@flamingo-stack/openframe-frontend-core 0.0.249 → 0.0.251-snapshot.20260610152056

package/dist/{chunk-VAKBNCV6.js → chunk-4AVACC2J.js}

@@ -21,10 +21,11 @@ import {
   buildListUrl,
   buildProductReleaseCardProps,
   canonicalContentRefType,
+  extractItemId,
   extractItems,
   getContentRefLabelOrTitleCase,
   orderContentRefTypes
-} from "./chunk-PCXI7ZB2.js";
+} from "./chunk-D2BC3NZ2.js";
 import {
   buildSuggestionUrl
 } from "./chunk-VAUI3CND.js";
@@ -171,7 +172,8 @@ function ContentGroup({
   resolveHref,
   LinkProvider,
   extras,
-  adminCampaignCard
+  adminCampaignCard,
+  heading
 }) {
   const { items, isLoading } = useGroupItems(type, refs, buildUrl);
   const config = resolveGroupConfig(type);
@@ -179,10 +181,15 @@ function ContentGroup({
   const cardSize = config.gridSize;
   if (isLoading && !items) {
     const skeletons = refs.map((r) => /* @__PURE__ */ jsx("div", { children: renderSkeletonForType(type, cardSize, adminCampaignCard) }, r.id));
-    return isListLayout ? /* @__PURE__ */ jsx("div", { className: "space-y-4", children: skeletons }) : /* @__PURE__ */ jsx("div", { className: gridClassFor(columns), children: skeletons });
+    return /* @__PURE__ */ jsxs("div", { className: "space-y-4", children: [
+      heading,
+      isListLayout ? /* @__PURE__ */ jsx("div", { className: "space-y-4", children: skeletons }) : /* @__PURE__ */ jsx("div", { className: gridClassFor(columns), children: skeletons })
+    ] });
   }
   if (!items || items.length === 0) return null;
-  const itemById = new Map(items.map((it) => [String(it.id), it]));
+  const itemById = new Map(
+    items.map((it) => [extractItemId(type, it) ?? String(it?.id), it])
+  );
   const cards = refs.map((contentRef) => {
     const itemId = String(contentRef.id);
     const item = itemById.get(itemId);
@@ -195,7 +202,6 @@ function ContentGroup({
       {
         type,
         item,
-        contentRef,
         size: cardSize,
         href,
         targetPlatform,
@@ -206,7 +212,10 @@ function ContentGroup({
     ) }) }, itemId);
   }).filter(Boolean);
   if (cards.length === 0) return null;
-  return isListLayout ? /* @__PURE__ */ jsx("div", { className: "space-y-4", children: cards }) : /* @__PURE__ */ jsx("div", { className: gridClassFor(columns), children: cards });
+  return /* @__PURE__ */ jsxs("div", { className: "space-y-4", children: [
+    heading,
+    isListLayout ? /* @__PURE__ */ jsx("div", { className: "space-y-4", children: cards }) : /* @__PURE__ */ jsx("div", { className: gridClassFor(columns), children: cards })
+  ] });
 }
 function RelatedContentSection({
   contentRefs,
@@ -226,7 +235,8 @@ function RelatedContentSection({
   LinkProvider = DefaultLinkPropsProvider,
   adminCampaignCard
 }) {
-  const suggestUrl = contentRefs === void 0 && entityType && entityId !== void 0 && entityId !== null && entityId !== "" && includeTypes?.length !== 0 ? buildSuggestionUrl("/api/related-content", {
+  const suggestionsDisabled = includeTypes?.length === 0;
+  const suggestUrl = contentRefs === void 0 && entityType && entityId !== void 0 && entityId !== null && entityId !== "" && !suggestionsDisabled ? buildSuggestionUrl("/api/related-content", {
     apiBaseUrl,
     entityType,
     entityId,
@@ -238,8 +248,11 @@ function RelatedContentSection({
     }
   }) : null;
   const initialData = useMemo(
-    () => initialItems ? { refs: initialItems } : void 0,
-    [initialItems]
+    // An explicitly disabled rail (includeTypes: []) must ignore SSR-hydrated
+    // refs too — otherwise useSelfFetch(null, {initialData}) keeps serving
+    // initialItems and the "nothing participates" contract silently breaks.
+    () => !suggestionsDisabled && initialItems ? { refs: initialItems } : void 0,
+    [initialItems, suggestionsDisabled]
   );
   const { data } = useSelfFetch(suggestUrl, { initialData });
   const effectiveBuildListUrl = useMemo(
@@ -257,33 +270,33 @@ function RelatedContentSection({
   }
   let orderedTypes = orderContentRefTypes(Object.keys(grouped));
   if (entityType) {
-    const sameType = orderedTypes.filter((t) => canonicalContentRefType(t) === entityType);
+    const canonicalEntityType = canonicalContentRefType(entityType);
+    const sameType = orderedTypes.filter((t) => canonicalContentRefType(t) === canonicalEntityType);
     if (sameType.length > 0) {
-      orderedTypes = [...sameType, ...orderedTypes.filter((t) => canonicalContentRefType(t) !== entityType)];
+      orderedTypes = [...sameType, ...orderedTypes.filter((t) => canonicalContentRefType(t) !== canonicalEntityType)];
     }
   }
   return /* @__PURE__ */ jsxs("div", { className: "space-y-8", children: [
     /* @__PURE__ */ jsx("h2", { className: "text-2xl font-bold text-ods-text-primary", children: title }),
-    orderedTypes.map((type) => /* @__PURE__ */ jsxs("div", { className: "space-y-4", children: [
-      /* @__PURE__ */ jsx("h3", { className: "font-['Azeret_Mono'] text-[14px] font-semibold uppercase text-ods-text-secondary tracking-wider", children: getContentRefLabelOrTitleCase(type) }),
-      /* @__PURE__ */ jsx(
-        ContentGroup,
-        {
-          type,
-          refs: grouped[type],
-          columns,
-          buildUrl: effectiveBuildListUrl,
-          resolveHref,
-          LinkProvider,
-          extras,
-          adminCampaignCard
-        }
-      )
-    ] }, type))
+    orderedTypes.map((type) => /* @__PURE__ */ jsx(
+      ContentGroup,
+      {
+        type,
+        refs: grouped[type],
+        columns,
+        buildUrl: effectiveBuildListUrl,
+        resolveHref,
+        LinkProvider,
+        extras,
+        adminCampaignCard,
+        heading: /* @__PURE__ */ jsx("h3", { className: "font-['Azeret_Mono'] text-[14px] font-semibold uppercase text-ods-text-secondary tracking-wider", children: getContentRefLabelOrTitleCase(type) })
+      },
+      type
+    ))
   ] });
 }
 
 export {
   RelatedContentSection
 };
-//# sourceMappingURL=chunk-VAKBNCV6.js.map
+//# sourceMappingURL=chunk-4AVACC2J.js.map

package/dist/chunk-4AVACC2J.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/components/related-content/related-content-section.tsx"],"sourcesContent":["\"use client\";\n\n/**\n * RelatedContentSection\n *\n * Renders content references grouped by type using the canonical card\n * components. MOVED from the hub (`components/shared/related-content-card.tsx`)\n * so any consuming app can embed it; the hub keeps a thin wrapper that\n * pre-binds its host-specific injections (nav hook, URL recomposition,\n * program configs, admin campaign card).\n *\n * THREE data modes (precedence top-down):\n *   1. CONTROLLED — `contentRefs` provided (even `[]`): render exactly those\n *      refs, no suggestion fetch (the original investor-update behavior).\n *   2. SUGGESTION — `entityType` + `entityId` provided: self-fetch\n *      `GET {apiBaseUrl}/api/related-content?entityType&entityId[&count][&excludeTypes]`\n *      (the generic 5-tier engine's second web service). `minResults` maps to\n *      `count`; absent → param not sent (server default applies). Each ref\n *      carries a `reason` (data-only — never rendered, matching the\n *      FaqSection/FaqWithReason precedent).\n *   3. SSR-HYDRATED suggestion — also pass `initialItems` (the server page\n *      called the engine directly); the first client fetch is skipped per the\n *      `useSelfFetch` initialData contract.\n *\n * Group layout (list vs grid) + card size (lg vs default) come from\n * `CONTENT_REF_GROUPS` in `../../utils/content-ref-groups` — single source of\n * truth, no per-type logic in this file. Skeletons come from\n * `renderSkeletonForType` so the placeholder height matches the loaded card\n * exactly (zero layout shift on resolve).\n *\n * One API call per content type via the shared list-URL builder\n * (`buildListUrl` — injectable; defaults to the lib's byte-parity-tested\n * builder prefixed with `apiBaseUrl`). Fetching uses `useSelfFetch` (plain\n * fetch, NO react-query) so third-party embedders need no QueryClientProvider;\n * cards are imported via DEEP module paths (not the chat barrel) so this\n * chunk never reaches `@tanstack/react-query`.\n *\n * LOCKSTEP NOTE: this file's per-type card/skeleton dispatch is the SIZED\n * sibling of the chat-side `CHAT_CARD_REGISTRY` (`../chat/entity-cards/\n * dispatch.tsx`), which renders compact `size='sm'` cards wired to the chat\n * runtime. Two dispatchers by design — when registering a new fetch-mode\n * content type, add it BOTH there and here (cards + skeleton + list URL).\n */\n\nimport React, { useMemo } from 'react';\nimport {\n  CONTENT_REF_GROUPS,\n  getContentRefLabelOrTitleCase,\n  orderContentRefTypes,\n  type ContentRefGroupConfig,\n} from '../../utils/content-ref-groups';\nimport type { ContentRef, ContentRefWithReason } from '../../types/content-ref';\nimport { useSelfFetch } from '../../hooks/use-self-fetch';\nimport { extractItems, extractItemId } from '../../utils/extract-items';\nimport { buildListUrl as libBuildListUrl, canonicalContentRefType } from '../../utils/list-url';\nimport { buildSuggestionUrl } from '../../utils/suggestion-url';\nimport { decideNewTab } from '../chat/utils/decide-new-tab';\n// DEEP card imports — NOT the `../chat` barrel (the barrel statically reaches\n// @tanstack/react-query via embeddable-chat + its hooks). Deep paths keep this\n// component's SOURCE graph react-query-free. Note: tsup's shared-chunk\n// splitting may still colocate the cards with chat hooks in one dist chunk\n// (react-query is a required peerDep, so resolution always succeeds) — the\n// guarantee that matters here is the RUNTIME one: nothing on this path ever\n// instantiates a QueryClient, so embedders need NO QueryClientProvider.\nimport { BlogCard, BlogCardSkeleton } from '../chat/entity-cards/blog-card';\nimport { CaseStudyCard, CaseStudyCardSkeleton } from '../chat/entity-cards/case-study-card';\nimport { CustomerInterviewCard, CustomerInterviewCardSkeleton } from '../chat/entity-cards/customer-interview-card';\nimport { ProductReleaseCard, ProductReleaseCardSkeleton } from '../chat/entity-cards/product-release-card';\nimport { buildProductReleaseCardProps } from '../chat/entity-cards/product-release-card-defaults';\nimport { ProgramCard, ProgramCardSkeleton } from '../chat/entity-cards/program-card';\nimport { InvestorUpdateCard, InvestorUpdateCardSkeleton } from '../chat/entity-cards/investor-update-card';\nimport { OnboardingGuideCard, OnboardingGuideCardSkeleton } from '../chat/entity-cards/onboarding-guide-card';\nimport { RoadmapCard, RoadmapCardSkeleton } from '../chat/entity-cards/roadmap-card';\n// Type-only — erased at build, no runtime dependency on the dispatch module.\nimport type { ChatCardDispatchExtras } from '../chat/entity-cards/dispatch';\n\ntype CardSize = 'lg' | 'default' | 'sm';\n\n/** Anchor prop bundle the per-card link surface receives — same shape the\n *  hub's `useNavLink` returns and the chat dispatcher's anchor builders\n *  produce. `null` = non-anchor mode (no URL). */\nexport interface CardLinkAnchorProps {\n  href: string;\n  target?: '_blank';\n  rel?: 'noopener noreferrer';\n  onClick?: (e: React.MouseEvent<HTMLAnchorElement>) => void;\n}\n\n/** Render-prop component injection for the navigation decision — keeps hook\n *  calls legal (hooks live INSIDE the injected component; `CardForType`\n *  itself calls zero hooks). The hub injects a `useNavLink`-backed provider;\n *  the default is hook-free (pure `decideNewTab`). MUST be defined at module\n *  scope by hosts — an inline arrow would remount every card each render. */\nexport interface CardLinkProviderProps {\n  href: string | null;\n  targetPlatform: string | null;\n  children: (linkProps: CardLinkAnchorProps | null) => React.ReactElement | null;\n}\nexport type CardLinkProvider = React.ComponentType<CardLinkProviderProps>;\n\n/** Default link provider for standalone embeds: relative/-same-origin hrefs\n *  stay same-tab, cross-origin pops a new tab (pure `decideNewTab` with no\n *  platform context — `currentSource: ''` falls through to the origin\n *  check). No router integration, no hooks. */\nfunction DefaultLinkPropsProvider({ href, targetPlatform, children }: CardLinkProviderProps): React.ReactElement | null {\n  if (!href) return children(null);\n  const newTab = decideNewTab({ href, targetPlatform, currentSource: '' });\n  return children(\n    newTab\n      ? { href, target: '_blank', rel: 'noopener noreferrer' }\n      : { href },\n  );\n}\n\n/** Default href resolution: trust the ref's stored url/targetPlatform as the\n *  API composed them. The hub overrides this with its `buildContentURL`\n *  re-composition so dev gets localhost and prod gets platform domains. */\nfunction defaultResolveHref(ref: ContentRef): { href: string | null; targetPlatform: string | null } {\n  return { href: ref.url || null, targetPlatform: ref.targetPlatform ?? null };\n}\n\n/** Host-injected renderer pair for the admin-only `marketing_campaign` type.\n *  Absent (every non-hub embed) → the type renders nothing (its list URL\n *  hits `/api/admin`, unreachable outside the hub anyway). */\nexport interface AdminCampaignCardSlot {\n  Card: React.ComponentType<{ campaign: any }>;\n  Skeleton: React.ComponentType<{ size?: 'default' | 'sm' }>;\n}\n\n/**\n * Per-type skeleton dispatch — returns the SAME colocated skeleton the\n * resolved card renders, sized to match (zero layout shift on resolve).\n * The chat-side `CHAT_CARD_REGISTRY` already does this via\n * `entry.skeleton()`; this surface exposes the same discipline to the\n * related-content rail.\n */\nfunction renderSkeletonForType(\n  type: string,\n  size: CardSize,\n  adminCampaignCard?: AdminCampaignCardSlot,\n): React.ReactNode {\n  // Most card skeletons accept only `{default, sm}`. `'lg'` collapses to\n  // `'default'`. ProductReleaseCardSkeleton uses lg/sm pair.\n  const legacySize: 'default' | 'sm' = size === 'sm' ? 'sm' : 'default';\n  switch (type) {\n    case 'blog_post_existing':\n      return <BlogCardSkeleton size={legacySize} />;\n    case 'case_study':\n      return <CaseStudyCardSkeleton size={legacySize} />;\n    case 'customer_interview':\n      return <CustomerInterviewCardSkeleton size={legacySize} />;\n    case 'product_release':\n      return <ProductReleaseCardSkeleton size={size === 'sm' ? 'sm' : 'lg'} />;\n    case 'podcast':\n    case 'webinar':\n    case 'event':\n      return <ProgramCardSkeleton size={legacySize} />;\n    case 'investor_update':\n      return <InvestorUpdateCardSkeleton size={legacySize} />;\n    case 'onboarding_guide':\n      // The rich catalog variant (hero + author grid, clamped description) —\n      // the step-numbered 'default' variant is for the guide detail page's\n      // \"More in section\" rail, not this full-width row.\n      return <OnboardingGuideCardSkeleton size={size === 'sm' ? 'sm' : 'catalog'} />;\n    case 'marketing_campaign':\n      return adminCampaignCard ? <adminCampaignCard.Skeleton size={legacySize} /> : null;\n    case 'roadmap_item':\n    case 'delivery_item':\n    case 'internal_task':\n      return <RoadmapCardSkeleton size={legacySize} />;\n    default:\n      return null;\n  }\n}\n\n/**\n * Per-type card dispatch — renders the right card with the right size.\n * Sized cards (`'lg'` / `'default'`) are unique to this rail — the chat\n * dispatcher only renders `'sm'`, so we go directly through the per-type\n * cards here.\n *\n * PURE FUNCTION COMPONENT WITH ZERO HOOK CALLS: the placeholder comes from a\n * plain `extras.buildOgPlaceholderUrl` call (the chat `dispatch.tsx`\n * pattern) and the anchor-prop bundle arrives via the `LinkProvider`\n * render-prop from the parent — so per-card hook legality is owned by the\n * injected provider component, not by this switch.\n *\n * `href` comes from the host's `resolveHref(ref)` (hub: live\n * `buildContentURL` recomposition; default: the ref's stored url).\n */\nfunction CardForType({\n  type,\n  item,\n  size,\n  href,\n  targetPlatform,\n  linkProps,\n  extras,\n  adminCampaignCard,\n}: {\n  type: string;\n  item: any;\n  size: CardSize;\n  href: string;\n  targetPlatform: string | null;\n  linkProps: CardLinkAnchorProps | null;\n  extras?: ChatCardDispatchExtras;\n  adminCampaignCard?: AdminCampaignCardSlot;\n}): React.ReactNode {\n  // Most card variants accept only `{default, sm}`. `'lg'` collapses to\n  // `'default'` for those. ProductReleaseCard uses its own lg/sm pair.\n  const legacySize: 'default' | 'sm' = size === 'sm' ? 'sm' : 'default';\n  // OG placeholder URL — injected into the pure-presentation cards so they\n  // render a branded fallback when the row's featured image is null. Plain\n  // function call (NOT a hook). Title is the universal field across all card\n  // item shapes used here.\n  const placeholderUrl =\n    extras?.buildOgPlaceholderUrl?.((item?.title as string | undefined) ?? '') ?? undefined;\n\n  // Top-level target/rel for cards that take them as separate props\n  // (BlogCard, CaseStudyCard, …). ProductReleaseCard takes the bundle as a\n  // single `anchorProps={...}` and uses `linkProps` directly. When the host\n  // didn't surface a URL, `linkProps` is null and the card stays in\n  // non-anchor mode.\n  const anchorAttrs: Pick<CardLinkAnchorProps, 'target' | 'rel'> = linkProps\n    ? { target: linkProps.target, rel: linkProps.rel }\n    : {};\n\n  switch (type) {\n    case 'blog_post_existing':\n      return <BlogCard post={item} size={legacySize} href={href} targetPlatform={targetPlatform} placeholderUrl={placeholderUrl} {...anchorAttrs} />;\n    case 'case_study':\n      return <CaseStudyCard study={item} size={legacySize} href={href} targetPlatform={targetPlatform} placeholderUrl={placeholderUrl} {...anchorAttrs} />;\n    case 'customer_interview':\n      return <CustomerInterviewCard interview={item} size={legacySize} href={href} targetPlatform={targetPlatform} placeholderUrl={placeholderUrl} {...anchorAttrs} />;\n    case 'product_release': {\n      // Anchor-prop pattern: build product-release lg-variant props from the\n      // shared `buildProductReleaseCardProps` so this rail and the /releases\n      // catalog page render byte-identically. The card wraps in\n      // `<a {...anchorProps}>` ONLY when `anchorProps.href` is set — pass\n      // `undefined` (not an empty object) when href is empty so the card\n      // stays in non-anchor mode without rendering a dead <a> tag.\n      const releaseSize = size === 'sm' ? 'sm' : 'lg';\n      const buildReleaseProps = extras?.buildProductReleaseCardProps ?? buildProductReleaseCardProps;\n      const releaseProps = buildReleaseProps(item);\n      return (\n        <ProductReleaseCard\n          size={releaseSize}\n          title={item.title}\n          summary={item.summary}\n          version={item.version}\n          {...releaseProps}\n          anchorProps={linkProps ?? undefined}\n        />\n      );\n    }\n    case 'podcast':\n      return extras?.programConfigs?.podcast\n        ? <ProgramCard config={extras.programConfigs.podcast} item={item} size={legacySize} href={href} targetPlatform={targetPlatform} placeholderUrl={placeholderUrl} {...anchorAttrs} />\n        : null;\n    case 'webinar':\n      return extras?.programConfigs?.webinar\n        ? <ProgramCard config={extras.programConfigs.webinar} item={item} size={legacySize} href={href} targetPlatform={targetPlatform} placeholderUrl={placeholderUrl} {...anchorAttrs} />\n        : null;\n    case 'event':\n      return extras?.programConfigs?.event\n        ? <ProgramCard config={extras.programConfigs.event} item={item} size={legacySize} href={href} targetPlatform={targetPlatform} placeholderUrl={placeholderUrl} {...anchorAttrs} />\n        : null;\n    case 'investor_update':\n      return <InvestorUpdateCard update={item} size={legacySize} href={href} targetPlatform={targetPlatform} placeholderUrl={placeholderUrl} {...anchorAttrs} />;\n    case 'onboarding_guide':\n      // Catalog variant (see skeleton note) — full-width rich card with a\n      // line-clamped description instead of the step-numbered rail card.\n      return <OnboardingGuideCard guide={item} size={size === 'sm' ? 'sm' : 'catalog'} href={href} targetPlatform={targetPlatform} placeholderUrl={placeholderUrl} {...anchorAttrs} />;\n    case 'marketing_campaign':\n      return adminCampaignCard ? <adminCampaignCard.Card campaign={item} /> : null;\n    case 'roadmap_item':\n    case 'delivery_item':\n    case 'internal_task':\n      return (\n        <RoadmapCard\n          item={item}\n          href={href ?? ''}\n          targetPlatform={targetPlatform}\n          userVote={null}\n          onVote={() => {}}\n          size={legacySize}\n          cardType={type as 'roadmap_item' | 'delivery_item' | 'internal_task'}\n          {...anchorAttrs}\n        />\n      );\n    default:\n      return null;\n  }\n}\n\n// =============================================================================\n// Fetch all items for a type in ONE server-sorted call, via the injectable\n// list-URL builder. `useSelfFetch` (URL = cache key) replaces the hub's old\n// react-query usage: `enabled` ≙ `url === null`, `!res.ok`/network error ≙\n// `error → items null → group renders nothing`. Accepted deltas vs\n// react-query: no retry/backoff, no focus refetch, no cross-mount cache.\n// =============================================================================\n\nfunction useGroupItems(\n  type: string,\n  refs: ContentRef[],\n  buildUrl: (type: string, ids: string[]) => string | null,\n) {\n  const ids = refs.map((r) => r.id);\n  const url = ids.length > 0 ? buildUrl(type, ids) : null;\n  const { data, isLoading } = useSelfFetch<unknown>(url);\n  const items = data != null ? extractItems(data) : null;\n  return { items, isLoading };\n}\n\n// =============================================================================\n// Per-group renderer — one API call, server-sorted, then render cards via the\n// dispatcher with per-type skeletons + per-type layout from CONTENT_REF_GROUPS.\n// =============================================================================\n\n/** Map columns prop → tailwind grid class. Only consulted for grid-layout\n *  groups; list-layout groups stack vertically. */\nfunction gridClassFor(columns: 2 | 3): string {\n  return columns === 3\n    ? 'grid grid-cols-1 sm:grid-cols-2 lg:grid-cols-3 gap-6'\n    : 'grid grid-cols-1 sm:grid-cols-2 gap-6';\n}\n\n/** Resolve the group config for a type, falling back to a grid layout with\n *  the default card size for unregistered types so the section still renders\n *  rather than silently dropping them. The `label` field on the fallback is\n *  intentionally a placeholder — the section heading goes through\n *  `getContentRefLabelOrTitleCase(type)` instead so cross-surface labels\n *  stay consistent between this rail and the investor-email builder. */\nfunction resolveGroupConfig(type: string): ContentRefGroupConfig {\n  return CONTENT_REF_GROUPS[type] ?? {\n    label: type,\n    order: 999,\n    layout: 'grid',\n    gridSize: 'default',\n  };\n}\n\nfunction ContentGroup({\n  type,\n  refs,\n  columns,\n  buildUrl,\n  resolveHref,\n  LinkProvider,\n  extras,\n  adminCampaignCard,\n  heading,\n}: {\n  type: string;\n  refs: ContentRef[];\n  columns: 2 | 3;\n  buildUrl: (type: string, ids: string[]) => string | null;\n  resolveHref: (ref: ContentRef) => { href: string | null; targetPlatform: string | null };\n  LinkProvider: CardLinkProvider;\n  extras?: ChatCardDispatchExtras;\n  adminCampaignCard?: AdminCampaignCardSlot;\n  /** Group heading, rendered INSIDE the group so a group that resolves to\n   *  nothing (fetch miss / unsupported type / missing program config) drops\n   *  its heading too — no orphaned titles. */\n  heading: React.ReactNode;\n}) {\n  const { items, isLoading } = useGroupItems(type, refs, buildUrl);\n  const config = resolveGroupConfig(type);\n  const isListLayout = config.layout === 'list';\n  const cardSize = config.gridSize;\n\n  // Skeleton gate: `isLoading && !items` — SSR HTML and the client's first\n  // paint render identical skeletons (useSelfFetch starts isLoading=true on\n  // both sides), and once items exist they are never replaced by skeletons.\n  if (isLoading && !items) {\n    const skeletons = refs.map((r) => (\n      <div key={r.id}>{renderSkeletonForType(type, cardSize, adminCampaignCard)}</div>\n    ));\n    return (\n      <div className=\"space-y-4\">\n        {heading}\n        {isListLayout ? (\n          <div className=\"space-y-4\">{skeletons}</div>\n        ) : (\n          <div className={gridClassFor(columns)}>{skeletons}</div>\n        )}\n      </div>\n    );\n  }\n\n  if (!items || items.length === 0) return null;\n\n  // Index fetched rows by id, then render in REF order — refs carry the\n  // intended sequence (suggestion mode: the engine's tier order, so\n  // same-platform/tag-matched items lead; controlled mode: the curated\n  // display_order). The list APIs return rows date-sorted, which would\n  // otherwise scramble that ordering (same-platform items sinking below\n  // newer cross-platform ones).\n  // Shared extractor (NOT raw `.id`) — some API shapes key items differently\n  // (e.g. external_id types); raw access would silently drop valid items.\n  const itemById = new Map(\n    (items as any[]).map((it) => [extractItemId(type, it) ?? String((it as any)?.id), it]),\n  );\n\n  const cards = refs\n    .map((contentRef) => {\n      const itemId = String(contentRef.id);\n      const item = itemById.get(itemId);\n      if (!item) return null;\n      // Re-compose the URL via the host's resolver (hub: buildContentURL so\n      // dev gets localhost and prod the right platform domain; default: the\n      // ref's stored url as the API composed it).\n      const resolved = resolveHref(contentRef);\n      const href = resolved.href ?? '';\n      const targetPlatform = resolved.targetPlatform ?? contentRef.targetPlatform ?? null;\n      return (\n        <div key={itemId}>\n          <LinkProvider href={href || null} targetPlatform={targetPlatform}>\n            {(linkProps) => (\n              <CardForType\n                type={type}\n                item={item}\n                size={cardSize}\n                href={href}\n                targetPlatform={targetPlatform}\n                linkProps={linkProps}\n                extras={extras}\n                adminCampaignCard={adminCampaignCard}\n              />\n            )}\n          </LinkProvider>\n        </div>\n      );\n    })\n    .filter(Boolean);\n\n  if (cards.length === 0) return null;\n\n  return (\n    <div className=\"space-y-4\">\n      {heading}\n      {isListLayout ? (\n        <div className=\"space-y-4\">{cards}</div>\n      ) : (\n        <div className={gridClassFor(columns)}>{cards}</div>\n      )}\n    </div>\n  );\n}\n\n// =============================================================================\n// Main component\n// =============================================================================\n\ninterface RelatedContentResponse {\n  refs: ContentRefWithReason[];\n}\n\nexport interface RelatedContentSectionProps {\n  /** CONTROLLED mode (the original behavior). When defined — even `[]` — no\n   *  suggestion fetch runs and exactly these refs render. */\n  contentRefs?: ContentRef[];\n  /** SUGGESTION mode (with `entityId`): self-fetch suggestions for this host\n   *  entity from `{apiBaseUrl}/api/related-content`. Ignored when\n   *  `contentRefs` is provided. */\n  entityType?: string;\n  entityId?: number | string;\n  /** Maps to the suggestion API's `count` param — the PER-TYPE fill target\n   *  for every candidate type EXCEPT the host's own. Absent → param not sent\n   *  (server default applies). */\n  minResults?: number;\n  /** Maps to the suggestion API's `sameTypeCount` param — the budget for the\n   *  candidate type MATCHING the host's own `entityType` (same-type boost:\n   *  a blog post's rail leads with more blog posts). Absent → param not\n   *  sent (host's type uses the server's `count`). */\n  sameTypeMinResults?: number;\n  /** SSR hydrate for suggestion mode — the server page ran the engine and\n   *  drills the refs here; the first client fetch is skipped (useSelfFetch\n   *  initialData contract). */\n  initialItems?: ContentRefWithReason[];\n  /** Section title (default: \"Related Content\") */\n  title?: string;\n  /**\n   * Grid columns at desktop. 2 = denser cards / wider summary (original\n   * investor-update layout); 3 = more cards per row for dashboards.\n   * Only consulted for grid-layout groups. Default: 2.\n   */\n  columns?: 2 | 3;\n  /**\n   * ContentRef.type values to exclude. Honored in ALL modes — controlled\n   * mode post-filters (original behavior); suggestion mode ALSO forwards the\n   * list verbatim as the API's `excludeTypes=` param so excluded types never\n   * consume engine fill slots (`minResults` stays honored). The subtraction\n   * happens SERVER-side — this component never mirrors the hub's candidate\n   * list.\n   */\n  excludeTypes?: string[];\n  /**\n   * SUGGESTION-mode allow-list (rail vocabulary): which content types\n   * participate in this rail. Sent verbatim as the API's `types=` param —\n   * the SERVER intersects it with its own allowed candidate set, and\n   * platform policy gates (e.g. internal-only types) ALWAYS win: the client\n   * cannot request its way past them. Absent → all server-side candidates.\n   */\n  includeTypes?: string[];\n  /** Fetch-URL prefix for third-party embeds / reverse proxies\n   *  ('' = same-origin). Applied to BOTH the suggestion fetch and the\n   *  default per-group list fetches. */\n  apiBaseUrl?: string;\n  /** Host injection bundle — REUSES the chat dispatcher's\n   *  `ChatCardDispatchExtras` (programConfigs, buildOgPlaceholderUrl,\n   *  buildProductReleaseCardProps override). Program groups render nothing\n   *  when their config is absent. */\n  extras?: ChatCardDispatchExtras;\n  /** Hub injects its `buildContentURL` recomposition; default uses the\n   *  ref's stored `url`/`targetPlatform` as the API composed them. */\n  resolveHref?: (ref: ContentRef) => { href: string | null; targetPlatform: string | null };\n  /** Hub injects its registry-driven entity-list-api builder; default = the\n   *  lib's `buildListUrl(type, ids, apiBaseUrl)`. */\n  buildListUrl?: (type: string, ids: string[]) => string | null;\n  /** Hub injects a `useNavLink`-backed render-prop provider; default = pure\n   *  anchor via `decideNewTab`. MUST be a module-scope component. */\n  LinkProvider?: CardLinkProvider;\n  /** Renderer pair for the admin-only `marketing_campaign` type. Absent →\n   *  the type renders nothing. */\n  adminCampaignCard?: AdminCampaignCardSlot;\n}\n\nexport function RelatedContentSection({\n  contentRefs,\n  entityType,\n  entityId,\n  minResults,\n  sameTypeMinResults,\n  includeTypes,\n  initialItems,\n  title = 'Related Content',\n  columns = 2,\n  excludeTypes,\n  apiBaseUrl = '',\n  extras,\n  resolveHref = defaultResolveHref,\n  buildListUrl,\n  LinkProvider = DefaultLinkPropsProvider,\n  adminCampaignCard,\n}: RelatedContentSectionProps) {\n  // ── Hooks above EVERY early return (the original `if (!contentRefs.length)\n  // return null` guard moved below them). ──\n\n  // Suggestion-mode fetch URL — null in controlled mode (contentRefs defined,\n  // even []) or when the entity scope is incomplete.\n  // `includeTypes: []` is an explicit \"nothing participates\" — skip the fetch\n  // entirely (an empty-string `types=` param would be dropped by the URL\n  // builder and read server-side as \"all candidates\") AND ignore SSR refs.\n  const suggestionsDisabled = includeTypes?.length === 0;\n  const suggestUrl =\n    contentRefs === undefined &&\n    entityType &&\n    entityId !== undefined &&\n    entityId !== null &&\n    entityId !== '' &&\n    !suggestionsDisabled\n      ? buildSuggestionUrl('/api/related-content', {\n          apiBaseUrl,\n          entityType,\n          entityId,\n          count: minResults,\n          extraParams: {\n            sameTypeCount: sameTypeMinResults !== undefined ? String(sameTypeMinResults) : undefined,\n            types: includeTypes !== undefined ? includeTypes.join(',') : undefined,\n            excludeTypes: excludeTypes && excludeTypes.length > 0 ? excludeTypes.join(',') : undefined,\n          },\n        })\n      : null;\n  // Memoize the initialData wrapper — useSelfFetch re-syncs on [initialData],\n  // and a fresh per-render object would loop setState under re-rendering\n  // parents (the latent FaqSection bug, fixed there in the same change).\n  const initialData = useMemo<RelatedContentResponse | undefined>(\n    // An explicitly disabled rail (includeTypes: []) must ignore SSR-hydrated\n    // refs too — otherwise useSelfFetch(null, {initialData}) keeps serving\n    // initialItems and the \"nothing participates\" contract silently breaks.\n    () => (!suggestionsDisabled && initialItems ? { refs: initialItems } : undefined),\n    [initialItems, suggestionsDisabled],\n  );\n  const { data } = useSelfFetch<RelatedContentResponse>(suggestUrl, { initialData });\n\n  // Default group fetcher: the lib's byte-parity-tested builder, prefixed for\n  // embeds. Memoized so group-fetch URLs stay value-stable across renders.\n  const effectiveBuildListUrl = useMemo(\n    () => buildListUrl ?? ((type: string, ids: string[]) => libBuildListUrl(type, ids, apiBaseUrl)),\n    [buildListUrl, apiBaseUrl],\n  );\n\n  const refs: ContentRef[] = contentRefs ?? data?.refs ?? [];\n\n  // Per-consumer type gating — drops refs whose `type` is in the exclude\n  // list. In suggestion mode the server already subtracted these (the param\n  // is forwarded above); the client filter stays as an idempotent guard and\n  // IS the mechanism in controlled mode (original behavior).\n  const exclude = new Set(excludeTypes || []);\n  const visibleRefs = exclude.size > 0 ? refs.filter((r) => !exclude.has(r.type)) : refs;\n  // Zero refs (still loading in suggestion mode, or genuinely empty) → no\n  // empty shell.\n  if (!visibleRefs.length) return null;\n\n  const grouped: Record<string, ContentRef[]> = {};\n  for (const ref of visibleRefs) {\n    if (!grouped[ref.type]) grouped[ref.type] = [];\n    grouped[ref.type].push(ref);\n  }\n\n  // Registered types in CONTENT_REF_GROUPS order, then any unregistered\n  // types appended (same shape the investor-email builder uses — both\n  // consume `orderContentRefTypes` so cross-surface ordering matches).\n  // SAME-TYPE FIRST: when a host entityType is known (suggestion / SSR\n  // modes), its own content-type group is hoisted to the top — a blog\n  // post's rail leads with blog posts. Rail group keys are compared via\n  // the shared alias canonicalizer (blog_post_existing ↔ blog_post).\n  let orderedTypes = orderContentRefTypes(Object.keys(grouped));\n  if (entityType) {\n    // Canonicalize BOTH sides — hosts pass registry vocab ('blog_post') but\n    // rail-vocab aliases ('blog_post_existing') are also legal inputs; a raw\n    // comparison would silently lose the same-type-first hoist for aliases.\n    const canonicalEntityType = canonicalContentRefType(entityType);\n    const sameType = orderedTypes.filter((t) => canonicalContentRefType(t) === canonicalEntityType);\n    if (sameType.length > 0) {\n      orderedTypes = [...sameType, ...orderedTypes.filter((t) => canonicalContentRefType(t) !== canonicalEntityType)];\n    }\n  }\n\n  return (\n    <div className=\"space-y-8\">\n      <h2 className=\"text-2xl font-bold text-ods-text-primary\">{title}</h2>\n      {orderedTypes.map((type) => (\n        <ContentGroup\n          key={type}\n          type={type}\n          refs={grouped[type]}\n          columns={columns}\n          buildUrl={effectiveBuildListUrl}\n          resolveHref={resolveHref}\n          LinkProvider={LinkProvider}\n          extras={extras}\n          adminCampaignCard={adminCampaignCard}\n          heading={\n            <h3 className=\"font-['Azeret_Mono'] text-[14px] font-semibold uppercase text-ods-text-secondary tracking-wider\">\n              {getContentRefLabelOrTitleCase(type)}\n            </h3>\n          }\n        />\n      ))}\n    </div>\n  );\n}\n"],"mappings":"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","names":["buildListUrl"]}

package/dist/{chunk-PCXI7ZB2.js → chunk-D2BC3NZ2.js}

@@ -2924,12 +2924,15 @@ var ChatMessageList = forwardRef12(
     onLoadMoreRef.current = onLoadMore;
     const isFetchingRef = useRef3(isFetchingNextPage);
     isFetchingRef.current = isFetchingNextPage;
+    const dialogIdRef = useRef3(dialogId);
+    dialogIdRef.current = dialogId;
     const prevRenderRef = useRef3({ dialogId: void 0, messageCount: 0, lastMessageId: void 0 });
-    const prependRef = useRef3({ firstMessageId: void 0, firstMessageContent: void 0, scrollHeight: 0 });
+    const loadOlderAnchorRef = useRef3(null);
     useEffect3(() => {
       if (!autoScroll) return;
       const dialogChanged = dialogId !== prevRenderRef.current.dialogId;
       const prevCount = prevRenderRef.current.messageCount;
+      const prevLastId = prevRenderRef.current.lastMessageId;
       const newCount = messages.length;
       const currentLastId = messages[messages.length - 1]?.id;
       prevRenderRef.current = { dialogId, messageCount: newCount, lastMessageId: currentLastId };
@@ -2942,7 +2945,8 @@ var ChatMessageList = forwardRef12(
         return;
       }
       if (newCount > prevCount) {
-        const newSlice = messages.slice(prevCount);
+        const prevLastIdx = prevLastId ? messages.findIndex((m) => m.id === prevLastId) : -1;
+        const newSlice = prevLastIdx >= 0 ? messages.slice(prevLastIdx + 1) : messages.slice(prevCount);
         const hasNewUser = newSlice.some((m) => m.role === "user");
         if (hasNewUser) {
           void scrollToBottom({ animation: "instant", ignoreEscapes: true });
@@ -2966,34 +2970,17 @@ var ChatMessageList = forwardRef12(
     }, [autoScroll, messages, dialogId, scrollToBottom, contentRef]);
     useLayoutEffect2(() => {
       const el = scrollRef.current;
-      if (!el) {
-        prependRef.current = { firstMessageId: void 0, firstMessageContent: void 0, scrollHeight: 0 };
+      const anchor = loadOlderAnchorRef.current;
+      if (!el || !anchor) return;
+      if (anchor.dialogId !== dialogId) {
+        loadOlderAnchorRef.current = null;
         return;
       }
-      const currentFirstId = messages[0]?.id;
-      const currentFirstContent = messages[0]?.content;
-      const prevFirstId = prependRef.current.firstMessageId;
-      const prevHeight = prependRef.current.scrollHeight;
-      if (currentFirstId !== prevFirstId) {
-        if (prevFirstId && prevHeight > 0) {
-          const prevIdx = messages.findIndex((m) => m.id === prevFirstId);
-          if (prevIdx > 0) {
-            const addedHeight = el.scrollHeight - prevHeight;
-            if (addedHeight > 0) el.scrollTop += addedHeight;
-          }
-        }
-        prependRef.current = {
-          firstMessageId: currentFirstId,
-          firstMessageContent: currentFirstContent,
-          scrollHeight: el.scrollHeight
-        };
-        return;
-      }
-      prependRef.current.scrollHeight = el.scrollHeight;
-      if (currentFirstContent !== prependRef.current.firstMessageContent) {
-        prependRef.current.firstMessageContent = currentFirstContent;
-      }
-    }, [messages, scrollRef]);
+      const addedHeight = el.scrollHeight - anchor.scrollHeight;
+      if (addedHeight <= 0) return;
+      loadOlderAnchorRef.current = null;
+      el.scrollTop = anchor.scrollTop + addedHeight;
+    }, [messages, dialogId, scrollRef]);
     const messageElsRef = useRef3(/* @__PURE__ */ new Map());
     const refCallbacksRef = useRef3(/* @__PURE__ */ new Map());
     const getRegisterMessageEl = (id) => {
@@ -3065,6 +3052,14 @@ var ChatMessageList = forwardRef12(
           const entry = entries[0];
           if (!entry) return;
           if (entry.isIntersecting && !isFetchingRef.current) {
+            const el = scrollRef.current;
+            if (el) {
+              loadOlderAnchorRef.current = {
+                dialogId: dialogIdRef.current,
+                scrollHeight: el.scrollHeight,
+                scrollTop: el.scrollTop
+              };
+            }
             onLoadMoreRef.current?.();
           }
         },
@@ -3072,7 +3067,7 @@ var ChatMessageList = forwardRef12(
       );
       observer.observe(sentinelElement);
       return () => observer.disconnect();
-    }, [hasNextPage, scrollRef]);
+    }, [hasNextPage, isFetchingNextPage, scrollRef]);
     useImperativeHandle2(ref, () => scrollRef.current, [scrollRef]);
     if (isLoading) {
       return /* @__PURE__ */ jsx22(
@@ -20247,6 +20242,7 @@ var CategorySection = ({
           /* @__PURE__ */ jsx175(
             Button,
             {
+              type: "button",
               variant: "transparent",
               onClick: (e) => {
                 e.stopPropagation();
@@ -37808,6 +37804,110 @@ function extractIncompleteMessageState(lastMessage) {
   };
 }
 
+// src/components/chat/utils/history-merge.ts
+var SYNTHETIC_REALTIME_ID_PREFIXES = ["assistant-", "user-", "error-"];
+function isSyntheticRealtimeId(id) {
+  return SYNTHETIC_REALTIME_ID_PREFIXES.some((prefix) => id.startsWith(prefix));
+}
+function flattenMessagePagesChronological(pages) {
+  if (!pages) return [];
+  return [...pages].reverse().flatMap((page) => [...page.messages].reverse());
+}
+function maxPersistedStreamSeq(pages) {
+  let max = 0;
+  if (!pages) return max;
+  for (const page of pages) {
+    for (const msg of page.messages) {
+      const seq = msg.lastChunkStreamSeq;
+      if (typeof seq === "number" && seq > max) max = seq;
+    }
+  }
+  return max;
+}
+function mergeHistoryWithRealtime(input) {
+  const {
+    processedHistory,
+    rawHistoryIds,
+    existingMessages,
+    streamingMessageId,
+    historyFetchedAt,
+    historyMaxStreamSeq = 0,
+    realtimeSeenStreamSeq = 0
+  } = input;
+  if (processedHistory.length === 0) return existingMessages;
+  const processedIds = new Set(processedHistory.map((m) => m.id));
+  const seqCoverageKnown = realtimeSeenStreamSeq > 0 && historyMaxStreamSeq > 0;
+  const historyCoversRealtime = seqCoverageKnown ? historyMaxStreamSeq >= realtimeSeenStreamSeq : null;
+  const trailing = processedHistory[processedHistory.length - 1];
+  const historyTrailingAssistant = trailing?.role === "assistant" ? trailing : null;
+  const historyBatchId = historyTrailingAssistant && Array.isArray(historyTrailingAssistant.content) ? historyTrailingAssistant.content.find((s) => s.type === "approval_batch")?.data?.approvalRequestId ?? null : null;
+  let processedToUse = processedHistory;
+  const pinnedSyntheticIds = /* @__PURE__ */ new Set();
+  const droppedSyntheticIds = /* @__PURE__ */ new Set();
+  if (historyBatchId) {
+    const batchTwins = existingMessages.filter(
+      (m) => m.role === "assistant" && Array.isArray(m.content) && m.content.some(
+        (s) => s.type === "approval_batch" && s.data?.approvalRequestId === historyBatchId
+      )
+    );
+    const existingWithSameBatch = batchTwins.find((m) => m.id === streamingMessageId) ?? batchTwins[batchTwins.length - 1];
+    if (existingWithSameBatch && Array.isArray(existingWithSameBatch.content)) {
+      const histSize = Array.isArray(historyTrailingAssistant?.content) ? historyTrailingAssistant.content.length : 0;
+      const realtimeSize = existingWithSameBatch.content.length;
+      if (existingWithSameBatch.id === streamingMessageId || realtimeSize > histSize) {
+        processedToUse = processedHistory.slice(0, -1);
+        pinnedSyntheticIds.add(existingWithSameBatch.id);
+      } else {
+        droppedSyntheticIds.add(existingWithSameBatch.id);
+      }
+    }
+  }
+  const realtimeMessages = existingMessages.filter((m) => {
+    if (pinnedSyntheticIds.has(m.id)) return true;
+    if (droppedSyntheticIds.has(m.id)) return false;
+    if (processedIds.has(m.id)) return false;
+    if (rawHistoryIds?.has(m.id)) return false;
+    if (m.role === "user" && m.id.startsWith("optimistic-") && typeof m.content === "string") {
+      const canBeInSnapshot = (m.timestamp?.getTime() ?? 0) <= historyFetchedAt;
+      return !(canBeInSnapshot && processedToUse.some((pm) => pm.role === "user" && pm.content === m.content));
+    }
+    if (isSyntheticRealtimeId(m.id) && m.id !== streamingMessageId) {
+      const covered = historyCoversRealtime !== null ? historyCoversRealtime : (m.timestamp?.getTime() ?? 0) <= historyFetchedAt;
+      if (covered) return false;
+    }
+    return true;
+  });
+  return [...processedToUse, ...realtimeMessages];
+}
+function computeHistoryPrepend(processedHistory, existingMessages) {
+  const existingIds = new Set(existingMessages.map((m) => m.id));
+  const newMessages = [];
+  let boundaryMessageIndex = -1;
+  for (let i = 0; i < processedHistory.length; i++) {
+    if (existingIds.has(processedHistory[i].id)) {
+      boundaryMessageIndex = i;
+      break;
+    }
+    newMessages.push(processedHistory[i]);
+  }
+  let boundaryMessageId;
+  let boundaryUpdates;
+  if (boundaryMessageIndex >= 0) {
+    const boundaryMessage = processedHistory[boundaryMessageIndex];
+    const existingBoundary = existingMessages.find((m) => m.id === boundaryMessage.id);
+    if (existingBoundary) {
+      const existingContent = JSON.stringify(existingBoundary.content);
+      const newContent = JSON.stringify(boundaryMessage.content);
+      if (existingContent !== newContent) {
+        boundaryMessageId = boundaryMessage.id;
+        boundaryUpdates = { content: boundaryMessage.content };
+      }
+    }
+  }
+  if (newMessages.length === 0 && !boundaryUpdates) return null;
+  return { newMessages, boundaryMessageId, boundaryUpdates };
+}
+
 // src/components/chat/utils/chip-action-class.ts
 var CHIP_ACTION_BUTTON_CLASS = "text-[11px] font-medium text-ods-text-secondary hover:text-ods-text-primary bg-transparent hover:bg-ods-card-hover border border-ods-border rounded-md px-2 py-1 transition-colors focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ods-focus";
 
@@ -39283,6 +39383,11 @@ export {
   useNatsChatAdapter,
   useUnifiedChat,
   extractIncompleteMessageState,
+  SYNTHETIC_REALTIME_ID_PREFIXES,
+  flattenMessagePagesChronological,
+  maxPersistedStreamSeq,
+  mergeHistoryWithRealtime,
+  computeHistoryPrepend,
   CHIP_ACTION_BUTTON_CLASS,
   chatChipClass,
   clickupTaskUrl,
@@ -39610,4 +39715,4 @@ export {
   LogsList,
   assets
 };
-//# sourceMappingURL=chunk-PCXI7ZB2.js.map
+//# sourceMappingURL=chunk-D2BC3NZ2.js.map