@terra-symposium/docs 0.0.0-stage → 0.1.71

package/lib-dist/components/terra/editor/docs/heading.js

@@ -0,0 +1,63 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+// @ts-nocheck -- source-preserving extraction; public host contracts are typed in src/host.ts.
+/**
+ * astro/src/components/editor/docs/heading.tsx
+ * Shared Docs heading identifiers and copyable read-only headings.
+ */
+/*//////////////////////////////////////////////////
+IMPORTS
+//////////////////////////////////////////////////*/
+import { Children, isValidElement, useEffect, useRef, useState } from 'react';
+import { Link as LinkIcon } from '@carbon/icons-react';
+import * as TerraQualityRegex from '../../../../lib/terra/regex.mjs';
+/*//////////////////////////////////////////////////
+CONFIG
+//////////////////////////////////////////////////*/
+/*//////////////////////////////////////////////////
+HELPERS
+//////////////////////////////////////////////////*/
+/**
+ * Normalizes text into the URL identifier used by Docs headings and their table of contents.
+ *
+ * @param text - The heading text to normalize.
+ * @returns The heading's URL fragment.
+ */
+export const toHeadingId = (text) => text
+    .toLowerCase()
+    .replace(TerraQualityRegex.REGEX_A_Z0_9_G_REGEX(), '-')
+    .replace(TerraQualityRegex.REGEX_G_REGEX_6(), '');
+/*//////////////////////////////////////////////////
+COMPONENTS
+//////////////////////////////////////////////////*/
+/**
+ * Renders a Docs heading with a keyboard-accessible control for copying its link.
+ *
+ * @param props - The heading level and its content.
+ * @returns A heading with a copy-link button.
+ */
+export function DocsHeading({ children, level, }) {
+    const headingRef = useRef(null);
+    const [text, setText] = useState(() => {
+        const pending = Children.toArray(children).reverse();
+        let result = '';
+        while (pending.length > 0) {
+            const child = pending.pop();
+            if (typeof child === 'string' || typeof child === 'number')
+                result += String(child);
+            else if (isValidElement(child))
+                pending.push(...Children.toArray(child.props.children).reverse());
+        }
+        return result.trim();
+    });
+    useEffect(() => {
+        const renderedText = headingRef.current?.textContent?.trim();
+        if (renderedText)
+            setText(renderedText);
+    }, [children]);
+    const id = toHeadingId(text);
+    const Heading = level;
+    return (_jsx(Heading, { id: id, ref: headingRef, children: _jsxs("button", { type: "button", className: "heading-anchor", "aria-label": `Copy link to ${text}`, title: `Copy link to ${text}`, onClick: () => {
+                void navigator.clipboard.writeText(`${window.location.origin}${window.location.pathname}#${id}`);
+            }, children: [children, _jsx("span", { className: "heading-anchor-icon", "aria-hidden": "true", children: _jsx(LinkIcon, {}) })] }) }));
+}
+//# sourceMappingURL=heading.js.map

package/lib-dist/components/terra/editor/docs/heading.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"heading.js","sourceRoot":"","sources":["../../../../../src/components/terra/editor/docs/heading.tsx"],"names":[],"mappings":";AAAA,+FAA+F;AAC/F;;;GAGG;AAEH;;oDAEoD;AAEpD,OAAO,EAAE,QAAQ,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAC9E,OAAO,EAAE,IAAI,IAAI,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,KAAK,iBAAiB,MAAM,iCAAiC,CAAC;AAIrE;;oDAEoD;AAEpD;;oDAEoD;AAEpD;;;;;GAKG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,IAAY,EAAU,EAAE,CAClD,IAAI;KACD,WAAW,EAAE;KACb,OAAO,CAAC,iBAAiB,CAAC,oBAAoB,EAAE,EAAE,GAAG,CAAC;KACtD,OAAO,CAAC,iBAAiB,CAAC,eAAe,EAAE,EAAE,EAAE,CAAC,CAAC;AAEtD;;oDAEoD;AAEpD;;;;;GAKG;AACH,MAAM,UAAU,WAAW,CAAC,EAC1B,QAAQ,EACR,KAAK,GAIN;IACC,MAAM,UAAU,GAAG,MAAM,CAAqB,IAAI,CAAC,CAAC;IACpD,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,GAAG,QAAQ,CAAC,GAAG,EAAE;QACpC,MAAM,OAAO,GAAG,QAAQ,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,OAAO,EAAE,CAAC;QACrD,IAAI,MAAM,GAAG,EAAE,CAAC;QAChB,OAAO,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC1B,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;YAC5B,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,OAAO,KAAK,KAAK,QAAQ;gBAAE,MAAM,IAAI,MAAM,CAAC,KAAK,CAAC,CAAC;iBAC/E,IAAI,cAAc,CAA2B,KAAK,CAAC;gBACtD,OAAO,CAAC,IAAI,CAAC,GAAG,QAAQ,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;QACtE,CAAC;QACD,OAAO,MAAM,CAAC,IAAI,EAAE,CAAC;IACvB,CAAC,CAAC,CAAC;IACH,SAAS,CAAC,GAAG,EAAE;QACb,MAAM,YAAY,GAAG,UAAU,CAAC,OAAO,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC;QAC7D,IAAI,YAAY;YAAE,OAAO,CAAC,YAAY,CAAC,CAAC;IAC1C,CAAC,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC;IACf,MAAM,EAAE,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC;IAC7B,MAAM,OAAO,GAAG,KAAK,CAAC;IACtB,OAAO,CACL,KAAC,OAAO,IAAC,EAAE,EAAE,EAAE,EAAE,GAAG,EAAE,UAAU,YAC9B,kBACE,IAAI,EAAC,QAAQ,EACb,SAAS,EAAC,gBAAgB,gBACd,gBAAgB,IAAI,EAAE,EAClC,KAAK,EAAE,gBAAgB,IAAI,EAAE,EAC7B,OAAO,EAAE,GAAG,EAAE;gBACZ,KAAK,SAAS,CAAC,SAAS,CAAC,SAAS,CAChC,GAAG,MAAM,CAAC,QAAQ,CAAC,MAAM,GAAG,MAAM,CAAC,QAAQ,CAAC,QAAQ,IAAI,EAAE,EAAE,CAC7D,CAAC;YACJ,CAAC,aAEA,QAAQ,EACT,eAAM,SAAS,EAAC,qBAAqB,iBAAa,MAAM,YACtD,KAAC,QAAQ,KAAG,GACP,IACA,GACD,CACX,CAAC;AACJ,CAAC"}

package/lib-dist/components/terra/editor/docs/index.d.ts

@@ -0,0 +1,13 @@
+/** Internal Docs renderer contracts. */
+export { default as _DocsMathInline } from './_math_inline.js';
+export { renderCallout as _Callout } from './_Callout.js';
+export { renderCode as _Code } from './_DocsCode.js';
+export { Embed as _Embed } from './_Embed.js';
+export { renderImage as _Image } from './_DocsImage.js';
+export { renderMathBlock as _MathBlock } from './_Math.js';
+export { NodesBlock as _NodesBlock } from './_Nodes.js';
+export { Raw as _Raw } from './_Raw.js';
+export { renderTable as _Table } from './_Table.js';
+export { renderSections as _Sections } from './_Tabs.js';
+export { TsDocs as _TsDocs } from './_TsDocs.js';
+//# sourceMappingURL=index.d.ts.map

package/lib-dist/components/terra/editor/docs/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/components/terra/editor/docs/index.ts"],"names":[],"mappings":"AACA,wCAAwC;AAExC,OAAO,EAAE,OAAO,IAAI,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAC/D,OAAO,EAAE,aAAa,IAAI,QAAQ,EAAE,MAAM,eAAe,CAAC;AAC1D,OAAO,EAAE,UAAU,IAAI,KAAK,EAAE,MAAM,gBAAgB,CAAC;AACrD,OAAO,EAAE,KAAK,IAAI,MAAM,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EAAE,WAAW,IAAI,MAAM,EAAE,MAAM,iBAAiB,CAAC;AACxD,OAAO,EAAE,eAAe,IAAI,UAAU,EAAE,MAAM,YAAY,CAAC;AAC3D,OAAO,EAAE,UAAU,IAAI,WAAW,EAAE,MAAM,aAAa,CAAC;AACxD,OAAO,EAAE,GAAG,IAAI,IAAI,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,EAAE,WAAW,IAAI,MAAM,EAAE,MAAM,aAAa,CAAC;AACpD,OAAO,EAAE,cAAc,IAAI,SAAS,EAAE,MAAM,YAAY,CAAC;AACzD,OAAO,EAAE,MAAM,IAAI,OAAO,EAAE,MAAM,cAAc,CAAC"}

package/lib-dist/components/terra/editor/docs/index.js

@@ -0,0 +1,14 @@
+// @ts-nocheck -- source-preserving extraction; public host contracts are typed in src/host.ts.
+/** Internal Docs renderer contracts. */
+export { default as _DocsMathInline } from './_math_inline.js';
+export { renderCallout as _Callout } from './_Callout.js';
+export { renderCode as _Code } from './_DocsCode.js';
+export { Embed as _Embed } from './_Embed.js';
+export { renderImage as _Image } from './_DocsImage.js';
+export { renderMathBlock as _MathBlock } from './_Math.js';
+export { NodesBlock as _NodesBlock } from './_Nodes.js';
+export { Raw as _Raw } from './_Raw.js';
+export { renderTable as _Table } from './_Table.js';
+export { renderSections as _Sections } from './_Tabs.js';
+export { TsDocs as _TsDocs } from './_TsDocs.js';
+//# sourceMappingURL=index.js.map

package/lib-dist/components/terra/editor/docs/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/components/terra/editor/docs/index.ts"],"names":[],"mappings":"AAAA,+FAA+F;AAC/F,wCAAwC;AAExC,OAAO,EAAE,OAAO,IAAI,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAC/D,OAAO,EAAE,aAAa,IAAI,QAAQ,EAAE,MAAM,eAAe,CAAC;AAC1D,OAAO,EAAE,UAAU,IAAI,KAAK,EAAE,MAAM,gBAAgB,CAAC;AACrD,OAAO,EAAE,KAAK,IAAI,MAAM,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EAAE,WAAW,IAAI,MAAM,EAAE,MAAM,iBAAiB,CAAC;AACxD,OAAO,EAAE,eAAe,IAAI,UAAU,EAAE,MAAM,YAAY,CAAC;AAC3D,OAAO,EAAE,UAAU,IAAI,WAAW,EAAE,MAAM,aAAa,CAAC;AACxD,OAAO,EAAE,GAAG,IAAI,IAAI,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,EAAE,WAAW,IAAI,MAAM,EAAE,MAAM,aAAa,CAAC;AACpD,OAAO,EAAE,cAAc,IAAI,SAAS,EAAE,MAAM,YAAY,CAAC;AACzD,OAAO,EAAE,MAAM,IAAI,OAAO,EAAE,MAAM,cAAc,CAAC"}

package/lib-dist/components/terra/editor/terra-content.styles.d.ts

@@ -0,0 +1,3 @@
+/** Original Terra Content reading typography shared by Docs and other profiles. */
+export declare const TERRA_CONTENT_PROSE_CLASS = "mx-auto max-w-3xl text-base leading-8 text-primary-12 [&_a:not([data-docs-flow-node-link])]:text-secondary-10 [&_a:not([data-docs-flow-node-link])]:underline [&_blockquote]:my-6 [&_blockquote]:border-l-2 [&_blockquote]:border-secondary-7 [&_blockquote]:pl-5 [&_blockquote]:text-primary-11 [&_h2]:mb-3 [&_h2]:mt-10 [&_h2]:text-3xl [&_h2]:font-semibold [&_h2]:tracking-tight [&_h3]:mb-3 [&_h3]:mt-8 [&_h3]:text-2xl [&_h3]:font-semibold [&_h4]:mb-2 [&_h4]:mt-6 [&_h4]:text-xl [&_h5]:mb-2 [&_h5]:mt-6 [&_h5]:font-semibold [&_h6]:mb-2 [&_h6]:mt-5 [&_h6]:font-semibold [&_p:first-child]:mt-0 [&_p]:my-4";
+//# sourceMappingURL=terra-content.styles.d.ts.map

package/lib-dist/components/terra/editor/terra-content.styles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"terra-content.styles.d.ts","sourceRoot":"","sources":["../../../../src/components/terra/editor/terra-content.styles.ts"],"names":[],"mappings":"AAAA,mFAAmF;AACnF,eAAO,MAAM,yBAAyB,ylBACkjB,CAAC"}

package/lib-dist/components/terra/editor/terra-content.styles.js

@@ -0,0 +1,3 @@
+/** Original Terra Content reading typography shared by Docs and other profiles. */
+export const TERRA_CONTENT_PROSE_CLASS = 'mx-auto max-w-3xl text-base leading-8 text-primary-12 [&_a:not([data-docs-flow-node-link])]:text-secondary-10 [&_a:not([data-docs-flow-node-link])]:underline [&_blockquote]:my-6 [&_blockquote]:border-l-2 [&_blockquote]:border-secondary-7 [&_blockquote]:pl-5 [&_blockquote]:text-primary-11 [&_h2]:mb-3 [&_h2]:mt-10 [&_h2]:text-3xl [&_h2]:font-semibold [&_h2]:tracking-tight [&_h3]:mb-3 [&_h3]:mt-8 [&_h3]:text-2xl [&_h3]:font-semibold [&_h4]:mb-2 [&_h4]:mt-6 [&_h4]:text-xl [&_h5]:mb-2 [&_h5]:mt-6 [&_h5]:font-semibold [&_h6]:mb-2 [&_h6]:mt-5 [&_h6]:font-semibold [&_p:first-child]:mt-0 [&_p]:my-4';
+//# sourceMappingURL=terra-content.styles.js.map

package/lib-dist/components/terra/editor/terra-content.styles.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"terra-content.styles.js","sourceRoot":"","sources":["../../../../src/components/terra/editor/terra-content.styles.ts"],"names":[],"mappings":"AAAA,mFAAmF;AACnF,MAAM,CAAC,MAAM,yBAAyB,GACpC,slBAAslB,CAAC"}

package/lib-dist/components/terra/editor/types.d.ts

@@ -0,0 +1,40 @@
+/**
+ * astro/src/components/editor/types.ts
+ * Shared Terra content and Portable Text renderer contracts.
+ */
+import { DOCS_BLOCK_SCHEMAS, PROBLEM_BLOCK_TYPES } from '../../../lib/terra/runtime/types.js';
+import type { ArticleContent, DocsContent, ProblemContent } from '../../../lib/terra/runtime/types.js';
+import type { BlockObjectRenderProps } from '@portabletext/editor';
+/** Sanity Portable Text block names supported by the docs editor. */
+export type DocsBlockType = Extract<keyof typeof DOCS_BLOCK_SCHEMAS, DocsContent[number]['_type']>;
+/** Extracts one docs block shape by its Sanity `_type` discriminator. */
+export type DocsMember<T extends DocsContent[number]['_type']> = Extract<DocsContent[number], {
+    _type: T;
+}>;
+/** Resolves a docs block shape for a supported docs block name. */
+export type DocsBlock<T extends DocsBlockType> = DocsMember<T>;
+/** Inline Sanity content types supported by article editors. */
+export type ArticleInlineType = 'image' | 'video' | 'table' | 'questions' | 'dialogue' | 'definition';
+/** Article inline block shape selected by its Sanity type discriminator. */
+export type ArticleInline<T extends ArticleInlineType> = Extract<NonNullable<Extract<ArticleContent[number], {
+    children?: unknown;
+}>['children']>[number], {
+    _type: T;
+}>;
+/** Sanity Portable Text block names supported by the problem editor. */
+export type ProblemBlockType = (typeof PROBLEM_BLOCK_TYPES)[number];
+/** Resolves a problem block shape for a supported problem block name. */
+export type ProblemBlock<T extends ProblemBlockType> = Extract<ProblemContent[number], {
+    _type: T;
+}>;
+/** Extracts one problem inline shape by its Sanity `_type` discriminator. */
+export type ProblemInline<T extends 'definition'> = Extract<ProblemContent[number], {
+    _type: T;
+}>;
+/** Props supplied to a read-only renderer for a typed Portable Text block. */
+export type PortableTextBlockRendererProps<TBlock> = Pick<BlockObjectRenderProps, 'attributes' | 'children' | 'path' | 'readOnly'> & {
+    node: TBlock;
+};
+/** Props supplied to an editable renderer for a typed Portable Text block. */
+export type PortableTextBlockEditorProps<TBlock> = Omit<PortableTextBlockRendererProps<TBlock>, 'readOnly'>;
+//# sourceMappingURL=types.d.ts.map

package/lib-dist/components/terra/editor/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/components/terra/editor/types.ts"],"names":[],"mappings":"AACA;;;GAGG;AAOH,OAAO,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,qCAAqC,CAAC;AAG9F,OAAO,KAAK,EACV,cAAc,EACd,WAAW,EACX,cAAc,EACf,MAAM,qCAAqC,CAAC;AAC7C,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AAMnE,qEAAqE;AACrE,MAAM,MAAM,aAAa,GAAG,OAAO,CAAC,MAAM,OAAO,kBAAkB,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;AACnG,yEAAyE;AACzE,MAAM,MAAM,UAAU,CAAC,CAAC,SAAS,WAAW,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,IAAI,OAAO,CACtE,WAAW,CAAC,MAAM,CAAC,EACnB;IAAE,KAAK,EAAE,CAAC,CAAA;CAAE,CACb,CAAC;AACF,mEAAmE;AACnE,MAAM,MAAM,SAAS,CAAC,CAAC,SAAS,aAAa,IAAI,UAAU,CAAC,CAAC,CAAC,CAAC;AAC/D,gEAAgE;AAChE,MAAM,MAAM,iBAAiB,GAC3B,OAAO,GAAG,OAAO,GAAG,OAAO,GAAG,WAAW,GAAG,UAAU,GAAG,YAAY,CAAC;AAExE,4EAA4E;AAC5E,MAAM,MAAM,aAAa,CAAC,CAAC,SAAS,iBAAiB,IAAI,OAAO,CAC9D,WAAW,CACT,OAAO,CACL,cAAc,CAAC,MAAM,CAAC,EACtB;IACE,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB,CACF,CAAC,UAAU,CAAC,CACd,CAAC,MAAM,CAAC,EACT;IAAE,KAAK,EAAE,CAAC,CAAA;CAAE,CACb,CAAC;AACF,wEAAwE;AACxE,MAAM,MAAM,gBAAgB,GAAG,CAAC,OAAO,mBAAmB,CAAC,CAAC,MAAM,CAAC,CAAC;AACpE,yEAAyE;AACzE,MAAM,MAAM,YAAY,CAAC,CAAC,SAAS,gBAAgB,IAAI,OAAO,CAC5D,cAAc,CAAC,MAAM,CAAC,EACtB;IAAE,KAAK,EAAE,CAAC,CAAA;CAAE,CACb,CAAC;AACF,6EAA6E;AAC7E,MAAM,MAAM,aAAa,CAAC,CAAC,SAAS,YAAY,IAAI,OAAO,CAAC,cAAc,CAAC,MAAM,CAAC,EAAE;IAAE,KAAK,EAAE,CAAC,CAAA;CAAE,CAAC,CAAC;AAClG,8EAA8E;AAC9E,MAAM,MAAM,8BAA8B,CAAC,MAAM,IAAI,IAAI,CACvD,sBAAsB,EACtB,YAAY,GAAG,UAAU,GAAG,MAAM,GAAG,UAAU,CAChD,GAAG;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AACrB,8EAA8E;AAC9E,MAAM,MAAM,4BAA4B,CAAC,MAAM,IAAI,IAAI,CACrD,8BAA8B,CAAC,MAAM,CAAC,EACtC,UAAU,CACX,CAAC"}

package/lib-dist/components/terra/editor/types.js

@@ -0,0 +1,11 @@
+// @ts-nocheck -- source-preserving extraction; public host contracts are typed in src/host.ts.
+/**
+ * astro/src/components/editor/types.ts
+ * Shared Terra content and Portable Text renderer contracts.
+ */
+/*//////////////////////////////////////////////////
+IMPORTS
+//////////////////////////////////////////////////*/
+// DATA
+import { DOCS_BLOCK_SCHEMAS, PROBLEM_BLOCK_TYPES } from '../../../lib/terra/runtime/types.js';
+//# sourceMappingURL=types.js.map

package/lib-dist/components/terra/editor/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/components/terra/editor/types.ts"],"names":[],"mappings":"AAAA,+FAA+F;AAC/F;;;GAGG;AAEH;;oDAEoD;AAEpD,OAAO;AACP,OAAO,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,qCAAqC,CAAC"}

package/lib-dist/components/terra/flow/Nodes.d.ts

@@ -0,0 +1,78 @@
+/**
+ * astro/src/components/flow/Nodes.tsx
+ */
+import React from 'react';
+import type { Node as XyNode, NodeProps } from '@xyflow/react';
+import type { NodeData } from '../../../lib/terra/runtime/types.js';
+import type { GroupNodeData, NodesProps } from '../../../lib/terra/runtime/types.js';
+/**
+ * Renders the container node used to group related flowchart nodes.
+ *
+ * @param props - Flow node props.
+ * @param data - Group node data and resize hooks.
+ * @param selected - Boolean flag controlling group node's selected behaviour.
+ *
+ * @return Resizable group frame, title bar, and group handles.
+ */
+export declare function GroupNode({ data, selected }: NodeProps<XyNode<GroupNodeData>>): React.JSX.Element;
+/**
+ * Renders a sticky-note style node in the flowchart.
+ *
+ * @param props - Flow node props.
+ * @param id - Unique clipping mask identifier.
+ * @param data - Sticky note text and resize hooks.
+ * @param selected - Boolean flag controlling note node's selected behaviour.
+ *
+ * @return Sticky note styled container.
+ */
+export declare function NoteNode({ id, data, selected, }: NodeProps<XyNode<GroupNodeData>>): React.JSX.Element;
+export declare const NODE_TYPES: {
+    erd: ({ data, selected }: NodeProps<XyNode<NodeData>>) => React.JSX.Element;
+    process: (props: NodeProps<XyNode<NodeData>>) => React.JSX.Element;
+    terminator: (props: NodeProps<XyNode<NodeData>>) => React.JSX.Element;
+    origin: (props: NodeProps<XyNode<NodeData>>) => React.JSX.Element;
+    terminal: (props: NodeProps<XyNode<NodeData>>) => React.JSX.Element;
+    decision: (props: NodeProps<XyNode<NodeData>>) => React.JSX.Element;
+    data: (props: NodeProps<XyNode<NodeData>>) => React.JSX.Element;
+    note: typeof NoteNode;
+    group: typeof GroupNode;
+};
+/**
+ * Renders the flow editor wrapper used by docs diagrams.
+ *
+ * @param props - Initial nodes and edges, layout configuration, interactions, change callbacks, and display settings for the problem graph.
+ * @param className - Extra classes applied to the outer flow wrapper.
+ * @param onCommit - Callback that receives the fully normalised flow after each change.
+ * @param nodes - Graph nodes rendered and updated by nodes.
+ * @param edges - Graph connections rendered and updated by nodes.
+ * @param nodeSep - Horizontal gap between graph nodes in nodes.
+ * @param rankSep - Vertical gap between graph ranks in nodes.
+ * @param height - Viewport height reserved for nodes's graph surface.
+ * @param onAddContent - Callback invoked for add content.
+ * @param onNodeClick - Callback invoked when a user selects a node in nodes.
+ * @param nodeTypes - Node renderer map that draws graph nodes in nodes.
+ * @param nodeLabels - Node label map shown alongside nodes's graph nodes.
+ * @param lockedTypes - Node types that nodes must keep read-only.
+ * @param allowedTypes - Node types that nodes permits users to create.
+ * @param disabled - Disabled state controlling whether nodes accepts interaction.
+ * @param clipboardKey - Clipboard key that enables graph copy and paste in nodes.
+ * @param arcControls - Arc controls input supplied to nodes's operation.
+ * @param edgeTypes - Edge renderer map that draws graph connections in nodes.
+ * @param readyWhenEmpty - Readiness rule that lets nodes finish with no graph nodes.
+ * @param onReady - Callback invoked when nodes finishes initialising its graph surface.
+ * @param style - Inline style values merged into nodes.
+ * @param rest - Rest input supplied to nodes's operation.
+ * @param direction - Layout direction that arranges nodes's graph.
+ * @param interactive - Interaction flag that controls whether nodes accepts graph input.
+ * @param editable - Editability flag controlling whether nodes accepts changes.
+ * @param proximityConnect - Connection rule that lets nearby graph nodes link automatically in nodes.
+ * @param showBg - Visibility flag for nodes's graph background.
+ * @param showCtrls - Visibility flag for nodes's graph controls.
+ *
+ * @return Docs flow editor wrapper with derived height, toolbar controls, and drag state.
+ *
+ * @remarks
+ * This is the public entrypoint; the rest of the file exists to keep the canvas state manageable.
+ */
+export default function Nodes({ nodes: initialNodes, edges: initialEdges, className, direction: dir, nodeSep, rankSep, proximityConnect, interactive, height, onCommit, onAddContent, onNodeClick, nodeTypes: customNodeTypes, nodeLabels, lockedTypes, allowedTypes, editable, disabled, clipboardKey, showBg, showCtrls, arcControls, edgeTypes, readyWhenEmpty, onReady, style, ...rest }: NodesProps): React.JSX.Element;
+//# sourceMappingURL=Nodes.d.ts.map

package/lib-dist/components/terra/flow/Nodes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Nodes.d.ts","sourceRoot":"","sources":["../../../../src/components/terra/flow/Nodes.tsx"],"names":[],"mappings":"AACA;;GAEG;AA0BH,OAAO,KAAK,MAAM,OAAO,CAAC;AAwD1B,OAAO,KAAK,EAKV,IAAI,IAAI,MAAM,EAEd,SAAS,EAEV,MAAM,eAAe,CAAC;AACvB,OAAO,KAAK,EAIV,QAAQ,EAET,MAAM,qCAAqC,CAAC;AAC7C,OAAO,KAAK,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,qCAAqC,CAAC;AAoFrF;;;;;;;;GAQG;AACH,wBAAgB,SAAS,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,SAAS,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,CA0BjG;AAuCD;;;;;;;;;GASG;AACH,wBAAgB,QAAQ,CAAC,EACvB,EAAE,EACF,IAAI,EACJ,QAAQ,GACT,EAAE,SAAS,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,CAuCtD;AACD,eAAO,MAAM,UAAU;8BACqB,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,KAAG,KAAK,CAAC,GAAG,CAAC,OAAO;qBAjFhF,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,KAAK,KAAK,CAAC,GAAG,CAAC,OAAO;wBAAjD,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,KAAK,KAAK,CAAC,GAAG,CAAC,OAAO;oBAAjD,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,KAAK,KAAK,CAAC,GAAG,CAAC,OAAO;sBAAjD,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,KAAK,KAAK,CAAC,GAAG,CAAC,OAAO;sBAAjD,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,KAAK,KAAK,CAAC,GAAG,CAAC,OAAO;kBAAjD,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,KAAK,KAAK,CAAC,GAAG,CAAC,OAAO;;;CA4J3D,CAAC;AA4uBF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AACH,MAAM,CAAC,OAAO,UAAU,KAAK,CAAC,EAC5B,KAAK,EAAE,YAAiB,EACxB,KAAK,EAAE,YAAiB,EACxB,SAAS,EACT,SAAS,EAAE,GAAU,EACrB,OAAY,EACZ,OAAW,EACX,gBAAwB,EACxB,WAAmB,EACnB,MAAM,EACN,QAAQ,EACR,YAAY,EACZ,WAAW,EACX,SAAS,EAAE,eAAoB,EAC/B,UAAe,EACf,WAAgB,EAChB,YAAqE,EACrE,QAAgB,EAChB,QAAoB,EACpB,YAAuD,EACvD,MAAa,EACb,SAAgB,EAChB,WAAmB,EACnB,SAAS,EACT,cAAqB,EACrB,OAAO,EACP,KAAK,EACL,GAAG,IAAI,EACR,EAAE,UAAU,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,CA2kBhC"}