@flamingo-stack/openframe-frontend-core 0.0.508 → 0.0.509

package/dist/chunk-WA7RR64F.js.map

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

package/dist/chunk-WK4N5VBX.cjs.map

@@ -1 +0,0 @@
-{"version":3,"sources":["/home/runner/work/openframe-oss-lib/openframe-oss-lib/openframe-frontend-core/dist/chunk-WK4N5VBX.cjs","../src/components/onboarding-guides/onboarding-guides-catalog-view.tsx","../src/components/onboarding-guides/onboarding-guides-catalog-skeleton.tsx","../src/components/onboarding-guides/onboarding-guide-detail-view.tsx","../src/components/onboarding-guides/hooks/use-onboarding-guides.ts"],"names":["jsx","jsxs"],"mappings":"AAAA,6rBAAY;AACZ;AACE;AACA;AACF,wDAA6B;AAC7B;AACE;AACA;AACF,wDAA6B;AAC7B;AACE;AACF,wDAA6B;AAC7B;AACE;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACF,wDAA6B;AAC7B;AACE;AACF,wDAA6B;AAC7B;AACE;AACA;AACF,wDAA6B;AAC7B;AACE;AACF,wDAA6B;AAC7B;AACA;AClBA,8BAAuD;AACvD,2CAA8B;ADoB9B;AACA;AElBQ,+CAAA;AAPD,SAAS,+BAAA,CAAA,EAAkC;AAChD,EAAA,uBACE,8BAAA,KAAC,EAAA,EAAI,SAAA,EAAU,2CAAA,EAIb,QAAA,EAAA;AAAA,oBAAA,8BAAA,KAAC,EAAA,EAAI,SAAA,EAAU,WAAA,EACb,QAAA,EAAA;AAAA,sBAAA,6BAAA,KAAC,EAAA,EAAI,SAAA,EAAU,8DAAA,CAA8D,CAAA;AAAA,sBAC7E,8BAAA,KAAC,EAAA,EAAI,SAAA,EAAU,uFAAA,EACb,QAAA,EAAA;AAAA,wBAAA,6BAAA,KAAC,EAAA,EAAI,SAAA,EAAU,oCAAA,CAAoC,CAAA;AAAA,QAClD,CAAC,CAAA,EAAG,CAAA,EAAG,CAAA,EAAG,CAAC,CAAA,CAAE,GAAA,CAAI,CAAC,CAAA,EAAA,mBACjB,6BAAA;AAAA,UAAC,KAAA;AAAA,UAAA;AAAA,YAEC,SAAA,EAAU;AAAA,UAAA,CAAA;AAAA,UADL;AAAA,QAEP,CACD;AAAA,MAAA,EAAA,CACH;AAAA,IAAA,EAAA,CACF,CAAA;AAAA,oBACA,6BAAA,KAAC,EAAA,EAAI,SAAA,EAAU,YAAA,EACZ,QAAA,EAAA,CAAC,CAAA,EAAG,CAAA,EAAG,CAAC,CAAA,CAAE,GAAA,CAAI,CAAC,SAAA,EAAW,UAAA,EAAA,mBACzB,8BAAA,SAAC,EAAA,EAAyB,SAAA,EAAU,WAAA,EAClC,QAAA,EAAA;AAAA,sBAAA,8BAAA,IAAC,EAAA,EAAG,SAAA,EAAU,0EAAA,EACZ,QAAA,EAAA;AAAA,wBAAA,6BAAA,MAAC,EAAA,EAAK,SAAA,EAAU,oCAAA,CAAoC,CAAA;AAAA,wBACpD,6BAAA,MAAC,EAAA,EAAK,SAAA,EAAU,gDAAA,CAAgD;AAAA,MAAA,EAAA,CAClE,CAAA;AAAA,sBACA,6BAAA,IAAC,EAAA,EAAG,SAAA,EAAU,qBAAA,EACX,QAAA,EAAA,KAAA,CAAM,IAAA,CAAK,EAAE,MAAA,EAAQ,UAAU,CAAC,CAAA,CAAE,GAAA,CAAI,CAAC,CAAA,EAAG,OAAA,EAAA,mBACzC,6BAAA,IAAC,EAAA,EACC,QAAA,kBAAA,6BAAA,6CAAC,EAAA,EAA4B,IAAA,EAAK,UAAA,CAAU,EAAA,CAAA,EADrC,OAET,CACD,EAAA,CACH;AAAA,IAAA,EAAA,CAAA,EAXY,UAYd,CACD,EAAA,CACH;AAAA,EAAA,EAAA,CACF,CAAA;AAEJ;AFcA;AACA;ACuFM;AAvGC,SAAS,2BAAA,CAA4B;AAAA,EAC1C,aAAA;AAAA,EACA,eAAA;AAAA,EACA,eAAA,EAAiB,EAAA;AAAA,EACjB,cAAA;AAAA,EACA,gBAAA;AAAA,EACA,UAAA;AAAA,EACA,SAAA,EAAW;AACb,CAAA,EAAqC;AACnC,EAAA,MAAM,OAAA,EAAS,yCAAA,CAAU;AACzB,EAAA,MAAM,aAAA,EAAe,+CAAA,CAAgB;AACrC,EAAA,MAAM,CAAC,SAAA,EAAW,eAAe,EAAA,EAAI,kCAAA,CAAc;AACnD,EAAA,MAAM,QAAA,EAAU,8CAAA,CAAe;AAG/B,EAAA,MAAM,UAAA,EAAY,cAAA,IAAkB,KAAA,EAAA,GAAa,eAAA,IAAmB,KAAA,CAAA;AAGpE,EAAA,MAAM,aAAA,EAAe,UAAA,mBAAY,YAAA,CAAa,GAAA,CAAI,SAAS,CAAA,UAAK,KAAA,EAAK,cAAA;AACrE,EAAA,MAAM,cAAA,EAAgB,aAAA,GAAgB,KAAA;AAKtC,EAAA,MAAM,SAAA,EAAW,aAAA,EAAe,CAAA,SAAA,EAAY,kBAAA,CAAmB,YAAY,CAAC,CAAA,EAAA;AAC1D,EAAA;AAC+C,IAAA;AACjE,EAAA;AACoB,EAAA;AACiC,IAAA;AACrD,EAAA;AAOyD,EAAA;AACc,EAAA;AACnB,EAAA;AAItB,EAAA;AACsD,IAAA;AAC1D,IAAA;AACY,MAAA;AACpB,MAAA;AAC2D,QAAA;AACjD,QAAA;AACjB,MAAA;AAC6D,QAAA;AACpE,MAAA;AACF,IAAA;AACkC,IAAA;AACmC,MAAA;AACrE,IAAA;AAE2C,IAAA;AAElC,EAAA;AAEkB,EAAA;AACrB,IAAA;AAC4C,MAAA;AACsB,MAAA;AACxE,IAAA;AACwB,IAAA;AAC1B,EAAA;AAIsC,EAAA;AACsB,IAAA;AACrC,IAAA;AACI,MAAA;AAClB,IAAA;AACsB,MAAA;AAC7B,IAAA;AAC2B,IAAA;AACL,IAAA;AAC2B,MAAA;AAChD,IAAA;AACH,EAAA;AAGkC,EAAA;AACH,EAAA;AAC7B,IAAA;AACW,IAAA;AAC2B,IAAA;AACR,IAAA;AAC/B,EAAA;AAGqD,EAAA;AACO,IAAA;AACnD,MAAA;AACM,MAAA;AACZ,MAAA;AACiB,MAAA;AAClB,IAAA;AAECA,IAAAA;AAAC,MAAA;AAAA,MAAA;AACC,QAAA;AACU,QAAA;AACU,QAAA;AACf,QAAA;AAAA,MAAA;AACP,IAAA;AAEJ,EAAA;AACmC,EAAA;AAI/B,EAAA;AAAAA,oBAAAA;AAAC,MAAA;AAAA,MAAA;AACa,QAAA;AACK,QAAA;AACQ,QAAA;AACN,QAAA;AACE,QAAA;AACK,QAAA;AACF,QAAA;AAAA,MAAA;AAC1B,IAAA;AAEEA,IAAAA;AAAC,MAAA;AAAA,MAAA;AACO,QAAA;AACS,QAAA;AACA,QAAA;AACN,QAAA;AAAA,MAAA;AACX,IAAA;AAEJ,EAAA;AAKgC,EAAA;AACN,IAAA;AAC5B,EAAA;AAIsD,EAAA;AACZ,IAAA;AAC1C,EAAA;AAGiB,EAAA;AACZ,IAAA;AAEgB,IAAA;AACY,sBAAA;AACX,sBAAA;AAGD,sBAAA;AAO0B,IAAA;AAGrB,sBAAA;AACP,QAAA;AACW,wBAAA;AAGlB,MAAA;AAIG,sBAAA;AAMT,IAAA;AAEJ,EAAA;AAEJ;ADrC+E;AACA;AG/FnE;AAtB8B;AACxC,EAAA;AACA,EAAA;AACA,EAAA;AACA,EAAA;AACA,EAAA;AACA,EAAA;AACW,EAAA;AACQ,EAAA;AACnB,EAAA;AACA,EAAA;AACY,EAAA;AACD,EAAA;AACX,EAAA;AACQ,EAAA;AACyB;AACI,EAAA;AACN,EAAA;AACN,EAAA;AAIH,EAAA;AAGqD,EAAA;AACY,EAAA;AAIxB,EAAA;AAC5C,IAAA;AACyB,IAAA;AAC3C,EAAA;AAEoC,EAAA;AACG,IAAA;AACxC,EAAA;AACY,EAAA;AAKH,IAAA;AAAA;AAAA;AAIH,sBAAA;AAEJ,IAAA;AACF,EAAA;AAEuE,EAAA;AAKrE,EAAA;AAAM;AAGmE,EAAA;AAElB,EAAA;AACI,IAAA;AACnD,MAAA;AACE,MAAA;AACR,MAAA;AACa,MAAA;AACd,IAAA;AAC+C,IAAA;AAClD,EAAA;AACiD,EAAA;AAE1C,EAAA;AACLC,oBAAAA;AAAC,MAAA;AAAA,MAAA;AACgB,QAAA;AACH,QAAA;AACD,QAAA;AACkD,QAAA;AAG3D,QAAA;AAAsC,0BAAA;AAGtCD,0BAAAA;AAAC,YAAA;AAAA,YAAA;AACe,cAAA;AACd,cAAA;AACmB,cAAA;AACP,cAAA;AACV,gBAAA;AACoD,kBAAA;AAC3C,kBAAA;AACI,kBAAA;AACb,gBAAA;AACF,cAAA;AAAA,YAAA;AACF,UAAA;AAKG,UAAA;AACE,YAAA;AAAA,YAAA;AACqB,cAAA;AACa,cAAA;AACR,cAAA;AACR,cAAA;AAC2C,cAAA;AAC9C,cAAA;AACF,cAAA;AACC,cAAA;AACK,cAAA;AAClB,cAAA;AACA,cAAA;AAAA,YAAA;AAEJ,UAAA;AAKe,UAAA;AAMjBA,0BAAAA;AAAC,YAAA;AAAA,YAAA;AACwD,cAAA;AACtC,cAAA;AACN,cAAA;AACyB,cAAA;AACE,cAAA;AAAA,YAAA;AACxC,UAAA;AAKAA,0BAAAA;AAAC,YAAA;AAAA,YAAA;AACoC,cAAA;AACb,cAAA;AACE,cAAA;AACQ,cAAA;AAC1B,cAAA;AACN,cAAA;AAAA,YAAA;AACF,UAAA;AAIiB,UAAA;AACC,4BAAA;AAAmD,cAAA;AAChD,cAAA;AACjB,YAAA;AAEG,4BAAA;AAIL,UAAA;AAID,UAAA;AAAA,QAAA;AAAA,MAAA;AACH,IAAA;AACJ,EAAA;AACF;AHkF+E;AACA;AI9TtD;AAkBU;AACR,EAAA;AACuB,EAAA;AAEN,EAAA;AACU,EAAA;AACa,EAAA;AACV,EAAA;AAChD,EAAA;AAC6B,IAAA;AACgB,IAAA;AAEd,IAAA;AACe,IAAA;AACrD,EAAA;AACF;AAEsE;AACpD,EAAA;AACkC,IAAA;AACW,IAAA;AACtB,MAAA;AACqB,MAAA;AACG,MAAA;AACK,MAAA;AACG,MAAA;AACT,MAAA;AACM,MAAA;AAChD,MAAA;AAClB,IAAA;AACD,EAAA;AACH;AAE6D;AAC3C,EAAA;AACiC,IAAA;AACA,IAAA;AACW,MAAA;AACO,MAAA;AAC/C,MAAA;AAClB,IAAA;AACW,IAAA;AACZ,EAAA;AACH;AAE6C;AAC3B,EAAA;AACyB,IAAA;AACwB,IAAA;AACJ,MAAA;AAChD,MAAA;AACoD,QAAA;AAC7C,MAAA;AAClB,IAAA;AACW,IAAA;AACZ,EAAA;AACH;AJ0S+E;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA","file":"/home/runner/work/openframe-oss-lib/openframe-oss-lib/openframe-frontend-core/dist/chunk-WK4N5VBX.cjs","sourcesContent":[null,"'use client'\n\n/**\n * Public-facing catalog view for `/onboarding-guides`.\n *\n * Two data modes:\n *   - **controlled** (hub SSR): pass `initialGuides` + `initialSections`\n *     (server-fetched; section changes re-render the host with new props).\n *   - **self-fetching** (config-only embed): omit the data props and pass\n *     `guidesEndpoint` + `sectionsEndpoint` (the api routes). The view fetches\n *     the guides (refetching on `?section=` change) + the section list itself —\n *     no host data layer. (Plain fetch + useEffect, the DeliveryLists pattern.)\n *\n * The view renders ONLY its body + its OWN controls (the RAG `<DocSearchBar>` +\n * dynamic section pills — onboarding's controls are content-driven, unlike the\n * static search/filter the `DevSectionView` chrome ships). It does NOT render the\n * page chrome: the CALLER wraps it in `<DevSectionPage sectionKey=\"onboarding\">`\n * (hero + back button), exactly like the roadmap / releases / delivery pages — so\n * every dev-center surface composes the same way and the view stays embeddable in\n * tabbed contexts. Card hrefs flow through `runtime.composeContentUrl`.\n */\n\nimport { useMemo, useTransition, type ReactNode } from 'react'\nimport { GraduationCap } from 'lucide-react'\n\nimport { useRouter, useSearchParams } from '../../embed-shims'\nimport { useSelfFetch } from '../../hooks/use-self-fetch'\nimport { DocSearchBar, useDocSearch } from '../shared/doc-search'\nimport { FilterPillRow } from '../ui/filter-pill-row'\nimport { LoadError } from '../ui/error-state'\nimport { OnboardingGuideCard } from '../chat/entity-cards/onboarding-guide-card'\nimport { OnboardingGuidesCatalogSkeleton } from './onboarding-guides-catalog-skeleton'\nimport { useChatRuntime } from '../../contexts/chat-runtime-context'\nimport type { OnboardingGuide } from '../chat/types/entities/onboarding-guide'\nimport { resolveContentHref } from '../../utils/content-href'\n\ntype SectionSummary = { section: string; section_order: number; count: number }\n\nexport interface OnboardingGuidesCatalogViewProps {\n  /** Controlled / SSR: server-fetched guides. Omit + pass `guidesEndpoint`\n   *  for the self-fetching config-only mode. */\n  initialGuides?: OnboardingGuide[]\n  initialSections?: SectionSummary[]\n  initialSection?: string\n  /** Self-fetch: GET list endpoint (the api route). Appends `?section=`. */\n  guidesEndpoint?: string\n  /** Self-fetch: GET section-summary endpoint (the api route). */\n  sectionsEndpoint?: string\n  /** Optional per-row card renderer override. */\n  renderCard?: (guide: OnboardingGuide) => ReactNode\n  /** Base path the catalog is mounted under (fallback href prefix + `?section=`\n   *  push target). Default `/onboarding-guides`. */\n  basePath?: string\n}\n\nexport function OnboardingGuidesCatalogView({\n  initialGuides,\n  initialSections,\n  initialSection = '',\n  guidesEndpoint,\n  sectionsEndpoint,\n  renderCard,\n  basePath = '/onboarding-guides',\n}: OnboardingGuidesCatalogViewProps) {\n  const router = useRouter()\n  const searchParams = useSearchParams()\n  const [isPending, startTransition] = useTransition()\n  const runtime = useChatRuntime()\n\n  // Self-fetch only when the host supplied NO data but DID give an endpoint.\n  const selfFetch = initialGuides === undefined && guidesEndpoint !== undefined\n  // Active section: from the URL when self-fetching, from the prop (host RSC\n  // already read the URL server-side) when controlled.\n  const sectionValue = selfFetch ? searchParams.get('section') ?? '' : initialSection\n  const activeSection = sectionValue || 'all'\n\n  // Self-fetch the guides (refetched whenever `?section=` changes — it's folded\n  // into the url) + the section summaries. Controlled mode passes `null` urls so\n  // the hook never fetches. The guides fetch carries the error/retry affordance.\n  const guidesQs = sectionValue ? `?section=${encodeURIComponent(sectionValue)}` : ''\n  const guidesRes = useSelfFetch<{ data?: OnboardingGuide[] }>(\n    selfFetch && guidesEndpoint ? `${guidesEndpoint}${guidesQs}` : null,\n  )\n  const sectionsRes = useSelfFetch<SectionSummary[]>(\n    selfFetch && sectionsEndpoint ? sectionsEndpoint : null,\n  )\n\n  // Invariant: `guidesRes.data` is `null` until the first fetch resolves, then\n  // `{ data: [...] }`. The `?.data ?? []` chain collapses never-fetched (null) and\n  // legitimately-empty ([]) to the same `[]` — so the first-load skeleton gate below\n  // keys on the OUTER `guidesRes.data == null` to distinguish them (an empty section\n  // toggle keeps the chrome; only a true cold start shows the full-page skeleton).\n  const guides = initialGuides ?? guidesRes.data?.data ?? []\n  const sections = initialSections ?? (Array.isArray(sectionsRes.data) ? sectionsRes.data : [])\n  const isLoading = selfFetch ? guidesRes.isLoading : false\n\n  // Section grouping. Data arrives already filtered (server-side `?section=`\n  // for the host, or our `?section=` fetch); this just buckets visible rows.\n  const grouped = useMemo(() => {\n    const map = new Map<string, { section_order: number; guides: OnboardingGuide[] }>()\n    for (const g of guides) {\n      const existing = map.get(g.section)\n      if (existing) {\n        if (g.section_order < existing.section_order) existing.section_order = g.section_order\n        existing.guides.push(g)\n      } else {\n        map.set(g.section, { section_order: g.section_order, guides: [g] })\n      }\n    }\n    for (const entry of map.values()) {\n      entry.guides.sort((a, b) => a.step_order - b.step_order || a.title.localeCompare(b.title))\n    }\n    return Array.from(map.entries())\n      .map(([section, info]) => ({ section, ...info }))\n      .sort((a, b) => a.section_order - b.section_order || a.section.localeCompare(b.section))\n  }, [guides])\n\n  const sectionFilterOptions = useMemo(\n    () => [\n      { value: 'all', label: `All (${guides.length})` },\n      ...sections.map((s) => ({ value: s.section, label: `${s.section} (${s.count})` })),\n    ],\n    [guides.length, sections],\n  )\n\n  // Section pill change → push `?section=X`. Controlled mode: host RSC\n  // re-fetches. Self-fetch mode: our guides effect re-fetches on the URL change.\n  const setSection = (value: string) => {\n    const params = new URLSearchParams(searchParams.toString())\n    if (value === 'all') {\n      params.delete('section')\n    } else {\n      params.set('section', value)\n    }\n    const qs = params.toString()\n    startTransition(() => {\n      router.push(qs ? `${basePath}?${qs}` : basePath)\n    })\n  }\n\n  // Search bar — scoped to onboarding-guides only via RAG-search `tableIds`.\n  const source = runtime?.source ?? 'openframe'\n  const docSearch = useDocSearch({\n    source,\n    baseRoute: basePath,\n    onNavigate: (path) => router.push(path),\n    tableIds: ['onboarding-guides'],\n  })\n\n  // Per-row card renderer — runtime-composed href, fallback to relative.\n  const defaultRenderCard = (guide: OnboardingGuide) => {\n    const cta = resolveContentHref(runtime?.composeContentUrl, {\n      type: 'onboarding_guide',\n      slug: guide.slug,\n      basePath,\n      platforms: guide.onboarding_guide_platforms,\n    })\n    return (\n      <OnboardingGuideCard\n        guide={guide}\n        href={cta.href}\n        targetPlatform={cta.targetPlatform}\n        size=\"catalog\"\n      />\n    )\n  }\n  const renderCardFn = renderCard ?? defaultRenderCard\n\n  const preControls = (\n    <div className=\"space-y-4\">\n      <DocSearchBar\n        placeholder=\"Search onboarding guides, releases, case studies…\"\n        query={docSearch.query}\n        onQueryChange={docSearch.setQuery}\n        results={docSearch.results}\n        isLoading={docSearch.isLoading}\n        onResultSelect={docSearch.handleResultSelect}\n        showDropdown={docSearch.keepDropdownOpen}\n      />\n      {sections.length > 0 && (\n        <FilterPillRow\n          label=\"Section\"\n          selectedValue={activeSection}\n          onValueChange={setSection}\n          options={sectionFilterOptions}\n        />\n      )}\n    </div>\n  )\n\n  // A failed guides fetch → a RETRYABLE error (not the indistinguishable-from-\n  // empty \"no guides found\" state) — parity with the sibling self-fetch views.\n  if (selfFetch && guidesRes.error) {\n    return <LoadError message=\"Failed to load onboarding guides.\" onRetry={guidesRes.reload} />\n  }\n  // Full-page skeleton ONLY on the very first load (no data has loaded yet) — a\n  // later section toggle that legitimately returns ZERO guides keeps the page\n  // chrome (search + section pills) and dims the grid via the className below.\n  if (selfFetch && guidesRes.data == null && isLoading) {\n    return <OnboardingGuidesCatalogSkeleton />\n  }\n\n  return (\n    <div className=\"w-full flex flex-col gap-10\">\n      {preControls}\n      {guides.length === 0 ? (\n        <div className=\"text-center py-16\">\n          <GraduationCap className=\"h-12 w-12 text-ods-text-secondary mx-auto mb-4\" />\n          <h2 className=\"text-ods-text-primary text-h3 mb-2\">\n            No onboarding guides found\n          </h2>\n          <p className=\"text-ods-text-secondary text-h6\">\n            {activeSection !== 'all'\n              ? 'No guides in this section yet.'\n              : \"We're working on the onboarding library. Check back soon.\"}\n          </p>\n        </div>\n      ) : (\n        <div className={isPending || isLoading ? 'opacity-60 transition-opacity space-y-10' : 'space-y-10'}>\n          {grouped.map((sec) => (\n            <section key={sec.section} className=\"space-y-4\">\n              <h2 className=\"text-h3 text-ods-text-primary flex items-center gap-2\">\n                {sec.section}\n                <span className=\"inline-flex items-center justify-center rounded-full bg-ods-text-secondary/20 text-ods-text-secondary text-h6 px-2 py-0.5\">\n                  {sec.guides.length}\n                </span>\n              </h2>\n              {/* HORIZONTAL catalog list — single column so consecutive steps\n                  read top-to-bottom; a grid would visually reorder them. */}\n              <ul className=\"flex flex-col gap-4\">\n                {sec.guides.map((guide) => (\n                  <li key={guide.id}>{renderCardFn(guide)}</li>\n                ))}\n              </ul>\n            </section>\n          ))}\n        </div>\n      )}\n    </div>\n  )\n}\n","'use client'\n\nimport { OnboardingGuideCardSkeleton } from '../chat/entity-cards/onboarding-guide-card'\n\n/**\n * Loading skeleton for `/onboarding-guides` — CHROME-LESS, exactly like the\n * loaded `<OnboardingGuidesCatalogView>`. The HOST page owns the\n * `<DevSectionPage sectionKey=\"onboarding\">` shell (hero + back button);\n * this component renders only what replaces the view: the search/pill\n * placeholder block and the section card lists.\n *\n * HISTORY: this used to mount its own `<DevSectionPage>` — nested inside the\n * page's shell that double-rendered the hero + back button during loading\n * (the view was made chrome-less in the page restructure; the skeleton was\n * missed). Keep BOTH chrome-less.\n *\n * Wrapper mirrors the loaded view's `w-full flex flex-col gap-10`; per-card\n * height matches the loaded catalog card so resolve shifts are zero.\n */\nexport function OnboardingGuidesCatalogSkeleton() {\n  return (\n    <div className=\"w-full flex flex-col gap-10 animate-pulse\">\n      {/* Search input placeholder — matches `<SearchInput>` h-12 — plus the\n          section pill row (~74 px incl. padding), same as the loaded\n          preControls block. */}\n      <div className=\"space-y-4\">\n        <div className=\"h-12 w-full bg-ods-card border border-ods-border rounded-md\" />\n        <div className=\"flex flex-wrap items-center gap-3 p-4 bg-ods-card border border-ods-border rounded-lg\">\n          <div className=\"h-4 w-14 bg-ods-border/60 rounded\" />\n          {[0, 1, 2, 3].map((i) => (\n            <div\n              key={i}\n              className=\"h-10 w-24 bg-ods-card border border-ods-border rounded-md\"\n            />\n          ))}\n        </div>\n      </div>\n      <div className=\"space-y-10\">\n        {[4, 3, 3].map((cardCount, sectionIdx) => (\n          <section key={sectionIdx} className=\"space-y-4\">\n            <h2 className=\"text-h3 tracking-[-0.36px] text-ods-text-primary flex items-center gap-2\">\n              <span className=\"h-6 w-40 bg-ods-border/70 rounded\" />\n              <span className=\"h-5 w-8 bg-ods-text-secondary/20 rounded-full\" />\n            </h2>\n            <ul className=\"flex flex-col gap-4\">\n              {Array.from({ length: cardCount }).map((_, cardIdx) => (\n                <li key={cardIdx}>\n                  <OnboardingGuideCardSkeleton size=\"catalog\" />\n                </li>\n              ))}\n            </ul>\n          </section>\n        ))}\n      </div>\n    </div>\n  )\n}\n","'use client'\n\n/**\n * Public-facing detail view for `/onboarding-guides/<slug>`.\n *\n * Two modes:\n *   - **controlled** (hub SSR): pass `initialData` (a server-fetched guide).\n *   - **self-fetching** (config-only embed): pass `slug` + `guideEndpoint`\n *     (the api route) and the view fetches the guide itself — no host data\n *     layer. (Plain fetch + useEffect, the DeliveryLists pattern.)\n *\n * Everything else flows through lib primitives + the ChatRuntime context\n * (markdown, video warmup, captions, related-card hrefs via\n * `runtime.composeContentUrl`). Optional `MarkdownRenderer` lets hosts swap a\n * renderer with extra plugins.\n */\n\nimport { type ComponentType, type ReactNode } from 'react'\nimport { PageLayout } from '../layout/page-layout'\n\nimport { useRouter } from '../../embed-shims'\n// PageShell (max-w-[1920px]) — the guide detail content must share the SAME\n// container sizing as the related-content/FAQ rail the host page renders\n// below it (which uses the wide shell). ArticleDetailLayout (1280px) made\n// the detail block visibly narrower than the rail.\nimport { PageShell } from '../layout/article-detail-layout'\nimport { DetailPageSkeleton } from '../shared/detail-page-skeleton'\nimport { EntityVideoSection } from '../features/entity-video-section'\nimport { VideoBitesStrip } from '../features/video-bites-strip'\nimport { toStripProfile } from '../features/video-bites-shared'\nimport { useVideoWarmup } from '../features/use-video-warmup'\nimport { getCaptionsUrl } from '../features/captions-url'\nimport { RichMarkdownRenderer } from '../ui/rich-markdown-renderer'\nimport { EntityTagBadges } from '../features/entity-tag-badges'\nimport { LoadError } from '../ui/error-state'\nimport { ArticleAuthorByline } from '../shared/article-author-byline'\nimport { EntityAuthorCard } from '../chat/entity-cards/entity-author-card'\nimport { OnboardingGuideCard } from '../chat/entity-cards/onboarding-guide-card'\nimport { useChatRuntime } from '../../contexts/chat-runtime-context'\nimport type { OnboardingGuide } from '../chat/types/entities/onboarding-guide'\nimport type { VideoTeaser } from '../../types/video-processing'\nimport { resolveContentHref } from '../../utils/content-href'\nimport { buildOgPlaceholderUrl } from '../../utils/og-placeholder'\nimport { useSelfFetch } from '../../hooks/use-self-fetch'\n\nexport interface OnboardingGuideDetailViewProps {\n  /** Server-fetched guide (controlled / SSR mode). Omit it and pass\n   *  `slug` + `guideEndpoint` for the self-fetching config-only mode. */\n  initialData?: OnboardingGuide\n  /** Self-fetch: the guide's slug (the host reads it from its route). */\n  slug?: string\n  /** Self-fetch: builds the GET url for a single guide (the api route).\n   *  e.g. `(s) => \\`/content/api/onboarding-guides/${s}\\``. */\n  guideEndpoint?: (slug: string) => string\n  related?: OnboardingGuide[]\n  /** Link target for the author name in the metadata grid — the host\n   *  computes it (public author page; absent ⇒ plain text). */\n  authorHref?: string\n  /** Bio paragraph for the end-of-article author byline. Defaults to the\n   *  guide payload's `author.about` (hubs that hydrate it can omit this). */\n  authorBio?: string | null\n  /** Byline fallback paragraph when the bio is empty — the host passes its\n   *  platform-aware copy (the lib has no config awareness). Absent ⇒ the\n   *  byline renders nothing below the name when the bio is empty. */\n  fallbackBio?: string | null\n  /** Optional markdown renderer override. Defaults to lib\n   *  `<RichMarkdownRenderer>`. */\n  MarkdownRenderer?: ComponentType<{ content: string }>\n  /** Optional per-row related-card renderer override. */\n  renderRelatedCard?: (guide: OnboardingGuide) => ReactNode\n  /** Back-link target. Defaults to `basePath`. */\n  backHref?: string\n  /** Back-link label. Defaults to \"Back to Getting Started\". */\n  backLabel?: string\n  /** Base path the related-card hrefs default to when\n   *  `runtime.composeContentUrl` is not wired. Default `/onboarding-guides`. */\n  basePath?: string\n  /** Optional slot rendered inside the page chrome, BELOW the article + related\n   *  guides — e.g. the hub's cross-type related-content / FAQ rail. Lets the hub\n   *  mount this view directly (no local wrapper); embedders omit it. */\n  relatedContent?: ReactNode\n  /** Render the standalone `<PageShell>`. Default true. Pass false when the host\n   *  layout already provides the page container — only the padding box renders,\n   *  avoiding a nested `<main>`. */\n  shell?: boolean\n}\n\nexport function OnboardingGuideDetailView({\n  authorHref,\n  authorBio,\n  fallbackBio,\n  initialData,\n  slug,\n  guideEndpoint,\n  related = [],\n  MarkdownRenderer = RichMarkdownRenderer,\n  renderRelatedCard,\n  backHref,\n  backLabel = 'Back to Getting Started',\n  basePath = '/onboarding-guides',\n  relatedContent,\n  shell = true,\n}: OnboardingGuideDetailViewProps) {\n  const resolvedBackHref = backHref ?? basePath\n  const runtime = useChatRuntime()\n  const router = useRouter()\n  // `shell` true → standalone `<PageShell>`; false → padding-only box (no nested\n  // <main>) for hosts whose layout already provides the container.\n  const renderShell = (node: ReactNode) =>\n    shell ? <PageShell>{node}</PageShell> : <div className=\"page-shell-content\">{node}</div>\n\n  // Controlled (hub SSR `initialData`) OR self-fetch by slug (config-only embed).\n  const url = initialData ? null : slug && guideEndpoint ? guideEndpoint(slug) : null\n  const { data: guide, isLoading, error, reload } = useSelfFetch<OnboardingGuide>(url, { initialData })\n\n  // Hooks must run unconditionally — feed them optional-chained values so they\n  // no-op while the guide is still loading.\n  const { ref: videoWarmupRef } = useVideoWarmup<HTMLDivElement>({\n    videoUrl: guide?.main_video_url,\n    supabaseStorageOrigin: runtime?.endpoints.supabaseStorageOrigin,\n  })\n\n  if (error || (!guide && !isLoading)) {\n    return renderShell(<LoadError message=\"Guide not found.\" onRetry={reload} />)\n  }\n  if (!guide) {\n    // Skeleton (not a bare \"Loading…\") for parity with every other shared view —\n    // catalog, roadmap, releases all render a skeleton on first load, so the detail\n    // page shouldn't flash text then content. `bare` + `PageShell` so the loading\n    // state matches the loaded page's full width / padding / min-height.\n    return renderShell(\n      // Match the loaded page's top offset (TitleBlock's\n      // `pt-[var(--spacing-system-l)]`) so content doesn't jump on load.\n      <div className=\"pt-[var(--spacing-system-l)]\">\n        <DetailPageSkeleton bare showImageGallery={false} />\n      </div>\n    )\n  }\n\n  const captionsUrl = getCaptionsUrl('onboarding_guide', guide.id, guide.srt_content)\n\n  const videoPoster =\n    guide.main_video_thumbnail ||\n    guide.featured_image ||\n    guide.og_image_url ||\n    // `buildOgPlaceholderUrl` always returns a usable string (relative route at\n    // worst), so it's the terminal fallback — no trailing `|| undefined` needed.\n    buildOgPlaceholderUrl(runtime?.endpoints, guide.title, { aspect: 'wide' })\n\n  const defaultRenderRelatedCard = (g: OnboardingGuide) => {\n    const cta = resolveContentHref(runtime?.composeContentUrl, {\n      type: 'onboarding_guide',\n      slug: g.slug,\n      basePath,\n      platforms: g.onboarding_guide_platforms,\n    })\n    return <OnboardingGuideCard guide={g} href={cta.href} targetPlatform={cta.targetPlatform} />\n  }\n  const renderRelatedCardFn = renderRelatedCard ?? defaultRenderRelatedCard\n\n  return renderShell(\n    <PageLayout\n        title={guide.title}\n        titleSize=\"h1\"\n        titleWrap\n        backButton={{ label: backLabel, onClick: () => router.push(resolvedBackHref) }}\n      >\n        {/* Tags — flat onboarding_guide_tags[] from entity_tags. */}\n        <EntityTagBadges tags={(guide as any).onboarding_guide_tags} />\n\n        {/* Metadata grid — Section · Step | Published | Author. */}\n        <EntityAuthorCard\n          author={guide.author}\n          authorHref={authorHref}\n          publishedAt={guide.published_at}\n          extraCells={[\n            {\n              value: `${guide.section} · Step ${guide.step_order}`,\n              label: 'Section',\n              uppercase: false,\n            },\n          ]}\n        />\n\n        {/* Video. `main_video_url` (Mux/MP4) and `youtube_url` are independent\n            columns — either populated renders the player. */}\n        {(guide.main_video_url || guide.youtube_url) && (\n          <div ref={videoWarmupRef}>\n            <EntityVideoSection\n              mainVideoUrl={guide.main_video_url}\n              youtubeUrl={guide.youtube_url || undefined}\n              highlightVideoUrl={guide.highlight_video_url}\n              mainVideoPoster={videoPoster}\n              highlightVideoThumbnail={guide.highlight_video_thumbnail || undefined}\n              videoSummary={undefined}\n              videoBites={undefined}\n              title={guide.title}\n              srtContent={guide.srt_content}\n              captionsUrl={captionsUrl}\n              MarkdownRenderer={MarkdownRenderer}\n            />\n          </div>\n        )}\n\n        {/* Markdown body */}\n        {guide.content && (\n          <div className=\"space-y-4\">\n            <MarkdownRenderer content={guide.content} />\n          </div>\n        )}\n\n        {/* Video Bites — unified strip; renders nothing when no published bites. */}\n        <VideoBitesStrip\n          bites={(guide.video_bites as VideoTeaser[] | null) ?? []}\n          filterPublished={true}\n          showTitle={false}\n          profile={toStripProfile(guide.author)}\n          href={`/onboarding-guides/${guide.slug}`}\n        />\n\n        {/* End-of-article author byline (avatar + linked name + bio) — the\n            author DESCRIPTION block every article-shaped detail page renders.\n            Hidden when the guide has no author (the byline returns null). */}\n        <ArticleAuthorByline\n          author={guide.author?.full_name ?? null}\n          avatar={guide.author?.avatar_url}\n          jobTitle={guide.author?.job_title}\n          bio={authorBio ?? guide.author?.about}\n          href={authorHref}\n          fallbackBio={fallbackBio}\n        />\n\n        {/* Related — same-section, ordered by step. */}\n        {related.length > 0 && (\n          <div className=\"space-y-4 pt-8 border-t border-ods-border\">\n            <h2 className=\"text-h3 tracking-[-0.36px] text-ods-text-primary\">\n              More in {guide.section}\n            </h2>\n            <ul className=\"flex flex-col gap-3\">\n              {related.map((r) => (\n                <li key={r.id}>{renderRelatedCardFn(r)}</li>\n              ))}\n            </ul>\n          </div>\n        )}\n\n        {/* Host slot — cross-type related-content / FAQ rail. */}\n        {relatedContent}\n      </PageLayout>\n  )\n}\n","'use client'\n\n/**\n * React Query hooks for Onboarding Guides — PUBLIC reads only.\n *\n * Admin mutations (create/update/delete/publish/stats/save-highlight)\n * stay HUB-side in `hooks/use-onboarding-guides.ts` and import the\n * `onboardingGuideKeys.admin` sub-namespace from this module so the\n * cache namespace `['onboarding-guides']` has a single source of truth.\n *\n * Endpoints (`/api/onboarding-guides*`) are host-supplied — non-Next.js\n * embedders must reverse-proxy the same routes. Same precedent as the\n * tickets list hook.\n */\n\nimport { useQuery } from '@tanstack/react-query'\n\nimport type {\n  OnboardingGuide,\n  OnboardingGuideFilters,\n  OnboardingGuideListResponse,\n  OnboardingGuideSectionSummary,\n} from '../../chat/types/entities/onboarding-guide'\n\n/**\n * Cache key builder for the `['onboarding-guides']` namespace.\n *\n * Includes BOTH public-read sub-keys (`lists`, `list`, `details`,\n * `detail`, `sections`) AND the `admin` sub-namespace. Admin mutations\n * live hub-side but invalidate against this same builder so a single\n * `qc.invalidateQueries({ queryKey: onboardingGuideKeys.all })` from\n * an admin hook also clears the public read cache.\n */\nexport const onboardingGuideKeys = {\n  all: ['onboarding-guides'] as const,\n  lists: () => [...onboardingGuideKeys.all, 'list'] as const,\n  list: (filters: OnboardingGuideFilters) =>\n    [...onboardingGuideKeys.lists(), filters] as const,\n  details: () => [...onboardingGuideKeys.all, 'detail'] as const,\n  detail: (slug: string) => [...onboardingGuideKeys.details(), slug] as const,\n  sections: () => [...onboardingGuideKeys.all, 'sections'] as const,\n  admin: {\n    all: ['admin', 'onboarding-guides'] as const,\n    lists: () => ['admin', 'onboarding-guides', 'list'] as const,\n    detail: (slug: string) =>\n      ['admin', 'onboarding-guide', slug] as const,\n    stats: () => ['admin', 'onboarding-guides', 'stats'] as const,\n  },\n}\n\nexport function useOnboardingGuides(filters?: OnboardingGuideFilters) {\n  return useQuery({\n    queryKey: onboardingGuideKeys.list(filters || {}),\n    queryFn: async (): Promise<OnboardingGuideListResponse> => {\n      const params = new URLSearchParams()\n      if (filters?.search) params.set('search', filters.search)\n      if (filters?.section) params.set('section', filters.section)\n      if (filters?.limit) params.set('limit', filters.limit.toString())\n      if (filters?.offset) params.set('offset', filters.offset.toString())\n      const res = await fetch(`/api/onboarding-guides?${params}`)\n      if (!res.ok) throw new Error('Failed to fetch onboarding guides')\n      return res.json()\n    },\n  })\n}\n\nexport function useOnboardingGuide(slug: string | undefined) {\n  return useQuery({\n    queryKey: onboardingGuideKeys.detail(slug || ''),\n    queryFn: async (): Promise<OnboardingGuide> => {\n      const res = await fetch(`/api/onboarding-guides/${slug}`)\n      if (!res.ok) throw new Error('Failed to fetch onboarding guide')\n      return res.json()\n    },\n    enabled: !!slug,\n  })\n}\n\nexport function useOnboardingGuideSections() {\n  return useQuery({\n    queryKey: onboardingGuideKeys.sections(),\n    queryFn: async (): Promise<OnboardingGuideSectionSummary[]> => {\n      const res = await fetch('/api/onboarding-guides/sections')\n      if (!res.ok)\n        throw new Error('Failed to fetch onboarding-guide sections')\n      return res.json()\n    },\n    staleTime: 0,\n  })\n}\n"]}

package/dist/components/chat/hooks/use-realtime-chunk-processor.d.ts

@@ -1,6 +0,0 @@
-import type { UseRealtimeChunkProcessorReturn, UseRealtimeChunkProcessorOptions } from '../types';
-/**
- * Hook for processing real-time NATS chunks into message segments
- */
-export declare function useRealtimeChunkProcessor(options: UseRealtimeChunkProcessorOptions): UseRealtimeChunkProcessorReturn;
-//# sourceMappingURL=use-realtime-chunk-processor.d.ts.map

package/dist/components/chat/hooks/use-realtime-chunk-processor.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"use-realtime-chunk-processor.d.ts","sourceRoot":"","sources":["../../../../src/components/chat/hooks/use-realtime-chunk-processor.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,+BAA+B,EAAE,gCAAgC,EAAmF,MAAM,UAAU,CAAA;AAQlL;;GAEG;AACH,wBAAgB,yBAAyB,CACvC,OAAO,EAAE,gCAAgC,GACxC,+BAA+B,CA8cjC"}

package/dist/components/chat/utils/chunk-parser.d.ts

@@ -1,25 +0,0 @@
-/**
- * Utilities for parsing NATS chunks into structured actions
- */
-import { type ParsedChunkAction } from '../types';
-/**
- * Parse a raw NATS chunk into a structured action
- */
-export declare function parseChunkToAction(chunk: unknown): ParsedChunkAction | null;
-/**
- * Check if a chunk represents a control message (start/end)
- */
-export declare function isControlChunk(chunk: unknown): boolean;
-/**
- * Check if a chunk represents an error
- */
-export declare function isErrorChunk(chunk: unknown): boolean;
-/**
- * Check if a chunk represents metadata
- */
-export declare function isMetadataChunk(chunk: unknown): boolean;
-/**
- * Extract text content from a chunk if it's a text chunk
- */
-export declare function extractTextFromChunk(chunk: unknown): string | null;
-//# sourceMappingURL=chunk-parser.d.ts.map

package/dist/components/chat/utils/chunk-parser.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"chunk-parser.d.ts","sourceRoot":"","sources":["../../../../src/components/chat/utils/chunk-parser.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAgC,KAAK,iBAAiB,EAAuD,MAAM,UAAU,CAAA;AAqBpI;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,iBAAiB,GAAG,IAAI,CAiM3E;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAKtD;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAIpD;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAIvD;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAOlE"}

package/dist/components/ui/rich-markdown-renderer.d.ts

@@ -1,34 +0,0 @@
-import React from 'react';
-import { type RichMarkdownRuntime } from '../embeds/rich-markdown-runtime';
-/**
- * Props for `<RichMarkdownRenderer>`. Aside from the four runtime knobs
- * lifted from {@link RichMarkdownRuntime}, this is the same shape the hub's
- * `SimpleMarkdownRenderer` ever had — every legacy call site can be moved
- * over without other changes.
- */
-export interface RichMarkdownRendererProps extends Partial<RichMarkdownRuntime> {
-    content: string;
-    className?: string;
-    sectionIds?: Array<{
-        id: string;
-        title: string;
-        level: number;
-    }>;
-    /** Callback for internal navigation (called after the resolver returns) */
-    onInternalLinkClick?: (path: string, options?: {
-        expandFolder?: boolean;
-        fromInternalLink?: boolean;
-    }) => void;
-    /** List of broken links detected server-side */
-    brokenLinks?: string[];
-    /** Current documentation path for resolving relative links */
-    currentPath?: string;
-    /** Source for resolving internal links (default: 'openframe-docs'). Registry id from DOC_SOURCES. */
-    resolveSource?: string;
-    /** Path of the internal link-resolver endpoint. Default '/api/docs/resolve-link'. */
-    resolveLinkEndpointUrl?: string;
-    /** When the page already has an H1, render markdown `#` as `h2` (e.g. legal pages). */
-    demoteMarkdownH1ToH2?: boolean;
-}
-export declare const RichMarkdownRenderer: React.FC<RichMarkdownRendererProps>;
-//# sourceMappingURL=rich-markdown-renderer.d.ts.map

package/dist/components/ui/rich-markdown-renderer.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"rich-markdown-renderer.d.ts","sourceRoot":"","sources":["../../../src/components/ui/rich-markdown-renderer.tsx"],"names":[],"mappings":"AAEA,OAAO,KAA4D,MAAM,OAAO,CAAC;AAgBjF,OAAO,EAGL,KAAK,mBAAmB,EACzB,MAAM,iCAAiC,CAAC;AA4czC;;;;;GAKG;AACH,MAAM,WAAW,yBAA0B,SAAQ,OAAO,CAAC,mBAAmB,CAAC;IAC7E,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACjE,2EAA2E;IAC3E,mBAAmB,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,YAAY,CAAC,EAAE,OAAO,CAAC;QAAC,gBAAgB,CAAC,EAAE,OAAO,CAAA;KAAE,KAAK,IAAI,CAAC;IAC/G,gDAAgD;IAChD,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,8DAA8D;IAC9D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,qGAAqG;IACrG,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,qFAAqF;IACrF,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,uFAAuF;IACvF,oBAAoB,CAAC,EAAE,OAAO,CAAC;CAChC;AAED,eAAO,MAAM,oBAAoB,EAAE,KAAK,CAAC,EAAE,CAAC,yBAAyB,CAoCpE,CAAC"}

package/dist/components/ui/simple-markdown-renderer.d.ts

@@ -1,73 +0,0 @@
-import React from 'react';
-import { type Components } from 'react-markdown';
-import type { PluggableList } from 'unified';
-import type { ResolveLinkResult } from '../../types/doc-source';
-export type { ResolveLinkResult };
-export type TextSizeElement = 'h1' | 'h2' | 'h3' | 'h4' | 'h5' | 'h6' | 'p' | 'li' | 'blockquote' | 'code' | 'th' | 'td';
-export type TextSizeClassMap = Partial<Record<TextSizeElement, string>>;
-export type TextSizePreset = 'default' | 'compact' | 'large';
-export type TextSizeConfig = TextSizePreset | TextSizeClassMap | {
-    preset: TextSizePreset;
-    overrides: TextSizeClassMap;
-};
-export interface SimpleMarkdownRendererProps {
-    content: string;
-    className?: string;
-    /** Backend-provided heading IDs for deep-link anchors */
-    sectionIds?: Array<{
-        id: string;
-        title: string;
-        level: number;
-    }>;
-    /** When the page already has an H1, render markdown `#` as `<h2>` */
-    demoteMarkdownH1ToH2?: boolean;
-    /** List of broken link hrefs detected server-side (shown with [BROKEN] badge) */
-    brokenLinks?: string[];
-    /** Callback for internal (non-http, non-anchor) link clicks */
-    onInternalLinkClick?: (path: string, options?: {
-        expandFolder?: boolean;
-        fromInternalLink?: boolean;
-    }) => void;
-    /** Current documentation path — enables internal-link mode when set */
-    currentPath?: string;
-    /**
-     * Resolve an internal link href to a navigation path.
-     * Called when a user clicks an internal doc link.
-     */
-    onResolveLink?: (href: string, currentPath: string) => Promise<ResolveLinkResult>;
-    /** Pre-process the raw markdown string before rendering (e.g. shortcode expansion) */
-    preprocessContent?: (content: string) => string;
-    /** Merge additional or override react-markdown component renderers */
-    componentOverrides?: Partial<Components>;
-    /**
-     * Extra remark plugins appended after the built-in `remarkGfm` and
-     * `remarkBreaks`. Used by chat consumers to inject `remarkCardLinks`,
-     * which converts `[card://<type>:<id>]` markers into synthetic `link`
-     * nodes; the host's `componentOverrides.a` then swaps those for whatever
-     * inline entity-card component it provides.
-     *
-     * Each entry is either a Plugin reference or a [Plugin, options] tuple
-     * — same shape as react-markdown's own `remarkPlugins` prop. Pass an
-     * empty array (or omit) to keep the default plugin set.
-     */
-    additionalRemarkPlugins?: PluggableList;
-    /**
-     * Configure text sizing for all rendered elements.
-     * - `"default"` — current behavior (large article-style typography)
-     * - `"compact"` — smaller sizes for sidebars, cards, changelogs
-     * - `"large"` — extra-large sizes for hero/landing content
-     * - `{ p: "text-sm", h1: "text-2xl" }` — per-element overrides (merged onto default)
-     * - `{ preset: "compact", overrides: { h1: "text-heading-1" } }` — preset + tweaks
-     */
-    textSize?: TextSizeConfig;
-}
-/**
- * Memoized so a parent re-render with UNCHANGED props (same `content` string,
- * same memoized `componentOverrides`/plugins) does NOT re-parse the markdown.
- * Re-parsing rebuilds the entire react-markdown subtree, which RE-MOUNTS any
- * embedded inline entity cards — closing their open menus and re-triggering
- * their fetch on every chat re-render (streaming chunk AND scroll). With
- * stable props the renderer bails, so completed messages' cards stay mounted.
- */
-export declare const SimpleMarkdownRenderer: React.NamedExoticComponent<SimpleMarkdownRendererProps>;
-//# sourceMappingURL=simple-markdown-renderer.d.ts.map

package/dist/components/ui/simple-markdown-renderer.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"simple-markdown-renderer.d.ts","sourceRoot":"","sources":["../../../src/components/ui/simple-markdown-renderer.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAkE,MAAM,OAAO,CAAC;AACvF,OAAsB,EAAE,KAAK,UAAU,EAAuB,MAAM,gBAAgB,CAAC;AACrF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAU7C,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAEhE,YAAY,EAAE,iBAAiB,EAAE,CAAC;AAyflC,MAAM,MAAM,eAAe,GACvB,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GACvC,GAAG,GAAG,IAAI,GAAG,YAAY,GAAG,MAAM,GAAG,IAAI,GAAG,IAAI,CAAC;AAErD,MAAM,MAAM,gBAAgB,GAAG,OAAO,CAAC,MAAM,CAAC,eAAe,EAAE,MAAM,CAAC,CAAC,CAAC;AACxE,MAAM,MAAM,cAAc,GAAG,SAAS,GAAG,SAAS,GAAG,OAAO,CAAC;AAC7D,MAAM,MAAM,cAAc,GACtB,cAAc,GACd,gBAAgB,GAChB;IAAE,MAAM,EAAE,cAAc,CAAC;IAAC,SAAS,EAAE,gBAAgB,CAAA;CAAE,CAAC;AA+D5D,MAAM,WAAW,2BAA2B;IAC1C,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,yDAAyD;IACzD,UAAU,CAAC,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACjE,qEAAqE;IACrE,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,iFAAiF;IACjF,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,+DAA+D;IAC/D,mBAAmB,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,YAAY,CAAC,EAAE,OAAO,CAAC;QAAC,gBAAgB,CAAC,EAAE,OAAO,CAAA;KAAE,KAAK,IAAI,CAAC;IAC/G,uEAAuE;IACvE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;OAGG;IACH,aAAa,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,KAAK,OAAO,CAAC,iBAAiB,CAAC,CAAC;IAClF,sFAAsF;IACtF,iBAAiB,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,MAAM,CAAC;IAChD,sEAAsE;IACtE,kBAAkB,CAAC,EAAE,OAAO,CAAC,UAAU,CAAC,CAAC;IACzC;;;;;;;;;;OAUG;IACH,uBAAuB,CAAC,EAAE,aAAa,CAAC;IACxC;;;;;;;OAOG;IACH,QAAQ,CAAC,EAAE,cAAc,CAAC;CAC3B;AA+TD;;;;;;;GAOG;AACH,eAAO,MAAM,sBAAsB,yDAAmC,CAAC"}

package/src/components/chat/hooks/.use-realtime-chunk-processor.md

@@ -1,77 +0,0 @@
-<!-- source-hash: 681c783784fdc89f0c86eb3e539c482b -->
-Processes real-time NATS streaming chunks into structured message segments, managing streaming state, approval flows, direct-mode barriers, and tool execution events for AI assistant chat interfaces.
-
-## Key Components
-
-### `useRealtimeChunkProcessor(options)`
-
-Main hook export. Accepts `UseRealtimeChunkProcessorOptions` and returns `UseRealtimeChunkProcessorReturn`.
-
-**Options:**
-
-| Option | Type | Default | Description |
-|---|---|---|---|
-| `callbacks` | `object` | required | Event handlers (`onSegmentsUpdate`, `onStreamStart`, `onStreamEnd`, `onApprove`, `onReject`, etc.) |
-| `displayApprovalTypes` | `string[]` | `['CLIENT']` | Approval types rendered inline; others are escalated |
-| `approvalStatuses` | `object` | `{}` | Current status map keyed by `requestId` |
-| `initialState` | `object` | — | Hydrates accumulator for resumed dialogs |
-| `batchApprovalsEnabled` | `boolean` | `true` | Renders batch approvals as a single card; `false` unfolds into individual cards |
-| `isDirectMode` | `boolean` | `false` | Activates the direct-mode barrier, dropping AI assistant chunks |
-
-### Internal Refs
-
-| Ref | Purpose |
-|---|---|
-| `accumulatorRef` | `MessageSegmentAccumulator` instance managing segment state |
-| `isInStreamRef` | Tracks open/closed stream window (`MESSAGE_START` → `MESSAGE_END`) |
-| `hasEverStreamedRef` | Distinguishes cold-start vs. post-stream continuation for append mode |
-| `directModeFlagRef` / `sawDirectMessageRef` | Direct-mode barrier gate |
-| `directTeardownFiredRef` | One-shot guard: ensures teardown fires exactly once on barrier entry |
-| `pendingEscalatedRef` | Map of escalated approval requests not shown inline |
-
-### Supported Chunk Actions
-
-| Action | Behavior |
-|---|---|
-| `message_start` / `message_end` | Opens/closes stream, resets accumulator |
-| `text` / `thinking` | Appends to accumulator; uses append-mode after `MESSAGE_END` |
-| `tool_execution` | Routes in-stream to accumulator; post-stream to `onToolExecuted` callback |
-| `approval_request` | Inline or escalated based on `displayApprovalTypes` |
-| `approval_batch` | Single batch card, legacy card fan-out, or escalated |
-| `metadata` | Forwarded directly to `onMetadata` |
-| `direct_message` | Activates direct-mode barrier |
-
-## Usage Example
-
-```typescript
-const { processChunk } = useRealtimeChunkProcessor({
-  callbacks: {
-    onSegmentsUpdate: (segments, meta) => setSegments(segments),
-    onStreamStart: () => setIsStreaming(true),
-    onStreamEnd: () => setIsStreaming(false),
-    onApprove: (requestId) => approveAction(requestId),
-    onReject: (requestId) => rejectAction(requestId),
-    onEscalatedApproval: (requestId, data) => notifyAdmin(requestId, data),
-    onToolExecuted: (segment) => updateToolCard(segment),
-    onAgentBusy: () => showTypingIndicator(),
-    onMetadata: (meta) => handleMetadata(meta),
-  },
-  displayApprovalTypes: ['CLIENT'],
-  batchApprovalsEnabled: true,
-  isDirectMode: false,
-  approvalStatuses: { 'req-123': 'approved' },
-})
-
-// Wire to your NATS subscription
-natsSubscription.onMessage((rawChunk) => {
-  processChunk(rawChunk)
-})
-```
-
-## Direct-Mode Barrier
-
-When `isDirectMode` is `true` or a `direct_message` chunk arrives, the hook drops all subsequent AI-assistant chunks (everything not in `DIRECT_MODE_ALLOWED`). Teardown fires exactly once — clearing the typing indicator, composer lock, and in-progress bubble — even if no stream is currently open (e.g., during post-approval tool execution).
-
-## Source
-
-[`use-realtime-chunk-processor.ts`](https://github.com/flamingo-stack/openframe-oss-lib/blob/main/use-realtime-chunk-processor.ts)