@adminiumjs/widgets 0.1.0-rc.1

package/dist/families/kpi/kpi-config.d.ts

@@ -0,0 +1,1700 @@
+import { z } from 'zod';
+import { INSIGHT_ICONS } from './kpi-lib.js';
+export declare const kpiStatCardConfigSchema: z.ZodObject<{
+    title: z.ZodOptional<z.ZodString>;
+    subtitle: z.ZodOptional<z.ZodString>;
+    icon: z.ZodOptional<z.ZodString>;
+    href: z.ZodOptional<z.ZodString>;
+    binding: z.ZodOptional<z.ZodObject<{
+        kind: z.ZodDefault<z.ZodLiteral<"table-query">>;
+        connectionId: z.ZodString;
+        source: z.ZodObject<{
+            schema: z.ZodOptional<z.ZodString>;
+            name: z.ZodString;
+            type: z.ZodDefault<z.ZodEnum<{
+                table: "table";
+                view: "view";
+            }>>;
+        }, z.core.$strip>;
+        shape: z.ZodEnum<{
+            "single-metric": "single-metric";
+            "metric+delta": "metric+delta";
+            timeseries: "timeseries";
+            "multi-timeseries": "multi-timeseries";
+            categorical: "categorical";
+            "record-list": "record-list";
+            record: "record";
+            matrix: "matrix";
+            "hierarchy/tree": "hierarchy/tree";
+            "calendar-events": "calendar-events";
+            "geo-points": "geo-points";
+            flows: "flows";
+            ohlc: "ohlc";
+            distribution: "distribution";
+            "boolean-map": "boolean-map";
+            stream: "stream";
+            "form-state": "form-state";
+            static: "static";
+        }>;
+        select: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        aggregations: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            fn: z.ZodEnum<{
+                count: "count";
+                sum: "sum";
+                avg: "avg";
+                min: "min";
+                max: "max";
+                count_distinct: "count_distinct";
+                percentile: "percentile";
+            }>;
+            column: z.ZodOptional<z.ZodString>;
+            p: z.ZodOptional<z.ZodNumber>;
+            alias: z.ZodString;
+        }, z.core.$strip>>>;
+        groupBy: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        bucket: z.ZodOptional<z.ZodObject<{
+            column: z.ZodString;
+            unit: z.ZodEnum<{
+                hour: "hour";
+                day: "day";
+                week: "week";
+                month: "month";
+                quarter: "quarter";
+                year: "year";
+            }>;
+        }, z.core.$strip>>;
+        filters: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            column: z.ZodString;
+            op: z.ZodEnum<{
+                eq: "eq";
+                neq: "neq";
+                gt: "gt";
+                gte: "gte";
+                lt: "lt";
+                lte: "lte";
+                in: "in";
+                like: "like";
+                ilike: "ilike";
+                is_null: "is_null";
+                not_null: "not_null";
+                between: "between";
+            }>;
+            value: z.ZodOptional<z.ZodUnknown>;
+            param: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>>;
+        window: z.ZodOptional<z.ZodObject<{
+            column: z.ZodString;
+            last: z.ZodNumber;
+            unit: z.ZodEnum<{
+                hour: "hour";
+                day: "day";
+                week: "week";
+                month: "month";
+                quarter: "quarter";
+                year: "year";
+            }>;
+            compareToPrior: z.ZodDefault<z.ZodBoolean>;
+        }, z.core.$strip>>;
+        orderBy: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            column: z.ZodString;
+            dir: z.ZodEnum<{
+                asc: "asc";
+                desc: "desc";
+            }>;
+        }, z.core.$strip>>>;
+        limit: z.ZodOptional<z.ZodNumber>;
+        cursor: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    refreshInterval: z.ZodOptional<z.ZodNumber>;
+    emptyState: z.ZodOptional<z.ZodObject<{
+        icon: z.ZodOptional<z.ZodString>;
+        titleKey: z.ZodOptional<z.ZodString>;
+        bodyKey: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    permissions: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    tone: z.ZodOptional<z.ZodEnum<{
+        accent: "accent";
+        pos: "pos";
+        warn: "warn";
+        danger: "danger";
+        info: "info";
+        muted: "muted";
+    }>>;
+    format: z.ZodOptional<z.ZodObject<{
+        locale: z.ZodOptional<z.ZodString>;
+        currency: z.ZodOptional<z.ZodString>;
+        number: z.ZodOptional<z.ZodEnum<{
+            percent: "percent";
+            plain: "plain";
+            compact: "compact";
+        }>>;
+        date: z.ZodOptional<z.ZodEnum<{
+            relative: "relative";
+            short: "short";
+            long: "long";
+        }>>;
+        referenceTime: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>;
+    testId: z.ZodOptional<z.ZodString>;
+    metricLabel: z.ZodOptional<z.ZodString>;
+    metricFormat: z.ZodDefault<z.ZodEnum<{
+        percent: "percent";
+        duration: "duration";
+        plain: "plain";
+        currency: "currency";
+        compact: "compact";
+    }>>;
+    deltaMode: z.ZodDefault<z.ZodEnum<{
+        none: "none";
+        pct: "pct";
+        abs: "abs";
+    }>>;
+    invertDeltaGood: z.ZodDefault<z.ZodBoolean>;
+    showSparkline: z.ZodDefault<z.ZodBoolean>;
+    iconName: z.ZodDefault<z.ZodEnum<{
+        zap: "zap";
+        activity: "activity";
+        dollar: "dollar";
+        users: "users";
+        cart: "cart";
+        gauge: "gauge";
+        database: "database";
+        star: "star";
+        package: "package";
+        trending: "trending";
+    }>>;
+    iconTone: z.ZodDefault<z.ZodEnum<{
+        neutral: "neutral";
+        accent: "accent";
+        pos: "pos";
+        warn: "warn";
+        danger: "danger";
+        info: "info";
+    }>>;
+}, z.core.$strip>;
+export type KpiStatCardConfig = z.infer<typeof kpiStatCardConfigSchema>;
+/** Deterministic `metric+delta` demo payload (04 §7.7). */
+export declare function kpiStatCardDemoData(seed: number): {
+    value: number;
+    prior: number;
+    spark: number[];
+};
+export declare const usageMeterConfigSchema: z.ZodObject<{
+    title: z.ZodOptional<z.ZodString>;
+    subtitle: z.ZodOptional<z.ZodString>;
+    icon: z.ZodOptional<z.ZodString>;
+    href: z.ZodOptional<z.ZodString>;
+    binding: z.ZodOptional<z.ZodObject<{
+        kind: z.ZodDefault<z.ZodLiteral<"table-query">>;
+        connectionId: z.ZodString;
+        source: z.ZodObject<{
+            schema: z.ZodOptional<z.ZodString>;
+            name: z.ZodString;
+            type: z.ZodDefault<z.ZodEnum<{
+                table: "table";
+                view: "view";
+            }>>;
+        }, z.core.$strip>;
+        shape: z.ZodEnum<{
+            "single-metric": "single-metric";
+            "metric+delta": "metric+delta";
+            timeseries: "timeseries";
+            "multi-timeseries": "multi-timeseries";
+            categorical: "categorical";
+            "record-list": "record-list";
+            record: "record";
+            matrix: "matrix";
+            "hierarchy/tree": "hierarchy/tree";
+            "calendar-events": "calendar-events";
+            "geo-points": "geo-points";
+            flows: "flows";
+            ohlc: "ohlc";
+            distribution: "distribution";
+            "boolean-map": "boolean-map";
+            stream: "stream";
+            "form-state": "form-state";
+            static: "static";
+        }>;
+        select: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        aggregations: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            fn: z.ZodEnum<{
+                count: "count";
+                sum: "sum";
+                avg: "avg";
+                min: "min";
+                max: "max";
+                count_distinct: "count_distinct";
+                percentile: "percentile";
+            }>;
+            column: z.ZodOptional<z.ZodString>;
+            p: z.ZodOptional<z.ZodNumber>;
+            alias: z.ZodString;
+        }, z.core.$strip>>>;
+        groupBy: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        bucket: z.ZodOptional<z.ZodObject<{
+            column: z.ZodString;
+            unit: z.ZodEnum<{
+                hour: "hour";
+                day: "day";
+                week: "week";
+                month: "month";
+                quarter: "quarter";
+                year: "year";
+            }>;
+        }, z.core.$strip>>;
+        filters: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            column: z.ZodString;
+            op: z.ZodEnum<{
+                eq: "eq";
+                neq: "neq";
+                gt: "gt";
+                gte: "gte";
+                lt: "lt";
+                lte: "lte";
+                in: "in";
+                like: "like";
+                ilike: "ilike";
+                is_null: "is_null";
+                not_null: "not_null";
+                between: "between";
+            }>;
+            value: z.ZodOptional<z.ZodUnknown>;
+            param: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>>;
+        window: z.ZodOptional<z.ZodObject<{
+            column: z.ZodString;
+            last: z.ZodNumber;
+            unit: z.ZodEnum<{
+                hour: "hour";
+                day: "day";
+                week: "week";
+                month: "month";
+                quarter: "quarter";
+                year: "year";
+            }>;
+            compareToPrior: z.ZodDefault<z.ZodBoolean>;
+        }, z.core.$strip>>;
+        orderBy: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            column: z.ZodString;
+            dir: z.ZodEnum<{
+                asc: "asc";
+                desc: "desc";
+            }>;
+        }, z.core.$strip>>>;
+        limit: z.ZodOptional<z.ZodNumber>;
+        cursor: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    refreshInterval: z.ZodOptional<z.ZodNumber>;
+    emptyState: z.ZodOptional<z.ZodObject<{
+        icon: z.ZodOptional<z.ZodString>;
+        titleKey: z.ZodOptional<z.ZodString>;
+        bodyKey: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    permissions: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    tone: z.ZodOptional<z.ZodEnum<{
+        accent: "accent";
+        pos: "pos";
+        warn: "warn";
+        danger: "danger";
+        info: "info";
+        muted: "muted";
+    }>>;
+    format: z.ZodOptional<z.ZodObject<{
+        locale: z.ZodOptional<z.ZodString>;
+        currency: z.ZodOptional<z.ZodString>;
+        number: z.ZodOptional<z.ZodEnum<{
+            percent: "percent";
+            plain: "plain";
+            compact: "compact";
+        }>>;
+        date: z.ZodOptional<z.ZodEnum<{
+            relative: "relative";
+            short: "short";
+            long: "long";
+        }>>;
+        referenceTime: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>;
+    testId: z.ZodOptional<z.ZodString>;
+    limit: z.ZodDefault<z.ZodNumber>;
+    warnThreshold: z.ZodDefault<z.ZodNumber>;
+    dangerThreshold: z.ZodDefault<z.ZodNumber>;
+    unit: z.ZodOptional<z.ZodString>;
+    ctaLabel: z.ZodOptional<z.ZodString>;
+    ctaHref: z.ZodOptional<z.ZodString>;
+    compact: z.ZodDefault<z.ZodBoolean>;
+}, z.core.$strip>;
+export type UsageMeterConfig = z.infer<typeof usageMeterConfigSchema>;
+/** Deterministic `single-metric` demo payload against the default limit of 100. */
+export declare function usageMeterDemoData(seed: number): {
+    value: number;
+};
+export declare const kpiStatTileCompactConfigSchema: z.ZodObject<{
+    title: z.ZodOptional<z.ZodString>;
+    subtitle: z.ZodOptional<z.ZodString>;
+    icon: z.ZodOptional<z.ZodString>;
+    href: z.ZodOptional<z.ZodString>;
+    binding: z.ZodOptional<z.ZodObject<{
+        kind: z.ZodDefault<z.ZodLiteral<"table-query">>;
+        connectionId: z.ZodString;
+        source: z.ZodObject<{
+            schema: z.ZodOptional<z.ZodString>;
+            name: z.ZodString;
+            type: z.ZodDefault<z.ZodEnum<{
+                table: "table";
+                view: "view";
+            }>>;
+        }, z.core.$strip>;
+        shape: z.ZodEnum<{
+            "single-metric": "single-metric";
+            "metric+delta": "metric+delta";
+            timeseries: "timeseries";
+            "multi-timeseries": "multi-timeseries";
+            categorical: "categorical";
+            "record-list": "record-list";
+            record: "record";
+            matrix: "matrix";
+            "hierarchy/tree": "hierarchy/tree";
+            "calendar-events": "calendar-events";
+            "geo-points": "geo-points";
+            flows: "flows";
+            ohlc: "ohlc";
+            distribution: "distribution";
+            "boolean-map": "boolean-map";
+            stream: "stream";
+            "form-state": "form-state";
+            static: "static";
+        }>;
+        select: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        aggregations: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            fn: z.ZodEnum<{
+                count: "count";
+                sum: "sum";
+                avg: "avg";
+                min: "min";
+                max: "max";
+                count_distinct: "count_distinct";
+                percentile: "percentile";
+            }>;
+            column: z.ZodOptional<z.ZodString>;
+            p: z.ZodOptional<z.ZodNumber>;
+            alias: z.ZodString;
+        }, z.core.$strip>>>;
+        groupBy: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        bucket: z.ZodOptional<z.ZodObject<{
+            column: z.ZodString;
+            unit: z.ZodEnum<{
+                hour: "hour";
+                day: "day";
+                week: "week";
+                month: "month";
+                quarter: "quarter";
+                year: "year";
+            }>;
+        }, z.core.$strip>>;
+        filters: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            column: z.ZodString;
+            op: z.ZodEnum<{
+                eq: "eq";
+                neq: "neq";
+                gt: "gt";
+                gte: "gte";
+                lt: "lt";
+                lte: "lte";
+                in: "in";
+                like: "like";
+                ilike: "ilike";
+                is_null: "is_null";
+                not_null: "not_null";
+                between: "between";
+            }>;
+            value: z.ZodOptional<z.ZodUnknown>;
+            param: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>>;
+        window: z.ZodOptional<z.ZodObject<{
+            column: z.ZodString;
+            last: z.ZodNumber;
+            unit: z.ZodEnum<{
+                hour: "hour";
+                day: "day";
+                week: "week";
+                month: "month";
+                quarter: "quarter";
+                year: "year";
+            }>;
+            compareToPrior: z.ZodDefault<z.ZodBoolean>;
+        }, z.core.$strip>>;
+        orderBy: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            column: z.ZodString;
+            dir: z.ZodEnum<{
+                asc: "asc";
+                desc: "desc";
+            }>;
+        }, z.core.$strip>>>;
+        limit: z.ZodOptional<z.ZodNumber>;
+        cursor: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    refreshInterval: z.ZodOptional<z.ZodNumber>;
+    emptyState: z.ZodOptional<z.ZodObject<{
+        icon: z.ZodOptional<z.ZodString>;
+        titleKey: z.ZodOptional<z.ZodString>;
+        bodyKey: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    permissions: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    tone: z.ZodOptional<z.ZodEnum<{
+        accent: "accent";
+        pos: "pos";
+        warn: "warn";
+        danger: "danger";
+        info: "info";
+        muted: "muted";
+    }>>;
+    format: z.ZodOptional<z.ZodObject<{
+        locale: z.ZodOptional<z.ZodString>;
+        currency: z.ZodOptional<z.ZodString>;
+        number: z.ZodOptional<z.ZodEnum<{
+            percent: "percent";
+            plain: "plain";
+            compact: "compact";
+        }>>;
+        date: z.ZodOptional<z.ZodEnum<{
+            relative: "relative";
+            short: "short";
+            long: "long";
+        }>>;
+        referenceTime: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>;
+    testId: z.ZodOptional<z.ZodString>;
+    metricLabel: z.ZodOptional<z.ZodString>;
+    metricFormat: z.ZodDefault<z.ZodEnum<{
+        percent: "percent";
+        duration: "duration";
+        plain: "plain";
+        currency: "currency";
+        compact: "compact";
+    }>>;
+    deltaMode: z.ZodDefault<z.ZodEnum<{
+        none: "none";
+        pct: "pct";
+        abs: "abs";
+    }>>;
+    invertDeltaGood: z.ZodDefault<z.ZodBoolean>;
+    showSparkline: z.ZodDefault<z.ZodBoolean>;
+    columns: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strip>;
+export type KpiStatTileCompactConfig = z.infer<typeof kpiStatTileCompactConfigSchema>;
+/** Deterministic `metric+delta` (+ `timeseries[6]`) demo payload (04 §7.7). */
+export declare function kpiStatTileCompactDemoData(seed: number): {
+    value: number;
+    prior: number;
+    spark: number[];
+};
+export declare const metricHeroConfigSchema: z.ZodObject<{
+    title: z.ZodOptional<z.ZodString>;
+    subtitle: z.ZodOptional<z.ZodString>;
+    icon: z.ZodOptional<z.ZodString>;
+    href: z.ZodOptional<z.ZodString>;
+    binding: z.ZodOptional<z.ZodObject<{
+        kind: z.ZodDefault<z.ZodLiteral<"table-query">>;
+        connectionId: z.ZodString;
+        source: z.ZodObject<{
+            schema: z.ZodOptional<z.ZodString>;
+            name: z.ZodString;
+            type: z.ZodDefault<z.ZodEnum<{
+                table: "table";
+                view: "view";
+            }>>;
+        }, z.core.$strip>;
+        shape: z.ZodEnum<{
+            "single-metric": "single-metric";
+            "metric+delta": "metric+delta";
+            timeseries: "timeseries";
+            "multi-timeseries": "multi-timeseries";
+            categorical: "categorical";
+            "record-list": "record-list";
+            record: "record";
+            matrix: "matrix";
+            "hierarchy/tree": "hierarchy/tree";
+            "calendar-events": "calendar-events";
+            "geo-points": "geo-points";
+            flows: "flows";
+            ohlc: "ohlc";
+            distribution: "distribution";
+            "boolean-map": "boolean-map";
+            stream: "stream";
+            "form-state": "form-state";
+            static: "static";
+        }>;
+        select: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        aggregations: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            fn: z.ZodEnum<{
+                count: "count";
+                sum: "sum";
+                avg: "avg";
+                min: "min";
+                max: "max";
+                count_distinct: "count_distinct";
+                percentile: "percentile";
+            }>;
+            column: z.ZodOptional<z.ZodString>;
+            p: z.ZodOptional<z.ZodNumber>;
+            alias: z.ZodString;
+        }, z.core.$strip>>>;
+        groupBy: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        bucket: z.ZodOptional<z.ZodObject<{
+            column: z.ZodString;
+            unit: z.ZodEnum<{
+                hour: "hour";
+                day: "day";
+                week: "week";
+                month: "month";
+                quarter: "quarter";
+                year: "year";
+            }>;
+        }, z.core.$strip>>;
+        filters: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            column: z.ZodString;
+            op: z.ZodEnum<{
+                eq: "eq";
+                neq: "neq";
+                gt: "gt";
+                gte: "gte";
+                lt: "lt";
+                lte: "lte";
+                in: "in";
+                like: "like";
+                ilike: "ilike";
+                is_null: "is_null";
+                not_null: "not_null";
+                between: "between";
+            }>;
+            value: z.ZodOptional<z.ZodUnknown>;
+            param: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>>;
+        window: z.ZodOptional<z.ZodObject<{
+            column: z.ZodString;
+            last: z.ZodNumber;
+            unit: z.ZodEnum<{
+                hour: "hour";
+                day: "day";
+                week: "week";
+                month: "month";
+                quarter: "quarter";
+                year: "year";
+            }>;
+            compareToPrior: z.ZodDefault<z.ZodBoolean>;
+        }, z.core.$strip>>;
+        orderBy: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            column: z.ZodString;
+            dir: z.ZodEnum<{
+                asc: "asc";
+                desc: "desc";
+            }>;
+        }, z.core.$strip>>>;
+        limit: z.ZodOptional<z.ZodNumber>;
+        cursor: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    refreshInterval: z.ZodOptional<z.ZodNumber>;
+    emptyState: z.ZodOptional<z.ZodObject<{
+        icon: z.ZodOptional<z.ZodString>;
+        titleKey: z.ZodOptional<z.ZodString>;
+        bodyKey: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    permissions: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    tone: z.ZodOptional<z.ZodEnum<{
+        accent: "accent";
+        pos: "pos";
+        warn: "warn";
+        danger: "danger";
+        info: "info";
+        muted: "muted";
+    }>>;
+    format: z.ZodOptional<z.ZodObject<{
+        locale: z.ZodOptional<z.ZodString>;
+        currency: z.ZodOptional<z.ZodString>;
+        number: z.ZodOptional<z.ZodEnum<{
+            percent: "percent";
+            plain: "plain";
+            compact: "compact";
+        }>>;
+        date: z.ZodOptional<z.ZodEnum<{
+            relative: "relative";
+            short: "short";
+            long: "long";
+        }>>;
+        referenceTime: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>;
+    testId: z.ZodOptional<z.ZodString>;
+    metricLabel: z.ZodOptional<z.ZodString>;
+    metricFormat: z.ZodDefault<z.ZodEnum<{
+        percent: "percent";
+        duration: "duration";
+        plain: "plain";
+        currency: "currency";
+        compact: "compact";
+    }>>;
+    deltaMode: z.ZodDefault<z.ZodEnum<{
+        none: "none";
+        pct: "pct";
+        abs: "abs";
+    }>>;
+    invertDeltaGood: z.ZodDefault<z.ZodBoolean>;
+    goalValue: z.ZodOptional<z.ZodNumber>;
+    goalLabel: z.ZodOptional<z.ZodString>;
+    countUp: z.ZodDefault<z.ZodBoolean>;
+    sparkBars: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strip>;
+export type MetricHeroConfig = z.infer<typeof metricHeroConfigSchema>;
+/** Deterministic `metric+delta` + `timeseries` + goal demo payload (04 §7.7). */
+export declare function metricHeroDemoData(seed: number): {
+    value: number;
+    prior: number;
+    spark: number[];
+    goal: number;
+};
+export declare const statPairCardConfigSchema: z.ZodObject<{
+    title: z.ZodOptional<z.ZodString>;
+    subtitle: z.ZodOptional<z.ZodString>;
+    icon: z.ZodOptional<z.ZodString>;
+    href: z.ZodOptional<z.ZodString>;
+    binding: z.ZodOptional<z.ZodObject<{
+        kind: z.ZodDefault<z.ZodLiteral<"table-query">>;
+        connectionId: z.ZodString;
+        source: z.ZodObject<{
+            schema: z.ZodOptional<z.ZodString>;
+            name: z.ZodString;
+            type: z.ZodDefault<z.ZodEnum<{
+                table: "table";
+                view: "view";
+            }>>;
+        }, z.core.$strip>;
+        shape: z.ZodEnum<{
+            "single-metric": "single-metric";
+            "metric+delta": "metric+delta";
+            timeseries: "timeseries";
+            "multi-timeseries": "multi-timeseries";
+            categorical: "categorical";
+            "record-list": "record-list";
+            record: "record";
+            matrix: "matrix";
+            "hierarchy/tree": "hierarchy/tree";
+            "calendar-events": "calendar-events";
+            "geo-points": "geo-points";
+            flows: "flows";
+            ohlc: "ohlc";
+            distribution: "distribution";
+            "boolean-map": "boolean-map";
+            stream: "stream";
+            "form-state": "form-state";
+            static: "static";
+        }>;
+        select: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        aggregations: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            fn: z.ZodEnum<{
+                count: "count";
+                sum: "sum";
+                avg: "avg";
+                min: "min";
+                max: "max";
+                count_distinct: "count_distinct";
+                percentile: "percentile";
+            }>;
+            column: z.ZodOptional<z.ZodString>;
+            p: z.ZodOptional<z.ZodNumber>;
+            alias: z.ZodString;
+        }, z.core.$strip>>>;
+        groupBy: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        bucket: z.ZodOptional<z.ZodObject<{
+            column: z.ZodString;
+            unit: z.ZodEnum<{
+                hour: "hour";
+                day: "day";
+                week: "week";
+                month: "month";
+                quarter: "quarter";
+                year: "year";
+            }>;
+        }, z.core.$strip>>;
+        filters: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            column: z.ZodString;
+            op: z.ZodEnum<{
+                eq: "eq";
+                neq: "neq";
+                gt: "gt";
+                gte: "gte";
+                lt: "lt";
+                lte: "lte";
+                in: "in";
+                like: "like";
+                ilike: "ilike";
+                is_null: "is_null";
+                not_null: "not_null";
+                between: "between";
+            }>;
+            value: z.ZodOptional<z.ZodUnknown>;
+            param: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>>;
+        window: z.ZodOptional<z.ZodObject<{
+            column: z.ZodString;
+            last: z.ZodNumber;
+            unit: z.ZodEnum<{
+                hour: "hour";
+                day: "day";
+                week: "week";
+                month: "month";
+                quarter: "quarter";
+                year: "year";
+            }>;
+            compareToPrior: z.ZodDefault<z.ZodBoolean>;
+        }, z.core.$strip>>;
+        orderBy: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            column: z.ZodString;
+            dir: z.ZodEnum<{
+                asc: "asc";
+                desc: "desc";
+            }>;
+        }, z.core.$strip>>>;
+        limit: z.ZodOptional<z.ZodNumber>;
+        cursor: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    refreshInterval: z.ZodOptional<z.ZodNumber>;
+    emptyState: z.ZodOptional<z.ZodObject<{
+        icon: z.ZodOptional<z.ZodString>;
+        titleKey: z.ZodOptional<z.ZodString>;
+        bodyKey: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    permissions: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    tone: z.ZodOptional<z.ZodEnum<{
+        accent: "accent";
+        pos: "pos";
+        warn: "warn";
+        danger: "danger";
+        info: "info";
+        muted: "muted";
+    }>>;
+    format: z.ZodOptional<z.ZodObject<{
+        locale: z.ZodOptional<z.ZodString>;
+        currency: z.ZodOptional<z.ZodString>;
+        number: z.ZodOptional<z.ZodEnum<{
+            percent: "percent";
+            plain: "plain";
+            compact: "compact";
+        }>>;
+        date: z.ZodOptional<z.ZodEnum<{
+            relative: "relative";
+            short: "short";
+            long: "long";
+        }>>;
+        referenceTime: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>;
+    testId: z.ZodOptional<z.ZodString>;
+    metricALabel: z.ZodOptional<z.ZodString>;
+    metricBLabel: z.ZodOptional<z.ZodString>;
+    metricAFormat: z.ZodDefault<z.ZodEnum<{
+        percent: "percent";
+        duration: "duration";
+        plain: "plain";
+        currency: "currency";
+        compact: "compact";
+    }>>;
+    metricBFormat: z.ZodDefault<z.ZodEnum<{
+        percent: "percent";
+        duration: "duration";
+        plain: "plain";
+        currency: "currency";
+        compact: "compact";
+    }>>;
+    derivedFormula: z.ZodDefault<z.ZodEnum<{
+        none: "none";
+        add: "add";
+        subtract: "subtract";
+        multiply: "multiply";
+        divide: "divide";
+    }>>;
+    derivedOperand: z.ZodDefault<z.ZodNumber>;
+    valueAField: z.ZodDefault<z.ZodString>;
+    valueBField: z.ZodDefault<z.ZodString>;
+}, z.core.$strip>;
+export type StatPairCardConfig = z.infer<typeof statPairCardConfigSchema>;
+/** Deterministic two-`single-metric` demo payload (04 §7.7). */
+export declare function statPairCardDemoData(seed: number): {
+    value: number;
+    valueB: number;
+};
+/**
+ * One qualitative gauge band (annex §1 `bands` [{to, color, label}]). `tone`
+ * names a semantic token rather than a colour so bands re-theme with the app
+ * (research/widget-registry.md Conventions: "CSS variables only").
+ */
+export declare const gaugeBandSchema: z.ZodObject<{
+    to: z.ZodNumber;
+    tone: z.ZodEnum<{
+        neutral: "neutral";
+        accent: "accent";
+        pos: "pos";
+        warn: "warn";
+        danger: "danger";
+        info: "info";
+    }>;
+    label: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type GaugeBandConfig = z.infer<typeof gaugeBandSchema>;
+export declare const gaugeRingConfigSchema: z.ZodObject<{
+    title: z.ZodOptional<z.ZodString>;
+    subtitle: z.ZodOptional<z.ZodString>;
+    icon: z.ZodOptional<z.ZodString>;
+    href: z.ZodOptional<z.ZodString>;
+    binding: z.ZodOptional<z.ZodObject<{
+        kind: z.ZodDefault<z.ZodLiteral<"table-query">>;
+        connectionId: z.ZodString;
+        source: z.ZodObject<{
+            schema: z.ZodOptional<z.ZodString>;
+            name: z.ZodString;
+            type: z.ZodDefault<z.ZodEnum<{
+                table: "table";
+                view: "view";
+            }>>;
+        }, z.core.$strip>;
+        shape: z.ZodEnum<{
+            "single-metric": "single-metric";
+            "metric+delta": "metric+delta";
+            timeseries: "timeseries";
+            "multi-timeseries": "multi-timeseries";
+            categorical: "categorical";
+            "record-list": "record-list";
+            record: "record";
+            matrix: "matrix";
+            "hierarchy/tree": "hierarchy/tree";
+            "calendar-events": "calendar-events";
+            "geo-points": "geo-points";
+            flows: "flows";
+            ohlc: "ohlc";
+            distribution: "distribution";
+            "boolean-map": "boolean-map";
+            stream: "stream";
+            "form-state": "form-state";
+            static: "static";
+        }>;
+        select: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        aggregations: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            fn: z.ZodEnum<{
+                count: "count";
+                sum: "sum";
+                avg: "avg";
+                min: "min";
+                max: "max";
+                count_distinct: "count_distinct";
+                percentile: "percentile";
+            }>;
+            column: z.ZodOptional<z.ZodString>;
+            p: z.ZodOptional<z.ZodNumber>;
+            alias: z.ZodString;
+        }, z.core.$strip>>>;
+        groupBy: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        bucket: z.ZodOptional<z.ZodObject<{
+            column: z.ZodString;
+            unit: z.ZodEnum<{
+                hour: "hour";
+                day: "day";
+                week: "week";
+                month: "month";
+                quarter: "quarter";
+                year: "year";
+            }>;
+        }, z.core.$strip>>;
+        filters: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            column: z.ZodString;
+            op: z.ZodEnum<{
+                eq: "eq";
+                neq: "neq";
+                gt: "gt";
+                gte: "gte";
+                lt: "lt";
+                lte: "lte";
+                in: "in";
+                like: "like";
+                ilike: "ilike";
+                is_null: "is_null";
+                not_null: "not_null";
+                between: "between";
+            }>;
+            value: z.ZodOptional<z.ZodUnknown>;
+            param: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>>;
+        window: z.ZodOptional<z.ZodObject<{
+            column: z.ZodString;
+            last: z.ZodNumber;
+            unit: z.ZodEnum<{
+                hour: "hour";
+                day: "day";
+                week: "week";
+                month: "month";
+                quarter: "quarter";
+                year: "year";
+            }>;
+            compareToPrior: z.ZodDefault<z.ZodBoolean>;
+        }, z.core.$strip>>;
+        orderBy: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            column: z.ZodString;
+            dir: z.ZodEnum<{
+                asc: "asc";
+                desc: "desc";
+            }>;
+        }, z.core.$strip>>>;
+        limit: z.ZodOptional<z.ZodNumber>;
+        cursor: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    refreshInterval: z.ZodOptional<z.ZodNumber>;
+    emptyState: z.ZodOptional<z.ZodObject<{
+        icon: z.ZodOptional<z.ZodString>;
+        titleKey: z.ZodOptional<z.ZodString>;
+        bodyKey: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    permissions: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    tone: z.ZodOptional<z.ZodEnum<{
+        accent: "accent";
+        pos: "pos";
+        warn: "warn";
+        danger: "danger";
+        info: "info";
+        muted: "muted";
+    }>>;
+    format: z.ZodOptional<z.ZodObject<{
+        locale: z.ZodOptional<z.ZodString>;
+        currency: z.ZodOptional<z.ZodString>;
+        number: z.ZodOptional<z.ZodEnum<{
+            percent: "percent";
+            plain: "plain";
+            compact: "compact";
+        }>>;
+        date: z.ZodOptional<z.ZodEnum<{
+            relative: "relative";
+            short: "short";
+            long: "long";
+        }>>;
+        referenceTime: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>;
+    testId: z.ZodOptional<z.ZodString>;
+    max: z.ZodDefault<z.ZodNumber>;
+    bands: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        to: z.ZodNumber;
+        tone: z.ZodEnum<{
+            neutral: "neutral";
+            accent: "accent";
+            pos: "pos";
+            warn: "warn";
+            danger: "danger";
+            info: "info";
+        }>;
+        label: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>;
+    centerFormat: z.ZodDefault<z.ZodEnum<{
+        value: "value";
+        percent: "percent";
+        fraction: "fraction";
+    }>>;
+    footer: z.ZodDefault<z.ZodEnum<{
+        none: "none";
+        "spent-of-total": "spent-of-total";
+        "avatar-stack": "avatar-stack";
+    }>>;
+    size: z.ZodDefault<z.ZodEnum<{
+        sm: "sm";
+        md: "md";
+        lg: "lg";
+    }>>;
+    metricFormat: z.ZodDefault<z.ZodEnum<{
+        percent: "percent";
+        duration: "duration";
+        plain: "plain";
+        currency: "currency";
+        compact: "compact";
+    }>>;
+    deltaMode: z.ZodDefault<z.ZodEnum<{
+        none: "none";
+        pct: "pct";
+        abs: "abs";
+    }>>;
+    invertDeltaGood: z.ZodDefault<z.ZodBoolean>;
+    caption: z.ZodOptional<z.ZodString>;
+    spentLabel: z.ZodOptional<z.ZodString>;
+    totalLabel: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type GaugeRingConfig = z.infer<typeof gaugeRingConfigSchema>;
+/**
+ * Deterministic `single-metric` demo payload (04 §7.7) carrying the optional
+ * numerator/denominator + delta + avatar stack the annex's footer variants read.
+ */
+export declare function gaugeRingDemoData(seed: number): {
+    value: number;
+    total: number;
+    prior: number;
+    avatars: string[];
+};
+export declare const gaugeArcConfigSchema: z.ZodObject<{
+    title: z.ZodOptional<z.ZodString>;
+    subtitle: z.ZodOptional<z.ZodString>;
+    icon: z.ZodOptional<z.ZodString>;
+    href: z.ZodOptional<z.ZodString>;
+    binding: z.ZodOptional<z.ZodObject<{
+        kind: z.ZodDefault<z.ZodLiteral<"table-query">>;
+        connectionId: z.ZodString;
+        source: z.ZodObject<{
+            schema: z.ZodOptional<z.ZodString>;
+            name: z.ZodString;
+            type: z.ZodDefault<z.ZodEnum<{
+                table: "table";
+                view: "view";
+            }>>;
+        }, z.core.$strip>;
+        shape: z.ZodEnum<{
+            "single-metric": "single-metric";
+            "metric+delta": "metric+delta";
+            timeseries: "timeseries";
+            "multi-timeseries": "multi-timeseries";
+            categorical: "categorical";
+            "record-list": "record-list";
+            record: "record";
+            matrix: "matrix";
+            "hierarchy/tree": "hierarchy/tree";
+            "calendar-events": "calendar-events";
+            "geo-points": "geo-points";
+            flows: "flows";
+            ohlc: "ohlc";
+            distribution: "distribution";
+            "boolean-map": "boolean-map";
+            stream: "stream";
+            "form-state": "form-state";
+            static: "static";
+        }>;
+        select: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        aggregations: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            fn: z.ZodEnum<{
+                count: "count";
+                sum: "sum";
+                avg: "avg";
+                min: "min";
+                max: "max";
+                count_distinct: "count_distinct";
+                percentile: "percentile";
+            }>;
+            column: z.ZodOptional<z.ZodString>;
+            p: z.ZodOptional<z.ZodNumber>;
+            alias: z.ZodString;
+        }, z.core.$strip>>>;
+        groupBy: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        bucket: z.ZodOptional<z.ZodObject<{
+            column: z.ZodString;
+            unit: z.ZodEnum<{
+                hour: "hour";
+                day: "day";
+                week: "week";
+                month: "month";
+                quarter: "quarter";
+                year: "year";
+            }>;
+        }, z.core.$strip>>;
+        filters: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            column: z.ZodString;
+            op: z.ZodEnum<{
+                eq: "eq";
+                neq: "neq";
+                gt: "gt";
+                gte: "gte";
+                lt: "lt";
+                lte: "lte";
+                in: "in";
+                like: "like";
+                ilike: "ilike";
+                is_null: "is_null";
+                not_null: "not_null";
+                between: "between";
+            }>;
+            value: z.ZodOptional<z.ZodUnknown>;
+            param: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>>;
+        window: z.ZodOptional<z.ZodObject<{
+            column: z.ZodString;
+            last: z.ZodNumber;
+            unit: z.ZodEnum<{
+                hour: "hour";
+                day: "day";
+                week: "week";
+                month: "month";
+                quarter: "quarter";
+                year: "year";
+            }>;
+            compareToPrior: z.ZodDefault<z.ZodBoolean>;
+        }, z.core.$strip>>;
+        orderBy: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            column: z.ZodString;
+            dir: z.ZodEnum<{
+                asc: "asc";
+                desc: "desc";
+            }>;
+        }, z.core.$strip>>>;
+        limit: z.ZodOptional<z.ZodNumber>;
+        cursor: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    refreshInterval: z.ZodOptional<z.ZodNumber>;
+    emptyState: z.ZodOptional<z.ZodObject<{
+        icon: z.ZodOptional<z.ZodString>;
+        titleKey: z.ZodOptional<z.ZodString>;
+        bodyKey: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    permissions: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    tone: z.ZodOptional<z.ZodEnum<{
+        accent: "accent";
+        pos: "pos";
+        warn: "warn";
+        danger: "danger";
+        info: "info";
+        muted: "muted";
+    }>>;
+    format: z.ZodOptional<z.ZodObject<{
+        locale: z.ZodOptional<z.ZodString>;
+        currency: z.ZodOptional<z.ZodString>;
+        number: z.ZodOptional<z.ZodEnum<{
+            percent: "percent";
+            plain: "plain";
+            compact: "compact";
+        }>>;
+        date: z.ZodOptional<z.ZodEnum<{
+            relative: "relative";
+            short: "short";
+            long: "long";
+        }>>;
+        referenceTime: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>;
+    testId: z.ZodOptional<z.ZodString>;
+    max: z.ZodDefault<z.ZodNumber>;
+    bands: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        to: z.ZodNumber;
+        tone: z.ZodEnum<{
+            neutral: "neutral";
+            accent: "accent";
+            pos: "pos";
+            warn: "warn";
+            danger: "danger";
+            info: "info";
+        }>;
+        label: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>;
+    cluster: z.ZodDefault<z.ZodBoolean>;
+    columns: z.ZodDefault<z.ZodNumber>;
+    needle: z.ZodDefault<z.ZodBoolean>;
+    valueFormat: z.ZodDefault<z.ZodEnum<{
+        percent: "percent";
+        duration: "duration";
+        plain: "plain";
+        currency: "currency";
+        compact: "compact";
+    }>>;
+    unit: z.ZodOptional<z.ZodString>;
+    emptyTitle: z.ZodOptional<z.ZodString>;
+    emptyBody: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type GaugeArcConfig = z.infer<typeof gaugeArcConfigSchema>;
+/**
+ * Deterministic demo payload satisfying BOTH accepted shapes at once (04 §7.7).
+ * `gauge-arc` declares `['single-metric', 'categorical']` because `cluster` is a
+ * CONFIG flag while `demoData(seed)` only sees the seed — so the payload carries
+ * `value` (single-metric, the speedometer) *and* `items` (categorical, the
+ * cluster grid), and the component reads whichever its config selects.
+ */
+export declare function gaugeArcDemoData(seed: number): {
+    value: number;
+    items: {
+        key: string;
+        label: string;
+        value: number;
+        tone: string;
+    }[];
+};
+export declare const periodComparisonConfigSchema: z.ZodObject<{
+    title: z.ZodOptional<z.ZodString>;
+    subtitle: z.ZodOptional<z.ZodString>;
+    icon: z.ZodOptional<z.ZodString>;
+    href: z.ZodOptional<z.ZodString>;
+    binding: z.ZodOptional<z.ZodObject<{
+        kind: z.ZodDefault<z.ZodLiteral<"table-query">>;
+        connectionId: z.ZodString;
+        source: z.ZodObject<{
+            schema: z.ZodOptional<z.ZodString>;
+            name: z.ZodString;
+            type: z.ZodDefault<z.ZodEnum<{
+                table: "table";
+                view: "view";
+            }>>;
+        }, z.core.$strip>;
+        shape: z.ZodEnum<{
+            "single-metric": "single-metric";
+            "metric+delta": "metric+delta";
+            timeseries: "timeseries";
+            "multi-timeseries": "multi-timeseries";
+            categorical: "categorical";
+            "record-list": "record-list";
+            record: "record";
+            matrix: "matrix";
+            "hierarchy/tree": "hierarchy/tree";
+            "calendar-events": "calendar-events";
+            "geo-points": "geo-points";
+            flows: "flows";
+            ohlc: "ohlc";
+            distribution: "distribution";
+            "boolean-map": "boolean-map";
+            stream: "stream";
+            "form-state": "form-state";
+            static: "static";
+        }>;
+        select: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        aggregations: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            fn: z.ZodEnum<{
+                count: "count";
+                sum: "sum";
+                avg: "avg";
+                min: "min";
+                max: "max";
+                count_distinct: "count_distinct";
+                percentile: "percentile";
+            }>;
+            column: z.ZodOptional<z.ZodString>;
+            p: z.ZodOptional<z.ZodNumber>;
+            alias: z.ZodString;
+        }, z.core.$strip>>>;
+        groupBy: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        bucket: z.ZodOptional<z.ZodObject<{
+            column: z.ZodString;
+            unit: z.ZodEnum<{
+                hour: "hour";
+                day: "day";
+                week: "week";
+                month: "month";
+                quarter: "quarter";
+                year: "year";
+            }>;
+        }, z.core.$strip>>;
+        filters: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            column: z.ZodString;
+            op: z.ZodEnum<{
+                eq: "eq";
+                neq: "neq";
+                gt: "gt";
+                gte: "gte";
+                lt: "lt";
+                lte: "lte";
+                in: "in";
+                like: "like";
+                ilike: "ilike";
+                is_null: "is_null";
+                not_null: "not_null";
+                between: "between";
+            }>;
+            value: z.ZodOptional<z.ZodUnknown>;
+            param: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>>;
+        window: z.ZodOptional<z.ZodObject<{
+            column: z.ZodString;
+            last: z.ZodNumber;
+            unit: z.ZodEnum<{
+                hour: "hour";
+                day: "day";
+                week: "week";
+                month: "month";
+                quarter: "quarter";
+                year: "year";
+            }>;
+            compareToPrior: z.ZodDefault<z.ZodBoolean>;
+        }, z.core.$strip>>;
+        orderBy: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            column: z.ZodString;
+            dir: z.ZodEnum<{
+                asc: "asc";
+                desc: "desc";
+            }>;
+        }, z.core.$strip>>>;
+        limit: z.ZodOptional<z.ZodNumber>;
+        cursor: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    refreshInterval: z.ZodOptional<z.ZodNumber>;
+    emptyState: z.ZodOptional<z.ZodObject<{
+        icon: z.ZodOptional<z.ZodString>;
+        titleKey: z.ZodOptional<z.ZodString>;
+        bodyKey: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    permissions: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    tone: z.ZodOptional<z.ZodEnum<{
+        accent: "accent";
+        pos: "pos";
+        warn: "warn";
+        danger: "danger";
+        info: "info";
+        muted: "muted";
+    }>>;
+    format: z.ZodOptional<z.ZodObject<{
+        locale: z.ZodOptional<z.ZodString>;
+        currency: z.ZodOptional<z.ZodString>;
+        number: z.ZodOptional<z.ZodEnum<{
+            percent: "percent";
+            plain: "plain";
+            compact: "compact";
+        }>>;
+        date: z.ZodOptional<z.ZodEnum<{
+            relative: "relative";
+            short: "short";
+            long: "long";
+        }>>;
+        referenceTime: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>;
+    testId: z.ZodOptional<z.ZodString>;
+    periodALabel: z.ZodOptional<z.ZodString>;
+    periodBLabel: z.ZodOptional<z.ZodString>;
+    metricFormat: z.ZodDefault<z.ZodEnum<{
+        percent: "percent";
+        duration: "duration";
+        plain: "plain";
+        currency: "currency";
+        compact: "compact";
+    }>>;
+    invertDeltaGood: z.ZodDefault<z.ZodBoolean>;
+    higherLabel: z.ZodOptional<z.ZodString>;
+    lowerLabel: z.ZodOptional<z.ZodString>;
+    flatLabel: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type PeriodComparisonConfig = z.infer<typeof periodComparisonConfigSchema>;
+/**
+ * Deterministic `metric+delta` demo payload (04 §7.7) — the annex's "two
+ * `single-metric` values for adjacent windows" IS the `metric+delta` envelope
+ * (`value` = this period, `prior` = last), so the shared `computeDelta` produces
+ * the footer figure without a bespoke shape.
+ */
+export declare function periodComparisonDemoData(seed: number): {
+    value: number;
+    prior: number;
+};
+export declare const microKpiSubtitleConfigSchema: z.ZodObject<{
+    title: z.ZodOptional<z.ZodString>;
+    subtitle: z.ZodOptional<z.ZodString>;
+    icon: z.ZodOptional<z.ZodString>;
+    href: z.ZodOptional<z.ZodString>;
+    binding: z.ZodOptional<z.ZodObject<{
+        kind: z.ZodDefault<z.ZodLiteral<"table-query">>;
+        connectionId: z.ZodString;
+        source: z.ZodObject<{
+            schema: z.ZodOptional<z.ZodString>;
+            name: z.ZodString;
+            type: z.ZodDefault<z.ZodEnum<{
+                table: "table";
+                view: "view";
+            }>>;
+        }, z.core.$strip>;
+        shape: z.ZodEnum<{
+            "single-metric": "single-metric";
+            "metric+delta": "metric+delta";
+            timeseries: "timeseries";
+            "multi-timeseries": "multi-timeseries";
+            categorical: "categorical";
+            "record-list": "record-list";
+            record: "record";
+            matrix: "matrix";
+            "hierarchy/tree": "hierarchy/tree";
+            "calendar-events": "calendar-events";
+            "geo-points": "geo-points";
+            flows: "flows";
+            ohlc: "ohlc";
+            distribution: "distribution";
+            "boolean-map": "boolean-map";
+            stream: "stream";
+            "form-state": "form-state";
+            static: "static";
+        }>;
+        select: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        aggregations: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            fn: z.ZodEnum<{
+                count: "count";
+                sum: "sum";
+                avg: "avg";
+                min: "min";
+                max: "max";
+                count_distinct: "count_distinct";
+                percentile: "percentile";
+            }>;
+            column: z.ZodOptional<z.ZodString>;
+            p: z.ZodOptional<z.ZodNumber>;
+            alias: z.ZodString;
+        }, z.core.$strip>>>;
+        groupBy: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        bucket: z.ZodOptional<z.ZodObject<{
+            column: z.ZodString;
+            unit: z.ZodEnum<{
+                hour: "hour";
+                day: "day";
+                week: "week";
+                month: "month";
+                quarter: "quarter";
+                year: "year";
+            }>;
+        }, z.core.$strip>>;
+        filters: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            column: z.ZodString;
+            op: z.ZodEnum<{
+                eq: "eq";
+                neq: "neq";
+                gt: "gt";
+                gte: "gte";
+                lt: "lt";
+                lte: "lte";
+                in: "in";
+                like: "like";
+                ilike: "ilike";
+                is_null: "is_null";
+                not_null: "not_null";
+                between: "between";
+            }>;
+            value: z.ZodOptional<z.ZodUnknown>;
+            param: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>>;
+        window: z.ZodOptional<z.ZodObject<{
+            column: z.ZodString;
+            last: z.ZodNumber;
+            unit: z.ZodEnum<{
+                hour: "hour";
+                day: "day";
+                week: "week";
+                month: "month";
+                quarter: "quarter";
+                year: "year";
+            }>;
+            compareToPrior: z.ZodDefault<z.ZodBoolean>;
+        }, z.core.$strip>>;
+        orderBy: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            column: z.ZodString;
+            dir: z.ZodEnum<{
+                asc: "asc";
+                desc: "desc";
+            }>;
+        }, z.core.$strip>>>;
+        limit: z.ZodOptional<z.ZodNumber>;
+        cursor: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    refreshInterval: z.ZodOptional<z.ZodNumber>;
+    emptyState: z.ZodOptional<z.ZodObject<{
+        icon: z.ZodOptional<z.ZodString>;
+        titleKey: z.ZodOptional<z.ZodString>;
+        bodyKey: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    permissions: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    tone: z.ZodOptional<z.ZodEnum<{
+        accent: "accent";
+        pos: "pos";
+        warn: "warn";
+        danger: "danger";
+        info: "info";
+        muted: "muted";
+    }>>;
+    format: z.ZodOptional<z.ZodObject<{
+        locale: z.ZodOptional<z.ZodString>;
+        currency: z.ZodOptional<z.ZodString>;
+        number: z.ZodOptional<z.ZodEnum<{
+            percent: "percent";
+            plain: "plain";
+            compact: "compact";
+        }>>;
+        date: z.ZodOptional<z.ZodEnum<{
+            relative: "relative";
+            short: "short";
+            long: "long";
+        }>>;
+        referenceTime: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>;
+    testId: z.ZodOptional<z.ZodString>;
+    template: z.ZodDefault<z.ZodString>;
+    zeroStateText: z.ZodOptional<z.ZodString>;
+    zeroKey: z.ZodDefault<z.ZodString>;
+    metricFormat: z.ZodDefault<z.ZodEnum<{
+        percent: "percent";
+        duration: "duration";
+        plain: "plain";
+        currency: "currency";
+        compact: "compact";
+    }>>;
+}, z.core.$strip>;
+export type MicroKpiSubtitleConfig = z.infer<typeof microKpiSubtitleConfigSchema>;
+/**
+ * Deterministic `single-metric` demo payload (04 §7.7). The annex's contract is
+ * "1–3 derived scalars over a sibling `record-list`", so the envelope is a
+ * `single-metric` (`value`) carrying the sibling scalars the template reads.
+ */
+export declare function microKpiSubtitleDemoData(seed: number): {
+    value: number;
+    total: number;
+    online: number;
+};
+export declare const autoInsightsConfigSchema: z.ZodObject<{
+    title: z.ZodOptional<z.ZodString>;
+    subtitle: z.ZodOptional<z.ZodString>;
+    icon: z.ZodOptional<z.ZodString>;
+    href: z.ZodOptional<z.ZodString>;
+    binding: z.ZodOptional<z.ZodObject<{
+        kind: z.ZodDefault<z.ZodLiteral<"table-query">>;
+        connectionId: z.ZodString;
+        source: z.ZodObject<{
+            schema: z.ZodOptional<z.ZodString>;
+            name: z.ZodString;
+            type: z.ZodDefault<z.ZodEnum<{
+                table: "table";
+                view: "view";
+            }>>;
+        }, z.core.$strip>;
+        shape: z.ZodEnum<{
+            "single-metric": "single-metric";
+            "metric+delta": "metric+delta";
+            timeseries: "timeseries";
+            "multi-timeseries": "multi-timeseries";
+            categorical: "categorical";
+            "record-list": "record-list";
+            record: "record";
+            matrix: "matrix";
+            "hierarchy/tree": "hierarchy/tree";
+            "calendar-events": "calendar-events";
+            "geo-points": "geo-points";
+            flows: "flows";
+            ohlc: "ohlc";
+            distribution: "distribution";
+            "boolean-map": "boolean-map";
+            stream: "stream";
+            "form-state": "form-state";
+            static: "static";
+        }>;
+        select: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        aggregations: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            fn: z.ZodEnum<{
+                count: "count";
+                sum: "sum";
+                avg: "avg";
+                min: "min";
+                max: "max";
+                count_distinct: "count_distinct";
+                percentile: "percentile";
+            }>;
+            column: z.ZodOptional<z.ZodString>;
+            p: z.ZodOptional<z.ZodNumber>;
+            alias: z.ZodString;
+        }, z.core.$strip>>>;
+        groupBy: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        bucket: z.ZodOptional<z.ZodObject<{
+            column: z.ZodString;
+            unit: z.ZodEnum<{
+                hour: "hour";
+                day: "day";
+                week: "week";
+                month: "month";
+                quarter: "quarter";
+                year: "year";
+            }>;
+        }, z.core.$strip>>;
+        filters: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            column: z.ZodString;
+            op: z.ZodEnum<{
+                eq: "eq";
+                neq: "neq";
+                gt: "gt";
+                gte: "gte";
+                lt: "lt";
+                lte: "lte";
+                in: "in";
+                like: "like";
+                ilike: "ilike";
+                is_null: "is_null";
+                not_null: "not_null";
+                between: "between";
+            }>;
+            value: z.ZodOptional<z.ZodUnknown>;
+            param: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>>;
+        window: z.ZodOptional<z.ZodObject<{
+            column: z.ZodString;
+            last: z.ZodNumber;
+            unit: z.ZodEnum<{
+                hour: "hour";
+                day: "day";
+                week: "week";
+                month: "month";
+                quarter: "quarter";
+                year: "year";
+            }>;
+            compareToPrior: z.ZodDefault<z.ZodBoolean>;
+        }, z.core.$strip>>;
+        orderBy: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            column: z.ZodString;
+            dir: z.ZodEnum<{
+                asc: "asc";
+                desc: "desc";
+            }>;
+        }, z.core.$strip>>>;
+        limit: z.ZodOptional<z.ZodNumber>;
+        cursor: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    refreshInterval: z.ZodOptional<z.ZodNumber>;
+    emptyState: z.ZodOptional<z.ZodObject<{
+        icon: z.ZodOptional<z.ZodString>;
+        titleKey: z.ZodOptional<z.ZodString>;
+        bodyKey: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    permissions: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    tone: z.ZodOptional<z.ZodEnum<{
+        accent: "accent";
+        pos: "pos";
+        warn: "warn";
+        danger: "danger";
+        info: "info";
+        muted: "muted";
+    }>>;
+    format: z.ZodOptional<z.ZodObject<{
+        locale: z.ZodOptional<z.ZodString>;
+        currency: z.ZodOptional<z.ZodString>;
+        number: z.ZodOptional<z.ZodEnum<{
+            percent: "percent";
+            plain: "plain";
+            compact: "compact";
+        }>>;
+        date: z.ZodOptional<z.ZodEnum<{
+            relative: "relative";
+            short: "short";
+            long: "long";
+        }>>;
+        referenceTime: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>;
+    testId: z.ZodOptional<z.ZodString>;
+    count: z.ZodDefault<z.ZodNumber>;
+    refreshable: z.ZodDefault<z.ZodBoolean>;
+    pool: z.ZodDefault<z.ZodNumber>;
+    variant: z.ZodDefault<z.ZodEnum<{
+        bullets: "bullets";
+        cards: "cards";
+    }>>;
+    columns: z.ZodDefault<z.ZodNumber>;
+    applyLabel: z.ZodOptional<z.ZodString>;
+    refreshLabel: z.ZodOptional<z.ZodString>;
+    idField: z.ZodDefault<z.ZodString>;
+    iconField: z.ZodDefault<z.ZodString>;
+    toneField: z.ZodDefault<z.ZodString>;
+    tagField: z.ZodDefault<z.ZodString>;
+    titleField: z.ZodDefault<z.ZodString>;
+    bodyField: z.ZodDefault<z.ZodString>;
+    sparkField: z.ZodDefault<z.ZodString>;
+    hrefField: z.ZodDefault<z.ZodString>;
+    scoreField: z.ZodDefault<z.ZodString>;
+}, z.core.$strip>;
+export type AutoInsightsConfig = z.infer<typeof autoInsightsConfigSchema>;
+/**
+ * Deterministic `record-list` of ranked insights (04 §7.7). Every row carries a
+ * `score` so the widget's ranking is exercised, and a spark so the annex's
+ * "bold stat + sentence + mini sparkline" row has its third element.
+ */
+export declare function autoInsightsDemoData(seed: number): {
+    rows: Record<string, unknown>[];
+    total: number;
+};
+/** Re-exported so the definitions module's icon enum stays annex-anchored. */
+export { INSIGHT_ICONS };
+//# sourceMappingURL=kpi-config.d.ts.map