@vmz/vmz 0.1.16 → 0.1.18

package/dist/locale-runtime.d.ts

@@ -1,140 +1,145 @@
-/**
- * Fixed negotiation priority (locale notes ). Host only supplies candidates.
- * @param {{
- * supportedLocales: string[],
- * defaultLocale: string,
- * routeLocale?: string|null,
- * userChoice?: string|null,
- * preference?: string|null,
- * hostCandidates?: string[],
- * }} input
- */
-export declare function negotiateLocale(input: any): any;
-/**
- * @param {{
- * applicationId: string,
- * deliveryId: string,
- * localeId: string,
- * timeZone: string,
- * calendar?: string,
- * numberingSystem?: string,
- * direction?: string,
- * generation?: number,
- * }} opts
- */
-export declare function buildApplicationContext(opts: any): {
+/** Fixed negotiation priority. Host only supplies candidates. */
+export declare function negotiateLocale(input: {
+    supportedLocales: string[];
+    defaultLocale: string;
+    routeLocale?: string | null;
+    userChoice?: string | null;
+    preference?: string | null;
+    hostCandidates?: string[];
+}): string;
+export interface ApplicationContextOpts {
+    applicationId: string;
+    deliveryId: string;
+    localeId: string;
+    timeZone: string;
+    calendar?: string;
+    numberingSystem?: string;
+    direction?: string;
+    generation?: number;
+}
+export declare function buildApplicationContext(opts: ApplicationContextOpts): {
     schema: string;
-    applicationId: any;
-    deliveryId: any;
-    localeId: any;
-    timeZone: any;
-    calendar: any;
-    numberingSystem: any;
-    direction: any;
-    generation: any;
+    applicationId: string;
+    deliveryId: string;
+    localeId: string;
+    timeZone: string;
+    calendar: string;
+    numberingSystem: string;
+    direction: string;
+    generation: number;
 };
-/**
- * @param {ReturnType<typeof buildApplicationContext>} app
- * @param {{ currency?: string }} [opts]
- */
-export declare function buildFormatterContext(app: any, opts?: {}): {
+export type ApplicationContext = ReturnType<typeof buildApplicationContext>;
+export interface FormatterContextOpts {
+    currency?: string;
+}
+export declare function buildFormatterContext(app: ApplicationContext, opts?: FormatterContextOpts): {
     schema: string;
-    localeId: any;
-    timeZone: any;
-    calendar: any;
-    numberingSystem: any;
-    currency: any;
+    localeId: string;
+    timeZone: string;
+    calendar: string;
+    numberingSystem: string;
+    currency: string;
     formatterDataVersion: string;
 };
-/**
- * Stable digest for Resume / SSR↔client parity.
- * @param {ReturnType<typeof buildFormatterContext>} formatter
- */
-export declare function formatterContextDigest(formatter: any): string;
-/**
- * Server must not read machine locale/timezone defaults.
- * @param {ReturnType<typeof buildFormatterContext>} formatter
- * @param {{ allowMachineDefault?: boolean }} [opts]
- */
-export declare function validateFormatterContext(formatter: any, opts?: {}): {
+export type FormatterContext = ReturnType<typeof buildFormatterContext>;
+/** Stable digest for Resume / SSR↔client parity. */
+export declare function formatterContextDigest(formatter: FormatterContext): string;
+export interface ValidateFormatterContextOpts {
+    allowMachineDefault?: boolean;
+}
+export interface LocaleDiagnostic {
+    code: string;
+    severity: string;
+    message: string;
+}
+/** Server must not read machine locale/timezone defaults. */
+export declare function validateFormatterContext(formatter: FormatterContext, opts?: ValidateFormatterContextOpts): {
     ok: boolean;
-    diagnostics: any[];
+    diagnostics: LocaleDiagnostic[];
 };
-/**
- * Resolve one MessageBinding to a single locale variant (whole-message, no mix).
- * @param {{
- * messageId: string,
- * requestedLocale: string,
- * variants: Record<string, { template: string }>,
- * fallback?: Record<string, string[]>,
- * }} input
- */
-export declare function resolveMessageVariant(input: any): {
+export interface MessageVariantInput {
+    template: string;
+}
+/** Resolve one MessageBinding to a single locale variant (whole-message, no mix). */
+export declare function resolveMessageVariant(input: {
+    messageId: string;
+    requestedLocale: string;
+    variants: Record<string, MessageVariantInput>;
+    fallback?: Record<string, string[]>;
+}): {
     schema: string;
-    messageId: any;
-    requestedLocale: any;
-    resolvedLocale: any;
-    fallbackPath: any[];
-    template: any;
+    messageId: string;
+    requestedLocale: string;
+    resolvedLocale: string;
+    fallbackPath: string[];
+    template: string;
     ok: boolean;
 };
 /**
  * Minimal ICU MessageFormat subset for parity proofs (params + plural + #).
- * @param {string} template
- * @param {Record<string, any>} [args]
  */
-export declare function formatMessageTemplate(template: any, args?: {}): string;
-/**
- * @param {{
- * applicationId: string,
- * deliveryId: string,
- * supportedLocales: string[],
- * defaultLocale: string,
- * fallback?: Record<string, string[]>,
- * directions?: Record<string, string>,
- * messages: Record<string, { variants: Record<string, { template: string }> }>,
- * initialLocaleId: string,
- * timeZone: string,
- * generation?: number,
- * loadedChunks?: Set<string>|string[],
- * }} opts
- */
-export declare function createLocaleSession(opts: any): {
+export declare function formatMessageTemplate(template: string, args?: Record<string, unknown>): string;
+export interface LocaleSessionOpts {
+    applicationId: string;
+    deliveryId: string;
+    supportedLocales: string[];
+    defaultLocale: string;
+    fallback?: Record<string, string[]>;
+    directions?: Record<string, string>;
+    messages: Record<string, {
+        variants: Record<string, {
+            template: string;
+        }>;
+    }>;
+    initialLocaleId: string;
+    timeZone: string;
+    generation?: number;
+    loadedChunks?: Set<string> | string[];
+}
+export interface LocaleTransitionOpts {
+    generation?: number;
+    loadChunk?: (localeId: string) => boolean | Promise<boolean>;
+    timeZone?: string;
+}
+export declare function createLocaleSession(opts: LocaleSessionOpts): {
     negotiateLocale: typeof negotiateLocale;
     snapshot: () => {
         applicationContext: {
             schema: string;
-            applicationId: any;
-            deliveryId: any;
-            localeId: any;
-            timeZone: any;
-            calendar: any;
-            numberingSystem: any;
-            direction: any;
-            generation: any;
+            applicationId: string;
+            deliveryId: string;
+            localeId: string;
+            timeZone: string;
+            calendar: string;
+            numberingSystem: string;
+            direction: string;
+            generation: number;
         };
         formatterContext: {
             schema: string;
-            localeId: any;
-            timeZone: any;
-            calendar: any;
-            numberingSystem: any;
-            currency: any;
+            localeId: string;
+            timeZone: string;
+            calendar: string;
+            numberingSystem: string;
+            currency: string;
             formatterDataVersion: string;
         };
         formatterDigest: string;
-        loadedChunks: unknown[];
-        generation: any;
+        loadedChunks: string[];
+        generation: number;
     };
-    renderAll: (argMap?: {}) => {
-        bindings: {};
-        resolvedLocales: any[];
+    renderAll: (argMap?: Record<string, Record<string, unknown>>) => {
+        bindings: Record<string, {
+            text: string;
+            resolvedLocale: string;
+        }>;
+        resolvedLocales: string[];
     };
-    transition: (targetLocaleId: any, transitionOpts?: {}) => Promise<{
+    transition: (targetLocaleId: string, transitionOpts?: LocaleTransitionOpts) => Promise<{
         schema: string;
         status: string;
-        fromLocale: any;
-        toLocale: any;
+        fromLocale: string;
+        toLocale: string;
         reason: string;
         diagnostics: {
             code: string;
@@ -144,174 +149,196 @@ export declare function createLocaleSession(opts: any): {
         snapshot: {
             applicationContext: {
                 schema: string;
-                applicationId: any;
-                deliveryId: any;
-                localeId: any;
-                timeZone: any;
-                calendar: any;
-                numberingSystem: any;
-                direction: any;
-                generation: any;
+                applicationId: string;
+                deliveryId: string;
+                localeId: string;
+                timeZone: string;
+                calendar: string;
+                numberingSystem: string;
+                direction: string;
+                generation: number;
             };
             formatterContext: {
                 schema: string;
-                localeId: any;
-                timeZone: any;
-                calendar: any;
-                numberingSystem: any;
-                currency: any;
+                localeId: string;
+                timeZone: string;
+                calendar: string;
+                numberingSystem: string;
+                currency: string;
                 formatterDataVersion: string;
             };
             formatterDigest: string;
-            loadedChunks: unknown[];
-            generation: any;
+            loadedChunks: string[];
+            generation: number;
         };
         rendered?: undefined;
     } | {
         schema: string;
         status: string;
-        fromLocale: any;
-        toLocale: any;
+        fromLocale: string;
+        toLocale: string;
         reason: string;
-        diagnostics: any[];
+        diagnostics: LocaleDiagnostic[];
         snapshot: {
             applicationContext: {
                 schema: string;
-                applicationId: any;
-                deliveryId: any;
-                localeId: any;
-                timeZone: any;
-                calendar: any;
-                numberingSystem: any;
-                direction: any;
-                generation: any;
+                applicationId: string;
+                deliveryId: string;
+                localeId: string;
+                timeZone: string;
+                calendar: string;
+                numberingSystem: string;
+                direction: string;
+                generation: number;
             };
             formatterContext: {
                 schema: string;
-                localeId: any;
-                timeZone: any;
-                calendar: any;
-                numberingSystem: any;
-                currency: any;
+                localeId: string;
+                timeZone: string;
+                calendar: string;
+                numberingSystem: string;
+                currency: string;
                 formatterDataVersion: string;
             };
             formatterDigest: string;
-            loadedChunks: unknown[];
-            generation: any;
+            loadedChunks: string[];
+            generation: number;
         };
         rendered: {
-            bindings: {};
-            resolvedLocales: any[];
+            bindings: Record<string, {
+                text: string;
+                resolvedLocale: string;
+            }>;
+            resolvedLocales: string[];
         };
     }>;
     readonly applicationContext: {
         schema: string;
-        applicationId: any;
-        deliveryId: any;
-        localeId: any;
-        timeZone: any;
-        calendar: any;
-        numberingSystem: any;
-        direction: any;
-        generation: any;
+        applicationId: string;
+        deliveryId: string;
+        localeId: string;
+        timeZone: string;
+        calendar: string;
+        numberingSystem: string;
+        direction: string;
+        generation: number;
     };
     readonly formatterContext: {
         schema: string;
-        localeId: any;
-        timeZone: any;
-        calendar: any;
-        numberingSystem: any;
-        currency: any;
+        localeId: string;
+        timeZone: string;
+        calendar: string;
+        numberingSystem: string;
+        currency: string;
         formatterDataVersion: string;
     };
     readonly formatterDigest: string;
 };
-/**
- * SSR and client must share the same resolved FormatterContext digest and texts.
- * @param {{
- * ssr: { localeId: string, formatterDigest: string, formatterDataVersion?: string, texts: Record<string, string> },
- * client: { localeId: string, formatterDigest: string, formatterDataVersion?: string, texts: Record<string, string> },
- * }} input
- */
-export declare function checkSsrClientParity(input: any): {
+/** SSR and client must share the same resolved FormatterContext digest and texts. */
+export declare function checkSsrClientParity(input: {
+    ssr: {
+        localeId: string;
+        formatterDigest: string;
+        formatterDataVersion?: string;
+        texts: Record<string, string>;
+    };
+    client: {
+        localeId: string;
+        formatterDigest: string;
+        formatterDataVersion?: string;
+        texts: Record<string, string>;
+    };
+}): {
     schema: string;
     status: string;
     kind: string;
-    diagnostics: any[];
+    diagnostics: LocaleDiagnostic[];
 };
-/**
- * Aggregate runtime proof for a project check report + explicit contexts.
- * @param {{
- * manifest: { defaultLocale: string, locales: Array<{id:string,direction?:string}>, fallback?: Record<string,string[]> },
- * messages: Array<{ messageId: string, variants: Record<string, { template: string }> }>,
- * applicationId?: string,
- * deliveryId?: string,
- * timeZone?: string,
- * }} input
- */
-export declare function checkLocaleRuntime(input: any): {
+/** Aggregate runtime proof for a project check report + explicit contexts. */
+export declare function checkLocaleRuntime(input: {
+    manifest: {
+        defaultLocale: string;
+        locales: Array<{
+            id: string;
+            direction?: string;
+        }>;
+        fallback?: Record<string, string[]>;
+    };
+    messages: Array<{
+        messageId: string;
+        variants: Record<string, {
+            template: string;
+        }>;
+    }>;
+    applicationId?: string;
+    deliveryId?: string;
+    timeZone?: string;
+}): {
     schema: string;
     status: string;
-    negotiatedLocale: any;
+    negotiatedLocale: string;
     applicationContext: {
         schema: string;
-        applicationId: any;
-        deliveryId: any;
-        localeId: any;
-        timeZone: any;
-        calendar: any;
-        numberingSystem: any;
-        direction: any;
-        generation: any;
+        applicationId: string;
+        deliveryId: string;
+        localeId: string;
+        timeZone: string;
+        calendar: string;
+        numberingSystem: string;
+        direction: string;
+        generation: number;
     };
     formatterContext: {
         schema: string;
-        localeId: any;
-        timeZone: any;
-        calendar: any;
-        numberingSystem: any;
-        currency: any;
+        localeId: string;
+        timeZone: string;
+        calendar: string;
+        numberingSystem: string;
+        currency: string;
         formatterDataVersion: string;
     };
     formatterDigest: string;
     formatterDataVersion: string;
-    diagnostics: any[];
+    diagnostics: LocaleDiagnostic[];
     session: {
         negotiateLocale: typeof negotiateLocale;
         snapshot: () => {
             applicationContext: {
                 schema: string;
-                applicationId: any;
-                deliveryId: any;
-                localeId: any;
-                timeZone: any;
-                calendar: any;
-                numberingSystem: any;
-                direction: any;
-                generation: any;
+                applicationId: string;
+                deliveryId: string;
+                localeId: string;
+                timeZone: string;
+                calendar: string;
+                numberingSystem: string;
+                direction: string;
+                generation: number;
             };
             formatterContext: {
                 schema: string;
-                localeId: any;
-                timeZone: any;
-                calendar: any;
-                numberingSystem: any;
-                currency: any;
+                localeId: string;
+                timeZone: string;
+                calendar: string;
+                numberingSystem: string;
+                currency: string;
                 formatterDataVersion: string;
             };
             formatterDigest: string;
-            loadedChunks: unknown[];
-            generation: any;
+            loadedChunks: string[];
+            generation: number;
         };
-        renderAll: (argMap?: {}) => {
-            bindings: {};
-            resolvedLocales: any[];
+        renderAll: (argMap?: Record<string, Record<string, unknown>>) => {
+            bindings: Record<string, {
+                text: string;
+                resolvedLocale: string;
+            }>;
+            resolvedLocales: string[];
         };
-        transition: (targetLocaleId: any, transitionOpts?: {}) => Promise<{
+        transition: (targetLocaleId: string, transitionOpts?: LocaleTransitionOpts) => Promise<{
             schema: string;
             status: string;
-            fromLocale: any;
-            toLocale: any;
+            fromLocale: string;
+            toLocale: string;
             reason: string;
             diagnostics: {
                 code: string;
@@ -321,84 +348,87 @@ export declare function checkLocaleRuntime(input: any): {
             snapshot: {
                 applicationContext: {
                     schema: string;
-                    applicationId: any;
-                    deliveryId: any;
-                    localeId: any;
-                    timeZone: any;
-                    calendar: any;
-                    numberingSystem: any;
-                    direction: any;
-                    generation: any;
+                    applicationId: string;
+                    deliveryId: string;
+                    localeId: string;
+                    timeZone: string;
+                    calendar: string;
+                    numberingSystem: string;
+                    direction: string;
+                    generation: number;
                 };
                 formatterContext: {
                     schema: string;
-                    localeId: any;
-                    timeZone: any;
-                    calendar: any;
-                    numberingSystem: any;
-                    currency: any;
+                    localeId: string;
+                    timeZone: string;
+                    calendar: string;
+                    numberingSystem: string;
+                    currency: string;
                     formatterDataVersion: string;
                 };
                 formatterDigest: string;
-                loadedChunks: unknown[];
-                generation: any;
+                loadedChunks: string[];
+                generation: number;
             };
             rendered?: undefined;
         } | {
             schema: string;
             status: string;
-            fromLocale: any;
-            toLocale: any;
+            fromLocale: string;
+            toLocale: string;
             reason: string;
-            diagnostics: any[];
+            diagnostics: LocaleDiagnostic[];
             snapshot: {
                 applicationContext: {
                     schema: string;
-                    applicationId: any;
-                    deliveryId: any;
-                    localeId: any;
-                    timeZone: any;
-                    calendar: any;
-                    numberingSystem: any;
-                    direction: any;
-                    generation: any;
+                    applicationId: string;
+                    deliveryId: string;
+                    localeId: string;
+                    timeZone: string;
+                    calendar: string;
+                    numberingSystem: string;
+                    direction: string;
+                    generation: number;
                 };
                 formatterContext: {
                     schema: string;
-                    localeId: any;
-                    timeZone: any;
-                    calendar: any;
-                    numberingSystem: any;
-                    currency: any;
+                    localeId: string;
+                    timeZone: string;
+                    calendar: string;
+                    numberingSystem: string;
+                    currency: string;
                     formatterDataVersion: string;
                 };
                 formatterDigest: string;
-                loadedChunks: unknown[];
-                generation: any;
+                loadedChunks: string[];
+                generation: number;
             };
             rendered: {
-                bindings: {};
-                resolvedLocales: any[];
+                bindings: Record<string, {
+                    text: string;
+                    resolvedLocale: string;
+                }>;
+                resolvedLocales: string[];
             };
         }>;
         readonly applicationContext: {
             schema: string;
-            applicationId: any;
-            deliveryId: any;
-            localeId: any;
-            timeZone: any;
-            calendar: any;
-            numberingSystem: any;
-            direction: any;
-            generation: any;
+            applicationId: string;
+            deliveryId: string;
+            localeId: string;
+            timeZone: string;
+            calendar: string;
+            numberingSystem: string;
+            direction: string;
+            generation: number;
         };
         readonly formatterContext: {
             schema: string;
-            localeId: any;
-            timeZone: any;
-            calendar: any;
-            numberingSystem: any;
-            currency: any;
+            localeId: string;
+            timeZone: string;
+            calendar: string;
+            numberingSystem: string;
+            currency: string;
             formatterDataVersion: string;
         };
         readonly formatterDigest: string;