ultimate-jekyll-manager 0.0.231 → 0.0.232

package/CLAUDE.md

@@ -36,6 +36,27 @@ FIREBASE_EMULATOR_CONNECT=true npm start
 
 This value is written to `.temp/_config_browsersync.yml` under `web_manager.env.FIREBASE_EMULATOR_CONNECT` and made available to the frontend at build time.
 
+### PurgeCSS
+
+PurgeCSS runs automatically in production builds and can be enabled locally with `UJ_PURGECSS=true`. Consuming projects can add custom safelist patterns via `config/ultimate-jekyll-manager.json` under `sass.purgecss.safelist`:
+
+```json5
+{
+  sass: {
+    purgecss: {
+      safelist: {
+        standard: ["^my-component-"],  // Match full class names
+        deep: [],                       // Match including children
+        greedy: [],                     // Match anywhere in selector
+        keyframes: [],                  // Preserve keyframe animations
+      },
+    },
+  },
+}
+```
+
+Each entry is a regex string that gets converted to a `RegExp` and merged into the corresponding PurgeCSS safelist category.
+
 ## Asset Organization
 
 ### Ultimate Jekyll Manager Files (THIS project)

package/dist/defaults/config/ultimate-jekyll-manager.json

@@ -1,13 +1,23 @@
 {
+  distribute: {
+    input: [],
+  },
   webpack: {
     target: 'default',
   },
+  sass: {
+    purgecss: {
+      safelist: {
+        standard: [],
+        deep: [],
+        greedy: [],
+        keyframes: [],
+      },
+    },
+  },
   imagemin: {
     enabled: true,
   },
-  distribute: {
-    input: [],
-  },
   github: {
     workflows: {
       build: {

package/dist/gulp/tasks/sass.js

@@ -81,6 +81,8 @@ const compiled = {};
 const MAIN_BUNDLE_PAGE_PARTIALS = false; // Set to true to merge pages into _page-specific.scss, false to compile separately
 // Enable PurgeCSS via environment variable or in production mode
 const ENABLE_PURGECSS = Manager.isBuildMode() || process.env.UJ_PURGECSS === 'true';
+// Load UJM config for user-defined PurgeCSS safelist
+const ujmConfig = Manager.getUJMConfig();
 
 // SASS Compilation Task
 function sass(complete) {
@@ -272,6 +274,9 @@ function sass(complete) {
 
           // Social
           /^social-share-/,
+
+          // User-defined safelist from ultimate-jekyll-manager.json
+          ...(ujmConfig?.sass?.purgecss?.safelist?.standard || []).map(s => new RegExp(s)),
         ],
         deep: [
           // Preserve input state pseudo-selectors (checkbox, radio, etc.)
@@ -282,8 +287,14 @@ function sass(complete) {
           /:hover/,
           /:valid/,
           /:invalid/,
+
+          // User-defined
+          ...(ujmConfig?.sass?.purgecss?.safelist?.deep || []).map(s => new RegExp(s)),
+        ],
+        greedy: [
+          // User-defined
+          ...(ujmConfig?.sass?.purgecss?.safelist?.greedy || []).map(s => new RegExp(s)),
         ],
-        greedy: [],
         // Preserve keyframe animations
         keyframes: [
           /^spinner-/,
@@ -291,6 +302,9 @@ function sass(complete) {
           // /^fade-/,
           // /^slide-/,
           // /^collapse/
+
+          // User-defined
+          ...(ujmConfig?.sass?.purgecss?.safelist?.keyframes || []).map(s => new RegExp(s)),
         ]
       },
       // Don't remove CSS variables

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ultimate-jekyll-manager",
-  "version": "0.0.231",
+  "version": "0.0.232",
   "description": "Ultimate Jekyll dependency manager",
   "main": "dist/index.js",
   "exports": {