@ng-linguo/linguo 0.9.0

package/README.md

@@ -0,0 +1,25 @@
+<p align="center">
+  <img
+    src="https://raw.githubusercontent.com/jmwierzbicki/linguo/main/apps/playground/public/linguo-logo.png"
+    alt="ng-linguo"
+    width="640"
+  />
+</p>
+
+# @ng-linguo/linguo
+
+A modern, complete i18n toolkit for Angular 21+, built on SignalStore.
+
+```ts
+import { provideTranslate } from '@ng-linguo/linguo';
+import { provideIcu } from '@ng-linguo/linguo/icu';
+import { createHttpLoader } from '@ng-linguo/linguo/http';
+```
+
+- **`@ng-linguo/linguo`** — the runtime: `TranslateStore`, the `t` pipe, the
+  `[t]` directive, `injectTranslate`, slot tags.
+- **`@ng-linguo/linguo/icu`** — ICU MessageFormat (MF1 + MF2) via `provideIcu`.
+- **`@ng-linguo/linguo/http`** — an HTTP `TranslationLoader` (`createHttpLoader`).
+
+The build-time extraction CLI lives in the separate `@ng-linguo/extract`
+package (pure Node, no Angular dependency).

package/fesm2022/ng-linguo-linguo-http.mjs

@@ -0,0 +1,32 @@
+import { HttpClient } from '@angular/common/http';
+import { inject } from '@angular/core';
+import { firstValueFrom } from 'rxjs';
+
+/**
+ * Create a {@link TranslationLoader} backed by Angular's `HttpClient`.
+ *
+ * Must be called within an injection context (it injects `HttpClient`), so
+ * construct it inside a factory provider or an `inject`-aware bootstrap path
+ * where `provideHttpClient()` is also available. RxJS is used only here, at the
+ * I/O boundary, and is converted to the promise the loader interface expects.
+ *
+ * @example
+ * ```ts
+ * const loader = createHttpLoader({ prefix: '/i18n/' });
+ * ```
+ */
+function createHttpLoader(options = {}) {
+    const http = inject(HttpClient);
+    const prefix = options.prefix ?? '/assets/i18n/';
+    const suffix = options.suffix ?? '.json';
+    return {
+        load: (lang) => firstValueFrom(http.get(`${prefix}${lang}${suffix}`)),
+    };
+}
+
+/**
+ * Generated bundle index. Do not edit.
+ */
+
+export { createHttpLoader };
+//# sourceMappingURL=ng-linguo-linguo-http.mjs.map

package/fesm2022/ng-linguo-linguo-http.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"ng-linguo-linguo-http.mjs","sources":["../../../../packages/linguo/http/src/lib/http-loader.ts","../../../../packages/linguo/http/src/ng-linguo-linguo-http.ts"],"sourcesContent":["import { HttpClient } from '@angular/common/http';\nimport { inject } from '@angular/core';\nimport type { TranslationLoader, Translations } from '@ng-linguo/linguo';\nimport { firstValueFrom } from 'rxjs';\n\n/**\n * Options controlling where {@link createHttpLoader} fetches translation files\n * from. Files are expected to live at `${prefix}${lang}${suffix}` and contain a\n * flat JSON map of keys to strings.\n */\nexport interface HttpLoaderOptions {\n  /** Path prefix for translation files. Defaults to `/assets/i18n/`. */\n  readonly prefix?: string;\n  /** File extension for translation files. Defaults to `.json`. */\n  readonly suffix?: string;\n}\n\n/**\n * Create a {@link TranslationLoader} backed by Angular's `HttpClient`.\n *\n * Must be called within an injection context (it injects `HttpClient`), so\n * construct it inside a factory provider or an `inject`-aware bootstrap path\n * where `provideHttpClient()` is also available. RxJS is used only here, at the\n * I/O boundary, and is converted to the promise the loader interface expects.\n *\n * @example\n * ```ts\n * const loader = createHttpLoader({ prefix: '/i18n/' });\n * ```\n */\nexport function createHttpLoader(options: HttpLoaderOptions = {}): TranslationLoader {\n  const http = inject(HttpClient);\n  const prefix = options.prefix ?? '/assets/i18n/';\n  const suffix = options.suffix ?? '.json';\n  return {\n    load: (lang: string): Promise<Translations> =>\n      firstValueFrom(http.get<Translations>(`${prefix}${lang}${suffix}`)),\n  };\n}\n","/**\n * Generated bundle index. Do not edit.\n */\n\nexport * from './index';\n"],"names":[],"mappings":";;;;AAiBA;;;;;;;;;;;;AAYG;AACG,SAAU,gBAAgB,CAAC,OAAA,GAA6B,EAAE,EAAA;AAC9D,IAAA,MAAM,IAAI,GAAG,MAAM,CAAC,UAAU,CAAC;AAC/B,IAAA,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,eAAe;AAChD,IAAA,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,OAAO;IACxC,OAAO;QACL,IAAI,EAAE,CAAC,IAAY,KACjB,cAAc,CAAC,IAAI,CAAC,GAAG,CAAe,CAAA,EAAG,MAAM,CAAA,EAAG,IAAI,GAAG,MAAM,CAAA,CAAE,CAAC,CAAC;KACtE;AACH;;ACtCA;;AAEG;;;;"}

package/fesm2022/ng-linguo-linguo-icu.mjs

@@ -0,0 +1,104 @@
+import { IntlMessageFormat } from 'intl-messageformat';
+import { MessageFormat } from 'messageformat';
+import { makeEnvironmentProviders } from '@angular/core';
+import { MESSAGE_FORMATTER } from '@ng-linguo/linguo';
+
+const SEP = String.fromCharCode(0);
+const compilers = new Map();
+function compile(message, locale, format) {
+    const cacheKey = `${format}${SEP}${locale}${SEP}${message}`;
+    const cached = compilers.get(cacheKey);
+    if (cached) {
+        return cached;
+    }
+    let render;
+    if (format === 'mf1') {
+        const mf = new IntlMessageFormat(message, locale);
+        render = (args) => {
+            const result = mf.format(args);
+            return Array.isArray(result) ? result.join('') : String(result);
+        };
+    }
+    else {
+        // Disable bidi isolation so output is plain text (no invisible U+2068/U+2069
+        // marks around placeholders), matching MF1 and keeping output predictable.
+        const mf = new MessageFormat(locale, message, { bidiIsolation: 'none' });
+        render = (args) => mf.format(args);
+    }
+    compilers.set(cacheKey, render);
+    return render;
+}
+/**
+ * Format an ICU message against `args` for a locale.
+ *
+ * Defaults to MessageFormat 2.0; pass `format: 'mf1'` for classic ICU. Compiled
+ * messages are memoized per `(format, locale, message)`. On a malformed or
+ * unsupported pattern the raw message is returned rather than throwing, so a
+ * bad string never breaks the view.
+ *
+ * @example
+ * ```ts
+ * formatMessage('{n, plural, one {# file} other {# files}}', { n: 3 }, { locale: 'en', format: 'mf1' });
+ * // '3 files'
+ * ```
+ */
+function formatMessage(message, args, options) {
+    try {
+        return compile(message, options.locale, options.format ?? 'mf2')(args);
+    }
+    catch {
+        return message;
+    }
+}
+
+/**
+ * Enable ICU message formatting for the `translate` pipe.
+ *
+ * Add it next to `provideTranslate`. Once provided, any `translate` call given
+ * an arguments object formats the message as ICU — consumers never touch a
+ * separate ICU pipe or the formatter directly. Defaults to MessageFormat 2.0;
+ * pass `{ defaultFormat: 'mf1' }` for classic ICU.
+ *
+ * @example
+ * ```ts
+ * bootstrapApplication(App, {
+ *   providers: [
+ *     provideTranslate({ defaultLang: 'en', loader }),
+ *     provideIcu(),
+ *   ],
+ * });
+ * // template: {{ '{count, plural, one {# file} other {# files}}' | translate: { count } }}
+ * ```
+ */
+function provideIcu(config) {
+    const format = config?.defaultFormat ?? 'mf2';
+    const formatter = {
+        format: (message, args, locale) => formatMessage(message, args, { locale, format }),
+    };
+    return makeEnvironmentProviders([{ provide: MESSAGE_FORMATTER, useValue: formatter }]);
+}
+
+/**
+ * Select the CLDR plural category for `count` in `locale`, used to pick the
+ * correct ICU plural branch.
+ *
+ * Backed by the platform `Intl.PluralRules`, so it has no Angular dependency
+ * and runs anywhere ICU formatting is needed. The locale is always explicit —
+ * the runtime never reads the ambient browser locale.
+ *
+ * @example
+ * ```ts
+ * selectPlural(1, 'en');  // 'one'
+ * selectPlural(5, 'en');  // 'other'
+ * ```
+ */
+function selectPlural(count, locale) {
+    return new Intl.PluralRules(locale).select(count);
+}
+
+/**
+ * Generated bundle index. Do not edit.
+ */
+
+export { formatMessage, provideIcu, selectPlural };
+//# sourceMappingURL=ng-linguo-linguo-icu.mjs.map

package/fesm2022/ng-linguo-linguo-icu.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"ng-linguo-linguo-icu.mjs","sources":["../../../../packages/linguo/icu/src/lib/format.ts","../../../../packages/linguo/icu/src/lib/provide-icu.ts","../../../../packages/linguo/icu/src/lib/plural.ts","../../../../packages/linguo/icu/src/ng-linguo-linguo-icu.ts"],"sourcesContent":["import { IntlMessageFormat } from 'intl-messageformat';\nimport { MessageFormat } from 'messageformat';\n\n/**\n * Which ICU message syntax a message is written in.\n *\n * - `'mf2'` — Unicode MessageFormat 2.0 (`.input`/`.match`/`{$var :number}`),\n *   the default and future-facing format.\n * - `'mf1'` — classic ICU MessageFormat (`{count, plural, one {#} other {#}}`),\n *   what most existing translation tooling emits today.\n */\nexport type MessageFormatVersion = 'mf2' | 'mf1';\n\n/**\n * Arguments substituted into a message. Values are the primitives the ICU\n * formatters accept (numbers for plurals/number formatting, strings for\n * `select`, `Date` for date/time).\n */\nexport type IcuArgs = Record<string, string | number | boolean | Date | null | undefined>;\n\n/** Options for {@link formatMessage}. */\nexport interface FormatMessageOptions {\n  /** BCP-47 locale used for plural rules and number/date formatting. */\n  readonly locale: string;\n  /** Message syntax to parse. Defaults to `'mf2'`. */\n  readonly format?: MessageFormatVersion;\n}\n\nconst SEP = String.fromCharCode(0);\nconst compilers = new Map<string, (args: IcuArgs) => string>();\n\nfunction compile(\n  message: string,\n  locale: string,\n  format: MessageFormatVersion,\n): (args: IcuArgs) => string {\n  const cacheKey = `${format}${SEP}${locale}${SEP}${message}`;\n  const cached = compilers.get(cacheKey);\n  if (cached) {\n    return cached;\n  }\n\n  let render: (args: IcuArgs) => string;\n  if (format === 'mf1') {\n    const mf = new IntlMessageFormat(message, locale);\n    render = (args) => {\n      const result = mf.format(args);\n      return Array.isArray(result) ? result.join('') : String(result);\n    };\n  } else {\n    // Disable bidi isolation so output is plain text (no invisible U+2068/U+2069\n    // marks around placeholders), matching MF1 and keeping output predictable.\n    const mf = new MessageFormat(locale, message, { bidiIsolation: 'none' });\n    render = (args) => mf.format(args);\n  }\n\n  compilers.set(cacheKey, render);\n  return render;\n}\n\n/**\n * Format an ICU message against `args` for a locale.\n *\n * Defaults to MessageFormat 2.0; pass `format: 'mf1'` for classic ICU. Compiled\n * messages are memoized per `(format, locale, message)`. On a malformed or\n * unsupported pattern the raw message is returned rather than throwing, so a\n * bad string never breaks the view.\n *\n * @example\n * ```ts\n * formatMessage('{n, plural, one {# file} other {# files}}', { n: 3 }, { locale: 'en', format: 'mf1' });\n * // '3 files'\n * ```\n */\nexport function formatMessage(\n  message: string,\n  args: IcuArgs,\n  options: FormatMessageOptions,\n): string {\n  try {\n    return compile(message, options.locale, options.format ?? 'mf2')(args);\n  } catch {\n    return message;\n  }\n}\n","import { type EnvironmentProviders, makeEnvironmentProviders } from '@angular/core';\nimport { MESSAGE_FORMATTER, type MessageFormatter } from '@ng-linguo/linguo';\n\nimport { formatMessage, type IcuArgs, type MessageFormatVersion } from './format';\n\n/**\n * Enable ICU message formatting for the `translate` pipe.\n *\n * Add it next to `provideTranslate`. Once provided, any `translate` call given\n * an arguments object formats the message as ICU — consumers never touch a\n * separate ICU pipe or the formatter directly. Defaults to MessageFormat 2.0;\n * pass `{ defaultFormat: 'mf1' }` for classic ICU.\n *\n * @example\n * ```ts\n * bootstrapApplication(App, {\n *   providers: [\n *     provideTranslate({ defaultLang: 'en', loader }),\n *     provideIcu(),\n *   ],\n * });\n * // template: {{ '{count, plural, one {# file} other {# files}}' | translate: { count } }}\n * ```\n */\nexport function provideIcu(config?: {\n  defaultFormat?: MessageFormatVersion;\n}): EnvironmentProviders {\n  const format = config?.defaultFormat ?? 'mf2';\n  const formatter: MessageFormatter = {\n    format: (message, args, locale) => formatMessage(message, args as IcuArgs, { locale, format }),\n  };\n  return makeEnvironmentProviders([{ provide: MESSAGE_FORMATTER, useValue: formatter }]);\n}\n","/**\n * The CLDR plural categories. A given locale uses a subset of these; English,\n * for example, only distinguishes `'one'` and `'other'`.\n */\nexport type PluralCategory = Intl.LDMLPluralRule;\n\n/**\n * Select the CLDR plural category for `count` in `locale`, used to pick the\n * correct ICU plural branch.\n *\n * Backed by the platform `Intl.PluralRules`, so it has no Angular dependency\n * and runs anywhere ICU formatting is needed. The locale is always explicit —\n * the runtime never reads the ambient browser locale.\n *\n * @example\n * ```ts\n * selectPlural(1, 'en');  // 'one'\n * selectPlural(5, 'en');  // 'other'\n * ```\n */\nexport function selectPlural(count: number, locale: string): PluralCategory {\n  return new Intl.PluralRules(locale).select(count);\n}\n","/**\n * Generated bundle index. Do not edit.\n */\n\nexport * from './index';\n"],"names":[],"mappings":";;;;;AA4BA,MAAM,GAAG,GAAG,MAAM,CAAC,YAAY,CAAC,CAAC,CAAC;AAClC,MAAM,SAAS,GAAG,IAAI,GAAG,EAAqC;AAE9D,SAAS,OAAO,CACd,OAAe,EACf,MAAc,EACd,MAA4B,EAAA;AAE5B,IAAA,MAAM,QAAQ,GAAG,CAAA,EAAG,MAAM,CAAA,EAAG,GAAG,CAAA,EAAG,MAAM,CAAA,EAAG,GAAG,CAAA,EAAG,OAAO,EAAE;IAC3D,MAAM,MAAM,GAAG,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC;IACtC,IAAI,MAAM,EAAE;AACV,QAAA,OAAO,MAAM;IACf;AAEA,IAAA,IAAI,MAAiC;AACrC,IAAA,IAAI,MAAM,KAAK,KAAK,EAAE;QACpB,MAAM,EAAE,GAAG,IAAI,iBAAiB,CAAC,OAAO,EAAE,MAAM,CAAC;AACjD,QAAA,MAAM,GAAG,CAAC,IAAI,KAAI;YAChB,MAAM,MAAM,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC;YAC9B,OAAO,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC;AACjE,QAAA,CAAC;IACH;SAAO;;;AAGL,QAAA,MAAM,EAAE,GAAG,IAAI,aAAa,CAAC,MAAM,EAAE,OAAO,EAAE,EAAE,aAAa,EAAE,MAAM,EAAE,CAAC;AACxE,QAAA,MAAM,GAAG,CAAC,IAAI,KAAK,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC;IACpC;AAEA,IAAA,SAAS,CAAC,GAAG,CAAC,QAAQ,EAAE,MAAM,CAAC;AAC/B,IAAA,OAAO,MAAM;AACf;AAEA;;;;;;;;;;;;;AAaG;SACa,aAAa,CAC3B,OAAe,EACf,IAAa,EACb,OAA6B,EAAA;AAE7B,IAAA,IAAI;AACF,QAAA,OAAO,OAAO,CAAC,OAAO,EAAE,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,KAAK,CAAC,CAAC,IAAI,CAAC;IACxE;AAAE,IAAA,MAAM;AACN,QAAA,OAAO,OAAO;IAChB;AACF;;AC/EA;;;;;;;;;;;;;;;;;;AAkBG;AACG,SAAU,UAAU,CAAC,MAE1B,EAAA;AACC,IAAA,MAAM,MAAM,GAAG,MAAM,EAAE,aAAa,IAAI,KAAK;AAC7C,IAAA,MAAM,SAAS,GAAqB;QAClC,MAAM,EAAE,CAAC,OAAO,EAAE,IAAI,EAAE,MAAM,KAAK,aAAa,CAAC,OAAO,EAAE,IAAe,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;KAC/F;AACD,IAAA,OAAO,wBAAwB,CAAC,CAAC,EAAE,OAAO,EAAE,iBAAiB,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC,CAAC;AACxF;;AC1BA;;;;;;;;;;;;;AAaG;AACG,SAAU,YAAY,CAAC,KAAa,EAAE,MAAc,EAAA;AACxD,IAAA,OAAO,IAAI,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;AACnD;;ACtBA;;AAEG;;;;"}