推进 INI 面板 workflow overview embedding mount result

This commit is contained in:
2026-06-15 20:35:39 +08:00
parent 75f71c2563
commit 83df80d00f
12 changed files with 245 additions and 5 deletions

View File

@@ -48,6 +48,7 @@ import {
createIniPanelShellWorkflowOverviewEmbeddingDomReadiness,
mountIniPanelShellWorkflowOverviewEmbedding,
renderIniPanelShellWorkflowOverviewEmbeddingState,
mountIniPanelShellWorkflowOverviewEmbeddingState,
renderIniPanelShellSessionHandoffWorkflowState,
mountIniPanelShellSessionHandoffWorkflow,
renderIniPanelShellSessionHandoffMountState,
@@ -344,6 +345,12 @@ outer shell needs to render an embedding report render-state into existing
mount/status/rows nodes and receive a structured read-only render result. The
workflow overview page also exposes
`linuxCncIniPanelWorkflowOverviewApi.renderWorkflowOverviewEmbeddingState()`.
Use `mountIniPanelShellWorkflowOverviewEmbeddingState()` or
`linuxCncIniPanelLaunchApi.mountWorkflowOverviewEmbeddingState()` when an outer
shell needs a non-throwing workflow result that combines embedding DOM
readiness, render-state, render result, and any render error as structured
data. The workflow overview page also exposes
`linuxCncIniPanelWorkflowOverviewApi.mountWorkflowOverviewEmbeddingState()`.
Use
`renderIniPanelShellSessionHandoffMountState()` or
`linuxCncIniPanelLaunchApi.renderShellSessionHandoffMountState()` when an outer

View File

@@ -297,6 +297,11 @@
renderWorkflowOverviewEmbeddingState: (renderState, options) => (
shellViewModel.renderWorkflowOverviewEmbeddingState(renderState, options ?? { documentRef: document })
),
mountWorkflowOverviewEmbeddingState: (options) => (
shellViewModel.mountWorkflowOverviewEmbeddingState(options ?? {
documentRef: document,
})
),
isSupportedShellSessionHandoffPackage: shellViewModel.isSupportedShellSessionHandoffPackage,
getLauncherLinks: () => shellViewModel.launcherLinks,
getControlPageApiMethods: () => shellViewModel.controlPage.browserApiMethods,

View File

@@ -165,6 +165,7 @@ export function createIniPanelLaunchApiManifest(entries = getVisibleIniPanelEntr
"getWorkflowOverviewEmbeddingDomContract",
"getWorkflowOverviewEmbeddingDomReadiness",
"renderWorkflowOverviewEmbeddingState",
"mountWorkflowOverviewEmbeddingState",
"isSupportedShellSessionHandoffPackage",
"getLauncherLinks",
"getControlPageApiMethods",
@@ -2059,6 +2060,73 @@ export function renderIniPanelShellWorkflowOverviewEmbeddingState(
};
}
export function mountIniPanelShellWorkflowOverviewEmbeddingState({
renderState = createIniPanelShellWorkflowOverviewEmbeddingRenderState(),
rowDatasetPrefix = "workflowOverviewEmbedding",
contract = createIniPanelShellWorkflowOverviewEmbeddingDomContract({ rowDatasetPrefix }),
documentRef = globalThis.document,
mountNode = documentRef?.querySelector?.(contract.selectors.mount),
statusNode = documentRef?.querySelector?.(contract.selectors.status),
rowsNode = documentRef?.querySelector?.(contract.selectors.rows),
} = {}) {
const domReadiness = createIniPanelShellWorkflowOverviewEmbeddingDomReadiness({
contract,
documentRef,
mountNode,
statusNode,
rowsNode,
});
if (!domReadiness.ready) {
return {
apiName: "ini-panel-shell-workflow-overview-embedding-dom-mount",
workflowVersion: 1,
phase: "blocked",
ready: false,
statusLine: `Blocked: ${domReadiness.missing.join(", ")}`,
contract,
domReadiness,
renderState,
renderResult: null,
error: null,
};
}
try {
const renderResult = renderIniPanelShellWorkflowOverviewEmbeddingState(renderState, {
contract,
documentRef,
mountNode,
statusNode,
rowsNode,
});
return {
apiName: "ini-panel-shell-workflow-overview-embedding-dom-mount",
workflowVersion: 1,
phase: renderState?.phase === "ready" ? "ready" : "blocked",
ready: renderState?.ready === true,
statusLine: renderResult.statusLine,
contract,
domReadiness,
renderState,
renderResult,
error: null,
};
} catch (error) {
return {
apiName: "ini-panel-shell-workflow-overview-embedding-dom-mount",
workflowVersion: 1,
phase: "blocked",
ready: false,
statusLine: `Blocked: ${error?.message ?? "workflow overview embedding DOM mount error"}`,
contract,
domReadiness,
renderState,
renderResult: null,
error: error?.message ?? String(error),
};
}
}
export function createIniPanelShellViewModel(entries = getVisibleIniPanelEntries()) {
const shellIntegrationManifest = createIniPanelShellIntegrationManifest(entries);
const shellIntegrationReadiness = createIniPanelShellIntegrationReadiness(shellIntegrationManifest);
@@ -2223,6 +2291,7 @@ export function createIniPanelShellViewModel(entries = getVisibleIniPanelEntries
createWorkflowOverviewEmbeddingDomContract: createIniPanelShellWorkflowOverviewEmbeddingDomContract,
createWorkflowOverviewEmbeddingDomReadiness: createIniPanelShellWorkflowOverviewEmbeddingDomReadiness,
renderWorkflowOverviewEmbeddingState: renderIniPanelShellWorkflowOverviewEmbeddingState,
mountWorkflowOverviewEmbeddingState: mountIniPanelShellWorkflowOverviewEmbeddingState,
isSupportedShellSessionHandoffPackage: isSupportedIniPanelShellSessionHandoffPackage,
controlPage: {
browserApiSchema: createControlPageBrowserApiSchema(),

View File

@@ -96,6 +96,7 @@
createIniPanelShellWorkflowOverviewEmbeddingDomReadiness,
mountIniPanelShellWorkflowOverviewEmbedding,
renderIniPanelShellWorkflowOverviewEmbeddingState,
mountIniPanelShellWorkflowOverviewEmbeddingState,
renderIniPanelShellSessionHandoffWorkflowState,
mountIniPanelShellSessionHandoffWorkflow,
} from "./ui-shell.js";
@@ -155,6 +156,11 @@
renderWorkflowOverviewEmbeddingState: (renderState, options) => (
renderIniPanelShellWorkflowOverviewEmbeddingState(renderState, options ?? { documentRef: document })
),
mountWorkflowOverviewEmbeddingState: (options) => (
mountIniPanelShellWorkflowOverviewEmbeddingState(options ?? {
documentRef: document,
})
),
};
</script>
</body>

View File

@@ -109,6 +109,7 @@
!launchApi?.getWorkflowOverviewEmbeddingDomContract ||
!launchApi?.getWorkflowOverviewEmbeddingDomReadiness ||
!launchApi?.renderWorkflowOverviewEmbeddingState ||
!launchApi?.mountWorkflowOverviewEmbeddingState ||
!launchApi?.isSupportedShellSessionHandoffPackage ||
!launchApi?.getLauncherLinks ||
!launchApi?.getControlPageApiMethods
@@ -639,7 +640,8 @@
!workflowOverviewApi?.getWorkflowOverviewEmbeddingRenderState ||
!workflowOverviewApi?.getWorkflowOverviewEmbeddingDomContract ||
!workflowOverviewApi?.getWorkflowOverviewEmbeddingDomReadiness ||
!workflowOverviewApi?.renderWorkflowOverviewEmbeddingState
!workflowOverviewApi?.renderWorkflowOverviewEmbeddingState ||
!workflowOverviewApi?.mountWorkflowOverviewEmbeddingState
) {
throw new Error("workflow overview API namespace did not expose shell helpers");
}

View File

@@ -115,6 +115,7 @@ TOOL_TABLE = browser-shell-tool.tbl
!launchApi?.getWorkflowOverviewEmbeddingDomContract ||
!launchApi?.getWorkflowOverviewEmbeddingDomReadiness ||
!launchApi?.renderWorkflowOverviewEmbeddingState ||
!launchApi?.mountWorkflowOverviewEmbeddingState ||
!launchApi?.isSupportedShellSessionHandoffPackage
) {
throw new Error("launch API namespace did not expose shell integration helpers");
@@ -326,6 +327,11 @@ TOOL_TABLE = browser-shell-tool.tbl
documentRef: document,
},
);
const workflowOverviewEmbeddingMountState = launchApi.mountWorkflowOverviewEmbeddingState({
renderState: workflowOverviewEmbeddingRenderState,
contract: workflowOverviewEmbeddingDomContract,
documentRef: document,
});
assertEqual(workflowOverviewReadiness.ready, true, "shell workflow overview iframe readiness");
assertEqual(workflowOverviewReadiness.missing.join(","), "", "shell workflow overview iframe missing methods");
assertEqual(workflowOverviewEmbedding.apiName, "ini-panel-shell-workflow-overview-embedding", "shell workflow overview embedding API");
@@ -352,6 +358,9 @@ TOOL_TABLE = browser-shell-tool.tbl
workflowOverviewEmbeddingRenderState.statusLine,
"shell workflow overview embedding rendered status",
);
assertEqual(workflowOverviewEmbeddingMountState.apiName, "ini-panel-shell-workflow-overview-embedding-dom-mount", "shell workflow overview embedding mount API");
assertEqual(workflowOverviewEmbeddingMountState.ready, false, "shell workflow overview embedding mount readiness");
assertEqual(workflowOverviewEmbeddingMountState.renderResult.rowCount, 6, "shell workflow overview embedding mount rows");
const controlDoc = await loadFrame(`../../runtime/ui/ini-panel/${controlTarget.href.slice(2)}`);
const controlPageApi = controlDoc.defaultView.linuxCncIniPanelControlPageApi;

View File

@@ -41,7 +41,8 @@
!workflowApi?.getWorkflowOverviewEmbeddingRenderState ||
!workflowApi?.getWorkflowOverviewEmbeddingDomContract ||
!workflowApi?.getWorkflowOverviewEmbeddingDomReadiness ||
!workflowApi?.renderWorkflowOverviewEmbeddingState
!workflowApi?.renderWorkflowOverviewEmbeddingState ||
!workflowApi?.mountWorkflowOverviewEmbeddingState
) {
throw new Error("workflow overview API namespace did not expose overview helpers");
}
@@ -102,10 +103,16 @@
embeddingMount.append(embeddingStatus, embeddingRows);
workflowDoc.body.append(embeddingMount);
const embeddingRenderResult = workflowApi.renderWorkflowOverviewEmbeddingState(embeddingRenderState);
const embeddingMountState = workflowApi.mountWorkflowOverviewEmbeddingState({
renderState: embeddingRenderState,
});
assertEqual(embeddingRenderResult.rendered, true, "workflow overview embedding render result");
assertEqual(embeddingRenderResult.rowCount, 6, "workflow overview embedding render row count");
assertEqual(embeddingRenderResult.dataset.handoffScope, "workflow-overview-embedding", "workflow overview embedding render scope");
assertEqual(embeddingStatus.textContent, embeddingRenderState.statusLine, "workflow overview embedding rendered status");
assertEqual(embeddingMountState.apiName, "ini-panel-shell-workflow-overview-embedding-dom-mount", "workflow overview embedding mount API");
assertEqual(embeddingMountState.ready, false, "workflow overview embedding mount readiness");
assertEqual(embeddingMountState.renderResult.rowCount, 6, "workflow overview embedding mount row count");
assertEqual(
workflowDoc.querySelector("[data-handoff-workflow]").dataset.handoffScope,
"workflow",

View File

@@ -46,6 +46,7 @@ import {
createIniPanelShellWorkflowOverviewEmbeddingDomReadiness,
mountIniPanelShellWorkflowOverviewEmbedding,
renderIniPanelShellWorkflowOverviewEmbeddingState,
mountIniPanelShellWorkflowOverviewEmbeddingState,
renderIniPanelShellSessionHandoffWorkflowState,
mountIniPanelShellSessionHandoffWorkflow,
renderIniPanelShellSessionHandoffMountState,
@@ -133,6 +134,7 @@ const requiredShellExports = [
"createIniPanelShellWorkflowOverviewEmbeddingDomReadiness",
"mountIniPanelShellWorkflowOverviewEmbedding",
"renderIniPanelShellWorkflowOverviewEmbeddingState",
"mountIniPanelShellWorkflowOverviewEmbeddingState",
"renderIniPanelShellSessionHandoffWorkflowState",
"mountIniPanelShellSessionHandoffWorkflow",
"renderIniPanelShellSessionHandoffMountState",
@@ -438,6 +440,7 @@ assert.match(shellText, /\bexport function createIniPanelShellWorkflowOverviewEm
assert.match(shellText, /\bexport function createIniPanelShellWorkflowOverviewEmbeddingDomContract\b/);
assert.match(shellText, /\bexport function createIniPanelShellWorkflowOverviewEmbeddingDomReadiness\b/);
assert.match(shellText, /\bexport function renderIniPanelShellWorkflowOverviewEmbeddingState\b/);
assert.match(shellText, /\bexport function mountIniPanelShellWorkflowOverviewEmbeddingState\b/);
assert.match(shellText, /\bexport function isSupportedIniPanelControlPageApiManifest\b/);
assert.match(shellText, /\bexport function isSupportedIniPanelLaunchApiManifest\b/);
assert.match(shellText, /\bexport function isSupportedIniPanelShellIntegrationManifest\b/);
@@ -472,6 +475,7 @@ assert.match(launchText, /\bgetWorkflowOverviewEmbeddingRenderState\b/);
assert.match(launchText, /\bgetWorkflowOverviewEmbeddingDomContract\b/);
assert.match(launchText, /\bgetWorkflowOverviewEmbeddingDomReadiness\b/);
assert.match(launchText, /\brenderWorkflowOverviewEmbeddingState\b/);
assert.match(launchText, /\bmountWorkflowOverviewEmbeddingState\b/);
assert.match(launchText, /\bisSupportedShellSessionHandoffPackage\b/);
assert.match(launchText, /\bdata-handoff-shell\b/);
assert.match(launchText, /\bdata-handoff-status\b/);
@@ -511,6 +515,7 @@ assert.match(docText, /\bcreateIniPanelShellWorkflowOverviewEmbeddingRenderState
assert.match(docText, /\bcreateIniPanelShellWorkflowOverviewEmbeddingDomContract\b/);
assert.match(docText, /\bcreateIniPanelShellWorkflowOverviewEmbeddingDomReadiness\b/);
assert.match(docText, /\brenderIniPanelShellWorkflowOverviewEmbeddingState\b/);
assert.match(docText, /\bmountIniPanelShellWorkflowOverviewEmbeddingState\b/);
assert.match(docText, /\bisSupportedIniPanelControlPageApiManifest\b/);
assert.match(docText, /\bisSupportedIniPanelLaunchApiManifest\b/);
assert.match(docText, /\bisSupportedIniPanelShellIntegrationManifest\b/);
@@ -540,6 +545,7 @@ assert.match(docText, /\blinuxCncIniPanelLaunchApi\.getWorkflowOverviewEmbedding
assert.match(docText, /\blinuxCncIniPanelLaunchApi\.getWorkflowOverviewEmbeddingDomContract\b/);
assert.match(docText, /\blinuxCncIniPanelLaunchApi\.getWorkflowOverviewEmbeddingDomReadiness\b/);
assert.match(docText, /\blinuxCncIniPanelLaunchApi\.renderWorkflowOverviewEmbeddingState\b/);
assert.match(docText, /\blinuxCncIniPanelLaunchApi\.mountWorkflowOverviewEmbeddingState\b/);
assert.match(docText, /\blinuxCncIniPanelLaunchApi\.isSupportedShellSessionHandoffPackage\b/);
assert.match(docText, /\bdata-handoff-shell\b/);
assert.match(docText, /\bdata-handoff-status\b/);

View File

@@ -85,6 +85,7 @@ assert.deepEqual(manifest, {
"getWorkflowOverviewEmbeddingDomContract",
"getWorkflowOverviewEmbeddingDomReadiness",
"renderWorkflowOverviewEmbeddingState",
"mountWorkflowOverviewEmbeddingState",
"isSupportedShellSessionHandoffPackage",
"getLauncherLinks",
"getControlPageApiMethods",
@@ -234,6 +235,7 @@ assert.match(launchText, /\bgetWorkflowOverviewEmbeddingRenderState\b/);
assert.match(launchText, /\bgetWorkflowOverviewEmbeddingDomContract\b/);
assert.match(launchText, /\bgetWorkflowOverviewEmbeddingDomReadiness\b/);
assert.match(launchText, /\brenderWorkflowOverviewEmbeddingState\b/);
assert.match(launchText, /\bmountWorkflowOverviewEmbeddingState\b/);
assert.match(launchText, /\bisSupportedShellSessionHandoffPackage\b/);
assert.match(launchText, /\bdata-handoff-workflow\b/);
assert.match(launchText, /\bdata-handoff-workflow-status\b/);

View File

@@ -42,6 +42,7 @@ import {
createIniPanelShellWorkflowOverviewEmbeddingDomReadiness,
mountIniPanelShellWorkflowOverviewEmbedding,
renderIniPanelShellWorkflowOverviewEmbeddingState,
mountIniPanelShellWorkflowOverviewEmbeddingState,
renderIniPanelShellSessionHandoffWorkflowState,
mountIniPanelShellSessionHandoffWorkflow,
createIniPanelShellSessionHandoffPackageReport,
@@ -170,7 +171,7 @@ assert.deepEqual(readiness, {
counts: {
pages: 3,
launcherLinks: 3,
launchMethods: 48,
launchMethods: 49,
controlPageMethods: 11,
persistenceCapabilities: 3,
},
@@ -232,7 +233,7 @@ assert.deepEqual(handoffSummary, {
counts: {
pages: 3,
launcherLinks: 3,
launchMethods: 48,
launchMethods: 49,
controlPageMethods: 11,
persistenceCapabilities: 3,
},
@@ -794,6 +795,7 @@ assert.equal(
);
assert.equal(createIniPanelShellWorkflowOverviewEmbeddingDomReadiness().ready, false);
assert.equal(typeof renderIniPanelShellWorkflowOverviewEmbeddingState, "function");
assert.equal(typeof mountIniPanelShellWorkflowOverviewEmbeddingState, "function");
assert.deepEqual(
createIniPanelShellWorkflowOverviewReadiness({
overviewApi: {
@@ -1222,7 +1224,7 @@ assert.deepEqual(createIniPanelShellIntegrationReadiness(blockedManifest), {
counts: {
pages: 3,
launcherLinks: 3,
launchMethods: 48,
launchMethods: 49,
controlPageMethods: 11,
persistenceCapabilities: 3,
},
@@ -1410,6 +1412,7 @@ assert.match(shellText, /\bexport function createIniPanelShellWorkflowOverviewEm
assert.match(shellText, /\bexport function createIniPanelShellWorkflowOverviewEmbeddingDomContract\b/);
assert.match(shellText, /\bexport function createIniPanelShellWorkflowOverviewEmbeddingDomReadiness\b/);
assert.match(shellText, /\bexport function renderIniPanelShellWorkflowOverviewEmbeddingState\b/);
assert.match(shellText, /\bexport function mountIniPanelShellWorkflowOverviewEmbeddingState\b/);
assert.match(shellText, /\bexport function createIniPanelShellSessionHandoffPackageRenderState\b/);
assert.match(shellText, /\bexport function createIniPanelShellSessionHandoffPackageSchema\b/);
assert.match(shellText, /\bexport function createIniPanelShellSessionHandoffRenderState\b/);
@@ -1453,6 +1456,7 @@ assert.match(docText, /\bcreateIniPanelShellWorkflowOverviewEmbeddingRenderState
assert.match(docText, /\bcreateIniPanelShellWorkflowOverviewEmbeddingDomContract\b/);
assert.match(docText, /\bcreateIniPanelShellWorkflowOverviewEmbeddingDomReadiness\b/);
assert.match(docText, /\brenderIniPanelShellWorkflowOverviewEmbeddingState\b/);
assert.match(docText, /\bmountIniPanelShellWorkflowOverviewEmbeddingState\b/);
assert.match(docText, /\bcreateIniPanelShellSessionHandoffPackageRenderState\b/);
assert.match(docText, /\bcreateIniPanelShellSessionHandoffPackageSchema\b/);
assert.match(docText, /\bcreateIniPanelShellSessionHandoffRenderState\b/);

View File

@@ -42,6 +42,7 @@ import {
createIniPanelShellWorkflowOverviewEmbeddingDomReadiness,
mountIniPanelShellWorkflowOverviewEmbedding,
renderIniPanelShellWorkflowOverviewEmbeddingState,
mountIniPanelShellWorkflowOverviewEmbeddingState,
renderIniPanelShellSessionHandoffWorkflowState,
mountIniPanelShellSessionHandoffWorkflow,
renderIniPanelShellSessionHandoffMountState,
@@ -134,6 +135,7 @@ assert.equal(typeof createIniPanelShellWorkflowOverviewEmbeddingDomContract, "fu
assert.equal(typeof createIniPanelShellWorkflowOverviewEmbeddingDomReadiness, "function");
assert.equal(typeof mountIniPanelShellWorkflowOverviewEmbedding, "function");
assert.equal(typeof renderIniPanelShellWorkflowOverviewEmbeddingState, "function");
assert.equal(typeof mountIniPanelShellWorkflowOverviewEmbeddingState, "function");
assert.equal(typeof renderIniPanelShellSessionHandoffWorkflowState, "function");
assert.equal(typeof mountIniPanelShellSessionHandoffWorkflow, "function");
assert.equal(typeof renderIniPanelShellSessionHandoffMountState, "function");
@@ -823,6 +825,10 @@ assert.equal(
shellViewModel.renderWorkflowOverviewEmbeddingState,
renderIniPanelShellWorkflowOverviewEmbeddingState,
);
assert.equal(
shellViewModel.mountWorkflowOverviewEmbeddingState,
mountIniPanelShellWorkflowOverviewEmbeddingState,
);
assert.equal(shellViewModel.createShellSessionHandoffPackageReport, createIniPanelShellSessionHandoffPackageReport);
assert.equal(shellViewModel.createShellSessionHandoffPackageSchema, createIniPanelShellSessionHandoffPackageSchema);
assert.equal(shellViewModel.isSupportedShellSessionHandoffPackage, isSupportedIniPanelShellSessionHandoffPackage);
@@ -1393,6 +1399,29 @@ assert.deepEqual(
assert.equal(mountRowsNode.children[0].dataset.workflowOverviewEmbeddingRow, "overview-api");
assert.equal(mountRowsNode.children[1].dataset.workflowOverviewEmbeddingValue, "overview-api");
assert.equal(mountRowsNode.children[1].dataset.workflowOverviewEmbeddingStatus, "blocked");
const workflowOverviewEmbeddingMountResult = mountIniPanelShellWorkflowOverviewEmbeddingState({
renderState: createIniPanelShellWorkflowOverviewEmbeddingRenderState(
createIniPanelShellWorkflowOverviewEmbeddingDisplayViewModel(workflowOverviewEmbeddingReport),
),
documentRef: mountDocument,
mountNode,
statusNode: mountStatusNode,
rowsNode: mountRowsNode,
});
assert.equal(workflowOverviewEmbeddingMountResult.apiName, "ini-panel-shell-workflow-overview-embedding-dom-mount");
assert.equal(workflowOverviewEmbeddingMountResult.workflowVersion, 1);
assert.equal(workflowOverviewEmbeddingMountResult.phase, "blocked");
assert.equal(workflowOverviewEmbeddingMountResult.ready, false);
assert.equal(workflowOverviewEmbeddingMountResult.renderResult.rowCount, 6);
assert.equal(
workflowOverviewEmbeddingMountResult.renderResult.dataset.handoffScope,
"workflow-overview-embedding",
);
assert.equal(workflowOverviewEmbeddingMountResult.error, null);
assert.deepEqual(
mountIniPanelShellWorkflowOverviewEmbeddingState({ documentRef: null }).domReadiness.missing,
["document", "mount", "status", "rows"],
);
assert.deepEqual(
mountIniPanelShellWorkflowOverviewEmbedding({ overviewApi: null }).readiness.missing,
shellViewModel.shellWorkflowOverviewContract.methodNames,