@motion-proto/live-tokens 0.74.0 → 0.76.0

package/dist-plugin/index.js

@@ -5,7 +5,7 @@ import {
   nextAvailableName,
   normalizeTheme,
   versionedFileResourceServer
-} from "./chunk-7VRTBGJT.js";
+} from "./chunk-PDNL4NC5.js";
 import {
   formatGradientValue,
   palettesToVars,
@@ -16,7 +16,7 @@ import {
 } from "./chunk-O6GQ6GBH.js";
 import {
   CURRENT_COMPONENT_SCHEMA_VERSION
-} from "./chunk-V3YF6CGT.js";
+} from "./chunk-SWXRVZKT.js";
 import {
   TOKENS_CSS_MIGRATIONS,
   extractGlobalRootBody,
@@ -30,12 +30,14 @@ import {
   parseOklchCss
 } from "./chunk-7TQQTHI6.js";
 import {
-  resolveDataDirs
-} from "./chunk-W6Y4BWFB.js";
+  resolveDataDirs,
+  testDataDir,
+  testPackageDataDir
+} from "./chunk-6WGFOJXO.js";
 
 // vite-plugin/themeFileApi.ts
-import fs from "fs";
-import path from "path";
+import fs2 from "fs";
+import path2 from "path";
 
 // src/editor/core/themes/migrations/2026-07-21-palette-oklch-basis.ts
 var round = (v, dp) => {
@@ -166,18 +168,79 @@ async function dispatch(req, res, routes) {
   return false;
 }
 
+// vite-plugin/files/dataTreeWatch.ts
+import fs from "fs";
+import path from "path";
+function fingerprint(file) {
+  try {
+    return fs.readFileSync(file, "utf-8");
+  } catch {
+    return null;
+  }
+}
+function dataTreeWatch(opts) {
+  const debounceMs = opts.debounceMs ?? 100;
+  const ownWrites = /* @__PURE__ */ new Map();
+  const listeners = /* @__PURE__ */ new Set();
+  let watchers = [];
+  let timer = null;
+  function noteOwnWrite(file) {
+    const resolved = path.resolve(file);
+    ownWrites.set(resolved, fingerprint(resolved));
+  }
+  function onEvent(dir, filename) {
+    if (!filename) return;
+    const file = path.resolve(dir, filename.toString());
+    if (!opts.isLive(file)) return;
+    if (ownWrites.has(file) && ownWrites.get(file) === fingerprint(file)) return;
+    ownWrites.delete(file);
+    if (timer) clearTimeout(timer);
+    timer = setTimeout(() => {
+      timer = null;
+      for (const listener of listeners) listener();
+    }, debounceMs);
+  }
+  function start() {
+    for (const dir of opts.dirs) {
+      if (!fs.existsSync(dir)) continue;
+      const watcher = fs.watch(
+        dir,
+        { recursive: true, persistent: false },
+        (_event, filename) => onEvent(dir, filename)
+      );
+      watcher.on("error", () => watcher.close());
+      watchers.push(watcher);
+    }
+  }
+  function stop() {
+    for (const watcher of watchers) watcher.close();
+    watchers = [];
+    if (timer) clearTimeout(timer);
+    timer = null;
+  }
+  function subscribe(listener) {
+    if (listeners.size === 0) start();
+    listeners.add(listener);
+    return () => {
+      listeners.delete(listener);
+      if (listeners.size === 0) stop();
+    };
+  }
+  return { noteOwnWrite, subscribe };
+}
+
 // vite-plugin/themeFileApi.ts
 import { fileURLToPath } from "url";
 var PKG_VERSION = (() => {
   try {
-    let dir = path.dirname(fileURLToPath(import.meta.url));
+    let dir = path2.dirname(fileURLToPath(import.meta.url));
     for (let i = 0; i < 4; i++) {
-      const p = path.join(dir, "package.json");
-      if (fs.existsSync(p)) {
-        const json = JSON.parse(fs.readFileSync(p, "utf-8"));
+      const p = path2.join(dir, "package.json");
+      if (fs2.existsSync(p)) {
+        const json = JSON.parse(fs2.readFileSync(p, "utf-8"));
         if (json?.name === "@motion-proto/live-tokens") return json.version ?? "";
       }
-      const up = path.dirname(dir);
+      const up = path2.dirname(dir);
       if (up === dir) break;
       dir = up;
     }
@@ -221,56 +284,64 @@ function themeFileApi(opts) {
   const COMPONENT_CONFIGS_DIR = dataDirs.componentConfigsDir;
   const THEMES_DIR = dataDirs.themesDir;
   const SKETCH_STYLES_DIR = dataDirs.sketchStylesDir;
-  const CSS_PATH = path.resolve(opts.tokensCssPath);
-  const GENERATED_CSS_PATH = opts.tokensGeneratedCssPath ? path.resolve(opts.tokensGeneratedCssPath) : path.join(dataDirs.dataDir, "tokens.generated.css");
-  const FONTS_CSS_PATH = opts.fontsCssPath ? path.resolve(opts.fontsCssPath) : path.join(path.dirname(CSS_PATH), "fonts.css");
+  const CSS_PATH = path2.resolve(opts.tokensCssPath);
+  const ISOLATED_DATA_DIR = testDataDir();
+  const GENERATED_CSS_PATH = ISOLATED_DATA_DIR ? path2.join(ISOLATED_DATA_DIR, "tokens.generated.css") : opts.tokensGeneratedCssPath ? path2.resolve(opts.tokensGeneratedCssPath) : path2.join(dataDirs.dataDir, "tokens.generated.css");
+  const FONTS_CSS_PATH = ISOLATED_DATA_DIR ? path2.join(ISOLATED_DATA_DIR, "fonts.css") : opts.fontsCssPath ? path2.resolve(opts.fontsCssPath) : path2.join(path2.dirname(CSS_PATH), "fonts.css");
   const API_BASE = opts.apiBase ?? "/api/live-tokens";
-  const consumerComponentDirs = opts.componentsSrcDir ? [path.resolve(opts.componentsSrcDir)] : [path.resolve("src/components"), path.resolve("src/system/components")];
-  const packageComponentsDir = path.resolve(
-    path.dirname(fileURLToPath(import.meta.url)),
+  const consumerComponentDirs = opts.componentsSrcDir ? [path2.resolve(opts.componentsSrcDir)] : [path2.resolve("src/components"), path2.resolve("src/system/components")];
+  const packageComponentsDir = path2.resolve(
+    path2.dirname(fileURLToPath(import.meta.url)),
     "..",
     "src",
     "system",
     "components"
   );
-  const packageDataDir = path.resolve(
-    path.dirname(fileURLToPath(import.meta.url)),
+  const packageDataDir = testPackageDataDir() ?? path2.resolve(
+    path2.dirname(fileURLToPath(import.meta.url)),
     "..",
     "src",
     "live-tokens",
     "data"
   );
-  const packageColorsAndTypeDir = path.join(packageDataDir, "colors-and-type");
-  const packageThemesDir = path.join(packageDataDir, "themes");
-  const packageComponentConfigsDir = path.join(packageDataDir, "component-configs");
-  const packageSketchStylesDir = path.join(packageDataDir, "sketch-styles");
+  const packageColorsAndTypeDir = path2.join(packageDataDir, "colors-and-type");
+  const packageThemesDir = path2.join(packageDataDir, "themes");
+  const packageComponentConfigsDir = path2.join(packageDataDir, "component-configs");
+  const packageSketchStylesDir = path2.join(packageDataDir, "sketch-styles");
   function shippedNames(dataDir, subdir) {
     try {
-      const pkgRoot = path.resolve(dataDir, "..", "..", "..");
-      const pkg = JSON.parse(fs.readFileSync(path.join(pkgRoot, "package.json"), "utf-8"));
+      const pkgRoot = path2.resolve(dataDir, "..", "..", "..");
+      const pkg = JSON.parse(fs2.readFileSync(path2.join(pkgRoot, "package.json"), "utf-8"));
       const files = Array.isArray(pkg.files) ? pkg.files : [];
       const owned = new RegExp(`^src/live-tokens/data/${subdir}/[^/]+\\.json$`);
-      return files.filter((f) => owned.test(f)).map((f) => path.basename(f, ".json"));
+      return files.filter((f) => owned.test(f)).map((f) => path2.basename(f, ".json"));
     } catch {
       return [];
     }
   }
   const COMPONENTS_SCAN_DIRS = [...consumerComponentDirs];
-  if (!COMPONENTS_SCAN_DIRS.includes(packageComponentsDir) && fs.existsSync(packageComponentsDir)) {
+  if (!COMPONENTS_SCAN_DIRS.includes(packageComponentsDir) && fs2.existsSync(packageComponentsDir)) {
     COMPONENTS_SCAN_DIRS.push(packageComponentsDir);
   }
+  const isLiveStateFile = (file) => file === path2.join(THEMES_DIR, "_active.json") || path2.basename(file) === "_working.json" && (file.startsWith(COLORS_AND_TYPE_DIR + path2.sep) || file.startsWith(COMPONENT_CONFIGS_DIR + path2.sep));
+  const liveWatch = dataTreeWatch({
+    dirs: [COLORS_AND_TYPE_DIR, COMPONENT_CONFIGS_DIR, THEMES_DIR],
+    isLive: isLiveStateFile
+  });
   const colorsAndTypeResource = versionedFileResourceServer({
     dir: COLORS_AND_TYPE_DIR,
     packageDir: packageColorsAndTypeDir,
-    packageOwnedNames: shippedNames(packageDataDir, "colors-and-type")
+    packageOwnedNames: shippedNames(packageDataDir, "colors-and-type"),
+    onWrite: liveWatch.noteOwnWrite
   });
   const componentResourceCache = /* @__PURE__ */ new Map();
   function componentResource(comp) {
     let r = componentResourceCache.get(comp);
     if (!r) {
       r = versionedFileResourceServer({
-        dir: path.join(COMPONENT_CONFIGS_DIR, comp),
-        packageDir: path.join(packageComponentConfigsDir, comp)
+        dir: path2.join(COMPONENT_CONFIGS_DIR, comp),
+        packageDir: path2.join(packageComponentConfigsDir, comp),
+        onWrite: liveWatch.noteOwnWrite
       });
       componentResourceCache.set(comp, r);
     }
@@ -278,7 +349,8 @@ function themeFileApi(opts) {
   }
   const themesResource = versionedFileResourceServer({
     dir: THEMES_DIR,
-    packageDir: packageThemesDir
+    packageDir: packageThemesDir,
+    onWrite: liveWatch.noteOwnWrite
   });
   const sketchStylesResource = versionedFileResourceServer({
     dir: SKETCH_STYLES_DIR,
@@ -359,7 +431,7 @@ function themeFileApi(opts) {
     const productionThemeName = themesResource.getProductionName();
     const productionTheme = readTheme(productionThemeName)?.theme ?? null;
     if (themesResource.existingPath(productionThemeName) !== null && !productionTheme?.colorsAndType) {
-      const tail = `${path.basename(GENERATED_CSS_PATH)} was left as it was.`;
+      const tail = `${path2.basename(GENERATED_CSS_PATH)} was left as it was.`;
       throw new Error(
         unreadableThemeReason(productionThemeName) === "colors-and-type" ? `[live-tokens] ${notAThemeError(productionThemeName)} ${tail}` : `[live-tokens] Production theme "${productionThemeName}" is unreadable, so ${tail} Repair the theme file or adopt another theme.`
       );
@@ -397,7 +469,7 @@ function themeFileApi(opts) {
       }
     }
     let componentOverrideCount = 0;
-    if (fs.existsSync(COMPONENT_CONFIGS_DIR)) {
+    if (fs2.existsSync(COMPONENT_CONFIGS_DIR)) {
       const blocks = [];
       for (const comp of listComponentNames()) {
         const prodCfg = productionTheme?.componentConfigs[comp];
@@ -430,12 +502,12 @@ function themeFileApi(opts) {
         lines.push("");
       }
     }
-    if (!fs.existsSync(path.dirname(GENERATED_CSS_PATH))) {
-      fs.mkdirSync(path.dirname(GENERATED_CSS_PATH), { recursive: true });
+    if (!fs2.existsSync(path2.dirname(GENERATED_CSS_PATH))) {
+      fs2.mkdirSync(path2.dirname(GENERATED_CSS_PATH), { recursive: true });
     }
-    fs.writeFileSync(GENERATED_CSS_PATH, lines.join("\n"));
+    fs2.writeFileSync(GENERATED_CSS_PATH, lines.join("\n"));
     console.log(
-      `[regenerateTokensCss] Wrote ${path.basename(GENERATED_CSS_PATH)} (${colorsAndTypeVarCount} theme vars, ${componentOverrideCount} component overrides)`
+      `[regenerateTokensCss] Wrote ${path2.basename(GENERATED_CSS_PATH)} (${colorsAndTypeVarCount} theme vars, ${componentOverrideCount} component overrides)`
     );
   }
   function syncFontsToCss(colorsAndTypeData) {
@@ -463,18 +535,18 @@ function themeFileApi(opts) {
       lines.push("");
     }
     const content = lines.join("\n");
-    if (!fs.existsSync(path.dirname(FONTS_CSS_PATH))) {
-      fs.mkdirSync(path.dirname(FONTS_CSS_PATH), { recursive: true });
+    if (!fs2.existsSync(path2.dirname(FONTS_CSS_PATH))) {
+      fs2.mkdirSync(path2.dirname(FONTS_CSS_PATH), { recursive: true });
     }
-    fs.writeFileSync(FONTS_CSS_PATH, content);
-    console.log(`[syncFontsToCss] Wrote ${sources.length} source(s) into ${path.basename(FONTS_CSS_PATH)}`);
+    fs2.writeFileSync(FONTS_CSS_PATH, content);
+    console.log(`[syncFontsToCss] Wrote ${sources.length} source(s) into ${path2.basename(FONTS_CSS_PATH)}`);
   }
   function componentNameFromFile(filePath) {
-    return path.basename(filePath, ".svelte").toLowerCase();
+    return path2.basename(filePath, ".svelte").toLowerCase();
   }
   function isThemeAwareComponent(filePath) {
     try {
-      const source = fs.readFileSync(filePath, "utf-8");
+      const source = fs2.readFileSync(filePath, "utf-8");
       return /:global\(:root\)\s*\{/.test(source);
     } catch {
       return false;
@@ -483,10 +555,10 @@ function themeFileApi(opts) {
   function listComponentSourcePaths() {
     const byName = /* @__PURE__ */ new Map();
     for (const dir of COMPONENTS_SCAN_DIRS) {
-      if (!fs.existsSync(dir)) continue;
-      for (const f of fs.readdirSync(dir)) {
+      if (!fs2.existsSync(dir)) continue;
+      for (const f of fs2.readdirSync(dir)) {
         if (!f.endsWith(".svelte")) continue;
-        const full = path.join(dir, f);
+        const full = path2.join(dir, f);
         if (!isThemeAwareComponent(full)) continue;
         const name = componentNameFromFile(f);
         if (!byName.has(name)) byName.set(name, full);
@@ -500,18 +572,18 @@ function themeFileApi(opts) {
   function warnOnTokenDrift(log) {
     let tokensCss = "";
     try {
-      tokensCss = fs.readFileSync(CSS_PATH, "utf-8");
+      tokensCss = fs2.readFileSync(CSS_PATH, "utf-8");
     } catch {
       return;
     }
     let generatedCss = "";
     try {
-      generatedCss = fs.readFileSync(GENERATED_CSS_PATH, "utf-8");
+      generatedCss = fs2.readFileSync(GENERATED_CSS_PATH, "utf-8");
     } catch {
     }
     const componentSources = listComponentSourcePaths().map((p) => ({
       name: componentNameFromFile(p),
-      source: fs.readFileSync(p, "utf-8")
+      source: fs2.readFileSync(p, "utf-8")
     }));
     const missing = validateTokensCss({ tokensCss, generatedCss, componentSources });
     if (missing.length === 0) return;
@@ -519,7 +591,7 @@ function themeFileApi(opts) {
       (m) => `  ${m.token}  (referenced by ${m.referencedBy.join(", ")})`
     );
     log(
-      `[live-tokens] ${missing.length} token(s) referenced by components are not defined in ${path.relative(process.cwd(), CSS_PATH)}:
+      `[live-tokens] ${missing.length} token(s) referenced by components are not defined in ${path2.relative(process.cwd(), CSS_PATH)}:
 ${lines.join("\n")}
   These render as blank/empty editor slots. Run \`npx live-tokens migrate\` to reconcile.`
     );
@@ -527,30 +599,30 @@ ${lines.join("\n")}
   function autoMigrateAdditive(log) {
     let before = "";
     try {
-      before = fs.readFileSync(CSS_PATH, "utf-8");
+      before = fs2.readFileSync(CSS_PATH, "utf-8");
     } catch {
       return;
     }
     const { css, applied, changed } = runAdditiveTokensCssMigrations(before);
     if (!changed) return;
-    fs.writeFileSync(CSS_PATH, css);
+    fs2.writeFileSync(CSS_PATH, css);
     log(
-      `[live-tokens] autoMigrate applied ${applied.length} additive migration(s) to ${path.relative(process.cwd(), CSS_PATH)}: ${applied.join(", ")}. Review the diff in git.`
+      `[live-tokens] autoMigrate applied ${applied.length} additive migration(s) to ${path2.relative(process.cwd(), CSS_PATH)}: ${applied.join(", ")}. Review the diff in git.`
     );
   }
   function generateDefaultConfig(comp, sourcePath) {
-    if (!fs.existsSync(sourcePath)) return;
+    if (!fs2.existsSync(sourcePath)) return;
     const r = componentResource(comp);
     r.ensureDir();
     const defaultPath = r.filePath("default");
-    const sourceStat = fs.statSync(sourcePath);
+    const sourceStat = fs2.statSync(sourcePath);
     let createdAt = (/* @__PURE__ */ new Date()).toISOString();
     let existingUpdatedAt;
     let existingAliases;
     let existingSchemaVersion;
-    if (fs.existsSync(defaultPath)) {
+    if (fs2.existsSync(defaultPath)) {
       try {
-        const existing = JSON.parse(fs.readFileSync(defaultPath, "utf-8"));
+        const existing = JSON.parse(fs2.readFileSync(defaultPath, "utf-8"));
         if (existing.createdAt) createdAt = existing.createdAt;
         if (typeof existing.updatedAt === "string") existingUpdatedAt = existing.updatedAt;
         if (existing.aliases && typeof existing.aliases === "object") {
@@ -559,13 +631,13 @@ ${lines.join("\n")}
         if (typeof existing.schemaVersion === "number") existingSchemaVersion = existing.schemaVersion;
       } catch {
       }
-      const defaultStat = fs.statSync(defaultPath);
+      const defaultStat = fs2.statSync(defaultPath);
       if (defaultStat.mtimeMs >= sourceStat.mtimeMs && existingSchemaVersion === CURRENT_COMPONENT_SCHEMA_VERSION) {
         return;
       }
     }
     const now = (/* @__PURE__ */ new Date()).toISOString();
-    const source = fs.readFileSync(sourcePath, "utf-8");
+    const source = fs2.readFileSync(sourcePath, "utf-8");
     const body = extractGlobalRootBody(source);
     const aliases = extractAliasDeclarations(body);
     const aliasesUnchanged = existingAliases !== void 0 && JSON.stringify(existingAliases) === JSON.stringify(aliases);
@@ -580,14 +652,14 @@ ${lines.join("\n")}
     };
     if (aliasesUnchanged && schemaStampCurrent && existingUpdatedAt) {
       const t = /* @__PURE__ */ new Date();
-      fs.utimesSync(defaultPath, t, t);
+      fs2.utimesSync(defaultPath, t, t);
       return;
     }
-    fs.writeFileSync(defaultPath, JSON.stringify(defaultConfig, null, 2));
+    fs2.writeFileSync(defaultPath, JSON.stringify(defaultConfig, null, 2));
   }
   function ensureComponentConfigsDir() {
-    if (!fs.existsSync(COMPONENT_CONFIGS_DIR)) {
-      fs.mkdirSync(COMPONENT_CONFIGS_DIR, { recursive: true });
+    if (!fs2.existsSync(COMPONENT_CONFIGS_DIR)) {
+      fs2.mkdirSync(COMPONENT_CONFIGS_DIR, { recursive: true });
     }
     for (const sourcePath of listComponentSourcePaths()) {
       const comp = componentNameFromFile(sourcePath);
@@ -600,14 +672,14 @@ ${lines.join("\n")}
     const legacy = [];
     const check = (dir) => {
       for (const name of ["_active.json", "_production.json"]) {
-        const p = path.join(dir, name);
-        if (fs.existsSync(p)) legacy.push(path.relative(process.cwd(), p));
+        const p = path2.join(dir, name);
+        if (fs2.existsSync(p)) legacy.push(path2.relative(process.cwd(), p));
       }
     };
     check(COLORS_AND_TYPE_DIR);
-    if (fs.existsSync(COMPONENT_CONFIGS_DIR)) {
-      for (const entry of fs.readdirSync(COMPONENT_CONFIGS_DIR, { withFileTypes: true })) {
-        if (entry.isDirectory()) check(path.join(COMPONENT_CONFIGS_DIR, entry.name));
+    if (fs2.existsSync(COMPONENT_CONFIGS_DIR)) {
+      for (const entry of fs2.readdirSync(COMPONENT_CONFIGS_DIR, { withFileTypes: true })) {
+        if (entry.isDirectory()) check(path2.join(COMPONENT_CONFIGS_DIR, entry.name));
       }
     }
     return legacy;
@@ -615,19 +687,19 @@ ${lines.join("\n")}
   function warnOnLegacyPointers(legacy, bakeHeld, warn) {
     if (legacy.length === 0) return;
     warn(
-      `[live-tokens] ${legacy.length} legacy pointer file(s) left from the pre-working-set data model, starting with ${legacy[0]}. They are no longer read. Run \`npx live-tokens migrate\` to heal the tree.` + (bakeHeld ? ` Until then this tree has named no production theme, so ${path.basename(GENERATED_CSS_PATH)} is left exactly as it is rather than rebuilt from the default.` : "")
+      `[live-tokens] ${legacy.length} legacy pointer file(s) left from the pre-working-set data model, starting with ${legacy[0]}. They are no longer read. Run \`npx live-tokens migrate\` to heal the tree.` + (bakeHeld ? ` Until then this tree has named no production theme, so ${path2.basename(GENERATED_CSS_PATH)} is left exactly as it is rather than rebuilt from the default.` : "")
     );
   }
   function warnOnLegacyLayout(evidence, warn) {
     warn(
-      `[live-tokens] This project still uses the data layout from 0.47 and earlier: ${evidence}. Since 0.48 the whole-theme theme files live in \`themes/\` and the colors and type live in \`colors-and-type/\`. Nothing in the data directory was written, the editor cannot save, and ${path.basename(GENERATED_CSS_PATH)} is left exactly as it is. Run \`npx live-tokens migrate\` to move the directories and heal the tree, then restart the dev server.`
+      `[live-tokens] This project still uses the data layout from 0.47 and earlier: ${evidence}. Since 0.48 the whole-theme theme files live in \`themes/\` and the colors and type live in \`colors-and-type/\`. Nothing in the data directory was written, the editor cannot save, and ${path2.basename(GENERATED_CSS_PATH)} is left exactly as it is. Run \`npx live-tokens migrate\` to move the directories and heal the tree, then restart the dev server.`
     );
   }
   function warnOnUnmigratedSketchStyles(warn) {
-    const legacyDir = path.join(dataDirs.dataDir, "sketch-presets");
-    if (!fs.existsSync(legacyDir)) return;
+    const legacyDir = path2.join(dataDirs.dataDir, "sketch-presets");
+    if (!fs2.existsSync(legacyDir)) return;
     warn(
-      `[live-tokens] Saved sketchstyles still live under the retired ${path.basename(legacyDir)}/ directory name. Run \`npx live-tokens migrate\` to rename it to ${path.basename(SKETCH_STYLES_DIR)}/; until then they will not show up in the Sketchstyle view.`
+      `[live-tokens] Saved sketchstyles still live under the retired ${path2.basename(legacyDir)}/ directory name. Run \`npx live-tokens migrate\` to rename it to ${path2.basename(SKETCH_STYLES_DIR)}/; until then they will not show up in the Sketchstyle view.`
     );
   }
   const diskThemeResolvers = {
@@ -651,7 +723,7 @@ ${lines.join("\n")}
     const resolved = themesResource.existingPath(fileName);
     if (resolved === null) return "missing";
     try {
-      if (isColorsAndTypeShaped(JSON.parse(fs.readFileSync(resolved, "utf-8")))) {
+      if (isColorsAndTypeShaped(JSON.parse(fs2.readFileSync(resolved, "utf-8")))) {
         return "colors-and-type";
       }
     } catch {
@@ -659,7 +731,7 @@ ${lines.join("\n")}
     return "corrupt";
   }
   function notAThemeError(fileName) {
-    return `"${fileName}" is a colors-and-type file, not a theme. Before 0.48 those lived in themes/; move it to ${path.basename(COLORS_AND_TYPE_DIR)}/ or delete it. To build a theme, use the theme skill "create-theme".`;
+    return `"${fileName}" is a colors-and-type file, not a theme. Before 0.48 those lived in themes/; move it to ${path2.basename(COLORS_AND_TYPE_DIR)}/ or delete it. To build a theme, use the theme skill "create-theme".`;
   }
   function respondUnreadableTheme(res, fileName, missingError) {
     switch (unreadableThemeReason(fileName)) {
@@ -678,18 +750,18 @@ ${lines.join("\n")}
   }
   function writeTheme(fileName, theme) {
     themesResource.ensureDir();
-    fs.writeFileSync(themesResource.filePath(fileName), JSON.stringify(theme, null, 2));
+    fs2.writeFileSync(themesResource.filePath(fileName), JSON.stringify(theme, null, 2));
   }
   function migrateLocalThemes(warn) {
-    if (path.resolve(THEMES_DIR) === path.resolve(packageThemesDir)) return;
-    if (!fs.existsSync(THEMES_DIR)) return;
-    for (const file of fs.readdirSync(THEMES_DIR)) {
+    if (path2.resolve(THEMES_DIR) === path2.resolve(packageThemesDir)) return;
+    if (!fs2.existsSync(THEMES_DIR)) return;
+    for (const file of fs2.readdirSync(THEMES_DIR)) {
       if (!file.endsWith(".json") || file.startsWith("_")) continue;
       const fileName = file.slice(0, -".json".length);
       if (fileName === "default") continue;
       let raw;
       try {
-        raw = JSON.parse(fs.readFileSync(path.join(THEMES_DIR, file), "utf-8"));
+        raw = JSON.parse(fs2.readFileSync(path2.join(THEMES_DIR, file), "utf-8"));
       } catch {
         continue;
       }
@@ -710,7 +782,7 @@ ${lines.join("\n")}
   function ensureDefaultTheme(warn) {
     let existing = null;
     try {
-      existing = JSON.parse(fs.readFileSync(themesResource.filePath("default"), "utf-8"));
+      existing = JSON.parse(fs2.readFileSync(themesResource.filePath("default"), "utf-8"));
     } catch {
     }
     if (isColorsAndTypeShaped(existing)) {
@@ -747,9 +819,9 @@ ${lines.join("\n")}
     themesResource.ensureDir();
     ensureDefaultTheme(warn);
     migrateLocalThemes(warn);
-    const productionPointerHeld = !fs.existsSync(themesResource.productionPath) && listLegacyPointers().length > 0;
+    const productionPointerHeld = !fs2.existsSync(themesResource.productionPath) && listLegacyPointers().length > 0;
     if (productionPointerHeld) {
-      if (!fs.existsSync(themesResource.activePath)) themesResource.setActiveName("default");
+      if (!fs2.existsSync(themesResource.activePath)) themesResource.setActiveName("default");
     } else {
       themesResource.ensureMeta();
     }
@@ -828,8 +900,8 @@ ${lines.join("\n")}
   }
   function clearAllWorking() {
     colorsAndTypeResource.clearWorking();
-    if (!fs.existsSync(COMPONENT_CONFIGS_DIR)) return;
-    for (const entry of fs.readdirSync(COMPONENT_CONFIGS_DIR, { withFileTypes: true })) {
+    if (!fs2.existsSync(COMPONENT_CONFIGS_DIR)) return;
+    for (const entry of fs2.readdirSync(COMPONENT_CONFIGS_DIR, { withFileTypes: true })) {
       if (entry.isDirectory()) componentResource(entry.name).clearWorking();
     }
   }
@@ -872,6 +944,7 @@ ${lines.join("\n")}
   const SKETCH_STYLES_ROUTE = `${API_BASE}/sketch-styles`;
   const SKETCH_STYLE_BY_NAME_REGEX = new RegExp(`^${escapedBase}/sketch-styles/([a-z0-9\\-_]+)$`);
   const PRODUCTION_ROUTE = `${API_BASE}/production`;
+  const EVENTS_ROUTE = `${API_BASE}/events`;
   async function handleListColorsAndType(_ctx) {
     const files = colorsAndTypeResource.listNames().map((fileName) => {
       const data = colorsAndTypeResource.readJson(fileName);
@@ -956,15 +1029,15 @@ ${lines.join("\n")}
       }
       const body = JSON.parse(await readBody(req));
       body.updatedAt = (/* @__PURE__ */ new Date()).toISOString();
-      if (fs.existsSync(filePath)) {
+      if (fs2.existsSync(filePath)) {
         try {
-          const existing = JSON.parse(fs.readFileSync(filePath, "utf-8"));
+          const existing = JSON.parse(fs2.readFileSync(filePath, "utf-8"));
           if (existing.createdAt) body.createdAt = existing.createdAt;
         } catch {
         }
       }
       if (!body.createdAt) body.createdAt = body.updatedAt;
-      fs.writeFileSync(filePath, JSON.stringify(body, null, 2));
+      fs2.writeFileSync(filePath, JSON.stringify(body, null, 2));
       jsonResponse(res, 200, { ok: true, fileName });
       return;
     }
@@ -973,8 +1046,8 @@ ${lines.join("\n")}
         jsonResponse(res, 403, { error: "Cannot delete the default colors and type" });
         return;
       }
-      if (fs.existsSync(filePath)) {
-        fs.unlinkSync(filePath);
+      if (fs2.existsSync(filePath)) {
+        fs2.unlinkSync(filePath);
       } else if (colorsAndTypeResource.existingPath(fileName)) {
         jsonResponse(res, 403, {
           error: "Cannot delete colors and type shipped with the package. Saving it creates a local copy; deleting that copy restores the shipped version.",
@@ -1061,16 +1134,16 @@ ${lines.join("\n")}
       body.component = comp;
       body.name = body.name || name;
       body.updatedAt = (/* @__PURE__ */ new Date()).toISOString();
-      if (fs.existsSync(configPath)) {
+      if (fs2.existsSync(configPath)) {
         try {
-          const existing = JSON.parse(fs.readFileSync(configPath, "utf-8"));
+          const existing = JSON.parse(fs2.readFileSync(configPath, "utf-8"));
           if (existing.createdAt) body.createdAt = existing.createdAt;
         } catch {
         }
       }
       if (!body.createdAt) body.createdAt = body.updatedAt;
       r.ensureDir();
-      fs.writeFileSync(configPath, JSON.stringify(body, null, 2));
+      fs2.writeFileSync(configPath, JSON.stringify(body, null, 2));
       jsonResponse(res, 200, { ok: true, fileName: name });
       return;
     }
@@ -1079,7 +1152,7 @@ ${lines.join("\n")}
         jsonResponse(res, 403, { error: "Cannot delete default config" });
         return;
       }
-      if (fs.existsSync(configPath)) fs.unlinkSync(configPath);
+      if (fs2.existsSync(configPath)) fs2.unlinkSync(configPath);
       jsonResponse(res, 200, { ok: true });
       return;
     }
@@ -1087,7 +1160,7 @@ ${lines.join("\n")}
   async function handleListComponentConfigs({ params, res }) {
     const [comp] = params;
     const r = componentResource(comp);
-    if (!fs.existsSync(r.dir)) {
+    if (!fs2.existsSync(r.dir)) {
       jsonResponse(res, 404, { error: "Component not found" });
       return;
     }
@@ -1175,9 +1248,9 @@ ${lines.join("\n")}
       const body = JSON.parse(await readBody(req));
       const { theme } = normalizeTheme(body, diskThemeResolvers);
       theme.updatedAt = (/* @__PURE__ */ new Date()).toISOString();
-      if (fs.existsSync(filePath)) {
+      if (fs2.existsSync(filePath)) {
         try {
-          const existing = JSON.parse(fs.readFileSync(filePath, "utf-8"));
+          const existing = JSON.parse(fs2.readFileSync(filePath, "utf-8"));
           if (existing.createdAt) theme.createdAt = existing.createdAt;
         } catch {
         }
@@ -1199,7 +1272,7 @@ ${lines.join("\n")}
         });
         return;
       }
-      if (fs.existsSync(filePath)) {
+      if (fs2.existsSync(filePath)) {
         const deletingActive = themesResource.getActiveName() === fileName;
         const liveColors = deletingActive ? resolveLiveColorsAndType(activeTheme()) : null;
         const liveComponents = {};
@@ -1209,7 +1282,7 @@ ${lines.join("\n")}
             if (resolved) liveComponents[comp] = resolved.data;
           }
         }
-        fs.unlinkSync(filePath);
+        fs2.unlinkSync(filePath);
         if (themesResource.existingPath(fileName) === null && deletingActive) {
           themesResource.setActiveName("default");
         }
@@ -1256,30 +1329,50 @@ ${lines.join("\n")}
       return;
     }
     clearAllWorking();
-    const knownComponents = listComponentNames();
     themesResource.setActiveName(fileName);
-    const resolvedConfigs = {};
-    for (const comp of knownComponents) {
-      const resolved = resolveLiveComponentConfig(comp, theme);
-      if (resolved) resolvedConfigs[comp] = { ...resolved.data, _fileName: fileName, _source: resolved.source };
-    }
-    const resolvedColorsAndType = resolveLiveColorsAndType(theme);
+    const knownComponents = listComponentNames();
     const skippedComponents = Object.keys(theme.componentConfigs).filter(
       (comp) => !knownComponents.includes(comp)
     );
     jsonResponse(res, 200, {
       ok: true,
-      theme: { ...theme, _fileName: fileName },
-      colorsAndType: resolvedColorsAndType && {
-        ...resolvedColorsAndType.data,
-        _fileName: fileName,
-        _source: resolvedColorsAndType.source
-      },
-      componentConfigs: resolvedConfigs,
+      ...resolveLiveState(theme, fileName),
       skippedComponents,
       filled
     });
   }
+  function resolveLiveState(theme, fileName) {
+    const componentConfigs = {};
+    for (const comp of listComponentNames()) {
+      const resolved = resolveLiveComponentConfig(comp, theme);
+      if (resolved) componentConfigs[comp] = { ...resolved.data, _fileName: fileName, _source: resolved.source };
+    }
+    const colorsAndType = resolveLiveColorsAndType(theme);
+    return {
+      fileName,
+      theme: { ...theme, _fileName: fileName },
+      colorsAndType: colorsAndType && { ...colorsAndType.data, _fileName: fileName, _source: colorsAndType.source },
+      componentConfigs
+    };
+  }
+  async function handleEvents({ req, res }) {
+    res.statusCode = 200;
+    res.setHeader("Content-Type", "text/event-stream");
+    res.setHeader("Cache-Control", "no-cache");
+    res.setHeader("Connection", "keep-alive");
+    res.write(": connected\n\n");
+    const unsubscribe = liveWatch.subscribe(() => {
+      const activeFile = themesResource.getActiveName();
+      const read = readTheme(activeFile);
+      if (!read) return;
+      const state = resolveLiveState(read.theme, activeFile);
+      res.write(`event: live-state
+data: ${JSON.stringify(state)}
+
+`);
+    });
+    req.on("close", unsubscribe);
+  }
   async function handleExportTheme({ params, res }) {
     const [fileName] = params;
     if (rejectReservedName(res, fileName)) return;
@@ -1440,22 +1533,22 @@ ${lines.join("\n")}
       }
       body.name = String(body.name || fileName);
       body.updatedAt = (/* @__PURE__ */ new Date()).toISOString();
-      if (fs.existsSync(filePath)) {
+      if (fs2.existsSync(filePath)) {
         try {
-          const existing = JSON.parse(fs.readFileSync(filePath, "utf-8"));
+          const existing = JSON.parse(fs2.readFileSync(filePath, "utf-8"));
           if (existing.createdAt) body.createdAt = existing.createdAt;
         } catch {
         }
       }
       if (!body.createdAt) body.createdAt = body.updatedAt;
       sketchStylesResource.ensureDir();
-      fs.writeFileSync(filePath, JSON.stringify(body, null, 2));
+      fs2.writeFileSync(filePath, JSON.stringify(body, null, 2));
       jsonResponse(res, 200, { ok: true, fileName });
       return;
     }
     if (req.method === "DELETE") {
-      if (fs.existsSync(filePath)) {
-        fs.unlinkSync(filePath);
+      if (fs2.existsSync(filePath)) {
+        fs2.unlinkSync(filePath);
       } else if (sketchStylesResource.existingPath(fileName)) {
         jsonResponse(res, 403, {
           error: "Cannot delete a sketchstyle shipped with the package. Saving it creates a local copy; deleting that copy restores the shipped version.",
@@ -1551,12 +1644,13 @@ ${lines.join("\n")}
     { method: "PUT", pattern: SKETCH_STYLE_BY_NAME_REGEX, handler: handleSketchStyleByName },
     { method: "DELETE", pattern: SKETCH_STYLE_BY_NAME_REGEX, handler: handleSketchStyleByName },
     { method: "POST", pattern: SKETCH_STYLE_BY_NAME_REGEX, handler: methodNotAllowed },
+    { method: "GET", pattern: EVENTS_ROUTE, handler: handleEvents },
     { method: "PUT", pattern: PRODUCTION_ROUTE, handler: handleAdoptTheme },
     { method: "GET", pattern: PRODUCTION_ROUTE, handler: methodNotAllowed },
     { method: "POST", pattern: PRODUCTION_ROUTE, handler: methodNotAllowed },
     { method: "DELETE", pattern: PRODUCTION_ROUTE, handler: methodNotAllowed }
   ];
-  const isEditorOwnedJson = (file) => file.endsWith(".json") && path.resolve(file).startsWith(dataDirs.dataDir + path.sep);
+  const isEditorOwnedJson = (file) => file.endsWith(".json") && path2.resolve(file).startsWith(dataDirs.dataDir + path2.sep);
   return {
     name: "theme-file-api",
     config() {
@@ -1584,8 +1678,10 @@ ${lines.join("\n")}
         const { productionPointerHeld } = ensureThemesDir((msg) => server.config.logger.warn(msg));
         const openTheme = activeTheme();
         if (openTheme) pruneMatchingWorking(openTheme);
-        if (!productionPointerHeld || !fs.existsSync(GENERATED_CSS_PATH)) regenerateTokensCss();
-        if (opts.autoMigrate) autoMigrateAdditive((msg) => server.config.logger.info(msg));
+        if (!productionPointerHeld || !fs2.existsSync(GENERATED_CSS_PATH)) regenerateTokensCss();
+        if (opts.autoMigrate && !ISOLATED_DATA_DIR) {
+          autoMigrateAdditive((msg) => server.config.logger.info(msg));
+        }
         warnOnTokenDrift((msg) => server.config.logger.warn(msg));
         warnOnLegacyPointers(
           listLegacyPointers(),
@@ -1608,7 +1704,7 @@ ${lines.join("\n")}
     },
     handleHotUpdate(ctx) {
       if (legacyLayout) return;
-      const normalized = path.resolve(ctx.file);
+      const normalized = path2.resolve(ctx.file);
       if (!COMPONENTS_SCAN_DIRS.some((d) => normalized.startsWith(d))) return;
       if (!normalized.endsWith(".svelte")) return;
       if (!isThemeAwareComponent(normalized)) return;