expo-harmony-toolkit 1.7.1 → 1.7.3

package/README.en.md

@@ -9,7 +9,7 @@
   <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.7.1-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.7.3-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>
@@ -45,9 +45,10 @@
 
 ## Current Status
 
+<!-- GENERATED:readme-current-status:start -->
 | Item | Status |
 | --- | --- |
-| Current version | `v1.7.1` |
+| Current version | `v1.7.3` |
 | Support model | `verified + preview + experimental` |
 | Public `verified` matrix | `expo55-rnoh082-ui-stack` |
 | Supported input | Managed/CNG Expo projects |
@@ -55,11 +56,12 @@
 | `preview` native capabilities | `expo-file-system`, `expo-image-picker`, `expo-location`, `expo-camera` |
 | `experimental` capabilities | `expo-notifications`, `react-native-gesture-handler` |
 | Release tracks | `latest` = fully accepted `verified` only; `next` = preview fast track |
-| Capability telemetry | `runtimeMode` + `evidence(bundle/debugBuild/device/release)` |
+| Capability telemetry | `runtimeMode` + `evidence(...)` + `evidenceSource(...)` |
 | Build path | `doctor -> init -> bundle -> build-hap` |
 | Primary sample | `examples/official-ui-stack-sample` |
 | Preview sample | `examples/official-native-capabilities-sample` |
 | Supporting onboarding samples | `examples/official-app-shell-sample`, `examples/official-minimal-sample` |
+<!-- GENERATED:readme-current-status:end -->
 
 <details>
 <summary><strong>Still outside the verified public promise</strong></summary>
@@ -170,19 +172,21 @@ Common decision points:
 
 ## Support Matrix
 
-`v1.7` keeps tiered support and now exposes capability promotion distance in public reports:
-
+<!-- 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`
 - `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.
 
-Starting in this refresh:
-
 - `doctor-report.json` exposes `capabilities[].runtimeMode`
 - `doctor-report.json` and `toolkit-config.json` expose `evidence.bundle`, `evidence.debugBuild`, `evidence.device`, and `evidence.release`
+- `doctor-report.json` and `toolkit-config.json` expose `evidenceSource.bundle`, `evidenceSource.debugBuild`, `evidenceSource.device`, and `evidenceSource.release`
 - `runtimeMode=shim` means the capability still has not reached a verified runtime path even if bundling and debug-build scaffolding already exist
+- `evidenceSource.device=manual-doc` means the current device signal comes from manual acceptance records, not automated verification
+<!-- GENERATED:readme-support-matrix:end -->
+
+Starting in this refresh, `doctor` also emits `buildabilityRisk` so matrix-out dependencies that still look JavaScript-only no longer get described the same way as packages with clear native risk. This does not relax any gate; it only improves diagnosis.
 
 See [docs/support-matrix.md](./docs/support-matrix.md) for the full allowlist, pairing rules, exact specifiers, issue codes, and release gates.
 
@@ -226,10 +230,10 @@ Key managed outputs include:
 - `harmony/entry/src/main/cpp/autolinking.cmake`
 - `metro.harmony.config.js`
 - `.expo-harmony/manifest.json`
+- `.expo-harmony/toolkit-config.json`
 - `.expo-harmony/doctor-report.json`
 - `.expo-harmony/env-report.json`
 - `.expo-harmony/build-report.json`
-- `.expo-harmony/toolkit-config.json`
 
 ## Release And Validation
 
@@ -249,6 +253,12 @@ Automatic publishing still defaults to hosted CI only, but now splits into two t
 - GitHub auto-publish selects `latest` or `next` based on the tag and keeps provenance enabled
 - `build-hap --mode debug` still does not block hosted npm publishing
 
+Additional preview evidence semantics:
+
+- `bundle/debugBuild` are marked as `automated`
+- `device` is marked as `manual-doc`, which means a human acceptance record exists rather than CI automation
+- `release` is marked as `none`, which means no release evidence exists yet
+
 Manual Harmony acceptance still requires:
 
 - `official-ui-stack-sample` launches successfully
@@ -276,9 +286,10 @@ See [docs/npm-release.md](./docs/npm-release.md) and [docs/signing-and-release.m
 - [Official Minimal Sample Guide](./docs/official-minimal-sample.md)
 - [npm Release Notes](./docs/npm-release.md)
 - [Signing and Release Notes](./docs/signing-and-release.md)
-- [v1.7.1 Acceptance Log](./docs/v1.7.1-acceptance.md)
 - [Roadmap](./docs/roadmap.md)
 
+Acceptance logs stay in the repo-only [`acceptance/`](./acceptance/) directory and are not shipped inside the npm tarball.
+
 ## License
 
 Released under the [MIT License](./LICENSE).

package/README.md

@@ -9,7 +9,7 @@
   <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.7.1-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.7.3-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>
@@ -45,9 +45,10 @@
 
 ## 当前状态
 
+<!-- GENERATED:readme-current-status:start -->
 | 项目 | 说明 |
 | --- | --- |
-| 当前版本 | `v1.7.1` |
+| 当前版本 | `v1.7.3` |
 | 支持模型 | `verified + preview + experimental` |
 | 唯一 `verified` 公开矩阵 | `expo55-rnoh082-ui-stack` |
 | 输入范围 | Managed/CNG Expo 项目 |
@@ -55,11 +56,12 @@
 | `preview` 原生能力 | `expo-file-system`、`expo-image-picker`、`expo-location`、`expo-camera` |
 | `experimental` 能力 | `expo-notifications`、`react-native-gesture-handler` |
 | 发布轨 | `latest` = fully accepted verified only；`next` = preview fast track |
-| capability 遥测 | `runtimeMode` + `evidence(bundle/debugBuild/device/release)` |
+| capability 遥测 | `runtimeMode` + `evidence(...)` + `evidenceSource(...)` |
 | 构建链 | `doctor -> init -> bundle -> build-hap` |
 | 主 sample | `examples/official-ui-stack-sample` |
 | preview sample | `examples/official-native-capabilities-sample` |
 | 辅助 onboarding samples | `examples/official-app-shell-sample`、`examples/official-minimal-sample` |
+<!-- GENERATED:readme-current-status:end -->
 
 <details>
 <summary><strong>当前仍不在 verified 正式承诺范围</strong></summary>
@@ -170,19 +172,21 @@ pnpm exec expo-harmony build-hap --mode release
 
 ## 支持矩阵
 
-`v1.7` 继续采用支持分层，并开始把 capability 晋升距离写进公开报告：
-
+<!-- GENERATED:readme-support-matrix:start -->
 - `verified`：唯一公开矩阵仍是 `expo55-rnoh082-ui-stack`
-- `preview`：`expo-file-system`、`expo-image-picker`、`expo-location`、`expo-camera`
-- `experimental`：`expo-notifications`、`react-native-gesture-handler`
+- `preview`：`expo-file-system`, `expo-image-picker`, `expo-location`, `expo-camera`
+- `experimental`：`expo-notifications`, `react-native-gesture-handler`
 
 `doctor --strict` 继续只代表 `verified`。`doctor --target-tier preview` 会在同一 runtime matrix 下额外放行 preview 能力，但这不等于它们已经进入正式承诺。
 
-从本版开始：
-
 - `doctor-report.json` 的 `capabilities[]` 会带出 `runtimeMode`
 - `doctor-report.json` 与 `toolkit-config.json` 会带出 `evidence.bundle`、`evidence.debugBuild`、`evidence.device`、`evidence.release`
+- `doctor-report.json` 与 `toolkit-config.json` 会带出 `evidenceSource.bundle`、`evidenceSource.debugBuild`、`evidenceSource.device`、`evidenceSource.release`
 - `runtimeMode=shim` 说明当前仍未进入 verified runtime path，即使 bundle / debug build 已经可走通
+- `evidenceSource.device=manual-doc` 表示当前只有人工设备验收记录，不代表机器自动验证
+<!-- GENERATED:readme-support-matrix:end -->
+
+从本版开始，`doctor` 还会额外输出 `buildabilityRisk`，把“超出公开矩阵但看起来更像纯 JS 层”的依赖，与“存在明确原生风险”的依赖区分开来；这不会放宽 gate，只是让构建可诊断性更强。
 
 文档里的状态标记额外约定为：
 
@@ -233,9 +237,9 @@ pnpm exec expo-harmony build-hap --mode release
 - `metro.harmony.config.js`
 - `.expo-harmony/manifest.json`
 - `.expo-harmony/doctor-report.json`
+- `.expo-harmony/toolkit-config.json`
 - `.expo-harmony/env-report.json`
 - `.expo-harmony/build-report.json`
-- `.expo-harmony/toolkit-config.json`
 
 ## 发布与验收
 
@@ -255,6 +259,12 @@ pnpm exec expo-harmony build-hap --mode release
 - GitHub 自动发布按 tag 选择 `latest` 或 `next` dist-tag，并保留 provenance
 - `build-hap --mode debug` 继续不作为 hosted npm publish 的硬阻塞条件
 
+preview 证据的额外说明：
+
+- `bundle/debugBuild` 标记为 `automated`
+- `device` 标记为 `manual-doc`，表示已有人工验收记录，不等于 CI 自动验收
+- `release` 标记为 `none`，表示当前仍没有 release 证据
+
 手动 Harmony 验收继续要求：
 
 - `official-ui-stack-sample` 成功启动
@@ -282,9 +292,10 @@ verified capability 晋升还必须补齐：
 - [官方最小 sample 指南](./docs/official-minimal-sample.md)
 - [npm 发布说明](./docs/npm-release.md)
 - [签名与 Release 说明](./docs/signing-and-release.md)
-- [v1.7.1 验收记录](./docs/v1.7.1-acceptance.md)
 - [路线图](./docs/roadmap.md)
 
+验收记录继续保留在 repo-only 的 [`acceptance/`](./acceptance/) 目录中，不随 npm tarball 一起发布。
+
 ## License
 
 本项目基于 [MIT License](./LICENSE) 发布。

package/build/core/autolinking.d.ts

@@ -0,0 +1,10 @@
+import { TemplateFileDefinition } from '../types';
+export declare const AUTOLINKED_FILE_PATHS: readonly [string, string, string, string];
+export declare class AutolinkingFailureError extends Error {
+    constructor(stage: string, command: string, options?: {
+        cause?: string;
+        missingFiles?: string[];
+    });
+}
+export declare function buildAutolinkedManagedFiles(projectRoot: string, harmonyRootPackageContents: string): Promise<TemplateFileDefinition[]>;
+export declare function normalizeKnownHarmonyPackageJsons(projectRoot: string): Promise<() => Promise<void>>;

package/build/core/autolinking.js

@@ -0,0 +1,421 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AutolinkingFailureError = exports.AUTOLINKED_FILE_PATHS = void 0;
+exports.buildAutolinkedManagedFiles = buildAutolinkedManagedFiles;
+exports.normalizeKnownHarmonyPackageJsons = normalizeKnownHarmonyPackageJsons;
+const fs_extra_1 = __importDefault(require("fs-extra"));
+const json5_1 = __importDefault(require("json5"));
+const os_1 = __importDefault(require("os"));
+const path_1 = __importDefault(require("path"));
+const uiStack_1 = require("../data/uiStack");
+exports.AUTOLINKED_FILE_PATHS = [
+    path_1.default.join('harmony', 'oh-package.json5'),
+    path_1.default.join('harmony', 'entry', 'src', 'main', 'ets', 'RNOHPackagesFactory.ets'),
+    path_1.default.join('harmony', 'entry', 'src', 'main', 'cpp', 'RNOHPackagesFactory.h'),
+    path_1.default.join('harmony', 'entry', 'src', 'main', 'cpp', 'autolinking.cmake'),
+];
+const HARMONY_PACKAGE_JSON_NORMALIZERS = {
+    '@react-native-oh-tpl/react-native-gesture-handler': (packageJson) => {
+        const harmony = packageJson.harmony && typeof packageJson.harmony === 'object' && !Array.isArray(packageJson.harmony)
+            ? { ...packageJson.harmony }
+            : null;
+        if (!harmony || !('codegenConfig' in harmony)) {
+            return null;
+        }
+        delete harmony.codegenConfig;
+        return {
+            ...packageJson,
+            harmony,
+        };
+    },
+};
+class AutolinkingFailureError extends Error {
+    constructor(stage, command, options = {}) {
+        const details = [
+            `Harmony autolinking failed during ${stage}.`,
+            `Command: ${command}`,
+        ];
+        if (options.missingFiles && options.missingFiles.length > 0) {
+            details.push(`Missing files: ${options.missingFiles.join(', ')}`);
+        }
+        if (options.cause) {
+            details.push(`Cause: ${options.cause}`);
+        }
+        super(details.join(' '));
+        this.name = 'AutolinkingFailureError';
+    }
+}
+exports.AutolinkingFailureError = AutolinkingFailureError;
+async function buildAutolinkedManagedFiles(projectRoot, harmonyRootPackageContents) {
+    const generated = await generateAutolinkingArtifacts(projectRoot, harmonyRootPackageContents);
+    return [
+        {
+            relativePath: exports.AUTOLINKED_FILE_PATHS[0],
+            contents: generated.ohPackageContents,
+        },
+        {
+            relativePath: exports.AUTOLINKED_FILE_PATHS[1],
+            contents: generated.etsFactoryContents,
+        },
+        {
+            relativePath: exports.AUTOLINKED_FILE_PATHS[2],
+            contents: generated.cppFactoryContents,
+        },
+        {
+            relativePath: exports.AUTOLINKED_FILE_PATHS[3],
+            contents: generated.cmakeContents,
+        },
+    ];
+}
+async function normalizeKnownHarmonyPackageJsons(projectRoot) {
+    const originalContentsByPath = new Map();
+    for (const [packageName, normalizePackageJson] of Object.entries(HARMONY_PACKAGE_JSON_NORMALIZERS)) {
+        const packageJsonPath = resolveProjectPackageJson(projectRoot, packageName);
+        if (!packageJsonPath || originalContentsByPath.has(packageJsonPath)) {
+            continue;
+        }
+        try {
+            const currentContents = await fs_extra_1.default.readFile(packageJsonPath, 'utf8');
+            const packageJson = JSON.parse(currentContents);
+            const normalizedPackageJson = normalizePackageJson(packageJson);
+            if (!normalizedPackageJson) {
+                continue;
+            }
+            originalContentsByPath.set(packageJsonPath, currentContents);
+            await fs_extra_1.default.writeFile(packageJsonPath, JSON.stringify(normalizedPackageJson, null, 2) + '\n');
+        }
+        catch {
+            // Ignore malformed adapter package metadata and let downstream tooling surface the failure.
+        }
+    }
+    return async () => {
+        for (const [packageJsonPath, originalContents] of originalContentsByPath) {
+            await fs_extra_1.default.writeFile(packageJsonPath, originalContents);
+        }
+    };
+}
+async function generateAutolinkingArtifacts(projectRoot, harmonyRootPackageContents) {
+    const rnohCliPackageJsonPath = resolveProjectPackageJson(projectRoot, '@react-native-oh/react-native-harmony-cli');
+    const managedOhPackageContents = await buildManagedHarmonyRootPackageContents(projectRoot, harmonyRootPackageContents);
+    const managedAutolinkingEntries = await resolveManagedAutolinkingEntries(projectRoot);
+    if (!rnohCliPackageJsonPath) {
+        return createEmptyAutolinkingArtifacts(managedOhPackageContents, managedAutolinkingEntries);
+    }
+    const restoreNormalizedHarmonyPackageJsons = await normalizeKnownHarmonyPackageJsons(projectRoot);
+    try {
+        const temporaryRoot = await fs_extra_1.default.mkdtemp(path_1.default.join(os_1.default.tmpdir(), 'expo-harmony-autolinking-'));
+        try {
+            const temporaryHarmonyRoot = path_1.default.join(temporaryRoot, 'harmony');
+            const commandDescription = buildRnohLinkHarmonyCommand(projectRoot, temporaryHarmonyRoot);
+            await fs_extra_1.default.ensureDir(path_1.default.join(temporaryHarmonyRoot, 'entry', 'src', 'main', 'ets'));
+            await fs_extra_1.default.ensureDir(path_1.default.join(temporaryHarmonyRoot, 'entry', 'src', 'main', 'cpp'));
+            await fs_extra_1.default.writeFile(path_1.default.join(temporaryHarmonyRoot, 'oh-package.json5'), harmonyRootPackageContents);
+            await runRnohLinkHarmonyCommand(projectRoot, rnohCliPackageJsonPath, temporaryHarmonyRoot, commandDescription);
+            await assertGeneratedAutolinkingFilesExist(temporaryHarmonyRoot, commandDescription);
+            let normalizedEtsFactoryContents;
+            let normalizedCppFactoryContents;
+            let normalizedCmakeContents;
+            try {
+                normalizedEtsFactoryContents = await normalizeAutolinkingEtsFactoryContents(projectRoot, await fs_extra_1.default.readFile(path_1.default.join(temporaryHarmonyRoot, 'entry', 'src', 'main', 'ets', 'RNOHPackagesFactory.ets'), 'utf8'));
+                normalizedCppFactoryContents = await normalizeAutolinkingCppFactoryContents(projectRoot, await fs_extra_1.default.readFile(path_1.default.join(temporaryHarmonyRoot, 'entry', 'src', 'main', 'cpp', 'RNOHPackagesFactory.h'), 'utf8'));
+                normalizedCmakeContents = await fs_extra_1.default.readFile(path_1.default.join(temporaryHarmonyRoot, 'entry', 'src', 'main', 'cpp', 'autolinking.cmake'), 'utf8');
+            }
+            catch (error) {
+                throw new AutolinkingFailureError('normalize-generated-files', commandDescription, {
+                    cause: getErrorMessage(error),
+                });
+            }
+            return {
+                ohPackageContents: managedOhPackageContents,
+                etsFactoryContents: injectManagedAutolinkingIntoEtsFactory(normalizedEtsFactoryContents, managedAutolinkingEntries),
+                cppFactoryContents: injectManagedAutolinkingIntoCppFactory(normalizedCppFactoryContents, managedAutolinkingEntries),
+                cmakeContents: injectManagedAutolinkingIntoCmake(normalizedCmakeContents, managedAutolinkingEntries),
+            };
+        }
+        finally {
+            await fs_extra_1.default.remove(temporaryRoot);
+        }
+    }
+    finally {
+        await restoreNormalizedHarmonyPackageJsons();
+    }
+}
+async function resolveManagedAutolinkingEntries(projectRoot) {
+    const entries = await Promise.all(uiStack_1.UI_STACK_VALIDATED_ADAPTERS.map(async (adapter) => {
+        if (adapter.supportsAutolinking || !adapter.managedAutolinking) {
+            return null;
+        }
+        const dependencySpecifier = await resolveHarmonyAdapterHarDependency(projectRoot, adapter.adapterPackageName);
+        if (!dependencySpecifier) {
+            return null;
+        }
+        return {
+            adapterPackageName: adapter.adapterPackageName,
+            ...adapter.managedAutolinking,
+        };
+    }));
+    return entries.filter((entry) => entry !== null);
+}
+async function normalizeAutolinkingEtsFactoryContents(projectRoot, contents) {
+    let normalizedContents = contents
+        .replace(/import type \{\s*RNPackageContext\s*,\s*RNOHPackage\s*\} from '@rnoh\/react-native-openharmony';/, "import type { RNPackageContext, RNPackage } from '@rnoh/react-native-openharmony';")
+        .replace(/export function createRNOHPackages\(([^)]*)\):\s*RNOHPackage\[\]/, 'export function createRNOHPackages($1): RNPackage[]');
+    const gestureHandlerPackageJsonPath = resolveProjectPackageJson(projectRoot, '@react-native-oh-tpl/react-native-gesture-handler');
+    if (!gestureHandlerPackageJsonPath) {
+        return normalizedContents;
+    }
+    try {
+        const gestureHandlerPackageJson = (await fs_extra_1.default.readJson(gestureHandlerPackageJsonPath));
+        if (gestureHandlerPackageJson.harmony?.codegenConfig) {
+            return normalizedContents;
+        }
+    }
+    catch {
+        return normalizedContents;
+    }
+    let gestureHandlerPackageImportName = null;
+    normalizedContents = normalizedContents.replace(/import\s+([A-Za-z_$][\w$]*)\s+from ['"]@react-native-oh-tpl\/react-native-gesture-handler['"];?/, (_match, importName) => {
+        gestureHandlerPackageImportName = importName;
+        return "import { GestureHandlerPackage } from '@react-native-oh-tpl/react-native-gesture-handler/ts';";
+    });
+    if (!gestureHandlerPackageImportName) {
+        return normalizedContents;
+    }
+    return normalizedContents.replace(new RegExp(`new\\s+${escapeRegExp(gestureHandlerPackageImportName)}\\(ctx\\)`, 'g'), 'new GestureHandlerPackage(ctx)');
+}
+function injectManagedAutolinkingIntoEtsFactory(contents, entries) {
+    if (entries.length === 0) {
+        return contents;
+    }
+    const missingImports = entries
+        .filter((entry) => !contents.includes(`from '${entry.etsImportPath}'`))
+        .map((entry) => `import { ${entry.etsPackageName} } from '${entry.etsImportPath}';`);
+    if (missingImports.length > 0) {
+        contents = contents.replace("import type { RNPackageContext, RNPackage } from '@rnoh/react-native-openharmony';", `import type { RNPackageContext, RNPackage } from '@rnoh/react-native-openharmony';\n${missingImports.join('\n')}`);
+    }
+    const missingFactoryEntries = entries
+        .filter((entry) => !contents.includes(`new ${entry.etsPackageName}(ctx)`))
+        .map((entry) => `    new ${entry.etsPackageName}(ctx),`);
+    if (missingFactoryEntries.length > 0) {
+        contents = contents.replace(/return \[\n/, `return [\n${missingFactoryEntries.join('\n')}\n`);
+    }
+    return contents;
+}
+async function normalizeAutolinkingCppFactoryContents(projectRoot, contents) {
+    const gestureHandlerPackageJsonPath = resolveProjectPackageJson(projectRoot, '@react-native-oh-tpl/react-native-gesture-handler');
+    if (!gestureHandlerPackageJsonPath) {
+        return contents;
+    }
+    try {
+        const gestureHandlerPackageJson = (await fs_extra_1.default.readJson(gestureHandlerPackageJsonPath));
+        if (gestureHandlerPackageJson.harmony?.codegenConfig) {
+            return contents;
+        }
+    }
+    catch {
+        return contents;
+    }
+    return contents
+        .replace(/#include "ReactNativeOhTplReactNativeGestureHandlerPackage\.h"/, '#include "RnohReactNativeHarmonyGestureHandlerPackage.h"')
+        .replace(/\brnoh::ReactNativeOhTplReactNativeGestureHandlerPackage\b/g, 'rnoh::RnohReactNativeHarmonyGestureHandlerPackage');
+}
+function injectManagedAutolinkingIntoCppFactory(contents, entries) {
+    if (entries.length === 0) {
+        return contents;
+    }
+    const missingIncludes = entries
+        .filter((entry) => !contents.includes(`#include "${entry.cppHeaderName}"`))
+        .map((entry) => `#include "${entry.cppHeaderName}"`);
+    if (missingIncludes.length > 0) {
+        contents = contents.replace('#include "RNOH/Package.h"', `#include "RNOH/Package.h"\n${missingIncludes.join('\n')}`);
+    }
+    const missingFactoryEntries = entries
+        .filter((entry) => !contents.includes(`std::make_shared<rnoh::${entry.cppPackageName}>(ctx)`))
+        .map((entry) => `    std::make_shared<rnoh::${entry.cppPackageName}>(ctx),`);
+    if (missingFactoryEntries.length > 0) {
+        contents = contents.replace(/return \{\n/, `return {\n${missingFactoryEntries.join('\n')}\n`);
+    }
+    return contents;
+}
+function injectManagedAutolinkingIntoCmake(contents, entries) {
+    if (entries.length === 0) {
+        return contents;
+    }
+    const missingSubdirectories = entries
+        .filter((entry) => !contents.includes(`./${entry.cmakeTargetName}`))
+        .map((entry) => `    add_subdirectory("\${OH_MODULES_DIR}/${entry.adapterPackageName}/src/main/cpp" ./${entry.cmakeTargetName})`);
+    if (missingSubdirectories.length > 0) {
+        contents = contents.replace(/function\(autolink_libraries target\)\n/, `function(autolink_libraries target)\n${missingSubdirectories.join('\n')}\n`);
+    }
+    const missingLibraryTargets = entries
+        .filter((entry) => !contents.includes(`        ${entry.cmakeTargetName}`))
+        .map((entry) => `        ${entry.cmakeTargetName}`);
+    if (missingLibraryTargets.length > 0) {
+        contents = contents.replace(/set\(AUTOLINKED_LIBRARIES\n/, `set(AUTOLINKED_LIBRARIES\n${missingLibraryTargets.join('\n')}\n`);
+    }
+    return contents;
+}
+async function runRnohLinkHarmonyCommand(projectRoot, rnohCliPackageJsonPath, harmonyProjectPath, commandDescription) {
+    const rnohCliRoot = path_1.default.dirname(rnohCliPackageJsonPath);
+    let commandLinkHarmony;
+    try {
+        ({ commandLinkHarmony } = require(path_1.default.join(rnohCliRoot, 'dist', 'commands', 'link-harmony.js')));
+    }
+    catch (error) {
+        throw new AutolinkingFailureError('load-link-harmony', commandDescription, {
+            cause: getErrorMessage(error),
+        });
+    }
+    try {
+        await commandLinkHarmony.func([], {}, {
+            harmonyProjectPath,
+            nodeModulesPath: path_1.default.join(projectRoot, 'node_modules'),
+            cmakeAutolinkPathRelativeToHarmony: './entry/src/main/cpp/autolinking.cmake',
+            cppRnohPackagesFactoryPathRelativeToHarmony: './entry/src/main/cpp/RNOHPackagesFactory.h',
+            etsRnohPackagesFactoryPathRelativeToHarmony: './entry/src/main/ets/RNOHPackagesFactory.ets',
+            ohPackagePathRelativeToHarmony: './oh-package.json5',
+            includeNpmPackages: uiStack_1.UI_STACK_ADAPTER_PACKAGE_NAMES,
+        });
+    }
+    catch (error) {
+        throw new AutolinkingFailureError('link-harmony', commandDescription, {
+            cause: getErrorMessage(error),
+        });
+    }
+}
+function buildRnohLinkHarmonyCommand(projectRoot, harmonyProjectPath) {
+    return [
+        'link-harmony',
+        `--harmonyProjectPath ${harmonyProjectPath}`,
+        `--nodeModulesPath ${path_1.default.join(projectRoot, 'node_modules')}`,
+        '--cmakeAutolinkPathRelativeToHarmony ./entry/src/main/cpp/autolinking.cmake',
+        '--cppRnohPackagesFactoryPathRelativeToHarmony ./entry/src/main/cpp/RNOHPackagesFactory.h',
+        '--etsRnohPackagesFactoryPathRelativeToHarmony ./entry/src/main/ets/RNOHPackagesFactory.ets',
+        '--ohPackagePathRelativeToHarmony ./oh-package.json5',
+    ].join(' ');
+}
+async function assertGeneratedAutolinkingFilesExist(harmonyProjectPath, commandDescription) {
+    const requiredFiles = [
+        path_1.default.join(harmonyProjectPath, 'entry', 'src', 'main', 'ets', 'RNOHPackagesFactory.ets'),
+        path_1.default.join(harmonyProjectPath, 'entry', 'src', 'main', 'cpp', 'RNOHPackagesFactory.h'),
+        path_1.default.join(harmonyProjectPath, 'entry', 'src', 'main', 'cpp', 'autolinking.cmake'),
+    ];
+    const missingFiles = requiredFiles.filter((filePath) => !fs_extra_1.default.existsSync(filePath));
+    if (missingFiles.length > 0) {
+        throw new AutolinkingFailureError('validate-generated-files', commandDescription, {
+            missingFiles: missingFiles.map((filePath) => path_1.default.relative(harmonyProjectPath, filePath)),
+        });
+    }
+}
+async function buildManagedHarmonyRootPackageContents(projectRoot, harmonyRootPackageContents) {
+    const parsedPackageJson = json5_1.default.parse(harmonyRootPackageContents);
+    const dependencies = {
+        ...(parsedPackageJson.dependencies ?? {}),
+        ...(await readPreservedHarmonyRootDependencies(projectRoot)),
+    };
+    for (const adapter of uiStack_1.UI_STACK_VALIDATED_ADAPTERS) {
+        const dependencySpecifier = await resolveHarmonyAdapterHarDependency(projectRoot, adapter.adapterPackageName);
+        if (dependencySpecifier) {
+            dependencies[adapter.adapterPackageName] = dependencySpecifier;
+        }
+    }
+    parsedPackageJson.dependencies = sortRecordByKey(dependencies);
+    return json5_1.default.stringify(parsedPackageJson, null, 2) + '\n';
+}
+async function readPreservedHarmonyRootDependencies(projectRoot) {
+    const harmonyRootPackagePath = path_1.default.join(projectRoot, 'harmony', 'oh-package.json5');
+    if (!(await fs_extra_1.default.pathExists(harmonyRootPackagePath))) {
+        return {};
+    }
+    const currentHarmonyRootPackage = json5_1.default.parse(await fs_extra_1.default.readFile(harmonyRootPackagePath, 'utf8'));
+    const preservedDependencies = {};
+    const validatedAdapterPackageNames = new Set(uiStack_1.UI_STACK_ADAPTER_PACKAGE_NAMES);
+    for (const [packageName, specifier] of Object.entries(currentHarmonyRootPackage.dependencies ?? {})) {
+        if (typeof specifier !== 'string') {
+            continue;
+        }
+        if (validatedAdapterPackageNames.has(packageName)) {
+            continue;
+        }
+        preservedDependencies[packageName] = specifier;
+    }
+    return preservedDependencies;
+}
+async function resolveHarmonyAdapterHarDependency(projectRoot, adapterPackageName) {
+    const adapterEntry = uiStack_1.UI_STACK_VALIDATED_ADAPTERS.find((candidate) => candidate.adapterPackageName === adapterPackageName);
+    if (!adapterEntry) {
+        return null;
+    }
+    const adapterRoot = path_1.default.join(projectRoot, 'node_modules', ...adapterPackageName.split('/'));
+    const harPath = path_1.default.join(adapterRoot, 'harmony', adapterEntry.harmonyHarFileName);
+    if (!(await fs_extra_1.default.pathExists(harPath))) {
+        return null;
+    }
+    const relativeHarPath = path_1.default.relative(path_1.default.join(projectRoot, 'harmony'), harPath).replace(/\\/g, '/');
+    return `file:${relativeHarPath}`;
+}
+function createEmptyAutolinkingArtifacts(harmonyRootPackageContents, managedAutolinkingEntries) {
+    return {
+        ohPackageContents: harmonyRootPackageContents,
+        etsFactoryContents: injectManagedAutolinkingIntoEtsFactory(`/*
+ * This file was generated by Expo Harmony Toolkit autolinking.
+ * DO NOT modify it manually, your changes WILL be overwritten.
+ */
+import type { RNPackageContext, RNPackage } from '@rnoh/react-native-openharmony';
+
+export function createRNOHPackages(_ctx: RNPackageContext): RNPackage[] {
+  return [];
+}
+`, managedAutolinkingEntries),
+        cppFactoryContents: injectManagedAutolinkingIntoCppFactory(`/*
+ * This file was generated by Expo Harmony Toolkit autolinking.
+ * DO NOT modify it manually, your changes WILL be overwritten.
+ */
+#pragma once
+#include "RNOH/Package.h"
+
+std::vector<rnoh::Package::Shared> createRNOHPackages(const rnoh::Package::Context &_ctx) {
+  return {};
+}
+`, managedAutolinkingEntries),
+        cmakeContents: injectManagedAutolinkingIntoCmake(`# This file was generated by Expo Harmony Toolkit autolinking.
+# DO NOT modify it manually, your changes WILL be overwritten.
+cmake_minimum_required(VERSION 3.5)
+
+function(autolink_libraries target)
+  set(AUTOLINKED_LIBRARIES
+  )
+
+  foreach(lib \${AUTOLINKED_LIBRARIES})
+    target_link_libraries(\${target} PUBLIC \${lib})
+  endforeach()
+endfunction()
+`, managedAutolinkingEntries),
+    };
+}
+function resolveProjectPackageJson(projectRoot, request) {
+    const directPackageJsonPath = path_1.default.join(projectRoot, 'node_modules', ...request.split('/'), 'package.json');
+    if (fs_extra_1.default.existsSync(directPackageJsonPath)) {
+        return directPackageJsonPath;
+    }
+    try {
+        return require.resolve(path_1.default.join(request, 'package.json'), {
+            paths: [projectRoot],
+        });
+    }
+    catch {
+        return null;
+    }
+}
+function sortRecordByKey(record) {
+    return Object.fromEntries(Object.entries(record).sort(([left], [right]) => left.localeCompare(right)));
+}
+function escapeRegExp(value) {
+    return value.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+}
+function getErrorMessage(error) {
+    return error instanceof Error ? error.message : String(error);
+}

package/build/core/build/commands.d.ts

@@ -0,0 +1,19 @@
+import { buildEnvReport } from '../env';
+export interface CommandRunnerResult {
+    exitCode: number;
+    stdout: string;
+    stderr: string;
+}
+export type CommandRunner = (file: string, args: string[], options: {
+    cwd: string;
+    env: NodeJS.ProcessEnv;
+}) => Promise<CommandRunnerResult>;
+export declare function buildInvocation(file: string, args: string[]): {
+    file: string;
+    args: string[];
+};
+export declare function createHarmonyBuildEnvironment(runtimeEnv: NodeJS.ProcessEnv, envReport: Awaited<ReturnType<typeof buildEnvReport>>): NodeJS.ProcessEnv;
+export declare function defaultCommandRunner(file: string, args: string[], options: {
+    cwd: string;
+    env: NodeJS.ProcessEnv;
+}): Promise<CommandRunnerResult>;