react-semaphor 0.1.325 → 0.1.327

package/dist/surfboard/index.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const r=require("../chunks/index-YTk9Hab2.js"),e=require("../chunks/common-types-C73-Ud1-.js"),a=require("../chunks/calendar-preferences-dialog-BxeROxyq.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-BD90s-wf.js"),e=require("../chunks/common-types-C73-Ud1-.js"),a=require("../chunks/calendar-preferences-dialog-fkLUMJyR.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-CffvIaZO.js";
+import { a as e } from "../chunks/index-DTlbYpxd.js";
 import { C, E } from "../chunks/common-types-4bjoIgvm.js";
-import { C as s } from "../chunks/calendar-preferences-dialog-DHhT6Sja.js";
+import { C as s } from "../chunks/calendar-preferences-dialog-CjwbE_82.js";
 export {
   C as CONTROL_CARD_DEFAULT_VALUE,
   s as CalendarPreferencesDialog,

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

@@ -1,5 +1,265 @@
+export declare type AnalyticsCatalogDataType = 'string' | 'number' | 'boolean' | 'date' | 'datetime' | 'unknown';
+
+export declare type AnalyticsCatalogField = {
+    id?: unknown;
+    column_name?: unknown;
+    name?: unknown;
+    label?: unknown;
+    alias?: unknown;
+    qualifiedFieldName?: unknown;
+    data_type?: unknown;
+    dataType?: unknown;
+    role?: unknown;
+};
+
+export declare type AnalyticsCatalogFieldSummary = {
+    validMetricCandidates: string[];
+    validDateCandidates: string[];
+    validDimensionCandidates: string[];
+};
+
+export declare type AnalyticsMetricFormat = {
+    type: 'number' | 'currency' | 'percent' | 'scientific';
+    locale?: string;
+    minimumFractionDigits?: number;
+    maximumFractionDigits?: number;
+    useGrouping?: boolean;
+    prefix?: string;
+    suffix?: string;
+    negativeStyle?: 'minus' | 'parentheses';
+    compact?: boolean;
+    scale?: number;
+    currency?: string;
+    percentValueMode?: 'fraction' | 'whole';
+} | {
+    type: 'date';
+    locale?: string;
+    pattern?: string;
+    relative?: boolean;
+    timezone?: string;
+    sourceTimezone?: string;
+    prefix?: string;
+    suffix?: string;
+} | {
+    type: 'string';
+    prefix?: string;
+    suffix?: string;
+};
+
+export declare function buildAnalyticsCatalogFieldSummary(fields: AnalyticsCatalogField[]): AnalyticsCatalogFieldSummary;
+
+export declare function getAnalyticsCatalogFieldCandidates(field: AnalyticsCatalogField): string[];
+
+export declare function getAnalyticsCatalogFieldName(field: AnalyticsCatalogField): string;
+
+export declare function inferAnalyticsMetricFormat(field: AnalyticsCatalogField): AnalyticsMetricFormat | undefined;
+
+export declare function isAnalyticsCatalogDateField(field: AnalyticsCatalogField): boolean;
+
+export declare function isAnalyticsCatalogDimensionField(field: AnalyticsCatalogField): boolean;
+
+export declare function isAnalyticsCatalogMetricField(field: AnalyticsCatalogField, options?: {
+    excludeIdentifiers?: boolean;
+}): boolean;
+
+export declare function isAnalyticsDateLikeDataType(value: unknown): boolean;
+
+export declare function isAnalyticsMetricIdentifierField(field: AnalyticsCatalogField): boolean;
+
+export declare function isAnalyticsTechnicalIdentifierField(field: AnalyticsCatalogField): boolean;
+
+export declare function normalizeAnalyticsCatalogDataType(value: unknown): AnalyticsCatalogDataType;
+
+export declare function normalizeAnalyticsCatalogName(value: unknown): string;
+
+export declare const SEMAPHOR_ANALYTICS_INTENT_FIXTURES: {
+    revenueKpi: {
+        version: 1;
+        kind: "metric";
+        id: string;
+        label: string;
+        source: {
+            readonly kind: "semantic";
+            readonly domainId: "domain_sales";
+            readonly datasetName: "orders";
+            readonly connectionId: "conn_sales";
+            readonly label: "Orders";
+        };
+        metric: string;
+        comparison: {
+            kind: "previous_period";
+        };
+        limit: number;
+    };
+    revenueTrend: {
+        version: 1;
+        kind: "records";
+        id: string;
+        label: string;
+        source: {
+            readonly kind: "semantic";
+            readonly domainId: "domain_sales";
+            readonly datasetName: "orders";
+            readonly connectionId: "conn_sales";
+            readonly label: "Orders";
+        };
+        fields: {
+            name: string;
+            role: "date";
+            dataType: "date";
+            label: string;
+        }[];
+        measures: string[];
+        dateField: {
+            name: string;
+            role: "date";
+            dataType: "date";
+        };
+        timeGrain: "month";
+        limit: number;
+    };
+    topCustomersRecords: {
+        version: 1;
+        kind: "records";
+        id: string;
+        label: string;
+        source: {
+            readonly kind: "semantic";
+            readonly domainId: "domain_sales";
+            readonly datasetName: "orders";
+            readonly connectionId: "conn_sales";
+            readonly label: "Orders";
+        };
+        fields: ({
+            name: string;
+            role: "dimension";
+            dataType: "string";
+        } | {
+            name: string;
+            role: "measure";
+            dataType: "number";
+        })[];
+        measures: string[];
+        orderBy: {
+            field: string;
+            direction: "desc";
+        };
+        limit: number;
+    };
+    regionInputOptions: {
+        version: 1;
+        kind: "inputOptions";
+        id: string;
+        label: string;
+        source: {
+            readonly kind: "semantic";
+            readonly domainId: "domain_sales";
+            readonly datasetName: "orders";
+            readonly connectionId: "conn_sales";
+            readonly label: "Orders";
+        };
+        field: {
+            name: string;
+            role: "dimension";
+            dataType: "string";
+        };
+        limit: number;
+    };
+    previousPeriodRevenueComparison: {
+        version: 1;
+        kind: "metric";
+        id: string;
+        label: string;
+        source: {
+            readonly kind: "semantic";
+            readonly domainId: "domain_sales";
+            readonly datasetName: "orders";
+            readonly connectionId: "conn_sales";
+            readonly label: "Orders";
+        };
+        metric: string;
+        dateField: {
+            name: string;
+            role: "date";
+            dataType: "date";
+        };
+        timeGrain: "week";
+        comparison: {
+            kind: "previous_period";
+        };
+        limit: number;
+    };
+    boundedSqlRanking: {
+        version: 1;
+        kind: "sql";
+        id: string;
+        label: string;
+        source: {
+            kind: "physical";
+            connectionId: string;
+            databaseName: string;
+            schemaName: string;
+            tableName: string;
+            dialect: "postgres";
+        };
+        sql: string;
+        limit: number;
+        rationale: string;
+        fields: ({
+            name: string;
+            role: "dimension";
+            dataType: "string";
+        } | {
+            name: string;
+            role: "measure";
+            dataType: "number";
+        })[];
+    };
+};
+
+export declare type SemaphorAnalyticsFieldRole = 'metric' | 'dateField' | 'dimension' | 'input' | 'source' | 'sql';
+
 export declare type SemaphorAnalyticsIntent = SemaphorMetricIntent | SemaphorRecordsIntent | SemaphorInputOptionsIntent | SemaphorSqlIntent;
 
+export declare type SemaphorAnalyticsIntentFixtureName = keyof typeof SEMAPHOR_ANALYTICS_INTENT_FIXTURES;
+
+export declare type SemaphorAnalyticsRepairHint = {
+    code: SemaphorAnalyticsValidationCode | string;
+    message?: string;
+    invalidField?: string;
+    fieldRole?: SemaphorAnalyticsFieldRole;
+    validMetricCandidates?: string[];
+    validDateCandidates?: string[];
+    validDimensionCandidates?: string[];
+    recommendedNextStep: string;
+};
+
+export declare type SemaphorAnalyticsResult = SemaphorMetricResult | SemaphorRecordsResult | SemaphorInputOptionsResult | SemaphorSqlResult;
+
+export declare type SemaphorAnalyticsResultBase = {
+    intentId?: string;
+    queryPath: SemaphorQueryPath;
+    warnings?: string[];
+    rowCount?: number;
+    rowLimitExceeded?: boolean;
+    limit?: number;
+};
+
+export declare type SemaphorAnalyticsValidationCode = 'missing_source' | 'invalid_source_kind' | 'missing_semantic_domain' | 'missing_dataset_name' | 'missing_connection_id' | 'missing_table_name' | 'missing_sql' | 'missing_metric' | 'missing_record_fields' | 'missing_input_options_field' | 'invalid_metric' | 'invalid_metric_list' | 'invalid_date_field' | 'invalid_dimension' | 'invalid_metric_dimensions' | 'conflicting_sql' | 'sql_policy_violation' | 'unsupported_intent_for_adapter' | 'invalid_analytics_kind' | 'invalid_analytics_intent';
+
+export declare type SemaphorAnalyticsValidationIssue = SemaphorProtocolIssue & {
+    code: SemaphorAnalyticsValidationCode | string;
+    fieldRole?: SemaphorAnalyticsFieldRole;
+    repairHint?: SemaphorAnalyticsRepairHint;
+};
+
+export declare type SemaphorAnalyticsValidationResult = {
+    ok: boolean;
+    errors: SemaphorAnalyticsValidationIssue[];
+    warnings: SemaphorAnalyticsValidationIssue[];
+    repairHints: SemaphorAnalyticsRepairHint[];
+};
+
 export declare type SemaphorDashboardIntent = {
     version: SemaphorProtocolVersion;
     kind: 'dashboard';
@@ -34,6 +294,7 @@ export declare type SemaphorFieldRef = {
     label?: string;
     role?: 'dimension' | 'measure' | 'date' | 'id' | 'unknown';
     dataType?: 'string' | 'number' | 'boolean' | 'date' | 'datetime' | 'unknown';
+    source?: SemaphorSourceRef;
 };
 
 export declare type SemaphorInputBinding = {
@@ -45,12 +306,24 @@ export declare type SemaphorInputOperator = '=' | '!=' | 'in' | 'not_in' | 'cont
 
 export declare type SemaphorInputOptionsIntent = {
     kind: 'inputOptions';
+    version?: SemaphorProtocolVersion;
+    id?: string;
+    label?: string;
     source: SemaphorSourceRef;
     field: SemaphorFieldRef;
     search?: string;
     limit?: number;
 };
 
+export declare type SemaphorInputOptionsResult = SemaphorAnalyticsResultBase & {
+    kind: 'inputOptions';
+    options: Array<{
+        label: string;
+        value: unknown;
+        count?: number;
+    }>;
+};
+
 export declare type SemaphorInputScope = {
     level: 'dashboard';
     excludeViewIds?: string[];
@@ -77,15 +350,32 @@ export declare type SemaphorInputSpec = {
 
 export declare type SemaphorMetricIntent = {
     kind: 'metric';
+    version?: SemaphorProtocolVersion;
+    id?: string;
     source: SemaphorSourceRef;
     metric: string;
+    metrics?: string[];
     label?: string;
     dateField?: SemaphorFieldRef;
+    timeGrain?: SemaphorTimeGrain;
+    dimensions?: SemaphorFieldRef[];
     comparison?: {
         kind: 'previous_period' | 'previous_year' | 'target';
         targetValue?: number;
     };
     inputs?: SemaphorInputBinding[];
+    limit?: number;
+};
+
+export declare type SemaphorMetricResult = SemaphorAnalyticsResultBase & {
+    kind: 'metric';
+    value: number | string | null;
+    comparison?: {
+        kind: NonNullable<SemaphorMetricIntent['comparison']>['kind'];
+        value?: number | string | null;
+        delta?: number | null;
+        deltaPercent?: number | null;
+    };
 };
 
 export declare type SemaphorProtocolIssue = {
@@ -96,9 +386,14 @@ export declare type SemaphorProtocolIssue = {
 
 export declare type SemaphorProtocolVersion = 1;
 
+export declare type SemaphorQueryPath = 'query_spec' | 'sql' | 'sql_python';
+
 export declare type SemaphorRecordsIntent = {
     kind: 'records';
+    version?: SemaphorProtocolVersion;
     source: SemaphorSourceRef;
+    id?: string;
+    label?: string;
     fields: SemaphorFieldRef[];
     measures?: string[];
     dateField?: SemaphorFieldRef;
@@ -111,6 +406,16 @@ export declare type SemaphorRecordsIntent = {
     inputs?: SemaphorInputBinding[];
 };
 
+export declare type SemaphorRecordsResult = SemaphorAnalyticsResultBase & {
+    kind: 'records';
+    columns: Array<{
+        name: string;
+        label?: string;
+        dataType?: SemaphorFieldRef['dataType'];
+    }>;
+    records: Array<Record<string, unknown>>;
+};
+
 export declare type SemaphorSourceRef = {
     kind: 'semantic';
     domainId: string;
@@ -136,13 +441,32 @@ export declare type SemaphorSourceRef = {
 
 export declare type SemaphorSqlIntent = {
     kind: 'sql';
+    version?: SemaphorProtocolVersion;
+    id?: string;
+    label?: string;
     source: Extract<SemaphorSourceRef, {
-        kind: 'sql';
+        kind: 'sql' | 'physical';
     }>;
+    sql?: string;
+    parameters?: Record<string, unknown>;
+    pythonCode?: string;
+    limit?: number;
+    rationale?: string;
     fields?: SemaphorFieldRef[];
     inputs?: SemaphorInputBinding[];
 };
 
+export declare type SemaphorSqlResult = SemaphorAnalyticsResultBase & {
+    kind: 'sql';
+    columns: SemaphorRecordsResult['columns'];
+    records: SemaphorRecordsResult['records'];
+    sqlShape?: {
+        statementType?: string;
+        explicitLimit?: number;
+        hasPythonCode?: boolean;
+    };
+};
+
 export declare type SemaphorTimeGrain = 'hour' | 'day' | 'week' | 'month' | 'quarter' | 'year';
 
 export declare type SemaphorValidationResult = {
@@ -165,7 +489,7 @@ export declare type SemaphorViewPresentation = {
     kind: 'text';
 };
 
-export declare function validateSemaphorAnalyticsIntent(intent: SemaphorAnalyticsIntent): SemaphorValidationResult;
+export declare function validateSemaphorAnalyticsIntent(intent: SemaphorAnalyticsIntent): SemaphorAnalyticsValidationResult;
 
 export declare function validateSemaphorDashboardIntent(intent: SemaphorDashboardIntent): SemaphorValidationResult;
 

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

@@ -496,6 +496,8 @@ declare type DashboardAIContextMode = 'auto' | 'fixed';
 
 export declare type DashboardAuthoringBreakpoint = (typeof DASHBOARD_AUTHORING_BREAKPOINTS)[number];
 
+export declare function dashboardAuthoringDatasetMatchesSource(dataset: unknown, source: SemaphorSourceRef | undefined): boolean;
+
 export declare type DashboardAuthoringDatasetRef = {
     kind: 'semantic';
     domainId: string;
@@ -512,6 +514,17 @@ export declare type DashboardAuthoringDatasetRef = {
     label?: string;
 };
 
+export declare type DashboardAuthoringDatasetScopeIssue = 'invalid_dataset_count' | 'invalid_multi_dataset_scope';
+
+export declare type DashboardAuthoringDatasetScopeResult = {
+    ok: true;
+} | {
+    ok: false;
+    issue: DashboardAuthoringDatasetScopeIssue;
+};
+
+export declare function dashboardAuthoringFieldsReferToSameTarget(left: SemaphorFieldRef | undefined, right: SemaphorFieldRef | undefined): boolean;
+
 export declare type DashboardAuthoringIdFactory = {
     dashboardId?: () => string;
     sheetId?: () => string;
@@ -519,18 +532,31 @@ export declare type DashboardAuthoringIdFactory = {
     cardId: (seed?: string) => string;
 };
 
+export declare function dashboardAuthoringSourceFromField(field: SemaphorFieldRef | undefined, fallback?: SemaphorSourceRef): MaterializableDashboardAuthoringSource | undefined;
+
+export declare function dashboardAuthoringSourceKey(source: SemaphorSourceRef): string;
+
+export declare function dashboardAuthoringSourcesReferToSameDataset(left: SemaphorSourceRef, right: SemaphorSourceRef): boolean;
+
 export declare type DashboardAuthoringValidationResult = {
     ok: boolean;
     errors: DashboardPlanWarning[];
     warnings: DashboardPlanWarning[];
 };
 
+export declare type DashboardCardQueryFieldRef = {
+    name: string;
+    source?: DashboardAuthoringDatasetRef;
+};
+
 export declare type DashboardCardQueryIntent = {
     metric?: string;
     metrics?: string[];
     dateField?: string;
+    dateFieldRef?: DashboardCardQueryFieldRef;
     timeGrain?: 'day' | 'week' | 'month' | 'quarter' | 'year';
     dimensions?: string[];
+    dimensionRefs?: DashboardCardQueryFieldRef[];
     limit?: number;
 };
 
@@ -732,6 +758,7 @@ export declare type DashboardPlanCard = {
     priority: number;
     section?: string;
     query?: DashboardCardQueryIntent;
+    analyticsIntent?: SemaphorAnalyticsIntent;
     text?: string;
 };
 
@@ -773,6 +800,11 @@ export declare type DashboardSuggestion = {
     cardCount: number;
     filterCount: number;
     prompt: string;
+    datasets?: Array<{
+        name: string;
+        label?: string;
+    }>;
+    relationshipHints?: string[];
 };
 
 export declare type DashboardSuggestionPreviewKind = 'kpi' | 'line' | 'bar' | 'donut' | 'table';
@@ -800,6 +832,7 @@ declare interface DataModelEntityReference extends DatabaseEntityReference {
 declare interface DatasetEntityReference extends DatabaseEntityReference {
     type: 'dataset';
     datasetType: 'physical' | 'virtual';
+    table?: string | null;
     datamodelId?: string | null;
     sql?: string | null;
     id: string;
@@ -1399,6 +1432,8 @@ declare type FilterSemanticContext = {
 
 declare type FilterValue = string | number | boolean | Date | null | [number, number] | [string, string] | string[] | number[];
 
+export declare function findDashboardAuthoringDatasetForSource(datasets: readonly DashboardAuthoringDatasetRef[], source: SemaphorSourceRef | undefined): DashboardAuthoringDatasetRef | undefined;
+
 /**
  * Absolute fixed month/year default used by Month Picker defaults.
  * - `month` is 0-indexed (0=January, 11=December) to align with MonthPicker.
@@ -1432,6 +1467,16 @@ declare type FormatSpec = {
     sourceTimezone?: string;
     prefix?: string;
     suffix?: string;
+} | {
+    type: 'duration';
+    inputUnit?: 'millisecond' | 'second' | 'minute' | 'hour' | 'day';
+    outputStyle?: 'compact' | 'digital' | 'long';
+    largestUnit?: 'millisecond' | 'second' | 'minute' | 'hour' | 'day';
+    smallestUnit?: 'millisecond' | 'second' | 'minute' | 'hour' | 'day';
+    maxUnits?: number;
+    prefix?: string;
+    suffix?: string;
+    negativeStyle?: 'minus' | 'parentheses';
 } | {
     type: 'string';
     prefix?: string;
@@ -1446,6 +1491,8 @@ export declare type GeneratedDashboardCardArtifact = {
     warnings?: DashboardPlanWarning[];
 };
 
+export declare function getDashboardAuthoringCardSource(card: Pick<DashboardPlanCard, 'analyticsIntent'>): SemaphorSourceRef | undefined;
+
 declare type Granularity = 'day' | 'week' | 'month' | 'quarter' | 'year' | 'hour' | 'minute' | 'second';
 
 declare interface GroupByColumn extends BaseColumn {
@@ -1543,6 +1590,10 @@ declare interface InteractionTrigger {
     field: Field;
 }
 
+export declare function isMaterializableDashboardAuthoringSource(value: unknown): value is MaterializableDashboardAuthoringSource;
+
+export declare function isSemaphorSourceRef(value: unknown): value is SemaphorSourceRef;
+
 declare interface Join {
     id: string;
     source: DatabaseEntityReference;
@@ -1583,6 +1634,12 @@ declare interface LinkFormat {
 
 declare type LogicalOperator = 'AND' | 'OR';
 
+export declare type MaterializableDashboardAuthoringSource = Extract<SemaphorSourceRef, {
+    kind: 'semantic' | 'physical';
+}>;
+
+export declare function mergeDashboardAuthoringSources(sources: readonly SemaphorSourceRef[]): SemaphorSourceRef[];
+
 declare interface MetricColumn extends BaseColumn {
     role: 'metric';
     aggregate: AggregateFunction;
@@ -1714,6 +1771,10 @@ declare interface PivotByField extends Field {
     role: 'pivotby';
 }
 
+export declare function preferDashboardAuthoringSourceMetadata(current: SemaphorSourceRef, next: SemaphorSourceRef): SemaphorSourceRef;
+
+export declare function preferredDashboardAuthoringSource(sources: readonly SemaphorSourceRef[]): SemaphorSourceRef | undefined;
+
 declare interface QueryConfig {
     groupByColumns?: GroupByColumn[];
     pivotColumns?: GroupByColumn[];
@@ -1755,6 +1816,13 @@ declare type RelativeDateFilter = {
     to: number;
 };
 
+export declare function resolveDashboardAuthoringSource({ explicitSource, field, defaultSource, fallbackSources, }: {
+    explicitSource?: unknown;
+    field?: SemaphorFieldRef;
+    defaultSource?: SemaphorSourceRef;
+    fallbackSources?: readonly SemaphorSourceRef[];
+}): MaterializableDashboardAuthoringSource | undefined;
+
 declare type SelectedEntities = SelectedEntity[];
 
 declare type SelectedEntity = DatabaseEntityReference | DataModelEntityReference | DatasetEntityReference | FileEntityReference;
@@ -1793,6 +1861,7 @@ declare type SemaphorFieldRef = {
     label?: string;
     role?: 'dimension' | 'measure' | 'date' | 'id' | 'unknown';
     dataType?: 'string' | 'number' | 'boolean' | 'date' | 'datetime' | 'unknown';
+    source?: SemaphorSourceRef;
 };
 
 declare type SemaphorInputBinding = {
@@ -1804,6 +1873,9 @@ declare type SemaphorInputOperator = '=' | '!=' | 'in' | 'not_in' | 'contains' |
 
 declare type SemaphorInputOptionsIntent = {
     kind: 'inputOptions';
+    version?: SemaphorProtocolVersion;
+    id?: string;
+    label?: string;
     source: SemaphorSourceRef;
     field: SemaphorFieldRef;
     search?: string;
@@ -1836,22 +1908,31 @@ declare type SemaphorInputSpec = {
 
 declare type SemaphorMetricIntent = {
     kind: 'metric';
+    version?: SemaphorProtocolVersion;
+    id?: string;
     source: SemaphorSourceRef;
     metric: string;
+    metrics?: string[];
     label?: string;
     dateField?: SemaphorFieldRef;
+    timeGrain?: SemaphorTimeGrain;
+    dimensions?: SemaphorFieldRef[];
     comparison?: {
         kind: 'previous_period' | 'previous_year' | 'target';
         targetValue?: number;
     };
     inputs?: SemaphorInputBinding[];
+    limit?: number;
 };
 
 declare type SemaphorProtocolVersion = 1;
 
 declare type SemaphorRecordsIntent = {
     kind: 'records';
+    version?: SemaphorProtocolVersion;
     source: SemaphorSourceRef;
+    id?: string;
+    label?: string;
     fields: SemaphorFieldRef[];
     measures?: string[];
     dateField?: SemaphorFieldRef;
@@ -1889,9 +1970,17 @@ declare type SemaphorSourceRef = {
 
 declare type SemaphorSqlIntent = {
     kind: 'sql';
+    version?: SemaphorProtocolVersion;
+    id?: string;
+    label?: string;
     source: Extract<SemaphorSourceRef, {
-        kind: 'sql';
+        kind: 'sql' | 'physical';
     }>;
+    sql?: string;
+    parameters?: Record<string, unknown>;
+    pythonCode?: string;
+    limit?: number;
+    rationale?: string;
     fields?: SemaphorFieldRef[];
     inputs?: SemaphorInputBinding[];
 };
@@ -2463,7 +2552,7 @@ declare type TDataLabelsConfig = {
     display?: 'auto' | boolean;
     formatMode?: 'inherit' | 'override';
     /** @deprecated Use formatMode + formatOptions.type */
-    format?: 'auto' | 'number' | 'currency' | 'percent' | 'date' | 'scientific' | 'none';
+    format?: 'auto' | 'number' | 'currency' | 'percent' | 'date' | 'scientific' | 'duration' | 'none';
     formatOptions?: TFormatOptions;
     font?: {
         size?: number;
@@ -2601,7 +2690,7 @@ declare type TFilter = {
 declare type TFilterValue = FilterForString | FilterForEqual | FilterForCompare | FilterForBetween | FilterForIn | FilterForNull | FilterForDate;
 
 declare type TFormatOptions = {
-    type?: 'auto' | 'number' | 'currency' | 'percent' | 'scientific' | 'date';
+    type?: 'auto' | 'number' | 'currency' | 'percent' | 'scientific' | 'date' | 'duration';
     decimalPlaces?: number;
     minimumFractionDigits?: number;
     maximumFractionDigits?: number;
@@ -2618,6 +2707,11 @@ declare type TFormatOptions = {
     timezone?: string;
     sourceTimezone?: string;
     relative?: boolean;
+    durationInputUnit?: 'millisecond' | 'second' | 'minute' | 'hour' | 'day';
+    durationDisplayStyle?: 'compact' | 'digital' | 'long';
+    durationLargestUnit?: 'millisecond' | 'second' | 'minute' | 'hour' | 'day';
+    durationSmallestUnit?: 'millisecond' | 'second' | 'minute' | 'hour' | 'day';
+    durationMaxUnits?: number;
 };
 
 declare type TFrame = {
@@ -2798,6 +2892,11 @@ declare interface URLParameter {
     field?: Field;
 }
 
+export declare function validateDashboardAuthoringDatasetScope({ datasets, requireAtLeastOne, }: {
+    datasets: readonly unknown[];
+    requireAtLeastOne: boolean;
+}): DashboardAuthoringDatasetScopeResult;
+
 export declare function validateDashboardChangePlan(plan: DashboardChangePlan): DashboardAuthoringValidationResult;
 
 export declare function validateDashboardPlan(plan: DashboardPlan): DashboardAuthoringValidationResult;