@flamingo-stack/openframe-frontend-core 0.0.364 → 0.0.365-snapshot.20260703164521

package/src/components/layout/title-block.tsx

@@ -38,6 +38,14 @@
  * the loaded one — used by page skeletons that render through `PageLayout`).
  * Both are additive + default-preserving: omit them and every existing caller is
  * byte-identical. Do NOT change defaults or touch anything else here.
+ *
+ * SANCTIONED EXCEPTION (2026-07, explicit human sign-off): the OPTIONAL
+ * `titleWrap` prop. Defaults to `false` — the frozen single-line `truncate`
+ * baseline is unchanged for every existing caller. Content DETAIL pages (whose
+ * h1 is CMS data of arbitrary length — releases, legal docs, FAQ docs, dev
+ * sections) pass `titleWrap` to let the title wrap onto multiple lines instead
+ * of being ellipsis-clipped. Additive + default-preserving; do NOT change the
+ * default or touch anything else here.
  * ========================================================================== */
 
 import React from 'react'
@@ -86,6 +94,10 @@ export interface TitleBlockProps {
    *  (typography + surrounding markup unchanged, so header height is identical to loaded).
    *  Additive + default-preserving: omit it and every existing caller is byte-identical. */
   loading?: boolean
+  /** When true, a long title WRAPS onto multiple lines instead of the frozen single-line
+   *  ellipsis clamp. For content detail pages whose h1 is CMS data of arbitrary length.
+   *  Additive + default-preserving: omit it and every existing caller is byte-identical. */
+  titleWrap?: boolean
 }
 
 /**
@@ -119,10 +131,14 @@ export function TitleBlock({
   titleSize = 'h2',
   titleAdornment,
   loading,
+  titleWrap = false,
 }: TitleBlockProps) {
   const hasActions = actions && actions.length > 0
   const hasMenuActions = !!menuActions && menuActions.some(g => g.items.length > 0)
   const titleClass = titleSize === 'h1' ? 'text-h1' : 'text-h2'
+  // Frozen baseline is the single-line `truncate`; `titleWrap` swaps it for
+  // multi-line wrapping (break-words guards pathological unbroken tokens).
+  const titleOverflowClass = titleWrap ? 'break-words' : 'truncate'
 
   return (
     <div
@@ -163,11 +179,11 @@ export function TitleBlock({
               {(loading || title) && (
                 titleAdornment ? (
                   <div className="flex items-center gap-[var(--spacing-system-m)] min-w-0 w-full">
-                    <h1 className={cn(titleClass, 'text-ods-text-primary truncate min-w-0')} title={title}>{loading ? <TitleTextSkeleton widthClass="w-48 md:w-72" heightClass="h-4 md:h-6" /> : title}</h1>
+                    <h1 className={cn(titleClass, 'text-ods-text-primary min-w-0', titleOverflowClass)} title={title}>{loading ? <TitleTextSkeleton widthClass="w-48 md:w-72" heightClass="h-4 md:h-6" /> : title}</h1>
                     <span className="shrink-0">{titleAdornment}</span>
                   </div>
                 ) : (
-                  <h1 className={cn(titleClass, 'text-ods-text-primary truncate')} title={title}>{loading ? <TitleTextSkeleton widthClass="w-48 md:w-72" heightClass="h-4 md:h-6" /> : title}</h1>
+                  <h1 className={cn(titleClass, 'text-ods-text-primary', titleOverflowClass)} title={title}>{loading ? <TitleTextSkeleton widthClass="w-48 md:w-72" heightClass="h-4 md:h-6" /> : title}</h1>
                 )
               )}
               {subtitle && (
@@ -179,11 +195,15 @@ export function TitleBlock({
           title && (
             titleAdornment ? (
               <div className="flex items-center gap-[var(--spacing-system-m)] min-w-0 w-full">
-                <h1 className={cn(titleClass, 'text-ods-text-primary truncate min-w-0')} title={title}>{title}</h1>
+                <h1 className={cn(titleClass, 'text-ods-text-primary min-w-0', titleOverflowClass)} title={title}>{title}</h1>
                 <span className="shrink-0">{titleAdornment}</span>
               </div>
             ) : (
-              <h1 className={cn(titleClass, 'text-ods-text-primary')}>{title}</h1>
+              /* This branch never had the single-line clamp, so text already
+                 wraps; `titleWrap` only adds break-words for pathological
+                 unbroken tokens. No class change when the prop is unset —
+                 the frozen baseline stays byte-identical. */
+              <h1 className={cn(titleClass, 'text-ods-text-primary', titleWrap && 'break-words')}>{title}</h1>
             )
           )
         )}

package/src/components/onboarding-guides/onboarding-guide-detail-view.tsx

@@ -161,6 +161,7 @@ export function OnboardingGuideDetailView({
     <PageLayout
         title={guide.title}
         titleSize="h1"
+        titleWrap
         backButton={{ label: backLabel, onClick: () => router.push(resolvedBackHref) }}
       >
         {/* Tags — flat onboarding_guide_tags[] from entity_tags. */}

package/src/components/shared/dev-section/dev-section-page.tsx

@@ -89,6 +89,7 @@ export function DevSectionPage({
       title={title ?? section.hero.title}
       subtitle={subtitle ?? section.hero.description}
       titleSize="h1"
+      titleWrap
       backButton={backCfg}
     >
       <DevSectionView sectionKey={sectionKey} showHeading={false} preControls={preControls}>

package/src/components/shared/legal-document/legal-document-page.tsx

@@ -108,7 +108,7 @@ export function LegalDocumentPage({
   const subtitle = effectiveLastUpdatedLabel ? `Last Updated: ${effectiveLastUpdatedLabel}` : fallbackDescription;
 
   const inner = (
-    <PageLayout title={title} subtitle={subtitle} backButton={backCfg} titleSize="h1">
+    <PageLayout title={title} subtitle={subtitle} backButton={backCfg} titleSize="h1" titleWrap>
       {data?.sourceFile && (
         <p className="font-['DM_Sans'] text-sm text-ods-text-secondary opacity-75">Source: {data.sourceFile}</p>
       )}

package/src/components/shared/product-release/release-detail-page.tsx

@@ -9,6 +9,7 @@ import { Card, CardContent } from '../../ui/card';
 // the rail, see hub detail-container alignment decision 2026-06-10).
 import { PageShell } from '../../layout/article-detail-layout';
 import { PageLayout } from '../../layout/page-layout';
+import { FadePreview } from '../../ui/fade-preview';
 import { ReleaseChangelogSection } from '../../ui/release-changelog-section';
 import { RichMarkdownRenderer } from '../../ui/rich-markdown-renderer';
 import { EntityTagBadges } from '../../features/entity-tag-badges';
@@ -257,6 +258,7 @@ export function ReleaseDetailPage({
         title={releaseTitle}
         subtitle={`Version: ${releaseVersion}`}
         titleSize="h1"
+        titleWrap
         backButton={
           showBackButton ? { label: backLabel, onClick: () => router.push(backHref) } : undefined
         }
@@ -461,16 +463,35 @@ export function ReleaseDetailPage({
           </div>
         )}
 
-        {/* Bug-fixes & Enhancements Section */}
+        {/* Bug-fixes & Enhancements Section — releases can link dozens of
+            delivery tasks, so the list gets the same `FadePreview`
+            progressive disclosure as the changelog sections above: first
+            row visible, rest fade-masked behind "Show N more". */}
         {DeliverySection && (deliveryLoading || (deliveryData && (deliveryData.completed.length > 0 || deliveryData.inProgress.length > 0))) && (
           <div className="w-full space-y-4">
             <p className="text-h5 tracking-[-0.28px] text-ods-text-secondary">
               Related Enhancements and Bug-fixes
             </p>
-            <DeliverySection
-              data={deliveryData}
-              isLoading={deliveryLoading}
-            />
+            {(() => {
+              const deliveryCount = deliveryData
+                ? deliveryData.completed.length + deliveryData.inProgress.length
+                : 0;
+              return deliveryLoading ? (
+                <DeliverySection data={deliveryData} isLoading={deliveryLoading} />
+              ) : (
+                <FadePreview
+                  hiddenCount={deliveryCount - 1}
+                  collapsedHeight={300}
+                  resetKey={deliveryCount}
+                >
+                  {/* space-y-4 restores the completed/in-progress table gap the
+                      parent's space-y used to provide before the fade wrapper. */}
+                  <div className="space-y-4">
+                    <DeliverySection data={deliveryData} isLoading={false} />
+                  </div>
+                </FadePreview>
+              );
+            })()}
           </div>
         )}
 

package/src/components/ui/fade-preview.tsx

@@ -0,0 +1,87 @@
+"use client"
+
+import React, { useState, useRef, useEffect } from 'react';
+import { ChevronDown } from 'lucide-react';
+
+/**
+ * FadePreview — the single shared progressive-disclosure primitive for
+ * long lists/sections: renders children inside a height-clamped wrapper
+ * whose bottom fades out via a CSS mask, with a "Show N more / Show less"
+ * toggle below.
+ *
+ * Extracted from `ReleaseChangelogSection`'s `previewFirst` mode (which
+ * itself unified the investor-update detail page's duplicated
+ * `FadedHighlightSection`). Every fade-preview surface must compose THIS
+ * component — do not re-inline the mask/clamp/toggle trio.
+ *
+ * When `hiddenCount <= 0` the children render unclamped and no toggle
+ * shows (single-entry sections need no disclosure).
+ */
+export interface FadePreviewProps {
+  /** How many items are visually hidden while collapsed — drives the
+   *  "Show N more" label. Pass `total - visible`; `<= 0` disables the
+   *  clamp + fade + toggle entirely. */
+  hiddenCount: number;
+  /** Collapsed height in px. ~120 shows one changelog entry's title +
+   *  the start of its description before the mask kicks in. Callers with
+   *  taller rows (e.g. delivery tables) pass a larger value. */
+  collapsedHeight?: number;
+  /** Reset the expanded state when this value changes — otherwise a
+   *  parent that refetches and shrinks the list would leave a stale
+   *  "expanded" state and a momentarily-wrong "Show 0 more" button.
+   *  Callers typically pass the item count. */
+  resetKey?: unknown;
+  children: React.ReactNode;
+}
+
+export function FadePreview({
+  hiddenCount,
+  collapsedHeight = 120,
+  resetKey,
+  children,
+}: FadePreviewProps) {
+  const [expanded, setExpanded] = useState(false);
+  const contentRef = useRef<HTMLDivElement>(null);
+
+  useEffect(() => {
+    setExpanded(false);
+  }, [resetKey]);
+
+  const needsFade = hiddenCount > 0;
+
+  // No disclosure needed → no clamp wrapper at all. (Keeping the wrapper
+  // with a `scrollHeight ?? 2000` max-height would clip tall content on
+  // the first render, before the ref measures.)
+  if (!needsFade) return <>{children}</>;
+
+  return (
+    <div className="relative">
+      <div
+        ref={contentRef}
+        className="overflow-hidden transition-[max-height] duration-500"
+        style={{
+          transitionTimingFunction: 'cubic-bezier(0.33, 1, 0.68, 1)',
+          maxHeight: expanded
+            ? contentRef.current?.scrollHeight ?? 2000
+            : collapsedHeight,
+          ...(!expanded ? {
+            maskImage: 'linear-gradient(to bottom, black 30%, transparent 100%)',
+            WebkitMaskImage: 'linear-gradient(to bottom, black 30%, transparent 100%)',
+          } : {}),
+        }}
+      >
+        {children}
+      </div>
+      <button
+        type="button"
+        onClick={() => setExpanded(!expanded)}
+        className="mt-4 flex items-center gap-1.5 text-sm text-ods-text-secondary hover:text-ods-accent transition-colors duration-200"
+      >
+        <span>{expanded ? 'Show less' : `Show ${hiddenCount} more`}</span>
+        <ChevronDown
+          className={`w-3.5 h-3.5 transition-transform duration-300 ${expanded ? 'rotate-180' : ''}`}
+        />
+      </button>
+    </div>
+  );
+}

package/src/components/ui/index.ts

@@ -53,6 +53,7 @@ export * from './tab-navigation'
 export * from './alert'
 export * from './badge'
 export * from './ai-generated-badge'
+export * from './fade-preview'
 export * from './progress'
 export * from './release-changelog-section'
 export * from './stacked-rows-panel'

package/src/components/ui/release-changelog-section.tsx

@@ -1,8 +1,9 @@
 "use client"
 
-import React, { useState, useRef, useEffect } from 'react';
+import React, { useState } from 'react';
 import { Badge } from './badge';
 import { ChevronDown } from 'lucide-react';
+import { FadePreview } from './fade-preview';
 import { RichMarkdownRenderer } from './rich-markdown-renderer';
 import type { ChangelogEntry } from '../../types/product-release';
 
@@ -55,24 +56,11 @@ export function ReleaseChangelogSection({
   MarkdownRenderer = RichMarkdownRenderer,
 }: ReleaseChangelogSectionProps) {
   const [collapsed, setCollapsed] = useState(collapsible ? defaultCollapsed : false);
-  const [previewExpanded, setPreviewExpanded] = useState(false);
-  const previewContentRef = useRef<HTMLDivElement>(null);
-
-  // Reset preview-expanded state when the entries set changes — otherwise
-  // a parent that refetches and shrinks entries from N → 1 would leave
-  // the user with a stale "expanded" state and a momentarily-wrong
-  // "Show 0 more" button before the `previewNeedsFade` gate hides it.
-  // Keyed on `entries.length` (not identity) so re-renders with the same
-  // length don't churn state unnecessarily.
-  useEffect(() => {
-    setPreviewExpanded(false);
-  }, [entries.length]);
 
   if (!entries || entries.length === 0) return null;
 
   // collapsible wins when both flags are passed (documented in JSDoc).
   const inPreviewMode = previewFirst && !collapsible;
-  const previewNeedsFade = inPreviewMode && entries.length > 1;
   const showEntries = !collapsible || !collapsed;
 
   return (
@@ -105,42 +93,16 @@ export function ReleaseChangelogSection({
       )}
       {showEntries && (
         inPreviewMode ? (
-          /* Preview-first mode: render the list in a height-clamped +
-             mask-faded wrapper. The CSS mask creates the soft fade-out
-             at the bottom of the collapsed region; the inline maxHeight
-             + transition animate the open/close. When `previewExpanded`
-             flips, the wrapper falls back to its natural scrollHeight
-             (or 2000px on first render before the ref measures). */
-          <div className="relative">
-            <div
-              ref={previewContentRef}
-              className="overflow-hidden transition-[max-height] duration-500"
-              style={{
-                transitionTimingFunction: 'cubic-bezier(0.33, 1, 0.68, 1)',
-                maxHeight: previewExpanded || !previewNeedsFade
-                  ? previewContentRef.current?.scrollHeight ?? 2000
-                  : PREVIEW_COLLAPSED_HEIGHT,
-                ...(previewNeedsFade && !previewExpanded ? {
-                  maskImage: 'linear-gradient(to bottom, black 30%, transparent 100%)',
-                  WebkitMaskImage: 'linear-gradient(to bottom, black 30%, transparent 100%)',
-                } : {}),
-              }}
-            >
-              <ChangelogEntryList entries={entries} MarkdownRenderer={MarkdownRenderer} />
-            </div>
-            {previewNeedsFade && (
-              <button
-                type="button"
-                onClick={() => setPreviewExpanded(!previewExpanded)}
-                className="mt-4 flex items-center gap-1.5 text-sm text-ods-text-secondary hover:text-ods-accent transition-colors duration-200"
-              >
-                <span>{previewExpanded ? 'Show less' : `Show ${entries.length - 1} more`}</span>
-                <ChevronDown
-                  className={`w-3.5 h-3.5 transition-transform duration-300 ${previewExpanded ? 'rotate-180' : ''}`}
-                />
-              </button>
-            )}
-          </div>
+          /* Preview-first mode: the shared `FadePreview` primitive clamps
+             the list to ~one full entry, fade-masks the rest, and renders
+             the "Show N more / Show less" toggle. */
+          <FadePreview
+            hiddenCount={entries.length - 1}
+            collapsedHeight={PREVIEW_COLLAPSED_HEIGHT}
+            resetKey={entries.length}
+          >
+            <ChangelogEntryList entries={entries} MarkdownRenderer={MarkdownRenderer} />
+          </FadePreview>
         ) : (
           <ChangelogEntryList entries={entries} MarkdownRenderer={MarkdownRenderer} />
         )

package/dist/chunk-3FGFGOH5.cjs.map

@@ -1 +0,0 @@
-{"version":3,"sources":["/home/runner/work/openframe-oss-lib/openframe-oss-lib/openframe-frontend-core/dist/chunk-3FGFGOH5.cjs","../src/components/onboarding-guides/onboarding-guides-catalog-view.tsx","../src/components/onboarding-guides/onboarding-guides-catalog-skeleton.tsx","../src/components/onboarding-guides/onboarding-guide-detail-view.tsx","../src/components/onboarding-guides/hooks/use-onboarding-guides.ts"],"names":["jsx","jsxs"],"mappings":"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","file":"/home/runner/work/openframe-oss-lib/openframe-oss-lib/openframe-frontend-core/dist/chunk-3FGFGOH5.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 font-['DM_Sans'] text-[20px] font-semibold mb-2\">\n            No onboarding guides found\n          </h2>\n          <p className=\"text-ods-text-secondary font-['DM_Sans'] text-[14px]\">\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 tracking-[-0.36px] 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-xs font-medium 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 { VideoBitesDisplay } from '../features/video-bites-display'\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        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 */}\n        {guide.video_bites && guide.video_bites.length > 0 && (\n          <VideoBitesDisplay\n            bites={guide.video_bites as VideoTeaser[]}\n            filterPublished={true}\n            showTitle={false}\n          />\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"]}