@databricks/appkit-ui 0.92.0 → 0.94.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (72) hide show
  1. package/CLAUDE.md +3 -0
  2. package/dist/cli/commands/docs.js +231 -10
  3. package/dist/cli/commands/docs.js.map +1 -1
  4. package/dist/cli/commands/plugin/add/add.js +398 -0
  5. package/dist/cli/commands/plugin/add/add.js.map +1 -0
  6. package/dist/cli/commands/plugin/add/plan.js +216 -0
  7. package/dist/cli/commands/plugin/add/plan.js.map +1 -0
  8. package/dist/cli/commands/plugin/add/resolve.js +45 -0
  9. package/dist/cli/commands/plugin/add/resolve.js.map +1 -0
  10. package/dist/cli/commands/plugin/index.js +4 -1
  11. package/dist/cli/commands/plugin/index.js.map +1 -1
  12. package/dist/cli/commands/registry/add.js +3 -2
  13. package/dist/cli/commands/registry/add.js.map +1 -1
  14. package/dist/cli/commands/registry/config-plan.js +1 -1
  15. package/dist/cli/commands/registry/config-plan.js.map +1 -1
  16. package/dist/cli/commands/registry/config-writer.js +77 -9
  17. package/dist/cli/commands/registry/config-writer.js.map +1 -1
  18. package/dist/cli/commands/registry/env-writer.js +1 -1
  19. package/dist/cli/commands/registry/env-writer.js.map +1 -1
  20. package/dist/cli/commands/registry/server-register.js +62 -26
  21. package/dist/cli/commands/registry/server-register.js.map +1 -1
  22. package/dist/cli/commands/registry/workspace-picker.js +1 -1
  23. package/dist/cli/deploy-config.js.map +1 -1
  24. package/dist/cli/index.js +1 -1
  25. package/dist/react/beta.d.ts +3 -1
  26. package/dist/react/beta.js +3 -1
  27. package/dist/react/charts/base.d.ts +1 -1
  28. package/dist/react/charts/base.d.ts.map +1 -1
  29. package/dist/react/charts/base.js +5 -3
  30. package/dist/react/charts/base.js.map +1 -1
  31. package/dist/react/charts/constants.js +13 -1
  32. package/dist/react/charts/constants.js.map +1 -1
  33. package/dist/react/charts/create-chart.js +1 -1
  34. package/dist/react/charts/create-chart.js.map +1 -1
  35. package/dist/react/charts/index.d.ts +1 -1
  36. package/dist/react/charts/types.d.ts +17 -8
  37. package/dist/react/charts/types.d.ts.map +1 -1
  38. package/dist/react/charts/types.js.map +1 -1
  39. package/dist/react/charts/wrapper.d.ts +1 -1
  40. package/dist/react/charts/wrapper.d.ts.map +1 -1
  41. package/dist/react/charts/wrapper.js +12 -5
  42. package/dist/react/charts/wrapper.js.map +1 -1
  43. package/dist/react/design-page.d.ts +33 -0
  44. package/dist/react/design-page.d.ts.map +1 -0
  45. package/dist/react/design-page.js +173 -0
  46. package/dist/react/design-page.js.map +1 -0
  47. package/dist/react/hooks/use-design-ready.d.ts +19 -0
  48. package/dist/react/hooks/use-design-ready.d.ts.map +1 -0
  49. package/dist/react/hooks/use-design-ready.js +33 -0
  50. package/dist/react/hooks/use-design-ready.js.map +1 -0
  51. package/dist/react/index.d.ts +2 -2
  52. package/dist/react/table/data-table.d.ts +6 -0
  53. package/dist/react/table/data-table.d.ts.map +1 -1
  54. package/dist/react/table/data-table.js +6 -0
  55. package/dist/react/table/data-table.js.map +1 -1
  56. package/dist/shared/src/plugin.d.ts.map +1 -1
  57. package/docs/api/appkit/Variable.design.md +6 -0
  58. package/docs/api/appkit-ui/data/AreaChart.md +25 -25
  59. package/docs/api/appkit-ui/data/BarChart.md +23 -23
  60. package/docs/api/appkit-ui/data/DataTable.md +2 -0
  61. package/docs/api/appkit-ui/data/DonutChart.md +24 -24
  62. package/docs/api/appkit-ui/data/HeatmapChart.md +25 -25
  63. package/docs/api/appkit-ui/data/LineChart.md +24 -24
  64. package/docs/api/appkit-ui/data/PieChart.md +24 -24
  65. package/docs/api/appkit-ui/data/RadarChart.md +22 -22
  66. package/docs/api/appkit-ui/data/ScatterChart.md +22 -22
  67. package/docs/api/appkit.md +1 -0
  68. package/docs/plugins/analytics.md +9 -1
  69. package/docs/plugins/design.md +233 -0
  70. package/llms.txt +3 -0
  71. package/package.json +1 -1
  72. package/sbom.cdx.json +1 -1
package/CLAUDE.md CHANGED
@@ -7,6 +7,7 @@ npx @databricks/appkit docs <query>
7
7
  ```
8
8
 
9
9
  - View documentation index: `npx @databricks/appkit docs`
10
+ - Look up components, hooks and functions by name: `npx @databricks/appkit docs BarChart DataTable Select useAnalyticsQuery sql`
10
11
  - View a section: `npx @databricks/appkit docs "appkit-ui API reference"`
11
12
  - Full index (all API entries): `npx @databricks/appkit docs --full`
12
13
  - View specific doc: `npx @databricks/appkit docs ./docs/plugins/analytics.md`
@@ -49,6 +50,7 @@ npx @databricks/appkit docs <query>
49
50
  - [Caching](./docs/plugins/caching.md): AppKit provides both global and plugin-level caching capabilities.
50
51
  - [Creating custom plugins](./docs/plugins/custom-plugins.md): If you need custom API routes or background logic, implement an AppKit plugin. The fastest way is to use the CLI:
51
52
  - [Database plugin](./docs/plugins/database.md): This plugin is currently beta. APIs may change between minor releases. Import from @databricks/appkit/beta. See Plugin Stability Tiers.
53
+ - [Design plugin](./docs/plugins/design.md): This plugin is currently beta. APIs may change between minor releases. Import from @databricks/appkit/beta. See Plugin Stability Tiers.
52
54
  - [Execution context](./docs/plugins/execution-context.md): AppKit uses the service principal by default. Open a caller scope when an
53
55
  - [Files plugin](./docs/plugins/files.md): File operations against Databricks Unity Catalog Volumes. Supports listing, reading, downloading, uploading, deleting, and previewing files with built-in caching, retry, and timeout handling via the execution interceptor pipeline.
54
56
  - [Genie plugin](./docs/plugins/genie.md): Integrates Databricks AI/BI Genie spaces into your AppKit application, enabling natural language data queries via a conversational interface.
@@ -317,6 +319,7 @@ npx @databricks/appkit docs <query>
317
319
  - [Type Alias: WorkspaceClientLike](./docs/api/appkit/TypeAlias.WorkspaceClientLike.md): Structural shape of a Databricks SDK client used by fromSupervisorApi.
318
320
  - [Variable: agents](./docs/api/appkit/Variable.agents.md): Plugin factory for the agents plugin. Discovers agents from
319
321
  - [Variable: aiSearch](./docs/api/appkit/Variable.aiSearch.md)
322
+ - [Variable: design](./docs/api/appkit/Variable.design.md)
320
323
  - [Variable: READ_ACTIONS](./docs/api/appkit/Variable.READ_ACTIONS.md): Actions that only read data.
321
324
  - [Variable: sql](./docs/api/appkit/Variable.sql.md): SQL helper namespace
322
325
  - [Variable: SUPERVISOR_EXTENSION_KEY](./docs/api/appkit/Variable.SUPERVISOR_EXTENSION_KEY.md): Namespace key under which the adapter reads its hosted-tool payload
@@ -78,37 +78,258 @@ function formatCollapsedSection(section) {
78
78
  function formatExpandedSection(section) {
79
79
  return `## ${section.name}${section.body}`;
80
80
  }
81
- function runDocs(query, options) {
81
+ const EXAMPLE_HEADINGS = new Set(["Example", "Examples"]);
82
+ const COMPONENT_PAGE_HEADINGS = new Set([
83
+ ...EXAMPLE_HEADINGS,
84
+ "Usage",
85
+ "Props"
86
+ ]);
87
+ const NOT_PROSE = /^(```|\||<!--|\*\*Source:\*\*)/;
88
+ /** The exported docs carry each heading's anchor link (`## Props[​](#props "Direct link to Props")`). */
89
+ function cleanLine(line) {
90
+ return line.replace(/\[\u200b\]\(#[^\s)]*(?: "[^"]*")?\)/g, "").trimEnd();
91
+ }
92
+ const linesByFile = /* @__PURE__ */ new Map();
93
+ function linesOf(file) {
94
+ let lines = linesByFile.get(file);
95
+ if (!lines) {
96
+ let inCode = false;
97
+ lines = fs.readFileSync(file, "utf-8").split("\n").map((raw) => {
98
+ const fence = raw.startsWith("```");
99
+ if (fence) inCode = !inCode;
100
+ return {
101
+ text: cleanLine(raw),
102
+ code: fence || inCode
103
+ };
104
+ });
105
+ linesByFile.set(file, lines);
106
+ }
107
+ return lines;
108
+ }
109
+ const headingOf = (line) => line.code ? null : line.text.match(/^(#+) (.*)$/);
110
+ function markdownFiles(dir) {
111
+ if (!fs.existsSync(dir)) return [];
112
+ return fs.readdirSync(dir, { withFileTypes: true }).sort((a, b) => a.name.localeCompare(b.name)).flatMap((entry) => {
113
+ const file = path.join(dir, entry.name);
114
+ if (entry.isDirectory()) return markdownFiles(file);
115
+ return entry.name.endsWith(".md") ? [file] : [];
116
+ });
117
+ }
118
+ /**
119
+ * Every documented name: component pages and their parts (`api/appkit-ui/<group>/<Name>.md`, `## SelectItem`),
120
+ * reference pages (`api/appkit/<Kind>.<name>.md`), and hooks documented in guides (`### useAnalyticsQuery`).
121
+ */
122
+ function apiIndex(packageRoot) {
123
+ const docsDir = path.join(packageRoot, "docs");
124
+ const index = /* @__PURE__ */ new Map();
125
+ for (const file of markdownFiles(docsDir)) {
126
+ const rel = path.relative(docsDir, file).split(path.sep).join("/");
127
+ const reference = rel.match(/^api\/appkit\/[A-Za-z]+\.(\w+)\.md$/);
128
+ const kind = reference ? "reference" : /^api\/appkit-ui\/[^/]+\/[^/]+\.md$/.test(rel) ? "component" : "guide";
129
+ const add = (name, line, level) => {
130
+ if (!index.has(name)) index.set(name, {
131
+ kind,
132
+ file,
133
+ line,
134
+ level
135
+ });
136
+ };
137
+ if (reference) {
138
+ add(reference[1], 0, 1);
139
+ continue;
140
+ }
141
+ linesOf(file).forEach((line, i) => {
142
+ const heading = !line.code && line.text.match(/^(#{1,4}) `?([A-Za-z]\w*)`?$/);
143
+ if (!heading) return;
144
+ const [, hashes, name] = heading;
145
+ if (kind === "component" ? !COMPONENT_PAGE_HEADINGS.has(name) : /^use[A-Z]/.test(name)) add(name, i, hashes.length);
146
+ });
147
+ }
148
+ return index;
149
+ }
150
+ const unescapeCell = (cell) => cell.replace(/\\([\\`*_{}[\]()#+\-.!<>|])/g, "$1").replace(/&lt;/g, "<").replace(/&gt;/g, ">").replace(/&#123;/g, "{").replace(/&#125;/g, "}").replace(/`/g, "");
151
+ function tableCells(row) {
152
+ return row.replace(/^\|\s*|\s*\|$/g, "").split(/\s*(?<!\\)\|\s*/).map(unescapeCell);
153
+ }
154
+ /** A description's summary sentence (the TSDoc convention). */
155
+ const firstSentence = (text) => text.replace(/^(.+?\.)\s+[A-Z`(].*$/, "$1");
156
+ /**
157
+ * A doc section as an agent reads it: prose and signatures, one line per prop. Without `details` (several names),
158
+ * no examples and props get their summary sentence. Component pages repeat their description and share notes and
159
+ * props across pages, so on them what has been printed is referred back to instead.
160
+ */
161
+ function condense(lines, kind, owner, details, printed) {
162
+ const out = [];
163
+ let lastText = "";
164
+ let intro = "";
165
+ const push = (text) => {
166
+ out.push(text);
167
+ if (text.trim()) lastText = text;
168
+ };
169
+ const sharedProps = /* @__PURE__ */ new Map();
170
+ let skipLevel = 0;
171
+ let propsTable = false;
172
+ for (const [i, line] of lines.entries()) {
173
+ const { text } = line;
174
+ const heading = headingOf(line);
175
+ if (heading) {
176
+ const level = heading[1].length;
177
+ if (skipLevel && level > skipLevel) continue;
178
+ const title = heading[2];
179
+ const skip = kind === "component" && title === "Usage" || !details && EXAMPLE_HEADINGS.has(title);
180
+ skipLevel = skip ? level : 0;
181
+ if (!skip && !(kind === "component" && title === "Props")) push(text);
182
+ continue;
183
+ }
184
+ if (skipLevel) continue;
185
+ if (line.code) {
186
+ push(text);
187
+ continue;
188
+ }
189
+ if (text.startsWith("|")) {
190
+ if (/^\|[\s:|-]+\|$/.test(text)) continue;
191
+ if (/^\|[\s:|-]+\|$/.test(lines[i + 1]?.text ?? "")) {
192
+ propsTable = /^\|\s*Prop\s*\|/.test(text);
193
+ continue;
194
+ }
195
+ const cells = tableCells(text);
196
+ if (propsTable && cells.length === 5) {
197
+ const [name, type, required, def, desc] = cells;
198
+ const prop = `- ${name}${required ? "" : "?"}: ${type}${def && def !== "-" ? ` = ${def}` : ""}${desc && desc !== "-" ? ` — ${details ? desc : firstSentence(desc)}` : ""}`;
199
+ const earlier = details ? void 0 : printed.get(prop);
200
+ if (earlier) {
201
+ sharedProps.set(earlier, [...sharedProps.get(earlier) ?? [], name]);
202
+ continue;
203
+ }
204
+ printed.set(prop, owner);
205
+ push(prop);
206
+ } else push(`- ${cells.join(" | ")}`);
207
+ continue;
208
+ }
209
+ if (NOT_PROSE.test(text)) continue;
210
+ if (kind === "component" && text.trim()) {
211
+ const earlier = printed.get(text);
212
+ if (earlier && earlier !== owner) {
213
+ const reference = `(as in ${earlier})`;
214
+ if (lastText !== reference) push(reference);
215
+ continue;
216
+ }
217
+ if (text === intro) continue;
218
+ intro ||= text;
219
+ printed.set(text, owner);
220
+ }
221
+ if (text.trim() || out.length && out[out.length - 1].trim()) push(text);
222
+ }
223
+ for (const [earlier, props] of sharedProps) push(`- ${props.join(", ")}: as in ${earlier}`);
224
+ return out.join("\n").trim();
225
+ }
226
+ function sectionLines(entry) {
227
+ const lines = linesOf(entry.file);
228
+ let end = entry.line + 1;
229
+ for (; end < lines.length; end++) {
230
+ const heading = headingOf(lines[end]);
231
+ if (heading && heading[1].length <= entry.level) break;
232
+ }
233
+ return lines.slice(entry.line, end);
234
+ }
235
+ /** Reference pages detail every member; among several names, one gets its declaration and member names. */
236
+ function declarationOnly(lines, name) {
237
+ const end = lines.findIndex((line, i) => i > 0 && headingOf(line)?.[1] === "##");
238
+ const declaration = end < 0 ? lines : lines.slice(0, end);
239
+ const members = lines.flatMap((line) => {
240
+ const heading = headingOf(line);
241
+ return heading?.[1] === "###" ? [heading[2]] : [];
242
+ });
243
+ if (!members.length) return declaration;
244
+ const prose = (text) => ({
245
+ text,
246
+ code: false
247
+ });
248
+ return [
249
+ ...declaration,
250
+ prose(""),
251
+ prose(`Members: ${members.join(", ")} (\`appkit docs ${name}\` for each)`)
252
+ ];
253
+ }
254
+ function firstProseLine(entry) {
255
+ for (const line of sectionLines(entry).slice(1)) {
256
+ if (headingOf(line)) return "";
257
+ if (!line.code && line.text.trim() && !NOT_PROSE.test(line.text)) return line.text.trim();
258
+ }
259
+ return "";
260
+ }
261
+ /** Names close to an unknown one: those sharing a word with it (DateRangePicker: date, range, picker). */
262
+ function similarNames(index, name) {
263
+ const words = name.split(/(?=[A-Z])|[^A-Za-z]/).map((w) => w.toLowerCase()).filter((w) => w.length > 2);
264
+ const hits = (text) => words.filter((w) => text.toLowerCase().includes(w)).length;
265
+ const scores = new Map([...index].map(([candidate, entry]) => [candidate, 2 * hits(candidate) + (entry.kind === "component" ? hits(firstProseLine(entry)) : 0)]));
266
+ return [...scores.keys()].filter((candidate) => (scores.get(candidate) ?? 0) > 0).sort((a, b) => (scores.get(b) ?? 0) - (scores.get(a) ?? 0)).slice(0, 6);
267
+ }
268
+ /**
269
+ * `appkit docs NAME...`: what each name's docs say and whether any was found, or null for a section query. Names
270
+ * come as separate arguments or as one ("BarChart DataTable"); a section name has spaces too, so a single argument
271
+ * that isn't all names and matches a section is a section query. One that matches neither also lists the sections.
272
+ */
273
+ function lookUp(packageRoot, queries, sections) {
274
+ const names = queries.flatMap((q) => q.split(/[\s,]+/)).filter(Boolean);
275
+ if (!names.length) return null;
276
+ const index = apiIndex(packageRoot);
277
+ const single = queries.length === 1;
278
+ const allNames = names.every((name) => index.has(name));
279
+ if (single && !allNames && findSections(sections, queries[0]).length) return null;
280
+ const details = names.length === 1;
281
+ const printed = /* @__PURE__ */ new Map();
282
+ const entries = names.map((name) => {
283
+ const entry = index.get(name);
284
+ if (!entry) {
285
+ const similar = similarNames(index, name);
286
+ return `=== ${name}\nNot documented.${similar.length ? ` Similar: ${similar.join(", ")}` : ""}`;
287
+ }
288
+ const section = sectionLines(entry);
289
+ const lines = entry.kind === "reference" && !details ? declarationOnly(section, name) : section;
290
+ return `=== ${name} (${path.relative(packageRoot, entry.file)})\n${condense(lines, entry.kind, name, details, printed)}`;
291
+ });
292
+ const found = names.some((name) => index.has(name));
293
+ if (single && !found && sections.length) entries.push(`No section matches either. Sections: ${sections.map((s) => s.name).join(", ")}`);
294
+ return {
295
+ text: entries.join("\n\n"),
296
+ found
297
+ };
298
+ }
299
+ function runDocs(queries, options) {
82
300
  const packageRoot = findPackageRoot();
301
+ const [query] = queries;
83
302
  if (query && isFilePath(query)) {
84
303
  readDocFile(packageRoot, query);
85
304
  return;
86
305
  }
87
306
  const content = readLlmsTxt(packageRoot);
307
+ const { header, sections } = parseSections(content);
308
+ const answer = lookUp(packageRoot, queries, sections);
309
+ if (answer) {
310
+ console.log(answer.text);
311
+ if (!answer.found) process.exit(1);
312
+ return;
313
+ }
88
314
  if (options.full) {
89
315
  console.log(content.replaceAll(` ${COLLAPSED_MARKER}`, ""));
90
316
  return;
91
317
  }
92
- const { header, sections } = parseSections(content);
93
- if (query) {
94
- const matched = findSections(sections, query);
95
- if (matched.length === 0) {
96
- const available = sections.map((s) => ` - ${s.name}`).join("\n");
97
- console.error(`No section matching "${query}". Available sections:\n${available}`);
98
- process.exit(1);
99
- }
318
+ const matched = query ? findSections(sections, query) : [];
319
+ if (matched.length) {
100
320
  console.log(matched.map(formatExpandedSection).join("\n"));
101
321
  return;
102
322
  }
103
323
  const output = header + sections.map((s) => s.collapsed ? formatCollapsedSection(s) : formatExpandedSection(s)).join("\n");
104
324
  console.log(output);
105
325
  }
106
- const docsCommand = new Command("docs").description("Display embedded documentation").argument("[query]", "Section name (e.g. 'plugins') or path to a doc file (e.g. './docs.md')").option("--full", "Show complete index including all API reference entries").addHelpText("after", `
326
+ const docsCommand = new Command("docs").description("Display embedded documentation").argument("[query...]", "Section name (e.g. 'plugins'), path to a doc file (e.g. './docs.md'), or API names (e.g. BarChart DataTable sql)").option("--full", "Show complete index including all API reference entries").addHelpText("after", `
107
327
  Examples:
108
328
  $ appkit docs
109
329
  $ appkit docs plugins
110
330
  $ appkit docs "appkit-ui API reference"
111
331
  $ appkit docs ./docs/plugins/analytics.md
332
+ $ appkit docs BarChart DataTable Select useAnalyticsQuery sql
112
333
  $ appkit docs --full`).action(runDocs);
113
334
 
114
335
  //#endregion
@@ -1 +1 @@
1
- {"version":3,"file":"docs.js","names":[],"sources":["../../../src/cli/commands/docs.ts"],"sourcesContent":["import fs from \"node:fs\";\nimport path from \"node:path\";\nimport { fileURLToPath } from \"node:url\";\n\nimport { Command } from \"commander\";\n\nconst __filename = fileURLToPath(import.meta.url);\nconst __dirname = path.dirname(__filename);\n\nconst COLLAPSED_MARKER = \"[collapsed]\";\n\ninterface Section {\n name: string;\n body: string;\n collapsed: boolean;\n}\n\nfunction findPackageRoot(): string {\n let dir = __dirname;\n while (dir !== path.parse(dir).root) {\n if (fs.existsSync(path.join(dir, \"package.json\"))) {\n return dir;\n }\n dir = path.dirname(dir);\n }\n throw new Error(\"Could not find package root\");\n}\n\nfunction parseSections(content: string): {\n header: string;\n sections: Section[];\n} {\n const parts = content.split(/^(## .+)$/m);\n const header = parts[0];\n const sections: Section[] = [];\n\n for (let i = 1; i < parts.length; i += 2) {\n const rawName = parts[i].replace(/^## /, \"\");\n const body = parts[i + 1] ?? \"\";\n const collapsed = rawName.includes(COLLAPSED_MARKER);\n const name = rawName.replace(COLLAPSED_MARKER, \"\").trim();\n sections.push({ name, body, collapsed });\n }\n\n return { header, sections };\n}\n\nfunction countPages(body: string): number {\n return (body.match(/^- \\[/gm) || []).length;\n}\n\nfunction findSections(sections: Section[], query: string): Section[] {\n const q = query.toLowerCase();\n return sections.filter((s) => s.name.toLowerCase().includes(q));\n}\n\nfunction isFilePath(arg: string): boolean {\n return arg.startsWith(\"./\") && arg.endsWith(\".md\");\n}\n\nfunction readLlmsTxt(packageRoot: string): string {\n const llmsPath = path.join(packageRoot, \"llms.txt\");\n if (!fs.existsSync(llmsPath)) {\n console.error(\"Error: llms.txt not found in package\");\n process.exit(1);\n }\n return fs.readFileSync(llmsPath, \"utf-8\");\n}\n\nfunction readDocFile(packageRoot: string, docPath: string): void {\n let normalizedPath = docPath;\n normalizedPath = normalizedPath.replace(/^\\.\\//, \"\");\n normalizedPath = normalizedPath.replace(/^\\//, \"\");\n normalizedPath = normalizedPath.replace(/^appkit\\//, \"\");\n\n const fullPath = path.join(packageRoot, normalizedPath);\n\n if (!fs.existsSync(fullPath)) {\n console.error(`Error: Documentation file not found: ${docPath}`);\n console.error(`Tried: ${fullPath}`);\n process.exit(1);\n }\n\n console.log(fs.readFileSync(fullPath, \"utf-8\"));\n}\n\nfunction formatCollapsedSection(section: Section): string {\n const pages = countPages(section.body);\n return [\n `## ${section.name} (${pages} pages)`,\n \"\",\n `> Use \\`appkit docs \"${section.name}\"\\` to expand, or \\`appkit docs --full\\` to expand all sections.`,\n \"\",\n ].join(\"\\n\");\n}\n\nfunction formatExpandedSection(section: Section): string {\n return `## ${section.name}${section.body}`;\n}\n\nfunction runDocs(query: string | undefined, options: { full?: boolean }) {\n const packageRoot = findPackageRoot();\n\n if (query && isFilePath(query)) {\n readDocFile(packageRoot, query);\n return;\n }\n\n const content = readLlmsTxt(packageRoot);\n\n if (options.full) {\n console.log(content.replaceAll(` ${COLLAPSED_MARKER}`, \"\"));\n return;\n }\n\n const { header, sections } = parseSections(content);\n\n if (query) {\n const matched = findSections(sections, query);\n if (matched.length === 0) {\n const available = sections.map((s) => ` - ${s.name}`).join(\"\\n\");\n console.error(\n `No section matching \"${query}\". Available sections:\\n${available}`,\n );\n process.exit(1);\n }\n console.log(matched.map(formatExpandedSection).join(\"\\n\"));\n return;\n }\n\n const output =\n header +\n sections\n .map((s) =>\n s.collapsed ? formatCollapsedSection(s) : formatExpandedSection(s),\n )\n .join(\"\\n\");\n console.log(output);\n}\n\nexport const docsCommand = new Command(\"docs\")\n .description(\"Display embedded documentation\")\n .argument(\n \"[query]\",\n \"Section name (e.g. 'plugins') or path to a doc file (e.g. './docs.md')\",\n )\n .option(\"--full\", \"Show complete index including all API reference entries\")\n .addHelpText(\n \"after\",\n `\nExamples:\n $ appkit docs\n $ appkit docs plugins\n $ appkit docs \"appkit-ui API reference\"\n $ appkit docs ./docs/plugins/analytics.md\n $ appkit docs --full`,\n )\n .action(runDocs);\n"],"mappings":"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"}
1
+ {"version":3,"file":"docs.js","names":[],"sources":["../../../src/cli/commands/docs.ts"],"sourcesContent":["import fs from \"node:fs\";\nimport path from \"node:path\";\nimport { fileURLToPath } from \"node:url\";\n\nimport { Command } from \"commander\";\n\nconst __filename = fileURLToPath(import.meta.url);\nconst __dirname = path.dirname(__filename);\n\nconst COLLAPSED_MARKER = \"[collapsed]\";\n\nexport interface Section {\n name: string;\n body: string;\n collapsed: boolean;\n}\n\nfunction findPackageRoot(): string {\n let dir = __dirname;\n while (dir !== path.parse(dir).root) {\n if (fs.existsSync(path.join(dir, \"package.json\"))) {\n return dir;\n }\n dir = path.dirname(dir);\n }\n throw new Error(\"Could not find package root\");\n}\n\nfunction parseSections(content: string): {\n header: string;\n sections: Section[];\n} {\n const parts = content.split(/^(## .+)$/m);\n const header = parts[0];\n const sections: Section[] = [];\n\n for (let i = 1; i < parts.length; i += 2) {\n const rawName = parts[i].replace(/^## /, \"\");\n const body = parts[i + 1] ?? \"\";\n const collapsed = rawName.includes(COLLAPSED_MARKER);\n const name = rawName.replace(COLLAPSED_MARKER, \"\").trim();\n sections.push({ name, body, collapsed });\n }\n\n return { header, sections };\n}\n\nfunction countPages(body: string): number {\n return (body.match(/^- \\[/gm) || []).length;\n}\n\nfunction findSections(sections: Section[], query: string): Section[] {\n const q = query.toLowerCase();\n return sections.filter((s) => s.name.toLowerCase().includes(q));\n}\n\nfunction isFilePath(arg: string): boolean {\n return arg.startsWith(\"./\") && arg.endsWith(\".md\");\n}\n\nfunction readLlmsTxt(packageRoot: string): string {\n const llmsPath = path.join(packageRoot, \"llms.txt\");\n if (!fs.existsSync(llmsPath)) {\n console.error(\"Error: llms.txt not found in package\");\n process.exit(1);\n }\n return fs.readFileSync(llmsPath, \"utf-8\");\n}\n\nfunction readDocFile(packageRoot: string, docPath: string): void {\n let normalizedPath = docPath;\n normalizedPath = normalizedPath.replace(/^\\.\\//, \"\");\n normalizedPath = normalizedPath.replace(/^\\//, \"\");\n normalizedPath = normalizedPath.replace(/^appkit\\//, \"\");\n\n const fullPath = path.join(packageRoot, normalizedPath);\n\n if (!fs.existsSync(fullPath)) {\n console.error(`Error: Documentation file not found: ${docPath}`);\n console.error(`Tried: ${fullPath}`);\n process.exit(1);\n }\n\n console.log(fs.readFileSync(fullPath, \"utf-8\"));\n}\n\nfunction formatCollapsedSection(section: Section): string {\n const pages = countPages(section.body);\n return [\n `## ${section.name} (${pages} pages)`,\n \"\",\n `> Use \\`appkit docs \"${section.name}\"\\` to expand, or \\`appkit docs --full\\` to expand all sections.`,\n \"\",\n ].join(\"\\n\");\n}\n\nfunction formatExpandedSection(section: Section): string {\n return `## ${section.name}${section.body}`;\n}\n\ntype PageKind = \"component\" | \"reference\" | \"guide\";\n\ninterface ApiEntry {\n kind: PageKind;\n file: string;\n line: number;\n level: number;\n}\n\ntype Printed = Map<string, string>;\n\n// Component pages (tools/generate-component-mdx.ts) put each component's sections under Example, Usage and Props\n// headings; TypeDoc's reference pages put theirs under Examples.\nconst EXAMPLE_HEADINGS = new Set([\"Example\", \"Examples\"]);\nconst COMPONENT_PAGE_HEADINGS = new Set([\n ...EXAMPLE_HEADINGS,\n \"Usage\",\n \"Props\",\n]);\n// Code fences, table rows, comments and the generator's source link.\nconst NOT_PROSE = /^(```|\\||<!--|\\*\\*Source:\\*\\*)/;\n\n/** The exported docs carry each heading's anchor link (`## Props[​](#props \"Direct link to Props\")`). */\nfunction cleanLine(line: string): string {\n return line.replace(/\\[\\u200b\\]\\(#[^\\s)]*(?: \"[^\"]*\")?\\)/g, \"\").trimEnd();\n}\n\n/** A doc line, and whether it is code (a fence or inside one), where `#` starts no heading. */\ninterface Line {\n text: string;\n code: boolean;\n}\n\nconst linesByFile = new Map<string, Line[]>();\nfunction linesOf(file: string): Line[] {\n let lines = linesByFile.get(file);\n if (!lines) {\n let inCode = false;\n lines = fs\n .readFileSync(file, \"utf-8\")\n .split(\"\\n\")\n .map((raw) => {\n const fence = raw.startsWith(\"```\");\n if (fence) inCode = !inCode;\n return { text: cleanLine(raw), code: fence || inCode };\n });\n linesByFile.set(file, lines);\n }\n return lines;\n}\n\nconst headingOf = (line: Line) =>\n line.code ? null : line.text.match(/^(#+) (.*)$/);\n\nfunction markdownFiles(dir: string): string[] {\n if (!fs.existsSync(dir)) return [];\n return fs\n .readdirSync(dir, { withFileTypes: true })\n .sort((a, b) => a.name.localeCompare(b.name))\n .flatMap((entry) => {\n const file = path.join(dir, entry.name);\n if (entry.isDirectory()) return markdownFiles(file);\n return entry.name.endsWith(\".md\") ? [file] : [];\n });\n}\n\n/**\n * Every documented name: component pages and their parts (`api/appkit-ui/<group>/<Name>.md`, `## SelectItem`),\n * reference pages (`api/appkit/<Kind>.<name>.md`), and hooks documented in guides (`### useAnalyticsQuery`).\n */\nfunction apiIndex(packageRoot: string): Map<string, ApiEntry> {\n const docsDir = path.join(packageRoot, \"docs\");\n const index = new Map<string, ApiEntry>();\n for (const file of markdownFiles(docsDir)) {\n const rel = path.relative(docsDir, file).split(path.sep).join(\"/\");\n const reference = rel.match(/^api\\/appkit\\/[A-Za-z]+\\.(\\w+)\\.md$/);\n const kind: PageKind = reference\n ? \"reference\"\n : /^api\\/appkit-ui\\/[^/]+\\/[^/]+\\.md$/.test(rel)\n ? \"component\"\n : \"guide\";\n const add = (name: string, line: number, level: number) => {\n if (!index.has(name)) index.set(name, { kind, file, line, level });\n };\n if (reference) {\n add(reference[1], 0, 1);\n continue;\n }\n linesOf(file).forEach((line, i) => {\n const heading =\n !line.code && line.text.match(/^(#{1,4}) `?([A-Za-z]\\w*)`?$/);\n if (!heading) return;\n const [, hashes, name] = heading;\n const isApi =\n kind === \"component\"\n ? !COMPONENT_PAGE_HEADINGS.has(name)\n : /^use[A-Z]/.test(name);\n if (isApi) add(name, i, hashes.length);\n });\n }\n return index;\n}\n\nconst unescapeCell = (cell: string) =>\n cell\n .replace(/\\\\([\\\\`*_{}[\\]()#+\\-.!<>|])/g, \"$1\")\n .replace(/&lt;/g, \"<\")\n .replace(/&gt;/g, \">\")\n .replace(/&#123;/g, \"{\")\n .replace(/&#125;/g, \"}\")\n .replace(/`/g, \"\");\n\n// The props table buildPropsSection (tools/generate-component-mdx.ts) writes: Prop | Type | Required (✓) | Default\n// (- for none) | Description, with its escapes undone.\nfunction tableCells(row: string): string[] {\n return row\n .replace(/^\\|\\s*|\\s*\\|$/g, \"\")\n .split(/\\s*(?<!\\\\)\\|\\s*/)\n .map(unescapeCell);\n}\n\n/** A description's summary sentence (the TSDoc convention). */\nconst firstSentence = (text: string) =>\n text.replace(/^(.+?\\.)\\s+[A-Z`(].*$/, \"$1\");\n\n/**\n * A doc section as an agent reads it: prose and signatures, one line per prop. Without `details` (several names),\n * no examples and props get their summary sentence. Component pages repeat their description and share notes and\n * props across pages, so on them what has been printed is referred back to instead.\n */\nfunction condense(\n lines: Line[],\n kind: PageKind,\n owner: string,\n details: boolean,\n printed: Printed,\n): string {\n const out: string[] = [];\n let lastText = \"\";\n let intro = \"\";\n const push = (text: string) => {\n out.push(text);\n if (text.trim()) lastText = text;\n };\n const sharedProps = new Map<string, string[]>();\n let skipLevel = 0;\n let propsTable = false;\n for (const [i, line] of lines.entries()) {\n const { text } = line;\n const heading = headingOf(line);\n if (heading) {\n const level = heading[1].length;\n if (skipLevel && level > skipLevel) continue;\n const title = heading[2];\n const skip =\n (kind === \"component\" && title === \"Usage\") ||\n (!details && EXAMPLE_HEADINGS.has(title));\n skipLevel = skip ? level : 0;\n if (!skip && !(kind === \"component\" && title === \"Props\")) push(text);\n continue;\n }\n if (skipLevel) continue;\n if (line.code) {\n push(text);\n continue;\n }\n if (text.startsWith(\"|\")) {\n if (/^\\|[\\s:|-]+\\|$/.test(text)) continue;\n if (/^\\|[\\s:|-]+\\|$/.test(lines[i + 1]?.text ?? \"\")) {\n propsTable = /^\\|\\s*Prop\\s*\\|/.test(text);\n continue;\n }\n const cells = tableCells(text);\n if (propsTable && cells.length === 5) {\n const [name, type, required, def, desc] = cells;\n const optional = required ? \"\" : \"?\";\n const value = def && def !== \"-\" ? ` = ${def}` : \"\";\n const note =\n desc && desc !== \"-\"\n ? ` — ${details ? desc : firstSentence(desc)}`\n : \"\";\n const prop = `- ${name}${optional}: ${type}${value}${note}`;\n const earlier = details ? undefined : printed.get(prop);\n if (earlier) {\n sharedProps.set(earlier, [...(sharedProps.get(earlier) ?? []), name]);\n continue;\n }\n printed.set(prop, owner);\n push(prop);\n } else {\n push(`- ${cells.join(\" | \")}`);\n }\n continue;\n }\n if (NOT_PROSE.test(text)) continue;\n if (kind === \"component\" && text.trim()) {\n // The generator repeats a page's intro in its component's section; other names' text is referred back to.\n const earlier = printed.get(text);\n if (earlier && earlier !== owner) {\n const reference = `(as in ${earlier})`;\n if (lastText !== reference) push(reference);\n continue;\n }\n if (text === intro) continue;\n intro ||= text;\n printed.set(text, owner);\n }\n if (text.trim() || (out.length && out[out.length - 1].trim())) push(text);\n }\n for (const [earlier, props] of sharedProps) {\n push(`- ${props.join(\", \")}: as in ${earlier}`);\n }\n return out.join(\"\\n\").trim();\n}\n\nfunction sectionLines(entry: ApiEntry): Line[] {\n const lines = linesOf(entry.file);\n let end = entry.line + 1;\n for (; end < lines.length; end++) {\n const heading = headingOf(lines[end]);\n if (heading && heading[1].length <= entry.level) break;\n }\n return lines.slice(entry.line, end);\n}\n\n/** Reference pages detail every member; among several names, one gets its declaration and member names. */\nfunction declarationOnly(lines: Line[], name: string): Line[] {\n const end = lines.findIndex(\n (line, i) => i > 0 && headingOf(line)?.[1] === \"##\",\n );\n const declaration = end < 0 ? lines : lines.slice(0, end);\n const members = lines.flatMap((line) => {\n const heading = headingOf(line);\n return heading?.[1] === \"###\" ? [heading[2]] : [];\n });\n if (!members.length) return declaration;\n const prose = (text: string) => ({ text, code: false });\n return [\n ...declaration,\n prose(\"\"),\n prose(`Members: ${members.join(\", \")} (\\`appkit docs ${name}\\` for each)`),\n ];\n}\n\nfunction firstProseLine(entry: ApiEntry): string {\n for (const line of sectionLines(entry).slice(1)) {\n if (headingOf(line)) return \"\";\n if (!line.code && line.text.trim() && !NOT_PROSE.test(line.text)) {\n return line.text.trim();\n }\n }\n return \"\";\n}\n\n/** Names close to an unknown one: those sharing a word with it (DateRangePicker: date, range, picker). */\nfunction similarNames(index: Map<string, ApiEntry>, name: string): string[] {\n const words = name\n .split(/(?=[A-Z])|[^A-Za-z]/)\n .map((w) => w.toLowerCase())\n .filter((w) => w.length > 2);\n const hits = (text: string) =>\n words.filter((w) => text.toLowerCase().includes(w)).length;\n // A component's description names what it does (\"Date picker component\" for Calendar); reference pages'\n // descriptions are too generic to match on.\n const scores = new Map(\n [...index].map(([candidate, entry]) => [\n candidate,\n 2 * hits(candidate) +\n (entry.kind === \"component\" ? hits(firstProseLine(entry)) : 0),\n ]),\n );\n return [...scores.keys()]\n .filter((candidate) => (scores.get(candidate) ?? 0) > 0)\n .sort((a, b) => (scores.get(b) ?? 0) - (scores.get(a) ?? 0))\n .slice(0, 6);\n}\n\n/**\n * `appkit docs NAME...`: what each name's docs say and whether any was found, or null for a section query. Names\n * come as separate arguments or as one (\"BarChart DataTable\"); a section name has spaces too, so a single argument\n * that isn't all names and matches a section is a section query. One that matches neither also lists the sections.\n */\nexport function lookUp(\n packageRoot: string,\n queries: string[],\n sections: Section[],\n): { text: string; found: boolean } | null {\n const names = queries.flatMap((q) => q.split(/[\\s,]+/)).filter(Boolean);\n if (!names.length) return null;\n const index = apiIndex(packageRoot);\n const single = queries.length === 1;\n const allNames = names.every((name) => index.has(name));\n if (single && !allNames && findSections(sections, queries[0]).length) {\n return null;\n }\n\n const details = names.length === 1;\n const printed: Printed = new Map();\n const entries = names.map((name) => {\n const entry = index.get(name);\n if (!entry) {\n const similar = similarNames(index, name);\n return `=== ${name}\\nNot documented.${similar.length ? ` Similar: ${similar.join(\", \")}` : \"\"}`;\n }\n const section = sectionLines(entry);\n const lines =\n entry.kind === \"reference\" && !details\n ? declarationOnly(section, name)\n : section;\n const where = path.relative(packageRoot, entry.file);\n return `=== ${name} (${where})\\n${condense(lines, entry.kind, name, details, printed)}`;\n });\n const found = names.some((name) => index.has(name));\n if (single && !found && sections.length) {\n entries.push(\n `No section matches either. Sections: ${sections.map((s) => s.name).join(\", \")}`,\n );\n }\n return { text: entries.join(\"\\n\\n\"), found };\n}\n\nfunction runDocs(queries: string[], options: { full?: boolean }) {\n const packageRoot = findPackageRoot();\n const [query] = queries;\n\n if (query && isFilePath(query)) {\n readDocFile(packageRoot, query);\n return;\n }\n\n const content = readLlmsTxt(packageRoot);\n const { header, sections } = parseSections(content);\n\n const answer = lookUp(packageRoot, queries, sections);\n if (answer) {\n console.log(answer.text);\n if (!answer.found) process.exit(1);\n return;\n }\n\n if (options.full) {\n console.log(content.replaceAll(` ${COLLAPSED_MARKER}`, \"\"));\n return;\n }\n\n const matched = query ? findSections(sections, query) : [];\n if (matched.length) {\n console.log(matched.map(formatExpandedSection).join(\"\\n\"));\n return;\n }\n\n const output =\n header +\n sections\n .map((s) =>\n s.collapsed ? formatCollapsedSection(s) : formatExpandedSection(s),\n )\n .join(\"\\n\");\n console.log(output);\n}\n\nexport const docsCommand = new Command(\"docs\")\n .description(\"Display embedded documentation\")\n .argument(\n \"[query...]\",\n \"Section name (e.g. 'plugins'), path to a doc file (e.g. './docs.md'), or API names (e.g. BarChart DataTable sql)\",\n )\n .option(\"--full\", \"Show complete index including all API reference entries\")\n .addHelpText(\n \"after\",\n `\nExamples:\n $ appkit docs\n $ appkit docs plugins\n $ appkit docs \"appkit-ui API reference\"\n $ appkit docs ./docs/plugins/analytics.md\n $ appkit docs BarChart DataTable Select useAnalyticsQuery sql\n $ appkit docs --full`,\n )\n .action(runDocs);\n"],"mappings":"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"}