推进 INI 面板 launch 暴露 control-page API 清单

wasm-port/docs/panel-entry.md

@@ -10,6 +10,7 @@ control view:
 ```js
 import {
   INI_PANEL_ENTRIES,
+  createControlPageBrowserApiMethods,
   createIniPanelLauncherLinkViewModel,
   createIniPanelShellControlPageContract,
   createIniPanelShellViewModel,
@@ -77,6 +78,9 @@ control page API.
 Use `linuxCncIniPanelControlPageApi.readControlPageStatus()` when a browser
 outer page needs the same readonly status snapshot from the real embedded
 control page after save/load session workflows.
+The launch page exposes `linuxCncIniPanelLaunchApi.getControlPageApiMethods()`
+from the same shell view-model so entry pages can consume the available
+read-only control-page API list without loading the control-page iframe first.
 
 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

@@ -5,6 +5,7 @@ import {
   createMachineSessionControlPageController,
 } from "./control-page-controller.js";
 import {
+  createControlPageBrowserApiMethods,
   createIniPanelShellControlPageContract,
 } from "./ui-shell.js";
 
@@ -21,19 +22,6 @@ const controller = createMachineSessionControlPageController({
 
 controller.mount();
 
-export function createControlPageBrowserApiMethods() {
-  return [
-    "getControlPageApiMethods",
-    "getControlPageContract",
-    "getControlView",
-    "getPanelApi",
-    "loadControlPageSessionState",
-    "readControlPageStatus",
-    "refreshControlPage",
-    "renderControlPage",
-  ];
-}
-
 window.linuxCncIniPanelControlPageApi = {
   getControlPageApiMethods: createControlPageBrowserApiMethods,
   getControlView: controller.getControlView,

wasm-port/runtime/ui/ini-panel/launch.html

@@ -73,9 +73,13 @@
     </section>
   </main>
   <script type="module">
-    import { createIniPanelLauncherLinkViewModel } from "./ui-shell.js";
+    import {
+      createIniPanelLauncherLinkViewModel,
+      createIniPanelShellViewModel,
+    } from "./ui-shell.js";
 
-    const links = createIniPanelLauncherLinkViewModel();
+    const shellViewModel = createIniPanelShellViewModel();
+    const links = shellViewModel.launcherLinks;
     for (const linkModel of links) {
       const link = document.querySelector(`a[data-entry-id="${linkModel.entryId}"]`);
       if (!link) {
@@ -84,6 +88,11 @@
       link.textContent = linkModel.label;
       link.href = linkModel.href;
     }
+
+    window.linuxCncIniPanelLaunchApi = {
+      getLauncherLinks: () => shellViewModel.launcherLinks,
+      getControlPageApiMethods: () => shellViewModel.controlPage.browserApiMethods,
+    };
   </script>
 </body>
 </html>

wasm-port/runtime/ui/ini-panel/ui-shell.js

@@ -78,6 +78,19 @@ export function createIniPanelShellControlPageContract() {
   };
 }
 
+export function createControlPageBrowserApiMethods() {
+  return [
+    "getControlPageApiMethods",
+    "getControlPageContract",
+    "getControlView",
+    "getPanelApi",
+    "loadControlPageSessionState",
+    "readControlPageStatus",
+    "refreshControlPage",
+    "renderControlPage",
+  ];
+}
+
 export function createIniPanelShellViewModel(entries = getVisibleIniPanelEntries()) {
   return {
     pages: entries.map(({ id, href, title }) => ({
@@ -87,6 +100,7 @@ export function createIniPanelShellViewModel(entries = getVisibleIniPanelEntries
     })),
     launcherLinks: createIniPanelLauncherLinkViewModel(entries),
     controlPage: {
+      browserApiMethods: createControlPageBrowserApiMethods(),
       contract: createIniPanelShellControlPageContract(),
       createController: createMachineSessionControlPageController,
       loadSessionState: loadMachineSessionForControlPageWorkflow,

wasm-port/tests/browser/ini_panel_launch_smoke.html

@@ -8,7 +8,9 @@
   <pre id="status">running</pre>
   <script type="module">
     import {
+      createControlPageBrowserApiMethods,
       createIniPanelLauncherLinkViewModel,
+      createIniPanelShellViewModel,
       getIniPanelEntryByHref,
       getVisibleIniPanelEntries,
     } from "../../runtime/ui/ini-panel/ui-shell.js";
@@ -44,8 +46,17 @@
         "Open read-only control view",
         "launch manifest control entry",
       );
+      assertEqual(
+        createIniPanelShellViewModel().controlPage.browserApiMethods.join(","),
+        createControlPageBrowserApiMethods().join(","),
+        "launch shell control-page browser API methods",
+      );
 
       const launchDoc = await loadLaunchFrame();
+      const launchApi = launchDoc.defaultView.linuxCncIniPanelLaunchApi;
+      if (!launchApi?.getLauncherLinks || !launchApi?.getControlPageApiMethods) {
+        throw new Error("launch API namespace did not expose shell helpers");
+      }
       assertEqual(
         launchDoc.querySelector('a[href="./index.html"]').textContent,
         "Open edit and run panel",
@@ -56,6 +67,16 @@
         "Open read-only control view",
         "launch panel control link",
       );
+      assertEqual(
+        launchApi.getLauncherLinks().length,
+        2,
+        "launch API launcher link count",
+      );
+      assertEqual(
+        launchApi.getControlPageApiMethods().join(","),
+        createControlPageBrowserApiMethods().join(","),
+        "launch API control-page browser methods",
+      );
       status.textContent = "browser_ini_launch_smoke=ok";
       console.log("browser_ini_launch_smoke=ok");
     } catch (error) {

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

@@ -7,6 +7,7 @@ import {
   INI_PANEL_ENTRIES,
   controlPageStatusText,
   createControlPageSessionLoadState,
+  createControlPageBrowserApiMethods,
   createIniPanelLauncherLinkViewModel,
   createIniPanelShellControlPageContract,
   createIniPanelShellViewModel,
@@ -23,6 +24,7 @@ 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 launchText = readFileSync(resolve(root, "runtime/ui/ini-panel/launch.html"), "utf8");
 const refreshWorkflowText = readFileSync(
   resolve(root, "runtime/ui/ini-panel/control-page-refresh-workflow.js"),
   "utf8",
@@ -35,6 +37,7 @@ const sessionWorkflowText = readFileSync(
 const requiredShellExports = [
   "INI_PANEL_ENTRIES",
   "controlPageStatusText",
+  "createControlPageBrowserApiMethods",
   "createControlPageSessionLoadState",
   "createIniPanelLauncherLinkViewModel",
   "createIniPanelShellControlPageContract",
@@ -97,6 +100,10 @@ assert.deepEqual(
   createIniPanelShellViewModel().controlPage.contract,
   createIniPanelShellControlPageContract(),
 );
+assert.deepEqual(
+  createIniPanelShellViewModel().controlPage.browserApiMethods,
+  createControlPageBrowserApiMethods(),
+);
 assert.equal(controlPageStatusText({ lastAction: "run-gcode", runStatus: "ok", error: null }), "run-gcode | ok | -");
 assert.deepEqual(createControlPageSessionLoadState({ phase: "waiting-panel" }), {
   phase: "waiting-panel",
@@ -120,14 +127,17 @@ assert.deepEqual(
 assert.equal(createIniPanelShellViewModel().controlPage.readStatus, readMachineSessionReadonlyStatus);
 assert.equal(createIniPanelShellViewModel().controlPage.refresh, refreshMachineSessionControlPage);
 assert.equal(typeof createIniPanelShellViewModel().controlPage.renderView, "function");
-assert.match(controlPageText, /\bexport function createControlPageBrowserApiMethods\b/);
+assert.match(shellText, /\bexport function createControlPageBrowserApiMethods\b/);
 assert.match(controlPageText, /\bgetControlPageApiMethods\b/);
+assert.match(launchText, /\blinuxCncIniPanelLaunchApi\b/);
+assert.match(launchText, /\bgetControlPageApiMethods\b/);
 assert.match(controlPageText, /\bgetControlPageContract\b/);
 assert.match(controlPageText, /\breadControlPageStatus\b/);
 assert.match(controlPageText, /\bcreateIniPanelShellControlPageContract\b/);
 assert.match(docText, /\blinuxCncIniPanelControlPageApi\.getControlPageApiMethods\b/);
 assert.match(docText, /\blinuxCncIniPanelControlPageApi\.getControlPageContract\b/);
 assert.match(docText, /\blinuxCncIniPanelControlPageApi\.readControlPageStatus\b/);
+assert.match(docText, /\blinuxCncIniPanelLaunchApi\.getControlPageApiMethods\b/);
 
 for (const entry of INI_PANEL_ENTRIES) {
   const escapedHref = entry.href.replace(".", "\\.");

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

@@ -4,6 +4,7 @@ import { dirname, resolve } from "node:path";
 import { fileURLToPath } from "node:url";
 
 import {
+  createControlPageBrowserApiMethods,
   createIniPanelShellControlPageContract,
   createIniPanelShellViewModel,
   createMachineSessionControlPageController,
@@ -55,6 +56,7 @@ assert.deepEqual(contract, {
 
 const shellViewModel = createIniPanelShellViewModel();
 assert.deepEqual(Object.keys(shellViewModel.controlPage), [
+  "browserApiMethods",
   "contract",
   "createController",
   "loadSessionState",
@@ -63,6 +65,7 @@ assert.deepEqual(Object.keys(shellViewModel.controlPage), [
   "refresh",
   "renderView",
 ]);
+assert.deepEqual(shellViewModel.controlPage.browserApiMethods, createControlPageBrowserApiMethods());
 assert.deepEqual(shellViewModel.controlPage.contract, contract);
 assert.deepEqual(shellViewModel.controlPage.readonlyStatusApiManifest, manifest);
 assert.equal(shellViewModel.controlPage.createController, createMachineSessionControlPageController);
@@ -81,6 +84,7 @@ for (const fieldName of contract.readonlyStatusApiStatusFields) {
 }
 
 assert.match(shellText, /\bexport function createIniPanelShellControlPageContract\b/);
+assert.match(shellText, /\bexport function createControlPageBrowserApiMethods\b/);
 assert.match(docText, /\bcreateIniPanelShellControlPageContract\b/);
 assert.match(docText, /\bcontrolPage\.contract\b/);
 assert.doesNotMatch(shellText, /\bparseGcode\b|\bcanonicalEvents\b|\btoolTable\b|\bplanner\b/);

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

@@ -3,6 +3,7 @@ import assert from "node:assert/strict";
 import {
   INI_PANEL_ENTRIES,
   controlPageStatusText,
+  createControlPageBrowserApiMethods,
   createIniPanelLauncherLinkViewModel,
   createIniPanelShellControlPageContract,
   createIniPanelShellViewModel,
@@ -44,6 +45,7 @@ assert.equal(getIniPanelEntryByHref("./index.html")?.id, "edit-run");
 assert.equal(typeof createMachineSessionControlPageController, "function");
 assert.equal(typeof createMachineSessionReadonlyStatus, "function");
 assert.equal(typeof createMachineSessionReadonlyStatusApiManifest, "function");
+assert.equal(typeof createControlPageBrowserApiMethods, "function");
 assert.equal(typeof createIniPanelShellControlPageContract, "function");
 assert.equal(typeof loadMachineSessionForControlPageWorkflow, "function");
 assert.equal(typeof readMachineSessionReadonlyStatus, "function");
@@ -85,6 +87,7 @@ assert.deepEqual(shellViewModel.pages, [
   },
 ]);
 assert.deepEqual(shellViewModel.launcherLinks, createIniPanelLauncherLinkViewModel());
+assert.deepEqual(shellViewModel.controlPage.browserApiMethods, createControlPageBrowserApiMethods());
 assert.equal(shellViewModel.controlPage.createController, createMachineSessionControlPageController);
 assert.deepEqual(shellViewModel.controlPage.contract, createIniPanelShellControlPageContract());
 assert.equal(shellViewModel.controlPage.loadSessionState, loadMachineSessionForControlPageWorkflow);