@carefully-built/cli 0.1.0 → 0.1.2

package/README.md

@@ -1,23 +1,164 @@
 # @carefully-built/cli
 
-CLI for adding Carefully Built components to apps as editable source code.
+Carefully Built SaaS Kit is meant to be used in two complementary ways:
 
-## Usage
+1. **Managed package imports** from packages such as `@carefully-built/ui` when you want shared, upgradeable components.
+2. **Editable source ejection** with this CLI when a component needs to become local app code.
+
+The CLI does not replace the package imports. It gives you the shadcn-style path for the same Carefully Built components.
+
+## Component Previews
+
+<img src="https://raw.githubusercontent.com/AlessandroDodi/carefully-built-saas-kit/main/docs/saas-kit/images/smarttable.png" alt="Smart Table" width="360" />
+<img src="https://raw.githubusercontent.com/AlessandroDodi/carefully-built-saas-kit/main/docs/saas-kit/images/responsivesheet.png" alt="Responsive Sheet" width="360" />
+<img src="https://raw.githubusercontent.com/AlessandroDodi/carefully-built-saas-kit/main/docs/saas-kit/images/kanban.png" alt="Kanban" width="360" />
+<img src="https://raw.githubusercontent.com/AlessandroDodi/carefully-built-saas-kit/main/docs/saas-kit/images/charts.png" alt="Charts" width="360" />
+<img src="https://raw.githubusercontent.com/AlessandroDodi/carefully-built-saas-kit/main/docs/saas-kit/images/notifications.png" alt="Notifications" width="360" />
+<img src="https://raw.githubusercontent.com/AlessandroDodi/carefully-built-saas-kit/main/docs/saas-kit/images/search.png" alt="Search" width="360" />
+<img src="https://raw.githubusercontent.com/AlessandroDodi/carefully-built-saas-kit/main/docs/saas-kit/images/calendar.png" alt="Calendar" width="360" />
+<img src="https://raw.githubusercontent.com/AlessandroDodi/carefully-built-saas-kit/main/docs/saas-kit/images/maps.png" alt="Maps" width="360" />
+<img src="https://raw.githubusercontent.com/AlessandroDodi/carefully-built-saas-kit/main/docs/saas-kit/images/superadmin.png" alt="Superadmin" width="360" />
+<img src="https://raw.githubusercontent.com/AlessandroDodi/carefully-built-saas-kit/main/docs/saas-kit/images/widgets.png" alt="Widgets" width="360" />
+<img src="https://raw.githubusercontent.com/AlessandroDodi/carefully-built-saas-kit/main/docs/saas-kit/images/file-dropper.png" alt="Files" width="360" />
+<img src="https://raw.githubusercontent.com/AlessandroDodi/carefully-built-saas-kit/main/docs/saas-kit/images/theme-switcher.png" alt="Theme" width="360" />
+
+## Managed Package Imports
+
+Use package imports when you want the kit to stay shared and receive fixes through npm updates.
+
+```bash
+bun add @carefully-built/ui
+```
+
+```tsx
+import { Button, SmartTable, TableToolbar, ResponsiveSheet } from "@carefully-built/ui";
+```
+
+This mode is the default for stable primitives, CRUD surfaces, tables, overlays, hooks, and utilities that should remain consistent across apps.
+
+## Editable Source With The CLI
+
+Use the CLI when a component should become local code that you can edit directly.
 
 ```bash
 bunx @carefully-built/cli list
 bunx @carefully-built/cli add button
+bunx @carefully-built/cli add smart-table
+bunx @carefully-built/cli add responsive-sheet
 ```
 
-Use `--overwrite` to replace existing files:
+The CLI copies the component source and its local dependency closure into your app. It preserves normal app imports such as `@/components/ui/button` and `@/lib/utils`.
+
+It reads common shadcn project conventions:
+
+- `components.json` aliases such as `ui: "@/components/ui"` and `utils: "@/lib/utils"`
+- `tsconfig.json` paths such as `@/* -> ./src/*`
+
+So a `src` app receives files under `src/components/ui` and `src/lib`; a root-style app receives files under `components/ui` and `lib`.
+
+Use `--overwrite` only when replacing local files intentionally:
 
 ```bash
 bunx @carefully-built/cli add button --overwrite
 ```
 
-The first registry entry copies:
+## Full Registry
+
+Every public UI module exported by `@carefully-built/ui` is available through the CLI registry.
 
-- `components/ui/button.tsx`
-- `lib/utils.ts`
+| Registry entry | Managed import | Editable source |
+|---|---|---|
+| `avatar` | `import { Avatar, AvatarFallback, AvatarImage } from "@carefully-built/ui"` | `bunx @carefully-built/cli add avatar` |
+| `button` | `import { Button, ButtonSize, ButtonVariant, buttonVariants } from "@carefully-built/ui"` | `bunx @carefully-built/cli add button` |
+| `calendar` | `import { Calendar } from "@carefully-built/ui"` | `bunx @carefully-built/cli add calendar` |
+| `card` | `import { Card, CardContent, CardDescription, CardFooter, CardHeader, CardTitle } from "@carefully-built/ui"` | `bunx @carefully-built/cli add card` |
+| `chip` | `import { Chip, ChipButton } from "@carefully-built/ui"` | `bunx @carefully-built/cli add chip` |
+| `chip-utils` | `import { CHIP_CLASS_NAMES, ChipSize, getChipClassName } from "@carefully-built/ui"` | `bunx @carefully-built/cli add chip-utils` |
+| `date-display` | `import { DateDisplayValue, formatAbsoluteDate, formatDisplayDate } from "@carefully-built/ui"` | `bunx @carefully-built/cli add date-display` |
+| `dialog` | `import { Dialog, DialogContent, DialogDescription, DialogFooter, DialogHeader, DialogOverlay } from "@carefully-built/ui"` | `bunx @carefully-built/cli add dialog` |
+| `display-date` | `import { DisplayDate } from "@carefully-built/ui"` | `bunx @carefully-built/cli add display-date` |
+| `drawer` | `import { Drawer, DrawerContent, DrawerDescription, DrawerHeader, DrawerOverlay, DrawerPortal } from "@carefully-built/ui"` | `bunx @carefully-built/cli add drawer` |
+| `dropdown-menu` | `import { DropdownMenu, DropdownMenuCheckboxItem, DropdownMenuContent, DropdownMenuItem, DropdownMenuLabel, DropdownMenuSeparator } from "@carefully-built/ui"` | `bunx @carefully-built/cli add dropdown-menu` |
+| `empty-state` | `import { CollectionEmptyState, EmptyStateCard, InitialEmptyState, NoResultsState, ResolveCollectionEmptyStateOptions, resolveCollectionEmptyState } from "@carefully-built/ui"` | `bunx @carefully-built/cli add empty-state` |
+| `error-page` | `import { ErrorCode, ErrorPageContent, ErrorPageKind, PostHogErrorCapturePayload, ResolveErrorPageContentOptions, SaasErrorPage } from "@carefully-built/ui"` | `bunx @carefully-built/cli add error-page` |
+| `field-detail-row` | `import { FieldDetailRow } from "@carefully-built/ui"` | `bunx @carefully-built/cli add field-detail-row` |
+| `file-dropzone` | `import { FileDropzone } from "@carefully-built/ui"` | `bunx @carefully-built/cli add file-dropzone` |
+| `help-info-button` | `import { HelpInfoButton } from "@carefully-built/ui"` | `bunx @carefully-built/cli add help-info-button` |
+| `input` | `import { Input } from "@carefully-built/ui"` | `bunx @carefully-built/cli add input` |
+| `keyboard-shortcut-hint` | `import { KeyboardKeycap, ShortcutModifierKeycap } from "@carefully-built/ui"` | `bunx @carefully-built/cli add keyboard-shortcut-hint` |
+| `label` | `import { Label } from "@carefully-built/ui"` | `bunx @carefully-built/cli add label` |
+| `pagination` | `import { Pagination } from "@carefully-built/ui"` | `bunx @carefully-built/cli add pagination` |
+| `popover` | `import { Popover, PopoverContent, PopoverTrigger } from "@carefully-built/ui"` | `bunx @carefully-built/cli add popover` |
+| `responsive-sheet` | `import { ResponsiveSheet, SheetOutsideInteractionGuard } from "@carefully-built/ui"` | `bunx @carefully-built/cli add responsive-sheet` |
+| `responsive-sheet.footer` | `import { DesktopConfirmShortcutHint, SheetActionFooter } from "@carefully-built/ui"` | `bunx @carefully-built/cli add responsive-sheet.footer` |
+| `responsive-sheet.shortcuts` | `import { getDesktopShortcutModifierLabel, isAllowedConfirmShortcutEvent, useDesktopConfirmShortcut, useDesktopShortcutModifierLabel } from "@carefully-built/ui"` | `bunx @carefully-built/cli add responsive-sheet.shortcuts` |
+| `scroll-fade-area` | `import { ScrollFadeArea } from "@carefully-built/ui"` | `bunx @carefully-built/cli add scroll-fade-area` |
+| `search` | `import { SearchTextPart, buildSearchText, filterAndRankBySearch, rankBySearch, scoreFuzzyMatch } from "@carefully-built/ui"` | `bunx @carefully-built/cli add search` |
+| `searchable-select` | `import { AUTO_SEARCHABLE_SELECT_THRESHOLD, SearchableSelect, SearchableSelectOption, getSearchableSelectPortalContainer, isSearchableSelectPointerInside } from "@carefully-built/ui"` | `bunx @carefully-built/cli add searchable-select` |
+| `searchable-select-position` | `import { SearchableSelectRect, resolveSearchableSelectDropdownPosition } from "@carefully-built/ui"` | `bunx @carefully-built/cli add searchable-select-position` |
+| `segmented-toggle` | `import { SegmentedToggle, SegmentedToggleOption } from "@carefully-built/ui"` | `bunx @carefully-built/cli add segmented-toggle` |
+| `select` | `import { Select, SelectContent, SelectItem, SelectScrollDownButton, SelectScrollUpButton, SelectTrigger } from "@carefully-built/ui"` | `bunx @carefully-built/cli add select` |
+| `sheet` | `import { Sheet, SheetContent, SheetDescription, SheetHeader, SheetTitle } from "@carefully-built/ui"` | `bunx @carefully-built/cli add sheet` |
+| `skeleton` | `import { Skeleton } from "@carefully-built/ui"` | `bunx @carefully-built/cli add skeleton` |
+| `smart-table` | `import { ActionHandlers, ActionType, Column, ColumnAlign, PaginationConfig, SmartTable } from "@carefully-built/ui"` | `bunx @carefully-built/cli add smart-table` |
+| `switch` | `import { Switch } from "@carefully-built/ui"` | `bunx @carefully-built/cli add switch` |
+| `table` | `import { Table, TableBody, TableCaption, TableCell, TableFooter, TableHead } from "@carefully-built/ui"` | `bunx @carefully-built/cli add table` |
+| `table-toolbar` | `import { CustomTableToolbarFilter, FilterConfig, FilterDropdown, FilterOption, SearchInput, TableToolbar } from "@carefully-built/ui"` | `bunx @carefully-built/cli add table-toolbar` |
+| `tabs` | `import { Tabs, TabsContent, TabsList, TabsScrollArea, TabsTrigger, tabsListVariants } from "@carefully-built/ui"` | `bunx @carefully-built/cli add tabs` |
+| `textarea` | `import { Textarea } from "@carefully-built/ui"` | `bunx @carefully-built/cli add textarea` |
+| `tooltip` | `import { Tooltip, TooltipContent, TooltipProvider, TooltipTrigger } from "@carefully-built/ui"` | `bunx @carefully-built/cli add tooltip` |
+| `use-media-query` | `import { useIsMobile, useMediaQuery } from "@carefully-built/ui"` | `bunx @carefully-built/cli add use-media-query` |
+| `user-picker` | `import { UserPicker } from "@carefully-built/ui"` | `bunx @carefully-built/cli add user-picker` |
+| `user-picker-utils` | `import { UserPickerCopy, UserPickerOption, buildUserInitials, filterSelectableUsers, filterUsersBySearch, formatSelectedUserSummary } from "@carefully-built/ui"` | `bunx @carefully-built/cli add user-picker-utils` |
 
-Install the printed dependencies in the target app if they are not already present.
+Some entries export several related components, hooks, helpers, and types from one module. The import column shows the main exported symbols; TypeScript autocomplete will show the full API after installing `@carefully-built/ui`.
+
+## Dependency Notes
+
+The CLI prints dependency hints after copying. Depending on the component, your app may need packages such as:
+
+- `class-variance-authority`
+- `clsx`
+- `tailwind-merge`
+- `react`
+- `react-dom`
+- `radix-ui`
+- `lucide-react`
+- `react-day-picker`
+- `vaul`
+
+Most Carefully Built apps already have these through the shared kit stack.
+
+## Import vs Eject
+
+Import from `@carefully-built/ui` when:
+
+- you want package updates and bug fixes
+- the component should stay shared across apps
+- product-specific differences can be handled with props, slots, `className`, or `classes`
+
+Use `@carefully-built/cli add` when:
+
+- the component needs local product behavior
+- design needs to diverge from the shared package
+- you want to own and edit every line in the consuming app
+- the component should follow the app's normal source-control workflow
+
+## Development
+
+From the monorepo root:
+
+```bash
+bun install
+bun run --cwd packages/cli registry:build
+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
+```

package/dist/index.mjs

@@ -1,19 +1,22 @@
 #!/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 { constants, readFileSync, readdirSync } from "node:fs";
+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
 const registryRoot = join(join(dirname(fileURLToPath(import.meta.url)), ".."), "registry");
-const componentNames = ["button"];
 function listRegistryComponents() {
-	return [...componentNames];
+	return readdirSync(join(registryRoot, "ui"), { withFileTypes: true }).filter((entry) => entry.isDirectory()).map((entry) => entry.name).sort();
 }
 function getRegistryComponent(componentName) {
-	if (!componentNames.includes(componentName)) return;
 	const manifestPath = join(registryRoot, "ui", componentName, "manifest.json");
-	const manifest = JSON.parse(readFileSync(manifestPath, "utf8"));
+	let manifest;
+	try {
+		manifest = JSON.parse(readFileSync(manifestPath, "utf8"));
+	} catch {
+		return;
+	}
 	return {
 		...manifest,
 		files: manifest.files.map((file) => ({
@@ -31,17 +34,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 +65,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":["manifest: Omit<RegistryComponent, \"files\"> & {\n    files: readonly RegistryFile[];\n  }","created: string[]","overwritten: string[]","skipped: string[]"],"sources":["../src/registry.ts","../src/add.ts","../src/index.ts"],"sourcesContent":["import { readdirSync, readFileSync } from \"node:fs\";\nimport { dirname, join } from \"node:path\";\nimport { fileURLToPath } from \"node:url\";\n\ninterface RegistryFile {\n  readonly source: string;\n  readonly target: string;\n}\n\nexport interface RegistryComponent {\n  readonly name: string;\n  readonly description: string;\n  readonly importPath?: string;\n  readonly exports?: readonly 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\");\n\nexport function listRegistryComponents(): string[] {\n  return readdirSync(join(registryRoot, \"ui\"), { withFileTypes: true })\n    .filter((entry) => entry.isDirectory())\n    .map((entry) => entry.name)\n    .sort();\n}\n\nexport function getRegistryComponent(\n  componentName: string,\n): RegistryComponent | undefined {\n  const manifestPath = join(registryRoot, \"ui\", componentName, \"manifest.json\");\n\n  let manifest: Omit<RegistryComponent, \"files\"> & {\n    files: readonly RegistryFile[];\n  };\n\n  try {\n    manifest = JSON.parse(readFileSync(manifestPath, \"utf8\")) as typeof manifest;\n  } catch {\n    return undefined;\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.2",
+  "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",
@@ -39,7 +39,8 @@
   },
   "scripts": {
     "build": "tsdown src/index.ts --format esm --dts",
-    "prepublishOnly": "bun run typecheck && bun run test && bun run build",
+    "prepublishOnly": "bun run registry:build && bun run typecheck && bun run test && bun run build",
+    "registry:build": "node scripts/build-registry.mjs",
     "test": "bun test",
     "typecheck": "tsc --noEmit"
   },

package/registry/ui/avatar/manifest.json

@@ -0,0 +1,33 @@
+{
+  "name": "avatar",
+  "description": "Editable source registry entry for avatar.",
+  "importPath": "@carefully-built/ui",
+  "exports": [
+    "Avatar",
+    "AvatarFallback",
+    "AvatarImage"
+  ],
+  "dependencies": [
+    "class-variance-authority",
+    "clsx",
+    "tailwind-merge"
+  ],
+  "peerDependencies": [
+    "react",
+    "react-dom",
+    "radix-ui",
+    "lucide-react",
+    "react-day-picker",
+    "vaul"
+  ],
+  "files": [
+    {
+      "source": "primitives/avatar.tsx",
+      "target": "components/ui/avatar.tsx"
+    },
+    {
+      "source": "utils/cn.ts",
+      "target": "lib/utils.ts"
+    }
+  ]
+}

package/registry/ui/avatar/primitives/avatar.tsx

@@ -0,0 +1,64 @@
+"use client"
+
+import * as React from "react"
+import { Avatar as AvatarPrimitive } from "radix-ui"
+
+import { cn } from "@/lib/utils"
+
+function Avatar({
+  className,
+  size = "default",
+  ...props
+}: React.ComponentProps<typeof AvatarPrimitive.Root> & {
+  size?: "default" | "sm" | "lg"
+}) {
+  return (
+    <AvatarPrimitive.Root
+      data-slot="avatar"
+      data-size={size}
+      className={cn(
+        "size-8 rounded-full after:rounded-full data-[size=lg]:size-10 data-[size=sm]:size-6 after:border-border group/avatar relative flex shrink-0 select-none after:absolute after:inset-0 after:border after:mix-blend-darken dark:after:mix-blend-lighten",
+        className
+      )}
+      {...props}
+    />
+  )
+}
+
+function AvatarImage({
+  className,
+  ...props
+}: React.ComponentProps<typeof AvatarPrimitive.Image>) {
+  return (
+    <AvatarPrimitive.Image
+      data-slot="avatar-image"
+      className={cn(
+        "rounded-full aspect-square size-full object-cover",
+        className
+      )}
+      {...props}
+    />
+  )
+}
+
+function AvatarFallback({
+  className,
+  ...props
+}: React.ComponentProps<typeof AvatarPrimitive.Fallback>) {
+  return (
+    <AvatarPrimitive.Fallback
+      data-slot="avatar-fallback"
+      className={cn(
+        "bg-muted text-muted-foreground rounded-full flex size-full items-center justify-center text-sm group-data-[size=sm]/avatar:text-xs",
+        className
+      )}
+      {...props}
+    />
+  )
+}
+
+export {
+  Avatar,
+  AvatarImage,
+  AvatarFallback
+}

package/registry/ui/avatar/utils/cn.ts

@@ -0,0 +1,6 @@
+import { clsx, type ClassValue } from "clsx"
+import { twMerge } from "tailwind-merge"
+
+export function cn(...inputs: ClassValue[]): string {
+  return twMerge(clsx(inputs))
+}

package/registry/ui/button/manifest.json

@@ -1,15 +1,34 @@
 {
   "name": "button",
-  "description": "Shared button primitive with Carefully Built variants and sizes.",
-  "dependencies": ["class-variance-authority", "clsx", "tailwind-merge"],
-  "peerDependencies": ["react", "radix-ui"],
+  "description": "Editable source registry entry for button.",
+  "importPath": "@carefully-built/ui",
+  "exports": [
+    "Button",
+    "ButtonProps",
+    "ButtonSize",
+    "ButtonVariant",
+    "buttonVariants"
+  ],
+  "dependencies": [
+    "class-variance-authority",
+    "clsx",
+    "tailwind-merge"
+  ],
+  "peerDependencies": [
+    "react",
+    "react-dom",
+    "radix-ui",
+    "lucide-react",
+    "react-day-picker",
+    "vaul"
+  ],
   "files": [
     {
-      "source": "button.tsx",
+      "source": "primitives/button.tsx",
       "target": "components/ui/button.tsx"
     },
     {
-      "source": "cn.ts",
+      "source": "utils/cn.ts",
       "target": "lib/utils.ts"
     }
   ]

package/registry/ui/button/utils/cn.ts

@@ -0,0 +1,6 @@
+import { clsx, type ClassValue } from "clsx"
+import { twMerge } from "tailwind-merge"
+
+export function cn(...inputs: ClassValue[]): string {
+  return twMerge(clsx(inputs))
+}

package/registry/ui/calendar/manifest.json

@@ -0,0 +1,35 @@
+{
+  "name": "calendar",
+  "description": "Editable source registry entry for calendar.",
+  "importPath": "@carefully-built/ui",
+  "exports": [
+    "Calendar"
+  ],
+  "dependencies": [
+    "class-variance-authority",
+    "clsx",
+    "tailwind-merge"
+  ],
+  "peerDependencies": [
+    "react",
+    "react-dom",
+    "radix-ui",
+    "lucide-react",
+    "react-day-picker",
+    "vaul"
+  ],
+  "files": [
+    {
+      "source": "primitives/button.tsx",
+      "target": "components/ui/button.tsx"
+    },
+    {
+      "source": "primitives/calendar.tsx",
+      "target": "components/ui/calendar.tsx"
+    },
+    {
+      "source": "utils/cn.ts",
+      "target": "lib/utils.ts"
+    }
+  ]
+}

package/registry/ui/calendar/primitives/button.tsx

@@ -0,0 +1,89 @@
+import * as React from "react";
+import { cva } from "class-variance-authority";
+import { Slot } from "radix-ui";
+
+import { cn } from "@/lib/utils";
+
+const buttonVariants = cva(
+  "group/button inline-flex shrink-0 cursor-pointer items-center justify-center rounded-lg border border-transparent bg-clip-padding text-sm font-medium whitespace-nowrap transition-all outline-none select-none focus-visible:border-ring focus-visible:ring-3 focus-visible:ring-ring/50 active:not-aria-[haspopup]:translate-y-px disabled:pointer-events-none disabled:opacity-50 aria-invalid:border-destructive aria-invalid:ring-3 aria-invalid:ring-destructive/20 dark:aria-invalid:border-destructive/50 dark:aria-invalid:ring-destructive/40 [&_svg]:pointer-events-none [&_svg]:shrink-0 [&_svg:not([class*='size-'])]:size-4",
+  {
+    variants: {
+      variant: {
+        default:
+          "bg-primary text-primary-foreground hover:brightness-90 [a]:hover:bg-primary/80",
+        outline:
+          "border-border bg-background hover:bg-muted hover:text-foreground aria-expanded:bg-muted aria-expanded:text-foreground dark:border-input dark:bg-input/30 dark:hover:bg-input/50",
+        secondary:
+          "bg-secondary text-secondary-foreground hover:bg-secondary/80 aria-expanded:bg-secondary aria-expanded:text-secondary-foreground",
+        ghost:
+          "hover:bg-muted hover:text-foreground aria-expanded:bg-muted aria-expanded:text-foreground dark:hover:bg-muted/50",
+        destructive:
+          "bg-destructive/10 text-destructive hover:bg-destructive/20 focus-visible:border-destructive/40 focus-visible:ring-destructive/20 dark:bg-destructive/20 dark:hover:bg-destructive/30 dark:focus-visible:ring-destructive/40",
+        link: "text-primary underline-offset-4 hover:underline",
+      },
+      size: {
+        default:
+          "h-8 gap-1.5 px-2.5 has-data-[icon=inline-end]:pr-2 has-data-[icon=inline-start]:pl-2",
+        xs: "h-6 gap-1 rounded-[min(var(--radius-md),10px)] px-2 text-xs in-data-[slot=button-group]:rounded-lg has-data-[icon=inline-end]:pr-1.5 has-data-[icon=inline-start]:pl-1.5 [&_svg:not([class*='size-'])]:size-3",
+        sm: "h-7 gap-1 rounded-[min(var(--radius-md),12px)] px-2.5 text-[0.8rem] in-data-[slot=button-group]:rounded-lg has-data-[icon=inline-end]:pr-1.5 has-data-[icon=inline-start]:pl-1.5 [&_svg:not([class*='size-'])]:size-3.5",
+        lg: "h-9 gap-1.5 px-2.5 has-data-[icon=inline-end]:pr-2 has-data-[icon=inline-start]:pl-2",
+        icon: "size-8",
+        "icon-xs":
+          "size-6 rounded-[min(var(--radius-md),10px)] in-data-[slot=button-group]:rounded-lg [&_svg:not([class*='size-'])]:size-3",
+        "icon-sm":
+          "size-7 rounded-[min(var(--radius-md),12px)] in-data-[slot=button-group]:rounded-lg",
+        "icon-lg": "size-9",
+      },
+    },
+    defaultVariants: {
+      variant: "default",
+      size: "default",
+    },
+  },
+);
+
+type ButtonVariant =
+  | "default"
+  | "outline"
+  | "secondary"
+  | "ghost"
+  | "destructive"
+  | "link";
+type ButtonSize =
+  | "default"
+  | "xs"
+  | "sm"
+  | "lg"
+  | "icon"
+  | "icon-xs"
+  | "icon-sm"
+  | "icon-lg";
+
+interface ButtonProps extends React.ComponentProps<"button"> {
+  readonly asChild?: boolean;
+  readonly size?: ButtonSize;
+  readonly variant?: ButtonVariant;
+}
+
+function Button({
+  className,
+  variant = "default",
+  size = "default",
+  asChild = false,
+  ...props
+}: ButtonProps) {
+  const Comp = asChild ? Slot.Root : "button";
+
+  return (
+    <Comp
+      data-slot="button"
+      data-variant={variant}
+      data-size={size}
+      className={cn(buttonVariants({ variant, size, className }))}
+      {...props}
+    />
+  );
+}
+
+export { Button, buttonVariants };
+export type { ButtonProps, ButtonSize, ButtonVariant };