react-semaphor 0.1.515 → 0.1.516

package/dist/types/lib/query-context/build-dashboard-frame-base-query-contexts.d.ts

@@ -3,6 +3,7 @@ import { TFilter, TFilterValue } from '../../components/surfboard/filter/types.j
 import { ControlDefinition, DashboardInputValues, TCard, TDashboard, TFrame } from '../types/common-types.js';
 import { TransientInputContext } from '../dashboard-inputs/transient-input-context.js';
 import { CardQueryContext } from './build-card-query-context.js';
+import { CardExecution } from './card-execution.js';
 export type DashboardFrameDocumentQueryState = {
     isExplicitDocumentSectionRuntime: boolean;
     isDocumentSectionEditing: boolean;
@@ -41,7 +42,8 @@ export type BuildDashboardFrameBaseQueryContextsParams = {
     cardViewStates: CardViewStateMap | undefined;
     filteringCards?: TCard[];
     selectedSheetId?: string | null;
-    isVisualEditing: boolean;
+    /** How this call's queries run (tech spec M7). */
+    execution: CardExecution;
     getCardFrame: (cardId: string) => TFrame | undefined;
     lastRequestPayloadMap?: Map<string, Record<string, unknown>>;
     documentState: DashboardFrameDocumentQueryState;
@@ -55,4 +57,4 @@ export type DashboardFrameBaseQueryContext = CardQueryContext & {
     missingRequiredInputLabels: string[];
     dashboardInputMissingRequiredLabels: string[];
 };
-export declare function buildDashboardFrameBaseQueryContexts({ cards, dashboard, filters, dashboardControls, filterValues, controlValues, dashboardInputValues, dashboardInlineFilterValuesMap, editorInlineFilterValuesMap, dashboardCardControlValuesMap, transientContexts, cardViewStates, filteringCards, selectedSheetId, isVisualEditing, getCardFrame, lastRequestPayloadMap, documentState, }: BuildDashboardFrameBaseQueryContextsParams): DashboardFrameBaseQueryContext[];
+export declare function buildDashboardFrameBaseQueryContexts({ cards, dashboard, filters, dashboardControls, filterValues, controlValues, dashboardInputValues, dashboardInlineFilterValuesMap, editorInlineFilterValuesMap, dashboardCardControlValuesMap, transientContexts, cardViewStates, filteringCards, selectedSheetId, execution, getCardFrame, lastRequestPayloadMap, documentState, }: BuildDashboardFrameBaseQueryContextsParams): DashboardFrameBaseQueryContext[];

package/dist/types/lib/query-context/card-execution.d.ts

@@ -0,0 +1,30 @@
+import { SemanticExecutionPayloadAuthority } from './use-semantic-execution-payload-for-cards.js';
+/**
+ * How one card's query runs, decided once per card (tech spec M7). Every gate
+ * in `useDashboardFrameQuery` and the base query-context builder reads this
+ * instead of the global `isVisualEditing` flag.
+ */
+export type CardExecution = {
+    /** The editor shows a failed query inline; a dashboard or report throws to its boundary. */
+    errorMode: 'throw' | 'inline';
+    refetchOnInterval: boolean;
+    /**
+     * `editor`: config cards run unless the editor is in dev mode, and dev mode
+     * uses the card's own connection. `runtime`: any card with a connection and
+     * SQL or a valid config runs.
+     */
+    gating: 'editor' | 'runtime';
+    /** `editor` waits for fresh semantic metadata before querying. */
+    metadataAuthority: SemanticExecutionPayloadAuthority;
+    /** `editorSnapshot`: the editor's inline filter values and the document inputs captured when it opened. */
+    inputSource: 'host' | 'editorSnapshot';
+};
+/**
+ * - `isEditorPreview`: the card renders inside `<Editor>`.
+ * - `requestedAuthority`: the caller's explicit choice. Inside the editor some
+ *   components query with runtime metadata, so it is kept as is.
+ */
+export declare function resolveCardExecution({ isEditorPreview, requestedAuthority, }: {
+    isEditorPreview: boolean;
+    requestedAuthority?: SemanticExecutionPayloadAuthority;
+}): CardExecution;

package/dist/types/lib/query-context/document-section-card-query.d.ts

@@ -0,0 +1,37 @@
+import { TFilterValue } from '../../components/surfboard/filter/types.js';
+import { DashboardInputRuntimeValues } from '../dashboard-inputs/resolve-dashboard-input-context.js';
+import { ControlDefinition, DashboardInputValues, TCard, TDashboard } from '../types/common-types.js';
+import { BuildCardQueryContextParams } from './build-card-query-context.js';
+/** What a Document sheet resolved for one section, as one card's query sees it. */
+export type DocumentSectionCardRuntime = {
+    sheetId: string | undefined;
+    sectionId: string | undefined;
+    documentFilterValues: TFilterValue[];
+    documentControlDefinitions: ControlDefinition[];
+    documentControlValues: Record<string, unknown>;
+    /** The page's own input values; the editor's query uses the dashboard's. */
+    documentDashboardInputValues?: DashboardInputValues;
+    /** The editor's card filters, for the editor's query of the card it edits. */
+    editorFilterValues?: TFilterValue[];
+    /** `editor` for the editor's query of the card it edits, else `print`. */
+    mode: 'print' | 'editor';
+};
+/**
+ * The `buildCardQueryContext` inputs for a card that runs as a Document
+ * section. A section is its own runtime:
+ * - nothing is carried in (no transient contexts, no drill state);
+ * - the dashboard's toolbar filters and controls do not apply;
+ * - the section's scoped dashboard inputs apply when the dashboard has any,
+ *   otherwise the document's filter and control values do.
+ *
+ * The one owner of these rules, for frame queries and the Matrix execution
+ * snapshot alike.
+ */
+export declare function buildDocumentSectionCardQueryParams({ card, dashboard, runtime, dashboardRuntimeValues, timezone, }: {
+    card: TCard;
+    dashboard: TDashboard;
+    runtime: DocumentSectionCardRuntime;
+    /** The dashboard's runtime values, which scoped input resolution reads. */
+    dashboardRuntimeValues: Omit<DashboardInputRuntimeValues, 'cardViewState'>;
+    timezone?: string;
+}): Omit<BuildCardQueryContextParams, 'selectedSheetId' | 'includeAuthoredFilters'>;

package/dist/types/lib/stores/dashboard-store.d.ts

@@ -6,6 +6,8 @@ import { DashboardAIContext } from '../types/assistant-types.js';
 import { FilterGroup, Field } from '../types/explorer-types.js';
 import { DashboardControlsModelOptions } from '../controls/control-authoring-types.js';
 import { SemanticExecutionPayload } from '../types/semantic-runtime-types.js';
+import { DocumentPanelTarget } from '../document/document-panel-target.js';
+import { DocumentEdit, DocumentEditResult } from '../document/document-edits.js';
 import { DocumentFilterMode } from '../document/document-input-runtime.js';
 import { DashboardInputRuntimeTarget } from '../dashboard-inputs/dashboard-input-values.js';
 import { DashboardFilterMappingAuthoringIssue, DashboardFilterInputAcceptanceResult, DashboardFilterMappingAcceptanceResult, DashboardFilterMappingAuthoringRequest, DashboardFilterMappingDisableResult } from '../dashboard-inputs/dashboard-filter-mapping-authoring.js';
@@ -61,8 +63,8 @@ export type DashboardStore = {
     selectedFrameId?: string | null;
     selectedCardId?: string | null;
     selectedCard?: TCard | null;
-    selectedDocumentSectionIdsBySheetId: Record<string, string | null>;
-    documentInspectorTabsBySheetId: Record<string, DocumentInspectorTab>;
+    /** What each Document sheet's side panel shows; also its section selection. */
+    documentPanelTargetBySheetId: Record<string, DocumentPanelTarget>;
     documentInputRuntimeBySheetId: Record<string, DocumentInputRuntimeState>;
     /**
      * Pending sheet-wide frame rewrites produced while visual editing. These stay
@@ -139,7 +141,6 @@ export type DashboardStore = {
     onRemoveCard?: (card: TCard, sheetId: string) => void;
     actions: Actions;
 };
-export type DocumentInspectorTab = 'section' | 'page' | 'header' | 'footer' | 'inputs';
 export type DocumentInputRuntimeState = {
     filterValuesByInputId: Record<string, TFilterValue | undefined>;
     filterModesByInputId: Record<string, DocumentFilterMode>;
@@ -227,11 +228,14 @@ type Actions = {
     deleteSheet: (sheetId: string) => void;
     setSheetTitle: (sheetId: string, title: string) => void;
     updateSheetDocument: (sheetId: string, updater: (document: DocumentDefinition) => DocumentDefinition) => void;
-    updateDocumentSectionCard: (sheetId: string, sectionId: string, card: TCard, options?: {
-        calculatedFields?: Field[];
-    }) => void;
-    setSelectedDocumentSectionId: (sheetId: string, sectionId: string | null) => void;
-    setDocumentInspectorTab: (sheetId: string, tab: DocumentInspectorTab) => void;
+    /**
+     * The one write for a Document's sections (see `applyDocumentEdit`).
+     * Persists the edited document, any sheet calculated fields a copy brought,
+     * and card reference cleanup. Throws `DocumentEditError` for a refused edit
+     * without changing state.
+     */
+    editDocument: (sheetId: string, edit: DocumentEdit) => DocumentEditResult;
+    setDocumentPanelTarget: (sheetId: string, target: DocumentPanelTarget) => void;
     setDocumentInputFilterValues: (sheetId: string, valuesByInputId: Record<string, TFilterValue | undefined>) => void;
     setDocumentInputFilterValue: (sheetId: string, inputId: string, filterValue: TFilterValue) => void;
     removeDocumentInputFilterValue: (sheetId: string, inputId: string) => void;

package/dist/types/lib/stores/editor-store.d.ts

@@ -28,6 +28,8 @@ export type EditorContext = {
     sheetId: string;
     sectionId: string;
     cardId: string;
+    /** The card type at open. The section's kind cannot change in the editor. */
+    lockedKind: TChartType;
     documentFilterValues?: TFilterValue[];
     documentControlDefinitions?: ControlDefinition[];
     documentControlValues?: Record<string, unknown>;

package/dist/types/lib/text-variables/text-variable-types.d.ts

@@ -0,0 +1,39 @@
+/** What kind of value a variable holds; picks the chip's icon. */
+export type TextVariableKind = 'filter' | 'date' | 'control' | 'report';
+/** How one variable reference reads as a chip. */
+export type TextVariableChipFace = {
+    /** The input's name ("State"), or "Missing input". */
+    name: string;
+    kind: TextVariableKind;
+    /** Shown after the name when the chip shows a part other than the default. */
+    partLabel?: string;
+    /** The reference points at an input that no longer exists. */
+    missing?: boolean;
+};
+/** One part of an input a chip can show, with what it holds now. */
+export type TextVariablePart = {
+    key: string;
+    label: string;
+    preview?: string;
+};
+/** One input (or report value) the picker offers. */
+export type TextVariableOption = {
+    id: string;
+    name: string;
+    kind: TextVariableKind;
+    parts: TextVariablePart[];
+    defaultPart: string;
+};
+/** What a chip shows: an option and one of its parts. */
+export type TextVariableSelection = {
+    optionId: string;
+    part: string;
+};
+export declare const TEXT_VARIABLE_PART_LABELS: Record<string, string>;
+/** The picker's groups, in order. */
+export declare function textVariableGroup(kind: TextVariableKind): "Filters" | "Controls" | "Report";
+/**
+ * Options whose name matches `query`, in the picker's order: filters, then
+ * controls, then report values.
+ */
+export declare function filterTextVariableOptions(options: readonly TextVariableOption[], query: string): TextVariableOption[];

package/dist/types/lib/types/common-types.d.ts

@@ -1435,7 +1435,7 @@ export type DocumentTextStyle = {
     color?: string;
     align?: 'left' | 'center' | 'right';
 };
-export type DocumentSection = DocumentTextSection | DocumentTableSection | DocumentChartSection | DocumentSpacerSection | DocumentPageBreakSection;
+export type DocumentSection = DocumentTextSection | DocumentTableSection | DocumentKpiSection | DocumentChartSection | DocumentSpacerSection | DocumentPageBreakSection;
 export type DocumentTextSection = {
     id: string;
     type: 'text';
@@ -1452,6 +1452,39 @@ export type DocumentTableSection = {
         columnFormatting?: Record<string, unknown>;
         repeatHeaderOnPageBreak?: boolean;
         rowHeightPx?: number;
+        /** Print nothing, and take no space, while the result is empty (Plan 2). */
+        hideWhenEmpty?: boolean;
+        /** Matrix sections only: how the Document prints the Matrix (Plan 2). */
+        matrix?: {
+            /** `tabular`: one column per row level. `outline`: one indented column. */
+            rowLabels?: 'tabular' | 'outline';
+            /** Where each group's subtotal prints. */
+            subtotals?: 'after' | 'before';
+            /**
+             * A Matrix too wide for the page prints in column bands. `across`: each
+             * slice of rows prints in every band before the next slice. `down`:
+             * each band runs through every row before the next band.
+             */
+            bandOrder?: 'across' | 'down';
+        };
+    };
+};
+/**
+ * Headline numbers. Each card is an ordinary `kpi` card with its own query.
+ * Read and rewrite its cards through `getDocumentSectionCards` and
+ * `mapDocumentSectionCards` (`react-semaphor/dashboard-authoring`).
+ */
+export type DocumentKpiSection = {
+    id: string;
+    type: 'kpi';
+    title?: string;
+    /** 1 to 8 cards, each `card.type === 'kpi'`, with unique ids. Order is display order. */
+    cards: TCard[];
+    kpi: {
+        /** `tiles` holds at most 6 cards; a section with more uses `lines`. */
+        layout: 'tiles' | 'lines';
+        /** Used by `lines`, default 2. Kept but ignored on `tiles`. */
+        columns?: 1 | 2;
     };
 };
 export type DocumentChartSection = {

package/dist/types/lib/utils/card-definition.d.ts

@@ -43,6 +43,7 @@ export declare function getCardDefinition(card: DefinitionCard, catalog?: Matrix
                         position: "before" | "after";
                         label?: string | undefined;
                     }>>;
+                    skipRedundant?: boolean | undefined;
                 };
                 rows: {
                     grand: {
@@ -55,6 +56,7 @@ export declare function getCardDefinition(card: DefinitionCard, catalog?: Matrix
                         position: "before" | "after";
                         label?: string | undefined;
                     }>>;
+                    skipRedundant?: boolean | undefined;
                 };
             };
             layout: {

package/dist/types/lib/utils/card-utils.d.ts

@@ -2,19 +2,20 @@ import { TDashboard, TCard, TSheet } from '../types/common-types.js';
 export type DashboardCardEntry = {
     card: TCard;
     sheet: TSheet;
-};
-export declare function getDashboardCardEntries(dashboard: Pick<TDashboard, 'sheets'>): DashboardCardEntry[];
-export type DashboardCardLocation = DashboardCardEntry & {
-    /** Set when the card is the visual of a document section. */
+    /** Set when the card sits in a frame. */
+    frameId?: string;
+    /** Set when the card belongs to a document section (a section may own several cards). */
     sectionId?: string;
 };
+/** Dashboard cards: sheet cards and frame cards. Document section cards are not included. */
+export declare function getDashboardCardEntries(dashboard: Pick<TDashboard, 'sheets'>): DashboardCardEntry[];
 /**
  * Every card a dashboard hosts, with where it sits: sheet cards, frame cards,
- * and the table or chart of a document section. Use this, not
+ * and every card of a document section. Use this, not
  * `getDashboardCardEntries`, when a card may be reached by a scope that names
  * document sections.
  */
-export declare function getDashboardCardLocations(dashboard: Pick<TDashboard, 'sheets'>): DashboardCardLocation[];
+export declare function getDashboardCardLocations(dashboard: Pick<TDashboard, 'sheets'>): DashboardCardEntry[];
 export declare function getDashboardCards(dashboard: Pick<TDashboard, 'sheets'>): TCard[];
 /**
  * Check if a card ID is unique across the entire dashboard
@@ -53,6 +54,12 @@ export declare function getAllCardIds(dashboard: TDashboard): string[];
  * @returns The card if found, undefined otherwise
  */
 export declare function findCardById(dashboard: TDashboard, cardId: string): TCard | undefined;
+/**
+ * A dashboard card (sheet or frame) by id. Document section cards are not
+ * included: they need their section for input resolution, so they are found
+ * through section-aware lookups (for example the dashboard input snapshot's
+ * section targets). Phase 1.2 routes KPI card execution through those.
+ */
 export declare function findCardLocationById(dashboard: TDashboard, cardId: string): {
     card: TCard;
     sheet: TSheet;

package/dist/types/pdf-table-layout.d.ts

@@ -0,0 +1,2 @@
+export * from './shared/format-utils/pdf-table-layout/index.js'
+export {}

package/dist/types/shared/analytics-protocol/index.d.ts

@@ -26,7 +26,7 @@ export * from './matrix-window-contract.js';
 export * from './matrix-member-presentation.js';
 export { matrixFormattingRoleSchema, type MatrixFormattingRole } from './matrix-path-contract.js';
 export { getMatrixAnalyticalDefinition } from './matrix-analytical-definition.js';
-export { matrixAxisSchema, matrixAggregateSchema, matrixFieldSchema, matrixLevelSchema, matrixMeasureSchema, matrixMemberSchema, matrixPathSchema, matrixCoordinateSchema, matrixSortTargetSchema, matrixSortSchema, matrixRankingSchema, matrixPathKey, matrixSortKey, matrixSpecSchema, matrixTotalPresentationSchema, matrixPresentationSchema, matrixExpansionSchema, matrixDefaultViewSchema, matrixViewStateSchema, matrixDefinitionInputSchema, matrixConfigSchema, matrixExportRequestSchema, } from './matrix-definition-contract.js';
+export { matrixAxisSchema, matrixAggregateSchema, matrixFieldSchema, matrixLevelSchema, matrixMeasureSchema, matrixMemberSchema, matrixPathSchema, matrixCoordinateSchema, matrixSortTargetSchema, matrixSortSchema, matrixRankingSchema, matrixPathKey, matrixSortKey, matrixSpecSchema, matrixTotalPresentationSchema, MATRIX_TOTAL_MEMBER_PLACEHOLDER, matrixPresentationSchema, matrixExpansionSchema, matrixDefaultViewSchema, matrixViewStateSchema, matrixDefinitionInputSchema, matrixConfigSchema, matrixExportRequestSchema, } from './matrix-definition-contract.js';
 export type { MatrixLevelId, MatrixMeasureId, MatrixAxis, MatrixAggregate, MatrixField, MatrixLevel, MatrixMeasure, MatrixMember, MatrixPath, MatrixCoordinate, MatrixSortTarget, MatrixSort, MatrixRanking, MatrixSpec, MatrixTotalPresentation, MatrixPresentation, MatrixExpansion, MatrixViewState, MatrixConfig, MatrixDefinitionInput, MatrixExportRequest, } from './matrix-definition-contract.js';
 export * from './matrix-operation-contract.js';
 export { configSourceRefSchema } from './execution-input-schemas.js';

package/dist/types/shared/analytics-protocol/matrix-definition-contract.d.ts

@@ -794,9 +794,12 @@ declare const analyticalIntentShape: z.ZodObject<{
 type MatrixAnalyticalIntentSchema = z.ZodEffects<typeof analyticalIntentShape>;
 /** Analytical definition only; acquisition windows are sibling operation inputs. */
 export declare const matrixAnalyticalIntentSchema: MatrixAnalyticalIntentSchema;
+/** The placeholder a subtotal label uses for its member's name. */
+export declare const MATRIX_TOTAL_MEMBER_PLACEHOLDER = "{member}";
 export declare const matrixTotalPresentationSchema: z.ZodObject<{
     visible: z.ZodBoolean;
     position: z.ZodEnum<["before", "after"]>;
+    /** As written; a subtotal's `{member}` becomes its member's name. */
     label: z.ZodOptional<z.ZodString>;
 }, "strict", z.ZodTypeAny, {
     visible: boolean;
@@ -2255,6 +2258,7 @@ declare const presentationFields: {
             grand: z.ZodObject<{
                 visible: z.ZodBoolean;
                 position: z.ZodEnum<["before", "after"]>;
+                /** As written; a subtotal's `{member}` becomes its member's name. */
                 label: z.ZodOptional<z.ZodString>;
             }, "strict", z.ZodTypeAny, {
                 visible: boolean;
@@ -2268,6 +2272,7 @@ declare const presentationFields: {
             levels: z.ZodReadonly<z.ZodRecord<z.ZodString, z.ZodObject<{
                 visible: z.ZodBoolean;
                 position: z.ZodEnum<["before", "after"]>;
+                /** As written; a subtotal's `{member}` becomes its member's name. */
                 label: z.ZodOptional<z.ZodString>;
             }, "strict", z.ZodTypeAny, {
                 visible: boolean;
@@ -2278,6 +2283,11 @@ declare const presentationFields: {
                 position: "before" | "after";
                 label?: string | undefined;
             }>>>;
+            /**
+             * Skip a subtotal that only repeats one row: an expanded group with
+             * exactly one child shows no subtotal. Off when absent.
+             */
+            skipRedundant: z.ZodOptional<z.ZodBoolean>;
         }, "strict", z.ZodTypeAny, {
             grand: {
                 visible: boolean;
@@ -2289,6 +2299,7 @@ declare const presentationFields: {
                 position: "before" | "after";
                 label?: string | undefined;
             }>>;
+            skipRedundant?: boolean | undefined;
         }, {
             grand: {
                 visible: boolean;
@@ -2300,11 +2311,13 @@ declare const presentationFields: {
                 position: "before" | "after";
                 label?: string | undefined;
             }>>;
+            skipRedundant?: boolean | undefined;
         }>;
         columns: z.ZodObject<{
             grand: z.ZodObject<{
                 visible: z.ZodBoolean;
                 position: z.ZodEnum<["before", "after"]>;
+                /** As written; a subtotal's `{member}` becomes its member's name. */
                 label: z.ZodOptional<z.ZodString>;
             }, "strict", z.ZodTypeAny, {
                 visible: boolean;
@@ -2318,6 +2331,7 @@ declare const presentationFields: {
             levels: z.ZodReadonly<z.ZodRecord<z.ZodString, z.ZodObject<{
                 visible: z.ZodBoolean;
                 position: z.ZodEnum<["before", "after"]>;
+                /** As written; a subtotal's `{member}` becomes its member's name. */
                 label: z.ZodOptional<z.ZodString>;
             }, "strict", z.ZodTypeAny, {
                 visible: boolean;
@@ -2328,6 +2342,11 @@ declare const presentationFields: {
                 position: "before" | "after";
                 label?: string | undefined;
             }>>>;
+            /**
+             * Skip a subtotal that only repeats one row: an expanded group with
+             * exactly one child shows no subtotal. Off when absent.
+             */
+            skipRedundant: z.ZodOptional<z.ZodBoolean>;
         }, "strict", z.ZodTypeAny, {
             grand: {
                 visible: boolean;
@@ -2339,6 +2358,7 @@ declare const presentationFields: {
                 position: "before" | "after";
                 label?: string | undefined;
             }>>;
+            skipRedundant?: boolean | undefined;
         }, {
             grand: {
                 visible: boolean;
@@ -2350,6 +2370,7 @@ declare const presentationFields: {
                 position: "before" | "after";
                 label?: string | undefined;
             }>>;
+            skipRedundant?: boolean | undefined;
         }>;
     }, "strict", z.ZodTypeAny, {
         columns: {
@@ -2363,6 +2384,7 @@ declare const presentationFields: {
                 position: "before" | "after";
                 label?: string | undefined;
             }>>;
+            skipRedundant?: boolean | undefined;
         };
         rows: {
             grand: {
@@ -2375,6 +2397,7 @@ declare const presentationFields: {
                 position: "before" | "after";
                 label?: string | undefined;
             }>>;
+            skipRedundant?: boolean | undefined;
         };
     }, {
         columns: {
@@ -2388,6 +2411,7 @@ declare const presentationFields: {
                 position: "before" | "after";
                 label?: string | undefined;
             }>>;
+            skipRedundant?: boolean | undefined;
         };
         rows: {
             grand: {
@@ -2400,6 +2424,7 @@ declare const presentationFields: {
                 position: "before" | "after";
                 label?: string | undefined;
             }>>;
+            skipRedundant?: boolean | undefined;
         };
     }>;
     conditionalFormatting: z.ZodOptional<z.ZodEffects<z.ZodObject<{
@@ -3907,6 +3932,7 @@ declare const definitionInputShape: z.ZodObject<{
                     position: "before" | "after";
                     label?: string | undefined;
                 }>>;
+                skipRedundant?: boolean | undefined;
             };
             rows: {
                 grand: {
@@ -3919,6 +3945,7 @@ declare const definitionInputShape: z.ZodObject<{
                     position: "before" | "after";
                     label?: string | undefined;
                 }>>;
+                skipRedundant?: boolean | undefined;
             };
         };
         layout: {
@@ -4306,6 +4333,7 @@ declare const definitionInputShape: z.ZodObject<{
                     position: "before" | "after";
                     label?: string | undefined;
                 }>>;
+                skipRedundant?: boolean | undefined;
             };
             rows: {
                 grand: {
@@ -4318,6 +4346,7 @@ declare const definitionInputShape: z.ZodObject<{
                     position: "before" | "after";
                     label?: string | undefined;
                 }>>;
+                skipRedundant?: boolean | undefined;
             };
         };
         layout: {
@@ -4714,6 +4743,7 @@ declare const configShape: z.ZodObject<{
                     position: "before" | "after";
                     label?: string | undefined;
                 }>>;
+                skipRedundant?: boolean | undefined;
             };
             rows: {
                 grand: {
@@ -4726,6 +4756,7 @@ declare const configShape: z.ZodObject<{
                     position: "before" | "after";
                     label?: string | undefined;
                 }>>;
+                skipRedundant?: boolean | undefined;
             };
         };
         layout: {
@@ -5046,6 +5077,7 @@ declare const configShape: z.ZodObject<{
                     position: "before" | "after";
                     label?: string | undefined;
                 }>>;
+                skipRedundant?: boolean | undefined;
             };
             rows: {
                 grand: {
@@ -5058,6 +5090,7 @@ declare const configShape: z.ZodObject<{
                     position: "before" | "after";
                     label?: string | undefined;
                 }>>;
+                skipRedundant?: boolean | undefined;
             };
         };
         layout: {
@@ -5388,6 +5421,7 @@ declare const authoringConfigShape: z.ZodObject<{
                     position: "before" | "after";
                     label?: string | undefined;
                 }>>;
+                skipRedundant?: boolean | undefined;
             };
             rows: {
                 grand: {
@@ -5400,6 +5434,7 @@ declare const authoringConfigShape: z.ZodObject<{
                     position: "before" | "after";
                     label?: string | undefined;
                 }>>;
+                skipRedundant?: boolean | undefined;
             };
         };
         layout: {
@@ -5720,6 +5755,7 @@ declare const authoringConfigShape: z.ZodObject<{
                     position: "before" | "after";
                     label?: string | undefined;
                 }>>;
+                skipRedundant?: boolean | undefined;
             };
             rows: {
                 grand: {
@@ -5732,6 +5768,7 @@ declare const authoringConfigShape: z.ZodObject<{
                     position: "before" | "after";
                     label?: string | undefined;
                 }>>;
+                skipRedundant?: boolean | undefined;
             };
         };
         layout: {
@@ -6158,6 +6195,7 @@ declare const exportRequestShape: z.ZodUnion<[z.ZodObject<{
                     position: "before" | "after";
                     label?: string | undefined;
                 }>>;
+                skipRedundant?: boolean | undefined;
             };
             rows: {
                 grand: {
@@ -6170,6 +6208,7 @@ declare const exportRequestShape: z.ZodUnion<[z.ZodObject<{
                     position: "before" | "after";
                     label?: string | undefined;
                 }>>;
+                skipRedundant?: boolean | undefined;
             };
         };
         layout: {
@@ -6494,6 +6533,7 @@ declare const exportRequestShape: z.ZodUnion<[z.ZodObject<{
                     position: "before" | "after";
                     label?: string | undefined;
                 }>>;
+                skipRedundant?: boolean | undefined;
             };
             rows: {
                 grand: {
@@ -6506,6 +6546,7 @@ declare const exportRequestShape: z.ZodUnion<[z.ZodObject<{
                     position: "before" | "after";
                     label?: string | undefined;
                 }>>;
+                skipRedundant?: boolean | undefined;
             };
         };
         layout: {
@@ -6836,6 +6877,7 @@ declare const exportRequestShape: z.ZodUnion<[z.ZodObject<{
                     position: "before" | "after";
                     label?: string | undefined;
                 }>>;
+                skipRedundant?: boolean | undefined;
             };
             rows: {
                 grand: {
@@ -6848,6 +6890,7 @@ declare const exportRequestShape: z.ZodUnion<[z.ZodObject<{
                     position: "before" | "after";
                     label?: string | undefined;
                 }>>;
+                skipRedundant?: boolean | undefined;
             };
         };
         layout: {
@@ -7127,6 +7170,7 @@ declare const exportRequestShape: z.ZodUnion<[z.ZodObject<{
                     position: "before" | "after";
                     label?: string | undefined;
                 }>>;
+                skipRedundant?: boolean | undefined;
             };
             rows: {
                 grand: {
@@ -7139,6 +7183,7 @@ declare const exportRequestShape: z.ZodUnion<[z.ZodObject<{
                     position: "before" | "after";
                     label?: string | undefined;
                 }>>;
+                skipRedundant?: boolean | undefined;
             };
         };
         layout: {

package/dist/types/shared/analytics-protocol/matrix-member-presentation.d.ts

@@ -10,6 +10,10 @@ export declare function resolveMatrixMemberPresentation(input: {
     total?: MatrixTotalPresentation;
     childrenEmpty?: boolean;
     rowLayout?: 'compact' | 'tabular';
+    /** The axis's `totals.skipRedundant`. */
+    skipRedundant?: boolean;
+    /** The group has exactly one child: its first child page holds one member and no cursor after it. */
+    singleChild?: boolean;
 }): {
     expandable: boolean;
     expanded: boolean;