@courthive/i18n 0.4.9 → 0.5.0

package/dist/manifest.gen.d.ts

@@ -1,6 +1,6 @@
 /**
  * Build-time CLI: scans `dist/locales/*.json`, computes a SHA256 per
- * file, counts keys and `__TODO__` sentinels, and emits
+ * file, counts keys and translator sentinels, and emits
  * `dist/manifest.json`.
  *
  * The manifest is the authoritative contract served by CFS at
@@ -27,6 +27,16 @@
  * `keyCount` is therefore the *translatable* key count, which is ≥ the number of
  * keys present in the served file. That is the useful reading of it, but it does
  * mean keyCount cannot be used to validate a downloaded locale's key count.
+ *
+ * ## Completeness counts both sentinels
+ *
+ * `__TODO__` means no translation exists. `__STALE__<translation>` means one
+ * exists but the English it was made from has since changed, so it may now
+ * answer the wrong question — see `scripts/merge-source-en.cjs`. Both are
+ * outstanding translator work and both count against `completeness`; a stale
+ * string is not a correct one. The stale prefix is stripped by `copy-locales`
+ * on the way to dist, so it is only ever visible in `src` — which is exactly
+ * why the metric is read from `src`.
  */
 export interface ManifestLocaleEntry {
     /** BCP47 language tag (e.g. 'en', 'pt-BR', 'zh-CN'). */
@@ -41,7 +51,7 @@ export interface ManifestLocaleEntry {
     size: number;
     /** Total leaf-key count. */
     keyCount: number;
-    /** 1 - (__TODO__ count / total keys). */
+    /** 1 - ((__TODO__ + __STALE__ count) / total keys). */
     completeness: number;
     /** Right-to-left rendering required. */
     rtl: boolean;

package/dist/manifest.gen.js

@@ -1,6 +1,6 @@
 /**
  * Build-time CLI: scans `dist/locales/*.json`, computes a SHA256 per
- * file, counts keys and `__TODO__` sentinels, and emits
+ * file, counts keys and translator sentinels, and emits
  * `dist/manifest.json`.
  *
  * The manifest is the authoritative contract served by CFS at
@@ -27,6 +27,16 @@
  * `keyCount` is therefore the *translatable* key count, which is ≥ the number of
  * keys present in the served file. That is the useful reading of it, but it does
  * mean keyCount cannot be used to validate a downloaded locale's key count.
+ *
+ * ## Completeness counts both sentinels
+ *
+ * `__TODO__` means no translation exists. `__STALE__<translation>` means one
+ * exists but the English it was made from has since changed, so it may now
+ * answer the wrong question — see `scripts/merge-source-en.cjs`. Both are
+ * outstanding translator work and both count against `completeness`; a stale
+ * string is not a correct one. The stale prefix is stripped by `copy-locales`
+ * on the way to dist, so it is only ever visible in `src` — which is exactly
+ * why the metric is read from `src`.
  */
 import { createHash } from 'node:crypto';
 import { readFileSync, readdirSync, writeFileSync, statSync, existsSync } from 'node:fs';
@@ -35,6 +45,7 @@ import { dirname, join } from 'node:path';
 import { localeLabels } from './locale-labels.js';
 const __dirname = dirname(fileURLToPath(import.meta.url));
 const TODO_SENTINEL = '__TODO__';
+const STALE_SENTINEL = '__STALE__';
 function countLeafKeys(obj) {
     if (obj === null || typeof obj !== 'object' || Array.isArray(obj))
         return 1;
@@ -44,14 +55,15 @@ function countLeafKeys(obj) {
     }
     return n;
 }
-function countTodos(obj) {
+/** Leaves carrying either sentinel — untranslated or translated-then-drifted. */
+function countOutstanding(obj) {
     if (typeof obj === 'string')
-        return obj === TODO_SENTINEL ? 1 : 0;
+        return obj === TODO_SENTINEL || obj.startsWith(STALE_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]);
+        n += countOutstanding(obj[key]);
     }
     return n;
 }
@@ -77,16 +89,16 @@ function build() {
         const raw = readFileSync(fullPath, 'utf8');
         const sha = createHash('sha256').update(raw).digest('hex');
         const size = statSync(fullPath).size;
-        // … while the translation metric is read from src, where `__TODO__` still
-        // lives. Fall back to the dist copy if src is unavailable (e.g. a consumer
+        // … while the translation metric is read from src, where both sentinels
+        // still live. Fall back to the dist copy if src is unavailable (e.g. a consumer
         // running the generator against an extracted package) rather than silently
         // reporting 100% complete.
         const srcPath = join(__dirname, '..', 'src', 'locales', file);
         const metricSource = existsSync(srcPath) ? srcPath : fullPath;
         const parsed = JSON.parse(readFileSync(metricSource, 'utf8'));
         const keyCount = countLeafKeys(parsed);
-        const todos = countTodos(parsed);
-        const completeness = keyCount > 0 ? 1 - todos / keyCount : 1;
+        const outstanding = countOutstanding(parsed);
+        const completeness = keyCount > 0 ? 1 - outstanding / keyCount : 1;
         entries.push({
             code,
             label: labelEntry.label,
@@ -98,7 +110,8 @@ function build() {
             rtl: labelEntry.rtl,
         });
         if (completeness < 1) {
-            console.warn(`manifest.gen: locale "${code}" is ${(completeness * 100).toFixed(1)}% complete (${todos}/${keyCount} __TODO__)`);
+            console.warn(`manifest.gen: locale "${code}" is ${(completeness * 100).toFixed(1)}% complete ` +
+                `(${outstanding}/${keyCount} outstanding)`);
         }
     }
     // Deterministic order: alphabetical by code so manifest diffs are stable.

package/dist/manifest.json

@@ -1,44 +1,44 @@
 {
-  "version": "@courthive/i18n@0.4.9",
-  "generatedAt": "2026-08-23T00:55:10.377Z",
+  "version": "@courthive/i18n@0.5.0",
+  "generatedAt": "2026-08-31T16:24:10.199Z",
   "locales": [
     {
       "code": "ar",
       "label": "Arabic",
       "nativeLabel": "العربية",
-      "version": "sha256-0765e316012e6743413bcdb0cae1ee0a3f2360292faff711f3ecbeb368d2e649",
-      "size": 132643,
-      "keyCount": 2642,
-      "completeness": 0.9015897047691143,
+      "version": "sha256-f726c6bd2fa8f49155682e0e929dcf50762ef2808cd6c0d75bda90984819af3b",
+      "size": 169719,
+      "keyCount": 2888,
+      "completeness": 1,
       "rtl": true
     },
     {
       "code": "cs",
       "label": "Czech",
       "nativeLabel": "Čeština",
-      "version": "sha256-ef7eba0c4b064ae8ee8eb6455ca39bf46fadc3527a09f7151fb0fb7d53ed34b0",
-      "size": 110834,
-      "keyCount": 2642,
-      "completeness": 0.9015897047691143,
+      "version": "sha256-472d4b81562a8b485f319de257f17107853d9a346e39bf05e006367f11971c3a",
+      "size": 141170,
+      "keyCount": 2888,
+      "completeness": 1,
       "rtl": false
     },
     {
       "code": "de",
       "label": "German",
       "nativeLabel": "Deutsch",
-      "version": "sha256-0e6b1d7a0b3628ce0c21afbb933681d77317a01c0f75e6446e3c9d2eba8f22ce",
-      "size": 112807,
-      "keyCount": 2642,
-      "completeness": 0.9015897047691143,
+      "version": "sha256-52d8fd4c8278899b910ccf749a118dd47de255d4f86b2945d7e8c766274b4404",
+      "size": 144043,
+      "keyCount": 2888,
+      "completeness": 1,
       "rtl": false
     },
     {
       "code": "en",
       "label": "English",
       "nativeLabel": "English",
-      "version": "sha256-c68ec79cd1ae8ad0f5ab6f1d2d25a90da7acc2ce2a468c055892c013054aeecb",
-      "size": 116333,
-      "keyCount": 2642,
+      "version": "sha256-337885289fcb09e9519c4be1054c73f4aeb47547f3cd84cd7fa0b73cea1f7265",
+      "size": 130650,
+      "keyCount": 2888,
       "completeness": 1,
       "rtl": false
     },
@@ -46,50 +46,50 @@
       "code": "es",
       "label": "Spanish",
       "nativeLabel": "Español",
-      "version": "sha256-8b9f2879ac438323ab49a362be6ae22e530f28ec0b1551027d963bad4b3d4366",
-      "size": 113081,
-      "keyCount": 2642,
-      "completeness": 0.9015897047691143,
+      "version": "sha256-b0d9ce14f4ddc2281805f7245cd1b5d0fab75e6908568e4883530bd5e4bacf80",
+      "size": 143885,
+      "keyCount": 2888,
+      "completeness": 1,
       "rtl": false
     },
     {
       "code": "fr",
       "label": "French",
       "nativeLabel": "Français",
-      "version": "sha256-220bcadb8c2305271646759eee6930bc2c3eeefc156ac1704fbecc552bb92664",
-      "size": 116190,
-      "keyCount": 2642,
-      "completeness": 0.9015897047691143,
+      "version": "sha256-755c098b022da4cf4202b7af33a8132f98b57b928dcc332b49b6d61c522fc4c0",
+      "size": 147980,
+      "keyCount": 2888,
+      "completeness": 1,
       "rtl": false
     },
     {
       "code": "hr",
       "label": "Croatian",
       "nativeLabel": "Hrvatski",
-      "version": "sha256-4f04284c811700e5cfe42742312c56076628e6350df2fc6edb24599dccd4d7b7",
-      "size": 109069,
-      "keyCount": 2642,
-      "completeness": 0.9015897047691143,
+      "version": "sha256-7f6dd49a642e65b67239ba356921b5d99149e2960a5cafa1182223f7c4ade20a",
+      "size": 138630,
+      "keyCount": 2888,
+      "completeness": 1,
       "rtl": false
     },
     {
       "code": "pt-BR",
       "label": "Portuguese (Brazil)",
       "nativeLabel": "Português (Brasil)",
-      "version": "sha256-b008dbf9941075a7a96d3f9e772135b2e7887cf922dae1758643d5e72e931b69",
-      "size": 112047,
-      "keyCount": 2642,
-      "completeness": 0.9015897047691143,
+      "version": "sha256-8be7d6aaaf8d40ae225eb452f193823bbb36f15eb9f89a29fd9cd0718d5df96d",
+      "size": 142783,
+      "keyCount": 2888,
+      "completeness": 1,
       "rtl": false
     },
     {
       "code": "zh-CN",
       "label": "Chinese (Simplified)",
       "nativeLabel": "简体中文",
-      "version": "sha256-b1596afc6520a778c850df76ae994af7ee8204a8fc039051ee72bfb8dad8b0df",
-      "size": 100716,
-      "keyCount": 2642,
-      "completeness": 0.9015897047691143,
+      "version": "sha256-abc965d89a65ed427e1ab2fe70f577ff9d29b8f1a7d3296f3c9c4b2e7e5418dc",
+      "size": 128550,
+      "keyCount": 2888,
+      "completeness": 1,
       "rtl": false
     }
   ]

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@courthive/i18n",
-  "packageManager": "pnpm@11.21.0",
-  "version": "0.4.9",
+  "packageManager": "pnpm@11.22.0",
+  "version": "0.5.0",
   "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",