@xndrjs/i18n 0.2.0 → 0.3.0

package/src/codegen/emit/dictionary-schema-file.ts

@@ -1,6 +1,6 @@
 import type { VariableSpec } from "../../icu/extract-variables.js";
-import { GENERATED_FILE_BANNER } from "../paths.js";
-import type { NamespaceEntry } from "../types.js";
+import { GENERATED_FILE_BANNER, toRelativeModuleImport } from "../paths.js";
+import type { ImportExtension, NamespaceEntry } from "../types.js";
 
 function formatVariableSpecObject(spec: VariableSpec): string {
   const entries = Object.entries(spec);
@@ -70,8 +70,10 @@ export function formatDictionarySchemaFile(
   schemaTypeName: string,
   typesModule: string,
   isSingle: boolean,
-  dictionarySpecBlock: string
+  dictionarySpecBlock: string,
+  importExtension: ImportExtension
 ): string {
+  const typesImport = toRelativeModuleImport(typesModule, importExtension);
   const namespaceImport = isSingle
     ? ""
     : `  validateExternalNamespace as validateExternalNamespaceImpl,\n`;
@@ -99,7 +101,7 @@ export function formatDictionarySchemaFile(
     `  type NormalizedDictionary,\n` +
     `  type ValidationResult,\n` +
     `} from '@xndrjs/i18n/validation';\n` +
-    `import type { ${schemaTypeName} } from './${typesModule}.js';\n\n` +
+    `import type { ${schemaTypeName} } from '${typesImport}';\n\n` +
     `${dictionarySpecBlock}\n` +
     `export function normalizeExternalDictionary(\n` +
     `  input: unknown,\n` +

package/src/codegen/emit/instance-file.ts

@@ -1,4 +1,5 @@
-import { GENERATED_FILE_BANNER, toModuleBasename } from "../paths.js";
+import { GENERATED_FILE_BANNER, toModuleBasename, toRelativeModuleImport } from "../paths.js";
+import type { ImportExtension } from "../types.js";
 
 export interface InstanceFileOptions {
   isSingle: boolean;
@@ -11,6 +12,7 @@ export interface InstanceFileOptions {
   localeFallbackConstName: string;
   factoryName: string;
   hasLocaleFallback: boolean;
+  importExtension: ImportExtension;
 }
 
 export function formatInstanceFile(options: InstanceFileOptions): string {
@@ -25,15 +27,18 @@ export function formatInstanceFile(options: InstanceFileOptions): string {
     localeFallbackConstName,
     factoryName,
     hasLocaleFallback,
+    importExtension,
   } = options;
 
   const providerClass = isSingle ? "IcuTranslationProviderSingle" : "IcuTranslationProviderMulti";
   const typesModule = toModuleBasename(typesOutputPath);
   const dictionaryModule = toModuleBasename(dictionaryOutputPath);
+  const typesImport = toRelativeModuleImport(typesModule, importExtension);
+  const dictionaryImport = toRelativeModuleImport(dictionaryModule, importExtension);
   const initialDictionaryType = hasLazy ? "InitialSchema" : schemaTypeName;
   const initialDictionaryImport = hasLazy
-    ? `import type { ${paramsTypeName}, ${schemaTypeName}, InitialSchema } from './${typesModule}.js';\n`
-    : `import type { ${paramsTypeName}, ${schemaTypeName} } from './${typesModule}.js';\n`;
+    ? `import type { ${paramsTypeName}, ${schemaTypeName}, InitialSchema } from '${typesImport}';\n`
+    : `import type { ${paramsTypeName}, ${schemaTypeName} } from '${typesImport}';\n`;
   const providerTypeArgs = hasLocaleFallback
     ? `${schemaTypeName}, ${paramsTypeName}, ${localeTypeName}, typeof ${localeFallbackConstName}`
     : `${schemaTypeName}, ${paramsTypeName}`;
@@ -41,13 +46,13 @@ export function formatInstanceFile(options: InstanceFileOptions): string {
     ? `, {\n    localeFallback: ${localeFallbackConstName},\n  }`
     : "";
   const fallbackImport = hasLocaleFallback
-    ? `import { ${localeFallbackConstName}, type ${localeTypeName} } from './${typesModule}.js';\n`
+    ? `import { ${localeFallbackConstName}, type ${localeTypeName} } from '${typesImport}';\n`
     : "";
 
   return (
     `${GENERATED_FILE_BANNER}` +
     `import { ${providerClass} } from '@xndrjs/i18n';\n` +
-    `import { dictionary } from './${dictionaryModule}.js';\n` +
+    `import { dictionary } from '${dictionaryImport}';\n` +
     initialDictionaryImport +
     fallbackImport +
     `\n` +

package/src/codegen/emit/namespace-loaders-file.ts

@@ -1,5 +1,5 @@
-import { GENERATED_FILE_BANNER, toImportPath } from "../paths.js";
-import type { NamespaceEntry } from "../types.js";
+import { GENERATED_FILE_BANNER, toImportPath, toRelativeModuleImport } from "../paths.js";
+import type { ImportExtension, NamespaceEntry } from "../types.js";
 
 export function formatNamespaceLoadersFile(
   loadersOutputPath: string,
@@ -8,8 +8,12 @@ export function formatNamespaceLoadersFile(
   typesModule: string,
   dictionarySchemaModule: string,
   instanceModule: string,
-  factoryName: string
+  factoryName: string,
+  importExtension: ImportExtension
 ): string {
+  const dictionarySchemaImport = toRelativeModuleImport(dictionarySchemaModule, importExtension);
+  const typesImport = toRelativeModuleImport(typesModule, importExtension);
+  const instanceImport = toRelativeModuleImport(instanceModule, importExtension);
   const loaderEntries = lazyEntries
     .map((entry) => {
       const importPath = toImportPath(loadersOutputPath, entry.absolutePath);
@@ -20,9 +24,9 @@ export function formatNamespaceLoadersFile(
   return (
     `${GENERATED_FILE_BANNER}` +
     `import { ensureNamespacesLoadedImpl } from '@xndrjs/i18n';\n` +
-    `import { validateExternalNamespace } from './${dictionarySchemaModule}.js';\n` +
-    `import type { ${schemaTypeName}, LazyNamespace } from './${typesModule}.js';\n` +
-    `import type { ${factoryName} } from './${instanceModule}.js';\n\n` +
+    `import { validateExternalNamespace } from '${dictionarySchemaImport}';\n` +
+    `import type { ${schemaTypeName}, LazyNamespace } from '${typesImport}';\n` +
+    `import type { ${factoryName} } from '${instanceImport}';\n\n` +
     `export const namespaceLoaders: Record<\n` +
     `  LazyNamespace,\n` +
     `  () => Promise<${schemaTypeName}[LazyNamespace]>\n` +

package/src/codegen/generate-i18n-types.test.ts

@@ -294,6 +294,73 @@ describe("generate-i18n-types", () => {
     );
   });
 
+  it("enriches LOCALE_FALLBACK with null for dictionary locales missing from config", () => {
+    tempDir = mkdtempSync(join(tmpdir(), "xndrjs-i18n-codegen-"));
+    mkdirSync(join(tempDir, "src/i18n/translations"), { recursive: true });
+
+    writeFileSync(
+      join(tempDir, "src/i18n/translations/translations.json"),
+      JSON.stringify({
+        login_button: { en: "Login", fr: "Connexion" },
+      })
+    );
+    writeFileSync(
+      join(tempDir, "i18n.codegen.json"),
+      JSON.stringify({
+        dictionary: "src/i18n/translations/translations.json",
+        typesOutput: "src/i18n/i18n-types.generated.ts",
+        dictionaryOutput: "src/i18n/dictionary.generated.ts",
+        instanceOutput: "src/i18n/instance.generated.ts",
+        paramsTypeName: "AppParams",
+        schemaTypeName: "AppSchema",
+        localeFallback: {
+          en: null,
+          it: "en",
+        },
+      })
+    );
+
+    const result = runCodegen(tempDir);
+    expect(result.status).toBe(0);
+
+    const types = readFileSync(join(tempDir, "src/i18n/i18n-types.generated.ts"), "utf8");
+    expect(types).toContain('"fr": null');
+    expect(types).toContain('"it": "en"');
+    expect(types).toContain("export type AppLocale = 'en' | 'fr' | 'it'");
+  });
+
+  it("does not emit LOCALE_FALLBACK when localeFallback is absent from config", () => {
+    tempDir = mkdtempSync(join(tmpdir(), "xndrjs-i18n-codegen-"));
+    mkdirSync(join(tempDir, "src/i18n/translations"), { recursive: true });
+
+    writeFileSync(
+      join(tempDir, "src/i18n/translations/translations.json"),
+      JSON.stringify({
+        login_button: { en: "Login", it: "Accedi" },
+      })
+    );
+    writeFileSync(
+      join(tempDir, "i18n.codegen.json"),
+      JSON.stringify({
+        dictionary: "src/i18n/translations/translations.json",
+        typesOutput: "src/i18n/i18n-types.generated.ts",
+        dictionaryOutput: "src/i18n/dictionary.generated.ts",
+        instanceOutput: "src/i18n/instance.generated.ts",
+        paramsTypeName: "AppParams",
+        schemaTypeName: "AppSchema",
+      })
+    );
+
+    const result = runCodegen(tempDir);
+    expect(result.status).toBe(0);
+
+    const types = readFileSync(join(tempDir, "src/i18n/i18n-types.generated.ts"), "utf8");
+    const factory = readFileSync(join(tempDir, "src/i18n/instance.generated.ts"), "utf8");
+    expect(types).not.toContain("export const LOCALE_FALLBACK");
+    expect(factory).not.toContain("localeFallback:");
+    expect(types).toContain("export type AppLocale = 'en' | 'it'");
+  });
+
   it("fails on circular locale fallback in config", () => {
     tempDir = mkdtempSync(join(tmpdir(), "xndrjs-i18n-codegen-"));
     mkdirSync(join(tempDir, "src/i18n/translations"), { recursive: true });
@@ -448,6 +515,128 @@ describe("generate-i18n-types", () => {
     expect(result.stderr).toContain("loadOnInit");
   });
 
+  it("infers number when English plural and Italian simple interpolation share a key", () => {
+    tempDir = mkdtempSync(join(tmpdir(), "xndrjs-i18n-codegen-"));
+    mkdirSync(join(tempDir, "src/i18n/translations"), { recursive: true });
+
+    writeFileSync(
+      join(tempDir, "src/i18n/translations/translations.json"),
+      JSON.stringify({
+        invoice_count: {
+          en: "You have {count, plural, one {1 invoice} other {# invoices}}",
+          it: "Hai {count} fatture",
+        },
+      })
+    );
+    writeFileSync(
+      join(tempDir, "i18n.codegen.json"),
+      JSON.stringify({
+        dictionary: "src/i18n/translations/translations.json",
+        typesOutput: "src/i18n/i18n-types.generated.ts",
+        dictionaryOutput: "src/i18n/dictionary.generated.ts",
+        instanceOutput: "src/i18n/instance.generated.ts",
+        paramsTypeName: "AppParams",
+        schemaTypeName: "AppSchema",
+      })
+    );
+
+    const result = runCodegen(tempDir);
+    expect(result.status).toBe(0);
+
+    const types = readFileSync(join(tempDir, "src/i18n/i18n-types.generated.ts"), "utf8");
+    expect(types).toContain("invoice_count: { count: number }");
+  });
+
+  it("fails when plural and select disagree on the same variable across locales", () => {
+    tempDir = mkdtempSync(join(tmpdir(), "xndrjs-i18n-codegen-"));
+    mkdirSync(join(tempDir, "src/i18n/translations"), { recursive: true });
+
+    writeFileSync(
+      join(tempDir, "src/i18n/translations/translations.json"),
+      JSON.stringify({
+        broken: {
+          en: "{myVar, select, other {x}}",
+          it: "{myVar, plural, one {1} other {#}}",
+        },
+      })
+    );
+    writeFileSync(
+      join(tempDir, "i18n.codegen.json"),
+      JSON.stringify({
+        dictionary: "src/i18n/translations/translations.json",
+        typesOutput: "src/i18n/i18n-types.generated.ts",
+        dictionaryOutput: "src/i18n/dictionary.generated.ts",
+        instanceOutput: "src/i18n/instance.generated.ts",
+        paramsTypeName: "AppParams",
+        schemaTypeName: "AppSchema",
+      })
+    );
+
+    const result = runCodegen(tempDir);
+    expect(result.status).not.toBe(0);
+    expect(result.stderr).toContain('Incompatible ICU variable "myVar"');
+  });
+
+  it("fails when plural and selectordinal disagree on the same variable across locales", () => {
+    tempDir = mkdtempSync(join(tmpdir(), "xndrjs-i18n-codegen-"));
+    mkdirSync(join(tempDir, "src/i18n/translations"), { recursive: true });
+
+    writeFileSync(
+      join(tempDir, "src/i18n/translations/translations.json"),
+      JSON.stringify({
+        broken: {
+          en: "{rank, plural, one {1} other {#}}",
+          it: "{rank, selectordinal, one {#°} other {#°}}",
+        },
+      })
+    );
+    writeFileSync(
+      join(tempDir, "i18n.codegen.json"),
+      JSON.stringify({
+        dictionary: "src/i18n/translations/translations.json",
+        typesOutput: "src/i18n/i18n-types.generated.ts",
+        dictionaryOutput: "src/i18n/dictionary.generated.ts",
+        instanceOutput: "src/i18n/instance.generated.ts",
+        paramsTypeName: "AppParams",
+        schemaTypeName: "AppSchema",
+      })
+    );
+
+    const result = runCodegen(tempDir);
+    expect(result.status).not.toBe(0);
+    expect(result.stderr).toContain('Incompatible ICU variable "rank"');
+  });
+
+  it("fails when select and number format disagree on the same variable across locales", () => {
+    tempDir = mkdtempSync(join(tmpdir(), "xndrjs-i18n-codegen-"));
+    mkdirSync(join(tempDir, "src/i18n/translations"), { recursive: true });
+
+    writeFileSync(
+      join(tempDir, "src/i18n/translations/translations.json"),
+      JSON.stringify({
+        broken: {
+          en: "{value, select, other {x}}",
+          it: "{value, number}",
+        },
+      })
+    );
+    writeFileSync(
+      join(tempDir, "i18n.codegen.json"),
+      JSON.stringify({
+        dictionary: "src/i18n/translations/translations.json",
+        typesOutput: "src/i18n/i18n-types.generated.ts",
+        dictionaryOutput: "src/i18n/dictionary.generated.ts",
+        instanceOutput: "src/i18n/instance.generated.ts",
+        paramsTypeName: "AppParams",
+        schemaTypeName: "AppSchema",
+      })
+    );
+
+    const result = runCodegen(tempDir);
+    expect(result.status).not.toBe(0);
+    expect(result.stderr).toContain('Incompatible ICU variable "value"');
+  });
+
   it("keeps multi mode when namespaces has a single entry", () => {
     tempDir = mkdtempSync(join(tmpdir(), "xndrjs-i18n-codegen-"));
     mkdirSync(join(tempDir, "src/i18n/translations"), { recursive: true });
@@ -479,4 +668,311 @@ describe("generate-i18n-types", () => {
     expect(types).toContain("default: {");
     expect(factory).toContain("IcuTranslationProviderMulti");
   });
+
+  it("omits import extension by default between generated modules", () => {
+    tempDir = mkdtempSync(join(tmpdir(), "xndrjs-i18n-codegen-"));
+    mkdirSync(join(tempDir, "src/i18n/translations"), { recursive: true });
+
+    writeFileSync(
+      join(tempDir, "src/i18n/translations/translations.json"),
+      JSON.stringify({ welcome: { en: "Welcome {name}!" } })
+    );
+    writeFileSync(
+      join(tempDir, "i18n.codegen.json"),
+      JSON.stringify({
+        dictionary: "src/i18n/translations/translations.json",
+        typesOutput: "src/i18n/i18n-types.generated.ts",
+        dictionaryOutput: "src/i18n/dictionary.generated.ts",
+        instanceOutput: "src/i18n/instance.generated.ts",
+        paramsTypeName: "AppParams",
+        schemaTypeName: "AppSchema",
+      })
+    );
+
+    const result = runCodegen(tempDir);
+    expect(result.status).toBe(0);
+
+    const dictionary = readFileSync(join(tempDir, "src/i18n/dictionary.generated.ts"), "utf8");
+    const factory = readFileSync(join(tempDir, "src/i18n/instance.generated.ts"), "utf8");
+    expect(dictionary).toContain("from './i18n-types.generated'");
+    expect(factory).toContain("from './dictionary.generated'");
+    expect(factory).toContain("from './i18n-types.generated'");
+    expect(dictionary).not.toContain(".generated.js");
+    expect(dictionary).not.toContain(".generated.ts");
+    expect(factory).not.toContain(".generated.js");
+    expect(factory).not.toContain(".generated.ts");
+  });
+
+  it("supports importExtension .ts", () => {
+    tempDir = mkdtempSync(join(tmpdir(), "xndrjs-i18n-codegen-"));
+    mkdirSync(join(tempDir, "src/i18n/translations"), { recursive: true });
+
+    writeFileSync(
+      join(tempDir, "src/i18n/translations/translations.json"),
+      JSON.stringify({ welcome: { en: "Welcome {name}!" } })
+    );
+    writeFileSync(
+      join(tempDir, "i18n.codegen.json"),
+      JSON.stringify({
+        dictionary: "src/i18n/translations/translations.json",
+        typesOutput: "src/i18n/i18n-types.generated.ts",
+        dictionaryOutput: "src/i18n/dictionary.generated.ts",
+        instanceOutput: "src/i18n/instance.generated.ts",
+        importExtension: ".ts",
+        paramsTypeName: "AppParams",
+        schemaTypeName: "AppSchema",
+      })
+    );
+
+    const result = runCodegen(tempDir);
+    expect(result.status).toBe(0);
+
+    const factory = readFileSync(join(tempDir, "src/i18n/instance.generated.ts"), "utf8");
+    expect(factory).toContain("from './dictionary.generated.ts'");
+    expect(factory).toContain("from './i18n-types.generated.ts'");
+  });
+
+  it("supports importExtension .js for NodeNext ESM projects", () => {
+    tempDir = mkdtempSync(join(tmpdir(), "xndrjs-i18n-codegen-"));
+    mkdirSync(join(tempDir, "src/i18n/translations"), { recursive: true });
+
+    writeFileSync(
+      join(tempDir, "src/i18n/translations/translations.json"),
+      JSON.stringify({ welcome: { en: "Welcome {name}!" } })
+    );
+    writeFileSync(
+      join(tempDir, "i18n.codegen.json"),
+      JSON.stringify({
+        dictionary: "src/i18n/translations/translations.json",
+        typesOutput: "src/i18n/i18n-types.generated.ts",
+        dictionaryOutput: "src/i18n/dictionary.generated.ts",
+        instanceOutput: "src/i18n/instance.generated.ts",
+        importExtension: ".js",
+        paramsTypeName: "AppParams",
+        schemaTypeName: "AppSchema",
+      })
+    );
+
+    const result = runCodegen(tempDir);
+    expect(result.status).toBe(0);
+
+    const factory = readFileSync(join(tempDir, "src/i18n/instance.generated.ts"), "utf8");
+    expect(factory).toContain("from './dictionary.generated.js'");
+    expect(factory).toContain("from './i18n-types.generated.js'");
+  });
+
+  it("fails when importExtension is invalid", () => {
+    tempDir = mkdtempSync(join(tmpdir(), "xndrjs-i18n-codegen-"));
+    mkdirSync(join(tempDir, "src/i18n/translations"), { recursive: true });
+
+    writeFileSync(
+      join(tempDir, "src/i18n/translations/translations.json"),
+      JSON.stringify({ welcome: { en: "Welcome {name}!" } })
+    );
+    writeFileSync(
+      join(tempDir, "i18n.codegen.json"),
+      JSON.stringify({
+        dictionary: "src/i18n/translations/translations.json",
+        typesOutput: "src/i18n/i18n-types.generated.ts",
+        dictionaryOutput: "src/i18n/dictionary.generated.ts",
+        instanceOutput: "src/i18n/instance.generated.ts",
+        importExtension: ".mjs",
+        paramsTypeName: "AppParams",
+        schemaTypeName: "AppSchema",
+      })
+    );
+
+    const result = runCodegen(tempDir);
+    expect(result.status).not.toBe(0);
+    expect(result.stderr).toContain('importExtension must be "none", ".ts", or ".js"');
+  });
+
+  it("compiles yaml dictionaries to json and generates json imports", () => {
+    tempDir = mkdtempSync(join(tmpdir(), "xndrjs-i18n-codegen-"));
+    mkdirSync(join(tempDir, "src/i18n/translations"), { recursive: true });
+    mkdirSync(join(tempDir, "src/i18n/generated"), { recursive: true });
+
+    writeFileSync(
+      join(tempDir, "src/i18n/translations/translations.yaml"),
+      `welcome:
+  en: |
+    Line one
+    Line two
+  it: |
+    Riga uno
+    Riga due
+`
+    );
+    writeFileSync(
+      join(tempDir, "i18n.codegen.json"),
+      JSON.stringify({
+        dictionary: "src/i18n/translations/translations.yaml",
+        typesOutput: "src/i18n/generated/i18n-types.generated.ts",
+        dictionaryOutput: "src/i18n/generated/dictionary.generated.ts",
+        instanceOutput: "src/i18n/generated/instance.generated.ts",
+        paramsTypeName: "AppParams",
+        schemaTypeName: "AppSchema",
+      })
+    );
+
+    const result = runCodegen(tempDir);
+    expect(result.status).toBe(0);
+    expect(result.stdout).toContain(
+      "Compiled: src/i18n/translations/translations.yaml → src/i18n/generated/translations/translations.json"
+    );
+
+    const compiled = JSON.parse(
+      readFileSync(join(tempDir, "src/i18n/generated/translations/translations.json"), "utf8")
+    ) as Record<string, Record<string, string>>;
+    expect(compiled.welcome?.en).toBe("Line one\nLine two\n");
+
+    const dictionary = readFileSync(
+      join(tempDir, "src/i18n/generated/dictionary.generated.ts"),
+      "utf8"
+    );
+    const types = readFileSync(join(tempDir, "src/i18n/generated/i18n-types.generated.ts"), "utf8");
+    expect(dictionary).toContain("from './translations/translations.json'");
+    expect(types).toContain("typeof import('./translations/translations.json')");
+  });
+
+  it("supports mixed json and yaml namespaces", () => {
+    tempDir = mkdtempSync(join(tmpdir(), "xndrjs-i18n-codegen-"));
+    mkdirSync(join(tempDir, "src/i18n/translations"), { recursive: true });
+    mkdirSync(join(tempDir, "src/i18n/generated"), { recursive: true });
+
+    writeFileSync(
+      join(tempDir, "src/i18n/translations/default.json"),
+      JSON.stringify({
+        login_button: { en: "Login", it: "Accedi" },
+      })
+    );
+    writeFileSync(
+      join(tempDir, "src/i18n/translations/billing.yaml"),
+      `invoice_summary:
+  en: You have {count} invoices
+`
+    );
+    writeFileSync(
+      join(tempDir, "i18n.codegen.json"),
+      JSON.stringify({
+        namespaces: {
+          default: "src/i18n/translations/default.json",
+          billing: "src/i18n/translations/billing.yaml",
+        },
+        typesOutput: "src/i18n/generated/i18n-types.generated.ts",
+        dictionaryOutput: "src/i18n/generated/dictionary.generated.ts",
+        instanceOutput: "src/i18n/generated/instance.generated.ts",
+        paramsTypeName: "AppParams",
+        schemaTypeName: "AppSchema",
+      })
+    );
+
+    const result = runCodegen(tempDir);
+    expect(result.status).toBe(0);
+
+    const dictionary = readFileSync(
+      join(tempDir, "src/i18n/generated/dictionary.generated.ts"),
+      "utf8"
+    );
+    const types = readFileSync(join(tempDir, "src/i18n/generated/i18n-types.generated.ts"), "utf8");
+    expect(dictionary).toContain("from '../translations/default.json'");
+    expect(dictionary).toContain("from './translations/billing.json'");
+    expect(types).toContain("default: typeof import('../translations/default.json')");
+    expect(types).toContain("billing: typeof import('./translations/billing.json')");
+  });
+
+  it("generates lazy loaders that import compiled json for yaml namespaces", () => {
+    tempDir = mkdtempSync(join(tmpdir(), "xndrjs-i18n-codegen-"));
+    mkdirSync(join(tempDir, "src/i18n/translations"), { recursive: true });
+    mkdirSync(join(tempDir, "src/i18n/generated"), { recursive: true });
+
+    writeFileSync(
+      join(tempDir, "src/i18n/translations/default.json"),
+      JSON.stringify({
+        login_button: { en: "Login" },
+      })
+    );
+    writeFileSync(
+      join(tempDir, "src/i18n/translations/billing.yaml"),
+      `invoice_summary:
+  en: You have {count} invoices
+`
+    );
+    writeFileSync(
+      join(tempDir, "i18n.codegen.json"),
+      JSON.stringify({
+        namespaces: {
+          default: "src/i18n/translations/default.json",
+          billing: "src/i18n/translations/billing.yaml",
+        },
+        loadOnInit: ["default"],
+        typesOutput: "src/i18n/generated/i18n-types.generated.ts",
+        dictionaryOutput: "src/i18n/generated/dictionary.generated.ts",
+        instanceOutput: "src/i18n/generated/instance.generated.ts",
+        dictionarySchemaOutput: "src/i18n/generated/dictionary-schema.generated.ts",
+        namespaceLoadersOutput: "src/i18n/generated/namespace-loaders.generated.ts",
+        paramsTypeName: "AppParams",
+        schemaTypeName: "AppSchema",
+      })
+    );
+
+    const result = runCodegen(tempDir);
+    expect(result.status).toBe(0);
+
+    const loaders = readFileSync(
+      join(tempDir, "src/i18n/generated/namespace-loaders.generated.ts"),
+      "utf8"
+    );
+    expect(loaders).toContain("import('./translations/billing.json')");
+    expect(loaders).not.toContain("billing.yaml");
+  });
+
+  it("fails when dictionary extension is unsupported", () => {
+    tempDir = mkdtempSync(join(tmpdir(), "xndrjs-i18n-codegen-"));
+    mkdirSync(join(tempDir, "src/i18n/translations"), { recursive: true });
+
+    writeFileSync(join(tempDir, "src/i18n/translations/translations.toml"), "welcome = {}");
+    writeFileSync(
+      join(tempDir, "i18n.codegen.json"),
+      JSON.stringify({
+        dictionary: "src/i18n/translations/translations.toml",
+        typesOutput: "src/i18n/i18n-types.generated.ts",
+        dictionaryOutput: "src/i18n/dictionary.generated.ts",
+        instanceOutput: "src/i18n/instance.generated.ts",
+        paramsTypeName: "AppParams",
+        schemaTypeName: "AppSchema",
+      })
+    );
+
+    const result = runCodegen(tempDir);
+    expect(result.status).not.toBe(0);
+    expect(result.stderr).toContain("unsupported dictionary extension");
+  });
+
+  it("fails when yaml dictionary has invalid shape", () => {
+    tempDir = mkdtempSync(join(tmpdir(), "xndrjs-i18n-codegen-"));
+    mkdirSync(join(tempDir, "src/i18n/translations"), { recursive: true });
+
+    writeFileSync(
+      join(tempDir, "src/i18n/translations/translations.yaml"),
+      `welcome:
+  en: 123
+`
+    );
+    writeFileSync(
+      join(tempDir, "i18n.codegen.json"),
+      JSON.stringify({
+        dictionary: "src/i18n/translations/translations.yaml",
+        typesOutput: "src/i18n/i18n-types.generated.ts",
+        dictionaryOutput: "src/i18n/dictionary.generated.ts",
+        instanceOutput: "src/i18n/instance.generated.ts",
+        paramsTypeName: "AppParams",
+        schemaTypeName: "AppSchema",
+      })
+    );
+
+    const result = runCodegen(tempDir);
+    expect(result.status).not.toBe(0);
+    expect(result.stderr).toContain("must be a string");
+  });
 });