@flamingo-stack/openframe-frontend-core 0.0.848 → 0.0.849

package/dist/{chunk-7DW3LZ52.cjs → chunk-PV2XQJ2R.cjs}

@@ -3,24 +3,23 @@
 
 
 
-var _chunkI3YRYS23cjs = require('./chunk-I3YRYS23.cjs');
+var _chunkC3P7IUTUcjs = require('./chunk-C3P7IUTU.cjs');
 
 
 
 
 
-var _chunkO4BXHCMKcjs = require('./chunk-O4BXHCMK.cjs');
+var _chunkFRG724DUcjs = require('./chunk-FRG724DU.cjs');
 
 
 
-var _chunk5HOWR4TGcjs = require('./chunk-5HOWR4TG.cjs');
+var _chunk5CBI2ZYVcjs = require('./chunk-5CBI2ZYV.cjs');
 
 
 
 
 
-
-var _chunk2V6FCVULcjs = require('./chunk-2V6FCVUL.cjs');
+var _chunkYLETC7LPcjs = require('./chunk-YLETC7LP.cjs');
 
 
 var _chunkIKOL6NJYcjs = require('./chunk-IKOL6NJY.cjs');
@@ -29,13 +28,9 @@ var _chunkIKOL6NJYcjs = require('./chunk-IKOL6NJY.cjs');
 
 
 
-var _chunkQUSCSYHJcjs = require('./chunk-QUSCSYHJ.cjs');
-
-
 
 
-
-var _chunkYAW7CHLVcjs = require('./chunk-YAW7CHLV.cjs');
+var _chunkTX4NTH22cjs = require('./chunk-TX4NTH22.cjs');
 
 
 
@@ -53,12 +48,6 @@ var _chunkFX35L4Y6cjs = require('./chunk-FX35L4Y6.cjs');
 var _chunkUJ7AXHRZcjs = require('./chunk-UJ7AXHRZ.cjs');
 
 
-var _chunk2XCORRJVcjs = require('./chunk-2XCORRJV.cjs');
-
-
-
-var _chunkPMUCEUFQcjs = require('./chunk-PMUCEUFQ.cjs');
-
 
 
 var _chunk63A4GZMBcjs = require('./chunk-63A4GZMB.cjs');
@@ -221,7 +210,7 @@ function toResolveLinkResult(body) {
 }
 function useDocsResolveLink(sourceId, resolveLinkEndpoint) {
   const chatRuntime = _chunkUJ7AXHRZcjs.useChatRuntime.call(void 0, );
-  const resolvedResolveLinkEndpoint = _nullishCoalesce(_nullishCoalesce(resolveLinkEndpoint, () => ( _optionalChain([chatRuntime, 'optionalAccess', _2 => _2.endpoints, 'access', _3 => _3.docsResolveLinkUrl]))), () => ( "/api/docs/resolve-link"));
+  const resolvedResolveLinkEndpoint = _nullishCoalesce(_nullishCoalesce(resolveLinkEndpoint, () => ( _optionalChain([chatRuntime, 'optionalAccess', _ => _.endpoints, 'access', _2 => _2.docsResolveLinkUrl]))), () => ( "/api/docs/resolve-link"));
   return _react.useCallback.call(void 0, 
     async (href, currentPath) => {
       try {
@@ -256,21 +245,6 @@ function scrollToContent() {
     _chunkGRCOEICKcjs.scrollElementIntoView.call(void 0, document.documentElement);
   }
 }
-function findFirstDocPath(folder) {
-  const children = _nullishCoalesce(folder.children, () => ( []));
-  for (const child of children) {
-    if (child.type === "file" && !child.path.toLowerCase().endsWith(".mmd")) {
-      return child.path;
-    }
-  }
-  for (const child of children) {
-    if (child.type === "folder") {
-      const nested = findFirstDocPath(child);
-      if (nested) return nested;
-    }
-  }
-  return null;
-}
 function isRecord(value) {
   return typeof value === "object" && value !== null;
 }
@@ -354,14 +328,18 @@ function toDocContent(value, requestedPath) {
 function toDataSync(value) {
   if (!isRecord(value)) return void 0;
   const source = readString(value, "source");
-  if (!_chunk2V6FCVULcjs.isDataSyncSource.call(void 0, source)) return void 0;
+  if (!_chunkYLETC7LPcjs.isDataSyncSource.call(void 0, source)) return void 0;
   return { source, syncedAt: _nullishCoalesce(readString(value, "syncedAt"), () => ( null)) };
 }
 function useDocumentTree(config, initialPath) {
   const { structureEndpoint, contentEndpoint, baseRoute } = config;
-  const folderIndexFile = _nullishCoalesce(config.folderIndexFile, () => ( _chunkQUSCSYHJcjs.DEFAULT_FOLDER_INDEX_FILE));
-  const cleanInitialPath = _chunkQUSCSYHJcjs.stripFolderIndexFromPath.call(void 0, _optionalChain([initialPath, 'optionalAccess', _4 => _4.replace, 'call', _5 => _5(/\/$/, "")]) || "", folderIndexFile);
+  const folderIndexFile = _nullishCoalesce(config.folderIndexFile, () => ( _chunkTX4NTH22cjs.DEFAULT_FOLDER_INDEX_FILE));
+  const cleanInitialPath = _chunkTX4NTH22cjs.stripFolderIndexFromPath.call(void 0, _optionalChain([initialPath, 'optionalAccess', _3 => _3.replace, 'call', _4 => _4(/\/$/, "")]) || "", folderIndexFile);
   const [structure, setStructure] = _react.useState.call(void 0, []);
+  const structureRef = _react.useRef.call(void 0, structure);
+  _react.useEffect.call(void 0, () => {
+    structureRef.current = structure;
+  }, [structure]);
   const [selectedPath, setSelectedPath] = _react.useState.call(void 0, cleanInitialPath);
   const [content, setContent] = _react.useState.call(void 0, null);
   const [isLoadingStructure, setIsLoadingStructure] = _react.useState.call(void 0, true);
@@ -386,12 +364,12 @@ function useDocumentTree(config, initialPath) {
       } else if (pathname.startsWith(`${normalizedBaseRoute}/`)) {
         pathFromUrl = pathname.substring(`${normalizedBaseRoute}/`.length);
       }
-      pathFromUrl = _chunkQUSCSYHJcjs.stripFolderIndexFromPath.call(void 0, pathFromUrl, folderIndexFile);
+      pathFromUrl = _chunkTX4NTH22cjs.stripFolderIndexFromPath.call(void 0, pathFromUrl, folderIndexFile);
       if (pathFromUrl !== selectedPathRef.current) {
         setSelectedPath(pathFromUrl);
         if (pathFromUrl) {
           const parentPath = pathFromUrl.includes("/") ? pathFromUrl.substring(0, pathFromUrl.lastIndexOf("/")) : pathFromUrl;
-          setExpandedNodes(new Set(_chunkQUSCSYHJcjs.getDocAncestorNodeIds.call(void 0, parentPath)));
+          setExpandedNodes(new Set(_chunkTX4NTH22cjs.getDocAncestorNodeIds.call(void 0, parentPath)));
         }
         setTimeout(() => {
           scrollToContent();
@@ -409,7 +387,7 @@ function useDocumentTree(config, initialPath) {
       setSelectedPath(cleanInitialPath);
       if (cleanInitialPath) {
         const parentPath = cleanInitialPath.includes("/") ? cleanInitialPath.substring(0, cleanInitialPath.lastIndexOf("/")) : cleanInitialPath;
-        setExpandedNodes(new Set(_chunkQUSCSYHJcjs.getDocAncestorNodeIds.call(void 0, parentPath)));
+        setExpandedNodes(new Set(_chunkTX4NTH22cjs.getDocAncestorNodeIds.call(void 0, parentPath)));
       }
       setExternalNavCount((n) => n + 1);
     }
@@ -434,7 +412,7 @@ function useDocumentTree(config, initialPath) {
         if (cleanInitialPath) {
           const pathForExpansion = cleanInitialPath.includes(".") ? cleanInitialPath.substring(0, cleanInitialPath.lastIndexOf("/")) : cleanInitialPath;
           if (pathForExpansion) {
-            setExpandedNodes(new Set(_chunkQUSCSYHJcjs.getDocAncestorNodeIds.call(void 0, pathForExpansion)));
+            setExpandedNodes(new Set(_chunkTX4NTH22cjs.getDocAncestorNodeIds.call(void 0, pathForExpansion)));
           }
         } else if (nodes.length > 0) {
           const hasRootReadme = nodes.some((node) => node.type === "file" && node.path === folderIndexFile);
@@ -474,9 +452,10 @@ function useDocumentTree(config, initialPath) {
             setContent(null);
             return;
           }
-          const probe = _chunkQUSCSYHJcjs.findDocNodeByPath.call(void 0, _chunkQUSCSYHJcjs.stripFolderIndexFromPath.call(void 0, path, folderIndexFile), structure);
+          const latestStructure = structureRef.current;
+          const probe = _chunkTX4NTH22cjs.findDocNodeByPath.call(void 0, _chunkTX4NTH22cjs.stripFolderIndexFromPath.call(void 0, path, folderIndexFile), latestStructure);
           const probeIsNoReadmeFolder = !!probe && probe.type === "folder" && !probe.hasReadme;
-          const preStructureFolderLike = structure.length === 0 && !path.endsWith(".md");
+          const preStructureFolderLike = latestStructure.length === 0 && !path.endsWith(".md");
           if (probeIsNoReadmeFolder || preStructureFolderLike) {
             lastFetchedPath.current = null;
             setError(null);
@@ -531,11 +510,16 @@ function useDocumentTree(config, initialPath) {
     if (!structure || structure.length === 0) return;
     let pathToFetch = null;
     if (selectedPath === "") {
-      pathToFetch = folderIndexFile;
+      const rootPath = _chunkTX4NTH22cjs.rootDocumentPath.call(void 0, structure, folderIndexFile);
+      if (!rootPath) {
+        lastFetchedPath.current = null;
+        return;
+      }
+      pathToFetch = rootPath;
     } else {
-      const node = _chunkQUSCSYHJcjs.findDocNodeByPath.call(void 0, selectedPath, structure);
+      const node = _chunkTX4NTH22cjs.findDocNodeByPath.call(void 0, selectedPath, structure);
       if (node && node.type === "folder" && !node.hasReadme) {
-        const firstDocPath = findFirstDocPath(node);
+        const firstDocPath = _chunkTX4NTH22cjs.findFirstDocPath.call(void 0, node);
         if (!firstDocPath) {
           lastFetchedPath.current = null;
           return;
@@ -574,16 +558,16 @@ function useDocumentTree(config, initialPath) {
       if (node.type === "folder") {
         setExpandedNodes((prev) => {
           if (prev.has(node.id)) {
-            const ancestorIds = _chunkQUSCSYHJcjs.getDocAncestorNodeIds.call(void 0, node.path);
+            const ancestorIds = _chunkTX4NTH22cjs.getDocAncestorNodeIds.call(void 0, node.path);
             ancestorIds.pop();
             return new Set(ancestorIds);
           }
-          return new Set(_chunkQUSCSYHJcjs.getDocAncestorNodeIds.call(void 0, node.path));
+          return new Set(_chunkTX4NTH22cjs.getDocAncestorNodeIds.call(void 0, node.path));
         });
       } else {
         const lastSlash = node.path.lastIndexOf("/");
         if (lastSlash > 0) {
-          setExpandedNodes(new Set(_chunkQUSCSYHJcjs.getDocAncestorNodeIds.call(void 0, node.path.substring(0, lastSlash))));
+          setExpandedNodes(new Set(_chunkTX4NTH22cjs.getDocAncestorNodeIds.call(void 0, node.path.substring(0, lastSlash))));
         }
       }
       lastFetchedPath.current = null;
@@ -598,8 +582,8 @@ function useDocumentTree(config, initialPath) {
       const hashIndex = path.indexOf("#");
       const anchor = hashIndex !== -1 ? path.substring(hashIndex) : "";
       const cleanPath = path.replace(/\/$/, "").split("#")[0];
-      const pathForSelection = anchor && _optionalChain([options, 'optionalAccess', _6 => _6.fromInternalLink]) && cleanPath === "" ? selectedPathRef.current : _chunkQUSCSYHJcjs.stripFolderIndexFromPath.call(void 0, cleanPath, folderIndexFile);
-      if (anchor && _optionalChain([options, 'optionalAccess', _7 => _7.fromInternalLink]) && pathForSelection === selectedPathRef.current) {
+      const pathForSelection = anchor && _optionalChain([options, 'optionalAccess', _5 => _5.fromInternalLink]) && cleanPath === "" ? selectedPathRef.current : _chunkTX4NTH22cjs.stripFolderIndexFromPath.call(void 0, cleanPath, folderIndexFile);
+      if (anchor && _optionalChain([options, 'optionalAccess', _6 => _6.fromInternalLink]) && pathForSelection === selectedPathRef.current) {
         _chunkGRCOEICKcjs.navigateSamePageHash.call(void 0, anchor, { headerOffset: _chunkGRCOEICKcjs.HUB_HEADER_OFFSET_PX });
         return;
       }
@@ -619,7 +603,7 @@ function useDocumentTree(config, initialPath) {
           }, 150);
         }
       };
-      if (_optionalChain([options, 'optionalAccess', _8 => _8.expandFolder])) {
+      if (_optionalChain([options, 'optionalAccess', _7 => _7.expandFolder])) {
         lastFetchedPath.current = null;
         setSelectedPath(cleanPath);
         window.history.pushState({}, "", `${normalizedBaseRoute}/${cleanPath}${anchor}`);
@@ -631,7 +615,7 @@ function useDocumentTree(config, initialPath) {
           nodeIdsToExpand.push(currentPath2.toLowerCase());
         }
         setExpandedNodes(new Set(nodeIdsToExpand));
-        if (_optionalChain([options, 'optionalAccess', _9 => _9.fromInternalLink])) {
+        if (_optionalChain([options, 'optionalAccess', _8 => _8.fromInternalLink])) {
           scrollAfterNav();
         }
         setError(null);
@@ -641,7 +625,7 @@ function useDocumentTree(config, initialPath) {
       lastFetchedPath.current = null;
       setSelectedPath(pathForSelection);
       window.history.pushState({}, "", `${normalizedBaseRoute}/${urlPath}${anchor}`);
-      if (_optionalChain([options, 'optionalAccess', _10 => _10.fromInternalLink])) {
+      if (_optionalChain([options, 'optionalAccess', _9 => _9.fromInternalLink])) {
         scrollAfterNav();
       }
       const pathParts = cleanPath.split("/");
@@ -662,25 +646,28 @@ function useDocumentTree(config, initialPath) {
     return docNavigation.register({
       baseRoute: normalizedBaseRoute,
       findNodeByPath: (path) => {
-        const clean = _chunkQUSCSYHJcjs.stripFolderIndexFromPath.call(void 0, path.replace(/\/$/, "").split("#")[0], folderIndexFile);
-        return _nullishCoalesce(_chunkQUSCSYHJcjs.findDocNodeByPath.call(void 0, clean, structure), () => ( null));
+        const clean = _chunkTX4NTH22cjs.stripFolderIndexFromPath.call(void 0, path.replace(/\/$/, "").split("#")[0], folderIndexFile);
+        return _nullishCoalesce(_chunkTX4NTH22cjs.findDocNodeByPath.call(void 0, clean, structure), () => ( null));
       },
       selectNode
     });
   }, [docNavigation, normalizedBaseRoute, structure, selectNode, folderIndexFile]);
   const isEmptyFolder = _react.useMemo.call(void 0, () => {
-    if (!selectedPath || structure.length === 0) return false;
-    const node = _chunkQUSCSYHJcjs.findDocNodeByPath.call(void 0, selectedPath, structure);
-    return !!node && node.type === "folder" && !node.hasReadme && !findFirstDocPath(node);
-  }, [selectedPath, structure]);
+    if (structure.length === 0) return false;
+    if (!selectedPath) return !_chunkTX4NTH22cjs.rootDocumentPath.call(void 0, structure, folderIndexFile);
+    const node = _chunkTX4NTH22cjs.findDocNodeByPath.call(void 0, selectedPath, structure);
+    return !!node && node.type === "folder" && !node.hasReadme && !_chunkTX4NTH22cjs.findFirstDocPath.call(void 0, node);
+  }, [selectedPath, structure, folderIndexFile]);
+  const isEmptySource = !isLoadingStructure && structure.length === 0;
+  const settled = isEmptyFolder || isEmptySource;
   return {
     structure,
     selectedPath,
     setSelectedPath,
-    content: isEmptyFolder ? null : content,
+    content: settled ? null : content,
     isLoadingStructure,
-    isLoadingContent: isEmptyFolder ? false : isLoadingContent,
-    error: isEmptyFolder ? null : error,
+    isLoadingContent: settled ? false : isLoadingContent,
+    error: settled ? null : error,
     expandedNodes,
     toggleNode,
     selectNode,
@@ -706,11 +693,12 @@ function DocViewer(props) {
   return /* @__PURE__ */ _jsxruntime.jsx.call(void 0, DocViewerContent, { ...props });
 }
 var ON_THIS_PAGE_LABEL = "ON THIS PAGE";
+var NO_SECTION_CLICK = () => {
+};
 var ON_THIS_PAGE_HEADING_CLASS = "mb-4 font-semibold text-ods-text-secondary text-h5";
 function DocViewerContent({
   sourceId,
   renderContent,
-  renderSkeleton,
   chatSource,
   title,
   subtitle,
@@ -718,6 +706,7 @@ function DocViewerContent({
   className = "",
   shell = true,
   docPath,
+  initialDocumentType,
   sidebarLabel = "DOCUMENTATION",
   structureEndpoint,
   contentEndpoint,
@@ -753,14 +742,14 @@ function DocViewerContent({
     },
     docPath
   );
-  const { activeSection, handleSectionClick } = _chunkO4BXHCMKcjs.useScrollSpy.call(void 0, _optionalChain([content, 'optionalAccess', _11 => _11.sections]));
+  const { activeSection, handleSectionClick } = _chunkFRG724DUcjs.useScrollSpy.call(void 0, _optionalChain([content, 'optionalAccess', _10 => _10.sections]));
   const docNav = useDocNavigation();
   const router = _chunk7DNL734Scjs.useRouter.call(void 0, );
   const backCfg = backButton === false ? null : {
-    label: _nullishCoalesce(_optionalChain([backButton, 'optionalAccess', _12 => _12.label]), () => ( "Back to home")),
-    onClick: () => router.push(_nullishCoalesce(_optionalChain([backButton, 'optionalAccess', _13 => _13.href]), () => ( "/")))
+    label: _nullishCoalesce(_optionalChain([backButton, 'optionalAccess', _11 => _11.label]), () => ( "Back to home")),
+    onClick: () => router.push(_nullishCoalesce(_optionalChain([backButton, 'optionalAccess', _12 => _12.href]), () => ( "/")))
   };
-  const docSearch = _chunk5HOWR4TGcjs.useDocSearch.call(void 0, {
+  const docSearch = _chunk5CBI2ZYVcjs.useDocSearch.call(void 0, {
     source: chatSource,
     baseRoute,
     searchEndpoint,
@@ -784,23 +773,28 @@ function DocViewerContent({
       onResolveLink: resolveLink
     });
   }, [content, renderContent, navigateToDoc, sourceId, resolveLink]);
-  const selectedNodeDocType = selectedPath && structure.length > 0 ? _optionalChain([_chunkQUSCSYHJcjs.findDocNodeByPath.call(void 0, selectedPath, structure), 'optionalAccess', _14 => _14.documentType]) : void 0;
-  const activeDocType = _nullishCoalesce(_optionalChain([content, 'optionalAccess', _15 => _15.documentType]), () => ( selectedNodeDocType));
+  const selectedNodePath = structure.length > 0 && !selectedPath ? _chunkTX4NTH22cjs.rootDocumentPath.call(void 0, structure, folderIndexFile) : selectedPath;
+  const selectedNodeDocType = structure.length > 0 ? selectedNodePath ? _optionalChain([_chunkTX4NTH22cjs.findDocNodeByPath.call(void 0, selectedNodePath, structure), 'optionalAccess', _13 => _13.documentType]) : void 0 : initialDocumentType;
+  const isLoadingDocument = isLoadingContent || isLoadingStructure;
+  const loadingContent = isLoadingDocument ? renderContent(
+    { content: "", sections: [], path: _nullishCoalesce(selectedPath, () => ( "")), documentType: selectedNodeDocType },
+    { onInternalLinkClick: navigateToDoc, currentPath: _nullishCoalesce(selectedPath, () => ( "")), sourceId }
+  ) : null;
+  const activeDocType = isLoadingDocument ? selectedNodeDocType : _nullishCoalesce(_optionalChain([content, 'optionalAccess', _14 => _14.documentType]), () => ( selectedNodeDocType));
   const isMarkdownContent = !activeDocType || activeDocType === "markdown";
   const showStickyNav = isMarkdownContent;
-  const stickyNavSections = _nullishCoalesce(_optionalChain([content, 'optionalAccess', _16 => _16.sections, 'optionalAccess', _17 => _17.map, 'call', _18 => _18((s) => ({ id: s.id, label: s.title }))]), () => ( []));
+  const stickyNavSections = _nullishCoalesce(_optionalChain([content, 'optionalAccess', _15 => _15.sections, 'optionalAccess', _16 => _16.map, 'call', _17 => _17((s) => ({ id: s.id, label: s.title }))]), () => ( []));
   const isColorValue = colorPalette.background.startsWith("#") || colorPalette.background.startsWith("rgb") || colorPalette.background.startsWith("var(");
   const bgStyle = isColorValue ? { backgroundColor: colorPalette.background } : {};
   const bgClass = !isColorValue ? colorPalette.background : "";
   const containerBgStyle = colorPalette.containerBackground !== "transparent" ? { backgroundColor: colorPalette.containerBackground } : {};
-  const defaultEmptyText = structure.length > 0 ? "Select a document from the sidebar to view" : "No documents yet. Add content from the admin panel.";
-  const resolvedEmptyText = emptyStateText || defaultEmptyText;
+  const resolvedEmptyText = structure.length > 0 ? "Select a document from the sidebar to view" : emptyStateText || "No documents yet.";
   const inner = /* @__PURE__ */ _jsxruntime.jsx.call(void 0, "div", { style: { ...bgStyle, ...containerBgStyle }, children: /* @__PURE__ */ _jsxruntime.jsx.call(void 0, _chunkIKOL6NJYcjs.PageLayout, { title, subtitle, titleSize: "h1", titleWrap: true, backButton: _nullishCoalesce(backCfg, () => ( void 0)), children: /* @__PURE__ */ _jsxruntime.jsxs.call(void 0, "div", { className: "flex w-full flex-col gap-10", children: [
-    synced && /* @__PURE__ */ _jsxruntime.jsx.call(void 0, _chunk2V6FCVULcjs.DataSyncLine, { sync: _optionalChain([content, 'optionalAccess', _19 => _19.sync]), loading: !content && (isLoadingContent || isLoadingStructure) }),
+    synced && /* @__PURE__ */ _jsxruntime.jsx.call(void 0, _chunkYLETC7LPcjs.DataSyncLine, { sync: _optionalChain([content, 'optionalAccess', _18 => _18.sync]), loading: !content && (isLoadingContent || isLoadingStructure) }),
     showAIChat && /* @__PURE__ */ _jsxruntime.jsx.call(void 0, 
-      _chunk5HOWR4TGcjs.DocSearchBar,
+      _chunk5CBI2ZYVcjs.DocSearchBar,
       {
-        placeholder: `Search ${_optionalChain([sidebarLabel, 'optionalAccess', _20 => _20.toLowerCase, 'call', _21 => _21()]) || "documents"}...`,
+        placeholder: `Search ${_optionalChain([sidebarLabel, 'optionalAccess', _19 => _19.toLowerCase, 'call', _20 => _20()]) || "documents"}...`,
         query: docSearch.query,
         onQueryChange: docSearch.setQuery,
         results: docSearch.results,
@@ -819,7 +813,7 @@ function DocViewerContent({
     !error && /* @__PURE__ */ _jsxruntime.jsxs.call(void 0, "div", { className: "flex flex-1 flex-col items-start gap-6 content-lg:flex-row content-lg:gap-10", children: [
       /* @__PURE__ */ _jsxruntime.jsx.call(void 0, "div", { className: "w-full content-lg:w-[320px] content-lg:shrink-0", children: /* @__PURE__ */ _jsxruntime.jsxs.call(void 0, "div", { className: "content-lg:sticky content-lg:top-20", children: [
         /* @__PURE__ */ _jsxruntime.jsx.call(void 0, PersistentMobileDropdown, { isLoading: false, children: /* @__PURE__ */ _jsxruntime.jsx.call(void 0, 
-          _chunkO4BXHCMKcjs.MobileNavigationDropdown,
+          _chunkFRG724DUcjs.MobileNavigationDropdown,
           {
             nodes: structure,
             selectedPath,
@@ -833,7 +827,7 @@ function DocViewerContent({
         /* @__PURE__ */ _jsxruntime.jsx.call(void 0, PersistentSidebar, { isLoading: false, children: /* @__PURE__ */ _jsxruntime.jsx.call(void 0, "div", { className: "hidden content-lg:block", children: /* @__PURE__ */ _jsxruntime.jsxs.call(void 0, "div", { className: "space-y-4", children: [
           /* @__PURE__ */ _jsxruntime.jsx.call(void 0, "h3", { className: "font-semibold text-ods-text-secondary text-h5", children: sidebarLabel }),
           /* @__PURE__ */ _jsxruntime.jsx.call(void 0, 
-            _chunkO4BXHCMKcjs.MultiLevelNavigation,
+            _chunkFRG724DUcjs.MultiLevelNavigation,
             {
               nodes: structure,
               selectedPath,
@@ -857,22 +851,28 @@ function DocViewerContent({
           // shouldn't be on file pages" bug.
           isMarkdownContent && (showStickyNav && stickyNavSections.length > 0 || isLoadingContent || isLoadingStructure) ? "content-lg:grid-cols-[1fr_280px]" : ""} gap-8`,
           children: [
-            /* @__PURE__ */ _jsxruntime.jsx.call(void 0, "div", { className: `w-full min-w-0 ${isMarkdownContent ? "mx-auto max-w-4xl" : ""}`, children: /* @__PURE__ */ _jsxruntime.jsx.call(void 0, "article", { className: "space-y-2", children: isLoadingContent || isLoadingStructure ? renderSkeleton(selectedNodeDocType) : !content ? /* @__PURE__ */ _jsxruntime.jsx.call(void 0, "div", { className: "py-16 text-center", children: /* @__PURE__ */ _jsxruntime.jsx.call(void 0, "p", { className: "text-ods-text-secondary text-h4", children: resolvedEmptyText }) }) : renderedContent }) }),
-            isMarkdownContent && (isLoadingContent || isLoadingStructure) && /* @__PURE__ */ _jsxruntime.jsx.call(void 0, "div", { className: "hidden content-lg:block", children: /* @__PURE__ */ _jsxruntime.jsxs.call(void 0, "div", { className: "sticky top-24", children: [
+            /* @__PURE__ */ _jsxruntime.jsx.call(void 0, "div", { className: `w-full min-w-0 ${isMarkdownContent ? "mx-auto max-w-4xl" : ""}`, children: /* @__PURE__ */ _jsxruntime.jsx.call(void 0, "article", { className: "space-y-2", children: isLoadingDocument ? (
+              // The document being opened draws its own loading form: its renderer, in a loading scope,
+              // with an empty document of its type (no words, no address), never a skeleton picked here.
+              /* @__PURE__ */ _jsxruntime.jsx.call(void 0, _chunk63A4GZMBcjs.LoadingScope, { children: loadingContent })
+            ) : !content ? /* @__PURE__ */ _jsxruntime.jsx.call(void 0, "div", { className: "py-16 text-center", children: /* @__PURE__ */ _jsxruntime.jsx.call(void 0, "p", { className: "text-ods-text-secondary text-h4", children: resolvedEmptyText }) }) : renderedContent }) }),
+            isMarkdownContent && isLoadingDocument && /* @__PURE__ */ _jsxruntime.jsx.call(void 0, "div", { className: "hidden content-lg:block", children: /* @__PURE__ */ _jsxruntime.jsxs.call(void 0, "div", { className: "sticky top-24", children: [
               /* @__PURE__ */ _jsxruntime.jsx.call(void 0, "h3", { className: ON_THIS_PAGE_HEADING_CLASS, children: ON_THIS_PAGE_LABEL }),
-              /* @__PURE__ */ _jsxruntime.jsx.call(void 0, "div", { className: "space-y-0", children: [130, 170, 190, 220, 110, 200, 80, 100, 120, 140, 90].map((w, i) => /* @__PURE__ */ _jsxruntime.jsx.call(void 0, 
-                "div",
+              /* @__PURE__ */ _jsxruntime.jsx.call(void 0, _chunk63A4GZMBcjs.LoadingScope, { children: /* @__PURE__ */ _jsxruntime.jsx.call(void 0, 
+                _chunkFRG724DUcjs.StickySectionNav,
                 {
-                  className: `border-l-2 py-[13px] pl-3 ${i === 0 ? "border-ods-accent" : "border-transparent"}`,
-                  children: /* @__PURE__ */ _jsxruntime.jsx.call(void 0, _chunkPMUCEUFQcjs.UnifiedSkeleton, { className: "h-[13px] rounded", width: w })
-                },
-                i
-              )) })
+                  sections: [],
+                  activeSection: "",
+                  onSectionClick: NO_SECTION_CLICK,
+                  ribbonPosition: "left",
+                  ribbonColor: "var(--ods-accent)"
+                }
+              ) })
             ] }) }),
             showStickyNav && content && stickyNavSections.length > 0 && !isLoadingContent && /* @__PURE__ */ _jsxruntime.jsx.call(void 0, "div", { className: "hidden content-lg:block", children: /* @__PURE__ */ _jsxruntime.jsxs.call(void 0, "div", { className: "sticky top-24", children: [
               /* @__PURE__ */ _jsxruntime.jsx.call(void 0, "h3", { className: ON_THIS_PAGE_HEADING_CLASS, children: ON_THIS_PAGE_LABEL }),
               /* @__PURE__ */ _jsxruntime.jsx.call(void 0, 
-                _chunkO4BXHCMKcjs.StickySectionNav,
+                _chunkFRG724DUcjs.StickySectionNav,
                 {
                   sections: stickyNavSections,
                   activeSection,
@@ -887,91 +887,18 @@ function DocViewerContent({
       ) })
     ] })
   ] }) }) });
-  return shell ? /* @__PURE__ */ _jsxruntime.jsx.call(void 0, _chunk2V6FCVULcjs.PageShell, { contentClassName: `${bgClass} ${className}`, children: inner }) : /* @__PURE__ */ _jsxruntime.jsx.call(void 0, "div", { className: `page-shell-content ${bgClass} ${className}`.trim(), children: inner });
-}
-
-// src/components/docs/skeletons.tsx
-
-var MARKDOWN_SKELETON_BLOCKS = [
-  { kind: "p", lines: 4 },
-  { kind: "p", lines: 4 },
-  { kind: "p", lines: 5 },
-  { kind: "h2" },
-  { kind: "p", lines: 4 },
-  { kind: "p", lines: 5 },
-  { kind: "h2" },
-  { kind: "p", lines: 3 },
-  { kind: "p", lines: 4 }
-];
-var MARKDOWN_SKELETON_H2_CLASS = _chunk63A4GZMBcjs.cn.call(void 0, _chunkYAW7CHLVcjs.MARKDOWN_H2_CLASS, _chunkYAW7CHLVcjs.TEXT_SIZE_PRESETS.default.h2);
-var MARKDOWN_SKELETON_P_CLASS = _chunk63A4GZMBcjs.cn.call(void 0, _chunkYAW7CHLVcjs.MARKDOWN_PARAGRAPH_CLASS, _chunkYAW7CHLVcjs.TEXT_SIZE_PRESETS.default.p);
-function MarkdownSkeleton({
-  region = true
-} = {}) {
-  return (
-    // The renderer's root class, and its box (no margin of its own, like the rendered body): the document's first fold.
-    /* @__PURE__ */ _jsxruntime.jsx.call(void 0, _chunk2XCORRJVcjs.LoadingRegion, { label: "Loading the document", announce: region, className: _chunkYAW7CHLVcjs.MARKDOWN_RENDERER_CLASS, children: MARKDOWN_SKELETON_BLOCKS.map(
-      (block, i) => block.kind === "h2" ? (
-        // biome-ignore lint/suspicious/noArrayIndexKey: skeleton blocks never reorder
-        /* @__PURE__ */ _jsxruntime.jsx.call(void 0, "h2", { className: MARKDOWN_SKELETON_H2_CLASS, "aria-hidden": true, children: /* @__PURE__ */ _jsxruntime.jsx.call(void 0, _chunkPMUCEUFQcjs.TextLineSkeleton, { type: "inherit", as: "span", className: "w-1/3" }) }, i)
-      ) : (
-        // The last block ends the body with no margin, like the rendered one. Its own `last:mb-0` does not apply here:
-        // the region's status line follows the blocks, so the paragraph is not the last child.
-        // biome-ignore lint/suspicious/noArrayIndexKey: skeleton blocks never reorder
-        /* @__PURE__ */ _jsxruntime.jsx.call(void 0, 
-          "p",
-          {
-            className: _chunk63A4GZMBcjs.cn.call(void 0, MARKDOWN_SKELETON_P_CLASS, i === MARKDOWN_SKELETON_BLOCKS.length - 1 && "mb-0"),
-            "aria-hidden": true,
-            children: /* @__PURE__ */ _jsxruntime.jsx.call(void 0, _chunkPMUCEUFQcjs.TextLineSkeleton, { type: "inherit", as: "span", lines: block.lines, className: "w-full" })
-          },
-          i
-        )
-      )
-    ) })
-  );
-}
-function EmbedSkeleton({ documentType, region = true } = {}) {
-  if (documentType === "file") {
-    return /* @__PURE__ */ _jsxruntime.jsx.call(void 0, 
-      _chunk2XCORRJVcjs.LoadingRegion,
-      {
-        label: "Loading the document",
-        announce: region,
-        className: "flex flex-col items-center justify-center py-16",
-        children: /* @__PURE__ */ _jsxruntime.jsxs.call(void 0, "div", { className: "w-full max-w-md space-y-4 rounded-xl border border-ods-border bg-ods-card p-8 text-center", children: [
-          /* @__PURE__ */ _jsxruntime.jsx.call(void 0, _chunkPMUCEUFQcjs.UnifiedSkeleton, { className: "mx-auto h-16 w-16 rounded" }),
-          /* @__PURE__ */ _jsxruntime.jsxs.call(void 0, "div", { className: "space-y-2", children: [
-            /* @__PURE__ */ _jsxruntime.jsx.call(void 0, _chunkPMUCEUFQcjs.UnifiedSkeleton, { className: "mx-auto h-5 w-2/3 rounded" }),
-            /* @__PURE__ */ _jsxruntime.jsx.call(void 0, _chunkPMUCEUFQcjs.UnifiedSkeleton, { className: "mx-auto h-4 w-1/2 rounded" })
-          ] }),
-          /* @__PURE__ */ _jsxruntime.jsx.call(void 0, _chunkPMUCEUFQcjs.UnifiedSkeleton, { className: "h-10 w-full rounded" })
-        ] })
-      }
-    );
-  }
-  const buttonCount = documentType === "pdf" ? 2 : 1;
-  return /* @__PURE__ */ _jsxruntime.jsxs.call(void 0, _chunk2XCORRJVcjs.LoadingRegion, { label: "Loading the document", announce: region, className: "space-y-4", children: [
-    /* @__PURE__ */ _jsxruntime.jsxs.call(void 0, "div", { className: "flex flex-col gap-3 content-sm:flex-row content-sm:items-center content-sm:justify-between", children: [
-      /* @__PURE__ */ _jsxruntime.jsxs.call(void 0, "div", { className: "flex min-w-0 flex-1 items-center gap-2", children: [
-        /* @__PURE__ */ _jsxruntime.jsx.call(void 0, _chunkPMUCEUFQcjs.UnifiedSkeleton, { className: "h-5 w-5 shrink-0 rounded" }),
-        /* @__PURE__ */ _jsxruntime.jsx.call(void 0, _chunkPMUCEUFQcjs.UnifiedSkeleton, { className: "h-6 w-2/3 rounded" })
-      ] }),
-      /* @__PURE__ */ _jsxruntime.jsx.call(void 0, "div", { className: "flex w-full items-center gap-2 content-sm:w-auto", children: Array.from({ length: buttonCount }).map((_, i) => /* @__PURE__ */ _jsxruntime.jsx.call(void 0, _chunkPMUCEUFQcjs.UnifiedSkeleton, { className: "h-10 w-full flex-1 rounded content-sm:w-32 content-sm:flex-initial" }, i)) })
-    ] }),
-    /* @__PURE__ */ _jsxruntime.jsx.call(void 0, _chunk2V6FCVULcjs.EmbedLoadingSkeleton, { region: false })
-  ] });
+  return shell ? /* @__PURE__ */ _jsxruntime.jsx.call(void 0, _chunkYLETC7LPcjs.PageShell, { contentClassName: `${bgClass} ${className}`, children: inner }) : /* @__PURE__ */ _jsxruntime.jsx.call(void 0, "div", { className: `page-shell-content ${bgClass} ${className}`.trim(), children: inner });
 }
 
 // src/components/docs/docs-hub-page.tsx
 
 var DEFAULT_TITLE = "Documents";
 var defaultFallbackRenderer = () => /* @__PURE__ */ _jsxruntime.jsx.call(void 0, "div", { className: "py-16 text-center", children: /* @__PURE__ */ _jsxruntime.jsx.call(void 0, "p", { className: "text-ods-text-secondary", children: "Unsupported document type" }) });
-var defaultPdfRenderer = (content, handlers) => content.fileUrl ? /* @__PURE__ */ _jsxruntime.jsx.call(void 0, _chunkI3YRYS23cjs.PdfViewer, { src: content.fileUrl, fileName: content.fileName }) : defaultFallbackRenderer(content, handlers);
-var defaultGoogleSheetRenderer = (content, handlers) => content.externalUrl ? /* @__PURE__ */ _jsxruntime.jsx.call(void 0, _chunkI3YRYS23cjs.GoogleSheetsViewer, { externalUrl: content.externalUrl, fileName: content.fileName }) : defaultFallbackRenderer(content, handlers);
-var defaultFigmaRenderer = (content, handlers) => content.externalUrl ? /* @__PURE__ */ _jsxruntime.jsx.call(void 0, _chunk2V6FCVULcjs.FigmaEmbed, { url: content.externalUrl, title: content.fileName, loading: "eager" }) : defaultFallbackRenderer(content, handlers);
+var defaultPdfRenderer = (content) => /* @__PURE__ */ _jsxruntime.jsx.call(void 0, _chunkC3P7IUTUcjs.PdfViewer, { src: _nullishCoalesce(content.fileUrl, () => ( "")), fileName: content.fileName });
+var defaultGoogleSheetRenderer = (content) => /* @__PURE__ */ _jsxruntime.jsx.call(void 0, _chunkC3P7IUTUcjs.GoogleSheetsViewer, { externalUrl: _nullishCoalesce(content.externalUrl, () => ( "")), fileName: content.fileName });
+var defaultFigmaRenderer = (content) => /* @__PURE__ */ _jsxruntime.jsx.call(void 0, _chunkYLETC7LPcjs.FigmaEmbed, { url: _nullishCoalesce(content.externalUrl, () => ( "")), title: content.fileName, iframeLoading: "eager" });
 var defaultFileRenderer = (content) => /* @__PURE__ */ _jsxruntime.jsx.call(void 0, 
-  _chunkI3YRYS23cjs.FileDownloadCard,
+  _chunkC3P7IUTUcjs.FileDownloadCard,
   {
     fileName: content.fileName,
     mimeType: content.mimeType,
@@ -979,11 +906,6 @@ var defaultFileRenderer = (content) => /* @__PURE__ */ _jsxruntime.jsx.call(void
     fileUrl: content.fileUrl
   }
 );
-var documentLoadingForm = (documentType) => !documentType || documentType === "markdown" ? /* @__PURE__ */ _jsxruntime.jsx.call(void 0, MarkdownSkeleton, {}) : (
-  // Forward the documentType so the embed skeleton renders the right
-  // shape (PDF=2 buttons, sheets/figma=1 button, file=centered card).
-  /* @__PURE__ */ _jsxruntime.jsx.call(void 0, EmbedSkeleton, { documentType })
-);
 function DocsHubPage({
   title = DEFAULT_TITLE,
   documentTypeRenderers,
@@ -1013,8 +935,7 @@ function DocsHubPage({
       showAIChat,
       className,
       sidebarLabel,
-      renderContent,
-      renderSkeleton: documentLoadingForm
+      renderContent
     }
   );
 }

package/dist/{chunk-GASFYPGH.cjs → chunk-R5JPZ6TY.cjs}

@@ -8,13 +8,13 @@ var _chunkMZ4KBSH7cjs = require('./chunk-MZ4KBSH7.cjs');
 
 
 
-var _chunkQUSCSYHJcjs = require('./chunk-QUSCSYHJ.cjs');
+var _chunkTX4NTH22cjs = require('./chunk-TX4NTH22.cjs');
 
 
 
 
 
-var _chunkYAW7CHLVcjs = require('./chunk-YAW7CHLV.cjs');
+var _chunkFXLROQUTcjs = require('./chunk-FXLROQUT.cjs');
 
 
 
@@ -33,10 +33,10 @@ var _chunkIX2E3AN7cjs = require('./chunk-IX2E3AN7.cjs');
 
 
 
-var _chunkU7UBYJEZcjs = require('./chunk-U7UBYJEZ.cjs');
+var _chunkBU2PSRAScjs = require('./chunk-BU2PSRAS.cjs');
 
 
-var _chunkYXKAHQYScjs = require('./chunk-YXKAHQYS.cjs');
+var _chunk533QK4R6cjs = require('./chunk-533QK4R6.cjs');
 
 
 var _chunkFX35L4Y6cjs = require('./chunk-FX35L4Y6.cjs');
@@ -82,7 +82,7 @@ function FaqAccordion({ items, defaultOpenIds = [], loading: loadingProp, skelet
     return /* @__PURE__ */ _jsxruntime.jsxs.call(void 0, 
       "div",
       {
-        id: _chunkYAW7CHLVcjs.faqItemAnchor.call(void 0, item.id),
+        id: _chunkFXLROQUTcjs.faqItemAnchor.call(void 0, item.id),
         className: _chunk63A4GZMBcjs.cn.call(void 0, ROW_FRAME_CLASS, "hover:bg-ods-bg-hover"),
         "data-loading-item": true,
         children: [
@@ -148,14 +148,14 @@ function FaqAccordionSkeleton({
 
 var PICK_ROOT_MARGIN = "600px";
 function faqAskCardShown(assistant) {
-  return _chunkQUSCSYHJcjs.assistantAvailable.call(void 0, assistant) && !!assistant.name;
+  return _chunkTX4NTH22cjs.assistantAvailable.call(void 0, assistant) && !!assistant.name;
 }
 function FaqAskCard({ exclude, count, title, description, onOpen }) {
   const { ref, inView } = _chunkGRCOEICKcjs.useInView.call(void 0, { rootMargin: PICK_ROOT_MARGIN });
   const [reached, setReached] = _react.useState.call(void 0, false);
   if (inView && !reached) setReached(true);
   return /* @__PURE__ */ _jsxruntime.jsx.call(void 0, "div", { ref, children: /* @__PURE__ */ _jsxruntime.jsx.call(void 0, 
-    _chunkQUSCSYHJcjs.AssistantAskPrompts,
+    _chunkTX4NTH22cjs.AssistantAskPrompts,
     {
       variant: "card",
       count,
@@ -214,7 +214,7 @@ var CATEGORY_NAV_SKELETON_LINE_CLASS = "flex min-w-0 flex-nowrap gap-2 overflow-
 var FAQ_NAV_SKELETON_PILLS = 8;
 var CATEGORY_PILL_CLASS = "rounded-full border px-4 py-2 transition-colors text-h6";
 var CATEGORY_SECTION_CLASS = "scroll-mt-24";
-var CATEGORY_HEADING_CLASS = _chunk63A4GZMBcjs.cn.call(void 0, _chunkYXKAHQYScjs.SECTION_HEADING_CLASS, "pb-4");
+var CATEGORY_HEADING_CLASS = _chunk63A4GZMBcjs.cn.call(void 0, _chunk533QK4R6cjs.SECTION_HEADING_CLASS, "pb-4");
 var FAQ_SECTION_SKELETON_QUESTIONS = FAQ_ACCORDION_SKELETON_ROWS;
 function FaqLayout({
   heading,
@@ -240,11 +240,11 @@ function FaqLayout({
   ] });
 }
 function faqHeadingNode(heading, showTopic, topic) {
-  const titleNode = heading === void 0 ? /* @__PURE__ */ _jsxruntime.jsx.call(void 0, "h2", { className: _chunkYXKAHQYScjs.SECTION_HEADING_CLASS, children: DEFAULT_HEADING_TEXT }) : heading;
+  const titleNode = heading === void 0 ? /* @__PURE__ */ _jsxruntime.jsx.call(void 0, "h2", { className: _chunk533QK4R6cjs.SECTION_HEADING_CLASS, children: DEFAULT_HEADING_TEXT }) : heading;
   if (!(showTopic && topic)) return titleNode;
   return /* @__PURE__ */ _jsxruntime.jsxs.call(void 0, "div", { className: TOPIC_STACK_CLASS, children: [
     /* @__PURE__ */ _jsxruntime.jsx.call(void 0, "div", { children: titleNode }),
-    /* @__PURE__ */ _jsxruntime.jsx.call(void 0, _chunkYAW7CHLVcjs.PageTopicLabel, {})
+    /* @__PURE__ */ _jsxruntime.jsx.call(void 0, _chunkFXLROQUTcjs.PageTopicLabel, {})
   ] });
 }
 var PAGE_FAQ_SECTION_ID = "faq";
@@ -255,7 +255,7 @@ function SharedPageFaq() {
 }
 function buildFaqsUrl(endpoint, entityType, entityId, minResults, topic) {
   const entityScoped = !!entityType && entityId !== void 0 && entityId !== null && entityId !== "";
-  return _chunkU7UBYJEZcjs.buildSuggestionUrl.call(void 0, endpoint, {
+  return _chunkBU2PSRAScjs.buildSuggestionUrl.call(void 0, endpoint, {
     entityType,
     entityId,
     count: minResults,
@@ -275,7 +275,7 @@ function groupFaqsBySection(faqs) {
     }
     let group = byName.get(name);
     if (!group) {
-      group = { section: name, slug: _chunkYAW7CHLVcjs.faqSectionSlug.call(void 0, name), items: [] };
+      group = { section: name, slug: _chunkFXLROQUTcjs.faqSectionSlug.call(void 0, name), items: [] };
       byName.set(name, group);
     }
     group.items.push(item);
@@ -331,7 +331,7 @@ function GroupedFaqList({
   }, [slugKey]);
   const [hashTarget, setHashTarget] = _react.useState.call(void 0, null);
   _react.useEffect.call(void 0, () => {
-    const refresh = () => setHashTarget(_chunkYAW7CHLVcjs.parseFaqHash.call(void 0, window.location.hash));
+    const refresh = () => setHashTarget(_chunkFXLROQUTcjs.parseFaqHash.call(void 0, window.location.hash));
     refresh();
     window.addEventListener("hashchange", refresh);
     return () => window.removeEventListener("hashchange", refresh);
@@ -435,7 +435,7 @@ function FaqSection({
     () => initialFaqs ? { faqs: initialFaqs } : void 0,
     [initialFaqs]
   );
-  const { data, dataUrl, isLoading, error } = _chunkU7UBYJEZcjs.useSelfFetch.call(void 0, inScope ? null : url, { initialData });
+  const { data, dataUrl, isLoading, error } = _chunkBU2PSRAScjs.useSelfFetch.call(void 0, inScope ? null : url, { initialData });
   const held = dataUrl === url ? _optionalChain([data, 'optionalAccess', _15 => _15.faqs]) : void 0;
   const faqs = _react.useMemo.call(void 0, () => _nullishCoalesce(held, () => ( [])), [held]);
   const groups = _react.useMemo.call(void 0, () => faqs.length > 0 ? groupFaqsBySection(faqs) : [], [faqs]);