@dowel-ui/registry 0.5.0 → 0.8.0

package/dist/generate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate.js","names":[],"sources":["../src/generate.ts"],"sourcesContent":["import type { RegistryIndex, RegistryIndexEntry } from \"./schema\";\n\nexport type { RegistryIndex, RegistryIndexEntry } from \"./schema\";\n\n/**\n * Turning a description of a screen into a plan made of components that exist.\n *\n * The hard part of generating UI is not writing JSX. It is not inventing: a\n * model asked for a billing page will cheerfully produce `<PricingTable>` and\n * `<InvoiceList>` and a `variant=\"subtle\"` that was never implemented, and the\n * result reads perfectly and compiles nowhere.\n *\n * So this resolves a prompt against the registry first, and everything it\n * emits afterwards is drawn from what came back. It cannot name a component\n * that is not installable, because it only ever repeats names the registry\n * gave it.\n *\n * It does not guess at props. The registry publishes what a component *is* and\n * what it depends on, not the shape of its arguments, so the output stops at\n * the composition and points at the page where the props are documented.\n * Emitting a plausible prop is worse than emitting none — one is a gap, the\n * other is a bug that looks like working code.\n */\n\n/** Words that carry no signal about which component is wanted. */\nconst STOPWORDS = new Set([\n  \"a\",\n  \"an\",\n  \"the\",\n  \"and\",\n  \"or\",\n  \"of\",\n  \"for\",\n  \"with\",\n  \"to\",\n  \"in\",\n  \"on\",\n  \"at\",\n  \"by\",\n  \"is\",\n  \"are\",\n  \"be\",\n  \"make\",\n  \"build\",\n  \"create\",\n  \"want\",\n  \"need\",\n  \"add\",\n  \"show\",\n  \"page\",\n  \"screen\",\n  \"app\",\n  \"application\",\n  \"ui\",\n  \"interface\",\n  \"component\",\n  \"components\",\n  \"me\",\n  \"my\",\n  \"our\",\n  \"i\",\n  \"it\",\n  \"that\",\n  \"this\",\n  \"some\",\n  \"using\",\n  \"use\",\n  \"like\",\n]);\n\n/**\n * Words a reader would use that are not the words the registry uses.\n *\n * Hand-written, and deliberately so. \"Sign in\" is what someone types and\n * `login` is what the item is called; no amount of string similarity bridges\n * that, and pretending otherwise produces a matcher that works on the examples\n * it was tuned against and nothing else.\n */\nconst SYNONYMS: Record<string, string[]> = {\n  \"sign in\": [\"login\"],\n  signin: [\"login\"],\n  \"log in\": [\"login\"],\n  \"sign up\": [\"signup\"],\n  register: [\"signup\"],\n  registration: [\"signup\"],\n  \"forgot password\": [\"forgot-password\"],\n  \"reset password\": [\"forgot-password\"],\n  chat: [\"ai-chat\", \"ai-conversation\", \"ai-prompt-input\"],\n  conversation: [\"ai-chat\"],\n  assistant: [\"ai-chat\"],\n  copilot: [\"ai-chat\"],\n  agent: [\"agent-console\", \"ai-agent-status\", \"ai-agent-plan\"],\n  agents: [\"agent-console\"],\n  tool: [\"ai-tool\"],\n  approval: [\"ai-approval-request\"],\n  approve: [\"ai-approval-request\"],\n  undo: [\"ai-action-ledger\"],\n  audit: [\"ai-action-ledger\", \"activity-feed\"],\n  tokens: [\"ai-token-usage\"],\n  spend: [\"ai-dashboard\", \"billing\"],\n  cost: [\"ai-dashboard\", \"billing\"],\n  usage: [\"ai-dashboard\", \"billing\"],\n  subscription: [\"billing\", \"pricing\"],\n  invoice: [\"billing\"],\n  invoices: [\"billing\"],\n  payment: [\"billing\"],\n  plan: [\"pricing\", \"billing\"],\n  plans: [\"pricing\", \"pricing-three-tier\", \"pricing-two-tier\", \"pricing-single-plan\"],\n  metrics: [\"analytics\", \"dashboard\", \"metric-delta\"],\n  chart: [\"analytics\", \"dither-bar\", \"dither-line\", \"dither-area\", \"dither-donut\"],\n  charts: [\n    \"analytics\",\n    \"dither-canvas\",\n    \"dither-bar\",\n    \"dither-line\",\n    \"dither-area\",\n    \"dither-donut\",\n    \"dither-heatmap\",\n  ],\n  graph: [\"analytics\", \"dither-line\", \"dither-area\", \"contribution-graph\"],\n  stats: [\"dashboard\", \"analytics\", \"stats-grid\", \"stats-trend-cards\"],\n  overview: [\"dashboard\"],\n  grid: [\"data-table\", \"table\"],\n  spreadsheet: [\"data-table\"],\n  list: [\"table\", \"data-table\"],\n  search: [\"command\", \"combobox\", \"expanding-search\", \"faq-searchable\"],\n  palette: [\"command\", \"palette-generator\"],\n  shortcut: [\"command\", \"shortcut-recorder\"],\n  modal: [\"dialog\"],\n  popup: [\"dialog\", \"popover\"],\n  dropdown: [\"dropdown-menu\", \"select\"],\n  toast: [\"toast\"],\n  notification: [\"toast\", \"activity-feed\", \"notification-badge\", \"notify-button\"],\n  notifications: [\"toast\", \"settings\"],\n  upload: [\"file-upload\"],\n  file: [\"file-upload\"],\n  date: [\"date-picker\", \"calendar\"],\n  time: [\"time-range-picker\"],\n  schedule: [\"cron-editor\"],\n  cron: [\"cron-editor\"],\n  team: [\"admin-users\", \"settings\", \"team-grid\", \"team-carousel\"],\n  members: [\"admin-users\"],\n  users: [\"admin-users\"],\n  admin: [\"admin-users\"],\n  permissions: [\"permission-matrix\"],\n  roles: [\"permission-matrix\"],\n  profile: [\"settings\"],\n  preferences: [\"settings\"],\n  account: [\"settings\", \"billing\"],\n  setup: [\"onboarding\"],\n  checklist: [\"onboarding\", \"animated-checklist\", \"todo-tower\"],\n  wizard: [\"onboarding\", \"stepper\"],\n  logs: [\"log-viewer\"],\n  log: [\"log-viewer\"],\n  diff: [\"diff-viewer\", \"record-diff\"],\n  secret: [\"secret-field\"],\n  \"api key\": [\"secret-field\"],\n  key: [\"secret-field\"],\n  dns: [\"dns-record\"],\n  loader: [\n    \"spinner\",\n    \"dots-loader\",\n    \"ring-loader\",\n    \"bar-loader\",\n    \"shape-loader\",\n    \"text-loader\",\n    \"grid-loader\",\n    \"ai-loader\",\n  ],\n  loaders: [\n    \"dots-loader\",\n    \"ring-loader\",\n    \"bar-loader\",\n    \"shape-loader\",\n    \"text-loader\",\n    \"grid-loader\",\n  ],\n  loading: [\"spinner\", \"dots-loader\", \"ring-loader\", \"bar-loader\", \"skeleton\", \"text-loader\"],\n  spinner: [\"spinner\", \"ring-loader\"],\n  animation: [\"text-effect\", \"text-swap\", \"shader-transition\"],\n  animated: [\"text-effect\", \"morph-button\", \"effect-button\", \"number-flow\"],\n  \"text animation\": [\n    \"text-effect\",\n    \"text-swap\",\n    \"shimmer-text\",\n    \"scramble-text\",\n    \"typewriter-text\",\n  ],\n  typewriter: [\"typewriter-text\"],\n  shimmer: [\"shimmer-text\", \"skeleton\"],\n  counter: [\"number-flow\", \"drag-stepper\"],\n  price: [\"number-flow\", \"pricing\"],\n  carousel: [\n    \"carousel-3d\",\n    \"swipe-carousel\",\n    \"reviews-carousel\",\n    \"invite-carousel\",\n    \"time-stack\",\n  ],\n  slider: [\"slider\", \"exposure-slider\", \"slosh-slider\", \"scrubber\", \"range-dial\"],\n  slideshow: [\"carousel-3d\", \"swipe-carousel\", \"photo-stack\"],\n  marquee: [\"marquee\", \"logo-marquee\"],\n  ticker: [\"marquee\"],\n  cards: [\"card\", \"card-spread\", \"card-stack\", \"glow-card\", \"tilt-card\", \"expandable-cards\"],\n  hero: [\n    \"hero-grid\",\n    \"hero-product\",\n    \"hero-split-image\",\n    \"hero-perspective-grid\",\n    \"hero-spotlight\",\n    \"hero-minimal\",\n  ],\n  landing: [\"hero-grid\", \"features-bento\", \"cta-centered\", \"footer-newsletter\"],\n  cta: [\"cta-centered\", \"cta-split-image\", \"cta-banner\"],\n  \"call to action\": [\"cta-centered\", \"cta-split-image\", \"cta-banner\"],\n  features: [\"features-icon-grid\", \"features-bento\", \"features-alternating\"],\n  logos: [\"logo-cloud-simple\", \"logo-marquee\", \"logo-links-marquee\", \"logo-grid-tooltips\"],\n  testimonials: [\n    \"testimonial-rotator\",\n    \"testimonial-spotlight\",\n    \"testimonial-star-grid\",\n    \"reviews-carousel\",\n  ],\n  reviews: [\"reviews-carousel\", \"testimonial-star-grid\"],\n  faq: [\"faq-accordion\", \"faq-searchable\", \"faq-categorized\", \"faq-tabbed-grid\"],\n  footer: [\"footer-simple\", \"footer-newsletter\", \"footer-mega\", \"footer-minimal\"],\n  newsletter: [\"footer-newsletter\", \"footer-mega\"],\n  heatmap: [\"dither-heatmap\", \"contribution-graph\"],\n  donut: [\"dither-donut\"],\n  pie: [\"dither-donut\"],\n  gauge: [\"dither-gauge\", \"meter\"],\n  funnel: [\"dither-funnel\"],\n  uptime: [\"uptime-matrix\"],\n  \"status page\": [\"uptime-matrix\"],\n  otp: [\"otp-input\"],\n  \"one-time code\": [\"otp-input\"],\n  \"verification code\": [\"otp-input\"],\n  steps: [\"stepper\"],\n  \"context menu\": [\"context-menu\"],\n  \"right click\": [\"context-menu\"],\n  reorder: [\"reorder-list\", \"browser-tabs\"],\n  sortable: [\"reorder-list\"],\n  drag: [\"reorder-list\", \"goo-ball\", \"swipe-carousel\"],\n  dock: [\"magnify-dock\"],\n  toolbar: [\"canvas-toolbar\", \"magnify-dock\"],\n  confirm: [\"slide-to-confirm\", \"inline-confirm\", \"confirm-typed\"],\n  delete: [\"inline-confirm\", \"confirm-typed\"],\n  toggle: [\"switch\", \"liquid-toggle\"],\n  copy: [\"copy-button\"],\n  clipboard: [\"copy-button\"],\n  refresh: [\"pull-to-refresh\"],\n  music: [\"now-playing\"],\n  player: [\"now-playing\"],\n  orb: [\"gradient-orb\", \"orb-face\"],\n  transition: [\"shader-transition\", \"text-swap\"],\n  badge: [\"badge\", \"notification-badge\"],\n  avatar: [\"avatar\", \"avatar-group\", \"pixel-avatar\"],\n  tweet: [\"tweet-card\"],\n  dial: [\"dial\", \"range-dial\"],\n  knob: [\"dial\"],\n};\n\nexport interface PlanEntry {\n  entry: RegistryIndexEntry;\n  /** Why this was chosen, in words, so a wrong pick is arguable. */\n  because: string;\n}\n\nexport interface UiPlan {\n  /** The prompt, as given. */\n  prompt: string;\n  /** Whole sections, which bring their own components. */\n  blocks: PlanEntry[];\n  /** Individual components, none of which a chosen block already installs. */\n  components: PlanEntry[];\n  /** Everything to install, in one list. */\n  install: string[];\n  /** True when nothing matched, so callers can say so rather than emit nothing. */\n  empty: boolean;\n}\n\nfunction normalise(prompt: string): string {\n  return prompt.toLowerCase().replace(/[^a-z0-9\\s-]/g, \" \");\n}\n\nfunction words(prompt: string): string[] {\n  return normalise(prompt)\n    .split(/\\s+/)\n    .filter((word) => word.length > 2 && !STOPWORDS.has(word));\n}\n\ninterface SynonymMatch {\n  /** Item name to the phrase that selected it. */\n  hits: Map<string, string>;\n  /**\n   * Words the table has already spoken for.\n   *\n   * Excluded from generic term matching afterwards. The table exists to say\n   * that \"plan\" means pricing or billing; letting the generic matcher also\n   * score every item with \"plan\" in its name puts `ai-agent-plan` on a billing\n   * page and re-introduces exactly the ambiguity the table resolves.\n   */\n  consumed: Set<string>;\n}\n\nfunction synonymHits(prompt: string): SynonymMatch {\n  const text = normalise(prompt);\n  const hits = new Map<string, string>();\n  const consumed = new Set<string>();\n\n  for (const [phrase, names] of Object.entries(SYNONYMS)) {\n    // Word-boundary matched, so \"keyboard\" does not trigger \"key\".\n    const pattern = new RegExp(`(^|\\\\s)${phrase.replace(/\\s+/g, \"\\\\s+\")}(\\\\s|$)`);\n    if (!pattern.test(text)) continue;\n\n    for (const word of phrase.split(/\\s+/)) consumed.add(word);\n    for (const name of names) {\n      if (!hits.has(name)) hits.set(name, phrase);\n    }\n  }\n\n  return { hits, consumed };\n}\n\n/** Below this a match is coincidence rather than intent. */\nconst MINIMUM_SCORE = 20;\n\ninterface Scored {\n  entry: RegistryIndexEntry;\n  /** What the prompt actually matched. Decides whether it qualifies at all. */\n  score: number;\n  /** Score plus the block preference. Decides order only. */\n  rank: number;\n  because: string;\n}\n\nfunction scoreEntry(\n  entry: RegistryIndexEntry,\n  terms: string[],\n  synonyms: Map<string, string>,\n): Scored | undefined {\n  const name = entry.name.toLowerCase();\n  const title = entry.title.toLowerCase();\n  const description = entry.description.toLowerCase();\n\n  let score = 0;\n  const reasons: string[] = [];\n\n  const synonym = synonyms.get(entry.name);\n  if (synonym) {\n    score += 60;\n    reasons.push(`\"${synonym}\"`);\n  }\n\n  for (const term of terms) {\n    if (name === term) {\n      score += 50;\n      reasons.push(`named \"${term}\"`);\n    } else if (name.split(\"-\").includes(term)) {\n      score += 30;\n      reasons.push(`\"${term}\" in its name`);\n    } else if (title.includes(term)) {\n      score += 20;\n      reasons.push(`\"${term}\" in its title`);\n    } else if (entry.category === term) {\n      score += 12;\n      reasons.push(`the ${term} category`);\n    } else if (description.includes(term)) {\n      score += 8;\n      reasons.push(`\"${term}\" in its description`);\n    }\n  }\n\n  if (score === 0) return undefined;\n\n  // A block covers more of an intent than a component does, and installing one\n  // brings the components anyway — so where both match, the block is the better\n  // answer rather than merely an equal one.\n  //\n  // Kept out of `score` on purpose. Added there it would lift a block over the\n  // qualifying floor on a description-only brush, which is how `ai-dashboard`\n  // ended up recommended for an agent console because its prose contains the\n  // word \"run\". A preference should order real matches, not manufacture one.\n  const rank = score + (entry.type === \"registry:block\" ? 25 : 0);\n\n  return { entry, score, rank, because: [...new Set(reasons)].slice(0, 3).join(\", \") };\n}\n\nexport interface PlanOptions {\n  /** How many components to suggest beyond the blocks. */\n  maxComponents?: number;\n  /** How many blocks to suggest. */\n  maxBlocks?: number;\n}\n\nexport function planUi(\n  prompt: string,\n  index: RegistryIndex,\n  options: PlanOptions = {},\n): UiPlan {\n  const { maxBlocks = 3, maxComponents = 6 } = options;\n\n  const { hits: synonyms, consumed } = synonymHits(prompt);\n  const terms = words(prompt).filter((term) => !consumed.has(term));\n\n  const scored = index.items\n    .filter((entry) => entry.type === \"registry:ui\" || entry.type === \"registry:block\")\n    .map((entry) => scoreEntry(entry, terms, synonyms))\n    .filter((candidate): candidate is Scored => candidate !== undefined)\n    // A description-only brush (8) or a bare category hit (12) is not enough on\n    // its own. Suggesting six components because the prompt shares a common\n    // word with their prose makes the plan look like more work than it is, and\n    // buries the ones that actually matched.\n    .filter((candidate) => candidate.score >= MINIMUM_SCORE)\n    .sort((a, b) => b.rank - a.rank || a.entry.name.localeCompare(b.entry.name));\n\n  const blocks = scored\n    .filter((candidate) => candidate.entry.type === \"registry:block\")\n    .slice(0, maxBlocks);\n\n  // Anything a chosen block already installs is not a separate suggestion:\n  // listing Button beside a Dashboard that brings it is noise that makes the\n  // plan look longer than the work.\n  const covered = new Set(\n    blocks.flatMap((candidate) => [\n      candidate.entry.name,\n      ...candidate.entry.registryDependencies,\n    ]),\n  );\n\n  const components = scored\n    .filter(\n      (candidate) =>\n        candidate.entry.type === \"registry:ui\" && !covered.has(candidate.entry.name),\n    )\n    .slice(0, maxComponents);\n\n  const toEntry = (candidate: Scored): PlanEntry => ({\n    entry: candidate.entry,\n    because: candidate.because,\n  });\n\n  return {\n    prompt,\n    blocks: blocks.map(toEntry),\n    components: components.map(toEntry),\n    install: [...blocks, ...components].map((candidate) => candidate.entry.name),\n    empty: blocks.length === 0 && components.length === 0,\n  };\n}\n\n/** PascalCase export name for a registry name, e.g. \"ai-tool\" -> \"AiTool\". */\nfunction tag(name: string): string {\n  return name\n    .split(\"-\")\n    .map((part) => part.charAt(0).toUpperCase() + part.slice(1))\n    .join(\"\");\n}\n\n/** Blocks export a `…Block` component; components export their own name. */\nfunction componentName(entry: RegistryIndexEntry): string {\n  const base = tag(entry.name);\n  return entry.type === \"registry:block\" ? `${base}Block` : base;\n}\n\nexport interface RenderOptions {\n  /** Where components are imported from in the target project. */\n  importFrom?: string;\n  /**\n   * Where blocks are imported from.\n   *\n   * Separate because blocks are not exported from the component package at\n   * all — they are only ever installed as source — so deriving their path from\n   * a package specifier produces an import that does not exist. Derived from\n   * `importFrom` when it is a project alias, and otherwise the conventional\n   * install location.\n   */\n  blocksImportFrom?: string;\n  cliPackage?: string;\n  docsUrl?: string;\n}\n\n/**\n * Where an installed block lives.\n *\n * A project alias like `@/components/ui` has a sibling `@/components/blocks`. A\n * bare package specifier has no block path at all, so the conventional install\n * location is used instead of inventing one under the package.\n */\nexport function blocksPathFor(importFrom: string): string {\n  if (importFrom.endsWith(\"/ui\")) return `${importFrom.slice(0, -3)}/blocks`;\n  if (importFrom.startsWith(\"@/\") || importFrom.startsWith(\"~/\")) {\n    return `${importFrom}/blocks`;\n  }\n  return \"@/components/blocks\";\n}\n\n/**\n * The plan as a starting file.\n *\n * Imports and composition only. Every element carries the page its props are\n * documented on, because the registry does not publish prop shapes and a\n * plausible invented prop is worse than an obvious gap — one is a TODO, the\n * other is a bug wearing the costume of working code.\n */\nexport function renderPlan(plan: UiPlan, options: RenderOptions = {}): string {\n  const {\n    importFrom = \"@/components/ui\",\n    docsUrl = \"https://dowel-eight.vercel.app\",\n    blocksImportFrom = blocksPathFor(importFrom),\n  } = options;\n\n  if (plan.empty) {\n    return `// Nothing in the registry matched \"${plan.prompt}\".\\n`;\n  }\n\n  const chosen = [...plan.blocks, ...plan.components];\n\n  const imports = chosen\n    .map((item) => {\n      const from =\n        item.entry.type === \"registry:block\"\n          ? `${blocksImportFrom}/${item.entry.name}`\n          : `${importFrom}/${item.entry.name}`;\n      return `import { ${componentName(item.entry)} } from \"${from}\";`;\n    })\n    .sort();\n\n  const body = chosen\n    .map((item) => {\n      const name = componentName(item.entry);\n      return [\n        `      {/* ${item.entry.title} — props: ${docsUrl}/docs/${\n          item.entry.type === \"registry:block\" ? \"blocks\" : \"components\"\n        }/${item.entry.name} */}`,\n        `      <${name} />`,\n      ].join(\"\\n\");\n    })\n    .join(\"\\n\\n\");\n\n  return `${imports.join(\"\\n\")}\n\nexport default function Page() {\n  return (\n    <div className=\"flex flex-col gap-6\">\n${body}\n    </div>\n  );\n}\n`;\n}\n\n/**\n * The plan as a brief for a coding agent.\n *\n * The most useful thing this can produce. The agent has the project, the\n * editor and the ability to write the props; what it lacks is the knowledge\n * that these components exist and that it must not invent others. That is\n * exactly what a grounded plan supplies.\n */\nexport function renderBrief(plan: UiPlan, options: RenderOptions = {}): string {\n  const {\n    cliPackage = \"@dowel-ui/cli\",\n    docsUrl = \"https://dowel-eight.vercel.app\",\n    importFrom = \"@/components/ui\",\n  } = options;\n\n  if (plan.empty) {\n    return `Nothing in the registry matched \"${plan.prompt}\". Search the catalogue at ${docsUrl}/docs/components before building anything by hand.`;\n  }\n\n  const lines = [\n    `Build: ${plan.prompt}`,\n    \"\",\n    \"Use these, which are already in the registry. Do not write your own versions,\",\n    \"and do not use any component not listed here without checking the catalogue first.\",\n    \"\",\n  ];\n\n  if (plan.blocks.length > 0) {\n    lines.push(\"Blocks (whole sections — each installs its own components):\");\n    for (const item of plan.blocks) {\n      lines.push(`- ${item.entry.name} — ${item.entry.description}`);\n    }\n    lines.push(\"\");\n  }\n\n  if (plan.components.length > 0) {\n    lines.push(\"Components:\");\n    for (const item of plan.components) {\n      lines.push(`- ${item.entry.name} — ${item.entry.description}`);\n    }\n    lines.push(\"\");\n  }\n\n  lines.push(\n    \"Install first:\",\n    \"\",\n    `    npx ${cliPackage} add ${plan.install.join(\" \")}`,\n    \"\",\n    `Import from \\`${importFrom}\\`. Each component's props are on its page under`,\n    `${docsUrl}/docs/components — read the page rather than guessing a prop name.`,\n    \"\",\n    \"Style with semantic tokens only (bg-background, text-muted-foreground). Never raw\",\n    \"hex, never Tailwind's own palette — those do not follow the theme.\",\n  );\n\n  return lines.join(\"\\n\");\n}\n"],"mappings":"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"}

package/dist/index.d.ts

@@ -1,4 +1,186 @@
-import { a as RegistryIndexEntry, c as registryFileSchema, d as registryIndexSchema, f as registryItemSchema, i as RegistryIndex, l as registryFileTypeSchema, n as RegistryFile, o as RegistryItem, p as registryItemTypeSchema, r as RegistryFileType, s as RegistryItemType, t as REGISTRY_VERSION, u as registryIndexEntrySchema } from "./schema-Cc32v3R-.js";
+import { a as RegistryIndex, c as RegistryItemType, d as registryFileTypeSchema, f as registryIndexEntrySchema, h as registryItemTypeSchema, i as RegistryFileType, l as registryAccessSchema, m as registryItemSchema, n as RegistryAccess, o as RegistryIndexEntry, p as registryIndexSchema, r as RegistryFile, s as RegistryItem, t as REGISTRY_VERSION, u as registryFileSchema } from "./schema-BmYeKe9e.js";
+import { PlanEntry, PlanOptions, RenderOptions, UiPlan, blocksPathFor, planUi, renderBrief, renderPlan } from "./generate.js";
+import { z } from "zod";
+//#region src/custom.d.ts
+/**
+ * Building a registry of your own components.
+ *
+ * The CLI has always been able to install from any registry — `--registry`
+ * takes a URL or a directory — but producing one meant reimplementing this
+ * package. So an organisation that wanted its own components installed the same
+ * way had the consumer half and none of the producer half.
+ *
+ * The authoring shape is declared here rather than imported from the component
+ * package, because the registry *is* the contract. A team publishing their own
+ * components should not have to depend on somebody else's component library to
+ * describe their own.
+ */
+/** Where an item's files are written in the consuming project. */
+declare const itemGroupSchema: z.ZodEnum<{
+  ui: "ui";
+  blocks: "blocks";
+  lib: "lib";
+  hooks: "hooks";
+}>;
+type ItemGroup = z.infer<typeof itemGroupSchema>;
+declare const itemSourceSchema: z.ZodObject<{
+  name: z.ZodString;
+  title: z.ZodString;
+  description: z.ZodString;
+  category: z.ZodString;
+  status: z.ZodDefault<z.ZodEnum<{
+    stable: "stable";
+    beta: "beta";
+    experimental: "experimental";
+  }>>;
+  group: z.ZodDefault<z.ZodEnum<{
+    ui: "ui";
+    blocks: "blocks";
+    lib: "lib";
+    hooks: "hooks";
+  }>>;
+  dependencies: z.ZodDefault<z.ZodArray<z.ZodString>>;
+  registryDependencies: z.ZodDefault<z.ZodArray<z.ZodString>>;
+  files: z.ZodArray<z.ZodString>;
+  a11y: z.ZodOptional<z.ZodString>;
+  access: z.ZodDefault<z.ZodEnum<{
+    free: "free";
+    pro: "pro";
+  }>>;
+  directory: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+type ItemSource = z.input<typeof itemSourceSchema>;
+declare const registryConfigSchema: z.ZodObject<{
+  root: z.ZodString;
+  items: z.ZodArray<z.ZodObject<{
+    name: z.ZodString;
+    title: z.ZodString;
+    description: z.ZodString;
+    category: z.ZodString;
+    status: z.ZodDefault<z.ZodEnum<{
+      stable: "stable";
+      beta: "beta";
+      experimental: "experimental";
+    }>>;
+    group: z.ZodDefault<z.ZodEnum<{
+      ui: "ui";
+      blocks: "blocks";
+      lib: "lib";
+      hooks: "hooks";
+    }>>;
+    dependencies: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    registryDependencies: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    files: z.ZodArray<z.ZodString>;
+    a11y: z.ZodOptional<z.ZodString>;
+    access: z.ZodDefault<z.ZodEnum<{
+      free: "free";
+      pro: "pro";
+    }>>;
+    directory: z.ZodOptional<z.ZodString>;
+  }, z.core.$strip>>;
+  extends: z.ZodOptional<z.ZodString>;
+  generatedFrom: z.ZodDefault<z.ZodString>;
+}, z.core.$strip>;
+type RegistryConfig = z.input<typeof registryConfigSchema>;
+/** Identity helper, for editor autocomplete inside a config file. */
+declare function defineRegistryConfig(config: RegistryConfig): RegistryConfig;
+interface BuildResult {
+  items: RegistryItem[];
+  /**
+   * Names that exist upstream and were replaced by a local item.
+   *
+   * Reported rather than applied silently. Overriding upstream's Button is a
+   * legitimate thing to want and a catastrophic thing to do by accident, and
+   * the difference is entirely whether anyone was told.
+   */
+  overridden: string[];
+  /** How many items came from upstream unchanged. */
+  inherited: number;
+}
+/**
+ * Every `registryDependencies` name must exist in the finished registry.
+ *
+ * Checked here, once, rather than discovered by a consumer whose `add` walks
+ * into a name nothing serves. This is the single most common way a
+ * hand-assembled registry is broken, and it is invisible until someone installs.
+ */
+declare function assertResolvable(items: RegistryItem[]): void;
+declare function buildCustomRegistry(config: RegistryConfig): Promise<BuildResult>;
+//#endregion
+//#region src/agent-docs.d.ts
+/**
+ * Documentation written for coding agents rather than for people.
+ *
+ * This lives beside the registry rather than in the CLI or the docs site
+ * because all three need to emit the same text: the CLI writes it into a
+ * consumer's repository, the site serves it at /llms.txt, and the MCP server
+ * answers with it. Three hand-maintained copies would disagree within a
+ * release, and an agent acting on a stale catalogue writes code that does not
+ * compile.
+ *
+ * Everything here is derived from the registry index. Nothing is a hardcoded
+ * list of component names — that is the failure mode this replaces.
+ */
+interface AgentDocsContext {
+  index: RegistryIndex;
+  /**
+   * Full registry items, when the caller has them.
+   *
+   * The index carries no accessibility notes, so callers that can afford to
+   * fetch every item (the docs build, the MCP server) get richer output than
+   * ones that cannot (the CLI, which would otherwise make 81 requests).
+   */
+  items?: RegistryItem[];
+  /** Base URL the CLI installs from. */
+  registryUrl: string;
+  /** Base URL of the documentation site, no trailing slash. */
+  docsUrl: string;
+  /** npm package name of the CLI, e.g. `@dowel-ui/cli`. */
+  cliPackage: string;
+  libraryName: string;
+  /** Registry names already present in the project, if known. */
+  installed?: string[];
+  /**
+   * What components are imported from in this project.
+   *
+   * Source-first installs resolve to the project's own alias; the published
+   * package is a separate, supported way to consume the same components. An
+   * agent told the wrong one writes imports that do not resolve.
+   */
+  importFrom: string;
+}
+declare function conventionsDoc(context: AgentDocsContext): string;
+declare function componentsDoc(context: AgentDocsContext): string;
+declare function aiDoc(context: AgentDocsContext): string;
+declare function themesDoc(context: AgentDocsContext): string;
+/** Frontmatter-carrying skill file for Claude Code. */
+declare function skillDoc(context: AgentDocsContext): string;
+/** Cursor project rule (`.cursor/rules/*.mdc`). */
+declare function cursorRule(context: AgentDocsContext): string;
+declare const AGENTS_MARKER_START = "<!-- dowel:start -->";
+declare const AGENTS_MARKER_END = "<!-- dowel:end -->";
+/**
+ * The block written into a project's AGENTS.md.
+ *
+ * Marker-wrapped rather than written as a whole file: AGENTS.md belongs to the
+ * project and usually already says things about the project. Replacing it would
+ * destroy that; appending without markers would duplicate the section on every
+ * regeneration.
+ */
+declare function agentsSection(context: AgentDocsContext): string;
+/** Replaces the marked block, or appends it if there is none. */
+declare function upsertAgentsSection(existing: string, section: string): string;
+/**
+ * The llms.txt index.
+ *
+ * Deliberately a map rather than a dump: it names every component and points at
+ * the one URL that carries everything, so a model with a small budget can find
+ * the right page and one with a large budget can take the lot.
+ */
+declare function llmsTxt(context: AgentDocsContext): string;
+/** Everything an agent needs, in one request. */
+declare function llmsFullTxt(context: AgentDocsContext): string;
+//#endregion
 //#region src/hash.d.ts
 /**
  * Content hash used to detect local edits to an installed file.
@@ -8,5 +190,5 @@ import { a as RegistryIndexEntry, c as registryFileSchema, d as registryIndexSch
  */
 declare function hashContent(content: string): string;
 //#endregion
-export { REGISTRY_VERSION, type RegistryFile, type RegistryFileType, type RegistryIndex, type RegistryIndexEntry, type RegistryItem, type RegistryItemType, hashContent, registryFileSchema, registryFileTypeSchema, registryIndexEntrySchema, registryIndexSchema, registryItemSchema, registryItemTypeSchema };
+export { AGENTS_MARKER_END, AGENTS_MARKER_START, type AgentDocsContext, type BuildResult, type ItemGroup, type ItemSource, type PlanEntry, type PlanOptions, REGISTRY_VERSION, type RegistryAccess, type RegistryConfig, type RegistryFile, type RegistryFileType, type RegistryIndex, type RegistryIndexEntry, type RegistryItem, type RegistryItemType, type RenderOptions, type UiPlan, agentsSection, aiDoc, assertResolvable, blocksPathFor, buildCustomRegistry, componentsDoc, conventionsDoc, cursorRule, defineRegistryConfig, hashContent, itemGroupSchema, itemSourceSchema, llmsFullTxt, llmsTxt, planUi, registryAccessSchema, registryConfigSchema, registryFileSchema, registryFileTypeSchema, registryIndexEntrySchema, registryIndexSchema, registryItemSchema, registryItemTypeSchema, renderBrief, renderPlan, skillDoc, themesDoc, upsertAgentsSection };
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","names":[],"sources":["../src/hash.ts"],"mappings":";;;;;;;;iBAQgB,YAAY"}
+{"version":3,"file":"index.d.ts","names":[],"sources":["../src/custom.ts","../src/agent-docs.ts","../src/hash.ts"],"mappings":";;;;;;;;;;;;;;;;;;cAgCa,iBAAe,EAAA;;;;;;KAEhB,YAAY,EAAE,aAAa;cAS1B,kBAAgB,EAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAqB3B,EAAA,KAAA;KAEU,aAAa,EAAE,aAAa;cAE3B,sBAAoB,EAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAc/B,EAAA,KAAA;KAEU,iBAAiB,EAAE,aAAa;;iBAG5B,qBAAqB,QAAQ,iBAAiB;UAI7C;EACf,OAAO;;;;;;;;EAQP;;EAEA;;;;;;;;;iBAgKc,iBAAiB,OAAO;iBAkBlB,oBAAoB,QAAQ,iBAAiB,QAAQ;;;;;;;;;;;;;;;;UCxQ1D;EACf,OAAO;;;;;;;;EAQP,QAAQ;;EAER;;EAEA;;EAEA;EACA;;EAEA;;;;;;;;EAQA;;iBA8Ec,eAAe,SAAS;iBA6DxB,cAAc,SAAS;iBAmDvB,MAAM,SAAS;iBAqCf,UAAU,SAAS;;iBA2CnB,SAAS,SAAS;;iBAgElB,WAAW,SAAS;cAyBvB;cACA;;;;;;;;;iBAUG,cAAc,SAAS;;iBAuBvB,oBAAoB,kBAAkB;;;;;;;;iBAmBtC,QAAQ,SAAS;;iBA+CjB,YAAY,SAAS;;;;;;;;;iBC7erB,YAAY"}