@flamingo-stack/openframe-frontend-core 0.0.305 → 0.0.306-snapshot.20260622221324

package/dist/{chunk-SR6ZSDOP.cjs → chunk-4RI7S6ZD.cjs}

@@ -6,7 +6,7 @@
 
 
 
-var _chunk3NDFB23Mcjs = require('./chunk-3NDFB23M.cjs');
+var _chunk6TRTIHGWcjs = require('./chunk-6TRTIHGW.cjs');
 
 
 
@@ -34,7 +34,7 @@ function DocSearchResultRow({
 }) {
   const docType = _optionalChain([result, 'access', _ => _.metadata, 'optionalAccess', _2 => _2.documentType]) || void 0;
   const sourceRepo = _optionalChain([result, 'access', _3 => _3.metadata, 'optionalAccess', _4 => _4.sourceRepo]) || void 0;
-  const { Icon: SourceIcon, label: iconLabel } = _chunk3NDFB23Mcjs.resolveSourceIcon.call(void 0, {
+  const { Icon: SourceIcon, label: iconLabel } = _chunk6TRTIHGWcjs.resolveSourceIcon.call(void 0, {
     sourceRepo,
     documentType: docType
   });
@@ -77,7 +77,7 @@ function DocSearchBar({
   renderResult
 }) {
   return /* @__PURE__ */ _jsxruntime.jsx.call(void 0, 
-    _chunk3NDFB23Mcjs.SearchInput,
+    _chunk6TRTIHGWcjs.SearchInput,
     {
       placeholder,
       value: query,
@@ -186,7 +186,7 @@ function resolveSearchResultAction(result, source, runtimeMode) {
   const externalUrl = meta.externalUrl;
   if (externalUrl) {
     const targetPlatform = meta.targetPlatform;
-    const isNewTab = _chunk3NDFB23Mcjs.decideNewTab.call(void 0, {
+    const isNewTab = _chunk6TRTIHGWcjs.decideNewTab.call(void 0, {
       href: externalUrl,
       targetPlatform,
       surface: "useUnifiedNav",
@@ -288,7 +288,7 @@ function useDocSearch(config) {
           if (_optionalChain([runtime, 'optionalAccess', _14 => _14.navigation, 'access', _15 => _15.mode]) === "embed") {
             setKeepOpen(true);
             const targetPlatform = _nullishCoalesce(_optionalChain([result, 'access', _16 => _16.metadata, 'optionalAccess', _17 => _17.targetPlatform]), () => ( null));
-            _chunk3NDFB23Mcjs.resolveExternalNavigation.call(void 0, {
+            _chunk6TRTIHGWcjs.resolveExternalNavigation.call(void 0, {
               href: action.href,
               targetPlatform,
               runtime
@@ -297,18 +297,18 @@ function useDocSearch(config) {
           }
           if (wantsNewTab) {
             setKeepOpen(true);
-            window.open(action.href, "_blank", _chunk3NDFB23Mcjs.NEW_TAB_FEATURES);
+            window.open(action.href, "_blank", _chunk6TRTIHGWcjs.NEW_TAB_FEATURES);
             return;
           }
           setKeepOpen(false);
           const path = baseRoute && action.href.startsWith(`${baseRoute}/`) ? action.href.slice(baseRoute.length + 1) : null;
           if (path && _optionalChain([onInPageSwap, 'optionalCall', _18 => _18(path)])) return;
-          router.push(_chunk3NDFB23Mcjs.stripSameOriginToPath.call(void 0, action.href));
+          router.push(_chunk6TRTIHGWcjs.stripSameOriginToPath.call(void 0, action.href));
           return;
         }
         case "navigate-new-tab":
           setKeepOpen(true);
-          window.open(action.href, "_blank", _chunk3NDFB23Mcjs.NEW_TAB_FEATURES);
+          window.open(action.href, "_blank", _chunk6TRTIHGWcjs.NEW_TAB_FEATURES);
           return;
         case "ask-ai":
           setKeepOpen(false);
@@ -347,4 +347,4 @@ function useDocSearch(config) {
 
 
 exports.formatRelativePath = formatRelativePath; exports.DocSearchResultRow = DocSearchResultRow; exports.DocSearchBar = DocSearchBar; exports.mapDocSearchResults = mapDocSearchResults; exports.resolveSearchResultAction = resolveSearchResultAction; exports.useDocSearch = useDocSearch;
-//# sourceMappingURL=chunk-SR6ZSDOP.cjs.map
+//# sourceMappingURL=chunk-4RI7S6ZD.cjs.map

package/dist/{chunk-SR6ZSDOP.cjs.map → chunk-4RI7S6ZD.cjs.map}

@@ -1 +1 @@
-{"version":3,"sources":["/home/runner/work/openframe-oss-lib/openframe-oss-lib/openframe-frontend-core/dist/chunk-SR6ZSDOP.cjs","../src/components/shared/doc-search/format-relative-path.ts","../src/components/shared/doc-search/doc-search-result-row.tsx","../src/components/shared/doc-search/doc-search-bar.tsx","../src/components/shared/doc-search/map-doc-search-results.ts","../src/components/shared/doc-search/resolve-search-result-action.ts","../src/components/shared/doc-search/use-doc-search.ts"],"names":["jsx"],"mappings":"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","file":"/home/runner/work/openframe-oss-lib/openframe-oss-lib/openframe-frontend-core/dist/chunk-SR6ZSDOP.cjs","sourcesContent":[null,"/**\n * Format a full document path as a breadcrumb trail.\n * Shows parent folders only (excludes the last segment / filename).\n *\n * @example\n *   formatRelativePath('openframe-oss-tenant/architecture/api-controllers.md')\n *   // → 'Openframe oss tenant / Architecture'\n */\nexport function formatRelativePath(fullPath: string): string {\n  if (!fullPath) return ''\n  const segments = fullPath.replace(/\\.md$/, '').split('/')\n  // Show only parent path (exclude the filename itself since the title already shows it)\n  const parentSegments = segments.length > 1 ? segments.slice(0, -1) : segments\n  return parentSegments\n    .map((seg) => seg.charAt(0).toUpperCase() + seg.slice(1).replace(/-/g, ' '))\n    .join(' / ')\n}\n","'use client'\n\n/**\n * Single row in the `<SearchInput>` dropdown — the standard layout\n * used by every doc-search-backed surface (company-hub data-room\n * search bar, onboarding-guide catalog search, …). Single source of\n * truth for the row appearance so search dropdowns are visually\n * identical everywhere.\n *\n * Resolves the source icon via the same `resolveSourceIcon()`\n * registry the inline chat-card refs use, so a row pointing at e.g.\n * an onboarding-guide surfaces the SAME `<GraduationCap>` glyph the\n * chat card surfaces — no cross-surface drift.\n */\n\nimport { resolveSourceIcon } from '../../chat/utils/source-row-cta'\nimport { formatRelativePath } from './format-relative-path'\n\n/**\n * Minimal result shape this row renders. Compatible with any\n * doc-search hook whose result type exposes `{ title?, path?,\n * metadata? }`. The two hub consumers (onboarding-guide catalog,\n * data-room sidebar) both satisfy this shape via their\n * `useDocSearch` hook result.\n */\nexport interface DocSearchResultRowEntry {\n  title?: string\n  path?: string\n  metadata?: Record<string, unknown>\n}\n\nexport interface DocSearchResultRowProps {\n  result: DocSearchResultRowEntry\n  isHighlighted: boolean\n}\n\nexport function DocSearchResultRow({\n  result,\n  isHighlighted,\n}: DocSearchResultRowProps) {\n  const docType = (result.metadata?.documentType as string) || undefined\n  const sourceRepo = (result.metadata?.sourceRepo as string) || undefined\n  const { Icon: SourceIcon, label: iconLabel } = resolveSourceIcon({\n    sourceRepo,\n    documentType: docType,\n  })\n  const isGroup = result.metadata?.isGroup as boolean | undefined\n\n  return (\n    <div className=\"flex items-center gap-3 w-full min-w-0\">\n      <span\n        className=\"flex-shrink-0 text-ods-text-secondary\"\n        title={iconLabel}\n      >\n        <SourceIcon className=\"size-4\" />\n      </span>\n      <div className=\"min-w-0 flex-1\">\n        <div\n          className={`text-sm font-medium leading-5 truncate ${\n            isHighlighted ? 'text-ods-accent' : 'text-ods-text-primary'\n          }`}\n        >\n          {result.title || result.path}\n        </div>\n        {!isGroup && result.path?.includes('/') && (\n          <div className=\"text-xs leading-4 text-ods-text-secondary truncate mt-0.5\">\n            {formatRelativePath(result.path)}\n          </div>\n        )}\n      </div>\n    </div>\n  )\n}\n","'use client'\n\n/**\n * `<DocSearchBar>` — the canonical RAG-search dropdown surface.\n *\n * Mounted by every doc-search consumer (data-room sidebar, onboarding-\n * guide catalog, and any future surface that needs typeahead against\n * `/api/docs/search`). Wraps `<SearchInput>` with the lib's standard\n * `<DocSearchResultRow>` so the dropdown looks identical everywhere.\n *\n * ## Why a presentation component, not a \"search bar that owns its\n *    own hook\"\n *\n * The data-fetching hook (`useDocSearch`) lives hub-side because it\n * depends on hub-only context (`useDocNavigation`, the rag-table-\n * config registry, the hub's `decideNewTab` helper). Moving the hook\n * would cascade ~5 more file migrations into the lib.\n *\n * Instead, the hook stays hub-side and callers pass its result into\n * this component as plain props. Both consumers shrink to ~5 lines.\n */\n\nimport type { ReactNode } from 'react'\nimport { SearchInput, type SearchResult } from '../../ui/search-input'\nimport { DocSearchResultRow } from './doc-search-result-row'\n\nexport interface DocSearchBarProps {\n  placeholder: string\n  query: string\n  onQueryChange: (value: string) => void\n  /** Hook-fetched results. Reuses the lib's `<SearchInput>` `SearchResult`\n   *  shape directly so callers don't translate. */\n  results: SearchResult[]\n  isLoading: boolean\n  /** Result selection handler. Mirrors `<SearchInput>` — the second\n   *  `modifiers` argument is preserved so cmd-click / shift-click on\n   *  a result row still forces new-tab behavior. Hub `useDocSearch`\n   *  reads these to short-circuit to `window.open()`. */\n  onResultSelect: (\n    result: SearchResult,\n    modifiers?: {\n      metaKey?: boolean\n      ctrlKey?: boolean\n      shiftKey?: boolean\n      altKey?: boolean\n      button?: number\n    },\n  ) => void\n  /** Lets the caller's hook force the dropdown open after a recent\n   *  internal action (e.g. result navigation). `undefined` falls back\n   *  to `<SearchInput>`'s built-in focus/hover heuristics. */\n  showDropdown?: boolean\n  /** Defaults to 2 — matches the existing data-room and onboarding-\n   *  guide consumers. Override only if a surface needs different\n   *  typeahead semantics. */\n  minQueryLength?: number\n  /** Defaults to 0 — both existing consumers debounce inside the\n   *  hook, not the input. */\n  debounceMs?: number\n  className?: string\n  /** Optional row-renderer override. Defaults to the lib's standard\n   *  `<DocSearchResultRow>` (source icon + title + path breadcrumb).\n   *  Override only when a surface needs custom row chrome. */\n  renderResult?: (result: SearchResult, isHighlighted: boolean) => ReactNode\n}\n\nexport function DocSearchBar({\n  placeholder,\n  query,\n  onQueryChange,\n  results,\n  isLoading,\n  onResultSelect,\n  showDropdown,\n  minQueryLength = 2,\n  debounceMs = 0,\n  className = 'w-full',\n  renderResult,\n}: DocSearchBarProps) {\n  return (\n    <SearchInput\n      placeholder={placeholder}\n      value={query}\n      onChange={onQueryChange}\n      results={results}\n      isLoading={isLoading}\n      onResultSelect={onResultSelect}\n      showDropdown={showDropdown || undefined}\n      debounceMs={debounceMs}\n      minQueryLength={minQueryLength}\n      className={className}\n      renderResult={\n        renderResult ??\n        ((result, isHighlighted) => (\n          <DocSearchResultRow result={result} isHighlighted={isHighlighted} />\n        ))\n      }\n    />\n  )\n}\n","/**\n * Map RAG `/api/docs/search` wire results into the `<DocSearchBar>`\n * dropdown's row shape, collapsing entity-table rows into grouped\n * results so the dropdown lists ONE \"Cap Table (12 records)\" row\n * instead of 12 individual rows.\n *\n * Pure transform — no telemetry, no navigation, no React deps. Lifted\n * from the hub's `hooks/use-docs.ts:mapDocSearchResults` (the hub's\n * `traceCompose` call was hub-only telemetry and is intentionally\n * dropped — callers that want logging can wrap this helper).\n */\n\nimport type { SearchResult } from '../../ui/search-input'\nimport type { DocSearchResult } from './types'\n\n/** Source repos that should be collapsed into grouped results in the search bar.\n *  Only financial tables (all rows link to the same admin page).\n *  Content tables (blog, webinar, podcast, etc.) stay individual since each has a unique URL. */\nconst SEARCH_GROUP_REPOS = new Set([\n  'financial-cap-table',\n  'financial-kpis',\n  'financial-pnl',\n  'financial-balance-sheet',\n  'financial-cash-flow',\n])\n\nconst ENTITY_LABELS: Record<string, string> = {\n  'financial-cap-table': 'Cap Table',\n  'financial-kpis': 'Financial KPIs',\n  'financial-pnl': 'Profit & Loss',\n  'financial-balance-sheet': 'Balance Sheets',\n  'financial-cash-flow': 'Cash Flow',\n  'blog-posts': 'Blog Posts',\n  'product-releases': 'Product Releases',\n  'case-studies': 'Case Studies',\n  webinars: 'Webinars',\n  events: 'Events',\n  podcasts: 'Podcasts',\n}\n\nexport function mapDocSearchResults(docs: DocSearchResult[]): SearchResult[] {\n  const entityGroups = new Map<string, DocSearchResult[]>()\n  // Track insertion order — groups appear where the FIRST row of that\n  // repo appeared in the response.\n  const order: Array<\n    { type: 'entity'; repo: string } | { type: 'doc'; doc: DocSearchResult }\n  > = []\n  const seenRepos = new Set<string>()\n\n  for (const doc of docs) {\n    if (doc.sourceRepo && SEARCH_GROUP_REPOS.has(doc.sourceRepo)) {\n      const group = entityGroups.get(doc.sourceRepo) || []\n      group.push(doc)\n      entityGroups.set(doc.sourceRepo, group)\n      if (!seenRepos.has(doc.sourceRepo)) {\n        seenRepos.add(doc.sourceRepo)\n        order.push({ type: 'entity', repo: doc.sourceRepo })\n      }\n    } else {\n      order.push({ type: 'doc', doc })\n    }\n  }\n\n  const results: SearchResult[] = []\n  for (const entry of order) {\n    if (entry.type === 'entity') {\n      const rows = entityGroups.get(entry.repo)!\n      const label = ENTITY_LABELS[entry.repo] || entry.repo\n      results.push({\n        id: `group-${entry.repo}`,\n        title: `${label} (${rows.length} ${rows.length === 1 ? 'record' : 'records'})`,\n        path: rows[0].path,\n        type: 'file',\n        metadata: {\n          documentType: rows[0].documentType,\n          externalUrl: rows[0].externalUrl,\n          sourceRepo: entry.repo,\n          id: rows[0].entityId,\n          isGroup: true,\n          items: rows.map((r) => ({\n            name: r.name,\n            externalUrl: r.externalUrl,\n            id: r.entityId,\n            sourceRepo: r.sourceRepo,\n            documentType: r.documentType,\n          })),\n        },\n      })\n    } else {\n      const doc = entry.doc\n      const isNonMarkdown = doc.documentType && doc.documentType !== 'markdown'\n      results.push({\n        id: doc.path,\n        title: doc.name,\n        description: isNonMarkdown ? doc.name : doc.snippet,\n        path: doc.path,\n        type: doc.type,\n        metadata: {\n          matchType: doc.matchType,\n          ...(doc.documentType ? { documentType: doc.documentType } : {}),\n          ...(doc.externalUrl ? { externalUrl: doc.externalUrl } : {}),\n          ...(doc.targetPlatform != null\n            ? { targetPlatform: doc.targetPlatform }\n            : {}),\n          ...(doc.sourceRepo ? { sourceRepo: doc.sourceRepo } : {}),\n          ...(doc.entityId ? { id: doc.entityId } : {}),\n        },\n      })\n    }\n  }\n\n  return results\n}\n","/**\n * Resolve what should happen when the user picks a search result.\n * Returns one of five typed actions so the caller is a single switch.\n *\n * Resolution order:\n *  1. `externalUrl` present → use `decideNewTab` to choose same-tab vs\n *     new-tab against the row's `targetPlatform`.\n *  2. Row has `id` + `sourceRepo` + `documentType` → synth an Ask-AI\n *     action (entity drill-in via primary key, no URL).\n *  3. Row has only `path` → legacy navigation fallback.\n *  4. Nothing actionable → noop.\n *\n * Lifted from the hub's `hooks/use-docs.ts:resolveSearchResultAction`.\n * Pure — no React, no telemetry.\n */\n\nimport type { SearchResult } from '../../ui/search-input'\nimport type { ChatRef } from '../../chat/chat-ref.types'\nimport { decideNewTab } from '../../chat/utils/decide-new-tab'\n\nexport type SearchResultAction =\n  | { kind: 'navigate-same-tab'; href: string }\n  | { kind: 'navigate-new-tab'; href: string }\n  | { kind: 'ask-ai'; detail: { source: string; ref: ChatRef } }\n  | { kind: 'route'; path: string }\n  | { kind: 'noop' }\n\nexport function resolveSearchResultAction(\n  result: SearchResult,\n  source: string,\n  runtimeMode?: 'host' | 'embed',\n): SearchResultAction {\n  const meta = result.metadata ?? {}\n  const externalUrl = meta.externalUrl as string | undefined\n  if (externalUrl) {\n    // Same pure helper `useNavLink` and `useUnifiedNav` call — single\n    // decision rule across cards, chips, and autocomplete rows. Thread\n    // the caller's `source` as `currentSource` so the platform-vs-\n    // platform comparison matches the hub's pre-migration behavior.\n    const targetPlatform = meta.targetPlatform as string | null | undefined\n    const isNewTab = decideNewTab({\n      href: externalUrl,\n      targetPlatform,\n      surface: 'useUnifiedNav',\n      runtimeMode,\n      currentSource: source,\n    })\n    return isNewTab\n      ? { kind: 'navigate-new-tab', href: externalUrl }\n      : { kind: 'navigate-same-tab', href: externalUrl }\n  }\n  const rowId = meta.id as string | undefined\n  const sourceRepo = meta.sourceRepo as string | undefined\n  const documentType = meta.documentType as string | undefined\n  if (rowId && sourceRepo && documentType) {\n    return {\n      kind: 'ask-ai',\n      detail: {\n        source,\n        ref: { type: documentType, id: rowId, title: result.title, url: null },\n      },\n    }\n  }\n  if (result.path) {\n    return { kind: 'route', path: result.path }\n  }\n  return { kind: 'noop' }\n}\n","'use client'\n\n/**\n * `useDocSearch` — debounced RAG-search hook against `/api/docs/search`.\n *\n * Pure fetch + navigation glue. Embedders can mount this directly\n * (any host with a reverse-proxy that exposes `/api/docs/search` will\n * work). Hub callers wire it into the lib `<DocSearchBar>` for the\n * canonical typeahead dropdown.\n *\n * ## What moved from hub to lib\n *\n * Lifted from `multi-platform-hub/hooks/use-docs.ts:useDocSearch`. Two\n * hub-only concerns are now optional injection points instead of\n * direct imports:\n *\n *   - `useDocNavigation()` (hub's in-page doc-tree swap) → optional\n *     `onInPageSwap?: (path: string) => boolean` config callback. When\n *     present and returns true, the hook treats a same-origin result\n *     click as \"handled in-page\"; when absent or returns false, the\n *     hook falls back to `onNavigate(path)` (`router.push` on hub,\n *     `window.location.assign` on bare embedders).\n *   - `traceCompose` (hub-only telemetry) → dropped. The lib has no\n *     equivalent runtime-context yet; bring it back when there is one.\n *\n * Everything else (debounce, `useChatRuntime` for embed-mode short-\n * circuit, embed-shim router, the action-resolver + result-mapper) is\n * now lib-resident.\n */\n\nimport { useState, useEffect, useCallback } from 'react'\nimport { useRouter } from '../../../embed-shims'\nimport { useDebounce } from '../../../hooks/ui/use-debounce'\nimport { useChatRuntime } from '../../../contexts/chat-runtime-context'\nimport { contentFetch } from '../../../utils/embed-content-fetch'\nimport type { SearchResult } from '../../ui/search-input'\nimport {\n  resolveExternalNavigation,\n  stripSameOriginToPath,\n  NEW_TAB_FEATURES,\n} from '../../chat/utils/chat-nav-resolution'\nimport type { DocSearchResult } from './types'\nimport { mapDocSearchResults } from './map-doc-search-results'\nimport { resolveSearchResultAction } from './resolve-search-result-action'\n\nexport interface UseDocSearchConfig {\n  /** Discriminator passed to `/api/docs/search?source=` (e.g.\n   *  `'openframe'`). Embedders set it to whatever discriminator their\n   *  reverse-proxy expects. */\n  source: string\n  /** Base route prefix this search lives under (e.g. `'/onboarding-guides'`).\n   *  When a result's href starts with `${baseRoute}/`, the hook\n   *  attempts the optional in-page swap path before falling through\n   *  to a full nav. */\n  baseRoute: string\n  /** Imperative navigation fallback. Called when no override\n   *  (in-page swap, new-tab) applies. Hub callers pass\n   *  `(path) => router.push(path)`; embedders pass an equivalent. */\n  onNavigate: (path: string) => void\n  /** Optional `RagTableConfig.id` list to narrow the search to specific\n   *  tables (e.g. `['onboarding-guides']`). Forwarded to\n   *  `/api/docs/search?tableIds=…` which intersects with the source's\n   *  standing set. */\n  tableIds?: string[]\n  /** Optional in-page swap callback. When the result's href is under\n   *  `baseRoute` AND this callback returns true, the hook treats the\n   *  click as handled in-page (no router push). Hub's\n   *  `<DocumentationSection>` wires this to\n   *  `useDocNavigation().navigate(path)`. */\n  onInPageSwap?: (path: string) => boolean\n  /** Optional endpoint override. Defaults to `'/api/docs/search'`\n   *  (the hub's reverse-proxy route). Embedders with a different\n   *  path can override. */\n  searchEndpoint?: string\n}\n\nexport function useDocSearch(config: UseDocSearchConfig) {\n  const {\n    source,\n    baseRoute,\n    onNavigate,\n    tableIds,\n    onInPageSwap,\n    searchEndpoint,\n  } = config\n  const tableIdsKey = tableIds && tableIds.length > 0 ? tableIds.join(',') : ''\n\n  const router = useRouter()\n  // Optional chat-runtime read — when present and mode='embed' the\n  // search-result row click short-circuits to a new-tab open against\n  // the absolutized URL. Null/host preserves today's behavior.\n  // Also used as the proxy-prefix fallback for `searchEndpoint`, matching\n  // how tickets resolves `findTicketUrl`.\n  const runtime = useChatRuntime()\n  const resolvedSearchEndpoint =\n    searchEndpoint ?? runtime?.endpoints.docsSearchUrl ?? '/api/docs/search'\n\n  const [query, setQuery] = useState('')\n  const [results, setResults] = useState<SearchResult[]>([])\n  const [isFetching, setIsFetching] = useState(false)\n  const debouncedQuery = useDebounce(query, 300)\n\n  useEffect(() => {\n    if (!debouncedQuery || debouncedQuery.trim().length < 2) {\n      setResults([])\n      setIsFetching(false)\n      return\n    }\n\n    let cancelled = false\n\n    async function fetchResults() {\n      setIsFetching(true)\n      try {\n        const params = new URLSearchParams({\n          q: debouncedQuery,\n          source,\n          limit: '10',\n        })\n        if (tableIdsKey) params.set('tableIds', tableIdsKey)\n\n        const response = await contentFetch(`${resolvedSearchEndpoint}?${params.toString()}`)\n        if (!response.ok) {\n          throw new Error(`Search request failed: ${response.status}`)\n        }\n\n        const json = await response.json()\n\n        if (!cancelled && json.success && Array.isArray(json.data)) {\n          const mapped = mapDocSearchResults(json.data as DocSearchResult[])\n          setResults(mapped)\n        }\n      } catch (error) {\n        console.error('Doc search error:', error)\n        if (!cancelled) {\n          setResults([])\n        }\n      } finally {\n        if (!cancelled) {\n          setIsFetching(false)\n        }\n      }\n    }\n\n    fetchResults()\n\n    return () => {\n      cancelled = true\n    }\n  }, [debouncedQuery, source, tableIdsKey, resolvedSearchEndpoint])\n\n  // Derived loading state — single source of truth for \"should the\n  // dropdown show 'Loading...' instead of 'No results found'\":\n  const isLoading =\n    query.trim().length >= 2 && (query !== debouncedQuery || isFetching)\n\n  // Track whether dropdown should stay open (external link opened in new tab).\n  const [keepOpen, setKeepOpen] = useState(false)\n\n  const handleResultSelect = useCallback(\n    (\n      result: SearchResult,\n      modifiers?: {\n        metaKey?: boolean\n        ctrlKey?: boolean\n        shiftKey?: boolean\n        altKey?: boolean\n        button?: number\n      },\n    ) => {\n      const action = resolveSearchResultAction(\n        result,\n        source,\n        runtime?.navigation.mode,\n      )\n      // Modifier / non-primary mouse click → force new tab regardless of\n      // same-tab/new-tab decision. The dropdown row is a `<div>`, not an\n      // `<a target=\"_blank\">`, so the browser doesn't background-tab\n      // natively on cmd-click. Honor it explicitly here for parity with\n      // the anchor-based surfaces (cards, chips, related-content). Plain\n      // Enter from the keyboard passes `modifiers === undefined`.\n      const wantsNewTab =\n        modifiers &&\n        (modifiers.metaKey ||\n          modifiers.ctrlKey ||\n          modifiers.shiftKey ||\n          modifiers.altKey ||\n          (typeof modifiers.button === 'number' && modifiers.button !== 0))\n      switch (action.kind) {\n        case 'navigate-same-tab': {\n          // Embed-mode short-circuit — autocomplete row clicked while\n          // the chat panel is hosted inside an embedding app.\n          if (runtime?.navigation.mode === 'embed') {\n            setKeepOpen(true)\n            const targetPlatform =\n              (result.metadata?.targetPlatform as string | null | undefined) ?? null\n            resolveExternalNavigation({\n              href: action.href,\n              targetPlatform,\n              runtime,\n            }).open()\n            return\n          }\n          if (wantsNewTab) {\n            setKeepOpen(true)\n            window.open(action.href, '_blank', NEW_TAB_FEATURES)\n            return\n          }\n          // Same-origin click:\n          //   1. If the href is under the current doc-tree's baseRoute AND\n          //      an `onInPageSwap` callback is wired AND returns true →\n          //      consider in-page swap handled.\n          //   2. Otherwise → embed-shim `router.push()` (soft RSC nav on\n          //      Next.js hosts, window.location.assign on bare hosts).\n          setKeepOpen(false)\n          const path =\n            baseRoute && action.href.startsWith(`${baseRoute}/`)\n              ? action.href.slice(baseRoute.length + 1)\n              : null\n          if (path && onInPageSwap?.(path)) return\n          router.push(stripSameOriginToPath(action.href))\n          return\n        }\n        case 'navigate-new-tab':\n          // Cross-origin (e.g. clicking a flamingo.run release from\n          // product-hub) — open in a new tab. Keep dropdown open so the\n          // user can pick another result without re-searching.\n          setKeepOpen(true)\n          window.open(action.href, '_blank', NEW_TAB_FEATURES)\n          return\n        case 'ask-ai':\n          // Row is searchable-but-not-openable (cap_table positions,\n          // financial-kpi snapshots, anything backed by\n          // `resolveUrl: () => null`). Dispatch a CustomEvent that\n          // GlobalAskAI listens for — opens chat + drills via\n          // `entityIdFilter` (primary-key only, same as inline-card Ask).\n          setKeepOpen(false)\n          window.dispatchEvent(\n            new CustomEvent('ask-ai:open-with-ref', { detail: action.detail }),\n          )\n          return\n        case 'route':\n          // Final fallback: legacy navigation by path. Hits when a row\n          // has neither URL nor pk metadata — a mapper/API regression.\n          setKeepOpen(false)\n          onNavigate(action.path)\n          return\n        case 'noop':\n          return\n      }\n    },\n    [onNavigate, source, baseRoute, router, onInPageSwap, runtime],\n  )\n\n  // Reset keepOpen when query changes.\n  useEffect(() => {\n    setKeepOpen(false)\n  }, [query])\n\n  return {\n    query,\n    setQuery,\n    results,\n    isLoading,\n    handleResultSelect,\n    keepDropdownOpen: keepOpen,\n  }\n}\n"]}
+{"version":3,"sources":["/home/runner/work/openframe-oss-lib/openframe-oss-lib/openframe-frontend-core/dist/chunk-4RI7S6ZD.cjs","../src/components/shared/doc-search/format-relative-path.ts","../src/components/shared/doc-search/doc-search-result-row.tsx","../src/components/shared/doc-search/doc-search-bar.tsx","../src/components/shared/doc-search/map-doc-search-results.ts","../src/components/shared/doc-search/resolve-search-result-action.ts","../src/components/shared/doc-search/use-doc-search.ts"],"names":["jsx"],"mappings":"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","file":"/home/runner/work/openframe-oss-lib/openframe-oss-lib/openframe-frontend-core/dist/chunk-4RI7S6ZD.cjs","sourcesContent":[null,"/**\n * Format a full document path as a breadcrumb trail.\n * Shows parent folders only (excludes the last segment / filename).\n *\n * @example\n *   formatRelativePath('openframe-oss-tenant/architecture/api-controllers.md')\n *   // → 'Openframe oss tenant / Architecture'\n */\nexport function formatRelativePath(fullPath: string): string {\n  if (!fullPath) return ''\n  const segments = fullPath.replace(/\\.md$/, '').split('/')\n  // Show only parent path (exclude the filename itself since the title already shows it)\n  const parentSegments = segments.length > 1 ? segments.slice(0, -1) : segments\n  return parentSegments\n    .map((seg) => seg.charAt(0).toUpperCase() + seg.slice(1).replace(/-/g, ' '))\n    .join(' / ')\n}\n","'use client'\n\n/**\n * Single row in the `<SearchInput>` dropdown — the standard layout\n * used by every doc-search-backed surface (company-hub data-room\n * search bar, onboarding-guide catalog search, …). Single source of\n * truth for the row appearance so search dropdowns are visually\n * identical everywhere.\n *\n * Resolves the source icon via the same `resolveSourceIcon()`\n * registry the inline chat-card refs use, so a row pointing at e.g.\n * an onboarding-guide surfaces the SAME `<GraduationCap>` glyph the\n * chat card surfaces — no cross-surface drift.\n */\n\nimport { resolveSourceIcon } from '../../chat/utils/source-row-cta'\nimport { formatRelativePath } from './format-relative-path'\n\n/**\n * Minimal result shape this row renders. Compatible with any\n * doc-search hook whose result type exposes `{ title?, path?,\n * metadata? }`. The two hub consumers (onboarding-guide catalog,\n * data-room sidebar) both satisfy this shape via their\n * `useDocSearch` hook result.\n */\nexport interface DocSearchResultRowEntry {\n  title?: string\n  path?: string\n  metadata?: Record<string, unknown>\n}\n\nexport interface DocSearchResultRowProps {\n  result: DocSearchResultRowEntry\n  isHighlighted: boolean\n}\n\nexport function DocSearchResultRow({\n  result,\n  isHighlighted,\n}: DocSearchResultRowProps) {\n  const docType = (result.metadata?.documentType as string) || undefined\n  const sourceRepo = (result.metadata?.sourceRepo as string) || undefined\n  const { Icon: SourceIcon, label: iconLabel } = resolveSourceIcon({\n    sourceRepo,\n    documentType: docType,\n  })\n  const isGroup = result.metadata?.isGroup as boolean | undefined\n\n  return (\n    <div className=\"flex items-center gap-3 w-full min-w-0\">\n      <span\n        className=\"flex-shrink-0 text-ods-text-secondary\"\n        title={iconLabel}\n      >\n        <SourceIcon className=\"size-4\" />\n      </span>\n      <div className=\"min-w-0 flex-1\">\n        <div\n          className={`text-sm font-medium leading-5 truncate ${\n            isHighlighted ? 'text-ods-accent' : 'text-ods-text-primary'\n          }`}\n        >\n          {result.title || result.path}\n        </div>\n        {!isGroup && result.path?.includes('/') && (\n          <div className=\"text-xs leading-4 text-ods-text-secondary truncate mt-0.5\">\n            {formatRelativePath(result.path)}\n          </div>\n        )}\n      </div>\n    </div>\n  )\n}\n","'use client'\n\n/**\n * `<DocSearchBar>` — the canonical RAG-search dropdown surface.\n *\n * Mounted by every doc-search consumer (data-room sidebar, onboarding-\n * guide catalog, and any future surface that needs typeahead against\n * `/api/docs/search`). Wraps `<SearchInput>` with the lib's standard\n * `<DocSearchResultRow>` so the dropdown looks identical everywhere.\n *\n * ## Why a presentation component, not a \"search bar that owns its\n *    own hook\"\n *\n * The data-fetching hook (`useDocSearch`) lives hub-side because it\n * depends on hub-only context (`useDocNavigation`, the rag-table-\n * config registry, the hub's `decideNewTab` helper). Moving the hook\n * would cascade ~5 more file migrations into the lib.\n *\n * Instead, the hook stays hub-side and callers pass its result into\n * this component as plain props. Both consumers shrink to ~5 lines.\n */\n\nimport type { ReactNode } from 'react'\nimport { SearchInput, type SearchResult } from '../../ui/search-input'\nimport { DocSearchResultRow } from './doc-search-result-row'\n\nexport interface DocSearchBarProps {\n  placeholder: string\n  query: string\n  onQueryChange: (value: string) => void\n  /** Hook-fetched results. Reuses the lib's `<SearchInput>` `SearchResult`\n   *  shape directly so callers don't translate. */\n  results: SearchResult[]\n  isLoading: boolean\n  /** Result selection handler. Mirrors `<SearchInput>` — the second\n   *  `modifiers` argument is preserved so cmd-click / shift-click on\n   *  a result row still forces new-tab behavior. Hub `useDocSearch`\n   *  reads these to short-circuit to `window.open()`. */\n  onResultSelect: (\n    result: SearchResult,\n    modifiers?: {\n      metaKey?: boolean\n      ctrlKey?: boolean\n      shiftKey?: boolean\n      altKey?: boolean\n      button?: number\n    },\n  ) => void\n  /** Lets the caller's hook force the dropdown open after a recent\n   *  internal action (e.g. result navigation). `undefined` falls back\n   *  to `<SearchInput>`'s built-in focus/hover heuristics. */\n  showDropdown?: boolean\n  /** Defaults to 2 — matches the existing data-room and onboarding-\n   *  guide consumers. Override only if a surface needs different\n   *  typeahead semantics. */\n  minQueryLength?: number\n  /** Defaults to 0 — both existing consumers debounce inside the\n   *  hook, not the input. */\n  debounceMs?: number\n  className?: string\n  /** Optional row-renderer override. Defaults to the lib's standard\n   *  `<DocSearchResultRow>` (source icon + title + path breadcrumb).\n   *  Override only when a surface needs custom row chrome. */\n  renderResult?: (result: SearchResult, isHighlighted: boolean) => ReactNode\n}\n\nexport function DocSearchBar({\n  placeholder,\n  query,\n  onQueryChange,\n  results,\n  isLoading,\n  onResultSelect,\n  showDropdown,\n  minQueryLength = 2,\n  debounceMs = 0,\n  className = 'w-full',\n  renderResult,\n}: DocSearchBarProps) {\n  return (\n    <SearchInput\n      placeholder={placeholder}\n      value={query}\n      onChange={onQueryChange}\n      results={results}\n      isLoading={isLoading}\n      onResultSelect={onResultSelect}\n      showDropdown={showDropdown || undefined}\n      debounceMs={debounceMs}\n      minQueryLength={minQueryLength}\n      className={className}\n      renderResult={\n        renderResult ??\n        ((result, isHighlighted) => (\n          <DocSearchResultRow result={result} isHighlighted={isHighlighted} />\n        ))\n      }\n    />\n  )\n}\n","/**\n * Map RAG `/api/docs/search` wire results into the `<DocSearchBar>`\n * dropdown's row shape, collapsing entity-table rows into grouped\n * results so the dropdown lists ONE \"Cap Table (12 records)\" row\n * instead of 12 individual rows.\n *\n * Pure transform — no telemetry, no navigation, no React deps. Lifted\n * from the hub's `hooks/use-docs.ts:mapDocSearchResults` (the hub's\n * `traceCompose` call was hub-only telemetry and is intentionally\n * dropped — callers that want logging can wrap this helper).\n */\n\nimport type { SearchResult } from '../../ui/search-input'\nimport type { DocSearchResult } from './types'\n\n/** Source repos that should be collapsed into grouped results in the search bar.\n *  Only financial tables (all rows link to the same admin page).\n *  Content tables (blog, webinar, podcast, etc.) stay individual since each has a unique URL. */\nconst SEARCH_GROUP_REPOS = new Set([\n  'financial-cap-table',\n  'financial-kpis',\n  'financial-pnl',\n  'financial-balance-sheet',\n  'financial-cash-flow',\n])\n\nconst ENTITY_LABELS: Record<string, string> = {\n  'financial-cap-table': 'Cap Table',\n  'financial-kpis': 'Financial KPIs',\n  'financial-pnl': 'Profit & Loss',\n  'financial-balance-sheet': 'Balance Sheets',\n  'financial-cash-flow': 'Cash Flow',\n  'blog-posts': 'Blog Posts',\n  'product-releases': 'Product Releases',\n  'case-studies': 'Case Studies',\n  webinars: 'Webinars',\n  events: 'Events',\n  podcasts: 'Podcasts',\n}\n\nexport function mapDocSearchResults(docs: DocSearchResult[]): SearchResult[] {\n  const entityGroups = new Map<string, DocSearchResult[]>()\n  // Track insertion order — groups appear where the FIRST row of that\n  // repo appeared in the response.\n  const order: Array<\n    { type: 'entity'; repo: string } | { type: 'doc'; doc: DocSearchResult }\n  > = []\n  const seenRepos = new Set<string>()\n\n  for (const doc of docs) {\n    if (doc.sourceRepo && SEARCH_GROUP_REPOS.has(doc.sourceRepo)) {\n      const group = entityGroups.get(doc.sourceRepo) || []\n      group.push(doc)\n      entityGroups.set(doc.sourceRepo, group)\n      if (!seenRepos.has(doc.sourceRepo)) {\n        seenRepos.add(doc.sourceRepo)\n        order.push({ type: 'entity', repo: doc.sourceRepo })\n      }\n    } else {\n      order.push({ type: 'doc', doc })\n    }\n  }\n\n  const results: SearchResult[] = []\n  for (const entry of order) {\n    if (entry.type === 'entity') {\n      const rows = entityGroups.get(entry.repo)!\n      const label = ENTITY_LABELS[entry.repo] || entry.repo\n      results.push({\n        id: `group-${entry.repo}`,\n        title: `${label} (${rows.length} ${rows.length === 1 ? 'record' : 'records'})`,\n        path: rows[0].path,\n        type: 'file',\n        metadata: {\n          documentType: rows[0].documentType,\n          externalUrl: rows[0].externalUrl,\n          sourceRepo: entry.repo,\n          id: rows[0].entityId,\n          isGroup: true,\n          items: rows.map((r) => ({\n            name: r.name,\n            externalUrl: r.externalUrl,\n            id: r.entityId,\n            sourceRepo: r.sourceRepo,\n            documentType: r.documentType,\n          })),\n        },\n      })\n    } else {\n      const doc = entry.doc\n      const isNonMarkdown = doc.documentType && doc.documentType !== 'markdown'\n      results.push({\n        id: doc.path,\n        title: doc.name,\n        description: isNonMarkdown ? doc.name : doc.snippet,\n        path: doc.path,\n        type: doc.type,\n        metadata: {\n          matchType: doc.matchType,\n          ...(doc.documentType ? { documentType: doc.documentType } : {}),\n          ...(doc.externalUrl ? { externalUrl: doc.externalUrl } : {}),\n          ...(doc.targetPlatform != null\n            ? { targetPlatform: doc.targetPlatform }\n            : {}),\n          ...(doc.sourceRepo ? { sourceRepo: doc.sourceRepo } : {}),\n          ...(doc.entityId ? { id: doc.entityId } : {}),\n        },\n      })\n    }\n  }\n\n  return results\n}\n","/**\n * Resolve what should happen when the user picks a search result.\n * Returns one of five typed actions so the caller is a single switch.\n *\n * Resolution order:\n *  1. `externalUrl` present → use `decideNewTab` to choose same-tab vs\n *     new-tab against the row's `targetPlatform`.\n *  2. Row has `id` + `sourceRepo` + `documentType` → synth an Ask-AI\n *     action (entity drill-in via primary key, no URL).\n *  3. Row has only `path` → legacy navigation fallback.\n *  4. Nothing actionable → noop.\n *\n * Lifted from the hub's `hooks/use-docs.ts:resolveSearchResultAction`.\n * Pure — no React, no telemetry.\n */\n\nimport type { SearchResult } from '../../ui/search-input'\nimport type { ChatRef } from '../../chat/chat-ref.types'\nimport { decideNewTab } from '../../chat/utils/decide-new-tab'\n\nexport type SearchResultAction =\n  | { kind: 'navigate-same-tab'; href: string }\n  | { kind: 'navigate-new-tab'; href: string }\n  | { kind: 'ask-ai'; detail: { source: string; ref: ChatRef } }\n  | { kind: 'route'; path: string }\n  | { kind: 'noop' }\n\nexport function resolveSearchResultAction(\n  result: SearchResult,\n  source: string,\n  runtimeMode?: 'host' | 'embed',\n): SearchResultAction {\n  const meta = result.metadata ?? {}\n  const externalUrl = meta.externalUrl as string | undefined\n  if (externalUrl) {\n    // Same pure helper `useNavLink` and `useUnifiedNav` call — single\n    // decision rule across cards, chips, and autocomplete rows. Thread\n    // the caller's `source` as `currentSource` so the platform-vs-\n    // platform comparison matches the hub's pre-migration behavior.\n    const targetPlatform = meta.targetPlatform as string | null | undefined\n    const isNewTab = decideNewTab({\n      href: externalUrl,\n      targetPlatform,\n      surface: 'useUnifiedNav',\n      runtimeMode,\n      currentSource: source,\n    })\n    return isNewTab\n      ? { kind: 'navigate-new-tab', href: externalUrl }\n      : { kind: 'navigate-same-tab', href: externalUrl }\n  }\n  const rowId = meta.id as string | undefined\n  const sourceRepo = meta.sourceRepo as string | undefined\n  const documentType = meta.documentType as string | undefined\n  if (rowId && sourceRepo && documentType) {\n    return {\n      kind: 'ask-ai',\n      detail: {\n        source,\n        ref: { type: documentType, id: rowId, title: result.title, url: null },\n      },\n    }\n  }\n  if (result.path) {\n    return { kind: 'route', path: result.path }\n  }\n  return { kind: 'noop' }\n}\n","'use client'\n\n/**\n * `useDocSearch` — debounced RAG-search hook against `/api/docs/search`.\n *\n * Pure fetch + navigation glue. Embedders can mount this directly\n * (any host with a reverse-proxy that exposes `/api/docs/search` will\n * work). Hub callers wire it into the lib `<DocSearchBar>` for the\n * canonical typeahead dropdown.\n *\n * ## What moved from hub to lib\n *\n * Lifted from `multi-platform-hub/hooks/use-docs.ts:useDocSearch`. Two\n * hub-only concerns are now optional injection points instead of\n * direct imports:\n *\n *   - `useDocNavigation()` (hub's in-page doc-tree swap) → optional\n *     `onInPageSwap?: (path: string) => boolean` config callback. When\n *     present and returns true, the hook treats a same-origin result\n *     click as \"handled in-page\"; when absent or returns false, the\n *     hook falls back to `onNavigate(path)` (`router.push` on hub,\n *     `window.location.assign` on bare embedders).\n *   - `traceCompose` (hub-only telemetry) → dropped. The lib has no\n *     equivalent runtime-context yet; bring it back when there is one.\n *\n * Everything else (debounce, `useChatRuntime` for embed-mode short-\n * circuit, embed-shim router, the action-resolver + result-mapper) is\n * now lib-resident.\n */\n\nimport { useState, useEffect, useCallback } from 'react'\nimport { useRouter } from '../../../embed-shims'\nimport { useDebounce } from '../../../hooks/ui/use-debounce'\nimport { useChatRuntime } from '../../../contexts/chat-runtime-context'\nimport { contentFetch } from '../../../utils/embed-content-fetch'\nimport type { SearchResult } from '../../ui/search-input'\nimport {\n  resolveExternalNavigation,\n  stripSameOriginToPath,\n  NEW_TAB_FEATURES,\n} from '../../chat/utils/chat-nav-resolution'\nimport type { DocSearchResult } from './types'\nimport { mapDocSearchResults } from './map-doc-search-results'\nimport { resolveSearchResultAction } from './resolve-search-result-action'\n\nexport interface UseDocSearchConfig {\n  /** Discriminator passed to `/api/docs/search?source=` (e.g.\n   *  `'openframe'`). Embedders set it to whatever discriminator their\n   *  reverse-proxy expects. */\n  source: string\n  /** Base route prefix this search lives under (e.g. `'/onboarding-guides'`).\n   *  When a result's href starts with `${baseRoute}/`, the hook\n   *  attempts the optional in-page swap path before falling through\n   *  to a full nav. */\n  baseRoute: string\n  /** Imperative navigation fallback. Called when no override\n   *  (in-page swap, new-tab) applies. Hub callers pass\n   *  `(path) => router.push(path)`; embedders pass an equivalent. */\n  onNavigate: (path: string) => void\n  /** Optional `RagTableConfig.id` list to narrow the search to specific\n   *  tables (e.g. `['onboarding-guides']`). Forwarded to\n   *  `/api/docs/search?tableIds=…` which intersects with the source's\n   *  standing set. */\n  tableIds?: string[]\n  /** Optional in-page swap callback. When the result's href is under\n   *  `baseRoute` AND this callback returns true, the hook treats the\n   *  click as handled in-page (no router push). Hub's\n   *  `<DocumentationSection>` wires this to\n   *  `useDocNavigation().navigate(path)`. */\n  onInPageSwap?: (path: string) => boolean\n  /** Optional endpoint override. Defaults to `'/api/docs/search'`\n   *  (the hub's reverse-proxy route). Embedders with a different\n   *  path can override. */\n  searchEndpoint?: string\n}\n\nexport function useDocSearch(config: UseDocSearchConfig) {\n  const {\n    source,\n    baseRoute,\n    onNavigate,\n    tableIds,\n    onInPageSwap,\n    searchEndpoint,\n  } = config\n  const tableIdsKey = tableIds && tableIds.length > 0 ? tableIds.join(',') : ''\n\n  const router = useRouter()\n  // Optional chat-runtime read — when present and mode='embed' the\n  // search-result row click short-circuits to a new-tab open against\n  // the absolutized URL. Null/host preserves today's behavior.\n  // Also used as the proxy-prefix fallback for `searchEndpoint`, matching\n  // how tickets resolves `findTicketUrl`.\n  const runtime = useChatRuntime()\n  const resolvedSearchEndpoint =\n    searchEndpoint ?? runtime?.endpoints.docsSearchUrl ?? '/api/docs/search'\n\n  const [query, setQuery] = useState('')\n  const [results, setResults] = useState<SearchResult[]>([])\n  const [isFetching, setIsFetching] = useState(false)\n  const debouncedQuery = useDebounce(query, 300)\n\n  useEffect(() => {\n    if (!debouncedQuery || debouncedQuery.trim().length < 2) {\n      setResults([])\n      setIsFetching(false)\n      return\n    }\n\n    let cancelled = false\n\n    async function fetchResults() {\n      setIsFetching(true)\n      try {\n        const params = new URLSearchParams({\n          q: debouncedQuery,\n          source,\n          limit: '10',\n        })\n        if (tableIdsKey) params.set('tableIds', tableIdsKey)\n\n        const response = await contentFetch(`${resolvedSearchEndpoint}?${params.toString()}`)\n        if (!response.ok) {\n          throw new Error(`Search request failed: ${response.status}`)\n        }\n\n        const json = await response.json()\n\n        if (!cancelled && json.success && Array.isArray(json.data)) {\n          const mapped = mapDocSearchResults(json.data as DocSearchResult[])\n          setResults(mapped)\n        }\n      } catch (error) {\n        console.error('Doc search error:', error)\n        if (!cancelled) {\n          setResults([])\n        }\n      } finally {\n        if (!cancelled) {\n          setIsFetching(false)\n        }\n      }\n    }\n\n    fetchResults()\n\n    return () => {\n      cancelled = true\n    }\n  }, [debouncedQuery, source, tableIdsKey, resolvedSearchEndpoint])\n\n  // Derived loading state — single source of truth for \"should the\n  // dropdown show 'Loading...' instead of 'No results found'\":\n  const isLoading =\n    query.trim().length >= 2 && (query !== debouncedQuery || isFetching)\n\n  // Track whether dropdown should stay open (external link opened in new tab).\n  const [keepOpen, setKeepOpen] = useState(false)\n\n  const handleResultSelect = useCallback(\n    (\n      result: SearchResult,\n      modifiers?: {\n        metaKey?: boolean\n        ctrlKey?: boolean\n        shiftKey?: boolean\n        altKey?: boolean\n        button?: number\n      },\n    ) => {\n      const action = resolveSearchResultAction(\n        result,\n        source,\n        runtime?.navigation.mode,\n      )\n      // Modifier / non-primary mouse click → force new tab regardless of\n      // same-tab/new-tab decision. The dropdown row is a `<div>`, not an\n      // `<a target=\"_blank\">`, so the browser doesn't background-tab\n      // natively on cmd-click. Honor it explicitly here for parity with\n      // the anchor-based surfaces (cards, chips, related-content). Plain\n      // Enter from the keyboard passes `modifiers === undefined`.\n      const wantsNewTab =\n        modifiers &&\n        (modifiers.metaKey ||\n          modifiers.ctrlKey ||\n          modifiers.shiftKey ||\n          modifiers.altKey ||\n          (typeof modifiers.button === 'number' && modifiers.button !== 0))\n      switch (action.kind) {\n        case 'navigate-same-tab': {\n          // Embed-mode short-circuit — autocomplete row clicked while\n          // the chat panel is hosted inside an embedding app.\n          if (runtime?.navigation.mode === 'embed') {\n            setKeepOpen(true)\n            const targetPlatform =\n              (result.metadata?.targetPlatform as string | null | undefined) ?? null\n            resolveExternalNavigation({\n              href: action.href,\n              targetPlatform,\n              runtime,\n            }).open()\n            return\n          }\n          if (wantsNewTab) {\n            setKeepOpen(true)\n            window.open(action.href, '_blank', NEW_TAB_FEATURES)\n            return\n          }\n          // Same-origin click:\n          //   1. If the href is under the current doc-tree's baseRoute AND\n          //      an `onInPageSwap` callback is wired AND returns true →\n          //      consider in-page swap handled.\n          //   2. Otherwise → embed-shim `router.push()` (soft RSC nav on\n          //      Next.js hosts, window.location.assign on bare hosts).\n          setKeepOpen(false)\n          const path =\n            baseRoute && action.href.startsWith(`${baseRoute}/`)\n              ? action.href.slice(baseRoute.length + 1)\n              : null\n          if (path && onInPageSwap?.(path)) return\n          router.push(stripSameOriginToPath(action.href))\n          return\n        }\n        case 'navigate-new-tab':\n          // Cross-origin (e.g. clicking a flamingo.run release from\n          // product-hub) — open in a new tab. Keep dropdown open so the\n          // user can pick another result without re-searching.\n          setKeepOpen(true)\n          window.open(action.href, '_blank', NEW_TAB_FEATURES)\n          return\n        case 'ask-ai':\n          // Row is searchable-but-not-openable (cap_table positions,\n          // financial-kpi snapshots, anything backed by\n          // `resolveUrl: () => null`). Dispatch a CustomEvent that\n          // GlobalAskAI listens for — opens chat + drills via\n          // `entityIdFilter` (primary-key only, same as inline-card Ask).\n          setKeepOpen(false)\n          window.dispatchEvent(\n            new CustomEvent('ask-ai:open-with-ref', { detail: action.detail }),\n          )\n          return\n        case 'route':\n          // Final fallback: legacy navigation by path. Hits when a row\n          // has neither URL nor pk metadata — a mapper/API regression.\n          setKeepOpen(false)\n          onNavigate(action.path)\n          return\n        case 'noop':\n          return\n      }\n    },\n    [onNavigate, source, baseRoute, router, onInPageSwap, runtime],\n  )\n\n  // Reset keepOpen when query changes.\n  useEffect(() => {\n    setKeepOpen(false)\n  }, [query])\n\n  return {\n    query,\n    setQuery,\n    results,\n    isLoading,\n    handleResultSelect,\n    keepDropdownOpen: keepOpen,\n  }\n}\n"]}

package/dist/{chunk-EEVOKQGR.js → chunk-4YV5U7GA.js}

@@ -3,11 +3,11 @@ import {
   FileDownloadCard,
   GoogleSheetsViewer,
   PdfViewer
-} from "./chunk-GC4CNBTS.js";
+} from "./chunk-QWMYOUGP.js";
 import {
   DocSearchBar,
   useDocSearch
-} from "./chunk-KKSZQLGC.js";
+} from "./chunk-QPTJOLAP.js";
 import {
   DEFAULT_FOLDER_INDEX_FILE,
   FigmaEmbed,
@@ -19,7 +19,7 @@ import {
   findDocNodeByPath,
   getDocAncestorNodeIds,
   stripFolderIndexFromPath
-} from "./chunk-UEGSCIAW.js";
+} from "./chunk-ER4CMF47.js";
 import {
   HUB_HEADER_OFFSET_PX,
   contentFetch,
@@ -1048,6 +1048,21 @@ function scrollToContent() {
     window.scrollTo({ top: 0, behavior: "smooth" });
   }
 }
+function findFirstDocPath(folder) {
+  const children = folder.children ?? [];
+  for (const child of children) {
+    if (child.type === "file" && !child.path.toLowerCase().endsWith(".mmd")) {
+      return child.path;
+    }
+  }
+  for (const child of children) {
+    if (child.type === "folder") {
+      const nested = findFirstDocPath(child);
+      if (nested) return nested;
+    }
+  }
+  return null;
+}
 function useDocumentTree(config, initialPath) {
   const { structureEndpoint, contentEndpoint, baseRoute } = config;
   const folderIndexFile = config.folderIndexFile ?? DEFAULT_FOLDER_INDEX_FILE;
@@ -1119,11 +1134,19 @@ function useDocumentTree(config, initialPath) {
     } else {
       const node = findDocNodeByPath(selectedPath, structure);
       if (node && node.type === "folder" && !node.hasReadme) {
-        return;
-      }
-      pathToFetch = selectedPath;
-      if (node && node.type === "folder" && node.hasReadme) {
+        const firstDocPath = findFirstDocPath(node);
+        if (!firstDocPath) {
+          lastFetchedPath.current = null;
+          setError(null);
+          setContent(null);
+          setIsLoadingContent(false);
+          return;
+        }
+        pathToFetch = firstDocPath;
+      } else if (node && node.type === "folder" && node.hasReadme) {
         pathToFetch = `${selectedPath}/${folderIndexFile}`;
+      } else {
+        pathToFetch = selectedPath;
       }
     }
     if (pathToFetch === lastFetchedPath.current) {
@@ -1189,6 +1212,17 @@ function useDocumentTree(config, initialPath) {
             setContent(null);
             return;
           }
+          const probe = findDocNodeByPath(
+            stripFolderIndexFromPath(path, folderIndexFile),
+            structure
+          );
+          const probeIsNoReadmeFolder = !!probe && probe.type === "folder" && !probe.hasReadme;
+          const preStructureFolderLike = structure.length === 0 && !path.endsWith(".md");
+          if (probeIsNoReadmeFolder || preStructureFolderLike) {
+            setError(null);
+            setContent(null);
+            return;
+          }
           setError(result2.error || "Documentation file not found");
           setContent(null);
           return;
@@ -1238,33 +1272,19 @@ function useDocumentTree(config, initialPath) {
           const ancestorIds = getDocAncestorNodeIds(node.path);
           ancestorIds.pop();
           return new Set(ancestorIds);
-        } else {
-          return new Set(getDocAncestorNodeIds(node.path));
         }
+        return new Set(getDocAncestorNodeIds(node.path));
       });
-      if (node.hasReadme) {
-        lastFetchedPath.current = null;
-        setSelectedPath(node.path);
-        window.history.pushState({}, "", `${normalizedBaseRoute}/${node.path}`);
-        setTimeout(() => {
-          scrollToContent();
-        }, 150);
-      } else {
-        setSelectedPath(node.path);
-      }
     } else {
       const lastSlash = node.path.lastIndexOf("/");
       if (lastSlash > 0) {
-        const parentPath = node.path.substring(0, lastSlash);
-        setExpandedNodes(new Set(getDocAncestorNodeIds(parentPath)));
+        setExpandedNodes(new Set(getDocAncestorNodeIds(node.path.substring(0, lastSlash))));
       }
-      lastFetchedPath.current = null;
-      setSelectedPath(node.path);
-      window.history.pushState({}, "", `${normalizedBaseRoute}/${node.path}`);
-      setTimeout(() => {
-        scrollToContent();
-      }, 150);
     }
+    lastFetchedPath.current = null;
+    setSelectedPath(node.path);
+    window.history.pushState({}, "", `${normalizedBaseRoute}/${node.path}`);
+    setTimeout(scrollToContent, 150);
   }, [normalizedBaseRoute]);
   const navigateToDoc = useCallback2((path, options) => {
     const hashIndex = path.indexOf("#");
@@ -1833,4 +1853,4 @@ export {
   EmbedSkeleton,
   DocsHubPage
 };
-//# sourceMappingURL=chunk-EEVOKQGR.js.map
+//# sourceMappingURL=chunk-4YV5U7GA.js.map