feat(l10n): single-source localization pipeline

Add localization/ — one strings.json is the source of truth for every
user-facing string, and a Bun CLI generates the platform files:

  loc migrate   rebuild strings.json from existing platform files (one-time)
  loc validate  structural checks (plural `other`, arg refs, coverage)
  loc generate  emit .xcstrings (Apple) + per-language strings.xml (KMP)

Canonical `{name}` placeholders are converted to each platform's positional
printf tokens using declared arg types. Plurals use CLDR categories and emit
native forms: xcstrings plural variations and Compose <plurals> blocks.

Migration folds the KMP `transfer_file_count_one`/`_other` pair into a single
plural key, so `transferFileCountResource` now returns the plural resource and
callers resolve it with pluralStringResource.
This commit is contained in:
2026-07-20 10:15:28 +02:00
parent 9a3cfb55d0
commit cd6a2d66aa
19 changed files with 4882 additions and 1775 deletions

72
localization/schema.json Normal file
View File

@@ -0,0 +1,72 @@
{
"$schema": "http://json-schema.org/draft-07/schema#",
"title": "VniDrop localization source",
"type": "object",
"required": ["sourceLanguage", "supportedLanguages", "strings"],
"additionalProperties": false,
"properties": {
"sourceLanguage": { "type": "string", "description": "Default/base language code, e.g. \"en\"." },
"supportedLanguages": {
"type": "array",
"items": { "type": "string" },
"minItems": 1,
"uniqueItems": true
},
"strings": {
"type": "object",
"additionalProperties": { "$ref": "#/definitions/entry" }
}
},
"definitions": {
"entry": {
"type": "object",
"required": ["context"],
"additionalProperties": false,
"oneOf": [
{ "required": ["translations"] },
{ "required": ["plural"] },
{ "not": { "anyOf": [{ "required": ["translations"] }, { "required": ["plural"] }] } }
],
"properties": {
"context": { "type": "string" },
"targets": {
"type": "array",
"items": { "enum": ["kmp", "apple"] },
"uniqueItems": true
},
"args": {
"type": "array",
"items": {
"type": "object",
"required": ["name", "type"],
"additionalProperties": false,
"properties": {
"name": { "type": "string", "pattern": "^[A-Za-z_][A-Za-z0-9_]*$" },
"type": { "enum": ["string", "int", "double"] }
}
}
},
"translations": {
"type": "object",
"additionalProperties": { "type": "string" }
},
"plural": {
"type": "object",
"additionalProperties": {
"type": "object",
"required": ["other"],
"additionalProperties": false,
"properties": {
"zero": { "type": "string" },
"one": { "type": "string" },
"two": { "type": "string" },
"few": { "type": "string" },
"many": { "type": "string" },
"other": { "type": "string" }
}
}
}
}
}
}
}