react-semaphor 0.1.503 → 0.1.505

package/dist/types/shared/dashboard-authoring/matrix-delivery.d.ts

@@ -0,0 +1,1453 @@
+import { z } from 'zod';
+import { MatrixConfig, MatrixViewState, MatrixExportRequest } from '../analytics-protocol/index.js';
+import { ReportRuntimeContext } from '../report-runtime-context/index.js';
+export type MatrixExportContent = 'current' | 'all' | 'flat';
+export declare function captureMatrixExport(input: {
+    config: MatrixConfig;
+    session?: MatrixViewState;
+    content: MatrixExportContent;
+    format: 'csv' | 'pdf';
+    purpose: 'manual' | 'schedule';
+}): {
+    mode: "layout";
+    presentation: {
+        totals: {
+            columns: {
+                grand: {
+                    visible: boolean;
+                    position: "before" | "after";
+                    label?: string | undefined;
+                };
+                levels: Readonly<Record<string, {
+                    visible: boolean;
+                    position: "before" | "after";
+                    label?: string | undefined;
+                }>>;
+            };
+            rows: {
+                grand: {
+                    visible: boolean;
+                    position: "before" | "after";
+                    label?: string | undefined;
+                };
+                levels: Readonly<Record<string, {
+                    visible: boolean;
+                    position: "before" | "after";
+                    label?: string | undefined;
+                }>>;
+            };
+        };
+        layout: {
+            kind: "compact";
+        } | {
+            kind: "tabular";
+            repeatLabels: boolean;
+        };
+        absence: {
+            emptyText: string;
+            nullText: string;
+        };
+        levelLabels: Readonly<Record<string, string>>;
+        measureLabels: Readonly<Record<string, string>>;
+        levelFormats: Readonly<Record<string, import('../analytics-protocol/index.js').TemporalBucketFormat | {
+            type: "date" | "datetime";
+            pattern?: string | undefined;
+            locale?: string | undefined;
+            prefix?: string | undefined;
+            suffix?: string | undefined;
+            relative?: boolean | undefined;
+            timezone?: string | undefined;
+            sourceTimezone?: string | undefined;
+        } | {
+            type: "duration";
+            prefix?: string | undefined;
+            suffix?: string | undefined;
+            negativeStyle?: "minus" | "parentheses" | undefined;
+            inputUnit?: "second" | "minute" | "hour" | "day" | "millisecond" | undefined;
+            outputStyle?: "compact" | "digital" | "long" | undefined;
+            largestUnit?: "second" | "minute" | "hour" | "day" | "millisecond" | undefined;
+            smallestUnit?: "second" | "minute" | "hour" | "day" | "millisecond" | undefined;
+            maxUnits?: number | undefined;
+        } | {
+            type: "string";
+            prefix?: string | undefined;
+            suffix?: string | undefined;
+        } | {
+            type: "number" | "currency" | "percent" | "percentage" | "scientific";
+            currency?: string | undefined;
+            minimumFractionDigits?: number | undefined;
+            maximumFractionDigits?: number | undefined;
+            useGrouping?: boolean | undefined;
+            prefix?: string | undefined;
+            suffix?: string | undefined;
+            negativeStyle?: "minus" | "parentheses" | undefined;
+            compact?: boolean | undefined;
+            scale?: number | undefined;
+            percentValueMode?: "fraction" | "whole" | undefined;
+        }>>;
+        measureFormats: Readonly<Record<string, import('../analytics-protocol/index.js').TemporalBucketFormat | {
+            type: "date" | "datetime";
+            pattern?: string | undefined;
+            locale?: string | undefined;
+            prefix?: string | undefined;
+            suffix?: string | undefined;
+            relative?: boolean | undefined;
+            timezone?: string | undefined;
+            sourceTimezone?: string | undefined;
+        } | {
+            type: "duration";
+            prefix?: string | undefined;
+            suffix?: string | undefined;
+            negativeStyle?: "minus" | "parentheses" | undefined;
+            inputUnit?: "second" | "minute" | "hour" | "day" | "millisecond" | undefined;
+            outputStyle?: "compact" | "digital" | "long" | undefined;
+            largestUnit?: "second" | "minute" | "hour" | "day" | "millisecond" | undefined;
+            smallestUnit?: "second" | "minute" | "hour" | "day" | "millisecond" | undefined;
+            maxUnits?: number | undefined;
+        } | {
+            type: "string";
+            prefix?: string | undefined;
+            suffix?: string | undefined;
+        } | {
+            type: "number" | "currency" | "percent" | "percentage" | "scientific";
+            currency?: string | undefined;
+            minimumFractionDigits?: number | undefined;
+            maximumFractionDigits?: number | undefined;
+            useGrouping?: boolean | undefined;
+            prefix?: string | undefined;
+            suffix?: string | undefined;
+            negativeStyle?: "minus" | "parentheses" | undefined;
+            compact?: boolean | undefined;
+            scale?: number | undefined;
+            percentValueMode?: "fraction" | "whole" | undefined;
+        }>>;
+        conditionalFormatting?: {
+            version: 1;
+            rules: {
+                id: string;
+                target: {
+                    level: "row" | "cell";
+                    matrix?: {
+                        axis: "columns" | "rows";
+                        levelId?: string | undefined;
+                        oppositePath?: {
+                            member: {
+                                value: string | number | boolean | {
+                                    value: string;
+                                    type: "integer" | "decimal";
+                                    kind: "exact_number";
+                                } | null;
+                                kind: "value";
+                            } | {
+                                kind: "others";
+                                rankingId: string;
+                            };
+                            levelId: string;
+                        }[] | undefined;
+                    } | undefined;
+                    columnIds?: string[] | undefined;
+                    conditionColumnId?: string | undefined;
+                    applyToColumnIds?: string[] | undefined;
+                    tableParts?: ("subtotal" | "body" | "header" | "footer" | "grandTotal")[] | undefined;
+                    rowRoles?: ("member" | "subtotal" | "grand_total" | "others")[] | undefined;
+                    depth?: number | undefined;
+                    includeTotals?: boolean | undefined;
+                    includeSubtotals?: boolean | undefined;
+                };
+                condition: {
+                    value: string | number | boolean | {
+                        value: string;
+                        type: "integer" | "decimal";
+                        kind: "exact_number";
+                    } | null;
+                    kind: "comparison";
+                    operator: "eq" | "neq" | "gt" | "gte" | "lt" | "lte";
+                    columnId: string;
+                } | {
+                    kind: "between";
+                    columnId: string;
+                    min: string | number | boolean | {
+                        value: string;
+                        type: "integer" | "decimal";
+                        kind: "exact_number";
+                    } | null;
+                    max: string | number | boolean | {
+                        value: string;
+                        type: "integer" | "decimal";
+                        kind: "exact_number";
+                    } | null;
+                    inclusive?: boolean | undefined;
+                } | {
+                    kind: "blank";
+                    columnId: string;
+                    isBlank: boolean;
+                } | {
+                    value: string;
+                    kind: "contains";
+                    columnId: string;
+                    exact?: boolean | undefined;
+                    caseSensitive?: boolean | undefined;
+                } | {
+                    kind: "topBottom";
+                    count: number;
+                    columnId: string;
+                    direction: "top" | "bottom";
+                } | {
+                    kind: "colorScale";
+                    columnId: string;
+                    range: "auto" | "manual";
+                    colors: {
+                        min: string;
+                        max: string;
+                        mid?: string | undefined;
+                    };
+                    min?: number | undefined;
+                    max?: number | undefined;
+                    mid?: number | undefined;
+                } | {
+                    kind: "dataBar";
+                    columnId: string;
+                    range: "auto" | "manual";
+                    color: string;
+                    min?: number | undefined;
+                    max?: number | undefined;
+                    showValue?: boolean | undefined;
+                };
+                name?: string | undefined;
+                enabled?: boolean | undefined;
+                style?: {
+                    dataBar?: {
+                        color: string;
+                        showValue: boolean;
+                    } | undefined;
+                    backgroundColor?: string | undefined;
+                    textColor?: string | undefined;
+                    fontWeight?: "normal" | "medium" | "semibold" | "bold" | undefined;
+                    italic?: boolean | undefined;
+                    textDecoration?: "none" | "underline" | "line-through" | undefined;
+                    icon?: "arrowUp" | "arrowDown" | "warning" | "check" | "x" | undefined;
+                } | undefined;
+            }[];
+        } | undefined;
+    };
+    format: "csv" | "xlsx" | "pdf";
+    spec: {
+        source: {
+            kind: "semantic";
+            domainId: string;
+            datasetName: string;
+            datasetId?: string | undefined;
+            label?: string | undefined;
+            connectionId?: string | undefined;
+        } | {
+            kind: "physical";
+            connectionId: string;
+            tableName: string;
+            label?: string | undefined;
+            connectionType?: string | undefined;
+            databaseName?: string | undefined;
+            schemaName?: string | undefined;
+            dialect?: "postgres" | "mysql" | "mssql" | "snowflake" | "clickhouse" | "bigquery" | "redshift" | "duckdb" | "sqlite" | "unknown" | undefined;
+        };
+        columns: readonly import('../analytics-protocol/index.js').MatrixLevel[];
+        measures: readonly ({
+            id: string;
+            kind: "aggregate";
+            aggregate: "SUM" | "COUNT" | "AVG" | "MIN" | "MAX" | "DISTINCT";
+            field: Omit<import('../analytics-protocol/index.js').SemaphorExecutionFieldRef, "source" | "aggregate" | "derivedField"> & {
+                source?: import('../analytics-protocol/index.js').SemaphorMatrixSourceRef;
+                derivedField?: Omit<import('../analytics-protocol/index.js').SemaphorDerivedFieldDefinition, "inputs"> & {
+                    inputs: Record<string, {
+                        kind: "field";
+                        field: Omit<import('../analytics-protocol/index.js').SemaphorFieldRef, "source"> & {
+                            source?: import('../analytics-protocol/index.js').SemaphorMatrixSourceRef;
+                        };
+                        aggregate?: import('../analytics-protocol/index.js').SemaphorAggregateFunction;
+                    }>;
+                };
+            };
+        } | {
+            id: string;
+            kind: "calculated";
+            definition: Omit<import('../analytics-protocol/index.js').SemaphorDerivedFieldDefinition, "inputs"> & {
+                inputs: Record<string, {
+                    kind: "field";
+                    field: Omit<import('../analytics-protocol/index.js').SemaphorFieldRef, "source"> & {
+                        source?: import('../analytics-protocol/index.js').SemaphorMatrixSourceRef;
+                    };
+                    aggregate?: import('../analytics-protocol/index.js').SemaphorAggregateFunction;
+                }>;
+            };
+        })[];
+        rows: readonly import('../analytics-protocol/index.js').MatrixLevel[];
+        sorts: readonly {
+            target: import('../analytics-protocol/index.js').MatrixSortTarget;
+            scope: {
+                kind: "level";
+            } | {
+                kind: "branch";
+                parent: readonly {
+                    member: {
+                        value: string | number | boolean | {
+                            value: string;
+                            type: "integer" | "decimal";
+                            kind: "exact_number";
+                        } | null;
+                        kind: "value";
+                    } | {
+                        kind: "others";
+                        rankingId: string;
+                    };
+                    levelId: string;
+                }[];
+            };
+            levelId: string;
+            axis: "columns" | "rows";
+            direction: "asc" | "desc";
+            nulls: "first" | "last";
+        }[];
+        rankings: readonly import('../analytics-protocol/index.js').MatrixRanking[];
+        filters?: import('../../components/index.js').FilterGroup | undefined;
+        joinPlan?: import('../../components/index.js').JoinPlan | undefined;
+        relationshipHint?: {
+            relationshipIds?: string[] | undefined;
+        } | undefined;
+    };
+    expansion: {
+        kind: "current";
+        columns: {
+            depth: number;
+            overrides: readonly {
+                path: readonly {
+                    member: {
+                        value: string | number | boolean | {
+                            value: string;
+                            type: "integer" | "decimal";
+                            kind: "exact_number";
+                        } | null;
+                        kind: "value";
+                    } | {
+                        kind: "others";
+                        rankingId: string;
+                    };
+                    levelId: string;
+                }[];
+                expanded: boolean;
+            }[];
+        };
+        rows: {
+            depth: number;
+            overrides: readonly {
+                path: readonly {
+                    member: {
+                        value: string | number | boolean | {
+                            value: string;
+                            type: "integer" | "decimal";
+                            kind: "exact_number";
+                        } | null;
+                        kind: "value";
+                    } | {
+                        kind: "others";
+                        rankingId: string;
+                    };
+                    levelId: string;
+                }[];
+                expanded: boolean;
+            }[];
+        };
+    } | {
+        kind: "all";
+    };
+} | {
+    mode: "flat";
+    presentation: {
+        totals: {
+            columns: {
+                grand: {
+                    visible: boolean;
+                    position: "before" | "after";
+                    label?: string | undefined;
+                };
+                levels: Readonly<Record<string, {
+                    visible: boolean;
+                    position: "before" | "after";
+                    label?: string | undefined;
+                }>>;
+            };
+            rows: {
+                grand: {
+                    visible: boolean;
+                    position: "before" | "after";
+                    label?: string | undefined;
+                };
+                levels: Readonly<Record<string, {
+                    visible: boolean;
+                    position: "before" | "after";
+                    label?: string | undefined;
+                }>>;
+            };
+        };
+        layout: {
+            kind: "compact";
+        } | {
+            kind: "tabular";
+            repeatLabels: boolean;
+        };
+        absence: {
+            emptyText: string;
+            nullText: string;
+        };
+        levelLabels: Readonly<Record<string, string>>;
+        measureLabels: Readonly<Record<string, string>>;
+        levelFormats: Readonly<Record<string, import('../analytics-protocol/index.js').TemporalBucketFormat | {
+            type: "date" | "datetime";
+            pattern?: string | undefined;
+            locale?: string | undefined;
+            prefix?: string | undefined;
+            suffix?: string | undefined;
+            relative?: boolean | undefined;
+            timezone?: string | undefined;
+            sourceTimezone?: string | undefined;
+        } | {
+            type: "duration";
+            prefix?: string | undefined;
+            suffix?: string | undefined;
+            negativeStyle?: "minus" | "parentheses" | undefined;
+            inputUnit?: "second" | "minute" | "hour" | "day" | "millisecond" | undefined;
+            outputStyle?: "compact" | "digital" | "long" | undefined;
+            largestUnit?: "second" | "minute" | "hour" | "day" | "millisecond" | undefined;
+            smallestUnit?: "second" | "minute" | "hour" | "day" | "millisecond" | undefined;
+            maxUnits?: number | undefined;
+        } | {
+            type: "string";
+            prefix?: string | undefined;
+            suffix?: string | undefined;
+        } | {
+            type: "number" | "currency" | "percent" | "percentage" | "scientific";
+            currency?: string | undefined;
+            minimumFractionDigits?: number | undefined;
+            maximumFractionDigits?: number | undefined;
+            useGrouping?: boolean | undefined;
+            prefix?: string | undefined;
+            suffix?: string | undefined;
+            negativeStyle?: "minus" | "parentheses" | undefined;
+            compact?: boolean | undefined;
+            scale?: number | undefined;
+            percentValueMode?: "fraction" | "whole" | undefined;
+        }>>;
+        measureFormats: Readonly<Record<string, import('../analytics-protocol/index.js').TemporalBucketFormat | {
+            type: "date" | "datetime";
+            pattern?: string | undefined;
+            locale?: string | undefined;
+            prefix?: string | undefined;
+            suffix?: string | undefined;
+            relative?: boolean | undefined;
+            timezone?: string | undefined;
+            sourceTimezone?: string | undefined;
+        } | {
+            type: "duration";
+            prefix?: string | undefined;
+            suffix?: string | undefined;
+            negativeStyle?: "minus" | "parentheses" | undefined;
+            inputUnit?: "second" | "minute" | "hour" | "day" | "millisecond" | undefined;
+            outputStyle?: "compact" | "digital" | "long" | undefined;
+            largestUnit?: "second" | "minute" | "hour" | "day" | "millisecond" | undefined;
+            smallestUnit?: "second" | "minute" | "hour" | "day" | "millisecond" | undefined;
+            maxUnits?: number | undefined;
+        } | {
+            type: "string";
+            prefix?: string | undefined;
+            suffix?: string | undefined;
+        } | {
+            type: "number" | "currency" | "percent" | "percentage" | "scientific";
+            currency?: string | undefined;
+            minimumFractionDigits?: number | undefined;
+            maximumFractionDigits?: number | undefined;
+            useGrouping?: boolean | undefined;
+            prefix?: string | undefined;
+            suffix?: string | undefined;
+            negativeStyle?: "minus" | "parentheses" | undefined;
+            compact?: boolean | undefined;
+            scale?: number | undefined;
+            percentValueMode?: "fraction" | "whole" | undefined;
+        }>>;
+        conditionalFormatting?: {
+            version: 1;
+            rules: {
+                id: string;
+                target: {
+                    level: "row" | "cell";
+                    matrix?: {
+                        axis: "columns" | "rows";
+                        levelId?: string | undefined;
+                        oppositePath?: {
+                            member: {
+                                value: string | number | boolean | {
+                                    value: string;
+                                    type: "integer" | "decimal";
+                                    kind: "exact_number";
+                                } | null;
+                                kind: "value";
+                            } | {
+                                kind: "others";
+                                rankingId: string;
+                            };
+                            levelId: string;
+                        }[] | undefined;
+                    } | undefined;
+                    columnIds?: string[] | undefined;
+                    conditionColumnId?: string | undefined;
+                    applyToColumnIds?: string[] | undefined;
+                    tableParts?: ("subtotal" | "body" | "header" | "footer" | "grandTotal")[] | undefined;
+                    rowRoles?: ("member" | "subtotal" | "grand_total" | "others")[] | undefined;
+                    depth?: number | undefined;
+                    includeTotals?: boolean | undefined;
+                    includeSubtotals?: boolean | undefined;
+                };
+                condition: {
+                    value: string | number | boolean | {
+                        value: string;
+                        type: "integer" | "decimal";
+                        kind: "exact_number";
+                    } | null;
+                    kind: "comparison";
+                    operator: "eq" | "neq" | "gt" | "gte" | "lt" | "lte";
+                    columnId: string;
+                } | {
+                    kind: "between";
+                    columnId: string;
+                    min: string | number | boolean | {
+                        value: string;
+                        type: "integer" | "decimal";
+                        kind: "exact_number";
+                    } | null;
+                    max: string | number | boolean | {
+                        value: string;
+                        type: "integer" | "decimal";
+                        kind: "exact_number";
+                    } | null;
+                    inclusive?: boolean | undefined;
+                } | {
+                    kind: "blank";
+                    columnId: string;
+                    isBlank: boolean;
+                } | {
+                    value: string;
+                    kind: "contains";
+                    columnId: string;
+                    exact?: boolean | undefined;
+                    caseSensitive?: boolean | undefined;
+                } | {
+                    kind: "topBottom";
+                    count: number;
+                    columnId: string;
+                    direction: "top" | "bottom";
+                } | {
+                    kind: "colorScale";
+                    columnId: string;
+                    range: "auto" | "manual";
+                    colors: {
+                        min: string;
+                        max: string;
+                        mid?: string | undefined;
+                    };
+                    min?: number | undefined;
+                    max?: number | undefined;
+                    mid?: number | undefined;
+                } | {
+                    kind: "dataBar";
+                    columnId: string;
+                    range: "auto" | "manual";
+                    color: string;
+                    min?: number | undefined;
+                    max?: number | undefined;
+                    showValue?: boolean | undefined;
+                };
+                name?: string | undefined;
+                enabled?: boolean | undefined;
+                style?: {
+                    dataBar?: {
+                        color: string;
+                        showValue: boolean;
+                    } | undefined;
+                    backgroundColor?: string | undefined;
+                    textColor?: string | undefined;
+                    fontWeight?: "normal" | "medium" | "semibold" | "bold" | undefined;
+                    italic?: boolean | undefined;
+                    textDecoration?: "none" | "underline" | "line-through" | undefined;
+                    icon?: "arrowUp" | "arrowDown" | "warning" | "check" | "x" | undefined;
+                } | undefined;
+            }[];
+        } | undefined;
+    };
+    format: "csv";
+    spec: {
+        source: {
+            kind: "semantic";
+            domainId: string;
+            datasetName: string;
+            datasetId?: string | undefined;
+            label?: string | undefined;
+            connectionId?: string | undefined;
+        } | {
+            kind: "physical";
+            connectionId: string;
+            tableName: string;
+            label?: string | undefined;
+            connectionType?: string | undefined;
+            databaseName?: string | undefined;
+            schemaName?: string | undefined;
+            dialect?: "postgres" | "mysql" | "mssql" | "snowflake" | "clickhouse" | "bigquery" | "redshift" | "duckdb" | "sqlite" | "unknown" | undefined;
+        };
+        columns: readonly import('../analytics-protocol/index.js').MatrixLevel[];
+        measures: readonly ({
+            id: string;
+            kind: "aggregate";
+            aggregate: "SUM" | "COUNT" | "AVG" | "MIN" | "MAX" | "DISTINCT";
+            field: Omit<import('../analytics-protocol/index.js').SemaphorExecutionFieldRef, "source" | "aggregate" | "derivedField"> & {
+                source?: import('../analytics-protocol/index.js').SemaphorMatrixSourceRef;
+                derivedField?: Omit<import('../analytics-protocol/index.js').SemaphorDerivedFieldDefinition, "inputs"> & {
+                    inputs: Record<string, {
+                        kind: "field";
+                        field: Omit<import('../analytics-protocol/index.js').SemaphorFieldRef, "source"> & {
+                            source?: import('../analytics-protocol/index.js').SemaphorMatrixSourceRef;
+                        };
+                        aggregate?: import('../analytics-protocol/index.js').SemaphorAggregateFunction;
+                    }>;
+                };
+            };
+        } | {
+            id: string;
+            kind: "calculated";
+            definition: Omit<import('../analytics-protocol/index.js').SemaphorDerivedFieldDefinition, "inputs"> & {
+                inputs: Record<string, {
+                    kind: "field";
+                    field: Omit<import('../analytics-protocol/index.js').SemaphorFieldRef, "source"> & {
+                        source?: import('../analytics-protocol/index.js').SemaphorMatrixSourceRef;
+                    };
+                    aggregate?: import('../analytics-protocol/index.js').SemaphorAggregateFunction;
+                }>;
+            };
+        })[];
+        rows: readonly import('../analytics-protocol/index.js').MatrixLevel[];
+        sorts: readonly {
+            target: import('../analytics-protocol/index.js').MatrixSortTarget;
+            scope: {
+                kind: "level";
+            } | {
+                kind: "branch";
+                parent: readonly {
+                    member: {
+                        value: string | number | boolean | {
+                            value: string;
+                            type: "integer" | "decimal";
+                            kind: "exact_number";
+                        } | null;
+                        kind: "value";
+                    } | {
+                        kind: "others";
+                        rankingId: string;
+                    };
+                    levelId: string;
+                }[];
+            };
+            levelId: string;
+            axis: "columns" | "rows";
+            direction: "asc" | "desc";
+            nulls: "first" | "last";
+        }[];
+        rankings: readonly import('../analytics-protocol/index.js').MatrixRanking[];
+        filters?: import('../../components/index.js').FilterGroup | undefined;
+        joinPlan?: import('../../components/index.js').JoinPlan | undefined;
+        relationshipHint?: {
+            relationshipIds?: string[] | undefined;
+        } | undefined;
+    };
+};
+/** Public analytical payload, shared by job and PDF adapters. Never accepts cells. */
+export declare const matrixDeliveryQuerySchema: z.ZodObject<{
+    connection_id: z.ZodString;
+    cardType: z.ZodLiteral<"matrixTable">;
+    resultOwner: z.ZodLiteral<"config">;
+    sql: z.ZodOptional<z.ZodLiteral<"">>;
+    python: z.ZodOptional<z.ZodLiteral<"">>;
+    tableStructure: z.ZodOptional<z.ZodNever>;
+    cardDataSource: z.ZodObject<{
+        connectionId: z.ZodString;
+        connectionType: z.ZodString;
+        mode: z.ZodEnum<["database", "semanticDomain"]>;
+        selectedEntities: z.ZodArray<z.ZodUnknown, "many">;
+        semanticDomainId: z.ZodOptional<z.ZodString>;
+    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+        connectionId: z.ZodString;
+        connectionType: z.ZodString;
+        mode: z.ZodEnum<["database", "semanticDomain"]>;
+        selectedEntities: z.ZodArray<z.ZodUnknown, "many">;
+        semanticDomainId: z.ZodOptional<z.ZodString>;
+    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+        connectionId: z.ZodString;
+        connectionType: z.ZodString;
+        mode: z.ZodEnum<["database", "semanticDomain"]>;
+        selectedEntities: z.ZodArray<z.ZodUnknown, "many">;
+        semanticDomainId: z.ZodOptional<z.ZodString>;
+    }, z.ZodTypeAny, "passthrough">>;
+    active_filters: z.ZodDefault<z.ZodArray<z.ZodUnknown, "many">>;
+}, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+    connection_id: z.ZodString;
+    cardType: z.ZodLiteral<"matrixTable">;
+    resultOwner: z.ZodLiteral<"config">;
+    sql: z.ZodOptional<z.ZodLiteral<"">>;
+    python: z.ZodOptional<z.ZodLiteral<"">>;
+    tableStructure: z.ZodOptional<z.ZodNever>;
+    cardDataSource: z.ZodObject<{
+        connectionId: z.ZodString;
+        connectionType: z.ZodString;
+        mode: z.ZodEnum<["database", "semanticDomain"]>;
+        selectedEntities: z.ZodArray<z.ZodUnknown, "many">;
+        semanticDomainId: z.ZodOptional<z.ZodString>;
+    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+        connectionId: z.ZodString;
+        connectionType: z.ZodString;
+        mode: z.ZodEnum<["database", "semanticDomain"]>;
+        selectedEntities: z.ZodArray<z.ZodUnknown, "many">;
+        semanticDomainId: z.ZodOptional<z.ZodString>;
+    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+        connectionId: z.ZodString;
+        connectionType: z.ZodString;
+        mode: z.ZodEnum<["database", "semanticDomain"]>;
+        selectedEntities: z.ZodArray<z.ZodUnknown, "many">;
+        semanticDomainId: z.ZodOptional<z.ZodString>;
+    }, z.ZodTypeAny, "passthrough">>;
+    active_filters: z.ZodDefault<z.ZodArray<z.ZodUnknown, "many">>;
+}, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+    connection_id: z.ZodString;
+    cardType: z.ZodLiteral<"matrixTable">;
+    resultOwner: z.ZodLiteral<"config">;
+    sql: z.ZodOptional<z.ZodLiteral<"">>;
+    python: z.ZodOptional<z.ZodLiteral<"">>;
+    tableStructure: z.ZodOptional<z.ZodNever>;
+    cardDataSource: z.ZodObject<{
+        connectionId: z.ZodString;
+        connectionType: z.ZodString;
+        mode: z.ZodEnum<["database", "semanticDomain"]>;
+        selectedEntities: z.ZodArray<z.ZodUnknown, "many">;
+        semanticDomainId: z.ZodOptional<z.ZodString>;
+    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+        connectionId: z.ZodString;
+        connectionType: z.ZodString;
+        mode: z.ZodEnum<["database", "semanticDomain"]>;
+        selectedEntities: z.ZodArray<z.ZodUnknown, "many">;
+        semanticDomainId: z.ZodOptional<z.ZodString>;
+    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+        connectionId: z.ZodString;
+        connectionType: z.ZodString;
+        mode: z.ZodEnum<["database", "semanticDomain"]>;
+        selectedEntities: z.ZodArray<z.ZodUnknown, "many">;
+        semanticDomainId: z.ZodOptional<z.ZodString>;
+    }, z.ZodTypeAny, "passthrough">>;
+    active_filters: z.ZodDefault<z.ZodArray<z.ZodUnknown, "many">>;
+}, z.ZodTypeAny, "passthrough">>;
+export type MatrixDeliveryPayload = z.infer<typeof matrixDeliveryQuerySchema> & {
+    dashboardId: string;
+    cardId: string;
+    formatOptions: {
+        matrix: MatrixExportRequest;
+        presentationExecutionSnapshot?: unknown;
+        [key: string]: unknown;
+    };
+};
+export declare const matrixDeliveryPayloadSchema: z.ZodType<MatrixDeliveryPayload, z.ZodTypeDef, unknown>;
+/** Inputs are already resolved by the host; schedules materialize relative dates
+ * before calling this builder. No authentication or temporal resolution here. */
+export declare function buildMatrixDeliveryEnvelope<TSource extends {
+    connectionId: string;
+}, TFilters, TControls extends object>(input: {
+    dashboardId: string;
+    cardId: string;
+    title: string;
+    matrix: MatrixExportRequest;
+    dataSource: TSource;
+    activeFilters: TFilters;
+    controls: TControls;
+    reportContext: ReportRuntimeContext;
+    delimiter: ',' | ';' | '\t';
+    includeHeaders: boolean;
+}): TControls & {
+    type: "card";
+    dashboardId: string;
+    cardId: string;
+    title: string;
+    cardType: "matrixTable";
+    resultOwner: "config";
+    sql: string;
+    python: string;
+    connection_id: string;
+    cardDataSource: TSource & {
+        mode: "database" | "semanticDomain";
+        semanticDomainId: string | undefined;
+    };
+    active_filters: TFilters;
+    formatOptions: {
+        matrix: {
+            mode: "layout";
+            presentation: {
+                totals: {
+                    columns: {
+                        grand: {
+                            visible: boolean;
+                            position: "before" | "after";
+                            label?: string | undefined;
+                        };
+                        levels: Readonly<Record<string, {
+                            visible: boolean;
+                            position: "before" | "after";
+                            label?: string | undefined;
+                        }>>;
+                    };
+                    rows: {
+                        grand: {
+                            visible: boolean;
+                            position: "before" | "after";
+                            label?: string | undefined;
+                        };
+                        levels: Readonly<Record<string, {
+                            visible: boolean;
+                            position: "before" | "after";
+                            label?: string | undefined;
+                        }>>;
+                    };
+                };
+                layout: {
+                    kind: "compact";
+                } | {
+                    kind: "tabular";
+                    repeatLabels: boolean;
+                };
+                absence: {
+                    emptyText: string;
+                    nullText: string;
+                };
+                levelLabels: Readonly<Record<string, string>>;
+                measureLabels: Readonly<Record<string, string>>;
+                levelFormats: Readonly<Record<string, import('../analytics-protocol/index.js').TemporalBucketFormat | {
+                    type: "date" | "datetime";
+                    pattern?: string | undefined;
+                    locale?: string | undefined;
+                    prefix?: string | undefined;
+                    suffix?: string | undefined;
+                    relative?: boolean | undefined;
+                    timezone?: string | undefined;
+                    sourceTimezone?: string | undefined;
+                } | {
+                    type: "duration";
+                    prefix?: string | undefined;
+                    suffix?: string | undefined;
+                    negativeStyle?: "minus" | "parentheses" | undefined;
+                    inputUnit?: "second" | "minute" | "hour" | "day" | "millisecond" | undefined;
+                    outputStyle?: "compact" | "digital" | "long" | undefined;
+                    largestUnit?: "second" | "minute" | "hour" | "day" | "millisecond" | undefined;
+                    smallestUnit?: "second" | "minute" | "hour" | "day" | "millisecond" | undefined;
+                    maxUnits?: number | undefined;
+                } | {
+                    type: "string";
+                    prefix?: string | undefined;
+                    suffix?: string | undefined;
+                } | {
+                    type: "number" | "currency" | "percent" | "percentage" | "scientific";
+                    currency?: string | undefined;
+                    minimumFractionDigits?: number | undefined;
+                    maximumFractionDigits?: number | undefined;
+                    useGrouping?: boolean | undefined;
+                    prefix?: string | undefined;
+                    suffix?: string | undefined;
+                    negativeStyle?: "minus" | "parentheses" | undefined;
+                    compact?: boolean | undefined;
+                    scale?: number | undefined;
+                    percentValueMode?: "fraction" | "whole" | undefined;
+                }>>;
+                measureFormats: Readonly<Record<string, import('../analytics-protocol/index.js').TemporalBucketFormat | {
+                    type: "date" | "datetime";
+                    pattern?: string | undefined;
+                    locale?: string | undefined;
+                    prefix?: string | undefined;
+                    suffix?: string | undefined;
+                    relative?: boolean | undefined;
+                    timezone?: string | undefined;
+                    sourceTimezone?: string | undefined;
+                } | {
+                    type: "duration";
+                    prefix?: string | undefined;
+                    suffix?: string | undefined;
+                    negativeStyle?: "minus" | "parentheses" | undefined;
+                    inputUnit?: "second" | "minute" | "hour" | "day" | "millisecond" | undefined;
+                    outputStyle?: "compact" | "digital" | "long" | undefined;
+                    largestUnit?: "second" | "minute" | "hour" | "day" | "millisecond" | undefined;
+                    smallestUnit?: "second" | "minute" | "hour" | "day" | "millisecond" | undefined;
+                    maxUnits?: number | undefined;
+                } | {
+                    type: "string";
+                    prefix?: string | undefined;
+                    suffix?: string | undefined;
+                } | {
+                    type: "number" | "currency" | "percent" | "percentage" | "scientific";
+                    currency?: string | undefined;
+                    minimumFractionDigits?: number | undefined;
+                    maximumFractionDigits?: number | undefined;
+                    useGrouping?: boolean | undefined;
+                    prefix?: string | undefined;
+                    suffix?: string | undefined;
+                    negativeStyle?: "minus" | "parentheses" | undefined;
+                    compact?: boolean | undefined;
+                    scale?: number | undefined;
+                    percentValueMode?: "fraction" | "whole" | undefined;
+                }>>;
+                conditionalFormatting?: {
+                    version: 1;
+                    rules: {
+                        id: string;
+                        target: {
+                            level: "row" | "cell";
+                            matrix?: {
+                                axis: "columns" | "rows";
+                                levelId?: string | undefined;
+                                oppositePath?: {
+                                    member: {
+                                        value: string | number | boolean | {
+                                            value: string;
+                                            type: "integer" | "decimal";
+                                            kind: "exact_number";
+                                        } | null;
+                                        kind: "value";
+                                    } | {
+                                        kind: "others";
+                                        rankingId: string;
+                                    };
+                                    levelId: string;
+                                }[] | undefined;
+                            } | undefined;
+                            columnIds?: string[] | undefined;
+                            conditionColumnId?: string | undefined;
+                            applyToColumnIds?: string[] | undefined;
+                            tableParts?: ("subtotal" | "body" | "header" | "footer" | "grandTotal")[] | undefined;
+                            rowRoles?: ("member" | "subtotal" | "grand_total" | "others")[] | undefined;
+                            depth?: number | undefined;
+                            includeTotals?: boolean | undefined;
+                            includeSubtotals?: boolean | undefined;
+                        };
+                        condition: {
+                            value: string | number | boolean | {
+                                value: string;
+                                type: "integer" | "decimal";
+                                kind: "exact_number";
+                            } | null;
+                            kind: "comparison";
+                            operator: "eq" | "neq" | "gt" | "gte" | "lt" | "lte";
+                            columnId: string;
+                        } | {
+                            kind: "between";
+                            columnId: string;
+                            min: string | number | boolean | {
+                                value: string;
+                                type: "integer" | "decimal";
+                                kind: "exact_number";
+                            } | null;
+                            max: string | number | boolean | {
+                                value: string;
+                                type: "integer" | "decimal";
+                                kind: "exact_number";
+                            } | null;
+                            inclusive?: boolean | undefined;
+                        } | {
+                            kind: "blank";
+                            columnId: string;
+                            isBlank: boolean;
+                        } | {
+                            value: string;
+                            kind: "contains";
+                            columnId: string;
+                            exact?: boolean | undefined;
+                            caseSensitive?: boolean | undefined;
+                        } | {
+                            kind: "topBottom";
+                            count: number;
+                            columnId: string;
+                            direction: "top" | "bottom";
+                        } | {
+                            kind: "colorScale";
+                            columnId: string;
+                            range: "auto" | "manual";
+                            colors: {
+                                min: string;
+                                max: string;
+                                mid?: string | undefined;
+                            };
+                            min?: number | undefined;
+                            max?: number | undefined;
+                            mid?: number | undefined;
+                        } | {
+                            kind: "dataBar";
+                            columnId: string;
+                            range: "auto" | "manual";
+                            color: string;
+                            min?: number | undefined;
+                            max?: number | undefined;
+                            showValue?: boolean | undefined;
+                        };
+                        name?: string | undefined;
+                        enabled?: boolean | undefined;
+                        style?: {
+                            dataBar?: {
+                                color: string;
+                                showValue: boolean;
+                            } | undefined;
+                            backgroundColor?: string | undefined;
+                            textColor?: string | undefined;
+                            fontWeight?: "normal" | "medium" | "semibold" | "bold" | undefined;
+                            italic?: boolean | undefined;
+                            textDecoration?: "none" | "underline" | "line-through" | undefined;
+                            icon?: "arrowUp" | "arrowDown" | "warning" | "check" | "x" | undefined;
+                        } | undefined;
+                    }[];
+                } | undefined;
+            };
+            format: "csv" | "xlsx" | "pdf";
+            spec: {
+                source: {
+                    kind: "semantic";
+                    domainId: string;
+                    datasetName: string;
+                    datasetId?: string | undefined;
+                    label?: string | undefined;
+                    connectionId?: string | undefined;
+                } | {
+                    kind: "physical";
+                    connectionId: string;
+                    tableName: string;
+                    label?: string | undefined;
+                    connectionType?: string | undefined;
+                    databaseName?: string | undefined;
+                    schemaName?: string | undefined;
+                    dialect?: "postgres" | "mysql" | "mssql" | "snowflake" | "clickhouse" | "bigquery" | "redshift" | "duckdb" | "sqlite" | "unknown" | undefined;
+                };
+                columns: readonly import('../analytics-protocol/index.js').MatrixLevel[];
+                measures: readonly ({
+                    id: string;
+                    kind: "aggregate";
+                    aggregate: "SUM" | "COUNT" | "AVG" | "MIN" | "MAX" | "DISTINCT";
+                    field: Omit<import('../analytics-protocol/index.js').SemaphorExecutionFieldRef, "source" | "aggregate" | "derivedField"> & {
+                        source?: import('../analytics-protocol/index.js').SemaphorMatrixSourceRef;
+                        derivedField?: Omit<import('../analytics-protocol/index.js').SemaphorDerivedFieldDefinition, "inputs"> & {
+                            inputs: Record<string, {
+                                kind: "field";
+                                field: Omit<import('../analytics-protocol/index.js').SemaphorFieldRef, "source"> & {
+                                    source?: import('../analytics-protocol/index.js').SemaphorMatrixSourceRef;
+                                };
+                                aggregate?: import('../analytics-protocol/index.js').SemaphorAggregateFunction;
+                            }>;
+                        };
+                    };
+                } | {
+                    id: string;
+                    kind: "calculated";
+                    definition: Omit<import('../analytics-protocol/index.js').SemaphorDerivedFieldDefinition, "inputs"> & {
+                        inputs: Record<string, {
+                            kind: "field";
+                            field: Omit<import('../analytics-protocol/index.js').SemaphorFieldRef, "source"> & {
+                                source?: import('../analytics-protocol/index.js').SemaphorMatrixSourceRef;
+                            };
+                            aggregate?: import('../analytics-protocol/index.js').SemaphorAggregateFunction;
+                        }>;
+                    };
+                })[];
+                rows: readonly import('../analytics-protocol/index.js').MatrixLevel[];
+                sorts: readonly {
+                    target: import('../analytics-protocol/index.js').MatrixSortTarget;
+                    scope: {
+                        kind: "level";
+                    } | {
+                        kind: "branch";
+                        parent: readonly {
+                            member: {
+                                value: string | number | boolean | {
+                                    value: string;
+                                    type: "integer" | "decimal";
+                                    kind: "exact_number";
+                                } | null;
+                                kind: "value";
+                            } | {
+                                kind: "others";
+                                rankingId: string;
+                            };
+                            levelId: string;
+                        }[];
+                    };
+                    levelId: string;
+                    axis: "columns" | "rows";
+                    direction: "asc" | "desc";
+                    nulls: "first" | "last";
+                }[];
+                rankings: readonly import('../analytics-protocol/index.js').MatrixRanking[];
+                filters?: import('../../components/index.js').FilterGroup | undefined;
+                joinPlan?: import('../../components/index.js').JoinPlan | undefined;
+                relationshipHint?: {
+                    relationshipIds?: string[] | undefined;
+                } | undefined;
+            };
+            expansion: {
+                kind: "current";
+                columns: {
+                    depth: number;
+                    overrides: readonly {
+                        path: readonly {
+                            member: {
+                                value: string | number | boolean | {
+                                    value: string;
+                                    type: "integer" | "decimal";
+                                    kind: "exact_number";
+                                } | null;
+                                kind: "value";
+                            } | {
+                                kind: "others";
+                                rankingId: string;
+                            };
+                            levelId: string;
+                        }[];
+                        expanded: boolean;
+                    }[];
+                };
+                rows: {
+                    depth: number;
+                    overrides: readonly {
+                        path: readonly {
+                            member: {
+                                value: string | number | boolean | {
+                                    value: string;
+                                    type: "integer" | "decimal";
+                                    kind: "exact_number";
+                                } | null;
+                                kind: "value";
+                            } | {
+                                kind: "others";
+                                rankingId: string;
+                            };
+                            levelId: string;
+                        }[];
+                        expanded: boolean;
+                    }[];
+                };
+            } | {
+                kind: "all";
+            };
+        } | {
+            mode: "flat";
+            presentation: {
+                totals: {
+                    columns: {
+                        grand: {
+                            visible: boolean;
+                            position: "before" | "after";
+                            label?: string | undefined;
+                        };
+                        levels: Readonly<Record<string, {
+                            visible: boolean;
+                            position: "before" | "after";
+                            label?: string | undefined;
+                        }>>;
+                    };
+                    rows: {
+                        grand: {
+                            visible: boolean;
+                            position: "before" | "after";
+                            label?: string | undefined;
+                        };
+                        levels: Readonly<Record<string, {
+                            visible: boolean;
+                            position: "before" | "after";
+                            label?: string | undefined;
+                        }>>;
+                    };
+                };
+                layout: {
+                    kind: "compact";
+                } | {
+                    kind: "tabular";
+                    repeatLabels: boolean;
+                };
+                absence: {
+                    emptyText: string;
+                    nullText: string;
+                };
+                levelLabels: Readonly<Record<string, string>>;
+                measureLabels: Readonly<Record<string, string>>;
+                levelFormats: Readonly<Record<string, import('../analytics-protocol/index.js').TemporalBucketFormat | {
+                    type: "date" | "datetime";
+                    pattern?: string | undefined;
+                    locale?: string | undefined;
+                    prefix?: string | undefined;
+                    suffix?: string | undefined;
+                    relative?: boolean | undefined;
+                    timezone?: string | undefined;
+                    sourceTimezone?: string | undefined;
+                } | {
+                    type: "duration";
+                    prefix?: string | undefined;
+                    suffix?: string | undefined;
+                    negativeStyle?: "minus" | "parentheses" | undefined;
+                    inputUnit?: "second" | "minute" | "hour" | "day" | "millisecond" | undefined;
+                    outputStyle?: "compact" | "digital" | "long" | undefined;
+                    largestUnit?: "second" | "minute" | "hour" | "day" | "millisecond" | undefined;
+                    smallestUnit?: "second" | "minute" | "hour" | "day" | "millisecond" | undefined;
+                    maxUnits?: number | undefined;
+                } | {
+                    type: "string";
+                    prefix?: string | undefined;
+                    suffix?: string | undefined;
+                } | {
+                    type: "number" | "currency" | "percent" | "percentage" | "scientific";
+                    currency?: string | undefined;
+                    minimumFractionDigits?: number | undefined;
+                    maximumFractionDigits?: number | undefined;
+                    useGrouping?: boolean | undefined;
+                    prefix?: string | undefined;
+                    suffix?: string | undefined;
+                    negativeStyle?: "minus" | "parentheses" | undefined;
+                    compact?: boolean | undefined;
+                    scale?: number | undefined;
+                    percentValueMode?: "fraction" | "whole" | undefined;
+                }>>;
+                measureFormats: Readonly<Record<string, import('../analytics-protocol/index.js').TemporalBucketFormat | {
+                    type: "date" | "datetime";
+                    pattern?: string | undefined;
+                    locale?: string | undefined;
+                    prefix?: string | undefined;
+                    suffix?: string | undefined;
+                    relative?: boolean | undefined;
+                    timezone?: string | undefined;
+                    sourceTimezone?: string | undefined;
+                } | {
+                    type: "duration";
+                    prefix?: string | undefined;
+                    suffix?: string | undefined;
+                    negativeStyle?: "minus" | "parentheses" | undefined;
+                    inputUnit?: "second" | "minute" | "hour" | "day" | "millisecond" | undefined;
+                    outputStyle?: "compact" | "digital" | "long" | undefined;
+                    largestUnit?: "second" | "minute" | "hour" | "day" | "millisecond" | undefined;
+                    smallestUnit?: "second" | "minute" | "hour" | "day" | "millisecond" | undefined;
+                    maxUnits?: number | undefined;
+                } | {
+                    type: "string";
+                    prefix?: string | undefined;
+                    suffix?: string | undefined;
+                } | {
+                    type: "number" | "currency" | "percent" | "percentage" | "scientific";
+                    currency?: string | undefined;
+                    minimumFractionDigits?: number | undefined;
+                    maximumFractionDigits?: number | undefined;
+                    useGrouping?: boolean | undefined;
+                    prefix?: string | undefined;
+                    suffix?: string | undefined;
+                    negativeStyle?: "minus" | "parentheses" | undefined;
+                    compact?: boolean | undefined;
+                    scale?: number | undefined;
+                    percentValueMode?: "fraction" | "whole" | undefined;
+                }>>;
+                conditionalFormatting?: {
+                    version: 1;
+                    rules: {
+                        id: string;
+                        target: {
+                            level: "row" | "cell";
+                            matrix?: {
+                                axis: "columns" | "rows";
+                                levelId?: string | undefined;
+                                oppositePath?: {
+                                    member: {
+                                        value: string | number | boolean | {
+                                            value: string;
+                                            type: "integer" | "decimal";
+                                            kind: "exact_number";
+                                        } | null;
+                                        kind: "value";
+                                    } | {
+                                        kind: "others";
+                                        rankingId: string;
+                                    };
+                                    levelId: string;
+                                }[] | undefined;
+                            } | undefined;
+                            columnIds?: string[] | undefined;
+                            conditionColumnId?: string | undefined;
+                            applyToColumnIds?: string[] | undefined;
+                            tableParts?: ("subtotal" | "body" | "header" | "footer" | "grandTotal")[] | undefined;
+                            rowRoles?: ("member" | "subtotal" | "grand_total" | "others")[] | undefined;
+                            depth?: number | undefined;
+                            includeTotals?: boolean | undefined;
+                            includeSubtotals?: boolean | undefined;
+                        };
+                        condition: {
+                            value: string | number | boolean | {
+                                value: string;
+                                type: "integer" | "decimal";
+                                kind: "exact_number";
+                            } | null;
+                            kind: "comparison";
+                            operator: "eq" | "neq" | "gt" | "gte" | "lt" | "lte";
+                            columnId: string;
+                        } | {
+                            kind: "between";
+                            columnId: string;
+                            min: string | number | boolean | {
+                                value: string;
+                                type: "integer" | "decimal";
+                                kind: "exact_number";
+                            } | null;
+                            max: string | number | boolean | {
+                                value: string;
+                                type: "integer" | "decimal";
+                                kind: "exact_number";
+                            } | null;
+                            inclusive?: boolean | undefined;
+                        } | {
+                            kind: "blank";
+                            columnId: string;
+                            isBlank: boolean;
+                        } | {
+                            value: string;
+                            kind: "contains";
+                            columnId: string;
+                            exact?: boolean | undefined;
+                            caseSensitive?: boolean | undefined;
+                        } | {
+                            kind: "topBottom";
+                            count: number;
+                            columnId: string;
+                            direction: "top" | "bottom";
+                        } | {
+                            kind: "colorScale";
+                            columnId: string;
+                            range: "auto" | "manual";
+                            colors: {
+                                min: string;
+                                max: string;
+                                mid?: string | undefined;
+                            };
+                            min?: number | undefined;
+                            max?: number | undefined;
+                            mid?: number | undefined;
+                        } | {
+                            kind: "dataBar";
+                            columnId: string;
+                            range: "auto" | "manual";
+                            color: string;
+                            min?: number | undefined;
+                            max?: number | undefined;
+                            showValue?: boolean | undefined;
+                        };
+                        name?: string | undefined;
+                        enabled?: boolean | undefined;
+                        style?: {
+                            dataBar?: {
+                                color: string;
+                                showValue: boolean;
+                            } | undefined;
+                            backgroundColor?: string | undefined;
+                            textColor?: string | undefined;
+                            fontWeight?: "normal" | "medium" | "semibold" | "bold" | undefined;
+                            italic?: boolean | undefined;
+                            textDecoration?: "none" | "underline" | "line-through" | undefined;
+                            icon?: "arrowUp" | "arrowDown" | "warning" | "check" | "x" | undefined;
+                        } | undefined;
+                    }[];
+                } | undefined;
+            };
+            format: "csv";
+            spec: {
+                source: {
+                    kind: "semantic";
+                    domainId: string;
+                    datasetName: string;
+                    datasetId?: string | undefined;
+                    label?: string | undefined;
+                    connectionId?: string | undefined;
+                } | {
+                    kind: "physical";
+                    connectionId: string;
+                    tableName: string;
+                    label?: string | undefined;
+                    connectionType?: string | undefined;
+                    databaseName?: string | undefined;
+                    schemaName?: string | undefined;
+                    dialect?: "postgres" | "mysql" | "mssql" | "snowflake" | "clickhouse" | "bigquery" | "redshift" | "duckdb" | "sqlite" | "unknown" | undefined;
+                };
+                columns: readonly import('../analytics-protocol/index.js').MatrixLevel[];
+                measures: readonly ({
+                    id: string;
+                    kind: "aggregate";
+                    aggregate: "SUM" | "COUNT" | "AVG" | "MIN" | "MAX" | "DISTINCT";
+                    field: Omit<import('../analytics-protocol/index.js').SemaphorExecutionFieldRef, "source" | "aggregate" | "derivedField"> & {
+                        source?: import('../analytics-protocol/index.js').SemaphorMatrixSourceRef;
+                        derivedField?: Omit<import('../analytics-protocol/index.js').SemaphorDerivedFieldDefinition, "inputs"> & {
+                            inputs: Record<string, {
+                                kind: "field";
+                                field: Omit<import('../analytics-protocol/index.js').SemaphorFieldRef, "source"> & {
+                                    source?: import('../analytics-protocol/index.js').SemaphorMatrixSourceRef;
+                                };
+                                aggregate?: import('../analytics-protocol/index.js').SemaphorAggregateFunction;
+                            }>;
+                        };
+                    };
+                } | {
+                    id: string;
+                    kind: "calculated";
+                    definition: Omit<import('../analytics-protocol/index.js').SemaphorDerivedFieldDefinition, "inputs"> & {
+                        inputs: Record<string, {
+                            kind: "field";
+                            field: Omit<import('../analytics-protocol/index.js').SemaphorFieldRef, "source"> & {
+                                source?: import('../analytics-protocol/index.js').SemaphorMatrixSourceRef;
+                            };
+                            aggregate?: import('../analytics-protocol/index.js').SemaphorAggregateFunction;
+                        }>;
+                    };
+                })[];
+                rows: readonly import('../analytics-protocol/index.js').MatrixLevel[];
+                sorts: readonly {
+                    target: import('../analytics-protocol/index.js').MatrixSortTarget;
+                    scope: {
+                        kind: "level";
+                    } | {
+                        kind: "branch";
+                        parent: readonly {
+                            member: {
+                                value: string | number | boolean | {
+                                    value: string;
+                                    type: "integer" | "decimal";
+                                    kind: "exact_number";
+                                } | null;
+                                kind: "value";
+                            } | {
+                                kind: "others";
+                                rankingId: string;
+                            };
+                            levelId: string;
+                        }[];
+                    };
+                    levelId: string;
+                    axis: "columns" | "rows";
+                    direction: "asc" | "desc";
+                    nulls: "first" | "last";
+                }[];
+                rankings: readonly import('../analytics-protocol/index.js').MatrixRanking[];
+                filters?: import('../../components/index.js').FilterGroup | undefined;
+                joinPlan?: import('../../components/index.js').JoinPlan | undefined;
+                relationshipHint?: {
+                    relationshipIds?: string[] | undefined;
+                } | undefined;
+            };
+        };
+        delimiter: "," | ";" | "\t";
+        includeHeaders: boolean;
+        timezone: string;
+        presentationExecutionSnapshot: import('../format-utils/index.js').PresentationExecutionSnapshot;
+        acquisition?: "continuation" | undefined;
+    };
+};