react-semaphor 0.1.326 → 0.1.327

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-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-DwfDwtv2.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--2jD-eKu.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

@@ -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-sdk.d.ts

@@ -240,6 +240,7 @@ declare type SemaphorFieldRef = {
     label?: string;
     role?: 'dimension' | 'measure' | 'date' | 'id' | 'unknown';
     dataType?: 'string' | 'number' | 'boolean' | 'date' | 'datetime' | 'unknown';
+    source?: SemaphorSourceRef;
 };
 
 declare type SemaphorInputBinding = {

package/dist/types/format-utils.d.ts

@@ -107,6 +107,29 @@ export declare interface DateFormatOptions {
     locale?: string;
 }
 
+export declare type DurationDisplayStyle = 'compact' | 'digital' | 'long';
+
+export declare interface DurationFormatOptions {
+    /** Unit represented by the raw numeric value. */
+    inputUnit?: DurationUnit;
+    /** Display style, e.g. "6min 32s", "06:32", or "6 minutes 32 seconds". */
+    outputStyle?: DurationDisplayStyle;
+    /** Largest unit to show. Defaults to day. */
+    largestUnit?: DurationUnit;
+    /** Smallest unit to show. Defaults to second. */
+    smallestUnit?: DurationUnit;
+    /** Maximum non-zero unit parts to show for compact/long output. */
+    maxUnits?: number;
+    /** Add prefix string before the formatted duration. */
+    prefix?: string;
+    /** Add suffix string after the formatted duration. */
+    suffix?: string;
+    /** Show negative durations in parentheses instead of a minus sign. */
+    negativeInParentheses?: boolean;
+}
+
+export declare type DurationUnit = 'millisecond' | 'second' | 'minute' | 'hour' | 'day';
+
 /**
  * Escape a value for CSV output (RFC 4180 compliant)
  * Wraps in quotes if value contains delimiter, quotes, or newlines
@@ -181,6 +204,8 @@ export declare function formatCurrency(value: number | null | undefined, options
  */
 export declare const formatDate: (dateString: string | null | undefined, formatPattern: string | undefined, displayTimezone?: string, sourceTimezone?: string) => string;
 
+export declare function formatDuration(value: number | string | null | undefined, options?: DurationFormatOptions): string;
+
 /**
  * Format a number with locale-aware formatting
  */

package/dist/types/main.d.ts

@@ -1170,7 +1170,7 @@ export declare type CancelBriefingRunResponse = {
  */
 export declare function cancelExport(apiServiceUrl: string, token: string, exportId: string): Promise<void>;
 
-export declare type CanonicalFormatSpec = NumericCanonicalFormat | DateCanonicalFormat | StringCanonicalFormat;
+export declare type CanonicalFormatSpec = NumericCanonicalFormat | DateCanonicalFormat | DurationCanonicalFormat | StringCanonicalFormat;
 
 export declare interface CardConfig {
     groupByColumns?: GroupByField[];
@@ -1771,12 +1771,19 @@ export declare type DashboardBriefingLauncherProps = {
     client?: Partial<DashboardBriefingLauncherClient>;
 };
 
+declare type DashboardCardQueryFieldRef = {
+    name: string;
+    source?: DashboardAuthoringDatasetRef;
+};
+
 declare type DashboardCardQueryIntent = {
     metric?: string;
     metrics?: string[];
     dateField?: string;
+    dateFieldRef?: DashboardCardQueryFieldRef;
     timeGrain?: 'day' | 'week' | 'month' | 'quarter' | 'year';
     dimensions?: string[];
+    dimensionRefs?: DashboardCardQueryFieldRef[];
     limit?: number;
 };
 
@@ -1818,13 +1825,8 @@ export declare interface DashboardCreateDialogBaseProps {
     isCreatingBlank: boolean;
     sources: DashboardAuthoringSource[];
     sourcesLoading?: boolean;
-    suggestDashboards: (input: {
-        dataset: DashboardAuthoringDatasetRef;
-    }) => Promise<DashboardSuggestion[]>;
-    planDashboard: AsyncMutation<{
-        prompt: string;
-        dataset: DashboardAuthoringDatasetRef;
-    }, DashboardPlan>;
+    suggestDashboards: (input: DashboardSuggestionRequest) => Promise<DashboardSuggestion[]>;
+    planDashboard: AsyncMutation<DashboardPlanRequest, DashboardPlan>;
     createDashboardFromPlan: AsyncMutation<DashboardPlan, any>;
     settingsSlot?: ReactNode;
     blankDescription?: string;
@@ -2069,6 +2071,15 @@ declare type DashboardPlanFilterInput = {
     defaultValue?: unknown;
 };
 
+declare type DashboardPlanRequest = {
+    prompt: string;
+    dataset: DashboardAuthoringDatasetRef;
+} | {
+    prompt: string;
+    domainId: string;
+    datasetNames?: string[];
+};
+
 declare type DashboardPlanSheet = {
     id: string;
     title: string;
@@ -2274,10 +2285,24 @@ declare type DashboardSuggestion = {
     cardCount: number;
     filterCount: number;
     prompt: string;
+    datasets?: Array<{
+        name: string;
+        label?: string;
+    }>;
+    relationshipHints?: string[];
 };
 
 declare type DashboardSuggestionPreviewKind = 'kpi' | 'line' | 'bar' | 'donut' | 'table';
 
+declare type DashboardSuggestionRequest = {
+    dataset: DashboardAuthoringDatasetRef;
+    instruction?: string;
+} | {
+    domainId: string;
+    datasetNames?: string[];
+    instruction?: string;
+};
+
 export declare const DashboardWC: CustomElementConstructor;
 
 export declare interface DatabaseEntityReference {
@@ -2927,6 +2952,20 @@ export declare type DropdownItem = {
 
 export declare type DroppableId = 'droppable-group-by' | 'droppable-metric';
 
+declare type DurationCanonicalFormat = {
+    type: 'duration';
+    inputUnit?: DurationUnit;
+    outputStyle?: 'compact' | 'digital' | 'long';
+    largestUnit?: DurationUnit;
+    smallestUnit?: DurationUnit;
+    maxUnits?: number;
+    prefix?: string;
+    suffix?: string;
+    negativeStyle?: 'minus' | 'parentheses';
+};
+
+declare type DurationUnit = 'millisecond' | 'second' | 'minute' | 'hour' | 'day';
+
 export declare interface DynamicDrillEvent extends BaseInteractionEvent {
     interactionMode: 'dynamicDrill';
     filterGroups: ClickFilterConditionGroup[];
@@ -3436,6 +3475,16 @@ export 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;
@@ -4377,6 +4426,7 @@ declare type SemaphorFieldRef = {
     label?: string;
     role?: 'dimension' | 'measure' | 'date' | 'id' | 'unknown';
     dataType?: 'string' | 'number' | 'boolean' | 'date' | 'datetime' | 'unknown';
+    source?: SemaphorSourceRef;
 };
 
 declare type SemaphorInputBinding = {
@@ -5271,7 +5321,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;
@@ -5422,7 +5472,7 @@ export declare type TFilter = {
 export 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;
@@ -5439,6 +5489,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/shared.d.ts

@@ -1228,6 +1228,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;
@@ -2098,7 +2108,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;
@@ -2236,7 +2246,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;
@@ -2253,6 +2263,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 = {

package/dist/types/surfboard.d.ts

@@ -1479,6 +1479,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;
@@ -2532,7 +2542,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;
@@ -2683,7 +2693,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;
@@ -2700,6 +2710,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/types.d.ts

@@ -645,7 +645,7 @@ export declare type CancelBriefingRunResponse = {
     transitionApplied: boolean;
 };
 
-export declare type CanonicalFormatSpec = NumericCanonicalFormat | DateCanonicalFormat | StringCanonicalFormat;
+export declare type CanonicalFormatSpec = NumericCanonicalFormat | DateCanonicalFormat | DurationCanonicalFormat | StringCanonicalFormat;
 
 export declare interface CardConfig {
     groupByColumns?: GroupByField[];
@@ -1737,6 +1737,20 @@ declare interface DrillUpInteraction {
 
 export declare type DroppableId = 'droppable-group-by' | 'droppable-metric';
 
+declare type DurationCanonicalFormat = {
+    type: 'duration';
+    inputUnit?: DurationUnit;
+    outputStyle?: 'compact' | 'digital' | 'long';
+    largestUnit?: DurationUnit;
+    smallestUnit?: DurationUnit;
+    maxUnits?: number;
+    prefix?: string;
+    suffix?: string;
+    negativeStyle?: 'minus' | 'parentheses';
+};
+
+declare type DurationUnit = 'millisecond' | 'second' | 'minute' | 'hour' | 'day';
+
 declare interface DynamicDrillInteraction {
     mode: 'dynamicDrill';
     /**
@@ -2015,6 +2029,16 @@ export 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;
@@ -3302,7 +3326,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;
@@ -3453,7 +3477,7 @@ export declare type TFilter = {
 export 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;
@@ -3470,6 +3494,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/package.json

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