@flamingo-stack/openframe-frontend-core 0.0.692 → 0.0.693-snapshot.20261002120603

package/dist/chat-protocol/leading-frames.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"leading-frames.d.ts","sourceRoot":"","sources":["../../src/chat-protocol/leading-frames.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAEhD;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEvD;AASD;;;2DAG2D;AAC3D,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAE3D;AAED;;;;;;;;;GASG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,EAAE,eAAe,EAAE,GAAG,IAAI,CAsH3F"}
+{"version":3,"file":"leading-frames.d.ts","sourceRoot":"","sources":["../../src/chat-protocol/leading-frames.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAGhD;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEvD;AASD;;;2DAG2D;AAC3D,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAE3D;AAED;;;;;;;;;GASG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,EAAE,eAAe,EAAE,GAAG,IAAI,CAwH3F"}

package/dist/chat-protocol/progress.d.ts

@@ -0,0 +1,35 @@
+/**
+ * What a turn is doing before its first answer token: the named stages a server
+ * reports while it works, and the line a client shows for each.
+ *
+ * A retrieval chat spends seconds before any text exists (reading the question,
+ * searching, reading what it found). A generic spinner for that whole time says
+ * nothing; a line naming the real step ("Searching 28 sources") does, and people
+ * wait more willingly for it. The stage is a FIXED vocabulary on the wire (never
+ * model text, a rewritten query or a source name), so it is safe on a public
+ * chat and the wording stays the client's: `chatProgressLabel` is the one place
+ * the copy lives.
+ *
+ * Wire: the existing `{ status: 'thinking' }` leading frame, with an optional
+ * `stage` and `count`. A client that predates the stage reads the frame exactly
+ * as before; a client that knows it shows the line. A stage it does not know is
+ * dropped (the frame is still a plain "thinking").
+ *
+ * Server-safe: no React, no browser APIs.
+ */
+export declare const CHAT_PROGRESS_STAGES: readonly ["understanding", "searching", "searching_again", "reading"];
+export type ChatProgressStage = (typeof CHAT_PROGRESS_STAGES)[number];
+export interface ChatProgress {
+    stage: ChatProgressStage;
+    /** How many of the thing the stage works on: sources searched, results read. */
+    count?: number;
+}
+export declare function isChatProgressStage(value: unknown): value is ChatProgressStage;
+/** A parsed status frame's progress, or null when it carries no stage this client knows. */
+export declare function chatProgressOf(frame: {
+    stage?: unknown;
+    count?: unknown;
+}): ChatProgress | null;
+/** The one line shown for a stage. Specific when the server gave a real count, never an invented one. */
+export declare function chatProgressLabel(progress: ChatProgress): string;
+//# sourceMappingURL=progress.d.ts.map

package/dist/chat-protocol/progress.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"progress.d.ts","sourceRoot":"","sources":["../../src/chat-protocol/progress.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,eAAO,MAAM,oBAAoB,uEAAwE,CAAC;AAE1G,MAAM,MAAM,iBAAiB,GAAG,CAAC,OAAO,oBAAoB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEtE,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,iBAAiB,CAAC;IACzB,gFAAgF;IAChF,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,iBAAiB,CAE9E;AAED,4FAA4F;AAC5F,wBAAgB,cAAc,CAAC,KAAK,EAAE;IAAE,KAAK,CAAC,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,YAAY,GAAG,IAAI,CAO/F;AASD,yGAAyG;AACzG,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,YAAY,GAAG,MAAM,CAEhE"}

package/dist/{chunk-GDZ7IC5B.js → chunk-234IIQIS.js}

@@ -2,7 +2,7 @@
 import {
   embedAuthedFetch,
   hasEmbedAuthAdapter
-} from "./chunk-UVUNBXS6.js";
+} from "./chunk-7IINE3MK.js";
 
 // src/utils/search-params.ts
 function positiveInt(raw, fallback, { min = 1, max } = {}) {
@@ -142,4 +142,4 @@ export {
   serializeSchemaParams,
   withQuery
 };
-//# sourceMappingURL=chunk-GDZ7IC5B.js.map
+//# sourceMappingURL=chunk-234IIQIS.js.map

package/dist/{chunk-KDCIYRZV.cjs → chunk-2EQED5SZ.cjs}

@@ -2,14 +2,14 @@
 
 
 
-var _chunkF6LXGP6Scjs = require('./chunk-F6LXGP6S.cjs');
+var _chunkQ2B2MGFUcjs = require('./chunk-Q2B2MGFU.cjs');
 
 
 
-var _chunk5XPK2QGUcjs = require('./chunk-5XPK2QGU.cjs');
+var _chunkKJHIFF6Hcjs = require('./chunk-KJHIFF6H.cjs');
 
 
-var _chunkUSKQURNFcjs = require('./chunk-USKQURNF.cjs');
+var _chunkTG3VBMDGcjs = require('./chunk-TG3VBMDG.cjs');
 
 
 
@@ -18,13 +18,13 @@ var _chunkUSKQURNFcjs = require('./chunk-USKQURNF.cjs');
 
 
 
-var _chunkEXWS2QSDcjs = require('./chunk-EXWS2QSD.cjs');
+var _chunkFNGX5WZMcjs = require('./chunk-FNGX5WZM.cjs');
 
 
 
 
 
-var _chunkGZRU2A4Lcjs = require('./chunk-GZRU2A4L.cjs');
+var _chunkC27F6GBZcjs = require('./chunk-C27F6GBZ.cjs');
 
 
 
@@ -34,10 +34,10 @@ var _chunkSADRZ4YIcjs = require('./chunk-SADRZ4YI.cjs');
 
 
 
-var _chunk53O6PQ3Fcjs = require('./chunk-53O6PQ3F.cjs');
+var _chunkNDLFK57Dcjs = require('./chunk-NDLFK57D.cjs');
 
 
-var _chunkI27PWVWEcjs = require('./chunk-I27PWVWE.cjs');
+var _chunkWT4HURQNcjs = require('./chunk-WT4HURQN.cjs');
 
 
 var _chunkU2YLMFJKcjs = require('./chunk-U2YLMFJK.cjs');
@@ -62,7 +62,7 @@ function OnboardingGuidesCatalogSkeleton() {
         /* @__PURE__ */ _jsxruntime.jsx.call(void 0, "span", { className: "h-6 w-40 rounded bg-ods-border/70" }),
         /* @__PURE__ */ _jsxruntime.jsx.call(void 0, "span", { className: "h-5 w-8 rounded-full bg-ods-text-secondary/20" })
       ] }),
-      /* @__PURE__ */ _jsxruntime.jsx.call(void 0, "ul", { className: "flex flex-col gap-4", children: Array.from({ length: cardCount }).map((_, cardIdx) => /* @__PURE__ */ _jsxruntime.jsx.call(void 0, "li", { children: /* @__PURE__ */ _jsxruntime.jsx.call(void 0, _chunk53O6PQ3Fcjs.OnboardingGuideCardSkeleton, { size: "catalog" }) }, cardIdx)) })
+      /* @__PURE__ */ _jsxruntime.jsx.call(void 0, "ul", { className: "flex flex-col gap-4", children: Array.from({ length: cardCount }).map((_, cardIdx) => /* @__PURE__ */ _jsxruntime.jsx.call(void 0, "li", { children: /* @__PURE__ */ _jsxruntime.jsx.call(void 0, _chunkNDLFK57Dcjs.OnboardingGuideCardSkeleton, { size: "catalog" }) }, cardIdx)) })
     ] }, sectionIdx)) })
   ] });
 }
@@ -86,10 +86,10 @@ function OnboardingGuidesCatalogView({
   const sectionValue = selfFetch ? _nullishCoalesce(searchParams.get("section"), () => ( "")) : initialSection;
   const activeSection = sectionValue || "all";
   const guidesQs = sectionValue ? `?section=${encodeURIComponent(sectionValue)}` : "";
-  const guidesRes = _chunkUSKQURNFcjs.useSelfFetch.call(void 0, 
+  const guidesRes = _chunkTG3VBMDGcjs.useSelfFetch.call(void 0, 
     selfFetch && guidesEndpoint ? `${guidesEndpoint}${guidesQs}` : null
   );
-  const sectionsRes = _chunkUSKQURNFcjs.useSelfFetch.call(void 0, selfFetch && sectionsEndpoint ? sectionsEndpoint : null);
+  const sectionsRes = _chunkTG3VBMDGcjs.useSelfFetch.call(void 0, selfFetch && sectionsEndpoint ? sectionsEndpoint : null);
   const guides = _react.useMemo.call(void 0, () => _nullishCoalesce(_nullishCoalesce(initialGuides, () => ( _optionalChain([guidesRes, 'access', _2 => _2.data, 'optionalAccess', _3 => _3.data]))), () => ( [])), [initialGuides, _optionalChain([guidesRes, 'access', _4 => _4.data, 'optionalAccess', _5 => _5.data])]);
   const sections = _react.useMemo.call(void 0, 
     () => _nullishCoalesce(initialSections, () => ( (Array.isArray(sectionsRes.data) ? sectionsRes.data : []))),
@@ -132,25 +132,25 @@ function OnboardingGuidesCatalogView({
     });
   };
   const source = _nullishCoalesce(_optionalChain([runtime, 'optionalAccess', _6 => _6.source]), () => ( "openframe"));
-  const docSearch = _chunk5XPK2QGUcjs.useDocSearch.call(void 0, {
+  const docSearch = _chunkKJHIFF6Hcjs.useDocSearch.call(void 0, {
     source,
     baseRoute: basePath,
     onNavigate: (path) => router.push(path),
     tableIds: ["onboarding-guides"]
   });
   const defaultRenderCard = (guide) => {
-    const cta = _chunkEXWS2QSDcjs.resolveContentHref.call(void 0, _optionalChain([runtime, 'optionalAccess', _7 => _7.composeContentUrl]), {
+    const cta = _chunkFNGX5WZMcjs.resolveContentHref.call(void 0, _optionalChain([runtime, 'optionalAccess', _7 => _7.composeContentUrl]), {
       type: "onboarding_guide",
       slug: guide.slug,
       basePath,
       platforms: guide.onboarding_guide_platforms
     });
-    return /* @__PURE__ */ _jsxruntime.jsx.call(void 0, _chunk53O6PQ3Fcjs.OnboardingGuideCard, { guide, href: cta.href, targetPlatform: cta.targetPlatform, size: "catalog" });
+    return /* @__PURE__ */ _jsxruntime.jsx.call(void 0, _chunkNDLFK57Dcjs.OnboardingGuideCard, { guide, href: cta.href, targetPlatform: cta.targetPlatform, size: "catalog" });
   };
   const renderCardFn = _nullishCoalesce(renderCard, () => ( defaultRenderCard));
   const preControls = /* @__PURE__ */ _jsxruntime.jsxs.call(void 0, "div", { className: "space-y-4", children: [
     /* @__PURE__ */ _jsxruntime.jsx.call(void 0, 
-      _chunk5XPK2QGUcjs.DocSearchBar,
+      _chunkKJHIFF6Hcjs.DocSearchBar,
       {
         placeholder: "Search onboarding guides, releases, case studies\u2026",
         query: docSearch.query,
@@ -162,7 +162,7 @@ function OnboardingGuidesCatalogView({
       }
     ),
     sections.length > 0 && /* @__PURE__ */ _jsxruntime.jsx.call(void 0, 
-      _chunkEXWS2QSDcjs.FilterPillRow,
+      _chunkFNGX5WZMcjs.FilterPillRow,
       {
         label: "Section",
         selectedValue: activeSection,
@@ -172,7 +172,7 @@ function OnboardingGuidesCatalogView({
     )
   ] });
   if (selfFetch && guidesRes.error) {
-    return /* @__PURE__ */ _jsxruntime.jsx.call(void 0, _chunkEXWS2QSDcjs.LoadError, { message: "Failed to load onboarding guides.", onRetry: guidesRes.reload });
+    return /* @__PURE__ */ _jsxruntime.jsx.call(void 0, _chunkFNGX5WZMcjs.LoadError, { message: "Failed to load onboarding guides.", onRetry: guidesRes.reload });
   }
   if (selfFetch && guidesRes.data == null && isLoading) {
     return /* @__PURE__ */ _jsxruntime.jsx.call(void 0, OnboardingGuidesCatalogSkeleton, {});
@@ -204,7 +204,7 @@ function OnboardingGuideDetailView({
   slug,
   guideEndpoint,
   related = [],
-  MarkdownRenderer = _chunkEXWS2QSDcjs.RichMarkdownRenderer,
+  MarkdownRenderer = _chunkFNGX5WZMcjs.RichMarkdownRenderer,
   renderRelatedCard,
   backHref,
   backLabel = "Back to Getting Started",
@@ -214,51 +214,51 @@ function OnboardingGuideDetailView({
 }) {
   const resolvedBackHref = _nullishCoalesce(backHref, () => ( basePath));
   const runtime = _chunkU2YLMFJKcjs.useChatRuntime.call(void 0, );
-  const captions = _chunkGZRU2A4Lcjs.useCaptions.call(void 0, );
+  const captions = _chunkC27F6GBZcjs.useCaptions.call(void 0, );
   const router = _chunkSADRZ4YIcjs.useRouter.call(void 0, );
-  const renderShell = (node) => shell ? /* @__PURE__ */ _jsxruntime.jsx.call(void 0, _chunkEXWS2QSDcjs.PageShell, { children: node }) : /* @__PURE__ */ _jsxruntime.jsx.call(void 0, "div", { className: "page-shell-content", children: node });
+  const renderShell = (node) => shell ? /* @__PURE__ */ _jsxruntime.jsx.call(void 0, _chunkFNGX5WZMcjs.PageShell, { children: node }) : /* @__PURE__ */ _jsxruntime.jsx.call(void 0, "div", { className: "page-shell-content", children: node });
   const url = initialData ? null : slug && guideEndpoint ? guideEndpoint(slug) : null;
-  const { data: guide, isLoading, error, reload } = _chunkUSKQURNFcjs.useSelfFetch.call(void 0, url, { initialData });
-  const { ref: videoWarmupRef } = _chunkGZRU2A4Lcjs.useVideoWarmup.call(void 0, {
+  const { data: guide, isLoading, error, reload } = _chunkTG3VBMDGcjs.useSelfFetch.call(void 0, url, { initialData });
+  const { ref: videoWarmupRef } = _chunkC27F6GBZcjs.useVideoWarmup.call(void 0, {
     videoUrl: _optionalChain([guide, 'optionalAccess', _8 => _8.main_video_url]),
     supabaseStorageOrigin: _optionalChain([runtime, 'optionalAccess', _9 => _9.endpoints, 'access', _10 => _10.supabaseStorageOrigin])
   });
   if (error || !guide && !isLoading) {
-    return renderShell(/* @__PURE__ */ _jsxruntime.jsx.call(void 0, _chunkEXWS2QSDcjs.LoadError, { message: "Guide not found.", onRetry: reload }));
+    return renderShell(/* @__PURE__ */ _jsxruntime.jsx.call(void 0, _chunkFNGX5WZMcjs.LoadError, { message: "Guide not found.", onRetry: reload }));
   }
   if (!guide) {
     return renderShell(
       // Match the loaded page's top offset (TitleBlock's
       // `pt-[var(--spacing-system-l)]`) so content doesn't jump on load.
-      /* @__PURE__ */ _jsxruntime.jsx.call(void 0, "div", { className: "pt-[var(--spacing-system-l)]", children: /* @__PURE__ */ _jsxruntime.jsx.call(void 0, _chunkF6LXGP6Scjs.DetailPageSkeleton, { bare: true, showImageGallery: false }) })
+      /* @__PURE__ */ _jsxruntime.jsx.call(void 0, "div", { className: "pt-[var(--spacing-system-l)]", children: /* @__PURE__ */ _jsxruntime.jsx.call(void 0, _chunkQ2B2MGFUcjs.DetailPageSkeleton, { bare: true, showImageGallery: false }) })
     );
   }
   const { captionsUrl, highlightCaptionsUrl } = captions.forEntity("onboarding_guide", guide);
   const videoPoster = guide.main_video_thumbnail || guide.featured_image || guide.og_image_url || // `buildOgPlaceholderUrl` always returns a usable string (relative route at
   // worst), so it's the terminal fallback — no trailing `|| undefined` needed.
-  _chunkI27PWVWEcjs.buildOgPlaceholderUrl.call(void 0, _optionalChain([runtime, 'optionalAccess', _11 => _11.endpoints]), guide.title, { aspect: "wide" });
+  _chunkWT4HURQNcjs.buildOgPlaceholderUrl.call(void 0, _optionalChain([runtime, 'optionalAccess', _11 => _11.endpoints]), guide.title, { aspect: "wide" });
   const defaultRenderRelatedCard = (g) => {
-    const cta = _chunkEXWS2QSDcjs.resolveContentHref.call(void 0, _optionalChain([runtime, 'optionalAccess', _12 => _12.composeContentUrl]), {
+    const cta = _chunkFNGX5WZMcjs.resolveContentHref.call(void 0, _optionalChain([runtime, 'optionalAccess', _12 => _12.composeContentUrl]), {
       type: "onboarding_guide",
       slug: g.slug,
       basePath,
       platforms: g.onboarding_guide_platforms
     });
-    return /* @__PURE__ */ _jsxruntime.jsx.call(void 0, _chunk53O6PQ3Fcjs.OnboardingGuideCard, { guide: g, href: cta.href, targetPlatform: cta.targetPlatform });
+    return /* @__PURE__ */ _jsxruntime.jsx.call(void 0, _chunkNDLFK57Dcjs.OnboardingGuideCard, { guide: g, href: cta.href, targetPlatform: cta.targetPlatform });
   };
   const renderRelatedCardFn = _nullishCoalesce(renderRelatedCard, () => ( defaultRenderRelatedCard));
   return renderShell(
     /* @__PURE__ */ _jsxruntime.jsxs.call(void 0, 
-      _chunkEXWS2QSDcjs.PageLayout,
+      _chunkFNGX5WZMcjs.PageLayout,
       {
         title: guide.title,
         titleSize: "h1",
         titleWrap: true,
         backButton: { label: backLabel, onClick: () => router.push(resolvedBackHref) },
         children: [
-          /* @__PURE__ */ _jsxruntime.jsx.call(void 0, _chunkEXWS2QSDcjs.EntityTagBadges, { tags: guide.onboarding_guide_tags }),
+          /* @__PURE__ */ _jsxruntime.jsx.call(void 0, _chunkFNGX5WZMcjs.EntityTagBadges, { tags: guide.onboarding_guide_tags }),
           /* @__PURE__ */ _jsxruntime.jsx.call(void 0, 
-            _chunk53O6PQ3Fcjs.EntityAuthorCard,
+            _chunkNDLFK57Dcjs.EntityAuthorCard,
             {
               author: guide.author,
               authorHref,
@@ -273,7 +273,7 @@ function OnboardingGuideDetailView({
             }
           ),
           (guide.main_video_url || guide.youtube_url) && /* @__PURE__ */ _jsxruntime.jsx.call(void 0, "div", { ref: videoWarmupRef, children: /* @__PURE__ */ _jsxruntime.jsx.call(void 0, 
-            _chunkGZRU2A4Lcjs.EntityVideoSection,
+            _chunkC27F6GBZcjs.EntityVideoSection,
             {
               mainVideoUrl: guide.main_video_url,
               youtubeUrl: guide.youtube_url || void 0,
@@ -291,17 +291,17 @@ function OnboardingGuideDetailView({
           ) }),
           guide.content && /* @__PURE__ */ _jsxruntime.jsx.call(void 0, "div", { className: "space-y-4", children: /* @__PURE__ */ _jsxruntime.jsx.call(void 0, MarkdownRenderer, { content: guide.content }) }),
           /* @__PURE__ */ _jsxruntime.jsx.call(void 0, 
-            _chunkGZRU2A4Lcjs.VideoBitesStrip,
+            _chunkC27F6GBZcjs.VideoBitesStrip,
             {
               bites: _nullishCoalesce(guide.video_bites, () => ( [])),
               filterPublished: true,
               showTitle: false,
-              profile: _chunk53O6PQ3Fcjs.toStripProfile.call(void 0, guide.author),
+              profile: _chunkNDLFK57Dcjs.toStripProfile.call(void 0, guide.author),
               href: `/onboarding-guides/${guide.slug}`
             }
           ),
           /* @__PURE__ */ _jsxruntime.jsx.call(void 0, 
-            _chunkF6LXGP6Scjs.ArticleAuthorByline,
+            _chunkQ2B2MGFUcjs.ArticleAuthorByline,
             {
               author: _nullishCoalesce(_optionalChain([guide, 'access', _13 => _13.author, 'optionalAccess', _14 => _14.full_name]), () => ( null)),
               avatar: _optionalChain([guide, 'access', _15 => _15.author, 'optionalAccess', _16 => _16.avatar_url]),
@@ -389,4 +389,4 @@ function useOnboardingGuideSections() {
 
 
 exports.OnboardingGuidesCatalogSkeleton = OnboardingGuidesCatalogSkeleton; exports.OnboardingGuidesCatalogView = OnboardingGuidesCatalogView; exports.OnboardingGuideDetailView = OnboardingGuideDetailView; exports.onboardingGuideKeys = onboardingGuideKeys; exports.useOnboardingGuides = useOnboardingGuides; exports.useOnboardingGuide = useOnboardingGuide; exports.useOnboardingGuideSections = useOnboardingGuideSections;
-//# sourceMappingURL=chunk-KDCIYRZV.cjs.map
+//# sourceMappingURL=chunk-2EQED5SZ.cjs.map

package/dist/{chunk-KDCIYRZV.cjs.map → chunk-2EQED5SZ.cjs.map}

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

package/dist/{chunk-JUNOY5HK.js → chunk-2HX6AADM.js}

@@ -8,6 +8,9 @@ import {
   OpenframeLogoGreyIcon,
   OsqueryLogoGreyIcon
 } from "./chunk-PBDSPANS.js";
+import {
+  useIsomorphicLayoutEffect
+} from "./chunk-7IINE3MK.js";
 
 // src/hooks/ui/use-is-truncated.ts
 import { useCallback, useEffect, useState } from "react";
@@ -46,10 +49,6 @@ function useDebounce(value, delay2 = 500) {
   return debouncedValue;
 }
 
-// src/hooks/ui/use-isomorphic-layout-effect.ts
-import { useEffect as useEffect3, useLayoutEffect } from "react";
-var useIsomorphicLayoutEffect = typeof window !== "undefined" ? useLayoutEffect : useEffect3;
-
 // src/hooks/ui/use-media-query.ts
 import { useState as useState3 } from "react";
 function useMediaQuery(query) {
@@ -86,11 +85,11 @@ function useLgUp() {
 }
 
 // src/hooks/ui/use-header-height.ts
-import { useEffect as useEffect4, useState as useState4 } from "react";
+import { useEffect as useEffect3, useState as useState4 } from "react";
 function useHeaderHeight(defaultHeight = 72, options = {}) {
   const { enabled = true } = options;
   const [height, setHeight] = useState4(defaultHeight);
-  useEffect4(() => {
+  useEffect3(() => {
     if (!enabled) return void 0;
     const measure = () => {
       let total = 0;
@@ -130,14 +129,14 @@ function useHeaderHeight(defaultHeight = 72, options = {}) {
 }
 
 // src/hooks/ui/use-marquee-engine.ts
-import { useCallback as useCallback2, useEffect as useEffect5, useRef } from "react";
+import { useCallback as useCallback2, useEffect as useEffect4, useRef } from "react";
 var RESYNC_EPSILON = 1.5;
 function useMarqueeEngine(options) {
   const posRef = useRef(0);
   const glideRemainingRef = useRef(0);
   const speedEnvRef = useRef(0);
   const optsRef = useRef(options);
-  useEffect5(() => {
+  useEffect4(() => {
     optsRef.current = options;
   });
   const wrap = useCallback2((pos) => {
@@ -153,7 +152,7 @@ function useMarqueeEngine(options) {
     glideRemainingRef.current += px;
   }, []);
   const active = options.active;
-  useEffect5(() => {
+  useEffect4(() => {
     if (!active) return void 0;
     let raf = 0;
     let last = performance.now();
@@ -198,9 +197,9 @@ function useMarqueeEngine(options) {
 }
 
 // src/hooks/ui/use-reset-on-page-hidden.ts
-import { useEffect as useEffect6 } from "react";
+import { useEffect as useEffect5 } from "react";
 function useResetOnPageHidden(reset) {
-  useEffect6(() => {
+  useEffect5(() => {
     const onVisibility = () => {
       if (document.visibilityState === "hidden") reset();
     };
@@ -214,11 +213,11 @@ function useResetOnPageHidden(reset) {
 }
 
 // src/hooks/ui/use-suppress-clone-focus.ts
-import { useEffect as useEffect7, useRef as useRef2 } from "react";
+import { useEffect as useEffect6, useRef as useRef2 } from "react";
 var CLONE_FOCUSABLE_SELECTOR = 'a[href],button,input,select,textarea,iframe,summary,audio[controls],video[controls],[tabindex],[contenteditable]:not([contenteditable="false"])';
 function useSuppressCloneFocus(active) {
   const ref = useRef2(null);
-  useEffect7(() => {
+  useEffect6(() => {
     const root = ref.current;
     if (!root || !active) return void 0;
     const suppress = () => {
@@ -352,7 +351,7 @@ function pick(source, keys) {
 var NO_CLIENT_CACHE = { staleTime: 0 };
 
 // src/hooks/use-near-viewport.ts
-import { useEffect as useEffect8, useRef as useRef3, useState as useState5, useCallback as useCallback3 } from "react";
+import { useEffect as useEffect7, useRef as useRef3, useState as useState5, useCallback as useCallback3 } from "react";
 var observers = /* @__PURE__ */ new Map();
 var subscribers = /* @__PURE__ */ new WeakMap();
 var THRESHOLD_EPSILON = 0.01;
@@ -404,7 +403,7 @@ function useNearViewport(rootMargin = NEAR_VIEWPORT_ROOT_MARGIN, threshold = 0)
     },
     [key, rootMargin, threshold]
   );
-  useEffect8(() => {
+  useEffect7(() => {
     return () => {
       const el = elRef.current;
       if (!el) return;
@@ -739,7 +738,6 @@ function navigateSamePageHash(target, options = {}) {
 export {
   useIsTruncated,
   useDebounce,
-  useIsomorphicLayoutEffect,
   useMediaQuery,
   breakpoints,
   useSmUp,
@@ -784,4 +782,4 @@ export {
   getHashTargetElement,
   navigateSamePageHash
 };
-//# sourceMappingURL=chunk-JUNOY5HK.js.map
+//# sourceMappingURL=chunk-2HX6AADM.js.map