@zestl/zvolv-widgets 0.0.0 → 0.0.1

package/dist/index.d.cts

@@ -1652,7 +1652,7 @@ interface FieldOption {
  * The UI family a field belongs to. A host draws one control per kind; the
  * library owns everything behind it (value shape, validation, submit format).
  */
-type FieldKind = "text" | "textarea" | "email" | "phone" | "url" | "number" | "currency" | "percent" | "select" | "radio" | "checkbox" | "lookup" | "user" | "date" | "time" | "datetime" | "daterange" | "rating" | "slider" | "file" | "signature" | "richtext" | "scan" | "timer" | "location" | "formula" | "display" | "autonumber" | "section" | "container" | "tabs" | "steps" | "matrix" | "table" | "sheet" | "comments" | "action" | "onbehalf" | "system" | "unknown";
+type FieldKind = "text" | "textarea" | "email" | "phone" | "url" | "number" | "currency" | "percent" | "select" | "radio" | "checkbox" | "lookup" | "user" | "date" | "time" | "datetime" | "daterange" | "rating" | "slider" | "file" | "signature" | "richtext" | "scan" | "timer" | "location" | "formula" | "display" | "autonumber" | "section" | "container" | "tabs" | "steps" | "matrix" | "table" | "sheet" | "comments" | "action" | "onbehalf" | "trials" | "system" | "unknown";
 
 /** Types never sent in a submission body. */
 declare const SUBMISSION_SKIP_TYPES: Set<string>;
@@ -1709,6 +1709,22 @@ declare function submissionIdOf(res: any): string | null;
 declare function createSubmission(client: any, form: FormDefinition, elements: FormElement[], values: FormValues, opts?: SubmitOptions): Promise<any>;
 declare function updateSubmission(client: any, form: FormDefinition, submissionId: string, elements: FormElement[], values: FormValues, opts?: SubmitOptions): Promise<any>;
 declare function invokeTrigger(client: any, triggerId: string | number, body: Record<string, any>): Promise<any>;
+/** TRIGGER_AUTOMATION with properties.automationType "ZENO" (zvolv-web onTriggerZeno → invokeNuclioAutomation). */
+declare function invokeZeno(client: any, automationUuid: string, body: Record<string, any>): Promise<any>;
+/**
+ * INVOKE_AGENT.
+ * 1. With properties.flowId: POST /api/v1/zwall/agent/invoke/{flowId}/{agentId} — the
+ *    zvolv-web / ZAI-Dashboard call (legacy agent flows).
+ * 2. Without a flowId, or when that server has no such flow (it answers
+ *    `{ error: true, reply: "Error: '<flowId>'" }`): POST
+ *    /api/v1/zwall/v3/agent_manager/agent_flow/{agentId} — how the platform calls
+ *    current ZAI agents (zvolv-mcp zagent.call_agent).
+ * Called directly, not through the SDK's workflow.invokeAgent, whose handleRequest
+ * rejects any reply without `error: false` ("Error fetching data").
+ */
+declare function invokeAgent(client: any, body: any, flowId?: string, agentId?: string): Promise<any>;
+/** Field map from an agent reply: `{formData}` or wrapped in `response`, possibly JSON-encoded (ZAI extractAgentFormData). */
+declare function extractAgentFormData(reply: any): Record<string, any> | null;
 interface UploadedFile {
     media_name: string;
     media_type: string;
@@ -1799,7 +1815,7 @@ interface FormField {
      * Visual intent: action buttons (primary / outline); checkbox "switch" when
      * attributes.showAsSwitch is set (ZAI CheckboxField / zvolv-web nz-switch).
      */
-    variant?: "primary" | "outline" | "switch";
+    variant?: "primary" | "outline" | "switch" | "dropdown";
     /** Read-only text to show (ON_BEHALF_OF: the user's name rather than their id). */
     displayText?: string;
     /** DATE_PICKER display format from properties.format (dayjs tokens), default DD/MM/YYYY. */
@@ -1869,18 +1885,50 @@ interface ZvolvFormApi {
         response: any;
     } | null>;
     reset: () => void;
-    runAction: (field: FormField) => Promise<ActionOutcome>;
+    /**
+     * Run an action button. For ACTION_DROPDOWN pass the picked option's label
+     * (field.options) — only that action (or its cascade) runs, as in zvolv-web.
+     */
+    runAction: (field: FormField, choice?: string) => Promise<ActionOutcome>;
+    /** Re-fetch the form (and the saved submission). Used by properties.refreshForm. */
+    reload: () => void;
     /** Field ids with an action / automation in flight. */
     busy: Set<string>;
     client: any;
     /** Sheet child definitions register here so submit can post their rows. */
     registerSheet: (fieldId: string, def: FormDefinition) => void;
+    /** A registered sheet's child form (after useSheetField loaded it). */
+    sheetDefinition: (fieldId: string) => FormDefinition | undefined;
+    /** Bumps whenever a sheet definition registers — memo key for inspectors. */
+    sheetVersion: number;
 }
+/** Elements that go into the POST/PUT /api/v1/submissions body. */
+declare function submitElementsOf(elements: FormElement[]): FormElement[];
 declare const FormApiContext: React.Context<ZvolvFormApi | null>;
 /** The nearest form's api, for field components rendered inside <ZvolvForm>. */
 declare function useFormApi(): ZvolvFormApi;
 declare function useZvolvForm(args: UseZvolvFormArgs): ZvolvFormApi;
 
+/**
+ * What an "open another screen" action button wants, for the host's onAction —
+ * mirrors ZAI-Dashboard ActionButtonField:
+ *  CREATE_SUBMISSION → NEW on properties.formId
+ *  EDIT_SUBMISSION / OPEN_TASK → EDIT on the button's value (a submission / task id)
+ *  SAVE_SUBMISSION → properties.formId, EDIT when the button holds an id, else NEW,
+ *                    prefilled through properties.inputMap (source → destination elementId)
+ *  OPEN_PROJECT → the button's value is a project WID
+ * After the host saves, write the new id back with form.setValue(field.id, id).
+ */
+interface OpenFormRequest {
+    actionType: string;
+    formId?: string;
+    submissionId?: string;
+    projectId?: string;
+    mode: "NEW" | "EDIT";
+    defaultValues?: Record<string, any>;
+}
+declare function openFormRequest(field: FormField, form: Pick<ZvolvFormApi, "values">): OpenFormRequest | null;
+
 /**
  * <ZvolvForm> — renders a Zvolv form with whatever field kit the host
  * supplies. Behaviour comes from useZvolvForm; appearance comes from
@@ -2528,6 +2576,8 @@ interface FieldOptionsOptions {
     autofillExtraLabels?: boolean;
 }
 declare function useFieldOptions(form: ZvolvFormApi, field: FormField, opts?: FieldOptionsOptions): FieldOptionsState;
+/** Extensions the platform refuses (ZAI-Dashboard utils/constant BLOCKED_FILE_EXTENSIONS). */
+declare const BLOCKED_FILE_EXTENSIONS: Set<string>;
 interface FileItem {
     key: string;
     name: string;
@@ -2581,6 +2631,60 @@ interface SheetFieldState {
 }
 declare function useSheetField(form: ZvolvFormApi, field: FormField): SheetFieldState;
 
+interface TrialButton {
+    label: string;
+    icon?: string;
+    color?: string;
+    hideLabel?: boolean;
+    disabled?: boolean;
+    /** Second-level buttons shown after this response is pressed. */
+    prompts: {
+        label: string;
+        icon?: string;
+        color?: string;
+        hideLabel?: boolean;
+    }[];
+}
+interface TrialLogEntry {
+    label: string;
+    correct: boolean;
+    detail?: string;
+}
+interface TrialFieldState {
+    type: "percent" | "time" | "task";
+    /** Response buttons for the current trial (task analysis: for the current step). */
+    buttons: TrialButton[];
+    /** Set after a response with prompt buttons is pressed; pick one with prompt(). */
+    activeResponse?: string;
+    prompts: TrialButton["prompts"];
+    respond: (label: string) => void;
+    prompt: (label: string) => void;
+    cancelPrompt: () => void;
+    /** Percent correct / task analysis: undo the last trial. */
+    prev: () => void;
+    currentTrial: number;
+    maxTrials: number;
+    complete: boolean;
+    /** Share of responses labelled IND / NR / CHECK (ZAI's "correct" set), 0–100. */
+    percentCorrect: number;
+    log: TrialLogEntry[];
+    disabled: boolean;
+    timer: number;
+    formattedTimer: string;
+    running: boolean;
+    start: () => void;
+    pause: () => void;
+    reset: () => void;
+    interval: number;
+    intervalCount: number;
+    timeLimit: number;
+    steps: string[];
+    currentStep: number;
+    stepName: string;
+    chain: "forward" | "backward" | "whole";
+}
+declare function useTrialField(form: ZvolvFormApi, field: FormField): TrialFieldState;
+
 /**
  * Form definition + submission normalisation. Ported from ZAI-Dashboard
  * `formApi.ts` (normaliseForm / normaliseElement / flattenElements /
@@ -2627,6 +2731,7 @@ interface RuleOverride {
 }
 /** Does `dep` (declared on `src`) match the current values? */
 declare function ruleMatches(src: FormElement, dep: any, values: FormValues): boolean;
+declare function rulesOf(el: FormElement): any[];
 /**
  * Hidden / disabled / required overrides per target elementId. A matching rule
  * for a target wins over a non-matching one on the same aspect (Angular's
@@ -2651,6 +2756,8 @@ declare function optionFilterRules(elements: FormElement[], targetId: string): {
     masterField: string;
 }[];
 
+/** Legacy formulas reference bare labels — wrap them in {…}, longest first. */
+declare function toBraceFormula(formula: string, labels: string[]): string;
 /**
  * Evaluate `formula` with `valueOf(label)` resolving field references.
  * Returns null when the formula is invalid or the result is not finite.
@@ -2658,6 +2765,125 @@ declare function optionFilterRules(elements: FormElement[], targetId: string): {
 declare function evaluateFormula(formula: string, valueOf: (label: string) => any, labels?: string[]): any;
 /** Labels a formula depends on (for recompute triggers). */
 declare function formulaLabels(formula: string, labels?: string[]): string[];
+/**
+ * True when the platform can evaluate `formula` itself. The submission API
+ * re-evaluates INPUT_FORMULA fields and rejects a mismatch ("Evaluated value
+ * \"0\" and existing value \"8000\" … do not match"); it only resolves
+ * `{Label}` references — bare labels (`MUL(Qty, Price)`) evaluate to 0 there.
+ */
+declare function isServerSafeFormula(formula: string, labels?: string[]): boolean;
+/**
+ * Recompute every INPUT_FORMULA cell of one sheet row (references are the
+ * child form's labels). Returns a new row; other cells are untouched.
+ */
+declare function computeRowFormulas(elements: {
+    elementId: string;
+    label: string;
+    type: string;
+    attributes?: any;
+    properties?: any;
+}[], row: Record<string, any>): Record<string, any>;
+
+type RuleEffect = "show" | "hide" | "required" | "optional" | "editable" | "read-only";
+interface RuleInsight {
+    sourceId: string;
+    sourceLabel: string;
+    sourceValue: string;
+    action: string;
+    effect: RuleEffect;
+    targetId: string;
+    targetLabel: string;
+    /** What the rule waits for, in words. */
+    expected: string;
+    matched: boolean;
+    /** "triage" (properties.triage) or "dependencies". */
+    origin: "triage" | "dependencies";
+}
+interface FilterInsight {
+    targetId: string;
+    targetLabel: string;
+    sourceForm: string;
+    kind: "dependent" | "dynamic" | "static";
+    /** Label on the source form the filter is applied to. */
+    masterField: string;
+    /** The local field whose value feeds the filter (dependent / dynamic). */
+    sourceLabel?: string;
+    sourceValue?: string;
+    /** Static filters: the configured value. */
+    value?: string;
+    active: boolean;
+}
+interface ValidationInsight {
+    id: string;
+    label: string;
+    type: string;
+    /** e.g. Accessories · row 2 — for sheet cells. */
+    scope?: string;
+    required: boolean;
+    hidden: boolean;
+    checks: string[];
+    value: string;
+    /** What validateField says right now. */
+    error?: string;
+    /** What the user currently sees (set on submit, cleared on change). */
+    shownError?: string;
+}
+interface FormulaInsight {
+    fieldId: string;
+    label: string;
+    scope: "form" | "row";
+    sheetLabel?: string;
+    row?: number;
+    formula: string;
+    /** The same formula with {Label} references — what the platform understands. */
+    serverFormula: string;
+    serverSafe: boolean;
+    inputs: {
+        label: string;
+        value: any;
+    }[];
+    /** The library's result for the current inputs. */
+    expected: any;
+    /** The value that will be submitted. */
+    current: any;
+    inSync: boolean;
+}
+interface DefaultInsight {
+    id: string;
+    label: string;
+    source: string;
+    value: string;
+}
+interface PayloadInsight {
+    formId: string;
+    elements: any[];
+    sheets: {
+        fieldId: string;
+        label: string;
+        formId: string;
+        rows: any[][];
+    }[];
+}
+interface FormInspection {
+    rules: RuleInsight[];
+    filters: FilterInsight[];
+    validation: ValidationInsight[];
+    formulas: FormulaInsight[];
+    defaults: DefaultInsight[];
+    payload: PayloadInsight | null;
+    summary: {
+        rules: number;
+        matched: number;
+        filters: number;
+        activeFilters: number;
+        errors: number;
+        formulas: number;
+        formulaIssues: number;
+    };
+}
+declare function inspectForm(form: ZvolvFormApi): FormInspection;
+/** inspectForm, memoised on the form's values, definition and loaded sheets. */
+declare function useFormInspector(form: ZvolvFormApi): FormInspection;
 
 /**
  * Authoring helpers: build a platform `create_form` payload and the FORM
@@ -2841,4 +3067,4 @@ declare function formWidget(o: {
     Description: string;
 };
 
-export { ActionCardWidget, type ActionCardWidgetProps, type ActionConfig, type ActionItem, type ActionOutcome, type ActionRenderArgs, ActivityFeedWidget, type AggregationType, AreaChartWidget, type AxisConfig, 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 DateGapUnit, type DateRange, type DateRangeToken, type DateToken, type DeepPartial, DefaultField, DoughnutChartWidget, EMPTY_INTERACTIONS, type ElementSpec, EntityGalleryWidget, type FieldFilter, type FieldKind, type FieldOption, type FieldOptionsState, type FileFieldState, type FileItem, type FilterControl, type FilterOperator, type FilterPanelConfig, type FilterPanelRenderArgs, FilterPanelWidget, type FilterPanelWidgetProps, type FilterableField, FormApiContext, type FormConfig, type FormDefinition, type FormElement, type FormErrors, type FormField, FormFields, type FormKit, FormKitSlot, type FormMode, type FormSpec, type FormStatus, type FormValues, FormWidget, type FormWidgetProps, 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, 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, PREFIX_UNITS, 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 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 UploadedFile, type UseKpiContentsArgs, type UseWidgetDataArgs, type UseZvolvFormArgs, 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, aggregate, alignSummaryToSeries, applyLocalColumnFilters, applyLocalSearch, applyLocalSort, applyLocalWidgetFilters, applyPostOperations, applyRules, automationSource, buildColumnFilterClauses, buildDashFilters, buildDashboardTree, buildInitialValues, buildRemoteSort, buildSearchClause, buildSubmissionElements, buildTree, buildTriggerBody, buildWidgetFilterClauses, cascade, cdateFiltersFor, childIdsOf, cleanTitle, clearLookupCache, coerceSeriesNumbers, createMockRuntime, createSubmission, createZvolvRuntime, dashboardDefaultDateToken, dashboardFilterDefs, dateRangeFor, defaultTokens, defineConfig, defineForm, derive, describeWidgetFilter, distinctColumnValues, eid, el, evaluateFormula, fetchForm, fetchLookupOptions, fetchSubmission, field, fieldKind, fieldKindOf, fillDateGaps, filterableFields, formSource, formWidget, formatAmountValue, formatCompact, formatFieldValue, formulaLabels, getDataType, getEmptyValue, getPostOpOperandSet, getPostOpResult, gridHeight, gridWidgets, groupBy, hasActiveInteractions, interpolate, invokeTrigger, isDataSourceConfigured, isLegacyId, isLikelyTimestamp, lookupConfigOf, mergeTokens, normaliseElement, normaliseForm, normalizeWidget, operatorsForKind, optionFilterRules, parseConfig, parseDeep, pivot, renderHtmlVariables, resetQueryUser, resolveChrome, resolveChromeConfig, resolveCollectionMapping, resolveDashboardLayout, resolveDateToken, resolveDrillDown, resolveFieldType, resolveFilterMode, resolveFormWidget, resolveSeries, resolveTableMode, resolveWidget, resolveWidgetDefaults, resolveXKey, rowSubmissionIds, ruleMatches, searchPeople, serializeElementValue, statusTone, submissionIdOf, submissionToValues, taskField, taskSource, toNum, toRelational, toneColor, toneSurface, updateSubmission, uploadFile, useCollectionItems, useFieldOptions, useFileField, useFormApi, useInteractiveWidgetData, useKpiContents, useSheetField, useTableColumns, useTemplateOverride, useTemporalEvents, useTokens, useWidgetData, useWidgetInteractions, useZvolvClient, useZvolvForm, useZvolvRuntime, usesFormFramework, validateField, validateForm, when, where };
+export { ActionCardWidget, type ActionCardWidgetProps, type ActionConfig, type ActionItem, type ActionOutcome, type ActionRenderArgs, ActivityFeedWidget, 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 DateGapUnit, 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 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, 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, aggregate, alignSummaryToSeries, 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, dateRangeFor, defaultTokens, defineConfig, defineForm, derive, describeWidgetFilter, distinctColumnValues, eid, el, evaluateFormula, extractAgentFormData, fetchForm, fetchLookupOptions, fetchSubmission, field, fieldKind, fieldKindOf, fillDateGaps, filterableFields, 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, parseDeep, pivot, renderHtmlVariables, resetQueryUser, resolveChrome, resolveChromeConfig, resolveCollectionMapping, resolveDashboardLayout, resolveDateToken, resolveDrillDown, resolveFieldType, resolveFilterMode, resolveFormWidget, resolveSeries, resolveTableMode, resolveWidget, resolveWidgetDefaults, resolveXKey, rowSubmissionIds, ruleMatches, rulesOf, searchPeople, serializeElementValue, 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 };