@likolabs/i18nmd 0.2.0 → 0.3.0

package/lib/runtime.mjs

@@ -1,3 +1,8 @@
+/** Intl.NumberFormat options for a {n, number, style} style. */
+export function numberOptions(style = '') {
+  return style === 'integer' ? { maximumFractionDigits: 0 } : style === 'percent' ? { style: 'percent' } : style.startsWith('::currency/') ? { style: 'currency', currency: style.slice(11) } : {};
+}
+
 /**
  * Format a compiled catalog using the host's Intl implementation.
  * Messages without tags return strings. Messages with rich-text tags call the
@@ -6,8 +11,11 @@
  * onError receives problems such as an unknown token or a missing value. By
  * default they are logged and the message degrades instead of crashing the UI;
  * pass `error => { throw error; }` to fail fast in tests.
+ * formatters supplies the project's own argument types: { length: (value,
+ * language) => string } formats {len, length}. It is read on each call, so
+ * formatters may be added to the object later.
  */
-export function createI18n(catalog, { onError = error => console.error(`i18nmd: ${error.message}`) } = {}) {
+export function createI18n(catalog, { onError = error => console.error(`i18nmd: ${error.message}`), formatters = {} } = {}) {
   function value(values, name) {
     if (!Object.hasOwn(values, name)) { onError(new Error(`Missing value for {${name}}.`)); return undefined; }
     return values[name];
@@ -33,8 +41,13 @@ export function createI18n(catalog, { onError = error => console.error(`i18nmd:
       if (v == null) { onError(new Error(`Missing value for {${n.name}}.`)); push(`{${n.name}}`); continue; }
       if (['number', 'plural', 'selectordinal'].includes(n.type) && (typeof v !== 'number' || !Number.isFinite(v))) { onError(new Error(`{${n.name}} must be a finite number.`)); push(String(v)); continue; }
       if (n.type === 'number') {
-        const options = n.style === 'integer' ? { maximumFractionDigits: 0 } : n.style === 'percent' ? { style: 'percent' } : n.style.startsWith('::currency/') ? { style: 'currency', currency: n.style.slice(11) } : {};
-        push(new Intl.NumberFormat(locale, options).format(v)); continue;
+        push(new Intl.NumberFormat(locale, numberOptions(n.style)).format(v)); continue;
+      }
+      if (n.type === 'format') {
+        const format = Object.hasOwn(formatters, n.format) ? formatters[n.format] : undefined;
+        if (typeof format !== 'function') { onError(new Error(`No formatter for {${n.name}, ${n.format}}.`)); push(String(v)); continue; }
+        try { push(String(format(v, locale))); } catch (error) { onError(error); push(String(v)); }
+        continue;
       }
       if (n.type === 'date' || n.type === 'time') {
         const date = v instanceof Date ? v : typeof v === 'number' ? new Date(v) : null;
@@ -48,7 +61,7 @@ export function createI18n(catalog, { onError = error => console.error(`i18nmd:
     }
     return parts.length === 0 ? '' : parts.length === 1 && typeof parts[0] === 'string' ? parts[0] : parts;
   }
-  return function i18nmd(token, language = catalog.source, values = {}) {
+  function i18nmd(token, language = catalog.source, values = {}) {
     if (!Object.hasOwn(catalog.messages, token)) { onError(new Error(`Unknown translation token: ${token}`)); return token; }
     let requested = language;
     try { requested = Intl.getCanonicalLocales(language)[0]; } catch { /* Custom language names use source formatting. */ }
@@ -60,7 +73,10 @@ export function createI18n(catalog, { onError = error => console.error(`i18nmd:
     try { Intl.getCanonicalLocales(formattingLocale); } catch { formattingLocale = catalog.source; }
     try { Intl.getCanonicalLocales(formattingLocale); } catch { formattingLocale = 'en'; }
     return render(entry[languageUsed], formattingLocale, values || {});
-  };
+  }
+  /** Whether the catalog has token, for text written after the last compile. */
+  i18nmd.has = token => Object.hasOwn(catalog.messages, token);
+  return i18nmd;
 }
 
 /** The catalog language that best matches a requested one: exact, then base language. */
@@ -138,7 +154,8 @@ export function createLanguage(languages, source, { load, divisions = [], storag
  * The generated i18nmd function over a language's store. Divisions are
  * properties: i18nmd.support("contact_us") is the token support.contact_us.
  * i18nmd.in("fr") translates into a given (loaded) language instead, for
- * servers, emails and tests. divisions maps each property to [segment, children].
+ * servers, emails and tests. i18nmd.has(token) (or i18nmd.support.has("contact_us"))
+ * says whether a token is among the messages loaded. divisions maps each property to [segment, children].
  */
 export function createTranslator(language, divisions = {}, options = {}) {
   const { store } = language;
@@ -151,6 +168,7 @@ export function createTranslator(language, divisions = {}, options = {}) {
   } });
   const build = (prefix, tree, fixed) => {
     const scoped = (token, values) => translate(prefix + token, fixed ?? language.getLanguage(), values);
+    Object.defineProperty(scoped, 'has', { value: token => translate.has(prefix + token) });
     for (const [property, [segment, children]] of Object.entries(tree)) {
       Object.defineProperty(scoped, property, { value: build(`${prefix}${segment}.`, children, fixed), enumerable: true });
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@likolabs/i18nmd",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "Interface strings in Markdown, one file per language. A compiler checks every language and generates typed code your app imports.",
   "author": "Liko Labs (https://likolabs.com)",
   "type": "module",
@@ -19,13 +19,15 @@
     "lib",
     "scripts/python_catalog.py",
     "README.md",
+    "README.haw.md",
     "LICENSE",
     "PROMPT.md",
     "CHANGELOG.md"
   ],
   "scripts": {
     "test": "node --test tests/*.test.mjs",
-    "check": "npm test"
+    "check": "npm test",
+    "plural-rules": "node scripts/plural-rules.mjs"
   },
   "engines": {
     "node": ">=22"
@@ -55,5 +57,8 @@
     "typescript",
     "llm"
   ],
-  "license": "MIT"
+  "license": "MIT",
+  "devDependencies": {
+    "cldr-core": "48.2.0"
+  }
 }