@terra-symposium/docs 0.1.17 → 0.1.71

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

@@ -8,29 +8,32 @@ import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-run
 IMPORTS
 //////////////////////////////////////////////////*/
 // API
-import { $attachmentFilter, $surfaceReady, $transition, clearTransition, sanitizeName, uploadAssetChunked, useAtom } from './_helpers.js';
-import { actions } from '../../runtime/action-proxy.js';
-import { cn, error as logError, errorLog, isRec, notify, warn } from '../../runtime/runtime.js';
-import { createElement, createElement as __terraQualityCreateElement, useCallback, useEffect, useMemo, useRef, useState } from 'react';
-import { currLeafSrc } from '../../runtime/leaf.js';
-import { dirname, docsPath, isDocsPath } from '../../runtime/shared.js';
+import { $surfaceReady, $transition, clearTransition, useAtom, } from '../../../../lib/terra/docs/state.js';
+import { $attachmentFilter } from '../../../../lib/terra/docs/attachments.js';
+import { sanitizeName } from '../../../../lib/terra/docs/tree.js';
+import { uploadAssetChunked } from '../../../../lib/terra/docs/assets.js';
+import { actions } from '../../../../lib/terra/runtime/action-proxy.js';
+import { cn, error as logError, errorLog, isRec, notify, warn, } from '../../../../lib/terra/runtime/runtime.js';
+import { createElement, createElement as __terraQualityCreateElement, useCallback, useEffect, useLayoutEffect, useMemo, useRef, useState, } from 'react';
+import { currLeafSrc } from '../../../../lib/terra/runtime/leaf.js';
+import { dirname, docsPath, isDocsPath } from '../../../../lib/terra/runtime/shared.js';
 import { toast } from 'sonner';
 // COMPONENTS
-import * as TerraQualityRegex from '../../regex.mjs';
+import * as TerraQualityRegex from '../../../../lib/terra/regex.mjs';
 import { ArrowUpRight as PopOutIcon, Box as BoxIcon, Catalog as CatalogIcon, Copy as CopyIcon, Doc as DocumentIcon, Download as DownloadIcon, Edit as EditIcon, Image as ImageIcon, Link as LinkIcon, LogoYoutube as YouTubeIcon, MagicWand as MagicIcon, TrashCan as TrashIcon, Upload as UploadIcon, } from '@carbon/icons-react';
 import { Button } from '@terra-symposium/styling/ui/terra-original';
-import { Card, CardDescription, CardHeader, CardTitle } from '@terra-symposium/styling/ui/terra-original';
+import { Card, CardDescription, CardHeader, CardTitle, } from '@terra-symposium/styling/ui/terra-original';
 import { CodeBlock } from '../../editor/docs/_CodeBlock.js';
-import { Dialog, DialogContent, DialogDescription, DialogFooter, DialogHeader, DialogTitle } from '@terra-symposium/styling/ui/terra-original';
-import { ErrorBoundary } from '../../runtime/ui.js';
-import { Empty } from '../../runtime/ui.js';
+import { Dialog, DialogContent, DialogDescription, DialogFooter, DialogHeader, DialogTitle, } from '@terra-symposium/styling/ui/terra-original';
+import { ErrorBoundary } from '../../ui.js';
+import { Empty } from '../../ui.js';
 import { Input } from '@terra-symposium/styling/ui/terra-original';
 import { Label } from '@terra-symposium/styling/ui/terra-original';
-import { Select, SelectContent, SelectItem, SelectTrigger, SelectValue } from '@terra-symposium/styling/ui/terra-original';
+import { Select, SelectContent, SelectItem, SelectTrigger, SelectValue, } from '@terra-symposium/styling/ui/terra-original';
 import { Textarea } from '@terra-symposium/styling/ui/terra-original';
 import { TsDocsSelect } from './_blocks.js';
 // DATA
-import { ATTCH_TYPES } from './_helpers.js';
+import { ATTCH_TYPES } from '../../../../lib/terra/docs/attachments.js';
 /*//////////////////////////////////////////////////
 HELPERS
 //////////////////////////////////////////////////*/
@@ -52,7 +55,16 @@ const latestContent = (content) => {
  *
  * @param sis - Attachment records to normalize for the Docs editor.
  */
-const textAsset = (sis) => /\.(?:csv|json|log|md|mdx|text|txt|xml|ya?ml)$/i.test(sis.name || sis.path.split('?')[0] || '');
+const textAsset = (sis) => {
+    const extension = /\.(?:csv|json|log|md|mdx|text|txt|xml|ya?ml)(?:[?#].*)?$/i;
+    return [sis.name, sis.title, sis.path].some((candidate) => typeof candidate === 'string' && extension.test(candidate.trim()));
+};
+const attachmentUrl = (attachmentPath, documentPath) => {
+    if (!/^(?:\.\.?(?:\/|$))/.test(attachmentPath))
+        return attachmentPath;
+    const basePath = documentPath.startsWith('/') ? documentPath : `/${documentPath}`;
+    return new URL(attachmentPath, new URL(basePath, window.location.origin)).toString();
+};
 /*//////////////////////////////////////////////////
 COMPONENTS
 //////////////////////////////////////////////////*/
@@ -84,9 +96,10 @@ export function Attachments({ dPath, tree }) {
     const [transferring, setTransferring] = useState(false);
     const [mergePdfState, setMergePdfState] = useState(null);
     const [ctxAttachment, setCtxAttachment] = useState(null);
+    const ctxMenuRef = useRef(null);
     const sistersMap = useMemo(() => {
         const map = new Map();
-        sisters.forEach(s => {
+        sisters.forEach((s) => {
             if (s.path)
                 map.set(s.path, s);
             if (s.id)
@@ -94,7 +107,7 @@ export function Attachments({ dPath, tree }) {
         });
         return map;
     }, [sisters]);
-    const selItems = useMemo(() => sel.map(p => sistersMap.get(p)).filter((s) => Boolean(s)), [sel, sistersMap]);
+    const selItems = useMemo(() => sel.map((p) => sistersMap.get(p)).filter((s) => Boolean(s)), [sel, sistersMap]);
     useEffect(() => {
         if (!viewDlg)
             return;
@@ -105,7 +118,7 @@ export function Attachments({ dPath, tree }) {
         const groups = [tree];
         while (groups.length > 0) {
             const nodes = groups.pop();
-            if (nodes.some(n => n.type === 'leaf' && n.path === dPath)) {
+            if (nodes.some((n) => n.type === 'leaf' && n.path === dPath)) {
                 tgts = nodes.filter((n) => n.type === 'leaf' && n.path !== dPath);
                 break;
             }
@@ -123,7 +136,10 @@ export function Attachments({ dPath, tree }) {
             let cat = 'other';
             if (s.type === 'youtube')
                 cat = 'youtube';
-            else if (s.name.toLowerCase().endsWith('.pdf') || s.path.toLowerCase().split('?')[0].endsWith('.pdf') || s.isMd || s.type === 'document')
+            else if (s.name.toLowerCase().endsWith('.pdf') ||
+                s.path.toLowerCase().split('?')[0].endsWith('.pdf') ||
+                s.isMd ||
+                s.type === 'document')
                 cat = 'document';
             else if (s.type === 'website')
                 cat = 'website';
@@ -131,7 +147,8 @@ export function Attachments({ dPath, tree }) {
                 cat = 'tsdocs';
             else if (TerraQualityRegex.REGEX_PNG_JPE_G_GIF_WEBP_SVG_AVIF_I_REGEX_2().test(s.name))
                 cat = 'image';
-            else if (s.type && ((val) => ATTCH_TYPES.includes(val))(s.type))
+            else if (s.type &&
+                ((val) => ATTCH_TYPES.includes(val))(s.type))
                 cat = s.type;
             if (!attchFilter.includes(cat))
                 continue;
@@ -179,7 +196,7 @@ export function Attachments({ dPath, tree }) {
             }
             setSisters(d);
         })
-            .catch(_err => {
+            .catch((_err) => {
             errorLog('Attachments', 'Fetch threw an exception', logError(_err));
         })
             .finally(() => {
@@ -197,18 +214,21 @@ export function Attachments({ dPath, tree }) {
      * @param sis - Attachment records being filtered for the active document.
      */
     const viewAsset = async (sis) => {
-        if (!textAsset(sis) || !sis.path.startsWith('http')) {
+        if (!textAsset(sis) || !sis.path || sis.path.startsWith('temp-')) {
             setViewDlg(sis);
             return;
         }
         try {
-            const res = await fetch(sis.path);
+            const res = await fetch(attachmentUrl(sis.path, dPath));
             if (!res.ok)
                 throw new Error(`Attachment preview failed (${res.status}).`);
             setViewDlg({ ...sis, content: await res.text() });
         }
         catch (err) {
-            notify({ error: err instanceof Error ? err : new Error('Attachment preview failed.'), fallback: 'Failed to load attachment preview.' });
+            notify({
+                error: err instanceof Error ? err : new Error('Attachment preview failed.'),
+                fallback: 'Failed to load attachment preview.',
+            });
             setViewDlg(sis);
         }
     };
@@ -224,18 +244,30 @@ export function Attachments({ dPath, tree }) {
             const finalAsset = await uploadAssetChunked(file, docId, {
                 onProgress: ({ currentChunk: currChunk, totalChunks, message: msg }) => {
                     if (msg)
-                        setSisters(p => p.map(s => (s.id === tempId ? { ...s, name: msg } : s)));
+                        setSisters((p) => p.map((s) => (s.id === tempId ? { ...s, name: msg } : s)));
                     else if (totalChunks > 1)
-                        setSisters(p => p.map(s => (s.id === tempId ? { ...s, name: `Uploading (${currChunk}/${totalChunks})...` } : s)));
+                        setSisters((p) => p.map((s) => s.id === tempId ? { ...s, name: `Uploading (${currChunk}/${totalChunks})...` } : s));
                 },
             });
-            setSisters(p => p.map(s => (s.id === tempId ? { ...s, path: finalAsset.path || finalAsset.src || tempId, name: finalAsset.name || file.name, isMd: isMdFile, title: file.name } : s)));
+            setSisters((p) => p.map((s) => s.id === tempId
+                ? {
+                    ...s,
+                    ...(finalAsset.id ? { id: finalAsset.id } : {}),
+                    path: finalAsset.path || finalAsset.src || tempId,
+                    name: finalAsset.name || file.name,
+                    isMd: isMdFile,
+                    title: file.name,
+                }
+                : s));
         }
         catch (_err) {
             errorLog('Attachments:Upload', `Failed '${file.name}'`, logError(_err));
-            setSisters(p => p.filter(s => s.id !== tempId));
+            setSisters((p) => p.filter((s) => s.id !== tempId));
             toast.error(_err instanceof Error ? _err.message : `Failed to upload ${file.name}.`);
-            notify({ error: _err instanceof Error ? _err : new Error('Failed to attach.'), fallback: `Failed to upload ${file.name}.` });
+            notify({
+                error: _err instanceof Error ? _err : new Error('Failed to attach.'),
+                fallback: `Failed to upload ${file.name}.`,
+            });
         }
     };
     const add = useCallback(async (v) => {
@@ -243,13 +275,16 @@ export function Attachments({ dPath, tree }) {
             return;
         const validFiles = [];
         const pdfFiles = [];
-        Array.from(v).forEach(f => {
+        Array.from(v).forEach((f) => {
             validFiles.push(f);
             if (f.name.toLowerCase().endsWith('.pdf') || f.type === 'application/pdf')
                 pdfFiles.push(f);
         });
         if (pdfFiles.length > 1) {
-            setMergePdfState({ pdfs: pdfFiles, others: validFiles.filter(f => !pdfFiles.includes(f)) });
+            setMergePdfState({
+                pdfs: pdfFiles,
+                others: validFiles.filter((f) => !pdfFiles.includes(f)),
+            });
             if (fileRef.current)
                 fileRef.current.value = '';
             return;
@@ -257,7 +292,7 @@ export function Attachments({ dPath, tree }) {
         validFiles.forEach((f, i) => {
             const isMdFile = TerraQualityRegex.REGEX_MD_MDX_I_REGEX().test(f.name);
             const tmpId = `temp-${Date.now()}-${i}`;
-            setSisters(p => [...p, { id: tmpId, path: tmpId, name: f.name, isMd: isMdFile }]);
+            setSisters((p) => [...p, { id: tmpId, path: tmpId, name: f.name, isMd: isMdFile }]);
             void processUpload(f, tmpId, isMdFile);
         });
         if (fileRef.current)
@@ -267,7 +302,11 @@ export function Attachments({ dPath, tree }) {
         setAddDialogOpen(false);
         if ($transition.get() || !dPath || !v.trim())
             return;
-        const urls = v.split(TerraQualityRegex.REGEX_N_S_REGEX()).filter(u => (t === 'tsdocs' ? u.trim().length > 0 : u.startsWith('http') || isDocsPath(u) || u.startsWith('/tsdocs')));
+        const urls = v
+            .split(TerraQualityRegex.REGEX_N_S_REGEX())
+            .filter((u) => t === 'tsdocs'
+            ? u.trim().length > 0
+            : u.startsWith('http') || isDocsPath(u) || u.startsWith('/tsdocs'));
         if (!urls.length)
             return;
         setUploading(true);
@@ -285,48 +324,96 @@ export function Attachments({ dPath, tree }) {
             try {
                 let item = null;
                 if (aType === 'youtube') {
-                    const { data, error } = await actions.write.attachment.youtube({ path: docId, url: u });
+                    const { data, error } = await actions.write.attachment.youtube({
+                        path: docId,
+                        url: u,
+                    });
                     if (error || !data)
                         throw error;
                     const { title } = data;
-                    item = { id: tmpId, path: u, name: `${title} Video`, isMd: false, title, type: 'youtube', sourceUrl: u };
+                    item = {
+                        id: tmpId,
+                        path: u,
+                        name: `${title} Video`,
+                        isMd: false,
+                        title,
+                        type: 'youtube',
+                        sourceUrl: u,
+                    };
                 }
                 else if (aType === 'website') {
-                    const { data: webData, error: webErr } = await actions.read.external.website({ url: u });
+                    const { data: webData, error: webErr } = await actions.read.external.website({
+                        url: u,
+                    });
                     if (webErr || !webData)
                         throw webErr;
                     const { title, text } = webData;
                     const dir = dirname(dPath);
                     const nPath = `${dir === '.' ? '' : `${dir}/`}${sanitizeName(title || 'website')}.mdx`;
-                    const { data: docData, error: wErr } = await actions.write.doc.editor({ path: nPath, source: text, title, type: 'website', sourceUrl: u });
+                    const { data: docData, error: wErr } = await actions.write.doc.editor({
+                        path: nPath,
+                        source: text,
+                        title,
+                        type: 'website',
+                        sourceUrl: u,
+                    });
                     if (wErr || !docData)
                         throw wErr;
-                    item = { id: tmpId, path: nPath, name: nPath.split('/').pop() || '', isMd: true, title, type: 'website', sourceUrl: u, source: text };
+                    item = {
+                        id: tmpId,
+                        path: nPath,
+                        name: nPath.split('/').pop() || '',
+                        isMd: true,
+                        title,
+                        type: 'website',
+                        sourceUrl: u,
+                        source: text,
+                    };
                 }
                 else if (aType === 'tsdocs') {
-                    const fmtUrl = u.startsWith('http') ? u : u.startsWith('/') ? `${window.location.origin}${u}` : `${window.location.origin}${docsPath(`tsdocs/${u}`)}`;
+                    const fmtUrl = u.startsWith('http')
+                        ? u
+                        : u.startsWith('/')
+                            ? `${window.location.origin}${u}`
+                            : `${window.location.origin}${docsPath(`tsdocs/${u}`)}`;
                     const { data: linkData, error: linkErr } = await actions.write.attachment.link({
                         path: docId,
                         url: fmtUrl,
                         type: 'tsdocs',
-                        title: (u.split('/').filter(Boolean).pop()?.replace(TerraQualityRegex.REGEX_G_REGEX_7(), ' ') || 'TsDocs Reference').replace(TerraQualityRegex.REGEX_B_W_G_REGEX(), c => c.toUpperCase()),
+                        title: (u
+                            .split('/')
+                            .filter(Boolean)
+                            .pop()
+                            ?.replace(TerraQualityRegex.REGEX_G_REGEX_7(), ' ') || 'TsDocs Reference').replace(TerraQualityRegex.REGEX_B_W_G_REGEX(), (c) => c.toUpperCase()),
                     });
                     if (linkErr || !linkData)
                         throw linkErr;
                     const { title } = linkData;
-                    item = { id: tmpId, path: fmtUrl, name: title, isMd: false, title, type: 'tsdocs', sourceUrl: fmtUrl };
+                    item = {
+                        id: tmpId,
+                        path: fmtUrl,
+                        name: title,
+                        isMd: false,
+                        title,
+                        type: 'tsdocs',
+                        sourceUrl: fmtUrl,
+                    };
                 }
                 else {
-                    const { data, error } = await actions.write.attachment.remoteFile({ path: docId, url: u, type: aType });
+                    const { data, error } = await actions.write.attachment.remoteFile({
+                        path: docId,
+                        url: u,
+                        type: aType,
+                    });
                     if (error || !data)
                         throw error;
-                    const { title, id, path: assetPath, name } = data;
+                    const { title, id, path: assetPath, name, } = data;
                     item = { id, path: assetPath, name, isMd: false, title, type: aType, sourceUrl: u };
                 }
-                setSisters(p => p.map(s => (s.id === tmpId ? item : s)));
+                setSisters((p) => p.map((s) => (s.id === tmpId ? item : s)));
             }
             catch (_err) {
-                setSisters(p => p.filter(s => s.id !== tmpId));
+                setSisters((p) => p.filter((s) => s.id !== tmpId));
                 toast.error(`Failed to process ${u}`);
             }
         }));
@@ -344,14 +431,22 @@ export function Attachments({ dPath, tree }) {
                 return;
             const text = e.clipboardData?.getData('text');
             if (text) {
-                const urls = text.split(TerraQualityRegex.REGEX_N_S_REGEX()).filter(u => u.startsWith('http') || isDocsPath(u) || u.startsWith('/tsdocs'));
+                const urls = text
+                    .split(TerraQualityRegex.REGEX_N_S_REGEX())
+                    .filter((u) => u.startsWith('http') || isDocsPath(u) || u.startsWith('/tsdocs'));
                 if (urls.length > 0) {
                     e.preventDefault();
-                    const ytUrls = urls.filter(u => u.includes('youtube.com') || u.includes('youtu.be'));
-                    const refUrls = urls.filter(u => u.includes('/tsdocs/'));
-                    const imgUrls = urls.filter(u => TerraQualityRegex.REGEX_PNG_JPE_G_GIF_WEBP_SVG_AVIF_I_REGEX_2().test(u.toLowerCase().split('?')[0] ?? ''));
-                    const docUrls = [...urls.filter(u => u.toLowerCase().split('?')[0].endsWith('.pdf')), ...urls.filter(u => u.toLowerCase().split('?')[0].endsWith('.json'))];
-                    const webUrls = urls.filter(u => !ytUrls.includes(u) && !refUrls.includes(u) && !docUrls.includes(u) && !imgUrls.includes(u));
+                    const ytUrls = urls.filter((u) => u.includes('youtube.com') || u.includes('youtu.be'));
+                    const refUrls = urls.filter((u) => u.includes('/tsdocs/'));
+                    const imgUrls = urls.filter((u) => TerraQualityRegex.REGEX_PNG_JPE_G_GIF_WEBP_SVG_AVIF_I_REGEX_2().test(u.toLowerCase().split('?')[0] ?? ''));
+                    const docUrls = [
+                        ...urls.filter((u) => u.toLowerCase().split('?')[0].endsWith('.pdf')),
+                        ...urls.filter((u) => u.toLowerCase().split('?')[0].endsWith('.json')),
+                    ];
+                    const webUrls = urls.filter((u) => !ytUrls.includes(u) &&
+                        !refUrls.includes(u) &&
+                        !docUrls.includes(u) &&
+                        !imgUrls.includes(u));
                     if (ytUrls.length > 0)
                         void addRemote(ytUrls.join('\n'), 'youtube');
                     if (refUrls.length > 0)
@@ -386,19 +481,23 @@ export function Attachments({ dPath, tree }) {
             const { path, name, isMd, id } = renameDlg;
             const nFilename = `${sanitizeName(nName)}${name.match(TerraQualityRegex.REGEX_I_REGEX())?.[0] ?? ''}`;
             const nPath = `${dirname(path) === '.' ? '' : `${dirname(path)}/`}${nFilename}`;
-            setSisters(p => p.map(s => (s.path === path ? { ...s, path: nPath, name: nFilename } : s)));
+            setSisters((p) => p.map((s) => (s.path === path ? { ...s, path: nPath, name: nFilename } : s)));
             if (isMd) {
                 const { error: err } = await actions.write.doc.commit({ cur: path, next: nPath });
                 if (err)
                     throw err;
             }
             else if (id)
-                await actions.write.attachment.rename({ docPath: docId, attachmentKey: id, newName: nFilename });
+                await actions.write.attachment.rename({
+                    docPath: docId,
+                    attachmentKey: id,
+                    newName: nFilename,
+                });
             toast.success('Renamed successfully');
         }
         catch (_err) {
             errorLog('Attachments:Rename', 'Rename failed', logError(_err));
-            setSisters(p => p.map(s => (s.path === renameDlg.path ? { ...s, path: renameDlg.path, name: renameDlg.name } : s)));
+            setSisters((p) => p.map((s) => s.path === renameDlg.path ? { ...s, path: renameDlg.path, name: renameDlg.name } : s));
             toast.error('Failed to rename attachment');
         }
         finally {
@@ -414,8 +513,8 @@ export function Attachments({ dPath, tree }) {
     const remove = async (items) => {
         if (!window.confirm(`Are you sure you want to delete ${items.length} items?`))
             return;
-        const itemKeys = new Set(items.flatMap(i => [i.id, i.path].filter(Boolean)));
-        setSisters(p => p.filter(s => !(s.id && itemKeys.has(s.id)) && !(s.path && itemKeys.has(s.path))));
+        const itemKeys = new Set(items.flatMap((i) => [i.id, i.path].filter(Boolean)));
+        setSisters((p) => p.filter((s) => !(s.id && itemKeys.has(s.id)) && !(s.path && itemKeys.has(s.path))));
         try {
             await Promise.allSettled(items.map(async (i) => {
                 if (i.isMd)
@@ -430,10 +529,17 @@ export function Attachments({ dPath, tree }) {
         }
         catch (_err) {
             setSisters([...sisters]);
-            notify({ error: _err instanceof Error ? _err : new Error('Deletion failed'), fallback: 'Failed to delete some attachments.' });
+            notify({
+                error: _err instanceof Error ? _err : new Error('Deletion failed'),
+                fallback: 'Failed to delete some attachments.',
+            });
         }
     };
-    const isDialogOpen = !!mergePdfState || !!viewDlg || (renameDlg?.open ?? false) || (transferDlg?.open ?? false) || addDialogOpen;
+    const isDialogOpen = !!mergePdfState ||
+        !!viewDlg ||
+        (renameDlg?.open ?? false) ||
+        (transferDlg?.open ?? false) ||
+        addDialogOpen;
     // GLOBAL KEYBOARD SHORTCUTS
     useEffect(() => {
         /**
@@ -472,6 +578,18 @@ export function Attachments({ dPath, tree }) {
         window.addEventListener('keydown', close);
         return () => window.removeEventListener('keydown', close);
     }, [ctxAttachment]);
+    useLayoutEffect(() => {
+        const menu = ctxMenuRef.current;
+        if (!ctxAttachment || !menu)
+            return;
+        const { width, height } = menu.getBoundingClientRect();
+        const inset = 8;
+        const x = Math.max(inset, Math.min(ctxAttachment.x, window.innerWidth - width - inset));
+        const y = Math.max(inset, Math.min(ctxAttachment.y, window.innerHeight - height - inset));
+        if (x !== ctxAttachment.x || y !== ctxAttachment.y) {
+            setCtxAttachment((current) => current?.item.path === ctxAttachment.item.path ? { ...current, x, y } : current);
+        }
+    }, [ctxAttachment]);
     useEffect(() => {
         /**
          * Opens the attachment context menu for the item under the pointer.
@@ -479,9 +597,13 @@ export function Attachments({ dPath, tree }) {
          * @param e - Mouse event used to identify the attachment item and menu position.
          */
         const open = (e) => {
-            const id = (e.target instanceof Element ? e.target.closest('[data-docs-attachment-id]') : null)?.dataset.docsAttachmentId;
+            const id = (e.target instanceof Element
+                ? e.target.closest('[data-docs-attachment-id]')
+                : null)?.dataset.docsAttachmentId;
             const item = id ? sistersMap.get(id) : undefined;
-            if (!(e.target instanceof Element ? e.target.closest('[data-docs-attachments]') : null))
+            if (!(e.target instanceof Element
+                ? e.target.closest('[data-docs-attachments]')
+                : null))
                 return;
             e.preventDefault();
             if (item)
@@ -493,72 +615,94 @@ export function Attachments({ dPath, tree }) {
         return () => document.removeEventListener('contextmenu', open, true);
     }, [sistersMap]);
     // RENDER
-    return (_jsxs(ErrorBoundary, { name: 'Attachments', children: [_jsxs("div", { "data-docs-attachments": true, "data-docs-path": dPath, "data-loading": loading, className: cn('-mx-6 -my-40 flex min-h-[calc(100vh+8rem)] flex-col rounded-xl border-2 px-6 pb-40 transition-colors md:-mx-20 md:px-20', isDragging ? 'border-primary-8 bg-primary-4/20' : 'border-transparent'), onDragOver: e => {
+    return (_jsxs(ErrorBoundary, { name: "Attachments", children: [_jsxs("div", { "data-docs-attachments": true, "data-docs-path": dPath, "data-loading": loading, className: cn('-mx-6 -my-40 flex min-h-[calc(100vh+8rem)] flex-col rounded-xl border-2 px-6 pb-40 transition-colors md:-mx-20 md:px-20', isDragging ? 'border-primary-8 bg-primary-4/20' : 'border-transparent'), onDragOver: (e) => {
                     e.preventDefault();
                     e.stopPropagation();
                     setIsDragging(true);
-                }, onDragEnter: e => {
+                }, onDragEnter: (e) => {
                     e.preventDefault();
                     e.stopPropagation();
                     setIsDragging(true);
-                }, onDragLeave: e => {
+                }, onDragLeave: (e) => {
                     e.preventDefault();
                     e.stopPropagation();
                     setIsDragging(false);
-                }, onDrop: e => {
+                }, onDrop: (e) => {
                     e.preventDefault();
                     e.stopPropagation();
                     setIsDragging(false);
                     if (e.dataTransfer.files?.length)
                         void add(e.dataTransfer.files);
-                }, onContextMenu: e => {
+                }, onContextMenu: (e) => {
                     if (e.target === e.currentTarget) {
                         e.preventDefault();
                         setAddDialogOpen(true);
                     }
-                }, onClick: e => {
+                }, onClick: (e) => {
                     if (e.target === e.currentTarget)
                         setSel([]);
-                }, children: [_jsx("div", { className: 'flex flex-col gap-8 py-8', children: loading ? null : Object.keys(gSisters).length === 0 ? (_jsx(Empty, { children: "No attachments found." })) : (ATTCH_TYPES.filter(c => gSisters[c]).map(c => (_jsxs("div", { className: 'space-y-4', children: [_jsx("h3", { className: 'h3 capitalize', children: c }), _jsx("div", { className: 'grid grid-cols-1 content-start gap-4 sm:grid-cols-2 md:grid-cols-1 lg:grid-cols-3', children: gSisters[c].map(v => {
+                }, children: [_jsx("div", { className: "flex flex-col gap-8 py-8", children: loading ? null : Object.keys(gSisters).length === 0 ? (_jsx(Empty, { children: "No attachments found." })) : (ATTCH_TYPES.filter((c) => gSisters[c]).map((c) => (_jsxs("div", { className: "space-y-4", children: [_jsx("h3", { className: "h3 capitalize", children: c }), _jsx("div", { className: "grid grid-cols-1 content-start gap-4 sm:grid-cols-2 md:grid-cols-1 lg:grid-cols-3", children: gSisters[c].map((v) => {
                                         const isTemp = v.path.startsWith('temp-');
-                                        return (_jsx(Card, { "data-docs-attachment-id": v.id || v.path, role: 'button', tabIndex: isTemp ? -1 : 0, "aria-disabled": isTemp ? true : undefined, "aria-selected": sel.includes(v.path), "aria-label": `Attachment ${v.title || v.name}`, className: cn('cursor-pointer transition-colors hover:border-primary-8 focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-primary-8', sel.includes(v.path) && 'bg-primary-4/50 ring-2 ring-primary-8', isTemp && 'pointer-events-none opacity-50'), onKeyDown: e => {
+                                        return (_jsx(Card, { "data-docs-attachment-id": v.id || v.path, role: "button", tabIndex: isTemp ? -1 : 0, "aria-disabled": isTemp ? true : undefined, "aria-selected": sel.includes(v.path), "aria-label": `Attachment ${v.title || v.name}`, className: cn('cursor-pointer transition-colors hover:border-primary-8 focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-primary-8', sel.includes(v.path) && 'bg-primary-4/50 ring-2 ring-primary-8', isTemp && 'pointer-events-none opacity-50'), onKeyDown: (e) => {
                                                 if (isTemp)
                                                     return;
                                                 if (e.key === 'Enter' || e.key === ' ') {
                                                     e.preventDefault();
                                                     if (v.type === 'youtube')
-                                                        setViewDlg({ ...v, isMd: true, content: latestContent(v.content) || 'No transcript text found.' });
+                                                        setViewDlg({
+                                                            ...v,
+                                                            isMd: true,
+                                                            content: latestContent(v.content) || 'No transcript text found.',
+                                                        });
                                                     else
                                                         void viewAsset(v);
                                                 }
-                                            }, onClick: e => {
+                                            }, onClick: (e) => {
                                                 if (isTemp)
                                                     return;
                                                 e.stopPropagation();
                                                 if (e.shiftKey && sel.length > 0) {
-                                                    const i1 = sisters.findIndex(s => s.path === sel[sel.length - 1]);
-                                                    const i2 = sisters.findIndex(s => s.path === v.path);
-                                                    setSel(p => Array.from(new Set([...(e.metaKey || e.ctrlKey ? p : []), ...sisters.slice(Math.min(i1, i2), Math.max(i1, i2) + 1).map(s => s.path)])));
+                                                    const i1 = sisters.findIndex((s) => s.path === sel[sel.length - 1]);
+                                                    const i2 = sisters.findIndex((s) => s.path === v.path);
+                                                    setSel((p) => Array.from(new Set([
+                                                        ...(e.metaKey || e.ctrlKey ? p : []),
+                                                        ...sisters
+                                                            .slice(Math.min(i1, i2), Math.max(i1, i2) + 1)
+                                                            .map((s) => s.path),
+                                                    ])));
                                                 }
                                                 else if (e.metaKey || e.ctrlKey) {
-                                                    setSel(p => (p.includes(v.path) ? p.filter(x => x !== v.path) : [...p, v.path]));
+                                                    setSel((p) => p.includes(v.path) ? p.filter((x) => x !== v.path) : [...p, v.path]);
                                                 }
                                                 else {
                                                     if (v.type === 'youtube')
-                                                        setViewDlg({ ...v, isMd: true, content: latestContent(v.content) || 'No transcript text found.' });
+                                                        setViewDlg({
+                                                            ...v,
+                                                            isMd: true,
+                                                            content: latestContent(v.content) || 'No transcript text found.',
+                                                        });
                                                     else
                                                         void viewAsset(v);
                                                 }
-                                            }, onContextMenu: e => {
+                                            }, onContextMenu: (e) => {
                                                 e.preventDefault();
                                                 setCtxAttachment({ item: v, x: e.clientX, y: e.clientY });
                                             }, children: _jsxs(CardHeader, { children: [__terraQualityCreateElement(
-                                                    /* prettier-ignore */ v.type === 'youtube' ? YouTubeIcon : v.type === 'website' ? LinkIcon : v.type === 'image' ? ImageIcon : v.type === 'tsdocs' ? CatalogIcon : v.type === 'other' ? BoxIcon : DocumentIcon, { className: 'size-6 text-primary-10', 'aria-hidden': 'true' }), _jsx(CardTitle, { className: 'truncate text-base', children: v.title || v.name }), _jsx(CardDescription, { className: 'truncate', children: v.sourceUrl || v.path })] }) }, v.id || v.path));
-                                    }) })] }, c)))) }), _jsx("input", { "data-testid": 'docs-attachment-upload', ref: fileRef, type: 'file', className: 'hidden', multiple: true, onChange: e => void add(e.currentTarget.files), disabled: uploading || loading })] }), ctxAttachment && (_jsx("div", { role: 'menu', "data-docs-attachment-menu": true, className: 'fixed z-[120] min-w-32 rounded-md border border-primary-6 bg-white p-1 text-primary-12 shadow-lg dark:bg-black', style: { left: ctxAttachment.x, top: ctxAttachment.y }, onContextMenu: e => e.preventDefault(), children: (sel.includes(ctxAttachment.item.path) && sel.length > 1
+                                                    /* prettier-ignore */ v.type === 'youtube' ? YouTubeIcon : v.type === 'website' ? LinkIcon : v.type === 'image' ? ImageIcon : v.type === 'tsdocs' ? CatalogIcon : v.type === 'other' ? BoxIcon : DocumentIcon, { className: 'size-6 text-primary-10', 'aria-hidden': 'true' }), _jsx(CardTitle, { className: "truncate text-base", children: v.title || v.name }), _jsx(CardDescription, { className: "truncate", children: v.sourceUrl || v.path })] }) }, v.id || v.path));
+                                    }) })] }, c)))) }), _jsx("input", { "data-testid": "docs-attachment-upload", ref: fileRef, type: "file", className: "hidden", multiple: true, onChange: (e) => void add(e.currentTarget.files), disabled: uploading || loading })] }), ctxAttachment && (_jsx("div", { ref: ctxMenuRef, role: "menu", "data-docs-attachment-menu": true, className: "fixed z-[120] max-h-[calc(100dvh-1rem)] min-w-32 max-w-[calc(100vw-1rem)] overflow-y-auto rounded-md border border-primary-6 bg-white p-1 text-primary-12 shadow-lg dark:bg-black", style: { left: ctxAttachment.x, top: ctxAttachment.y }, onContextMenu: (e) => e.preventDefault(), children: (sel.includes(ctxAttachment.item.path) && sel.length > 1
                     ? [
-                        { icon: _jsx(CopyIcon, {}), label: `Copy ${sel.length} items`, onSelect: () => setTransferDlg({ open: true, action: 'copy', items: selItems }) },
-                        { icon: _jsx(PopOutIcon, {}), label: `Move ${sel.length} items`, onSelect: () => setTransferDlg({ open: true, action: 'cut', items: selItems }) },
-                        ...(selItems.every(s => s.path.toLowerCase().split('?')[0].endsWith('.pdf') || s.name.toLowerCase().endsWith('.pdf'))
+                        {
+                            icon: _jsx(CopyIcon, {}),
+                            label: `Copy ${sel.length} items`,
+                            onSelect: () => setTransferDlg({ open: true, action: 'copy', items: selItems }),
+                        },
+                        {
+                            icon: _jsx(PopOutIcon, {}),
+                            label: `Move ${sel.length} items`,
+                            onSelect: () => setTransferDlg({ open: true, action: 'cut', items: selItems }),
+                        },
+                        ...(selItems.every((s) => s.path.toLowerCase().split('?')[0].endsWith('.pdf') ||
+                            s.name.toLowerCase().endsWith('.pdf'))
                             ? [
                                 {
                                     icon: _jsx(DocumentIcon, {}),
@@ -569,10 +713,17 @@ export function Attachments({ dPath, tree }) {
                                                 return;
                                             setUploading(true);
                                             const tmpId = `temp-merge-${Date.now()}`;
-                                            const itemKeys = new Set(selItems.flatMap(i => [i.id, i.path].filter(Boolean)));
-                                            setSisters(p => [
-                                                ...p.filter(s => !(s.id && itemKeys.has(s.id)) && !(s.path && itemKeys.has(s.path))),
-                                                { id: tmpId, path: tmpId, name: 'Merging PDFs...', isMd: false, type: 'document' },
+                                            const itemKeys = new Set(selItems.flatMap((i) => [i.id, i.path].filter(Boolean)));
+                                            setSisters((p) => [
+                                                ...p.filter((s) => !(s.id && itemKeys.has(s.id)) &&
+                                                    !(s.path && itemKeys.has(s.path))),
+                                                {
+                                                    id: tmpId,
+                                                    path: tmpId,
+                                                    name: 'Merging PDFs...',
+                                                    isMd: false,
+                                                    type: 'document',
+                                                },
                                             ]);
                                             setSel([]);
                                             try {
@@ -585,31 +736,52 @@ export function Attachments({ dPath, tree }) {
                                                         buf = await (await fetch(item.path)).arrayBuffer();
                                                     }
                                                     else {
-                                                        const { data, error: err } = await actions.read.asset.get({ path: item?.path || '' });
+                                                        const { data, error: err } = await actions.read.asset.get({
+                                                            path: item?.path || '',
+                                                        });
                                                         if (err || !data)
                                                             throw err || new Error('Failed to read local asset');
                                                         buf = data;
                                                     }
                                                     const pdfDoc = await PDFDocument.load(buf);
-                                                    (await mergedPdf.copyPages(pdfDoc, pdfDoc.getPageIndices())).forEach(p => mergedPdf.addPage(p));
+                                                    (await mergedPdf.copyPages(pdfDoc, pdfDoc.getPageIndices())).forEach((p) => mergedPdf.addPage(p));
                                                 }
                                                 const mergedFile = new File([(await mergedPdf.save()).buffer], 'Merged-Document.pdf', { type: 'application/pdf' });
-                                                setSisters(p => p.map(s => (s.id === tmpId ? { ...s, name: 'Uploading Merged PDF...' } : s)));
+                                                setSisters((p) => p.map((s) => s.id === tmpId ? { ...s, name: 'Uploading Merged PDF...' } : s));
                                                 const finalAsset = await uploadAssetChunked(mergedFile, docId, {
-                                                    onProgress: ({ currentChunk: currChunk, totalChunks, message: msg }) => {
+                                                    onProgress: ({ currentChunk: currChunk, totalChunks, message: msg, }) => {
                                                         if (msg)
-                                                            setSisters(p => p.map(s => (s.id === tmpId ? { ...s, name: msg } : s)));
+                                                            setSisters((p) => p.map((s) => (s.id === tmpId ? { ...s, name: msg } : s)));
                                                         else if (totalChunks > 1)
-                                                            setSisters(p => p.map(s => (s.id === tmpId ? { ...s, name: `Uploading (${currChunk}/${totalChunks})...` } : s)));
+                                                            setSisters((p) => p.map((s) => s.id === tmpId
+                                                                ? {
+                                                                    ...s,
+                                                                    name: `Uploading (${currChunk}/${totalChunks})...`,
+                                                                }
+                                                                : s));
                                                     },
                                                 });
                                                 const fPath = finalAsset.path || finalAsset.src || tmpId;
-                                                setSisters(p => p.map(s => (s.id === tmpId ? { ...s, path: fPath, name: fPath.split('/').pop() || mergedFile.name } : s)));
+                                                setSisters((p) => p.map((s) => s.id === tmpId
+                                                    ? {
+                                                        ...s,
+                                                        ...(finalAsset.id ? { id: finalAsset.id } : {}),
+                                                        path: fPath,
+                                                        name: fPath.split('/').pop() || mergedFile.name,
+                                                    }
+                                                    : s));
                                                 await Promise.allSettled(selItems.map(async (i) => {
                                                     if (i.isMd)
-                                                        await actions.write.doc.rm({ assets: false, path: i.path, type: 'doc' });
+                                                        await actions.write.doc.rm({
+                                                            assets: false,
+                                                            path: i.path,
+                                                            type: 'doc',
+                                                        });
                                                     else if (i.id) {
-                                                        await actions.write.attachment.rm({ docPath: docId, attachmentKey: i.id });
+                                                        await actions.write.attachment.rm({
+                                                            docPath: docId,
+                                                            attachmentKey: i.id,
+                                                        });
                                                         if (i.path.startsWith('http'))
                                                             await actions.write.asset.delete({ url: i.path });
                                                     }
@@ -630,7 +802,12 @@ export function Attachments({ dPath, tree }) {
                             ]
                             : []),
                         { separator: true },
-                        { destructive: true, icon: _jsx(TrashIcon, {}), label: `Delete ${sel.length} items`, onSelect: () => void remove(selItems) },
+                        {
+                            destructive: true,
+                            icon: _jsx(TrashIcon, {}),
+                            label: `Delete ${sel.length} items`,
+                            onSelect: () => void remove(selItems),
+                        },
                     ]
                     : [
                         ...(!ctxAttachment.item.type || ctxAttachment.item.type !== 'youtube'
@@ -638,19 +815,38 @@ export function Attachments({ dPath, tree }) {
                                 {
                                     onSelect: () => {
                                         setRenameInput(ctxAttachment.item.name.replace(TerraQualityRegex.REGEX_I_REGEX(), ''));
-                                        setRenameDlg({ open: true, path: ctxAttachment.item.path, name: ctxAttachment.item.name, isMd: ctxAttachment.item.isMd || false, id: ctxAttachment.item.id });
+                                        setRenameDlg({
+                                            open: true,
+                                            path: ctxAttachment.item.path,
+                                            name: ctxAttachment.item.name,
+                                            isMd: ctxAttachment.item.isMd || false,
+                                            id: ctxAttachment.item.id,
+                                        });
                                     },
                                     icon: _jsx(EditIcon, {}),
                                     label: 'Rename',
                                 },
                             ]
                             : []),
-                        { icon: _jsx(CopyIcon, {}), label: 'Copy to...', onSelect: () => setTransferDlg({ open: true, action: 'copy', items: [ctxAttachment.item] }) },
-                        { icon: _jsx(PopOutIcon, {}), label: 'Move to...', onSelect: () => setTransferDlg({ open: true, action: 'cut', items: [ctxAttachment.item] }) },
+                        {
+                            icon: _jsx(CopyIcon, {}),
+                            label: 'Copy to...',
+                            onSelect: () => setTransferDlg({ open: true, action: 'copy', items: [ctxAttachment.item] }),
+                        },
+                        {
+                            icon: _jsx(PopOutIcon, {}),
+                            label: 'Move to...',
+                            onSelect: () => setTransferDlg({ open: true, action: 'cut', items: [ctxAttachment.item] }),
+                        },
                         ...(ctxAttachment.item.isMd
                             ? [
                                 {
-                                    onSelect: () => document.dispatchEvent(new CustomEvent('docs:synthesize', { detail: { path: ctxAttachment.item.path, name: ctxAttachment.item.name } })),
+                                    onSelect: () => document.dispatchEvent(new CustomEvent('docs:synthesize', {
+                                        detail: {
+                                            path: ctxAttachment.item.path,
+                                            name: ctxAttachment.item.name,
+                                        },
+                                    })),
                                     icon: _jsx(MagicIcon, {}),
                                     label: 'Synthesize Content',
                                 },
@@ -672,11 +868,15 @@ export function Attachments({ dPath, tree }) {
                                                         if (readErr || !docData)
                                                             throw readErr || new Error('Failed to read doc.');
                                                         const nPath = `${dirname(path)}/${sanitizeName(name)}.mdx`;
-                                                        const { data, error: writeErr } = await actions.write.doc.save({ path: nPath, source: docData.source });
+                                                        const { data, error: writeErr } = await actions.write.doc.save({
+                                                            path: nPath,
+                                                            source: docData
+                                                                .source,
+                                                        });
                                                         if (writeErr || !data)
                                                             throw writeErr || new Error('Failed to duplicate.');
                                                         const duplicateData = data;
-                                                        setSisters(p => [
+                                                        setSisters((p) => [
                                                             ...p,
                                                             {
                                                                 path: nPath,
@@ -691,7 +891,12 @@ export function Attachments({ dPath, tree }) {
                                                     }
                                                     catch (_err) {
                                                         errorLog('Attachments:Duplicate', 'Duplicate failed', logError(_err));
-                                                        notify({ error: _err instanceof Error ? _err : new Error('Failed to duplicate.'), fallback: 'Failed to duplicate.' });
+                                                        notify({
+                                                            error: _err instanceof Error
+                                                                ? _err
+                                                                : new Error('Failed to duplicate.'),
+                                                            fallback: 'Failed to duplicate.',
+                                                        });
                                                     }
                                                 })();
                                             },
@@ -701,11 +906,16 @@ export function Attachments({ dPath, tree }) {
                             ]
                             : []),
                         { separator: true },
-                        { destructive: true, onSelect: () => void remove([ctxAttachment.item]), icon: _jsx(TrashIcon, {}), label: 'Delete' },
-                    ]).map((a, i) => a.separator ? (_jsx("div", { role: 'separator', className: 'mx-1.5 my-1 h-px bg-primary-6/50' }, `separator-${i}`)) : (_jsx("button", { type: 'button', role: 'menuitem', className: 'relative flex w-full cursor-default select-none items-center rounded-sm px-3 py-1 text-left text-sm hover:bg-primary-4', disabled: a.disabled, onClick: () => {
+                        {
+                            destructive: true,
+                            onSelect: () => void remove([ctxAttachment.item]),
+                            icon: _jsx(TrashIcon, {}),
+                            label: 'Delete',
+                        },
+                    ]).map((a, i) => a.separator ? (_jsx("div", { role: "separator", className: "mx-1.5 my-1 h-px bg-primary-6/50" }, `separator-${i}`)) : (_jsx("button", { type: "button", role: "menuitem", className: "relative flex w-full cursor-default select-none items-center rounded-sm px-3 py-1 text-left text-sm hover:bg-primary-4", disabled: a.disabled, onClick: () => {
                         setCtxAttachment(null);
                         a.onSelect?.();
-                    }, children: a.label }, `${a.label}-${i}`))) })), _jsxs(Dialog, { open: isDialogOpen, onOpenChange: open => {
+                    }, children: a.label }, `${a.label}-${i}`))) })), _jsxs(Dialog, { open: isDialogOpen, onOpenChange: (open) => {
                     if (open)
                         return;
                     if (viewDlg)
@@ -725,11 +935,14 @@ export function Attachments({ dPath, tree }) {
                             setUrlInput('');
                         }, 200);
                     }
-                }, children: [!!mergePdfState && (_jsxs(DialogContent, { className: 'sm:max-w-md', children: [_jsxs(DialogHeader, { children: [_jsx(DialogTitle, { children: "Multiple PDFs Selected" }), _jsxs(DialogDescription, { children: ["Would you like to merge these ", mergePdfState.pdfs.length, " PDFs into a single file, or upload them separately?"] })] }), _jsxs(DialogFooter, { className: 'flex gap-2 sm:justify-between', children: [_jsx(Button, { variant: 'ghost', onClick: () => {
+                }, children: [!!mergePdfState && (_jsxs(DialogContent, { className: "sm:max-w-md", children: [_jsxs(DialogHeader, { children: [_jsx(DialogTitle, { children: "Multiple PDFs Selected" }), _jsxs(DialogDescription, { children: ["Would you like to merge these ", mergePdfState.pdfs.length, " PDFs into a single file, or upload them separately?"] })] }), _jsxs(DialogFooter, { className: "flex gap-2 sm:justify-between", children: [_jsx(Button, { variant: "ghost", onClick: () => {
                                             [...mergePdfState.pdfs, ...mergePdfState.others].forEach((f, i) => {
                                                 const isMdFile = TerraQualityRegex.REGEX_MD_MDX_I_REGEX().test(f.name);
                                                 const tmpId = `temp-${Date.now()}-${i}`;
-                                                setSisters(p => [...p, { id: tmpId, path: tmpId, name: f.name, isMd: isMdFile, type: 'document' }]);
+                                                setSisters((p) => [
+                                                    ...p,
+                                                    { id: tmpId, path: tmpId, name: f.name, isMd: isMdFile, type: 'document' },
+                                                ]);
                                                 void processUpload(f, tmpId, isMdFile);
                                             });
                                             setMergePdfState(null);
@@ -741,12 +954,18 @@ export function Attachments({ dPath, tree }) {
                                                 const mergedPdf = await PDFDocument.create();
                                                 for (let i = 0; i < mergePdfState.pdfs.length; i++) {
                                                     const pdfDoc = await PDFDocument.load(await mergePdfState.pdfs[i].arrayBuffer());
-                                                    (await mergedPdf.copyPages(pdfDoc, pdfDoc.getPageIndices())).forEach(p => mergedPdf.addPage(p));
+                                                    (await mergedPdf.copyPages(pdfDoc, pdfDoc.getPageIndices())).forEach((p) => mergedPdf.addPage(p));
                                                 }
-                                                [new File([(await mergedPdf.save()).buffer], 'Merged-Document.pdf', { type: 'application/pdf' }), ...mergePdfState.others].forEach((f, i) => {
+                                                [
+                                                    new File([(await mergedPdf.save()).buffer], 'Merged-Document.pdf', { type: 'application/pdf' }),
+                                                    ...mergePdfState.others,
+                                                ].forEach((f, i) => {
                                                     const isMdFile = TerraQualityRegex.REGEX_MD_MDX_I_REGEX().test(f.name);
                                                     const tmpId = `temp-${Date.now()}-${i}`;
-                                                    setSisters(p => [...p, { id: tmpId, path: tmpId, name: f.name, isMd: isMdFile, type: 'document' }]);
+                                                    setSisters((p) => [
+                                                        ...p,
+                                                        { id: tmpId, path: tmpId, name: f.name, isMd: isMdFile, type: 'document' },
+                                                    ]);
                                                     void processUpload(f, tmpId, isMdFile);
                                                 });
                                             }
@@ -757,7 +976,9 @@ export function Attachments({ dPath, tree }) {
                                             finally {
                                                 setUploading(false);
                                             }
-                                        }, children: "Merge to Single PDF" })] })] })), !!viewDlg && (_jsxs(DialogContent, { className: 'flex max-h-[85vh] flex-col sm:max-w-4xl', children: [_jsxs(DialogHeader, { children: [_jsx(DialogTitle, { children: viewDlg.title || viewDlg.name }), _jsx(DialogDescription, { className: 'truncate', children: viewDlg.sourceUrl || viewDlg.path })] }), _jsx("div", { className: 'min-h-0 flex-1 overflow-y-auto py-4', children: viewDlg.isMd ? (_jsx(CodeBlock, { docsSource: true, code: typeof viewDlg.content === 'string' ? viewDlg.content : latestContent(viewDlg.content) || '', language: 'mdx', tone: 'view', className: 'my-0 text-xs' })) : textAsset(viewDlg) ? (_jsx(CodeBlock, { code: typeof viewDlg.content === 'string' ? viewDlg.content : '', language: 'text', tone: 'view', className: 'my-0 text-xs' })) : (_jsxs("div", { className: 'flex flex-col items-center justify-center gap-4 py-12 text-primary-11', children: [_jsx(DocumentIcon, { className: 'size-16 opacity-50', "aria-hidden": 'true' }), _jsx("p", { children: "Binary storage entry." }), viewDlg.unavailable ? (_jsx("p", { children: "Source asset is unavailable." })) : (_jsxs(Button, { onClick: () => {
+                                        }, children: "Merge to Single PDF" })] })] })), !!viewDlg && (_jsxs(DialogContent, { className: "flex max-h-[85vh] flex-col sm:max-w-4xl", children: [_jsxs(DialogHeader, { children: [_jsx(DialogTitle, { children: viewDlg.title || viewDlg.name }), _jsx(DialogDescription, { className: "truncate", children: viewDlg.sourceUrl || viewDlg.path })] }), _jsx("div", { className: "min-h-0 flex-1 overflow-y-auto py-4", children: viewDlg.isMd ? (_jsx(CodeBlock, { docsSource: true, code: typeof viewDlg.content === 'string'
+                                        ? viewDlg.content
+                                        : latestContent(viewDlg.content) || '', language: "mdx", tone: "view", className: "my-0 text-xs" })) : textAsset(viewDlg) ? (_jsx(CodeBlock, { code: typeof viewDlg.content === 'string' ? viewDlg.content : '', language: "text", tone: "view", className: "my-0 text-xs" })) : (_jsxs("div", { className: "flex flex-col items-center justify-center gap-4 py-12 text-primary-11", children: [_jsx(DocumentIcon, { className: "size-16 opacity-50", "aria-hidden": "true" }), _jsx("p", { children: "Binary storage entry." }), viewDlg.unavailable ? (_jsx("p", { children: "Source asset is unavailable." })) : (_jsxs(Button, { onClick: () => {
                                                 void (async () => {
                                                     if (!viewDlg)
                                                         return;
@@ -768,7 +989,13 @@ export function Attachments({ dPath, tree }) {
                                                             const { data, error } = await actions.read.tsdocs({ scope });
                                                             if (!error && data?.docs) {
                                                                 const url = URL.createObjectURL(new Blob([
-                                                                    JSON.stringify((Array.isArray(data.docs) ? data.docs : []).filter(isRec).map(d => ({ title: d.title, slug: d.slug, source: d.body })), null, 2),
+                                                                    JSON.stringify((Array.isArray(data.docs) ? data.docs : [])
+                                                                        .filter(isRec)
+                                                                        .map((d) => ({
+                                                                        title: d.title,
+                                                                        slug: d.slug,
+                                                                        source: d.body,
+                                                                    })), null, 2),
                                                                 ], { type: 'application/json' }));
                                                                 const a = document.createElement('a');
                                                                 a.href = url;
@@ -787,15 +1014,25 @@ export function Attachments({ dPath, tree }) {
                                                             return;
                                                         }
                                                         let dlName = viewDlg.title || viewDlg.name;
-                                                        const extMatch = viewDlg.path.split('?')[0]?.match(TerraQualityRegex.REGEX_A_Z0_9_I_REGEX());
-                                                        if (extMatch && !dlName.toLowerCase().endsWith(extMatch[0].toLowerCase()))
+                                                        const extMatch = viewDlg.path
+                                                            .split('?')[0]
+                                                            ?.match(TerraQualityRegex.REGEX_A_Z0_9_I_REGEX());
+                                                        if (extMatch &&
+                                                            !dlName.toLowerCase().endsWith(extMatch[0].toLowerCase()))
                                                             dlName = `${dlName}${extMatch[0]}`;
-                                                        else if (viewDlg.type === 'document' && !dlName.toLowerCase().endsWith('.pdf'))
+                                                        else if (viewDlg.type === 'document' &&
+                                                            !dlName.toLowerCase().endsWith('.pdf'))
                                                             dlName = `${dlName}.pdf`;
-                                                        const { data, error } = await actions.read.asset.get({ path: viewDlg.path });
+                                                        const { data, error } = await actions.read.asset.get({
+                                                            path: viewDlg.path,
+                                                        });
                                                         if (error || !data)
                                                             throw error;
-                                                        const url = URL.createObjectURL(new Blob([data], { type: viewDlg.type === 'document' ? 'application/pdf' : 'application/octet-stream' }));
+                                                        const url = URL.createObjectURL(new Blob([data], {
+                                                            type: viewDlg.type === 'document'
+                                                                ? 'application/pdf'
+                                                                : 'application/octet-stream',
+                                                        }));
                                                         const a = document.createElement('a');
                                                         a.href = url;
                                                         a.download = dlName;
@@ -808,11 +1045,11 @@ export function Attachments({ dPath, tree }) {
                                                         toast.error('Failed to download asset.');
                                                     }
                                                 })();
-                                            }, children: [_jsx(DownloadIcon, { className: 'mr-2 size-4' }), " Download Asset"] }))] })) }), _jsx(DialogFooter, { children: _jsx(Button, { variant: 'ghost', onClick: () => {
+                                            }, children: [_jsx(DownloadIcon, { className: "mr-2 size-4" }), " Download Asset"] }))] })) }), _jsx(DialogFooter, { children: _jsx(Button, { variant: "ghost", onClick: () => {
                                         setViewDlg(null);
-                                    }, children: "Close" }) })] })), renameDlg?.open && (_jsxs(DialogContent, { className: 'sm:max-w-md', children: [_jsxs(DialogHeader, { children: [_jsx(DialogTitle, { children: "Rename Attachment" }), _jsx(DialogDescription, { children: "Assign folder-compliant file identity token string parameters." })] }), _jsx("div", { className: 'py-4', children: _jsx(Input, { autoFocus: true, value: renameInput, onChange: e => {
+                                    }, children: "Close" }) })] })), renameDlg?.open && (_jsxs(DialogContent, { className: "sm:max-w-md", children: [_jsxs(DialogHeader, { children: [_jsx(DialogTitle, { children: "Rename Attachment" }), _jsx(DialogDescription, { children: "Assign folder-compliant file identity token string parameters." })] }), _jsx("div", { className: "py-4", children: _jsx(Input, { autoFocus: true, value: renameInput, onChange: (e) => {
                                         setRenameInput(e.target.value);
-                                    }, onKeyDown: e => e.key === 'Enter' && void renameAttch(renameInput) }) }), _jsxs(DialogFooter, { children: [_jsx(Button, { variant: 'ghost', onClick: () => { setRenameDlg(null); }, children: "Cancel" }), _jsx(Button, { disabled: !renameInput.trim(), onClick: () => void renameAttch(renameInput), children: "Rename" })] })] })), transferDlg?.open &&
+                                    }, onKeyDown: (e) => e.key === 'Enter' && void renameAttch(renameInput) }) }), _jsxs(DialogFooter, { children: [_jsx(Button, { variant: 'ghost', onClick: () => { setRenameDlg(null); }, children: "Cancel" }), _jsx(Button, { disabled: !renameInput.trim(), onClick: () => void renameAttch(renameInput), children: "Rename" })] })] })), transferDlg?.open &&
                         // prettier-ignore
                         _jsxs(DialogContent, { className: 'sm:max-w-md', children: [_jsxs(DialogHeader, { children: [_jsxs(DialogTitle, { children: [transferDlg.action === 'copy' ? 'Copy' : 'Move', " Asset", transferDlg.items.length > 1 ? 's' : ''] }), _jsx(DialogDescription, { children: "Shift structural components between system documents." })] }), _jsx("div", { className: 'py-4', children: _jsxs(Select, { value: transferTgt, onValueChange: setTransferTgt, children: [_jsx(SelectTrigger, { "aria-label": 'Select destination page', children: _jsx(SelectValue, { placeholder: 'Select destination page' }) }), _jsxs(SelectContent, { className: 'max-h-60', children: [_jsx(SelectItem, { value: '__new__', className: 'font-semibold text-primary-11', children: "\u2728 Move to new page..." }), localLeaves.length ? (localLeaves.map(l => (_jsx(SelectItem, { value: l.path, children: l.title || l.origName }, l.path)))) : (_jsx(SelectItem, { value: 'none', disabled: true, children: "No target layers found" }))] })] }) }), _jsxs(DialogFooter, { children: [_jsx(Button, { variant: 'ghost', onClick: () => { setTransferDlg(null); }, children: "Cancel" }), _jsx(Button, { disabled: !transferTgt || transferTgt === 'none' || transferring, loading: transferring, onClick: () => {
                                                 void (async () => {
@@ -873,30 +1110,37 @@ export function Attachments({ dPath, tree }) {
                                                         setTransferDlg(null);
                                                     }
                                                 })();
-                                            }, children: transferDlg.action === 'copy' ? 'Copy' : 'Move' })] })] }), addDialogOpen && (_jsxs(DialogContent, { className: 'flex max-h-[85vh] flex-col overflow-hidden sm:max-w-xl', children: [_jsx(DialogHeader, { children: dialogMode === 'select' ? (_jsxs(_Fragment, { children: [_jsx(DialogTitle, { children: "Add Attachment" }), _jsx(DialogDescription, { children: "Select attachment category." })] })) : (_jsxs(_Fragment, { children: [_jsxs(DialogTitle, { className: 'capitalize', children: ["Add ", dialogMode] }), _jsx(DialogDescription, { children: dialogMode === 'tsdocs' ? 'Select an API reference page or folder to link.' : ['youtube', 'website'].includes(dialogMode) ? `Provide URLs to attach ${dialogMode} content.` : `Upload files or provide URLs to attach remote ${dialogMode}s.` })] })) }), _jsx("div", { className: 'flex-1 overflow-y-auto py-4', children: dialogMode === 'select' ? (_jsx("div", { className: 'grid grid-cols-2 gap-4 sm:grid-cols-3', children: [
+                                            }, children: transferDlg.action === 'copy' ? 'Copy' : 'Move' })] })] }), addDialogOpen && (_jsxs(DialogContent, { className: "flex max-h-[85vh] flex-col overflow-hidden sm:max-w-xl", children: [_jsx(DialogHeader, { children: dialogMode === 'select' ? (_jsxs(_Fragment, { children: [_jsx(DialogTitle, { children: "Add Attachment" }), _jsx(DialogDescription, { children: "Select attachment category." })] })) : (_jsxs(_Fragment, { children: [_jsxs(DialogTitle, { className: 'capitalize', children: ["Add ", dialogMode] }), _jsx(DialogDescription, { children: dialogMode === 'tsdocs' ? 'Select an API reference page or folder to link.' : ['youtube', 'website'].includes(dialogMode) ? `Provide URLs to attach ${dialogMode} content.` : `Upload files or provide URLs to attach remote ${dialogMode}s.` })] })) }), _jsx("div", { className: "flex-1 overflow-y-auto py-4", children: dialogMode === 'select' ? (_jsx("div", { className: "grid grid-cols-2 gap-4 sm:grid-cols-3", children: [
                                         { Icon: DocumentIcon, text: 'Document', type: 'document' },
                                         { Icon: ImageIcon, text: 'Image', type: 'image' },
                                         { Icon: YouTubeIcon, text: 'YouTube', type: 'youtube' },
                                         { Icon: LinkIcon, text: 'Website', type: 'website' },
                                         { Icon: CatalogIcon, text: 'TsDocs', type: 'tsdocs' },
                                         { Icon: BoxIcon, text: 'Other', type: 'other' },
-                                    ].map(({ Icon: i, text: t, type: v }) => (_jsxs("button", { type: 'button', "aria-label": `Add ${t} attachment`, className: 'flex cursor-pointer flex-col items-center justify-center rounded-xl border border-primary-6 bg-transparent p-6 text-center transition-colors hover:border-primary-8 hover:bg-primary-3/50 focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-primary-8', onClick: () => {
+                                    ].map(({ Icon: i, text: t, type: v }) => (_jsxs("button", { type: "button", "aria-label": `Add ${t} attachment`, className: "flex cursor-pointer flex-col items-center justify-center rounded-xl border border-primary-6 bg-transparent p-6 text-center transition-colors hover:border-primary-8 hover:bg-primary-3/50 focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-primary-8", onClick: () => {
                                             setDialogMode(v);
-                                        }, children: [createElement(i, { className: 'size-6 text-primary-11', 'aria-hidden': 'true' }), _jsx("span", { className: 'mt-2 text-sm font-medium text-primary-11', children: t })] }, t))) })) : (_jsxs("div", { className: 'flex flex-col gap-4', children: [!['youtube', 'website', 'tsdocs'].includes(dialogMode) && (_jsxs(Button, { variant: 'outline', onClick: () => {
+                                        }, children: [createElement(i, {
+                                                className: 'size-6 text-primary-11',
+                                                'aria-hidden': 'true',
+                                            }), _jsx("span", { className: "mt-2 text-sm font-medium text-primary-11", children: t })] }, t))) })) : (_jsxs("div", { className: "flex flex-col gap-4", children: [!['youtube', 'website', 'tsdocs'].includes(dialogMode) && (_jsxs(Button, { variant: "outline", onClick: () => {
                                                 setAddDialogOpen(false);
                                                 fileRef.current?.click();
-                                            }, children: [_jsx(UploadIcon, { className: 'mr-2 size-5' }), "Select Files to Upload"] })), _jsxs("div", { className: 'space-y-2', children: [_jsx(Label, { children: dialogMode === 'tsdocs' ? 'Select Reference' : !['youtube', 'website'].includes(dialogMode) ? 'Or Import via URL' : 'Import via URL' }), dialogMode === 'tsdocs' ? (_jsx(TsDocsSelect, { variant: 'inline', multiple: true, value: urlInput ? urlInput.split('\n').filter(Boolean) : [], onChange: (v) => {
+                                            }, children: [_jsx(UploadIcon, { className: "mr-2 size-5" }), "Select Files to Upload"] })), _jsxs("div", { className: "space-y-2", children: [_jsx(Label, { children: dialogMode === 'tsdocs'
+                                                        ? 'Select Reference'
+                                                        : !['youtube', 'website'].includes(dialogMode)
+                                                            ? 'Or Import via URL'
+                                                            : 'Import via URL' }), dialogMode === 'tsdocs' ? (_jsx(TsDocsSelect, { variant: "inline", multiple: true, value: urlInput ? urlInput.split('\n').filter(Boolean) : [], onChange: (v) => {
                                                         setUrlInput(Array.isArray(v) ? v.join('\n') : v);
-                                                    } })) : (_jsx(Textarea, { autoFocus: true, placeholder: 'https://...\nPaste multiple URLs on new lines', value: urlInput, onChange: e => {
+                                                    } })) : (_jsx(Textarea, { autoFocus: true, placeholder: 'https://...\nPaste multiple URLs on new lines', value: urlInput, onChange: (e) => {
                                                         setUrlInput(e.target.value);
-                                                    }, rows: 4, onKeyDown: e => {
+                                                    }, rows: 4, onKeyDown: (e) => {
                                                         if (e.key === 'Enter' && !e.shiftKey) {
                                                             e.preventDefault();
                                                             void addRemote(urlInput, dialogMode);
                                                         }
-                                                    } }))] })] })) }), _jsx(DialogFooter, { className: 'shrink-0 border-t border-primary-6 pt-4', children: dialogMode === 'select' ? (_jsx(Button, { variant: 'ghost', onClick: () => {
+                                                    } }))] })] })) }), _jsx(DialogFooter, { className: "shrink-0 border-t border-primary-6 pt-4", children: dialogMode === 'select' ? (_jsx(Button, { variant: "ghost", onClick: () => {
                                         setAddDialogOpen(false);
-                                    }, children: "Cancel" })) : (_jsxs(_Fragment, { children: [_jsx(Button, { variant: 'ghost', onClick: () => {
+                                    }, children: "Cancel" })) : (_jsxs(_Fragment, { children: [_jsx(Button, { variant: "ghost", onClick: () => {
                                                 setDialogMode('select');
                                             }, children: "Back" }), _jsx(Button, { disabled: !urlInput.trim() || uploading, loading: uploading, onClick: () => void addRemote(urlInput, dialogMode), children: dialogMode === 'tsdocs' ? 'Attach Reference' : 'Attach URL' })] })) })] }))] })] }));
 }