astro-purgecss 2.2.0 → 2.3.0

package/README.md

@@ -67,12 +67,19 @@ export default defineConfig({
       fontFace: true,
       keyframes: true,
       safelist: ['random', 'yep', 'button', /^nav-/],
-      blocklist: ['usedClass', /^nav-/]
+      blocklist: ['usedClass', /^nav-/],
+      content: [
+        process.cwd() + '/src/**/*.{astro,vue}', // Watching astro and vue sources (for SSR, read the note below)
+      ],
     })
   ]
 });
 ```
 
+> **Note**
+>
+> If you are using **Astro SSR** in your project, you must add your astro and framework sources files into the `content` option (see in the example). Otherwise, as the package only look at the final build sent to the client, with SSR, some pages may not be included and may break your CSS.
+
 ### Available Options
 
 Here is a list of options, that are allowed to be passed in the config:
@@ -86,6 +93,7 @@ export type PurgeCSSOptions = {
   variables?: boolean; // removes any unused CSS variables if set to true
   safelist?: UserDefinedSafelist; // indicates which selectors are safe to leave in the final CSS
   blocklist?: StringRegExpArray; // blocks the CSS selectors from appearing in the final output CSS
+  content?: Array<string | RawContent>;
 };
 ```
 
@@ -95,7 +103,7 @@ We have also setup an example repository available here: [example-purgecss](../.
 
 ### Caveats
 
-- Certain options (ex: `css`, `content`), are not allowed to be passed in your `astro.config.mjs` config file, to not interfere with the internals of this integration.
+- Some options are not allowed to be passed in your `astro.config.mjs` config file, to not interfere with the internals of this integration.
 
 - If you are using `tailwind.css`, please read about purge limitations in this guide [writing-purgeable-html](https://v2.tailwindcss.com/docs/optimizing-for-production#writing-purgeable-html)
 

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 import type { AstroIntegration } from 'astro';
-import { StringRegExpArray, UserDefinedSafelist } from 'purgecss';
+import { RawContent, StringRegExpArray, UserDefinedSafelist } from 'purgecss';
 export type PurgeCSSOptions = {
     fontFace?: boolean;
     keyframes?: boolean;
@@ -8,5 +8,6 @@ export type PurgeCSSOptions = {
     variables?: boolean;
     safelist?: UserDefinedSafelist;
     blocklist?: StringRegExpArray;
+    content?: Array<string | RawContent>;
 };
 export default function (options?: PurgeCSSOptions): AstroIntegration;

package/dist/index.mjs

@@ -20,7 +20,8 @@ function src_default(options = {}) {
           ...options,
           content: [
             `${outDir}/**/*.html`,
-            `${outDir}/**/*.js`
+            `${outDir}/**/*.js`,
+            ...options.content || []
           ],
           css: [`${outDir}/**/*.css`],
           defaultExtractor: (content) => content.match(/[\w-/:]+(?<!:)/g) || []

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "astro-purgecss",
   "description": "Remove unused CSS rules from your final Astro bundle",
-  "version": "2.2.0",
+  "version": "2.3.0",
   "scripts": {
     "build": "astro-build --src src/index.ts",
     "postbuild": "npm run typecheck:emit",