emily-css 1.1.1 → 1.2.0

package/src/purge.js

@@ -2,28 +2,7 @@
 
 const fs = require("fs");
 const path = require("path");
-
-const DEFAULT_EXTENSIONS = [
-  ".html",
-  ".htm",
-  ".twig",
-  ".njk",
-  ".liquid",
-  ".hbs",
-  ".js",
-  ".jsx",
-  ".ts",
-  ".tsx",
-  ".vue",
-  ".php",
-  ".astro",
-  ".svelte",
-  ".blade.php",
-  ".jinja",
-  ".jinja2",
-  ".j2",
-  ".md",
-];
+const { DEFAULT_EXTENSIONS } = require("./constants.js");
 
 function getAllFiles(dir, extensions = DEFAULT_EXTENSIONS) {
   let files = [];

package/src/reporters/migrationReporter.js

@@ -0,0 +1,71 @@
+function pushListSection(lines, title, items, limit = 20) {
+  if (!Array.isArray(items) || items.length === 0) {
+    return;
+  }
+
+  lines.push('', `${title}:`);
+  items.slice(0, limit).forEach((item) => {
+    lines.push(`  - ${item}`);
+  });
+
+  if (items.length > limit) {
+    lines.push(`  ...and ${items.length - limit} more`);
+  }
+}
+
+function formatMigrationReport(report, options = {}) {
+  const importColours = options.importColours === true;
+  const lines = [
+    '',
+    'EmilyCSS migration report',
+    `  Files scanned: ${report.files.length}`,
+    `  Total classes found: ${report.found.length}`,
+    `  Supported EmilyCSS classes: ${report.supported.length}`,
+    `  Known Tailwind classes: ${report.knownTailwind.length}`,
+    `  Suggested replacements: ${report.replacements.length}`,
+    `  Unsupported classes: ${report.unsupported.length}`,
+  ];
+
+  if (importColours) {
+    lines.push(`  Migration mode: imported-palettes`);
+    lines.push(`  Imported palettes detected: ${report.importedPalettes.length}`);
+  } else {
+    lines.push(`  Migration mode: semantic`);
+  }
+
+  pushListSection(
+    lines,
+    'Suggested replacements',
+    report.replacements.map((entry) => `${entry.from} -> ${entry.to}`),
+  );
+
+  pushListSection(lines, 'Unsupported classes', report.unsupported);
+  pushListSection(lines, 'Unsupported arbitrary value utilities detected', report.arbitraryValueUtilities);
+
+  if (report.warnings.length > 0) {
+    lines.push('', 'Warnings:');
+    report.warnings.forEach((warning) => {
+      lines.push(`  - ${warning}`);
+    });
+  }
+
+  if (importColours) {
+    pushListSection(
+      lines,
+      'Imported palette colour mappings',
+      report.importedPaletteMappings.map((entry) => `${entry.from} -> ${entry.to}`),
+    );
+
+    if (report.importedPalettesConfig) {
+      lines.push('', 'Suggested importedPalettes config:');
+      lines.push(report.importedPalettesConfig);
+    }
+  }
+
+  lines.push('');
+  return lines.join('\n');
+}
+
+module.exports = {
+  formatMigrationReport,
+};

package/src/watch.js

@@ -3,6 +3,10 @@ const path = require("path");
 const chokidar = require("chokidar");
 const chalk = require("chalk");
 const fg = require("fast-glob");
+const {
+  DEFAULT_PURGE_IGNORE,
+  DEFAULT_EXTENSIONS,
+} = require("./constants.js");
 
 const {
   buildFullFramework,
@@ -16,6 +20,7 @@ let isRunning = false;
 let pendingRun = false;
 let previousClasses = new Set();
 let hasRunOnce = false;
+let activeIgnoreList = DEFAULT_PURGE_IGNORE;
 
 function readConfig() {
   const configPath = path.join(process.cwd(), "emily.config.json");
@@ -34,22 +39,26 @@ function normalisePath(filePath) {
   return filePath.replace(/\\/g, "/");
 }
 
-function shouldIgnore(filePath) {
-  const normalised = normalisePath(filePath);
+function normaliseIgnoreEntry(entry) {
+  return normalisePath(String(entry || ""))
+    .replace(/^\.\/+/, "")
+    .replace(/^\/+|\/+$/g, "");
+}
 
-  return [
-    "node_modules/",
-    ".git/",
-    ".nuxt/",
-    ".next/",
-    ".output/",
-    "dist/",
-    "build/",
-    "coverage/",
-    ".cache/",
-    ".vite/",
-  ].some(
-    (part) => normalised.includes("/" + part) || normalised.startsWith(part),
+function shouldIgnore(filePath, ignoreList = DEFAULT_PURGE_IGNORE) {
+  if (!filePath) return false;
+
+  const normalised = normalisePath(filePath);
+  const normalisedIgnoreList = (Array.isArray(ignoreList) ? ignoreList : DEFAULT_PURGE_IGNORE)
+    .map(normaliseIgnoreEntry)
+    .filter(Boolean);
+
+  return normalisedIgnoreList.some(
+    (entry) =>
+      normalised === entry ||
+      normalised.startsWith(entry + "/") ||
+      normalised.includes("/" + entry + "/") ||
+      normalised.endsWith("/" + entry),
   );
 }
 
@@ -80,27 +89,7 @@ function getScanFiles(config) {
   }
 
   const sourceDir = config.purge?.sourceDir || ".";
-  const extensions = config.purge?.extensions || [
-    ".html",
-    ".htm",
-    ".twig",
-    ".njk",
-    ".liquid",
-    ".hbs",
-    ".js",
-    ".jsx",
-    ".ts",
-    ".tsx",
-    ".vue",
-    ".php",
-    ".astro",
-    ".svelte",
-    ".blade.php",
-    ".jinja",
-    ".jinja2",
-    ".j2",
-    ".md",
-  ];
+  const extensions = config.purge?.extensions || DEFAULT_EXTENSIONS;
 
   return fg.sync(
     extensions.map((ext) => `${sourceDir.replace(/\/$/, "")}/**/*${ext}`),
@@ -115,9 +104,10 @@ function getScanFiles(config) {
 function collectUsedClasses(config) {
   const files = getScanFiles(config);
   const usedClasses = new Set();
+  const ignoreList = config.purge?.ignore || DEFAULT_PURGE_IGNORE;
 
   for (const file of files) {
-    if (shouldIgnore(file)) continue;
+    if (shouldIgnore(file, ignoreList)) continue;
 
     try {
       const content = fs.readFileSync(file, "utf8");
@@ -210,6 +200,7 @@ function runProductionUpdate(filePath) {
 
   try {
     const config = readConfig();
+    activeIgnoreList = config.purge?.ignore || DEFAULT_PURGE_IGNORE;
     const normalisedFilePath = filePath ? normalisePath(filePath) : "";
     const isConfigChange = normalisedFilePath.endsWith("emily.config.json");
 
@@ -244,12 +235,13 @@ function getWatchPaths(config) {
 }
 
 function queueUpdate(filePath) {
-  if (filePath && shouldIgnore(filePath)) return;
+  if (filePath && shouldIgnore(filePath, activeIgnoreList)) return;
   runProductionUpdate(filePath);
 }
 
 function runWatch() {
   const config = readConfig();
+  activeIgnoreList = config.purge?.ignore || DEFAULT_PURGE_IGNORE;
   const watchPaths = getWatchPaths(config);
 
   console.log("");
@@ -270,7 +262,7 @@ function runWatch() {
   runProductionUpdate();
 
   const watcher = chokidar.watch(watchPaths, {
-    ignored: shouldIgnore,
+    ignored: (filePath) => shouldIgnore(filePath, activeIgnoreList),
     ignoreInitial: true,
     awaitWriteFinish: {
       stabilityThreshold: 500,
@@ -288,4 +280,4 @@ function runWatch() {
   });
 }
 
-runWatch();
+runWatch();