react-semaphor 0.1.420 → 0.1.422

package/dist/surfboard/index.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const r=require("../chunks/index-yxKWKFdr.js"),e=require("../chunks/common-types-C73-Ud1-.js"),a=require("../chunks/calendar-preferences-dialog-f0Z7Kf-U.js");exports.Surfboard=r.DashboardPlus;exports.CONTROL_CARD_DEFAULT_VALUE=e.CONTROL_CARD_DEFAULT_VALUE;exports.EMPTY_SELECTION=e.EMPTY_SELECTION;exports.CalendarPreferencesDialog=a.CalendarPreferencesDialog;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const r=require("../chunks/index-8y8XX7sX.js"),e=require("../chunks/common-types-C73-Ud1-.js"),a=require("../chunks/calendar-preferences-dialog-C2fBRNZh.js");exports.Surfboard=r.DashboardPlus;exports.CONTROL_CARD_DEFAULT_VALUE=e.CONTROL_CARD_DEFAULT_VALUE;exports.EMPTY_SELECTION=e.EMPTY_SELECTION;exports.CalendarPreferencesDialog=a.CalendarPreferencesDialog;

package/dist/surfboard/index.js

@@ -1,6 +1,6 @@
-import { a as e } from "../chunks/index-B6DLEXRX.js";
+import { a as e } from "../chunks/index-OD6mLD7U.js";
 import { C, E } from "../chunks/common-types-4bjoIgvm.js";
-import { C as s } from "../chunks/calendar-preferences-dialog-DIfAbE_y.js";
+import { C as s } from "../chunks/calendar-preferences-dialog-Cbavs2EK.js";
 export {
   C as CONTROL_CARD_DEFAULT_VALUE,
   s as CalendarPreferencesDialog,

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

@@ -2576,6 +2576,15 @@ export declare type SemaphorDataAppImplementationChecklist = {
     browserSmokeChecks: string[];
 };
 
+export declare type SemaphorDataAppRawIdentifierFilterDiagnostic = {
+    kind: 'raw_identifier_filter_options';
+    inputId: string;
+    inputLabel: string;
+    optionSource: SemaphorDataAppRelationshipCandidateSource;
+    optionField: SemaphorDataAppRelationshipCandidateField;
+    missingEvidence: Array<'display_field' | 'relationship_display_path'>;
+};
+
 export declare type SemaphorDataAppRelationshipCandidate = {
     source: SemaphorDataAppRelationshipCandidateSource;
     sourceFields: SemaphorDataAppRelationshipCandidateField[];
@@ -2610,8 +2619,9 @@ export declare type SemaphorDataAppRequiredInputOption = {
 export declare type SemaphorDataAppUnsupportedInsight = {
     title: string;
     requestedQuestion: string;
-    reason: 'missing_measure' | 'missing_dimension' | 'missing_date' | 'missing_relationship' | 'missing_semantic_role' | 'missing_current_app_state' | 'unsupported_change_intent' | 'ambiguous_field_grounding' | 'bounded_intent_unavailable' | 'invalid_bounded_intent_output' | 'latest_snapshot_selector_not_modeled' | 'unsupported_grain' | 'requires_sql_escape_hatch' | 'unsupported_sdk_capability';
+    reason: 'missing_measure' | 'missing_dimension' | 'missing_date' | 'missing_relationship' | 'missing_semantic_role' | 'missing_current_app_state' | 'raw_identifier_filter_options' | 'unsupported_change_intent' | 'ambiguous_field_grounding' | 'bounded_intent_unavailable' | 'invalid_bounded_intent_output' | 'latest_snapshot_selector_not_modeled' | 'unsupported_grain' | 'requires_sql_escape_hatch' | 'unsupported_sdk_capability';
     suggestedModelingFix: string;
+    diagnostic?: SemaphorDataAppRawIdentifierFilterDiagnostic;
     relationshipCandidate?: SemaphorDataAppRelationshipCandidate;
     nextRepairAction?: {
         tool: 'semaphor_propose_semantic_model_change';
@@ -2656,9 +2666,6 @@ export declare type SemaphorDerivedFieldResultRole = 'measure' | 'dimension' | '
 export declare type SemaphorDialect = 'postgres' | 'mysql' | 'mssql' | 'snowflake' | 'clickhouse' | 'bigquery' | 'redshift' | 'duckdb' | 'sqlite' | 'unknown';
 
 export declare type SemaphorExecutionFieldRef = SemaphorFieldRef & {
-    semanticAggregate?: SemaphorAggregateFunction;
-    effectiveAggregate?: SemaphorAggregateFunction;
-    aggregateSource?: SemaphorMetricAggregateSource;
     derivedField?: SemaphorDerivedFieldDefinition;
 };
 
@@ -3011,7 +3018,7 @@ export declare type SemaphorMatrixValueField = {
     totalBehavior?: SemaphorMatrixTotalCalculation;
 };
 
-export declare type SemaphorMetricAggregateSource = 'semantic_model' | 'caller_override' | 'default_sum';
+export declare function semaphorMetricAggregate(field: Pick<SemaphorFieldRef, 'aggregate'>): string;
 
 export declare type SemaphorMetricAnalysis = {
     kind: 'period_change';
@@ -3052,7 +3059,6 @@ export declare function semaphorMetricMeasureBindingKey(field: SemaphorFieldRef)
 
 export declare type SemaphorMetricResult = SemaphorAnalyticsResultBase & {
     kind: 'metric';
-    value: number | string | null;
     primaryValue: number | string | null;
     missingMeasures?: string[];
     comparison?: {
@@ -3065,7 +3071,6 @@ export declare type SemaphorMetricResult = SemaphorAnalyticsResultBase & {
 
 export declare const semaphorMetricResultSchema: z.ZodObject<{
     kind: z.ZodLiteral<"metric">;
-    value: z.ZodUnion<[z.ZodNumber, z.ZodString, z.ZodNull]>;
     primaryValue: z.ZodUnion<[z.ZodNumber, z.ZodString, z.ZodNull]>;
     measures: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<[z.ZodNumber, z.ZodString, z.ZodNull]>>>;
     missingMeasures: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
@@ -3116,7 +3121,6 @@ export declare const semaphorMetricResultSchema: z.ZodObject<{
     }, z.ZodTypeAny, "passthrough">>>;
 }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
     kind: z.ZodLiteral<"metric">;
-    value: z.ZodUnion<[z.ZodNumber, z.ZodString, z.ZodNull]>;
     primaryValue: z.ZodUnion<[z.ZodNumber, z.ZodString, z.ZodNull]>;
     measures: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<[z.ZodNumber, z.ZodString, z.ZodNull]>>>;
     missingMeasures: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
@@ -3167,7 +3171,6 @@ export declare const semaphorMetricResultSchema: z.ZodObject<{
     }, z.ZodTypeAny, "passthrough">>>;
 }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
     kind: z.ZodLiteral<"metric">;
-    value: z.ZodUnion<[z.ZodNumber, z.ZodString, z.ZodNull]>;
     primaryValue: z.ZodUnion<[z.ZodNumber, z.ZodString, z.ZodNull]>;
     measures: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<[z.ZodNumber, z.ZodString, z.ZodNull]>>>;
     missingMeasures: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;

package/dist/types/dashboard-assistant.d.ts

@@ -1070,9 +1070,6 @@ declare type SemaphorDerivedFieldResultRole = 'measure' | 'dimension' | 'date' |
 declare type SemaphorDialect = 'postgres' | 'mysql' | 'mssql' | 'snowflake' | 'clickhouse' | 'bigquery' | 'redshift' | 'duckdb' | 'sqlite' | 'unknown';
 
 declare type SemaphorExecutionFieldRef = SemaphorFieldRef & {
-    semanticAggregate?: SemaphorAggregateFunction;
-    effectiveAggregate?: SemaphorAggregateFunction;
-    aggregateSource?: SemaphorMetricAggregateSource;
     derivedField?: SemaphorDerivedFieldDefinition;
 };
 
@@ -1297,8 +1294,6 @@ declare type SemaphorMatrixValueField = {
     totalBehavior?: SemaphorMatrixTotalCalculation;
 };
 
-declare type SemaphorMetricAggregateSource = 'semantic_model' | 'caller_override' | 'default_sum';
-
 declare type SemaphorMetricAnalysis = {
     kind: 'period_change';
     orderBy?: 'absolute_change' | 'positive_change' | 'negative_change' | 'period';
@@ -1336,7 +1331,6 @@ declare type SemaphorMetricIntent = {
 
 declare type SemaphorMetricResult = SemaphorAnalyticsResultBase & {
     kind: 'metric';
-    value: number | string | null;
     primaryValue: number | string | null;
     missingMeasures?: string[];
     comparison?: {

package/dist/types/data-app-codegen-node.d.ts

@@ -75,7 +75,7 @@ export declare function isSemaphorDataAppCodegenSummary(value: unknown): value i
 
 declare type JsonRecord = Record<string, unknown>;
 
-export declare const REQUIRED_GENERATED_CONTRACT_FILES: readonly ["sources.ts", "fields.ts", "inputs.ts", "queries.ts", "bindings.ts", "accessors.ts", "metadata.ts", "index.ts", "contract.manifest.json"];
+export declare const REQUIRED_GENERATED_CONTRACT_FILES: readonly ["sources.ts", "fields.ts", "inputs.ts", "queries.ts", "bindings.ts", "accessors.ts", "metadata.ts", "index.ts", "USAGE.md", "contract.manifest.json"];
 
 export declare const SEMAPHOR_DATA_APP_CODEGEN_SUMMARY_SCHEMA_VERSION: "semaphor-data-app-codegen-summary/v1";
 
@@ -631,6 +631,15 @@ declare type SemaphorDataAppImplementationChecklist = {
     browserSmokeChecks: string[];
 };
 
+declare type SemaphorDataAppRawIdentifierFilterDiagnostic = {
+    kind: 'raw_identifier_filter_options';
+    inputId: string;
+    inputLabel: string;
+    optionSource: SemaphorDataAppRelationshipCandidateSource;
+    optionField: SemaphorDataAppRelationshipCandidateField;
+    missingEvidence: Array<'display_field' | 'relationship_display_path'>;
+};
+
 declare type SemaphorDataAppRelationshipCandidate = {
     source: SemaphorDataAppRelationshipCandidateSource;
     sourceFields: SemaphorDataAppRelationshipCandidateField[];
@@ -665,8 +674,9 @@ declare type SemaphorDataAppRequiredInputOption = {
 declare type SemaphorDataAppUnsupportedInsight = {
     title: string;
     requestedQuestion: string;
-    reason: 'missing_measure' | 'missing_dimension' | 'missing_date' | 'missing_relationship' | 'missing_semantic_role' | 'missing_current_app_state' | 'unsupported_change_intent' | 'ambiguous_field_grounding' | 'bounded_intent_unavailable' | 'invalid_bounded_intent_output' | 'latest_snapshot_selector_not_modeled' | 'unsupported_grain' | 'requires_sql_escape_hatch' | 'unsupported_sdk_capability';
+    reason: 'missing_measure' | 'missing_dimension' | 'missing_date' | 'missing_relationship' | 'missing_semantic_role' | 'missing_current_app_state' | 'raw_identifier_filter_options' | 'unsupported_change_intent' | 'ambiguous_field_grounding' | 'bounded_intent_unavailable' | 'invalid_bounded_intent_output' | 'latest_snapshot_selector_not_modeled' | 'unsupported_grain' | 'requires_sql_escape_hatch' | 'unsupported_sdk_capability';
     suggestedModelingFix: string;
+    diagnostic?: SemaphorDataAppRawIdentifierFilterDiagnostic;
     relationshipCandidate?: SemaphorDataAppRelationshipCandidate;
     nextRepairAction?: {
         tool: 'semaphor_propose_semantic_model_change';

package/dist/types/data-app-codegen.d.ts

@@ -71,7 +71,7 @@ export declare function isSemaphorDataAppCodegenSummary(value: unknown): value i
 
 declare type JsonRecord = Record<string, unknown>;
 
-export declare const REQUIRED_GENERATED_CONTRACT_FILES: readonly ["sources.ts", "fields.ts", "inputs.ts", "queries.ts", "bindings.ts", "accessors.ts", "metadata.ts", "index.ts", "contract.manifest.json"];
+export declare const REQUIRED_GENERATED_CONTRACT_FILES: readonly ["sources.ts", "fields.ts", "inputs.ts", "queries.ts", "bindings.ts", "accessors.ts", "metadata.ts", "index.ts", "USAGE.md", "contract.manifest.json"];
 
 export declare const SEMAPHOR_DATA_APP_CODEGEN_SUMMARY_SCHEMA_VERSION: "semaphor-data-app-codegen-summary/v1";
 
@@ -621,6 +621,15 @@ declare type SemaphorDataAppImplementationChecklist = {
     browserSmokeChecks: string[];
 };
 
+declare type SemaphorDataAppRawIdentifierFilterDiagnostic = {
+    kind: 'raw_identifier_filter_options';
+    inputId: string;
+    inputLabel: string;
+    optionSource: SemaphorDataAppRelationshipCandidateSource;
+    optionField: SemaphorDataAppRelationshipCandidateField;
+    missingEvidence: Array<'display_field' | 'relationship_display_path'>;
+};
+
 declare type SemaphorDataAppRelationshipCandidate = {
     source: SemaphorDataAppRelationshipCandidateSource;
     sourceFields: SemaphorDataAppRelationshipCandidateField[];
@@ -655,8 +664,9 @@ declare type SemaphorDataAppRequiredInputOption = {
 declare type SemaphorDataAppUnsupportedInsight = {
     title: string;
     requestedQuestion: string;
-    reason: 'missing_measure' | 'missing_dimension' | 'missing_date' | 'missing_relationship' | 'missing_semantic_role' | 'missing_current_app_state' | 'unsupported_change_intent' | 'ambiguous_field_grounding' | 'bounded_intent_unavailable' | 'invalid_bounded_intent_output' | 'latest_snapshot_selector_not_modeled' | 'unsupported_grain' | 'requires_sql_escape_hatch' | 'unsupported_sdk_capability';
+    reason: 'missing_measure' | 'missing_dimension' | 'missing_date' | 'missing_relationship' | 'missing_semantic_role' | 'missing_current_app_state' | 'raw_identifier_filter_options' | 'unsupported_change_intent' | 'ambiguous_field_grounding' | 'bounded_intent_unavailable' | 'invalid_bounded_intent_output' | 'latest_snapshot_selector_not_modeled' | 'unsupported_grain' | 'requires_sql_escape_hatch' | 'unsupported_sdk_capability';
     suggestedModelingFix: string;
+    diagnostic?: SemaphorDataAppRawIdentifierFilterDiagnostic;
     relationshipCandidate?: SemaphorDataAppRelationshipCandidate;
     nextRepairAction?: {
         tool: 'semaphor_propose_semantic_model_change';

package/dist/types/data-app-sdk-validation.d.ts

@@ -576,9 +576,6 @@ declare type SemaphorDerivedFieldResultRole = 'measure' | 'dimension' | 'date' |
 declare type SemaphorDialect = 'postgres' | 'mysql' | 'mssql' | 'snowflake' | 'clickhouse' | 'bigquery' | 'redshift' | 'duckdb' | 'sqlite' | 'unknown';
 
 declare type SemaphorExecutionFieldRef = SemaphorFieldRef & {
-    semanticAggregate?: SemaphorAggregateFunction;
-    effectiveAggregate?: SemaphorAggregateFunction;
-    aggregateSource?: SemaphorMetricAggregateSource;
     derivedField?: SemaphorDerivedFieldDefinition;
 };
 
@@ -895,8 +892,6 @@ declare type SemaphorMatrixValueField = {
 
 declare type SemaphorMatrixValueFieldInput = SemaphorQueryField | SemaphorMatrixValueField;
 
-declare type SemaphorMetricAggregateSource = 'semantic_model' | 'caller_override' | 'default_sum';
-
 declare type SemaphorMetricAnalysis = {
     kind: 'period_change';
     orderBy?: 'absolute_change' | 'positive_change' | 'negative_change' | 'period';
@@ -959,7 +954,6 @@ declare type SemaphorMetricQuerySpec = SemaphorQuerySourceSpec & SemaphorAppDeri
 
 declare type SemaphorMetricResult = SemaphorAnalyticsResultBase & {
     kind: 'metric';
-    value: number | string | null;
     primaryValue: number | string | null;
     missingMeasures?: string[];
     comparison?: {

package/dist/types/data-app-sdk.d.ts

@@ -361,7 +361,7 @@ declare type MatrixWarning = {
 
 export declare const semaphor: {
     source: {
-        semantic(spec: SemaphorSemanticSourceBuilderSpec): SemaphorSourceRef;
+        semantic(spec: SemaphorSemanticSourceBuilderSpec): SemaphorSemanticSourceRef;
         sql(spec: Omit<SemaphorSqlSourceBuilderSpec, "kind">): SemaphorSqlSourceBuilderSpec;
     };
     field: {
@@ -750,6 +750,20 @@ export declare type SemaphorDataAppQueryError = Error & {
     validationIssues?: SemaphorAnalyticsValidationIssue[];
 };
 
+export declare type SemaphorDataAppResultPreview = {
+    title: string;
+    summary: string;
+    columns: SemaphorDataAppResultPreviewColumn[];
+    rows: Array<Record<string, unknown>>;
+    truncatedRows: boolean;
+    truncatedColumns: boolean;
+};
+
+export declare type SemaphorDataAppResultPreviewColumn = {
+    key: string;
+    label: string;
+};
+
 export declare type SemaphorDataAppSourceHint = {
     file?: string;
     line?: number;
@@ -792,6 +806,7 @@ export declare type SemaphorDataAppTrace = {
             populatedMetricKeys?: string[];
             missingMeasures?: string[];
         };
+        resultPreview?: SemaphorDataAppResultPreview;
         executionResult?: SemaphorAnalyticsExecutionResult;
         errorMessage?: string;
     };
@@ -899,9 +914,6 @@ export declare type SemaphorDevtoolsProps = {
 declare type SemaphorDialect = 'postgres' | 'mysql' | 'mssql' | 'snowflake' | 'clickhouse' | 'bigquery' | 'redshift' | 'duckdb' | 'sqlite' | 'unknown';
 
 declare type SemaphorExecutionFieldRef = SemaphorFieldRef & {
-    semanticAggregate?: SemaphorAggregateFunction;
-    effectiveAggregate?: SemaphorAggregateFunction;
-    aggregateSource?: SemaphorMetricAggregateSource;
     derivedField?: SemaphorDerivedFieldDefinition;
 };
 
@@ -1252,7 +1264,7 @@ export declare type SemaphorMatrixValueField = {
 
 export declare type SemaphorMatrixValueFieldInput = SemaphorQueryField | SemaphorMatrixValueField;
 
-declare type SemaphorMetricAggregateSource = 'semantic_model' | 'caller_override' | 'default_sum';
+export declare function semaphorMetricAggregate(field: Pick<SemaphorFieldRef, 'aggregate'>): string;
 
 declare type SemaphorMetricAnalysis = {
     kind: 'period_change';
@@ -1297,7 +1309,6 @@ declare type SemaphorMetricIntent = {
 export declare function semaphorMetricMeasureBindingKey(field: SemaphorFieldRef): string;
 
 export declare type SemaphorMetricPayload = {
-    value: number | string | null;
     primaryValue: number | string | null;
     measures?: Record<string, number | string | null>;
     measureBindings?: Record<string, string>;
@@ -1337,7 +1348,6 @@ export declare type SemaphorMetricQuerySpec = SemaphorQuerySourceSpec & Semaphor
 
 declare type SemaphorMetricResult = SemaphorAnalyticsResultBase & {
     kind: 'metric';
-    value: number | string | null;
     primaryValue: number | string | null;
     missingMeasures?: string[];
     comparison?: {

package/package.json

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