@courthive/i18n 0.1.1

package/dist/manifest.gen.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Build-time CLI: scans `dist/locales/*.json`, computes a SHA256 per
+ * file, counts keys and `__TODO__` sentinels, and emits
+ * `dist/manifest.json`.
+ *
+ * The manifest is the authoritative contract served by CFS at
+ * `GET /i18n/manifest` — its shape is documented in
+ * `Mentat/planning/I18N_DELIVERY.md`.
+ *
+ * Invocation: `node dist/manifest.gen.js` (chained after `tsc` in
+ * `pnpm build`).
+ */
+export interface ManifestLocaleEntry {
+    /** BCP47 language tag (e.g. 'en', 'pt-BR', 'zh-CN'). */
+    code: string;
+    /** English label. */
+    label: string;
+    /** Native label. */
+    nativeLabel: string;
+    /** `sha256-<hex>` content hash of the locale JSON file. */
+    version: string;
+    /** File size in bytes. */
+    size: number;
+    /** Total leaf-key count. */
+    keyCount: number;
+    /** 1 - (__TODO__ count / total keys). */
+    completeness: number;
+    /** Right-to-left rendering required. */
+    rtl: boolean;
+}
+export interface Manifest {
+    /** `@courthive/i18n@<package-version>`. */
+    version: string;
+    /** ISO timestamp the manifest was generated at. */
+    generatedAt: string;
+    locales: ManifestLocaleEntry[];
+}

package/dist/manifest.gen.js

@@ -0,0 +1,93 @@
+/**
+ * Build-time CLI: scans `dist/locales/*.json`, computes a SHA256 per
+ * file, counts keys and `__TODO__` sentinels, and emits
+ * `dist/manifest.json`.
+ *
+ * The manifest is the authoritative contract served by CFS at
+ * `GET /i18n/manifest` — its shape is documented in
+ * `Mentat/planning/I18N_DELIVERY.md`.
+ *
+ * Invocation: `node dist/manifest.gen.js` (chained after `tsc` in
+ * `pnpm build`).
+ */
+import { createHash } from 'node:crypto';
+import { readFileSync, readdirSync, writeFileSync, statSync } from 'node:fs';
+import { fileURLToPath } from 'node:url';
+import { dirname, join } from 'node:path';
+import { localeLabels } from './locale-labels.js';
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const TODO_SENTINEL = '__TODO__';
+function countLeafKeys(obj) {
+    if (obj === null || typeof obj !== 'object' || Array.isArray(obj))
+        return 1;
+    let n = 0;
+    for (const key of Object.keys(obj)) {
+        n += countLeafKeys(obj[key]);
+    }
+    return n;
+}
+function countTodos(obj) {
+    if (typeof obj === 'string')
+        return obj === TODO_SENTINEL ? 1 : 0;
+    if (obj === null || typeof obj !== 'object' || Array.isArray(obj))
+        return 0;
+    let n = 0;
+    for (const key of Object.keys(obj)) {
+        n += countTodos(obj[key]);
+    }
+    return n;
+}
+function readPackageVersion() {
+    // dist/manifest.gen.js → dist/ → repo root
+    const pkgPath = join(__dirname, '..', 'package.json');
+    const pkg = JSON.parse(readFileSync(pkgPath, 'utf8'));
+    return `${pkg.name}@${pkg.version}`;
+}
+function build() {
+    const localesDir = join(__dirname, 'locales');
+    const files = readdirSync(localesDir).filter((f) => f.endsWith('.json'));
+    const entries = [];
+    for (const file of files) {
+        const code = file.replace(/\.json$/, '');
+        const labelEntry = localeLabels[code];
+        if (!labelEntry) {
+            console.warn(`manifest.gen: locale "${code}" has no entry in locale-labels.ts — skipping`);
+            continue;
+        }
+        const fullPath = join(localesDir, file);
+        const raw = readFileSync(fullPath, 'utf8');
+        const parsed = JSON.parse(raw);
+        const sha = createHash('sha256').update(raw).digest('hex');
+        const size = statSync(fullPath).size;
+        const keyCount = countLeafKeys(parsed);
+        const todos = countTodos(parsed);
+        const completeness = keyCount > 0 ? 1 - todos / keyCount : 1;
+        entries.push({
+            code,
+            label: labelEntry.label,
+            nativeLabel: labelEntry.nativeLabel,
+            version: `sha256-${sha}`,
+            size,
+            keyCount,
+            completeness,
+            rtl: labelEntry.rtl,
+        });
+        if (completeness < 1) {
+            console.warn(`manifest.gen: locale "${code}" is ${(completeness * 100).toFixed(1)}% complete (${todos}/${keyCount} __TODO__)`);
+        }
+    }
+    // Deterministic order: alphabetical by code so manifest diffs are stable.
+    entries.sort((a, b) => a.code.localeCompare(b.code));
+    return {
+        version: readPackageVersion(),
+        generatedAt: new Date().toISOString(),
+        locales: entries,
+    };
+}
+function main() {
+    const manifest = build();
+    const outPath = join(__dirname, 'manifest.json');
+    writeFileSync(outPath, JSON.stringify(manifest, null, 2) + '\n', 'utf8');
+    console.log(`manifest.gen: wrote ${outPath} (${manifest.locales.length} locales)`);
+}
+main();

package/dist/manifest.json

@@ -0,0 +1,96 @@
+{
+  "version": "@courthive/i18n@0.1.1",
+  "generatedAt": "2026-05-19T20:14:44.491Z",
+  "locales": [
+    {
+      "code": "ar",
+      "label": "Arabic",
+      "nativeLabel": "العربية",
+      "version": "sha256-898ace24f03deb33e968b1b87b123cfb1176f3d68451b445b7a850129be754c7",
+      "size": 81545,
+      "keyCount": 1748,
+      "completeness": 0.8541189931350115,
+      "rtl": true
+    },
+    {
+      "code": "cs",
+      "label": "Czech",
+      "nativeLabel": "Čeština",
+      "version": "sha256-adab74b4421886d3b1ce87dcf15f58015ca2503ac17eacae7357c886a82b2664",
+      "size": 73071,
+      "keyCount": 1748,
+      "completeness": 0.9754004576659039,
+      "rtl": false
+    },
+    {
+      "code": "de",
+      "label": "German",
+      "nativeLabel": "Deutsch",
+      "version": "sha256-0595faff7802cbcc04f37b7c9f3faeb6c6dc9de48b39a1bff6088e55860cefb6",
+      "size": 69799,
+      "keyCount": 1748,
+      "completeness": 0.8541189931350115,
+      "rtl": false
+    },
+    {
+      "code": "en",
+      "label": "English",
+      "nativeLabel": "English",
+      "version": "sha256-e6df6c8687929901e800eb7a990f74e6b34c32f313744fbd29ac49ee184748d0",
+      "size": 68249,
+      "keyCount": 1748,
+      "completeness": 0.9994279176201373,
+      "rtl": false
+    },
+    {
+      "code": "es",
+      "label": "Spanish",
+      "nativeLabel": "Español",
+      "version": "sha256-bf19cc379b3a84dadd38702ee75ea6a02782a2724abc9e94c4de2cd7c9782ee7",
+      "size": 70785,
+      "keyCount": 1748,
+      "completeness": 0.8541189931350115,
+      "rtl": false
+    },
+    {
+      "code": "fr",
+      "label": "French",
+      "nativeLabel": "Français",
+      "version": "sha256-76eee82d25eb2d8ec730449abeef2e39ea4bb4ee97a657426eba86f8d8ae118c",
+      "size": 72243,
+      "keyCount": 1748,
+      "completeness": 0.8541189931350115,
+      "rtl": false
+    },
+    {
+      "code": "hr",
+      "label": "Croatian",
+      "nativeLabel": "Hrvatski",
+      "version": "sha256-9ac80c816f22b37feeb908a1079a03ec99b74dc4f4573dcb0eabaef5cc4525a4",
+      "size": 71578,
+      "keyCount": 1748,
+      "completeness": 0.9754004576659039,
+      "rtl": false
+    },
+    {
+      "code": "pt-BR",
+      "label": "Portuguese (Brazil)",
+      "nativeLabel": "Português (Brasil)",
+      "version": "sha256-2190a533602573f8af19128004f8f87106dfd19f0bf8c9cd5d42aa581554e93d",
+      "size": 70400,
+      "keyCount": 1748,
+      "completeness": 0.8541189931350115,
+      "rtl": false
+    },
+    {
+      "code": "zh-CN",
+      "label": "Chinese (Simplified)",
+      "nativeLabel": "简体中文",
+      "version": "sha256-3725b0fd07ed5c938b759475e496d2eb23c5e2149e8bbd0e4f3c5bfb5f06b652",
+      "size": 64697,
+      "keyCount": 1748,
+      "completeness": 0.8781464530892449,
+      "rtl": false
+    }
+  ]
+}

package/package.json

@@ -0,0 +1,75 @@
+{
+  "name": "@courthive/i18n",
+  "packageManager": "pnpm@11.1.2",
+  "version": "0.1.1",
+  "description": "Translation locales for the CourtHive ecosystem. Source-of-truth bundle served at runtime by competition-factory-server to TMX clients.",
+  "author": "Charles Allen <charles@CourtHive.com> (CourtHive.com)",
+  "license": "MIT",
+  "type": "module",
+  "private": false,
+  "bugs": {
+    "url": "https://github.com/CourtHive/courthive-i18n/issues",
+    "email": "support@CourtHive.com"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/CourtHive/courthive-i18n.git"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./manifest": {
+      "types": "./dist/manifest.d.ts",
+      "default": "./dist/manifest.js"
+    },
+    "./locale-labels": {
+      "types": "./dist/locale-labels.d.ts",
+      "default": "./dist/locale-labels.js"
+    },
+    "./locales/*.json": "./dist/locales/*.json",
+    "./manifest.json": "./dist/manifest.json"
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "rm -rf dist && tsc -p tsconfig.build.json && node scripts/copy-locales.cjs && node dist/manifest.gen.js",
+    "check-types": "tsc --noEmit",
+    "lint": "eslint . --fix --max-warnings 0",
+    "format": "prettier --write \"src/**/*.{ts,json}\"",
+    "test": "node scripts/compare-keys.cjs && echo 'OK'",
+    "commitlint": "commitlint --edit",
+    "prepare": "husky && node scripts/install-husky-hooks.cjs",
+    "prepublishOnly": "pnpm build"
+  },
+  "lint-staged": {
+    "*.{js,ts,cjs,mjs}": "eslint --cache --fix",
+    "*": "prettier --ignore-unknown --write"
+  },
+  "engines": {
+    "node": ">=22"
+  },
+  "devDependencies": {
+    "@commitlint/cli": "^21.0.0",
+    "@commitlint/config-conventional": "^21.0.0",
+    "@types/node": "^24.0.0",
+    "@typescript-eslint/eslint-plugin": "^8.59.0",
+    "@typescript-eslint/parser": "^8.59.0",
+    "eslint": "^10.0.0",
+    "husky": "^9.1.7",
+    "lint-staged": "^17.0.2",
+    "prettier": "^3.8.3",
+    "typescript": "^6.0.0"
+  },
+  "pnpm": {
+    "ignoredBuiltDependencies": [
+      "@scarf/scarf",
+      "esbuild",
+      "unrs-resolver"
+    ]
+  }
+}