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

package/dist/components/related-content/related-content-section.d.ts

@@ -1,141 +0,0 @@
-/**
- * RelatedContentSection
- *
- * Renders content references grouped by type using the canonical card
- * components. MOVED from the hub (`components/shared/related-content-card.tsx`)
- * so any consuming app can embed it; the hub keeps a thin wrapper that
- * pre-binds its host-specific injections (nav hook, URL recomposition,
- * program configs, admin campaign card).
- *
- * THREE data modes (precedence top-down):
- *   1. CONTROLLED — `contentRefs` provided (even `[]`): render exactly those
- *      refs, no suggestion fetch (the original investor-update behavior).
- *   2. SUGGESTION — `entityType` + `entityId` provided: self-fetch
- *      `GET {apiBaseUrl}/api/related-content?entityType&entityId[&count][&excludeTypes]`
- *      (the generic 5-tier engine's second web service). `minResults` maps to
- *      `count`; absent → param not sent (server default applies). Each ref
- *      carries a `reason` (data-only — never rendered, matching the
- *      FaqSection/FaqWithReason precedent).
- *   3. SSR-HYDRATED suggestion — also pass `initialItems` (the server page
- *      called the engine directly); the first client fetch is skipped per the
- *      `useSelfFetch` initialData contract.
- *
- * Group layout (list vs grid) + card size (lg vs default) come from
- * `CONTENT_REF_GROUPS` in `../../utils/content-ref-groups` — single source of
- * truth, no per-type logic in this file. Skeletons come from
- * `renderSkeletonForType` so the placeholder height matches the loaded card
- * exactly (zero layout shift on resolve).
- *
- * One API call per content type via the shared list-URL builder
- * (`buildListUrl` — injectable; defaults to the lib's byte-parity-tested
- * builder prefixed with `apiBaseUrl`). Fetching uses `useSelfFetch` (plain
- * fetch, NO react-query) so third-party embedders need no QueryClientProvider;
- * cards are imported via DEEP module paths (not the chat barrel) so this
- * chunk never reaches `@tanstack/react-query`.
- *
- * LOCKSTEP NOTE: this file's per-type card/skeleton dispatch is the SIZED
- * sibling of the chat-side `CHAT_CARD_REGISTRY` (`../chat/entity-cards/
- * dispatch.tsx`), which renders compact `size='sm'` cards wired to the chat
- * runtime. Two dispatchers by design — when registering a new fetch-mode
- * content type, add it BOTH there and here (cards + skeleton + list URL).
- */
-import React from 'react';
-import type { ContentRef, ContentRefWithReason } from '../../types/content-ref';
-import type { ChatCardDispatchExtras } from '../chat/entity-cards/dispatch';
-/** Anchor prop bundle the per-card link surface receives — same shape the
- *  hub's `useNavLink` returns and the chat dispatcher's anchor builders
- *  produce. `null` = non-anchor mode (no URL). */
-export interface CardLinkAnchorProps {
-    href: string;
-    target?: '_blank';
-    rel?: 'noopener noreferrer';
-    onClick?: (e: React.MouseEvent<HTMLAnchorElement>) => void;
-}
-/** Render-prop component injection for the navigation decision — keeps hook
- *  calls legal (hooks live INSIDE the injected component; `CardForType`
- *  itself calls zero hooks). The hub injects a `useNavLink`-backed provider;
- *  the default is hook-free (pure `decideNewTab`). MUST be defined at module
- *  scope by hosts — an inline arrow would remount every card each render. */
-export interface CardLinkProviderProps {
-    href: string | null;
-    targetPlatform: string | null;
-    children: (linkProps: CardLinkAnchorProps | null) => React.ReactElement | null;
-}
-export type CardLinkProvider = React.ComponentType<CardLinkProviderProps>;
-/** Host-injected renderer pair for the admin-only `marketing_campaign` type.
- *  Absent (every non-hub embed) → the type renders nothing (its list URL
- *  hits `/api/admin`, unreachable outside the hub anyway). */
-export interface AdminCampaignCardSlot {
-    Card: React.ComponentType<{
-        campaign: any;
-    }>;
-    Skeleton: React.ComponentType<{
-        size?: 'default' | 'sm';
-    }>;
-}
-export interface RelatedContentSectionProps {
-    /** CONTROLLED mode (the original behavior). When defined — even `[]` — no
-     *  suggestion fetch runs and exactly these refs render. */
-    contentRefs?: ContentRef[];
-    /** SUGGESTION mode (with `entityId`): self-fetch suggestions for this host
-     *  entity from `{apiBaseUrl}/api/related-content`. Ignored when
-     *  `contentRefs` is provided. */
-    entityType?: string;
-    entityId?: number | string;
-    /** Maps to the suggestion API's `count` param — the PER-TYPE fill target
-     *  for every candidate type EXCEPT the host's own. Absent → param not sent
-     *  (server default applies). */
-    minResults?: number;
-    /** Maps to the suggestion API's `sameTypeCount` param — the budget for the
-     *  candidate type MATCHING the host's own `entityType` (same-type boost:
-     *  a blog post's rail leads with more blog posts). Absent → param not
-     *  sent (host's type uses the server's `count`). */
-    sameTypeMinResults?: number;
-    /** SSR hydrate for suggestion mode — the server page ran the engine and
-     *  drills the refs here; the first client fetch is skipped (useSelfFetch
-     *  initialData contract). */
-    initialItems?: ContentRefWithReason[];
-    /** Section title (default: "Related Content") */
-    title?: string;
-    /**
-     * Grid columns at desktop. 2 = denser cards / wider summary (original
-     * investor-update layout); 3 = more cards per row for dashboards.
-     * Only consulted for grid-layout groups. Default: 2.
-     */
-    columns?: 2 | 3;
-    /**
-     * ContentRef.type values to exclude. Honored in ALL modes — controlled
-     * mode post-filters (original behavior); suggestion mode ALSO forwards the
-     * list verbatim as the API's `excludeTypes=` param so excluded types never
-     * consume engine fill slots (`minResults` stays honored). The subtraction
-     * happens SERVER-side — this component never mirrors the hub's candidate
-     * list.
-     */
-    excludeTypes?: string[];
-    /** Fetch-URL prefix for third-party embeds / reverse proxies
-     *  ('' = same-origin). Applied to BOTH the suggestion fetch and the
-     *  default per-group list fetches. */
-    apiBaseUrl?: string;
-    /** Host injection bundle — REUSES the chat dispatcher's
-     *  `ChatCardDispatchExtras` (programConfigs, buildOgPlaceholderUrl,
-     *  buildProductReleaseCardProps override). Program groups render nothing
-     *  when their config is absent. */
-    extras?: ChatCardDispatchExtras;
-    /** Hub injects its `buildContentURL` recomposition; default uses the
-     *  ref's stored `url`/`targetPlatform` as the API composed them. */
-    resolveHref?: (ref: ContentRef) => {
-        href: string | null;
-        targetPlatform: string | null;
-    };
-    /** Hub injects its registry-driven entity-list-api builder; default = the
-     *  lib's `buildListUrl(type, ids, apiBaseUrl)`. */
-    buildListUrl?: (type: string, ids: string[]) => string | null;
-    /** Hub injects a `useNavLink`-backed render-prop provider; default = pure
-     *  anchor via `decideNewTab`. MUST be a module-scope component. */
-    LinkProvider?: CardLinkProvider;
-    /** Renderer pair for the admin-only `marketing_campaign` type. Absent →
-     *  the type renders nothing. */
-    adminCampaignCard?: AdminCampaignCardSlot;
-}
-export declare function RelatedContentSection({ contentRefs, entityType, entityId, minResults, sameTypeMinResults, initialItems, title, columns, excludeTypes, apiBaseUrl, extras, resolveHref, buildListUrl, LinkProvider, adminCampaignCard, }: RelatedContentSectionProps): React.JSX.Element | null;
-//# sourceMappingURL=related-content-section.d.ts.map

package/dist/components/related-content/related-content-section.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"related-content-section.d.ts","sourceRoot":"","sources":["../../../src/components/related-content/related-content-section.tsx"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AAEH,OAAO,KAAkB,MAAM,OAAO,CAAC;AAOvC,OAAO,KAAK,EAAE,UAAU,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAuBhF,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AAI5E;;kDAEkD;AAClD,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,QAAQ,CAAC;IAClB,GAAG,CAAC,EAAE,qBAAqB,CAAC;IAC5B,OAAO,CAAC,EAAE,CAAC,CAAC,EAAE,KAAK,CAAC,UAAU,CAAC,iBAAiB,CAAC,KAAK,IAAI,CAAC;CAC5D;AAED;;;;6EAI6E;AAC7E,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,QAAQ,EAAE,CAAC,SAAS,EAAE,mBAAmB,GAAG,IAAI,KAAK,KAAK,CAAC,YAAY,GAAG,IAAI,CAAC;CAChF;AACD,MAAM,MAAM,gBAAgB,GAAG,KAAK,CAAC,aAAa,CAAC,qBAAqB,CAAC,CAAC;AAuB1E;;8DAE8D;AAC9D,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,KAAK,CAAC,aAAa,CAAC;QAAE,QAAQ,EAAE,GAAG,CAAA;KAAE,CAAC,CAAC;IAC7C,QAAQ,EAAE,KAAK,CAAC,aAAa,CAAC;QAAE,IAAI,CAAC,EAAE,SAAS,GAAG,IAAI,CAAA;KAAE,CAAC,CAAC;CAC5D;AA4TD,MAAM,WAAW,0BAA0B;IACzC;+DAC2D;IAC3D,WAAW,CAAC,EAAE,UAAU,EAAE,CAAC;IAC3B;;qCAEiC;IACjC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC3B;;oCAEgC;IAChC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;wDAGoD;IACpD,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B;;iCAE6B;IAC7B,YAAY,CAAC,EAAE,oBAAoB,EAAE,CAAC;IACtC,iDAAiD;IACjD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;;OAIG;IACH,OAAO,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC;IAChB;;;;;;;OAOG;IACH,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB;;0CAEsC;IACtC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;uCAGmC;IACnC,MAAM,CAAC,EAAE,sBAAsB,CAAC;IAChC;wEACoE;IACpE,WAAW,CAAC,EAAE,CAAC,GAAG,EAAE,UAAU,KAAK;QAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,cAAc,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC;IAC1F;uDACmD;IACnD,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,MAAM,GAAG,IAAI,CAAC;IAC9D;uEACmE;IACnE,YAAY,CAAC,EAAE,gBAAgB,CAAC;IAChC;oCACgC;IAChC,iBAAiB,CAAC,EAAE,qBAAqB,CAAC;CAC3C;AAED,wBAAgB,qBAAqB,CAAC,EACpC,WAAW,EACX,UAAU,EACV,QAAQ,EACR,UAAU,EACV,kBAAkB,EAClB,YAAY,EACZ,KAAyB,EACzB,OAAW,EACX,YAAY,EACZ,UAAe,EACf,MAAM,EACN,WAAgC,EAChC,YAAY,EACZ,YAAuC,EACvC,iBAAiB,GAClB,EAAE,0BAA0B,4BA0F5B"}

package/dist/types/content-ref.d.ts

@@ -1,35 +0,0 @@
-/**
- * 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 from `components/chat/types/entities/`
- * to this server-safe home when `RelatedContentSection` moved into the
- * lib — the chat path re-exports from here, so there is exactly ONE
- * `ContentRef` 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;
-}
-/**
- * A ContentRef as returned by the suggestion service (`/api/related-content`)
- * — carries the 5-tier engine's placement reason. Widened to `string` here
- * (the narrow reason union is hub-server vocabulary); data-only, never
- * rendered by the rail.
- */
-export type ContentRefWithReason = ContentRef & {
-    reason: string;
-};
-//# sourceMappingURL=content-ref.d.ts.map

package/dist/types/content-ref.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"content-ref.d.ts","sourceRoot":"","sources":["../../src/types/content-ref.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,UAAU,EAAE,QAAQ,GAAG,UAAU,CAAC;IAClC,aAAa,EAAE,MAAM,CAAC;CACvB;AAED;;;;;GAKG;AACH,MAAM,MAAM,oBAAoB,GAAG,UAAU,GAAG;IAAE,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC"}

package/dist/utils/content-ref-groups.d.ts

@@ -1,58 +0,0 @@
-/**
- * Content Ref Group Configuration
- *
- * Single source of truth for grouping content_refs by type. Used by both:
- *  - components/related-content (detail page rail — lives in this lib)
- *  - the hub's lib/utils/investor-email-utils.ts (email builder, via the
- *    hub's re-export shim at lib/config/content-ref-groups.ts)
- *
- * Lives in utils/ (server-safe tsup block) so hub server-side code can
- * import it.
- *
- * Each entry carries the metadata RelatedContentSection needs to render the
- * group WITHOUT re-implementing per-type logic locally:
- *   - `label`: section heading.
- *   - `order`: source-stable ordering (lowest first).
- *   - `layout`: 'list' (one-per-row, full-width cards) or 'grid' (responsive
- *     column grid).
- *   - `gridSize`: card-size variant passed to the per-type card dispatch.
- *     `'lg'` matches the canonical large-card variant openframe + flamingo
- *     apps already use; `'default'` is the legacy denser variant. New types
- *     should pick `'lg'` whenever the card has a large variant.
- *
- * Adding a new content type = one entry here. RelatedContentSection picks up
- * the new group automatically (no hardcoded set to update). NOTE: the hub's
- * related-content SUGGESTION candidate list is DERIVED from these keys (minus
- * an explicit exclusion knob) — a new entry here becomes a suggestion
- * candidate iff it also resolves through the hub's TYPE_TO_ENTITY → RAG
- * config chain (unresolvable entries are dropped loudly at module load).
- */
-export type ContentRefLayout = 'list' | 'grid';
-/** Subset of `EntityCardSize` (entity-card dispatch) appropriate for
- *  grid/list rendering in RelatedContentSection. Duplicated as a literal
- *  union here to avoid a config→component import cycle. Kept in lockstep
- *  with `EntityCardSize`; widen here when a new size is added there. */
-export type ContentRefGridSize = 'lg' | 'default' | 'sm';
-export interface ContentRefGroupConfig {
-    label: string;
-    order: number;
-    layout: ContentRefLayout;
-    gridSize: ContentRefGridSize;
-}
-export declare const CONTENT_REF_GROUPS: Record<string, ContentRefGroupConfig>;
-/** Human-readable label for a content_ref `type`. Returns null when the type
- *  isn't registered — caller decides the fallback. Use `getContentRefLabelOrTitleCase`
- *  to get a consistent title-cased fallback across all surfaces. */
-export declare function getContentRefLabel(type: string): string | null;
-/** Resolved label with a single shared fallback shape — title-cased version
- *  of the raw type string for any unregistered type. Both RelatedContentSection
- *  AND the investor-email builder consume this so cross-surface label rendering
- *  for unregistered types is identical (no drift between "podcast guest" and
- *  "Podcast Guest"). */
-export declare function getContentRefLabelOrTitleCase(type: string): string;
-/** Sort a set of present content_ref types into the canonical group order
- *  (registered types first in CONTENT_REF_GROUPS `order`, then unregistered
- *  types appended in insertion order). Used by RelatedContentSection AND the
- *  investor-email builder so cross-surface ordering stays identical. */
-export declare function orderContentRefTypes(present: Iterable<string>): string[];
-//# sourceMappingURL=content-ref-groups.d.ts.map

package/dist/utils/content-ref-groups.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"content-ref-groups.d.ts","sourceRoot":"","sources":["../../src/utils/content-ref-groups.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAEH,MAAM,MAAM,gBAAgB,GAAG,MAAM,GAAG,MAAM,CAAA;AAE9C;;;wEAGwE;AACxE,MAAM,MAAM,kBAAkB,GAAG,IAAI,GAAG,SAAS,GAAG,IAAI,CAAA;AAExD,MAAM,WAAW,qBAAqB;IACpC,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,gBAAgB,CAAA;IACxB,QAAQ,EAAE,kBAAkB,CAAA;CAC7B;AAED,eAAO,MAAM,kBAAkB,EAAE,MAAM,CAAC,MAAM,EAAE,qBAAqB,CAUpE,CAAA;AAED;;oEAEoE;AACpE,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAE9D;AAED;;;;wBAIwB;AACxB,wBAAgB,6BAA6B,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAKlE;AAED;;;wEAGwE;AACxE,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,GAAG,MAAM,EAAE,CAQxE"}

package/dist/utils/extract-items.d.ts

@@ -1,18 +0,0 @@
-/**
- * List-API response normalizers — HOISTED from
- * `components/chat/hooks/use-chat-card-item.ts` (private copies) so the
- * related-content rail can import them WITHOUT touching the chat hooks
- * chunk (which reaches `@tanstack/react-query`). Pure + server-safe.
- *
- * The hub's `lib/utils/entity-list-api.ts` re-exports these — one
- * implementation of response-shape normalization across both repos.
- */
-/** Extract the items array from each endpoint's response shape (some
- *  return `{ items }`, others `{ posts }`, etc.). Single normalization
- *  point — callers always read `Item[]`. */
-export declare function extractItems(data: unknown): unknown[];
-/** 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. */
-export declare function extractItemId(type: string, item: unknown): string | null;
-//# sourceMappingURL=extract-items.d.ts.map

package/dist/utils/extract-items.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"extract-items.d.ts","sourceRoot":"","sources":["../../src/utils/extract-items.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH;;4CAE4C;AAC5C,wBAAgB,YAAY,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,EAAE,CAerD;AAED;;6CAE6C;AAC7C,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAcxE"}

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

@@ -1,26 +0,0 @@
-/**
- * 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

@@ -1 +0,0 @@
-{"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/src/components/related-content/index.ts

@@ -1,9 +0,0 @@
-// 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'