@carefully-built/cli 0.1.0 → 0.1.1

package/README.md

@@ -1,23 +1,143 @@
 # @carefully-built/cli
 
-CLI for adding Carefully Built components to apps as editable source code.
+![Carefully Built CLI hero](./assets/hero.png)
 
-## Usage
+Bring Carefully Built SaaS components into a React app in the form that fits the job: import the maintained package when you want upgrades, or eject the source when a component needs to become part of the product.
+
+The CLI is the editable-source side of the Carefully Built SaaS Kit. It copies registry components into your app using the same mental model as shadcn: the code lands in your repository, keeps normal imports such as `@/lib/utils`, and can be changed without waiting for a package release.
+
+## Two Ways To Use The Kit
+
+### 1. Managed Package Imports
+
+Use package imports when the component should stay shared and receive fixes through npm updates.
+
+```bash
+bun add @carefully-built/ui
+```
+
+```tsx
+import { Button, SmartTable, TableToolbar } from "@carefully-built/ui";
+```
+
+This is the best default for stable primitives, CRUD helpers, table controls, layout shells, and shared SaaS behavior that should remain consistent across apps.
+
+### 2. Editable Source With The CLI
+
+Use the CLI when a component needs to become local code.
+
+```bash
+bunx @carefully-built/cli add button
+```
+
+The CLI reads common shadcn project conventions. If your app uses `components.json` aliases and `tsconfig.json` paths like `@/* -> ./src/*`, files are copied into `src/components/ui` and `src/lib`. Without those conventions, files are copied to root-level `components/ui` and `lib`.
+
+## Install And Commands
+
+You can run it without installing:
 
 ```bash
 bunx @carefully-built/cli list
 bunx @carefully-built/cli add button
 ```
 
-Use `--overwrite` to replace existing files:
+Or with npm:
+
+```bash
+npx @carefully-built/cli list
+npx @carefully-built/cli add button
+```
+
+Replace existing local files only when you ask for it:
 
 ```bash
 bunx @carefully-built/cli add button --overwrite
 ```
 
-The first registry entry copies:
+## What Gets Copied
+
+The first registry entry is intentionally small:
+
+```txt
+button
+├─ components/ui/button.tsx
+└─ lib/utils.ts
+```
+
+In a `src` app with shadcn aliases, that becomes:
+
+```txt
+button
+├─ src/components/ui/button.tsx
+└─ src/lib/utils.ts
+```
+
+The copied `Button` uses:
 
-- `components/ui/button.tsx`
-- `lib/utils.ts`
+- `class-variance-authority`
+- `clsx`
+- `tailwind-merge`
+- `react`
+- `radix-ui`
 
-Install the printed dependencies in the target app if they are not already present.
+The CLI prints dependency hints after copying. Install anything your app does not already provide.
+
+## When To Import vs Eject
+
+Import from `@carefully-built/ui` when:
+
+- you want package updates and bug fixes without owning the source
+- the component is generic enough to stay shared
+- app-specific behavior can be passed through props, `className`, slots, or `classes`
+
+Use `@carefully-built/cli add` when:
+
+- the component is about to become product-specific
+- design or behavior needs local edits
+- you want to inspect and own every line in the consuming app
+- the component should follow the same source-control workflow as the rest of the app
+
+## Current Registry
+
+```bash
+bunx @carefully-built/cli list
+```
+
+Available now:
+
+- `button`
+
+More registry entries should be added deliberately, starting with low-risk primitives and then moving toward composed SaaS surfaces such as tables, toolbars, forms, and shells.
+
+## Project Assumptions
+
+The generated components assume a modern React app with:
+
+- React 18 or 19
+- TypeScript
+- Tailwind-compatible design tokens such as `bg-primary`, `text-primary-foreground`, `border`, `ring`, and `muted`
+- an alias for `@/lib/utils`, or a project structure where the CLI can resolve that alias through `components.json` and `tsconfig.json`
+
+## Development
+
+From the monorepo root:
+
+```bash
+bun install
+bun run --cwd packages/cli test
+bun run --cwd packages/cli typecheck
+bun run --cwd packages/cli build
+```
+
+Before publishing:
+
+```bash
+cd packages/cli
+npm publish --dry-run --access public
+```
+
+Publish:
+
+```bash
+npm publish --access public
+```

package/dist/index.mjs

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import { constants, readFileSync } from "node:fs";
-import { access, copyFile, mkdir } from "node:fs/promises";
-import { dirname, join } from "node:path";
+import { access, copyFile, mkdir, readFile } from "node:fs/promises";
+import { dirname, join, normalize } from "node:path";
 import { fileURLToPath } from "node:url";
 
 //#region src/registry.ts
@@ -31,17 +31,19 @@ async function addComponent({ componentName, cwd, overwrite }) {
 	const created = [];
 	const overwritten = [];
 	const skipped = [];
+	const projectConfig = await readProjectConfig(cwd);
 	for (const file of component.files) {
-		const targetPath = join(cwd, file.target);
+		const target = resolveTargetPath(file.target, projectConfig);
+		const targetPath = join(cwd, target);
 		const exists = await fileExists(targetPath);
 		if (exists && !overwrite) {
-			skipped.push(file.target);
+			skipped.push(target);
 			continue;
 		}
 		await mkdir(dirname(targetPath), { recursive: true });
 		await copyFile(file.source, targetPath);
-		if (exists) overwritten.push(file.target);
-		else created.push(file.target);
+		if (exists) overwritten.push(target);
+		else created.push(target);
 	}
 	return {
 		componentName: component.name,
@@ -60,6 +62,61 @@ async function fileExists(path) {
 		return false;
 	}
 }
+async function readProjectConfig(cwd) {
+	const [componentsJson, tsconfigJson] = await Promise.all([readJsonFile(join(cwd, "components.json")), readJsonFile(join(cwd, "tsconfig.json"))]);
+	return {
+		uiAlias: readString(componentsJson, ["aliases", "ui"]),
+		utilsAlias: readString(componentsJson, ["aliases", "utils"]),
+		...readPrimaryTsconfigAlias(tsconfigJson)
+	};
+}
+function resolveTargetPath(target, config) {
+	if (target === "lib/utils.ts" && config.utilsAlias) return resolveAliasPath(`${config.utilsAlias}.ts`, config);
+	if (target.startsWith("components/ui/") && config.uiAlias) {
+		const fileName = target.slice(14);
+		return resolveAliasPath(`${config.uiAlias}/${fileName}`, config);
+	}
+	return target;
+}
+function resolveAliasPath(path, config) {
+	if (config.aliasPrefix && config.aliasTarget && path.startsWith(config.aliasPrefix)) return cleanPath(path.replace(config.aliasPrefix, config.aliasTarget));
+	if (path.startsWith("@/")) return cleanPath(path.slice(2));
+	return cleanPath(path);
+}
+function readPrimaryTsconfigAlias(value) {
+	const aliasTarget = readArray(readRecord(readRecord(value, "compilerOptions"), "paths"), "@/*").find((entry) => typeof entry === "string");
+	if (typeof aliasTarget !== "string") return {};
+	return {
+		aliasPrefix: "@/",
+		aliasTarget: aliasTarget.replace(/\/\*$/, "/")
+	};
+}
+async function readJsonFile(path) {
+	try {
+		return JSON.parse(stripJsonComments(await readFile(path, "utf8")));
+	} catch {
+		return;
+	}
+}
+function stripJsonComments(source) {
+	return source.replace(/^\s*\/\/.*$/gm, "");
+}
+function readString(value, path) {
+	let current = value;
+	for (const key of path) current = readRecord(current, key);
+	return typeof current === "string" ? current : void 0;
+}
+function readRecord(value, key) {
+	if (!value || typeof value !== "object") return;
+	return value[key];
+}
+function readArray(value, key) {
+	const array = readRecord(value, key);
+	return Array.isArray(array) ? array : [];
+}
+function cleanPath(path) {
+	return normalize(path).replace(/^\.\//, "");
+}
 
 //#endregion
 //#region src/index.ts

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","names":["created: string[]","overwritten: string[]","skipped: string[]"],"sources":["../src/registry.ts","../src/add.ts","../src/index.ts"],"sourcesContent":["import { readFileSync } from \"node:fs\";\nimport { dirname, join } from \"node:path\";\nimport { fileURLToPath } from \"node:url\";\n\nexport interface RegistryFile {\n  readonly source: string;\n  readonly target: string;\n}\n\nexport interface RegistryComponent {\n  readonly name: string;\n  readonly description: string;\n  readonly dependencies: readonly string[];\n  readonly peerDependencies: readonly string[];\n  readonly files: readonly RegistryFile[];\n}\n\nconst packageRoot = join(dirname(fileURLToPath(import.meta.url)), \"..\");\nconst registryRoot = join(packageRoot, \"registry\");\nconst componentNames = [\"button\"] as const;\n\nexport function listRegistryComponents(): string[] {\n  return [...componentNames];\n}\n\nexport function getRegistryComponent(\n  componentName: string,\n): RegistryComponent | undefined {\n  if (!componentNames.includes(componentName as (typeof componentNames)[number])) {\n    return undefined;\n  }\n\n  const manifestPath = join(registryRoot, \"ui\", componentName, \"manifest.json\");\n  const manifest = JSON.parse(readFileSync(manifestPath, \"utf8\")) as Omit<\n    RegistryComponent,\n    \"files\"\n  > & {\n    files: readonly RegistryFile[];\n  };\n\n  return {\n    ...manifest,\n    files: manifest.files.map((file) => ({\n      ...file,\n      source: join(registryRoot, \"ui\", componentName, file.source),\n    })),\n  };\n}\n","import { constants } from \"node:fs\";\nimport { access, copyFile, mkdir } from \"node:fs/promises\";\nimport { dirname, join } from \"node:path\";\n\nimport { getRegistryComponent } from \"./registry\";\n\nexport interface AddComponentOptions {\n  readonly componentName: string;\n  readonly cwd: string;\n  readonly overwrite: boolean;\n}\n\nexport interface AddComponentResult {\n  readonly componentName: string;\n  readonly created: string[];\n  readonly overwritten: string[];\n  readonly skipped: string[];\n  readonly dependencies: readonly string[];\n  readonly peerDependencies: readonly string[];\n}\n\nexport async function addComponent({\n  componentName,\n  cwd,\n  overwrite,\n}: AddComponentOptions): Promise<AddComponentResult> {\n  const component = getRegistryComponent(componentName);\n\n  if (!component) {\n    throw new Error(`Unknown component \"${componentName}\"`);\n  }\n\n  const created: string[] = [];\n  const overwritten: string[] = [];\n  const skipped: string[] = [];\n\n  for (const file of component.files) {\n    const targetPath = join(cwd, file.target);\n    const exists = await fileExists(targetPath);\n\n    if (exists && !overwrite) {\n      skipped.push(file.target);\n      continue;\n    }\n\n    await mkdir(dirname(targetPath), { recursive: true });\n    await copyFile(file.source, targetPath);\n\n    if (exists) {\n      overwritten.push(file.target);\n    } else {\n      created.push(file.target);\n    }\n  }\n\n  return {\n    componentName: component.name,\n    created,\n    overwritten,\n    skipped,\n    dependencies: component.dependencies,\n    peerDependencies: component.peerDependencies,\n  };\n}\n\nasync function fileExists(path: string): Promise<boolean> {\n  try {\n    await access(path, constants.F_OK);\n    return true;\n  } catch {\n    return false;\n  }\n}\n","#!/usr/bin/env node\nimport { addComponent } from \"./add\";\nimport { listRegistryComponents } from \"./registry\";\n\ninterface ParsedArgs {\n  readonly command?: string;\n  readonly componentName?: string;\n  readonly overwrite: boolean;\n  readonly help: boolean;\n}\n\nexport async function runCli(argv = process.argv.slice(2)): Promise<void> {\n  const args = parseArgs(argv);\n\n  if (args.help || !args.command) {\n    printHelp();\n    return;\n  }\n\n  if (args.command === \"list\") {\n    for (const componentName of listRegistryComponents()) {\n      console.log(componentName);\n    }\n    return;\n  }\n\n  if (args.command === \"add\") {\n    if (!args.componentName) {\n      throw new Error(\"Missing component name. Example: carefully-built add button\");\n    }\n\n    const result = await addComponent({\n      componentName: args.componentName,\n      cwd: process.cwd(),\n      overwrite: args.overwrite,\n    });\n\n    printAddResult(result);\n    return;\n  }\n\n  throw new Error(`Unknown command \"${args.command}\"`);\n}\n\nfunction parseArgs(argv: readonly string[]): ParsedArgs {\n  return {\n    command: argv[0],\n    componentName: argv[1]?.startsWith(\"-\") ? undefined : argv[1],\n    overwrite: argv.includes(\"--overwrite\"),\n    help: argv.includes(\"--help\") || argv.includes(\"-h\"),\n  };\n}\n\nfunction printHelp(): void {\n  console.log(`carefully-built\n\nUsage:\n  carefully-built list\n  carefully-built add <component> [--overwrite]\n\nComponents:\n  ${listRegistryComponents().join(\", \")}\n`);\n}\n\nfunction printAddResult(result: Awaited<ReturnType<typeof addComponent>>): void {\n  for (const file of result.created) {\n    console.log(`created ${file}`);\n  }\n  for (const file of result.overwritten) {\n    console.log(`overwrote ${file}`);\n  }\n  for (const file of result.skipped) {\n    console.log(`skipped ${file}`);\n  }\n\n  if (result.dependencies.length > 0) {\n    console.log(`dependencies: ${result.dependencies.join(\", \")}`);\n  }\n  if (result.peerDependencies.length > 0) {\n    console.log(`peer dependencies: ${result.peerDependencies.join(\", \")}`);\n  }\n}\n\nrunCli().catch((error: unknown) => {\n  const message = error instanceof Error ? error.message : String(error);\n  console.error(message);\n  process.exitCode = 1;\n});\n"],"mappings":"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"}
+{"version":3,"file":"index.mjs","names":["created: string[]","overwritten: string[]","skipped: string[]"],"sources":["../src/registry.ts","../src/add.ts","../src/index.ts"],"sourcesContent":["import { readFileSync } from \"node:fs\";\nimport { dirname, join } from \"node:path\";\nimport { fileURLToPath } from \"node:url\";\n\nexport interface RegistryFile {\n  readonly source: string;\n  readonly target: string;\n}\n\nexport interface RegistryComponent {\n  readonly name: string;\n  readonly description: string;\n  readonly dependencies: readonly string[];\n  readonly peerDependencies: readonly string[];\n  readonly files: readonly RegistryFile[];\n}\n\nconst packageRoot = join(dirname(fileURLToPath(import.meta.url)), \"..\");\nconst registryRoot = join(packageRoot, \"registry\");\nconst componentNames = [\"button\"] as const;\n\nexport function listRegistryComponents(): string[] {\n  return [...componentNames];\n}\n\nexport function getRegistryComponent(\n  componentName: string,\n): RegistryComponent | undefined {\n  if (!componentNames.includes(componentName as (typeof componentNames)[number])) {\n    return undefined;\n  }\n\n  const manifestPath = join(registryRoot, \"ui\", componentName, \"manifest.json\");\n  const manifest = JSON.parse(readFileSync(manifestPath, \"utf8\")) as Omit<\n    RegistryComponent,\n    \"files\"\n  > & {\n    files: readonly RegistryFile[];\n  };\n\n  return {\n    ...manifest,\n    files: manifest.files.map((file) => ({\n      ...file,\n      source: join(registryRoot, \"ui\", componentName, file.source),\n    })),\n  };\n}\n","import { constants } from \"node:fs\";\nimport { access, copyFile, mkdir, readFile } from \"node:fs/promises\";\nimport { dirname, join, normalize } from \"node:path\";\n\nimport { getRegistryComponent } from \"./registry\";\n\nexport interface AddComponentOptions {\n  readonly componentName: string;\n  readonly cwd: string;\n  readonly overwrite: boolean;\n}\n\nexport interface AddComponentResult {\n  readonly componentName: string;\n  readonly created: string[];\n  readonly overwritten: string[];\n  readonly skipped: string[];\n  readonly dependencies: readonly string[];\n  readonly peerDependencies: readonly string[];\n}\n\nexport async function addComponent({\n  componentName,\n  cwd,\n  overwrite,\n}: AddComponentOptions): Promise<AddComponentResult> {\n  const component = getRegistryComponent(componentName);\n\n  if (!component) {\n    throw new Error(`Unknown component \"${componentName}\"`);\n  }\n\n  const created: string[] = [];\n  const overwritten: string[] = [];\n  const skipped: string[] = [];\n  const projectConfig = await readProjectConfig(cwd);\n\n  for (const file of component.files) {\n    const target = resolveTargetPath(file.target, projectConfig);\n    const targetPath = join(cwd, target);\n    const exists = await fileExists(targetPath);\n\n    if (exists && !overwrite) {\n      skipped.push(target);\n      continue;\n    }\n\n    await mkdir(dirname(targetPath), { recursive: true });\n    await copyFile(file.source, targetPath);\n\n    if (exists) {\n      overwritten.push(target);\n    } else {\n      created.push(target);\n    }\n  }\n\n  return {\n    componentName: component.name,\n    created,\n    overwritten,\n    skipped,\n    dependencies: component.dependencies,\n    peerDependencies: component.peerDependencies,\n  };\n}\n\nasync function fileExists(path: string): Promise<boolean> {\n  try {\n    await access(path, constants.F_OK);\n    return true;\n  } catch {\n    return false;\n  }\n}\n\ninterface ProjectConfig {\n  readonly uiAlias?: string;\n  readonly utilsAlias?: string;\n  readonly aliasPrefix?: string;\n  readonly aliasTarget?: string;\n}\n\nasync function readProjectConfig(cwd: string): Promise<ProjectConfig> {\n  const [componentsJson, tsconfigJson] = await Promise.all([\n    readJsonFile(join(cwd, \"components.json\")),\n    readJsonFile(join(cwd, \"tsconfig.json\")),\n  ]);\n\n  return {\n    uiAlias: readString(componentsJson, [\"aliases\", \"ui\"]),\n    utilsAlias: readString(componentsJson, [\"aliases\", \"utils\"]),\n    ...readPrimaryTsconfigAlias(tsconfigJson),\n  };\n}\n\nfunction resolveTargetPath(target: string, config: ProjectConfig): string {\n  if (target === \"lib/utils.ts\" && config.utilsAlias) {\n    return resolveAliasPath(`${config.utilsAlias}.ts`, config);\n  }\n\n  if (target.startsWith(\"components/ui/\") && config.uiAlias) {\n    const fileName = target.slice(\"components/ui/\".length);\n    return resolveAliasPath(`${config.uiAlias}/${fileName}`, config);\n  }\n\n  return target;\n}\n\nfunction resolveAliasPath(path: string, config: ProjectConfig): string {\n  if (\n    config.aliasPrefix &&\n    config.aliasTarget &&\n    path.startsWith(config.aliasPrefix)\n  ) {\n    return cleanPath(path.replace(config.aliasPrefix, config.aliasTarget));\n  }\n\n  if (path.startsWith(\"@/\")) {\n    return cleanPath(path.slice(2));\n  }\n\n  return cleanPath(path);\n}\n\nfunction readPrimaryTsconfigAlias(value: unknown): Pick<\n  ProjectConfig,\n  \"aliasPrefix\" | \"aliasTarget\"\n> {\n  const paths = readRecord(readRecord(value, \"compilerOptions\"), \"paths\");\n  const aliasTargets = readArray(paths, \"@/*\");\n  const aliasTarget = aliasTargets.find((entry) => typeof entry === \"string\");\n\n  if (typeof aliasTarget !== \"string\") {\n    return {};\n  }\n\n  return {\n    aliasPrefix: \"@/\",\n    aliasTarget: aliasTarget.replace(/\\/\\*$/, \"/\"),\n  };\n}\n\nasync function readJsonFile(path: string): Promise<unknown> {\n  try {\n    return JSON.parse(stripJsonComments(await readFile(path, \"utf8\")));\n  } catch {\n    return undefined;\n  }\n}\n\nfunction stripJsonComments(source: string): string {\n  return source.replace(/^\\s*\\/\\/.*$/gm, \"\");\n}\n\nfunction readString(value: unknown, path: readonly string[]): string | undefined {\n  let current = value;\n\n  for (const key of path) {\n    current = readRecord(current, key);\n  }\n\n  return typeof current === \"string\" ? current : undefined;\n}\n\nfunction readRecord(value: unknown, key: string): unknown {\n  if (!value || typeof value !== \"object\") {\n    return undefined;\n  }\n\n  return (value as Record<string, unknown>)[key];\n}\n\nfunction readArray(value: unknown, key: string): unknown[] {\n  const array = readRecord(value, key);\n  return Array.isArray(array) ? array : [];\n}\n\nfunction cleanPath(path: string): string {\n  return normalize(path).replace(/^\\.\\//, \"\");\n}\n","#!/usr/bin/env node\nimport { addComponent } from \"./add\";\nimport { listRegistryComponents } from \"./registry\";\n\ninterface ParsedArgs {\n  readonly command?: string;\n  readonly componentName?: string;\n  readonly overwrite: boolean;\n  readonly help: boolean;\n}\n\nexport async function runCli(argv = process.argv.slice(2)): Promise<void> {\n  const args = parseArgs(argv);\n\n  if (args.help || !args.command) {\n    printHelp();\n    return;\n  }\n\n  if (args.command === \"list\") {\n    for (const componentName of listRegistryComponents()) {\n      console.log(componentName);\n    }\n    return;\n  }\n\n  if (args.command === \"add\") {\n    if (!args.componentName) {\n      throw new Error(\"Missing component name. Example: carefully-built add button\");\n    }\n\n    const result = await addComponent({\n      componentName: args.componentName,\n      cwd: process.cwd(),\n      overwrite: args.overwrite,\n    });\n\n    printAddResult(result);\n    return;\n  }\n\n  throw new Error(`Unknown command \"${args.command}\"`);\n}\n\nfunction parseArgs(argv: readonly string[]): ParsedArgs {\n  return {\n    command: argv[0],\n    componentName: argv[1]?.startsWith(\"-\") ? undefined : argv[1],\n    overwrite: argv.includes(\"--overwrite\"),\n    help: argv.includes(\"--help\") || argv.includes(\"-h\"),\n  };\n}\n\nfunction printHelp(): void {\n  console.log(`carefully-built\n\nUsage:\n  carefully-built list\n  carefully-built add <component> [--overwrite]\n\nComponents:\n  ${listRegistryComponents().join(\", \")}\n`);\n}\n\nfunction printAddResult(result: Awaited<ReturnType<typeof addComponent>>): void {\n  for (const file of result.created) {\n    console.log(`created ${file}`);\n  }\n  for (const file of result.overwritten) {\n    console.log(`overwrote ${file}`);\n  }\n  for (const file of result.skipped) {\n    console.log(`skipped ${file}`);\n  }\n\n  if (result.dependencies.length > 0) {\n    console.log(`dependencies: ${result.dependencies.join(\", \")}`);\n  }\n  if (result.peerDependencies.length > 0) {\n    console.log(`peer dependencies: ${result.peerDependencies.join(\", \")}`);\n  }\n}\n\nrunCli().catch((error: unknown) => {\n  const message = error instanceof Error ? error.message : String(error);\n  console.error(message);\n  process.exitCode = 1;\n});\n"],"mappings":"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"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@carefully-built/cli",
-  "version": "0.1.0",
-  "description": "CLI for adding Carefully Built components to apps.",
+  "version": "0.1.1",
+  "description": "Add Carefully Built SaaS components to apps as editable source, with package imports when you want managed upgrades.",
   "type": "module",
   "license": "MIT",
   "author": "Alessandro Dodi",
@@ -25,6 +25,7 @@
     "carefully-built": "dist/index.mjs"
   },
   "files": [
+    "assets",
     "dist",
     "registry",
     "README.md"