推进 INI 面板 shell handoff snapshot API

wasm-port/docs/panel-entry.md

@@ -21,7 +21,11 @@ import {
   createIniPanelShellIntegrationReadiness,
   createIniPanelShellIntegrationSchema,
   createIniPanelShellIntegrationWorkflowPlan,
+  createIniPanelShellSessionHandoffCompatibilityReport,
+  createIniPanelShellSessionHandoffDisplayViewModel,
+  createIniPanelShellSessionHandoffSnapshot,
   createIniPanelShellSessionHandoffSummary,
+  createIniPanelShellSessionHandoffSummarySchema,
   createIniPanelShellViewModel,
   getIniPanelEntryByHref,
   getVisibleIniPanelEntries,
@@ -37,6 +41,7 @@ import {
   isSupportedIniPanelControlPageApiManifest,
   isSupportedIniPanelLaunchApiManifest,
   isSupportedIniPanelShellIntegrationManifest,
+  isSupportedIniPanelShellSessionHandoffSummary,
 } from "../runtime/ui/ini-panel/ui-shell.js";
 ```
 
@@ -135,6 +140,25 @@ read-only display summary of readiness, target page, persistence capabilities,
 readonly status fields, handoff methods, and blocking reasons. Browser shells
 can read the same summary through
 `linuxCncIniPanelLaunchApi.getShellSessionHandoffSummary()`.
+Use `createIniPanelShellSessionHandoffSummarySchema()` or
+`linuxCncIniPanelLaunchApi.getShellSessionHandoffSummarySchema()` for the
+versioned summary shape, and `isSupportedIniPanelShellSessionHandoffSummary()`
+or `linuxCncIniPanelLaunchApi.isSupportedShellSessionHandoffSummary()` before
+consuming a summary from a browser shell.
+Use `createIniPanelShellSessionHandoffCompatibilityReport()` or
+`linuxCncIniPanelLaunchApi.getShellSessionHandoffCompatibilityReport()` when an
+outer shell needs display-ready diagnostics for schema support, missing fields,
+api/version mismatches, and current blocking reasons before consuming the
+handoff summary.
+Use `createIniPanelShellSessionHandoffDisplayViewModel()` or
+`linuxCncIniPanelLaunchApi.getShellSessionHandoffDisplayViewModel()` when an
+outer shell needs the same diagnostics as stable read-only label/value rows for
+DOM display. The launch page renders those rows in `[data-handoff-status]` and
+`[data-handoff-rows]` without adding control actions.
+Use `createIniPanelShellSessionHandoffSnapshot()` or
+`linuxCncIniPanelLaunchApi.getShellSessionHandoffSnapshot()` when an outer shell
+needs one read-only API read that includes readiness, handoff summary,
+compatibility report, and display view-model together.
 The browser workflow smoke
 `tests/browser/ini_panel_shell_integration_workflow_smoke.html` verifies the
 same external shell handoff: read integration manifest, pass readiness gate,