推进 INI 面板 shell handoff package mount-state

2026-06-15 11:16:35 +08:00
parent 1d06fd4cd4
commit f548f24fb8
10 changed files with 427 additions and 4 deletions
--- a/wasm-port/tests/browser/ini_panel_launch_smoke.html
+++ b/wasm-port/tests/browser/ini_panel_launch_smoke.html
@@ -87,6 +87,7 @@
        !launchApi?.getShellSessionHandoffPackageReport ||
        !launchApi?.getShellSessionHandoffPackageDisplayViewModel ||
        !launchApi?.getShellSessionHandoffPackageRenderState ||
+        !launchApi?.getShellSessionHandoffPackageMountState ||
        !launchApi?.isSupportedShellSessionHandoffPackage ||
        !launchApi?.getLauncherLinks ||
        !launchApi?.getControlPageApiMethods
@@ -127,7 +128,7 @@
      );
      assertEqual(
        launchApiManifest.methods.join(","),
-        "isSupportedLaunchApiManifest,getLaunchApiSchema,getLaunchApiManifest,getShellIntegrationSchema,getShellIntegrationManifest,getShellIntegrationReadiness,getShellSessionHandoffSummarySchema,getShellSessionHandoffSummary,isSupportedShellSessionHandoffSummary,getShellSessionHandoffCompatibilityReport,getShellSessionHandoffDisplayViewModel,getShellSessionHandoffSnapshot,getShellSessionHandoffRenderState,getShellSessionHandoffActionPlan,getShellSessionHandoffChecklist,getShellSessionHandoffPackageSchema,getShellSessionHandoffPackage,getShellSessionHandoffPackageReport,getShellSessionHandoffPackageDisplayViewModel,getShellSessionHandoffPackageRenderState,isSupportedShellSessionHandoffPackage,getLauncherLinks,getControlPageApiMethods",
+        "isSupportedLaunchApiManifest,getLaunchApiSchema,getLaunchApiManifest,getShellIntegrationSchema,getShellIntegrationManifest,getShellIntegrationReadiness,getShellSessionHandoffSummarySchema,getShellSessionHandoffSummary,isSupportedShellSessionHandoffSummary,getShellSessionHandoffCompatibilityReport,getShellSessionHandoffDisplayViewModel,getShellSessionHandoffSnapshot,getShellSessionHandoffRenderState,getShellSessionHandoffActionPlan,getShellSessionHandoffChecklist,getShellSessionHandoffPackageSchema,getShellSessionHandoffPackage,getShellSessionHandoffPackageReport,getShellSessionHandoffPackageDisplayViewModel,getShellSessionHandoffPackageRenderState,getShellSessionHandoffPackageMountState,isSupportedShellSessionHandoffPackage,getLauncherLinks,getControlPageApiMethods",
        "launch API manifest methods",
      );
      const shellIntegrationSchema = launchApi.getShellIntegrationSchema();
@@ -146,6 +147,7 @@
      const shellSessionHandoffPackageReport = launchApi.getShellSessionHandoffPackageReport();
      const shellSessionHandoffPackageDisplayViewModel = launchApi.getShellSessionHandoffPackageDisplayViewModel();
      const shellSessionHandoffPackageRenderState = launchApi.getShellSessionHandoffPackageRenderState();
+      const shellSessionHandoffPackageMountState = launchApi.getShellSessionHandoffPackageMountState();
      assertEqual(
        shellIntegrationSchema.manifestVersion,
        1,
@@ -356,6 +358,31 @@
        shellSessionHandoffPackageDisplayViewModel.rows.length,
        "shell session handoff package render-state rows",
      );
+      assertEqual(
+        shellSessionHandoffPackageMountState.mountStateVersion,
+        1,
+        "shell session handoff package mount-state version",
+      );
+      assertEqual(
+        shellSessionHandoffPackageMountState.packageReady,
+        true,
+        "shell session handoff package mount-state package readiness",
+      );
+      assertEqual(
+        shellSessionHandoffPackageMountState.targetPage.href,
+        "./control-page.html",
+        "shell session handoff package mount-state target",
+      );
+      assertEqual(
+        shellSessionHandoffPackageMountState.requiredMethods.readStatus,
+        "readControlPageStatus",
+        "shell session handoff package mount-state read method",
+      );
+      assertEqual(
+        shellSessionHandoffPackageMountState.sessionLoadState.phase,
+        "waiting-panel",
+        "shell session handoff package mount-state default session",
+      );
      assertEqual(
        shellSessionHandoffPackage.ready,
        true,
--- a/wasm-port/tests/browser/ini_panel_shell_integration_workflow_smoke.html
+++ b/wasm-port/tests/browser/ini_panel_shell_integration_workflow_smoke.html
@@ -78,6 +78,7 @@ TOOL_TABLE = browser-shell-tool.tbl
        !launchApi?.getShellSessionHandoffPackageReport ||
        !launchApi?.getShellSessionHandoffPackageDisplayViewModel ||
        !launchApi?.getShellSessionHandoffPackageRenderState ||
+        !launchApi?.getShellSessionHandoffPackageMountState ||
        !launchApi?.isSupportedShellSessionHandoffPackage
      ) {
        throw new Error("launch API namespace did not expose shell integration helpers");
@@ -98,6 +99,7 @@ TOOL_TABLE = browser-shell-tool.tbl
      const handoffPackageReport = launchApi.getShellSessionHandoffPackageReport();
      const handoffPackageDisplay = launchApi.getShellSessionHandoffPackageDisplayViewModel();
      const handoffPackageRenderState = launchApi.getShellSessionHandoffPackageRenderState();
+      const handoffPackageMountState = launchApi.getShellSessionHandoffPackageMountState();
      assertEqual(handoffSummarySchema.summaryVersion, 1, "shell handoff summary schema version");
      assertEqual(
        launchApi.isSupportedShellSessionHandoffSummary(handoffSummary),
@@ -157,6 +159,9 @@ TOOL_TABLE = browser-shell-tool.tbl
        handoffPackageDisplay.rows.length,
        "shell handoff package render-state rows",
      );
+      assertEqual(handoffPackageMountState.packageReady, true, "shell handoff package mount-state package readiness");
+      assertEqual(handoffPackageMountState.targetPage.href, "./control-page.html", "shell handoff package mount-state target");
+      assertEqual(handoffPackageMountState.sessionLoadState.phase, "waiting-panel", "shell handoff package mount-state default session");
      assertEqual(handoffPackage.checklist.ready, handoffChecklist.ready, "shell handoff package checklist");
      assertEqual(
        handoffPackage.actionPlan.nextSteps.map(({ id }) => id).join(","),
@@ -229,6 +234,11 @@ TOOL_TABLE = browser-shell-tool.tbl
        "ready",
        "shell integration control-page session readiness",
      );
+      const readyMountState = launchApi.getShellSessionHandoffPackageMountState(
+        controlPageApi[handoffSummary.handoffMethods.loadSessionState](),
+      );
+      assertEqual(readyMountState.ready, true, "shell handoff package mount-state readiness");
+      assertEqual(readyMountState.sessionLoadState.phase, "ready", "shell handoff package mount-state ready session");
      assertEqual(
        controlPageApi[handoffSummary.handoffMethods.readStatus]().status.lastAction,
        null,
--- a/wasm-port/tests/ui/node/verify_ini_panel_entry_docs.mjs
+++ b/wasm-port/tests/ui/node/verify_ini_panel_entry_docs.mjs
@@ -24,6 +24,7 @@ import {
  createIniPanelShellSessionHandoffDisplayViewModel,
  createIniPanelShellSessionHandoffPackage,
  createIniPanelShellSessionHandoffPackageDisplayViewModel,
+  createIniPanelShellSessionHandoffPackageMountState,
  createIniPanelShellSessionHandoffPackageReport,
  createIniPanelShellSessionHandoffPackageRenderState,
  createIniPanelShellSessionHandoffPackageSchema,
@@ -86,6 +87,7 @@ const requiredShellExports = [
  "createIniPanelShellSessionHandoffDisplayViewModel",
  "createIniPanelShellSessionHandoffPackage",
  "createIniPanelShellSessionHandoffPackageDisplayViewModel",
+  "createIniPanelShellSessionHandoffPackageMountState",
  "createIniPanelShellSessionHandoffPackageReport",
  "createIniPanelShellSessionHandoffPackageRenderState",
  "createIniPanelShellSessionHandoffPackageSchema",
@@ -252,6 +254,13 @@ assert.deepEqual(
    createIniPanelShellViewModel().shellSessionHandoffPackageDisplayViewModel,
  ),
 );
+assert.deepEqual(
+  createIniPanelShellViewModel().shellSessionHandoffPackageMountState,
+  createIniPanelShellSessionHandoffPackageMountState({
+    handoffPackage: createIniPanelShellViewModel().shellSessionHandoffPackage,
+    packageRenderState: createIniPanelShellViewModel().shellSessionHandoffPackageRenderState,
+  }),
+);
 assert.equal(isSupportedIniPanelShellSessionHandoffPackage(createIniPanelShellViewModel().shellSessionHandoffPackage), true);
 assert.equal(isSupportedIniPanelShellIntegrationManifest(createIniPanelShellViewModel().shellIntegrationManifest), true);
 assert.deepEqual(createIniPanelShellViewModel().launchApiSchema, createIniPanelLaunchApiSchema());
--- 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
@@ -60,6 +60,7 @@ assert.deepEqual(manifest, {
    "getShellSessionHandoffPackageReport",
    "getShellSessionHandoffPackageDisplayViewModel",
    "getShellSessionHandoffPackageRenderState",
+    "getShellSessionHandoffPackageMountState",
    "isSupportedShellSessionHandoffPackage",
    "getLauncherLinks",
    "getControlPageApiMethods",
@@ -175,6 +176,7 @@ assert.match(launchText, /\bgetShellSessionHandoffPackage\b/);
 assert.match(launchText, /\bgetShellSessionHandoffPackageReport\b/);
 assert.match(launchText, /\bgetShellSessionHandoffPackageDisplayViewModel\b/);
 assert.match(launchText, /\bgetShellSessionHandoffPackageRenderState\b/);
+assert.match(launchText, /\bgetShellSessionHandoffPackageMountState\b/);
 assert.match(launchText, /\bisSupportedShellSessionHandoffPackage\b/);
 assert.match(launchText, /\blinuxCncIniPanelLaunchApi\b/);

--- a/wasm-port/tests/ui/node/verify_ini_panel_shell_integration_manifest.mjs
+++ b/wasm-port/tests/ui/node/verify_ini_panel_shell_integration_manifest.mjs
@@ -20,6 +20,7 @@ import {
  createIniPanelShellSessionHandoffDisplayViewModel,
  createIniPanelShellSessionHandoffPackage,
  createIniPanelShellSessionHandoffPackageDisplayViewModel,
+  createIniPanelShellSessionHandoffPackageMountState,
  createIniPanelShellSessionHandoffPackageReport,
  createIniPanelShellSessionHandoffPackageRenderState,
  createIniPanelShellSessionHandoffPackageSchema,
@@ -27,6 +28,7 @@ import {
  createIniPanelShellSessionHandoffSnapshot,
  createIniPanelShellSessionHandoffSummary,
  createIniPanelShellSessionHandoffSummarySchema,
+  createControlPageSessionLoadState,
  getVisibleIniPanelEntries,
  isSupportedIniPanelShellIntegrationManifest,
  isSupportedIniPanelShellSessionHandoffPackage,
@@ -79,6 +81,10 @@ const handoffPackageDisplayViewModel = createIniPanelShellSessionHandoffPackageD
 const handoffPackageRenderState = createIniPanelShellSessionHandoffPackageRenderState(
  handoffPackageDisplayViewModel,
 );
+const handoffPackageMountState = createIniPanelShellSessionHandoffPackageMountState({
+  handoffPackage,
+  packageRenderState: handoffPackageRenderState,
+});

 assert.deepEqual(schema, {
  apiName: "ini-panel-shell-integration",
@@ -134,7 +140,7 @@ assert.deepEqual(readiness, {
  counts: {
    pages: 2,
    launcherLinks: 2,
-    launchMethods: 23,
+    launchMethods: 24,
    controlPageMethods: 11,
    persistenceCapabilities: 3,
  },
@@ -196,7 +202,7 @@ assert.deepEqual(handoffSummary, {
    counts: {
      pages: 2,
      launcherLinks: 2,
-      launchMethods: 23,
+      launchMethods: 24,
      controlPageMethods: 11,
      persistenceCapabilities: 3,
    },
@@ -575,6 +581,100 @@ assert.deepEqual(handoffPackageRenderState, {
    handoffScope: "package",
  },
 });
+assert.deepEqual(handoffPackageMountState, {
+  apiName: "ini-panel-shell-session-handoff-package-mount-state",
+  mountStateVersion: 1,
+  phase: "blocked",
+  ready: false,
+  packageReady: true,
+  targetReady: true,
+  methodsReady: true,
+  sessionReady: false,
+  statusLine: "Blocked: waiting-panel",
+  packageRenderState: handoffPackageRenderState,
+  targetPage: {
+    entryId: "control-view",
+    href: "./control-page.html",
+  },
+  requiredMethods: {
+    loadSessionState: "loadControlPageSessionState",
+    readStatus: "readControlPageStatus",
+  },
+  sessionLoadState: createControlPageSessionLoadState({ phase: "waiting-panel" }),
+  blockingReasons: [],
+  checks: [
+    {
+      id: "package-render-state",
+      label: "Package render state",
+      status: "pass",
+      value: "Ready: No blocking reasons",
+    },
+    {
+      id: "target-page",
+      label: "Control target",
+      status: "pass",
+      value: "./control-page.html",
+    },
+    {
+      id: "required-methods",
+      label: "Readonly methods",
+      status: "pass",
+      value: "loadControlPageSessionState, readControlPageStatus",
+    },
+    {
+      id: "session-load-state",
+      label: "Session load state",
+      status: "blocked",
+      value: "waiting-panel",
+    },
+    {
+      id: "blocking-reasons",
+      label: "Blocking reasons",
+      status: "pass",
+      value: "none",
+    },
+  ],
+});
+assert.deepEqual(
+  createIniPanelShellSessionHandoffPackageMountState({
+    handoffPackage,
+    packageRenderState: handoffPackageRenderState,
+    sessionLoadState: createControlPageSessionLoadState({
+      phase: "ready",
+      panelReady: true,
+      apiReady: true,
+      controlViewReady: true,
+      controlView: { status: { runStatus: "not-run" } },
+    }),
+  }).checks.map(({ id, status, value }) => ({ id, status, value })),
+  [
+    {
+      id: "package-render-state",
+      status: "pass",
+      value: "Ready: No blocking reasons",
+    },
+    {
+      id: "target-page",
+      status: "pass",
+      value: "./control-page.html",
+    },
+    {
+      id: "required-methods",
+      status: "pass",
+      value: "loadControlPageSessionState, readControlPageStatus",
+    },
+    {
+      id: "session-load-state",
+      status: "pass",
+      value: "ready",
+    },
+    {
+      id: "blocking-reasons",
+      status: "pass",
+      value: "none",
+    },
+  ],
+);
 assert.equal(isSupportedIniPanelShellSessionHandoffPackage(handoffPackage), true);
 assert.equal(
  isSupportedIniPanelShellSessionHandoffPackage({ ...handoffPackage, packageVersion: 2 }),
@@ -673,6 +773,16 @@ assert.deepEqual(
    },
  },
 );
+assert.deepEqual(
+  createIniPanelShellSessionHandoffPackageMountState({
+    handoffPackage: { ...handoffPackage, ready: false },
+    packageRenderState: createIniPanelShellSessionHandoffPackageRenderState(createIniPanelShellSessionHandoffPackageDisplayViewModel(
+      createIniPanelShellSessionHandoffPackageReport({ ...handoffPackage, packageVersion: 2 }),
+    )),
+    sessionLoadState: createControlPageSessionLoadState({ phase: "error", error: "boom" }),
+  }).blockingReasons,
+  ["controlPageSessionError"],
+);
 assert.deepEqual(
  createIniPanelShellSessionHandoffPackageReport(missingManifestField).missingManifestFields,
  ["controlPageMethods"],
@@ -904,7 +1014,7 @@ assert.deepEqual(createIniPanelShellIntegrationReadiness(blockedManifest), {
  counts: {
    pages: 2,
    launcherLinks: 2,
-    launchMethods: 23,
+    launchMethods: 24,
    controlPageMethods: 11,
    persistenceCapabilities: 3,
  },
@@ -1070,6 +1180,7 @@ assert.match(shellText, /\bexport function createIniPanelShellSessionHandoffComp
 assert.match(shellText, /\bexport function createIniPanelShellSessionHandoffDisplayViewModel\b/);
 assert.match(shellText, /\bexport function createIniPanelShellSessionHandoffPackage\b/);
 assert.match(shellText, /\bexport function createIniPanelShellSessionHandoffPackageDisplayViewModel\b/);
+assert.match(shellText, /\bexport function createIniPanelShellSessionHandoffPackageMountState\b/);
 assert.match(shellText, /\bexport function createIniPanelShellSessionHandoffPackageReport\b/);
 assert.match(shellText, /\bexport function createIniPanelShellSessionHandoffPackageRenderState\b/);
 assert.match(shellText, /\bexport function createIniPanelShellSessionHandoffPackageSchema\b/);
@@ -1092,6 +1203,7 @@ assert.match(docText, /\bcreateIniPanelShellSessionHandoffCompatibilityReport\b/
 assert.match(docText, /\bcreateIniPanelShellSessionHandoffDisplayViewModel\b/);
 assert.match(docText, /\bcreateIniPanelShellSessionHandoffPackage\b/);
 assert.match(docText, /\bcreateIniPanelShellSessionHandoffPackageDisplayViewModel\b/);
+assert.match(docText, /\bcreateIniPanelShellSessionHandoffPackageMountState\b/);
 assert.match(docText, /\bcreateIniPanelShellSessionHandoffPackageReport\b/);
 assert.match(docText, /\bcreateIniPanelShellSessionHandoffPackageRenderState\b/);
 assert.match(docText, /\bcreateIniPanelShellSessionHandoffPackageSchema\b/);
--- a/wasm-port/tests/ui/node/verify_ini_panel_ui_shell.mjs
+++ b/wasm-port/tests/ui/node/verify_ini_panel_ui_shell.mjs
@@ -20,6 +20,7 @@ import {
  createIniPanelShellSessionHandoffDisplayViewModel,
  createIniPanelShellSessionHandoffPackage,
  createIniPanelShellSessionHandoffPackageDisplayViewModel,
+  createIniPanelShellSessionHandoffPackageMountState,
  createIniPanelShellSessionHandoffPackageReport,
  createIniPanelShellSessionHandoffPackageRenderState,
  createIniPanelShellSessionHandoffPackageSchema,
@@ -87,6 +88,7 @@ assert.equal(typeof createIniPanelShellSessionHandoffCompatibilityReport, "funct
 assert.equal(typeof createIniPanelShellSessionHandoffDisplayViewModel, "function");
 assert.equal(typeof createIniPanelShellSessionHandoffPackage, "function");
 assert.equal(typeof createIniPanelShellSessionHandoffPackageDisplayViewModel, "function");
+assert.equal(typeof createIniPanelShellSessionHandoffPackageMountState, "function");
 assert.equal(typeof createIniPanelShellSessionHandoffPackageReport, "function");
 assert.equal(typeof createIniPanelShellSessionHandoffPackageRenderState, "function");
 assert.equal(typeof createIniPanelShellSessionHandoffPackageSchema, "function");
@@ -222,6 +224,13 @@ assert.deepEqual(
  shellViewModel.shellSessionHandoffPackageRenderState,
  createIniPanelShellSessionHandoffPackageRenderState(shellViewModel.shellSessionHandoffPackageDisplayViewModel),
 );
+assert.deepEqual(
+  shellViewModel.shellSessionHandoffPackageMountState,
+  createIniPanelShellSessionHandoffPackageMountState({
+    handoffPackage: shellViewModel.shellSessionHandoffPackage,
+    packageRenderState: shellViewModel.shellSessionHandoffPackageRenderState,
+  }),
+);
 assert.equal(isSupportedIniPanelShellSessionHandoffPackage(shellViewModel.shellSessionHandoffPackage), true);
 assert.deepEqual(shellViewModel.shellSessionHandoffDisplayViewModel, {
  phase: "ready",
@@ -464,6 +473,74 @@ assert.deepEqual(shellViewModel.shellSessionHandoffPackageRenderState, {
    handoffScope: "package",
  },
 });
+assert.deepEqual(shellViewModel.shellSessionHandoffPackageMountState, {
+  apiName: "ini-panel-shell-session-handoff-package-mount-state",
+  mountStateVersion: 1,
+  phase: "blocked",
+  ready: false,
+  packageReady: true,
+  targetReady: true,
+  methodsReady: true,
+  sessionReady: false,
+  statusLine: "Blocked: waiting-panel",
+  packageRenderState: shellViewModel.shellSessionHandoffPackageRenderState,
+  targetPage: {
+    entryId: "control-view",
+    href: "./control-page.html",
+  },
+  requiredMethods: {
+    loadSessionState: "loadControlPageSessionState",
+    readStatus: "readControlPageStatus",
+  },
+  sessionLoadState: createControlPageSessionLoadState({ phase: "waiting-panel" }),
+  blockingReasons: [],
+  checks: [
+    {
+      id: "package-render-state",
+      label: "Package render state",
+      status: "pass",
+      value: "Ready: No blocking reasons",
+    },
+    {
+      id: "target-page",
+      label: "Control target",
+      status: "pass",
+      value: "./control-page.html",
+    },
+    {
+      id: "required-methods",
+      label: "Readonly methods",
+      status: "pass",
+      value: "loadControlPageSessionState, readControlPageStatus",
+    },
+    {
+      id: "session-load-state",
+      label: "Session load state",
+      status: "blocked",
+      value: "waiting-panel",
+    },
+    {
+      id: "blocking-reasons",
+      label: "Blocking reasons",
+      status: "pass",
+      value: "none",
+    },
+  ],
+});
+assert.equal(
+  createIniPanelShellSessionHandoffPackageMountState({
+    handoffPackage: shellViewModel.shellSessionHandoffPackage,
+    packageRenderState: shellViewModel.shellSessionHandoffPackageRenderState,
+    sessionLoadState: createControlPageSessionLoadState({
+      phase: "ready",
+      panelReady: true,
+      apiReady: true,
+      controlViewReady: true,
+      controlView: { status: { runStatus: "not-run" } },
+    }),
+  }).ready,
+  true,
+);
 assert.equal(
  isSupportedIniPanelShellIntegrationManifest(shellViewModel.shellIntegrationManifest),
  true,
@@ -520,6 +597,10 @@ assert.equal(
  shellViewModel.createShellSessionHandoffPackageRenderState,
  createIniPanelShellSessionHandoffPackageRenderState,
 );
+assert.equal(
+  shellViewModel.createShellSessionHandoffPackageMountState,
+  createIniPanelShellSessionHandoffPackageMountState,
+);
 assert.equal(shellViewModel.createShellSessionHandoffPackageReport, createIniPanelShellSessionHandoffPackageReport);
 assert.equal(shellViewModel.createShellSessionHandoffPackageSchema, createIniPanelShellSessionHandoffPackageSchema);
 assert.equal(shellViewModel.isSupportedShellSessionHandoffPackage, isSupportedIniPanelShellSessionHandoffPackage);