@datamoc/mw_games 0.5.1 → 0.5.3

package/dist/i18n/EditSession.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EditSession.d.ts","sourceRoot":"","sources":["../../src/i18n/EditSession.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAgB,MAAM,YAAY,CAAC;AAGxD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AAEH,0FAA0F;AAC1F,MAAM,WAAW,OAAO;IACvB,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;IACjB,uDAAuD;IACvD,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,IAAI,GAAG,SAAS,GAAG,OAAO,CAAC;IACnC,oGAAoG;IACpG,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,2DAA2D;IAC3D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,kEAAkE;IAClE,cAAc,EAAE,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,WAAW;IAC3B,IAAI,EAAE,OAAO,CAAC;IACd,MAAM,EAAE,OAAO,CAAC;CAChB;AAED,MAAM,WAAW,SAAS;IACzB,wCAAwC;IACxC,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,oEAAoE;IACpE,KAAK,CAAC,EAAE,MAAM,CAAC;CACf;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,GAAG,WAAW,CAE7E;AAED,yEAAyE;AACzE,eAAO,MAAM,YAAY,WAAW,CAAC;AAErC,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAE/C;AAED,6FAA6F;AAC7F,wBAAgB,WAAW,CAAC,OAAO,EAAE,WAAW,GAAG,MAAM,EAAE,CAG1D;AAkBD,wBAAgB,UAAU,CAAC,OAAO,EAAE,WAAW,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAkCrE;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,WAAW,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAInE;AAED,wBAAgB,WAAW,CAAC,OAAO,EAAE,WAAW,EAAE,MAAM,GAAE,SAAc,GAAG,OAAO,EAAE,CAYnF;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,WAAW,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,WAAW,CAc1F;AAED,iGAAiG;AACjG,wBAAgB,YAAY,CAAC,OAAO,EAAE,WAAW,EAAE,GAAG,EAAE,MAAM,GAAG,WAAW,CAI3E;AAED,wBAAgB,eAAe,CAAC,OAAO,EAAE,WAAW,EAAE,GAAG,EAAE,MAAM,GAAG,WAAW,CAK9E;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,WAAW,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,WAAW,CAM3F;AAED,8FAA8F;AAC9F,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,WAAW,GAAG,MAAM,CAMhE;AAED,wGAAwG;AACxG,wBAAgB,WAAW,CAAC,OAAO,EAAE,WAAW,GAAG,WAAW,CAE7D"}

package/dist/i18n/EditSession.js

@@ -0,0 +1,150 @@
+import { catalogCompleteness, messageText } from './Content.js';
+export function createEditSession(base, target) {
+    return { base, target };
+}
+/** the suffix marking a sound-cue entry rather than translatable text */
+export const AUDIO_SUFFIX = '.audio';
+export function isAudioKey(key) {
+    return key.endsWith(AUDIO_SUFFIX);
+}
+/** every translatable key across both catalogs, sorted; `*.audio` cues are not translated */
+export function sessionKeys(session) {
+    const keys = new Set([...Object.keys(session.base.messages), ...Object.keys(session.target.messages)]);
+    return [...keys].filter((key) => !isAudioKey(key)).sort();
+}
+function audioText(value) {
+    if (value === undefined)
+        return undefined;
+    const text = messageText(value);
+    return text === '' ? undefined : text;
+}
+/** text channels sharing one semantic type share its cue: `combat.damage.log` shows
+ * `combat.damage.audio` when it has no `<key>.audio` of its own */
+const TEXT_CHANNELS = ['log', 'compact', 'accessibility', 'debug'];
+function familyAudioKey(key) {
+    const dot = key.lastIndexOf('.');
+    if (dot <= 0 || !TEXT_CHANNELS.includes(key.slice(dot + 1)))
+        return undefined;
+    return `${key.slice(0, dot)}${AUDIO_SUFFIX}`;
+}
+export function sessionRow(session, key) {
+    const baseValue = session.base.messages[key];
+    const targetValue = session.target.messages[key];
+    const status = baseValue !== undefined && targetValue !== undefined ? 'ok' : baseValue === undefined ? 'extra' : 'missing';
+    const cueKeys = [`${key}${AUDIO_SUFFIX}`];
+    const family = familyAudioKey(key);
+    if (family)
+        cueKeys.push(family);
+    let sound;
+    let soundKey;
+    let soundInherited = false;
+    for (const candidate of cueKeys) {
+        const own = audioText(session.target.messages[candidate]);
+        if (own !== undefined) {
+            sound = own;
+            soundKey = candidate;
+            break;
+        }
+        const inherited = audioText(session.base.messages[candidate]);
+        if (inherited !== undefined) {
+            sound = inherited;
+            soundKey = candidate;
+            soundInherited = true;
+            break;
+        }
+    }
+    return {
+        key,
+        baseText: baseValue === undefined ? '' : messageText(baseValue),
+        targetText: targetValue === undefined ? '' : messageText(targetValue),
+        status,
+        sound,
+        soundKey,
+        soundInherited,
+    };
+}
+/**
+ * Which audio key `setTargetSound` writes for `key`: the key's own `<key>.audio` when one
+ * already exists on either side, else the family's (`<type>.audio` for a channel key),
+ * else the key's own. One cue per family rather than one per channel.
+ */
+export function cueKeyFor(session, key) {
+    const own = `${key}${AUDIO_SUFFIX}`;
+    if (own in session.target.messages || own in session.base.messages)
+        return own;
+    return familyAudioKey(key) ?? own;
+}
+export function sessionRows(session, filter = {}) {
+    const query = filter.query?.toLowerCase() ?? '';
+    return sessionKeys(session)
+        .map((key) => sessionRow(session, key))
+        .filter((row) => !filter.missingOnly || row.status === 'missing')
+        .filter((row) => query === '' ||
+        row.key.toLowerCase().includes(query) ||
+        row.baseText.toLowerCase().includes(query) ||
+        row.targetText.toLowerCase().includes(query));
+}
+/**
+ * Sets the target's text for `key`, preserving a plural structure when the new text parses
+ * as a plain JSON object over an existing plural entry - otherwise the entry becomes the
+ * string as typed. A select message (from an FTL source) edited here downgrades to a
+ * plain string; the tool warns about that on save rather than this function refusing it.
+ */
+export function setTargetText(session, key, text) {
+    const current = session.target.messages[key] ?? session.base.messages[key];
+    let value = text;
+    if (current !== undefined && typeof current === 'object' && !('format' in current)) {
+        try {
+            const parsed = JSON.parse(text);
+            if (parsed !== null && typeof parsed === 'object' && !Array.isArray(parsed)) {
+                value = parsed;
+            }
+        }
+        catch {
+            // not JSON - keep the string as typed
+        }
+    }
+    return { ...session, target: { ...session.target, messages: { ...session.target.messages, [key]: value } } };
+}
+/** fills a missing target entry with the base language's own value, plural structure included */
+export function copyFromBase(session, key) {
+    const baseValue = session.base.messages[key];
+    if (baseValue === undefined)
+        throw new Error(`copyFromBase: "${key}" is not a key in the base catalog`);
+    return { ...session, target: { ...session.target, messages: { ...session.target.messages, [key]: baseValue } } };
+}
+export function deleteTargetKey(session, key) {
+    if (!(key in session.target.messages))
+        throw new Error(`deleteTargetKey: "${key}" is not a key in the target catalog`);
+    const messages = { ...session.target.messages };
+    delete messages[key];
+    return { ...session, target: { ...session.target, messages } };
+}
+/**
+ * Associates a sound cue with `key` by setting the target's audio entry (`cueKeyFor`
+ * picks the family's `<type>.audio` for a channel key with no cue of its own). An empty
+ * path clears the cue (removing the entry rather than storing an empty string, which
+ * `validateMessageAudio` would flag).
+ */
+export function setTargetSound(session, key, path) {
+    const messages = { ...session.target.messages };
+    const audioKey = cueKeyFor(session, key);
+    if (path === '')
+        delete messages[audioKey];
+    else
+        messages[audioKey] = path;
+    return { ...session, target: { ...session.target, messages } };
+}
+/** fraction of the base catalog's translatable keys the target also has; cue keys excluded */
+export function sessionCompleteness(session) {
+    const stripAudio = (catalog) => ({
+        ...catalog,
+        messages: Object.fromEntries(Object.entries(catalog.messages).filter(([key]) => !isAudioKey(key))),
+    });
+    return catalogCompleteness(stripAudio(session.base), stripAudio(session.target));
+}
+/** swaps which catalog is the reference and which is edited, for main-language-to-main-language work */
+export function swapSession(session) {
+    return { base: session.target, target: session.base };
+}
+//# sourceMappingURL=EditSession.js.map

package/dist/i18n/EditSession.js.map

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

package/dist/i18n/Fluent.js

@@ -65,7 +65,15 @@ export function parseFTL(locale, source, options = {}) {
     return { locale, direction: options.direction ?? (/^(ar|he|fa|ur)(?:-|$)/i.test(locale) ? 'rtl' : 'ltr'), messages };
 }
 function normalize(text) {
-    return text.replace(/\{\s*\$([\w-]+)\s*\}/g, '{$1}').trim();
+    //`{$name}` renders as `{name}`; a conversion or format spec rides along untouched
+    //(`{$dmg:03d}` becomes `{dmg:03d}`), for `t()`'s own f-string handling downstream
+    return text
+        .replace(/\{\s*\$([\w-]+)\s*(?:!([sra]))?\s*(?::\s*([^{}]*?))?\s*\}/g, (_, name, conv, spec) => {
+        const conversion = conv ? `!${conv}` : '';
+        const suffix = spec === undefined ? '' : `:${spec.trim()}`;
+        return `{${name}${conversion}${suffix}}`;
+    })
+        .trim();
 }
 function selectMessage(locale, selectorName, variants) {
     const defaults = variants.filter((variant) => variant.default);

package/dist/i18n/Fluent.js.map

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

package/dist/i18n/FormatSpec.d.ts

@@ -0,0 +1,74 @@
+/**
+ * Python f-string-style value formatting for catalog messages: `{dmg:03d}`, `{hp:.1%}`,
+ * `{name:>12}`. Plain `{token}` interpolation stays exactly as it was; a format spec after
+ * a colon picks a deterministic, locale-independent rendering (padded damage numbers, hex
+ * ids, fixed-precision percentages), the counterpart to `Format.ts`, whose `Intl` wrappers
+ * render the locale-aware way instead ("1,234" vs "1 234").
+ *
+ * Supported subset of
+ * https://docs.python.org/3/library/string.html#format-specification-mini-language -
+ * `[[fill]align][sign][z][#][0][width][,|_][.precision][type]` with types
+ * `b c d e E f F g G n o s x X %`, verified case by case against CPython itself
+ * (two-digit exponents, stripped `g` precision, `_` grouping binary/octal/hex in fours).
+ * Deliberately outside the subset: nested replacement fields in the spec (`{:{width}}`),
+ * which are left for a game to resolve before calling `t()`. Anything outside the subset
+ * returns `undefined` rather than guessing, and `t()` leaves that placeholder untouched
+ * the way it already does for a missing token.
+ *
+ * One divergence no implementation choice can close: JavaScript numbers carry no
+ * int/float distinction, so integer-valued floats always take the integer path (`3.0`
+ * renders as `3`, and takes `d` where CPython would raise for a float). Games that need
+ * `3.0` spell it with an explicit float type (`{v:.1f}`).
+ *
+ * @example
+ * ```ts
+ * import { formatSpec, tokenizeMessage, diffPlaceholders } from '@datamoc/mw_games/i18n';
+ *
+ * formatSpec(7, '03d'); // '007'
+ * formatSpec(0.125, '.1%'); // '12.5%'
+ * formatSpec('hi', '^7'); // '  hi   '
+ *
+ * tokenizeMessage('Hit for {dmg:03d}!');
+ * // ['Hit for ', { raw: '{dmg:03d}', token: 'dmg', debug: false, conv: undefined, spec: '03d' }, '!']
+ *
+ * diffPlaceholders('Hit for {dmg:03d}!', 'Touché pour {dmg} !');
+ * // { missing: [], extra: [], changed: [{ token: 'dmg', base: ':03d', target: '' }] }
+ * ```
+ */
+export interface Placeholder {
+    /** the placeholder exactly as written, for untouched passthrough */
+    raw: string;
+    token: string;
+    debug: boolean;
+    conv: string | undefined;
+    spec: string | undefined;
+}
+export type MessagePart = string | Placeholder;
+/**
+ * Splits a message into literal text and `{token}`, `{token:spec}`, `{token!conv}` and
+ * `{token=}` placeholders - the single definition of that grammar, shared by `t()`'s own
+ * interpolation and by `diffPlaceholders` below, so the editor's consistency check can
+ * never disagree with the runtime about what counts as a placeholder.
+ */
+export declare function tokenizeMessage(text: string): MessagePart[];
+export interface PlaceholderDiff {
+    /** tokens the base message needs that the target never supplies */
+    missing: string[];
+    /** tokens the target supplies that the base never needs */
+    extra: string[];
+    /** same token, different conversion/spec/debug shape on each side */
+    changed: Array<{
+        token: string;
+        base: string;
+        target: string;
+    }>;
+}
+/**
+ * Compares two message texts placeholder by placeholder - the check a translation editor
+ * runs between a reference string and its translation, since a dropped or reworded token
+ * (`{dmg:03d}` becoming `{damage}`, or vanishing entirely) reaches the player as a raw
+ * placeholder exactly the way a missing key would.
+ */
+export declare function diffPlaceholders(baseText: string, targetText: string): PlaceholderDiff;
+export declare function formatSpec(value: string | number, spec: string, language?: string): string | undefined;
+//# sourceMappingURL=FormatSpec.d.ts.map

package/dist/i18n/FormatSpec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FormatSpec.d.ts","sourceRoot":"","sources":["../../src/i18n/FormatSpec.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AAEH,MAAM,WAAW,WAAW;IAC3B,oEAAoE;IACpE,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,OAAO,CAAC;IACf,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;IACzB,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;CACzB;AAED,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,WAAW,CAAC;AAI/C;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,EAAE,CAgB3D;AAMD,MAAM,WAAW,eAAe;IAC/B,mEAAmE;IACnE,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,2DAA2D;IAC3D,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,qEAAqE;IACrE,OAAO,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAChE;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,eAAe,CAiBtF;AAqFD,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,SAAO,GAAG,MAAM,GAAG,SAAS,CAkGpG"}

package/dist/i18n/FormatSpec.js

@@ -0,0 +1,302 @@
+/**
+ * Python f-string-style value formatting for catalog messages: `{dmg:03d}`, `{hp:.1%}`,
+ * `{name:>12}`. Plain `{token}` interpolation stays exactly as it was; a format spec after
+ * a colon picks a deterministic, locale-independent rendering (padded damage numbers, hex
+ * ids, fixed-precision percentages), the counterpart to `Format.ts`, whose `Intl` wrappers
+ * render the locale-aware way instead ("1,234" vs "1 234").
+ *
+ * Supported subset of
+ * https://docs.python.org/3/library/string.html#format-specification-mini-language -
+ * `[[fill]align][sign][z][#][0][width][,|_][.precision][type]` with types
+ * `b c d e E f F g G n o s x X %`, verified case by case against CPython itself
+ * (two-digit exponents, stripped `g` precision, `_` grouping binary/octal/hex in fours).
+ * Deliberately outside the subset: nested replacement fields in the spec (`{:{width}}`),
+ * which are left for a game to resolve before calling `t()`. Anything outside the subset
+ * returns `undefined` rather than guessing, and `t()` leaves that placeholder untouched
+ * the way it already does for a missing token.
+ *
+ * One divergence no implementation choice can close: JavaScript numbers carry no
+ * int/float distinction, so integer-valued floats always take the integer path (`3.0`
+ * renders as `3`, and takes `d` where CPython would raise for a float). Games that need
+ * `3.0` spell it with an explicit float type (`{v:.1f}`).
+ *
+ * @example
+ * ```ts
+ * import { formatSpec, tokenizeMessage, diffPlaceholders } from '@datamoc/mw_games/i18n';
+ *
+ * formatSpec(7, '03d'); // '007'
+ * formatSpec(0.125, '.1%'); // '12.5%'
+ * formatSpec('hi', '^7'); // '  hi   '
+ *
+ * tokenizeMessage('Hit for {dmg:03d}!');
+ * // ['Hit for ', { raw: '{dmg:03d}', token: 'dmg', debug: false, conv: undefined, spec: '03d' }, '!']
+ *
+ * diffPlaceholders('Hit for {dmg:03d}!', 'Touché pour {dmg} !');
+ * // { missing: [], extra: [], changed: [{ token: 'dmg', base: ':03d', target: '' }] }
+ * ```
+ */
+const PLACEHOLDER_PATTERN = /\{(\w+)(=)?(?:!([sra]))?(?::([^{}]*))?\}/g;
+/**
+ * Splits a message into literal text and `{token}`, `{token:spec}`, `{token!conv}` and
+ * `{token=}` placeholders - the single definition of that grammar, shared by `t()`'s own
+ * interpolation and by `diffPlaceholders` below, so the editor's consistency check can
+ * never disagree with the runtime about what counts as a placeholder.
+ */
+export function tokenizeMessage(text) {
+    const parts = [];
+    PLACEHOLDER_PATTERN.lastIndex = 0;
+    let cursor = 0;
+    let match;
+    while ((match = PLACEHOLDER_PATTERN.exec(text)) !== null) {
+        if (match.index > cursor)
+            parts.push(text.slice(cursor, match.index));
+        //group 1 always participates; the rest may be absent at runtime
+        const token = match[1];
+        const conv = match[3];
+        const spec = match[4];
+        parts.push({ raw: match[0], token, debug: match[2] === '=', conv, spec });
+        cursor = match.index + match[0].length;
+    }
+    if (cursor < text.length)
+        parts.push(text.slice(cursor));
+    return parts;
+}
+function placeholderSignature(part) {
+    return `${part.debug ? '=' : ''}${part.conv ? `!${part.conv}` : ''}${part.spec === undefined ? '' : `:${part.spec}`}`;
+}
+/**
+ * Compares two message texts placeholder by placeholder - the check a translation editor
+ * runs between a reference string and its translation, since a dropped or reworded token
+ * (`{dmg:03d}` becoming `{damage}`, or vanishing entirely) reaches the player as a raw
+ * placeholder exactly the way a missing key would.
+ */
+export function diffPlaceholders(baseText, targetText) {
+    const base = new Map();
+    const target = new Map();
+    for (const part of tokenizeMessage(baseText)) {
+        if (typeof part !== 'string')
+            base.set(part.token, placeholderSignature(part));
+    }
+    for (const part of tokenizeMessage(targetText)) {
+        if (typeof part !== 'string')
+            target.set(part.token, placeholderSignature(part));
+    }
+    return {
+        missing: [...base.keys()].filter((token) => !target.has(token)),
+        extra: [...target.keys()].filter((token) => !base.has(token)),
+        changed: [...base].flatMap(([token, baseSig]) => {
+            const targetSig = target.get(token);
+            return targetSig !== undefined && targetSig !== baseSig ? [{ token, base: baseSig, target: targetSig }] : [];
+        }),
+    };
+}
+const SPEC_PATTERN = /^(?:(.)?([<>=^]))?([+\- ])?(z)?(#)?(0)?(\d+)?([,_])?(?:\.(\d+))?([bcdeEfFgGnosxX%])?$/;
+const INT_RADIX = { b: 2, o: 8, x: 16, X: 16 };
+const INT_PREFIX = { b: '0b', o: '0o', x: '0x', X: '0X' };
+const FINITE_FLOAT_TYPES = new Set(['f', 'F', 'e', 'E', 'g', 'G', '%', 'n']);
+/** `str()` for a number: integers plain, non-integers as-is, infinities Python-spelled */
+function reprNumber(value) {
+    if (Number.isNaN(value))
+        return 'nan';
+    if (value === Infinity)
+        return 'inf';
+    if (value === -Infinity)
+        return '-inf';
+    if (Object.is(value, -0))
+        return '-0.0';
+    return String(value);
+}
+function groupDigits(digits, separator, size = 3, digit = '\\d') {
+    return digits.replace(new RegExp(`\\B(?=(${digit}{${size}})+(?!${digit}))`, 'g'), separator);
+}
+/** groups the leading digit run of a decimal rendering (`1,234.5`, `1_234.5`) */
+function groupDecimalRendering(text, separator) {
+    const match = /^(\d+)/.exec(text);
+    if (!match)
+        return text;
+    return groupDigits(match[1], separator) + text.slice(match[1].length);
+}
+function padText(text, width, fill, align) {
+    if (text.length >= width)
+        return text;
+    const pad = fill.repeat(width - text.length);
+    if (align === '<')
+        return text + pad;
+    //a centered field with an odd spare character puts it on the right, like CPython
+    if (align === '^')
+        return pad.slice(0, Math.floor(pad.length / 2)) + text + pad.slice(Math.floor(pad.length / 2));
+    return pad + text;
+}
+/** CPython pads an exponent to at least two digits (`1.23e+3` renders as `1.23e+03`) */
+function padExponent(text) {
+    return text.replace(/([eE][+-])(\d)$/, '$10$2');
+}
+/**
+ * Significant-digits formatting with stripped zeros. CPython's `g` renders fixed while
+ * the exponent stays below the precision; a bare precision without a type (`{v:.4}`)
+ * switches to exponential one digit sooner - same shape, a tighter threshold.
+ */
+function formatGeneral(magnitude, precision, upper, alt, fixedBelow) {
+    const digits = precision === 0 ? 1 : precision;
+    if (magnitude === 0)
+        return alt ? `0.${'0'.repeat(digits - 1)}` : '0';
+    const exponent = Math.floor(Math.log10(magnitude));
+    let out;
+    if (exponent >= -4 && exponent < (fixedBelow ?? digits)) {
+        out = magnitude.toFixed(digits - 1 - exponent);
+        if (!alt)
+            out = out.replace(/(\.\d*?)0+$/, '$1').replace(/\.$/, '');
+    }
+    else {
+        out = padExponent(magnitude.toExponential(digits - 1));
+        if (!alt)
+            out = out.replace(/(\.\d*?)0+(e|$)/, '$1$2').replace(/\.e/i, 'e');
+    }
+    return upper ? out.toUpperCase() : out;
+}
+function localeSeparators(language) {
+    let group = ',';
+    let decimal = '.';
+    for (const part of new Intl.NumberFormat(language).formatToParts(1000.5)) {
+        if (part.type === 'group')
+            group = part.value;
+        if (part.type === 'decimal')
+            decimal = part.value;
+    }
+    return { group, decimal };
+}
+function formatStringSpec(value, fillChar, alignChar, zeroFlag, width, precision) {
+    const text = precision === undefined ? value : value.slice(0, precision);
+    //unlike numbers, a string keeps its left alignment behind a `0` flag (`'ab'` as
+    //`05` renders `'ab000'`), since zero-padding a word has no sign to sit behind
+    return padText(text, width, fillChar ?? (zeroFlag ? '0' : ' '), alignChar ?? '<');
+}
+export function formatSpec(value, spec, language = 'en') {
+    if (spec === '')
+        return typeof value === 'number' ? reprNumber(value) : value;
+    const parsed = SPEC_PATTERN.exec(spec);
+    if (!parsed)
+        return undefined;
+    const groups = parsed.slice(1);
+    const [fillChar, alignChar, sign, zFlag, altFlag, zeroFlag, widthDigits, grouping, precisionDigits, type] = groups;
+    const precision = precisionDigits === undefined ? undefined : Number(precisionDigits);
+    const width = widthDigits === undefined ? 0 : Number(widthDigits);
+    if (typeof value === 'string') {
+        //strings take width/alignment/fill and `.precision` truncation only - every other
+        //option is numeric, and CPython raises for those rather than coercing the string
+        if (sign || zFlag || altFlag || grouping || alignChar === '=' || (type !== undefined && type !== 's'))
+            return undefined;
+        return formatStringSpec(value, fillChar, alignChar, zeroFlag, width, precision);
+    }
+    //CPython's `s` is string-only: a number behind one raises rather than stringifying
+    if (type === 's')
+        return undefined;
+    if (type === 'c') {
+        //a code point, not a number rendered as text - numeric dressing of any kind is refused
+        if (sign || altFlag || zeroFlag || grouping || precision !== undefined)
+            return undefined;
+        const code = Math.trunc(value);
+        if (code < 0 || code > 0x10ffff)
+            return undefined;
+        return padText(String.fromCodePoint(code), width, fillChar ?? ' ', alignChar ?? '>');
+    }
+    if (!Number.isFinite(value)) {
+        if (type !== undefined && !FINITE_FLOAT_TYPES.has(type))
+            return undefined;
+        //CPython spells these lowercase except behind an uppercase float type
+        let text = Number.isNaN(value) ? 'nan' : 'inf';
+        if (type === 'F' || type === 'E' || type === 'G')
+            text = text.toUpperCase();
+        if (type === '%')
+            text += '%';
+        const signText = value < 0 ? '-' : sign === '+' ? '+' : sign === ' ' ? ' ' : '';
+        return padText(signText + text, width, fillChar ?? ' ', alignChar ?? '>');
+    }
+    let negative = value < 0 || Object.is(value, -0);
+    //Python 3.11's `z`: a negative zero renders as a positive one
+    if (zFlag && value === 0)
+        negative = false;
+    const magnitude = Math.abs(value);
+    const separator = grouping === ',' ? ',' : grouping === '_' ? '_' : '';
+    let body;
+    if (type === undefined) {
+        //no type: `str()` plus sign/grouping/width - a precision without a type reads as
+        //significant digits, except on an integer, where CPython raises
+        if (precision !== undefined) {
+            if (Number.isInteger(magnitude))
+                return undefined;
+            body = formatGeneral(magnitude, precision, false, !!altFlag, precision - 1);
+        }
+        else {
+            body = reprNumber(magnitude);
+        }
+        if (separator)
+            body = groupDecimalRendering(body, separator);
+    }
+    else if (type === 'd') {
+        if (precision !== undefined || !Number.isInteger(magnitude))
+            return undefined;
+        body = String(Math.trunc(magnitude));
+        if (separator)
+            body = groupDigits(body, separator);
+    }
+    else if (type in INT_RADIX) {
+        //integer-only, like `d`; `,` is refused on a non-decimal base while `_` groups
+        //binary, octal and hex in fours rather than threes (`dead_beef`, `1010_1010`)
+        if (precision !== undefined || !Number.isInteger(magnitude) || grouping === ',')
+            return undefined;
+        body = Math.trunc(magnitude).toString(INT_RADIX[type]);
+        if (type === 'X')
+            body = body.toUpperCase();
+        if (separator)
+            body = groupDigits(body, separator, 4, '[0-9a-fA-F]');
+        if (altFlag)
+            body = INT_PREFIX[type] + body;
+    }
+    else if (type === 'n') {
+        //locale-aware, so it shares none of the fixed separators above - and takes none
+        if (grouping || (precision !== undefined && Number.isInteger(magnitude)))
+            return undefined;
+        if (Number.isInteger(magnitude)) {
+            body = new Intl.NumberFormat(language).format(Math.trunc(magnitude));
+        }
+        else {
+            const { group, decimal } = localeSeparators(language);
+            const general = formatGeneral(magnitude, precision ?? 6, false, !!altFlag);
+            const mantissa = general.split('e')[0];
+            const exponent = general.slice(mantissa.length);
+            body = groupDecimalRendering(mantissa, group).replace('.', decimal) + exponent;
+        }
+    }
+    else if (type === 'f' || type === 'F') {
+        body = magnitude.toFixed(precision ?? 6);
+        if (separator)
+            body = groupDecimalRendering(body, separator);
+    }
+    else if (type === 'e' || type === 'E') {
+        body = padExponent(magnitude.toExponential(precision ?? 6));
+        if (type === 'E')
+            body = body.toUpperCase();
+        if (separator)
+            body = groupDecimalRendering(body, separator);
+    }
+    else if (type === 'g' || type === 'G') {
+        body = formatGeneral(magnitude, precision ?? 6, type === 'G', !!altFlag);
+        if (separator)
+            body = groupDecimalRendering(body, separator);
+    }
+    else {
+        // '%' - fixed digits of the value times a hundred, then the sign itself
+        const hundredths = magnitude * 100;
+        body = (Number.isFinite(hundredths) ? hundredths.toFixed(precision ?? 6) : 'inf') + '%';
+        if (separator && Number.isFinite(hundredths))
+            body = groupDecimalRendering(body, separator);
+    }
+    const signText = negative ? '-' : sign === '+' ? '+' : sign === ' ' ? ' ' : '';
+    const fill = fillChar ?? (zeroFlag && !alignChar ? '0' : ' ');
+    const align = alignChar ?? (zeroFlag && !alignChar ? '=' : '>');
+    if (align === '=')
+        return signText + padText(body, width - signText.length, fill, '>');
+    return padText(signText + body, width, fill, align);
+}
+//# sourceMappingURL=FormatSpec.js.map

package/dist/i18n/FormatSpec.js.map

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

package/dist/i18n/SemanticMessage.d.ts

@@ -33,8 +33,11 @@ export interface GrammaticalEntity {
     forms?: Record<string, string>;
 }
 /** Where the same semantic message ends up: a game log line, a compact HUD number, an
- * accessibility announcement, or a debug dump - one simulation event, several presentations. */
-export type MessageChannel = 'log' | 'compact' | 'accessibility' | 'debug';
+ * accessibility announcement, a debug dump, or the sound effect played alongside it - one
+ * simulation event, several presentations. The `audio` entry holds a sound path (an asset
+ * path `mwg/audio`'s `Sound` plays), not display text, so it resolves through `tRaw`
+ * rather than `t()`: no typographic spacing, no right-to-left wrapping. */
+export type MessageChannel = 'log' | 'compact' | 'accessibility' | 'debug' | 'audio';
 export interface MessageFormatter {
     format(message: SemanticMessage, channel: MessageChannel): string;
 }
@@ -65,7 +68,17 @@ export interface MessageFormatter {
  * console.log(formatter.format(message, 'log'));     // 'The gnoll takes 7 damage.'
  * console.log(formatter.format(message, 'compact'));  // '-7 HP'
  * console.log(formatter.format(message, 'debug'));    // falls back to the bare type: the key itself, if undeclared
+ * console.log(formatter.format(message, 'audio'));    // 'sounds/sword-hit.wav', or '' when no '<type>.audio' entry exists
  * ```
+ *
+ * The `audio` channel is deliberately narrower than the text channels: it resolves only
+ * `<type>.audio`, never falling back to the bare type the way text does. A bare type
+ * holding a sentence (`'combat.damage': 'combat.damage generic'`) is not a playable path,
+ * so falling back to it would hand the game garbage to load. Sounds that need no
+ * per-channel variation are still shared - every text channel already falls back to the
+ * same bare type, while `audio` stays a separate entry a translator never touches and the
+ * base language usually owns alone (runtime lookup falls back to the base catalog, so a
+ * translated catalog needs no copy of it).
  */
 export declare function createCatalogFormatter(): MessageFormatter;
 //# sourceMappingURL=SemanticMessage.d.ts.map