renderer-package 1.2.32

package/dist/page/types/widget-configs.d.ts

@@ -0,0 +1,766 @@
+/** Widget config shapes aligned with page-builder-design.md §4.5 */
+export interface KeyValueParam {
+    key: string;
+    value: string;
+}
+export type JsonPrimitive = string | number | boolean | null;
+export type JsonValue = JsonPrimitive | JsonValue[] | {
+    [key: string]: JsonValue;
+};
+export interface ExternalApiAuth {
+    type?: string;
+    [key: string]: unknown;
+}
+export interface PageDataApiDefinition {
+    id: string;
+    name: string;
+    enabled: boolean;
+    baseUrl?: string;
+    path: string;
+    method: 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE';
+    queryParams?: KeyValueParam[];
+    bodyFields?: KeyValueParam[];
+    /**
+     * Declarative nested JSON request body. When present, this takes precedence over
+     * `bodyFields`. Supports context/item placeholders and `$map` / `$concat` operators.
+     */
+    bodyTemplate?: JsonValue;
+    headers?: KeyValueParam[];
+    auth?: ExternalApiAuth;
+    /** Dot path to the item array. Use `*` to flatten nested lists, e.g. `data.items.*.slots`. */
+    itemsPath?: string;
+    totalPath?: string;
+    singleItemPath?: string;
+    pagination?: {
+        pageParam: string;
+        pageSizeParam: string;
+        defaultPageSize: number;
+        searchParam?: string;
+        sortParam?: string;
+        sortOrderParam?: string;
+    };
+    staleTimeMs?: number;
+    refetchOnMount?: boolean;
+    sampleResponse?: unknown;
+}
+export interface PagePrepopulateApiConfig {
+    enabled: boolean;
+    api: PageDataApiDefinition;
+    /** Page context key -> JSON path in prepopulate API response */
+    contextMapping?: Record<string, string>;
+}
+export type ValueFormatter = {
+    type: 'none';
+} | {
+    type: 'number';
+    decimals?: number;
+} | {
+    type: 'currency';
+    currency?: string;
+} | {
+    type: 'date';
+    format?: string;
+} | {
+    type: 'percent';
+    decimals?: number;
+} | {
+    type: 'template';
+    template: string;
+};
+export interface ResponseFieldMapping {
+    target: string;
+    path: string;
+    fallback?: unknown;
+    formatter?: ValueFormatter;
+}
+export interface WidgetDataSourceConfig {
+    mode: 'api' | 'static' | 'context' | 'pageApi';
+    dataSourceRef?: string;
+    api?: PageDataApiDefinition;
+    staticData?: unknown;
+    contextPath?: string;
+    responseMapping: ResponseFieldMapping[];
+    requestBindings?: Array<{
+        param: string;
+        source: 'binding' | 'filter' | 'widget';
+        key: string;
+    }>;
+    filterGroupKey?: string;
+    /** Skip API fetch until these page-context keys are non-empty. */
+    requireContextKeys?: string[];
+    /** When set, write true/false to this page-context key as the fetch succeeds or fails. */
+    readyContextKey?: string;
+}
+export type WidgetBorderStyle = 'solid' | 'dashed';
+export interface SectionWidgetConfig {
+    heading?: string;
+    showDivider?: boolean;
+    collapsible?: boolean;
+    defaultCollapsed?: boolean;
+    showBorder?: boolean;
+    borderStyle?: WidgetBorderStyle;
+}
+export interface ColumnsWidgetConfig {
+    /** Number of columns (1–5). */
+    columns: number;
+    gap?: 'sm' | 'md' | 'lg';
+    columnWidths?: string[];
+    minHeightPercent?: 25 | 50 | 75 | 100;
+    showBorder?: boolean;
+    showColumnBorders?: boolean;
+    columnBorders?: boolean[];
+    borderStyle?: WidgetBorderStyle;
+    collapseEmptyColumns?: boolean;
+}
+export interface CardWidgetConfig {
+    title?: string;
+    subtitle?: string;
+    variant?: 'default' | 'outline' | 'elevated';
+}
+export type FormEmbedScrollBehavior = 'page' | 'contained';
+export type FormEmbedMaxHeightPercent = 25 | 50 | 75 | 100;
+export interface FormEmbedScrollConfig {
+    /** Default `page` — form grows with the page. `contained` — scroll inside the embed only. */
+    scrollBehavior?: FormEmbedScrollBehavior;
+    /** Viewport max height when `scrollBehavior` is `contained`. Default 75. */
+    maxHeightPercent?: FormEmbedMaxHeightPercent;
+    /** Draw a border around the embedded form (tab group form tabs and form embed widget). */
+    showBorder?: boolean;
+}
+export type TabGroupAlign = 'start' | 'center' | 'end' | 'stretch';
+export type TabGroupGap = 'sm' | 'md' | 'lg';
+export interface TabGroupWidgetConfig {
+    variant?: 'default' | 'pills' | 'underline';
+    /** Tab row alignment. Default `start` (left, content-width tabs). `stretch` splits equal width. */
+    align?: TabGroupAlign;
+    /** Space between tab labels. Default `lg` for underline, `md` otherwise. */
+    gap?: TabGroupGap;
+    defaultTabId?: string;
+    lazyLoad?: boolean;
+    tabs: TabGroupTabConfig[];
+}
+export interface TabGroupTabConfig extends FormEmbedScrollConfig {
+    id: string;
+    label: string;
+    icon?: string;
+    disabled?: boolean;
+    contentType: 'widgets' | 'form' | 'page';
+    formId?: string;
+    formName?: string;
+    formMode?: 'view' | 'edit' | 'fill';
+    contextFieldMapping?: Record<string, string>;
+    pageId?: string;
+    pageName?: string;
+    pageVersion?: number;
+    /** When set, tab click navigates this route (`{{scheduleId}}` from page context). */
+    href?: string;
+}
+export interface HeadingWidgetConfig {
+    text?: string;
+    level: 1 | 2 | 3 | 4;
+    align?: 'left' | 'center' | 'right';
+    variable?: string;
+    fallback?: string;
+}
+export interface TextWidgetConfig {
+    text?: string;
+    variable?: string;
+    fallback?: string;
+    preset?: 'body' | 'caption' | 'small';
+    align?: 'left' | 'center' | 'right';
+}
+export type StatCardShape = 'rectangle' | 'square' | 'circle';
+export type StatCardSize = 'sm' | 'md' | 'lg';
+export interface StatCardWidgetConfig {
+    title?: string;
+    dataSource: WidgetDataSourceConfig;
+    valueMapping: ResponseFieldMapping;
+    trendMapping?: ResponseFieldMapping;
+    icon?: string;
+    variant?: 'default' | 'success' | 'warning' | 'danger';
+    shape?: StatCardShape;
+    size?: StatCardSize;
+    layout?: 'vertical' | 'horizontal';
+    tabId?: string;
+}
+export interface StatGridStatConfig {
+    id: string;
+    title: string;
+    dataSource: WidgetDataSourceConfig;
+    valueMapping: ResponseFieldMapping;
+    trendMapping?: ResponseFieldMapping;
+    icon?: string;
+    variant?: 'default' | 'success' | 'warning' | 'danger';
+    shape?: StatCardShape;
+    size?: StatCardSize;
+}
+export interface StatGridWidgetConfig {
+    columns: 1 | 2 | 3 | 4;
+    direction?: 'vertical' | 'horizontal';
+    gap?: 'sm' | 'md' | 'lg';
+    stats: StatGridStatConfig[];
+    tabId?: string;
+}
+export interface ButtonGroupItemConfig {
+    id: string;
+    label: string;
+    variant?: 'default' | 'outline' | 'secondary' | 'ghost' | 'destructive';
+    size?: 'sm' | 'default' | 'lg';
+    action: WidgetActionConfig;
+}
+export interface ButtonGroupWidgetConfig {
+    align?: 'start' | 'center' | 'end' | 'space-between';
+    gap?: 'sm' | 'md' | 'lg';
+    wrap?: boolean;
+    buttons: ButtonGroupItemConfig[];
+    tabId?: string;
+}
+export type DataTableCellType = 'text' | 'badge' | 'boolean' | 'number';
+export type DataTableBadgeVariant = 'default' | 'secondary' | 'success' | 'destructive' | 'outline';
+export type DataTableBorderRadius = 'none' | 'sm' | 'md' | 'lg';
+export interface DataTableBorderConfig {
+    outer?: boolean;
+    horizontal?: boolean;
+    vertical?: boolean;
+    headerHorizontal?: boolean;
+    headerVertical?: boolean;
+    color?: string;
+}
+export interface DataTableAppearanceConfig {
+    borders?: DataTableBorderConfig;
+    borderRadius?: DataTableBorderRadius;
+    headerBackgroundColor?: string;
+    headerTextColor?: string;
+}
+export interface DataTableCellAppearance {
+    backgroundColor?: string;
+    textColor?: string;
+    backgroundColorMap?: Record<string, string>;
+    textColorMap?: Record<string, string>;
+    pill?: boolean;
+}
+export interface DataTableColumnConfig {
+    id: string;
+    header: string;
+    field: string;
+    sortable?: boolean;
+    width?: string;
+    align?: 'left' | 'center' | 'right';
+    formatter?: ValueFormatter;
+    cellAction?: WidgetActionConfig;
+    cellType?: DataTableCellType;
+    truncate?: boolean;
+    maxWidth?: string;
+    badgeVariant?: DataTableBadgeVariant;
+    badgeVariantMap?: Record<string, DataTableBadgeVariant>;
+    cellAppearance?: DataTableCellAppearance;
+}
+export interface DataTableToolbarConfig {
+    addButton?: {
+        label: string;
+        icon?: string;
+        action: WidgetActionConfig;
+    };
+    filter?: {
+        enabled: boolean;
+        placeholder?: string;
+        paramKey: string;
+        options: Array<{
+            label: string;
+            value: string;
+            extraQueryParams?: Array<{
+                param: string;
+                value: string;
+            }>;
+        }>;
+        defaultValue?: string;
+    };
+}
+export interface DataTableRowActionConfig {
+    id: string;
+    label: string;
+    icon?: string;
+    action: WidgetActionConfig;
+    variant?: 'default' | 'outline' | 'destructive';
+}
+export interface DataTableWidgetConfig {
+    dataSource: WidgetDataSourceConfig;
+    columns: DataTableColumnConfig[];
+    pagination?: {
+        enabled: boolean;
+        pageSize: number;
+        showSizeChanger?: boolean;
+        itemLabel?: string;
+    };
+    search?: {
+        enabled: boolean;
+        placeholder?: string;
+        searchFields?: string[];
+    };
+    filters?: {
+        filterGroupKey: string;
+    };
+    toolbar?: DataTableToolbarConfig;
+    rowSelection?: 'none' | 'single' | 'multiple';
+    rowAction?: WidgetActionConfig;
+    rowActions?: DataTableRowActionConfig[];
+    emptyMessage?: string;
+    tabId?: string;
+    appearance?: DataTableAppearanceConfig;
+}
+export interface SearchFilterWidgetConfig {
+    filterGroupKey: string;
+    placeholder?: string;
+    debounceMs?: number;
+}
+export interface FormEmbedWidgetConfig extends FormEmbedScrollConfig {
+    formId: string;
+    formName?: string;
+    mode: 'view' | 'edit' | 'fill';
+    contextFieldMapping?: Record<string, string>;
+    onSubmitAction?: WidgetActionConfig;
+}
+export interface WorkflowEmbedWidgetConfig {
+    workflowId: string;
+    workflowName?: string;
+    mode: 'tracker' | 'start' | 'approval';
+    contextVariableMapping?: Record<string, string>;
+}
+export interface ButtonWidgetConfig {
+    label: string;
+    variant?: 'default' | 'outline' | 'secondary' | 'ghost' | 'destructive';
+    size?: 'sm' | 'default' | 'lg';
+    icon?: string;
+    action: WidgetActionConfig;
+}
+export interface PageNavWidgetConfig {
+    showPrevious?: boolean;
+    showNext?: boolean;
+    showBreadcrumbs?: boolean;
+    align?: 'left' | 'center' | 'right' | 'space-between';
+    previousPage?: {
+        pageId?: string;
+        label?: string;
+    };
+    nextPage?: {
+        pageId?: string;
+        label?: string;
+    };
+}
+export interface TemporalItemFieldMap {
+    id: string;
+    title: string;
+    subtitle?: string;
+    start: string;
+    end: string;
+    date?: string;
+    column?: string;
+    color?: string;
+    locked?: string;
+}
+export interface TemporalGridColumn {
+    id: string;
+    label: string;
+    value: string | number;
+}
+export interface TimeGridWidgetConfig {
+    dataSource: WidgetDataSourceConfig;
+    fields: TemporalItemFieldMap;
+    columns: TemporalGridColumn[];
+    palette?: {
+        title?: string;
+        dataSource: WidgetDataSourceConfig;
+        fields: Pick<TemporalItemFieldMap, 'id' | 'title'> & Partial<Pick<TemporalItemFieldMap, 'subtitle' | 'color'>> & {
+            weeklyHours?: string;
+            remainingHours?: string;
+            /** Term/total hours. When set, palette cards use Total / Remaining / Scheduled. */
+            totalHours?: string;
+            scheduledHours?: string;
+        };
+        match?: {
+            itemField: string;
+            paletteField: string;
+        };
+    };
+    startHour?: number;
+    endHour?: number;
+    stepMinutes?: 15 | 30 | 60;
+    allowDrag?: boolean;
+    detectOverlap?: boolean;
+    itemTemplate?: string;
+    blockedBands?: Array<{
+        start: string;
+        end: string;
+        label?: string;
+    }>;
+    emptyMessage?: string;
+    onItemClick?: WidgetActionConfig;
+    onItemMove?: WidgetActionConfig;
+    onItemCreate?: WidgetActionConfig;
+    onItemDelete?: WidgetActionConfig;
+    onConflict?: WidgetActionConfig;
+    tabId?: string;
+}
+export interface DateTimeGridWidgetConfig extends Omit<TimeGridWidgetConfig, 'columns'> {
+    columns?: TemporalGridColumn[];
+    visibleDateCount?: number;
+    startDate?: string;
+    /** Page context key for the visible range start (e.g. `weekStart`). */
+    startDateContextKey?: string;
+    minDate?: string;
+    maxDate?: string;
+    showNavigation?: boolean;
+    dateFormat?: 'short' | 'medium' | 'long';
+    weekStartsOn?: 0 | 1;
+}
+export interface CalendarMonthWidgetConfig {
+    dataSource: WidgetDataSourceConfig;
+    fields: {
+        id: string;
+        title: string;
+        startDate: string;
+        endDate?: string;
+        color?: string;
+        subtitle?: string;
+    };
+    initialDate?: string;
+    weekStartsOn?: 0 | 1;
+    maxEventsPerDay?: number;
+    onEventClick?: WidgetActionConfig;
+    onDateClick?: WidgetActionConfig;
+    /** When set, date click writes that week's start (YYYY-MM-DD) to this context key. */
+    weekStartContextKey?: string;
+    emptyMessage?: string;
+    tabId?: string;
+}
+export interface CalendarYearLegendItem {
+    value: string;
+    label: string;
+    color: string;
+}
+export interface CalendarYearWidgetConfig {
+    dataSource: WidgetDataSourceConfig;
+    fields: {
+        id: string;
+        title: string;
+        startDate: string;
+        endDate?: string;
+        /** Row field used to pick a legend color (e.g. `type`). */
+        category?: string;
+        color?: string;
+        subtitle?: string;
+    };
+    initialDate?: string;
+    weekStartsOn?: 0 | 1;
+    minYear?: number;
+    maxYear?: number;
+    /** Page context key written by Year Stepper (default `calendarYear`). */
+    yearContextKey?: string;
+    showYearNavigation?: boolean;
+    legend?: CalendarYearLegendItem[];
+    showTodayLegend?: boolean;
+    onEventClick?: WidgetActionConfig;
+    onDateClick?: WidgetActionConfig;
+    /** When set, date click writes that week's start (YYYY-MM-DD) to this context key. */
+    weekStartContextKey?: string;
+    emptyMessage?: string;
+    tabId?: string;
+}
+export interface YearStepperWidgetConfig {
+    label?: string;
+    contextKey?: string;
+    initialYear?: number | string;
+    minYear?: number;
+    maxYear?: number;
+    showLabel?: boolean;
+    tabId?: string;
+}
+export interface WeekStepperWidgetConfig {
+    label?: string;
+    contextKey?: string;
+    stepDays?: number;
+    weekStartsOn?: 0 | 1;
+    snapToWeekStart?: boolean;
+    initialDate?: string;
+    minDate?: string;
+    maxDate?: string;
+    showLabel?: boolean;
+    showRange?: boolean;
+    tabId?: string;
+}
+/** Stacked month calendars for a date range; click a week row to write `weekStart`. */
+export interface WeekSelectorWidgetConfig {
+    title?: string;
+    helperText?: string;
+    /** Range start (YYYY-MM-DD or `{termStart}`). */
+    startDate?: string;
+    /** Range end (YYYY-MM-DD or `{termEnd}`). When empty, `monthCount` months from start. */
+    endDate?: string;
+    /** Months to show when `endDate` is empty. Default 6. */
+    monthCount?: number;
+    weekStartsOn?: 0 | 1;
+    weekStartContextKey?: string;
+    onWeekSelect?: WidgetActionConfig;
+    showTitle?: boolean;
+    tabId?: string;
+}
+export interface DatePickerWidgetConfig {
+    label?: string;
+    helperText?: string;
+    contextKey?: string;
+    initialDate?: string;
+    minDate?: string;
+    maxDate?: string;
+    weekStartsOn?: 0 | 1;
+    placeholder?: string;
+    showLabel?: boolean;
+    tabId?: string;
+}
+export type EditableMatrixEditor = 'text' | 'number' | 'select' | 'multiselect';
+/** How the column value is sent on row save. `raw` keeps the editor value. */
+export type EditableMatrixValueAs = 'raw' | 'id' | 'idArray';
+export interface EditableMatrixColumn {
+    id: string;
+    header: string;
+    field: string;
+    editor?: EditableMatrixEditor;
+    options?: Array<{
+        label: string;
+        value: string;
+    }>;
+    optionsDataSource?: WidgetDataSourceConfig;
+    optionLabelField?: string;
+    optionValueField?: string;
+    /** Row field names this column's options depend on (`topics` or `topics,subject_id`). */
+    dependsOn?: string | string[];
+    /** Default true when `dependsOn` is set: skip the options API until parents have values. */
+    waitForDependsOn?: boolean;
+    /** Default true: clear this column when a `dependsOn` field changes. */
+    clearOnDependencyChange?: boolean;
+    placeholder?: string;
+    /** Shown instead of the editor while `dependsOn` parents are empty. */
+    emptyDependsOnLabel?: string;
+    /** Shape used in the row-save payload / `{field}` placeholders. */
+    valueAs?: EditableMatrixValueAs;
+    readOnly?: boolean;
+    width?: string;
+}
+export interface EditableMatrixWidgetConfig {
+    dataSource: WidgetDataSourceConfig;
+    rowIdField: string;
+    columns: EditableMatrixColumn[];
+    readOnly?: boolean;
+    emptyMessage?: string;
+    saveButtonLabel?: string;
+    onCellChange?: WidgetActionConfig;
+    onRowSave?: WidgetActionConfig;
+    tabId?: string;
+}
+export type WidgetActionConfig = {
+    type: 'navigate';
+    href: string;
+    openIn?: 'same' | 'new';
+} | {
+    type: 'navigate_page';
+    pageId?: string;
+    pageName?: string;
+    params?: Record<string, string>;
+} | {
+    type: 'emit';
+    eventName: string;
+    payload?: Record<string, unknown>;
+} | {
+    type: 'workflow';
+    workflowId: string;
+    workflowName?: string;
+    inputMapping?: Record<string, string>;
+} | {
+    type: 'api';
+    api?: PageDataApiDefinition;
+    dataSourceRef?: string;
+    onSuccess?: WidgetActionConfig;
+} | {
+    type: 'modal';
+    formId?: string;
+    formName?: string;
+    moduleId?: string;
+    featureId?: string;
+    subFeatureId?: string;
+    pageId?: string;
+    pageName?: string;
+    title?: string;
+    contextFieldMapping?: Record<string, string>;
+} | {
+    type: 'scroll_to';
+    widgetId: string;
+} | {
+    type: 'set_filter';
+    filterGroupKey: string;
+    values: Record<string, unknown>;
+} | {
+    type: 'refresh';
+    targetWidgetIds: string[];
+} | {
+    type: 'set_context';
+    mappings: Array<{
+        contextKey: string;
+        path: string;
+    }>;
+    /** When writing an array, drop each item's `id` (draft lists from another API). */
+    omitListItemIds?: boolean;
+};
+export interface WeekCalendarEventMapping {
+    id?: string;
+    date?: string;
+    dayOfWeek?: string;
+    startTime?: string;
+    endTime?: string;
+    title?: string;
+    subtitle?: string;
+    label?: string;
+    color?: string;
+}
+export type WeekCalendarScrollBehavior = FormEmbedScrollBehavior | 'fit';
+export type WeekCalendarOrientation = 'time-rows' | 'days-rows';
+export interface WeekCalendarWidgetConfig {
+    dataSource: WidgetDataSourceConfig;
+    eventMapping?: WeekCalendarEventMapping;
+    dayStartHour?: number;
+    dayEndHour?: number;
+    showWeekNav?: boolean;
+    weekRangePosition?: 'left' | 'right';
+    navigationPosition?: 'left' | 'right';
+    navigationStyle?: 'text' | 'arrows';
+    /** Initial grid axes. `time-rows` preserves the original calendar layout. */
+    defaultOrientation?: WeekCalendarOrientation;
+    /** Allow viewers to switch axes from the calendar toolbar at runtime. */
+    showOrientationToggle?: boolean;
+    showCurrentTimeIndicator?: boolean;
+    /** Fallback event color when `eventMapping.color` resolves to nothing. */
+    defaultEventColor?: string;
+    /** Hover popup with title, subtitle, time, and label. Default off. */
+    showEventHover?: boolean;
+    /**
+     * `page` (default) — grid grows with the page. `contained` — scroll inside a fixed
+     * viewport height. `fit` — size to the space left below the grid so the page never scrolls.
+     */
+    scrollBehavior?: WeekCalendarScrollBehavior;
+    /** Viewport max height when `scrollBehavior` is `contained`. Default 75. */
+    maxHeightPercent?: FormEmbedMaxHeightPercent;
+    /** Tint the column for today. Default on. */
+    highlightCurrentDay?: boolean;
+    weekStartContextKey?: string;
+    selectedContextKey?: string;
+    selectedPayloadContextKey?: string;
+    onEventClick?: WidgetActionConfig;
+    tabId?: string;
+}
+export interface DetailCardFieldConfig {
+    id: string;
+    label: string;
+    path: string;
+    icon?: string;
+    fallback?: string;
+}
+export interface DetailCardBadgeConfig {
+    id: string;
+    path: string;
+    label?: string;
+}
+export interface DetailCardWidgetConfig {
+    dataSource: WidgetDataSourceConfig;
+    titlePath?: string;
+    subtitlePath?: string;
+    statusPath?: string;
+    badges?: DetailCardBadgeConfig[];
+    fields?: DetailCardFieldConfig[];
+    emptyTitle?: string;
+    emptyMessage?: string;
+    actions?: ButtonGroupItemConfig[];
+    tabId?: string;
+}
+export type ChartBarVariant = 'clustered_column' | 'stacked_column' | 'percent_stacked_column' | '3d_clustered_column' | '3d_stacked_column' | '3d_column' | 'clustered_bar' | 'stacked_bar' | 'percent_stacked_bar' | '3d_clustered_bar' | '3d_stacked_bar';
+export type ChartLineVariant = 'line' | 'stacked_line' | 'percent_stacked_line' | 'line_markers' | 'stacked_line_markers' | 'percent_stacked_line_markers' | '3d_line';
+export type ChartPieVariant = 'pie' | '3d_pie' | 'pie_of_pie' | 'bar_of_pie' | 'doughnut';
+export type ChartAreaVariant = 'area' | 'stacked_area' | 'percent_stacked_area' | '3d_area' | '3d_stacked_area' | '3d_percent_stacked_area';
+export type ChartComboVariant = 'clustered_column_line' | 'clustered_column_line_secondary' | 'stacked_area_clustered_column';
+export interface ChartWidgetConfigBase {
+    dataSource: WidgetDataSourceConfig;
+    title?: string;
+    height?: number;
+    showLegend?: boolean;
+    emptyMessage?: string;
+    /** Fill/stroke colors by series index (or pie slice index). */
+    colors?: string[];
+    tabId?: string;
+}
+export interface ChartCartesianWidgetConfig extends ChartWidgetConfigBase {
+    xField: ResponseFieldMapping;
+    yFields: ResponseFieldMapping[];
+}
+export interface ChartBarWidgetConfig extends ChartCartesianWidgetConfig {
+    variant?: ChartBarVariant;
+}
+export interface ChartLineWidgetConfig extends ChartCartesianWidgetConfig {
+    variant?: ChartLineVariant;
+    smooth?: boolean;
+}
+export interface ChartAreaWidgetConfig extends ChartCartesianWidgetConfig {
+    variant?: ChartAreaVariant;
+}
+export interface ChartPieWidgetConfig extends ChartWidgetConfigBase {
+    variant?: ChartPieVariant;
+    labelField: ResponseFieldMapping;
+    valueField: ResponseFieldMapping;
+    colorField?: ResponseFieldMapping;
+    secondarySliceCount?: number;
+}
+export interface ChartComboWidgetConfig extends ChartCartesianWidgetConfig {
+    variant?: ChartComboVariant;
+    lineFields?: ResponseFieldMapping[];
+    lineColor?: string;
+}
+export interface DualListFieldConfig {
+    id: string;
+    label: string;
+    path: string;
+    fallback?: string;
+}
+export interface DualListWidgetConfig {
+    dataSource: WidgetDataSourceConfig;
+    itemsPath?: string;
+    idPath?: string;
+    titlePath?: string;
+    subtitlePath?: string;
+    fields?: DualListFieldConfig[];
+    groupField?: string;
+    leftValue?: string;
+    rightValue?: string;
+    leftTitle?: string;
+    rightTitle?: string;
+    leftEmptyMessage?: string;
+    rightEmptyMessage?: string;
+    instruction?: string;
+    moveToLeftLabel?: string;
+    moveToRightLabel?: string;
+    showMoveAllLeft?: boolean;
+    showMoveAllRight?: boolean;
+    moveAllLeftLabel?: string;
+    moveAllRightLabel?: string;
+    enableDrag?: boolean;
+    /**
+     * `page` (default) — panes grow with the page. `contained` — fixed viewport height with
+     * scrolling inside each pane. `fit` — size to the space left below the widget.
+     */
+    scrollBehavior?: WeekCalendarScrollBehavior;
+    /** Viewport max height when `scrollBehavior` is `contained`. Default 50. */
+    maxHeightPercent?: FormEmbedMaxHeightPercent;
+    leftContextKey?: string;
+    rightContextKey?: string;
+    leftIdsContextKey?: string;
+    rightIdsContextKey?: string;
+    tabId?: string;
+}
+/** Union of Phase 1 widget configs plus tabId for tab_group children */
+export type PageWidgetConfig = SectionWidgetConfig | ColumnsWidgetConfig | CardWidgetConfig | TabGroupWidgetConfig | HeadingWidgetConfig | TextWidgetConfig | StatCardWidgetConfig | DataTableWidgetConfig | SearchFilterWidgetConfig | FormEmbedWidgetConfig | WorkflowEmbedWidgetConfig | ButtonWidgetConfig | ButtonGroupWidgetConfig | PageNavWidgetConfig | StatGridWidgetConfig | WeekCalendarWidgetConfig | DetailCardWidgetConfig | DualListWidgetConfig | TimeGridWidgetConfig | CalendarMonthWidgetConfig | CalendarYearWidgetConfig | YearStepperWidgetConfig | WeekStepperWidgetConfig | WeekSelectorWidgetConfig | DatePickerWidgetConfig | DateTimeGridWidgetConfig | EditableMatrixWidgetConfig | ChartBarWidgetConfig | ChartLineWidgetConfig | ChartAreaWidgetConfig | ChartPieWidgetConfig | ChartComboWidgetConfig | Record<string, unknown>;
+//# sourceMappingURL=widget-configs.d.ts.map