@flamingo-stack/openframe-frontend-core 0.0.736 → 0.0.737

package/dist/{knowledge-F4YFQT3G.cjs → knowledge-3ZASPWMF.cjs}

@@ -8,7 +8,7 @@ var _chunkII4QMH26cjs = require('./chunk-II4QMH26.cjs');
 var _chunkKHXZFLINcjs = require('./chunk-KHXZFLIN.cjs');
 
 
-var _chunkOJUMVOMPcjs = require('./chunk-OJUMVOMP.cjs');
+var _chunkE2JCZU36cjs = require('./chunk-E2JCZU36.cjs');
 require('./chunk-ZJNYWNCB.cjs');
 require('./chunk-3HPB4H4C.cjs');
 require('./chunk-L4ZNR5V7.cjs');
@@ -21,10 +21,10 @@ require('./chunk-A6P6DHEZ.cjs');
 require('./chunk-MZ4KBSH7.cjs');
 require('./chunk-MGW5DO6P.cjs');
 require('./chunk-YUMFVQIN.cjs');
-require('./chunk-T27CVQBO.cjs');
+require('./chunk-4FJZ7RJD.cjs');
 
 
-var _chunkOV6BGMELcjs = require('./chunk-OV6BGMEL.cjs');
+var _chunkVL4JKXU2cjs = require('./chunk-VL4JKXU2.cjs');
 require('./chunk-ZRYKDN2J.cjs');
 require('./chunk-HZJRERJW.cjs');
 require('./chunk-DUXLZPMJ.cjs');
@@ -1905,10 +1905,10 @@ function KnowledgeScreen(_props) {
   const cast = _chunkII4QMH26cjs.useProductDemoCast.call(void 0, );
   const fixture = _react.useMemo.call(void 0, () => buildKnowledgeFixture(cast), [cast]);
   return /* @__PURE__ */ _jsxruntime.jsx.call(void 0, "div", { className: "h-full bg-ods-bg", children: /* @__PURE__ */ _jsxruntime.jsx.call(void 0, 
-    _chunkOJUMVOMPcjs.KnowledgeBaseArticleView,
+    _chunkE2JCZU36cjs.KnowledgeBaseArticleView,
     {
       ...fixture.article,
-      content: /* @__PURE__ */ _jsxruntime.jsx.call(void 0, _chunkOV6BGMELcjs.SimpleMarkdownRenderer, { content: fixture.content, textSize: "compact" })
+      content: /* @__PURE__ */ _jsxruntime.jsx.call(void 0, _chunkVL4JKXU2cjs.SimpleMarkdownRenderer, { content: fixture.content, textSize: "compact" })
     }
   ) });
 }

package/dist/{logs-GAYEGEZM.cjs → logs-E6Y54P6K.cjs}

@@ -16,7 +16,7 @@ var _chunkKHXZFLINcjs = require('./chunk-KHXZFLIN.cjs');
 
 
 
-var _chunkOJUMVOMPcjs = require('./chunk-OJUMVOMP.cjs');
+var _chunkE2JCZU36cjs = require('./chunk-E2JCZU36.cjs');
 require('./chunk-ZJNYWNCB.cjs');
 require('./chunk-3HPB4H4C.cjs');
 require('./chunk-L4ZNR5V7.cjs');
@@ -31,8 +31,8 @@ require('./chunk-MGW5DO6P.cjs');
 require('./chunk-YUMFVQIN.cjs');
 
 
-var _chunkT27CVQBOcjs = require('./chunk-T27CVQBO.cjs');
-require('./chunk-OV6BGMEL.cjs');
+var _chunk4FJZ7RJDcjs = require('./chunk-4FJZ7RJD.cjs');
+require('./chunk-VL4JKXU2.cjs');
 require('./chunk-ZRYKDN2J.cjs');
 require('./chunk-HZJRERJW.cjs');
 require('./chunk-DUXLZPMJ.cjs');
@@ -1886,7 +1886,7 @@ function entry(logId, minutesAgo, severity, toolType, device2, summary) {
     id: logId,
     logId,
     timestamp: displayTime(_chunkKHXZFLINcjs.demoMinutesAgo.call(void 0, minutesAgo)),
-    status: { label: severity, variant: _chunkOJUMVOMPcjs.logSeverityVariant.call(void 0, severity) },
+    status: { label: severity, variant: _chunkE2JCZU36cjs.logSeverityVariant.call(void 0, severity) },
     source: { name: toolType, toolType },
     device: device2,
     description: { title: summary }
@@ -1958,13 +1958,13 @@ var NO_FILTERS = {};
 var ACTION_COLUMNS = ["copy", "quickView", "open"];
 var BESIDE_DRAWER_HIDDEN = [...ACTION_COLUMNS, "tool", "source"];
 var logHref = () => "#";
-var copyAction = () => /* @__PURE__ */ _jsxruntime.jsx.call(void 0, _chunkOJUMVOMPcjs.LogCopyIconButton, {});
+var copyAction = () => /* @__PURE__ */ _jsxruntime.jsx.call(void 0, _chunkE2JCZU36cjs.LogCopyIconButton, {});
 function LogsScreen({ compact = false }) {
   const [dock, setDock] = _react.useState.call(void 0, null);
   const selected = LOGS_FIXTURE_SELECTED;
   return /* @__PURE__ */ _jsxruntime.jsxs.call(void 0, "div", { className: "flex h-full bg-ods-bg", children: [
     /* @__PURE__ */ _jsxruntime.jsx.call(void 0, "div", { className: "min-w-0 flex-1 overflow-clip", children: /* @__PURE__ */ _jsxruntime.jsx.call(void 0, 
-      _chunkOJUMVOMPcjs.LogsPageView,
+      _chunkE2JCZU36cjs.LogsPageView,
       {
         showHeader: false,
         className: "p-[var(--spacing-system-l)]",
@@ -1972,7 +1972,7 @@ function LogsScreen({ compact = false }) {
         onSearchChange: noop,
         onOpenFilters: noop,
         children: /* @__PURE__ */ _jsxruntime.jsx.call(void 0, 
-          _chunkOJUMVOMPcjs.LogsTableView,
+          _chunkE2JCZU36cjs.LogsTableView,
           {
             logs: LOGS_FIXTURE_ENTRIES,
             facets: LOGS_FIXTURE_FACETS,
@@ -1986,8 +1986,8 @@ function LogsScreen({ compact = false }) {
         )
       }
     ) }),
-    !compact && /* @__PURE__ */ _jsxruntime.jsx.call(void 0, "div", { ref: setDock, className: "relative w-[calc(400px+var(--spacing-system-m))] shrink-0", children: dock && /* @__PURE__ */ _jsxruntime.jsx.call(void 0, _chunkOJUMVOMPcjs.AppLayoutDrawerContainerContext.Provider, { value: dock, children: /* @__PURE__ */ _jsxruntime.jsx.call(void 0, 
-      _chunkOJUMVOMPcjs.LogDrawer,
+    !compact && /* @__PURE__ */ _jsxruntime.jsx.call(void 0, "div", { ref: setDock, className: "relative w-[calc(400px+var(--spacing-system-m))] shrink-0", children: dock && /* @__PURE__ */ _jsxruntime.jsx.call(void 0, _chunkE2JCZU36cjs.AppLayoutDrawerContainerContext.Provider, { value: dock, children: /* @__PURE__ */ _jsxruntime.jsx.call(void 0, 
+      _chunkE2JCZU36cjs.LogDrawer,
       {
         docked: true,
         isOpen: true,
@@ -1999,12 +1999,12 @@ function LogsScreen({ compact = false }) {
           { label: "Log ID", value: selected.logId },
           {
             label: "Source",
-            value: /* @__PURE__ */ _jsxruntime.jsx.call(void 0, _chunkOJUMVOMPcjs.ToolBadge, { toolType: _chunkT27CVQBOcjs.normalizeToolTypeWithFallback.call(void 0, selected.source.toolType) })
+            value: /* @__PURE__ */ _jsxruntime.jsx.call(void 0, _chunkE2JCZU36cjs.ToolBadge, { toolType: _chunk4FJZ7RJDcjs.normalizeToolTypeWithFallback.call(void 0, selected.source.toolType) })
           },
-          { label: "Device", value: _chunkOJUMVOMPcjs.logSourceLabels.call(void 0, selected.device).deviceName }
+          { label: "Device", value: _chunkE2JCZU36cjs.logSourceLabels.call(void 0, selected.device).deviceName }
         ],
         deviceCard: /* @__PURE__ */ _jsxruntime.jsx.call(void 0, 
-          _chunkOJUMVOMPcjs.DeviceCard,
+          _chunkE2JCZU36cjs.DeviceCard,
           {
             ...LOGS_FIXTURE_DEVICE,
             actions: {

package/dist/{policies-ZOVJCJWX.cjs → policies-LAV75B5B.cjs}

@@ -10,7 +10,7 @@ var _chunkKHXZFLINcjs = require('./chunk-KHXZFLIN.cjs');
 
 
 
-var _chunkOJUMVOMPcjs = require('./chunk-OJUMVOMP.cjs');
+var _chunkE2JCZU36cjs = require('./chunk-E2JCZU36.cjs');
 require('./chunk-ZJNYWNCB.cjs');
 require('./chunk-3HPB4H4C.cjs');
 require('./chunk-L4ZNR5V7.cjs');
@@ -23,8 +23,8 @@ require('./chunk-A6P6DHEZ.cjs');
 require('./chunk-MZ4KBSH7.cjs');
 require('./chunk-MGW5DO6P.cjs');
 require('./chunk-YUMFVQIN.cjs');
-require('./chunk-T27CVQBO.cjs');
-require('./chunk-OV6BGMEL.cjs');
+require('./chunk-4FJZ7RJD.cjs');
+require('./chunk-VL4JKXU2.cjs');
 require('./chunk-ZRYKDN2J.cjs');
 require('./chunk-HZJRERJW.cjs');
 require('./chunk-DUXLZPMJ.cjs');
@@ -1891,14 +1891,14 @@ var POLICIES = [
   policy("policy-local-admins", "No local admins", "No everyday account is a local administrator.", false, 0)
 ];
 var POLICIES_FIXTURE = {
-  summary: _chunkOJUMVOMPcjs.computePolicySummary.call(void 0, POLICIES),
+  summary: _chunkE2JCZU36cjs.computePolicySummary.call(void 0, POLICIES),
   rows: POLICIES.map((item) => ({
     id: item.id,
     name: item.name,
     description: item.description,
     critical: item.critical,
     severityLabel: item.critical ? "Critical" : "Low",
-    status: _chunkOJUMVOMPcjs.getPolicyTableStatus.call(void 0, item),
+    status: _chunkE2JCZU36cjs.getPolicyTableStatus.call(void 0, item),
     actions: [
       { label: "Policy Details", onClick: noop },
       { label: "Delete Policy", onClick: noop }
@@ -1912,16 +1912,16 @@ var POLICIES_FIXTURE = {
 var _jsxruntime = require('react/jsx-runtime');
 function PoliciesScreen({ compact = false }) {
   const table = /* @__PURE__ */ _jsxruntime.jsx.call(void 0, 
-    _chunkOJUMVOMPcjs.PoliciesTable,
+    _chunkE2JCZU36cjs.PoliciesTable,
     {
       rows: POLICIES_FIXTURE.rows,
       rowAsLink: true,
-      rightSlot: compact ? void 0 : /* @__PURE__ */ _jsxruntime.jsx.call(void 0, _chunkOJUMVOMPcjs.DataTable.RowCount, {}),
+      rightSlot: compact ? void 0 : /* @__PURE__ */ _jsxruntime.jsx.call(void 0, _chunkE2JCZU36cjs.DataTable.RowCount, {}),
       emptyMessage: "No policies found."
     }
   );
   return /* @__PURE__ */ _jsxruntime.jsxs.call(void 0, "div", { className: "flex h-full flex-col gap-[var(--spacing-system-l)] bg-ods-bg p-[var(--spacing-system-l)]", children: [
-    !compact && /* @__PURE__ */ _jsxruntime.jsx.call(void 0, _chunkOJUMVOMPcjs.PolicySummaryCards, { summary: POLICIES_FIXTURE.summary, now: POLICIES_FIXTURE.now }),
+    !compact && /* @__PURE__ */ _jsxruntime.jsx.call(void 0, _chunkE2JCZU36cjs.PolicySummaryCards, { summary: POLICIES_FIXTURE.summary, now: POLICIES_FIXTURE.now }),
     table
   ] });
 }

package/dist/{software-update-H4YE5GMJ.cjs → software-update-2CAL3AMJ.cjs}

@@ -15,7 +15,7 @@ var _chunkKHXZFLINcjs = require('./chunk-KHXZFLIN.cjs');
 
 
 
-var _chunkOJUMVOMPcjs = require('./chunk-OJUMVOMP.cjs');
+var _chunkE2JCZU36cjs = require('./chunk-E2JCZU36.cjs');
 require('./chunk-ZJNYWNCB.cjs');
 require('./chunk-3HPB4H4C.cjs');
 
@@ -30,8 +30,8 @@ require('./chunk-A6P6DHEZ.cjs');
 require('./chunk-MZ4KBSH7.cjs');
 require('./chunk-MGW5DO6P.cjs');
 require('./chunk-YUMFVQIN.cjs');
-require('./chunk-T27CVQBO.cjs');
-require('./chunk-OV6BGMEL.cjs');
+require('./chunk-4FJZ7RJD.cjs');
+require('./chunk-VL4JKXU2.cjs');
 require('./chunk-ZRYKDN2J.cjs');
 require('./chunk-HZJRERJW.cjs');
 require('./chunk-DUXLZPMJ.cjs');
@@ -1926,12 +1926,12 @@ function StaticPackageField({ value }) {
   return /* @__PURE__ */ _jsxruntime.jsx.call(void 0, 
     _chunkL4ZNR5V7cjs.Autocomplete,
     {
-      label: _chunkOJUMVOMPcjs.PACKAGE_SEARCH_LABEL,
+      label: _chunkE2JCZU36cjs.PACKAGE_SEARCH_LABEL,
       labelVariant: "large",
       options: value ? [{ value: value.id, label: value.name, description: _nullishCoalesce(value.description, () => ( void 0)) }] : [],
       value: _nullishCoalesce(_optionalChain([value, 'optionalAccess', _ => _.id]), () => ( null)),
       onChange: noop,
-      placeholder: _chunkOJUMVOMPcjs.PACKAGE_SEARCH_PLACEHOLDER
+      placeholder: _chunkE2JCZU36cjs.PACKAGE_SEARCH_PLACEHOLDER
     }
   );
 }
@@ -1945,7 +1945,7 @@ function SoftwareUpdateScreen({ compact = false }) {
     [fixture.devices, fixture.selectedIds]
   );
   return /* @__PURE__ */ _jsxruntime.jsx.call(void 0, "div", { className: "h-full bg-ods-bg pt-[var(--spacing-system-l)]", children: /* @__PURE__ */ _jsxruntime.jsx.call(void 0, "div", { className: "h-full", children: /* @__PURE__ */ _jsxruntime.jsx.call(void 0, 
-    _chunkOJUMVOMPcjs.SoftwareActionForm,
+    _chunkE2JCZU36cjs.SoftwareActionForm,
     {
       action: fixture.action,
       showHeader: false,
@@ -1957,7 +1957,7 @@ function SoftwareUpdateScreen({ compact = false }) {
       initialValues: fixture.initialValues,
       renderPackageSearch,
       renderDevicePicker: () => /* @__PURE__ */ _jsxruntime.jsx.call(void 0, 
-        _chunkOJUMVOMPcjs.DeviceSelector,
+        _chunkE2JCZU36cjs.DeviceSelector,
         {
           devices: selected,
           loading: false,

package/dist/types/faq.d.ts

@@ -1,8 +1,25 @@
+/**
+ * The two kinds of FAQ. An `answer` is a question with its written answer (the
+ * accordion, FAQPage JSON-LD). An `ask` is a question the assistant answers: it
+ * has a `prompt` (what is sent to the chat) and no written answer, and is what
+ * every "ask the assistant" surface offers.
+ */
+export declare const FAQ_KINDS: readonly ["answer", "ask"];
+export type FaqKind = (typeof FAQ_KINDS)[number];
 export interface Faq {
     id: number;
     question: string;
     answer: string;
     section?: string | null;
+    /** Absent on a host that predates kinds: an `answer`. */
+    kind?: FaqKind;
+    /** An `ask` FAQ's prompt for the chat; null on an `answer`. */
+    prompt?: string | null;
+    /**
+     * The places the FAQ is written for, shared by both kinds: a page's topic
+     * (`pricing`, `careers`, `home`) or a section's. Empty: written for no place.
+     */
+    topics?: string[];
     display_order: number;
     is_active: boolean;
     created_at: string;

package/dist/types/faq.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"faq.d.ts","sourceRoot":"","sources":["../../src/types/faq.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,GAAG;IAClB,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,OAAO,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACpB"}
+{"version":3,"file":"faq.d.ts","sourceRoot":"","sources":["../../src/types/faq.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,eAAO,MAAM,SAAS,4BAA6B,CAAC;AACpD,MAAM,MAAM,OAAO,GAAG,CAAC,OAAO,SAAS,CAAC,CAAC,MAAM,CAAC,CAAC;AAEjD,MAAM,WAAW,GAAG;IAClB,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,yDAAyD;IACzD,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,+DAA+D;IAC/D,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,OAAO,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACpB"}

package/dist/types/faq.js

@@ -0,0 +1,4 @@
+const FAQ_KINDS = ["answer", "ask"];
+export {
+  FAQ_KINDS
+};

package/dist/types/index.cjs

@@ -59,6 +59,9 @@ var TASK_TYPE_TEXT_COLORS = {
 // src/types/video-processing.ts
 var ENTITY_QUOTES_TITLE = "Key Quotes";
 
+// src/types/faq.ts
+var FAQ_KINDS = ["answer", "ask"];
+
 // src/utils/escape-regexp.ts
 function escapeRegExp(value) {
   return value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
@@ -608,6 +611,7 @@ exports.DOWNLOADS_TAGLINE = DOWNLOADS_TAGLINE;
 exports.DOWNLOADS_TITLE = DOWNLOADS_TITLE;
 exports.DOWNLOAD_ARCHITECTURE_LABELS = DOWNLOAD_ARCHITECTURE_LABELS;
 exports.ENTITY_QUOTES_TITLE = ENTITY_QUOTES_TITLE;
+exports.FAQ_KINDS = FAQ_KINDS;
 exports.OSTypeValues = OSTypeValues;
 exports.OS_TYPES = OS_TYPES;
 exports.SEMVER_REGEX = SEMVER_REGEX;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@flamingo-stack/openframe-frontend-core",
-  "version": "0.0.736",
+  "version": "0.0.737",
   "description": "Shared design system and components for all Flamingo platforms",
   "type": "module",
   "sideEffects": [

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

@@ -139,3 +139,4 @@ export {
 // PACKAGE-EXPORTED chat barrel so the hub can value-import them (deep paths
 // into chat/types/* are not in the package exports map and 404 at runtime).
 export { programItemToStripProfile, type ProgramAuthorRef } from '../types/entities/program-types';
+export { type MingoInfoCardAction, MingoInfoCardActionProvider } from '../mingo-info-card';

package/src/components/chat/hooks/use-ask-prompts.ts

@@ -24,7 +24,7 @@ export function buildAskPromptsUrl(
   { count, topic, exclude = [] }: { count: number; topic?: string; exclude?: readonly string[] },
 ): string {
   const params = new URLSearchParams({ count: String(count) });
-  if (topic) params.set('section', topic);
+  if (topic) params.set('topic', topic);
   if (exclude.length > 0) params.set('exclude', exclude.join(','));
   return `${base}${base.includes('?') ? '&' : '?'}${params.toString()}`;
 }
@@ -37,7 +37,7 @@ export function assistantAvailable(assistant: AssistantRuntime | null): assistan
 export interface UseAskPromptsOptions {
   /**
    * What the surface is about: ANY string the host's endpoint knows (sent as
-   * `section`). Questions written for it are picked first. Absent: general ones.
+   * `topic`). Questions written for it are picked first. Absent: general ones.
    */
   topic?: string;
   count?: number;

package/src/components/chat/mingo-info-card.tsx

@@ -1,6 +1,6 @@
 'use client';
 
-import type { MouseEvent, ReactNode } from 'react';
+import { createContext, type MouseEvent, type ReactNode, useContext } from 'react';
 import Image from '../../embed-shims/next-image';
 import Link from '../../embed-shims/next-link';
 import { cn } from '../../utils/cn';
@@ -13,6 +13,35 @@ import { tagVariants, type TagProps } from '../ui/tag';
 // Types
 // =============================================================================
 
+/**
+ * ONE action in place of the "⋯" menu, for a host that shows the card outside a
+ * conversation: an editor's list of attached records swaps the menu for
+ * "detach". It is a context because the host renders the card through the
+ * entity-card dispatch, which decides the menu per record type.
+ */
+export interface MingoInfoCardAction {
+  icon: ReactNode;
+  /** The button's accessible name, e.g. "Detach". */
+  label: string;
+  onClick: () => void;
+}
+
+const MingoInfoCardActionContext = createContext<MingoInfoCardAction | null>(null);
+
+export function MingoInfoCardActionProvider({
+  action,
+  children,
+}: {
+  action: MingoInfoCardAction;
+  children: ReactNode;
+}) {
+  return <MingoInfoCardActionContext.Provider value={action}>{children}</MingoInfoCardActionContext.Provider>;
+}
+
+/** The trailing cell's footprint and press feedback, shared by the "⋯" trigger and a host's action. */
+const TRAILING_BUTTON_CLASS =
+  'flex w-[56px] shrink-0 items-center justify-center self-stretch text-ods-text-secondary transition-colors hover:bg-ods-bg-hover hover:text-ods-text-primary focus:outline-none focus-visible:ring-2 focus-visible:ring-inset focus-visible:ring-ods-accent active:bg-ods-bg-active active:text-ods-text-primary md:w-[68px]';
+
 /** A coloured status pill rendered to the right of the title/description. */
 export interface MingoInfoCardStatus {
   /** Pill text — rendered uppercase via the `success`/`warning`/… Tag palette. */
@@ -157,7 +186,8 @@ export function MingoInfoCard({
   className,
 }: MingoInfoCardProps) {
   const hasMedia = !!imageSrc || !!icon;
-  const hasMenu = !!menuGroups && menuGroups.length > 0;
+  const action = useContext(MingoInfoCardActionContext);
+  const hasMenu = !action && !!menuGroups && menuGroups.length > 0;
   const isAnchor = !!anchorProps;
   const isInteractive = isAnchor || !!onClick;
 
@@ -182,7 +212,7 @@ export function MingoInfoCard({
 
   const contentClass = cn(
     'flex min-w-0 flex-1 items-center gap-[var(--spacing-system-s)] overflow-hidden p-[var(--spacing-system-s)] text-left',
-    hasMenu && 'border-r border-ods-border',
+    (hasMenu || action) && 'border-r border-ods-border',
     isInteractive &&
       'cursor-pointer transition-colors hover:bg-ods-bg-hover focus:outline-none focus-visible:ring-2 focus-visible:ring-inset focus-visible:ring-ods-accent active:bg-ods-bg-active',
   );
@@ -206,6 +236,11 @@ export function MingoInfoCard({
         <span className={contentClass}>{content}</span>
       )}
 
+      {action && (
+        <button type="button" aria-label={action.label} onClick={action.onClick} className={TRAILING_BUTTON_CLASS}>
+          {action.icon}
+        </button>
+      )}
       {hasMenu && (
         <ActionsMenuDropdown
           groups={menuGroups as ActionsMenuGroup[]}
@@ -217,7 +252,7 @@ export function MingoInfoCard({
               aria-label={menuAriaLabel}
               // Press feedback mirrors `Button` (transparent variant):
               // `hover:bg-ods-bg-hover` → `active:bg-ods-bg-active`.
-              className="flex w-[56px] shrink-0 items-center justify-center self-stretch text-ods-text-secondary transition-colors hover:bg-ods-bg-hover hover:text-ods-text-primary focus:outline-none focus-visible:ring-2 focus-visible:ring-inset focus-visible:ring-ods-accent active:bg-ods-bg-active active:text-ods-text-primary md:w-[68px]"
+              className={TRAILING_BUTTON_CLASS}
             >
               <Ellipsis01Icon size={24} />
             </button>

package/src/components/faq/faq-ask-card.tsx

@@ -10,10 +10,11 @@ import { assistantAvailable } from '../chat/hooks/use-ask-prompts';
 export interface FaqAskOptions {
   /**
    * What this FAQ is about: ANY string the host's questions endpoint knows (it
-   * is sent as `section`, and reported with every click). Questions written
-   * for the topic are picked first. Whoever renders the FAQ passes it. Absent:
-   * the entity the FAQ is attached to (`FaqSection`'s `entityType`). With
-   * neither, the FAQ has no card: the lib names no topic of its own.
+   * is sent as `topic`, and reported with every click). Questions written
+   * for the topic are picked first. Absent: the FAQ's own topic
+   * (`FaqSection`'s `topic`), else the entity the FAQ is attached to (its
+   * `entityType`). With none, the FAQ has no card: the lib names no topic of
+   * its own.
    */
   topic?: string;
   /**

package/src/components/faq/faq-document-page.tsx

@@ -49,6 +49,8 @@ export interface FaqDocumentPageProps {
   jsonLd?: FaqSchemaOptions;
   /** Base URL `FaqSection` appends `/api/faqs` to (reverse-proxy embedders). */
   apiBaseUrl?: string;
+  /** What the page is about (forwarded to `FaqSection`): its FAQs and its ask card are the ones written for the topic. */
+  topic?: string;
   /** Optional entity scoping forwarded to `FaqSection`. */
   entityType?: string;
   entityId?: number | string;
@@ -70,6 +72,7 @@ export function FaqDocumentPage({
   entityType,
   entityId,
   minResults,
+  topic,
   ask,
   shell = true,
 }: FaqDocumentPageProps) {
@@ -97,6 +100,7 @@ export function FaqDocumentPage({
         entityType={entityType}
         entityId={entityId}
         minResults={minResults}
+        topic={topic}
         ask={ask}
       />
     </PageLayout>

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

@@ -27,6 +27,15 @@ export interface FaqSectionProps {
   /** Both required together for entity-attached FAQs; partial → bare /api/faqs. */
   entityType?: string;
   entityId?: number | string;
+  /**
+   * What the page this FAQ sits on is about: ANY string the host's FAQ
+   * endpoint knows. ONE topic for the whole block: the questions are the FAQs
+   * written for it (`/api/faqs?topic=`; `initialFaqs` are then the host's read
+   * of the same topic) and the "ask the assistant" card offers the questions
+   * written for it. Whoever renders the FAQ states it; the lib names none.
+   * Ignored for the questions when the FAQ is attached to an entity.
+   */
+  topic?: string;
   /**
    * Heading node above the grouped list. `undefined` → default
    * `<h2>`"Frequently Asked Questions". `null` → no heading (the host page
@@ -43,6 +52,14 @@ export interface FaqSectionProps {
   /** Overrides for the JSON-LD's name/description/url. */
   jsonLd?: FaqSchemaOptions;
   className?: string;
+  /** The `id` of the rendered section: what an in-page link to the FAQ points at (`PAGE_FAQ_SECTION_ID` for a page's own block). */
+  id?: string;
+  /**
+   * Print the topic's bare name in small muted text under the heading
+   * (`pricing`), so whoever edits the FAQs can see which topic a page asks
+   * for. Default off. The section always carries it as `data-faq-topic` too.
+   */
+  showTopic?: boolean;
   /** Maps to /api/faqs `?count=` (the 5-tier fill target). Absent → param
    *  not sent (server default applies). */
   minResults?: number;
@@ -60,10 +77,10 @@ export interface FaqSectionProps {
    * The "ask the assistant" card beside the questions. Shown wherever the
    * host's assistant runtime says a chat is there to open
    * (`AssistantRuntimeContext`: its name, glyph, questions endpoint and
-   * opener) AND the FAQ has a topic: `ask.topic` (any string the host's
-   * questions endpoint knows), else the `entityType` the FAQ is attached to.
-   * No runtime or no topic: the FAQ is the single column it always was; the
-   * lib names no topic of its own. `false` switches the card off; the object
+   * opener) AND the FAQ has a topic: the block's `topic`, else the
+   * `entityType` the FAQ is attached to (`ask.topic` states another one for
+   * the card alone). No runtime or no topic: the FAQ is the single column it
+   * always was; the lib names no topic of its own. `false` switches the card off; the object
    * also states the questions to leave out, the wording and the chat it opens
    * (`onOpen`). An `aside` takes the card's place.
    */
@@ -72,11 +89,47 @@ export interface FaqSectionProps {
 
 const DEFAULT_HEADING_TEXT = 'Frequently Asked Questions';
 
+/** The id of a page's own FAQ block: what a page's "FAQ" link or section nav points at. */
+export const PAGE_FAQ_SECTION_ID = 'faq';
+
+/** A page's own FAQ block inside a page that already provides the container: vertical rhythm only. */
+const PAGE_FAQ_IN_PAGE_CLASS = 'space-y-10 pt-12 md:pt-20';
+
+/**
+ * What a shared page of the lib takes as its `faq` prop: the topic the page is
+ * about (REQUIRED, stated by the host, never read from the page's address) and
+ * where the host serves the FAQs. The page renders `FaqSection` with it, inside
+ * its own container, after its content (`pageFaqProps`).
+ */
+export type PageFaqSlot = Pick<
+  FaqSectionProps,
+  'apiBaseUrl' | 'initialFaqs' | 'heading' | 'ask' | 'emitJsonLd' | 'jsonLd' | 'showTopic'
+> & { topic: string };
+
+/** The `FaqSection` props of a shared page's own FAQ block: the host's slot, as the page's `#faq` section. */
+export function pageFaqProps(faq: PageFaqSlot): FaqSectionProps {
+  return { ...faq, id: PAGE_FAQ_SECTION_ID, className: PAGE_FAQ_IN_PAGE_CLASS };
+}
+
 /** 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 buildFaqsUrl(
+  entityType?: string,
+  entityId?: number | string,
+  minResults?: number,
+  apiBaseUrl = '',
+  topic?: string,
+): string {
+  // An entity's FAQs are the entity's: a topic narrows only the platform's own list.
+  const entityScoped = !!entityType && entityId !== undefined && entityId !== null && entityId !== '';
+  return buildSuggestionUrl('/api/faqs', {
+    apiBaseUrl,
+    entityType,
+    entityId,
+    count: minResults,
+    extraParams: entityScoped ? undefined : { topic },
+  });
 }
 
 interface FaqGroup {
@@ -390,6 +443,8 @@ interface FaqsResponse {
  *   page owns the <h1>) + `emitJsonLd` with `jsonLd` overrides for SEO.
  * - Per-entity embed: pass `entityType` + `entityId` (no `initialFaqs`); the
  *   hook self-fetches `GET /api/faqs`, and `heading` is this block's own <h2>.
+ * - A page's own FAQ: pass `topic` (what the page is about); the hook
+ *   self-fetches `GET /api/faqs?topic=`, and the ask card takes the same topic.
  *
  * CONTRACT: the consuming app MUST implement `GET /api/faqs`. On a fetch error
  * (or zero FAQs) the component renders nothing so the host page isn't
@@ -400,10 +455,13 @@ export function FaqSection({
   initialFaqs,
   entityType,
   entityId,
+  topic,
   heading,
   emitJsonLd = false,
   jsonLd,
   className,
+  id,
+  showTopic = false,
   minResults,
   apiBaseUrl = '',
   aside: asideProp,
@@ -412,30 +470,41 @@ export function FaqSection({
   const assistant = useAssistantRuntime();
   // The host's own block wins; else the card, where a chat is there to open and the FAQ has a topic
   // (an empty topic is no topic, as the questions request reads it).
-  const askTopic = ask === false ? undefined : ask?.topic || entityType;
+  const askTopic = ask === false ? undefined : ask?.topic || topic || entityType;
   const aside =
     asideProp ??
     (ask !== false && askTopic && faqAskCardShown(assistant) ? <FaqAskCard {...ask} topic={askTopic} /> : undefined);
-  const url = buildFaqsUrl(entityType, entityId, minResults, apiBaseUrl);
+  const url = buildFaqsUrl(entityType, entityId, minResults, apiBaseUrl, topic);
   // 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 { data, dataUrl, isLoading, error } = useSelfFetch<FaqsResponse>(url, { initialData });
 
-  // Memoised because the `??` fallback minted a NEW array on every
-  // render, which made the memo below re-run every time — i.e. do nothing.
-  const faqs = useMemo(() => data?.faqs ?? [], [data?.faqs]);
+  // Only the answer for THIS url: while another topic's questions load, the
+  // previous topic's are not this page's. Memoised because the `??` fallback
+  // minted a NEW array on every render, which made the memo below re-run
+  // every time — i.e. do nothing.
+  const held = dataUrl === url ? data?.faqs : undefined;
+  const faqs = useMemo(() => held ?? [], [held]);
   // Grouped before the early returns so the hook order stays stable.
   const groups = useMemo(() => (faqs.length > 0 ? groupFaqsBySection(faqs) : []), [faqs]);
 
   // `undefined` → default <h2> title; `null` → the host page owns the <h1>, so
   // no title renders here. `heading === null` also makes the category headings
   // <h2> (directly under the page <h1>); otherwise they nest as <h3>.
+  const titleNode = heading === undefined ? <h2 className={SECTION_HEADING_CLASS}>{DEFAULT_HEADING_TEXT}</h2> : heading;
   const headingNode =
-    heading === undefined ? <h2 className={SECTION_HEADING_CLASS}>{DEFAULT_HEADING_TEXT}</h2> : heading;
+    showTopic && topic ? (
+      <div className="space-y-1">
+        {titleNode}
+        <p className="text-ods-text-muted text-h6">{topic}</p>
+      </div>
+    ) : (
+      titleNode
+    );
 
   // Degrade silently — never show an error banner or an empty section shell
   // where FAQs would be (host pages and the standalone surface both rely on it).
@@ -453,7 +522,7 @@ export function FaqSection({
 
   return (
     <>
-      <section className={className ?? 'space-y-10'}>
+      <section id={id} data-faq-topic={topic} className={className ?? 'space-y-10'}>
         {!aside && headingNode}
         <GroupedFaqList
           groups={groups}

package/src/components/faq/index.ts

@@ -9,6 +9,6 @@
 //
 // (Server-safe subpath is wired in tsup.config.ts under the server/universal
 // block and exposed via "./components/faq/json-ld" in package.json#exports.)
-export { FaqSection, type FaqSectionProps } from './faq-section';
+export { FaqSection, PAGE_FAQ_SECTION_ID, pageFaqProps, type FaqSectionProps, type PageFaqSlot } from './faq-section';
 export { FaqDocumentPage, type FaqDocumentPageProps } from './faq-document-page';
 export { FaqAskCard, type FaqAskOptions } from './faq-ask-card';