@factorialco/f0-react 1.412.0 → 1.413.1

package/dist/{F0Input-JjjfHKNJ.js → F0Input-C9w04Jpr.js}

@@ -109665,23 +109665,23 @@ export {
   kH as d$,
   bc as d0,
   GI as d1,
-  gr1 as d2,
-  Jn1 as d3,
-  Lk as d4,
-  wB as d5,
-  AB as d6,
-  Ad as d7,
-  Td as d8,
-  Dd as d9,
-  gI as dA,
-  II as dB,
-  XI as dC,
-  ka as dD,
-  tB as dE,
-  rB as dF,
-  hr1 as dG,
-  cB as dH,
-  CB as dI,
+  Jn1 as d2,
+  Lk as d3,
+  wB as d4,
+  AB as d5,
+  Ad as d6,
+  Td as d7,
+  Dd as d8,
+  Ow as d9,
+  II as dA,
+  XI as dB,
+  ka as dC,
+  tB as dD,
+  rB as dE,
+  hr1 as dF,
+  cB as dG,
+  CB as dH,
+  gr1 as dI,
   br1 as dJ,
   wr1 as dK,
   yr1 as dL,
@@ -109700,87 +109700,86 @@ export {
   d0 as dY,
   or as dZ,
   qs2 as d_,
-  Ow as da,
-  qu2 as db,
-  zr1 as dc,
-  UI as dd,
-  QI as de,
-  bj as df,
-  Cr1 as dg,
-  Zr1 as dh,
-  p8 as di,
-  Qn1 as dj,
-  cx as dk,
-  Ar1 as dl,
-  qn as dm,
-  Xe1 as dn,
-  D3 as dp,
-  n01 as dq,
-  Qr1 as dr,
-  Jr1 as ds,
-  lF as dt,
-  n4 as du,
-  gc as dv,
-  sr1 as dw,
-  lr1 as dx,
-  WI as dy,
-  mI as dz,
+  qu2 as da,
+  zr1 as db,
+  UI as dc,
+  QI as dd,
+  bj as de,
+  Cr1 as df,
+  Zr1 as dg,
+  p8 as dh,
+  Qn1 as di,
+  cx as dj,
+  Ar1 as dk,
+  qn as dl,
+  Xe1 as dm,
+  D3 as dn,
+  n01 as dp,
+  Qr1 as dq,
+  Jr1 as dr,
+  lF as ds,
+  n4 as dt,
+  gc as du,
+  sr1 as dv,
+  lr1 as dw,
+  WI as dx,
+  mI as dy,
+  gI as dz,
   JL as e,
   sd as e0,
   HH as e1,
   zk as e2,
   wc as e3,
-  q42 as e4,
-  j2 as e5,
-  Y1 as e6,
-  i9 as e7,
-  Fr as e8,
-  r8 as e9,
-  gs2 as eA,
-  pl as eB,
-  tx as eC,
-  nx as eD,
-  rx as eE,
-  PH as eF,
-  b91 as eG,
-  V6 as eH,
-  E6 as eI,
-  or1 as eJ,
-  Yb as eK,
-  R01 as eL,
-  jC2 as eM,
-  Xr1 as eN,
-  k01 as eO,
-  ll2 as eP,
-  ef2 as eQ,
-  Tn1 as eR,
-  sn1 as eS,
-  Nr1 as ea,
-  Dr1 as eb,
-  Tr1 as ec,
-  tl2 as ed,
-  F4 as ee,
-  pi as ef,
-  y3 as eg,
-  a7 as eh,
-  dl2 as ei,
-  Fu2 as ej,
-  Jv as ek,
-  c8 as el,
-  cd2 as em,
-  dd2 as en,
-  kF as eo,
-  er as ep,
-  Qn as eq,
-  oD as er,
-  Ml as es,
-  c3 as et,
-  t7 as eu,
-  ah as ev,
-  SN as ew,
-  er1 as ex,
-  q6 as ey,
-  nl2 as ez,
+  er as e4,
+  Qn as e5,
+  oD as e6,
+  Ml as e7,
+  c3 as e8,
+  t7 as e9,
+  j2 as eA,
+  Y1 as eB,
+  i9 as eC,
+  Fr as eD,
+  r8 as eE,
+  Nr1 as eF,
+  Dr1 as eG,
+  Tr1 as eH,
+  F4 as eI,
+  pi as eJ,
+  y3 as eK,
+  a7 as eL,
+  dl2 as eM,
+  Fu2 as eN,
+  Jv as eO,
+  cd2 as eP,
+  dd2 as eQ,
+  kF as eR,
+  ah as ea,
+  SN as eb,
+  er1 as ec,
+  q6 as ed,
+  nl2 as ee,
+  tl2 as ef,
+  gs2 as eg,
+  pl as eh,
+  tx as ei,
+  nx as ej,
+  rx as ek,
+  PH as el,
+  c8 as em,
+  b91 as en,
+  V6 as eo,
+  E6 as ep,
+  or1 as eq,
+  Yb as er,
+  R01 as es,
+  jC2 as et,
+  Xr1 as eu,
+  k01 as ev,
+  ll2 as ew,
+  ef2 as ex,
+  Tn1 as ey,
+  sn1 as ez,
   ZN as f,
   y6 as g,
   E3 as h,

package/dist/ai.d.ts

@@ -37,6 +37,11 @@ declare type AiChatDisclaimer = {
     linkText?: string;
 };
 
+/**
+ * Interaction mode for the AI chat
+ */
+export declare type AiChatMode = "chat" | "voice";
+
 /**
  * Props for the AiChatProvider component
  */
@@ -73,6 +78,10 @@ export declare type AiChatProviderProps = {
      * Optional footer content rendered below the textarea
      */
     footer?: React.ReactNode;
+    /**
+     * Optional component rendered in place of the chat UI when voice mode is active.
+     */
+    VoiceMode?: React.ComponentType;
     /**
      * Async resolver functions for entity references in markdown.
      * Used to fetch profile data for inline entity mentions (hover cards).
@@ -166,6 +175,14 @@ declare type AiChatProviderReturnValue = {
      * Set the visualization mode
      */
     setVisualizationMode: React.Dispatch<React.SetStateAction<VisualizationMode>>;
+    /**
+     * The current interaction mode
+     */
+    mode: AiChatMode;
+    /**
+     * Set the interaction mode
+     */
+    setMode: React.Dispatch<React.SetStateAction<AiChatMode>>;
     /**
      * When true, prevents switching between visualization modes
      */
@@ -175,6 +192,10 @@ declare type AiChatProviderReturnValue = {
      * Optional footer content rendered below the textarea
      */
     footer?: React.ReactNode;
+    /**
+     * Optional component rendered when voice mode is active.
+     */
+    VoiceMode?: React.ComponentType;
     /**
      * Set the footer content. Use this to update the footer from outside the provider (e.g. per page/route).
      */
@@ -182,8 +203,6 @@ declare type AiChatProviderReturnValue = {
 } & Pick<AiChatState, "greeting" | "agent" | "disclaimer" | "resizable" | "entityResolvers" | "toolHints"> & {
     /** The current canvas content, or null when canvas is closed */
     canvasContent: CanvasContent | null;
-    /** The dashboard config from the current canvas content, or null */
-    canvasDashboard: ChatDashboardConfig | null;
     /** Open the canvas panel with the given content */
     openCanvas: (content: CanvasContent) => void;
     /** Close the canvas panel and restore the previous visualization mode */
@@ -192,10 +211,6 @@ declare type AiChatProviderReturnValue = {
     activeToolHint: AiChatToolHint | null;
     /** Set the active tool hint (pass null to clear) */
     setActiveToolHint: React.Dispatch<React.SetStateAction<AiChatToolHint | null>>;
-    /** Get a saved dashboard config by toolCallId (returns updated config after user edits) */
-    getSavedDashboardConfig: (toolCallId: string) => ChatDashboardConfig | undefined;
-    /** Save an updated dashboard config keyed by toolCallId */
-    updateDashboardConfig: (toolCallId: string, config: ChatDashboardConfig) => void;
 };
 
 /**
@@ -213,6 +228,7 @@ declare interface AiChatState {
     lockVisualizationMode?: boolean;
     historyEnabled?: boolean;
     footer?: React.ReactNode;
+    VoiceMode?: React.ComponentType;
     entityResolvers?: EntityResolvers;
     toolHints?: AiChatToolHint[];
     placeholders?: string[];
@@ -345,19 +361,54 @@ export declare function Blockquote({ children, ...props }: React.HTMLAttributes<
 
 /**
  * Discriminated union for canvas panel content.
- * Expand this union to support new content types in the canvas.
+ * Add new entity types to this union as they are implemented.
  */
-export declare type CanvasContent = {
-    type: "dashboard";
+export declare type CanvasContent = DashboardCanvasContent;
+
+/**
+ * Base shape shared by all canvas content types.
+ * Every entity adds its own fields on top of this.
+ */
+export declare type CanvasContentBase = {
+    type: string;
     title: string;
-    config: ChatDashboardConfig;
-    apiConfig: {
-        baseUrl: string;
-        headers: Record<string, string>;
-    };
     toolCallId?: string;
 };
 
+/**
+ * Contract for a canvas entity type.
+ *
+ * Each entity (dashboard, survey, goal, job-posting…) implements this
+ * interface and registers itself via `registerCanvasEntity()`.
+ *
+ * To add a new entity type:
+ * 1. Create a folder in `canvas/entities/<your-entity>/`
+ * 2. Define a type extending `CanvasContentBase` in `types.ts`
+ * 3. Implement `CanvasEntityDefinition` in `index.ts`
+ * 4. Import the entity module in `canvas/index.ts`
+ */
+export declare type CanvasEntityDefinition<T extends CanvasContentBase = CanvasContentBase> = {
+    /** Must match the `type` discriminant on the content object */
+    type: T["type"];
+    /** Renders the main body of the canvas panel */
+    renderContent: (props: {
+        content: T;
+        refreshKey: number;
+    }) => ReactNode;
+    /** Renders header actions (placed before the close button) */
+    renderHeaderActions: (props: {
+        content: T;
+    }) => ReactNode;
+    /**
+     * Optional wrapper providing entity-scoped context around
+     * both header actions and body (e.g. shared edit-mode state).
+     */
+    wrapper?: (props: {
+        content: T;
+        children: ReactNode;
+    }) => ReactNode;
+};
+
 export declare interface ChartComputation {
     datasetId: string;
     xAxis: string;
@@ -526,6 +577,29 @@ export declare interface CollectionComputation {
  */
 export declare type CSSRgbString = `rgb(${number}, ${number}, ${number})` | `rgb(${number},${number},${number})`;
 
+/**
+ * Dashboard canvas content — renders an analytics dashboard.
+ */
+export declare type DashboardCanvasContent = CanvasContentBase & {
+    type: "dashboard";
+    config: ChatDashboardConfig;
+    apiConfig: {
+        baseUrl: string;
+        headers: Record<string, string>;
+    };
+};
+
+/**
+ * Dashboard-specific card that wraps CanvasCard with config-store
+ * subscription logic. Re-renders when the user edits and saves
+ * the dashboard layout.
+ */
+declare function DashboardCard({ config: originalConfig, onView, toolCallId, }: F0ChatReportCardProps): JSX_2.Element;
+
+declare namespace DashboardCard {
+    var displayName: string;
+}
+
 export declare interface DashboardFetchSpec {
     fetch: Array<{
         toolId: string;
@@ -1236,7 +1310,7 @@ export declare const F0AiChat: () => JSX_2.Element | null;
 /**
  * @experimental This is an experimental component use it at your own risk
  */
-export declare const F0AiChatProvider: ({ enabled, greeting, initialMessage, welcomeScreenSuggestions, disclaimer, resizable, defaultVisualizationMode, lockVisualizationMode, historyEnabled, footer, entityResolvers, toolHints, onThumbsUp, onThumbsDown, children, agent, tracking, ...copilotKitProps }: AiChatProviderProps) => JSX_2.Element;
+export declare const F0AiChatProvider: ({ enabled, greeting, initialMessage, welcomeScreenSuggestions, disclaimer, resizable, defaultVisualizationMode, lockVisualizationMode, historyEnabled, footer, VoiceMode, entityResolvers, toolHints, onThumbsUp, onThumbsDown, children, agent, tracking, ...copilotKitProps }: AiChatProviderProps) => JSX_2.Element;
 
 export declare const F0AiChatTextArea: ({ submitLabel, inProgress, onSend, onStop, placeholders, defaultPlaceholder, autoFocus, entityResolvers, toolHints, activeToolHint, onActiveToolHintChange, }: F0AiChatTextAreaProps) => JSX_2.Element;
 
@@ -1373,29 +1447,19 @@ declare const F0AuraVoiceAnimationVariants: (props?: ({
 })) | undefined) => string;
 
 /**
- * Compact card shown inline in the AI chat to represent a generated
- * dashboard report. Uses F0Card with an icon avatar, the dashboard
- * title/description, and an item summary in metadata. Clicking the
- * card triggers `onView` to open the canvas panel.
- *
- * Subscribes to the external `savedDashboardConfigStore` via
- * `useSyncExternalStore` so it re-renders when the user edits the
- * dashboard layout and saves — independently of React context.
+ * @deprecated Use `DashboardCard` from `canvas/entities/dashboard` directly.
+ * This re-export exists for backwards compatibility.
  */
-export declare function F0ChatReportCard({ config: originalConfig, onView, toolCallId, }: F0ChatReportCardProps): JSX_2.Element;
+export declare const F0ChatReportCard: typeof DashboardCard;
 
-export declare namespace F0ChatReportCard {
-    var displayName: string;
-}
-
-export declare interface F0ChatReportCardProps {
+export declare type F0ChatReportCardProps = {
     /** The original dashboard config from the agent */
     config: ChatDashboardConfig;
     /** Callback when the user clicks the card to view the report */
     onView: (config: ChatDashboardConfig) => void;
     /** Tool call ID used to look up saved (edited) dashboard configs */
     toolCallId?: string;
-}
+};
 
 /**
  * Component that renders an optional markdown preview followed by
@@ -1639,6 +1703,12 @@ declare interface GaugeComputation {
     name?: string;
 }
 
+/**
+ * Look up a registered entity definition by content type.
+ * Returns `undefined` if the type hasn't been registered.
+ */
+export declare function getCanvasEntity(type: string): CanvasEntityDefinition<any> | undefined;
+
 export declare function H1({ children, ...props }: React.HTMLAttributes<HTMLHeadingElement>): JSX_2.Element;
 
 export declare function H2({ children, ...props }: React.HTMLAttributes<HTMLHeadingElement>): JSX_2.Element;
@@ -1784,6 +1854,12 @@ declare interface RadarComputation {
     sortOrder?: "asc" | "desc";
 }
 
+/**
+ * Register a canvas entity definition.
+ * Called as a side-effect when each entity module is imported.
+ */
+export declare function registerCanvasEntity<T extends CanvasContentBase>(definition: CanvasEntityDefinition<T>): void;
+
 export declare function Strong({ children, ...props }: React.HTMLAttributes<HTMLSpanElement>): JSX_2.Element;
 
 export declare function Table({ children, ...props }: React.HTMLAttributes<HTMLTableElement>): JSX_2.Element;

package/dist/ai.js

@@ -1,56 +1,58 @@
-import { I as e, u as t } from "./F0Input-JjjfHKNJ.js";
+import { I as e, u as t } from "./F0Input-C9w04Jpr.js";
 import { defaultTranslations as i } from "./i18n-provider-defaults.js";
-import { A as r, B as l, C as A, p as F, E as c, g as u, F as h, a as C, z as d, h as m, b as T, i as f, j as p, v as I, w as S, x as g, y as k, c as x, q as H, r as M, s as P, H as b, I as w, L as O, O as v, t as R, P as D, S as E, T as L, m as q, n as y, o as z, U as B, k as U, l as j, u as V, d as G, f as J, e as K } from "./F0AiChat-CA_dpVxM.js";
-import { A as Q, F as W, c as X, d as Y, b as Z, a as _, o as $, u as aa } from "./F0HILActionConfirmation-CasXGy89.js";
+import { A as r, B as l, C as A, p as F, E as c, h as u, F as C, a as h, D as d, i as m, b as T, j as f, w as p, x as g, y as I, z as S, c as k, q as x, s as v, t as H, H as M, I as P, L as b, O as w, v as E, P as O, S as y, T as D, m as R, n as L, o as q, U as z, k as B, l as U, g as j, r as V, u as G, d as J, f as K, e as N } from "./F0AiChat-CMz8oLke.js";
+import { A as W, F as X, c as Y, d as Z, e as _, b as $, a as aa, o as sa, u as ea } from "./F0HILActionConfirmation-MJSEogqB.js";
 export {
   r as A,
-  Q as AiChatTranslationsProvider,
+  W as AiChatTranslationsProvider,
   l as Blockquote,
   A as ChatSpinner,
   F as Em,
   c as EntityRef,
   u as F0ActionItem,
-  h as F0AiChat,
-  C as F0AiChatProvider,
+  C as F0AiChat,
+  h as F0AiChatProvider,
   d as F0AiChatTextArea,
   m as F0AiCollapsibleMessage,
   T as F0AiFullscreenChat,
-  W as F0AiMask,
-  X as F0AuraVoiceAnimation,
-  f as F0ChatReportCard,
-  p as F0DataDownload,
-  Y as F0HILActionConfirmation,
-  I as F0MessageSources,
-  S as F0OneIcon,
-  g as F0OneSwitch,
-  k as F0Thinking,
-  x as FullscreenChatContext,
-  H as H1,
-  M as H2,
-  P as H3,
-  b as Hr,
+  X as F0AiMask,
+  Y as F0AuraVoiceAnimation,
+  Z as F0ChatReportCard,
+  f as F0DataDownload,
+  _ as F0HILActionConfirmation,
+  p as F0MessageSources,
+  g as F0OneIcon,
+  I as F0OneSwitch,
+  S as F0Thinking,
+  k as FullscreenChatContext,
+  x as H1,
+  v as H2,
+  H as H3,
+  M as Hr,
   e as I18nProvider,
-  w as Image,
-  O as Li,
-  v as Ol,
-  R as P,
-  D as Pre,
-  E as Strong,
-  L as Table,
-  q as TableSimple,
-  y as Td,
-  z as Th,
-  B as Ul,
-  Z as actionItemStatuses,
-  _ as aiTranslations,
+  P as Image,
+  b as Li,
+  w as Ol,
+  E as P,
+  O as Pre,
+  y as Strong,
+  D as Table,
+  R as TableSimple,
+  L as Td,
+  q as Th,
+  z as Ul,
+  $ as actionItemStatuses,
+  aa as aiTranslations,
   i as defaultTranslations,
-  U as f0MarkdownRenderers,
-  j as f0MarkdownRenderersSimple,
-  $ as oneIconSizes,
-  V as useAiChat,
-  aa as useAiChatTranslations,
-  G as useDefaultCopilotActions,
+  B as f0MarkdownRenderers,
+  U as f0MarkdownRenderersSimple,
+  j as getCanvasEntity,
+  sa as oneIconSizes,
+  V as registerCanvasEntity,
+  G as useAiChat,
+  ea as useAiChatTranslations,
+  J as useDefaultCopilotActions,
   t as useI18n,
-  J as useMessageSourcesAction,
-  K as useOrchestratorThinkingAction
+  K as useMessageSourcesAction,
+  N as useOrchestratorThinkingAction
 };

package/dist/experimental.d.ts

@@ -445,6 +445,10 @@ declare type AiChatProviderProps = {
      * Optional footer content rendered below the textarea
      */
     footer?: React.ReactNode;
+    /**
+     * Optional component rendered in place of the chat UI when voice mode is active.
+     */
+    VoiceMode?: React.ComponentType;
     /**
      * Async resolver functions for entity references in markdown.
      * Used to fetch profile data for inline entity mentions (hover cards).