react-semaphor 0.1.336 → 0.1.338

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

@@ -300,6 +300,7 @@ export declare type SemaphorAnalyticsExecutionResult = {
     missingFields?: string[];
     warnings?: string[];
     relationshipDiagnostics?: SemaphorRelationshipDiagnostics;
+    population?: SemaphorAnalyticsPopulation;
     metadata?: Record<string, unknown>;
 };
 
@@ -341,6 +342,11 @@ export declare type SemaphorAnalyticsObligation = {
 
 export declare type SemaphorAnalyticsObligationType = 'record_list' | 'count' | 'trend' | 'comparison' | 'driver_analysis' | 'metric_summary' | 'analysis_table' | 'lookup' | 'unknown';
 
+export declare type SemaphorAnalyticsPopulation = {
+    scope: 'filtered_query';
+    metrics: Record<string, number | string | null>;
+};
+
 export declare type SemaphorAnalyticsRecoveryPlan = {
     version: SemaphorProtocolVersion;
     kind: 'analytics_recovery_plan';

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

@@ -127,6 +127,13 @@ declare interface CardConfig {
     pivotByColumns?: PivotByField[];
     sortByColumns?: SortByField[];
     detailColumns?: DetailField[];
+    /**
+     * Typed source that anchors the query before auto-join materializes an
+     * executable joinPlan.baseEntity. This is distinct from
+     * DataSource.selectedEntities, which lists available datasets but does not
+     * define join-root semantics.
+     */
+    queryBaseSource?: SemaphorSourceRef;
     /** Preserves non-detail config when switching to detail tables. */
     detailTableBackup?: DetailTableBackupConfig;
     filters?: FilterGroup;

package/dist/types/dashboard.d.ts

@@ -204,6 +204,13 @@ declare interface CardConfig {
     pivotByColumns?: PivotByField[];
     sortByColumns?: SortByField[];
     detailColumns?: DetailField[];
+    /**
+     * Typed source that anchors the query before auto-join materializes an
+     * executable joinPlan.baseEntity. This is distinct from
+     * DataSource.selectedEntities, which lists available datasets but does not
+     * define join-root semantics.
+     */
+    queryBaseSource?: SemaphorSourceRef;
     /** Preserves non-detail config when switching to detail tables. */
     detailTableBackup?: DetailTableBackupConfig;
     filters?: FilterGroup;
@@ -1898,6 +1905,32 @@ declare type SemanticExecutionPayload = {
     }>;
 };
 
+declare type SemaphorDialect = 'semantic' | 'postgres' | 'mysql' | 'mssql' | 'snowflake' | 'clickhouse' | 'bigquery' | 'redshift' | 'duckdb' | 'sqlite' | 'unknown';
+
+declare type SemaphorSourceRef = {
+    kind: 'semantic';
+    domainId: string;
+    datasetName: string;
+    datasetId?: string;
+    label?: string;
+    connectionId?: string;
+} | {
+    kind: 'physical';
+    connectionId: string;
+    connectionType?: string;
+    tableName: string;
+    databaseName?: string;
+    schemaName?: string;
+    label?: string;
+    dialect?: SemaphorDialect;
+} | {
+    kind: 'sql';
+    connectionId: string;
+    sql: string;
+    dialect?: SemaphorDialect;
+    label?: string;
+};
+
 declare interface SortByField extends Field {
     role: 'sortby';
     direction: 'asc' | 'desc';

package/dist/types/main.d.ts

@@ -1179,6 +1179,13 @@ export declare interface CardConfig {
     pivotByColumns?: PivotByField[];
     sortByColumns?: SortByField[];
     detailColumns?: DetailField[];
+    /**
+     * Typed source that anchors the query before auto-join materializes an
+     * executable joinPlan.baseEntity. This is distinct from
+     * DataSource.selectedEntities, which lists available datasets but does not
+     * define join-root semantics.
+     */
+    queryBaseSource?: SemaphorSourceRef;
     /** Preserves non-detail config when switching to detail tables. */
     detailTableBackup?: DetailTableBackupConfig;
     filters?: FilterGroup;
@@ -6418,7 +6425,7 @@ export declare function useTextFilterHook(filterId: string): {
     activeFilterValue: TFilterValue | undefined;
     isSearching: boolean;
     searchError: boolean;
-    resultSource: "server" | "both" | "local";
+    resultSource: "both" | "server" | "local";
 };
 
 export declare function validateBriefingFormDraft(draft: BriefingFormDraft): BriefingFormValidationResult;

package/dist/types/shared.d.ts

@@ -119,6 +119,13 @@ declare interface CardConfig {
     pivotByColumns?: PivotByField[];
     sortByColumns?: SortByField[];
     detailColumns?: DetailField[];
+    /**
+     * Typed source that anchors the query before auto-join materializes an
+     * executable joinPlan.baseEntity. This is distinct from
+     * DataSource.selectedEntities, which lists available datasets but does not
+     * define join-root semantics.
+     */
+    queryBaseSource?: SemaphorSourceRef;
     /** Preserves non-detail config when switching to detail tables. */
     detailTableBackup?: DetailTableBackupConfig;
     filters?: FilterGroup;
@@ -1548,6 +1555,32 @@ declare type SelectedEntities = SelectedEntity[];
 
 declare type SelectedEntity = DatabaseEntityReference | DataModelEntityReference | DatasetEntityReference | FileEntityReference;
 
+declare type SemaphorDialect = 'semantic' | 'postgres' | 'mysql' | 'mssql' | 'snowflake' | 'clickhouse' | 'bigquery' | 'redshift' | 'duckdb' | 'sqlite' | 'unknown';
+
+declare type SemaphorSourceRef = {
+    kind: 'semantic';
+    domainId: string;
+    datasetName: string;
+    datasetId?: string;
+    label?: string;
+    connectionId?: string;
+} | {
+    kind: 'physical';
+    connectionId: string;
+    connectionType?: string;
+    tableName: string;
+    databaseName?: string;
+    schemaName?: string;
+    label?: string;
+    dialect?: SemaphorDialect;
+} | {
+    kind: 'sql';
+    connectionId: string;
+    sql: string;
+    dialect?: SemaphorDialect;
+    label?: string;
+};
+
 /**
  * Stable serializer for dashboard dirty checks.
  * This consolidates normalization + serialization into one call site, so

package/dist/types/surfboard.d.ts

@@ -211,6 +211,13 @@ declare interface CardConfig {
     pivotByColumns?: PivotByField[];
     sortByColumns?: SortByField[];
     detailColumns?: DetailField[];
+    /**
+     * Typed source that anchors the query before auto-join materializes an
+     * executable joinPlan.baseEntity. This is distinct from
+     * DataSource.selectedEntities, which lists available datasets but does not
+     * define join-root semantics.
+     */
+    queryBaseSource?: SemaphorSourceRef;
     /** Preserves non-detail config when switching to detail tables. */
     detailTableBackup?: DetailTableBackupConfig;
     filters?: FilterGroup;
@@ -1908,6 +1915,32 @@ declare type SemanticExecutionPayload = {
     }>;
 };
 
+declare type SemaphorDialect = 'semantic' | 'postgres' | 'mysql' | 'mssql' | 'snowflake' | 'clickhouse' | 'bigquery' | 'redshift' | 'duckdb' | 'sqlite' | 'unknown';
+
+declare type SemaphorSourceRef = {
+    kind: 'semantic';
+    domainId: string;
+    datasetName: string;
+    datasetId?: string;
+    label?: string;
+    connectionId?: string;
+} | {
+    kind: 'physical';
+    connectionId: string;
+    connectionType?: string;
+    tableName: string;
+    databaseName?: string;
+    schemaName?: string;
+    label?: string;
+    dialect?: SemaphorDialect;
+} | {
+    kind: 'sql';
+    connectionId: string;
+    sql: string;
+    dialect?: SemaphorDialect;
+    label?: string;
+};
+
 declare interface SortByField extends Field {
     role: 'sortby';
     direction: 'asc' | 'desc';

package/dist/types/types.d.ts

@@ -653,6 +653,13 @@ export declare interface CardConfig {
     pivotByColumns?: PivotByField[];
     sortByColumns?: SortByField[];
     detailColumns?: DetailField[];
+    /**
+     * Typed source that anchors the query before auto-join materializes an
+     * executable joinPlan.baseEntity. This is distinct from
+     * DataSource.selectedEntities, which lists available datasets but does not
+     * define join-root semantics.
+     */
+    queryBaseSource?: SemaphorSourceRef;
     /** Preserves non-detail config when switching to detail tables. */
     detailTableBackup?: DetailTableBackupConfig;
     filters?: FilterGroup;
@@ -2668,6 +2675,32 @@ declare type SemanticExecutionPayload = {
     }>;
 };
 
+declare type SemaphorDialect = 'semantic' | 'postgres' | 'mysql' | 'mssql' | 'snowflake' | 'clickhouse' | 'bigquery' | 'redshift' | 'duckdb' | 'sqlite' | 'unknown';
+
+declare type SemaphorSourceRef = {
+    kind: 'semantic';
+    domainId: string;
+    datasetName: string;
+    datasetId?: string;
+    label?: string;
+    connectionId?: string;
+} | {
+    kind: 'physical';
+    connectionId: string;
+    connectionType?: string;
+    tableName: string;
+    databaseName?: string;
+    schemaName?: string;
+    label?: string;
+    dialect?: SemaphorDialect;
+} | {
+    kind: 'sql';
+    connectionId: string;
+    sql: string;
+    dialect?: SemaphorDialect;
+    label?: string;
+};
+
 export declare interface SortByField extends Field {
     role: 'sortby';
     direction: 'asc' | 'desc';

package/package.json

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