@terra-symposium/docs 0.1.17 → 0.1.72

package/lib-dist/{terra → components/terra}/pages/docs/_tree.js

@@ -9,58 +9,35 @@ import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 IMPORTS
 //////////////////////////////////////////////////*/
 // API
-import { $unsavedDrafts, clearTransition, download, extractAllNodeIds, getStableKey, isIndexFile, memoryDrafts, resetEditorMounts, runMutation, sanitizeName, setTransition, uploadAssetChunked, useAtom, } from './_helpers.js';
-import { actions } from '../../runtime/action-proxy.js';
-import { bName, cTitle, dirname, docsPath, docsRootPath, toNodeLabel, toPaths } from '../../runtime/shared.js';
-import { cn, notify } from '../../runtime/runtime.js';
-import { toPortableBody } from '../../runtime/leaf.js';
-import { toHeadingId } from '../../editor/docs/heading.js';
+import { $unsavedDrafts, clearTransition, memoryDrafts, resetEditorMounts, setTransition, useAtom, } from '../../../../lib/terra/docs/state.js';
+import { extractAllNodeIds, getStableKey, isIndexFile, sanitizeName, } from '../../../../lib/terra/docs/tree.js';
+import { runMutation } from '../../../../lib/terra/docs/mutations.js';
+import { download, uploadAssetChunked } from '../../../../lib/terra/docs/assets.js';
+import { actions } from '../../../../lib/terra/runtime/action-proxy.js';
+import { bName, cTitle, dirname, docsPath, docsRootPath, toNodeLabel, toPaths, } from '../../../../lib/terra/runtime/shared.js';
+import { cn, notify } from '../../../../lib/terra/runtime/runtime.js';
+import { toPortableBody } from '../../../../lib/terra/runtime/leaf.js';
+import { Toc } from './_toc.js';
 import { toast } from 'sonner';
 import { useEffect, useRef, useState } from 'react';
 // COMPONENTS
-import * as TerraQualityRegex from '../../regex.mjs';
+import * as TerraQualityRegex from '../../../../lib/terra/regex.mjs';
 import React, { Fragment } from 'react';
-import { Add as AddIcon, ArrowUpRight as PopOutIcon, Box as BoxIcon, Copy as CopyIcon, Doc as DocumentIcon, Download as DownloadIcon, Draggable as DragIcon, Edit as EditIcon, Link as LinkIcon, MagicWand as MagicIcon, OverflowMenuVertical as OverflowMenuIcon, TrashCan as TrashIcon, } from '@carbon/icons-react';
-import { Button, ButtonLink } from '@terra-symposium/styling/ui/terra-original';
-import { ContextMenu, ContextMenuContent, ContextMenuItem, ContextMenuSeparator, ContextMenuSub, ContextMenuSubContent, ContextMenuSubTrigger, ContextMenuTrigger } from '@terra-symposium/styling/ui/terra-original';
-import { DropdownMenu, DropdownMenuContent, DropdownMenuItem, DropdownMenuSeparator, DropdownMenuTrigger } from '@terra-symposium/styling/ui/terra-original';
-import { ErrorBoundary } from '../../runtime/ui.js';
-import { SidebarGroup, SidebarGroupContent, SidebarGroupLabel, SidebarMenu, SidebarMenuButton, SidebarMenuItem, SidebarMenuSub, SidebarMenuSubItem } from '@terra-symposium/styling/ui/terra-original';
+import { Add as AddIcon, ArrowUpRight as PopOutIcon, Box as BoxIcon, Copy as CopyIcon, Doc as DocumentIcon, Download as DownloadIcon, Draggable as DragIcon, Edit as EditIcon, Link as LinkIcon, MagicWand as MagicIcon, TrashCan as TrashIcon, } from '@carbon/icons-react';
+import { Button } from '@terra-symposium/styling/ui';
+import { ContextMenu, ContextMenuContent, ContextMenuItem, ContextMenuSeparator, ContextMenuSub, ContextMenuSubContent, ContextMenuSubTrigger, ContextMenuTrigger, } from '@terra-symposium/styling/ui';
+import { ErrorBoundary } from '../../ui.js';
+import { SidebarGroup, SidebarGroupContent, SidebarGroupLabel, SidebarMenu, SidebarMenuButton, SidebarMenuItem, } from '@terra-symposium/styling/ui';
 // DATA
-import { REORDER } from '../../runtime/shared.js';
+import { REORDER } from '../../../../lib/terra/runtime/shared.js';
 /*//////////////////////////////////////////////////
 CONFIG
 //////////////////////////////////////////////////*/
 // DATA
 /** Validated interactive literal mappings explicitly capturing action intents. */
-const UI = { add: { doc: 'Add page', group: 'Add group' }, open: 'bg-primary-3 text-primary-12' };
-/** Returns the rendered Docs mode shell used by navigation and the table of contents. */
-const docsShellOf = () => Array.from(document.querySelectorAll('[data-docs-shell]')).find(e => {
-    const style = window.getComputedStyle(e);
-    return (e.dataset.docsMode === (new URL(window.location.href).searchParams.get('mode') || 'view') &&
-        style.display !== 'none' &&
-        style.visibility !== 'hidden' &&
-        e.dataset.loading !== 'true' &&
-        e.querySelector('[data-docs-transition-content]')?.getAttribute('aria-hidden') !== 'true' &&
-        e.getClientRects().length > 0);
-}) ?? null;
-/**
- * Handles navigate heading.
- *
- * @param id - Tree node identifier used to create the link target.
- * @param text - Tree node label displayed to the reader.
- */
-const navigateHeading = (id, text) => {
-    const shell = docsShellOf();
-    const root = shell?.dataset.docsMode === 'view'
-        ? shell.querySelector('[data-docs-view-root], [data-docs-body-content]')
-        : shell?.dataset.docsMode === 'edit'
-            ? shell.querySelector('[data-docs-body-editor], [data-docs-body-content]')
-            : null;
-    Array.from(root?.querySelectorAll('h2') ?? [])
-        .find(e => e.id === id || e.textContent?.trim() === text)
-        ?.scrollIntoView({ behavior: 'auto', block: 'start' });
-    window.history.pushState(null, '', `#${id}`);
+const UI = {
+    add: { doc: 'Add page', group: 'Add group' },
+    open: 'bg-primary-3 text-primary-12',
 };
 // TYPES
 /*//////////////////////////////////////////////////
@@ -95,8 +72,16 @@ export function Menu({ actions }) {
 function Link({ active: a, contexting = false, dragging = false, renaming = false, node, trailing, mode, transitioning = false, }) {
     const unsaved = useAtom($unsavedDrafts);
     const asset = node.type === 'leaf' && node.asset === true;
-    const isDirty = node.type === 'leaf' && (unsaved[(node.type === 'leaf' ? node.path : '') ?? ''] || unsaved[(node.type === 'leaf' ? node.url : '') ?? '']);
-    return (_jsx(SidebarMenuButton, { asChild: true, isActive: a, className: cn('group h-auto justify-between py-0 transition-colors', contexting && UI.open, renaming && 'ring-1 ring-ring', isDirty && 'pl-1.5'), children: _jsxs("div", { className: 'flex w-full items-center gap-1', children: [_jsxs("a", { href: asset ? (node.type === 'leaf' && node.url ? node.url : '') : 'url' in node && node.url ? node.url : '', target: asset || (node.type === 'leaf' && node.fileType === 'pdf') ? '_blank' : '_self', rel: asset || (node.type === 'leaf' && node.fileType === 'pdf') ? 'noreferrer' : undefined, className: cn('flex min-w-0 flex-1 items-center gap-1.5', dragging && 'pointer-events-none'), draggable: false, onDragStart: e => {
+    const isDirty = node.type === 'leaf' &&
+        (unsaved[(node.type === 'leaf' ? node.path : '') ?? ''] ||
+            unsaved[(node.type === 'leaf' ? node.url : '') ?? '']);
+    return (_jsx(SidebarMenuButton, { asChild: true, isActive: a, className: cn('group h-auto justify-between py-0 transition-colors', contexting && UI.open, renaming && 'ring-1 ring-ring', isDirty && 'pl-1.5'), children: _jsxs("div", { className: "flex w-full items-center gap-1", children: [_jsxs("a", { href: asset
+                        ? node.type === 'leaf' && node.url
+                            ? node.url
+                            : ''
+                        : 'url' in node && node.url
+                            ? node.url
+                            : '', target: asset || (node.type === 'leaf' && node.fileType === 'pdf') ? '_blank' : '_self', rel: asset || (node.type === 'leaf' && node.fileType === 'pdf') ? 'noreferrer' : undefined, className: cn('flex min-w-0 flex-1 items-center gap-1.5', dragging && 'pointer-events-none'), draggable: false, onDragStart: (e) => {
                         e.preventDefault();
                     }, onClick: async (e) => {
                         if (asset || (node.type === 'leaf' && node.fileType === 'pdf'))
@@ -111,7 +96,10 @@ function Link({ active: a, contexting = false, dragging = false, renaming = fals
                         setTransition('local');
                         let data;
                         try {
-                            const result = (await actions.read.doc.get({ path: node.path }));
+                            const result = (await actions.read.doc.get({
+                                id: node.origName,
+                                pathname: node.url,
+                            }));
                             if (!result.error)
                                 data = result.data;
                         }
@@ -125,7 +113,7 @@ function Link({ active: a, contexting = false, dragging = false, renaming = fals
                         }
                         const content = toPortableBody(data.content);
                         resetEditorMounts(node.path, ['root']);
-                        await new Promise(resolve => requestAnimationFrame(() => requestAnimationFrame(() => {
+                        await new Promise((resolve) => requestAnimationFrame(() => requestAnimationFrame(() => {
                             resolve();
                         })));
                         const url = new URL(node.url, window.location.origin);
@@ -139,9 +127,10 @@ function Link({ active: a, contexting = false, dragging = false, renaming = fals
                             url.searchParams.delete('mode');
                         // PIPELINE: sidebar navigation carries stored JSON; View never compiles Markdown.
                         window.history.pushState(null, '', url.toString());
+                        const route = `${url.pathname}${url.search}${url.hash}`;
                         // prettier-ignore
-                        document.dispatchEvent(new CustomEvent('docs:navigate', { detail: { url: url.pathname + url.search, pathname: url.pathname + url.search, path: node.path, title: data.title || node.title, description: data.description ?? node.description, contributors: node.contributors, updatedAt: node.updatedAt, source: data.source, content, compiledMDX: '' } }));
-                    }, children: [isDirty && _jsx("span", { className: 'size-1.5 shrink-0 rounded-full bg-yellow-500', title: 'Unsaved changes' }), _jsx("span", { className: 'line-clamp-1', children: cTitle(toNodeLabel(node.title || node.origName)) }), asset && _jsx(PopOutIcon, { className: 'ml-auto size-3.5 shrink-0 text-primary-10', "aria-hidden": 'true' })] }), trailing] }) }));
+                        document.dispatchEvent(new CustomEvent('docs:navigate', { detail: { url: route, pathname: route, path: node.path, title: data.title || node.title, description: data.description ?? node.description, ...(Array.isArray(node.contributors) ? { contributors: node.contributors } : {}), ...(node.updatedAt ? { updatedAt: node.updatedAt } : {}), source: data.source, content, compiledMDX: '' } }));
+                    }, children: [isDirty && (_jsx("span", { className: "size-1.5 shrink-0 rounded-full bg-yellow-500", title: "Unsaved changes" })), _jsx("span", { className: "line-clamp-1", children: cTitle(toNodeLabel(node.title || node.origName)) }), asset && (_jsx(PopOutIcon, { className: "ml-auto size-3.5 shrink-0 text-primary-10", "aria-hidden": "true" }))] }), trailing] }) }));
 }
 /*//////////////////////////////////////////////////
 COMPONENTS
@@ -158,13 +147,13 @@ COMPONENTS
  *
  * @return The draggable reorder button, hidden or disabled when reordering is unavailable.
  */
-function DragHandle({ disabled, isVisible, onDragStart, onDragEnd }) {
-    return (_jsx(Button, { variant: 'ghost', size: 'icon', "aria-label": 'Reorder item', draggable: true, className: cn(REORDER.handle, isVisible && !disabled ? 'opacity-100' : 'opacity-0 disabled:opacity-0'), disabled: disabled, onClick: e => {
+function DragHandle({ disabled, isVisible, onDragStart, onDragEnd, }) {
+    return (_jsx(Button, { variant: "ghost", size: "icon", "aria-label": "Reorder item", draggable: true, className: cn(REORDER.handle, isVisible && !disabled ? 'opacity-100' : 'opacity-0 disabled:opacity-0'), disabled: disabled, onClick: (e) => {
             e.preventDefault();
-        }, onDragStart: e => {
+        }, onDragStart: (e) => {
             e.stopPropagation();
             onDragStart(e);
-        }, onDragEnd: onDragEnd, title: 'Drag', children: _jsx(DragIcon, { className: 'size-3', "aria-hidden": 'true' }) }));
+        }, onDragEnd: onDragEnd, title: "Drag", children: _jsx(DragIcon, { className: "size-3", "aria-hidden": "true" }) }));
 }
 /*//////////////////////////////////////////////////
 TOC COMPONENTS
@@ -178,169 +167,9 @@ TOC COMPONENTS
  * @return A table of contents for discovered headings, or `null` when there are no headings to navigate.
  */
 const TREE_COMPONENTS = {
-    Toc({ title }) {
-        const [heads, setHeads] = useState([]);
-        const [a, setActive] = useState(null);
-        useEffect(() => {
-            const syncState = { frame: 0, tries: 0, els: [], observedRoot: null, threshold: 0 };
-            const surfaceObserver = new MutationObserver(() => syncLifecycle.sync());
-            const bodyObserver = new MutationObserver(() => {
-                syncLifecycle.sync();
-                if (syncState.observedRoot)
-                    bodyObserver.disconnect();
-            });
-            /**
-             * Sync active.
-             */
-            const syncLifecycle = {
-                syncActive: () => {
-                    if (!syncState.els.length) {
-                        setActive(null);
-                        return;
-                    }
-                    syncState.threshold = window.innerWidth >= 768 ? 160 : 112;
-                    for (let i = syncState.els.length - 1; i >= 0; i--) {
-                        const el = syncState.els[i];
-                        if (el && el.getBoundingClientRect().top <= syncState.threshold) {
-                            setActive(el.id);
-                            return;
-                        }
-                    }
-                    setActive(syncState.els[0]?.id ?? null);
-                },
-                /*
-                 * Queue active.
-                 */
-                queueActive: () => {
-                    cancelAnimationFrame(syncState.frame);
-                    syncState.frame = requestAnimationFrame(syncLifecycle.syncActive);
-                },
-                /*
-                 * Synchronizes the current view state with the source data.
-                 */
-                sync: () => {
-                    try {
-                        const seen = new Set();
-                        const shell = docsShellOf();
-                        let root = null;
-                        for (const e of document.querySelectorAll(shell?.dataset.docsMode === 'view'
-                            ? '[data-docs-view-root], [data-docs-body-content]'
-                            : '[data-docs-body-editor], [data-docs-body-content]')) {
-                            const style = window.getComputedStyle(e);
-                            if (style.display !== 'none' && style.visibility !== 'hidden' && e.getClientRects().length > 0) {
-                                root = e;
-                                break;
-                            }
-                        }
-                        if (!root)
-                            return;
-                        if (root !== syncState.observedRoot) {
-                            surfaceObserver.disconnect();
-                            surfaceObserver.observe(root, { childList: true, characterData: true, subtree: true });
-                            syncState.observedRoot = root;
-                        }
-                        const lowerTitle = title ? title.toLowerCase() : null;
-                        const validEls = [];
-                        const headsList = [];
-                        for (const e of Array.from(root.querySelectorAll('h2') ?? [])) {
-                            if (e.closest('[data-placeholder], [data-tabs-placeholder]') || e.closest('[hidden]'))
-                                continue;
-                            let text = '';
-                            for (const child of Array.from(e.childNodes)) {
-                                if (child instanceof Element && child.classList.contains('heading-anchor-icon'))
-                                    continue;
-                                text += child.textContent || '';
-                            }
-                            text = text.trim();
-                            if (lowerTitle && text.toLowerCase() === lowerTitle)
-                                continue;
-                            const id = e.id || (e.id = toHeadingId(text));
-                            if (!id || seen.has(id))
-                                continue;
-                            seen.add(id);
-                            validEls.push(e);
-                            headsList.push({ id, text });
-                        }
-                        syncState.els = validEls;
-                        if (!syncState.els.length) {
-                            setHeads([]);
-                            setActive(null);
-                            return;
-                        }
-                        setHeads(headsList);
-                        syncLifecycle.queueActive();
-                    }
-                    catch {
-                        /* ignore */
-                    }
-                },
-                /*
-                 * Re-reads headings until the surface has mounted them.
-                 *
-                 */
-                pump: () => {
-                    syncLifecycle.sync();
-                    if (syncState.els.length || syncState.tries++ >= 60)
-                        return;
-                    syncState.frame = requestAnimationFrame(syncLifecycle.pump);
-                },
-                /*
-                 * Handles navigate.
-                 *
-                 * @param e - Pointer event received from the tree interaction.
-                 */
-                navigate: (e) => {
-                    const link = e.target instanceof Element ? e.target.closest('[data-docs-toc-heading]') : null;
-                    const id = link?.dataset.docsTocId;
-                    const text = link?.dataset.docsTocHeading;
-                    if (!id || !text)
-                        return;
-                    e.preventDefault();
-                    navigateHeading(id, text);
-                },
-            };
-            syncLifecycle.pump();
-            if (!syncState.observedRoot)
-                bodyObserver.observe(document.body, { childList: true, subtree: true });
-            window.addEventListener('click', syncLifecycle.navigate, true);
-            document.addEventListener('docs:surface-ready', syncLifecycle.sync);
-            document.addEventListener('astro:after-swap', syncLifecycle.sync);
-            window.addEventListener('hashchange', syncLifecycle.sync);
-            window.addEventListener('resize', syncLifecycle.queueActive);
-            window.addEventListener('scroll', syncLifecycle.queueActive, { passive: true });
-            return () => {
-                window.removeEventListener('click', syncLifecycle.navigate, true);
-                document.removeEventListener('docs:surface-ready', syncLifecycle.sync);
-                document.removeEventListener('astro:after-swap', syncLifecycle.sync);
-                window.removeEventListener('hashchange', syncLifecycle.sync);
-                window.removeEventListener('resize', syncLifecycle.queueActive);
-                window.removeEventListener('scroll', syncLifecycle.queueActive);
-                bodyObserver.disconnect();
-                surfaceObserver.disconnect();
-                cancelAnimationFrame(syncState.frame);
-            };
-        }, [title]);
-        useEffect(() => {
-            const id = decodeURIComponent(window.location.hash.slice(1));
-            if (!id)
-                return;
-            let heading;
-            for (const i of heads) {
-                if (i.id === id) {
-                    heading = i;
-                    break;
-                }
-            }
-            if (heading)
-                navigateHeading(id, heading.text);
-        }, [heads]);
-        if (!heads?.length)
-            return null;
-        return (_jsx("nav", { "aria-label": 'Table of contents', children: _jsx(SidebarMenuSub, { className: 'mr-0 pr-0', children: heads.map(h => (_jsx(SidebarMenuSubItem, { children: _jsx(ButtonLink, { "data-docs-toc-id": h.id, "data-docs-toc-heading": h.text, href: `#${h.id}`, variant: 'ghost', size: 'xs', "aria-label": `Jump to ${h.text}`, className: cn('relative w-full justify-start truncate pl-4 before:absolute before:left-1.5 before:top-1/2 before:size-1 before:-translate-y-1/2 before:rounded-full before:content-[""] hover:!bg-transparent', a === h.id ? 'text-primary-12 before:bg-current' : 'text-primary-11 before:bg-primary-11 before:opacity-0 hover:before:opacity-100'), children: h.text }) }, h.id))) }) }));
-    },
     /*//////////////////////////////////////////////////
-LEAF COMPONENTS
-//////////////////////////////////////////////////*/
+  LEAF COMPONENTS
+  //////////////////////////////////////////////////*/
     /**
      * Renders the leaf component.
      *
@@ -429,7 +258,12 @@ LEAF COMPONENTS
                             if (!isIdx && isMd)
                                 continue;
                             const sNode = siblingByPath.get(p);
-                            sisList.push({ name: bName(p), path: p, title: sNode && sNode.type === 'leaf' ? sNode.title : undefined, isMd });
+                            sisList.push({
+                                name: bName(p),
+                                path: p,
+                                title: sNode && sNode.type === 'leaf' ? sNode.title : undefined,
+                                isMd,
+                            });
                         }
                         setSis(sisList);
                     }
@@ -473,7 +307,10 @@ LEAF COMPONENTS
                             return;
                         }
                         try {
-                            const { data: res, error: resErr } = await actions.read.doc.resolvePath({ path: node.path, title: nTitle });
+                            const { data: res, error: resErr } = await actions.read.doc.resolvePath({
+                                path: node.path,
+                                title: nTitle,
+                            });
                             if (resErr || !res)
                                 throw resErr || new Error('Failed to resolve path');
                             const nPath = res.path;
@@ -493,13 +330,21 @@ LEAF COMPONENTS
                                     cur: node.path,
                                     next: nPath,
                                     title: nTitle,
-                                    source: docData && typeof docData === 'object' && 'source' in docData && typeof docData.source === 'string' ? docData.source : '',
+                                    source: docData &&
+                                        typeof docData === 'object' &&
+                                        'source' in docData &&
+                                        typeof docData.source === 'string'
+                                        ? docData.source
+                                        : '',
                                 });
                                 if (err)
                                     throw err;
                             }
                             else {
-                                const { error: writeErr } = await actions.write.doc.editor({ path: nPath, title: nTitle });
+                                const { error: writeErr } = await actions.write.doc.editor({
+                                    path: nPath,
+                                    title: nTitle,
+                                });
                                 if (writeErr)
                                     throw writeErr;
                             }
@@ -628,7 +473,7 @@ LEAF COMPONENTS
                         continue;
                     const tmpId = `temp-${Date.now()}-${i}`;
                     const isMdFile = TerraQualityRegex.REGEX_MD_MDX_I_REGEX().test(file.name);
-                    setSis(p => [...p, { id: tmpId, path: tmpId, name: file.name, isMd: isMdFile }]);
+                    setSis((p) => [...p, { id: tmpId, path: tmpId, name: file.name, isMd: isMdFile }]);
                     const finalAsset = await uploadAssetChunked(file, node.path, {
                         onProgress: ({ bytes }) => {
                             uploadedSize += bytes;
@@ -637,10 +482,10 @@ LEAF COMPONENTS
                     });
                     const fPath = finalAsset.path || finalAsset.src || tmpId;
                     const nName = fPath.split('/').pop() || file.name;
-                    setSis(p => {
-                        if (p.some(s => s.name === nName && s.id !== tmpId))
-                            return p.filter(s => s.id !== tmpId);
-                        return p.map(s => (s.id === tmpId ? { ...s, path: fPath, name: nName, isMd: isMdFile } : s));
+                    setSis((p) => {
+                        if (p.some((s) => s.name === nName && s.id !== tmpId))
+                            return p.filter((s) => s.id !== tmpId);
+                        return p.map((s) => s.id === tmpId ? { ...s, path: fPath, name: nName, isMd: isMdFile } : s);
                     });
                 }
                 toast.success('Files attached successfully.');
@@ -669,13 +514,16 @@ LEAF COMPONENTS
                     label: 'New name',
                     value: s.name.replace(TerraQualityRegex.REGEX_I_REGEX(), ''),
                     onCancel: () => { },
-                    onSave: nName => runMutation(async () => {
-                        const fileName = { extension: s.name.match(TerraQualityRegex.REGEX_I_REGEX())?.[0] ?? '', stem: sanitizeName(nName) };
+                    onSave: (nName) => runMutation(async () => {
+                        const fileName = {
+                            extension: s.name.match(TerraQualityRegex.REGEX_I_REGEX())?.[0] ?? '',
+                            stem: sanitizeName(nName),
+                        };
                         const nFilename = `${fileName.stem}${fileName.extension}`;
                         const dir = dirname(s.path);
                         const nPath = `${dir && dir !== '.' ? `${dir}/` : ''}${nFilename}`;
                         // optimistic UI update
-                        setSis(p => p.map(x => (x.path === s.path ? { ...x, path: nPath, name: nFilename } : x)));
+                        setSis((p) => p.map((x) => (x.path === s.path ? { ...x, path: nPath, name: nFilename } : x)));
                         ctx.setInputDlg(null);
                         try {
                             if (s.isMd) {
@@ -683,16 +531,26 @@ LEAF COMPONENTS
                                 const { error } = await actions.write.doc.commit({
                                     cur: s.path,
                                     next: nPath,
-                                    source: docData && typeof docData === 'object' && 'source' in docData && typeof docData.source === 'string' ? docData.source : '',
+                                    source: docData &&
+                                        typeof docData === 'object' &&
+                                        'source' in docData &&
+                                        typeof docData.source === 'string'
+                                        ? docData.source
+                                        : '',
                                 });
                                 if (error)
                                     throw error;
                             }
                             else {
-                                const { data: buf, error: readErr } = await actions.read.asset.get({ path: s.path });
+                                const { data: buf, error: readErr } = await actions.read.asset.get({
+                                    path: s.path,
+                                });
                                 if (readErr || !buf)
                                     throw readErr || new Error('Failed to read asset');
-                                const { error: writeErr } = await actions.write.asset.raw({ bytes: buf, path: nPath });
+                                const { error: writeErr } = await actions.write.asset.raw({
+                                    bytes: buf,
+                                    path: nPath,
+                                });
                                 if (writeErr)
                                     throw writeErr;
                                 await actions.write.doc.rm({ path: s.path, type: 'asset', assets: false });
@@ -701,7 +559,7 @@ LEAF COMPONENTS
                         }
                         catch (err) {
                             // revert on failure
-                            setSis(p => p.map(x => (x.path === nPath ? { ...x, path: s.path, name: s.name } : x)));
+                            setSis((p) => p.map((x) => (x.path === nPath ? { ...x, path: s.path, name: s.name } : x)));
                             throw err;
                         }
                     }, 'Failed to rename attachment.'),
@@ -721,7 +579,7 @@ LEAF COMPONENTS
                     label: 'New name',
                     value: `${s.name.replace(TerraQualityRegex.REGEX_I_REGEX(), '')}-copy`,
                     onCancel: () => { },
-                    onSave: n => runMutation(async () => {
+                    onSave: (n) => runMutation(async () => {
                         const tgt = { path: s.path, stem: sanitizeName(n) };
                         const { data: docData, error: err } = await actions.read.doc.get({ path: tgt.path });
                         if (err || !docData)
@@ -729,15 +587,24 @@ LEAF COMPONENTS
                         const nPath = `${dirname(tgt.path)}/${tgt.stem}.mdx`;
                         const { data, error: wErr } = await actions.write.doc.save({
                             path: nPath,
-                            source: typeof docData === 'object' && 'source' in docData && typeof docData.source === 'string' ? docData.source : '',
+                            source: typeof docData === 'object' &&
+                                'source' in docData &&
+                                typeof docData.source === 'string'
+                                ? docData.source
+                                : '',
                         });
                         if (wErr || !data)
                             throw wErr || new Error('Failed to write doc.');
                         const sisterDetails = {
                             name: nPath.split('/').pop() || '',
-                            title: typeof data === 'object' && 'title' in data && typeof data.title === 'string' ? data.title : undefined,
+                            title: typeof data === 'object' && 'title' in data && typeof data.title === 'string'
+                                ? data.title
+                                : undefined,
                         };
-                        setSis(p => [...p, { path: nPath, name: sisterDetails.name, isMd: true, title: sisterDetails.title }]);
+                        setSis((p) => [
+                            ...p,
+                            { path: nPath, name: sisterDetails.name, isMd: true, title: sisterDetails.title },
+                        ]);
                         ctx.setInputDlg(null);
                     }, 'Failed to duplicate.'),
                 });
@@ -754,13 +621,17 @@ LEAF COMPONENTS
                     return;
                 const deletion = {
                     previousSisters: [...sis],
-                    remove: () => setSis(p => p.filter(x => x.path !== s.path)),
+                    remove: () => setSis((p) => p.filter((x) => x.path !== s.path)),
                     restore: () => setSis(deletion.previousSisters),
                 };
                 deletion.remove();
                 runMutation(async () => {
                     try {
-                        const { error } = await actions.write.doc.rm({ assets: false, path: s.path, type: s.isMd ? 'doc' : 'asset' });
+                        const { error } = await actions.write.doc.rm({
+                            assets: false,
+                            path: s.path,
+                            type: s.isMd ? 'doc' : 'asset',
+                        });
                         if (error)
                             throw error;
                     }
@@ -786,12 +657,12 @@ LEAF COMPONENTS
             },
         };
         // RENDER
-        return (_jsxs(SidebarMenuItem, { ref: leafRef, children: [!!node.path && !isSimulated ? (_jsxs(ContextMenu, { onOpenChange: setContexting, children: [_jsx("input", { ref: fileRef, type: 'file', className: 'hidden', multiple: true, onChange: e => void add(e.currentTarget.files), disabled: disabled }), _jsx(ContextMenuTrigger, { asChild: true, children: _jsx("div", { "data-docs-drop": drop, "data-docs-parent": bPath, className: cn('relative rounded-md', dState?.key === drop && dState.position === 'before' && REORDER.before, dState?.key === drop && dState.position === 'after' && REORDER.after, (isMultiSel || isDragOverFile) && 'bg-primary-4/50 ring-2 ring-primary-8', progress !== null && 'pointer-events-none opacity-70'), onMouseEnter: () => {
+        return (_jsxs(SidebarMenuItem, { ref: leafRef, children: [!!node.path && !isSimulated ? (_jsxs(ContextMenu, { onOpenChange: setContexting, children: [_jsx("input", { ref: fileRef, type: "file", className: "hidden", multiple: true, onChange: (e) => void add(e.currentTarget.files), disabled: disabled }), _jsx(ContextMenuTrigger, { asChild: true, children: _jsx("div", { "data-docs-drop": drop, "data-docs-parent": bPath, className: cn('relative rounded-md', dState?.key === drop && dState.position === 'before' && REORDER.before, dState?.key === drop && dState.position === 'after' && REORDER.after, (isMultiSel || isDragOverFile) && 'bg-primary-4/50 ring-2 ring-primary-8', progress !== null && 'pointer-events-none opacity-70'), onMouseEnter: () => {
                                     ctx.setHovered(drop);
                                 }, onMouseLeave: () => {
                                     if (ctx.hovered === drop)
                                         ctx.setHovered(null);
-                                }, onClickCapture: e => {
+                                }, onClickCapture: (e) => {
                                     if (e.metaKey || e.ctrlKey || e.shiftKey) {
                                         e.preventDefault();
                                         e.stopPropagation();
@@ -799,13 +670,13 @@ LEAF COMPONENTS
                                     }
                                     else if (ctx.selectedLeaves.length > 0)
                                         ctx.clearSelection();
-                                }, onDragEnter: e => {
+                                }, onDragEnter: (e) => {
                                     if (permission === 'write' && !drag && e.dataTransfer.types.includes('Files')) {
                                         e.preventDefault();
                                         e.stopPropagation();
                                         setIsDragOverFile(true);
                                     }
-                                }, onDragOver: e => {
+                                }, onDragOver: (e) => {
                                     if (permission !== 'write')
                                         return;
                                     if (!drag && e.dataTransfer.types.includes('Files')) {
@@ -843,14 +714,14 @@ LEAF COMPONENTS
                                     const pos = e.clientY < rect.top + rect.height / 2 ? 'before' : 'after';
                                     if (dState?.key !== drop || dState.position !== pos)
                                         ctx.setDState({ key: drop, position: pos });
-                                }, onDragLeave: e => {
+                                }, onDragLeave: (e) => {
                                     if (isDragOverFile)
                                         setIsDragOverFile(false);
                                     if (e.currentTarget.contains(e.relatedTarget))
                                         return;
                                     if (dState?.key === drop)
                                         ctx.setDState(null);
-                                }, onDrop: e => {
+                                }, onDrop: (e) => {
                                     e.preventDefault();
                                     e.stopPropagation();
                                     if (e.dataTransfer.files?.length && !drag) {
@@ -865,13 +736,21 @@ LEAF COMPONENTS
                                         return;
                                     }
                                     const dPath = e.dataTransfer.getData('application/docs-path');
-                                    const move = drag ?? (e.dataTransfer.getData('application/docs-kind') === 'leaf' && dPath ? { kind: 'leaf', path: dPath } : null);
+                                    const move = drag ??
+                                        (e.dataTransfer.getData('application/docs-kind') === 'leaf' && dPath
+                                            ? { kind: 'leaf', path: dPath }
+                                            : null);
                                     if (!move || move.kind !== 'leaf' || !node.path)
                                         return;
                                     const rect = e.currentTarget.getBoundingClientRect();
-                                    void ctx.mvLeaf({ path: move.path, tPosition: e.clientY < rect.top + rect.height / 2 ? 'before' : 'after', tTarget: node.path, tpath: bPath });
+                                    void ctx.mvLeaf({
+                                        path: move.path,
+                                        tPosition: e.clientY < rect.top + rect.height / 2 ? 'before' : 'after',
+                                        tTarget: node.path,
+                                        tpath: bPath,
+                                    });
                                     ctx.setDrag(null);
-                                }, children: _jsx(Link, { active: a, contexting: contexting || dState?.key === drop, dragging: drag?.kind === 'leaf', renaming: renaming, node: node, mode: mode, trailing: _jsxs("div", { className: 'flex items-center gap-2', children: [progress !== null && _jsxs("span", { className: 'text-xs font-medium text-primary-10', children: [progress, "%"] }), _jsx(DragHandle, { disabled: disabled, isVisible: hovered === drop, onDragStart: e => {
+                                }, children: _jsx(Link, { active: a, contexting: contexting || dState?.key === drop, dragging: drag?.kind === 'leaf', renaming: renaming, node: node, mode: mode, trailing: _jsxs("div", { className: "flex items-center gap-2", children: [progress !== null && (_jsxs("span", { className: "text-xs font-medium text-primary-10", children: [progress, "%"] })), _jsx(DragHandle, { disabled: disabled, isVisible: hovered === drop, onDragStart: (e) => {
                                                     ctx.setDrag({ active: a, kind: 'leaf', path });
                                                     e.dataTransfer.effectAllowed = 'move';
                                                     e.dataTransfer.setData('application/docs-kind', 'leaf');
@@ -880,7 +759,16 @@ LEAF COMPONENTS
                                                     e.dataTransfer.setData('text/plain', path);
                                                 }, onDragEnd: () => {
                                                     ctx.setDrag(null);
-                                                } })] }) }) }) }), _jsx(ContextMenuContent, { children: permission !== 'write' ? (_jsx(Menu, { actions: [{ icon: _jsx(LinkIcon, {}), label: 'Copy link', onSelect: () => { void navigator.clipboard.writeText(new URL(node.url || docsPath(path), window.location.origin).href); toast.success('Link copied'); } }] })) : isMultiSel && ctx.selectedLeaves.length > 1 ? (_jsx(Menu, { actions: [
+                                                } })] }) }) }) }), _jsx(ContextMenuContent, { children: permission !== 'write' ? (_jsx(Menu, { actions: [
+                                    {
+                                        icon: _jsx(LinkIcon, {}),
+                                        label: 'Copy link',
+                                        onSelect: () => {
+                                            void navigator.clipboard.writeText(new URL(node.url || docsPath(path), window.location.origin).href);
+                                            toast.success('Link copied');
+                                        },
+                                    },
+                                ] })) : isMultiSel && ctx.selectedLeaves.length > 1 ? (_jsx(Menu, { actions: [
                                     {
                                         disabled: disabled,
                                         icon: _jsx(DocumentIcon, {}),
@@ -963,11 +851,11 @@ LEAF COMPONENTS
                                     { icon: _jsx(PopOutIcon, {}), label: 'Make asset', disabled: disabled || !(permission === 'write' && !node.asset && !isSimulated && !!path), onSelect: () => { ctx.setAssetTarget({ path, title: cTitle(toNodeLabel(node.title || node.origName)) || bName(path) }); } },
                                     { icon: _jsx(DownloadIcon, {}), label: 'Download page', disabled: disabled, onSelect: () => { ctx.setExportTarget({ paths: [path], rootDir: path, filename: sanitizeName(node.title || bName(path)), title: cTitle(toNodeLabel(node.title || node.origName)) || 'Document' }); } },
                                     { destructive: true, disabled: disabled, icon: _jsx(TrashIcon, {}), label: 'Delete page', onSelect: () => { ctx.setDelTarget({ kind: 'leaf', path: node.path, bPath, active: a, title: node.title || node.path }); } },
-                                ] })) })] })) : (_jsx(Link, { active: a, node: node, mode: mode })), a && _jsx(TREE_COMPONENTS.Toc, { title: node.title })] }));
+                                ] })) })] })) : (_jsx(Link, { active: a, node: node, mode: mode })), a && _jsx(Toc, { title: node.title })] }));
     },
     /*//////////////////////////////////////////////////
-TREE COMPONENTS
-//////////////////////////////////////////////////*/
+  TREE COMPONENTS
+  //////////////////////////////////////////////////*/
     /**
      * Main recursive tree mapping structural layers evaluating context dependencies natively.
      *
@@ -1017,9 +905,11 @@ TREE COMPONENTS
                             return;
                         }
                         // optimistic UI mutation bypasses global loading sweep
-                        ctx.setTree(c => {
+                        ctx.setTree((c) => {
                             const updatedTree = [...c];
-                            const titleFrames = [{ nodes: updatedTree, index: 0 }];
+                            const titleFrames = [
+                                { nodes: updatedTree, index: 0 },
+                            ];
                             while (titleFrames.length) {
                                 const frame = titleFrames[titleFrames.length - 1];
                                 if (!frame)
@@ -1047,7 +937,10 @@ TREE COMPONENTS
                         });
                         ctx.setInputDlg(null);
                         try {
-                            const { error: err } = await actions.write.doc.editor({ path: node.origName, title: nName });
+                            const { error: err } = await actions.write.doc.editor({
+                                path: node.origName,
+                                title: nName,
+                            });
                             if (err)
                                 throw err;
                             toast.success('Group renamed successfully.');
@@ -1108,22 +1001,77 @@ TREE COMPONENTS
         // RENDER
         // leaf
         if (node.type === 'leaf')
-            return (_jsx(ErrorBoundary, { name: 'Tree', children: _jsx(TREE_COMPONENTS.Leaf, { active: pathname !== '' && pathname === nodeUrl, bPath: bPath, node: node, ctx: ctx, siblings: sibs }) }));
+            return (_jsx(ErrorBoundary, { name: "Tree", children: _jsx(TREE_COMPONENTS.Leaf, { active: pathname !== '' && pathname === nodeUrl, bPath: bPath, node: node, ctx: ctx, siblings: sibs }) }));
         // branch
         const branchActions = [
-            { disabled, icon: _jsx(LinkIcon, {}), label: 'Copy link', onSelect: () => { void navigator.clipboard.writeText(`${window.location.origin}${nodeUrl}`); toast.success('Link copied'); } },
-            { disabled, icon: _jsx(AddIcon, {}), label: 'Add page', onSelect: () => { ctx.openCreate(fPath, node.origName); } },
-            { disabled, icon: _jsx(BoxIcon, {}), label: 'Manage attachments', onSelect: () => { ctx.setManageAttTgt({ path: slugPath, title: node.title || slugPath, scope: 'group', node }); } },
-            { disabled, icon: _jsx(DownloadIcon, {}), label: 'Download group', onSelect: () => { ctx.setExportTarget({ paths: toPaths(node.children), rootDir: slugPath, filename: sanitizeName(cTitle(toNodeLabel(node.title || node.origName)) || node.origName), title: `${cTitle(toNodeLabel(node.title || node.origName))} docs`, nodeIds: extractAllNodeIds([node]) }); } },
+            {
+                disabled,
+                icon: _jsx(LinkIcon, {}),
+                label: 'Copy link',
+                onSelect: () => {
+                    void navigator.clipboard.writeText(`${window.location.origin}${nodeUrl}`);
+                    toast.success('Link copied');
+                },
+            },
+            {
+                disabled,
+                icon: _jsx(AddIcon, {}),
+                label: 'Add page',
+                onSelect: () => {
+                    ctx.openCreate(fPath, node.origName);
+                },
+            },
+            {
+                disabled,
+                icon: _jsx(BoxIcon, {}),
+                label: 'Manage attachments',
+                onSelect: () => {
+                    ctx.setManageAttTgt({
+                        path: slugPath,
+                        title: node.title || slugPath,
+                        scope: 'group',
+                        node,
+                    });
+                },
+            },
+            {
+                disabled,
+                icon: _jsx(DownloadIcon, {}),
+                label: 'Download group',
+                onSelect: () => {
+                    ctx.setExportTarget({
+                        paths: toPaths(node.children),
+                        rootDir: slugPath,
+                        filename: sanitizeName(cTitle(toNodeLabel(node.title || node.origName)) || node.origName),
+                        title: `${cTitle(toNodeLabel(node.title || node.origName))} docs`,
+                        nodeIds: extractAllNodeIds([node]),
+                    });
+                },
+            },
             { disabled, icon: _jsx(EditIcon, {}), label: 'Rename group', onSelect: treeActions.renameNode },
-            { separator: true, destructive: true, disabled, icon: _jsx(TrashIcon, {}), label: 'Delete group', onSelect: () => { ctx.setDelTarget({ kind: 'branch', path: fPath, bPath, slugPath, title: node.title || slugPath }); } },
+            {
+                separator: true,
+                destructive: true,
+                disabled,
+                icon: _jsx(TrashIcon, {}),
+                label: 'Delete group',
+                onSelect: () => {
+                    ctx.setDelTarget({
+                        kind: 'branch',
+                        path: fPath,
+                        bPath,
+                        slugPath,
+                        title: node.title || slugPath,
+                    });
+                },
+            },
         ];
-        const label = (_jsx(SidebarGroupLabel, { asChild: true, className: 'p-0', children: _jsxs("div", { "data-docs-drop": drop, className: cn('group flex w-full items-center gap-1 rounded-md px-2 py-1 text-left text-primary-11', dState?.key === drop && dState.position === 'before' && REORDER.before, dState?.key === drop && dState.position === 'after' && REORDER.after, contexting && UI.open, renaming && 'ring-1 ring-ring'), onMouseEnter: () => {
+        const label = (_jsx(SidebarGroupLabel, { asChild: true, className: "p-0", children: _jsxs("div", { "data-docs-drop": drop, className: cn('flex w-full items-center gap-1 rounded-md px-2 py-1 text-left text-primary-11', dState?.key === drop && dState.position === 'before' && REORDER.before, dState?.key === drop && dState.position === 'after' && REORDER.after, contexting && UI.open, renaming && 'ring-1 ring-ring'), onMouseEnter: () => {
                     setHovered(drop);
                 }, onMouseLeave: () => {
                     if (hovered === drop)
                         setHovered(null);
-                }, onDragOver: treeActions.handleDragOver, onDragLeave: treeActions.handleDragLeave, onDrop: e => {
+                }, onDragOver: treeActions.handleDragOver, onDragLeave: treeActions.handleDragLeave, onDrop: (e) => {
                     e.preventDefault();
                     e.stopPropagation();
                     if (e.dataTransfer.files?.length && !drag) {
@@ -1148,9 +1096,15 @@ TREE COMPONENTS
                     if (move.kind === 'leaf')
                         void ctx.mvLeaf({ path: move.path, tPosition: tPos, tTarget: fPath, tpath: bPath });
                     else
-                        void ctx.mvBranch({ fPath: move.fPath, pPath: move.pPath, tpath: bPath, tPosition: tPos, tTarget: fPath });
+                        void ctx.mvBranch({
+                            fPath: move.fPath,
+                            pPath: move.pPath,
+                            tpath: bPath,
+                            tPosition: tPos,
+                            tTarget: fPath,
+                        });
                     ctx.setDrag(null);
-                }, children: [_jsx("span", { className: 'min-w-0 flex-1 truncate', children: cTitle(toNodeLabel(node.title || node.origName)) }), permission === 'write' && !node.simulated && (_jsx(DragHandle, { disabled: disabled, isVisible: hovered === drop, onDragStart: e => {
+                }, children: [_jsx("span", { className: "min-w-0 flex-1 truncate", children: cTitle(toNodeLabel(node.title || node.origName)) }), permission === 'write' && !node.simulated && (_jsx(DragHandle, { disabled: disabled, isVisible: hovered === drop, onDragStart: (e) => {
                             ctx.setDrag({ fPath, kind: 'branch', pPath: bPath });
                             e.dataTransfer.effectAllowed = 'move';
                             e.dataTransfer.setData('application/docs-kind', 'branch');
@@ -1159,8 +1113,9 @@ TREE COMPONENTS
                             e.dataTransfer.setData('text/plain', fPath);
                         }, onDragEnd: () => {
                             ctx.setDrag(null);
-                        } })), permission === 'write' && !node.simulated && (_jsxs(DropdownMenu, { children: [_jsx(DropdownMenuTrigger, { asChild: true, children: _jsx(Button, { variant: 'ghost', size: 'xs', "aria-label": `Actions for group ${cTitle(toNodeLabel(node.title || node.origName))}`, className: 'h-6 w-6 shrink-0 px-1 opacity-0 transition-opacity group-hover:opacity-100 focus-visible:opacity-100', onClick: event => event.stopPropagation(), children: _jsx(OverflowMenuIcon, { size: 16 }) }) }), _jsx(DropdownMenuContent, { align: 'end', children: branchActions.map((action, index) => (_jsxs(Fragment, { children: [action.separator && _jsx(DropdownMenuSeparator, {}), _jsxs(DropdownMenuItem, { disabled: action.disabled, onSelect: () => action.onSelect?.(), className: action.destructive ? 'text-destructive focus:text-destructive' : undefined, children: [action.icon, action.label] })] }, `${action.label}-${index}`))) })] }))] }) }));
-        return (_jsx(ErrorBoundary, { name: 'Tree', children: _jsxs(SidebarGroup, { className: cn('p-0', !bPath.includes('/') && 'mt-4 first:mt-0'), children: [permission === 'write' && !node.simulated ? (_jsxs(ContextMenu, { onOpenChange: setContexting, children: [_jsx(ContextMenuTrigger, { asChild: true, children: label }), _jsx(ContextMenuContent, { children: _jsx(Menu, { actions: branchActions }) })] })) : (label), _jsx(SidebarGroupContent, { children: _jsx(SidebarMenu, { children: node.type === 'branch' && node.children?.map(c => _jsx(TREE_COMPONENTS.Tree, { bPath: fPath, node: c, ctx: ctx, siblings: node.children }, getStableKey(c))) }) })] }) }));
+                        } }))] }) }));
+        return (_jsx(ErrorBoundary, { name: "Tree", children: _jsxs(SidebarGroup, { className: cn('p-0', !bPath.includes('/') && 'mt-4 first:mt-0'), children: [permission === 'write' && !node.simulated ? (_jsxs(ContextMenu, { onOpenChange: setContexting, children: [_jsx(ContextMenuTrigger, { asChild: true, children: label }), _jsx(ContextMenuContent, { children: _jsx(Menu, { actions: branchActions }) })] })) : (label), _jsx(SidebarGroupContent, { children: _jsx(SidebarMenu, { children: node.type === 'branch' &&
+                                node.children?.map((c) => (_jsx(TREE_COMPONENTS.Tree, { bPath: fPath, node: c, ctx: ctx, siblings: node.children }, getStableKey(c)))) }) })] }) }));
     },
 };
 export const { Tree } = TREE_COMPONENTS;