@ankhorage/orchestrator-module-expo-localization 0.1.1

package/CHANGELOG.md

@@ -0,0 +1,13 @@
+# @ankhorage/orchestrator-module-expo-localization
+
+## 0.1.1
+
+### Patch Changes
+
+- Align the module repo with the agreed standard by shipping module-owned template files, adding knip verification, and tightening CI checks.
+
+## 0.1.0
+
+### Minor Changes
+
+- Add the first publishable expo-localization module for `@ankhorage/orchestrator`.

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Ankhorage
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,78 @@
+# @ankhorage/orchestrator-module-expo-localization
+
+`@ankhorage/orchestrator-module-expo-localization` is the first standalone module extracted for `@ankhorage/orchestrator`. It replaces the old localization plugin contract from `ankhorage4/packages/plugin-kit` with a pure module that only returns supported orchestrator actions.
+
+The repo follows the module-owned template pattern: generated runtime files come from checked-in [`templates/*.tpl`](./templates) assets that the module reads and materializes into orchestrator `write-files` actions.
+
+## What it does
+
+- ensures `i18next`, `react-i18next`, and `expo-localization`
+- writes localization runtime files into `src/plugins/localization`
+- patches `src/app/_layout.tsx` to wrap the generated app shell with `LocalizationPluginProvider`
+- patches `app.config.ts` to register the Expo localization config plugin
+- keeps `ankh.config.json` aligned at `settings.localization`
+
+The module does not implement or depend on executor behavior outside the orchestrator contract. It only emits `ensure-packages`, `write-files`, `patch-text-block`, and `json-set`.
+
+## Install
+
+```sh
+bun add @ankhorage/orchestrator @ankhorage/orchestrator-module-expo-localization
+```
+
+## Usage
+
+```ts
+import { createOrchestrator } from '@ankhorage/orchestrator';
+import { expoLocalizationModule } from '@ankhorage/orchestrator-module-expo-localization';
+
+const orchestrator = createOrchestrator({
+  modules: [expoLocalizationModule],
+  projectRoot: '/absolute/path/to/project',
+});
+
+await orchestrator.installModule('expo-localization', {
+  config: {
+    defaultLocale: 'en',
+    locales: ['en', 'de'],
+    translations: {
+      en: { hello: 'Hello' },
+      de: { hello: 'Hallo' },
+    },
+  },
+});
+```
+
+## Config
+
+```ts
+{
+  defaultLocale?: string;
+  locales?: string[];
+  translations?: Record<string, Record<string, string>>;
+}
+```
+
+Defaults:
+
+- `defaultLocale`: `"en"`
+- `locales`: `["en"]`
+- `translations`: `{}`
+
+## Assumptions
+
+- The target app already has a generated `src/app/_layout.tsx`.
+- The target app uses the standard `@/` alias layout generated by the surrounding Ankhorage toolchain.
+
+This package is meant for the newer `@ankhorage/orchestrator` stack and supersedes the old `@ankh/plugin-kit` localization plugin path that is planned for removal.
+
+## Development
+
+```sh
+bun install
+bun run format:check
+bun run lint
+bun run test
+bun run build
+bun run knip
+```

package/dist/config.d.ts

@@ -0,0 +1,7 @@
+export interface ExpoLocalizationModuleConfig {
+    defaultLocale?: string;
+    locales?: string[];
+    translations?: Record<string, Record<string, string>>;
+}
+export declare function parseExpoLocalizationModuleConfig(input: unknown): Required<ExpoLocalizationModuleConfig>;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,4BAA4B;IAC3C,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;CACvD;AAED,wBAAgB,iCAAiC,CAC/C,KAAK,EAAE,OAAO,GACb,QAAQ,CAAC,4BAA4B,CAAC,CAmCxC"}

package/dist/config.js

@@ -0,0 +1,29 @@
+export function parseExpoLocalizationModuleConfig(input) {
+    const fallback = {
+        defaultLocale: 'en',
+        locales: ['en'],
+        translations: {},
+    };
+    if (!isRecord(input)) {
+        return fallback;
+    }
+    const defaultLocale = typeof input.defaultLocale === 'string' && input.defaultLocale.trim().length > 0
+        ? input.defaultLocale.trim()
+        : fallback.defaultLocale;
+    const locales = Array.isArray(input.locales) && input.locales.every((value) => typeof value === 'string')
+        ? Array.from(new Set(input.locales.map((value) => value.trim()).filter(Boolean)))
+        : fallback.locales;
+    const translations = isRecord(input.translations) &&
+        Object.values(input.translations).every((value) => isRecord(value) && Object.values(value).every((entry) => typeof entry === 'string'))
+        ? input.translations
+        : fallback.translations;
+    return {
+        defaultLocale,
+        locales: locales.length > 0 ? locales : fallback.locales,
+        translations,
+    };
+}
+function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAMA,MAAM,UAAU,iCAAiC,CAC/C,KAAc;IAEd,MAAM,QAAQ,GAA2C;QACvD,aAAa,EAAE,IAAI;QACnB,OAAO,EAAE,CAAC,IAAI,CAAC;QACf,YAAY,EAAE,EAAE;KACjB,CAAC;IAEF,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QACrB,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,MAAM,aAAa,GACjB,OAAO,KAAK,CAAC,aAAa,KAAK,QAAQ,IAAI,KAAK,CAAC,aAAa,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC;QAC9E,CAAC,CAAC,KAAK,CAAC,aAAa,CAAC,IAAI,EAAE;QAC5B,CAAC,CAAC,QAAQ,CAAC,aAAa,CAAC;IAE7B,MAAM,OAAO,GACX,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,OAAO,KAAK,KAAK,QAAQ,CAAC;QACvF,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC;QACjF,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC;IAEvB,MAAM,YAAY,GAChB,QAAQ,CAAC,KAAK,CAAC,YAAY,CAAC;QAC5B,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC,KAAK,CACrC,CAAC,KAAK,EAAE,EAAE,CACR,QAAQ,CAAC,KAAK,CAAC,IAAI,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,OAAO,KAAK,KAAK,QAAQ,CAAC,CACtF;QACC,CAAC,CAAE,KAAK,CAAC,YAAuD;QAChE,CAAC,CAAC,QAAQ,CAAC,YAAY,CAAC;IAE5B,OAAO;QACL,aAAa;QACb,OAAO,EAAE,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO;QACxD,YAAY;KACb,CAAC;AACJ,CAAC;AAED,SAAS,QAAQ,CAAC,KAAc;IAC9B,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC9E,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+import { expoLocalizationModule } from './module';
+export { type ExpoLocalizationModuleConfig, parseExpoLocalizationModuleConfig } from './config';
+export { EXPO_LOCALIZATION_MODULE_ID, expoLocalizationModule } from './module';
+export default expoLocalizationModule;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,UAAU,CAAC;AAElD,OAAO,EAAE,KAAK,4BAA4B,EAAE,iCAAiC,EAAE,MAAM,UAAU,CAAC;AAChG,OAAO,EAAE,2BAA2B,EAAE,sBAAsB,EAAE,MAAM,UAAU,CAAC;AAE/E,eAAe,sBAAsB,CAAC"}

package/dist/index.js

@@ -0,0 +1,5 @@
+import { expoLocalizationModule } from './module';
+export { parseExpoLocalizationModuleConfig } from './config';
+export { EXPO_LOCALIZATION_MODULE_ID, expoLocalizationModule } from './module';
+export default expoLocalizationModule;
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,UAAU,CAAC;AAElD,OAAO,EAAqC,iCAAiC,EAAE,MAAM,UAAU,CAAC;AAChG,OAAO,EAAE,2BAA2B,EAAE,sBAAsB,EAAE,MAAM,UAAU,CAAC;AAE/E,eAAe,sBAAsB,CAAC"}

package/dist/module.d.ts

@@ -0,0 +1,5 @@
+import { type ModuleDefinition } from '@ankhorage/orchestrator';
+import { type ExpoLocalizationModuleConfig } from './config';
+export declare const EXPO_LOCALIZATION_MODULE_ID = "expo-localization";
+export declare const expoLocalizationModule: ModuleDefinition<ExpoLocalizationModuleConfig>;
+//# sourceMappingURL=module.d.ts.map

package/dist/module.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"module.d.ts","sourceRoot":"","sources":["../src/module.ts"],"names":[],"mappings":"AAAA,OAAO,EAAmC,KAAK,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAEjG,OAAO,EAAE,KAAK,4BAA4B,EAAqC,MAAM,UAAU,CAAC;AAGhG,eAAO,MAAM,2BAA2B,sBAAsB,CAAC;AAE/D,eAAO,MAAM,sBAAsB,EAAE,gBAAgB,CAAC,4BAA4B,CAgE9E,CAAC"}

package/dist/module.js

@@ -0,0 +1,68 @@
+import { defineModule } from '@ankhorage/orchestrator';
+import { parseExpoLocalizationModuleConfig } from './config';
+import { buildLocalizationWriteFiles } from './templateFiles';
+export const EXPO_LOCALIZATION_MODULE_ID = 'expo-localization';
+export const expoLocalizationModule = defineModule({
+    id: EXPO_LOCALIZATION_MODULE_ID,
+    plan(context) {
+        const config = parseExpoLocalizationModuleConfig(context.config);
+        return [
+            {
+                type: 'ensure-packages',
+                add: [
+                    { name: 'i18next', version: '^25.8.10' },
+                    { name: 'react-i18next', version: '^16.5.4' },
+                    { name: 'expo-localization', version: '~17.0.8' },
+                ],
+            },
+            {
+                type: 'write-files',
+                files: buildLocalizationWriteFiles({
+                    defaultLocale: config.defaultLocale,
+                    locales: config.locales,
+                    translations: config.translations,
+                }),
+            },
+            {
+                type: 'patch-text-block',
+                path: 'src/app/_layout.tsx',
+                blockId: `${EXPO_LOCALIZATION_MODULE_ID}:root-layout-import`,
+                content: 'import { LocalizationPluginProvider } from "@/plugins/localization";',
+                anchor: {
+                    find: "import ankhConfig from '@root/ankh.config.json';",
+                    position: 'before',
+                },
+            },
+            {
+                type: 'patch-text-block',
+                path: 'src/app/_layout.tsx',
+                blockId: `${EXPO_LOCALIZATION_MODULE_ID}:root-layout-provider`,
+                content: '  output = <LocalizationPluginProvider>{output}</LocalizationPluginProvider>;',
+                anchor: {
+                    find: '  return (',
+                    position: 'before',
+                },
+            },
+            {
+                type: 'patch-text-block',
+                path: 'app.config.ts',
+                blockId: `${EXPO_LOCALIZATION_MODULE_ID}:expo-plugin`,
+                content: '    "expo-localization",',
+                anchor: {
+                    find: 'plugins: [',
+                    position: 'after',
+                },
+            },
+            {
+                type: 'json-set',
+                path: 'ankh.config.json',
+                jsonPath: 'settings.localization',
+                value: {
+                    defaultLocale: config.defaultLocale,
+                    locales: config.locales,
+                },
+            },
+        ];
+    },
+});
+//# sourceMappingURL=module.js.map

package/dist/module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"module.js","sourceRoot":"","sources":["../src/module.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAA4C,MAAM,yBAAyB,CAAC;AAEjG,OAAO,EAAqC,iCAAiC,EAAE,MAAM,UAAU,CAAC;AAChG,OAAO,EAAE,2BAA2B,EAAE,MAAM,iBAAiB,CAAC;AAE9D,MAAM,CAAC,MAAM,2BAA2B,GAAG,mBAAmB,CAAC;AAE/D,MAAM,CAAC,MAAM,sBAAsB,GACjC,YAAY,CAA+B;IACzC,EAAE,EAAE,2BAA2B;IAC/B,IAAI,CAAC,OAAO;QACV,MAAM,MAAM,GAAG,iCAAiC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QAEjE,OAAO;YACL;gBACE,IAAI,EAAE,iBAAiB;gBACvB,GAAG,EAAE;oBACH,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,UAAU,EAAE;oBACxC,EAAE,IAAI,EAAE,eAAe,EAAE,OAAO,EAAE,SAAS,EAAE;oBAC7C,EAAE,IAAI,EAAE,mBAAmB,EAAE,OAAO,EAAE,SAAS,EAAE;iBAClD;aACF;YACD;gBACE,IAAI,EAAE,aAAa;gBACnB,KAAK,EAAE,2BAA2B,CAAC;oBACjC,aAAa,EAAE,MAAM,CAAC,aAAa;oBACnC,OAAO,EAAE,MAAM,CAAC,OAAO;oBACvB,YAAY,EAAE,MAAM,CAAC,YAAY;iBAClC,CAAC;aACH;YACD;gBACE,IAAI,EAAE,kBAAkB;gBACxB,IAAI,EAAE,qBAAqB;gBAC3B,OAAO,EAAE,GAAG,2BAA2B,qBAAqB;gBAC5D,OAAO,EAAE,sEAAsE;gBAC/E,MAAM,EAAE;oBACN,IAAI,EAAE,kDAAkD;oBACxD,QAAQ,EAAE,QAAQ;iBACnB;aACF;YACD;gBACE,IAAI,EAAE,kBAAkB;gBACxB,IAAI,EAAE,qBAAqB;gBAC3B,OAAO,EAAE,GAAG,2BAA2B,uBAAuB;gBAC9D,OAAO,EAAE,+EAA+E;gBACxF,MAAM,EAAE;oBACN,IAAI,EAAE,YAAY;oBAClB,QAAQ,EAAE,QAAQ;iBACnB;aACF;YACD;gBACE,IAAI,EAAE,kBAAkB;gBACxB,IAAI,EAAE,eAAe;gBACrB,OAAO,EAAE,GAAG,2BAA2B,cAAc;gBACrD,OAAO,EAAE,0BAA0B;gBACnC,MAAM,EAAE;oBACN,IAAI,EAAE,YAAY;oBAClB,QAAQ,EAAE,OAAO;iBAClB;aACF;YACD;gBACE,IAAI,EAAE,UAAU;gBAChB,IAAI,EAAE,kBAAkB;gBACxB,QAAQ,EAAE,uBAAuB;gBACjC,KAAK,EAAE;oBACL,aAAa,EAAE,MAAM,CAAC,aAAa;oBACnC,OAAO,EAAE,MAAM,CAAC,OAAO;iBACxB;aACF;SACF,CAAC;IACJ,CAAC;CACF,CAAC,CAAC"}

package/dist/templateFiles.d.ts

@@ -0,0 +1,7 @@
+import type { WriteFileInstruction } from '@ankhorage/orchestrator';
+export declare function buildLocalizationWriteFiles(args: {
+    defaultLocale: string;
+    locales: string[];
+    translations: Record<string, Record<string, string>>;
+}): WriteFileInstruction[];
+//# sourceMappingURL=templateFiles.d.ts.map

package/dist/templateFiles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"templateFiles.d.ts","sourceRoot":"","sources":["../src/templateFiles.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AASpE,wBAAgB,2BAA2B,CAAC,IAAI,EAAE;IAChD,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;CACtD,GAAG,oBAAoB,EAAE,CAoCzB"}

package/dist/templateFiles.js

@@ -0,0 +1,76 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+const TEMPLATE_DIR = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '../templates');
+const templateCache = new Map();
+const defaultTranslations = {
+    de: readJsonTemplate('locales/de.json.tpl'),
+    en: readJsonTemplate('locales/en.json.tpl'),
+};
+export function buildLocalizationWriteFiles(args) {
+    const { defaultLocale, locales, translations } = args;
+    return [
+        {
+            path: 'src/plugins/localization/i18n.ts',
+            content: renderTemplate('i18n.ts.tpl', {
+                DEFAULT_LOCALE: JSON.stringify(defaultLocale),
+            }),
+            overwrite: true,
+        },
+        {
+            path: 'src/plugins/localization/useT.ts',
+            content: readTemplate('useT.ts.tpl'),
+            overwrite: true,
+        },
+        {
+            path: 'src/plugins/localization/LocalizationProvider.tsx',
+            content: renderTemplate('LocalizationProvider.tsx.tpl', {
+                DEFAULT_LOCALE: JSON.stringify(defaultLocale),
+                RESOURCE_LINES: locales
+                    .map((locale) => `      ${JSON.stringify(locale)}: { translation: require("./locales/${locale}.json") },`)
+                    .join('\n'),
+            }),
+            overwrite: true,
+        },
+        {
+            path: 'src/plugins/localization/index.ts',
+            content: readTemplate('index.ts.tpl'),
+            overwrite: true,
+        },
+        ...buildLocaleJsonFiles(locales, translations),
+    ];
+}
+function buildLocaleJsonFiles(locales, configTranslations) {
+    return locales.map((locale) => {
+        const contentSource = configTranslations[locale] ??
+            (locale.startsWith('de') ? defaultTranslations.de : defaultTranslations.en);
+        return {
+            path: `src/plugins/localization/locales/${locale}.json`,
+            content: `${JSON.stringify(contentSource, null, 2)}\n`,
+        };
+    });
+}
+function renderTemplate(templateName, replacements) {
+    let content = readTemplate(templateName);
+    for (const [token, value] of Object.entries(replacements)) {
+        content = content.replaceAll(`__${token}__`, value);
+    }
+    return content;
+}
+function readJsonTemplate(templateName) {
+    return JSON.parse(readTemplate(templateName));
+}
+function readTemplate(templateName) {
+    const cached = templateCache.get(templateName);
+    if (cached) {
+        return cached;
+    }
+    const templatePath = path.join(TEMPLATE_DIR, templateName);
+    if (!fs.existsSync(templatePath)) {
+        throw new Error(`Missing localization template: ${templateName}`);
+    }
+    const content = fs.readFileSync(templatePath, 'utf8');
+    templateCache.set(templateName, content);
+    return content;
+}
+//# sourceMappingURL=templateFiles.js.map

package/dist/templateFiles.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"templateFiles.js","sourceRoot":"","sources":["../src/templateFiles.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,50 @@
+{
+  "name": "@ankhorage/orchestrator-module-expo-localization",
+  "version": "0.1.1",
+  "description": "Expo localization module for @ankhorage/orchestrator.",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "sideEffects": false,
+  "files": [
+    "dist",
+    "templates",
+    "README.md",
+    "CHANGELOG.md",
+    "LICENSE"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "scripts": {
+    "build": "rm -rf dist tsconfig.tsbuildinfo && bun x tsc -p tsconfig.json",
+    "lint": "eslint . --max-warnings=0",
+    "lint:fix": "eslint . --fix --max-warnings=0",
+    "format": "prettier --write .",
+    "format:check": "prettier --check .",
+    "knip": "knip",
+    "test": "bun test",
+    "changeset": "changeset",
+    "changeset:version": "changeset version"
+  },
+  "dependencies": {
+    "@ankhorage/orchestrator": "^0.1.1"
+  },
+  "devDependencies": {
+    "@ankhorage/devtools": "^1.0.0",
+    "@changesets/cli": "^2.30.0",
+    "@types/bun": "^1.3.11",
+    "@types/node": "^25.2.3",
+    "eslint": "^10.2.0",
+    "knip": "^5.83.1",
+    "prettier": "^3.8.1",
+    "typescript": "^5.9.3"
+  },
+  "packageManager": "bun@1.3.11",
+  "publishConfig": {
+    "access": "public"
+  }
+}

package/templates/LocalizationProvider.tsx.tpl

@@ -0,0 +1,53 @@
+/* generated by @ankhorage/orchestrator-module-expo-localization */
+import React, { useEffect, useState } from "react";
+import * as ExpoLocalization from "expo-localization";
+import { useTranslation } from "react-i18next";
+
+import { TranslationProvider } from "@ankhorage/surface";
+
+import { initI18n } from "./i18n";
+
+export interface LocalizationPluginConfig {
+  defaultLocale?: string;
+}
+
+export function LocalizationPluginProvider(props: {
+  children: React.ReactNode;
+  config?: LocalizationPluginConfig;
+}) {
+  const { children, config } = props;
+
+  const locales = ExpoLocalization.getLocales();
+  const deviceLocale =
+    (locales.length > 0 ? locales[0]?.languageTag : null) ??
+    (ExpoLocalization as { locale?: string }).locale ??
+    __DEFAULT_LOCALE__;
+
+  const initialLocale = config?.defaultLocale ?? deviceLocale;
+  const [currentLocale, setCurrentLocale] = useState<string>(initialLocale);
+
+  useEffect(() => {
+    const resources: Record<string, { translation: Record<string, string> }> = {
+__RESOURCE_LINES__
+    };
+
+    initI18n({
+      locale: currentLocale,
+      resources
+    });
+  }, [currentLocale]);
+
+  const { t, i18n } = useTranslation();
+
+  useEffect(() => {
+    if (i18n.language && i18n.language !== currentLocale) {
+      setCurrentLocale(i18n.language);
+    }
+  }, [currentLocale, i18n.language]);
+
+  return (
+    <TranslationProvider t={i18n.isInitialized ? t : (key: string) => key} i18n={i18n}>
+      {children}
+    </TranslationProvider>
+  );
+}

package/templates/i18n.ts.tpl

@@ -0,0 +1,42 @@
+/* generated by @ankhorage/orchestrator-module-expo-localization */
+import i18n from "i18next";
+import { initReactI18next } from "react-i18next";
+
+export type I18nResources = Record<string, { translation: Record<string, string> }>;
+
+function normalizeLocale(requested: string, resources: I18nResources, fallback: string) {
+  const supported = Object.keys(resources);
+
+  if (supported.includes(requested)) return requested;
+
+  const [base] = requested.split("-");
+  if (base && supported.includes(base)) return base;
+
+  if (supported.includes(fallback)) return fallback;
+
+  return supported[0] ?? fallback;
+}
+
+export function initI18n(args: { locale: string; resources: I18nResources }) {
+  const { locale: requestedLocale, resources } = args;
+  const locale = normalizeLocale(requestedLocale, resources, __DEFAULT_LOCALE__);
+
+  if (!i18n.isInitialized) {
+    i18n.use(initReactI18next).init({
+      resources,
+      lng: locale,
+      fallbackLng: __DEFAULT_LOCALE__,
+      interpolation: { escapeValue: false },
+      react: { useSuspense: false }
+    });
+    return i18n;
+  }
+
+  if (i18n.language !== locale) {
+    void i18n.changeLanguage(locale);
+  }
+
+  return i18n;
+}
+
+export { i18n };

package/templates/index.ts.tpl

@@ -0,0 +1,4 @@
+/* generated by @ankhorage/orchestrator-module-expo-localization */
+export { LocalizationPluginProvider } from "./LocalizationProvider";
+export { useT } from "./useT";
+export { i18n } from "./i18n";

package/templates/locales/de.json.tpl

@@ -0,0 +1,6 @@
+{
+  "app_title": "Meine App",
+  "hello": "Hallo",
+  "system_overview": "Systemübersicht",
+  "system-overview": "Systemübersicht"
+}

package/templates/locales/en.json.tpl

@@ -0,0 +1,6 @@
+{
+  "app_title": "My App",
+  "hello": "Hello",
+  "system_overview": "System Overview",
+  "system-overview": "System Overview"
+}

package/templates/useT.ts.tpl

@@ -0,0 +1,7 @@
+/* generated by @ankhorage/orchestrator-module-expo-localization */
+import { useTranslation } from "react-i18next";
+
+export function useT(namespace: string = "translation") {
+  const { t, i18n } = useTranslation(namespace);
+  return { t, i18n };
+}