From 1375e0ddd50d1e917c8251f5f37bb12b15862c08 Mon Sep 17 00:00:00 2001
From: wangdequan <wangdequan@meswork.com>
Date: Mon, 15 Jun 2026 11:43:00 +0800
Subject: [PATCH] =?UTF-8?q?=E6=8E=A8=E8=BF=9B=20INI=20=E9=9D=A2=E6=9D=BF?=
 =?UTF-8?q?=20launch=20mount-state=20DOM=20=E6=B8=B2=E6=9F=93?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 text12.txt                                    | 76 +++++++++++++++++++
 wasm-port/docs/panel-entry.md                 |  4 +-
 wasm-port/runtime/ui/ini-panel/launch.html    | 22 ++++++
 .../tests/browser/ini_panel_launch_smoke.html | 30 ++++++++
 .../verify_ini_panel_launch_api_manifest.mjs  |  3 +
 5 files changed, 134 insertions(+), 1 deletion(-)

diff --git a/text12.txt b/text12.txt
index e7cb7b7..c68ffab 100644
--- a/text12.txt
+++ b/text12.txt
@@ -2489,3 +2489,79 @@ host_wasm_opfs_browser_smokes=ok
 继续推进 browser/UI workflow 与 OPFS/session persistence。下一批建议把 mount render-state 接入
 launch 页面一个独立的 `[data-handoff-mount-*]` 只读区域，或在 shell integration workflow 中增加
 mount-state ready DOM rendering smoke；仍保持只读，不新增控制按钮，不解析 G-code。
+
+三十一、2026-06-15 继续执行记录：INI panel launch mount-state DOM render
+
+本轮按“第一原则：加快实质性推进”继续推进 browser/UI workflow，把 mount render-state 接入
+真实 launch 页面独立只读 DOM 区域，使首屏能同时显示 package handoff 状态与 mount readiness 状态。
+
+完成内容：
+
+- `launch.html` 新增独立只读 mount 状态区域：
+  - `[data-handoff-mount]`；
+  - `[data-handoff-mount-status]`；
+  - `[data-handoff-mount-rows]`；
+- `launch.html` 使用 `shellSessionHandoffPackageMountRenderState` 渲染默认 waiting mount-state；
+- mount DOM rows 写入：
+  - `data-handoff-mount-row`；
+  - `data-handoff-mount-value`；
+  - `data-handoff-mount-status`；
+- mount DOM dataset 暴露：
+  - `data-handoff-phase`；
+  - `data-handoff-ready`；
+  - `data-handoff-scope="mount"`；
+- `ini_panel_launch_smoke.html` 校验真实 launch iframe 中的 mount DOM status、phase、ready、scope、
+  session state value 与 row status；
+- `verify_ini_panel_launch_api_manifest.mjs` 覆盖 launch page 中新增 mount DOM hooks；
+- `docs/panel-entry.md` 记录 launch 页面 mount DOM hook；
+- 未新增控制按钮；
+- 未解析 G-code；
+- 未解释 canonical events；
+- 未新增 JS CNC 语义；
+- 未改变 OPFS/session persistence、LinuxCNC interpreter、tool、parameter、planner 或
+  LinuxCNC-owned runtime semantics。
+
+验证已通过：
+
+```bash
+git diff --check
+wasm-port/tests/ui/node/verify_ini_panel_launch_api_manifest.sh
+wasm-port/tests/ui/node/verify_ini_panel_entry_docs.sh
+wasm-port/tests/ui/node/verify_ini_panel_ui_shell.sh
+wasm-port/tests/ui/node/verify_ini_panel_shell_integration_manifest.sh
+wasm-port/tests/ui/node/verify_ui_node_smokes.sh
+SKIP_INI_BUILD=1 SKIP_INTERP_BUILD=1 wasm-port/tests/browser/verify_ini_panel_browser.sh
+wasm-port/tools/verify_vendor_sync.sh
+wasm-port/tools/verify_no_standalone_cnc_semantics.sh
+SKIP_INTERP_BUILD=1 wasm-port/tests/wasm/node/verify_interp_wasm.sh
+SKIP_INTERP_BUILD=1 wasm-port/tests/wasm/node/verify_sim_configs_inventory_wasm.sh
+wasm-port/tests/host/verify_host_smokes.sh
+```
+
+关键输出：
+
+```text
+ini_panel_launch_api_manifest_node_smoke=ok
+ini_panel_entry_docs_node_smoke=ok
+ini_panel_ui_shell_node_smoke=ok
+ini_panel_shell_integration_manifest_node_smoke=ok
+browser_ini_opfs_smoke=ok
+browser_ini_control_page_smoke=ok
+browser_ini_launch_smoke=ok
+browser_ini_shell_integration_workflow_smoke=ok
+ui_node_smokes=ok
+vendor sync up to date
+standalone CNC semantics guard complete
+interp_wasm_node_smoke=ok
+sim_configs_wasm_node_inventory_executed=28
+sim_configs_wasm_node_inventory_passed=28
+sim_configs_wasm_node_inventory_skipped=131
+sim_configs_wasm_node_inventory_unexpected_fail=0
+host_wasm_opfs_browser_smokes=ok
+```
+
+下一步建议：
+
+继续推进 browser/UI workflow。下一批建议在 shell integration browser workflow 中增加 ready
+mount-state DOM rendering helper 或 smoke，把 control-page ready 后的 mount render-state 渲染到
+外部 shell 自有 DOM 并校验 row/status；仍保持只读，不新增控制按钮，不解析 G-code。
diff --git a/wasm-port/docs/panel-entry.md b/wasm-port/docs/panel-entry.md
index bcda879..34467ed 100644
--- a/wasm-port/docs/panel-entry.md
+++ b/wasm-port/docs/panel-entry.md
@@ -224,7 +224,9 @@ when an outer shell needs mount-state checks as stable read-only label/value
 rows. Use `createIniPanelShellSessionHandoffPackageMountRenderState()` or
 `linuxCncIniPanelLaunchApi.getShellSessionHandoffPackageMountRenderState()`
 when those rows need a status line and `[data-handoff-shell]` style dataset
-flags for DOM rendering.
+flags for DOM rendering. The launch page renders the default waiting mount
+state into `[data-handoff-mount]`, `[data-handoff-mount-status]`, and
+`[data-handoff-mount-rows]` without opening the control page.
 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,
diff --git a/wasm-port/runtime/ui/ini-panel/launch.html b/wasm-port/runtime/ui/ini-panel/launch.html
index d5463d9..01abc7d 100644
--- a/wasm-port/runtime/ui/ini-panel/launch.html
+++ b/wasm-port/runtime/ui/ini-panel/launch.html
@@ -95,6 +95,10 @@
         <p data-handoff-status>Checking shell handoff compatibility.</p>
         <dl data-handoff-rows></dl>
       </section>
+      <section class="handoff-status" aria-label="Shell handoff mount readiness" data-handoff-mount>
+        <p data-handoff-mount-status>Checking shell handoff mount readiness.</p>
+        <dl data-handoff-mount-rows></dl>
+      </section>
     </section>
   </main>
   <script type="module">
@@ -130,6 +134,24 @@
       detail.textContent = row.value;
       handoffRows.append(term, detail);
     }
+    const handoffMountRenderState = shellViewModel.shellSessionHandoffPackageMountRenderState;
+    const handoffMount = document.querySelector("[data-handoff-mount]");
+    handoffMount.dataset.handoffPhase = handoffMountRenderState.dataset.handoffPhase;
+    handoffMount.dataset.handoffReady = handoffMountRenderState.dataset.handoffReady;
+    handoffMount.dataset.handoffScope = handoffMountRenderState.dataset.handoffScope;
+    document.querySelector("[data-handoff-mount-status]").textContent = handoffMountRenderState.statusLine;
+    const handoffMountRows = document.querySelector("[data-handoff-mount-rows]");
+    for (const row of handoffMountRenderState.rows) {
+      const term = document.createElement("dt");
+      term.dataset.handoffMountRow = row.id;
+      term.dataset.handoffMountStatus = row.status;
+      term.textContent = row.label;
+      const detail = document.createElement("dd");
+      detail.dataset.handoffMountValue = row.id;
+      detail.dataset.handoffMountStatus = row.status;
+      detail.textContent = row.value;
+      handoffMountRows.append(term, detail);
+    }
 
     window.linuxCncIniPanelLaunchApi = {
       isSupportedLaunchApiManifest: isSupportedIniPanelLaunchApiManifest,
diff --git a/wasm-port/tests/browser/ini_panel_launch_smoke.html b/wasm-port/tests/browser/ini_panel_launch_smoke.html
index ce9b524..3e51bf1 100644
--- a/wasm-port/tests/browser/ini_panel_launch_smoke.html
+++ b/wasm-port/tests/browser/ini_panel_launch_smoke.html
@@ -487,6 +487,36 @@
         "none",
         "shell session handoff DOM blocking reasons",
       );
+      assertEqual(
+        launchDoc.querySelector("[data-handoff-mount-status]").textContent,
+        "Blocked: session-load-state",
+        "shell session handoff mount DOM status",
+      );
+      assertEqual(
+        launchDoc.querySelector("[data-handoff-mount]").dataset.handoffPhase,
+        "blocked",
+        "shell session handoff mount DOM phase",
+      );
+      assertEqual(
+        launchDoc.querySelector("[data-handoff-mount]").dataset.handoffReady,
+        "false",
+        "shell session handoff mount DOM ready",
+      );
+      assertEqual(
+        launchDoc.querySelector("[data-handoff-mount]").dataset.handoffScope,
+        "mount",
+        "shell session handoff mount DOM scope",
+      );
+      assertEqual(
+        launchDoc.querySelector('[data-handoff-mount-value="session-load-state"]').textContent,
+        "waiting-panel",
+        "shell session handoff mount DOM session state",
+      );
+      assertEqual(
+        launchDoc.querySelector('[data-handoff-mount-value="session-load-state"]').dataset.handoffMountStatus,
+        "blocked",
+        "shell session handoff mount DOM session status",
+      );
       assertEqual(
         shellSessionHandoffSummary.targetPage.href,
         "./control-page.html",
diff --git a/wasm-port/tests/ui/node/verify_ini_panel_launch_api_manifest.mjs b/wasm-port/tests/ui/node/verify_ini_panel_launch_api_manifest.mjs
index 2b7be8a..08f8131 100644
--- a/wasm-port/tests/ui/node/verify_ini_panel_launch_api_manifest.mjs
+++ b/wasm-port/tests/ui/node/verify_ini_panel_launch_api_manifest.mjs
@@ -182,6 +182,9 @@ assert.match(launchText, /\bgetShellSessionHandoffPackageMountState\b/);
 assert.match(launchText, /\bgetShellSessionHandoffPackageMountDisplayViewModel\b/);
 assert.match(launchText, /\bgetShellSessionHandoffPackageMountRenderState\b/);
 assert.match(launchText, /\bisSupportedShellSessionHandoffPackage\b/);
+assert.match(launchText, /\bdata-handoff-mount\b/);
+assert.match(launchText, /\bdata-handoff-mount-status\b/);
+assert.match(launchText, /\bdata-handoff-mount-rows\b/);
 assert.match(launchText, /\blinuxCncIniPanelLaunchApi\b/);
 
 console.log("ini_panel_launch_api_manifest_node_smoke=ok");