expo-harmony-toolkit 1.5.2 → 1.6.0

package/README.en.md

@@ -1,7 +1,7 @@
 <div align="center">
   <h1>Expo Harmony Toolkit</h1>
   <p><strong>A HarmonyOS migration, admission, and UI-stack build toolkit for Managed/CNG Expo projects.</strong></p>
-  <p>One validated UI-stack matrix, explicit dependency admission rules, managed Harmony sidecar scaffolding, and a toolkit-driven <code>doctor → init → bundle → build-hap</code> path.</p>
+  <p>One verified UI-stack matrix, additive preview/experimental capability tiers, managed Harmony sidecar scaffolding, and a toolkit-driven <code>doctor → init → bundle → build-hap</code> path.</p>
   <p>
     <a href="./README.md">简体中文</a> ·
     <a href="./README.en.md">English</a>
@@ -9,13 +9,14 @@
   <p>
     <a href="https://github.com/BlackishGreen33/Expo-Harmony-Toolkit/actions/workflows/ci.yml"><img alt="Checks" src="https://img.shields.io/badge/checks-passing-16a34a?style=flat-square&logo=githubactions&logoColor=white"></a>
     <a href="./LICENSE"><img alt="License" src="https://img.shields.io/badge/license-MIT-0f766e?style=flat-square"></a>
-    <a href="https://github.com/BlackishGreen33/Expo-Harmony-Toolkit/releases"><img alt="Version" src="https://img.shields.io/badge/version-v1.5.2-111827?style=flat-square"></a>
+    <a href="https://github.com/BlackishGreen33/Expo-Harmony-Toolkit/releases"><img alt="Version" src="https://img.shields.io/badge/version-v1.6.0-111827?style=flat-square"></a>
     <a href="./docs/support-matrix.md"><img alt="Matrix" src="https://img.shields.io/badge/matrix-expo55--rnoh082--ui--stack-2563eb?style=flat-square"></a>
     <img alt="Input" src="https://img.shields.io/badge/input-Managed%2FCNG-059669?style=flat-square">
   </p>
   <p>
     <a href="./docs/support-matrix.md">Support Matrix</a> ·
     <a href="./docs/cli-build.md">CLI Build Guide</a> ·
+    <a href="./docs/official-native-capabilities-sample.md">Official Native Capabilities Sample</a> ·
     <a href="./docs/official-ui-stack-sample.md">Official UI Stack Sample</a> ·
     <a href="./docs/npm-release.md">npm Release Notes</a> ·
     <a href="./docs/roadmap.md">Roadmap</a>
@@ -23,14 +24,14 @@
 </div>
 
 > [!IMPORTANT]
-> `v1.5.2` continues to make one formal public promise only: `expo55-rnoh082-ui-stack`. This is not a claim that arbitrary Expo applications can be published to HarmonyOS unchanged.
+> Starting with `v1.6`, the toolkit exposes `verified + preview + experimental` support tiers. `expo55-rnoh082-ui-stack` remains the only `verified` public matrix, while `expo-file-system` and `expo-image-picker` move into `preview`. This is still not a claim that arbitrary Expo apps can be published to HarmonyOS unchanged.
 
 > [!TIP]
 > The two validated `@react-native-oh-tpl/*` adapters in the public matrix are currently consumed via exact Git URLs and commits. For repository development and the official UI-stack sample, prefer `pnpm install --ignore-scripts` so adapter prepare hooks do not fail on private upstream resources.
 
 ## Overview
 
-`expo-harmony-toolkit` provides a constrained, verifiable Expo-to-Harmony toolchain:
+`expo-harmony-toolkit` provides a constrained, verifiable Expo-to-Harmony toolchain and now starts exposing preview-tier native capability bridges:
 
 - Expo config plugin entrypoint `app.plugin.js`
 - `expo-harmony doctor`
@@ -46,20 +47,23 @@
 
 | Item | Status |
 | --- | --- |
-| Current version | `v1.5.2` |
-| Public matrix | `expo55-rnoh082-ui-stack` |
+| Current version | `v1.6.0` |
+| Support model | `verified + preview + experimental` |
+| Public `verified` matrix | `expo55-rnoh082-ui-stack` |
 | Supported input | Managed/CNG Expo projects |
-| Validated JS/UI capabilities | `expo-router`, `expo-linking`, `expo-constants`, `react-native-reanimated`, `react-native-svg` |
+| `verified` JS/UI capabilities | `expo-router`, `expo-linking`, `expo-constants`, `react-native-reanimated`, `react-native-svg` |
+| `preview` native capabilities | `expo-file-system`, `expo-image-picker` |
+| `experimental` capabilities | `expo-location`, `expo-camera`, `expo-notifications`, `react-native-gesture-handler` |
 | Build path | `doctor -> init -> bundle -> build-hap` |
 | Primary sample | `examples/official-ui-stack-sample` |
+| Preview sample | `examples/official-native-capabilities-sample` |
 | Regression baselines | `examples/official-app-shell-sample`, `examples/official-minimal-sample` |
 
 <details>
-<summary><strong>Currently out of scope</strong></summary>
+<summary><strong>Still outside the verified public promise</strong></summary>
 
 - bare Expo
-- `expo-image-picker`
-- `expo-file-system`
+- `expo-file-system` and `expo-image-picker` remain `preview`
 - `expo-location`
 - `expo-camera`
 - `expo-notifications`
@@ -130,6 +134,7 @@ Notes:
 cd /path/to/app
 pnpm exec expo-harmony doctor --project-root .
 pnpm exec expo-harmony doctor --project-root . --strict
+pnpm exec expo-harmony doctor --project-root . --target-tier preview
 ```
 
 2. Generate or refresh the managed Harmony sidecar:
@@ -157,24 +162,20 @@ pnpm exec expo-harmony build-hap --mode release
 Common decision points:
 
 - Want to know whether the current project still matches the public matrix: run `doctor --strict`
+- Want to know whether the project at least falls into preview / experimental tiers: run `doctor --target-tier preview` or `doctor --target-tier experimental`
 - Changed dependencies, Expo config, or plugin wiring: run `sync-template`
 - Only want to verify JavaScript/UI portability: run `bundle`
 - About to open DevEco Studio or build a HAP locally: run `env` first
 
 ## Support Matrix
 
-`v1.5.2` stays on one public matrix: `expo55-rnoh082-ui-stack`.
+`v1.6` moves to tiered support:
 
-- Expo SDK: `55`
-- React: `19.1.1`
-- React Native: `0.82.1`
-- RNOH and `@react-native-oh/react-native-harmony-cli`: `0.82.18`
-- App Shell packages: `expo-router`, `expo-linking`, `expo-constants`
-- UI stack packages: `react-native-reanimated`, `react-native-svg`
-- Harmony adapters: the matching `@react-native-oh-tpl/*` exact Git specifiers
-- Native identifier: at least `android.package` or `ios.bundleIdentifier`
+- `verified`: the only public matrix remains `expo55-rnoh082-ui-stack`
+- `preview`: `expo-file-system`, `expo-image-picker`
+- `experimental`: `expo-location`, `expo-camera`, `expo-notifications`, `react-native-gesture-handler`
 
-`react-native-gesture-handler` is no longer part of the public matrix. It remains a manual exploration path until the current `@react-native-oh-tpl/react-native-gesture-handler` and `@react-native-oh/react-native-harmony@0.82.18` runtime pairing passes on-device validation.
+`doctor --strict` still means `verified` only. `doctor --target-tier preview` allows the same runtime matrix plus preview-tier capabilities, but that does not promote them into the formal public promise.
 
 See [docs/support-matrix.md](./docs/support-matrix.md) for the full allowlist, pairing rules, exact specifiers, issue codes, and release gates.
 
@@ -182,6 +183,8 @@ See [docs/support-matrix.md](./docs/support-matrix.md) for the full allowlist, p
 
 - `examples/official-ui-stack-sample`
   The primary public sample for `v1.5.0`, covering router, linking, constants, SVG, reanimated, and Harmony sidecar build flow.
+- `examples/official-native-capabilities-sample`
+  The new preview sample for `v1.6`, covering the `expo-file-system` and `expo-image-picker` bridge, permission generation, and bundle-time alias flow.
 - `examples/official-app-shell-sample`
   The `v1.1` App Shell regression baseline that protects router behavior while UI-stack support is finalized.
 - `examples/official-minimal-sample`
@@ -189,6 +192,7 @@ See [docs/support-matrix.md](./docs/support-matrix.md) for the full allowlist, p
 
 See:
 
+- [Official Native Capabilities Sample Guide](./docs/official-native-capabilities-sample.md)
 - [Official UI Stack Sample Guide](./docs/official-ui-stack-sample.md)
 - [Official App Shell Sample Guide](./docs/official-app-shell-sample.md)
 - [Official Minimal Sample Guide](./docs/official-minimal-sample.md)
@@ -199,6 +203,7 @@ See:
 | --- | --- |
 | `expo-harmony doctor` | Inspect Expo config and dependencies and produce a migration report |
 | `expo-harmony doctor --strict` | Run the formal matrix admission gate |
+| `expo-harmony doctor --target-tier preview` | Evaluate whether the project fits at least the preview support tier |
 | `expo-harmony init` | Generate Harmony sidecar files, autolinking artifacts, metadata, and package scripts |
 | `expo-harmony sync-template` | Reapply managed templates and report drift |
 | `expo-harmony env` | Check the local DevEco / hvigor / hdc / signing environment |
@@ -242,6 +247,7 @@ Manual Harmony acceptance still requires:
 - pressing the home-screen motion rail triggers visible animation
 - routing still works after the animation completes
 - `Build Debug Hap(s)` succeeds
+- `official-native-capabilities-sample` at least proves preview route bundling and generated Harmony permissions
 
 See [docs/npm-release.md](./docs/npm-release.md) and [docs/signing-and-release.md](./docs/signing-and-release.md).
 
@@ -249,6 +255,7 @@ See [docs/npm-release.md](./docs/npm-release.md) and [docs/signing-and-release.m
 
 - [Support Matrix](./docs/support-matrix.md)
 - [CLI Build Guide](./docs/cli-build.md)
+- [Official Native Capabilities Sample Guide](./docs/official-native-capabilities-sample.md)
 - [Official UI Stack Sample Guide](./docs/official-ui-stack-sample.md)
 - [Official App Shell Sample Guide](./docs/official-app-shell-sample.md)
 - [Official Minimal Sample Guide](./docs/official-minimal-sample.md)

package/README.md

@@ -1,7 +1,7 @@
 <div align="center">
   <h1>Expo Harmony Toolkit</h1>
   <p><strong>面向 Managed/CNG Expo 项目的 HarmonyOS 迁移、准入检查与 UI-stack 构建工具链。</strong></p>
-  <p>One validated UI-stack matrix, explicit dependency admission rules, managed Harmony sidecar scaffolding, and a toolkit-driven <code>doctor → init → bundle → build-hap</code> path.</p>
+  <p>One verified UI-stack matrix, additive preview/experimental capability tiers, managed Harmony sidecar scaffolding, and a toolkit-driven <code>doctor → init → bundle → build-hap</code> path.</p>
   <p>
     <a href="./README.md">简体中文</a> ·
     <a href="./README.en.md">English</a>
@@ -9,13 +9,14 @@
   <p>
     <a href="https://github.com/BlackishGreen33/Expo-Harmony-Toolkit/actions/workflows/ci.yml"><img alt="Checks" src="https://img.shields.io/badge/checks-passing-16a34a?style=flat-square&logo=githubactions&logoColor=white"></a>
     <a href="./LICENSE"><img alt="License" src="https://img.shields.io/badge/license-MIT-0f766e?style=flat-square"></a>
-    <a href="https://github.com/BlackishGreen33/Expo-Harmony-Toolkit/releases"><img alt="Version" src="https://img.shields.io/badge/version-v1.5.2-111827?style=flat-square"></a>
+    <a href="https://github.com/BlackishGreen33/Expo-Harmony-Toolkit/releases"><img alt="Version" src="https://img.shields.io/badge/version-v1.6.0-111827?style=flat-square"></a>
     <a href="./docs/support-matrix.md"><img alt="Matrix" src="https://img.shields.io/badge/matrix-expo55--rnoh082--ui--stack-2563eb?style=flat-square"></a>
     <img alt="Input" src="https://img.shields.io/badge/input-Managed%2FCNG-059669?style=flat-square">
   </p>
   <p>
     <a href="./docs/support-matrix.md">支持矩阵</a> ·
     <a href="./docs/cli-build.md">CLI 构建指南</a> ·
+    <a href="./docs/official-native-capabilities-sample.md">官方 Native Capabilities Sample</a> ·
     <a href="./docs/official-ui-stack-sample.md">官方 UI Stack Sample</a> ·
     <a href="./docs/npm-release.md">npm 发布说明</a> ·
     <a href="./docs/roadmap.md">路线图</a>
@@ -23,14 +24,14 @@
 </div>
 
 > [!IMPORTANT]
-> `v1.5.2` 继续只对 `expo55-rnoh082-ui-stack` 做正式公开承诺。这不是“任意 Expo 项目都能原样发布到 HarmonyOS”的声明，而是对一条受限、可验证矩阵的稳定承诺。
+> `v1.6` 开始，toolkit 采用 `verified + preview + experimental` 三层支持模型。`expo55-rnoh082-ui-stack` 仍是唯一 `verified` 公开矩阵；`expo-file-system` 与 `expo-image-picker` 进入 `preview`，但这仍然不是“任意 Expo 项目都能原样发布到 HarmonyOS”的声明。
 
 > [!TIP]
 > 由于当前公开矩阵内的两套 `@react-native-oh-tpl/*` adapter 依赖以 Git URL + exact commit 形式接入，仓库开发和官方 UI-stack sample 推荐使用 `pnpm install --ignore-scripts`，避免 Git adapter 在 prepare 阶段拉取私有资源而中断安装。
 
 ## 概览
 
-`expo-harmony-toolkit` 提供一条围绕 Expo 到 HarmonyOS 迁移的受限、可验证工具链：
+`expo-harmony-toolkit` 提供一条围绕 Expo 到 HarmonyOS 迁移的受限、可验证工具链，并开始公开 preview 层的原生能力桥接骨架：
 
 - Expo config plugin 根入口 `app.plugin.js`
 - `expo-harmony doctor`
@@ -46,20 +47,23 @@
 
 | 项目 | 说明 |
 | --- | --- |
-| 当前版本 | `v1.5.2` |
-| 唯一公开矩阵 | `expo55-rnoh082-ui-stack` |
+| 当前版本 | `v1.6.0` |
+| 支持模型 | `verified + preview + experimental` |
+| 唯一 `verified` 公开矩阵 | `expo55-rnoh082-ui-stack` |
 | 输入范围 | Managed/CNG Expo 项目 |
-| 已验证 JS/UI 能力 | `expo-router`、`expo-linking`、`expo-constants`、`react-native-reanimated`、`react-native-svg` |
+| `verified` JS/UI 能力 | `expo-router`、`expo-linking`、`expo-constants`、`react-native-reanimated`、`react-native-svg` |
+| `preview` 原生能力 | `expo-file-system`、`expo-image-picker` |
+| `experimental` 能力 | `expo-location`、`expo-camera`、`expo-notifications`、`react-native-gesture-handler` |
 | 构建链 | `doctor -> init -> bundle -> build-hap` |
 | 主 sample | `examples/official-ui-stack-sample` |
+| preview sample | `examples/official-native-capabilities-sample` |
 | 回归基线 | `examples/official-app-shell-sample`、`examples/official-minimal-sample` |
 
 <details>
-<summary><strong>当前不在承诺范围</strong></summary>
+<summary><strong>当前仍不在 verified 正式承诺范围</strong></summary>
 
 - bare Expo
-- `expo-image-picker`
-- `expo-file-system`
+- `expo-file-system`、`expo-image-picker` 仍只属于 `preview`
 - `expo-location`
 - `expo-camera`
 - `expo-notifications`
@@ -130,6 +134,7 @@ pnpm install --ignore-scripts
 cd /path/to/app
 pnpm exec expo-harmony doctor --project-root .
 pnpm exec expo-harmony doctor --project-root . --strict
+pnpm exec expo-harmony doctor --project-root . --target-tier preview
 ```
 
 2. 生成或刷新受管 Harmony sidecar：
@@ -157,24 +162,20 @@ pnpm exec expo-harmony build-hap --mode release
 常见使用判断：
 
 - 想知道当前项目是否还在公开矩阵里：跑 `doctor --strict`
+- 想知道项目是否只落在 preview / experimental：跑 `doctor --target-tier preview` 或 `doctor --target-tier experimental`
 - 刚改过依赖、Expo 配置或插件：先跑 `sync-template`
 - 只想验证 JS/UI 侧是否能打包：跑 `bundle`
 - 准备进 DevEco Studio 或本机构建 HAP：先跑 `env`
 
 ## 支持矩阵
 
-`v1.5.2` 继续坚持单矩阵路线：`expo55-rnoh082-ui-stack`。
+`v1.6` 开始改成支持分层：
 
-- Expo SDK：`55`
-- React：`19.1.1`
-- React Native：`0.82.1`
-- RNOH / `@react-native-oh/react-native-harmony-cli`：`0.82.18`
-- App Shell 依赖：`expo-router`、`expo-linking`、`expo-constants`
-- UI stack 依赖：`react-native-reanimated`、`react-native-svg`
-- Harmony adapter：对应两项 `@react-native-oh-tpl/*` exact Git specifier
-- 原生标识：至少配置 `android.package` 或 `ios.bundleIdentifier`
+- `verified`：唯一公开矩阵仍是 `expo55-rnoh082-ui-stack`
+- `preview`：`expo-file-system`、`expo-image-picker`
+- `experimental`：`expo-location`、`expo-camera`、`expo-notifications`、`react-native-gesture-handler`
 
-当前不再把 `react-native-gesture-handler` 放进公开矩阵。它仍可作为手动探索项，但当前 `@react-native-oh-tpl/react-native-gesture-handler` 与 `@react-native-oh/react-native-harmony@0.82.18` 的设备侧 runtime 组合还没有通过正式验收。
+`doctor --strict` 继续只代表 `verified`。`doctor --target-tier preview` 会在同一 runtime matrix 下额外放行 preview 能力，但这不等于它们已经进入正式承诺。
 
 完整白名单、配对规则、exact specifier、issue code 与 release gate 见 [docs/support-matrix.md](./docs/support-matrix.md)。
 
@@ -182,6 +183,8 @@ pnpm exec expo-harmony build-hap --mode release
 
 - `examples/official-ui-stack-sample`
   当前唯一对外主 sample，同时覆盖 router、linking、constants、SVG、reanimated 和 Harmony sidecar 构建链。
+- `examples/official-native-capabilities-sample`
+  v1.6 新增的 preview sample，用来承接 `expo-file-system` 与 `expo-image-picker` 的 bridge、permission 与 bundle 骨架验收。
 - `examples/official-app-shell-sample`
   `v1.1` App Shell 回归基线，用来防止 UI-stack 收口引入 router 退化。
 - `examples/official-minimal-sample`
@@ -190,6 +193,7 @@ pnpm exec expo-harmony build-hap --mode release
 详见：
 
 - [官方 UI Stack sample 指南](./docs/official-ui-stack-sample.md)
+- [官方 Native Capabilities sample 指南](./docs/official-native-capabilities-sample.md)
 - [官方 App Shell sample 指南](./docs/official-app-shell-sample.md)
 - [官方最小 sample 指南](./docs/official-minimal-sample.md)
 
@@ -199,6 +203,7 @@ pnpm exec expo-harmony build-hap --mode release
 | --- | --- |
 | `expo-harmony doctor` | 扫描 Expo 配置与依赖，输出迁移报告 |
 | `expo-harmony doctor --strict` | 将当前矩阵准入检查作为正式 gate 执行 |
+| `expo-harmony doctor --target-tier preview` | 在同一 runtime matrix 下评估项目是否至少落在 `preview` 能力层 |
 | `expo-harmony init` | 生成 Harmony sidecar、autolinking 产物、metadata 与 package scripts |
 | `expo-harmony sync-template` | 再次应用受管模板并检查 drift |
 | `expo-harmony env` | 检查 DevEco / hvigor / hdc / signing 本地环境 |
@@ -242,6 +247,7 @@ pnpm exec expo-harmony build-hap --mode release
 - 点击首页 motion rail 后能触发可见动画
 - 动画完成后路由跳转仍正常
 - `Build Debug Hap(s)` 成功
+- `official-native-capabilities-sample` 至少完成 preview route 的 bundle 与 permission 产物检查
 
 详见 [docs/npm-release.md](./docs/npm-release.md) 与 [docs/signing-and-release.md](./docs/signing-and-release.md)。
 
@@ -249,6 +255,7 @@ pnpm exec expo-harmony build-hap --mode release
 
 - [支持矩阵](./docs/support-matrix.md)
 - [CLI 构建指南](./docs/cli-build.md)
+- [官方 Native Capabilities sample 指南](./docs/official-native-capabilities-sample.md)
 - [官方 UI Stack sample 指南](./docs/official-ui-stack-sample.md)
 - [官方 App Shell sample 指南](./docs/official-app-shell-sample.md)
 - [官方最小 sample 指南](./docs/official-minimal-sample.md)

package/build/cli.js

@@ -25,7 +25,8 @@ async function run(argv = process.argv) {
         .command('doctor')
         .description('Inspect an Expo project and classify dependencies against the Harmony migration matrix')
         .option('-p, --project-root <path>', 'path to the Expo project')
-        .option('--strict', 'return a non-zero exit code when the project falls outside the validated v1.5 matrix')
+        .option('--strict', 'return a non-zero exit code when the project falls outside the validated verified matrix')
+        .option('--target-tier <tier>', 'evaluate the project against verified, preview, or experimental support tiers')
         .option('--json', 'print JSON instead of a human-readable report')
         .option('-o, --output <path>', 'write the JSON report to a file')
         .action(doctor_1.runDoctorCommand);

package/build/commands/doctor.d.ts

@@ -1,7 +1,9 @@
+import { DoctorTargetTier } from '../types';
 export interface DoctorCommandOptions {
     projectRoot?: string;
     strict?: boolean;
     json?: boolean;
     output?: string;
+    targetTier?: DoctorTargetTier | string;
 }
 export declare function runDoctorCommand(options: DoctorCommandOptions): Promise<void>;

package/build/commands/doctor.js

@@ -9,7 +9,8 @@ const constants_1 = require("../core/constants");
 const report_1 = require("../core/report");
 async function runDoctorCommand(options) {
     const projectRoot = path_1.default.resolve(options.projectRoot ?? process.cwd());
-    const report = await (0, report_1.buildDoctorReport)(projectRoot);
+    const targetTier = resolveDoctorTargetTier(options.targetTier, Boolean(options.strict));
+    const report = await (0, report_1.buildDoctorReport)(projectRoot, { targetTier });
     if (options.output) {
         await (0, report_1.writeDoctorReport)(projectRoot, report, path_1.default.resolve(options.output));
     }
@@ -22,3 +23,15 @@ async function runDoctorCommand(options) {
     }
     process.stdout.write((0, report_1.renderDoctorReport)(report) + '\n');
 }
+function resolveDoctorTargetTier(targetTier, strict) {
+    if (strict) {
+        return 'verified';
+    }
+    if (!targetTier) {
+        return 'verified';
+    }
+    if (targetTier === 'verified' || targetTier === 'preview' || targetTier === 'experimental') {
+        return targetTier;
+    }
+    throw new Error(`Unsupported doctor target tier: ${targetTier}`);
+}

package/build/core/constants.d.ts

@@ -1,6 +1,6 @@
 export declare const TOOLKIT_PACKAGE_NAME = "expo-harmony-toolkit";
 export declare const CLI_NAME = "expo-harmony";
-export declare const TOOLKIT_VERSION = "1.5.2";
+export declare const TOOLKIT_VERSION = "1.6.0";
 export declare const TEMPLATE_VERSION = "rnoh-0.82.18";
 export declare const RNOH_VERSION = "0.82.18";
 export declare const RNOH_CLI_VERSION = "0.82.18";

package/build/core/constants.js

@@ -3,7 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.DESIRED_PACKAGE_SCRIPTS = exports.HARMONY_RUNTIME_PRELUDE_RELATIVE_PATH = exports.HARMONY_ROUTER_ENTRY_FILENAME = exports.STRICT_ENV_EXIT_CODE = exports.STRICT_DOCTOR_EXIT_CODE = exports.DEFAULT_HVIGOR_PLUGIN_FILENAME = exports.PREBUILD_METADATA_FILENAME = exports.TOOLKIT_CONFIG_FILENAME = exports.BUILD_REPORT_FILENAME = exports.ENV_REPORT_FILENAME = exports.DOCTOR_REPORT_FILENAME = exports.MANIFEST_FILENAME = exports.GENERATED_SHIMS_DIR = exports.GENERATED_DIR = exports.SUPPORTED_EXPO_SDKS = exports.RNOH_CLI_VERSION = exports.RNOH_VERSION = exports.TEMPLATE_VERSION = exports.TOOLKIT_VERSION = exports.CLI_NAME = exports.TOOLKIT_PACKAGE_NAME = void 0;
 exports.TOOLKIT_PACKAGE_NAME = 'expo-harmony-toolkit';
 exports.CLI_NAME = 'expo-harmony';
-exports.TOOLKIT_VERSION = '1.5.2';
+exports.TOOLKIT_VERSION = '1.6.0';
 exports.TEMPLATE_VERSION = 'rnoh-0.82.18';
 exports.RNOH_VERSION = '0.82.18';
 exports.RNOH_CLI_VERSION = '0.82.18';

package/build/core/report.d.ts

@@ -1,4 +1,6 @@
-import { DoctorReport } from '../types';
-export declare function buildDoctorReport(projectRoot: string): Promise<DoctorReport>;
+import { DoctorTargetTier, DoctorReport } from '../types';
+export declare function buildDoctorReport(projectRoot: string, options?: {
+    targetTier?: DoctorTargetTier;
+}): Promise<DoctorReport>;
 export declare function writeDoctorReport(projectRoot: string, report: DoctorReport, outputPath?: string): Promise<string>;
 export declare function renderDoctorReport(report: DoctorReport): string;

package/build/core/report.js

@@ -12,18 +12,21 @@ const semver_1 = __importDefault(require("semver"));
 const constants_1 = require("./constants");
 const dependencyCatalog_1 = require("../data/dependencyCatalog");
 const validatedMatrices_1 = require("../data/validatedMatrices");
+const capabilities_1 = require("../data/capabilities");
 const uiStack_1 = require("../data/uiStack");
 const metadata_1 = require("./metadata");
 const project_1 = require("./project");
 const constants_2 = require("./constants");
 const DEFAULT_RECORD = {
     status: 'unknown',
+    supportTier: 'unsupported',
     note: 'This dependency is not in the current compatibility catalog yet.',
 };
-async function buildDoctorReport(projectRoot) {
+async function buildDoctorReport(projectRoot, options = {}) {
     const loadedProject = await (0, project_1.loadProject)(projectRoot);
     const expoSdkVersion = (0, project_1.detectExpoSdkVersion)(loadedProject.packageJson);
     const matrix = validatedMatrices_1.VALIDATED_RELEASE_MATRICES[validatedMatrices_1.DEFAULT_VALIDATED_MATRIX_ID];
+    const targetTier = options.targetTier ?? 'verified';
     const expoPlugins = (0, project_1.collectExpoPlugins)(loadedProject.expoConfig);
     const expoSchemes = (0, project_1.collectExpoSchemes)(loadedProject.expoConfig);
     const dependencyRecords = new Map();
@@ -37,7 +40,19 @@ async function buildDoctorReport(projectRoot) {
         }
     }
     const dependencies = [...dependencyRecords.values()].sort((left, right) => left.name.localeCompare(right.name));
-    const blockingIssues = await collectBlockingIssues(loadedProject.projectRoot, loadedProject.expoConfig, loadedProject.packageJson, expoPlugins, expoSchemes, expoSdkVersion, dependencies, matrix);
+    const blockingIssues = await collectBlockingIssues(loadedProject.projectRoot, loadedProject.expoConfig, loadedProject.packageJson, expoPlugins, expoSchemes, expoSdkVersion, dependencies, matrix, targetTier);
+    const capabilities = (0, capabilities_1.getCapabilityDefinitionsForProject)(loadedProject.packageJson).map((definition) => ({
+        id: definition.id,
+        packageName: definition.packageName,
+        status: definition.status,
+        supportTier: definition.supportTier,
+        note: definition.note,
+        docsUrl: definition.docsUrl,
+        nativePackageNames: [...definition.nativePackageNames],
+        harmonyPermissions: [...definition.harmonyPermissions],
+        sampleRoute: definition.sampleRoute,
+        acceptanceChecklist: [...definition.acceptanceChecklist],
+    }));
     const blockingDependencyNames = new Set(blockingIssues
         .filter((issue) => issue.code.startsWith('dependency.') && issue.subject)
         .map((issue) => issue.subject));
@@ -58,6 +73,7 @@ async function buildDoctorReport(projectRoot) {
         rnohVersion: constants_1.RNOH_VERSION,
         rnohCliVersion: constants_1.RNOH_CLI_VERSION,
         expoSdkVersion,
+        targetTier,
         expoConfig: {
             name: loadedProject.expoConfig.name ?? null,
             slug: loadedProject.expoConfig.slug ?? null,
@@ -74,6 +90,13 @@ async function buildDoctorReport(projectRoot) {
             manual: resolvedDependencies.filter((dependency) => dependency.status === 'manual').length,
             unknown: resolvedDependencies.filter((dependency) => dependency.status === 'unknown').length,
         },
+        supportSummary: {
+            verified: resolvedDependencies.filter((dependency) => dependency.supportTier === 'verified').length,
+            preview: resolvedDependencies.filter((dependency) => dependency.supportTier === 'preview').length,
+            experimental: resolvedDependencies.filter((dependency) => dependency.supportTier === 'experimental').length,
+            unsupported: resolvedDependencies.filter((dependency) => dependency.supportTier === 'unsupported').length,
+        },
+        capabilities,
         blockingIssues,
         advisories,
         warnings,
@@ -92,19 +115,29 @@ function renderDoctorReport(report) {
         `Config: ${report.appConfigPath ?? 'not found'}`,
         `Expo SDK: ${report.expoSdkVersion ?? 'unknown'} (recognized ${constants_1.SUPPORTED_EXPO_SDKS.join(', ')})`,
         `Matrix: ${report.matrixId ?? 'none'}`,
+        `Target tier: ${report.targetTier}`,
         `Eligibility: ${report.eligibility}`,
         `Schemes: ${report.expoConfig.schemes.join(', ') || 'none'}`,
         `Plugins: ${report.expoConfig.plugins.join(', ') || 'none'}`,
         `RNOH template: ${report.templateVersion} / runtime ${report.rnohVersion}`,
         `Summary: ${report.summary.supported} supported, ${report.summary.manual} manual, ${report.summary.unknown} unknown (${report.summary.total} total)`,
+        `Support tiers: ${report.supportSummary.verified} verified, ${report.supportSummary.preview} preview, ${report.supportSummary.experimental} experimental, ${report.supportSummary.unsupported} unsupported`,
         '',
         `Dependencies:`,
         ...report.dependencies.map((dependency) => {
             const replacement = dependency.replacement ? ` | replacement: ${dependency.replacement}` : '';
             const blocking = dependency.blocking ? ' | blocking: yes' : '';
-            return `- [${dependency.status}] ${dependency.name}@${dependency.version} (${dependency.source}) - ${dependency.note}${replacement}${blocking}`;
+            return `- [${dependency.status}/${dependency.supportTier}] ${dependency.name}@${dependency.version} (${dependency.source}) - ${dependency.note}${replacement}${blocking}`;
         }),
     ];
+    if (report.capabilities.length > 0) {
+        sections.push('', 'Capabilities:', ...report.capabilities.map((capability) => {
+            const permissions = capability.harmonyPermissions.length > 0
+                ? ` | permissions: ${capability.harmonyPermissions.join(', ')}`
+                : '';
+            return `- [${capability.status}/${capability.supportTier}] ${capability.packageName} -> ${capability.nativePackageNames.join(', ') || 'toolkit-managed bridge'} | sample: ${capability.sampleRoute}${permissions}`;
+        }));
+    }
     if (report.blockingIssues.length > 0) {
         sections.push('', 'Blocking issues:', ...report.blockingIssues.map((issue) => `- ${issue.code}: ${issue.message}${issue.subject ? ` (${issue.subject})` : ''}`));
     }
@@ -123,13 +156,14 @@ function createDependencyRecord(name, version, source) {
         version,
         source,
         status: matrixRecord.status,
+        supportTier: matrixRecord.supportTier,
         blocking: false,
         note: matrixRecord.note,
         replacement: matrixRecord.replacement,
         docsUrl: matrixRecord.docsUrl,
     };
 }
-async function collectBlockingIssues(projectRoot, expoConfig, packageJson, expoPlugins, expoSchemes, expoSdkVersion, dependencies, matrix) {
+async function collectBlockingIssues(projectRoot, expoConfig, packageJson, expoPlugins, expoSchemes, expoSdkVersion, dependencies, matrix, targetTier) {
     const issues = [];
     const dependencyMap = new Map(dependencies.map((dependency) => [dependency.name, dependency]));
     if (expoSdkVersion !== matrix.expoSdkVersion) {
@@ -167,10 +201,10 @@ async function collectBlockingIssues(projectRoot, expoConfig, packageJson, expoP
         }
     }
     for (const dependency of dependencies) {
-        if (!matrix.allowedDependencies.includes(dependency.name)) {
+        if (!isDependencyAllowedForTargetTier(dependency.name, matrix, targetTier)) {
             issues.push({
                 code: 'dependency.not_allowed',
-                message: `${dependency.name} is outside the validated ${matrix.id} allowlist.`,
+                message: `${dependency.name} is outside the ${targetTier} support tier for ${matrix.id}.`,
                 subject: dependency.name,
             });
         }
@@ -282,6 +316,12 @@ function buildWarnings(expoConfig, expoSdkVersion, dependencies) {
     if (dependencies.some((dependency) => dependency.status === 'manual')) {
         warnings.push('Manual-review dependencies were detected. They remain outside the current validated matrix even though the toolkit can still scaffold exploratory files.');
     }
+    if (dependencies.some((dependency) => dependency.supportTier === 'preview')) {
+        warnings.push('Preview-tier dependencies were detected. The toolkit can scaffold and bundle them, but runtime behavior is not part of the verified public promise yet.');
+    }
+    if (dependencies.some((dependency) => dependency.supportTier === 'experimental')) {
+        warnings.push('Experimental-tier dependencies were detected. Expect bridge drift, runtime gaps, or additional manual validation before claiming release readiness.');
+    }
     if (dependencies.some((dependency) => dependency.status === 'unknown')) {
         warnings.push('Unknown dependencies were detected. The toolkit can scaffold the project, but runtime portability is not guaranteed.');
     }
@@ -294,6 +334,16 @@ function buildAdvisories(expoConfig) {
     }
     return advisories;
 }
+function isDependencyAllowedForTargetTier(dependencyName, matrix, targetTier) {
+    if (matrix.allowedDependencies.includes(dependencyName)) {
+        return true;
+    }
+    const capability = capabilities_1.CAPABILITY_BY_PACKAGE[dependencyName];
+    if (!capability) {
+        return false;
+    }
+    return (0, capabilities_1.isSupportTierAllowed)(capability.supportTier, targetTier);
+}
 function matchesVersionRange(rawVersion, range) {
     const coerced = semver_1.default.coerce(rawVersion);
     if (!coerced) {