@terra-symposium/docs 0.0.0-stage → 0.1.17
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/LICENSE +201 -0
- package/README.md +72 -2
- package/lib-dist/Docs.d.ts +22 -0
- package/lib-dist/Docs.d.ts.map +1 -0
- package/lib-dist/Docs.js +60 -0
- package/lib-dist/Docs.js.map +1 -0
- package/lib-dist/LocalDocsWorkspace.d.ts +30 -0
- package/lib-dist/LocalDocsWorkspace.d.ts.map +1 -0
- package/lib-dist/LocalDocsWorkspace.js +148 -0
- package/lib-dist/LocalDocsWorkspace.js.map +1 -0
- package/lib-dist/SiteLayout.d.ts +30 -0
- package/lib-dist/SiteLayout.d.ts.map +1 -0
- package/lib-dist/SiteLayout.js +34 -0
- package/lib-dist/SiteLayout.js.map +1 -0
- package/lib-dist/StaticWorkspace.d.ts +21 -0
- package/lib-dist/StaticWorkspace.d.ts.map +1 -0
- package/lib-dist/StaticWorkspace.js +179 -0
- package/lib-dist/StaticWorkspace.js.map +1 -0
- package/lib-dist/_Toolbar.d.ts +7 -0
- package/lib-dist/_Toolbar.d.ts.map +1 -0
- package/lib-dist/_Toolbar.js +85 -0
- package/lib-dist/_Toolbar.js.map +1 -0
- package/lib-dist/blocks.d.ts +23 -0
- package/lib-dist/blocks.d.ts.map +1 -0
- package/lib-dist/blocks.js +321 -0
- package/lib-dist/blocks.js.map +1 -0
- package/lib-dist/docs-catalog.d.ts +5 -0
- package/lib-dist/docs-catalog.d.ts.map +1 -0
- package/lib-dist/docs-catalog.js +38 -0
- package/lib-dist/docs-catalog.js.map +1 -0
- package/lib-dist/docs-style.css +31 -0
- package/lib-dist/fonts/Avara-Bold.woff2 +0 -0
- package/lib-dist/fonts/Avara-BoldItalic.woff2 +0 -0
- package/lib-dist/fonts/OFL-1.1.txt +93 -0
- package/lib-dist/fonts/README.md +5 -0
- package/lib-dist/host-runtime.d.ts +5 -0
- package/lib-dist/host-runtime.d.ts.map +1 -0
- package/lib-dist/host-runtime.js +21 -0
- package/lib-dist/host-runtime.js.map +1 -0
- package/lib-dist/host.d.ts +170 -0
- package/lib-dist/host.d.ts.map +1 -0
- package/lib-dist/host.js +2 -0
- package/lib-dist/host.js.map +1 -0
- package/lib-dist/index.d.ts +35 -0
- package/lib-dist/index.d.ts.map +1 -0
- package/lib-dist/index.js +28 -0
- package/lib-dist/index.js.map +1 -0
- package/lib-dist/markdown-model.d.ts +7 -0
- package/lib-dist/markdown-model.d.ts.map +1 -0
- package/lib-dist/markdown-model.js +181 -0
- package/lib-dist/markdown-model.js.map +1 -0
- package/lib-dist/markdown.d.ts +3 -0
- package/lib-dist/markdown.d.ts.map +1 -0
- package/lib-dist/markdown.js +83 -0
- package/lib-dist/markdown.js.map +1 -0
- package/lib-dist/navigation.d.ts +17 -0
- package/lib-dist/navigation.d.ts.map +1 -0
- package/lib-dist/navigation.js +9 -0
- package/lib-dist/navigation.js.map +1 -0
- package/lib-dist/schema.d.ts +135 -0
- package/lib-dist/schema.d.ts.map +1 -0
- package/lib-dist/schema.js +55 -0
- package/lib-dist/schema.js.map +1 -0
- package/lib-dist/style.css +1 -0
- package/lib-dist/terra/Workspace.d.ts +5 -0
- package/lib-dist/terra/Workspace.d.ts.map +1 -0
- package/lib-dist/terra/Workspace.js +9 -0
- package/lib-dist/terra/Workspace.js.map +1 -0
- package/lib-dist/terra/editor/TerraContentEditor.d.ts +10 -0
- package/lib-dist/terra/editor/TerraContentEditor.d.ts.map +1 -0
- package/lib-dist/terra/editor/TerraContentEditor.js +47 -0
- package/lib-dist/terra/editor/TerraContentEditor.js.map +1 -0
- package/lib-dist/terra/editor/_blocks.d.ts +71 -0
- package/lib-dist/terra/editor/_blocks.d.ts.map +1 -0
- package/lib-dist/terra/editor/_blocks.js +110 -0
- package/lib-dist/terra/editor/_blocks.js.map +1 -0
- package/lib-dist/terra/editor/docs/_Callout.d.ts +14 -0
- package/lib-dist/terra/editor/docs/_Callout.d.ts.map +1 -0
- package/lib-dist/terra/editor/docs/_Callout.js +41 -0
- package/lib-dist/terra/editor/docs/_Callout.js.map +1 -0
- package/lib-dist/terra/editor/docs/_CodeBlock.d.ts +39 -0
- package/lib-dist/terra/editor/docs/_CodeBlock.d.ts.map +1 -0
- package/lib-dist/terra/editor/docs/_CodeBlock.js +494 -0
- package/lib-dist/terra/editor/docs/_CodeBlock.js.map +1 -0
- package/lib-dist/terra/editor/docs/_DocsCode.d.ts +14 -0
- package/lib-dist/terra/editor/docs/_DocsCode.d.ts.map +1 -0
- package/lib-dist/terra/editor/docs/_DocsCode.js +95 -0
- package/lib-dist/terra/editor/docs/_DocsCode.js.map +1 -0
- package/lib-dist/terra/editor/docs/_DocsImage.d.ts +18 -0
- package/lib-dist/terra/editor/docs/_DocsImage.d.ts.map +1 -0
- package/lib-dist/terra/editor/docs/_DocsImage.js +62 -0
- package/lib-dist/terra/editor/docs/_DocsImage.js.map +1 -0
- package/lib-dist/terra/editor/docs/_Embed.d.ts +15 -0
- package/lib-dist/terra/editor/docs/_Embed.d.ts.map +1 -0
- package/lib-dist/terra/editor/docs/_Embed.js +27 -0
- package/lib-dist/terra/editor/docs/_Embed.js.map +1 -0
- package/lib-dist/terra/editor/docs/_Math.d.ts +31 -0
- package/lib-dist/terra/editor/docs/_Math.d.ts.map +1 -0
- package/lib-dist/terra/editor/docs/_Math.js +126 -0
- package/lib-dist/terra/editor/docs/_Math.js.map +1 -0
- package/lib-dist/terra/editor/docs/_Nodes.d.ts +15 -0
- package/lib-dist/terra/editor/docs/_Nodes.d.ts.map +1 -0
- package/lib-dist/terra/editor/docs/_Nodes.js +52 -0
- package/lib-dist/terra/editor/docs/_Nodes.js.map +1 -0
- package/lib-dist/terra/editor/docs/_Raw.d.ts +15 -0
- package/lib-dist/terra/editor/docs/_Raw.d.ts.map +1 -0
- package/lib-dist/terra/editor/docs/_Raw.js +26 -0
- package/lib-dist/terra/editor/docs/_Raw.js.map +1 -0
- package/lib-dist/terra/editor/docs/_Table.d.ts +12 -0
- package/lib-dist/terra/editor/docs/_Table.d.ts.map +1 -0
- package/lib-dist/terra/editor/docs/_Table.js +71 -0
- package/lib-dist/terra/editor/docs/_Table.js.map +1 -0
- package/lib-dist/terra/editor/docs/_Tabs.d.ts +14 -0
- package/lib-dist/terra/editor/docs/_Tabs.d.ts.map +1 -0
- package/lib-dist/terra/editor/docs/_Tabs.js +104 -0
- package/lib-dist/terra/editor/docs/_Tabs.js.map +1 -0
- package/lib-dist/terra/editor/docs/_TsDocs.d.ts +15 -0
- package/lib-dist/terra/editor/docs/_TsDocs.d.ts.map +1 -0
- package/lib-dist/terra/editor/docs/_TsDocs.js +81 -0
- package/lib-dist/terra/editor/docs/_TsDocs.js.map +1 -0
- package/lib-dist/terra/editor/docs/_math_inline.d.ts +14 -0
- package/lib-dist/terra/editor/docs/_math_inline.d.ts.map +1 -0
- package/lib-dist/terra/editor/docs/_math_inline.js +30 -0
- package/lib-dist/terra/editor/docs/_math_inline.js.map +1 -0
- package/lib-dist/terra/editor/docs/heading.d.ts +23 -0
- package/lib-dist/terra/editor/docs/heading.d.ts.map +1 -0
- package/lib-dist/terra/editor/docs/heading.js +60 -0
- package/lib-dist/terra/editor/docs/heading.js.map +1 -0
- package/lib-dist/terra/editor/docs/index.d.ts +13 -0
- package/lib-dist/terra/editor/docs/index.d.ts.map +1 -0
- package/lib-dist/terra/editor/docs/index.js +14 -0
- package/lib-dist/terra/editor/docs/index.js.map +1 -0
- package/lib-dist/terra/editor/types.d.ts +40 -0
- package/lib-dist/terra/editor/types.d.ts.map +1 -0
- package/lib-dist/terra/editor/types.js +11 -0
- package/lib-dist/terra/editor/types.js.map +1 -0
- package/lib-dist/terra/flow/Nodes.d.ts +78 -0
- package/lib-dist/terra/flow/Nodes.d.ts.map +1 -0
- package/lib-dist/terra/flow/Nodes.js +912 -0
- package/lib-dist/terra/flow/Nodes.js.map +1 -0
- package/lib-dist/terra/flow/_chrome.d.ts +267 -0
- package/lib-dist/terra/flow/_chrome.d.ts.map +1 -0
- package/lib-dist/terra/flow/_chrome.js +798 -0
- package/lib-dist/terra/flow/_chrome.js.map +1 -0
- package/lib-dist/terra/flow/_layout.d.ts +30 -0
- package/lib-dist/terra/flow/_layout.d.ts.map +1 -0
- package/lib-dist/terra/flow/_layout.js +53 -0
- package/lib-dist/terra/flow/_layout.js.map +1 -0
- package/lib-dist/terra/flow/menuContext.d.ts +13 -0
- package/lib-dist/terra/flow/menuContext.d.ts.map +1 -0
- package/lib-dist/terra/flow/menuContext.js +10 -0
- package/lib-dist/terra/flow/menuContext.js.map +1 -0
- package/lib-dist/terra/flow/powerSource.d.ts +16 -0
- package/lib-dist/terra/flow/powerSource.d.ts.map +1 -0
- package/lib-dist/terra/flow/powerSource.js +59 -0
- package/lib-dist/terra/flow/powerSource.js.map +1 -0
- package/lib-dist/terra/pages/docs/_attachments.d.ts +20 -0
- package/lib-dist/terra/pages/docs/_attachments.d.ts.map +1 -0
- package/lib-dist/terra/pages/docs/_attachments.js +904 -0
- package/lib-dist/terra/pages/docs/_attachments.js.map +1 -0
- package/lib-dist/terra/pages/docs/_blocks.d.ts +48 -0
- package/lib-dist/terra/pages/docs/_blocks.d.ts.map +1 -0
- package/lib-dist/terra/pages/docs/_blocks.js +192 -0
- package/lib-dist/terra/pages/docs/_blocks.js.map +1 -0
- package/lib-dist/terra/pages/docs/_custom.d.ts +5 -0
- package/lib-dist/terra/pages/docs/_custom.d.ts.map +1 -0
- package/lib-dist/terra/pages/docs/_custom.js +6 -0
- package/lib-dist/terra/pages/docs/_custom.js.map +1 -0
- package/lib-dist/terra/pages/docs/_editable.d.ts +61 -0
- package/lib-dist/terra/pages/docs/_editable.d.ts.map +1 -0
- package/lib-dist/terra/pages/docs/_editable.js +404 -0
- package/lib-dist/terra/pages/docs/_editable.js.map +1 -0
- package/lib-dist/terra/pages/docs/_export-dialog.d.ts +19 -0
- package/lib-dist/terra/pages/docs/_export-dialog.d.ts.map +1 -0
- package/lib-dist/terra/pages/docs/_export-dialog.js +78 -0
- package/lib-dist/terra/pages/docs/_export-dialog.js.map +1 -0
- package/lib-dist/terra/pages/docs/_helpers.d.ts +395 -0
- package/lib-dist/terra/pages/docs/_helpers.d.ts.map +1 -0
- package/lib-dist/terra/pages/docs/_helpers.js +911 -0
- package/lib-dist/terra/pages/docs/_helpers.js.map +1 -0
- package/lib-dist/terra/pages/docs/_icons.d.ts +20 -0
- package/lib-dist/terra/pages/docs/_icons.d.ts.map +1 -0
- package/lib-dist/terra/pages/docs/_icons.js +29 -0
- package/lib-dist/terra/pages/docs/_icons.js.map +1 -0
- package/lib-dist/terra/pages/docs/_main.d.ts +51 -0
- package/lib-dist/terra/pages/docs/_main.d.ts.map +1 -0
- package/lib-dist/terra/pages/docs/_main.js +1959 -0
- package/lib-dist/terra/pages/docs/_main.js.map +1 -0
- package/lib-dist/terra/pages/docs/_sidebar.d.ts +42 -0
- package/lib-dist/terra/pages/docs/_sidebar.d.ts.map +1 -0
- package/lib-dist/terra/pages/docs/_sidebar.js +2450 -0
- package/lib-dist/terra/pages/docs/_sidebar.js.map +1 -0
- package/lib-dist/terra/pages/docs/_toolbar.d.ts +23 -0
- package/lib-dist/terra/pages/docs/_toolbar.d.ts.map +1 -0
- package/lib-dist/terra/pages/docs/_toolbar.js +1539 -0
- package/lib-dist/terra/pages/docs/_toolbar.js.map +1 -0
- package/lib-dist/terra/pages/docs/_tree.d.ts +178 -0
- package/lib-dist/terra/pages/docs/_tree.d.ts.map +1 -0
- package/lib-dist/terra/pages/docs/_tree.js +1168 -0
- package/lib-dist/terra/pages/docs/_tree.js.map +1 -0
- package/lib-dist/terra/regex.mjs +398 -0
- package/lib-dist/terra/runtime/action-proxy.d.ts +5 -0
- package/lib-dist/terra/runtime/action-proxy.d.ts.map +1 -0
- package/lib-dist/terra/runtime/action-proxy.js +19 -0
- package/lib-dist/terra/runtime/action-proxy.js.map +1 -0
- package/lib-dist/terra/runtime/content.d.ts +150 -0
- package/lib-dist/terra/runtime/content.d.ts.map +1 -0
- package/lib-dist/terra/runtime/content.js +1171 -0
- package/lib-dist/terra/runtime/content.js.map +1 -0
- package/lib-dist/terra/runtime/leaf.d.ts +5 -0
- package/lib-dist/terra/runtime/leaf.d.ts.map +1 -0
- package/lib-dist/terra/runtime/leaf.js +13 -0
- package/lib-dist/terra/runtime/leaf.js.map +1 -0
- package/lib-dist/terra/runtime/nodes.d.ts +112 -0
- package/lib-dist/terra/runtime/nodes.d.ts.map +1 -0
- package/lib-dist/terra/runtime/nodes.js +534 -0
- package/lib-dist/terra/runtime/nodes.js.map +1 -0
- package/lib-dist/terra/runtime/runtime.d.ts +25 -0
- package/lib-dist/terra/runtime/runtime.d.ts.map +1 -0
- package/lib-dist/terra/runtime/runtime.js +50 -0
- package/lib-dist/terra/runtime/runtime.js.map +1 -0
- package/lib-dist/terra/runtime/shared.d.ts +35 -0
- package/lib-dist/terra/runtime/shared.d.ts.map +1 -0
- package/lib-dist/terra/runtime/shared.js +79 -0
- package/lib-dist/terra/runtime/shared.js.map +1 -0
- package/lib-dist/terra/runtime/types.d.ts +266 -0
- package/lib-dist/terra/runtime/types.d.ts.map +1 -0
- package/lib-dist/terra/runtime/types.js +18 -0
- package/lib-dist/terra/runtime/types.js.map +1 -0
- package/lib-dist/terra/runtime/ui.d.ts +31 -0
- package/lib-dist/terra/runtime/ui.d.ts.map +1 -0
- package/lib-dist/terra/runtime/ui.js +16 -0
- package/lib-dist/terra/runtime/ui.js.map +1 -0
- package/lib-dist/workspace.d.ts +78 -0
- package/lib-dist/workspace.d.ts.map +1 -0
- package/lib-dist/workspace.js +151 -0
- package/lib-dist/workspace.js.map +1 -0
- package/package.json +90 -3
- package/src/SiteLayout.astro +38 -0
- package/src/navigation.tsx +47 -0
- package/src/style.css +733 -0
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
import { configureDocsActionProxy } from './terra/runtime/action-proxy.js';
|
|
2
|
+
import { setDocsCustomComponents } from './terra/pages/docs/_custom.js';
|
|
3
|
+
let activeHost;
|
|
4
|
+
export function getDocsHostAdapter() { return activeHost; }
|
|
5
|
+
/** Install host-owned storage and capability checks before mounting the Docs surface. */
|
|
6
|
+
export function configureDocsHost(host, customBlocks = []) {
|
|
7
|
+
activeHost = host;
|
|
8
|
+
setDocsCustomComponents(customBlocks);
|
|
9
|
+
configureDocsActionProxy(async (operation, input) => {
|
|
10
|
+
if (operation.startsWith('write.') && !host.capabilities.write)
|
|
11
|
+
return { error: new Error('This Docs instance is read-only.') };
|
|
12
|
+
if (operation.startsWith('write.attachment.') && !host.capabilities.attachments)
|
|
13
|
+
return { error: new Error('Attachment changes are disabled for this Docs instance.') };
|
|
14
|
+
if (operation.startsWith('write.doc.reorder') && !host.capabilities.reorder)
|
|
15
|
+
return { error: new Error('Reordering is disabled for this Docs instance.') };
|
|
16
|
+
if (operation.includes('.versions.') && !host.capabilities.history)
|
|
17
|
+
return { error: new Error('History is disabled for this Docs instance.') };
|
|
18
|
+
return host.invoke(operation, input);
|
|
19
|
+
});
|
|
20
|
+
}
|
|
21
|
+
//# sourceMappingURL=host-runtime.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"host-runtime.js","sourceRoot":"","sources":["../src/host-runtime.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,wBAAwB,EAAE,MAAM,iCAAiC,CAAC;AAC3E,OAAO,EAAE,uBAAuB,EAAE,MAAM,+BAA+B,CAAC;AAGxE,IAAI,UAAuC,CAAC;AAE5C,MAAM,UAAU,kBAAkB,KAAkC,OAAO,UAAU,CAAC,CAAC,CAAC;AAExF,yFAAyF;AACzF,MAAM,UAAU,iBAAiB,CAAC,IAAqB,EAAE,eAAkC,EAAE;IAC3F,UAAU,GAAG,IAAI,CAAC;IAClB,uBAAuB,CAAC,YAAY,CAAC,CAAC;IACtC,wBAAwB,CAAC,KAAK,EAAM,SAA8B,EAAE,KAAe,EAAgC,EAAE;QACnH,IAAI,SAAS,CAAC,UAAU,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,KAAK;YAAE,OAAO,EAAE,KAAK,EAAE,IAAI,KAAK,CAAC,kCAAkC,CAAC,EAAE,CAAC;QAChI,IAAI,SAAS,CAAC,UAAU,CAAC,mBAAmB,CAAC,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,WAAW;YAAE,OAAO,EAAE,KAAK,EAAE,IAAI,KAAK,CAAC,yDAAyD,CAAC,EAAE,CAAC;QACxK,IAAI,SAAS,CAAC,UAAU,CAAC,mBAAmB,CAAC,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,OAAO;YAAE,OAAO,EAAE,KAAK,EAAE,IAAI,KAAK,CAAC,gDAAgD,CAAC,EAAE,CAAC;QAC3J,IAAI,SAAS,CAAC,QAAQ,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,OAAO;YAAE,OAAO,EAAE,KAAK,EAAE,IAAI,KAAK,CAAC,6CAA6C,CAAC,EAAE,CAAC;QAC/I,OAAO,IAAI,CAAC,MAAM,CAAI,SAAS,EAAE,KAAK,CAAC,CAAC;IAC1C,CAAC,CAAC,CAAC;AACL,CAAC"}
|
|
@@ -0,0 +1,170 @@
|
|
|
1
|
+
import type { ComponentType, ReactNode } from 'react';
|
|
2
|
+
/** The portable tree-node shape used by the original Terra Docs workspace. */
|
|
3
|
+
export type DocsHostTreeNode = {
|
|
4
|
+
type: 'branch' | 'leaf';
|
|
5
|
+
origName: string;
|
|
6
|
+
title?: string;
|
|
7
|
+
url?: string;
|
|
8
|
+
path?: string;
|
|
9
|
+
permission?: 'read' | 'write';
|
|
10
|
+
children?: DocsHostTreeNode[];
|
|
11
|
+
[key: string]: unknown;
|
|
12
|
+
};
|
|
13
|
+
/** A portable document value handed to the workspace by its storage adapter. */
|
|
14
|
+
export type DocsHostDocument = {
|
|
15
|
+
id?: string;
|
|
16
|
+
path?: string;
|
|
17
|
+
pathname?: string;
|
|
18
|
+
title: string;
|
|
19
|
+
description?: string;
|
|
20
|
+
content?: unknown[] | string;
|
|
21
|
+
source?: string;
|
|
22
|
+
contributors?: string[];
|
|
23
|
+
updatedAt?: string;
|
|
24
|
+
[key: string]: unknown;
|
|
25
|
+
};
|
|
26
|
+
/** The subset of the signed-in account the shared navigation can display. */
|
|
27
|
+
export type DocsHostUser = {
|
|
28
|
+
id?: string;
|
|
29
|
+
name?: string;
|
|
30
|
+
email?: string;
|
|
31
|
+
image?: string;
|
|
32
|
+
[key: string]: unknown;
|
|
33
|
+
};
|
|
34
|
+
/** Portable attachment metadata. The host resolves and authorizes its URL. */
|
|
35
|
+
export type DocsHostAttachment = {
|
|
36
|
+
id?: string;
|
|
37
|
+
name: string;
|
|
38
|
+
path: string;
|
|
39
|
+
type?: string;
|
|
40
|
+
size?: number;
|
|
41
|
+
[key: string]: unknown;
|
|
42
|
+
};
|
|
43
|
+
/** Capability flags control which mutating controls the shared UI displays. */
|
|
44
|
+
export type DocsHostCapabilities = {
|
|
45
|
+
read?: boolean;
|
|
46
|
+
write?: boolean;
|
|
47
|
+
reorder?: boolean;
|
|
48
|
+
attachments?: boolean;
|
|
49
|
+
export?: boolean;
|
|
50
|
+
history?: boolean;
|
|
51
|
+
publish?: boolean;
|
|
52
|
+
};
|
|
53
|
+
export type DocsActionOperation = `read.${'asset' | 'doc' | 'external' | 'source' | 'util'}.${string}` | `read.${'tsdocs'}` | `write.${'asset' | 'attachment' | 'doc'}.${string}`;
|
|
54
|
+
export type DocsActionResult<T = unknown> = {
|
|
55
|
+
data?: T;
|
|
56
|
+
error?: unknown;
|
|
57
|
+
};
|
|
58
|
+
export type DocsResolvedRoute = {
|
|
59
|
+
sectionId: string;
|
|
60
|
+
groupId?: string;
|
|
61
|
+
leafId?: string;
|
|
62
|
+
targetId: string;
|
|
63
|
+
pathname: string;
|
|
64
|
+
};
|
|
65
|
+
/** Type contract for the stable host operations used by the shared UI. */
|
|
66
|
+
export type DocsHostOperationContracts = {
|
|
67
|
+
'read.doc.list': {
|
|
68
|
+
input: {
|
|
69
|
+
type: 'nav';
|
|
70
|
+
pathname: string;
|
|
71
|
+
full?: boolean;
|
|
72
|
+
};
|
|
73
|
+
output: DocsHostTreeNode[];
|
|
74
|
+
};
|
|
75
|
+
'read.doc.get': {
|
|
76
|
+
input: {
|
|
77
|
+
id?: string;
|
|
78
|
+
pathname?: string;
|
|
79
|
+
};
|
|
80
|
+
output: DocsHostDocument | null;
|
|
81
|
+
};
|
|
82
|
+
'read.doc.attachments': {
|
|
83
|
+
input: {
|
|
84
|
+
path: string;
|
|
85
|
+
};
|
|
86
|
+
output: DocsHostAttachment[];
|
|
87
|
+
};
|
|
88
|
+
'write.doc.save': {
|
|
89
|
+
input: {
|
|
90
|
+
path: string;
|
|
91
|
+
title: string;
|
|
92
|
+
description?: string;
|
|
93
|
+
content?: unknown[];
|
|
94
|
+
source?: string;
|
|
95
|
+
};
|
|
96
|
+
output: DocsHostDocument;
|
|
97
|
+
};
|
|
98
|
+
'write.doc.reorder': {
|
|
99
|
+
input: {
|
|
100
|
+
path: string;
|
|
101
|
+
parent: string;
|
|
102
|
+
order: number;
|
|
103
|
+
type?: 'leaf' | 'branch';
|
|
104
|
+
};
|
|
105
|
+
output: DocsHostTreeNode[] | null;
|
|
106
|
+
};
|
|
107
|
+
'write.doc.rm': {
|
|
108
|
+
input: {
|
|
109
|
+
path: string;
|
|
110
|
+
type: 'doc' | 'folder';
|
|
111
|
+
assets?: boolean;
|
|
112
|
+
};
|
|
113
|
+
output: null;
|
|
114
|
+
};
|
|
115
|
+
};
|
|
116
|
+
/** Host boundary for storage, authorization, URLs, and mutations. */
|
|
117
|
+
export type DocsHostAdapter = {
|
|
118
|
+
capabilities: DocsHostCapabilities;
|
|
119
|
+
/** Legacy action bridge for host-specific operations outside the stable contract. */
|
|
120
|
+
invoke<T = unknown>(operation: DocsActionOperation, input?: unknown): Promise<DocsActionResult<T>>;
|
|
121
|
+
/** Load a host-owned draft when an editor enters Edit mode. */
|
|
122
|
+
loadDraft?: (path: string) => Promise<DocsHostDocument | null>;
|
|
123
|
+
/** Publish the current saved draft from the shared toolbar when supported by the host. */
|
|
124
|
+
publishDraft?: (path: string) => Promise<void>;
|
|
125
|
+
assetUrl?: (assetId: string, width?: number) => string | undefined;
|
|
126
|
+
resolveRoute?: (pathname: string) => DocsResolvedRoute;
|
|
127
|
+
buildRoute?: (sectionId: string, groupId?: string, leafId?: string) => string;
|
|
128
|
+
/** Base path for a host's Docs application (`/docs` for Terra, `/` for local instances). */
|
|
129
|
+
rootPath?: string;
|
|
130
|
+
/** Resolve a repository or content path into a browser route. */
|
|
131
|
+
routePath?: (path: string) => string;
|
|
132
|
+
/** Route back to the host's Docs root from its brand link. */
|
|
133
|
+
homePath?: string;
|
|
134
|
+
isDevelopmentOrigin?: (origin: string) => boolean;
|
|
135
|
+
/** Label used in the shared sidebar and document title. */
|
|
136
|
+
siteTitle?: string;
|
|
137
|
+
/** Supporting text shown beneath the site title in the shared sidebar. */
|
|
138
|
+
siteDescription?: string;
|
|
139
|
+
};
|
|
140
|
+
/** A host-specific rich block renderer. Generic blocks live in @terra-symposium/docs. */
|
|
141
|
+
export type DocsCustomBlock = {
|
|
142
|
+
name: string;
|
|
143
|
+
label?: string;
|
|
144
|
+
component?: ComponentType<Record<string, unknown>>;
|
|
145
|
+
render?: (props: Record<string, unknown>) => ReactNode;
|
|
146
|
+
path?: string;
|
|
147
|
+
clipboardValue?: string;
|
|
148
|
+
exportValue?: string;
|
|
149
|
+
[key: string]: unknown;
|
|
150
|
+
};
|
|
151
|
+
/** Root inputs required to mount the original Terra Docs workspace. */
|
|
152
|
+
export type TerraDocsWorkspaceProps = {
|
|
153
|
+
host: DocsHostAdapter;
|
|
154
|
+
tree: DocsHostTreeNode[];
|
|
155
|
+
pathname: string;
|
|
156
|
+
permission: 'read' | 'write';
|
|
157
|
+
path?: string;
|
|
158
|
+
title: string;
|
|
159
|
+
description?: string;
|
|
160
|
+
contributors?: string[];
|
|
161
|
+
updatedAt?: string;
|
|
162
|
+
userData?: DocsHostUser | null;
|
|
163
|
+
source?: string;
|
|
164
|
+
content?: unknown;
|
|
165
|
+
standalone?: boolean;
|
|
166
|
+
full?: boolean;
|
|
167
|
+
mode?: 'view' | 'edit' | 'attachments';
|
|
168
|
+
customBlocks?: DocsCustomBlock[];
|
|
169
|
+
};
|
|
170
|
+
//# sourceMappingURL=host.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"host.d.ts","sourceRoot":"","sources":["../src/host.ts"],"names":[],"mappings":"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"}
|
package/lib-dist/host.js
ADDED
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"host.js","sourceRoot":"","sources":["../src/host.ts"],"names":[],"mappings":""}
|
|
@@ -0,0 +1,35 @@
|
|
|
1
|
+
export { Docs } from './Docs.js';
|
|
2
|
+
export { DocsSiteLayout } from './SiteLayout.js';
|
|
3
|
+
export { DocsStaticWorkspace } from './StaticWorkspace.js';
|
|
4
|
+
export type { DocsMode, DocsProps, DocsValue } from './Docs.js';
|
|
5
|
+
export { DocsNavigation } from './navigation.js';
|
|
6
|
+
export type { DocsNavNode } from './navigation.js';
|
|
7
|
+
export { renderMarkdown } from './markdown.js';
|
|
8
|
+
export { markdownToDocsValue, docsValueToMarkdown } from './markdown-model.js';
|
|
9
|
+
export { DOCS_BLOCK_TYPES, DOCS_BLOCK_FIELDS, enabledDocsBlocks, defaultDocsBlock, DocsRichBlock, } from './blocks.js';
|
|
10
|
+
export type { DocsBlockOptions, DocsBlockType, RichBlock } from './blocks.js';
|
|
11
|
+
export { TerraDocsWorkspace } from './terra/Workspace.js';
|
|
12
|
+
export { DocsLocalWorkspace } from './LocalDocsWorkspace.js';
|
|
13
|
+
export type { DocsLocalPage, DocsLocalWorkspaceProps } from './LocalDocsWorkspace.js';
|
|
14
|
+
export { TerraContentEditor as DocsContentEditor } from './terra/editor/TerraContentEditor.js';
|
|
15
|
+
export { renderCallout } from './terra/editor/docs/_Callout.js';
|
|
16
|
+
export { renderCode } from './terra/editor/docs/_DocsCode.js';
|
|
17
|
+
export { Embed } from './terra/editor/docs/_Embed.js';
|
|
18
|
+
export { renderImage } from './terra/editor/docs/_DocsImage.js';
|
|
19
|
+
export { renderMathBlock } from './terra/editor/docs/_Math.js';
|
|
20
|
+
export { default as DocsInlineMath } from './terra/editor/docs/_math_inline.js';
|
|
21
|
+
export { NodesBlock } from './terra/editor/docs/_Nodes.js';
|
|
22
|
+
export { Raw } from './terra/editor/docs/_Raw.js';
|
|
23
|
+
export { renderTable } from './terra/editor/docs/_Table.js';
|
|
24
|
+
export { renderSections } from './terra/editor/docs/_Tabs.js';
|
|
25
|
+
export { TsDocs } from './terra/editor/docs/_TsDocs.js';
|
|
26
|
+
export { DocsHeading } from './terra/editor/docs/heading.js';
|
|
27
|
+
export { DOCS_BLOCK_ICONS } from './terra/pages/docs/_icons.js';
|
|
28
|
+
export { ATTCH_TYPES } from './terra/pages/docs/_helpers.js';
|
|
29
|
+
export { ExportDialog } from './terra/pages/docs/_export-dialog.js';
|
|
30
|
+
export type { DocsExportOpts, ExportTgt } from './terra/runtime/types.js';
|
|
31
|
+
export { configureDocsHost, getDocsHostAdapter } from './host-runtime.js';
|
|
32
|
+
export type { DocsActionOperation, DocsActionResult, DocsHostOperationContracts, DocsResolvedRoute, DocsCustomBlock, DocsHostAdapter, DocsHostAttachment, DocsHostCapabilities, DocsHostDocument, DocsHostTreeNode, DocsHostUser, TerraDocsWorkspaceProps, } from './host.js';
|
|
33
|
+
export { DocsWorkspaceNavigation, DocsWorkspaceToolbar, DocsAttachmentsView } from './workspace.js';
|
|
34
|
+
export type { DocsAttachment, DocsLeaf, DocsGroup, DocsSection, DocsCapabilities, DocsRemoteProvider, DocsTreeAction, DocsTreeActionName, DocsTreeActions, } from './workspace.js';
|
|
35
|
+
//# sourceMappingURL=index.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAC3D,YAAY,EAAE,QAAQ,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAChE,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACjD,YAAY,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC/E,OAAO,EACL,gBAAgB,EAChB,iBAAiB,EACjB,iBAAiB,EACjB,gBAAgB,EAChB,aAAa,GACd,MAAM,aAAa,CAAC;AACrB,YAAY,EAAE,gBAAgB,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAC9E,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,YAAY,EAAE,aAAa,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAC;AACtF,OAAO,EAAE,kBAAkB,IAAI,iBAAiB,EAAE,MAAM,sCAAsC,CAAC;AAC/F,OAAO,EAAE,aAAa,EAAE,MAAM,iCAAiC,CAAC;AAChE,OAAO,EAAE,UAAU,EAAE,MAAM,kCAAkC,CAAC;AAC9D,OAAO,EAAE,KAAK,EAAE,MAAM,+BAA+B,CAAC;AACtD,OAAO,EAAE,WAAW,EAAE,MAAM,mCAAmC,CAAC;AAChE,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAC/D,OAAO,EAAE,OAAO,IAAI,cAAc,EAAE,MAAM,qCAAqC,CAAC;AAChF,OAAO,EAAE,UAAU,EAAE,MAAM,+BAA+B,CAAC;AAC3D,OAAO,EAAE,GAAG,EAAE,MAAM,6BAA6B,CAAC;AAClD,OAAO,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC;AAC5D,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAC9D,OAAO,EAAE,MAAM,EAAE,MAAM,gCAAgC,CAAC;AACxD,OAAO,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAC;AAC7D,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAChE,OAAO,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAC;AAC7D,OAAO,EAAE,YAAY,EAAE,MAAM,sCAAsC,CAAC;AACpE,YAAY,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAC1E,OAAO,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAC1E,YAAY,EACV,mBAAmB,EACnB,gBAAgB,EAChB,0BAA0B,EAC1B,iBAAiB,EACjB,eAAe,EACf,eAAe,EACf,kBAAkB,EAClB,oBAAoB,EACpB,gBAAgB,EAChB,gBAAgB,EAChB,YAAY,EACZ,uBAAuB,GACxB,MAAM,WAAW,CAAC;AAEnB,OAAO,EAAE,uBAAuB,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AACpG,YAAY,EACV,cAAc,EACd,QAAQ,EACR,SAAS,EACT,WAAW,EACX,gBAAgB,EAChB,kBAAkB,EAClB,cAAc,EACd,kBAAkB,EAClB,eAAe,GAChB,MAAM,gBAAgB,CAAC"}
|
|
@@ -0,0 +1,28 @@
|
|
|
1
|
+
export { Docs } from './Docs.js';
|
|
2
|
+
export { DocsSiteLayout } from './SiteLayout.js';
|
|
3
|
+
export { DocsStaticWorkspace } from './StaticWorkspace.js';
|
|
4
|
+
export { DocsNavigation } from './navigation.js';
|
|
5
|
+
export { renderMarkdown } from './markdown.js';
|
|
6
|
+
export { markdownToDocsValue, docsValueToMarkdown } from './markdown-model.js';
|
|
7
|
+
export { DOCS_BLOCK_TYPES, DOCS_BLOCK_FIELDS, enabledDocsBlocks, defaultDocsBlock, DocsRichBlock, } from './blocks.js';
|
|
8
|
+
export { TerraDocsWorkspace } from './terra/Workspace.js';
|
|
9
|
+
export { DocsLocalWorkspace } from './LocalDocsWorkspace.js';
|
|
10
|
+
export { TerraContentEditor as DocsContentEditor } from './terra/editor/TerraContentEditor.js';
|
|
11
|
+
export { renderCallout } from './terra/editor/docs/_Callout.js';
|
|
12
|
+
export { renderCode } from './terra/editor/docs/_DocsCode.js';
|
|
13
|
+
export { Embed } from './terra/editor/docs/_Embed.js';
|
|
14
|
+
export { renderImage } from './terra/editor/docs/_DocsImage.js';
|
|
15
|
+
export { renderMathBlock } from './terra/editor/docs/_Math.js';
|
|
16
|
+
export { default as DocsInlineMath } from './terra/editor/docs/_math_inline.js';
|
|
17
|
+
export { NodesBlock } from './terra/editor/docs/_Nodes.js';
|
|
18
|
+
export { Raw } from './terra/editor/docs/_Raw.js';
|
|
19
|
+
export { renderTable } from './terra/editor/docs/_Table.js';
|
|
20
|
+
export { renderSections } from './terra/editor/docs/_Tabs.js';
|
|
21
|
+
export { TsDocs } from './terra/editor/docs/_TsDocs.js';
|
|
22
|
+
export { DocsHeading } from './terra/editor/docs/heading.js';
|
|
23
|
+
export { DOCS_BLOCK_ICONS } from './terra/pages/docs/_icons.js';
|
|
24
|
+
export { ATTCH_TYPES } from './terra/pages/docs/_helpers.js';
|
|
25
|
+
export { ExportDialog } from './terra/pages/docs/_export-dialog.js';
|
|
26
|
+
export { configureDocsHost, getDocsHostAdapter } from './host-runtime.js';
|
|
27
|
+
export { DocsWorkspaceNavigation, DocsWorkspaceToolbar, DocsAttachmentsView } from './workspace.js';
|
|
28
|
+
//# sourceMappingURL=index.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAE3D,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAEjD,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC/E,OAAO,EACL,gBAAgB,EAChB,iBAAiB,EACjB,iBAAiB,EACjB,gBAAgB,EAChB,aAAa,GACd,MAAM,aAAa,CAAC;AAErB,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAE7D,OAAO,EAAE,kBAAkB,IAAI,iBAAiB,EAAE,MAAM,sCAAsC,CAAC;AAC/F,OAAO,EAAE,aAAa,EAAE,MAAM,iCAAiC,CAAC;AAChE,OAAO,EAAE,UAAU,EAAE,MAAM,kCAAkC,CAAC;AAC9D,OAAO,EAAE,KAAK,EAAE,MAAM,+BAA+B,CAAC;AACtD,OAAO,EAAE,WAAW,EAAE,MAAM,mCAAmC,CAAC;AAChE,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAC/D,OAAO,EAAE,OAAO,IAAI,cAAc,EAAE,MAAM,qCAAqC,CAAC;AAChF,OAAO,EAAE,UAAU,EAAE,MAAM,+BAA+B,CAAC;AAC3D,OAAO,EAAE,GAAG,EAAE,MAAM,6BAA6B,CAAC;AAClD,OAAO,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC;AAC5D,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAC9D,OAAO,EAAE,MAAM,EAAE,MAAM,gCAAgC,CAAC;AACxD,OAAO,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAC;AAC7D,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAChE,OAAO,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAC;AAC7D,OAAO,EAAE,YAAY,EAAE,MAAM,sCAAsC,CAAC;AAEpE,OAAO,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAgB1E,OAAO,EAAE,uBAAuB,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC"}
|
|
@@ -0,0 +1,7 @@
|
|
|
1
|
+
import type { DocsValue } from './Docs.js';
|
|
2
|
+
import type { DocsBlockOptions } from './blocks.js';
|
|
3
|
+
/** Decode Markdown without dropping unsupported syntax; opaque tokens become raw blocks. */
|
|
4
|
+
export declare function markdownToDocsValue(markdown: string, options?: DocsBlockOptions): DocsValue;
|
|
5
|
+
/** Serialize supported visual blocks and keep every opaque raw token verbatim. */
|
|
6
|
+
export declare function docsValueToMarkdown(value: DocsValue): string;
|
|
7
|
+
//# sourceMappingURL=markdown-model.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"markdown-model.d.ts","sourceRoot":"","sources":["../src/markdown-model.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAG3C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAkEpD,4FAA4F;AAC5F,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,GAAE,gBAAqB,GAAG,SAAS,CAqE/F;AAED,kFAAkF;AAClF,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,SAAS,GAAG,MAAM,CA4E5D"}
|
|
@@ -0,0 +1,181 @@
|
|
|
1
|
+
import { marked } from 'marked';
|
|
2
|
+
import { enabledDocsBlocks } from './blocks.js';
|
|
3
|
+
const key = () => crypto.randomUUID();
|
|
4
|
+
function span(text, marks = []) {
|
|
5
|
+
return { _type: 'span', _key: key(), text, marks };
|
|
6
|
+
}
|
|
7
|
+
function inline(tokens, markDefs) {
|
|
8
|
+
if (!tokens)
|
|
9
|
+
return [];
|
|
10
|
+
return tokens.flatMap((token) => {
|
|
11
|
+
if (token.type === 'strong')
|
|
12
|
+
return inline(token.tokens, markDefs).map((item) => item._type === 'span' ? { ...item, marks: [...item.marks, 'strong'] } : item);
|
|
13
|
+
if (token.type === 'em')
|
|
14
|
+
return inline(token.tokens, markDefs).map((item) => item._type === 'span' ? { ...item, marks: [...item.marks, 'em'] } : item);
|
|
15
|
+
if (token.type === 'del')
|
|
16
|
+
return inline(token.tokens, markDefs).map((item) => item._type === 'span' ? { ...item, marks: [...item.marks, 'strike-through'] } : item);
|
|
17
|
+
if (token.type === 'link') {
|
|
18
|
+
const href = typeof token.href === 'string' ? token.href : '';
|
|
19
|
+
if (!href || !/^(?:https?:\/\/|mailto:|\/|\.\.?\/|#)/i.test(href))
|
|
20
|
+
return [span(token.raw)];
|
|
21
|
+
const mark = key();
|
|
22
|
+
markDefs.push({ _type: 'link', _key: mark, href });
|
|
23
|
+
return inline(token.tokens, markDefs).map((item) => item._type === 'span' ? { ...item, marks: [...item.marks, mark] } : item);
|
|
24
|
+
}
|
|
25
|
+
if (token.type === 'text' || token.type === 'escape') {
|
|
26
|
+
const pieces = (token.text ?? token.raw).split(/(\$[^$\n]+\$)/g).filter(Boolean);
|
|
27
|
+
return pieces.map((piece) => /^\$[^$\n]+\$$/.test(piece)
|
|
28
|
+
? { _type: 'math', _key: key(), code: piece.slice(1, -1), inline: true }
|
|
29
|
+
: span(piece));
|
|
30
|
+
}
|
|
31
|
+
if (token.type === 'codespan')
|
|
32
|
+
return [span(token.text ?? token.raw, ['code'])];
|
|
33
|
+
return [span(token.raw)];
|
|
34
|
+
});
|
|
35
|
+
}
|
|
36
|
+
function textBlock(style, tokens, fallback) {
|
|
37
|
+
const markDefs = [];
|
|
38
|
+
const children = inline(tokens, markDefs);
|
|
39
|
+
return {
|
|
40
|
+
_type: 'block',
|
|
41
|
+
_key: key(),
|
|
42
|
+
style,
|
|
43
|
+
markDefs,
|
|
44
|
+
children: children.length ? children : [span(fallback)],
|
|
45
|
+
};
|
|
46
|
+
}
|
|
47
|
+
/** Decode Markdown without dropping unsupported syntax; opaque tokens become raw blocks. */
|
|
48
|
+
export function markdownToDocsValue(markdown, options = {}) {
|
|
49
|
+
const blocks = [];
|
|
50
|
+
const richSource = markdown.replace(/^:::terra-docs ([A-Za-z]+)\s*\n([\s\S]*?)^:::\s*$/gm, (source, type, json) => {
|
|
51
|
+
try {
|
|
52
|
+
const data = JSON.parse(json);
|
|
53
|
+
if (data._type === type && enabledDocsBlocks(options).includes(type)) {
|
|
54
|
+
const placeholder = `TERRADOCSBLOCK${blocks.length}PLACEHOLDER`;
|
|
55
|
+
blocks.push({ ...data, _key: data._key ?? key() });
|
|
56
|
+
return `\n\n${placeholder}\n\n`;
|
|
57
|
+
}
|
|
58
|
+
}
|
|
59
|
+
catch {
|
|
60
|
+
/* Preserve malformed source. */
|
|
61
|
+
}
|
|
62
|
+
const placeholder = `TERRADOCSBLOCK${blocks.length}PLACEHOLDER`;
|
|
63
|
+
blocks.push({ _type: 'raw', _key: key(), markdown: source });
|
|
64
|
+
return `\n\n${placeholder}\n\n`;
|
|
65
|
+
});
|
|
66
|
+
const source = richSource.replace(/^(===|\|\|\|)\s*\[([^\]\n]+)\]\s*\n([\s\S]*?)^\1\s*$/gm, (_match, delimiter, title, body) => {
|
|
67
|
+
const placeholder = `TERRADOCSBLOCK${blocks.length}PLACEHOLDER`;
|
|
68
|
+
blocks.push({
|
|
69
|
+
_type: delimiter === '===' ? 'accordion' : 'tabs',
|
|
70
|
+
_key: key(),
|
|
71
|
+
items: [{ title, markdown: body, content: [] }],
|
|
72
|
+
markdown: _match,
|
|
73
|
+
});
|
|
74
|
+
return `\n\n${placeholder}\n\n`;
|
|
75
|
+
});
|
|
76
|
+
const parsed = marked.lexer(source, { gfm: true });
|
|
77
|
+
const result = [];
|
|
78
|
+
for (const token of parsed) {
|
|
79
|
+
if (token.type === 'space')
|
|
80
|
+
continue;
|
|
81
|
+
const marker = token.raw.trim().match(/^TERRADOCSBLOCK(\d+)PLACEHOLDER$/);
|
|
82
|
+
if (marker) {
|
|
83
|
+
const block = blocks[Number(marker[1])];
|
|
84
|
+
if (block)
|
|
85
|
+
result.push(block);
|
|
86
|
+
continue;
|
|
87
|
+
}
|
|
88
|
+
if (token.type === 'heading') {
|
|
89
|
+
result.push(textBlock(`h${Math.min(6, Math.max(2, token.depth ?? 2))}`, token.tokens, token.text ?? ''));
|
|
90
|
+
continue;
|
|
91
|
+
}
|
|
92
|
+
if (token.type === 'paragraph' && !/\n\s*\n/.test(token.raw)) {
|
|
93
|
+
result.push(textBlock('normal', token.tokens, token.text ?? ''));
|
|
94
|
+
continue;
|
|
95
|
+
}
|
|
96
|
+
if (token.type === 'blockquote') {
|
|
97
|
+
result.push(textBlock('blockquote', token.tokens, token.text ?? ''));
|
|
98
|
+
continue;
|
|
99
|
+
}
|
|
100
|
+
if (token.type === 'code') {
|
|
101
|
+
result.push({
|
|
102
|
+
_type: 'code',
|
|
103
|
+
_key: key(),
|
|
104
|
+
language: token.lang ?? '',
|
|
105
|
+
value: token.text ?? '',
|
|
106
|
+
});
|
|
107
|
+
continue;
|
|
108
|
+
}
|
|
109
|
+
result.push({ _type: 'raw', _key: key(), markdown: token.raw });
|
|
110
|
+
}
|
|
111
|
+
return result;
|
|
112
|
+
}
|
|
113
|
+
/** Serialize supported visual blocks and keep every opaque raw token verbatim. */
|
|
114
|
+
export function docsValueToMarkdown(value) {
|
|
115
|
+
return (value
|
|
116
|
+
.map((block) => {
|
|
117
|
+
const item = block;
|
|
118
|
+
const extra = Object.keys(item).some((name) => ![
|
|
119
|
+
'_type',
|
|
120
|
+
'_key',
|
|
121
|
+
'markdown',
|
|
122
|
+
'language',
|
|
123
|
+
'source',
|
|
124
|
+
'value',
|
|
125
|
+
'items',
|
|
126
|
+
'code',
|
|
127
|
+
'inline',
|
|
128
|
+
].includes(name));
|
|
129
|
+
if (item._type === 'block') {
|
|
130
|
+
const markDefs = new Map((Array.isArray(item.markDefs) ? item.markDefs : [])
|
|
131
|
+
.filter((mark) => typeof mark === 'object' && mark !== null && '_key' in mark && 'href' in mark)
|
|
132
|
+
.map((mark) => [mark._key, mark.href]));
|
|
133
|
+
const children = Array.isArray(item.children)
|
|
134
|
+
? item.children
|
|
135
|
+
: [];
|
|
136
|
+
const content = children
|
|
137
|
+
.map((child) => {
|
|
138
|
+
if (child._type === 'math')
|
|
139
|
+
return `$${child.code ?? ''}$`;
|
|
140
|
+
let text = child.text ?? '';
|
|
141
|
+
for (const mark of child.marks ?? []) {
|
|
142
|
+
if (mark === 'strong')
|
|
143
|
+
text = `**${text}**`;
|
|
144
|
+
if (mark === 'em')
|
|
145
|
+
text = `*${text}*`;
|
|
146
|
+
if (mark === 'strike-through')
|
|
147
|
+
text = `~~${text}~~`;
|
|
148
|
+
if (mark === 'code')
|
|
149
|
+
text = `\`${text}\``;
|
|
150
|
+
if (markDefs.has(mark))
|
|
151
|
+
text = `[${text}](${markDefs.get(mark)})`;
|
|
152
|
+
}
|
|
153
|
+
return text;
|
|
154
|
+
})
|
|
155
|
+
.join('');
|
|
156
|
+
const style = String(item.style ?? 'normal');
|
|
157
|
+
if (/^h[2-6]$/.test(style))
|
|
158
|
+
return `${'#'.repeat(Number(style[1]))} ${content}`;
|
|
159
|
+
if (style === 'blockquote')
|
|
160
|
+
return `> ${content}`;
|
|
161
|
+
return content;
|
|
162
|
+
}
|
|
163
|
+
if (item._type === 'raw' && !extra)
|
|
164
|
+
return String(item.markdown ?? '');
|
|
165
|
+
if (item._type === 'code' && !extra)
|
|
166
|
+
return `\`\`\`${String(item.language ?? '')}\n${String(item.value ?? '')}\n\`\`\``;
|
|
167
|
+
if (item._type === 'accordion' || item._type === 'tabs') {
|
|
168
|
+
if (item.markdown)
|
|
169
|
+
return item.markdown;
|
|
170
|
+
const delimiter = item._type === 'accordion' ? '===' : '|||';
|
|
171
|
+
return (Array.isArray(item.items) ? item.items : [])
|
|
172
|
+
.map((entry) => `${delimiter}[${entry.title ?? 'Item'}]\n${entry.markdown ?? ''}\n${delimiter}`)
|
|
173
|
+
.join('\n\n');
|
|
174
|
+
}
|
|
175
|
+
return `:::terra-docs ${item._type}\n${JSON.stringify(item)}\n:::`;
|
|
176
|
+
})
|
|
177
|
+
.join('\n\n')
|
|
178
|
+
.replace(/\n{3,}/g, '\n\n')
|
|
179
|
+
.trimEnd() + '\n');
|
|
180
|
+
}
|
|
181
|
+
//# sourceMappingURL=markdown-model.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"markdown-model.js","sourceRoot":"","sources":["../src/markdown-model.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAGhC,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAGhD,MAAM,GAAG,GAAG,GAAG,EAAE,CAAC,MAAM,CAAC,UAAU,EAAE,CAAC;AAUtC,SAAS,IAAI,CAAC,IAAY,EAAE,QAAkB,EAAE;IAC9C,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;AACrD,CAAC;AACD,SAAS,MAAM,CACb,MAA2B,EAC3B,QAAyD;IAEzD,IAAI,CAAC,MAAM;QAAE,OAAO,EAAE,CAAC;IACvB,OAAO,MAAM,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE;QAC9B,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ;YACzB,OAAO,MAAM,CAAC,KAAK,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CACjD,IAAI,CAAC,KAAK,KAAK,MAAM,CAAC,CAAC,CAAC,EAAE,GAAG,IAAI,EAAE,KAAK,EAAE,CAAC,GAAG,IAAI,CAAC,KAAK,EAAE,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAC7E,CAAC;QACJ,IAAI,KAAK,CAAC,IAAI,KAAK,IAAI;YACrB,OAAO,MAAM,CAAC,KAAK,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CACjD,IAAI,CAAC,KAAK,KAAK,MAAM,CAAC,CAAC,CAAC,EAAE,GAAG,IAAI,EAAE,KAAK,EAAE,CAAC,GAAG,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CACzE,CAAC;QACJ,IAAI,KAAK,CAAC,IAAI,KAAK,KAAK;YACtB,OAAO,MAAM,CAAC,KAAK,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CACjD,IAAI,CAAC,KAAK,KAAK,MAAM,CAAC,CAAC,CAAC,EAAE,GAAG,IAAI,EAAE,KAAK,EAAE,CAAC,GAAG,IAAI,CAAC,KAAK,EAAE,gBAAgB,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CACrF,CAAC;QACJ,IAAI,KAAK,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;YAC1B,MAAM,IAAI,GAAG,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;YAC9D,IAAI,CAAC,IAAI,IAAI,CAAC,wCAAwC,CAAC,IAAI,CAAC,IAAI,CAAC;gBAAE,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC;YAC5F,MAAM,IAAI,GAAG,GAAG,EAAE,CAAC;YACnB,QAAQ,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;YACnD,OAAO,MAAM,CAAC,KAAK,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CACjD,IAAI,CAAC,KAAK,KAAK,MAAM,CAAC,CAAC,CAAC,EAAE,GAAG,IAAI,EAAE,KAAK,EAAE,CAAC,GAAG,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CACzE,CAAC;QACJ,CAAC;QACD,IAAI,KAAK,CAAC,IAAI,KAAK,MAAM,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YACrD,MAAM,MAAM,GAAG,CAAC,KAAK,CAAC,IAAI,IAAI,KAAK,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;YACjF,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAC1B,eAAe,CAAC,IAAI,CAAC,KAAK,CAAC;gBACzB,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE;gBACxE,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAChB,CAAC;QACJ,CAAC;QACD,IAAI,KAAK,CAAC,IAAI,KAAK,UAAU;YAAE,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,IAAI,KAAK,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;QAChF,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC;IAC3B,CAAC,CAAC,CAAC;AACL,CAAC;AACD,SAAS,SAAS,CAAC,KAAa,EAAE,MAA2B,EAAE,QAAgB;IAC7E,MAAM,QAAQ,GAAoD,EAAE,CAAC;IACrE,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IAC1C,OAAO;QACL,KAAK,EAAE,OAAO;QACd,IAAI,EAAE,GAAG,EAAE;QACX,KAAK;QACL,QAAQ;QACR,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;KACxD,CAAC;AACJ,CAAC;AAED,4FAA4F;AAC5F,MAAM,UAAU,mBAAmB,CAAC,QAAgB,EAAE,UAA4B,EAAE;IAClF,MAAM,MAAM,GAAgB,EAAE,CAAC;IAC/B,MAAM,UAAU,GAAG,QAAQ,CAAC,OAAO,CACjC,qDAAqD,EACrD,CAAC,MAAM,EAAE,IAAY,EAAE,IAAY,EAAE,EAAE;QACrC,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAc,CAAC;YAC3C,IAAI,IAAI,CAAC,KAAK,KAAK,IAAI,IAAI,iBAAiB,CAAC,OAAO,CAAC,CAAC,QAAQ,CAAC,IAAa,CAAC,EAAE,CAAC;gBAC9E,MAAM,WAAW,GAAG,iBAAiB,MAAM,CAAC,MAAM,aAAa,CAAC;gBAChE,MAAM,CAAC,IAAI,CAAC,EAAE,GAAG,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,IAAI,GAAG,EAAE,EAAE,CAAC,CAAC;gBACnD,OAAO,OAAO,WAAW,MAAM,CAAC;YAClC,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,gCAAgC;QAClC,CAAC;QACD,MAAM,WAAW,GAAG,iBAAiB,MAAM,CAAC,MAAM,aAAa,CAAC;QAChE,MAAM,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,CAAC;QAC7D,OAAO,OAAO,WAAW,MAAM,CAAC;IAClC,CAAC,CACF,CAAC;IACF,MAAM,MAAM,GAAG,UAAU,CAAC,OAAO,CAC/B,wDAAwD,EACxD,CAAC,MAAM,EAAE,SAAiB,EAAE,KAAa,EAAE,IAAY,EAAE,EAAE;QACzD,MAAM,WAAW,GAAG,iBAAiB,MAAM,CAAC,MAAM,aAAa,CAAC;QAChE,MAAM,CAAC,IAAI,CAAC;YACV,KAAK,EAAE,SAAS,KAAK,KAAK,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,MAAM;YACjD,IAAI,EAAE,GAAG,EAAE;YACX,KAAK,EAAE,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC;YAC/C,QAAQ,EAAE,MAAM;SACjB,CAAC,CAAC;QACH,OAAO,OAAO,WAAW,MAAM,CAAC;IAClC,CAAC,CACF,CAAC;IACF,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE,CAAY,CAAC;IAC9D,MAAM,MAAM,GAAgB,EAAE,CAAC;IAC/B,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,IAAI,KAAK,CAAC,IAAI,KAAK,OAAO;YAAE,SAAS;QACrC,MAAM,MAAM,GAAG,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,kCAAkC,CAAC,CAAC;QAC1E,IAAI,MAAM,EAAE,CAAC;YACX,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YACxC,IAAI,KAAK;gBAAE,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YAC9B,SAAS;QACX,CAAC;QACD,IAAI,KAAK,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;YAC7B,MAAM,CAAC,IAAI,CACT,SAAS,CAAC,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,IAAI,IAAI,EAAE,CAAC,CAC5F,CAAC;YACF,SAAS;QACX,CAAC;QACD,IAAI,KAAK,CAAC,IAAI,KAAK,WAAW,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC;YAC7D,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,CAAC;YACjE,SAAS;QACX,CAAC;QACD,IAAI,KAAK,CAAC,IAAI,KAAK,YAAY,EAAE,CAAC;YAChC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,YAAY,EAAE,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,CAAC;YACrE,SAAS;QACX,CAAC;QACD,IAAI,KAAK,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;YAC1B,MAAM,CAAC,IAAI,CAAC;gBACV,KAAK,EAAE,MAAM;gBACb,IAAI,EAAE,GAAG,EAAE;gBACX,QAAQ,EAAE,KAAK,CAAC,IAAI,IAAI,EAAE;gBAC1B,KAAK,EAAE,KAAK,CAAC,IAAI,IAAI,EAAE;aACxB,CAAC,CAAC;YACH,SAAS;QACX,CAAC;QACD,MAAM,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,EAAE,EAAE,QAAQ,EAAE,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC;IAClE,CAAC;IACD,OAAO,MAAmB,CAAC;AAC7B,CAAC;AAED,kFAAkF;AAClF,MAAM,UAAU,mBAAmB,CAAC,KAAgB;IAClD,OAAO,CACL,KAAK;SACF,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE;QACb,MAAM,IAAI,GAAG,KAAkB,CAAC;QAChC,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,CAClC,CAAC,IAAI,EAAE,EAAE,CACP,CAAC;YACC,OAAO;YACP,MAAM;YACN,UAAU;YACV,UAAU;YACV,QAAQ;YACR,OAAO;YACP,OAAO;YACP,MAAM;YACN,QAAQ;SACT,CAAC,QAAQ,CAAC,IAAI,CAAC,CACnB,CAAC;QACF,IAAI,IAAI,CAAC,KAAK,KAAK,OAAO,EAAE,CAAC;YAC3B,MAAM,QAAQ,GAAG,IAAI,GAAG,CACtB,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC;iBAChD,MAAM,CACL,CAAC,IAAI,EAAyD,EAAE,CAC9D,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,IAAI,IAAI,MAAM,IAAI,IAAI,IAAI,MAAM,IAAI,IAAI,CAChF;iBACA,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,CACzC,CAAC;YACF,MAAM,QAAQ,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC;gBAC3C,CAAC,CAAE,IAAI,CAAC,QAKF;gBACN,CAAC,CAAC,EAAE,CAAC;YACP,MAAM,OAAO,GAAG,QAAQ;iBACrB,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE;gBACb,IAAI,KAAK,CAAC,KAAK,KAAK,MAAM;oBAAE,OAAO,IAAI,KAAK,CAAC,IAAI,IAAI,EAAE,GAAG,CAAC;gBAC3D,IAAI,IAAI,GAAG,KAAK,CAAC,IAAI,IAAI,EAAE,CAAC;gBAC5B,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,KAAK,IAAI,EAAE,EAAE,CAAC;oBACrC,IAAI,IAAI,KAAK,QAAQ;wBAAE,IAAI,GAAG,KAAK,IAAI,IAAI,CAAC;oBAC5C,IAAI,IAAI,KAAK,IAAI;wBAAE,IAAI,GAAG,IAAI,IAAI,GAAG,CAAC;oBACtC,IAAI,IAAI,KAAK,gBAAgB;wBAAE,IAAI,GAAG,KAAK,IAAI,IAAI,CAAC;oBACpD,IAAI,IAAI,KAAK,MAAM;wBAAE,IAAI,GAAG,KAAK,IAAI,IAAI,CAAC;oBAC1C,IAAI,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC;wBAAE,IAAI,GAAG,IAAI,IAAI,KAAK,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC;gBACpE,CAAC;gBACD,OAAO,IAAI,CAAC;YACd,CAAC,CAAC;iBACD,IAAI,CAAC,EAAE,CAAC,CAAC;YACZ,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,IAAI,QAAQ,CAAC,CAAC;YAC7C,IAAI,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC;gBAAE,OAAO,GAAG,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,OAAO,EAAE,CAAC;YAChF,IAAI,KAAK,KAAK,YAAY;gBAAE,OAAO,KAAK,OAAO,EAAE,CAAC;YAClD,OAAO,OAAO,CAAC;QACjB,CAAC;QACD,IAAI,IAAI,CAAC,KAAK,KAAK,KAAK,IAAI,CAAC,KAAK;YAAE,OAAO,MAAM,CAAC,IAAI,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC;QACvE,IAAI,IAAI,CAAC,KAAK,KAAK,MAAM,IAAI,CAAC,KAAK;YACjC,OAAO,SAAS,MAAM,CAAC,IAAI,CAAC,QAAQ,IAAI,EAAE,CAAC,KAAK,MAAM,CAAC,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC,UAAU,CAAC;QACrF,IAAI,IAAI,CAAC,KAAK,KAAK,WAAW,IAAI,IAAI,CAAC,KAAK,KAAK,MAAM,EAAE,CAAC;YACxD,IAAI,IAAI,CAAC,QAAQ;gBAAE,OAAO,IAAI,CAAC,QAAQ,CAAC;YACxC,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,KAAK,WAAW,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC;YAC7D,OAAO,CACL,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAE,IAAI,CAAC,KAAiD,CAAC,CAAC,CAAC,EAAE,CACzF;iBACE,GAAG,CACF,CAAC,KAAK,EAAE,EAAE,CACR,GAAG,SAAS,IAAI,KAAK,CAAC,KAAK,IAAI,MAAM,MAAM,KAAK,CAAC,QAAQ,IAAI,EAAE,KAAK,SAAS,EAAE,CAClF;iBACA,IAAI,CAAC,MAAM,CAAC,CAAC;QAClB,CAAC;QACD,OAAO,iBAAiB,IAAI,CAAC,KAAK,KAAK,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC;IACrE,CAAC,CAAC;SACD,IAAI,CAAC,MAAM,CAAC;SACZ,OAAO,CAAC,SAAS,EAAE,MAAM,CAAC;SAC1B,OAAO,EAAE,GAAG,IAAI,CACpB,CAAC;AACJ,CAAC"}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"markdown.d.ts","sourceRoot":"","sources":["../src/markdown.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,gBAAgB,EAAa,MAAM,aAAa,CAAC;AAE/D,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,GAAE,gBAAqB,GAAG,MAAM,CAgGvF"}
|
|
@@ -0,0 +1,83 @@
|
|
|
1
|
+
import { Marked } from 'marked';
|
|
2
|
+
import sanitizeHtml from 'sanitize-html';
|
|
3
|
+
import { createElement } from 'react';
|
|
4
|
+
import { renderToStaticMarkup } from 'react-dom/server';
|
|
5
|
+
import { DocsRichBlock, enabledDocsBlocks } from './blocks.js';
|
|
6
|
+
export function renderMarkdown(markdown, options = {}) {
|
|
7
|
+
const rendered = [];
|
|
8
|
+
const placeholder = (html) => {
|
|
9
|
+
const marker = `TERRADOCSRICHPLACEHOLDER${rendered.length}END`;
|
|
10
|
+
rendered.push(html);
|
|
11
|
+
return marker;
|
|
12
|
+
};
|
|
13
|
+
const portable = markdown.replace(/^:::terra-docs ([A-Za-z]+)\s*\n([\s\S]*?)^:::\s*$/gm, (source, type, json) => {
|
|
14
|
+
try {
|
|
15
|
+
const data = JSON.parse(json);
|
|
16
|
+
if (!enabledDocsBlocks(options).includes(type) || data._type !== type)
|
|
17
|
+
return placeholder(`<pre>${sanitizeHtml(source, { allowedTags: [], allowedAttributes: {} })}</pre>`);
|
|
18
|
+
return placeholder(renderToStaticMarkup(createElement(DocsRichBlock, { block: data })));
|
|
19
|
+
}
|
|
20
|
+
catch {
|
|
21
|
+
return placeholder(`<pre>${sanitizeHtml(source, { allowedTags: [], allowedAttributes: {} })}</pre>`);
|
|
22
|
+
}
|
|
23
|
+
});
|
|
24
|
+
const withMath = portable.replace(/^\$\$\s*\n([\s\S]*?)^\$\$\s*$/gm, (_source, code) => options.math === false
|
|
25
|
+
? _source
|
|
26
|
+
: placeholder(renderToStaticMarkup(createElement(DocsRichBlock, { block: { _type: 'math', code } }))));
|
|
27
|
+
const parser = new Marked({ gfm: true });
|
|
28
|
+
if (options.inlineMath !== false && options.math !== false)
|
|
29
|
+
parser.use({
|
|
30
|
+
extensions: [
|
|
31
|
+
{
|
|
32
|
+
name: 'terraInlineMath',
|
|
33
|
+
level: 'inline',
|
|
34
|
+
start: (source) => source.indexOf('$'),
|
|
35
|
+
tokenizer(source) {
|
|
36
|
+
const match = /^\$([^$\n]+)\$/.exec(source);
|
|
37
|
+
return match ? { type: 'terraInlineMath', raw: match[0], text: match[1] } : undefined;
|
|
38
|
+
},
|
|
39
|
+
renderer(token) {
|
|
40
|
+
return placeholder(renderToStaticMarkup(createElement(DocsRichBlock, {
|
|
41
|
+
block: { _type: 'math', code: token.text, inline: true },
|
|
42
|
+
})));
|
|
43
|
+
},
|
|
44
|
+
},
|
|
45
|
+
],
|
|
46
|
+
});
|
|
47
|
+
let blockNumber = 0;
|
|
48
|
+
const rich = withMath.replace(/^(===|\|\|\|)\s*\[([^\]\n]+)\]\s*\n([\s\S]*?)^\1\s*$/gm, (_match, delimiter, title, body) => {
|
|
49
|
+
const summary = sanitizeHtml(title, { allowedTags: [], allowedAttributes: {} });
|
|
50
|
+
const content = parser.parse(body, { async: false });
|
|
51
|
+
if (delimiter === '===')
|
|
52
|
+
return `<details class="terra-docs-accordion"><summary>${summary}</summary>${content}</details>`;
|
|
53
|
+
blockNumber += 1;
|
|
54
|
+
return `<details class="terra-docs-tab" data-tab="${blockNumber}"><summary>${summary}</summary>${content}</details>`;
|
|
55
|
+
});
|
|
56
|
+
const html = parser.parse(rich, { async: false });
|
|
57
|
+
const safe = sanitizeHtml(html, {
|
|
58
|
+
...sanitizeHtml.defaults,
|
|
59
|
+
allowedTags: [
|
|
60
|
+
...sanitizeHtml.defaults.allowedTags,
|
|
61
|
+
'img',
|
|
62
|
+
'details',
|
|
63
|
+
'summary',
|
|
64
|
+
'input',
|
|
65
|
+
'table',
|
|
66
|
+
'thead',
|
|
67
|
+
'tbody',
|
|
68
|
+
'tr',
|
|
69
|
+
'th',
|
|
70
|
+
'td',
|
|
71
|
+
],
|
|
72
|
+
allowedAttributes: {
|
|
73
|
+
...sanitizeHtml.defaults.allowedAttributes,
|
|
74
|
+
a: ['href', 'name', 'target', 'rel', 'id'],
|
|
75
|
+
img: ['src', 'alt', 'title', 'width', 'height'],
|
|
76
|
+
input: ['type', 'checked', 'disabled'],
|
|
77
|
+
'*': ['id', 'class', 'aria-label'],
|
|
78
|
+
},
|
|
79
|
+
allowedSchemes: ['http', 'https', 'mailto'],
|
|
80
|
+
});
|
|
81
|
+
return safe.replace(/TERRADOCSRICHPLACEHOLDER(\d+)END/g, (_match, index) => rendered[Number(index)] ?? '');
|
|
82
|
+
}
|
|
83
|
+
//# sourceMappingURL=markdown.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"markdown.js","sourceRoot":"","sources":["../src/markdown.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAChC,OAAO,YAAY,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AACtC,OAAO,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AACxD,OAAO,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAG/D,MAAM,UAAU,cAAc,CAAC,QAAgB,EAAE,UAA4B,EAAE;IAC7E,MAAM,QAAQ,GAAa,EAAE,CAAC;IAC9B,MAAM,WAAW,GAAG,CAAC,IAAY,EAAE,EAAE;QACnC,MAAM,MAAM,GAAG,2BAA2B,QAAQ,CAAC,MAAM,KAAK,CAAC;QAC/D,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACpB,OAAO,MAAM,CAAC;IAChB,CAAC,CAAC;IACF,MAAM,QAAQ,GAAG,QAAQ,CAAC,OAAO,CAC/B,qDAAqD,EACrD,CAAC,MAAM,EAAE,IAAY,EAAE,IAAY,EAAE,EAAE;QACrC,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAc,CAAC;YAC3C,IAAI,CAAC,iBAAiB,CAAC,OAAO,CAAC,CAAC,QAAQ,CAAC,IAAa,CAAC,IAAI,IAAI,CAAC,KAAK,KAAK,IAAI;gBAC5E,OAAO,WAAW,CAChB,QAAQ,YAAY,CAAC,MAAM,EAAE,EAAE,WAAW,EAAE,EAAE,EAAE,iBAAiB,EAAE,EAAE,EAAE,CAAC,QAAQ,CACjF,CAAC;YACJ,OAAO,WAAW,CAAC,oBAAoB,CAAC,aAAa,CAAC,aAAa,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QAC1F,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,WAAW,CAChB,QAAQ,YAAY,CAAC,MAAM,EAAE,EAAE,WAAW,EAAE,EAAE,EAAE,iBAAiB,EAAE,EAAE,EAAE,CAAC,QAAQ,CACjF,CAAC;QACJ,CAAC;IACH,CAAC,CACF,CAAC;IACF,MAAM,QAAQ,GAAG,QAAQ,CAAC,OAAO,CAAC,iCAAiC,EAAE,CAAC,OAAO,EAAE,IAAY,EAAE,EAAE,CAC7F,OAAO,CAAC,IAAI,KAAK,KAAK;QACpB,CAAC,CAAC,OAAO;QACT,CAAC,CAAC,WAAW,CACT,oBAAoB,CAAC,aAAa,CAAC,aAAa,EAAE,EAAE,KAAK,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,CAAC,CAAC,CACvF,CACN,CAAC;IACF,MAAM,MAAM,GAAG,IAAI,MAAM,CAAC,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC;IACzC,IAAI,OAAO,CAAC,UAAU,KAAK,KAAK,IAAI,OAAO,CAAC,IAAI,KAAK,KAAK;QACxD,MAAM,CAAC,GAAG,CAAC;YACT,UAAU,EAAE;gBACV;oBACE,IAAI,EAAE,iBAAiB;oBACvB,KAAK,EAAE,QAAQ;oBACf,KAAK,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC;oBACtC,SAAS,CAAC,MAAM;wBACd,MAAM,KAAK,GAAG,gBAAgB,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;wBAC5C,OAAO,KAAK,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,iBAAiB,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;oBACxF,CAAC;oBACD,QAAQ,CAAC,KAAK;wBACZ,OAAO,WAAW,CAChB,oBAAoB,CAClB,aAAa,CAAC,aAAa,EAAE;4BAC3B,KAAK,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE;yBACzD,CAAC,CACH,CACF,CAAC;oBACJ,CAAC;iBACF;aACF;SACF,CAAC,CAAC;IACL,IAAI,WAAW,GAAG,CAAC,CAAC;IACpB,MAAM,IAAI,GAAG,QAAQ,CAAC,OAAO,CAC3B,wDAAwD,EACxD,CAAC,MAAM,EAAE,SAAiB,EAAE,KAAa,EAAE,IAAY,EAAE,EAAE;QACzD,MAAM,OAAO,GAAG,YAAY,CAAC,KAAK,EAAE,EAAE,WAAW,EAAE,EAAE,EAAE,iBAAiB,EAAE,EAAE,EAAE,CAAC,CAAC;QAChF,MAAM,OAAO,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;QACrD,IAAI,SAAS,KAAK,KAAK;YACrB,OAAO,kDAAkD,OAAO,aAAa,OAAO,YAAY,CAAC;QACnG,WAAW,IAAI,CAAC,CAAC;QACjB,OAAO,6CAA6C,WAAW,cAAc,OAAO,aAAa,OAAO,YAAY,CAAC;IACvH,CAAC,CACF,CAAC;IACF,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;IAClD,MAAM,IAAI,GAAG,YAAY,CAAC,IAAI,EAAE;QAC9B,GAAG,YAAY,CAAC,QAAQ;QACxB,WAAW,EAAE;YACX,GAAG,YAAY,CAAC,QAAQ,CAAC,WAAW;YACpC,KAAK;YACL,SAAS;YACT,SAAS;YACT,OAAO;YACP,OAAO;YACP,OAAO;YACP,OAAO;YACP,IAAI;YACJ,IAAI;YACJ,IAAI;SACL;QACD,iBAAiB,EAAE;YACjB,GAAG,YAAY,CAAC,QAAQ,CAAC,iBAAiB;YAC1C,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,IAAI,CAAC;YAC1C,GAAG,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,QAAQ,CAAC;YAC/C,KAAK,EAAE,CAAC,MAAM,EAAE,SAAS,EAAE,UAAU,CAAC;YACtC,GAAG,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,YAAY,CAAC;SACnC;QACD,cAAc,EAAE,CAAC,MAAM,EAAE,OAAO,EAAE,QAAQ,CAAC;KAC5C,CAAC,CAAC;IACH,OAAO,IAAI,CAAC,OAAO,CACjB,mCAAmC,EACnC,CAAC,MAAM,EAAE,KAAa,EAAE,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,CACzD,CAAC;AACJ,CAAC"}
|
|
@@ -0,0 +1,17 @@
|
|
|
1
|
+
import type { JSX } from 'react';
|
|
2
|
+
export type DocsNavNode = {
|
|
3
|
+
id?: string;
|
|
4
|
+
path?: string;
|
|
5
|
+
title: string;
|
|
6
|
+
href?: string;
|
|
7
|
+
description?: string;
|
|
8
|
+
updatedAt?: string;
|
|
9
|
+
attachments?: import('./workspace.js').DocsAttachment[];
|
|
10
|
+
children?: DocsNavNode[];
|
|
11
|
+
};
|
|
12
|
+
export declare function DocsNavigation({ nodes, currentPath, hue, }: {
|
|
13
|
+
nodes: DocsNavNode[];
|
|
14
|
+
currentPath: string;
|
|
15
|
+
hue?: number | null;
|
|
16
|
+
}): JSX.Element;
|
|
17
|
+
//# sourceMappingURL=navigation.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"navigation.d.ts","sourceRoot":"","sources":["../src/navigation.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAiB,GAAG,EAAE,MAAM,OAAO,CAAC;AAEhD,MAAM,MAAM,WAAW,GAAG;IACxB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,OAAO,gBAAgB,EAAE,cAAc,EAAE,CAAC;IACxD,QAAQ,CAAC,EAAE,WAAW,EAAE,CAAC;CAC1B,CAAC;AAEF,wBAAgB,cAAc,CAAC,EAC7B,KAAK,EACL,WAAW,EACX,GAAS,GACV,EAAE;IACD,KAAK,EAAE,WAAW,EAAE,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACrB,GAAG,GAAG,CAAC,OAAO,CAwBd"}
|
|
@@ -0,0 +1,9 @@
|
|
|
1
|
+
import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
|
|
2
|
+
import { colors } from '@terra-symposium/styling';
|
|
3
|
+
export function DocsNavigation({ nodes, currentPath, hue = 210, }) {
|
|
4
|
+
const [accent] = colors(hue);
|
|
5
|
+
const style = { '--docs-accent': `rgb(${accent.light[8]})` };
|
|
6
|
+
const render = (items) => (_jsx("ul", { className: "terra-docs-nav-list", children: items.map((node, index) => (_jsxs("li", { children: [node.href ? (_jsx("a", { href: node.href, "aria-current": node.href === currentPath ? 'page' : undefined, children: node.title })) : (_jsx("span", { children: node.title })), node.children?.length ? render(node.children) : null] }, `${node.href ?? node.title}-${index}`))) }));
|
|
7
|
+
return (_jsx("nav", { className: "terra-docs-nav", "aria-label": "Documentation", style: style, children: render(nodes) }));
|
|
8
|
+
}
|
|
9
|
+
//# sourceMappingURL=navigation.js.map
|