@ozzylabs/feedradar 0.2.1 → 0.2.3

package/dist/i18n/index.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Type-safe translator factory (ADR-0021, epic #307 P2).
+ *
+ * `createTranslator(locale)` returns a `t(key, params?)` function bound to a
+ * locale. The design constraints (from issue #310):
+ *
+ *   - **Type-safe keys.** `key` is `keyof typeof en` (= {@link MessageKey}); a
+ *     typo is a compile error.
+ *   - **Type-safe params.** Whether `t` accepts (and requires) a `params`
+ *     argument is derived per-key from the catalog entry: string entries take
+ *     no params, function entries require their declared params object. This is
+ *     the single unified interpolation scheme — function args, no placeholder
+ *     string-replacement.
+ *   - **en fallback for missing keys.** If a locale catalog is somehow missing
+ *     a key at runtime (it cannot be under the {@link Messages} type, but we
+ *     stay defensive for hand-edited / future dynamically-merged catalogs), the
+ *     English entry is used.
+ *   - **No global singleton.** Each command resolves its own locale (config is
+ *     cwd-dependent and read per command — see `src/core/config.ts`) and builds
+ *     its own translator; there is no module-level shared translator.
+ *   - **No new runtime dependency.**
+ *
+ * Wiring convention established here (followed by later P3/P4/P5 issues): a
+ * command resolves its locale (`src/cli/_locale.ts` + `resolveLocale`, plus
+ * `loadRadarConfig` for config-aware commands), calls {@link createTranslator},
+ * and threads the resulting `t` through `options` alongside the existing
+ * `options.io` log/warn/error sinks. `t` produces the strings, `io` writes
+ * them — same output path as today, just localized copy.
+ */
+import type { Locale } from "../core/locale.js";
+import { en, type MessageKey } from "./messages/en.js";
+/**
+ * Params accepted by a single catalog entry. A `string` entry has no params
+ * (`undefined`); a function entry has the type of its first argument.
+ */
+type ParamsOf<K extends MessageKey> = (typeof en)[K] extends (params: infer P) => string ? P : undefined;
+/**
+ * `t` overloads keep call sites honest: keys whose catalog value is a plain
+ * string reject a params argument, keys whose value is a function require the
+ * matching params object.
+ */
+export interface Translator {
+    <K extends MessageKey>(key: ParamsOf<K> extends undefined ? K : never): string;
+    <K extends MessageKey>(key: K, params: ParamsOf<K>): string;
+}
+/**
+ * Build a translator bound to `locale`.
+ *
+ * Resolution order per key: the requested locale's entry, else the English
+ * entry (defensive fallback — see module docs). The resolved entry is rendered
+ * by calling it with `params` when it is a function, or returned verbatim when
+ * it is a string.
+ */
+export declare function createTranslator(locale: Locale): Translator;
+export type { Locale } from "../core/locale.js";
+export type { MessageKey, Messages } from "./messages/en.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/i18n/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/i18n/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,EAAE,EAAE,KAAK,UAAU,EAAiB,MAAM,kBAAkB,CAAC;AAMtE;;;GAGG;AACH,KAAK,QAAQ,CAAC,CAAC,SAAS,UAAU,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,KAAK,MAAM,GACpF,CAAC,GACD,SAAS,CAAC;AAEd;;;;GAIG;AACH,MAAM,WAAW,UAAU;IACzB,CAAC,CAAC,SAAS,UAAU,EAAE,GAAG,EAAE,QAAQ,CAAC,CAAC,CAAC,SAAS,SAAS,GAAG,CAAC,GAAG,KAAK,GAAG,MAAM,CAAC;IAC/E,CAAC,CAAC,SAAS,UAAU,EAAE,GAAG,EAAE,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC;CAC7D;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,UAAU,CAM3D;AAED,YAAY,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAChD,YAAY,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/i18n/index.js

@@ -0,0 +1,49 @@
+/**
+ * Type-safe translator factory (ADR-0021, epic #307 P2).
+ *
+ * `createTranslator(locale)` returns a `t(key, params?)` function bound to a
+ * locale. The design constraints (from issue #310):
+ *
+ *   - **Type-safe keys.** `key` is `keyof typeof en` (= {@link MessageKey}); a
+ *     typo is a compile error.
+ *   - **Type-safe params.** Whether `t` accepts (and requires) a `params`
+ *     argument is derived per-key from the catalog entry: string entries take
+ *     no params, function entries require their declared params object. This is
+ *     the single unified interpolation scheme — function args, no placeholder
+ *     string-replacement.
+ *   - **en fallback for missing keys.** If a locale catalog is somehow missing
+ *     a key at runtime (it cannot be under the {@link Messages} type, but we
+ *     stay defensive for hand-edited / future dynamically-merged catalogs), the
+ *     English entry is used.
+ *   - **No global singleton.** Each command resolves its own locale (config is
+ *     cwd-dependent and read per command — see `src/core/config.ts`) and builds
+ *     its own translator; there is no module-level shared translator.
+ *   - **No new runtime dependency.**
+ *
+ * Wiring convention established here (followed by later P3/P4/P5 issues): a
+ * command resolves its locale (`src/cli/_locale.ts` + `resolveLocale`, plus
+ * `loadRadarConfig` for config-aware commands), calls {@link createTranslator},
+ * and threads the resulting `t` through `options` alongside the existing
+ * `options.io` log/warn/error sinks. `t` produces the strings, `io` writes
+ * them — same output path as today, just localized copy.
+ */
+import { en } from "./messages/en.js";
+import { ja } from "./messages/ja.js";
+/** Locale → catalog lookup. `en` is also the missing-key fallback source. */
+const catalogs = { en, ja };
+/**
+ * Build a translator bound to `locale`.
+ *
+ * Resolution order per key: the requested locale's entry, else the English
+ * entry (defensive fallback — see module docs). The resolved entry is rendered
+ * by calling it with `params` when it is a function, or returned verbatim when
+ * it is a string.
+ */
+export function createTranslator(locale) {
+    const primary = catalogs[locale] ?? en;
+    return ((key, params) => {
+        const entry = (primary[key] ?? en[key]);
+        return typeof entry === "function" ? entry(params) : entry;
+    });
+}
+//# sourceMappingURL=index.js.map

package/dist/i18n/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/i18n/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAGH,OAAO,EAAE,EAAE,EAAkC,MAAM,kBAAkB,CAAC;AACtE,OAAO,EAAE,EAAE,EAAE,MAAM,kBAAkB,CAAC;AAEtC,6EAA6E;AAC7E,MAAM,QAAQ,GAA6B,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC;AAoBtD;;;;;;;GAOG;AACH,MAAM,UAAU,gBAAgB,CAAC,MAAc;IAC7C,MAAM,OAAO,GAAG,QAAQ,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;IACvC,OAAO,CAAC,CAAC,GAAe,EAAE,MAAgB,EAAU,EAAE;QACpD,MAAM,KAAK,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAA2C,CAAC;QAClF,OAAO,OAAO,KAAK,KAAK,UAAU,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;IAC7D,CAAC,CAAe,CAAC;AACnB,CAAC"}