@flamingo-stack/openframe-frontend-core 0.0.594 → 0.0.595

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;AAWH;;;;iEAIiE;AACjE,wBAAgB,uBAAuB,CAAC,cAAc,EAAE,MAAM,GAAG,MAAM,CAKtE;AA2DD;;;;;;;;;;;;;;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,CAKtE;AAmED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,YAAY,CAAC,cAAc,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,EAAE,IAAI,SAAK,GAAG,MAAM,GAAG,IAAI,CAa5F"}

package/dist/utils/source-icons.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"source-icons.d.ts","sourceRoot":"","sources":["../../src/utils/source-icons.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,6EAA6E;AAC7E,eAAO,MAAM,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAmDpD,CAAC;AAEF;;6DAE6D;AAC7D,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAGxF;AAED;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,sBAAsB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAyDzD,CAAC;AAEF;;kEAEkE;AAClE,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEtD;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,eAAO,MAAM,iCAAiC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAmDpE,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,6BAA6B,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAEjF"}
+{"version":3,"file":"source-icons.d.ts","sourceRoot":"","sources":["../../src/utils/source-icons.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,6EAA6E;AAC7E,eAAO,MAAM,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAoDpD,CAAC;AAEF;;6DAE6D;AAC7D,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAGxF;AAED;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,sBAAsB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CA0DzD,CAAC;AAEF;;kEAEkE;AAClE,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEtD;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,eAAO,MAAM,iCAAiC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAoDpE,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,6BAA6B,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAEjF"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@flamingo-stack/openframe-frontend-core",
-  "version": "0.0.594",
+  "version": "0.0.595",
   "description": "Shared design system and components for all Flamingo platforms",
   "type": "module",
   "main": "./dist/index.js",

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

@@ -619,12 +619,11 @@ function SlackChatCard({
 }
 
 /**
- * Generic REF-ONLY card — for types with no `?ids=` list endpoint whose
- * ChatRef already carries everything the card shows (title / preview /
- * url). Same posture as `video`: nothing to fetch, so no skeleton and no
- * `contentRefType`. The per-type glyph is the only thing that varies.
+ * Generic glyph card for ChatRef-shaped items (title / preview / url) whose
+ * only per-type variation is the leading icon — used by the ref-hydrated
+ * product-hub objects (design docs, tenants) and the people-hub feeds.
  */
-function RefOnlyChatCard({
+function GlyphChatCard({
   chatRef,
   icon,
   isNewTab,
@@ -1343,26 +1342,57 @@ const GITHUB_CARD_CONFIGS: Record<string, GitHubCardConfig> = {
   github_pr_review: { label: 'GitHub review', kind: 'pr_review' },
   github_pr_review_public: { label: 'GitHub review (public)', kind: 'pr_review' },
 };
-interface RefOnlyCardConfig {
+interface GlyphCardConfig {
   label: string;
   icon: () => React.ReactNode;
 }
-/** Hub-internal row types whose mapper declares `listApi: () => null` —
- *  design docs + the tenant roster (product-hub), the two people-hub
- *  employee feeds. Adding one = one line here + the `source-icons.ts`
- *  label / icon / documentType entries. */
-const REF_ONLY_CARD_CONFIGS: Record<string, RefOnlyCardConfig> = {
+/** Product-hub internal objects hydrated by their per-object card routes
+ *  (`/api/design-docs`, `/api/openframe-tenants` — ChatRef-shaped items,
+ *  same preset as github / slack). Adding one = one line here + the
+ *  `list-url.ts` builder + the `source-icons.ts` label / icon / type entries. */
+const REF_GLYPH_CARD_CONFIGS: Record<string, GlyphCardConfig> = {
   design_doc: { label: 'Design doc', icon: () => <FileContentIcon size={24} /> },
   openframe_tenant: { label: 'OpenFrame tenant', icon: () => <BuildingsIcon size={24} /> },
+};
+function refGlyphRegistryEntries(): Record<string, ChatCardRegistryEntry> {
+  return registryEntries(REF_GLYPH_CARD_CONFIGS, (cfg, docType) =>
+    refHydratedEntry(docType, cfg.label, (displayRef, opts) => (
+      <GlyphChatCard chatRef={displayRef} icon={cfg.icon()} isNewTab={opts.isNewTab} discuss={opts.discuss} />
+    )),
+  );
+}
+
+/** People-hub employee feeds hydrate from their EXISTING list APIs
+ *  (`/api/what-i-shipped?ids=`, `/api/how-i-work?ids=`) — entry-shaped rows
+ *  (title / summary / author), not ChatRefs, hence the bespoke row→display
+ *  mapping (the FAQ precedent). The destination comes from the ref (the
+ *  server-resolved entry url) or, on a bare marker, the host's
+ *  `composeContentUrl` seam for the type. */
+function fetchedEmployeeEntryDisplayRef(item: unknown, chatRef: ChatRef): ChatRef {
+  const it = item as { title?: unknown; summary?: unknown; author?: { full_name?: unknown } | null };
+  const title = typeof it?.title === 'string' && it.title.trim().length > 0 ? it.title.trim() : chatRef.title;
+  const author = typeof it?.author?.full_name === 'string' ? it.author.full_name.trim() : '';
+  const summary = typeof it?.summary === 'string' ? it.summary.trim() : '';
+  const preview = [author, summary].filter(x => x.length > 0).join(' · ');
+  return { ...chatRef, title, preview: preview.length > 0 ? preview : chatRef.preview };
+}
+const EMPLOYEE_ENTRY_CARD_CONFIGS: Record<string, GlyphCardConfig> = {
   what_i_shipped: { label: 'What I Shipped', icon: () => <Rocket02Icon size={24} /> },
   how_i_work: { label: 'How I Work', icon: () => <ClipboardListIcon size={24} /> },
 };
-function refOnlyRegistryEntries(): Record<string, ChatCardRegistryEntry> {
-  return registryEntries(REF_ONLY_CARD_CONFIGS, cfg => ({
+function employeeEntryRegistryEntries(): Record<string, ChatCardRegistryEntry> {
+  return registryEntries(EMPLOYEE_ENTRY_CARD_CONFIGS, (cfg, docType) => ({
     label: cfg.label,
     bareInline: true,
-    render: (_item, chatRef, opts) => (
-      <RefOnlyChatCard chatRef={chatRef} icon={cfg.icon()} isNewTab={opts.isNewTab} discuss={opts.discuss} />
+    contentRefType: docType,
+    skeleton: () => <MingoInfoCardSkeleton />,
+    render: (item, chatRef, opts) => (
+      <GlyphChatCard
+        chatRef={fetchedEmployeeEntryDisplayRef(item, chatRef)}
+        icon={cfg.icon()}
+        isNewTab={opts.isNewTab}
+        discuss={opts.discuss}
+      />
     ),
   }));
 }
@@ -1479,7 +1509,8 @@ const CHAT_CARD_REGISTRY: Record<string, ChatCardRegistryEntry> = {
     ),
   },
   // ───────── ref-only types (no list endpoint; the ChatRef IS the card) ─────────
-  ...refOnlyRegistryEntries(),
+  ...refGlyphRegistryEntries(),
+  ...employeeEntryRegistryEntries(),
   slack_message: refHydratedEntry('slack_message', 'Slack message', (displayRef, opts) => (
     <SlackChatCard chatRef={displayRef} isNewTab={opts.isNewTab} discuss={opts.discuss} />
   )),

package/src/utils/__tests__/list-url.test.ts

@@ -48,6 +48,12 @@ const BASELINE: Record<string, string> = {
   profit_loss: '/api/financials/profit-loss?ids=a,b',
   balance_sheet: '/api/financials/balance-sheet?ids=a,b',
   cash_flow: '/api/financials/cash-flow?ids=a,b',
+  // 2026-09: hub-internal chat sources (people-hub feeds via their list APIs,
+  // product-hub design docs + tenants via per-object card routes).
+  what_i_shipped: '/api/what-i-shipped?ids=a,b&limit=2',
+  how_i_work: '/api/how-i-work?ids=a,b&limit=2',
+  design_doc: '/api/design-docs?ids=a,b',
+  openframe_tenant: '/api/openframe-tenants?ids=a,b',
 };
 
 describe('buildListUrl — byte parity with the hub mappers', () => {

package/src/utils/list-url.ts

@@ -104,6 +104,14 @@ const BUILDERS: Record<string, (ids: string[], base: string) => string> = {
   profit_loss: (ids, b) => `${b}/api/financials/profit-loss?ids=${ids.join(',')}`,
   balance_sheet: (ids, b) => `${b}/api/financials/balance-sheet?ids=${ids.join(',')}`,
   cash_flow: (ids, b) => `${b}/api/financials/cash-flow?ids=${ids.join(',')}`,
+  // People-hub employee feeds — their EXISTING list APIs (`?ids=`, also feeding
+  // the related-content rail + author page), entry-shaped rows.
+  what_i_shipped: (ids, b) => `${b}/api/what-i-shipped?ids=${ids.join(',')}&limit=${ids.length}`,
+  how_i_work: (ids, b) => `${b}/api/how-i-work?ids=${ids.join(',')}&limit=${ids.length}`,
+  // Product-hub internal objects — per-object card-hydration routes
+  // (ChatRef-shaped items, `handleEntityCardList`), like github / slack.
+  design_doc: (ids, b) => `${b}/api/design-docs?ids=${ids.join(',')}`,
+  openframe_tenant: (ids, b) => `${b}/api/openframe-tenants?ids=${ids.join(',')}`,
 };
 
 /**

package/src/utils/source-icons.ts

@@ -39,6 +39,7 @@ export const SOURCE_ICON_NAMES: Record<string, string> = {
   events: 'calendar',
   podcasts: 'headphones',
   'customer-interviews': 'users',
+  faqs: 'info',
 
   // Financials
   'investor-updates': 'mail',
@@ -112,6 +113,7 @@ export const SOURCE_LABELS_BY_TABLE: Record<string, string> = {
   events: 'Events',
   podcasts: 'Podcasts',
   'customer-interviews': 'Customer Interviews',
+  faqs: 'FAQs',
 
   // Financials
   'investor-updates': 'Investor Updates',
@@ -199,6 +201,7 @@ export const DEFAULT_DOCUMENT_TYPE_TO_TABLE_ID: Record<string, string> = {
   event: 'events',
   podcast: 'podcasts',
   customer_interview: 'customer-interviews',
+  faq: 'faqs',
 
   // Financials
   investor_update: 'investor-updates',