@flamingo-stack/openframe-frontend-core 0.0.244 → 0.0.245

package/dist/utils/list-url.d.ts

@@ -27,6 +27,12 @@
  * Pure + server-safe (no React, no browser APIs) so the hub's server-side
  * mappers can import it from `@flamingo-stack/openframe-frontend-core/utils`.
  */
+/** Resolve a ContentRef rail-vocab type to its canonical `documentType`
+ *  (registry vocabulary) — `blog_post_existing` → `blog_post`, everything
+ *  else passes through. Exported so consumers comparing rail group keys to
+ *  registry entityTypes (e.g. the related-content rail's same-type-first
+ *  ordering) share THIS alias map instead of re-declaring it. */
+export declare function canonicalContentRefType(contentRefType: string): string;
 /**
  * Build a list-API URL that returns full rows for the given ids, or `null`
  * when the type has no list endpoint (the caller skips fetching rather than

package/dist/utils/list-url.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"list-url.d.ts","sourceRoot":"","sources":["../../src/utils/list-url.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAqCH;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,YAAY,CAAC,cAAc,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,EAAE,IAAI,SAAK,GAAG,MAAM,GAAG,IAAI,CAa5F"}
+{"version":3,"file":"list-url.d.ts","sourceRoot":"","sources":["../../src/utils/list-url.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAWH;;;;iEAIiE;AACjE,wBAAgB,uBAAuB,CAAC,cAAc,EAAE,MAAM,GAAG,MAAM,CAEtE;AA4BD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,YAAY,CAAC,cAAc,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,EAAE,IAAI,SAAK,GAAG,MAAM,GAAG,IAAI,CAa5F"}

package/dist/utils/suggestion-url.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Shared fetch-URL composer for the two suggestion sections (FaqSection +
+ * RelatedContentSection) — ONE owner of the entityType/entityId/count query
+ * shape so the sections can never drift. Pure + server-safe.
+ *
+ * Byte-parity contract with the original `buildFaqsUrl`: when only
+ * entityType/entityId are set, the param order is `entityType`, `entityId`;
+ * with nothing set, the bare `path` is returned (no `?`).
+ */
+export interface SuggestionUrlOptions {
+    /** Fetch-URL prefix for third-party embeds / reverse proxies
+     *  ('' = same-origin relative). */
+    apiBaseUrl?: string;
+    /** Both required together for entity scope; partial → bare path. */
+    entityType?: string;
+    entityId?: number | string;
+    /** Maps to the server's `count` param. Undefined → param not sent
+     *  (server default applies). */
+    count?: number;
+    /** Extra query params appended after the shared trio (e.g. the
+     *  related-content `excludeTypes` deny-list). Empty/undefined values
+     *  are skipped. */
+    extraParams?: Record<string, string | undefined>;
+}
+export declare function buildSuggestionUrl(path: string, opts?: SuggestionUrlOptions): string;
+//# sourceMappingURL=suggestion-url.d.ts.map

package/dist/utils/suggestion-url.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"suggestion-url.d.ts","sourceRoot":"","sources":["../../src/utils/suggestion-url.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,MAAM,WAAW,oBAAoB;IACnC;uCACmC;IACnC,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,oEAAoE;IACpE,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;IAC1B;oCACgC;IAChC,KAAK,CAAC,EAAE,MAAM,CAAA;IACd;;uBAEmB;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAA;CACjD;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,GAAE,oBAAyB,GAAG,MAAM,CAaxF"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@flamingo-stack/openframe-frontend-core",
-  "version": "0.0.244",
+  "version": "0.0.245",
   "description": "Shared design system and components for all Flamingo platforms",
   "type": "module",
   "main": "./dist/index.js",
@@ -60,6 +60,12 @@
       "require": "./dist/components/faq/index.cjs",
       "default": "./dist/components/faq/index.js"
     },
+    "./components/related-content": {
+      "types": "./dist/components/related-content/index.d.ts",
+      "import": "./dist/components/related-content/index.js",
+      "require": "./dist/components/related-content/index.cjs",
+      "default": "./dist/components/related-content/index.js"
+    },
     "./components/faq/json-ld": {
       "types": "./dist/components/faq/json-ld.d.ts",
       "import": "./dist/components/faq/json-ld.js",

package/src/components/chat/chat-message-list.tsx

@@ -130,11 +130,6 @@ const ChatMessageList = forwardRef<HTMLDivElement, ChatMessageListProps>(
     onLoadMoreRef.current = onLoadMore
     const isFetchingRef = useRef(isFetchingNextPage)
     isFetchingRef.current = isFetchingNextPage
-    // Fresh dialogId for the IntersectionObserver callback (its effect must
-    // not depend on `dialogId` or it would re-create on every dialog switch
-    // mid-stream; the ref keeps the snapshot's dialog tag current).
-    const dialogIdRef = useRef(dialogId)
-    dialogIdRef.current = dialogId
 
     // Tracks previous render state for explicit "force-stick" decisions
     // (dialog change, first message, new user message). The library
@@ -145,19 +140,15 @@ const ChatMessageList = forwardRef<HTMLDivElement, ChatMessageListProps>(
       lastMessageId: string | undefined
     }>({ dialogId: undefined, messageCount: 0, lastMessageId: undefined })
 
-    // Geometry snapshot captured the instant the top sentinel triggers
-    // onLoadMore (BEFORE the older page lands), applied once when the taller
-    // content commits. Keyed on the LOAD LIFECYCLE, not `messages[0].id`: the
-    // history processor groups consecutive assistant turns into one bubble
-    // keyed by the group's LAST id, so an older page that is all continuation
-    // of the first bubble grows that bubble in place WITHOUT changing its id.
-    // An id-based anchor misses that growth and leaves the reader pinned at
-    // the top (and the still-visible sentinel never re-fires).
-    const loadOlderAnchorRef = useRef<{
-      dialogId: string | undefined
+    // Snapshot of the first message id + scrollHeight observed BEFORE
+    // a load-older prepend, so we can preserve the user's viewport
+    // position when older messages stream in above their current
+    // reading position.
+    const prependRef = useRef<{
+      firstMessageId: string | undefined
+      firstMessageContent: unknown
       scrollHeight: number
-      scrollTop: number
-    } | null>(null)
+    }>({ firstMessageId: undefined, firstMessageContent: undefined, scrollHeight: 0 })
 
     // ---- Force-stick: dialog change / first-load / new user message --
     useEffect(() => {
@@ -165,7 +156,6 @@ const ChatMessageList = forwardRef<HTMLDivElement, ChatMessageListProps>(
 
       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 }
@@ -187,18 +177,7 @@ const ChatMessageList = forwardRef<HTMLDivElement, ChatMessageListProps>(
         // user message DID arrive). When the user just sent a
         // message, they expect their bubble pinned to the bottom,
         // regardless of where they were scrolled.
-        //
-        // The tail must be located via the previous LAST message id,
-        // not `slice(prevCount)`: when load-older PREPENDS a page,
-        // count grows but the new messages are at the HEAD —
-        // `slice(prevCount)` would return already-rendered tail
-        // messages (which contain user bubbles) and force-scroll the
-        // reader away from the older page they just loaded. With the
-        // id-based slice a pure prepend yields an empty tail → no
-        // scroll, and the prepend-anchoring effect below keeps their
-        // viewport position.
-        const prevLastIdx = prevLastId ? messages.findIndex((m) => m.id === prevLastId) : -1
-        const newSlice = prevLastIdx >= 0 ? messages.slice(prevLastIdx + 1) : messages.slice(prevCount)
+        const newSlice = messages.slice(prevCount)
         const hasNewUser = newSlice.some((m) => m.role === 'user')
         if (hasNewUser) {
           void scrollToBottom({ animation: 'instant', ignoreEscapes: true })
@@ -251,35 +230,49 @@ const ChatMessageList = forwardRef<HTMLDivElement, ChatMessageListProps>(
     }, [autoScroll, messages, dialogId, scrollToBottom, contentRef])
 
     // ---- Prepend anchoring (load-older) ------------------------------
-    // The library doesn't preserve user position when content grows ABOVE
-    // the viewport. We do: from the pre-load geometry snapshot (taken in the
-    // sentinel callback), add the height the list gained and re-pin scrollTop
-    // so the message the user was reading stays put. `useLayoutEffect` so the
-    // write lands before paint (no visible jump). Covers both a pure prepend
-    // (new ids on top) and a boundary-merge (first bubble grows in place) —
-    // it measures total height delta, not message identity.
+    // The library doesn't preserve user position when content prepends
+    // ABOVE the viewport. We do it ourselves: snapshot scrollHeight
+    // BEFORE the new render, then add the delta after to keep the
+    // user on the same message they were reading. `useLayoutEffect`
+    // so the scrollTop write lands before paint (no visible jump).
     useLayoutEffect(() => {
       const el = scrollRef.current
-      const anchor = loadOlderAnchorRef.current
-      if (!el || !anchor) return
-      // Dialog switched out from under a pending load — abandon; the
-      // force-stick effect owns the new dialog's position.
-      if (anchor.dialogId !== dialogId) {
-        loadOlderAnchorRef.current = null
+      if (!el) {
+        prependRef.current = { firstMessageId: undefined, firstMessageContent: undefined, scrollHeight: 0 }
+        return
+      }
+
+      const currentFirstId = messages[0]?.id
+      const currentFirstContent = messages[0]?.content
+      const prevFirstId = prependRef.current.firstMessageId
+      const prevHeight = prependRef.current.scrollHeight
+
+      if (currentFirstId !== prevFirstId) {
+        // First-id changed → older messages prepended (verified by
+        // confirming the previous-first is still in the array at
+        // idx > 0; otherwise this is some other mutation).
+        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
       }
-      // Hold the anchor across the intermediate renders between firing
-      // onLoadMore and the older page committing (the isFetchingNextPage
-      // flip, and in some hosts a two-stage store update) — those don't grow
-      // the list. Apply on the first render where it actually grew taller,
-      // which is the prepend (new ids on top) or a boundary-merge (first
-      // bubble grew in place). Same-id boundary-merge is why this can't key
-      // on message count.
-      const addedHeight = el.scrollHeight - anchor.scrollHeight
-      if (addedHeight <= 0) return
-      loadOlderAnchorRef.current = null
-      el.scrollTop = anchor.scrollTop + addedHeight
-    }, [messages, dialogId, scrollRef])
+      // Always keep `scrollHeight` snapshot fresh so the next prepend
+      // computes the right delta. The id/content updates only when
+      // those actually change to avoid churn.
+      prependRef.current.scrollHeight = el.scrollHeight
+      if (currentFirstContent !== prependRef.current.firstMessageContent) {
+        prependRef.current.firstMessageContent = currentFirstContent
+      }
+    }, [messages, scrollRef])
 
     // ---- Per-message scrollAnchor (server-driven) --------------------
     // Server emits `scrollAnchor: 'top'` on the metadata leading frame
@@ -389,14 +382,6 @@ const ChatMessageList = forwardRef<HTMLDivElement, ChatMessageListProps>(
     // ---- Load-more (infinite-scroll UP) ------------------------------
     // Distinct from stick-to-bottom; uses its own IntersectionObserver
     // on the top sentinel.
-    //
-    // `isFetchingNextPage` is in the deps so the observer is RE-CREATED when a
-    // fetch completes: IntersectionObserver fires no new callback while an
-    // element stays continuously intersecting, so after an older page lands
-    // with the sentinel still in view (small prepend, or rootMargin overlap)
-    // nothing would re-trigger until the user scrolled it out and back in.
-    // Re-observing re-evaluates the current intersection and fires again if
-    // the sentinel is still visible — load continues until it's pushed out.
     useEffect(() => {
       const scrollContainer = scrollRef.current
       const sentinelElement = sentinelRef.current
@@ -407,16 +392,6 @@ const ChatMessageList = forwardRef<HTMLDivElement, ChatMessageListProps>(
           const entry = entries[0]
           if (!entry) return
           if (entry.isIntersecting && !isFetchingRef.current) {
-            // Snapshot pre-load geometry so the prepend-anchoring layout
-            // effect can re-pin scrollTop once the taller content commits.
-            const el = scrollRef.current
-            if (el) {
-              loadOlderAnchorRef.current = {
-                dialogId: dialogIdRef.current,
-                scrollHeight: el.scrollHeight,
-                scrollTop: el.scrollTop,
-              }
-            }
             onLoadMoreRef.current?.()
           }
         },
@@ -424,7 +399,7 @@ const ChatMessageList = forwardRef<HTMLDivElement, ChatMessageListProps>(
       )
       observer.observe(sentinelElement)
       return () => observer.disconnect()
-    }, [hasNextPage, isFetchingNextPage, scrollRef])
+    }, [hasNextPage, scrollRef])
 
     // Expose the scroll container ref to parents that need it (rare,
     // but the existing public contract). Library's `scrollRef` is a

package/src/components/chat/hooks/use-chat-card-item.ts

@@ -22,6 +22,7 @@
 import { useQuery } from '@tanstack/react-query'
 import { useRequiredChatRuntime } from '../../../contexts/chat-runtime-context'
 import { embedAuthedFetch } from '../../../utils/embed-authed-fetch'
+import { extractItems, extractItemId } from '../../../utils/extract-items'
 
 export interface UseChatCardItemResult<T = unknown> {
   item: T | undefined
@@ -29,44 +30,8 @@ export interface UseChatCardItemResult<T = unknown> {
   isError: boolean
 }
 
-/** Extract the items array from each endpoint's response shape (some
- *  return `{ items }`, others `{ posts }`, etc.). Single normalization
- *  point — callers always read `Item[]`. */
-function extractItems(data: unknown): unknown[] {
-  if (!data || typeof data !== 'object') return []
-  const obj = data as Record<string, unknown>
-  if (Array.isArray(obj.items)) return obj.items
-  if (Array.isArray(obj.posts)) return obj.posts
-  if (Array.isArray(obj.campaigns)) return obj.campaigns
-  if (Array.isArray(obj.completed) || Array.isArray(obj.inProgress)) {
-    // Delivery endpoint splits into completed/inProgress arrays — flatten.
-    const completed = Array.isArray(obj.completed) ? obj.completed : []
-    const inProgress = Array.isArray(obj.inProgress) ? obj.inProgress : []
-    return [...completed, ...inProgress]
-  }
-  if (Array.isArray(obj.data)) return obj.data
-  if (Array.isArray(data)) return data
-  return []
-}
-
-/** Extract a stable id from a fetched item — different shapes use
- *  `id` vs `external_id`. Used by the chat loader to match the fetched
- *  array element back to the marker's id. */
-function extractItemId(type: string, item: unknown): string | null {
-  if (!item || typeof item !== 'object') return null
-  const obj = item as Record<string, unknown>
-  if (type === 'roadmap_item' || type === 'delivery_item' || type === 'internal_task') {
-    const ext = obj.external_id
-    if (typeof ext === 'string') return ext
-  }
-  // RoadmapItem-shaped responses use `id` to carry the external_id; the
-  // mapper renames external_id→id at the API boundary. Treat both id and
-  // external_id as primary-key candidates for these clickup-backed types.
-  const id = obj.id
-  if (typeof id === 'string') return id
-  if (typeof id === 'number') return String(id)
-  return null
-}
+// `extractItems` / `extractItemId` hoisted to `src/utils/extract-items.ts`
+// (shared with the related-content rail — react-query-free home).
 
 export function useChatCardItem<T = unknown>(
   type: string,

package/src/components/chat/types/entities/content-ref.ts

@@ -1,23 +1,7 @@
 /**
- * ContentRef — the unified link/embed shape stored in JSONB columns
- * across investor updates, performance baselines, and any other entity
- * that surfaces "related content" rails.
- *
- * Lifted from `lib/data/investor-update-utils-shared.ts` in the hub
- * (the server-side data utils in the same file stay hub-side; only the
- * TYPE moves here).
+ * RELOCATED — the canonical `ContentRef` now lives at `src/types/content-ref.ts`
+ * (server-safe home, shared by the related-content rail + chat entities).
+ * This stub keeps the chat entities barrel + `entities/investor-update.ts`
+ * compiling unchanged. One definition package-wide.
  */
-
-export interface ContentRef {
-  type: string;
-  id: string;
-  slug: string;
-  url: string;
-  targetPlatform?: string | null;
-  title: string;
-  summary?: string;
-  image_url?: string;
-  image_bg_color?: string;
-  visibility: 'public' | 'internal';
-  display_order: number;
-}
+export type { ContentRef, ContentRefWithReason } from '../../../../types/content-ref';

package/src/components/chat/utils/index.ts

@@ -31,18 +31,6 @@ export {
   extractIncompleteMessageState,
 } from './extract-incomplete-message-state'
 
-// History <-> realtime reconciliation
-export {
-  mergeHistoryWithRealtime,
-  computeHistoryPrepend,
-  flattenMessagePagesChronological,
-  maxPersistedStreamSeq,
-  SYNTHETIC_REALTIME_ID_PREFIXES,
-  type MergeableChatMessage,
-  type HistoryMergeInput,
-  type HistoryPrependResult,
-} from './history-merge'
-
 // Tool call helpers
 export { getCommandText } from './tool-call-helpers'
 

package/src/components/faq/faq-section.tsx

@@ -1,9 +1,10 @@
 "use client"
 
-import React from 'react'
+import React, { useMemo } from 'react'
 import type { Faq } from '../../types/faq'
 import { FaqAccordion, type FaqItem } from '../faq-accordion'
 import { useSelfFetch } from '../../hooks/use-self-fetch'
+import { buildSuggestionUrl } from '../../utils/suggestion-url'
 import { buildFaqJsonLdFromFaqs, type FaqSchemaOptions } from './json-ld'
 
 export interface FaqSectionProps {
@@ -28,16 +29,26 @@ export interface FaqSectionProps {
   /** Overrides for the JSON-LD's name/description/url. */
   jsonLd?: FaqSchemaOptions
   className?: string
+  /** Maps to /api/faqs `?count=` (the 5-tier fill target). Absent → param
+   *  not sent (server default applies). */
+  minResults?: number
+  /** Fetch-URL prefix for third-party embeds / reverse proxies
+   *  ('' = same-origin relative). */
+  apiBaseUrl?: string
 }
 
 const DEFAULT_HEADING_TEXT = 'Frequently Asked Questions'
 
-function buildFaqsUrl(entityType?: string, entityId?: number | string): string {
-  if (!entityType || entityId === undefined || entityId === null || entityId === '') {
-    return '/api/faqs'
-  }
-  const qs = new URLSearchParams({ entityType, entityId: String(entityId) })
-  return `/api/faqs?${qs.toString()}`
+/** URL composition shared with RelatedContentSection (`buildSuggestionUrl`)
+ *  — byte-identical to the historical `buildFaqsUrl` output when
+ *  `minResults`/`apiBaseUrl` are absent. */
+function buildFaqsUrl(
+  entityType?: string,
+  entityId?: number | string,
+  minResults?: number,
+  apiBaseUrl = '',
+): string {
+  return buildSuggestionUrl('/api/faqs', { apiBaseUrl, entityType, entityId, count: minResults })
 }
 
 function groupBySection(faqs: Faq[]): Array<{ section: string | null; items: FaqItem[] }> {
@@ -97,9 +108,16 @@ export function FaqSection({
   emitJsonLd = false,
   jsonLd,
   className,
+  minResults,
+  apiBaseUrl = '',
 }: FaqSectionProps) {
-  const url = buildFaqsUrl(entityType, entityId)
-  const initialData = initialFaqs ? { faqs: initialFaqs } : undefined
+  const url = buildFaqsUrl(entityType, entityId, minResults, apiBaseUrl)
+  // Memoized — useSelfFetch re-syncs on [initialData]; a fresh per-render
+  // wrapper object would setState-loop under re-rendering parents.
+  const initialData = useMemo<FaqsResponse | undefined>(
+    () => (initialFaqs ? { faqs: initialFaqs } : undefined),
+    [initialFaqs],
+  )
   const { data, isLoading, error } = useSelfFetch<FaqsResponse>(url, { initialData })
 
   const faqs = data?.faqs ?? []
@@ -116,7 +134,24 @@ export function FaqSection({
     return null
   }
 
+  // Embedded mode, zero FAQs after load: render nothing — an embedded host
+  // page (blog/case-study detail) must not show an empty section shell.
+  // The standalone /faqs page (heading set) keeps its existing behavior.
+  if (!isLoading && !error && faqs.length === 0 && !showHeading) {
+    return null
+  }
+
   if (isLoading && faqs.length === 0) {
+    // Embedded mode renders skeletons WITHOUT the standalone page shell —
+    // a host detail page already provides <main> + gutters; nesting them
+    // here would emit invalid markup and double padding.
+    if (!showHeading) {
+      return (
+        <div className={className}>
+          <FaqSkeleton />
+        </div>
+      )
+    }
     return (
       <main className={className ?? 'bg-ods-bg'}>
         <div className="max-w-[1920px] px-6 md:px-20 py-6 md:py-10 mx-auto">
@@ -136,23 +171,33 @@ export function FaqSection({
 
   const schema = emitJsonLd ? buildFaqJsonLdFromFaqs(faqs, jsonLd) : null
 
+  const groupNodes = groups.map(({ section, items }) => (
+    <div key={section || 'default'} className="space-y-4">
+      {section && (
+        <h2 className="text-h2 tracking-[-0.04em] text-ods-text-primary mb-3 md:mb-4">
+          {section}
+        </h2>
+      )}
+      <FaqAccordion items={items} />
+    </div>
+  ))
+
+  // Embedded mode (heading === null): no <main> page shell, no page gutters —
+  // the host page owns layout. Standalone mode keeps the historical markup.
+  const body = showHeading ? (
+    <main className={className ?? 'bg-ods-bg'}>
+      <div className="max-w-[1920px] px-6 md:px-20 py-6 md:py-10 mx-auto space-y-10">
+        {headingNode}
+        {groupNodes}
+      </div>
+    </main>
+  ) : (
+    <section className={className ?? 'space-y-10'}>{groupNodes}</section>
+  )
+
   return (
     <>
-      <main className={className ?? 'bg-ods-bg'}>
-        <div className="max-w-[1920px] px-6 md:px-20 py-6 md:py-10 mx-auto space-y-10">
-          {showHeading && headingNode}
-          {groups.map(({ section, items }) => (
-            <div key={section || 'default'} className="space-y-4">
-              {section && (
-                <h2 className="text-h2 tracking-[-0.04em] text-ods-text-primary mb-3 md:mb-4">
-                  {section}
-                </h2>
-              )}
-              <FaqAccordion items={items} />
-            </div>
-          ))}
-        </div>
-      </main>
+      {body}
       {schema && (
         <script
           type="application/ld+json"

package/src/components/features/policy-configuration-panel.tsx

@@ -204,7 +204,6 @@ const CategorySection: React.FC<{
 
         {/* Expand/Collapse Button */}
         <Button
-          type="button"
           variant="transparent"
           onClick={(e) => {
             e.stopPropagation();

package/src/components/index.ts

@@ -26,6 +26,7 @@ export * from './faq-accordion'
 // dedicated server-safe subpath "./components/faq/json-ld" (built without the
 // client banner under the server/universal block of tsup.config.ts).
 export * from './faq'
+export * from './related-content'
 export * from './filter-chip'
 export * from './footer'
 export * from './unified-filter-logic'

package/src/components/related-content/index.ts

@@ -0,0 +1,9 @@
+// CLIENT subpath barrel — `@flamingo-stack/openframe-frontend-core/components/related-content`
+export {
+  RelatedContentSection,
+  type RelatedContentSectionProps,
+  type CardLinkProvider,
+  type CardLinkProviderProps,
+  type CardLinkAnchorProps,
+  type AdminCampaignCardSlot,
+} from './related-content-section'