@pantoken/vite-workspace-orchestrator 0.1.0 → 0.1.2

package/README.md

@@ -14,7 +14,8 @@ Key behaviors:
   filtered out.
 - Debounces rapid changes per package before spawning a build.
 - Rebuilds dependents in topological order after a successful build.
-- Registers optional HMR paths with Vite's watcher, and mounts optional static file servers.
+- Watches built-output paths with native `fs.watch` and emits `change` events into Vite — CSS files
+  already in the module graph get a targeted hot-update; anything else falls back to a full reload.
 
 ## Usage
 
@@ -34,7 +35,7 @@ export default {
           dependents: [],
         },
       ],
-      hmrWatchPaths: [resolve(root, "formats/components/generated")],
+      outputWatchPaths: [resolve(root, "formats/components/generated")],
       debounceMs: 200,
     }),
   ],

package/dist/index.d.mts

@@ -50,17 +50,14 @@ interface OrchestratorOptions {
   /** The upstream workspace dependency graph. */
   upstream: readonly UpstreamNode[];
   /**
-   * Paths to add to Vite's `server.watcher` so HMR fires when built output is updated (e.g. a
-   * package's `dist` or `generated` directory).
+   * Paths to watch with native `fs.watch` so Vite picks up built output after an upstream rebuild
+   * (e.g. a package's `dist` or `generated` directory). Uses native `fs.watch` rather than
+   * chokidar's `add()`, which doesn't reliably detect changes in pnpm-symlinked or out-of-root
+   * directories. On each change a synthetic `"change"` event is emitted on `server.watcher`: for
+   * CSS files already in the module graph Vite triggers a targeted hot-update; for anything else
+   * it falls back to a full page reload.
    */
-  hmrWatchPaths?: readonly string[];
-  /**
-   * Paths to watch with native `fs.watch` for triggering module invalidation. Unlike
-   * `hmrWatchPaths` (which relies on chokidar), these are monitored with Node's native `fs.watch` —
-   * which reliably detects changes for pnpm-symlinked workspace `dist` directories. On a change, a
-   * synthetic `"change"` event is emitted on `server.watcher` so the module graph is invalidated.
-   */
-  reloadWatchPaths?: readonly string[];
+  outputWatchPaths?: readonly string[];
   /** Debounce delay in milliseconds before triggering a rebuild (default: 200). */
   debounceMs?: number;
   /** Optional static file-serving middleware entries. */

package/dist/index.mjs

@@ -1,5 +1,5 @@
 import { readFileSync, watch } from "node:fs";
-import { matchesGlob, resolve } from "node:path";
+import { isAbsolute, matchesGlob, relative, resolve } from "node:path";
 import { spawn } from "node:child_process";
 //#region src/file-server.ts
 /**
@@ -22,7 +22,13 @@ function mountFileServers(fileServers, middlewares) {
 			return;
 		}
 		const resolved = entry.pathTransform ? entry.pathTransform(filePath) : filePath;
-		const fullPath = resolve(entry.serveDir, resolved.slice(1));
+		const serveRoot = resolve(entry.serveDir);
+		const fullPath = resolve(serveRoot, resolved.slice(1));
+		const rel = relative(serveRoot, fullPath);
+		if (rel.startsWith("..") || isAbsolute(rel)) {
+			next();
+			return;
+		}
 		try {
 			const content = readFileSync(fullPath, "utf8");
 			res.setHeader("Content-Type", entry.contentType);
@@ -125,7 +131,7 @@ function createScheduler(nodeMap, logger, debounceMs) {
 *       dependents: [],
 *     },
 *   ],
-*   hmrWatchPaths: [resolve(root, "formats/components/generated")],
+*   outputWatchPaths: [resolve(root, "formats/components/generated")],
 * });
 * ```
 *
@@ -166,7 +172,7 @@ function matchesFilters(filename, node) {
 * @returns A Vite plugin object (`apply: "serve"`).
 */
 const workspaceOrchestrator = (options) => {
-	const { upstream, hmrWatchPaths = [], reloadWatchPaths = [], debounceMs = DEFAULT_DEBOUNCE_MS, fileServers = [] } = options;
+	const { upstream, outputWatchPaths = [], debounceMs = DEFAULT_DEBOUNCE_MS, fileServers = [] } = options;
 	return {
 		apply: "serve",
 		name: "workspace-orchestrator",
@@ -181,13 +187,10 @@ const workspaceOrchestrator = (options) => {
 				});
 				fsWatchers.push(watcher);
 			} catch {}
-			for (const hmrPath of hmrWatchPaths) server.watcher.add(hmrPath);
-			for (const reloadPath of reloadWatchPaths) try {
-				const watcher = watch(reloadPath, { recursive: true }, (_event, filename) => {
+			for (const outputPath of outputWatchPaths) try {
+				const watcher = watch(outputPath, { recursive: true }, (_event, filename) => {
 					if (filename === null) return;
-					const fullPath = resolve(reloadPath, filename);
-					logger.info(`[orchestrator] invalidating ${fullPath}`, { timestamp: true });
-					server.watcher.emit("change", fullPath);
+					server.watcher.emit("change", resolve(outputPath, filename));
 				});
 				fsWatchers.push(watcher);
 			} catch {}

package/package.json

@@ -1,32 +1,43 @@
 {
   "name": "@pantoken/vite-workspace-orchestrator",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "Vite dev-server plugin that watches upstream workspace packages and rebuilds them (and their dependents) when source changes.",
+  "homepage": "https://pantoken.iywahl.com",
+  "bugs": "https://github.com/thedannywahl/pantoken/issues",
   "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/thedannywahl/pantoken.git",
+    "directory": "plugins/vite/workspace-orchestrator"
+  },
   "files": [
     "dist"
   ],
   "type": "module",
+  "sideEffects": false,
   "exports": {
     ".": "./dist/index.mjs",
     "./package.json": "./package.json"
   },
   "publishConfig": {
-    "access": "public"
+    "access": "public",
+    "provenance": true
+  },
+  "scripts": {
+    "dev": "vp pack --watch",
+    "test": "vp test",
+    "check": "vp check"
   },
   "devDependencies": {
-    "@types/node": "^24.13.3",
-    "typescript": "^6.0.3",
-    "vite": "npm:@voidzero-dev/vite-plus-core@0.2.4",
-    "vite-plus": "0.2.4"
+    "@types/node": "catalog:",
+    "typescript": "catalog:",
+    "vite": "catalog:",
+    "vite-plus": "catalog:"
   },
   "peerDependencies": {
     "vite": ">=6"
   },
-  "scripts": {
-    "build": "vp pack",
-    "dev": "vp pack --watch",
-    "test": "vp test",
-    "check": "vp check"
+  "engines": {
+    "node": ">=22.18.0"
   }
-}
+}