react-semaphor 0.1.497 → 0.1.498

package/dist/surfboard/index.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("../chunks/index-B8-qrqSa.cjs"),r=require("../chunks/common-types-nBuCd3u2.cjs"),o=require("../chunks/report-preferences-dialog-BOGeoFLL.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-DhBGtRkR.cjs"),r=require("../chunks/common-types-nBuCd3u2.cjs"),o=require("../chunks/report-preferences-dialog-BcaEOgn2.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-Cg8HZmMI.js";
+import { b as a, a as o } from "../chunks/index-DjbQVfS6.js";
 import { C as f, E } from "../chunks/common-types-C6cAQgyh.js";
-import { R as t } from "../chunks/report-preferences-dialog-KI7AgU11.js";
+import { R as t } from "../chunks/report-preferences-dialog-B8DdDM7q.js";
 export {
   f as CONTROL_CARD_DEFAULT_VALUE,
   a as DisplayFormatPreferencesFields,

package/dist/types/index.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const t=require("../chunks/common-types-nBuCd3u2.cjs"),e=require("../chunks/validators-ux2obZB9.cjs"),l=require("../chunks/token-types-CkAGFhiW.cjs"),E=require("../chunks/pivot-result-identity-DEenUrMj.cjs"),a=require("../chunks/report-runtime-context-lSIvyKm2.cjs");exports.CONTROL_CARD_DEFAULT_VALUE=t.CONTROL_CARD_DEFAULT_VALUE;exports.EMPTY_SELECTION=t.EMPTY_SELECTION;exports.CALCULATED_FIELD_ENTITY_MARKER=e.CALCULATED_FIELD_ENTITY_MARKER;exports.DATE_FORMAT_VALUES=e.DATE_FORMAT_VALUES;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=l.DEFAULT_SEMANTIC_DOMAIN_ACCESS;exports.resolveQueryColumnKeyMapEntry=E.resolveQueryColumnKeyMapEntry;exports.resolveUniqueQueryColumnKeyMapEntry=E.resolveUniqueQueryColumnKeyMapEntry;exports.DEFAULT_CALENDAR_CONTEXT=a.DEFAULT_CALENDAR_CONTEXT;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const l=require("../chunks/common-types-nBuCd3u2.cjs"),e=require("../chunks/validators-mhiJSia7.cjs"),t=require("../chunks/field-dependencies-BiyQuGxZ.cjs"),a=require("../chunks/pivot-result-identity-0grcK7bY.cjs"),r=require("../chunks/report-runtime-context-D3t8vyl9.cjs");exports.CONTROL_CARD_DEFAULT_VALUE=l.CONTROL_CARD_DEFAULT_VALUE;exports.EMPTY_SELECTION=l.EMPTY_SELECTION;exports.CALCULATED_FIELD_ENTITY_MARKER=e.CALCULATED_FIELD_ENTITY_MARKER;exports.DATE_FORMAT_VALUES=e.DATE_FORMAT_VALUES;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.isDerivedField=e.isDerivedField;exports.DEFAULT_SEMANTIC_DOMAIN_ACCESS=t.DEFAULT_SEMANTIC_DOMAIN_ACCESS;exports.collectDatasetNamesFromExplorerField=t.collectDatasetNamesFromExplorerField;exports.collectDatasetNamesFromFilterGroup=t.collectDatasetNamesFromFilterGroup;exports.collectExecutionDatasetNamesFromExplorerField=t.collectExecutionDatasetNamesFromExplorerField;exports.collectPreferredDatasetNamesFromExplorerField=t.collectPreferredDatasetNamesFromExplorerField;exports.collectQualifiedDatasetNamesFromExplorerField=t.collectQualifiedDatasetNamesFromExplorerField;exports.datasetRefFromSource=t.datasetRefFromSource;exports.dependencyDisplayIdentity=t.dependencyDisplayIdentity;exports.humanizeDatasetName=t.humanizeDatasetName;exports.resolveFieldDatasetDependencies=t.resolveFieldDatasetDependencies;exports.resolveQueryColumnKeyMapEntry=a.resolveQueryColumnKeyMapEntry;exports.resolveUniqueQueryColumnKeyMapEntry=a.resolveUniqueQueryColumnKeyMapEntry;exports.DEFAULT_CALENDAR_CONTEXT=r.DEFAULT_CALENDAR_CONTEXT;

package/dist/types/index.js

@@ -1,24 +1,34 @@
-import { C as s, E } from "../chunks/common-types-C6cAQgyh.js";
-import { C, D as l, L as t, P as A, g as o, c as _, h as T, d as u, a as L, b as i, i as D } from "../chunks/validators-D-_IT-Xw.js";
-import { D as n } from "../chunks/token-types-BIYFAsGq.js";
-import { r as F, a as M } from "../chunks/pivot-result-identity-sZc1RaIz.js";
-import { D as N } from "../chunks/report-runtime-context-BlDpc-F-.js";
+import { C as s, E as r } from "../chunks/common-types-C6cAQgyh.js";
+import { C as t, D as o, L as i, P as E, g as d, d as m, h as D, e as c, a as C, b as F, i as u, c as n } from "../chunks/validators-CvLOGzT3.js";
+import { D as _, c as T, g as p, f as L, b as N, e as M, d as x, a as y, h as R, r as f } from "../chunks/field-dependencies-CNOgt39w.js";
+import { r as U, a as h } from "../chunks/pivot-result-identity-DBeK76wx.js";
+import { D as S } from "../chunks/report-runtime-context-BziN1eg9.js";
 export {
-  C as CALCULATED_FIELD_ENTITY_MARKER,
+  t as CALCULATED_FIELD_ENTITY_MARKER,
   s as CONTROL_CARD_DEFAULT_VALUE,
-  l as DATE_FORMAT_VALUES,
-  N as DEFAULT_CALENDAR_CONTEXT,
-  n as DEFAULT_SEMANTIC_DOMAIN_ACCESS,
-  E as EMPTY_SELECTION,
-  t as LEGACY_CALCULATED_FIELD_ENTITY_MARKER,
-  A as PivotMarkerEnum,
-  o as getFieldRuntimeColumnName,
-  _ as hasCalculatedFieldMarker,
-  T as hasCalculatedFormulaInputs,
-  u as hasSyntheticCalculatedFieldOwner,
-  L as isCalculatedDimension,
-  i as isCalculatedField,
-  D as isCalculatedMetric,
-  F as resolveQueryColumnKeyMapEntry,
-  M as resolveUniqueQueryColumnKeyMapEntry
+  o as DATE_FORMAT_VALUES,
+  S as DEFAULT_CALENDAR_CONTEXT,
+  _ as DEFAULT_SEMANTIC_DOMAIN_ACCESS,
+  r as EMPTY_SELECTION,
+  i as LEGACY_CALCULATED_FIELD_ENTITY_MARKER,
+  E as PivotMarkerEnum,
+  T as collectDatasetNamesFromExplorerField,
+  p as collectDatasetNamesFromFilterGroup,
+  L as collectExecutionDatasetNamesFromExplorerField,
+  N as collectPreferredDatasetNamesFromExplorerField,
+  M as collectQualifiedDatasetNamesFromExplorerField,
+  x as datasetRefFromSource,
+  y as dependencyDisplayIdentity,
+  d as getFieldRuntimeColumnName,
+  m as hasCalculatedFieldMarker,
+  D as hasCalculatedFormulaInputs,
+  c as hasSyntheticCalculatedFieldOwner,
+  R as humanizeDatasetName,
+  C as isCalculatedDimension,
+  F as isCalculatedField,
+  u as isCalculatedMetric,
+  n as isDerivedField,
+  f as resolveFieldDatasetDependencies,
+  U as resolveQueryColumnKeyMapEntry,
+  h as resolveUniqueQueryColumnKeyMapEntry
 };

package/dist/types/main.d.ts

@@ -11248,6 +11248,15 @@ export declare function isColumnInSqlGen(column: TDataColumn, sqlGen: SqlGen): b
 
 export declare function isDateDataType(dataType: string): boolean;
 
+/**
+ * True for every representation of a derived (calculated) field:
+ * an expression, formula inputs, the shared-contract `derivedField`
+ * (the only shape Matrix-authored calculations may carry), or a synthetic
+ * calculated-field owner. Use this, not `isCalculatedField`, wherever the
+ * question is "is this computed rather than stored".
+ */
+export declare function isDerivedField(field: Field | null | undefined): boolean;
+
 /**
  * Check if an export has completed (successfully or with failure)
  */

package/dist/types/types.d.ts

@@ -1897,6 +1897,16 @@ declare interface ClickFilterInteraction {
     label?: string;
 }
 
+export declare function collectDatasetNamesFromExplorerField(field: ExplorerField | null | undefined, datasets: Set<string>, visitedFields?: Set<string>, visitedGroups?: Set<string>, options?: DatasetCollectionOptions): void;
+
+export declare function collectDatasetNamesFromFilterGroup(filters: FilterGroup | null | undefined, datasets: Set<string>, visitedFields?: Set<string>, visitedGroups?: Set<string>, options?: DatasetCollectionOptions): void;
+
+export declare function collectExecutionDatasetNamesFromExplorerField(field: ExplorerField | null | undefined, datasets: Set<string>, visitedFields?: Set<string>, visitedGroups?: Set<string>): void;
+
+export declare function collectPreferredDatasetNamesFromExplorerField(field: ExplorerField | null | undefined, datasets: Set<string>): void;
+
+export declare function collectQualifiedDatasetNamesFromExplorerField(field: ExplorerField | null | undefined, datasets: Set<string>, visitedFields?: Set<string>, visitedGroups?: Set<string>): void;
+
 export declare type ColorConfig = {
     segments: Record<string, string>;
 };
@@ -4946,6 +4956,13 @@ export declare interface DataModelEntityReference extends DatabaseEntityReferenc
     description: string;
 }
 
+export declare type DatasetCollectionOptions = {
+    /** Include datasets referenced by metric filter conditions. Default true. */
+    includeMetricFilterDatasets?: boolean;
+    /** Emit `qualifiedEntityName` when it is dotted, otherwise `entityName`. Default false. */
+    preferQualifiedIdentity?: boolean;
+};
+
 export declare interface DatasetEntityReference extends DatabaseEntityReference {
     type: 'dataset';
     datasetType: 'physical' | 'virtual';
@@ -4959,6 +4976,14 @@ export declare interface DatasetEntityReference extends DatabaseEntityReference
     description?: string;
 }
 
+/**
+ * The dataset a shared analytics `source` ref names. Semantic sources are
+ * the dataset name; physical sources keep database/schema/table so distinct
+ * tables stay distinct. The single mapping for both the walker and the
+ * calculator's identity resolver.
+ */
+export declare function datasetRefFromSource(source: Field['source'] | undefined): FieldDatasetDependency | undefined;
+
 export declare interface DataSource {
     connectionId: string;
     semanticDomainId?: string;
@@ -5026,6 +5051,9 @@ export declare type DeleteBriefingRunResponse = {
     deletedRunId: string;
 };
 
+/** Best available identity for a dependency: name, else qualified name. */
+export declare function dependencyDisplayIdentity(dep: FieldDatasetDependency): string;
+
 /**
  * Field configuration for detail table columns.
  * Unlike GroupByField, DetailField does not support aggregation or granularity.
@@ -5725,6 +5753,41 @@ declare const expansionShape: z.ZodObject<{
     }[];
 }>;
 
+/**
+ * Field dependency resolution (shared by server planning and client UX)
+ * =====================================================================
+ *
+ * One question, answered in one place for every field representation:
+ *
+ *   "Which datasets does this field read from?"
+ *
+ * Consumers:
+ *   - semaphor-app query planning (join resolution, filter applicability,
+ *     fan-out analysis) via the `collect*` functions, which keep the
+ *     original server API and semantics.
+ *   - react-semaphor field availability ("usable in this chart") via
+ *     `resolveFieldDatasetDependencies`, which returns full dependency
+ *     objects with qualified identity.
+ *
+ * Representations handled, in order, by ONE walker:
+ *   1. A field owned by a real dataset is a leaf on that dataset, even when
+ *      it carries an expression (inline domain expressions, query-local
+ *      aliases). Synthetic owners (the calculated-field markers, the
+ *      `calculated_fields` group, or no owner) are never leaves.
+ *   2. `calculatedFormula.inputFields`: full Field objects, walked
+ *      recursively.
+ *   3. `derivedField.inputs[*].field.source`: the shared analytics contract,
+ *      used only when there are no formula inputs (both encode the same
+ *      inputs). Semantic sources resolve to the dataset name; physical
+ *      sources keep database/schema/table so `public.orders` and
+ *      `archive.orders` stay distinct. This is the only representation
+ *      Matrix-authored calculations may carry.
+ *   4. Metric filter conditions (`parameters.filters`), when requested.
+ *
+ * Adding a representation means adding it here, once.
+ */
+declare type ExplorerField = Field | GroupByField | MetricField;
+
 export declare type ExportDataPayload = {
     cardId: string;
     title: string;
@@ -5803,6 +5866,30 @@ export declare interface Field {
     fieldScope?: FieldScope;
 }
 
+export declare type FieldDatasetDependency = {
+    /**
+     * Dataset name as the catalog knows it (entityName / datasetName / table).
+     * Empty string when the source carried only a qualified name.
+     */
+    entityName: string;
+    entityId?: string;
+    /** Qualified identity when known (`schema.table`, `db.schema.table`, or the field's qualifiedEntityName). */
+    qualifiedEntityName?: string;
+    /** Human label when the source carried one. */
+    label?: string;
+};
+
+export declare type FieldDependencyResolution = {
+    /** Unique datasets, in first-seen order. */
+    datasets: FieldDatasetDependency[];
+    /**
+     * False when at least one input could not be traced to a dataset (for
+     * example a metric-to-metric reference that was not expanded into input
+     * fields). Callers must not claim the field is available in that case.
+     */
+    complete: boolean;
+};
+
 export declare type FieldScope = 'card' | 'sheet' | 'dashboard' | 'domain';
 
 declare type FileAttachment = {
@@ -6117,6 +6204,9 @@ export declare type HtmlOptions = {
     html: string;
 };
 
+/** Humanize a catalog dataset name for customer-facing copy. */
+export declare function humanizeDatasetName(name: string, labels?: Record<string, string>): string;
+
 declare interface InlineDrillEvent extends BaseInteractionEvent {
     interactionMode: 'inlineDrill';
     fetchMode?: 'lazy' | 'preloaded';
@@ -6295,6 +6385,15 @@ export declare function isCalculatedMetric(field: Field): field is MetricField &
     expression: string;
 };
 
+/**
+ * True for every representation of a derived (calculated) field:
+ * an expression, formula inputs, the shared-contract `derivedField`
+ * (the only shape Matrix-authored calculations may carry), or a synthetic
+ * calculated-field owner. Use this, not `isCalculatedField`, wherever the
+ * question is "is this computed rather than stored".
+ */
+export declare function isDerivedField(field: Field | null | undefined): boolean;
+
 export declare interface Join {
     id: string;
     source: DatabaseEntityReference;
@@ -8729,6 +8828,14 @@ declare type ResolvedValueFormatPreferenceSources = {
     defaultCurrency: ReportPreferenceSource;
 };
 
+/**
+ * Resolve the datasets a field reads from, with qualified identity.
+ * Base fields resolve to their own dataset; calculated fields resolve
+ * through their inputs. Metric filter datasets are not included: they do
+ * not affect whether the field itself can be added.
+ */
+export declare function resolveFieldDatasetDependencies(field: Field): FieldDependencyResolution;
+
 export declare function resolveQueryColumnKeyMapEntry(columnKeyMap: QueryColumnKeyMap_2 | undefined, fieldId: string, role: QueryColumnKeyRole): QueryColumnKeyMapEntry | undefined;
 
 export declare function resolveUniqueQueryColumnKeyMapEntry(columnKeyMap: QueryColumnKeyMap_2 | undefined, fieldId: string): QueryColumnKeyMapEntry | undefined;

package/package.json

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