react-semaphor 0.1.449 → 0.1.454

package/dist/types/types.d.ts

@@ -346,8 +346,7 @@ declare type BriefingFragments = {
 
 export declare type BriefingJobConfig = {
     kind: BriefingKind;
-    reportContext: ReportRuntimeContext;
-    resolvedFormats?: ResolvedPresentationEntry[];
+    presentationExecutionSnapshot: PresentationExecutionSnapshot;
     source: BriefingSource;
     body: BriefingBody;
     attachments: BriefingAttachment[];
@@ -702,7 +701,7 @@ export declare type CancelBriefingRunResponse = {
 
 declare type CanonicalDurationUnit = 'millisecond' | 'second' | 'minute' | 'hour' | 'day';
 
-export declare type CanonicalFormatSpec = NumericCanonicalFormat | DateCanonicalFormat | DurationCanonicalFormat | StringCanonicalFormat | TemporalBucketFormat;
+export declare type CanonicalFormatSpec = NumericCanonicalFormat | DateCanonicalFormat | RawTemporalFormat | DurationCanonicalFormat | StringCanonicalFormat | TemporalBucketFormat;
 
 declare type CanonicalPivotResultContract = {
     version: 1;
@@ -1182,7 +1181,6 @@ export declare type CreateBriefingRequest = {
     presentation: BriefingPresentation;
     limits?: BriefingLimits;
     deliveryConfig: BriefingDeliveryConfig | null;
-    resolvedFormats?: ResolvedPresentationEntry[];
 };
 
 export declare type CurrencyPresentationBinding = {
@@ -1408,6 +1406,8 @@ export declare type DashboardProps = {
      * points. Ordinary dashboard consumers should leave this unset.
      */
     interactionExecutionSnapshot?: Record<string, InteractionState>;
+    /** Server-resolved immutable presentation snapshot for internal print views. */
+    presentationExecutionSnapshot?: PresentationExecutionSnapshot;
     /**
      * Render target for print entry points. Generic dashboard PDF exports also
      * use cardDisplay.mode="print"; document-specific print handling must only
@@ -1544,6 +1544,11 @@ export declare type DeleteBriefingRunResponse = {
  */
 export declare interface DetailField extends Omit<Field, 'role' | 'granularity'> {
     role: 'detail';
+    /**
+     * Query transport policy for ungrouped temporal values. This marker is
+     * projected into executable config and is never persisted authoring state.
+     */
+    dateValueMode?: 'canonical' | 'formatted';
     dateFormat?: DateFormatValue;
     customFormat?: string;
     /**
@@ -2371,11 +2376,6 @@ declare interface GroupByColumn extends BaseColumn {
 export declare interface GroupByField extends Field {
     role: 'groupby';
     granularity?: TimeGranularity;
-    /**
-     * Query transport policy for grouped temporal values. This is projected
-     * into executable card config and is not persisted authoring state.
-     */
-    dateValueMode?: 'canonical' | 'formatted';
     /**
      * Optional SQL expression for grouping (e.g., DATE_TRUNC('month', order_date)).
      * If present, used in SELECT and GROUP BY instead of just the column name.
@@ -2656,6 +2656,7 @@ declare type MatrixAxisLevelDescriptor = {
     label: string;
     field: SemaphorFieldRef;
     grain?: SemaphorMatrixTimeGrain;
+    temporalBucket?: TemporalBucketMetadata;
     subtotal?: SemaphorMatrixSubtotalOptions;
 };
 
@@ -2730,7 +2731,8 @@ declare type MatrixFormattingContext = {
 
 declare type MatrixGridColumn = {
     id: string;
-    label: string;
+    /** Present only for measure and explicit total headings. */
+    label?: string;
     columnNodeId?: string;
     columnPath: MatrixMemberPathSegment[];
     measureInstanceId: string;
@@ -2739,7 +2741,8 @@ declare type MatrixGridColumn = {
 
 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;
@@ -2801,7 +2804,8 @@ declare type MatrixMemberPathSegment = {
     instanceId: string;
     fieldKey: string;
     value: unknown;
-    label: string;
+    /** Display-only source label for non-temporal members. */
+    label?: string;
 };
 
 declare type MatrixNode = {
@@ -2809,7 +2813,8 @@ 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;
@@ -3064,11 +3069,6 @@ export declare interface PivotByField extends Field {
      * so existing cards need no migration.
      */
     memberOrder?: PivotMemberOrder;
-    /**
-     * Query transport policy for grouped temporal pivot members. This is
-     * projected into executable config and is never persisted authoring state.
-     */
-    dateValueMode?: 'canonical' | 'formatted';
 }
 
 export declare interface PivotColumnSchema {
@@ -3143,6 +3143,12 @@ export declare type Placeholders = {
 
 export declare type PluginType = 'custom' | 'standard';
 
+declare type PresentationExecutionSnapshot = {
+    version: 1;
+    reportContext: ReportRuntimeContext;
+    resolvedFormats: ResolvedPresentationEntry[];
+};
+
 declare type PresentationScope = {
     dashboardId: string;
     cardId?: string;
@@ -3220,6 +3226,41 @@ declare type RangeValue = {
     gt?: string | number;
 };
 
+/** Normalized authored input for an ungrouped temporal result column. */
+declare type RawTemporalFormat = {
+    type: 'raw_temporal';
+    /** Authored display timezone; `auto` uses the resolved calendar timezone. */
+    timezone?: string;
+    /** Authored source timezone; `auto` means UTC for timezone-less values. */
+    sourceTimezone?: string;
+    presentation: {
+        mode: 'auto';
+    } | {
+        mode: 'pattern';
+        dialect: RawTemporalPatternDialect;
+        pattern: string;
+    };
+};
+
+declare type RawTemporalPatternDialect = 'semaphor_tokens' | 'date_fns';
+
+declare type RawTemporalPresentationTarget = {
+    kind: 'column';
+    columnKey: string;
+};
+
+/** Authoritative meaning of one ungrouped temporal result column. */
+declare type RawTemporalValueKind = 'date' | 'wall_datetime' | 'instant';
+
+/**
+ * Result-column metadata for an ungrouped temporal value. This descriptor is
+ * mutually exclusive with grouped `temporalBucket` metadata.
+ */
+declare type RawTemporalValueMetadata = {
+    kind: 'raw_temporal';
+    valueKind: RawTemporalValueKind;
+};
+
 export declare type RelativeDateFilter = {
     mode: 'last';
     n: number;
@@ -3329,7 +3370,7 @@ declare type ResolvedNumericPresentationEntry = {
     format: NumericCanonicalFormat;
 };
 
-declare type ResolvedPresentationEntry = ResolvedNumericPresentationEntry | ResolvedTemporalBucketPresentationEntry;
+declare type ResolvedPresentationEntry = ResolvedNumericPresentationEntry | ResolvedTemporalBucketPresentationEntry | ResolvedRawTemporalPresentationEntry;
 
 declare type ResolvedPrimaryDateField = (ResolvedPrimaryDateFieldBase & ({
     defaultGranularity?: SemaphorTimeGrain;
@@ -3354,8 +3395,45 @@ declare type ResolvedPrimaryDateFieldBase = {
     supportedGranularities?: SemaphorTimeGrain[];
 };
 
-declare type ResolvedTemporalBucketFormat = TemporalBucketFormat & {
+declare type ResolvedRawTemporalFormat = {
+    type: 'raw_temporal';
+    locale: string;
+    calendarTimezone: string;
+    /** Resolved source timezone for timezone-less wall datetimes, when authored. */
+    sourceTimezone?: string;
+    presentation: {
+        mode: 'auto';
+        styles: ResolvedTemporalStyleSet;
+    } | {
+        mode: 'pattern';
+        dialect: RawTemporalPatternDialect;
+        pattern: string;
+    };
+};
+
+declare type ResolvedRawTemporalPresentationEntry = {
+    scope: PresentationScope;
+    target: RawTemporalPresentationTarget;
+    format: ResolvedRawTemporalFormat;
+};
+
+declare type ResolvedTemporalBucketFormat = {
+    type: 'temporal_bucket';
     locale: string;
+    presentation: {
+        mode: 'auto';
+        styles: ResolvedTemporalStyleSet;
+    };
+} | {
+    type: 'temporal_bucket';
+    locale: string;
+    presentation: {
+        mode: 'preset';
+        preset: TemporalBucketPreset;
+    } | {
+        mode: 'pattern';
+        pattern: string;
+    };
 };
 
 declare type ResolvedTemporalBucketPresentationEntry = {
@@ -3364,6 +3442,14 @@ declare type ResolvedTemporalBucketPresentationEntry = {
     format: ResolvedTemporalBucketFormat;
 };
 
+declare type ResolvedTemporalStyleSet = {
+    dateStyle: LocaleStyle;
+    dateTime: {
+        dateStyle: LocaleStyle;
+        timeStyle: LocaleStyle;
+    };
+};
+
 declare type ResolvedValueFormatPreferences = {
     locale: string;
     dateStyle: LocaleStyle;
@@ -3580,6 +3666,8 @@ declare type SemaphorMatrixAxisLevel = {
     id?: string;
     field: SemaphorFieldRef;
     grain?: SemaphorMatrixTimeGrain;
+    format?: TemporalBucketFormat;
+    semanticTemporalPresentation?: SemaphorMatrixSemanticTemporalPresentation;
     label?: string;
     subtotal?: boolean | SemaphorMatrixSubtotalOptions;
     sortBy?: SemaphorMatrixAxisSortRule;
@@ -3588,7 +3676,7 @@ declare type SemaphorMatrixAxisLevel = {
 declare type SemaphorMatrixAxisSortRule = {
     direction: 'asc' | 'desc';
     by: {
-        kind: 'label';
+        kind: 'member';
     } | {
         kind: 'field';
         field: SemaphorFieldRef;
@@ -3645,7 +3733,7 @@ declare type SemaphorMatrixMemberPathSegment = {
 
 declare type SemaphorMatrixResult = SemaphorAnalyticsResultBase & {
     kind: 'matrix';
-    schemaVersion: 1;
+    schemaVersion: 2;
     intent?: SemaphorMatrixIntent;
     shape: MatrixShape;
     capabilities: MatrixCapability[];
@@ -3667,12 +3755,17 @@ declare type SemaphorMatrixResult = SemaphorAnalyticsResultBase & {
     expansion?: MatrixExpansionResponseHints;
 };
 
+declare type SemaphorMatrixSemanticTemporalPresentation = {
+    granularity: SemaphorMatrixTimeGrain;
+    format: TemporalBucketFormat;
+};
+
 declare type SemaphorMatrixSortRule = {
     axis: 'row' | 'column';
     targetId?: string;
     direction: 'asc' | 'desc';
     by: {
-        kind: 'label';
+        kind: 'member';
     } | {
         kind: 'field';
         field: SemaphorFieldRef;
@@ -3797,6 +3890,7 @@ declare type SemaphorResultColumn = {
     source?: SemaphorFieldRef['source'];
     derivedField?: SemaphorDerivedFieldDefinition;
     temporalBucket?: TemporalBucketMetadata;
+    rawTemporal?: RawTemporalValueMetadata;
     pivotIdentity?: SemaphorPivotResultColumnIdentity;
 };
 

package/dist/types/value-format-preferences.d.ts

@@ -41,6 +41,9 @@ export declare const REPORT_PREFERENCE_SOURCES: readonly ["viewer_user", "viewer
 
 export declare type ReportPreferenceSource = (typeof REPORT_PREFERENCE_SOURCES)[number];
 
+/** Viewer preferences that affect temporal presentation without numeric currency policy. */
+export declare type ResolvedTemporalValueFormatPreferences = Pick<ResolvedValueFormatPreferences, 'locale' | 'dateStyle' | 'dateTime'>;
+
 export declare type ResolvedValueFormatPreferences = {
     locale: string;
     dateStyle: LocaleStyle;

package/package.json

@@ -5,7 +5,7 @@
     "email": "support@semaphor.cloud"
   },
   "license": "MIT",
-  "version": "0.1.449",
+  "version": "0.1.454",
   "description": "Fully interactive and customizable dashboards for your apps.",
   "keywords": [
     "react",
@@ -147,6 +147,7 @@
     "verify:release-artifacts": "npm run verify:metric-comparison-artifact && npm run verify:temporal-bucket-artifact",
     "verify:metric-comparison-artifact": "node scripts/verify-metric-comparison-artifact.mjs",
     "verify:temporal-bucket-artifact": "node scripts/verify-temporal-bucket-artifact.mjs",
+    "verify:temporal-browser": "node scripts/verify-temporal-browser.mjs",
     "deploy": "./scripts/deploy.sh",
     "deploy:patch": "./scripts/deploy.sh patch",
     "deploy:minor": "./scripts/deploy.sh minor",

package/dist/chunks/card-config-utils-15sRtebL.cjs

@@ -1 +0,0 @@
-"use strict";function a(e){if(!e)return!1;const t=e.groupByColumns&&e.groupByColumns.length>0,n=e.metricColumns&&e.metricColumns.length>0,s=e.pivotByColumns&&e.pivotByColumns.length>0,r=e.detailColumns&&e.detailColumns.length>0;return!!(t||n||s||r)}function i(e,t){var u,l,o;if(t!=null&&t.skipSetupCheck||e.type==="text"||(u=e.customCardPreferences)!=null&&u.url)return!1;const n=!!(e.connectionId||(l=e.dataSource)!=null&&l.connectionId),s=!!((o=e.sql)!=null&&o.trim()),r=a(e.config);return!n||!r&&!s}exports.hasValidCardConfig=a;exports.isCardUnconfigured=i;

package/dist/chunks/card-config-utils-BYZ5MJOh.js

@@ -1,16 +0,0 @@
-function a(e) {
-  if (!e) return !1;
-  const t = e.groupByColumns && e.groupByColumns.length > 0, n = e.metricColumns && e.metricColumns.length > 0, s = e.pivotByColumns && e.pivotByColumns.length > 0, r = e.detailColumns && e.detailColumns.length > 0;
-  return !!(t || n || s || r);
-}
-function i(e, t) {
-  var l, u, o;
-  if (t != null && t.skipSetupCheck || e.type === "text" || (l = e.customCardPreferences) != null && l.url)
-    return !1;
-  const n = !!(e.connectionId || (u = e.dataSource) != null && u.connectionId), s = !!((o = e.sql) != null && o.trim()), r = a(e.config);
-  return !n || !r && !s;
-}
-export {
-  a as h,
-  i
-};

package/dist/chunks/catalog-field-grounding-Bnx-3tE0.cjs

@@ -1 +0,0 @@
-"use strict";function l(t){return typeof t=="string"?t.trim().toLowerCase():""}function f(t){return String(t.column_name||t.name||t.qualifiedFieldName||"")}function g(t){return Array.from(new Set([t.column_name,t.name,t.qualifiedFieldName,t.alias].filter(e=>typeof e=="string"&&e.trim().length>0).map(e=>e.trim())))}function d(t){const e=p(t);return e?e.includes("int")||e.includes("uint")||e.includes("bigint")||e.includes("smallint")||e.includes("tinyint")||e.includes("numeric")||e.includes("decimal")||e.includes("double")||e.includes("float")||e.includes("number")||e.includes("real")||e.includes("money")||e.includes("currency")||e.includes("percent")?"number":e.includes("timestamp")||e.includes("datetime")||e.startsWith("time")?"datetime":e.includes("date")?"date":e.includes("bool")?"boolean":"string":"unknown"}function p(t){let e=l(t),i="";for(;e&&e!==i;)i=e,e=y(e,"nullable"),e=y(e,"lowcardinality");return e}function y(t,e){const i=`${e}(`;return!t.startsWith(i)||!t.endsWith(")")?t:t.slice(i.length,-1).trim()}function A(t){const e=d(t);return e==="date"||e==="datetime"}function o(t){return A(t.dataType||t.data_type)}function u(t){const e=C(t);return e==="id"||e==="row_id"}function c(t){const e=C(t);return u(t)||e.endsWith("_id")||e.endsWith("_key")||e.endsWith("_number")}function C(t){return l(f(t)||t.name||t.alias).replace(/[^a-z0-9]+/g,"_").replace(/^_+|_+$/g,"")}function m(t,e={}){const i=l(t.role);return i==="metric"||i==="measure"?!e.excludeIdentifiers||!c(t):i==="groupby"||i==="dimension"||i==="date"||i==="id"?!1:d(t.dataType||t.data_type)==="number"&&(!e.excludeIdentifiers||!c(t))}function D(t){return!m(t)&&!o(t)}function F(t){const e=new Set,i=new Set,s=new Set;for(const a of t){if(u(a))continue;const r=g(a);if(r.length!==0){if(o(a)){r.forEach(n=>i.add(n));continue}if(m(a,{excludeIdentifiers:!0})){r.forEach(n=>e.add(n));continue}r.forEach(n=>s.add(n))}}return{validMeasureCandidates:Array.from(e).sort(),validDateCandidates:Array.from(i).sort(),validDimensionCandidates:Array.from(s).sort()}}exports.buildAnalyticsCatalogFieldSummary=F;exports.getAnalyticsCatalogFieldCandidates=g;exports.getAnalyticsCatalogFieldName=f;exports.isAnalyticsCatalogDateField=o;exports.isAnalyticsCatalogDimensionField=D;exports.isAnalyticsCatalogMetricField=m;exports.isAnalyticsDateLikeDataType=A;exports.isAnalyticsMetricIdentifierField=c;exports.isAnalyticsTechnicalIdentifierField=u;exports.normalizeAnalyticsCatalogDataType=d;exports.normalizeAnalyticsCatalogName=l;

package/dist/chunks/catalog-field-grounding-S2jKwKGD.js

@@ -1,100 +0,0 @@
-function c(n) {
-  return typeof n == "string" ? n.trim().toLowerCase() : "";
-}
-function g(n) {
-  return String(n.column_name || n.name || n.qualifiedFieldName || "");
-}
-function p(n) {
-  return Array.from(
-    new Set(
-      [
-        n.column_name,
-        n.name,
-        n.qualifiedFieldName,
-        n.alias
-      ].filter(
-        (e) => typeof e == "string" && e.trim().length > 0
-      ).map((e) => e.trim())
-    )
-  );
-}
-function o(n) {
-  const e = C(n);
-  return e ? e.includes("int") || e.includes("uint") || e.includes("bigint") || e.includes("smallint") || e.includes("tinyint") || e.includes("numeric") || e.includes("decimal") || e.includes("double") || e.includes("float") || e.includes("number") || e.includes("real") || e.includes("money") || e.includes("currency") || e.includes("percent") ? "number" : e.includes("timestamp") || e.includes("datetime") || e.startsWith("time") ? "datetime" : e.includes("date") ? "date" : e.includes("bool") ? "boolean" : "string" : "unknown";
-}
-function C(n) {
-  let e = c(n), t = "";
-  for (; e && e !== t; )
-    t = e, e = d(e, "nullable"), e = d(e, "lowcardinality");
-  return e;
-}
-function d(n, e) {
-  const t = `${e}(`;
-  return !n.startsWith(t) || !n.endsWith(")") ? n : n.slice(t.length, -1).trim();
-}
-function A(n) {
-  const e = o(n);
-  return e === "date" || e === "datetime";
-}
-function u(n) {
-  return A(n.dataType || n.data_type);
-}
-function m(n) {
-  const e = f(n);
-  return e === "id" || e === "row_id";
-}
-function l(n) {
-  const e = f(n);
-  return m(n) || e.endsWith("_id") || e.endsWith("_key") || e.endsWith("_number");
-}
-function f(n) {
-  return c(
-    g(n) || n.name || n.alias
-  ).replace(/[^a-z0-9]+/g, "_").replace(/^_+|_+$/g, "");
-}
-function y(n, e = {}) {
-  const t = c(n.role);
-  return t === "metric" || t === "measure" ? !e.excludeIdentifiers || !l(n) : t === "groupby" || t === "dimension" || t === "date" || t === "id" ? !1 : o(
-    n.dataType || n.data_type
-  ) === "number" && (!e.excludeIdentifiers || !l(n));
-}
-function h(n) {
-  return !y(n) && !u(n);
-}
-function D(n) {
-  const e = /* @__PURE__ */ new Set(), t = /* @__PURE__ */ new Set(), s = /* @__PURE__ */ new Set();
-  for (const a of n) {
-    if (m(a))
-      continue;
-    const r = p(a);
-    if (r.length !== 0) {
-      if (u(a)) {
-        r.forEach((i) => t.add(i));
-        continue;
-      }
-      if (y(a, { excludeIdentifiers: !0 })) {
-        r.forEach((i) => e.add(i));
-        continue;
-      }
-      r.forEach((i) => s.add(i));
-    }
-  }
-  return {
-    validMeasureCandidates: Array.from(e).sort(),
-    validDateCandidates: Array.from(t).sort(),
-    validDimensionCandidates: Array.from(s).sort()
-  };
-}
-export {
-  c as a,
-  p as b,
-  u as c,
-  m as d,
-  l as e,
-  y as f,
-  g,
-  h,
-  A as i,
-  D as j,
-  o as n
-};