react-semaphor 0.1.428 → 0.1.430

package/dist/types/dashboard.d.ts

@@ -203,6 +203,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;
+};
+
 declare interface CardConfig {
     /**
      * Matrix table is the shared analytics-spine successor for pivot and
@@ -387,12 +396,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;
@@ -418,8 +432,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';
@@ -565,7 +577,7 @@ export declare type ControlBinding = {
     controlId: string;
     target: 'config_grain';
     mapping: Record<string, string>;
-};
+} | CurrencyPresentationBinding;
 
 export declare type ControlDashboardInput = DashboardInputBase & {
     kind: 'control';
@@ -620,6 +632,23 @@ export declare type ControlSource = {
 
 export declare type ControlType = 'enum' | 'multi_enum' | 'text' | 'number' | 'boolean' | 'date' | 'field_selector' | 'metric_selector' | 'aggregation_selector' | 'grain_selector';
 
+export declare type CurrencyPresentationBinding = {
+    controlId: string;
+    target: 'presentation_currency';
+    presentationTarget: CurrencyPresentationTarget;
+};
+
+export declare type CurrencyPresentationTarget = {
+    kind: 'metric';
+    metricId: string;
+} | {
+    kind: 'column';
+    columnKey: string;
+} | {
+    kind: 'matrix_measure';
+    measureId: string;
+};
+
 export declare type CustomCard = CardWithContent | CardWithFooter;
 
 export declare function Dashboard(props: DashboardProps): JSX.Element | null;
@@ -1561,6 +1590,7 @@ declare type FormatSpec = {
 
 export declare type GetDashboardResponse = {
     dashboard: TDashboard;
+    initialReportContext: ReportRuntimeContext;
     lenses: TLens[];
     filterValues?: TFilterValue[] | null;
     inputValues?: LensInputValuesSnapshot | null;
@@ -1742,6 +1772,8 @@ export declare type LoadingProps = {
     message?: string;
 };
 
+declare type LocaleStyle = 'short' | 'medium' | 'long';
+
 declare type LogicalOperator = 'AND' | 'OR';
 
 /**
@@ -1836,6 +1868,11 @@ declare interface MetricField extends Field {
     semanticComparisonPolarity?: MetricComparisonPolarity;
 }
 
+declare type MonthAlignedFiscalCalendar = {
+    kind: 'month_aligned';
+    yearStartMonth: number;
+};
+
 declare type NoneOptions = {};
 
 export declare type NumberAxisFormat = {
@@ -1887,6 +1924,12 @@ declare type Params = {
     [key: string]: string | number | string[] | number[];
 };
 
+declare type PersistedColumnSettings = Omit<Partial<ColumnSettings>, 'numberFormat'> & {
+    numberFormat?: Partial<ColumnSettings['numberFormat']>;
+};
+
+declare type PersistedColumnSettingsMap = Record<string, PersistedColumnSettings>;
+
 declare type PersistedInteraction = Interaction & {
     id?: string;
 };
@@ -1954,6 +1997,26 @@ 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;
+};
+
 export declare type ResolvedDashboardDateComparisonInput = {
     inputId: string;
     filterId: string;
@@ -2029,6 +2092,26 @@ declare type ResolvedPrimaryDateField = {
     supportedGranularities?: TimeGranularity[];
 } | null;
 
+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;
@@ -2315,7 +2398,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;
@@ -2511,7 +2593,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;
@@ -3448,6 +3530,8 @@ export 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/data-app-builder.d.ts

@@ -949,7 +949,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/data-app-codegen-node.d.ts

@@ -22,33 +22,13 @@ export declare function buildSemaphorGeneratedViewExecutionRequest(view: unknown
 
 export declare function buildSemaphorGeneratedViewExecutionRequests(codegenSummary: unknown): SemaphorGeneratedViewExecutionRequestsResult;
 
-/**
- * Calendar context for timezone-aware date operations.
- * Controls how dates are interpreted, grouped, and displayed.
- */
 declare type CalendarContext = {
-    /**
-     * IANA timezone identifier.
-     * @example 'America/Chicago', 'Europe/London', 'Asia/Tokyo', 'UTC'
-     * @see https://en.wikipedia.org/wiki/List_of_tz_database_time_zones
-     */
     tz: string;
-    /**
-     * Day the week starts on.
-     * 0 = Sunday (US, Canada, Japan)
-     * 1 = Monday (ISO standard, most of Europe)
-     * 6 = Saturday (Middle East)
-     * @default 1 (Monday) for backward compatibility
-     */
     weekStart: WeekStart;
-    /**
-     * Date anchor for relative date calculations.
-     * - 'now': Use current time (default, live dashboards)
-     * - { iso: string }: Fixed ISO 8601 date for reproducible views
-     */
     anchor: 'now' | {
         iso: string;
     };
+    fiscalCalendar?: MonthAlignedFiscalCalendar;
 };
 
 export declare const CODEGEN_SUMMARY_SCHEMA_VERSION: "semaphor-data-app-codegen-summary/v1";
@@ -75,6 +55,11 @@ export declare function isSemaphorDataAppCodegenSummary(value: unknown): value i
 
 declare type JsonRecord = Record<string, unknown>;
 
+declare type MonthAlignedFiscalCalendar = {
+    kind: 'month_aligned';
+    yearStartMonth: number;
+};
+
 export declare const REQUIRED_GENERATED_CONTRACT_FILES: readonly ["sources.ts", "fields.ts", "inputs.ts", "queries.ts", "bindings.ts", "accessors.ts", "metadata.ts", "index.ts", "USAGE.md", "contract.manifest.json"];
 
 export declare const SEMAPHOR_DATA_APP_CODEGEN_SUMMARY_SCHEMA_VERSION: "semaphor-data-app-codegen-summary/v1";
@@ -1116,7 +1101,6 @@ declare type SemaphorTimeWindow = SemaphorRelativeTimeWindow | SemaphorAbsoluteT
 
 declare type SemaphorValueFormat = {
     type: 'number' | 'currency' | 'percent' | 'percentage' | 'scientific';
-    locale?: string;
     minimumFractionDigits?: number;
     maximumFractionDigits?: number;
     useGrouping?: boolean;
@@ -1161,12 +1145,6 @@ export declare function validateSemaphorDataAppCodegenSummary(value: unknown): {
 
 export declare function validateSemaphorGeneratedContract({ manifest, generatedFiles, }: SemaphorGeneratedContractValidationInput): Promise<SemaphorGeneratedContractValidationResult>;
 
-/**
- * Week start day type.
- * 0 = Sunday (US, Canada, Japan)
- * 1 = Monday (ISO standard, most of Europe)
- * 6 = Saturday (Middle East)
- */
 declare type WeekStart = 0 | 1 | 2 | 3 | 4 | 5 | 6;
 
 export { }

package/dist/types/data-app-codegen.d.ts

@@ -22,33 +22,13 @@ export declare function buildSemaphorGeneratedViewExecutionRequest(view: unknown
 
 export declare function buildSemaphorGeneratedViewExecutionRequests(codegenSummary: unknown): SemaphorGeneratedViewExecutionRequestsResult;
 
-/**
- * Calendar context for timezone-aware date operations.
- * Controls how dates are interpreted, grouped, and displayed.
- */
 declare type CalendarContext = {
-    /**
-     * IANA timezone identifier.
-     * @example 'America/Chicago', 'Europe/London', 'Asia/Tokyo', 'UTC'
-     * @see https://en.wikipedia.org/wiki/List_of_tz_database_time_zones
-     */
     tz: string;
-    /**
-     * Day the week starts on.
-     * 0 = Sunday (US, Canada, Japan)
-     * 1 = Monday (ISO standard, most of Europe)
-     * 6 = Saturday (Middle East)
-     * @default 1 (Monday) for backward compatibility
-     */
     weekStart: WeekStart;
-    /**
-     * Date anchor for relative date calculations.
-     * - 'now': Use current time (default, live dashboards)
-     * - { iso: string }: Fixed ISO 8601 date for reproducible views
-     */
     anchor: 'now' | {
         iso: string;
     };
+    fiscalCalendar?: MonthAlignedFiscalCalendar;
 };
 
 export declare const CODEGEN_SUMMARY_SCHEMA_VERSION: "semaphor-data-app-codegen-summary/v1";
@@ -71,6 +51,11 @@ export declare function isSemaphorDataAppCodegenSummary(value: unknown): value i
 
 declare type JsonRecord = Record<string, unknown>;
 
+declare type MonthAlignedFiscalCalendar = {
+    kind: 'month_aligned';
+    yearStartMonth: number;
+};
+
 export declare const REQUIRED_GENERATED_CONTRACT_FILES: readonly ["sources.ts", "fields.ts", "inputs.ts", "queries.ts", "bindings.ts", "accessors.ts", "metadata.ts", "index.ts", "USAGE.md", "contract.manifest.json"];
 
 export declare const SEMAPHOR_DATA_APP_CODEGEN_SUMMARY_SCHEMA_VERSION: "semaphor-data-app-codegen-summary/v1";
@@ -1088,7 +1073,6 @@ declare type SemaphorTimeWindow = SemaphorRelativeTimeWindow | SemaphorAbsoluteT
 
 declare type SemaphorValueFormat = {
     type: 'number' | 'currency' | 'percent' | 'percentage' | 'scientific';
-    locale?: string;
     minimumFractionDigits?: number;
     maximumFractionDigits?: number;
     useGrouping?: boolean;
@@ -1133,12 +1117,6 @@ export declare function validateSemaphorDataAppCodegenSummary(value: unknown): {
 
 export declare function validateSemaphorGeneratedContract({ manifest, generatedFiles, }: SemaphorGeneratedContractValidationInput): Promise<SemaphorGeneratedContractValidationResult>;
 
-/**
- * Week start day type.
- * 0 = Sunday (US, Canada, Japan)
- * 1 = Monday (ISO standard, most of Europe)
- * 6 = Saturday (Middle East)
- */
 declare type WeekStart = 0 | 1 | 2 | 3 | 4 | 5 | 6;
 
 export { }

package/dist/types/data-app-sdk-adapters.d.ts

@@ -1,34 +1,19 @@
-/**
- * Calendar context for timezone-aware date operations.
- * Controls how dates are interpreted, grouped, and displayed.
- */
 declare type CalendarContext = {
-    /**
-     * IANA timezone identifier.
-     * @example 'America/Chicago', 'Europe/London', 'Asia/Tokyo', 'UTC'
-     * @see https://en.wikipedia.org/wiki/List_of_tz_database_time_zones
-     */
     tz: string;
-    /**
-     * Day the week starts on.
-     * 0 = Sunday (US, Canada, Japan)
-     * 1 = Monday (ISO standard, most of Europe)
-     * 6 = Saturday (Middle East)
-     * @default 1 (Monday) for backward compatibility
-     */
     weekStart: WeekStart;
-    /**
-     * Date anchor for relative date calculations.
-     * - 'now': Use current time (default, live dashboards)
-     * - { iso: string }: Fixed ISO 8601 date for reproducible views
-     */
     anchor: 'now' | {
         iso: string;
     };
+    fiscalCalendar?: MonthAlignedFiscalCalendar;
 };
 
 export declare function hasSemaphorInputValue(value: unknown): boolean;
 
+declare type MonthAlignedFiscalCalendar = {
+    kind: 'month_aligned';
+    yearStartMonth: number;
+};
+
 export declare function normalizeSemaphorInputOptions(options?: Array<{
     label: string;
     value: SemaphorOptionValue;
@@ -656,7 +641,6 @@ declare type SemaphorTimeWindow = SemaphorRelativeTimeWindow | SemaphorAbsoluteT
 
 declare type SemaphorValueFormat = {
     type: 'number' | 'currency' | 'percent' | 'percentage' | 'scientific';
-    locale?: string;
     minimumFractionDigits?: number;
     maximumFractionDigits?: number;
     useGrouping?: boolean;
@@ -724,12 +708,6 @@ export declare function toSemaphorRecordsIntent(spec: SemaphorRecordsQuerySpec):
 
 export declare function toSemaphorSqlIntent(spec: SemaphorSqlQuerySpec): SemaphorSqlIntent;
 
-/**
- * Week start day type.
- * 0 = Sunday (US, Canada, Japan)
- * 1 = Monday (ISO standard, most of Europe)
- * 6 = Saturday (Middle East)
- */
 declare type WeekStart = 0 | 1 | 2 | 3 | 4 | 5 | 6;
 
 export { }

package/dist/types/data-app-sdk-validation.d.ts

@@ -1,30 +1,10 @@
-/**
- * Calendar context for timezone-aware date operations.
- * Controls how dates are interpreted, grouped, and displayed.
- */
 declare type CalendarContext = {
-    /**
-     * IANA timezone identifier.
-     * @example 'America/Chicago', 'Europe/London', 'Asia/Tokyo', 'UTC'
-     * @see https://en.wikipedia.org/wiki/List_of_tz_database_time_zones
-     */
     tz: string;
-    /**
-     * Day the week starts on.
-     * 0 = Sunday (US, Canada, Japan)
-     * 1 = Monday (ISO standard, most of Europe)
-     * 6 = Saturday (Middle East)
-     * @default 1 (Monday) for backward compatibility
-     */
     weekStart: WeekStart;
-    /**
-     * Date anchor for relative date calculations.
-     * - 'now': Use current time (default, live dashboards)
-     * - { iso: string }: Fixed ISO 8601 date for reproducible views
-     */
     anchor: 'now' | {
         iso: string;
     };
+    fiscalCalendar?: MonthAlignedFiscalCalendar;
 };
 
 export declare function fieldWithSelectedProjectionRole(field: SemaphorFieldRef, selectedField?: SemaphorFieldRef): SemaphorFieldRef;
@@ -238,7 +218,6 @@ declare type MatrixResultCell = {
     columnId?: string;
     measureId: string;
     value: unknown;
-    formattedValue?: string;
     presence: MatrixCellPresence;
     role: MatrixCellRole;
     calculationId?: string;
@@ -255,6 +234,11 @@ declare type MatrixTotals = {
     };
 };
 
+declare type MonthAlignedFiscalCalendar = {
+    kind: 'month_aligned';
+    yearStartMonth: number;
+};
+
 export declare function normalizeSemaphorAnalysisQueryOptions(value: unknown, options?: {
     pathPrefix?: string;
     validateTimezone?: SemaphorAnalysisTimezoneValidator;
@@ -1245,7 +1229,6 @@ declare type SemaphorTimeWindow = SemaphorRelativeTimeWindow | SemaphorAbsoluteT
 
 declare type SemaphorValueFormat = {
     type: 'number' | 'currency' | 'percent' | 'percentage' | 'scientific';
-    locale?: string;
     minimumFractionDigits?: number;
     maximumFractionDigits?: number;
     useGrouping?: boolean;
@@ -1288,12 +1271,6 @@ export declare function validateSemaphorDataAppQuerySpecs(input: {
     validateTimezone?: SemaphorAnalysisTimezoneValidator;
 }): SemaphorDataAppValidationResult;
 
-/**
- * Week start day type.
- * 0 = Sunday (US, Canada, Japan)
- * 1 = Monday (ISO standard, most of Europe)
- * 6 = Saturday (Middle East)
- */
 declare type WeekStart = 0 | 1 | 2 | 3 | 4 | 5 | 6;
 
 export { }

package/dist/types/data-app-sdk.d.ts

@@ -3,33 +3,13 @@ import { JSX } from 'react';
 import { ReactElement } from 'react';
 import { ReactNode } from 'react';
 
-/**
- * Calendar context for timezone-aware date operations.
- * Controls how dates are interpreted, grouped, and displayed.
- */
 declare type CalendarContext = {
-    /**
-     * IANA timezone identifier.
-     * @example 'America/Chicago', 'Europe/London', 'Asia/Tokyo', 'UTC'
-     * @see https://en.wikipedia.org/wiki/List_of_tz_database_time_zones
-     */
     tz: string;
-    /**
-     * Day the week starts on.
-     * 0 = Sunday (US, Canada, Japan)
-     * 1 = Monday (ISO standard, most of Europe)
-     * 6 = Saturday (Middle East)
-     * @default 1 (Monday) for backward compatibility
-     */
     weekStart: WeekStart;
-    /**
-     * Date anchor for relative date calculations.
-     * - 'now': Use current time (default, live dashboards)
-     * - { iso: string }: Fixed ISO 8601 date for reproducible views
-     */
     anchor: 'now' | {
         iso: string;
     };
+    fiscalCalendar?: MonthAlignedFiscalCalendar;
 };
 
 export declare function createSemaphorQueryExecutor(): SemaphorQueryExecutor;
@@ -84,7 +64,6 @@ declare type MatrixCell = {
     measureInstanceId: string;
     rawValue: unknown;
     presence: MatrixCellPresence;
-    formattedValue?: string;
     role: MatrixCellRole;
     aggregateFunction?: SemaphorAggregateFunction;
     formattingScope: MatrixCellFormattingScope;
@@ -160,7 +139,6 @@ declare type MatrixGridCell = {
     columnId: string;
     cellId?: string;
     rawValue: unknown;
-    formattedValue?: string;
     presence: MatrixCellPresence;
     role: MatrixCellRole;
     measureInstanceId: string;
@@ -335,7 +313,6 @@ declare type MatrixResultCell = {
     columnId?: string;
     measureId: string;
     value: unknown;
-    formattedValue?: string;
     presence: MatrixCellPresence;
     role: MatrixCellRole;
     calculationId?: string;
@@ -359,6 +336,11 @@ declare type MatrixWarning = {
     severity?: 'info' | 'warning' | 'error';
 };
 
+declare type MonthAlignedFiscalCalendar = {
+    kind: 'month_aligned';
+    yearStartMonth: number;
+};
+
 export declare const semaphor: {
     source: {
         semantic(spec: SemaphorSemanticSourceBuilderSpec): SemaphorSemanticSourceRef;
@@ -1735,7 +1717,6 @@ export declare type SemaphorTimeWindow = SemaphorRelativeTimeWindow | SemaphorAb
 
 declare type SemaphorValueFormat = {
     type: 'number' | 'currency' | 'percent' | 'percentage' | 'scientific';
-    locale?: string;
     minimumFractionDigits?: number;
     maximumFractionDigits?: number;
     useGrouping?: boolean;
@@ -1797,12 +1778,6 @@ export declare function useSemaphorQuery<TRecord extends Record<string, unknown>
 
 export declare function useSemaphorQuery(spec: SemaphorMatrixQueryDefinition, options?: SemaphorQueryRuntimeOptions): SemaphorMatrixQueryResult;
 
-/**
- * Week start day type.
- * 0 = Sunday (US, Canada, Japan)
- * 1 = Monday (ISO standard, most of Europe)
- * 6 = Saturday (Middle East)
- */
 declare type WeekStart = 0 | 1 | 2 | 3 | 4 | 5 | 6;
 
 export { }