nimbus-docs 0.1.0 → 0.1.2

package/dist/cli/index.js

@@ -185,6 +185,12 @@ const BUNDLED_INDEX = {
 			"title": "TOC",
 			"description": "On-page table of contents with active-heading tracking."
 		},
+		"version-switcher": {
+			"name": "version-switcher",
+			"type": "registry:ui",
+			"title": "VersionPicker",
+			"description": "Header dropdown for switching between docs versions. Reads `versions` from nimbus.config.ts, uses the build-time alternates table to land readers on the same logical page in the target version. Includes deprecation badge and hidden-version exclusion. Renders nothing when versioning is off or only one version is configured."
+		},
 		"404-page": {
 			"name": "404-page",
 			"type": "registry:feature",
@@ -197,6 +203,24 @@ const BUNDLED_INDEX = {
 			"title": "AI-native static surface",
 			"description": "Add llms.txt, markdown variants, robots.txt, and an AgentDirective to a Nimbus docs site."
 		},
+		"component-showcase": {
+			"name": "component-showcase",
+			"type": "registry:feature",
+			"title": "Component showcase",
+			"description": "Add a /components grid landing plus per-component showcase pages at /components/<slug>, driven by a dedicated content collection. For sites documenting their own UI library."
+		},
+		"new-collection": {
+			"name": "new-collection",
+			"type": "registry:feature",
+			"title": "Add a new collection",
+			"description": "End-to-end setup for a non-version content tree on a Nimbus docs site — blog, API reference, changelog, glossary. Creates the folder, registers the collection, scaffolds routes. For docs versions, use `nimbus-docs add new-version`."
+		},
+		"new-version": {
+			"name": "new-version",
+			"type": "registry:feature",
+			"title": "Add a docs version",
+			"description": "End-to-end setup for adding a docs version to a Nimbus site. Creates the content directory, registers the collection, scaffolds routes, declares the manifest, installs the version-switcher picker, and wires it into your Header and DocsLayout. One command for one mental task."
+		},
 		"pagefind-search": {
 			"name": "pagefind-search",
 			"type": "registry:feature",
@@ -602,7 +626,7 @@ async function main() {
 		return;
 	}
 	if (args.version) {
-		process.stdout.write(`0.1.0\n`);
+		process.stdout.write(`0.1.2\n`);
 		return;
 	}
 	const [command, slug] = args._;

package/dist/cli/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":["addCommand","addCommand"],"sources":["../../src/cli/_registry.generated.ts","../../src/cli/pm.ts","../../src/cli/component.ts","../../src/cli/dotenv.ts","../../src/cli/resolver.ts","../../src/cli/feature.ts","../../src/cli/index.ts"],"sourcesContent":["/**\n * Bundled registry index — auto-generated by\n * apps/www/scripts/generate-registry.ts. Do not edit by hand.\n *\n * Re-run via: pnpm --filter @nimbus/www generate-registry\n */\n\nexport type RegistryEntryType =\n  | \"registry:ui\"\n  | \"registry:lib\"\n  | \"registry:feature\";\n\nexport interface RegistryIndexEntry {\n  name: string;\n  type: RegistryEntryType;\n  title: string;\n  description: string;\n}\n\nexport interface BundledIndex {\n  version: 1;\n  items: Record<string, RegistryIndexEntry>;\n}\n\nexport const REGISTRY_BASE_URL = \"https://nimbus-docs.com/registry\";\n\nexport const BUNDLED_INDEX: BundledIndex = {\n  \"version\": 1,\n  \"items\": {\n    \"cn\": {\n      \"name\": \"cn\",\n      \"type\": \"registry:lib\",\n      \"title\": \"cn\",\n      \"description\": \"Tailwind-aware className merger built on clsx + tailwind-merge.\"\n    },\n    \"accordion\": {\n      \"name\": \"accordion\",\n      \"type\": \"registry:ui\",\n      \"title\": \"Accordion\",\n      \"description\": \"Vertically stacked collapsible sections.\"\n    },\n    \"aside\": {\n      \"name\": \"aside\",\n      \"type\": \"registry:ui\",\n      \"title\": \"Aside\",\n      \"description\": \"Generic boxed callout. Building block for Callout, Note, Warning.\"\n    },\n    \"badge\": {\n      \"name\": \"badge\",\n      \"type\": \"registry:ui\",\n      \"title\": \"Badge\",\n      \"description\": \"Small status / category pill.\"\n    },\n    \"banner\": {\n      \"name\": \"banner\",\n      \"type\": \"registry:ui\",\n      \"title\": \"Banner\",\n      \"description\": \"Site-wide dismissible announcement bar.\"\n    },\n    \"breadcrumbs\": {\n      \"name\": \"breadcrumbs\",\n      \"type\": \"registry:ui\",\n      \"title\": \"Breadcrumbs\",\n      \"description\": \"Page-context navigation crumbs.\"\n    },\n    \"callout\": {\n      \"name\": \"callout\",\n      \"type\": \"registry:ui\",\n      \"title\": \"Callout\",\n      \"description\": \"Inline note / tip / warning / danger / info card.\"\n    },\n    \"card\": {\n      \"name\": \"card\",\n      \"type\": \"registry:ui\",\n      \"title\": \"Card\",\n      \"description\": \"Generic content card with optional title and footer.\"\n    },\n    \"card-grid\": {\n      \"name\": \"card-grid\",\n      \"type\": \"registry:ui\",\n      \"title\": \"CardGrid\",\n      \"description\": \"Responsive grid layout for cards.\"\n    },\n    \"code\": {\n      \"name\": \"code\",\n      \"type\": \"registry:ui\",\n      \"title\": \"Code\",\n      \"description\": \"Inline / block code wrapper. Re-exports Astro's built-in <Code> (Shiki).\"\n    },\n    \"code-group\": {\n      \"name\": \"code-group\",\n      \"type\": \"registry:ui\",\n      \"title\": \"CodeGroup\",\n      \"description\": \"Tabbed group of code blocks.\"\n    },\n    \"collapsible\": {\n      \"name\": \"collapsible\",\n      \"type\": \"registry:ui\",\n      \"title\": \"Collapsible\",\n      \"description\": \"Headless show/hide primitive — building block for Accordion and Sidebar groups.\"\n    },\n    \"dialog\": {\n      \"name\": \"dialog\",\n      \"type\": \"registry:ui\",\n      \"title\": \"Dialog\",\n      \"description\": \"Modal dialog with focus-trap and body-scroll lock.\"\n    },\n    \"embed\": {\n      \"name\": \"embed\",\n      \"type\": \"registry:ui\",\n      \"title\": \"Embed\",\n      \"description\": \"Responsive iframe / video / external content wrapper.\"\n    },\n    \"file-tree\": {\n      \"name\": \"file-tree\",\n      \"type\": \"registry:ui\",\n      \"title\": \"FileTree\",\n      \"description\": \"Render a directory tree as nested markup.\"\n    },\n    \"frame\": {\n      \"name\": \"frame\",\n      \"type\": \"registry:ui\",\n      \"title\": \"Frame\",\n      \"description\": \"Decorative outer frame for screenshots and demos.\"\n    },\n    \"layer-card\": {\n      \"name\": \"layer-card\",\n      \"type\": \"registry:ui\",\n      \"title\": \"LayerCard\",\n      \"description\": \"Stacked-card container with sticky header. Base for CodeGroup and PackageManagers.\"\n    },\n    \"link-button\": {\n      \"name\": \"link-button\",\n      \"type\": \"registry:ui\",\n      \"title\": \"LinkButton\",\n      \"description\": \"Anchor styled as a button.\"\n    },\n    \"link-card\": {\n      \"name\": \"link-card\",\n      \"type\": \"registry:ui\",\n      \"title\": \"LinkCard\",\n      \"description\": \"Card whose entire surface is a link.\"\n    },\n    \"package-managers\": {\n      \"name\": \"package-managers\",\n      \"type\": \"registry:ui\",\n      \"title\": \"PackageManagers\",\n      \"description\": \"Tabbed install command block translated across npm / pnpm / yarn / bun.\"\n    },\n    \"page-actions\": {\n      \"name\": \"page-actions\",\n      \"type\": \"registry:ui\",\n      \"title\": \"PageActions\",\n      \"description\": \"Inline page-header actions: copy the page as markdown, open the raw .md.\"\n    },\n    \"pagination\": {\n      \"name\": \"pagination\",\n      \"type\": \"registry:ui\",\n      \"title\": \"Pagination\",\n      \"description\": \"Prev / next page navigation.\"\n    },\n    \"popover\": {\n      \"name\": \"popover\",\n      \"type\": \"registry:ui\",\n      \"title\": \"Popover\",\n      \"description\": \"Floating panel anchored to a trigger element.\"\n    },\n    \"search\": {\n      \"name\": \"search\",\n      \"type\": \"registry:ui\",\n      \"title\": \"Search\",\n      \"description\": \"Command-palette search dialog with a provider seam. Defaults to Pagefind.\"\n    },\n    \"sidebar\": {\n      \"name\": \"sidebar\",\n      \"type\": \"registry:ui\",\n      \"title\": \"Sidebar\",\n      \"description\": \"Docs sidebar with nested groups and active-link tracking.\"\n    },\n    \"steps\": {\n      \"name\": \"steps\",\n      \"type\": \"registry:ui\",\n      \"title\": \"Steps\",\n      \"description\": \"Numbered ordered-list with vertical connectors.\"\n    },\n    \"tabs\": {\n      \"name\": \"tabs\",\n      \"type\": \"registry:ui\",\n      \"title\": \"Tabs\",\n      \"description\": \"Tabbed content panels (manual + Starlight-compatible modes).\"\n    },\n    \"theme-toggle\": {\n      \"name\": \"theme-toggle\",\n      \"type\": \"registry:ui\",\n      \"title\": \"ThemeToggle\",\n      \"description\": \"Light / dark theme switcher button.\"\n    },\n    \"toc\": {\n      \"name\": \"toc\",\n      \"type\": \"registry:ui\",\n      \"title\": \"TOC\",\n      \"description\": \"On-page table of contents with active-heading tracking.\"\n    },\n    \"404-page\": {\n      \"name\": \"404-page\",\n      \"type\": \"registry:feature\",\n      \"title\": \"Custom 404 page\",\n      \"description\": \"Generate a brand-matched 404 page for the docs site.\"\n    },\n    \"ai-native\": {\n      \"name\": \"ai-native\",\n      \"type\": \"registry:feature\",\n      \"title\": \"AI-native static surface\",\n      \"description\": \"Add llms.txt, markdown variants, robots.txt, and an AgentDirective to a Nimbus docs site.\"\n    },\n    \"pagefind-search\": {\n      \"name\": \"pagefind-search\",\n      \"type\": \"registry:feature\",\n      \"title\": \"Pagefind search\",\n      \"description\": \"Add static Pagefind indexing and the Nimbus search dialog to an existing docs site.\"\n    }\n  }\n};\n","/**\n * Package-manager detection + install command helpers.\n *\n * Detection prefers lockfile presence in the user's cwd, then falls back\n * to the `npm_config_user_agent` env var the active package manager sets\n * when invoking the CLI. Finally falls back to `npm`.\n */\n\nimport { existsSync } from \"node:fs\";\nimport { join } from \"node:path\";\n\nexport type PackageManager = \"npm\" | \"pnpm\" | \"yarn\" | \"bun\";\n\nconst LOCKFILES: ReadonlyArray<readonly [string, PackageManager]> = [\n  [\"pnpm-lock.yaml\", \"pnpm\"],\n  [\"yarn.lock\", \"yarn\"],\n  [\"bun.lockb\", \"bun\"],\n  [\"bun.lock\", \"bun\"],\n  [\"package-lock.json\", \"npm\"],\n];\n\nexport function detectPackageManager(cwd: string): PackageManager {\n  for (const [lockfile, pm] of LOCKFILES) {\n    if (existsSync(join(cwd, lockfile))) return pm;\n  }\n  const ua = process.env.npm_config_user_agent ?? \"\";\n  if (ua.startsWith(\"pnpm\")) return \"pnpm\";\n  if (ua.startsWith(\"yarn\")) return \"yarn\";\n  if (ua.startsWith(\"bun\")) return \"bun\";\n  return \"npm\";\n}\n\n/**\n * Command + args to install one or more new npm deps. Each PM picks the\n * verb that both adds to package.json AND installs:\n *\n *   npm  install <deps...>\n *   pnpm add     <deps...>\n *   yarn add     <deps...>\n *   bun  add     <deps...>\n */\nexport function addCommand(\n  pm: PackageManager,\n  deps: string[],\n): { bin: string; args: string[] } {\n  if (deps.length === 0) {\n    throw new Error(\"addCommand called with empty deps\");\n  }\n  switch (pm) {\n    case \"npm\":\n      return { bin: \"npm\", args: [\"install\", ...deps] };\n    case \"pnpm\":\n      return { bin: \"pnpm\", args: [\"add\", ...deps] };\n    case \"yarn\":\n      return { bin: \"yarn\", args: [\"add\", ...deps] };\n    case \"bun\":\n      return { bin: \"bun\", args: [\"add\", ...deps] };\n  }\n}\n","/**\n * Component / utility installer.\n *\n * Walks the resolved list of items, writes each file (per-file overwrite\n * prompt on conflict), then collects all npm `dependencies` across the\n * tree and runs `<pm> add` once for the dedup'd set.\n *\n * File destination: `<cwd>/src/<path>`. The `path` field already encodes\n * the directory layout (e.g. `components/ui/dialog/Dialog.astro`).\n */\n\nimport { spawn } from \"node:child_process\";\nimport {\n  existsSync,\n  mkdirSync,\n  readFileSync,\n  writeFileSync,\n} from \"node:fs\";\nimport { dirname, join, relative } from \"node:path\";\n\nimport * as p from \"@clack/prompts\";\n\nimport { addCommand, detectPackageManager } from \"./pm.js\";\nimport type { ComponentItem } from \"./resolver.js\";\n\nexport interface InstallOptions {\n  /** User's project root. */\n  cwd: string;\n  /** Skip overwrite prompts; assume \"overwrite\" on every conflict. */\n  yes: boolean;\n}\n\nexport interface InstallReport {\n  /** Individual files actually written. */\n  written: string[];\n  /** Registry slugs skipped wholesale by the user. */\n  skipped: string[];\n  npmDepsInstalled: string[];\n}\n\nexport async function installComponents(\n  items: ComponentItem[],\n  options: InstallOptions,\n): Promise<InstallReport> {\n  const report: InstallReport = {\n    written: [],\n    skipped: [],\n    npmDepsInstalled: [],\n  };\n\n  // ---- 1. Write files — atomic per registry item -------------------------\n  //\n  // Each item (e.g. `dialog`) is treated as an indivisible unit: when any\n  // of its files conflict, we prompt once for the whole slug. Letting users\n  // overwrite Dialog.astro while keeping DialogContent.astro is a footgun\n  // — components are cohesive and meant to evolve together.\n  const srcDir = join(options.cwd, \"src\");\n\n  for (const item of items) {\n    const filePlans = item.files.map((file) => {\n      const targetAbs = join(srcDir, file.path);\n      return {\n        targetAbs,\n        targetRel: relative(options.cwd, targetAbs),\n        content: file.content,\n        exists: existsSync(targetAbs),\n      };\n    });\n\n    const conflicts = filePlans.filter((f) => f.exists);\n\n    // Utilities (registry:lib) are transitive dependencies of UI\n    // components — install silently when missing, skip silently when\n    // present. Never prompt or overwrite: users may have customized\n    // them (e.g. cn) and being asked about `cn` every time you `add` a\n    // component is noise.\n    if (item.type === \"registry:lib\") {\n      if (conflicts.length > 0) {\n        report.skipped.push(item.name);\n        continue;\n      }\n    } else if (conflicts.length > 0 && !options.yes) {\n      const total = filePlans.length;\n      const message =\n        conflicts.length === total\n          ? `${item.name} is already installed (${total} file${total === 1 ? \"\" : \"s\"}). Overwrite?`\n          : `${item.name} is partially installed (${conflicts.length} of ${total} file${total === 1 ? \"\" : \"s\"} present). Overwrite all?`;\n\n      const choice = await p.select({\n        message,\n        options: [\n          { value: \"overwrite\", label: \"Overwrite — replace existing files\" },\n          { value: \"skip\", label: \"Skip — leave files as-is\" },\n          { value: \"cancel\", label: \"Cancel install\" },\n        ],\n        initialValue: \"overwrite\",\n      });\n\n      if (p.isCancel(choice) || choice === \"cancel\") {\n        p.cancel(\"Cancelled.\");\n        process.exit(0);\n      }\n      if (choice === \"skip\") {\n        report.skipped.push(item.name);\n        continue;\n      }\n    }\n\n    // Either no conflicts, --yes, or user chose overwrite. Write every file.\n    for (const plan of filePlans) {\n      mkdirSync(dirname(plan.targetAbs), { recursive: true });\n      writeFileSync(plan.targetAbs, plan.content);\n      report.written.push(plan.targetRel);\n    }\n  }\n\n  // ---- 2. Install missing npm deps ---------------------------------------\n  const allDeps = new Set<string>();\n  for (const item of items) {\n    for (const dep of item.dependencies) allDeps.add(dep);\n  }\n\n  if (allDeps.size > 0) {\n    const newDeps = filterAlreadyInstalled(options.cwd, [...allDeps]);\n    if (newDeps.length > 0) {\n      const pm = detectPackageManager(options.cwd);\n      const { bin, args } = addCommand(pm, newDeps);\n      const spinner = p.spinner();\n      spinner.start(`${pm} add ${newDeps.join(\" \")}`);\n      try {\n        await runCommand(bin, args, options.cwd);\n        spinner.stop(\n          `Installed ${newDeps.length} dep${newDeps.length === 1 ? \"\" : \"s\"}.`,\n        );\n        report.npmDepsInstalled = newDeps;\n      } catch (err) {\n        spinner.stop(\"Dependency install failed.\");\n        p.log.warn(\n          `Could not install ${newDeps.join(\", \")}. Run \\`${bin} ${args.join(\" \")}\\` manually.`,\n        );\n      }\n    }\n  }\n\n  return report;\n}\n\n/**\n * Filter out deps already present in `dependencies` or `devDependencies`\n * of the user's package.json. If package.json is missing, returns all.\n */\nfunction filterAlreadyInstalled(cwd: string, deps: string[]): string[] {\n  const pkgPath = join(cwd, \"package.json\");\n  if (!existsSync(pkgPath)) return deps;\n  try {\n    const pkg = JSON.parse(readFileSync(pkgPath, \"utf8\")) as {\n      dependencies?: Record<string, string>;\n      devDependencies?: Record<string, string>;\n    };\n    const installed = new Set([\n      ...Object.keys(pkg.dependencies ?? {}),\n      ...Object.keys(pkg.devDependencies ?? {}),\n    ]);\n    return deps.filter((d) => !installed.has(d));\n  } catch {\n    return deps;\n  }\n}\n\nfunction runCommand(\n  bin: string,\n  args: string[],\n  cwd: string,\n): Promise<void> {\n  return new Promise((resolveP, rejectP) => {\n    const child = spawn(bin, args, {\n      cwd,\n      stdio: [\"ignore\", \"ignore\", \"inherit\"],\n    });\n    child.on(\"close\", (code) =>\n      code === 0\n        ? resolveP()\n        : rejectP(new Error(`${bin} ${args.join(\" \")} exited ${code}`)),\n    );\n    child.on(\"error\", rejectP);\n  });\n}\n","/**\n * Tiny .env loader — no dependency.\n *\n * Reads `.env` from the user's cwd at CLI startup and sets any KEY=VALUE\n * pairs into `process.env` IF the variable isn't already set (so a shell-\n * provided env always wins over the file). Supports the basic cases:\n *\n *   KEY=value\n *   KEY=\"quoted value\"\n *   KEY='quoted value'\n *   # comments\n *\n * Used so `examples/local/.env` can carry `NIMBUS_REGISTRY_URL=...` without\n * the user having to prefix every CLI invocation.\n */\n\nimport { existsSync, readFileSync } from \"node:fs\";\nimport { join } from \"node:path\";\n\nexport function loadDotenv(cwd: string): void {\n  const path = join(cwd, \".env\");\n  if (!existsSync(path)) return;\n\n  let raw: string;\n  try {\n    raw = readFileSync(path, \"utf8\");\n  } catch {\n    return;\n  }\n\n  for (const rawLine of raw.split(/\\r?\\n/)) {\n    const line = rawLine.trim();\n    if (!line || line.startsWith(\"#\")) continue;\n\n    const eq = line.indexOf(\"=\");\n    if (eq <= 0) continue;\n\n    const key = line.slice(0, eq).trim();\n    if (!/^[A-Z_][A-Z0-9_]*$/i.test(key)) continue;\n\n    let value = line.slice(eq + 1).trim();\n    if (\n      (value.startsWith('\"') && value.endsWith('\"')) ||\n      (value.startsWith(\"'\") && value.endsWith(\"'\"))\n    ) {\n      value = value.slice(1, -1);\n    }\n\n    if (process.env[key] === undefined) {\n      process.env[key] = value;\n    }\n  }\n}\n","/**\n * Registry resolver.\n *\n * Two entry points:\n *\n *   - `resolveComponentTree(slug)` walks `registryDependencies` transitively\n *     and returns a flat ordered list of components/utilities to install\n *     (dependencies first, root last). Cycles are detected as repeated\n *     visits and skipped.\n *\n *   - `fetchFeatureMarkdown(slug)` returns the raw markdown for an\n *     agent-handoff feature; the caller decides what to do with it.\n *\n * The base URL for hosted artifacts is read from the bundled index, with\n * an `NIMBUS_REGISTRY_URL` env override for local development.\n */\n\nimport {\n  BUNDLED_INDEX,\n  REGISTRY_BASE_URL,\n  type RegistryIndexEntry,\n} from \"./_registry.generated.js\";\n\nexport interface RegistryFile {\n  path: string;\n  content: string;\n}\n\nexport interface ComponentItem {\n  name: string;\n  type: \"registry:ui\" | \"registry:lib\";\n  title: string;\n  description: string;\n  dependencies: string[];\n  registryDependencies: string[];\n  files: RegistryFile[];\n}\n\n/**\n * Read the registry base URL on every call so `.env` files loaded after\n * module-import time (see cli/dotenv.ts) are picked up. The cost is\n * negligible — string interpolation of an env var.\n */\nfunction getBaseUrl(): string {\n  return (process.env.NIMBUS_REGISTRY_URL ?? REGISTRY_BASE_URL).replace(\n    /\\/$/,\n    \"\",\n  );\n}\n\n// ---------------------------------------------------------------------------\n// Index lookup (offline — no network)\n// ---------------------------------------------------------------------------\n\nexport function getIndexEntry(slug: string): RegistryIndexEntry | undefined {\n  return BUNDLED_INDEX.items[slug];\n}\n\nexport function listEntries(filter?: {\n  type?: RegistryIndexEntry[\"type\"];\n}): RegistryIndexEntry[] {\n  const all = Object.values(BUNDLED_INDEX.items);\n  if (!filter?.type) return all;\n  return all.filter((e) => e.type === filter.type);\n}\n\n// ---------------------------------------------------------------------------\n// Network: component JSON + feature markdown\n// ---------------------------------------------------------------------------\n\nasync function httpGet(url: string): Promise<Response> {\n  let res: Response;\n  try {\n    res = await fetch(url);\n  } catch (err) {\n    const cause = (err as Error).message;\n    throw new Error(\n      `Could not reach the registry at ${url}.\\n` +\n        `  Underlying error: ${cause}\\n\\n` +\n        `  Things to try:\\n` +\n        `    - Is the registry server running? Start it with \\`pnpm local\\` (in the monorepo root).\\n` +\n        `    - Override the URL: NIMBUS_REGISTRY_URL=https://example.com nimbus-docs add ...\\n` +\n        `    - Check the value in your project's .env file.`,\n    );\n  }\n  if (!res.ok) {\n    throw new Error(\n      `Registry returned ${res.status} ${res.statusText} for ${url}. ` +\n        `The server is up but doesn't know about this slug — check \\`nimbus-docs list\\` for valid names.`,\n    );\n  }\n  return res;\n}\n\nexport async function fetchComponent(slug: string): Promise<ComponentItem> {\n  const res = await httpGet(`${getBaseUrl()}/components/${slug}.json`);\n  return (await res.json()) as ComponentItem;\n}\n\nexport async function fetchFeatureMarkdown(slug: string): Promise<string> {\n  const res = await httpGet(`${getBaseUrl()}/features/${slug}.md`);\n  return await res.text();\n}\n\n// ---------------------------------------------------------------------------\n// Transitive dep resolution\n// ---------------------------------------------------------------------------\n\n/**\n * Depth-first walk of registryDependencies. Returns items in install order\n * (deps before dependents), deduplicated by slug.\n */\nexport async function resolveComponentTree(\n  rootSlug: string,\n): Promise<ComponentItem[]> {\n  const visited = new Set<string>();\n  const ordered: ComponentItem[] = [];\n\n  async function visit(slug: string): Promise<void> {\n    if (visited.has(slug)) return;\n    visited.add(slug);\n\n    const item = await fetchComponent(slug);\n\n    // Walk deps first so they're earlier in the install order.\n    for (const dep of item.registryDependencies) {\n      await visit(dep);\n    }\n\n    ordered.push(item);\n  }\n\n  await visit(rootSlug);\n  return ordered;\n}\n","/**\n * Feature installer — Flue-style agent-handoff.\n *\n * Same rule Flue uses for `flue add`: if `--print` is set OR\n * `determineAgent()` says the CLI is running inside a known coding agent,\n * the markdown is piped to stdout for the agent to consume. Otherwise we\n * print human-friendly instructions on stderr telling the user exactly\n * how to pipe the output to their agent of choice.\n *\n * No picker, no clipboard mode — the printed pipe commands cover both.\n */\n\nimport { determineAgent } from \"@vercel/detect-agent\";\n\nimport { fetchFeatureMarkdown } from \"./resolver.js\";\n\nexport interface FeatureInstallOptions {\n  /** Force markdown to stdout regardless of agent detection. */\n  print: boolean;\n}\n\nexport async function installFeature(\n  slug: string,\n  options: FeatureInstallOptions,\n): Promise<void> {\n  const markdown = await fetchFeatureMarkdown(slug);\n\n  // Same predicate as Flue: explicit --print, or detection says we're\n  // running inside a known agent (which captures our stdout).\n  const detected = await determineAgent().catch(() => ({\n    isAgent: false as const,\n  }));\n  const isAgentMode = options.print || detected.isAgent === true;\n\n  if (isAgentMode) {\n    process.stdout.write(markdown);\n    if (!markdown.endsWith(\"\\n\")) process.stdout.write(\"\\n\");\n    return;\n  }\n\n  printHumanInstructions(slug);\n}\n\n/**\n * Stderr-only. We don't put this on stdout because if the user pipes our\n * output anywhere by accident, only the markdown should reach the agent.\n *\n * Formatting mirrors Flue's `printHumanInstructions` 1:1 — agents listed\n * with a blank line between the \"first-tier\" CLIs (claude/codex/cursor-agent)\n * and the rest (opencode/pi).\n */\nfunction printHumanInstructions(slug: string): void {\n  const cmd = `nimbus-docs add ${slug}`;\n  const stream = process.stderr;\n  stream.write(`${cmd}\\n\\n`);\n  stream.write(\"To install this feature, pipe it to your coding agent:\\n\\n\");\n  stream.write(`  ${cmd} --print | claude\\n`);\n  stream.write(`  ${cmd} --print | codex\\n`);\n  stream.write(`  ${cmd} --print | cursor-agent\\n\\n`);\n  stream.write(`  ${cmd} --print | opencode\\n`);\n  stream.write(`  ${cmd} --print | pi\\n`);\n  stream.write(\"Or paste this prompt into any agent:\\n\\n\");\n  stream.write(`  Run \"${cmd} --print\" and follow the instructions.\\n`);\n}\n","#!/usr/bin/env node\n\n/**\n * `nimbus-docs` CLI entry.\n *\n * Surface:\n *\n *   nimbus                        → list (table of installable items)\n *   nimbus-docs list                   → list\n *   nimbus-docs list --type ui|lib|feature\n *   nimbus-docs add                    → list\n *   nimbus-docs add <slug>             → install (component path or feature path)\n *   nimbus-docs add <slug> --yes       → component: skip overwrite prompts\n *   nimbus-docs add <slug> --print     → feature: print markdown to stdout (skip detect)\n *\n * Feature behavior mirrors Flue's `add` command: print markdown to stdout\n * iff `--print` OR an agent is detected; otherwise print human-friendly\n * pipe instructions to stderr.\n *\n * The bundled index makes `list` (and `add` with no slug) work offline.\n * Per-item content is fetched from `REGISTRY_BASE_URL` only when actually\n * installing a slug — override via `NIMBUS_REGISTRY_URL` for local dev.\n */\n\nimport mri from \"mri\";\nimport * as p from \"@clack/prompts\";\n\nimport { BUNDLED_INDEX } from \"./_registry.generated.js\";\nimport { installComponents } from \"./component.js\";\nimport { loadDotenv } from \"./dotenv.js\";\nimport { installFeature } from \"./feature.js\";\nimport {\n  getIndexEntry,\n  listEntries,\n  resolveComponentTree,\n} from \"./resolver.js\";\n\n// Load .env from the user's cwd so per-project NIMBUS_REGISTRY_URL (and\n// any future env vars) work without shell prefixes. Shell-provided vars\n// always win (loadDotenv only sets undefined keys).\nloadDotenv(process.cwd());\n\ndeclare const __APP_VERSION__: string;\n\ninterface CliArgs {\n  _: string[];\n  yes: boolean;\n  print: boolean;\n  help: boolean;\n  version: boolean;\n  type?: string;\n}\n\nconst HELP = `\n  Usage: nimbus-docs <command> [args]\n\n  Commands:\n    list [--type ui|lib|feature]   List available registry items\n    add                            Same as \\`list\\`\n    add <slug>                     Install a component or hand off a feature\n\n  Flags:\n    --yes, -y                      Component: overwrite conflicts without prompting\n    --print                        Feature: print markdown to stdout (skip agent detect)\n    --type <ui|lib|feature>        \\`list\\`: filter by type\n    --help, -h\n    --version, -v\n\n  Examples:\n    nimbus-docs add dialog                              # component: resolve + install\n    nimbus-docs add 404-page                            # feature: detect agent or print\n                                                   #   pipe instructions for humans\n    nimbus-docs add 404-page --print | claude           # explicit pipe to claude\n    nimbus-docs add 404-page --print | codex            # …or any other agent\n`;\n\nasync function main(): Promise<void> {\n  const args = mri(process.argv.slice(2), {\n    boolean: [\"yes\", \"print\", \"help\", \"version\"],\n    string: [\"type\"],\n    alias: { y: \"yes\", h: \"help\", v: \"version\" },\n  }) as unknown as CliArgs;\n\n  if (args.help) {\n    process.stdout.write(HELP);\n    return;\n  }\n  if (args.version) {\n    process.stdout.write(`${__APP_VERSION__}\\n`);\n    return;\n  }\n\n  const [command, slug] = args._;\n\n  if (command === \"list\" || (command === \"add\" && !slug) || !command) {\n    listCommand(args.type);\n    return;\n  }\n\n  if (command === \"add\") {\n    await addCommand(slug!, {\n      yes: args.yes,\n      print: args.print,\n    });\n    return;\n  }\n\n  p.log.error(`Unknown command: \\`${command}\\`. Try \\`nimbus-docs --help\\`.`);\n  process.exit(1);\n}\n\n// ---------------------------------------------------------------------------\n// `nimbus-docs list`\n// ---------------------------------------------------------------------------\n\nfunction listCommand(typeFilter: string | undefined): void {\n  const typeMap: Record<string, \"registry:ui\" | \"registry:lib\" | \"registry:feature\"> = {\n    ui: \"registry:ui\",\n    lib: \"registry:lib\",\n    feature: \"registry:feature\",\n  };\n\n  const filter =\n    typeFilter && typeFilter in typeMap\n      ? { type: typeMap[typeFilter] }\n      : undefined;\n\n  if (typeFilter && !(typeFilter in typeMap)) {\n    p.log.error(\n      `Unknown --type \"${typeFilter}\". Valid: ui, lib, feature.`,\n    );\n    process.exit(1);\n  }\n\n  const items = listEntries(filter);\n  if (items.length === 0) {\n    p.log.info(\"No items match the filter.\");\n    return;\n  }\n\n  // Group by type for readability.\n  const grouped: Record<string, typeof items> = {\n    \"registry:ui\": [],\n    \"registry:lib\": [],\n    \"registry:feature\": [],\n  };\n  for (const item of items) grouped[item.type]!.push(item);\n\n  const labels: Record<string, string> = {\n    \"registry:ui\": \"Components\",\n    \"registry:lib\": \"Utilities\",\n    \"registry:feature\": \"Features\",\n  };\n  const widths = items.reduce(\n    (m, i) => Math.max(m, i.name.length),\n    0,\n  );\n\n  process.stdout.write(\"\\n\");\n  for (const [type, label] of Object.entries(labels)) {\n    const group = grouped[type];\n    if (!group || group.length === 0) continue;\n    process.stdout.write(`  ${label}\\n`);\n    for (const item of group) {\n      process.stdout.write(\n        `    ${item.name.padEnd(widths + 2)}${item.description}\\n`,\n      );\n    }\n    process.stdout.write(\"\\n\");\n  }\n  process.stdout.write(\n    `  Install:  nimbus-docs add <name>     ·  ${items.length} item${items.length === 1 ? \"\" : \"s\"}\\n\\n`,\n  );\n}\n\n// ---------------------------------------------------------------------------\n// `nimbus-docs add <slug>`\n// ---------------------------------------------------------------------------\n\nasync function addCommand(\n  slug: string,\n  flags: { yes: boolean; print: boolean },\n): Promise<void> {\n  const entry = getIndexEntry(slug);\n  if (!entry) {\n    p.log.error(\n      `Unknown registry item: \\`${slug}\\`. Try \\`nimbus-docs list\\` to see what's available.`,\n    );\n    process.exit(1);\n  }\n\n  if (entry.type === \"registry:feature\") {\n    await installFeature(slug, { print: flags.print });\n    return;\n  }\n\n  // Component / utility path.\n  p.intro(`nimbus-docs add ${slug}`);\n  p.log.info(`${entry.title} — ${entry.description}`);\n\n  const spinner = p.spinner();\n  spinner.start(\"Resolving dependencies\");\n  let items;\n  try {\n    items = await resolveComponentTree(slug);\n    spinner.stop(\n      `Resolved ${items.length} item${items.length === 1 ? \"\" : \"s\"}.`,\n    );\n  } catch (err) {\n    spinner.stop(\"Failed to resolve.\");\n    p.log.error((err as Error).message);\n    process.exit(1);\n  }\n\n  if (items.length > 1) {\n    p.log.message(\n      \"Install order:\\n  \" + items.map((i) => i.name).join(\" → \"),\n    );\n  }\n\n  const report = await installComponents(items, {\n    cwd: process.cwd(),\n    yes: flags.yes,\n  });\n\n  const lines: string[] = [];\n  if (report.written.length > 0) {\n    lines.push(`✓ Wrote ${report.written.length} file${report.written.length === 1 ? \"\" : \"s\"}`);\n  }\n  if (report.skipped.length > 0) {\n    lines.push(`↷ Skipped: ${report.skipped.join(\", \")}`);\n  }\n  if (report.npmDepsInstalled.length > 0) {\n    lines.push(\n      `+ Installed ${report.npmDepsInstalled.length} npm dep${report.npmDepsInstalled.length === 1 ? \"\" : \"s\"}: ${report.npmDepsInstalled.join(\", \")}`,\n    );\n  }\n\n  if (lines.length === 0) {\n    p.outro(\"Nothing to do.\");\n  } else {\n    p.outro(lines.join(\"\\n\"));\n  }\n}\n\n// ---------------------------------------------------------------------------\n// Entrypoint\n// ---------------------------------------------------------------------------\n\nmain().catch((err) => {\n  p.log.error(`${(err as Error).message}`);\n  process.exit(1);\n});\n\n// Tell TS BUNDLED_INDEX is used (so no `verbatimModuleSyntax` warning).\nvoid BUNDLED_INDEX;\n"],"mappings":"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"}
+{"version":3,"file":"index.js","names":["addCommand","addCommand"],"sources":["../../src/cli/_registry.generated.ts","../../src/cli/pm.ts","../../src/cli/component.ts","../../src/cli/dotenv.ts","../../src/cli/resolver.ts","../../src/cli/feature.ts","../../src/cli/index.ts"],"sourcesContent":["/**\n * Bundled registry index — auto-generated by\n * apps/www/scripts/generate-registry.ts. Do not edit by hand.\n *\n * Re-run via: pnpm --filter @nimbus/www generate-registry\n */\n\nexport type RegistryEntryType =\n  | \"registry:ui\"\n  | \"registry:lib\"\n  | \"registry:feature\";\n\nexport interface RegistryIndexEntry {\n  name: string;\n  type: RegistryEntryType;\n  title: string;\n  description: string;\n}\n\nexport interface BundledIndex {\n  version: 1;\n  items: Record<string, RegistryIndexEntry>;\n}\n\nexport const REGISTRY_BASE_URL = \"https://nimbus-docs.com/registry\";\n\nexport const BUNDLED_INDEX: BundledIndex = {\n  \"version\": 1,\n  \"items\": {\n    \"cn\": {\n      \"name\": \"cn\",\n      \"type\": \"registry:lib\",\n      \"title\": \"cn\",\n      \"description\": \"Tailwind-aware className merger built on clsx + tailwind-merge.\"\n    },\n    \"accordion\": {\n      \"name\": \"accordion\",\n      \"type\": \"registry:ui\",\n      \"title\": \"Accordion\",\n      \"description\": \"Vertically stacked collapsible sections.\"\n    },\n    \"aside\": {\n      \"name\": \"aside\",\n      \"type\": \"registry:ui\",\n      \"title\": \"Aside\",\n      \"description\": \"Generic boxed callout. Building block for Callout, Note, Warning.\"\n    },\n    \"badge\": {\n      \"name\": \"badge\",\n      \"type\": \"registry:ui\",\n      \"title\": \"Badge\",\n      \"description\": \"Small status / category pill.\"\n    },\n    \"banner\": {\n      \"name\": \"banner\",\n      \"type\": \"registry:ui\",\n      \"title\": \"Banner\",\n      \"description\": \"Site-wide dismissible announcement bar.\"\n    },\n    \"breadcrumbs\": {\n      \"name\": \"breadcrumbs\",\n      \"type\": \"registry:ui\",\n      \"title\": \"Breadcrumbs\",\n      \"description\": \"Page-context navigation crumbs.\"\n    },\n    \"callout\": {\n      \"name\": \"callout\",\n      \"type\": \"registry:ui\",\n      \"title\": \"Callout\",\n      \"description\": \"Inline note / tip / warning / danger / info card.\"\n    },\n    \"card\": {\n      \"name\": \"card\",\n      \"type\": \"registry:ui\",\n      \"title\": \"Card\",\n      \"description\": \"Generic content card with optional title and footer.\"\n    },\n    \"card-grid\": {\n      \"name\": \"card-grid\",\n      \"type\": \"registry:ui\",\n      \"title\": \"CardGrid\",\n      \"description\": \"Responsive grid layout for cards.\"\n    },\n    \"code\": {\n      \"name\": \"code\",\n      \"type\": \"registry:ui\",\n      \"title\": \"Code\",\n      \"description\": \"Inline / block code wrapper. Re-exports Astro's built-in <Code> (Shiki).\"\n    },\n    \"code-group\": {\n      \"name\": \"code-group\",\n      \"type\": \"registry:ui\",\n      \"title\": \"CodeGroup\",\n      \"description\": \"Tabbed group of code blocks.\"\n    },\n    \"collapsible\": {\n      \"name\": \"collapsible\",\n      \"type\": \"registry:ui\",\n      \"title\": \"Collapsible\",\n      \"description\": \"Headless show/hide primitive — building block for Accordion and Sidebar groups.\"\n    },\n    \"dialog\": {\n      \"name\": \"dialog\",\n      \"type\": \"registry:ui\",\n      \"title\": \"Dialog\",\n      \"description\": \"Modal dialog with focus-trap and body-scroll lock.\"\n    },\n    \"embed\": {\n      \"name\": \"embed\",\n      \"type\": \"registry:ui\",\n      \"title\": \"Embed\",\n      \"description\": \"Responsive iframe / video / external content wrapper.\"\n    },\n    \"file-tree\": {\n      \"name\": \"file-tree\",\n      \"type\": \"registry:ui\",\n      \"title\": \"FileTree\",\n      \"description\": \"Render a directory tree as nested markup.\"\n    },\n    \"frame\": {\n      \"name\": \"frame\",\n      \"type\": \"registry:ui\",\n      \"title\": \"Frame\",\n      \"description\": \"Decorative outer frame for screenshots and demos.\"\n    },\n    \"layer-card\": {\n      \"name\": \"layer-card\",\n      \"type\": \"registry:ui\",\n      \"title\": \"LayerCard\",\n      \"description\": \"Stacked-card container with sticky header. Base for CodeGroup and PackageManagers.\"\n    },\n    \"link-button\": {\n      \"name\": \"link-button\",\n      \"type\": \"registry:ui\",\n      \"title\": \"LinkButton\",\n      \"description\": \"Anchor styled as a button.\"\n    },\n    \"link-card\": {\n      \"name\": \"link-card\",\n      \"type\": \"registry:ui\",\n      \"title\": \"LinkCard\",\n      \"description\": \"Card whose entire surface is a link.\"\n    },\n    \"package-managers\": {\n      \"name\": \"package-managers\",\n      \"type\": \"registry:ui\",\n      \"title\": \"PackageManagers\",\n      \"description\": \"Tabbed install command block translated across npm / pnpm / yarn / bun.\"\n    },\n    \"page-actions\": {\n      \"name\": \"page-actions\",\n      \"type\": \"registry:ui\",\n      \"title\": \"PageActions\",\n      \"description\": \"Inline page-header actions: copy the page as markdown, open the raw .md.\"\n    },\n    \"pagination\": {\n      \"name\": \"pagination\",\n      \"type\": \"registry:ui\",\n      \"title\": \"Pagination\",\n      \"description\": \"Prev / next page navigation.\"\n    },\n    \"popover\": {\n      \"name\": \"popover\",\n      \"type\": \"registry:ui\",\n      \"title\": \"Popover\",\n      \"description\": \"Floating panel anchored to a trigger element.\"\n    },\n    \"search\": {\n      \"name\": \"search\",\n      \"type\": \"registry:ui\",\n      \"title\": \"Search\",\n      \"description\": \"Command-palette search dialog with a provider seam. Defaults to Pagefind.\"\n    },\n    \"sidebar\": {\n      \"name\": \"sidebar\",\n      \"type\": \"registry:ui\",\n      \"title\": \"Sidebar\",\n      \"description\": \"Docs sidebar with nested groups and active-link tracking.\"\n    },\n    \"steps\": {\n      \"name\": \"steps\",\n      \"type\": \"registry:ui\",\n      \"title\": \"Steps\",\n      \"description\": \"Numbered ordered-list with vertical connectors.\"\n    },\n    \"tabs\": {\n      \"name\": \"tabs\",\n      \"type\": \"registry:ui\",\n      \"title\": \"Tabs\",\n      \"description\": \"Tabbed content panels (manual + Starlight-compatible modes).\"\n    },\n    \"theme-toggle\": {\n      \"name\": \"theme-toggle\",\n      \"type\": \"registry:ui\",\n      \"title\": \"ThemeToggle\",\n      \"description\": \"Light / dark theme switcher button.\"\n    },\n    \"toc\": {\n      \"name\": \"toc\",\n      \"type\": \"registry:ui\",\n      \"title\": \"TOC\",\n      \"description\": \"On-page table of contents with active-heading tracking.\"\n    },\n    \"version-switcher\": {\n      \"name\": \"version-switcher\",\n      \"type\": \"registry:ui\",\n      \"title\": \"VersionPicker\",\n      \"description\": \"Header dropdown for switching between docs versions. Reads `versions` from nimbus.config.ts, uses the build-time alternates table to land readers on the same logical page in the target version. Includes deprecation badge and hidden-version exclusion. Renders nothing when versioning is off or only one version is configured.\"\n    },\n    \"404-page\": {\n      \"name\": \"404-page\",\n      \"type\": \"registry:feature\",\n      \"title\": \"Custom 404 page\",\n      \"description\": \"Generate a brand-matched 404 page for the docs site.\"\n    },\n    \"ai-native\": {\n      \"name\": \"ai-native\",\n      \"type\": \"registry:feature\",\n      \"title\": \"AI-native static surface\",\n      \"description\": \"Add llms.txt, markdown variants, robots.txt, and an AgentDirective to a Nimbus docs site.\"\n    },\n    \"component-showcase\": {\n      \"name\": \"component-showcase\",\n      \"type\": \"registry:feature\",\n      \"title\": \"Component showcase\",\n      \"description\": \"Add a /components grid landing plus per-component showcase pages at /components/<slug>, driven by a dedicated content collection. For sites documenting their own UI library.\"\n    },\n    \"new-collection\": {\n      \"name\": \"new-collection\",\n      \"type\": \"registry:feature\",\n      \"title\": \"Add a new collection\",\n      \"description\": \"End-to-end setup for a non-version content tree on a Nimbus docs site — blog, API reference, changelog, glossary. Creates the folder, registers the collection, scaffolds routes. For docs versions, use `nimbus-docs add new-version`.\"\n    },\n    \"new-version\": {\n      \"name\": \"new-version\",\n      \"type\": \"registry:feature\",\n      \"title\": \"Add a docs version\",\n      \"description\": \"End-to-end setup for adding a docs version to a Nimbus site. Creates the content directory, registers the collection, scaffolds routes, declares the manifest, installs the version-switcher picker, and wires it into your Header and DocsLayout. One command for one mental task.\"\n    },\n    \"pagefind-search\": {\n      \"name\": \"pagefind-search\",\n      \"type\": \"registry:feature\",\n      \"title\": \"Pagefind search\",\n      \"description\": \"Add static Pagefind indexing and the Nimbus search dialog to an existing docs site.\"\n    }\n  }\n};\n","/**\n * Package-manager detection + install command helpers.\n *\n * Detection prefers lockfile presence in the user's cwd, then falls back\n * to the `npm_config_user_agent` env var the active package manager sets\n * when invoking the CLI. Finally falls back to `npm`.\n */\n\nimport { existsSync } from \"node:fs\";\nimport { join } from \"node:path\";\n\nexport type PackageManager = \"npm\" | \"pnpm\" | \"yarn\" | \"bun\";\n\nconst LOCKFILES: ReadonlyArray<readonly [string, PackageManager]> = [\n  [\"pnpm-lock.yaml\", \"pnpm\"],\n  [\"yarn.lock\", \"yarn\"],\n  [\"bun.lockb\", \"bun\"],\n  [\"bun.lock\", \"bun\"],\n  [\"package-lock.json\", \"npm\"],\n];\n\nexport function detectPackageManager(cwd: string): PackageManager {\n  for (const [lockfile, pm] of LOCKFILES) {\n    if (existsSync(join(cwd, lockfile))) return pm;\n  }\n  const ua = process.env.npm_config_user_agent ?? \"\";\n  if (ua.startsWith(\"pnpm\")) return \"pnpm\";\n  if (ua.startsWith(\"yarn\")) return \"yarn\";\n  if (ua.startsWith(\"bun\")) return \"bun\";\n  return \"npm\";\n}\n\n/**\n * Command + args to install one or more new npm deps. Each PM picks the\n * verb that both adds to package.json AND installs:\n *\n *   npm  install <deps...>\n *   pnpm add     <deps...>\n *   yarn add     <deps...>\n *   bun  add     <deps...>\n */\nexport function addCommand(\n  pm: PackageManager,\n  deps: string[],\n): { bin: string; args: string[] } {\n  if (deps.length === 0) {\n    throw new Error(\"addCommand called with empty deps\");\n  }\n  switch (pm) {\n    case \"npm\":\n      return { bin: \"npm\", args: [\"install\", ...deps] };\n    case \"pnpm\":\n      return { bin: \"pnpm\", args: [\"add\", ...deps] };\n    case \"yarn\":\n      return { bin: \"yarn\", args: [\"add\", ...deps] };\n    case \"bun\":\n      return { bin: \"bun\", args: [\"add\", ...deps] };\n  }\n}\n","/**\n * Component / utility installer.\n *\n * Walks the resolved list of items, writes each file (per-file overwrite\n * prompt on conflict), then collects all npm `dependencies` across the\n * tree and runs `<pm> add` once for the dedup'd set.\n *\n * File destination: `<cwd>/src/<path>`. The `path` field already encodes\n * the directory layout (e.g. `components/ui/dialog/Dialog.astro`).\n */\n\nimport { spawn } from \"node:child_process\";\nimport {\n  existsSync,\n  mkdirSync,\n  readFileSync,\n  writeFileSync,\n} from \"node:fs\";\nimport { dirname, join, relative } from \"node:path\";\n\nimport * as p from \"@clack/prompts\";\n\nimport { addCommand, detectPackageManager } from \"./pm.js\";\nimport type { ComponentItem } from \"./resolver.js\";\n\nexport interface InstallOptions {\n  /** User's project root. */\n  cwd: string;\n  /** Skip overwrite prompts; assume \"overwrite\" on every conflict. */\n  yes: boolean;\n}\n\nexport interface InstallReport {\n  /** Individual files actually written. */\n  written: string[];\n  /** Registry slugs skipped wholesale by the user. */\n  skipped: string[];\n  npmDepsInstalled: string[];\n}\n\nexport async function installComponents(\n  items: ComponentItem[],\n  options: InstallOptions,\n): Promise<InstallReport> {\n  const report: InstallReport = {\n    written: [],\n    skipped: [],\n    npmDepsInstalled: [],\n  };\n\n  // ---- 1. Write files — atomic per registry item -------------------------\n  //\n  // Each item (e.g. `dialog`) is treated as an indivisible unit: when any\n  // of its files conflict, we prompt once for the whole slug. Letting users\n  // overwrite Dialog.astro while keeping DialogContent.astro is a footgun\n  // — components are cohesive and meant to evolve together.\n  const srcDir = join(options.cwd, \"src\");\n\n  for (const item of items) {\n    const filePlans = item.files.map((file) => {\n      const targetAbs = join(srcDir, file.path);\n      return {\n        targetAbs,\n        targetRel: relative(options.cwd, targetAbs),\n        content: file.content,\n        exists: existsSync(targetAbs),\n      };\n    });\n\n    const conflicts = filePlans.filter((f) => f.exists);\n\n    // Utilities (registry:lib) are transitive dependencies of UI\n    // components — install silently when missing, skip silently when\n    // present. Never prompt or overwrite: users may have customized\n    // them (e.g. cn) and being asked about `cn` every time you `add` a\n    // component is noise.\n    if (item.type === \"registry:lib\") {\n      if (conflicts.length > 0) {\n        report.skipped.push(item.name);\n        continue;\n      }\n    } else if (conflicts.length > 0 && !options.yes) {\n      const total = filePlans.length;\n      const message =\n        conflicts.length === total\n          ? `${item.name} is already installed (${total} file${total === 1 ? \"\" : \"s\"}). Overwrite?`\n          : `${item.name} is partially installed (${conflicts.length} of ${total} file${total === 1 ? \"\" : \"s\"} present). Overwrite all?`;\n\n      const choice = await p.select({\n        message,\n        options: [\n          { value: \"overwrite\", label: \"Overwrite — replace existing files\" },\n          { value: \"skip\", label: \"Skip — leave files as-is\" },\n          { value: \"cancel\", label: \"Cancel install\" },\n        ],\n        initialValue: \"overwrite\",\n      });\n\n      if (p.isCancel(choice) || choice === \"cancel\") {\n        p.cancel(\"Cancelled.\");\n        process.exit(0);\n      }\n      if (choice === \"skip\") {\n        report.skipped.push(item.name);\n        continue;\n      }\n    }\n\n    // Either no conflicts, --yes, or user chose overwrite. Write every file.\n    for (const plan of filePlans) {\n      mkdirSync(dirname(plan.targetAbs), { recursive: true });\n      writeFileSync(plan.targetAbs, plan.content);\n      report.written.push(plan.targetRel);\n    }\n  }\n\n  // ---- 2. Install missing npm deps ---------------------------------------\n  const allDeps = new Set<string>();\n  for (const item of items) {\n    for (const dep of item.dependencies) allDeps.add(dep);\n  }\n\n  if (allDeps.size > 0) {\n    const newDeps = filterAlreadyInstalled(options.cwd, [...allDeps]);\n    if (newDeps.length > 0) {\n      const pm = detectPackageManager(options.cwd);\n      const { bin, args } = addCommand(pm, newDeps);\n      const spinner = p.spinner();\n      spinner.start(`${pm} add ${newDeps.join(\" \")}`);\n      try {\n        await runCommand(bin, args, options.cwd);\n        spinner.stop(\n          `Installed ${newDeps.length} dep${newDeps.length === 1 ? \"\" : \"s\"}.`,\n        );\n        report.npmDepsInstalled = newDeps;\n      } catch (err) {\n        spinner.stop(\"Dependency install failed.\");\n        p.log.warn(\n          `Could not install ${newDeps.join(\", \")}. Run \\`${bin} ${args.join(\" \")}\\` manually.`,\n        );\n      }\n    }\n  }\n\n  return report;\n}\n\n/**\n * Filter out deps already present in `dependencies` or `devDependencies`\n * of the user's package.json. If package.json is missing, returns all.\n */\nfunction filterAlreadyInstalled(cwd: string, deps: string[]): string[] {\n  const pkgPath = join(cwd, \"package.json\");\n  if (!existsSync(pkgPath)) return deps;\n  try {\n    const pkg = JSON.parse(readFileSync(pkgPath, \"utf8\")) as {\n      dependencies?: Record<string, string>;\n      devDependencies?: Record<string, string>;\n    };\n    const installed = new Set([\n      ...Object.keys(pkg.dependencies ?? {}),\n      ...Object.keys(pkg.devDependencies ?? {}),\n    ]);\n    return deps.filter((d) => !installed.has(d));\n  } catch {\n    return deps;\n  }\n}\n\nfunction runCommand(\n  bin: string,\n  args: string[],\n  cwd: string,\n): Promise<void> {\n  return new Promise((resolveP, rejectP) => {\n    const child = spawn(bin, args, {\n      cwd,\n      stdio: [\"ignore\", \"ignore\", \"inherit\"],\n    });\n    child.on(\"close\", (code) =>\n      code === 0\n        ? resolveP()\n        : rejectP(new Error(`${bin} ${args.join(\" \")} exited ${code}`)),\n    );\n    child.on(\"error\", rejectP);\n  });\n}\n","/**\n * Tiny .env loader — no dependency.\n *\n * Reads `.env` from the user's cwd at CLI startup and sets any KEY=VALUE\n * pairs into `process.env` IF the variable isn't already set (so a shell-\n * provided env always wins over the file). Supports the basic cases:\n *\n *   KEY=value\n *   KEY=\"quoted value\"\n *   KEY='quoted value'\n *   # comments\n *\n * Used so `examples/local/.env` can carry `NIMBUS_REGISTRY_URL=...` without\n * the user having to prefix every CLI invocation.\n */\n\nimport { existsSync, readFileSync } from \"node:fs\";\nimport { join } from \"node:path\";\n\nexport function loadDotenv(cwd: string): void {\n  const path = join(cwd, \".env\");\n  if (!existsSync(path)) return;\n\n  let raw: string;\n  try {\n    raw = readFileSync(path, \"utf8\");\n  } catch {\n    return;\n  }\n\n  for (const rawLine of raw.split(/\\r?\\n/)) {\n    const line = rawLine.trim();\n    if (!line || line.startsWith(\"#\")) continue;\n\n    const eq = line.indexOf(\"=\");\n    if (eq <= 0) continue;\n\n    const key = line.slice(0, eq).trim();\n    if (!/^[A-Z_][A-Z0-9_]*$/i.test(key)) continue;\n\n    let value = line.slice(eq + 1).trim();\n    if (\n      (value.startsWith('\"') && value.endsWith('\"')) ||\n      (value.startsWith(\"'\") && value.endsWith(\"'\"))\n    ) {\n      value = value.slice(1, -1);\n    }\n\n    if (process.env[key] === undefined) {\n      process.env[key] = value;\n    }\n  }\n}\n","/**\n * Registry resolver.\n *\n * Two entry points:\n *\n *   - `resolveComponentTree(slug)` walks `registryDependencies` transitively\n *     and returns a flat ordered list of components/utilities to install\n *     (dependencies first, root last). Cycles are detected as repeated\n *     visits and skipped.\n *\n *   - `fetchFeatureMarkdown(slug)` returns the raw markdown for an\n *     agent-handoff feature; the caller decides what to do with it.\n *\n * The base URL for hosted artifacts is read from the bundled index, with\n * an `NIMBUS_REGISTRY_URL` env override for local development.\n */\n\nimport {\n  BUNDLED_INDEX,\n  REGISTRY_BASE_URL,\n  type RegistryIndexEntry,\n} from \"./_registry.generated.js\";\n\nexport interface RegistryFile {\n  path: string;\n  content: string;\n}\n\nexport interface ComponentItem {\n  name: string;\n  type: \"registry:ui\" | \"registry:lib\";\n  title: string;\n  description: string;\n  dependencies: string[];\n  registryDependencies: string[];\n  files: RegistryFile[];\n}\n\n/**\n * Read the registry base URL on every call so `.env` files loaded after\n * module-import time (see cli/dotenv.ts) are picked up. The cost is\n * negligible — string interpolation of an env var.\n */\nfunction getBaseUrl(): string {\n  return (process.env.NIMBUS_REGISTRY_URL ?? REGISTRY_BASE_URL).replace(\n    /\\/$/,\n    \"\",\n  );\n}\n\n// ---------------------------------------------------------------------------\n// Index lookup (offline — no network)\n// ---------------------------------------------------------------------------\n\nexport function getIndexEntry(slug: string): RegistryIndexEntry | undefined {\n  return BUNDLED_INDEX.items[slug];\n}\n\nexport function listEntries(filter?: {\n  type?: RegistryIndexEntry[\"type\"];\n}): RegistryIndexEntry[] {\n  const all = Object.values(BUNDLED_INDEX.items);\n  if (!filter?.type) return all;\n  return all.filter((e) => e.type === filter.type);\n}\n\n// ---------------------------------------------------------------------------\n// Network: component JSON + feature markdown\n// ---------------------------------------------------------------------------\n\nasync function httpGet(url: string): Promise<Response> {\n  let res: Response;\n  try {\n    res = await fetch(url);\n  } catch (err) {\n    const cause = (err as Error).message;\n    throw new Error(\n      `Could not reach the registry at ${url}.\\n` +\n        `  Underlying error: ${cause}\\n\\n` +\n        `  Things to try:\\n` +\n        `    - Is the registry server running? Start it with \\`pnpm local\\` (in the monorepo root).\\n` +\n        `    - Override the URL: NIMBUS_REGISTRY_URL=https://example.com nimbus-docs add ...\\n` +\n        `    - Check the value in your project's .env file.`,\n    );\n  }\n  if (!res.ok) {\n    throw new Error(\n      `Registry returned ${res.status} ${res.statusText} for ${url}. ` +\n        `The server is up but doesn't know about this slug — check \\`nimbus-docs list\\` for valid names.`,\n    );\n  }\n  return res;\n}\n\nexport async function fetchComponent(slug: string): Promise<ComponentItem> {\n  const res = await httpGet(`${getBaseUrl()}/components/${slug}.json`);\n  return (await res.json()) as ComponentItem;\n}\n\nexport async function fetchFeatureMarkdown(slug: string): Promise<string> {\n  const res = await httpGet(`${getBaseUrl()}/features/${slug}.md`);\n  return await res.text();\n}\n\n// ---------------------------------------------------------------------------\n// Transitive dep resolution\n// ---------------------------------------------------------------------------\n\n/**\n * Depth-first walk of registryDependencies. Returns items in install order\n * (deps before dependents), deduplicated by slug.\n */\nexport async function resolveComponentTree(\n  rootSlug: string,\n): Promise<ComponentItem[]> {\n  const visited = new Set<string>();\n  const ordered: ComponentItem[] = [];\n\n  async function visit(slug: string): Promise<void> {\n    if (visited.has(slug)) return;\n    visited.add(slug);\n\n    const item = await fetchComponent(slug);\n\n    // Walk deps first so they're earlier in the install order.\n    for (const dep of item.registryDependencies) {\n      await visit(dep);\n    }\n\n    ordered.push(item);\n  }\n\n  await visit(rootSlug);\n  return ordered;\n}\n","/**\n * Feature installer — Flue-style agent-handoff.\n *\n * Same rule Flue uses for `flue add`: if `--print` is set OR\n * `determineAgent()` says the CLI is running inside a known coding agent,\n * the markdown is piped to stdout for the agent to consume. Otherwise we\n * print human-friendly instructions on stderr telling the user exactly\n * how to pipe the output to their agent of choice.\n *\n * No picker, no clipboard mode — the printed pipe commands cover both.\n */\n\nimport { determineAgent } from \"@vercel/detect-agent\";\n\nimport { fetchFeatureMarkdown } from \"./resolver.js\";\n\nexport interface FeatureInstallOptions {\n  /** Force markdown to stdout regardless of agent detection. */\n  print: boolean;\n}\n\nexport async function installFeature(\n  slug: string,\n  options: FeatureInstallOptions,\n): Promise<void> {\n  const markdown = await fetchFeatureMarkdown(slug);\n\n  // Same predicate as Flue: explicit --print, or detection says we're\n  // running inside a known agent (which captures our stdout).\n  const detected = await determineAgent().catch(() => ({\n    isAgent: false as const,\n  }));\n  const isAgentMode = options.print || detected.isAgent === true;\n\n  if (isAgentMode) {\n    process.stdout.write(markdown);\n    if (!markdown.endsWith(\"\\n\")) process.stdout.write(\"\\n\");\n    return;\n  }\n\n  printHumanInstructions(slug);\n}\n\n/**\n * Stderr-only. We don't put this on stdout because if the user pipes our\n * output anywhere by accident, only the markdown should reach the agent.\n *\n * Formatting mirrors Flue's `printHumanInstructions` 1:1 — agents listed\n * with a blank line between the \"first-tier\" CLIs (claude/codex/cursor-agent)\n * and the rest (opencode/pi).\n */\nfunction printHumanInstructions(slug: string): void {\n  const cmd = `nimbus-docs add ${slug}`;\n  const stream = process.stderr;\n  stream.write(`${cmd}\\n\\n`);\n  stream.write(\"To install this feature, pipe it to your coding agent:\\n\\n\");\n  stream.write(`  ${cmd} --print | claude\\n`);\n  stream.write(`  ${cmd} --print | codex\\n`);\n  stream.write(`  ${cmd} --print | cursor-agent\\n\\n`);\n  stream.write(`  ${cmd} --print | opencode\\n`);\n  stream.write(`  ${cmd} --print | pi\\n`);\n  stream.write(\"Or paste this prompt into any agent:\\n\\n\");\n  stream.write(`  Run \"${cmd} --print\" and follow the instructions.\\n`);\n}\n","#!/usr/bin/env node\n\n/**\n * `nimbus-docs` CLI entry.\n *\n * Surface:\n *\n *   nimbus                        → list (table of installable items)\n *   nimbus-docs list                   → list\n *   nimbus-docs list --type ui|lib|feature\n *   nimbus-docs add                    → list\n *   nimbus-docs add <slug>             → install (component path or feature path)\n *   nimbus-docs add <slug> --yes       → component: skip overwrite prompts\n *   nimbus-docs add <slug> --print     → feature: print markdown to stdout (skip detect)\n *\n * Feature behavior mirrors Flue's `add` command: print markdown to stdout\n * iff `--print` OR an agent is detected; otherwise print human-friendly\n * pipe instructions to stderr.\n *\n * The bundled index makes `list` (and `add` with no slug) work offline.\n * Per-item content is fetched from `REGISTRY_BASE_URL` only when actually\n * installing a slug — override via `NIMBUS_REGISTRY_URL` for local dev.\n */\n\nimport mri from \"mri\";\nimport * as p from \"@clack/prompts\";\n\nimport { BUNDLED_INDEX } from \"./_registry.generated.js\";\nimport { installComponents } from \"./component.js\";\nimport { loadDotenv } from \"./dotenv.js\";\nimport { installFeature } from \"./feature.js\";\nimport {\n  getIndexEntry,\n  listEntries,\n  resolveComponentTree,\n} from \"./resolver.js\";\n\n// Load .env from the user's cwd so per-project NIMBUS_REGISTRY_URL (and\n// any future env vars) work without shell prefixes. Shell-provided vars\n// always win (loadDotenv only sets undefined keys).\nloadDotenv(process.cwd());\n\ndeclare const __APP_VERSION__: string;\n\ninterface CliArgs {\n  _: string[];\n  yes: boolean;\n  print: boolean;\n  help: boolean;\n  version: boolean;\n  type?: string;\n}\n\nconst HELP = `\n  Usage: nimbus-docs <command> [args]\n\n  Commands:\n    list [--type ui|lib|feature]   List available registry items\n    add                            Same as \\`list\\`\n    add <slug>                     Install a component or hand off a feature\n\n  Flags:\n    --yes, -y                      Component: overwrite conflicts without prompting\n    --print                        Feature: print markdown to stdout (skip agent detect)\n    --type <ui|lib|feature>        \\`list\\`: filter by type\n    --help, -h\n    --version, -v\n\n  Examples:\n    nimbus-docs add dialog                              # component: resolve + install\n    nimbus-docs add 404-page                            # feature: detect agent or print\n                                                   #   pipe instructions for humans\n    nimbus-docs add 404-page --print | claude           # explicit pipe to claude\n    nimbus-docs add 404-page --print | codex            # …or any other agent\n`;\n\nasync function main(): Promise<void> {\n  const args = mri(process.argv.slice(2), {\n    boolean: [\"yes\", \"print\", \"help\", \"version\"],\n    string: [\"type\"],\n    alias: { y: \"yes\", h: \"help\", v: \"version\" },\n  }) as unknown as CliArgs;\n\n  if (args.help) {\n    process.stdout.write(HELP);\n    return;\n  }\n  if (args.version) {\n    process.stdout.write(`${__APP_VERSION__}\\n`);\n    return;\n  }\n\n  const [command, slug] = args._;\n\n  if (command === \"list\" || (command === \"add\" && !slug) || !command) {\n    listCommand(args.type);\n    return;\n  }\n\n  if (command === \"add\") {\n    await addCommand(slug!, {\n      yes: args.yes,\n      print: args.print,\n    });\n    return;\n  }\n\n  p.log.error(`Unknown command: \\`${command}\\`. Try \\`nimbus-docs --help\\`.`);\n  process.exit(1);\n}\n\n// ---------------------------------------------------------------------------\n// `nimbus-docs list`\n// ---------------------------------------------------------------------------\n\nfunction listCommand(typeFilter: string | undefined): void {\n  const typeMap: Record<string, \"registry:ui\" | \"registry:lib\" | \"registry:feature\"> = {\n    ui: \"registry:ui\",\n    lib: \"registry:lib\",\n    feature: \"registry:feature\",\n  };\n\n  const filter =\n    typeFilter && typeFilter in typeMap\n      ? { type: typeMap[typeFilter] }\n      : undefined;\n\n  if (typeFilter && !(typeFilter in typeMap)) {\n    p.log.error(\n      `Unknown --type \"${typeFilter}\". Valid: ui, lib, feature.`,\n    );\n    process.exit(1);\n  }\n\n  const items = listEntries(filter);\n  if (items.length === 0) {\n    p.log.info(\"No items match the filter.\");\n    return;\n  }\n\n  // Group by type for readability.\n  const grouped: Record<string, typeof items> = {\n    \"registry:ui\": [],\n    \"registry:lib\": [],\n    \"registry:feature\": [],\n  };\n  for (const item of items) grouped[item.type]!.push(item);\n\n  const labels: Record<string, string> = {\n    \"registry:ui\": \"Components\",\n    \"registry:lib\": \"Utilities\",\n    \"registry:feature\": \"Features\",\n  };\n  const widths = items.reduce(\n    (m, i) => Math.max(m, i.name.length),\n    0,\n  );\n\n  process.stdout.write(\"\\n\");\n  for (const [type, label] of Object.entries(labels)) {\n    const group = grouped[type];\n    if (!group || group.length === 0) continue;\n    process.stdout.write(`  ${label}\\n`);\n    for (const item of group) {\n      process.stdout.write(\n        `    ${item.name.padEnd(widths + 2)}${item.description}\\n`,\n      );\n    }\n    process.stdout.write(\"\\n\");\n  }\n  process.stdout.write(\n    `  Install:  nimbus-docs add <name>     ·  ${items.length} item${items.length === 1 ? \"\" : \"s\"}\\n\\n`,\n  );\n}\n\n// ---------------------------------------------------------------------------\n// `nimbus-docs add <slug>`\n// ---------------------------------------------------------------------------\n\nasync function addCommand(\n  slug: string,\n  flags: { yes: boolean; print: boolean },\n): Promise<void> {\n  const entry = getIndexEntry(slug);\n  if (!entry) {\n    p.log.error(\n      `Unknown registry item: \\`${slug}\\`. Try \\`nimbus-docs list\\` to see what's available.`,\n    );\n    process.exit(1);\n  }\n\n  if (entry.type === \"registry:feature\") {\n    await installFeature(slug, { print: flags.print });\n    return;\n  }\n\n  // Component / utility path.\n  p.intro(`nimbus-docs add ${slug}`);\n  p.log.info(`${entry.title} — ${entry.description}`);\n\n  const spinner = p.spinner();\n  spinner.start(\"Resolving dependencies\");\n  let items;\n  try {\n    items = await resolveComponentTree(slug);\n    spinner.stop(\n      `Resolved ${items.length} item${items.length === 1 ? \"\" : \"s\"}.`,\n    );\n  } catch (err) {\n    spinner.stop(\"Failed to resolve.\");\n    p.log.error((err as Error).message);\n    process.exit(1);\n  }\n\n  if (items.length > 1) {\n    p.log.message(\n      \"Install order:\\n  \" + items.map((i) => i.name).join(\" → \"),\n    );\n  }\n\n  const report = await installComponents(items, {\n    cwd: process.cwd(),\n    yes: flags.yes,\n  });\n\n  const lines: string[] = [];\n  if (report.written.length > 0) {\n    lines.push(`✓ Wrote ${report.written.length} file${report.written.length === 1 ? \"\" : \"s\"}`);\n  }\n  if (report.skipped.length > 0) {\n    lines.push(`↷ Skipped: ${report.skipped.join(\", \")}`);\n  }\n  if (report.npmDepsInstalled.length > 0) {\n    lines.push(\n      `+ Installed ${report.npmDepsInstalled.length} npm dep${report.npmDepsInstalled.length === 1 ? \"\" : \"s\"}: ${report.npmDepsInstalled.join(\", \")}`,\n    );\n  }\n\n  if (lines.length === 0) {\n    p.outro(\"Nothing to do.\");\n  } else {\n    p.outro(lines.join(\"\\n\"));\n  }\n}\n\n// ---------------------------------------------------------------------------\n// Entrypoint\n// ---------------------------------------------------------------------------\n\nmain().catch((err) => {\n  p.log.error(`${(err as Error).message}`);\n  process.exit(1);\n});\n\n// Tell TS BUNDLED_INDEX is used (so no `verbatimModuleSyntax` warning).\nvoid BUNDLED_INDEX;\n"],"mappings":"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"}

package/dist/content.d.ts

@@ -107,6 +107,7 @@ declare function docsCollection(options?: DocsCollectionOptions): {
       link: z.ZodOptional<z.ZodString>;
       label: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>, z.ZodLiteral<false>]>>;
+    previousSlug: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>>;
   }, z.core.$strip> | z.ZodObject<{
     [x: string]: z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>;
   }, z.core.$strip>;
@@ -121,6 +122,40 @@ declare function partialsCollection(options?: PartialsCollectionOptions): {
     params: z.ZodOptional<z.ZodArray<z.ZodString>>;
   }, z.core.$strip>>;
 };
+interface ComponentsCollectionOptions {
+  /**
+   * Directory under `src/content/` to load component entries from.
+   * Default: `"components"`.
+   */
+  base?: string;
+  /**
+   * Glob pattern relative to `base`.
+   * Default: `"**\/*.{md,mdx}"`.
+   */
+  pattern?: string;
+}
+/**
+ * Returns an Astro content-collection config (`{ loader, schema }`) for the
+ * components collection — for sites documenting their own UI components.
+ *
+ * Pairs with the `component-showcase` registry recipe, which installs the
+ * matching `<Showcase>` / `<Example>` MDX wrappers and the `/components`
+ * route. Frontmatter shape: `{ title, tagline, props }`.
+ */
+declare function componentsCollection(options?: ComponentsCollectionOptions): {
+  loader: astro_loaders0.Loader;
+  schema: z.ZodObject<{
+    title: z.ZodString;
+    tagline: z.ZodString;
+    props: z.ZodDefault<z.ZodArray<z.ZodObject<{
+      name: z.ZodString;
+      type: z.ZodString;
+      defaultValue: z.ZodOptional<z.ZodString>;
+      required: z.ZodDefault<z.ZodBoolean>;
+      description: z.ZodString;
+    }, z.core.$strip>>>;
+  }, z.core.$strip>;
+};
 //#endregion
-export { DocsCollectionOptions, PartialsCollectionOptions, docsCollection, partialsCollection };
+export { ComponentsCollectionOptions, DocsCollectionOptions, PartialsCollectionOptions, componentsCollection, docsCollection, partialsCollection };
 //# sourceMappingURL=content.d.ts.map

package/dist/content.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"content.d.ts","names":[],"sources":["../src/content.ts"],"mappings":";;;;UAyBiB,qBAAA;EAsCD;;;;EAjCd,IAAA;;;;;EAKA,OAAA;;;;;;EAMA,YAAA,GAAe,MAAA,SAAe,CAAA,CAAE,UAAA;AAAA;AAAA,UAGjB,yBAAA;;;;;EAKf,IAAA;;;;;EAKA,OAAA;AAAA;;;;;iBASc,cAAA,CAAe,OAAA,GAAS,qBAAA;UAA0B,cAAA,CAAA,MAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAelD,kBAAA,CAAmB,OAAA,GAAS,yBAAA;UAA8B,cAAA,CAAA,MAAA"}
+{"version":3,"file":"content.d.ts","names":[],"sources":["../src/content.ts"],"mappings":";;;;UAyBiB,qBAAA;EAsCD;;;;EAjCd,IAAA;;;;;EAKA,OAAA;;;;;;EAMA,YAAA,GAAe,MAAA,SAAe,CAAA,CAAE,UAAA;AAAA;AAAA,UAGjB,yBAAA;;;;;EAKf,IAAA;;;;;EAKA,OAAA;AAAA;;;;;iBASc,cAAA,CAAe,OAAA,GAAS,qBAAA;UAA0B,cAAA,CAAA,MAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAelD,kBAAA,CAAmB,OAAA,GAAS,yBAAA;UAA8B,cAAA,CAAA,MAAA;;;;;UAUzD,2BAAA;;;;;EAKf,IAAA;;;;;EAKA,OAAA;AAAA;;;;;;;;;iBAWc,oBAAA,CAAqB,OAAA,GAAS,2BAAA;UAAgC,cAAA,CAAA,MAAA"}

package/dist/content.js

@@ -1,4 +1,4 @@
-import { defineDocSchema, partialsSchema } from "./schemas.js";
+import { componentsSchema, defineDocSchema, partialsSchema } from "./schemas.js";
 import { glob } from "astro/loaders";
 
 //#region src/content.ts
@@ -51,7 +51,24 @@ function partialsCollection(options = {}) {
 		schema: partialsSchema
 	};
 }
+/**
+* Returns an Astro content-collection config (`{ loader, schema }`) for the
+* components collection — for sites documenting their own UI components.
+*
+* Pairs with the `component-showcase` registry recipe, which installs the
+* matching `<Showcase>` / `<Example>` MDX wrappers and the `/components`
+* route. Frontmatter shape: `{ title, tagline, props }`.
+*/
+function componentsCollection(options = {}) {
+	return {
+		loader: glob({
+			base: `./src/content/${options.base ?? "components"}`,
+			pattern: options.pattern ?? DEFAULT_PATTERN
+		}),
+		schema: componentsSchema
+	};
+}
 
 //#endregion
-export { docsCollection, partialsCollection };
+export { componentsCollection, docsCollection, partialsCollection };
 //# sourceMappingURL=content.js.map

package/dist/content.js.map

@@ -1 +1 @@
-{"version":3,"file":"content.js","names":[],"sources":["../src/content.ts"],"sourcesContent":["/**\n * Content collection helpers for `nimbus-docs/content`.\n *\n * Users plug these into their `src/content.config.ts`:\n *\n *   import { defineCollection } from \"astro:content\";\n *   import { docsCollection, partialsCollection } from \"nimbus-docs/content\";\n *\n *   export const collections = {\n *     docs: defineCollection(docsCollection()),\n *     partials: defineCollection(partialsCollection()),\n *   };\n *\n * Extend the docs schema with extra frontmatter fields:\n *\n *   docs: defineCollection(docsCollection({\n *     schemaFields: { author: z.string(), tags: z.array(z.string()) },\n *   })),\n */\n\nimport { glob } from \"astro/loaders\";\nimport type { z } from \"astro/zod\";\n\nimport { defineDocSchema, partialsSchema } from \"./schemas.js\";\n\nexport interface DocsCollectionOptions {\n  /**\n   * Directory under `src/content/` to load docs from.\n   * Default: `\"docs\"`.\n   */\n  base?: string;\n  /**\n   * Glob pattern relative to `base`.\n   * Default: `\"** /*.{md,mdx}\"` (space added to avoid breaking this comment).\n   */\n  pattern?: string;\n  /**\n   * Extra fields merged into the default docs schema. Lets users add\n   * project-specific frontmatter (author, tags, etc.) without rebuilding\n   * the whole schema.\n   */\n  schemaFields?: Record<string, z.ZodTypeAny>;\n}\n\nexport interface PartialsCollectionOptions {\n  /**\n   * Directory under `src/content/` to load partials from.\n   * Default: `\"partials\"`.\n   */\n  base?: string;\n  /**\n   * Glob pattern relative to `base`.\n   * Default: `\"** /*.{md,mdx}\"`.\n   */\n  pattern?: string;\n}\n\nconst DEFAULT_PATTERN = \"**/*.{md,mdx}\";\n\n/**\n * Returns an Astro content-collection config (`{ loader, schema }`) for the\n * docs collection. Pass to `defineCollection()`.\n */\nexport function docsCollection(options: DocsCollectionOptions = {}) {\n  const base = `./src/content/${options.base ?? \"docs\"}`;\n  const pattern = options.pattern ?? DEFAULT_PATTERN;\n  const schema = defineDocSchema({ fields: options.schemaFields });\n\n  return {\n    loader: glob({ base, pattern }),\n    schema,\n  };\n}\n\n/**\n * Returns an Astro content-collection config (`{ loader, schema }`) for the\n * partials collection. Pass to `defineCollection()`.\n */\nexport function partialsCollection(options: PartialsCollectionOptions = {}) {\n  const base = `./src/content/${options.base ?? \"partials\"}`;\n  const pattern = options.pattern ?? DEFAULT_PATTERN;\n\n  return {\n    loader: glob({ base, pattern }),\n    schema: partialsSchema,\n  };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;AAyDA,MAAM,kBAAkB;;;;;AAMxB,SAAgB,eAAe,UAAiC,EAAE,EAAE;CAClE,MAAM,OAAO,iBAAiB,QAAQ,QAAQ;CAC9C,MAAM,UAAU,QAAQ,WAAW;CACnC,MAAM,SAAS,gBAAgB,EAAE,QAAQ,QAAQ,cAAc,CAAC;AAEhE,QAAO;EACL,QAAQ,KAAK;GAAE;GAAM;GAAS,CAAC;EAC/B;EACD;;;;;;AAOH,SAAgB,mBAAmB,UAAqC,EAAE,EAAE;AAI1E,QAAO;EACL,QAAQ,KAAK;GAAE,MAJJ,iBAAiB,QAAQ,QAAQ;GAIvB,SAHP,QAAQ,WAAW;GAGH,CAAC;EAC/B,QAAQ;EACT"}
+{"version":3,"file":"content.js","names":[],"sources":["../src/content.ts"],"sourcesContent":["/**\n * Content collection helpers for `nimbus-docs/content`.\n *\n * Users plug these into their `src/content.config.ts`:\n *\n *   import { defineCollection } from \"astro:content\";\n *   import { docsCollection, partialsCollection } from \"nimbus-docs/content\";\n *\n *   export const collections = {\n *     docs: defineCollection(docsCollection()),\n *     partials: defineCollection(partialsCollection()),\n *   };\n *\n * Extend the docs schema with extra frontmatter fields:\n *\n *   docs: defineCollection(docsCollection({\n *     schemaFields: { author: z.string(), tags: z.array(z.string()) },\n *   })),\n */\n\nimport { glob } from \"astro/loaders\";\nimport type { z } from \"astro/zod\";\n\nimport { componentsSchema, defineDocSchema, partialsSchema } from \"./schemas.js\";\n\nexport interface DocsCollectionOptions {\n  /**\n   * Directory under `src/content/` to load docs from.\n   * Default: `\"docs\"`.\n   */\n  base?: string;\n  /**\n   * Glob pattern relative to `base`.\n   * Default: `\"** /*.{md,mdx}\"` (space added to avoid breaking this comment).\n   */\n  pattern?: string;\n  /**\n   * Extra fields merged into the default docs schema. Lets users add\n   * project-specific frontmatter (author, tags, etc.) without rebuilding\n   * the whole schema.\n   */\n  schemaFields?: Record<string, z.ZodTypeAny>;\n}\n\nexport interface PartialsCollectionOptions {\n  /**\n   * Directory under `src/content/` to load partials from.\n   * Default: `\"partials\"`.\n   */\n  base?: string;\n  /**\n   * Glob pattern relative to `base`.\n   * Default: `\"** /*.{md,mdx}\"`.\n   */\n  pattern?: string;\n}\n\nconst DEFAULT_PATTERN = \"**/*.{md,mdx}\";\n\n/**\n * Returns an Astro content-collection config (`{ loader, schema }`) for the\n * docs collection. Pass to `defineCollection()`.\n */\nexport function docsCollection(options: DocsCollectionOptions = {}) {\n  const base = `./src/content/${options.base ?? \"docs\"}`;\n  const pattern = options.pattern ?? DEFAULT_PATTERN;\n  const schema = defineDocSchema({ fields: options.schemaFields });\n\n  return {\n    loader: glob({ base, pattern }),\n    schema,\n  };\n}\n\n/**\n * Returns an Astro content-collection config (`{ loader, schema }`) for the\n * partials collection. Pass to `defineCollection()`.\n */\nexport function partialsCollection(options: PartialsCollectionOptions = {}) {\n  const base = `./src/content/${options.base ?? \"partials\"}`;\n  const pattern = options.pattern ?? DEFAULT_PATTERN;\n\n  return {\n    loader: glob({ base, pattern }),\n    schema: partialsSchema,\n  };\n}\n\nexport interface ComponentsCollectionOptions {\n  /**\n   * Directory under `src/content/` to load component entries from.\n   * Default: `\"components\"`.\n   */\n  base?: string;\n  /**\n   * Glob pattern relative to `base`.\n   * Default: `\"**\\/*.{md,mdx}\"`.\n   */\n  pattern?: string;\n}\n\n/**\n * Returns an Astro content-collection config (`{ loader, schema }`) for the\n * components collection — for sites documenting their own UI components.\n *\n * Pairs with the `component-showcase` registry recipe, which installs the\n * matching `<Showcase>` / `<Example>` MDX wrappers and the `/components`\n * route. Frontmatter shape: `{ title, tagline, props }`.\n */\nexport function componentsCollection(options: ComponentsCollectionOptions = {}) {\n  const base = `./src/content/${options.base ?? \"components\"}`;\n  const pattern = options.pattern ?? DEFAULT_PATTERN;\n\n  return {\n    loader: glob({ base, pattern }),\n    schema: componentsSchema,\n  };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;AAyDA,MAAM,kBAAkB;;;;;AAMxB,SAAgB,eAAe,UAAiC,EAAE,EAAE;CAClE,MAAM,OAAO,iBAAiB,QAAQ,QAAQ;CAC9C,MAAM,UAAU,QAAQ,WAAW;CACnC,MAAM,SAAS,gBAAgB,EAAE,QAAQ,QAAQ,cAAc,CAAC;AAEhE,QAAO;EACL,QAAQ,KAAK;GAAE;GAAM;GAAS,CAAC;EAC/B;EACD;;;;;;AAOH,SAAgB,mBAAmB,UAAqC,EAAE,EAAE;AAI1E,QAAO;EACL,QAAQ,KAAK;GAAE,MAJJ,iBAAiB,QAAQ,QAAQ;GAIvB,SAHP,QAAQ,WAAW;GAGH,CAAC;EAC/B,QAAQ;EACT;;;;;;;;;;AAwBH,SAAgB,qBAAqB,UAAuC,EAAE,EAAE;AAI9E,QAAO;EACL,QAAQ,KAAK;GAAE,MAJJ,iBAAiB,QAAQ,QAAQ;GAIvB,SAHP,QAAQ,WAAW;GAGH,CAAC;EAC/B,QAAQ;EACT"}