react-semaphor 0.1.552 → 0.1.554

package/dist/surfboard/index.js

@@ -1,5 +1,5 @@
-import { a, R as s, D as o } from "../chunks/report-preferences-dialog-C0uGI0v7.js";
-import { C as f, E as D } from "../chunks/table-settings-WysCBj62.js";
+import { a, R as s, D as o } from "../chunks/report-preferences-dialog-2tqY0BMQ.js";
+import { C as f, E as D } from "../chunks/table-settings-DOT_Bv1m.js";
 export {
   f as CONTROL_CARD_DEFAULT_VALUE,
   a as DisplayFormatPreferencesFields,

package/dist/types/index.js

@@ -1,9 +1,9 @@
-import { C as s, E as r, V as l, i as o, c as i, g as n, f as d, b as m, e as u, d as E, a as c, u as p, s as C, h as T, j as D, q as A, o as I, m as _, n as F, p as S, k as b, l as L, r as f, t as N } from "../chunks/table-settings-WysCBj62.js";
-import { C as y, D as M, L as g, P as h, e as x, g as O, j as V, h as k, k as w, d as U, b as B, i as K, c as z, n as v, f as P } from "../chunks/validators-C-aOQlTB.js";
-import { D as q } from "../chunks/token-types-BMqRmT-C.js";
-import { B as Q, a as j, p as W, r as J } from "../chunks/bookmark-state-Cu-a5ie_.js";
-import { r as H, a as Z } from "../chunks/pivot-result-identity-C-Q1j1Wb.js";
-import { D as ee } from "../chunks/report-runtime-context-hWiTCzFV.js";
+import { C as s, E as r, V as l, i as o, c as i, g as n, f as d, b as m, e as u, d as E, a as c, u as p, s as C, h as T, j as D, q as A, o as I, m as _, n as F, p as S, k as b, l as L, r as f, t as N } from "../chunks/table-settings-DOT_Bv1m.js";
+import { C as y, D as M, L as g, P as h, e as x, g as O, j as V, h as k, k as w, d as U, b as B, i as K, c as z, n as v, f as P } from "../chunks/validators-ClKLGDGZ.js";
+import { D as q } from "../chunks/token-types-DYECHYGH.js";
+import { B as Q, a as j, p as W, r as J } from "../chunks/bookmark-state-BAeGKd3s.js";
+import { r as H, a as Z } from "../chunks/pivot-result-identity-BHJGZwIc.js";
+import { D as ee } from "../chunks/report-runtime-context-BaIKSaja.js";
 const e = [
   "concatenate",
   "conditional-category",

package/dist/types/lib/dashboard-inputs/prepare-loaded-dashboard.d.ts

@@ -11,5 +11,8 @@ import { TDashboard } from '../types/common-types.js';
  * and the server's saved-dashboard reader, so they all hold the same shape.
  * The same object when nothing changes. Alias-based text is bound to stable
  * input ids before the upgrade (`upgradeToStoredDashboard`, ledger P5-11).
+ * Last, every Pivot and Hierarchical card the converter can carry exactly
+ * loads as a Matrix card (pivot-aggregate-to-matrix PM-D1, PM-D3): in memory
+ * only, stored as Matrix when someone saves.
  */
 export declare function prepareLoadedDashboard<TDashboardShape extends TDashboard>(dashboard: TDashboardShape): TDashboardShape;

package/dist/types/lib/matrix-table/matrix-card-adapter.d.ts

@@ -267,7 +267,7 @@ export declare function prepareMatrixCard(card: TCard, catalog: MatrixCardCatalo
             measures: readonly ({
                 id: string;
                 kind: "aggregate";
-                aggregate: "SUM" | "COUNT" | "AVG" | "MIN" | "MAX" | "DISTINCT";
+                aggregate: "SUM" | "COUNT" | "AVG" | "MIN" | "MAX" | "MEDIAN" | "DISTINCT";
                 field: Omit<import('../../shared/analytics-protocol/index.js').SemaphorExecutionFieldRef, "source" | "aggregate" | "derivedField"> & {
                     source?: import('../../shared/analytics-protocol/index.js').SemaphorMatrixSourceRef;
                     derivedField?: Omit<import('../../shared/analytics-protocol/index.js').SemaphorDerivedFieldDefinition, "inputs"> & {
@@ -326,6 +326,7 @@ export declare function prepareMatrixCard(card: TCard, catalog: MatrixCardCatalo
             relationshipHint?: {
                 relationshipIds?: string[] | undefined;
             } | undefined;
+            measureFilters?: readonly import('../../shared/analytics-protocol/index.js').MatrixMeasureFilter[] | undefined;
         };
         defaultView: {
             columns: {
@@ -449,7 +450,7 @@ export declare function prepareMatrixCard(card: TCard, catalog: MatrixCardCatalo
         }[];
         metrics: {
             id: string;
-            aggregate: "SUM" | "COUNT" | "AVG" | "MIN" | "MAX" | "DISTINCT";
+            aggregate: "SUM" | "COUNT" | "AVG" | "MIN" | "MAX" | "MEDIAN" | "DISTINCT";
             role: "metric";
             derivedField?: import('../../shared/analytics-protocol/index.js').SemaphorDerivedFieldDefinition;
             name: string;

package/dist/types/lib/matrix-table/matrix-delivery.d.ts

@@ -334,7 +334,7 @@ export declare function buildMatrixDeliveryPayload(input: {
                 measures: readonly ({
                     id: string;
                     kind: "aggregate";
-                    aggregate: "SUM" | "COUNT" | "AVG" | "MIN" | "MAX" | "DISTINCT";
+                    aggregate: "SUM" | "COUNT" | "AVG" | "MIN" | "MAX" | "MEDIAN" | "DISTINCT";
                     field: Omit<import('../../shared/analytics-protocol/index.js').SemaphorExecutionFieldRef, "source" | "aggregate" | "derivedField"> & {
                         source?: import('../../shared/analytics-protocol/index.js').SemaphorMatrixSourceRef;
                         derivedField?: Omit<import('../../shared/analytics-protocol/index.js').SemaphorDerivedFieldDefinition, "inputs"> & {
@@ -393,6 +393,7 @@ export declare function buildMatrixDeliveryPayload(input: {
                 relationshipHint?: {
                     relationshipIds?: string[] | undefined;
                 } | undefined;
+                measureFilters?: readonly import('../../shared/analytics-protocol/index.js').MatrixMeasureFilter[] | undefined;
             };
             expansion: {
                 kind: "current";
@@ -686,7 +687,7 @@ export declare function buildMatrixDeliveryPayload(input: {
                 measures: readonly ({
                     id: string;
                     kind: "aggregate";
-                    aggregate: "SUM" | "COUNT" | "AVG" | "MIN" | "MAX" | "DISTINCT";
+                    aggregate: "SUM" | "COUNT" | "AVG" | "MIN" | "MAX" | "MEDIAN" | "DISTINCT";
                     field: Omit<import('../../shared/analytics-protocol/index.js').SemaphorExecutionFieldRef, "source" | "aggregate" | "derivedField"> & {
                         source?: import('../../shared/analytics-protocol/index.js').SemaphorMatrixSourceRef;
                         derivedField?: Omit<import('../../shared/analytics-protocol/index.js').SemaphorDerivedFieldDefinition, "inputs"> & {
@@ -745,6 +746,7 @@ export declare function buildMatrixDeliveryPayload(input: {
                 relationshipHint?: {
                     relationshipIds?: string[] | undefined;
                 } | undefined;
+                measureFilters?: readonly import('../../shared/analytics-protocol/index.js').MatrixMeasureFilter[] | undefined;
             };
         };
         delimiter: "," | ";" | "\t";

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

@@ -0,0 +1,61 @@
+import { CardConfig, DataSource, Field, FilterGroup, JoinPlan } from '../types/explorer-types.js';
+import { TCard } from '../types/common-types.js';
+/** Matrix acquisition requires its structured definition, never an authored SQL query. */
+export declare function supportsSqlEditor(cardType: TCard['type']): boolean;
+export declare function hasEditorResultsView(cardType: TCard['type']): boolean;
+export declare function hasEditorInfoView(cardType: TCard['type']): boolean;
+/** The deprecated table types every saved card of which loads as Matrix (pivot-aggregate-to-matrix). */
+export declare const LEGACY_TABLE_CARD_TYPES: readonly ["pivotTable", "aggregateTable"];
+export type LegacyTableCardType = (typeof LEGACY_TABLE_CARD_TYPES)[number];
+export declare function isLegacyTableCard(card: Pick<TCard, 'type'>): card is Pick<TCard, 'type'> & {
+    type: LegacyTableCardType;
+};
+/**
+ * Why one data part did not carry exactly (pivot-aggregate-to-matrix PM-D12).
+ * The problem-area codes (PA-n) are the shapes a later rule will translate;
+ * display differences are never gaps (PM-D15).
+ */
+export type CardTypeChangeGapCode = 'calculated_metric_per_row' | 'calculated_metric_without_stage' | 'calculated_field_card_scope' | 'calculated_field_dashboard_scope' | 'source_field_renamed' | 'join_not_carried' | 'metric_parameters' | 'unknown_field_property' | 'calculated_level_without_inputs' | 'field_not_resolvable' | 'filter_not_accepted' | 'control_binding' | 'no_shelf_fields' | 'matrix_definition_incomplete' | 'detail_columns' | 'matrix_field_not_on_shelves' | 'not_in_detail_table';
+export type CardTypeChangeGap = {
+    code: CardTypeChangeGapCode;
+    label: string;
+};
+export type MatrixRepresentationChange = {
+    card: Partial<TCard>;
+    /** Authored data parts the next representation does not accept, in shelf order. */
+    gaps: readonly CardTypeChangeGap[];
+};
+/**
+ * Crossing the Matrix boundary carries the card's authored definition (MS-D12):
+ * rows, pivot columns, metrics, the join and filters are read once through
+ * `getCardDefinition` and written into the next representation by each part's
+ * own writer. A data part the next representation refuses is a gap. Into
+ * Matrix, number formats carry, and from a Pivot or Hierarchical card the
+ * expansion and the visible totals too (PM-D5); every other display setting
+ * takes the Matrix defaults. SQL, Python and control bindings start fresh.
+ * Needs the loaded column catalog to complete join keys and resolve Matrix
+ * fields; without it, keys saved with their identity still carry.
+ */
+export declare function convertMatrixRepresentation(card: TCard, nextType: TCard['type'], catalog?: readonly Field[], 
+/** Mints each carried Matrix field's instance id; a replayed conversion passes stored ids (DE-D54). */
+createId?: () => string): MatrixRepresentationChange;
+/** The switch reads the catalog only when it has something to carry. */
+export declare function matrixSwitchNeedsCatalog(card: TCard, nextType: TCard['type']): boolean;
+/** Replacing the base dataset starts a new definition; metadata refresh does not. */
+export declare function withAuthoredCardDataSource(card: TCard, dataSource: DataSource): Partial<TCard>;
+export declare function getAuthoredCardJoinPlan(card: Pick<TCard, 'type' | 'config'>): JoinPlan | undefined;
+/** The normal join editor writes the canonical definition, including empty drafts. */
+export declare function withAuthoredCardJoinPlan(card: Pick<TCard, 'type' | 'config' | 'dataSource'>, joinPlan: JoinPlan | undefined): CardConfig;
+/** Authored predicates from the card's canonical representation. */
+export declare function getAuthoredCardFilters(card: Pick<TCard, 'type' | 'config'> | undefined): FilterGroup | undefined;
+export declare function withAuthoredCardFilters(card: Pick<TCard, 'type' | 'config' | 'dataSource'>, filters: FilterGroup | undefined): CardConfig;
+/**
+ * Checks if a card config object has actual configuration data
+ * An empty config object {} should be treated as no config
+ */
+export declare function hasValidCardConfig(config: CardConfig | undefined, cardType?: TCard['type']): boolean;
+type CardSetupCheckOptions = {
+    skipSetupCheck?: boolean;
+};
+export declare function isCardUnconfigured(card: Pick<TCard, 'type' | 'sql' | 'config' | 'connectionId' | 'dataSource' | 'customCardPreferences'>, options?: CardSetupCheckOptions): boolean;
+export {};

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

@@ -275,7 +275,7 @@ export declare function getCardDefinition(card: DefinitionCard, catalog?: Matrix
             measures: readonly ({
                 id: string;
                 kind: "aggregate";
-                aggregate: "SUM" | "COUNT" | "AVG" | "MIN" | "MAX" | "DISTINCT";
+                aggregate: "SUM" | "COUNT" | "AVG" | "MIN" | "MAX" | "MEDIAN" | "DISTINCT";
                 field: Omit<import('../../shared/analytics-protocol/index.js').SemaphorExecutionFieldRef, "source" | "aggregate" | "derivedField"> & {
                     source?: import('../../shared/analytics-protocol/index.js').SemaphorMatrixSourceRef;
                     derivedField?: Omit<import('../../data-app-sdk.js').SemaphorDerivedFieldDefinition, "inputs"> & {
@@ -334,6 +334,7 @@ export declare function getCardDefinition(card: DefinitionCard, catalog?: Matrix
             relationshipHint?: {
                 relationshipIds?: string[] | undefined;
             } | undefined;
+            measureFilters?: readonly import('../../shared/analytics-protocol/matrix-definition-contract.js').MatrixMeasureFilter[] | undefined;
         };
         defaultView: {
             columns: {

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

@@ -1,5 +1,7 @@
 import { TCard, TCardPreferences, TCustomCardPreferences } from '../types/common-types.js';
 import { Field } from '../types/explorer-types.js';
+import { CardTypeChangeGap } from './card-config-utils.js';
+export type { CardTypeChangeGap, CardTypeChangeGapCode } from './card-config-utils.js';
 export declare function sharedCardPreferences(preferences: TCardPreferences | undefined): TCardPreferences;
 export type CardTypeChangeOptions = {
     /** The loaded column catalog; the Matrix carry resolves fields against it. */
@@ -22,7 +24,9 @@ export type CardTypeChange = {
 } | {
     status: 'changed';
     card: TCard;
-    /** Labels of authored parts the new type could not keep. */
+    /** Authored data parts the new type could not keep, with why (pivot-aggregate-to-matrix PM-D12). */
+    gaps: readonly CardTypeChangeGap[];
+    /** The gaps' labels, in the same order, for readers that only name them. */
     leftOut: readonly string[];
     /** Chart-scoped preference keys the new type drops (DE-D43). */
     droppedPreferences: readonly (keyof TCardPreferences)[];

package/dist/types/shared/analytics-protocol/explorer-input-schemas.d.ts

@@ -1,5 +1,7 @@
 import { z } from 'zod';
 import { Field, FilterGroup, JoinPlan } from '../../lib/types/explorer-types.js';
+/** The roles a field may carry; the Matrix carry drops any other (pivot-aggregate-to-matrix PA-19). */
+export declare const explorerFieldRoleSchema: z.ZodEnum<["groupby", "metric", "sortby", "pivotby", "detail"]>;
 export declare const explorerFieldSchema: z.ZodType<Field>;
 export declare const filterGroupSchema: z.ZodType<FilterGroup>;
 export declare const joinPlanSchema: z.ZodType<JoinPlan>;

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

@@ -46,7 +46,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, 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 { matrixAxisSchema, matrixAggregateSchema, matrixFieldSchema, matrixLevelSchema, matrixMeasureSchema, matrixMemberSchema, matrixPathSchema, matrixCoordinateSchema, matrixSortTargetSchema, matrixSortSchema, matrixRankingSchema, matrixMeasureFilterSchema, 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, MatrixMeasureFilter, MatrixMeasureFilterOperator, 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-analytical-definition.d.ts

@@ -250,5 +250,6 @@ export declare function getMatrixAnalyticalDefinition(spec: MatrixSpec): {
         relationshipIds?: string[];
     };
     rankings: readonly import('./matrix-definition-contract.js').MatrixRanking[];
+    measureFilters?: readonly import('./matrix-definition-contract.js').MatrixMeasureFilter[];
 };
 export {};

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

@@ -5,7 +5,7 @@ import { FilterGroup, JoinPlan } from '../../lib/types/explorer-types.js';
 export { matrixAxisSchema, matrixMemberSchema, matrixPathSchema, matrixCoordinateSchema, matrixPathKey, type MatrixAxis, type MatrixMember, type MatrixPath, type MatrixCoordinate } from './matrix-path-contract.js';
 export type MatrixLevelId = string;
 export type MatrixMeasureId = string;
-export type MatrixAggregate = 'SUM' | 'COUNT' | 'DISTINCT' | 'AVG' | 'MIN' | 'MAX';
+export type MatrixAggregate = 'SUM' | 'COUNT' | 'DISTINCT' | 'AVG' | 'MIN' | 'MAX' | 'MEDIAN';
 type MatrixDerivedFieldInput = {
     kind: 'field';
     field: Omit<SemaphorFieldRef, 'source'> & {
@@ -65,6 +65,23 @@ export type MatrixRanking = {
     oppositePath: MatrixPath;
     others: boolean;
 };
+/** Comparisons from the shared filter vocabulary; range bounds are inclusive. */
+export type MatrixMeasureFilterOperator = '=' | '!=' | '>' | '>=' | '<' | '<=' | 'between' | 'not between';
+/**
+ * Keeps the members of one level whose own value of a measure passes the
+ * condition. The value covers the member's descendants and the whole other
+ * axis, after card filters; excluded members leave with their descendants,
+ * and every total covers kept members only (matrix-median-measure-filters
+ * MF-D6 to MF-D10).
+ */
+export type MatrixMeasureFilter = {
+    id: string;
+    axis: MatrixAxis;
+    levelId: MatrixLevelId;
+    measureId: MatrixMeasureId;
+    operator: MatrixMeasureFilterOperator;
+    value: number | readonly [number, number];
+};
 export type MatrixSpec = {
     source: SemaphorMatrixSourceRef;
     rows: readonly MatrixLevel[];
@@ -77,19 +94,20 @@ export type MatrixSpec = {
     };
     sorts: readonly MatrixSort[];
     rankings: readonly MatrixRanking[];
+    measureFilters?: readonly MatrixMeasureFilter[];
 };
-export declare const matrixAggregateSchema: z.ZodEnum<["SUM", "COUNT", "DISTINCT", "AVG", "MIN", "MAX"]>;
+export declare const matrixAggregateSchema: z.ZodEnum<["SUM", "COUNT", "DISTINCT", "AVG", "MIN", "MAX", "MEDIAN"]>;
 export declare const matrixFieldSchema: z.ZodType<MatrixField>;
 export declare const matrixLevelSchema: z.ZodType<MatrixLevel>;
 declare const aggregateMeasureSchema: z.ZodObject<{
     id: z.ZodString;
     kind: z.ZodLiteral<"aggregate">;
     field: z.ZodType<MatrixField, z.ZodTypeDef, MatrixField>;
-    aggregate: z.ZodEnum<["SUM", "COUNT", "DISTINCT", "AVG", "MIN", "MAX"]>;
+    aggregate: z.ZodEnum<["SUM", "COUNT", "DISTINCT", "AVG", "MIN", "MAX", "MEDIAN"]>;
 }, "strict", z.ZodTypeAny, {
     id: string;
     kind: "aggregate";
-    aggregate: "SUM" | "COUNT" | "AVG" | "MIN" | "MAX" | "DISTINCT";
+    aggregate: "SUM" | "COUNT" | "AVG" | "MIN" | "MAX" | "MEDIAN" | "DISTINCT";
     field: Omit<SemaphorExecutionFieldRef, "source" | "aggregate" | "derivedField"> & {
         source?: SemaphorMatrixSourceRef;
         derivedField?: MatrixDerivedFieldDefinition;
@@ -97,7 +115,7 @@ declare const aggregateMeasureSchema: z.ZodObject<{
 }, {
     id: string;
     kind: "aggregate";
-    aggregate: "SUM" | "COUNT" | "AVG" | "MIN" | "MAX" | "DISTINCT";
+    aggregate: "SUM" | "COUNT" | "AVG" | "MIN" | "MAX" | "MEDIAN" | "DISTINCT";
     field: Omit<SemaphorExecutionFieldRef, "source" | "aggregate" | "derivedField"> & {
         source?: SemaphorMatrixSourceRef;
         derivedField?: MatrixDerivedFieldDefinition;
@@ -175,6 +193,7 @@ declare const matrixSortFields: {
 type MatrixSortSchema = z.ZodObject<typeof matrixSortFields, 'strict'>;
 export declare const matrixSortSchema: MatrixSortSchema;
 export declare const matrixRankingSchema: z.ZodType<MatrixRanking>;
+export declare const matrixMeasureFilterSchema: z.ZodType<MatrixMeasureFilter>;
 declare const specShape: z.ZodObject<{
     source: z.ZodUnion<[z.ZodObject<{
         kind: z.ZodLiteral<"semantic">;
@@ -241,6 +260,7 @@ declare const specShape: z.ZodObject<{
     }>>;
     sorts: z.ZodReadonly<z.ZodArray<MatrixSortSchema, "many">>;
     rankings: z.ZodReadonly<z.ZodArray<z.ZodType<MatrixRanking, z.ZodTypeDef, MatrixRanking>, "many">>;
+    measureFilters: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodType<MatrixMeasureFilter, z.ZodTypeDef, MatrixMeasureFilter>, "many">>>;
 }, "strict", z.ZodTypeAny, {
     source: {
         kind: "semantic";
@@ -263,7 +283,7 @@ declare const specShape: z.ZodObject<{
     measures: readonly ({
         id: string;
         kind: "aggregate";
-        aggregate: "SUM" | "COUNT" | "AVG" | "MIN" | "MAX" | "DISTINCT";
+        aggregate: "SUM" | "COUNT" | "AVG" | "MIN" | "MAX" | "MEDIAN" | "DISTINCT";
         field: Omit<SemaphorExecutionFieldRef, "source" | "aggregate" | "derivedField"> & {
             source?: SemaphorMatrixSourceRef;
             derivedField?: MatrixDerivedFieldDefinition;
@@ -308,6 +328,7 @@ declare const specShape: z.ZodObject<{
     relationshipHint?: {
         relationshipIds?: string[] | undefined;
     } | undefined;
+    measureFilters?: readonly MatrixMeasureFilter[] | undefined;
 }, {
     source: {
         kind: "semantic";
@@ -330,7 +351,7 @@ declare const specShape: z.ZodObject<{
     measures: readonly ({
         id: string;
         kind: "aggregate";
-        aggregate: "SUM" | "COUNT" | "AVG" | "MIN" | "MAX" | "DISTINCT";
+        aggregate: "SUM" | "COUNT" | "AVG" | "MIN" | "MAX" | "MEDIAN" | "DISTINCT";
         field: Omit<SemaphorExecutionFieldRef, "source" | "aggregate" | "derivedField"> & {
             source?: SemaphorMatrixSourceRef;
             derivedField?: MatrixDerivedFieldDefinition;
@@ -375,6 +396,7 @@ declare const specShape: z.ZodObject<{
     relationshipHint?: {
         relationshipIds?: string[] | undefined;
     } | undefined;
+    measureFilters?: readonly MatrixMeasureFilter[] | undefined;
 }>;
 export declare function matrixSortKey(sort: Pick<MatrixSort, 'axis' | 'levelId' | 'scope'>): string;
 type Spec = MatrixSpec;
@@ -445,6 +467,7 @@ declare const authoringSpecShape: z.ZodObject<{
     }>>;
     sorts: z.ZodReadonly<z.ZodArray<MatrixSortSchema, "many">>;
     rankings: z.ZodReadonly<z.ZodArray<z.ZodType<MatrixRanking, z.ZodTypeDef, MatrixRanking>, "many">>;
+    measureFilters: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodType<MatrixMeasureFilter, z.ZodTypeDef, MatrixMeasureFilter>, "many">>>;
 } & {
     rows: z.ZodReadonly<z.ZodArray<z.ZodType<MatrixLevel, z.ZodTypeDef, MatrixLevel>, "many">>;
     measures: z.ZodReadonly<z.ZodArray<MatrixMeasureSchema, "many">>;
@@ -470,7 +493,7 @@ declare const authoringSpecShape: z.ZodObject<{
     measures: readonly ({
         id: string;
         kind: "aggregate";
-        aggregate: "SUM" | "COUNT" | "AVG" | "MIN" | "MAX" | "DISTINCT";
+        aggregate: "SUM" | "COUNT" | "AVG" | "MIN" | "MAX" | "MEDIAN" | "DISTINCT";
         field: Omit<SemaphorExecutionFieldRef, "source" | "aggregate" | "derivedField"> & {
             source?: SemaphorMatrixSourceRef;
             derivedField?: MatrixDerivedFieldDefinition;
@@ -515,6 +538,7 @@ declare const authoringSpecShape: z.ZodObject<{
     relationshipHint?: {
         relationshipIds?: string[] | undefined;
     } | undefined;
+    measureFilters?: readonly MatrixMeasureFilter[] | undefined;
 }, {
     source: {
         kind: "semantic";
@@ -537,7 +561,7 @@ declare const authoringSpecShape: z.ZodObject<{
     measures: readonly ({
         id: string;
         kind: "aggregate";
-        aggregate: "SUM" | "COUNT" | "AVG" | "MIN" | "MAX" | "DISTINCT";
+        aggregate: "SUM" | "COUNT" | "AVG" | "MIN" | "MAX" | "MEDIAN" | "DISTINCT";
         field: Omit<SemaphorExecutionFieldRef, "source" | "aggregate" | "derivedField"> & {
             source?: SemaphorMatrixSourceRef;
             derivedField?: MatrixDerivedFieldDefinition;
@@ -582,6 +606,7 @@ declare const authoringSpecShape: z.ZodObject<{
     relationshipHint?: {
         relationshipIds?: string[] | undefined;
     } | undefined;
+    measureFilters?: readonly MatrixMeasureFilter[] | undefined;
 }>;
 type MatrixAuthoringSpecSchema = z.ZodEffects<typeof authoringSpecShape>;
 /** Editor-only incomplete shelves. Execution and persistence use matrixSpecSchema. */
@@ -652,6 +677,7 @@ declare const analyticalIntentShape: z.ZodObject<{
     }>>;
     sorts: z.ZodReadonly<z.ZodArray<MatrixSortSchema, "many">>;
     rankings: z.ZodReadonly<z.ZodArray<z.ZodType<MatrixRanking, z.ZodTypeDef, MatrixRanking>, "many">>;
+    measureFilters: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodType<MatrixMeasureFilter, z.ZodTypeDef, MatrixMeasureFilter>, "many">>>;
 } & {
     kind: z.ZodLiteral<"matrix">;
 }, "strict", z.ZodTypeAny, {
@@ -677,7 +703,7 @@ declare const analyticalIntentShape: z.ZodObject<{
     measures: readonly ({
         id: string;
         kind: "aggregate";
-        aggregate: "SUM" | "COUNT" | "AVG" | "MIN" | "MAX" | "DISTINCT";
+        aggregate: "SUM" | "COUNT" | "AVG" | "MIN" | "MAX" | "MEDIAN" | "DISTINCT";
         field: Omit<SemaphorExecutionFieldRef, "source" | "aggregate" | "derivedField"> & {
             source?: SemaphorMatrixSourceRef;
             derivedField?: MatrixDerivedFieldDefinition;
@@ -722,6 +748,7 @@ declare const analyticalIntentShape: z.ZodObject<{
     relationshipHint?: {
         relationshipIds?: string[] | undefined;
     } | undefined;
+    measureFilters?: readonly MatrixMeasureFilter[] | undefined;
 }, {
     kind: "matrix";
     source: {
@@ -745,7 +772,7 @@ declare const analyticalIntentShape: z.ZodObject<{
     measures: readonly ({
         id: string;
         kind: "aggregate";
-        aggregate: "SUM" | "COUNT" | "AVG" | "MIN" | "MAX" | "DISTINCT";
+        aggregate: "SUM" | "COUNT" | "AVG" | "MIN" | "MAX" | "MEDIAN" | "DISTINCT";
         field: Omit<SemaphorExecutionFieldRef, "source" | "aggregate" | "derivedField"> & {
             source?: SemaphorMatrixSourceRef;
             derivedField?: MatrixDerivedFieldDefinition;
@@ -790,6 +817,7 @@ declare const analyticalIntentShape: z.ZodObject<{
     relationshipHint?: {
         relationshipIds?: string[] | undefined;
     } | undefined;
+    measureFilters?: readonly MatrixMeasureFilter[] | undefined;
 }>;
 type MatrixAnalyticalIntentSchema = z.ZodEffects<typeof analyticalIntentShape>;
 /** Analytical definition only; acquisition windows are sibling operation inputs. */
@@ -4163,7 +4191,7 @@ declare const definitionInputShape: z.ZodObject<{
         measures: readonly ({
             id: string;
             kind: "aggregate";
-            aggregate: "SUM" | "COUNT" | "AVG" | "MIN" | "MAX" | "DISTINCT";
+            aggregate: "SUM" | "COUNT" | "AVG" | "MIN" | "MAX" | "MEDIAN" | "DISTINCT";
             field: Omit<SemaphorExecutionFieldRef, "source" | "aggregate" | "derivedField"> & {
                 source?: SemaphorMatrixSourceRef;
                 derivedField?: MatrixDerivedFieldDefinition;
@@ -4208,6 +4236,7 @@ declare const definitionInputShape: z.ZodObject<{
         relationshipHint?: {
             relationshipIds?: string[] | undefined;
         } | undefined;
+        measureFilters?: readonly MatrixMeasureFilter[] | undefined;
     };
     defaults: {
         columns: {
@@ -4564,7 +4593,7 @@ declare const definitionInputShape: z.ZodObject<{
         measures: readonly ({
             id: string;
             kind: "aggregate";
-            aggregate: "SUM" | "COUNT" | "AVG" | "MIN" | "MAX" | "DISTINCT";
+            aggregate: "SUM" | "COUNT" | "AVG" | "MIN" | "MAX" | "MEDIAN" | "DISTINCT";
             field: Omit<SemaphorExecutionFieldRef, "source" | "aggregate" | "derivedField"> & {
                 source?: SemaphorMatrixSourceRef;
                 derivedField?: MatrixDerivedFieldDefinition;
@@ -4609,6 +4638,7 @@ declare const definitionInputShape: z.ZodObject<{
         relationshipHint?: {
             relationshipIds?: string[] | undefined;
         } | undefined;
+        measureFilters?: readonly MatrixMeasureFilter[] | undefined;
     };
     defaults: {
         columns: {
@@ -4975,7 +5005,7 @@ declare const configShape: z.ZodObject<{
         measures: readonly ({
             id: string;
             kind: "aggregate";
-            aggregate: "SUM" | "COUNT" | "AVG" | "MIN" | "MAX" | "DISTINCT";
+            aggregate: "SUM" | "COUNT" | "AVG" | "MIN" | "MAX" | "MEDIAN" | "DISTINCT";
             field: Omit<SemaphorExecutionFieldRef, "source" | "aggregate" | "derivedField"> & {
                 source?: SemaphorMatrixSourceRef;
                 derivedField?: MatrixDerivedFieldDefinition;
@@ -5020,6 +5050,7 @@ declare const configShape: z.ZodObject<{
         relationshipHint?: {
             relationshipIds?: string[] | undefined;
         } | undefined;
+        measureFilters?: readonly MatrixMeasureFilter[] | undefined;
     };
     defaultView: {
         columns: {
@@ -5309,7 +5340,7 @@ declare const configShape: z.ZodObject<{
         measures: readonly ({
             id: string;
             kind: "aggregate";
-            aggregate: "SUM" | "COUNT" | "AVG" | "MIN" | "MAX" | "DISTINCT";
+            aggregate: "SUM" | "COUNT" | "AVG" | "MIN" | "MAX" | "MEDIAN" | "DISTINCT";
             field: Omit<SemaphorExecutionFieldRef, "source" | "aggregate" | "derivedField"> & {
                 source?: SemaphorMatrixSourceRef;
                 derivedField?: MatrixDerivedFieldDefinition;
@@ -5354,6 +5385,7 @@ declare const configShape: z.ZodObject<{
         relationshipHint?: {
             relationshipIds?: string[] | undefined;
         } | undefined;
+        measureFilters?: readonly MatrixMeasureFilter[] | undefined;
     };
     defaultView: {
         columns: {
@@ -5653,7 +5685,7 @@ declare const authoringConfigShape: z.ZodObject<{
         measures: readonly ({
             id: string;
             kind: "aggregate";
-            aggregate: "SUM" | "COUNT" | "AVG" | "MIN" | "MAX" | "DISTINCT";
+            aggregate: "SUM" | "COUNT" | "AVG" | "MIN" | "MAX" | "MEDIAN" | "DISTINCT";
             field: Omit<SemaphorExecutionFieldRef, "source" | "aggregate" | "derivedField"> & {
                 source?: SemaphorMatrixSourceRef;
                 derivedField?: MatrixDerivedFieldDefinition;
@@ -5698,6 +5730,7 @@ declare const authoringConfigShape: z.ZodObject<{
         relationshipHint?: {
             relationshipIds?: string[] | undefined;
         } | undefined;
+        measureFilters?: readonly MatrixMeasureFilter[] | undefined;
     };
     defaultView: {
         columns: {
@@ -5987,7 +6020,7 @@ declare const authoringConfigShape: z.ZodObject<{
         measures: readonly ({
             id: string;
             kind: "aggregate";
-            aggregate: "SUM" | "COUNT" | "AVG" | "MIN" | "MAX" | "DISTINCT";
+            aggregate: "SUM" | "COUNT" | "AVG" | "MIN" | "MAX" | "MEDIAN" | "DISTINCT";
             field: Omit<SemaphorExecutionFieldRef, "source" | "aggregate" | "derivedField"> & {
                 source?: SemaphorMatrixSourceRef;
                 derivedField?: MatrixDerivedFieldDefinition;
@@ -6032,6 +6065,7 @@ declare const authoringConfigShape: z.ZodObject<{
         relationshipHint?: {
             relationshipIds?: string[] | undefined;
         } | undefined;
+        measureFilters?: readonly MatrixMeasureFilter[] | undefined;
     };
     defaultView: {
         columns: {
@@ -6427,7 +6461,7 @@ declare const exportRequestShape: z.ZodUnion<[z.ZodObject<{
         measures: readonly ({
             id: string;
             kind: "aggregate";
-            aggregate: "SUM" | "COUNT" | "AVG" | "MIN" | "MAX" | "DISTINCT";
+            aggregate: "SUM" | "COUNT" | "AVG" | "MIN" | "MAX" | "MEDIAN" | "DISTINCT";
             field: Omit<SemaphorExecutionFieldRef, "source" | "aggregate" | "derivedField"> & {
                 source?: SemaphorMatrixSourceRef;
                 derivedField?: MatrixDerivedFieldDefinition;
@@ -6472,6 +6506,7 @@ declare const exportRequestShape: z.ZodUnion<[z.ZodObject<{
         relationshipHint?: {
             relationshipIds?: string[] | undefined;
         } | undefined;
+        measureFilters?: readonly MatrixMeasureFilter[] | undefined;
     };
     expansion: {
         kind: "current";
@@ -6765,7 +6800,7 @@ declare const exportRequestShape: z.ZodUnion<[z.ZodObject<{
         measures: readonly ({
             id: string;
             kind: "aggregate";
-            aggregate: "SUM" | "COUNT" | "AVG" | "MIN" | "MAX" | "DISTINCT";
+            aggregate: "SUM" | "COUNT" | "AVG" | "MIN" | "MAX" | "MEDIAN" | "DISTINCT";
             field: Omit<SemaphorExecutionFieldRef, "source" | "aggregate" | "derivedField"> & {
                 source?: SemaphorMatrixSourceRef;
                 derivedField?: MatrixDerivedFieldDefinition;
@@ -6810,6 +6845,7 @@ declare const exportRequestShape: z.ZodUnion<[z.ZodObject<{
         relationshipHint?: {
             relationshipIds?: string[] | undefined;
         } | undefined;
+        measureFilters?: readonly MatrixMeasureFilter[] | undefined;
     };
     expansion: {
         kind: "current";
@@ -7109,7 +7145,7 @@ declare const exportRequestShape: z.ZodUnion<[z.ZodObject<{
         measures: readonly ({
             id: string;
             kind: "aggregate";
-            aggregate: "SUM" | "COUNT" | "AVG" | "MIN" | "MAX" | "DISTINCT";
+            aggregate: "SUM" | "COUNT" | "AVG" | "MIN" | "MAX" | "MEDIAN" | "DISTINCT";
             field: Omit<SemaphorExecutionFieldRef, "source" | "aggregate" | "derivedField"> & {
                 source?: SemaphorMatrixSourceRef;
                 derivedField?: MatrixDerivedFieldDefinition;
@@ -7154,6 +7190,7 @@ declare const exportRequestShape: z.ZodUnion<[z.ZodObject<{
         relationshipHint?: {
             relationshipIds?: string[] | undefined;
         } | undefined;
+        measureFilters?: readonly MatrixMeasureFilter[] | undefined;
     };
 }, {
     mode: "flat";
@@ -7402,7 +7439,7 @@ declare const exportRequestShape: z.ZodUnion<[z.ZodObject<{
         measures: readonly ({
             id: string;
             kind: "aggregate";
-            aggregate: "SUM" | "COUNT" | "AVG" | "MIN" | "MAX" | "DISTINCT";
+            aggregate: "SUM" | "COUNT" | "AVG" | "MIN" | "MAX" | "MEDIAN" | "DISTINCT";
             field: Omit<SemaphorExecutionFieldRef, "source" | "aggregate" | "derivedField"> & {
                 source?: SemaphorMatrixSourceRef;
                 derivedField?: MatrixDerivedFieldDefinition;
@@ -7447,6 +7484,7 @@ declare const exportRequestShape: z.ZodUnion<[z.ZodObject<{
         relationshipHint?: {
             relationshipIds?: string[] | undefined;
         } | undefined;
+        measureFilters?: readonly MatrixMeasureFilter[] | undefined;
     };
 }>]>;
 type MatrixExportRequestSchema = z.ZodEffects<typeof exportRequestShape>;