Method getPurgedCSS

packages/purgecss/src/index.ts:648–721

* Get the purged version of the css based on the files * * @param cssOptions - css options, files or raw strings * @param selectors - set of extracted css selectors

(
    cssOptions: Array<string | RawCSS>,
    selectors: ExtractorResultSets,
  )

   * @param selectors - set of extracted css selectors
   */
  public async getPurgedCSS(
    cssOptions: Array<string | RawCSS>,
    selectors: ExtractorResultSets,
  ): Promise<ResultPurge[]> {
    const sources = [];

    // resolve any globs
    const processedOptions: Array<string | RawCSS> = [];
    for (const option of cssOptions) {
      if (typeof option === "string") {
        processedOptions.push(
          ...glob.sync(option, {
            onlyFiles: true,
            ignore: this.options.skippedContentGlobs,
          }),
        );
      } else {
        processedOptions.push(option);
      }
    }

    for (const option of processedOptions) {
      const cssContent =
        typeof option === "string"
          ? this.options.stdin
            ? option
            : await asyncFs.readFile(option, "utf-8")
          : option.raw;
      const isFromFile = typeof option === "string" && !this.options.stdin;
      const root = postcss.parse(cssContent, {
        from: isFromFile ? option : undefined,
      });

      // purge unused selectors
      this.walkThroughCSS(root, selectors);

      if (this.options.fontFace) this.removeUnusedFontFaces();
      if (this.options.keyframes) this.removeUnusedKeyframes();
      if (this.options.variables) this.removeUnusedCSSVariables();

      const postCSSResult = root.toResult({
        map: this.options.sourceMap,
        to:
          typeof this.options.sourceMap === "object" &&
          this.options.sourceMap.to
            ? this.options.sourceMap.to
            : isFromFile
              ? option
              : undefined,
      });
      const result: ResultPurge = {
        css: postCSSResult.toString(),
        file: typeof option === "string" ? option : option.name,
      };

      if (this.options.sourceMap) {
        result.sourceMap = postCSSResult.map?.toString();
      }