forgecss 0.4.0 → 0.5.0

package/index.d.ts

@@ -3,14 +3,15 @@ export type ForgeCSSOptions = {
   usageFiles?: string[];
   usageAttributes?: string[];
   breakpoints?: {
-    [key: string]: string
+    [key: string]: string;
   };
+  verbose?: boolean;
 };
 
 export type ForgeInstance = {
-  parseDirectory: (options: { dir: string; output?: string }) => Promise<string>;
-  parseFile: (options: { file: string; output?: string }) => Promise<string>;
-  parse: (options: { css: string; html?: string; jsx?: string; output?: string }) => Promise<string>;
+  parseDirectory: (options: { dir: string; output?: string; watch?: boolean }) => Promise<string>;
+  parseFile: (options: { file: string; output?: string; watch?: boolean }) => Promise<string>;
+  parse: (options: { css: string; html?: string; jsx?: string; output?: string; }) => Promise<string>;
 };
 
 declare function ForgeCSS(options?: ForgeCSSOptions): ForgeInstance;

package/index.js

@@ -1,20 +1,27 @@
+import path from 'path';
 import { writeFile } from "fs/promises";
 import getAllFiles from "./lib/getAllFiles.js";
 import { extractStyles, invalidateInvetory } from "./lib/inventory.js";
 import { invalidateUsageCache, findUsages } from "./lib/usages.js";
 import { generateOutputCSS } from "./lib/generator.js";
+import chokidar from "chokidar";
 
 const DEFAULT_OPTIONS = {
   inventoryFiles: ["css", "less", "scss"],
   usageFiles: ["html", "jsx", "tsx"],
   usageAttributes: ["class", "className"],
-  breakpoints: {}
+  breakpoints: {},
+  verbose: true
 };
 
 export default function ForgeCSS(options) {
   const config = { ...DEFAULT_OPTIONS };
 
   config.breakpoints = Object.assign({}, DEFAULT_OPTIONS.breakpoints, options?.breakpoints ?? {});
+  config.inventoryFiles = options?.inventoryFiles ?? DEFAULT_OPTIONS.inventoryFiles;
+  config.usageFiles = options?.usageFiles ?? DEFAULT_OPTIONS.usageFiles;
+  config.usageAttributes = options?.usageAttributes ?? DEFAULT_OPTIONS.usageAttributes;
+  config.verbose = options?.verbose ?? DEFAULT_OPTIONS.verbose;
 
   async function result(output) {
     try {
@@ -22,15 +29,32 @@ export default function ForgeCSS(options) {
       if (output) {
         await writeFile(output, `/* ForgeCSS autogenerated file */\n${css}`, "utf-8");
       }
+      console.log("forgecss: Output CSS generated successfully.");
       return css;
     } catch (err) {
       console.error(`forgecss: error generating output CSS: ${err}`);
     }
     return null;
   }
+  function runWatcher(what, output, callback) {
+    const watcher = chokidar.watch(what, {
+      persistent: true,
+      ignoreInitial: true,
+      ignored: (p, stats) => output && path.resolve(p) === path.resolve(output)
+    });
+    watcher.on("change", async (filePath) => {
+      if (config.verbose) {
+        console.log(`forgecss: Detected change in ${filePath}`);
+      }
+      callback();
+    });
+    if (config.verbose) {
+      console.log("forgecss: Watch mode enabled. Listening for file changes...");
+    }
+  }
 
   return {
-    async parseDirectory({ dir, output = null }) {
+    async parseDirectory({ dir, output = null, watch = false }) {
       if (!dir) {
         throw new Error('forgecss: parseDirectory requires "dir" as an argument.');
       }
@@ -52,10 +76,13 @@ export default function ForgeCSS(options) {
       } catch (err) {
         console.error(`forgecss: error extracting usages`, err);
       }
+      watch && runWatcher(dir, output, () => {
+        this.parseDirectory({ dir, output, watch: false });
+      });
       // generating the output CSS
       return result(output);
     },
-    async parseFile({ file, output = null }) {
+    async parseFile({ file, output = null, watch = false }) {
       if (!file) {
         throw new Error('forgecss: parseFile requires "file" as an argument.');
       }
@@ -77,6 +104,9 @@ export default function ForgeCSS(options) {
       } catch (err) {
         console.error(`forgecss: error extracting usages.`, err);
       }
+       watch && runWatcher(file, output, () => {
+        this.parseFile({ file, output, watch: false });
+       });
       // generating the output CSS
       return result(output);
     },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "forgecss",
-  "version": "0.4.0",
+  "version": "0.5.0",
   "type": "module",
   "description": "ForgeCSS turns strings into fully generated responsive CSS using a custom DSL.",
   "author": "Krasimir Tsonev",