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

package/src/components/help-center-pages/delivery-page.tsx

@@ -8,6 +8,7 @@
  */
 
 import type { ReactNode } from 'react';
+import type { PageFaqSlot } from '../faq/faq-section';
 import { DeliveryLists } from '../shared/delivery';
 import { DevSectionPage } from '../shared/dev-section';
 
@@ -22,6 +23,12 @@ export interface DeliveryPageProps {
   subtitle?: string;
   /** Optional slot rendered below the lists, inside the page chrome. */
   belowContent?: ReactNode;
+  /**
+   * The page's own FAQ block: the topic the page is about (stated by the host,
+   * never read from its address) and where the host serves the FAQs. Rendered
+   * after the page's content, inside its container. Absent: no FAQ block.
+   */
+  faq?: PageFaqSlot;
   /** Render the standalone `<PageShell>`. Default true. Pass false when the host
    *  layout already provides the page container (forwarded to `DevSectionPage`). */
   shell?: boolean;
@@ -34,10 +41,18 @@ export function DeliveryPage({
   title,
   subtitle,
   belowContent,
+  faq,
   shell,
 }: DeliveryPageProps) {
   return (
-    <DevSectionPage sectionKey="delivery" backButton={backButton} title={title} subtitle={subtitle} shell={shell}>
+    <DevSectionPage
+      sectionKey="delivery"
+      backButton={backButton}
+      title={title}
+      subtitle={subtitle}
+      faq={faq}
+      shell={shell}
+    >
       <DeliveryLists completedApiEndpoint={completedEndpoint} inProgressApiEndpoint={inProgressEndpoint} />
       {belowContent}
     </DevSectionPage>

package/src/components/help-center-pages/download-apps-page.tsx

@@ -52,6 +52,7 @@ import {
 import { cn } from '../../utils/cn';
 import { formatUrlForDisplay } from '../../utils/format';
 import { DESKTOP_OSES, type DesktopOs } from '../../utils/visitor-os';
+import { FaqSection, pageFaqProps, type PageFaqSlot } from '../faq/faq-section';
 import { CommandBox } from '../features/command-box';
 import { AppleLogoIcon } from '../icons-v2-generated/brand-logos/apple-logo-icon';
 import { WindowsLogoGreyIcon } from '../icons-v2-generated/brand-logos/windows-logo-grey-icon';
@@ -86,6 +87,12 @@ export interface DownloadAppsPageProps {
   onDownloadAction?: (event: DownloadActionEvent) => void;
   /** The closing card, under the mobile app: using OpenFrame without installing anything. Default: none. */
   web?: DownloadAppsWebOption;
+  /**
+   * The page's own FAQ block: the topic the page is about (stated by the host,
+   * never read from its address) and where the host serves the FAQs. Rendered
+   * after the page's content, inside its container. Absent: no FAQ block.
+   */
+  faq?: PageFaqSlot;
 }
 
 /** The "no install" card: the host's words and its own button (the page holds no signup link). */
@@ -281,6 +288,7 @@ export function DownloadAppsPage({
   openStoresInNewTab = true,
   onDownloadAction,
   web,
+  faq,
 }: DownloadAppsPageProps) {
   const { data, isLoading, error, reload } = useDownloads({ endpoint, initialData });
   // The page adapts to the server's answer: a section exists only for what it names.
@@ -362,6 +370,7 @@ export function DownloadAppsPage({
         {body}
         {web && <WebCard web={web} />}
       </div>
+      {faq && <FaqSection {...pageFaqProps(faq)} />}
     </DownloadAppsChrome>
   );
 }

package/src/components/help-center-pages/onboarding-guides-catalog-page.tsx

@@ -10,6 +10,7 @@
 
 import type { ReactNode } from 'react';
 import type { OnboardingGuide } from '../chat/types/entities/onboarding-guide';
+import type { PageFaqSlot } from '../faq/faq-section';
 import { OnboardingGuidesCatalogView } from '../onboarding-guides';
 import { DevSectionPage } from '../shared/dev-section';
 
@@ -32,6 +33,12 @@ export interface OnboardingGuidesCatalogPageProps {
   subtitle?: string;
   /** Optional slot rendered below the catalog, inside the page chrome. */
   belowContent?: ReactNode;
+  /**
+   * The page's own FAQ block: the topic the page is about (stated by the host,
+   * never read from its address) and where the host serves the FAQs. Rendered
+   * after the page's content, inside its container. Absent: no FAQ block.
+   */
+  faq?: PageFaqSlot;
   /** Render the standalone `<PageShell>`. Default true. Pass false when the host
    *  layout already provides the page container (forwarded to `DevSectionPage`). */
   shell?: boolean;
@@ -48,10 +55,18 @@ export function OnboardingGuidesCatalogPage({
   title,
   subtitle,
   belowContent,
+  faq,
   shell,
 }: OnboardingGuidesCatalogPageProps) {
   return (
-    <DevSectionPage sectionKey="onboarding" backButton={backButton} title={title} subtitle={subtitle} shell={shell}>
+    <DevSectionPage
+      sectionKey="onboarding"
+      backButton={backButton}
+      title={title}
+      subtitle={subtitle}
+      faq={faq}
+      shell={shell}
+    >
       <OnboardingGuidesCatalogView
         guidesEndpoint={guidesEndpoint}
         sectionsEndpoint={sectionsEndpoint}

package/src/components/help-center-pages/product-releases-list-page.tsx

@@ -10,6 +10,7 @@
 
 import type { ReactNode } from 'react';
 import type { ProductRelease, ProductReleaseListResponse } from '../../types/product-release';
+import type { PageFaqSlot } from '../faq/faq-section';
 import { DevSectionPage } from '../shared/dev-section';
 import { ProductReleasesView, type ProductReleaseCardExtras } from '../shared/product-release';
 
@@ -28,6 +29,12 @@ export interface ProductReleasesListPageProps {
   subtitle?: string;
   /** Optional slot rendered below the list, inside the page chrome. */
   belowContent?: ReactNode;
+  /**
+   * The page's own FAQ block: the topic the page is about (stated by the host,
+   * never read from its address) and where the host serves the FAQs. Rendered
+   * after the page's content, inside its container. Absent: no FAQ block.
+   */
+  faq?: PageFaqSlot;
   /** Render the standalone `<PageShell>`. Default true. Pass false when the host
    *  layout already provides the page container (forwarded to `DevSectionPage`). */
   shell?: boolean;
@@ -42,10 +49,18 @@ export function ProductReleasesListPage({
   title,
   subtitle,
   belowContent,
+  faq,
   shell,
 }: ProductReleasesListPageProps) {
   return (
-    <DevSectionPage sectionKey="releases" backButton={backButton} title={title} subtitle={subtitle} shell={shell}>
+    <DevSectionPage
+      sectionKey="releases"
+      backButton={backButton}
+      title={title}
+      subtitle={subtitle}
+      faq={faq}
+      shell={shell}
+    >
       <ProductReleasesView
         endpoint={releasesEndpoint}
         basePath={basePath}

package/src/components/help-center-pages/roadmap-page.tsx

@@ -10,6 +10,7 @@
 
 import type { ReactNode } from 'react';
 import type { RoadmapItem } from '../chat/types/entities/roadmap-item';
+import type { PageFaqSlot } from '../faq/faq-section';
 import { DevSectionPage } from '../shared/dev-section';
 import { RoadmapView } from '../shared/roadmap';
 import type { UseRoadmapVotingOptions } from '../shared/roadmap';
@@ -35,6 +36,12 @@ export interface RoadmapPageProps {
   /** Optional slot rendered below the list, inside the page chrome — e.g. the
    *  hub's related-content rail. */
   belowContent?: ReactNode;
+  /**
+   * The page's own FAQ block: the topic the page is about (stated by the host,
+   * never read from its address) and where the host serves the FAQs. Rendered
+   * after the page's content, inside its container. Absent: no FAQ block.
+   */
+  faq?: PageFaqSlot;
   /** Render the standalone `<PageShell>`. Default true. Pass false when the host
    *  layout already provides the page container (forwarded to `DevSectionPage`). */
   shell?: boolean;
@@ -51,10 +58,18 @@ export function RoadmapPage({
   title,
   subtitle,
   belowContent,
+  faq,
   shell,
 }: RoadmapPageProps) {
   return (
-    <DevSectionPage sectionKey="roadmap" backButton={backButton} title={title} subtitle={subtitle} shell={shell}>
+    <DevSectionPage
+      sectionKey="roadmap"
+      backButton={backButton}
+      title={title}
+      subtitle={subtitle}
+      faq={faq}
+      shell={shell}
+    >
       <RoadmapView
         endpoint={roadmapEndpoint}
         initialItems={initialItems}

package/src/components/shared/dev-section/dev-section-page.tsx

@@ -22,6 +22,7 @@ import {
   OPENFRAME_DEV_SECTIONS,
   type OpenframeDevSectionKey,
 } from '../../../utils/dev-sections/openframe-dev-sections';
+import { FaqSection, pageFaqProps, type PageFaqSlot } from '../../faq/faq-section';
 import { PageShell, PageLayout } from '../../ui';
 import { DevSectionView } from './dev-section-view';
 
@@ -51,6 +52,12 @@ export interface DevSectionPageProps {
    *  `false` when the host layout already provides the page container (e.g.
    *  openframe-frontend's `AppLayout` `<main>`): then only the
    *  `page-shell-content` padding box is rendered, avoiding a nested `<main>`. */
+  /**
+   * The page's own FAQ block: the topic the page is about (stated by the host,
+   * never read from its address) and where the host serves the FAQs. Rendered
+   * after the page's content, inside its container. Absent: no FAQ block.
+   */
+  faq?: PageFaqSlot;
   shell?: boolean;
 }
 
@@ -61,6 +68,7 @@ export function DevSectionPage({
   backButton,
   title,
   subtitle,
+  faq,
   shell = true,
 }: DevSectionPageProps) {
   const router = useRouter();
@@ -95,6 +103,7 @@ export function DevSectionPage({
       <DevSectionView sectionKey={sectionKey} showHeading={false} preControls={preControls}>
         {children}
       </DevSectionView>
+      {faq && <FaqSection {...pageFaqProps(faq)} />}
     </PageLayout>
   );
 

package/src/components/shared/legal-document/legal-document-page.tsx

@@ -21,6 +21,7 @@ import type { ComponentType } from 'react';
 import Link from '../../../embed-shims/next-link';
 import { useRouter } from '../../../embed-shims/next-navigation';
 import { formatLegalDate } from '../../../utils/format';
+import { FaqSection, pageFaqProps, type PageFaqSlot } from '../../faq/faq-section';
 import { PageShell, PageLayout } from '../../ui';
 import { RichMarkdownRenderer } from '../../ui/markdown';
 import { useLegalDocs, type LegalDocument } from './use-legal-docs';
@@ -64,6 +65,12 @@ export interface LegalDocumentPageProps {
   /** Back-button config — same pattern as `DevSectionPage`. Pass `false`
    *  to hide. Default `{ label: 'Back to home', href: '/' }`. */
   backButton?: { label?: string; href?: string } | false;
+  /**
+   * The page's own FAQ block: the topic the page is about (stated by the host,
+   * never read from its address) and where the host serves the FAQs. Rendered
+   * after the page's content, inside its container. Absent: no FAQ block.
+   */
+  faq?: PageFaqSlot;
   /** Render the standalone `<PageShell>`. Default true. Pass false when the host
    *  layout already provides the page container — only the padding box renders,
    *  avoiding a nested `<main>`. */
@@ -83,6 +90,7 @@ export function LegalDocumentPage({
   apiEndpoint,
   MarkdownRenderer = RichMarkdownRenderer,
   backButton,
+  faq,
   shell = true,
 }: LegalDocumentPageProps) {
   const router = useRouter();
@@ -161,6 +169,7 @@ export function LegalDocumentPage({
           </div>
         </div>
       </div>
+      {faq && <FaqSection {...pageFaqProps(faq)} />}
     </PageLayout>
   );
 

package/src/contexts/assistant-runtime-context.tsx

@@ -56,11 +56,11 @@ export interface AssistantRuntime {
   source?: string;
   /**
    * GET endpoint the questions are read from:
-   *   `<url>?count=<n>&section=<topic>&exclude=<id,id>` → `{ prompts: AskPrompt[] }`
-   * `section` is ANY string: the host decides what topics exist (the hub: the
-   * `section` attribute of a quick action, set in chat config), so a new topic
-   * needs no change here. Hub: '/api/quick-actions/questions'. Absent: an "ask"
-   * surface shows its launcher with no questions.
+   *   `<url>?count=<n>&topic=<topic>&exclude=<id,id>` → `{ prompts: AskPrompt[] }`
+   * `topic` is ANY string: the host decides what topics exist (the hub: the
+   * topics of its FAQs, set in the FAQ admin), so a new topic needs no change
+   * here. Hub: '/api/faqs/questions'. Absent: an "ask" surface shows its
+   * launcher with no questions.
    */
   askPromptsUrl?: string;
   /**

package/src/types/faq.ts

@@ -1,8 +1,26 @@
+/**
+ * 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 const FAQ_KINDS = ['answer', 'ask'] as const;
+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;