expo-harmony-toolkit 1.8.3 → 1.9.1

package/README.en.md

@@ -1,6 +1,6 @@
 <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><strong>A HarmonyOS migration, admission, and UI-stack build toolkit for Managed/CNG Expo projects, now with a bare intake baseline.</strong></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> ·
@@ -9,9 +9,9 @@
   <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.8.3-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.9.1-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">
+    <img alt="Input" src="https://img.shields.io/badge/input-Managed%2FCNG%20%2B%20bare%20intake-059669?style=flat-square">
   </p>
   <p>
     <a href="./docs/support-matrix.md">Support Matrix</a> ·
@@ -24,7 +24,7 @@
 </div>
 
 > [!IMPORTANT]
-> `v1.8` keeps the `verified + preview + experimental` model and continues to keep `expo-location` and `expo-camera` in `preview`. The public promise remains tighter: `latest` only carries fully accepted `verified` capabilities, while `next` is reserved for preview fast-track work. The roadmap now defines `v2.0.0` itself as “reliable Harmony packaging for any Expo project”, so the intermediate versions will keep getting split smaller, but that still does not widen the current `verified` boundary yet.
+> `v1.9.1` keeps the `v1.9.0` bare workflow intake, app foundation modules, and `react-native-gesture-handler` formal slice, and adds a local HAR normalize opt-out for `build-hap`. The public promise remains tighter: `latest` only carries fully accepted `verified` capabilities, while `next` is reserved for preview fast-track work. The expanded goal still does not widen the current `verified` boundary yet.
 
 > [!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.
@@ -48,12 +48,12 @@
 <!-- GENERATED:readme-current-status:start -->
 | Item | Status |
 | --- | --- |
-| Current version | `v1.8.3` |
+| Current version | `v1.9.1` |
 | Support model | `verified + preview + experimental` |
 | Public `verified` matrix | `expo55-rnoh082-ui-stack` |
-| Supported input | Managed/CNG Expo projects |
+| Supported input | Managed/CNG Expo projects; bare workflow intake baseline |
 | `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`, `expo-location`, `expo-camera` |
+| `preview` native capabilities | `expo-file-system`, `expo-image-picker`, `expo-location`, `expo-camera`, `expo-secure-store`, `expo-asset`, `expo-device`, `expo-clipboard`, `expo-haptics` |
 | `experimental` capabilities | `expo-notifications`, `react-native-gesture-handler` |
 | Release tracks | `latest` = fully accepted `verified` only; `next` = preview fast track |
 | Capability telemetry | `runtimeMode` + `evidence(...)` + `evidenceSource(...)` + `coverageProfile` + `nextActions` |
@@ -66,10 +66,11 @@
 <details>
 <summary><strong>Still outside the verified public promise</strong></summary>
 
-- bare Expo
+- bare Expo still only reaches the intake baseline
 - `expo-file-system`, `expo-image-picker`, `expo-location`, and `expo-camera` remain `preview`
+- `expo-secure-store`, `expo-asset`, `expo-device`, `expo-clipboard`, and `expo-haptics` remain the `preview` shim baseline
 - `expo-notifications`
-- `react-native-gesture-handler`
+- `react-native-gesture-handler` remains a formal experimental slice
 - multiple public matrices
 
 </details>
@@ -174,7 +175,7 @@ Common decision points:
 
 <!-- GENERATED:readme-support-matrix:start -->
 - `verified`: the only public matrix remains `expo55-rnoh082-ui-stack`
-- `preview`: `expo-file-system`, `expo-image-picker`, `expo-location`, `expo-camera`
+- `preview`: `expo-file-system`, `expo-image-picker`, `expo-location`, `expo-camera`, `expo-secure-store`, `expo-asset`, `expo-device`, `expo-clipboard`, `expo-haptics`
 - `experimental`: `expo-notifications`, `react-native-gesture-handler`
 
 `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.
@@ -198,7 +199,7 @@ If you want the `v1.8.x` promotion board directly, use [acceptance/v1.8.x-capabi
 - `examples/official-ui-stack-sample`
   The current public main sample, covering router, linking, constants, SVG, reanimated, and the Harmony sidecar build flow.
 - `examples/official-native-capabilities-sample`
-  The `v1.8.x` preview walkthrough sample, covering the supported core subsets for `expo-file-system`, `expo-image-picker`, `expo-location`, and `expo-camera` plus permission, bundle, debug-build validation, and per-capability acceptance tracking.
+  Preview walkthrough sample for `expo-file-system`, `expo-image-picker`, `expo-location`, `expo-camera`, and the v1.9 app foundation modules, keeping core subsets, permissions, bundle/debug evidence, and per-capability acceptance tracking explicit.
 - `examples/official-app-shell-sample`
   The minimal App Shell onboarding sample that demonstrates router, linking, constants, pathname, observed URL, and a generated deep-link flow.
 - `examples/official-minimal-sample`

package/README.md

@@ -1,6 +1,6 @@
 <div align="center">
   <h1>Expo Harmony Toolkit</h1>
-  <p><strong>面向 Managed/CNG Expo 项目的 HarmonyOS 迁移、准入检查与 UI-stack 构建工具链。</strong></p>
+  <p><strong>面向 Managed/CNG Expo 项目，并开始纳入 bare intake baseline 的 HarmonyOS 迁移、准入检查与 UI-stack 构建工具链。</strong></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> ·
@@ -9,9 +9,9 @@
   <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.8.3-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.9.1-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">
+    <img alt="Input" src="https://img.shields.io/badge/input-Managed%2FCNG%20%2B%20bare%20intake-059669?style=flat-square">
   </p>
   <p>
     <a href="./docs/support-matrix.md">支持矩阵</a> ·
@@ -24,7 +24,7 @@
 </div>
 
 > [!IMPORTANT]
-> `v1.8` 延续 `verified + preview + experimental` 三层支持模型，并把 `expo-location`、`expo-camera` 继续保持在 `preview`。当前公开承诺仍然收紧为：`latest` 只承诺完整验收的 `verified` 能力，`next` 用于 preview fast track。最新 roadmap 已把 `v2.0.0` 直接定义成“任何 Expo 项目都能可靠打包成鸿蒙 App”，因此中间版本会继续拆小，但这不等于当前 `verified` 边界已经放宽。
+> `v1.9.1` 延续 `v1.9.0` 的 bare workflow intake、app foundation modules 与 `react-native-gesture-handler` formal slice，并为 `build-hap` 增加本地 HAR normalize opt-out。当前公开承诺仍然收紧为：`latest` 只承诺完整验收的 `verified` 能力，`next` 用于 preview fast track。目标扩大不等于当前 `verified` 边界已经放宽。
 
 > [!TIP]
 > 由于当前公开矩阵内的两套 `@react-native-oh-tpl/*` adapter 依赖以 Git URL + exact commit 形式接入，仓库开发和官方 UI-stack sample 推荐使用 `pnpm install --ignore-scripts`，避免 Git adapter 在 prepare 阶段拉取私有资源而中断安装。
@@ -48,12 +48,12 @@
 <!-- GENERATED:readme-current-status:start -->
 | 项目 | 说明 |
 | --- | --- |
-| 当前版本 | `v1.8.3` |
+| 当前版本 | `v1.9.1` |
 | 支持模型 | `verified + preview + experimental` |
 | 唯一 `verified` 公开矩阵 | `expo55-rnoh082-ui-stack` |
-| 输入范围 | Managed/CNG Expo 项目 |
+| 输入范围 | Managed/CNG Expo 项目；bare workflow intake baseline |
 | `verified` JS/UI 能力 | `expo-router`、`expo-linking`、`expo-constants`、`react-native-reanimated`、`react-native-svg` |
-| `preview` 原生能力 | `expo-file-system`、`expo-image-picker`、`expo-location`、`expo-camera` |
+| `preview` 原生能力 | `expo-file-system`、`expo-image-picker`、`expo-location`、`expo-camera`、`expo-secure-store`、`expo-asset`、`expo-device`、`expo-clipboard`、`expo-haptics` |
 | `experimental` 能力 | `expo-notifications`、`react-native-gesture-handler` |
 | 发布轨 | `latest` = fully accepted verified only；`next` = preview fast track |
 | capability 遥测 | `runtimeMode` + `evidence(...)` + `evidenceSource(...)` + `coverageProfile` + `nextActions` |
@@ -66,10 +66,11 @@
 <details>
 <summary><strong>当前仍不在 verified 正式承诺范围</strong></summary>
 
-- bare Expo
+- bare Expo 仍只到 intake baseline
 - `expo-file-system`、`expo-image-picker`、`expo-location`、`expo-camera` 仍只属于 `preview`
+- `expo-secure-store`、`expo-asset`、`expo-device`、`expo-clipboard`、`expo-haptics` 仍只属于 `preview` shim baseline
 - `expo-notifications`
-- `react-native-gesture-handler`
+- `react-native-gesture-handler` 仍只属于 formal experimental slice
 - 多矩阵并行支持
 
 </details>
@@ -174,7 +175,7 @@ pnpm exec expo-harmony build-hap --mode release
 
 <!-- GENERATED:readme-support-matrix:start -->
 - `verified`：唯一公开矩阵仍是 `expo55-rnoh082-ui-stack`
-- `preview`：`expo-file-system`, `expo-image-picker`, `expo-location`, `expo-camera`
+- `preview`：`expo-file-system`, `expo-image-picker`, `expo-location`, `expo-camera`, `expo-secure-store`, `expo-asset`, `expo-device`, `expo-clipboard`, `expo-haptics`
 - `experimental`：`expo-notifications`, `react-native-gesture-handler`
 
 `doctor --strict` 继续只代表 `verified`。`doctor --target-tier preview` 会在同一 runtime matrix 下额外放行 preview 能力，但这不等于它们已经进入正式承诺。
@@ -204,7 +205,7 @@ 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.8.x` 的 preview walkthrough sample，用来承接 `expo-file-system`、`expo-image-picker`、`expo-location`、`expo-camera` 的核心支持子集、permission、bundle、debug build 与逐 capability 验收追踪。
+  preview walkthrough sample，用来承接 `expo-file-system`、`expo-image-picker`、`expo-location`、`expo-camera` 与 v1.9 app foundation modules 的核心支持子集、permission、bundle、debug build 与逐 capability 验收追踪。
 - `examples/official-app-shell-sample`
   最小可理解的 App Shell onboarding sample，用来展示 router、linking、constants、pathname、observed URL 与 generated deep link。
 - `examples/official-minimal-sample`

package/build/cli.js

@@ -40,6 +40,7 @@ async function run(argv = process.argv) {
         .description('Build a Harmony HAP from the validated sidecar and bundle outputs')
         .option('-p, --project-root <path>', 'path to the Expo project')
         .option('--mode <mode>', 'build mode: debug or release', 'debug')
+        .option('--no-har-normalize', 'let ohpm consume file:*.har dependencies without extracting local HARs')
         .action(buildHap_1.runBuildHapCommand);
     program
         .command('init')

package/build/commands/buildHap.d.ts

@@ -1,5 +1,6 @@
 export interface BuildHapCommandOptions {
     projectRoot?: string;
     mode?: 'debug' | 'release';
+    harNormalize?: boolean;
 }
 export declare function runBuildHapCommand(options: BuildHapCommandOptions): Promise<void>;

package/build/commands/buildHap.js

@@ -17,6 +17,7 @@ async function runBuildHapCommand(options) {
     }
     const report = await (0, build_1.buildHapProject)(projectRoot, {
         mode,
+        skipHarNormalize: options.harNormalize === false,
     });
     await (0, metadata_1.writeBuildReport)(projectRoot, report);
     if (report.status === 'failed') {

package/build/core/build.d.ts

@@ -2,6 +2,7 @@ import type { BuildReport } from '../types';
 import type { CommandRunner } from './build/commands';
 export type { CommandRunner, CommandRunnerResult } from './build/commands';
 export { renderBuildReport } from './build/reporting';
+export declare const SKIP_HAR_NORMALIZE_WARNING = "Local HAR normalization is disabled; ohpm will consume file:*.har dependencies directly and normalized build-profile/RNOH compatibility steps will be skipped.";
 interface BundleProjectOptions {
     env?: NodeJS.ProcessEnv;
     runner?: CommandRunner;
@@ -11,6 +12,7 @@ interface BuildHapProjectOptions {
     mode: 'debug' | 'release';
     env?: NodeJS.ProcessEnv;
     runner?: CommandRunner;
+    skipHarNormalize?: boolean;
 }
 export declare function bundleProject(projectRoot: string, options?: BundleProjectOptions): Promise<BuildReport>;
 export declare function buildHapProject(projectRoot: string, options: BuildHapProjectOptions): Promise<BuildReport>;

package/build/core/build.js

@@ -3,7 +3,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.renderBuildReport = void 0;
+exports.SKIP_HAR_NORMALIZE_WARNING = exports.renderBuildReport = void 0;
 exports.bundleProject = bundleProject;
 exports.buildHapProject = buildHapProject;
 exports.getDesiredHarmonyScripts = getDesiredHarmonyScripts;
@@ -20,6 +20,7 @@ const reporting_1 = require("./build/reporting");
 const rnohCompatibility_1 = require("./build/rnohCompatibility");
 var reporting_2 = require("./build/reporting");
 Object.defineProperty(exports, "renderBuildReport", { enumerable: true, get: function () { return reporting_2.renderBuildReport; } });
+exports.SKIP_HAR_NORMALIZE_WARNING = 'Local HAR normalization is disabled; ohpm will consume file:*.har dependencies directly and normalized build-profile/RNOH compatibility steps will be skipped.';
 async function bundleProject(projectRoot, options = {}) {
     const runtimeEnv = options.env ?? process.env;
     const runCommand = options.runner ?? commands_1.defaultCommandRunner;
@@ -193,6 +194,7 @@ async function bundleProject(projectRoot, options = {}) {
 async function buildHapProject(projectRoot, options) {
     const runtimeEnv = options.env ?? process.env;
     const runCommand = options.runner ?? commands_1.defaultCommandRunner;
+    const skipHarNormalize = options.skipHarNormalize === true || runtimeEnv.EXPO_HARMONY_SKIP_HAR_NORMALIZE === '1';
     const loadedProject = await (0, project_1.loadProject)(projectRoot);
     const envReport = await (0, env_1.buildEnvReport)(loadedProject.projectRoot, {
         env: runtimeEnv,
@@ -202,6 +204,9 @@ async function buildHapProject(projectRoot, options) {
         ...envReport.warnings.filter((warning) => !warning.startsWith('Harmony sidecar files are not present yet.')),
         ...relevantEnvAdvisories.map((issue) => `${issue.code}: ${issue.message}`),
     ];
+    if (skipHarNormalize) {
+        warnings.push(exports.SKIP_HAR_NORMALIZE_WARNING);
+    }
     const blockingIssues = [];
     if (!envReport.hvigorPath) {
         blockingIssues.push({
@@ -286,39 +291,41 @@ async function buildHapProject(projectRoot, options) {
     let restoreNormalizedRnohCliAutolinkingTemplates = async () => { };
     let restoreNormalizedRnohCodegenAlignment = async () => { };
     let restoreNormalizedHarmonyPackageJsons = async () => { };
-    try {
-        const normalizedLocalHarDependencies = await (0, localHar_1.normalizeLocalHarDependencies)(harmonyProjectRoot);
-        normalizedLocalHarPackages = normalizedLocalHarDependencies.packages;
-        restoreNormalizedDependencies = normalizedLocalHarDependencies.restore;
-        restoreNormalizedLocalHarModules = await (0, localHar_1.ensureHarmonyBuildProfileSupportsNormalizedLocalDeps)(harmonyProjectRoot, normalizedLocalHarDependencies.packages);
-        restoreNormalizedRnohCliAutolinkingTemplates =
-            await (0, rnohCompatibility_1.normalizeProjectRnohCliAutolinkingTemplates)(loadedProject.projectRoot);
-        restoreNormalizedHarmonyPackageJsons =
-            await (0, autolinking_1.normalizeKnownHarmonyPackageJsons)(loadedProject.projectRoot);
-    }
-    catch (error) {
-        const message = error instanceof Error ? error.message : String(error);
-        return (0, reporting_1.createBuildReport)({
-            projectRoot: loadedProject.projectRoot,
-            command: 'build-hap',
-            mode: options.mode,
-            status: 'failed',
-            harmonyProjectRoot,
-            entryFile: bundleReport.entryFile,
-            bundleOutputPath: bundleReport.bundleOutputPath,
-            assetsDestPath: bundleReport.assetsDestPath,
-            artifactPaths: [],
-            blockingIssues: [
-                {
-                    code: 'build.hap.failed',
-                    message,
-                },
-            ],
-            warnings: [...warnings, ...bundleReport.warnings],
-            steps,
-        });
+    if (!skipHarNormalize) {
+        try {
+            const normalizedLocalHarDependencies = await (0, localHar_1.normalizeLocalHarDependencies)(harmonyProjectRoot);
+            normalizedLocalHarPackages = normalizedLocalHarDependencies.packages;
+            restoreNormalizedDependencies = normalizedLocalHarDependencies.restore;
+            restoreNormalizedLocalHarModules = await (0, localHar_1.ensureHarmonyBuildProfileSupportsNormalizedLocalDeps)(harmonyProjectRoot, normalizedLocalHarDependencies.packages);
+            restoreNormalizedRnohCliAutolinkingTemplates =
+                await (0, rnohCompatibility_1.normalizeProjectRnohCliAutolinkingTemplates)(loadedProject.projectRoot);
+            restoreNormalizedHarmonyPackageJsons =
+                await (0, autolinking_1.normalizeKnownHarmonyPackageJsons)(loadedProject.projectRoot);
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            return (0, reporting_1.createBuildReport)({
+                projectRoot: loadedProject.projectRoot,
+                command: 'build-hap',
+                mode: options.mode,
+                status: 'failed',
+                harmonyProjectRoot,
+                entryFile: bundleReport.entryFile,
+                bundleOutputPath: bundleReport.bundleOutputPath,
+                assetsDestPath: bundleReport.assetsDestPath,
+                artifactPaths: [],
+                blockingIssues: [
+                    {
+                        code: 'build.hap.failed',
+                        message,
+                    },
+                ],
+                warnings: [...warnings, ...bundleReport.warnings],
+                steps,
+            });
+        }
+        restoreNormalizedRnohCodegenAlignment = await (0, localHar_1.alignRnohCodegenWithNormalizedLocalPackage)(harmonyProjectRoot, normalizedLocalHarPackages);
     }
-    restoreNormalizedRnohCodegenAlignment = await (0, localHar_1.alignRnohCodegenWithNormalizedLocalPackage)(harmonyProjectRoot, normalizedLocalHarPackages);
     const ohpmCommand = (0, commands_1.buildInvocation)(envReport.ohpmPath, ['install', '--all']);
     try {
         const ohpmResult = await runCommand(ohpmCommand.file, ohpmCommand.args, {
@@ -349,10 +356,12 @@ async function buildHapProject(projectRoot, options) {
                 steps,
             });
         }
-        if (!normalizedLocalHarPackages.some((localPackage) => localPackage.packageName === '@rnoh/react-native-openharmony')) {
-            await (0, localHar_1.ensureRnohGeneratedTsShim)(harmonyProjectRoot);
+        if (!skipHarNormalize) {
+            if (!normalizedLocalHarPackages.some((localPackage) => localPackage.packageName === '@rnoh/react-native-openharmony')) {
+                await (0, localHar_1.ensureRnohGeneratedTsShim)(harmonyProjectRoot);
+            }
+            await (0, localHar_1.patchRnohGeneratedCodegenForNormalizedLocalPackage)(harmonyProjectRoot);
         }
-        await (0, localHar_1.patchRnohGeneratedCodegenForNormalizedLocalPackage)(harmonyProjectRoot);
         await (0, localHar_1.patchKnownHarmonyAdapterCodegenOutputs)(harmonyProjectRoot);
         const hvigorCommand = (0, commands_1.buildInvocation)(envReport.hvigorPath, [
             'assembleHap',

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.8.3";
+export declare const TOOLKIT_VERSION = "1.9.1";
 export declare const TEMPLATE_VERSION = "rnoh-0.82.29";
 export declare const RNOH_VERSION = "0.82.29";
 export declare const RNOH_CLI_VERSION = "0.82.29";

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.SIGNING_LOCAL_EXAMPLE_FILENAME = exports.SIGNING_LOCAL_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.8.3';
+exports.TOOLKIT_VERSION = '1.9.1';
 exports.TEMPLATE_VERSION = 'rnoh-0.82.29';
 exports.RNOH_VERSION = '0.82.29';
 exports.RNOH_CLI_VERSION = '0.82.29';

package/build/core/report.js

@@ -25,6 +25,12 @@ const DEFAULT_RECORD = {
 };
 const BARE_WORKFLOW_DIRECTORY_NAMES = ['android', 'ios'];
 const BARE_WORKFLOW_DEPENDENCIES = new Set(['expo-build-properties', 'expo-dev-client']);
+const FORMAL_EXPERIMENTAL_ADAPTER_PAIRS = [
+    {
+        canonicalPackageName: 'react-native-gesture-handler',
+        adapterPackageName: '@react-native-oh-tpl/react-native-gesture-handler',
+    },
+];
 async function buildDoctorReport(projectRoot, options = {}) {
     const loadedProject = await (0, project_1.loadProject)(projectRoot);
     const doctorConfig = (0, project_1.resolveExpoHarmonyDoctorConfig)(loadedProject.expoConfig);
@@ -329,6 +335,24 @@ async function collectBlockingIssues(projectRoot, expoConfig, packageJson, expoP
             });
         }
     }
+    for (const pairing of FORMAL_EXPERIMENTAL_ADAPTER_PAIRS) {
+        const hasCanonical = dependencyMap.has(pairing.canonicalPackageName);
+        const hasAdapter = dependencyMap.has(pairing.adapterPackageName);
+        if (hasCanonical && !hasAdapter) {
+            issues.push({
+                code: 'dependency.required_missing',
+                message: `Using ${pairing.canonicalPackageName} in its formal experimental Harmony slice also requires ${pairing.adapterPackageName}.`,
+                subject: pairing.adapterPackageName,
+            });
+        }
+        if (hasAdapter && !hasCanonical) {
+            issues.push({
+                code: 'dependency.required_missing',
+                message: `Using ${pairing.adapterPackageName} in its formal experimental Harmony slice also requires ${pairing.canonicalPackageName}.`,
+                subject: pairing.canonicalPackageName,
+            });
+        }
+    }
     if (!expoConfig.android?.package && !expoConfig.ios?.bundleIdentifier) {
         issues.push({
             code: 'config.native_identifier.missing',
@@ -392,14 +416,14 @@ function resolveDependencyGapCategory(dependency, coverageProfile) {
             dependency.name === 'react-native')) {
         return 'bare-workflow-gap';
     }
+    if (isThirdPartyNativeGapDependency(dependency)) {
+        return 'third-party-native-gap';
+    }
     if (isOfficialExpoDependencyName(dependency.name) || capabilities_1.CAPABILITY_BY_PACKAGE[dependency.name]) {
         return dependency.supportTier === 'verified' && dependency.status === 'supported'
             ? 'matrix-drift'
             : 'official-module-gap';
     }
-    if (isThirdPartyNativeGapDependency(dependency)) {
-        return 'third-party-native-gap';
-    }
     if (coverageProfile === 'bare') {
         return 'bare-workflow-gap';
     }
@@ -462,7 +486,7 @@ function buildNextActions(input) {
     if (blockingIssues.some((issue) => issue.code === 'dependency.not_allowed' &&
         (issue.subject === 'react-native-gesture-handler' ||
             issue.subject === '@react-native-oh-tpl/react-native-gesture-handler'))) {
-        actions.push('Keep `react-native-gesture-handler` out of the verified lane until its Harmony adapter path has stable doctor, sample, and build coverage.');
+        actions.push('Keep `react-native-gesture-handler` on the formal experimental slice until its Harmony adapter path closes device and release evidence.');
     }
     if (hasBlockingIssueCode(blockingIssues, 'config.native_identifier.missing')) {
         actions.push('Set `android.package` or `ios.bundleIdentifier` in Expo config before expecting a strict Harmony build path.');

package/build/core/template/capabilityRegistry.js

@@ -3,6 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.MANAGED_EXPO_HARMONY_MODULE_RENDERERS = void 0;
 exports.renderCapabilityModuleShim = renderCapabilityModuleShim;
 exports.renderUnsupportedCapabilityShim = renderUnsupportedCapabilityShim;
+const appFoundation_1 = require("./renderers/appFoundation");
 const camera_1 = require("./renderers/camera");
 const fileSystem_1 = require("./renderers/fileSystem");
 const imagePicker_1 = require("./renderers/imagePicker");
@@ -24,6 +25,26 @@ const CAPABILITY_SHIM_RENDERERS = {
         adapter: camera_1.renderExpoCameraHarmonyAdapterShim,
         preview: camera_1.renderExpoCameraPreviewShim,
     },
+    'expo-secure-store': {
+        adapter: appFoundation_1.renderExpoSecureStorePreviewShim,
+        preview: appFoundation_1.renderExpoSecureStorePreviewShim,
+    },
+    'expo-asset': {
+        adapter: appFoundation_1.renderExpoAssetPreviewShim,
+        preview: appFoundation_1.renderExpoAssetPreviewShim,
+    },
+    'expo-device': {
+        adapter: appFoundation_1.renderExpoDevicePreviewShim,
+        preview: appFoundation_1.renderExpoDevicePreviewShim,
+    },
+    'expo-clipboard': {
+        adapter: appFoundation_1.renderExpoClipboardPreviewShim,
+        preview: appFoundation_1.renderExpoClipboardPreviewShim,
+    },
+    'expo-haptics': {
+        adapter: appFoundation_1.renderExpoHapticsPreviewShim,
+        preview: appFoundation_1.renderExpoHapticsPreviewShim,
+    },
 };
 exports.MANAGED_EXPO_HARMONY_MODULE_RENDERERS = [
     {

package/build/core/template/renderers/appFoundation.d.ts

@@ -0,0 +1,5 @@
+export declare function renderExpoSecureStorePreviewShim(): string;
+export declare function renderExpoAssetPreviewShim(): string;
+export declare function renderExpoDevicePreviewShim(): string;
+export declare function renderExpoClipboardPreviewShim(): string;
+export declare function renderExpoHapticsPreviewShim(): string;