@vmz/vmz 0.0.1 → 0.0.2

package/dist/locale-runtime.d.ts

@@ -0,0 +1,406 @@
+/**
+ * Fixed negotiation priority (doc 28 §6). 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): {
+    schema: string;
+    applicationId: any;
+    deliveryId: any;
+    localeId: any;
+    timeZone: any;
+    calendar: any;
+    numberingSystem: any;
+    direction: any;
+    generation: any;
+};
+/**
+ * @param {ReturnType<typeof buildApplicationContext>} app
+ * @param {{ currency?: string }} [opts]
+ */
+export declare function buildFormatterContext(app: any, opts?: {}): {
+    schema: string;
+    localeId: any;
+    timeZone: any;
+    calendar: any;
+    numberingSystem: any;
+    currency: any;
+    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?: {}): {
+    ok: boolean;
+    diagnostics: any[];
+};
+/**
+ * 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): {
+    schema: string;
+    messageId: any;
+    requestedLocale: any;
+    resolvedLocale: any;
+    fallbackPath: any[];
+    template: any;
+    ok: boolean;
+};
+/**
+ * Minimal ICU MessageFormat subset for I2 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): {
+    negotiateLocale: typeof negotiateLocale;
+    snapshot: () => {
+        applicationContext: {
+            schema: string;
+            applicationId: any;
+            deliveryId: any;
+            localeId: any;
+            timeZone: any;
+            calendar: any;
+            numberingSystem: any;
+            direction: any;
+            generation: any;
+        };
+        formatterContext: {
+            schema: string;
+            localeId: any;
+            timeZone: any;
+            calendar: any;
+            numberingSystem: any;
+            currency: any;
+            formatterDataVersion: string;
+        };
+        formatterDigest: string;
+        loadedChunks: unknown[];
+        generation: any;
+    };
+    renderAll: (argMap?: {}) => {
+        bindings: {};
+        resolvedLocales: any[];
+    };
+    transition: (targetLocaleId: any, transitionOpts?: {}) => Promise<{
+        schema: string;
+        status: string;
+        fromLocale: any;
+        toLocale: any;
+        reason: string;
+        diagnostics: {
+            code: string;
+            severity: string;
+            message: string;
+        }[];
+        snapshot: {
+            applicationContext: {
+                schema: string;
+                applicationId: any;
+                deliveryId: any;
+                localeId: any;
+                timeZone: any;
+                calendar: any;
+                numberingSystem: any;
+                direction: any;
+                generation: any;
+            };
+            formatterContext: {
+                schema: string;
+                localeId: any;
+                timeZone: any;
+                calendar: any;
+                numberingSystem: any;
+                currency: any;
+                formatterDataVersion: string;
+            };
+            formatterDigest: string;
+            loadedChunks: unknown[];
+            generation: any;
+        };
+        rendered?: undefined;
+    } | {
+        schema: string;
+        status: string;
+        fromLocale: any;
+        toLocale: any;
+        reason: string;
+        diagnostics: any[];
+        snapshot: {
+            applicationContext: {
+                schema: string;
+                applicationId: any;
+                deliveryId: any;
+                localeId: any;
+                timeZone: any;
+                calendar: any;
+                numberingSystem: any;
+                direction: any;
+                generation: any;
+            };
+            formatterContext: {
+                schema: string;
+                localeId: any;
+                timeZone: any;
+                calendar: any;
+                numberingSystem: any;
+                currency: any;
+                formatterDataVersion: string;
+            };
+            formatterDigest: string;
+            loadedChunks: unknown[];
+            generation: any;
+        };
+        rendered: {
+            bindings: {};
+            resolvedLocales: any[];
+        };
+    }>;
+    readonly applicationContext: {
+        schema: string;
+        applicationId: any;
+        deliveryId: any;
+        localeId: any;
+        timeZone: any;
+        calendar: any;
+        numberingSystem: any;
+        direction: any;
+        generation: any;
+    };
+    readonly formatterContext: {
+        schema: string;
+        localeId: any;
+        timeZone: any;
+        calendar: any;
+        numberingSystem: any;
+        currency: any;
+        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): {
+    schema: string;
+    status: string;
+    kind: string;
+    diagnostics: any[];
+};
+/**
+ * Aggregate I2 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): {
+    schema: string;
+    status: string;
+    negotiatedLocale: any;
+    applicationContext: {
+        schema: string;
+        applicationId: any;
+        deliveryId: any;
+        localeId: any;
+        timeZone: any;
+        calendar: any;
+        numberingSystem: any;
+        direction: any;
+        generation: any;
+    };
+    formatterContext: {
+        schema: string;
+        localeId: any;
+        timeZone: any;
+        calendar: any;
+        numberingSystem: any;
+        currency: any;
+        formatterDataVersion: string;
+    };
+    formatterDigest: string;
+    formatterDataVersion: string;
+    diagnostics: any[];
+    session: {
+        negotiateLocale: typeof negotiateLocale;
+        snapshot: () => {
+            applicationContext: {
+                schema: string;
+                applicationId: any;
+                deliveryId: any;
+                localeId: any;
+                timeZone: any;
+                calendar: any;
+                numberingSystem: any;
+                direction: any;
+                generation: any;
+            };
+            formatterContext: {
+                schema: string;
+                localeId: any;
+                timeZone: any;
+                calendar: any;
+                numberingSystem: any;
+                currency: any;
+                formatterDataVersion: string;
+            };
+            formatterDigest: string;
+            loadedChunks: unknown[];
+            generation: any;
+        };
+        renderAll: (argMap?: {}) => {
+            bindings: {};
+            resolvedLocales: any[];
+        };
+        transition: (targetLocaleId: any, transitionOpts?: {}) => Promise<{
+            schema: string;
+            status: string;
+            fromLocale: any;
+            toLocale: any;
+            reason: string;
+            diagnostics: {
+                code: string;
+                severity: string;
+                message: string;
+            }[];
+            snapshot: {
+                applicationContext: {
+                    schema: string;
+                    applicationId: any;
+                    deliveryId: any;
+                    localeId: any;
+                    timeZone: any;
+                    calendar: any;
+                    numberingSystem: any;
+                    direction: any;
+                    generation: any;
+                };
+                formatterContext: {
+                    schema: string;
+                    localeId: any;
+                    timeZone: any;
+                    calendar: any;
+                    numberingSystem: any;
+                    currency: any;
+                    formatterDataVersion: string;
+                };
+                formatterDigest: string;
+                loadedChunks: unknown[];
+                generation: any;
+            };
+            rendered?: undefined;
+        } | {
+            schema: string;
+            status: string;
+            fromLocale: any;
+            toLocale: any;
+            reason: string;
+            diagnostics: any[];
+            snapshot: {
+                applicationContext: {
+                    schema: string;
+                    applicationId: any;
+                    deliveryId: any;
+                    localeId: any;
+                    timeZone: any;
+                    calendar: any;
+                    numberingSystem: any;
+                    direction: any;
+                    generation: any;
+                };
+                formatterContext: {
+                    schema: string;
+                    localeId: any;
+                    timeZone: any;
+                    calendar: any;
+                    numberingSystem: any;
+                    currency: any;
+                    formatterDataVersion: string;
+                };
+                formatterDigest: string;
+                loadedChunks: unknown[];
+                generation: any;
+            };
+            rendered: {
+                bindings: {};
+                resolvedLocales: any[];
+            };
+        }>;
+        readonly applicationContext: {
+            schema: string;
+            applicationId: any;
+            deliveryId: any;
+            localeId: any;
+            timeZone: any;
+            calendar: any;
+            numberingSystem: any;
+            direction: any;
+            generation: any;
+        };
+        readonly formatterContext: {
+            schema: string;
+            localeId: any;
+            timeZone: any;
+            calendar: any;
+            numberingSystem: any;
+            currency: any;
+            formatterDataVersion: string;
+        };
+        readonly formatterDigest: string;
+    };
+};