# Rust migration plan: x18n 10 packages, 257 source files (26615 lines), 52 test files, 42 UI files, grouped into 142 units. | Ready | Caution | Blocked | Keep in JS/TS | | ---: | ---: | ---: | ---: | | 107 | 8 | 7 | 20 | ## Start here Best first ports: safe to port (readiness) and worth porting (loops and string work, tests, size). | # | Unit | Lines | Priority | Readiness | Tests | Bridge | Main risks | | ---: | --- | ---: | ---: | ---: | ---: | --- | --- | | 1 | `packages/builtins/src/formats/properties/` | 151 | 90 | 91 | 1 | wasm-bindgen | String offsets (UTF-16 vs UTF-8) (5); Insertion-ordered maps and object keys (1); Exceptions (1) | | 2 | `packages/builtins/src/formats/resx/` | 235 | 88 | 79 | 1 | wasm-bindgen | String offsets (UTF-16 vs UTF-8) (22); Insertion-ordered maps and object keys (2); Exceptions (3) | | 3 | `packages/builtins/src/manifests/` | 136 | 87 | 85 | 1 | wasm-bindgen | String offsets (UTF-16 vs UTF-8) (11); Insertion-ordered maps and object keys (3); JSON round-trips (2) | | 4 | `packages/builtins/src/formats/ini/` | 197 | 87 | 78 | 1 | wasm-bindgen | String offsets (UTF-16 vs UTF-8) (20); Insertion-ordered maps and object keys (2); Callback-shaped APIs (1) | | 5 | `packages/core/src/fuzzy.ts` | 20 | 82 | 94 | 0 | wasm-bindgen | String offsets (UTF-16 vs UTF-8) (2) | | 6 | `packages/builtins/src/presets/i18next/` | 85 | 81 | 88 | 2 | wasm-bindgen | String offsets (UTF-16 vs UTF-8) (4); Async and promises (5) | | 7 | `packages/builtins/src/formats/ftl/` | 262 | 81 | 81 | 1 | wasm-bindgen | String offsets (UTF-16 vs UTF-8) (14); Insertion-ordered maps and object keys (2); Exceptions (2) | | 8 | `packages/builtins/src/formats/po/` | 219 | 79 | 77 | 1 | wasm-bindgen | String offsets (UTF-16 vs UTF-8) (13); Regex features the `regex` crate lacks (1); Callback-shaped APIs (2) | | 9 | `packages/core/src/text.ts` | 102 | 79 | 74 | 0 | wasm-bindgen | String offsets (UTF-16 vs UTF-8) (10); Callback-shaped APIs (3); Insertion-ordered maps and object keys (1) | | 10 | `packages/builtins/src/formats/json5/` | 171 | 78 | 86 | 1 | wasm-bindgen | String offsets (UTF-16 vs UTF-8) (5); Insertion-ordered maps and object keys (3); Exceptions (3) | ### `packages/builtins/src/formats/properties/` 151 lines in 2 files, wave 1, priority 90, readiness 91, bridge **wasm-bindgen**. - 1 test files import it directly. - Portable code: wasm-bindgen keeps it running in browsers and Node. - String offsets (UTF-16 vs UTF-8) x5: `packages/builtins/src/formats/properties/index.ts:35`, `packages/builtins/src/formats/properties/index.ts:59`, `packages/builtins/src/formats/properties/index.ts:77` - Insertion-ordered maps and object keys x1: `packages/builtins/src/formats/properties/index.ts:131` - Exceptions x1: `packages/builtins/src/formats/properties/index.ts:37` ### `packages/builtins/src/formats/resx/` 235 lines in 2 files, wave 1, priority 88, readiness 79, bridge **wasm-bindgen**. - 1 test files import it directly. - Portable code: wasm-bindgen keeps it running in browsers and Node. - String offsets (UTF-16 vs UTF-8) x22: `packages/builtins/src/formats/resx/index.ts:36`, `packages/builtins/src/formats/resx/index.ts:37`, `packages/builtins/src/formats/resx/index.ts:80` - Insertion-ordered maps and object keys x2: `packages/builtins/src/formats/resx/index.ts:101`, `packages/builtins/src/formats/resx/index.ts:222` - Exceptions x3: `packages/builtins/src/formats/resx/index.ts:116`, `packages/builtins/src/formats/resx/index.ts:174`, `packages/builtins/src/formats/resx/index.ts:190` ### `packages/builtins/src/manifests/` 136 lines in 1 files, wave 0, priority 87, readiness 85, bridge **wasm-bindgen**. - Leaf: imports no other unit. - 1 test files import it directly. - Portable code: wasm-bindgen keeps it running in browsers and Node. - String offsets (UTF-16 vs UTF-8) x11: `packages/builtins/src/manifests/index.ts:41`, `packages/builtins/src/manifests/index.ts:47`, `packages/builtins/src/manifests/index.ts:58` - Insertion-ordered maps and object keys x3: `packages/builtins/src/manifests/index.ts:6`, `packages/builtins/src/manifests/index.ts:13`, `packages/builtins/src/manifests/index.ts:13` - JSON round-trips x2: `packages/builtins/src/manifests/index.ts:21`, `packages/builtins/src/manifests/index.ts:27` ### `packages/builtins/src/formats/ini/` 197 lines in 2 files, wave 1, priority 87, readiness 78, bridge **wasm-bindgen**. - 1 test files import it directly. - Portable code: wasm-bindgen keeps it running in browsers and Node. - String offsets (UTF-16 vs UTF-8) x20: `packages/builtins/src/formats/ini/index.ts:26`, `packages/builtins/src/formats/ini/index.ts:26`, `packages/builtins/src/formats/ini/index.ts:27` - Insertion-ordered maps and object keys x2: `packages/builtins/src/formats/ini/index.ts:155`, `packages/builtins/src/formats/ini/index.ts:180` - Callback-shaped APIs x1: `packages/builtins/src/formats/ini/index.ts:22` - Exceptions x2: `packages/builtins/src/formats/ini/index.ts:33`, `packages/builtins/src/formats/ini/index.ts:65` - JSON round-trips x2: `packages/builtins/src/formats/ini/index.ts:34`, `packages/builtins/src/formats/ini/index.ts:113` ### `packages/core/src/fuzzy.ts` 20 lines in 1 files, wave 0, priority 82, readiness 94, bridge **wasm-bindgen**. - Leaf: imports no other unit. - Portable code: wasm-bindgen keeps it running in browsers and Node. - String offsets (UTF-16 vs UTF-8) x2: `packages/core/src/fuzzy.ts:5`, `packages/core/src/fuzzy.ts:11` ## Order by package Packages come after the workspace packages they use. Inside a package, port by wave: a unit's imports are in earlier waves. ### 1. @x18n/docs (`docs`, node, 0 test files) | Wave | Unit | Status | Lines | Readiness | Bridge | Main risks | | ---: | --- | --- | ---: | ---: | --- | --- | | 0 | `docs/app/pages/` | keep | 5 | 100 | keep in JS | - | | 0 | `docs/app/composables/` | keep | 191 | 76 | keep in JS | String offsets (UTF-16 vs UTF-8) (1); Async and promises (8) | | 0 | `docs/app/components/` | keep | 836 | 51 | keep in JS | String offsets (UTF-16 vs UTF-8) (10); Async and promises (32) | | 4 | `docs/scripts/` | caution | 1196 | 6 | napi-rs | String offsets (UTF-16 vs UTF-8) (19); Regexes built at runtime (5) | ### 2. @x18n/core (`packages/core`, portable, 22 test files) | Wave | Unit | Status | Lines | Readiness | Bridge | Main risks | | ---: | --- | --- | ---: | ---: | --- | --- | | 0 | `packages/core/src/fuzzy.ts` | ready | 20 | 94 | wasm-bindgen | String offsets (UTF-16 vs UTF-8) (2) | | 0 | `packages/core/src/errors.ts` | ready | 158 | 83 | wasm-bindgen | Callback-shaped APIs (1) | | 1 | `packages/core/src/schema.ts` | ready | 302 | 94 | wasm-bindgen | Insertion-ordered maps and object keys (1) | | 1 | `packages/core/src/locale.ts` | ready | 126 | 81 | wasm-bindgen | String offsets (UTF-16 vs UTF-8) (5); Insertion-ordered maps and object keys (2) | | 1 | `packages/core/src/message-tree.ts` | ready | 100 | 80 | wasm-bindgen | String offsets (UTF-16 vs UTF-8) (2); Insertion-ordered maps and object keys (5) | | 1 | `packages/core/src/keys.ts` | ready | 116 | 77 | wasm-bindgen | String offsets (UTF-16 vs UTF-8) (6); Regexes built at runtime (1) | | 1 | `packages/core/src/text.ts` | ready | 102 | 74 | wasm-bindgen | String offsets (UTF-16 vs UTF-8) (10); Callback-shaped APIs (3) | | 1 | `packages/core/src/resolve.ts` | ready | 478 | 61 | wasm-bindgen | Async and promises (25); Insertion-ordered maps and object keys (6) | | 1 | `packages/core/src/plugins.ts` | ready | 208 | 59 | wasm-bindgen | String offsets (UTF-16 vs UTF-8) (4); Async and promises (8) | | 1 | `packages/core/src/types/` | caution | 1080 | 48 | wasm-bindgen | Callback-shaped APIs (100) | | 1 | `packages/core/src/project/` | caution | 3259 | 0 | wasm-bindgen | String offsets (UTF-16 vs UTF-8) (45); Regexes built at runtime (2) | | 2 | `packages/core/src/contracts.ts` | ready | 74 | 99 | wasm-bindgen | Callback-shaped APIs (1) | | 2 | `packages/core/src/define.ts` | ready | 13 | 99 | wasm-bindgen | Callback-shaped APIs (2) | | 2 | `packages/core/scripts/` | ready | 25 | 98 | napi-rs | Async and promises (4); JSON round-trips (3) | | 2 | `packages/core/src/library.ts` | ready | 73 | 95 | wasm-bindgen | Async and promises (2); Callback-shaped APIs (1) | | 2 | `packages/core/src/memory-host.ts` | ready | 27 | 94 | wasm-bindgen | Async and promises (4); Insertion-ordered maps and object keys (2) | | 2 | `packages/core/src/overlay-host.ts` | ready | 26 | 91 | wasm-bindgen | Async and promises (3); Callback-shaped APIs (3) | | 3 | `packages/core/src/index.ts` | ready | 37 | 100 | wasm-bindgen | - | ### 3. @x18n/builtins (`packages/builtins`, portable, 19 test files, uses @x18n/core) | Wave | Unit | Status | Lines | Readiness | Bridge | Main risks | | ---: | --- | --- | ---: | ---: | --- | --- | | 0 | `packages/builtins/src/reporters/shared/` | ready | 33 | 100 | wasm-bindgen | - | | 0 | `packages/builtins/src/reviews/` | ready | 28 | 98 | wasm-bindgen | Insertion-ordered maps and object keys (2); Exceptions (1) | | 0 | `packages/builtins/src/scanners/regex-scopes/` | ready | 41 | 92 | wasm-bindgen | String offsets (UTF-16 vs UTF-8) (1); Regexes built at runtime (1) | | 0 | `packages/builtins/src/presets/shared/` | ready | 55 | 86 | wasm-bindgen | Callback-shaped APIs (1) | | 0 | `packages/builtins/src/manifests/` | ready | 136 | 85 | wasm-bindgen | String offsets (UTF-16 vs UTF-8) (11); Insertion-ordered maps and object keys (3) | | 0 | `packages/builtins/src/scanners/regex/` | ready | 76 | 85 | wasm-bindgen | String offsets (UTF-16 vs UTF-8) (3); Regexes built at runtime (1) | | 0 | `packages/builtins/src/placeholders/` | ready | 173 | 58 | wasm-bindgen | String offsets (UTF-16 vs UTF-8) (8); Regex features the `regex` crate lacks (4) | | 0 | `packages/builtins/src/extractors/` | ready | 469 | 54 | wasm-bindgen | String offsets (UTF-16 vs UTF-8) (13); Regexes built at runtime (2) | | 0 | `packages/builtins/src/formats/shared/` | caution | 347 | 47 | wasm-bindgen | String offsets (UTF-16 vs UTF-8) (28); Regex features the `regex` crate lacks (1) | | 0 | `packages/builtins/src/scanners/shared/` | blocked | 790 | 43 | wasm-bindgen | String offsets (UTF-16 vs UTF-8) (8); Insertion-ordered maps and object keys (15) | | 1 | `packages/builtins/src/formats/json/` | ready | 19 | 100 | wasm-bindgen | - | | 1 | `packages/builtins/src/formats/jsonc/` | ready | 18 | 100 | wasm-bindgen | - | | 1 | `packages/builtins/src/presets/easy-localization/` | ready | 43 | 100 | wasm-bindgen | - | | 1 | `packages/builtins/src/presets/ember-intl/` | ready | 48 | 100 | wasm-bindgen | - | | 1 | `packages/builtins/src/presets/fluent-react/` | ready | 55 | 100 | wasm-bindgen | - | | 1 | `packages/builtins/src/presets/flutter-translate/` | ready | 40 | 100 | wasm-bindgen | - | | 1 | `packages/builtins/src/presets/flutter/` | ready | 40 | 100 | wasm-bindgen | - | | 1 | `packages/builtins/src/presets/general/` | ready | 24 | 100 | wasm-bindgen | - | | 1 | `packages/builtins/src/presets/globalize/` | ready | 43 | 100 | wasm-bindgen | - | | 1 | `packages/builtins/src/presets/gravity-ui-i18n/` | ready | 54 | 100 | wasm-bindgen | - | | 1 | `packages/builtins/src/presets/i18n-tag/` | ready | 34 | 100 | wasm-bindgen | - | | 1 | `packages/builtins/src/presets/jekyll/` | ready | 34 | 100 | wasm-bindgen | - | | 1 | `packages/builtins/src/presets/laravel/` | ready | 49 | 100 | wasm-bindgen | - | | 1 | `packages/builtins/src/presets/lingui/` | ready | 70 | 100 | wasm-bindgen | - | | 1 | `packages/builtins/src/presets/next-international/` | ready | 42 | 100 | wasm-bindgen | - | | 1 | `packages/builtins/src/presets/next-intl/` | ready | 67 | 100 | wasm-bindgen | - | | 1 | `packages/builtins/src/presets/next-translate/` | ready | 57 | 100 | wasm-bindgen | - | | 1 | `packages/builtins/src/presets/ngx-translate/` | ready | 62 | 100 | wasm-bindgen | - | | 1 | `packages/builtins/src/presets/paraglide/` | ready | 57 | 100 | wasm-bindgen | - | | 1 | `packages/builtins/src/presets/php-gettext/` | ready | 39 | 100 | wasm-bindgen | - | | 1 | `packages/builtins/src/presets/php-joomla/` | ready | 38 | 100 | wasm-bindgen | - | | 1 | `packages/builtins/src/presets/polyglot/` | ready | 40 | 100 | wasm-bindgen | - | | 1 | `packages/builtins/src/presets/python-gettext/` | ready | 56 | 100 | wasm-bindgen | - | | 1 | `packages/builtins/src/presets/react-intl/` | ready | 53 | 100 | wasm-bindgen | - | | 1 | `packages/builtins/src/presets/ruby-i18n-js/` | ready | 34 | 100 | wasm-bindgen | - | | 1 | `packages/builtins/src/presets/solid-primitives-i18n/` | ready | 42 | 100 | wasm-bindgen | - | | 1 | `packages/builtins/src/presets/svelte-i18n/` | ready | 49 | 100 | wasm-bindgen | - | | 1 | `packages/builtins/src/presets/transloco/` | ready | 68 | 100 | wasm-bindgen | - | | 1 | `packages/builtins/src/presets/typesafe-i18n/` | ready | 72 | 100 | wasm-bindgen | - | | 1 | `packages/builtins/src/presets/ui5/` | ready | 49 | 100 | wasm-bindgen | - | | 1 | `packages/builtins/src/scanners/js/` | ready | 48 | 98 | wasm-bindgen | Async and promises (2) | | 1 | `packages/builtins/src/presets/ruby-rails/` | ready | 51 | 97 | wasm-bindgen | String offsets (UTF-16 vs UTF-8) (1) | | 1 | `packages/builtins/src/presets/i18nice/` | ready | 46 | 95 | wasm-bindgen | String offsets (UTF-16 vs UTF-8) (2) | | 1 | `packages/builtins/src/formats/properties/` | ready | 151 | 91 | wasm-bindgen | String offsets (UTF-16 vs UTF-8) (5); Insertion-ordered maps and object keys (1) | | 1 | `packages/builtins/src/presets/cargo-i18n/` | ready | 46 | 91 | wasm-bindgen | String offsets (UTF-16 vs UTF-8) (2); Async and promises (2) | | 1 | `packages/builtins/src/presets/vscode-extension/` | ready | 71 | 91 | wasm-bindgen | String offsets (UTF-16 vs UTF-8) (2); Async and promises (2) | | 1 | `packages/builtins/src/formats/ecmascript/` | ready | 245 | 89 | wasm-bindgen | String offsets (UTF-16 vs UTF-8) (1); Insertion-ordered maps and object keys (2) | | 1 | `packages/builtins/src/presets/chrome-extension/` | ready | 81 | 88 | wasm-bindgen | String offsets (UTF-16 vs UTF-8) (1); Async and promises (6) | | 1 | `packages/builtins/src/presets/i18next/` | ready | 85 | 88 | wasm-bindgen | String offsets (UTF-16 vs UTF-8) (4); Async and promises (5) | | 1 | `packages/builtins/src/presets/dotnet-resx/` | ready | 74 | 87 | wasm-bindgen | String offsets (UTF-16 vs UTF-8) (2); Async and promises (5) | | 1 | `packages/builtins/src/formats/json5/` | ready | 171 | 86 | wasm-bindgen | String offsets (UTF-16 vs UTF-8) (5); Insertion-ordered maps and object keys (3) | | 1 | `packages/builtins/src/reporters/` | ready | 252 | 86 | wasm-bindgen | String offsets (UTF-16 vs UTF-8) (2); Insertion-ordered maps and object keys (1) | | 1 | `packages/builtins/src/formats/ftl/` | ready | 262 | 81 | wasm-bindgen | String offsets (UTF-16 vs UTF-8) (14); Insertion-ordered maps and object keys (2) | | 1 | `packages/builtins/src/formats/yaml/` | ready | 161 | 80 | wasm-bindgen | String offsets (UTF-16 vs UTF-8) (6); Insertion-ordered maps and object keys (2) | | 1 | `packages/builtins/src/formats/resx/` | ready | 235 | 79 | wasm-bindgen | String offsets (UTF-16 vs UTF-8) (22); Insertion-ordered maps and object keys (2) | | 1 | `packages/builtins/src/formats/ini/` | ready | 197 | 78 | wasm-bindgen | String offsets (UTF-16 vs UTF-8) (20); Insertion-ordered maps and object keys (2) | | 1 | `packages/builtins/src/formats/php/` | ready | 248 | 78 | wasm-bindgen | String offsets (UTF-16 vs UTF-8) (12); Regex features the `regex` crate lacks (1) | | 1 | `packages/builtins/src/formats/po/` | ready | 219 | 77 | wasm-bindgen | String offsets (UTF-16 vs UTF-8) (13); Regex features the `regex` crate lacks (1) | | 1 | `packages/builtins/src/scanners/vue/` | ready | 191 | 71 | wasm-bindgen | String offsets (UTF-16 vs UTF-8) (4); Regex features the `regex` crate lacks (2) | | 1 | `packages/builtins/src/scanners/svelte/` | blocked | 127 | 64 | wasm-bindgen | String offsets (UTF-16 vs UTF-8) (3); Dynamic typing (`any`, `in` checks) (6) | | 1 | `packages/builtins/src/scanners/astro/` | ready | 296 | 59 | wasm-bindgen | String offsets (UTF-16 vs UTF-8) (15); Regex features the `regex` crate lacks (4) | | 1 | `packages/builtins/src/checks/` | ready | 450 | 52 | wasm-bindgen | String offsets (UTF-16 vs UTF-8) (5); Regexes built at runtime (4) | | 2 | `packages/builtins/src/formats/` | ready | 29 | 100 | wasm-bindgen | - | | 2 | `packages/builtins/src/presets/react-i18next/` | ready | 60 | 100 | wasm-bindgen | - | | 2 | `packages/builtins/src/presets/svelte-i18next/` | ready | 40 | 100 | wasm-bindgen | - | | 2 | `packages/builtins/src/scanners/` | ready | 11 | 100 | wasm-bindgen | - | | 2 | `packages/builtins/src/presets/laravel-vue-i18n/` | ready | 68 | 97 | wasm-bindgen | String offsets (UTF-16 vs UTF-8) (1); Async and promises (2) | | 2 | `packages/builtins/src/finders/` | caution | 475 | 50 | wasm-bindgen | String offsets (UTF-16 vs UTF-8) (16); Regexes built at runtime (1) | | 3 | `packages/builtins/src/presets/fluent-vue/` | ready | 71 | 100 | wasm-bindgen | - | | 3 | `packages/builtins/src/presets/i18next-shopify/` | ready | 37 | 100 | wasm-bindgen | - | | 3 | `packages/builtins/src/presets/vue-i18n/` | ready | 78 | 100 | wasm-bindgen | - | | 3 | `packages/builtins/src/index.ts` | ready | 41 | 99 | wasm-bindgen | Async and promises (5); Insertion-ordered maps and object keys (3) | | 4 | `packages/builtins/src/presets/nuxt-i18n/` | ready | 40 | 90 | wasm-bindgen | String offsets (UTF-16 vs UTF-8) (1); Async and promises (5) | | 5 | `packages/builtins/src/presets/nuxt-i18n-micro/` | ready | 98 | 90 | wasm-bindgen | String offsets (UTF-16 vs UTF-8) (2); Async and promises (2) | | 6 | `packages/builtins/src/presets/` | ready | 97 | 100 | wasm-bindgen | - | ### 4. @x18n/node (`packages/node`, node, 6 test files, uses @x18n/builtins, @x18n/core) | Wave | Unit | Status | Lines | Readiness | Bridge | Main risks | | ---: | --- | --- | ---: | ---: | --- | --- | | 0 | `packages/node/src/yaml-plugin.ts` | ready | 111 | 91 | napi-rs | Regexes built at runtime (1); Async and promises (2) | | 0 | `packages/node/src/host.ts` | ready | 221 | 71 | napi-rs | Async and promises (27); Insertion-ordered maps and object keys (5) | | 0 | `packages/node/src/git-history.ts` | ready | 445 | 58 | napi-rs | String offsets (UTF-16 vs UTF-8) (2); Async and promises (24) | | 0 | `packages/node/src/migrate.ts` | caution | 715 | 48 | napi-rs | String offsets (UTF-16 vs UTF-8) (5); Insertion-ordered maps and object keys (17) | | 1 | `packages/node/src/config.ts` | blocked | 207 | 55 | napi-rs | String offsets (UTF-16 vs UTF-8) (1); Async and promises (19) | | 2 | `packages/node/src/load.ts` | ready | 288 | 84 | napi-rs | Async and promises (16); Callback-shaped APIs (1) | | 3 | `packages/node/src/index.ts` | ready | 8 | 100 | napi-rs | - | ### 5. @x18n/ui (`packages/ui`, node, 7 test files, uses @x18n/builtins, @x18n/core, @x18n/node) | Wave | Unit | Status | Lines | Readiness | Bridge | Main risks | | ---: | --- | --- | ---: | ---: | --- | --- | | 0 | `packages/ui/src/node/` | blocked | 1197 | 18 | napi-rs | String offsets (UTF-16 vs UTF-8) (3); Callback-shaped APIs (16) | | 1 | `packages/ui/app/components/` | keep | 361 | 59 | keep in JS | String offsets (UTF-16 vs UTF-8) (9); Async and promises (10) | | 1 | `packages/ui/app/` | keep | 727 | 27 | keep in JS | String offsets (UTF-16 vs UTF-8) (5); Async and promises (22) | | 2 | `packages/ui/app/components/ui/` | keep | 18 | 99 | keep in JS | - | | 3 | `packages/ui/app/pages/locales/` | keep | 28 | 100 | keep in JS | - | | 3 | `packages/ui/app/pages/keys/` | keep | 258 | 81 | keep in JS | Async and promises (8); Insertion-ordered maps and object keys (3) | | 3 | `packages/ui/app/pages/` | keep | 285 | 80 | keep in JS | String offsets (UTF-16 vs UTF-8) (1); Insertion-ordered maps and object keys (11) | ### 6. @x18n/cli (`packages/cli`, node, 2 test files, uses @x18n/builtins, @x18n/core, @x18n/node, @x18n/ui) | Wave | Unit | Status | Lines | Readiness | Bridge | Main risks | | ---: | --- | --- | ---: | ---: | --- | --- | | 0 | `packages/cli/bin.mjs` | ready | 2 | 100 | napi-rs | - | | 0 | `packages/cli/src/index.ts` | ready | 2 | 100 | napi-rs | - | | 0 | `packages/cli/src/presets.ts` | ready | 44 | 100 | napi-rs | - | | 0 | `packages/cli/src/context.ts` | ready | 178 | 80 | napi-rs | String offsets (UTF-16 vs UTF-8) (2); Async and promises (7) | | 1 | `packages/cli/src/commands/` | blocked | 1139 | 16 | napi-rs | String offsets (UTF-16 vs UTF-8) (12); Regexes built at runtime (1) | | 2 | `packages/cli/src/cli.ts` | ready | 204 | 81 | napi-rs | Async and promises (12); Callback-shaped APIs (3) | ### 7. @x18n/monorepo (`.`, node, 3 test files, uses @x18n/cli, @x18n/node) | Wave | Unit | Status | Lines | Readiness | Bridge | Main risks | | ---: | --- | --- | ---: | ---: | --- | --- | | 0 | `scripts/` | ready | 117 | 79 | napi-rs | String offsets (UTF-16 vs UTF-8) (2); Async and promises (19) | ### 8. @x18n/devtools (`packages/devtools`, node, 1 test files, uses @x18n/node, @x18n/ui) | Wave | Unit | Status | Lines | Readiness | Bridge | Main risks | | ---: | --- | --- | ---: | ---: | --- | --- | | 0 | `packages/devtools/src/load.ts` | blocked | 31 | 84 | napi-rs | Async and promises (3) | | 1 | `packages/devtools/src/devframe.ts` | ready | 9 | 100 | napi-rs | - | | 1 | `packages/devtools/src/vite.ts` | ready | 20 | 96 | napi-rs | Async and promises (2) | ### 9. @x18n/lsp (`packages/lsp`, node, 7 test files, uses @x18n/builtins, @x18n/core, @x18n/node, @x18n/ui) | Wave | Unit | Status | Lines | Readiness | Bridge | Main risks | | ---: | --- | --- | ---: | ---: | --- | --- | | 0 | `packages/lsp/bin.mjs` | ready | 2 | 100 | napi-rs | - | | 0 | `packages/lsp/src/protocol.ts` | ready | 213 | 93 | napi-rs | - | | 1 | `packages/lsp/src/ui.ts` | blocked | 50 | 77 | napi-rs | Async and promises (9); Callback-shaped APIs (2) | | 1 | `packages/lsp/src/server.ts` | caution | 1193 | 28 | napi-rs | String offsets (UTF-16 vs UTF-8) (10); Async and promises (74) | | 2 | `packages/lsp/src/index.ts` | ready | 3 | 100 | napi-rs | - | | 3 | `packages/lsp/src/cli.ts` | ready | 6 | 100 | napi-rs | - | ### 10. x18n-vscode (`packages/vscode`, node, 10 test files, uses @x18n/lsp) | Wave | Unit | Status | Lines | Readiness | Bridge | Main risks | | ---: | --- | --- | ---: | ---: | --- | --- | | 0 | `packages/vscode/src/server.ts` | ready | 5 | 100 | napi-rs | - | | 0 | `packages/vscode/scripts/` | ready | 22 | 97 | napi-rs | Async and promises (5); JSON round-trips (2) | | 0 | `packages/vscode/src/config.ts` | ready | 12 | 92 | napi-rs | - | | 0 | `packages/vscode/src/model/` | caution | 524 | 49 | napi-rs | String offsets (UTF-16 vs UTF-8) (5); Async and promises (11) | | 1 | `packages/vscode/src/flags.ts` | keep | 16 | 93 | keep in JS | Async and promises (2) | | 1 | `packages/vscode/src/panel.ts` | keep | 39 | 91 | keep in JS | Async and promises (3); Callback-shaped APIs (1) | | 1 | `packages/vscode/src/client.ts` | keep | 79 | 88 | keep in JS | Async and promises (5); Callback-shaped APIs (2) | | 1 | `packages/vscode/src/migrate.ts` | keep | 64 | 87 | keep in JS | Async and promises (11); Exceptions (1) | | 1 | `packages/vscode/src/typescript-native.ts` | keep | 52 | 87 | keep in JS | Dynamic typing (`any`, `in` checks) (5); Async and promises (4) | | 1 | `packages/vscode/src/log.ts` | keep | 43 | 86 | keep in JS | Async and promises (3); Callback-shaped APIs (1) | | 1 | `packages/vscode/src/annotations.ts` | keep | 133 | 83 | keep in JS | Insertion-ordered maps and object keys (5); Async and promises (2) | | 1 | `packages/vscode/src/reviews.ts` | keep | 122 | 78 | keep in JS | Async and promises (8); Dynamic typing (`any`, `in` checks) (4) | | 2 | `packages/vscode/src/views.ts` | keep | 105 | 87 | keep in JS | Async and promises (10); Callback-shaped APIs (1) | | 2 | `packages/vscode/src/commands.ts` | keep | 338 | 60 | keep in JS | Async and promises (87); Dynamic typing (`any`, `in` checks) (4) | | 3 | `packages/vscode/src/index.ts` | keep | 131 | 90 | keep in JS | Async and promises (11); Exceptions (2) | ## npm dependencies | Package | Units | Rust | Fit | Note | | --- | ---: | --- | --- | --- | | `devframe` | 4 | - | none | Dev server or UI framework: keep in JS. | | `@vue/compiler-sfc` | 1 | - | none | No Rust Vue compiler. Keep SFC parsing in JS or split blocks before the bridge. | | `jiti` | 1 | - | none | Loads TS/JS config or plugins at runtime. Keep loading in JS and pass data to Rust. | | `svelte` | 1 | - | none | The Svelte compiler is JS only. Keep it in JS. | | `@valibot/to-json-schema` | 2 | ? | unknown | | | `nostics` | 2 | ? | unknown | | | `@vitejs/devtools-kit` | 1 | ? | unknown | | | `reactive-vscode` | 1 | ? | unknown | | | `yaml` | 6 | saphyr, serde_yaml_ng | partial | Parsing is covered. No crate rewrites YAML while keeping comments and layout. | | `valibot` | 2 | serde, garde | partial | Schemas become types plus validation; error messages will differ. | | `vscode-languageserver-textdocument` | 1 | lsp-textdocument | partial | LSP positions are UTF-16 by default. | | `tinyglobby` | 3 | ignore, globset | good | | | `vscode-languageserver` | 3 | tower-lsp-server | good | | | `chokidar` | 2 | notify | good | | | `jsonc-parser` | 2 | jsonc-parser | good | dprint's crate, with a CST for edits. | | `oxc-parser` | 2 | oxc | good | oxc-parser is already a binding of the Rust crate. | | `cac` | 1 | clap | good | | | `ignore` | 1 | ignore | good | | | `json5` | 1 | json5 | good | | ## Blocked - `packages/builtins/src/scanners/shared/`: `@vue/compiler-sfc` has no Rust equivalent. - `packages/builtins/src/scanners/svelte/`: `svelte` has no Rust equivalent. - `packages/cli/src/commands/`: `devframe` has no Rust equivalent. - `packages/devtools/src/load.ts`: `devframe` has no Rust equivalent. - `packages/lsp/src/ui.ts`: `devframe` has no Rust equivalent. - `packages/node/src/config.ts`: `jiti` has no Rust equivalent. - `packages/ui/src/node/`: `devframe` has no Rust equivalent. ## Risk guide - **String offsets (UTF-16 vs UTF-8)** (High): JS indexes strings in UTF-16 code units, Rust in UTF-8 bytes. Offsets that cross the boundary must be converted, or non-ASCII text gets wrong ranges silently. - **Regex features the `regex` crate lacks** (High): Lookaround, backreferences and the `y` flag are not in the `regex` crate. Use `fancy-regex` for those patterns, or rewrite them. - **Regexes built at runtime** (High): Patterns come from data or config in JS syntax. Rust regex syntax differs, so user-visible behavior can change. Pin it with tests on real patterns. - **Dynamic typing (`any`, `in` checks)** (Medium): Values whose shape is checked at runtime need an explicit Rust enum or `serde_json::Value`. - **Insertion-ordered maps and object keys** (Medium): JS Map, Set and object keys keep insertion order. `HashMap` does not: use `indexmap` wherever order reaches output. - **Exceptions** (Low): Thrown errors become `Result`. Errors crossing the bridge must map back to the same JS error shape. - **Async and promises** (Medium): Promises become futures. Bridge with napi-rs `async fn` or `wasm-bindgen-futures`, or keep the async shell in JS and port the sync core. - **Generators** (Medium): Lazy generators become iterators, or return a collected Vec across the bridge. - **Reflection and prototypes** (Medium): Proxy, Reflect, Symbol and prototype tricks need a redesign, not a translation. - **Callback-shaped APIs** (Medium): Function-typed parameters and methods cross the bridge on every call. Keep boundaries coarse: pass data in, get data out. - **Number semantics** (Low): JS numbers are f64; bitwise ops truncate to i32; parseInt is lenient. Pick Rust integer types deliberately. - **JSON round-trips** (Low): JSON.stringify key order and number formatting must match `serde_json` output if the result is user-visible.