@flamingo-stack/openframe-frontend-core 0.0.685-snapshot.20260929164409 → 0.0.685

package/dist/{chunk-QSRUYHTW.js → chunk-BZ2XOEHW.js}

@@ -8,7 +8,7 @@ import {
   SelectTrigger,
   SelectValue,
   Textarea
-} from "./chunk-OTV4W3YD.js";
+} from "./chunk-VDPCK437.js";
 import {
   useContactSubmission,
   useHumanitySignals,
@@ -19,7 +19,7 @@ import {
   ChatAttachmentChipStrip,
   SECTION_HEADING_CLASS,
   useChatAttachments
-} from "./chunk-YPXXXX6R.js";
+} from "./chunk-XGX6JSEU.js";
 import {
   Input,
   Label,
@@ -385,4 +385,4 @@ function ContactForm({
 export {
   ContactForm
 };
-//# sourceMappingURL=chunk-QSRUYHTW.js.map
+//# sourceMappingURL=chunk-BZ2XOEHW.js.map

package/dist/{chunk-XATA4OVO.cjs → chunk-C3B36OYZ.cjs}

@@ -1,7 +1,7 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _nullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return rhsFn(); } } function _optionalChain(ops) { let lastAccessLHS = undefined; let value = ops[0]; let i = 1; while (i < ops.length) { const op = ops[i]; const fn = ops[i + 1]; i += 2; if ((op === 'optionalAccess' || op === 'optionalCall') && value == null) { return undefined; } if (op === 'access' || op === 'optionalAccess') { lastAccessLHS = value; value = fn(value); } else if (op === 'call' || op === 'optionalCall') { value = fn((...args) => value.call(lastAccessLHS, ...args)); lastAccessLHS = undefined; } } return value; }"use client";
 
 
-var _chunkJNDHXL2Dcjs = require('./chunk-JNDHXL2D.cjs');
+var _chunkM4HYIXP6cjs = require('./chunk-M4HYIXP6.cjs');
 
 
 var _chunkIJUQQTMVcjs = require('./chunk-IJUQQTMV.cjs');
@@ -130,7 +130,7 @@ function useSectionNavigation(sections, options) {
 // src/components/navigation/multi-level-navigation.tsx
 var _lucidereact = require('lucide-react');
 
-var DEFAULT_FOLDER_INDEX_FILE2 = _chunkJNDHXL2Dcjs.DEFAULT_FOLDER_INDEX_FILE;
+var DEFAULT_FOLDER_INDEX_FILE2 = _chunkM4HYIXP6cjs.DEFAULT_FOLDER_INDEX_FILE;
 function isNodeVisuallySelected(node, selectedPath, folderIndexFile = DEFAULT_FOLDER_INDEX_FILE2) {
   const FOLDER_INDEX_FILE = folderIndexFile.toLowerCase();
   if (selectedPath === node.path) {
@@ -358,4 +358,4 @@ function MobileNavigationItem({
 
 
 exports.StickySectionNav = StickySectionNav; exports.useSectionNavigation = useSectionNavigation; exports.MultiLevelNavigation = MultiLevelNavigation; exports.MobileNavigationDropdown = MobileNavigationDropdown;
-//# sourceMappingURL=chunk-XATA4OVO.cjs.map
+//# sourceMappingURL=chunk-C3B36OYZ.cjs.map

package/dist/{chunk-XATA4OVO.cjs.map → chunk-C3B36OYZ.cjs.map}

@@ -1 +1 @@
-{"version":3,"sources":["/home/runner/work/openframe-oss-lib/openframe-oss-lib/openframe-frontend-core/dist/chunk-XATA4OVO.cjs","../src/components/navigation/sticky-section-nav.tsx","../src/components/navigation/multi-level-navigation.tsx"],"names":["jsx","DEFAULT_FOLDER_INDEX_FILE"],"mappings":"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","file":"/home/runner/work/openframe-oss-lib/openframe-oss-lib/openframe-frontend-core/dist/chunk-XATA4OVO.cjs","sourcesContent":[null,"'use client';\n\nimport type React from 'react';\nimport { useEffect, useState, useCallback, useRef } from 'react';\nimport { cn } from '../../utils';\nimport { scrollElementIntoView } from '../../utils/scroll-into-view';\n\nexport interface StickyNavSection {\n  id: string;\n  label: string;\n}\n\ninterface StickySectionNavProps {\n  sections: StickyNavSection[];\n  activeSection: string;\n  onSectionClick: (sectionId: string) => void;\n  className?: string;\n  ribbonPosition?: 'left' | 'right';\n  ribbonColor?: string;\n}\n\n/**\n * Reusable sticky navigation component for section-based navigation\n * Used in vendor detail pages, knowledge base, documentation, etc.\n */\nexport function StickySectionNav({\n  sections,\n  activeSection,\n  onSectionClick,\n  className,\n  ribbonPosition = 'left',\n  ribbonColor = 'var(--color-accent-primary)',\n}: StickySectionNavProps) {\n  const navHeight = sections.length * 40; // 40px per item (h-10)\n\n  return (\n    <nav className={cn('relative bg-ods-bg', className)}>\n      {/* Background gray vertical line for all nav items */}\n      <div\n        className=\"absolute bg-ods-border\"\n        style={{\n          width: '1px',\n          height: `${navHeight}px`,\n          [ribbonPosition === 'left' ? 'left' : 'right']: '-2px',\n          top: '0px',\n        }}\n      />\n\n      {sections.map(section => (\n        <div key={section.id} className=\"relative flex h-10 w-full items-stretch transition-all duration-200\">\n          {/* Yellow ribbon for active state */}\n          {activeSection === section.id && (\n            <div\n              className=\"absolute z-10 transition-all duration-200\"\n              style={{\n                backgroundColor: ribbonColor,\n                width: '4px',\n                height: '24px',\n                [ribbonPosition === 'left' ? 'left' : 'right']: '-2px',\n                top: '8px',\n                borderRadius: '2px',\n              }}\n            />\n          )}\n\n          {/* Navigation button */}\n          <button\n            onClick={() => onSectionClick(section.id)}\n            // The ribbon is the visual; this is the same state for assistive\n            // tech (a table of contents marks the reader's current location).\n            aria-current={activeSection === section.id ? 'location' : undefined}\n            className=\"relative flex flex-1 cursor-pointer items-center gap-2 px-3 py-2\"\n          >\n            <span\n              className={cn(\n                'text-left transition-all duration-200 text-h6',\n                activeSection === section.id\n                  ? 'text-ods-text-primary'\n                  : 'text-ods-text-secondary hover:text-ods-text-primary',\n              )}\n            >\n              {section.label}\n            </span>\n          </button>\n        </div>\n      ))}\n    </nav>\n  );\n}\n\n/**\n * SIMPLEST POSSIBLE IMPLEMENTATION - Just make it work\n */\nexport function useSectionNavigation(\n  sections: { id: string; ref: React.RefObject<HTMLElement> }[],\n  options?: {\n    offset?: number;\n  },\n) {\n  const [activeSection, setActiveSection] = useState(sections[0]?.id || '');\n  const isScrollingFromClick = useRef(false);\n  const { offset = 100 } = options || {};\n\n  // Handle click - scroll to the element via the canonical helper.\n  // The `offset` prop maps to `headerOffset` (sticky chrome above the\n  // section nav); same smooth-scroll mechanics every other anchor\n  // surface in the app uses.\n  const handleSectionClick = useCallback(\n    (sectionId: string) => {\n      const targetElement = document.getElementById(sectionId);\n      if (!targetElement) return;\n\n      // Prevent scroll spy while we're scrolling\n      isScrollingFromClick.current = true;\n      setActiveSection(sectionId);\n\n      scrollElementIntoView(targetElement, { headerOffset: offset });\n\n      // Allow scroll spy again after scroll completes\n      setTimeout(() => {\n        isScrollingFromClick.current = false;\n      }, 500);\n    },\n    [offset],\n  );\n\n  // Make sure elements have IDs\n  useEffect(() => {\n    sections.forEach(section => {\n      const el = section.ref.current;\n      if (el && !el.id) {\n        el.id = section.id;\n      }\n    });\n  }, [sections]);\n\n  // Simple scroll spy\n  useEffect(() => {\n    const handleScroll = () => {\n      if (isScrollingFromClick.current) return;\n\n      const scrollPosition = window.scrollY + offset + 50;\n\n      // Find which section we're in\n      let currentSection = sections[0]?.id || '';\n\n      for (let i = sections.length - 1; i >= 0; i--) {\n        const element = document.getElementById(sections[i].id);\n        if (element && scrollPosition >= element.offsetTop) {\n          currentSection = sections[i].id;\n          break;\n        }\n      }\n\n      setActiveSection(currentSection);\n    };\n\n    // Throttle the scroll handler\n    let scrollTimer: NodeJS.Timeout;\n    const throttledScroll = () => {\n      clearTimeout(scrollTimer);\n      scrollTimer = setTimeout(handleScroll, 100);\n    };\n\n    window.addEventListener('scroll', throttledScroll);\n    handleScroll(); // Check initial position\n\n    return () => {\n      window.removeEventListener('scroll', throttledScroll);\n      clearTimeout(scrollTimer);\n    };\n  }, [sections, offset]);\n\n  return {\n    activeSection,\n    handleSectionClick,\n  };\n}\n","'use client';\n\nimport { ChevronDown, ChevronUp, FileText, Folder, FolderOpen } from 'lucide-react';\nimport { cn } from '../../utils/cn';\nimport { DEFAULT_FOLDER_INDEX_FILE as CANONICAL_FOLDER_INDEX_FILE } from '../../utils/doc-tree-nav';\n\nexport interface NavigationNode {\n  id: string;\n  name: string;\n  path: string;\n  type: 'file' | 'folder';\n  hasReadme?: boolean;\n  children?: NavigationNode[];\n  slug?: string;\n  // Mirror DocNode's extra optional fields so a DocNode tree is structurally\n  // assignable to NavigationNode[] without an `as` cast. NavigationNode\n  // intentionally never reads these — they're carried for type-compat only.\n  documentType?: 'markdown' | 'pdf' | 'google_sheet' | 'figma' | 'file';\n  sortOrder?: number;\n}\n\ninterface MultiLevelNavigationProps {\n  nodes: NavigationNode[];\n  selectedPath: string;\n  expandedNodes: Set<string>;\n  onNodeClick: (node: NavigationNode) => void;\n  onToggleExpand?: (nodeId: string) => void;\n  isLoading?: boolean;\n  className?: string;\n  /** Folder-index filename (default `'README.md'`, case-insensitive). When the\n   *  selectedPath is a folder with this file, the visual ribbon moves to the\n   *  child file. */\n  folderIndexFile?: string;\n}\n\n// SSOT lives in `doc-tree-nav` (canonical case `'README.md'`). The visual\n// comparator below lowercases both sides, so re-exporting the canonical\n// constant under the same local name preserves call-site syntax without\n// drifting from the SSOT.\nconst DEFAULT_FOLDER_INDEX_FILE = CANONICAL_FOLDER_INDEX_FILE;\n\n/**\n * Compute the visual \"selected\" state for a navigation node.\n *\n * Folder-with-README convention: when `selectedPath` is a folder that has a\n * README, the FOLDER doesn't get the ribbon — its README child does. The folder\n * is just a container; the README is the actual document being viewed.\n *\n * Mirror case: a README file whose parent folder is the `selectedPath` gets the\n * visual selection ribbon (implicit). This handles both the auto-select-first-\n * folder landing path AND the user-clicks-folder case.\n */\nfunction isNodeVisuallySelected(\n  node: NavigationNode,\n  selectedPath: string,\n  folderIndexFile: string = DEFAULT_FOLDER_INDEX_FILE,\n): boolean {\n  const FOLDER_INDEX_FILE = folderIndexFile.toLowerCase();\n  // Path comparisons keyed on `node.path` (raw, includes `.md`). Do NOT use\n  // `node.name` — the tree-builder runs it through `formatDocName` which strips\n  // the `.md` extension, so `node.name.toLowerCase() === 'readme.md'` is always\n  // false.\n  if (selectedPath === node.path) {\n    // Explicit match — but folder-with-README defers to its README child.\n    return !(node.type === 'folder' && node.hasReadme);\n  }\n  if (node.type !== 'file') return false;\n  const pathLower = node.path.toLowerCase();\n  // Implicit: README child whose parent folder is the selectedPath.\n  if (selectedPath !== '' && pathLower === `${selectedPath.toLowerCase()}/${FOLDER_INDEX_FILE}`) {\n    return true;\n  }\n  // Implicit: ROOT README on the landing page (selectedPath === '' means\n  // \"no explicit doc selected\" — the viewer falls back to the root folder-\n  // index file, so that file IS the active document).\n  if (selectedPath === '' && pathLower === FOLDER_INDEX_FILE) {\n    return true;\n  }\n  return false;\n}\n\nexport function MultiLevelNavigation({\n  nodes,\n  selectedPath,\n  expandedNodes,\n  onNodeClick,\n  onToggleExpand,\n  isLoading,\n  className,\n  folderIndexFile = DEFAULT_FOLDER_INDEX_FILE,\n}: MultiLevelNavigationProps) {\n  if (isLoading) {\n    return (\n      <div className={cn('space-y-2', className)}>\n        {[1, 2, 3, 4].map(i => (\n          <div key={i} className=\"h-12 animate-pulse rounded-lg bg-ods-skeleton p-3\" />\n        ))}\n      </div>\n    );\n  }\n\n  return (\n    <div className={cn('space-y-2', className)} role=\"list\" aria-label=\"Navigation list\">\n      {nodes.map(node => (\n        <NavigationItem\n          key={node.id}\n          node={node}\n          selectedPath={selectedPath}\n          expandedNodes={expandedNodes}\n          onNodeClick={onNodeClick}\n          onToggleExpand={onToggleExpand}\n          level={0}\n          folderIndexFile={folderIndexFile}\n        />\n      ))}\n    </div>\n  );\n}\n\ninterface NavigationItemProps {\n  node: NavigationNode;\n  selectedPath: string;\n  expandedNodes: Set<string>;\n  onNodeClick: (node: NavigationNode) => void;\n  onToggleExpand?: (nodeId: string) => void;\n  level: number;\n  folderIndexFile: string;\n}\n\nfunction NavigationItem({\n  node,\n  selectedPath,\n  expandedNodes,\n  onNodeClick,\n  onToggleExpand,\n  level,\n  folderIndexFile,\n}: NavigationItemProps) {\n  const isExpanded = expandedNodes.has(node.id);\n  const isSelected = isNodeVisuallySelected(node, selectedPath, folderIndexFile);\n  // Bind the (optional) child list once so the render below maps a real array\n  // rather than re-deriving `hasChildren` and asserting it away.\n  const children = node.children ?? [];\n  const hasChildren = children.length > 0;\n\n  return (\n    <div className=\"space-y-1\" role=\"listitem\">\n      <div className={cn('px-2', level > 0 && 'ml-4')}>\n        <div\n          className={cn(\n            'relative w-full rounded-lg border transition-all duration-150',\n            isSelected ? 'border-ods-border bg-ods-border' : 'border-ods-border bg-ods-card',\n          )}\n        >\n          <div className=\"relative flex items-center\">\n            <button\n              className={cn(\n                'flex h-12 w-full items-center rounded-lg px-2 text-ods-text-primary transition-all duration-150 text-h6',\n                !isSelected && 'hover:bg-ods-bg-hover',\n                hasChildren && 'pr-12',\n              )}\n              onClick={() => onNodeClick(node)}\n              aria-label={`${isSelected ? 'Selected' : 'Select'} ${node.name}`}\n            >\n              <span className=\"mr-2 flex-shrink-0\">\n                {node.type === 'folder' ? (\n                  isExpanded ? (\n                    <FolderOpen className=\"h-4 w-4\" />\n                  ) : (\n                    <Folder className=\"h-4 w-4\" />\n                  )\n                ) : (\n                  <FileText className=\"h-4 w-4\" />\n                )}\n              </span>\n              <span className=\"min-w-0 flex-1 truncate text-left\">\n                {node.name.endsWith('.md') ? node.name.replace('.md', '') : node.name}\n              </span>\n              {node.type === 'folder' && node.hasReadme && (\n                <span className=\"mr-2 rounded bg-ods-bg-surface px-1.5 py-0.5 text-ods-text-secondary text-h6\">\n                  README\n                </span>\n              )}\n            </button>\n\n            {hasChildren && (\n              <button\n                className=\"absolute right-0 top-0 flex h-12 w-12 items-center justify-center text-ods-text-secondary transition-colors duration-150 hover:text-ods-text-primary\"\n                onClick={e => {\n                  e.stopPropagation();\n                  if (onToggleExpand) {\n                    onToggleExpand(node.id);\n                  } else {\n                    onNodeClick(node);\n                  }\n                }}\n                aria-label={`${isExpanded ? 'Collapse' : 'Expand'} ${node.name}`}\n              >\n                {isExpanded ? <ChevronUp className=\"h-4 w-4\" /> : <ChevronDown className=\"h-4 w-4\" />}\n              </button>\n            )}\n          </div>\n\n          {isSelected && (\n            <div className=\"absolute right-0 top-1/2 h-[calc(100%-8px)] w-1 -translate-y-1/2 rounded-l bg-ods-accent\" />\n          )}\n        </div>\n      </div>\n\n      {hasChildren && isExpanded && (\n        <div className=\"space-y-1\">\n          {children.map(child => (\n            <NavigationItem\n              key={child.id}\n              node={child}\n              selectedPath={selectedPath}\n              expandedNodes={expandedNodes}\n              onNodeClick={onNodeClick}\n              onToggleExpand={onToggleExpand}\n              level={level + 1}\n              folderIndexFile={folderIndexFile}\n            />\n          ))}\n        </div>\n      )}\n    </div>\n  );\n}\n\nexport function MobileNavigationDropdown({\n  nodes,\n  selectedPath,\n  expandedNodes,\n  onNodeClick,\n  onToggleExpand,\n  isLoading,\n  className,\n  folderIndexFile = DEFAULT_FOLDER_INDEX_FILE,\n}: MultiLevelNavigationProps) {\n  if (isLoading) {\n    return (\n      <div className={cn('space-y-2', className)}>\n        {[1, 2, 3].map(i => (\n          <div key={i} className=\"h-10 animate-pulse rounded-lg bg-ods-skeleton p-3\" />\n        ))}\n      </div>\n    );\n  }\n\n  return (\n    <div className={cn('space-y-2', className)}>\n      {nodes.map(node => (\n        <MobileNavigationItem\n          key={node.id}\n          node={node}\n          selectedPath={selectedPath}\n          expandedNodes={expandedNodes}\n          onNodeClick={onNodeClick}\n          onToggleExpand={onToggleExpand}\n          level={0}\n          folderIndexFile={folderIndexFile}\n        />\n      ))}\n    </div>\n  );\n}\n\nfunction MobileNavigationItem({\n  node,\n  selectedPath,\n  expandedNodes,\n  onNodeClick,\n  onToggleExpand,\n  level,\n  folderIndexFile,\n}: NavigationItemProps) {\n  const isExpanded = expandedNodes.has(node.id);\n  const isSelected = isNodeVisuallySelected(node, selectedPath, folderIndexFile);\n  // Same binding as the desktop item above — a real array to map, no assertion.\n  const children = node.children ?? [];\n  const hasChildren = children.length > 0;\n\n  return (\n    <div className=\"space-y-1\">\n      <div className={cn('px-2', level > 0 && 'ml-3')}>\n        <div\n          className={cn(\n            'relative w-full rounded-lg border transition-all duration-150',\n            isSelected ? 'border-ods-border bg-ods-border' : 'border-ods-border bg-ods-card',\n          )}\n        >\n          <div className=\"relative flex items-center\">\n            <button\n              className={cn(\n                'flex h-11 w-full items-center rounded-lg px-2 text-ods-text-primary transition-all duration-150 text-h6',\n                !isSelected && 'hover:bg-ods-bg-hover',\n                hasChildren && 'pr-11',\n              )}\n              onClick={() => onNodeClick(node)}\n            >\n              <span className=\"mr-2 flex-shrink-0\">\n                {node.type === 'folder' ? (\n                  isExpanded ? (\n                    <FolderOpen className=\"h-4 w-4\" />\n                  ) : (\n                    <Folder className=\"h-4 w-4\" />\n                  )\n                ) : (\n                  <FileText className=\"h-4 w-4\" />\n                )}\n              </span>\n              <span className=\"min-w-0 flex-1 truncate text-left\">\n                {node.name.endsWith('.md') ? node.name.replace('.md', '') : node.name}\n              </span>\n              {node.type === 'folder' && node.hasReadme && (\n                <span className=\"mr-2 rounded bg-ods-bg-surface px-1.5 py-0.5 text-ods-text-secondary text-h6\">\n                  README\n                </span>\n              )}\n            </button>\n\n            {hasChildren && (\n              <button\n                className=\"absolute right-0 top-0 flex h-11 w-11 items-center justify-center text-ods-text-secondary transition-colors duration-150 hover:text-ods-text-primary\"\n                onClick={e => {\n                  e.stopPropagation();\n                  if (onToggleExpand) {\n                    onToggleExpand(node.id);\n                  } else {\n                    onNodeClick(node);\n                  }\n                }}\n                aria-label={`${isExpanded ? 'Collapse' : 'Expand'} ${node.name}`}\n              >\n                {isExpanded ? <ChevronUp className=\"h-3.5 w-3.5\" /> : <ChevronDown className=\"h-3.5 w-3.5\" />}\n              </button>\n            )}\n          </div>\n\n          {isSelected && (\n            <div className=\"absolute right-0 top-1/2 h-[calc(100%-8px)] w-1 -translate-y-1/2 rounded-l bg-ods-accent\" />\n          )}\n        </div>\n      </div>\n\n      {hasChildren && isExpanded && (\n        <div className=\"space-y-1\">\n          {children.map(child => (\n            <MobileNavigationItem\n              key={child.id}\n              node={child}\n              selectedPath={selectedPath}\n              expandedNodes={expandedNodes}\n              onNodeClick={onNodeClick}\n              onToggleExpand={onToggleExpand}\n              level={level + 1}\n              folderIndexFile={folderIndexFile}\n            />\n          ))}\n        </div>\n      )}\n    </div>\n  );\n}\n"]}
+{"version":3,"sources":["/home/runner/work/openframe-oss-lib/openframe-oss-lib/openframe-frontend-core/dist/chunk-C3B36OYZ.cjs","../src/components/navigation/sticky-section-nav.tsx","../src/components/navigation/multi-level-navigation.tsx"],"names":["jsx","DEFAULT_FOLDER_INDEX_FILE"],"mappings":"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","file":"/home/runner/work/openframe-oss-lib/openframe-oss-lib/openframe-frontend-core/dist/chunk-C3B36OYZ.cjs","sourcesContent":[null,"'use client';\n\nimport type React from 'react';\nimport { useEffect, useState, useCallback, useRef } from 'react';\nimport { cn } from '../../utils';\nimport { scrollElementIntoView } from '../../utils/scroll-into-view';\n\nexport interface StickyNavSection {\n  id: string;\n  label: string;\n}\n\ninterface StickySectionNavProps {\n  sections: StickyNavSection[];\n  activeSection: string;\n  onSectionClick: (sectionId: string) => void;\n  className?: string;\n  ribbonPosition?: 'left' | 'right';\n  ribbonColor?: string;\n}\n\n/**\n * Reusable sticky navigation component for section-based navigation\n * Used in vendor detail pages, knowledge base, documentation, etc.\n */\nexport function StickySectionNav({\n  sections,\n  activeSection,\n  onSectionClick,\n  className,\n  ribbonPosition = 'left',\n  ribbonColor = 'var(--color-accent-primary)',\n}: StickySectionNavProps) {\n  const navHeight = sections.length * 40; // 40px per item (h-10)\n\n  return (\n    <nav className={cn('relative bg-ods-bg', className)}>\n      {/* Background gray vertical line for all nav items */}\n      <div\n        className=\"absolute bg-ods-border\"\n        style={{\n          width: '1px',\n          height: `${navHeight}px`,\n          [ribbonPosition === 'left' ? 'left' : 'right']: '-2px',\n          top: '0px',\n        }}\n      />\n\n      {sections.map(section => (\n        <div key={section.id} className=\"relative flex h-10 w-full items-stretch transition-all duration-200\">\n          {/* Yellow ribbon for active state */}\n          {activeSection === section.id && (\n            <div\n              className=\"absolute z-10 transition-all duration-200\"\n              style={{\n                backgroundColor: ribbonColor,\n                width: '4px',\n                height: '24px',\n                [ribbonPosition === 'left' ? 'left' : 'right']: '-2px',\n                top: '8px',\n                borderRadius: '2px',\n              }}\n            />\n          )}\n\n          {/* Navigation button */}\n          <button\n            onClick={() => onSectionClick(section.id)}\n            // The ribbon is the visual; this is the same state for assistive\n            // tech (a table of contents marks the reader's current location).\n            aria-current={activeSection === section.id ? 'location' : undefined}\n            className=\"relative flex flex-1 cursor-pointer items-center gap-2 px-3 py-2\"\n          >\n            <span\n              className={cn(\n                'text-left transition-all duration-200 text-h6',\n                activeSection === section.id\n                  ? 'text-ods-text-primary'\n                  : 'text-ods-text-secondary hover:text-ods-text-primary',\n              )}\n            >\n              {section.label}\n            </span>\n          </button>\n        </div>\n      ))}\n    </nav>\n  );\n}\n\n/**\n * SIMPLEST POSSIBLE IMPLEMENTATION - Just make it work\n */\nexport function useSectionNavigation(\n  sections: { id: string; ref: React.RefObject<HTMLElement> }[],\n  options?: {\n    offset?: number;\n  },\n) {\n  const [activeSection, setActiveSection] = useState(sections[0]?.id || '');\n  const isScrollingFromClick = useRef(false);\n  const { offset = 100 } = options || {};\n\n  // Handle click - scroll to the element via the canonical helper.\n  // The `offset` prop maps to `headerOffset` (sticky chrome above the\n  // section nav); same smooth-scroll mechanics every other anchor\n  // surface in the app uses.\n  const handleSectionClick = useCallback(\n    (sectionId: string) => {\n      const targetElement = document.getElementById(sectionId);\n      if (!targetElement) return;\n\n      // Prevent scroll spy while we're scrolling\n      isScrollingFromClick.current = true;\n      setActiveSection(sectionId);\n\n      scrollElementIntoView(targetElement, { headerOffset: offset });\n\n      // Allow scroll spy again after scroll completes\n      setTimeout(() => {\n        isScrollingFromClick.current = false;\n      }, 500);\n    },\n    [offset],\n  );\n\n  // Make sure elements have IDs\n  useEffect(() => {\n    sections.forEach(section => {\n      const el = section.ref.current;\n      if (el && !el.id) {\n        el.id = section.id;\n      }\n    });\n  }, [sections]);\n\n  // Simple scroll spy\n  useEffect(() => {\n    const handleScroll = () => {\n      if (isScrollingFromClick.current) return;\n\n      const scrollPosition = window.scrollY + offset + 50;\n\n      // Find which section we're in\n      let currentSection = sections[0]?.id || '';\n\n      for (let i = sections.length - 1; i >= 0; i--) {\n        const element = document.getElementById(sections[i].id);\n        if (element && scrollPosition >= element.offsetTop) {\n          currentSection = sections[i].id;\n          break;\n        }\n      }\n\n      setActiveSection(currentSection);\n    };\n\n    // Throttle the scroll handler\n    let scrollTimer: NodeJS.Timeout;\n    const throttledScroll = () => {\n      clearTimeout(scrollTimer);\n      scrollTimer = setTimeout(handleScroll, 100);\n    };\n\n    window.addEventListener('scroll', throttledScroll);\n    handleScroll(); // Check initial position\n\n    return () => {\n      window.removeEventListener('scroll', throttledScroll);\n      clearTimeout(scrollTimer);\n    };\n  }, [sections, offset]);\n\n  return {\n    activeSection,\n    handleSectionClick,\n  };\n}\n","'use client';\n\nimport { ChevronDown, ChevronUp, FileText, Folder, FolderOpen } from 'lucide-react';\nimport { cn } from '../../utils/cn';\nimport { DEFAULT_FOLDER_INDEX_FILE as CANONICAL_FOLDER_INDEX_FILE } from '../../utils/doc-tree-nav';\n\nexport interface NavigationNode {\n  id: string;\n  name: string;\n  path: string;\n  type: 'file' | 'folder';\n  hasReadme?: boolean;\n  children?: NavigationNode[];\n  slug?: string;\n  // Mirror DocNode's extra optional fields so a DocNode tree is structurally\n  // assignable to NavigationNode[] without an `as` cast. NavigationNode\n  // intentionally never reads these — they're carried for type-compat only.\n  documentType?: 'markdown' | 'pdf' | 'google_sheet' | 'figma' | 'file';\n  sortOrder?: number;\n}\n\ninterface MultiLevelNavigationProps {\n  nodes: NavigationNode[];\n  selectedPath: string;\n  expandedNodes: Set<string>;\n  onNodeClick: (node: NavigationNode) => void;\n  onToggleExpand?: (nodeId: string) => void;\n  isLoading?: boolean;\n  className?: string;\n  /** Folder-index filename (default `'README.md'`, case-insensitive). When the\n   *  selectedPath is a folder with this file, the visual ribbon moves to the\n   *  child file. */\n  folderIndexFile?: string;\n}\n\n// SSOT lives in `doc-tree-nav` (canonical case `'README.md'`). The visual\n// comparator below lowercases both sides, so re-exporting the canonical\n// constant under the same local name preserves call-site syntax without\n// drifting from the SSOT.\nconst DEFAULT_FOLDER_INDEX_FILE = CANONICAL_FOLDER_INDEX_FILE;\n\n/**\n * Compute the visual \"selected\" state for a navigation node.\n *\n * Folder-with-README convention: when `selectedPath` is a folder that has a\n * README, the FOLDER doesn't get the ribbon — its README child does. The folder\n * is just a container; the README is the actual document being viewed.\n *\n * Mirror case: a README file whose parent folder is the `selectedPath` gets the\n * visual selection ribbon (implicit). This handles both the auto-select-first-\n * folder landing path AND the user-clicks-folder case.\n */\nfunction isNodeVisuallySelected(\n  node: NavigationNode,\n  selectedPath: string,\n  folderIndexFile: string = DEFAULT_FOLDER_INDEX_FILE,\n): boolean {\n  const FOLDER_INDEX_FILE = folderIndexFile.toLowerCase();\n  // Path comparisons keyed on `node.path` (raw, includes `.md`). Do NOT use\n  // `node.name` — the tree-builder runs it through `formatDocName` which strips\n  // the `.md` extension, so `node.name.toLowerCase() === 'readme.md'` is always\n  // false.\n  if (selectedPath === node.path) {\n    // Explicit match — but folder-with-README defers to its README child.\n    return !(node.type === 'folder' && node.hasReadme);\n  }\n  if (node.type !== 'file') return false;\n  const pathLower = node.path.toLowerCase();\n  // Implicit: README child whose parent folder is the selectedPath.\n  if (selectedPath !== '' && pathLower === `${selectedPath.toLowerCase()}/${FOLDER_INDEX_FILE}`) {\n    return true;\n  }\n  // Implicit: ROOT README on the landing page (selectedPath === '' means\n  // \"no explicit doc selected\" — the viewer falls back to the root folder-\n  // index file, so that file IS the active document).\n  if (selectedPath === '' && pathLower === FOLDER_INDEX_FILE) {\n    return true;\n  }\n  return false;\n}\n\nexport function MultiLevelNavigation({\n  nodes,\n  selectedPath,\n  expandedNodes,\n  onNodeClick,\n  onToggleExpand,\n  isLoading,\n  className,\n  folderIndexFile = DEFAULT_FOLDER_INDEX_FILE,\n}: MultiLevelNavigationProps) {\n  if (isLoading) {\n    return (\n      <div className={cn('space-y-2', className)}>\n        {[1, 2, 3, 4].map(i => (\n          <div key={i} className=\"h-12 animate-pulse rounded-lg bg-ods-skeleton p-3\" />\n        ))}\n      </div>\n    );\n  }\n\n  return (\n    <div className={cn('space-y-2', className)} role=\"list\" aria-label=\"Navigation list\">\n      {nodes.map(node => (\n        <NavigationItem\n          key={node.id}\n          node={node}\n          selectedPath={selectedPath}\n          expandedNodes={expandedNodes}\n          onNodeClick={onNodeClick}\n          onToggleExpand={onToggleExpand}\n          level={0}\n          folderIndexFile={folderIndexFile}\n        />\n      ))}\n    </div>\n  );\n}\n\ninterface NavigationItemProps {\n  node: NavigationNode;\n  selectedPath: string;\n  expandedNodes: Set<string>;\n  onNodeClick: (node: NavigationNode) => void;\n  onToggleExpand?: (nodeId: string) => void;\n  level: number;\n  folderIndexFile: string;\n}\n\nfunction NavigationItem({\n  node,\n  selectedPath,\n  expandedNodes,\n  onNodeClick,\n  onToggleExpand,\n  level,\n  folderIndexFile,\n}: NavigationItemProps) {\n  const isExpanded = expandedNodes.has(node.id);\n  const isSelected = isNodeVisuallySelected(node, selectedPath, folderIndexFile);\n  // Bind the (optional) child list once so the render below maps a real array\n  // rather than re-deriving `hasChildren` and asserting it away.\n  const children = node.children ?? [];\n  const hasChildren = children.length > 0;\n\n  return (\n    <div className=\"space-y-1\" role=\"listitem\">\n      <div className={cn('px-2', level > 0 && 'ml-4')}>\n        <div\n          className={cn(\n            'relative w-full rounded-lg border transition-all duration-150',\n            isSelected ? 'border-ods-border bg-ods-border' : 'border-ods-border bg-ods-card',\n          )}\n        >\n          <div className=\"relative flex items-center\">\n            <button\n              className={cn(\n                'flex h-12 w-full items-center rounded-lg px-2 text-ods-text-primary transition-all duration-150 text-h6',\n                !isSelected && 'hover:bg-ods-bg-hover',\n                hasChildren && 'pr-12',\n              )}\n              onClick={() => onNodeClick(node)}\n              aria-label={`${isSelected ? 'Selected' : 'Select'} ${node.name}`}\n            >\n              <span className=\"mr-2 flex-shrink-0\">\n                {node.type === 'folder' ? (\n                  isExpanded ? (\n                    <FolderOpen className=\"h-4 w-4\" />\n                  ) : (\n                    <Folder className=\"h-4 w-4\" />\n                  )\n                ) : (\n                  <FileText className=\"h-4 w-4\" />\n                )}\n              </span>\n              <span className=\"min-w-0 flex-1 truncate text-left\">\n                {node.name.endsWith('.md') ? node.name.replace('.md', '') : node.name}\n              </span>\n              {node.type === 'folder' && node.hasReadme && (\n                <span className=\"mr-2 rounded bg-ods-bg-surface px-1.5 py-0.5 text-ods-text-secondary text-h6\">\n                  README\n                </span>\n              )}\n            </button>\n\n            {hasChildren && (\n              <button\n                className=\"absolute right-0 top-0 flex h-12 w-12 items-center justify-center text-ods-text-secondary transition-colors duration-150 hover:text-ods-text-primary\"\n                onClick={e => {\n                  e.stopPropagation();\n                  if (onToggleExpand) {\n                    onToggleExpand(node.id);\n                  } else {\n                    onNodeClick(node);\n                  }\n                }}\n                aria-label={`${isExpanded ? 'Collapse' : 'Expand'} ${node.name}`}\n              >\n                {isExpanded ? <ChevronUp className=\"h-4 w-4\" /> : <ChevronDown className=\"h-4 w-4\" />}\n              </button>\n            )}\n          </div>\n\n          {isSelected && (\n            <div className=\"absolute right-0 top-1/2 h-[calc(100%-8px)] w-1 -translate-y-1/2 rounded-l bg-ods-accent\" />\n          )}\n        </div>\n      </div>\n\n      {hasChildren && isExpanded && (\n        <div className=\"space-y-1\">\n          {children.map(child => (\n            <NavigationItem\n              key={child.id}\n              node={child}\n              selectedPath={selectedPath}\n              expandedNodes={expandedNodes}\n              onNodeClick={onNodeClick}\n              onToggleExpand={onToggleExpand}\n              level={level + 1}\n              folderIndexFile={folderIndexFile}\n            />\n          ))}\n        </div>\n      )}\n    </div>\n  );\n}\n\nexport function MobileNavigationDropdown({\n  nodes,\n  selectedPath,\n  expandedNodes,\n  onNodeClick,\n  onToggleExpand,\n  isLoading,\n  className,\n  folderIndexFile = DEFAULT_FOLDER_INDEX_FILE,\n}: MultiLevelNavigationProps) {\n  if (isLoading) {\n    return (\n      <div className={cn('space-y-2', className)}>\n        {[1, 2, 3].map(i => (\n          <div key={i} className=\"h-10 animate-pulse rounded-lg bg-ods-skeleton p-3\" />\n        ))}\n      </div>\n    );\n  }\n\n  return (\n    <div className={cn('space-y-2', className)}>\n      {nodes.map(node => (\n        <MobileNavigationItem\n          key={node.id}\n          node={node}\n          selectedPath={selectedPath}\n          expandedNodes={expandedNodes}\n          onNodeClick={onNodeClick}\n          onToggleExpand={onToggleExpand}\n          level={0}\n          folderIndexFile={folderIndexFile}\n        />\n      ))}\n    </div>\n  );\n}\n\nfunction MobileNavigationItem({\n  node,\n  selectedPath,\n  expandedNodes,\n  onNodeClick,\n  onToggleExpand,\n  level,\n  folderIndexFile,\n}: NavigationItemProps) {\n  const isExpanded = expandedNodes.has(node.id);\n  const isSelected = isNodeVisuallySelected(node, selectedPath, folderIndexFile);\n  // Same binding as the desktop item above — a real array to map, no assertion.\n  const children = node.children ?? [];\n  const hasChildren = children.length > 0;\n\n  return (\n    <div className=\"space-y-1\">\n      <div className={cn('px-2', level > 0 && 'ml-3')}>\n        <div\n          className={cn(\n            'relative w-full rounded-lg border transition-all duration-150',\n            isSelected ? 'border-ods-border bg-ods-border' : 'border-ods-border bg-ods-card',\n          )}\n        >\n          <div className=\"relative flex items-center\">\n            <button\n              className={cn(\n                'flex h-11 w-full items-center rounded-lg px-2 text-ods-text-primary transition-all duration-150 text-h6',\n                !isSelected && 'hover:bg-ods-bg-hover',\n                hasChildren && 'pr-11',\n              )}\n              onClick={() => onNodeClick(node)}\n            >\n              <span className=\"mr-2 flex-shrink-0\">\n                {node.type === 'folder' ? (\n                  isExpanded ? (\n                    <FolderOpen className=\"h-4 w-4\" />\n                  ) : (\n                    <Folder className=\"h-4 w-4\" />\n                  )\n                ) : (\n                  <FileText className=\"h-4 w-4\" />\n                )}\n              </span>\n              <span className=\"min-w-0 flex-1 truncate text-left\">\n                {node.name.endsWith('.md') ? node.name.replace('.md', '') : node.name}\n              </span>\n              {node.type === 'folder' && node.hasReadme && (\n                <span className=\"mr-2 rounded bg-ods-bg-surface px-1.5 py-0.5 text-ods-text-secondary text-h6\">\n                  README\n                </span>\n              )}\n            </button>\n\n            {hasChildren && (\n              <button\n                className=\"absolute right-0 top-0 flex h-11 w-11 items-center justify-center text-ods-text-secondary transition-colors duration-150 hover:text-ods-text-primary\"\n                onClick={e => {\n                  e.stopPropagation();\n                  if (onToggleExpand) {\n                    onToggleExpand(node.id);\n                  } else {\n                    onNodeClick(node);\n                  }\n                }}\n                aria-label={`${isExpanded ? 'Collapse' : 'Expand'} ${node.name}`}\n              >\n                {isExpanded ? <ChevronUp className=\"h-3.5 w-3.5\" /> : <ChevronDown className=\"h-3.5 w-3.5\" />}\n              </button>\n            )}\n          </div>\n\n          {isSelected && (\n            <div className=\"absolute right-0 top-1/2 h-[calc(100%-8px)] w-1 -translate-y-1/2 rounded-l bg-ods-accent\" />\n          )}\n        </div>\n      </div>\n\n      {hasChildren && isExpanded && (\n        <div className=\"space-y-1\">\n          {children.map(child => (\n            <MobileNavigationItem\n              key={child.id}\n              node={child}\n              selectedPath={selectedPath}\n              expandedNodes={expandedNodes}\n              onNodeClick={onNodeClick}\n              onToggleExpand={onToggleExpand}\n              level={level + 1}\n              folderIndexFile={folderIndexFile}\n            />\n          ))}\n        </div>\n      )}\n    </div>\n  );\n}\n"]}

package/dist/{chunk-V26TKJ4Z.cjs → chunk-CMQXPD5C.cjs}

@@ -2,11 +2,11 @@
 
 
 
-var _chunk2FGFB2HYcjs = require('./chunk-2FGFB2HY.cjs');
+var _chunkTJI5V5BRcjs = require('./chunk-TJI5V5BR.cjs');
 
 
 
-var _chunkGSJR33UPcjs = require('./chunk-GSJR33UP.cjs');
+var _chunkQHLJSB2Jcjs = require('./chunk-QHLJSB2J.cjs');
 
 
 var _chunkDMXI5D2Qcjs = require('./chunk-DMXI5D2Q.cjs');
@@ -18,13 +18,13 @@ var _chunkDMXI5D2Qcjs = require('./chunk-DMXI5D2Q.cjs');
 
 
 
-var _chunkJNDHXL2Dcjs = require('./chunk-JNDHXL2D.cjs');
+var _chunkM4HYIXP6cjs = require('./chunk-M4HYIXP6.cjs');
 
 
 
 
 
-var _chunkSI77HF4Ucjs = require('./chunk-SI77HF4U.cjs');
+var _chunkA3CSQB4Acjs = require('./chunk-A3CSQB4A.cjs');
 
 
 
@@ -34,7 +34,7 @@ var _chunkSADRZ4YIcjs = require('./chunk-SADRZ4YI.cjs');
 
 
 
-var _chunkQNWQQ4RTcjs = require('./chunk-QNWQQ4RT.cjs');
+var _chunkDQOQ3KTPcjs = require('./chunk-DQOQ3KTP.cjs');
 
 
 var _chunkYCKGUQA2cjs = require('./chunk-YCKGUQA2.cjs');
@@ -62,7 +62,7 @@ function OnboardingGuidesCatalogSkeleton() {
         /* @__PURE__ */ _jsxruntime.jsx.call(void 0, "span", { className: "h-6 w-40 rounded bg-ods-border/70" }),
         /* @__PURE__ */ _jsxruntime.jsx.call(void 0, "span", { className: "h-5 w-8 rounded-full bg-ods-text-secondary/20" })
       ] }),
-      /* @__PURE__ */ _jsxruntime.jsx.call(void 0, "ul", { className: "flex flex-col gap-4", children: Array.from({ length: cardCount }).map((_, cardIdx) => /* @__PURE__ */ _jsxruntime.jsx.call(void 0, "li", { children: /* @__PURE__ */ _jsxruntime.jsx.call(void 0, _chunkQNWQQ4RTcjs.OnboardingGuideCardSkeleton, { size: "catalog" }) }, cardIdx)) })
+      /* @__PURE__ */ _jsxruntime.jsx.call(void 0, "ul", { className: "flex flex-col gap-4", children: Array.from({ length: cardCount }).map((_, cardIdx) => /* @__PURE__ */ _jsxruntime.jsx.call(void 0, "li", { children: /* @__PURE__ */ _jsxruntime.jsx.call(void 0, _chunkDQOQ3KTPcjs.OnboardingGuideCardSkeleton, { size: "catalog" }) }, cardIdx)) })
     ] }, sectionIdx)) })
   ] });
 }
@@ -132,25 +132,25 @@ function OnboardingGuidesCatalogView({
     });
   };
   const source = _nullishCoalesce(_optionalChain([runtime, 'optionalAccess', _6 => _6.source]), () => ( "openframe"));
-  const docSearch = _chunkGSJR33UPcjs.useDocSearch.call(void 0, {
+  const docSearch = _chunkQHLJSB2Jcjs.useDocSearch.call(void 0, {
     source,
     baseRoute: basePath,
     onNavigate: (path) => router.push(path),
     tableIds: ["onboarding-guides"]
   });
   const defaultRenderCard = (guide) => {
-    const cta = _chunkJNDHXL2Dcjs.resolveContentHref.call(void 0, _optionalChain([runtime, 'optionalAccess', _7 => _7.composeContentUrl]), {
+    const cta = _chunkM4HYIXP6cjs.resolveContentHref.call(void 0, _optionalChain([runtime, 'optionalAccess', _7 => _7.composeContentUrl]), {
       type: "onboarding_guide",
       slug: guide.slug,
       basePath,
       platforms: guide.onboarding_guide_platforms
     });
-    return /* @__PURE__ */ _jsxruntime.jsx.call(void 0, _chunkQNWQQ4RTcjs.OnboardingGuideCard, { guide, href: cta.href, targetPlatform: cta.targetPlatform, size: "catalog" });
+    return /* @__PURE__ */ _jsxruntime.jsx.call(void 0, _chunkDQOQ3KTPcjs.OnboardingGuideCard, { guide, href: cta.href, targetPlatform: cta.targetPlatform, size: "catalog" });
   };
   const renderCardFn = _nullishCoalesce(renderCard, () => ( defaultRenderCard));
   const preControls = /* @__PURE__ */ _jsxruntime.jsxs.call(void 0, "div", { className: "space-y-4", children: [
     /* @__PURE__ */ _jsxruntime.jsx.call(void 0, 
-      _chunkGSJR33UPcjs.DocSearchBar,
+      _chunkQHLJSB2Jcjs.DocSearchBar,
       {
         placeholder: "Search onboarding guides, releases, case studies\u2026",
         query: docSearch.query,
@@ -162,7 +162,7 @@ function OnboardingGuidesCatalogView({
       }
     ),
     sections.length > 0 && /* @__PURE__ */ _jsxruntime.jsx.call(void 0, 
-      _chunkJNDHXL2Dcjs.FilterPillRow,
+      _chunkM4HYIXP6cjs.FilterPillRow,
       {
         label: "Section",
         selectedValue: activeSection,
@@ -172,7 +172,7 @@ function OnboardingGuidesCatalogView({
     )
   ] });
   if (selfFetch && guidesRes.error) {
-    return /* @__PURE__ */ _jsxruntime.jsx.call(void 0, _chunkJNDHXL2Dcjs.LoadError, { message: "Failed to load onboarding guides.", onRetry: guidesRes.reload });
+    return /* @__PURE__ */ _jsxruntime.jsx.call(void 0, _chunkM4HYIXP6cjs.LoadError, { message: "Failed to load onboarding guides.", onRetry: guidesRes.reload });
   }
   if (selfFetch && guidesRes.data == null && isLoading) {
     return /* @__PURE__ */ _jsxruntime.jsx.call(void 0, OnboardingGuidesCatalogSkeleton, {});
@@ -204,7 +204,7 @@ function OnboardingGuideDetailView({
   slug,
   guideEndpoint,
   related = [],
-  MarkdownRenderer = _chunkJNDHXL2Dcjs.RichMarkdownRenderer,
+  MarkdownRenderer = _chunkM4HYIXP6cjs.RichMarkdownRenderer,
   renderRelatedCard,
   backHref,
   backLabel = "Back to Getting Started",
@@ -214,23 +214,23 @@ function OnboardingGuideDetailView({
 }) {
   const resolvedBackHref = _nullishCoalesce(backHref, () => ( basePath));
   const runtime = _chunkU2YLMFJKcjs.useChatRuntime.call(void 0, );
-  const captions = _chunkSI77HF4Ucjs.useCaptions.call(void 0, );
+  const captions = _chunkA3CSQB4Acjs.useCaptions.call(void 0, );
   const router = _chunkSADRZ4YIcjs.useRouter.call(void 0, );
-  const renderShell = (node) => shell ? /* @__PURE__ */ _jsxruntime.jsx.call(void 0, _chunkJNDHXL2Dcjs.PageShell, { children: node }) : /* @__PURE__ */ _jsxruntime.jsx.call(void 0, "div", { className: "page-shell-content", children: node });
+  const renderShell = (node) => shell ? /* @__PURE__ */ _jsxruntime.jsx.call(void 0, _chunkM4HYIXP6cjs.PageShell, { children: node }) : /* @__PURE__ */ _jsxruntime.jsx.call(void 0, "div", { className: "page-shell-content", children: node });
   const url = initialData ? null : slug && guideEndpoint ? guideEndpoint(slug) : null;
   const { data: guide, isLoading, error, reload } = _chunkDMXI5D2Qcjs.useSelfFetch.call(void 0, url, { initialData });
-  const { ref: videoWarmupRef } = _chunkSI77HF4Ucjs.useVideoWarmup.call(void 0, {
+  const { ref: videoWarmupRef } = _chunkA3CSQB4Acjs.useVideoWarmup.call(void 0, {
     videoUrl: _optionalChain([guide, 'optionalAccess', _8 => _8.main_video_url]),
     supabaseStorageOrigin: _optionalChain([runtime, 'optionalAccess', _9 => _9.endpoints, 'access', _10 => _10.supabaseStorageOrigin])
   });
   if (error || !guide && !isLoading) {
-    return renderShell(/* @__PURE__ */ _jsxruntime.jsx.call(void 0, _chunkJNDHXL2Dcjs.LoadError, { message: "Guide not found.", onRetry: reload }));
+    return renderShell(/* @__PURE__ */ _jsxruntime.jsx.call(void 0, _chunkM4HYIXP6cjs.LoadError, { message: "Guide not found.", onRetry: reload }));
   }
   if (!guide) {
     return renderShell(
       // Match the loaded page's top offset (TitleBlock's
       // `pt-[var(--spacing-system-l)]`) so content doesn't jump on load.
-      /* @__PURE__ */ _jsxruntime.jsx.call(void 0, "div", { className: "pt-[var(--spacing-system-l)]", children: /* @__PURE__ */ _jsxruntime.jsx.call(void 0, _chunk2FGFB2HYcjs.DetailPageSkeleton, { bare: true, showImageGallery: false }) })
+      /* @__PURE__ */ _jsxruntime.jsx.call(void 0, "div", { className: "pt-[var(--spacing-system-l)]", children: /* @__PURE__ */ _jsxruntime.jsx.call(void 0, _chunkTJI5V5BRcjs.DetailPageSkeleton, { bare: true, showImageGallery: false }) })
     );
   }
   const { captionsUrl, highlightCaptionsUrl } = captions.forEntity("onboarding_guide", guide);
@@ -238,27 +238,27 @@ function OnboardingGuideDetailView({
   // worst), so it's the terminal fallback — no trailing `|| undefined` needed.
   _chunkYCKGUQA2cjs.buildOgPlaceholderUrl.call(void 0, _optionalChain([runtime, 'optionalAccess', _11 => _11.endpoints]), guide.title, { aspect: "wide" });
   const defaultRenderRelatedCard = (g) => {
-    const cta = _chunkJNDHXL2Dcjs.resolveContentHref.call(void 0, _optionalChain([runtime, 'optionalAccess', _12 => _12.composeContentUrl]), {
+    const cta = _chunkM4HYIXP6cjs.resolveContentHref.call(void 0, _optionalChain([runtime, 'optionalAccess', _12 => _12.composeContentUrl]), {
       type: "onboarding_guide",
       slug: g.slug,
       basePath,
       platforms: g.onboarding_guide_platforms
     });
-    return /* @__PURE__ */ _jsxruntime.jsx.call(void 0, _chunkQNWQQ4RTcjs.OnboardingGuideCard, { guide: g, href: cta.href, targetPlatform: cta.targetPlatform });
+    return /* @__PURE__ */ _jsxruntime.jsx.call(void 0, _chunkDQOQ3KTPcjs.OnboardingGuideCard, { guide: g, href: cta.href, targetPlatform: cta.targetPlatform });
   };
   const renderRelatedCardFn = _nullishCoalesce(renderRelatedCard, () => ( defaultRenderRelatedCard));
   return renderShell(
     /* @__PURE__ */ _jsxruntime.jsxs.call(void 0, 
-      _chunkJNDHXL2Dcjs.PageLayout,
+      _chunkM4HYIXP6cjs.PageLayout,
       {
         title: guide.title,
         titleSize: "h1",
         titleWrap: true,
         backButton: { label: backLabel, onClick: () => router.push(resolvedBackHref) },
         children: [
-          /* @__PURE__ */ _jsxruntime.jsx.call(void 0, _chunkJNDHXL2Dcjs.EntityTagBadges, { tags: guide.onboarding_guide_tags }),
+          /* @__PURE__ */ _jsxruntime.jsx.call(void 0, _chunkM4HYIXP6cjs.EntityTagBadges, { tags: guide.onboarding_guide_tags }),
           /* @__PURE__ */ _jsxruntime.jsx.call(void 0, 
-            _chunkQNWQQ4RTcjs.EntityAuthorCard,
+            _chunkDQOQ3KTPcjs.EntityAuthorCard,
             {
               author: guide.author,
               authorHref,
@@ -273,7 +273,7 @@ function OnboardingGuideDetailView({
             }
           ),
           (guide.main_video_url || guide.youtube_url) && /* @__PURE__ */ _jsxruntime.jsx.call(void 0, "div", { ref: videoWarmupRef, children: /* @__PURE__ */ _jsxruntime.jsx.call(void 0, 
-            _chunkSI77HF4Ucjs.EntityVideoSection,
+            _chunkA3CSQB4Acjs.EntityVideoSection,
             {
               mainVideoUrl: guide.main_video_url,
               youtubeUrl: guide.youtube_url || void 0,
@@ -291,17 +291,17 @@ function OnboardingGuideDetailView({
           ) }),
           guide.content && /* @__PURE__ */ _jsxruntime.jsx.call(void 0, "div", { className: "space-y-4", children: /* @__PURE__ */ _jsxruntime.jsx.call(void 0, MarkdownRenderer, { content: guide.content }) }),
           /* @__PURE__ */ _jsxruntime.jsx.call(void 0, 
-            _chunkSI77HF4Ucjs.VideoBitesStrip,
+            _chunkA3CSQB4Acjs.VideoBitesStrip,
             {
               bites: _nullishCoalesce(guide.video_bites, () => ( [])),
               filterPublished: true,
               showTitle: false,
-              profile: _chunkQNWQQ4RTcjs.toStripProfile.call(void 0, guide.author),
+              profile: _chunkDQOQ3KTPcjs.toStripProfile.call(void 0, guide.author),
               href: `/onboarding-guides/${guide.slug}`
             }
           ),
           /* @__PURE__ */ _jsxruntime.jsx.call(void 0, 
-            _chunk2FGFB2HYcjs.ArticleAuthorByline,
+            _chunkTJI5V5BRcjs.ArticleAuthorByline,
             {
               author: _nullishCoalesce(_optionalChain([guide, 'access', _13 => _13.author, 'optionalAccess', _14 => _14.full_name]), () => ( null)),
               avatar: _optionalChain([guide, 'access', _15 => _15.author, 'optionalAccess', _16 => _16.avatar_url]),
@@ -389,4 +389,4 @@ function useOnboardingGuideSections() {
 
 
 exports.OnboardingGuidesCatalogSkeleton = OnboardingGuidesCatalogSkeleton; exports.OnboardingGuidesCatalogView = OnboardingGuidesCatalogView; exports.OnboardingGuideDetailView = OnboardingGuideDetailView; exports.onboardingGuideKeys = onboardingGuideKeys; exports.useOnboardingGuides = useOnboardingGuides; exports.useOnboardingGuide = useOnboardingGuide; exports.useOnboardingGuideSections = useOnboardingGuideSections;
-//# sourceMappingURL=chunk-V26TKJ4Z.cjs.map
+//# sourceMappingURL=chunk-CMQXPD5C.cjs.map

package/dist/{chunk-V26TKJ4Z.cjs.map → chunk-CMQXPD5C.cjs.map}

@@ -1 +1 @@
-{"version":3,"sources":["/home/runner/work/openframe-oss-lib/openframe-oss-lib/openframe-frontend-core/dist/chunk-V26TKJ4Z.cjs","../src/components/onboarding-guides/onboarding-guides-catalog-view.tsx","../src/components/onboarding-guides/onboarding-guides-catalog-skeleton.tsx","../src/components/onboarding-guides/onboarding-guide-detail-view.tsx","../src/components/onboarding-guides/hooks/use-onboarding-guides.ts"],"names":["jsx","jsxs"],"mappings":"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","file":"/home/runner/work/openframe-oss-lib/openframe-oss-lib/openframe-frontend-core/dist/chunk-V26TKJ4Z.cjs","sourcesContent":[null,"'use client';\n\n/**\n * Public-facing catalog view for `/onboarding-guides`.\n *\n * Two data modes:\n *   - **controlled** (hub SSR): pass `initialGuides` + `initialSections`\n *     (server-fetched; section changes re-render the host with new props).\n *   - **self-fetching** (config-only embed): omit the data props and pass\n *     `guidesEndpoint` + `sectionsEndpoint` (the api routes). The view fetches\n *     the guides (refetching on `?section=` change) + the section list itself —\n *     no host data layer. (Plain fetch + useEffect, the DeliveryLists pattern.)\n *\n * The view renders ONLY its body + its OWN controls (the RAG `<DocSearchBar>` +\n * dynamic section pills — onboarding's controls are content-driven, unlike the\n * static search/filter the `DevSectionView` chrome ships). It does NOT render the\n * page chrome: the CALLER wraps it in `<DevSectionPage sectionKey=\"onboarding\">`\n * (hero + back button), exactly like the roadmap / releases / delivery pages — so\n * every dev-center surface composes the same way and the view stays embeddable in\n * tabbed contexts. Card hrefs flow through `runtime.composeContentUrl`.\n */\n\nimport { GraduationCap } from 'lucide-react';\nimport { useMemo, useTransition, type ReactNode } from 'react';\n\nimport { useChatRuntime } from '../../contexts/chat-runtime-context';\nimport { useRouter, useSearchParams } from '../../embed-shims';\nimport { useSelfFetch } from '../../hooks/use-self-fetch';\nimport { resolveContentHref } from '../../utils/content-href';\nimport { OnboardingGuideCard } from '../chat/entity-cards/onboarding-guide-card';\nimport type { OnboardingGuide } from '../chat/types/entities/onboarding-guide';\nimport { DocSearchBar, useDocSearch } from '../shared/doc-search';\nimport { LoadError } from '../ui/error-state';\nimport { FilterPillRow } from '../ui/filter-pill-row';\nimport { OnboardingGuidesCatalogSkeleton } from './onboarding-guides-catalog-skeleton';\n\ntype SectionSummary = { section: string; section_order: number; count: number };\n\nexport interface OnboardingGuidesCatalogViewProps {\n  /** Controlled / SSR: server-fetched guides. Omit + pass `guidesEndpoint`\n   *  for the self-fetching config-only mode. */\n  initialGuides?: OnboardingGuide[];\n  initialSections?: SectionSummary[];\n  initialSection?: string;\n  /** Self-fetch: GET list endpoint (the api route). Appends `?section=`. */\n  guidesEndpoint?: string;\n  /** Self-fetch: GET section-summary endpoint (the api route). */\n  sectionsEndpoint?: string;\n  /** Optional per-row card renderer override. */\n  renderCard?: (guide: OnboardingGuide) => ReactNode;\n  /** Base path the catalog is mounted under (fallback href prefix + `?section=`\n   *  push target). Default `/onboarding-guides`. */\n  basePath?: string;\n}\n\nexport function OnboardingGuidesCatalogView({\n  initialGuides,\n  initialSections,\n  initialSection = '',\n  guidesEndpoint,\n  sectionsEndpoint,\n  renderCard,\n  basePath = '/onboarding-guides',\n}: OnboardingGuidesCatalogViewProps) {\n  const router = useRouter();\n  const searchParams = useSearchParams();\n  const [isPending, startTransition] = useTransition();\n  const runtime = useChatRuntime();\n\n  // Self-fetch only when the host supplied NO data but DID give an endpoint.\n  const selfFetch = initialGuides === undefined && guidesEndpoint !== undefined;\n  // Active section: from the URL when self-fetching, from the prop (host RSC\n  // already read the URL server-side) when controlled.\n  const sectionValue = selfFetch ? (searchParams.get('section') ?? '') : initialSection;\n  const activeSection = sectionValue || 'all';\n\n  // Self-fetch the guides (refetched whenever `?section=` changes — it's folded\n  // into the url) + the section summaries. Controlled mode passes `null` urls so\n  // the hook never fetches. The guides fetch carries the error/retry affordance.\n  const guidesQs = sectionValue ? `?section=${encodeURIComponent(sectionValue)}` : '';\n  const guidesRes = useSelfFetch<{ data?: OnboardingGuide[] }>(\n    selfFetch && guidesEndpoint ? `${guidesEndpoint}${guidesQs}` : null,\n  );\n  const sectionsRes = useSelfFetch<SectionSummary[]>(selfFetch && sectionsEndpoint ? sectionsEndpoint : null);\n\n  // Invariant: `guidesRes.data` is `null` until the first fetch resolves, then\n  // `{ data: [...] }`. The `?.data ?? []` chain collapses never-fetched (null) and\n  // legitimately-empty ([]) to the same `[]` — so the first-load skeleton gate below\n  // keys on the OUTER `guidesRes.data == null` to distinguish them (an empty section\n  // toggle keeps the chrome; only a true cold start shows the full-page skeleton).\n  // Memoised because the `??` fallback minted a NEW array on every\n  // render, which made the memo below re-run every time — i.e. do nothing.\n  const guides = useMemo(() => initialGuides ?? guidesRes.data?.data ?? [], [initialGuides, guidesRes.data?.data]);\n  const sections = useMemo(\n    () => initialSections ?? (Array.isArray(sectionsRes.data) ? sectionsRes.data : []),\n    [initialSections, sectionsRes.data],\n  );\n  const isLoading = selfFetch ? guidesRes.isLoading : false;\n\n  // Section grouping. Data arrives already filtered (server-side `?section=`\n  // for the host, or our `?section=` fetch); this just buckets visible rows.\n  const grouped = useMemo(() => {\n    const map = new Map<string, { section_order: number; guides: OnboardingGuide[] }>();\n    for (const g of guides) {\n      const existing = map.get(g.section);\n      if (existing) {\n        if (g.section_order < existing.section_order) existing.section_order = g.section_order;\n        existing.guides.push(g);\n      } else {\n        map.set(g.section, { section_order: g.section_order, guides: [g] });\n      }\n    }\n    for (const entry of map.values()) {\n      entry.guides.sort((a, b) => a.step_order - b.step_order || a.title.localeCompare(b.title));\n    }\n    return Array.from(map.entries())\n      .map(([section, info]) => ({ section, ...info }))\n      .sort((a, b) => a.section_order - b.section_order || a.section.localeCompare(b.section));\n  }, [guides]);\n\n  const sectionFilterOptions = useMemo(\n    () => [\n      { value: 'all', label: `All (${guides.length})` },\n      ...sections.map(s => ({ value: s.section, label: `${s.section} (${s.count})` })),\n    ],\n    [guides.length, sections],\n  );\n\n  // Section pill change → push `?section=X`. Controlled mode: host RSC\n  // re-fetches. Self-fetch mode: our guides effect re-fetches on the URL change.\n  const setSection = (value: string) => {\n    const params = new URLSearchParams(searchParams.toString());\n    if (value === 'all') {\n      params.delete('section');\n    } else {\n      params.set('section', value);\n    }\n    const qs = params.toString();\n    startTransition(() => {\n      router.push(qs ? `${basePath}?${qs}` : basePath);\n    });\n  };\n\n  // Search bar — scoped to onboarding-guides only via RAG-search `tableIds`.\n  const source = runtime?.source ?? 'openframe';\n  const docSearch = useDocSearch({\n    source,\n    baseRoute: basePath,\n    onNavigate: path => router.push(path),\n    tableIds: ['onboarding-guides'],\n  });\n\n  // Per-row card renderer — runtime-composed href, fallback to relative.\n  const defaultRenderCard = (guide: OnboardingGuide) => {\n    const cta = resolveContentHref(runtime?.composeContentUrl, {\n      type: 'onboarding_guide',\n      slug: guide.slug,\n      basePath,\n      platforms: guide.onboarding_guide_platforms,\n    });\n    return <OnboardingGuideCard guide={guide} href={cta.href} targetPlatform={cta.targetPlatform} size=\"catalog\" />;\n  };\n  const renderCardFn = renderCard ?? defaultRenderCard;\n\n  const preControls = (\n    <div className=\"space-y-4\">\n      <DocSearchBar\n        placeholder=\"Search onboarding guides, releases, case studies…\"\n        query={docSearch.query}\n        onQueryChange={docSearch.setQuery}\n        results={docSearch.results}\n        isLoading={docSearch.isLoading}\n        onResultSelect={docSearch.handleResultSelect}\n        showDropdown={docSearch.keepDropdownOpen}\n      />\n      {sections.length > 0 && (\n        <FilterPillRow\n          label=\"Section\"\n          selectedValue={activeSection}\n          onValueChange={setSection}\n          options={sectionFilterOptions}\n        />\n      )}\n    </div>\n  );\n\n  // A failed guides fetch → a RETRYABLE error (not the indistinguishable-from-\n  // empty \"no guides found\" state) — parity with the sibling self-fetch views.\n  if (selfFetch && guidesRes.error) {\n    return <LoadError message=\"Failed to load onboarding guides.\" onRetry={guidesRes.reload} />;\n  }\n  // Full-page skeleton ONLY on the very first load (no data has loaded yet) — a\n  // later section toggle that legitimately returns ZERO guides keeps the page\n  // chrome (search + section pills) and dims the grid via the className below.\n  if (selfFetch && guidesRes.data == null && isLoading) {\n    return <OnboardingGuidesCatalogSkeleton />;\n  }\n\n  return (\n    <div className=\"flex w-full flex-col gap-10\">\n      {preControls}\n      {guides.length === 0 ? (\n        <div className=\"py-16 text-center\">\n          <GraduationCap className=\"mx-auto mb-4 h-12 w-12 text-ods-text-secondary\" />\n          <h2 className=\"mb-2 text-ods-text-primary text-h3\">No onboarding guides found</h2>\n          <p className=\"text-ods-text-secondary text-h6\">\n            {activeSection !== 'all'\n              ? 'No guides in this section yet.'\n              : \"We're working on the onboarding library. Check back soon.\"}\n          </p>\n        </div>\n      ) : (\n        <div className={isPending || isLoading ? 'space-y-10 opacity-60 transition-opacity' : 'space-y-10'}>\n          {grouped.map(sec => (\n            <section key={sec.section} className=\"space-y-4\">\n              <h2 className=\"flex items-center gap-2 text-ods-text-primary text-h3\">\n                {sec.section}\n                <span className=\"inline-flex items-center justify-center rounded-full bg-ods-text-secondary/20 px-2 py-0.5 text-ods-text-secondary text-h6\">\n                  {sec.guides.length}\n                </span>\n              </h2>\n              {/* HORIZONTAL catalog list — single column so consecutive steps\n                  read top-to-bottom; a grid would visually reorder them. */}\n              <ul className=\"flex flex-col gap-4\">\n                {sec.guides.map(guide => (\n                  <li key={guide.id}>{renderCardFn(guide)}</li>\n                ))}\n              </ul>\n            </section>\n          ))}\n        </div>\n      )}\n    </div>\n  );\n}\n","'use client';\n\nimport { OnboardingGuideCardSkeleton } from '../chat/entity-cards/onboarding-guide-card';\n\n/**\n * Loading skeleton for `/onboarding-guides` — CHROME-LESS, exactly like the\n * loaded `<OnboardingGuidesCatalogView>`. The HOST page owns the\n * `<DevSectionPage sectionKey=\"onboarding\">` shell (hero + back button);\n * this component renders only what replaces the view: the search/pill\n * placeholder block and the section card lists.\n *\n * HISTORY: this used to mount its own `<DevSectionPage>` — nested inside the\n * page's shell that double-rendered the hero + back button during loading\n * (the view was made chrome-less in the page restructure; the skeleton was\n * missed). Keep BOTH chrome-less.\n *\n * Wrapper mirrors the loaded view's `w-full flex flex-col gap-10`; per-card\n * height matches the loaded catalog card so resolve shifts are zero.\n */\nexport function OnboardingGuidesCatalogSkeleton() {\n  return (\n    <div className=\"flex w-full animate-pulse flex-col gap-10\">\n      {/* Search input placeholder — matches `<SearchInput>` h-12 — plus the\n          section pill row (~74 px incl. padding), same as the loaded\n          preControls block. */}\n      <div className=\"space-y-4\">\n        <div className=\"h-12 w-full rounded-md border border-ods-border bg-ods-card\" />\n        <div className=\"flex flex-wrap items-center gap-3 rounded-lg border border-ods-border bg-ods-card p-4\">\n          <div className=\"h-4 w-14 rounded bg-ods-border/60\" />\n          {[0, 1, 2, 3].map(i => (\n            <div key={i} className=\"h-10 w-24 rounded-md border border-ods-border bg-ods-card\" />\n          ))}\n        </div>\n      </div>\n      <div className=\"space-y-10\">\n        {[4, 3, 3].map((cardCount, sectionIdx) => (\n          <section key={sectionIdx} className=\"space-y-4\">\n            <h2 className=\"flex items-center gap-2 tracking-[-0.36px] text-ods-text-primary text-h3\">\n              <span className=\"h-6 w-40 rounded bg-ods-border/70\" />\n              <span className=\"h-5 w-8 rounded-full bg-ods-text-secondary/20\" />\n            </h2>\n            <ul className=\"flex flex-col gap-4\">\n              {Array.from({ length: cardCount }).map((_, cardIdx) => (\n                <li key={cardIdx}>\n                  <OnboardingGuideCardSkeleton size=\"catalog\" />\n                </li>\n              ))}\n            </ul>\n          </section>\n        ))}\n      </div>\n    </div>\n  );\n}\n","'use client';\n\n/**\n * Public-facing detail view for `/onboarding-guides/<slug>`.\n *\n * Two modes:\n *   - **controlled** (hub SSR): pass `initialData` (a server-fetched guide).\n *   - **self-fetching** (config-only embed): pass `slug` + `guideEndpoint`\n *     (the api route) and the view fetches the guide itself — no host data\n *     layer. (Plain fetch + useEffect, the DeliveryLists pattern.)\n *\n * Everything else flows through lib primitives + the ChatRuntime context\n * (markdown, video warmup, captions, related-card hrefs via\n * `runtime.composeContentUrl`). Optional `MarkdownRenderer` lets hosts swap a\n * renderer with extra plugins.\n */\n\nimport { Fragment, type ComponentType, type ReactNode } from 'react';\nimport { useChatRuntime } from '../../contexts/chat-runtime-context';\nimport { useRouter } from '../../embed-shims';\nimport { useSelfFetch } from '../../hooks/use-self-fetch';\nimport type { VideoTeaser } from '../../types/video-processing';\nimport { resolveContentHref } from '../../utils/content-href';\nimport { buildOgPlaceholderUrl } from '../../utils/og-placeholder';\nimport { EntityAuthorCard } from '../chat/entity-cards/entity-author-card';\nimport { OnboardingGuideCard } from '../chat/entity-cards/onboarding-guide-card';\nimport type { OnboardingGuide } from '../chat/types/entities/onboarding-guide';\nimport { EntityTagBadges } from '../features/entity-tag-badges';\nimport { EntityVideoSection } from '../features/entity-video-section';\nimport { useCaptions } from '../features/use-captions';\nimport { useVideoWarmup } from '../features/use-video-warmup';\nimport { toStripProfile } from '../features/video-bites-shared';\nimport { VideoBitesStrip } from '../features/video-bites-strip';\n// PageShell (max-w-[1920px]) — the guide detail content must share the SAME\n// container sizing as the related-content/FAQ rail the host page renders\n// below it (which uses the wide shell). ArticleDetailLayout (1280px) made\n// the detail block visibly narrower than the rail.\nimport { PageShell } from '../layout/article-detail-layout';\nimport { PageLayout } from '../layout/page-layout';\nimport { ArticleAuthorByline } from '../shared/article-author-byline';\nimport { DetailPageSkeleton } from '../shared/detail-page-skeleton';\nimport { LoadError } from '../ui/error-state';\nimport { RichMarkdownRenderer } from '../ui/markdown';\n\nexport interface OnboardingGuideDetailViewProps {\n  /** Server-fetched guide (controlled / SSR mode). Omit it and pass\n   *  `slug` + `guideEndpoint` for the self-fetching config-only mode. */\n  initialData?: OnboardingGuide;\n  /** Self-fetch: the guide's slug (the host reads it from its route). */\n  slug?: string;\n  /** Self-fetch: builds the GET url for a single guide (the api route).\n   *  e.g. `(s) => \\`/content/api/onboarding-guides/${s}\\``. */\n  guideEndpoint?: (slug: string) => string;\n  related?: OnboardingGuide[];\n  /** Link target for the author name in the metadata grid — the host\n   *  computes it (public author page; absent ⇒ plain text). */\n  authorHref?: string;\n  /** Bio paragraph for the end-of-article author byline. Defaults to the\n   *  guide payload's `author.about` (hubs that hydrate it can omit this). */\n  authorBio?: string | null;\n  /** Byline fallback paragraph when the bio is empty — the host passes its\n   *  platform-aware copy (the lib has no config awareness). Absent ⇒ the\n   *  byline renders nothing below the name when the bio is empty. */\n  fallbackBio?: string | null;\n  /** Optional markdown renderer override. Defaults to lib\n   *  `<RichMarkdownRenderer>`. */\n  MarkdownRenderer?: ComponentType<{ content: string }>;\n  /** Optional per-row related-card renderer override. */\n  renderRelatedCard?: (guide: OnboardingGuide) => ReactNode;\n  /** Back-link target. Defaults to `basePath`. */\n  backHref?: string;\n  /** Back-link label. Defaults to \"Back to Getting Started\". */\n  backLabel?: string;\n  /** Base path the related-card hrefs default to when\n   *  `runtime.composeContentUrl` is not wired. Default `/onboarding-guides`. */\n  basePath?: string;\n  /** Optional slot rendered inside the page chrome, BELOW the article + related\n   *  guides — e.g. the hub's cross-type related-content / FAQ rail. Lets the hub\n   *  mount this view directly (no local wrapper); embedders omit it. */\n  relatedContent?: ReactNode;\n  /** Render the standalone `<PageShell>`. Default true. Pass false when the host\n   *  layout already provides the page container — only the padding box renders,\n   *  avoiding a nested `<main>`. */\n  shell?: boolean;\n}\n\nexport function OnboardingGuideDetailView({\n  authorHref,\n  authorBio,\n  fallbackBio,\n  initialData,\n  slug,\n  guideEndpoint,\n  related = [],\n  MarkdownRenderer = RichMarkdownRenderer,\n  renderRelatedCard,\n  backHref,\n  backLabel = 'Back to Getting Started',\n  basePath = '/onboarding-guides',\n  relatedContent,\n  shell = true,\n}: OnboardingGuideDetailViewProps) {\n  const resolvedBackHref = backHref ?? basePath;\n  const runtime = useChatRuntime();\n  const captions = useCaptions();\n  const router = useRouter();\n  // `shell` true → standalone `<PageShell>`; false → padding-only box (no nested\n  // <main>) for hosts whose layout already provides the container.\n  const renderShell = (node: ReactNode) =>\n    shell ? <PageShell>{node}</PageShell> : <div className=\"page-shell-content\">{node}</div>;\n\n  // Controlled (hub SSR `initialData`) OR self-fetch by slug (config-only embed).\n  const url = initialData ? null : slug && guideEndpoint ? guideEndpoint(slug) : null;\n  const { data: guide, isLoading, error, reload } = useSelfFetch<OnboardingGuide>(url, { initialData });\n\n  // Hooks must run unconditionally — feed them optional-chained values so they\n  // no-op while the guide is still loading.\n  const { ref: videoWarmupRef } = useVideoWarmup<HTMLDivElement>({\n    videoUrl: guide?.main_video_url,\n    supabaseStorageOrigin: runtime?.endpoints.supabaseStorageOrigin,\n  });\n\n  if (error || (!guide && !isLoading)) {\n    return renderShell(<LoadError message=\"Guide not found.\" onRetry={reload} />);\n  }\n  if (!guide) {\n    // Skeleton (not a bare \"Loading…\") for parity with every other shared view —\n    // catalog, roadmap, releases all render a skeleton on first load, so the detail\n    // page shouldn't flash text then content. `bare` + `PageShell` so the loading\n    // state matches the loaded page's full width / padding / min-height.\n    return renderShell(\n      // Match the loaded page's top offset (TitleBlock's\n      // `pt-[var(--spacing-system-l)]`) so content doesn't jump on load.\n      <div className=\"pt-[var(--spacing-system-l)]\">\n        <DetailPageSkeleton bare showImageGallery={false} />\n      </div>,\n    );\n  }\n\n  // Track URLs via the ONE captions configurer (`useCaptions`); same-origin\n  // hosts get the relative `/api/captions/...` default. Zero per-page wiring.\n  const { captionsUrl, highlightCaptionsUrl } = captions.forEntity('onboarding_guide', guide);\n\n  const videoPoster =\n    guide.main_video_thumbnail ||\n    guide.featured_image ||\n    guide.og_image_url ||\n    // `buildOgPlaceholderUrl` always returns a usable string (relative route at\n    // worst), so it's the terminal fallback — no trailing `|| undefined` needed.\n    buildOgPlaceholderUrl(runtime?.endpoints, guide.title, { aspect: 'wide' });\n\n  const defaultRenderRelatedCard = (g: OnboardingGuide) => {\n    const cta = resolveContentHref(runtime?.composeContentUrl, {\n      type: 'onboarding_guide',\n      slug: g.slug,\n      basePath,\n      platforms: g.onboarding_guide_platforms,\n    });\n    return <OnboardingGuideCard guide={g} href={cta.href} targetPlatform={cta.targetPlatform} />;\n  };\n  const renderRelatedCardFn = renderRelatedCard ?? defaultRenderRelatedCard;\n\n  return renderShell(\n    <PageLayout\n      title={guide.title}\n      titleSize=\"h1\"\n      titleWrap\n      backButton={{ label: backLabel, onClick: () => router.push(resolvedBackHref) }}\n    >\n      {/* Tags — flat onboarding_guide_tags[] from entity_tags. */}\n      <EntityTagBadges tags={guide.onboarding_guide_tags} />\n\n      {/* Metadata grid — Section · Step | Published | Author. */}\n      <EntityAuthorCard\n        author={guide.author}\n        authorHref={authorHref}\n        publishedAt={guide.published_at}\n        extraCells={[\n          {\n            value: `${guide.section} · Step ${guide.step_order}`,\n            label: 'Section',\n            uppercase: false,\n          },\n        ]}\n      />\n\n      {/* Video. `main_video_url` (Mux/MP4) and `youtube_url` are independent\n            columns — either populated renders the player. */}\n      {(guide.main_video_url || guide.youtube_url) && (\n        <div ref={videoWarmupRef}>\n          <EntityVideoSection\n            mainVideoUrl={guide.main_video_url}\n            youtubeUrl={guide.youtube_url || undefined}\n            highlightVideoUrl={guide.highlight_video_url}\n            mainVideoPoster={videoPoster}\n            highlightVideoThumbnail={guide.highlight_video_thumbnail || undefined}\n            videoSummary={undefined}\n            videoBites={undefined}\n            title={guide.title}\n            srtContent={guide.srt_content}\n            captionsUrl={captionsUrl}\n            highlightCaptionsUrl={highlightCaptionsUrl}\n            MarkdownRenderer={MarkdownRenderer}\n          />\n        </div>\n      )}\n\n      {/* Markdown body */}\n      {guide.content && (\n        <div className=\"space-y-4\">\n          <MarkdownRenderer content={guide.content} />\n        </div>\n      )}\n\n      {/* Video Bites — unified strip; renders nothing when no published bites. */}\n      <VideoBitesStrip\n        bites={(guide.video_bites as VideoTeaser[] | null) ?? []}\n        filterPublished={true}\n        showTitle={false}\n        profile={toStripProfile(guide.author)}\n        href={`/onboarding-guides/${guide.slug}`}\n      />\n\n      {/* End-of-article author byline (avatar + linked name + bio) — the\n            author DESCRIPTION block every article-shaped detail page renders.\n            Hidden when the guide has no author (the byline returns null). */}\n      <ArticleAuthorByline\n        author={guide.author?.full_name ?? null}\n        avatar={guide.author?.avatar_url}\n        jobTitle={guide.author?.job_title}\n        bio={authorBio ?? guide.author?.about}\n        href={authorHref}\n        fallbackBio={fallbackBio}\n      />\n\n      {/* Related — same-section, ordered by step. */}\n      {related.length > 0 && (\n        <div className=\"space-y-4 border-t border-ods-border pt-8\">\n          <h2 className=\"tracking-[-0.36px] text-ods-text-primary text-h3\">More in {guide.section}</h2>\n          <ul className=\"flex flex-col gap-3\">\n            {related.map(r => (\n              <li key={r.id}>{renderRelatedCardFn(r)}</li>\n            ))}\n          </ul>\n        </div>\n      )}\n\n      {/*\n       * Host slot — cross-type related-content / FAQ rail.\n       *\n       * KEYED DELIBERATELY. This is one member of PageLayout's static children\n       * array, and the only member whose element may be created in a SERVER\n       * component and crossed over the RSC boundary. Static JSX children are\n       * normally exempt from the key warning because `jsxs` runs\n       * `validateChildKeys` and stamps `_store.validated = 1` on each element —\n       * but a slot arriving over the wire is referenced as a lazy chunk wrapper,\n       * so validation marks the WRAPPER and the fulfilled path never copies the\n       * flag onto the revived element. It reaches the reconciler with\n       * `validated: 0, key: null` and warns, blaming PageLayout (the owner of the\n       * enclosing element) rather than anything actually at fault.\n       *\n       * A keyed Fragment emits no DOM, so rendered output is byte-identical.\n       * Do NOT \"fix\" this in PageLayout via `React.Children.toArray` — that would\n       * auto-key every consumer's children and change reconciliation identity for\n       * all of them, and that file carries an explicit FROZEN contract.\n       */}\n      <Fragment key=\"related-content\">{relatedContent}</Fragment>\n    </PageLayout>,\n  );\n}\n","'use client';\n\n/**\n * React Query hooks for Onboarding Guides — PUBLIC reads only.\n *\n * Admin mutations (create/update/delete/publish/stats/save-highlight)\n * stay HUB-side in `hooks/use-onboarding-guides.ts` and import the\n * `onboardingGuideKeys.admin` sub-namespace from this module so the\n * cache namespace `['onboarding-guides']` has a single source of truth.\n *\n * Endpoints (`/api/onboarding-guides*`) are host-supplied — non-Next.js\n * embedders must reverse-proxy the same routes. Same precedent as the\n * tickets list hook.\n */\n\nimport { useQuery } from '@tanstack/react-query';\n\nimport type {\n  OnboardingGuide,\n  OnboardingGuideFilters,\n  OnboardingGuideListResponse,\n  OnboardingGuideSectionSummary,\n} from '../../chat/types/entities/onboarding-guide';\n\n/**\n * Cache key builder for the `['onboarding-guides']` namespace.\n *\n * Includes BOTH public-read sub-keys (`lists`, `list`, `details`,\n * `detail`, `sections`) AND the `admin` sub-namespace. Admin mutations\n * live hub-side but invalidate against this same builder so a single\n * `qc.invalidateQueries({ queryKey: onboardingGuideKeys.all })` from\n * an admin hook also clears the public read cache.\n */\nexport const onboardingGuideKeys = {\n  all: ['onboarding-guides'] as const,\n  lists: () => [...onboardingGuideKeys.all, 'list'] as const,\n  list: (filters: OnboardingGuideFilters) => [...onboardingGuideKeys.lists(), filters] as const,\n  details: () => [...onboardingGuideKeys.all, 'detail'] as const,\n  detail: (slug: string) => [...onboardingGuideKeys.details(), slug] as const,\n  sections: () => [...onboardingGuideKeys.all, 'sections'] as const,\n  admin: {\n    all: ['admin', 'onboarding-guides'] as const,\n    lists: () => ['admin', 'onboarding-guides', 'list'] as const,\n    detail: (slug: string) => ['admin', 'onboarding-guide', slug] as const,\n    stats: () => ['admin', 'onboarding-guides', 'stats'] as const,\n  },\n};\n\nexport function useOnboardingGuides(filters?: OnboardingGuideFilters) {\n  return useQuery({\n    queryKey: onboardingGuideKeys.list(filters || {}),\n    queryFn: async (): Promise<OnboardingGuideListResponse> => {\n      const params = new URLSearchParams();\n      if (filters?.search) params.set('search', filters.search);\n      if (filters?.section) params.set('section', filters.section);\n      if (filters?.limit) params.set('limit', filters.limit.toString());\n      if (filters?.offset) params.set('offset', filters.offset.toString());\n      // Comma-joined, matching the route's `task_ids`-style split. This is the\n      // chat-card loader's path: `ids` ALSO tells the route to drop the\n      // platform scope, so omitting it silently returned a platform-filtered\n      // catalog page under a cache key that claimed to be the id-filtered set.\n      if (filters?.ids?.length) params.set('ids', filters.ids.join(','));\n      const res = await fetch(`/api/onboarding-guides?${params}`);\n      if (!res.ok) throw new Error('Failed to fetch onboarding guides');\n      return (await res.json()) as OnboardingGuideListResponse;\n    },\n  });\n}\n\nexport function useOnboardingGuide(slug: string | undefined) {\n  return useQuery({\n    queryKey: onboardingGuideKeys.detail(slug || ''),\n    queryFn: async (): Promise<OnboardingGuide> => {\n      const res = await fetch(`/api/onboarding-guides/${slug}`);\n      if (!res.ok) throw new Error('Failed to fetch onboarding guide');\n      return (await res.json()) as OnboardingGuide;\n    },\n    enabled: !!slug,\n  });\n}\n\nexport function useOnboardingGuideSections() {\n  return useQuery({\n    queryKey: onboardingGuideKeys.sections(),\n    queryFn: async (): Promise<OnboardingGuideSectionSummary[]> => {\n      const res = await fetch('/api/onboarding-guides/sections');\n      if (!res.ok) throw new Error('Failed to fetch onboarding-guide sections');\n      return (await res.json()) as OnboardingGuideSectionSummary[];\n    },\n    staleTime: 0,\n  });\n}\n"]}
+{"version":3,"sources":["/home/runner/work/openframe-oss-lib/openframe-oss-lib/openframe-frontend-core/dist/chunk-CMQXPD5C.cjs","../src/components/onboarding-guides/onboarding-guides-catalog-view.tsx","../src/components/onboarding-guides/onboarding-guides-catalog-skeleton.tsx","../src/components/onboarding-guides/onboarding-guide-detail-view.tsx","../src/components/onboarding-guides/hooks/use-onboarding-guides.ts"],"names":["jsx","jsxs"],"mappings":"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","file":"/home/runner/work/openframe-oss-lib/openframe-oss-lib/openframe-frontend-core/dist/chunk-CMQXPD5C.cjs","sourcesContent":[null,"'use client';\n\n/**\n * Public-facing catalog view for `/onboarding-guides`.\n *\n * Two data modes:\n *   - **controlled** (hub SSR): pass `initialGuides` + `initialSections`\n *     (server-fetched; section changes re-render the host with new props).\n *   - **self-fetching** (config-only embed): omit the data props and pass\n *     `guidesEndpoint` + `sectionsEndpoint` (the api routes). The view fetches\n *     the guides (refetching on `?section=` change) + the section list itself —\n *     no host data layer. (Plain fetch + useEffect, the DeliveryLists pattern.)\n *\n * The view renders ONLY its body + its OWN controls (the RAG `<DocSearchBar>` +\n * dynamic section pills — onboarding's controls are content-driven, unlike the\n * static search/filter the `DevSectionView` chrome ships). It does NOT render the\n * page chrome: the CALLER wraps it in `<DevSectionPage sectionKey=\"onboarding\">`\n * (hero + back button), exactly like the roadmap / releases / delivery pages — so\n * every dev-center surface composes the same way and the view stays embeddable in\n * tabbed contexts. Card hrefs flow through `runtime.composeContentUrl`.\n */\n\nimport { GraduationCap } from 'lucide-react';\nimport { useMemo, useTransition, type ReactNode } from 'react';\n\nimport { useChatRuntime } from '../../contexts/chat-runtime-context';\nimport { useRouter, useSearchParams } from '../../embed-shims';\nimport { useSelfFetch } from '../../hooks/use-self-fetch';\nimport { resolveContentHref } from '../../utils/content-href';\nimport { OnboardingGuideCard } from '../chat/entity-cards/onboarding-guide-card';\nimport type { OnboardingGuide } from '../chat/types/entities/onboarding-guide';\nimport { DocSearchBar, useDocSearch } from '../shared/doc-search';\nimport { LoadError } from '../ui/error-state';\nimport { FilterPillRow } from '../ui/filter-pill-row';\nimport { OnboardingGuidesCatalogSkeleton } from './onboarding-guides-catalog-skeleton';\n\ntype SectionSummary = { section: string; section_order: number; count: number };\n\nexport interface OnboardingGuidesCatalogViewProps {\n  /** Controlled / SSR: server-fetched guides. Omit + pass `guidesEndpoint`\n   *  for the self-fetching config-only mode. */\n  initialGuides?: OnboardingGuide[];\n  initialSections?: SectionSummary[];\n  initialSection?: string;\n  /** Self-fetch: GET list endpoint (the api route). Appends `?section=`. */\n  guidesEndpoint?: string;\n  /** Self-fetch: GET section-summary endpoint (the api route). */\n  sectionsEndpoint?: string;\n  /** Optional per-row card renderer override. */\n  renderCard?: (guide: OnboardingGuide) => ReactNode;\n  /** Base path the catalog is mounted under (fallback href prefix + `?section=`\n   *  push target). Default `/onboarding-guides`. */\n  basePath?: string;\n}\n\nexport function OnboardingGuidesCatalogView({\n  initialGuides,\n  initialSections,\n  initialSection = '',\n  guidesEndpoint,\n  sectionsEndpoint,\n  renderCard,\n  basePath = '/onboarding-guides',\n}: OnboardingGuidesCatalogViewProps) {\n  const router = useRouter();\n  const searchParams = useSearchParams();\n  const [isPending, startTransition] = useTransition();\n  const runtime = useChatRuntime();\n\n  // Self-fetch only when the host supplied NO data but DID give an endpoint.\n  const selfFetch = initialGuides === undefined && guidesEndpoint !== undefined;\n  // Active section: from the URL when self-fetching, from the prop (host RSC\n  // already read the URL server-side) when controlled.\n  const sectionValue = selfFetch ? (searchParams.get('section') ?? '') : initialSection;\n  const activeSection = sectionValue || 'all';\n\n  // Self-fetch the guides (refetched whenever `?section=` changes — it's folded\n  // into the url) + the section summaries. Controlled mode passes `null` urls so\n  // the hook never fetches. The guides fetch carries the error/retry affordance.\n  const guidesQs = sectionValue ? `?section=${encodeURIComponent(sectionValue)}` : '';\n  const guidesRes = useSelfFetch<{ data?: OnboardingGuide[] }>(\n    selfFetch && guidesEndpoint ? `${guidesEndpoint}${guidesQs}` : null,\n  );\n  const sectionsRes = useSelfFetch<SectionSummary[]>(selfFetch && sectionsEndpoint ? sectionsEndpoint : null);\n\n  // Invariant: `guidesRes.data` is `null` until the first fetch resolves, then\n  // `{ data: [...] }`. The `?.data ?? []` chain collapses never-fetched (null) and\n  // legitimately-empty ([]) to the same `[]` — so the first-load skeleton gate below\n  // keys on the OUTER `guidesRes.data == null` to distinguish them (an empty section\n  // toggle keeps the chrome; only a true cold start shows the full-page skeleton).\n  // Memoised because the `??` fallback minted a NEW array on every\n  // render, which made the memo below re-run every time — i.e. do nothing.\n  const guides = useMemo(() => initialGuides ?? guidesRes.data?.data ?? [], [initialGuides, guidesRes.data?.data]);\n  const sections = useMemo(\n    () => initialSections ?? (Array.isArray(sectionsRes.data) ? sectionsRes.data : []),\n    [initialSections, sectionsRes.data],\n  );\n  const isLoading = selfFetch ? guidesRes.isLoading : false;\n\n  // Section grouping. Data arrives already filtered (server-side `?section=`\n  // for the host, or our `?section=` fetch); this just buckets visible rows.\n  const grouped = useMemo(() => {\n    const map = new Map<string, { section_order: number; guides: OnboardingGuide[] }>();\n    for (const g of guides) {\n      const existing = map.get(g.section);\n      if (existing) {\n        if (g.section_order < existing.section_order) existing.section_order = g.section_order;\n        existing.guides.push(g);\n      } else {\n        map.set(g.section, { section_order: g.section_order, guides: [g] });\n      }\n    }\n    for (const entry of map.values()) {\n      entry.guides.sort((a, b) => a.step_order - b.step_order || a.title.localeCompare(b.title));\n    }\n    return Array.from(map.entries())\n      .map(([section, info]) => ({ section, ...info }))\n      .sort((a, b) => a.section_order - b.section_order || a.section.localeCompare(b.section));\n  }, [guides]);\n\n  const sectionFilterOptions = useMemo(\n    () => [\n      { value: 'all', label: `All (${guides.length})` },\n      ...sections.map(s => ({ value: s.section, label: `${s.section} (${s.count})` })),\n    ],\n    [guides.length, sections],\n  );\n\n  // Section pill change → push `?section=X`. Controlled mode: host RSC\n  // re-fetches. Self-fetch mode: our guides effect re-fetches on the URL change.\n  const setSection = (value: string) => {\n    const params = new URLSearchParams(searchParams.toString());\n    if (value === 'all') {\n      params.delete('section');\n    } else {\n      params.set('section', value);\n    }\n    const qs = params.toString();\n    startTransition(() => {\n      router.push(qs ? `${basePath}?${qs}` : basePath);\n    });\n  };\n\n  // Search bar — scoped to onboarding-guides only via RAG-search `tableIds`.\n  const source = runtime?.source ?? 'openframe';\n  const docSearch = useDocSearch({\n    source,\n    baseRoute: basePath,\n    onNavigate: path => router.push(path),\n    tableIds: ['onboarding-guides'],\n  });\n\n  // Per-row card renderer — runtime-composed href, fallback to relative.\n  const defaultRenderCard = (guide: OnboardingGuide) => {\n    const cta = resolveContentHref(runtime?.composeContentUrl, {\n      type: 'onboarding_guide',\n      slug: guide.slug,\n      basePath,\n      platforms: guide.onboarding_guide_platforms,\n    });\n    return <OnboardingGuideCard guide={guide} href={cta.href} targetPlatform={cta.targetPlatform} size=\"catalog\" />;\n  };\n  const renderCardFn = renderCard ?? defaultRenderCard;\n\n  const preControls = (\n    <div className=\"space-y-4\">\n      <DocSearchBar\n        placeholder=\"Search onboarding guides, releases, case studies…\"\n        query={docSearch.query}\n        onQueryChange={docSearch.setQuery}\n        results={docSearch.results}\n        isLoading={docSearch.isLoading}\n        onResultSelect={docSearch.handleResultSelect}\n        showDropdown={docSearch.keepDropdownOpen}\n      />\n      {sections.length > 0 && (\n        <FilterPillRow\n          label=\"Section\"\n          selectedValue={activeSection}\n          onValueChange={setSection}\n          options={sectionFilterOptions}\n        />\n      )}\n    </div>\n  );\n\n  // A failed guides fetch → a RETRYABLE error (not the indistinguishable-from-\n  // empty \"no guides found\" state) — parity with the sibling self-fetch views.\n  if (selfFetch && guidesRes.error) {\n    return <LoadError message=\"Failed to load onboarding guides.\" onRetry={guidesRes.reload} />;\n  }\n  // Full-page skeleton ONLY on the very first load (no data has loaded yet) — a\n  // later section toggle that legitimately returns ZERO guides keeps the page\n  // chrome (search + section pills) and dims the grid via the className below.\n  if (selfFetch && guidesRes.data == null && isLoading) {\n    return <OnboardingGuidesCatalogSkeleton />;\n  }\n\n  return (\n    <div className=\"flex w-full flex-col gap-10\">\n      {preControls}\n      {guides.length === 0 ? (\n        <div className=\"py-16 text-center\">\n          <GraduationCap className=\"mx-auto mb-4 h-12 w-12 text-ods-text-secondary\" />\n          <h2 className=\"mb-2 text-ods-text-primary text-h3\">No onboarding guides found</h2>\n          <p className=\"text-ods-text-secondary text-h6\">\n            {activeSection !== 'all'\n              ? 'No guides in this section yet.'\n              : \"We're working on the onboarding library. Check back soon.\"}\n          </p>\n        </div>\n      ) : (\n        <div className={isPending || isLoading ? 'space-y-10 opacity-60 transition-opacity' : 'space-y-10'}>\n          {grouped.map(sec => (\n            <section key={sec.section} className=\"space-y-4\">\n              <h2 className=\"flex items-center gap-2 text-ods-text-primary text-h3\">\n                {sec.section}\n                <span className=\"inline-flex items-center justify-center rounded-full bg-ods-text-secondary/20 px-2 py-0.5 text-ods-text-secondary text-h6\">\n                  {sec.guides.length}\n                </span>\n              </h2>\n              {/* HORIZONTAL catalog list — single column so consecutive steps\n                  read top-to-bottom; a grid would visually reorder them. */}\n              <ul className=\"flex flex-col gap-4\">\n                {sec.guides.map(guide => (\n                  <li key={guide.id}>{renderCardFn(guide)}</li>\n                ))}\n              </ul>\n            </section>\n          ))}\n        </div>\n      )}\n    </div>\n  );\n}\n","'use client';\n\nimport { OnboardingGuideCardSkeleton } from '../chat/entity-cards/onboarding-guide-card';\n\n/**\n * Loading skeleton for `/onboarding-guides` — CHROME-LESS, exactly like the\n * loaded `<OnboardingGuidesCatalogView>`. The HOST page owns the\n * `<DevSectionPage sectionKey=\"onboarding\">` shell (hero + back button);\n * this component renders only what replaces the view: the search/pill\n * placeholder block and the section card lists.\n *\n * HISTORY: this used to mount its own `<DevSectionPage>` — nested inside the\n * page's shell that double-rendered the hero + back button during loading\n * (the view was made chrome-less in the page restructure; the skeleton was\n * missed). Keep BOTH chrome-less.\n *\n * Wrapper mirrors the loaded view's `w-full flex flex-col gap-10`; per-card\n * height matches the loaded catalog card so resolve shifts are zero.\n */\nexport function OnboardingGuidesCatalogSkeleton() {\n  return (\n    <div className=\"flex w-full animate-pulse flex-col gap-10\">\n      {/* Search input placeholder — matches `<SearchInput>` h-12 — plus the\n          section pill row (~74 px incl. padding), same as the loaded\n          preControls block. */}\n      <div className=\"space-y-4\">\n        <div className=\"h-12 w-full rounded-md border border-ods-border bg-ods-card\" />\n        <div className=\"flex flex-wrap items-center gap-3 rounded-lg border border-ods-border bg-ods-card p-4\">\n          <div className=\"h-4 w-14 rounded bg-ods-border/60\" />\n          {[0, 1, 2, 3].map(i => (\n            <div key={i} className=\"h-10 w-24 rounded-md border border-ods-border bg-ods-card\" />\n          ))}\n        </div>\n      </div>\n      <div className=\"space-y-10\">\n        {[4, 3, 3].map((cardCount, sectionIdx) => (\n          <section key={sectionIdx} className=\"space-y-4\">\n            <h2 className=\"flex items-center gap-2 tracking-[-0.36px] text-ods-text-primary text-h3\">\n              <span className=\"h-6 w-40 rounded bg-ods-border/70\" />\n              <span className=\"h-5 w-8 rounded-full bg-ods-text-secondary/20\" />\n            </h2>\n            <ul className=\"flex flex-col gap-4\">\n              {Array.from({ length: cardCount }).map((_, cardIdx) => (\n                <li key={cardIdx}>\n                  <OnboardingGuideCardSkeleton size=\"catalog\" />\n                </li>\n              ))}\n            </ul>\n          </section>\n        ))}\n      </div>\n    </div>\n  );\n}\n","'use client';\n\n/**\n * Public-facing detail view for `/onboarding-guides/<slug>`.\n *\n * Two modes:\n *   - **controlled** (hub SSR): pass `initialData` (a server-fetched guide).\n *   - **self-fetching** (config-only embed): pass `slug` + `guideEndpoint`\n *     (the api route) and the view fetches the guide itself — no host data\n *     layer. (Plain fetch + useEffect, the DeliveryLists pattern.)\n *\n * Everything else flows through lib primitives + the ChatRuntime context\n * (markdown, video warmup, captions, related-card hrefs via\n * `runtime.composeContentUrl`). Optional `MarkdownRenderer` lets hosts swap a\n * renderer with extra plugins.\n */\n\nimport { Fragment, type ComponentType, type ReactNode } from 'react';\nimport { useChatRuntime } from '../../contexts/chat-runtime-context';\nimport { useRouter } from '../../embed-shims';\nimport { useSelfFetch } from '../../hooks/use-self-fetch';\nimport type { VideoTeaser } from '../../types/video-processing';\nimport { resolveContentHref } from '../../utils/content-href';\nimport { buildOgPlaceholderUrl } from '../../utils/og-placeholder';\nimport { EntityAuthorCard } from '../chat/entity-cards/entity-author-card';\nimport { OnboardingGuideCard } from '../chat/entity-cards/onboarding-guide-card';\nimport type { OnboardingGuide } from '../chat/types/entities/onboarding-guide';\nimport { EntityTagBadges } from '../features/entity-tag-badges';\nimport { EntityVideoSection } from '../features/entity-video-section';\nimport { useCaptions } from '../features/use-captions';\nimport { useVideoWarmup } from '../features/use-video-warmup';\nimport { toStripProfile } from '../features/video-bites-shared';\nimport { VideoBitesStrip } from '../features/video-bites-strip';\n// PageShell (max-w-[1920px]) — the guide detail content must share the SAME\n// container sizing as the related-content/FAQ rail the host page renders\n// below it (which uses the wide shell). ArticleDetailLayout (1280px) made\n// the detail block visibly narrower than the rail.\nimport { PageShell } from '../layout/article-detail-layout';\nimport { PageLayout } from '../layout/page-layout';\nimport { ArticleAuthorByline } from '../shared/article-author-byline';\nimport { DetailPageSkeleton } from '../shared/detail-page-skeleton';\nimport { LoadError } from '../ui/error-state';\nimport { RichMarkdownRenderer } from '../ui/markdown';\n\nexport interface OnboardingGuideDetailViewProps {\n  /** Server-fetched guide (controlled / SSR mode). Omit it and pass\n   *  `slug` + `guideEndpoint` for the self-fetching config-only mode. */\n  initialData?: OnboardingGuide;\n  /** Self-fetch: the guide's slug (the host reads it from its route). */\n  slug?: string;\n  /** Self-fetch: builds the GET url for a single guide (the api route).\n   *  e.g. `(s) => \\`/content/api/onboarding-guides/${s}\\``. */\n  guideEndpoint?: (slug: string) => string;\n  related?: OnboardingGuide[];\n  /** Link target for the author name in the metadata grid — the host\n   *  computes it (public author page; absent ⇒ plain text). */\n  authorHref?: string;\n  /** Bio paragraph for the end-of-article author byline. Defaults to the\n   *  guide payload's `author.about` (hubs that hydrate it can omit this). */\n  authorBio?: string | null;\n  /** Byline fallback paragraph when the bio is empty — the host passes its\n   *  platform-aware copy (the lib has no config awareness). Absent ⇒ the\n   *  byline renders nothing below the name when the bio is empty. */\n  fallbackBio?: string | null;\n  /** Optional markdown renderer override. Defaults to lib\n   *  `<RichMarkdownRenderer>`. */\n  MarkdownRenderer?: ComponentType<{ content: string }>;\n  /** Optional per-row related-card renderer override. */\n  renderRelatedCard?: (guide: OnboardingGuide) => ReactNode;\n  /** Back-link target. Defaults to `basePath`. */\n  backHref?: string;\n  /** Back-link label. Defaults to \"Back to Getting Started\". */\n  backLabel?: string;\n  /** Base path the related-card hrefs default to when\n   *  `runtime.composeContentUrl` is not wired. Default `/onboarding-guides`. */\n  basePath?: string;\n  /** Optional slot rendered inside the page chrome, BELOW the article + related\n   *  guides — e.g. the hub's cross-type related-content / FAQ rail. Lets the hub\n   *  mount this view directly (no local wrapper); embedders omit it. */\n  relatedContent?: ReactNode;\n  /** Render the standalone `<PageShell>`. Default true. Pass false when the host\n   *  layout already provides the page container — only the padding box renders,\n   *  avoiding a nested `<main>`. */\n  shell?: boolean;\n}\n\nexport function OnboardingGuideDetailView({\n  authorHref,\n  authorBio,\n  fallbackBio,\n  initialData,\n  slug,\n  guideEndpoint,\n  related = [],\n  MarkdownRenderer = RichMarkdownRenderer,\n  renderRelatedCard,\n  backHref,\n  backLabel = 'Back to Getting Started',\n  basePath = '/onboarding-guides',\n  relatedContent,\n  shell = true,\n}: OnboardingGuideDetailViewProps) {\n  const resolvedBackHref = backHref ?? basePath;\n  const runtime = useChatRuntime();\n  const captions = useCaptions();\n  const router = useRouter();\n  // `shell` true → standalone `<PageShell>`; false → padding-only box (no nested\n  // <main>) for hosts whose layout already provides the container.\n  const renderShell = (node: ReactNode) =>\n    shell ? <PageShell>{node}</PageShell> : <div className=\"page-shell-content\">{node}</div>;\n\n  // Controlled (hub SSR `initialData`) OR self-fetch by slug (config-only embed).\n  const url = initialData ? null : slug && guideEndpoint ? guideEndpoint(slug) : null;\n  const { data: guide, isLoading, error, reload } = useSelfFetch<OnboardingGuide>(url, { initialData });\n\n  // Hooks must run unconditionally — feed them optional-chained values so they\n  // no-op while the guide is still loading.\n  const { ref: videoWarmupRef } = useVideoWarmup<HTMLDivElement>({\n    videoUrl: guide?.main_video_url,\n    supabaseStorageOrigin: runtime?.endpoints.supabaseStorageOrigin,\n  });\n\n  if (error || (!guide && !isLoading)) {\n    return renderShell(<LoadError message=\"Guide not found.\" onRetry={reload} />);\n  }\n  if (!guide) {\n    // Skeleton (not a bare \"Loading…\") for parity with every other shared view —\n    // catalog, roadmap, releases all render a skeleton on first load, so the detail\n    // page shouldn't flash text then content. `bare` + `PageShell` so the loading\n    // state matches the loaded page's full width / padding / min-height.\n    return renderShell(\n      // Match the loaded page's top offset (TitleBlock's\n      // `pt-[var(--spacing-system-l)]`) so content doesn't jump on load.\n      <div className=\"pt-[var(--spacing-system-l)]\">\n        <DetailPageSkeleton bare showImageGallery={false} />\n      </div>,\n    );\n  }\n\n  // Track URLs via the ONE captions configurer (`useCaptions`); same-origin\n  // hosts get the relative `/api/captions/...` default. Zero per-page wiring.\n  const { captionsUrl, highlightCaptionsUrl } = captions.forEntity('onboarding_guide', guide);\n\n  const videoPoster =\n    guide.main_video_thumbnail ||\n    guide.featured_image ||\n    guide.og_image_url ||\n    // `buildOgPlaceholderUrl` always returns a usable string (relative route at\n    // worst), so it's the terminal fallback — no trailing `|| undefined` needed.\n    buildOgPlaceholderUrl(runtime?.endpoints, guide.title, { aspect: 'wide' });\n\n  const defaultRenderRelatedCard = (g: OnboardingGuide) => {\n    const cta = resolveContentHref(runtime?.composeContentUrl, {\n      type: 'onboarding_guide',\n      slug: g.slug,\n      basePath,\n      platforms: g.onboarding_guide_platforms,\n    });\n    return <OnboardingGuideCard guide={g} href={cta.href} targetPlatform={cta.targetPlatform} />;\n  };\n  const renderRelatedCardFn = renderRelatedCard ?? defaultRenderRelatedCard;\n\n  return renderShell(\n    <PageLayout\n      title={guide.title}\n      titleSize=\"h1\"\n      titleWrap\n      backButton={{ label: backLabel, onClick: () => router.push(resolvedBackHref) }}\n    >\n      {/* Tags — flat onboarding_guide_tags[] from entity_tags. */}\n      <EntityTagBadges tags={guide.onboarding_guide_tags} />\n\n      {/* Metadata grid — Section · Step | Published | Author. */}\n      <EntityAuthorCard\n        author={guide.author}\n        authorHref={authorHref}\n        publishedAt={guide.published_at}\n        extraCells={[\n          {\n            value: `${guide.section} · Step ${guide.step_order}`,\n            label: 'Section',\n            uppercase: false,\n          },\n        ]}\n      />\n\n      {/* Video. `main_video_url` (Mux/MP4) and `youtube_url` are independent\n            columns — either populated renders the player. */}\n      {(guide.main_video_url || guide.youtube_url) && (\n        <div ref={videoWarmupRef}>\n          <EntityVideoSection\n            mainVideoUrl={guide.main_video_url}\n            youtubeUrl={guide.youtube_url || undefined}\n            highlightVideoUrl={guide.highlight_video_url}\n            mainVideoPoster={videoPoster}\n            highlightVideoThumbnail={guide.highlight_video_thumbnail || undefined}\n            videoSummary={undefined}\n            videoBites={undefined}\n            title={guide.title}\n            srtContent={guide.srt_content}\n            captionsUrl={captionsUrl}\n            highlightCaptionsUrl={highlightCaptionsUrl}\n            MarkdownRenderer={MarkdownRenderer}\n          />\n        </div>\n      )}\n\n      {/* Markdown body */}\n      {guide.content && (\n        <div className=\"space-y-4\">\n          <MarkdownRenderer content={guide.content} />\n        </div>\n      )}\n\n      {/* Video Bites — unified strip; renders nothing when no published bites. */}\n      <VideoBitesStrip\n        bites={(guide.video_bites as VideoTeaser[] | null) ?? []}\n        filterPublished={true}\n        showTitle={false}\n        profile={toStripProfile(guide.author)}\n        href={`/onboarding-guides/${guide.slug}`}\n      />\n\n      {/* End-of-article author byline (avatar + linked name + bio) — the\n            author DESCRIPTION block every article-shaped detail page renders.\n            Hidden when the guide has no author (the byline returns null). */}\n      <ArticleAuthorByline\n        author={guide.author?.full_name ?? null}\n        avatar={guide.author?.avatar_url}\n        jobTitle={guide.author?.job_title}\n        bio={authorBio ?? guide.author?.about}\n        href={authorHref}\n        fallbackBio={fallbackBio}\n      />\n\n      {/* Related — same-section, ordered by step. */}\n      {related.length > 0 && (\n        <div className=\"space-y-4 border-t border-ods-border pt-8\">\n          <h2 className=\"tracking-[-0.36px] text-ods-text-primary text-h3\">More in {guide.section}</h2>\n          <ul className=\"flex flex-col gap-3\">\n            {related.map(r => (\n              <li key={r.id}>{renderRelatedCardFn(r)}</li>\n            ))}\n          </ul>\n        </div>\n      )}\n\n      {/*\n       * Host slot — cross-type related-content / FAQ rail.\n       *\n       * KEYED DELIBERATELY. This is one member of PageLayout's static children\n       * array, and the only member whose element may be created in a SERVER\n       * component and crossed over the RSC boundary. Static JSX children are\n       * normally exempt from the key warning because `jsxs` runs\n       * `validateChildKeys` and stamps `_store.validated = 1` on each element —\n       * but a slot arriving over the wire is referenced as a lazy chunk wrapper,\n       * so validation marks the WRAPPER and the fulfilled path never copies the\n       * flag onto the revived element. It reaches the reconciler with\n       * `validated: 0, key: null` and warns, blaming PageLayout (the owner of the\n       * enclosing element) rather than anything actually at fault.\n       *\n       * A keyed Fragment emits no DOM, so rendered output is byte-identical.\n       * Do NOT \"fix\" this in PageLayout via `React.Children.toArray` — that would\n       * auto-key every consumer's children and change reconciliation identity for\n       * all of them, and that file carries an explicit FROZEN contract.\n       */}\n      <Fragment key=\"related-content\">{relatedContent}</Fragment>\n    </PageLayout>,\n  );\n}\n","'use client';\n\n/**\n * React Query hooks for Onboarding Guides — PUBLIC reads only.\n *\n * Admin mutations (create/update/delete/publish/stats/save-highlight)\n * stay HUB-side in `hooks/use-onboarding-guides.ts` and import the\n * `onboardingGuideKeys.admin` sub-namespace from this module so the\n * cache namespace `['onboarding-guides']` has a single source of truth.\n *\n * Endpoints (`/api/onboarding-guides*`) are host-supplied — non-Next.js\n * embedders must reverse-proxy the same routes. Same precedent as the\n * tickets list hook.\n */\n\nimport { useQuery } from '@tanstack/react-query';\n\nimport type {\n  OnboardingGuide,\n  OnboardingGuideFilters,\n  OnboardingGuideListResponse,\n  OnboardingGuideSectionSummary,\n} from '../../chat/types/entities/onboarding-guide';\n\n/**\n * Cache key builder for the `['onboarding-guides']` namespace.\n *\n * Includes BOTH public-read sub-keys (`lists`, `list`, `details`,\n * `detail`, `sections`) AND the `admin` sub-namespace. Admin mutations\n * live hub-side but invalidate against this same builder so a single\n * `qc.invalidateQueries({ queryKey: onboardingGuideKeys.all })` from\n * an admin hook also clears the public read cache.\n */\nexport const onboardingGuideKeys = {\n  all: ['onboarding-guides'] as const,\n  lists: () => [...onboardingGuideKeys.all, 'list'] as const,\n  list: (filters: OnboardingGuideFilters) => [...onboardingGuideKeys.lists(), filters] as const,\n  details: () => [...onboardingGuideKeys.all, 'detail'] as const,\n  detail: (slug: string) => [...onboardingGuideKeys.details(), slug] as const,\n  sections: () => [...onboardingGuideKeys.all, 'sections'] as const,\n  admin: {\n    all: ['admin', 'onboarding-guides'] as const,\n    lists: () => ['admin', 'onboarding-guides', 'list'] as const,\n    detail: (slug: string) => ['admin', 'onboarding-guide', slug] as const,\n    stats: () => ['admin', 'onboarding-guides', 'stats'] as const,\n  },\n};\n\nexport function useOnboardingGuides(filters?: OnboardingGuideFilters) {\n  return useQuery({\n    queryKey: onboardingGuideKeys.list(filters || {}),\n    queryFn: async (): Promise<OnboardingGuideListResponse> => {\n      const params = new URLSearchParams();\n      if (filters?.search) params.set('search', filters.search);\n      if (filters?.section) params.set('section', filters.section);\n      if (filters?.limit) params.set('limit', filters.limit.toString());\n      if (filters?.offset) params.set('offset', filters.offset.toString());\n      // Comma-joined, matching the route's `task_ids`-style split. This is the\n      // chat-card loader's path: `ids` ALSO tells the route to drop the\n      // platform scope, so omitting it silently returned a platform-filtered\n      // catalog page under a cache key that claimed to be the id-filtered set.\n      if (filters?.ids?.length) params.set('ids', filters.ids.join(','));\n      const res = await fetch(`/api/onboarding-guides?${params}`);\n      if (!res.ok) throw new Error('Failed to fetch onboarding guides');\n      return (await res.json()) as OnboardingGuideListResponse;\n    },\n  });\n}\n\nexport function useOnboardingGuide(slug: string | undefined) {\n  return useQuery({\n    queryKey: onboardingGuideKeys.detail(slug || ''),\n    queryFn: async (): Promise<OnboardingGuide> => {\n      const res = await fetch(`/api/onboarding-guides/${slug}`);\n      if (!res.ok) throw new Error('Failed to fetch onboarding guide');\n      return (await res.json()) as OnboardingGuide;\n    },\n    enabled: !!slug,\n  });\n}\n\nexport function useOnboardingGuideSections() {\n  return useQuery({\n    queryKey: onboardingGuideKeys.sections(),\n    queryFn: async (): Promise<OnboardingGuideSectionSummary[]> => {\n      const res = await fetch('/api/onboarding-guides/sections');\n      if (!res.ok) throw new Error('Failed to fetch onboarding-guide sections');\n      return (await res.json()) as OnboardingGuideSectionSummary[];\n    },\n    staleTime: 0,\n  });\n}\n"]}