推进 INI 面板浏览器 control-page contract 暴露

wasm-port/docs/panel-entry.md

@@ -68,6 +68,9 @@ manifest, and its status fields before mounting the embedded panel. The
 contract lists readonly status fields for `stateBundle`, `workflowStatus`,
 `overview`, `controlView`, `report`, `runReadiness`, `run`, `session`, and
 `status`.
+The browser control page also exposes this contract through
+`linuxCncIniPanelControlPageApi.getControlPageContract()`, so real iframe-based
+smokes can verify the same API shape before reading the embedded panel state.
 
 The control-page refresh workflow lives in
 `runtime/ui/ini-panel/control-page-refresh-workflow.js`. Use

wasm-port/runtime/ui/ini-panel/control-page.js

@@ -4,6 +4,9 @@ import {
 import {
   createMachineSessionControlPageController,
 } from "./control-page-controller.js";
+import {
+  createIniPanelShellControlPageContract,
+} from "./ui-shell.js";
 
 const panelFrameNode = document.getElementById("panel-frame");
 const statusNode = document.getElementById("control-page-status");
@@ -20,6 +23,7 @@ controller.mount();
 
 window.linuxCncIniPanelControlPageApi = {
   getControlView: controller.getControlView,
+  getControlPageContract: createIniPanelShellControlPageContract,
   getPanelApi: controller.getPanelApi,
   loadControlPageSessionState: controller.loadSessionState,
   refreshControlPage: controller.refresh,

wasm-port/tests/browser/ini_panel_control_page_smoke.html

@@ -63,6 +63,7 @@ TOOL_TABLE = browser-tool.tbl
       const controlPageApi = controlDoc.defaultView.linuxCncIniPanelControlPageApi;
       if (
         !controlPageApi?.getControlView ||
+        !controlPageApi?.getControlPageContract ||
         !controlPageApi?.getPanelApi ||
         !controlPageApi?.loadControlPageSessionState ||
         !controlPageApi?.refreshControlPage ||
@@ -71,6 +72,33 @@ TOOL_TABLE = browser-tool.tbl
         throw new Error("control page API namespace did not expose control helpers");
       }
 
+      const controlPageContract = controlPageApi.getControlPageContract();
+      assertEqual(
+        controlPageContract.methodNames.join(","),
+        "createController,loadSessionState,readStatus,refresh,renderView",
+        "control page contract methods",
+      );
+      assertEqual(
+        controlPageContract.readonlyStatusApiManifest.apiName,
+        "machine-session-readonly-status",
+        "control page contract readonly status API name",
+      );
+      assertEqual(
+        controlPageContract.readonlyStatusApiMethodNames.join(","),
+        "readStatus",
+        "control page contract readonly status API methods",
+      );
+      assertEqual(
+        controlPageContract.relatedControlPageMethods.join(","),
+        "loadSessionState,readStatus,refresh,renderView",
+        "control page contract related methods",
+      );
+      assertEqual(
+        controlPageContract.readonlyStatusApiStatusFields.join(","),
+        "stateBundle,workflowStatus,overview,controlView,report,runReadiness,run,session,status",
+        "control page contract readonly status fields",
+      );
+
       const panelFrame = controlDoc.getElementById("panel-frame");
       const panelDoc = await waitFor(
         () => panelFrame?.contentDocument,

wasm-port/tests/ui/node/verify_ini_panel_entry_docs.mjs

@@ -22,6 +22,7 @@ const __dirname = dirname(fileURLToPath(import.meta.url));
 const root = resolve(__dirname, "../../..");
 const docText = readFileSync(resolve(root, "docs/panel-entry.md"), "utf8");
 const shellText = readFileSync(resolve(root, "runtime/ui/ini-panel/ui-shell.js"), "utf8");
+const controlPageText = readFileSync(resolve(root, "runtime/ui/ini-panel/control-page.js"), "utf8");
 const refreshWorkflowText = readFileSync(
   resolve(root, "runtime/ui/ini-panel/control-page-refresh-workflow.js"),
   "utf8",
@@ -119,6 +120,9 @@ assert.deepEqual(
 assert.equal(createIniPanelShellViewModel().controlPage.readStatus, readMachineSessionReadonlyStatus);
 assert.equal(createIniPanelShellViewModel().controlPage.refresh, refreshMachineSessionControlPage);
 assert.equal(typeof createIniPanelShellViewModel().controlPage.renderView, "function");
+assert.match(controlPageText, /\bgetControlPageContract\b/);
+assert.match(controlPageText, /\bcreateIniPanelShellControlPageContract\b/);
+assert.match(docText, /\blinuxCncIniPanelControlPageApi\.getControlPageContract\b/);
 
 for (const entry of INI_PANEL_ENTRIES) {
   const escapedHref = entry.href.replace(".", "\\.");