@thedatagrid/docs-kit 0.0.0-stage → 0.2.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 (184) hide show
  1. package/CHANGELOG.md +20 -0
  2. package/README.md +224 -2
  3. package/dist/code/demoFiles.d.ts +14 -0
  4. package/dist/code/demoFiles.d.ts.map +1 -0
  5. package/dist/code/demoFiles.js +46 -0
  6. package/dist/code/demoFiles.js.map +1 -0
  7. package/dist/code/heights.d.ts +17 -0
  8. package/dist/code/heights.d.ts.map +1 -0
  9. package/dist/code/heights.js +40 -0
  10. package/dist/code/heights.js.map +1 -0
  11. package/dist/code/highlightSpec.d.ts +34 -0
  12. package/dist/code/highlightSpec.d.ts.map +1 -0
  13. package/dist/code/highlightSpec.js +119 -0
  14. package/dist/code/highlightSpec.js.map +1 -0
  15. package/dist/code/imports.d.ts +5 -0
  16. package/dist/code/imports.d.ts.map +1 -0
  17. package/dist/code/imports.js +17 -0
  18. package/dist/code/imports.js.map +1 -0
  19. package/dist/code/index.d.ts +8 -0
  20. package/dist/code/index.d.ts.map +1 -0
  21. package/dist/code/index.js +8 -0
  22. package/dist/code/index.js.map +1 -0
  23. package/dist/code/lineRanges.d.ts +5 -0
  24. package/dist/code/lineRanges.d.ts.map +1 -0
  25. package/dist/code/lineRanges.js +35 -0
  26. package/dist/code/lineRanges.js.map +1 -0
  27. package/dist/code/regions.d.ts +53 -0
  28. package/dist/code/regions.d.ts.map +1 -0
  29. package/dist/code/regions.js +237 -0
  30. package/dist/code/regions.js.map +1 -0
  31. package/dist/code/shiki.d.ts +58 -0
  32. package/dist/code/shiki.d.ts.map +1 -0
  33. package/dist/code/shiki.js +244 -0
  34. package/dist/code/shiki.js.map +1 -0
  35. package/dist/demos/build.d.ts +17 -0
  36. package/dist/demos/build.d.ts.map +1 -0
  37. package/dist/demos/build.js +426 -0
  38. package/dist/demos/build.js.map +1 -0
  39. package/dist/demos/cli.d.ts +3 -0
  40. package/dist/demos/cli.d.ts.map +1 -0
  41. package/dist/demos/cli.js +102 -0
  42. package/dist/demos/cli.js.map +1 -0
  43. package/dist/demos/client.d.ts +27 -0
  44. package/dist/demos/client.d.ts.map +1 -0
  45. package/dist/demos/client.js +61 -0
  46. package/dist/demos/client.js.map +1 -0
  47. package/dist/demos/compile/core.d.ts +64 -0
  48. package/dist/demos/compile/core.d.ts.map +1 -0
  49. package/dist/demos/compile/core.js +174 -0
  50. package/dist/demos/compile/core.js.map +1 -0
  51. package/dist/demos/config.d.ts +108 -0
  52. package/dist/demos/config.d.ts.map +1 -0
  53. package/dist/demos/config.js +4 -0
  54. package/dist/demos/config.js.map +1 -0
  55. package/dist/demos/devEvents.d.ts +13 -0
  56. package/dist/demos/devEvents.d.ts.map +1 -0
  57. package/dist/demos/devEvents.js +45 -0
  58. package/dist/demos/devEvents.js.map +1 -0
  59. package/dist/demos/html.d.ts +21 -0
  60. package/dist/demos/html.d.ts.map +1 -0
  61. package/dist/demos/html.js +57 -0
  62. package/dist/demos/html.js.map +1 -0
  63. package/dist/demos/index.d.ts +8 -0
  64. package/dist/demos/index.d.ts.map +1 -0
  65. package/dist/demos/index.js +6 -0
  66. package/dist/demos/index.js.map +1 -0
  67. package/dist/demos/pages.d.ts +15 -0
  68. package/dist/demos/pages.d.ts.map +1 -0
  69. package/dist/demos/pages.js +71 -0
  70. package/dist/demos/pages.js.map +1 -0
  71. package/dist/demos/runtime/iframe.d.ts +50 -0
  72. package/dist/demos/runtime/iframe.d.ts.map +1 -0
  73. package/dist/demos/runtime/iframe.js +245 -0
  74. package/dist/demos/runtime/iframe.js.map +1 -0
  75. package/dist/demos/runtime/react.d.ts +3 -0
  76. package/dist/demos/runtime/react.d.ts.map +1 -0
  77. package/dist/demos/runtime/react.js +17 -0
  78. package/dist/demos/runtime/react.js.map +1 -0
  79. package/dist/demos/slug.d.ts +3 -0
  80. package/dist/demos/slug.d.ts.map +1 -0
  81. package/dist/demos/slug.js +11 -0
  82. package/dist/demos/slug.js.map +1 -0
  83. package/dist/demos/vendor.d.ts +32 -0
  84. package/dist/demos/vendor.d.ts.map +1 -0
  85. package/dist/demos/vendor.js +127 -0
  86. package/dist/demos/vendor.js.map +1 -0
  87. package/dist/demos/worker/compile.worker.d.ts +2 -0
  88. package/dist/demos/worker/compile.worker.d.ts.map +1 -0
  89. package/dist/demos/worker/compile.worker.js +27 -0
  90. package/dist/demos/worker/compile.worker.js.map +1 -0
  91. package/dist/editor/install.d.ts +15 -0
  92. package/dist/editor/install.d.ts.map +1 -0
  93. package/dist/editor/install.js +71 -0
  94. package/dist/editor/install.js.map +1 -0
  95. package/dist/fork/codesandbox.d.ts +39 -0
  96. package/dist/fork/codesandbox.d.ts.map +1 -0
  97. package/dist/fork/codesandbox.js +156 -0
  98. package/dist/fork/codesandbox.js.map +1 -0
  99. package/dist/fork/index.d.ts +2 -0
  100. package/dist/fork/index.d.ts.map +1 -0
  101. package/dist/fork/index.js +2 -0
  102. package/dist/fork/index.js.map +1 -0
  103. package/dist/react/Demo.d.ts +80 -0
  104. package/dist/react/Demo.d.ts.map +1 -0
  105. package/dist/react/Demo.js +156 -0
  106. package/dist/react/Demo.js.map +1 -0
  107. package/dist/react/DemoIframe.d.ts +22 -0
  108. package/dist/react/DemoIframe.d.ts.map +1 -0
  109. package/dist/react/DemoIframe.js +123 -0
  110. package/dist/react/DemoIframe.js.map +1 -0
  111. package/dist/react/DemoShell.d.ts +47 -0
  112. package/dist/react/DemoShell.d.ts.map +1 -0
  113. package/dist/react/DemoShell.js +341 -0
  114. package/dist/react/DemoShell.js.map +1 -0
  115. package/dist/react/devEvents.d.ts +17 -0
  116. package/dist/react/devEvents.d.ts.map +1 -0
  117. package/dist/react/devEvents.js +30 -0
  118. package/dist/react/devEvents.js.map +1 -0
  119. package/dist/react/editor.d.ts +17 -0
  120. package/dist/react/editor.d.ts.map +1 -0
  121. package/dist/react/editor.js +158 -0
  122. package/dist/react/editor.js.map +1 -0
  123. package/dist/react/fork.d.ts +10 -0
  124. package/dist/react/fork.d.ts.map +1 -0
  125. package/dist/react/fork.js +30 -0
  126. package/dist/react/fork.js.map +1 -0
  127. package/dist/react/index.d.ts +4 -0
  128. package/dist/react/index.d.ts.map +1 -0
  129. package/dist/react/index.js +4 -0
  130. package/dist/react/index.js.map +1 -0
  131. package/dist/react/styles.css +471 -0
  132. package/dist/remark/index.d.ts +3 -0
  133. package/dist/remark/index.d.ts.map +1 -0
  134. package/dist/remark/index.js +3 -0
  135. package/dist/remark/index.js.map +1 -0
  136. package/dist/remark/meta.d.ts +7 -0
  137. package/dist/remark/meta.d.ts.map +1 -0
  138. package/dist/remark/meta.js +20 -0
  139. package/dist/remark/meta.js.map +1 -0
  140. package/dist/remark/remarkDemoFences.d.ts +77 -0
  141. package/dist/remark/remarkDemoFences.d.ts.map +1 -0
  142. package/dist/remark/remarkDemoFences.js +259 -0
  143. package/dist/remark/remarkDemoFences.js.map +1 -0
  144. package/editor-extension/README.md +23 -0
  145. package/editor-extension/extension.js +40 -0
  146. package/editor-extension/links.js +137 -0
  147. package/editor-extension/package.json +19 -0
  148. package/package.json +107 -4
  149. package/src/code/demoFiles.ts +54 -0
  150. package/src/code/heights.ts +47 -0
  151. package/src/code/highlightSpec.ts +139 -0
  152. package/src/code/imports.ts +18 -0
  153. package/src/code/index.ts +46 -0
  154. package/src/code/lineRanges.ts +31 -0
  155. package/src/code/regions.ts +270 -0
  156. package/src/code/shiki.ts +271 -0
  157. package/src/demos/build.ts +477 -0
  158. package/src/demos/cli.ts +97 -0
  159. package/src/demos/client.ts +82 -0
  160. package/src/demos/compile/core.ts +228 -0
  161. package/src/demos/config.ts +106 -0
  162. package/src/demos/devEvents.ts +45 -0
  163. package/src/demos/html.ts +74 -0
  164. package/src/demos/index.ts +25 -0
  165. package/src/demos/pages.ts +79 -0
  166. package/src/demos/runtime/iframe.ts +262 -0
  167. package/src/demos/runtime/react.ts +19 -0
  168. package/src/demos/slug.ts +10 -0
  169. package/src/demos/vendor.ts +142 -0
  170. package/src/demos/worker/compile.worker.ts +35 -0
  171. package/src/editor/install.ts +85 -0
  172. package/src/fork/codesandbox.ts +189 -0
  173. package/src/fork/index.ts +10 -0
  174. package/src/react/Demo.tsx +250 -0
  175. package/src/react/DemoIframe.tsx +165 -0
  176. package/src/react/DemoShell.tsx +592 -0
  177. package/src/react/devEvents.ts +34 -0
  178. package/src/react/editor.ts +178 -0
  179. package/src/react/fork.ts +31 -0
  180. package/src/react/index.ts +10 -0
  181. package/src/react/styles.css +471 -0
  182. package/src/remark/index.ts +2 -0
  183. package/src/remark/meta.ts +20 -0
  184. package/src/remark/remarkDemoFences.ts +330 -0
@@ -0,0 +1,15 @@
1
+ export declare function findFiles(dir: string, suffix: string): string[];
2
+ export declare function defaultRouteForPage(pagePath: string): string;
3
+ /**
4
+ * Maps demo ids to the docs page (and card anchor) that shows them, so a demo
5
+ * opened on its own can link back. The anchor matches the `<Demo>` card's
6
+ * slug: `<DemoTitle>` > `<Demo title>` > the fence's `title` > `<name>.demo.tsx`.
7
+ */
8
+ export declare function findDocsLinks(options: {
9
+ contentDir: string;
10
+ pageExtension: string;
11
+ demoSuffix: string;
12
+ routeForPage: (pagePath: string) => string;
13
+ anchorPrefix?: string;
14
+ }): Map<string, string>;
15
+ //# sourceMappingURL=pages.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"pages.d.ts","sourceRoot":"","sources":["../../src/demos/pages.ts"],"names":[],"mappings":"AAgBA,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAE/D;AAID,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAG5D;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE;IACrC,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,MAAM,CAAC;IAC3C,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAwCtB"}
@@ -0,0 +1,71 @@
1
+ import fs from 'node:fs';
2
+ import path from 'node:path';
3
+ import { slugifyDemoTitle } from "./slug.js";
4
+ function walk(dir, accept, out = []) {
5
+ if (!fs.existsSync(dir))
6
+ return out;
7
+ for (const entry of fs.readdirSync(dir, { withFileTypes: true })) {
8
+ if (entry.name === 'node_modules' || entry.name.startsWith('.'))
9
+ continue;
10
+ const full = path.join(dir, entry.name);
11
+ if (entry.isDirectory())
12
+ walk(full, accept, out);
13
+ else if (accept(entry.name))
14
+ out.push(full);
15
+ }
16
+ return out;
17
+ }
18
+ export function findFiles(dir, suffix) {
19
+ return walk(dir, (name) => name.endsWith(suffix)).sort();
20
+ }
21
+ const toPosix = (p) => p.split(path.sep).join('/');
22
+ export function defaultRouteForPage(pagePath) {
23
+ const route = `/${pagePath}`.replace(/\/index$/, '');
24
+ return route || '/';
25
+ }
26
+ /**
27
+ * Maps demo ids to the docs page (and card anchor) that shows them, so a demo
28
+ * opened on its own can link back. The anchor matches the `<Demo>` card's
29
+ * slug: `<DemoTitle>` > `<Demo title>` > the fence's `title` > `<name>.demo.tsx`.
30
+ */
31
+ export function findDocsLinks(options) {
32
+ const { contentDir, pageExtension, demoSuffix, routeForPage, anchorPrefix = '' } = options;
33
+ const links = new Map();
34
+ const fenceRe = /^```[^\n]*$/gm;
35
+ for (const pageFile of findFiles(contentDir, pageExtension)) {
36
+ const text = fs.readFileSync(pageFile, 'utf8');
37
+ const pageDir = path.dirname(pageFile);
38
+ const pagePath = toPosix(path.relative(contentDir, pageFile)).slice(0, -pageExtension.length);
39
+ for (const match of text.matchAll(fenceRe)) {
40
+ const info = match[0];
41
+ const file = /\bfile=(?:"([^"]+)"|'([^']+)')/.exec(info);
42
+ const fileName = file?.[1] ?? file?.[2];
43
+ if (!fileName || !fileName.endsWith(demoSuffix) || !/\blive\b/.test(info))
44
+ continue;
45
+ const absPath = fileName.startsWith('/') ? path.join(contentDir, fileName) : path.resolve(pageDir, fileName);
46
+ const demoId = toPosix(path.relative(contentDir, absPath)).slice(0, -demoSuffix.length);
47
+ if (links.has(demoId))
48
+ continue;
49
+ // the enclosing <Demo> … </Demo>, if any
50
+ const before = text.slice(0, match.index);
51
+ // the last `<Demo` tag itself, not `<DemoTitle>` / `<DemoDescription>`
52
+ const open = Math.max(-1, ...[...before.matchAll(/<Demo(?=[\s>])/g)].map((m) => m.index));
53
+ const close = before.lastIndexOf('</Demo>');
54
+ let title = null;
55
+ if (open > close) {
56
+ const end = text.indexOf('</Demo>', match.index);
57
+ const block = text.slice(open, end === -1 ? undefined : end);
58
+ const demoTitle = /<DemoTitle>\s*([\s\S]*?)\s*<\/DemoTitle>/.exec(block);
59
+ const titleAttr = /^<Demo\b[^>]*\btitle=(?:"([^"]*)"|'([^']*)')/.exec(block);
60
+ title = demoTitle?.[1].replace(/<[^>]+>/g, '').trim() || titleAttr?.[1] || titleAttr?.[2] || null;
61
+ }
62
+ if (!title) {
63
+ const fenceTitle = /\btitle=(?:"([^"]*)"|'([^']*)')/.exec(info);
64
+ title = fenceTitle?.[1] ?? fenceTitle?.[2] ?? `${path.basename(fileName)}`;
65
+ }
66
+ links.set(demoId, `${routeForPage(pagePath)}#${anchorPrefix}${slugifyDemoTitle(title)}`);
67
+ }
68
+ }
69
+ return links;
70
+ }
71
+ //# sourceMappingURL=pages.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"pages.js","sourceRoot":"","sources":["../../src/demos/pages.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,50 @@
1
+ /**
2
+ * Runs inside every demo iframe (bundled by the builder together with the
3
+ * framework adapter and the site's bootstrap module).
4
+ *
5
+ * Parent → iframe messages:
6
+ * { type: 'set-theme', theme } docs light/dark changed
7
+ * { type: 'demo-reset' } unmount + clear persisted keys
8
+ * { type: 'demo-update', js, css } run an edited build in place
9
+ * { type: 'demo-compile-error', message } show compile errors
10
+ * Iframe → parent:
11
+ * demo-ready, demo-error { message }, demo-escape, demo-reset-done
12
+ */
13
+ export type DocsTheme = 'light' | 'dark';
14
+ export type MountedDemo = {
15
+ unmount(): void;
16
+ };
17
+ /** Framework glue: renders a demo module's default export into an element. */
18
+ export type DemoAdapter = {
19
+ render(target: HTMLElement, component: unknown, onError: (error: unknown) => void): MountedDemo;
20
+ };
21
+ /** The site's bootstrap module (`bootstrap` in docs-kit.config). All hooks are optional. */
22
+ export type SiteBootstrap = {
23
+ /** Called once, before the first mount. */
24
+ setup?(context: {
25
+ theme: DocsTheme;
26
+ }): void | Promise<void>;
27
+ /** Called on load and whenever the docs theme changes. */
28
+ applyTheme?(theme: DocsTheme): void;
29
+ };
30
+ export type RuntimeOptions = {
31
+ adapter: DemoAdapter;
32
+ site: SiteBootstrap;
33
+ /** localStorage key the docs site keeps its theme under. */
34
+ themeStorageKey?: string;
35
+ defaultTheme?: DocsTheme;
36
+ /** Classes on `<html>` per theme. */
37
+ themeClasses?: {
38
+ light?: string[];
39
+ dark?: string[];
40
+ };
41
+ };
42
+ export declare function resolveTheme(storageKey: string | undefined, fallback: DocsTheme): DocsTheme;
43
+ export declare function createRuntime(options: RuntimeOptions): {
44
+ /** The demo module failed to load (syntax/runtime error at import). */
45
+ fail(error: unknown): void;
46
+ mount(component: unknown): Promise<void>;
47
+ };
48
+ /** Styles for the error overlay (inlined into every demo page). */
49
+ export declare const OVERLAY_CSS = "\n#dk-error-overlay { position: fixed; inset: 8px; z-index: 2147483600; display: flex; flex-direction: column;\n background: rgba(20, 20, 24, 0.94); color: #ffd7d7; border: 1px solid #ff6b6b; border-radius: 8px;\n font: 12px/1.5 ui-monospace, SFMono-Regular, Menlo, monospace; overflow: hidden; }\n#dk-error-overlay .dk-error-title { display: flex; justify-content: space-between; align-items: center;\n padding: 8px 12px; font-weight: 600; color: #ff8b8b; border-bottom: 1px solid rgba(255, 107, 107, 0.35); }\n#dk-error-overlay button { all: unset; cursor: pointer; font-size: 18px; line-height: 1; padding: 0 4px; color: #ffd7d7; }\n#dk-error-overlay pre { margin: 0; padding: 12px; overflow: auto; white-space: pre-wrap; flex: 1; }\n";
50
+ //# sourceMappingURL=iframe.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"iframe.d.ts","sourceRoot":"","sources":["../../../src/demos/runtime/iframe.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,MAAM,MAAM,SAAS,GAAG,OAAO,GAAG,MAAM,CAAC;AAEzC,MAAM,MAAM,WAAW,GAAG;IAAE,OAAO,IAAI,IAAI,CAAA;CAAE,CAAC;AAE9C,8EAA8E;AAC9E,MAAM,MAAM,WAAW,GAAG;IACxB,MAAM,CAAC,MAAM,EAAE,WAAW,EAAE,SAAS,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,GAAG,WAAW,CAAC;CACjG,CAAC;AAEF,4FAA4F;AAC5F,MAAM,MAAM,aAAa,GAAG;IAC1B,2CAA2C;IAC3C,KAAK,CAAC,CAAC,OAAO,EAAE;QAAE,KAAK,EAAE,SAAS,CAAA;KAAE,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5D,0DAA0D;IAC1D,UAAU,CAAC,CAAC,KAAK,EAAE,SAAS,GAAG,IAAI,CAAC;CACrC,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IAC3B,OAAO,EAAE,WAAW,CAAC;IACrB,IAAI,EAAE,aAAa,CAAC;IACpB,4DAA4D;IAC5D,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,YAAY,CAAC,EAAE,SAAS,CAAC;IACzB,qCAAqC;IACrC,YAAY,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;CACtD,CAAC;AAUF,wBAAgB,YAAY,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,EAAE,QAAQ,EAAE,SAAS,GAAG,SAAS,CAW3F;AAoCD,wBAAgB,aAAa,CAAC,OAAO,EAAE,cAAc;IAsIjD,uEAAuE;gBAC3D,OAAO;qBAMI,OAAO;EAcjC;AAED,mEAAmE;AACnE,eAAO,MAAM,WAAW,yuBAQvB,CAAC"}
@@ -0,0 +1,245 @@
1
+ /**
2
+ * Runs inside every demo iframe (bundled by the builder together with the
3
+ * framework adapter and the site's bootstrap module).
4
+ *
5
+ * Parent → iframe messages:
6
+ * { type: 'set-theme', theme } docs light/dark changed
7
+ * { type: 'demo-reset' } unmount + clear persisted keys
8
+ * { type: 'demo-update', js, css } run an edited build in place
9
+ * { type: 'demo-compile-error', message } show compile errors
10
+ * Iframe → parent:
11
+ * demo-ready, demo-error { message }, demo-escape, demo-reset-done
12
+ */
13
+ var __rewriteRelativeImportExtension = (this && this.__rewriteRelativeImportExtension) || function (path, preserveJsx) {
14
+ if (typeof path === "string" && /^\.\.?\//.test(path)) {
15
+ return path.replace(/\.(tsx)$|((?:\.d)?)((?:\.[^./]+?)?)\.([cm]?)ts$/i, function (m, tsx, d, ext, cm) {
16
+ return tsx ? preserveJsx ? ".jsx" : ".js" : d && (!ext || !cm) ? m : (d + ext + "." + cm.toLowerCase() + "js");
17
+ });
18
+ }
19
+ return path;
20
+ };
21
+ const post = (message) => {
22
+ try {
23
+ parent.postMessage(message, '*');
24
+ }
25
+ catch {
26
+ // standalone page without a parent - nothing to tell
27
+ }
28
+ };
29
+ export function resolveTheme(storageKey, fallback) {
30
+ try {
31
+ const fromQuery = new URLSearchParams(location.search).get('theme');
32
+ if (fromQuery === 'dark' || fromQuery === 'light')
33
+ return fromQuery;
34
+ const stored = storageKey ? localStorage.getItem(storageKey) : null;
35
+ if (stored === 'dark' || stored === 'light')
36
+ return stored;
37
+ if (window.matchMedia?.('(prefers-color-scheme: dark)').matches)
38
+ return 'dark';
39
+ }
40
+ catch {
41
+ // storage blocked
42
+ }
43
+ return fallback;
44
+ }
45
+ let overlay = null;
46
+ function showOverlay(title, message) {
47
+ if (!overlay) {
48
+ overlay = document.createElement('div');
49
+ overlay.id = 'dk-error-overlay';
50
+ overlay.setAttribute('role', 'alert');
51
+ document.body.appendChild(overlay);
52
+ }
53
+ overlay.replaceChildren();
54
+ const heading = document.createElement('div');
55
+ heading.className = 'dk-error-title';
56
+ heading.textContent = title;
57
+ const close = document.createElement('button');
58
+ close.type = 'button';
59
+ close.textContent = '×';
60
+ close.title = 'Dismiss';
61
+ close.addEventListener('click', hideOverlay);
62
+ heading.appendChild(close);
63
+ const body = document.createElement('pre');
64
+ body.textContent = message;
65
+ overlay.append(heading, body);
66
+ }
67
+ function hideOverlay() {
68
+ overlay?.remove();
69
+ overlay = null;
70
+ }
71
+ function errorText(error) {
72
+ if (error instanceof Error)
73
+ return error.stack || `${error.name}: ${error.message}`;
74
+ return String(error);
75
+ }
76
+ export function createRuntime(options) {
77
+ const { adapter, site, themeStorageKey, defaultTheme = 'light', themeClasses = {} } = options;
78
+ const root = () => document.getElementById('root');
79
+ const applyTheme = (theme) => {
80
+ const html = document.documentElement;
81
+ html.setAttribute('data-theme', theme);
82
+ html.style.colorScheme = theme;
83
+ html.classList.remove(...(themeClasses.light ?? []), ...(themeClasses.dark ?? []));
84
+ html.classList.add(...(themeClasses[theme] ?? []));
85
+ site.applyTheme?.(theme);
86
+ };
87
+ // Every localStorage key the demo writes, so "reset" can clear them. Patched
88
+ // on the prototype: assigning localStorage.setItem would store an item
89
+ // named "setItem".
90
+ const writtenKeys = new Set();
91
+ let resetting = false;
92
+ try {
93
+ const setItem = Storage.prototype.setItem;
94
+ Storage.prototype.setItem = function (key, value) {
95
+ if (this === localStorage) {
96
+ if (resetting)
97
+ return;
98
+ writtenKeys.add(String(key));
99
+ }
100
+ return setItem.call(this, key, value);
101
+ };
102
+ }
103
+ catch {
104
+ // storage unavailable
105
+ }
106
+ window.addEventListener('error', (event) => {
107
+ const message = errorText(event.error ?? event.message);
108
+ showOverlay('Runtime error', message);
109
+ post({ type: 'demo-error', message });
110
+ });
111
+ window.addEventListener('unhandledrejection', (event) => {
112
+ const message = errorText(event.reason);
113
+ showOverlay('Unhandled promise rejection', message);
114
+ post({ type: 'demo-error', message });
115
+ });
116
+ window.addEventListener('keydown', (event) => {
117
+ if (event.key === 'Escape')
118
+ post({ type: 'demo-escape' });
119
+ }, true);
120
+ let mounted = null;
121
+ let editedStyle = null;
122
+ let editedUrl = null;
123
+ let generation = 0;
124
+ const render = (component) => {
125
+ try {
126
+ mounted?.unmount();
127
+ }
128
+ catch {
129
+ // a broken demo can throw on unmount; the next render replaces it anyway
130
+ }
131
+ mounted = null;
132
+ root().replaceChildren();
133
+ mounted = adapter.render(root(), component, (error) => {
134
+ const message = errorText(error);
135
+ showOverlay('Render error', message);
136
+ post({ type: 'demo-error', message });
137
+ });
138
+ };
139
+ const runEdited = async (js, css) => {
140
+ const current = ++generation;
141
+ const url = URL.createObjectURL(new Blob([js], { type: 'text/javascript' }));
142
+ try {
143
+ // Bare imports in the edited module resolve through this document's import map.
144
+ const mod = (await import(__rewriteRelativeImportExtension(/* @vite-ignore */ url)));
145
+ if (current !== generation)
146
+ return;
147
+ if (!mod.default)
148
+ throw new Error('The demo entry file has no default export');
149
+ if (editedStyle)
150
+ editedStyle.remove();
151
+ editedStyle = null;
152
+ // The prebuilt demo's own stylesheet no longer matches the edited code.
153
+ document.querySelectorAll('link[data-demo-css]').forEach((link) => link.remove());
154
+ if (css) {
155
+ editedStyle = document.createElement('style');
156
+ editedStyle.dataset.demoEdited = '';
157
+ editedStyle.textContent = css;
158
+ document.head.appendChild(editedStyle);
159
+ }
160
+ hideOverlay();
161
+ render(mod.default);
162
+ }
163
+ catch (error) {
164
+ if (current !== generation)
165
+ return;
166
+ const message = errorText(error);
167
+ showOverlay('Runtime error', message);
168
+ post({ type: 'demo-error', message });
169
+ }
170
+ finally {
171
+ if (editedUrl)
172
+ URL.revokeObjectURL(editedUrl);
173
+ editedUrl = url;
174
+ }
175
+ };
176
+ window.addEventListener('message', (event) => {
177
+ const data = event.data;
178
+ if (!data || typeof data.type !== 'string')
179
+ return;
180
+ switch (data.type) {
181
+ case 'set-theme':
182
+ applyTheme(data.theme === 'dark' ? 'dark' : 'light');
183
+ break;
184
+ case 'demo-reset':
185
+ resetting = true;
186
+ try {
187
+ mounted?.unmount();
188
+ }
189
+ catch {
190
+ // ignore
191
+ }
192
+ mounted = null;
193
+ for (const key of writtenKeys) {
194
+ try {
195
+ localStorage.removeItem(key);
196
+ }
197
+ catch {
198
+ // ignore
199
+ }
200
+ }
201
+ post({ type: 'demo-reset-done' });
202
+ break;
203
+ case 'demo-update':
204
+ void runEdited(String(data.js ?? ''), String(data.css ?? ''));
205
+ break;
206
+ case 'demo-compile-error':
207
+ showOverlay('Compile error', String(data.message ?? 'Unknown error'));
208
+ break;
209
+ }
210
+ });
211
+ return {
212
+ /** The demo module failed to load (syntax/runtime error at import). */
213
+ fail(error) {
214
+ const message = errorText(error);
215
+ showOverlay('The demo failed to load', message);
216
+ post({ type: 'demo-error', message });
217
+ post({ type: 'demo-ready' });
218
+ },
219
+ async mount(component) {
220
+ const theme = resolveTheme(themeStorageKey, defaultTheme);
221
+ applyTheme(theme);
222
+ try {
223
+ await site.setup?.({ theme });
224
+ render(component);
225
+ }
226
+ catch (error) {
227
+ const message = errorText(error);
228
+ showOverlay('Runtime error', message);
229
+ post({ type: 'demo-error', message });
230
+ }
231
+ requestAnimationFrame(() => requestAnimationFrame(() => post({ type: 'demo-ready' })));
232
+ },
233
+ };
234
+ }
235
+ /** Styles for the error overlay (inlined into every demo page). */
236
+ export const OVERLAY_CSS = `
237
+ #dk-error-overlay { position: fixed; inset: 8px; z-index: 2147483600; display: flex; flex-direction: column;
238
+ background: rgba(20, 20, 24, 0.94); color: #ffd7d7; border: 1px solid #ff6b6b; border-radius: 8px;
239
+ font: 12px/1.5 ui-monospace, SFMono-Regular, Menlo, monospace; overflow: hidden; }
240
+ #dk-error-overlay .dk-error-title { display: flex; justify-content: space-between; align-items: center;
241
+ padding: 8px 12px; font-weight: 600; color: #ff8b8b; border-bottom: 1px solid rgba(255, 107, 107, 0.35); }
242
+ #dk-error-overlay button { all: unset; cursor: pointer; font-size: 18px; line-height: 1; padding: 0 4px; color: #ffd7d7; }
243
+ #dk-error-overlay pre { margin: 0; padding: 12px; overflow: auto; white-space: pre-wrap; flex: 1; }
244
+ `;
245
+ //# sourceMappingURL=iframe.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"iframe.js","sourceRoot":"","sources":["../../../src/demos/runtime/iframe.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,3 @@
1
+ import type { DemoAdapter } from './iframe.ts';
2
+ export declare const reactAdapter: DemoAdapter;
3
+ //# sourceMappingURL=react.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"react.d.ts","sourceRoot":"","sources":["../../../src/demos/runtime/react.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE/C,eAAO,MAAM,YAAY,EAAE,WAQ1B,CAAC"}
@@ -0,0 +1,17 @@
1
+ /**
2
+ * React adapter for the iframe runtime. `react` and `react-dom/client` stay
3
+ * bare imports: the builder externalizes them, so the iframe's import map
4
+ * hands the runtime and the demo the same React instance.
5
+ */
6
+ import { createElement } from 'react';
7
+ import { createRoot } from 'react-dom/client';
8
+ export const reactAdapter = {
9
+ render(target, component, onError) {
10
+ const root = createRoot(target, {
11
+ onUncaughtError: (error) => onError(error),
12
+ });
13
+ root.render(createElement(component));
14
+ return { unmount: () => root.unmount() };
15
+ },
16
+ };
17
+ //# sourceMappingURL=react.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"react.js","sourceRoot":"","sources":["../../../src/demos/runtime/react.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,aAAa,EAAsB,MAAM,OAAO,CAAC;AAC1D,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAI9C,MAAM,CAAC,MAAM,YAAY,GAAgB;IACvC,MAAM,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO;QAC/B,MAAM,IAAI,GAAG,UAAU,CAAC,MAAM,EAAE;YAC9B,eAAe,EAAE,CAAC,KAAc,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC;SAChB,CAAC,CAAC;QACvC,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,SAA0B,CAAC,CAAC,CAAC;QACvD,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,CAAC;IAC3C,CAAC;CACF,CAAC"}
@@ -0,0 +1,3 @@
1
+ /** URL hash slug of a demo card: "Your first grid" → `your-first-grid`, `basic.demo.tsx` → `basic-demo`. */
2
+ export declare function slugifyDemoTitle(text: string): string;
3
+ //# sourceMappingURL=slug.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"slug.d.ts","sourceRoot":"","sources":["../../src/demos/slug.ts"],"names":[],"mappings":"AAAA,4GAA4G;AAC5G,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAQrD"}
@@ -0,0 +1,11 @@
1
+ /** URL hash slug of a demo card: "Your first grid" → `your-first-grid`, `basic.demo.tsx` → `basic-demo`. */
2
+ export function slugifyDemoTitle(text) {
3
+ return text
4
+ .trim()
5
+ .replace(/\.[jt]sx?$/i, '')
6
+ .toLowerCase()
7
+ .replace(/['’]/g, '')
8
+ .replace(/[^a-z0-9]+/g, '-')
9
+ .replace(/^-+|-+$/g, '');
10
+ }
11
+ //# sourceMappingURL=slug.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"slug.js","sourceRoot":"","sources":["../../src/demos/slug.ts"],"names":[],"mappings":"AAAA,4GAA4G;AAC5G,MAAM,UAAU,gBAAgB,CAAC,IAAY;IAC3C,OAAO,IAAI;SACR,IAAI,EAAE;SACN,OAAO,CAAC,aAAa,EAAE,EAAE,CAAC;SAC1B,WAAW,EAAE;SACb,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC;SACpB,OAAO,CAAC,aAAa,EAAE,GAAG,CAAC;SAC3B,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;AAC7B,CAAC"}
@@ -0,0 +1,32 @@
1
+ import type { Plugin } from 'esbuild';
2
+ import type { LibrarySource } from './config.ts';
3
+ /** `@scope/pkg/sub` → `scope__pkg__sub`, safe as an output file name. */
4
+ export declare function entryNameFor(specifier: string): string;
5
+ export type VendorEntries = {
6
+ /** esbuild entry name → wrapper file. */
7
+ entryPoints: Record<string, string>;
8
+ /** esbuild entry name → specifier. */
9
+ specifierByEntry: Record<string, string>;
10
+ };
11
+ /** Writes one wrapper module per specifier into `workDir`. */
12
+ export declare function writeVendorEntries(options: {
13
+ specifiers: string[];
14
+ libraries: Record<string, LibrarySource>;
15
+ root: string;
16
+ nodePaths: string[];
17
+ workDir: string;
18
+ warn: (message: string) => void;
19
+ }): Promise<VendorEntries>;
20
+ /**
21
+ * Resolves libraries to their source entries, stubs `stubImports`, and pins
22
+ * every import-map package to the copy resolved from the site root — a
23
+ * library built from another folder (e.g. `../source/src`) would otherwise
24
+ * bundle its own React.
25
+ */
26
+ export declare function vendorResolvePlugin(options: {
27
+ libraries: Record<string, LibrarySource>;
28
+ canonical: Set<string>;
29
+ stubImports: string[];
30
+ root: string;
31
+ }): Plugin;
32
+ //# sourceMappingURL=vendor.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"vendor.d.ts","sourceRoot":"","sources":["../../src/demos/vendor.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAGtC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AASjD,yEAAyE;AACzE,wBAAgB,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAEtD;AAoCD,MAAM,MAAM,aAAa,GAAG;IAC1B,yCAAyC;IACzC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACpC,sCAAsC;IACtC,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC1C,CAAC;AAEF,8DAA8D;AAC9D,wBAAsB,kBAAkB,CAAC,OAAO,EAAE;IAChD,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;IACzC,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CACjC,GAAG,OAAO,CAAC,aAAa,CAAC,CA8BzB;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE;IAC3C,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;IACzC,SAAS,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACvB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,IAAI,EAAE,MAAM,CAAC;CACd,GAAG,MAAM,CAsBT"}
@@ -0,0 +1,127 @@
1
+ var __rewriteRelativeImportExtension = (this && this.__rewriteRelativeImportExtension) || function (path, preserveJsx) {
2
+ if (typeof path === "string" && /^\.\.?\//.test(path)) {
3
+ return path.replace(/\.(tsx)$|((?:\.d)?)((?:\.[^./]+?)?)\.([cm]?)ts$/i, function (m, tsx, d, ext, cm) {
4
+ return tsx ? preserveJsx ? ".jsx" : ".js" : d && (!ext || !cm) ? m : (d + ext + "." + cm.toLowerCase() + "js");
5
+ });
6
+ }
7
+ return path;
8
+ };
9
+ /**
10
+ * The import-map side of the demo build: every package the demos (and the
11
+ * iframe runtime) import becomes one ESM entry under `<outDir>/_lib/`, built
12
+ * in a single esbuild pass with code splitting, so React and friends exist
13
+ * once and are shared by every entry, demo and edited rebuild.
14
+ */
15
+ import fs from 'node:fs';
16
+ import { createRequire } from 'node:module';
17
+ import path from 'node:path';
18
+ import { pathToFileURL } from 'node:url';
19
+ import { matchesStub } from "./compile/core.js";
20
+ const VALID_IDENTIFIER = /^[A-Za-z_$][\w$]*$/;
21
+ const RESERVED = new Set('break case catch class const continue debugger default delete do else enum export extends false finally for function if import in instanceof new null return super switch this throw true try typeof var void while with yield let static implements interface package private protected public await'.split(' '));
22
+ /** `@scope/pkg/sub` → `scope__pkg__sub`, safe as an output file name. */
23
+ export function entryNameFor(specifier) {
24
+ return specifier.replace(/^@/, '').replace(/\//g, '__').replace(/[^\w.-]/g, '_');
25
+ }
26
+ /**
27
+ * Export names of an npm package, read by loading it in Node. CommonJS
28
+ * packages (React…) have no static ESM names, so the wrapper entry lists them.
29
+ */
30
+ async function readExportShape(specifier, root, nodePaths) {
31
+ const require = createRequire(path.join(root, 'package.json'));
32
+ let resolved;
33
+ try {
34
+ resolved = require.resolve(specifier, { paths: [root, ...nodePaths.map((p) => path.dirname(p))] });
35
+ }
36
+ catch {
37
+ return null;
38
+ }
39
+ let mod;
40
+ try {
41
+ mod = require(resolved);
42
+ }
43
+ catch {
44
+ try {
45
+ mod = await import(__rewriteRelativeImportExtension(pathToFileURL(resolved).href));
46
+ }
47
+ catch {
48
+ return null;
49
+ }
50
+ }
51
+ if (mod == null || (typeof mod !== 'object' && typeof mod !== 'function')) {
52
+ return { names: [], hasDefault: true };
53
+ }
54
+ const isNamespace = mod[Symbol.toStringTag] === 'Module';
55
+ const names = Object.keys(mod).filter((name) => name !== 'default' && name !== '__esModule' && VALID_IDENTIFIER.test(name) && !RESERVED.has(name));
56
+ return { names, hasDefault: isNamespace ? 'default' in mod : true };
57
+ }
58
+ /** Writes one wrapper module per specifier into `workDir`. */
59
+ export async function writeVendorEntries(options) {
60
+ const { specifiers, libraries, root, nodePaths, workDir, warn } = options;
61
+ fs.mkdirSync(workDir, { recursive: true });
62
+ const entryPoints = {};
63
+ const specifierByEntry = {};
64
+ for (const specifier of [...specifiers].sort()) {
65
+ const name = entryNameFor(specifier);
66
+ const file = path.join(workDir, `${name}.mjs`);
67
+ let contents;
68
+ const library = libraries[specifier];
69
+ if (library) {
70
+ contents = `export * from ${JSON.stringify(path.resolve(root, library.entry))};\n`;
71
+ }
72
+ else {
73
+ const shape = await readExportShape(specifier, root, nodePaths);
74
+ if (!shape) {
75
+ warn(`could not load "${specifier}" in Node to list its exports; re-exporting with \`export *\``);
76
+ contents = `export * from ${JSON.stringify(specifier)};\n`;
77
+ }
78
+ else {
79
+ const lines = [`import * as __dk from ${JSON.stringify(specifier)};`];
80
+ if (shape.names.length)
81
+ lines.push(`export const { ${shape.names.join(', ')} } = __dk;`);
82
+ if (shape.hasDefault)
83
+ lines.push('export default __dk.default;');
84
+ contents = `${lines.join('\n')}\n`;
85
+ }
86
+ }
87
+ fs.writeFileSync(file, contents);
88
+ entryPoints[name] = file;
89
+ specifierByEntry[name] = specifier;
90
+ }
91
+ return { entryPoints, specifierByEntry };
92
+ }
93
+ /**
94
+ * Resolves libraries to their source entries, stubs `stubImports`, and pins
95
+ * every import-map package to the copy resolved from the site root — a
96
+ * library built from another folder (e.g. `../source/src`) would otherwise
97
+ * bundle its own React.
98
+ */
99
+ export function vendorResolvePlugin(options) {
100
+ const { libraries, canonical, stubImports, root } = options;
101
+ return {
102
+ name: 'docs-kit:vendor-resolve',
103
+ setup(build) {
104
+ build.onResolve({ filter: /^[^./]/ }, async (args) => {
105
+ if (args.pluginData?.docsKitCanonical)
106
+ return undefined;
107
+ const library = libraries[args.path];
108
+ if (library)
109
+ return { path: path.resolve(root, library.entry) };
110
+ if (matchesStub(args.path, stubImports))
111
+ return { path: args.path, namespace: 'docs-kit-stub' };
112
+ if (!canonical.has(args.path))
113
+ return undefined;
114
+ const result = await build.resolve(args.path, {
115
+ kind: args.kind,
116
+ resolveDir: root,
117
+ pluginData: { docsKitCanonical: true },
118
+ });
119
+ if (result.errors.length)
120
+ return { errors: result.errors };
121
+ return { path: result.path, namespace: result.namespace, sideEffects: result.sideEffects };
122
+ });
123
+ build.onLoad({ filter: /.*/, namespace: 'docs-kit-stub' }, () => ({ contents: '', loader: 'js' }));
124
+ },
125
+ };
126
+ }
127
+ //# sourceMappingURL=vendor.js.map