@randajan/say 1.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2022-present Jan Randa
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,64 @@
+# @randajan/say
+
+[![NPM](https://img.shields.io/npm/v/@randajan/say.svg)](https://www.npmjs.com/package/@randajan/say) [![JavaScript Style Guide](https://img.shields.io/badge/code_style-standard-brightgreen.svg)](https://standardjs.com)
+
+A tiny, chainable phrase lookup helper for simple localization with fallbacks.
+
+This project is a small toy for experimenting with callable objects and minimal translation tables.
+
+## Installation
+
+```bash
+npm install @randajan/say
+```
+
+## Exports (CJS / ESM)
+
+ESM:
+
+```js
+import Say, { Say as SayClass } from "@randajan/say";
+```
+
+CommonJS:
+
+```js
+const Say = require("@randajan/say");
+const { Say: SayClass } = require("@randajan/say");
+```
+
+## API
+
+### `new Say(options)`
+
+Creates a callable instance that can be invoked like a function: `say("phraseId", "en")`.
+
+Options:
+- `langs` (`string[]`): Ordered list of language codes.
+- `translations` (`Record<string, string[]>`): Phrase table, where each entry aligns with `langs`.
+- `defaultLang` (`string`): Default language to use when none is provided.
+- `parent` (`Say | null`): Optional parent instance for fallback lookups.
+
+### `say(phraseId, lang?)`
+
+Returns the translation for `phraseId` in `lang` or the default language. Falls back to `parent` if not found.
+
+### `bindLang(lang)`
+
+Returns a new instance with `defaultLang` set to `lang`, keeping the same language list and parent chain.
+
+### `extend({ defaultLang, langs, translations } = {})`
+
+Creates a new instance that can override `defaultLang`, `langs`, or `translations` and chains the current instance as `parent`.
+
+### `has(phraseId, lang?)`
+
+Returns `true` if the phrase exists (including via fallback), otherwise `false`.
+
+### `sayOr(phraseId, fallback, lang?)`
+
+Returns the phrase if found; otherwise returns `fallback`.
+
+## License
+
+MIT

package/dist/cjs/index.cjs

@@ -0,0 +1,107 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.js
+var index_exports = {};
+__export(index_exports, {
+  Say: () => Say,
+  default: () => index_default
+});
+module.exports = __toCommonJS(index_exports);
+var import_props = require("@randajan/props");
+var makeLangIndex = (langs = []) => {
+  const idx = {};
+  for (let i = 0; i < langs.length; i++) idx[langs[i]] = i;
+  return idx;
+};
+var Say = class _Say extends Function {
+  /**
+   * @param {object} opts
+   * @param {string[]} opts.langs
+   * @param {Record<string, string[]>} opts.translations
+   * @param {string[]} opts.defaultLang
+   * @param {Say|null} opts.parent
+   */
+  constructor({ defaultLang = null, langs = [], translations = {}, parent = null } = {}) {
+    super();
+    langs = langs ?? [];
+    translations = translations ?? {};
+    defaultLang = defaultLang ?? langs[0];
+    const _say = (...a) => _say.say(...a);
+    (0, import_props.solids)(_say, {
+      defaultLang,
+      langs,
+      langIndex: makeLangIndex(langs),
+      translations,
+      parent
+    });
+    console.log("h", _say.langIndex);
+    return Object.setPrototypeOf(_say, new.target.prototype);
+  }
+  _lookupHere(phraseId, lang) {
+    const i = this.langIndex[lang];
+    if (i == null) {
+      return;
+    }
+    const arr = this.translations?.[phraseId];
+    if (!Array.isArray(arr)) {
+      return;
+    }
+    return arr[i];
+  }
+  say(phraseId, lang) {
+    const effectiveLang = lang ?? this.defaultLang;
+    const here = this._lookupHere(phraseId, effectiveLang);
+    if (here != null) {
+      return here;
+    }
+    if (this.parent) {
+      return this.parent.say(phraseId, effectiveLang);
+    }
+    throw new Error(`Phrase '${phraseId}' not found (lang '${effectiveLang}').`);
+  }
+  bindLang(lang) {
+    return this.extend({ defaultLang: lang });
+  }
+  extend({ defaultLang, langs, translations } = {}) {
+    if (!langs) {
+      langs = this.langs;
+    } else if (!defaultLang) {
+      defaultLang = this.defaultLang;
+    }
+    console.log({ defaultLang, langs, translations }, { ...this });
+    return new _Say({ defaultLang, langs, translations, parent: this });
+  }
+  has(phraseId, lang) {
+    try {
+      this.say(phraseId, lang);
+      return true;
+    } catch {
+      return false;
+    }
+  }
+  sayOr(phraseId, fallback, lang) {
+    try {
+      return this.say(phraseId, lang);
+    } catch {
+      return fallback;
+    }
+  }
+};
+var index_default = Say;
+//# sourceMappingURL=index.js.map

package/dist/cjs/index.cjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/index.js"],
+  "sourcesContent": ["import { solids } from \"@randajan/props\";\n\nconst makeLangIndex = (langs = []) => {\n    const idx = {};\n    for (let i = 0; i < langs.length; i++) idx[langs[i]] = i;\n    return idx;\n};\n\nexport class Say extends Function {\n    /**\n     * @param {object} opts\n     * @param {string[]} opts.langs\n     * @param {Record<string, string[]>} opts.translations\n     * @param {string[]} opts.defaultLang\n     * @param {Say|null} opts.parent\n     */\n    constructor({ defaultLang = null, langs = [], translations = {}, parent = null } = {}) {\n        super();\n\n        langs = langs ?? [];\n        translations = translations ?? {};\n        defaultLang = defaultLang ?? langs[0];\n\n        // Important: keep prototype = Say so instance methods work\n        const _say = (...a) => _say.say(...a);\n\n        solids(_say, {\n            defaultLang,\n            langs,\n            langIndex: makeLangIndex(langs),\n            translations,\n            parent\n        });\n\n        console.log(\"h\", _say.langIndex);\n\n        return Object.setPrototypeOf(_say, new.target.prototype);\n    }\n\n    _lookupHere(phraseId, lang) {\n        const i = this.langIndex[lang];\n        if (i == null) { return; }\n        const arr = this.translations?.[phraseId];\n        if (!Array.isArray(arr)) { return; }\n        return arr[i];\n    }\n\n    say(phraseId, lang) {\n        const effectiveLang = lang ?? this.defaultLang;\n        const here = this._lookupHere(phraseId, effectiveLang);\n\n        if (here != null) { return here; }\n        if (this.parent) { return this.parent.say(phraseId, effectiveLang); }\n\n        throw new Error(`Phrase '${phraseId}' not found (lang '${effectiveLang}').`);\n    }\n\n    bindLang(lang) {\n        return this.extend({defaultLang:lang});\n    }\n\n    extend({ defaultLang, langs, translations} = {}) {\n        if (!langs) { langs = this.langs; }\n        else if (!defaultLang) { defaultLang = this.defaultLang; }\n\n        console.log({ defaultLang, langs, translations }, {...this});\n        return new Say({defaultLang, langs, translations, parent:this});\n    }\n\n    has(phraseId, lang) {\n        try {\n            this.say(phraseId, lang);\n            return true;\n        } catch {\n            return false;\n        }\n    }\n\n    sayOr(phraseId, fallback, lang) {\n        try {\n            return this.say(phraseId, lang);\n        } catch {\n            return fallback;\n        }\n    }\n}\n\nexport default Say;\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,mBAAuB;AAEvB,IAAM,gBAAgB,CAAC,QAAQ,CAAC,MAAM;AAClC,QAAM,MAAM,CAAC;AACb,WAAS,IAAI,GAAG,IAAI,MAAM,QAAQ,IAAK,KAAI,MAAM,CAAC,CAAC,IAAI;AACvD,SAAO;AACX;AAEO,IAAM,MAAN,MAAM,aAAY,SAAS;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQ9B,YAAY,EAAE,cAAc,MAAM,QAAQ,CAAC,GAAG,eAAe,CAAC,GAAG,SAAS,KAAK,IAAI,CAAC,GAAG;AACnF,UAAM;AAEN,YAAQ,SAAS,CAAC;AAClB,mBAAe,gBAAgB,CAAC;AAChC,kBAAc,eAAe,MAAM,CAAC;AAGpC,UAAM,OAAO,IAAI,MAAM,KAAK,IAAI,GAAG,CAAC;AAEpC,6BAAO,MAAM;AAAA,MACT;AAAA,MACA;AAAA,MACA,WAAW,cAAc,KAAK;AAAA,MAC9B;AAAA,MACA;AAAA,IACJ,CAAC;AAED,YAAQ,IAAI,KAAK,KAAK,SAAS;AAE/B,WAAO,OAAO,eAAe,MAAM,WAAW,SAAS;AAAA,EAC3D;AAAA,EAEA,YAAY,UAAU,MAAM;AACxB,UAAM,IAAI,KAAK,UAAU,IAAI;AAC7B,QAAI,KAAK,MAAM;AAAE;AAAA,IAAQ;AACzB,UAAM,MAAM,KAAK,eAAe,QAAQ;AACxC,QAAI,CAAC,MAAM,QAAQ,GAAG,GAAG;AAAE;AAAA,IAAQ;AACnC,WAAO,IAAI,CAAC;AAAA,EAChB;AAAA,EAEA,IAAI,UAAU,MAAM;AAChB,UAAM,gBAAgB,QAAQ,KAAK;AACnC,UAAM,OAAO,KAAK,YAAY,UAAU,aAAa;AAErD,QAAI,QAAQ,MAAM;AAAE,aAAO;AAAA,IAAM;AACjC,QAAI,KAAK,QAAQ;AAAE,aAAO,KAAK,OAAO,IAAI,UAAU,aAAa;AAAA,IAAG;AAEpE,UAAM,IAAI,MAAM,WAAW,QAAQ,sBAAsB,aAAa,KAAK;AAAA,EAC/E;AAAA,EAEA,SAAS,MAAM;AACX,WAAO,KAAK,OAAO,EAAC,aAAY,KAAI,CAAC;AAAA,EACzC;AAAA,EAEA,OAAO,EAAE,aAAa,OAAO,aAAY,IAAI,CAAC,GAAG;AAC7C,QAAI,CAAC,OAAO;AAAE,cAAQ,KAAK;AAAA,IAAO,WACzB,CAAC,aAAa;AAAE,oBAAc,KAAK;AAAA,IAAa;AAEzD,YAAQ,IAAI,EAAE,aAAa,OAAO,aAAa,GAAG,EAAC,GAAG,KAAI,CAAC;AAC3D,WAAO,IAAI,KAAI,EAAC,aAAa,OAAO,cAAc,QAAO,KAAI,CAAC;AAAA,EAClE;AAAA,EAEA,IAAI,UAAU,MAAM;AAChB,QAAI;AACA,WAAK,IAAI,UAAU,IAAI;AACvB,aAAO;AAAA,IACX,QAAQ;AACJ,aAAO;AAAA,IACX;AAAA,EACJ;AAAA,EAEA,MAAM,UAAU,UAAU,MAAM;AAC5B,QAAI;AACA,aAAO,KAAK,IAAI,UAAU,IAAI;AAAA,IAClC,QAAQ;AACJ,aAAO;AAAA,IACX;AAAA,EACJ;AACJ;AAEA,IAAO,gBAAQ;",
+  "names": []
+}

package/dist/esm/index.mjs

@@ -0,0 +1,87 @@
+// src/index.js
+import { solids } from "@randajan/props";
+var makeLangIndex = (langs = []) => {
+  const idx = {};
+  for (let i = 0; i < langs.length; i++) idx[langs[i]] = i;
+  return idx;
+};
+var Say = class _Say extends Function {
+  /**
+   * @param {object} opts
+   * @param {string[]} opts.langs
+   * @param {Record<string, string[]>} opts.translations
+   * @param {string[]} opts.defaultLang
+   * @param {Say|null} opts.parent
+   */
+  constructor({ defaultLang = null, langs = [], translations = {}, parent = null } = {}) {
+    super();
+    langs = langs ?? [];
+    translations = translations ?? {};
+    defaultLang = defaultLang ?? langs[0];
+    const _say = (...a) => _say.say(...a);
+    solids(_say, {
+      defaultLang,
+      langs,
+      langIndex: makeLangIndex(langs),
+      translations,
+      parent
+    });
+    console.log("h", _say.langIndex);
+    return Object.setPrototypeOf(_say, new.target.prototype);
+  }
+  _lookupHere(phraseId, lang) {
+    const i = this.langIndex[lang];
+    if (i == null) {
+      return;
+    }
+    const arr = this.translations?.[phraseId];
+    if (!Array.isArray(arr)) {
+      return;
+    }
+    return arr[i];
+  }
+  say(phraseId, lang) {
+    const effectiveLang = lang ?? this.defaultLang;
+    const here = this._lookupHere(phraseId, effectiveLang);
+    if (here != null) {
+      return here;
+    }
+    if (this.parent) {
+      return this.parent.say(phraseId, effectiveLang);
+    }
+    throw new Error(`Phrase '${phraseId}' not found (lang '${effectiveLang}').`);
+  }
+  bindLang(lang) {
+    return this.extend({ defaultLang: lang });
+  }
+  extend({ defaultLang, langs, translations } = {}) {
+    if (!langs) {
+      langs = this.langs;
+    } else if (!defaultLang) {
+      defaultLang = this.defaultLang;
+    }
+    console.log({ defaultLang, langs, translations }, { ...this });
+    return new _Say({ defaultLang, langs, translations, parent: this });
+  }
+  has(phraseId, lang) {
+    try {
+      this.say(phraseId, lang);
+      return true;
+    } catch {
+      return false;
+    }
+  }
+  sayOr(phraseId, fallback, lang) {
+    try {
+      return this.say(phraseId, lang);
+    } catch {
+      return fallback;
+    }
+  }
+};
+var index_default = Say;
+export {
+  Say,
+  index_default as default
+};
+//# sourceMappingURL=index.js.map

package/dist/esm/index.mjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/index.js"],
+  "sourcesContent": ["import { solids } from \"@randajan/props\";\n\nconst makeLangIndex = (langs = []) => {\n    const idx = {};\n    for (let i = 0; i < langs.length; i++) idx[langs[i]] = i;\n    return idx;\n};\n\nexport class Say extends Function {\n    /**\n     * @param {object} opts\n     * @param {string[]} opts.langs\n     * @param {Record<string, string[]>} opts.translations\n     * @param {string[]} opts.defaultLang\n     * @param {Say|null} opts.parent\n     */\n    constructor({ defaultLang = null, langs = [], translations = {}, parent = null } = {}) {\n        super();\n\n        langs = langs ?? [];\n        translations = translations ?? {};\n        defaultLang = defaultLang ?? langs[0];\n\n        // Important: keep prototype = Say so instance methods work\n        const _say = (...a) => _say.say(...a);\n\n        solids(_say, {\n            defaultLang,\n            langs,\n            langIndex: makeLangIndex(langs),\n            translations,\n            parent\n        });\n\n        console.log(\"h\", _say.langIndex);\n\n        return Object.setPrototypeOf(_say, new.target.prototype);\n    }\n\n    _lookupHere(phraseId, lang) {\n        const i = this.langIndex[lang];\n        if (i == null) { return; }\n        const arr = this.translations?.[phraseId];\n        if (!Array.isArray(arr)) { return; }\n        return arr[i];\n    }\n\n    say(phraseId, lang) {\n        const effectiveLang = lang ?? this.defaultLang;\n        const here = this._lookupHere(phraseId, effectiveLang);\n\n        if (here != null) { return here; }\n        if (this.parent) { return this.parent.say(phraseId, effectiveLang); }\n\n        throw new Error(`Phrase '${phraseId}' not found (lang '${effectiveLang}').`);\n    }\n\n    bindLang(lang) {\n        return this.extend({defaultLang:lang});\n    }\n\n    extend({ defaultLang, langs, translations} = {}) {\n        if (!langs) { langs = this.langs; }\n        else if (!defaultLang) { defaultLang = this.defaultLang; }\n\n        console.log({ defaultLang, langs, translations }, {...this});\n        return new Say({defaultLang, langs, translations, parent:this});\n    }\n\n    has(phraseId, lang) {\n        try {\n            this.say(phraseId, lang);\n            return true;\n        } catch {\n            return false;\n        }\n    }\n\n    sayOr(phraseId, fallback, lang) {\n        try {\n            return this.say(phraseId, lang);\n        } catch {\n            return fallback;\n        }\n    }\n}\n\nexport default Say;\n"],
+  "mappings": ";AAAA,SAAS,cAAc;AAEvB,IAAM,gBAAgB,CAAC,QAAQ,CAAC,MAAM;AAClC,QAAM,MAAM,CAAC;AACb,WAAS,IAAI,GAAG,IAAI,MAAM,QAAQ,IAAK,KAAI,MAAM,CAAC,CAAC,IAAI;AACvD,SAAO;AACX;AAEO,IAAM,MAAN,MAAM,aAAY,SAAS;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQ9B,YAAY,EAAE,cAAc,MAAM,QAAQ,CAAC,GAAG,eAAe,CAAC,GAAG,SAAS,KAAK,IAAI,CAAC,GAAG;AACnF,UAAM;AAEN,YAAQ,SAAS,CAAC;AAClB,mBAAe,gBAAgB,CAAC;AAChC,kBAAc,eAAe,MAAM,CAAC;AAGpC,UAAM,OAAO,IAAI,MAAM,KAAK,IAAI,GAAG,CAAC;AAEpC,WAAO,MAAM;AAAA,MACT;AAAA,MACA;AAAA,MACA,WAAW,cAAc,KAAK;AAAA,MAC9B;AAAA,MACA;AAAA,IACJ,CAAC;AAED,YAAQ,IAAI,KAAK,KAAK,SAAS;AAE/B,WAAO,OAAO,eAAe,MAAM,WAAW,SAAS;AAAA,EAC3D;AAAA,EAEA,YAAY,UAAU,MAAM;AACxB,UAAM,IAAI,KAAK,UAAU,IAAI;AAC7B,QAAI,KAAK,MAAM;AAAE;AAAA,IAAQ;AACzB,UAAM,MAAM,KAAK,eAAe,QAAQ;AACxC,QAAI,CAAC,MAAM,QAAQ,GAAG,GAAG;AAAE;AAAA,IAAQ;AACnC,WAAO,IAAI,CAAC;AAAA,EAChB;AAAA,EAEA,IAAI,UAAU,MAAM;AAChB,UAAM,gBAAgB,QAAQ,KAAK;AACnC,UAAM,OAAO,KAAK,YAAY,UAAU,aAAa;AAErD,QAAI,QAAQ,MAAM;AAAE,aAAO;AAAA,IAAM;AACjC,QAAI,KAAK,QAAQ;AAAE,aAAO,KAAK,OAAO,IAAI,UAAU,aAAa;AAAA,IAAG;AAEpE,UAAM,IAAI,MAAM,WAAW,QAAQ,sBAAsB,aAAa,KAAK;AAAA,EAC/E;AAAA,EAEA,SAAS,MAAM;AACX,WAAO,KAAK,OAAO,EAAC,aAAY,KAAI,CAAC;AAAA,EACzC;AAAA,EAEA,OAAO,EAAE,aAAa,OAAO,aAAY,IAAI,CAAC,GAAG;AAC7C,QAAI,CAAC,OAAO;AAAE,cAAQ,KAAK;AAAA,IAAO,WACzB,CAAC,aAAa;AAAE,oBAAc,KAAK;AAAA,IAAa;AAEzD,YAAQ,IAAI,EAAE,aAAa,OAAO,aAAa,GAAG,EAAC,GAAG,KAAI,CAAC;AAC3D,WAAO,IAAI,KAAI,EAAC,aAAa,OAAO,cAAc,QAAO,KAAI,CAAC;AAAA,EAClE;AAAA,EAEA,IAAI,UAAU,MAAM;AAChB,QAAI;AACA,WAAK,IAAI,UAAU,IAAI;AACvB,aAAO;AAAA,IACX,QAAQ;AACJ,aAAO;AAAA,IACX;AAAA,EACJ;AAAA,EAEA,MAAM,UAAU,UAAU,MAAM;AAC5B,QAAI;AACA,aAAO,KAAK,IAAI,UAAU,IAAI;AAAA,IAClC,QAAQ;AACJ,aAAO;AAAA,IACX;AAAA,EACJ;AACJ;AAEA,IAAO,gBAAQ;",
+  "names": []
+}

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "@randajan/say",
+  "version": "1.0.1",
+  "description": "Tiny, chainable phrase lookup helper for simple localization with fallbacks.",
+  "repository": "randajan/say",
+  "type": "module",
+  "main": "dist/cjs/index.cjs",
+  "module": "dist/esm/index.mjs",
+  "exports": {
+    ".": {
+      "import": "./dist/esm/index.mjs",
+      "require": "./dist/cjs/index.cjs"
+    }
+  },
+  "license": "MIT",
+  "devDependencies": {
+    "@randajan/simple-lib": "^3.3.0"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "keywords": [
+    "i18n",
+    "localization",
+    "translation",
+    "phrases",
+    "language",
+    "lookup",
+    "fallback",
+    "chainable",
+    "minimal",
+    "tiny"
+  ],
+  "homepage": "https://github.com/randajan/say",
+  "bugs": {
+    "url": "https://github.com/randajan/say/issues"
+  },
+  "author": {
+    "name": "Jan Randa",
+    "email": "jnranda@gmail.com",
+    "url": "https://www.linkedin.com/in/randajan/"
+  },
+  "dependencies": {
+    "@randajan/props": "^0.1.4"
+  }
+}