@flamingo-stack/openframe-frontend-core 0.0.686-2464.7467.1 → 0.0.686

package/dist/{chunk-IQDUMR3K.cjs.map → chunk-N3I53B5W.cjs.map}

@@ -1 +1 @@
-{"version":3,"sources":["/home/runner/work/openframe-oss-lib/openframe-oss-lib/openframe-frontend-core/dist/chunk-IQDUMR3K.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-IQDUMR3K.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-N3I53B5W.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-N3I53B5W.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-3NBKFWHG.js → chunk-NINO3PI7.js}

@@ -1,10 +1,10 @@
 "use client";
 import {
   DEFAULT_FOLDER_INDEX_FILE
-} from "./chunk-NRH4IHI4.js";
+} from "./chunk-MHTB67ZH.js";
 import {
   scrollElementIntoView
-} from "./chunk-WYB27NKC.js";
+} from "./chunk-JNUL3ZWK.js";
 import {
   cn
 } from "./chunk-OXB6LRBK.js";
@@ -358,4 +358,4 @@ export {
   MultiLevelNavigation,
   MobileNavigationDropdown
 };
-//# sourceMappingURL=chunk-3NBKFWHG.js.map
+//# sourceMappingURL=chunk-NINO3PI7.js.map

package/dist/{chunk-CCLO5R5A.cjs → chunk-P4SBHO7U.cjs}

@@ -5,10 +5,10 @@ var _chunkDMXI5D2Qcjs = require('./chunk-DMXI5D2Q.cjs');
 
 
 
-var _chunkXML4CLL3cjs = require('./chunk-XML4CLL3.cjs');
+var _chunkIBUFFKAKcjs = require('./chunk-IBUFFKAK.cjs');
 
 
-var _chunkIWJEJBMLcjs = require('./chunk-IWJEJBML.cjs');
+var _chunkXF5TJ4P2cjs = require('./chunk-XF5TJ4P2.cjs');
 
 
 var _chunkJU6SBF3Ccjs = require('./chunk-JU6SBF3C.cjs');
@@ -17,12 +17,12 @@ var _chunkJU6SBF3Ccjs = require('./chunk-JU6SBF3C.cjs');
 
 
 
-var _chunkSIAGFCKPcjs = require('./chunk-SIAGFCKP.cjs');
+var _chunkSI77HF4Ucjs = require('./chunk-SI77HF4U.cjs');
 
 
 
 
-var _chunkD2XLLWIUcjs = require('./chunk-D2XLLWIU.cjs');
+var _chunkIJUQQTMVcjs = require('./chunk-IJUQQTMV.cjs');
 
 
 var _chunkSADRZ4YIcjs = require('./chunk-SADRZ4YI.cjs');
@@ -54,7 +54,7 @@ function FaqAccordion({ items, defaultOpenIds = [] }) {
     return /* @__PURE__ */ _jsxruntime.jsxs.call(void 0, 
       "div",
       {
-        id: _chunkSIAGFCKPcjs.faqItemAnchor.call(void 0, item.id),
+        id: _chunkSI77HF4Ucjs.faqItemAnchor.call(void 0, item.id),
         className: "scroll-mt-24 transition-colors hover:bg-ods-bg-hover",
         children: [
           /* @__PURE__ */ _jsxruntime.jsxs.call(void 0, 
@@ -147,7 +147,7 @@ function groupFaqsBySection(faqs) {
     }
     let group = byName.get(name);
     if (!group) {
-      group = { section: name, slug: _chunkSIAGFCKPcjs.faqSectionSlug.call(void 0, name), items: [] };
+      group = { section: name, slug: _chunkSI77HF4Ucjs.faqSectionSlug.call(void 0, name), items: [] };
       byName.set(name, group);
     }
     group.items.push(item);
@@ -190,7 +190,7 @@ function GroupedFaqList({
         }
         if (bestId) setActiveSlug(bestId);
       },
-      { rootMargin: `-${_chunkD2XLLWIUcjs.STICKY_HEADER_OFFSET_PX}px 0px -55% 0px`, threshold: 0 }
+      { rootMargin: `-${_chunkIJUQQTMVcjs.STICKY_HEADER_OFFSET_PX}px 0px -55% 0px`, threshold: 0 }
     );
     for (const group of navGroupsRef.current) {
       const el = group.slug ? document.getElementById(group.slug) : null;
@@ -200,7 +200,7 @@ function GroupedFaqList({
   }, [slugKey]);
   const [hashTarget, setHashTarget] = _react.useState.call(void 0, null);
   _react.useEffect.call(void 0, () => {
-    const refresh = () => setHashTarget(_chunkSIAGFCKPcjs.parseFaqHash.call(void 0, window.location.hash));
+    const refresh = () => setHashTarget(_chunkSI77HF4Ucjs.parseFaqHash.call(void 0, window.location.hash));
     refresh();
     window.addEventListener("hashchange", refresh);
     return () => window.removeEventListener("hashchange", refresh);
@@ -217,7 +217,7 @@ function GroupedFaqList({
   }, [groups, hashTarget]);
   const accordionKeySuffix = _optionalChain([hashTarget, 'optionalAccess', _8 => _8.kind]) === "item" ? `item:${hashTarget.rawId}` : "default";
   const scrollDep = `${groups.length}|` + (_optionalChain([hashTarget, 'optionalAccess', _9 => _9.kind]) === "item" ? `item:${hashTarget.rawId}` : _optionalChain([hashTarget, 'optionalAccess', _10 => _10.kind]) === "section" ? `section:${hashTarget.slug}` : "none");
-  _chunkIWJEJBMLcjs.useScrollToHash.call(void 0, scrollDep, { headerOffset: _chunkD2XLLWIUcjs.STICKY_HEADER_OFFSET_PX });
+  _chunkXF5TJ4P2cjs.useScrollToHash.call(void 0, scrollDep, { headerOffset: _chunkIJUQQTMVcjs.STICKY_HEADER_OFFSET_PX });
   const [pillSyncedHash, setPillSyncedHash] = _react.useState.call(void 0, hashTarget);
   if (pillSyncedHash !== hashTarget) {
     setPillSyncedHash(hashTarget);
@@ -225,8 +225,8 @@ function GroupedFaqList({
   }
   const handleJump = _react.useCallback.call(void 0, (e, slug) => {
     e.preventDefault();
-    _chunkD2XLLWIUcjs.navigateSamePageHash.call(void 0, "#" + slug, {
-      headerOffset: _chunkD2XLLWIUcjs.STICKY_HEADER_OFFSET_PX,
+    _chunkIJUQQTMVcjs.navigateSamePageHash.call(void 0, "#" + slug, {
+      headerOffset: _chunkIJUQQTMVcjs.STICKY_HEADER_OFFSET_PX,
       history: "replace"
     });
   }, []);
@@ -251,7 +251,7 @@ function GroupedFaqList({
     /* @__PURE__ */ _jsxruntime.jsx.call(void 0, "div", { className: "space-y-10", children: groups.map((group) => {
       const key = groupKey(group);
       return /* @__PURE__ */ _jsxruntime.jsxs.call(void 0, "section", { id: _nullishCoalesce(group.slug, () => ( void 0)), className: "scroll-mt-24 space-y-4", children: [
-        group.section && /* @__PURE__ */ _jsxruntime.jsx.call(void 0, CategoryHeading, { className: _chunkSIAGFCKPcjs.SECTION_HEADING_CLASS, children: group.section }),
+        group.section && /* @__PURE__ */ _jsxruntime.jsx.call(void 0, CategoryHeading, { className: _chunkSI77HF4Ucjs.SECTION_HEADING_CLASS, children: group.section }),
         /* @__PURE__ */ _jsxruntime.jsx.call(void 0, 
           FaqAccordion,
           {
@@ -292,7 +292,7 @@ function FaqSection({
   const { data, isLoading, error } = _chunkDMXI5D2Qcjs.useSelfFetch.call(void 0, url, { initialData });
   const faqs = _react.useMemo.call(void 0, () => _nullishCoalesce(_optionalChain([data, 'optionalAccess', _14 => _14.faqs]), () => ( [])), [_optionalChain([data, 'optionalAccess', _15 => _15.faqs])]);
   const groups = _react.useMemo.call(void 0, () => faqs.length > 0 ? groupFaqsBySection(faqs) : [], [faqs]);
-  const headingNode = heading === void 0 ? /* @__PURE__ */ _jsxruntime.jsx.call(void 0, "h2", { className: _chunkSIAGFCKPcjs.SECTION_HEADING_CLASS, children: DEFAULT_HEADING_TEXT }) : heading;
+  const headingNode = heading === void 0 ? /* @__PURE__ */ _jsxruntime.jsx.call(void 0, "h2", { className: _chunkSI77HF4Ucjs.SECTION_HEADING_CLASS, children: DEFAULT_HEADING_TEXT }) : heading;
   if (error) return null;
   if (!isLoading && faqs.length === 0) return null;
   if (isLoading && faqs.length === 0) {
@@ -308,7 +308,7 @@ function FaqSection({
       "script",
       {
         type: "application/ld+json",
-        dangerouslySetInnerHTML: { __html: _chunkD2XLLWIUcjs.serializeJsonLd.call(void 0, schema) }
+        dangerouslySetInnerHTML: { __html: _chunkIJUQQTMVcjs.serializeJsonLd.call(void 0, schema) }
       }
     )
   ] });
@@ -334,7 +334,7 @@ function FaqDocumentPage({
     label: _nullishCoalesce(_optionalChain([backButton, 'optionalAccess', _16 => _16.label]), () => ( "Back to home")),
     onClick: () => router.push(_nullishCoalesce(_optionalChain([backButton, 'optionalAccess', _17 => _17.href]), () => ( "/")))
   };
-  const inner = /* @__PURE__ */ _jsxruntime.jsx.call(void 0, _chunkXML4CLL3cjs.PageLayout, { title, subtitle, backButton: backCfg, titleSize: "h1", titleWrap: true, children: /* @__PURE__ */ _jsxruntime.jsx.call(void 0, 
+  const inner = /* @__PURE__ */ _jsxruntime.jsx.call(void 0, _chunkIBUFFKAKcjs.PageLayout, { title, subtitle, backButton: backCfg, titleSize: "h1", titleWrap: true, children: /* @__PURE__ */ _jsxruntime.jsx.call(void 0, 
     FaqSection,
     {
       initialFaqs,
@@ -347,7 +347,7 @@ function FaqDocumentPage({
       minResults
     }
   ) });
-  return shell ? /* @__PURE__ */ _jsxruntime.jsx.call(void 0, _chunkXML4CLL3cjs.PageShell, { children: inner }) : /* @__PURE__ */ _jsxruntime.jsx.call(void 0, "div", { className: "page-shell-content", children: inner });
+  return shell ? /* @__PURE__ */ _jsxruntime.jsx.call(void 0, _chunkIBUFFKAKcjs.PageShell, { children: inner }) : /* @__PURE__ */ _jsxruntime.jsx.call(void 0, "div", { className: "page-shell-content", children: inner });
 }
 
 
@@ -355,4 +355,4 @@ function FaqDocumentPage({
 
 
 exports.FaqAccordion = FaqAccordion; exports.FaqSection = FaqSection; exports.FaqDocumentPage = FaqDocumentPage;
-//# sourceMappingURL=chunk-CCLO5R5A.cjs.map
+//# sourceMappingURL=chunk-P4SBHO7U.cjs.map

package/dist/{chunk-CCLO5R5A.cjs.map → chunk-P4SBHO7U.cjs.map}

@@ -1 +1 @@
-{"version":3,"sources":["/home/runner/work/openframe-oss-lib/openframe-oss-lib/openframe-frontend-core/dist/chunk-CCLO5R5A.cjs","../src/components/faq/faq-section.tsx","../src/components/faq-accordion.tsx","../src/components/faq/json-ld.ts","../src/components/faq/faq-document-page.tsx"],"names":["useState","jsx"],"mappings":"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","file":"/home/runner/work/openframe-oss-lib/openframe-oss-lib/openframe-frontend-core/dist/chunk-CCLO5R5A.cjs","sourcesContent":[null,"'use client';\n\nimport type React from 'react';\nimport { useCallback, useEffect, useMemo, useRef, useState } from 'react';\nimport { useScrollToHash } from '../../hooks/use-scroll-to-hash';\nimport { useSelfFetch } from '../../hooks/use-self-fetch';\nimport type { Faq } from '../../types/faq';\nimport { cn } from '../../utils/cn';\nimport { serializeJsonLd } from '../../utils/common';\nimport { faqSectionSlug, parseFaqHash, type FaqHashTarget } from '../../utils/faq-anchor';\nimport { navigateSamePageHash, STICKY_HEADER_OFFSET_PX } from '../../utils/same-page-hash-nav';\nimport { buildSuggestionUrl } from '../../utils/suggestion-url';\nimport { FaqAccordion, type FaqItem } from '../faq-accordion';\nimport { SECTION_HEADING_CLASS } from '../layout/page-heading';\nimport { buildFaqJsonLdFromFaqs, type FaqSchemaOptions } from './json-ld';\n\nexport interface FaqSectionProps {\n  /**\n   * SSR hydrate. When provided, the hook skips the first client fetch (per\n   * useSelfFetch contract). The consuming server page resolves FAQs then drills\n   * them into this prop — the lib never re-fetches what the host already gated on.\n   */\n  initialFaqs?: Faq[];\n  /** Both required together for entity-attached FAQs; partial → bare /api/faqs. */\n  entityType?: string;\n  entityId?: number | string;\n  /**\n   * Heading node above the grouped list. `undefined` → default\n   * `<h2>`\"Frequently Asked Questions\". `null` → no heading (the host page\n   * owns the `<h1>`, as the standalone /faqs surface does). A React node lets a\n   * platform drill its own <PageHeading> without the lib referencing platform\n   * state. Also drives category nesting so the document outline stays correct:\n   * `null` → categories render `<h2>` (directly under the page `<h1>`);\n   * otherwise categories render `<h3>` beneath this heading.\n   */\n  heading?: React.ReactNode | null;\n  /** Inject FAQPage schema.org JSON-LD as a <script>. Off by default so embeds\n   *  don't emit duplicate schema. */\n  emitJsonLd?: boolean;\n  /** Overrides for the JSON-LD's name/description/url. */\n  jsonLd?: FaqSchemaOptions;\n  className?: string;\n  /** Maps to /api/faqs `?count=` (the 5-tier fill target). Absent → param\n   *  not sent (server default applies). */\n  minResults?: number;\n  /** Fetch-URL prefix for third-party embeds / reverse proxies\n   *  ('' = same-origin relative). */\n  apiBaseUrl?: string;\n}\n\nconst DEFAULT_HEADING_TEXT = 'Frequently Asked Questions';\n\n/** URL composition shared with RelatedContentSection (`buildSuggestionUrl`)\n *  — byte-identical to the historical `buildFaqsUrl` output when\n *  `minResults`/`apiBaseUrl` are absent. */\nfunction buildFaqsUrl(entityType?: string, entityId?: number | string, minResults?: number, apiBaseUrl = ''): string {\n  return buildSuggestionUrl('/api/faqs', { apiBaseUrl, entityType, entityId, count: minResults });\n}\n\ninterface FaqGroup {\n  /** null → the uncategorized bucket: no heading, no jump pill, rendered last. */\n  section: string | null;\n  slug: string | null;\n  items: FaqItem[];\n}\n\n/** Group FAQs by `faq.section`, preserving the server's first-seen\n *  (display_order) order for BOTH the section order and the rows within each\n *  section. The uncategorized bucket (blank/missing section) sinks to the end\n *  since it renders without a heading. Items carry NO badge here — the `<h2>`\n *  IS the category, so a per-row chip would be redundant. */\nfunction groupFaqsBySection(faqs: Faq[]): FaqGroup[] {\n  // A Map iterates in insertion order, which is exactly the first-seen section\n  // order this function promises — so the Map IS the ordering, and no parallel\n  // array of names (plus a lookup that has to assert the key back) is needed.\n  const byName = new Map<string, FaqGroup>();\n  let uncategorized: FaqGroup | null = null;\n  for (const faq of faqs) {\n    const item: FaqItem = { id: faq.id, question: faq.question, answer: faq.answer };\n    const name = faq.section?.trim();\n    if (!name) {\n      if (!uncategorized) uncategorized = { section: null, slug: null, items: [] };\n      uncategorized.items.push(item);\n      continue;\n    }\n    let group = byName.get(name);\n    if (!group) {\n      group = { section: name, slug: faqSectionSlug(name), items: [] };\n      byName.set(name, group);\n    }\n    group.items.push(item);\n  }\n  const groups = [...byName.values()];\n  if (uncategorized) groups.push(uncategorized);\n  return groups;\n}\n\n/** Map key for the uncategorized bucket — `group.slug` is null for it, so\n *  every per-group map (default-open ids, accordion keys) uses this sentinel\n *  to keep the lookup typed. */\nconst UNCATEGORIZED_KEY = '__uncategorized__';\nconst groupKey = (g: FaqGroup): string => g.slug ?? UNCATEGORIZED_KEY;\n\n/**\n * Grouped FAQ layout: a category jump-nav above stacked `<h2>` category\n * sections (each its own accordion). Isolated into its own component so the\n * scroll-spy hooks only mount in grouped mode — `FaqSection`'s own hooks stay\n * unconditional.\n *\n * The pills are real `<a href=\"#slug\">` anchors (crawlable in-page links,\n * deep-linkable, work without JS); the click handler upgrades the jump to the\n * cancellation-proof `scrollElementIntoView` tween and syncs the URL hash.\n */\nfunction GroupedFaqList({\n  groups,\n  categoryHeadingAs,\n}: {\n  groups: FaqGroup[];\n  /** Heading tag for each category, so the document outline nests correctly\n   *  under whatever owns the heading above this block: `h2` on the standalone\n   *  page (the page owns the `<h1>`), `h3` beneath an embed's `<h2>` title.\n   *  The VISUAL is `SECTION_HEADING_CLASS` either way, so categories look\n   *  identical on every surface. */\n  categoryHeadingAs: 'h2' | 'h3';\n}) {\n  const CategoryHeading = categoryHeadingAs;\n  const navGroups = useMemo(() => groups.filter(g => g.slug), [groups]);\n  const [activeSlug, setActiveSlug] = useState<string | null>(navGroups[0]?.slug ?? null);\n  // Identity-stable key for the section set so the observer re-binds only when\n  // the categories actually change (not on every parent re-render).\n  const slugKey = navGroups.map(g => g.slug).join('|');\n  // Latest `navGroups` for the scroll-spy observer below, which re-observes on\n  // `slugKey` (the section SET) and must not re-run when the array is merely\n  // rebuilt with the same slugs.\n  const navGroupsRef = useRef(navGroups);\n  useEffect(() => {\n    navGroupsRef.current = navGroups;\n  });\n\n  // Scroll-spy: mark the pill for the category currently at the top of the\n  // viewport. rootMargin drops the trigger line just below the sticky header\n  // and ignores the bottom ~55% so \"active\" is the section being read, not the\n  // next one peeking in.\n  useEffect(() => {\n    if (navGroupsRef.current.length < 2) return undefined;\n    const tops = new Map<string, number>();\n    const observer = new IntersectionObserver(\n      entries => {\n        for (const entry of entries) {\n          const id = (entry.target as HTMLElement).id;\n          if (entry.isIntersecting) tops.set(id, entry.boundingClientRect.top);\n          else tops.delete(id);\n        }\n        let bestId: string | null = null;\n        let bestTop = Number.POSITIVE_INFINITY;\n        for (const [id, top] of tops) {\n          if (top < bestTop) {\n            bestTop = top;\n            bestId = id;\n          }\n        }\n        if (bestId) setActiveSlug(bestId);\n      },\n      { rootMargin: `-${STICKY_HEADER_OFFSET_PX}px 0px -55% 0px`, threshold: 0 },\n    );\n    for (const group of navGroupsRef.current) {\n      const el = group.slug ? document.getElementById(group.slug) : null;\n      if (el) observer.observe(el);\n    }\n    return () => observer.disconnect();\n    // slugKey encodes the section set; re-observe only when it changes.\n  }, [slugKey]);\n\n  // ─── Hash dispatch — `/faqs#faq-item-<id>` or `/faqs#faq-<section-slug>` ──\n  // Tracks the current hash so:\n  //   1. an item-kind hash seeds `defaultOpenIds` on the matching accordion\n  //      (auto-expands the cited question);\n  //   2. either kind triggers the cancellation-proof tween scroll with the\n  //      sticky-header offset (native browser hash scroll runs once, ignores\n  //      our offset — re-running the tween puts the target in the right spot).\n  // Listens to `hashchange` so back/forward replays the same behavior. SSR-\n  // safe: initial null state matches the server render; the first effect\n  // tick on the client updates it.\n  const [hashTarget, setHashTarget] = useState<FaqHashTarget | null>(null);\n  useEffect(() => {\n    const refresh = () => setHashTarget(parseFaqHash(window.location.hash));\n    refresh();\n    window.addEventListener('hashchange', refresh);\n    return () => window.removeEventListener('hashchange', refresh);\n  }, []);\n\n  // Per-group default-open set when the hash points at an item. The map key\n  // matches `groupKey(group)` so the render-time lookup is O(1) per group.\n  const defaultOpenByGroupKey = useMemo(() => {\n    if (hashTarget?.kind !== 'item') return null;\n    const targetId = hashTarget.rawId;\n    const result = new Map<string, (string | number)[]>();\n    for (const group of groups) {\n      const hit = group.items.find(i => String(i.id) === targetId);\n      if (hit) result.set(groupKey(group), [hit.id]);\n    }\n    return result.size > 0 ? result : null;\n  }, [groups, hashTarget]);\n\n  // Accordion is uncontrolled — `defaultOpenIds` is only consumed at mount,\n  // so a new item hash needs a remount to honor it. Keying off the item-id\n  // suffix triggers exactly the remount we need (and stays stable when the\n  // hash points at a section, so category navigation never disturbs the\n  // accordion's open state).\n  const accordionKeySuffix = hashTarget?.kind === 'item' ? `item:${hashTarget.rawId}` : 'default';\n\n  // Unified scroll-to-hash: rAF-polls for the target row (outlasts the SWR self-fetch\n  // + Radix accordion expand) and re-fires on `hashchange` — including the synthetic\n  // event `navigateSamePageHash` dispatches for a SOFT same-page chat-card nav (a\n  // host-router `pushState` fires no `hashchange`). The ready-dep keys off BOTH the\n  // loaded `groups` (so a deep-link / refresh scrolls once the self-fetched list\n  // mounts) AND `hashTarget` (so a soft nav re-runs the scroll AFTER the re-render\n  // that remounts + opens the cited row, landing on its FINAL expanded position\n  // instead of racing the uncontrolled accordion's key-remount — the bare-`hashchange`\n  // listener alone fires before the remount and lands on the stale closed position).\n  const scrollDep =\n    `${groups.length}|` +\n    (hashTarget?.kind === 'item'\n      ? `item:${hashTarget.rawId}`\n      : hashTarget?.kind === 'section'\n        ? `section:${hashTarget.slug}`\n        : 'none');\n  useScrollToHash(scrollDep, { headerOffset: STICKY_HEADER_OFFSET_PX });\n\n  // A section hash also lights up its category pill; item hashes leave the pills\n  // untouched so deep-linking a question never disturbs scroll-spy state.\n  //\n  // Adjusted while rendering (React's prop-sync pattern) rather than from an\n  // effect: the pills below read `activeSlug` in THIS render, so an effect\n  // painted the OLD pill lit and then re-rendered to move the highlight. The\n  // initial value matches `hashTarget`'s own initial `null`, so a mount is a\n  // no-op here exactly as the effect's first run was.\n  const [pillSyncedHash, setPillSyncedHash] = useState(hashTarget);\n  if (pillSyncedHash !== hashTarget) {\n    setPillSyncedHash(hashTarget);\n    if (hashTarget?.kind === 'section') setActiveSlug(hashTarget.slug);\n  }\n\n  // Category pill click. `navigateSamePageHash` owns the entire transition:\n  // replaceState → synthetic `hashchange` → `scrollElementIntoView` tween\n  // with `STICKY_HEADER_OFFSET_PX` so the section heading lands BELOW the\n  // sticky category nav on the FIRST tween (covers the same-target\n  // re-click case, where the `hashTarget` effect at L214 is a no-op\n  // because the state reference is equal). For DIFFERENT-target clicks\n  // the helper's synthetic `hashchange` re-fires that effect, which\n  // re-scrolls with the same offset and cancels this tween (singleton)\n  // — both paths land at the same position. The effect is still\n  // required for back/forward + direct URL edits, where the helper\n  // isn't in the call chain.\n  //\n  // `history: 'replace'` matches the pre-helper behavior: category pills\n  // are a TOC, not a navigation step, so the Back button leaves the\n  // FAQ page in one step regardless of how many categories the user\n  // clicked through.\n  const handleJump = useCallback((e: React.MouseEvent<HTMLAnchorElement>, slug: string) => {\n    e.preventDefault();\n    navigateSamePageHash('#' + slug, {\n      headerOffset: STICKY_HEADER_OFFSET_PX,\n      history: 'replace',\n    });\n  }, []);\n\n  return (\n    <div className=\"space-y-8\">\n      {navGroups.length > 1 && (\n        <nav aria-label=\"FAQ categories\" className=\"flex flex-wrap gap-2\">\n          {navGroups.map(group => {\n            const isActive = group.slug === activeSlug;\n            return (\n              <a\n                key={group.slug}\n                href={`#${group.slug}`}\n                aria-current={isActive ? 'true' : undefined}\n                onClick={e => handleJump(e, group.slug as string)}\n                className={cn(\n                  'rounded-full border px-4 py-2 transition-colors text-h6',\n                  isActive\n                    ? 'border-ods-text-primary bg-ods-card text-ods-text-primary'\n                    : 'border-ods-border bg-ods-card text-ods-text-secondary hover:border-ods-text-secondary hover:text-ods-text-primary',\n                )}\n              >\n                {group.section}\n              </a>\n            );\n          })}\n        </nav>\n      )}\n      <div className=\"space-y-10\">\n        {groups.map(group => {\n          const key = groupKey(group);\n          return (\n            <section key={key} id={group.slug ?? undefined} className=\"scroll-mt-24 space-y-4\">\n              {group.section && <CategoryHeading className={SECTION_HEADING_CLASS}>{group.section}</CategoryHeading>}\n              <FaqAccordion\n                // Re-key on item-hash changes so the remount picks up the new\n                // `defaultOpenIds` (the accordion is uncontrolled). Stable for\n                // section hashes — category navigation doesn't disturb state.\n                key={`${key}:${accordionKeySuffix}`}\n                items={group.items}\n                defaultOpenIds={defaultOpenByGroupKey?.get(key)}\n              />\n            </section>\n          );\n        })}\n      </div>\n    </div>\n  );\n}\n\nfunction FaqSkeleton() {\n  return (\n    <div className=\"animate-pulse space-y-8\">\n      <div className=\"h-12 w-2/3 rounded bg-ods-border md:h-14\" />\n      <div className=\"w-full divide-y divide-ods-border overflow-hidden rounded-md border border-ods-border bg-transparent\">\n        {Array.from({ length: 8 }).map((_, idx) => (\n          <div key={idx} className=\"flex items-center justify-between gap-6 px-6 py-4 md:gap-10\">\n            <div className=\"h-6 w-5/6 rounded bg-ods-border\" />\n            <div className=\"size-6 rounded bg-ods-border\" />\n          </div>\n        ))}\n      </div>\n    </div>\n  );\n}\n\ninterface FaqsResponse {\n  faqs: Faq[];\n}\n\n/**\n * The FAQ display surface — ONE rendering on every host: the list grouped by\n * `faq.section` (each category a heading + its own accordion, with a category\n * jump-nav once there are 2+ categories). There is no flat/ungrouped mode and\n * no page-vs-embedded shell fork; the standalone /faqs page and every embed\n * render through this single path, so they cannot drift.\n *\n * - Standalone /faqs page: pass `initialFaqs` (SSR) + `heading={null}` (the\n *   page owns the <h1>) + `emitJsonLd` with `jsonLd` overrides for SEO.\n * - Per-entity embed: pass `entityType` + `entityId` (no `initialFaqs`); the\n *   hook self-fetches `GET /api/faqs`, and `heading` is this block's own <h2>.\n *\n * CONTRACT: the consuming app MUST implement `GET /api/faqs`. On a fetch error\n * (or zero FAQs) the component renders nothing so the host page isn't\n * disfigured. The host always supplies the page shell — this renders a bare\n * <section>.\n */\nexport function FaqSection({\n  initialFaqs,\n  entityType,\n  entityId,\n  heading,\n  emitJsonLd = false,\n  jsonLd,\n  className,\n  minResults,\n  apiBaseUrl = '',\n}: FaqSectionProps) {\n  const url = buildFaqsUrl(entityType, entityId, minResults, apiBaseUrl);\n  // Memoized — useSelfFetch re-syncs on [initialData]; a fresh per-render\n  // wrapper object would setState-loop under re-rendering parents.\n  const initialData = useMemo<FaqsResponse | undefined>(\n    () => (initialFaqs ? { faqs: initialFaqs } : undefined),\n    [initialFaqs],\n  );\n  const { data, isLoading, error } = useSelfFetch<FaqsResponse>(url, { initialData });\n\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 faqs = useMemo(() => data?.faqs ?? [], [data?.faqs]);\n  // Grouped before the early returns so the hook order stays stable.\n  const groups = useMemo(() => (faqs.length > 0 ? groupFaqsBySection(faqs) : []), [faqs]);\n\n  // `undefined` → default <h2> title; `null` → the host page owns the <h1>, so\n  // no title renders here. `heading === null` also makes the category headings\n  // <h2> (directly under the page <h1>); otherwise they nest as <h3>.\n  const headingNode =\n    heading === undefined ? <h2 className={SECTION_HEADING_CLASS}>{DEFAULT_HEADING_TEXT}</h2> : heading;\n\n  // Degrade silently — never show an error banner or an empty section shell\n  // where FAQs would be (host pages and the standalone surface both rely on it).\n  if (error) return null;\n  if (!isLoading && faqs.length === 0) return null;\n  if (isLoading && faqs.length === 0) {\n    return (\n      <div className={className}>\n        <FaqSkeleton />\n      </div>\n    );\n  }\n\n  const schema = emitJsonLd ? buildFaqJsonLdFromFaqs(faqs, jsonLd) : null;\n\n  return (\n    <>\n      <section className={className ?? 'space-y-10'}>\n        {headingNode}\n        <GroupedFaqList groups={groups} categoryHeadingAs={heading === null ? 'h2' : 'h3'} />\n      </section>\n      {schema && (\n        <script\n          type=\"application/ld+json\"\n          // serializeJsonLd, NOT raw JSON.stringify — FAQ answers are\n          // admin-entered; an embedded \"</script>\" must not break the tag.\n          dangerouslySetInnerHTML={{ __html: serializeJsonLd(schema) }}\n        />\n      )}\n    </>\n  );\n}\n","'use client';\n\nimport { useState } from 'react';\nimport { cn } from '../utils/cn';\nimport { faqItemAnchor } from '../utils/faq-anchor';\nimport { Chevron02DownIcon } from './icons-v2-generated/arrows/chevron-02-down-icon';\n\nexport interface FaqItem {\n  id: number | string;\n  question: string;\n  answer: string;\n}\n\ninterface FaqAccordionProps {\n  items: FaqItem[];\n  defaultOpenIds?: (number | string)[];\n}\n\nexport function FaqAccordion({ items, defaultOpenIds = [] }: FaqAccordionProps) {\n  const [openSet, setOpenSet] = useState<Set<string | number>>(new Set(defaultOpenIds));\n\n  const toggle = (id: string | number) => {\n    setOpenSet(prev => {\n      const next = new Set(prev);\n      if (next.has(id)) next.delete(id);\n      else next.add(id);\n      return next;\n    });\n  };\n\n  return (\n    <div className=\"divide-y divide-ods-border overflow-hidden rounded-md border border-ods-border bg-transparent\">\n      {items.map(item => {\n        const isOpen = openSet.has(item.id);\n\n        return (\n          <div\n            key={item.id}\n            // Per-row anchor — chat citation chips (`/faqs#faq-item-<id>`) land\n            // here via native browser hash scroll AND via `FaqSection`'s tween\n            // dispatch. `scroll-mt-24` keeps the row header below the 96px\n            // sticky nav offset (matches `<section>`'s scroll-margin for\n            // category anchors).\n            id={faqItemAnchor(item.id)}\n            className=\"scroll-mt-24 transition-colors hover:bg-ods-bg-hover\"\n          >\n            {/* Header */}\n            <div\n              role=\"button\"\n              tabIndex={0}\n              onClick={() => toggle(item.id)}\n              onKeyDown={e => {\n                if (e.key === 'Enter' || e.key === ' ') {\n                  e.preventDefault();\n                  toggle(item.id);\n                }\n              }}\n              aria-expanded={isOpen}\n              className=\"flex w-full cursor-pointer items-center gap-6 px-6 py-4 text-left transition-colors focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-inset focus-visible:ring-ods-focus md:gap-10\"\n            >\n              <h3 className=\"min-w-0 flex-1 break-words\">{item.question}</h3>\n              <Chevron02DownIcon\n                aria-hidden=\"true\"\n                size={24}\n                className={cn(\n                  'shrink-0 text-ods-text-primary transition-transform duration-300',\n                  isOpen && 'rotate-180',\n                )}\n              />\n            </div>\n            {/* Content wrapper. Collapses with the grid 1fr->0fr transition the\n                rest of the design system uses (see AnnouncementBar) rather than\n                an animated max-height: measuring `scrollHeight` needed a hook\n                PER ROW, which meant calling hooks inside `items.map` — the hook\n                order then changed whenever `items` did. Grid needs no\n                measurement, and it animates correctly when an answer's height\n                changes after mount. */}\n            <div\n              className=\"grid transition-[grid-template-rows,opacity] duration-300 ease-in-out motion-reduce:transition-none\"\n              style={{ gridTemplateRows: isOpen ? '1fr' : '0fr', opacity: isOpen ? 1 : 0 }}\n            >\n              {/* break-words: FAQ answers render as plain text, so a long URL or\n                  token has no wrap opportunity — and the row is overflow-hidden,\n                  which would CLIP it past the viewport on mobile. Mirrors the\n                  markdown-renderer overflow-wrap fix. */}\n              <div className=\"overflow-hidden\">\n                <div className=\"break-words px-6 pb-4 text-ods-text-primary text-h4\">{item.answer}</div>\n              </div>\n            </div>\n          </div>\n        );\n      })}\n    </div>\n  );\n}\n","/**\n * Pure FAQ JSON-LD builder. No React, no client-only deps — safe to import from\n * Server Components via the `./components/faq` subpath export. (Do NOT import\n * through the root `./components` barrel — that barrel is `\"use client\"` and\n * dragging it into a Server Component would force the client graph into the\n * server.)\n *\n * The hub used to harcode `name`/`description` here for OpenMSP; in the lib we\n * accept overrides so every embedder can supply its own platform branding.\n */\nimport type { Faq } from '../../types/faq';\n\nexport interface FaqSchemaOptions {\n  name?: string;\n  description?: string;\n  url?: string;\n}\n\nconst DEFAULT_NAME = 'Frequently Asked Questions';\nconst DEFAULT_DESCRIPTION = 'Answers to common questions.';\n\nexport function baseFaqSchema(opts: FaqSchemaOptions = {}) {\n  return {\n    '@context': 'https://schema.org',\n    '@type': 'FAQPage',\n    name: opts.name ?? DEFAULT_NAME,\n    description: opts.description ?? DEFAULT_DESCRIPTION,\n    ...(opts.url ? { url: opts.url } : {}),\n  } as const;\n}\n\nexport function buildFaqJsonLdFromFaqs(faqs: Faq[], opts: FaqSchemaOptions = {}) {\n  return {\n    ...baseFaqSchema(opts),\n    mainEntity: faqs.map(faq => ({\n      '@type': 'Question',\n      name: faq.question,\n      acceptedAnswer: {\n        '@type': 'Answer',\n        text: faq.answer,\n      },\n    })),\n  } as const;\n}\n","'use client';\n\n/**\n * FaqDocumentPage — the full `/faqs` page with chrome, so embedders drop in\n * ONE component instead of hand-assembling `PageShell` + `PageLayout` around\n * the bare `<FaqSection>`. Mirrors `LegalDocumentPage` / `DevSectionPage`: the\n * page-level layout lives in the lib, the host page is a thin wrapper that\n * passes only config + the SSR-resolved data.\n *\n * HERO: the title + subtitle route through the canonical (frozen) `PageLayout`\n * `TitleBlock` with `titleSize=\"h1\"` — the unified Help Center header (the\n * `TitleBlock` element is always an `<h1>`; `titleSize` only sets its typography,\n * here `text-h1`). The page owns that `<h1>`, so `<FaqSection heading={null}>`\n * nests its category headings as `<h2>`/`<h3>` (the SEO-recommended FAQ document\n * outline).\n *\n * DATA: pass `initialFaqs` (SSR-resolved, platform-scoped) so `FaqSection`\n * skips its client self-fetch — the standalone page's static platform-only\n * contract. Omit it for embeds that want the self-fetching `/api/faqs`\n * suggestion-fill instead.\n */\n\nimport { useRouter } from '../../embed-shims/next-navigation';\nimport type { Faq } from '../../types/faq';\nimport { PageShell, PageLayout } from '../ui';\nimport { FaqSection } from './faq-section';\nimport type { FaqSchemaOptions } from './json-ld';\n\nexport interface FaqDocumentPageProps {\n  /** Page title (frozen `PageLayout` `TitleBlock`). Default \"Frequently Asked Questions\". */\n  title?: string;\n  /** Subtitle under the title. */\n  subtitle?: string;\n  /** Back-button config — same pattern as `DevSectionPage` / `LegalDocumentPage`.\n   *  Pass `false` to hide. Default `{ label: 'Back to home', href: '/' }`. */\n  backButton?: { label?: string; href?: string } | false;\n  /** Render the standalone `<PageShell>` (own `<main>` + bg + max-width). Default\n   *  true. Pass false when the host layout already provides the page container\n   *  (e.g. openframe-frontend's `AppLayout` `<main>`) — only the padding box\n   *  renders, avoiding a nested `<main>`. */\n  shell?: boolean;\n  /** SSR-hydrate `FaqSection` (skips the client fetch — the platform-only\n   *  contract for the standalone page). Omit for self-fetching embeds. */\n  initialFaqs?: Faq[];\n  /** Emit FAQPage schema.org JSON-LD (forwarded to `FaqSection`). Off by\n   *  default so embeds don't emit duplicate schema. */\n  emitJsonLd?: boolean;\n  /** JSON-LD name/description/url overrides (forwarded to `FaqSection`). */\n  jsonLd?: FaqSchemaOptions;\n  /** Base URL `FaqSection` appends `/api/faqs` to (reverse-proxy embedders). */\n  apiBaseUrl?: string;\n  /** Optional entity scoping forwarded to `FaqSection`. */\n  entityType?: string;\n  entityId?: number | string;\n  /** Minimum FAQ count before the section renders (forwarded to `FaqSection`). */\n  minResults?: number;\n}\n\nexport function FaqDocumentPage({\n  title = 'Frequently Asked Questions',\n  subtitle,\n  backButton,\n  initialFaqs,\n  emitJsonLd,\n  jsonLd,\n  apiBaseUrl,\n  entityType,\n  entityId,\n  minResults,\n  shell = true,\n}: FaqDocumentPageProps) {\n  const router = useRouter();\n\n  // Back-button config — mirrors LegalDocumentPage / DevSectionPage. Hide\n  // entirely when the caller passes `false` (embed-mode where the host owns\n  // nav chrome).\n  const backCfg =\n    backButton === false\n      ? undefined\n      : {\n          label: backButton?.label ?? 'Back to home',\n          onClick: () => router.push(backButton?.href ?? '/'),\n        };\n\n  const inner = (\n    <PageLayout title={title} subtitle={subtitle} backButton={backCfg} titleSize=\"h1\" titleWrap>\n      <FaqSection\n        initialFaqs={initialFaqs}\n        heading={null}\n        emitJsonLd={emitJsonLd}\n        jsonLd={jsonLd}\n        apiBaseUrl={apiBaseUrl}\n        entityType={entityType}\n        entityId={entityId}\n        minResults={minResults}\n      />\n    </PageLayout>\n  );\n\n  return shell ? <PageShell>{inner}</PageShell> : <div className=\"page-shell-content\">{inner}</div>;\n}\n"]}
+{"version":3,"sources":["/home/runner/work/openframe-oss-lib/openframe-oss-lib/openframe-frontend-core/dist/chunk-P4SBHO7U.cjs","../src/components/faq/faq-section.tsx","../src/components/faq-accordion.tsx","../src/components/faq/json-ld.ts","../src/components/faq/faq-document-page.tsx"],"names":["useState","jsx"],"mappings":"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","file":"/home/runner/work/openframe-oss-lib/openframe-oss-lib/openframe-frontend-core/dist/chunk-P4SBHO7U.cjs","sourcesContent":[null,"'use client';\n\nimport type React from 'react';\nimport { useCallback, useEffect, useMemo, useRef, useState } from 'react';\nimport { useScrollToHash } from '../../hooks/use-scroll-to-hash';\nimport { useSelfFetch } from '../../hooks/use-self-fetch';\nimport type { Faq } from '../../types/faq';\nimport { cn } from '../../utils/cn';\nimport { serializeJsonLd } from '../../utils/common';\nimport { faqSectionSlug, parseFaqHash, type FaqHashTarget } from '../../utils/faq-anchor';\nimport { navigateSamePageHash, STICKY_HEADER_OFFSET_PX } from '../../utils/same-page-hash-nav';\nimport { buildSuggestionUrl } from '../../utils/suggestion-url';\nimport { FaqAccordion, type FaqItem } from '../faq-accordion';\nimport { SECTION_HEADING_CLASS } from '../layout/page-heading';\nimport { buildFaqJsonLdFromFaqs, type FaqSchemaOptions } from './json-ld';\n\nexport interface FaqSectionProps {\n  /**\n   * SSR hydrate. When provided, the hook skips the first client fetch (per\n   * useSelfFetch contract). The consuming server page resolves FAQs then drills\n   * them into this prop — the lib never re-fetches what the host already gated on.\n   */\n  initialFaqs?: Faq[];\n  /** Both required together for entity-attached FAQs; partial → bare /api/faqs. */\n  entityType?: string;\n  entityId?: number | string;\n  /**\n   * Heading node above the grouped list. `undefined` → default\n   * `<h2>`\"Frequently Asked Questions\". `null` → no heading (the host page\n   * owns the `<h1>`, as the standalone /faqs surface does). A React node lets a\n   * platform drill its own <PageHeading> without the lib referencing platform\n   * state. Also drives category nesting so the document outline stays correct:\n   * `null` → categories render `<h2>` (directly under the page `<h1>`);\n   * otherwise categories render `<h3>` beneath this heading.\n   */\n  heading?: React.ReactNode | null;\n  /** Inject FAQPage schema.org JSON-LD as a <script>. Off by default so embeds\n   *  don't emit duplicate schema. */\n  emitJsonLd?: boolean;\n  /** Overrides for the JSON-LD's name/description/url. */\n  jsonLd?: FaqSchemaOptions;\n  className?: string;\n  /** Maps to /api/faqs `?count=` (the 5-tier fill target). Absent → param\n   *  not sent (server default applies). */\n  minResults?: number;\n  /** Fetch-URL prefix for third-party embeds / reverse proxies\n   *  ('' = same-origin relative). */\n  apiBaseUrl?: string;\n}\n\nconst DEFAULT_HEADING_TEXT = 'Frequently Asked Questions';\n\n/** URL composition shared with RelatedContentSection (`buildSuggestionUrl`)\n *  — byte-identical to the historical `buildFaqsUrl` output when\n *  `minResults`/`apiBaseUrl` are absent. */\nfunction buildFaqsUrl(entityType?: string, entityId?: number | string, minResults?: number, apiBaseUrl = ''): string {\n  return buildSuggestionUrl('/api/faqs', { apiBaseUrl, entityType, entityId, count: minResults });\n}\n\ninterface FaqGroup {\n  /** null → the uncategorized bucket: no heading, no jump pill, rendered last. */\n  section: string | null;\n  slug: string | null;\n  items: FaqItem[];\n}\n\n/** Group FAQs by `faq.section`, preserving the server's first-seen\n *  (display_order) order for BOTH the section order and the rows within each\n *  section. The uncategorized bucket (blank/missing section) sinks to the end\n *  since it renders without a heading. Items carry NO badge here — the `<h2>`\n *  IS the category, so a per-row chip would be redundant. */\nfunction groupFaqsBySection(faqs: Faq[]): FaqGroup[] {\n  // A Map iterates in insertion order, which is exactly the first-seen section\n  // order this function promises — so the Map IS the ordering, and no parallel\n  // array of names (plus a lookup that has to assert the key back) is needed.\n  const byName = new Map<string, FaqGroup>();\n  let uncategorized: FaqGroup | null = null;\n  for (const faq of faqs) {\n    const item: FaqItem = { id: faq.id, question: faq.question, answer: faq.answer };\n    const name = faq.section?.trim();\n    if (!name) {\n      if (!uncategorized) uncategorized = { section: null, slug: null, items: [] };\n      uncategorized.items.push(item);\n      continue;\n    }\n    let group = byName.get(name);\n    if (!group) {\n      group = { section: name, slug: faqSectionSlug(name), items: [] };\n      byName.set(name, group);\n    }\n    group.items.push(item);\n  }\n  const groups = [...byName.values()];\n  if (uncategorized) groups.push(uncategorized);\n  return groups;\n}\n\n/** Map key for the uncategorized bucket — `group.slug` is null for it, so\n *  every per-group map (default-open ids, accordion keys) uses this sentinel\n *  to keep the lookup typed. */\nconst UNCATEGORIZED_KEY = '__uncategorized__';\nconst groupKey = (g: FaqGroup): string => g.slug ?? UNCATEGORIZED_KEY;\n\n/**\n * Grouped FAQ layout: a category jump-nav above stacked `<h2>` category\n * sections (each its own accordion). Isolated into its own component so the\n * scroll-spy hooks only mount in grouped mode — `FaqSection`'s own hooks stay\n * unconditional.\n *\n * The pills are real `<a href=\"#slug\">` anchors (crawlable in-page links,\n * deep-linkable, work without JS); the click handler upgrades the jump to the\n * cancellation-proof `scrollElementIntoView` tween and syncs the URL hash.\n */\nfunction GroupedFaqList({\n  groups,\n  categoryHeadingAs,\n}: {\n  groups: FaqGroup[];\n  /** Heading tag for each category, so the document outline nests correctly\n   *  under whatever owns the heading above this block: `h2` on the standalone\n   *  page (the page owns the `<h1>`), `h3` beneath an embed's `<h2>` title.\n   *  The VISUAL is `SECTION_HEADING_CLASS` either way, so categories look\n   *  identical on every surface. */\n  categoryHeadingAs: 'h2' | 'h3';\n}) {\n  const CategoryHeading = categoryHeadingAs;\n  const navGroups = useMemo(() => groups.filter(g => g.slug), [groups]);\n  const [activeSlug, setActiveSlug] = useState<string | null>(navGroups[0]?.slug ?? null);\n  // Identity-stable key for the section set so the observer re-binds only when\n  // the categories actually change (not on every parent re-render).\n  const slugKey = navGroups.map(g => g.slug).join('|');\n  // Latest `navGroups` for the scroll-spy observer below, which re-observes on\n  // `slugKey` (the section SET) and must not re-run when the array is merely\n  // rebuilt with the same slugs.\n  const navGroupsRef = useRef(navGroups);\n  useEffect(() => {\n    navGroupsRef.current = navGroups;\n  });\n\n  // Scroll-spy: mark the pill for the category currently at the top of the\n  // viewport. rootMargin drops the trigger line just below the sticky header\n  // and ignores the bottom ~55% so \"active\" is the section being read, not the\n  // next one peeking in.\n  useEffect(() => {\n    if (navGroupsRef.current.length < 2) return undefined;\n    const tops = new Map<string, number>();\n    const observer = new IntersectionObserver(\n      entries => {\n        for (const entry of entries) {\n          const id = (entry.target as HTMLElement).id;\n          if (entry.isIntersecting) tops.set(id, entry.boundingClientRect.top);\n          else tops.delete(id);\n        }\n        let bestId: string | null = null;\n        let bestTop = Number.POSITIVE_INFINITY;\n        for (const [id, top] of tops) {\n          if (top < bestTop) {\n            bestTop = top;\n            bestId = id;\n          }\n        }\n        if (bestId) setActiveSlug(bestId);\n      },\n      { rootMargin: `-${STICKY_HEADER_OFFSET_PX}px 0px -55% 0px`, threshold: 0 },\n    );\n    for (const group of navGroupsRef.current) {\n      const el = group.slug ? document.getElementById(group.slug) : null;\n      if (el) observer.observe(el);\n    }\n    return () => observer.disconnect();\n    // slugKey encodes the section set; re-observe only when it changes.\n  }, [slugKey]);\n\n  // ─── Hash dispatch — `/faqs#faq-item-<id>` or `/faqs#faq-<section-slug>` ──\n  // Tracks the current hash so:\n  //   1. an item-kind hash seeds `defaultOpenIds` on the matching accordion\n  //      (auto-expands the cited question);\n  //   2. either kind triggers the cancellation-proof tween scroll with the\n  //      sticky-header offset (native browser hash scroll runs once, ignores\n  //      our offset — re-running the tween puts the target in the right spot).\n  // Listens to `hashchange` so back/forward replays the same behavior. SSR-\n  // safe: initial null state matches the server render; the first effect\n  // tick on the client updates it.\n  const [hashTarget, setHashTarget] = useState<FaqHashTarget | null>(null);\n  useEffect(() => {\n    const refresh = () => setHashTarget(parseFaqHash(window.location.hash));\n    refresh();\n    window.addEventListener('hashchange', refresh);\n    return () => window.removeEventListener('hashchange', refresh);\n  }, []);\n\n  // Per-group default-open set when the hash points at an item. The map key\n  // matches `groupKey(group)` so the render-time lookup is O(1) per group.\n  const defaultOpenByGroupKey = useMemo(() => {\n    if (hashTarget?.kind !== 'item') return null;\n    const targetId = hashTarget.rawId;\n    const result = new Map<string, (string | number)[]>();\n    for (const group of groups) {\n      const hit = group.items.find(i => String(i.id) === targetId);\n      if (hit) result.set(groupKey(group), [hit.id]);\n    }\n    return result.size > 0 ? result : null;\n  }, [groups, hashTarget]);\n\n  // Accordion is uncontrolled — `defaultOpenIds` is only consumed at mount,\n  // so a new item hash needs a remount to honor it. Keying off the item-id\n  // suffix triggers exactly the remount we need (and stays stable when the\n  // hash points at a section, so category navigation never disturbs the\n  // accordion's open state).\n  const accordionKeySuffix = hashTarget?.kind === 'item' ? `item:${hashTarget.rawId}` : 'default';\n\n  // Unified scroll-to-hash: rAF-polls for the target row (outlasts the SWR self-fetch\n  // + Radix accordion expand) and re-fires on `hashchange` — including the synthetic\n  // event `navigateSamePageHash` dispatches for a SOFT same-page chat-card nav (a\n  // host-router `pushState` fires no `hashchange`). The ready-dep keys off BOTH the\n  // loaded `groups` (so a deep-link / refresh scrolls once the self-fetched list\n  // mounts) AND `hashTarget` (so a soft nav re-runs the scroll AFTER the re-render\n  // that remounts + opens the cited row, landing on its FINAL expanded position\n  // instead of racing the uncontrolled accordion's key-remount — the bare-`hashchange`\n  // listener alone fires before the remount and lands on the stale closed position).\n  const scrollDep =\n    `${groups.length}|` +\n    (hashTarget?.kind === 'item'\n      ? `item:${hashTarget.rawId}`\n      : hashTarget?.kind === 'section'\n        ? `section:${hashTarget.slug}`\n        : 'none');\n  useScrollToHash(scrollDep, { headerOffset: STICKY_HEADER_OFFSET_PX });\n\n  // A section hash also lights up its category pill; item hashes leave the pills\n  // untouched so deep-linking a question never disturbs scroll-spy state.\n  //\n  // Adjusted while rendering (React's prop-sync pattern) rather than from an\n  // effect: the pills below read `activeSlug` in THIS render, so an effect\n  // painted the OLD pill lit and then re-rendered to move the highlight. The\n  // initial value matches `hashTarget`'s own initial `null`, so a mount is a\n  // no-op here exactly as the effect's first run was.\n  const [pillSyncedHash, setPillSyncedHash] = useState(hashTarget);\n  if (pillSyncedHash !== hashTarget) {\n    setPillSyncedHash(hashTarget);\n    if (hashTarget?.kind === 'section') setActiveSlug(hashTarget.slug);\n  }\n\n  // Category pill click. `navigateSamePageHash` owns the entire transition:\n  // replaceState → synthetic `hashchange` → `scrollElementIntoView` tween\n  // with `STICKY_HEADER_OFFSET_PX` so the section heading lands BELOW the\n  // sticky category nav on the FIRST tween (covers the same-target\n  // re-click case, where the `hashTarget` effect at L214 is a no-op\n  // because the state reference is equal). For DIFFERENT-target clicks\n  // the helper's synthetic `hashchange` re-fires that effect, which\n  // re-scrolls with the same offset and cancels this tween (singleton)\n  // — both paths land at the same position. The effect is still\n  // required for back/forward + direct URL edits, where the helper\n  // isn't in the call chain.\n  //\n  // `history: 'replace'` matches the pre-helper behavior: category pills\n  // are a TOC, not a navigation step, so the Back button leaves the\n  // FAQ page in one step regardless of how many categories the user\n  // clicked through.\n  const handleJump = useCallback((e: React.MouseEvent<HTMLAnchorElement>, slug: string) => {\n    e.preventDefault();\n    navigateSamePageHash('#' + slug, {\n      headerOffset: STICKY_HEADER_OFFSET_PX,\n      history: 'replace',\n    });\n  }, []);\n\n  return (\n    <div className=\"space-y-8\">\n      {navGroups.length > 1 && (\n        <nav aria-label=\"FAQ categories\" className=\"flex flex-wrap gap-2\">\n          {navGroups.map(group => {\n            const isActive = group.slug === activeSlug;\n            return (\n              <a\n                key={group.slug}\n                href={`#${group.slug}`}\n                aria-current={isActive ? 'true' : undefined}\n                onClick={e => handleJump(e, group.slug as string)}\n                className={cn(\n                  'rounded-full border px-4 py-2 transition-colors text-h6',\n                  isActive\n                    ? 'border-ods-text-primary bg-ods-card text-ods-text-primary'\n                    : 'border-ods-border bg-ods-card text-ods-text-secondary hover:border-ods-text-secondary hover:text-ods-text-primary',\n                )}\n              >\n                {group.section}\n              </a>\n            );\n          })}\n        </nav>\n      )}\n      <div className=\"space-y-10\">\n        {groups.map(group => {\n          const key = groupKey(group);\n          return (\n            <section key={key} id={group.slug ?? undefined} className=\"scroll-mt-24 space-y-4\">\n              {group.section && <CategoryHeading className={SECTION_HEADING_CLASS}>{group.section}</CategoryHeading>}\n              <FaqAccordion\n                // Re-key on item-hash changes so the remount picks up the new\n                // `defaultOpenIds` (the accordion is uncontrolled). Stable for\n                // section hashes — category navigation doesn't disturb state.\n                key={`${key}:${accordionKeySuffix}`}\n                items={group.items}\n                defaultOpenIds={defaultOpenByGroupKey?.get(key)}\n              />\n            </section>\n          );\n        })}\n      </div>\n    </div>\n  );\n}\n\nfunction FaqSkeleton() {\n  return (\n    <div className=\"animate-pulse space-y-8\">\n      <div className=\"h-12 w-2/3 rounded bg-ods-border md:h-14\" />\n      <div className=\"w-full divide-y divide-ods-border overflow-hidden rounded-md border border-ods-border bg-transparent\">\n        {Array.from({ length: 8 }).map((_, idx) => (\n          <div key={idx} className=\"flex items-center justify-between gap-6 px-6 py-4 md:gap-10\">\n            <div className=\"h-6 w-5/6 rounded bg-ods-border\" />\n            <div className=\"size-6 rounded bg-ods-border\" />\n          </div>\n        ))}\n      </div>\n    </div>\n  );\n}\n\ninterface FaqsResponse {\n  faqs: Faq[];\n}\n\n/**\n * The FAQ display surface — ONE rendering on every host: the list grouped by\n * `faq.section` (each category a heading + its own accordion, with a category\n * jump-nav once there are 2+ categories). There is no flat/ungrouped mode and\n * no page-vs-embedded shell fork; the standalone /faqs page and every embed\n * render through this single path, so they cannot drift.\n *\n * - Standalone /faqs page: pass `initialFaqs` (SSR) + `heading={null}` (the\n *   page owns the <h1>) + `emitJsonLd` with `jsonLd` overrides for SEO.\n * - Per-entity embed: pass `entityType` + `entityId` (no `initialFaqs`); the\n *   hook self-fetches `GET /api/faqs`, and `heading` is this block's own <h2>.\n *\n * CONTRACT: the consuming app MUST implement `GET /api/faqs`. On a fetch error\n * (or zero FAQs) the component renders nothing so the host page isn't\n * disfigured. The host always supplies the page shell — this renders a bare\n * <section>.\n */\nexport function FaqSection({\n  initialFaqs,\n  entityType,\n  entityId,\n  heading,\n  emitJsonLd = false,\n  jsonLd,\n  className,\n  minResults,\n  apiBaseUrl = '',\n}: FaqSectionProps) {\n  const url = buildFaqsUrl(entityType, entityId, minResults, apiBaseUrl);\n  // Memoized — useSelfFetch re-syncs on [initialData]; a fresh per-render\n  // wrapper object would setState-loop under re-rendering parents.\n  const initialData = useMemo<FaqsResponse | undefined>(\n    () => (initialFaqs ? { faqs: initialFaqs } : undefined),\n    [initialFaqs],\n  );\n  const { data, isLoading, error } = useSelfFetch<FaqsResponse>(url, { initialData });\n\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 faqs = useMemo(() => data?.faqs ?? [], [data?.faqs]);\n  // Grouped before the early returns so the hook order stays stable.\n  const groups = useMemo(() => (faqs.length > 0 ? groupFaqsBySection(faqs) : []), [faqs]);\n\n  // `undefined` → default <h2> title; `null` → the host page owns the <h1>, so\n  // no title renders here. `heading === null` also makes the category headings\n  // <h2> (directly under the page <h1>); otherwise they nest as <h3>.\n  const headingNode =\n    heading === undefined ? <h2 className={SECTION_HEADING_CLASS}>{DEFAULT_HEADING_TEXT}</h2> : heading;\n\n  // Degrade silently — never show an error banner or an empty section shell\n  // where FAQs would be (host pages and the standalone surface both rely on it).\n  if (error) return null;\n  if (!isLoading && faqs.length === 0) return null;\n  if (isLoading && faqs.length === 0) {\n    return (\n      <div className={className}>\n        <FaqSkeleton />\n      </div>\n    );\n  }\n\n  const schema = emitJsonLd ? buildFaqJsonLdFromFaqs(faqs, jsonLd) : null;\n\n  return (\n    <>\n      <section className={className ?? 'space-y-10'}>\n        {headingNode}\n        <GroupedFaqList groups={groups} categoryHeadingAs={heading === null ? 'h2' : 'h3'} />\n      </section>\n      {schema && (\n        <script\n          type=\"application/ld+json\"\n          // serializeJsonLd, NOT raw JSON.stringify — FAQ answers are\n          // admin-entered; an embedded \"</script>\" must not break the tag.\n          dangerouslySetInnerHTML={{ __html: serializeJsonLd(schema) }}\n        />\n      )}\n    </>\n  );\n}\n","'use client';\n\nimport { useState } from 'react';\nimport { cn } from '../utils/cn';\nimport { faqItemAnchor } from '../utils/faq-anchor';\nimport { Chevron02DownIcon } from './icons-v2-generated/arrows/chevron-02-down-icon';\n\nexport interface FaqItem {\n  id: number | string;\n  question: string;\n  answer: string;\n}\n\ninterface FaqAccordionProps {\n  items: FaqItem[];\n  defaultOpenIds?: (number | string)[];\n}\n\nexport function FaqAccordion({ items, defaultOpenIds = [] }: FaqAccordionProps) {\n  const [openSet, setOpenSet] = useState<Set<string | number>>(new Set(defaultOpenIds));\n\n  const toggle = (id: string | number) => {\n    setOpenSet(prev => {\n      const next = new Set(prev);\n      if (next.has(id)) next.delete(id);\n      else next.add(id);\n      return next;\n    });\n  };\n\n  return (\n    <div className=\"divide-y divide-ods-border overflow-hidden rounded-md border border-ods-border bg-transparent\">\n      {items.map(item => {\n        const isOpen = openSet.has(item.id);\n\n        return (\n          <div\n            key={item.id}\n            // Per-row anchor — chat citation chips (`/faqs#faq-item-<id>`) land\n            // here via native browser hash scroll AND via `FaqSection`'s tween\n            // dispatch. `scroll-mt-24` keeps the row header below the 96px\n            // sticky nav offset (matches `<section>`'s scroll-margin for\n            // category anchors).\n            id={faqItemAnchor(item.id)}\n            className=\"scroll-mt-24 transition-colors hover:bg-ods-bg-hover\"\n          >\n            {/* Header */}\n            <div\n              role=\"button\"\n              tabIndex={0}\n              onClick={() => toggle(item.id)}\n              onKeyDown={e => {\n                if (e.key === 'Enter' || e.key === ' ') {\n                  e.preventDefault();\n                  toggle(item.id);\n                }\n              }}\n              aria-expanded={isOpen}\n              className=\"flex w-full cursor-pointer items-center gap-6 px-6 py-4 text-left transition-colors focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-inset focus-visible:ring-ods-focus md:gap-10\"\n            >\n              <h3 className=\"min-w-0 flex-1 break-words\">{item.question}</h3>\n              <Chevron02DownIcon\n                aria-hidden=\"true\"\n                size={24}\n                className={cn(\n                  'shrink-0 text-ods-text-primary transition-transform duration-300',\n                  isOpen && 'rotate-180',\n                )}\n              />\n            </div>\n            {/* Content wrapper. Collapses with the grid 1fr->0fr transition the\n                rest of the design system uses (see AnnouncementBar) rather than\n                an animated max-height: measuring `scrollHeight` needed a hook\n                PER ROW, which meant calling hooks inside `items.map` — the hook\n                order then changed whenever `items` did. Grid needs no\n                measurement, and it animates correctly when an answer's height\n                changes after mount. */}\n            <div\n              className=\"grid transition-[grid-template-rows,opacity] duration-300 ease-in-out motion-reduce:transition-none\"\n              style={{ gridTemplateRows: isOpen ? '1fr' : '0fr', opacity: isOpen ? 1 : 0 }}\n            >\n              {/* break-words: FAQ answers render as plain text, so a long URL or\n                  token has no wrap opportunity — and the row is overflow-hidden,\n                  which would CLIP it past the viewport on mobile. Mirrors the\n                  markdown-renderer overflow-wrap fix. */}\n              <div className=\"overflow-hidden\">\n                <div className=\"break-words px-6 pb-4 text-ods-text-primary text-h4\">{item.answer}</div>\n              </div>\n            </div>\n          </div>\n        );\n      })}\n    </div>\n  );\n}\n","/**\n * Pure FAQ JSON-LD builder. No React, no client-only deps — safe to import from\n * Server Components via the `./components/faq` subpath export. (Do NOT import\n * through the root `./components` barrel — that barrel is `\"use client\"` and\n * dragging it into a Server Component would force the client graph into the\n * server.)\n *\n * The hub used to harcode `name`/`description` here for OpenMSP; in the lib we\n * accept overrides so every embedder can supply its own platform branding.\n */\nimport type { Faq } from '../../types/faq';\n\nexport interface FaqSchemaOptions {\n  name?: string;\n  description?: string;\n  url?: string;\n}\n\nconst DEFAULT_NAME = 'Frequently Asked Questions';\nconst DEFAULT_DESCRIPTION = 'Answers to common questions.';\n\nexport function baseFaqSchema(opts: FaqSchemaOptions = {}) {\n  return {\n    '@context': 'https://schema.org',\n    '@type': 'FAQPage',\n    name: opts.name ?? DEFAULT_NAME,\n    description: opts.description ?? DEFAULT_DESCRIPTION,\n    ...(opts.url ? { url: opts.url } : {}),\n  } as const;\n}\n\nexport function buildFaqJsonLdFromFaqs(faqs: Faq[], opts: FaqSchemaOptions = {}) {\n  return {\n    ...baseFaqSchema(opts),\n    mainEntity: faqs.map(faq => ({\n      '@type': 'Question',\n      name: faq.question,\n      acceptedAnswer: {\n        '@type': 'Answer',\n        text: faq.answer,\n      },\n    })),\n  } as const;\n}\n","'use client';\n\n/**\n * FaqDocumentPage — the full `/faqs` page with chrome, so embedders drop in\n * ONE component instead of hand-assembling `PageShell` + `PageLayout` around\n * the bare `<FaqSection>`. Mirrors `LegalDocumentPage` / `DevSectionPage`: the\n * page-level layout lives in the lib, the host page is a thin wrapper that\n * passes only config + the SSR-resolved data.\n *\n * HERO: the title + subtitle route through the canonical (frozen) `PageLayout`\n * `TitleBlock` with `titleSize=\"h1\"` — the unified Help Center header (the\n * `TitleBlock` element is always an `<h1>`; `titleSize` only sets its typography,\n * here `text-h1`). The page owns that `<h1>`, so `<FaqSection heading={null}>`\n * nests its category headings as `<h2>`/`<h3>` (the SEO-recommended FAQ document\n * outline).\n *\n * DATA: pass `initialFaqs` (SSR-resolved, platform-scoped) so `FaqSection`\n * skips its client self-fetch — the standalone page's static platform-only\n * contract. Omit it for embeds that want the self-fetching `/api/faqs`\n * suggestion-fill instead.\n */\n\nimport { useRouter } from '../../embed-shims/next-navigation';\nimport type { Faq } from '../../types/faq';\nimport { PageShell, PageLayout } from '../ui';\nimport { FaqSection } from './faq-section';\nimport type { FaqSchemaOptions } from './json-ld';\n\nexport interface FaqDocumentPageProps {\n  /** Page title (frozen `PageLayout` `TitleBlock`). Default \"Frequently Asked Questions\". */\n  title?: string;\n  /** Subtitle under the title. */\n  subtitle?: string;\n  /** Back-button config — same pattern as `DevSectionPage` / `LegalDocumentPage`.\n   *  Pass `false` to hide. Default `{ label: 'Back to home', href: '/' }`. */\n  backButton?: { label?: string; href?: string } | false;\n  /** Render the standalone `<PageShell>` (own `<main>` + bg + max-width). Default\n   *  true. Pass false when the host layout already provides the page container\n   *  (e.g. openframe-frontend's `AppLayout` `<main>`) — only the padding box\n   *  renders, avoiding a nested `<main>`. */\n  shell?: boolean;\n  /** SSR-hydrate `FaqSection` (skips the client fetch — the platform-only\n   *  contract for the standalone page). Omit for self-fetching embeds. */\n  initialFaqs?: Faq[];\n  /** Emit FAQPage schema.org JSON-LD (forwarded to `FaqSection`). Off by\n   *  default so embeds don't emit duplicate schema. */\n  emitJsonLd?: boolean;\n  /** JSON-LD name/description/url overrides (forwarded to `FaqSection`). */\n  jsonLd?: FaqSchemaOptions;\n  /** Base URL `FaqSection` appends `/api/faqs` to (reverse-proxy embedders). */\n  apiBaseUrl?: string;\n  /** Optional entity scoping forwarded to `FaqSection`. */\n  entityType?: string;\n  entityId?: number | string;\n  /** Minimum FAQ count before the section renders (forwarded to `FaqSection`). */\n  minResults?: number;\n}\n\nexport function FaqDocumentPage({\n  title = 'Frequently Asked Questions',\n  subtitle,\n  backButton,\n  initialFaqs,\n  emitJsonLd,\n  jsonLd,\n  apiBaseUrl,\n  entityType,\n  entityId,\n  minResults,\n  shell = true,\n}: FaqDocumentPageProps) {\n  const router = useRouter();\n\n  // Back-button config — mirrors LegalDocumentPage / DevSectionPage. Hide\n  // entirely when the caller passes `false` (embed-mode where the host owns\n  // nav chrome).\n  const backCfg =\n    backButton === false\n      ? undefined\n      : {\n          label: backButton?.label ?? 'Back to home',\n          onClick: () => router.push(backButton?.href ?? '/'),\n        };\n\n  const inner = (\n    <PageLayout title={title} subtitle={subtitle} backButton={backCfg} titleSize=\"h1\" titleWrap>\n      <FaqSection\n        initialFaqs={initialFaqs}\n        heading={null}\n        emitJsonLd={emitJsonLd}\n        jsonLd={jsonLd}\n        apiBaseUrl={apiBaseUrl}\n        entityType={entityType}\n        entityId={entityId}\n        minResults={minResults}\n      />\n    </PageLayout>\n  );\n\n  return shell ? <PageShell>{inner}</PageShell> : <div className=\"page-shell-content\">{inner}</div>;\n}\n"]}

package/dist/{chunk-BOIYZ2L6.js → chunk-PG65AE3I.js}

@@ -5,10 +5,10 @@ import {
 import {
   PageLayout,
   PageShell
-} from "./chunk-NRH4IHI4.js";
+} from "./chunk-MHTB67ZH.js";
 import {
   useScrollToHash
-} from "./chunk-ZQDJPLRS.js";
+} from "./chunk-V5REIMSE.js";
 import {
   buildSuggestionUrl
 } from "./chunk-GRBZC5N3.js";
@@ -17,12 +17,12 @@ import {
   faqItemAnchor,
   faqSectionSlug,
   parseFaqHash
-} from "./chunk-IXLO6K3T.js";
+} from "./chunk-YPXXXX6R.js";
 import {
   STICKY_HEADER_OFFSET_PX,
   navigateSamePageHash,
   serializeJsonLd
-} from "./chunk-WYB27NKC.js";
+} from "./chunk-JNUL3ZWK.js";
 import {
   useRouter
 } from "./chunk-XXMHLZ3Y.js";
@@ -355,4 +355,4 @@ export {
   FaqSection,
   FaqDocumentPage
 };
-//# sourceMappingURL=chunk-BOIYZ2L6.js.map
+//# sourceMappingURL=chunk-PG65AE3I.js.map

package/dist/{chunk-SFYBD456.js → chunk-QOH45QSE.js}

@@ -8,18 +8,18 @@ import {
   SelectTrigger,
   SelectValue,
   Textarea
-} from "./chunk-NRH4IHI4.js";
+} from "./chunk-MHTB67ZH.js";
 import {
   useContactSubmission,
   useHumanitySignals,
   useRescuedForm
-} from "./chunk-ZQDJPLRS.js";
+} from "./chunk-V5REIMSE.js";
 import {
   ChatAttachmentAddButton,
   ChatAttachmentChipStrip,
   SECTION_HEADING_CLASS,
   useChatAttachments
-} from "./chunk-IXLO6K3T.js";
+} from "./chunk-YPXXXX6R.js";
 import {
   Input,
   Label,
@@ -385,4 +385,4 @@ function ContactForm({
 export {
   ContactForm
 };
-//# sourceMappingURL=chunk-SFYBD456.js.map
+//# sourceMappingURL=chunk-QOH45QSE.js.map