@gabrielbourget/i18n-foundation 0.1.0 → 0.1.1

package/CHANGELOG.md

@@ -0,0 +1,14 @@
+# Changelog
+
+## 0.1.1 - 2026-06-15
+
+- Added namespace source-root resolver helpers for mixed app-owned and foundation-owned locale roots.
+- Extended generated asset helpers and source verification to accept namespace source-root resolvers while preserving the existing single-root API.
+- Added package publish guardrails with `prepack`, `prepublishOnly`, `verify`, and test typechecking.
+- Added package CI and a Node version pin.
+- Corrected README examples to use the public subpath imports.
+
+## 0.1.0 - 2026-06-14
+
+- Initial private i18n foundation package release.
+- Extracted shared i18next runtime helpers, env parsing, manifest helpers, pseudolocalization, asset helpers, verifier helpers, and foundation-owned common locale JSON.

package/README.md

@@ -93,12 +93,9 @@ namespace.
 The app facade owns all app-specific registry values:
 
 ```ts
-import {
-  buildClientRuntimeConfig,
-  createI18nClientEnvReader,
-  createI18nProvider,
-  validateDevManifest,
-} from "@gabrielbourget/i18n-foundation"
+import { createI18nProvider } from "@gabrielbourget/i18n-foundation/core/client"
+import { buildClientRuntimeConfig, createI18nClientEnvReader } from "@gabrielbourget/i18n-foundation/env/client"
+import { validateDevManifest } from "@gabrielbourget/i18n-foundation/manifest"
 
 const registry = {
   defaultLocale: DEFAULT_LOCALE,
@@ -131,7 +128,15 @@ Facade scripts should pass explicit app paths and registries into foundation
 helpers:
 
 ```ts
-import { buildI18nManifest, generateI18nAssets, verifyI18nSource } from "@gabrielbourget/i18n-foundation"
+import { FOUNDATION_COMMON_NAMESPACES } from "@gabrielbourget/i18n-foundation/common"
+import { createI18nNamespaceSourceRootResolver, generateI18nAssets } from "@gabrielbourget/i18n-foundation/assets"
+import { buildI18nManifest } from "@gabrielbourget/i18n-foundation/manifest"
+import { verifyI18nSource } from "@gabrielbourget/i18n-foundation/verifier"
+
+const resolveNamespaceSourceRoot = createI18nNamespaceSourceRootResolver({
+  defaultLocalesRoot: appLocalesRoot,
+  overrides: [{ localesRoot: foundationLocalesRoot, namespaces: FOUNDATION_COMMON_NAMESPACES }],
+})
 
 const manifest = buildI18nManifest({
   defaultLocale: DEFAULT_LOCALE,
@@ -141,13 +146,14 @@ const manifest = buildI18nManifest({
 })
 
 generateI18nAssets({
-  localesRoot,
   outputRoot,
   manifest,
+  resolveNamespaceSourceRoot,
 })
 
 await verifyI18nSource({
-  localesRoot,
+  localesRoot: appLocalesRoot,
+  resolveNamespaceSourceRoot,
   availableNamespaces: AVAILABLE_NAMESPACES,
   declaredLocales: DECLARED_LOCALES,
   defaultLocale: DEFAULT_LOCALE,

package/dist/assets/index.d.ts

@@ -5,8 +5,24 @@ export type TGeneratedI18nAsset<Locale extends string = string, Namespace extend
     sourcePath: string;
     outputPath: string;
 };
-export type TGenerateI18nAssetsArgs<Locale extends string, Namespace extends string> = {
+export type TI18nNamespaceSourceRootResolver<Namespace extends string = string> = (namespace: Namespace) => string;
+export type TI18nNamespaceSourceRootOverride<Namespace extends string = string> = {
     localesRoot: string;
+    namespaces: readonly Namespace[];
+};
+export type TCreateI18nNamespaceSourceRootResolverArgs<Namespace extends string = string> = {
+    defaultLocalesRoot: string;
+    overrides?: readonly TI18nNamespaceSourceRootOverride<Namespace>[] | undefined;
+};
+export type TResolveI18nNamespaceSourcePathArgs<Locale extends string = string, Namespace extends string = string> = {
+    locale: Locale;
+    namespace: Namespace;
+    localesRoot?: string | undefined;
+    resolveNamespaceSourceRoot?: TI18nNamespaceSourceRootResolver<Namespace> | undefined;
+};
+export type TGenerateI18nAssetsArgs<Locale extends string, Namespace extends string> = {
+    localesRoot?: string | undefined;
+    resolveNamespaceSourceRoot?: TI18nNamespaceSourceRootResolver<Namespace> | undefined;
     outputRoot: string;
     manifest: TI18nManifest<Locale, Namespace>;
     cleanOutputRoot?: boolean | undefined;
@@ -17,7 +33,8 @@ export type TGenerateI18nAssetsResult<Locale extends string, Namespace extends s
     assets: readonly TGeneratedI18nAsset<Locale, Namespace>[];
 };
 export type TValidateGeneratedI18nAssetsArgs<Locale extends string, Namespace extends string> = {
-    localesRoot: string;
+    localesRoot?: string | undefined;
+    resolveNamespaceSourceRoot?: TI18nNamespaceSourceRootResolver<Namespace> | undefined;
     generatedRoot: string;
     manifest: TI18nManifest<Locale, Namespace>;
 };
@@ -30,6 +47,8 @@ export declare const listJSONFileNames: (directoryPath: string) => string[];
 export declare const assertEqualArrays: (label: string, expected: readonly string[], actual: readonly string[]) => void;
 export declare const ensureDirectory: (directoryPath: string) => void;
 export declare const removeDirectoryIfExists: (directoryPath: string) => void;
-export declare const generateI18nAssets: <Locale extends string, Namespace extends string>({ localesRoot, outputRoot, manifest, cleanOutputRoot, }: TGenerateI18nAssetsArgs<Locale, Namespace>) => TGenerateI18nAssetsResult<Locale, Namespace>;
-export declare const validateGeneratedI18nAssets: <Locale extends string, Namespace extends string>({ localesRoot, generatedRoot, manifest, }: TValidateGeneratedI18nAssetsArgs<Locale, Namespace>) => void;
+export declare const createI18nNamespaceSourceRootResolver: <Namespace extends string>({ defaultLocalesRoot, overrides, }: TCreateI18nNamespaceSourceRootResolverArgs<Namespace>) => TI18nNamespaceSourceRootResolver<Namespace>;
+export declare const resolveI18nNamespaceSourcePath: <Locale extends string, Namespace extends string>({ locale, namespace, localesRoot, resolveNamespaceSourceRoot, }: TResolveI18nNamespaceSourcePathArgs<Locale, Namespace>) => string;
+export declare const generateI18nAssets: <Locale extends string, Namespace extends string>({ localesRoot, resolveNamespaceSourceRoot, outputRoot, manifest, cleanOutputRoot, }: TGenerateI18nAssetsArgs<Locale, Namespace>) => TGenerateI18nAssetsResult<Locale, Namespace>;
+export declare const validateGeneratedI18nAssets: <Locale extends string, Namespace extends string>({ localesRoot, resolveNamespaceSourceRoot, generatedRoot, manifest, }: TValidateGeneratedI18nAssetsArgs<Locale, Namespace>) => void;
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/assets/index.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAA;AAEzD,MAAM,MAAM,mBAAmB,CAAC,MAAM,SAAS,MAAM,GAAG,MAAM,EAAE,SAAS,SAAS,MAAM,GAAG,MAAM,IAAI;IACnG,MAAM,EAAE,MAAM,CAAA;IACd,SAAS,EAAE,SAAS,CAAA;IACpB,UAAU,EAAE,MAAM,CAAA;IAClB,UAAU,EAAE,MAAM,CAAA;CACnB,CAAA;AAED,MAAM,MAAM,uBAAuB,CAAC,MAAM,SAAS,MAAM,EAAE,SAAS,SAAS,MAAM,IAAI;IACrF,WAAW,EAAE,MAAM,CAAA;IACnB,UAAU,EAAE,MAAM,CAAA;IAClB,QAAQ,EAAE,aAAa,CAAC,MAAM,EAAE,SAAS,CAAC,CAAA;IAC1C,eAAe,CAAC,EAAE,OAAO,GAAG,SAAS,CAAA;CACtC,CAAA;AAED,MAAM,MAAM,yBAAyB,CAAC,MAAM,SAAS,MAAM,EAAE,SAAS,SAAS,MAAM,IAAI;IACvF,UAAU,EAAE,MAAM,CAAA;IAClB,YAAY,EAAE,MAAM,CAAA;IACpB,MAAM,EAAE,SAAS,mBAAmB,CAAC,MAAM,EAAE,SAAS,CAAC,EAAE,CAAA;CAC1D,CAAA;AAED,MAAM,MAAM,gCAAgC,CAAC,MAAM,SAAS,MAAM,EAAE,SAAS,SAAS,MAAM,IAAI;IAC9F,WAAW,EAAE,MAAM,CAAA;IACnB,aAAa,EAAE,MAAM,CAAA;IACrB,QAAQ,EAAE,aAAa,CAAC,MAAM,EAAE,SAAS,CAAC,CAAA;CAC3C,CAAA;AAED,eAAO,MAAM,QAAQ,GAAI,UAAU,MAAM,KAAG,MAA2C,CAAA;AAEvF,eAAO,MAAM,SAAS,GAAI,UAAU,MAAM,EAAE,OAAO,MAAM,KAAG,IAE3D,CAAA;AAED,eAAO,MAAM,YAAY,GAAI,UAAU,MAAM,KAAG,OAQ/C,CAAA;AAED,eAAO,MAAM,aAAa,GAAI,UAAU,MAAM,EAAE,OAAO,OAAO,KAAG,IAEhE,CAAA;AAED,eAAO,MAAM,kBAAkB,GAAI,eAAe,MAAM,KAAG,MAAM,EAMhE,CAAA;AAED,eAAO,MAAM,iBAAiB,GAAI,eAAe,MAAM,KAAG,MAAM,EAM/D,CAAA;AAED,eAAO,MAAM,iBAAiB,GAAI,OAAO,MAAM,EAAE,UAAU,SAAS,MAAM,EAAE,EAAE,QAAQ,SAAS,MAAM,EAAE,KAAG,IAOzG,CAAA;AAED,eAAO,MAAM,eAAe,GAAI,eAAe,MAAM,KAAG,IAEvD,CAAA;AAED,eAAO,MAAM,uBAAuB,GAAI,eAAe,MAAM,KAAG,IAE/D,CAAA;AAWD,eAAO,MAAM,kBAAkB,GAAI,MAAM,SAAS,MAAM,EAAE,SAAS,SAAS,MAAM,EAAE,yDAKjF,uBAAuB,CAAC,MAAM,EAAE,SAAS,CAAC,KAAG,yBAAyB,CAAC,MAAM,EAAE,SAAS,CAgC1F,CAAA;AAED,eAAO,MAAM,2BAA2B,GAAI,MAAM,SAAS,MAAM,EAAE,SAAS,SAAS,MAAM,EAAE,2CAI1F,gCAAgC,CAAC,MAAM,EAAE,SAAS,CAAC,KAAG,IA0CxD,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/assets/index.ts"],"names":[],"mappings":"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"}

package/dist/assets/index.js

@@ -43,6 +43,25 @@ export const ensureDirectory = (directoryPath) => {
 export const removeDirectoryIfExists = (directoryPath) => {
     fs.rmSync(directoryPath, { recursive: true, force: true });
 };
+export const createI18nNamespaceSourceRootResolver = ({ defaultLocalesRoot, overrides = [], }) => {
+    const overrideRootByNamespace = new Map();
+    for (const override of overrides) {
+        for (const namespace of override.namespaces) {
+            if (overrideRootByNamespace.has(namespace)) {
+                throw new Error(`[i18n assets] Namespace source root configured more than once: ${namespace}`);
+            }
+            overrideRootByNamespace.set(namespace, override.localesRoot);
+        }
+    }
+    return (namespace) => overrideRootByNamespace.get(namespace) ?? defaultLocalesRoot;
+};
+export const resolveI18nNamespaceSourcePath = ({ locale, namespace, localesRoot, resolveNamespaceSourceRoot, }) => {
+    const resolvedLocalesRoot = resolveNamespaceSourceRoot?.(namespace) ?? localesRoot;
+    if (!resolvedLocalesRoot) {
+        throw new Error("[i18n assets] Either localesRoot or resolveNamespaceSourceRoot must be provided.");
+    }
+    return path.join(resolvedLocalesRoot, locale, `${namespace}.json`);
+};
 const assertFileContentMatches = (label, expectedPath, actualPath) => {
     const expected = readUTF8(expectedPath);
     const actual = readUTF8(actualPath);
@@ -50,7 +69,7 @@ const assertFileContentMatches = (label, expectedPath, actualPath) => {
         throw new Error(`${label} does not match source file.\nsource: ${expectedPath}\nasset:  ${actualPath}`);
     }
 };
-export const generateI18nAssets = ({ localesRoot, outputRoot, manifest, cleanOutputRoot = true, }) => {
+export const generateI18nAssets = ({ localesRoot, resolveNamespaceSourceRoot, outputRoot, manifest, cleanOutputRoot = true, }) => {
     if (cleanOutputRoot) {
         removeDirectoryIfExists(outputRoot);
     }
@@ -60,7 +79,12 @@ export const generateI18nAssets = ({ localesRoot, outputRoot, manifest, cleanOut
         const localeOutputPath = path.join(outputRoot, locale);
         ensureDirectory(localeOutputPath);
         for (const namespace of manifest.namespaces) {
-            const sourcePath = path.join(localesRoot, locale, `${namespace}.json`);
+            const sourcePath = resolveI18nNamespaceSourcePath({
+                locale,
+                localesRoot,
+                namespace,
+                resolveNamespaceSourceRoot,
+            });
             const outputPath = path.join(localeOutputPath, `${namespace}.json`);
             readJSONFile(sourcePath);
             writeUTF8(outputPath, readUTF8(sourcePath));
@@ -75,7 +99,7 @@ export const generateI18nAssets = ({ localesRoot, outputRoot, manifest, cleanOut
         outputRoot,
     };
 };
-export const validateGeneratedI18nAssets = ({ localesRoot, generatedRoot, manifest, }) => {
+export const validateGeneratedI18nAssets = ({ localesRoot, resolveNamespaceSourceRoot, generatedRoot, manifest, }) => {
     const manifestPath = path.join(generatedRoot, "manifest.json");
     if (!fs.existsSync(generatedRoot))
         throw new Error(`[i18n assets] Generated root not found: ${generatedRoot}`);
@@ -96,7 +120,12 @@ export const validateGeneratedI18nAssets = ({ localesRoot, generatedRoot, manife
         const expectedFileNames = manifest.namespaces.map((namespace) => `${namespace}.json`);
         assertEqualArrays(`[i18n assets] generated namespace files for ${locale}`, expectedFileNames, listJSONFileNames(generatedLocalePath));
         for (const namespace of manifest.namespaces) {
-            assertFileContentMatches(`[i18n assets] ${locale}/${namespace}.json`, path.join(localesRoot, locale, `${namespace}.json`), path.join(generatedLocalePath, `${namespace}.json`));
+            assertFileContentMatches(`[i18n assets] ${locale}/${namespace}.json`, resolveI18nNamespaceSourcePath({
+                locale,
+                localesRoot,
+                namespace,
+                resolveNamespaceSourceRoot,
+            }), path.join(generatedLocalePath, `${namespace}.json`));
         }
     }
 };

package/dist/verifier/verifyI18nSource.d.ts

@@ -1,6 +1,8 @@
+import { type TI18nNamespaceSourceRootResolver } from "../assets/index.js";
 import { type TDomainSeedSourceContract, type TDomainTranslationContract } from "./domainContracts.js";
 export type TVerifyI18nSourceArgs<Locale extends string = string, Namespace extends string = string> = {
     localesRoot: string;
+    resolveNamespaceSourceRoot?: TI18nNamespaceSourceRootResolver<Namespace> | undefined;
     availableNamespaces: readonly Namespace[];
     declaredLocales?: readonly Locale[] | undefined;
     defaultLocale: Locale;
@@ -21,5 +23,5 @@ export type TVerifyI18nSourceResult = {
     domainSeedSourceContractCount: number;
     domainSeedSourceCodeCount: number;
 };
-export declare const verifyI18nSource: <Locale extends string, Namespace extends string>({ localesRoot, availableNamespaces, declaredLocales, defaultLocale, initialLoadNamespaces, repoRoot, domainTranslationContracts, domainSeedSourceContracts, structuredNamespaceKeyConventionExceptions, }: TVerifyI18nSourceArgs<Locale, Namespace>) => Promise<TVerifyI18nSourceResult>;
+export declare const verifyI18nSource: <Locale extends string, Namespace extends string>({ localesRoot, availableNamespaces, declaredLocales, defaultLocale, initialLoadNamespaces, repoRoot, domainTranslationContracts, domainSeedSourceContracts, structuredNamespaceKeyConventionExceptions, resolveNamespaceSourceRoot, }: TVerifyI18nSourceArgs<Locale, Namespace>) => Promise<TVerifyI18nSourceResult>;
 //# sourceMappingURL=verifyI18nSource.d.ts.map

package/dist/verifier/verifyI18nSource.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"verifyI18nSource.d.ts","sourceRoot":"","sources":["../../src/verifier/verifyI18nSource.ts"],"names":[],"mappings":"AAWA,OAAO,EAGL,KAAK,yBAAyB,EAC9B,KAAK,0BAA0B,EAChC,MAAM,sBAAsB,CAAA;AAE7B,MAAM,MAAM,qBAAqB,CAAC,MAAM,SAAS,MAAM,GAAG,MAAM,EAAE,SAAS,SAAS,MAAM,GAAG,MAAM,IAAI;IACrG,WAAW,EAAE,MAAM,CAAA;IACnB,mBAAmB,EAAE,SAAS,SAAS,EAAE,CAAA;IACzC,eAAe,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,CAAA;IAC/C,aAAa,EAAE,MAAM,CAAA;IACrB,qBAAqB,CAAC,EAAE,SAAS,SAAS,EAAE,GAAG,SAAS,CAAA;IACxD,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAC7B,0BAA0B,CAAC,EAAE,SAAS,0BAA0B,EAAE,GAAG,SAAS,CAAA;IAC9E,yBAAyB,CAAC,EAAE,SAAS,yBAAyB,EAAE,GAAG,SAAS,CAAA;IAC5E,0CAA0C,CAAC,EAAE,SAAS,SAAS,EAAE,GAAG,SAAS,CAAA;CAC9E,CAAA;AAED,MAAM,MAAM,uBAAuB,GAAG;IACpC,UAAU,EAAE,MAAM,CAAA;IAClB,eAAe,EAAE,MAAM,CAAA;IACvB,WAAW,EAAE,MAAM,CAAA;IACnB,wBAAwB,EAAE,MAAM,CAAA;IAChC,YAAY,EAAE,MAAM,CAAA;IACpB,8BAA8B,EAAE,MAAM,CAAA;IACtC,gCAAgC,EAAE,MAAM,CAAA;IACxC,6BAA6B,EAAE,MAAM,CAAA;IACrC,yBAAyB,EAAE,MAAM,CAAA;CAClC,CAAA;AAUD,eAAO,MAAM,gBAAgB,GAAU,MAAM,SAAS,MAAM,EAAE,SAAS,SAAS,MAAM,EAAE,2MAUrF,qBAAqB,CAAC,MAAM,EAAE,SAAS,CAAC,KAAG,OAAO,CAAC,uBAAuB,CAsO5E,CAAA"}
+{"version":3,"file":"verifyI18nSource.d.ts","sourceRoot":"","sources":["../../src/verifier/verifyI18nSource.ts"],"names":[],"mappings":"AAEA,OAAO,EAAkC,KAAK,gCAAgC,EAAE,MAAM,oBAAoB,CAAA;AAW1G,OAAO,EAGL,KAAK,yBAAyB,EAC9B,KAAK,0BAA0B,EAChC,MAAM,sBAAsB,CAAA;AAE7B,MAAM,MAAM,qBAAqB,CAAC,MAAM,SAAS,MAAM,GAAG,MAAM,EAAE,SAAS,SAAS,MAAM,GAAG,MAAM,IAAI;IACrG,WAAW,EAAE,MAAM,CAAA;IACnB,0BAA0B,CAAC,EAAE,gCAAgC,CAAC,SAAS,CAAC,GAAG,SAAS,CAAA;IACpF,mBAAmB,EAAE,SAAS,SAAS,EAAE,CAAA;IACzC,eAAe,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,CAAA;IAC/C,aAAa,EAAE,MAAM,CAAA;IACrB,qBAAqB,CAAC,EAAE,SAAS,SAAS,EAAE,GAAG,SAAS,CAAA;IACxD,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAC7B,0BAA0B,CAAC,EAAE,SAAS,0BAA0B,EAAE,GAAG,SAAS,CAAA;IAC9E,yBAAyB,CAAC,EAAE,SAAS,yBAAyB,EAAE,GAAG,SAAS,CAAA;IAC5E,0CAA0C,CAAC,EAAE,SAAS,SAAS,EAAE,GAAG,SAAS,CAAA;CAC9E,CAAA;AAED,MAAM,MAAM,uBAAuB,GAAG;IACpC,UAAU,EAAE,MAAM,CAAA;IAClB,eAAe,EAAE,MAAM,CAAA;IACvB,WAAW,EAAE,MAAM,CAAA;IACnB,wBAAwB,EAAE,MAAM,CAAA;IAChC,YAAY,EAAE,MAAM,CAAA;IACpB,8BAA8B,EAAE,MAAM,CAAA;IACtC,gCAAgC,EAAE,MAAM,CAAA;IACxC,6BAA6B,EAAE,MAAM,CAAA;IACrC,yBAAyB,EAAE,MAAM,CAAA;CAClC,CAAA;AAUD,eAAO,MAAM,gBAAgB,GAAU,MAAM,SAAS,MAAM,EAAE,SAAS,SAAS,MAAM,EAAE,uOAWrF,qBAAqB,CAAC,MAAM,EAAE,SAAS,CAAC,KAAG,OAAO,CAAC,uBAAuB,CA2O5E,CAAA"}

package/dist/verifier/verifyI18nSource.js

@@ -1,4 +1,5 @@
 import path from "node:path";
+import { resolveI18nNamespaceSourcePath } from "../assets/index.js";
 import { getDeclaredInterpolationTokens, getTranslationStringEntries, parseICUContract, pushContractDiffs, } from "./icuContracts.js";
 import { getLeafShapes, normalizeShapeEntries, validateKeyConventions } from "./keyShape.js";
 import { listDirNames, listJSONFiles, readJSONFileOrThrow } from "./fileSystem.js";
@@ -10,7 +11,7 @@ const assertNoItems = (label, items) => {
         return;
     throw new Error(`[i18n verify] ${label}\n${formatList(items)}`);
 };
-export const verifyI18nSource = async ({ localesRoot, availableNamespaces, declaredLocales, defaultLocale, initialLoadNamespaces = [], repoRoot, domainTranslationContracts = [], domainSeedSourceContracts = [], structuredNamespaceKeyConventionExceptions = [], }) => {
+export const verifyI18nSource = async ({ localesRoot, availableNamespaces, declaredLocales, defaultLocale, initialLoadNamespaces = [], repoRoot, domainTranslationContracts = [], domainSeedSourceContracts = [], structuredNamespaceKeyConventionExceptions = [], resolveNamespaceSourceRoot, }) => {
     if (availableNamespaces.length === 0) {
         throw new Error("[i18n verify] availableNamespaces must contain at least one namespace");
     }
@@ -34,21 +35,26 @@ export const verifyI18nSource = async ({ localesRoot, availableNamespaces, decla
     const namespaceUnion = new Set();
     for (const locale of locales) {
         const localeDir = path.join(localesRoot, locale);
-        const files = await listJSONFiles(localeDir);
-        const namespaces = files.map((file) => file.replace(/\.json$/, ""));
-        if (files.length === 0) {
+        const namespaces = resolveNamespaceSourceRoot
+            ? [...availableNamespaces]
+            : (await listJSONFiles(localeDir)).map((file) => file.replace(/\.json$/, ""));
+        if (namespaces.length === 0) {
             throw new Error(`[i18n verify] No translation sheets found for locale=${locale}`);
         }
         namespacesByLocale.set(locale, namespaces);
         sheetsByLocale.set(locale, new Map());
         namespaces.forEach((namespace) => namespaceUnion.add(namespace));
-        for (const file of files) {
-            const namespace = file.replace(/\.json$/, "");
-            const filePath = path.join(localeDir, file);
+        for (const namespace of namespaces) {
+            const filePath = resolveI18nNamespaceSourcePath({
+                locale,
+                localesRoot,
+                namespace,
+                resolveNamespaceSourceRoot,
+            });
             const { json: sheet, raw } = await readJSONFileOrThrow(filePath, "[i18n verify]");
             const canonicalSheet = formatI18nSheet(sheet);
             if (raw !== canonicalSheet) {
-                sheetOrderingErrors.push(`${locale}/${file}`);
+                sheetOrderingErrors.push(`${locale}/${namespace}.json`);
             }
             sheetsByLocale.get(locale)?.set(namespace, sheet);
             sheetCount += 1;

package/package.json

@@ -1,15 +1,17 @@
 {
   "name": "@gabrielbourget/i18n-foundation",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "Shared i18n runtime foundation for Wavemap and Waveguide facade packages.",
   "license": "UNLICENSED",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
+  "packageManager": "pnpm@10.18.3",
   "files": [
     "dist",
     "locales",
-    "README.md"
+    "README.md",
+    "CHANGELOG.md"
   ],
   "sideEffects": false,
   "publishConfig": {
@@ -68,6 +70,18 @@
       "import": "./dist/verifier/index.js"
     }
   },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "format": "prettier --write .",
+    "format:check": "prettier --check .",
+    "prepack": "pnpm build",
+    "prepublishOnly": "pnpm verify",
+    "test": "vitest run",
+    "test:unit": "vitest run",
+    "typecheck": "tsc --noEmit -p tsconfig.json",
+    "typecheck:tests": "tsc --noEmit -p tsconfig.vitest.json",
+    "verify": "pnpm format:check && pnpm typecheck && pnpm typecheck:tests && pnpm test"
+  },
   "peerDependencies": {
     "i18next": "^23.16.8",
     "i18next-icu": "^2.4.1",
@@ -91,13 +105,5 @@
     "react-i18next": "13.5.0",
     "typescript": "5.9.3",
     "vitest": "4.0.18"
-  },
-  "scripts": {
-    "build": "tsc -p tsconfig.json",
-    "format": "prettier --write .",
-    "format:check": "prettier --check .",
-    "test": "vitest run",
-    "test:unit": "vitest run",
-    "typecheck": "tsc --noEmit -p tsconfig.json"
   }
-}
+}