react-semaphor 0.1.514 → 0.1.516

package/dist/types/shared/format-utils/matrix-export-presentation.d.ts

@@ -5,8 +5,16 @@ import { FastPathTableStructure } from './table-structure.js';
 export declare function prepareMatrixExportPresentation(layout: MatrixExportLayout, request: MatrixExportRequest, report: ReportRuntimeContext): {
     headers: string[];
     headerBands: string[][];
-    row: (data: MatrixExportRow) => string[];
     numericColumns: boolean[];
+    /** A row's cells; after `previous`, a tabular layout prints each label once. */
+    row: (data: MatrixExportRow, previous?: MatrixExportRow) => string[];
+    /**
+     * Level columns whose group label the row above shows, so this row
+     * continues the group (Plan 2, 2d, C8). Only a member row after a member
+     * row continues one: a total prints as a band, and its rules stay whole
+     * above and below it.
+     */
+    continuedColumns: (data: MatrixExportRow, previous?: MatrixExportRow) => number[];
     csvRow: (data: MatrixExportRow) => string[];
     csvRows: (data: readonly MatrixExportRow[]) => string[][];
 };
@@ -20,3 +28,684 @@ export declare function buildMatrixTableStructure(input: {
     rows: readonly MatrixExportRow[];
     report: ReportRuntimeContext;
 }): FastPathTableStructure;
+/**
+ * The table every Matrix PDF prints, Documents and the single-card PDF alike
+ * (Plan 2, 2d, C3). Unformatted numbers get the print defaults, each label
+ * prints once as the layout asks, each row says whether it keeps with the row
+ * before it (P6), and the metadata names the column groups bands keep
+ * together. `request` carries the print presentation the table was formatted
+ * with. The row organization is the caller's (`applyMatrixPrintOrganization`),
+ * because it decides which rows the traversal returns.
+ */
+export declare function buildMatrixPrintTable(input: {
+    layout: MatrixExportLayout;
+    request: MatrixExportRequest;
+    rows: readonly MatrixExportRow[];
+    report: ReportRuntimeContext;
+}): {
+    columnGroups: (number | null)[];
+    groupLabels: string[];
+    /** What bands name their groups by: the innermost column level, or "Measures". */
+    groupLevelLabel: string;
+    request: {
+        presentation: {
+            totals: {
+                columns: {
+                    grand: {
+                        visible: boolean;
+                        position: "before" | "after";
+                        label?: string | undefined;
+                    };
+                    levels: Readonly<Record<string, {
+                        visible: boolean;
+                        position: "before" | "after";
+                        label?: string | undefined;
+                    }>>;
+                    skipRedundant?: boolean | undefined;
+                };
+                rows: {
+                    grand: {
+                        visible: boolean;
+                        position: "before" | "after";
+                        label?: string | undefined;
+                    };
+                    levels: Readonly<Record<string, {
+                        visible: boolean;
+                        position: "before" | "after";
+                        label?: string | undefined;
+                    }>>;
+                    skipRedundant?: boolean | 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;
+        };
+        mode: "layout";
+        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";
+        };
+    } | {
+        presentation: {
+            totals: {
+                columns: {
+                    grand: {
+                        visible: boolean;
+                        position: "before" | "after";
+                        label?: string | undefined;
+                    };
+                    levels: Readonly<Record<string, {
+                        visible: boolean;
+                        position: "before" | "after";
+                        label?: string | undefined;
+                    }>>;
+                    skipRedundant?: boolean | undefined;
+                };
+                rows: {
+                    grand: {
+                        visible: boolean;
+                        position: "before" | "after";
+                        label?: string | undefined;
+                    };
+                    levels: Readonly<Record<string, {
+                        visible: boolean;
+                        position: "before" | "after";
+                        label?: string | undefined;
+                    }>>;
+                    skipRedundant?: boolean | 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;
+        };
+        mode: "flat";
+        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;
+        };
+    };
+    table: FastPathTableStructure;
+};