@zestl/zvolv-widgets 0.0.2 → 0.0.3

package/dist/index.d.ts

@@ -235,6 +235,8 @@ declare function useTokens(): ZvolvTokens;
 
 type KpiTemplateId = "standard" | "trend" | "comparison" | "progress" | "financial" | "status" | "chart" | "hero_chart" | "icon";
 type BadgeTone = "success" | "warning" | "error" | "info" | "neutral";
+/** Where a content item goes in a card-level KPI layout (`config.layout: "card"`). */
+type KpiRole = "main" | "sub" | "chip" | "series";
 /**
  * View-model for a single resolved KPI item.
  *
@@ -273,9 +275,34 @@ interface KpiContentVM {
         description?: string;
     };
     series?: number[];
+    /** From `KpiContentConfig.role`; set only when configured. */
+    role?: KpiRole;
     raw: any;
     config: any;
 }
+/** Content items sorted into card slots. */
+interface KpiCardRoles {
+    /** role "main", else the first item without a role, else the first item. */
+    main: KpiContentVM | null;
+    /** role "sub": small values under the main one. */
+    subs: KpiContentVM[];
+    /** role "chip": its `delta` is the change badge. */
+    chip: KpiContentVM | null;
+    /** Sparkline data: the role "series" item's series, else main's. */
+    series: number[] | undefined;
+}
+/** Args for `KpiWidget` `render` and the `"KPI_CARD:card"` template. */
+interface KpiCardRenderArgs {
+    /** Every resolved item, in config order. */
+    vms: KpiContentVM[];
+    /** Items by `dataPoint` (the first item wins when two share one). */
+    byKey: Record<string, KpiContentVM>;
+    roles: KpiCardRoles;
+    state: "loading" | "ready" | "empty" | "unconfigured" | "error";
+    tokens: any;
+    config: any;
+    onItemClick?: (vm: KpiContentVM, index: number) => void;
+}
 /** Props every KPI template component receives. */
 interface KpiTemplateProps {
     vm: KpiContentVM;
@@ -307,11 +334,23 @@ declare const Value: React.FC<{
 declare const Delta: React.FC<{
     vm: KpiTemplateProps["vm"];
 }>;
-declare const Sparkline: React.FC<{
+interface KpiSparklineProps {
     series: number[];
     color: string;
+    /** CSS width. Default "100%". */
+    width?: number | string;
+    /** Height in px. Default 40. */
     height?: number;
-}>;
+    /** Fill the area under the line. */
+    area?: boolean;
+    /** "minmax" (default) fits the data; "zero" keeps 0 on the axis. */
+    scale?: "minmax" | "zero";
+}
+declare const Sparkline: React.FC<KpiSparklineProps>;
+/** Sorts card items into slots by `role`. Pure. */
+declare function resolveKpiRoles(vms: KpiContentVM[]): KpiCardRoles;
+/** Default `"KPI_CARD:card"` template: one card, items placed by `role`. */
+declare const Card: React.FC<KpiCardRenderArgs>;
 declare const KPI_DEFAULT_TEMPLATES: {
     standard: React.FC<KpiTemplateProps>;
     trend: React.FC<KpiTemplateProps>;
@@ -523,6 +562,53 @@ declare function coerceSeriesNumbers(rows: any[], series: {
     valueField: string;
 }[]): any[];
 
+/**
+ * Row reshaping that runs client-side after the query: turning one wide row
+ * into one row per category (`unpivot`), and filling categories that returned
+ * no bucket (`categoryGap`). Neither changes what is queried.
+ */
+interface UnpivotOptions {
+    /** Columns of row 0 to turn into rows, in output order. */
+    columns: string[];
+    /** Output key for the column name. Default "label". */
+    labelField?: string;
+    /** Output key for the column value. Default "value". */
+    valueField?: string;
+    /**
+     * Extra columns to copy onto an output row: source column → output field.
+     * A source column belongs to the listed column its name starts with (the
+     * longest such match), so `{ "Contacted %": "step" }` sets `step` on the
+     * "Contacted" row. A source column matching no listed column is copied
+     * onto every output row.
+     */
+    extra?: Record<string, string>;
+}
+interface CategoryGapOptions {
+    /** Row key holding the category — normally the chart's argumentField. */
+    field: string;
+    /**
+     * Categories in display order, or "fromForm" to read the field's dropdown
+     * options from the form schema.
+     */
+    values: string[] | "fromForm";
+}
+/**
+ * Row 0's `columns` → one row per column, in the given order:
+ * `{ [labelField]: column, [valueField]: number }`. A missing column is 0.
+ * Other input rows are ignored (a multi-number source returns one row).
+ */
+declare function unpivotRows(rows: any[], options: UnpivotOptions): any[];
+/** The dropdown values of a form element, as stored (select value first). */
+declare function elementOptionValues(element: any): string[];
+/**
+ * One row per value of `field`, in `values` order. Categories with no row get
+ * `{ [field]: value }` plus 0 for every series valueField. Rows whose category
+ * is not listed are kept, in their original order, after the listed ones.
+ */
+declare function fillCategoryGaps(rows: any[], field: string, values: string[], series: {
+    valueField: string;
+}[]): any[];
+
 /**
  * DataSource authoring — how a widget says WHERE its data comes from.
  *
@@ -884,6 +970,17 @@ interface UseWidgetDataArgs {
     rowLimit?: number;
     /** Fill empty periods (and optionally accumulate) on a date x-axis. See `DateGapOptions`. */
     dateGap?: DateGapOptions | null;
+    /**
+     * Turn row 0's columns into one row per column, in order (after
+     * postOperations). With no declared series, x/y become `labelField`/`valueField`.
+     */
+    unpivot?: UnpivotOptions | null;
+    /**
+     * Ensure one row per category, in the given order, with 0 for every series
+     * valueField where no bucket came back. Applied after postOperations and
+     * widget filters, before local search / column filters / sort.
+     */
+    categoryGap?: CategoryGapOptions | null;
     /** Rows supplied by an automation binding; when provided, no query is issued. */
     automationRows?: any[] | null;
     automationLoading?: boolean;
@@ -1156,6 +1253,14 @@ interface KpiWidgetProps extends Omit<InteractiveWidgetProps, "widgetType"> {
      * items you fetch yourself. Wins over a self-fetched `seriesSource.dataSource`.
      */
     externalSeriesByIndex?: Record<number, number[]>;
+    /**
+     * Render the whole card yourself. Used only with `layout: "card"` (so a
+     * generic `render` a host passes to every widget never changes a KPI).
+     * Wins over the `"KPI_CARD:card"` template.
+     */
+    renderCard?: (args: KpiCardRenderArgs) => React.ReactNode;
+    /** Same as `renderCard`, and likewise only with `layout: "card"`. */
+    render?: (args: KpiCardRenderArgs) => React.ReactNode;
 }
 declare const KpiWidget: React.FC<KpiWidgetProps>;
 
@@ -1229,9 +1334,49 @@ interface RankingBarWidgetProps extends Omit<InteractiveWidgetProps, "widgetType
 }
 /**
  * Ranked list of categories. Sorting, ranking and ratio math happen here; the
- * caller renders. `config.ranking` supplies { limit, order, labelField, valueField }.
+ * caller renders. `config.ranking` supplies { limit, order, labelField, valueField };
+ * `order: "none"` keeps the incoming row order.
  */
 declare const RankingBarWidget: React.FC<RankingBarWidgetProps>;
+interface FunnelRow {
+    label: any;
+    value: number;
+    /** value ÷ the first stage's value, 0..∞. 0 when the first stage is 0. */
+    ratioToFirst: number;
+    /** value ÷ the previous stage × 100. null for the first stage, or when the previous is 0. */
+    stepPct: number | null;
+    isFirst: boolean;
+    index: number;
+    raw: any;
+}
+interface FunnelRenderArgs {
+    rows: FunnelRow[];
+    /** The first stage, or null with no rows. */
+    first: FunnelRow | null;
+    tokens: ZvolvTokens;
+    config: any;
+    toLabel: (value: any) => any;
+    onItemClick?: (row: FunnelRow) => void;
+}
+interface FunnelWidgetProps extends Omit<InteractiveWidgetProps, "widgetType"> {
+    title?: string;
+    description?: string;
+    emptyMessage?: string;
+    unconfiguredMessage?: string;
+    className?: string;
+    style?: React.CSSProperties;
+    /** Called with the clicked stage — for drill-down. */
+    onItemClick?: (row: FunnelRow) => void;
+    render?: (args: FunnelRenderArgs) => React.ReactNode;
+}
+/** Rows (in stage order) → funnel stages. Pure; usable outside React. */
+declare function computeFunnelRows(rows: any[], labelField: string, valueField: string): FunnelRow[];
+/**
+ * Stage funnel (type FUNNEL). Rows arrive in stage order — usually from `unpivot` on a
+ * one-row, many-number source — and are never re-sorted. `config.funnel`
+ * may set { labelField, valueField }; defaults are the series x / y.
+ */
+declare const FunnelWidget: React.FC<FunnelWidgetProps>;
 interface GaugeRenderArgs {
     value: number;
     min: number;
@@ -2182,15 +2327,45 @@ declare function resolveFormWidget(config: any, dataSource?: any): {
 };
 /** Form widget: the headless form engine inside widget chrome. */
 declare const FormWidget: React.FC<FormWidgetProps>;
+/** Options for a filter control fetched from another data source. */
+interface FilterOptionsSource {
+    /** Usually a raw-rows formSource on another form, e.g. open mandates. */
+    dataSource: any;
+    /** Row key shown in the dropdown. */
+    labelField: string;
+    /**
+     * Row key used as the filter value. For a FORM_SEARCH lookup target this
+     * must be the lookup's ViewLabel field: the filter matches `<field>.view`.
+     */
+    valueField: string;
+    /** Sort options by label. Default: keep the source's row order. */
+    sort?: "asc" | "desc";
+    /** Label of the "no filter" option. Default "All". */
+    allLabel?: string;
+}
+interface FilterOption {
+    label: any;
+    value: any;
+}
 interface FilterControl {
     key: string;
     label: any;
     type: "text" | "select" | "multiselect" | "date" | "daterange" | "number";
-    options?: {
-        label: any;
-        value: any;
-    }[];
+    options?: FilterOption[];
     value?: any;
+    /** Field the produced WidgetFilter targets. */
+    field?: string;
+    optionsSource?: FilterOptionsSource;
+    /** True while `optionsSource` options load. */
+    loading?: boolean;
+}
+interface FilterSlotArgs {
+    control: FilterControl;
+    options: FilterOption[];
+    value: any;
+    setValue: (value: any) => void;
+    loading: boolean;
+    tokens: ZvolvTokens;
 }
 interface FilterPanelRenderArgs {
     controls: FilterControl[];
@@ -2198,6 +2373,8 @@ interface FilterPanelRenderArgs {
     setValue: (key: string, value: any) => void;
     apply: () => void;
     reset: () => void;
+    /** Current selections as widget filters (select / multiselect controls with a `field`). */
+    filters: WidgetFilter[];
     tokens: ZvolvTokens;
     config: any;
 }
@@ -2209,8 +2386,31 @@ interface FilterPanelWidgetProps {
     /** Current filter values, owned by the dashboard (URL params). */
     value?: Record<string, any>;
     onChange?: (values: Record<string, any>) => void;
+    /**
+     * Selections as `WidgetFilter[]` — pass straight to a widget's
+     * `widgetFilters`. A control on "All" (null / empty) contributes nothing.
+     */
+    onFiltersChange?: (filters: WidgetFilter[]) => void;
+    /** Replaces one control's UI; the panel still owns options and state. */
+    renderFilter?: (args: FilterSlotArgs) => React.ReactNode;
     render?: (args: FilterPanelRenderArgs) => React.ReactNode;
 }
+/**
+ * The option a stored value refers to. Values restored from URL params are
+ * strings, so "123" matches an option whose value is 123.
+ */
+declare function matchFilterOption(options: FilterOption[] | undefined, value: any): FilterOption | undefined;
+/** Panel values → widget filters: `{ field, operator: "IN", value: [...] }` per selected control. */
+declare function filterPanelToWidgetFilters(controls: FilterControl[], values: Record<string, any>): WidgetFilter[];
+/**
+ * The query behind a control's options: a distinct-values (composite terms)
+ * aggregation over the WHOLE index, with the source's own filters applied by
+ * Elasticsearch — never "the first N rows". A source that already declares a
+ * pivot is used as is.
+ */
+declare function optionsDataSource(source: FilterOptionsSource): any;
+/** Fetched rows → distinct, non-empty options. Pure. */
+declare function rowsToFilterOptions(rows: any[], source: FilterOptionsSource): FilterOption[];
 /**
  * In-grid filter panel. Dashboard filters are URL-param driven and owned by the
  * host, so this is a controlled component: it renders controls and reports
@@ -2426,9 +2626,16 @@ interface KpiContentConfig {
         mode?: "timeseries" | "fields";
         [k: string]: any;
     };
+    /** Slot in `layout: "card"`: big value, small inline value, delta chip, or sparkline. */
+    role?: KpiRole;
 }
 interface KpiConfig extends WidgetChromeConfig {
     template?: KpiTemplateId;
+    /**
+     * "card" renders every item inside ONE card, placed by `role` (template key
+     * `"KPI_CARD:card"`). Default: each item as its own block.
+     */
+    layout?: "card" | "stack";
     contents?: KpiContentConfig[];
 }
 interface TableColumnConfig {
@@ -2542,10 +2749,19 @@ interface RankingConfig extends WidgetChromeConfig {
     ranking?: {
         labelField?: string;
         valueField?: string;
-        order?: "asc" | "desc";
+        /** "none" keeps the incoming row order. Default "desc". */
+        order?: "asc" | "desc" | "none";
         limit?: number;
     };
 }
+interface FunnelConfig extends WidgetChromeConfig {
+    template?: string;
+    /** Defaults: the series x / y (with `unpivot`, "label" / "value"). */
+    funnel?: {
+        labelField?: string;
+        valueField?: string;
+    };
+}
 interface TreeConfig extends WidgetChromeConfig {
     tree?: {
         idField?: string;
@@ -2604,6 +2820,19 @@ interface FilterPanelConfig extends WidgetChromeConfig {
             label: any;
             value: any;
         }[];
+        /**
+         * Fetch options from another data source (one request). Selecting one
+         * emits `{ field, operator: "IN", value: [v] }` via `onFiltersChange`;
+         * "All" emits nothing. For a FORM_SEARCH `field`, `valueField` must be
+         * the lookup's ViewLabel field (the filter matches `<field>.view`).
+         */
+        optionsSource?: {
+            dataSource: ZvolvDataSource;
+            labelField: string;
+            valueField: string;
+            sort?: "asc" | "desc";
+            allLabel?: string;
+        };
     }[];
 }
 /** A complete widget definition as a dashboard stores it. */
@@ -3248,4 +3477,4 @@ declare function formWidget(o: {
     Description: string;
 };
 
-export { ActionCardWidget, type ActionCardWidgetProps, type ActionConfig, type ActionItem, type ActionOutcome, type ActionRenderArgs, ActivityFeedWidget, type AggregateOptions, type AggregationType, AreaChartWidget, type AxisConfig, BLOCKED_FILE_EXTENSIONS, type BadgeTone, BannerWidget, BarChartWidget, COLUMN_FILTER_BLANK, CONTAINER_KINDS, CalendarWidget, CardListWidget, CarouselWidget, type CellArgs, type ChartConfig, type ChartRenderArgs, ChartWidget, type ChartWidgetProps, ChildTableWidget, type CollectionConfig, type CollectionItem, type CollectionMappingConfig, type CollectionRenderArgs, CollectionWidget, type CollectionWidgetProps, type ColumnFilterSlotArgs, type ColumnFilters, type CreateZvolvRuntimeOptions, type DashboardFilterDef, type DashboardFilterValue, type DashboardNode, DashboardTableWidget, type DataSourceDefinition, type DataSourceField, DatabaseTableWidget, type DateDiffField, type DateDiffSpec, type DateDiffUnit, type DateGapOptions, type DateGapUnit, type DateInterval, type DateRange, type DateRangeToken, type DateToken, type DeepPartial, DefaultField, type DefaultInsight, DoughnutChartWidget, EMPTY_INTERACTIONS, type ElementSpec, EntityGalleryWidget, type FieldFilter, type FieldKind, type FieldOption, type FieldOptionsState, type FileFieldState, type FileItem, type FillDateGapsArgs, type FilterControl, type FilterInsight, type FilterOperator, type FilterPanelConfig, type FilterPanelRenderArgs, FilterPanelWidget, type FilterPanelWidgetProps, type FilterableField, FormApiContext, type FormConfig, type FormDefinition, type FormElement, type FormErrors, type FormField, FormFields, type FormInspection, type FormKit, FormKitSlot, type FormMode, type FormSpec, type FormStatus, type FormValues, FormWidget, type FormWidgetProps, type FormulaInsight, GRID, GanttChartWidget, type GaugeConfig, GaugeMeterWidget, type GaugeMeterWidgetProps, type GaugeRenderArgs, GoogleMapWidget, GridCardWidget, type GridItem, type HeatCell, type HeatMapConfig, type HeatMapRenderArgs, HeatMapWidget, type HeatMapWidgetProps, type HtmlConfig, type HtmlRenderArgs, HtmlWidget, type HtmlWidgetProps, type IframeConfig, IframeWidget, type IframeWidgetProps, type InteractionMode, type InteractionProps, type InteractionStateProps, type InteractionUiProps, type InteractiveWidgetData, type InteractiveWidgetProps, KPI_DEFAULT_TEMPLATES, type KpiConfig, type KpiContentConfig, type KpiContentVM, Delta as KpiDelta, Label as KpiLabel, Sparkline as KpiSparkline, type KpiTemplateId, type KpiTemplateProps, type KpiTimeseriesSource, Value as KpiValue, KpiWidget, type KpiWidgetProps, type LegendConfig, LineChartWidget, type LookupConfig, type MapConfig, type MapMarker, type MapRenderArgs, type MapWidgetProps, type MasterFieldDataType, type MasterFieldType, MeetingSchedulerWidget, type MockQuery, type MockRuntimeOptions, NON_INPUT_TYPES, NON_RENDERING_TYPES, type NormalizedWidget, type OpenFormRequest, PREFIX_UNITS, type PayloadInsight, PieChartWidget, type PivotConfig, type PivotFilter, PivotGridWidget, type PivotGridWidgetProps, type PivotRenderArgs, type PivotRow, type PivotSummary, type PostOperation, type PostOperator, RankingBarWidget, type RankingBarWidgetProps, type RankingConfig, type RankingRenderArgs, type RankingRow, RawHtmlWidget, type ResolvedChromeConfig, type RuleEffect, type RuleInsight, type RuleOverride, SAMPLE_ROWS, SUBMISSION_SKIP_TYPES, SUFFIX_UNITS, ScatterChartWidget, type SearchSlotArgs, type SeriesConfig, type SheetColumn, type SheetFieldState, type SortDirection, type SortSlotArgs, type SortState, type StepItem, type StepperConfig, type StepperRenderArgs, StepperWidget, type StepperWidgetProps, type SubmitOptions, type TabConfig, type TabItem, type TabRenderArgs, TabWidget, type TabWidgetProps, type TableColumn, type TableColumnConfig, type TableConfig, type TableRenderArgs, TableWidget, type TableWidgetProps, TaskTrackerTableWidget, type TemplateComponent, type TemplateMap, TemplateProvider, type TemporalConfig, type TemporalEvent, type TemporalMappingConfig, type TemporalRenderArgs, TemporalWidget, type TemporalWidgetProps, TimelineWidget, type Tone, type ToolbarSlotArgs, type TreeConfig, type TreeNode, type TreeRenderArgs, TreeWidget, type TreeWidgetProps, type TrialButton, type TrialFieldState, type TrialLogEntry, type UploadedFile, type UseKpiContentsArgs, type UseWidgetDataArgs, type UseZvolvFormArgs, type ValidationInsight, WIDGET_REGISTRY, type WidgetChrome, type WidgetChromeConfig, type WidgetConfigurations, type WidgetDataResult, type WidgetDefinition, type WidgetFilter, type WidgetFilterSlotArgs, type WidgetInteractionState, type WidgetInteractions, WidgetShell, type WidgetShellProps, type WidgetState, type WidgetStateRenderArgs, WidgetStateSlot, type WidgetStyleOverrides, type WidgetTypeId, ZaiChatWidget, type ZaiChatWidgetProps, type ZvolvDataSource, ZvolvForm, type ZvolvFormApi, type ZvolvFormProps, ZvolvProvider, type ZvolvProviderProps, type ZvolvRuntime, ZvolvThemeProvider, type ZvolvTokens, ZvolvWidget, type ZvolvWidgetProps, addPeriod, aggregate, alignSummaryToSeries, applyCumulative, applyLocalColumnFilters, applyLocalSearch, applyLocalSort, applyLocalWidgetFilters, applyPostOperations, applyRules, automationSource, buildColumnFilterClauses, buildDashFilters, buildDashboardTree, buildInitialValues, buildRemoteSort, buildSearchClause, buildSubmissionElements, buildTree, buildTriggerBody, buildWidgetFilterClauses, cascade, cdateFiltersFor, childIdsOf, cleanTitle, clearLookupCache, coerceSeriesNumbers, computeRowFormulas, createMockRuntime, createSubmission, createZvolvRuntime, dashboardDefaultDateToken, dashboardFilterDefs, dateDiff, dateRangeFor, defaultTokens, defineConfig, defineForm, derive, describeWidgetFilter, distinctColumnValues, eid, el, evaluateFormula, extractAgentFormData, fetchForm, fetchLookupOptions, fetchSubmission, field, fieldKind, fieldKindOf, fillDateGaps, filterableFields, flattenPercentiles, formSource, formWidget, formatAmountValue, formatCompact, formatFieldValue, formulaLabels, getDataType, getEmptyValue, getPostOpOperandSet, getPostOpResult, gridHeight, gridWidgets, groupBy, hasActiveInteractions, inspectForm, interpolate, invokeAgent, invokeTrigger, invokeZeno, isDataSourceConfigured, isLegacyId, isLikelyTimestamp, isServerSafeFormula, lookupConfigOf, mergeTokens, normaliseElement, normaliseForm, normalizeWidget, openFormRequest, operatorsForKind, optionFilterRules, parseConfig, parseDateValue, parseDeep, percentileKey, pivot, renderHtmlVariables, resetQueryUser, resolveChrome, resolveChromeConfig, resolveCollectionMapping, resolveDashboardLayout, resolveDateToken, resolveDrillDown, resolveFieldType, resolveFilterMode, resolveFormWidget, resolveSeries, resolveTableMode, resolveWidget, resolveWidgetDefaults, resolveXKey, rowSubmissionIds, ruleMatches, rulesOf, searchPeople, serializeElementValue, startOfPeriod, statusTone, submissionIdOf, submissionToValues, submitElementsOf, taskField, taskSource, toBraceFormula, toNum, toRelational, toneColor, toneSurface, updateSubmission, uploadFile, useCollectionItems, useFieldOptions, useFileField, useFormApi, useFormInspector, useInteractiveWidgetData, useKpiContents, useSheetField, useTableColumns, useTemplateOverride, useTemporalEvents, useTokens, useTrialField, useWidgetData, useWidgetInteractions, useZvolvClient, useZvolvForm, useZvolvRuntime, usesFormFramework, validateField, validateForm, when, where };
+export { ActionCardWidget, type ActionCardWidgetProps, type ActionConfig, type ActionItem, type ActionOutcome, type ActionRenderArgs, ActivityFeedWidget, type AggregateOptions, type AggregationType, AreaChartWidget, type AxisConfig, BLOCKED_FILE_EXTENSIONS, type BadgeTone, BannerWidget, BarChartWidget, COLUMN_FILTER_BLANK, CONTAINER_KINDS, CalendarWidget, CardListWidget, CarouselWidget, type CategoryGapOptions, type CellArgs, type ChartConfig, type ChartRenderArgs, ChartWidget, type ChartWidgetProps, ChildTableWidget, type CollectionConfig, type CollectionItem, type CollectionMappingConfig, type CollectionRenderArgs, CollectionWidget, type CollectionWidgetProps, type ColumnFilterSlotArgs, type ColumnFilters, type CreateZvolvRuntimeOptions, type DashboardFilterDef, type DashboardFilterValue, type DashboardNode, DashboardTableWidget, type DataSourceDefinition, type DataSourceField, DatabaseTableWidget, type DateDiffField, type DateDiffSpec, type DateDiffUnit, type DateGapOptions, type DateGapUnit, type DateInterval, type DateRange, type DateRangeToken, type DateToken, type DeepPartial, DefaultField, type DefaultInsight, DoughnutChartWidget, EMPTY_INTERACTIONS, type ElementSpec, EntityGalleryWidget, type FieldFilter, type FieldKind, type FieldOption, type FieldOptionsState, type FileFieldState, type FileItem, type FillDateGapsArgs, type FilterControl, type FilterInsight, type FilterOperator, type FilterOption, type FilterOptionsSource, type FilterPanelConfig, type FilterPanelRenderArgs, FilterPanelWidget, type FilterPanelWidgetProps, type FilterSlotArgs, type FilterableField, FormApiContext, type FormConfig, type FormDefinition, type FormElement, type FormErrors, type FormField, FormFields, type FormInspection, type FormKit, FormKitSlot, type FormMode, type FormSpec, type FormStatus, type FormValues, FormWidget, type FormWidgetProps, type FormulaInsight, type FunnelConfig, type FunnelRenderArgs, type FunnelRow, FunnelWidget, type FunnelWidgetProps, GRID, GanttChartWidget, type GaugeConfig, GaugeMeterWidget, type GaugeMeterWidgetProps, type GaugeRenderArgs, GoogleMapWidget, GridCardWidget, type GridItem, type HeatCell, type HeatMapConfig, type HeatMapRenderArgs, HeatMapWidget, type HeatMapWidgetProps, type HtmlConfig, type HtmlRenderArgs, HtmlWidget, type HtmlWidgetProps, type IframeConfig, IframeWidget, type IframeWidgetProps, type InteractionMode, type InteractionProps, type InteractionStateProps, type InteractionUiProps, type InteractiveWidgetData, type InteractiveWidgetProps, KPI_DEFAULT_TEMPLATES, Card as KpiCard, type KpiCardRenderArgs, type KpiCardRoles, type KpiConfig, type KpiContentConfig, type KpiContentVM, Delta as KpiDelta, Label as KpiLabel, type KpiRole, Sparkline as KpiSparkline, type KpiSparklineProps, type KpiTemplateId, type KpiTemplateProps, type KpiTimeseriesSource, Value as KpiValue, KpiWidget, type KpiWidgetProps, type LegendConfig, LineChartWidget, type LookupConfig, type MapConfig, type MapMarker, type MapRenderArgs, type MapWidgetProps, type MasterFieldDataType, type MasterFieldType, MeetingSchedulerWidget, type MockQuery, type MockRuntimeOptions, NON_INPUT_TYPES, NON_RENDERING_TYPES, type NormalizedWidget, type OpenFormRequest, PREFIX_UNITS, type PayloadInsight, PieChartWidget, type PivotConfig, type PivotFilter, PivotGridWidget, type PivotGridWidgetProps, type PivotRenderArgs, type PivotRow, type PivotSummary, type PostOperation, type PostOperator, RankingBarWidget, type RankingBarWidgetProps, type RankingConfig, type RankingRenderArgs, type RankingRow, RawHtmlWidget, type ResolvedChromeConfig, type RuleEffect, type RuleInsight, type RuleOverride, SAMPLE_ROWS, SUBMISSION_SKIP_TYPES, SUFFIX_UNITS, ScatterChartWidget, type SearchSlotArgs, type SeriesConfig, type SheetColumn, type SheetFieldState, type SortDirection, type SortSlotArgs, type SortState, type StepItem, type StepperConfig, type StepperRenderArgs, StepperWidget, type StepperWidgetProps, type SubmitOptions, type TabConfig, type TabItem, type TabRenderArgs, TabWidget, type TabWidgetProps, type TableColumn, type TableColumnConfig, type TableConfig, type TableRenderArgs, TableWidget, type TableWidgetProps, TaskTrackerTableWidget, type TemplateComponent, type TemplateMap, TemplateProvider, type TemporalConfig, type TemporalEvent, type TemporalMappingConfig, type TemporalRenderArgs, TemporalWidget, type TemporalWidgetProps, TimelineWidget, type Tone, type ToolbarSlotArgs, type TreeConfig, type TreeNode, type TreeRenderArgs, TreeWidget, type TreeWidgetProps, type TrialButton, type TrialFieldState, type TrialLogEntry, type UnpivotOptions, type UploadedFile, type UseKpiContentsArgs, type UseWidgetDataArgs, type UseZvolvFormArgs, type ValidationInsight, WIDGET_REGISTRY, type WidgetChrome, type WidgetChromeConfig, type WidgetConfigurations, type WidgetDataResult, type WidgetDefinition, type WidgetFilter, type WidgetFilterSlotArgs, type WidgetInteractionState, type WidgetInteractions, WidgetShell, type WidgetShellProps, type WidgetState, type WidgetStateRenderArgs, WidgetStateSlot, type WidgetStyleOverrides, type WidgetTypeId, ZaiChatWidget, type ZaiChatWidgetProps, type ZvolvDataSource, ZvolvForm, type ZvolvFormApi, type ZvolvFormProps, ZvolvProvider, type ZvolvProviderProps, type ZvolvRuntime, ZvolvThemeProvider, type ZvolvTokens, ZvolvWidget, type ZvolvWidgetProps, addPeriod, aggregate, alignSummaryToSeries, applyCumulative, applyLocalColumnFilters, applyLocalSearch, applyLocalSort, applyLocalWidgetFilters, applyPostOperations, applyRules, automationSource, buildColumnFilterClauses, buildDashFilters, buildDashboardTree, buildInitialValues, buildRemoteSort, buildSearchClause, buildSubmissionElements, buildTree, buildTriggerBody, buildWidgetFilterClauses, cascade, cdateFiltersFor, childIdsOf, cleanTitle, clearLookupCache, coerceSeriesNumbers, computeFunnelRows, computeRowFormulas, createMockRuntime, createSubmission, createZvolvRuntime, dashboardDefaultDateToken, dashboardFilterDefs, dateDiff, dateRangeFor, defaultTokens, defineConfig, defineForm, derive, describeWidgetFilter, distinctColumnValues, eid, el, elementOptionValues, evaluateFormula, extractAgentFormData, fetchForm, fetchLookupOptions, fetchSubmission, field, fieldKind, fieldKindOf, fillCategoryGaps, fillDateGaps, filterPanelToWidgetFilters, filterableFields, flattenPercentiles, formSource, formWidget, formatAmountValue, formatCompact, formatFieldValue, formulaLabels, getDataType, getEmptyValue, getPostOpOperandSet, getPostOpResult, gridHeight, gridWidgets, groupBy, hasActiveInteractions, inspectForm, interpolate, invokeAgent, invokeTrigger, invokeZeno, isDataSourceConfigured, isLegacyId, isLikelyTimestamp, isServerSafeFormula, lookupConfigOf, matchFilterOption, mergeTokens, normaliseElement, normaliseForm, normalizeWidget, openFormRequest, operatorsForKind, optionFilterRules, optionsDataSource, parseConfig, parseDateValue, parseDeep, percentileKey, pivot, renderHtmlVariables, resetQueryUser, resolveChrome, resolveChromeConfig, resolveCollectionMapping, resolveDashboardLayout, resolveDateToken, resolveDrillDown, resolveFieldType, resolveFilterMode, resolveFormWidget, resolveKpiRoles, resolveSeries, resolveTableMode, resolveWidget, resolveWidgetDefaults, resolveXKey, rowSubmissionIds, rowsToFilterOptions, ruleMatches, rulesOf, searchPeople, serializeElementValue, startOfPeriod, statusTone, submissionIdOf, submissionToValues, submitElementsOf, taskField, taskSource, toBraceFormula, toNum, toRelational, toneColor, toneSurface, unpivotRows, updateSubmission, uploadFile, useCollectionItems, useFieldOptions, useFileField, useFormApi, useFormInspector, useInteractiveWidgetData, useKpiContents, useSheetField, useTableColumns, useTemplateOverride, useTemporalEvents, useTokens, useTrialField, useWidgetData, useWidgetInteractions, useZvolvClient, useZvolvForm, useZvolvRuntime, usesFormFramework, validateField, validateForm, when, where };