@factorialco/f0-react 12.15.0 → 12.17.0

package/dist/{index-BkCnaiJG.d.ts → index-MOV0Rv_v.d.ts}

@@ -527,956 +527,968 @@ type F0AvatarModuleProps = VariantProps<typeof moduleAvatarVariants> & {
 declare function F0AvatarModuleBase({ size, module, ...props }: F0AvatarModuleProps): import("react").JSX.Element;
 declare const F0AvatarModule: WithDataTestIdReturnType<typeof F0AvatarModuleBase>;
 //#endregion
-//#region src/addons/ai/ai/canvas/types.d.ts
-/**
- * Base shape shared by all canvas content types.
- * Every entity adds its own fields on top of this.
- */
-interface CanvasContentBase {
-  type: string;
-  title: string;
-  description?: string;
-  toolCallId?: string;
-  /**
-   * Render this content across the whole frame, covering the docked chat
-   * instead of hugging a seam beside it. For content that is a step of its own
-   * rather than something you work through while talking — picking a template,
-   * say. The chat is only covered, never closed, so the conversation is exactly
-   * where it was when the canvas is dismissed.
-   *
-   * Deliberately NOT called `fullscreen`: the chat's own
-   * `visualizationMode: "fullscreen"` means the opposite arrangement (chat full
-   * width, no canvas), and going back to it is how a covering canvas is
-   * dismissed.
-   *
-   * Defaults to the docked split.
-   */
-  coversChat?: boolean;
-  /**
-   * Keep this docked content mounted, out of view, while the chat is
-   * fullscreen, and bring it back as it was when the chat docks again. For
-   * content the reader works on and would lose by expanding the chat, such as
-   * an editor with unsaved changes.
-   *
-   * Defaults to dropping the content when the chat goes fullscreen. Ignored
-   * with `coversChat`, which fullscreen always dismisses.
-   */
-  keepsUnderFullscreen?: boolean;
+//#region src/elements/lib/global.types.d.ts
+interface DataAttributes {
+  [key: `data-${string}`]: string | undefined;
 }
+//#endregion
+//#region src/addons/documents/F0DocumentViewer/types.d.ts
+declare const pdfScales: readonly ["page-width", "page-fit", "0.5", "0.75", "1", "1.25", "1.5", "2", "3", "4"];
+type F0PdfScale = (typeof pdfScales)[number];
+type F0PdfRotation = 0 | 90 | 180 | 270;
 /**
- * Dashboard canvas content — renders an analytics dashboard.
- */
-type DashboardCanvasContent = CanvasContentBase & {
-  type: "dashboard";
-  config: ChatDashboardConfig;
-  apiConfig: {
-    baseUrl: string;
-    headers: Record<string, string>;
-    runtimeFetch?: typeof fetch;
-  };
-  /** Present when the dashboard is a pre-saved dashboard */
-  savedDashboardId?: string;
-  /** Category of the saved dashboard */
-  savedDashboardCategory?: string;
-  /** Description of the saved dashboard */
-  savedDashboardDescription?: string;
-  /** True when the agent has iterated on a saved dashboard but the user hasn't saved yet */
-  savedDashboardUnsaved?: boolean;
-};
-/**
- * Form canvas content — renders an interactive F0Form in the canvas panel.
- */
-type FormCanvasContent = CanvasContentBase & {
-  type: "form";
-  formName: string;
-  formDescription?: string;
-  formModule?: ModuleId;
-};
-/**
- * Data download canvas content — renders a full data table with download options.
- */
-type DataDownloadCanvasContent = CanvasContentBase & {
-  type: "dataDownload";
-  dataset: DataDownloadDataset;
-  filename?: string;
-  markdown?: string;
-};
-/**
- * Autofill-timesheet canvas content — renders an editable timesheet proposal
- * (day-grouped shift blocks the user can adjust and confirm) in the canvas panel.
- */
-type AutofillTimesheetCanvasContent = CanvasContentBase & {
-  type: "autofillTimesheet";
-  employeeId: string;
-  startOn: string;
-  endOn: string;
-  shifts: AutofillTimesheetShift[];
-};
-/**
- * Bulk-resolve-inconsistencies canvas content — renders an AI-grouped proposal
- * for resolving open time-tracking inconsistencies (a reviewable collection of
- * employees/rows the user can trim and apply). Carries scope identity only:
- * the proposal rows live in host state, keyed by this scope.
- */
-type BulkResolveInconsistenciesCanvasContent = CanvasContentBase & {
-  type: "bulkResolveInconsistencies";
-  /** Analysed period, YYYY-MM-DD. */
-  periodStart: string;
-  periodEnd: string;
-  /** Exact row ids the proposal was scoped to; null when the whole period was analysed. */
-  scopeInconsistencyIds?: string[] | null;
-};
-/**
- * Discriminated union for canvas panel content.
- * Add new entity types to this union as they are implemented.
+ * Document families the viewer can render. "pdf" is the default and keeps the
+ * full toolbar (paging, zoom, print, download); the other kinds render a
+ * lazy-loaded, read-only preview: "sheet" (xlsx/csv) as an Excel-style
+ * grid with one tab per sheet, "docx" through docx-preview with page layout,
+ * "text" as a rendered markdown document (`.md`) or monospaced source,
+ * "code" as syntax-highlighted source, "html" as a sandboxed page running its
+ * scripts and "archive" as the file listing of a zip (never extracted).
  */
-type CanvasContent = DashboardCanvasContent | FormCanvasContent | DataDownloadCanvasContent | AutofillTimesheetCanvasContent | BulkResolveInconsistenciesCanvasContent;
+type F0DocumentKind = "pdf" | "sheet" | "docx" | "text" | "code" | "html" | "archive";
 /**
- * Canvas-level action callbacks grouped by entity type.
- * Each entity defines its own actions type; this aggregates them.
- * Passed by the host app to F0AiChatProvider via `canvasActions`.
+ * When an HTML document's scripts may run. "auto" runs them on open, in the
+ * isolated `htmlSandbox` origin when there is one, else in an opaque-origin
+ * srcdoc frame. "ask" opens static with a "Run content" button. "never" keeps
+ * it static.
  */
-interface CanvasActions {
-  dashboard?: DashboardCanvasActions;
+type F0DocumentHtmlExecution = "auto" | "ask" | "never";
+/** A separate registrable domain serving `f0-html-host/` (see its README). */
+interface F0DocumentHtmlSandbox {
+  /** Exact origin, e.g. "https://usercontent.example.com". */
+  origin: string;
 }
 /**
- * Contract for a canvas entity type.
- *
- * Each entity (dashboard, survey, goal, job-posting…) implements this
- * interface and is added to the `canvasEntities` record passed to F0AiChat.
+ * Where the toolbar sits. "top" (default) is a bar across the top of the
+ * surface. "floating" is a dark pill that floats over the bottom of the
+ * document, like an action bar — for hosts whose own header already carries
+ * the title and the primary action (the AI chat canvas), so the controls stay
+ * close to the content instead of competing with that header. "none" draws
+ * no toolbar at all, for a host that already provides every control (the
+ * chat attachment viewer on an HTML page).
  */
-interface 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 the full header (title, actions, close button) */
-  renderHeader: (props: {
-    content: T;
-    onClose: () => void;
-  }) => ReactNode;
-  /**
-   * Optional wrapper providing entity-scoped context around
-   * both header and body (e.g. shared edit-mode state).
-   */
-  wrapper?: (props: {
-    content: T;
-    children: ReactNode;
-  }) => ReactNode;
-  /**
-   * When true the content area uses `overflow-hidden` instead of
-   * `overflow-auto`, letting the entity manage its own scrolling.
-   */
-  overflowHidden?: boolean;
-}
+type F0DocumentViewerToolbarPlacement = "top" | "floating" | "none";
 /**
- * Inline dataset for client-side file generation (Excel / CSV).
- * Sent by the agent with the raw query results.
+ * Host-provided toolbar action, appended after the built-in controls in every
+ * kind — e.g. a Close button when the viewer lives inside a fullscreen overlay.
  */
-interface DataDownloadDataset {
-  /** Column headers in display order. */
-  columns: string[];
-  /** Array of row objects keyed by column name. */
-  rows: Record<string, unknown>[];
+interface F0DocumentViewerAction {
+  icon: IconType;
+  label: string;
+  onClick: () => void;
+}
+interface F0DocumentViewerProps extends WithDataTestIdProps, DataAttributes {
+  /** Source URL of the document. */
+  url: string;
+  /** File name used when downloading the document. Defaults to "document.pdf". */
+  filename?: string;
   /**
-   * Total number of rows returned by the query (before truncation).
-   * Used together with previewCount to render the preview note.
+   * Document family to render. Defaults to "pdf" (unchanged behavior). For the
+   * other kinds the PDF-only props below (page, scale, rotation, print…) are
+   * ignored.
    */
-  totalCount?: number;
+  kind?: F0DocumentKind;
+  /** MIME type of the document — used by kind "text" to detect markdown. */
+  mimeType?: string;
   /**
-   * Number of rows shown in the markdown preview table.
-   * Used together with totalCount to render the preview note.
+   * Language for kind="code" (e.g. "typescript", "py"). Derived from the
+   * file name when omitted; unknown languages show as plain source.
    */
-  previewCount?: number;
+  language?: string;
+  /** Hide the built-in Download button, in every kind. */
+  hideDownload?: boolean;
+  /** kind="html": when scripts may run. Defaults to "auto". */
+  htmlExecution?: F0DocumentHtmlExecution;
+  /** kind="html": isolated origin where scripts run like a Claude artifact. */
+  htmlSandbox?: F0DocumentHtmlSandbox;
+  /** kind="html": who sent the file, shown as "Content from {sender}". */
+  sender?: string;
+  /** Toolbar placement, in every kind. Defaults to "top". */
+  toolbar?: F0DocumentViewerToolbarPlacement;
   /**
-   * Map of raw column names to human-readable labels in the user's language.
-   * Used for Excel/CSV headers. Falls back to the raw column name when absent.
+   * Custom actions appended to the toolbar (after the built-in controls), in
+   * every kind — e.g. a Close button when the viewer fills an overlay.
    */
-  columnLabels?: Record<string, string>;
+  actions?: F0DocumentViewerAction[];
+  /** Zero-based page index to scroll to initially (and on change). */
+  page?: number;
+  /** Restrict rendering to a subset of pages (zero-based indexes). */
+  pagesToDisplay?: number[];
+  /** Initial zoom level. Defaults to "page-width". */
+  initialScale?: F0PdfScale;
+  /** Send credentials with the document request. Defaults to true. */
+  withCredentials?: boolean;
+  /** Show a toolbar control to rotate the document in 90° steps. */
+  rotatable?: boolean;
+  /** Initial rotation in degrees. Defaults to 0. */
+  initialRotation?: F0PdfRotation;
+  /** Called with the new rotation in degrees whenever the user rotates. */
+  onRotationChange?: (rotation: F0PdfRotation) => void;
+  /** Called once the document has loaded, with the pdf.js document proxy. */
+  onPdfLoaded?: (pdf: PDFDocumentProxy) => void;
+  /** Called with the 1-based page number when the visible page changes. */
+  onPageChange?: (page: number) => void;
 }
+//#endregion
+//#region src/addons/documents/F0DocumentViewer/F0DocumentViewerSkeleton.d.ts
+declare const F0DocumentViewerSkeleton: () => import("react").JSX.Element;
+//#endregion
+//#region src/addons/documents/F0DocumentViewer/F0DocumentViewer.d.ts
 /**
- * A single proposed shift block in a timesheet-autofill preview. Every proposed
- * block carries concrete employee-local clock times (ISO datetime or "HH:MM");
- * days that cannot be proposed are omitted rather than emitted with empty bounds.
+ * @experimental This is an experimental component, use it at your own risk.
  */
-interface AutofillTimesheetShift {
-  date: string;
-  clockIn: string;
-  clockOut: string;
-  workable: boolean;
-  workplaceId?: string | null;
-  workAreaId?: string | null;
-  /**
-   * Host-defined work-location kind. Left as a loose string to keep the kit
-   * host-agnostic; the factorial consumer narrows it to its attendance
-   * location-type enum (today: "office" | "work_from_home" | "business_trip").
+declare const F0DocumentViewer: WithDataTestIdReturnType<import("react").ForwardRefExoticComponent<F0DocumentViewerProps & import("react").RefAttributes<HTMLDivElement>> & {
+  Skeleton: typeof F0DocumentViewerSkeleton;
+}>;
+/** @deprecated Renamed to `F0DocumentViewer`: it previews PDF, Word, Excel and text. */
+declare const F0PdfViewer: WithDataTestIdReturnType<import("react").ForwardRefExoticComponent<F0DocumentViewerProps & import("react").RefAttributes<HTMLDivElement>> & {
+  Skeleton: typeof F0DocumentViewerSkeleton;
+}>;
+/** @deprecated Renamed to `F0DocumentViewerProps`. */
+type F0PdfViewerProps = F0DocumentViewerProps;
+/** @deprecated Renamed to `F0DocumentViewerToolbarPlacement`. */
+type F0PdfViewerToolbarPlacement = F0DocumentViewerToolbarPlacement;
+/** @deprecated Renamed to `F0DocumentViewerAction`. */
+type F0PdfViewerAction = F0DocumentViewerAction;
+//#endregion
+//#region src/elements/lib/localized.d.ts
+/**
+ * Shared helpers for content that can be provided in one language (a plain
+ * value) or several (a list of per-locale entries) — used by the media players
+ * for captions, descriptions, transcriptions and summaries.
+ */
+interface LocalizedOption<T> {
+  /** BCP-47 language tag, e.g. `"en"`, `"es"`, `"en-US"`. */
+  locale: string;
+  /**
+   * Display label for the language picker. Defaults to the language name for
+   * `locale` (via `Intl.DisplayNames`), so this is only needed to override it.
    */
-  locationType?: string | null;
+  label?: string;
+  /** The value for this locale. */
+  value: T;
 }
+/** A single value, or the same value provided in multiple languages. */
+type Localized<T> = T | LocalizedOption<T>[];
+//#endregion
+//#region src/blocks/F0VideoPlayer/types.d.ts
 /**
- * A preset formatting instruction the LLM can specify instead of a
- * real formatter function. The wrapper component maps these to actual
- * `(value: number) => string` functions at render time.
+ * Structured content for the video player.
+ *
+ * Every field accepts either a single value or a localized list
+ * (`[{ locale, label?, value }]`) — pass several languages and a language
+ * selector appears in the controls. A single shared selection drives captions,
+ * descriptions and the described source together (each falls back to its first
+ * entry for languages it doesn't provide). See `F0VideoPlayerProps.defaultLanguage`.
+ *
+ * `captions` are timed text shown over the video during playback (WCAG 2.1
+ * SC 1.2.2, Captions). Pass either a WebVTT resource URL or a raw WebVTT string
+ * (the player turns raw VTT into a blob track, so no CORS setup is needed); a
+ * remote URL requires the video host to allow cross-origin reads. When omitted,
+ * the player uses any caption/subtitle track embedded in the video file. A
+ * captions toggle in the controls shows/hides them (a filled glyph when on, a
+ * line glyph when off).
+ *
+ * Audio description (WCAG 2.1 SC 1.2.5) conveys on-screen visual information as
+ * audio, complementary to captions — both are independent and can be on at
+ * once. Provide it in one of two ways, toggled with the audio-description
+ * control (a filled "AD" badge when on, a line badge when off):
+ * - `describedSrc`: a pre-produced media rendition with description mixed into
+ *   the audio. Toggling swaps the source, preserving position and play state.
+ *   Highest quality; assumed the same length as `src`.
+ * - `descriptions`: a WebVTT `kind="descriptions"` script (URL or raw VTT),
+ *   delivered at runtime — the video pauses on each cue so the description can
+ *   be spoken (extended audio description), then resumes. Used only when
+ *   `describedSrc` is absent.
  */
-type FormatPreset = {
-  type: "number";
-} | {
-  type: "currency";
-  currency?: string;
-} | {
-  type: "percent";
-} | {
-  type: "compact";
-};
-interface ChatDashboardChartConfigBase {
-  showLegend?: boolean;
-  showGrid?: boolean;
-  showLabels?: boolean;
-  valueFormat?: FormatPreset;
-}
-interface ChatDashboardBarChartConfig extends ChatDashboardChartConfigBase {
-  type: "bar";
-  orientation?: "vertical" | "horizontal";
-  stacked?: boolean;
-}
-interface ChatDashboardLineChartConfig extends ChatDashboardChartConfigBase {
-  type: "line";
-  lineType?: "linear" | "smooth" | "step";
-  showArea?: boolean;
-  showDots?: boolean;
-}
-interface ChatDashboardFunnelChartConfig {
-  type: "funnel";
-  sort?: "descending" | "ascending" | "none";
-  orient?: "horizontal" | "vertical";
-  labelPosition?: "inside" | "outside";
-  showLegend?: boolean;
-  showLabels?: boolean;
-  showConversion?: boolean;
-  valueFormat?: FormatPreset;
-}
-interface ChatDashboardRadarChartConfig extends ChatDashboardChartConfigBase {
-  type: "radar";
-  showArea?: boolean;
-}
-interface ChatDashboardPieChartConfig {
-  type: "pie";
-  innerRadius?: number;
-  showLegend?: boolean;
-  showLabels?: boolean;
-  showPercentage?: boolean;
-  valueFormat?: FormatPreset;
-}
-interface ChatDashboardGaugeChartConfig {
-  type: "gauge";
-  min?: number;
-  max?: number;
-  showValue?: boolean;
-  valueFormat?: FormatPreset;
-}
-interface ChatDashboardHeatmapChartConfig {
-  type: "heatmap";
-  min?: number;
-  max?: number;
-  showLabels?: boolean;
-  showVisualMap?: boolean;
-  valueFormat?: FormatPreset;
-}
-interface ChatDashboardScatterChartConfig {
-  type: "scatter";
-  pointSize?: number;
-  scaleAxes?: boolean;
-  showGrid?: boolean;
-  /** Only rendered with 2+ series, but still needed so a skeleton can reserve for it. */
-  showLegend?: boolean;
-  /** What the X measure is, e.g. "salary" — labels the x row in the tooltip */
-  xAxisName?: string;
-  /** What the Y measure is, e.g. "tenure" — labels the y row in the tooltip */
-  yAxisName?: string;
-  /** Pin the X axis bounds, e.g. 0 and 100 for a percentage */
-  xAxisMin?: number;
-  xAxisMax?: number;
-  /** Pin the Y axis bounds, e.g. 1 and 5 for a rating */
-  yAxisMin?: number;
-  yAxisMax?: number;
-  /** Print each point's label next to it. @default false */
-  showPointLabels?: boolean;
-  /** Merge points on nearly the same spot; hover lists them. @default false */
-  groupNearbyPoints?: boolean;
-  /** Render the axis names as axis titles. @default false */
-  showAxisNames?: boolean;
-  /** Formats the Y measure */
-  valueFormat?: FormatPreset;
-  /** Formats the X measure, which is a second measure rather than a category */
-  xValueFormat?: FormatPreset;
-}
-type ChatDashboardChartConfig = ChatDashboardBarChartConfig | ChatDashboardLineChartConfig | ChatDashboardFunnelChartConfig | ChatDashboardRadarChartConfig | ChatDashboardPieChartConfig | ChatDashboardGaugeChartConfig | ChatDashboardHeatmapChartConfig | ChatDashboardScatterChartConfig;
-type ChatDashboardMetricFormat = {
-  type: "number";
-} | {
-  type: "currency";
-  currency?: string;
-} | {
-  type: "percent";
-} | {
-  type: "custom";
-  suffix?: string;
-  prefix?: string;
-};
-interface DashboardFetchSpec {
-  fetch: {
-    toolId: string;
-    args: Record<string, unknown>;
-  }[];
-  query: string | null;
-  columnLabels?: Record<string, string>;
-}
-type AggregationType = "count" | "sum" | "avg" | "min" | "max" | "countDistinct";
-interface ChartComputation {
-  datasetId: string;
-  xAxis: string;
-  yAxis: string;
-  aggregation: AggregationType;
-  series?: string;
-  sortBy?: "value" | "category";
-  sortOrder?: "asc" | "desc";
-  limit?: number;
-}
-interface MetricComputation {
-  datasetId: string;
-  aggregation: AggregationType;
-  column?: string;
+interface VideoPlayerContent {
+  /**
+   * WebVTT URL, or raw WebVTT content, for captions shown during playback.
+   * Localizable — pass a per-locale list to offer captions in several languages.
+   */
+  captions?: Localized<string>;
+  /**
+   * A pre-produced described media source (description mixed into the audio),
+   * swapped in when audio description is enabled. Takes precedence over
+   * `descriptions`. Should match `src`'s duration so the position carries
+   * across the swap. Localizable.
+   */
+  describedSrc?: Localized<string>;
+  /**
+   * WebVTT URL, or raw WebVTT content, of a `kind="descriptions"` script.
+   * Delivered at runtime with extended (pausing) audio description when no
+   * `describedSrc` is provided. Localizable.
+   */
+  descriptions?: Localized<string>;
 }
-interface RadarComputation {
-  datasetId: string;
-  seriesColumn: string;
-  indicators: {
-    column: string;
+interface F0VideoPlayerProps extends DataAttributes {
+  /** Accessible name for this player region. Defaults to "Video player". */
+  ariaLabel?: string;
+  /**
+   * Video source URL. Localizable — pass a per-locale list of dubbed renditions
+   * to offer selectable audio languages; an "Audio" selector then appears,
+   * independent of the subtitle/caption language.
+   */
+  src: Localized<string>;
+  /**
+   * Initial language for localized content, matched against the provided
+   * locales exactly or by primary subtag, then the viewer's browser language,
+   * then the first provided. Applies to both the audio (`src`) and the text
+   * (`content`) language selections. Only relevant when more than one language
+   * is available.
+   */
+  defaultLanguage?: string;
+  /**
+   * Image URL shown while the video loads and before playback starts (the
+   * native `<video>` poster). Cleared by the browser once playback begins.
+   */
+  poster?: string;
+  /**
+   * Marks the video as having no audio (video-only). Captions (WCAG 2.1
+   * SC 1.2.2) don't apply to silent media, so this exempts the player from the
+   * captions requirement — `data-video-captions` is set to `"no-audio"` instead
+   * of `"missing"`. Note video-only content may still need a text/audio
+   * alternative for its visual information (SC 1.2.1) — audio description still
+   * works over a silent video (its description audio plays even though the video
+   * itself is muted). Browsers can't reliably detect the absence of audio before
+   * playback, so this is declared explicitly.
+   * @default false
+   */
+  silent?: boolean;
+  /**
+   * Structured content for the player. Currently carries `captions` (a WebVTT
+   * URL or raw WebVTT string) shown over the video during playback and
+   * toggled with the "CC" control. When `captions` is omitted, captions
+   * embedded in the video file are used instead.
+   */
+  content?: VideoPlayerContent;
+  /**
+   * Keep the controls bar visible during playback instead of auto-hiding it.
+   * By default the controls show while the video is paused and auto-hide while
+   * it plays (revealing on hover or keyboard focus); set this to keep them
+   * visible the whole time. Default `false`.
+   */
+  persistControls?: boolean;
+  /** Start playing on mount. Default `false`. */
+  autoPlay?: boolean;
+  /** Focus the player on mount so keyboard shortcuts work immediately. Default `false`. */
+  autoFocus?: boolean;
+  /**
+   * Optional download action rendered inside the player controls. Native media
+   * downloads remain disabled, so embedded surfaces that allow saving the
+   * source can expose an explicit, keyboard-accessible action here.
+   */
+  download?: {
     label: string;
-    max?: number;
-  }[];
-  limit?: number;
-  sortBy?: string;
-  sortOrder?: "asc" | "desc";
-}
-interface PieComputation {
-  datasetId: string;
-  nameColumn: string;
-  valueColumn: string;
-  aggregation: AggregationType;
-  sortBy?: "value" | "name";
-  sortOrder?: "asc" | "desc";
-  limit?: number;
-}
-interface GaugeComputation {
-  datasetId: string;
-  aggregation: AggregationType;
-  column?: string;
-  min?: number;
-  max?: number;
-  name?: string;
-}
-interface HeatmapComputation {
-  datasetId: string;
-  xAxis: string;
-  yAxis: string;
-  valueColumn: string;
-  aggregation: AggregationType;
+    onClick: () => void;
+  };
+  /**
+   * Prevent seeking past the furthest point already watched. Renders a marker at
+   * that position and blocks the cursor beyond it. Default `false`.
+   */
+  restrictForwardSeek?: boolean;
+  /** Called on play, on pause and on a recurring heartbeat during playback. */
+  onTrackAction?: () => void;
+  /**
+   * Called once when each watched-% milestone (`25`, `50`, `75`) is first
+   * reached. For progress analytics; completion is reported via `onComplete`.
+   */
+  onMilestone?: (milestone: number, video: HTMLVideoElement) => void;
+  /**
+   * Called once when the video is "watched enough": the remaining time drops to
+   * `min(10s, 3% of duration)` (the later of "last 10s" and "97%").
+   */
+  onComplete?: (video: HTMLVideoElement) => void;
 }
+//#endregion
+//#region src/blocks/F0VideoPlayer/internal.d.ts
 /**
- * Both axes are measures, so there is no aggregation: a scatter plots one
- * point per row rather than grouping rows into categories. `label` names the
- * column identifying each point, and `series` the optional column that splits
- * the points into colour groups.
+ * Video player built on a native `<video>` element.
+ *
+ *   useVideoState           → element ref, native listeners, derived state.
+ *   useFullscreen           → toggles fullscreen on the wrapper (keeps controls visible).
+ *   useKeyboardShortcuts    → Space, ←/→, ↑/↓, M, F.
+ *   useVideoTracking        → analytics callback on play/pause + interval.
+ *   useVideoMilestones      → watched-% milestone callbacks (25/50/75).
+ *   useVideoCompletion      → "watched enough" callback (min(10s, 3%)).
+ *   useRestrictForwardSeek  → blocks seeking past the furthest-watched point.
+ *   <Controls>              → presentation only; interactions delegated back here.
  */
-interface ScatterComputation {
-  datasetId: string;
-  xAxis: string;
-  yAxis: string;
-  label?: string;
-  series?: string;
-  limit?: number;
-}
-interface CollectionComputation {
-  datasetId: string;
-  sortBy?: string;
-  sortOrder?: "asc" | "desc";
-  limit?: number;
-}
-interface ChatDashboardFilterDefinition {
-  type: "in";
-  label: string;
-  column: string;
-  datasetId: string;
-}
-/** Granularity options exposed by F0's `OneDateNavigator`. */
-type ChatDashboardDateNavigationGranularity = "day" | "week" | "month" | "quarter" | "halfyear" | "year" | "range";
+declare function F0VideoPlayerInternal({ src, poster, ariaLabel, silent, persistControls, content, defaultLanguage, autoPlay, autoFocus, download, restrictForwardSeek, onTrackAction, onMilestone, onComplete, ...dataAttributes }: F0VideoPlayerProps): import("react").JSX.Element;
+//#endregion
+//#region src/blocks/F0VideoPlayer/F0VideoPlayer.d.ts
 /**
- * Navigation filter definitions emitted by the LLM via `displayDashboard`.
- * Discriminated on `type`. Today the only supported variant is
- * `dateNavigation`, which renders F0's date navigator above the dashboard
- * grid. The `column` and `datasetId` are agent-side metadata used by the
- * compute SQL builder; they are stripped before reaching F0AnalyticsDashboard.
+ * @experimental This is an experimental component, use it at your own risk.
+ *
+ * Video player built on a native `<video>` element with f0-styled controls
+ * (play/pause, seekbar, volume, playback speed, fullscreen) plus keyboard
+ * shortcuts. Analytics, watch-% milestones, completion and forward-seek
+ * restriction are built in and enabled via props (`onTrackAction`,
+ * `onMilestone`, `onComplete`, `restrictForwardSeek`).
  */
-interface ChatDashboardNavigationFilterDefinition {
-  type: "dateNavigation";
-  label: string;
-  column: string;
-  datasetId: string;
-  granularities: ChatDashboardDateNavigationGranularity[];
-  defaultGranularity?: ChatDashboardDateNavigationGranularity;
-}
-interface ChatDashboardColumn {
-  /** Column key — must match a key in each row object */
-  id: string;
-  /** Display header label */
-  label: string;
-  /** Optional fixed width in pixels */
-  width?: number;
+declare const F0VideoPlayer: WithDataTestIdReturnType<typeof F0VideoPlayerInternal>;
+//#endregion
+//#region src/elements/primitives/_primitives/F0Attachments/types.d.ts
+type AttachmentDocumentKind = F0DocumentKind;
+//#endregion
+//#region src/addons/ai/ai/F0AiFileAttachments/types.d.ts
+/**
+ * A file shown in the AI chat: something the person sent, or something the
+ * assistant produced. Built from the host's message parts with the adapters in
+ * `./adapters`.
+ */
+interface AiChatFile {
+  url: string;
+  name: string;
+  /**
+   * Declared type. Placeholder types (`application/octet-stream`,
+   * `application/vnd.factorial.*`) are ignored and the extension decides.
+   */
+  mimeType?: string;
+  /** Size in bytes, when known. */
+  size?: number;
   /**
-   * Optional header tooltip explaining what the column represents — formula
-   * or aggregation if derived, source if direct. Forwarded to the underlying
-   * table column's `info` prop. Omit when the label is self-explanatory.
+   * PDF rendering of a file the browser can't preview (docx, pptx, xlsx made
+   * by the agent). The card and viewer show it; downloads keep `url`.
    */
-  info?: string;
+  previewUrl?: string;
+  /** Smaller image for the transcript, or a video poster. */
+  thumbnailUrl?: string;
+  /** Intrinsic photo size; reserves the box before the photo loads. */
+  width?: number;
+  height?: number;
 }
-interface ChatDashboardItemBase {
-  id: string;
-  title: string;
-  description?: string;
-  /** Source attribution shown as a subtitle (e.g. "Based on 8 feedbacks from 3 evaluators") */
-  sourceDescription?: string;
+/**
+ * Which kind of preview a file opened. `document` covers everything the
+ * document viewer shows (pdf, sheets, Word, text, code, HTML); the exact
+ * family comes in `onOpenFile`'s third argument. Zips never open: their card
+ * downloads them.
+ */
+type AiChatFileKind = "image" | "video" | "audio" | "document" | "file";
+/**
+ * Makes a file URL loadable by the browser. Needed when files sit behind
+ * authentication headers that `<img>`, video and the PDF reader can't send.
+ *
+ * - Return a `Blob`: F0 creates the object URL, shares it between the card,
+ *   the lightbox and the download, and revokes it when nothing uses it.
+ * - Return a string: used as is (for example a signed URL).
+ * - Return null or undefined: the original URL is used.
+ *
+ * Results are shared while in use, so a URL is normally resolved once; it is
+ * resolved again after a failure or once nothing has shown it for a while.
+ * Must not throw for URLs it doesn't recognise.
+ */
+type AiChatFileUrlResolver = (url: string, context: {
+  signal: AbortSignal;
+}) => Promise<string | Blob | null | undefined> | string | Blob | null | undefined;
+interface AiChatFilePreviewConfig {
   /**
-   * Optional markdown explanation of how this item's data was calculated.
-   * Surfaced via the per-item dropdown's "Where does this data come from?"
-   * entry, which opens a dialog rendering the markdown. Omit to hide the
-   * entry — backwards compatible with persisted dashboards.
+   * Resolve file URLs before showing them. Without it, only files the browser
+   * already holds (`blob:` and `data:` URLs) get rich previews; anything else
+   * stays a download card, since the chat can't know the URL is loadable.
    */
-  explanation?: string;
+  resolveUrl?: AiChatFileUrlResolver;
   /**
-   * @deprecated Ignored by the renderer — items auto-size to equal-width
-   * slots based on the per-row slot budget. Kept for backwards compatibility
-   * with persisted layouts; safe to leave unset.
+   * Show rich previews for remote URLs without a resolver, when they load
+   * directly (public or cookie-authenticated files).
+   * @default false
    */
-  colSpan?: number;
+  directUrls?: boolean;
   /**
-   * @deprecated Use `itemHeight` (pixels) instead. Kept for backwards
-   * compatibility with persisted layouts: when `itemHeight` is unset, the
-   * grid still reads `rowSpan * 48` as a fallback.
+   * Separate registrable domain serving `f0-html-host/` (see its README).
+   * With it, HTML files run in that isolated origin; without it they run in
+   * an opaque-origin srcdoc frame inside this tab.
    */
-  rowSpan?: number;
+  htmlSandbox?: F0DocumentHtmlSandbox;
   /**
-   * Item height in pixels. Takes precedence over `rowSpan` when set. The
-   * row height in the grid is `max(itemHeight)` across all items in the row.
-   * Persisted resizes write a pixel-accurate value here; agent-generated
-   * dashboards should pick from a constrained set of values that match the
-   * data shape (more rows / more categories → taller).
+   * When HTML files run their scripts: "auto" on open, "ask" behind a "Run
+   * content" button, "never" static.
+   * @default "auto"
    */
-  itemHeight?: number;
-  x?: number;
-  y?: number;
+  htmlExecution?: F0DocumentHtmlExecution;
 }
-interface ChatDashboardChartItem extends ChatDashboardItemBase {
-  type: "chart";
-  chart: ChatDashboardChartConfig;
-  computation: ChartComputation | RadarComputation | PieComputation | GaugeComputation | HeatmapComputation | ScatterComputation;
+/** One file published by an agent's `showFiles` tool. */
+interface AiChatShowFilesItem {
+  path: string;
+  displayName?: string;
+  mimeType?: string;
+  bytes?: number;
+  /** Download URL, when the tool already built one. */
+  url?: string;
+  /** A PDF rendering of the file, written next to it by the agent. */
+  preview?: {
+    path: string;
+    url?: string;
+  };
 }
-interface ChatDashboardMetricItem extends ChatDashboardItemBase {
-  type: "metric";
-  format?: ChatDashboardMetricFormat;
-  decimals?: number;
-  computation: MetricComputation;
+//#endregion
+//#region src/addons/ai/ai/canvas/types.d.ts
+/**
+ * Base shape shared by all canvas content types.
+ * Every entity adds its own fields on top of this.
+ */
+interface CanvasContentBase {
+  type: string;
+  title: string;
+  description?: string;
+  toolCallId?: string;
+  /**
+   * Render this content across the whole frame, covering the docked chat
+   * instead of hugging a seam beside it. For content that is a step of its own
+   * rather than something you work through while talking — picking a template,
+   * say. The chat is only covered, never closed, so the conversation is exactly
+   * where it was when the canvas is dismissed.
+   *
+   * Deliberately NOT called `fullscreen`: the chat's own
+   * `visualizationMode: "fullscreen"` means the opposite arrangement (chat full
+   * width, no canvas), and going back to it is how a covering canvas is
+   * dismissed.
+   *
+   * Defaults to the docked split.
+   */
+  coversChat?: boolean;
+  /**
+   * Keep this docked content mounted, out of view, while the chat is
+   * fullscreen, and bring it back as it was when the chat docks again. For
+   * content the reader works on and would lose by expanding the chat, such as
+   * an editor with unsaved changes.
+   *
+   * Defaults to dropping the content when the chat goes fullscreen. Ignored
+   * with `coversChat`, which fullscreen always dismisses.
+   */
+  keepsUnderFullscreen?: boolean;
 }
-interface ChatDashboardCollectionItem extends ChatDashboardItemBase {
-  type: "collection";
-  columns: ChatDashboardColumn[];
-  computation: CollectionComputation;
+/**
+ * Dashboard canvas content — renders an analytics dashboard.
+ */
+type DashboardCanvasContent = CanvasContentBase & {
+  type: "dashboard";
+  config: ChatDashboardConfig;
+  apiConfig: {
+    baseUrl: string;
+    headers: Record<string, string>;
+    runtimeFetch?: typeof fetch;
+  };
+  /** Present when the dashboard is a pre-saved dashboard */
+  savedDashboardId?: string;
+  /** Category of the saved dashboard */
+  savedDashboardCategory?: string;
+  /** Description of the saved dashboard */
+  savedDashboardDescription?: string;
+  /** True when the agent has iterated on a saved dashboard but the user hasn't saved yet */
+  savedDashboardUnsaved?: boolean;
+};
+/**
+ * Form canvas content — renders an interactive F0Form in the canvas panel.
+ */
+type FormCanvasContent = CanvasContentBase & {
+  type: "form";
+  formName: string;
+  formDescription?: string;
+  formModule?: ModuleId;
+};
+/**
+ * Data download canvas content — renders a full data table with download options.
+ */
+type DataDownloadCanvasContent = CanvasContentBase & {
+  type: "dataDownload";
+  dataset: DataDownloadDataset;
+  filename?: string;
+  markdown?: string;
+};
+/**
+ * Autofill-timesheet canvas content — renders an editable timesheet proposal
+ * (day-grouped shift blocks the user can adjust and confirm) in the canvas panel.
+ */
+type AutofillTimesheetCanvasContent = CanvasContentBase & {
+  type: "autofillTimesheet";
+  employeeId: string;
+  startOn: string;
+  endOn: string;
+  shifts: AutofillTimesheetShift[];
+};
+/**
+ * Bulk-resolve-inconsistencies canvas content — renders an AI-grouped proposal
+ * for resolving open time-tracking inconsistencies (a reviewable collection of
+ * employees/rows the user can trim and apply). Carries scope identity only:
+ * the proposal rows live in host state, keyed by this scope.
+ */
+type BulkResolveInconsistenciesCanvasContent = CanvasContentBase & {
+  type: "bulkResolveInconsistencies";
+  /** Analysed period, YYYY-MM-DD. */
+  periodStart: string;
+  periodEnd: string;
+  /** Exact row ids the proposal was scoped to; null when the whole period was analysed. */
+  scopeInconsistencyIds?: string[] | null;
+};
+/**
+ * File canvas content: files the assistant sent, previewed beside the chat.
+ * Built into the chat (no host entity needed); `F0AiFileAttachments` opens it
+ * for assistant files that have a preview.
+ */
+type FileCanvasContent = CanvasContentBase & {
+  type: "file";
+  /** The files the canvas pages through, in the message's order. */
+  files: AiChatFile[];
+  /** The file on screen. */
+  index: number;
+};
+/**
+ * Discriminated union for canvas panel content.
+ * Add new entity types to this union as they are implemented.
+ */
+type CanvasContent = DashboardCanvasContent | FormCanvasContent | DataDownloadCanvasContent | AutofillTimesheetCanvasContent | BulkResolveInconsistenciesCanvasContent | FileCanvasContent;
+/**
+ * Canvas-level action callbacks grouped by entity type.
+ * Each entity defines its own actions type; this aggregates them.
+ * Passed by the host app to F0AiChatProvider via `canvasActions`.
+ */
+interface CanvasActions {
+  dashboard?: DashboardCanvasActions;
 }
-type ChatDashboardItem = ChatDashboardChartItem | ChatDashboardMetricItem | ChatDashboardCollectionItem;
 /**
- * Complete dashboard configuration received via `displayDashboard`.
- * Contains fetchSpecs that describe how to obtain data server-side —
- * no raw data is included. Fully JSON-serializable.
+ * Contract for a canvas entity type.
+ *
+ * Each entity (dashboard, survey, goal, job-posting…) implements this
+ * interface and is added to the `canvasEntities` record passed to F0AiChat.
  */
-interface ChatDashboardConfig {
-  /** Dashboard title displayed in the canvas header and chat report card */
-  title: string;
+interface 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 the full header (title, actions, close button) */
+  renderHeader: (props: {
+    content: T;
+    onClose: () => void;
+  }) => ReactNode;
   /**
-   * AI-generated 1–2 sentence summary of what the dashboard shows. Displayed
-   * under the title in the canvas header. Optional at the type level so
-   * legacy persisted dashboards (before the agent started emitting it) still
-   * parse; the agent schema makes it required going forward.
+   * Optional wrapper providing entity-scoped context around
+   * both header and body (e.g. shared edit-mode state).
    */
-  description?: string;
-  /** Filter definitions — keys become filter IDs */
-  filters?: Record<string, ChatDashboardFilterDefinition>;
+  wrapper?: (props: {
+    content: T;
+    children: ReactNode;
+  }) => ReactNode;
   /**
-   * Dashboard-level navigation filters (e.g. date navigator). Keys become
-   * filter IDs. Rendered above the grid by F0AnalyticsDashboard's
-   * `navigationFilters` slot.
+   * When true the content area uses `overflow-hidden` instead of
+   * `overflow-auto`, letting the entity manage its own scrolling.
    */
-  navigationFilters?: Record<string, ChatDashboardNavigationFilterDefinition>;
-  /** Ordered list of dashboard items with computation specs */
-  items: ChatDashboardItem[];
-  /** Fetch specs for server-side data retrieval, keyed by datasetId */
-  fetchSpecs: Record<string, DashboardFetchSpec>;
+  overflowHidden?: boolean;
 }
 /**
- * Creator + last-edited metadata for a saved dashboard. Returned by
- * `DashboardCanvasActions.getMetadata` so the header can render the author
- * avatar and the freshness signal only once a dashboard has been persisted.
- *
- * `title` and `description` are also returned: once a dashboard has an id
- * the backend is the source of truth and may diverge from what's stored in
- * the chat history (e.g. someone renamed the dashboard from the Analytics
- * list page since this conversation was first opened). The header prefers
- * these values over the ones baked into `content` / `config`.
+ * Inline dataset for client-side file generation (Excel / CSV).
+ * Sent by the agent with the raw query results.
  */
-interface DashboardMetadata {
+interface DataDownloadDataset {
+  /** Column headers in display order. */
+  columns: string[];
+  /** Array of row objects keyed by column name. */
+  rows: Record<string, unknown>[];
   /**
-   * Latest persisted title. When present, the header displays this instead
-   * of `content.title` so the chat-history snapshot never shadows the
-   * authoritative backend copy.
+   * Total number of rows returned by the query (before truncation).
+   * Used together with previewCount to render the preview note.
    */
-  title?: string;
+  totalCount?: number;
   /**
-   * Latest persisted description. Same rationale as `title` — takes
-   * precedence over `config.description` once the dashboard is saved.
+   * Number of rows shown in the markdown preview table.
+   * Used together with totalCount to render the preview note.
    */
-  description?: string;
-  creator: {
-    firstName: string;
-    lastName: string;
-    /** Optional avatar image URL. Falls back to initials when omitted. */
-    src?: string;
-  };
+  previewCount?: number;
   /**
-   * Last edited timestamp. Accepts `Date` or an ISO-8601 string so host apps
-   * can forward backend payloads verbatim without pre-parsing.
+   * Map of raw column names to human-readable labels in the user's language.
+   * Used for Excel/CSV headers. Falls back to the raw column name when absent.
    */
-  lastEdited: Date | string;
+  columnLabels?: Record<string, string>;
 }
 /**
- * Callbacks for persisting dashboards externally (beyond chat history).
+ * A single proposed shift block in a timesheet-autofill preview. Every proposed
+ * block carries concrete employee-local clock times (ISO datetime or "HH:MM");
+ * days that cannot be proposed are omitted rather than emitted with empty bounds.
  */
-interface DashboardCanvasActions {
-  /** Update an existing saved dashboard */
-  save: (id: string, category: string, config: ChatDashboardConfig) => Promise<void>;
-  /**
-   * Create a new saved dashboard. Returns the new dashboard's id and
-   * category so subsequent edits can call `save` (which requires both).
-   * Returning void / undefined leaves the canvas in its current state.
-   */
-  create: (title: string, description: string, config: ChatDashboardConfig, category?: string) => Promise<{
-    id: string;
-    category: string;
-  } | void>;
+interface AutofillTimesheetShift {
+  date: string;
+  clockIn: string;
+  clockOut: string;
+  workable: boolean;
+  workplaceId?: string | null;
+  workAreaId?: string | null;
   /**
-   * Fetch creator + last-edited metadata for a saved dashboard. The header
-   * calls this lazily, only when the current dashboard has a
-   * `savedDashboardId`. Returning `void` signals "no metadata available" —
-   * the header will skip rendering the avatar and the last-edited row
-   * instead of showing a placeholder.
+   * Host-defined work-location kind. Left as a loose string to keep the kit
+   * host-agnostic; the factorial consumer narrows it to its attendance
+   * location-type enum (today: "office" | "work_from_home" | "business_trip").
    */
-  getMetadata?: (id: string) => Promise<DashboardMetadata | void>;
-}
-//#endregion
-//#region src/elements/lib/global.types.d.ts
-interface DataAttributes {
-  [key: `data-${string}`]: string | undefined;
+  locationType?: string | null;
 }
-//#endregion
-//#region src/addons/documents/F0DocumentViewer/types.d.ts
-declare const pdfScales: readonly ["page-width", "page-fit", "0.5", "0.75", "1", "1.25", "1.5", "2", "3", "4"];
-type F0PdfScale = (typeof pdfScales)[number];
-type F0PdfRotation = 0 | 90 | 180 | 270;
-/**
- * Document families the viewer can render. "pdf" is the default and keeps the
- * full toolbar (paging, zoom, print, download); the other kinds render a
- * lazy-loaded, read-only preview: "sheet" (xlsx/csv) as an Excel-style
- * grid with one tab per sheet, "docx" through docx-preview with page layout,
- * "text" as a rendered markdown document (`.md`) or monospaced source,
- * "code" as syntax-highlighted source, "html" as a sandboxed page running its
- * scripts and "archive" as the file listing of a zip (never extracted).
- */
-type F0DocumentKind = "pdf" | "sheet" | "docx" | "text" | "code" | "html" | "archive";
 /**
- * When an HTML document's scripts may run. "auto" runs them on open, in the
- * isolated `htmlSandbox` origin when there is one, else in an opaque-origin
- * srcdoc frame. "ask" opens static with a "Run content" button. "never" keeps
- * it static.
+ * A preset formatting instruction the LLM can specify instead of a
+ * real formatter function. The wrapper component maps these to actual
+ * `(value: number) => string` functions at render time.
  */
-type F0DocumentHtmlExecution = "auto" | "ask" | "never";
-/** A separate registrable domain serving `f0-html-host/` (see its README). */
-interface F0DocumentHtmlSandbox {
-  /** Exact origin, e.g. "https://usercontent.example.com". */
-  origin: string;
+type FormatPreset = {
+  type: "number";
+} | {
+  type: "currency";
+  currency?: string;
+} | {
+  type: "percent";
+} | {
+  type: "compact";
+};
+interface ChatDashboardChartConfigBase {
+  showLegend?: boolean;
+  showGrid?: boolean;
+  showLabels?: boolean;
+  valueFormat?: FormatPreset;
+}
+interface ChatDashboardBarChartConfig extends ChatDashboardChartConfigBase {
+  type: "bar";
+  orientation?: "vertical" | "horizontal";
+  stacked?: boolean;
+}
+interface ChatDashboardLineChartConfig extends ChatDashboardChartConfigBase {
+  type: "line";
+  lineType?: "linear" | "smooth" | "step";
+  showArea?: boolean;
+  showDots?: boolean;
+}
+interface ChatDashboardFunnelChartConfig {
+  type: "funnel";
+  sort?: "descending" | "ascending" | "none";
+  orient?: "horizontal" | "vertical";
+  labelPosition?: "inside" | "outside";
+  showLegend?: boolean;
+  showLabels?: boolean;
+  showConversion?: boolean;
+  valueFormat?: FormatPreset;
+}
+interface ChatDashboardRadarChartConfig extends ChatDashboardChartConfigBase {
+  type: "radar";
+  showArea?: boolean;
+}
+interface ChatDashboardPieChartConfig {
+  type: "pie";
+  innerRadius?: number;
+  showLegend?: boolean;
+  showLabels?: boolean;
+  showPercentage?: boolean;
+  valueFormat?: FormatPreset;
+}
+interface ChatDashboardGaugeChartConfig {
+  type: "gauge";
+  min?: number;
+  max?: number;
+  showValue?: boolean;
+  valueFormat?: FormatPreset;
+}
+interface ChatDashboardHeatmapChartConfig {
+  type: "heatmap";
+  min?: number;
+  max?: number;
+  showLabels?: boolean;
+  showVisualMap?: boolean;
+  valueFormat?: FormatPreset;
+}
+interface ChatDashboardScatterChartConfig {
+  type: "scatter";
+  pointSize?: number;
+  scaleAxes?: boolean;
+  showGrid?: boolean;
+  /** Only rendered with 2+ series, but still needed so a skeleton can reserve for it. */
+  showLegend?: boolean;
+  /** What the X measure is, e.g. "salary" — labels the x row in the tooltip */
+  xAxisName?: string;
+  /** What the Y measure is, e.g. "tenure" — labels the y row in the tooltip */
+  yAxisName?: string;
+  /** Pin the X axis bounds, e.g. 0 and 100 for a percentage */
+  xAxisMin?: number;
+  xAxisMax?: number;
+  /** Pin the Y axis bounds, e.g. 1 and 5 for a rating */
+  yAxisMin?: number;
+  yAxisMax?: number;
+  /** Print each point's label next to it. @default false */
+  showPointLabels?: boolean;
+  /** Merge points on nearly the same spot; hover lists them. @default false */
+  groupNearbyPoints?: boolean;
+  /** Render the axis names as axis titles. @default false */
+  showAxisNames?: boolean;
+  /** Formats the Y measure */
+  valueFormat?: FormatPreset;
+  /** Formats the X measure, which is a second measure rather than a category */
+  xValueFormat?: FormatPreset;
+}
+type ChatDashboardChartConfig = ChatDashboardBarChartConfig | ChatDashboardLineChartConfig | ChatDashboardFunnelChartConfig | ChatDashboardRadarChartConfig | ChatDashboardPieChartConfig | ChatDashboardGaugeChartConfig | ChatDashboardHeatmapChartConfig | ChatDashboardScatterChartConfig;
+type ChatDashboardMetricFormat = {
+  type: "number";
+} | {
+  type: "currency";
+  currency?: string;
+} | {
+  type: "percent";
+} | {
+  type: "custom";
+  suffix?: string;
+  prefix?: string;
+};
+interface DashboardFetchSpec {
+  fetch: {
+    toolId: string;
+    args: Record<string, unknown>;
+  }[];
+  query: string | null;
+  columnLabels?: Record<string, string>;
+}
+type AggregationType = "count" | "sum" | "avg" | "min" | "max" | "countDistinct";
+interface ChartComputation {
+  datasetId: string;
+  xAxis: string;
+  yAxis: string;
+  aggregation: AggregationType;
+  series?: string;
+  sortBy?: "value" | "category";
+  sortOrder?: "asc" | "desc";
+  limit?: number;
+}
+interface MetricComputation {
+  datasetId: string;
+  aggregation: AggregationType;
+  column?: string;
+}
+interface RadarComputation {
+  datasetId: string;
+  seriesColumn: string;
+  indicators: {
+    column: string;
+    label: string;
+    max?: number;
+  }[];
+  limit?: number;
+  sortBy?: string;
+  sortOrder?: "asc" | "desc";
 }
-/**
- * Where the toolbar sits. "top" (default) is a bar across the top of the
- * surface. "floating" is a dark pill that floats over the bottom of the
- * document, like an action bar — for hosts whose own header already carries
- * the title and the primary action (the AI chat canvas), so the controls stay
- * close to the content instead of competing with that header. "none" draws
- * no toolbar at all, for a host that already provides every control (the
- * chat attachment viewer on an HTML page).
- */
-type F0DocumentViewerToolbarPlacement = "top" | "floating" | "none";
-/**
- * Host-provided toolbar action, appended after the built-in controls in every
- * kind — e.g. a Close button when the viewer lives inside a fullscreen overlay.
- */
-interface F0DocumentViewerAction {
-  icon: IconType;
-  label: string;
-  onClick: () => void;
+interface PieComputation {
+  datasetId: string;
+  nameColumn: string;
+  valueColumn: string;
+  aggregation: AggregationType;
+  sortBy?: "value" | "name";
+  sortOrder?: "asc" | "desc";
+  limit?: number;
 }
-interface F0DocumentViewerProps extends WithDataTestIdProps, DataAttributes {
-  /** Source URL of the document. */
-  url: string;
-  /** File name used when downloading the document. Defaults to "document.pdf". */
-  filename?: string;
-  /**
-   * Document family to render. Defaults to "pdf" (unchanged behavior). For the
-   * other kinds the PDF-only props below (page, scale, rotation, print…) are
-   * ignored.
-   */
-  kind?: F0DocumentKind;
-  /** MIME type of the document — used by kind "text" to detect markdown. */
-  mimeType?: string;
-  /**
-   * Language for kind="code" (e.g. "typescript", "py"). Derived from the
-   * file name when omitted; unknown languages show as plain source.
-   */
-  language?: string;
-  /** Hide the built-in Download button, in every kind. */
-  hideDownload?: boolean;
-  /** kind="html": when scripts may run. Defaults to "auto". */
-  htmlExecution?: F0DocumentHtmlExecution;
-  /** kind="html": isolated origin where scripts run like a Claude artifact. */
-  htmlSandbox?: F0DocumentHtmlSandbox;
-  /** kind="html": who sent the file, shown as "Content from {sender}". */
-  sender?: string;
-  /** Toolbar placement, in every kind. Defaults to "top". */
-  toolbar?: F0DocumentViewerToolbarPlacement;
-  /**
-   * Custom actions appended to the toolbar (after the built-in controls), in
-   * every kind — e.g. a Close button when the viewer fills an overlay.
-   */
-  actions?: F0DocumentViewerAction[];
-  /** Zero-based page index to scroll to initially (and on change). */
-  page?: number;
-  /** Restrict rendering to a subset of pages (zero-based indexes). */
-  pagesToDisplay?: number[];
-  /** Initial zoom level. Defaults to "page-width". */
-  initialScale?: F0PdfScale;
-  /** Send credentials with the document request. Defaults to true. */
-  withCredentials?: boolean;
-  /** Show a toolbar control to rotate the document in 90° steps. */
-  rotatable?: boolean;
-  /** Initial rotation in degrees. Defaults to 0. */
-  initialRotation?: F0PdfRotation;
-  /** Called with the new rotation in degrees whenever the user rotates. */
-  onRotationChange?: (rotation: F0PdfRotation) => void;
-  /** Called once the document has loaded, with the pdf.js document proxy. */
-  onPdfLoaded?: (pdf: PDFDocumentProxy) => void;
-  /** Called with the 1-based page number when the visible page changes. */
-  onPageChange?: (page: number) => void;
+interface GaugeComputation {
+  datasetId: string;
+  aggregation: AggregationType;
+  column?: string;
+  min?: number;
+  max?: number;
+  name?: string;
+}
+interface HeatmapComputation {
+  datasetId: string;
+  xAxis: string;
+  yAxis: string;
+  valueColumn: string;
+  aggregation: AggregationType;
 }
-//#endregion
-//#region src/addons/documents/F0DocumentViewer/F0DocumentViewerSkeleton.d.ts
-declare const F0DocumentViewerSkeleton: () => import("react").JSX.Element;
-//#endregion
-//#region src/addons/documents/F0DocumentViewer/F0DocumentViewer.d.ts
-/**
- * @experimental This is an experimental component, use it at your own risk.
- */
-declare const F0DocumentViewer: WithDataTestIdReturnType<import("react").ForwardRefExoticComponent<F0DocumentViewerProps & import("react").RefAttributes<HTMLDivElement>> & {
-  Skeleton: typeof F0DocumentViewerSkeleton;
-}>;
-/** @deprecated Renamed to `F0DocumentViewer`: it previews PDF, Word, Excel and text. */
-declare const F0PdfViewer: WithDataTestIdReturnType<import("react").ForwardRefExoticComponent<F0DocumentViewerProps & import("react").RefAttributes<HTMLDivElement>> & {
-  Skeleton: typeof F0DocumentViewerSkeleton;
-}>;
-/** @deprecated Renamed to `F0DocumentViewerProps`. */
-type F0PdfViewerProps = F0DocumentViewerProps;
-/** @deprecated Renamed to `F0DocumentViewerToolbarPlacement`. */
-type F0PdfViewerToolbarPlacement = F0DocumentViewerToolbarPlacement;
-/** @deprecated Renamed to `F0DocumentViewerAction`. */
-type F0PdfViewerAction = F0DocumentViewerAction;
-//#endregion
-//#region src/elements/lib/localized.d.ts
 /**
- * Shared helpers for content that can be provided in one language (a plain
- * value) or several (a list of per-locale entries) — used by the media players
- * for captions, descriptions, transcriptions and summaries.
+ * Both axes are measures, so there is no aggregation: a scatter plots one
+ * point per row rather than grouping rows into categories. `label` names the
+ * column identifying each point, and `series` the optional column that splits
+ * the points into colour groups.
  */
-interface LocalizedOption<T> {
-  /** BCP-47 language tag, e.g. `"en"`, `"es"`, `"en-US"`. */
-  locale: string;
-  /**
-   * Display label for the language picker. Defaults to the language name for
-   * `locale` (via `Intl.DisplayNames`), so this is only needed to override it.
-   */
+interface ScatterComputation {
+  datasetId: string;
+  xAxis: string;
+  yAxis: string;
   label?: string;
-  /** The value for this locale. */
-  value: T;
+  series?: string;
+  limit?: number;
 }
-/** A single value, or the same value provided in multiple languages. */
-type Localized<T> = T | LocalizedOption<T>[];
-//#endregion
-//#region src/blocks/F0VideoPlayer/types.d.ts
+interface CollectionComputation {
+  datasetId: string;
+  sortBy?: string;
+  sortOrder?: "asc" | "desc";
+  limit?: number;
+}
+interface ChatDashboardFilterDefinition {
+  type: "in";
+  label: string;
+  column: string;
+  datasetId: string;
+}
+/** Granularity options exposed by F0's `OneDateNavigator`. */
+type ChatDashboardDateNavigationGranularity = "day" | "week" | "month" | "quarter" | "halfyear" | "year" | "range";
 /**
- * Structured content for the video player.
- *
- * Every field accepts either a single value or a localized list
- * (`[{ locale, label?, value }]`) — pass several languages and a language
- * selector appears in the controls. A single shared selection drives captions,
- * descriptions and the described source together (each falls back to its first
- * entry for languages it doesn't provide). See `F0VideoPlayerProps.defaultLanguage`.
- *
- * `captions` are timed text shown over the video during playback (WCAG 2.1
- * SC 1.2.2, Captions). Pass either a WebVTT resource URL or a raw WebVTT string
- * (the player turns raw VTT into a blob track, so no CORS setup is needed); a
- * remote URL requires the video host to allow cross-origin reads. When omitted,
- * the player uses any caption/subtitle track embedded in the video file. A
- * captions toggle in the controls shows/hides them (a filled glyph when on, a
- * line glyph when off).
- *
- * Audio description (WCAG 2.1 SC 1.2.5) conveys on-screen visual information as
- * audio, complementary to captions — both are independent and can be on at
- * once. Provide it in one of two ways, toggled with the audio-description
- * control (a filled "AD" badge when on, a line badge when off):
- * - `describedSrc`: a pre-produced media rendition with description mixed into
- *   the audio. Toggling swaps the source, preserving position and play state.
- *   Highest quality; assumed the same length as `src`.
- * - `descriptions`: a WebVTT `kind="descriptions"` script (URL or raw VTT),
- *   delivered at runtime — the video pauses on each cue so the description can
- *   be spoken (extended audio description), then resumes. Used only when
- *   `describedSrc` is absent.
+ * Navigation filter definitions emitted by the LLM via `displayDashboard`.
+ * Discriminated on `type`. Today the only supported variant is
+ * `dateNavigation`, which renders F0's date navigator above the dashboard
+ * grid. The `column` and `datasetId` are agent-side metadata used by the
+ * compute SQL builder; they are stripped before reaching F0AnalyticsDashboard.
  */
-interface VideoPlayerContent {
-  /**
-   * WebVTT URL, or raw WebVTT content, for captions shown during playback.
-   * Localizable — pass a per-locale list to offer captions in several languages.
-   */
-  captions?: Localized<string>;
-  /**
-   * A pre-produced described media source (description mixed into the audio),
-   * swapped in when audio description is enabled. Takes precedence over
-   * `descriptions`. Should match `src`'s duration so the position carries
-   * across the swap. Localizable.
-   */
-  describedSrc?: Localized<string>;
-  /**
-   * WebVTT URL, or raw WebVTT content, of a `kind="descriptions"` script.
-   * Delivered at runtime with extended (pausing) audio description when no
-   * `describedSrc` is provided. Localizable.
-   */
-  descriptions?: Localized<string>;
-}
-interface F0VideoPlayerProps extends DataAttributes {
-  /** Accessible name for this player region. Defaults to "Video player". */
-  ariaLabel?: string;
-  /**
-   * Video source URL. Localizable — pass a per-locale list of dubbed renditions
-   * to offer selectable audio languages; an "Audio" selector then appears,
-   * independent of the subtitle/caption language.
-   */
-  src: Localized<string>;
-  /**
-   * Initial language for localized content, matched against the provided
-   * locales exactly or by primary subtag, then the viewer's browser language,
-   * then the first provided. Applies to both the audio (`src`) and the text
-   * (`content`) language selections. Only relevant when more than one language
-   * is available.
-   */
-  defaultLanguage?: string;
-  /**
-   * Image URL shown while the video loads and before playback starts (the
-   * native `<video>` poster). Cleared by the browser once playback begins.
-   */
-  poster?: string;
-  /**
-   * Marks the video as having no audio (video-only). Captions (WCAG 2.1
-   * SC 1.2.2) don't apply to silent media, so this exempts the player from the
-   * captions requirement — `data-video-captions` is set to `"no-audio"` instead
-   * of `"missing"`. Note video-only content may still need a text/audio
-   * alternative for its visual information (SC 1.2.1) — audio description still
-   * works over a silent video (its description audio plays even though the video
-   * itself is muted). Browsers can't reliably detect the absence of audio before
-   * playback, so this is declared explicitly.
-   * @default false
-   */
-  silent?: boolean;
-  /**
-   * Structured content for the player. Currently carries `captions` (a WebVTT
-   * URL or raw WebVTT string) shown over the video during playback and
-   * toggled with the "CC" control. When `captions` is omitted, captions
-   * embedded in the video file are used instead.
-   */
-  content?: VideoPlayerContent;
+interface ChatDashboardNavigationFilterDefinition {
+  type: "dateNavigation";
+  label: string;
+  column: string;
+  datasetId: string;
+  granularities: ChatDashboardDateNavigationGranularity[];
+  defaultGranularity?: ChatDashboardDateNavigationGranularity;
+}
+interface ChatDashboardColumn {
+  /** Column key — must match a key in each row object */
+  id: string;
+  /** Display header label */
+  label: string;
+  /** Optional fixed width in pixels */
+  width?: number;
   /**
-   * Keep the controls bar visible during playback instead of auto-hiding it.
-   * By default the controls show while the video is paused and auto-hide while
-   * it plays (revealing on hover or keyboard focus); set this to keep them
-   * visible the whole time. Default `false`.
+   * Optional header tooltip explaining what the column represents — formula
+   * or aggregation if derived, source if direct. Forwarded to the underlying
+   * table column's `info` prop. Omit when the label is self-explanatory.
    */
-  persistControls?: boolean;
-  /** Start playing on mount. Default `false`. */
-  autoPlay?: boolean;
-  /** Focus the player on mount so keyboard shortcuts work immediately. Default `false`. */
-  autoFocus?: boolean;
+  info?: string;
+}
+interface ChatDashboardItemBase {
+  id: string;
+  title: string;
+  description?: string;
+  /** Source attribution shown as a subtitle (e.g. "Based on 8 feedbacks from 3 evaluators") */
+  sourceDescription?: string;
   /**
-   * Optional download action rendered inside the player controls. Native media
-   * downloads remain disabled, so embedded surfaces that allow saving the
-   * source can expose an explicit, keyboard-accessible action here.
+   * Optional markdown explanation of how this item's data was calculated.
+   * Surfaced via the per-item dropdown's "Where does this data come from?"
+   * entry, which opens a dialog rendering the markdown. Omit to hide the
+   * entry — backwards compatible with persisted dashboards.
    */
-  download?: {
-    label: string;
-    onClick: () => void;
-  };
+  explanation?: string;
   /**
-   * Prevent seeking past the furthest point already watched. Renders a marker at
-   * that position and blocks the cursor beyond it. Default `false`.
+   * @deprecated Ignored by the renderer — items auto-size to equal-width
+   * slots based on the per-row slot budget. Kept for backwards compatibility
+   * with persisted layouts; safe to leave unset.
    */
-  restrictForwardSeek?: boolean;
-  /** Called on play, on pause and on a recurring heartbeat during playback. */
-  onTrackAction?: () => void;
+  colSpan?: number;
   /**
-   * Called once when each watched-% milestone (`25`, `50`, `75`) is first
-   * reached. For progress analytics; completion is reported via `onComplete`.
+   * @deprecated Use `itemHeight` (pixels) instead. Kept for backwards
+   * compatibility with persisted layouts: when `itemHeight` is unset, the
+   * grid still reads `rowSpan * 48` as a fallback.
    */
-  onMilestone?: (milestone: number, video: HTMLVideoElement) => void;
+  rowSpan?: number;
   /**
-   * Called once when the video is "watched enough": the remaining time drops to
-   * `min(10s, 3% of duration)` (the later of "last 10s" and "97%").
+   * Item height in pixels. Takes precedence over `rowSpan` when set. The
+   * row height in the grid is `max(itemHeight)` across all items in the row.
+   * Persisted resizes write a pixel-accurate value here; agent-generated
+   * dashboards should pick from a constrained set of values that match the
+   * data shape (more rows / more categories → taller).
    */
-  onComplete?: (video: HTMLVideoElement) => void;
+  itemHeight?: number;
+  x?: number;
+  y?: number;
 }
-//#endregion
-//#region src/blocks/F0VideoPlayer/internal.d.ts
-/**
- * Video player built on a native `<video>` element.
- *
- *   useVideoState           → element ref, native listeners, derived state.
- *   useFullscreen           → toggles fullscreen on the wrapper (keeps controls visible).
- *   useKeyboardShortcuts    → Space, ←/→, ↑/↓, M, F.
- *   useVideoTracking        → analytics callback on play/pause + interval.
- *   useVideoMilestones      → watched-% milestone callbacks (25/50/75).
- *   useVideoCompletion      → "watched enough" callback (min(10s, 3%)).
- *   useRestrictForwardSeek  → blocks seeking past the furthest-watched point.
- *   <Controls>              → presentation only; interactions delegated back here.
- */
-declare function F0VideoPlayerInternal({ src, poster, ariaLabel, silent, persistControls, content, defaultLanguage, autoPlay, autoFocus, download, restrictForwardSeek, onTrackAction, onMilestone, onComplete, ...dataAttributes }: F0VideoPlayerProps): import("react").JSX.Element;
-//#endregion
-//#region src/blocks/F0VideoPlayer/F0VideoPlayer.d.ts
-/**
- * @experimental This is an experimental component, use it at your own risk.
- *
- * Video player built on a native `<video>` element with f0-styled controls
- * (play/pause, seekbar, volume, playback speed, fullscreen) plus keyboard
- * shortcuts. Analytics, watch-% milestones, completion and forward-seek
- * restriction are built in and enabled via props (`onTrackAction`,
- * `onMilestone`, `onComplete`, `restrictForwardSeek`).
- */
-declare const F0VideoPlayer: WithDataTestIdReturnType<typeof F0VideoPlayerInternal>;
-//#endregion
-//#region src/elements/primitives/_primitives/F0Attachments/types.d.ts
-type AttachmentDocumentKind = F0DocumentKind;
-//#endregion
-//#region src/addons/ai/ai/F0AiFileAttachments/types.d.ts
+interface ChatDashboardChartItem extends ChatDashboardItemBase {
+  type: "chart";
+  chart: ChatDashboardChartConfig;
+  computation: ChartComputation | RadarComputation | PieComputation | GaugeComputation | HeatmapComputation | ScatterComputation;
+}
+interface ChatDashboardMetricItem extends ChatDashboardItemBase {
+  type: "metric";
+  format?: ChatDashboardMetricFormat;
+  decimals?: number;
+  computation: MetricComputation;
+}
+interface ChatDashboardCollectionItem extends ChatDashboardItemBase {
+  type: "collection";
+  columns: ChatDashboardColumn[];
+  computation: CollectionComputation;
+}
+type ChatDashboardItem = ChatDashboardChartItem | ChatDashboardMetricItem | ChatDashboardCollectionItem;
 /**
- * A file shown in the AI chat: something the person sent, or something the
- * assistant produced. Built from the host's message parts with the adapters in
- * `./adapters`.
+ * Complete dashboard configuration received via `displayDashboard`.
+ * Contains fetchSpecs that describe how to obtain data server-side —
+ * no raw data is included. Fully JSON-serializable.
  */
-interface AiChatFile {
-  url: string;
-  name: string;
+interface ChatDashboardConfig {
+  /** Dashboard title displayed in the canvas header and chat report card */
+  title: string;
   /**
-   * Declared type. Placeholder types (`application/octet-stream`,
-   * `application/vnd.factorial.*`) are ignored and the extension decides.
+   * AI-generated 1–2 sentence summary of what the dashboard shows. Displayed
+   * under the title in the canvas header. Optional at the type level so
+   * legacy persisted dashboards (before the agent started emitting it) still
+   * parse; the agent schema makes it required going forward.
    */
-  mimeType?: string;
-  /** Size in bytes, when known. */
-  size?: number;
+  description?: string;
+  /** Filter definitions — keys become filter IDs */
+  filters?: Record<string, ChatDashboardFilterDefinition>;
   /**
-   * PDF rendering of a file the browser can't preview (docx, pptx, xlsx made
-   * by the agent). The card and viewer show it; downloads keep `url`.
+   * Dashboard-level navigation filters (e.g. date navigator). Keys become
+   * filter IDs. Rendered above the grid by F0AnalyticsDashboard's
+   * `navigationFilters` slot.
    */
-  previewUrl?: string;
-  /** Smaller image for the transcript, or a video poster. */
-  thumbnailUrl?: string;
-  /** Intrinsic photo size; reserves the box before the photo loads. */
-  width?: number;
-  height?: number;
+  navigationFilters?: Record<string, ChatDashboardNavigationFilterDefinition>;
+  /** Ordered list of dashboard items with computation specs */
+  items: ChatDashboardItem[];
+  /** Fetch specs for server-side data retrieval, keyed by datasetId */
+  fetchSpecs: Record<string, DashboardFetchSpec>;
 }
 /**
- * Which kind of preview a file opened. `document` covers everything the
- * document viewer shows (pdf, sheets, Word, text, code, HTML); the exact
- * family comes in `onOpenFile`'s third argument. Zips never open: their card
- * downloads them.
- */
-type AiChatFileKind = "image" | "video" | "audio" | "document" | "file";
-/**
- * Makes a file URL loadable by the browser. Needed when files sit behind
- * authentication headers that `<img>`, video and the PDF reader can't send.
- *
- * - Return a `Blob`: F0 creates the object URL, shares it between the card,
- *   the lightbox and the download, and revokes it when nothing uses it.
- * - Return a string: used as is (for example a signed URL).
- * - Return null or undefined: the original URL is used.
+ * Creator + last-edited metadata for a saved dashboard. Returned by
+ * `DashboardCanvasActions.getMetadata` so the header can render the author
+ * avatar and the freshness signal only once a dashboard has been persisted.
  *
- * Results are shared while in use, so a URL is normally resolved once; it is
- * resolved again after a failure or once nothing has shown it for a while.
- * Must not throw for URLs it doesn't recognise.
+ * `title` and `description` are also returned: once a dashboard has an id
+ * the backend is the source of truth and may diverge from what's stored in
+ * the chat history (e.g. someone renamed the dashboard from the Analytics
+ * list page since this conversation was first opened). The header prefers
+ * these values over the ones baked into `content` / `config`.
  */
-type AiChatFileUrlResolver = (url: string, context: {
-  signal: AbortSignal;
-}) => Promise<string | Blob | null | undefined> | string | Blob | null | undefined;
-interface AiChatFilePreviewConfig {
+interface DashboardMetadata {
   /**
-   * Resolve file URLs before showing them. Without it, only files the browser
-   * already holds (`blob:` and `data:` URLs) get rich previews; anything else
-   * stays a download card, since the chat can't know the URL is loadable.
+   * Latest persisted title. When present, the header displays this instead
+   * of `content.title` so the chat-history snapshot never shadows the
+   * authoritative backend copy.
    */
-  resolveUrl?: AiChatFileUrlResolver;
+  title?: string;
   /**
-   * Show rich previews for remote URLs without a resolver, when they load
-   * directly (public or cookie-authenticated files).
-   * @default false
+   * Latest persisted description. Same rationale as `title` — takes
+   * precedence over `config.description` once the dashboard is saved.
    */
-  directUrls?: boolean;
+  description?: string;
+  creator: {
+    firstName: string;
+    lastName: string;
+    /** Optional avatar image URL. Falls back to initials when omitted. */
+    src?: string;
+  };
   /**
-   * Separate registrable domain serving `f0-html-host/` (see its README).
-   * With it, HTML files run in that isolated origin; without it they run in
-   * an opaque-origin srcdoc frame inside this tab.
+   * Last edited timestamp. Accepts `Date` or an ISO-8601 string so host apps
+   * can forward backend payloads verbatim without pre-parsing.
    */
-  htmlSandbox?: F0DocumentHtmlSandbox;
+  lastEdited: Date | string;
+}
+/**
+ * Callbacks for persisting dashboards externally (beyond chat history).
+ */
+interface DashboardCanvasActions {
+  /** Update an existing saved dashboard */
+  save: (id: string, category: string, config: ChatDashboardConfig) => Promise<void>;
   /**
-   * When HTML files run their scripts: "auto" on open, "ask" behind a "Run
-   * content" button, "never" static.
-   * @default "auto"
+   * Create a new saved dashboard. Returns the new dashboard's id and
+   * category so subsequent edits can call `save` (which requires both).
+   * Returning void / undefined leaves the canvas in its current state.
    */
-  htmlExecution?: F0DocumentHtmlExecution;
-}
-/** One file published by an agent's `showFiles` tool. */
-interface AiChatShowFilesItem {
-  path: string;
-  displayName?: string;
-  mimeType?: string;
-  bytes?: number;
-  /** Download URL, when the tool already built one. */
-  url?: string;
-  /** A PDF rendering of the file, written next to it by the agent. */
-  preview?: {
-    path: string;
-    url?: string;
-  };
+  create: (title: string, description: string, config: ChatDashboardConfig, category?: string) => Promise<{
+    id: string;
+    category: string;
+  } | void>;
+  /**
+   * Fetch creator + last-edited metadata for a saved dashboard. The header
+   * calls this lazily, only when the current dashboard has a
+   * `savedDashboardId`. Returning `void` signals "no metadata available" —
+   * the header will skip rendering the avatar and the last-edited row
+   * instead of showing a placeholder.
+   */
+  getMetadata?: (id: string) => Promise<DashboardMetadata | void>;
 }
 //#endregion
 //#region src/elements/avatars/F0Avatar/F0Avatar.d.ts
@@ -5482,4 +5494,4 @@ declare function useI18n(): TranslationsType & {
 };
 declare const buildTranslations: (translations: TranslationsType) => TranslationsType;
 //#endregion
-export { AiChatCredits as $, F0AvatarTeamProps as $i, F0Button as $n, CanvasActions as $r, F0TagTeam as $t, Weekdays as A, WithDataTestIdPropsOf as Aa, FormCanvasContent as Ai, AvatarListSize as An, AttachmentDocumentKind as Ar, CustomEntityRefCard as At, RenderableTurn as B, AvatarAction as Bi, F0Link as Bn, F0DocumentHtmlExecution as Br, cardImageAspectRatios as Bt, FileItemSize as C, tagDotColors as Ca, CollectionComputation as Ci, TooltipProps as Cn, F0PersonCardProps as Cr, WelcomeScreenSuggestionItem as Ct, TagCounterItem as D, IconType as Da, DashboardMetadata as Di, ChartColorToken as Dn, AiChatFilePreviewConfig as Dr, SidePanelContextValue as Dt, TagCounter as E, F0IconProps as Ea, DashboardFetchSpec as Ei, HourDistributionDataPoint as En, AiChatFileKind as Er, SidePanelContent as Et, F0AiMessagesContainerProps as F, PieComputation as Fi, CardAvatarVariant as Fn, F0DocumentViewer as Fr, F0Card as Ft, F0AiChatProps as G, CompanyAvatarVariant as Gi, DropdownItemLabel as Gn, F0DocumentViewerToolbarPlacement as Gr, CardAlertVariant as Gt, MarkdownTagRenderers as H, AvatarVariants as Hi, DropdownContentVariant as Hn, F0DocumentKind as Hr, cardImageSizes as Ht, WelcomeScreenCta as I, RadarComputation as Ii, AlertAvatarProps as In, F0PdfViewer as Ir, F0CardProps as It, AiChatComposerActionItem as J, IconAvatarVariant as Ji, DropdownItemSeparator as Jn, DataAttributes as Jr, ValueDisplayRendererDefinition as Jt, F0AiChatProvider as K, FileAvatarVariant as Ki, DropdownItemObject as Kn, F0PdfScale as Kr, CardMetadata as Kt, FeedbackConfig as L, ScatterComputation as Li, F0AvatarAlert as Ln, F0PdfViewerAction as Lr, CardImageAspectRatio as Lt, useAiChatTranslations as M, withDataTestId as Ma, GaugeComputation as Mi, F0TagAlert as Mn, F0VideoPlayerProps as Mr, EntityRefs as Mt, useAiChat as N, HeatmapComputation as Ni, Level as Nn, VideoPlayerContent as Nr, EntityResolvers as Nt, F0TagRaw as O, DataTestIdWrapper as Oa, DataDownloadCanvasContent as Oi, chartColorTokens as On, AiChatFileUrlResolver as Or, SidePanelLayout as Ot, F0AiMessagesContainer as P, MetricComputation as Pi, Props$1 as Pn, Localized as Pr, EntityUrlBuilders as Pt, AiChatCreditWarning as Q, F0AvatarTeam as Qi, LinkContextValue as Qn, BulkResolveInconsistenciesCanvasContent as Qr, TagVariant as Qt, UserReaction as R, F0AvatarModule as Ri, alertAvatarTypes as Rn, F0PdfViewerProps as Rr, CardImageFit as Rt, FileItemProps as S, Props$2 as Sa, ChatDashboardScatterChartConfig as Si, TooltipGroupProps as Sn, F0PersonCardAction as Sr, WelcomeScreenSuggestion as St, F0TagList as T, F0Icon as Ta, DashboardCanvasContent as Ti, HourDistributionCellValue as Tn, AiChatFile as Tr, aiTranslations as Tt, markdownRenderers as U, ColorAvatarVariant as Ui, DropdownInternalProps as Un, F0DocumentViewerAction as Ur, CardAlertAction as Ut, ThinkingProps as V, AvatarVariant$1 as Vi, F0LinkProps as Vn, F0DocumentHtmlSandbox as Vr, cardImageFits as Vt, F0AiChat as W, ColorListAvatarVariant as Wi, DropdownItem as Wn, F0DocumentViewerProps as Wr, CardAlertProps as Wt, AiChatComposerActionSubmenu as X, TeamAvatarVariant as Xi, DropdownItemSwitch as Xn, AutofillTimesheetCanvasContent as Xr, TagType as Xt, AiChatComposerActionSeparator as Y, PersonAvatarVariant as Yi, DropdownItemSubmenu as Yn, AggregationType as Yr, F0TagListProps as Yt, AiChatComposerActionToggle as Z, avatarVariants as Zi, NavigationItem as Zn, AutofillTimesheetShift as Zr, Tag as Zt, F0FileItem as _, Badge as _a, ChatDashboardMetricFormat as _i, F0ProgressSeriesSize as _n, Variant as _r, PendingContext as _t, F0CardHorizontal as a, F0AvatarFileProps as aa, ChatDashboardChartConfig as ai, F0TagCompanyProps as an, EmojiImage as ar, AiChatTrackingOptions as at, FileAction as b, modules as ba, ChatDashboardPieChartConfig as bi, Tooltip as bn, PersonProfile as br, UploadedFile as bt, MobileDropdown as c, F0AvatarEmojiProps as ca, ChatDashboardColumn as ci, F0TagBalanceProps as cn, getEmojiLabel as cr, AiChatUsageLimits as ct, useFormCardValueFormatter as d, F0AvatarColorList as da, ChatDashboardFilterDefinition as di, RelaxedNumericWithFormatter as dn, ExpenseProfile as dr, AppendToolCall as dt, F0AvatarPersonProps as ea, CanvasContent as ei, F0TagTeamProps as en, F0ButtonProps as er, AiChatDisclaimer as et, useSetFormCardValueFormatter as f, F0AvatarColorListProps as fa, ChatDashboardFunnelChartConfig as fi, F0ProgressSeries as fn, VacancyProfile as fr, CreditsUsage as ft, F0FileAction as g, BaseAvatarProps as ga, ChatDashboardLineChartConfig as gi, F0ProgressSeriesProps as gn, StatusVariant as gr, F0ToolCall as gt, DetailsItemType as h, AvatarBadge as ha, ChatDashboardItem as hi, F0ProgressSeriesOptions as hn, F0TagStatusProps as hr, F0Message as ht, useI18n as i, F0AvatarFile as ia, ChatDashboardBarChartConfig as ii, F0TagCompany as in, buttonVariants as ir, AiChatProviderProps as it, AiChatTranslationsProvider as j, WithDataTestIdReturnType as ja, FormatPreset as ji, F0AvatarListProps as jn, F0VideoPlayer as jr, CustomEntityRefConfig as jt, F0TagDot as k, WithDataTestIdProps as ka, DataDownloadDataset as ki, BarSeriesStyle as kn, AiChatShowFilesItem as kr, SidePanelViewDefinition as kt, FormCardValueFormatterEntry as l, BaseAvatar as la, ChatDashboardConfig as li, Numeric as ln, useEmojiConfetti as lr, AiChatUsageLimitsSection as lt, DetailsItemContent as m, F0AvatarColorProps as ma, ChatDashboardHeatmapChartConfig as mi, F0ProgressSeriesColor as mn, F0TagStatus as mr, F0AiChatWelcomeCard as mt, I18nProviderProps as n, F0AvatarIconProps as na, CanvasEntityDefinition as ni, F0TagPerson as nn, ButtonVariant as nr, AiChatFileAttachmentConfig as nt, F0CardHorizontalProps as o, FileDef as oa, ChatDashboardChartItem as oi, F0TagBalance as on, EmojiImageProps as or, AiChatTranslations as ot, DetailsItem as p, F0AvatarColor as pa, ChatDashboardGaugeChartConfig as pi, F0ProgressSeriesBar as pn, RequisitionProfile as pr, F0AIMessage as pt, AiChatComposerAction as q, FlagAvatarVariant as qi, DropdownItemPanel as qn, pdfScales as qr, cardAlertVariants as qt, buildTranslations as r, CountryCode as ra, ChartComputation as ri, F0TagPersonProps as rn, buttonSizes as rr, AiChatMode as rt, Dropdown as s, F0AvatarEmoji as sa, ChatDashboardCollectionItem as si, BalanceStatus as sn, EmojiRenderMode as sr, AiChatTranslationsProviderProps as st, I18nProvider as t, F0AvatarIcon as ta, CanvasContentBase as ti, F0TagRawProps as tn, ButtonSize as tr, AiChatEmployeeCredits as tt, FormCardValueFormatterProvider as u, F0AvatarCompanyProps as ua, ChatDashboardDateNavigationGranularity as ui, NumericWithFormatter as un, ActionButtonVariant as ur, AppendMessage as ut, F0FileItemProps as v, BadgeProps as va, ChatDashboardMetricItem as vi, f0ProgressSeriesColors as vn, JobPostingProfile as vr, PendingQuote as vt, f0FileItemSizes as w, DistributiveOmit as wa, DashboardCanvasActions as wi, Shortcut as wn, F0Avatar as wr, WelcomeSuggestionClickEvent as wt, FileItem as x, NewColor as xa, ChatDashboardRadarChartConfig as xi, TooltipGroup as xn, F0PersonCard as xr, VisualizationMode as xt, F0FileItemSize as y, ModuleId as ya, ChatDashboardNavigationFilterDefinition as yi, f0ProgressSeriesSizes as yn, CandidateProfile as yr, TranscribeFn as yt, useToolCallId as z, F0AvatarModuleProps as zi, CardSecondaryAction as zn, F0PdfViewerToolbarPlacement as zr, CardImageSize as zt };
+export { AiChatCredits as $, F0AvatarTeam as $i, F0Button as $n, CollectionComputation as $r, F0TagTeam as $t, Weekdays as A, WithDataTestIdProps as Aa, F0DocumentHtmlExecution as Ai, AvatarListSize as An, CanvasContent as Ar, CustomEntityRefCard as At, RenderableTurn as B, F0AvatarModuleProps as Bi, F0Link as Bn, ChatDashboardDateNavigationGranularity as Br, cardImageAspectRatios as Bt, FileItemSize as C, Props$2 as Ca, VideoPlayerContent as Ci, TooltipProps as Cn, F0PersonCardProps as Cr, WelcomeScreenSuggestionItem as Ct, TagCounterItem as D, F0IconProps as Da, F0PdfViewerAction as Di, ChartColorToken as Dn, AutofillTimesheetShift as Dr, SidePanelContextValue as Dt, TagCounter as E, F0Icon as Ea, F0PdfViewer as Ei, HourDistributionDataPoint as En, AutofillTimesheetCanvasContent as Er, SidePanelContent as Et, F0AiMessagesContainerProps as F, F0DocumentViewerToolbarPlacement as Fi, CardAvatarVariant as Fn, ChatDashboardChartConfig as Fr, F0Card as Ft, F0AiChatProps as G, ColorListAvatarVariant as Gi, DropdownItemLabel as Gn, ChatDashboardItem as Gr, CardAlertVariant as Gt, MarkdownTagRenderers as H, AvatarVariant$1 as Hi, DropdownContentVariant as Hn, ChatDashboardFunnelChartConfig as Hr, cardImageSizes as Ht, WelcomeScreenCta as I, F0PdfScale as Ii, AlertAvatarProps as In, ChatDashboardChartItem as Ir, F0CardProps as It, AiChatComposerActionItem as J, FlagAvatarVariant as Ji, DropdownItemSeparator as Jn, ChatDashboardMetricItem as Jr, ValueDisplayRendererDefinition as Jt, F0AiChatProvider as K, CompanyAvatarVariant as Ki, DropdownItemObject as Kn, ChatDashboardLineChartConfig as Kr, CardMetadata as Kt, FeedbackConfig as L, pdfScales as Li, F0AvatarAlert as Ln, ChatDashboardCollectionItem as Lr, CardImageAspectRatio as Lt, useAiChatTranslations as M, WithDataTestIdReturnType as Ma, F0DocumentKind as Mi, F0TagAlert as Mn, CanvasEntityDefinition as Mr, EntityRefs as Mt, useAiChat as N, withDataTestId as Na, F0DocumentViewerAction as Ni, Level as Nn, ChartComputation as Nr, EntityResolvers as Nt, F0TagRaw as O, IconType as Oa, F0PdfViewerProps as Oi, chartColorTokens as On, BulkResolveInconsistenciesCanvasContent as Or, SidePanelLayout as Ot, F0AiMessagesContainer as P, F0DocumentViewerProps as Pi, Props$1 as Pn, ChatDashboardBarChartConfig as Pr, EntityUrlBuilders as Pt, AiChatCreditWarning as Q, avatarVariants as Qi, LinkContextValue as Qn, ChatDashboardScatterChartConfig as Qr, TagVariant as Qt, UserReaction as R, DataAttributes as Ri, alertAvatarTypes as Rn, ChatDashboardColumn as Rr, CardImageFit as Rt, FileItemProps as S, NewColor as Sa, F0VideoPlayerProps as Si, TooltipGroupProps as Sn, F0PersonCardAction as Sr, WelcomeScreenSuggestion as St, F0TagList as T, DistributiveOmit as Ta, F0DocumentViewer as Ti, HourDistributionCellValue as Tn, AggregationType as Tr, aiTranslations as Tt, markdownRenderers as U, AvatarVariants as Ui, DropdownInternalProps as Un, ChatDashboardGaugeChartConfig as Ur, CardAlertAction as Ut, ThinkingProps as V, AvatarAction as Vi, F0LinkProps as Vn, ChatDashboardFilterDefinition as Vr, cardImageFits as Vt, F0AiChat as W, ColorAvatarVariant as Wi, DropdownItem as Wn, ChatDashboardHeatmapChartConfig as Wr, CardAlertProps as Wt, AiChatComposerActionSubmenu as X, PersonAvatarVariant as Xi, DropdownItemSwitch as Xn, ChatDashboardPieChartConfig as Xr, TagType as Xt, AiChatComposerActionSeparator as Y, IconAvatarVariant as Yi, DropdownItemSubmenu as Yn, ChatDashboardNavigationFilterDefinition as Yr, F0TagListProps as Yt, AiChatComposerActionToggle as Z, TeamAvatarVariant as Zi, NavigationItem as Zn, ChatDashboardRadarChartConfig as Zr, Tag as Zt, F0FileItem as _, BaseAvatarProps as _a, AiChatFilePreviewConfig as _i, F0ProgressSeriesSize as _n, Variant as _r, PendingContext as _t, F0CardHorizontal as a, F0AvatarFile as aa, DataDownloadDataset as ai, F0TagCompanyProps as an, EmojiImage as ar, AiChatTrackingOptions as at, FileAction as b, ModuleId as ba, AttachmentDocumentKind as bi, Tooltip as bn, PersonProfile as br, UploadedFile as bt, MobileDropdown as c, F0AvatarEmoji as ca, FormatPreset as ci, F0TagBalanceProps as cn, getEmojiLabel as cr, AiChatUsageLimits as ct, useFormCardValueFormatter as d, F0AvatarCompanyProps as da, MetricComputation as di, RelaxedNumericWithFormatter as dn, ExpenseProfile as dr, AppendToolCall as dt, F0AvatarTeamProps as ea, DashboardCanvasActions as ei, F0TagTeamProps as en, F0ButtonProps as er, AiChatDisclaimer as et, useSetFormCardValueFormatter as f, F0AvatarColorList as fa, PieComputation as fi, F0ProgressSeries as fn, VacancyProfile as fr, CreditsUsage as ft, F0FileAction as g, AvatarBadge as ga, AiChatFileKind as gi, F0ProgressSeriesProps as gn, StatusVariant as gr, F0ToolCall as gt, DetailsItemType as h, F0AvatarColorProps as ha, AiChatFile as hi, F0ProgressSeriesOptions as hn, F0TagStatusProps as hr, F0Message as ht, useI18n as i, CountryCode as ia, DataDownloadCanvasContent as ii, F0TagCompany as in, buttonVariants as ir, AiChatProviderProps as it, AiChatTranslationsProvider as j, WithDataTestIdPropsOf as ja, F0DocumentHtmlSandbox as ji, F0AvatarListProps as jn, CanvasContentBase as jr, CustomEntityRefConfig as jt, F0TagDot as k, DataTestIdWrapper as ka, F0PdfViewerToolbarPlacement as ki, BarSeriesStyle as kn, CanvasActions as kr, SidePanelViewDefinition as kt, FormCardValueFormatterEntry as l, F0AvatarEmojiProps as la, GaugeComputation as li, Numeric as ln, useEmojiConfetti as lr, AiChatUsageLimitsSection as lt, DetailsItemContent as m, F0AvatarColor as ma, ScatterComputation as mi, F0ProgressSeriesColor as mn, F0TagStatus as mr, F0AiChatWelcomeCard as mt, I18nProviderProps as n, F0AvatarIcon as na, DashboardFetchSpec as ni, F0TagPerson as nn, ButtonVariant as nr, AiChatFileAttachmentConfig as nt, F0CardHorizontalProps as o, F0AvatarFileProps as oa, FileCanvasContent as oi, F0TagBalance as on, EmojiImageProps as or, AiChatTranslations as ot, DetailsItem as p, F0AvatarColorListProps as pa, RadarComputation as pi, F0ProgressSeriesBar as pn, RequisitionProfile as pr, F0AIMessage as pt, AiChatComposerAction as q, FileAvatarVariant as qi, DropdownItemPanel as qn, ChatDashboardMetricFormat as qr, cardAlertVariants as qt, buildTranslations as r, F0AvatarIconProps as ra, DashboardMetadata as ri, F0TagPersonProps as rn, buttonSizes as rr, AiChatMode as rt, Dropdown as s, FileDef as sa, FormCanvasContent as si, BalanceStatus as sn, EmojiRenderMode as sr, AiChatTranslationsProviderProps as st, I18nProvider as t, F0AvatarPersonProps as ta, DashboardCanvasContent as ti, F0TagRawProps as tn, ButtonSize as tr, AiChatEmployeeCredits as tt, FormCardValueFormatterProvider as u, BaseAvatar as ua, HeatmapComputation as ui, NumericWithFormatter as un, ActionButtonVariant as ur, AppendMessage as ut, F0FileItemProps as v, Badge as va, AiChatFileUrlResolver as vi, f0ProgressSeriesColors as vn, JobPostingProfile as vr, PendingQuote as vt, f0FileItemSizes as w, tagDotColors as wa, Localized as wi, Shortcut as wn, F0Avatar as wr, WelcomeSuggestionClickEvent as wt, FileItem as x, modules as xa, F0VideoPlayer as xi, TooltipGroup as xn, F0PersonCard as xr, VisualizationMode as xt, F0FileItemSize as y, BadgeProps as ya, AiChatShowFilesItem as yi, f0ProgressSeriesSizes as yn, CandidateProfile as yr, TranscribeFn as yt, useToolCallId as z, F0AvatarModule as zi, CardSecondaryAction as zn, ChatDashboardConfig as zr, CardImageSize as zt };