@flamingo-stack/openframe-frontend-core 0.0.218 → 0.0.219

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

@@ -0,0 +1,46 @@
+/**
+ * Shared list-API URL builder — the single un-replicable piece of the
+ * chat entity-card fetch path.
+ *
+ * ## Why this exists
+ *
+ * A fetch-mode entity card (`dispatch.tsx` → `useChatCardItem`) expands a
+ * compact `[card://<type>:<id>]` marker by fetching the type's public list
+ * endpoint with an `?ids=` (or `?task_ids=`) filter and matching the row
+ * back by id. The per-type URL SHAPE is non-obvious — `task_ids` for the
+ * ClickUp-backed types, `pageSize` for blog, `&limit=N&filter=all` for the
+ * programs trio, a distinct `/customer-interviews` path, etc. — and lives in
+ * the hub's 12 RAG mapper closures (`lib/config/rag-mappers/*.ts`). An
+ * embedder can't reverse-engineer those shapes, so a wrong/missing builder
+ * resolves a null URL ⇒ `enabled:false` ⇒ the card never fetches and renders
+ * nothing.
+ *
+ * This builder is the ONE source for those shapes. The hub's 12 mappers
+ * delegate their `listApi` here (a byte-parity test guards the migration),
+ * and embedders wire it once:
+ *
+ *   endpoints.buildListUrl = (type, ids) => buildListUrl(type, ids, '/content')
+ *
+ * `base=''` (default) yields the hub-relative `/api/...`; `base='/content'`
+ * (or any reverse-proxy prefix) yields `/content/api/...`.
+ *
+ * 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`.
+ */
+/**
+ * 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
+ * fabricating a URL).
+ *
+ *   buildListUrl('roadmap_item', ['a','b'])             → '/api/roadmap?task_ids=a,b'
+ *   buildListUrl('blog_post_existing', ['a','b'])       → '/api/blog/posts?ids=a,b&pageSize=2'  (alias)
+ *   buildListUrl('roadmap_item', ['a','b'], '/content') → '/content/api/roadmap?task_ids=a,b'
+ *   buildListUrl('github_pr', ['a'])                    → null  (absent key)
+ *
+ * `marketing_campaign` (admin-only, non-RAG) is a LITERAL case, NOT a
+ * `BUILDERS` entry — a static branch keeps CodeQL able to prove no
+ * user-controlled dynamic dispatch reaches the admin endpoint; embedders
+ * can't hit `/api/admin` through their proxy anyway.
+ */
+export declare function buildListUrl(contentRefType: string, ids: string[], base?: string): string | null;
+//# sourceMappingURL=list-url.d.ts.map

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

@@ -0,0 +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"}

package/dist/utils/ods-color-utils.d.ts

@@ -78,6 +78,25 @@ export declare function usePlatformColors(platform?: Platform): {
  * Uses Rec. 601 luminance.
  */
 export declare function getReadableTextColor(hex: string): string;
+export declare const HEX_PATTERN: RegExp;
+export declare function hexToRgb(hex: string): {
+    r: number;
+    g: number;
+    b: number;
+} | null;
+export declare function rgbToHex(r: number, g: number, b: number): string;
+export declare function deriveHoverColor(hex: string): string;
+export declare function deriveActiveColor(hex: string): string;
+export declare function rgbToHsl(r: number, g: number, b: number): {
+    h: number;
+    s: number;
+    l: number;
+};
+export declare function hslToRgb(h: number, s: number, l: number): {
+    r: number;
+    g: number;
+    b: number;
+};
 declare const _default: {
     getODSToken: typeof getODSToken;
     getPlatformAccentColor: typeof getPlatformAccentColor;

package/dist/utils/ods-color-utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ods-color-utils.d.ts","sourceRoot":"","sources":["../../src/utils/ods-color-utils.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,MAAM,MAAM,QAAQ,GAAG,SAAS,GAAG,WAAW,GAAG,UAAU,CAAC;AAC5D,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,UAAU,GAAG,QAAQ,GAAG,WAAW,CAAC;AACzE,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,OAAO,GAAG,QAAQ,GAAG,OAAO,GAAG,UAAU,CAAC;AAE9E;;GAEG;AACH,wBAAgB,WAAW,CACzB,QAAQ,EAAE,aAAa,EACvB,KAAK,EAAE,MAAM,EACb,OAAO,GAAE,YAAqB,GAC7B,MAAM,GAAG,SAAS,CAGpB;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,QAAQ,CAAC,EAAE,QAAQ,GAAG,MAAM,CAUlE;AAED;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,QAAQ,CAa7C;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,QAAQ,GAAG,IAAI,CAa5D;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,YAAY,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,QAAQ,GAAG,MAAM,GAAG,SAAS,CAyB9F;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,MAAM,EAChB,IAAI,GAAE,IAAI,GAAG,MAAM,GAAG,QAAe,GACpC,MAAM,GAAG,SAAS,CAsCpB;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAUnF;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAEzD;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,CAAC,EAAE,QAAQ;;;;;;EAcpD;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,QAAQ,GAAG,MAAM,CAoB9D;AAED;;GAEG;AACH,wBAAgB,eAAe,CAC7B,OAAO,EAAE,WAAW,EACpB,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,GACf,IAAI,CAKN;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,GACf,MAAM,CAgCR;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,CAAC,EAAE,QAAQ;;;;;;yBAU5B,aAAa,SAAS,MAAM,YAAY,YAAY;+BAE9C,QAAQ;qCACF,MAAM;EAE1C;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAOxD;;;;;;;;;;;;;;;;AAED,wBAcE"}
+{"version":3,"file":"ods-color-utils.d.ts","sourceRoot":"","sources":["../../src/utils/ods-color-utils.ts"],"names":[],"mappings":"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"}

package/dist/utils/platform-config.d.ts

@@ -2,17 +2,17 @@ import React from 'react';
 import type { SelectableOption } from '../components/features';
 import type { PlatformConfig } from '../types/platform';
 export declare const platformIcons: {
-    openframe: import("react/jsx-runtime").JSX.Element;
-    openmsp: import("react/jsx-runtime").JSX.Element;
-    flamingo: import("react/jsx-runtime").JSX.Element;
-    'flamingo-teaser': import("react/jsx-runtime").JSX.Element;
-    'marketing-hub': import("react/jsx-runtime").JSX.Element;
-    'product-hub': import("react/jsx-runtime").JSX.Element;
-    'revenue-hub': import("react/jsx-runtime").JSX.Element;
-    'people-hub': import("react/jsx-runtime").JSX.Element;
-    'company-hub': import("react/jsx-runtime").JSX.Element;
-    tmcg: import("react/jsx-runtime").JSX.Element;
-    universal: import("react/jsx-runtime").JSX.Element;
+    openframe: React.JSX.Element;
+    openmsp: React.JSX.Element;
+    flamingo: React.JSX.Element;
+    'flamingo-teaser': React.JSX.Element;
+    'marketing-hub': React.JSX.Element;
+    'product-hub': React.JSX.Element;
+    'revenue-hub': React.JSX.Element;
+    'people-hub': React.JSX.Element;
+    'company-hub': React.JSX.Element;
+    tmcg: React.JSX.Element;
+    universal: React.JSX.Element;
 };
 export declare const platformColors: {
     openmsp: string;
@@ -94,7 +94,7 @@ export declare function transformPlatformConfigsToOptions(platformConfigs: Platf
 /**
  * Get platform icon by name
  */
-export declare function getPlatformIcon(platformName: string): import("react/jsx-runtime").JSX.Element;
+export declare function getPlatformIcon(platformName: string): React.JSX.Element;
 /**
  * Get platform color by name
  */

package/dist/utils/platform-config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"platform-config.d.ts","sourceRoot":"","sources":["../../src/utils/platform-config.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAG1B,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC/D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAGxD,eAAO,MAAM,aAAa;;;;;;;;;;;;CAYzB,CAAC;AAGF,eAAO,MAAM,cAAc;;;;;;;;;;;;CAY1B,CAAC;AAGF,eAAO,MAAM,oBAAoB;;;;;;;;;;;;CAYhC,CAAC;AAGF,eAAO,MAAM,oBAAoB;;;;;;;CAOhC,CAAC;AAGF,eAAO,MAAM,eAAe;;;;;;;CAO3B,CAAC;AAGF,eAAO,MAAM,iBAAiB;;;;;;;;;;;;CAY7B,CAAC;AAGF,eAAO,MAAM,iBAAiB;;;;;;;;;;;;CAY7B,CAAC;AAEF;;GAEG;AACH,wBAAgB,0BAA0B,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAEvE;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAEtE;AAED,wBAAgB,iCAAiC,CAAC,eAAe,EAAE,cAAc,EAAE,GAAG,gBAAgB,EAAE,CASvG;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,YAAY,EAAE,MAAM,2CAEnD;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,YAAY,EAAE,MAAM,UAEpD;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAEnE;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAEnE;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAE9D;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,YAAY,EAAE,MAAM,GAAG,KAAK,CAAC,SAAS,CA2B1E;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,YAAY,EAAE,MAAM,EAAE,SAAS,GAAE,MAAkB,GAAG,KAAK,CAAC,SAAS,CAyB7G"}
+{"version":3,"file":"platform-config.d.ts","sourceRoot":"","sources":["../../src/utils/platform-config.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAG1B,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC/D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAGxD,eAAO,MAAM,aAAa;;;;;;;;;;;;CAYzB,CAAC;AAGF,eAAO,MAAM,cAAc;;;;;;;;;;;;CAY1B,CAAC;AAGF,eAAO,MAAM,oBAAoB;;;;;;;;;;;;CAYhC,CAAC;AAGF,eAAO,MAAM,oBAAoB;;;;;;;CAOhC,CAAC;AAGF,eAAO,MAAM,eAAe;;;;;;;CAO3B,CAAC;AAGF,eAAO,MAAM,iBAAiB;;;;;;;;;;;;CAY7B,CAAC;AAGF,eAAO,MAAM,iBAAiB;;;;;;;;;;;;CAY7B,CAAC;AAEF;;GAEG;AACH,wBAAgB,0BAA0B,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAEvE;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAEtE;AAED,wBAAgB,iCAAiC,CAAC,eAAe,EAAE,cAAc,EAAE,GAAG,gBAAgB,EAAE,CASvG;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,YAAY,EAAE,MAAM,qBAEnD;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,YAAY,EAAE,MAAM,UAEpD;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAEnE;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAEnE;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAE9D;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,YAAY,EAAE,MAAM,GAAG,KAAK,CAAC,SAAS,CA2B1E;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,YAAY,EAAE,MAAM,EAAE,SAAS,GAAE,MAAkB,GAAG,KAAK,CAAC,SAAS,CAyB7G"}

package/dist/utils/release-badge.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Single source of truth for mapping a product release's `release_type` to
+ * the `StatusBadge` colorScheme used in the `ProductReleaseCard` lg variant's
+ * metadata-grid Type cell. Every surface that renders a
+ * `<ProductReleaseCard size="lg" ...>` must pass this value as
+ * `releaseTypeBadgeColor` or the card falls back to a `'—'` placeholder
+ * (the card requires BOTH `releaseType && releaseTypeBadgeColor` to paint a
+ * colored badge).
+ *
+ * Mapping mirrors the visual hierarchy operators expect at a glance:
+ *   major  → error   (red, breaking change)
+ *   minor  → cyan    (accent, feature)
+ *   patch  → success (green, safe bump)
+ *   beta/alpha → warning (yellow, preview)
+ *
+ * (Lifted from the hub so every embedder — not just the hub — gets the rich
+ * card metadata. The admin form's `releaseTypeOptions.color` array uses a
+ * different color vocabulary — different concern; don't unify here.)
+ */
+export type ReleaseType = 'major' | 'minor' | 'patch' | 'beta' | 'alpha';
+export type ReleaseTypeBadgeColor = 'error' | 'cyan' | 'success' | 'warning';
+/**
+ * Accepts a wider input type than `ReleaseType` because list-API rows can
+ * carry legacy / unenforced `release_type` values. Returns `undefined` for
+ * unknown values — the card guards on `releaseType && releaseTypeBadgeColor`
+ * to decide whether to render a colored badge or fall back to an em-dash, so
+ * an undefined return is the correct failure mode (badge hidden), not a crash.
+ */
+export declare function releaseTypeToBadgeColor(t: ReleaseType | string | null | undefined): ReleaseTypeBadgeColor | undefined;
+//# sourceMappingURL=release-badge.d.ts.map

package/dist/utils/release-badge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"release-badge.d.ts","sourceRoot":"","sources":["../../src/utils/release-badge.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,MAAM,WAAW,GAAG,OAAO,GAAG,OAAO,GAAG,OAAO,GAAG,MAAM,GAAG,OAAO,CAAA;AACxE,MAAM,MAAM,qBAAqB,GAAG,OAAO,GAAG,MAAM,GAAG,SAAS,GAAG,SAAS,CAAA;AAE5E;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CACrC,CAAC,EAAE,WAAW,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,GACzC,qBAAqB,GAAG,SAAS,CAcnC"}

package/dist/utils/release-cover.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Single source of truth for the ProductReleaseCard cover-image fallback
+ * priority. Every surface that renders a `<ProductReleaseCard>` (catalog row,
+ * chat-inline dispatcher, chat wrapper) computes the cover via this helper —
+ * adding a new fallback source or reordering the priority is ONE edit.
+ *
+ * **Priority** (intentional):
+ *   1. `featured_image` — editor-curated cover, always wins.
+ *   2. `highlight_video_thumbnail` — AI-generated highlight reel thumb.
+ *   3. `main_video_thumbnail` — full-release video thumb.
+ *   4. `og_image_url` — SEO fallback.
+ *   5. `null` — caller renders the entity placeholder.
+ *
+ * **`hasVideoCover`** fires ONLY when the active cover is a video thumb
+ * (priority 2 or 3). When the editor configured a still `featured_image`, a
+ * Play overlay would be misleading and is suppressed.
+ *
+ * Operator note: `||` (not `??`) so empty-string DB values fall through to the
+ * next fallback rather than rendering `<Image src="">`.
+ *
+ * (Lifted from the hub so the rich `buildProductReleaseCardProps` works in the
+ * lib / any embedder, not just the hub.)
+ */
+export interface ReleaseCoverSource {
+    featured_image?: string | null;
+    highlight_video_thumbnail?: string | null;
+    main_video_thumbnail?: string | null;
+    og_image_url?: string | null;
+}
+export interface ReleaseCoverResult {
+    cover: string | null;
+    hasVideoCover: boolean;
+}
+export declare function resolveReleaseCover(r: ReleaseCoverSource): ReleaseCoverResult;
+//# sourceMappingURL=release-cover.d.ts.map

package/dist/utils/release-cover.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"release-cover.d.ts","sourceRoot":"","sources":["../../src/utils/release-cover.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,MAAM,WAAW,kBAAkB;IACjC,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC9B,yBAAyB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACzC,oBAAoB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACpC,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAC7B;AAED,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;IACpB,aAAa,EAAE,OAAO,CAAA;CACvB;AAED,wBAAgB,mBAAmB,CAAC,CAAC,EAAE,kBAAkB,GAAG,kBAAkB,CAS7E"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@flamingo-stack/openframe-frontend-core",
-  "version": "0.0.218",
+  "version": "0.0.219",
   "description": "Shared design system and components for all Flamingo platforms",
   "type": "module",
   "main": "./dist/index.js",
@@ -267,6 +267,7 @@
     "nats.ws": "^1.30.3",
     "next-themes": "^0.2.1",
     "react-aria-components": "^1.11.0",
+    "react-colorful": "^5.7.0",
     "react-datepicker": "^8.7.0",
     "react-day-picker": "^9.8.1",
     "react-device-detect": "^2.2.3",

package/src/components/chat/chat-container.tsx

@@ -5,7 +5,7 @@ import { Button } from "../ui/button"
 import { PlusCircleIcon } from "../plus-circle-icon"
 import { XmarkIcon } from "../icons-v2-generated/signs-and-symbols/xmark-icon"
 import { Chevron02LeftIcon } from "../icons-v2-generated"
-import { TicketStatusTag } from "../ui/ticket-status-tag"
+import { TicketStatusTag, resolveStatusTagProps } from "../ui/ticket-status-tag"
 import type { ConnectionIndicatorProps, ChatContainerProps, ChatHeaderProps } from "./types"
 
 const ConnectionIndicator: React.FC<ConnectionIndicatorProps> = ({ status }) => {
@@ -156,7 +156,16 @@ const ChatHeader = React.forwardRef<HTMLDivElement, ChatHeaderProps>(
                     <div className="text-h6 text-ods-text-secondary truncate" title={typeof ticketInfo.meta === 'string' ? ticketInfo.meta : undefined}>{ticketInfo.meta}</div>
                   )}
                 </div>
-                {ticketInfo.status && <TicketStatusTag status={ticketInfo.status} />}
+                {(ticketInfo.status || ticketInfo.statusName) && (
+                  <TicketStatusTag
+                    {...resolveStatusTagProps({
+                      status: ticketInfo.status,
+                      statusKind: ticketInfo.statusKind,
+                      statusName: ticketInfo.statusName,
+                      statusColor: ticketInfo.statusColor,
+                    })}
+                  />
+                )}
               </div>
             </>
           )}

package/src/components/chat/embeddable-chat.tsx

@@ -59,6 +59,7 @@ import { renderChatInlineEntityCard } from './entity-cards/dispatch'
 import type { ChatCardDispatchExtras } from './entity-cards/dispatch'
 
 import { useRequiredChatRuntime } from '../../contexts/chat-runtime-context'
+import { useRouter } from '../../embed-shims/next-navigation'
 import { type ChatSource, type UseSseChatAdapterOptions } from './hooks/use-sse-chat-adapter'
 import {
   useUnifiedChat,
@@ -81,7 +82,7 @@ import { handleChatNavClick } from './utils/nav-click-handler'
 import { computeIsNewTab, newTabAnchorAttrs } from './utils/nav-anchor-props'
 import { resolveHrefForRuntime } from './utils/chat-nav-resolution'
 import { ChatPanelContext, type ChatPanelHandle } from './chat-panel-context'
-import { resolveSourceRowCTA } from './utils/source-row-cta'
+import { resolveSourceRowCTA, sourceRowCtxFromRuntime } from './utils/source-row-cta'
 import { chatChipClass } from './utils/chip-styles'
 import { getIconComponent } from './utils/icon-registry'
 import { resolveOnboardingIcon } from './utils/onboarding-icons'
@@ -293,6 +294,7 @@ function SourceChip({
   onDiscuss?: (ref: ChatRef) => void
 }) {
   const runtime = useRequiredChatRuntime()
+  const router = useRouter()
   // Single CTA resolver — same icon, same href chain, same ChatRef
   // synthesis the inline card and search-result paths use.
   const cta = resolveSourceRowCTA(
@@ -305,7 +307,7 @@ function SourceChip({
       targetPlatform: src.targetPlatform ?? null,
       path: src.path,
     },
-    { baseRoute, chipBasePlatform, currentPlatform: runtime.source },
+    sourceRowCtxFromRuntime(runtime, { baseRoute, chipBasePlatform }),
   )
   const Icon = cta.icon
   const icon = <Icon className="h-3.5 w-3.5" />
@@ -329,7 +331,7 @@ function SourceChip({
           targetPlatform: item.targetPlatform ?? null,
           path: item.path,
         },
-        { baseRoute, chipBasePlatform, currentPlatform: runtime.source },
+        sourceRowCtxFromRuntime(runtime, { baseRoute, chipBasePlatform }),
       )
       const ItemIcon = itemCta.icon
       return {
@@ -403,7 +405,7 @@ function SourceChip({
   // Single close model: matches `ChatCardNavWrap` for inline cards.
   const buildClickHandler = (href: string, path: string | null | undefined, targetPlatform: string | null, isNewTab: boolean) =>
     (e: React.MouseEvent<HTMLAnchorElement>) => {
-      const handled = handleChatNavClick(e, runtime, { href, path, targetPlatform })
+      const handled = handleChatNavClick(e, runtime, { href, path, targetPlatform }, router.push)
       if (handled && !isNewTab && onClose) onClose()
     }
 
@@ -585,7 +587,9 @@ function EmbeddableChatInner({
   // we don't double-up with the host's behaviour.
   const shellLess = shell === 'none'
   const runtime = useRequiredChatRuntime()
-  const source = runtime.source as DocSource
+  // Optional on embedders (platform-agnostic); '' is a harmless sentinel for the
+  // `ask-ai:open-with-ref` event filter below. (DocSource is a `string` alias.)
+  const source = (runtime.source ?? '') as DocSource
   const commandsUrl = runtime.endpoints.commandsUrl
   // Server-resolved identity — drives the greeting first-name AND the
   // attachment capability flag. Single source of truth: the chat-identity
@@ -832,7 +836,12 @@ function EmbeddableChatInner({
     useChatAttachmentImageGallery()
 
   // Resolve base route. Hub default mapping: flamingo → /knowledge-base,
-  // anything else → /data-room. Embedders can override per platform.
+  // anything else → /data-room. Embedders override per platform. An embedder that
+  // doesn't host an in-app doc viewer should NOT pass an empty baseRoute (that just
+  // falls back to the platform default here) — instead it sets a truthy baseRoute +
+  // `chipBasePlatform` so doc chips with no externalUrl resolve cross-platform to that
+  // platform's public knowledge hub (`getBaseUrl(chipBasePlatform)/knowledge-base/…`),
+  // exactly like the hub's openframe config (baseRoute:'/', chipBasePlatform:'flamingo').
   const resolvedBaseRoute =
     baseRoute || (source === 'flamingo' ? '/knowledge-base' : '/data-room')
 

package/src/components/chat/entity-cards/chat-ticket-item.tsx

@@ -3,7 +3,7 @@
 import * as React from 'react'
 import { cn } from '../../../utils/cn'
 import { ChevronRight } from 'lucide-react'
-import { TicketStatusTag, resolveTicketStatus } from '../../ui/ticket-status-tag'
+import { TicketStatusTag, resolveStatusTagProps, resolveTicketStatus } from '../../ui/ticket-status-tag'
 import { Tag } from '../../ui/tag'
 import { WrenchIcon } from '../../icons-v2-generated/household/wrench-icon'
 
@@ -20,6 +20,10 @@ export interface ChatTicketItemData {
    *  When omitted, the canonical status's default label is used
    *  ("Resolved" for closed, "Active" for open, etc.). */
   statusLabel?: string
+  /** Lifecycle (custom-status) kind — drives canonical-vs-color styling. */
+  statusKind?: string
+  /** Lifecycle (custom-status) hex color, used when the kind isn't canonical. */
+  statusColor?: string
   category?: string
   timeAgo?: string
   /** When set, renders a "Linked work" chip with a wrench icon next to
@@ -38,7 +42,13 @@ export interface ChatTicketItemProps extends Omit<React.ButtonHTMLAttributes<HTM
 
 const ChatTicketItem = React.forwardRef<HTMLButtonElement, ChatTicketItemProps>(
   ({ className, ticket, onClick, ...props }, ref) => {
-    const isResolved = resolveTicketStatus(ticket.status) === 'RESOLVED'
+    const statusTagProps = resolveStatusTagProps({
+      status: ticket.status,
+      statusKind: ticket.statusKind,
+      statusName: ticket.statusLabel,
+      statusColor: ticket.statusColor,
+    })
+    const isResolved = ticket.statusKind === 'RESOLVED' || resolveTicketStatus(ticket.status) === 'RESOLVED'
 
     const subtitle = [ticket.ticketNumber, ticket.category, ticket.timeAgo]
       .filter(Boolean)
@@ -93,7 +103,7 @@ const ChatTicketItem = React.forwardRef<HTMLButtonElement, ChatTicketItemProps>(
             className="shrink-0 hidden sm:inline-flex"
           />
         )}
-        <TicketStatusTag status={ticket.status} label={ticket.statusLabel} />
+        {(statusTagProps.status || statusTagProps.label) && <TicketStatusTag {...statusTagProps} />}
 
         <div className="flex items-center justify-center shrink-0 size-12 rounded-md bg-ods-card border border-ods-border">
           <ChevronRight className="size-6 text-ods-text-secondary" />

package/src/components/chat/entity-cards/dispatch.tsx

@@ -31,10 +31,11 @@
 
 import React, { type ReactNode } from 'react'
 import { useRequiredChatRuntime } from '../../../contexts/chat-runtime-context'
+import { useRouter } from '../../../embed-shims/next-navigation'
 import type { ChatRef } from '../chat-ref.types'
 import { useChatCardItem } from '../hooks/use-chat-card-item'
 import { handleChatNavClick } from '../utils/nav-click-handler'
-import { resolveSourceRowCTA, resolveSourceIcon } from '../utils/source-row-cta'
+import { resolveSourceRowCTA, resolveSourceIcon, sourceRowCtxFromRuntime } from '../utils/source-row-cta'
 import { resolveHrefForRuntime } from '../utils/chat-nav-resolution'
 import {
   computeIsNewTab,
@@ -866,6 +867,7 @@ function ChatCardNavWrap({
   children: ReactNode
 }) {
   const runtime = useRequiredChatRuntime()
+  const router = useRouter()
   const panel = useChatPanel()
   const onClickCapture = (e: React.MouseEvent<HTMLElement>) => {
     if (!href) return
@@ -879,7 +881,7 @@ function ChatCardNavWrap({
     if (targetEl?.closest?.('button')) return
     if (!targetEl?.closest?.('a')) return
 
-    const handled = handleChatNavClick(e, runtime, { href, path, targetPlatform })
+    const handled = handleChatNavClick(e, runtime, { href, path, targetPlatform }, router.push)
     if (!handled) return
     // Modifier-clicks fall through (handled=false) without stopPropagation
     // so ancestor telemetry handlers still see the bubble.
@@ -950,11 +952,7 @@ export function ChatCardLoader({
             ? (chatRef.metadata.path as string)
             : null,
       },
-      {
-        baseRoute,
-        chipBasePlatform,
-        currentPlatform: runtime.source,
-      },
+      sourceRowCtxFromRuntime(runtime, { baseRoute, chipBasePlatform }),
     )
     const finalHref = cta.href ? resolveHrefForRuntime(cta.href, runtime) : null
     return {

package/src/components/chat/entity-cards/index.ts

@@ -36,6 +36,14 @@ export {
   type ProductReleaseCardSize,
   type ProductReleaseCardAnchorProps,
 } from './product-release-card'
+// Card-prop builders: `defaultBuildProductReleaseCardProps` (sm chat default) +
+// `buildProductReleaseCardProps` (RICH lg builder — the ProductReleasesView
+// default; lifted from the hub so embedders get the full metadata grid).
+export {
+  defaultBuildProductReleaseCardProps,
+  buildProductReleaseCardProps,
+  type ProductReleaseCardDerivedProps,
+} from './product-release-card-defaults'
 
 // Refactored pure-presentation cards
 export { BlogCard, BlogCardSkeleton, type BlogCardProps } from './blog-card'

package/src/components/chat/entity-cards/onboarding-guide-card.tsx

@@ -18,6 +18,7 @@
 
 import React from 'react'
 import Image from '../../../embed-shims/next-image'
+import Link from '../../../embed-shims/next-link'
 import { Clock, ExternalLink, GraduationCap, Play } from 'lucide-react'
 import { cn } from '../../../utils/cn'
 import { BlogImagePlaceholder } from './blog-image-placeholder'
@@ -178,10 +179,11 @@ export function OnboardingGuideCard({
         : ''
 
     return (
-      <a
+      <Link
         href={href}
         target={target}
         rel={rel}
+        prefetch={false}
         className={cn(
           'group block no-underline bg-ods-system-greys-black',
           'border border-ods-border rounded-lg overflow-hidden',
@@ -253,7 +255,7 @@ export function OnboardingGuideCard({
             ]}
           />
         </div>
-      </a>
+      </Link>
     )
   }
 
@@ -269,7 +271,7 @@ export function OnboardingGuideCard({
       author,
     ].filter((s): s is string => typeof s === 'string' && s.length > 0)
     return (
-      <a href={href} target={target} rel={rel} className={cn(COMPACT_CARD_OUTER, className)}>
+      <Link href={href} target={target} rel={rel} prefetch={false} className={cn(COMPACT_CARD_OUTER, className)}>
         <span className={COMPACT_CARD_IMAGE_SLOT}>
           {compactCover ? (
             <Image
@@ -311,7 +313,7 @@ export function OnboardingGuideCard({
         <span className="flex shrink-0 items-center self-start h-5 text-ods-text-secondary">
           <ExternalLink className="w-3.5 h-3.5" />
         </span>
-      </a>
+      </Link>
     )
   }
 
@@ -320,10 +322,11 @@ export function OnboardingGuideCard({
   const summary = (guide.video_summary || guide.content || '').trim()
 
   return (
-    <a
+    <Link
       href={href}
       target={target}
       rel={rel}
+      prefetch={false}
       className={cn(
         `flex items-start gap-3 rounded-md border border-ods-border bg-ods-card hover:border-ods-accent transition-colors ${t.padding}`,
         className,
@@ -347,6 +350,6 @@ export function OnboardingGuideCard({
           </span>
         )}
       </span>
-    </a>
+    </Link>
   )
 }

package/src/components/chat/entity-cards/product-release-card-defaults.ts

@@ -13,6 +13,12 @@
  */
 
 import { formatReleaseDate } from '../../../utils/date-formatters'
+import { resolveReleaseCover } from '../../../utils/release-cover'
+import {
+  releaseTypeToBadgeColor,
+  type ReleaseType,
+  type ReleaseTypeBadgeColor,
+} from '../../../utils/release-badge'
 
 interface ReleaseLike {
   release_date?: string | null
@@ -30,9 +36,15 @@ interface DerivedSmProps {
   formattedDate: string
 }
 
-/** Pick the first usable image URL from the row's cover-candidate
- *  fields. Order mirrors the hub's `resolveReleaseCover` precedence
- *  (video thumbnail wins when a video is set, then featured/og). */
+/** Pick the first usable image URL from the row's cover-candidate fields.
+ *  This is an INTENTIONALLY SIMPLER sm-subset heuristic — it does NOT mirror the
+ *  hub's `resolveReleaseCover`: when a video URL is set this prefers
+ *  `main_video_thumbnail` (then `highlight_video_thumbnail`) over `featured_image`,
+ *  and keys `hasVideoCover` off `main_video_url`/`youtube_url` (fields the hub
+ *  helper never reads). It's the builder-less default (chat sm cards + any embedder
+ *  that doesn't pass its own `buildCardProps` to `ProductReleasesView`); hosts
+ *  wanting hub-identical covers pass their richer builder (the hub does — see
+ *  the hub's `product-release-card-props.ts` / `resolveReleaseCover`). */
 function pickCover(item: ReleaseLike): string | null {
   const hasVideo = Boolean(item.main_video_url || item.youtube_url)
   if (hasVideo) {
@@ -55,3 +67,80 @@ export function defaultBuildProductReleaseCardProps(item: unknown): DerivedSmPro
     formattedDate: row.release_date ? formatReleaseDate(row.release_date) : '',
   }
 }
+
+// ───────────────────────────────────────────────────────────────────────────
+// RICH (lg-variant) builder — the DEFAULT for <ProductReleasesView>.
+// ───────────────────────────────────────────────────────────────────────────
+
+/** Minimal shape the RICH builder reads. List-API rows from `/api/releases`
+ *  carry all of these; `release_type` is widened to `string` to absorb legacy
+ *  non-enum values (the badge helper returns `undefined` for unknowns, which
+ *  the card guards correctly with an em-dash placeholder). */
+interface RichReleaseLike {
+  release_date?: string | null
+  release_type?: string | null
+  release_status?: 'alpha' | 'beta' | 'stable' | 'deprecated' | null
+  view_count?: number | null
+  author?: { full_name: string; avatar_url: string | null; job_title: string | null } | null
+  features_added?: unknown[] | null
+  bugs_fixed?: unknown[] | null
+  improvements?: unknown[] | null
+  breaking_changes?: unknown[] | null
+  featured_image?: string | null
+  highlight_video_thumbnail?: string | null
+  main_video_thumbnail?: string | null
+  og_image_url?: string | null
+}
+
+export interface ProductReleaseCardDerivedProps {
+  coverImage: string | null
+  hasVideoCover: boolean
+  formattedDate: string
+  releaseType: ReleaseType | undefined
+  releaseStatus: 'alpha' | 'beta' | 'stable' | 'deprecated' | undefined
+  releaseTypeBadgeColor: ReleaseTypeBadgeColor | undefined
+  viewCount: number
+  author: { full_name: string; avatar_url: string | null; job_title: string | null } | undefined
+  changelogCounts: { features: number; fixes: number; improvements: number; breaking: number }
+}
+
+const RELEASE_TYPE_ENUM: ReadonlySet<ReleaseType> = new Set(['major', 'minor', 'patch', 'beta', 'alpha'])
+
+/**
+ * The RICH `lg`-variant builder — populates the full metadata grid (Type /
+ * Status / author / view count / changelog counts) the `lg` `ProductReleaseCard`
+ * renders. This is the DEFAULT `buildCardProps` for `<ProductReleasesView>`, so
+ * embedders get the full card config-only. (Lifted from the hub; before this,
+ * the example fell back to the sm builder and the lg Type/Status/author cells
+ * rendered as em-dash placeholders.) The sm chat card keeps
+ * `defaultBuildProductReleaseCardProps` — it ignores the lg-only fields.
+ */
+export function buildProductReleaseCardProps(item: unknown): ProductReleaseCardDerivedProps {
+  const release = (item ?? {}) as RichReleaseLike
+  const { cover, hasVideoCover } = resolveReleaseCover(release)
+  const rawType = release.release_type
+  const releaseType: ReleaseType | undefined =
+    rawType && RELEASE_TYPE_ENUM.has(rawType as ReleaseType) ? (rawType as ReleaseType) : undefined
+  return {
+    coverImage: cover,
+    hasVideoCover,
+    formattedDate: release.release_date ? formatReleaseDate(release.release_date) : '',
+    releaseType,
+    releaseStatus: release.release_status ?? undefined,
+    releaseTypeBadgeColor: releaseTypeToBadgeColor(releaseType),
+    viewCount: release.view_count ?? 0,
+    author: release.author
+      ? {
+          full_name: release.author.full_name,
+          avatar_url: release.author.avatar_url,
+          job_title: release.author.job_title,
+        }
+      : undefined,
+    changelogCounts: {
+      features: release.features_added?.length ?? 0,
+      fixes: release.bugs_fixed?.length ?? 0,
+      improvements: release.improvements?.length ?? 0,
+      breaking: release.breaking_changes?.length ?? 0,
+    },
+  }
+}

package/src/components/chat/entity-cards/use-entity-card-link.ts

@@ -25,6 +25,7 @@
 
 import { useMemo } from 'react'
 import { useChatRuntime } from '../../../contexts/chat-runtime-context'
+import { computeIsNewTab } from '../utils/nav-anchor-props'
 
 export interface UseEntityCardLinkArgs {
   href: string
@@ -58,7 +59,14 @@ export function useEntityCardLink({
         rel ?? (target === '_blank' ? 'noopener noreferrer' : undefined)
       return { target, rel: safeRel }
     }
-    const newTab = runtime?.navigation.decideNewTab?.({ href, targetPlatform }) ?? false
+    // Use the UNIFIED new-tab decision so the rendered anchor's target/rel ALWAYS
+    // agrees with the click handler (executeNavigation also calls computeIsNewTab) —
+    // including the embed-mode short-circuit + the origin/platform fallback.
+    // Previously this used `decideNewTab ?? false`, which diverged from the click
+    // when decideNewTab was unwired (embed mode rendered a same-tab anchor that
+    // clicked into a new tab). Hub behavior is unchanged: it wires decideNewTab,
+    // which computeIsNewTab consumes identically.
+    const newTab = runtime ? computeIsNewTab(runtime, href, targetPlatform ?? null) : false
     return newTab
       ? { target: '_blank' as const, rel: 'noopener noreferrer' as const }
       : { target: undefined, rel: undefined }

package/src/components/chat/hooks/.use-sse-chat-adapter.md

@@ -31,4 +31,4 @@ const chatState = useSseChatAdapter({
 const { messages, sendMessage, isStreaming, streamingPhase } = chatState
 ```
 
-> **Note:** `source` is read automatically from `ChatRuntimeContext` — no parameter needed. If `runtime.source` is empty the hook throws immediately to surface misconfigured embedders early.
+> **Note:** `source` is read automatically from `ChatRuntimeContext` — no parameter needed. It is optional: an empty `source` falls back to a stable constant (`DEFAULT_CHAT_SOURCE`) for the localStorage history namespace and is never sent on the wire (the hub resolves source server-side).