npm - @loworbitstudio/visor - Versions diffs - 0.4.0 → 0.5.0 - Mend

@loworbitstudio/visor 0.4.0 → 0.5.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (6) hide show

package/dist/index.js CHANGED Viewed

@@ -61,6 +61,7 @@ function resolveTransitiveDeps(registry, names, onWarning) {
 function collectDependencies(items) {
   const deps = /* @__PURE__ */ new Set();
   const devDeps = /* @__PURE__ */ new Set();
+  const pubDeps = /* @__PURE__ */ new Map();
   for (const item of items) {
     if (item.dependencies) {
       for (const dep of item.dependencies) {
@@ -72,12 +73,36 @@ function collectDependencies(items) {
         devDeps.add(dep);
       }
     }
+    if (item.pubDependencies) {
+      for (const dep of item.pubDependencies) {
+        pubDeps.set(dep.pub, dep);
+      }
+    }
   }
   return {
     dependencies: Array.from(deps).sort(),
-    devDependencies: Array.from(devDeps).sort()
+    devDependencies: Array.from(devDeps).sort(),
+    pubDependencies: Array.from(pubDeps.values()).sort(
+      (a, b) => a.pub.localeCompare(b.pub)
+    )
   };
 }
+function filterItemsByTarget(items, target) {
+  return items.filter(
+    (item) => item.target === target || item.target === void 0
+  );
+}
+function slug(name) {
+  return name.toLowerCase().replace(/[^a-z0-9]/g, "");
+}
+function findItemForTarget(registry, name, target) {
+  const needle = slug(name);
+  return registry.items.find(
+    (item) => slug(item.name) === needle && item.target === target
+  ) ?? registry.items.find(
+    (item) => slug(item.name) === needle && item.target === void 0
+  );
+}
 // src/check/catalog.ts
 var STOP_WORDS = /* @__PURE__ */ new Set([
@@ -524,8 +549,10 @@ function checkCommand() {
 }
 // src/commands/init.ts
-import { existsSync as existsSync3, writeFileSync as writeFileSync2, mkdirSync } from "fs";
+import { existsSync as existsSync3, writeFileSync as writeFileSync2, mkdirSync, readFileSync as readFileSync5 } from "fs";
 import { join as join5, dirname as dirname2 } from "path";
+import { fileURLToPath as fileURLToPath2 } from "url";
+import * as childProcess from "child_process";
 // src/config/config.ts
 import { readFileSync as readFileSync3, writeFileSync, existsSync } from "fs";
@@ -536,6 +563,7 @@ var DEFAULT_CONFIG = {
   paths: {
     components: "components/ui",
     deckComponents: "components/deck",
+    flutterComponents: "lib/visor/components",
     blocks: "blocks",
     hooks: "hooks",
     lib: "lib"
@@ -624,11 +652,45 @@ function installPackages(packages, cwd, dev = false) {
 }
 // src/commands/templates/nextjs.ts
+var NEXTJS_PINNED_VERSION = "15.1.6";
+var CREATE_NEXT_APP_FLAGS = [
+  "--ts",
+  "--app",
+  "--no-tailwind",
+  "--no-eslint",
+  "--no-src-dir",
+  "--import-alias",
+  "@/*",
+  "--use-npm"
+];
 var NEXTJS_STARTER_YAML = `name: my-app
 version: 1
 colors:
   primary: "#2563EB"
 `;
+function generateNextjsLayout() {
+  return `import "./globals.css";
+import { FOWT_SCRIPT } from "@loworbitstudio/visor-theme-engine/fowt";
+import type { Metadata } from "next";
+import type { ReactNode } from "react";
+export const metadata: Metadata = {
+  title: "My Visor App",
+  description: "Built with Visor \u2014 Low Orbit Studio's design system.",
+};
+export default function RootLayout({ children }: { children: ReactNode }) {
+  return (
+    <html lang="en">
+      <head>
+        <script>{FOWT_SCRIPT}</script>
+      </head>
+      <body>{children}</body>
+    </html>
+  );
+}
+`;
+}
 // src/commands/init.ts
 import { generateThemeData } from "@loworbitstudio/visor-theme-engine";
@@ -639,18 +701,14 @@ function initCommand(cwd, options) {
   const filesSkipped = [];
   const warnings = [];
   if (options?.template && options.template !== "nextjs") {
-    if (json) {
-      console.log(
-        JSON.stringify(
-          { success: false, error: `Unknown template: ${options.template}. Available templates: nextjs` },
-          null,
-          2
-        )
-      );
-    } else {
-      logger.error(`Unknown template: ${options.template}`);
-      logger.info("Available templates: nextjs");
-    }
+    emitError(json, `Unknown template: ${options.template}. Available templates: nextjs`);
+    process.exit(1);
+  }
+  if (options?.template === "nextjs" && existsSync3(join5(cwd, "package.json"))) {
+    emitError(
+      json,
+      "package.json already exists in this directory. visor init --template nextjs only scaffolds into empty directories. For an existing app, see the retrofit flow: https://visor.loworbit.studio/docs/guides/migration"
+    );
     process.exit(1);
   }
   if (configExists(cwd)) {
@@ -673,51 +731,62 @@ function initCommand(cwd, options) {
     }
   }
   if (options?.template === "nextjs") {
-    scaffoldNextjs(cwd, json, filesCreated, filesSkipped);
+    scaffoldNextjs(cwd, json, filesCreated, filesSkipped, warnings);
   }
-  const missingTokens = !hasVisorTokens(cwd);
-  if (missingTokens) {
-    const warning = "@loworbitstudio/visor-core is not installed. Components require it for styling.";
-    warnings.push(warning);
-    if (!json) {
-      logger.blank();
-      logger.warn(warning);
-      logger.info("  For Next.js: re-run with --template nextjs to generate tokens inline.");
+  if (options?.template !== "nextjs") {
+    const missingTokens = !hasVisorTokens(cwd);
+    if (missingTokens) {
+      const warning = "@loworbitstudio/visor-core is not installed. Components require it for styling.";
+      warnings.push(warning);
+      if (!json) {
+        logger.blank();
+        logger.warn(warning);
+        logger.info("  For a complete one-command setup: run `npx @loworbitstudio/visor init --template nextjs` in an empty directory.");
+      }
     }
   }
   if (json) {
-    const nextSteps = [];
-    if (options?.template === "nextjs") {
-      nextSteps.push("Customize colors in .visor.yaml");
-      nextSteps.push("Add FOWT prevention script to your layout.tsx <head>");
-      nextSteps.push("Run: npx visor add button \u2014 to add your first component");
-    } else {
-      nextSteps.push("Run: npx visor add button \u2014 to add your first component");
-    }
-    if (missingTokens) {
-      nextSteps.push("Re-run with --template nextjs to generate tokens inline (no npm package needed)");
-    }
-    console.log(
-      JSON.stringify(
-        {
-          success: true,
-          config: DEFAULT_CONFIG,
-          files: { created: filesCreated, skipped: filesSkipped },
-          warnings,
-          nextSteps
-        },
-        null,
-        2
-      )
-    );
+    const nextSteps = buildNextSteps(options, warnings);
+    const result = {
+      success: true,
+      config: DEFAULT_CONFIG,
+      files: { created: filesCreated, skipped: filesSkipped },
+      warnings,
+      nextSteps
+    };
+    console.log(JSON.stringify(result, null, 2));
     process.exit(0);
   }
 }
-function scaffoldNextjs(cwd, json, filesCreated, filesSkipped) {
+function buildNextSteps(options, warnings) {
+  const steps = [];
+  if (options?.template === "nextjs") {
+    steps.push("Run: npm run dev \u2014 start the development server");
+    steps.push("Customize colors in .visor.yaml, then re-run `npx visor theme apply .visor.yaml --adapter nextjs`");
+    steps.push("Run: npx visor add button \u2014 add your first component");
+  } else {
+    steps.push("Run: npx visor add button \u2014 add your first component");
+  }
+  if (warnings.some((w) => w.includes("visor-core"))) {
+    steps.push("For a complete one-command setup: re-run with --template nextjs in an empty directory");
+  }
+  return steps;
+}
+function emitError(json, message) {
+  if (json) {
+    const result = { success: false, error: message };
+    console.log(JSON.stringify(result, null, 2));
+  } else {
+    logger.error(message);
+  }
+}
+function scaffoldNextjs(cwd, json, filesCreated, filesSkipped, warnings) {
   if (!json) {
     logger.blank();
-    logger.info("Scaffolding NextJS theme...");
+    logger.info("Scaffolding a Borealis-native Next.js app...");
   }
+  runCreateNextApp(cwd, json);
+  runInstallVisorDeps(cwd, json);
   const yamlPath = join5(cwd, ".visor.yaml");
   if (existsSync3(yamlPath)) {
     filesSkipped.push(".visor.yaml");
@@ -739,32 +808,110 @@ function scaffoldNextjs(cwd, json, filesCreated, filesSkipped) {
   });
   const globalsPath = join5(cwd, "app", "globals.css");
   const globalsDir = dirname2(globalsPath);
+  mkdirSync(globalsDir, { recursive: true });
   if (existsSync3(globalsPath)) {
-    filesSkipped.push("app/globals.css");
-    if (!json) {
-      logger.warn("app/globals.css already exists. Skipping.");
-    }
+    writeFileSync2(globalsPath, css, "utf-8");
+    filesCreated.push("app/globals.css");
   } else {
-    mkdirSync(globalsDir, { recursive: true });
     writeFileSync2(globalsPath, css, "utf-8");
     filesCreated.push("app/globals.css");
+  }
+  if (!json) {
+    logger.success("Created app/globals.css with theme tokens");
+  }
+  const layoutPath = join5(cwd, "app", "layout.tsx");
+  writeFileSync2(layoutPath, generateNextjsLayout(), "utf-8");
+  filesCreated.push("app/layout.tsx");
+  if (!json) {
+    logger.success("Wired app/layout.tsx with FOWT prevention and theme tokens");
+  }
+  const stampDir = join5(cwd, ".lo");
+  const stampPath = join5(stampDir, "borealis.json");
+  if (existsSync3(stampPath)) {
+    filesSkipped.push(".lo/borealis.json");
+    if (!json) {
+      logger.warn(".lo/borealis.json already exists. Skipping.");
+    }
+  } else {
+    mkdirSync(stampDir, { recursive: true });
+    const stamp = {
+      visorVersion: readVisorCliVersion(),
+      initializedAt: (/* @__PURE__ */ new Date()).toISOString()
+    };
+    writeFileSync2(stampPath, JSON.stringify(stamp, null, 2) + "\n", "utf-8");
+    filesCreated.push(".lo/borealis.json");
     if (!json) {
-      logger.success("Created app/globals.css with theme tokens");
+      logger.success("Stamped .lo/borealis.json");
     }
   }
   if (!json) {
+    logger.blank();
+    logger.success("Your Borealis-native Next.js app is ready.");
     logger.blank();
     logger.info("Next steps:");
-    logger.item("Customize colors in .visor.yaml");
-    logger.item("Add FOWT prevention script to your layout.tsx <head>");
-    logger.item("Run: npx visor add button \u2014 to add your first component");
+    logger.item("npm run dev                           # start the dev server");
+    logger.item("Edit .visor.yaml to customize tokens, then re-run theme apply");
+    logger.item("npx visor add button                  # add your first component");
+  }
+  void warnings;
+}
+function runCreateNextApp(cwd, json) {
+  if (!json) {
+    logger.info(`Running create-next-app@${NEXTJS_PINNED_VERSION}...`);
   }
+  const result = childProcess.spawnSync(
+    "npx",
+    [`create-next-app@${NEXTJS_PINNED_VERSION}`, ".", ...CREATE_NEXT_APP_FLAGS],
+    { cwd, stdio: json ? "ignore" : "inherit" }
+  );
+  assertSpawnSuccess(result, "create-next-app");
+}
+function runInstallVisorDeps(cwd, json) {
+  if (!json) {
+    logger.info("Installing @loworbitstudio/visor-core and visor-theme-engine...");
+  }
+  const result = childProcess.spawnSync(
+    "npm",
+    [
+      "install",
+      "@loworbitstudio/visor-core",
+      "@loworbitstudio/visor-theme-engine"
+    ],
+    { cwd, stdio: json ? "ignore" : "inherit" }
+  );
+  assertSpawnSuccess(result, "npm install");
+}
+function assertSpawnSuccess(result, label) {
+  if (result.error) {
+    throw new Error(`${label} failed to start: ${result.error.message}`);
+  }
+  if (typeof result.status === "number" && result.status !== 0) {
+    throw new Error(`${label} exited with code ${result.status}`);
+  }
+}
+function readVisorCliVersion() {
+  try {
+    const here = dirname2(fileURLToPath2(import.meta.url));
+    for (let i = 0; i < 5; i++) {
+      const segments = new Array(i).fill("..");
+      const candidate = join5(here, ...segments, "package.json");
+      try {
+        const pkg = JSON.parse(readFileSync5(candidate, "utf-8"));
+        if (pkg.name === "@loworbitstudio/visor" && pkg.version) {
+          return pkg.version;
+        }
+      } catch {
+      }
+    }
+  } catch {
+  }
+  return "0.0.0-dev";
 }
 // src/utils/fs.ts
 import {
   writeFileSync as writeFileSync3,
-  readFileSync as readFileSync5,
+  readFileSync as readFileSync6,
   existsSync as existsSync4,
   mkdirSync as mkdirSync2
 } from "fs";
@@ -780,6 +927,10 @@ function resolveOutputPath(registryPath, type, config, cwd) {
       relativePath = registryPath.replace(/^components\/deck\//, "");
       return join6(cwd, config.paths.deckComponents, relativePath);
     }
+    if (registryPath.startsWith("components/flutter/")) {
+      relativePath = registryPath.replace(/^components\/flutter\//, "");
+      return join6(cwd, config.paths.flutterComponents, relativePath);
+    }
     relativePath = registryPath.replace(/^components\/ui\//, "");
     return join6(cwd, config.paths.components, relativePath);
   }
@@ -802,7 +953,7 @@ function writeFile(filePath, content) {
 }
 function readFile(filePath) {
   if (!existsSync4(filePath)) return null;
-  return readFileSync5(filePath, "utf-8");
+  return readFileSync6(filePath, "utf-8");
 }
 function fileExists(filePath) {
   return existsSync4(filePath);
@@ -945,10 +1096,140 @@ function listCommand(cwd, options = {}) {
   }
 }
+// src/utils/pubspec.ts
+import { existsSync as existsSync5, readFileSync as readFileSync7, writeFileSync as writeFileSync4 } from "fs";
+import { join as join7 } from "path";
+import { parseDocument, YAMLMap } from "yaml";
+function mergePubspec(pubspecText, deps) {
+  const doc = parseDocument(pubspecText);
+  const added = [];
+  const skipped = [];
+  let depsNode = doc.get("dependencies");
+  if (depsNode == null || !(depsNode instanceof YAMLMap)) {
+    depsNode = new YAMLMap();
+    doc.set("dependencies", depsNode);
+  }
+  for (const dep of deps) {
+    if (depsNode.has(dep.pub)) {
+      skipped.push(dep.pub);
+      continue;
+    }
+    depsNode.set(dep.pub, dep.version);
+    added.push(dep.pub);
+  }
+  return { text: doc.toString(), added, skipped };
+}
+function pubspecPath(cwd) {
+  return join7(cwd, "pubspec.yaml");
+}
+function pubspecExists(cwd) {
+  return existsSync5(pubspecPath(cwd));
+}
+function isPubPackageInstalled(packageName, cwd) {
+  if (!pubspecExists(cwd)) return false;
+  const text = readFileSync7(pubspecPath(cwd), "utf-8");
+  const doc = parseDocument(text);
+  const depsNode = doc.get("dependencies");
+  if (!(depsNode instanceof YAMLMap)) return false;
+  return depsNode.has(packageName);
+}
+function getUninstalledPubDeps(deps, cwd) {
+  return deps.filter((d) => !isPubPackageInstalled(d.pub, cwd));
+}
+function addPubDependencies(deps, cwd) {
+  const path2 = pubspecPath(cwd);
+  if (!existsSync5(path2)) {
+    throw new Error(
+      `No pubspec.yaml found at ${path2}. Run this command from a Flutter project root.`
+    );
+  }
+  const text = readFileSync7(path2, "utf-8");
+  const result = mergePubspec(text, deps);
+  if (result.added.length > 0) {
+    writeFileSync4(path2, result.text, "utf-8");
+  }
+  return result;
+}
+// src/utils/flutter.ts
+import { execFileSync as execFileSync2 } from "child_process";
+import { existsSync as existsSync6, readdirSync as readdirSync2, statSync as statSync2 } from "fs";
+import { homedir } from "os";
+import { join as join8 } from "path";
+function isExecutable(path2) {
+  try {
+    const s = statSync2(path2);
+    return s.isFile();
+  } catch {
+    return false;
+  }
+}
+function fromPath(env) {
+  const pathVar = env.PATH ?? "";
+  const sep = process.platform === "win32" ? ";" : ":";
+  const bin = process.platform === "win32" ? "flutter.bat" : "flutter";
+  for (const dir of pathVar.split(sep)) {
+    if (!dir) continue;
+    const candidate = join8(dir, bin);
+    if (isExecutable(candidate)) return candidate;
+  }
+  return null;
+}
+function fromFvm(home) {
+  const fvmDefault = join8(home, "fvm", "default", "bin", "flutter");
+  if (isExecutable(fvmDefault)) return fvmDefault;
+  const versionsDir = join8(home, "fvm", "versions");
+  if (!existsSync6(versionsDir)) return null;
+  let best = null;
+  try {
+    for (const name of readdirSync2(versionsDir)) {
+      const candidate = join8(versionsDir, name, "bin", "flutter");
+      if (!isExecutable(candidate)) continue;
+      if (!best || compareSemver(name, best.version) > 0) {
+        best = { version: name, path: candidate };
+      }
+    }
+  } catch {
+    return null;
+  }
+  return best?.path ?? null;
+}
+function compareSemver(a, b) {
+  const pa = a.split(".").map((x) => parseInt(x, 10) || 0);
+  const pb = b.split(".").map((x) => parseInt(x, 10) || 0);
+  for (let i = 0; i < Math.max(pa.length, pb.length); i++) {
+    const av = pa[i] ?? 0;
+    const bv = pb[i] ?? 0;
+    if (av !== bv) return av - bv;
+  }
+  return 0;
+}
+function findFlutterBin(options = {}) {
+  const env = options.env ?? process.env;
+  const home = options.home ?? homedir();
+  const envRoot = env.FLUTTER_ROOT;
+  if (envRoot) {
+    const bin = join8(envRoot, "bin", "flutter");
+    if (isExecutable(bin)) return bin;
+  }
+  const fromPathBin = fromPath(env);
+  if (fromPathBin) return fromPathBin;
+  return fromFvm(home);
+}
+function runFlutterPubGet(cwd, bin) {
+  try {
+    execFileSync2(bin, ["pub", "get"], { cwd, stdio: "inherit" });
+    return true;
+  } catch {
+    return false;
+  }
+}
 // src/commands/add.ts
 function addCommand(components, cwd, options = {}) {
   const json = options.json ?? false;
   const dryRun = options.dryRun ?? false;
+  const target = options.target ?? "react";
   const prefix = dryRun ? "[dry-run] " : "";
   let autoInitialized = false;
   if (!configExists(cwd)) {
@@ -973,9 +1254,12 @@ function addCommand(components, cwd, options = {}) {
     }
     process.exit(1);
   }
+  const targetRegistry = {
+    items: filterItemsByTarget(registry.items, target)
+  };
   if (options.block && components.length > 0) {
     for (const name of components) {
-      const item = registry.items.find((i) => i.name === name);
+      const item = targetRegistry.items.find((i) => i.name === name);
       if (item && item.type !== "registry:block") {
         if (json) {
           console.log(
@@ -1012,7 +1296,7 @@ function addCommand(components, cwd, options = {}) {
       }
       process.exit(1);
     }
-    const categoryItems = registry.items.filter(
+    const categoryItems = targetRegistry.items.filter(
       (item) => item.category === options.category
     );
     if (categoryItems.length === 0) {
@@ -1038,7 +1322,7 @@ function addCommand(components, cwd, options = {}) {
   }
   if (itemNames.length === 0) {
     if (options.block) {
-      const blockItems = registry.items.filter(
+      const blockItems = targetRegistry.items.filter(
         (item) => item.type === "registry:block"
       );
       if (json) {
@@ -1077,10 +1361,24 @@ function addCommand(components, cwd, options = {}) {
     }
     process.exit(1);
   }
+  const canonicalNames = [];
+  for (const name of itemNames) {
+    const resolved = findItemForTarget(targetRegistry, name, target);
+    if (!resolved) {
+      const message = `Registry item "${name}" not found for target "${target}".`;
+      if (json) {
+        console.log(JSON.stringify({ success: false, error: message }, null, 2));
+      } else {
+        logger.error(message);
+      }
+      process.exit(1);
+    }
+    canonicalNames.push(resolved.name);
+  }
   const circularWarnings = [];
   let items;
   try {
-    items = resolveTransitiveDeps(registry, itemNames, (msg) => {
+    items = resolveTransitiveDeps(targetRegistry, canonicalNames, (msg) => {
       circularWarnings.push(msg);
     });
   } catch (error) {
@@ -1134,66 +1432,124 @@ function addCommand(components, cwd, options = {}) {
       `${prefix}Files: ${writtenFiles.length} written, ${skippedFiles.length} skipped`
     );
   }
-  const { dependencies, devDependencies } = collectDependencies(items);
-  const uninstalledDeps = dryRun ? dependencies : getUninstalledDeps(dependencies, cwd);
-  const uninstalledDevDeps = dryRun ? devDependencies : getUninstalledDeps(devDependencies, cwd);
+  const { dependencies, devDependencies, pubDependencies } = collectDependencies(items);
   const installedDeps = [];
   const failedDeps = [];
-  if (uninstalledDeps.length > 0) {
-    if (dryRun) {
-      if (!json) {
-        logger.blank();
-        logger.info(`${prefix}Would install dependencies: ${uninstalledDeps.join(", ")}`);
-      }
-      installedDeps.push(...uninstalledDeps);
-    } else {
-      if (!json) {
-        logger.blank();
-        logger.info("Installing dependencies...");
+  const warnings = [];
+  if (target === "flutter") {
+    const uninstalledPubDeps = dryRun ? pubDependencies : pubspecExists(cwd) ? getUninstalledPubDeps(pubDependencies, cwd) : pubDependencies;
+    if (uninstalledPubDeps.length > 0) {
+      if (dryRun) {
+        if (!json) {
+          logger.blank();
+          logger.info(
+            `${prefix}Would add pub dependencies: ${uninstalledPubDeps.map((d) => `${d.pub}@${d.version}`).join(", ")}`
+          );
+        }
+        installedDeps.push(...uninstalledPubDeps.map((d) => d.pub));
+      } else if (!pubspecExists(cwd)) {
+        const message = "No pubspec.yaml found. Run this from a Flutter project root, or add " + uninstalledPubDeps.map((d) => `${d.pub}: ${d.version}`).join(", ") + " to pubspec.yaml manually.";
+        warnings.push(message);
+        if (!json) {
+          logger.blank();
+          logger.warn(message);
+        }
+      } else {
+        if (!json) {
+          logger.blank();
+          logger.info("Updating pubspec.yaml...");
+        }
+        const result = addPubDependencies(uninstalledPubDeps, cwd);
+        installedDeps.push(...result.added);
+        const flutterBin = findFlutterBin();
+        if (flutterBin) {
+          if (!json) {
+            logger.info("Running flutter pub get...");
+          }
+          if (!runFlutterPubGet(cwd, flutterBin)) {
+            const warning = "flutter pub get failed. Run it manually to refresh dependencies.";
+            warnings.push(warning);
+            if (!json) logger.warn(warning);
+          }
+        } else {
+          const warning = "flutter CLI not found. Run `flutter pub get` manually after setting up Flutter (or FVM).";
+          warnings.push(warning);
+          if (!json) logger.warn(warning);
+        }
       }
-      if (installPackages(uninstalledDeps, cwd)) {
+    }
+  } else {
+    const uninstalledDeps = dryRun ? dependencies : getUninstalledDeps(dependencies, cwd);
+    const uninstalledDevDeps = dryRun ? devDependencies : getUninstalledDeps(devDependencies, cwd);
+    if (uninstalledDeps.length > 0) {
+      if (dryRun) {
+        if (!json) {
+          logger.blank();
+          logger.info(
+            `${prefix}Would install dependencies: ${uninstalledDeps.join(", ")}`
+          );
+        }
         installedDeps.push(...uninstalledDeps);
       } else {
-        failedDeps.push(...uninstalledDeps);
         if (!json) {
-          logger.warn("Some dependencies failed to install. Install them manually:");
-          logger.info(`  npm install ${uninstalledDeps.join(" ")}`);
+          logger.blank();
+          logger.info("Installing dependencies...");
+        }
+        if (installPackages(uninstalledDeps, cwd)) {
+          installedDeps.push(...uninstalledDeps);
+        } else {
+          failedDeps.push(...uninstalledDeps);
+          if (!json) {
+            logger.warn(
+              "Some dependencies failed to install. Install them manually:"
+            );
+            logger.info(`  npm install ${uninstalledDeps.join(" ")}`);
+          }
         }
       }
     }
-  }
-  if (uninstalledDevDeps.length > 0) {
-    if (dryRun) {
-      if (!json) {
-        logger.blank();
-        logger.info(`${prefix}Would install dev dependencies: ${uninstalledDevDeps.join(", ")}`);
-      }
-      installedDeps.push(...uninstalledDevDeps);
-    } else {
-      if (!json) {
-        logger.blank();
-        logger.info("Installing dev dependencies...");
-      }
-      if (installPackages(uninstalledDevDeps, cwd, true)) {
+    if (uninstalledDevDeps.length > 0) {
+      if (dryRun) {
+        if (!json) {
+          logger.blank();
+          logger.info(
+            `${prefix}Would install dev dependencies: ${uninstalledDevDeps.join(", ")}`
+          );
+        }
         installedDeps.push(...uninstalledDevDeps);
       } else {
-        failedDeps.push(...uninstalledDevDeps);
         if (!json) {
-          logger.warn("Some dev dependencies failed to install. Install them manually:");
-          logger.info(`  npm install --save-dev ${uninstalledDevDeps.join(" ")}`);
+          logger.blank();
+          logger.info("Installing dev dependencies...");
+        }
+        if (installPackages(uninstalledDevDeps, cwd, true)) {
+          installedDeps.push(...uninstalledDevDeps);
+        } else {
+          failedDeps.push(...uninstalledDevDeps);
+          if (!json) {
+            logger.warn(
+              "Some dev dependencies failed to install. Install them manually:"
+            );
+            logger.info(
+              `  npm install --save-dev ${uninstalledDevDeps.join(" ")}`
+            );
+          }
         }
       }
     }
-  }
-  const warnings = [];
-  if (!hasVisorTokens(cwd)) {
-    const warning = "@loworbitstudio/visor-core is not installed. Components require it for styling.";
-    warnings.push(warning);
-    if (!json) {
-      logger.blank();
-      logger.warn(warning);
-      logger.info("  For Next.js: npx @loworbitstudio/visor init --template nextjs");
-      logger.info("  This generates all tokens inline \u2014 no npm package needed.");
+    if (!hasVisorTokens(cwd)) {
+      const warning = "@loworbitstudio/visor-core is not installed. Components require it for styling.";
+      warnings.push(warning);
+      if (!json) {
+        logger.blank();
+        logger.warn(warning);
+        logger.info(
+          "  For Next.js: npx @loworbitstudio/visor init --template nextjs"
+        );
+        logger.info(
+          "  This generates all tokens inline \u2014 no npm package needed."
+        );
+      }
     }
   }
   if (json) {
@@ -1496,14 +1852,15 @@ function infoCommand(name, cwd, options = {}) {
 }
 // src/commands/theme-apply.ts
-import { readFileSync as readFileSync6, writeFileSync as writeFileSync4, mkdirSync as mkdirSync3 } from "fs";
-import { resolve as resolve2, dirname as dirname4 } from "path";
+import { readFileSync as readFileSync8, writeFileSync as writeFileSync5, mkdirSync as mkdirSync3 } from "fs";
+import { resolve as resolve2, dirname as dirname4, join as join9 } from "path";
 import { generateTheme, generateThemeData as generateThemeData2 } from "@loworbitstudio/visor-theme-engine";
 import {
   nextjsAdapter as nextjsAdapter2,
   fumadocsAdapter,
   deckAdapter,
-  docsAdapter
+  docsAdapter,
+  flutterAdapter
 } from "@loworbitstudio/visor-theme-engine/adapters";
 function defaultOutputPath(adapter, themeName) {
   switch (adapter) {
@@ -1512,13 +1869,15 @@ function defaultOutputPath(adapter, themeName) {
     case "fumadocs":
       return "visor-fumadocs-bridge.css";
     case "deck": {
-      const slug = (themeName ?? "theme").toLowerCase().replace(/\s+/g, "-");
-      return `visor-deck-${slug}.css`;
+      const slug2 = (themeName ?? "theme").toLowerCase().replace(/\s+/g, "-");
+      return `visor-deck-${slug2}.css`;
     }
     case "docs": {
-      const slug = (themeName ?? "theme").toLowerCase().replace(/\s+/g, "-");
-      return `${slug}-theme.css`;
+      const slug2 = (themeName ?? "theme").toLowerCase().replace(/\s+/g, "-");
+      return `${slug2}-theme.css`;
     }
+    case "flutter":
+      return "packages/ui";
     default:
       return "visor-theme.css";
   }
@@ -1527,7 +1886,7 @@ function themeApplyCommand(file, cwd, options) {
   const filePath = resolve2(cwd, file);
   let yamlContent;
   try {
-    yamlContent = readFileSync6(filePath, "utf-8");
+    yamlContent = readFileSync8(filePath, "utf-8");
   } catch {
     if (options.json) {
       console.log(
@@ -1542,7 +1901,8 @@ function themeApplyCommand(file, cwd, options) {
     }
     process.exit(2);
   }
-  let css;
+  let css = null;
+  let fileMap = null;
   let themeName;
   let sections;
   try {
@@ -1567,6 +1927,17 @@ function themeApplyCommand(file, cwd, options) {
         case "docs":
           css = docsAdapter(adapterInput);
           break;
+        case "flutter": {
+          const flutterOptions = {
+            packageName: options.packageName,
+            tokensOnly: options.tokensOnly,
+            lightOnly: options.lightOnly,
+            darkOnly: options.darkOnly,
+            themeClassName: options.themeClassName
+          };
+          fileMap = flutterAdapter(adapterInput, flutterOptions);
+          break;
+        }
         default:
           throw new Error(`Unknown adapter: ${options.adapter}`);
       }
@@ -1591,12 +1962,56 @@ function themeApplyCommand(file, cwd, options) {
     }
     process.exit(1);
   }
-  const outputFile = options.output ?? defaultOutputPath(options.adapter, themeName);
-  const outputPath = resolve2(cwd, outputFile);
+  const outputTarget = options.output ?? defaultOutputPath(options.adapter, themeName);
+  const outputPath = resolve2(cwd, outputTarget);
+  if (fileMap) {
+    try {
+      mkdirSync3(outputPath, { recursive: true });
+      let totalBytes = 0;
+      for (const [relPath, content] of Object.entries(fileMap.files)) {
+        const filePath2 = join9(outputPath, relPath);
+        mkdirSync3(dirname4(filePath2), { recursive: true });
+        writeFileSync5(filePath2, content, "utf-8");
+        totalBytes += content.length;
+      }
+      if (options.json) {
+        console.log(
+          JSON.stringify({
+            success: true,
+            directory: outputPath,
+            adapter: options.adapter,
+            files: Object.keys(fileMap.files),
+            size: totalBytes
+          })
+        );
+      } else {
+        logger.success(`Flutter theme package generated: ${outputPath}`);
+        logger.info(`Adapter: ${options.adapter}`);
+        logger.item(`Files: ${Object.keys(fileMap.files).length}`);
+        logger.item(`Size: ${formatSize(totalBytes)}`);
+      }
+    } catch {
+      if (options.json) {
+        console.log(
+          JSON.stringify({
+            success: false,
+            error: `Could not write package to: ${outputPath}`
+          })
+        );
+      } else {
+        logger.error(`Could not write package to: ${outputPath}`);
+      }
+      process.exit(2);
+    }
+    return;
+  }
+  if (css === null) {
+    process.exit(1);
+  }
   const outputDir = dirname4(outputPath);
   try {
     mkdirSync3(outputDir, { recursive: true });
-    writeFileSync4(outputPath, css, "utf-8");
+    writeFileSync5(outputPath, css, "utf-8");
   } catch {
     if (options.json) {
       console.log(
@@ -1637,7 +2052,7 @@ function formatSize(bytes) {
 }
 // src/commands/theme-export.ts
-import { readFileSync as readFileSync7 } from "fs";
+import { readFileSync as readFileSync9 } from "fs";
 import { resolve as resolve3 } from "path";
 import {
   parseConfig,
@@ -1649,7 +2064,7 @@ function themeExportCommand(file, cwd, options) {
   const filePath = resolve3(cwd, file ?? ".visor.yaml");
   let yamlContent;
   try {
-    yamlContent = readFileSync7(filePath, "utf-8");
+    yamlContent = readFileSync9(filePath, "utf-8");
   } catch {
     if (options.json) {
       console.log(
@@ -1701,7 +2116,7 @@ function themeExportCommand(file, cwd, options) {
 }
 // src/commands/theme-validate.ts
-import { readFileSync as readFileSync8 } from "fs";
+import { readFileSync as readFileSync10 } from "fs";
 import { resolve as resolve4 } from "path";
 import { parse as parseYaml } from "yaml";
 import { validate } from "@loworbitstudio/visor-theme-engine";
@@ -1710,7 +2125,7 @@ function themeValidateCommand(file, cwd, options) {
   const filePath = resolve4(cwd, file);
   let fileContent;
   try {
-    fileContent = readFileSync8(filePath, "utf-8");
+    fileContent = readFileSync10(filePath, "utf-8");
   } catch {
     if (options.json) {
       console.log(
@@ -1797,8 +2212,8 @@ function printIssue(issue) {
 }
 // src/commands/theme-extract.ts
-import { readFileSync as readFileSync9, writeFileSync as writeFileSync5, existsSync as existsSync5, readdirSync as readdirSync2, statSync as statSync2 } from "fs";
-import { resolve as resolve5, join as join7, basename, extname as extname2, relative } from "path";
+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 { stringify as stringifyYaml } from "yaml";
 import {
   extractFromCSS,
@@ -1828,7 +2243,7 @@ var CSS_DIRS = [
 ];
 function themeExtractCommand(cwd, options) {
   const targetDir = resolve5(cwd, options.from ?? ".");
-  if (!existsSync5(targetDir)) {
+  if (!existsSync7(targetDir)) {
     if (options.json) {
       console.log(JSON.stringify({ success: false, error: `Directory not found: ${targetDir}` }));
     } else {
@@ -1882,16 +2297,16 @@ function collectCSSFiles(targetDir) {
   const files = [];
   const seen = /* @__PURE__ */ new Set();
   for (const pattern2 of CSS_FILE_PATTERNS) {
-    const rootPath = join7(targetDir, pattern2);
+    const rootPath = join10(targetDir, pattern2);
     addFileIfExists(rootPath, files, seen);
     for (const dir of CSS_DIRS) {
-      const dirPath = join7(targetDir, dir, pattern2);
+      const dirPath = join10(targetDir, dir, pattern2);
       addFileIfExists(dirPath, files, seen);
     }
   }
   for (const dir of CSS_DIRS) {
-    const dirPath = join7(targetDir, dir);
-    if (existsSync5(dirPath) && statSync2(dirPath).isDirectory()) {
+    const dirPath = join10(targetDir, dir);
+    if (existsSync7(dirPath) && statSync3(dirPath).isDirectory()) {
       scanDirForCSS(dirPath, files, seen, 2);
     }
   }
@@ -1901,9 +2316,9 @@ function collectCSSFiles(targetDir) {
 function addFileIfExists(filePath, files, seen) {
   const resolved = resolve5(filePath);
   if (seen.has(resolved)) return;
-  if (!existsSync5(resolved)) return;
+  if (!existsSync7(resolved)) return;
   try {
-    const content = readFileSync9(resolved, "utf-8");
+    const content = readFileSync11(resolved, "utf-8");
     if (content.includes("--")) {
       files.push({ path: resolved, content });
       seen.add(resolved);
@@ -1912,7 +2327,7 @@ function addFileIfExists(filePath, files, seen) {
   }
 }
 function scanDirForCSS(dir, files, seen, maxDepth) {
-  if (!existsSync5(dir)) return;
+  if (!existsSync7(dir)) return;
   const SKIP_DIRS = /* @__PURE__ */ new Set([
     "node_modules",
     ".next",
@@ -1926,15 +2341,15 @@ function scanDirForCSS(dir, files, seen, maxDepth) {
     ".vercel"
   ]);
   try {
-    const entries = readdirSync2(dir, { withFileTypes: true });
+    const entries = readdirSync3(dir, { withFileTypes: true });
     for (const entry of entries) {
       if (entry.isDirectory()) {
         if (SKIP_DIRS.has(entry.name)) continue;
         if (maxDepth > 0) {
-          scanDirForCSS(join7(dir, entry.name), files, seen, maxDepth - 1);
+          scanDirForCSS(join10(dir, entry.name), files, seen, maxDepth - 1);
         }
       } else if (entry.isFile() && extname2(entry.name) === ".css") {
-        addFileIfExists(join7(dir, entry.name), files, seen);
+        addFileIfExists(join10(dir, entry.name), files, seen);
       }
     }
   } catch {
@@ -2016,10 +2431,10 @@ function extractVarName(varExpr) {
 function parseNextFontFromLayouts(targetDir) {
   const fontMap = /* @__PURE__ */ new Map();
   for (const relPath of LAYOUT_FILE_PATHS) {
-    const fullPath = join7(targetDir, relPath);
-    if (!existsSync5(fullPath)) continue;
+    const fullPath = join10(targetDir, relPath);
+    if (!existsSync7(fullPath)) continue;
     try {
-      const content = readFileSync9(fullPath, "utf-8");
+      const content = readFileSync11(fullPath, "utf-8");
       parseNextFontDeclarations(content, fontMap);
     } catch {
     }
@@ -2104,10 +2519,10 @@ var MONO_FONT_NAMES = /* @__PURE__ */ new Set([
   "IBM Plex Mono"
 ]);
 function extractFontHints(targetDir) {
-  const pkgPath = join7(targetDir, "package.json");
-  if (!existsSync5(pkgPath)) return void 0;
+  const pkgPath = join10(targetDir, "package.json");
+  if (!existsSync7(pkgPath)) return void 0;
   try {
-    const pkg = JSON.parse(readFileSync9(pkgPath, "utf-8"));
+    const pkg = JSON.parse(readFileSync11(pkgPath, "utf-8"));
     const allDeps = { ...pkg.dependencies, ...pkg.devDependencies };
     const fonts2 = [];
     for (const [dep, _] of Object.entries(allDeps)) {
@@ -2143,10 +2558,10 @@ function extractFontHints(targetDir) {
   }
 }
 function inferThemeName(targetDir) {
-  const pkgPath = join7(targetDir, "package.json");
-  if (existsSync5(pkgPath)) {
+  const pkgPath = join10(targetDir, "package.json");
+  if (existsSync7(pkgPath)) {
     try {
-      const pkg = JSON.parse(readFileSync9(pkgPath, "utf-8"));
+      const pkg = JSON.parse(readFileSync11(pkgPath, "utf-8"));
       if (pkg.name) {
         const name = pkg.name.replace(/^@[\w-]+\//, "");
         return `${name}-theme`;
@@ -2211,7 +2626,7 @@ function outputYAML(result, outputPath, cwd, validationResult) {
     }
     logger.blank();
   }
-  writeFileSync5(outFile, yamlStr, "utf-8");
+  writeFileSync6(outFile, yamlStr, "utf-8");
   logger.success(`Theme written to ${relative(cwd, outFile)}`);
   if (validationResult) {
     logger.blank();
@@ -2269,14 +2684,14 @@ function buildAnnotatedYAML(result) {
 }
 // src/commands/theme-register.ts
-import { readFileSync as readFileSync10, writeFileSync as writeFileSync6, mkdirSync as mkdirSync4, existsSync as existsSync7 } from "fs";
-import { resolve as resolve7, join as join9 } from "path";
+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 { 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 existsSync6 } from "fs";
-import { resolve as resolve6, dirname as dirname5, join as join8 } from "path";
+import { existsSync as existsSync8 } from "fs";
+import { resolve as resolve6, dirname as dirname5, join as join11 } from "path";
 function toSlug(name) {
   return name.toLowerCase().replace(/\s+/g, "-");
 }
@@ -2286,7 +2701,7 @@ function toLabel(name) {
 function findRepoRoot(startDir) {
   let current = resolve6(startDir);
   while (true) {
-    if (existsSync6(join8(current, "packages", "docs"))) {
+    if (existsSync8(join11(current, "packages", "docs"))) {
       return current;
     }
     const parent = dirname5(current);
@@ -2297,8 +2712,8 @@ function findRepoRoot(startDir) {
 }
 // src/commands/theme-register.ts
-function insertGlobalsImport(content, slug) {
-  const importLine = `@import './${slug}-theme.css';`;
+function insertGlobalsImport(content, slug2) {
+  const importLine = `@import './${slug2}-theme.css';`;
   if (content.includes(importLine)) {
     return { updated: content, changed: false };
   }
@@ -2329,8 +2744,8 @@ function insertGlobalsImport(content, slug) {
   lines.splice(insertAt, 0, importLine);
   return { updated: lines.join("\n"), changed: true };
 }
-function insertThemeConfig(content, slug, label, group) {
-  if (content.includes(`value: "${slug}"`)) {
+function insertThemeConfig(content, slug2, label, group) {
+  if (content.includes(`value: "${slug2}"`)) {
     return { updated: content, changed: false };
   }
   const escapedGroup = group.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
@@ -2363,7 +2778,7 @@ function insertThemeConfig(content, slug, label, group) {
   }
   let insertPos = closingBracket;
   for (const e of entries) {
-    if (slug < e.value) {
+    if (slug2 < e.value) {
       insertPos = e.start;
       break;
     }
@@ -2372,7 +2787,7 @@ function insertThemeConfig(content, slug, label, group) {
   const lineContent = content.slice(prevNewline + 1, insertPos);
   const indentMatch = /^(\s*)/.exec(lineContent);
   const indent = indentMatch ? indentMatch[1] : "      ";
-  const newEntry = `{ value: "${slug}", label: "${label}" }`;
+  const newEntry = `{ value: "${slug2}", label: "${label}" }`;
   const insertion = entries.length === 0 ? `
 ${indent}${newEntry},
     ` : `${indent}${newEntry},
@@ -2384,7 +2799,7 @@ function themeRegisterCommand(file, cwd, options) {
   const filePath = resolve7(cwd, file);
   let yamlContent;
   try {
-    yamlContent = readFileSync10(filePath, "utf-8");
+    yamlContent = readFileSync12(filePath, "utf-8");
   } catch {
     if (options.json) {
       console.log(JSON.stringify({ success: false, error: `Could not read file: ${filePath}` }));
@@ -2408,7 +2823,7 @@ function themeRegisterCommand(file, cwd, options) {
     process.exit(1);
     return;
   }
-  const slug = toSlug(data.config.name);
+  const slug2 = toSlug(data.config.name);
   const label = toLabel(data.config.name);
   const adapterInput = {
     primitives: data.primitives,
@@ -2427,11 +2842,11 @@ function themeRegisterCommand(file, cwd, options) {
     process.exit(1);
     return;
   }
-  const docsAppDir = join9(repoRoot, "packages", "docs", "app");
-  const cssFilePath = join9(docsAppDir, `${slug}-theme.css`);
-  const globalsPath = join9(docsAppDir, "globals.css");
-  const themeConfigPath = join9(repoRoot, "packages", "docs", "lib", "theme-config.ts");
-  if (!existsSync7(docsAppDir)) {
+  const docsAppDir = join12(repoRoot, "packages", "docs", "app");
+  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)) {
     const msg = `Docs app directory not found: ${docsAppDir}`;
     if (options.json) {
       console.log(JSON.stringify({ success: false, error: msg }));
@@ -2444,8 +2859,8 @@ function themeRegisterCommand(file, cwd, options) {
   let globalsContent = "";
   let themeConfigContent = "";
   try {
-    globalsContent = readFileSync10(globalsPath, "utf-8");
-    themeConfigContent = readFileSync10(themeConfigPath, "utf-8");
+    globalsContent = readFileSync12(globalsPath, "utf-8");
+    themeConfigContent = readFileSync12(themeConfigPath, "utf-8");
   } catch (err) {
     const msg = err instanceof Error ? err.message : "Could not read docs files";
     if (options.json) {
@@ -2456,12 +2871,12 @@ function themeRegisterCommand(file, cwd, options) {
     process.exit(1);
     return;
   }
-  const cssExists = existsSync7(cssFilePath);
-  const cssChanged = !cssExists || readFileSync10(cssFilePath, "utf-8") !== css;
-  const { updated: newGlobals, changed: globalsChanged } = insertGlobalsImport(globalsContent, slug);
+  const cssExists = existsSync9(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(
     themeConfigContent,
-    slug,
+    slug2,
     label,
     options.group
   );
@@ -2479,7 +2894,7 @@ function themeRegisterCommand(file, cwd, options) {
       console.log(JSON.stringify({
         success: true,
         dryRun: true,
-        slug,
+        slug: slug2,
         label,
         group: options.group,
         changes: {
@@ -2490,7 +2905,7 @@ function themeRegisterCommand(file, cwd, options) {
       }));
     } else {
       logger.info("Dry run \u2014 no files written");
-      logger.item(`Theme: ${label} (${slug})`);
+      logger.item(`Theme: ${label} (${slug2})`);
       logger.item(`Group: ${options.group}`);
       logger.item(`CSS file: ${cssFilePath} \u2014 ${cssChanged ? cssExists ? "update" : "create" : "no change"}`);
       logger.item(`globals.css: ${globalsChanged ? "add import" : "already registered"}`);
@@ -2501,13 +2916,13 @@ function themeRegisterCommand(file, cwd, options) {
   try {
     if (cssChanged) {
       mkdirSync4(docsAppDir, { recursive: true });
-      writeFileSync6(cssFilePath, css, "utf-8");
+      writeFileSync7(cssFilePath, css, "utf-8");
     }
     if (globalsChanged) {
-      writeFileSync6(globalsPath, newGlobals, "utf-8");
+      writeFileSync7(globalsPath, newGlobals, "utf-8");
     }
     if (themeConfigChanged) {
-      writeFileSync6(themeConfigPath, newThemeConfig, "utf-8");
+      writeFileSync7(themeConfigPath, newThemeConfig, "utf-8");
     }
   } catch (err) {
     const msg = err instanceof Error ? err.message : "Write failed";
@@ -2522,14 +2937,14 @@ function themeRegisterCommand(file, cwd, options) {
   if (options.json) {
     console.log(JSON.stringify({
       success: true,
-      slug,
+      slug: slug2,
       label,
       group: options.group,
       files: { css: cssFilePath, globals: globalsPath, themeConfig: themeConfigPath },
       changes: { cssFile: cssChanged, globalsCSS: globalsChanged, themeConfig: themeConfigChanged }
     }));
   } else {
-    logger.success(`Theme registered: ${label} (${slug})`);
+    logger.success(`Theme registered: ${label} (${slug2})`);
     logger.item(`Group: ${options.group}`);
     if (cssChanged) logger.item(`CSS: ${cssFilePath}`);
     if (globalsChanged) logger.item(`globals.css updated`);
@@ -2541,28 +2956,28 @@ function themeRegisterCommand(file, cwd, options) {
 }
 // src/commands/theme-unregister.ts
-import { readFileSync as readFileSync11, writeFileSync as writeFileSync7, existsSync as existsSync8, unlinkSync } from "fs";
-import { join as join10 } from "path";
-function removeGlobalsImport(content, slug) {
-  const importLine = `@import './${slug}-theme.css';`;
+import { readFileSync as readFileSync13, writeFileSync as writeFileSync8, existsSync as existsSync10, unlinkSync } from "fs";
+import { join as join13 } from "path";
+function removeGlobalsImport(content, slug2) {
+  const importLine = `@import './${slug2}-theme.css';`;
   if (!content.includes(importLine)) {
     return { updated: content, changed: false };
   }
   const updated = content.split("\n").filter((line) => line !== importLine).join("\n");
   return { updated, changed: true };
 }
-function removeThemeConfigEntry(content, slug) {
-  if (!content.includes(`value: "${slug}"`)) {
+function removeThemeConfigEntry(content, slug2) {
+  if (!content.includes(`value: "${slug2}"`)) {
     return { updated: content, changed: false };
   }
   const entryPattern = new RegExp(
-    `\\s*\\{\\s*value:\\s*"${slug.replace(/[.*+?^${}()|[\]\\]/g, "\\$&")}"[^}]*\\},?`,
+    `\\s*\\{\\s*value:\\s*"${slug2.replace(/[.*+?^${}()|[\]\\]/g, "\\$&")}"[^}]*\\},?`,
     "g"
   );
   const updated = content.replace(entryPattern, "");
   return { updated, changed: true };
 }
-function themeUnregisterCommand(slug, cwd, options) {
+function themeUnregisterCommand(slug2, cwd, options) {
   const repoRoot = findRepoRoot(cwd);
   if (!repoRoot) {
     const msg = "Could not locate repo root (packages/docs/ not found). Run from within the visor repo.";
@@ -2574,11 +2989,11 @@ function themeUnregisterCommand(slug, cwd, options) {
     process.exit(1);
     return;
   }
-  const docsAppDir = join10(repoRoot, "packages", "docs", "app");
-  const cssFilePath = join10(docsAppDir, `${slug}-theme.css`);
-  const globalsPath = join10(docsAppDir, "globals.css");
-  const themeConfigPath = join10(repoRoot, "packages", "docs", "lib", "theme-config.ts");
-  if (!existsSync8(docsAppDir)) {
+  const docsAppDir = join13(repoRoot, "packages", "docs", "app");
+  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)) {
     const msg = `Docs app directory not found: ${docsAppDir}`;
     if (options.json) {
       console.log(JSON.stringify({ success: false, error: msg }));
@@ -2591,8 +3006,8 @@ function themeUnregisterCommand(slug, cwd, options) {
   let globalsContent = "";
   let themeConfigContent = "";
   try {
-    globalsContent = readFileSync11(globalsPath, "utf-8");
-    themeConfigContent = readFileSync11(themeConfigPath, "utf-8");
+    globalsContent = readFileSync13(globalsPath, "utf-8");
+    themeConfigContent = readFileSync13(themeConfigPath, "utf-8");
   } catch (err) {
     const msg = err instanceof Error ? err.message : "Could not read docs files";
     if (options.json) {
@@ -2603,21 +3018,21 @@ function themeUnregisterCommand(slug, cwd, options) {
     process.exit(1);
     return;
   }
-  const cssExists = existsSync8(cssFilePath);
-  const { updated: newGlobals, changed: globalsChanged } = removeGlobalsImport(globalsContent, slug);
-  const { updated: newThemeConfig, changed: themeConfigChanged } = removeThemeConfigEntry(themeConfigContent, slug);
+  const cssExists = existsSync10(cssFilePath);
+  const { updated: newGlobals, changed: globalsChanged } = removeGlobalsImport(globalsContent, slug2);
+  const { updated: newThemeConfig, changed: themeConfigChanged } = removeThemeConfigEntry(themeConfigContent, slug2);
   if (!cssExists && !globalsChanged && !themeConfigChanged) {
     if (options.json) {
-      console.log(JSON.stringify({ success: true, slug, changes: { cssFile: false, globalsCSS: false, themeConfig: false } }));
+      console.log(JSON.stringify({ success: true, slug: slug2, changes: { cssFile: false, globalsCSS: false, themeConfig: false } }));
     } else {
-      logger.info(`Theme "${slug}" is not registered \u2014 nothing to remove.`);
+      logger.info(`Theme "${slug2}" is not registered \u2014 nothing to remove.`);
     }
     return;
   }
   try {
     if (cssExists) unlinkSync(cssFilePath);
-    if (globalsChanged) writeFileSync7(globalsPath, newGlobals, "utf-8");
-    if (themeConfigChanged) writeFileSync7(themeConfigPath, newThemeConfig, "utf-8");
+    if (globalsChanged) writeFileSync8(globalsPath, newGlobals, "utf-8");
+    if (themeConfigChanged) writeFileSync8(themeConfigPath, newThemeConfig, "utf-8");
   } catch (err) {
     const msg = err instanceof Error ? err.message : "Write failed";
     if (options.json) {
@@ -2631,11 +3046,11 @@ function themeUnregisterCommand(slug, cwd, options) {
   if (options.json) {
     console.log(JSON.stringify({
       success: true,
-      slug,
+      slug: slug2,
       changes: { cssFile: cssExists, globalsCSS: globalsChanged, themeConfig: themeConfigChanged }
     }));
   } else {
-    logger.success(`Theme unregistered: ${slug}`);
+    logger.success(`Theme unregistered: ${slug2}`);
     if (cssExists) logger.item(`CSS file removed: ${cssFilePath}`);
     if (globalsChanged) logger.item(`globals.css updated`);
     if (themeConfigChanged) logger.item(`theme-config.ts updated`);
@@ -2644,15 +3059,15 @@ function themeUnregisterCommand(slug, cwd, options) {
 // src/commands/theme-sync.ts
 import {
-  readFileSync as readFileSync12,
-  writeFileSync as writeFileSync8,
+  readFileSync as readFileSync14,
+  writeFileSync as writeFileSync9,
   mkdirSync as mkdirSync5,
-  existsSync as existsSync9,
-  readdirSync as readdirSync3,
+  existsSync as existsSync11,
+  readdirSync as readdirSync4,
   unlinkSync as unlinkSync2,
   copyFileSync
 } from "fs";
-import { join as join11, basename as basename2 } from "path";
+import { join as join14, basename as basename2 } from "path";
 import { parse as parseYaml2 } from "yaml";
 import { generateThemeData as generateThemeData4 } from "@loworbitstudio/visor-theme-engine";
 import { docsAdapter as docsAdapter3 } from "@loworbitstudio/visor-theme-engine/adapters";
@@ -2666,8 +3081,8 @@ 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 (!existsSync9(dir)) return [];
-  return readdirSync3(dir).filter((f) => f.endsWith(".visor.yaml")).map((f) => join11(dir, f));
+  if (!existsSync11(dir)) return [];
+  return readdirSync4(dir).filter((f) => f.endsWith(".visor.yaml")).map((f) => join14(dir, f));
 }
 function extractGroup(yamlContent) {
   const parsed = parseYaml2(yamlContent);
@@ -2693,7 +3108,7 @@ function sortGroups(groups) {
   });
 }
 function updateGlobalsImports(content, stockSlugs) {
-  const importLines = [...stockSlugs].sort().map((slug) => `@import './${slug}-theme.css';`).join("\n");
+  const importLines = [...stockSlugs].sort().map((slug2) => `@import './${slug2}-theme.css';`).join("\n");
   const newBlock = `${GLOBALS_BEGIN_MARKER}
 ${importLines}
 ${GLOBALS_END_MARKER}`;
@@ -2827,7 +3242,7 @@ ${groupsTs}
 `;
 }
 function updateGitignoreBlock(content, customSlugs) {
-  const cssLines = customSlugs.sort().map((slug) => `packages/docs/app/${slug}-theme.css`).join("\n");
+  const cssLines = customSlugs.sort().map((slug2) => `packages/docs/app/${slug2}-theme.css`).join("\n");
   const newBlock = `${GITIGNORE_BEGIN_MARKER}
 ${cssLines}
 ${GITIGNORE_END_MARKER}`;
@@ -2850,16 +3265,16 @@ function themeSyncCommand(cwd, options) {
     process.exit(1);
     return;
   }
-  const themesDir = join11(repoRoot, "themes");
-  const customThemesDir = join11(repoRoot, "custom-themes");
-  const docsAppDir = join11(repoRoot, "packages", "docs", "app");
-  const docsLibDir = join11(repoRoot, "packages", "docs", "lib");
-  const docsPublicThemesDir = join11(repoRoot, "packages", "docs", "public", "themes");
-  const themeConfigPath = join11(repoRoot, "packages", "docs", "lib", "theme-config.ts");
-  const globalsPath = join11(docsAppDir, "globals.css");
-  const gitignorePath = join11(repoRoot, ".gitignore");
-  const customOverlayCssPath = join11(repoRoot, CUSTOM_OVERLAY_CSS_PATH);
-  const customOverlayTsPath = join11(repoRoot, CUSTOM_OVERLAY_TS_PATH);
+  const themesDir = join14(repoRoot, "themes");
+  const customThemesDir = join14(repoRoot, "custom-themes");
+  const docsAppDir = join14(repoRoot, "packages", "docs", "app");
+  const docsLibDir = join14(repoRoot, "packages", "docs", "lib");
+  const docsPublicThemesDir = join14(repoRoot, "packages", "docs", "public", "themes");
+  const themeConfigPath = join14(repoRoot, "packages", "docs", "lib", "theme-config.ts");
+  const globalsPath = join14(docsAppDir, "globals.css");
+  const gitignorePath = join14(repoRoot, ".gitignore");
+  const customOverlayCssPath = join14(repoRoot, CUSTOM_OVERLAY_CSS_PATH);
+  const customOverlayTsPath = join14(repoRoot, CUSTOM_OVERLAY_TS_PATH);
   const stockFiles = scanThemeDir(themesDir);
   const customFiles = scanThemeDir(customThemesDir);
   if (stockFiles.length === 0 && customFiles.length === 0) {
@@ -2876,7 +3291,7 @@ function themeSyncCommand(cwd, options) {
   const processFile = (filePath, isCustom) => {
     let yamlContent;
     try {
-      yamlContent = readFileSync12(filePath, "utf-8");
+      yamlContent = readFileSync14(filePath, "utf-8");
     } catch {
       errors.push(`Could not read: ${filePath}`);
       return;
@@ -2888,13 +3303,13 @@ function themeSyncCommand(cwd, options) {
       errors.push(`Failed to parse ${basename2(filePath)}: ${err instanceof Error ? err.message : "Unknown error"}`);
       return;
     }
-    const slug = toSlug(data.config.name);
+    const slug2 = toSlug(data.config.name);
     const label = extractLabel(yamlContent) ?? toLabel(data.config.name);
     const group = extractGroup(yamlContent) ?? (isCustom ? "Custom" : "Visor");
     const defaultMode = extractDefaultMode(yamlContent);
     const css = docsAdapter3({ primitives: data.primitives, tokens: data.tokens, config: data.config });
     const yamlFilename = basename2(filePath).replace(/\.visor\.yaml$/, "");
-    manifest.push({ slug, label, group, defaultMode, css, yamlFilename, isCustom });
+    manifest.push({ slug: slug2, label, group, defaultMode, css, yamlFilename, isCustom });
   };
   for (const f of stockFiles) processFile(f, false);
   for (const f of customFiles) processFile(f, true);
@@ -2916,9 +3331,9 @@ function themeSyncCommand(cwd, options) {
   let themeConfigContent;
   let gitignoreContent;
   try {
-    globalsContent = readFileSync12(globalsPath, "utf-8");
-    themeConfigContent = readFileSync12(themeConfigPath, "utf-8");
-    gitignoreContent = existsSync9(gitignorePath) ? readFileSync12(gitignorePath, "utf-8") : "";
+    globalsContent = readFileSync14(globalsPath, "utf-8");
+    themeConfigContent = readFileSync14(themeConfigPath, "utf-8");
+    gitignoreContent = existsSync11(gitignorePath) ? readFileSync14(gitignorePath, "utf-8") : "";
   } catch (err) {
     const msg = err instanceof Error ? err.message : "Could not read docs files";
     if (options.json) {
@@ -2934,12 +3349,12 @@ function themeSyncCommand(cwd, options) {
   const newGitignore = customSlugs.length > 0 ? updateGitignoreBlock(gitignoreContent, customSlugs) : gitignoreContent;
   const newCustomOverlayCss = generateCustomOverlayCss(customManifest);
   const newCustomOverlayTs = generateCustomOverlayTs(customManifest);
-  const existingCssFiles = existsSync9(docsAppDir) ? readdirSync3(docsAppDir).filter(
+  const existingCssFiles = existsSync11(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 = existsSync9(docsPublicThemesDir) ? readdirSync3(docsPublicThemesDir).filter((f) => f.endsWith(".visor.yaml")) : [];
+  const existingPublicYamls = existsSync11(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) {
@@ -2971,25 +3386,25 @@ function themeSyncCommand(cwd, options) {
     mkdirSync5(docsLibDir, { recursive: true });
     mkdirSync5(docsPublicThemesDir, { recursive: true });
     for (const entry of manifest) {
-      writeFileSync8(join11(docsAppDir, `${entry.slug}-theme.css`), entry.css, "utf-8");
+      writeFileSync9(join14(docsAppDir, `${entry.slug}-theme.css`), entry.css, "utf-8");
     }
     for (const stale of staleCssFiles) {
-      unlinkSync2(join11(docsAppDir, stale));
+      unlinkSync2(join14(docsAppDir, stale));
     }
-    writeFileSync8(customOverlayCssPath, newCustomOverlayCss, "utf-8");
-    writeFileSync8(customOverlayTsPath, newCustomOverlayTs, "utf-8");
-    writeFileSync8(themeConfigPath, newThemeConfig, "utf-8");
-    writeFileSync8(globalsPath, newGlobals, "utf-8");
-    if (existsSync9(gitignorePath)) {
-      writeFileSync8(gitignorePath, newGitignore, "utf-8");
+    writeFileSync9(customOverlayCssPath, newCustomOverlayCss, "utf-8");
+    writeFileSync9(customOverlayTsPath, newCustomOverlayTs, "utf-8");
+    writeFileSync9(themeConfigPath, newThemeConfig, "utf-8");
+    writeFileSync9(globalsPath, newGlobals, "utf-8");
+    if (existsSync11(gitignorePath)) {
+      writeFileSync9(gitignorePath, newGitignore, "utf-8");
     }
     const allSourceFiles = [...stockFiles, ...customFiles];
     for (const srcFile of allSourceFiles) {
       const filename = basename2(srcFile);
-      copyFileSync(srcFile, join11(docsPublicThemesDir, filename));
+      copyFileSync(srcFile, join14(docsPublicThemesDir, filename));
     }
     for (const stale of stalePublicYamls) {
-      unlinkSync2(join11(docsPublicThemesDir, stale));
+      unlinkSync2(join14(docsPublicThemesDir, stale));
     }
   } catch (err) {
     const msg = err instanceof Error ? err.message : "Write failed";
@@ -3023,12 +3438,304 @@ function themeSyncCommand(cwd, options) {
   }
 }
+// src/commands/theme-batch-apply-flutter.ts
+import {
+  readFileSync as readFileSync15,
+  writeFileSync as writeFileSync10,
+  mkdirSync as mkdirSync6,
+  existsSync as existsSync12,
+  readdirSync as readdirSync5,
+  rmSync
+} from "fs";
+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 [];
+  return readdirSync5(dir).filter((f) => f.endsWith(".visor.yaml")).map((f) => join15(dir, f)).sort();
+}
+function slugToCamel(slug2) {
+  return slug2.replace(/-([a-z])/g, (_, c) => c.toUpperCase());
+}
+function mapAdapterPath(relPath) {
+  if (relPath === "pubspec.yaml") return null;
+  if (relPath === "lib/ui.dart") return null;
+  if (relPath.startsWith("lib/src/")) {
+    return relPath.slice("lib/src/".length);
+  }
+  return null;
+}
+function emitVisorThemesPubspec() {
+  return [
+    `name: visor_themes`,
+    `description: All Visor-generated Flutter ThemeData packages \u2014 4 stock + 7 custom themes. GENERATED \u2014 regenerate with \`npm run themes:apply-flutter\`.`,
+    `version: 0.1.0+1`,
+    `publish_to: none`,
+    ``,
+    `environment:`,
+    `  sdk: ^3.5.0`,
+    `  flutter: ^3.24.0`,
+    ``,
+    `dependencies:`,
+    `  flutter:`,
+    `    sdk: flutter`,
+    `  visor_core: ^0.1.0`,
+    ``,
+    `dev_dependencies:`,
+    `  flutter_test:`,
+    `    sdk: flutter`,
+    `  flutter_lints: ^5.0.0`,
+    ``,
+    `flutter:`,
+    `  uses-material-design: true`,
+    ``
+  ].join("\n");
+}
+function emitVisorThemesPubspecOverrides() {
+  return [
+    `# Path overrides for in-monorepo development.`,
+    `# visor_core is not yet published to pub.dev; this forces the local copy.`,
+    `dependency_overrides:`,
+    `  visor_core:`,
+    `    path: ../visor-flutter`,
+    ``
+  ].join("\n");
+}
+function emitAnalysisOptions() {
+  return [
+    `include: package:flutter_lints/flutter.yaml`,
+    ``,
+    `linter:`,
+    `  rules:`,
+    `    - avoid_print`,
+    ``
+  ].join("\n");
+}
+function slugToDartPrefix(slug2) {
+  return slug2.replace(/-/g, "_") + "_t";
+}
+function emitMetaBarrel(slugs) {
+  const lines = [
+    `// GENERATED BY visor \u2014 DO NOT EDIT.`,
+    `// Regenerate with \`npm run themes:apply-flutter\`.`,
+    `//`,
+    `// Aggregates Dart ThemeData for all Visor themes (4 stock + 7 custom).`,
+    `// Access themes via [VisorThemes], e.g. VisorThemes.blackout.light`,
+    ``,
+    `import 'package:flutter/material.dart';`,
+    ``,
+    `// Re-export visor_core so consumers access VisorColorsData etc. with`,
+    `// a single import of this package.`,
+    `export 'package:visor_core/visor_core.dart';`,
+    ``
+  ];
+  for (const slug2 of slugs) {
+    const prefix = slugToDartPrefix(slug2);
+    lines.push(`import 'src/${slug2}/theme/visor_theme.dart' as ${prefix};`);
+  }
+  lines.push(``);
+  lines.push(`/// A light/dark [ThemeData] pair for a single Visor theme.`);
+  lines.push(`class VisorThemePair {`);
+  lines.push(`  final ThemeData light;`);
+  lines.push(`  final ThemeData dark;`);
+  lines.push(`  const VisorThemePair({required this.light, required this.dark});`);
+  lines.push(`}`);
+  lines.push(``);
+  lines.push(`/// Static access to all Visor-generated Flutter themes.`);
+  lines.push(`///`);
+  lines.push(`/// Usage:`);
+  lines.push(`/// \`\`\`dart`);
+  lines.push(`/// MaterialApp(`);
+  lines.push(`///   theme: VisorThemes.blackout.light,`);
+  lines.push(`///   darkTheme: VisorThemes.blackout.dark,`);
+  lines.push(`/// );`);
+  lines.push(`/// \`\`\``);
+  lines.push(`sealed class VisorThemes {`);
+  for (const slug2 of slugs) {
+    const camel = slugToCamel(slug2);
+    const prefix = slugToDartPrefix(slug2);
+    lines.push(`  static VisorThemePair get ${camel} => VisorThemePair(`);
+    lines.push(`    light: ${prefix}.VisorAppTheme.light,`);
+    lines.push(`    dark: ${prefix}.VisorAppTheme.dark,`);
+    lines.push(`  );`);
+  }
+  lines.push(`}`);
+  lines.push(``);
+  return lines.join("\n");
+}
+function emitGitignore() {
+  return [
+    `.dart_tool/`,
+    `.packages`,
+    `build/`,
+    `pubspec.lock`,
+    `*.g.dart`,
+    ``
+  ].join("\n");
+}
+function themeBatchApplyFlutterCommand(cwd, options) {
+  const repoRoot = findRepoRoot(cwd);
+  if (!repoRoot) {
+    const msg = "Could not locate repo root (packages/docs/ not found). Run from within the visor repo.";
+    if (options.json) {
+      console.log(JSON.stringify({ success: false, error: msg }));
+    } else {
+      logger.error(msg);
+    }
+    process.exit(1);
+    return;
+  }
+  const themesDir = join15(repoRoot, "themes");
+  const customThemesDir = join15(repoRoot, "custom-themes");
+  const outputDir = join15(repoRoot, "packages", "visor_themes");
+  const stockFiles = scanThemeDir2(themesDir);
+  const customFiles = scanThemeDir2(customThemesDir);
+  const allFiles = [...stockFiles, ...customFiles];
+  if (allFiles.length === 0) {
+    const msg = `No .visor.yaml files found in themes/ or custom-themes/. Nothing to generate.`;
+    if (options.json) {
+      console.log(JSON.stringify({ success: false, error: msg }));
+    } else {
+      logger.warn(msg);
+    }
+    return;
+  }
+  if (!options.json) {
+    logger.info(`Found ${allFiles.length} theme YAML files (${stockFiles.length} stock, ${customFiles.length} custom)`);
+  }
+  const processed = [];
+  const errors = [];
+  for (const filePath of allFiles) {
+    let yamlContent;
+    try {
+      yamlContent = readFileSync15(filePath, "utf-8");
+    } catch {
+      errors.push(`Could not read: ${filePath}`);
+      continue;
+    }
+    let data;
+    try {
+      data = generateThemeData5(yamlContent);
+    } catch (err) {
+      errors.push(
+        `Failed to parse ${basename3(filePath)}: ${err instanceof Error ? err.message : "Unknown error"}`
+      );
+      continue;
+    }
+    const slug2 = data.config.name.toLowerCase().replace(/\s+/g, "-");
+    const camel = slugToCamel(slug2);
+    const flutterOptions = {
+      packageName: `visor_themes_${slug2.replace(/-/g, "_")}`,
+      themeClassName: "VisorAppTheme"
+    };
+    let fileMap;
+    try {
+      fileMap = flutterAdapter2(
+        {
+          primitives: data.primitives,
+          tokens: data.tokens,
+          config: data.config
+        },
+        flutterOptions
+      );
+    } catch (err) {
+      errors.push(
+        `Failed flutter adapter for ${slug2}: ${err instanceof Error ? err.message : "Unknown error"}`
+      );
+      continue;
+    }
+    const primsAsUnknown = data.primitives;
+    const primitivesMap = primsAsUnknown;
+    const primaryHex = typeof primitivesMap?.primary500 === "string" ? primitivesMap.primary500 : "#000000";
+    const tokenFiles = {};
+    for (const [relPath, content] of Object.entries(fileMap.files)) {
+      const mapped = mapAdapterPath(relPath);
+      if (mapped !== null) {
+        tokenFiles[mapped] = content;
+      }
+    }
+    if (tokenFiles["theme/visor_theme.dart"]) {
+      tokenFiles["theme/visor_theme.dart"] = tokenFiles["theme/visor_theme.dart"].replace(/import '\.\.\/colors\/visor_colors\.dart';/g, "import '../colors/visor_colors.dart';").replace(/import '\.\.\/typography\/visor_text_styles\.dart';/g, "import '../typography/visor_text_styles.dart';").replace(/import '\.\.\/spacing\/visor_spacing\.dart';/g, "import '../spacing/visor_spacing.dart';").replace(/import '\.\.\/radius\/visor_radius\.dart';/g, "import '../radius/visor_radius.dart';").replace(/import '\.\.\/shadows\/visor_shadows\.dart';/g, "import '../shadows/visor_shadows.dart';").replace(/import '\.\.\/strokes\/visor_stroke_widths\.dart';/g, "import '../strokes/visor_stroke_widths.dart';").replace(/import '\.\.\/opacity\/visor_opacity\.dart';/g, "import '../opacity/visor_opacity.dart';").replace(/import '\.\.\/motion\/visor_motion\.dart';/g, "import '../motion/visor_motion.dart';");
+    }
+    processed.push({ slug: slug2, camel, primaryHex, tokenFiles });
+  }
+  if (errors.length > 0) {
+    if (options.json) {
+      console.log(JSON.stringify({ success: false, errors }));
+    } else {
+      errors.forEach((e) => logger.error(e));
+    }
+    process.exit(1);
+    return;
+  }
+  if (options.dryRun) {
+    if (!options.json) {
+      logger.info(`[dry-run] Would generate ${processed.length} theme packages in ${outputDir}`);
+      for (const { slug: slug2 } of processed) {
+        logger.item(`  packages/visor_themes/lib/src/${slug2}/`);
+      }
+    } else {
+      console.log(
+        JSON.stringify({
+          success: true,
+          dryRun: true,
+          themes: processed.map((p) => p.slug),
+          outputDir
+        })
+      );
+    }
+    return;
+  }
+  const slugs = processed.map((p) => p.slug);
+  const libSrcDir = join15(outputDir, "lib", "src");
+  if (existsSync12(libSrcDir)) {
+    rmSync(libSrcDir, { recursive: true, force: true });
+  }
+  const packageFiles = {
+    "pubspec.yaml": emitVisorThemesPubspec(),
+    "pubspec_overrides.yaml": emitVisorThemesPubspecOverrides(),
+    "analysis_options.yaml": emitAnalysisOptions(),
+    ".gitignore": emitGitignore(),
+    "lib/visor_themes.dart": emitMetaBarrel(slugs)
+  };
+  let totalFiles = 0;
+  for (const [relPath, content] of Object.entries(packageFiles)) {
+    const absPath = join15(outputDir, relPath);
+    mkdirSync6(dirname6(absPath), { recursive: true });
+    writeFileSync10(absPath, content, "utf-8");
+    totalFiles++;
+  }
+  for (const { slug: slug2, tokenFiles } of processed) {
+    const themeBaseDir = join15(outputDir, "lib", "src", slug2);
+    for (const [relPath, content] of Object.entries(tokenFiles)) {
+      const absPath = join15(themeBaseDir, relPath);
+      mkdirSync6(dirname6(absPath), { recursive: true });
+      writeFileSync10(absPath, content, "utf-8");
+      totalFiles++;
+    }
+  }
+  if (options.json) {
+    console.log(
+      JSON.stringify({
+        success: true,
+        outputDir,
+        themes: slugs,
+        totalFiles
+      })
+    );
+  } else {
+    logger.success(`Flutter theme package generated: ${outputDir}`);
+    logger.item(`Themes: ${slugs.join(", ")}`);
+    logger.item(`Total files written: ${totalFiles}`);
+  }
+}
 // src/commands/fonts-add.ts
-import { existsSync as existsSync10, statSync as statSync3, readdirSync as readdirSync4, readFileSync as readFileSync13 } from "fs";
-import { resolve as resolve8, basename as basename3, extname as extname3 } from "path";
+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 { S3Client, PutObjectCommand } from "@aws-sdk/client-s3";
 function deriveFamilySlug(filename) {
-  const name = basename3(filename, extname3(filename));
+  const name = basename4(filename, extname3(filename));
   const WEIGHT_STYLE_SUFFIXES = /* @__PURE__ */ new Set([
     "thin",
     "hairline",
@@ -3070,26 +3777,26 @@ function deriveFamilySlug(filename) {
 }
 function collectWoff2Files(inputPath) {
   const resolved = resolve8(inputPath);
-  if (!existsSync10(resolved)) {
+  if (!existsSync13(resolved)) {
     throw new Error(`Path not found: ${resolved}`);
   }
-  const stat = statSync3(resolved);
+  const stat = statSync4(resolved);
   if (stat.isFile()) {
     if (extname3(resolved).toLowerCase() !== ".woff2") {
       throw new Error(
-        `Invalid file format: ${basename3(resolved)}. Only .woff2 files are accepted.`
+        `Invalid file format: ${basename4(resolved)}. Only .woff2 files are accepted.`
       );
     }
     return [resolved];
   }
   if (stat.isDirectory()) {
-    const files = readdirSync4(resolved).filter((f) => extname3(f).toLowerCase() === ".woff2").map((f) => resolve8(resolved, f));
+    const files = readdirSync6(resolved).filter((f) => extname3(f).toLowerCase() === ".woff2").map((f) => resolve8(resolved, f));
     if (files.length === 0) {
       throw new Error(
         `No .woff2 files found in directory: ${resolved}`
       );
     }
-    const nonWoff2Fonts = readdirSync4(resolved).filter((f) => {
+    const nonWoff2Fonts = readdirSync6(resolved).filter((f) => {
       const ext = extname3(f).toLowerCase();
       return [".ttf", ".otf", ".woff", ".eot"].includes(ext);
     });
@@ -3099,10 +3806,10 @@ function collectWoff2Files(inputPath) {
 }
 function getNonWoff2Fonts(inputPath) {
   const resolved = resolve8(inputPath);
-  if (!existsSync10(resolved) || !statSync3(resolved).isDirectory()) {
+  if (!existsSync13(resolved) || !statSync4(resolved).isDirectory()) {
     return [];
   }
-  return readdirSync4(resolved).filter((f) => {
+  return readdirSync6(resolved).filter((f) => {
     const ext = extname3(f).toLowerCase();
     return [".ttf", ".otf", ".woff", ".eot"].includes(ext);
   });
@@ -3136,7 +3843,7 @@ function createR2Client(config) {
   });
 }
 async function uploadFile(client, bucket, key, filePath) {
-  const body = readFileSync13(filePath);
+  const body = readFileSync16(filePath);
   await client.send(
     new PutObjectCommand({
       Bucket: bucket,
@@ -3151,9 +3858,9 @@ async function fontsAddCommand(inputPath, options) {
   try {
     const r2Config = getR2Config();
     const files = collectWoff2Files(inputPath);
-    const familySlug = options.family ?? deriveFamilySlug(basename3(files[0]));
+    const familySlug = options.family ?? deriveFamilySlug(basename4(files[0]));
     const resolved = resolve8(inputPath);
-    const nonWoff2 = statSync3(resolved).isDirectory() ? getNonWoff2Fonts(resolved) : [];
+    const nonWoff2 = statSync4(resolved).isDirectory() ? getNonWoff2Fonts(resolved) : [];
     if (!json) {
       logger.heading("Visor Font Upload");
       logger.info(`Organization: ${org}`);
@@ -3171,13 +3878,13 @@ async function fontsAddCommand(inputPath, options) {
     const bucket = "visor-fonts";
     const results = [];
     for (const filePath of files) {
-      const filename = basename3(filePath);
+      const filename = basename4(filePath);
       const key = buildS3Key(org, familySlug, filename);
       if (!json) {
         logger.info(`Uploading ${filename}...`);
       }
       await uploadFile(client, bucket, key, filePath);
-      const size = statSync3(filePath).size;
+      const size = statSync4(filePath).size;
       results.push({ file: filename, key, size });
       if (!json) {
         logger.success(`Uploaded: ${key} (${formatBytes(size)})`);
@@ -3227,7 +3934,7 @@ function formatBytes(bytes) {
 // src/commands/doctor.ts
 import * as fs from "fs";
 import * as path from "path";
-import { execFileSync as execFileSync2 } from "child_process";
+import { execFileSync as execFileSync3 } from "child_process";
 async function doctorCommand(cwd, options, cliVersion) {
   const checks = [];
   const visorJsonPath = path.join(cwd, "visor.json");
@@ -3362,9 +4069,9 @@ async function doctorCommand(cwd, options, cliVersion) {
   }
   if (process.platform !== "win32") {
     try {
-      const globalPath = execFileSync2("which", ["visor"], { encoding: "utf-8" }).trim();
+      const globalPath = execFileSync3("which", ["visor"], { encoding: "utf-8" }).trim();
       if (globalPath) {
-        const globalVersionRaw = execFileSync2(globalPath, ["--version"], { encoding: "utf-8" }).trim();
+        const globalVersionRaw = execFileSync3(globalPath, ["--version"], { encoding: "utf-8" }).trim();
         const globalVersion = globalVersionRaw.split(/\s+/).pop() ?? "";
         if (isOlder(globalVersion, cliVersion)) {
           checks.push({
@@ -3440,27 +4147,27 @@ function findCssFiles(dir, maxDepth = 3) {
 }
 // src/utils/patterns.ts
-import { existsSync as existsSync12, readdirSync as readdirSync6, readFileSync as readFileSync15 } from "fs";
-import { join as join13 } from "path";
+import { existsSync as existsSync15, 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 = join13(repoRoot, "patterns");
-  if (!existsSync12(patternsDir)) return [];
-  const files = readdirSync6(patternsDir).filter(
+  const patternsDir = join17(repoRoot, "patterns");
+  if (!existsSync15(patternsDir)) return [];
+  const files = readdirSync8(patternsDir).filter(
     (f) => f.endsWith(".visor-pattern.yaml")
   );
   return files.map((file) => {
-    const content = readFileSync15(join13(patternsDir, file), "utf-8");
+    const content = readFileSync18(join17(patternsDir, file), "utf-8");
     return parseYAML(content);
   }).filter(Boolean);
 }
 function findRepoRoot2(startDir) {
   let current = startDir;
   while (true) {
-    if (existsSync12(join13(current, "patterns"))) {
+    if (existsSync15(join17(current, "patterns"))) {
       return current;
     }
-    const parent = join13(current, "..");
+    const parent = join17(current, "..");
     if (parent === current) return null;
     current = parent;
   }
@@ -3842,14 +4549,15 @@ Visor Tokens (${categoryLabel}) \u2014 ${tokens2.length} tokens
 var program = new Command2();
 program.name("visor").description("CLI for the Visor design system").version("0.3.0");
 program.addCommand(checkCommand());
-program.command("init").description("Initialize Visor in the current project").option("--template <name>", "scaffold a themed project (nextjs)").option("--json", "output structured JSON (for AI agents)").action((options) => {
+program.command("init").description("Initialize Visor \u2014 with --template nextjs, scaffolds a complete runnable Borealis-native Next.js app in one command").option("--template <name>", "scaffold a complete runnable app (templates: nextjs)").option("--json", "output structured JSON (for AI agents)").action((options) => {
   initCommand(process.cwd(), options);
 });
 program.command("list").description("List all available registry items").option("--json", "output structured JSON (for AI agents)").option("--category <name>", "filter items by category").action((options) => {
   listCommand(process.cwd(), options);
 });
-program.command("add").description("Add components, hooks, blocks, or utilities to your project").argument("[items...]", "names of registry items to add").option("--overwrite", "overwrite existing files", false).option("--category <name>", "install all items from a category").option("--block", "install blocks instead of components").option("--dry-run", "preview what would be added without writing files").option("--json", "output structured JSON (for AI agents)").action((items, options) => {
-  addCommand(items, process.cwd(), { overwrite: options.overwrite, category: options.category, block: options.block, dryRun: options.dryRun, json: options.json });
+program.command("add").description("Add components, hooks, blocks, or utilities to your project").argument("[items...]", "names of registry items to add").option("--overwrite", "overwrite existing files", false).option("--category <name>", "install all items from a category").option("--block", "install blocks instead of components").option("--target <platform>", "target platform: react (default) or flutter", "react").option("--dry-run", "preview what would be added without writing files").option("--json", "output structured JSON (for AI agents)").action((items, options) => {
+  const target = options.target === "flutter" ? "flutter" : "react";
+  addCommand(items, process.cwd(), { overwrite: options.overwrite, category: options.category, block: options.block, target, dryRun: options.dryRun, json: options.json });
 });
 program.command("diff").description(
   "Show differences between local files and the registry"
@@ -3864,8 +4572,29 @@ program.command("doctor").description("Run diagnostics on a Visor installation")
 });
 var theme = program.command("theme").description("Theme management commands");
 theme.command("apply").description(
-  "Read a .visor.yaml file and generate full CSS token overrides"
-).argument("<file>", "path to .visor.yaml file").option("-o, --output <path>", "output CSS file path").option("--json", "output structured JSON (for AI agents)").option("--adapter <name>", "target adapter: nextjs, fumadocs, deck").action(
+  "Read a .visor.yaml file and generate token overrides (CSS or Flutter)"
+).argument("<file>", "path to .visor.yaml file").option(
+  "-o, --output <path>",
+  "output CSS file path (or directory for --adapter flutter)"
+).option("--json", "output structured JSON (for AI agents)").option(
+  "--adapter <name>",
+  "target adapter: nextjs, fumadocs, deck, docs, flutter"
+).option(
+  "--package-name <name>",
+  "(flutter) Dart package name for generated pubspec.yaml (default: ui)"
+).option(
+  "--tokens-only",
+  "(flutter) emit only token files \u2014 skip pubspec.yaml and theme scaffolding"
+).option(
+  "--light-only",
+  "(flutter) emit only the light-brightness theme getter"
+).option(
+  "--dark-only",
+  "(flutter) emit only the dark-brightness theme getter"
+).option(
+  "--theme-class-name <name>",
+  "(flutter) class name for generated theme (default: VisorAppTheme)"
+).action(
   (file, options) => {
     themeApplyCommand(file, process.cwd(), {
       ...options,
@@ -3909,8 +4638,8 @@ theme.command("register").description(
 theme.command("unregister").description(
   "Remove a theme from the docs site \u2014 deletes CSS file, removes globals.css import and theme-config.ts entry"
 ).argument("<slug>", "theme slug to unregister (e.g. entr, kaiah)").option("--json", "output structured JSON (for AI agents)").action(
-  (slug, options) => {
-    themeUnregisterCommand(slug, process.cwd(), options);
+  (slug2, options) => {
+    themeUnregisterCommand(slug2, process.cwd(), options);
   }
 );
 theme.command("sync").description(
@@ -3920,6 +4649,13 @@ theme.command("sync").description(
     themeSyncCommand(process.cwd(), options);
   }
 );
+theme.command("batch-apply-flutter").description(
+  "Batch-generate Dart ThemeData for all .visor.yaml themes (themes/ + custom-themes/) into packages/visor_themes/"
+).option("--dry-run", "show what would be generated without writing files").option("--json", "output structured JSON (for AI agents)").action(
+  (options) => {
+    themeBatchApplyFlutterCommand(process.cwd(), options);
+  }
+);
 var fonts = program.command("fonts").description("Font library management commands");
 fonts.command("add").description("Upload woff2 font files to the Visor Font Library on R2").argument("<path>", "path to a .woff2 file or directory containing .woff2 files").requiredOption("--org <org>", "organization namespace (e.g. low-orbit)").option("--family <name>", "font family slug (auto-inferred from filename if omitted)").option("--json", "output structured JSON (for AI agents)").action(
   (path2, options) => {