Files
mokosh/tests/i18n/locale-parity.test.ts
Mark 34a9ce10d4 test(01-12): wave-0 — scaffold RED unit tests (tokens / fonts / icons / no-remote-fonts / manifest-i18n / locale-parity)
Wave 0 of the design-integration plan. Six new test files at tests/build/
and tests/i18n/ pin the contracts that later waves will GREEN:

- tokens-adopted.test.ts (4 cases): src/shared/tokens.css exists +
  parses; src/popup/style.css @imports it; popup/style.css has zero
  hex literals; welcome.css conditional check.
- fonts-present.test.ts: 7 required WOFF2 faces (Lora normal + Plex Sans
  ×4 + Plex Mono ×2) + LICENSE-Lora + LICENSE-IBM-Plex + README +
  optional Lora-Italic (A5 verify-at-execute).
- icons-present.test.ts (15 cases across 3 sizes): existence, size FLOOR
  per assets-spec.md, PNG signature, dimensions, color-type byte === 6
  (RGBA — RED until Wave 2 rsvg-convert overwrites the 16-bit-RGB
  placeholders).
- no-remote-fonts.test.ts: production dist/ contains zero
  fonts.googleapis.com / https://fonts / googleapis substrings (MV3 CSP
  self-host invariant T-01-12-01).
- manifest-i18n.test.ts (10 cases): manifest:name === '__MSG_extName__',
  :description === '__MSG_extDesc__', :default_locale === 'en',
  :action.default_title === '__MSG_tooltipOff__'; _locales/{en,ru}/
  messages.json carry D-07 + D-08 canonical strings.
- locale-parity.test.ts (4 cases): ru→en parity, en→ru symmetric,
  non-empty .message strings (RESEARCH Pitfall 4 mitigation).

Current polarity: 29 RED + 18 GREEN across the 6 new files (placeholders
already clear dim+size floors; no-remote-fonts vacuous-GREEN since
tokens.css doesn't yet exist with remote URLs). Existing 100/100 vitest
baseline preserved (verified SKIP_BUILD=1 npx vitest run).

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-19 21:56:08 +02:00

79 lines
3.0 KiB
TypeScript

// tests/i18n/locale-parity.test.ts — Plan 01-12 Wave 0 RED unit test.
//
// Enforces default_locale parity: every key in _locales/ru/messages.json
// must exist in _locales/en/messages.json (the default_locale fallback).
// Symmetric check for cleanliness; non-empty message strings throughout.
//
// Polarity at Wave 0 land: RED across the board (no _locales/ yet).
// Flips GREEN after Wave 3 Task 1 lands both locale files with parity.
//
// References:
// - RESEARCH Pitfall 4 (missing default_locale key returns empty string,
// not the key name — silent UI breakage if EN locale lacks a key the
// RU locale defines).
import { describe, expect, it } from 'vitest';
import { existsSync, readFileSync } from 'node:fs';
import { resolve as resolvePath } from 'node:path';
const EN_LOCALE_PATH = resolvePath(process.cwd(), '_locales/en/messages.json');
const RU_LOCALE_PATH = resolvePath(process.cwd(), '_locales/ru/messages.json');
interface I18nEntry {
message: string;
description?: string;
}
type LocaleFile = Record<string, I18nEntry>;
function loadLocale(filePath: string): LocaleFile {
if (!existsSync(filePath)) {
throw new Error(`Missing locale file: ${filePath} (RED until Wave 3 Task 1)`);
}
return JSON.parse(readFileSync(filePath, 'utf8'));
}
describe('Plan 01-12: _locales/ key parity (default_locale fallback invariant)', () => {
it('every key in _locales/ru/messages.json exists in _locales/en/messages.json', () => {
const ru = loadLocale(RU_LOCALE_PATH);
const en = loadLocale(EN_LOCALE_PATH);
const ruKeys = Object.keys(ru);
const missingInEn = ruKeys.filter((k) => !(k in en));
expect(
missingInEn,
missingInEn.length === 0
? 'unreachable'
: `Keys present in ru/ but missing in en/ (silent UI breakage risk):\n - ${missingInEn.join('\n - ')}`,
).toEqual([]);
});
it('every key in _locales/en/messages.json exists in _locales/ru/messages.json (symmetric)', () => {
const ru = loadLocale(RU_LOCALE_PATH);
const en = loadLocale(EN_LOCALE_PATH);
const enKeys = Object.keys(en);
const missingInRu = enKeys.filter((k) => !(k in ru));
expect(
missingInRu,
missingInRu.length === 0
? 'unreachable'
: `Keys present in en/ but missing in ru/ (cleanliness):\n - ${missingInRu.join('\n - ')}`,
).toEqual([]);
});
it('every key in _locales/en/messages.json has a non-empty .message string', () => {
const en = loadLocale(EN_LOCALE_PATH);
for (const k of Object.keys(en)) {
expect(typeof en[k].message, `en:${k}.message must be a string`).toBe('string');
expect(en[k].message.length, `en:${k}.message must be non-empty`).toBeGreaterThan(0);
}
});
it('every key in _locales/ru/messages.json has a non-empty .message string', () => {
const ru = loadLocale(RU_LOCALE_PATH);
for (const k of Object.keys(ru)) {
expect(typeof ru[k].message, `ru:${k}.message must be a string`).toBe('string');
expect(ru[k].message.length, `ru:${k}.message must be non-empty`).toBeGreaterThan(0);
}
});
});