@loworbitstudio/visor 0.6.0 → 0.7.0

package/dist/CHANGELOG.json

@@ -1,6 +1,6 @@
 {
   "version": "0.4.0",
-  "generated_at": "2026-04-29T19:23:27.559Z",
+  "generated_at": "2026-05-01T00:42:09.768Z",
   "components": {
     "accessibility-specimen": {
       "changeType": "current",

package/dist/index.js

@@ -2211,9 +2211,121 @@ function printIssue(issue) {
   console.log(`${prefix} ${code} ${issue.message}${path2}`);
 }
 
+// src/commands/theme-verify.ts
+import { spawnSync as _spawnSync } from "child_process";
+import { existsSync as existsSync7 } from "fs";
+import { resolve as resolve5 } from "path";
+function themeVerifyCommand(dir, cwd, options, _spawnFn = _spawnSync) {
+  const target = options.target ?? "flutter";
+  if (target !== "flutter") {
+    if (options.json) {
+      console.log(
+        JSON.stringify({
+          valid: false,
+          target,
+          errors: [
+            {
+              code: "UNSUPPORTED_TARGET",
+              message: `Unsupported target: "${target}". Only "flutter" is supported.`
+            }
+          ]
+        })
+      );
+    } else {
+      logger.error(`Unsupported target: "${target}". Only "flutter" is supported.`);
+    }
+    process.exit(1);
+  }
+  const dirPath = resolve5(cwd, dir);
+  if (!existsSync7(dirPath)) {
+    if (options.json) {
+      console.log(
+        JSON.stringify({
+          valid: false,
+          target,
+          dir: dirPath,
+          errors: [
+            {
+              code: "DIR_NOT_FOUND",
+              message: `Directory not found: ${dirPath}`
+            }
+          ]
+        })
+      );
+    } else {
+      logger.error(`Directory not found: ${dirPath}`);
+      logger.info("Make sure the path exists and is readable.");
+    }
+    process.exit(1);
+  }
+  const flutterBin = findFlutterBin();
+  if (!flutterBin) {
+    if (options.json) {
+      console.log(
+        JSON.stringify({
+          valid: false,
+          target,
+          dir: dirPath,
+          errors: [
+            {
+              code: "FLUTTER_NOT_FOUND",
+              message: "Flutter binary not found. Set FLUTTER_ROOT, add flutter to PATH, or install via FVM."
+            }
+          ]
+        })
+      );
+    } else {
+      logger.error("Flutter binary not found.");
+      logger.info(
+        "Set FLUTTER_ROOT, add flutter to PATH, or install via FVM."
+      );
+    }
+    process.exit(1);
+  }
+  if (!options.json) {
+    logger.info(`Verifying Flutter output at: ${dirPath}`);
+    logger.item(`Using Flutter binary: ${flutterBin}`);
+  }
+  const result = _spawnFn(flutterBin, ["analyze", "--no-pub"], {
+    cwd: dirPath,
+    stdio: options.json ? "pipe" : "inherit",
+    encoding: "utf-8"
+  });
+  if (options.json) {
+    const stdout = (result.stdout ?? "").toString();
+    const stderr = (result.stderr ?? "").toString();
+    const success = result.status === 0;
+    console.log(
+      JSON.stringify({
+        valid: success,
+        target,
+        dir: dirPath,
+        exitCode: result.status,
+        stdout: stdout.trim() || void 0,
+        stderr: stderr.trim() || void 0,
+        errors: success ? [] : [
+          {
+            code: "DART_ANALYZE_FAILED",
+            message: stderr.trim() || stdout.trim() || "dart analyze reported errors"
+          }
+        ]
+      })
+    );
+    process.exit(success ? 0 : 1);
+  }
+  if (result.status === 0) {
+    logger.success("Flutter output is clean \u2014 dart analyze passed.");
+    process.exit(0);
+  } else {
+    logger.error("dart analyze reported errors in the generated output.");
+    logger.info("Fix the errors above, then re-run: visor theme apply --target flutter");
+    process.exit(1);
+  }
+}
+
 // src/commands/theme-extract.ts
-import { readFileSync as readFileSync11, writeFileSync as writeFileSync6, existsSync as existsSync7, readdirSync as readdirSync3, statSync as statSync3 } from "fs";
-import { resolve as resolve5, join as join10, basename, extname as extname2, relative } from "path";
+import { readFileSync as readFileSync11, writeFileSync as writeFileSync6, existsSync as existsSync8, readdirSync as readdirSync3, statSync as statSync3 } from "fs";
+import { resolve as resolve6, join as join10, basename, extname as extname2, relative } from "path";
 import { stringify as stringifyYaml } from "yaml";
 import {
   extractFromCSS,
@@ -2242,8 +2354,8 @@ var CSS_DIRS = [
   "packages/design-tokens"
 ];
 function themeExtractCommand(cwd, options) {
-  const targetDir = resolve5(cwd, options.from ?? ".");
-  if (!existsSync7(targetDir)) {
+  const targetDir = resolve6(cwd, options.from ?? ".");
+  if (!existsSync8(targetDir)) {
     if (options.json) {
       console.log(JSON.stringify({ success: false, error: `Directory not found: ${targetDir}` }));
     } else {
@@ -2306,7 +2418,7 @@ function collectCSSFiles(targetDir) {
   }
   for (const dir of CSS_DIRS) {
     const dirPath = join10(targetDir, dir);
-    if (existsSync7(dirPath) && statSync3(dirPath).isDirectory()) {
+    if (existsSync8(dirPath) && statSync3(dirPath).isDirectory()) {
       scanDirForCSS(dirPath, files, seen, 2);
     }
   }
@@ -2314,9 +2426,9 @@ function collectCSSFiles(targetDir) {
   return files;
 }
 function addFileIfExists(filePath, files, seen) {
-  const resolved = resolve5(filePath);
+  const resolved = resolve6(filePath);
   if (seen.has(resolved)) return;
-  if (!existsSync7(resolved)) return;
+  if (!existsSync8(resolved)) return;
   try {
     const content = readFileSync11(resolved, "utf-8");
     if (content.includes("--")) {
@@ -2327,7 +2439,7 @@ function addFileIfExists(filePath, files, seen) {
   }
 }
 function scanDirForCSS(dir, files, seen, maxDepth) {
-  if (!existsSync7(dir)) return;
+  if (!existsSync8(dir)) return;
   const SKIP_DIRS = /* @__PURE__ */ new Set([
     "node_modules",
     ".next",
@@ -2432,7 +2544,7 @@ function parseNextFontFromLayouts(targetDir) {
   const fontMap = /* @__PURE__ */ new Map();
   for (const relPath of LAYOUT_FILE_PATHS) {
     const fullPath = join10(targetDir, relPath);
-    if (!existsSync7(fullPath)) continue;
+    if (!existsSync8(fullPath)) continue;
     try {
       const content = readFileSync11(fullPath, "utf-8");
       parseNextFontDeclarations(content, fontMap);
@@ -2520,7 +2632,7 @@ var MONO_FONT_NAMES = /* @__PURE__ */ new Set([
 ]);
 function extractFontHints(targetDir) {
   const pkgPath = join10(targetDir, "package.json");
-  if (!existsSync7(pkgPath)) return void 0;
+  if (!existsSync8(pkgPath)) return void 0;
   try {
     const pkg = JSON.parse(readFileSync11(pkgPath, "utf-8"));
     const allDeps = { ...pkg.dependencies, ...pkg.devDependencies };
@@ -2559,7 +2671,7 @@ function extractFontHints(targetDir) {
 }
 function inferThemeName(targetDir) {
   const pkgPath = join10(targetDir, "package.json");
-  if (existsSync7(pkgPath)) {
+  if (existsSync8(pkgPath)) {
     try {
       const pkg = JSON.parse(readFileSync11(pkgPath, "utf-8"));
       if (pkg.name) {
@@ -2598,7 +2710,7 @@ function outputJSON(result, validationResult) {
 }
 function outputYAML(result, outputPath, cwd, validationResult) {
   const yamlStr = buildAnnotatedYAML(result);
-  const outFile = resolve5(cwd, outputPath ?? ".visor.yaml");
+  const outFile = resolve6(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;
@@ -2684,14 +2796,14 @@ function buildAnnotatedYAML(result) {
 }
 
 // src/commands/theme-register.ts
-import { readFileSync as readFileSync12, writeFileSync as writeFileSync7, mkdirSync as mkdirSync4, existsSync as existsSync9 } from "fs";
-import { resolve as resolve7, join as join12 } from "path";
+import { readFileSync as readFileSync12, writeFileSync as writeFileSync7, mkdirSync as mkdirSync4, existsSync as existsSync10 } from "fs";
+import { resolve as resolve8, join as join12 } from "path";
 import { generateThemeData as generateThemeData3 } from "@loworbitstudio/visor-theme-engine";
 import { docsAdapter as docsAdapter2 } from "@loworbitstudio/visor-theme-engine/adapters";
 
 // src/utils/theme-helpers.ts
-import { existsSync as existsSync8 } from "fs";
-import { resolve as resolve6, dirname as dirname5, join as join11 } from "path";
+import { existsSync as existsSync9 } from "fs";
+import { resolve as resolve7, dirname as dirname5, join as join11 } from "path";
 function toSlug(name) {
   return name.toLowerCase().replace(/\s+/g, "-");
 }
@@ -2699,9 +2811,9 @@ function toLabel(name) {
   return name.split(/[\s-]+/).map((w) => w.charAt(0).toUpperCase() + w.slice(1)).join(" ");
 }
 function findRepoRoot(startDir) {
-  let current = resolve6(startDir);
+  let current = resolve7(startDir);
   while (true) {
-    if (existsSync8(join11(current, "packages", "docs"))) {
+    if (existsSync9(join11(current, "packages", "docs"))) {
       return current;
     }
     const parent = dirname5(current);
@@ -2796,7 +2908,7 @@ ${indent}${newEntry},
   return { updated, changed: true };
 }
 function themeRegisterCommand(file, cwd, options) {
-  const filePath = resolve7(cwd, file);
+  const filePath = resolve8(cwd, file);
   let yamlContent;
   try {
     yamlContent = readFileSync12(filePath, "utf-8");
@@ -2846,7 +2958,7 @@ function themeRegisterCommand(file, cwd, options) {
   const cssFilePath = join12(docsAppDir, `${slug2}-theme.css`);
   const globalsPath = join12(docsAppDir, "globals.css");
   const themeConfigPath = join12(repoRoot, "packages", "docs", "lib", "theme-config.ts");
-  if (!existsSync9(docsAppDir)) {
+  if (!existsSync10(docsAppDir)) {
     const msg = `Docs app directory not found: ${docsAppDir}`;
     if (options.json) {
       console.log(JSON.stringify({ success: false, error: msg }));
@@ -2871,7 +2983,7 @@ function themeRegisterCommand(file, cwd, options) {
     process.exit(1);
     return;
   }
-  const cssExists = existsSync9(cssFilePath);
+  const cssExists = existsSync10(cssFilePath);
   const cssChanged = !cssExists || readFileSync12(cssFilePath, "utf-8") !== css;
   const { updated: newGlobals, changed: globalsChanged } = insertGlobalsImport(globalsContent, slug2);
   const { updated: newThemeConfig, changed: themeConfigChanged, error: configError } = insertThemeConfig(
@@ -2956,7 +3068,7 @@ function themeRegisterCommand(file, cwd, options) {
 }
 
 // src/commands/theme-unregister.ts
-import { readFileSync as readFileSync13, writeFileSync as writeFileSync8, existsSync as existsSync10, unlinkSync } from "fs";
+import { readFileSync as readFileSync13, writeFileSync as writeFileSync8, existsSync as existsSync11, unlinkSync } from "fs";
 import { join as join13 } from "path";
 function removeGlobalsImport(content, slug2) {
   const importLine = `@import './${slug2}-theme.css';`;
@@ -2993,7 +3105,7 @@ function themeUnregisterCommand(slug2, cwd, options) {
   const cssFilePath = join13(docsAppDir, `${slug2}-theme.css`);
   const globalsPath = join13(docsAppDir, "globals.css");
   const themeConfigPath = join13(repoRoot, "packages", "docs", "lib", "theme-config.ts");
-  if (!existsSync10(docsAppDir)) {
+  if (!existsSync11(docsAppDir)) {
     const msg = `Docs app directory not found: ${docsAppDir}`;
     if (options.json) {
       console.log(JSON.stringify({ success: false, error: msg }));
@@ -3018,7 +3130,7 @@ function themeUnregisterCommand(slug2, cwd, options) {
     process.exit(1);
     return;
   }
-  const cssExists = existsSync10(cssFilePath);
+  const cssExists = existsSync11(cssFilePath);
   const { updated: newGlobals, changed: globalsChanged } = removeGlobalsImport(globalsContent, slug2);
   const { updated: newThemeConfig, changed: themeConfigChanged } = removeThemeConfigEntry(themeConfigContent, slug2);
   if (!cssExists && !globalsChanged && !themeConfigChanged) {
@@ -3062,7 +3174,7 @@ import {
   readFileSync as readFileSync14,
   writeFileSync as writeFileSync9,
   mkdirSync as mkdirSync5,
-  existsSync as existsSync11,
+  existsSync as existsSync12,
   readdirSync as readdirSync4,
   unlinkSync as unlinkSync2,
   copyFileSync
@@ -3081,7 +3193,7 @@ 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 (!existsSync11(dir)) return [];
+  if (!existsSync12(dir)) return [];
   return readdirSync4(dir).filter((f) => f.endsWith(".visor.yaml")).map((f) => join14(dir, f));
 }
 function extractGroup(yamlContent) {
@@ -3333,7 +3445,7 @@ function themeSyncCommand(cwd, options) {
   try {
     globalsContent = readFileSync14(globalsPath, "utf-8");
     themeConfigContent = readFileSync14(themeConfigPath, "utf-8");
-    gitignoreContent = existsSync11(gitignorePath) ? readFileSync14(gitignorePath, "utf-8") : "";
+    gitignoreContent = existsSync12(gitignorePath) ? readFileSync14(gitignorePath, "utf-8") : "";
   } catch (err) {
     const msg = err instanceof Error ? err.message : "Could not read docs files";
     if (options.json) {
@@ -3349,12 +3461,12 @@ function themeSyncCommand(cwd, options) {
   const newGitignore = customSlugs.length > 0 ? updateGitignoreBlock(gitignoreContent, customSlugs) : gitignoreContent;
   const newCustomOverlayCss = generateCustomOverlayCss(customManifest);
   const newCustomOverlayTs = generateCustomOverlayTs(customManifest);
-  const existingCssFiles = existsSync11(docsAppDir) ? readdirSync4(docsAppDir).filter(
+  const existingCssFiles = existsSync12(docsAppDir) ? readdirSync4(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 = existsSync11(docsPublicThemesDir) ? readdirSync4(docsPublicThemesDir).filter((f) => f.endsWith(".visor.yaml")) : [];
+  const existingPublicYamls = existsSync12(docsPublicThemesDir) ? readdirSync4(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) {
@@ -3395,7 +3507,7 @@ function themeSyncCommand(cwd, options) {
     writeFileSync9(customOverlayTsPath, newCustomOverlayTs, "utf-8");
     writeFileSync9(themeConfigPath, newThemeConfig, "utf-8");
     writeFileSync9(globalsPath, newGlobals, "utf-8");
-    if (existsSync11(gitignorePath)) {
+    if (existsSync12(gitignorePath)) {
       writeFileSync9(gitignorePath, newGitignore, "utf-8");
     }
     const allSourceFiles = [...stockFiles, ...customFiles];
@@ -3443,7 +3555,7 @@ import {
   readFileSync as readFileSync15,
   writeFileSync as writeFileSync10,
   mkdirSync as mkdirSync6,
-  existsSync as existsSync12,
+  existsSync as existsSync13,
   readdirSync as readdirSync5,
   rmSync
 } from "fs";
@@ -3451,7 +3563,7 @@ import { join as join15, basename as basename3, dirname as dirname6 } from "path
 import { generateThemeData as generateThemeData5 } from "@loworbitstudio/visor-theme-engine";
 import { flutterAdapter as flutterAdapter2 } from "@loworbitstudio/visor-theme-engine/adapters";
 function scanThemeDir2(dir) {
-  if (!existsSync12(dir)) return [];
+  if (!existsSync13(dir)) return [];
   return readdirSync5(dir).filter((f) => f.endsWith(".visor.yaml")).map((f) => join15(dir, f)).sort();
 }
 function slugToCamel(slug2) {
@@ -3688,7 +3800,7 @@ function themeBatchApplyFlutterCommand(cwd, options) {
   }
   const slugs = processed.map((p) => p.slug);
   const libSrcDir = join15(outputDir, "lib", "src");
-  if (existsSync12(libSrcDir)) {
+  if (existsSync13(libSrcDir)) {
     rmSync(libSrcDir, { recursive: true, force: true });
   }
   const packageFiles = {
@@ -3731,8 +3843,8 @@ function themeBatchApplyFlutterCommand(cwd, options) {
 }
 
 // src/commands/fonts-add.ts
-import { existsSync as existsSync13, statSync as statSync4, readdirSync as readdirSync6, readFileSync as readFileSync16 } from "fs";
-import { resolve as resolve8, basename as basename4, extname as extname3 } from "path";
+import { existsSync as existsSync14, statSync as statSync4, readdirSync as readdirSync6, readFileSync as readFileSync16 } from "fs";
+import { resolve as resolve9, basename as basename4, extname as extname3 } from "path";
 import { S3Client, PutObjectCommand } from "@aws-sdk/client-s3";
 function deriveFamilySlug(filename) {
   const name = basename4(filename, extname3(filename));
@@ -3776,8 +3888,8 @@ function deriveFamilySlug(filename) {
   return parts.join("-").toLowerCase();
 }
 function collectWoff2Files(inputPath) {
-  const resolved = resolve8(inputPath);
-  if (!existsSync13(resolved)) {
+  const resolved = resolve9(inputPath);
+  if (!existsSync14(resolved)) {
     throw new Error(`Path not found: ${resolved}`);
   }
   const stat = statSync4(resolved);
@@ -3790,7 +3902,7 @@ function collectWoff2Files(inputPath) {
     return [resolved];
   }
   if (stat.isDirectory()) {
-    const files = readdirSync6(resolved).filter((f) => extname3(f).toLowerCase() === ".woff2").map((f) => resolve8(resolved, f));
+    const files = readdirSync6(resolved).filter((f) => extname3(f).toLowerCase() === ".woff2").map((f) => resolve9(resolved, f));
     if (files.length === 0) {
       throw new Error(
         `No .woff2 files found in directory: ${resolved}`
@@ -3805,8 +3917,8 @@ function collectWoff2Files(inputPath) {
   throw new Error(`Path is neither a file nor a directory: ${resolved}`);
 }
 function getNonWoff2Fonts(inputPath) {
-  const resolved = resolve8(inputPath);
-  if (!existsSync13(resolved) || !statSync4(resolved).isDirectory()) {
+  const resolved = resolve9(inputPath);
+  if (!existsSync14(resolved) || !statSync4(resolved).isDirectory()) {
     return [];
   }
   return readdirSync6(resolved).filter((f) => {
@@ -3859,7 +3971,7 @@ async function fontsAddCommand(inputPath, options) {
     const r2Config = getR2Config();
     const files = collectWoff2Files(inputPath);
     const familySlug = options.family ?? deriveFamilySlug(basename4(files[0]));
-    const resolved = resolve8(inputPath);
+    const resolved = resolve9(inputPath);
     const nonWoff2 = statSync4(resolved).isDirectory() ? getNonWoff2Fonts(resolved) : [];
     if (!json) {
       logger.heading("Visor Font Upload");
@@ -4147,12 +4259,12 @@ function findCssFiles(dir, maxDepth = 3) {
 }
 
 // src/utils/patterns.ts
-import { existsSync as existsSync15, readdirSync as readdirSync8, readFileSync as readFileSync18 } from "fs";
+import { existsSync as existsSync16, readdirSync as readdirSync8, readFileSync as readFileSync18 } from "fs";
 import { join as join17 } from "path";
 import { parse as parseYAML } from "yaml";
 function loadPatternsFromYaml(repoRoot) {
   const patternsDir = join17(repoRoot, "patterns");
-  if (!existsSync15(patternsDir)) return [];
+  if (!existsSync16(patternsDir)) return [];
   const files = readdirSync8(patternsDir).filter(
     (f) => f.endsWith(".visor-pattern.yaml")
   );
@@ -4164,7 +4276,7 @@ function loadPatternsFromYaml(repoRoot) {
 function findRepoRoot2(startDir) {
   let current = startDir;
   while (true) {
-    if (existsSync15(join17(current, "patterns"))) {
+    if (existsSync16(join17(current, "patterns"))) {
       return current;
     }
     const parent = join17(current, "..");
@@ -4618,6 +4730,11 @@ theme.command("validate").description("Run full validation ruleset on a .visor.y
     themeValidateCommand(file, process.cwd(), options);
   }
 );
+theme.command("verify").description("Verify generated theme output for a target platform").argument("<dir>", "path to generated output directory").option("--target <platform>", "target platform (flutter)", "flutter").option("--json", "output structured JSON (for AI agents)").action(
+  (dir, options) => {
+    themeVerifyCommand(dir, process.cwd(), options);
+  }
+);
 theme.command("extract").description(
   "Scan an existing project's CSS and produce a best-effort .visor.yaml theme file"
 ).option("--from <path>", "path to project directory to scan").option("--json", "output structured JSON (for AI agents)").option("-o, --output <path>", "output file path (default: .visor.yaml)").option("--validate", "run validator on the extracted theme").action(