@datamoc/mw_games 0.44.2 → 0.46.0

package/dist/i18n/Content.js

@@ -1,218 +0,0 @@
-import { diffCatalogKeys } from './Validate.js';
-/**
- * A catalog message reduced to plain, comparable text: a string as-is, a `PluralForms`
- * reduced to its `other` branch (or the first form present, the same fallback
- * `resolvePlural` itself uses with no count), and a `FluentMessage` formatted with no
- * params - best-effort, since a `.ftl` message needing a required variable throws rather
- * than resolving; that failure reads as empty text here rather than aborting the caller's
- * whole scan.
- *
- * @example
- * ```ts
- * import { messageText } from '@datamoc/mw_games/i18n';
- *
- * messageText('Hello'); // 'Hello'
- * messageText({ one: '1 item', other: '{count} items' }); // '{count} items'
- * ```
- */
-export function messageText(value) {
-    if (typeof value === 'string')
-        return value;
-    if (typeof value === 'object' && value !== null && 'format' in value) {
-        try {
-            return value.format();
-        }
-        catch {
-            return '';
-        }
-    }
-    const forms = value;
-    return forms.other ?? Object.values(forms)[0] ?? '';
-}
-/**
- * The classic edit distance: how many single-character insertions, deletions or
- * substitutions turn `a` into `b`. The primitive `findSimilarMessages` is built on, exposed
- * on its own since "how different are these two strings" is useful wherever a catalog's own
- * message text is not the only thing worth comparing.
- *
- * @example
- * ```ts
- * import { levenshteinDistance } from '@datamoc/mw_games/i18n';
- *
- * levenshteinDistance('kitten', 'sitting'); // 3
- * levenshteinDistance('same', 'same'); // 0
- * ```
- */
-export function levenshteinDistance(a, b) {
-    if (a === b)
-        return 0;
-    if (a.length === 0)
-        return b.length;
-    if (b.length === 0)
-        return a.length;
-    let previous = Array.from({ length: b.length + 1 }, (_, i) => i);
-    let current = new Array(b.length + 1);
-    for (let i = 1; i <= a.length; i++) {
-        current[0] = i;
-        for (let j = 1; j <= b.length; j++) {
-            const cost = a[i - 1] === b[j - 1] ? 0 : 1;
-            current[j] = Math.min(previous[j] + 1, //deletion
-            current[j - 1] + 1, //insertion
-            previous[j - 1] + cost);
-        }
-        [previous, current] = [current, previous];
-    }
-    return previous[b.length];
-}
-/**
- * Every pair of keys in `catalog` whose message text is at least `minSimilarity` alike
- * (default 0.8), surfaced for a human to decide whether they are genuinely the same message
- * translated three separate times - `mwg` finds the candidates, never merges anything on
- * its own. Empty messages are skipped (nothing to compare), and pairs are sorted most
- * similar first.
- *
- * @example
- * ```ts
- * import { findSimilarMessages } from '@datamoc/mw_games/i18n';
- *
- * const catalog = {
- *   locale: 'en', direction: 'ltr' as const,
- *   messages: { 'confirm.quit': 'Are you sure?', 'confirm.delete': 'Are you sure?' },
- * };
- *
- * findSimilarMessages(catalog); // [{ a: 'confirm.quit', b: 'confirm.delete', distance: 0, similarity: 1 }]
- * ```
- */
-export function findSimilarMessages(catalog, minSimilarity = 0.8) {
-    const entries = Object.entries(catalog.messages)
-        .map(([key, value]) => [key, messageText(value)])
-        .filter(([, text]) => text.length > 0);
-    const pairs = [];
-    for (let i = 0; i < entries.length; i++) {
-        for (let j = i + 1; j < entries.length; j++) {
-            const [keyA, textA] = entries[i];
-            const [keyB, textB] = entries[j];
-            const maxLen = Math.max(textA.length, textB.length);
-            const distance = levenshteinDistance(textA, textB);
-            const similarity = maxLen === 0 ? 1 : 1 - distance / maxLen;
-            if (similarity >= minSimilarity)
-                pairs.push({ a: keyA, b: keyB, distance, similarity });
-        }
-    }
-    return pairs.sort((x, y) => y.similarity - x.similarity);
-}
-/**
- * Which of a catalog's keys a game's own source actually references, and which just sit
- * there. `mwg` has no idea how a game's code names a message key (a string literal, a
- * generated constant, a `SemanticMessage.type`) - `referencedKeys` is however the caller
- * already found that out (typically a grep or a build-time scan over its own source), the
- * same boundary `rollRoster` draws around a game's own roster values.
- *
- * @example
- * ```ts
- * import { catalogUsage } from '@datamoc/mw_games/i18n';
- *
- * const catalog = {
- *   locale: 'en', direction: 'ltr' as const,
- *   messages: { greeting: 'Hi', unused: 'never shown' },
- * };
- *
- * catalogUsage(catalog, ['greeting']); // { totalKeys: 2, usedKeys: 1, unusedKeys: ['unused'] }
- * ```
- */
-export function catalogUsage(catalog, referencedKeys) {
-    const referenced = new Set(referencedKeys);
-    const keys = Object.keys(catalog.messages);
-    const unusedKeys = keys.filter((key) => !referenced.has(key));
-    return { totalKeys: keys.length, usedKeys: keys.length - unusedKeys.length, unusedKeys };
-}
-/**
- * How complete `other` is against `reference`, as a 0-1 fraction of `reference`'s own keys
- * that `other` also has - built on `diffCatalogKeys` rather than recomputing the same set
- * difference, so the two never disagree about what "missing" means.
- *
- * @example
- * ```ts
- * import { catalogCompleteness } from '@datamoc/mw_games/i18n';
- *
- * const en = { locale: 'en', direction: 'ltr' as const, messages: { a: '1', b: '2' } };
- * const fr = { locale: 'fr', direction: 'ltr' as const, messages: { a: '1' } };
- *
- * catalogCompleteness(en, fr); // 0.5
- * ```
- */
-export function catalogCompleteness(reference, other) {
-    const referenceKeys = Object.keys(reference.messages);
-    if (referenceKeys.length === 0)
-        return 1;
-    const { missing } = diffCatalogKeys(reference, other);
-    return (referenceKeys.length - missing.length) / referenceKeys.length;
-}
-/**
- * How many of a catalog's plural-form messages define each CLDR category - `'few'`/`'many'`
- * sitting at 0 while `'other'` covers every key is exactly the gap a language needing those
- * categories (Polish, Arabic) would otherwise only discover once a player hit the wrong count.
- *
- * @example
- * ```ts
- * import { pluralFormCoverage } from '@datamoc/mw_games/i18n';
- *
- * const catalog = {
- *   locale: 'en', direction: 'ltr' as const,
- *   messages: { items: { one: '{count} item', other: '{count} items' } },
- * };
- *
- * pluralFormCoverage(catalog); // { pluralKeys: 1, formsPresent: { one: 1, other: 1 } }
- * ```
- */
-export function pluralFormCoverage(catalog) {
-    const formsPresent = {};
-    let pluralKeys = 0;
-    for (const value of Object.values(catalog.messages)) {
-        if (typeof value === 'string' || (typeof value === 'object' && value !== null && 'format' in value))
-            continue;
-        pluralKeys++;
-        for (const category of Object.keys(value)) {
-            formsPresent[category] = (formsPresent[category] ?? 0) + 1;
-        }
-    }
-    return { pluralKeys, formsPresent };
-}
-/**
- * Drops `mergedKey` from `catalog`, keeping `survivingKey` (and its current text) exactly as
- * it was - the mechanical half of collapsing two keys a human decided are the same message.
- * Apply this to every language's own catalog to merge consistently across all of them.
- *
- * Rewriting whichever call sites used `mergedKey` is deliberately not this function's job:
- * `mwg` has no view into a game's own source tree, the same boundary `catalogUsage`'s
- * `referencedKeys` already draws - a caller doing that rewrite already knows exactly where
- * `mergedKey` is used, since it had to find `referencedKeys` the same way to begin with.
- *
- * @example
- * ```ts
- * import { mergeCatalogKeys } from '@datamoc/mw_games/i18n';
- *
- * const catalog = {
- *   locale: 'en', direction: 'ltr' as const,
- *   messages: { 'confirm.quit': 'Are you sure?', 'confirm.delete': 'Are you sure?' },
- * };
- *
- * const merged = mergeCatalogKeys(catalog, 'confirm.quit', 'confirm.delete');
- * console.log(Object.keys(merged.messages)); // ['confirm.quit']
- * ```
- */
-export function mergeCatalogKeys(catalog, survivingKey, mergedKey) {
-    if (!(survivingKey in catalog.messages)) {
-        throw new Error(`mergeCatalogKeys: "${survivingKey}" is not a key in this catalog`);
-    }
-    if (!(mergedKey in catalog.messages)) {
-        throw new Error(`mergeCatalogKeys: "${mergedKey}" is not a key in this catalog`);
-    }
-    if (survivingKey === mergedKey) {
-        throw new Error('mergeCatalogKeys: survivingKey and mergedKey must be different keys');
-    }
-    const messages = { ...catalog.messages };
-    delete messages[mergedKey];
-    return { ...catalog, messages };
-}
-//# sourceMappingURL=Content.js.map

package/dist/i18n/Content.js.map

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

package/dist/i18n/EditSession.d.ts

@@ -1,101 +0,0 @@
-import type { Catalog } from './index.ts';
-/**
- * The testable core behind `tools/i18n-edit.mjs`: a base (reference-language) catalog and
- * the target catalog being translated, plus the pure operations a split-screen translation
- * editor needs. Nothing here touches the filesystem or the terminal - the tool owns file
- * IO and rendering, this module owns the catalog arithmetic, so both are verifiable with
- * plain unit tests.
- *
- * Audio cues are ordinary catalog entries under this scheme (`<key>.audio` holding a
- * sound path, read by the semantic formatter's `audio` channel), not a parallel map - so
- * associating a sound with a string is just setting one more key, and the translatable
- * key list simply skips `*.audio` entries rather than asking a translator to translate a
- * file path.
- *
- * @example
- * ```ts
- * import {
- *   AUDIO_SUFFIX, copyFromBase, createEditSession, cueKeyFor, deleteTargetKey,
- *   isAudioKey, sessionCompleteness, sessionKeys, sessionRow, sessionRows,
- *   setTargetSound, setTargetText, swapSession,
- * } from '@datamoc/mw_games/i18n';
- *
- * let session = createEditSession(
- *   { locale: 'en', direction: 'ltr', messages: { greeting: 'Hello!', 'hit.audio': 'sounds/hit.wav' } },
- *   { locale: 'fr', direction: 'ltr', messages: {} },
- * );
- *
- * sessionKeys(session); // ['greeting'] - 'hit.audio' is a cue, not translated
- * isAudioKey(`hit${AUDIO_SUFFIX}`); // true
- * sessionRow(session, 'greeting').status; // 'missing'
- * sessionRows(session, { missingOnly: true }).length; // 1
- * sessionCompleteness(session); // 0
- *
- * session = setTargetText(session, 'greeting', 'Bonjour !');
- * session = copyFromBase(session, 'greeting');
- * session = setTargetSound(session, 'hit', 'sons/coup.wav');
- * cueKeyFor(session, 'greeting'); // 'greeting.audio'
- * session = deleteTargetKey(session, 'greeting');
- * session = swapSession(session);
- * ```
- */
-/** one translatable key as the editor shows it: reference text left, target text right */
-export interface EditRow {
-    key: string;
-    baseText: string;
-    /** '' when the target has no entry for this key yet */
-    targetText: string;
-    status: 'ok' | 'missing' | 'extra';
-    /** effective cue: the target's own `<key>.audio`, else the base's, else the family's (see below) */
-    sound?: string;
-    /** the full audio key `sound` above came from, when any */
-    soundKey?: string;
-    /** true when `sound` above was inherited from the base catalog */
-    soundInherited: boolean;
-}
-export interface EditSession {
-    base: Catalog;
-    target: Catalog;
-}
-export interface RowFilter {
-    /** only keys missing from the target */
-    missingOnly?: boolean;
-    /** case-insensitive substring matched against key and both texts */
-    query?: string;
-}
-export declare function createEditSession(base: Catalog, target: Catalog): EditSession;
-/** the suffix marking a sound-cue entry rather than translatable text */
-export declare const AUDIO_SUFFIX = ".audio";
-export declare function isAudioKey(key: string): boolean;
-/** every translatable key across both catalogs, sorted; `*.audio` cues are not translated */
-export declare function sessionKeys(session: EditSession): string[];
-export declare function sessionRow(session: EditSession, key: string): EditRow;
-/**
- * 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 declare function cueKeyFor(session: EditSession, key: string): string;
-export declare function sessionRows(session: EditSession, filter?: RowFilter): EditRow[];
-/**
- * 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 declare function setTargetText(session: EditSession, key: string, text: string): EditSession;
-/** fills a missing target entry with the base language's own value, plural structure included */
-export declare function copyFromBase(session: EditSession, key: string): EditSession;
-export declare function deleteTargetKey(session: EditSession, key: string): EditSession;
-/**
- * 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 declare function setTargetSound(session: EditSession, key: string, path: string): EditSession;
-/** fraction of the base catalog's translatable keys the target also has; cue keys excluded */
-export declare function sessionCompleteness(session: EditSession): number;
-/** swaps which catalog is the reference and which is edited, for main-language-to-main-language work */
-export declare function swapSession(session: EditSession): EditSession;
-//# sourceMappingURL=EditSession.d.ts.map

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

@@ -1 +0,0 @@
-{"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,CAmCrE;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,CAM9E;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

@@ -1,150 +0,0 @@
-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

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

package/dist/i18n/Fluent.d.ts

@@ -1,7 +0,0 @@
-import type { Catalog, Direction } from './index.ts';
-export interface FluentOptions {
-    direction?: Direction;
-}
-/** Parses the useful, dependency-free subset of FTL used by game message catalogs. */
-export declare function parseFTL(locale: string, source: string, options?: FluentOptions): Catalog;
-//# sourceMappingURL=Fluent.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"Fluent.d.ts","sourceRoot":"","sources":["../../src/i18n/Fluent.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,SAAS,EAAiB,MAAM,YAAY,CAAC;AAEpE,MAAM,WAAW,aAAa;IAC7B,SAAS,CAAC,EAAE,SAAS,CAAC;CACtB;AAID,sFAAsF;AACtF,wBAAgB,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAE,aAAkB,GAAG,OAAO,CA2D7F"}

package/dist/i18n/Fluent.js

@@ -1,98 +0,0 @@
-/** Parses the useful, dependency-free subset of FTL used by game message catalogs. */
-export function parseFTL(locale, source, options = {}) {
-    const messages = {};
-    const lines = source.replace(/\r/g, '').split('\n');
-    let id = null;
-    let value = '';
-    let variants = [];
-    let selectClosed = false;
-    const finish = () => {
-        if (!id)
-            return;
-        if (messages[id] !== undefined)
-            throw new Error(`Duplicate FTL message: ${id}`);
-        if (variants.length) {
-            if (!selectClosed)
-                throw new Error(`FTL select expression is not closed: ${id}`);
-            const selector = value.trim().match(/^\{\s*\$([\w-]+)\s*->\s*$/)?.[1];
-            if (!selector)
-                throw new Error(`Invalid FTL selector: ${value}`);
-            messages[id] = selectMessage(locale, selector, variants);
-        }
-        else {
-            messages[id] = normalize(value);
-        }
-        id = null;
-        value = '';
-        variants = [];
-        selectClosed = false;
-    };
-    for (const line of lines) {
-        if (!line.trim() || line.trimStart().startsWith('#'))
-            continue;
-        const message = line.match(/^([\w-]+)\s*=\s*(.*)$/);
-        if (message) {
-            finish();
-            id = message[1];
-            value = message[2];
-            continue;
-        }
-        if (!id)
-            throw new Error(`FTL continuation has no message: ${line}`);
-        if (line.trim() === '}') {
-            if (!variants.length || selectClosed)
-                throw new Error(`Unexpected FTL select terminator: ${line}`);
-            selectClosed = true;
-            continue;
-        }
-        if (selectClosed)
-            throw new Error(`FTL content follows a closed select expression: ${line}`);
-        const variant = line.match(/^\s*(\*)?\[([^\]]+)\]\s*(.*)$/);
-        if (variant) {
-            variants.push({ key: variant[2], value: variant[3], default: Boolean(variant[1]) });
-            continue;
-        }
-        if (/^\s+/.test(line)) {
-            if (variants.length)
-                variants[variants.length - 1].value += ` ${line.trim()}`;
-            else
-                value += ` ${line.trim()}`;
-            continue;
-        }
-        throw new Error(`Invalid FTL line: ${line}`);
-    }
-    finish();
-    return {
-        locale,
-        direction: options.direction ?? (/^(ar|he|fa|ur)(?:-|$)/i.test(locale) ? 'rtl' : 'ltr'),
-        messages,
-    };
-}
-function normalize(text) {
-    //`{$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);
-    if (defaults.length !== 1)
-        throw new Error('FTL select expressions need exactly one default variant');
-    const defaultVariant = defaults[0];
-    const rules = new Intl.PluralRules(locale);
-    return {
-        format(params = {}) {
-            const selector = params[selectorName];
-            const exact = variants.find((variant) => variant.key === String(selector));
-            const category = typeof selector === 'number' ? rules.select(selector) : '';
-            const chosen = exact ?? variants.find((variant) => variant.key === category) ?? defaultVariant;
-            return normalize(chosen.value);
-        },
-    };
-}
-//# sourceMappingURL=Fluent.js.map

package/dist/i18n/Fluent.js.map

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

package/dist/i18n/Format.d.ts

@@ -1,25 +0,0 @@
-/**
- * Locale-aware number/date/list formatting, for a catalog message that needs more than
- * `{token}` substitution can give it - "1,234" vs "1 234", "3 items" vs "3 éléments" joined
- * with "and"/"et". A game calls these while building a `t()`/`SemanticMessage` param, the
- * same way it already resolves an entity id to display text; MWG does not parse a format
- * directive out of the message string itself.
- *
- * All three read the active locale from `i18n`'s own `locale()`, so a language switch takes
- * effect the same way it already does for plurals and typography.
- *
- * @example
- * ```ts
- * import { setActive, t, formatNumber, formatDate, formatList } from '@datamoc/mw_games/i18n';
- *
- * setActive({ locale: 'fr-FR', direction: 'ltr', messages: { found: 'Vous trouvez {amount}.' } });
- *
- * console.log(formatNumber(1234.5)); // '1 234,5'
- * console.log(formatDate(new Date(2024, 0, 15))); // '15/01/2024'
- * console.log(t('found', { amount: formatList(['une épée', 'un bouclier']) })); // '... une épée et un bouclier.'
- * ```
- */
-export declare function formatNumber(value: number, options?: Intl.NumberFormatOptions): string;
-export declare function formatDate(value: Date | number, options?: Intl.DateTimeFormatOptions): string;
-export declare function formatList(items: readonly string[], options?: Intl.ListFormatOptions): string;
-//# sourceMappingURL=Format.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"Format.d.ts","sourceRoot":"","sources":["../../src/i18n/Format.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,CAAC,mBAAmB,GAAG,MAAM,CAEtF;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,IAAI,GAAG,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,CAAC,qBAAqB,GAAG,MAAM,CAE7F;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,EAAE,OAAO,CAAC,EAAE,IAAI,CAAC,iBAAiB,GAAG,MAAM,CAE7F"}