react-semaphor 0.1.467 → 0.1.469

package/dist/surfboard/index.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("../chunks/index-yJRh4x9j.cjs"),r=require("../chunks/common-types-o3LJcrpg.cjs"),o=require("../chunks/report-preferences-dialog-CRNoMzNj.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-DKaQRhKm.cjs"),r=require("../chunks/common-types-tRK8fhXV.cjs"),o=require("../chunks/report-preferences-dialog-C5UOCTwt.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-B31RKKGb.js";
-import { C as f, E } from "../chunks/common-types-Co766x6t.js";
-import { R as t } from "../chunks/report-preferences-dialog-CZPqG-em.js";
+import { b as a, a as o } from "../chunks/index-8Cm77joZ.js";
+import { C as f, E } from "../chunks/common-types-BgI-ymBp.js";
+import { R as t } from "../chunks/report-preferences-dialog-D-NDYRrk.js";
 export {
   f as CONTROL_CARD_DEFAULT_VALUE,
   a as DisplayFormatPreferencesFields,

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

@@ -71,6 +71,13 @@ export declare type CanonicalDashboardRecordsPayload = DashboardRecordsPayload &
 
 export declare const canonicalDashboardRecordsPayloadSchema: z.ZodType<CanonicalDashboardRecordsPayload>;
 
+/**
+ * Canonicalizes a persisted metadata path. This does not parse authored SQL;
+ * it only unwraps the segment-level double quotes produced by dashboard filter
+ * persistence while preserving identifier case.
+ */
+export declare function canonicalizeSemaphorQualifiedSourcePath(value: string | undefined): string | undefined;
+
 export declare function canonicalizeSemaphorSourceIdentity(source: SemaphorSemanticSourceRef_2): SemaphorSemanticSourceRef_2;
 
 export declare function canonicalizeSemaphorSourceIdentity(source: SemaphorSourceRef): SemaphorSourceRef;
@@ -238,6 +245,12 @@ export declare function isSemaphorDataAppCodegenSummary(value: unknown): value i
 
 export declare function isSemaphorMatrixTimeGrain(value: unknown): value is SemaphorMatrixTimeGrain;
 
+/**
+ * Classifies persisted selected-entity metadata. This is structural metadata
+ * handling; it does not inspect or parse authored SQL.
+ */
+export declare function isSemaphorPhysicalSourceEntity(value: unknown): boolean;
+
 export declare function isSemaphorTimeGrain(value: unknown): value is SemaphorTimeGrain;
 
 export declare type MatrixAxisLevelDescriptor = {
@@ -715,6 +728,11 @@ export declare function parseSemaphorIsoInstant(value: unknown): Date | null;
 
 export declare function parseSemaphorIsoTimeWindowBoundary(value: unknown): Date | null;
 
+export declare function parseSemaphorQualifiedSourcePath(input: {
+    qualifiedName: string | undefined;
+    capabilities: Pick<SemaphorConnectionCapabilities, 'prefixLevels'>;
+}): SemaphorSourceCoordinateInput;
+
 export declare function preferSemaphorFieldRefMetadata(current: SemaphorFieldRef, next: SemaphorFieldRef): SemaphorFieldRef;
 
 export declare function preferSemaphorSourceMetadata(current: SemaphorSourceRef, next: SemaphorSourceRef): SemaphorSourceRef;
@@ -809,6 +827,13 @@ export declare function resolveMetricComparisonRequest(input: {
 /** Stable result-instance identity shared by query producers and consumers. */
 export declare function resolveMetricResultAlias(metric: MetricResultAliasInput): string;
 
+/**
+ * Resolves one physical source from persisted structural identity hints.
+ * Qualified identity takes precedence over conflicting bare hints, while
+ * malformed, mutually conflicting, or ambiguous identity fails closed.
+ */
+export declare function resolveSemaphorPhysicalSourceEntity<T>(input: SemaphorPhysicalSourceResolutionInput<T>): SemaphorPhysicalSourceResolution<T>;
+
 export declare function resolveTemporalContext(input: ResolveTemporalContextInput): ResolvedTemporalContext;
 
 export declare type ResolveTemporalContextInput = {
@@ -3707,6 +3732,23 @@ export declare type SemaphorPaginationRequest = {
     pageSize: number;
 };
 
+export declare function semaphorPhysicalSourceCoordinatesAreCompatible(input: {
+    left: SemaphorSourceCoordinateInput;
+    right: SemaphorSourceCoordinateInput;
+    capabilities: Pick<SemaphorConnectionCapabilities, 'prefixLevels'>;
+}): boolean;
+
+/**
+ * Returns whether an allowed physical source contains every coordinate named
+ * by the requested source. Unlike symmetric compatibility, a missing allowed
+ * coordinate cannot satisfy a more-qualified request.
+ */
+export declare function semaphorPhysicalSourceCoordinatesCover(input: {
+    requested: SemaphorSourceCoordinateInput;
+    allowed: SemaphorSourceCoordinateInput;
+    capabilities: Pick<SemaphorConnectionCapabilities, 'prefixLevels'>;
+}): boolean;
+
 export declare const semaphorPhysicalSourceRefSchema: z.ZodObject<{
     kind: z.ZodLiteral<"physical">;
     connectionId: z.ZodString;
@@ -3736,6 +3778,38 @@ export declare const semaphorPhysicalSourceRefSchema: z.ZodObject<{
     dialect: z.ZodOptional<z.ZodEnum<["postgres", "mysql", "mssql", "snowflake", "clickhouse", "bigquery", "redshift", "duckdb", "sqlite", "unknown"]>>;
 }, z.ZodTypeAny, "passthrough">>;
 
+export declare type SemaphorPhysicalSourceResolution<T> = {
+    kind: 'resolved';
+    basis: SemaphorPhysicalSourceResolutionBasis;
+    entity: T;
+    coordinates: SemaphorSourceCoordinateInput;
+} | {
+    kind: 'unqualified';
+} | {
+    kind: 'malformed';
+} | {
+    kind: 'conflicting';
+} | {
+    kind: 'ambiguous';
+    basis: Exclude<SemaphorPhysicalSourceResolutionBasis, 'unqualified'>;
+} | {
+    kind: 'not_found';
+    basis: Exclude<SemaphorPhysicalSourceResolutionBasis, 'unqualified'>;
+    coordinates?: SemaphorSourceCoordinateInput;
+} | {
+    kind: 'incompatible_capabilities';
+};
+
+export declare type SemaphorPhysicalSourceResolutionBasis = 'qualified' | 'bare' | 'unqualified';
+
+export declare type SemaphorPhysicalSourceResolutionInput<T> = {
+    entities: readonly T[];
+    connectionType?: string;
+    qualifiedHints?: ReadonlyArray<string | undefined>;
+    bareHints?: ReadonlyArray<string | undefined>;
+    coordinateHint?: SemaphorSourceCoordinateInput;
+};
+
 export declare type SemaphorPivotResultColumnIdentity = {
     metricId: string;
     /** Collision-safe identity for this configured metric instance. */

package/dist/types/index.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("../chunks/common-types-o3LJcrpg.cjs"),l=require("../chunks/token-types-DALtlgbG.cjs"),t=require("../chunks/pivot-result-identity-gsOwOjHi.cjs"),E=require("../chunks/report-runtime-context-CLtzrZdC.cjs");exports.CALCULATED_FIELD_ENTITY_MARKER=e.CALCULATED_FIELD_ENTITY_MARKER;exports.CONTROL_CARD_DEFAULT_VALUE=e.CONTROL_CARD_DEFAULT_VALUE;exports.DATE_FORMAT_VALUES=e.DATE_FORMAT_VALUES;exports.EMPTY_SELECTION=e.EMPTY_SELECTION;exports.PivotMarkerEnum=e.PivotMarkerEnum;exports.getFieldRuntimeColumnName=e.getFieldRuntimeColumnName;exports.hasCalculatedFieldMarker=e.hasCalculatedFieldMarker;exports.hasCalculatedFormulaInputs=e.hasCalculatedFormulaInputs;exports.isCalculatedDimension=e.isCalculatedDimension;exports.isCalculatedField=e.isCalculatedField;exports.isCalculatedMetric=e.isCalculatedMetric;exports.DEFAULT_SEMANTIC_DOMAIN_ACCESS=l.DEFAULT_SEMANTIC_DOMAIN_ACCESS;exports.resolveQueryColumnKeyMapEntry=t.resolveQueryColumnKeyMapEntry;exports.resolveUniqueQueryColumnKeyMapEntry=t.resolveUniqueQueryColumnKeyMapEntry;exports.DEFAULT_CALENDAR_CONTEXT=E.DEFAULT_CALENDAR_CONTEXT;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("../chunks/common-types-tRK8fhXV.cjs"),t=require("../chunks/token-types-DALtlgbG.cjs"),E=require("../chunks/pivot-result-identity-gsOwOjHi.cjs"),l=require("../chunks/report-runtime-context-CLtzrZdC.cjs");exports.CALCULATED_FIELD_ENTITY_MARKER=e.CALCULATED_FIELD_ENTITY_MARKER;exports.CONTROL_CARD_DEFAULT_VALUE=e.CONTROL_CARD_DEFAULT_VALUE;exports.DATE_FORMAT_VALUES=e.DATE_FORMAT_VALUES;exports.EMPTY_SELECTION=e.EMPTY_SELECTION;exports.LEGACY_CALCULATED_FIELD_ENTITY_MARKER=e.LEGACY_CALCULATED_FIELD_ENTITY_MARKER;exports.PivotMarkerEnum=e.PivotMarkerEnum;exports.getFieldRuntimeColumnName=e.getFieldRuntimeColumnName;exports.hasCalculatedFieldMarker=e.hasCalculatedFieldMarker;exports.hasCalculatedFormulaInputs=e.hasCalculatedFormulaInputs;exports.hasSyntheticCalculatedFieldOwner=e.hasSyntheticCalculatedFieldOwner;exports.isCalculatedDimension=e.isCalculatedDimension;exports.isCalculatedField=e.isCalculatedField;exports.isCalculatedMetric=e.isCalculatedMetric;exports.DEFAULT_SEMANTIC_DOMAIN_ACCESS=t.DEFAULT_SEMANTIC_DOMAIN_ACCESS;exports.resolveQueryColumnKeyMapEntry=E.resolveQueryColumnKeyMapEntry;exports.resolveUniqueQueryColumnKeyMapEntry=E.resolveUniqueQueryColumnKeyMapEntry;exports.DEFAULT_CALENDAR_CONTEXT=l.DEFAULT_CALENDAR_CONTEXT;

package/dist/types/index.js

@@ -1,21 +1,23 @@
-import { a as s, C as r, D as E, E as l, P as C, g as o, d as t, h as A, b as u, c as T, i as _ } from "../chunks/common-types-Co766x6t.js";
-import { D } from "../chunks/token-types-p1M3SA2G.js";
-import { r as n, a as L } from "../chunks/pivot-result-identity-BvT51Nog.js";
-import { D as d } from "../chunks/report-runtime-context-CrTzKt0C.js";
+import { a as s, C as E, D as C, E as l, L as r, P as A, g as t, d as _, h as T, e as o, b as u, c as L, i } from "../chunks/common-types-BgI-ymBp.js";
+import { D as n } from "../chunks/token-types-Z889rD6g.js";
+import { r as d, a as F } from "../chunks/pivot-result-identity-CCMpd8ZA.js";
+import { D as c } from "../chunks/report-runtime-context-CcXUjpb-.js";
 export {
   s as CALCULATED_FIELD_ENTITY_MARKER,
-  r as CONTROL_CARD_DEFAULT_VALUE,
-  E as DATE_FORMAT_VALUES,
-  d as DEFAULT_CALENDAR_CONTEXT,
-  D as DEFAULT_SEMANTIC_DOMAIN_ACCESS,
+  E as CONTROL_CARD_DEFAULT_VALUE,
+  C as DATE_FORMAT_VALUES,
+  c as DEFAULT_CALENDAR_CONTEXT,
+  n as DEFAULT_SEMANTIC_DOMAIN_ACCESS,
   l as EMPTY_SELECTION,
-  C as PivotMarkerEnum,
-  o as getFieldRuntimeColumnName,
-  t as hasCalculatedFieldMarker,
-  A as hasCalculatedFormulaInputs,
+  r as LEGACY_CALCULATED_FIELD_ENTITY_MARKER,
+  A as PivotMarkerEnum,
+  t as getFieldRuntimeColumnName,
+  _ as hasCalculatedFieldMarker,
+  T as hasCalculatedFormulaInputs,
+  o as hasSyntheticCalculatedFieldOwner,
   u as isCalculatedDimension,
-  T as isCalculatedField,
-  _ as isCalculatedMetric,
-  n as resolveQueryColumnKeyMapEntry,
-  L as resolveUniqueQueryColumnKeyMapEntry
+  L as isCalculatedField,
+  i as isCalculatedMetric,
+  d as resolveQueryColumnKeyMapEntry,
+  F as resolveUniqueQueryColumnKeyMapEntry
 };

package/dist/types/main.d.ts

@@ -4059,6 +4059,13 @@ export declare function hasCalculatedFieldMarker(field: Pick<Field, 'entityName'
 
 export declare function hasCalculatedFormulaInputs(field: Field | null | undefined): boolean;
 
+/**
+ * Identifies the synthetic owner used by calculated fields. New fields use
+ * CALCULATED_FIELD_ENTITY_MARKER, while persisted dashboards may still carry
+ * the historical `calculated_fields` namespace.
+ */
+export declare function hasSyntheticCalculatedFieldOwner(field: Partial<Pick<Field, 'entityName' | 'entityId' | 'qualifiedEntityName'>> | null | undefined): boolean;
+
 export declare type HtmlOptions = {
     html: string;
 };
@@ -4300,6 +4307,8 @@ export declare type KPICardProps = {
     renderFilterInfo?: () => JSX_2.Element | null;
 };
 
+export declare const LEGACY_CALCULATED_FIELD_ENTITY_MARKER: "calculated_fields";
+
 export declare type LensInputValuesSnapshot = {
     generatedAt: string;
     dashboardInputValues: DashboardInputValues;
@@ -6393,6 +6402,7 @@ declare interface TableActions {
     updateColumnVisibility: (columnId: string, isVisible: boolean) => void;
     updateColumnSizing: (sizing: ColumnSizingState) => void;
     updatePageSize: (pageSize: number) => void;
+    updateEnableDevModePagination: (enabled: boolean) => void;
     showAllColumns: () => void;
     hideAllColumns: () => void;
     toggleSelectColumn: (isVisible: boolean) => void;

package/dist/types/types.d.ts

@@ -2457,6 +2457,13 @@ export declare function hasCalculatedFieldMarker(field: Pick<Field, 'entityName'
 
 export declare function hasCalculatedFormulaInputs(field: Field | null | undefined): boolean;
 
+/**
+ * Identifies the synthetic owner used by calculated fields. New fields use
+ * CALCULATED_FIELD_ENTITY_MARKER, while persisted dashboards may still carry
+ * the historical `calculated_fields` namespace.
+ */
+export declare function hasSyntheticCalculatedFieldOwner(field: Partial<Pick<Field, 'entityName' | 'entityId' | 'qualifiedEntityName'>> | null | undefined): boolean;
+
 export declare type HtmlOptions = {
     html: string;
 };
@@ -2676,6 +2683,8 @@ export declare type KPICardProps = {
     renderFilterInfo?: () => JSX.Element | null;
 };
 
+export declare const LEGACY_CALCULATED_FIELD_ENTITY_MARKER: "calculated_fields";
+
 export declare type LensInputValuesSnapshot = {
     generatedAt: string;
     dashboardInputValues: DashboardInputValues;

package/package.json

@@ -5,7 +5,7 @@
     "email": "support@semaphor.cloud"
   },
   "license": "MIT",
-  "version": "0.1.467",
+  "version": "0.1.469",
   "description": "Fully interactive and customizable dashboards for your apps.",
   "keywords": [
     "react",

package/dist/chunks/common-types-o3LJcrpg.cjs

@@ -1 +0,0 @@
-"use strict";require("./validators-DO-YuzgO.cjs");const e="SEMAPHOR_CALCULATED_FIELD";function u(Y){return(Y==null?void 0:Y.sourceField)||(Y==null?void 0:Y.name)||""}const s=["MM-DD-YYYY","YYYY-MM-DD","MM/DD/YYYY","DD/MM/YYYY","MMMM DD, YYYY","MMM DD, YYYY","DD MMM YYYY","YYYY-MM-DD HH:mm","YYYY-MM-DD HH:mm:ss","YYYY-MM-DD HH:mm Z","YYYY-MM-DD HH:mm:ss Z","Week of MMM DD, YYYY","Week of MMMM DD, YYYY","YYYY-WW","MMM YYYY","MMMM YYYY","YYYY-MM","MM/YYYY","YYYY MMM","Q1 YYYY","YYYY Q1","1st Quarter YYYY","YYYY-Q1","Quarter 1, YYYY","YYYY","YY","custom"];function D(Y){return Y.role==="metric"&&"expression"in Y&&!!Y.expression}function r(Y){return!!Y.expression}function _(Y){return!!Y.expression}function l(Y){var t,n;const M=Y;return!!(M!=null&&M.expression&&((n=(t=M.calculatedFormula)==null?void 0:t.inputFields)!=null&&n.length))}function o(Y){return!!(Y&&(Y.entityName===e||Y.entityId===e))}var a=(Y=>(Y.SUBTOTAL="__SUBTOTAL__",Y.TOTAL="__TOTAL__",Y.ALL="__ALL__",Y))(a||{});const c={database:null,schema:null,table:null},A="__card_default__";exports.CALCULATED_FIELD_ENTITY_MARKER=e;exports.CONTROL_CARD_DEFAULT_VALUE=A;exports.DATE_FORMAT_VALUES=s;exports.EMPTY_SELECTION=c;exports.PivotMarkerEnum=a;exports.getFieldRuntimeColumnName=u;exports.hasCalculatedFieldMarker=o;exports.hasCalculatedFormulaInputs=l;exports.isCalculatedDimension=r;exports.isCalculatedField=_;exports.isCalculatedMetric=D;