zx-kit 0.20.0 → 0.21.0

package/dist/i18n.d.ts

@@ -0,0 +1,43 @@
+/**
+ * i18n.ts — locale selection helper.
+ *
+ * A tiny, dependency-free utility for picking a string pack at runtime
+ * based on a language code. Designed so any zx-kit game can ship with
+ * multiple translations and switch them via a single config flag.
+ *
+ * USAGE
+ * ─────
+ * Each locale exports the same shape — usually as named string constants
+ * and template functions (e.g. `STR_DEPTH = (m) => \`D:${m}M\``).
+ * Import each locale module as a namespace and hand them to `pickLocale`:
+ *
+ *   import * as en from './strings.ts'        // default English
+ *   import * as sk from './strings.sk.ts'     // Slovak
+ *   import * as ru from './strings.ru.ts'     // Russian
+ *   import { LANGUAGE_CODE } from './config.ts'
+ *
+ *   export const L = pickLocale(en, { sk, ru }, LANGUAGE_CODE)
+ *
+ * Consumers then read `L.STR_DEPTH(120)` etc. — same name, swapped values.
+ *
+ * SELECTION RULES
+ * ───────────────
+ * - `code` null / undefined / empty       → returns `defaultLocale`
+ * - `code` matches a key in `locales`     → returns that locale
+ *   (case-insensitive: 'SK' === 'sk')
+ * - `code` doesn't match anything         → returns `defaultLocale`
+ *
+ * The default key (typically 'en') doesn't need to live in the `locales`
+ * map — passing 'en' simply falls through to `defaultLocale`. This keeps
+ * the English source-of-truth file at the conventional `strings.ts` path
+ * without forcing a `strings.en.ts` rename.
+ */
+/**
+ * Pick a locale object from a map by code, with fallback to a default.
+ *
+ * Generic over `T` so every entry in `locales` is type-checked against the
+ * shape of `defaultLocale` — adding a new translation that misses a key
+ * (or has a wrong signature) becomes a compile error.
+ */
+export declare function pickLocale<T>(defaultLocale: T, locales: Record<string, T>, code: string | null | undefined): T;
+//# sourceMappingURL=i18n.d.ts.map

package/dist/i18n.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"i18n.d.ts","sourceRoot":"","sources":["../src/i18n.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AAEH;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,CAAC,EAC1B,aAAa,EAAE,CAAC,EAChB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,EAC1B,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAC9B,CAAC,CAIH"}

package/dist/i18n.js

@@ -0,0 +1,48 @@
+/**
+ * i18n.ts — locale selection helper.
+ *
+ * A tiny, dependency-free utility for picking a string pack at runtime
+ * based on a language code. Designed so any zx-kit game can ship with
+ * multiple translations and switch them via a single config flag.
+ *
+ * USAGE
+ * ─────
+ * Each locale exports the same shape — usually as named string constants
+ * and template functions (e.g. `STR_DEPTH = (m) => \`D:${m}M\``).
+ * Import each locale module as a namespace and hand them to `pickLocale`:
+ *
+ *   import * as en from './strings.ts'        // default English
+ *   import * as sk from './strings.sk.ts'     // Slovak
+ *   import * as ru from './strings.ru.ts'     // Russian
+ *   import { LANGUAGE_CODE } from './config.ts'
+ *
+ *   export const L = pickLocale(en, { sk, ru }, LANGUAGE_CODE)
+ *
+ * Consumers then read `L.STR_DEPTH(120)` etc. — same name, swapped values.
+ *
+ * SELECTION RULES
+ * ───────────────
+ * - `code` null / undefined / empty       → returns `defaultLocale`
+ * - `code` matches a key in `locales`     → returns that locale
+ *   (case-insensitive: 'SK' === 'sk')
+ * - `code` doesn't match anything         → returns `defaultLocale`
+ *
+ * The default key (typically 'en') doesn't need to live in the `locales`
+ * map — passing 'en' simply falls through to `defaultLocale`. This keeps
+ * the English source-of-truth file at the conventional `strings.ts` path
+ * without forcing a `strings.en.ts` rename.
+ */
+/**
+ * Pick a locale object from a map by code, with fallback to a default.
+ *
+ * Generic over `T` so every entry in `locales` is type-checked against the
+ * shape of `defaultLocale` — adding a new translation that misses a key
+ * (or has a wrong signature) becomes a compile error.
+ */
+export function pickLocale(defaultLocale, locales, code) {
+    if (!code)
+        return defaultLocale;
+    const normalised = code.toLowerCase();
+    return locales[normalised] ?? defaultLocale;
+}
+//# sourceMappingURL=i18n.js.map

package/dist/i18n.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"i18n.js","sourceRoot":"","sources":["../src/i18n.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AAEH;;;;;;GAMG;AACH,MAAM,UAAU,UAAU,CACxB,aAAgB,EAChB,OAA0B,EAC1B,IAA+B;IAE/B,IAAI,CAAC,IAAI;QAAE,OAAO,aAAa,CAAA;IAC/B,MAAM,UAAU,GAAG,IAAI,CAAC,WAAW,EAAE,CAAA;IACrC,OAAO,OAAO,CAAC,UAAU,CAAC,IAAI,aAAa,CAAA;AAC7C,CAAC"}

package/dist/index.d.ts

@@ -12,4 +12,5 @@ export * from './animation.js';
 export * from './camera.js';
 export * from './scene.js';
 export * from './save.js';
+export * from './i18n.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAA;AAC5B,cAAc,SAAS,CAAA;AACvB,cAAc,WAAW,CAAA;AACzB,cAAc,eAAe,CAAA;AAC7B,cAAc,YAAY,CAAA;AAC1B,cAAc,YAAY,CAAA;AAC1B,cAAc,SAAS,CAAA;AACvB,cAAc,cAAc,CAAA;AAC5B,cAAc,aAAa,CAAA;AAC3B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,aAAa,CAAA;AAC3B,cAAc,YAAY,CAAA;AAC1B,cAAc,WAAW,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAA;AAC5B,cAAc,SAAS,CAAA;AACvB,cAAc,WAAW,CAAA;AACzB,cAAc,eAAe,CAAA;AAC7B,cAAc,YAAY,CAAA;AAC1B,cAAc,YAAY,CAAA;AAC1B,cAAc,SAAS,CAAA;AACvB,cAAc,cAAc,CAAA;AAC5B,cAAc,aAAa,CAAA;AAC3B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,aAAa,CAAA;AAC3B,cAAc,YAAY,CAAA;AAC1B,cAAc,WAAW,CAAA;AACzB,cAAc,WAAW,CAAA"}

package/dist/index.js

@@ -12,4 +12,5 @@ export * from './animation.js';
 export * from './camera.js';
 export * from './scene.js';
 export * from './save.js';
+export * from './i18n.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAA;AAC5B,cAAc,SAAS,CAAA;AACvB,cAAc,WAAW,CAAA;AACzB,cAAc,eAAe,CAAA;AAC7B,cAAc,YAAY,CAAA;AAC1B,cAAc,YAAY,CAAA;AAC1B,cAAc,SAAS,CAAA;AACvB,cAAc,cAAc,CAAA;AAC5B,cAAc,aAAa,CAAA;AAC3B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,aAAa,CAAA;AAC3B,cAAc,YAAY,CAAA;AAC1B,cAAc,WAAW,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAA;AAC5B,cAAc,SAAS,CAAA;AACvB,cAAc,WAAW,CAAA;AACzB,cAAc,eAAe,CAAA;AAC7B,cAAc,YAAY,CAAA;AAC1B,cAAc,YAAY,CAAA;AAC1B,cAAc,SAAS,CAAA;AACvB,cAAc,cAAc,CAAA;AAC5B,cAAc,aAAa,CAAA;AAC3B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,aAAa,CAAA;AAC3B,cAAc,YAAY,CAAA;AAC1B,cAAc,WAAW,CAAA;AACzB,cAAc,WAAW,CAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "zx-kit",
-  "version": "0.20.0",
+  "version": "0.21.0",
   "repository": {
     "type": "git",
     "url": "https://github.com/zrebec/zx-kit.git"