@terra-symposium/docs 0.0.0-stage → 0.1.71

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

@@ -0,0 +1,128 @@
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+// @ts-nocheck -- source-preserving extraction; public host contracts are typed in src/host.ts.
+/** Docs code block renderer with view and edit modes. */
+import { useEditor } from '@portabletext/editor';
+import { useEffect, useRef, useState } from 'react';
+import { ErrorBoundary } from '../../ui.js';
+import { Button } from '@terra-symposium/styling/ui/terra-original';
+import { Dialog, DialogContent, DialogHeader, DialogTitle, } from '@terra-symposium/styling/ui/terra-original';
+import { Input } from '@terra-symposium/styling/ui/terra-original';
+import { Label } from '@terra-symposium/styling/ui/terra-original';
+import { CodeBlock } from './_CodeBlock.js';
+/** Renders a Docs code block from its authored block.
+ *
+ * @param props - Authored code block and its language, title, and display settings.
+ * @returns The authored code block and its preview.
+ */
+function Code({ block }) {
+    return (_jsx(ErrorBoundary, { name: "Code", children: _jsx(CodeBlock, { code: block.value ?? '', language: block.language ?? 'text', source: block.source, tone: "view" }) }));
+}
+Object.assign(Code, { displayName: 'DocsCodePreview' });
+/** Adapts Portable Text's block-object contract to the code renderer. */
+/**
+ * Renders the renderCode component.
+ *
+ * @param props - Portable Text renderer attributes, nested children, code block node, path, and read-only mode.
+ * @returns The code block renderer in editable or read-only mode.
+ */
+export function renderCode({ attributes: attrs, children, node, path, readOnly, }) {
+    return readOnly ? (_jsx(Code, { block: node })) : (_jsx(CodeEditor, { attributes: attrs, children: children, node: node, path: path }));
+}
+Object.assign(renderCode, { displayName: 'DocsCodeRenderer' });
+/** Connects the code block's local controls to its Portable Text state. */
+/**
+ * Renders the CodeEditor component.
+ *
+ * @param props - Portable Text editor attributes, nested children, code node, and path used to update code content.
+ * @returns The editable code block controls.
+ */
+function CodeEditor({ attributes: attrs, children, node, path, }) {
+    const editor = useEditor();
+    const code = node;
+    const [endpoint, setEndpoint] = useState(code.source ?? '');
+    const [endpointDialog, setEndpointDialog] = useState(null);
+    const boundary = useRef(null);
+    useEffect(() => {
+        if (!boundary.current)
+            return;
+        const stop = (e) => e.stopPropagation();
+        const es = [
+            'beforeinput',
+            'input',
+            'keydown',
+            'keyup',
+            'paste',
+            'copy',
+            'cut',
+            'focusin',
+            'focusout',
+            'pointerdown',
+            'pointerup',
+        ];
+        const element = boundary.current;
+        for (const e of es)
+            element.addEventListener(e, stop);
+        return () => {
+            for (const e of es)
+                element.removeEventListener(e, stop);
+        };
+    }, [code.source]);
+    useEffect(() => {
+        if (!boundary.current)
+            return;
+        const block = boundary.current;
+        block.__blockActions = code.source
+            ? [
+                {
+                    text: 'Change API endpoint',
+                    onSelect: () => setEndpointDialog('change'),
+                },
+                {
+                    text: 'Convert to local definition',
+                    onSelect: () => {
+                        const received = boundary.current?.querySelector('[data-docs-code-received][data-state="received"]');
+                        if (!received)
+                            return;
+                        const { source: _source, ...localCode } = code;
+                        editor.send({
+                            type: 'set',
+                            at: path,
+                            value: {
+                                ...localCode,
+                                language: code.language ?? 'json',
+                                value: received.textContent ?? '',
+                            },
+                        });
+                    },
+                },
+            ]
+            : [{ text: 'Convert to received value', onSelect: () => setEndpointDialog('receive') }];
+        return () => {
+            delete block.__blockActions;
+        };
+    }, [code.language, code.source, editor, path]);
+    useEffect(() => setEndpoint(code.source ?? ''), [code.source]);
+    const update = (val, lang = code.language ?? 'text') => editor.send({
+        type: 'block.set',
+        at: path,
+        props: { language: lang, source: code.source, value: val },
+    });
+    return (_jsx(ErrorBoundary, { name: "CodeBlock", children: _jsxs(_Fragment, { children: [_jsxs("div", { ...attrs, ref: boundary, contentEditable: false, "data-terra-block": "code", "data-docs-editor-block": "code", children: [_jsx(CodeBlock, { code: code.value ?? '', expandAll: true, language: code.language ?? 'text', source: code.source, tone: "edit", onCodeChange: (v) => update(v), onCommit: (v, l) => update(v, l), onLanguageChange: (l, v) => update(v, l) }), children] }), _jsx(Dialog, { open: endpointDialog !== null, onOpenChange: (open) => !open && setEndpointDialog(null), children: _jsxs(DialogContent, { "aria-describedby": undefined, children: [_jsx(DialogHeader, { children: _jsx(DialogTitle, { children: endpointDialog === 'receive' ? 'Convert to received value' : 'Change API endpoint' }) }), _jsx(Label, { htmlFor: "docs-code-endpoint", children: "API endpoint" }), _jsx(Input, { id: "docs-code-endpoint", value: endpoint, onChange: (e) => setEndpoint(e.currentTarget.value) }), _jsxs("div", { className: "flex justify-end gap-2", children: [_jsx(Button, { variant: "outline", onClick: () => setEndpointDialog(null), children: "Cancel" }), _jsx(Button, { disabled: !endpoint.trim(), onClick: () => {
+                                            const src = endpoint.trim();
+                                            if (!src)
+                                                return;
+                                            editor.send({
+                                                type: 'set',
+                                                at: path,
+                                                value: {
+                                                    ...code,
+                                                    language: code.language ?? 'json',
+                                                    source: src,
+                                                    value: code.value ?? '',
+                                                },
+                                            });
+                                            setEndpointDialog(null);
+                                        }, children: endpointDialog === 'receive' ? 'Receive value' : 'Change API endpoint' })] })] }) })] }) }));
+}
+Object.assign(CodeEditor, { displayName: 'DocsCodeEditor' });
+//# sourceMappingURL=_DocsCode.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"_DocsCode.js","sourceRoot":"","sources":["../../../../../src/components/terra/editor/docs/_DocsCode.tsx"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,18 @@
+/**
+ * astro/src/components/editor/docs/_DocsImage.tsx
+ * Docs image renderer with view and edit modes.
+ */
+import type { DocsBlock, PortableTextBlockRendererProps } from '../types.js';
+/** Sanity Portable Text image fields authored in documentation content. */
+type DocsImgBlock = DocsBlock<'docImage'>;
+/** Adapts Portable Text's block-object contract to the image renderer. */
+/**
+ * Renders the renderImage component.
+ *
+ * @param props - Portable Text renderer attributes, nested children, image node, path, and read-only mode.
+ *
+ * @return The image renderer in editable or read-only mode.
+ */
+export declare function renderImage({ attributes: attrs, children, node, path, readOnly, }: PortableTextBlockRendererProps<DocsImgBlock>): JSX.Element;
+export {};
+//# sourceMappingURL=_DocsImage.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"_DocsImage.d.ts","sourceRoot":"","sources":["../../../../../src/components/terra/editor/docs/_DocsImage.tsx"],"names":[],"mappings":"AACA;;;GAGG;AAkBH,OAAO,KAAK,EACV,SAAS,EAET,8BAA8B,EAC/B,MAAM,aAAa,CAAC;AAMrB,2EAA2E;AAC3E,KAAK,YAAY,GAAG,SAAS,CAAC,UAAU,CAAC,CAAC;AAoC1C,0EAA0E;AAC1E;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,EAC1B,UAAU,EAAE,KAAK,EACjB,QAAQ,EACR,IAAI,EACJ,IAAI,EACJ,QAAQ,GACT,EAAE,8BAA8B,CAAC,YAAY,CAAC,GAAG,GAAG,CAAC,OAAO,CAM5D"}

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

@@ -0,0 +1,62 @@
+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/_DocsImage.tsx
+ * Docs image renderer with view and edit modes.
+ */
+/*//////////////////////////////////////////////////
+IMPORTS
+//////////////////////////////////////////////////*/
+// API
+import { useEditor } from '@portabletext/editor';
+// COMPONENTS
+import { AlertError } from '@terra-symposium/styling/ui/terra-original';
+import { Button } from '@terra-symposium/styling/ui/terra-original';
+import { ErrorBoundary } from '../../ui.js';
+import { Empty } from '../../ui.js';
+import { Image as ImageIcon, TrashCan as TrashIcon } from '@carbon/icons-react';
+import { Input } from '@terra-symposium/styling/ui/terra-original';
+const FIELD_LABEL = 'block text-sm font-medium text-primary-12';
+/*//////////////////////////////////////////////////
+HELPERS
+//////////////////////////////////////////////////*/
+/**
+ * Renders a Docs image block from its authored block.
+ *
+ * @param props - Authored image block containing the source URL, dimensions, and accessibility metadata.
+ *
+ * @return The image with its authored caption and alternate text.
+ */
+function Img({ block }) {
+    if (!block.url)
+        return (_jsx(ErrorBoundary, { name: "Image", children: _jsx(AlertError, { title: "Image unavailable", description: "This image block has no URL." }) }));
+    return (_jsx(ErrorBoundary, { name: "Image", children: _jsx("img", { src: block.url, alt: block.alt ?? '', className: "max-w-full", ...(block.title === undefined ? {} : { title: block.title }), ...(block.width === undefined ? {} : { width: block.width }), ...(block.height === undefined ? {} : { height: block.height }) }) }));
+}
+Object.assign(Img, { displayName: 'DocsImagePreview' });
+/** Adapts Portable Text's block-object contract to the image renderer. */
+/**
+ * Renders the renderImage component.
+ *
+ * @param props - Portable Text renderer attributes, nested children, image node, path, and read-only mode.
+ *
+ * @return The image renderer in editable or read-only mode.
+ */
+export function renderImage({ attributes: attrs, children, node, path, readOnly, }) {
+    return readOnly ? (_jsx(Img, { block: node })) : (_jsx(ImgEditor, { attributes: attrs, children: children, node: node, path: path }));
+}
+Object.assign(renderImage, { displayName: 'DocsImageRenderer' });
+/** Connects the image block's local controls to its Portable Text state. */
+/**
+ * Renders the ImageEditor component.
+ *
+ * @param props - Portable Text editor attributes, nested children, image node, and path used to update image metadata.
+ *
+ * @return The editable image block controls.
+ */
+function ImgEditor({ attributes: attrs, children, node, path, }) {
+    const editor = useEditor();
+    const update = (field, val) => editor.send({ type: 'block.set', at: path, props: { [field]: val } });
+    return (_jsx(ErrorBoundary, { name: "ImageBlock", children: _jsxs("section", { ...attrs, contentEditable: false, className: "my-8 rounded-xl border border-secondary-6 bg-secondary-1/40 p-4 shadow-sm sm:p-5", "data-terra-block": "docImage", children: [_jsxs("div", { className: "flex items-center gap-3 border-b border-secondary-5 pb-3 text-primary-12", children: [_jsx("span", { className: "flex size-9 shrink-0 items-center justify-center rounded-lg bg-secondary-3 text-secondary-11", children: _jsx(ImageIcon, { className: "size-5", "aria-hidden": "true" }) }), _jsxs("div", { children: [_jsx("h3", { className: "font-semibold", children: "Image" }), _jsx("p", { className: "text-sm text-primary-11", children: "Docs image block" })] })] }), _jsxs("label", { className: `mt-4 ${FIELD_LABEL}`, children: [_jsx("span", { children: "Image URL" }), _jsx(Input, { className: "mt-1.5", type: "url", value: node.url ?? '', onChange: (e) => update('url', e.currentTarget.value), placeholder: "https://example.com/image.png" })] }), node.url ? (_jsxs("figure", { className: "mt-4 overflow-hidden rounded-lg border border-secondary-5 bg-primary-1", children: [_jsx("img", { src: node.url, alt: node.alt ?? '', title: node.title ?? undefined, className: "max-h-[32rem] w-full object-contain", ...(node.width ? { width: node.width } : {}), ...(node.height ? { height: node.height } : {}) }), node.title ? (_jsx("figcaption", { className: "border-t border-secondary-5 px-3 py-2 text-sm text-primary-11", children: node.title })) : null] })) : (_jsx(Empty, { variant: "preview", children: "Add an image URL to preview it here." })), _jsxs("div", { className: "mt-4 grid gap-3 sm:grid-cols-2", children: [_jsxs("label", { className: FIELD_LABEL, children: [_jsx("span", { children: "Alternative text" }), _jsx(Input, { className: "mt-1.5", value: node.alt ?? '', onChange: (e) => update('alt', e.currentTarget.value), placeholder: "Describe the image" })] }), _jsxs("label", { className: FIELD_LABEL, children: [_jsx("span", { children: "Caption" }), _jsx(Input, { className: "mt-1.5", value: node.title ?? '', onChange: (e) => update('title', e.currentTarget.value), placeholder: "Optional caption" })] })] }), _jsxs("div", { className: "mt-4 grid gap-3 sm:grid-cols-2", children: [_jsxs("label", { className: FIELD_LABEL, children: [_jsx("span", { children: "Width" }), _jsx(Input, { className: "mt-1.5", value: node.width ?? '', onChange: (e) => update('width', e.currentTarget.value), placeholder: "e.g. 640px" })] }), _jsxs("label", { className: FIELD_LABEL, children: [_jsx("span", { children: "Height" }), _jsx(Input, { className: "mt-1.5", value: node.height ?? '', onChange: (e) => update('height', e.currentTarget.value), placeholder: "e.g. auto" })] })] }), _jsx("p", { className: "mt-3 text-xs leading-5 text-primary-10", children: "Use a stable, publicly accessible image URL. Uploading assets is part of real-content integration." }), _jsxs(Button, { className: "mt-4", size: "sm", variant: "destructive", onClick: () => editor.send({ type: 'unset', at: path }), children: [_jsx(TrashIcon, { "aria-hidden": "true" }), " Delete image"] }), children] }) }));
+}
+Object.assign(ImgEditor, { displayName: 'DocsImageEditor' });
+//# sourceMappingURL=_DocsImage.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"_DocsImage.js","sourceRoot":"","sources":["../../../../../src/components/terra/editor/docs/_DocsImage.tsx"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,17 @@
+/**
+ * astro/src/components/editor/docs/_Embed.tsx
+ */
+import type { DocsBlock } from '../types.js';
+/** Converts common YouTube watch links into iframe-compatible player URLs. */
+export declare function normalizeDocsEmbedUrl(source: string): string;
+/**
+ * Renders the embed component.
+ *
+ * @param props - Embed block data containing the external source and title.
+ *
+ * @return Embedded content, or null when no source is available.
+ */
+export declare function Embed({ block, }: {
+    block: DocsBlock<'embed'>;
+}): JSX.Element | null;
+//# sourceMappingURL=_Embed.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"_Embed.d.ts","sourceRoot":"","sources":["../../../../../src/components/terra/editor/docs/_Embed.tsx"],"names":[],"mappings":"AACA;;GAEG;AAUH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAM7C,8EAA8E;AAC9E,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAkC5D;AAUD;;;;;;GAMG;AACH,wBAAgB,KAAK,CAAC,EACpB,KAAK,GACN,EAAE;IACD,KAAK,EAA+D,SAAS,CAAC,OAAO,CAAC,CAAC;CACxF,GAAG,GAAG,CAAC,OAAO,GAAG,IAAI,CAYrB"}

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

@@ -0,0 +1,73 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+// @ts-nocheck -- source-preserving extraction; public host contracts are typed in src/host.ts.
+/**
+ * astro/src/components/editor/docs/_Embed.tsx
+ */
+/*//////////////////////////////////////////////////
+IMPORTS
+//////////////////////////////////////////////////*/
+// COMPONENTS
+import { ErrorBoundary } from '../../ui.js';
+/*//////////////////////////////////////////////////
+HELPERS
+//////////////////////////////////////////////////*/
+/** Converts common YouTube watch links into iframe-compatible player URLs. */
+export function normalizeDocsEmbedUrl(source) {
+    try {
+        const url = new URL(source);
+        const host = url.hostname.toLowerCase().replace(/^www\./, '');
+        const youtubeHost = host === 'youtube.com' || host === 'm.youtube.com' || host === 'youtube-nocookie.com';
+        let videoId;
+        if (youtubeHost) {
+            const [, route, routeId] = url.pathname.match(/^\/(embed|shorts|live)\/([^/]+)/) ?? [];
+            if (route)
+                videoId = routeId;
+            else if (url.pathname === '/watch')
+                videoId = url.searchParams.get('v') ?? undefined;
+        }
+        else if (host === 'youtu.be') {
+            videoId = url.pathname.split('/').filter(Boolean)[0];
+        }
+        if (!videoId || !/^[\w-]+$/.test(videoId))
+            return source;
+        const playerHost = host === 'youtube-nocookie.com' ? 'www.youtube-nocookie.com' : 'www.youtube.com';
+        const embed = new URL(`https://${playerHost}/embed/${videoId}`);
+        for (const parameter of ['list', 'index', 'playsinline', 'rel']) {
+            const value = url.searchParams.get(parameter);
+            if (value)
+                embed.searchParams.set(parameter, value);
+        }
+        const explicitStart = url.searchParams.get('start');
+        const time = explicitStart ?? url.searchParams.get('t');
+        const seconds = time ? youtubeTimeToSeconds(time) : undefined;
+        if (seconds !== undefined)
+            embed.searchParams.set('start', String(seconds));
+        return embed.toString();
+    }
+    catch {
+        return source;
+    }
+}
+function youtubeTimeToSeconds(value) {
+    if (/^\d+$/.test(value))
+        return Number(value);
+    const match = value.match(/^(?:(\d+)h)?(?:(\d+)m)?(?:(\d+)s)?$/i);
+    if (!match || !match[0])
+        return undefined;
+    const seconds = Number(match[1] ?? 0) * 3600 + Number(match[2] ?? 0) * 60 + Number(match[3] ?? 0);
+    return seconds > 0 ? seconds : undefined;
+}
+/**
+ * Renders the embed component.
+ *
+ * @param props - Embed block data containing the external source and title.
+ *
+ * @return Embedded content, or null when no source is available.
+ */
+export function Embed({ block, }) {
+    if (!block.src)
+        return null;
+    return (_jsx(ErrorBoundary, { name: "Embed", children: _jsx("iframe", { className: "my-6 w-full border-0", src: normalizeDocsEmbedUrl(block.src), title: block.title ?? block.src, style: { height: block.height ?? '500px', width: block.width ?? '100%' } }) }));
+}
+Object.assign(Embed, { displayName: 'DocsEmbed' });
+//# sourceMappingURL=_Embed.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"_Embed.js","sourceRoot":"","sources":["../../../../../src/components/terra/editor/docs/_Embed.tsx"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,31 @@
+/**
+ * astro/src/components/editor/docs/_Math.tsx
+ * Docs math renderer with optional editing controls.
+ */
+import type { DocsBlock, PortableTextBlockRendererProps } from '../types.js';
+/** Sanity Portable Text math expression block fields. */
+type MathBlockData = DocsBlock<'math'>;
+/**
+ * Renders the formula display and, when supplied, its edit popover.
+ *
+ * @param props - Math source, inline or block mode, optional class name, and callback for updating authored source.
+ *
+ * @return The formatted math expression or editable math control.
+ */
+export declare function renderMath({ code, inline, className, write, }: {
+    code: string;
+    inline?: boolean;
+    className?: string;
+    write?: (code: string, inline?: boolean) => void;
+}): JSX.Element;
+/** Adapts Portable Text's block-object contract to the math renderer. */
+/**
+ * Renders the renderMathBlock component.
+ *
+ * @param props - Portable Text renderer attributes, nested children, math node, path, and read-only mode.
+ *
+ * @return The math block renderer in editable or read-only mode.
+ */
+export declare function renderMathBlock({ attributes: attrs, children, node, path, readOnly, }: PortableTextBlockRendererProps<MathBlockData>): JSX.Element;
+export {};
+//# sourceMappingURL=_Math.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"_Math.d.ts","sourceRoot":"","sources":["../../../../../src/components/terra/editor/docs/_Math.tsx"],"names":[],"mappings":"AACA;;;GAGG;AA4BH,OAAO,KAAK,EACV,SAAS,EAET,8BAA8B,EAC/B,MAAM,aAAa,CAAC;AAMrB,yDAAyD;AACzD,KAAK,aAAa,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC;AAMvC;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,EACzB,IAAI,EACJ,MAAM,EACN,SAAS,EACT,KAAK,GACN,EAAE;IACD,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,KAAK,IAAI,CAAC;CAClD,GAAG,GAAG,CAAC,OAAO,CAiHd;AAcD,yEAAyE;AACzE;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,EAC9B,UAAU,EAAE,KAAK,EACjB,QAAQ,EACR,IAAI,EACJ,IAAI,EACJ,QAAQ,GACT,EAAE,8BAA8B,CAAC,aAAa,CAAC,GAAG,GAAG,CAAC,OAAO,CAM7D"}

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

@@ -0,0 +1,138 @@
+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/_Math.tsx
+ * Docs math renderer with optional editing controls.
+ */
+/*//////////////////////////////////////////////////
+IMPORTS
+//////////////////////////////////////////////////*/
+// API
+import katex from 'katex';
+import { cn } from '../../../../lib/terra/runtime/runtime.js';
+import { createElement as __terraQualityCreateElement, useEffect, useMemo, useRef, useState, } from 'react';
+import { useEditor } from '@portabletext/editor';
+// COMPONENTS
+import * as PopoverPrimitive from '@radix-ui/react-popover';
+import { Button } from '@terra-symposium/styling/ui/terra-original';
+import { Edit as EditIcon, FunctionMath as MathIcon } from '@carbon/icons-react';
+import { ErrorBoundary } from '../../ui.js';
+import { Popover, PopoverContent } from '@terra-symposium/styling/ui/terra-original';
+import { Textarea } from '@terra-symposium/styling/ui/terra-original';
+/*//////////////////////////////////////////////////
+HELPERS
+//////////////////////////////////////////////////*/
+/**
+ * Renders the formula display and, when supplied, its edit popover.
+ *
+ * @param props - Math source, inline or block mode, optional class name, and callback for updating authored source.
+ *
+ * @return The formatted math expression or editable math control.
+ */
+export function renderMath({ code, inline, className, write, }) {
+    const [open, setOpen] = useState(false);
+    const [val, setVal] = useState(code);
+    const ref = useRef(null);
+    useEffect(() => {
+        setVal(code);
+    }, [code]);
+    useEffect(() => {
+        if (!ref.current || !write)
+            return;
+        ref.current.__blockActions = [
+            {
+                text: 'Edit Formula',
+                icon: _jsx(EditIcon, { className: "mr-2 size-4", "aria-hidden": "true" }),
+                onSelect: () => setOpen(true),
+            },
+            {
+                text: `Set to ${inline ? 'Display' : 'Inline'}`,
+                icon: _jsx(MathIcon, { className: "mr-2 size-4", "aria-hidden": "true" }),
+                onSelect: () => write(code, !inline),
+            },
+        ];
+    }, [code, inline, write]);
+    const math = __terraQualityCreateElement(inline ? 'span' : 'div', {
+        className: cn('docs-math', !inline && 'my-4 flex w-full justify-center overflow-x-auto', className),
+        dangerouslySetInnerHTML: {
+            __html: useMemo(() => {
+                if (!code)
+                    return '';
+                try {
+                    return katex.renderToString(code, {
+                        throwOnError: false,
+                        displayMode: !inline,
+                        strict: false,
+                    });
+                }
+                catch (err) {
+                    return `<span class="text-red-500">${String(err)}</span>`;
+                }
+            }, [code, inline]),
+        },
+    });
+    if (!write)
+        return math;
+    return (_jsx(ErrorBoundary, { name: "MathBlock", children: _jsxs(Popover, { open: open, onOpenChange: setOpen, children: [_jsx("span", { ref: ref, className: cn('docs-math-wrapper relative cursor-context-menu select-none outline-none ring-0', inline ? 'inline-block' : 'block'), contentEditable: false, "data-docs-editor-block": "math", "data-math-inline": inline ? 'true' : 'false', "data-math-code": code, children: _jsx(PopoverPrimitive.Anchor, { className: cn('pointer-events-none', inline ? 'inline-block' : 'block'), children: math }) }), _jsxs(PopoverContent, { align: "center", className: "not-prose z-[120] w-96 space-y-4", onClick: (e) => e.stopPropagation(), onInteractOutside: (e) => {
+                        if (e.target.closest('[data-radix-popper-content-wrapper], [data-radix-menu-content]'))
+                            e.preventDefault();
+                    }, children: [_jsxs("div", { className: "space-y-2", children: [_jsx("h4", { className: "text-sm font-semibold", children: "Edit LaTeX Formula" }), _jsx(Textarea, { "aria-label": "LaTeX formula", value: val, onChange: (e) => setVal(e.target.value), placeholder: "f'(x) = ...", className: "h-32 font-mono text-xs" })] }), _jsxs("div", { className: "flex justify-end gap-2", children: [_jsx(Button, { variant: "ghost", size: "sm", onClick: () => {
+                                        setVal(code);
+                                        setOpen(false);
+                                    }, children: "Cancel" }), _jsx(Button, { variant: "default", size: "sm", onClick: () => {
+                                        write(val, inline);
+                                        setOpen(false);
+                                    }, children: "Save Formula" })] })] })] }) }));
+}
+/**
+ * Renders a Docs math block from its authored block.
+ *
+ * @param props - Authored expression and display mode from the math block.
+ *
+ * @return The rendered math expression.
+ */
+function MathBlock({ block }) {
+    return renderMath({ code: block.code ?? '', inline: Boolean(block.inline) });
+}
+Object.assign(MathBlock, { displayName: 'DocsMathPreview' });
+/** Adapts Portable Text's block-object contract to the math renderer. */
+/**
+ * Renders the renderMathBlock component.
+ *
+ * @param props - Portable Text renderer attributes, nested children, math node, path, and read-only mode.
+ *
+ * @return The math block renderer in editable or read-only mode.
+ */
+export function renderMathBlock({ attributes: attrs, children, node, path, readOnly, }) {
+    return readOnly ? (_jsx(MathBlock, { block: node })) : (_jsx(MathEditor, { attributes: attrs, children: children, node: node, path: path }));
+}
+Object.assign(renderMathBlock, { displayName: 'DocsMathRenderer' });
+/** Connects the math block's local controls to its Portable Text state. */
+/**
+ * Renders the MathEditor component.
+ *
+ * @param props - Portable Text editor attributes, nested children, math node, and path used to update the expression.
+ *
+ * @return The editable math expression controls.
+ */
+function MathEditor(props) {
+    return _jsx(MathEditorContent, { ...props, editor: useEditor() });
+}
+Object.assign(MathEditor, { displayName: 'DocsMathEditor' });
+/**
+ * Renders math controls using the editor context supplied by the Portable Text boundary.
+ *
+ * @param props - Portable Text attributes, children, math node, path, and editor context.
+ *
+ * @return The math block controls and any nested editor content.
+ */
+function MathEditorContent({ attributes: attrs, children, node, path, editor, }) {
+    const math = node;
+    return (_jsxs("div", { ...attrs, contentEditable: false, "data-terra-block": "math", children: [renderMath({
+                code: math.code ?? '',
+                ...(math.inline === undefined ? {} : { inline: math.inline }),
+                write: (code, inline) => editor.send({ type: 'block.set', at: path, props: { code, inline } }),
+            }), children] }));
+}
+Object.assign(MathEditorContent, { displayName: 'DocsMathEditorContent' });
+//# sourceMappingURL=_Math.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"_Math.js","sourceRoot":"","sources":["../../../../../src/components/terra/editor/docs/_Math.tsx"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,15 @@
+/**
+ * astro/src/components/editor/docs/_Nodes.tsx
+ */
+import type { DocsBlock } from '../types.js';
+/**
+ * Renders the nodes block component.
+ *
+ * @param props - Portable Text node props passed to the renderer.
+ *
+ * @return Rendered documentation node content.
+ */
+export declare function NodesBlock({ block, }: {
+    block: DocsBlock<'nodes'>;
+}): JSX.Element;
+//# sourceMappingURL=_Nodes.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"_Nodes.d.ts","sourceRoot":"","sources":["../../../../../src/components/terra/editor/docs/_Nodes.tsx"],"names":[],"mappings":"AACA;;GAEG;AAeH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAqE7C;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,EACzB,KAAK,GACN,EAAE;IACD,KAAK,EAAyE,SAAS,CAAC,OAAO,CAAC,CAAC;CAClG,GAAG,GAAG,CAAC,OAAO,CAsBd"}

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

@@ -0,0 +1,62 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+// @ts-nocheck -- source-preserving extraction; public host contracts are typed in src/host.ts.
+/**
+ * astro/src/components/editor/docs/_Nodes.tsx
+ */
+/*//////////////////////////////////////////////////
+IMPORTS
+//////////////////////////////////////////////////*/
+// API
+import { cn } from '../../../../lib/terra/runtime/runtime.js';
+import { decodeNodesPayload } from '../../../../lib/terra/runtime/nodes.js';
+// COMPONENTS
+import Canvas from '../../flow/Nodes.js';
+import { ErrorBoundary } from '../../ui.js';
+/*//////////////////////////////////////////////////
+HELPERS
+//////////////////////////////////////////////////*/
+/**
+ * Decodes and renders a Docs flow diagram.
+ *
+ * @param props - Node data, optional styling class, and rendering state used to display a graph preview.
+ *
+ * @return The graph preview for the supplied node data.
+ */
+function NodesRenderer(props) {
+    const { className, nodes: rawNodes, edges: rawEdges, direction, height, nodeSep, rankSep, proximityConnect, ...rest } = props;
+    const resolvedHeight = Number.isFinite(Number(height)) ? Number(height) : 384;
+    return (_jsx(ErrorBoundary, { name: "Nodes", children: _jsx("div", { className: cn('docs-block not-prose relative my-0 flow-root transition-all duration-200 [&>:first-child]:!mt-0 [&>:last-child]:!mb-0', className), "data-docs-editor-block": "Nodes", style: { height: resolvedHeight, width: '100%' }, contentEditable: false, suppressContentEditableWarning: true, children: _jsx(Canvas, { ...rest, direction: direction, height: resolvedHeight, nodeSep: nodeSep, rankSep: rankSep, proximityConnect: proximityConnect, nodes: decodeNodesPayload(rawNodes).filter((n) => {
+                    if (!n || typeof n !== 'object')
+                        return false;
+                    const val = n;
+                    return typeof val.id === 'string' && Boolean(val.data && typeof val.data === 'object');
+                }), edges: decodeNodesPayload(rawEdges).filter((e) => {
+                    if (!e || typeof e !== 'object')
+                        return false;
+                    const val = e;
+                    return (typeof val.id === 'string' &&
+                        typeof val.source === 'string' &&
+                        typeof val.target === 'string');
+                }), className: className }) }) }));
+}
+Object.assign(NodesRenderer, { displayName: 'DocsNodesRenderer' });
+/**
+ * Renders the nodes block component.
+ *
+ * @param props - Portable Text node props passed to the renderer.
+ *
+ * @return Rendered documentation node content.
+ */
+export function NodesBlock({ block, }) {
+    return (_jsx(ErrorBoundary, { name: "NodesBlock", children: _jsx(NodesRenderer, { ...(block.nodes === undefined
+                ? {}
+                : { nodes: block.nodes }), ...(block.edges === undefined
+                ? {}
+                : { edges: block.edges }), ...(block.direction === 'TB' || block.direction === 'LR'
+                ? { direction: block.direction }
+                : {}), ...(block.height === undefined ? {} : { height: block.height }), ...(block.nodeSep === undefined ? {} : { nodeSep: block.nodeSep }), ...(block.proximityConnect === undefined
+                ? {}
+                : { proximityConnect: block.proximityConnect }), ...(block.rankSep === undefined ? {} : { rankSep: block.rankSep }) }) }));
+}
+Object.assign(NodesBlock, { displayName: 'DocsNodesBlock' });
+//# sourceMappingURL=_Nodes.js.map