firefox-css-theme 0.2.0

package/dist/watcher.js

@@ -0,0 +1,111 @@
+import path from "node:path";
+import { watch } from "chokidar";
+export class FileWatcher {
+    fileSystemWatcher = null;
+    targets = new Set();
+    timers = new Map();
+    /** Registers a target with its file paths to be watched for changes. */
+    addTarget(target) {
+        this.targets.add(target);
+        if (this.fileSystemWatcher) {
+            for (const filePath of target.filePaths) {
+                this.fileSystemWatcher.add(path.resolve(process.cwd(), filePath));
+            }
+        }
+    }
+    /** Updates the list of file paths watched for a registered target. */
+    updateFilePaths(target, nextFilePaths) {
+        const previousAbsolutePaths = target.filePaths.map((filePath) => path.resolve(process.cwd(), filePath));
+        const nextAbsolutePaths = nextFilePaths.map((filePath) => path.resolve(process.cwd(), filePath));
+        target.filePaths = nextFilePaths;
+        if (this.fileSystemWatcher) {
+            for (const previousPath of previousAbsolutePaths) {
+                if (!nextAbsolutePaths.includes(previousPath)) {
+                    this.fileSystemWatcher.unwatch(previousPath);
+                }
+            }
+            for (const nextPath of nextAbsolutePaths) {
+                if (!previousAbsolutePaths.includes(nextPath)) {
+                    this.fileSystemWatcher.add(nextPath);
+                }
+            }
+        }
+    }
+    /** Removes a target from the active watch list. */
+    removeTarget(target) {
+        this.targets.delete(target);
+        const debounceTimer = this.timers.get(target);
+        if (debounceTimer) {
+            clearTimeout(debounceTimer);
+            this.timers.delete(target);
+        }
+        if (this.fileSystemWatcher) {
+            for (const filePath of target.filePaths) {
+                this.fileSystemWatcher.unwatch(path.resolve(process.cwd(), filePath));
+            }
+        }
+    }
+    /**
+     * Initialises the file watcher and begins monitoring all registered target
+     * file paths.
+     */
+    async start() {
+        if (this.fileSystemWatcher)
+            return;
+        const targetPaths = [];
+        for (const target of this.targets) {
+            for (const filePath of target.filePaths) {
+                const absolutePath = path.resolve(process.cwd(), filePath);
+                if (!targetPaths.includes(absolutePath)) {
+                    targetPaths.push(absolutePath);
+                }
+            }
+        }
+        this.fileSystemWatcher = watch(targetPaths, {
+            awaitWriteFinish: { pollInterval: 50, stabilityThreshold: 100 },
+            ignoreInitial: true,
+            persistent: true,
+        });
+        this.fileSystemWatcher.on("change", (changedFilePath) => {
+            this.handleFileChange("change", changedFilePath);
+        });
+        this.fileSystemWatcher.on("add", (addedFilePath) => {
+            this.handleFileChange("add", addedFilePath);
+        });
+        this.fileSystemWatcher.on("unlink", (unlinkedFilePath) => {
+            this.handleFileChange("unlink", unlinkedFilePath);
+        });
+        await new Promise((resolve) => {
+            this.fileSystemWatcher.on("ready", () => resolve());
+        });
+    }
+    /** Closes the file system watcher and cancels any pending debounce timers. */
+    async close() {
+        for (const timer of this.timers.values()) {
+            clearTimeout(timer);
+        }
+        this.timers.clear();
+        if (this.fileSystemWatcher) {
+            await this.fileSystemWatcher.close();
+            this.fileSystemWatcher = null;
+        }
+    }
+    handleFileChange(eventType, changedFilePath) {
+        const absoluteChangedPath = path.resolve(process.cwd(), changedFilePath);
+        for (const target of this.targets) {
+            const targetAbsolutePaths = target.filePaths.map((filePath) => path.resolve(process.cwd(), filePath));
+            const isMatch = targetAbsolutePaths.includes(absoluteChangedPath);
+            if (isMatch) {
+                const existingTimer = this.timers.get(target);
+                if (existingTimer)
+                    clearTimeout(existingTimer);
+                const newTimer = setTimeout(async () => {
+                    this.timers.delete(target);
+                    await target.onChange(eventType, absoluteChangedPath);
+                }, 100);
+                this.timers.set(target, newTimer);
+            }
+        }
+    }
+}
+export const fileWatcher = new FileWatcher();

package/package.json

@@ -0,0 +1,49 @@
+{
+	"name": "firefox-css-theme",
+	"version": "0.2.0",
+	"description": "CLI toolkit and Model Context Protocol server for building, inspecting, and live-debugging Firefox UI and CSS themes.",
+	"homepage": "https://github.com/easonwong-de/Firefox-CSS-Theme-MCP#readme",
+	"bugs": {
+		"url": "https://github.com/easonwong-de/Firefox-CSS-Theme-MCP/issues"
+	},
+	"repository": {
+		"type": "git",
+		"url": "git+https://github.com/easonwong-de/Firefox-CSS-Theme-MCP.git"
+	},
+	"license": "MIT",
+	"author": "Eason Wong <me@easonwong.de> (https://easonwong.de/)",
+	"type": "module",
+	"main": "dist/index.js",
+	"bin": {
+		"firefox-css-theme": "dist/cli.js",
+		"firefox-css-theme-mcp": "dist/cli.js"
+	},
+	"files": [
+		"dist"
+	],
+	"scripts": {
+		"build": "tsc",
+		"format": "prettier --write --list-different .",
+		"prepublishOnly": "npm run build",
+		"start": "node dist/cli.js start",
+		"test": "tsx tests/run.ts --headless"
+	},
+	"dependencies": {
+		"@modelcontextprotocol/sdk": "^1.30.0",
+		"chokidar": "^4.0.3",
+		"commander": "^15.0.0",
+		"postcss": "^8.5.3",
+		"postcss-import": "^16.1.0",
+		"selenium-webdriver": "^4.47.0",
+		"zod": "^4.4.3"
+	},
+	"devDependencies": {
+		"@types/node": "^26.2.0",
+		"@types/postcss-import": "^14.0.3",
+		"@types/selenium-webdriver": "^4.35.6",
+		"prettier": "^3.9.6",
+		"prettier-plugin-jsdoc": "^1.8.1",
+		"tsx": "^4.23.12",
+		"typescript": "^7.0.2"
+	}
+}