react-semaphor 0.1.514 → 0.1.515

package/dist/index.js

@@ -1,15 +1,15 @@
-import { E as x, F as B, S, c as N, U as _, d as P, C as w, V as F, e as R, f as L, g as I, h as M, I as k, R as U, i as O, j as V, k as q, l as z } from "./chunks/index-nhUr9xBz.js";
-import { al as Ta, am as va, an as Aa, ao as Ba, W as Sa, G as Na, D as _a, A as Pa, z as wa, w as Fa, b as Ra, av as La, M as Ia, n as Ma, q as ka, q as Ua, r as Oa, B as Va, a as qa, ag as za, ai as ja, aj as Wa, ah as Qa, a7 as Ha, aa as Ka, au as Ga, _ as Ya, af as Xa, aq as $a, a2 as Ja, ab as Za, y as ae, x as ee, ay as se, Z as re, ac as oe, ad as ie, a6 as te, a9 as ne, at as le, as as de, ar as ue, ax as ce, aw as pe, a8 as fe, Y as me, X as he, a0 as Ce, ae as ge, a4 as De, a1 as Ee, a3 as xe, a5 as be, $ as ye, P as Te, L as ve, ap as Ae, v as Be, J as Se, t as Ne, m as _e, H as Pe, K as we, o as Fe, T as Re, O as Le, N as Ie, Q as Me, u as ke, s as Ue, p as Oe, ak as Ve } from "./chunks/index-nhUr9xBz.js";
+import { E as x, F as B, S, c as N, U as _, d as P, C as w, V as F, e as R, f as L, g as I, h as M, I as k, R as U, i as O, j as V, k as q, l as z } from "./chunks/index-Dlic9KZs.js";
+import { al as Ta, am as va, an as Aa, ao as Ba, W as Sa, G as Na, D as _a, A as Pa, z as wa, w as Fa, b as Ra, av as La, M as Ia, n as Ma, q as ka, q as Ua, r as Oa, B as Va, a as qa, ag as za, ai as ja, aj as Wa, ah as Qa, a7 as Ha, aa as Ka, au as Ga, _ as Ya, af as Xa, aq as $a, a2 as Ja, ab as Za, y as ae, x as ee, ay as se, Z as re, ac as oe, ad as ie, a6 as te, a9 as ne, at as le, as as de, ar as ue, ax as ce, aw as pe, a8 as fe, Y as me, X as he, a0 as Ce, ae as ge, a4 as De, a1 as Ee, a3 as xe, a5 as be, $ as ye, P as Te, L as ve, ap as Ae, v as Be, J as Se, t as Ne, m as _e, H as Pe, K as we, o as Fe, T as Re, O as Le, N as Ie, Q as Me, u as ke, s as Ue, p as Oe, ak as Ve } from "./chunks/index-Dlic9KZs.js";
 import { C as ze, E as je } from "./chunks/common-types-C6cAQgyh.js";
-import { R as Qe } from "./chunks/report-preferences-dialog-B2fzQH1T.js";
+import { R as Qe } from "./chunks/report-preferences-dialog-b8J6KjSy.js";
 import { jsx as a, jsxs as l } from "react/jsx-runtime";
-import { u as j, P as W, a as Q, B as H, c as g, b as K, d as G } from "./chunks/switch-QfKb0Iwe.js";
-import { A as Ke, n as Ge, e as Ye, f as Xe, g as $e, p as Je, o as Ze, s as as, t as es, m as ss, i as rs, l as os, q as is, k as ts, j as ns, h as ls, v as ds, r as us, w as cs, y as ps, x as fs, z as ms, E as hs, D as Cs } from "./chunks/switch-QfKb0Iwe.js";
+import { u as j, P as W, a as Q, B as H, c as g, b as K, d as G } from "./chunks/switch-D5_tjsIS.js";
+import { A as Ke, n as Ge, e as Ye, f as Xe, g as $e, p as Je, o as Ze, s as as, t as es, m as ss, i as rs, l as os, q as is, k as ts, j as ns, h as ls, v as ds, r as us, w as cs, y as ps, x as fs, z as ms, E as hs, D as Cs } from "./chunks/switch-D5_tjsIS.js";
 import * as f from "react";
 import { useMemo as Y, useEffect as b } from "react";
 import { D as Ds } from "./chunks/token-types-Dl0hcKBX.js";
 import { C as xs, D as bs, L as ys, P as Ts, f as vs, g as As, k as Bs, j as Ss, l as Ns, e as _s, c as Ps, b as ws, d as Fs, n as Rs, h as Ls } from "./chunks/validators-CkHsAvwB.js";
-import { A as Ms, h as ks, D as Us, f as Os, g as Vs, e as qs, b as zs, E as js, N as Ws, U as Qs, a as Hs, V as Ks, W as Gs, u as Ys, c as Xs, d as $s } from "./chunks/dashboard-briefing-launcher-e3s3MuSs.js";
+import { A as Ms, h as ks, D as Us, f as Os, g as Vs, e as qs, b as zs, E as js, N as Ws, U as Qs, a as Hs, V as Ks, W as Gs, u as Ys, c as Xs, d as $s } from "./chunks/dashboard-briefing-launcher-BA_bl05p.js";
 import { u as Zs } from "./chunks/use-debounced-dirty-check-BwAbnX_5.js";
 import "./chunks/matrix-operation-contract-D0HfzwZg.js";
 import "./chunks/matrix-continuation-C4sRcjZU.js";
@@ -21,7 +21,7 @@ import { c as X } from "./chunks/calculated-field-identity-DnRd4YIY.js";
 import "zod";
 import "./chunks/card-config-utils-B2cDWQqB.js";
 import "react-dom";
-import "./chunks/index-CnGVjyF8.js";
+import "./chunks/index-v1OE4-eA.js";
 import "./chunks/appearance-context-VJdrKi7r.js";
 import "./chunks/color-CJvdlFM_.js";
 import "./chunks/index-CLIro-EG.js";

package/dist/surfboard/index.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("../chunks/index-DrOFJOCq.cjs"),r=require("../chunks/common-types-nBuCd3u2.cjs"),o=require("../chunks/report-preferences-dialog-DcLkVqni.cjs");exports.DisplayFormatPreferencesFields=e.DisplayFormatPreferencesFields;exports.Surfboard=e.DashboardPlus;exports.CONTROL_CARD_DEFAULT_VALUE=r.CONTROL_CARD_DEFAULT_VALUE;exports.EMPTY_SELECTION=r.EMPTY_SELECTION;exports.ReportPreferencesDialog=o.ReportPreferencesDialog;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("../chunks/index-C6_xef4P.cjs"),r=require("../chunks/common-types-nBuCd3u2.cjs"),o=require("../chunks/report-preferences-dialog-Dr1BYwuf.cjs");exports.DisplayFormatPreferencesFields=e.DisplayFormatPreferencesFields;exports.Surfboard=e.DashboardPlus;exports.CONTROL_CARD_DEFAULT_VALUE=r.CONTROL_CARD_DEFAULT_VALUE;exports.EMPTY_SELECTION=r.EMPTY_SELECTION;exports.ReportPreferencesDialog=o.ReportPreferencesDialog;

package/dist/surfboard/index.js

@@ -1,6 +1,6 @@
-import { b as a, a as o } from "../chunks/index-nhUr9xBz.js";
+import { b as a, a as o } from "../chunks/index-Dlic9KZs.js";
 import { C as f, E } from "../chunks/common-types-C6cAQgyh.js";
-import { R as t } from "../chunks/report-preferences-dialog-B2fzQH1T.js";
+import { R as t } from "../chunks/report-preferences-dialog-b8J6KjSy.js";
 export {
   f as CONTROL_CARD_DEFAULT_VALUE,
   a as DisplayFormatPreferencesFields,

package/dist/types/components/visual/aggregated-table/utils/metric-format-resolver.d.ts

@@ -4,7 +4,7 @@ import { ColumnSettings, ColumnSettingsMap } from '../../data-table/types/data-t
 import { PresentationFormatField } from '../../../../lib/formatters/metric-formatting.js';
 import { ResolvedValueFormatPreferences } from '../../../../shared/value-format-preferences/index.js';
 import { CardNumericPresentationContext } from '../../../../lib/formatters/numeric-presentation.js';
-import { NumericCanonicalFormat } from '../../../../shared/format-utils/types/index.js';
+import { MeasureCanonicalFormat } from '../../../../shared/format-utils/types/index.js';
 import { coerceNumericValue } from '../../../../lib/formatters/numeric-value-coercion.js';
 export { hasNumericFieldFormat } from '../../../../lib/table-formatting/table-presentation-fields.js';
 export { coerceNumericValue };
@@ -58,9 +58,9 @@ export declare function resolveAggregateMetricCanonicalPresentation(params: {
     groupByColumnCount: number;
     columnSettingsMap?: ColumnSettingsMap;
     presentation?: CardNumericPresentationContext;
-}): NumericCanonicalFormat | undefined;
+}): MeasureCanonicalFormat | undefined;
 export declare function formatNumericWithSettings(value: unknown, settings?: ColumnSettings): string | null;
 export declare function formatAggregateMetricValue(value: unknown, presentation?: {
     settings?: ColumnSettings;
-    canonical?: NumericCanonicalFormat;
+    canonical?: MeasureCanonicalFormat;
 }): string;

package/dist/types/components/visual/data-table/types/data-table.d.ts

@@ -6,6 +6,7 @@ import { Interaction } from '../../../../lib/types/interaction-types.js';
 import { ClickContextResult } from '../../../../lib/interactions/get-click-context-from-chartjs.js';
 import { ComparisonMetadataMap } from '../../../../lib/types/query-types.js';
 import { ColumnReorderRequest } from '../../shared/utils/table-column-order.js';
+import { ColumnDurationFormat, ColumnNumberStyle } from '../../../../shared/format-utils/types/index.js';
 import { ConditionalFormattingRenderContext, TableBaseFormatting, TableBaseStyle } from '../../../../lib/table-formatting/table-formatting-types.js';
 import { ColumnTextWrap } from '../../../../lib/table-formatting/table-text-flow.js';
 import { RawTemporalValueKind, SemaphorResultColumn } from '../../../../shared/analytics-protocol/index.js';
@@ -38,7 +39,7 @@ export interface ColumnSettings {
     totalsBehavior?: TotalsBehavior;
     totalsLabel?: string;
     numberFormat: {
-        style: 'decimal' | 'currency' | 'percent' | 'scientific';
+        style: ColumnNumberStyle;
         currency?: string;
         locale?: string;
         minimumFractionDigits?: number;
@@ -50,6 +51,8 @@ export interface ColumnSettings {
         negativeStyle?: 'minus' | 'parentheses';
         prefix?: string;
         suffix?: string;
+        /** Duration options; read only when `style` is `duration`. */
+        duration?: ColumnDurationFormat;
         showDataBar: boolean;
         dataBarColor: string;
         dataBarMinValue?: number;

package/dist/types/components/visual/pivot-table/utils/pivot-metric-formatting.d.ts

@@ -1,7 +1,7 @@
 import { CurrencyPresentationTarget, TCard } from '../../../../lib/types/common-types.js';
 import { ResolvedValueFormatPreferences } from '../../../../shared/value-format-preferences/index.js';
 import { ColumnSettings, ColumnSettingsMap } from '../../data-table/types/data-table.js';
-import { NumericCanonicalFormat } from '../../../../shared/format-utils/types/index.js';
+import { MeasureCanonicalFormat } from '../../../../shared/format-utils/types/index.js';
 type PivotColumnMetadata = Record<string, {
     metricId?: string;
     metricAlias?: string;
@@ -14,5 +14,5 @@ export declare function resolvePivotRowTotalSettings(params: {
     valueFormatPreferences: ResolvedValueFormatPreferences | null;
     resolveBoundCurrency: (target: CurrencyPresentationTarget) => string | undefined;
 }): ColumnSettings | undefined;
-export declare function resolvePivotRowTotalCanonicalFormat(params: Parameters<typeof resolvePivotRowTotalSettings>[0]): NumericCanonicalFormat | undefined;
+export declare function resolvePivotRowTotalCanonicalFormat(params: Parameters<typeof resolvePivotRowTotalSettings>[0]): MeasureCanonicalFormat | undefined;
 export {};

package/dist/types/lib/formatters/metric-formatting.d.ts

@@ -6,7 +6,7 @@ import { CardNumericPresentationContext } from './numeric-presentation.js';
 import { RawTemporalValueKind } from '../../shared/format-utils/index.js';
 import { ResolvedValueFormatPreferences } from '../../shared/value-format-preferences/index.js';
 import { MatrixCardCatalog } from '../matrix-table/matrix-card-adapter.js';
-import { NumericCanonicalFormat } from '../../shared/format-utils/types/index.js';
+import { MeasureCanonicalFormat, NumericCanonicalFormat } from '../../shared/format-utils/types/index.js';
 import { ChartNumericPresentationContext } from './chart-numeric-presentation.js';
 type MetricLookup = TableFieldLookup;
 export type PresentationFormatField = Pick<MetricField | DetailField | GroupByField, 'id' | 'name' | 'alias' | 'format' | 'dataType'>;
@@ -154,7 +154,7 @@ export declare function resolveMetricCanonicalFormat(params: {
     columnKeyMap?: QueryColumnKeyMap;
     valueFormatPreferences?: ResolvedValueFormatPreferences | null;
     boundCurrency?: string;
-}): NumericCanonicalFormat | undefined;
+}): MeasureCanonicalFormat | undefined;
 export declare function resolveTableColumnCanonicalPresentation(params: {
     card: TCard;
     columnId: string;
@@ -167,7 +167,7 @@ export declare function resolveTableColumnCanonicalPresentation(params: {
     comparisonValueKind?: 'comparison' | 'delta' | 'percent_change' | 'ratio';
     comparisonPrecision?: number;
     presentation: CardNumericPresentationContext;
-}): NumericCanonicalFormat | undefined;
+}): MeasureCanonicalFormat | undefined;
 export declare function resolveCurrencyPresentationTargetFormat(params: {
     matrixCatalog?: MatrixCardCatalog;
     card: TCard;

package/dist/types/lib/table-formatting/table-presentation-fields.d.ts

@@ -10,6 +10,7 @@ export type TableFieldLookup = {
     fieldRole?: QueryColumnKeyRole;
     columnKeyMap?: QueryColumnKeyMap;
 };
+/** True when the field authors a format for numeric values (numeric or duration). */
 export declare function hasNumericFieldFormat(field: Pick<PresentationField, 'format'> | undefined): boolean;
 /** Resolve identity before presentation. A supplied map is authoritative; names
  * and labels are only a unique-match adapter for results without bindings. */

package/dist/types/lib/utils/date-timezone-utils.d.ts

@@ -8,9 +8,13 @@ import { CalendarContext, WeekStart } from '../types/token-types.js';
  * @returns A Date object representing midnight in the specified timezone
  *
  * @example
- * // User in PST selects Nov 18, 2025
- * startOfDayInTimezone(new Date('2025-11-18'), 'America/Los_Angeles')
+ * // Nov 18, 2025 14:30 PST
+ * startOfDayInTimezone(new Date('2025-11-18T22:30:00Z'), 'America/Los_Angeles')
  * // Returns a Date that serializes to: 2025-11-18T08:00:00.000Z (Nov 18 00:00 PST)
+ *
+ * Do not pass `new Date('YYYY-MM-DD')`: that is UTC midnight, which is the
+ * previous day in zones west of UTC. Use `parseFilterDateValue` for
+ * date-only strings.
  */
 export declare const startOfDayInTimezone: (date: Date, timezone: string) => Date;
 /**
@@ -22,11 +26,29 @@ export declare const startOfDayInTimezone: (date: Date, timezone: string) => Dat
  * @returns A Date object representing 23:59:59.999 in the specified timezone
  *
  * @example
- * // User in PST selects Nov 20, 2025
- * endOfDayInTimezone(new Date('2025-11-20'), 'America/Los_Angeles')
+ * // Nov 20, 2025 14:30 PST
+ * endOfDayInTimezone(new Date('2025-11-20T22:30:00Z'), 'America/Los_Angeles')
  * // Returns a Date that serializes to: 2025-11-21T07:59:59.999Z (Nov 20 23:59:59 PST)
  */
 export declare const endOfDayInTimezone: (date: Date, timezone: string) => Date;
+/**
+ * Parses a stored date filter value into the instant the date pickers would
+ * have written for it.
+ *
+ * Filter values are usually instants, but date-only strings (`YYYY-MM-DD`)
+ * also arrive from SDK/embed defaults, generated dashboards and inputs. A
+ * date-only string names a calendar day, not an instant: it maps to the start
+ * (or, for an upper bound, the end) of that day in `timezone`, exactly as
+ * `startOfDayInTimezone` / `endOfDayInTimezone` produce for a picked day.
+ * `new Date('YYYY-MM-DD')` would instead give UTC midnight, which displays as
+ * the previous day in zones west of UTC.
+ *
+ * Everything else parses as an instant. Returns undefined for empty or
+ * unparseable values, including `YYYY-MM-DD` strings that name no calendar
+ * day (which `new Date` would silently roll into the next month). A missing timezone falls back to the browser zone, as
+ * `getEffectiveTimezone` does.
+ */
+export declare const parseFilterDateValue: (value: unknown, timezone: string | null | undefined, bound?: "start" | "end") => Date | undefined;
 /**
  * Gets the start of week (midnight) for a date in the specified timezone.
  *

package/dist/types/shared/format-utils/formatters/duration-formatter.d.ts

@@ -1,2 +1,5 @@
-import { DurationFormatOptions } from '../types/index.js';
+import { DurationCanonicalFormat, DurationFormatOptions } from '../types/index.js';
+import { ExactNumericValue } from '../../analytics-protocol/scalar-value.js';
 export declare function formatDuration(value: number | string | null | undefined, options?: DurationFormatOptions): string;
+/** Formats a value with a canonical duration format. */
+export declare function formatDurationCanonical(value: number | ExactNumericValue | string | null | undefined, format: DurationCanonicalFormat): string;

package/dist/types/shared/format-utils/formatters/index.d.ts

@@ -1,5 +1,5 @@
-export { formatNumber, formatCurrency, formatPercent, formatScientific, formatNumericCanonical, formatNumberWithColumnSettings, formatNumberCustom, } from './number-formatter.js';
-export { formatDuration } from './duration-formatter.js';
+export { formatNumber, formatCurrency, formatPercent, formatScientific, formatNumericCanonical, formatMeasureCanonical, formatNumberWithColumnSettings, formatNumberCustom, } from './number-formatter.js';
+export { formatDuration, formatDurationCanonical } from './duration-formatter.js';
 export { formatMetricComparison, type FormattedMetricComparison, type FormattedMetricComparisonPart, type FormatMetricComparisonOptions, type MetricComparisonDisplayMode, } from './metric-comparison-formatter.js';
 export { formatDate, formatRelativeTime, resolveTimezone, getTimezoneAbbreviation, getTimezoneName, parseWithSourceTimezone, } from './date-formatter.js';
 export { formatCellValue, formatRowForExport } from './cell-formatter.js';

package/dist/types/shared/format-utils/formatters/number-formatter.d.ts

@@ -1,4 +1,4 @@
-import { FormatOptions, NumberFormatOptions, NumericCanonicalFormat } from '../types/index.js';
+import { ColumnDurationFormat, ColumnNumberStyle, FormatOptions, MeasureCanonicalFormat, NumberFormatOptions, NumericCanonicalFormat } from '../types/index.js';
 import { ExactNumericValue } from '../../analytics-protocol/scalar-value.js';
 type NumericValue = number | ExactNumericValue;
 /**
@@ -21,12 +21,17 @@ export declare function formatPercent(value: NumericValue | null | undefined, op
  */
 export declare function formatScientific(value: NumericValue | null | undefined, options?: NumberFormatOptions): string;
 export declare function formatNumericCanonical(value: number | ExactNumericValue | null | undefined, format: NumericCanonicalFormat): string;
+/**
+ * Formats a table measure value with its resolved format: numeric styles go
+ * through `formatNumericCanonical`, durations through the duration formatter.
+ */
+export declare function formatMeasureCanonical(value: number | ExactNumericValue | null | undefined, format: MeasureCanonicalFormat): string;
 /**
  * Format a number value based on ColumnSettings.numberFormat
  * Used for export formatting
  */
 export declare function formatNumberWithColumnSettings(value: number | ExactNumericValue | null | undefined, numberFormat: {
-    style?: 'decimal' | 'currency' | 'percent' | 'scientific';
+    style?: ColumnNumberStyle;
     currency?: string;
     locale?: string;
     minimumFractionDigits?: number;
@@ -38,6 +43,7 @@ export declare function formatNumberWithColumnSettings(value: number | ExactNume
     negativeStyle?: 'minus' | 'parentheses';
     prefix?: string;
     suffix?: string;
+    duration?: ColumnDurationFormat;
 } | undefined, defaultLocale?: string): string;
 /**
  * Legacy wrapper for backward compatibility with existing code

package/dist/types/shared/format-utils/presentation-execution.d.ts

@@ -2,7 +2,7 @@ import { ResolvedRawTemporalFormat } from './raw-temporal.js';
 import { ReportRuntimeContext } from '../report-runtime-context/index.js';
 import { NumericPresentationTarget } from './numeric-presentation.js';
 import { ResolvedTemporalBucketFormat } from './temporal-bucket.js';
-import { NumericCanonicalFormat } from './types/index.js';
+import { DurationCanonicalFormat, MeasureCanonicalFormat, NumericCanonicalFormat } from './types/index.js';
 export type PresentationScope = {
     dashboardId: string;
     cardId?: string;
@@ -25,6 +25,11 @@ export type ResolvedNumericPresentationEntry = {
     target: NumericPresentationTarget;
     format: NumericCanonicalFormat;
 };
+export type ResolvedDurationPresentationEntry = {
+    scope: PresentationScope;
+    target: NumericPresentationTarget;
+    format: DurationCanonicalFormat;
+};
 export type ResolvedTemporalBucketPresentationEntry = {
     scope: PresentationScope;
     target: TemporalBucketPresentationTarget;
@@ -39,7 +44,7 @@ export type ResolvedRawTemporalPresentationEntry = {
     target: RawTemporalPresentationTarget;
     format: ResolvedRawTemporalFormat;
 };
-export type ResolvedPresentationEntry = ResolvedNumericPresentationEntry | ResolvedTemporalBucketPresentationEntry | ResolvedRawTemporalPresentationEntry;
+export type ResolvedPresentationEntry = ResolvedNumericPresentationEntry | ResolvedDurationPresentationEntry | ResolvedTemporalBucketPresentationEntry | ResolvedRawTemporalPresentationEntry;
 export type PresentationExecutionSnapshot = {
     version: 1;
     reportContext: ReportRuntimeContext;
@@ -67,6 +72,16 @@ export declare function findResolvedNumericFormat(input: {
     scope: PresentationScope;
     target: NumericPresentationTarget;
 }): NumericCanonicalFormat | undefined;
+/**
+ * Finds the resolved numeric or duration format for a measure target. Value
+ * formatters use this; `findResolvedNumericFormat` is for numeric-only
+ * consumers such as precision and currency lookups.
+ */
+export declare function findResolvedMeasureFormat(input: {
+    snapshot: PresentationExecutionSnapshot;
+    scope: PresentationScope;
+    target: NumericPresentationTarget;
+}): MeasureCanonicalFormat | undefined;
 export declare function findResolvedRawTemporalFormat(input: {
     snapshot: PresentationExecutionSnapshot;
     scope: PresentationScope;

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

@@ -51,6 +51,12 @@ export type DurationCanonicalFormat = {
     suffix?: string;
     negativeStyle?: 'minus' | 'parentheses';
 };
+/**
+ * Formats a table measure value can resolve to: a numeric style, or a
+ * duration rendered from a numeric amount of `inputUnit`. Every surface that
+ * renders a measure value (table cells, totals, exports) must accept both.
+ */
+export type MeasureCanonicalFormat = NumericCanonicalFormat | DurationCanonicalFormat;
 export type StringCanonicalFormat = {
     type: 'string';
     prefix?: string;
@@ -58,6 +64,7 @@ export type StringCanonicalFormat = {
 };
 export type CanonicalFormatSpec = NumericCanonicalFormat | DateCanonicalFormat | RawTemporalFormat | DurationCanonicalFormat | StringCanonicalFormat | TemporalBucketFormat;
 export declare function isNumericCanonicalFormat(format: unknown): format is NumericCanonicalFormat;
+export declare function isMeasureCanonicalFormat(format: unknown): format is MeasureCanonicalFormat;
 export interface NumberFormatOptions {
     style: 'decimal' | 'currency' | 'percent' | 'scientific';
     locale?: string;
@@ -113,18 +120,26 @@ export interface DateFormatOptions {
     /** Locale for date formatting */
     locale?: string;
 }
+export type ColumnNumberStyle = 'decimal' | 'currency' | 'percent' | 'scientific' | 'duration';
+/** Duration options on a table column (`numberFormat.style: 'duration'`). */
+export type ColumnDurationFormat = Pick<DurationCanonicalFormat, 'inputUnit' | 'outputStyle' | 'largestUnit' | 'smallestUnit' | 'maxUnits'>;
 export interface ColumnSettings {
     type: 'none' | 'text' | 'number' | 'date' | 'badge' | 'link' | 'progress';
     textAlign?: 'left' | 'center' | 'right';
     width?: number;
     numberFormat?: {
-        style: 'decimal' | 'currency' | 'percent' | 'scientific';
+        style: ColumnNumberStyle;
         currency?: string;
         locale?: string;
         minimumFractionDigits?: number;
         maximumFractionDigits?: number;
         useGrouping?: boolean;
         percentValueMode?: 'fraction' | 'whole';
+        prefix?: string;
+        suffix?: string;
+        negativeStyle?: 'minus' | 'parentheses';
+        /** Duration options; read only when `style` is `duration`. */
+        duration?: ColumnDurationFormat;
         showDataBar?: boolean;
         dataBarColor?: string;
         dataBarMinValue?: number;

package/package.json

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

package/dist/chunks/index-F25jnH0p.cjs

@@ -1 +0,0 @@
-"use strict";function F(e,t){const n=b(t);return"formatToParts"in n?$(n,e):A(n,e)}const _={year:0,month:1,day:2,hour:3,minute:4,second:5};function $(e,t){try{const n=e.formatToParts(t),r=[];for(let i=0;i<n.length;i++){const a=_[n[i].type];a!==void 0&&(r[a]=parseInt(n[i].value,10))}return r}catch(n){if(n instanceof RangeError)return[NaN];throw n}}function A(e,t){const n=e.format(t),r=/(\d+)\/(\d+)\/(\d+),? (\d+):(\d+):(\d+)/.exec(n);return[parseInt(r[3],10),parseInt(r[1],10),parseInt(r[2],10),parseInt(r[4],10),parseInt(r[5],10),parseInt(r[6],10)]}const f={},I=new Intl.DateTimeFormat("en-US",{hourCycle:"h23",timeZone:"America/New_York",year:"numeric",month:"2-digit",day:"2-digit",hour:"2-digit",minute:"2-digit",second:"2-digit"}).format(new Date("2014-06-25T04:00:00.123Z")),S=I==="06/25/2014, 00:00:00"||I==="‎06‎/‎25‎/‎2014‎ ‎00‎:‎00‎:‎00";function b(e){return f[e]||(f[e]=S?new Intl.DateTimeFormat("en-US",{hourCycle:"h23",timeZone:e,year:"numeric",month:"numeric",day:"2-digit",hour:"2-digit",minute:"2-digit",second:"2-digit"}):new Intl.DateTimeFormat("en-US",{hour12:!1,timeZone:e,year:"numeric",month:"numeric",day:"2-digit",hour:"2-digit",minute:"2-digit",second:"2-digit"})),f[e]}function T(e,t,n,r,i,a,o){const u=new Date(0);return u.setUTCFullYear(e,t,n),u.setUTCHours(r,i,a,o),u}const w=36e5,L=6e4,D={timezoneZ:/^(Z)$/,timezoneHH:/^([+-]\d{2})$/,timezoneHHMM:/^([+-])(\d{2}):?(\d{2})$/};function Y(e,t,n){if(!e)return 0;let r=D.timezoneZ.exec(e);if(r)return 0;let i,a;if(r=D.timezoneHH.exec(e),r)return i=parseInt(r[1],10),g(i)?-(i*w):NaN;if(r=D.timezoneHHMM.exec(e),r){i=parseInt(r[2],10);const o=parseInt(r[3],10);return g(i,o)?(a=Math.abs(i)*w+o*L,r[1]==="+"?-a:a):NaN}if(E(e)){t=new Date(t||Date.now());const o=n?t:Z(t),u=m(o,e);return-(n?u:z(t,u,e))}return NaN}function Z(e){return T(e.getFullYear(),e.getMonth(),e.getDate(),e.getHours(),e.getMinutes(),e.getSeconds(),e.getMilliseconds())}function m(e,t){const n=F(e,t),r=T(n[0],n[1]-1,n[2],n[3]%24,n[4],n[5],0).getTime();let i=e.getTime();const a=i%1e3;return i-=a>=0?a:1e3+a,r-i}function z(e,t,n){let i=e.getTime()-t;const a=m(new Date(i),n);if(t===a)return t;i-=a-t;const o=m(new Date(i),n);return a===o?a:Math.max(a,o)}function g(e,t){return-23<=e&&e<=23&&(t==null||0<=t&&t<=59)}const M={};function E(e){if(M[e])return!0;try{return new Intl.DateTimeFormat(void 0,{timeZone:e}),M[e]=!0,!0}catch{return!1}}function h(e){const t=new Date(Date.UTC(e.getFullYear(),e.getMonth(),e.getDate(),e.getHours(),e.getMinutes(),e.getSeconds(),e.getMilliseconds()));return t.setUTCFullYear(e.getFullYear()),+e-+t}const U=/(Z|[+-]\d{2}(?::?\d{2})?| UTC| [a-zA-Z]+\/[a-zA-Z_]+(?:\/[a-zA-Z_]+)?)$/,N=36e5,H=6e4,P=2,s={dateTimePattern:/^([0-9W+-]+)(T| )(.*)/,datePattern:/^([0-9W+-]+)(.*)/,YY:/^(\d{2})$/,YYY:[/^([+-]\d{2})$/,/^([+-]\d{3})$/,/^([+-]\d{4})$/],YYYY:/^(\d{4})/,YYYYY:[/^([+-]\d{4})/,/^([+-]\d{5})/,/^([+-]\d{6})/],MM:/^-(\d{2})$/,DDD:/^-?(\d{3})$/,MMDD:/^-?(\d{2})-?(\d{2})$/,Www:/^-?W(\d{2})$/,WwwD:/^-?W(\d{2})-?(\d{1})$/,HH:/^(\d{2}([.,]\d*)?)$/,HHMM:/^(\d{2}):?(\d{2}([.,]\d*)?)$/,HHMMSS:/^(\d{2}):?(\d{2}):?(\d{2}([.,]\d*)?)$/,timeZone:U};function p(e,t={}){if(arguments.length<1)throw new TypeError("1 argument required, but only "+arguments.length+" present");if(e===null)return new Date(NaN);const n=t.additionalDigits==null?P:Number(t.additionalDigits);if(n!==2&&n!==1&&n!==0)throw new RangeError("additionalDigits must be 0, 1 or 2");if(e instanceof Date||typeof e=="object"&&Object.prototype.toString.call(e)==="[object Date]")return new Date(e.getTime());if(typeof e=="number"||Object.prototype.toString.call(e)==="[object Number]")return new Date(e);if(Object.prototype.toString.call(e)!=="[object String]")return new Date(NaN);const r=W(e),{year:i,restDateString:a}=k(r.date,n),o=v(a,i);if(o===null||isNaN(o.getTime()))return new Date(NaN);if(o){const u=o.getTime();let c=0,l;if(r.time&&(c=j(r.time),c===null||isNaN(c)))return new Date(NaN);if(r.timeZone||t.timeZone){if(l=Y(r.timeZone||t.timeZone,new Date(u+c)),isNaN(l))return new Date(NaN)}else l=h(new Date(u+c)),l=h(new Date(u+c+l));return new Date(u+c+l)}else return new Date(NaN)}function W(e){const t={};let n=s.dateTimePattern.exec(e),r;if(n?(t.date=n[1],r=n[3]):(n=s.datePattern.exec(e),n?(t.date=n[1],r=n[2]):(t.date=null,r=e)),r){const i=s.timeZone.exec(r);i?(t.time=r.replace(i[1],""),t.timeZone=i[1].trim()):t.time=r}return t}function k(e,t){if(e){const n=s.YYY[t],r=s.YYYYY[t];let i=s.YYYY.exec(e)||r.exec(e);if(i){const a=i[1];return{year:parseInt(a,10),restDateString:e.slice(a.length)}}if(i=s.YY.exec(e)||n.exec(e),i){const a=i[1];return{year:parseInt(a,10)*100,restDateString:e.slice(a.length)}}}return{year:null}}function v(e,t){if(t===null)return null;let n,r,i;if(!e||!e.length)return n=new Date(0),n.setUTCFullYear(t),n;let a=s.MM.exec(e);if(a)return n=new Date(0),r=parseInt(a[1],10)-1,C(t,r)?(n.setUTCFullYear(t,r),n):new Date(NaN);if(a=s.DDD.exec(e),a){n=new Date(0);const o=parseInt(a[1],10);return q(t,o)?(n.setUTCFullYear(t,0,o),n):new Date(NaN)}if(a=s.MMDD.exec(e),a){n=new Date(0),r=parseInt(a[1],10)-1;const o=parseInt(a[2],10);return C(t,r,o)?(n.setUTCFullYear(t,r,o),n):new Date(NaN)}if(a=s.Www.exec(e),a)return i=parseInt(a[1],10)-1,O(i)?x(t,i):new Date(NaN);if(a=s.WwwD.exec(e),a){i=parseInt(a[1],10)-1;const o=parseInt(a[2],10)-1;return O(i,o)?x(t,i,o):new Date(NaN)}return null}function j(e){let t,n,r=s.HH.exec(e);if(r)return t=parseFloat(r[1].replace(",",".")),d(t)?t%24*N:NaN;if(r=s.HHMM.exec(e),r)return t=parseInt(r[1],10),n=parseFloat(r[2].replace(",",".")),d(t,n)?t%24*N+n*H:NaN;if(r=s.HHMMSS.exec(e),r){t=parseInt(r[1],10),n=parseInt(r[2],10);const i=parseFloat(r[3].replace(",","."));return d(t,n,i)?t%24*N+n*H+i*1e3:NaN}return null}function x(e,t,n){t=t||0,n=n||0;const r=new Date(0);r.setUTCFullYear(e,0,4);const i=r.getUTCDay()||7,a=t*7+n+1-i;return r.setUTCDate(r.getUTCDate()+a),r}const R=[31,28,31,30,31,30,31,31,30,31,30,31],G=[31,29,31,30,31,30,31,31,30,31,30,31];function y(e){return e%400===0||e%4===0&&e%100!==0}function C(e,t,n){if(t<0||t>11)return!1;if(n!=null){if(n<1)return!1;const r=y(e);if(r&&n>G[t]||!r&&n>R[t])return!1}return!0}function q(e,t){if(t<1)return!1;const n=y(e);return!(n&&t>366||!n&&t>365)}function O(e,t){return!(e<0||e>52||t!=null&&(t<0||t>6))}function d(e,t,n){return!(e<0||e>=25||t!=null&&(t<0||t>=60)||n!=null&&(n<0||n>=60))}function J(e,t,n){if(typeof e=="string"&&!e.match(U))return p(e,{...n,timeZone:t});e=p(e,n);const r=T(e.getFullYear(),e.getMonth(),e.getDate(),e.getHours(),e.getMinutes(),e.getSeconds(),e.getMilliseconds()).getTime(),i=Y(t,new Date(r));return new Date(r+i)}exports.fromZonedTime=J;exports.toDate=p;exports.tzParseTimezone=Y;