@datamoc/mw_games 0.5.2 → 0.5.3

package/README.md

@@ -11,7 +11,7 @@ of their own; improvements to `mwg`'s own files are shared back.
 **[Live examples and API docs](https://datamoc.github.io/mwg/)**: every example below,
 playable in the browser with no download, plus the generated API reference.
 
-> **Status: early release (v0.4.3).** Every module in the shared floor below, plus optional
+> **Status: early release (v0.5.3).** Every module in the shared floor below, plus optional
 > 3D, mobile (Capacitor) and desktop (WebView2) packaging, is built and tested - see
 > [ROADMAP.md](ROADMAP.md) for the full, numbered history.
 >
@@ -119,7 +119,9 @@ them rather than pretending otherwise:
 | cross-origin images | an `<img>` from a sibling file taints a WebGL texture in Chrome | assets travel as `data:` URIs inside those scripts |
 
 The practical effect: resources are **compiled at build time**, so at runtime every lookup
-is synchronous. Game code never awaits an asset.
+is synchronous. Game code never awaits an asset. The developer-side scripts behind this
+and the other workflows (translation editing, benchmarks, packaging) are listed in
+[tools.md](tools.md).
 
 ## Capability spec
 
@@ -144,15 +146,16 @@ only some do.
 | | camera with follow, pan, shake and zoom | `mwg/two-d/render` |
 | | particle effects | `mwg/two-d/render` |
 | | screen transitions: fade, flash, tint | `mwg/two-d/render` |
-| **ui** | windows, lists, tooltips | `mwg/two-d/ui` |
+| **ui** | windows, lists, tooltips, markdown labels | `mwg/two-d/ui` |
 | | text and fonts, including non-latin fallback | PixiJS |
 | | pointer, keyboard and gamepad input with rebinding | `mwg/core` |
 | **text** | message tables per language, compiled at build time | `mwg/i18n` |
-| | plurals, gendered forms and interpolation | `mwg/i18n` |
+| | plurals, gendered forms, interpolation, and Python f-string-style format specs | `mwg/i18n` |
 | | Fluent-style FTL catalogs with locale-aware fallback and variants | `mwg/i18n` |
 | | left-to-right, right-to-left and vertical writing | `mwg/i18n` |
 | | interface mirrored for right-to-left languages | `mwg/two-d/ui` |
 | | a missing translation falls back rather than showing a key | `mwg/i18n` |
+| | per-message sound cues as an `audio` channel, edited in a split-screen CLI | `mwg/i18n` + `tools/i18n-edit` |
 | **audio** | sound effects with pooling, music with crossfade | `mwg/audio` |
 
 ### World

package/dist/i18n/EditSession.d.ts

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

@@ -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"}