react-semaphor 0.1.427 → 0.1.429

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

@@ -26,6 +26,15 @@ export declare function arrayToCSV(rows: (string | number | null | undefined)[][
  */
 export declare function arrayToCSVRow(values: (string | number | null | undefined)[], delimiter?: string): string;
 
+declare type CalendarContext = {
+    tz: string;
+    weekStart: WeekStart;
+    anchor: 'now' | {
+        iso: string;
+    };
+    fiscalCalendar?: MonthAlignedFiscalCalendar;
+};
+
 export declare type CanonicalDurationUnit = 'millisecond' | 'second' | 'minute' | 'hour' | 'day';
 
 export declare type CanonicalFormatSpec = NumericCanonicalFormat | DateCanonicalFormat | DurationCanonicalFormat | StringCanonicalFormat;
@@ -51,10 +60,10 @@ export declare interface ColumnSettings {
     width?: number;
     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';
         showDataBar?: boolean;
@@ -265,8 +274,15 @@ export declare function formatNumberWithColumnSettings(value: number | null | un
     maximumFractionDigits?: number;
     useGrouping?: boolean;
     percentValueMode?: 'fraction' | 'whole';
+    scale?: number;
+    compact?: boolean;
+    negativeStyle?: 'minus' | 'parentheses';
+    prefix?: string;
+    suffix?: string;
 } | undefined, defaultLocale?: string): string;
 
+export declare function formatNumericCanonical(value: number | null | undefined, format: NumericCanonicalFormat): string;
+
 export declare interface FormatOptions {
     decimalPlaces?: number;
     useSuffix?: boolean;
@@ -367,6 +383,8 @@ export declare interface GroupByField {
     label?: string;
 }
 
+declare type LocaleStyle = 'short' | 'medium' | 'long';
+
 declare type MetricComparisonDirection = 'increase' | 'decrease' | 'no_change' | 'unknown';
 
 export declare type MetricComparisonDisplayMode = 'difference' | 'percent_change' | 'both' | 'ratio';
@@ -384,6 +402,11 @@ declare type MetricComparisonEvaluation = {
 
 declare type MetricComparisonSentiment = 'favorable' | 'unfavorable' | 'neutral';
 
+declare type MonthAlignedFiscalCalendar = {
+    kind: 'month_aligned';
+    yearStartMonth: number;
+};
+
 export declare interface NumberFormatOptions {
     style: 'decimal' | 'currency' | 'percent' | 'scientific';
     locale?: string;
@@ -428,6 +451,43 @@ export declare type NumericCanonicalFormat = {
     percentValueMode?: 'fraction' | 'whole';
 };
 
+export declare type NumericCanonicalFormatParseResult = {
+    ok: true;
+    value: NumericCanonicalFormat;
+} | {
+    ok: false;
+    issues: Array<{
+        path: string;
+        message: string;
+    }>;
+};
+
+export declare type NumericPresentationExecutionSnapshot = {
+    reportContext: ReportRuntimeContext;
+    resolvedNumericFormats: NumericPresentationSnapshotEntry[];
+};
+
+export declare type NumericPresentationSnapshotEntry = {
+    scope: {
+        dashboardId: string;
+        cardId?: string;
+        attachmentIndex?: number;
+    };
+    target: NumericPresentationTarget;
+    format: NumericCanonicalFormat;
+};
+
+export declare type NumericPresentationTarget = {
+    kind: 'metric';
+    metricId: string;
+} | {
+    kind: 'column';
+    columnKey: string;
+} | {
+    kind: 'matrix_measure';
+    measureId: string;
+};
+
 /**
  * Convert an array of objects to CSV string
  */
@@ -435,6 +495,14 @@ export declare function objectsToCSV(data: Record<string, unknown>[], options?:
     columns?: string[];
 }): string;
 
+export declare function parseNumericCanonicalFormat(input: unknown): NumericCanonicalFormatParseResult;
+
+export declare function parseNumericPresentationExecutionSnapshot(input: unknown): NumericPresentationExecutionSnapshot;
+
+export declare function parseNumericPresentationSnapshotEntries(input: unknown): NumericPresentationSnapshotEntry[];
+
+export declare function parseResolvedNumericCanonicalFormat(input: unknown): NumericCanonicalFormatParseResult;
+
 /**
  * Parse a date string with source timezone interpretation
  *
@@ -483,6 +551,50 @@ export declare interface PivotRowData {
     isGrandTotal?: boolean;
 }
 
+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;
+};
+
+export declare function resolveCurrencyFractionDigits(locale: string, currency: string): Pick<NumericCanonicalFormat, 'minimumFractionDigits' | 'maximumFractionDigits'>;
+
+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;
+};
+
+export declare function resolveNumericPresentation(authored: NumericCanonicalFormat, preferences: ResolvedValueFormatPreferences, boundCurrency?: string): NumericCanonicalFormat;
+
 /**
  * Date formatting utilities with timezone support
  * IMPORTANT: No React imports allowed in this file
@@ -513,4 +625,16 @@ export declare type StringCanonicalFormat = {
     suffix?: string;
 };
 
+export declare function validateCardExportNumericPresentationSnapshot(input: {
+    entries: NumericPresentationSnapshotEntry[];
+    expectedScope: {
+        dashboardId: string;
+        cardId: string;
+    };
+    visibleColumns?: string[];
+    useFormattedValues: boolean;
+}): void;
+
+declare type WeekStart = 0 | 1 | 2 | 3 | 4 | 5 | 6;
+
 export { }

package/dist/types/index.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("../chunks/common-types-C73-Ud1-.js"),a={mode:"all"},E={tz:"UTC",weekStart:1,anchor:"now"};exports.CALCULATED_FIELD_ENTITY_MARKER=e.CALCULATED_FIELD_ENTITY_MARKER;exports.CONTROL_CARD_DEFAULT_VALUE=e.CONTROL_CARD_DEFAULT_VALUE;exports.DATE_FORMAT_VALUES=e.DATE_FORMAT_VALUES;exports.EMPTY_SELECTION=e.EMPTY_SELECTION;exports.PivotMarkerEnum=e.PivotMarkerEnum;exports.getFieldRuntimeColumnName=e.getFieldRuntimeColumnName;exports.hasCalculatedFieldMarker=e.hasCalculatedFieldMarker;exports.hasCalculatedFormulaInputs=e.hasCalculatedFormulaInputs;exports.isCalculatedDimension=e.isCalculatedDimension;exports.isCalculatedField=e.isCalculatedField;exports.isCalculatedMetric=e.isCalculatedMetric;exports.DEFAULT_CALENDAR_CONTEXT=E;exports.DEFAULT_SEMANTIC_DOMAIN_ACCESS=a;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("../chunks/common-types-C73-Ud1-.js");require("../value-format-preferences/index.cjs");const E=require("../report-runtime-context/index.cjs"),a={mode:"all"};exports.CALCULATED_FIELD_ENTITY_MARKER=e.CALCULATED_FIELD_ENTITY_MARKER;exports.CONTROL_CARD_DEFAULT_VALUE=e.CONTROL_CARD_DEFAULT_VALUE;exports.DATE_FORMAT_VALUES=e.DATE_FORMAT_VALUES;exports.EMPTY_SELECTION=e.EMPTY_SELECTION;exports.PivotMarkerEnum=e.PivotMarkerEnum;exports.getFieldRuntimeColumnName=e.getFieldRuntimeColumnName;exports.hasCalculatedFieldMarker=e.hasCalculatedFieldMarker;exports.hasCalculatedFormulaInputs=e.hasCalculatedFormulaInputs;exports.isCalculatedDimension=e.isCalculatedDimension;exports.isCalculatedField=e.isCalculatedField;exports.isCalculatedMetric=e.isCalculatedMetric;exports.DEFAULT_CALENDAR_CONTEXT=E.DEFAULT_CALENDAR_CONTEXT;exports.DEFAULT_SEMANTIC_DOMAIN_ACCESS=a;

package/dist/types/index.js

@@ -1,19 +1,16 @@
-import { a as C, C as l, D as t, E as A, P as T, g as _, h as i, b as o, i as r, c as D, d as L } from "../chunks/common-types-ClkOI-3O.js";
-const a = {
+import { a as l, C, D as A, E as t, P as T, g as _, h as i, b as o, i as r, c as D, d as L } from "../chunks/common-types-ClkOI-3O.js";
+import "../value-format-preferences/index.js";
+import { DEFAULT_CALENDAR_CONTEXT as m } from "../report-runtime-context/index.js";
+const e = {
   mode: "all"
-}, e = {
-  tz: "UTC",
-  weekStart: 1,
-  // Monday (ISO standard)
-  anchor: "now"
 };
 export {
-  C as CALCULATED_FIELD_ENTITY_MARKER,
-  l as CONTROL_CARD_DEFAULT_VALUE,
-  t as DATE_FORMAT_VALUES,
-  e as DEFAULT_CALENDAR_CONTEXT,
-  a as DEFAULT_SEMANTIC_DOMAIN_ACCESS,
-  A as EMPTY_SELECTION,
+  l as CALCULATED_FIELD_ENTITY_MARKER,
+  C as CONTROL_CARD_DEFAULT_VALUE,
+  A as DATE_FORMAT_VALUES,
+  m as DEFAULT_CALENDAR_CONTEXT,
+  e as DEFAULT_SEMANTIC_DOMAIN_ACCESS,
+  t as EMPTY_SELECTION,
   T as PivotMarkerEnum,
   _ as getFieldRuntimeColumnName,
   i as hasCalculatedFieldMarker,