expo-harmony-toolkit 1.7.1 → 1.7.3

package/build/data/capabilities.js

@@ -12,12 +12,24 @@ const PREVIEW_BASELINE_EVIDENCE = {
     device: true,
     release: false,
 };
+const PREVIEW_BASELINE_EVIDENCE_SOURCE = {
+    bundle: 'automated',
+    debugBuild: 'automated',
+    device: 'manual-doc',
+    release: 'none',
+};
 const EXPLORATORY_EVIDENCE = {
     bundle: false,
     debugBuild: false,
     device: false,
     release: false,
 };
+const EXPLORATORY_EVIDENCE_SOURCE = {
+    bundle: 'none',
+    debugBuild: 'none',
+    device: 'none',
+    release: 'none',
+};
 exports.CAPABILITY_DEFINITIONS = [
     {
         id: 'expo-file-system',
@@ -26,15 +38,16 @@ exports.CAPABILITY_DEFINITIONS = [
         supportTier: 'preview',
         runtimeMode: 'adapter',
         evidence: PREVIEW_BASELINE_EVIDENCE,
-        note: 'Toolkit-managed Harmony native file-system adapters cover UTF-8 sandbox file flows, while broader Expo parity and release validation are still pending.',
+        evidenceSource: PREVIEW_BASELINE_EVIDENCE_SOURCE,
+        note: 'Toolkit-managed Harmony native file-system adapters cover the v1.7.3 preview subset: UTF-8/base64 sandbox I/O, append and partial reads, md5 metadata, and direct downloads into the app sandbox.',
         docsUrl: 'https://github.com/react-native-oh-library/usage-docs/blob/master/en/react-native-fs.md',
         nativePackageNames: ['react-native-fs'],
         harmonyPermissions: [],
         sampleRoute: '/file-system',
         acceptanceChecklist: [
-            'Write a UTF-8 file into the app sandbox.',
-            'Read the file back and verify content.',
-            'Delete the file and verify the entry disappears.',
+            'Write UTF-8 and base64 content into the app sandbox.',
+            'Read back full and partial content and verify md5 metadata.',
+            'Download a remote file into the sandbox and clean up generated entries.',
         ],
     },
     {
@@ -44,15 +57,20 @@ exports.CAPABILITY_DEFINITIONS = [
         supportTier: 'preview',
         runtimeMode: 'adapter',
         evidence: PREVIEW_BASELINE_EVIDENCE,
-        note: 'Toolkit-managed Harmony adapters cover permission probes, image-library selection, and initial camera-picker capture flows, while broader Expo parity and release validation are still pending.',
+        evidenceSource: PREVIEW_BASELINE_EVIDENCE_SOURCE,
+        note: 'Toolkit-managed Harmony adapters cover the v1.7.3 preview subset: media and camera permissions, single/multi-select library flows, system photo/video capture, pending-result restore, and richer video asset metadata.',
         docsUrl: 'https://github.com/react-native-oh-library/usage-docs/blob/master/en/react-native-image-picker.md',
         nativePackageNames: ['react-native-image-picker', 'react-native-permissions'],
-        harmonyPermissions: ['ohos.permission.CAMERA', 'ohos.permission.READ_IMAGEVIDEO'],
+        harmonyPermissions: [
+            'ohos.permission.CAMERA',
+            'ohos.permission.MICROPHONE',
+            'ohos.permission.READ_IMAGEVIDEO',
+        ],
         sampleRoute: '/image-picker',
         acceptanceChecklist: [
-            'Request media-library permissions and surface denied/cancel states.',
-            'Launch the image library flow and return one selected asset.',
-            'Launch the camera flow and surface denied/cancel states.',
+            'Request media-library and camera permissions and surface denied/cancel states.',
+            'Launch single, multi-select, and mixed library flows and return asset metadata.',
+            'Launch photo/video camera capture and restore one pending result when the JS side resumes.',
         ],
     },
     {
@@ -62,15 +80,21 @@ exports.CAPABILITY_DEFINITIONS = [
         supportTier: 'preview',
         runtimeMode: 'adapter',
         evidence: PREVIEW_BASELINE_EVIDENCE,
-        note: 'Toolkit-managed Harmony adapters cover foreground permission, current-position, last-known, and geocoding flows. Continuous watch, background permission parity, and heading APIs stay explicitly unsupported in v1.7.x while release evidence is still pending.',
+        evidenceSource: PREVIEW_BASELINE_EVIDENCE_SOURCE,
+        note: 'Toolkit-managed Harmony adapters cover the v1.7.3 preview subset: foreground/background permission flows, current and last-known fixes, geocoding, continuous watch subscriptions, and sensor-backed heading updates.',
         docsUrl: 'https://github.com/react-native-oh-library/usage-docs/blob/master/en/%40react-native-community-geolocation.md',
         nativePackageNames: ['@react-native-community/geolocation', 'react-native-permissions'],
-        harmonyPermissions: ['ohos.permission.LOCATION', 'ohos.permission.APPROXIMATELY_LOCATION'],
+        harmonyPermissions: [
+            'ohos.permission.LOCATION',
+            'ohos.permission.APPROXIMATELY_LOCATION',
+            'ohos.permission.LOCATION_IN_BACKGROUND',
+            'ohos.permission.ACCELEROMETER',
+        ],
         sampleRoute: '/location',
         acceptanceChecklist: [
-            'Request foreground location permission.',
-            'Resolve one current position fix.',
-            'Resolve one last-known or reverse-geocoded location result.',
+            'Request foreground and background location permissions.',
+            'Resolve current and last-known fixes plus one active watch update.',
+            'Resolve heading snapshot/watch updates and reverse-geocoded results.',
         ],
     },
     {
@@ -80,15 +104,16 @@ exports.CAPABILITY_DEFINITIONS = [
         supportTier: 'preview',
         runtimeMode: 'adapter',
         evidence: PREVIEW_BASELINE_EVIDENCE,
-        note: 'Toolkit-managed Harmony adapters cover camera permission and still-photo capture through the Harmony system camera flow. Embedded live preview, preview pause/resume, microphone, and video APIs stay explicitly unsupported in v1.7.x while release evidence is still pending.',
+        evidenceSource: PREVIEW_BASELINE_EVIDENCE_SOURCE,
+        note: 'Toolkit-managed Harmony adapters cover the v1.7.3 preview subset: embedded camera preview, still capture, preview pause/resume, microphone permission, and in-session video recording controls.',
         docsUrl: 'https://github.com/react-native-oh-library/usage-docs/blob/master/en/react-native-camera-kit.md',
         nativePackageNames: ['react-native-camera-kit', 'react-native-permissions'],
-        harmonyPermissions: ['ohos.permission.CAMERA'],
+        harmonyPermissions: ['ohos.permission.CAMERA', 'ohos.permission.MICROPHONE'],
         sampleRoute: '/camera',
         acceptanceChecklist: [
-            'Request camera permission.',
-            'Capture one photo and surface the asset metadata back to JS.',
-            'Record denied or canceled outcomes without crashing the Harmony runtime.',
+            'Request camera and microphone permissions.',
+            'Capture one photo and one embedded video result and surface metadata back to JS.',
+            'Exercise preview pause/resume plus denied or canceled outcomes without crashing the Harmony runtime.',
         ],
     },
     {
@@ -98,6 +123,7 @@ exports.CAPABILITY_DEFINITIONS = [
         supportTier: 'experimental',
         runtimeMode: 'shim',
         evidence: EXPLORATORY_EVIDENCE,
+        evidenceSource: EXPLORATORY_EVIDENCE_SOURCE,
         note: 'Notifications stay below the public promise until a complete Harmony delivery story is validated end to end.',
         docsUrl: 'https://github.com/react-native-oh-library',
         nativePackageNames: [],

package/build/data/dependencyCatalog.js

@@ -37,6 +37,11 @@ exports.DEPENDENCY_CATALOG = {
         supportTier: 'verified',
         note: 'Toolkit can parse Expo config and scaffold Harmony sidecar files for managed/CNG projects.',
     },
+    '@expo/metro-runtime': {
+        status: 'supported',
+        supportTier: 'verified',
+        note: 'Metro runtime is part of the validated managed Expo routing/bundling chain and keeps Expo workspace peers aligned.',
+    },
     '@babel/runtime': {
         status: 'supported',
         supportTier: 'verified',
@@ -62,6 +67,11 @@ exports.DEPENDENCY_CATALOG = {
         supportTier: 'verified',
         note: 'React is treated as a baseline JavaScript dependency.',
     },
+    'react-dom': {
+        status: 'supported',
+        supportTier: 'verified',
+        note: 'React DOM is treated as a workspace peer for Expo Router and web-capable managed Expo projects inside the validated matrix.',
+    },
     'react-native': {
         status: 'supported',
         supportTier: 'verified',

package/build/data/publicDocs.d.ts

@@ -0,0 +1,11 @@
+export declare const PUBLIC_RELEASE_TRACKS: {
+    readonly latest: "fully accepted verified only";
+    readonly next: "preview fast track";
+};
+export declare const PRIMARY_SAMPLE_PATH = "examples/official-ui-stack-sample";
+export declare const PREVIEW_SAMPLE_PATH = "examples/official-native-capabilities-sample";
+export declare const SUPPORTING_SAMPLE_PATHS: readonly ["examples/official-app-shell-sample", "examples/official-minimal-sample"];
+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.7.3";

package/build/data/publicDocs.js

@@ -0,0 +1,28 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PUBLIC_CURRENT_VERSION = exports.EXPERIMENTAL_CAPABILITY_NAMES = exports.PREVIEW_CAPABILITY_DEFINITIONS = exports.VERIFIED_JS_UI_CAPABILITY_NAMES = exports.SUPPORTING_SAMPLE_PATHS = exports.PREVIEW_SAMPLE_PATH = exports.PRIMARY_SAMPLE_PATH = exports.PUBLIC_RELEASE_TRACKS = void 0;
+const constants_1 = require("../core/constants");
+const capabilities_1 = require("./capabilities");
+const uiStack_1 = require("./uiStack");
+exports.PUBLIC_RELEASE_TRACKS = {
+    latest: 'fully accepted verified only',
+    next: 'preview fast track',
+};
+exports.PRIMARY_SAMPLE_PATH = 'examples/official-ui-stack-sample';
+exports.PREVIEW_SAMPLE_PATH = 'examples/official-native-capabilities-sample';
+exports.SUPPORTING_SAMPLE_PATHS = [
+    'examples/official-app-shell-sample',
+    'examples/official-minimal-sample',
+];
+exports.VERIFIED_JS_UI_CAPABILITY_NAMES = [
+    'expo-router',
+    'expo-linking',
+    'expo-constants',
+    ...uiStack_1.UI_STACK_VALIDATED_ADAPTERS.map((adapter) => adapter.canonicalPackageName),
+];
+exports.PREVIEW_CAPABILITY_DEFINITIONS = capabilities_1.CAPABILITY_DEFINITIONS.filter((definition) => definition.supportTier === 'preview');
+exports.EXPERIMENTAL_CAPABILITY_NAMES = [
+    ...capabilities_1.CAPABILITY_DEFINITIONS.filter((definition) => definition.supportTier === 'experimental').map((definition) => definition.packageName),
+    'react-native-gesture-handler',
+];
+exports.PUBLIC_CURRENT_VERSION = constants_1.TOOLKIT_VERSION;

package/build/data/validatedMatrices.js

@@ -6,10 +6,12 @@ const uiStack_1 = require("./uiStack");
 exports.DEFAULT_VALIDATED_MATRIX_ID = 'expo55-rnoh082-ui-stack';
 const BASE_ALLOWED_DEPENDENCIES = [
     'expo',
+    '@expo/metro-runtime',
     'expo-constants',
     'expo-linking',
     'expo-router',
     'react',
+    'react-dom',
     'react-native',
     'expo-status-bar',
     '@babel/runtime',
@@ -36,6 +38,9 @@ exports.VALIDATED_RELEASE_MATRICES = {
                 required: true,
                 version: '>=55.0.0 <56.0.0',
             },
+            '@expo/metro-runtime': {
+                version: '>=55.0.0 <56.0.0',
+            },
             'expo-constants': {
                 version: '>=55.0.0 <56.0.0',
             },
@@ -43,12 +48,15 @@ exports.VALIDATED_RELEASE_MATRICES = {
                 version: '>=55.0.0 <56.0.0',
             },
             'expo-router': {
-                version: '>=6.0.0 <7.0.0',
+                version: '>=55.0.0 <56.0.0',
             },
             react: {
                 required: true,
                 version: '19.1.1',
             },
+            'react-dom': {
+                version: '19.1.1',
+            },
             'react-native': {
                 required: true,
                 version: '0.82.1',

package/build/docs/render.d.ts

@@ -0,0 +1,9 @@
+export type DocsLocale = 'zh' | 'en';
+export declare function renderReadmeCurrentStatus(locale: DocsLocale): string;
+export declare function renderReadmeSupportMatrixSection(locale: DocsLocale): string;
+export declare function renderSupportMatrixVerifiedMatrix(locale: DocsLocale): string;
+export declare function renderSupportMatrixVerifiedAllowlist(): string;
+export declare function renderSupportMatrixCapabilityTelemetry(locale: DocsLocale): string;
+export declare function renderSupportMatrixPreviewCapabilities(locale: DocsLocale): string;
+export declare function renderSupportMatrixUiStackRules(locale: DocsLocale): string;
+export declare function renderSupportMatrixReleaseTracks(locale: DocsLocale): string;

package/build/docs/render.js

@@ -0,0 +1,248 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.renderReadmeCurrentStatus = renderReadmeCurrentStatus;
+exports.renderReadmeSupportMatrixSection = renderReadmeSupportMatrixSection;
+exports.renderSupportMatrixVerifiedMatrix = renderSupportMatrixVerifiedMatrix;
+exports.renderSupportMatrixVerifiedAllowlist = renderSupportMatrixVerifiedAllowlist;
+exports.renderSupportMatrixCapabilityTelemetry = renderSupportMatrixCapabilityTelemetry;
+exports.renderSupportMatrixPreviewCapabilities = renderSupportMatrixPreviewCapabilities;
+exports.renderSupportMatrixUiStackRules = renderSupportMatrixUiStackRules;
+exports.renderSupportMatrixReleaseTracks = renderSupportMatrixReleaseTracks;
+const publicDocs_1 = require("../data/publicDocs");
+const validatedMatrices_1 = require("../data/validatedMatrices");
+const uiStack_1 = require("../data/uiStack");
+const matrix = validatedMatrices_1.VALIDATED_RELEASE_MATRICES[validatedMatrices_1.DEFAULT_VALIDATED_MATRIX_ID];
+function renderReadmeCurrentStatus(locale) {
+    const headers = locale === 'zh'
+        ? ['项目', '说明']
+        : ['Item', 'Status'];
+    const versionLabel = locale === 'zh' ? '当前版本' : 'Current version';
+    const supportModelLabel = locale === 'zh' ? '支持模型' : 'Support model';
+    const verifiedMatrixLabel = locale === 'zh' ? '唯一 `verified` 公开矩阵' : 'Public `verified` matrix';
+    const inputLabel = locale === 'zh' ? '输入范围' : 'Supported input';
+    const verifiedCapabilitiesLabel = locale === 'zh' ? '`verified` JS/UI 能力' : '`verified` JS/UI capabilities';
+    const previewLabel = locale === 'zh' ? '`preview` 原生能力' : '`preview` native capabilities';
+    const experimentalLabel = locale === 'zh' ? '`experimental` 能力' : '`experimental` capabilities';
+    const releaseTracksLabel = locale === 'zh' ? '发布轨' : 'Release tracks';
+    const telemetryLabel = locale === 'zh' ? 'capability 遥测' : 'Capability telemetry';
+    const buildPathLabel = locale === 'zh' ? '构建链' : 'Build path';
+    const primarySampleLabel = locale === 'zh' ? '主 sample' : 'Primary sample';
+    const previewSampleLabel = locale === 'zh' ? 'preview sample' : 'Preview sample';
+    const supportingSamplesLabel = locale === 'zh' ? '辅助 onboarding samples' : 'Supporting onboarding samples';
+    const releaseTracksValue = locale === 'zh'
+        ? `\`latest\` = ${publicDocs_1.PUBLIC_RELEASE_TRACKS.latest}；\`next\` = ${publicDocs_1.PUBLIC_RELEASE_TRACKS.next}`
+        : `\`latest\` = fully accepted \`verified\` only; \`next\` = ${publicDocs_1.PUBLIC_RELEASE_TRACKS.next}`;
+    const inputValue = locale === 'zh' ? 'Managed/CNG Expo 项目' : 'Managed/CNG Expo projects';
+    const listJoiner = locale === 'zh' ? '、' : ', ';
+    return [
+        `| ${headers[0]} | ${headers[1]} |`,
+        '| --- | --- |',
+        `| ${versionLabel} | \`v${publicDocs_1.PUBLIC_CURRENT_VERSION}\` |`,
+        `| ${supportModelLabel} | \`verified + preview + experimental\` |`,
+        `| ${verifiedMatrixLabel} | \`${validatedMatrices_1.DEFAULT_VALIDATED_MATRIX_ID}\` |`,
+        `| ${inputLabel} | ${inputValue} |`,
+        `| ${verifiedCapabilitiesLabel} | ${joinInlineCode(publicDocs_1.VERIFIED_JS_UI_CAPABILITY_NAMES, listJoiner)} |`,
+        `| ${previewLabel} | ${joinInlineCode(publicDocs_1.PREVIEW_CAPABILITY_DEFINITIONS.map((definition) => definition.packageName), listJoiner)} |`,
+        `| ${experimentalLabel} | ${joinInlineCode(publicDocs_1.EXPERIMENTAL_CAPABILITY_NAMES, listJoiner)} |`,
+        `| ${releaseTracksLabel} | ${releaseTracksValue} |`,
+        `| ${telemetryLabel} | \`runtimeMode\` + \`evidence(...)\` + \`evidenceSource(...)\` |`,
+        `| ${buildPathLabel} | \`doctor -> init -> bundle -> build-hap\` |`,
+        `| ${primarySampleLabel} | \`${publicDocs_1.PRIMARY_SAMPLE_PATH}\` |`,
+        `| ${previewSampleLabel} | \`${publicDocs_1.PREVIEW_SAMPLE_PATH}\` |`,
+        `| ${supportingSamplesLabel} | ${publicDocs_1.SUPPORTING_SAMPLE_PATHS.map((samplePath) => `\`${samplePath}\``).join(locale === 'zh' ? '、' : ', ')} |`,
+    ].join('\n');
+}
+function renderReadmeSupportMatrixSection(locale) {
+    const verifiedLine = locale === 'zh'
+        ? `- \`verified\`：唯一公开矩阵仍是 \`${validatedMatrices_1.DEFAULT_VALIDATED_MATRIX_ID}\``
+        : `- \`verified\`: the only public matrix remains \`${validatedMatrices_1.DEFAULT_VALIDATED_MATRIX_ID}\``;
+    const previewLine = locale === 'zh'
+        ? `- \`preview\`：${joinInlineCode(publicDocs_1.PREVIEW_CAPABILITY_DEFINITIONS.map((definition) => definition.packageName))}`
+        : `- \`preview\`: ${joinInlineCode(publicDocs_1.PREVIEW_CAPABILITY_DEFINITIONS.map((definition) => definition.packageName))}`;
+    const experimentalLine = locale === 'zh'
+        ? `- \`experimental\`：${joinInlineCode(publicDocs_1.EXPERIMENTAL_CAPABILITY_NAMES)}`
+        : `- \`experimental\`: ${joinInlineCode(publicDocs_1.EXPERIMENTAL_CAPABILITY_NAMES)}`;
+    const strictLine = locale === 'zh'
+        ? '`doctor --strict` 继续只代表 `verified`。`doctor --target-tier preview` 会在同一 runtime matrix 下额外放行 preview 能力，但这不等于它们已经进入正式承诺。'
+        : '`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.';
+    const telemetryLines = locale === 'zh'
+        ? [
+            '- `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` 表示当前只有人工设备验收记录，不代表机器自动验证',
+        ]
+        : [
+            '- `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',
+        ];
+    return [verifiedLine, previewLine, experimentalLine, '', strictLine, '', ...telemetryLines].join('\n');
+}
+function renderSupportMatrixVerifiedMatrix(locale) {
+    const appShellValue = locale === 'zh'
+        ? '`expo-router` `55.x`、`expo-linking` `55.x`、`expo-constants` `55.x`、`@expo/metro-runtime` `55.x`、`react-dom` `19.1.1`'
+        : '`expo-router` `55.x`, `expo-linking` `55.x`, `expo-constants` `55.x`, `@expo/metro-runtime` `55.x`, `react-dom` `19.1.1`';
+    const uiStackValue = locale === 'zh'
+        ? '`react-native-reanimated` `3.6.0`、`react-native-svg` `15.0.0`'
+        : '`react-native-reanimated` `3.6.0`, `react-native-svg` `15.0.0`';
+    return [
+        '| 项目 | 要求 |',
+        '| --- | --- |',
+        `| Expo SDK | \`${matrix.expoSdkVersion}\` |`,
+        `| React | \`${matrix.dependencyRules.react?.version}\` |`,
+        `| React Native | \`${matrix.dependencyRules['react-native']?.version}\` |`,
+        `| \`@react-native-oh/react-native-harmony\` | \`${matrix.dependencyRules['@react-native-oh/react-native-harmony']?.version}\` |`,
+        `| \`@react-native-oh/react-native-harmony-cli\` | \`${matrix.dependencyRules['@react-native-oh/react-native-harmony-cli']?.version}\` |`,
+        '| `@react-native-community/cli` | `20.x` |',
+        '| `metro` | `0.83.x` |',
+        `| App Shell 依赖 | ${appShellValue} |`,
+        `| UI stack 依赖 | ${uiStackValue} |`,
+        '| 原生标识 | 至少设置 `android.package` 或 `ios.bundleIdentifier` |',
+    ].join('\n');
+}
+function renderSupportMatrixVerifiedAllowlist() {
+    return matrix.allowedDependencies.map((dependencyName) => `- \`${dependencyName}\``).join('\n');
+}
+function renderSupportMatrixCapabilityTelemetry(locale) {
+    const lines = locale === 'zh'
+        ? [
+            '所有 capability 从现在开始都同时公开：',
+            '',
+            '- `supportTier`',
+            '- `runtimeMode`',
+            '- `evidence.bundle`',
+            '- `evidence.debugBuild`',
+            '- `evidence.device`',
+            '- `evidence.release`',
+            '- `evidenceSource.bundle`',
+            '- `evidenceSource.debugBuild`',
+            '- `evidenceSource.device`',
+            '- `evidenceSource.release`',
+            '',
+            '判读规则：',
+            '',
+            '- `runtimeMode=shim`：说明当前还在桥接或占位阶段，即使 bundle / debug build 已完成，也不应宣称 verified',
+            '- `runtimeMode=adapter`：说明已经进入真实适配路径，但仍缺少某些验收证据',
+            '- `runtimeMode=verified`：说明能力已进入正式承诺，且证据闭环完成',
+        ]
+        : [
+            'All capabilities now publish the following fields together:',
+            '',
+            '- `supportTier`',
+            '- `runtimeMode`',
+            '- `evidence.bundle`',
+            '- `evidence.debugBuild`',
+            '- `evidence.device`',
+            '- `evidence.release`',
+            '- `evidenceSource.bundle`',
+            '- `evidenceSource.debugBuild`',
+            '- `evidenceSource.device`',
+            '- `evidenceSource.release`',
+            '',
+            'Reading rules:',
+            '',
+            '- `runtimeMode=shim`: the capability is still on a bridge or placeholder path and must not be described as verified',
+            '- `runtimeMode=adapter`: the capability is on a real adapter path but still lacks part of the evidence needed for verified promotion',
+            '- `runtimeMode=verified`: the capability has entered the formal public promise and closed the evidence loop',
+        ];
+    return lines.join('\n');
+}
+function renderSupportMatrixPreviewCapabilities(locale) {
+    const headers = locale === 'zh'
+        ? ['Expo 能力', '当前层级', 'runtimeMode', 'evidence', 'Harmony 依赖方向', '受管权限', '官方 sample route']
+        : ['Expo capability', 'Support tier', 'runtimeMode', 'evidence', 'Harmony dependency direction', 'Managed permissions', 'Official sample route'];
+    return [
+        `| ${headers.join(' | ')} |`,
+        `| ${headers.map(() => '---').join(' | ')} |`,
+        ...publicDocs_1.PREVIEW_CAPABILITY_DEFINITIONS.map((definition) => {
+            const dependencyDirection = definition.nativePackageNames.length > 0
+                ? definition.nativePackageNames.join(', ')
+                : 'toolkit-managed bridge';
+            const permissions = definition.harmonyPermissions.length > 0
+                ? definition.harmonyPermissions.join(locale === 'zh' ? '、' : ', ')
+                : locale === 'zh'
+                    ? '无新增必需权限'
+                    : 'no additional required permissions';
+            return [
+                `\`${definition.packageName}\``,
+                `\`${definition.supportTier}\``,
+                `\`${definition.runtimeMode}\``,
+                `\`${renderEvidence(definition)}\``,
+                dependencyDirection,
+                permissions,
+                `\`${definition.sampleRoute}\``,
+            ].join(' | ');
+        }).map((row) => `| ${row} |`),
+    ].join('\n');
+}
+function renderSupportMatrixUiStackRules(locale) {
+    const intro = locale === 'zh'
+        ? 'canonical 包与 Harmony adapter 包固定为双向强制：'
+        : 'Canonical packages and Harmony adapters stay strictly paired in both directions:';
+    const rules = locale === 'zh'
+        ? [
+            '规则固定为：',
+            '',
+            '- 出现 canonical 包，必须同时出现对应 `@react-native-oh-tpl/*`',
+            '- 出现 `@react-native-oh-tpl/*`，也必须同时出现对应 canonical 包',
+            '- canonical 包按 semver 校验',
+            '- `@react-native-oh-tpl/*` 按 exact dependency specifier 校验',
+            '',
+            '当前固定 exact specifier：',
+        ]
+        : [
+            'The enforced rules are:',
+            '',
+            '- canonical packages require their matching `@react-native-oh-tpl/*` adapters',
+            '- adapter packages also require their canonical counterparts',
+            '- canonical packages are validated with semver ranges',
+            '- `@react-native-oh-tpl/*` adapters are validated against exact dependency specifiers',
+            '',
+            'Pinned exact specifiers:',
+        ];
+    return [
+        intro,
+        '',
+        ...uiStack_1.UI_STACK_VALIDATED_ADAPTERS.map((adapter) => `- \`${adapter.canonicalPackageName}\` ↔ \`${adapter.adapterPackageName}\``),
+        '',
+        ...rules,
+        '',
+        ...uiStack_1.UI_STACK_VALIDATED_ADAPTERS.map((adapter) => `- \`${adapter.adapterPackageName}\`: \`${(0, uiStack_1.getUiStackAdapterSpecifier)(adapter)}\``),
+    ].join('\n');
+}
+function renderSupportMatrixReleaseTracks(locale) {
+    return locale === 'zh'
+        ? [
+            '- `latest`',
+            '  - 只承接完整验收的 `verified` 能力',
+            '  - 只允许 verified sample / gate 作为发布依据',
+            '- `next`',
+            '  - 承接 preview fast track',
+            '  - 必须至少通过 preview sample、bundle、debug build gate',
+            '  - 不得被描述为 verified 或 release-ready',
+        ].join('\n')
+        : [
+            '- `latest`',
+            '  - only carries fully accepted `verified` capabilities',
+            '  - only verified samples and gates may justify a release',
+            '- `next`',
+            '  - carries preview fast-track work',
+            '  - must at least pass the preview sample, bundle, and debug-build gates',
+            '  - must not be described as verified or release-ready',
+        ].join('\n');
+}
+function joinInlineCode(entries, joiner = ', ') {
+    return entries.map((entry) => `\`${entry}\``).join(joiner);
+}
+function renderEvidence(definition) {
+    return [
+        `bundle=${definition.evidence.bundle ? 'yes' : 'no'}[${definition.evidenceSource.bundle}]`,
+        `debugBuild=${definition.evidence.debugBuild ? 'yes' : 'no'}[${definition.evidenceSource.debugBuild}]`,
+        `device=${definition.evidence.device ? 'yes' : 'no'}[${definition.evidenceSource.device}]`,
+        `release=${definition.evidence.release ? 'yes' : 'no'}[${definition.evidenceSource.release}]`,
+    ].join(', ');
+}

package/build/types.d.ts

@@ -3,6 +3,8 @@ export type EligibilityStatus = 'eligible' | 'ineligible';
 export type SupportTier = 'verified' | 'preview' | 'experimental' | 'unsupported';
 export type DoctorTargetTier = Exclude<SupportTier, 'unsupported'>;
 export type CapabilityRuntimeMode = 'shim' | 'adapter' | 'verified';
+export type CapabilityEvidenceSource = 'automated' | 'manual-doc' | 'none';
+export type DependencyBuildabilityRisk = 'known' | 'js-only-unknown' | 'native-risk' | 'unresolved';
 export type DependencySource = 'dependency' | 'devDependency' | 'peerDependency' | 'expo-plugin';
 export interface ExpoHarmonyPluginProps {
     bundleName?: string;
@@ -66,6 +68,7 @@ export interface DetectedDependency {
     source: DependencySource;
     status: CompatibilityStatus;
     supportTier: SupportTier;
+    buildabilityRisk: DependencyBuildabilityRisk;
     blocking: boolean;
     note: string;
     replacement?: string;
@@ -89,6 +92,12 @@ export interface CapabilityEvidence {
     device: boolean;
     release: boolean;
 }
+export interface CapabilityEvidenceSourceMap {
+    bundle: CapabilityEvidenceSource;
+    debugBuild: CapabilityEvidenceSource;
+    device: CapabilityEvidenceSource;
+    release: CapabilityEvidenceSource;
+}
 export interface CapabilityDefinition {
     id: string;
     packageName: string;
@@ -96,6 +105,7 @@ export interface CapabilityDefinition {
     supportTier: DoctorTargetTier;
     runtimeMode: CapabilityRuntimeMode;
     evidence: CapabilityEvidence;
+    evidenceSource: CapabilityEvidenceSourceMap;
     note: string;
     docsUrl?: string;
     nativePackageNames: string[];
@@ -110,6 +120,7 @@ export interface ProjectCapabilityReport {
     supportTier: DoctorTargetTier;
     runtimeMode: CapabilityRuntimeMode;
     evidence: CapabilityEvidence;
+    evidenceSource: CapabilityEvidenceSourceMap;
     note: string;
     docsUrl?: string;
     nativePackageNames: string[];
@@ -123,6 +134,7 @@ export interface ManagedCapabilityRecord {
     supportTier: DoctorTargetTier;
     runtimeMode: CapabilityRuntimeMode;
     evidence: CapabilityEvidence;
+    evidenceSource: CapabilityEvidenceSourceMap;
 }
 export interface DoctorReport {
     generatedAt: string;

package/docs/cli-build.md

@@ -1,6 +1,6 @@
 # CLI 构建指南
 
-`v1.7.1` 延续 `verified + preview + experimental` 支持分层，并把 Batch B 设备能力推进到 preview 接入路径，其中 `expo55-rnoh082-ui-stack` 仍是唯一 verified 矩阵。
+`v1.7.3` 延续 `verified + preview + experimental` 支持分层，并把四项 preview capability 的现有 `🟠` 缺口收口到明确 `🟡` 子集，其中 `expo55-rnoh082-ui-stack` 仍是唯一 verified 矩阵。
 
 CLI 命令集合不变：
 

package/docs/npm-release.md

@@ -60,6 +60,7 @@ pnpm release:check
 
 - hosted CI 默认仍可通过 `EXPO_HARMONY_RELEASE_SKIP_HAP=1` 跳过真实 DevEco HAP 构建
 - debug / release HAP gate 继续由 capability acceptance、带工具链环境的 CI 或本地验收补齐
+- preview capability 若在报告里显示 `device=yes`，必须同时以 `evidenceSource.device=manual-doc` 对外说明其来源，不得表述成 CI 自动设备验证
 
 ## 手动发布
 

package/docs/official-app-shell-sample.md

@@ -38,7 +38,7 @@ pnpm run harmony:build:debug
 如果要继续验证 release 构建，先准备本地签名覆盖文件：
 
 ```bash
-mkdir -p .expo-harmony
+cp .expo-harmony/signing.local.example.json .expo-harmony/signing.local.json
 $EDITOR .expo-harmony/signing.local.json
 pnpm run harmony:env
 pnpm run harmony:build:release
@@ -46,6 +46,7 @@ pnpm run harmony:build:release
 
 说明：
 
+- `.expo-harmony/signing.local.example.json` 是可直接复制的本地 signing 範本
 - `.expo-harmony/signing.local.json` 是本地 signing 入口
 - signing 缺失时，`harmony:env` 和 `harmony:build:release` 会明确提示，不会静默跳过
 

package/docs/official-minimal-sample.md

@@ -35,7 +35,7 @@ pnpm run harmony:build:debug
 如果要继续验证 release 构建，先准备本地签名覆盖文件：
 
 ```bash
-mkdir -p .expo-harmony
+cp .expo-harmony/signing.local.example.json .expo-harmony/signing.local.json
 $EDITOR .expo-harmony/signing.local.json
 pnpm run harmony:env
 pnpm run harmony:build:release
@@ -43,6 +43,7 @@ pnpm run harmony:build:release
 
 说明：
 
+- `.expo-harmony/signing.local.example.json` 是可直接复制的本地 signing 範本
 - `.expo-harmony/signing.local.json` 是本地 signing 入口
 - toolkit 会把本地 signing 合并进 `harmony/build-profile.json5`
 - 如果 signing 没配置，`harmony:env` 会明确报缺失；这属于预期阻断