Method purge

packages/purgecss/src/index.ts:810–847

* Remove unused CSS * * @param userOptions - PurgeCSS options or path to the configuration file * @returns an array of object containing the filename and the associated CSS * * @example Using a configuration file named purgecss.config.js * ```ts * const purgeCSSResults = await n

(
    userOptions: UserDefinedOptions | string | undefined,
  )

   * ```
   */
  public async purge(
    userOptions: UserDefinedOptions | string | undefined,
  ): Promise<ResultPurge[]> {
    this.options =
      typeof userOptions !== "object"
        ? await setOptions(userOptions)
        : {
            ...defaultOptions,
            ...userOptions,
            safelist: standardizeSafelist(userOptions.safelist),
          };
    const { content, css, extractors, safelist } = this.options;

    if (this.options.variables) {
      this.variablesStructure.safelist = safelist.variables || [];
    }

    const fileFormatContents = content.filter(
      (o) => typeof o === "string",
    ) as string[];
    const rawFormatContents = content.filter(
      (o) => typeof o === "object",
    ) as RawContent[];

    const cssFileSelectors = await this.extractSelectorsFromFiles(
      fileFormatContents,
      extractors,
    );
    const cssRawSelectors = await this.extractSelectorsFromString(
      rawFormatContents,
      extractors,
    );

    return this.getPurgedCSS(
      css,
      mergeExtractorSelectors(cssFileSelectors, cssRawSelectors),
    );
  }

  /**
   * Remove unused CSS variables