react-semaphor 0.1.428 → 0.1.430

package/dist/types/types.d.ts

@@ -164,6 +164,45 @@ declare const BRIEFING_ARTIFACT_FORMATS: readonly ["markdown", "html"];
 
 declare const BRIEFING_KIND: "BRIEFING";
 
+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 = 'markdown' | 'html';
 
 declare type BriefingArtifactFormat_2 = (typeof BRIEFING_ARTIFACT_FORMATS)[number];
@@ -288,8 +327,18 @@ export declare type BriefingFormatProfile = 'concise' | 'balanced' | 'detailed';
 
 declare type BriefingFormatProfile_2 = '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[];
@@ -301,6 +350,7 @@ export declare type BriefingKind = typeof BRIEFING_KIND;
 
 export declare type BriefingLimits = {
     maxToolCalls?: number;
+    maxPlanningIterations?: number;
     maxRows?: number;
     timeoutMs?: number;
 };
@@ -350,6 +400,10 @@ export declare type BriefingPresentation = {
     audience?: string;
     tone?: string;
     format?: string;
+    appearance?: BriefingAppearanceSpec;
+    brandOverrides?: BriefingThemeOverrides;
+    fragments?: BriefingFragments;
+    viewUrl?: string;
 };
 
 export declare type BriefingPreviewPlan = {
@@ -529,6 +583,12 @@ export declare type BriefingTenantSummary = {
     latestRunStatus: BriefingRunStatus | string | null;
 };
 
+declare type BriefingThemeOverrides = {
+    brandName?: string;
+    logoUrl?: string;
+    link?: string;
+};
+
 declare type BriefingWebhookConfig = {
     url: string;
     method?: 'POST' | 'PUT';
@@ -613,33 +673,13 @@ export declare interface CalculatedFieldFormula {
  */
 export declare type CalculatedFieldOperation = 'sum' | 'difference' | 'product' | 'ratio' | 'change' | 'percentage' | 'scale' | 'custom';
 
-/**
- * Calendar context for timezone-aware date operations.
- * Controls how dates are interpreted, grouped, and displayed.
- */
 export 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 type CancelBriefingPreviewRunResponse = {
@@ -841,12 +881,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;
@@ -872,8 +917,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';
@@ -1021,7 +1064,7 @@ export declare type ControlBinding = {
     controlId: string;
     target: 'config_grain';
     mapping: Record<string, string>;
-};
+} | CurrencyPresentationBinding;
 
 export declare type ControlDashboardInput = DashboardInputBase & {
     kind: 'control';
@@ -1090,6 +1133,23 @@ export declare type CreateBriefingRequest = {
     deliveryConfig: BriefingDeliveryConfig | null;
 };
 
+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;
 
 declare type DashboardAIContext = AIContext & {
@@ -1400,10 +1460,6 @@ export declare type DateSelectionMode = 'range' | 'months';
 
 export declare type DateUnit = 'day' | 'week' | 'month' | 'quarter' | 'year';
 
-/**
- * Default CalendarContext when not provided.
- * Used as fallback for backward compatibility.
- */
 export declare const DEFAULT_CALENDAR_CONTEXT: CalendarContext;
 
 export declare const DEFAULT_SEMANTIC_DOMAIN_ACCESS: SemanticDomainAccess;
@@ -2120,6 +2176,7 @@ export declare type FormatSpec = {
 
 export declare type GetDashboardResponse = {
     dashboard: TDashboard;
+    initialReportContext: ReportRuntimeContext;
     lenses: TLens[];
     filterValues?: TFilterValue[] | null;
     inputValues?: LensInputValuesSnapshot | null;
@@ -2348,6 +2405,8 @@ export declare type LoadingProps = {
     message?: string;
 };
 
+declare type LocaleStyle = 'short' | 'medium' | 'long';
+
 export declare type LogicalOperator = 'AND' | 'OR';
 
 /**
@@ -2561,7 +2620,6 @@ declare type MatrixResultCell = {
     columnId?: string;
     measureId: string;
     value: unknown;
-    formattedValue?: string;
     presence: MatrixCellPresence;
     role: MatrixCellRole;
     calculationId?: string;
@@ -2662,6 +2720,11 @@ export declare interface MetricField extends Field {
     semanticComparisonPolarity?: MetricComparisonPolarity;
 }
 
+declare type MonthAlignedFiscalCalendar = {
+    kind: 'month_aligned';
+    yearStartMonth: number;
+};
+
 declare type NoneOptions = {};
 
 export declare type NumberAxisFormat = {
@@ -2749,6 +2812,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;
 };
@@ -2897,6 +2966,26 @@ export declare type RelativeDateFilter = {
 
 export declare type RelativeDateUnit = DateUnit | SubDayDateUnit;
 
+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;
@@ -2972,20 +3061,24 @@ declare type ResolvedPrimaryDateField = {
     supportedGranularities?: TimeGranularity[];
 } | null;
 
-/**
- * Parameters in JWT payload (after backend resolution).
- * The backend ALWAYS includes calendarContext, even if customer didn't provide it.
- */
-export declare type ResolvedTokenParams = Omit<TokenParams, 'calendarContext'> & {
-    /**
-     * Full calendar context for timezone-aware operations.
-     * ALWAYS present in JWT - resolved by backend from:
-     * 1. Token request calendarContext (highest priority)
-     * 2. Token request timezone (legacy)
-     * 3. User/Tenant/Org preferences (Phase 7)
-     * 4. Default: { tz: 'UTC', weekStart: 1, anchor: 'now' }
-     */
-    calendarContext: CalendarContext;
+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 type RunBriefingNowRequest = {
@@ -3362,7 +3455,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;
@@ -3574,7 +3666,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;
@@ -4404,19 +4496,6 @@ export declare type TLineStyle = 'solid' | 'dashed' | 'dotted' | 'dash-dot';
  * This is used for token REQUEST (customer provides these).
  */
 export declare type TokenParams = {
-    /**
-     * Currency formatting options.
-     */
-    currencyFormat?: {
-        /**
-         * Locale identifier (e.g., 'en-US', 'fr-FR').
-         */
-        locale: string;
-        /**
-         * Currency code compliant with ISO 4217 (e.g., 'USD', 'EUR').
-         */
-        currency: string;
-    };
     /**
      * IANA timezone identifier for date operations.
      * @deprecated Use calendarContext.tz instead for full calendar control.
@@ -4424,11 +4503,11 @@ export declare type TokenParams = {
      */
     timezone?: string;
     /**
-     * Full calendar context for timezone-aware operations.
-     * Optional in token request - the backend ALWAYS resolves and includes
-     * this in the JWT, even when the customer doesn't provide it.
+     * Optional developer-authored Calendar seed for the report session.
+     * The resolved viewer state is delivered by dashboard bootstrap instead.
      */
     calendarContext?: CalendarContext;
+    valueFormatPreferences?: ValueFormatPreferences;
 };
 
 /**
@@ -4496,9 +4575,9 @@ export declare type TokenProps = {
     rcls?: TokenSecurityPolicy[] | TokenSecurityPolicy;
     /**
      * Parameter overrides and preferences (e.g., formatting).
-     * Uses ResolvedTokenParams because backend ALWAYS includes calendarContext.
+     * These are developer-authored initial inputs, not resolved viewer state.
      */
-    params?: ResolvedTokenParams;
+    params?: TokenParams;
     /**
      * UI behavior and feature flags.
      */
@@ -4791,6 +4870,16 @@ export declare interface UserPreference {
     updatedAt: string;
 }
 
+declare type ValueFormatPreferences = {
+    locale?: string;
+    dateStyle?: LocaleStyle;
+    dateTime?: {
+        dateStyle?: LocaleStyle;
+        timeStyle?: LocaleStyle;
+    };
+    defaultCurrency?: string;
+};
+
 declare type ViewerPeriodComparisonSpec = Extract<MetricComparisonSpec, {
     kind: 'previous_period' | 'previous_year';
 }>;
@@ -4831,12 +4920,6 @@ export declare type VisualDisplayPreferences = {
     };
 };
 
-/**
- * Week start day type.
- * 0 = Sunday (US, Canada, Japan)
- * 1 = Monday (ISO standard, most of Europe)
- * 6 = Saturday (Middle East)
- */
 export declare type WeekStart = 0 | 1 | 2 | 3 | 4 | 5 | 6;
 
 export declare type WindowFunction = 'running_total' | 'moving_average' | 'previous_period_delta' | 'percent_of_total';

package/dist/types/value-format-preferences.d.ts

@@ -0,0 +1,126 @@
+export declare function applyValueFormatPreferenceMutation(stored: unknown, request: unknown): MutationResult;
+
+export declare function canonicalizeSupportedCurrencyCode(input: unknown): string | undefined;
+
+export declare function canonicalizeSupportedLocale(input: unknown): string | undefined;
+
+export declare function decodeStoredValueFormatPreferences(input: unknown, scope: StoredScope): {
+    value: ValueFormatPreferences | null;
+    diagnostics: StoredValueFormatPreferenceDiagnostic[];
+};
+
+export declare const DEFAULT_RESOLVED_VALUE_FORMAT_PREFERENCES: ResolvedValueFormatPreferences;
+
+export declare function getSupportedCurrencyCodes(): readonly string[];
+
+export declare function isReportPreferenceSource(value: unknown): value is ReportPreferenceSource;
+
+export declare type LocaleStyle = 'short' | 'medium' | 'long';
+
+declare type MutationResult = {
+    ok: true;
+    value: ValueFormatPreferences | null;
+} | {
+    ok: false;
+    issues: ValueFormatPreferenceValidationIssue[];
+};
+
+declare type ParseResult = {
+    ok: true;
+    value: ValueFormatPreferences;
+} | {
+    ok: false;
+    issues: ValueFormatPreferenceValidationIssue[];
+};
+
+export declare function parseValueFormatPreferences(input: unknown): ParseResult;
+
+export declare function parseValueFormatPreferencesResponse(input: unknown): ValueFormatPreferencesResponseParseResult;
+
+export declare const REPORT_PREFERENCE_SOURCES: readonly ["viewer_user", "viewer_tenant_user", "session_initial", "viewer_tenant", "viewer_organization", "system_default"];
+
+export declare type ReportPreferenceSource = (typeof REPORT_PREFERENCE_SOURCES)[number];
+
+export declare type ResolvedValueFormatPreferences = {
+    locale: string;
+    dateStyle: LocaleStyle;
+    dateTime: {
+        dateStyle: LocaleStyle;
+        timeStyle: LocaleStyle;
+    };
+    defaultCurrency: string;
+};
+
+export declare type ResolvedValueFormatPreferenceSources = {
+    locale: ReportPreferenceSource;
+    dateStyle: ReportPreferenceSource;
+    dateTime: {
+        dateStyle: ReportPreferenceSource;
+        timeStyle: ReportPreferenceSource;
+    };
+    defaultCurrency: ReportPreferenceSource;
+};
+
+export declare function resolveValueFormatPreferences(layers: {
+    user?: unknown;
+    tenantUser?: unknown;
+    sessionInitial?: ValueFormatPreferences | null;
+    tenant?: unknown;
+    organization?: unknown;
+}): {
+    preferences: ResolvedValueFormatPreferences;
+    sources: ResolvedValueFormatPreferenceSources;
+    diagnostics: StoredValueFormatPreferenceDiagnostic[];
+};
+
+declare type StoredScope = StoredValueFormatPreferenceDiagnostic['scope'];
+
+export declare type StoredValueFormatPreferenceDiagnostic = {
+    scope: 'viewer_user' | 'viewer_tenant_user' | 'viewer_tenant' | 'viewer_organization';
+    path: ValueFormatPreferencePath | '$';
+    code: 'invalid_stored_preference';
+};
+
+export declare type UpdateValueFormatPreferencesRequest = {
+    set?: ValueFormatPreferences;
+    clear?: ValueFormatPreferencePath[];
+};
+
+export declare type ValueFormatPreferencePath = 'locale' | 'dateStyle' | 'dateTime.dateStyle' | 'dateTime.timeStyle' | 'defaultCurrency';
+
+export declare type ValueFormatPreferences = {
+    locale?: string;
+    dateStyle?: LocaleStyle;
+    dateTime?: {
+        dateStyle?: LocaleStyle;
+        timeStyle?: LocaleStyle;
+    };
+    defaultCurrency?: string;
+};
+
+export declare type ValueFormatPreferencesResponse = {
+    stored: ValueFormatPreferences | null;
+    inherited: ResolvedValueFormatPreferences;
+    inheritedSources: ResolvedValueFormatPreferenceSources;
+    resolved: ResolvedValueFormatPreferences;
+    sources: ResolvedValueFormatPreferenceSources;
+    diagnostics: StoredValueFormatPreferenceDiagnostic[];
+};
+
+export declare type ValueFormatPreferencesResponseParseResult = {
+    ok: true;
+    value: ValueFormatPreferencesResponse;
+} | {
+    ok: false;
+    issues: ValueFormatPreferenceValidationIssue[];
+};
+
+export declare type ValueFormatPreferenceValidationIssue = {
+    path: string;
+    code: ValueFormatPreferenceValidationIssueCode;
+    message: string;
+};
+
+export declare type ValueFormatPreferenceValidationIssueCode = 'invalid_type' | 'unknown_property' | 'invalid_locale' | 'unsupported_locale' | 'invalid_currency' | 'invalid_style' | 'empty_mutation' | 'duplicate_clear_path' | 'conflicting_operation';
+
+export { }

package/dist/value-format-preferences/index.cjs

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const S={locale:"en-US",dateStyle:"short",dateTime:{dateStyle:"short",timeStyle:"short"},defaultCurrency:"USD"},F=["viewer_user","viewer_tenant_user","session_initial","viewer_tenant","viewer_organization","system_default"],j=new Set(F);function v(e){return typeof e=="string"&&j.has(e)}const L=["locale","dateStyle","dateTime","defaultCurrency"],E=["dateStyle","timeStyle"],D=["stored","inherited","inheritedSources","resolved","sources","diagnostics"],z=["locale","dateStyle","dateTime","defaultCurrency"],N=["scope","path","code"],g=["locale","dateStyle","dateTime.dateStyle","dateTime.timeStyle","defaultCurrency"],M=["short","medium","long"];let _,C;function f(e){if(e===null||typeof e!="object"||Array.isArray(e))return!1;const t=Object.getPrototypeOf(e);return t===null||Object.getPrototypeOf(t)===null}function d(e,t){return Object.prototype.hasOwnProperty.call(e,t)}function i(e,t,r){return{path:e,code:t,message:r}}function O(e,t){if(typeof e!="string")return{ok:!1,issue:i(t,"invalid_type",`${t} must be a string`)};const r=e.trim();let s;try{s=Intl.getCanonicalLocales(r)[0]??""}catch{return{ok:!1,issue:i(t,"invalid_locale",`${t} must be a valid BCP 47 locale`)}}if(!s||new Intl.Locale(s).baseName!==s)return{ok:!1,issue:i(t,"invalid_locale",`${t} must be a base BCP 47 locale without extensions`)};const a=Intl.DateTimeFormat.supportedLocalesOf([s]).length===1,n=Intl.NumberFormat.supportedLocalesOf([s]).length===1;return!a||!n?{ok:!1,issue:i(t,"unsupported_locale",`${t} is not supported by this runtime`)}:{ok:!0,value:s}}function Y(e){const t=O(e,"locale");return t.ok?t.value:void 0}function V(){if(_)return _;const e=Intl.supportedValuesOf;if(typeof e!="function")throw new Error('This runtime does not support Intl.supportedValuesOf("currency")');return _=new Set(e.call(Intl,"currency")),_}function K(){return C||(C=Object.freeze([...V()].sort((e,t)=>e.localeCompare(t)))),C}function A(e){if(typeof e!="string")return;const t=e.trim().toUpperCase();return V().has(t)?t:void 0}function I(e,t){if(typeof e!="string")return{ok:!1,issue:i(t,"invalid_type",`${t} must be a string`)};const r=A(e);return r?{ok:!0,value:r}:{ok:!1,issue:i(t,"invalid_currency",`${t} must be a supported ISO 4217 currency code`)}}function T(e,t){return typeof e!="string"?{ok:!1,issue:i(t,"invalid_type",`${t} must be a string`)}:M.includes(e)?{ok:!0,value:e}:{ok:!1,issue:i(t,"invalid_style",`${t} must be short, medium, or long`)}}function m(e,t,r=""){const s=new Set(t);return Object.keys(e).filter(a=>!s.has(a)).sort().map(a=>{const n=r?`${r}.${a}`:a;return i(n,"unknown_property",`${n} is not a recognized preference property`)})}function h(e){if(!f(e))return{ok:!1,issues:[i("$","invalid_type","Value format preferences must be a plain object")]};const t=m(e,L),r={};if(d(e,"locale")){const s=O(e.locale,"locale");s.ok?r.locale=s.value:t.push(s.issue)}if(d(e,"dateStyle")){const s=T(e.dateStyle,"dateStyle");s.ok?r.dateStyle=s.value:t.push(s.issue)}if(d(e,"dateTime"))if(!f(e.dateTime))t.push(i("dateTime","invalid_type","dateTime must be a plain object"));else{t.push(...m(e.dateTime,E,"dateTime"));const s={};if(d(e.dateTime,"dateStyle")){const a=T(e.dateTime.dateStyle,"dateTime.dateStyle");a.ok?s.dateStyle=a.value:t.push(a.issue)}if(d(e.dateTime,"timeStyle")){const a=T(e.dateTime.timeStyle,"dateTime.timeStyle");a.ok?s.timeStyle=a.value:t.push(a.issue)}Object.keys(s).length>0&&(r.dateTime=s)}if(d(e,"defaultCurrency")){const s=I(e.defaultCurrency,"defaultCurrency");s.ok?r.defaultCurrency=s.value:t.push(s.issue)}return t.length>0?{ok:!1,issues:t}:{ok:!0,value:r}}function b(e,t){var a;const r=h(e);if(!r.ok)return{ok:!1,issues:r.issues.map(n=>({...n,path:n.path==="$"?t:`${t}.${n.path}`}))};const s=r.value;return!s.locale||!s.dateStyle||!((a=s.dateTime)!=null&&a.dateStyle)||!s.dateTime.timeStyle||!s.defaultCurrency?{ok:!1,issues:[i(t,"invalid_type",`${t} must contain every resolved preference`)]}:{ok:!0,value:{locale:s.locale,dateStyle:s.dateStyle,dateTime:s.dateTime,defaultCurrency:s.defaultCurrency}}}function w(e,t){if(!f(e))return{ok:!1,issues:[i(t,"invalid_type",`${t} must contain a valid source for every preference`)]};const r=m(e,z,t);f(e.dateTime)?r.push(...m(e.dateTime,E,`${t}.dateTime`)):r.push(i(`${t}.dateTime`,"invalid_type",`${t}.dateTime must contain valid date and time sources`));const s=f(e.dateTime)?e.dateTime:void 0,a=v(e.locale)?e.locale:void 0,n=v(e.dateStyle)?e.dateStyle:void 0,o=v(s==null?void 0:s.dateStyle)?s.dateStyle:void 0,l=v(s==null?void 0:s.timeStyle)?s.timeStyle:void 0,u=v(e.defaultCurrency)?e.defaultCurrency:void 0;return(!a||!n||!o||!l||!u)&&r.push(i(t,"invalid_type",`${t} must contain a valid source for every preference`)),r.length>0||!s||!a||!n||!o||!l||!u?{ok:!1,issues:r}:{ok:!0,value:{locale:a,dateStyle:n,dateTime:{dateStyle:o,timeStyle:l},defaultCurrency:u}}}const B=new Set(["viewer_user","viewer_tenant_user","viewer_tenant","viewer_organization"]),G=new Set(g);function H(e){if(!Array.isArray(e))return{ok:!1,issues:[i("diagnostics","invalid_type","diagnostics must be an array")]};const t=[],r=[];return e.forEach((s,a)=>{const n=f(s)?m(s,N,`diagnostics.${a}`):[];if(r.push(...n),!f(s)||n.length>0||typeof s.scope!="string"||!B.has(s.scope)||s.path!=="$"&&!G.has(s.path)||s.code!=="invalid_stored_preference"){r.push(i(`diagnostics.${a}`,"invalid_type","diagnostic entry is invalid"));return}t.push(s)}),r.length>0?{ok:!1,issues:r}:{ok:!0,value:t}}function x(e){if(!f(e))return{ok:!1,issues:[i("$","invalid_type","Value format preference response must be a plain object")]};const t=m(e,D),r=e.stored===null?{ok:!0,value:null}:h(e.stored),s=b(e.inherited,"inherited"),a=b(e.resolved,"resolved"),n=w(e.inheritedSources,"inheritedSources"),o=w(e.sources,"sources"),l=H(e.diagnostics),u=[...t,...r.ok?[]:r.issues,...s.ok?[]:s.issues,...a.ok?[]:a.issues,...n.ok?[]:n.issues,...o.ok?[]:o.issues,...l.ok?[]:l.issues];return u.length>0||!r.ok||!s.ok||!a.ok||!n.ok||!o.ok||!l.ok?{ok:!1,issues:u}:{ok:!0,value:{stored:r.value,inherited:s.value,inheritedSources:n.value,resolved:a.value,sources:o.value,diagnostics:l.value}}}function k(e){var r,s;const t=new Set;return e.locale!==void 0&&t.add("locale"),e.dateStyle!==void 0&&t.add("dateStyle"),((r=e.dateTime)==null?void 0:r.dateStyle)!==void 0&&t.add("dateTime.dateStyle"),((s=e.dateTime)==null?void 0:s.timeStyle)!==void 0&&t.add("dateTime.timeStyle"),e.defaultCurrency!==void 0&&t.add("defaultCurrency"),t}function W(e,t){return{...e,...t.locale!==void 0?{locale:t.locale}:{},...t.dateStyle!==void 0?{dateStyle:t.dateStyle}:{},...t.dateTime?{dateTime:{...e.dateTime,...t.dateTime}}:{},...t.defaultCurrency!==void 0?{defaultCurrency:t.defaultCurrency}:{}}}function J(e,t){var s,a;const r={...e,...e.dateTime?{dateTime:{...e.dateTime}}:{}};for(const n of t)n==="locale"&&delete r.locale,n==="dateStyle"&&delete r.dateStyle,n==="dateTime.dateStyle"&&((s=r.dateTime)==null||delete s.dateStyle),n==="dateTime.timeStyle"&&((a=r.dateTime)==null||delete a.timeStyle),n==="defaultCurrency"&&delete r.defaultCurrency;return r.dateTime&&Object.keys(r.dateTime).length===0&&delete r.dateTime,r}function Q(e){if(e===void 0)return{paths:[],issues:[]};if(!Array.isArray(e))return{paths:[],issues:[i("clear","invalid_type","clear must be an array")]};const t=[],r=[],s=new Set;return e.forEach((a,n)=>{if(typeof a!="string"||!g.includes(a)){r.push(i(`clear.${n}`,typeof a=="string"?"unknown_property":"invalid_type",`clear.${n} must be a recognized preference path`));return}const o=a;if(s.has(o)){r.push(i(o,"duplicate_clear_path",`${o} appears more than once in clear`));return}s.add(o),t.push(o)}),{paths:t,issues:r}}function X(e,t){if(!f(t))return{ok:!1,issues:[i("$","invalid_type","Preference mutation must be a plain object")]};const r=m(t,["set","clear"]);let s={};if(t.set!==void 0){const u=h(t.set);u.ok?s=u.value:r.push(...u.issues)}const a=Q(t.clear);r.push(...a.issues);const n=k(s);r.length===0&&n.size===0&&a.paths.length===0&&r.push(i("$","empty_mutation","Preference mutation must set or clear at least one leaf"));for(const u of a.paths)n.has(u)&&r.push(i(u,"conflicting_operation",`${u} cannot be set and cleared in the same mutation`));if(r.length>0)return{ok:!1,issues:r};const o=Z(e),l=J(W(o??{},s),a.paths);return{ok:!0,value:k(l).size===0?null:l}}function $(e,t){return{scope:e,path:t,code:"invalid_stored_preference"}}function P(e,t){if(e==null)return{value:null,diagnostics:[]};if(!f(e))return{value:null,diagnostics:[$(t,"$")]};const r=new Set;Object.keys(e).some(o=>!L.includes(o))&&r.add("$");const s={};if(d(e,"locale")){const o=O(e.locale,"locale");o.ok?s.locale=o.value:r.add("locale")}if(d(e,"dateStyle")){const o=T(e.dateStyle,"dateStyle");o.ok?s.dateStyle=o.value:r.add("dateStyle")}if(d(e,"dateTime"))if(!f(e.dateTime))r.add("$");else{Object.keys(e.dateTime).some(l=>!E.includes(l))&&r.add("$");const o={};if(d(e.dateTime,"dateStyle")){const l=T(e.dateTime.dateStyle,"dateTime.dateStyle");l.ok?o.dateStyle=l.value:r.add("dateTime.dateStyle")}if(d(e.dateTime,"timeStyle")){const l=T(e.dateTime.timeStyle,"dateTime.timeStyle");l.ok?o.timeStyle=l.value:r.add("dateTime.timeStyle")}Object.keys(o).length>0&&(s.dateTime=o)}if(d(e,"defaultCurrency")){const o=I(e.defaultCurrency,"defaultCurrency");o.ok?s.defaultCurrency=o.value:r.add("defaultCurrency")}const n=["$",...g].filter(o=>r.has(o)).map(o=>$(t,o));return{value:k(s).size===0?null:s,diagnostics:n}}function Z(e){return P(e,"viewer_user").value}function q(e,t){return P(e,t)}function p(e,t,r){for(const s of e){if(!s.value)continue;const a=t(s.value);if(a!==void 0)return{value:a,source:s.source}}return{value:r,source:"system_default"}}function ee(e){if(e.user!==void 0&&e.tenantUser!==void 0)throw new TypeError("Value format preference resolution cannot include both user and tenantUser");const t=[],r=[],s=(c,y,U)=>{const R=P(c,y);t.push({value:R.value,source:U}),r.push(...R.diagnostics)};e.user!==void 0?s(e.user,"viewer_user","viewer_user"):e.tenantUser!==void 0&&s(e.tenantUser,"viewer_tenant_user","viewer_tenant_user"),e.sessionInitial&&t.push({value:e.sessionInitial,source:"session_initial"}),e.user===void 0&&(e.tenantUser!==void 0||e.tenant!==void 0)&&s(e.tenant,"viewer_tenant","viewer_tenant"),s(e.organization,"viewer_organization","viewer_organization");const a=p(t,c=>c.locale,S.locale),n=p(t,c=>c.dateStyle,S.dateStyle),o=p(t,c=>{var y;return(y=c.dateTime)==null?void 0:y.dateStyle},S.dateTime.dateStyle),l=p(t,c=>{var y;return(y=c.dateTime)==null?void 0:y.timeStyle},S.dateTime.timeStyle),u=p(t,c=>c.defaultCurrency,S.defaultCurrency);return{preferences:{locale:a.value,dateStyle:n.value,dateTime:{dateStyle:o.value,timeStyle:l.value},defaultCurrency:u.value},sources:{locale:a.source,dateStyle:n.source,dateTime:{dateStyle:o.source,timeStyle:l.source},defaultCurrency:u.source},diagnostics:r}}exports.DEFAULT_RESOLVED_VALUE_FORMAT_PREFERENCES=S;exports.REPORT_PREFERENCE_SOURCES=F;exports.applyValueFormatPreferenceMutation=X;exports.canonicalizeSupportedCurrencyCode=A;exports.canonicalizeSupportedLocale=Y;exports.decodeStoredValueFormatPreferences=q;exports.getSupportedCurrencyCodes=K;exports.isReportPreferenceSource=v;exports.parseValueFormatPreferences=h;exports.parseValueFormatPreferencesResponse=x;exports.resolveValueFormatPreferences=ee;