@loworbitstudio/visor 1.15.0 → 1.16.1

package/dist/index.js

@@ -2,7 +2,7 @@
 
 // src/index.ts
 import { readFileSync as readFileSync32 } from "fs";
-import { dirname as dirname11, join as join30 } from "path";
+import { dirname as dirname12, join as join32 } from "path";
 import { fileURLToPath as fileURLToPath4 } from "url";
 import { Command as Command2 } from "commander";
 
@@ -2792,8 +2792,8 @@ function infoCommand(name, cwd, options = {}) {
 }
 
 // src/commands/theme-apply.ts
-import { readFileSync as readFileSync12, writeFileSync as writeFileSync6, mkdirSync as mkdirSync4 } from "fs";
-import { resolve as resolve5, dirname as dirname6, join as join12 } from "path";
+import { readFileSync as readFileSync13, writeFileSync as writeFileSync8, mkdirSync as mkdirSync6 } from "fs";
+import { resolve as resolve7, dirname as dirname7, join as join15 } from "path";
 import { generateTheme, generateThemeData as generateThemeData3 } from "@loworbitstudio/visor-theme-engine";
 import {
   nextjsAdapter as nextjsAdapter2,
@@ -2802,6 +2802,143 @@ import {
   docsAdapter,
   flutterAdapter
 } from "@loworbitstudio/visor-theme-engine/adapters";
+
+// src/lib/blessed-manifest.ts
+import { existsSync as existsSync10, readFileSync as readFileSync12 } from "fs";
+import { join as join12 } from "path";
+import { z } from "zod";
+var BLESSED_MANIFEST_FILENAME = "blessed-manifest.json";
+var themeApplyTargetSchema = z.discriminatedUnion("kind", [
+  z.object({
+    kind: z.literal("globals-css"),
+    /** Build-root-relative destination file. Defaults to `app/globals.css`. */
+    path: z.string().min(1).optional()
+  }).strict(),
+  z.object({
+    kind: z.literal("themes-css-dir"),
+    /** Build-root-relative directory. The adapter output is written to `<path>/<theme-id>.css`. */
+    path: z.string().min(1)
+  }).strict()
+]);
+var blessedManifestSchema = z.object({
+  /** Blessed-build shape, e.g. `admin-ui`. Matched against the `{shape}` in `blessed:{shape}:{pattern}`. */
+  shape: z.string().min(1),
+  /** Pattern name within the shape, e.g. `organization-management`. */
+  pattern: z.string().min(1),
+  /** The theme the reference build was authored + captured against. */
+  base_theme: z.string().min(1),
+  /** Minimum Visor version this build is known to work with (semver range). */
+  requires_visor: z.string().min(1),
+  /** Path (relative to the build root) to the approved capture baseline. */
+  captures_baseline: z.string().min(1),
+  /** Three-gates disposition at the time the build was blessed. */
+  three_gates_status: z.string().min(1),
+  /** Optional: where to write the nextjs-adapter CSS. Absent = `globals-css`. */
+  theme_apply_target: themeApplyTargetSchema.optional()
+}).strict();
+function parseBlessedManifest(buildDir) {
+  const manifestPath = join12(buildDir, BLESSED_MANIFEST_FILENAME);
+  if (!existsSync10(manifestPath)) {
+    return {
+      ok: false,
+      error: `this directory is not a blessed build (missing ${BLESSED_MANIFEST_FILENAME}); see docs/blessed-builds.md`
+    };
+  }
+  let raw;
+  try {
+    raw = readFileSync12(manifestPath, "utf-8");
+  } catch {
+    return { ok: false, error: `could not read ${manifestPath}` };
+  }
+  let json;
+  try {
+    json = JSON.parse(raw);
+  } catch (err) {
+    const message = err instanceof Error ? err.message : "invalid JSON";
+    return { ok: false, error: `invalid JSON in ${manifestPath}: ${message}` };
+  }
+  const result = blessedManifestSchema.safeParse(json);
+  if (!result.success) {
+    const issues = result.error.issues.map((issue) => {
+      const path2 = issue.path.join(".") || "(root)";
+      return `${path2}: ${issue.message}`;
+    }).join("; ");
+    return {
+      ok: false,
+      error: `invalid ${BLESSED_MANIFEST_FILENAME} at ${manifestPath}: ${issues}`
+    };
+  }
+  return { ok: true, manifest: result.data };
+}
+
+// src/lib/theme-apply-targets/globals-css.ts
+import { existsSync as existsSync11, mkdirSync as mkdirSync4, writeFileSync as writeFileSync6 } from "fs";
+import { dirname as dirname6, isAbsolute, join as join13, resolve as resolve5 } from "path";
+function applyGlobalsCss(input) {
+  const outFile = input.path !== void 0 ? resolveInsideBuild(input.buildDir, input.path) : resolveDefaultGlobalsCss(input.buildDir);
+  mkdirSync4(dirname6(outFile), { recursive: true });
+  writeFileSync6(outFile, input.adapterCss, "utf-8");
+  return outFile;
+}
+function resolveDefaultGlobalsCss(buildDir) {
+  const candidates = [
+    join13(buildDir, "app", "globals.css"),
+    join13(buildDir, "src", "app", "globals.css")
+  ];
+  return candidates.find((candidate) => existsSync11(candidate)) ?? candidates[0];
+}
+function resolveInsideBuild(buildDir, relativeOrAbsolute) {
+  return isAbsolute(relativeOrAbsolute) ? relativeOrAbsolute : resolve5(buildDir, relativeOrAbsolute);
+}
+
+// src/lib/theme-apply-targets/themes-css-dir.ts
+import { mkdirSync as mkdirSync5, writeFileSync as writeFileSync7 } from "fs";
+import { isAbsolute as isAbsolute2, join as join14, resolve as resolve6 } from "path";
+function applyThemesCssDir(input) {
+  const dir = isAbsolute2(input.path) ? input.path : resolve6(input.buildDir, input.path);
+  const outFile = join14(dir, `${input.themeId}.css`);
+  mkdirSync5(dir, { recursive: true });
+  writeFileSync7(outFile, input.adapterCss, "utf-8");
+  return outFile;
+}
+
+// src/lib/theme-apply-targets/index.ts
+var IMPLICIT_TARGET = { kind: "globals-css" };
+function applyThemeToBuild(input) {
+  const target = input.manifest.theme_apply_target ?? IMPLICIT_TARGET;
+  switch (target.kind) {
+    case "globals-css": {
+      const writtenPath = applyGlobalsCss({
+        buildDir: input.buildDir,
+        adapterCss: input.adapterCss,
+        path: target.path
+      });
+      return { writtenPath, target };
+    }
+    case "themes-css-dir": {
+      if (!input.themeId || input.themeId.length === 0) {
+        throw new Error(
+          `theme_apply_target kind 'themes-css-dir' requires a theme id (used to name the emitted file); see docs/blessed-builds.md`
+        );
+      }
+      const writtenPath = applyThemesCssDir({
+        buildDir: input.buildDir,
+        adapterCss: input.adapterCss,
+        themeId: input.themeId,
+        path: target.path
+      });
+      return { writtenPath, target };
+    }
+    default: {
+      const unknown = target.kind;
+      throw new Error(
+        `Unknown theme_apply_target kind: '${unknown}'. Supported: 'globals-css', 'themes-css-dir'. See docs/blessed-builds.md.`
+      );
+    }
+  }
+}
+
+// src/commands/theme-apply.ts
 function defaultOutputPath(adapter, themeName) {
   switch (adapter) {
     case "nextjs":
@@ -2823,10 +2960,10 @@ function defaultOutputPath(adapter, themeName) {
   }
 }
 function themeApplyCommand(file, cwd, options) {
-  const filePath = resolve5(cwd, file);
+  const filePath = resolve7(cwd, file);
   let yamlContent;
   try {
-    yamlContent = readFileSync12(filePath, "utf-8");
+    yamlContent = readFileSync13(filePath, "utf-8");
   } catch {
     if (options.json) {
       console.log(
@@ -2904,16 +3041,74 @@ function themeApplyCommand(file, cwd, options) {
     }
     process.exit(1);
   }
+  if (options.targetPath) {
+    if (options.adapter !== "nextjs") {
+      const message = "--target-path requires --adapter nextjs; see docs/blessed-builds.md";
+      if (options.json) console.log(JSON.stringify({ success: false, error: message }));
+      else logger.error(message);
+      process.exit(1);
+    }
+    if (css === null) {
+      process.exit(1);
+    }
+    if (!themeName || themeName.length === 0) {
+      const message = "theme config is missing a `name` \u2014 required to derive the theme id for --target-path dispatch; see docs/blessed-builds.md";
+      if (options.json) console.log(JSON.stringify({ success: false, error: message }));
+      else logger.error(message);
+      process.exit(1);
+    }
+    const buildDir = resolve7(cwd, options.targetPath);
+    const manifestResult = parseBlessedManifest(buildDir);
+    if (!manifestResult.ok) {
+      if (options.json) {
+        console.log(JSON.stringify({ success: false, error: manifestResult.error }));
+      } else {
+        logger.error(manifestResult.error);
+      }
+      process.exit(2);
+    }
+    let writtenPath;
+    try {
+      writtenPath = applyThemeToBuild({
+        manifest: manifestResult.manifest,
+        buildDir,
+        themeId: themeName,
+        adapterCss: css
+      }).writtenPath;
+    } catch (err) {
+      const message = err instanceof Error ? err.message : String(err);
+      if (options.json) console.log(JSON.stringify({ success: false, error: message }));
+      else logger.error(message);
+      process.exit(1);
+    }
+    if (options.json) {
+      console.log(
+        JSON.stringify({
+          success: true,
+          file: writtenPath,
+          adapter: options.adapter,
+          size: css.length,
+          targetPath: buildDir
+        })
+      );
+    } else {
+      logger.success(`Theme CSS written via blessed-manifest dispatch: ${writtenPath}`);
+      logger.info(`Adapter: ${options.adapter}`);
+      logger.item(`Build root: ${buildDir}`);
+      logger.item(`Size: ${formatSize(css.length)}`);
+    }
+    return;
+  }
   const outputTarget = options.output ?? defaultOutputPath(options.adapter, themeName);
-  const outputPath = resolve5(cwd, outputTarget);
+  const outputPath = resolve7(cwd, outputTarget);
   if (fileMap) {
     try {
-      mkdirSync4(outputPath, { recursive: true });
+      mkdirSync6(outputPath, { recursive: true });
       let totalBytes = 0;
       for (const [relPath, content] of Object.entries(fileMap.files)) {
-        const filePath2 = join12(outputPath, relPath);
-        mkdirSync4(dirname6(filePath2), { recursive: true });
-        writeFileSync6(filePath2, content, "utf-8");
+        const filePath2 = join15(outputPath, relPath);
+        mkdirSync6(dirname7(filePath2), { recursive: true });
+        writeFileSync8(filePath2, content, "utf-8");
         totalBytes += content.length;
       }
       if (options.json) {
@@ -2950,10 +3145,10 @@ function themeApplyCommand(file, cwd, options) {
   if (css === null) {
     process.exit(1);
   }
-  const outputDir = dirname6(outputPath);
+  const outputDir = dirname7(outputPath);
   try {
-    mkdirSync4(outputDir, { recursive: true });
-    writeFileSync6(outputPath, css, "utf-8");
+    mkdirSync6(outputDir, { recursive: true });
+    writeFileSync8(outputPath, css, "utf-8");
   } catch {
     if (options.json) {
       console.log(
@@ -2994,8 +3189,8 @@ function formatSize(bytes) {
 }
 
 // src/commands/theme-export.ts
-import { readFileSync as readFileSync13 } from "fs";
-import { resolve as resolve6 } from "path";
+import { readFileSync as readFileSync14 } from "fs";
+import { resolve as resolve8 } from "path";
 import {
   parseConfig,
   resolveConfig,
@@ -3003,10 +3198,10 @@ import {
   exportTheme
 } from "@loworbitstudio/visor-theme-engine";
 function themeExportCommand(file, cwd, options) {
-  const filePath = resolve6(cwd, file ?? ".visor.yaml");
+  const filePath = resolve8(cwd, file ?? ".visor.yaml");
   let yamlContent;
   try {
-    yamlContent = readFileSync13(filePath, "utf-8");
+    yamlContent = readFileSync14(filePath, "utf-8");
   } catch {
     if (options.json) {
       console.log(
@@ -3058,16 +3253,16 @@ function themeExportCommand(file, cwd, options) {
 }
 
 // src/commands/theme-validate.ts
-import { readFileSync as readFileSync14 } from "fs";
-import { resolve as resolve7 } from "path";
+import { readFileSync as readFileSync15 } from "fs";
+import { resolve as resolve9 } from "path";
 import { parse as parseYaml2 } from "yaml";
 import { validate } from "@loworbitstudio/visor-theme-engine";
 import pc3 from "picocolors";
 function themeValidateCommand(file, cwd, options) {
-  const filePath = resolve7(cwd, file);
+  const filePath = resolve9(cwd, file);
   let fileContent;
   try {
-    fileContent = readFileSync14(filePath, "utf-8");
+    fileContent = readFileSync15(filePath, "utf-8");
   } catch {
     if (options.json) {
       console.log(
@@ -3156,8 +3351,8 @@ function printIssue(issue) {
 
 // src/commands/theme-verify.ts
 import { spawnSync as _spawnSync } from "child_process";
-import { existsSync as existsSync10 } from "fs";
-import { resolve as resolve8 } from "path";
+import { existsSync as existsSync12 } from "fs";
+import { resolve as resolve10 } from "path";
 function themeVerifyCommand(dir, cwd, options, _spawnFn = _spawnSync) {
   const target = options.target ?? "flutter";
   if (target !== "flutter") {
@@ -3179,8 +3374,8 @@ function themeVerifyCommand(dir, cwd, options, _spawnFn = _spawnSync) {
     }
     process.exit(1);
   }
-  const dirPath = resolve8(cwd, dir);
-  if (!existsSync10(dirPath)) {
+  const dirPath = resolve10(cwd, dir);
+  if (!existsSync12(dirPath)) {
     if (options.json) {
       console.log(
         JSON.stringify({
@@ -3267,8 +3462,8 @@ function themeVerifyCommand(dir, cwd, options, _spawnFn = _spawnSync) {
 }
 
 // src/commands/theme-extract.ts
-import { readFileSync as readFileSync15, writeFileSync as writeFileSync7, existsSync as existsSync11, readdirSync as readdirSync4, statSync as statSync5 } from "fs";
-import { resolve as resolve9, join as join13, basename as basename3, extname as extname3, relative } from "path";
+import { readFileSync as readFileSync16, writeFileSync as writeFileSync9, existsSync as existsSync13, readdirSync as readdirSync4, statSync as statSync5 } from "fs";
+import { resolve as resolve11, join as join16, basename as basename3, extname as extname3, relative } from "path";
 import { stringify as stringifyYaml } from "yaml";
 import {
   extractFromCSS,
@@ -3297,8 +3492,8 @@ var CSS_DIRS = [
   "packages/design-tokens"
 ];
 function themeExtractCommand(cwd, options) {
-  const targetDir = resolve9(cwd, options.from ?? ".");
-  if (!existsSync11(targetDir)) {
+  const targetDir = resolve11(cwd, options.from ?? ".");
+  if (!existsSync13(targetDir)) {
     if (options.json) {
       console.log(JSON.stringify({ success: false, error: `Directory not found: ${targetDir}` }));
     } else {
@@ -3352,16 +3547,16 @@ function collectCSSFiles(targetDir) {
   const files = [];
   const seen = /* @__PURE__ */ new Set();
   for (const pattern2 of CSS_FILE_PATTERNS) {
-    const rootPath = join13(targetDir, pattern2);
+    const rootPath = join16(targetDir, pattern2);
     addFileIfExists(rootPath, files, seen);
     for (const dir of CSS_DIRS) {
-      const dirPath = join13(targetDir, dir, pattern2);
+      const dirPath = join16(targetDir, dir, pattern2);
       addFileIfExists(dirPath, files, seen);
     }
   }
   for (const dir of CSS_DIRS) {
-    const dirPath = join13(targetDir, dir);
-    if (existsSync11(dirPath) && statSync5(dirPath).isDirectory()) {
+    const dirPath = join16(targetDir, dir);
+    if (existsSync13(dirPath) && statSync5(dirPath).isDirectory()) {
       scanDirForCSS(dirPath, files, seen, 2);
     }
   }
@@ -3369,11 +3564,11 @@ function collectCSSFiles(targetDir) {
   return files;
 }
 function addFileIfExists(filePath, files, seen) {
-  const resolved = resolve9(filePath);
+  const resolved = resolve11(filePath);
   if (seen.has(resolved)) return;
-  if (!existsSync11(resolved)) return;
+  if (!existsSync13(resolved)) return;
   try {
-    const content = readFileSync15(resolved, "utf-8");
+    const content = readFileSync16(resolved, "utf-8");
     if (content.includes("--")) {
       files.push({ path: resolved, content });
       seen.add(resolved);
@@ -3382,7 +3577,7 @@ function addFileIfExists(filePath, files, seen) {
   }
 }
 function scanDirForCSS(dir, files, seen, maxDepth) {
-  if (!existsSync11(dir)) return;
+  if (!existsSync13(dir)) return;
   const SKIP_DIRS = /* @__PURE__ */ new Set([
     "node_modules",
     ".next",
@@ -3401,10 +3596,10 @@ function scanDirForCSS(dir, files, seen, maxDepth) {
       if (entry.isDirectory()) {
         if (SKIP_DIRS.has(entry.name)) continue;
         if (maxDepth > 0) {
-          scanDirForCSS(join13(dir, entry.name), files, seen, maxDepth - 1);
+          scanDirForCSS(join16(dir, entry.name), files, seen, maxDepth - 1);
         }
       } else if (entry.isFile() && extname3(entry.name) === ".css") {
-        addFileIfExists(join13(dir, entry.name), files, seen);
+        addFileIfExists(join16(dir, entry.name), files, seen);
       }
     }
   } catch {
@@ -3486,10 +3681,10 @@ function extractVarName(varExpr) {
 function parseNextFontFromLayouts(targetDir) {
   const fontMap = /* @__PURE__ */ new Map();
   for (const relPath of LAYOUT_FILE_PATHS) {
-    const fullPath = join13(targetDir, relPath);
-    if (!existsSync11(fullPath)) continue;
+    const fullPath = join16(targetDir, relPath);
+    if (!existsSync13(fullPath)) continue;
     try {
-      const content = readFileSync15(fullPath, "utf-8");
+      const content = readFileSync16(fullPath, "utf-8");
       parseNextFontDeclarations(content, fontMap);
     } catch {
     }
@@ -3574,10 +3769,10 @@ var MONO_FONT_NAMES = /* @__PURE__ */ new Set([
   "IBM Plex Mono"
 ]);
 function extractFontHints(targetDir) {
-  const pkgPath = join13(targetDir, "package.json");
-  if (!existsSync11(pkgPath)) return void 0;
+  const pkgPath = join16(targetDir, "package.json");
+  if (!existsSync13(pkgPath)) return void 0;
   try {
-    const pkg2 = JSON.parse(readFileSync15(pkgPath, "utf-8"));
+    const pkg2 = JSON.parse(readFileSync16(pkgPath, "utf-8"));
     const allDeps = { ...pkg2.dependencies, ...pkg2.devDependencies };
     const fonts2 = [];
     for (const [dep, _] of Object.entries(allDeps)) {
@@ -3613,10 +3808,10 @@ function extractFontHints(targetDir) {
   }
 }
 function inferThemeName(targetDir) {
-  const pkgPath = join13(targetDir, "package.json");
-  if (existsSync11(pkgPath)) {
+  const pkgPath = join16(targetDir, "package.json");
+  if (existsSync13(pkgPath)) {
     try {
-      const pkg2 = JSON.parse(readFileSync15(pkgPath, "utf-8"));
+      const pkg2 = JSON.parse(readFileSync16(pkgPath, "utf-8"));
       if (pkg2.name) {
         const name = pkg2.name.replace(/^@[\w-]+\//, "");
         return `${name}-theme`;
@@ -3653,7 +3848,7 @@ function outputJSON(result, validationResult) {
 }
 function outputYAML(result, outputPath, cwd, validationResult) {
   const yamlStr = buildAnnotatedYAML(result);
-  const outFile = resolve9(cwd, outputPath ?? ".visor.yaml");
+  const outFile = resolve11(cwd, outputPath ?? ".visor.yaml");
   const high = result.tokens.filter((t) => t.confidence === "high").length;
   const med = result.tokens.filter((t) => t.confidence === "medium").length;
   const low = result.tokens.filter((t) => t.confidence === "low").length;
@@ -3681,7 +3876,7 @@ function outputYAML(result, outputPath, cwd, validationResult) {
     }
     logger.blank();
   }
-  writeFileSync7(outFile, yamlStr, "utf-8");
+  writeFileSync9(outFile, yamlStr, "utf-8");
   logger.success(`Theme written to ${relative(cwd, outFile)}`);
   if (validationResult) {
     logger.blank();
@@ -3739,14 +3934,14 @@ function buildAnnotatedYAML(result) {
 }
 
 // src/commands/theme-register.ts
-import { readFileSync as readFileSync17, writeFileSync as writeFileSync8, mkdirSync as mkdirSync5, existsSync as existsSync13 } from "fs";
-import { resolve as resolve11, join as join15 } from "path";
+import { readFileSync as readFileSync18, writeFileSync as writeFileSync10, mkdirSync as mkdirSync7, existsSync as existsSync15 } from "fs";
+import { resolve as resolve13, join as join18 } from "path";
 import { generateThemeData as generateThemeData4 } from "@loworbitstudio/visor-theme-engine";
 import { docsAdapter as docsAdapter2 } from "@loworbitstudio/visor-theme-engine/adapters";
 
 // src/utils/theme-helpers.ts
-import { existsSync as existsSync12, lstatSync, readdirSync as readdirSync5, readFileSync as readFileSync16, readlinkSync, realpathSync, statSync as statSync6 } from "fs";
-import { resolve as resolve10, dirname as dirname7, join as join14 } from "path";
+import { existsSync as existsSync14, lstatSync, readdirSync as readdirSync5, readFileSync as readFileSync17, readlinkSync, realpathSync, statSync as statSync6 } from "fs";
+import { resolve as resolve12, dirname as dirname8, join as join17 } from "path";
 import { execFileSync as execFileSync3 } from "child_process";
 function toSlug(name) {
   return name.toLowerCase().replace(/\s+/g, "-");
@@ -3755,12 +3950,12 @@ function toLabel(name) {
   return name.split(/[\s-]+/).map((w) => w.charAt(0).toUpperCase() + w.slice(1)).join(" ");
 }
 function findRepoRoot(startDir) {
-  let current = resolve10(startDir);
+  let current = resolve12(startDir);
   while (true) {
-    if (existsSync12(join14(current, "packages", "docs"))) {
+    if (existsSync14(join17(current, "packages", "docs"))) {
       return current;
     }
-    const parent = dirname7(current);
+    const parent = dirname8(current);
     if (parent === current) break;
     current = parent;
   }
@@ -3774,9 +3969,9 @@ function findMainRepoRoot(startDir) {
       stdio: ["ignore", "pipe", "ignore"]
     }).trim();
     if (commonDir) {
-      const absoluteCommonDir = resolve10(startDir, commonDir);
-      const candidate = dirname7(absoluteCommonDir);
-      if (existsSync12(join14(candidate, "packages", "docs"))) {
+      const absoluteCommonDir = resolve12(startDir, commonDir);
+      const candidate = dirname8(absoluteCommonDir);
+      if (existsSync14(join17(candidate, "packages", "docs"))) {
         return candidate;
       }
     }
@@ -3795,10 +3990,10 @@ var BrokenSymlinkError = class extends Error {
   code = "BROKEN_SYMLINK";
 };
 function assertNoBrokenSymlinks(dir) {
-  if (!existsSync12(dir)) return;
+  if (!existsSync14(dir)) return;
   const entries = readdirSync5(dir, { withFileTypes: true });
   for (const entry of entries) {
-    const entryPath = join14(dir, entry.name);
+    const entryPath = join17(dir, entry.name);
     let lst;
     try {
       lst = lstatSync(entryPath);
@@ -3816,39 +4011,39 @@ function assertNoBrokenSymlinks(dir) {
   }
 }
 function scanParentForPrivateThemes(parentDir) {
-  if (!existsSync12(parentDir)) return [];
+  if (!existsSync14(parentDir)) return [];
   const entries = readdirSync5(parentDir, { withFileTypes: true });
   const matches = [];
   for (const entry of entries) {
     if (!entry.isDirectory() && !entry.isSymbolicLink()) continue;
-    const candidate = join14(parentDir, entry.name, "visor-themes-private", "themes");
-    if (existsSync12(candidate)) {
+    const candidate = join17(parentDir, entry.name, "visor-themes-private", "themes");
+    if (existsSync14(candidate)) {
       matches.push(candidate);
     }
   }
   return matches.sort();
 }
 function scanNestedThemeDir(dir) {
-  if (!existsSync12(dir)) return [];
+  if (!existsSync14(dir)) return [];
   assertNoBrokenSymlinks(dir);
   const entries = readdirSync5(dir, { withFileTypes: true });
   const out = [];
   for (const entry of entries) {
     if (!entry.isDirectory() && !entry.isSymbolicLink()) continue;
-    const themeFile = join14(dir, entry.name, "theme.visor.yaml");
-    if (existsSync12(themeFile)) {
+    const themeFile = join17(dir, entry.name, "theme.visor.yaml");
+    if (existsSync14(themeFile)) {
       out.push({ filePath: themeFile, slug: entry.name });
     }
   }
   return out;
 }
 function detectVisorWorkspace(cwd) {
-  let current = resolve10(cwd);
+  let current = resolve12(cwd);
   while (true) {
-    const pkgPath = join14(current, "package.json");
-    if (existsSync12(pkgPath)) {
+    const pkgPath = join17(current, "package.json");
+    if (existsSync14(pkgPath)) {
       try {
-        const pkg2 = JSON.parse(readFileSync16(pkgPath, "utf-8"));
+        const pkg2 = JSON.parse(readFileSync17(pkgPath, "utf-8"));
         const workspaces = pkg2.workspaces ?? [];
         const hasCli = workspaces.some((w) => w.includes("packages/cli"));
         const hasEngine = workspaces.some((w) => w.includes("packages/theme-engine"));
@@ -3858,7 +4053,7 @@ function detectVisorWorkspace(cwd) {
       } catch {
       }
     }
-    const parent = dirname7(current);
+    const parent = dirname8(current);
     if (parent === current) break;
     current = parent;
   }
@@ -3866,18 +4061,18 @@ function detectVisorWorkspace(cwd) {
 }
 function isLocalVisorBinary(workspaceRoot, scriptPath) {
   if (!scriptPath) return false;
-  const expectedPrefix = join14(workspaceRoot, "packages", "cli", "dist");
+  const expectedPrefix = join17(workspaceRoot, "packages", "cli", "dist");
   let resolvedScript;
   let resolvedPrefix;
   try {
     resolvedScript = realpathSync(scriptPath);
   } catch {
-    resolvedScript = resolve10(scriptPath);
+    resolvedScript = resolve12(scriptPath);
   }
   try {
     resolvedPrefix = realpathSync(expectedPrefix);
   } catch {
-    resolvedPrefix = resolve10(expectedPrefix);
+    resolvedPrefix = resolve12(expectedPrefix);
   }
   return resolvedScript.startsWith(resolvedPrefix + "/") || resolvedScript === resolvedPrefix;
 }
@@ -3967,10 +4162,10 @@ ${indent}${newEntry},
   return { updated, changed: true };
 }
 function themeRegisterCommand(file, cwd, options) {
-  const filePath = resolve11(cwd, file);
+  const filePath = resolve13(cwd, file);
   let yamlContent;
   try {
-    yamlContent = readFileSync17(filePath, "utf-8");
+    yamlContent = readFileSync18(filePath, "utf-8");
   } catch {
     if (options.json) {
       console.log(JSON.stringify({ success: false, error: `Could not read file: ${filePath}` }));
@@ -4013,11 +4208,11 @@ function themeRegisterCommand(file, cwd, options) {
     process.exit(1);
     return;
   }
-  const docsAppDir = join15(repoRoot, "packages", "docs", "app");
-  const cssFilePath = join15(docsAppDir, `${slug2}-theme.css`);
-  const globalsPath = join15(docsAppDir, "globals.css");
-  const themeConfigPath = join15(repoRoot, "packages", "docs", "lib", "theme-config.ts");
-  if (!existsSync13(docsAppDir)) {
+  const docsAppDir = join18(repoRoot, "packages", "docs", "app");
+  const cssFilePath = join18(docsAppDir, `${slug2}-theme.css`);
+  const globalsPath = join18(docsAppDir, "globals.css");
+  const themeConfigPath = join18(repoRoot, "packages", "docs", "lib", "theme-config.ts");
+  if (!existsSync15(docsAppDir)) {
     const msg = `Docs app directory not found: ${docsAppDir}`;
     if (options.json) {
       console.log(JSON.stringify({ success: false, error: msg }));
@@ -4030,8 +4225,8 @@ function themeRegisterCommand(file, cwd, options) {
   let globalsContent = "";
   let themeConfigContent = "";
   try {
-    globalsContent = readFileSync17(globalsPath, "utf-8");
-    themeConfigContent = readFileSync17(themeConfigPath, "utf-8");
+    globalsContent = readFileSync18(globalsPath, "utf-8");
+    themeConfigContent = readFileSync18(themeConfigPath, "utf-8");
   } catch (err) {
     const msg = err instanceof Error ? err.message : "Could not read docs files";
     if (options.json) {
@@ -4042,8 +4237,8 @@ function themeRegisterCommand(file, cwd, options) {
     process.exit(1);
     return;
   }
-  const cssExists = existsSync13(cssFilePath);
-  const cssChanged = !cssExists || readFileSync17(cssFilePath, "utf-8") !== css;
+  const cssExists = existsSync15(cssFilePath);
+  const cssChanged = !cssExists || readFileSync18(cssFilePath, "utf-8") !== css;
   const { updated: newGlobals, changed: globalsChanged } = insertGlobalsImport(globalsContent, slug2);
   const { updated: newThemeConfig, changed: themeConfigChanged, error: configError } = insertThemeConfig(
     themeConfigContent,
@@ -4086,14 +4281,14 @@ function themeRegisterCommand(file, cwd, options) {
   }
   try {
     if (cssChanged) {
-      mkdirSync5(docsAppDir, { recursive: true });
-      writeFileSync8(cssFilePath, css, "utf-8");
+      mkdirSync7(docsAppDir, { recursive: true });
+      writeFileSync10(cssFilePath, css, "utf-8");
     }
     if (globalsChanged) {
-      writeFileSync8(globalsPath, newGlobals, "utf-8");
+      writeFileSync10(globalsPath, newGlobals, "utf-8");
     }
     if (themeConfigChanged) {
-      writeFileSync8(themeConfigPath, newThemeConfig, "utf-8");
+      writeFileSync10(themeConfigPath, newThemeConfig, "utf-8");
     }
   } catch (err) {
     const msg = err instanceof Error ? err.message : "Write failed";
@@ -4127,8 +4322,8 @@ function themeRegisterCommand(file, cwd, options) {
 }
 
 // src/commands/theme-unregister.ts
-import { readFileSync as readFileSync18, writeFileSync as writeFileSync9, existsSync as existsSync14, unlinkSync } from "fs";
-import { join as join16 } from "path";
+import { readFileSync as readFileSync19, writeFileSync as writeFileSync11, existsSync as existsSync16, unlinkSync } from "fs";
+import { join as join19 } from "path";
 function removeGlobalsImport(content, slug2) {
   const importLine = `@import './${slug2}-theme.css';`;
   if (!content.includes(importLine)) {
@@ -4160,11 +4355,11 @@ function themeUnregisterCommand(slug2, cwd, options) {
     process.exit(1);
     return;
   }
-  const docsAppDir = join16(repoRoot, "packages", "docs", "app");
-  const cssFilePath = join16(docsAppDir, `${slug2}-theme.css`);
-  const globalsPath = join16(docsAppDir, "globals.css");
-  const themeConfigPath = join16(repoRoot, "packages", "docs", "lib", "theme-config.ts");
-  if (!existsSync14(docsAppDir)) {
+  const docsAppDir = join19(repoRoot, "packages", "docs", "app");
+  const cssFilePath = join19(docsAppDir, `${slug2}-theme.css`);
+  const globalsPath = join19(docsAppDir, "globals.css");
+  const themeConfigPath = join19(repoRoot, "packages", "docs", "lib", "theme-config.ts");
+  if (!existsSync16(docsAppDir)) {
     const msg = `Docs app directory not found: ${docsAppDir}`;
     if (options.json) {
       console.log(JSON.stringify({ success: false, error: msg }));
@@ -4177,8 +4372,8 @@ function themeUnregisterCommand(slug2, cwd, options) {
   let globalsContent = "";
   let themeConfigContent = "";
   try {
-    globalsContent = readFileSync18(globalsPath, "utf-8");
-    themeConfigContent = readFileSync18(themeConfigPath, "utf-8");
+    globalsContent = readFileSync19(globalsPath, "utf-8");
+    themeConfigContent = readFileSync19(themeConfigPath, "utf-8");
   } catch (err) {
     const msg = err instanceof Error ? err.message : "Could not read docs files";
     if (options.json) {
@@ -4189,7 +4384,7 @@ function themeUnregisterCommand(slug2, cwd, options) {
     process.exit(1);
     return;
   }
-  const cssExists = existsSync14(cssFilePath);
+  const cssExists = existsSync16(cssFilePath);
   const { updated: newGlobals, changed: globalsChanged } = removeGlobalsImport(globalsContent, slug2);
   const { updated: newThemeConfig, changed: themeConfigChanged } = removeThemeConfigEntry(themeConfigContent, slug2);
   if (!cssExists && !globalsChanged && !themeConfigChanged) {
@@ -4202,8 +4397,8 @@ function themeUnregisterCommand(slug2, cwd, options) {
   }
   try {
     if (cssExists) unlinkSync(cssFilePath);
-    if (globalsChanged) writeFileSync9(globalsPath, newGlobals, "utf-8");
-    if (themeConfigChanged) writeFileSync9(themeConfigPath, newThemeConfig, "utf-8");
+    if (globalsChanged) writeFileSync11(globalsPath, newGlobals, "utf-8");
+    if (themeConfigChanged) writeFileSync11(themeConfigPath, newThemeConfig, "utf-8");
   } catch (err) {
     const msg = err instanceof Error ? err.message : "Write failed";
     if (options.json) {
@@ -4230,15 +4425,15 @@ function themeUnregisterCommand(slug2, cwd, options) {
 
 // src/commands/theme-sync.ts
 import {
-  readFileSync as readFileSync19,
-  writeFileSync as writeFileSync10,
-  mkdirSync as mkdirSync6,
-  existsSync as existsSync15,
+  readFileSync as readFileSync20,
+  writeFileSync as writeFileSync12,
+  mkdirSync as mkdirSync8,
+  existsSync as existsSync17,
   readdirSync as readdirSync6,
   unlinkSync as unlinkSync2,
   copyFileSync
 } from "fs";
-import { join as join17, basename as basename4, resolve as resolve12, sep, relative as relative2 } from "path";
+import { join as join20, basename as basename4, resolve as resolve14, sep, relative as relative2 } from "path";
 import { parse as parseYaml3 } from "yaml";
 import { generateThemeData as generateThemeData5, validateFontCoverage, formatFontCoverageError } from "@loworbitstudio/visor-theme-engine";
 import { docsAdapter as docsAdapter3 } from "@loworbitstudio/visor-theme-engine/adapters";
@@ -4252,9 +4447,9 @@ var CUSTOM_OVERLAY_CSS_PATH = "packages/docs/app/custom-themes.generated.css";
 var CUSTOM_OVERLAY_TS_PATH = "packages/docs/lib/theme-config.custom.generated.ts";
 var CUSTOM_OVERLAY_IMPORT_LINE = "@import './custom-themes.generated.css';";
 function scanThemeDir(dir) {
-  if (!existsSync15(dir)) return [];
+  if (!existsSync17(dir)) return [];
   assertNoBrokenSymlinks(dir);
-  return readdirSync6(dir).filter((f) => f.endsWith(".visor.yaml")).map((f) => join17(dir, f));
+  return readdirSync6(dir).filter((f) => f.endsWith(".visor.yaml")).map((f) => join20(dir, f));
 }
 function resolveCustomSources(repoRoot, mainRepoRoot, warn) {
   const merged = /* @__PURE__ */ new Map();
@@ -4278,20 +4473,20 @@ function resolveCustomSources(repoRoot, mainRepoRoot, warn) {
   };
   const envPath = process.env[PRIVATE_THEMES_ENV_VAR];
   if (envPath && envPath.trim() !== "") {
-    const resolved = resolve12(envPath);
-    if (!existsSync15(resolved)) {
+    const resolved = resolve14(envPath);
+    if (!existsSync17(resolved)) {
       throw new Error(
         `${PRIVATE_THEMES_ENV_VAR} is set to "${envPath}" but the path does not exist. Expected a directory containing {slug}/theme.visor.yaml entries.`
       );
     }
     addNested(resolved, "env");
   }
-  const siblingPath = join17(mainRepoRoot, "..", "visor-themes-private", "themes");
-  const siblingExists = existsSync15(siblingPath);
+  const siblingPath = join20(mainRepoRoot, "..", "visor-themes-private", "themes");
+  const siblingExists = existsSync17(siblingPath);
   if (siblingExists) {
     addNested(siblingPath, "sibling");
   }
-  const parentDir = join17(mainRepoRoot, "..");
+  const parentDir = join20(mainRepoRoot, "..");
   const parentGlobMatches = scanParentForPrivateThemes(parentDir).filter(
     (path2) => !path2.startsWith(mainRepoRoot + sep)
   );
@@ -4312,7 +4507,7 @@ function resolveCustomSources(repoRoot, mainRepoRoot, warn) {
       }
     }
   }
-  const legacyDir = join17(repoRoot, "custom-themes");
+  const legacyDir = join20(repoRoot, "custom-themes");
   const legacyFiles = scanThemeDir(legacyDir);
   for (const legacyFile of legacyFiles) {
     const slug2 = basename4(legacyFile).replace(/\.visor\.yaml$/, "");
@@ -4369,14 +4564,14 @@ function reportBrokenSymlink(err, options) {
   }
 }
 function buildEmptySourcesMessage(mainRepoRoot) {
-  const expectedSibling = join17(mainRepoRoot, "..", "visor-themes-private");
+  const expectedSibling = join20(mainRepoRoot, "..", "visor-themes-private");
   return [
     "No theme sources discovered. Cannot proceed \u2014 refusing to wipe generated CSS.",
     "",
     "Resolution order checked:",
     `  1. Env var ${PRIVATE_THEMES_ENV_VAR} (unset or empty)`,
     `  2. Sibling checkout at ${expectedSibling}/themes/ (not found)`,
-    `  3. One-level-deeper at ${join17(mainRepoRoot, "..")}/<parent>/visor-themes-private/themes/ (not found)`,
+    `  3. One-level-deeper at ${join20(mainRepoRoot, "..")}/<parent>/visor-themes-private/themes/ (not found)`,
     "  4. Legacy custom-themes/ (no .visor.yaml files)",
     "",
     "To fix, clone the private themes repo as a sibling:",
@@ -4581,14 +4776,14 @@ function themeSyncCommand(cwd, options) {
     return;
   }
   const mainRepoRoot = findMainRepoRoot(cwd) ?? repoRoot;
-  const themesDir = join17(repoRoot, "themes");
-  const docsAppDir = join17(repoRoot, "packages", "docs", "app");
-  const docsLibDir = join17(repoRoot, "packages", "docs", "lib");
-  const docsPublicThemesDir = join17(repoRoot, "packages", "docs", "public", "themes");
-  const themeConfigPath = join17(repoRoot, "packages", "docs", "lib", "theme-config.ts");
-  const globalsPath = join17(docsAppDir, "globals.css");
-  const customOverlayCssPath = join17(repoRoot, CUSTOM_OVERLAY_CSS_PATH);
-  const customOverlayTsPath = join17(repoRoot, CUSTOM_OVERLAY_TS_PATH);
+  const themesDir = join20(repoRoot, "themes");
+  const docsAppDir = join20(repoRoot, "packages", "docs", "app");
+  const docsLibDir = join20(repoRoot, "packages", "docs", "lib");
+  const docsPublicThemesDir = join20(repoRoot, "packages", "docs", "public", "themes");
+  const themeConfigPath = join20(repoRoot, "packages", "docs", "lib", "theme-config.ts");
+  const globalsPath = join20(docsAppDir, "globals.css");
+  const customOverlayCssPath = join20(repoRoot, CUSTOM_OVERLAY_CSS_PATH);
+  const customOverlayTsPath = join20(repoRoot, CUSTOM_OVERLAY_TS_PATH);
   let stockFiles;
   try {
     stockFiles = scanThemeDir(themesDir);
@@ -4645,7 +4840,7 @@ function themeSyncCommand(cwd, options) {
   const processFile = (filePath, isCustom, slugOverride) => {
     let yamlContent;
     try {
-      yamlContent = readFileSync19(filePath, "utf-8");
+      yamlContent = readFileSync20(filePath, "utf-8");
     } catch {
       failures.push({ filePath, error: `Could not read: ${filePath}` });
       return;
@@ -4695,8 +4890,8 @@ function themeSyncCommand(cwd, options) {
   let globalsContent;
   let themeConfigContent;
   try {
-    globalsContent = readFileSync19(globalsPath, "utf-8");
-    themeConfigContent = readFileSync19(themeConfigPath, "utf-8");
+    globalsContent = readFileSync20(globalsPath, "utf-8");
+    themeConfigContent = readFileSync20(themeConfigPath, "utf-8");
   } catch (err) {
     const msg = err instanceof Error ? err.message : "Could not read docs files";
     if (options.json) {
@@ -4711,12 +4906,12 @@ function themeSyncCommand(cwd, options) {
   const newThemeConfig = updateStockThemeConfigBlock(themeConfigContent, stockManifest);
   const newCustomOverlayCss = generateCustomOverlayCss(customManifest);
   const newCustomOverlayTs = generateCustomOverlayTs(customManifest);
-  const existingCssFiles = existsSync15(docsAppDir) ? readdirSync6(docsAppDir).filter(
+  const existingCssFiles = existsSync17(docsAppDir) ? readdirSync6(docsAppDir).filter(
     (f) => f.endsWith("-theme.css") && f !== "custom-themes.generated.css"
   ) : [];
   const newCssSet = new Set(allSlugs.map((s) => `${s}-theme.css`));
   const staleCssFiles = existingCssFiles.filter((f) => !newCssSet.has(f));
-  const existingPublicYamls = existsSync15(docsPublicThemesDir) ? readdirSync6(docsPublicThemesDir).filter((f) => f.endsWith(".visor.yaml")) : [];
+  const existingPublicYamls = existsSync17(docsPublicThemesDir) ? readdirSync6(docsPublicThemesDir).filter((f) => f.endsWith(".visor.yaml")) : [];
   const newPublicYamlSet = new Set(manifest.map((e) => `${e.yamlFilename}.visor.yaml`));
   const stalePublicYamls = existingPublicYamls.filter((f) => !newPublicYamlSet.has(f));
   if (options.dryRun) {
@@ -4756,28 +4951,28 @@ function themeSyncCommand(cwd, options) {
     return;
   }
   try {
-    mkdirSync6(docsAppDir, { recursive: true });
-    mkdirSync6(docsLibDir, { recursive: true });
-    mkdirSync6(docsPublicThemesDir, { recursive: true });
+    mkdirSync8(docsAppDir, { recursive: true });
+    mkdirSync8(docsLibDir, { recursive: true });
+    mkdirSync8(docsPublicThemesDir, { recursive: true });
     for (const entry of manifest) {
-      writeFileSync10(join17(docsAppDir, `${entry.slug}-theme.css`), entry.css, "utf-8");
+      writeFileSync12(join20(docsAppDir, `${entry.slug}-theme.css`), entry.css, "utf-8");
     }
     for (const stale of staleCssFiles) {
-      unlinkSync2(join17(docsAppDir, stale));
+      unlinkSync2(join20(docsAppDir, stale));
     }
-    writeFileSync10(customOverlayCssPath, newCustomOverlayCss, "utf-8");
-    writeFileSync10(customOverlayTsPath, newCustomOverlayTs, "utf-8");
-    writeFileSync10(themeConfigPath, newThemeConfig, "utf-8");
-    writeFileSync10(globalsPath, newGlobals, "utf-8");
+    writeFileSync12(customOverlayCssPath, newCustomOverlayCss, "utf-8");
+    writeFileSync12(customOverlayTsPath, newCustomOverlayTs, "utf-8");
+    writeFileSync12(themeConfigPath, newThemeConfig, "utf-8");
+    writeFileSync12(globalsPath, newGlobals, "utf-8");
     for (const srcFile of stockFiles) {
-      copyFileSync(srcFile, join17(docsPublicThemesDir, basename4(srcFile)));
+      copyFileSync(srcFile, join20(docsPublicThemesDir, basename4(srcFile)));
     }
     for (const c of customSources) {
       const targetName = c.origin === "legacy" ? basename4(c.filePath) : `${c.slug}.visor.yaml`;
-      copyFileSync(c.filePath, join17(docsPublicThemesDir, targetName));
+      copyFileSync(c.filePath, join20(docsPublicThemesDir, targetName));
     }
     for (const stale of stalePublicYamls) {
-      unlinkSync2(join17(docsPublicThemesDir, stale));
+      unlinkSync2(join20(docsPublicThemesDir, stale));
     }
   } catch (err) {
     const msg = err instanceof Error ? err.message : "Write failed";
@@ -4830,19 +5025,19 @@ function themeSyncCommand(cwd, options) {
 
 // src/commands/theme-batch-apply-flutter.ts
 import {
-  readFileSync as readFileSync20,
-  writeFileSync as writeFileSync11,
-  mkdirSync as mkdirSync7,
-  existsSync as existsSync16,
+  readFileSync as readFileSync21,
+  writeFileSync as writeFileSync13,
+  mkdirSync as mkdirSync9,
+  existsSync as existsSync18,
   readdirSync as readdirSync7,
   rmSync
 } from "fs";
-import { join as join18, basename as basename5, dirname as dirname8 } from "path";
+import { join as join21, basename as basename5, dirname as dirname9 } from "path";
 import { generateThemeData as generateThemeData6 } from "@loworbitstudio/visor-theme-engine";
 import { flutterAdapter as flutterAdapter2 } from "@loworbitstudio/visor-theme-engine/adapters";
 function scanThemeDir2(dir) {
-  if (!existsSync16(dir)) return [];
-  return readdirSync7(dir).filter((f) => f.endsWith(".visor.yaml")).map((f) => join18(dir, f)).sort();
+  if (!existsSync18(dir)) return [];
+  return readdirSync7(dir).filter((f) => f.endsWith(".visor.yaml")).map((f) => join21(dir, f)).sort();
 }
 function slugToCamel(slug2) {
   return slug2.replace(/-([a-z])/g, (_, c) => c.toUpperCase());
@@ -4975,9 +5170,9 @@ function themeBatchApplyFlutterCommand(cwd, options) {
     process.exit(1);
     return;
   }
-  const themesDir = join18(repoRoot, "themes");
-  const customThemesDir = join18(repoRoot, "custom-themes");
-  const outputDir = join18(repoRoot, "packages", "visor_themes");
+  const themesDir = join21(repoRoot, "themes");
+  const customThemesDir = join21(repoRoot, "custom-themes");
+  const outputDir = join21(repoRoot, "packages", "visor_themes");
   const stockFiles = scanThemeDir2(themesDir);
   const customFiles = scanThemeDir2(customThemesDir);
   const allFiles = [...stockFiles, ...customFiles];
@@ -4998,7 +5193,7 @@ function themeBatchApplyFlutterCommand(cwd, options) {
   for (const filePath of allFiles) {
     let yamlContent;
     try {
-      yamlContent = readFileSync20(filePath, "utf-8");
+      yamlContent = readFileSync21(filePath, "utf-8");
     } catch {
       errors.push(`Could not read: ${filePath}`);
       continue;
@@ -5077,8 +5272,8 @@ function themeBatchApplyFlutterCommand(cwd, options) {
     return;
   }
   const slugs = processed.map((p) => p.slug);
-  const libSrcDir = join18(outputDir, "lib", "src");
-  if (existsSync16(libSrcDir)) {
+  const libSrcDir = join21(outputDir, "lib", "src");
+  if (existsSync18(libSrcDir)) {
     rmSync(libSrcDir, { recursive: true, force: true });
   }
   const packageFiles = {
@@ -5090,17 +5285,17 @@ function themeBatchApplyFlutterCommand(cwd, options) {
   };
   let totalFiles = 0;
   for (const [relPath, content] of Object.entries(packageFiles)) {
-    const absPath = join18(outputDir, relPath);
-    mkdirSync7(dirname8(absPath), { recursive: true });
-    writeFileSync11(absPath, content, "utf-8");
+    const absPath = join21(outputDir, relPath);
+    mkdirSync9(dirname9(absPath), { recursive: true });
+    writeFileSync13(absPath, content, "utf-8");
     totalFiles++;
   }
   for (const { slug: slug2, tokenFiles } of processed) {
-    const themeBaseDir = join18(outputDir, "lib", "src", slug2);
+    const themeBaseDir = join21(outputDir, "lib", "src", slug2);
     for (const [relPath, content] of Object.entries(tokenFiles)) {
-      const absPath = join18(themeBaseDir, relPath);
-      mkdirSync7(dirname8(absPath), { recursive: true });
-      writeFileSync11(absPath, content, "utf-8");
+      const absPath = join21(themeBaseDir, relPath);
+      mkdirSync9(dirname9(absPath), { recursive: true });
+      writeFileSync13(absPath, content, "utf-8");
       totalFiles++;
     }
   }
@@ -5121,8 +5316,8 @@ function themeBatchApplyFlutterCommand(cwd, options) {
 }
 
 // src/commands/fonts-add.ts
-import { existsSync as existsSync17, statSync as statSync7, readdirSync as readdirSync8, readFileSync as readFileSync21 } from "fs";
-import { resolve as resolve13, basename as basename6, extname as extname4 } from "path";
+import { existsSync as existsSync19, statSync as statSync7, readdirSync as readdirSync8, readFileSync as readFileSync22 } from "fs";
+import { resolve as resolve15, basename as basename6, extname as extname4 } from "path";
 import { S3Client, PutObjectCommand } from "@aws-sdk/client-s3";
 function deriveFamilySlug(filename) {
   const name = basename6(filename, extname4(filename));
@@ -5166,8 +5361,8 @@ function deriveFamilySlug(filename) {
   return parts.join("-").toLowerCase();
 }
 function collectWoff2Files(inputPath) {
-  const resolved = resolve13(inputPath);
-  if (!existsSync17(resolved)) {
+  const resolved = resolve15(inputPath);
+  if (!existsSync19(resolved)) {
     throw new Error(`Path not found: ${resolved}`);
   }
   const stat = statSync7(resolved);
@@ -5180,7 +5375,7 @@ function collectWoff2Files(inputPath) {
     return [resolved];
   }
   if (stat.isDirectory()) {
-    const files = readdirSync8(resolved).filter((f) => extname4(f).toLowerCase() === ".woff2").map((f) => resolve13(resolved, f));
+    const files = readdirSync8(resolved).filter((f) => extname4(f).toLowerCase() === ".woff2").map((f) => resolve15(resolved, f));
     if (files.length === 0) {
       throw new Error(
         `No .woff2 files found in directory: ${resolved}`
@@ -5195,8 +5390,8 @@ function collectWoff2Files(inputPath) {
   throw new Error(`Path is neither a file nor a directory: ${resolved}`);
 }
 function getNonWoff2Fonts(inputPath) {
-  const resolved = resolve13(inputPath);
-  if (!existsSync17(resolved) || !statSync7(resolved).isDirectory()) {
+  const resolved = resolve15(inputPath);
+  if (!existsSync19(resolved) || !statSync7(resolved).isDirectory()) {
     return [];
   }
   return readdirSync8(resolved).filter((f) => {
@@ -5233,7 +5428,7 @@ function createR2Client(config) {
   });
 }
 async function uploadFile(client, bucket, key, filePath) {
-  const body = readFileSync21(filePath);
+  const body = readFileSync22(filePath);
   await client.send(
     new PutObjectCommand({
       Bucket: bucket,
@@ -5249,7 +5444,7 @@ async function fontsAddCommand(inputPath, options) {
     const r2Config = getR2Config();
     const files = collectWoff2Files(inputPath);
     const familySlug = options.family ?? deriveFamilySlug(basename6(files[0]));
-    const resolved = resolve13(inputPath);
+    const resolved = resolve15(inputPath);
     const nonWoff2 = statSync7(resolved).isDirectory() ? getNonWoff2Fonts(resolved) : [];
     if (!json) {
       logger.heading("Visor Font Upload");
@@ -5537,27 +5732,27 @@ function findCssFiles(dir, maxDepth = 3) {
 }
 
 // src/utils/patterns.ts
-import { existsSync as existsSync19, readdirSync as readdirSync10, readFileSync as readFileSync23 } from "fs";
-import { join as join20 } from "path";
+import { existsSync as existsSync21, readdirSync as readdirSync10, readFileSync as readFileSync24 } from "fs";
+import { join as join23 } from "path";
 import { parse as parseYAML } from "yaml";
 function loadPatternsFromYaml(repoRoot) {
-  const patternsDir = join20(repoRoot, "patterns");
-  if (!existsSync19(patternsDir)) return [];
+  const patternsDir = join23(repoRoot, "patterns");
+  if (!existsSync21(patternsDir)) return [];
   const files = readdirSync10(patternsDir).filter(
     (f) => f.endsWith(".visor-pattern.yaml")
   );
   return files.map((file) => {
-    const content = readFileSync23(join20(patternsDir, file), "utf-8");
+    const content = readFileSync24(join23(patternsDir, file), "utf-8");
     return parseYAML(content);
   }).filter(Boolean);
 }
 function findRepoRoot2(startDir) {
   let current = startDir;
   while (true) {
-    if (existsSync19(join20(current, "patterns"))) {
+    if (existsSync21(join23(current, "patterns"))) {
       return current;
     }
-    const parent = join20(current, "..");
+    const parent = join23(current, "..");
     if (parent === current) return null;
     current = parent;
   }
@@ -5936,8 +6131,8 @@ Visor Tokens (${categoryLabel}) \u2014 ${tokens2.length} tokens
 }
 
 // src/commands/migrate-token-substitution.ts
-import { readFileSync as readFileSync24, writeFileSync as writeFileSync12, readdirSync as readdirSync11, statSync as statSync8, existsSync as existsSync20 } from "fs";
-import { resolve as resolve14, join as join21, relative as relative4 } from "path";
+import { readFileSync as readFileSync25, writeFileSync as writeFileSync14, readdirSync as readdirSync11, statSync as statSync8, existsSync as existsSync22 } from "fs";
+import { resolve as resolve16, join as join24, relative as relative4 } from "path";
 import { parse as parseYaml4 } from "yaml";
 import pc4 from "picocolors";
 var V7_ENTR_SUBSTITUTION_MAP = {
@@ -5960,14 +6155,14 @@ var BUILT_IN_SUBSTITUTION_MAPS = {
 var DEFAULT_THEME_ID = "entr";
 function readMapFromThemeFile(themeId, cwd) {
   const candidates = [
-    join21(cwd, "themes", `${themeId}.visor.yaml`),
-    join21(cwd, "custom-themes", `${themeId}.visor.yaml`),
-    join21(cwd, "packages", "docs", "public", "themes", `${themeId}.visor.yaml`)
+    join24(cwd, "themes", `${themeId}.visor.yaml`),
+    join24(cwd, "custom-themes", `${themeId}.visor.yaml`),
+    join24(cwd, "packages", "docs", "public", "themes", `${themeId}.visor.yaml`)
   ];
   for (const candidate of candidates) {
-    if (existsSync20(candidate)) {
+    if (existsSync22(candidate)) {
       try {
-        const raw = readFileSync24(candidate, "utf-8");
+        const raw = readFileSync25(candidate, "utf-8");
         const parsed = parseYaml4(raw);
         if (parsed?.migrate?.["token-substitution"]) {
           return parsed.migrate["token-substitution"];
@@ -6023,7 +6218,7 @@ function collectCssFiles(dirPath) {
   function walk2(current) {
     const entries = readdirSync11(current, { withFileTypes: true });
     for (const entry of entries) {
-      const fullPath = join21(current, entry.name);
+      const fullPath = join24(current, entry.name);
       if (entry.isDirectory()) {
         if (["node_modules", ".git", ".next", "dist", "build", ".cache"].includes(entry.name)) {
           continue;
@@ -6051,7 +6246,7 @@ function runSubstitutionPass(targetPath, map, themeId) {
   const fileResults = [];
   let totalSubstitutions = 0;
   for (const file of files) {
-    const content = readFileSync24(file, "utf-8");
+    const content = readFileSync25(file, "utf-8");
     const { newContent, substitutions } = applySubstitutionsToContent(content, map);
     if (substitutions.length > 0) {
       fileResults.push({ file, substitutions, originalContent: content, newContent });
@@ -6085,7 +6280,7 @@ function migrateTokenSubstitutionCommand(targetArg, cwd, options) {
     process.exit(1);
     return;
   }
-  const targetPath = resolve14(cwd, targetArg ?? ".");
+  const targetPath = resolve16(cwd, targetArg ?? ".");
   try {
     statSync8(targetPath);
   } catch {
@@ -6113,7 +6308,7 @@ function migrateTokenSubstitutionCommand(targetArg, cwd, options) {
   if (options.json) {
     if (apply) {
       for (const f of result.files) {
-        writeFileSync12(f.file, f.newContent, "utf-8");
+        writeFileSync14(f.file, f.newContent, "utf-8");
       }
       console.log(JSON.stringify({
         success: true,
@@ -6153,7 +6348,7 @@ function migrateTokenSubstitutionCommand(targetArg, cwd, options) {
     logger.warn(`Dry run \u2014 no files written. Re-run with ${pc4.bold("--apply")} to commit changes.`);
   } else {
     for (const f of result.files) {
-      writeFileSync12(f.file, f.newContent, "utf-8");
+      writeFileSync14(f.file, f.newContent, "utf-8");
     }
     logger.heading(`visor migrate token-substitution \u2014 applied`);
     logger.blank();
@@ -6174,23 +6369,23 @@ function migrateTokenSubstitutionCommand(targetArg, cwd, options) {
 }
 
 // src/commands/sandbox/init.ts
-import { existsSync as existsSync23, mkdirSync as mkdirSync10, readFileSync as readFileSync27, rmSync as rmSync2 } from "fs";
-import { isAbsolute as isAbsolute2, join as join24, resolve as resolve16, dirname as dirname10 } from "path";
+import { existsSync as existsSync25, mkdirSync as mkdirSync12, readFileSync as readFileSync28, rmSync as rmSync2 } from "fs";
+import { isAbsolute as isAbsolute4, join as join27, resolve as resolve18, dirname as dirname11 } from "path";
 import { fileURLToPath as fileURLToPath3 } from "url";
 import * as childProcess3 from "child_process";
 
 // src/commands/sandbox/parse-handoff.ts
-import { readFileSync as readFileSync25, existsSync as existsSync21 } from "fs";
-import { dirname as dirname9, resolve as resolve15, isAbsolute } from "path";
+import { readFileSync as readFileSync26, existsSync as existsSync23 } from "fs";
+import { dirname as dirname10, resolve as resolve17, isAbsolute as isAbsolute3 } from "path";
 function parseHandoff(handoffPath) {
-  const text = readFileSync25(handoffPath, "utf-8");
+  const text = readFileSync26(handoffPath, "utf-8");
   const lines2 = text.split("\n");
   const warnings = [];
   const pattern2 = extractPatternSlug(lines2, warnings);
   const theme2 = extractMetaField(lines2, "Theme");
   const recipePath = extractRecipePath(text, handoffPath, warnings);
   const primitives = extractPrimitives(text, warnings);
-  const { screens, mockShapes } = recipePath && existsSync21(recipePath) ? extractRecipeArtifacts(recipePath, warnings) : { screens: [], mockShapes: [] };
+  const { screens, mockShapes } = recipePath && existsSync23(recipePath) ? extractRecipeArtifacts(recipePath, warnings) : { screens: [], mockShapes: [] };
   return { pattern: pattern2, theme: theme2, recipePath, primitives, screens, mockShapes, warnings };
 }
 function extractPatternSlug(lines2, warnings) {
@@ -6221,8 +6416,8 @@ function extractRecipePath(text, handoffPath, warnings) {
     return void 0;
   }
   const href = m[2].trim();
-  if (isAbsolute(href)) return href;
-  return resolve15(dirname9(handoffPath), href);
+  if (isAbsolute3(href)) return href;
+  return resolve17(dirname10(handoffPath), href);
 }
 var STATUS_PATTERNS = [
   { re: /NEW\s+gap/i, status: "gap-new" },
@@ -6269,7 +6464,7 @@ function extractPrimitives(text, warnings) {
   return primitives;
 }
 function extractRecipeArtifacts(recipePath, warnings) {
-  const text = readFileSync25(recipePath, "utf-8");
+  const text = readFileSync26(recipePath, "utf-8");
   const screens = extractScreens(text);
   const mockShapes = extractMockFields(text, warnings);
   return { screens, mockShapes };
@@ -6343,8 +6538,8 @@ function tryPort(port) {
 }
 
 // src/commands/sandbox/scaffold.ts
-import { mkdirSync as mkdirSync8, writeFileSync as writeFileSync13, existsSync as existsSync22, readdirSync as readdirSync12 } from "fs";
-import { join as join22 } from "path";
+import { mkdirSync as mkdirSync10, writeFileSync as writeFileSync15, existsSync as existsSync24, readdirSync as readdirSync12 } from "fs";
+import { join as join25 } from "path";
 
 // src/commands/sandbox/templates.ts
 var SANDBOX_PACKAGE_VERSION = "16.2.6";
@@ -6844,12 +7039,12 @@ function toPascalCase(s) {
 
 // src/commands/sandbox/scaffold.ts
 function writeScaffold(sandboxDir, manifest, port, options = {}) {
-  mkdirSync8(sandboxDir, { recursive: true });
+  mkdirSync10(sandboxDir, { recursive: true });
   const created = [];
   const writeIfNew = (rel, contents) => {
-    const full = join22(sandboxDir, rel);
-    mkdirSync8(dirOf(full), { recursive: true });
-    writeFileSync13(full, contents, "utf-8");
+    const full = join25(sandboxDir, rel);
+    mkdirSync10(dirOf(full), { recursive: true });
+    writeFileSync15(full, contents, "utf-8");
     created.push(rel);
   };
   writeIfNew("package.json", packageJsonTemplate(manifest.pattern));
@@ -6875,7 +7070,7 @@ function writeScaffold(sandboxDir, manifest, port, options = {}) {
     }
   }
   writeIfNew("playwright.capture.mjs", captureScriptTemplate());
-  mkdirSync8(join22(sandboxDir, "captures", "approved"), { recursive: true });
+  mkdirSync10(join25(sandboxDir, "captures", "approved"), { recursive: true });
   return { created };
 }
 function dirOf(p) {
@@ -6909,10 +7104,10 @@ function writeSandboxConfig(sandboxDir, manifest, port, options) {
       stripChromeSelectors: options.prototypeImport.stripChromeSelectors
     } : null
   };
-  writeFileSync13(join22(sandboxDir, "sandbox.json"), JSON.stringify(config, null, 2) + "\n", "utf-8");
+  writeFileSync15(join25(sandboxDir, "sandbox.json"), JSON.stringify(config, null, 2) + "\n", "utf-8");
 }
 function sandboxIsEmpty(sandboxDir) {
-  if (!existsSync22(sandboxDir)) return true;
+  if (!existsSync24(sandboxDir)) return true;
   try {
     return readdirSync12(sandboxDir).filter((f) => !f.startsWith(".")).length === 0;
   } catch {
@@ -6921,8 +7116,8 @@ function sandboxIsEmpty(sandboxDir) {
 }
 
 // src/commands/sandbox/html-prototype.ts
-import { mkdirSync as mkdirSync9, readdirSync as readdirSync13, readFileSync as readFileSync26, statSync as statSync9, writeFileSync as writeFileSync14 } from "fs";
-import { join as join23 } from "path";
+import { mkdirSync as mkdirSync11, readdirSync as readdirSync13, readFileSync as readFileSync27, statSync as statSync9, writeFileSync as writeFileSync16 } from "fs";
+import { join as join26 } from "path";
 
 // src/commands/sandbox/strip-chrome.ts
 var DEFAULT_STRIP_SELECTORS = [
@@ -7106,8 +7301,8 @@ function stripDocumentaryChrome(html, selectors) {
 var SCREEN_FILE_PATTERN = /^screen-(\d+)-([^/.]+)\.html$/i;
 function copyHtmlPrototype(sourceDir, sandboxDir, manifest, options = {}) {
   const warnings = [];
-  const destAbs = join23(sandboxDir, "public", "prototype");
-  mkdirSync9(destAbs, { recursive: true });
+  const destAbs = join26(sandboxDir, "public", "prototype");
+  mkdirSync11(destAbs, { recursive: true });
   const stripChromeSelectors = options.stripChromeSelectors ?? [];
   const copiedFiles = copyTreeRelative(sourceDir, destAbs, "", stripChromeSelectors);
   const screenFiles = listOrderedScreenFiles(sourceDir);
@@ -7160,24 +7355,24 @@ function deriveStateCoverageScreen(file, existingNames) {
 }
 function copyTreeRelative(srcDir, destDir, relDir = "", stripChromeSelectors = []) {
   const out = [];
-  const entries = readdirSync13(join23(srcDir, relDir));
+  const entries = readdirSync13(join26(srcDir, relDir));
   for (const name of entries) {
     if (name.startsWith(".")) continue;
-    const srcPath = join23(srcDir, relDir, name);
-    const destPath = join23(destDir, relDir, name);
+    const srcPath = join26(srcDir, relDir, name);
+    const destPath = join26(destDir, relDir, name);
     const stat = statSync9(srcPath);
     if (stat.isDirectory()) {
-      mkdirSync9(destPath, { recursive: true });
-      out.push(...copyTreeRelative(srcDir, destDir, join23(relDir, name), stripChromeSelectors));
+      mkdirSync11(destPath, { recursive: true });
+      out.push(...copyTreeRelative(srcDir, destDir, join26(relDir, name), stripChromeSelectors));
     } else if (stat.isFile()) {
       if (stripChromeSelectors.length > 0 && name.toLowerCase().endsWith(".html")) {
-        const html = readFileSync26(srcPath, "utf-8");
+        const html = readFileSync27(srcPath, "utf-8");
         const stripped = stripDocumentaryChrome(html, stripChromeSelectors);
-        writeFileSync14(destPath, stripped);
+        writeFileSync16(destPath, stripped);
       } else {
-        writeFileSync14(destPath, readFileSync26(srcPath));
+        writeFileSync16(destPath, readFileSync27(srcPath));
       }
-      out.push(join23("public", "prototype", relDir, name).replace(/\\/g, "/"));
+      out.push(join26("public", "prototype", relDir, name).replace(/\\/g, "/"));
     }
   }
   return out;
@@ -7229,8 +7424,8 @@ async function runInit(name, cwd, options) {
   if (!name || !/^[a-z0-9][a-z0-9-_]*$/i.test(name)) {
     throw new Error(`Invalid sandbox name '${name}'. Use letters, digits, '-' or '_'.`);
   }
-  const handoffPath = isAbsolute2(options.handoff) ? options.handoff : resolve16(cwd, options.handoff);
-  if (!existsSync23(handoffPath)) {
+  const handoffPath = isAbsolute4(options.handoff) ? options.handoff : resolve18(cwd, options.handoff);
+  if (!existsSync25(handoffPath)) {
     throw new Error(`Handoff manifest not found: ${handoffPath}`);
   }
   const manifest = parseHandoff(handoffPath);
@@ -7239,7 +7434,7 @@ async function runInit(name, cwd, options) {
       `Handoff has no primitives \u2014 refusing to scaffold an empty sandbox. Check the manifest at ${handoffPath}`
     );
   }
-  const sandboxDir = join24(cwd, ".lo", "sandbox", name);
+  const sandboxDir = join27(cwd, ".lo", "sandbox", name);
   if (!sandboxIsEmpty(sandboxDir)) {
     if (!options.overwrite) {
       throw new Error(
@@ -7248,12 +7443,12 @@ async function runInit(name, cwd, options) {
     }
     rmSync2(sandboxDir, { recursive: true, force: true });
   }
-  mkdirSync10(sandboxDir, { recursive: true });
+  mkdirSync12(sandboxDir, { recursive: true });
   const port = await findOpenPort();
   let prototypeImport;
   if (options.fromHtmlPrototype) {
-    const prototypeDir = isAbsolute2(options.fromHtmlPrototype) ? options.fromHtmlPrototype : resolve16(cwd, options.fromHtmlPrototype);
-    if (!existsSync23(prototypeDir)) {
+    const prototypeDir = isAbsolute4(options.fromHtmlPrototype) ? options.fromHtmlPrototype : resolve18(cwd, options.fromHtmlPrototype);
+    if (!existsSync25(prototypeDir)) {
       throw new Error(`HTML prototype directory not found: ${prototypeDir}`);
     }
     const stripChromeSelectors = resolveStripSelectors(
@@ -7312,22 +7507,22 @@ async function runInit(name, cwd, options) {
 function applyThemeIfPossible(sandboxDir, manifest, theme2, cwd, json, themeFile) {
   const candidates = [];
   if (themeFile) {
-    candidates.push(isAbsolute2(themeFile) ? themeFile : resolve16(cwd, themeFile));
+    candidates.push(isAbsolute4(themeFile) ? themeFile : resolve18(cwd, themeFile));
   }
-  candidates.push(isAbsolute2(theme2) ? theme2 : resolve16(cwd, theme2));
+  candidates.push(isAbsolute4(theme2) ? theme2 : resolve18(cwd, theme2));
   const privateRoot = process.env.VISOR_THEMES_PRIVATE_PATH;
   if (privateRoot && privateRoot.length > 0) {
-    candidates.push(join24(privateRoot, "themes", theme2, "theme.visor.yaml"));
+    candidates.push(join27(privateRoot, "themes", theme2, "theme.visor.yaml"));
   }
   candidates.push(
-    join24(cwd, "themes", `${theme2}.visor.yaml`),
-    join24(cwd, "custom-themes", `${theme2}.visor.yaml`)
+    join27(cwd, "themes", `${theme2}.visor.yaml`),
+    join27(cwd, "custom-themes", `${theme2}.visor.yaml`)
   );
-  const yamlPath = candidates.find((p) => existsSync23(p));
+  const yamlPath = candidates.find((p) => existsSync25(p));
   if (!yamlPath) {
     const searched = candidates.join(", ");
     manifest.warnings.push(
-      `Theme '${theme2}' not found (searched: ${searched}) \u2014 sandbox uses placeholder globals.css. Run 'npx visor theme apply <path-to-theme.visor.yaml> --adapter nextjs -o ${join24(sandboxDir, "app", "globals.css")}' manually, or re-run with --theme-file <path>, or set VISOR_THEMES_PRIVATE_PATH to a directory containing themes/${theme2}/theme.visor.yaml.`
+      `Theme '${theme2}' not found (searched: ${searched}) \u2014 sandbox uses placeholder globals.css. Run 'npx visor theme apply <path-to-theme.visor.yaml> --adapter nextjs -o ${join27(sandboxDir, "app", "globals.css")}' manually, or re-run with --theme-file <path>, or set VISOR_THEMES_PRIVATE_PATH to a directory containing themes/${theme2}/theme.visor.yaml.`
     );
     if (!json) {
       logger.warn(`Theme '${theme2}' not found \u2014 leaving placeholder globals.css.`);
@@ -7335,12 +7530,12 @@ function applyThemeIfPossible(sandboxDir, manifest, theme2, cwd, json, themeFile
         `Re-run with --theme-file <path>, or set VISOR_THEMES_PRIVATE_PATH=<dir-containing-themes/${theme2}/theme.visor.yaml>.`
       );
       logger.item(
-        `Or apply manually: npx visor theme apply <path> --adapter nextjs -o ${join24(sandboxDir, "app", "globals.css")}`
+        `Or apply manually: npx visor theme apply <path> --adapter nextjs -o ${join27(sandboxDir, "app", "globals.css")}`
       );
     }
     return;
   }
-  const globalsOut = join24(sandboxDir, "app", "globals.css");
+  const globalsOut = join27(sandboxDir, "app", "globals.css");
   try {
     themeApplyCommand(yamlPath, sandboxDir, {
       output: globalsOut,
@@ -7393,12 +7588,12 @@ function loadKnownPrimitives() {
 }
 function readCliVersion() {
   try {
-    const here = dirname10(fileURLToPath3(import.meta.url));
+    const here = dirname11(fileURLToPath3(import.meta.url));
     for (let i = 0; i < 6; i++) {
       const segments = new Array(i).fill("..");
-      const candidate = join24(here, ...segments, "package.json");
+      const candidate = join27(here, ...segments, "package.json");
       try {
-        const pkg2 = JSON.parse(readFileSync27(candidate, "utf-8"));
+        const pkg2 = JSON.parse(readFileSync28(candidate, "utf-8"));
         if (pkg2.name === "@loworbitstudio/visor" && pkg2.version) return pkg2.version;
       } catch {
       }
@@ -7409,14 +7604,14 @@ function readCliVersion() {
 }
 
 // src/commands/sandbox/dev.ts
-import { existsSync as existsSync24, readFileSync as readFileSync28 } from "fs";
-import { join as join25 } from "path";
+import { existsSync as existsSync26, readFileSync as readFileSync29 } from "fs";
+import { join as join28 } from "path";
 import * as childProcess4 from "child_process";
 function sandboxDevCommand(cwd, options) {
   const json = options.json ?? false;
-  const sandboxDir = join25(cwd, ".lo", "sandbox", options.name);
-  const configPath = join25(sandboxDir, "sandbox.json");
-  if (!existsSync24(configPath)) {
+  const sandboxDir = join28(cwd, ".lo", "sandbox", options.name);
+  const configPath = join28(sandboxDir, "sandbox.json");
+  if (!existsSync26(configPath)) {
     fail(
       json,
       `Sandbox '${options.name}' not found at ${sandboxDir}. Run 'visor sandbox init ${options.name} --handoff ... --theme ...' first.`
@@ -7425,7 +7620,7 @@ function sandboxDevCommand(cwd, options) {
   }
   let config;
   try {
-    config = JSON.parse(readFileSync28(configPath, "utf-8"));
+    config = JSON.parse(readFileSync29(configPath, "utf-8"));
   } catch (err) {
     fail(json, `Invalid sandbox.json at ${configPath}: ${err.message}`);
     return;
@@ -7483,20 +7678,20 @@ function fail(json, message) {
 // src/commands/sandbox/approve.ts
 import {
   copyFileSync as copyFileSync2,
-  existsSync as existsSync25,
-  mkdirSync as mkdirSync11,
-  readFileSync as readFileSync29,
+  existsSync as existsSync27,
+  mkdirSync as mkdirSync13,
+  readFileSync as readFileSync30,
   readdirSync as readdirSync14,
   rmSync as rmSync3,
-  writeFileSync as writeFileSync15
+  writeFileSync as writeFileSync17
 } from "fs";
-import { basename as basename7, join as join26 } from "path";
+import { basename as basename7, join as join29 } from "path";
 import * as childProcess5 from "child_process";
 function sandboxApproveCommand(cwd, options) {
   const json = options.json ?? false;
-  const sandboxDir = join26(cwd, ".lo", "sandbox", options.name);
-  const configPath = join26(sandboxDir, "sandbox.json");
-  if (!existsSync25(configPath)) {
+  const sandboxDir = join29(cwd, ".lo", "sandbox", options.name);
+  const configPath = join29(sandboxDir, "sandbox.json");
+  if (!existsSync27(configPath)) {
     fail2(
       json,
       `Sandbox '${options.name}' not found at ${sandboxDir}. Run 'visor sandbox init' first.`
@@ -7510,9 +7705,9 @@ function sandboxApproveCommand(cwd, options) {
   runCapture(sandboxDir, configPath, options.name, json);
 }
 function runCapture(sandboxDir, configPath, sandboxName, json) {
-  const config = JSON.parse(readFileSync29(configPath, "utf-8"));
-  const captureScriptPath = join26(sandboxDir, "playwright.capture.mjs");
-  writeFileSync15(captureScriptPath, captureScriptTemplate(), "utf-8");
+  const config = JSON.parse(readFileSync30(configPath, "utf-8"));
+  const captureScriptPath = join29(sandboxDir, "playwright.capture.mjs");
+  writeFileSync17(captureScriptPath, captureScriptTemplate(), "utf-8");
   ensurePlaywrightInstalled(sandboxDir, json);
   const result = childProcess5.spawnSync(
     "npx",
@@ -7533,9 +7728,9 @@ function runCapture(sandboxDir, configPath, sandboxName, json) {
 ${result.stderr}`);
     return;
   }
-  const pendingDir = join26(sandboxDir, "captures", "pending");
-  const diffsDir = join26(sandboxDir, "captures", "diffs");
-  const approvedDir = join26(sandboxDir, "captures", "approved");
+  const pendingDir = join29(sandboxDir, "captures", "pending");
+  const diffsDir = join29(sandboxDir, "captures", "diffs");
+  const approvedDir = join29(sandboxDir, "captures", "approved");
   const pendingFiles = safeListPngs(pendingDir);
   const diffFiles = safeListPngs(diffsDir);
   const hasBaseline = safeListPngs(approvedDir).length > 0;
@@ -7572,9 +7767,9 @@ ${result.stderr}`);
   }
 }
 function runPromotion(sandboxDir, sandboxName, json) {
-  const pendingDir = join26(sandboxDir, "captures", "pending");
-  const approvedDir = join26(sandboxDir, "captures", "approved");
-  const diffsDir = join26(sandboxDir, "captures", "diffs");
+  const pendingDir = join29(sandboxDir, "captures", "pending");
+  const approvedDir = join29(sandboxDir, "captures", "approved");
+  const diffsDir = join29(sandboxDir, "captures", "diffs");
   const pendingFiles = safeListPngs(pendingDir);
   if (pendingFiles.length === 0) {
     fail2(
@@ -7583,10 +7778,10 @@ function runPromotion(sandboxDir, sandboxName, json) {
     );
     return;
   }
-  mkdirSync11(approvedDir, { recursive: true });
+  mkdirSync13(approvedDir, { recursive: true });
   const promoted = [];
   for (const src of pendingFiles) {
-    const dest = join26(approvedDir, basename7(src));
+    const dest = join29(approvedDir, basename7(src));
     copyFileSync2(src, dest);
     promoted.push(dest);
   }
@@ -7606,8 +7801,8 @@ function runPromotion(sandboxDir, sandboxName, json) {
   }
 }
 function ensurePlaywrightInstalled(sandboxDir, json) {
-  const markerPath = join26(sandboxDir, ".playwright-installed");
-  if (existsSync25(markerPath)) return;
+  const markerPath = join29(sandboxDir, ".playwright-installed");
+  if (existsSync27(markerPath)) return;
   if (!json) logger.info("Installing Playwright Chromium (one-time)...");
   const result = childProcess5.spawnSync(
     "npx",
@@ -7623,11 +7818,11 @@ function ensurePlaywrightInstalled(sandboxDir, json) {
   if (typeof result.status === "number" && result.status !== 0) {
     throw new Error(`playwright install exited with code ${result.status}`);
   }
-  writeFileSync15(markerPath, (/* @__PURE__ */ new Date()).toISOString(), "utf-8");
+  writeFileSync17(markerPath, (/* @__PURE__ */ new Date()).toISOString(), "utf-8");
 }
 function safeListPngs(dir) {
-  if (!existsSync25(dir)) return [];
-  return readdirSync14(dir).filter((f) => f.endsWith(".png")).map((f) => join26(dir, f));
+  if (!existsSync27(dir)) return [];
+  return readdirSync14(dir).filter((f) => f.endsWith(".png")).map((f) => join29(dir, f));
 }
 function tryParseJson(s) {
   try {
@@ -7648,14 +7843,12 @@ function fail2(json, message) {
 // src/commands/spawn.ts
 import {
   cpSync,
-  existsSync as existsSync28,
-  mkdirSync as mkdirSync12,
+  existsSync as existsSync29,
   readFileSync as readFileSync31,
   readdirSync as readdirSync16,
-  rmSync as rmSync4,
-  writeFileSync as writeFileSync16
+  rmSync as rmSync4
 } from "fs";
-import { basename as basename8, isAbsolute as isAbsolute3, join as join29, resolve as resolve17 } from "path";
+import { basename as basename8, isAbsolute as isAbsolute5, join as join31, resolve as resolve19 } from "path";
 import { homedir as homedir3 } from "os";
 import * as childProcess6 from "child_process";
 import { parse as parseYaml5 } from "yaml";
@@ -7664,64 +7857,8 @@ import { nextjsAdapter as nextjsAdapter3 } from "@loworbitstudio/visor-theme-eng
 import { validate as validate3 } from "@loworbitstudio/visor-theme-engine";
 
 // src/lib/blessed-discovery.ts
-import { existsSync as existsSync27, readdirSync as readdirSync15 } from "fs";
-import { join as join28 } from "path";
-
-// src/lib/blessed-manifest.ts
-import { existsSync as existsSync26, readFileSync as readFileSync30 } from "fs";
-import { join as join27 } from "path";
-import { z } from "zod";
-var BLESSED_MANIFEST_FILENAME = "blessed-manifest.json";
-var blessedManifestSchema = z.object({
-  /** Blessed-build shape, e.g. `admin-ui`. Matched against the `{shape}` in `blessed:{shape}:{pattern}`. */
-  shape: z.string().min(1),
-  /** Pattern name within the shape, e.g. `organization-management`. */
-  pattern: z.string().min(1),
-  /** The theme the reference build was authored + captured against. */
-  base_theme: z.string().min(1),
-  /** Minimum Visor version this build is known to work with (semver range). */
-  requires_visor: z.string().min(1),
-  /** Path (relative to the build root) to the approved capture baseline. */
-  captures_baseline: z.string().min(1),
-  /** Three-gates disposition at the time the build was blessed. */
-  three_gates_status: z.string().min(1)
-}).strict();
-function parseBlessedManifest(buildDir) {
-  const manifestPath = join27(buildDir, BLESSED_MANIFEST_FILENAME);
-  if (!existsSync26(manifestPath)) {
-    return {
-      ok: false,
-      error: `this directory is not a blessed build (missing ${BLESSED_MANIFEST_FILENAME}); see docs/blessed-builds.md`
-    };
-  }
-  let raw;
-  try {
-    raw = readFileSync30(manifestPath, "utf-8");
-  } catch {
-    return { ok: false, error: `could not read ${manifestPath}` };
-  }
-  let json;
-  try {
-    json = JSON.parse(raw);
-  } catch (err) {
-    const message = err instanceof Error ? err.message : "invalid JSON";
-    return { ok: false, error: `invalid JSON in ${manifestPath}: ${message}` };
-  }
-  const result = blessedManifestSchema.safeParse(json);
-  if (!result.success) {
-    const issues = result.error.issues.map((issue) => {
-      const path2 = issue.path.join(".") || "(root)";
-      return `${path2}: ${issue.message}`;
-    }).join("; ");
-    return {
-      ok: false,
-      error: `invalid ${BLESSED_MANIFEST_FILENAME} at ${manifestPath}: ${issues}`
-    };
-  }
-  return { ok: true, manifest: result.data };
-}
-
-// src/lib/blessed-discovery.ts
+import { existsSync as existsSync28, readdirSync as readdirSync15 } from "fs";
+import { join as join30 } from "path";
 var WALK_EXCLUDE_DIRS = /* @__PURE__ */ new Set([
   "node_modules",
   ".next",
@@ -7734,7 +7871,7 @@ var WALK_EXCLUDE_DIRS = /* @__PURE__ */ new Set([
 function discoverBlessedBuilds(blessedDir, maxDepth = 8) {
   const builds = [];
   const errors = [];
-  if (!existsSync27(blessedDir)) {
+  if (!existsSync28(blessedDir)) {
     return { builds, errors };
   }
   walk2(blessedDir, 0);
@@ -7768,7 +7905,7 @@ function discoverBlessedBuilds(blessedDir, maxDepth = 8) {
     for (const entry of entries) {
       if (!entry.isDirectory()) continue;
       if (WALK_EXCLUDE_DIRS.has(entry.name)) continue;
-      walk2(join28(dir, entry.name), depth + 1);
+      walk2(join30(dir, entry.name), depth + 1);
     }
   }
 }
@@ -7781,7 +7918,7 @@ function resolveBlessedBuild(blessedDir, shape, pattern2) {
 }
 
 // src/commands/spawn.ts
-var DEFAULT_BLESSED_DIR = join29(
+var DEFAULT_BLESSED_DIR = join31(
   homedir3(),
   "Code",
   "low-orbit",
@@ -7817,23 +7954,23 @@ function parseBlessedIdentifier(from) {
 }
 function resolveBlessedDir(cwd, options) {
   const raw = options.blessedDir ?? (process.env.VISOR_BLESSED_DIR && process.env.VISOR_BLESSED_DIR.length > 0 ? process.env.VISOR_BLESSED_DIR : void 0) ?? DEFAULT_BLESSED_DIR;
-  return isAbsolute3(raw) ? raw : resolve17(cwd, raw);
+  return isAbsolute5(raw) ? raw : resolve19(cwd, raw);
 }
 function resolveThemeFile(theme2, cwd, themeFile) {
   const candidates = [];
   if (themeFile) {
-    candidates.push(isAbsolute3(themeFile) ? themeFile : resolve17(cwd, themeFile));
+    candidates.push(isAbsolute5(themeFile) ? themeFile : resolve19(cwd, themeFile));
   }
-  candidates.push(isAbsolute3(theme2) ? theme2 : resolve17(cwd, theme2));
+  candidates.push(isAbsolute5(theme2) ? theme2 : resolve19(cwd, theme2));
   const privateRoot = process.env.VISOR_THEMES_PRIVATE_PATH;
   if (privateRoot && privateRoot.length > 0) {
-    candidates.push(join29(privateRoot, "themes", theme2, "theme.visor.yaml"));
+    candidates.push(join31(privateRoot, "themes", theme2, "theme.visor.yaml"));
   }
   candidates.push(
-    join29(cwd, "themes", `${theme2}.visor.yaml`),
-    join29(cwd, "custom-themes", `${theme2}.visor.yaml`)
+    join31(cwd, "themes", `${theme2}.visor.yaml`),
+    join31(cwd, "custom-themes", `${theme2}.visor.yaml`)
   );
-  const found = candidates.find((candidate) => existsSync28(candidate));
+  const found = candidates.find((candidate) => existsSync29(candidate));
   if (!found) {
     throw new Error(
       `Theme '${theme2}' not found (searched: ${candidates.join(", ")}). Pass --theme-file <path>, use a direct path, or set VISOR_THEMES_PRIVATE_PATH.`
@@ -7841,23 +7978,25 @@ function resolveThemeFile(theme2, cwd, themeFile) {
   }
   return { path: found, searched: candidates };
 }
-function resolveGlobalsCssPath(outputDir) {
-  const candidates = [
-    join29(outputDir, "app", "globals.css"),
-    join29(outputDir, "src", "app", "globals.css")
-  ];
-  const existing = candidates.find((candidate) => existsSync28(candidate));
-  return existing ?? candidates[0];
-}
-function applyThemeToFork(themeFile, globalsOut) {
+function applyThemeToFork(themeFile, outputDir, manifest) {
   const yaml = readFileSync31(themeFile, "utf-8");
   const data = generateThemeData7(yaml);
+  const themeId = data.config.name;
+  if (!themeId || themeId.length === 0) {
+    throw new Error(
+      `Theme file '${themeFile}' is missing a config.name; required to derive the theme id for spawn's theme-apply dispatch. See docs/blessed-builds.md.`
+    );
+  }
   const css = nextjsAdapter3(
     { primitives: data.primitives, tokens: data.tokens, config: data.config },
     {}
   );
-  mkdirSync12(join29(globalsOut, ".."), { recursive: true });
-  writeFileSync16(globalsOut, css, "utf-8");
+  applyThemeToBuild({
+    manifest,
+    buildDir: outputDir,
+    themeId,
+    adapterCss: css
+  });
 }
 function runNpmInstall2(outputDir, json) {
   const result = childProcess6.spawnSync("npm", ["install", "--no-audit", "--no-fund"], {
@@ -7886,8 +8025,8 @@ Available builds:
 ${list}`
     );
   }
-  const outputDir = isAbsolute3(options.output) ? options.output : resolve17(cwd, options.output);
-  if (existsSync28(outputDir) && readdirSync16(outputDir).length > 0) {
+  const outputDir = isAbsolute5(options.output) ? options.output : resolve19(cwd, options.output);
+  if (existsSync29(outputDir) && readdirSync16(outputDir).length > 0) {
     throw new Error(`Output directory already exists and is not empty: ${outputDir}`);
   }
   const { path: themeFile } = resolveThemeFile(options.theme, cwd, options.themeFile);
@@ -7898,8 +8037,7 @@ ${list}`
   let validated = false;
   let installed = false;
   try {
-    const globalsOut = resolveGlobalsCssPath(outputDir);
-    applyThemeToFork(themeFile, globalsOut);
+    applyThemeToFork(themeFile, outputDir, build.manifest);
     if (options.validate) {
       const parsed = parseYaml5(readFileSync31(themeFile, "utf-8"));
       const result = validate3(parsed);
@@ -8003,9 +8141,9 @@ function spawnCommand(cwd, options) {
 }
 
 // src/index.ts
-var __dirname2 = dirname11(fileURLToPath4(import.meta.url));
+var __dirname2 = dirname12(fileURLToPath4(import.meta.url));
 var pkg = JSON.parse(
-  readFileSync32(join30(__dirname2, "..", "package.json"), "utf-8")
+  readFileSync32(join32(__dirname2, "..", "package.json"), "utf-8")
 );
 var program = new Command2();
 program.name("visor").description("CLI for the Visor design system").version(pkg.version);
@@ -8058,6 +8196,9 @@ theme.command("apply").description(
 ).option(
   "--theme-class-name <name>",
   "(flutter) class name for generated theme (default: VisorAppTheme)"
+).option(
+  "--target-path <path>",
+  "(nextjs) path to a blessed-build root; dispatches CSS through the build's theme_apply_target (VI-601), ignores --output"
 ).action(
   (file, options) => {
     themeApplyCommand(file, process.cwd(), {