emily-css 1.2.2 → 1.2.4

package/CHANGELOG.md

@@ -1,29 +1,63 @@
-# Changelog
-
-All notable changes to `emily-css` are documented here.
-
+# Changelog
+
+All notable changes to `emily-css` are documented here.
+
 ---
 
-## v1.2.2 — May 2026
+## v1.2.4 — May 2026
 
-### Added
-- Added IntelliSense JSON generation via `intellisense` config output (`dist/emily.intellisense.json` by default).
-- Added build profiling via `emily-css build --profile` with coarse timing buckets.
-- Added initial accessibility warnings to `emily-css doctor` (focus removal, same token text/background, and `cursor-pointer` on non-interactive elements).
-- Added documentation stubs in `docs/` for installation, configuration, variants, accessibility, doctor, migrate, manifest, and IntelliSense.
+**chore: release v1.2.4**
 
 ### Changed
-- Stabilised manifest schema metadata with explicit `schemaVersion`, package name, and package version fields.
-- Improved purge class extraction for complex variant patterns and safer junk filtering.
-- Updated README to reflect current product direction and command surface.
-
-### Notes
-- EmilyCSS remains CommonJS-compatible and continues to support Node 16+.
-- ESM-only dependency major upgrades remain intentionally deferred for compatibility.
+- chore: release v1.2.4
 
 ---
-
-## v1.2.1 — May 2026
+# Changelog
+
+All notable changes to `emily-css` are documented here.
+
+---
+
+## v1.2.4 — May 2026
+
+### Changed
+- Extracted shared config/path helpers (`getConfig`, `getFullCssPath`, `getManifestSettings`, etc.) into `src/config.js` to eliminate duplication between `src/index.js` and `src/doctor.js`. No behaviour change.
+- Updated `purge.js` file discovery to use `fast-glob` (already a dependency) instead of manual recursive `fs.readdirSync`, and to respect `DEFAULT_PURGE_IGNORE` from `src/constants.js` rather than hardcoded ignores.
+- Updated Node engine requirement to `>=22.0.0`. Node 16 and 18 are EOL.
+
+### Added
+- `emily-css manifest` CLI command. Generates the utility/token manifest JSON to the configured output path (default: `dist/emily.manifest.json`). The manifest feature existed internally — this wires it as a standalone command.
+
+### Notes
+- Current runtime support is Node 22+.
+
+---
+
+## v1.2.3 — May 2026
+
+****
+
+---
+## v1.2.2 — May 2026
+
+### Added
+- Added IntelliSense JSON generation via `intellisense` config output (`dist/emily.intellisense.json` by default).
+- Added build profiling via `emily-css build --profile` with coarse timing buckets.
+- Added initial accessibility warnings to `emily-css doctor` (focus removal, same token text/background, and `cursor-pointer` on non-interactive elements).
+- Added documentation stubs in `docs/` for installation, configuration, variants, accessibility, doctor, migrate, manifest, and IntelliSense.
+
+### Changed
+- Stabilised manifest schema metadata with explicit `schemaVersion`, package name, and package version fields.
+- Improved purge class extraction for complex variant patterns and safer junk filtering.
+- Updated README to reflect current product direction and command surface.
+
+### Notes
+- EmilyCSS remains CommonJS-compatible. Node engine requirement updated to >=22 in v1.2.4.
+- ESM-only dependency major upgrades remain intentionally deferred for compatibility.
+
+---
+
+## v1.2.1 — May 2026
 
 ### Changed
 - Refactored utility generators into smaller internal modules.

package/README.md

@@ -12,7 +12,7 @@ emilyCSS lets you define design tokens in `emily.config.json` and generate stati
 - Framework-agnostic output (`dist/emily.css` and `dist/emily.min.css`)
 - Accessibility-focused utility coverage (focus rings, visually-hidden helpers, motion-aware variants)
 - Tooling support with manifest and IntelliSense JSON generation
-- CommonJS package with Node 16+ compatibility
+- CommonJS package with Node 22+ compatibility
 
 ## Install and basic workflow
 
@@ -95,7 +95,7 @@ These files are intended for tooling, audits, and editor integrations. A VSCode
 ## Notes on compatibility
 
 - Package format: CommonJS
-- Runtime support: Node 16+
+- Runtime support: Node 22+
 - ESM-only major upgrades are intentionally avoided where they would break compatibility
 
 ## Documentation stubs
@@ -104,4 +104,4 @@ Starter docs are available in [`docs/`](./docs) for installation, configuration,
 
 ## License
 
-MIT
+MIT

package/bin/emilyui.js

@@ -1,5 +1,6 @@
 #!/usr/bin/env node
 
+const fs = require("fs");
 const path = require("path");
 
 const command = process.argv[2];
@@ -15,6 +16,7 @@ const usageText = `
     emily-css doctor      Scan project files for unknown EmilyCSS classes
     emily-css migrate     Generate a Tailwind-to-EmilyCSS migration report
       --import-colours    Detect Tailwind colour palettes and suggest importedPalettes config
+    emily-css manifest    Generate the utility/token manifest JSON
     emily-css showcase    Browse components in your browser
     emily-css help        Full command reference
 
@@ -43,6 +45,19 @@ if (command === "init") {
   const importColours = process.argv.includes("--import-colours");
   const report = generateMigrationReport({ importColours });
   console.log(formatMigrationReport(report, { importColours }));
+} else if (command === "manifest") {
+  const { getConfig, getFullCssPath, getManifestOutputPath, ensureDirectoryForFile } = require("../src/config.js");
+  const { ensureFullFramework } = require("../src/index.js");
+  const { generateManifest } = require("../src/manifest.js");
+  const config = getConfig();
+  ensureFullFramework();
+  const fullCssPath = getFullCssPath(config);
+  const css = fs.readFileSync(fullCssPath, "utf8");
+  const manifestData = generateManifest(css, config);
+  const manifestPath = getManifestOutputPath(config);
+  ensureDirectoryForFile(manifestPath);
+  fs.writeFileSync(manifestPath, JSON.stringify(manifestData, null, 2));
+  console.log(`✓ Generated manifest: ${manifestPath}`);
 } else if (command === "version" || command === "--version" || command === "-v") {
   console.log(packageJson.version);
 } else if (command === "help") {
@@ -57,6 +72,7 @@ if (command === "init") {
     emily-css doctor      Scan project files for unknown EmilyCSS classes
     emily-css migrate     Generate a Tailwind-to-EmilyCSS migration report
       --import-colours    Detect Tailwind colour palettes and suggest importedPalettes config
+    emily-css manifest    Generate the utility/token manifest JSON
     emily-css showcase    Launch the component showcase in your browser
     emily-css version     Show installed version
     emily-css help        Show this help text

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "emily-css",
-  "version": "1.2.2",
+  "version": "1.2.4",
   "description": "A config-driven utility CSS framework. Define your brand once, generate the CSS.",
   "main": "src/index.js",
   "bin": {
@@ -42,7 +42,7 @@
   "author": "Andy Terry",
   "license": "MIT",
   "engines": {
-    "node": ">=16.0.0"
+    "node": ">=22.0.0"
   },
   "devDependencies": {
     "nodemon": "^3.1.14"

package/src/config.js

@@ -0,0 +1,104 @@
+'use strict';
+
+const fs = require('fs');
+const path = require('path');
+
+function getConfigPath() {
+  return path.join(process.cwd(), 'emily.config.json');
+}
+
+function getConfig() {
+  const configPath = getConfigPath();
+
+  if (!fs.existsSync(configPath)) {
+    console.error('\n  emily-css: No config found. Run "emily-css init" first.\n');
+    process.exit(1);
+  }
+
+  return JSON.parse(fs.readFileSync(configPath, 'utf8'));
+}
+
+function getFullCssPath(config) {
+  return path.join(process.cwd(), config.output?.fullCss || 'dist/emily.css');
+}
+
+function getProductionCssPath(config) {
+  return path.join(process.cwd(), config.output?.css || 'dist/emily.min.css');
+}
+
+function getManifestSettings(config) {
+  const manifestConfig = config.manifest;
+
+  if (manifestConfig === true) {
+    return { enabled: true, output: 'dist/emily.manifest.json' };
+  }
+
+  if (manifestConfig && typeof manifestConfig === 'object') {
+    return {
+      enabled: manifestConfig.enabled === true,
+      output: manifestConfig.output || 'dist/emily.manifest.json',
+    };
+  }
+
+  return { enabled: false, output: 'dist/emily.manifest.json' };
+}
+
+function getManifestOutputPath(config) {
+  const manifestSettings = getManifestSettings(config);
+  const outputPath = manifestSettings.output || 'dist/emily.manifest.json';
+
+  return path.isAbsolute(outputPath)
+    ? outputPath
+    : path.join(process.cwd(), outputPath);
+}
+
+function getIntellisenseSettings(config) {
+  const intellisenseConfig = config.intellisense;
+
+  if (intellisenseConfig === true) {
+    return { enabled: true, output: 'dist/emily.intellisense.json' };
+  }
+
+  if (intellisenseConfig && typeof intellisenseConfig === 'object') {
+    return {
+      enabled: intellisenseConfig.enabled === true,
+      output: intellisenseConfig.output || 'dist/emily.intellisense.json',
+    };
+  }
+
+  return { enabled: false, output: 'dist/emily.intellisense.json' };
+}
+
+function getIntellisenseOutputPath(config) {
+  const intellisenseSettings = getIntellisenseSettings(config);
+  const outputPath = intellisenseSettings.output || 'dist/emily.intellisense.json';
+
+  return path.isAbsolute(outputPath)
+    ? outputPath
+    : path.join(process.cwd(), outputPath);
+}
+
+function ensureDirectoryForFile(filePath) {
+  const dir = path.dirname(filePath);
+
+  if (!fs.existsSync(dir)) {
+    fs.mkdirSync(dir, { recursive: true });
+  }
+}
+
+function getSourceDir(config) {
+  return config.purge?.sourceDir || '.';
+}
+
+module.exports = {
+  getConfigPath,
+  getConfig,
+  getFullCssPath,
+  getProductionCssPath,
+  getManifestSettings,
+  getManifestOutputPath,
+  getIntellisenseSettings,
+  getIntellisenseOutputPath,
+  ensureDirectoryForFile,
+  getSourceDir,
+};

package/src/doctor.js

@@ -1,54 +1,17 @@
+'use strict';
+
 const fs = require("fs");
 const path = require("path");
 const fg = require("fast-glob");
 const { extractClassNames } = require("./purge.js");
 const { ensureFullFramework, generateManifest } = require("./index.js");
 const { DEFAULT_EXTENSIONS } = require("./constants.js");
-
-function getConfigPath() {
-  return path.join(process.cwd(), "emily.config.json");
-}
-
-function getConfig() {
-  const configPath = getConfigPath();
-
-  if (!fs.existsSync(configPath)) {
-    console.error('\n  emily-css: No config found. Run "emily-css init" first.\n');
-    process.exit(1);
-  }
-
-  return JSON.parse(fs.readFileSync(configPath, "utf8"));
-}
-
-function getFullCssPath(config) {
-  return path.join(process.cwd(), config.output?.fullCss || "dist/emily.css");
-}
-
-function getManifestSettings(config) {
-  const manifestConfig = config.manifest;
-
-  if (manifestConfig === true) {
-    return { enabled: true, output: "dist/emily.manifest.json" };
-  }
-
-  if (manifestConfig && typeof manifestConfig === "object") {
-    return {
-      enabled: manifestConfig.enabled === true,
-      output: manifestConfig.output || "dist/emily.manifest.json",
-    };
-  }
-
-  return { enabled: false, output: "dist/emily.manifest.json" };
-}
-
-function getManifestOutputPath(config) {
-  const manifestSettings = getManifestSettings(config);
-  const outputPath = manifestSettings.output || "dist/emily.manifest.json";
-
-  return path.isAbsolute(outputPath)
-    ? outputPath
-    : path.join(process.cwd(), outputPath);
-}
+const {
+  getConfig,
+  getFullCssPath,
+  getManifestSettings,
+  getManifestOutputPath,
+} = require("./config.js");
 
 function normaliseClassForManifest(className) {
   if (!className || typeof className !== "string") {

package/src/index.js

@@ -1,10 +1,21 @@
-// new version
-
+'use strict';
 
 const fs = require('fs');
 const path = require('path');
 const { generateManifest } = require('./manifest');
 const { generateIntellisense } = require('./intellisense');
+const {
+  getConfigPath,
+  getConfig,
+  getFullCssPath,
+  getProductionCssPath,
+  getManifestSettings,
+  getManifestOutputPath,
+  getIntellisenseSettings,
+  getIntellisenseOutputPath,
+  ensureDirectoryForFile,
+  getSourceDir,
+} = require('./config');
 
 
 // ============================================================================
@@ -1455,97 +1466,6 @@ function generatePatternComponents() {
 // BUILD FUNCTION
 // ============================================================================
 
-// ============================================================================
-// BUILD FUNCTION
-// ============================================================================
-
-function getConfigPath() {
-  return path.join(process.cwd(), 'emily.config.json');
-}
-
-function getConfig() {
-  const configPath = getConfigPath();
-
-  if (!fs.existsSync(configPath)) {
-    console.error('\n  emily-css: No config found. Run "emily-css init" first.\n');
-    process.exit(1);
-  }
-
-  return JSON.parse(fs.readFileSync(configPath, 'utf8'));
-}
-
-function getFullCssPath(config) {
-  return path.join(process.cwd(), config.output?.fullCss || 'dist/emily.css');
-}
-
-function getProductionCssPath(config) {
-  return path.join(process.cwd(), config.output?.css || 'dist/emily.min.css');
-}
-
-function getManifestSettings(config) {
-  const manifestConfig = config.manifest;
-
-  if (manifestConfig === true) {
-    return { enabled: true, output: 'dist/emily.manifest.json' };
-  }
-
-  if (manifestConfig && typeof manifestConfig === 'object') {
-    return {
-      enabled: manifestConfig.enabled === true,
-      output: manifestConfig.output || 'dist/emily.manifest.json',
-    };
-  }
-
-  return { enabled: false, output: 'dist/emily.manifest.json' };
-}
-
-function getManifestOutputPath(config) {
-  const manifestSettings = getManifestSettings(config);
-  const outputPath = manifestSettings.output || 'dist/emily.manifest.json';
-
-  return path.isAbsolute(outputPath)
-    ? outputPath
-    : path.join(process.cwd(), outputPath);
-}
-
-function getIntellisenseSettings(config) {
-  const intellisenseConfig = config.intellisense;
-
-  if (intellisenseConfig === true) {
-    return { enabled: true, output: 'dist/emily.intellisense.json' };
-  }
-
-  if (intellisenseConfig && typeof intellisenseConfig === 'object') {
-    return {
-      enabled: intellisenseConfig.enabled === true,
-      output: intellisenseConfig.output || 'dist/emily.intellisense.json',
-    };
-  }
-
-  return { enabled: false, output: 'dist/emily.intellisense.json' };
-}
-
-function getIntellisenseOutputPath(config) {
-  const intellisenseSettings = getIntellisenseSettings(config);
-  const outputPath = intellisenseSettings.output || 'dist/emily.intellisense.json';
-
-  return path.isAbsolute(outputPath)
-    ? outputPath
-    : path.join(process.cwd(), outputPath);
-}
-
-function ensureDirectoryForFile(filePath) {
-  const dir = path.dirname(filePath);
-
-  if (!fs.existsSync(dir)) {
-    fs.mkdirSync(dir, { recursive: true });
-  }
-}
-
-function getSourceDir(config) {
-  return config.purge?.sourceDir || '.';
-}
-
 function buildFullFramework() {
   const config = getConfig();
 

package/src/purge.js

@@ -1,37 +1,27 @@
-// new version
+'use strict';
 
 const fs = require("fs");
 const path = require("path");
-const { DEFAULT_EXTENSIONS } = require("./constants.js");
+const fg = require("fast-glob");
+const { DEFAULT_EXTENSIONS, DEFAULT_PURGE_IGNORE } = require("./constants.js");
 
 function getAllFiles(dir, extensions = DEFAULT_EXTENSIONS) {
-  let files = [];
+  const absoluteDir = path.isAbsolute(dir) ? dir : path.resolve(dir);
+  const patterns = extensions.map((ext) => `**/*${ext}`);
+  const ignore = DEFAULT_PURGE_IGNORE.map((d) => `**/${d}/**`);
 
   try {
-    const entries = fs.readdirSync(dir, { withFileTypes: true });
-
-    for (const entry of entries) {
-      const fullPath = path.join(dir, entry.name);
-
-      if (
-        entry.name.startsWith(".") ||
-        entry.name === "node_modules" ||
-        entry.name === "dist"
-      ) {
-        continue;
-      }
-
-      if (entry.isDirectory()) {
-        files = files.concat(getAllFiles(fullPath, extensions));
-      } else if (extensions.some((ext) => entry.name.endsWith(ext))) {
-        files.push(fullPath);
-      }
-    }
+    return fg.sync(patterns, {
+      cwd: absoluteDir,
+      ignore,
+      onlyFiles: true,
+      unique: true,
+      absolute: true,
+    });
   } catch (err) {
-    console.warn(`Warning: Could not read directory ${dir}: ${err.message}`);
+    console.warn(`Warning: Could not scan directory ${absoluteDir}: ${err.message}`);
+    return [];
   }
-
-  return files;
 }
 
 function extractClassNames(content) {
@@ -186,8 +176,6 @@ function purgeBlock(block, usedClasses) {
 
 function getFilesForPurge(scanDir, config, extensions) {
   if (config?.purge?.sourceGlobs && config.purge.sourceGlobs.length) {
-    const fg = require("fast-glob");
-
     console.log(`\n🔍 Scanning using sourceGlobs`);
     config.purge.sourceGlobs.forEach((glob) => console.log(`   - ${glob}`));
     console.log(`   Extensions: ${extensions.join(", ")}`);