@voxel51/voodo 2.0.0 → 2.2.0

package/bin/voodo.mjs

@@ -0,0 +1,127 @@
+#!/usr/bin/env node
+// @ts-check
+/**
+ * `voodo`: agent-friendly docs for @voxel51/voodo, read from the installed
+ * package's own type declarations, so the output always matches the version
+ * that is installed.
+ *
+ *   npx @voxel51/voodo list
+ *   npx @voxel51/voodo docs Button
+ */
+import { existsSync, readdirSync, readFileSync } from "node:fs";
+import { dirname, join, sep } from "node:path";
+import { fileURLToPath } from "node:url";
+
+import {
+  findComponents,
+  findTokenGroups,
+  lookup,
+  renderDocs,
+  renderList,
+  renderTokens,
+  resolveExports,
+} from "../dist/cli.js";
+
+const root = join(dirname(fileURLToPath(import.meta.url)), "..");
+const { version } = JSON.parse(
+  readFileSync(join(root, "package.json"), "utf8")
+);
+
+const USAGE = `voodo: docs for @voxel51/voodo ${version}
+
+  voodo list             every component, one line each
+  voodo docs <Name>      one component's props, docs and token values
+  voodo tokens [Group]   token values, e.g. \`voodo tokens TextColor\`
+  voodo icons            every per-icon component name`;
+
+/** @param {string} dir Relative to the package root, `/`-separated. */
+const readDeclarations = (dir) => {
+  const absolute = join(root, ...dir.split("/"));
+
+  if (!existsSync(absolute)) {
+    console.error(
+      `voodo: ${dir} not found. In the design-system repo, run \`npm run build\` first.`
+    );
+    process.exit(1);
+  }
+
+  return readdirSync(absolute, { recursive: true })
+    .map(String)
+    .filter((file) => file.endsWith(".d.ts"))
+    .sort()
+    .map((file) => ({
+      path: `${dir}/${file.split(sep).join("/")}`,
+      text: readFileSync(join(absolute, file), "utf8"),
+    }));
+};
+
+const ICONS_FILE = "dist/components/Icons/icons.d.ts";
+
+const [command, argument] = process.argv.slice(2);
+const componentFiles = readDeclarations("dist/components");
+const exported = resolveExports(
+  new Map(componentFiles.map((file) => [file.path, file.text])),
+  "dist/components/index.d.ts"
+);
+// Only what the package exports: the dist also holds internal modules.
+const published = findComponents(componentFiles).filter(
+  (entry) => exported.get(entry.name) === entry.file
+);
+const components = published.filter((entry) => entry.file !== ICONS_FILE);
+const iconNames = published
+  .filter((entry) => entry.file === ICONS_FILE)
+  .map((entry) => entry.name);
+const tokens = findTokenGroups([
+  ...readDeclarations("dist/types"),
+  ...componentFiles,
+]);
+
+switch (command) {
+  case "list":
+    console.log(renderList(components, iconNames, version));
+    break;
+
+  case "docs": {
+    if (!argument) {
+      console.error("Usage: voodo docs <Name>. Run `voodo list` for names.");
+      process.exit(1);
+    }
+
+    const { match, suggestions } = lookup(components, argument);
+
+    if (!match) {
+      console.error(
+        suggestions.length
+          ? `No component named ${argument}. Did you mean: ${suggestions.join(", ")}?`
+          : `No component named ${argument}. Run \`voodo list\` for names.`
+      );
+      process.exit(1);
+    }
+
+    const file = componentFiles.find((entry) => entry.path === match.file);
+    console.log(renderDocs(match, file?.text ?? "", tokens));
+    break;
+  }
+
+  case "tokens": {
+    const output = renderTokens(tokens, argument);
+
+    if (!output) {
+      console.error(
+        `No token group named ${argument}. Run \`voodo tokens\` for all.`
+      );
+      process.exit(1);
+    }
+
+    console.log(output);
+    break;
+  }
+
+  case "icons":
+    console.log(iconNames.join("\n"));
+    break;
+
+  default:
+    console.log(USAGE);
+    if (command && command !== "help" && command !== "--help") process.exit(1);
+}

package/dist/cli/reference.d.ts

@@ -0,0 +1,79 @@
+/**
+ * Pure helpers for the `voodo` command (`bin/voodo.mjs`). They read the
+ * package's shipped `.d.ts` files as plain text and turn them into short,
+ * agent-friendly output.
+ *
+ * Built as its own entry (`dist/cli.js`) so the command can run from an
+ * installed package without React. No dependencies and no TypeScript
+ * compiler: the emitted declarations are regular enough to read with a few
+ * regular expressions, and the spec pins down every shape this relies on.
+ */
+export interface ComponentEntry {
+    name: string;
+    /** Path of the declaring `.d.ts`, relative to the package root. */
+    file: string;
+    /** First sentence of the component's JSDoc. */
+    summary: string;
+    /** Whether its JSDoc carries at least one `@example`. */
+    hasExample: boolean;
+    deprecated: boolean;
+    internal: boolean;
+}
+export interface DeclarationFile {
+    /** `/`-separated, relative to the package root. */
+    path: string;
+    text: string;
+}
+/** Token string values, current ones apart from deprecated ones. */
+export interface TokenValues {
+    values: string[];
+    deprecated: string[];
+}
+/** One token group's values, plus each member's value by member name. */
+export interface TokenGroup extends TokenValues {
+    members: Record<string, string>;
+}
+/** Token group name → its values. */
+export type TokenGroups = Record<string, TokenGroup>;
+/**
+ * The first sentence of a JSDoc description: the text before the first blank
+ * line or tag, with links reduced to their names.
+ *
+ * @param doc Raw JSDoc body, without the delimiters.
+ */
+export declare const summarize: (doc: string) => string;
+/** Every component declared in the given files, sorted by name. */
+export declare const findComponents: (files: DeclarationFile[]) => ComponentEntry[];
+/**
+ * Every value a barrel exports, mapped to the file that declares it. Follows
+ * `export * from` and `export { a, b as c } from` through other declaration
+ * files; `export type` re-exports carry no values and are skipped.
+ *
+ * @param files Path → text, `/`-separated.
+ * @param entry The barrel to start from.
+ */
+export declare const resolveExports: (files: ReadonlyMap<string, string>, entry: string) => Map<string, string>;
+/**
+ * String-valued token consts (`export declare const Size: { readonly Sm: "sm" … }`)
+ * and string enums (`export declare enum X { A = "a" … }`), by name.
+ */
+export declare const findTokenGroups: (files: DeclarationFile[]) => TokenGroups;
+export declare const renderList: (components: readonly ComponentEntry[], iconNames: readonly string[], version: string) => string;
+/**
+ * The declaration file for one component, trimmed for reading, with the value
+ * of every token type it mentions written out below it. A narrowed alias
+ * (`type ButtonSize = Exclude<Size, …>`) is written out as the values it
+ * allows, and the group it narrows only when the file uses that group
+ * elsewhere.
+ *
+ * @param text The declaring file's contents.
+ */
+export declare const renderDocs: (entry: ComponentEntry, text: string, tokens: TokenGroups) => string;
+/** Every token group, or only the one named `only` (case-insensitive). */
+export declare const renderTokens: (tokens: TokenGroups, only?: string) => string;
+/** Case-insensitive lookup, with near matches when there is no exact one. */
+export declare const lookup: (components: readonly ComponentEntry[], query: string) => {
+    match?: ComponentEntry;
+    suggestions: string[];
+};
+//# sourceMappingURL=reference.d.ts.map

package/dist/cli/reference.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reference.d.ts","sourceRoot":"","sources":["../../src/cli/reference.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,mEAAmE;IACnE,IAAI,EAAE,MAAM,CAAC;IACb,+CAA+C;IAC/C,OAAO,EAAE,MAAM,CAAC;IAChB,yDAAyD;IACzD,UAAU,EAAE,OAAO,CAAC;IACpB,UAAU,EAAE,OAAO,CAAC;IACpB,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,eAAe;IAC9B,mDAAmD;IACnD,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAED,oEAAoE;AACpE,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB;AAED,yEAAyE;AACzE,MAAM,WAAW,UAAW,SAAQ,WAAW;IAC7C,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACjC;AAED,qCAAqC;AACrC,MAAM,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;AAqCrD;;;;;GAKG;AACH,eAAO,MAAM,SAAS,GAAI,KAAK,MAAM,KAAG,MAcvC,CAAC;AAEF,mEAAmE;AACnE,eAAO,MAAM,cAAc,GAAI,OAAO,eAAe,EAAE,KAAG,cAAc,EAwBvB,CAAC;AA0BlD;;;;;;;GAOG;AACH,eAAO,MAAM,cAAc,GACzB,OAAO,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,EAClC,OAAO,MAAM,KACZ,GAAG,CAAC,MAAM,EAAE,MAAM,CA2CpB,CAAC;AA4CF;;;GAGG;AACH,eAAO,MAAM,eAAe,GAAI,OAAO,eAAe,EAAE,KAAG,WA0B1D,CAAC;AA4EF,eAAO,MAAM,UAAU,GACrB,YAAY,SAAS,cAAc,EAAE,EACrC,WAAW,SAAS,MAAM,EAAE,EAC5B,SAAS,MAAM,KACd,MAiBF,CAAC;AAEF;;;;;;;;GAQG;AACH,eAAO,MAAM,UAAU,GACrB,OAAO,cAAc,EACrB,MAAM,MAAM,EACZ,QAAQ,WAAW,KAClB,MA6CF,CAAC;AAEF,0EAA0E;AAC1E,eAAO,MAAM,YAAY,GAAI,QAAQ,WAAW,EAAE,OAAO,MAAM,KAAG,MAInD,CAAC;AAEhB,6EAA6E;AAC7E,eAAO,MAAM,MAAM,GACjB,YAAY,SAAS,cAAc,EAAE,EACrC,OAAO,MAAM,KACZ;IAAE,KAAK,CAAC,EAAE,cAAc,CAAC;IAAC,WAAW,EAAE,MAAM,EAAE,CAAA;CAUjD,CAAC"}

package/dist/cli.cjs

@@ -0,0 +1,11 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const E=/(?:\/\*\*((?:(?!\*\/)[\s\S])*)\*\/\s*)?^(?:export )?declare (const|function) ([A-Z][A-Za-z0-9]*)([^\n]*)/gm,C=/^(?:<[^>]*>)?\(|^: (?:React\.)?FC<|^: import\(['"]react['"]\)\.(?:ForwardRef|Memo|Named)ExoticComponent</,Z=(o,n,e)=>o==="function"||C.test(n)?!0:n===": {"&&/^\s*\(/.test(e),O=o=>o.split(`
+`).map(n=>n.replace(/^\s*\* ?/,"").trimEnd()),$=/\{@link\s+([^}\s]+)\s*\}/g,L=o=>o.replace($,"$1"),x=o=>{const n=[];for(const s of O(o))if(!(!s.trim()&&!n.length)){if(!s.trim()||s.trimStart().startsWith("@"))break;n.push(s.trim())}const e=L(n.join(" ")).replace(/\s+/g," ").trim(),t=e.match(/^.*?[.!?](?=\s|$)/);return t?t[0]:e},M=o=>o.flatMap(({path:n,text:e})=>[...e.matchAll(E)].filter(t=>Z(t[2]??"",t[4]??"",e.slice((t.index??0)+t[0].length))).map(t=>{const s=t[1]??"";return{name:t[3]??"",file:n,summary:x(s),hasExample:/@example\b/.test(s),deprecated:/@deprecated\b/.test(s),internal:/@internal\b/.test(s)}})).sort((n,e)=>n.name.localeCompare(e.name)),N=o=>o.slice(0,o.lastIndexOf("/")),g=(o,n,e)=>{const t=[];for(const r of`${N(n)}/${e}`.split("/"))r===".."?t.pop():r!=="."&&t.push(r);const s=t.join("/");return[`${s}.d.ts`,`${s}/index.d.ts`].find(r=>o.has(r))},m=(o,n)=>{const e=new Map,t=o.get(n)??"";for(const[,s]of t.matchAll(/^export declare (?:const|function|enum) ([A-Za-z0-9_$]+)/gm))s&&e.set(s,n);for(const[,s]of t.matchAll(/^export \* from ['"]([^'"]+)['"];/gm)){const r=s&&g(o,n,s);if(r)for(const[c,i]of m(o,r))e.set(c,i)}for(const[,s,r]of t.matchAll(/^export \{([^}]*)\} from ['"]([^'"]+)['"];/gm)){const c=r&&g(o,n,r);if(!c||!s)continue;const i=m(o,c);for(const d of s.split(",").map(a=>a.trim())){if(!d)continue;const[a=d,l=a]=d.split(/\s+as\s+/),p=a==="default"?c:i.get(a);p&&e.set(l,p)}}return e},w=/^export declare const ([A-Z][A-Za-z0-9]*): \{\n([\s\S]*?)\n\};/gm,z=/^export declare enum ([A-Z][A-Za-z0-9]*) \{\n([\s\S]*?)\n\}/gm,b=o=>o.startsWith("/")||o.startsWith("*"),v=(o,n)=>{const e={values:[],deprecated:[],members:{}};let t=!1;for(const s of o.split(`
+`).map(r=>r.trim())){if(!s)continue;if(b(s)){t||=s.includes("@deprecated");continue}const[,r,c]=s.match(n)??[];if(r===void 0||c===void 0)return;e.members[r]=c;const i=t?e.deprecated:e.values;i.includes(c)||i.push(c),t=!1}return e.values.length||e.deprecated.length?e:void 0},j=o=>{const n={};for(const{text:e}of o){for(const[,t,s]of e.matchAll(w)){const r=s===void 0?void 0:v(s,/^readonly ([A-Za-z0-9]+): "([^"]*)";$/);t&&r&&(n[t]=r)}for(const[,t,s]of e.matchAll(z)){const r=s===void 0?void 0:v(s,/^([A-Za-z0-9]+) = "([^"]*)",?$/);t&&r&&(n[t]=r)}}return Object.fromEntries(Object.entries(n).sort(([e],[t])=>e.localeCompare(t)))},R=/^(?:export )?type ([A-Z][A-Za-z0-9]*) = ([^\n]+);$/gm,k=/^(Exclude|Extract)<([A-Z][A-Za-z0-9]*), (.+)>$/,T=/^([A-Z][A-Za-z0-9]*)\.([A-Za-z0-9]+)$/,h=(o,n)=>{const e={values:[],deprecated:[]};for(const t of o.split("|").map(s=>s.trim())){const[,s="",r=""]=t.match(T)??[],c=n[s],i=c?.members[r];if(!c||i===void 0)return;(c.deprecated.includes(i)?e.deprecated:e.values).push(i)}return e},S=(o,n)=>{const e=o.match(/^`\$\{(.*)\}`$/)?.[1]??o,[,t,s="",r=""]=e.match(k)??[];if(!t)return h(e,n);const c=n[s],i=h(r,n);if(!c||!i)return;const d=[...i.values,...i.deprecated],a=l=>d.includes(l)===(t==="Extract");return{values:c.values.filter(a),deprecated:c.deprecated.filter(a)}},A=o=>o.map(n=>JSON.stringify(n)),u=(o,{values:n,deprecated:e})=>`type ${o} = ${A(n).join(" | ")||"never"};`+(e.length?` // deprecated: ${A(e).join(", ")}`:""),I=(o,n,e)=>{const t=o.filter(c=>!c.internal),s=Math.max(0,...t.map(c=>c.name.length)),r=t.map(c=>{const i=c.deprecated?" (deprecated)":"";return`${c.name.padEnd(s)}  ${c.summary}${i}`});return[`@voxel51/voodo ${e}: ${t.length} components, plus ${n.length} icons.`,"Run `voodo docs <Name>` for a component's props, docs and token values.","",...r,"",`Icons are per-icon components such as ${n.slice(0,3).join(", ")}. Run \`voodo icons\` for every name.`].join(`
+`)},W=(o,n,e)=>{const t=n.split(`
+`).filter(a=>!a.startsWith("import ")&&!a.startsWith("//# sourceMappingURL")&&a!=="export {};").join(`
+`).trim(),s=[...t.matchAll(R)].flatMap(([a,l,p])=>{const f=l&&p?S(p,e):void 0;return f?[{line:a,name:l,values:f}]:[]}),r=s.reduce((a,{line:l})=>a.replace(l,""),t).split(`
+`).map(a=>b(a.trim())?[...a.matchAll($)].map(([,l])=>l).join(" "):a).join(`
+`),c=Object.keys(j([{path:o.file,text:n}])),i=Object.entries(e).filter(([a])=>!c.includes(a)&&new RegExp(`\\b${a}\\b`).test(r)),d=[...s.map(({name:a,values:l})=>u(a,l)),...i.map(([a,l])=>u(a,l))];return[`import { ${o.name} } from "@voxel51/voodo";`,`// ${o.file}`,"",t,...d.length?["","// Token values used above",...d]:[]].join(`
+`)},G=(o,n)=>Object.entries(o).filter(([e])=>!n||e.toLowerCase()===n.toLowerCase()).map(([e,t])=>u(e,t)).join(`
+`),P=(o,n)=>{const e=n.toLowerCase(),t=o.find(r=>r.name.toLowerCase()===e),s=t?[]:o.filter(r=>r.name.toLowerCase().includes(e)).map(r=>r.name);return{match:t,suggestions:s}};exports.findComponents=M;exports.findTokenGroups=j;exports.lookup=P;exports.renderDocs=W;exports.renderList=I;exports.renderTokens=G;exports.resolveExports=m;exports.summarize=x;
+//# sourceMappingURL=cli.cjs.map

package/dist/cli.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.cjs","sources":["../src/cli/reference.ts"],"sourcesContent":["/**\n * Pure helpers for the `voodo` command (`bin/voodo.mjs`). They read the\n * package's shipped `.d.ts` files as plain text and turn them into short,\n * agent-friendly output.\n *\n * Built as its own entry (`dist/cli.js`) so the command can run from an\n * installed package without React. No dependencies and no TypeScript\n * compiler: the emitted declarations are regular enough to read with a few\n * regular expressions, and the spec pins down every shape this relies on.\n */\n\nexport interface ComponentEntry {\n  name: string;\n  /** Path of the declaring `.d.ts`, relative to the package root. */\n  file: string;\n  /** First sentence of the component's JSDoc. */\n  summary: string;\n  /** Whether its JSDoc carries at least one `@example`. */\n  hasExample: boolean;\n  deprecated: boolean;\n  internal: boolean;\n}\n\nexport interface DeclarationFile {\n  /** `/`-separated, relative to the package root. */\n  path: string;\n  text: string;\n}\n\n/** Token string values, current ones apart from deprecated ones. */\nexport interface TokenValues {\n  values: string[];\n  deprecated: string[];\n}\n\n/** One token group's values, plus each member's value by member name. */\nexport interface TokenGroup extends TokenValues {\n  members: Record<string, string>;\n}\n\n/** Token group name → its values. */\nexport type TokenGroups = Record<string, TokenGroup>;\n\n/**\n * An optional JSDoc block followed by a top-level `declare const` or\n * `declare function` whose name starts upper-case. The JSDoc body may not\n * contain `*\\/`, so a match never glues two comment blocks together.\n */\nconst DECLARATION =\n  /(?:\\/\\*\\*((?:(?!\\*\\/)[\\s\\S])*)\\*\\/\\s*)?^(?:export )?declare (const|function) ([A-Z][A-Za-z0-9]*)([^\\n]*)/gm;\n\nconst COMPONENT_TYPE =\n  /^(?:<[^>]*>)?\\(|^: (?:React\\.)?FC<|^: import\\(['\"]react['\"]\\)\\.(?:ForwardRef|Memo|Named)ExoticComponent</;\n\n/**\n * Whether a declaration's type describes a component. Object types count when\n * their first member is a call signature (`{ (props): JSX.Element; … }`, the\n * shape `displayName` assignments produce); token consts are object types too,\n * but their members are `readonly` string literals.\n */\nconst isComponent = (\n  kind: string,\n  rest: string,\n  following: string\n): boolean => {\n  if (kind === \"function\") return true;\n  if (COMPONENT_TYPE.test(rest)) return true;\n\n  return rest === \": {\" && /^\\s*\\(/.test(following);\n};\n\nconst docLines = (doc: string): string[] =>\n  doc.split(\"\\n\").map((line) => line.replace(/^\\s*\\* ?/, \"\").trimEnd());\n\nconst LINK = /\\{@link\\s+([^}\\s]+)\\s*\\}/g;\n\nconst stripLinks = (text: string): string => text.replace(LINK, \"$1\");\n\n/**\n * The first sentence of a JSDoc description: the text before the first blank\n * line or tag, with links reduced to their names.\n *\n * @param doc Raw JSDoc body, without the delimiters.\n */\nexport const summarize = (doc: string): string => {\n  const paragraph: string[] = [];\n\n  for (const line of docLines(doc)) {\n    // The body starts with the rest of the `/**` line, usually empty.\n    if (!line.trim() && !paragraph.length) continue;\n    if (!line.trim() || line.trimStart().startsWith(\"@\")) break;\n    paragraph.push(line.trim());\n  }\n\n  const text = stripLinks(paragraph.join(\" \")).replace(/\\s+/g, \" \").trim();\n  const sentence = text.match(/^.*?[.!?](?=\\s|$)/);\n\n  return sentence ? sentence[0] : text;\n};\n\n/** Every component declared in the given files, sorted by name. */\nexport const findComponents = (files: DeclarationFile[]): ComponentEntry[] =>\n  files\n    .flatMap(({ path, text }) =>\n      [...text.matchAll(DECLARATION)]\n        .filter((match) =>\n          isComponent(\n            match[2] ?? \"\",\n            match[4] ?? \"\",\n            text.slice((match.index ?? 0) + match[0].length)\n          )\n        )\n        .map((match) => {\n          const doc = match[1] ?? \"\";\n\n          return {\n            name: match[3] ?? \"\",\n            file: path,\n            summary: summarize(doc),\n            hasExample: /@example\\b/.test(doc),\n            deprecated: /@deprecated\\b/.test(doc),\n            internal: /@internal\\b/.test(doc),\n          };\n        })\n    )\n    .sort((a, b) => a.name.localeCompare(b.name));\n\nconst directory = (path: string): string =>\n  path.slice(0, path.lastIndexOf(\"/\"));\n\n/**\n * The declaration file a relative specifier points at: `./Button` is either\n * `Button.d.ts` or `Button/index.d.ts`.\n */\nconst resolveModule = (\n  files: ReadonlyMap<string, string>,\n  from: string,\n  specifier: string\n): string | undefined => {\n  const parts: string[] = [];\n\n  for (const segment of `${directory(from)}/${specifier}`.split(\"/\")) {\n    if (segment === \"..\") parts.pop();\n    else if (segment !== \".\") parts.push(segment);\n  }\n\n  const base = parts.join(\"/\");\n\n  return [`${base}.d.ts`, `${base}/index.d.ts`].find((path) => files.has(path));\n};\n\n/**\n * Every value a barrel exports, mapped to the file that declares it. Follows\n * `export * from` and `export { a, b as c } from` through other declaration\n * files; `export type` re-exports carry no values and are skipped.\n *\n * @param files Path → text, `/`-separated.\n * @param entry The barrel to start from.\n */\nexport const resolveExports = (\n  files: ReadonlyMap<string, string>,\n  entry: string\n): Map<string, string> => {\n  const exported = new Map<string, string>();\n  const text = files.get(entry) ?? \"\";\n\n  for (const [, name] of text.matchAll(\n    /^export declare (?:const|function|enum) ([A-Za-z0-9_$]+)/gm\n  )) {\n    if (name) exported.set(name, entry);\n  }\n\n  for (const [, specifier] of text.matchAll(\n    /^export \\* from ['\"]([^'\"]+)['\"];/gm\n  )) {\n    const target = specifier && resolveModule(files, entry, specifier);\n\n    if (target) {\n      for (const [name, file] of resolveExports(files, target)) {\n        exported.set(name, file);\n      }\n    }\n  }\n\n  for (const [, list, specifier] of text.matchAll(\n    /^export \\{([^}]*)\\} from ['\"]([^'\"]+)['\"];/gm\n  )) {\n    const target = specifier && resolveModule(files, entry, specifier);\n\n    if (!target || !list) continue;\n\n    const inner = resolveExports(files, target);\n\n    for (const spec of list.split(\",\").map((part) => part.trim())) {\n      if (!spec) continue;\n\n      const [local = spec, alias = local] = spec.split(/\\s+as\\s+/);\n      // `default` re-exports name the file's own declaration.\n      const file = local === \"default\" ? target : inner.get(local);\n\n      if (file) exported.set(alias, file);\n    }\n  }\n\n  return exported;\n};\n\nconst CONST_GROUP =\n  /^export declare const ([A-Z][A-Za-z0-9]*): \\{\\n([\\s\\S]*?)\\n\\};/gm;\nconst ENUM_GROUP =\n  /^export declare enum ([A-Z][A-Za-z0-9]*) \\{\\n([\\s\\S]*?)\\n\\}/gm;\n\nconst isComment = (line: string): boolean =>\n  line.startsWith(\"/\") || line.startsWith(\"*\");\n\n/**\n * Reads a group body's members with `member`, which captures a member's name\n * and then its value, sorting each value into current or deprecated by\n * whether the JSDoc just above it says `@deprecated`. Returns `undefined`\n * when a non-comment line is not a string member, which means the body is\n * not a token group.\n */\nconst readMembers = (body: string, member: RegExp): TokenGroup | undefined => {\n  const group: TokenGroup = { values: [], deprecated: [], members: {} };\n  let deprecated = false;\n\n  for (const line of body.split(\"\\n\").map((raw) => raw.trim())) {\n    if (!line) continue;\n\n    if (isComment(line)) {\n      deprecated ||= line.includes(\"@deprecated\");\n      continue;\n    }\n\n    const [, name, value] = line.match(member) ?? [];\n\n    if (name === undefined || value === undefined) return undefined;\n\n    group.members[name] = value;\n\n    const list = deprecated ? group.deprecated : group.values;\n\n    if (!list.includes(value)) list.push(value);\n    deprecated = false;\n  }\n\n  return group.values.length || group.deprecated.length ? group : undefined;\n};\n\n/**\n * String-valued token consts (`export declare const Size: { readonly Sm: \"sm\" … }`)\n * and string enums (`export declare enum X { A = \"a\" … }`), by name.\n */\nexport const findTokenGroups = (files: DeclarationFile[]): TokenGroups => {\n  const groups: TokenGroups = {};\n\n  for (const { text } of files) {\n    for (const [, name, body] of text.matchAll(CONST_GROUP)) {\n      const group =\n        body === undefined\n          ? undefined\n          : readMembers(body, /^readonly ([A-Za-z0-9]+): \"([^\"]*)\";$/);\n\n      if (name && group) groups[name] = group;\n    }\n\n    for (const [, name, body] of text.matchAll(ENUM_GROUP)) {\n      const group =\n        body === undefined\n          ? undefined\n          : readMembers(body, /^([A-Za-z0-9]+) = \"([^\"]*)\",?$/);\n\n      if (name && group) groups[name] = group;\n    }\n  }\n\n  return Object.fromEntries(\n    Object.entries(groups).sort(([a], [b]) => a.localeCompare(b))\n  );\n};\n\n/** A one-line type alias: its name, then its type. */\nconst ALIAS = /^(?:export )?type ([A-Z][A-Za-z0-9]*) = ([^\\n]+);$/gm;\nconst NARROWING = /^(Exclude|Extract)<([A-Z][A-Za-z0-9]*), (.+)>$/;\nconst MEMBER = /^([A-Z][A-Za-z0-9]*)\\.([A-Za-z0-9]+)$/;\n\n/**\n * The values of a `|` list of members such as `Size.Sm | Size.Md`, each kept\n * current or deprecated as its own group has it. `undefined` when any part is\n * not a known member.\n */\nconst readMemberList = (\n  list: string,\n  tokens: TokenGroups\n): TokenValues | undefined => {\n  const result: TokenValues = { values: [], deprecated: [] };\n\n  for (const part of list.split(\"|\").map((raw) => raw.trim())) {\n    const [, groupName = \"\", memberName = \"\"] = part.match(MEMBER) ?? [];\n    const group: TokenGroup | undefined = tokens[groupName];\n    const value: string | undefined = group?.members[memberName];\n\n    if (!group || value === undefined) return undefined;\n\n    const into = group.deprecated.includes(value)\n      ? result.deprecated\n      : result.values;\n\n    into.push(value);\n  }\n\n  return result;\n};\n\n/**\n * The values a narrowed token type allows. Handles the shapes components\n * use: `Exclude<Size, Size.Lg | Size.Xl>`, `Extract<Size, Size.Sm | Size.Md>`\n * and `Size.Sm | Size.Md`, each with or without a `` `${…}` `` wrapper.\n * `undefined` for any other type, which is then left as written.\n */\nconst resolveAlias = (\n  type: string,\n  tokens: TokenGroups\n): TokenValues | undefined => {\n  const inner = type.match(/^`\\$\\{(.*)\\}`$/)?.[1] ?? type;\n  const [, kind, groupName = \"\", list = \"\"] = inner.match(NARROWING) ?? [];\n\n  if (!kind) return readMemberList(inner, tokens);\n\n  const group: TokenGroup | undefined = tokens[groupName];\n  const named = readMemberList(list, tokens);\n\n  if (!group || !named) return undefined;\n\n  const listed = [...named.values, ...named.deprecated];\n  const keep = (value: string): boolean =>\n    listed.includes(value) === (kind === \"Extract\");\n\n  return {\n    values: group.values.filter(keep),\n    deprecated: group.deprecated.filter(keep),\n  };\n};\n\nconst quote = (values: readonly string[]): string[] =>\n  values.map((value) => JSON.stringify(value));\n\n/** `type Size = \"sm\" | \"md\";`, plus a comment naming any deprecated values. */\nconst renderUnion = (\n  name: string,\n  { values, deprecated }: TokenValues\n): string =>\n  `type ${name} = ${quote(values).join(\" | \") || \"never\"};` +\n  (deprecated.length ? ` // deprecated: ${quote(deprecated).join(\", \")}` : \"\");\n\nexport const renderList = (\n  components: readonly ComponentEntry[],\n  iconNames: readonly string[],\n  version: string\n): string => {\n  const shown = components.filter((entry) => !entry.internal);\n  const width = Math.max(0, ...shown.map((entry) => entry.name.length));\n  const rows = shown.map((entry) => {\n    const note = entry.deprecated ? \" (deprecated)\" : \"\";\n\n    return `${entry.name.padEnd(width)}  ${entry.summary}${note}`;\n  });\n\n  return [\n    `@voxel51/voodo ${version}: ${shown.length} components, plus ${iconNames.length} icons.`,\n    \"Run `voodo docs <Name>` for a component's props, docs and token values.\",\n    \"\",\n    ...rows,\n    \"\",\n    `Icons are per-icon components such as ${iconNames.slice(0, 3).join(\", \")}. Run \\`voodo icons\\` for every name.`,\n  ].join(\"\\n\");\n};\n\n/**\n * The declaration file for one component, trimmed for reading, with the value\n * of every token type it mentions written out below it. A narrowed alias\n * (`type ButtonSize = Exclude<Size, …>`) is written out as the values it\n * allows, and the group it narrows only when the file uses that group\n * elsewhere.\n *\n * @param text The declaring file's contents.\n */\nexport const renderDocs = (\n  entry: ComponentEntry,\n  text: string,\n  tokens: TokenGroups\n): string => {\n  const body = text\n    .split(\"\\n\")\n    .filter(\n      (line) =>\n        !line.startsWith(\"import \") &&\n        !line.startsWith(\"//# sourceMappingURL\") &&\n        line !== \"export {};\"\n    )\n    .join(\"\\n\")\n    .trim();\n  const aliases = [...body.matchAll(ALIAS)].flatMap(([line, name, type]) => {\n    const values = name && type ? resolveAlias(type, tokens) : undefined;\n\n    return values ? [{ line, name, values }] : [];\n  });\n  // Types and `{@link}`s count as using a group. Prose does not (\"Size of\n  // the toggle\"), and neither does the group a resolved alias narrows.\n  const references = aliases\n    .reduce((rest, { line }) => rest.replace(line, \"\"), body)\n    .split(\"\\n\")\n    .map((line) =>\n      isComment(line.trim())\n        ? [...line.matchAll(LINK)].map(([, target]) => target).join(\" \")\n        : line\n    )\n    .join(\"\\n\");\n  // Groups declared in this file are already visible in `body`.\n  const local = Object.keys(findTokenGroups([{ path: entry.file, text }]));\n  const used = Object.entries(tokens).filter(\n    ([name]) =>\n      !local.includes(name) && new RegExp(`\\\\b${name}\\\\b`).test(references)\n  );\n  const unions = [\n    ...aliases.map(({ name, values }) => renderUnion(name, values)),\n    ...used.map(([name, group]) => renderUnion(name, group)),\n  ];\n\n  return [\n    `import { ${entry.name} } from \"@voxel51/voodo\";`,\n    `// ${entry.file}`,\n    \"\",\n    body,\n    ...(unions.length ? [\"\", \"// Token values used above\", ...unions] : []),\n  ].join(\"\\n\");\n};\n\n/** Every token group, or only the one named `only` (case-insensitive). */\nexport const renderTokens = (tokens: TokenGroups, only?: string): string =>\n  Object.entries(tokens)\n    .filter(([name]) => !only || name.toLowerCase() === only.toLowerCase())\n    .map(([name, group]) => renderUnion(name, group))\n    .join(\"\\n\");\n\n/** Case-insensitive lookup, with near matches when there is no exact one. */\nexport const lookup = (\n  components: readonly ComponentEntry[],\n  query: string\n): { match?: ComponentEntry; suggestions: string[] } => {\n  const wanted = query.toLowerCase();\n  const match = components.find((entry) => entry.name.toLowerCase() === wanted);\n  const suggestions = match\n    ? []\n    : components\n        .filter((entry) => entry.name.toLowerCase().includes(wanted))\n        .map((entry) => entry.name);\n\n  return { match, suggestions };\n};\n"],"names":["DECLARATION","COMPONENT_TYPE","isComponent","kind","rest","following","docLines","doc","line","LINK","stripLinks","text","summarize","paragraph","sentence","findComponents","files","path","match","a","b","directory","resolveModule","from","specifier","parts","segment","base","resolveExports","entry","exported","name","target","file","list","inner","spec","part","local","alias","CONST_GROUP","ENUM_GROUP","isComment","readMembers","body","member","group","deprecated","raw","value","findTokenGroups","groups","ALIAS","NARROWING","MEMBER","readMemberList","tokens","result","groupName","memberName","resolveAlias","type","named","listed","keep","quote","values","renderUnion","renderList","components","iconNames","version","shown","width","rows","note","renderDocs","aliases","references","used","unions","renderTokens","only","lookup","query","wanted","suggestions"],"mappings":"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"}

package/dist/cli.d.ts

@@ -0,0 +1,2 @@
+export * from './cli/reference'
+export {}

package/dist/cli.js

@@ -0,0 +1,167 @@
+const b = /(?:\/\*\*((?:(?!\*\/)[\s\S])*)\*\/\s*)?^(?:export )?declare (const|function) ([A-Z][A-Za-z0-9]*)([^\n]*)/gm, j = /^(?:<[^>]*>)?\(|^: (?:React\.)?FC<|^: import\(['"]react['"]\)\.(?:ForwardRef|Memo|Named)ExoticComponent</, E = (o, n, e) => o === "function" || j.test(n) ? !0 : n === ": {" && /^\s*\(/.test(e), Z = (o) => o.split(`
+`).map((n) => n.replace(/^\s*\* ?/, "").trimEnd()), $ = /\{@link\s+([^}\s]+)\s*\}/g, C = (o) => o.replace($, "$1"), O = (o) => {
+  const n = [];
+  for (const s of Z(o))
+    if (!(!s.trim() && !n.length)) {
+      if (!s.trim() || s.trimStart().startsWith("@")) break;
+      n.push(s.trim());
+    }
+  const e = C(n.join(" ")).replace(/\s+/g, " ").trim(), t = e.match(/^.*?[.!?](?=\s|$)/);
+  return t ? t[0] : e;
+}, T = (o) => o.flatMap(
+  ({ path: n, text: e }) => [...e.matchAll(b)].filter(
+    (t) => E(
+      t[2] ?? "",
+      t[4] ?? "",
+      e.slice((t.index ?? 0) + t[0].length)
+    )
+  ).map((t) => {
+    const s = t[1] ?? "";
+    return {
+      name: t[3] ?? "",
+      file: n,
+      summary: O(s),
+      hasExample: /@example\b/.test(s),
+      deprecated: /@deprecated\b/.test(s),
+      internal: /@internal\b/.test(s)
+    };
+  })
+).sort((n, e) => n.name.localeCompare(e.name)), L = (o) => o.slice(0, o.lastIndexOf("/")), f = (o, n, e) => {
+  const t = [];
+  for (const r of `${L(n)}/${e}`.split("/"))
+    r === ".." ? t.pop() : r !== "." && t.push(r);
+  const s = t.join("/");
+  return [`${s}.d.ts`, `${s}/index.d.ts`].find((r) => o.has(r));
+}, g = (o, n) => {
+  const e = /* @__PURE__ */ new Map(), t = o.get(n) ?? "";
+  for (const [, s] of t.matchAll(
+    /^export declare (?:const|function|enum) ([A-Za-z0-9_$]+)/gm
+  ))
+    s && e.set(s, n);
+  for (const [, s] of t.matchAll(
+    /^export \* from ['"]([^'"]+)['"];/gm
+  )) {
+    const r = s && f(o, n, s);
+    if (r)
+      for (const [c, i] of g(o, r))
+        e.set(c, i);
+  }
+  for (const [, s, r] of t.matchAll(
+    /^export \{([^}]*)\} from ['"]([^'"]+)['"];/gm
+  )) {
+    const c = r && f(o, n, r);
+    if (!c || !s) continue;
+    const i = g(o, c);
+    for (const p of s.split(",").map((a) => a.trim())) {
+      if (!p) continue;
+      const [a = p, l = a] = p.split(/\s+as\s+/), m = a === "default" ? c : i.get(a);
+      m && e.set(l, m);
+    }
+  }
+  return e;
+}, M = /^export declare const ([A-Z][A-Za-z0-9]*): \{\n([\s\S]*?)\n\};/gm, N = /^export declare enum ([A-Z][A-Za-z0-9]*) \{\n([\s\S]*?)\n\}/gm, x = (o) => o.startsWith("/") || o.startsWith("*"), v = (o, n) => {
+  const e = { values: [], deprecated: [], members: {} };
+  let t = !1;
+  for (const s of o.split(`
+`).map((r) => r.trim())) {
+    if (!s) continue;
+    if (x(s)) {
+      t ||= s.includes("@deprecated");
+      continue;
+    }
+    const [, r, c] = s.match(n) ?? [];
+    if (r === void 0 || c === void 0) return;
+    e.members[r] = c;
+    const i = t ? e.deprecated : e.values;
+    i.includes(c) || i.push(c), t = !1;
+  }
+  return e.values.length || e.deprecated.length ? e : void 0;
+}, w = (o) => {
+  const n = {};
+  for (const { text: e } of o) {
+    for (const [, t, s] of e.matchAll(M)) {
+      const r = s === void 0 ? void 0 : v(s, /^readonly ([A-Za-z0-9]+): "([^"]*)";$/);
+      t && r && (n[t] = r);
+    }
+    for (const [, t, s] of e.matchAll(N)) {
+      const r = s === void 0 ? void 0 : v(s, /^([A-Za-z0-9]+) = "([^"]*)",?$/);
+      t && r && (n[t] = r);
+    }
+  }
+  return Object.fromEntries(
+    Object.entries(n).sort(([e], [t]) => e.localeCompare(t))
+  );
+}, R = /^(?:export )?type ([A-Z][A-Za-z0-9]*) = ([^\n]+);$/gm, z = /^(Exclude|Extract)<([A-Z][A-Za-z0-9]*), (.+)>$/, k = /^([A-Z][A-Za-z0-9]*)\.([A-Za-z0-9]+)$/, h = (o, n) => {
+  const e = { values: [], deprecated: [] };
+  for (const t of o.split("|").map((s) => s.trim())) {
+    const [, s = "", r = ""] = t.match(k) ?? [], c = n[s], i = c?.members[r];
+    if (!c || i === void 0) return;
+    (c.deprecated.includes(i) ? e.deprecated : e.values).push(i);
+  }
+  return e;
+}, S = (o, n) => {
+  const e = o.match(/^`\$\{(.*)\}`$/)?.[1] ?? o, [, t, s = "", r = ""] = e.match(z) ?? [];
+  if (!t) return h(e, n);
+  const c = n[s], i = h(r, n);
+  if (!c || !i) return;
+  const p = [...i.values, ...i.deprecated], a = (l) => p.includes(l) === (t === "Extract");
+  return {
+    values: c.values.filter(a),
+    deprecated: c.deprecated.filter(a)
+  };
+}, A = (o) => o.map((n) => JSON.stringify(n)), d = (o, { values: n, deprecated: e }) => `type ${o} = ${A(n).join(" | ") || "never"};` + (e.length ? ` // deprecated: ${A(e).join(", ")}` : ""), I = (o, n, e) => {
+  const t = o.filter((c) => !c.internal), s = Math.max(0, ...t.map((c) => c.name.length)), r = t.map((c) => {
+    const i = c.deprecated ? " (deprecated)" : "";
+    return `${c.name.padEnd(s)}  ${c.summary}${i}`;
+  });
+  return [
+    `@voxel51/voodo ${e}: ${t.length} components, plus ${n.length} icons.`,
+    "Run `voodo docs <Name>` for a component's props, docs and token values.",
+    "",
+    ...r,
+    "",
+    `Icons are per-icon components such as ${n.slice(0, 3).join(", ")}. Run \`voodo icons\` for every name.`
+  ].join(`
+`);
+}, W = (o, n, e) => {
+  const t = n.split(`
+`).filter(
+    (a) => !a.startsWith("import ") && !a.startsWith("//# sourceMappingURL") && a !== "export {};"
+  ).join(`
+`).trim(), s = [...t.matchAll(R)].flatMap(([a, l, m]) => {
+    const u = l && m ? S(m, e) : void 0;
+    return u ? [{ line: a, name: l, values: u }] : [];
+  }), r = s.reduce((a, { line: l }) => a.replace(l, ""), t).split(`
+`).map(
+    (a) => x(a.trim()) ? [...a.matchAll($)].map(([, l]) => l).join(" ") : a
+  ).join(`
+`), c = Object.keys(w([{ path: o.file, text: n }])), i = Object.entries(e).filter(
+    ([a]) => !c.includes(a) && new RegExp(`\\b${a}\\b`).test(r)
+  ), p = [
+    ...s.map(({ name: a, values: l }) => d(a, l)),
+    ...i.map(([a, l]) => d(a, l))
+  ];
+  return [
+    `import { ${o.name} } from "@voxel51/voodo";`,
+    `// ${o.file}`,
+    "",
+    t,
+    ...p.length ? ["", "// Token values used above", ...p] : []
+  ].join(`
+`);
+}, U = (o, n) => Object.entries(o).filter(([e]) => !n || e.toLowerCase() === n.toLowerCase()).map(([e, t]) => d(e, t)).join(`
+`), G = (o, n) => {
+  const e = n.toLowerCase(), t = o.find((r) => r.name.toLowerCase() === e), s = t ? [] : o.filter((r) => r.name.toLowerCase().includes(e)).map((r) => r.name);
+  return { match: t, suggestions: s };
+};
+export {
+  T as findComponents,
+  w as findTokenGroups,
+  G as lookup,
+  W as renderDocs,
+  I as renderList,
+  U as renderTokens,
+  g as resolveExports,
+  O as summarize
+};
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sources":["../src/cli/reference.ts"],"sourcesContent":["/**\n * Pure helpers for the `voodo` command (`bin/voodo.mjs`). They read the\n * package's shipped `.d.ts` files as plain text and turn them into short,\n * agent-friendly output.\n *\n * Built as its own entry (`dist/cli.js`) so the command can run from an\n * installed package without React. No dependencies and no TypeScript\n * compiler: the emitted declarations are regular enough to read with a few\n * regular expressions, and the spec pins down every shape this relies on.\n */\n\nexport interface ComponentEntry {\n  name: string;\n  /** Path of the declaring `.d.ts`, relative to the package root. */\n  file: string;\n  /** First sentence of the component's JSDoc. */\n  summary: string;\n  /** Whether its JSDoc carries at least one `@example`. */\n  hasExample: boolean;\n  deprecated: boolean;\n  internal: boolean;\n}\n\nexport interface DeclarationFile {\n  /** `/`-separated, relative to the package root. */\n  path: string;\n  text: string;\n}\n\n/** Token string values, current ones apart from deprecated ones. */\nexport interface TokenValues {\n  values: string[];\n  deprecated: string[];\n}\n\n/** One token group's values, plus each member's value by member name. */\nexport interface TokenGroup extends TokenValues {\n  members: Record<string, string>;\n}\n\n/** Token group name → its values. */\nexport type TokenGroups = Record<string, TokenGroup>;\n\n/**\n * An optional JSDoc block followed by a top-level `declare const` or\n * `declare function` whose name starts upper-case. The JSDoc body may not\n * contain `*\\/`, so a match never glues two comment blocks together.\n */\nconst DECLARATION =\n  /(?:\\/\\*\\*((?:(?!\\*\\/)[\\s\\S])*)\\*\\/\\s*)?^(?:export )?declare (const|function) ([A-Z][A-Za-z0-9]*)([^\\n]*)/gm;\n\nconst COMPONENT_TYPE =\n  /^(?:<[^>]*>)?\\(|^: (?:React\\.)?FC<|^: import\\(['\"]react['\"]\\)\\.(?:ForwardRef|Memo|Named)ExoticComponent</;\n\n/**\n * Whether a declaration's type describes a component. Object types count when\n * their first member is a call signature (`{ (props): JSX.Element; … }`, the\n * shape `displayName` assignments produce); token consts are object types too,\n * but their members are `readonly` string literals.\n */\nconst isComponent = (\n  kind: string,\n  rest: string,\n  following: string\n): boolean => {\n  if (kind === \"function\") return true;\n  if (COMPONENT_TYPE.test(rest)) return true;\n\n  return rest === \": {\" && /^\\s*\\(/.test(following);\n};\n\nconst docLines = (doc: string): string[] =>\n  doc.split(\"\\n\").map((line) => line.replace(/^\\s*\\* ?/, \"\").trimEnd());\n\nconst LINK = /\\{@link\\s+([^}\\s]+)\\s*\\}/g;\n\nconst stripLinks = (text: string): string => text.replace(LINK, \"$1\");\n\n/**\n * The first sentence of a JSDoc description: the text before the first blank\n * line or tag, with links reduced to their names.\n *\n * @param doc Raw JSDoc body, without the delimiters.\n */\nexport const summarize = (doc: string): string => {\n  const paragraph: string[] = [];\n\n  for (const line of docLines(doc)) {\n    // The body starts with the rest of the `/**` line, usually empty.\n    if (!line.trim() && !paragraph.length) continue;\n    if (!line.trim() || line.trimStart().startsWith(\"@\")) break;\n    paragraph.push(line.trim());\n  }\n\n  const text = stripLinks(paragraph.join(\" \")).replace(/\\s+/g, \" \").trim();\n  const sentence = text.match(/^.*?[.!?](?=\\s|$)/);\n\n  return sentence ? sentence[0] : text;\n};\n\n/** Every component declared in the given files, sorted by name. */\nexport const findComponents = (files: DeclarationFile[]): ComponentEntry[] =>\n  files\n    .flatMap(({ path, text }) =>\n      [...text.matchAll(DECLARATION)]\n        .filter((match) =>\n          isComponent(\n            match[2] ?? \"\",\n            match[4] ?? \"\",\n            text.slice((match.index ?? 0) + match[0].length)\n          )\n        )\n        .map((match) => {\n          const doc = match[1] ?? \"\";\n\n          return {\n            name: match[3] ?? \"\",\n            file: path,\n            summary: summarize(doc),\n            hasExample: /@example\\b/.test(doc),\n            deprecated: /@deprecated\\b/.test(doc),\n            internal: /@internal\\b/.test(doc),\n          };\n        })\n    )\n    .sort((a, b) => a.name.localeCompare(b.name));\n\nconst directory = (path: string): string =>\n  path.slice(0, path.lastIndexOf(\"/\"));\n\n/**\n * The declaration file a relative specifier points at: `./Button` is either\n * `Button.d.ts` or `Button/index.d.ts`.\n */\nconst resolveModule = (\n  files: ReadonlyMap<string, string>,\n  from: string,\n  specifier: string\n): string | undefined => {\n  const parts: string[] = [];\n\n  for (const segment of `${directory(from)}/${specifier}`.split(\"/\")) {\n    if (segment === \"..\") parts.pop();\n    else if (segment !== \".\") parts.push(segment);\n  }\n\n  const base = parts.join(\"/\");\n\n  return [`${base}.d.ts`, `${base}/index.d.ts`].find((path) => files.has(path));\n};\n\n/**\n * Every value a barrel exports, mapped to the file that declares it. Follows\n * `export * from` and `export { a, b as c } from` through other declaration\n * files; `export type` re-exports carry no values and are skipped.\n *\n * @param files Path → text, `/`-separated.\n * @param entry The barrel to start from.\n */\nexport const resolveExports = (\n  files: ReadonlyMap<string, string>,\n  entry: string\n): Map<string, string> => {\n  const exported = new Map<string, string>();\n  const text = files.get(entry) ?? \"\";\n\n  for (const [, name] of text.matchAll(\n    /^export declare (?:const|function|enum) ([A-Za-z0-9_$]+)/gm\n  )) {\n    if (name) exported.set(name, entry);\n  }\n\n  for (const [, specifier] of text.matchAll(\n    /^export \\* from ['\"]([^'\"]+)['\"];/gm\n  )) {\n    const target = specifier && resolveModule(files, entry, specifier);\n\n    if (target) {\n      for (const [name, file] of resolveExports(files, target)) {\n        exported.set(name, file);\n      }\n    }\n  }\n\n  for (const [, list, specifier] of text.matchAll(\n    /^export \\{([^}]*)\\} from ['\"]([^'\"]+)['\"];/gm\n  )) {\n    const target = specifier && resolveModule(files, entry, specifier);\n\n    if (!target || !list) continue;\n\n    const inner = resolveExports(files, target);\n\n    for (const spec of list.split(\",\").map((part) => part.trim())) {\n      if (!spec) continue;\n\n      const [local = spec, alias = local] = spec.split(/\\s+as\\s+/);\n      // `default` re-exports name the file's own declaration.\n      const file = local === \"default\" ? target : inner.get(local);\n\n      if (file) exported.set(alias, file);\n    }\n  }\n\n  return exported;\n};\n\nconst CONST_GROUP =\n  /^export declare const ([A-Z][A-Za-z0-9]*): \\{\\n([\\s\\S]*?)\\n\\};/gm;\nconst ENUM_GROUP =\n  /^export declare enum ([A-Z][A-Za-z0-9]*) \\{\\n([\\s\\S]*?)\\n\\}/gm;\n\nconst isComment = (line: string): boolean =>\n  line.startsWith(\"/\") || line.startsWith(\"*\");\n\n/**\n * Reads a group body's members with `member`, which captures a member's name\n * and then its value, sorting each value into current or deprecated by\n * whether the JSDoc just above it says `@deprecated`. Returns `undefined`\n * when a non-comment line is not a string member, which means the body is\n * not a token group.\n */\nconst readMembers = (body: string, member: RegExp): TokenGroup | undefined => {\n  const group: TokenGroup = { values: [], deprecated: [], members: {} };\n  let deprecated = false;\n\n  for (const line of body.split(\"\\n\").map((raw) => raw.trim())) {\n    if (!line) continue;\n\n    if (isComment(line)) {\n      deprecated ||= line.includes(\"@deprecated\");\n      continue;\n    }\n\n    const [, name, value] = line.match(member) ?? [];\n\n    if (name === undefined || value === undefined) return undefined;\n\n    group.members[name] = value;\n\n    const list = deprecated ? group.deprecated : group.values;\n\n    if (!list.includes(value)) list.push(value);\n    deprecated = false;\n  }\n\n  return group.values.length || group.deprecated.length ? group : undefined;\n};\n\n/**\n * String-valued token consts (`export declare const Size: { readonly Sm: \"sm\" … }`)\n * and string enums (`export declare enum X { A = \"a\" … }`), by name.\n */\nexport const findTokenGroups = (files: DeclarationFile[]): TokenGroups => {\n  const groups: TokenGroups = {};\n\n  for (const { text } of files) {\n    for (const [, name, body] of text.matchAll(CONST_GROUP)) {\n      const group =\n        body === undefined\n          ? undefined\n          : readMembers(body, /^readonly ([A-Za-z0-9]+): \"([^\"]*)\";$/);\n\n      if (name && group) groups[name] = group;\n    }\n\n    for (const [, name, body] of text.matchAll(ENUM_GROUP)) {\n      const group =\n        body === undefined\n          ? undefined\n          : readMembers(body, /^([A-Za-z0-9]+) = \"([^\"]*)\",?$/);\n\n      if (name && group) groups[name] = group;\n    }\n  }\n\n  return Object.fromEntries(\n    Object.entries(groups).sort(([a], [b]) => a.localeCompare(b))\n  );\n};\n\n/** A one-line type alias: its name, then its type. */\nconst ALIAS = /^(?:export )?type ([A-Z][A-Za-z0-9]*) = ([^\\n]+);$/gm;\nconst NARROWING = /^(Exclude|Extract)<([A-Z][A-Za-z0-9]*), (.+)>$/;\nconst MEMBER = /^([A-Z][A-Za-z0-9]*)\\.([A-Za-z0-9]+)$/;\n\n/**\n * The values of a `|` list of members such as `Size.Sm | Size.Md`, each kept\n * current or deprecated as its own group has it. `undefined` when any part is\n * not a known member.\n */\nconst readMemberList = (\n  list: string,\n  tokens: TokenGroups\n): TokenValues | undefined => {\n  const result: TokenValues = { values: [], deprecated: [] };\n\n  for (const part of list.split(\"|\").map((raw) => raw.trim())) {\n    const [, groupName = \"\", memberName = \"\"] = part.match(MEMBER) ?? [];\n    const group: TokenGroup | undefined = tokens[groupName];\n    const value: string | undefined = group?.members[memberName];\n\n    if (!group || value === undefined) return undefined;\n\n    const into = group.deprecated.includes(value)\n      ? result.deprecated\n      : result.values;\n\n    into.push(value);\n  }\n\n  return result;\n};\n\n/**\n * The values a narrowed token type allows. Handles the shapes components\n * use: `Exclude<Size, Size.Lg | Size.Xl>`, `Extract<Size, Size.Sm | Size.Md>`\n * and `Size.Sm | Size.Md`, each with or without a `` `${…}` `` wrapper.\n * `undefined` for any other type, which is then left as written.\n */\nconst resolveAlias = (\n  type: string,\n  tokens: TokenGroups\n): TokenValues | undefined => {\n  const inner = type.match(/^`\\$\\{(.*)\\}`$/)?.[1] ?? type;\n  const [, kind, groupName = \"\", list = \"\"] = inner.match(NARROWING) ?? [];\n\n  if (!kind) return readMemberList(inner, tokens);\n\n  const group: TokenGroup | undefined = tokens[groupName];\n  const named = readMemberList(list, tokens);\n\n  if (!group || !named) return undefined;\n\n  const listed = [...named.values, ...named.deprecated];\n  const keep = (value: string): boolean =>\n    listed.includes(value) === (kind === \"Extract\");\n\n  return {\n    values: group.values.filter(keep),\n    deprecated: group.deprecated.filter(keep),\n  };\n};\n\nconst quote = (values: readonly string[]): string[] =>\n  values.map((value) => JSON.stringify(value));\n\n/** `type Size = \"sm\" | \"md\";`, plus a comment naming any deprecated values. */\nconst renderUnion = (\n  name: string,\n  { values, deprecated }: TokenValues\n): string =>\n  `type ${name} = ${quote(values).join(\" | \") || \"never\"};` +\n  (deprecated.length ? ` // deprecated: ${quote(deprecated).join(\", \")}` : \"\");\n\nexport const renderList = (\n  components: readonly ComponentEntry[],\n  iconNames: readonly string[],\n  version: string\n): string => {\n  const shown = components.filter((entry) => !entry.internal);\n  const width = Math.max(0, ...shown.map((entry) => entry.name.length));\n  const rows = shown.map((entry) => {\n    const note = entry.deprecated ? \" (deprecated)\" : \"\";\n\n    return `${entry.name.padEnd(width)}  ${entry.summary}${note}`;\n  });\n\n  return [\n    `@voxel51/voodo ${version}: ${shown.length} components, plus ${iconNames.length} icons.`,\n    \"Run `voodo docs <Name>` for a component's props, docs and token values.\",\n    \"\",\n    ...rows,\n    \"\",\n    `Icons are per-icon components such as ${iconNames.slice(0, 3).join(\", \")}. Run \\`voodo icons\\` for every name.`,\n  ].join(\"\\n\");\n};\n\n/**\n * The declaration file for one component, trimmed for reading, with the value\n * of every token type it mentions written out below it. A narrowed alias\n * (`type ButtonSize = Exclude<Size, …>`) is written out as the values it\n * allows, and the group it narrows only when the file uses that group\n * elsewhere.\n *\n * @param text The declaring file's contents.\n */\nexport const renderDocs = (\n  entry: ComponentEntry,\n  text: string,\n  tokens: TokenGroups\n): string => {\n  const body = text\n    .split(\"\\n\")\n    .filter(\n      (line) =>\n        !line.startsWith(\"import \") &&\n        !line.startsWith(\"//# sourceMappingURL\") &&\n        line !== \"export {};\"\n    )\n    .join(\"\\n\")\n    .trim();\n  const aliases = [...body.matchAll(ALIAS)].flatMap(([line, name, type]) => {\n    const values = name && type ? resolveAlias(type, tokens) : undefined;\n\n    return values ? [{ line, name, values }] : [];\n  });\n  // Types and `{@link}`s count as using a group. Prose does not (\"Size of\n  // the toggle\"), and neither does the group a resolved alias narrows.\n  const references = aliases\n    .reduce((rest, { line }) => rest.replace(line, \"\"), body)\n    .split(\"\\n\")\n    .map((line) =>\n      isComment(line.trim())\n        ? [...line.matchAll(LINK)].map(([, target]) => target).join(\" \")\n        : line\n    )\n    .join(\"\\n\");\n  // Groups declared in this file are already visible in `body`.\n  const local = Object.keys(findTokenGroups([{ path: entry.file, text }]));\n  const used = Object.entries(tokens).filter(\n    ([name]) =>\n      !local.includes(name) && new RegExp(`\\\\b${name}\\\\b`).test(references)\n  );\n  const unions = [\n    ...aliases.map(({ name, values }) => renderUnion(name, values)),\n    ...used.map(([name, group]) => renderUnion(name, group)),\n  ];\n\n  return [\n    `import { ${entry.name} } from \"@voxel51/voodo\";`,\n    `// ${entry.file}`,\n    \"\",\n    body,\n    ...(unions.length ? [\"\", \"// Token values used above\", ...unions] : []),\n  ].join(\"\\n\");\n};\n\n/** Every token group, or only the one named `only` (case-insensitive). */\nexport const renderTokens = (tokens: TokenGroups, only?: string): string =>\n  Object.entries(tokens)\n    .filter(([name]) => !only || name.toLowerCase() === only.toLowerCase())\n    .map(([name, group]) => renderUnion(name, group))\n    .join(\"\\n\");\n\n/** Case-insensitive lookup, with near matches when there is no exact one. */\nexport const lookup = (\n  components: readonly ComponentEntry[],\n  query: string\n): { match?: ComponentEntry; suggestions: string[] } => {\n  const wanted = query.toLowerCase();\n  const match = components.find((entry) => entry.name.toLowerCase() === wanted);\n  const suggestions = match\n    ? []\n    : components\n        .filter((entry) => entry.name.toLowerCase().includes(wanted))\n        .map((entry) => entry.name);\n\n  return { match, suggestions };\n};\n"],"names":["DECLARATION","COMPONENT_TYPE","isComponent","kind","rest","following","docLines","doc","line","LINK","stripLinks","text","summarize","paragraph","sentence","findComponents","files","path","match","a","b","directory","resolveModule","from","specifier","parts","segment","base","resolveExports","entry","exported","name","target","file","list","inner","spec","part","local","alias","CONST_GROUP","ENUM_GROUP","isComment","readMembers","body","member","group","deprecated","raw","value","findTokenGroups","groups","ALIAS","NARROWING","MEMBER","readMemberList","tokens","result","groupName","memberName","resolveAlias","type","named","listed","keep","quote","values","renderUnion","renderList","components","iconNames","version","shown","width","rows","note","renderDocs","aliases","references","used","unions","renderTokens","only","lookup","query","wanted","suggestions"],"mappings":"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"}

package/dist/components/ActivityToast/ActivityToast.d.ts

@@ -21,7 +21,7 @@ export interface ActivityToastProps extends HTMLAttributes<HTMLDivElement> {
  *   open={true}
  *   icon={CheckIcon}
  *   message={"Operation successful"}
- *   variant={Variant.Success}
+ *   variant="success"
  * />
  * ```
  *

package/dist/components/ActivityToast/ActivityToast.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ActivityToast.d.ts","sourceRoot":"","sources":["../../../src/components/ActivityToast/ActivityToast.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAAE,EAAE,cAAc,EAAE,MAAM,OAAO,CAAC;AAEhD,OAAO,EAAE,KAAK,SAAS,EAAe,MAAM,oBAAoB,CAAC;AAKjE,OAAO,EACL,MAAM,EAON,OAAO,EACR,MAAM,SAAS,CAAC;AAGjB,MAAM,WAAW,kBAAmB,SAAQ,cAAc,CAAC,cAAc,CAAC;IACxE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,eAAO,MAAM,aAAa,EAAE,EAAE,CAAC,kBAAkB,CAgChD,CAAC"}
+{"version":3,"file":"ActivityToast.d.ts","sourceRoot":"","sources":["../../../src/components/ActivityToast/ActivityToast.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAAE,EAAE,cAAc,EAAE,MAAM,OAAO,CAAC;AAEhD,OAAO,EAAE,KAAK,SAAS,EAAe,MAAM,oBAAoB,CAAC;AAKjE,OAAO,EACL,MAAM,EAQN,OAAO,EACR,MAAM,SAAS,CAAC;AAGjB,MAAM,WAAW,kBAAmB,SAAQ,cAAc,CAAC,cAAc,CAAC;IACxE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,eAAO,MAAM,aAAa,EAAE,EAAE,CAAC,kBAAkB,CAsChD,CAAC"}

package/dist/components/Button/Button.d.ts

@@ -20,13 +20,15 @@ export interface ButtonProps extends ButtonHTMLAttributes<HTMLButtonElement>, Pi
  *
  * @example
  * ```tsx
- *   <Button onClick={() => alert("Button clicked")}>
- *     Click me
+ *   <Button variant="primary" size="sm" leadingIcon={AddIcon} onClick={save}>
+ *     Add dataset
  *   </Button>
  * ```
  *
  * @param variant The button variant; this controls the general styling of the button. See {@link Variant}.
- * @param size The size of the button; this controls both the text size and the button size. See {@link Size}.
+ * @param size The size of the button; this controls both the text size and the button size: `"xs"`, `"sm"` or `"md"`. Defaults to `"md"`.
+ * @param target Link target; only used with `href`.
+ * @param rel Link rel; only used with `href`. Defaults to `"noreferrer"` when `target` is `"_blank"`.
  * @param borderless Boolean controlling whether the button should be "borderless," removing any borders and
  *  rounding the corners.
  * @param leadingIcon Optional icon component which prefixes the button's content.

package/dist/components/Button/Button.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Button.d.ts","sourceRoot":"","sources":["../../../src/components/Button/Button.tsx"],"names":[],"mappings":"AAEA,OAAO,EACL,oBAAoB,EACpB,oBAAoB,EAEpB,EAAE,EACH,MAAM,OAAO,CAAC;AAEf,OAAO,EAAE,KAAK,SAAS,EAAe,MAAM,oBAAoB,CAAC;AAEjE,OAAO,EAQL,IAAI,EAGJ,OAAO,EACR,MAAM,SAAS,CAAC;AAKjB,KAAK,UAAU,GAAG,GAAG,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE,GAAG,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC;AAExD,MAAM,WAAW,WACf,SACE,oBAAoB,CAAC,iBAAiB,CAAC,EACvC,IAAI,CAAC,oBAAoB,CAAC,iBAAiB,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;IAC1E;;;;OAIG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,IAAI,CAAC,EAAE,UAAU,CAAC;IAClB,WAAW,CAAC,EAAE,SAAS,CAAC;IACxB,YAAY,CAAC,EAAE,SAAS,CAAC;IACzB,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAwFD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,eAAO,MAAM,MAAM,EAAE,EAAE,CAAC,WAAW,CAoFlC,CAAC"}
+{"version":3,"file":"Button.d.ts","sourceRoot":"","sources":["../../../src/components/Button/Button.tsx"],"names":[],"mappings":"AAEA,OAAO,EACL,oBAAoB,EACpB,oBAAoB,EAEpB,EAAE,EAEH,MAAM,OAAO,CAAC;AAEf,OAAO,EAAE,KAAK,SAAS,EAAe,MAAM,oBAAoB,CAAC;AAGjE,OAAO,EAOL,IAAI,EAIJ,OAAO,EACR,MAAM,SAAS,CAAC;AAKjB,KAAK,UAAU,GAAG,GAAG,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE,GAAG,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC;AAExD,MAAM,WAAW,WACf,SACE,oBAAoB,CAAC,iBAAiB,CAAC,EACvC,IAAI,CAAC,oBAAoB,CAAC,iBAAiB,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;IAC1E;;;;OAIG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,IAAI,CAAC,EAAE,UAAU,CAAC;IAClB,WAAW,CAAC,EAAE,SAAS,CAAC;IACxB,YAAY,CAAC,EAAE,SAAS,CAAC;IACzB,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AA2HD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,eAAO,MAAM,MAAM,EAAE,EAAE,CAAC,WAAW,CA2FlC,CAAC"}

package/dist/components/Card/Card.d.ts

@@ -24,16 +24,16 @@ export interface CardProps extends HTMLAttributes<HTMLDivElement> {
  *
  * @example
  * ```tsx
- * <Card background={CardBackground.Secondary} compact>
+ * <Card background="secondary" compact>
  *   Card content here
  * </Card>
  * ```
  *
- * @param background The background color variant. Defaults to {@link CardBackground.Primary}.
+ * @param background The background color variant. Defaults to `"primary"`.
  * @param border Whether to render a border around the card.
  * @param className Additional CSS class names to apply to the card.
  * @param compact When true, reduces internal padding.
- * @param shadow The shadow depth applied to the card. Defaults to {@link Shadow.Md}.
+ * @param shadow The shadow depth applied to the card. Defaults to `"none"`.
  * @param outlined When true, replaces the shadow with a border outline.
  * @param children The content of the card.
  * @param props Additional HTML properties to apply to the card.

package/dist/components/Card/Card.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Card.d.ts","sourceRoot":"","sources":["../../../src/components/Card/Card.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAAE,EAAE,cAAc,EAAE,MAAM,OAAO,CAAC;AAIhD,OAAO,EAOL,MAAM,EACP,MAAM,SAAS,CAAC;AAGjB,eAAO,MAAM,cAAc;;;;CAIjB,CAAC;AACX,MAAM,MAAM,cAAc,GACxB,GAAG,CAAC,OAAO,cAAc,CAAC,CAAC,MAAM,OAAO,cAAc,CAAC,EAAE,CAAC;AAE5D,yBAAiB,cAAc,CAAC;IAC9B,KAAY,OAAO,GAAG,OAAO,cAAc,CAAC,OAAO,CAAC;IACpD,KAAY,SAAS,GAAG,OAAO,cAAc,CAAC,SAAS,CAAC;IACxD,KAAY,QAAQ,GAAG,OAAO,cAAc,CAAC,QAAQ,CAAC;CACvD;AAED,MAAM,WAAW,SAAU,SAAQ,cAAc,CAAC,cAAc,CAAC;IAC/D,UAAU,CAAC,EAAE,cAAc,CAAC;IAC5B,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAQD;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,IAAI,EAAE,EAAE,CAAC,SAAS,CA0B9B,CAAC"}
+{"version":3,"file":"Card.d.ts","sourceRoot":"","sources":["../../../src/components/Card/Card.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAAE,EAAE,cAAc,EAAE,MAAM,OAAO,CAAC;AAIhD,OAAO,EAOL,MAAM,EACP,MAAM,SAAS,CAAC;AAGjB,eAAO,MAAM,cAAc;;;;CAIjB,CAAC;AACX,MAAM,MAAM,cAAc,GACxB,GAAG,CAAC,OAAO,cAAc,CAAC,CAAC,MAAM,OAAO,cAAc,CAAC,EAAE,CAAC;AAE5D,yBAAiB,cAAc,CAAC;IAC9B,KAAY,OAAO,GAAG,OAAO,cAAc,CAAC,OAAO,CAAC;IACpD,KAAY,SAAS,GAAG,OAAO,cAAc,CAAC,SAAS,CAAC;IACxD,KAAY,QAAQ,GAAG,OAAO,cAAc,CAAC,QAAQ,CAAC;CACvD;AAED,MAAM,WAAW,SAAU,SAAQ,cAAc,CAAC,cAAc,CAAC;IAC/D,UAAU,CAAC,EAAE,cAAc,CAAC;IAC5B,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAQD;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,IAAI,EAAE,EAAE,CAAC,SAAS,CA2B9B,CAAC"}

package/dist/components/Card/RichCard.d.ts

@@ -16,7 +16,7 @@ export interface RichCardProps extends CardProps {
  * @example
  * ```tsx
  * <RichCard
- *   icon={StarIcon}
+ *   icon={SearchIcon}
  *   title="Getting Started"
  *   description="Follow these steps to set up your workspace."
  *   badge="New"
@@ -38,6 +38,8 @@ export declare const RichCard: FC<RichCardProps>;
  * an array of strings is rendered as a bulleted list.
  *
  * @param text The description content.
+ *
+ * @internal Rendered by {@link RichCard}; pass `description` to it instead.
  */
 export declare const Description: FC<{
     text: string | string[];

package/dist/components/Card/RichCard.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"RichCard.d.ts","sourceRoot":"","sources":["../../../src/components/Card/RichCard.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC;AAChC,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,OAAO,EAAwB,SAAS,EAAE,MAAM,mBAAmB,CAAC;AACpE,OAAO,EAAE,KAAK,SAAS,EAAoB,MAAM,oBAAoB,CAAC;AAiBtE,MAAM,WAAW,aAAc,SAAQ,SAAS;IAC9C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IAChC,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;CAC1B;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,eAAO,MAAM,QAAQ,EAAE,EAAE,CAAC,aAAa,CAoEtC,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,WAAW,EAAE,EAAE,CAAC;IAAE,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAAA;CAAE,CAcvD,CAAC"}
+{"version":3,"file":"RichCard.d.ts","sourceRoot":"","sources":["../../../src/components/Card/RichCard.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC;AAChC,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,OAAO,EAAwB,SAAS,EAAE,MAAM,mBAAmB,CAAC;AACpE,OAAO,EAAE,KAAK,SAAS,EAAoB,MAAM,oBAAoB,CAAC;AAiBtE,MAAM,WAAW,aAAc,SAAQ,SAAS;IAC9C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IAChC,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;CAC1B;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,eAAO,MAAM,QAAQ,EAAE,EAAE,CAAC,aAAa,CA2DtC,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,WAAW,EAAE,EAAE,CAAC;IAAE,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAAA;CAAE,CAoBvD,CAAC"}

package/dist/components/Checkbox/Checkbox.d.ts

@@ -41,6 +41,7 @@ export interface CheckboxProps extends ModifiedCheckboxProps {
  * @param radius Border radius of the checkbox; this controls the styling of the checkbox itself. See {@link Radius}.
  * @param className `class` overrides to apply to the checkbox.
  * @param labelClassName `class` overrides for custom styling of the checkbox's label.
+ * @param disabled If `true`, disables the checkbox.
  * @param label Label to display alongside the checkbox.
  * @param showUnsetHint If `true`, displays a hint to the user for checkbox interaction.
  * @param props Additional HTML properties to apply to the checkbox.