@flamingo-stack/openframe-frontend-core 0.0.215 → 0.0.216

package/dist/components/navigation/index.cjs

@@ -15,21 +15,21 @@
 
 
 
-var _chunkD4MNFY67cjs = require('../../chunk-D4MNFY67.cjs');
-require('../../chunk-WT5JV2GS.cjs');
-require('../../chunk-24KCAECR.cjs');
-require('../../chunk-65CPJ4SX.cjs');
-require('../../chunk-XQFFGR6U.cjs');
-require('../../chunk-P5EE2VJX.cjs');
-require('../../chunk-27APPAJN.cjs');
+var _chunkZGTDUPTWcjs = require('../../chunk-ZGTDUPTW.cjs');
 require('../../chunk-XL4V2PYG.cjs');
 require('../../chunk-BZFW3FOF.cjs');
+require('../../chunk-XDPSSE4O.cjs');
+require('../../chunk-WBR7H6E3.cjs');
+require('../../chunk-5V6MSE3B.cjs');
 require('../../chunk-G7UE6RKV.cjs');
-require('../../chunk-OZ3GH6OQ.cjs');
-require('../../chunk-UXZ3ZJ3M.cjs');
+require('../../chunk-JJR27M56.cjs');
 require('../../chunk-664KA5FI.cjs');
+require('../../chunk-65CPJ4SX.cjs');
 require('../../chunk-WZW7C7TF.cjs');
-require('../../chunk-WBR7H6E3.cjs');
+require('../../chunk-XQFFGR6U.cjs');
+require('../../chunk-HOHDXYPR.cjs');
+require('../../chunk-27APPAJN.cjs');
+require('../../chunk-OZ3GH6OQ.cjs');
 require('../../chunk-VRHGVLSL.cjs');
 
 
@@ -46,5 +46,5 @@ require('../../chunk-VRHGVLSL.cjs');
 
 
 
-exports.AppHeader = _chunkD4MNFY67cjs.AppHeader; exports.AppLayout = _chunkD4MNFY67cjs.AppLayout; exports.ClientOnlyHeader = _chunkD4MNFY67cjs.ClientOnlyHeader; exports.Header = _chunkD4MNFY67cjs.Header; exports.HeaderButton = _chunkD4MNFY67cjs.HeaderButton; exports.HeaderGlobalSearch = _chunkD4MNFY67cjs.HeaderGlobalSearch; exports.HeaderOrganizationFilter = _chunkD4MNFY67cjs.HeaderOrganizationFilter; exports.HeaderSkeleton = _chunkD4MNFY67cjs.HeaderSkeleton; exports.MobileBurgerMenu = _chunkD4MNFY67cjs.MobileBurgerMenu; exports.MobileNavPanel = _chunkD4MNFY67cjs.MobileNavPanel; exports.NavigationSidebar = _chunkD4MNFY67cjs.NavigationSidebar; exports.SlidingSidebar = _chunkD4MNFY67cjs.SlidingSidebar; exports.StickySectionNav = _chunkD4MNFY67cjs.StickySectionNav; exports.useSectionNavigation = _chunkD4MNFY67cjs.useSectionNavigation;
+exports.AppHeader = _chunkZGTDUPTWcjs.AppHeader; exports.AppLayout = _chunkZGTDUPTWcjs.AppLayout; exports.ClientOnlyHeader = _chunkZGTDUPTWcjs.ClientOnlyHeader; exports.Header = _chunkZGTDUPTWcjs.Header; exports.HeaderButton = _chunkZGTDUPTWcjs.HeaderButton; exports.HeaderGlobalSearch = _chunkZGTDUPTWcjs.HeaderGlobalSearch; exports.HeaderOrganizationFilter = _chunkZGTDUPTWcjs.HeaderOrganizationFilter; exports.HeaderSkeleton = _chunkZGTDUPTWcjs.HeaderSkeleton; exports.MobileBurgerMenu = _chunkZGTDUPTWcjs.MobileBurgerMenu; exports.MobileNavPanel = _chunkZGTDUPTWcjs.MobileNavPanel; exports.NavigationSidebar = _chunkZGTDUPTWcjs.NavigationSidebar; exports.SlidingSidebar = _chunkZGTDUPTWcjs.SlidingSidebar; exports.StickySectionNav = _chunkZGTDUPTWcjs.StickySectionNav; exports.useSectionNavigation = _chunkZGTDUPTWcjs.useSectionNavigation;
 //# sourceMappingURL=index.cjs.map

package/dist/components/navigation/index.js

@@ -15,21 +15,21 @@ import {
   SlidingSidebar,
   StickySectionNav,
   useSectionNavigation
-} from "../../chunk-WQZP3JIZ.js";
-import "../../chunk-HICZPTRR.js";
-import "../../chunk-CIPO6DXK.js";
-import "../../chunk-EDW2NVRV.js";
-import "../../chunk-W72U7OU7.js";
-import "../../chunk-ZG2YY5E7.js";
-import "../../chunk-MJNXIEV2.js";
+} from "../../chunk-CDLYRFDE.js";
 import "../../chunk-LXC6P2EO.js";
 import "../../chunk-EL5YVPD5.js";
+import "../../chunk-UEBM4PC4.js";
+import "../../chunk-OHPI2HRK.js";
+import "../../chunk-LCLTCCXS.js";
 import "../../chunk-PLJLE4A4.js";
-import "../../chunk-CZR7ARBA.js";
-import "../../chunk-MX5MIFWA.js";
+import "../../chunk-QY75VKAS.js";
 import "../../chunk-KSOOKNBG.js";
+import "../../chunk-EDW2NVRV.js";
 import "../../chunk-6U3IUD57.js";
-import "../../chunk-OHPI2HRK.js";
+import "../../chunk-W72U7OU7.js";
+import "../../chunk-RFONYT63.js";
+import "../../chunk-MJNXIEV2.js";
+import "../../chunk-CZR7ARBA.js";
 import "../../chunk-GGWZFCYS.js";
 export {
   AppHeader,

package/dist/components/onboarding-guides/build-default-href.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Lib-internal helper — default href shape for onboarding-guide cards
+ * when `runtime.composeContentUrl` is not wired (single-platform
+ * embedders without cross-platform topology).
+ *
+ * Shared between `OnboardingGuidesCatalogView` (per-card href) and
+ * `OnboardingGuideDetailView` (per-related-card href) so both views
+ * compose hrefs from the same `basePath`-derived shape — no parallel
+ * 4-line helper to drift apart.
+ */
+export declare function buildDefaultHref(basePath: string, slug: string): {
+    href: string;
+    targetPlatform: string | null;
+};
+//# sourceMappingURL=build-default-href.d.ts.map

package/dist/components/onboarding-guides/build-default-href.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-default-href.d.ts","sourceRoot":"","sources":["../../../src/components/onboarding-guides/build-default-href.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,GACX;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,cAAc,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,CAEjD"}

package/dist/components/onboarding-guides/hooks/use-onboarding-guides.d.ts

@@ -0,0 +1,28 @@
+import type { OnboardingGuide, OnboardingGuideFilters, OnboardingGuideListResponse, OnboardingGuideSectionSummary } from '../../chat/types/entities/onboarding-guide';
+/**
+ * Cache key builder for the `['onboarding-guides']` namespace.
+ *
+ * Includes BOTH public-read sub-keys (`lists`, `list`, `details`,
+ * `detail`, `sections`) AND the `admin` sub-namespace. Admin mutations
+ * live hub-side but invalidate against this same builder so a single
+ * `qc.invalidateQueries({ queryKey: onboardingGuideKeys.all })` from
+ * an admin hook also clears the public read cache.
+ */
+export declare const onboardingGuideKeys: {
+    all: readonly ["onboarding-guides"];
+    lists: () => readonly ["onboarding-guides", "list"];
+    list: (filters: OnboardingGuideFilters) => readonly ["onboarding-guides", "list", OnboardingGuideFilters];
+    details: () => readonly ["onboarding-guides", "detail"];
+    detail: (slug: string) => readonly ["onboarding-guides", "detail", string];
+    sections: () => readonly ["onboarding-guides", "sections"];
+    admin: {
+        all: readonly ["admin", "onboarding-guides"];
+        lists: () => readonly ["admin", "onboarding-guides", "list"];
+        detail: (slug: string) => readonly ["admin", "onboarding-guide", string];
+        stats: () => readonly ["admin", "onboarding-guides", "stats"];
+    };
+};
+export declare function useOnboardingGuides(filters?: OnboardingGuideFilters): import("@tanstack/react-query").UseQueryResult<NoInfer<OnboardingGuideListResponse>, Error>;
+export declare function useOnboardingGuide(slug: string | undefined): import("@tanstack/react-query").UseQueryResult<NoInfer<OnboardingGuide>, Error>;
+export declare function useOnboardingGuideSections(): import("@tanstack/react-query").UseQueryResult<NoInfer<OnboardingGuideSectionSummary[]>, Error>;
+//# sourceMappingURL=use-onboarding-guides.d.ts.map

package/dist/components/onboarding-guides/hooks/use-onboarding-guides.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-onboarding-guides.d.ts","sourceRoot":"","sources":["../../../../src/components/onboarding-guides/hooks/use-onboarding-guides.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EACV,eAAe,EACf,sBAAsB,EACtB,2BAA2B,EAC3B,6BAA6B,EAC9B,MAAM,4CAA4C,CAAA;AAEnD;;;;;;;;GAQG;AACH,eAAO,MAAM,mBAAmB;;;oBAGd,sBAAsB;;mBAGvB,MAAM;;;;;uBAKJ,MAAM;;;CAIxB,CAAA;AAED,wBAAgB,mBAAmB,CAAC,OAAO,CAAC,EAAE,sBAAsB,+FAcnE;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,mFAU1D;AAED,wBAAgB,0BAA0B,oGAWzC"}

package/dist/components/onboarding-guides/index.cjs

@@ -0,0 +1,373 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _nullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return rhsFn(); } } function _optionalChain(ops) { let lastAccessLHS = undefined; let value = ops[0]; let i = 1; while (i < ops.length) { const op = ops[i]; const fn = ops[i + 1]; i += 2; if ((op === 'optionalAccess' || op === 'optionalCall') && value == null) { return undefined; } if (op === 'access' || op === 'optionalAccess') { lastAccessLHS = value; value = fn(value); } else if (op === 'call' || op === 'optionalCall') { value = fn((...args) => value.call(lastAccessLHS, ...args)); lastAccessLHS = undefined; } } return value; }"use client";
+
+
+
+var _chunk572WQWIXcjs = require('../../chunk-572WQWIX.cjs');
+
+
+var _chunkIH76P5R6cjs = require('../../chunk-IH76P5R6.cjs');
+require('../../chunk-OB45JHDY.cjs');
+
+
+
+
+
+
+
+
+
+
+
+var _chunkZGTDUPTWcjs = require('../../chunk-ZGTDUPTW.cjs');
+require('../../chunk-XL4V2PYG.cjs');
+require('../../chunk-BZFW3FOF.cjs');
+require('../../chunk-XDPSSE4O.cjs');
+
+
+var _chunkWBR7H6E3cjs = require('../../chunk-WBR7H6E3.cjs');
+require('../../chunk-5V6MSE3B.cjs');
+
+
+
+var _chunkG7UE6RKVcjs = require('../../chunk-G7UE6RKV.cjs');
+require('../../chunk-JJR27M56.cjs');
+require('../../chunk-664KA5FI.cjs');
+require('../../chunk-65CPJ4SX.cjs');
+require('../../chunk-WZW7C7TF.cjs');
+require('../../chunk-XQFFGR6U.cjs');
+
+
+var _chunkHOHDXYPRcjs = require('../../chunk-HOHDXYPR.cjs');
+require('../../chunk-27APPAJN.cjs');
+require('../../chunk-OZ3GH6OQ.cjs');
+require('../../chunk-VRHGVLSL.cjs');
+
+// src/components/onboarding-guides/onboarding-guides-catalog-view.tsx
+var _react = require('react');
+var _lucidereact = require('lucide-react');
+
+// src/components/onboarding-guides/build-default-href.ts
+function buildDefaultHref(basePath, slug) {
+  return { href: `${basePath}/${slug}`, targetPlatform: null };
+}
+
+// src/components/onboarding-guides/onboarding-guides-catalog-view.tsx
+var _jsxruntime = require('react/jsx-runtime');
+function OnboardingGuidesCatalogView({
+  initialGuides,
+  initialSections,
+  initialSection = "",
+  renderCard,
+  basePath = "/onboarding-guides"
+}) {
+  const router = _chunkG7UE6RKVcjs.useRouter.call(void 0, );
+  const searchParams = _chunkG7UE6RKVcjs.useSearchParams.call(void 0, );
+  const [isPending, startTransition] = _react.useTransition.call(void 0, );
+  const runtime = _chunkHOHDXYPRcjs.useChatRuntime.call(void 0, );
+  const activeSection = initialSection || "all";
+  const grouped = _react.useMemo.call(void 0, () => {
+    const map = /* @__PURE__ */ new Map();
+    for (const g of initialGuides) {
+      const existing = map.get(g.section);
+      if (existing) {
+        if (g.section_order < existing.section_order)
+          existing.section_order = g.section_order;
+        existing.guides.push(g);
+      } else {
+        map.set(g.section, { section_order: g.section_order, guides: [g] });
+      }
+    }
+    for (const entry of map.values()) {
+      entry.guides.sort(
+        (a, b) => a.step_order - b.step_order || a.title.localeCompare(b.title)
+      );
+    }
+    return Array.from(map.entries()).map(([section, info]) => ({ section, ...info })).sort(
+      (a, b) => a.section_order - b.section_order || a.section.localeCompare(b.section)
+    );
+  }, [initialGuides]);
+  const sectionFilterOptions = _react.useMemo.call(void 0, 
+    () => [
+      { value: "all", label: `All (${initialGuides.length})` },
+      ...initialSections.map((s) => ({
+        value: s.section,
+        label: `${s.section} (${s.count})`
+      }))
+    ],
+    [initialGuides.length, initialSections]
+  );
+  const setSection = (value) => {
+    const params = new URLSearchParams(searchParams.toString());
+    if (value === "all") {
+      params.delete("section");
+    } else {
+      params.set("section", value);
+    }
+    const qs = params.toString();
+    startTransition(() => {
+      router.push(qs ? `${basePath}?${qs}` : basePath);
+    });
+  };
+  const source = _nullishCoalesce(_optionalChain([runtime, 'optionalAccess', _2 => _2.source]), () => ( "openframe"));
+  const docSearch = _chunk572WQWIXcjs.useDocSearch.call(void 0, {
+    source,
+    baseRoute: basePath,
+    onNavigate: (path) => router.push(path),
+    tableIds: ["onboarding-guides"]
+  });
+  const defaultRenderCard = (guide) => {
+    const cta = _optionalChain([runtime, 'optionalAccess', _3 => _3.composeContentUrl]) ? runtime.composeContentUrl(
+      "onboarding_guide",
+      guide.slug,
+      guide.onboarding_guide_platforms
+    ) : buildDefaultHref(basePath, guide.slug);
+    return /* @__PURE__ */ _jsxruntime.jsx.call(void 0, 
+      _chunkZGTDUPTWcjs.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, 
+      _chunk572WQWIXcjs.DocSearchBar,
+      {
+        placeholder: "Search onboarding guides, releases, case studies\u2026",
+        query: docSearch.query,
+        onQueryChange: docSearch.setQuery,
+        results: docSearch.results,
+        isLoading: docSearch.isLoading,
+        onResultSelect: docSearch.handleResultSelect,
+        showDropdown: docSearch.keepDropdownOpen
+      }
+    ),
+    initialSections.length > 0 && /* @__PURE__ */ _jsxruntime.jsx.call(void 0, 
+      _chunkZGTDUPTWcjs.FilterPillRow,
+      {
+        label: "Section",
+        selectedValue: activeSection,
+        onValueChange: setSection,
+        options: sectionFilterOptions
+      }
+    )
+  ] });
+  return /* @__PURE__ */ _jsxruntime.jsx.call(void 0, _chunkIH76P5R6cjs.DevSectionPage, { sectionKey: "onboarding", preControls, children: initialGuides.length === 0 ? /* @__PURE__ */ _jsxruntime.jsxs.call(void 0, "div", { className: "text-center py-16", children: [
+    /* @__PURE__ */ _jsxruntime.jsx.call(void 0, _lucidereact.GraduationCap, { className: "h-12 w-12 text-ods-text-secondary mx-auto mb-4" }),
+    /* @__PURE__ */ _jsxruntime.jsx.call(void 0, "h2", { className: "text-ods-text-primary font-['DM_Sans'] text-[20px] font-semibold mb-2", children: "No onboarding guides found" }),
+    /* @__PURE__ */ _jsxruntime.jsx.call(void 0, "p", { className: "text-ods-text-secondary font-['DM_Sans'] text-[14px]", children: activeSection !== "all" ? "No guides in this section yet." : "We're working on the onboarding library. Check back soon." })
+  ] }) : /* @__PURE__ */ _jsxruntime.jsx.call(void 0, 
+    "div",
+    {
+      className: isPending ? "opacity-60 transition-opacity space-y-10" : "space-y-10",
+      children: grouped.map((sec) => /* @__PURE__ */ _jsxruntime.jsxs.call(void 0, "section", { className: "space-y-4", children: [
+        /* @__PURE__ */ _jsxruntime.jsxs.call(void 0, "h2", { className: "text-h3 tracking-[-0.36px] text-ods-text-primary flex items-center gap-2", children: [
+          sec.section,
+          /* @__PURE__ */ _jsxruntime.jsx.call(void 0, "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", children: sec.guides.length })
+        ] }),
+        /* @__PURE__ */ _jsxruntime.jsx.call(void 0, "ul", { className: "flex flex-col gap-4", children: sec.guides.map((guide) => /* @__PURE__ */ _jsxruntime.jsx.call(void 0, "li", { children: renderCardFn(guide) }, guide.id)) })
+      ] }, sec.section))
+    }
+  ) });
+}
+
+// src/components/onboarding-guides/onboarding-guide-detail-view.tsx
+
+
+function OnboardingGuideDetailView({
+  initialData: guide,
+  related = [],
+  MarkdownRenderer = _chunkZGTDUPTWcjs.SimpleMarkdownRenderer,
+  renderRelatedCard,
+  backHref,
+  backLabel = "Back to Getting Started",
+  basePath = "/onboarding-guides"
+}) {
+  const resolvedBackHref = _nullishCoalesce(backHref, () => ( basePath));
+  const runtime = _chunkHOHDXYPRcjs.useChatRuntime.call(void 0, );
+  const { ref: videoWarmupRef } = _chunkZGTDUPTWcjs.useVideoWarmup.call(void 0, {
+    videoUrl: guide.main_video_url,
+    supabaseStorageOrigin: _optionalChain([runtime, 'optionalAccess', _4 => _4.endpoints, 'access', _5 => _5.supabaseStorageOrigin])
+  });
+  const captionsUrl = _chunkZGTDUPTWcjs.getCaptionsUrl.call(void 0, 
+    "onboarding_guide",
+    guide.id,
+    guide.srt_content
+  );
+  const videoPoster = guide.main_video_thumbnail || guide.featured_image || guide.og_image_url || _optionalChain([runtime, 'optionalAccess', _6 => _6.resolvePlaceholderUrl, 'optionalCall', _7 => _7(guide.title, { aspect: "wide" })]) || void 0;
+  const defaultRenderRelatedCard = (g) => {
+    const cta = _optionalChain([runtime, 'optionalAccess', _8 => _8.composeContentUrl]) ? runtime.composeContentUrl(
+      "onboarding_guide",
+      g.slug,
+      g.onboarding_guide_platforms
+    ) : buildDefaultHref(basePath, g.slug);
+    return /* @__PURE__ */ _jsxruntime.jsx.call(void 0, 
+      _chunkZGTDUPTWcjs.OnboardingGuideCard,
+      {
+        guide: g,
+        href: cta.href,
+        targetPlatform: cta.targetPlatform
+      }
+    );
+  };
+  const renderRelatedCardFn = _nullishCoalesce(renderRelatedCard, () => ( defaultRenderRelatedCard));
+  return /* @__PURE__ */ _jsxruntime.jsx.call(void 0, _chunkZGTDUPTWcjs.ArticleDetailLayout, { children: /* @__PURE__ */ _jsxruntime.jsxs.call(void 0, "div", { className: "space-y-6 md:space-y-8", children: [
+    /* @__PURE__ */ _jsxruntime.jsxs.call(void 0, 
+      _chunkWBR7H6E3cjs.next_link_default,
+      {
+        href: resolvedBackHref,
+        className: "inline-flex items-center gap-2 text-ods-text-secondary hover:text-ods-accent transition-colors",
+        children: [
+          /* @__PURE__ */ _jsxruntime.jsx.call(void 0, _lucidereact.ArrowLeft, { className: "h-4 w-4" }),
+          /* @__PURE__ */ _jsxruntime.jsx.call(void 0, "span", { className: "text-h5", children: backLabel })
+        ]
+      }
+    ),
+    /* @__PURE__ */ _jsxruntime.jsx.call(void 0, "h1", { className: "text-h1 tracking-[-1.12px] text-ods-text-primary", children: guide.title }),
+    /* @__PURE__ */ _jsxruntime.jsx.call(void 0, 
+      _chunkZGTDUPTWcjs.EntityAuthorCard,
+      {
+        author: guide.author,
+        publishedAt: guide.published_at,
+        extraCells: [
+          {
+            value: `${guide.section} \xB7 Step ${guide.step_order}`,
+            label: "Section",
+            uppercase: false
+          }
+        ]
+      }
+    ),
+    (guide.main_video_url || guide.youtube_url) && /* @__PURE__ */ _jsxruntime.jsx.call(void 0, "div", { ref: videoWarmupRef, children: /* @__PURE__ */ _jsxruntime.jsx.call(void 0, 
+      _chunkZGTDUPTWcjs.EntityVideoSection,
+      {
+        mainVideoUrl: guide.main_video_url,
+        youtubeUrl: guide.youtube_url || void 0,
+        highlightVideoUrl: guide.highlight_video_url,
+        mainVideoPoster: videoPoster,
+        highlightVideoThumbnail: guide.highlight_video_thumbnail || void 0,
+        videoSummary: void 0,
+        videoBites: void 0,
+        title: guide.title,
+        srtContent: guide.srt_content,
+        captionsUrl,
+        MarkdownRenderer
+      }
+    ) }),
+    guide.content && /* @__PURE__ */ _jsxruntime.jsx.call(void 0, "div", { className: "space-y-4", children: /* @__PURE__ */ _jsxruntime.jsx.call(void 0, MarkdownRenderer, { content: guide.content }) }),
+    guide.video_bites && guide.video_bites.length > 0 && /* @__PURE__ */ _jsxruntime.jsx.call(void 0, 
+      _chunkZGTDUPTWcjs.VideoBitesDisplay,
+      {
+        bites: guide.video_bites,
+        filterPublished: true,
+        showTitle: false
+      }
+    ),
+    related.length > 0 && /* @__PURE__ */ _jsxruntime.jsxs.call(void 0, "div", { className: "space-y-4 pt-8 border-t border-ods-border", children: [
+      /* @__PURE__ */ _jsxruntime.jsxs.call(void 0, "h2", { className: "text-h3 tracking-[-0.36px] text-ods-text-primary", children: [
+        "More in ",
+        guide.section
+      ] }),
+      /* @__PURE__ */ _jsxruntime.jsx.call(void 0, "ul", { className: "flex flex-col gap-3", children: related.map((r) => /* @__PURE__ */ _jsxruntime.jsx.call(void 0, "li", { children: renderRelatedCardFn(r) }, r.id)) })
+    ] })
+  ] }) });
+}
+
+// src/components/onboarding-guides/onboarding-guides-catalog-skeleton.tsx
+
+function OnboardingGuidesCatalogSkeleton() {
+  return /* @__PURE__ */ _jsxruntime.jsx.call(void 0, 
+    _chunkIH76P5R6cjs.DevSectionPage,
+    {
+      sectionKey: "onboarding",
+      preControls: /* @__PURE__ */ _jsxruntime.jsxs.call(void 0, "div", { className: "space-y-4 animate-pulse", children: [
+        /* @__PURE__ */ _jsxruntime.jsx.call(void 0, "div", { className: "h-12 w-full bg-ods-card border border-ods-border rounded-md" }),
+        /* @__PURE__ */ _jsxruntime.jsxs.call(void 0, "div", { className: "flex flex-wrap items-center gap-3 p-4 bg-ods-card border border-ods-border rounded-lg", children: [
+          /* @__PURE__ */ _jsxruntime.jsx.call(void 0, "div", { className: "h-4 w-14 bg-ods-border/60 rounded" }),
+          [0, 1, 2, 3].map((i) => /* @__PURE__ */ _jsxruntime.jsx.call(void 0, 
+            "div",
+            {
+              className: "h-10 w-24 bg-ods-card border border-ods-border rounded-md"
+            },
+            i
+          ))
+        ] })
+      ] }),
+      children: /* @__PURE__ */ _jsxruntime.jsx.call(void 0, "div", { className: "space-y-10 animate-pulse", children: [4, 3, 3].map((cardCount, sectionIdx) => /* @__PURE__ */ _jsxruntime.jsxs.call(void 0, "section", { className: "space-y-4", children: [
+        /* @__PURE__ */ _jsxruntime.jsxs.call(void 0, "h2", { className: "text-h3 tracking-[-0.36px] text-ods-text-primary flex items-center gap-2", children: [
+          /* @__PURE__ */ _jsxruntime.jsx.call(void 0, "span", { className: "h-6 w-40 bg-ods-border/70 rounded" }),
+          /* @__PURE__ */ _jsxruntime.jsx.call(void 0, "span", { className: "h-5 w-8 bg-ods-text-secondary/20 rounded-full" })
+        ] }),
+        /* @__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, _chunkZGTDUPTWcjs.OnboardingGuideCardSkeleton, { size: "catalog" }) }, cardIdx)) })
+      ] }, sectionIdx)) })
+    }
+  );
+}
+
+// src/components/onboarding-guides/hooks/use-onboarding-guides.ts
+var _reactquery = require('@tanstack/react-query');
+var onboardingGuideKeys = {
+  all: ["onboarding-guides"],
+  lists: () => [...onboardingGuideKeys.all, "list"],
+  list: (filters) => [...onboardingGuideKeys.lists(), filters],
+  details: () => [...onboardingGuideKeys.all, "detail"],
+  detail: (slug) => [...onboardingGuideKeys.details(), slug],
+  sections: () => [...onboardingGuideKeys.all, "sections"],
+  admin: {
+    all: ["admin", "onboarding-guides"],
+    lists: () => ["admin", "onboarding-guides", "list"],
+    detail: (slug) => ["admin", "onboarding-guide", slug],
+    stats: () => ["admin", "onboarding-guides", "stats"]
+  }
+};
+function useOnboardingGuides(filters) {
+  return _reactquery.useQuery.call(void 0, {
+    queryKey: onboardingGuideKeys.list(filters || {}),
+    queryFn: async () => {
+      const params = new URLSearchParams();
+      if (_optionalChain([filters, 'optionalAccess', _9 => _9.search])) params.set("search", filters.search);
+      if (_optionalChain([filters, 'optionalAccess', _10 => _10.section])) params.set("section", filters.section);
+      if (_optionalChain([filters, 'optionalAccess', _11 => _11.limit])) params.set("limit", filters.limit.toString());
+      if (_optionalChain([filters, 'optionalAccess', _12 => _12.offset])) params.set("offset", filters.offset.toString());
+      const res = await fetch(`/api/onboarding-guides?${params}`);
+      if (!res.ok) throw new Error("Failed to fetch onboarding guides");
+      return res.json();
+    }
+  });
+}
+function useOnboardingGuide(slug) {
+  return _reactquery.useQuery.call(void 0, {
+    queryKey: onboardingGuideKeys.detail(slug || ""),
+    queryFn: async () => {
+      const res = await fetch(`/api/onboarding-guides/${slug}`);
+      if (!res.ok) throw new Error("Failed to fetch onboarding guide");
+      return res.json();
+    },
+    enabled: !!slug
+  });
+}
+function useOnboardingGuideSections() {
+  return _reactquery.useQuery.call(void 0, {
+    queryKey: onboardingGuideKeys.sections(),
+    queryFn: async () => {
+      const res = await fetch("/api/onboarding-guides/sections");
+      if (!res.ok)
+        throw new Error("Failed to fetch onboarding-guide sections");
+      return res.json();
+    },
+    staleTime: 0
+  });
+}
+
+
+
+
+
+
+
+
+exports.OnboardingGuideDetailView = OnboardingGuideDetailView; exports.OnboardingGuidesCatalogSkeleton = OnboardingGuidesCatalogSkeleton; exports.OnboardingGuidesCatalogView = OnboardingGuidesCatalogView; exports.onboardingGuideKeys = onboardingGuideKeys; exports.useOnboardingGuide = useOnboardingGuide; exports.useOnboardingGuideSections = useOnboardingGuideSections; exports.useOnboardingGuides = useOnboardingGuides;
+//# sourceMappingURL=index.cjs.map

package/dist/components/onboarding-guides/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/home/runner/work/openframe-oss-lib/openframe-oss-lib/openframe-frontend-core/dist/components/onboarding-guides/index.cjs","../../../src/components/onboarding-guides/onboarding-guides-catalog-view.tsx","../../../src/components/onboarding-guides/build-default-href.ts","../../../src/components/onboarding-guides/onboarding-guide-detail-view.tsx","../../../src/components/onboarding-guides/onboarding-guides-catalog-skeleton.tsx","../../../src/components/onboarding-guides/hooks/use-onboarding-guides.ts"],"names":["jsx"],"mappings":"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","file":"/home/runner/work/openframe-oss-lib/openframe-oss-lib/openframe-frontend-core/dist/components/onboarding-guides/index.cjs","sourcesContent":[null,"'use client'\n\n/**\n * Public-facing catalog view for `/onboarding-guides` on openframe.\n *\n * Self-contained: every concern that used to require a hub-side\n * wrapper now flows through lib primitives + the ChatRuntime context.\n *\n *   - Chrome: `<DevSectionPage sectionKey=\"onboarding\">` (same lib\n *     primitive every other dev-center surface uses).\n *   - Search bar: lib `<DocSearchBar>` + `useDocSearch` directly,\n *     pre-scoped to `tableIds: ['onboarding-guides']`. The chat\n *     runtime's `source` discriminates the RAG namespace.\n *   - Section filter: lib `<FilterSection>` + URL push via embed-shim\n *     `useRouter`/`useSearchParams`.\n *   - Cards: lib `<OnboardingGuideCard>` with hrefs composed via\n *     `runtime.composeContentUrl?.('onboarding_guide', slug, platforms)`.\n *     Falls back to a same-origin relative path when no composer is\n *     wired (single-platform embedders).\n *\n * No hub-side wrapper file required.\n */\n\nimport { useMemo, useTransition, type ReactNode } from 'react'\nimport { GraduationCap } from 'lucide-react'\n\nimport { useRouter, useSearchParams } from '../../embed-shims'\nimport { DevSectionPage } from '../shared/dev-section'\nimport { DocSearchBar, useDocSearch } from '../shared/doc-search'\nimport { FilterPillRow } from '../ui/filter-pill-row'\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 { buildDefaultHref } from './build-default-href'\n\nexport interface OnboardingGuidesCatalogViewProps {\n  initialGuides: OnboardingGuide[]\n  initialSections: Array<{\n    section: string\n    section_order: number\n    count: number\n  }>\n  initialSection?: string\n  /** Optional per-row card renderer override. When omitted, lib\n   *  renders `<OnboardingGuideCard>` with runtime-composed href.\n   *  Embedders only override to swap the card shape entirely. */\n  renderCard?: (guide: OnboardingGuide) => ReactNode\n  /** Base path the catalog is mounted under. Used as the fallback\n   *  `href` prefix for card hrefs when `runtime.composeContentUrl` is\n   *  not wired. Embedders mounting at `/docs/onboarding/` instead of\n   *  `/onboarding-guides/` should override. Also used by `setSection`\n   *  for the `?section=` URL push. Default `/onboarding-guides`. */\n  basePath?: string\n}\n\nexport function OnboardingGuidesCatalogView({\n  initialGuides,\n  initialSections,\n  initialSection = '',\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  const activeSection = initialSection || 'all'\n\n  // Section grouping. Data arrives already filtered server-side via\n  // `?section=`; this just buckets the visible rows for the section-\n  // header layout — no client-side `.filter()`.\n  const grouped = useMemo(() => {\n    const map = new Map<\n      string,\n      { section_order: number; guides: OnboardingGuide[] }\n    >()\n    for (const g of initialGuides) {\n      const existing = map.get(g.section)\n      if (existing) {\n        if (g.section_order < existing.section_order)\n          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(\n        (a, b) =>\n          a.step_order - b.step_order || a.title.localeCompare(b.title),\n      )\n    }\n    return Array.from(map.entries())\n      .map(([section, info]) => ({ section, ...info }))\n      .sort(\n        (a, b) =>\n          a.section_order - b.section_order ||\n          a.section.localeCompare(b.section),\n      )\n  }, [initialGuides])\n\n  // Section-filter options for the lib `<FilterSection>` row.\n  const sectionFilterOptions = useMemo(\n    () => [\n      { value: 'all', label: `All (${initialGuides.length})` },\n      ...initialSections.map((s) => ({\n        value: s.section,\n        label: `${s.section} (${s.count})`,\n      })),\n    ],\n    [initialGuides.length, initialSections],\n  )\n\n  // Section pill change → push `?section=X` so the host RSC re-\n  // fetches against the DAL. Wrapped in `useTransition` so the\n  // results grid dims while the new payload is in flight.\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 the RAG-search\n  // `tableIds` parameter. The hook calls `/api/docs/search` directly;\n  // hub or embedder must expose that endpoint (reverse-proxy on\n  // non-Next.js hosts).\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 — uses runtime-composed href for cross-\n  // platform navigation. Falls back to a same-origin relative URL\n  // when no composer is wired.\n  const defaultRenderCard = (guide: OnboardingGuide) => {\n    const cta = runtime?.composeContentUrl\n      ? runtime.composeContentUrl(\n          'onboarding_guide',\n          guide.slug,\n          guide.onboarding_guide_platforms,\n        )\n      : buildDefaultHref(basePath, guide.slug)\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      {initialSections.length > 0 && (\n        <FilterPillRow\n          label=\"Section\"\n          selectedValue={activeSection}\n          onValueChange={setSection}\n          options={sectionFilterOptions}\n        />\n      )}\n    </div>\n  )\n\n  return (\n    <DevSectionPage sectionKey=\"onboarding\" preControls={preControls}>\n      {initialGuides.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\n          className={\n            isPending\n              ? 'opacity-60 transition-opacity space-y-10'\n              : 'space-y-10'\n          }\n        >\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\n                  steps read top-to-bottom (Step 1 above Step 2 above\n                  Step 3); 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    </DevSectionPage>\n  )\n}\n","/**\n * Lib-internal helper — default href shape for onboarding-guide cards\n * when `runtime.composeContentUrl` is not wired (single-platform\n * embedders without cross-platform topology).\n *\n * Shared between `OnboardingGuidesCatalogView` (per-card href) and\n * `OnboardingGuideDetailView` (per-related-card href) so both views\n * compose hrefs from the same `basePath`-derived shape — no parallel\n * 4-line helper to drift apart.\n */\nexport function buildDefaultHref(\n  basePath: string,\n  slug: string,\n): { href: string; targetPlatform: string | null } {\n  return { href: `${basePath}/${slug}`, targetPlatform: null }\n}\n","'use client'\n\n/**\n * Public-facing detail view for `/onboarding-guides/<slug>` on\n * openframe.\n *\n * Self-contained: every concern that used to require a hub-side\n * wrapper now flows through lib primitives + the ChatRuntime context.\n *\n *   - Markdown: lib `<SimpleMarkdownRenderer>` (already lib-resident).\n *   - Video warmup: lib `useVideoWarmup` (reads Supabase storage\n *     origin from `runtime.endpoints.supabaseStorageOrigin`; Mux\n *     origins are hardcoded public CDN hosts).\n *   - Captions URL: lib `getCaptionsUrl` (pure URL builder).\n *   - Video poster: inline priority chain\n *     (`main_video_thumbnail || featured_image || og_image_url`) —\n *     same fallbacks the card uses.\n *   - Related card hrefs: `runtime.composeContentUrl?.(\n *     'onboarding_guide', slug, platforms)` — falls back to same-\n *     origin relative path when no composer is wired.\n *\n * No hub-side wrapper file required. Optional `MarkdownRenderer`\n * prop lets hosts swap in a renderer with extra plugins (Reddit /\n * Twitter / X embeds) when needed.\n */\n\nimport { type ComponentType, type ReactNode } from 'react'\nimport { ArrowLeft } from 'lucide-react'\n\nimport { Link } from '../../embed-shims'\nimport { ArticleDetailLayout } from '../layout/article-detail-layout'\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 { SimpleMarkdownRenderer } from '../ui/simple-markdown-renderer'\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 { buildDefaultHref } from './build-default-href'\n\nexport interface OnboardingGuideDetailViewProps {\n  initialData: OnboardingGuide\n  related?: OnboardingGuide[]\n  /** Optional markdown renderer override. Defaults to lib\n   *  `<SimpleMarkdownRenderer>`. Hosts override when they need extra\n   *  plugins (Reddit / Twitter / X / code-block enhancements). */\n  MarkdownRenderer?: ComponentType<{ content: string }>\n  /** Optional per-row related-card renderer override. When omitted,\n   *  lib renders `<OnboardingGuideCard>` with runtime-composed href. */\n  renderRelatedCard?: (guide: OnboardingGuide) => ReactNode\n  /** Back-link target. Defaults to `basePath` so the link returns to\n   *  the catalog the embedder is hosting (no drift when `basePath`\n   *  is overridden). The admin preview explicitly overrides to\n   *  `/admin/onboarding-guides`. */\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. Embedders mounting at\n   *  `/docs/onboarding/` instead of `/onboarding-guides/` should\n   *  override. Default `/onboarding-guides`. */\n  basePath?: string\n}\n\nexport function OnboardingGuideDetailView({\n  initialData: guide,\n  related = [],\n  MarkdownRenderer = SimpleMarkdownRenderer,\n  renderRelatedCard,\n  backHref,\n  backLabel = 'Back to Getting Started',\n  basePath = '/onboarding-guides',\n}: OnboardingGuideDetailViewProps) {\n  // Resolve `backHref` from `basePath` when not explicitly set — so\n  // an embedder overriding `basePath=\"/docs/onboarding\"` automatically\n  // gets the right back link without remembering to thread `backHref`\n  // too. Admin preview still wins via its explicit `backHref` override.\n  const resolvedBackHref = backHref ?? basePath\n  const runtime = useChatRuntime()\n\n  // Video warmup — preconnect always fires; preload only when the\n  // container scrolls within ~1 viewport AND the URL is on the\n  // configured Supabase storage origin. No origin in runtime ⇒\n  // preconnect-only path (Mux/YouTube unaffected).\n  const { ref: videoWarmupRef } = useVideoWarmup<HTMLDivElement>({\n    videoUrl: guide.main_video_url,\n    supabaseStorageOrigin: runtime?.endpoints.supabaseStorageOrigin,\n  })\n\n  const captionsUrl = getCaptionsUrl(\n    'onboarding_guide',\n    guide.id,\n    guide.srt_content,\n  )\n\n  // Video poster — fallback chain:\n  //   1. Entity-owned thumbnails (main_video_thumbnail / featured_image / og_image_url)\n  //   2. Branded OG placeholder from `runtime.resolvePlaceholderUrl(title)`\n  //      — restores the hub's prior behavior where a video without a\n  //      thumbnail still showed a branded poster instead of a black\n  //      frame.\n  //   3. `undefined` (player picks its own default poster — usually\n  //      first-frame extraction).\n  const videoPoster =\n    guide.main_video_thumbnail ||\n    guide.featured_image ||\n    guide.og_image_url ||\n    runtime?.resolvePlaceholderUrl?.(guide.title, { aspect: 'wide' }) ||\n    undefined\n\n  // Default related-card renderer — runtime-composed cross-platform href.\n  const defaultRenderRelatedCard = (g: OnboardingGuide) => {\n    const cta = runtime?.composeContentUrl\n      ? runtime.composeContentUrl(\n          'onboarding_guide',\n          g.slug,\n          g.onboarding_guide_platforms,\n        )\n      : buildDefaultHref(basePath, g.slug)\n    return (\n      <OnboardingGuideCard\n        guide={g}\n        href={cta.href}\n        targetPlatform={cta.targetPlatform}\n      />\n    )\n  }\n  const renderRelatedCardFn = renderRelatedCard ?? defaultRenderRelatedCard\n\n  return (\n    <ArticleDetailLayout>\n      <div className=\"space-y-6 md:space-y-8\">\n        {/* Back link */}\n        <Link\n          href={resolvedBackHref}\n          className=\"inline-flex items-center gap-2 text-ods-text-secondary hover:text-ods-accent transition-colors\"\n        >\n          <ArrowLeft className=\"h-4 w-4\" />\n          <span className=\"text-h5\">{backLabel}</span>\n        </Link>\n\n        <h1 className=\"text-h1 tracking-[-1.12px] text-ods-text-primary\">\n          {guide.title}\n        </h1>\n\n        {/* Metadata grid — Section · Step | Published | Author. */}\n        <EntityAuthorCard\n          author={guide.author}\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\n            independent columns — either one populated should render\n            the player. `EntityVideoSection` routes accordingly. */}\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        {/* 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      </div>\n    </ArticleDetailLayout>\n  )\n}\n","'use client'\n\nimport { DevSectionPage } from '../shared/dev-section'\nimport { OnboardingGuideCardSkeleton } from '../chat/entity-cards/onboarding-guide-card'\n\n/**\n * Page-level Suspense fallback for `/onboarding-guides`.\n *\n * Mirrors the loaded `<OnboardingGuidesCatalogView>` shape — both\n * mount the same `<DevSectionPage sectionKey=\"onboarding\">` so the\n * hero, back button, and overall page scaffold render identically.\n *\n * The `preControls` slot reserves space for the search bar (h-12)\n * plus the section pill row (~74px including padding) so the\n * Suspense → loaded transition doesn't shift vertically.\n *\n * Card distribution `4 + 3 + 3 = 10` matches the typical openframe\n * onboarding dataset; per-card height (288 px) is byte-identical to\n * the loaded card so per-card shifts on resolve are zero.\n */\nexport function OnboardingGuidesCatalogSkeleton() {\n  return (\n    <DevSectionPage\n      sectionKey=\"onboarding\"\n      preControls={\n        <div className=\"space-y-4 animate-pulse\">\n          {/* Search input placeholder — matches `<SearchInput>` h-12. */}\n          <div className=\"h-12 w-full bg-ods-card border border-ods-border rounded-md\" />\n          {/* Section pill row placeholder — same wrapper class set the\n              hub-side `<FilterSection>` uses (~74 px). */}\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      }\n    >\n      <div className=\"space-y-10 animate-pulse\">\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    </DevSectionPage>\n  )\n}\n","'use client'\n\n/**\n * React Query hooks for Onboarding Guides — PUBLIC reads only.\n *\n * Admin mutations (create/update/delete/publish/stats/save-highlight)\n * stay HUB-side in `hooks/use-onboarding-guides.ts` and import the\n * `onboardingGuideKeys.admin` sub-namespace from this module so the\n * cache namespace `['onboarding-guides']` has a single source of truth.\n *\n * Endpoints (`/api/onboarding-guides*`) are host-supplied — non-Next.js\n * embedders must reverse-proxy the same routes. Same precedent as the\n * tickets list hook.\n */\n\nimport { useQuery } from '@tanstack/react-query'\n\nimport type {\n  OnboardingGuide,\n  OnboardingGuideFilters,\n  OnboardingGuideListResponse,\n  OnboardingGuideSectionSummary,\n} from '../../chat/types/entities/onboarding-guide'\n\n/**\n * Cache key builder for the `['onboarding-guides']` namespace.\n *\n * Includes BOTH public-read sub-keys (`lists`, `list`, `details`,\n * `detail`, `sections`) AND the `admin` sub-namespace. Admin mutations\n * live hub-side but invalidate against this same builder so a single\n * `qc.invalidateQueries({ queryKey: onboardingGuideKeys.all })` from\n * an admin hook also clears the public read cache.\n */\nexport const onboardingGuideKeys = {\n  all: ['onboarding-guides'] as const,\n  lists: () => [...onboardingGuideKeys.all, 'list'] as const,\n  list: (filters: OnboardingGuideFilters) =>\n    [...onboardingGuideKeys.lists(), filters] as const,\n  details: () => [...onboardingGuideKeys.all, 'detail'] as const,\n  detail: (slug: string) => [...onboardingGuideKeys.details(), slug] as const,\n  sections: () => [...onboardingGuideKeys.all, 'sections'] as const,\n  admin: {\n    all: ['admin', 'onboarding-guides'] as const,\n    lists: () => ['admin', 'onboarding-guides', 'list'] as const,\n    detail: (slug: string) =>\n      ['admin', 'onboarding-guide', slug] as const,\n    stats: () => ['admin', 'onboarding-guides', 'stats'] as const,\n  },\n}\n\nexport function useOnboardingGuides(filters?: OnboardingGuideFilters) {\n  return useQuery({\n    queryKey: onboardingGuideKeys.list(filters || {}),\n    queryFn: async (): Promise<OnboardingGuideListResponse> => {\n      const params = new URLSearchParams()\n      if (filters?.search) params.set('search', filters.search)\n      if (filters?.section) params.set('section', filters.section)\n      if (filters?.limit) params.set('limit', filters.limit.toString())\n      if (filters?.offset) params.set('offset', filters.offset.toString())\n      const res = await fetch(`/api/onboarding-guides?${params}`)\n      if (!res.ok) throw new Error('Failed to fetch onboarding guides')\n      return res.json()\n    },\n  })\n}\n\nexport function useOnboardingGuide(slug: string | undefined) {\n  return useQuery({\n    queryKey: onboardingGuideKeys.detail(slug || ''),\n    queryFn: async (): Promise<OnboardingGuide> => {\n      const res = await fetch(`/api/onboarding-guides/${slug}`)\n      if (!res.ok) throw new Error('Failed to fetch onboarding guide')\n      return res.json()\n    },\n    enabled: !!slug,\n  })\n}\n\nexport function useOnboardingGuideSections() {\n  return useQuery({\n    queryKey: onboardingGuideKeys.sections(),\n    queryFn: async (): Promise<OnboardingGuideSectionSummary[]> => {\n      const res = await fetch('/api/onboarding-guides/sections')\n      if (!res.ok)\n        throw new Error('Failed to fetch onboarding-guide sections')\n      return res.json()\n    },\n    staleTime: 0,\n  })\n}\n"]}

package/dist/components/onboarding-guides/index.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Onboarding Guides surface barrel.
+ *
+ * Mirrors `components/tickets/` — top-level openframe-route-specific
+ * product surface (NOT under `shared/`, which is reserved for
+ * cross-platform marketing).
+ *
+ * IMPORTANT: this barrel MUST NOT re-export `OnboardingGuide`,
+ * `OnboardingGuideFilters`, `OnboardingGuideListResponse`, or
+ * `OnboardingGuideSectionSummary`. Those types already flow via
+ * `components/chat/types/entities/onboarding-guide.ts` (re-exported
+ * from `components/chat` through `./types/*`). A duplicate path
+ * triggers TypeScript's TS2308 ambiguous re-export at the top-level
+ * `components/index.ts` barrel — same gotcha documented for
+ * `RoadmapItem` at `shared/roadmap/index.ts:1-14`.
+ *
+ * Consumers needing the row type:
+ *   import type { OnboardingGuide } from
+ *     '@flamingo-stack/openframe-frontend-core/components/chat'
+ */
+export { OnboardingGuidesCatalogView, type OnboardingGuidesCatalogViewProps, } from './onboarding-guides-catalog-view';
+export { OnboardingGuideDetailView, type OnboardingGuideDetailViewProps, } from './onboarding-guide-detail-view';
+export { OnboardingGuidesCatalogSkeleton, } from './onboarding-guides-catalog-skeleton';
+export { useOnboardingGuides, useOnboardingGuide, useOnboardingGuideSections, onboardingGuideKeys, } from './hooks/use-onboarding-guides';
+//# sourceMappingURL=index.d.ts.map

package/dist/components/onboarding-guides/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/onboarding-guides/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,EACL,2BAA2B,EAC3B,KAAK,gCAAgC,GACtC,MAAM,kCAAkC,CAAA;AACzC,OAAO,EACL,yBAAyB,EACzB,KAAK,8BAA8B,GACpC,MAAM,gCAAgC,CAAA;AACvC,OAAO,EACL,+BAA+B,GAChC,MAAM,sCAAsC,CAAA;AAE7C,OAAO,EACL,mBAAmB,EACnB,kBAAkB,EAClB,0BAA0B,EAC1B,mBAAmB,GACpB,MAAM,+BAA+B,CAAA"}