@zerolith/i18n 0.1.0-alpha.5 → 0.1.0-alpha.6

package/dist/cli.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AA6DA,2EAA2E;AAC3E,wBAAsB,IAAI,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAwDnE"}
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AAsGA,2EAA2E;AAC3E,wBAAsB,IAAI,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CA8EnE"}

package/dist/cli.js

@@ -9,6 +9,36 @@ import { basename, join } from "node:path";
 import process from "node:process";
 import { compileIndex, compileMessages, messageNames } from "./compile.js";
 const USAGE = "usage: zerolith-i18n <folder> [--out <folder>] [--js] [--strict]\n";
+/** The locale a catalog's file name gives, refusing a name that is not a BCP 47 language tag, such as `en_US.json`. */
+function localeOf(file) {
+    const locale = basename(file, ".json");
+    try {
+        Intl.getCanonicalLocales(locale);
+    }
+    catch {
+        throw new Error(`${locale} is not a language tag; name the file as en.json or pt-BR.json`);
+    }
+    return locale;
+}
+/** A catalog's messages, refusing a file that is not a JSON object of strings. */
+function catalogOf(text) {
+    const parsed = JSON.parse(text);
+    if (parsed === null || typeof parsed !== "object" || Array.isArray(parsed)) {
+        throw new Error("a catalog is a JSON object of messages");
+    }
+    for (const [key, value] of Object.entries(parsed)) {
+        if (typeof value !== "string") {
+            throw new Error(`the message "${key}" is not a string`);
+        }
+    }
+    return parsed;
+}
+/** Reports why a catalog cannot be compiled, naming its file, and gives the exit code; nothing has been written. */
+function failure(file, error) {
+    const message = error instanceof Error ? error.message.replace(/^zerolith\/i18n: /, "") : String(error);
+    process.stderr.write(`zerolith-i18n: ${file}: ${message}\n`);
+    return 1;
+}
 function parse(argv) {
     const parsed = { folder: undefined, out: undefined, javascript: false, strict: false };
     for (let index = 0; index < argv.length; index++) {
@@ -59,10 +89,21 @@ export async function main(argv) {
         return 1;
     }
     const out = parsed.out ?? parsed.folder;
-    await mkdir(out, { recursive: true });
     const language = parsed.javascript ? "js" : "ts";
     const folder = parsed.folder;
-    const catalogs = new Map(await Promise.all(files.map(async (file) => [basename(file, ".json"), JSON.parse(await readFile(join(folder, file), "utf8"))])));
+    const read = await Promise.all(files.map(async (file) => {
+        try {
+            return { file, locale: localeOf(file), catalog: catalogOf(await readFile(join(folder, file), "utf8")) };
+        }
+        catch (error) {
+            return { file, error };
+        }
+    }));
+    const unreadable = read.find((entry) => "error" in entry);
+    if (unreadable !== undefined) {
+        return failure(unreadable.file, unreadable.error);
+    }
+    const catalogs = new Map(read.map((entry) => [entry.locale ?? "", entry.catalog ?? {}]));
     const all = new Set();
     for (const catalog of catalogs.values()) {
         for (const name of messageNames(catalog)) {
@@ -70,7 +111,7 @@ export async function main(argv) {
         }
     }
     let missing = 0;
-    const writes = [];
+    const modules = new Map();
     for (const [locale, catalog] of catalogs) {
         const present = new Set(messageNames(catalog));
         for (const name of all) {
@@ -79,11 +120,16 @@ export async function main(argv) {
                 process.stderr.write(`zerolith-i18n: ${locale} lacks ${name}\n`);
             }
         }
-        const compiled = compileMessages(locale, catalog, { language, source: `${locale}.json` });
-        writes.push(writeFile(join(out, `${locale}.${language}`), compiled.code));
+        try {
+            modules.set(`${locale}.${language}`, compileMessages(locale, catalog, { language, source: `${locale}.json` }).code);
+        }
+        catch (error) {
+            return failure(`${locale}.json`, error);
+        }
     }
-    writes.push(writeFile(join(out, `index.${language}`), compileIndex([...catalogs.keys()], { language })));
-    await Promise.all(writes);
+    modules.set(`index.${language}`, compileIndex([...catalogs.keys()], { language }));
+    await mkdir(out, { recursive: true });
+    await Promise.all([...modules].map(([name, code]) => writeFile(join(out, name), code)));
     process.stdout.write(`zerolith-i18n: ${catalogs.size} locale(s), ${all.size} message(s), written to ${out}\n`);
     return missing > 0 && parsed.strict ? 1 : 0;
 }

package/dist/cli.js.map

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

package/dist/compile.d.ts

@@ -20,6 +20,7 @@ export interface CompileOptions {
 }
 /** The result of compiling one catalog. */
 export interface CompiledCatalog {
+    /** The generated module's source, TypeScript or JavaScript as the `language` option chose; the `zerolith-i18n` CLI writes it to `<locale>.ts` or `<locale>.js`. */
     code: string;
     /** The message keys as function names, in source order. */
     names: string[];
@@ -28,7 +29,11 @@ export interface CompiledCatalog {
  * Compiles one locale's catalog into a module: `locale`, one exported
  * function per message named from its key, and the `Intl` helpers they
  * share. Each function takes an `args` object typed from the message's
- * placeholders, or nothing when the message has none.
+ * placeholders, or nothing when the message has none. A formatter whose
+ * options are all literals is a module-level binding created on first use
+ * and shared by every message that formats the same way; options that read
+ * an argument find their formatter in a cache keyed by the options. Only
+ * the helpers the messages use are written.
  */
 export declare function compileMessages(locale: string, catalog: Catalog, options?: CompileOptions): CompiledCatalog;
 /** The keys of a catalog as function names, for comparing locales. */

package/dist/compile.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"compile.d.ts","sourceRoot":"","sources":["../src/compile.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,wDAAwD;AACxD,MAAM,MAAM,OAAO,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;AAEvD,qCAAqC;AACrC,MAAM,WAAW,cAAc;IAE3B,0GAA0G;IAC1G,QAAQ,CAAC,EAAE,IAAI,GAAG,IAAI,CAAC;IACvB,qCAAqC;IACrC,MAAM,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,2CAA2C;AAC3C,MAAM,WAAW,eAAe;IAE5B,IAAI,EAAE,MAAM,CAAC;IACb,2DAA2D;IAC3D,KAAK,EAAE,MAAM,EAAE,CAAC;CACnB;AA4zBD;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,GAAE,cAAmB,GAAG,eAAe,CAkD/G;AAED,sEAAsE;AACtE,wBAAgB,YAAY,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,EAAE,CAGvD;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,EAAE,OAAO,GAAE,cAAmB,GAAG,MAAM,CAsB7F"}
+{"version":3,"file":"compile.d.ts","sourceRoot":"","sources":["../src/compile.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,wDAAwD;AACxD,MAAM,MAAM,OAAO,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;AAEvD,qCAAqC;AACrC,MAAM,WAAW,cAAc;IAE3B,0GAA0G;IAC1G,QAAQ,CAAC,EAAE,IAAI,GAAG,IAAI,CAAC;IACvB,qCAAqC;IACrC,MAAM,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,2CAA2C;AAC3C,MAAM,WAAW,eAAe;IAE5B,mKAAmK;IACnK,IAAI,EAAE,MAAM,CAAC;IACb,2DAA2D;IAC3D,KAAK,EAAE,MAAM,EAAE,CAAC;CACnB;AAy4BD;;;;;;;;;GASG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,GAAE,cAAmB,GAAG,eAAe,CA+D/G;AAED,sEAAsE;AACtE,wBAAgB,YAAY,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,EAAE,CAGvD;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,EAAE,OAAO,GAAE,cAAmB,GAAG,MAAM,CAsB7F"}

package/dist/compile.js

@@ -279,6 +279,14 @@ const NUMBER_OPTIONS = {
     currencySign: "currencySign",
     numberingSystem: "numberingSystem"
 };
+/** Names a module cannot bind; a message named so is exported under its name from a binding of its own. */
+const RESERVED = new Set(["arguments", "await", "break", "case", "catch", "class", "const", "continue", "debugger", "default", "delete", "do", "else", "enum", "eval", "export", "extends", "false", "finally", "for", "function", "if", "implements", "import", "in", "instanceof", "interface", "let", "new", "null", "package", "private", "protected", "public", "return", "static", "super", "switch", "this", "throw", "true", "try", "typeof", "var", "void", "while", "with", "yield"]);
+/** An argument or local name JavaScript can write as it is; MessageFormat also allows `-` and `.`, as in `$first-name`. */
+const PLAIN_NAME = /^[A-Za-z_][A-Za-z0-9_]*$/;
+/** A property name as code: as it is when plain, quoted otherwise. */
+function property(name) {
+    return PLAIN_NAME.test(name) ? name : JSON.stringify(name);
+}
 function identifier(key) {
     const words = key.replace(/([a-z0-9])([A-Z])/g, "$1 $2").split(/[^A-Za-z0-9]+/).filter((word) => word !== "");
     const name = words.map((word, index) => (index === 0 ? word.charAt(0).toLowerCase() + word.slice(1) : word.charAt(0).toUpperCase() + word.slice(1))).join("");
@@ -290,14 +298,30 @@ class Emitter {
     prelude = [];
     key;
     message;
-    constructor(key, message) {
+    formatters;
+    used;
+    reads = 0;
+    constructor(key, message, formatters, used) {
         this.key = key;
         this.message = message;
+        this.formatters = formatters;
+        this.used = used;
+    }
+    /** The module-level binding of a formatter whose options are known at compile time, created on first use and shared by every message that creates it the same way. */
+    shared(create) {
+        this.used.add("once");
+        let binding = this.formatters.get(create);
+        if (binding === undefined) {
+            binding = `$f${this.formatters.size}`;
+            this.formatters.set(create, binding);
+        }
+        return binding;
     }
     fail(text) {
         throw new Error(`zerolith/i18n: message "${this.key}": ${text}`);
     }
     argument(name, type) {
+        this.reads++;
         const local = this.locals.get(name);
         if (local !== undefined) {
             return local;
@@ -309,7 +333,7 @@ class Emitter {
         else if (existing !== type && type !== "string") {
             this.fail(`$${name} is used both as ${existing} and as ${type}`);
         }
-        return `args.${name}`;
+        return PLAIN_NAME.test(name) ? `args.${name}` : `args[${JSON.stringify(name)}]`;
     }
     optionValue(value) {
         if (value === undefined) {
@@ -347,7 +371,7 @@ class Emitter {
                 entries.push(`minimumFractionDigits: ${value.value}`, `maximumFractionDigits: ${value.value}`);
             }
         }
-        return `{ ${entries.join(", ")} }`;
+        return entries.length === 0 ? "{}" : `{ ${entries.join(", ")} }`;
     }
     dateOptions(expression) {
         const entries = [];
@@ -376,7 +400,7 @@ class Emitter {
         if (style !== undefined) {
             entries.push(`timeZoneName: ${JSON.stringify(style)}`);
         }
-        return `{ ${entries.join(", ")} }`;
+        return entries.length === 0 ? "{}" : `{ ${entries.join(", ")} }`;
     }
     /** The JavaScript for an expression's numeric value, before formatting. */
     numeric(expression) {
@@ -401,11 +425,11 @@ class Emitter {
         }
         return value;
     }
-    /** Resolves a plain `{$x}` to its declaration when one exists. */
-    resolve(expression) {
+    /** Resolves a plain `{$x}` to its `.input` declaration when one exists, or with `locals` to its `.local` one too, so a selector on a local selects as its expression does. */
+    resolve(expression, locals = false) {
         if (expression.fn === undefined && expression.operand?.kind === "variable") {
             const declared = this.message.declarations.get(expression.operand.name);
-            if (declared !== undefined && !declared.local) {
+            if (declared !== undefined && (locals || !declared.local)) {
                 return declared.expression;
             }
         }
@@ -423,7 +447,14 @@ class Emitter {
             return operand.kind === "literal" ? JSON.stringify(operand.value) : `String(${this.argument(operand.name, "string")})`;
         }
         if (NUMBER_FUNCTIONS.has(fn)) {
-            return `number(${this.numeric(expression)}, ${this.numberOptions(expression)})`;
+            const value = this.numeric(expression);
+            const reads = this.reads;
+            const options = this.numberOptions(expression);
+            if (this.reads === reads) {
+                return `${this.shared(`new Intl.NumberFormat(locale, ${options})`)}().format(${value})`;
+            }
+            this.used.add("number");
+            return `$number(${value}, ${options})`;
         }
         if (DATE_FUNCTIONS.has(fn)) {
             const operand = expression.operand;
@@ -431,13 +462,13 @@ class Emitter {
                 this.fail(`:${fn} needs an operand`);
             }
             const value = operand.kind === "literal" ? `new Date(${JSON.stringify(operand.value)})` : this.argument(operand.name, "date");
-            return `date(${value}, ${this.dateOptions(expression)})`;
+            return `${this.shared(`new Intl.DateTimeFormat(locale, ${this.dateOptions(expression)})`)}().format(${value})`;
         }
         this.fail(`unknown function :${fn}`);
     }
     /** The JavaScript for a selector: its comparable value and the categories it matches. */
     selector(raw) {
-        const expression = this.resolve(raw);
+        const expression = this.resolve(raw, true);
         const fn = expression.fn ?? "string";
         if (NUMBER_FUNCTIONS.has(fn)) {
             const select = expression.options["select"];
@@ -446,7 +477,14 @@ class Emitter {
             if (mode === "exact") {
                 return `{ value: String(${value}), categories: [] }`;
             }
-            return `{ value: String(${value}), categories: [plural(${value}, ${JSON.stringify(mode === "ordinal" ? "ordinal" : "cardinal")})] }`;
+            const type = JSON.stringify(mode === "ordinal" ? "ordinal" : "cardinal");
+            const reads = this.reads;
+            const options = this.numberOptions(expression);
+            if (this.reads === reads) {
+                return `{ value: String(${value}), categories: [${this.shared(`new Intl.PluralRules(locale, { ...new Intl.NumberFormat(locale, ${options}).resolvedOptions(), type: ${type} })`)}().select(${value})] }`;
+            }
+            this.used.add("plural");
+            return `{ value: String(${value}), categories: [$plural(${value}, ${type}, ${options})] }`;
         }
         if (fn === "string") {
             const operand = expression.operand;
@@ -468,8 +506,9 @@ class Emitter {
         for (const [name, declaration] of this.message.declarations) {
             if (declaration.local) {
                 const value = this.format(declaration.expression);
-                this.locals.set(name, `local_${name}`);
-                this.prelude.push(`const local_${name} = ${value};`);
+                const binding = PLAIN_NAME.test(name) ? `local_${name}` : `local_${this.locals.size}`;
+                this.locals.set(name, binding);
+                this.prelude.push(`const ${binding} = ${value};`);
             }
         }
         if (this.message.pattern !== undefined) {
@@ -477,34 +516,72 @@ class Emitter {
         }
         const selectors = this.message.selectors.map((selector) => this.selector(selector));
         const variants = this.message.variants.map((variant) => `{ keys: ${JSON.stringify(variant.keys)}, pattern: () => ${this.pattern(variant.pattern)} }`);
-        return `select([${selectors.join(", ")}], [${variants.join(", ")}])`;
+        this.used.add("select");
+        return `$select([${selectors.join(", ")}], [${variants.join(", ")}])`;
     }
 }
-const HELPERS = `const formats = new Map();
-function cached(kind, options, create)
+/** The helpers in JavaScript and in TypeScript, in the order a module writes them. */
+const HELPERS = {
+    cache: {
+        js: `const $formats = new Map();
+function $cached(kind, options, create)
 {
     const key = kind + JSON.stringify(options);
-    let instance = formats.get(key);
+    let instance = $formats.get(key);
     if (instance === undefined)
     {
         instance = create();
-        formats.set(key, instance);
+        $formats.set(key, instance);
     }
     return instance;
-}
-function number(value, options)
+}`,
+        ts: `const $formats: Map<string, unknown> = new Map();
+function $cached<T>(kind: string, options: object, create: () => T): T
 {
-    return cached("n", options, () => new Intl.NumberFormat(locale, options)).format(value);
-}
-function date(value, options)
+    const key = kind + JSON.stringify(options);
+    let instance = $formats.get(key) as T | undefined;
+    if (instance === undefined)
+    {
+        instance = create();
+        $formats.set(key, instance);
+    }
+    return instance;
+}`
+    },
+    once: {
+        js: `function $once(create)
 {
-    return cached("d", options, () => new Intl.DateTimeFormat(locale, options)).format(value);
-}
-function plural(value, type)
+    let instance;
+    return () => (instance ??= create());
+}`,
+        ts: `function $once<T>(create: () => T): () => T
 {
-    return cached("p", { type }, () => new Intl.PluralRules(locale, { type })).select(value);
-}
-function select(selectors, variants)
+    let instance: T | undefined;
+    return () => (instance ??= create());
+}`
+    },
+    number: {
+        js: `function $number(value, options)
+{
+    return $cached("n", options, () => new Intl.NumberFormat(locale, options)).format(value);
+}`,
+        ts: `function $number(value: number, options: Intl.NumberFormatOptions): string
+{
+    return $cached("n", options, () => new Intl.NumberFormat(locale, options)).format(value);
+}`
+    },
+    plural: {
+        js: `function $plural(value, type, options)
+{
+    return $cached("p" + type, options, () => new Intl.PluralRules(locale, { ...$cached("n", options, () => new Intl.NumberFormat(locale, options)).resolvedOptions(), type })).select(value);
+}`,
+        ts: `function $plural(value: number, type: "cardinal" | "ordinal", options: Intl.NumberFormatOptions): string
+{
+    return $cached("p" + type, options, () => new Intl.PluralRules(locale, { ...$cached("n", options, () => new Intl.NumberFormat(locale, options)).resolvedOptions(), type })).select(value);
+}`
+    },
+    select: {
+        js: `function $select(selectors, variants)
 {
     let best;
     let bestRank;
@@ -537,7 +614,7 @@ function select(selectors, variants)
         {
             continue;
         }
-        if (matches && better(rank, bestRank))
+        if (matches && $better(rank, bestRank))
         {
             best = variant;
             bestRank = rank;
@@ -545,7 +622,7 @@ function select(selectors, variants)
     }
     return best === undefined ? "" : best.pattern();
 }
-function better(rank, current)
+function $better(rank, current)
 {
     if (current === undefined)
     {
@@ -560,8 +637,8 @@ function better(rank, current)
         }
     }
     return false;
-}`;
-const HELPERS_TS = `interface Selector
+}`,
+        ts: `interface Selector
 {
     value: string;
     categories: string[];
@@ -571,31 +648,7 @@ interface Variant
     keys: string[];
     pattern: () => string;
 }
-const formats: Map<string, unknown> = new Map();
-function cached<T>(kind: string, options: object, create: () => T): T
-{
-    const key = kind + JSON.stringify(options);
-    let instance = formats.get(key) as T | undefined;
-    if (instance === undefined)
-    {
-        instance = create();
-        formats.set(key, instance);
-    }
-    return instance;
-}
-function number(value: number, options: Intl.NumberFormatOptions): string
-{
-    return cached("n", options, () => new Intl.NumberFormat(locale, options)).format(value);
-}
-function date(value: Date | number, options: Intl.DateTimeFormatOptions): string
-{
-    return cached("d", options, () => new Intl.DateTimeFormat(locale, options)).format(value);
-}
-function plural(value: number, type: "cardinal" | "ordinal"): string
-{
-    return cached("p", { type }, () => new Intl.PluralRules(locale, { type })).select(value);
-}
-function better(rank: number[], current: number[] | undefined): boolean
+function $better(rank: number[], current: number[] | undefined): boolean
 {
     if (current === undefined)
     {
@@ -611,7 +664,7 @@ function better(rank: number[], current: number[] | undefined): boolean
     }
     return false;
 }
-function select(selectors: Selector[], variants: Variant[]): string
+function $select(selectors: Selector[], variants: Variant[]): string
 {
     let best: Variant | undefined;
     let bestRank: number[] | undefined;
@@ -640,14 +693,24 @@ function select(selectors: Selector[], variants: Variant[]): string
                 break;
             }
         }
-        if (matches && better(rank, bestRank))
+        if (matches && $better(rank, bestRank))
         {
             best = variant;
             bestRank = rank;
         }
     }
     return best === undefined ? "" : best.pattern();
-}`;
+}`
+    }
+};
+/** The helpers a module's messages use, with the cache that `$number` and `$plural` share. */
+function helpersFor(used, javascript) {
+    const needed = new Set(used);
+    if (needed.has("number") || needed.has("plural")) {
+        needed.add("cache");
+    }
+    return Object.keys(HELPERS).filter((name) => needed.has(name)).map((name) => HELPERS[name][javascript ? "js" : "ts"]).join("\n");
+}
 function typeOf(type) {
     return type === "number" ? "number" : type === "date" ? "Date | number" : "string | number";
 }
@@ -655,7 +718,11 @@ function typeOf(type) {
  * Compiles one locale's catalog into a module: `locale`, one exported
  * function per message named from its key, and the `Intl` helpers they
  * share. Each function takes an `args` object typed from the message's
- * placeholders, or nothing when the message has none.
+ * placeholders, or nothing when the message has none. A formatter whose
+ * options are all literals is a module-level binding created on first use
+ * and shared by every message that formats the same way; options that read
+ * an argument find their formatter in a cache keyed by the options. Only
+ * the helpers the messages use are written.
  */
 export function compileMessages(locale, catalog, options = {}) {
     const javascript = options.language === "js";
@@ -666,8 +733,9 @@ export function compileMessages(locale, catalog, options = {}) {
     }
     out.push(`export const locale${javascript ? "" : ": string"} = ${JSON.stringify(locale)};`);
     out.push("");
-    out.push(javascript ? HELPERS : HELPERS_TS);
-    out.push("");
+    const head = out.length;
+    const formatters = new Map();
+    const used = new Set();
     const names = [];
     const seen = new Set();
     for (const [key, source] of Object.entries(catalog)) {
@@ -675,21 +743,25 @@ export function compileMessages(locale, catalog, options = {}) {
         if (seen.has(name)) {
             throw new Error(`zerolith/i18n: keys "${key}" and another one both become ${name}`);
         }
+        if (name === "locale") {
+            throw new Error(`zerolith/i18n: key "${key}" becomes locale, which every compiled module exports; rename the key`);
+        }
+        const binding = RESERVED.has(name) ? `message_${name}` : name;
         seen.add(name);
         names.push(name);
         const message = new Parser(source, key).parse();
-        const emitter = new Emitter(key, message);
+        const emitter = new Emitter(key, message, formatters, used);
         const body = emitter.body();
         const args = [...emitter.arguments.entries()].toSorted(([a], [b]) => a.localeCompare(b));
         const doc = source.replace(/\*\//g, "* /").split(/\r?\n/).map((line) => ` * ${line}`.trimEnd()).join("\n");
-        const argumentType = `{ ${args.map(([argument, type]) => `${argument}: ${typeOf(type)}`).join("; ")} }`;
+        const argumentType = `{ ${args.map(([argument, type]) => `${property(argument)}: ${typeOf(type)}`).join("; ")} }`;
         if (javascript) {
             out.push(`/**\n${doc}${args.length > 0 ? `\n * @param {${argumentType}} args` : ""}\n * @returns {string}\n */`);
-            out.push(`export function ${name}(${args.length > 0 ? "args" : ""})`);
+            out.push(`${binding === name ? "export " : ""}function ${binding}(${args.length > 0 ? "args" : ""})`);
         }
         else {
             out.push(`/**\n${doc}\n */`);
-            out.push(`export function ${name}(${args.length > 0 ? `args: ${argumentType}` : ""}): string`);
+            out.push(`${binding === name ? "export " : ""}function ${binding}(${args.length > 0 ? `args: ${argumentType}` : ""}): string`);
         }
         out.push("{");
         for (const line of emitter.prelude) {
@@ -697,8 +769,14 @@ export function compileMessages(locale, catalog, options = {}) {
         }
         out.push(`    return ${body};`);
         out.push("}");
+        if (binding !== name) {
+            out.push(`export { ${binding} as ${name} };`);
+        }
         out.push("");
     }
+    const helpers = helpersFor(used, javascript);
+    const shared = Array.from(formatters, ([create, binding]) => `const ${binding} = $once(() => ${create});`);
+    out.splice(head, 0, ...(helpers === "" ? [] : [helpers, ""]), ...(shared.length === 0 ? [] : [...shared, ""]));
     return { code: out.join("\n"), names };
 }
 /** The keys of a catalog as function names, for comparing locales. */