@organcli/composed-cli 0.1.0

package/dist/index.js

@@ -0,0 +1,540 @@
+#!/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/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,
+    readFile: (path) => {
+      const content = bundle.files[path];
+      if (content === void 0) {
+        throw new Error(`registry-bundle.json is missing file: ${path}`);
+      }
+      return content;
+    },
+    readMessages: (locale) => bundle.messages[locale] ?? {}
+  };
+}
+async function loadFromBoilerplateTree() {
+  const boilerplateRoot = findAncestorContaining(
+    here,
+    join("src", "registry", "components.ts")
+  );
+  if (!boilerplateRoot) return void 0;
+  const registryPath = join(boilerplateRoot, "src", "registry", "components.ts");
+  const mod = await import(
+    /* @vite-ignore */
+    pathToFileURL(registryPath).href
+  );
+  return {
+    registry: mod.componentRegistry,
+    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");
+    },
+    readMessages: (locale) => readMessagesFromTree(boilerplateRoot, locale)
+  };
+}
+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 namespace = file.replace(/\.json$/, "");
+    const json = JSON.parse(readFileSync(join(dir, file), "utf-8"));
+    for (const [key, value] of Object.entries(json)) {
+      if (key === "$schema") continue;
+      out[`${namespace}_${key}`] = String(value);
+    }
+  }
+  return out;
+}
+var cached;
+async function getComponentSource() {
+  if (cached) return cached;
+  const source = 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 });
+  }
+  return results;
+}
+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/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 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})`);
+}
+
+// src/lib/shadcn.ts
+import { existsSync as existsSync6 } from "fs";
+import { join as join6 } from "path";
+import { spawnSync as spawnSync2 } from "child_process";
+function hasShadcnConfig(cwd) {
+  return existsSync6(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 existsSync7, readFileSync as readFileSync4 } from "fs";
+function validateCopiedFiles(files) {
+  const issues = [];
+  for (const file of files) {
+    if (!existsSync7(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/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.0");
+program.command("add").description("Add one or more composed components to the current project").argument("<components...>", "component name(s) or slug(s), e.g. select dialog table").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.parseAsync(process.argv);