expo-harmony-toolkit 1.8.0 → 1.8.1

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.8.0-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.8.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">
   </p>
@@ -48,7 +48,7 @@
 <!-- GENERATED:readme-current-status:start -->
 | Item | Status |
 | --- | --- |
-| Current version | `v1.8.0` |
+| Current version | `v1.8.1` |
 | Support model | `verified + preview + experimental` |
 | Public `verified` matrix | `expo55-rnoh082-ui-stack` |
 | Supported input | Managed/CNG Expo projects |

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.8.0-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.8.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">
   </p>
@@ -48,7 +48,7 @@
 <!-- GENERATED:readme-current-status:start -->
 | 项目 | 说明 |
 | --- | --- |
-| 当前版本 | `v1.8.0` |
+| 当前版本 | `v1.8.1` |
 | 支持模型 | `verified + preview + experimental` |
 | 唯一 `verified` 公开矩阵 | `expo55-rnoh082-ui-stack` |
 | 输入范围 | Managed/CNG Expo 项目 |

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.0";
+export declare const TOOLKIT_VERSION = "1.8.1";
 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.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.0';
+exports.TOOLKIT_VERSION = '1.8.1';
 exports.TEMPLATE_VERSION = 'rnoh-0.82.18';
 exports.RNOH_VERSION = '0.82.18';
 exports.RNOH_CLI_VERSION = '0.82.18';

package/build/core/project.d.ts

@@ -1,4 +1,4 @@
-import { DependencySource, ExpoHarmonyPluginProps, HarmonyIdentifiers, LoadedProject, PackageJson } from '../types';
+import { DependencySource, ExpoHarmonyResolvedDoctorConfig, ExpoHarmonyPluginProps, HarmonyIdentifiers, LoadedProject, PackageJson } from '../types';
 export declare function resolveProjectRoot(projectRoot?: string): Promise<string>;
 export declare function loadProject(projectRoot: string): Promise<LoadedProject>;
 export declare function ensureProjectPackageJsonPath(projectRoot: string): Promise<string>;
@@ -10,6 +10,8 @@ export declare function collectDeclaredDependencies(packageJson: PackageJson): A
 }>;
 export declare function hasDeclaredDependency(packageJson: PackageJson, dependencyName: string): boolean;
 export declare function collectExpoPlugins(expoConfig: Record<string, any>): string[];
+export declare function resolveExpoHarmonyDoctorConfig(expoConfig: Record<string, any>): ExpoHarmonyResolvedDoctorConfig;
+export declare function applyDependencyExclusions(packageJson: PackageJson, excludedDependencies: readonly string[]): PackageJson;
 export declare function collectExpoSchemes(expoConfig: Record<string, any>): string[];
 export declare function deriveHarmonyIdentifiers(expoConfig: Record<string, any>, packageJson?: PackageJson, props?: ExpoHarmonyPluginProps): HarmonyIdentifiers;
 export declare function detectExpoSdkVersion(packageJson: PackageJson): number | null;

package/build/core/project.js

@@ -10,6 +10,8 @@ exports.findAppConfigPath = findAppConfigPath;
 exports.collectDeclaredDependencies = collectDeclaredDependencies;
 exports.hasDeclaredDependency = hasDeclaredDependency;
 exports.collectExpoPlugins = collectExpoPlugins;
+exports.resolveExpoHarmonyDoctorConfig = resolveExpoHarmonyDoctorConfig;
+exports.applyDependencyExclusions = applyDependencyExclusions;
 exports.collectExpoSchemes = collectExpoSchemes;
 exports.deriveHarmonyIdentifiers = deriveHarmonyIdentifiers;
 exports.detectExpoSdkVersion = detectExpoSdkVersion;
@@ -100,6 +102,27 @@ function collectExpoPlugins(expoConfig) {
     }
     return [...names].sort((left, right) => left.localeCompare(right));
 }
+function resolveExpoHarmonyDoctorConfig(expoConfig) {
+    const rawDoctorConfig = expoConfig.extra?.expoHarmony?.doctor;
+    const coverageProfile = normalizeCoverageProfile(rawDoctorConfig?.coverageProfile);
+    return {
+        excludeDependencies: normalizeStringArray(rawDoctorConfig?.excludeDependencies),
+        excludePlugins: normalizeStringArray(rawDoctorConfig?.excludePlugins),
+        coverageProfile,
+    };
+}
+function applyDependencyExclusions(packageJson, excludedDependencies) {
+    if (excludedDependencies.length === 0) {
+        return packageJson;
+    }
+    const excludedDependencySet = new Set(excludedDependencies);
+    return {
+        ...packageJson,
+        dependencies: filterDependencySection(packageJson.dependencies, excludedDependencySet),
+        devDependencies: filterDependencySection(packageJson.devDependencies, excludedDependencySet),
+        peerDependencies: filterDependencySection(packageJson.peerDependencies, excludedDependencySet),
+    };
+}
 function collectExpoSchemes(expoConfig) {
     const rawScheme = expoConfig.scheme;
     if (typeof rawScheme === 'string' && rawScheme.trim().length > 0) {
@@ -204,3 +227,27 @@ function sanitizeIdentifierSegment(value) {
         .replace(/^_+/, '');
     return cleaned.length > 0 ? cleaned : 'entry';
 }
+function normalizeStringArray(value) {
+    if (!Array.isArray(value)) {
+        return [];
+    }
+    return [...new Set(value
+            .filter((entry) => typeof entry === 'string')
+            .map((entry) => entry.trim())
+            .filter((entry) => entry.length > 0))].sort((left, right) => left.localeCompare(right));
+}
+function normalizeCoverageProfile(value) {
+    if (value === 'managed-core' ||
+        value === 'managed-native-heavy' ||
+        value === 'bare' ||
+        value === 'third-party-native-heavy') {
+        return value;
+    }
+    return null;
+}
+function filterDependencySection(section, excludedDependencies) {
+    if (!section) {
+        return section;
+    }
+    return Object.fromEntries(Object.entries(section).filter(([dependencyName]) => !excludedDependencies.has(dependencyName)));
+}

package/build/core/report.js

@@ -27,13 +27,16 @@ const BARE_WORKFLOW_DIRECTORY_NAMES = ['android', 'ios'];
 const BARE_WORKFLOW_DEPENDENCIES = new Set(['expo-build-properties', 'expo-dev-client']);
 async function buildDoctorReport(projectRoot, options = {}) {
     const loadedProject = await (0, project_1.loadProject)(projectRoot);
+    const doctorConfig = (0, project_1.resolveExpoHarmonyDoctorConfig)(loadedProject.expoConfig);
+    const filteredPackageJson = (0, project_1.applyDependencyExclusions)(loadedProject.packageJson, doctorConfig.excludeDependencies);
     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 excludedPlugins = new Set(doctorConfig.excludePlugins);
+    const expoPlugins = (0, project_1.collectExpoPlugins)(loadedProject.expoConfig).filter((pluginName) => !excludedPlugins.has(pluginName));
     const expoSchemes = (0, project_1.collectExpoSchemes)(loadedProject.expoConfig);
     const dependencyRecords = new Map();
-    const declaredDependencies = (0, project_1.collectDeclaredDependencies)(loadedProject.packageJson);
+    const declaredDependencies = (0, project_1.collectDeclaredDependencies)(filteredPackageJson);
     for (const dependency of declaredDependencies) {
         dependencyRecords.set(dependency.name, createDependencyRecord(dependency.name, dependency.version, dependency.source));
     }
@@ -43,8 +46,11 @@ async function buildDoctorReport(projectRoot, options = {}) {
         }
     }
     const dependencies = await (0, dependencyInspection_1.annotateDependencyBuildability)(loadedProject.projectRoot, [...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, targetTier);
-    const capabilities = (0, capabilities_1.getCapabilityDefinitionsForProject)(loadedProject.packageJson).map((definition) => ({
+    const blockingIssues = await collectBlockingIssues(loadedProject.projectRoot, loadedProject.expoConfig, filteredPackageJson, expoPlugins, expoSchemes, expoSdkVersion, dependencies, matrix, targetTier);
+    const excludedDependencies = new Set(doctorConfig.excludeDependencies);
+    const capabilities = (0, capabilities_1.getCapabilityDefinitionsForProject)(filteredPackageJson, {
+        excludedDependencies,
+    }).map((definition) => ({
         id: definition.id,
         packageName: definition.packageName,
         status: definition.status,
@@ -59,7 +65,7 @@ async function buildDoctorReport(projectRoot, options = {}) {
         sampleRoute: definition.sampleRoute,
         acceptanceChecklist: [...definition.acceptanceChecklist],
     }));
-    const coverageProfile = await detectCoverageProfile(loadedProject.projectRoot, loadedProject.packageJson, dependencies);
+    const coverageProfile = await detectCoverageProfile(loadedProject.projectRoot, filteredPackageJson, dependencies, doctorConfig.coverageProfile);
     const blockingDependencyNames = new Set(blockingIssues
         .filter((issue) => issue.code.startsWith('dependency.') && issue.subject)
         .map((issue) => issue.subject));
@@ -76,7 +82,7 @@ async function buildDoctorReport(projectRoot, options = {}) {
         capabilities,
     });
     const warnings = buildWarnings(loadedProject.expoConfig, expoSdkVersion, resolvedDependencies);
-    const advisories = buildAdvisories(loadedProject.expoConfig);
+    const advisories = buildAdvisories(loadedProject.expoConfig, doctorConfig);
     return {
         generatedAt: new Date().toISOString(),
         projectRoot: loadedProject.projectRoot,
@@ -353,7 +359,10 @@ async function collectBlockingIssues(projectRoot, expoConfig, packageJson, expoP
     }
     return dedupeIssues(issues);
 }
-async function detectCoverageProfile(projectRoot, packageJson, dependencies) {
+async function detectCoverageProfile(projectRoot, packageJson, dependencies, coverageProfileOverride) {
+    if (coverageProfileOverride) {
+        return coverageProfileOverride;
+    }
     for (const directoryName of BARE_WORKFLOW_DIRECTORY_NAMES) {
         if (await fs_extra_1.default.pathExists(path_1.default.join(projectRoot, directoryName))) {
             return 'bare';
@@ -490,8 +499,17 @@ function buildWarnings(expoConfig, expoSdkVersion, dependencies) {
     }
     return warnings;
 }
-function buildAdvisories(expoConfig) {
+function buildAdvisories(expoConfig, doctorConfig) {
     const advisories = [];
+    if (doctorConfig.excludeDependencies.length > 0) {
+        advisories.push(`Expo Harmony doctor excluded dependencies: ${doctorConfig.excludeDependencies.join(', ')}.`);
+    }
+    if (doctorConfig.excludePlugins.length > 0) {
+        advisories.push(`Expo Harmony doctor excluded plugins: ${doctorConfig.excludePlugins.join(', ')}.`);
+    }
+    if (doctorConfig.coverageProfile) {
+        advisories.push(`Expo Harmony doctor forced coverage profile to ${doctorConfig.coverageProfile}.`);
+    }
     if (!expoConfig.android?.package && expoConfig.ios?.bundleIdentifier) {
         advisories.push('The project is using ios.bundleIdentifier as the only explicit native identifier. Prefer setting android.package as well before claiming release readiness.');
     }
@@ -501,11 +519,12 @@ function isDependencyAllowedForTargetTier(dependencyName, matrix, targetTier) {
     if (matrix.allowedDependencies.includes(dependencyName)) {
         return true;
     }
-    const capability = capabilities_1.CAPABILITY_BY_PACKAGE[dependencyName];
-    if (!capability) {
-        return false;
+    const catalogRecord = dependencyCatalog_1.DEPENDENCY_CATALOG[dependencyName];
+    if (catalogRecord) {
+        return (0, capabilities_1.isSupportTierAllowed)(catalogRecord.supportTier, targetTier);
     }
-    return (0, capabilities_1.isSupportTierAllowed)(capability.supportTier, targetTier);
+    const capability = capabilities_1.CAPABILITY_BY_PACKAGE[dependencyName];
+    return capability ? (0, capabilities_1.isSupportTierAllowed)(capability.supportTier, targetTier) : false;
 }
 function matchesVersionRange(rawVersion, range) {
     const coerced = semver_1.default.coerce(rawVersion);

package/build/core/template.js

@@ -135,9 +135,12 @@ async function syncProjectTemplate(projectRoot, force = false, options = {}) {
 }
 async function buildManagedFiles(loadedProject, identifiers, previousToolkitConfig, doctorReport) {
     const hasExpoRouter = (0, support_1.usesExpoRouter)(loadedProject.packageJson);
+    const doctorConfig = (0, project_1.resolveExpoHarmonyDoctorConfig)(loadedProject.expoConfig);
     const enabledCapabilities = doctorReport.capabilities;
     const hasManagedExpoHarmonyPackage = enabledCapabilities.some((capability) => capability.runtimeMode !== 'shim');
-    const requestedHarmonyPermissions = (0, capabilities_1.collectCapabilityHarmonyPermissions)(loadedProject.packageJson);
+    const requestedHarmonyPermissions = (0, capabilities_1.collectCapabilityHarmonyPermissions)(loadedProject.packageJson, {
+        excludedDependencies: new Set(doctorConfig.excludeDependencies),
+    });
     const signingLocalConfig = await (0, signing_1.readSigningLocalConfig)(loadedProject.projectRoot);
     const hvigorPluginFilename = await (0, project_1.resolveRnohHvigorPluginFilename)(loadedProject.projectRoot);
     const renderedHarmonyRootPackage = renderTemplate(await fs_extra_1.default.readFile(path_1.default.join(TEMPLATE_ROOT, 'oh-package.json5'), 'utf8'), loadedProject, identifiers, hvigorPluginFilename);
@@ -179,6 +182,7 @@ async function buildManagedFiles(loadedProject, identifiers, previousToolkitConf
         bundleName: identifiers.bundleName,
         entryModuleName: identifiers.entryModuleName,
         coverageProfile: doctorReport.coverageProfile,
+        doctorConfig,
         capabilities: enabledCapabilities.map((capability) => ({
             id: capability.id,
             packageName: capability.packageName,

package/build/data/capabilities.d.ts

@@ -3,5 +3,9 @@ export declare const CAPABILITY_DEFINITIONS: readonly CapabilityDefinition[];
 export declare const CAPABILITY_BY_PACKAGE: Record<string, CapabilityDefinition>;
 export declare function compareSupportTiers(left: SupportTier, right: SupportTier): number;
 export declare function isSupportTierAllowed(dependencyTier: SupportTier, targetTier: DoctorTargetTier): boolean;
-export declare function getCapabilityDefinitionsForProject(packageJson: PackageJson): CapabilityDefinition[];
-export declare function collectCapabilityHarmonyPermissions(packageJson: PackageJson): string[];
+export declare function getCapabilityDefinitionsForProject(packageJson: PackageJson, options?: {
+    excludedDependencies?: ReadonlySet<string>;
+}): CapabilityDefinition[];
+export declare function collectCapabilityHarmonyPermissions(packageJson: PackageJson, options?: {
+    excludedDependencies?: ReadonlySet<string>;
+}): string[];

package/build/data/capabilities.js

@@ -149,9 +149,11 @@ function compareSupportTiers(left, right) {
 function isSupportTierAllowed(dependencyTier, targetTier) {
     return compareSupportTiers(dependencyTier, targetTier) <= 0;
 }
-function getCapabilityDefinitionsForProject(packageJson) {
-    return exports.CAPABILITY_DEFINITIONS.filter((definition) => (0, project_1.hasDeclaredDependency)(packageJson, definition.packageName)).sort((left, right) => left.packageName.localeCompare(right.packageName));
+function getCapabilityDefinitionsForProject(packageJson, options = {}) {
+    const excludedDependencies = options.excludedDependencies ?? new Set();
+    return exports.CAPABILITY_DEFINITIONS.filter((definition) => !excludedDependencies.has(definition.packageName) &&
+        (0, project_1.hasDeclaredDependency)(packageJson, definition.packageName)).sort((left, right) => left.packageName.localeCompare(right.packageName));
 }
-function collectCapabilityHarmonyPermissions(packageJson) {
-    return Array.from(new Set(getCapabilityDefinitionsForProject(packageJson).flatMap((definition) => definition.harmonyPermissions))).sort((left, right) => left.localeCompare(right));
+function collectCapabilityHarmonyPermissions(packageJson, options = {}) {
+    return Array.from(new Set(getCapabilityDefinitionsForProject(packageJson, options).flatMap((definition) => definition.harmonyPermissions))).sort((left, right) => left.localeCompare(right));
 }

package/build/data/dependencyCatalog.js

@@ -112,6 +112,30 @@ exports.DEPENDENCY_CATALOG = {
         supportTier: 'verified',
         note: 'File-based routing is treated as part of the validated App Shell matrix when router peers, scheme, and plugin config are present.',
     },
+    '@react-native-async-storage/async-storage': {
+        status: 'manual',
+        supportTier: 'experimental',
+        note: 'Async storage is a high-frequency startup dependency. Treat it as an experimental Harmony intake dependency until the managed adapter path has stable doctor, sample, and build coverage.',
+        docsUrl: 'https://github.com/react-native-oh-library',
+    },
+    'react-native-safe-area-context': {
+        status: 'supported',
+        supportTier: 'experimental',
+        note: 'Safe-area handling is shimmed by the toolkit for Harmony so App Shell layouts can keep rendering while the native path remains outside the verified matrix.',
+        docsUrl: 'https://github.com/react-native-oh-library',
+    },
+    'react-native-screens': {
+        status: 'manual',
+        supportTier: 'experimental',
+        note: 'Navigation stacks frequently depend on react-native-screens. Keep it on the experimental lane until the Harmony adapter path has repeatable sample and device coverage.',
+        docsUrl: 'https://github.com/react-native-oh-library',
+    },
+    'react-native-webview': {
+        status: 'manual',
+        supportTier: 'experimental',
+        note: 'WebView is a common app-shell blocker. Treat it as an experimental intake dependency until the Harmony runtime path is validated on device.',
+        docsUrl: 'https://github.com/react-native-oh-library',
+    },
     ...UI_STACK_COMPATIBILITY_RECORDS,
     'react-native-gesture-handler': {
         status: 'manual',

package/build/data/publicDocs.d.ts

@@ -8,4 +8,4 @@ export declare const SUPPORTING_SAMPLE_PATHS: readonly ["examples/official-app-s
 export declare const VERIFIED_JS_UI_CAPABILITY_NAMES: readonly ["expo-router", "expo-linking", "expo-constants", ...("react-native-reanimated" | "react-native-svg")[]];
 export declare const PREVIEW_CAPABILITY_DEFINITIONS: import("..").CapabilityDefinition[];
 export declare const EXPERIMENTAL_CAPABILITY_NAMES: readonly [...string[], "react-native-gesture-handler"];
-export declare const PUBLIC_CURRENT_VERSION = "1.8.0";
+export declare const PUBLIC_CURRENT_VERSION = "1.8.1";

package/build/plugin.js

@@ -16,9 +16,13 @@ const project_2 = require("./core/project");
 const withExpoHarmony = (config, props = {}) => {
     validatePluginProps(props);
     const identifiers = (0, project_1.deriveHarmonyIdentifiers)(config, undefined, props);
+    const existingExpoHarmonyConfig = config.extra && typeof config.extra.expoHarmony === 'object' && config.extra.expoHarmony
+        ? config.extra.expoHarmony
+        : {};
     config.extra = {
         ...(config.extra ?? {}),
         expoHarmony: {
+            ...existingExpoHarmonyConfig,
             bundleName: identifiers.bundleName,
             entryModuleName: identifiers.entryModuleName,
             templateVersion: props.templateVersion ?? constants_1.TEMPLATE_VERSION,

package/build/types.d.ts

@@ -8,6 +8,16 @@ export type DependencyBuildabilityRisk = 'known' | 'js-only-unknown' | 'native-r
 export type CoverageProfile = 'managed-core' | 'managed-native-heavy' | 'bare' | 'third-party-native-heavy';
 export type GapCategory = 'matrix-drift' | 'official-module-gap' | 'third-party-native-gap' | 'bare-workflow-gap';
 export type DependencySource = 'dependency' | 'devDependency' | 'peerDependency' | 'expo-plugin';
+export interface ExpoHarmonyDoctorConfig {
+    excludeDependencies?: string[];
+    excludePlugins?: string[];
+    coverageProfile?: CoverageProfile;
+}
+export interface ExpoHarmonyResolvedDoctorConfig {
+    excludeDependencies: string[];
+    excludePlugins: string[];
+    coverageProfile: CoverageProfile | null;
+}
 export interface ExpoHarmonyPluginProps {
     bundleName?: string;
     entryModuleName?: string;
@@ -236,6 +246,7 @@ export interface ToolkitConfig {
     bundleName: string;
     entryModuleName: string;
     coverageProfile: CoverageProfile;
+    doctorConfig: ExpoHarmonyResolvedDoctorConfig;
     capabilities: ManagedCapabilityRecord[];
     requestedHarmonyPermissions: string[];
     nextActions: string[];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "expo-harmony-toolkit",
-  "version": "1.8.0",
+  "version": "1.8.1",
   "description": "面向 Managed/CNG Expo 项目的 HarmonyOS 迁移、准入检查与 UI-stack 构建工具链",
   "main": "app.plugin.js",
   "types": "build/index.d.ts",