react-semaphor 0.1.428 → 0.1.429

package/dist/surfboard/index.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const r=require("../chunks/dashboard-CMDXBLnG.js"),e=require("../chunks/common-types-C73-Ud1-.js"),a=require("../chunks/calendar-preferences-dialog-_L9eBQfj.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 e=require("../chunks/dashboard-CQfAvRYI.js"),r=require("../chunks/common-types-C73-Ud1-.js"),o=require("../chunks/report-preferences-dialog-DV_5aHrS.js");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,9 +1,10 @@
-import { a as e } from "../chunks/dashboard-509sbC4_.js";
-import { C, E } from "../chunks/common-types-ClkOI-3O.js";
-import { C as s } from "../chunks/calendar-preferences-dialog-BF9bNAF_.js";
+import { a, b as o } from "../chunks/dashboard-agBXhvKo.js";
+import { C as f, E } from "../chunks/common-types-ClkOI-3O.js";
+import { R as t } from "../chunks/report-preferences-dialog-CPptr_V9.js";
 export {
-  C as CONTROL_CARD_DEFAULT_VALUE,
-  s as CalendarPreferencesDialog,
+  f as CONTROL_CARD_DEFAULT_VALUE,
+  a as DisplayFormatPreferencesFields,
   E as EMPTY_SELECTION,
-  e as Surfboard
+  t as ReportPreferencesDialog,
+  o as Surfboard
 };

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

@@ -235,7 +235,6 @@ export declare type MatrixCell = {
     measureInstanceId: string;
     rawValue: unknown;
     presence: MatrixCellPresence;
-    formattedValue?: string;
     role: MatrixCellRole;
     aggregateFunction?: SemaphorAggregateFunction;
     formattingScope: MatrixCellFormattingScope;
@@ -311,7 +310,6 @@ export declare type MatrixGridCell = {
     columnId: string;
     cellId?: string;
     rawValue: unknown;
-    formattedValue?: string;
     presence: MatrixCellPresence;
     role: MatrixCellRole;
     measureInstanceId: string;
@@ -486,7 +484,6 @@ export declare type MatrixResultCell = {
     columnId?: string;
     measureId: string;
     value: unknown;
-    formattedValue?: string;
     presence: MatrixCellPresence;
     role: MatrixCellRole;
     calculationId?: string;
@@ -4138,7 +4135,6 @@ export declare type SemaphorValidationResult = {
 
 export declare type SemaphorValueFormat = {
     type: 'number' | 'currency' | 'percent' | 'percentage' | 'scientific';
-    locale?: string;
     minimumFractionDigits?: number;
     maximumFractionDigits?: number;
     useGrouping?: boolean;

package/dist/types/briefings.d.ts

@@ -67,6 +67,45 @@ export declare const BRIEFING_TEXT_LIMITS: {
     readonly id: 500;
 };
 
+declare type BriefingAppearanceColorTokens = Partial<{
+    background: string;
+    foreground: string;
+    muted: string;
+    mutedForeground: string;
+    border: string;
+    primary: string;
+    primaryForeground: string;
+    positive: string;
+    negative: string;
+    warning: string;
+    info: string;
+}>;
+
+declare type BriefingAppearanceScheme = {
+    tokens?: BriefingAppearanceTokens;
+    components?: {
+        chart?: {
+            palette?: string[];
+        };
+    };
+};
+
+declare type BriefingAppearanceSpec = {
+    version?: number;
+    schemes?: {
+        light?: BriefingAppearanceScheme;
+        dark?: BriefingAppearanceScheme;
+    };
+};
+
+declare type BriefingAppearanceTokens = {
+    color?: BriefingAppearanceColorTokens;
+    typography?: {
+        fontFamily?: string;
+        monoFontFamily?: string;
+    };
+};
+
 export declare type BriefingArtifactFormat = (typeof BRIEFING_ARTIFACT_FORMATS)[number];
 
 export declare type BriefingAttachment = (BriefingAttachmentBase & {
@@ -174,9 +213,10 @@ export declare type BriefingContentBlock = {
 } | {
     type: 'metric';
     label: string;
-    value: string | number;
-    previousValue?: string | number | null;
-    delta?: string | number | null;
+    value: BriefingDisplayValue;
+    previousValue?: BriefingDisplayValue | null;
+    delta?: BriefingDisplayValue | null;
+    percentChange?: BriefingDisplayValue | null;
     unit?: string;
     evidenceIds?: string[];
 } | {
@@ -222,7 +262,7 @@ export declare type BriefingContentDocument = {
     blocks: BriefingContentBlock[];
 };
 
-export declare type BriefingContentScalar = string | number | boolean | null;
+export declare type BriefingContentScalar = string | number | boolean | BriefingNumericValue | null;
 
 export declare type BriefingContentSeverity = 'info' | 'positive' | 'warning' | 'critical';
 
@@ -261,6 +301,8 @@ export declare type BriefingDeliveryConfig = {
 
 export declare type BriefingDisplayTypeLabel = 'Analytical briefing' | 'Scheduled report' | 'On-demand report' | 'Plain briefing';
 
+export declare type BriefingDisplayValue = string | number | BriefingNumericValue;
+
 export declare type BriefingDraft = {
     name: string;
     description?: string | null;
@@ -283,8 +325,18 @@ export declare type BriefingEntityPresentation = {
 
 export declare type BriefingFormatProfile = 'concise' | 'balanced' | 'detailed';
 
+declare type BriefingFragments = {
+    preHeaderText?: string;
+    headerBannerHtml?: string;
+    signatureHtml?: string;
+    footerHtml?: string;
+    disclaimerHtml?: string;
+    unsubscribeUrl?: string;
+};
+
 export declare type BriefingJobConfig = {
     kind: BriefingKind;
+    reportContext: ReportRuntimeContext;
     source: BriefingSource;
     body: BriefingBody;
     attachments: BriefingAttachment[];
@@ -296,19 +348,29 @@ export declare type BriefingKind = typeof BRIEFING_KIND;
 
 export declare type BriefingKpiTile = {
     label: string;
-    value: string | number;
-    previousValue?: string | number | null;
-    delta?: string | number | null;
+    value: BriefingDisplayValue;
+    previousValue?: BriefingDisplayValue | null;
+    delta?: BriefingDisplayValue | null;
+    percentChange?: BriefingDisplayValue | null;
     unit?: string;
     evidenceIds?: string[];
 };
 
 export declare type BriefingLimits = {
     maxToolCalls?: number;
+    maxPlanningIterations?: number;
     maxRows?: number;
     timeoutMs?: number;
 };
 
+export declare type BriefingNumericTarget = NumericPresentationTarget;
+
+export declare type BriefingNumericValue = {
+    value: number;
+    target: BriefingNumericTarget;
+    format: NumericCanonicalFormat;
+};
+
 export declare type BriefingPdfOrientation = 'portrait' | 'landscape';
 
 export declare type BriefingPdfPageSize = 'letter' | 'legal' | 'a4' | 'a3' | 'tabloid';
@@ -320,6 +382,10 @@ export declare type BriefingPresentation = {
     audience?: string;
     tone?: string;
     format?: string;
+    appearance?: BriefingAppearanceSpec;
+    brandOverrides?: BriefingThemeOverrides;
+    fragments?: BriefingFragments;
+    viewUrl?: string;
 };
 
 export declare type BriefingRecipient = {
@@ -379,6 +445,12 @@ export declare type BriefingSource = {
 
 export declare type BriefingStatus = 'ACTIVE' | 'PAUSED' | 'DISABLED';
 
+declare type BriefingThemeOverrides = {
+    brandName?: string;
+    logoUrl?: string;
+    link?: string;
+};
+
 export declare type BriefingUiUser = {
     type: 'organization' | 'tenant';
     role?: string;
@@ -405,9 +477,7 @@ export declare type BriefingWebhookConfig = {
     secretEncrypted?: string;
 };
 
-export declare function buildBriefingJobConfig(input: Omit<Partial<BriefingJobConfig>, 'kind'> & {
-    body: BriefingBody;
-}): BriefingJobConfig;
+export declare function buildBriefingJobConfig(input: Omit<Partial<BriefingJobConfig>, 'kind' | 'body' | 'reportContext'> & Pick<BriefingJobConfig, 'body' | 'reportContext'>): BriefingJobConfig;
 
 export declare function buildBriefingScheduleExpr(view: BriefingScheduleViewModel): string;
 
@@ -463,6 +533,15 @@ declare interface CalculatedFieldFormula {
  */
 declare type CalculatedFieldOperation = 'sum' | 'difference' | 'product' | 'ratio' | 'change' | 'percentage' | 'scale' | 'custom';
 
+declare type CalendarContext = {
+    tz: string;
+    weekStart: WeekStart;
+    anchor: 'now' | {
+        iso: string;
+    };
+    fiscalCalendar?: MonthAlignedFiscalCalendar;
+};
+
 export declare function canCreateBriefingForUser(user: BriefingUiUser | null | undefined): boolean;
 
 declare interface CardConfig {
@@ -623,12 +702,17 @@ declare interface ColumnSettings {
     totalsLabel?: string;
     numberFormat: {
         style: 'decimal' | 'currency' | 'percent' | 'scientific';
-        currency: string;
-        locale: string;
-        minimumFractionDigits: number;
-        maximumFractionDigits: number;
+        currency?: string;
+        locale?: string;
+        minimumFractionDigits?: number;
+        maximumFractionDigits?: number;
         useGrouping?: boolean;
         percentValueMode?: 'fraction' | 'whole';
+        scale?: number;
+        compact?: boolean;
+        negativeStyle?: 'minus' | 'parentheses';
+        prefix?: string;
+        suffix?: string;
         showDataBar: boolean;
         dataBarColor: string;
         dataBarMinValue?: number;
@@ -654,8 +738,6 @@ declare interface ColumnSettings {
     colorRanges: ColorRange_2[];
 }
 
-declare type ColumnSettingsMap = Record<string, ColumnSettings>;
-
 declare type ColumnTextWrap = 'default' | 'truncate' | 'wrap' | 'nowrap' | 'preserve';
 
 declare type ColumnType = 'string' | 'number' | 'date';
@@ -793,7 +875,7 @@ declare type ControlBinding = {
     controlId: string;
     target: 'config_grain';
     mapping: Record<string, string>;
-};
+} | CurrencyPresentationBinding;
 
 declare type ControlDefinition = {
     id: string;
@@ -857,6 +939,23 @@ export declare type CreateBriefingRequest = {
     deliveryConfig: BriefingDeliveryConfig | null;
 };
 
+declare type CurrencyPresentationBinding = {
+    controlId: string;
+    target: 'presentation_currency';
+    presentationTarget: CurrencyPresentationTarget;
+};
+
+declare type CurrencyPresentationTarget = {
+    kind: 'metric';
+    metricId: string;
+} | {
+    kind: 'column';
+    columnKey: string;
+} | {
+    kind: 'matrix_measure';
+    measureId: string;
+};
+
 declare type DashboardInputExportKey = 'label' | 'value' | 'start' | 'end' | 'range';
 
 declare type DashboardInputTextContent = Array<{
@@ -1247,6 +1346,13 @@ declare type FixedMonthDefaultDateFilter = {
     month: number;
 };
 
+export declare function formatBriefingComparisonValues(input: {
+    delta?: BriefingDisplayValue | null;
+    percentChange?: BriefingDisplayValue | null;
+}): string;
+
+export declare function formatBriefingDisplayValue(value: BriefingDisplayValue | boolean | null | undefined): string;
+
 declare type FormatSpec = {
     type: 'number' | 'currency' | 'percent' | 'percentage' | 'scientific';
     locale?: string;
@@ -1419,6 +1525,8 @@ export declare function isBriefingArtifactFormat(input: unknown): input is Brief
 
 export declare function isBriefingDeliveryChannel(input: unknown): input is BriefingDeliveryChannel;
 
+export declare function isBriefingNumericValue(value: unknown): value is BriefingNumericValue;
+
 export declare function isEmailOnlyBriefingDelivery(deliveryConfig: BriefingDeliveryConfig | null): boolean;
 
 export declare function isValidBriefingTimezone(value: unknown): value is string;
@@ -1462,6 +1570,8 @@ declare interface LinkFormat {
     openInNewTab: boolean;
 }
 
+declare type LocaleStyle = 'short' | 'medium' | 'long';
+
 declare type LogicalOperator = 'AND' | 'OR';
 
 export declare const MAX_BRIEFING_ATTACHMENTS = 20;
@@ -1550,6 +1660,11 @@ declare interface MetricField extends Field {
     semanticComparisonPolarity?: MetricComparisonPolarity;
 }
 
+declare type MonthAlignedFiscalCalendar = {
+    kind: 'month_aligned';
+    yearStartMonth: number;
+};
+
 declare type NoneOptions = {};
 
 export declare function normalizeBriefingContentDocument(input: unknown): BriefingContentDocument;
@@ -1576,6 +1691,41 @@ declare type NumberOptions = {
     colorRanges?: ColorRange[];
 };
 
+/**
+ * Shared format types for export system
+ * IMPORTANT: No React imports allowed in this file
+ *
+ * These types are used by:
+ * - react-semaphor (browser) for client-side exports
+ * - semaphor-app (Next.js) for API routes
+ * - Lambda (Node.js) for async export processing
+ */
+declare type NumericCanonicalFormat = {
+    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';
+};
+
+declare type NumericPresentationTarget = {
+    kind: 'metric';
+    metricId: string;
+} | {
+    kind: 'column';
+    columnKey: string;
+} | {
+    kind: 'matrix_measure';
+    measureId: string;
+};
+
 declare type OldFilterValue = string | number | null | (string | number)[] | RangeValue;
 
 declare type Operation = '=' | '>' | '<' | '>=' | '<=' | '!=' | 'in' | 'not in' | 'like' | 'not like' | 'between' | 'not between' | 'is null' | 'is not null';
@@ -1611,6 +1761,12 @@ export declare function parseBriefingScheduleExpr(expression: string): {
     issue: string;
 };
 
+declare type PersistedColumnSettings = Omit<Partial<ColumnSettings>, 'numberFormat'> & {
+    numberFormat?: Partial<ColumnSettings['numberFormat']>;
+};
+
+declare type PersistedColumnSettingsMap = Record<string, PersistedColumnSettings>;
+
 declare type PersistedInteraction = Interaction & {
     id?: string;
 };
@@ -1665,6 +1821,46 @@ declare type RelativeDateFilter = {
     to: number;
 };
 
+declare const REPORT_PREFERENCE_SOURCES: readonly ["viewer_user", "viewer_tenant_user", "session_initial", "viewer_tenant", "viewer_organization", "system_default"];
+
+declare type ReportPreferenceSource = (typeof REPORT_PREFERENCE_SOURCES)[number];
+
+declare type ReportPreferenceSources = {
+    calendar: ResolvedCalendarPreferenceSources;
+    valueFormat: ResolvedValueFormatPreferenceSources;
+};
+
+declare type ReportRuntimeContext = {
+    calendar: CalendarContext;
+    valueFormat: ResolvedValueFormatPreferences;
+    preferenceSources: ReportPreferenceSources;
+};
+
+declare type ResolvedCalendarPreferenceSources = {
+    tz: ReportPreferenceSource;
+    weekStart: ReportPreferenceSource;
+};
+
+declare type ResolvedValueFormatPreferences = {
+    locale: string;
+    dateStyle: LocaleStyle;
+    dateTime: {
+        dateStyle: LocaleStyle;
+        timeStyle: LocaleStyle;
+    };
+    defaultCurrency: string;
+};
+
+declare type ResolvedValueFormatPreferenceSources = {
+    locale: ReportPreferenceSource;
+    dateStyle: ReportPreferenceSource;
+    dateTime: {
+        dateStyle: ReportPreferenceSource;
+        timeStyle: ReportPreferenceSource;
+    };
+    defaultCurrency: ReportPreferenceSource;
+};
+
 declare type SelectedEntities = SelectedEntity[];
 
 declare type SelectedEntity = DatabaseEntityReference | DataModelEntityReference | DatasetEntityReference | FileEntityReference;
@@ -1941,7 +2137,6 @@ declare type SemaphorTimeGrain = 'hour' | 'day' | 'week' | 'month' | 'quarter' |
 
 declare type SemaphorValueFormat = {
     type: 'number' | 'currency' | 'percent' | 'percentage' | 'scientific';
-    locale?: string;
     minimumFractionDigits?: number;
     maximumFractionDigits?: number;
     useGrouping?: boolean;
@@ -2040,7 +2235,7 @@ declare type TableHeaderStyle = 'plain' | 'filled' | 'accent';
 declare type TablePart = 'body' | 'header' | 'footer' | 'subtotal' | 'grandTotal';
 
 declare type TablePreferences = {
-    columnSettingsMap?: ColumnSettingsMap;
+    columnSettingsMap?: PersistedColumnSettingsMap;
     baseFormatting?: TableBaseFormatting;
     conditionalFormatting?: TableConditionalFormatting;
     selectColumnVisible?: boolean;
@@ -2770,6 +2965,8 @@ declare type VisualDisplayPreferences = {
     };
 };
 
+declare type WeekStart = 0 | 1 | 2 | 3 | 4 | 5 | 6;
+
 declare type WindowFunction = 'running_total' | 'moving_average' | 'previous_period_delta' | 'percent_of_total';
 
 declare interface WindowTransform {

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

@@ -770,7 +770,6 @@ declare type MatrixResultCell = {
     columnId?: string;
     measureId: string;
     value: unknown;
-    formattedValue?: string;
     presence: MatrixCellPresence;
     role: MatrixCellRole;
     calculationId?: string;
@@ -1559,7 +1558,6 @@ declare type SemaphorTimeWindow = SemaphorRelativeTimeWindow | SemaphorAbsoluteT
 
 declare type SemaphorValueFormat = {
     type: 'number' | 'currency' | 'percent' | 'percentage' | 'scientific';
-    locale?: string;
     minimumFractionDigits?: number;
     maximumFractionDigits?: number;
     useGrouping?: boolean;

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

@@ -303,12 +303,17 @@ declare interface ColumnSettings {
     totalsLabel?: string;
     numberFormat: {
         style: 'decimal' | 'currency' | 'percent' | 'scientific';
-        currency: string;
-        locale: string;
-        minimumFractionDigits: number;
-        maximumFractionDigits: number;
+        currency?: string;
+        locale?: string;
+        minimumFractionDigits?: number;
+        maximumFractionDigits?: number;
         useGrouping?: boolean;
         percentValueMode?: 'fraction' | 'whole';
+        scale?: number;
+        compact?: boolean;
+        negativeStyle?: 'minus' | 'parentheses';
+        prefix?: string;
+        suffix?: string;
         showDataBar: boolean;
         dataBarColor: string;
         dataBarMinValue?: number;
@@ -334,8 +339,6 @@ declare interface ColumnSettings {
     colorRanges: ColorRange_2[];
 }
 
-declare type ColumnSettingsMap = Record<string, ColumnSettings>;
-
 declare type ColumnTextWrap = 'default' | 'truncate' | 'wrap' | 'nowrap' | 'preserve';
 
 declare type ColumnType = 'string' | 'number' | 'date';
@@ -518,7 +521,7 @@ declare type ControlBinding = {
     controlId: string;
     target: 'config_grain';
     mapping: Record<string, string>;
-};
+} | CurrencyPresentationBinding;
 
 declare type ControlDashboardInput = DashboardInputBase & {
     kind: 'control';
@@ -573,6 +576,23 @@ declare type ControlSource = {
 
 declare type ControlType = 'enum' | 'multi_enum' | 'text' | 'number' | 'boolean' | 'date' | 'field_selector' | 'metric_selector' | 'aggregation_selector' | 'grain_selector';
 
+declare type CurrencyPresentationBinding = {
+    controlId: string;
+    target: 'presentation_currency';
+    presentationTarget: CurrencyPresentationTarget;
+};
+
+declare type CurrencyPresentationTarget = {
+    kind: 'metric';
+    metricId: string;
+} | {
+    kind: 'column';
+    columnKey: string;
+} | {
+    kind: 'matrix_measure';
+    measureId: string;
+};
+
 declare type CustomCard = CardWithContent | CardWithFooter;
 
 export declare const DASHBOARD_AUTHORING_BREAKPOINTS: readonly ["lg", "md", "sm", "xs", "xxs"];
@@ -1853,6 +1873,12 @@ declare interface PaginationConfig {
     pageSize: number;
 }
 
+declare type PersistedColumnSettings = Omit<Partial<ColumnSettings>, 'numberFormat'> & {
+    numberFormat?: Partial<ColumnSettings['numberFormat']>;
+};
+
+declare type PersistedColumnSettingsMap = Record<string, PersistedColumnSettings>;
+
 declare type PersistedFrameLayoutItem = {
     i: string;
     x: number;
@@ -2397,7 +2423,6 @@ declare type SemaphorTimeWindow = SemaphorRelativeTimeWindow | SemaphorAbsoluteT
 
 declare type SemaphorValueFormat = {
     type: 'number' | 'currency' | 'percent' | 'percentage' | 'scientific';
-    locale?: string;
     minimumFractionDigits?: number;
     maximumFractionDigits?: number;
     useGrouping?: boolean;
@@ -2554,7 +2579,7 @@ declare type TableHeaderStyle = 'plain' | 'filled' | 'accent';
 declare type TablePart = 'body' | 'header' | 'footer' | 'subtotal' | 'grandTotal';
 
 declare type TablePreferences = {
-    columnSettingsMap?: ColumnSettingsMap;
+    columnSettingsMap?: PersistedColumnSettingsMap;
     baseFormatting?: TableBaseFormatting;
     conditionalFormatting?: TableConditionalFormatting;
     selectColumnVisible?: boolean;