@parallelworks/i18n 0.0.0-stage → 0.1.1

package/README.md

@@ -1,3 +1,82 @@
-# Temporary Holding Version
+# @parallelworks/i18n
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Localization for React apps on [use-intl](https://next-intl.dev/docs/environments/core-library): picking the reader's language, a provider that switches it, catalogs loaded only when needed, and a check that keeps every language in step with the default.
+
+Related packages: show API errors with `useErrorMessage()` from `@parallelworks/problem/react`, and keep hard-coded English out of components with `@parallelworks/lint`.
+
+## Catalogs
+
+Messages live in one directory, in either layout:
+
+- one file per locale: `locales/en.json`, `locales/es.json`
+- one file per namespace, for large apps: `locales/en/nav.json`, `locales/en/billing.json`. Unrelated features then rarely edit the same file. `parallelworks-i18n index` writes `locales/en/index.ts`, which imports them all, so `typeof import('./locales/en')` types the messages.
+
+## Vite
+
+```ts
+// vite.config.ts
+import { i18n } from '@parallelworks/i18n/vite'
+
+export default defineConfig({
+  plugins: [
+    i18n({
+      dir: 'src/i18n/locales',
+      defaultLocale: 'en',
+      // Optional: namespaces only these features use, loaded where they're shown.
+      catalogs: { admin: ['adminUsers', 'adminBilling'] },
+    }),
+  ],
+})
+```
+
+The plugin serves `virtual:i18n`: `locales`, `defaultLocale`, `defaultMessages` (the default locale's common messages, bundled) and `loadMessages(locale, catalog?)`, which loads every other locale and catalog as its own chunk. Add `"@parallelworks/i18n/client"` to `compilerOptions.types` for its types.
+
+## React
+
+```tsx
+// main.tsx
+import { detectLocale } from '@parallelworks/i18n'
+import { LocaleProvider } from '@parallelworks/i18n/react'
+import { defaultLocale, defaultMessages, loadMessages, locales } from 'virtual:i18n'
+
+// The server's choice (if it injects one), a stored choice, then the browser's languages.
+const locale = detectLocale(locales, { fallback: defaultLocale, cookie: 'locale' })
+const messages = locale === defaultLocale ? defaultMessages : await loadMessages(locale)
+
+root.render(
+  <LocaleProvider
+    initial={{ locale, messages }}
+    load={loadMessages}
+    fallbackLocale={defaultLocale}
+    onChange={(next) => {
+      document.cookie = `locale=${next}; path=/; max-age=31536000`
+    }}
+  >
+    <App />
+  </LocaleProvider>,
+)
+```
+
+- `useSetLocale()` switches the language. If the person picks again before the first finishes loading, the later choice wins.
+- The provider keeps `<html lang>` current and passes the browser's time zone to use-intl.
+- `<Catalog name='admin' fallback={<Spinner />}>` adds a feature catalog's messages beneath it, loading them for the current language first.
+- `negotiateLocale(preferred, locales, fallback)` matches tags such as `es-MX` to `es`.
+
+## Checks
+
+```sh
+parallelworks-i18n check --dir src/i18n/locales      # in CI
+parallelworks-i18n add new-messages.json --dir src/i18n/locales
+```
+
+`check` fails when a locale is missing a key or has one the default doesn't, when a message isn't valid ICU, when a translation uses different arguments or rich-text tags than the default, or when a split layout's `index.ts` is stale. `add` merges messages without changing an existing one, and is safe to run from several processes at once. Its file is one locale's tree, or trees keyed by locale.
+
+`@parallelworks/i18n/node` exports the same functions and the catalog reader for an app's own scripts.
+
+## Dates and numbers
+
+Format for display with use-intl's `useFormatter()`: `format.dateTime`, `format.relativeTime`, `format.number`. It uses `Intl` with the provider's locale and time zone, so nothing else has to follow the language.
+
+For parsing, arithmetic and time zones, use [Luxon](https://moment.github.io/luxon/) for now. Not the built-in `Date`, which is mutable and knows only the local and UTC zones.
+
+**Switch to [Temporal](https://tc39.es/proposal-temporal/docs/) once it is Baseline.** Temporal is ES2026 and ships in Chrome 144+ and Firefox 139+, but as of October 2026 not yet in stable Safari. When Safari ships it, move parsing and arithmetic from Luxon to Temporal here and in every app, and drop Luxon.

package/client.d.ts

@@ -0,0 +1,12 @@
+// Types for the module @parallelworks/i18n/vite serves. Reference it from
+// tsconfig ("types": ["@parallelworks/i18n/client"]).
+declare module 'virtual:i18n' {
+  import type { AbstractIntlMessages } from 'use-intl'
+
+  export const locales: readonly string[]
+  export const defaultLocale: string
+  /** The default locale's common messages, bundled with the app. */
+  export const defaultMessages: AbstractIntlMessages
+  /** A locale's common messages, or with catalog, one feature's. */
+  export function loadMessages(locale: string, catalog?: string): Promise<AbstractIntlMessages>
+}

package/dist/catalogs.d.ts

@@ -0,0 +1,26 @@
+/** A message catalog: nested objects whose leaves are ICU messages. */
+export type Messages = {
+    [key: string]: string | Messages;
+};
+/**
+ * The locales in dir. A locale is either one file, <dir>/<locale>.json, or a
+ * directory with one file per namespace, <dir>/<locale>/<namespace>.json.
+ */
+export declare function listLocales(dir: string): string[];
+/** The files a locale's messages come from, for watching them. */
+export declare function localeFiles(dir: string, locale: string): string[];
+/** A locale's messages, from either layout; a split locale is keyed by namespace. */
+export declare function readLocale(dir: string, locale: string): Messages;
+/** Whether dir keeps each locale in one file per namespace. */
+export declare function isSplit(dir: string, locale: string): boolean;
+/**
+ * Feature catalogs: each lists the namespaces only that feature needs, loaded
+ * when it's shown. Everything else is in the common catalog.
+ */
+export type CatalogMap = Record<string, readonly string[]>;
+export declare const COMMON = "common";
+/** The namespaces of messages that belong in catalog. */
+export declare function selectCatalog(messages: Messages, catalog: string, catalogs: CatalogMap): Messages;
+/** Every message, keyed by its dotted path. */
+export declare function flatten(messages: Messages, prefix?: string): Map<string, string>;
+//# sourceMappingURL=catalogs.d.ts.map

package/dist/catalogs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalogs.d.ts","sourceRoot":"","sources":["../src/catalogs.ts"],"names":[],"mappings":"AAGA,uEAAuE;AACvE,MAAM,MAAM,QAAQ,GAAG;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,QAAQ,CAAA;CAAE,CAAA;AAE3D;;;GAGG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,CAQjD;AAED,kEAAkE;AAClE,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAQjE;AAED,qFAAqF;AACrF,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,QAAQ,CAMhE;AAED,+DAA+D;AAC/D,wBAAgB,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAE5D;AAUD;;;GAGG;AACH,MAAM,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC,CAAA;AAE1D,eAAO,MAAM,MAAM,WAAW,CAAA;AAE9B,yDAAyD;AACzD,wBAAgB,aAAa,CAAC,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,UAAU,GAAG,QAAQ,CAQjG;AAED,+CAA+C;AAC/C,wBAAgB,OAAO,CAAC,QAAQ,EAAE,QAAQ,EAAE,MAAM,SAAK,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAQ5E"}

package/dist/catalogs.js

@@ -0,0 +1,73 @@
+import { existsSync, readdirSync, readFileSync, statSync } from 'node:fs';
+import path from 'node:path';
+/**
+ * The locales in dir. A locale is either one file, <dir>/<locale>.json, or a
+ * directory with one file per namespace, <dir>/<locale>/<namespace>.json.
+ */
+export function listLocales(dir) {
+    return readdirSync(dir, { withFileTypes: true })
+        .flatMap((entry) => {
+        if (entry.isFile() && entry.name.endsWith('.json'))
+            return [entry.name.slice(0, -5)];
+        if (entry.isDirectory())
+            return [entry.name];
+        return [];
+    })
+        .sort();
+}
+/** The files a locale's messages come from, for watching them. */
+export function localeFiles(dir, locale) {
+    const file = path.join(dir, `${locale}.json`);
+    if (existsSync(file))
+        return [file];
+    const split = path.join(dir, locale);
+    return readdirSync(split)
+        .filter((name) => name.endsWith('.json'))
+        .sort()
+        .map((name) => path.join(split, name));
+}
+/** A locale's messages, from either layout; a split locale is keyed by namespace. */
+export function readLocale(dir, locale) {
+    const file = path.join(dir, `${locale}.json`);
+    if (existsSync(file) && statSync(file).isFile())
+        return parse(file);
+    return Object.fromEntries(localeFiles(dir, locale).map((f) => [path.basename(f, '.json'), parse(f)]));
+}
+/** Whether dir keeps each locale in one file per namespace. */
+export function isSplit(dir, locale) {
+    return !existsSync(path.join(dir, `${locale}.json`));
+}
+function parse(file) {
+    try {
+        return JSON.parse(readFileSync(file, 'utf8'));
+    }
+    catch (error) {
+        throw new Error(`${file}: ${error.message}`);
+    }
+}
+export const COMMON = 'common';
+/** The namespaces of messages that belong in catalog. */
+export function selectCatalog(messages, catalog, catalogs) {
+    if (catalog !== COMMON) {
+        const names = catalogs[catalog];
+        if (!names)
+            throw new Error(`unknown message catalog ${catalog}`);
+        return Object.fromEntries(Object.entries(messages).filter(([ns]) => names.includes(ns)));
+    }
+    const featured = new Set(Object.values(catalogs).flat());
+    return Object.fromEntries(Object.entries(messages).filter(([ns]) => !featured.has(ns)));
+}
+/** Every message, keyed by its dotted path. */
+export function flatten(messages, prefix = '') {
+    const out = new Map();
+    for (const [key, value] of Object.entries(messages)) {
+        const at = prefix ? `${prefix}.${key}` : key;
+        if (typeof value === 'string')
+            out.set(at, value);
+        else
+            for (const [k, v] of flatten(value, at))
+                out.set(k, v);
+    }
+    return out;
+}
+//# sourceMappingURL=catalogs.js.map

package/dist/catalogs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalogs.js","sourceRoot":"","sources":["../src/catalogs.ts"],"names":[],"mappings":"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"}

package/dist/check.d.ts

@@ -0,0 +1,22 @@
+import { type Messages } from './catalogs.js';
+/**
+ * What's wrong with dir's catalogs, one line each: a key missing from or
+ * extra to a locale, a message that isn't valid ICU, a translation that uses
+ * different arguments or tags than the default locale's, or a stale index.
+ */
+export declare function check(dir: string, defaultLocale: string): string[];
+/** The sorted argument and tag names of an ICU message, or why it doesn't parse. */
+export declare function argumentsOf(message: string): string[] | string;
+/**
+ * For a locale kept as one file per namespace, a TypeScript module importing
+ * every namespace, so `typeof import('<dir>/<locale>')` types the messages.
+ */
+export declare function indexSource(dir: string, locale: string): string;
+export declare function writeIndex(dir: string, locale: string): void;
+/**
+ * Merges additions into dir's catalogs without changing an existing message.
+ * additions is one locale's tree for defaultLocale, or trees keyed by locale.
+ * Safe to run from several processes at once.
+ */
+export declare function add(dir: string, defaultLocale: string, additions: Messages): void;
+//# sourceMappingURL=check.d.ts.map

package/dist/check.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"check.d.ts","sourceRoot":"","sources":["../src/check.ts"],"names":[],"mappings":"AAGA,OAAO,EAKL,KAAK,QAAQ,EAEd,MAAM,eAAe,CAAA;AAEtB;;;;GAIG;AACH,wBAAgB,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,MAAM,EAAE,CA6ClE;AAED,oFAAoF;AACpF,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,MAAM,CA4B9D;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAI/D;AAMD,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAE5D;AAED;;;;GAIG;AACH,wBAAgB,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,SAAS,EAAE,QAAQ,GAAG,IAAI,CAyBjF"}

package/dist/check.js

@@ -0,0 +1,179 @@
+import { mkdirSync, readFileSync, rmdirSync, writeFileSync } from 'node:fs';
+import path from 'node:path';
+import { parse, TYPE } from '@formatjs/icu-messageformat-parser';
+import { flatten, isSplit, listLocales, localeFiles, readLocale, } from './catalogs.js';
+/**
+ * What's wrong with dir's catalogs, one line each: a key missing from or
+ * extra to a locale, a message that isn't valid ICU, a translation that uses
+ * different arguments or tags than the default locale's, or a stale index.
+ */
+export function check(dir, defaultLocale) {
+    const problems = [];
+    const reference = flatten(readLocale(dir, defaultLocale));
+    const referenceArgs = new Map();
+    for (const [key, message] of reference) {
+        const args = argumentsOf(message);
+        if (typeof args === 'string')
+            problems.push(`${defaultLocale}: ${key}: ${args}`);
+        else
+            referenceArgs.set(key, args);
+    }
+    for (const locale of listLocales(dir)) {
+        if (locale === defaultLocale)
+            continue;
+        const messages = flatten(readLocale(dir, locale));
+        for (const key of reference.keys()) {
+            if (!messages.has(key))
+                problems.push(`${locale}: missing ${key}`);
+        }
+        for (const [key, message] of messages) {
+            if (!reference.has(key)) {
+                problems.push(`${locale}: ${key} is not in ${defaultLocale}`);
+                continue;
+            }
+            const args = argumentsOf(message);
+            const want = referenceArgs.get(key);
+            if (typeof args === 'string')
+                problems.push(`${locale}: ${key}: ${args}`);
+            else if (want && args.join() !== want.join()) {
+                problems.push(`${locale}: ${key} uses {${args.join(', ')}}, ${defaultLocale} uses {${want.join(', ')}}`);
+            }
+        }
+    }
+    if (isSplit(dir, defaultLocale)) {
+        const file = indexFile(dir, defaultLocale);
+        let current = '';
+        try {
+            current = readFileSync(file, 'utf8');
+        }
+        catch {
+            // A missing index is reported below like a stale one.
+        }
+        if (current !== indexSource(dir, defaultLocale)) {
+            problems.push(`${path.relative(process.cwd(), file)} is out of date: run parallelworks-i18n index`);
+        }
+    }
+    return problems;
+}
+/** The sorted argument and tag names of an ICU message, or why it doesn't parse. */
+export function argumentsOf(message) {
+    let ast;
+    try {
+        ast = parse(message);
+    }
+    catch (error) {
+        return `not valid ICU: ${error.message}`;
+    }
+    const names = new Set();
+    const walk = (elements) => {
+        for (const el of elements) {
+            if (el.type === TYPE.tag) {
+                names.add(`<${el.value}>`);
+                walk(el.children);
+            }
+            else if (el.type === TYPE.select || el.type === TYPE.plural) {
+                names.add(el.value);
+                for (const option of Object.values(el.options))
+                    walk(option.value);
+            }
+            else if (el.type === TYPE.argument ||
+                el.type === TYPE.number ||
+                el.type === TYPE.date ||
+                el.type === TYPE.time) {
+                names.add(el.value);
+            }
+        }
+    };
+    walk(ast);
+    return [...names].sort();
+}
+/**
+ * For a locale kept as one file per namespace, a TypeScript module importing
+ * every namespace, so `typeof import('<dir>/<locale>')` types the messages.
+ */
+export function indexSource(dir, locale) {
+    const names = localeFiles(dir, locale).map((f) => path.basename(f, '.json'));
+    const imports = names.map((n) => `import ${n} from './${n}.json'`).join('\n');
+    return `${imports}\n\nexport default {\n${names.map((n) => `  ${n},`).join('\n')}\n}\n`;
+}
+function indexFile(dir, locale) {
+    return path.join(dir, locale, 'index.ts');
+}
+export function writeIndex(dir, locale) {
+    if (isSplit(dir, locale))
+        writeFileSync(indexFile(dir, locale), indexSource(dir, locale));
+}
+/**
+ * Merges additions into dir's catalogs without changing an existing message.
+ * additions is one locale's tree for defaultLocale, or trees keyed by locale.
+ * Safe to run from several processes at once.
+ */
+export function add(dir, defaultLocale, additions) {
+    const locales = listLocales(dir);
+    const keys = Object.keys(additions);
+    const byLocale = keys.length > 0 && keys.every((k) => locales.includes(k))
+        ? additions
+        : { [defaultLocale]: additions };
+    const lock = path.join(dir, '.add.lock');
+    for (let i = 0;; i++) {
+        try {
+            mkdirSync(lock);
+            break;
+        }
+        catch {
+            if (i > 200)
+                throw new Error(`${lock} is held: remove it if no other add is running`);
+            Atomics.wait(new Int32Array(new SharedArrayBuffer(4)), 0, 0, 25);
+        }
+    }
+    try {
+        // Merge everything before writing anything, so a conflict changes no file.
+        const writes = Object.entries(byLocale).flatMap(([locale, tree]) => merged(dir, locale, tree));
+        for (const [file, value] of writes)
+            writeJSON(file, value);
+        for (const locale of Object.keys(byLocale))
+            writeIndex(dir, locale);
+    }
+    finally {
+        rmdirSync(lock);
+    }
+}
+function merged(dir, locale, tree) {
+    if (!isSplit(dir, locale)) {
+        const file = path.join(dir, `${locale}.json`);
+        return [[file, merge(readJSON(file), tree, locale)]];
+    }
+    return Object.entries(tree).map(([ns, value]) => {
+        if (typeof value === 'string')
+            throw new Error(`${locale}: ${ns}: a namespace must be an object`);
+        const file = path.join(dir, locale, `${ns}.json`);
+        let existing = {};
+        try {
+            existing = readJSON(file);
+        }
+        catch {
+            // A new namespace.
+        }
+        return [file, merge(existing, value, `${locale}.${ns}`)];
+    });
+}
+function merge(into, from, at) {
+    for (const [key, value] of Object.entries(from)) {
+        const existing = into[key];
+        const where = at ? `${at}.${key}` : key;
+        if (existing === undefined)
+            into[key] = value;
+        else if (typeof existing === 'object' && typeof value === 'object')
+            merge(existing, value, where);
+        else if (existing !== value)
+            throw new Error(`${where} already exists as ${JSON.stringify(existing)}`);
+    }
+    return into;
+}
+function readJSON(file) {
+    return JSON.parse(readFileSync(file, 'utf8'));
+}
+function writeJSON(file, value) {
+    writeFileSync(file, `${JSON.stringify(value, null, 2)}\n`);
+}
+//# sourceMappingURL=check.js.map

package/dist/check.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"check.js","sourceRoot":"","sources":["../src/check.ts"],"names":[],"mappings":"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"}

package/dist/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":""}

package/dist/cli.js

@@ -0,0 +1,42 @@
+#!/usr/bin/env node
+import { readFileSync } from 'node:fs';
+import path from 'node:path';
+import { add, check, writeIndex } from './check.js';
+const usage = `usage: parallelworks-i18n <command> [--dir <locales>] [--default <locale>]
+
+  check        every locale has the default locale's keys, valid ICU messages
+               and the same arguments; a split locale's index.ts is current
+  index        rewrite the default locale's index.ts (one-file-per-namespace layout)
+  add <file>   merge messages from a JSON file without changing existing ones;
+               the file is one locale's tree, or trees keyed by locale
+
+  --dir      locales directory (default: src/i18n/locales)
+  --default  default locale (default: en)`;
+const args = process.argv.slice(2);
+const flag = (name, fallback) => {
+    const i = args.indexOf(`--${name}`);
+    return i >= 0 && args[i + 1] ? (args[i + 1] ?? fallback) : fallback;
+};
+const dir = path.resolve(flag('dir', 'src/i18n/locales'));
+const defaultLocale = flag('default', 'en');
+const [command, file] = args.filter((a, i) => !a.startsWith('--') && !args[i - 1]?.startsWith('--'));
+if (command === 'check') {
+    const problems = check(dir, defaultLocale);
+    for (const problem of problems)
+        console.error(problem);
+    if (problems.length > 0)
+        process.exitCode = 1;
+    else
+        console.log(`i18n: catalogs in ${path.relative(process.cwd(), dir) || '.'} are consistent`);
+}
+else if (command === 'index') {
+    writeIndex(dir, defaultLocale);
+}
+else if (command === 'add' && file) {
+    add(dir, defaultLocale, JSON.parse(readFileSync(file, 'utf8')));
+}
+else {
+    console.error(usage);
+    process.exitCode = 2;
+}
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAA;AACtC,OAAO,IAAI,MAAM,WAAW,CAAA;AAC5B,OAAO,EAAE,GAAG,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AAEnD,MAAM,KAAK,GAAG;;;;;;;;;0CAS4B,CAAA;AAE1C,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAA;AAClC,MAAM,IAAI,GAAG,CAAC,IAAY,EAAE,QAAgB,EAAE,EAAE;IAC9C,MAAM,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,IAAI,EAAE,CAAC,CAAA;IACnC,OAAO,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAA;AACrE,CAAC,CAAA;AACD,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,EAAE,kBAAkB,CAAC,CAAC,CAAA;AACzD,MAAM,aAAa,GAAG,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,CAAA;AAC3C,MAAM,CAAC,OAAO,EAAE,IAAI,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,UAAU,CAAC,IAAI,CAAC,CAAC,CAAA;AAEpG,IAAI,OAAO,KAAK,OAAO,EAAE,CAAC;IACxB,MAAM,QAAQ,GAAG,KAAK,CAAC,GAAG,EAAE,aAAa,CAAC,CAAA;IAC1C,KAAK,MAAM,OAAO,IAAI,QAAQ;QAAE,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,CAAA;IACtD,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAA;;QACxC,OAAO,CAAC,GAAG,CAAC,qBAAqB,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,GAAG,CAAC,IAAI,GAAG,iBAAiB,CAAC,CAAA;AAClG,CAAC;KAAM,IAAI,OAAO,KAAK,OAAO,EAAE,CAAC;IAC/B,UAAU,CAAC,GAAG,EAAE,aAAa,CAAC,CAAA;AAChC,CAAC;KAAM,IAAI,OAAO,KAAK,KAAK,IAAI,IAAI,EAAE,CAAC;IACrC,GAAG,CAAC,GAAG,EAAE,aAAa,EAAE,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,CAAA;AACjE,CAAC;KAAM,CAAC;IACN,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAA;IACpB,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAA;AACtB,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,23 @@
+/**
+ * The supported locale that best matches preferred, most preferred first (as in
+ * navigator.languages): an exact match, else the same base language, so es-MX
+ * gets es. Returns fallback when nothing matches.
+ */
+export declare function negotiateLocale(preferred: readonly string[], locales: readonly string[], fallback: string): string;
+export interface DetectOptions {
+    /** Returned when nothing else matches. */
+    fallback: string;
+    /** A locale the server chose, such as one it injected into the page. */
+    injected?: string | null | undefined;
+    /** A cookie holding the person's choice. */
+    cookie?: string;
+    /** A localStorage key holding the person's choice. */
+    storageKey?: string;
+}
+/**
+ * The locale to start in: the server's choice, then a stored choice (cookie,
+ * then localStorage), then the browser's languages. Each is negotiated against
+ * locales, so a stored es-MX still finds es.
+ */
+export declare function detectLocale(locales: readonly string[], options: DetectOptions): string;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,wBAAgB,eAAe,CAC7B,SAAS,EAAE,SAAS,MAAM,EAAE,EAC5B,OAAO,EAAE,SAAS,MAAM,EAAE,EAC1B,QAAQ,EAAE,MAAM,GACf,MAAM,CASR;AAUD,MAAM,WAAW,aAAa;IAC5B,0CAA0C;IAC1C,QAAQ,EAAE,MAAM,CAAA;IAChB,wEAAwE;IACxE,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAA;IACpC,4CAA4C;IAC5C,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,sDAAsD;IACtD,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,EAAE,OAAO,EAAE,aAAa,GAAG,MAAM,CAUvF"}

package/dist/index.js

@@ -0,0 +1,64 @@
+/**
+ * The supported locale that best matches preferred, most preferred first (as in
+ * navigator.languages): an exact match, else the same base language, so es-MX
+ * gets es. Returns fallback when nothing matches.
+ */
+export function negotiateLocale(preferred, locales, fallback) {
+    for (const tag of preferred) {
+        const exact = locales.find((l) => l.toLowerCase() === tag.toLowerCase());
+        if (exact)
+            return exact;
+        const base = baseLanguage(tag);
+        const match = base && locales.find((l) => baseLanguage(l) === base);
+        if (match)
+            return match;
+    }
+    return fallback;
+}
+function baseLanguage(tag) {
+    try {
+        return new Intl.Locale(tag).language;
+    }
+    catch {
+        return undefined;
+    }
+}
+/**
+ * The locale to start in: the server's choice, then a stored choice (cookie,
+ * then localStorage), then the browser's languages. Each is negotiated against
+ * locales, so a stored es-MX still finds es.
+ */
+export function detectLocale(locales, options) {
+    const choices = [options.injected, readCookie(options.cookie), readStorage(options.storageKey)];
+    for (const choice of choices) {
+        if (choice) {
+            const match = negotiateLocale([choice], locales, '');
+            if (match)
+                return match;
+        }
+    }
+    const browser = typeof navigator === 'undefined' ? [] : navigator.languages;
+    return negotiateLocale(browser, locales, options.fallback);
+}
+function readCookie(name) {
+    if (!name || typeof document === 'undefined')
+        return undefined;
+    for (const part of document.cookie.split(';')) {
+        const [key, ...value] = part.trim().split('=');
+        if (key === name)
+            return decodeURIComponent(value.join('='));
+    }
+    return undefined;
+}
+function readStorage(key) {
+    if (!key)
+        return undefined;
+    try {
+        return localStorage.getItem(key) ?? undefined;
+    }
+    catch {
+        // Storage blocked, as in some private windows: use the browser's languages.
+        return undefined;
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAC7B,SAA4B,EAC5B,OAA0B,EAC1B,QAAgB;IAEhB,KAAK,MAAM,GAAG,IAAI,SAAS,EAAE,CAAC;QAC5B,MAAM,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,KAAK,GAAG,CAAC,WAAW,EAAE,CAAC,CAAA;QACxE,IAAI,KAAK;YAAE,OAAO,KAAK,CAAA;QACvB,MAAM,IAAI,GAAG,YAAY,CAAC,GAAG,CAAC,CAAA;QAC9B,MAAM,KAAK,GAAG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,YAAY,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,CAAA;QACnE,IAAI,KAAK;YAAE,OAAO,KAAK,CAAA;IACzB,CAAC;IACD,OAAO,QAAQ,CAAA;AACjB,CAAC;AAED,SAAS,YAAY,CAAC,GAAW;IAC/B,IAAI,CAAC;QACH,OAAO,IAAI,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAA;IACtC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAA;IAClB,CAAC;AACH,CAAC;AAaD;;;;GAIG;AACH,MAAM,UAAU,YAAY,CAAC,OAA0B,EAAE,OAAsB;IAC7E,MAAM,OAAO,GAAG,CAAC,OAAO,CAAC,QAAQ,EAAE,UAAU,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAA;IAC/F,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,IAAI,MAAM,EAAE,CAAC;YACX,MAAM,KAAK,GAAG,eAAe,CAAC,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,EAAE,CAAC,CAAA;YACpD,IAAI,KAAK;gBAAE,OAAO,KAAK,CAAA;QACzB,CAAC;IACH,CAAC;IACD,MAAM,OAAO,GAAG,OAAO,SAAS,KAAK,WAAW,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,SAAS,CAAA;IAC3E,OAAO,eAAe,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAA;AAC5D,CAAC;AAED,SAAS,UAAU,CAAC,IAAwB;IAC1C,IAAI,CAAC,IAAI,IAAI,OAAO,QAAQ,KAAK,WAAW;QAAE,OAAO,SAAS,CAAA;IAC9D,KAAK,MAAM,IAAI,IAAI,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC;QAC9C,MAAM,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;QAC9C,IAAI,GAAG,KAAK,IAAI;YAAE,OAAO,kBAAkB,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAA;IAC9D,CAAC;IACD,OAAO,SAAS,CAAA;AAClB,CAAC;AAED,SAAS,WAAW,CAAC,GAAuB;IAC1C,IAAI,CAAC,GAAG;QAAE,OAAO,SAAS,CAAA;IAC1B,IAAI,CAAC;QACH,OAAO,YAAY,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,SAAS,CAAA;IAC/C,CAAC;IAAC,MAAM,CAAC;QACP,4EAA4E;QAC5E,OAAO,SAAS,CAAA;IAClB,CAAC;AACH,CAAC"}

package/dist/node.d.ts

@@ -0,0 +1,3 @@
+export { type CatalogMap, COMMON, flatten, isSplit, listLocales, localeFiles, type Messages, readLocale, selectCatalog, } from './catalogs.js';
+export { add, argumentsOf, check, indexSource, writeIndex } from './check.js';
+//# sourceMappingURL=node.d.ts.map

package/dist/node.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node.d.ts","sourceRoot":"","sources":["../src/node.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,UAAU,EACf,MAAM,EACN,OAAO,EACP,OAAO,EACP,WAAW,EACX,WAAW,EACX,KAAK,QAAQ,EACb,UAAU,EACV,aAAa,GACd,MAAM,eAAe,CAAA;AACtB,OAAO,EAAE,GAAG,EAAE,WAAW,EAAE,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA"}

package/dist/node.js

@@ -0,0 +1,3 @@
+export { COMMON, flatten, isSplit, listLocales, localeFiles, readLocale, selectCatalog, } from './catalogs.js';
+export { add, argumentsOf, check, indexSource, writeIndex } from './check.js';
+//# sourceMappingURL=node.js.map

package/dist/node.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"node.js","sourceRoot":"","sources":["../src/node.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,MAAM,EACN,OAAO,EACP,OAAO,EACP,WAAW,EACX,WAAW,EAEX,UAAU,EACV,aAAa,GACd,MAAM,eAAe,CAAA;AACtB,OAAO,EAAE,GAAG,EAAE,WAAW,EAAE,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA"}

package/dist/react.d.ts

@@ -0,0 +1,34 @@
+import { type ReactNode } from 'react';
+import { type AbstractIntlMessages } from 'use-intl';
+/**
+ * Loads a locale's messages: the ones every page needs, or with catalog, one
+ * feature's, loaded only where that feature is shown. The Vite plugin in
+ * @parallelworks/i18n/vite generates one.
+ */
+export type LoadMessages = (locale: string, catalog?: string) => Promise<AbstractIntlMessages>;
+/** Switches the app's language; resolves once the new messages are shown. */
+export declare function useSetLocale(): (locale: string) => Promise<void>;
+export declare function LocaleProvider({ initial, load, fallbackLocale, onChange, timeZone, children, }: {
+    initial: {
+        locale: string;
+        messages: AbstractIntlMessages;
+    };
+    load: LoadMessages;
+    /** Loaded instead when a locale's messages fail to load. */
+    fallbackLocale?: string;
+    /** Runs after the language changes: store the choice, update a date library's locale. */
+    onChange?: (locale: string) => void;
+    /** For formatting dates and times; the browser's own by default. */
+    timeZone?: string;
+    children: ReactNode;
+}): import("react").JSX.Element;
+/**
+ * Adds one feature's messages to everything beneath it, loading them for the
+ * current language first. fallback shows while they load.
+ */
+export declare function Catalog({ name, fallback, children, }: {
+    name: string;
+    fallback?: ReactNode;
+    children: ReactNode;
+}): import("react").JSX.Element;
+//# sourceMappingURL=react.d.ts.map

package/dist/react.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"react.d.ts","sourceRoot":"","sources":["../src/react.tsx"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,SAAS,EAUf,MAAM,OAAO,CAAA;AACd,OAAO,EAAE,KAAK,oBAAoB,EAAwC,MAAM,UAAU,CAAA;AAE1F;;;;GAIG;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,oBAAoB,CAAC,CAAA;AAe9F,6EAA6E;AAC7E,wBAAgB,YAAY,IAAI,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAEhE;AAID,wBAAgB,cAAc,CAAC,EAC7B,OAAO,EACP,IAAI,EACJ,cAAc,EACd,QAAQ,EACR,QAA0B,EAC1B,QAAQ,GACT,EAAE;IACD,OAAO,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,oBAAoB,CAAA;KAAE,CAAA;IAC3D,IAAI,EAAE,YAAY,CAAA;IAClB,4DAA4D;IAC5D,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,yFAAyF;IACzF,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAA;IACnC,oEAAoE;IACpE,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,QAAQ,EAAE,SAAS,CAAA;CACpB,+BA4BA;AAED;;;GAGG;AACH,wBAAgB,OAAO,CAAC,EACtB,IAAI,EACJ,QAAe,EACf,QAAQ,GACT,EAAE;IACD,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,CAAC,EAAE,SAAS,CAAA;IACpB,QAAQ,EAAE,SAAS,CAAA;CACpB,+BAMA"}

package/dist/react.js

@@ -0,0 +1,68 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { createContext, Suspense, startTransition, use, useCallback, useContext, useEffect, useMemo, useRef, useState, } from 'react';
+import { IntlProvider, useLocale, useMessages } from 'use-intl';
+const LocalesContext = createContext(null);
+function useLocales() {
+    const locales = useContext(LocalesContext);
+    if (!locales)
+        throw new Error('@parallelworks/i18n: wrap the app in <LocaleProvider>');
+    return locales;
+}
+/** Switches the app's language; resolves once the new messages are shown. */
+export function useSetLocale() {
+    return useLocales().setLocale;
+}
+const browserTimeZone = Intl.DateTimeFormat().resolvedOptions().timeZone;
+export function LocaleProvider({ initial, load, fallbackLocale, onChange, timeZone = browserTimeZone, children, }) {
+    const [current, setCurrent] = useState(initial);
+    const cached = useMemo(() => cache(load, fallbackLocale), [load, fallbackLocale]);
+    const latest = useRef(0);
+    const setLocale = useCallback(async (locale) => {
+        const request = ++latest.current;
+        const messages = await cached(locale);
+        if (request !== latest.current)
+            return; // a later choice won
+        startTransition(() => setCurrent({ locale, messages }));
+        onChange?.(locale);
+    }, [cached, onChange]);
+    useEffect(() => {
+        document.documentElement.lang = current.locale;
+    }, [current.locale]);
+    const value = useMemo(() => ({ setLocale, load: cached }), [setLocale, cached]);
+    return (_jsx(LocalesContext, { value: value, children: _jsx(IntlProvider, { locale: current.locale, messages: current.messages, timeZone: timeZone, children: children }) }));
+}
+/**
+ * Adds one feature's messages to everything beneath it, loading them for the
+ * current language first. fallback shows while they load.
+ */
+export function Catalog({ name, fallback = null, children, }) {
+    return (_jsx(Suspense, { fallback: fallback, children: _jsx(CatalogMessages, { name: name, children: children }) }));
+}
+function CatalogMessages({ name, children }) {
+    const locale = useLocale();
+    const shared = useMessages();
+    const feature = use(useLocales().load(locale, name));
+    const messages = useMemo(() => ({ ...shared, ...feature }), [shared, feature]);
+    return (_jsx(IntlProvider, { locale: locale, messages: messages, children: children }));
+}
+/** Keeps one promise per locale and catalog, so use() sees the same one each render. */
+function cache(load, fallbackLocale) {
+    const pending = new Map();
+    const cached = (locale, catalog) => {
+        const key = `${locale}/${catalog ?? ''}`;
+        let promise = pending.get(key);
+        if (!promise) {
+            promise = load(locale, catalog).catch((error) => {
+                if (fallbackLocale && locale !== fallbackLocale)
+                    return cached(fallbackLocale, catalog);
+                // Forget the failure so the next render tries again.
+                pending.delete(key);
+                throw error;
+            });
+            pending.set(key, promise);
+        }
+        return promise;
+    };
+    return cached;
+}
+//# sourceMappingURL=react.js.map

package/dist/react.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"react.js","sourceRoot":"","sources":["../src/react.tsx"],"names":[],"mappings":"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"}

package/dist/vite.d.ts

@@ -0,0 +1,17 @@
+import type { Plugin } from 'vite';
+import { type CatalogMap } from './catalogs.js';
+export interface I18nOptions {
+    /** The locales directory, relative to the Vite root. */
+    dir: string;
+    /** The locale whose common messages are bundled with the app, and the fallback. */
+    defaultLocale: string;
+    /** Feature catalogs, loaded only where <Catalog name=...> is rendered. */
+    catalogs?: CatalogMap;
+}
+/**
+ * Serves `virtual:i18n`: `locales`, `defaultLocale`, `defaultMessages` (bundled)
+ * and `loadMessages(locale, catalog?)`, which loads every other locale and
+ * catalog as its own chunk. Add `@parallelworks/i18n/client` to tsconfig types.
+ */
+export declare function i18n(options: I18nOptions): Plugin;
+//# sourceMappingURL=vite.d.ts.map

package/dist/vite.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vite.d.ts","sourceRoot":"","sources":["../src/vite.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,MAAM,CAAA;AAClC,OAAO,EACL,KAAK,UAAU,EAMhB,MAAM,eAAe,CAAA;AAKtB,MAAM,WAAW,WAAW;IAC1B,wDAAwD;IACxD,GAAG,EAAE,MAAM,CAAA;IACX,mFAAmF;IACnF,aAAa,EAAE,MAAM,CAAA;IACrB,0EAA0E;IAC1E,QAAQ,CAAC,EAAE,UAAU,CAAA;CACtB;AAED;;;;GAIG;AACH,wBAAgB,IAAI,CAAC,OAAO,EAAE,WAAW,GAAG,MAAM,CA4DjD"}

package/dist/vite.js

@@ -0,0 +1,70 @@
+import path from 'node:path';
+import { COMMON, listLocales, localeFiles, readLocale, selectCatalog, } from './catalogs.js';
+const id = 'virtual:i18n';
+const resolved = `\0${id}`;
+/**
+ * Serves `virtual:i18n`: `locales`, `defaultLocale`, `defaultMessages` (bundled)
+ * and `loadMessages(locale, catalog?)`, which loads every other locale and
+ * catalog as its own chunk. Add `@parallelworks/i18n/client` to tsconfig types.
+ */
+export function i18n(options) {
+    const catalogs = options.catalogs ?? {};
+    const names = [COMMON, ...Object.keys(catalogs)];
+    let dir = '';
+    let locales = [];
+    return {
+        name: '@parallelworks/i18n',
+        configResolved(config) {
+            dir = path.resolve(config.root, options.dir);
+            locales = listLocales(dir);
+            if (!locales.includes(options.defaultLocale)) {
+                throw new Error(`@parallelworks/i18n: no ${options.defaultLocale} messages in ${dir}`);
+            }
+        },
+        resolveId(source) {
+            return source === id || source.startsWith(`${id}/`) ? `\0${source}` : undefined;
+        },
+        load(source) {
+            if (source === resolved) {
+                const loaders = locales.map((locale) => `${JSON.stringify(locale)}: {${names
+                    .map((name) => 
+                // The default locale's common messages are already bundled.
+                locale === options.defaultLocale && name === COMMON
+                    ? `${JSON.stringify(name)}: () => Promise.resolve({ default: defaultMessages })`
+                    : `${JSON.stringify(name)}: () => import(${JSON.stringify(`${id}/${locale}/${name}`)})`)
+                    .join(',')}}`);
+                return `import defaultMessages from ${JSON.stringify(`${id}/${options.defaultLocale}/${COMMON}`)}
+export { defaultMessages }
+export const defaultLocale = ${JSON.stringify(options.defaultLocale)}
+export const locales = ${JSON.stringify(locales)}
+const loaders = {${loaders.join(',')}}
+export function loadMessages(locale, catalog = ${JSON.stringify(COMMON)}) {
+  const load = loaders[locale]?.[catalog]
+  if (!load) return Promise.reject(new Error('no messages for ' + locale + '/' + catalog))
+  return load().then((m) => m.default)
+}`;
+            }
+            if (!source.startsWith(`${resolved}/`))
+                return undefined;
+            const [locale = '', name = ''] = source.slice(resolved.length + 1).split('/');
+            if (!locales.includes(locale) || !names.includes(name)) {
+                this.error(`unknown message catalog ${locale}/${name}`);
+            }
+            for (const file of localeFiles(dir, locale))
+                this.addWatchFile(file);
+            const messages = selectCatalog(readLocale(dir, locale), name, catalogs);
+            return `export default ${JSON.stringify(messages)}`;
+        },
+        handleHotUpdate({ file, server }) {
+            if (!file.startsWith(`${dir}${path.sep}`) || !file.endsWith('.json'))
+                return undefined;
+            for (const module of server.moduleGraph.idToModuleMap.values()) {
+                if (module.id?.startsWith(resolved))
+                    server.moduleGraph.invalidateModule(module);
+            }
+            server.ws.send({ type: 'full-reload' });
+            return [];
+        },
+    };
+}
+//# sourceMappingURL=vite.js.map

package/dist/vite.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vite.js","sourceRoot":"","sources":["../src/vite.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAA;AAE5B,OAAO,EAEL,MAAM,EACN,WAAW,EACX,WAAW,EACX,UAAU,EACV,aAAa,GACd,MAAM,eAAe,CAAA;AAEtB,MAAM,EAAE,GAAG,cAAc,CAAA;AACzB,MAAM,QAAQ,GAAG,KAAK,EAAE,EAAE,CAAA;AAW1B;;;;GAIG;AACH,MAAM,UAAU,IAAI,CAAC,OAAoB;IACvC,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,EAAE,CAAA;IACvC,MAAM,KAAK,GAAG,CAAC,MAAM,EAAE,GAAG,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAA;IAChD,IAAI,GAAG,GAAG,EAAE,CAAA;IACZ,IAAI,OAAO,GAAa,EAAE,CAAA;IAE1B,OAAO;QACL,IAAI,EAAE,qBAAqB;QAC3B,cAAc,CAAC,MAAM;YACnB,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,GAAG,CAAC,CAAA;YAC5C,OAAO,GAAG,WAAW,CAAC,GAAG,CAAC,CAAA;YAC1B,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,aAAa,CAAC,EAAE,CAAC;gBAC7C,MAAM,IAAI,KAAK,CAAC,2BAA2B,OAAO,CAAC,aAAa,gBAAgB,GAAG,EAAE,CAAC,CAAA;YACxF,CAAC;QACH,CAAC;QACD,SAAS,CAAC,MAAM;YACd,OAAO,MAAM,KAAK,EAAE,IAAI,MAAM,CAAC,UAAU,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,MAAM,EAAE,CAAC,CAAC,CAAC,SAAS,CAAA;QACjF,CAAC;QACD,IAAI,CAAC,MAAM;YACT,IAAI,MAAM,KAAK,QAAQ,EAAE,CAAC;gBACxB,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CACzB,CAAC,MAAM,EAAE,EAAE,CACT,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,MAAM,KAAK;qBACjC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;gBACZ,4DAA4D;gBAC5D,MAAM,KAAK,OAAO,CAAC,aAAa,IAAI,IAAI,KAAK,MAAM;oBACjD,CAAC,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,uDAAuD;oBAChF,CAAC,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,kBAAkB,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE,IAAI,MAAM,IAAI,IAAI,EAAE,CAAC,GAAG,CAC1F;qBACA,IAAI,CAAC,GAAG,CAAC,GAAG,CAClB,CAAA;gBACD,OAAO,+BAA+B,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE,IAAI,OAAO,CAAC,aAAa,IAAI,MAAM,EAAE,CAAC;;+BAEzE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,aAAa,CAAC;yBAC3C,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC;mBAC7B,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC;iDACa,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC;;;;EAIrE,CAAA;YACI,CAAC;YACD,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,GAAG,QAAQ,GAAG,CAAC;gBAAE,OAAO,SAAS,CAAA;YACxD,MAAM,CAAC,MAAM,GAAG,EAAE,EAAE,IAAI,GAAG,EAAE,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;YAC7E,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;gBACvD,IAAI,CAAC,KAAK,CAAC,2BAA2B,MAAM,IAAI,IAAI,EAAE,CAAC,CAAA;YACzD,CAAC;YACD,KAAK,MAAM,IAAI,IAAI,WAAW,CAAC,GAAG,EAAE,MAAM,CAAC;gBAAE,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,CAAA;YACpE,MAAM,QAAQ,GAAG,aAAa,CAAC,UAAU,CAAC,GAAG,EAAE,MAAM,CAAC,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAA;YACvE,OAAO,kBAAkB,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,EAAE,CAAA;QACrD,CAAC;QACD,eAAe,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE;YAC9B,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC;gBAAE,OAAO,SAAS,CAAA;YACtF,KAAK,MAAM,MAAM,IAAI,MAAM,CAAC,WAAW,CAAC,aAAa,CAAC,MAAM,EAAE,EAAE,CAAC;gBAC/D,IAAI,MAAM,CAAC,EAAE,EAAE,UAAU,CAAC,QAAQ,CAAC;oBAAE,MAAM,CAAC,WAAW,CAAC,gBAAgB,CAAC,MAAM,CAAC,CAAA;YAClF,CAAC;YACD,MAAM,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,aAAa,EAAE,CAAC,CAAA;YACvC,OAAO,EAAE,CAAA;QACX,CAAC;KACF,CAAA;AACH,CAAC"}

package/package.json

@@ -1,6 +1,80 @@
 {
   "name": "@parallelworks/i18n",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.1.1",
+  "description": "Localization for React apps on use-intl: locale negotiation, a provider, lazily loaded catalogs and catalog checks",
+  "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/parallelworks/foundation.git",
+    "directory": "packages/i18n"
+  },
+  "type": "module",
+  "sideEffects": false,
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./react": {
+      "types": "./dist/react.d.ts",
+      "default": "./dist/react.js"
+    },
+    "./vite": {
+      "types": "./dist/vite.d.ts",
+      "default": "./dist/vite.js"
+    },
+    "./node": {
+      "types": "./dist/node.d.ts",
+      "default": "./dist/node.js"
+    },
+    "./client": {
+      "types": "./client.d.ts"
+    }
+  },
+  "bin": {
+    "parallelworks-i18n": "./dist/cli.js"
+  },
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org",
+    "access": "public"
+  },
+  "files": [
+    "dist",
+    "client.d.ts"
+  ],
+  "dependencies": {
+    "@formatjs/icu-messageformat-parser": "^3.5.20"
+  },
+  "peerDependencies": {
+    "react": "^19.0.0",
+    "use-intl": "^4.0.0",
+    "vite": ">=6.0.0"
+  },
+  "peerDependenciesMeta": {
+    "react": {
+      "optional": true
+    },
+    "use-intl": {
+      "optional": true
+    },
+    "vite": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@types/node": "^26.6.3",
+    "@types/react": "^19.2.0",
+    "@types/react-dom": "^19.2.0",
+    "react": "^19.3.0",
+    "react-dom": "^19.3.0",
+    "typescript": "^7.0.2",
+    "use-intl": "^4.13.0",
+    "vite": "^8.0.0",
+    "vitest": "^4.1.8"
+  },
+  "scripts": {
+    "build": "rm -rf dist && tsc -p tsconfig.build.json",
+    "typecheck": "tsc -p tsconfig.json",
+    "test": "vitest run"
+  }
 }