@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.
- package/CHANGELOG.md +20 -0
- package/README.md +224 -2
- package/dist/code/demoFiles.d.ts +14 -0
- package/dist/code/demoFiles.d.ts.map +1 -0
- package/dist/code/demoFiles.js +46 -0
- package/dist/code/demoFiles.js.map +1 -0
- package/dist/code/heights.d.ts +17 -0
- package/dist/code/heights.d.ts.map +1 -0
- package/dist/code/heights.js +40 -0
- package/dist/code/heights.js.map +1 -0
- package/dist/code/highlightSpec.d.ts +34 -0
- package/dist/code/highlightSpec.d.ts.map +1 -0
- package/dist/code/highlightSpec.js +119 -0
- package/dist/code/highlightSpec.js.map +1 -0
- package/dist/code/imports.d.ts +5 -0
- package/dist/code/imports.d.ts.map +1 -0
- package/dist/code/imports.js +17 -0
- package/dist/code/imports.js.map +1 -0
- package/dist/code/index.d.ts +8 -0
- package/dist/code/index.d.ts.map +1 -0
- package/dist/code/index.js +8 -0
- package/dist/code/index.js.map +1 -0
- package/dist/code/lineRanges.d.ts +5 -0
- package/dist/code/lineRanges.d.ts.map +1 -0
- package/dist/code/lineRanges.js +35 -0
- package/dist/code/lineRanges.js.map +1 -0
- package/dist/code/regions.d.ts +53 -0
- package/dist/code/regions.d.ts.map +1 -0
- package/dist/code/regions.js +237 -0
- package/dist/code/regions.js.map +1 -0
- package/dist/code/shiki.d.ts +58 -0
- package/dist/code/shiki.d.ts.map +1 -0
- package/dist/code/shiki.js +244 -0
- package/dist/code/shiki.js.map +1 -0
- package/dist/demos/build.d.ts +17 -0
- package/dist/demos/build.d.ts.map +1 -0
- package/dist/demos/build.js +426 -0
- package/dist/demos/build.js.map +1 -0
- package/dist/demos/cli.d.ts +3 -0
- package/dist/demos/cli.d.ts.map +1 -0
- package/dist/demos/cli.js +102 -0
- package/dist/demos/cli.js.map +1 -0
- package/dist/demos/client.d.ts +27 -0
- package/dist/demos/client.d.ts.map +1 -0
- package/dist/demos/client.js +61 -0
- package/dist/demos/client.js.map +1 -0
- package/dist/demos/compile/core.d.ts +64 -0
- package/dist/demos/compile/core.d.ts.map +1 -0
- package/dist/demos/compile/core.js +174 -0
- package/dist/demos/compile/core.js.map +1 -0
- package/dist/demos/config.d.ts +108 -0
- package/dist/demos/config.d.ts.map +1 -0
- package/dist/demos/config.js +4 -0
- package/dist/demos/config.js.map +1 -0
- package/dist/demos/devEvents.d.ts +13 -0
- package/dist/demos/devEvents.d.ts.map +1 -0
- package/dist/demos/devEvents.js +45 -0
- package/dist/demos/devEvents.js.map +1 -0
- package/dist/demos/html.d.ts +21 -0
- package/dist/demos/html.d.ts.map +1 -0
- package/dist/demos/html.js +57 -0
- package/dist/demos/html.js.map +1 -0
- package/dist/demos/index.d.ts +8 -0
- package/dist/demos/index.d.ts.map +1 -0
- package/dist/demos/index.js +6 -0
- package/dist/demos/index.js.map +1 -0
- package/dist/demos/pages.d.ts +15 -0
- package/dist/demos/pages.d.ts.map +1 -0
- package/dist/demos/pages.js +71 -0
- package/dist/demos/pages.js.map +1 -0
- package/dist/demos/runtime/iframe.d.ts +50 -0
- package/dist/demos/runtime/iframe.d.ts.map +1 -0
- package/dist/demos/runtime/iframe.js +245 -0
- package/dist/demos/runtime/iframe.js.map +1 -0
- package/dist/demos/runtime/react.d.ts +3 -0
- package/dist/demos/runtime/react.d.ts.map +1 -0
- package/dist/demos/runtime/react.js +17 -0
- package/dist/demos/runtime/react.js.map +1 -0
- package/dist/demos/slug.d.ts +3 -0
- package/dist/demos/slug.d.ts.map +1 -0
- package/dist/demos/slug.js +11 -0
- package/dist/demos/slug.js.map +1 -0
- package/dist/demos/vendor.d.ts +32 -0
- package/dist/demos/vendor.d.ts.map +1 -0
- package/dist/demos/vendor.js +127 -0
- package/dist/demos/vendor.js.map +1 -0
- package/dist/demos/worker/compile.worker.d.ts +2 -0
- package/dist/demos/worker/compile.worker.d.ts.map +1 -0
- package/dist/demos/worker/compile.worker.js +27 -0
- package/dist/demos/worker/compile.worker.js.map +1 -0
- package/dist/editor/install.d.ts +15 -0
- package/dist/editor/install.d.ts.map +1 -0
- package/dist/editor/install.js +71 -0
- package/dist/editor/install.js.map +1 -0
- package/dist/fork/codesandbox.d.ts +39 -0
- package/dist/fork/codesandbox.d.ts.map +1 -0
- package/dist/fork/codesandbox.js +156 -0
- package/dist/fork/codesandbox.js.map +1 -0
- package/dist/fork/index.d.ts +2 -0
- package/dist/fork/index.d.ts.map +1 -0
- package/dist/fork/index.js +2 -0
- package/dist/fork/index.js.map +1 -0
- package/dist/react/Demo.d.ts +80 -0
- package/dist/react/Demo.d.ts.map +1 -0
- package/dist/react/Demo.js +156 -0
- package/dist/react/Demo.js.map +1 -0
- package/dist/react/DemoIframe.d.ts +22 -0
- package/dist/react/DemoIframe.d.ts.map +1 -0
- package/dist/react/DemoIframe.js +123 -0
- package/dist/react/DemoIframe.js.map +1 -0
- package/dist/react/DemoShell.d.ts +47 -0
- package/dist/react/DemoShell.d.ts.map +1 -0
- package/dist/react/DemoShell.js +341 -0
- package/dist/react/DemoShell.js.map +1 -0
- package/dist/react/devEvents.d.ts +17 -0
- package/dist/react/devEvents.d.ts.map +1 -0
- package/dist/react/devEvents.js +30 -0
- package/dist/react/devEvents.js.map +1 -0
- package/dist/react/editor.d.ts +17 -0
- package/dist/react/editor.d.ts.map +1 -0
- package/dist/react/editor.js +158 -0
- package/dist/react/editor.js.map +1 -0
- package/dist/react/fork.d.ts +10 -0
- package/dist/react/fork.d.ts.map +1 -0
- package/dist/react/fork.js +30 -0
- package/dist/react/fork.js.map +1 -0
- package/dist/react/index.d.ts +4 -0
- package/dist/react/index.d.ts.map +1 -0
- package/dist/react/index.js +4 -0
- package/dist/react/index.js.map +1 -0
- package/dist/react/styles.css +471 -0
- package/dist/remark/index.d.ts +3 -0
- package/dist/remark/index.d.ts.map +1 -0
- package/dist/remark/index.js +3 -0
- package/dist/remark/index.js.map +1 -0
- package/dist/remark/meta.d.ts +7 -0
- package/dist/remark/meta.d.ts.map +1 -0
- package/dist/remark/meta.js +20 -0
- package/dist/remark/meta.js.map +1 -0
- package/dist/remark/remarkDemoFences.d.ts +77 -0
- package/dist/remark/remarkDemoFences.d.ts.map +1 -0
- package/dist/remark/remarkDemoFences.js +259 -0
- package/dist/remark/remarkDemoFences.js.map +1 -0
- package/editor-extension/README.md +23 -0
- package/editor-extension/extension.js +40 -0
- package/editor-extension/links.js +137 -0
- package/editor-extension/package.json +19 -0
- package/package.json +107 -4
- package/src/code/demoFiles.ts +54 -0
- package/src/code/heights.ts +47 -0
- package/src/code/highlightSpec.ts +139 -0
- package/src/code/imports.ts +18 -0
- package/src/code/index.ts +46 -0
- package/src/code/lineRanges.ts +31 -0
- package/src/code/regions.ts +270 -0
- package/src/code/shiki.ts +271 -0
- package/src/demos/build.ts +477 -0
- package/src/demos/cli.ts +97 -0
- package/src/demos/client.ts +82 -0
- package/src/demos/compile/core.ts +228 -0
- package/src/demos/config.ts +106 -0
- package/src/demos/devEvents.ts +45 -0
- package/src/demos/html.ts +74 -0
- package/src/demos/index.ts +25 -0
- package/src/demos/pages.ts +79 -0
- package/src/demos/runtime/iframe.ts +262 -0
- package/src/demos/runtime/react.ts +19 -0
- package/src/demos/slug.ts +10 -0
- package/src/demos/vendor.ts +142 -0
- package/src/demos/worker/compile.worker.ts +35 -0
- package/src/editor/install.ts +85 -0
- package/src/fork/codesandbox.ts +189 -0
- package/src/fork/index.ts +10 -0
- package/src/react/Demo.tsx +250 -0
- package/src/react/DemoIframe.tsx +165 -0
- package/src/react/DemoShell.tsx +592 -0
- package/src/react/devEvents.ts +34 -0
- package/src/react/editor.ts +178 -0
- package/src/react/fork.ts +31 -0
- package/src/react/index.ts +10 -0
- package/src/react/styles.css +471 -0
- package/src/remark/index.ts +2 -0
- package/src/remark/meta.ts +20 -0
- package/src/remark/remarkDemoFences.ts +330 -0
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/demos/client.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,cAAc,EAAiC,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAEjG,YAAY,EACV,cAAc,EACd,cAAc,EACd,cAAc,EACd,aAAa,EACb,QAAQ,GACT,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAExD,MAAM,MAAM,cAAc,GACtB;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GACjD;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC;AAyBzC,2DAA2D;AAC3D,wBAAgB,qBAAqB,CAAC,MAAM,EAAE;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,EAAE,OAAO,EAAE,cAAc,GAAG,QAAQ,CAYjH;AAED,yFAAyF;AACzF,wBAAgB,oBAAoB,CAAC,MAAM,EAAE;IAAE,QAAQ,EAAE,MAAM,CAAA;CAAE,EAAE,OAAO,EAAE,cAAc,GAAG,QAAQ,CAkBpG;AAED,wBAAgB,cAAc,CAAC,MAAM,EAAE,cAAc,EAAE,OAAO,EAAE,cAAc,GAAG,QAAQ,CAExF"}
|
|
@@ -0,0 +1,61 @@
|
|
|
1
|
+
export { formatCompileErrors } from "./compile/core.js";
|
|
2
|
+
const workers = new Map();
|
|
3
|
+
function sharedWorker(workerUrl) {
|
|
4
|
+
let entry = workers.get(workerUrl);
|
|
5
|
+
if (!entry) {
|
|
6
|
+
const worker = new Worker(workerUrl, { type: 'module', name: 'docs-kit-compiler' });
|
|
7
|
+
const pending = new Map();
|
|
8
|
+
worker.addEventListener('message', (event) => {
|
|
9
|
+
pending.get(event.data.id)?.(event.data.result);
|
|
10
|
+
pending.delete(event.data.id);
|
|
11
|
+
});
|
|
12
|
+
worker.addEventListener('error', (event) => {
|
|
13
|
+
for (const resolve of pending.values()) {
|
|
14
|
+
resolve({ ok: false, errors: [{ text: `The editor's compiler crashed: ${event.message || 'unknown error'}` }] });
|
|
15
|
+
}
|
|
16
|
+
pending.clear();
|
|
17
|
+
});
|
|
18
|
+
entry = { worker, nextId: 0, pending };
|
|
19
|
+
workers.set(workerUrl, entry);
|
|
20
|
+
}
|
|
21
|
+
return entry;
|
|
22
|
+
}
|
|
23
|
+
/** esbuild-wasm in a (page-wide, shared) module worker. */
|
|
24
|
+
export function createBrowserCompiler(config, options) {
|
|
25
|
+
const wasmURL = new URL(config.wasm, location.href).href;
|
|
26
|
+
return {
|
|
27
|
+
compile(request) {
|
|
28
|
+
const shared = sharedWorker(new URL(config.worker, location.href).href);
|
|
29
|
+
const id = ++shared.nextId;
|
|
30
|
+
return new Promise((resolve) => {
|
|
31
|
+
shared.pending.set(id, resolve);
|
|
32
|
+
shared.worker.postMessage({ id, wasmURL, request, options });
|
|
33
|
+
});
|
|
34
|
+
},
|
|
35
|
+
};
|
|
36
|
+
}
|
|
37
|
+
/** POSTs `{ request, options }` as JSON; the endpoint answers with a `CompileResult`. */
|
|
38
|
+
export function createRemoteCompiler(config, options) {
|
|
39
|
+
return {
|
|
40
|
+
async compile(request) {
|
|
41
|
+
try {
|
|
42
|
+
const response = await fetch(config.endpoint, {
|
|
43
|
+
method: 'POST',
|
|
44
|
+
headers: { 'content-type': 'application/json' },
|
|
45
|
+
body: JSON.stringify({ request, options }),
|
|
46
|
+
});
|
|
47
|
+
if (!response.ok) {
|
|
48
|
+
return { ok: false, errors: [{ text: `Compile server error ${response.status}: ${await response.text()}` }] };
|
|
49
|
+
}
|
|
50
|
+
return (await response.json());
|
|
51
|
+
}
|
|
52
|
+
catch (error) {
|
|
53
|
+
return { ok: false, errors: [{ text: `Compile server unreachable: ${String(error)}` }] };
|
|
54
|
+
}
|
|
55
|
+
},
|
|
56
|
+
};
|
|
57
|
+
}
|
|
58
|
+
export function createCompiler(config, options) {
|
|
59
|
+
return config.kind === 'remote' ? createRemoteCompiler(config, options) : createBrowserCompiler(config, options);
|
|
60
|
+
}
|
|
61
|
+
//# sourceMappingURL=client.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/demos/client.ts"],"names":[],"mappings":"AAcA,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAMxD,MAAM,OAAO,GAAG,IAAI,GAAG,EAAgG,CAAC;AAExH,SAAS,YAAY,CAAC,SAAiB;IACrC,IAAI,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IACnC,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,MAAM,GAAG,IAAI,MAAM,CAAC,SAAS,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,mBAAmB,EAAE,CAAC,CAAC;QACpF,MAAM,OAAO,GAAG,IAAI,GAAG,EAAsC,CAAC;QAC9D,MAAM,CAAC,gBAAgB,CAAC,SAAS,EAAE,CAAC,KAA0D,EAAE,EAAE;YAChG,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YAChD,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAChC,CAAC,CAAC,CAAC;QACH,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE;YACzC,KAAK,MAAM,OAAO,IAAI,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC;gBACvC,OAAO,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,EAAE,IAAI,EAAE,kCAAkC,KAAK,CAAC,OAAO,IAAI,eAAe,EAAE,EAAE,CAAC,EAAE,CAAC,CAAC;YACnH,CAAC;YACD,OAAO,CAAC,KAAK,EAAE,CAAC;QAClB,CAAC,CAAC,CAAC;QACH,KAAK,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC;QACvC,OAAO,CAAC,GAAG,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;IAChC,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,2DAA2D;AAC3D,MAAM,UAAU,qBAAqB,CAAC,MAAwC,EAAE,OAAuB;IACrG,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,QAAQ,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC;IACzD,OAAO;QACL,OAAO,CAAC,OAAuB;YAC7B,MAAM,MAAM,GAAG,YAAY,CAAC,IAAI,GAAG,CAAC,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC;YACxE,MAAM,EAAE,GAAG,EAAE,MAAM,CAAC,MAAM,CAAC;YAC3B,OAAO,IAAI,OAAO,CAAgB,CAAC,OAAO,EAAE,EAAE;gBAC5C,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC;gBAChC,MAAM,CAAC,MAAM,CAAC,WAAW,CAAC,EAAE,EAAE,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,CAAC;YAC/D,CAAC,CAAC,CAAC;QACL,CAAC;KACF,CAAC;AACJ,CAAC;AAED,yFAAyF;AACzF,MAAM,UAAU,oBAAoB,CAAC,MAA4B,EAAE,OAAuB;IACxF,OAAO;QACL,KAAK,CAAC,OAAO,CAAC,OAAuB;YACnC,IAAI,CAAC;gBACH,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,MAAM,CAAC,QAAQ,EAAE;oBAC5C,MAAM,EAAE,MAAM;oBACd,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;oBAC/C,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC;iBAC3C,CAAC,CAAC;gBACH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;oBACjB,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,EAAE,IAAI,EAAE,wBAAwB,QAAQ,CAAC,MAAM,KAAK,MAAM,QAAQ,CAAC,IAAI,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC;gBAChH,CAAC;gBACD,OAAO,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAkB,CAAC;YAClD,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,EAAE,IAAI,EAAE,+BAA+B,MAAM,CAAC,KAAK,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC;YAC3F,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,MAAsB,EAAE,OAAuB;IAC5E,OAAO,MAAM,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,oBAAoB,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,qBAAqB,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AACnH,CAAC"}
|
|
@@ -0,0 +1,64 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* The compile step shared by every implementation: the browser worker
|
|
3
|
+
* (esbuild-wasm), a remote server (native esbuild) and the tests. It takes
|
|
4
|
+
* the esbuild module as a parameter, so it has no Node or DOM dependencies.
|
|
5
|
+
*
|
|
6
|
+
* A demo is compiled on its own: relative imports come from `files`, every
|
|
7
|
+
* bare import stays external (the iframe's import map resolves it), and
|
|
8
|
+
* `stubImports` (CSS that the iframe already links) compile to nothing.
|
|
9
|
+
*/
|
|
10
|
+
import type * as esbuildTypes from 'esbuild';
|
|
11
|
+
export type EsbuildLike = Pick<typeof esbuildTypes, 'build'>;
|
|
12
|
+
export type CompileRequest = {
|
|
13
|
+
/** Source files by POSIX path (any shared root, e.g. content-relative). */
|
|
14
|
+
files: Record<string, string>;
|
|
15
|
+
/** Path of the entry file in `files`. */
|
|
16
|
+
entry: string;
|
|
17
|
+
};
|
|
18
|
+
export type CompileOptions = {
|
|
19
|
+
/** esbuild `define` (values are JS expressions, e.g. `'"https://…"'`). */
|
|
20
|
+
define?: Record<string, string>;
|
|
21
|
+
/** Regex sources: bare imports matching one compile to an empty module. */
|
|
22
|
+
stubImports?: string[];
|
|
23
|
+
minify?: boolean;
|
|
24
|
+
/** Inline source maps, for readable stack traces of edited code. Default `true`. */
|
|
25
|
+
sourcemap?: boolean;
|
|
26
|
+
};
|
|
27
|
+
export type CompileMessage = {
|
|
28
|
+
text: string;
|
|
29
|
+
file?: string;
|
|
30
|
+
line?: number;
|
|
31
|
+
column?: number;
|
|
32
|
+
lineText?: string;
|
|
33
|
+
};
|
|
34
|
+
export type CompileResult = {
|
|
35
|
+
ok: true;
|
|
36
|
+
js: string;
|
|
37
|
+
css: string;
|
|
38
|
+
warnings: CompileMessage[];
|
|
39
|
+
} | {
|
|
40
|
+
ok: false;
|
|
41
|
+
errors: CompileMessage[];
|
|
42
|
+
};
|
|
43
|
+
export interface Compiler {
|
|
44
|
+
compile(request: CompileRequest): Promise<CompileResult>;
|
|
45
|
+
dispose?(): void;
|
|
46
|
+
}
|
|
47
|
+
/** Extensions tried for extensionless relative imports, in order. */
|
|
48
|
+
export declare const RESOLVE_EXTENSIONS: string[];
|
|
49
|
+
export declare function isBareSpecifier(specifier: string): boolean;
|
|
50
|
+
export declare function matchesStub(specifier: string, stubImports: string[] | undefined): boolean;
|
|
51
|
+
export declare function loaderForPath(filePath: string): esbuildTypes.Loader;
|
|
52
|
+
export declare function resolveInFiles(files: Record<string, string>, fromFile: string, specifier: string): string | null;
|
|
53
|
+
/**
|
|
54
|
+
* Externalizes bare imports and stubs `stubImports`. Used by the prebuild
|
|
55
|
+
* (real files) and by `compileDemo` (virtual files), so both agree on what
|
|
56
|
+
* the import map provides.
|
|
57
|
+
*/
|
|
58
|
+
export declare function externalImportsPlugin(stubImports: string[] | undefined): esbuildTypes.Plugin;
|
|
59
|
+
/** Shared esbuild options for demo code (prebuild and in-browser rebuilds). */
|
|
60
|
+
export declare function demoBuildOptions(options: CompileOptions): esbuildTypes.BuildOptions;
|
|
61
|
+
export declare function compileDemo(esbuild: EsbuildLike, request: CompileRequest, options?: CompileOptions): Promise<CompileResult>;
|
|
62
|
+
/** One-line-per-error text for overlays and logs. */
|
|
63
|
+
export declare function formatCompileErrors(errors: CompileMessage[]): string;
|
|
64
|
+
//# sourceMappingURL=core.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"core.d.ts","sourceRoot":"","sources":["../../../src/demos/compile/core.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,KAAK,KAAK,YAAY,MAAM,SAAS,CAAC;AAE7C,MAAM,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO,YAAY,EAAE,OAAO,CAAC,CAAC;AAE7D,MAAM,MAAM,cAAc,GAAG;IAC3B,2EAA2E;IAC3E,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC9B,yCAAyC;IACzC,KAAK,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IAC3B,0EAA0E;IAC1E,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,2EAA2E;IAC3E,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,oFAAoF;IACpF,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,aAAa,GACrB;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,cAAc,EAAE,CAAA;CAAE,GACjE;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,cAAc,EAAE,CAAA;CAAE,CAAC;AAE5C,MAAM,WAAW,QAAQ;IACvB,OAAO,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;IACzD,OAAO,CAAC,IAAI,IAAI,CAAC;CAClB;AAED,qEAAqE;AACrE,eAAO,MAAM,kBAAkB,UAA8D,CAAC;AAK9F,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAE1D;AAED,wBAAgB,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,GAAG,SAAS,GAAG,OAAO,CAEzF;AAED,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,YAAY,CAAC,MAAM,CAsBnE;AAiBD,wBAAgB,cAAc,CAC5B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC7B,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,GAChB,MAAM,GAAG,IAAI,CASf;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,WAAW,EAAE,MAAM,EAAE,GAAG,SAAS,GAAG,YAAY,CAAC,MAAM,CAY5F;AA0CD,+EAA+E;AAC/E,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,cAAc,GAAG,YAAY,CAAC,YAAY,CAYnF;AAED,wBAAsB,WAAW,CAC/B,OAAO,EAAE,WAAW,EACpB,OAAO,EAAE,cAAc,EACvB,OAAO,GAAE,cAAmB,GAC3B,OAAO,CAAC,aAAa,CAAC,CAuBxB;AAED,qDAAqD;AACrD,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,cAAc,EAAE,GAAG,MAAM,CAQpE"}
|
|
@@ -0,0 +1,174 @@
|
|
|
1
|
+
/** Extensions tried for extensionless relative imports, in order. */
|
|
2
|
+
export const RESOLVE_EXTENSIONS = ['', '.tsx', '.ts', '.jsx', '.js', '.mjs', '.css', '.json'];
|
|
3
|
+
const VFS = 'docs-kit-vfs';
|
|
4
|
+
const STUB = 'docs-kit-stub';
|
|
5
|
+
export function isBareSpecifier(specifier) {
|
|
6
|
+
return !/^(?:\.{1,2}\/|\/|[a-z][a-z0-9+.-]*:)/i.test(specifier);
|
|
7
|
+
}
|
|
8
|
+
export function matchesStub(specifier, stubImports) {
|
|
9
|
+
return !!stubImports?.some((source) => new RegExp(source).test(specifier));
|
|
10
|
+
}
|
|
11
|
+
export function loaderForPath(filePath) {
|
|
12
|
+
if (/\.module\.css$/.test(filePath))
|
|
13
|
+
return 'local-css';
|
|
14
|
+
const ext = /\.([a-z0-9]+)$/i.exec(filePath)?.[1]?.toLowerCase();
|
|
15
|
+
switch (ext) {
|
|
16
|
+
case 'ts':
|
|
17
|
+
case 'mts':
|
|
18
|
+
case 'cts':
|
|
19
|
+
return 'ts';
|
|
20
|
+
case 'tsx':
|
|
21
|
+
return 'tsx';
|
|
22
|
+
case 'js':
|
|
23
|
+
case 'mjs':
|
|
24
|
+
case 'cjs':
|
|
25
|
+
case 'jsx':
|
|
26
|
+
return 'jsx';
|
|
27
|
+
case 'css':
|
|
28
|
+
return 'css';
|
|
29
|
+
case 'json':
|
|
30
|
+
return 'json';
|
|
31
|
+
default:
|
|
32
|
+
return 'text';
|
|
33
|
+
}
|
|
34
|
+
}
|
|
35
|
+
function normalize(filePath) {
|
|
36
|
+
const out = [];
|
|
37
|
+
for (const segment of filePath.split('/')) {
|
|
38
|
+
if (!segment || segment === '.')
|
|
39
|
+
continue;
|
|
40
|
+
if (segment === '..')
|
|
41
|
+
out.pop();
|
|
42
|
+
else
|
|
43
|
+
out.push(segment);
|
|
44
|
+
}
|
|
45
|
+
return out.join('/');
|
|
46
|
+
}
|
|
47
|
+
function dirname(filePath) {
|
|
48
|
+
const index = filePath.lastIndexOf('/');
|
|
49
|
+
return index === -1 ? '' : filePath.slice(0, index);
|
|
50
|
+
}
|
|
51
|
+
export function resolveInFiles(files, fromFile, specifier) {
|
|
52
|
+
const base = normalize(`${dirname(fromFile)}/${specifier}`);
|
|
53
|
+
for (const ext of RESOLVE_EXTENSIONS) {
|
|
54
|
+
if (Object.hasOwn(files, base + ext))
|
|
55
|
+
return base + ext;
|
|
56
|
+
}
|
|
57
|
+
for (const ext of RESOLVE_EXTENSIONS.slice(1)) {
|
|
58
|
+
if (Object.hasOwn(files, `${base}/index${ext}`))
|
|
59
|
+
return `${base}/index${ext}`;
|
|
60
|
+
}
|
|
61
|
+
return null;
|
|
62
|
+
}
|
|
63
|
+
/**
|
|
64
|
+
* Externalizes bare imports and stubs `stubImports`. Used by the prebuild
|
|
65
|
+
* (real files) and by `compileDemo` (virtual files), so both agree on what
|
|
66
|
+
* the import map provides.
|
|
67
|
+
*/
|
|
68
|
+
export function externalImportsPlugin(stubImports) {
|
|
69
|
+
return {
|
|
70
|
+
name: 'docs-kit:external-imports',
|
|
71
|
+
setup(build) {
|
|
72
|
+
build.onResolve({ filter: /.*/ }, (args) => {
|
|
73
|
+
if (args.kind === 'entry-point' || !isBareSpecifier(args.path))
|
|
74
|
+
return undefined;
|
|
75
|
+
if (matchesStub(args.path, stubImports))
|
|
76
|
+
return { path: args.path, namespace: STUB };
|
|
77
|
+
return { path: args.path, external: true };
|
|
78
|
+
});
|
|
79
|
+
build.onLoad({ filter: /.*/, namespace: STUB }, () => ({ contents: '', loader: 'js' }));
|
|
80
|
+
},
|
|
81
|
+
};
|
|
82
|
+
}
|
|
83
|
+
function virtualFilesPlugin(request) {
|
|
84
|
+
return {
|
|
85
|
+
name: 'docs-kit:virtual-files',
|
|
86
|
+
setup(build) {
|
|
87
|
+
build.onResolve({ filter: /.*/ }, (args) => {
|
|
88
|
+
if (args.kind === 'entry-point') {
|
|
89
|
+
const entry = normalize(args.path);
|
|
90
|
+
if (!Object.hasOwn(request.files, entry)) {
|
|
91
|
+
return { errors: [{ text: `Entry file "${args.path}" is missing` }] };
|
|
92
|
+
}
|
|
93
|
+
return { path: entry, namespace: VFS };
|
|
94
|
+
}
|
|
95
|
+
if (isBareSpecifier(args.path))
|
|
96
|
+
return undefined;
|
|
97
|
+
if (args.namespace !== VFS || !/^\.\.?\//.test(args.path)) {
|
|
98
|
+
return { errors: [{ text: `Only relative imports between demo files are supported: "${args.path}"` }] };
|
|
99
|
+
}
|
|
100
|
+
const resolved = resolveInFiles(request.files, args.importer, args.path);
|
|
101
|
+
if (!resolved) {
|
|
102
|
+
return { errors: [{ text: `Cannot resolve "${args.path}" from ${args.importer}` }] };
|
|
103
|
+
}
|
|
104
|
+
return { path: resolved, namespace: VFS };
|
|
105
|
+
});
|
|
106
|
+
build.onLoad({ filter: /.*/, namespace: VFS }, (args) => ({
|
|
107
|
+
contents: request.files[args.path],
|
|
108
|
+
loader: loaderForPath(args.path),
|
|
109
|
+
}));
|
|
110
|
+
},
|
|
111
|
+
};
|
|
112
|
+
}
|
|
113
|
+
function toMessage(message) {
|
|
114
|
+
return {
|
|
115
|
+
text: message.text,
|
|
116
|
+
file: message.location?.file,
|
|
117
|
+
line: message.location?.line,
|
|
118
|
+
column: message.location?.column,
|
|
119
|
+
lineText: message.location?.lineText,
|
|
120
|
+
};
|
|
121
|
+
}
|
|
122
|
+
/** Shared esbuild options for demo code (prebuild and in-browser rebuilds). */
|
|
123
|
+
export function demoBuildOptions(options) {
|
|
124
|
+
return {
|
|
125
|
+
bundle: true,
|
|
126
|
+
format: 'esm',
|
|
127
|
+
platform: 'browser',
|
|
128
|
+
target: 'es2022',
|
|
129
|
+
jsx: 'automatic',
|
|
130
|
+
define: options.define,
|
|
131
|
+
minify: options.minify,
|
|
132
|
+
legalComments: 'none',
|
|
133
|
+
logLevel: 'silent',
|
|
134
|
+
};
|
|
135
|
+
}
|
|
136
|
+
export async function compileDemo(esbuild, request, options = {}) {
|
|
137
|
+
try {
|
|
138
|
+
const result = await esbuild.build({
|
|
139
|
+
...demoBuildOptions(options),
|
|
140
|
+
entryPoints: [request.entry],
|
|
141
|
+
outdir: '/out',
|
|
142
|
+
write: false,
|
|
143
|
+
sourcemap: options.sourcemap === false ? false : 'inline',
|
|
144
|
+
// Edited code may be mid-typing; keep going and report everything.
|
|
145
|
+
plugins: [externalImportsPlugin(options.stubImports), virtualFilesPlugin(request)],
|
|
146
|
+
});
|
|
147
|
+
let js = '';
|
|
148
|
+
let css = '';
|
|
149
|
+
for (const file of result.outputFiles ?? []) {
|
|
150
|
+
if (file.path.endsWith('.js'))
|
|
151
|
+
js += file.text;
|
|
152
|
+
else if (file.path.endsWith('.css'))
|
|
153
|
+
css += file.text;
|
|
154
|
+
}
|
|
155
|
+
return { ok: true, js, css, warnings: result.warnings.map(toMessage) };
|
|
156
|
+
}
|
|
157
|
+
catch (error) {
|
|
158
|
+
const failure = error;
|
|
159
|
+
if (failure.errors?.length)
|
|
160
|
+
return { ok: false, errors: failure.errors.map(toMessage) };
|
|
161
|
+
return { ok: false, errors: [{ text: failure.message ?? String(error) }] };
|
|
162
|
+
}
|
|
163
|
+
}
|
|
164
|
+
/** One-line-per-error text for overlays and logs. */
|
|
165
|
+
export function formatCompileErrors(errors) {
|
|
166
|
+
return errors
|
|
167
|
+
.map((error) => {
|
|
168
|
+
const where = error.file ? `${error.file}${error.line ? `:${error.line}:${(error.column ?? 0) + 1}` : ''}: ` : '';
|
|
169
|
+
const code = error.lineText ? `\n ${error.lineText}` : '';
|
|
170
|
+
return `${where}${error.text}${code}`;
|
|
171
|
+
})
|
|
172
|
+
.join('\n\n');
|
|
173
|
+
}
|
|
174
|
+
//# sourceMappingURL=core.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"core.js","sourceRoot":"","sources":["../../../src/demos/compile/core.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,108 @@
|
|
|
1
|
+
import type { Plugin } from 'esbuild';
|
|
2
|
+
import type { CompilerConfig } from './client.ts';
|
|
3
|
+
import type { CompileOptions } from './compile/core.ts';
|
|
4
|
+
/** A package the demos import that is built from source instead of `node_modules`. */
|
|
5
|
+
export type LibrarySource = {
|
|
6
|
+
/** Entry module (absolute, or relative to the site root). */
|
|
7
|
+
entry: string;
|
|
8
|
+
/** esbuild plugins for this library (e.g. vanilla-extract, sibling-file resolution). */
|
|
9
|
+
plugins?: () => Plugin[] | Promise<Plugin[]>;
|
|
10
|
+
/** Folders to watch in `--watch` mode. Default: the entry's folder. */
|
|
11
|
+
watch?: string[];
|
|
12
|
+
};
|
|
13
|
+
export type ForkConfig = {
|
|
14
|
+
/** `dependencies` of the forked sandbox's package.json (the published versions to pin). */
|
|
15
|
+
dependencies?: Record<string, string>;
|
|
16
|
+
devDependencies?: Record<string, string>;
|
|
17
|
+
/** Code placed at the top of the sandbox entry (`src/index.tsx`), e.g. CSS imports. */
|
|
18
|
+
entryPrelude?: string;
|
|
19
|
+
/** Extra CSS for the sandbox (`src/styles.css`). */
|
|
20
|
+
styles?: string;
|
|
21
|
+
/** Literal replacements applied to forked files (on top of `sourceReplacements`). */
|
|
22
|
+
sourceReplacements?: Record<string, string>;
|
|
23
|
+
};
|
|
24
|
+
export type DocsKitConfig = {
|
|
25
|
+
/** Site root; relative paths below resolve against it. Default: the config file's folder. */
|
|
26
|
+
root?: string;
|
|
27
|
+
/** Default `content`. */
|
|
28
|
+
contentDir?: string;
|
|
29
|
+
/** Where the iframe bundles go. Default `public/gen/demos`. */
|
|
30
|
+
outDir?: string;
|
|
31
|
+
/** Public URL of `outDir`. Default `/gen/demos`. */
|
|
32
|
+
urlRoot?: string;
|
|
33
|
+
/** Demo entry suffix. Default `.demo.tsx`. */
|
|
34
|
+
demoSuffix?: string;
|
|
35
|
+
/** Page files (for the "see example in docs" link of a standalone demo). Default `.page.md`. */
|
|
36
|
+
pageExtension?: string;
|
|
37
|
+
/** Prefix of the docs card anchors (the `<Demo>` context's `anchorPrefix`). Default `''`. */
|
|
38
|
+
anchorPrefix?: string;
|
|
39
|
+
/** Content-relative page path (without extension) → route. Default: `/<path>`, `index` dropped. */
|
|
40
|
+
routeForPage?: (pagePath: string) => string;
|
|
41
|
+
/** Only `react` for now. */
|
|
42
|
+
framework?: 'react';
|
|
43
|
+
/** Packages built from source, keyed by import specifier. */
|
|
44
|
+
libraries?: Record<string, LibrarySource>;
|
|
45
|
+
/** Bare specifiers always put in the import map, on top of what demos import. */
|
|
46
|
+
include?: string[];
|
|
47
|
+
/** Bare imports (strings or regexes) that compile to nothing, e.g. the library CSS. */
|
|
48
|
+
stubImports?: (string | RegExp)[];
|
|
49
|
+
/** esbuild `define` for the libraries, the runtime and every demo (and browser rebuilds). */
|
|
50
|
+
define?: Record<string, string>;
|
|
51
|
+
/** Extra `define`s for the site bootstrap module only (kept out of the public manifest). */
|
|
52
|
+
bootstrapDefine?: Record<string, string>;
|
|
53
|
+
/** Literal replacements for shown, edited and forked code. */
|
|
54
|
+
sourceReplacements?: Record<string, string>;
|
|
55
|
+
/** Module exporting the `SiteBootstrap` hooks (`setup`, `applyTheme`). */
|
|
56
|
+
bootstrap?: string;
|
|
57
|
+
/** Stylesheets linked in every demo (copied and hashed). */
|
|
58
|
+
css?: string[];
|
|
59
|
+
/** Extra CSS for the demo page. */
|
|
60
|
+
pageStyle?: string;
|
|
61
|
+
/** localStorage key of the docs theme; demos opened standalone fall back to it. */
|
|
62
|
+
themeStorageKey?: string;
|
|
63
|
+
defaultTheme?: 'light' | 'dark';
|
|
64
|
+
/** Classes put on the demo page's `<html>` per theme (before paint and on every theme change). */
|
|
65
|
+
themeClasses?: {
|
|
66
|
+
light?: string[];
|
|
67
|
+
dark?: string[];
|
|
68
|
+
};
|
|
69
|
+
/** Extra `node_modules` folders to resolve packages from. Default: `<root>/node_modules`. */
|
|
70
|
+
nodePaths?: string[];
|
|
71
|
+
/** Compile-on-edit: `browser` (default, esbuild-wasm worker) or `remote`. */
|
|
72
|
+
compiler?: {
|
|
73
|
+
kind: 'browser';
|
|
74
|
+
} | {
|
|
75
|
+
kind: 'remote';
|
|
76
|
+
endpoint: string;
|
|
77
|
+
};
|
|
78
|
+
fork?: ForkConfig;
|
|
79
|
+
/** Port of the dev-events SSE stream in `--watch` mode. Default 4748. */
|
|
80
|
+
devEventsPort?: number;
|
|
81
|
+
/** Minify and use production `NODE_ENV`. Default: `NODE_ENV === 'production'`. */
|
|
82
|
+
production?: boolean;
|
|
83
|
+
};
|
|
84
|
+
export type DemoManifestEntry = {
|
|
85
|
+
/** Standalone page, e.g. `/gen/demos/docs/x/basic/index.html`. */
|
|
86
|
+
html: string;
|
|
87
|
+
};
|
|
88
|
+
/** Written to `<outDir>/manifest.json`; the only thing the docs UI reads from the build. */
|
|
89
|
+
export type DemoManifest = {
|
|
90
|
+
version: 1;
|
|
91
|
+
framework: 'react';
|
|
92
|
+
urlRoot: string;
|
|
93
|
+
demoSuffix: string;
|
|
94
|
+
importMap: {
|
|
95
|
+
imports: Record<string, string>;
|
|
96
|
+
};
|
|
97
|
+
editor: {
|
|
98
|
+
compiler: CompilerConfig;
|
|
99
|
+
options: CompileOptions;
|
|
100
|
+
};
|
|
101
|
+
sourceReplacements: Record<string, string>;
|
|
102
|
+
fork: ForkConfig;
|
|
103
|
+
/** Dev only: SSE endpoint that reports rebuilt demos. */
|
|
104
|
+
devEvents?: string;
|
|
105
|
+
demos: Record<string, DemoManifestEntry>;
|
|
106
|
+
};
|
|
107
|
+
export declare function defineConfig(config: DocsKitConfig): DocsKitConfig;
|
|
108
|
+
//# sourceMappingURL=config.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/demos/config.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/demos/config.ts"],"names":[],"mappings":"AAuGA,MAAM,UAAU,YAAY,CAAC,MAAqB;IAChD,OAAO,MAAM,CAAC;AAChB,CAAC"}
|
|
@@ -0,0 +1,13 @@
|
|
|
1
|
+
export type DevEvent = {
|
|
2
|
+
type: 'demo';
|
|
3
|
+
id: string;
|
|
4
|
+
url: string;
|
|
5
|
+
} | {
|
|
6
|
+
type: 'build-error';
|
|
7
|
+
message: string;
|
|
8
|
+
};
|
|
9
|
+
export declare function startDevEvents(port: number, log: (message: string) => void): {
|
|
10
|
+
send(event: DevEvent): void;
|
|
11
|
+
close(): void;
|
|
12
|
+
};
|
|
13
|
+
//# sourceMappingURL=devEvents.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"devEvents.d.ts","sourceRoot":"","sources":["../../src/demos/devEvents.ts"],"names":[],"mappings":"AAOA,MAAM,MAAM,QAAQ,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAE5G,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI;gBAyB3D,QAAQ;;EAUvB"}
|
|
@@ -0,0 +1,45 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Dev-only server-sent events: the watcher reports rebuilt demo pages so open
|
|
3
|
+
* iframes reload (`{ type: 'demo', id, url }`). Folded into the watch process
|
|
4
|
+
* (ADG ran it as a separate `dev-events.mjs`).
|
|
5
|
+
*/
|
|
6
|
+
import http from 'node:http';
|
|
7
|
+
export function startDevEvents(port, log) {
|
|
8
|
+
const clients = new Set();
|
|
9
|
+
const server = http.createServer((req, res) => {
|
|
10
|
+
if (req.url !== '/events') {
|
|
11
|
+
res.writeHead(404).end();
|
|
12
|
+
return;
|
|
13
|
+
}
|
|
14
|
+
res.writeHead(200, {
|
|
15
|
+
'content-type': 'text/event-stream',
|
|
16
|
+
'cache-control': 'no-store',
|
|
17
|
+
connection: 'keep-alive',
|
|
18
|
+
'access-control-allow-origin': '*',
|
|
19
|
+
});
|
|
20
|
+
res.write(': connected\n\n');
|
|
21
|
+
clients.add(res);
|
|
22
|
+
req.on('close', () => clients.delete(res));
|
|
23
|
+
});
|
|
24
|
+
server.on('error', (error) => log(`dev events unavailable on port ${port}: ${error.message}`));
|
|
25
|
+
server.listen(port, () => log(`dev events on http://localhost:${port}/events`));
|
|
26
|
+
const ping = setInterval(() => {
|
|
27
|
+
for (const res of clients)
|
|
28
|
+
res.write(': ping\n\n');
|
|
29
|
+
}, 30_000);
|
|
30
|
+
ping.unref();
|
|
31
|
+
return {
|
|
32
|
+
send(event) {
|
|
33
|
+
const data = `data: ${JSON.stringify(event)}\n\n`;
|
|
34
|
+
for (const res of clients)
|
|
35
|
+
res.write(data);
|
|
36
|
+
},
|
|
37
|
+
close() {
|
|
38
|
+
clearInterval(ping);
|
|
39
|
+
for (const res of clients)
|
|
40
|
+
res.end();
|
|
41
|
+
server.close();
|
|
42
|
+
},
|
|
43
|
+
};
|
|
44
|
+
}
|
|
45
|
+
//# sourceMappingURL=devEvents.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"devEvents.js","sourceRoot":"","sources":["../../src/demos/devEvents.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,IAAI,MAAM,WAAW,CAAC;AAI7B,MAAM,UAAU,cAAc,CAAC,IAAY,EAAE,GAA8B;IACzE,MAAM,OAAO,GAAG,IAAI,GAAG,EAAuB,CAAC;IAC/C,MAAM,MAAM,GAAG,IAAI,CAAC,YAAY,CAAC,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE;QAC5C,IAAI,GAAG,CAAC,GAAG,KAAK,SAAS,EAAE,CAAC;YAC1B,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,CAAC;YACzB,OAAO;QACT,CAAC;QACD,GAAG,CAAC,SAAS,CAAC,GAAG,EAAE;YACjB,cAAc,EAAE,mBAAmB;YACnC,eAAe,EAAE,UAAU;YAC3B,UAAU,EAAE,YAAY;YACxB,6BAA6B,EAAE,GAAG;SACnC,CAAC,CAAC;QACH,GAAG,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC;QAC7B,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACjB,GAAG,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;IAC7C,CAAC,CAAC,CAAC;IACH,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,GAAG,CAAC,kCAAkC,IAAI,KAAK,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;IAC/F,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,kCAAkC,IAAI,SAAS,CAAC,CAAC,CAAC;IAChF,MAAM,IAAI,GAAG,WAAW,CAAC,GAAG,EAAE;QAC5B,KAAK,MAAM,GAAG,IAAI,OAAO;YAAE,GAAG,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;IACrD,CAAC,EAAE,MAAM,CAAC,CAAC;IACX,IAAI,CAAC,KAAK,EAAE,CAAC;IAEb,OAAO;QACL,IAAI,CAAC,KAAe;YAClB,MAAM,IAAI,GAAG,SAAS,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,MAAM,CAAC;YAClD,KAAK,MAAM,GAAG,IAAI,OAAO;gBAAE,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC7C,CAAC;QACD,KAAK;YACH,aAAa,CAAC,IAAI,CAAC,CAAC;YACpB,KAAK,MAAM,GAAG,IAAI,OAAO;gBAAE,GAAG,CAAC,GAAG,EAAE,CAAC;YACrC,MAAM,CAAC,KAAK,EAAE,CAAC;QACjB,CAAC;KACF,CAAC;AACJ,CAAC"}
|
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
export type ThemeClasses = {
|
|
2
|
+
light?: string[];
|
|
3
|
+
dark?: string[];
|
|
4
|
+
};
|
|
5
|
+
/** Theme before paint: `?theme=`, then the docs site's localStorage key, then the OS scheme. */
|
|
6
|
+
export declare function themeInitScript(storageKey: string | undefined, defaultTheme: string, classes: ThemeClasses): string;
|
|
7
|
+
export declare function demoPageHtml(options: {
|
|
8
|
+
title: string;
|
|
9
|
+
importMap: {
|
|
10
|
+
imports: Record<string, string>;
|
|
11
|
+
};
|
|
12
|
+
cssUrls: string[];
|
|
13
|
+
demoCssUrls: string[];
|
|
14
|
+
preload: string[];
|
|
15
|
+
runtimeUrl: string;
|
|
16
|
+
moduleUrl: string;
|
|
17
|
+
docsHref: string | null;
|
|
18
|
+
themeScript: string;
|
|
19
|
+
pageStyle?: string;
|
|
20
|
+
}): string;
|
|
21
|
+
//# sourceMappingURL=html.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"html.d.ts","sourceRoot":"","sources":["../../src/demos/html.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,YAAY,GAAG;IAAE,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC;AAQjE,gGAAgG;AAChG,wBAAgB,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,EAAE,YAAY,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,UAM1G;AAED,wBAAgB,YAAY,CAAC,OAAO,EAAE;IACpC,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;KAAE,CAAC;IAC/C,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,UA2CA"}
|
|
@@ -0,0 +1,57 @@
|
|
|
1
|
+
import { OVERLAY_CSS } from "./runtime/iframe.js";
|
|
2
|
+
const escapeHtml = (text) => text.replace(/&/g, '&').replace(/</g, '<').replace(/>/g, '>').replace(/"/g, '"');
|
|
3
|
+
/** `</script>` can't appear inside an inline script. */
|
|
4
|
+
const scriptJson = (value) => JSON.stringify(value).replace(/</g, '\\u003c');
|
|
5
|
+
/** Theme before paint: `?theme=`, then the docs site's localStorage key, then the OS scheme. */
|
|
6
|
+
export function themeInitScript(storageKey, defaultTheme, classes) {
|
|
7
|
+
return `(function(){try{var p=new URLSearchParams(location.search),t=p.get('theme');` +
|
|
8
|
+
`if(t!=='dark'&&t!=='light'){t=${storageKey ? `localStorage.getItem(${scriptJson(storageKey)})` : 'null'}}` +
|
|
9
|
+
`if(t!=='dark'&&t!=='light'){t=window.matchMedia&&matchMedia('(prefers-color-scheme: dark)').matches?'dark':${scriptJson(defaultTheme)}}` +
|
|
10
|
+
`var e=document.documentElement;e.setAttribute('data-theme',t);e.style.colorScheme=t;` +
|
|
11
|
+
`var c=${scriptJson(classes)}[t]||[];for(var i=0;i<c.length;i++)e.classList.add(c[i])}catch(x){}})();`;
|
|
12
|
+
}
|
|
13
|
+
export function demoPageHtml(options) {
|
|
14
|
+
const docsLink = options.docsHref
|
|
15
|
+
? `<div id="dk-docs-link"><a href="${escapeHtml(options.docsHref)}" target="_top">See this example in the docs</a>` +
|
|
16
|
+
`<button type="button" aria-label="Dismiss" title="Dismiss">×</button></div>` +
|
|
17
|
+
`<script>(function(){if(window.self!==window.top)return;var el=document.getElementById('dk-docs-link');` +
|
|
18
|
+
`el.style.display='inline-flex';el.querySelector('button').addEventListener('click',function(){el.remove()})})();</script>`
|
|
19
|
+
: '';
|
|
20
|
+
return `<!doctype html>
|
|
21
|
+
<html>
|
|
22
|
+
<head>
|
|
23
|
+
<meta charset="utf-8" />
|
|
24
|
+
<meta name="viewport" content="width=device-width, initial-scale=1" />
|
|
25
|
+
<title>${escapeHtml(options.title)}</title>
|
|
26
|
+
<script>${options.themeScript}</script>
|
|
27
|
+
<script type="importmap">${scriptJson(options.importMap)}</script>
|
|
28
|
+
${options.preload.map((url) => ` <link rel="modulepreload" href="${escapeHtml(url)}" />`).join('\n')}
|
|
29
|
+
${options.cssUrls.map((url) => ` <link rel="stylesheet" href="${escapeHtml(url)}" />`).join('\n')}
|
|
30
|
+
${options.demoCssUrls.map((url) => ` <link rel="stylesheet" data-demo-css href="${escapeHtml(url)}" />`).join('\n')}
|
|
31
|
+
<style>
|
|
32
|
+
html, body, #root { height: 100%; margin: 0; }
|
|
33
|
+
body { font-family: system-ui, -apple-system, 'Segoe UI', Roboto, sans-serif; }
|
|
34
|
+
* { box-sizing: border-box; }
|
|
35
|
+
#root { display: flex; flex-flow: column; overflow: hidden; }
|
|
36
|
+
#dk-docs-link { display: none; position: fixed; right: 12px; bottom: 12px; z-index: 2147483000;
|
|
37
|
+
align-items: center; gap: 10px; padding: 12px 20px; border-radius: 9999px;
|
|
38
|
+
font: 500 12px/1.4 system-ui, sans-serif; background: rgba(23, 23, 23, 0.85); color: #fff; }
|
|
39
|
+
#dk-docs-link a { color: inherit; text-decoration: none; }
|
|
40
|
+
#dk-docs-link a:hover { text-decoration: underline; }
|
|
41
|
+
#dk-docs-link button { all: unset; cursor: pointer; font-size: 16px; line-height: 1; opacity: 0.7; }
|
|
42
|
+
${OVERLAY_CSS}
|
|
43
|
+
${options.pageStyle ?? ''}
|
|
44
|
+
</style>
|
|
45
|
+
</head>
|
|
46
|
+
<body>
|
|
47
|
+
<div id="root"></div>
|
|
48
|
+
${docsLink}
|
|
49
|
+
<script type="module">
|
|
50
|
+
import { mount, fail } from ${scriptJson(options.runtimeUrl)};
|
|
51
|
+
import(${scriptJson(options.moduleUrl)}).then((mod) => mount(mod.default), fail);
|
|
52
|
+
</script>
|
|
53
|
+
</body>
|
|
54
|
+
</html>
|
|
55
|
+
`;
|
|
56
|
+
}
|
|
57
|
+
//# sourceMappingURL=html.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"html.js","sourceRoot":"","sources":["../../src/demos/html.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAIlD,MAAM,UAAU,GAAG,CAAC,IAAY,EAAE,EAAE,CAClC,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;AAElG,wDAAwD;AACxD,MAAM,UAAU,GAAG,CAAC,KAAc,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;AAEtF,gGAAgG;AAChG,MAAM,UAAU,eAAe,CAAC,UAA8B,EAAE,YAAoB,EAAE,OAAqB;IACzG,OAAO,8EAA8E;QACnF,iCAAiC,UAAU,CAAC,CAAC,CAAC,wBAAwB,UAAU,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,GAAG;QAC3G,8GAA8G,UAAU,CAAC,YAAY,CAAC,GAAG;QACzI,sFAAsF;QACtF,SAAS,UAAU,CAAC,OAAO,CAAC,0EAA0E,CAAC;AAC3G,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,OAW5B;IACC,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ;QAC/B,CAAC,CAAC,mCAAmC,UAAU,CAAC,OAAO,CAAC,QAAQ,CAAC,kDAAkD;YACjH,mFAAmF;YACnF,wGAAwG;YACxG,2HAA2H;QAC7H,CAAC,CAAC,EAAE,CAAC;IACP,OAAO;;;;;aAKI,UAAU,CAAC,OAAO,CAAC,KAAK,CAAC;cACxB,OAAO,CAAC,WAAW;+BACF,UAAU,CAAC,OAAO,CAAC,SAAS,CAAC;EAC1D,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,uCAAuC,UAAU,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;EACrG,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,oCAAoC,UAAU,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;EAClG,OAAO,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,kDAAkD,UAAU,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;;;;;;;;;;;;QAY9G,WAAW;QACX,OAAO,CAAC,SAAS,IAAI,EAAE;;;;;MAKzB,QAAQ;;oCAEsB,UAAU,CAAC,OAAO,CAAC,UAAU,CAAC;eACnD,UAAU,CAAC,OAAO,CAAC,SAAS,CAAC;;;;CAI3C,CAAC;AACF,CAAC"}
|
|
@@ -0,0 +1,8 @@
|
|
|
1
|
+
export { buildDemos, type BuildDemosOptions, type BuildDemosResult } from './build.ts';
|
|
2
|
+
export { defineConfig, type DemoManifest, type DemoManifestEntry, type DocsKitConfig, type ForkConfig, type LibrarySource, } from './config.ts';
|
|
3
|
+
export { compileDemo, demoBuildOptions, externalImportsPlugin, formatCompileErrors, type CompileMessage, type CompileOptions, type CompileRequest, type CompileResult, type Compiler, type EsbuildLike, } from './compile/core.ts';
|
|
4
|
+
export type { CompilerConfig } from './client.ts';
|
|
5
|
+
export type { DemoAdapter, DocsTheme, SiteBootstrap } from './runtime/iframe.ts';
|
|
6
|
+
export { slugifyDemoTitle } from './slug.ts';
|
|
7
|
+
export { defaultRouteForPage } from './pages.ts';
|
|
8
|
+
//# sourceMappingURL=index.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/demos/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,KAAK,iBAAiB,EAAE,KAAK,gBAAgB,EAAE,MAAM,YAAY,CAAC;AACvF,OAAO,EACL,YAAY,EACZ,KAAK,YAAY,EACjB,KAAK,iBAAiB,EACtB,KAAK,aAAa,EAClB,KAAK,UAAU,EACf,KAAK,aAAa,GACnB,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,WAAW,EACX,gBAAgB,EAChB,qBAAqB,EACrB,mBAAmB,EACnB,KAAK,cAAc,EACnB,KAAK,cAAc,EACnB,KAAK,cAAc,EACnB,KAAK,aAAa,EAClB,KAAK,QAAQ,EACb,KAAK,WAAW,GACjB,MAAM,mBAAmB,CAAC;AAC3B,YAAY,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAClD,YAAY,EAAE,WAAW,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACjF,OAAO,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC"}
|
|
@@ -0,0 +1,6 @@
|
|
|
1
|
+
export { buildDemos } from "./build.js";
|
|
2
|
+
export { defineConfig, } from "./config.js";
|
|
3
|
+
export { compileDemo, demoBuildOptions, externalImportsPlugin, formatCompileErrors, } from "./compile/core.js";
|
|
4
|
+
export { slugifyDemoTitle } from "./slug.js";
|
|
5
|
+
export { defaultRouteForPage } from "./pages.js";
|
|
6
|
+
//# sourceMappingURL=index.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/demos/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAiD,MAAM,YAAY,CAAC;AACvF,OAAO,EACL,YAAY,GAMb,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,WAAW,EACX,gBAAgB,EAChB,qBAAqB,EACrB,mBAAmB,GAOpB,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC"}
|