@factorialco/f0-react 1.396.0 → 1.398.0

package/dist/f0.d.ts

@@ -39,6 +39,7 @@ import { default as default_2 } from 'react';
 import { DeltaCellValue } from './types/delta';
 import { DotTagCellValue } from './f0';
 import { DotTagCellValue as DotTagCellValue_2 } from './types/dotTag';
+import { F0AnalyticsDashboardProps as F0AnalyticsDashboardProps_2 } from './types';
 import { F0AvatarCompanyProps as F0AvatarCompanyProps_2 } from './types';
 import { F0AvatarDateProps } from './F0AvatarDate';
 import { F0AvatarEmojiProps as F0AvatarEmojiProps_2 } from './F0AvatarEmoji';
@@ -62,6 +63,7 @@ import { f1Colors } from '@factorialco/f0-core';
 import { FC } from 'react';
 import { FileCellValue } from './f0';
 import { FileCellValue as FileCellValue_2 } from './types/file';
+import { FiltersDefinition as FiltersDefinition_2 } from './f0';
 import { FolderCellValue } from './f0';
 import { FolderCellValue as FolderCellValue_2 } from './types/folder';
 import { ForwardedRef } from 'react';
@@ -82,7 +84,7 @@ import { internalAvatarColors as internalAvatarColors_2 } from './f0';
 import { internalAvatarSizes as internalAvatarSizes_2 } from './f0';
 import { internalAvatarTypes as internalAvatarTypes_2 } from './f0';
 import { JSX as JSX_2 } from 'react';
-import { LineChartConfig } from './f0';
+import { LineChartConfig as LineChartConfig_2 } from './f0';
 import { LineChartPropsBase } from './utils/types';
 import { LocalAudioTrack } from 'livekit-client';
 import { LongTextCellValue } from './types/longText';
@@ -133,6 +135,7 @@ import { WithDataTestIdReturnType as WithDataTestIdReturnType_3 } from './f0';
 import { WithDataTestIdReturnType as WithDataTestIdReturnType_4 } from './f0';
 import { WithDataTestIdReturnType as WithDataTestIdReturnType_5 } from './f0';
 import { WithDataTestIdReturnType as WithDataTestIdReturnType_6 } from './f0';
+import { WithDataTestIdReturnType as WithDataTestIdReturnType_7 } from './f0';
 import { z } from 'zod';
 import { ZodEffects } from 'zod';
 import { ZodRawShape } from 'zod';
@@ -288,6 +291,8 @@ declare type ActionSize = (typeof actionSizes)[number];
 
 declare const actionSizes: readonly ["sm", "md", "lg"];
 
+export declare type ActionType = "duplicate" | "delete";
+
 declare type ActionVariant = (typeof actionVariants)[number];
 
 declare const actionVariants: readonly ["default", "outline", "critical", "neutral", "ghost", "promote", "outlinePromote", "ai", "link", "unstyled", "mention"];
@@ -594,7 +599,7 @@ declare type AnimationVariantsOptions = {
     maxDelay?: number;
 };
 
-export declare const AreaChart: WithDataTestIdReturnType_5<ForwardRefExoticComponent<Omit<LineChartPropsBase<LineChartConfig> & {
+export declare const AreaChart: WithDataTestIdReturnType_5<ForwardRefExoticComponent<Omit<LineChartPropsBase<LineChartConfig_2> & {
 lineType?: "step" | "linear" | "natural" | "monotoneX";
 marginTop?: number;
 canBeBlurred?: boolean;
@@ -726,6 +731,14 @@ values: {
 }) => void) | undefined;
 } & RefAttributes<HTMLDivElement>, "ref"> & RefAttributes<HTMLElement | SVGElement>>>;
 
+export declare interface BarChartConfig extends ChartConfigBase {
+    type: "bar";
+    /** @default "vertical" */
+    orientation?: "vertical" | "horizontal";
+    /** Stack all series into a single bar per category. @default false */
+    stacked?: boolean;
+}
+
 declare type BaseAction = {
     label: string;
     onClick: () => Promise<void> | void;
@@ -861,6 +874,25 @@ export declare type BasePaginatedResponse<R> = BaseResponse<R> & {
     perPage: number;
 };
 
+export declare type BaseQuestionOnChangeParams = {
+    id: string;
+    title?: string;
+    description?: string;
+    required?: boolean;
+};
+
+declare type BaseQuestionProps = {
+    id: string;
+    title: string;
+    description?: string;
+    type: QuestionType;
+    children: React.ReactNode;
+    required?: boolean;
+    locked?: boolean;
+};
+
+declare type BaseQuestionPropsForOtherQuestionComponents = Omit<BaseQuestionProps, "children" | "onChange">;
+
 /**
  * Base response type for collection data
  * @template R - The type of records in the collection
@@ -1378,6 +1410,28 @@ declare type CardVisualizationOptions<T, _Filters extends FiltersDefinition, _So
 
 export declare const CategoryBarChart: WithDataTestIdReturnType_5<ForwardRefExoticComponent<Omit<CategoryBarProps & RefAttributes<HTMLDivElement>, "ref"> & RefAttributes<HTMLElement | SVGElement>>>;
 
+/** A valid chart color token — one of the 15 chromatic F0 base-color names. */
+declare type ChartColorToken = (typeof chartColorTokens)[number];
+
+/**
+ * The 15 chromatic color names from the F0 design token palette.
+ * These are the only colors allowed for custom series / data-point colors.
+ */
+declare const chartColorTokens: readonly ["lilac", "barbie", "smoke", "army", "flubber", "indigo", "camel", "radical", "viridian", "orange", "red", "grass", "malibu", "yellow", "purple"];
+
+declare interface ChartConfigBase {
+    /** Show the legend below the chart. @default true */
+    showLegend?: boolean;
+    /** Show background grid lines. @default true */
+    showGrid?: boolean;
+    /** Show value labels on each data point. @default false */
+    showLabels?: boolean;
+    /** Format the value axis tick labels */
+    valueFormatter?: (value: number) => string;
+    /** Format category axis tick labels */
+    categoryFormatter?: (value: string) => string;
+}
+
 export declare const ChatSpinner: ForwardRefExoticComponent<Omit<SVGProps<SVGSVGElement>, "ref"> & RefAttributes<SVGSVGElement>>;
 
 /**
@@ -1610,6 +1664,8 @@ declare type ComponentTypes = (typeof componentTypes)[number];
 
 declare const componentTypes: readonly ["layout", "info", "action", "form"];
 
+export declare function computeSectionEndIds(elements: SurveyFormBuilderElement[]): Set<string>;
+
 declare type CountryCode = keyof TranslationsType["countries"];
 
 export declare function createAtlaskitDriver(instanceId: symbol): DndDriver;
@@ -1710,6 +1766,116 @@ declare interface CustomFieldRenderPropsBase {
 
 export declare const Dashboard: WithDataTestIdReturnType_3<ComponentType<DashboardProps_2> & PageLayoutGroupComponent_2>;
 
+/**
+ * Chart display configuration — discriminated on `type`.
+ * This object is JSON-serializable (no functions, except optional formatters).
+ */
+export declare type DashboardChartConfig = BarChartConfig | LineChartConfig | FunnelChartConfig | PieChartConfig | RadarChartConfig | GaugeChartConfig | HeatmapChartConfig;
+
+export declare interface DashboardChartData {
+    /** Category axis labels. Required for bar/line charts. */
+    categories?: string[];
+    /** X-axis category labels for heatmap charts. */
+    xCategories?: string[];
+    /** Y-axis category labels for heatmap charts. */
+    yCategories?: string[];
+    /** Radar chart axis indicators. */
+    indicators?: F0DataChartRadarIndicator[];
+    /** Chart series data — shape depends on chart type. Omit for heatmaps. */
+    series?: F0DataChartBarSeries[] | F0DataChartLineSeries[] | F0DataChartFunnelSeries | F0DataChartPieSeries | F0DataChartRadarSeries[] | {
+        value: number;
+        name?: string;
+    };
+    /** Heatmap data points as [xIndex, yIndex, value] tuples. */
+    data?: [number, number, number][];
+}
+
+export declare interface DashboardChartItem<Filters extends FiltersDefinition = FiltersDefinition> extends DashboardItemBase {
+    type: "chart";
+    /** Visual chart configuration (JSON-serializable) */
+    chart: DashboardChartConfig;
+    /**
+     * Reserved for future use. Currently all chart cells share the same
+     * height derived from the grid column width.
+     */
+    aspectRatio?: string;
+    /** Async data fetcher — receives dashboard filters when useDashboardFilters is true */
+    fetchData: (filters: FiltersState<Filters>) => Promise<DashboardChartData>;
+}
+
+/**
+ * Minimal collection config — enough to render a table/card/list inside
+ * a dashboard widget without its own filter bar.
+ *
+ * The consumer provides `createSource` which receives the dashboard-level
+ * filters and returns a full DataCollectionSourceDefinition. The dashboard
+ * calls `useDataCollectionSource` internally.
+ */
+export declare interface DashboardCollectionItem<Filters extends FiltersDefinition = FiltersDefinition> extends DashboardItemBase {
+    type: "collection";
+    /**
+     * Factory that creates a DataCollectionSourceDefinition for this item.
+     * Called whenever dashboard filters change.
+     * The returned definition should NOT include its own filters/presets
+     * (the dashboard provides those globally).
+     */
+    createSource: (filters: FiltersState<Filters>) => any;
+    /**
+     * Visualization configs for the collection (table, card, list, kanban).
+     * Same shape as OneDataCollection's `visualizations` prop.
+     */
+    visualizations: ReadonlyArray<any>;
+}
+
+/**
+ * A single dashboard item. Discriminated on `type`.
+ *
+ * Currently supports `"chart"`, `"metric"`, and `"collection"`.
+ * Future types (e.g. `"custom"`) extend this union.
+ */
+export declare type DashboardItem<Filters extends FiltersDefinition = FiltersDefinition> = DashboardChartItem<Filters> | DashboardMetricItem<Filters> | DashboardCollectionItem<Filters>;
+
+export declare interface DashboardItemBase {
+    /** Unique key for React reconciliation and identity */
+    id: string;
+    /** Widget title displayed in the header */
+    title: string;
+    /** Optional description below the title */
+    description?: string;
+    /** Number of grid columns this item spans (1–3). @default 1 */
+    colSpan?: 1 | 2 | 3;
+    /**
+     * Whether this item receives dashboard-level filters in its fetchData.
+     * When false, fetchData receives an empty object.
+     * @default true
+     */
+    useDashboardFilters?: boolean;
+}
+
+/** Data returned by a metric item's fetchData */
+export declare interface DashboardMetricData {
+    /** The main numeric value displayed in large text */
+    value: number;
+    /** Optional previous value — used to compute a trend indicator */
+    previousValue?: number;
+}
+
+/**
+ * A single big-number KPI widget.
+ *
+ * Displays a large formatted number with optional trend indicator
+ * (up/down vs previous value). Receives dashboard filters like any other item.
+ */
+export declare interface DashboardMetricItem<Filters extends FiltersDefinition = FiltersDefinition> extends DashboardItemBase {
+    type: "metric";
+    /** How to format the value. @default { type: "number" } */
+    format?: MetricFormat;
+    /** Number of decimal places. @default 0 */
+    decimals?: number;
+    /** Async data fetcher — receives dashboard filters */
+    fetchData: (filters: FiltersState<Filters>) => Promise<DashboardMetricData>;
+}
+
 export declare type DashboardProps = GroupGridProps<DashboardWidget>;
 
 export declare type DashboardWidget = GroupGridWidget<{
@@ -2072,6 +2238,10 @@ export declare interface DatePreset {
     value: DateRange | (() => DateRange);
 }
 
+declare type DateQuestionProps = BaseQuestionPropsForOtherQuestionComponents & {
+    value?: Date | null;
+};
+
 declare type DateRange = {
     from: Date;
     to?: Date;
@@ -2582,7 +2752,7 @@ export declare const defaultTranslations: {
             readonly dismiss: "Dismiss";
         };
     };
-    readonly coCreationForm: {
+    readonly surveyFormBuilder: {
         readonly actions: {
             readonly actions: "Actions";
             readonly duplicateQuestion: "Duplicate question";
@@ -2614,7 +2784,11 @@ export declare const defaultTranslations: {
         };
         readonly answer: {
             readonly label: "Answer";
-            readonly placeholder: "Respondent's answer";
+            readonly dropdownPlaceholder: "Pick an option";
+            readonly textPlaceholder: "Type your answer";
+            readonly numericPlaceholder: "Enter a number";
+            readonly linkPlaceholder: "https://example.com";
+            readonly invalidUrl: "Enter a valid URL";
         };
         readonly labels: {
             readonly applyingChanges: "Applying changes";
@@ -2633,6 +2807,16 @@ export declare const defaultTranslations: {
             readonly lastQuestionDialogDescription: "Moving this question will leave the section empty and it will be removed. Do you want to continue?";
         };
     };
+    readonly surveyAnsweringForm: {
+        readonly actions: {
+            readonly submit: "Submit survey";
+            readonly cancel: "Cancel";
+            readonly next: "Next";
+            readonly previous: "Previous";
+            readonly expand: "Expand";
+            readonly collapse: "Collapse";
+        };
+    };
     readonly richTextEditor: {
         readonly bold: "Bold";
         readonly italic: "Italic";
@@ -2819,6 +3003,12 @@ declare type DropdownItemSeparator = {
     type: "separator";
 };
 
+declare type DropdownSingleQuestionProps = BaseQuestionPropsForOtherQuestionComponents & {
+    type: "dropdown-single";
+    options: SelectQuestionOption[];
+    value?: string | null;
+};
+
 export declare type DropIntent = {
     type: "reorder";
     containerId: string;
@@ -2885,6 +3075,8 @@ declare type EditableTableVisualizationOptions<R extends RecordType, _Filters ex
 
 declare type EditableTableVisualizationSettings = TableVisualizationSettings;
 
+export declare type ElementType = QuestionType | "section";
+
 export declare function Em({ children, ...props }: React.HTMLAttributes<HTMLSpanElement>): JSX_2.Element;
 
 export declare function EmojiImage({ emoji, size, alt }: EmojiImageProps): JSX_2.Element;
@@ -3131,6 +3323,45 @@ export declare interface F0AlertProps {
     variant: AlertVariant;
 }
 
+/**
+ * @experimental This is an experimental component use it at your own risk
+ */
+export declare const F0AnalyticsDashboard: {
+    <Filters extends FiltersDefinition_2 = FiltersDefinition_2>({ filters, presets, defaultFilters, items, }: F0AnalyticsDashboardProps_2<Filters>): JSX_2.Element;
+    displayName: string;
+};
+
+/**
+ * Props for the F0AnalyticsDashboard component.
+ *
+ * The entire dashboard is defined declaratively via `filters` (optional shared
+ * filter definitions), `presets`, and `items` (an ordered array of chart /
+ * collection configs).
+ *
+ * An LLM can generate the full `items` array as JSON (minus the `fetchData`
+ * functions) to build dashboards on the fly.
+ */
+export declare interface F0AnalyticsDashboardProps<Filters extends FiltersDefinition = FiltersDefinition> {
+    /**
+     * Filter definitions for the dashboard-level filter bar.
+     * When omitted, no filter bar is rendered.
+     */
+    filters?: Filters;
+    /**
+     * Preset filter configurations shown as quick-select chips.
+     */
+    presets?: PresetsDefinition<Filters>;
+    /**
+     * Initial filter values applied when the dashboard first renders.
+     */
+    defaultFilters?: FiltersState<Filters>;
+    /**
+     * Ordered list of dashboard items to render in the grid.
+     * Each item declares its type, visual config, grid span, and data fetcher.
+     */
+    items: DashboardItem<Filters>[];
+}
+
 /**
  * Config for array fields (multi-select or multi-file)
  * @typeParam T - The value type (string or number)
@@ -3782,6 +4013,130 @@ declare type F0CustomFieldConfigWithConfig<TValue = unknown, TConfig = unknown>
     fieldType: "custom";
 };
 
+/**
+ * A single data point in a bar chart series.
+ * Can be a simple number or an object with value and optional target.
+ */
+declare type F0DataChartBarDataPoint = number | {
+    value: number;
+    /** When set, renders a gradient fade from the bar top up to the target value */
+    target?: number;
+    /** Override color for this individual bar. Must be an F0 design token name. */
+    color?: ChartColorToken;
+};
+
+/**
+ * A series of bars to render in the chart.
+ */
+declare interface F0DataChartBarSeries {
+    /** Display name used in legend and tooltip */
+    name: string;
+    /** Data points — one per category */
+    data: F0DataChartBarDataPoint[];
+    /** Override color for this series. Must be an F0 design token name. Falls back to the theme palette. */
+    color?: ChartColorToken;
+}
+
+/**
+ * A single data point in a funnel chart series.
+ * Each point has a value and a stage name.
+ */
+declare interface F0DataChartFunnelDataPoint {
+    /** Numeric value for this funnel stage */
+    value: number;
+    /** Stage label (e.g. "Applied", "Phone Screen", "Hired") */
+    name: string;
+    /** Override color for this individual stage. Must be an F0 design token name. */
+    color?: ChartColorToken;
+}
+
+/**
+ * A single funnel series with named data points.
+ */
+declare interface F0DataChartFunnelSeries {
+    /** Display name used in legend and tooltip */
+    name: string;
+    /** Data points — one per funnel stage */
+    data: F0DataChartFunnelDataPoint[];
+    /** Override color for the entire series. Must be an F0 design token name. */
+    color?: ChartColorToken;
+}
+
+/**
+ * A single data point in a line chart series.
+ * Can be a simple number or an object with a value.
+ */
+declare type F0DataChartLineDataPoint = number | {
+    value: number;
+};
+
+/**
+ * A series of data points to render as a line.
+ */
+declare interface F0DataChartLineSeries {
+    /** Display name used in legend and tooltip */
+    name: string;
+    /** Data points — one per category */
+    data: F0DataChartLineDataPoint[];
+    /** Override color for this series. Must be an F0 design token name. Falls back to the theme palette. */
+    color?: ChartColorToken;
+    /** Render this line with a dashed pattern (useful for projections/targets) */
+    dashed?: boolean;
+    /** Override line interpolation for this series */
+    lineType?: F0DataChartLineType;
+    /** Override area fill for this series */
+    showArea?: boolean;
+}
+
+/** Line interpolation type */
+declare type F0DataChartLineType = "linear" | "smooth" | "step";
+
+/**
+ * A single data point in a pie chart.
+ */
+declare interface F0DataChartPieDataPoint {
+    /** Numeric value for this segment */
+    value: number;
+    /** Segment label */
+    name: string;
+    /** Override color for this individual segment. Must be an F0 design token name. */
+    color?: ChartColorToken;
+}
+
+/**
+ * A single pie series with named data points.
+ */
+declare interface F0DataChartPieSeries {
+    /** Display name used in tooltip */
+    name: string;
+    /** Data points — one per pie segment */
+    data: F0DataChartPieDataPoint[];
+    /** Override color for the entire series. Must be an F0 design token name. */
+    color?: ChartColorToken;
+}
+
+/**
+ * A radar chart indicator (axis/dimension).
+ */
+declare interface F0DataChartRadarIndicator {
+    /** Name of the axis/dimension (e.g. "Performance", "Engagement") */
+    name: string;
+    /** Maximum value for this axis. @default auto-calculated from data */
+    max?: number;
+}
+
+/**
+ * A series of data points for a radar chart.
+ */
+declare interface F0DataChartRadarSeries {
+    /** Display name used in legend and tooltip (e.g. "Team A", "Team B") */
+    name: string;
+    /** Values — one per indicator, in the same order */
+    data: number[];
+    /** Override color for this series. Must be an F0 design token name. */
+    color?: ChartColorToken;
+}
+
 /**
  * Component that renders an optional markdown preview followed by
  * a dropdown button with "Download Excel" as the primary action and
@@ -4304,6 +4659,20 @@ export declare interface F0FormDiscardConfig {
  */
 export declare type F0FormErrorTriggerMode = "on-blur" | "on-change" | "on-submit";
 
+/**
+ * Standalone form field component that renders the appropriate F0Form input
+ * without requiring a react-hook-form context.
+ *
+ * Supports all field types that F0Form supports: text, number, textarea,
+ * select, checkbox, switch, date, time, datetime, daterange, richtext, custom,
+ * and file.
+ */
+export declare function F0FormField({ field, value, onChange, onBlur, error, errorMessage, loading, required, disabled, hideLabel: hideLabelProp, initialFiles, }: F0FormFieldProps): JSX_2.Element;
+
+export declare namespace F0FormField {
+    var displayName: string;
+}
+
 /**
  * String field - text input, textarea, select, or custom
  * @typeParam R - Record type for data source (when using source instead of options)
@@ -4379,6 +4748,44 @@ export declare function f0FormField<T extends ZodTypeAny, TConfig = undefined>(s
  */
 export declare function f0FormField<T extends ZodTypeAny, V extends string | number = string | number, R extends Record<string, unknown> = Record<string, unknown>>(schema: T, config: F0FieldConfig<V, R>): T & F0ZodType<T>;
 
+declare interface F0FormFieldCommonProps {
+    /** Field definition (type, label, placeholder, etc.) */
+    /** Current field value */
+    value: unknown;
+    /** Called when the field value changes */
+    onChange: (value: unknown) => void;
+    /** Called when the field loses focus */
+    onBlur?: () => void;
+    /** Whether the field has an error */
+    error?: boolean;
+    /** Error message to display */
+    errorMessage?: string;
+    /** Whether the field is in a loading/validating state */
+    loading?: boolean;
+    /** Whether the field is required */
+    required?: boolean;
+    /** Whether the field is disabled (overrides field.disabled) */
+    disabled?: boolean;
+    /** Whether to hide the label (useful when label is rendered externally) */
+    hideLabel?: boolean;
+}
+
+declare interface F0FormFieldFileProps extends F0FormFieldCommonProps {
+    /** File field definition */
+    field: F0FileField;
+    /** Shared pool of pre-existing file metadata for standalone file fields */
+    initialFiles?: InitialFile[];
+}
+
+declare interface F0FormFieldNonFileProps extends F0FormFieldCommonProps {
+    /** Non-file field definition */
+    field: Exclude<F0Field, F0FileField>;
+    /** Only supported for file fields */
+    initialFiles?: never;
+}
+
+export declare type F0FormFieldProps = F0FormFieldFileProps | F0FormFieldNonFileProps;
+
 /**
  * Union of all F0Form prop variants.
  * The component detects the mode based on whether `schema` is a single Zod schema
@@ -4570,6 +4977,12 @@ declare interface F0FormSubmitConfigBase {
     icon?: IconType | null;
     /** Label shown in the action bar while submitting (defaults to i18n "forms.actionBar.saving") */
     savingMessage?: string;
+    /**
+     * Duration in ms before the success message auto-clears.
+     * - number: auto-clear after this many ms (default: 3000)
+     * - null: never auto-clear (caller is responsible for unmounting)
+     */
+    successMessageDuration?: number | null;
 }
 
 /**
@@ -5163,7 +5576,7 @@ export declare const F0TableOfContentPopover: WithDataTestIdReturnType_3<typeof
  * Internal implementation of the TableOfContentPopover component.
  * This component includes all props including private ones.
  */
-declare function F0TableOfContentPopover_2({ title, items, className, activeItem, collapsible, sortable, onReorder, showChildrenCounter, barsAlign, size, variant, }: F0TableOfContentPopoverProps): JSX_2.Element;
+declare function F0TableOfContentPopover_2({ title, items, className, activeItem, collapsible, sortable, onReorder, showChildrenCounter, barsAlign, size, variant, portalContainer, }: F0TableOfContentPopoverProps): JSX_2.Element;
 
 declare interface F0TableOfContentPopoverProps extends Omit<TOCProps, "showSearchBox" | "title" | "hideChildrenCounter"> {
     /** Optional title displayed at the top of the menu popup */
@@ -5178,6 +5591,8 @@ declare interface F0TableOfContentPopoverProps extends Omit<TOCProps, "showSearc
     size?: PopupSize;
     /** Visual variant: "dark" for light backgrounds (default), "light" for dark backgrounds */
     variant?: TableOfContentPopoverVariant;
+    /** Container element for the portal. When inside a modal, pass the modal's container to prevent focus/click issues */
+    portalContainer?: HTMLElement | null;
 }
 
 export declare const F0TagAlert: WithDataTestIdReturnType_4<ForwardRefExoticComponent<Props_2 & RefAttributes<HTMLDivElement>>>;
@@ -5643,6 +6058,30 @@ export declare type FlagAvatarVariant = Extract<AvatarVariant, {
     type: "flag";
 }>;
 
+export declare type FlatFormItem = {
+    type: "section-header";
+    id: string;
+    section: SectionElement;
+} | {
+    type: "question";
+    id: string;
+    question: QuestionElement;
+} | {
+    type: "section-end";
+    id: string;
+    sectionId: string;
+};
+
+export declare type FlatQuestion = {
+    id: string;
+    type: string;
+    required?: boolean;
+    sectionTitle?: string;
+    sectionDescription?: string;
+};
+
+export declare function flattenElements(elements: SurveyFormBuilderElement[]): FlatFormItem[];
+
 /** Flex direction */
 export declare type FlexDirectionToken = "row" | "column" | "row-reverse" | "column-reverse";
 
@@ -5655,6 +6094,23 @@ declare const fontSizes: readonly ["sm", "md", "lg"];
 
 /* Excluded from this release type: FormDefinitionItem */
 
+/**
+ * Standalone form field props — decoupled from react-hook-form.
+ * This is the minimal contract that field renderers need to operate.
+ */
+export declare interface FormFieldProps {
+    /** Current field value */
+    value: unknown;
+    /** Called when the field value changes */
+    onChange: (value: unknown) => void;
+    /** Called when the field loses focus (used for validation triggers) */
+    onBlur: () => void;
+    /** Field name (defaults to field.id if not provided) */
+    name?: string;
+    /** Ref callback for the underlying input element */
+    ref?: React.RefCallback<HTMLElement>;
+}
+
 /** Fraction tokens for proportional widths */
 export declare type FractionToken = "1/2" | "1/3" | "2/3" | "1/4" | "2/4" | "3/4" | "1/5" | "2/5" | "3/5" | "4/5" | "1/6" | "5/6";
 
@@ -5668,6 +6124,28 @@ declare type FullscreenChatContextType = {
     setInProgress: (value: boolean) => void;
 };
 
+export declare interface FunnelChartConfig {
+    type: "funnel";
+    /** Sort direction of funnel stages. @default "descending" */
+    sort?: "descending" | "ascending" | "none";
+    /** Funnel orientation. @default "horizontal" */
+    orient?: "horizontal" | "vertical";
+    /** Show the legend below the chart. @default false */
+    showLegend?: boolean;
+    /** Show value labels on each stage. @default true */
+    showLabels?: boolean;
+    /**
+     * Show conversion percentages in labels.
+     * Each stage displays its value as a percentage of the first stage.
+     * @default false
+     */
+    showConversion?: boolean;
+    /** Use a color scale gradient instead of distinct colors. @default true */
+    colorScale?: boolean;
+    /** Format the value displayed in labels and tooltip */
+    valueFormatter?: (value: number) => string;
+}
+
 /**
  * Gap tokens for spacing between flex/grid children.
  * Uses betweenSpacing (rem) for sm–xl, absoluteSpacing (px) for extended sizes.
@@ -5687,6 +6165,20 @@ declare type FullscreenChatContextType = {
  */
 export declare type GapToken = "none" | "xs" | "sm" | "md" | "lg" | "xl" | "2xl" | "3xl" | "4xl" | "5xl";
 
+export declare interface GaugeChartConfig {
+    type: "gauge";
+    /** Minimum value. @default 0 */
+    min?: number;
+    /** Maximum value. @default 100 */
+    max?: number;
+    /** Color token for the gauge arc */
+    color?: ChartColorToken;
+    /** Show the numeric value inside the gauge. @default true */
+    showValue?: boolean;
+    /** Format the value displayed inside the gauge */
+    valueFormatter?: (value: number) => string;
+}
+
 /**
  * Generates an anchor ID for a form element
  * Format: forms.[formName].[sectionId].[fieldId]
@@ -5894,6 +6386,20 @@ declare type HeadingTags = (typeof headingTags)[number];
 
 declare const headingTags: readonly ["h1", "h2", "h3", "h4", "h5", "h6"];
 
+export declare interface HeatmapChartConfig {
+    type: "heatmap";
+    /** Minimum value for the color scale */
+    min?: number;
+    /** Maximum value for the color scale */
+    max?: number;
+    /** Show value labels on each cell. @default false */
+    showLabels?: boolean;
+    /** Show the visual map legend. @default false */
+    showVisualMap?: boolean;
+    /** Format the value displayed in cells and tooltip */
+    valueFormatter?: (value: number) => string;
+}
+
 declare type heightType = "xxs" | "xs" | "sm" | "md" | "lg" | "xl" | "2xl" | "3xl" | "full" | "auto";
 
 export declare const HomeLayout: WithDataTestIdReturnType_2<ForwardRefExoticComponent<Omit<{
@@ -6063,6 +6569,21 @@ export declare interface InitialFile {
     size?: number;
 }
 
+/**
+ * Re-inject section-end markers into a flat list that has none.
+ *
+ * Uses `inSectionQuestionIds` (the set of question IDs that originally
+ * belonged to *any* section) to determine where each section ends:
+ * - Questions in the set stay inside the current section.
+ * - Original standalone questions (NOT in the set) cause the section to close
+ *   before them so they remain standalone.
+ *
+ * This allows cross-section moves (a question from section B placed after
+ * section A's header joins section A) while keeping standalone questions
+ * outside sections unless the user explicitly drags them between section items.
+ */
+export declare function injectSectionEnds(items: FlatFormItem[], inSectionQuestionIds: Set<string>): FlatFormItem[];
+
 declare const INPUTFIELD_SIZES: readonly ["sm", "md"];
 
 declare type InputFieldInheritedProps = (typeof inputFieldInheritedProps)[number];
@@ -6279,10 +6800,20 @@ declare const levels: readonly ["info", "warning", "critical", "positive"];
 
 export declare function Li({ children, ...props }: React.HTMLAttributes<HTMLLIElement>): JSX_2.Element;
 
-export declare const LineChart: WithDataTestIdReturnType_5<ForwardRefExoticComponent<Omit<LineChartPropsBase<LineChartConfig> & {
+export declare const LineChart: WithDataTestIdReturnType_5<ForwardRefExoticComponent<Omit<LineChartPropsBase<LineChartConfig_2> & {
 lineType?: "natural" | "linear";
 } & RefAttributes<HTMLDivElement>, "ref"> & RefAttributes<HTMLElement | SVGElement>>>;
 
+export declare interface LineChartConfig extends ChartConfigBase {
+    type: "line";
+    /** @default "linear" */
+    lineType?: "linear" | "smooth" | "step";
+    /** Show gradient area fill below lines. @default true */
+    showArea?: boolean;
+    /** Show data point dots on the lines. @default false */
+    showDots?: boolean;
+}
+
 declare type LinkContextValue = {
     currentPath?: string;
     component?: (props: LinkProps, ref: ForwardedRef<HTMLAnchorElement>) => JSX.Element;
@@ -6293,6 +6824,10 @@ declare type LinkProps = AnchorHTMLAttributes<HTMLAnchorElement> & {
     disabled?: boolean;
 };
 
+declare type LinkQuestionProps = BaseQuestionPropsForOtherQuestionComponents & {
+    value?: string | null;
+};
+
 export declare const linkVariants: readonly ["link", "unstyled", "mention"];
 
 /**
@@ -6384,6 +6919,20 @@ declare type MentionsConfig = {
     users: MentionedUser[];
 };
 
+/** How to format the metric value */
+export declare type MetricFormat = {
+    type: "number";
+} | {
+    type: "currency";
+    currency?: string;
+} | {
+    type: "percent";
+} | {
+    type: "custom";
+    suffix?: string;
+    prefix?: string;
+};
+
 /**
  * Known MIME types for the file field `accept` prop.
  *
@@ -6664,6 +7213,10 @@ declare type NumericFormatterOptions = {
     useGrouping?: boolean;
 };
 
+declare type NumericQuestionProps = BaseQuestionPropsForOtherQuestionComponents & {
+    value?: number | null;
+};
+
 /**
  * Numeric size scale matching core spacing (relativeSpacing).
  * Maps 1:1 to Tailwind classes like w-0, w-4, w-8, w-16, etc.
@@ -6732,11 +7285,61 @@ declare type NumericWithFormatter = {
 
 export declare function Ol({ children, ...props }: React.HTMLAttributes<HTMLOListElement>): JSX_2.Element;
 
+export declare type OnAddNewElementParams = {
+    type: ElementType;
+    afterId?: string;
+};
+
 declare type OnBulkActionCallback<Record extends RecordType, Filters extends FiltersDefinition> = (...args: [
 action: BulkAction,
 ...Parameters<OnSelectItemsCallback<Record, Filters>>
 ]) => void;
 
+declare type OnChangeQuestionParams = BaseQuestionOnChangeParams & ({
+    type: "text" | "longText";
+    value?: string | null;
+} | {
+    type: "rating";
+    value: number;
+    options?: {
+        value: number;
+        label: string;
+    }[];
+} | {
+    type: "select";
+    value?: string | null;
+    options: SelectQuestionOption[];
+} | {
+    type: "multi-select";
+    value?: string[] | null;
+    options: SelectQuestionOption[];
+} | {
+    type: "dropdown-single";
+    value?: string | null;
+    options?: SelectQuestionOption[];
+} | {
+    type: "numeric";
+    value?: number | null;
+} | {
+    type: "link";
+    value?: string | null;
+} | {
+    type: "date";
+    value?: Date | null;
+});
+
+export declare type OnChangeSectionParams = {
+    id: string;
+    title: string;
+    description?: string;
+    questions?: QuestionElement[];
+};
+
+export declare type OnDuplicateElementParams = {
+    elementId: string;
+    type: ElementType;
+};
+
 export declare const OneFilterPicker: <Definition extends FiltersDefinition>(props: OneFilterPickerRootProps<Definition> & {
     dataTestId?: string;
 }) => ReactElement | null;
@@ -6915,6 +7518,20 @@ declare type PersonTagProps = ComponentProps<typeof F0TagPerson>;
 
 export declare const PieChart: WithDataTestIdReturnType_5<ForwardRefExoticComponent<Omit<PieChartProps & RefAttributes<HTMLDivElement>, "ref"> & RefAttributes<HTMLElement | SVGElement>>>;
 
+export declare interface PieChartConfig {
+    type: "pie";
+    /** Inner radius ratio (0 = full pie, >0 = donut). @default 0 */
+    innerRadius?: number;
+    /** Show the legend below the chart. @default true */
+    showLegend?: boolean;
+    /** Show value labels on each segment. @default true */
+    showLabels?: boolean;
+    /** Show percentage in labels. @default false */
+    showPercentage?: boolean;
+    /** Format the value displayed in labels and tooltip */
+    valueFormatter?: (value: number) => string;
+}
+
 declare type PopupSize = "sm" | "md" | "lg";
 
 /** CSS position */
@@ -7169,6 +7786,53 @@ declare type Props_3 = {
     list?: TagCounterItem[];
 };
 
+export declare type QuestionActionParams = {
+    questionId: string;
+    type: ActionType;
+    index: number;
+};
+
+export declare type QuestionElement = Omit<TextQuestionProps, QuestionPropsToOmit> | Omit<RatingQuestionProps & {
+    type: "rating";
+}, QuestionPropsToOmit> | Omit<SelectQuestionProps & {
+    type: "select" | "multi-select";
+}, QuestionPropsToOmit> | Omit<DropdownSingleQuestionProps & {
+    type: "dropdown-single";
+}, QuestionPropsToOmit> | Omit<NumericQuestionProps & {
+    type: "numeric";
+}, QuestionPropsToOmit> | Omit<LinkQuestionProps & {
+    type: "link";
+}, QuestionPropsToOmit> | Omit<DateQuestionProps & {
+    type: "date";
+}, QuestionPropsToOmit>;
+
+declare type QuestionPropsToOmit = "onAction" | "onChange" | "onAddNewElement";
+
+export declare type QuestionType = "rating" | "select" | "multi-select" | "dropdown-single" | "text" | "longText" | "numeric" | "link" | "date";
+
+export declare interface RadarChartConfig {
+    type: "radar";
+    /** Fill the radar area. @default true */
+    showArea?: boolean;
+    /** Show the legend below the chart. @default true */
+    showLegend?: boolean;
+    /** Show value labels on data points. @default false */
+    showLabels?: boolean;
+    /** Format the value displayed in labels and tooltip */
+    valueFormatter?: (value: number) => string;
+}
+
+declare type RatingQuestionProps = BaseQuestionPropsForOtherQuestionComponents & {
+    value?: number;
+} & {
+    options: {
+        value: number;
+        label: string;
+    }[];
+};
+
+export declare function reconstructElements(flatItems: FlatFormItem[]): SurveyFormBuilderElement[];
+
 /**
  * Utility type to get all possible paths through an object using dot notation
  * @template T - The object type to traverse
@@ -7336,8 +8000,24 @@ declare type SecondaryActionsDefinition = {
 
 declare type SecondaryActionsItems = SecondaryActionItem[] | SecondaryActionItem[][] | SecondaryActionGroup[];
 
+export declare type SectionActionParams = {
+    sectionId: string;
+    type: ActionType;
+    index: number;
+};
+
 /* Excluded from this release type: SectionDefinition */
 
+export declare type SectionElement = Omit<SectionProps, "onAction" | "onChange">;
+
+declare type SectionProps = {
+    id: string;
+    title: string;
+    description?: string;
+    locked?: boolean;
+    questions?: QuestionElement[];
+};
+
 /**
  * Conditional rendering for sections - can be a condition object or a function
  */
@@ -7412,6 +8092,23 @@ export declare type SelectionStatus<R extends RecordType, Filters extends Filter
     totalKnownItemsCount: number;
 };
 
+export declare type SelectQuestionOption = {
+    id?: string;
+    value: string;
+    label: string;
+    correct?: boolean;
+};
+
+declare type SelectQuestionProps = BaseQuestionPropsForOtherQuestionComponents & {
+    options: SelectQuestionOption[];
+} & ({
+    type: "select";
+    value?: string | null;
+} | {
+    type: "multi-select";
+    value?: string[] | null;
+});
+
 /**
  * Base for select-specific conditions
  */
@@ -7537,6 +8234,87 @@ declare type SummaryKey<Definition extends SummariesDefinition> = Definition ext
 
 declare type SummaryType = "sum";
 
+export declare function SurveyAnsweringForm({ elements, onSubmit, mode, title, isOpen, onClose, fullscreen: fullscreenProp, allowToChangeFullscreen, defaultValues, errorTriggerMode, }: SurveyAnsweringFormProps): JSX_2.Element;
+
+export declare type SurveyAnsweringFormMode = "stepped" | "all-questions";
+
+export declare interface SurveyAnsweringFormProps {
+    elements: SurveyFormBuilderElement[];
+    onSubmit: (answers: SurveySubmitAnswers) => Promise<SurveyFormSubmitResult> | SurveyFormSubmitResult;
+    mode: SurveyAnsweringFormMode;
+    title: string;
+    isOpen: boolean;
+    onClose: () => void;
+    fullscreen?: boolean;
+    allowToChangeFullscreen?: boolean;
+    defaultValues?: Partial<SurveyAnswers>;
+    errorTriggerMode?: F0FormErrorTriggerMode;
+}
+
+export declare type SurveyAnswers = Record<string, SurveyAnswerValue>;
+
+export declare type SurveyAnswerValue = {
+    type: "text" | "longText";
+    value: string | null;
+} | {
+    type: "rating";
+    value: number | null;
+} | {
+    type: "select";
+    value: string | null;
+} | {
+    type: "multi-select";
+    value: string[] | null;
+} | {
+    type: "dropdown-single";
+    value: string | null;
+} | {
+    type: "numeric";
+    value: number | null;
+} | {
+    type: "link";
+    value: string | null;
+} | {
+    type: "date";
+    value: Date | null;
+};
+
+export declare const SurveyFormBuilder: WithDataTestIdReturnType_7<({ elements: elementsProp, disabled, onChange, disallowOptionalQuestions, allowedQuestionTypes, applyingChanges, }: SurveyFormBuilderProps) => JSX_2.Element>;
+
+export declare type SurveyFormBuilderCallbacks = {
+    onQuestionChange?: (params: OnChangeQuestionParams) => void;
+    onSectionChange?: (params: OnChangeSectionParams) => void;
+    onAddNewElement?: (params: OnAddNewElementParams) => void;
+    onDuplicateElement?: (params: OnDuplicateElementParams) => void;
+};
+
+export declare type SurveyFormBuilderElement = {
+    type: "section";
+    section: SectionElement;
+} | {
+    type: "question";
+    question: QuestionElement;
+};
+
+export declare type SurveyFormBuilderProps = {
+    elements: SurveyFormBuilderElement[];
+    onChange: (elements: SurveyFormBuilderElement[]) => void;
+    disabled?: boolean;
+    disallowOptionalQuestions?: boolean;
+    allowedQuestionTypes?: QuestionType[];
+    applyingChanges?: boolean;
+};
+
+export declare type SurveyFormSubmitResult = {
+    success: true;
+    message?: string;
+} | {
+    success: false;
+    errors?: Record<string, string>;
+};
+
+export declare type SurveySubmitAnswers = Record<string, string | number | string[] | Date | null>;
+
 /**
  * All valid renderIf conditions for switch fields
  */
@@ -7895,6 +8673,11 @@ declare interface TextProps extends Omit<default_2.HTMLAttributes<HTMLElement>,
     required?: boolean;
 }
 
+declare type TextQuestionProps = BaseQuestionPropsForOtherQuestionComponents & {
+    type: "text" | "longText";
+    value?: string | null;
+};
+
 /**
  * Base for text-specific conditions
  */