react-semaphor 0.1.449 → 0.1.454

package/dist/surfboard/index.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("../chunks/index-DPv8_Ild.cjs"),r=require("../chunks/common-types-CQ6SHfLk.cjs"),o=require("../chunks/report-preferences-dialog-DaqTEcac.cjs");exports.DisplayFormatPreferencesFields=e.DisplayFormatPreferencesFields;exports.Surfboard=e.DashboardPlus;exports.CONTROL_CARD_DEFAULT_VALUE=r.CONTROL_CARD_DEFAULT_VALUE;exports.EMPTY_SELECTION=r.EMPTY_SELECTION;exports.ReportPreferencesDialog=o.ReportPreferencesDialog;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("../chunks/index-CLB_NGZ8.cjs"),r=require("../chunks/common-types-C57kJ59w.cjs"),o=require("../chunks/report-preferences-dialog-BgSvlDXa.cjs");exports.DisplayFormatPreferencesFields=e.DisplayFormatPreferencesFields;exports.Surfboard=e.DashboardPlus;exports.CONTROL_CARD_DEFAULT_VALUE=r.CONTROL_CARD_DEFAULT_VALUE;exports.EMPTY_SELECTION=r.EMPTY_SELECTION;exports.ReportPreferencesDialog=o.ReportPreferencesDialog;

package/dist/surfboard/index.js

@@ -1,6 +1,6 @@
-import { b as a, a as o } from "../chunks/index-CPuawpXJ.js";
-import { C as f, E } from "../chunks/common-types-B7Jk3Rtj.js";
-import { R as t } from "../chunks/report-preferences-dialog-D9ZCGh9l.js";
+import { b as a, a as o } from "../chunks/index-DAoS4BNU.js";
+import { C as f, E } from "../chunks/common-types-H51FLKB7.js";
+import { R as t } from "../chunks/report-preferences-dialog-DDc2WUa0.js";
 export {
   f as CONTROL_CARD_DEFAULT_VALUE,
   a as DisplayFormatPreferencesFields,

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

@@ -235,6 +235,7 @@ export declare type MatrixAxisLevelDescriptor = {
     label: string;
     field: SemaphorFieldRef;
     grain?: SemaphorMatrixTimeGrain;
+    temporalBucket?: TemporalBucketMetadata;
     subtotal?: SemaphorMatrixSubtotalOptions;
 };
 
@@ -355,7 +356,8 @@ export declare type MatrixGridCell = {
 
 export declare type MatrixGridColumn = {
     id: string;
-    label: string;
+    /** Present only for measure and explicit total headings. */
+    label?: string;
     columnNodeId?: string;
     columnPath: MatrixMemberPathSegment[];
     measureInstanceId: string;
@@ -364,7 +366,8 @@ export declare type MatrixGridColumn = {
 
 export declare type MatrixGridHeaderCell = {
     id: string;
-    label: string;
+    /** Present only for non-member headings and explicit total labels. */
+    label?: string;
     role: 'rowHeader' | 'columnHeader' | 'measureHeader' | 'subtotal' | 'grandTotal';
     colSpan: number;
     rowSpan: number;
@@ -378,7 +381,7 @@ export declare type MatrixGridHeaderRow = {
 };
 
 export declare type MatrixGridProjection = {
-    schemaVersion: 1;
+    schemaVersion: 2;
     shape: MatrixShape;
     rowHeaderLevels: MatrixGridRowHeaderLevel[];
     columnHeaderRows: MatrixGridHeaderRow[];
@@ -391,7 +394,8 @@ export declare type MatrixGridRow = {
     rowNodeId: string;
     rowPath: MatrixMemberPathSegment[];
     depth: number;
-    label: string;
+    /** Present only for non-temporal members and explicit total labels. */
+    label?: string;
     role: 'value' | 'rowSubtotal' | 'rowGrandTotal';
     isExpanded?: boolean;
     hasChildren?: boolean;
@@ -447,7 +451,8 @@ export declare type MatrixMemberPathSegment = {
     instanceId: string;
     fieldKey: string;
     value: unknown;
-    label: string;
+    /** Display-only source label for non-temporal members. */
+    label?: string;
 };
 
 export declare type MatrixNode = {
@@ -455,7 +460,8 @@ export declare type MatrixNode = {
     axis: 'row' | 'column';
     path: MatrixMemberPathSegment[];
     level: number;
-    label: string;
+    /** Present only for non-temporal members and explicit total labels. */
+    label?: string;
     value: unknown;
     parentId?: string;
     hasChildren: boolean;
@@ -484,7 +490,7 @@ export declare type MatrixPageInfo = {
 
 export declare type MatrixPayload = {
     kind: 'matrixPayload';
-    schemaVersion: 1;
+    schemaVersion: 2;
     shape: MatrixShape;
     capabilities: MatrixCapability[];
     executionMetadata: MatrixExecutionMetadata;
@@ -527,6 +533,18 @@ export declare type MatrixResultCell = {
     calculationId?: string;
 };
 
+export declare class MatrixResultContractError extends Error {
+    readonly code: MatrixResultContractErrorCode;
+    readonly path?: string;
+    constructor(input: {
+        code: MatrixResultContractErrorCode;
+        message: string;
+        path?: string;
+    });
+}
+
+export declare type MatrixResultContractErrorCode = 'invalid_matrix_result_contract' | 'unsupported_matrix_result_version';
+
 export declare type MatrixShape = 'hierarchical' | 'pivot';
 
 export declare type MatrixTotals = {
@@ -669,6 +687,17 @@ export declare function normalizeSemaphorDialect(input: string | undefined): Sem
 
 export declare function normalizeSemaphorInputOperator(value: SemaphorInputOperator | string | null | undefined): SemaphorInputOperator | undefined;
 
+/**
+ * The only serialized Matrix result boundary. It validates the structural
+ * schema and the cross-field identity invariants that a shape-only schema
+ * cannot express. Callers pass the returned object to downstream consumers;
+ * they do not inspect or reconstruct unparsed Matrix envelopes.
+ */
+export declare function parseCanonicalMatrixResult(input: unknown): SemaphorMatrixResult;
+
+/** Strictly parses one raw temporal descriptor at a result boundary. */
+export declare function parseRawTemporalValueMetadata(input: unknown): RawTemporalValueMetadata;
+
 export declare function parseSemaphorAnalyzeResult(value: unknown): SemaphorAnalyzeResult;
 
 export declare function parseSemaphorIsoInstant(value: unknown): Date | null;
@@ -679,6 +708,31 @@ export declare function preferSemaphorFieldRefMetadata(current: SemaphorFieldRef
 
 export declare function preferSemaphorSourceMetadata(current: SemaphorSourceRef, next: SemaphorSourceRef): SemaphorSourceRef;
 
+export declare const RAW_TEMPORAL_CONTRACT_ERROR_CODES: {
+    readonly invalidMetadata: "invalid_raw_temporal_metadata";
+};
+
+export declare type RawTemporalContractErrorCode = (typeof RAW_TEMPORAL_CONTRACT_ERROR_CODES)[keyof typeof RAW_TEMPORAL_CONTRACT_ERROR_CODES];
+
+export declare class RawTemporalMetadataContractError extends Error {
+    readonly code: RawTemporalContractErrorCode;
+    constructor(message: string);
+}
+
+/** Authoritative meaning of one ungrouped temporal result column. */
+export declare type RawTemporalValueKind = 'date' | 'wall_datetime' | 'instant';
+
+/**
+ * Result-column metadata for an ungrouped temporal value. This descriptor is
+ * mutually exclusive with grouped `temporalBucket` metadata.
+ */
+export declare type RawTemporalValueMetadata = {
+    kind: 'raw_temporal';
+    valueKind: RawTemporalValueKind;
+};
+
+export declare const rawTemporalValueMetadataSchema: z.ZodType<RawTemporalValueMetadata>;
+
 export declare function resolveDashboardDateComparisonFilterDefinition(filter: unknown): DashboardDateComparisonDefinitionResolution;
 
 export declare function resolveDashboardDateComparisonInputDefinition(input: unknown): DashboardDateComparisonDefinitionResolution;
@@ -2649,7 +2703,7 @@ export declare type SemaphorDataAppCodegenMatrixIntent = {
 
 export declare type SemaphorDataAppCodegenMatrixSortRule = Omit<SemaphorMatrixSortRule, 'by'> & {
     by: {
-        kind: 'label';
+        kind: 'member';
     } | {
         kind: 'field';
         field: SemaphorDataAppCodegenFieldRef;
@@ -3216,6 +3270,8 @@ export declare type SemaphorMatrixAxisLevel = {
     id?: string;
     field: SemaphorFieldRef;
     grain?: SemaphorMatrixTimeGrain;
+    format?: TemporalBucketFormat;
+    semanticTemporalPresentation?: SemaphorMatrixSemanticTemporalPresentation;
     label?: string;
     subtotal?: boolean | SemaphorMatrixSubtotalOptions;
     sortBy?: SemaphorMatrixAxisSortRule;
@@ -3224,7 +3280,7 @@ export declare type SemaphorMatrixAxisLevel = {
 export declare type SemaphorMatrixAxisSortRule = {
     direction: 'asc' | 'desc';
     by: {
-        kind: 'label';
+        kind: 'member';
     } | {
         kind: 'field';
         field: SemaphorFieldRef;
@@ -3281,7 +3337,7 @@ export declare type SemaphorMatrixMemberPathSegment = {
 
 export declare type SemaphorMatrixResult = SemaphorAnalyticsResultBase & {
     kind: 'matrix';
-    schemaVersion: 1;
+    schemaVersion: 2;
     intent?: SemaphorMatrixIntent;
     shape: MatrixShape;
     capabilities: MatrixCapability[];
@@ -3305,12 +3361,17 @@ export declare type SemaphorMatrixResult = SemaphorAnalyticsResultBase & {
 
 export declare const semaphorMatrixResultSchema: z.ZodType<SemaphorMatrixResult>;
 
+export declare type SemaphorMatrixSemanticTemporalPresentation = {
+    granularity: SemaphorMatrixTimeGrain;
+    format: TemporalBucketFormat;
+};
+
 export declare type SemaphorMatrixSortRule = {
     axis: 'row' | 'column';
     targetId?: string;
     direction: 'asc' | 'desc';
     by: {
-        kind: 'label';
+        kind: 'member';
     } | {
         kind: 'field';
         field: SemaphorFieldRef;
@@ -3979,6 +4040,7 @@ export declare type SemaphorResultColumn = {
     source?: SemaphorFieldRef['source'];
     derivedField?: SemaphorDerivedFieldDefinition;
     temporalBucket?: TemporalBucketMetadata;
+    rawTemporal?: RawTemporalValueMetadata;
     pivotIdentity?: SemaphorPivotResultColumnIdentity;
 };
 
@@ -4447,6 +4509,14 @@ export declare function validateMetricComparisonPolarity(value: unknown, path?:
 
 export declare function validateMetricComparisonSpec(value: unknown, path?: string): SemaphorValidationResult;
 
+/**
+ * Validates descriptor exclusivity and datatype compatibility without
+ * inferring temporal meaning from a value or display label.
+ */
+export declare function validateRawTemporalResultColumn(column: Pick<SemaphorResultColumn, 'dataType' | 'rawTemporal' | 'temporalBucket'>, options: {
+    metadataRequired: boolean;
+}): RawTemporalValueMetadata | undefined;
+
 export declare function validateSemaphorAnalyticsIntent(intent: SemaphorAnalyticsIntent): SemaphorAnalyticsValidationResult;
 
 export declare function validateSemaphorAnalyticsRecoveryPlan(plan: SemaphorAnalyticsRecoveryPlan): SemaphorAnalyticsValidationResult;