@organcli/composed-cli 0.1.2 → 0.1.3

package/dist/index.js

@@ -1,1241 +1,1356 @@
-#!/usr/bin/env node
-
-// src/index.ts
-import { Command } from "commander";
-
-// src/commands/add.ts
-import pc from "picocolors";
-
-// src/lib/install-files.ts
-import { existsSync as existsSync4, mkdirSync as mkdirSync2, writeFileSync as writeFileSync2 } from "fs";
-import { dirname as dirname2, join as join4, relative } from "path";
-
-// src/lib/controllers.ts
-var CONTROLLERS_PREFIX = "src/components/common/controllers/";
-function toKebabCase(name) {
-  return name.replace(/([a-z0-9])([A-Z])/g, "$1-$2").replace(/([A-Z])([A-Z][a-z])/g, "$1-$2").toLowerCase();
-}
-function findControllerPath(source, exportName) {
-  const guessed = `${CONTROLLERS_PREFIX}${toKebabCase(exportName)}.tsx`;
-  if (source.hasFile(guessed) && source.readFile(guessed).includes(`export function ${exportName}`)) {
-    return guessed;
-  }
-  for (const path of source.listFiles(CONTROLLERS_PREFIX)) {
-    if (!path.endsWith(".tsx")) continue;
-    if (path.endsWith("/index.tsx") || path.endsWith("/index.ts")) continue;
-    if (source.readFile(path).includes(`export function ${exportName}`)) {
-      return path;
-    }
-  }
-  return void 0;
-}
-function controllerBarrelExport(exportName, relPath) {
-  const fileName = relPath.split("/").pop().replace(/\.tsx?$/, "");
-  return `export { ${exportName} } from './${fileName}';`;
-}
-
-// src/lib/i18n.ts
-import { existsSync as existsSync2, mkdirSync, readFileSync as readFileSync2, writeFileSync } from "fs";
-import { join as join2 } from "path";
-
-// src/lib/source.ts
-import { existsSync, readFileSync, readdirSync } from "fs";
-import { dirname, join } from "path";
-import { fileURLToPath, pathToFileURL } from "url";
-var here = dirname(fileURLToPath(import.meta.url));
-function findAncestorContaining(startDir, markerRelPath, maxLevels = 6) {
-  let dir = startDir;
-  for (let i = 0; i <= maxLevels; i++) {
-    if (existsSync(join(dir, markerRelPath))) return dir;
-    const parent = dirname(dir);
-    if (parent === dir) return void 0;
-    dir = parent;
-  }
-  return void 0;
-}
-function loadFromBundle() {
-  const distDir = findAncestorContaining(here, "registry-bundle.json");
-  if (!distDir) return void 0;
-  const bundle = JSON.parse(
-    readFileSync(join(distDir, "registry-bundle.json"), "utf-8")
-  );
-  return {
-    registry: bundle.registry,
-    featureRegistry: bundle.featureRegistry ?? [],
-    readFile: (path) => {
-      const content = bundle.files[path];
-      if (content === void 0) {
-        throw new Error(`registry-bundle.json is missing file: ${path}`);
-      }
-      return content;
-    },
-    hasFile: (path) => path in bundle.files,
-    listFiles: (prefix) => Object.keys(bundle.files).filter((p) => p === prefix || p.startsWith(prefix)),
-    readMessages: (locale) => bundle.messages[locale] ?? {}
-  };
-}
-async function loadFromBoilerplateTree() {
-  const boilerplateRoot = overrideRoot ?? findAncestorContaining(here, join("src", "registry", "components.ts"));
-  if (!boilerplateRoot) return void 0;
-  if (!existsSync(join(boilerplateRoot, "src", "registry", "components.ts"))) {
-    return void 0;
-  }
-  const registryPath = join(boilerplateRoot, "src", "registry", "components.ts");
-  const mod = await import(
-    /* @vite-ignore */
-    pathToFileURL(registryPath).href
-  );
-  const featuresPath = join(boilerplateRoot, "src", "registry", "features.ts");
-  let featureRegistry = [];
-  if (existsSync(featuresPath)) {
-    const featuresMod = await import(
-      /* @vite-ignore */
-      pathToFileURL(featuresPath).href
-    );
-    featureRegistry = featuresMod.featureRegistry;
-  }
-  return {
-    registry: mod.componentRegistry,
-    featureRegistry,
-    readFile: (path) => {
-      const abs = join(boilerplateRoot, path);
-      if (!existsSync(abs)) {
-        throw new Error(`Source file missing from boilerplate tree: ${path}`);
-      }
-      return readFileSync(abs, "utf-8");
-    },
-    hasFile: (path) => existsSync(join(boilerplateRoot, path)),
-    listFiles: (prefix) => listFilesFromTree(boilerplateRoot, prefix),
-    readMessages: (locale) => readMessagesFromTree(boilerplateRoot, locale)
-  };
-}
-function listFilesFromTree(boilerplateRoot, prefix) {
-  const abs = join(boilerplateRoot, prefix);
-  if (!existsSync(abs)) return [];
-  const out = [];
-  for (const entry of readdirSync(abs, { withFileTypes: true })) {
-    const rel = `${prefix.replace(/\\/g, "/").replace(/\/$/, "")}/${entry.name}`;
-    if (entry.isDirectory()) {
-      out.push(...listFilesFromTree(boilerplateRoot, rel));
-    } else {
-      out.push(rel);
-    }
-  }
-  return out;
-}
-function readMessagesFromTree(boilerplateRoot, locale) {
-  const dir = join(boilerplateRoot, "messages", locale);
-  const out = {};
-  if (!existsSync(dir)) return out;
-  for (const file of readdirSync(dir)) {
-    if (!file.endsWith(".json")) continue;
-    const json = JSON.parse(readFileSync(join(dir, file), "utf-8"));
-    for (const [key, value] of Object.entries(json)) {
-      if (key === "$schema") continue;
-      out[key] = String(value);
-    }
-  }
-  return out;
-}
-var cached;
-var overrideRoot;
-function setSourceRoot(root) {
-  cached = void 0;
-  overrideRoot = root;
-}
-function getSourceRoot() {
-  return overrideRoot;
-}
-function resolveSourceRoot() {
-  return overrideRoot ?? findAncestorContaining(here, join("src", "registry", "components.ts"));
-}
-async function getComponentSource() {
-  if (cached) return cached;
-  const source = overrideRoot ? await loadFromBoilerplateTree() : loadFromBundle() ?? await loadFromBoilerplateTree();
-  if (!source) {
-    throw new Error(
-      "Could not locate component source. Expected either a built dist/registry-bundle.json (published package) or a sibling src/registry/components.ts (running inside the boilerplate repo)."
-    );
-  }
-  cached = source;
-  return source;
-}
-
-// src/lib/i18n.ts
-var STRINGS_RUNTIME = `// Generated by composed-cli. Minimal string lookup for components copied
-// from the BIM boilerplate \u2014 replace with your own i18n solution as needed.
-import strings from './strings.json';
-
-export function t(key: keyof typeof strings, params?: Record<string, string | number>) {
-  let value = strings[key] ?? key;
-  if (params) {
-    for (const [name, val] of Object.entries(params)) {
-      value = value.replaceAll(\`{\${name}}\`, String(val));
-    }
-  }
-  return value;
-}
-`;
-async function installI18nStrings(cwd, keys, destDir = "src/lib/composed-strings") {
-  if (keys.length === 0) return { ok: true, addedKeys: [], path: "" };
-  const source = await getComponentSource();
-  const enMessages = source.readMessages("en");
-  const outDir = join2(cwd, destDir);
-  mkdirSync(outDir, { recursive: true });
-  const stringsPath = join2(outDir, "strings.json");
-  const existing = existsSync2(stringsPath) ? JSON.parse(readFileSync2(stringsPath, "utf-8")) : {};
-  const addedKeys = [];
-  for (const key of keys) {
-    if (!(key in enMessages)) continue;
-    if (!(key in existing)) addedKeys.push(key);
-    existing[key] = enMessages[key];
-  }
-  const sorted = Object.fromEntries(
-    Object.keys(existing).sort().map((key) => [key, existing[key]])
-  );
-  writeFileSync(stringsPath, JSON.stringify(sorted, null, 2) + "\n", "utf-8");
-  const runtimePath = join2(outDir, "index.ts");
-  if (!existsSync2(runtimePath)) {
-    writeFileSync(runtimePath, STRINGS_RUNTIME, "utf-8");
-  }
-  return { ok: true, addedKeys, path: join2(destDir, "index.ts") };
-}
-function rewriteParaglideUsage(source, importPath) {
-  let out = source.replace(
-    /import\s*\{\s*m\s*\}\s*from\s*['"]#\/paraglide\/messages['"];?\n?/,
-    `import { t } from '${importPath}';
-`
-  );
-  out = out.replace(/\bm\.([a-zA-Z0-9_]+)\(\s*\)/g, "t('$1')");
-  out = out.replace(/\bm\.([a-zA-Z0-9_]+)\(\s*(\{[^}]*\})\s*\)/g, "t('$1', $2)");
-  return out;
-}
-
-// src/lib/target-config.ts
-import { existsSync as existsSync3, readFileSync as readFileSync3 } from "fs";
-import { join as join3 } from "path";
-var defaultAliases = {
-  components: "@/components",
-  ui: "@/components/ui",
-  utils: "@/lib/utils",
-  lib: "@/lib"
-};
-function readTargetAliases(cwd) {
-  const configPath = join3(cwd, "components.json");
-  if (!existsSync3(configPath)) return defaultAliases;
-  try {
-    const config = JSON.parse(readFileSync3(configPath, "utf-8"));
-    return {
-      components: config.aliases?.components ?? defaultAliases.components,
-      ui: config.aliases?.ui ?? defaultAliases.ui,
-      utils: config.aliases?.utils ?? defaultAliases.utils,
-      lib: config.aliases?.lib ?? defaultAliases.lib
-    };
-  } catch {
-    return defaultAliases;
-  }
-}
-function aliasToPath(cwd, alias) {
-  const bareAlias = alias.replace(/^[@#]\//, "");
-  const base = existsSync3(join3(cwd, "src")) ? join3(cwd, "src") : cwd;
-  return join3(base, bareAlias);
-}
-
-// src/lib/install-files.ts
-async function copyComponentFiles(cwd, entry, opts) {
-  const source = await getComponentSource();
-  const aliases = readTargetAliases(cwd);
-  const uiDir = aliasToPath(cwd, aliases.ui);
-  const composedDir = join4(uiDir, "composed", entry.slug);
-  const results = [];
-  for (const file of entry.files) {
-    const fileName = file.path.split("/").pop();
-    const targetPath = join4(composedDir, fileName);
-    if (existsSync4(targetPath) && !opts.overwrite) {
-      results.push({
-        entryName: entry.name,
-        targetPath,
-        skipped: true,
-        reason: "already exists (use --overwrite to replace)"
-      });
-      continue;
-    }
-    let content = source.readFile(file.path);
-    if (entry.i18n.required) {
-      content = rewriteParaglideUsage(content, opts.stringsImportPath);
-    }
-    mkdirSync2(dirname2(targetPath), { recursive: true });
-    writeFileSync2(targetPath, content, "utf-8");
-    results.push({ entryName: entry.name, targetPath, skipped: false });
-  }
-  if (entry.controller) {
-    const controller = await copyController(cwd, entry, opts);
-    if (controller) results.push(controller);
-  }
-  return results;
-}
-async function copyController(cwd, entry, opts) {
-  if (!entry.controller) return void 0;
-  const source = await getComponentSource();
-  const controllerPath = findControllerPath(source, entry.controller);
-  if (!controllerPath) {
-    throw new Error(
-      `Could not find controller file for ${entry.name} (${entry.controller})`
-    );
-  }
-  const aliases = readTargetAliases(cwd);
-  const fileName = controllerPath.split("/").pop();
-  const targetPath = join4(
-    aliasToPath(cwd, aliases.components),
-    "common",
-    "controllers",
-    fileName
-  );
-  if (existsSync4(targetPath) && !opts.overwrite) {
-    return {
-      entryName: entry.controller,
-      targetPath,
-      skipped: true,
-      reason: "already exists (use --overwrite to replace)"
-    };
-  }
-  mkdirSync2(dirname2(targetPath), { recursive: true });
-  writeFileSync2(targetPath, source.readFile(controllerPath), "utf-8");
-  return { entryName: entry.controller, targetPath, skipped: false };
-}
-async function copyLocalUtil(cwd, localDep, opts) {
-  if (localDep !== "@/lib/utils") return void 0;
-  const source = await getComponentSource();
-  const aliases = readTargetAliases(cwd);
-  const utilsAbsPath = aliasToPath(cwd, aliases.utils) + ".ts";
-  if (existsSync4(utilsAbsPath) && !opts.overwrite) {
-    return {
-      entryName: "cn",
-      targetPath: utilsAbsPath,
-      skipped: true,
-      reason: "already exists"
-    };
-  }
-  const content = source.readFile("src/lib/utils.ts");
-  mkdirSync2(dirname2(utilsAbsPath), { recursive: true });
-  writeFileSync2(utilsAbsPath, content, "utf-8");
-  return { entryName: "cn", targetPath: utilsAbsPath, skipped: false };
-}
-function toDisplayPath(cwd, absPath) {
-  return relative(cwd, absPath).split("\\").join("/");
-}
-
-// src/lib/npm-install.ts
-import { spawnSync } from "child_process";
-
-// src/lib/package-manager.ts
-import { existsSync as existsSync5 } from "fs";
-import { join as join5 } from "path";
-var lockfiles = {
-  "bun.lock": "bun",
-  "bun.lockb": "bun",
-  "pnpm-lock.yaml": "pnpm",
-  "yarn.lock": "yarn",
-  "package-lock.json": "npm"
-};
-function detectPackageManager(cwd) {
-  for (const [lockfile, pm] of Object.entries(lockfiles)) {
-    if (existsSync5(join5(cwd, lockfile))) return pm;
-  }
-  const userAgent = process.env.npm_config_user_agent ?? "";
-  if (userAgent.startsWith("bun")) return "bun";
-  if (userAgent.startsWith("pnpm")) return "pnpm";
-  if (userAgent.startsWith("yarn")) return "yarn";
-  return "npm";
-}
-function installCommand(pm, packages) {
-  switch (pm) {
-    case "bun":
-      return ["bun", ["add", ...packages]];
-    case "pnpm":
-      return ["pnpm", ["add", ...packages]];
-    case "yarn":
-      return ["yarn", ["add", ...packages]];
-    case "npm":
-    default:
-      return ["npm", ["install", ...packages]];
-  }
-}
-function dlxCommand(pm, args) {
-  switch (pm) {
-    case "bun":
-      return ["bunx", args];
-    case "pnpm":
-      return ["pnpm", ["dlx", ...args]];
-    case "yarn":
-      return ["yarn", ["dlx", ...args]];
-    case "npm":
-    default:
-      return ["npx", args];
-  }
-}
-
-// src/lib/npm-install.ts
-function installNpmPackages(cwd, packages, pm) {
-  if (packages.length === 0) return { ok: true };
-  const [cmd, args] = installCommand(pm, packages);
-  const result = spawnSync(cmd, args, {
-    cwd,
-    stdio: "inherit",
-    shell: process.platform === "win32"
-  });
-  if (result.status !== 0) {
-    return { ok: false, message: `${cmd} exited with code ${result.status}` };
-  }
-  return { ok: true };
-}
-
-// src/lib/resolve.ts
-import { existsSync as existsSync6 } from "fs";
-import { dirname as dirname3, isAbsolute, relative as relative2, resolve } from "path";
-
-// src/lib/registry.ts
-async function loadRegistry() {
-  const source = await getComponentSource();
-  return source.registry;
-}
-async function findComponent(query) {
-  const registry = await loadRegistry();
-  const byName = registry.find((e) => e.name === query);
-  if (byName) return byName;
-  const bySlug = registry.filter((e) => e.slug === query);
-  if (bySlug.length === 1) return bySlug[0];
-  if (bySlug.length > 1) return bySlug;
-  return void 0;
-}
-
-// src/lib/resolve.ts
-async function resolveQueries(queries) {
-  const entries = [];
-  const notFound = [];
-  const ambiguous = {};
-  const seen = /* @__PURE__ */ new Set();
-  for (const query of queries) {
-    const fromPath = looksLikePath(query) ? await findComponentsByPath(query) : void 0;
-    if (fromPath) {
-      if (fromPath.length === 0) {
-        notFound.push(query);
-        continue;
-      }
-      for (const match2 of fromPath) {
-        if (!seen.has(match2.name)) {
-          seen.add(match2.name);
-          entries.push(match2);
-        }
-      }
-      continue;
-    }
-    const match = await findComponent(query);
-    if (!match) {
-      notFound.push(query);
-      continue;
-    }
-    if (Array.isArray(match)) {
-      ambiguous[query] = match.map((e) => e.name);
-      continue;
-    }
-    if (!seen.has(match.name)) {
-      seen.add(match.name);
-      entries.push(match);
-    }
-  }
-  return { entries, notFound, ambiguous };
-}
-function unionDependencies(entries) {
-  const shadcn = /* @__PURE__ */ new Set();
-  const npm = /* @__PURE__ */ new Set();
-  const local = /* @__PURE__ */ new Set();
-  const i18nKeys = /* @__PURE__ */ new Set();
-  for (const entry of entries) {
-    entry.dependencies.shadcn.forEach((s) => shadcn.add(s));
-    entry.dependencies.npm.forEach((n) => npm.add(n));
-    entry.dependencies.local.forEach((l) => local.add(l));
-    entry.i18n.keys.forEach((k) => i18nKeys.add(k));
-  }
-  return {
-    shadcn: [...shadcn],
-    npm: [...npm],
-    local: [...local],
-    i18nKeys: [...i18nKeys]
-  };
-}
-async function allComponentNames() {
-  return (await loadRegistry()).map((e) => `${e.name} (${e.slug})`);
-}
-function looksLikePath(query) {
-  return isAbsolute(query) || /[\\/]/.test(query);
-}
-function toPosix(query) {
-  return query.replace(/\\/g, "/").replace(/\/$/, "");
-}
-function registryPrefixes(query) {
-  const posix = toPosix(query);
-  if (!posix || isAbsolute(query)) return [];
-  const prefixes = [posix];
-  if (!posix.startsWith("src/")) prefixes.push(`src/${posix}`);
-  return prefixes;
-}
-function matchesPrefix(filePath, prefix) {
-  return filePath === prefix || filePath.startsWith(`${prefix}/`);
-}
-function findBoilerplateRoot(start) {
-  let dir = start;
-  for (let i = 0; i <= 8; i++) {
-    if (existsSync6(resolve(dir, "src", "registry", "components.ts"))) return dir;
-    const parent = dirname3(dir);
-    if (parent === dir) return void 0;
-    dir = parent;
-  }
-  return void 0;
-}
-function queryToRelPath(query) {
-  const base = getSourceRoot() ?? process.cwd();
-  const abs = isAbsolute(query) ? query : resolve(base, query);
-  if (!existsSync6(abs)) return void 0;
-  const root = getSourceRoot() ?? findBoilerplateRoot(abs) ?? findBoilerplateRoot(process.cwd());
-  if (!root) return void 0;
-  const rel = relative2(root, abs).split("\\").join("/");
-  if (!rel || rel.startsWith("..")) return void 0;
-  return rel.replace(/\/$/, "");
-}
-async function findComponentsByPath(query) {
-  const rel = queryToRelPath(query);
-  const prefixes = rel ? [rel] : registryPrefixes(query);
-  if (prefixes.length === 0) return void 0;
-  const registry = await loadRegistry();
-  return registry.filter(
-    (entry) => entry.files.some((file) => prefixes.some((prefix) => matchesPrefix(file.path, prefix)))
-  );
-}
-
-// src/lib/shadcn.ts
-import { existsSync as existsSync7 } from "fs";
-import { join as join6 } from "path";
-import { spawnSync as spawnSync2 } from "child_process";
-function hasShadcnConfig(cwd) {
-  return existsSync7(join6(cwd, "components.json"));
-}
-function installShadcnPrimitives(cwd, slugs, pm) {
-  if (slugs.length === 0) return [];
-  const [cmd, baseArgs] = dlxCommand(pm, ["shadcn@latest", "add", ...slugs, "-y"]);
-  const result = spawnSync2(cmd, baseArgs, {
-    cwd,
-    stdio: "inherit",
-    shell: process.platform === "win32"
-  });
-  const ok = result.status === 0;
-  return slugs.map((slug) => ({
-    slug,
-    ok,
-    message: ok ? void 0 : `shadcn add exited with code ${result.status}`
-  }));
-}
-
-// src/lib/validate-install.ts
-import { existsSync as existsSync8, readFileSync as readFileSync4 } from "fs";
-function validateCopiedFiles(files) {
-  const issues = [];
-  for (const file of files) {
-    if (!existsSync8(file.targetPath)) {
-      issues.push({ file: file.targetPath, message: "file was not written" });
-      continue;
-    }
-    const content = readFileSync4(file.targetPath, "utf-8");
-    if (/from\s*['"]#\/paraglide\/messages['"]/.test(content)) {
-      issues.push({
-        file: file.targetPath,
-        message: "still imports Paraglide messages (rewrite did not apply)"
-      });
-    }
-    if (/\bm\.[a-zA-Z0-9_]+\(/.test(content)) {
-      issues.push({
-        file: file.targetPath,
-        message: "still calls m.*() (rewrite missed a usage)"
-      });
-    }
-  }
-  return issues;
-}
-
-// src/commands/add.ts
-async function runAdd(queries, options) {
-  const { cwd } = options;
-  if (queries.length === 0) {
-    console.error(pc.red("Usage: composed-cli add <component> [components...]"));
-    console.error("");
-    console.error("Available components:");
-    for (const name of await allComponentNames()) console.error(`  ${name}`);
-    process.exitCode = 1;
-    return;
-  }
-  const { entries, notFound, ambiguous } = await resolveQueries(queries);
-  if (notFound.length > 0) {
-    console.error(pc.red(`Unknown component(s): ${notFound.join(", ")}`));
-  }
-  for (const [query, names] of Object.entries(ambiguous)) {
-    console.error(
-      pc.red(
-        `"${query}" matches multiple components: ${names.join(", ")}. Use one of those exact names.`
-      )
-    );
-  }
-  if (entries.length === 0) {
-    process.exitCode = 1;
-    return;
-  }
-  if (!hasShadcnConfig(cwd)) {
-    console.error(
-      pc.red(
-        "No components.json found in this project. Run `shadcn init` before `composed-cli add`."
-      )
-    );
-    process.exitCode = 1;
-    return;
-  }
-  console.log(pc.bold(`Installing: ${entries.map((e) => e.name).join(", ")}`));
-  const deps = unionDependencies(entries);
-  const pm = detectPackageManager(cwd);
-  if (deps.shadcn.length > 0 && !options.skipShadcn) {
-    console.log(pc.cyan(`
-> Installing shadcn primitives: ${deps.shadcn.join(", ")}`));
-    const results = installShadcnPrimitives(cwd, deps.shadcn, pm);
-    const failed = results.filter((r) => !r.ok);
-    if (failed.length > 0) {
-      console.error(
-        pc.red(`shadcn add failed for: ${failed.map((f) => f.slug).join(", ")}`)
-      );
-      process.exitCode = 1;
-      return;
-    }
-  } else if (deps.shadcn.length > 0) {
-    console.log(pc.dim(`
-> Skipped shadcn primitives (--skip-shadcn): ${deps.shadcn.join(", ")}`));
-  }
-  if (deps.npm.length > 0 && !options.skipNpm) {
-    console.log(pc.cyan(`
-> Installing npm packages: ${deps.npm.join(", ")}`));
-    const result = installNpmPackages(cwd, deps.npm, pm);
-    if (!result.ok) {
-      console.error(pc.red(`npm install failed: ${result.message}`));
-      process.exitCode = 1;
-      return;
-    }
-  } else if (deps.npm.length > 0) {
-    console.log(pc.dim(`
-> Skipped npm packages (--skip-npm): ${deps.npm.join(", ")}`));
-  }
-  const stringsImportPath = "@/lib/composed-strings";
-  let i18nAdded = [];
-  if (deps.i18nKeys.length > 0 && !options.skipI18n) {
-    const result = await installI18nStrings(cwd, deps.i18nKeys);
-    i18nAdded = result.addedKeys;
-  }
-  console.log(pc.cyan(`
-> Copying component files`));
-  const copiedFiles = [];
-  for (const entry of entries) {
-    const copied = await copyComponentFiles(cwd, entry, {
-      overwrite: options.overwrite,
-      stringsImportPath
-    });
-    copiedFiles.push(...copied);
-    for (const file of copied) {
-      if (file.skipped) {
-        console.log(pc.yellow(`  skip  ${toDisplayPath(cwd, file.targetPath)} (${file.reason})`));
-      } else {
-        console.log(pc.green(`  add   ${toDisplayPath(cwd, file.targetPath)}`));
-      }
-    }
-    if (entry.knownIssues?.length) {
-      for (const issue of entry.knownIssues) {
-        console.log(pc.yellow(`  !     ${entry.name}: ${issue}`));
-      }
-    }
-  }
-  for (const localDep of deps.local) {
-    const copied = await copyLocalUtil(cwd, localDep, { overwrite: options.overwrite });
-    if (copied) {
-      copiedFiles.push(copied);
-      const line = copied.skipped ? pc.yellow(`  skip  ${toDisplayPath(cwd, copied.targetPath)} (${copied.reason})`) : pc.green(`  add   ${toDisplayPath(cwd, copied.targetPath)}`);
-      console.log(line);
-    }
-  }
-  if (i18nAdded.length > 0) {
-    console.log(pc.green(`  add   src/lib/composed-strings/ (${i18nAdded.length} key(s))`));
-  }
-  const issues = validateCopiedFiles(copiedFiles);
-  if (issues.length > 0) {
-    console.log(pc.red(`
-> Validation found ${issues.length} issue(s):`));
-    for (const issue of issues) {
-      console.log(pc.red(`  ${toDisplayPath(cwd, issue.file)}: ${issue.message}`));
-    }
-    process.exitCode = 1;
-    return;
-  }
-  console.log(pc.bold(pc.green(`
-Done. Installed ${entries.length} component(s).`)));
-}
-
-// src/commands/create.ts
-import { existsSync as existsSync12 } from "fs";
-import pc2 from "picocolors";
-
-// src/lib/framework-detect.ts
-import { existsSync as existsSync9, readFileSync as readFileSync5 } from "fs";
-import { join as join7 } from "path";
-function readPackageJson(cwd) {
-  const pkgPath = join7(cwd, "package.json");
-  if (!existsSync9(pkgPath)) return void 0;
-  try {
-    return JSON.parse(readFileSync5(pkgPath, "utf-8"));
-  } catch {
-    return void 0;
-  }
-}
-function allDeps(pkg) {
-  return { ...pkg.dependencies, ...pkg.devDependencies };
-}
-function detectTargetFramework(cwd) {
-  const pkg = readPackageJson(cwd);
-  if (pkg) {
-    const deps = allDeps(pkg);
-    if ("@tanstack/react-start" in deps || "@tanstack/start" in deps) {
-      return {
-        framework: "tanstack",
-        reason: "package.json depends on @tanstack/react-start"
-      };
-    }
-    if ("next" in deps) {
-      return { framework: "nextjs", reason: "package.json depends on next" };
-    }
-  }
-  if (existsSync9(join7(cwd, "next.config.js")) || existsSync9(join7(cwd, "next.config.ts")) || existsSync9(join7(cwd, "next.config.mjs"))) {
-    return { framework: "nextjs", reason: "found a next.config.* file" };
-  }
-  if (existsSync9(join7(cwd, "app")) && (existsSync9(join7(cwd, "app", "layout.tsx")) || existsSync9(join7(cwd, "app", "layout.js")))) {
-    return { framework: "nextjs", reason: "found app/layout.tsx (Next.js App Router)" };
-  }
-  if (existsSync9(join7(cwd, "src", "app")) && (existsSync9(join7(cwd, "src", "app", "layout.tsx")) || existsSync9(join7(cwd, "src", "app", "layout.js")))) {
-    return { framework: "nextjs", reason: "found src/app/layout.tsx (Next.js App Router)" };
-  }
-  if (existsSync9(join7(cwd, "src", "routeTree.gen.ts"))) {
-    return {
-      framework: "tanstack",
-      reason: "found src/routeTree.gen.ts (TanStack Router)"
-    };
-  }
-  if (existsSync9(join7(cwd, "src", "routes")) && existsSync9(join7(cwd, "src", "router.tsx"))) {
-    return {
-      framework: "tanstack",
-      reason: "found src/routes and src/router.tsx (TanStack Start layout)"
-    };
-  }
-  return void 0;
-}
-
-// src/lib/feature-registry.ts
-async function loadFeatureRegistry() {
-  const source = await getComponentSource();
-  return source.featureRegistry;
-}
-async function findFeature(name) {
-  const registry = await loadFeatureRegistry();
-  return registry.find((e) => e.name === name);
-}
-async function listFeatureNames() {
-  return (await loadFeatureRegistry()).map((e) => e.name);
-}
-function frameworkLabel(framework) {
-  return framework === "tanstack" ? "TanStack Start" : "Next.js";
-}
-function supportedFrameworksFor(entry) {
-  return Object.keys(entry.frameworks);
-}
-
-// src/lib/install-feature.ts
-import { existsSync as existsSync10, mkdirSync as mkdirSync3, readFileSync as readFileSync6, writeFileSync as writeFileSync3 } from "fs";
-import { dirname as dirname4, join as join8 } from "path";
-function nextAppDir(cwd) {
-  if (existsSync10(join8(cwd, "src", "app"))) return "src/app";
-  if (existsSync10(join8(cwd, "app"))) return "app";
-  if (existsSync10(join8(cwd, "src"))) return "src/app";
-  return "app";
-}
-function toFeatureTargetPath(cwd, sourceRelPath, impl, framework) {
-  let rel = sourceRelPath.replace(/\\/g, "/");
-  const prefix = impl.sourcePrefix?.replace(/\\/g, "/");
-  if (prefix && rel.startsWith(prefix)) rel = rel.slice(prefix.length);
-  if (framework === "nextjs" && (rel === "src/app" || rel.startsWith("src/app/"))) {
-    const appDir = nextAppDir(cwd);
-    if (appDir === "app") rel = rel.replace(/^src\/app/, "app");
-  }
-  return rel;
-}
-function adaptContent(content, framework) {
-  if (framework !== "nextjs") return content;
-  return rewriteParaglideUsage(content, "@/lib/composed-strings").replaceAll("#/", "@/");
-}
-function sourceContent(source, relPath, framework) {
-  return adaptContent(source.readFile(relPath), framework);
-}
-function fileMatchesSource(cwd, sourceRelPath, targetRelPath, source, framework) {
-  const targetPath = join8(cwd, targetRelPath);
-  if (!existsSync10(targetPath)) return false;
-  return readFileSync6(targetPath, "utf-8") === sourceContent(source, sourceRelPath, framework);
-}
-async function installFeatureFiles(cwd, impl, opts) {
-  const source = await getComponentSource();
-  const results = [];
-  for (const relPath of impl.files) {
-    const targetRel = toFeatureTargetPath(cwd, relPath, impl, opts.framework);
-    const targetPath = join8(cwd, targetRel);
-    if (existsSync10(targetPath) && !opts.overwrite) {
-      if (fileMatchesSource(cwd, relPath, targetRel, source, opts.framework)) {
-        results.push({
-          path: targetRel,
-          status: "skipped",
-          reason: "already installed (identical)"
-        });
-      } else {
-        results.push({
-          path: targetRel,
-          status: "skipped",
-          reason: "already exists (use --overwrite to replace)"
-        });
-      }
-      continue;
-    }
-    const content = sourceContent(source, relPath, opts.framework);
-    mkdirSync3(dirname4(targetPath), { recursive: true });
-    writeFileSync3(targetPath, content, "utf-8");
-    results.push({ path: targetRel, status: "added" });
-  }
-  return results;
-}
-async function findFeatureFileConflicts(cwd, impl, framework) {
-  const source = await getComponentSource();
-  const conflicts = [];
-  for (const relPath of impl.files) {
-    const targetRel = toFeatureTargetPath(cwd, relPath, impl, framework);
-    if (existsSync10(join8(cwd, targetRel)) && !fileMatchesSource(cwd, relPath, targetRel, source, framework)) {
-      conflicts.push(targetRel);
-    }
-  }
-  return conflicts;
-}
-
-// src/lib/move-files.ts
-import { existsSync as existsSync11, mkdirSync as mkdirSync4, readFileSync as readFileSync7, readdirSync as readdirSync2, writeFileSync as writeFileSync4 } from "fs";
-import { dirname as dirname5, join as join9 } from "path";
-async function copyEntryToRepo(destRoot, entry, opts) {
-  const source = await getComponentSource();
-  const results = [];
-  for (const file of entry.files) {
-    results.push(writeRelPath(destRoot, file.path, source.readFile(file.path), entry.name, opts));
-  }
-  if (entry.controller) {
-    const controllerPath = findControllerPath(source, entry.controller);
-    if (!controllerPath) {
-      throw new Error(
-        `Could not find controller file for ${entry.name} (${entry.controller})`
-      );
-    }
-    results.push(
-      writeRelPath(
-        destRoot,
-        controllerPath,
-        source.readFile(controllerPath),
-        entry.controller,
-        opts
-      )
-    );
-    upsertControllerBarrel(destRoot, entry.controller, controllerPath, results);
-  }
-  return results;
-}
-async function mergeI18nIntoRepo(destRoot, keys) {
-  if (keys.length === 0) return { added: [] };
-  const messagesRoot = join9(destRoot, "messages");
-  const source = await getComponentSource();
-  const added = [];
-  for (const locale of ["en", "ar"]) {
-    const localeDir = join9(messagesRoot, locale);
-    const messages = source.readMessages(locale);
-    const namespaces = existsSync11(localeDir) ? readdirSync2(localeDir).filter((file) => file.endsWith(".json")).map((file) => file.replace(/\.json$/, "")) : [];
-    const grouped = {};
-    for (const key of keys) {
-      if (!(key in messages)) continue;
-      const ns = namespaceForKey(key, namespaces);
-      grouped[ns] ??= {};
-      grouped[ns][key] = messages[key];
-    }
-    for (const [ns, kvs] of Object.entries(grouped)) {
-      const filePath = join9(localeDir, `${ns}.json`);
-      const existing = existsSync11(filePath) ? JSON.parse(readFileSync7(filePath, "utf-8")) : { $schema: "https://inlang.com/schema/inlang-message-format" };
-      for (const [key, value] of Object.entries(kvs)) {
-        if (!(key in existing)) added.push(`${locale}/${ns}.json#${key}`);
-        existing[key] = value;
-      }
-      const schema = existing.$schema;
-      delete existing.$schema;
-      const sorted = Object.fromEntries(
-        Object.keys(existing).sort().map((key) => [key, existing[key]])
-      );
-      const out = schema ? { $schema: schema, ...sorted } : sorted;
-      mkdirSync4(dirname5(filePath), { recursive: true });
-      writeFileSync4(filePath, JSON.stringify(out, null, 2) + "\n", "utf-8");
-    }
-  }
-  return { added };
-}
-function writeRelPath(destRoot, relPath, content, entryName, opts) {
-  const targetPath = join9(destRoot, relPath);
-  if (existsSync11(targetPath) && !opts.overwrite) {
-    return {
-      entryName,
-      targetPath,
-      skipped: true,
-      reason: "already exists (use --overwrite to replace)"
-    };
-  }
-  mkdirSync4(dirname5(targetPath), { recursive: true });
-  writeFileSync4(targetPath, content, "utf-8");
-  return { entryName, targetPath, skipped: false };
-}
-function upsertControllerBarrel(destRoot, exportName, controllerPath, results) {
-  const barrelRel = "src/components/common/controllers/index.ts";
-  const barrelAbs = join9(destRoot, barrelRel);
-  const line = controllerBarrelExport(exportName, controllerPath);
-  const existing = existsSync11(barrelAbs) ? readFileSync7(barrelAbs, "utf-8") : "";
-  if (existing.includes(`export { ${exportName} }`)) return;
-  const next = existing.trimEnd() ? `${existing.replace(/\s*$/, "\n")}${line}
-` : `${line}
-`;
-  mkdirSync4(dirname5(barrelAbs), { recursive: true });
-  writeFileSync4(barrelAbs, next, "utf-8");
-  results.push({ entryName: exportName, targetPath: barrelAbs, skipped: false });
-}
-function namespaceForKey(key, namespaces) {
-  const existing = namespaces.filter((ns) => key === ns || key.startsWith(`${ns}_`)).sort((a, b) => b.length - a.length)[0];
-  if (existing) return existing;
-  const underscoreIndex = key.indexOf("_");
-  return underscoreIndex === -1 ? key : key.slice(0, underscoreIndex);
-}
-
-// src/commands/create.ts
-async function runCreateFeature(featureName, options) {
-  const { cwd } = options;
-  if (!featureName) {
-    console.error(pc2.red("Usage: composed-cli create feature <name> [--protected|--public]"));
-    process.exitCode = 1;
-    return;
-  }
-  if (options.protected && options.public) {
-    console.error(pc2.red("Pass either --protected or --public, not both."));
-    process.exitCode = 1;
-    return;
-  }
-  if (!existsSync12(cwd)) {
-    console.error(pc2.red(`Target directory does not exist: ${cwd}`));
-    process.exitCode = 1;
-    return;
-  }
-  const feature = await findFeature(featureName);
-  if (!feature) {
-    const available = await listFeatureNames();
-    console.error(pc2.red(`Feature "${featureName}" is not available in the boilerplate.`));
-    console.error("");
-    console.error(pc2.bold("Available features:"));
-    for (const name of available) console.error(pc2.dim(`  - ${name}`));
-    process.exitCode = 1;
-    return;
-  }
-  const detected = detectTargetFramework(cwd);
-  if (!detected) {
-    console.error(
-      pc2.red(
-        `Could not detect the target project's framework at ${cwd}. Expected to find a package.json with a recognizable framework dependency (e.g. "next" or "@tanstack/react-start"), or matching project structure.`
-      )
-    );
-    process.exitCode = 1;
-    return;
-  }
-  const impl = feature.frameworks[detected.framework];
-  if (!impl) {
-    const supported = supportedFrameworksFor(feature);
-    console.error(
-      pc2.red(
-        `Feature "${feature.name}" exists, but ${frameworkLabel(detected.framework)} is not currently supported for this feature.`
-      )
-    );
-    console.error("");
-    console.error(pc2.bold("Supported frameworks:"));
-    for (const fw of supported) console.error(pc2.dim(`  - ${frameworkLabel(fw)}`));
-    process.exitCode = 1;
-    return;
-  }
-  const requestedScope = options.protected ? "protected" : options.public ? "public" : void 0;
-  if (requestedScope && impl.routeScope && requestedScope !== impl.routeScope) {
-    console.error(
-      pc2.red(
-        `--${requestedScope} does not apply to "${feature.name}" for ${frameworkLabel(detected.framework)}: this implementation's route is fixed at "${impl.routeScope}".`
-      )
-    );
-    process.exitCode = 1;
-    return;
-  }
-  if (requestedScope && !impl.routeScope) {
-    console.error(
-      pc2.red(
-        `--${requestedScope} does not apply to "${feature.name}" for ${frameworkLabel(detected.framework)}: this implementation has no protected/public route distinction.`
-      )
-    );
-    process.exitCode = 1;
-    return;
-  }
-  console.log(pc2.dim(`Detected framework: ${frameworkLabel(detected.framework)} (${detected.reason})`));
-  const conflicts = await findFeatureFileConflicts(cwd, impl, detected.framework);
-  if (conflicts.length > 0 && !options.overwrite) {
-    console.error(
-      pc2.red(`Feature "${feature.name}" already exists \u2014 the following file(s) already have different content:`)
-    );
-    for (const conflict of conflicts) {
-      console.error(pc2.red(`  ${conflict}`));
-    }
-    console.error("");
-    console.error(pc2.dim("Pass --overwrite to replace them."));
-    process.exitCode = 1;
-    return;
-  }
-  if (conflicts.length > 0) {
-    console.log(pc2.yellow(`Overwriting ${conflicts.length} existing file(s).`));
-  }
-  console.log(pc2.bold(`\u2714 Feature: ${feature.name}`));
-  console.log(pc2.bold(`\u2714 Framework implementation: ${frameworkLabel(detected.framework)}`));
-  const copied = await installFeatureFiles(cwd, impl, {
-    overwrite: options.overwrite,
-    framework: detected.framework
-  });
-  for (const file of copied) {
-    if (file.status === "skipped") {
-      console.log(pc2.yellow(`  skip  ${file.path} (${file.reason})`));
-    } else {
-      console.log(pc2.green(`  add   ${toDisplayPath(cwd, `${cwd}/${file.path}`)}`));
-    }
-  }
-  if (detected.framework === "nextjs") {
-    const i18n = await installI18nStrings(cwd, impl.i18nKeys);
-    if (i18n.addedKeys.length > 0) {
-      console.log(pc2.green(`  add   ${i18n.path} (${i18n.addedKeys.length} key(s))`));
-    }
-  } else {
-    const i18n = await mergeI18nIntoRepo(cwd, impl.i18nKeys);
-    if (i18n.added.length > 0) {
-      console.log(pc2.green(`  add   messages/ (${i18n.added.length} key(s))`));
-    }
-  }
-  console.log("");
-  console.log(pc2.bold(pc2.green(`Done. Installed feature "${feature.name}" (${frameworkLabel(detected.framework)}) into ${cwd}.`)));
-  if (detected.framework === "tanstack") {
-    console.log(
-      pc2.dim(
-        "Restart `bun run dev` (or run a build) so paraglideVitePlugin regenerates src/paraglide/ with any new message keys."
-      )
-    );
-  }
-}
-
-// src/commands/move.ts
-import { existsSync as existsSync13, statSync } from "fs";
-import { resolve as resolve2 } from "path";
-import pc3 from "picocolors";
-async function runMove(queries, options) {
-  if (queries.length === 0) {
-    console.error(
-      pc3.red(
-        "Usage: composed-cli move <component-or-path> [--to <repo>]"
-      )
-    );
-    console.error("");
-    console.error("Pass a registry name (labeled-select) or a path like components/ui.");
-    console.error("Available components:");
-    for (const name of await allComponentNames()) console.error(`  ${name}`);
-    process.exitCode = 1;
-    return;
-  }
-  if (options.from) {
-    const fromRoot = resolve2(options.from);
-    if (!existsSync13(fromRoot) || !statSync(fromRoot).isDirectory()) {
-      console.error(pc3.red(`Source is not a directory: ${fromRoot}`));
-      process.exitCode = 1;
-      return;
-    }
-    setSourceRoot(fromRoot);
-  }
-  const destRoot = resolve2(options.to);
-  if (!existsSync13(destRoot) || !statSync(destRoot).isDirectory()) {
-    console.error(pc3.red(`Destination is not a directory: ${destRoot}`));
-    process.exitCode = 1;
-    return;
-  }
-  const sourceRoot = resolveSourceRoot();
-  if (sourceRoot && resolve2(sourceRoot) === destRoot) {
-    console.error(pc3.red("Source and destination are the same repository."));
-    console.error("Pass --to <other-repo>, for example:");
-    console.error(
-      pc3.cyan("  npx tsx cli/src/index.ts move src/components/ui --to M:\\my-next-app")
-    );
-    process.exitCode = 1;
-    return;
-  }
-  const { entries, notFound, ambiguous } = await resolveQueries(queries);
-  if (notFound.length > 0) {
-    console.error(pc3.red(`Unknown component(s): ${notFound.join(", ")}`));
-    console.error(
-      pc3.dim(
-        "Use a name like labeled-select, or a path like components/ui. No local boilerplate is required."
-      )
-    );
-  }
-  for (const [query, names] of Object.entries(ambiguous)) {
-    console.error(
-      pc3.red(
-        `"${query}" matches multiple components: ${names.join(", ")}. Use one of those exact names.`
-      )
-    );
-  }
-  if (entries.length === 0) {
-    process.exitCode = 1;
-    return;
-  }
-  if (!existsSync13(resolve2(destRoot, ".git"))) {
-    console.log(pc3.yellow(`Warning: ${destRoot} has no .git directory.`));
-  }
-  if (hasShadcnConfig(destRoot)) {
-    await runAdd(
-      entries.map((e) => e.name),
-      {
-        cwd: destRoot,
-        overwrite: options.overwrite,
-        skipShadcn: false,
-        skipNpm: false,
-        skipI18n: false
-      }
-    );
-    return;
-  }
-  console.log(
-    pc3.bold(`Moving into ${destRoot}: ${entries.map((e) => e.name).join(", ")}`)
-  );
-  for (const entry of entries) {
-    const copied = await copyEntryToRepo(destRoot, entry, {
-      overwrite: options.overwrite
-    });
-    for (const file of copied) {
-      if (file.skipped) {
-        console.log(pc3.yellow(`  skip  ${toDisplayPath(destRoot, file.targetPath)} (${file.reason})`));
-      } else {
-        console.log(pc3.green(`  add   ${toDisplayPath(destRoot, file.targetPath)}`));
-      }
-    }
-  }
-  const deps = unionDependencies(entries);
-  const i18n = await mergeI18nIntoRepo(destRoot, deps.i18nKeys);
-  if (i18n.added.length > 0) {
-    console.log(pc3.green(`  add   messages/ (${i18n.added.length} key(s))`));
-  }
-  console.log(pc3.bold(pc3.green(`
-Done. Copied ${entries.length} component(s) into ${destRoot}.`)));
-}
-
-// src/index.ts
-var program = new Command();
-program.name("composed-cli").description(
-  "Install individual composed UI components from the BIM frontend boilerplate into a Next.js + shadcn project."
-).version("0.1.1");
-program.command("add").description("Add one or more composed components to the current project").argument(
-  "<components...>",
-  "component name(s), slug(s), or path(s) like labeled-select or components/ui"
-).option("-c, --cwd <path>", "target project directory", process.cwd()).option("-o, --overwrite", "overwrite files that already exist", false).option("--skip-shadcn", "do not run `shadcn add` for required primitives", false).option("--skip-npm", "do not install required npm packages", false).option("--skip-i18n", "do not generate the local i18n strings file", false).action(async (components, opts) => {
-  await runAdd(components, {
-    cwd: opts.cwd,
-    overwrite: opts.overwrite,
-    skipShadcn: opts.skipShadcn,
-    skipNpm: opts.skipNpm,
-    skipI18n: opts.skipI18n
-  });
-});
-program.command("move").description(
-  "Copy a composed component and its related files (controller, i18n) into another repository"
-).argument(
-  "<components...>",
-  "component name(s), slug(s), or path(s) like labeled-select or components/ui"
-).option("-t, --to <path>", "destination repository path", process.cwd()).option(
-  "-f, --from <path>",
-  "source boilerplate repository (optional; the published package uses its bundled registry)"
-).option("-o, --overwrite", "overwrite files that already exist", false).action(async (components, opts) => {
-  await runMove(components, {
-    to: opts.to,
-    from: opts.from,
-    overwrite: opts.overwrite
-  });
-});
-var create = program.command("create").description(
-  "Install a feature that already exists in the boilerplate into a target project"
-).addHelpText(
-  "after",
-  `
-The boilerplate is the single source of truth for which features exist. This
-does not generate arbitrary/new features \u2014 it installs an existing, registered
-boilerplate feature's real files into a target project, in the implementation
-that matches the target project's own framework.
-
-  Boilerplate -> Feature Registry -> Feature -> Framework Implementation -> Target Project
-
-See \`composed-cli create feature --help\` for the feature installer.`
-);
-create.command("feature").description(
-  "Install an existing boilerplate feature (route, screen, API layer, translations) into a target project, using the implementation registered for that project's detected framework."
-).argument("<name>", "registered feature name, e.g. login, dashboard, about, contact").option("-c, --cwd <path>", "target project directory", process.cwd()).option("--protected", "require/assert the protected-route implementation").option("--public", "require/assert the public-route implementation").option("-o, --overwrite", "overwrite files that already exist", false).addHelpText(
-  "after",
-  `
-The target project's framework is detected automatically (package.json
-dependencies, then project structure) \u2014 it does not need to be a copy of this
-boilerplate. Only frameworks with a registered implementation for the
-requested feature are supported; run the command to see the registry's error
-message list available features or supported frameworks.
-
---protected / --public are validated against the resolved implementation's
-own route scope (e.g. dashboard is always protected, about is always public)
-rather than choosing it \u2014 pass one only to assert the scope you expect;
-omit both to just install whatever the registry defines.
-
-Examples:
-  $ composed-cli create feature login
-  $ composed-cli create feature dashboard
-  $ composed-cli create feature login --cwd ./next-app
-  $ composed-cli create feature dashboard --cwd ./tanstack-app
-  $ composed-cli create feature login --overwrite
-
-Behavior:
-  - Unknown feature name -> rejected, lists available features.
-   - Feature exists but no implementation for the detected framework -> rejected, lists supported frameworks.
-   - Next.js targets install App Router pages from cli/templates/nextjs/ and rewrite Paraglide to @/lib/composed-strings.
-  - Every target file is checked for conflicts before anything is written; existing files are reported and left untouched unless --overwrite is passed.
-  - Files are copied byte-for-byte from the boilerplate's real source tree \u2014 nothing is templated or invented.
-  - Translation keys are merged into the target's messages/<locale>/*.json when that folder exists; skipped otherwise.`
-).action(async (name, opts) => {
-  await runCreateFeature(name, {
-    cwd: opts.cwd,
-    protected: opts.protected ?? false,
-    public: opts.public ?? false,
-    overwrite: opts.overwrite
-  });
-});
-program.parseAsync(process.argv);
+#!/usr/bin/env node
+
+// src/index.ts
+import { Command } from "commander";
+
+// src/commands/add.ts
+import pc from "picocolors";
+
+// src/lib/install-files.ts
+import { existsSync as existsSync4, mkdirSync as mkdirSync2, writeFileSync as writeFileSync2 } from "fs";
+import { dirname as dirname2, join as join4, relative } from "path";
+
+// src/lib/controllers.ts
+var CONTROLLERS_PREFIX = "src/components/common/controllers/";
+function toKebabCase(name) {
+  return name.replace(/([a-z0-9])([A-Z])/g, "$1-$2").replace(/([A-Z])([A-Z][a-z])/g, "$1-$2").toLowerCase();
+}
+function findControllerPath(source, exportName) {
+  const guessed = `${CONTROLLERS_PREFIX}${toKebabCase(exportName)}.tsx`;
+  if (source.hasFile(guessed) && source.readFile(guessed).includes(`export function ${exportName}`)) {
+    return guessed;
+  }
+  for (const path of source.listFiles(CONTROLLERS_PREFIX)) {
+    if (!path.endsWith(".tsx")) continue;
+    if (path.endsWith("/index.tsx") || path.endsWith("/index.ts")) continue;
+    if (source.readFile(path).includes(`export function ${exportName}`)) {
+      return path;
+    }
+  }
+  return void 0;
+}
+function controllerBarrelExport(exportName, relPath) {
+  const fileName = relPath.split("/").pop().replace(/\.tsx?$/, "");
+  return `export { ${exportName} } from './${fileName}';`;
+}
+
+// src/lib/i18n.ts
+import { existsSync as existsSync2, mkdirSync, readFileSync as readFileSync2, writeFileSync } from "fs";
+import { join as join2 } from "path";
+
+// src/lib/source.ts
+import { existsSync, readFileSync, readdirSync, statSync } from "fs";
+import { dirname, join } from "path";
+import { fileURLToPath, pathToFileURL } from "url";
+var here = dirname(fileURLToPath(import.meta.url));
+function findAncestorContaining(startDir, markerRelPath, maxLevels = 6) {
+  let dir = startDir;
+  for (let i = 0; i <= maxLevels; i++) {
+    if (existsSync(join(dir, markerRelPath))) return dir;
+    const parent = dirname(dir);
+    if (parent === dir) return void 0;
+    dir = parent;
+  }
+  return void 0;
+}
+function loadFromBundle() {
+  const distDir = findAncestorContaining(here, "registry-bundle.json");
+  if (!distDir) return void 0;
+  const bundle = JSON.parse(
+    readFileSync(join(distDir, "registry-bundle.json"), "utf-8")
+  );
+  return {
+    registry: bundle.registry,
+    featureRegistry: bundle.featureRegistry ?? [],
+    readFile: (path) => {
+      const content = bundle.files[path];
+      if (content === void 0) {
+        throw new Error(`registry-bundle.json is missing file: ${path}`);
+      }
+      return content;
+    },
+    hasFile: (path) => path in bundle.files,
+    listFiles: (prefix) => {
+      const normalized = prefix.replace(/\\/g, "/").replace(/\/$/, "");
+      return Object.keys(bundle.files).filter(
+        (p) => p === normalized || p.startsWith(`${normalized}/`)
+      );
+    },
+    readMessages: (locale) => bundle.messages[locale] ?? {}
+  };
+}
+async function loadFromBoilerplateTree() {
+  const boilerplateRoot = overrideRoot ?? findAncestorContaining(here, join("src", "registry", "components.ts"));
+  if (!boilerplateRoot) return void 0;
+  if (!existsSync(join(boilerplateRoot, "src", "registry", "components.ts"))) {
+    return void 0;
+  }
+  const registryPath = join(boilerplateRoot, "src", "registry", "components.ts");
+  const mod = await import(
+    /* @vite-ignore */
+    pathToFileURL(registryPath).href
+  );
+  const featuresPath = join(boilerplateRoot, "src", "registry", "features.ts");
+  let featureRegistry = [];
+  if (existsSync(featuresPath)) {
+    const featuresMod = await import(
+      /* @vite-ignore */
+      pathToFileURL(featuresPath).href
+    );
+    featureRegistry = featuresMod.featureRegistry;
+  }
+  return {
+    registry: mod.componentRegistry,
+    featureRegistry,
+    readFile: (path) => {
+      const abs = join(boilerplateRoot, path);
+      if (!existsSync(abs)) {
+        throw new Error(`Source file missing from boilerplate tree: ${path}`);
+      }
+      return readFileSync(abs, "utf-8");
+    },
+    hasFile: (path) => existsSync(join(boilerplateRoot, path)),
+    listFiles: (prefix) => listFilesFromTree(boilerplateRoot, prefix),
+    readMessages: (locale) => readMessagesFromTree(boilerplateRoot, locale)
+  };
+}
+function listFilesFromTree(boilerplateRoot, prefix) {
+  const abs = join(boilerplateRoot, prefix);
+  if (!existsSync(abs)) return [];
+  const posixPrefix = prefix.replace(/\\/g, "/").replace(/\/$/, "");
+  if (statSync(abs).isFile()) return [posixPrefix];
+  const out = [];
+  for (const entry of readdirSync(abs, { withFileTypes: true })) {
+    const rel = `${posixPrefix}/${entry.name}`;
+    if (entry.isDirectory()) {
+      out.push(...listFilesFromTree(boilerplateRoot, rel));
+    } else {
+      out.push(rel);
+    }
+  }
+  return out;
+}
+function readMessagesFromTree(boilerplateRoot, locale) {
+  const dir = join(boilerplateRoot, "messages", locale);
+  const out = {};
+  if (!existsSync(dir)) return out;
+  for (const file of readdirSync(dir)) {
+    if (!file.endsWith(".json")) continue;
+    const json = JSON.parse(readFileSync(join(dir, file), "utf-8"));
+    for (const [key, value] of Object.entries(json)) {
+      if (key === "$schema") continue;
+      out[key] = String(value);
+    }
+  }
+  return out;
+}
+var cached;
+var overrideRoot;
+function setSourceRoot(root) {
+  cached = void 0;
+  overrideRoot = root;
+}
+function getSourceRoot() {
+  return overrideRoot;
+}
+function resolveSourceRoot() {
+  return overrideRoot ?? findAncestorContaining(here, join("src", "registry", "components.ts"));
+}
+async function getComponentSource() {
+  if (cached) return cached;
+  const source = overrideRoot ? await loadFromBoilerplateTree() : loadFromBundle() ?? await loadFromBoilerplateTree();
+  if (!source) {
+    throw new Error(
+      "Could not locate component source. Expected either a built dist/registry-bundle.json (published package) or a sibling src/registry/components.ts (running inside the boilerplate repo)."
+    );
+  }
+  cached = source;
+  return source;
+}
+
+// src/lib/i18n.ts
+var STRINGS_RUNTIME = `// Generated by composed-cli. Minimal string lookup for components copied
+// from the BIM boilerplate \u2014 replace with your own i18n solution as needed.
+import strings from './strings.json';
+
+export function t(key: keyof typeof strings, params?: Record<string, string | number>) {
+  let value = strings[key] ?? key;
+  if (params) {
+    for (const [name, val] of Object.entries(params)) {
+      value = value.replaceAll(\`{\${name}}\`, String(val));
+    }
+  }
+  return value;
+}
+`;
+async function installI18nStrings(cwd, keys, destDir = "src/lib/composed-strings") {
+  if (keys.length === 0) return { ok: true, addedKeys: [], path: "" };
+  const source = await getComponentSource();
+  const enMessages = source.readMessages("en");
+  const outDir = join2(cwd, destDir);
+  mkdirSync(outDir, { recursive: true });
+  const stringsPath = join2(outDir, "strings.json");
+  const existing = existsSync2(stringsPath) ? JSON.parse(readFileSync2(stringsPath, "utf-8")) : {};
+  const addedKeys = [];
+  for (const key of keys) {
+    if (!(key in enMessages)) continue;
+    if (!(key in existing)) addedKeys.push(key);
+    existing[key] = enMessages[key];
+  }
+  const sorted = Object.fromEntries(
+    Object.keys(existing).sort().map((key) => [key, existing[key]])
+  );
+  writeFileSync(stringsPath, JSON.stringify(sorted, null, 2) + "\n", "utf-8");
+  const runtimePath = join2(outDir, "index.ts");
+  if (!existsSync2(runtimePath)) {
+    writeFileSync(runtimePath, STRINGS_RUNTIME, "utf-8");
+  }
+  return { ok: true, addedKeys, path: join2(destDir, "index.ts") };
+}
+function rewriteParaglideUsage(source, importPath) {
+  let out = source.replace(
+    /import\s*\{\s*m\s*\}\s*from\s*['"]#\/paraglide\/messages['"];?\n?/,
+    `import { t } from '${importPath}';
+`
+  );
+  out = out.replace(/\bm\.([a-zA-Z0-9_]+)\(\s*\)/g, "t('$1')");
+  out = out.replace(/\bm\.([a-zA-Z0-9_]+)\(\s*(\{[^}]*\})\s*\)/g, "t('$1', $2)");
+  return out;
+}
+
+// src/lib/target-config.ts
+import { existsSync as existsSync3, readFileSync as readFileSync3 } from "fs";
+import { join as join3 } from "path";
+var defaultAliases = {
+  components: "@/components",
+  ui: "@/components/ui",
+  utils: "@/lib/utils",
+  lib: "@/lib"
+};
+function readTargetAliases(cwd) {
+  const configPath = join3(cwd, "components.json");
+  if (!existsSync3(configPath)) return defaultAliases;
+  try {
+    const config = JSON.parse(readFileSync3(configPath, "utf-8"));
+    return {
+      components: config.aliases?.components ?? defaultAliases.components,
+      ui: config.aliases?.ui ?? defaultAliases.ui,
+      utils: config.aliases?.utils ?? defaultAliases.utils,
+      lib: config.aliases?.lib ?? defaultAliases.lib
+    };
+  } catch {
+    return defaultAliases;
+  }
+}
+function aliasToPath(cwd, alias) {
+  const bareAlias = alias.replace(/^[@#]\//, "");
+  const base = existsSync3(join3(cwd, "src")) ? join3(cwd, "src") : cwd;
+  return join3(base, bareAlias);
+}
+
+// src/lib/install-files.ts
+async function copyComponentFiles(cwd, entry, opts) {
+  const source = await getComponentSource();
+  const aliases = readTargetAliases(cwd);
+  const uiDir = aliasToPath(cwd, aliases.ui);
+  const composedDir = join4(uiDir, "composed", entry.slug);
+  const results = [];
+  for (const file of entry.files) {
+    const fileName = file.path.split("/").pop();
+    const targetPath = join4(composedDir, fileName);
+    if (existsSync4(targetPath) && !opts.overwrite) {
+      results.push({
+        entryName: entry.name,
+        targetPath,
+        skipped: true,
+        reason: "already exists (use --overwrite to replace)"
+      });
+      continue;
+    }
+    let content = source.readFile(file.path);
+    if (entry.i18n.required) {
+      content = rewriteParaglideUsage(content, opts.stringsImportPath);
+    }
+    mkdirSync2(dirname2(targetPath), { recursive: true });
+    writeFileSync2(targetPath, content, "utf-8");
+    results.push({ entryName: entry.name, targetPath, skipped: false });
+  }
+  if (entry.controller) {
+    const controller = await copyController(cwd, entry, opts);
+    if (controller) results.push(controller);
+  }
+  return results;
+}
+async function copyController(cwd, entry, opts) {
+  if (!entry.controller) return void 0;
+  const source = await getComponentSource();
+  const controllerPath = findControllerPath(source, entry.controller);
+  if (!controllerPath) {
+    throw new Error(
+      `Could not find controller file for ${entry.name} (${entry.controller})`
+    );
+  }
+  const aliases = readTargetAliases(cwd);
+  const fileName = controllerPath.split("/").pop();
+  const targetPath = join4(
+    aliasToPath(cwd, aliases.components),
+    "common",
+    "controllers",
+    fileName
+  );
+  if (existsSync4(targetPath) && !opts.overwrite) {
+    return {
+      entryName: entry.controller,
+      targetPath,
+      skipped: true,
+      reason: "already exists (use --overwrite to replace)"
+    };
+  }
+  mkdirSync2(dirname2(targetPath), { recursive: true });
+  writeFileSync2(targetPath, source.readFile(controllerPath), "utf-8");
+  return { entryName: entry.controller, targetPath, skipped: false };
+}
+async function copyLocalUtil(cwd, localDep, opts) {
+  if (localDep !== "@/lib/utils") return void 0;
+  const source = await getComponentSource();
+  const aliases = readTargetAliases(cwd);
+  const utilsAbsPath = aliasToPath(cwd, aliases.utils) + ".ts";
+  if (existsSync4(utilsAbsPath) && !opts.overwrite) {
+    return {
+      entryName: "cn",
+      targetPath: utilsAbsPath,
+      skipped: true,
+      reason: "already exists"
+    };
+  }
+  const content = source.readFile("src/lib/utils.ts");
+  mkdirSync2(dirname2(utilsAbsPath), { recursive: true });
+  writeFileSync2(utilsAbsPath, content, "utf-8");
+  return { entryName: "cn", targetPath: utilsAbsPath, skipped: false };
+}
+function toDisplayPath(cwd, absPath) {
+  return relative(cwd, absPath).split("\\").join("/");
+}
+var UI_PREFIXES = ["src/components/ui/", "components/ui/"];
+function uiRelativePath(relPath) {
+  const posix = relPath.replace(/\\/g, "/");
+  for (const prefix of UI_PREFIXES) {
+    if (posix.startsWith(prefix)) return posix.slice(prefix.length);
+  }
+  return void 0;
+}
+function extraPrimitiveSlugs(extraFiles) {
+  const slugs = [];
+  for (const file of extraFiles) {
+    const rel = uiRelativePath(file);
+    if (!rel || rel.includes("/")) continue;
+    if (rel.endsWith(".tsx") || rel.endsWith(".ts")) {
+      slugs.push(rel.replace(/\.tsx?$/, ""));
+    }
+  }
+  return slugs;
+}
+async function copyExtraFiles(cwd, extraFiles, opts) {
+  if (extraFiles.length === 0) return [];
+  const source = await getComponentSource();
+  const aliases = readTargetAliases(cwd);
+  const uiDir = aliasToPath(cwd, aliases.ui);
+  const results = [];
+  for (const relPath of extraFiles) {
+    const uiRel = uiRelativePath(relPath);
+    const targetPath = opts.useAliases && uiRel !== void 0 ? join4(uiDir, uiRel) : join4(cwd, relPath);
+    if (existsSync4(targetPath) && !opts.overwrite) {
+      results.push({
+        entryName: relPath,
+        targetPath,
+        skipped: true,
+        reason: "already exists (use --overwrite to replace)"
+      });
+      continue;
+    }
+    let content = source.readFile(relPath);
+    if (opts.stringsImportPath) {
+      content = rewriteParaglideUsage(content, opts.stringsImportPath);
+    }
+    mkdirSync2(dirname2(targetPath), { recursive: true });
+    writeFileSync2(targetPath, content, "utf-8");
+    results.push({ entryName: relPath, targetPath, skipped: false });
+  }
+  return results;
+}
+
+// src/lib/npm-install.ts
+import { spawnSync } from "child_process";
+
+// src/lib/package-manager.ts
+import { existsSync as existsSync5 } from "fs";
+import { join as join5 } from "path";
+var lockfiles = {
+  "bun.lock": "bun",
+  "bun.lockb": "bun",
+  "pnpm-lock.yaml": "pnpm",
+  "yarn.lock": "yarn",
+  "package-lock.json": "npm"
+};
+function detectPackageManager(cwd) {
+  for (const [lockfile, pm] of Object.entries(lockfiles)) {
+    if (existsSync5(join5(cwd, lockfile))) return pm;
+  }
+  const userAgent = process.env.npm_config_user_agent ?? "";
+  if (userAgent.startsWith("bun")) return "bun";
+  if (userAgent.startsWith("pnpm")) return "pnpm";
+  if (userAgent.startsWith("yarn")) return "yarn";
+  return "npm";
+}
+function installCommand(pm, packages) {
+  switch (pm) {
+    case "bun":
+      return ["bun", ["add", ...packages]];
+    case "pnpm":
+      return ["pnpm", ["add", ...packages]];
+    case "yarn":
+      return ["yarn", ["add", ...packages]];
+    case "npm":
+    default:
+      return ["npm", ["install", ...packages]];
+  }
+}
+function dlxCommand(pm, args) {
+  switch (pm) {
+    case "bun":
+      return ["bunx", args];
+    case "pnpm":
+      return ["pnpm", ["dlx", ...args]];
+    case "yarn":
+      return ["yarn", ["dlx", ...args]];
+    case "npm":
+    default:
+      return ["npx", args];
+  }
+}
+
+// src/lib/npm-install.ts
+function installNpmPackages(cwd, packages, pm) {
+  if (packages.length === 0) return { ok: true };
+  const [cmd, args] = installCommand(pm, packages);
+  const result = spawnSync(cmd, args, {
+    cwd,
+    stdio: "inherit",
+    shell: process.platform === "win32"
+  });
+  if (result.status !== 0) {
+    return { ok: false, message: `${cmd} exited with code ${result.status}` };
+  }
+  return { ok: true };
+}
+
+// src/lib/resolve.ts
+import { existsSync as existsSync6 } from "fs";
+import { dirname as dirname3, isAbsolute, relative as relative2, resolve } from "path";
+
+// src/lib/registry.ts
+async function loadRegistry() {
+  const source = await getComponentSource();
+  return source.registry;
+}
+async function findComponent(query) {
+  const registry = await loadRegistry();
+  const byName = registry.find((e) => e.name === query);
+  if (byName) return byName;
+  const bySlug = registry.filter((e) => e.slug === query);
+  if (bySlug.length === 1) return bySlug[0];
+  if (bySlug.length > 1) return bySlug;
+  return void 0;
+}
+
+// src/lib/resolve.ts
+async function resolveQueries(queries) {
+  const entries = [];
+  const extraFiles = [];
+  const notFound = [];
+  const ambiguous = {};
+  const seen = /* @__PURE__ */ new Set();
+  const seenExtra = /* @__PURE__ */ new Set();
+  for (const query of queries) {
+    const fromPath = looksLikePath(query) ? await findComponentsByPath(query) : void 0;
+    if (fromPath) {
+      if (fromPath.entries.length === 0 && fromPath.extraFiles.length === 0) {
+        notFound.push(query);
+        continue;
+      }
+      for (const match2 of fromPath.entries) {
+        if (!seen.has(match2.name)) {
+          seen.add(match2.name);
+          entries.push(match2);
+        }
+      }
+      for (const file of fromPath.extraFiles) {
+        if (!seenExtra.has(file)) {
+          seenExtra.add(file);
+          extraFiles.push(file);
+        }
+      }
+      continue;
+    }
+    const match = await findComponent(query);
+    if (!match) {
+      notFound.push(query);
+      continue;
+    }
+    if (Array.isArray(match)) {
+      ambiguous[query] = match.map((e) => e.name);
+      continue;
+    }
+    if (!seen.has(match.name)) {
+      seen.add(match.name);
+      entries.push(match);
+    }
+  }
+  return { entries, extraFiles, notFound, ambiguous };
+}
+function unionDependencies(entries) {
+  const shadcn = /* @__PURE__ */ new Set();
+  const npm = /* @__PURE__ */ new Set();
+  const local = /* @__PURE__ */ new Set();
+  const i18nKeys = /* @__PURE__ */ new Set();
+  for (const entry of entries) {
+    entry.dependencies.shadcn.forEach((s) => shadcn.add(s));
+    entry.dependencies.npm.forEach((n) => npm.add(n));
+    entry.dependencies.local.forEach((l) => local.add(l));
+    entry.i18n.keys.forEach((k) => i18nKeys.add(k));
+  }
+  return {
+    shadcn: [...shadcn],
+    npm: [...npm],
+    local: [...local],
+    i18nKeys: [...i18nKeys]
+  };
+}
+async function allComponentNames() {
+  return (await loadRegistry()).map((e) => `${e.name} (${e.slug})`);
+}
+function looksLikePath(query) {
+  return isAbsolute(query) || /[\\/]/.test(query);
+}
+function toPosix(query) {
+  return query.replace(/\\/g, "/").replace(/\/$/, "");
+}
+function registryPrefixes(query) {
+  const posix = toPosix(query);
+  if (!posix || isAbsolute(query)) return [];
+  const prefixes = [posix];
+  if (!posix.startsWith("src/")) prefixes.push(`src/${posix}`);
+  return prefixes;
+}
+function matchesPrefix(filePath, prefix) {
+  return filePath === prefix || filePath.startsWith(`${prefix}/`);
+}
+function findBoilerplateRoot(start) {
+  let dir = start;
+  for (let i = 0; i <= 8; i++) {
+    if (existsSync6(resolve(dir, "src", "registry", "components.ts"))) return dir;
+    const parent = dirname3(dir);
+    if (parent === dir) return void 0;
+    dir = parent;
+  }
+  return void 0;
+}
+function queryToRelPath(query) {
+  const base = getSourceRoot() ?? process.cwd();
+  const abs = isAbsolute(query) ? query : resolve(base, query);
+  if (!existsSync6(abs)) return void 0;
+  const root = getSourceRoot() ?? findBoilerplateRoot(abs) ?? findBoilerplateRoot(process.cwd());
+  if (!root) return void 0;
+  const rel = relative2(root, abs).split("\\").join("/");
+  if (!rel || rel.startsWith("..")) return void 0;
+  return rel.replace(/\/$/, "");
+}
+async function findComponentsByPath(query) {
+  const rel = queryToRelPath(query);
+  const prefixes = rel ? [rel] : registryPrefixes(query);
+  if (prefixes.length === 0) return void 0;
+  const source = await getComponentSource();
+  const entries = source.registry.filter(
+    (entry) => entry.files.some((file) => prefixes.some((prefix) => matchesPrefix(file.path, prefix)))
+  );
+  const registered = new Set(entries.flatMap((entry) => entry.files.map((file) => file.path)));
+  const extra = /* @__PURE__ */ new Set();
+  for (const prefix of prefixes) {
+    for (const file of source.listFiles(prefix)) {
+      if (!registered.has(file)) extra.add(file);
+    }
+  }
+  return { entries, extraFiles: [...extra].sort() };
+}
+
+// src/lib/shadcn.ts
+import { existsSync as existsSync7 } from "fs";
+import { join as join6 } from "path";
+import { spawnSync as spawnSync2 } from "child_process";
+function hasShadcnConfig(cwd) {
+  return existsSync7(join6(cwd, "components.json"));
+}
+function installShadcnPrimitives(cwd, slugs, pm) {
+  if (slugs.length === 0) return [];
+  const [cmd, baseArgs] = dlxCommand(pm, ["shadcn@latest", "add", ...slugs, "-y"]);
+  const result = spawnSync2(cmd, baseArgs, {
+    cwd,
+    stdio: "inherit",
+    shell: process.platform === "win32"
+  });
+  const ok = result.status === 0;
+  return slugs.map((slug) => ({
+    slug,
+    ok,
+    message: ok ? void 0 : `shadcn add exited with code ${result.status}`
+  }));
+}
+
+// src/lib/validate-install.ts
+import { existsSync as existsSync8, readFileSync as readFileSync4 } from "fs";
+function validateCopiedFiles(files) {
+  const issues = [];
+  for (const file of files) {
+    if (!existsSync8(file.targetPath)) {
+      issues.push({ file: file.targetPath, message: "file was not written" });
+      continue;
+    }
+    const content = readFileSync4(file.targetPath, "utf-8");
+    if (/from\s*['"]#\/paraglide\/messages['"]/.test(content)) {
+      issues.push({
+        file: file.targetPath,
+        message: "still imports Paraglide messages (rewrite did not apply)"
+      });
+    }
+    if (/\bm\.[a-zA-Z0-9_]+\(/.test(content)) {
+      issues.push({
+        file: file.targetPath,
+        message: "still calls m.*() (rewrite missed a usage)"
+      });
+    }
+  }
+  return issues;
+}
+
+// src/commands/add.ts
+async function runAdd(queries, options) {
+  const { cwd } = options;
+  if (queries.length === 0) {
+    console.error(pc.red("Usage: composed-cli add <component> [components...]"));
+    console.error("");
+    console.error("Available components:");
+    for (const name of await allComponentNames()) console.error(`  ${name}`);
+    process.exitCode = 1;
+    return;
+  }
+  const resolved = await resolveQueries(queries);
+  const { entries, notFound, ambiguous } = resolved;
+  const extraFiles = [
+    .../* @__PURE__ */ new Set([...options.extraFiles ?? [], ...resolved.extraFiles])
+  ];
+  if (notFound.length > 0) {
+    console.error(pc.red(`Unknown component(s): ${notFound.join(", ")}`));
+  }
+  for (const [query, names] of Object.entries(ambiguous)) {
+    console.error(
+      pc.red(
+        `"${query}" matches multiple components: ${names.join(", ")}. Use one of those exact names.`
+      )
+    );
+  }
+  if (entries.length === 0 && extraFiles.length === 0) {
+    process.exitCode = 1;
+    return;
+  }
+  if (!hasShadcnConfig(cwd)) {
+    console.error(
+      pc.red(
+        "No components.json found in this project. Run `shadcn init` before `composed-cli add`."
+      )
+    );
+    process.exitCode = 1;
+    return;
+  }
+  console.log(
+    pc.bold(
+      entries.length > 0 ? `Installing: ${entries.map((e) => e.name).join(", ")}` : `Copying ${extraFiles.length} file(s)`
+    )
+  );
+  const deps = unionDependencies(entries);
+  const pm = detectPackageManager(cwd);
+  const copiedPrimitiveSlugs = new Set(extraPrimitiveSlugs(extraFiles));
+  const shadcnToInstall = deps.shadcn.filter((s) => !copiedPrimitiveSlugs.has(s));
+  if (shadcnToInstall.length > 0 && !options.skipShadcn) {
+    console.log(pc.cyan(`
+> Installing shadcn primitives: ${shadcnToInstall.join(", ")}`));
+    const results = installShadcnPrimitives(cwd, shadcnToInstall, pm);
+    const failed = results.filter((r) => !r.ok);
+    if (failed.length > 0) {
+      console.error(
+        pc.red(`shadcn add failed for: ${failed.map((f) => f.slug).join(", ")}`)
+      );
+      process.exitCode = 1;
+      return;
+    }
+  } else if (deps.shadcn.length > 0) {
+    const reason = options.skipShadcn ? "--skip-shadcn" : "copied from source";
+    console.log(
+      pc.dim(`
+> Skipped shadcn primitives (${reason}): ${deps.shadcn.join(", ")}`)
+    );
+  }
+  if (deps.npm.length > 0 && !options.skipNpm) {
+    console.log(pc.cyan(`
+> Installing npm packages: ${deps.npm.join(", ")}`));
+    const result = installNpmPackages(cwd, deps.npm, pm);
+    if (!result.ok) {
+      console.error(pc.red(`npm install failed: ${result.message}`));
+      process.exitCode = 1;
+      return;
+    }
+  } else if (deps.npm.length > 0) {
+    console.log(pc.dim(`
+> Skipped npm packages (--skip-npm): ${deps.npm.join(", ")}`));
+  }
+  const stringsImportPath = "@/lib/composed-strings";
+  let i18nAdded = [];
+  if (deps.i18nKeys.length > 0 && !options.skipI18n) {
+    const result = await installI18nStrings(cwd, deps.i18nKeys);
+    i18nAdded = result.addedKeys;
+  }
+  console.log(pc.cyan(`
+> Copying component files`));
+  const copiedFiles = [];
+  for (const entry of entries) {
+    const copied = await copyComponentFiles(cwd, entry, {
+      overwrite: options.overwrite,
+      stringsImportPath
+    });
+    copiedFiles.push(...copied);
+    for (const file of copied) {
+      if (file.skipped) {
+        console.log(pc.yellow(`  skip  ${toDisplayPath(cwd, file.targetPath)} (${file.reason})`));
+      } else {
+        console.log(pc.green(`  add   ${toDisplayPath(cwd, file.targetPath)}`));
+      }
+    }
+    if (entry.knownIssues?.length) {
+      for (const issue of entry.knownIssues) {
+        console.log(pc.yellow(`  !     ${entry.name}: ${issue}`));
+      }
+    }
+  }
+  const extraCopied = await copyExtraFiles(cwd, extraFiles, {
+    overwrite: options.overwrite,
+    useAliases: true,
+    stringsImportPath
+  });
+  copiedFiles.push(...extraCopied);
+  for (const file of extraCopied) {
+    if (file.skipped) {
+      console.log(pc.yellow(`  skip  ${toDisplayPath(cwd, file.targetPath)} (${file.reason})`));
+    } else {
+      console.log(pc.green(`  add   ${toDisplayPath(cwd, file.targetPath)}`));
+    }
+  }
+  for (const localDep of deps.local) {
+    const copied = await copyLocalUtil(cwd, localDep, { overwrite: options.overwrite });
+    if (copied) {
+      copiedFiles.push(copied);
+      const line = copied.skipped ? pc.yellow(`  skip  ${toDisplayPath(cwd, copied.targetPath)} (${copied.reason})`) : pc.green(`  add   ${toDisplayPath(cwd, copied.targetPath)}`);
+      console.log(line);
+    }
+  }
+  if (i18nAdded.length > 0) {
+    console.log(pc.green(`  add   src/lib/composed-strings/ (${i18nAdded.length} key(s))`));
+  }
+  const issues = validateCopiedFiles(copiedFiles);
+  if (issues.length > 0) {
+    console.log(pc.red(`
+> Validation found ${issues.length} issue(s):`));
+    for (const issue of issues) {
+      console.log(pc.red(`  ${toDisplayPath(cwd, issue.file)}: ${issue.message}`));
+    }
+    process.exitCode = 1;
+    return;
+  }
+  const extraNote = extraFiles.length > 0 ? ` and ${extraFiles.length} primitive file(s)` : "";
+  console.log(
+    pc.bold(pc.green(`
+Done. Installed ${entries.length} component(s)${extraNote}.`))
+  );
+}
+
+// src/commands/create.ts
+import { existsSync as existsSync12 } from "fs";
+import pc2 from "picocolors";
+
+// src/lib/framework-detect.ts
+import { existsSync as existsSync9, readFileSync as readFileSync5 } from "fs";
+import { join as join7 } from "path";
+function readPackageJson(cwd) {
+  const pkgPath = join7(cwd, "package.json");
+  if (!existsSync9(pkgPath)) return void 0;
+  try {
+    return JSON.parse(readFileSync5(pkgPath, "utf-8"));
+  } catch {
+    return void 0;
+  }
+}
+function allDeps(pkg) {
+  return { ...pkg.dependencies, ...pkg.devDependencies };
+}
+function detectTargetFramework(cwd) {
+  const pkg = readPackageJson(cwd);
+  if (pkg) {
+    const deps = allDeps(pkg);
+    if ("@tanstack/react-start" in deps || "@tanstack/start" in deps) {
+      return {
+        framework: "tanstack",
+        reason: "package.json depends on @tanstack/react-start"
+      };
+    }
+    if ("next" in deps) {
+      return { framework: "nextjs", reason: "package.json depends on next" };
+    }
+  }
+  if (existsSync9(join7(cwd, "next.config.js")) || existsSync9(join7(cwd, "next.config.ts")) || existsSync9(join7(cwd, "next.config.mjs"))) {
+    return { framework: "nextjs", reason: "found a next.config.* file" };
+  }
+  if (existsSync9(join7(cwd, "app")) && (existsSync9(join7(cwd, "app", "layout.tsx")) || existsSync9(join7(cwd, "app", "layout.js")))) {
+    return { framework: "nextjs", reason: "found app/layout.tsx (Next.js App Router)" };
+  }
+  if (existsSync9(join7(cwd, "src", "app")) && (existsSync9(join7(cwd, "src", "app", "layout.tsx")) || existsSync9(join7(cwd, "src", "app", "layout.js")))) {
+    return { framework: "nextjs", reason: "found src/app/layout.tsx (Next.js App Router)" };
+  }
+  if (existsSync9(join7(cwd, "src", "routeTree.gen.ts"))) {
+    return {
+      framework: "tanstack",
+      reason: "found src/routeTree.gen.ts (TanStack Router)"
+    };
+  }
+  if (existsSync9(join7(cwd, "src", "routes")) && existsSync9(join7(cwd, "src", "router.tsx"))) {
+    return {
+      framework: "tanstack",
+      reason: "found src/routes and src/router.tsx (TanStack Start layout)"
+    };
+  }
+  return void 0;
+}
+
+// src/lib/feature-registry.ts
+async function loadFeatureRegistry() {
+  const source = await getComponentSource();
+  return source.featureRegistry;
+}
+async function findFeature(name) {
+  const registry = await loadFeatureRegistry();
+  return registry.find((e) => e.name === name);
+}
+async function listFeatureNames() {
+  return (await loadFeatureRegistry()).map((e) => e.name);
+}
+function frameworkLabel(framework) {
+  return framework === "tanstack" ? "TanStack Start" : "Next.js";
+}
+function supportedFrameworksFor(entry) {
+  return Object.keys(entry.frameworks);
+}
+
+// src/lib/install-feature.ts
+import { existsSync as existsSync10, mkdirSync as mkdirSync3, readFileSync as readFileSync6, writeFileSync as writeFileSync3 } from "fs";
+import { dirname as dirname4, join as join8 } from "path";
+function nextAppDir(cwd) {
+  if (existsSync10(join8(cwd, "src", "app"))) return "src/app";
+  if (existsSync10(join8(cwd, "app"))) return "app";
+  if (existsSync10(join8(cwd, "src"))) return "src/app";
+  return "app";
+}
+function toFeatureTargetPath(cwd, sourceRelPath, impl, framework) {
+  let rel = sourceRelPath.replace(/\\/g, "/");
+  const prefix = impl.sourcePrefix?.replace(/\\/g, "/");
+  if (prefix && rel.startsWith(prefix)) rel = rel.slice(prefix.length);
+  if (framework === "nextjs" && (rel === "src/app" || rel.startsWith("src/app/"))) {
+    const appDir = nextAppDir(cwd);
+    if (appDir === "app") rel = rel.replace(/^src\/app/, "app");
+  }
+  return rel;
+}
+function adaptContent(content, framework) {
+  if (framework !== "nextjs") return content;
+  return rewriteParaglideUsage(content, "@/lib/composed-strings").replaceAll("#/", "@/");
+}
+function sourceContent(source, relPath, framework) {
+  return adaptContent(source.readFile(relPath), framework);
+}
+function fileMatchesSource(cwd, sourceRelPath, targetRelPath, source, framework) {
+  const targetPath = join8(cwd, targetRelPath);
+  if (!existsSync10(targetPath)) return false;
+  return readFileSync6(targetPath, "utf-8") === sourceContent(source, sourceRelPath, framework);
+}
+async function installFeatureFiles(cwd, impl, opts) {
+  const source = await getComponentSource();
+  const results = [];
+  for (const relPath of impl.files) {
+    const targetRel = toFeatureTargetPath(cwd, relPath, impl, opts.framework);
+    const targetPath = join8(cwd, targetRel);
+    if (existsSync10(targetPath) && !opts.overwrite) {
+      if (fileMatchesSource(cwd, relPath, targetRel, source, opts.framework)) {
+        results.push({
+          path: targetRel,
+          status: "skipped",
+          reason: "already installed (identical)"
+        });
+      } else {
+        results.push({
+          path: targetRel,
+          status: "skipped",
+          reason: "already exists (use --overwrite to replace)"
+        });
+      }
+      continue;
+    }
+    const content = sourceContent(source, relPath, opts.framework);
+    mkdirSync3(dirname4(targetPath), { recursive: true });
+    writeFileSync3(targetPath, content, "utf-8");
+    results.push({ path: targetRel, status: "added" });
+  }
+  return results;
+}
+async function findFeatureFileConflicts(cwd, impl, framework) {
+  const source = await getComponentSource();
+  const conflicts = [];
+  for (const relPath of impl.files) {
+    const targetRel = toFeatureTargetPath(cwd, relPath, impl, framework);
+    if (existsSync10(join8(cwd, targetRel)) && !fileMatchesSource(cwd, relPath, targetRel, source, framework)) {
+      conflicts.push(targetRel);
+    }
+  }
+  return conflicts;
+}
+
+// src/lib/move-files.ts
+import { existsSync as existsSync11, mkdirSync as mkdirSync4, readFileSync as readFileSync7, readdirSync as readdirSync2, writeFileSync as writeFileSync4 } from "fs";
+import { dirname as dirname5, join as join9 } from "path";
+async function copyEntryToRepo(destRoot, entry, opts) {
+  const source = await getComponentSource();
+  const results = [];
+  for (const file of entry.files) {
+    results.push(writeRelPath(destRoot, file.path, source.readFile(file.path), entry.name, opts));
+  }
+  if (entry.controller) {
+    const controllerPath = findControllerPath(source, entry.controller);
+    if (!controllerPath) {
+      throw new Error(
+        `Could not find controller file for ${entry.name} (${entry.controller})`
+      );
+    }
+    results.push(
+      writeRelPath(
+        destRoot,
+        controllerPath,
+        source.readFile(controllerPath),
+        entry.controller,
+        opts
+      )
+    );
+    upsertControllerBarrel(destRoot, entry.controller, controllerPath, results);
+  }
+  return results;
+}
+async function mergeI18nIntoRepo(destRoot, keys) {
+  if (keys.length === 0) return { added: [] };
+  const messagesRoot = join9(destRoot, "messages");
+  const source = await getComponentSource();
+  const added = [];
+  for (const locale of ["en", "ar"]) {
+    const localeDir = join9(messagesRoot, locale);
+    const messages = source.readMessages(locale);
+    const namespaces = existsSync11(localeDir) ? readdirSync2(localeDir).filter((file) => file.endsWith(".json")).map((file) => file.replace(/\.json$/, "")) : [];
+    const grouped = {};
+    for (const key of keys) {
+      if (!(key in messages)) continue;
+      const ns = namespaceForKey(key, namespaces);
+      grouped[ns] ??= {};
+      grouped[ns][key] = messages[key];
+    }
+    for (const [ns, kvs] of Object.entries(grouped)) {
+      const filePath = join9(localeDir, `${ns}.json`);
+      const existing = existsSync11(filePath) ? JSON.parse(readFileSync7(filePath, "utf-8")) : { $schema: "https://inlang.com/schema/inlang-message-format" };
+      for (const [key, value] of Object.entries(kvs)) {
+        if (!(key in existing)) added.push(`${locale}/${ns}.json#${key}`);
+        existing[key] = value;
+      }
+      const schema = existing.$schema;
+      delete existing.$schema;
+      const sorted = Object.fromEntries(
+        Object.keys(existing).sort().map((key) => [key, existing[key]])
+      );
+      const out = schema ? { $schema: schema, ...sorted } : sorted;
+      mkdirSync4(dirname5(filePath), { recursive: true });
+      writeFileSync4(filePath, JSON.stringify(out, null, 2) + "\n", "utf-8");
+    }
+  }
+  return { added };
+}
+function writeRelPath(destRoot, relPath, content, entryName, opts) {
+  const targetPath = join9(destRoot, relPath);
+  if (existsSync11(targetPath) && !opts.overwrite) {
+    return {
+      entryName,
+      targetPath,
+      skipped: true,
+      reason: "already exists (use --overwrite to replace)"
+    };
+  }
+  mkdirSync4(dirname5(targetPath), { recursive: true });
+  writeFileSync4(targetPath, content, "utf-8");
+  return { entryName, targetPath, skipped: false };
+}
+function upsertControllerBarrel(destRoot, exportName, controllerPath, results) {
+  const barrelRel = "src/components/common/controllers/index.ts";
+  const barrelAbs = join9(destRoot, barrelRel);
+  const line = controllerBarrelExport(exportName, controllerPath);
+  const existing = existsSync11(barrelAbs) ? readFileSync7(barrelAbs, "utf-8") : "";
+  if (existing.includes(`export { ${exportName} }`)) return;
+  const next = existing.trimEnd() ? `${existing.replace(/\s*$/, "\n")}${line}
+` : `${line}
+`;
+  mkdirSync4(dirname5(barrelAbs), { recursive: true });
+  writeFileSync4(barrelAbs, next, "utf-8");
+  results.push({ entryName: exportName, targetPath: barrelAbs, skipped: false });
+}
+function namespaceForKey(key, namespaces) {
+  const existing = namespaces.filter((ns) => key === ns || key.startsWith(`${ns}_`)).sort((a, b) => b.length - a.length)[0];
+  if (existing) return existing;
+  const underscoreIndex = key.indexOf("_");
+  return underscoreIndex === -1 ? key : key.slice(0, underscoreIndex);
+}
+
+// src/commands/create.ts
+async function runCreateFeature(featureName, options) {
+  const { cwd } = options;
+  if (!featureName) {
+    console.error(pc2.red("Usage: composed-cli create feature <name> [--protected|--public]"));
+    process.exitCode = 1;
+    return;
+  }
+  if (options.protected && options.public) {
+    console.error(pc2.red("Pass either --protected or --public, not both."));
+    process.exitCode = 1;
+    return;
+  }
+  if (!existsSync12(cwd)) {
+    console.error(pc2.red(`Target directory does not exist: ${cwd}`));
+    process.exitCode = 1;
+    return;
+  }
+  const feature = await findFeature(featureName);
+  if (!feature) {
+    const available = await listFeatureNames();
+    console.error(pc2.red(`Feature "${featureName}" is not available in the boilerplate.`));
+    console.error("");
+    console.error(pc2.bold("Available features:"));
+    for (const name of available) console.error(pc2.dim(`  - ${name}`));
+    process.exitCode = 1;
+    return;
+  }
+  const detected = detectTargetFramework(cwd);
+  if (!detected) {
+    console.error(
+      pc2.red(
+        `Could not detect the target project's framework at ${cwd}. Expected to find a package.json with a recognizable framework dependency (e.g. "next" or "@tanstack/react-start"), or matching project structure.`
+      )
+    );
+    process.exitCode = 1;
+    return;
+  }
+  const impl = feature.frameworks[detected.framework];
+  if (!impl) {
+    const supported = supportedFrameworksFor(feature);
+    console.error(
+      pc2.red(
+        `Feature "${feature.name}" exists, but ${frameworkLabel(detected.framework)} is not currently supported for this feature.`
+      )
+    );
+    console.error("");
+    console.error(pc2.bold("Supported frameworks:"));
+    for (const fw of supported) console.error(pc2.dim(`  - ${frameworkLabel(fw)}`));
+    process.exitCode = 1;
+    return;
+  }
+  const requestedScope = options.protected ? "protected" : options.public ? "public" : void 0;
+  if (requestedScope && impl.routeScope && requestedScope !== impl.routeScope) {
+    console.error(
+      pc2.red(
+        `--${requestedScope} does not apply to "${feature.name}" for ${frameworkLabel(detected.framework)}: this implementation's route is fixed at "${impl.routeScope}".`
+      )
+    );
+    process.exitCode = 1;
+    return;
+  }
+  if (requestedScope && !impl.routeScope) {
+    console.error(
+      pc2.red(
+        `--${requestedScope} does not apply to "${feature.name}" for ${frameworkLabel(detected.framework)}: this implementation has no protected/public route distinction.`
+      )
+    );
+    process.exitCode = 1;
+    return;
+  }
+  console.log(pc2.dim(`Detected framework: ${frameworkLabel(detected.framework)} (${detected.reason})`));
+  const conflicts = await findFeatureFileConflicts(cwd, impl, detected.framework);
+  if (conflicts.length > 0 && !options.overwrite) {
+    console.error(
+      pc2.red(`Feature "${feature.name}" already exists \u2014 the following file(s) already have different content:`)
+    );
+    for (const conflict of conflicts) {
+      console.error(pc2.red(`  ${conflict}`));
+    }
+    console.error("");
+    console.error(pc2.dim("Pass --overwrite to replace them."));
+    process.exitCode = 1;
+    return;
+  }
+  if (conflicts.length > 0) {
+    console.log(pc2.yellow(`Overwriting ${conflicts.length} existing file(s).`));
+  }
+  console.log(pc2.bold(`\u2714 Feature: ${feature.name}`));
+  console.log(pc2.bold(`\u2714 Framework implementation: ${frameworkLabel(detected.framework)}`));
+  const copied = await installFeatureFiles(cwd, impl, {
+    overwrite: options.overwrite,
+    framework: detected.framework
+  });
+  for (const file of copied) {
+    if (file.status === "skipped") {
+      console.log(pc2.yellow(`  skip  ${file.path} (${file.reason})`));
+    } else {
+      console.log(pc2.green(`  add   ${toDisplayPath(cwd, `${cwd}/${file.path}`)}`));
+    }
+  }
+  if (detected.framework === "nextjs") {
+    const i18n = await installI18nStrings(cwd, impl.i18nKeys);
+    if (i18n.addedKeys.length > 0) {
+      console.log(pc2.green(`  add   ${i18n.path} (${i18n.addedKeys.length} key(s))`));
+    }
+  } else {
+    const i18n = await mergeI18nIntoRepo(cwd, impl.i18nKeys);
+    if (i18n.added.length > 0) {
+      console.log(pc2.green(`  add   messages/ (${i18n.added.length} key(s))`));
+    }
+  }
+  console.log("");
+  console.log(pc2.bold(pc2.green(`Done. Installed feature "${feature.name}" (${frameworkLabel(detected.framework)}) into ${cwd}.`)));
+  if (detected.framework === "tanstack") {
+    console.log(
+      pc2.dim(
+        "Restart `bun run dev` (or run a build) so paraglideVitePlugin regenerates src/paraglide/ with any new message keys."
+      )
+    );
+  }
+}
+
+// src/commands/move.ts
+import { existsSync as existsSync13, statSync as statSync2 } from "fs";
+import { resolve as resolve2 } from "path";
+import pc3 from "picocolors";
+async function runMove(queries, options) {
+  if (queries.length === 0) {
+    console.error(
+      pc3.red(
+        "Usage: composed-cli move <component-or-path> [--to <repo>]"
+      )
+    );
+    console.error("");
+    console.error("Pass a registry name (labeled-select) or a path like components/ui.");
+    console.error("Available components:");
+    for (const name of await allComponentNames()) console.error(`  ${name}`);
+    process.exitCode = 1;
+    return;
+  }
+  if (options.from) {
+    const fromRoot = resolve2(options.from);
+    if (!existsSync13(fromRoot) || !statSync2(fromRoot).isDirectory()) {
+      console.error(pc3.red(`Source is not a directory: ${fromRoot}`));
+      process.exitCode = 1;
+      return;
+    }
+    setSourceRoot(fromRoot);
+  }
+  const destRoot = resolve2(options.to);
+  if (!existsSync13(destRoot) || !statSync2(destRoot).isDirectory()) {
+    console.error(pc3.red(`Destination is not a directory: ${destRoot}`));
+    process.exitCode = 1;
+    return;
+  }
+  const sourceRoot = resolveSourceRoot();
+  if (sourceRoot && resolve2(sourceRoot) === destRoot) {
+    console.error(pc3.red("Source and destination are the same repository."));
+    console.error("Pass --to <other-repo>, for example:");
+    console.error(
+      pc3.cyan("  npx tsx cli/src/index.ts move src/components/ui --to M:\\my-next-app")
+    );
+    process.exitCode = 1;
+    return;
+  }
+  const { entries, extraFiles, notFound, ambiguous } = await resolveQueries(queries);
+  if (notFound.length > 0) {
+    console.error(pc3.red(`Unknown component(s): ${notFound.join(", ")}`));
+    console.error(
+      pc3.dim(
+        "Use a name like labeled-select, or a path like components/ui. No local boilerplate is required."
+      )
+    );
+  }
+  for (const [query, names] of Object.entries(ambiguous)) {
+    console.error(
+      pc3.red(
+        `"${query}" matches multiple components: ${names.join(", ")}. Use one of those exact names.`
+      )
+    );
+  }
+  if (entries.length === 0 && extraFiles.length === 0) {
+    process.exitCode = 1;
+    return;
+  }
+  if (!existsSync13(resolve2(destRoot, ".git"))) {
+    console.log(pc3.yellow(`Warning: ${destRoot} has no .git directory.`));
+  }
+  if (hasShadcnConfig(destRoot)) {
+    await runAdd(entries.length > 0 ? entries.map((e) => e.name) : queries, {
+      cwd: destRoot,
+      overwrite: options.overwrite,
+      skipShadcn: false,
+      skipNpm: false,
+      skipI18n: false,
+      extraFiles
+    });
+    return;
+  }
+  console.log(
+    pc3.bold(
+      `Moving into ${destRoot}: ${entries.length > 0 ? entries.map((e) => e.name).join(", ") : extraFiles.join(", ")}`
+    )
+  );
+  for (const entry of entries) {
+    const copied = await copyEntryToRepo(destRoot, entry, {
+      overwrite: options.overwrite
+    });
+    for (const file of copied) {
+      if (file.skipped) {
+        console.log(pc3.yellow(`  skip  ${toDisplayPath(destRoot, file.targetPath)} (${file.reason})`));
+      } else {
+        console.log(pc3.green(`  add   ${toDisplayPath(destRoot, file.targetPath)}`));
+      }
+    }
+  }
+  const extraCopied = await copyExtraFiles(destRoot, extraFiles, {
+    overwrite: options.overwrite,
+    useAliases: false
+  });
+  for (const file of extraCopied) {
+    if (file.skipped) {
+      console.log(pc3.yellow(`  skip  ${toDisplayPath(destRoot, file.targetPath)} (${file.reason})`));
+    } else {
+      console.log(pc3.green(`  add   ${toDisplayPath(destRoot, file.targetPath)}`));
+    }
+  }
+  const deps = unionDependencies(entries);
+  const i18n = await mergeI18nIntoRepo(destRoot, deps.i18nKeys);
+  if (i18n.added.length > 0) {
+    console.log(pc3.green(`  add   messages/ (${i18n.added.length} key(s))`));
+  }
+  const extraNote = extraFiles.length > 0 ? ` and ${extraFiles.length} primitive file(s)` : "";
+  console.log(
+    pc3.bold(
+      pc3.green(`
+Done. Copied ${entries.length} component(s)${extraNote} into ${destRoot}.`)
+    )
+  );
+}
+
+// src/index.ts
+var program = new Command();
+program.name("composed-cli").description(
+  "Install individual composed UI components from the BIM frontend boilerplate into a Next.js + shadcn project."
+).version("0.1.3");
+program.command("add").description("Add one or more composed components to the current project").argument(
+  "<components...>",
+  "component name(s), slug(s), or path(s) like labeled-select or components/ui"
+).option("-c, --cwd <path>", "target project directory", process.cwd()).option("-o, --overwrite", "overwrite files that already exist", false).option("--skip-shadcn", "do not run `shadcn add` for required primitives", false).option("--skip-npm", "do not install required npm packages", false).option("--skip-i18n", "do not generate the local i18n strings file", false).action(async (components, opts) => {
+  await runAdd(components, {
+    cwd: opts.cwd,
+    overwrite: opts.overwrite,
+    skipShadcn: opts.skipShadcn,
+    skipNpm: opts.skipNpm,
+    skipI18n: opts.skipI18n
+  });
+});
+program.command("move").description(
+  "Copy a composed component and its related files (controller, i18n) into another repository"
+).argument(
+  "<components...>",
+  "component name(s), slug(s), or path(s) like labeled-select or components/ui"
+).option("-t, --to <path>", "destination repository path", process.cwd()).option(
+  "-f, --from <path>",
+  "source boilerplate repository (optional; the published package uses its bundled registry)"
+).option("-o, --overwrite", "overwrite files that already exist", false).action(async (components, opts) => {
+  await runMove(components, {
+    to: opts.to,
+    from: opts.from,
+    overwrite: opts.overwrite
+  });
+});
+var create = program.command("create").description(
+  "Install a feature that already exists in the boilerplate into a target project"
+).addHelpText(
+  "after",
+  `
+The boilerplate is the single source of truth for which features exist. This
+does not generate arbitrary/new features \u2014 it installs an existing, registered
+boilerplate feature's real files into a target project, in the implementation
+that matches the target project's own framework.
+
+  Boilerplate -> Feature Registry -> Feature -> Framework Implementation -> Target Project
+
+See \`composed-cli create feature --help\` for the feature installer.`
+);
+create.command("feature").description(
+  "Install an existing boilerplate feature (route, screen, API layer, translations) into a target project, using the implementation registered for that project's detected framework."
+).argument("<name>", "registered feature name, e.g. login, dashboard, about, contact").option("-c, --cwd <path>", "target project directory", process.cwd()).option("--protected", "require/assert the protected-route implementation").option("--public", "require/assert the public-route implementation").option("-o, --overwrite", "overwrite files that already exist", false).addHelpText(
+  "after",
+  `
+The target project's framework is detected automatically (package.json
+dependencies, then project structure) \u2014 it does not need to be a copy of this
+boilerplate. Only frameworks with a registered implementation for the
+requested feature are supported; run the command to see the registry's error
+message list available features or supported frameworks.
+
+--protected / --public are validated against the resolved implementation's
+own route scope (e.g. dashboard is always protected, about is always public)
+rather than choosing it \u2014 pass one only to assert the scope you expect;
+omit both to just install whatever the registry defines.
+
+Examples:
+  $ composed-cli create feature login
+  $ composed-cli create feature dashboard
+  $ composed-cli create feature login --cwd ./next-app
+  $ composed-cli create feature dashboard --cwd ./tanstack-app
+  $ composed-cli create feature login --overwrite
+
+Behavior:
+  - Unknown feature name -> rejected, lists available features.
+   - Feature exists but no implementation for the detected framework -> rejected, lists supported frameworks.
+   - Next.js targets install App Router pages from cli/templates/nextjs/ and rewrite Paraglide to @/lib/composed-strings.
+  - Every target file is checked for conflicts before anything is written; existing files are reported and left untouched unless --overwrite is passed.
+  - Files are copied byte-for-byte from the boilerplate's real source tree \u2014 nothing is templated or invented.
+  - Translation keys are merged into the target's messages/<locale>/*.json when that folder exists; skipped otherwise.`
+).action(async (name, opts) => {
+  await runCreateFeature(name, {
+    cwd: opts.cwd,
+    protected: opts.protected ?? false,
+    public: opts.public ?? false,
+    overwrite: opts.overwrite
+  });
+});
+program.parseAsync(process.argv);