react-semaphor 0.1.326 → 0.1.328

package/dist/surfboard/index.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const r=require("../chunks/index-B1-46PoR.js"),e=require("../chunks/common-types-C73-Ud1-.js"),a=require("../chunks/calendar-preferences-dialog-mqU_uOmY.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-BdjXTQt4.js"),e=require("../chunks/common-types-C73-Ud1-.js"),a=require("../chunks/calendar-preferences-dialog-DD_qAthL.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-DwfDwtv2.js";
+import { a as e } from "../chunks/index-BmKr-K7J.js";
 import { C, E } from "../chunks/common-types-4bjoIgvm.js";
-import { C as s } from "../chunks/calendar-preferences-dialog--2jD-eKu.js";
+import { C as s } from "../chunks/calendar-preferences-dialog-JRmNJptJ.js";
 export {
   C as CONTROL_CARD_DEFAULT_VALUE,
   s as CalendarPreferencesDialog,

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

@@ -294,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 = {

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;
 };
 
@@ -774,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';
@@ -1401,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.
@@ -1434,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;
@@ -1448,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 {
@@ -1545,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;
@@ -1585,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;
@@ -1716,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[];
@@ -1757,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;
@@ -1795,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 = {
@@ -2485,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;
@@ -2623,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;
@@ -2640,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 = {
@@ -2820,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;

package/dist/types/dashboard.d.ts

@@ -1469,6 +1469,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;
@@ -2520,7 +2530,7 @@ export 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;
@@ -2671,7 +2681,7 @@ declare type TFilter = {
 declare type TFilterValue = FilterForString | FilterForEqual | FilterForCompare | FilterForBetween | FilterForIn | FilterForNull | FilterForDate;
 
 export declare type TFormatOptions = {
-    type?: 'auto' | 'number' | 'currency' | 'percent' | 'scientific' | 'date';
+    type?: 'auto' | 'number' | 'currency' | 'percent' | 'scientific' | 'date' | 'duration';
     decimalPlaces?: number;
     minimumFractionDigits?: number;
     maximumFractionDigits?: number;
@@ -2688,6 +2698,11 @@ export 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;
 };
 
 export declare type TFrame = {

package/dist/types/data-app-builder-browser-runtime.d.ts

@@ -0,0 +1,185 @@
+export declare type BrowserRuntimeLoader = <TModule = BrowserRuntimeModule>(specifier?: string) => Promise<TModule>;
+
+export declare type BrowserRuntimeModule = BrowserSandboxRuntimeModule;
+
+export declare type BrowserSandboxFile = {
+    path: string;
+    contents: string;
+};
+
+export declare type BrowserSandboxFilePlan = {
+    intent: string;
+    files: Array<{
+        path: string;
+        purpose: string;
+        action: 'create' | 'edit';
+    }>;
+};
+
+export declare type BrowserSandboxResult = {
+    ok: boolean;
+    projectRoot?: string;
+    provider?: string;
+    validation?: 'typecheck' | 'build' | 'write-policy-validation' | 'import-validation' | 'data-api-validation';
+    changedFiles?: string[];
+    summary?: string;
+    changes?: BrowserSandboxRevision['changes'];
+    files?: Array<{
+        path: string;
+        size: number;
+    }>;
+    generationMeta?: BrowserSandboxRevision['generationMeta'];
+    attempts?: Array<{
+        label: string;
+        ok: boolean;
+        command: {
+            command: string;
+            durationMs: number;
+            exitCode: number;
+            ok: boolean;
+            stdout: string;
+            stderr: string;
+        };
+    }>;
+    command?: {
+        command: string;
+        durationMs: number;
+        exitCode: number;
+        ok: boolean;
+        stdout: string;
+        stderr: string;
+    };
+    importValidation?: {
+        ok: boolean;
+        diagnostics: string[];
+    };
+    writePolicyValidation?: {
+        ok: boolean;
+        diagnostics: string[];
+    };
+    dataApiValidation?: {
+        ok: boolean;
+        diagnostics: string[];
+    };
+    telemetry?: {
+        contextFileCount?: number;
+        contextChars?: number;
+        generatedFileCount?: number;
+        generatedChars?: number;
+        repairAttempts?: number;
+    };
+    error?: string;
+};
+
+export declare type BrowserSandboxRevision = {
+    provider?: string;
+    summary?: string;
+    changes?: Array<{
+        kind: 'add' | 'edit' | 'remove';
+        label: string;
+    }>;
+    files: BrowserSandboxFile[];
+    plan?: BrowserSandboxFilePlan;
+    replaceExistingFiles?: boolean;
+    generationMeta?: {
+        model: string;
+        strategy: string;
+        reasoningEffort?: string;
+        durationMs: number;
+        outputChars?: number;
+        fallbackFrom?: {
+            strategy: string;
+            reason: string;
+        };
+    };
+    attemptLabel?: string;
+};
+
+export declare type BrowserSandboxRuntimeManifest = {
+    id: string;
+    name: string;
+    execution: 'browser-sandbox';
+    moduleSystem: string;
+    cssPipeline: {
+        mode: string;
+        status: string;
+    };
+    packages: Array<{
+        name: string;
+        source: 'host' | 'runtime' | 'shim' | 'fallback';
+        status: 'supported' | 'partial';
+    }>;
+    components: Array<{
+        name: string;
+        importPath: string;
+        sourceFile: string;
+        implementation: 'source' | 'shim';
+        dependencies: string[];
+    }>;
+    limits: {
+        writeScope: string[];
+        editableGlobs: string[];
+        unsupported: string[];
+    };
+};
+
+export declare type BrowserSandboxRuntimeModule = {
+    resetBrowserSandbox: (templateId?: string) => void;
+    readBrowserSandboxWorkspaceContext: () => BrowserSandboxWorkspaceContext;
+    readBrowserSandboxFiles: (paths: string[]) => BrowserSandboxFile[];
+    listBrowserSandboxFiles: () => Array<{
+        path: string;
+        size: number;
+    }>;
+    applyBrowserSandboxRevision: (revision: BrowserSandboxRevision) => BrowserSandboxResult;
+    compileBrowserSandboxPreviewHtml: () => Promise<{
+        html: string;
+        diagnostics: string[];
+        warnings?: string[];
+        cssMode?: 'tailwind' | 'fallback';
+    }>;
+};
+
+export declare type BrowserSandboxWorkspaceContext = {
+    projectRoot?: string;
+    framework?: string;
+    packageManager?: string;
+    runtimeManifest?: BrowserSandboxRuntimeManifest;
+    packageJson?: {
+        dependencies?: Record<string, string>;
+        devDependencies?: Record<string, string>;
+        scripts?: Record<string, string>;
+    };
+    componentsJson?: unknown;
+    tsconfig?: {
+        baseUrl?: string | null;
+        paths?: Record<string, string[]>;
+        jsx?: string | null;
+        strict?: boolean | null;
+        noUnusedLocals?: boolean | null;
+        noUnusedParameters?: boolean | null;
+    };
+    files?: {
+        source?: string[];
+        root?: string[];
+        editable?: string[];
+        editableGlobs?: string[];
+        approvalRequiredGlobs?: string[];
+        styleEntries?: string[];
+        localModules?: string[];
+    };
+    validation?: {
+        typecheck?: string | null;
+        build?: string | null;
+    };
+    capabilities?: unknown;
+};
+
+/**
+ * Lazily loads the browser execution runtime only when the user chooses
+ * in-browser app building. Keep this behind a dedicated subpath so ordinary
+ * dashboard and Analytics Hub consumers do not pay for runtime code.
+ */
+export declare const loadSemaphorBrowserRuntime: BrowserRuntimeLoader;
+
+export { }