@xopcai/xopc 0.0.146 → 0.0.147

package/dist/src/local-apps/acceptance.js

@@ -0,0 +1,93 @@
+import { join } from "node:path";
+import { existsSync, readFileSync } from "node:fs";
+//#region src/local-apps/acceptance.ts
+const MAX_SCENARIOS = 10;
+const MAX_STEPS = 20;
+const MAX_TEXT_LENGTH = 500;
+const TEST_ID_PATTERN = /^[A-Za-z0-9_-]{1,80}$/;
+function requiredText(value, label, maxLength = MAX_TEXT_LENGTH) {
+	if (typeof value !== "string" || !value.trim() || value.length > maxLength) throw new Error(`${label} must be a non-empty string up to ${maxLength} characters`);
+	return value;
+}
+function boundedText(value, label) {
+	if (typeof value !== "string" || value.length > MAX_TEXT_LENGTH) throw new Error(`${label} must be a string up to ${MAX_TEXT_LENGTH} characters`);
+	return value;
+}
+function testId(value, label) {
+	const id = requiredText(value, label, 80);
+	if (!TEST_ID_PATTERN.test(id)) throw new Error(`${label} must use only letters, numbers, dashes, and underscores`);
+	return id;
+}
+function parseStep(value, label) {
+	if (!value || typeof value !== "object" || Array.isArray(value)) throw new Error(`${label} must be an object`);
+	const step = value;
+	const hasOnly = (...keys) => Object.keys(step).every((key) => keys.includes(key));
+	if (step.action === "click" && hasOnly("action", "target")) return {
+		action: "click",
+		target: testId(step.target, `${label}.target`)
+	};
+	if (step.action === "fill" && hasOnly("action", "target", "value")) return {
+		action: "fill",
+		target: testId(step.target, `${label}.target`),
+		value: boundedText(step.value, `${label}.value`)
+	};
+	if (step.assert === "text_visible" && hasOnly("assert", "text")) return {
+		assert: "text_visible",
+		text: requiredText(step.text, `${label}.text`)
+	};
+	if (step.assert === "element_exists" && hasOnly("assert", "target")) return {
+		assert: "element_exists",
+		target: testId(step.target, `${label}.target`)
+	};
+	if (step.assert === "value_equals" && hasOnly("assert", "target", "value")) return {
+		assert: "value_equals",
+		target: testId(step.target, `${label}.target`),
+		value: boundedText(step.value, `${label}.value`)
+	};
+	throw new Error(`${label} uses an unsupported action or assertion`);
+}
+function parseLocalAppAcceptanceConfig(value) {
+	if (!value || typeof value !== "object" || Array.isArray(value)) throw new Error("Acceptance config must be an object");
+	const config = value;
+	if (config.schemaVersion !== 1) throw new Error("Acceptance config schemaVersion must be 1");
+	if (!Array.isArray(config.scenarios) || config.scenarios.length > MAX_SCENARIOS) throw new Error(`Acceptance config must contain at most ${MAX_SCENARIOS} scenarios`);
+	const ids = /* @__PURE__ */ new Set();
+	return {
+		schemaVersion: 1,
+		scenarios: config.scenarios.map((value, scenarioIndex) => {
+			const label = `Acceptance scenario ${scenarioIndex + 1}`;
+			if (!value || typeof value !== "object" || Array.isArray(value)) throw new Error(`${label} must be an object`);
+			const scenario = value;
+			const id = testId(scenario.id, `${label}.id`);
+			if (ids.has(id)) throw new Error(`Acceptance scenario id is duplicated: ${id}`);
+			ids.add(id);
+			if (!Array.isArray(scenario.steps) || !scenario.steps.length || scenario.steps.length > MAX_STEPS) throw new Error(`${label} must contain 1 to ${MAX_STEPS} steps`);
+			return {
+				id,
+				name: requiredText(scenario.name, `${label}.name`, 120),
+				steps: scenario.steps.map((step, stepIndex) => parseStep(step, `${label} step ${stepIndex + 1}`))
+			};
+		})
+	};
+}
+function readLocalAppAcceptanceConfig(root) {
+	const path = join(root, ".xopc", "acceptance.json");
+	if (!existsSync(path)) return {
+		schemaVersion: 1,
+		scenarios: []
+	};
+	let value;
+	try {
+		value = JSON.parse(readFileSync(path, "utf8"));
+	} catch (error) {
+		throw new Error(`Acceptance config is not valid JSON: ${error instanceof Error ? error.message : String(error)}`);
+	}
+	return parseLocalAppAcceptanceConfig(value);
+}
+function encodeLocalAppAcceptanceConfig(config) {
+	return Buffer.from(JSON.stringify(config), "utf8").toString("base64url");
+}
+//#endregion
+export { encodeLocalAppAcceptanceConfig, parseLocalAppAcceptanceConfig, readLocalAppAcceptanceConfig };
+
+//# sourceMappingURL=acceptance.js.map

package/dist/src/local-apps/acceptance.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"acceptance.js","names":[],"sources":["../../../src/local-apps/acceptance.ts"],"sourcesContent":["import { existsSync, readFileSync } from 'node:fs';\nimport { join } from 'node:path';\n\nconst MAX_SCENARIOS = 10;\nconst MAX_STEPS = 20;\nconst MAX_TEXT_LENGTH = 500;\nconst TEST_ID_PATTERN = /^[A-Za-z0-9_-]{1,80}$/;\n\nexport type LocalAppAcceptanceStep =\n  | { action: 'click'; target: string }\n  | { action: 'fill'; target: string; value: string }\n  | { assert: 'text_visible'; text: string }\n  | { assert: 'element_exists'; target: string }\n  | { assert: 'value_equals'; target: string; value: string };\n\nexport interface LocalAppAcceptanceScenario {\n  id: string;\n  name: string;\n  steps: LocalAppAcceptanceStep[];\n}\n\nexport interface LocalAppAcceptanceConfig {\n  schemaVersion: 1;\n  scenarios: LocalAppAcceptanceScenario[];\n}\n\nfunction requiredText(value: unknown, label: string, maxLength = MAX_TEXT_LENGTH): string {\n  if (typeof value !== 'string' || !value.trim() || value.length > maxLength) {\n    throw new Error(`${label} must be a non-empty string up to ${maxLength} characters`);\n  }\n  return value;\n}\n\nfunction boundedText(value: unknown, label: string): string {\n  if (typeof value !== 'string' || value.length > MAX_TEXT_LENGTH) {\n    throw new Error(`${label} must be a string up to ${MAX_TEXT_LENGTH} characters`);\n  }\n  return value;\n}\n\nfunction testId(value: unknown, label: string): string {\n  const id = requiredText(value, label, 80);\n  if (!TEST_ID_PATTERN.test(id)) {\n    throw new Error(`${label} must use only letters, numbers, dashes, and underscores`);\n  }\n  return id;\n}\n\nfunction parseStep(value: unknown, label: string): LocalAppAcceptanceStep {\n  if (!value || typeof value !== 'object' || Array.isArray(value)) throw new Error(`${label} must be an object`);\n  const step = value as Record<string, unknown>;\n  const hasOnly = (...keys: string[]) => Object.keys(step).every((key) => keys.includes(key));\n  if (step.action === 'click' && hasOnly('action', 'target')) {\n    return { action: 'click', target: testId(step.target, `${label}.target`) };\n  }\n  if (step.action === 'fill' && hasOnly('action', 'target', 'value')) {\n    return { action: 'fill', target: testId(step.target, `${label}.target`), value: boundedText(step.value, `${label}.value`) };\n  }\n  if (step.assert === 'text_visible' && hasOnly('assert', 'text')) {\n    return { assert: 'text_visible', text: requiredText(step.text, `${label}.text`) };\n  }\n  if (step.assert === 'element_exists' && hasOnly('assert', 'target')) {\n    return { assert: 'element_exists', target: testId(step.target, `${label}.target`) };\n  }\n  if (step.assert === 'value_equals' && hasOnly('assert', 'target', 'value')) {\n    return { assert: 'value_equals', target: testId(step.target, `${label}.target`), value: boundedText(step.value, `${label}.value`) };\n  }\n  throw new Error(`${label} uses an unsupported action or assertion`);\n}\n\nexport function parseLocalAppAcceptanceConfig(value: unknown): LocalAppAcceptanceConfig {\n  if (!value || typeof value !== 'object' || Array.isArray(value)) throw new Error('Acceptance config must be an object');\n  const config = value as Record<string, unknown>;\n  if (config.schemaVersion !== 1) throw new Error('Acceptance config schemaVersion must be 1');\n  if (!Array.isArray(config.scenarios) || config.scenarios.length > MAX_SCENARIOS) {\n    throw new Error(`Acceptance config must contain at most ${MAX_SCENARIOS} scenarios`);\n  }\n  const ids = new Set<string>();\n  const scenarios = config.scenarios.map((value, scenarioIndex) => {\n    const label = `Acceptance scenario ${scenarioIndex + 1}`;\n    if (!value || typeof value !== 'object' || Array.isArray(value)) throw new Error(`${label} must be an object`);\n    const scenario = value as Record<string, unknown>;\n    const id = testId(scenario.id, `${label}.id`);\n    if (ids.has(id)) throw new Error(`Acceptance scenario id is duplicated: ${id}`);\n    ids.add(id);\n    if (!Array.isArray(scenario.steps) || !scenario.steps.length || scenario.steps.length > MAX_STEPS) {\n      throw new Error(`${label} must contain 1 to ${MAX_STEPS} steps`);\n    }\n    return {\n      id,\n      name: requiredText(scenario.name, `${label}.name`, 120),\n      steps: scenario.steps.map((step, stepIndex) => parseStep(step, `${label} step ${stepIndex + 1}`)),\n    };\n  });\n  return { schemaVersion: 1, scenarios };\n}\n\nexport function readLocalAppAcceptanceConfig(root: string): LocalAppAcceptanceConfig {\n  const path = join(root, '.xopc', 'acceptance.json');\n  if (!existsSync(path)) return { schemaVersion: 1, scenarios: [] };\n  let value: unknown;\n  try {\n    value = JSON.parse(readFileSync(path, 'utf8'));\n  } catch (error) {\n    throw new Error(`Acceptance config is not valid JSON: ${error instanceof Error ? error.message : String(error)}`);\n  }\n  return parseLocalAppAcceptanceConfig(value);\n}\n\nexport function encodeLocalAppAcceptanceConfig(config: LocalAppAcceptanceConfig): string {\n  return Buffer.from(JSON.stringify(config), 'utf8').toString('base64url');\n}\n"],"mappings":"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"}

package/dist/src/local-apps/index.d.ts

@@ -0,0 +1,5 @@
+export { LocalAppService, type LocalAppServiceOptions } from './service.js';
+export { LocalAppStore } from './store.js';
+export { encodeLocalAppAcceptanceConfig, parseLocalAppAcceptanceConfig, readLocalAppAcceptanceConfig, } from './acceptance.js';
+export type { LocalAppAcceptanceConfig, LocalAppAcceptanceScenario, LocalAppAcceptanceStep, } from './acceptance.js';
+export type { CreateLocalAppInput, LocalApp, LocalAppAcceptanceCheck, LocalAppAcceptanceScenarioSummary, LocalAppAcceptanceRun, LocalAppDetail, LocalAppInstallationState, LocalAppChangedFile, LocalAppValidationIssue, LocalAppValidationResult, LocalAppPreviewTarget, LocalAppRelease, LocalAppReleaseHealth, LocalAppStatus, LocalAppUiGrant, RecordLocalAppAcceptanceInput, } from './types.js';

package/dist/src/local-apps/index.js

@@ -0,0 +1,4 @@
+import { LocalAppStore } from "./store.js";
+import { encodeLocalAppAcceptanceConfig, parseLocalAppAcceptanceConfig, readLocalAppAcceptanceConfig } from "./acceptance.js";
+import { LocalAppService } from "./service.js";
+export { LocalAppService, LocalAppStore, encodeLocalAppAcceptanceConfig, parseLocalAppAcceptanceConfig, readLocalAppAcceptanceConfig };

package/dist/src/local-apps/preview-runtime-bridge.d.ts

@@ -0,0 +1,4 @@
+import type { LocalAppAcceptanceConfig } from './acceptance.js';
+export declare const LOCAL_APP_RUNTIME_BRIDGE_SCRIPT = "(() => {\n  let hostPort = null;\n  const pending = [];\n  const send = (type, detail) => {\n    const message = { source: 'xopc-local-app-preview', version: 1, type, detail };\n    if (hostPort) hostPort.postMessage(message);\n    else pending.push(message);\n  };\n  const connect = (event) => {\n    const message = event.data;\n    if (event.source !== parent || message?.source !== 'xopc-local-app-host' || message?.version !== 1 || message?.type !== 'connect' || !event.ports[0]) return;\n    event.stopImmediatePropagation();\n    removeEventListener('message', connect, true);\n    hostPort = event.ports[0];\n    hostPort.start();\n    for (const queued of pending.splice(0)) hostPort.postMessage(queued);\n  };\n  addEventListener('message', connect, true);\n  const text = (value) => String(value ?? '').slice(0, 500);\n  let runtimeFailure = '';\n  const visible = (element) => {\n    const style = getComputedStyle(element);\n    const rect = element.getBoundingClientRect();\n    return style.display !== 'none' && style.visibility !== 'hidden' && Number(style.opacity) !== 0 && rect.width > 0 && rect.height > 0;\n  };\n  const accessibleName = (element) => {\n    const labelledBy = text(element.getAttribute('aria-labelledby'));\n    const labelledText = labelledBy.split(/\\s+/).map((id) => document.getElementById(id)?.textContent).filter(Boolean).join(' ');\n    return text(element.getAttribute('aria-label') || labelledText || element.labels?.[0]?.textContent || element.textContent || element.getAttribute('alt') || element.getAttribute('title') || element.getAttribute('placeholder') || element.getAttribute('name')).trim();\n  };\n  const target = (id) => Array.from(document.querySelectorAll('[data-xopc-test-id]'))\n    .find((element) => element.getAttribute('data-xopc-test-id') === id);\n  const pause = () => new Promise((resolve) => setTimeout(resolve, 50));\n  const readCriteria = () => {\n    const encoded = document.querySelector('meta[name=\"xopc-local-app-acceptance\"]')?.content;\n    if (!encoded) return { schemaVersion: 1, scenarios: [] };\n    const base64 = encoded.replace(/-/g, '+').replace(/_/g, '/');\n    const padded = base64.padEnd(Math.ceil(base64.length / 4) * 4, '=');\n    const bytes = Uint8Array.from(atob(padded), (char) => char.charCodeAt(0));\n    return JSON.parse(new TextDecoder().decode(bytes));\n  };\n  addEventListener('error', (event) => {\n    runtimeFailure = text(event.message || 'A preview resource failed to load');\n    send('error', {\n      kind: 'script_error',\n      message: runtimeFailure,\n      filename: text(event.filename),\n      line: Number(event.lineno) || undefined,\n      column: Number(event.colno) || undefined,\n    });\n  }, true);\n  addEventListener('unhandledrejection', (event) => {\n    runtimeFailure = text(event.reason instanceof Error ? event.reason.message : event.reason);\n    send('error', { kind: 'unhandled_rejection', message: runtimeFailure });\n  });\n  const runAcceptance = () => {\n    const checks = [];\n    const bodyReady = Boolean(document.body);\n    checks.push({ id: 'document', status: bodyReady ? 'passed' : 'failed', message: bodyReady ? 'Preview document loaded' : 'Preview document has no body' });\n    const contentNodes = bodyReady ? Array.from(document.body.querySelectorAll('*')).slice(0, 300) : [];\n    const hasVisibleContent = contentNodes.some((element) => visible(element) && (text(element.textContent).trim() || /^(IMG|SVG|CANVAS|VIDEO)$/.test(element.tagName)));\n    checks.push({ id: 'content', status: hasVisibleContent ? 'passed' : 'failed', message: hasVisibleContent ? 'Visible content rendered' : 'No visible content was rendered' });\n    const controls = bodyReady ? Array.from(document.body.querySelectorAll('a[href], button, input, select, textarea, [role=\"button\"], [tabindex]')).filter((element) => visible(element) && !element.disabled && element.getAttribute('aria-disabled') !== 'true') : [];\n    const unnamed = controls.filter((element) => !accessibleName(element));\n    let interactionStatus = controls.length ? 'passed' : 'skipped';\n    let interactionMessage = controls.length ? controls.length + ' interactive control(s) are discoverable' : 'No interactive controls to exercise';\n    if (unnamed.length) {\n      interactionStatus = 'failed';\n      interactionMessage = unnamed.length + ' interactive control(s) need an accessible name';\n    } else if (controls.length) {\n      const previous = document.activeElement;\n      controls[0].focus({ preventScroll: true });\n      if (document.activeElement !== controls[0]) {\n        interactionStatus = 'failed';\n        interactionMessage = 'The first interactive control could not receive focus';\n      }\n      if (previous && typeof previous.focus === 'function') previous.focus({ preventScroll: true });\n      else controls[0].blur();\n    }\n    checks.push({ id: 'interaction', status: interactionStatus, message: interactionMessage });\n    send('acceptance', {\n      status: checks.some((check) => check.status === 'failed') ? 'failed' : 'passed',\n      checks,\n      interactiveCount: controls.length,\n    });\n  };\n  const runCriteria = async () => {\n    const params = new URLSearchParams(location.search);\n    if (params.get('xopcAcceptance') !== '1') return;\n    let config;\n    try {\n      config = readCriteria();\n    } catch (error) {\n      send('criteria', { status: 'failed', scenarioCount: 0, scenarios: [{ id: 'config', name: 'Acceptance config', status: 'failed', message: text(error instanceof Error ? error.message : error) }] });\n      return;\n    }\n    const requestedScenario = params.get('xopcScenario');\n    const selectedScenarios = requestedScenario\n      ? (config.scenarios || []).filter((scenario) => scenario.id === requestedScenario)\n      : config.scenarios || [];\n    if (requestedScenario && !selectedScenarios.length) {\n      send('criteria', { status: 'failed', scenarioCount: 1, scenarios: [{ id: requestedScenario, name: requestedScenario, status: 'failed', message: 'Requested scenario was not found' }] });\n      return;\n    }\n    const scenarios = [];\n    for (const scenario of selectedScenarios) {\n      let failure = '';\n      for (let index = 0; index < scenario.steps.length; index += 1) {\n        const step = scenario.steps[index];\n        try {\n          if (step.action === 'click') {\n            const element = target(step.target);\n            if (!(element instanceof HTMLElement)) throw new Error('Target \"' + step.target + '\" was not found');\n            if ('disabled' in element && element.disabled || element.getAttribute('aria-disabled') === 'true') throw new Error('Target \"' + step.target + '\" is disabled');\n            element.click();\n            await pause();\n          } else if (step.action === 'fill') {\n            const element = target(step.target);\n            if (!(element instanceof HTMLInputElement || element instanceof HTMLTextAreaElement || element instanceof HTMLSelectElement)) throw new Error('Target \"' + step.target + '\" cannot be filled');\n            const prototype = element instanceof HTMLInputElement ? HTMLInputElement.prototype : element instanceof HTMLTextAreaElement ? HTMLTextAreaElement.prototype : HTMLSelectElement.prototype;\n            const setter = Object.getOwnPropertyDescriptor(prototype, 'value')?.set;\n            if (setter) setter.call(element, step.value);\n            else element.value = step.value;\n            element.dispatchEvent(new Event('input', { bubbles: true }));\n            element.dispatchEvent(new Event('change', { bubbles: true }));\n            await pause();\n          } else if (step.assert === 'text_visible') {\n            const found = Array.from(document.body.querySelectorAll('*')).some((element) => visible(element) && text(element.textContent).includes(step.text));\n            if (!found) throw new Error('Visible text was not found: \"' + step.text + '\"');\n          } else if (step.assert === 'element_exists') {\n            if (!target(step.target)) throw new Error('Target \"' + step.target + '\" was not found');\n          } else if (step.assert === 'value_equals') {\n            const element = target(step.target);\n            if (!element || !('value' in element) || element.value !== step.value) throw new Error('Target \"' + step.target + '\" does not have the expected value');\n          }\n          if (runtimeFailure) throw new Error(runtimeFailure);\n        } catch (error) {\n          failure = 'Step ' + (index + 1) + ': ' + text(error instanceof Error ? error.message : error);\n          break;\n        }\n      }\n      scenarios.push({ id: scenario.id, name: scenario.name, status: failure ? 'failed' : 'passed', message: failure || 'Scenario passed' });\n    }\n    send('criteria', {\n      status: scenarios.some((scenario) => scenario.status === 'failed') ? 'failed' : 'passed',\n      scenarioCount: scenarios.length,\n      scenarios,\n    });\n  };\n  const loaded = () => {\n    send('ready', { readyState: document.readyState });\n    const run = () => { runAcceptance(); void runCriteria(); };\n    if (typeof requestAnimationFrame === 'function') requestAnimationFrame(() => requestAnimationFrame(run));\n    else setTimeout(run, 0);\n  };\n  if (document.readyState === 'complete') queueMicrotask(loaded);\n  else addEventListener('load', loaded, { once: true });\n})();";
+export declare const LOCAL_APP_RUNTIME_BRIDGE_HASH: string;
+export declare function injectLocalAppRuntimeBridge(html: string, acceptance?: LocalAppAcceptanceConfig): string;

package/dist/src/local-apps/preview-runtime-bridge.js

@@ -0,0 +1,171 @@
+import { encodeLocalAppAcceptanceConfig } from "./acceptance.js";
+import { createHash } from "node:crypto";
+//#region src/local-apps/preview-runtime-bridge.ts
+const LOCAL_APP_RUNTIME_BRIDGE_SCRIPT = `(() => {
+  let hostPort = null;
+  const pending = [];
+  const send = (type, detail) => {
+    const message = { source: 'xopc-local-app-preview', version: 1, type, detail };
+    if (hostPort) hostPort.postMessage(message);
+    else pending.push(message);
+  };
+  const connect = (event) => {
+    const message = event.data;
+    if (event.source !== parent || message?.source !== 'xopc-local-app-host' || message?.version !== 1 || message?.type !== 'connect' || !event.ports[0]) return;
+    event.stopImmediatePropagation();
+    removeEventListener('message', connect, true);
+    hostPort = event.ports[0];
+    hostPort.start();
+    for (const queued of pending.splice(0)) hostPort.postMessage(queued);
+  };
+  addEventListener('message', connect, true);
+  const text = (value) => String(value ?? '').slice(0, 500);
+  let runtimeFailure = '';
+  const visible = (element) => {
+    const style = getComputedStyle(element);
+    const rect = element.getBoundingClientRect();
+    return style.display !== 'none' && style.visibility !== 'hidden' && Number(style.opacity) !== 0 && rect.width > 0 && rect.height > 0;
+  };
+  const accessibleName = (element) => {
+    const labelledBy = text(element.getAttribute('aria-labelledby'));
+    const labelledText = labelledBy.split(/\\s+/).map((id) => document.getElementById(id)?.textContent).filter(Boolean).join(' ');
+    return text(element.getAttribute('aria-label') || labelledText || element.labels?.[0]?.textContent || element.textContent || element.getAttribute('alt') || element.getAttribute('title') || element.getAttribute('placeholder') || element.getAttribute('name')).trim();
+  };
+  const target = (id) => Array.from(document.querySelectorAll('[data-xopc-test-id]'))
+    .find((element) => element.getAttribute('data-xopc-test-id') === id);
+  const pause = () => new Promise((resolve) => setTimeout(resolve, 50));
+  const readCriteria = () => {
+    const encoded = document.querySelector('meta[name="xopc-local-app-acceptance"]')?.content;
+    if (!encoded) return { schemaVersion: 1, scenarios: [] };
+    const base64 = encoded.replace(/-/g, '+').replace(/_/g, '/');
+    const padded = base64.padEnd(Math.ceil(base64.length / 4) * 4, '=');
+    const bytes = Uint8Array.from(atob(padded), (char) => char.charCodeAt(0));
+    return JSON.parse(new TextDecoder().decode(bytes));
+  };
+  addEventListener('error', (event) => {
+    runtimeFailure = text(event.message || 'A preview resource failed to load');
+    send('error', {
+      kind: 'script_error',
+      message: runtimeFailure,
+      filename: text(event.filename),
+      line: Number(event.lineno) || undefined,
+      column: Number(event.colno) || undefined,
+    });
+  }, true);
+  addEventListener('unhandledrejection', (event) => {
+    runtimeFailure = text(event.reason instanceof Error ? event.reason.message : event.reason);
+    send('error', { kind: 'unhandled_rejection', message: runtimeFailure });
+  });
+  const runAcceptance = () => {
+    const checks = [];
+    const bodyReady = Boolean(document.body);
+    checks.push({ id: 'document', status: bodyReady ? 'passed' : 'failed', message: bodyReady ? 'Preview document loaded' : 'Preview document has no body' });
+    const contentNodes = bodyReady ? Array.from(document.body.querySelectorAll('*')).slice(0, 300) : [];
+    const hasVisibleContent = contentNodes.some((element) => visible(element) && (text(element.textContent).trim() || /^(IMG|SVG|CANVAS|VIDEO)$/.test(element.tagName)));
+    checks.push({ id: 'content', status: hasVisibleContent ? 'passed' : 'failed', message: hasVisibleContent ? 'Visible content rendered' : 'No visible content was rendered' });
+    const controls = bodyReady ? Array.from(document.body.querySelectorAll('a[href], button, input, select, textarea, [role="button"], [tabindex]')).filter((element) => visible(element) && !element.disabled && element.getAttribute('aria-disabled') !== 'true') : [];
+    const unnamed = controls.filter((element) => !accessibleName(element));
+    let interactionStatus = controls.length ? 'passed' : 'skipped';
+    let interactionMessage = controls.length ? controls.length + ' interactive control(s) are discoverable' : 'No interactive controls to exercise';
+    if (unnamed.length) {
+      interactionStatus = 'failed';
+      interactionMessage = unnamed.length + ' interactive control(s) need an accessible name';
+    } else if (controls.length) {
+      const previous = document.activeElement;
+      controls[0].focus({ preventScroll: true });
+      if (document.activeElement !== controls[0]) {
+        interactionStatus = 'failed';
+        interactionMessage = 'The first interactive control could not receive focus';
+      }
+      if (previous && typeof previous.focus === 'function') previous.focus({ preventScroll: true });
+      else controls[0].blur();
+    }
+    checks.push({ id: 'interaction', status: interactionStatus, message: interactionMessage });
+    send('acceptance', {
+      status: checks.some((check) => check.status === 'failed') ? 'failed' : 'passed',
+      checks,
+      interactiveCount: controls.length,
+    });
+  };
+  const runCriteria = async () => {
+    const params = new URLSearchParams(location.search);
+    if (params.get('xopcAcceptance') !== '1') return;
+    let config;
+    try {
+      config = readCriteria();
+    } catch (error) {
+      send('criteria', { status: 'failed', scenarioCount: 0, scenarios: [{ id: 'config', name: 'Acceptance config', status: 'failed', message: text(error instanceof Error ? error.message : error) }] });
+      return;
+    }
+    const requestedScenario = params.get('xopcScenario');
+    const selectedScenarios = requestedScenario
+      ? (config.scenarios || []).filter((scenario) => scenario.id === requestedScenario)
+      : config.scenarios || [];
+    if (requestedScenario && !selectedScenarios.length) {
+      send('criteria', { status: 'failed', scenarioCount: 1, scenarios: [{ id: requestedScenario, name: requestedScenario, status: 'failed', message: 'Requested scenario was not found' }] });
+      return;
+    }
+    const scenarios = [];
+    for (const scenario of selectedScenarios) {
+      let failure = '';
+      for (let index = 0; index < scenario.steps.length; index += 1) {
+        const step = scenario.steps[index];
+        try {
+          if (step.action === 'click') {
+            const element = target(step.target);
+            if (!(element instanceof HTMLElement)) throw new Error('Target "' + step.target + '" was not found');
+            if ('disabled' in element && element.disabled || element.getAttribute('aria-disabled') === 'true') throw new Error('Target "' + step.target + '" is disabled');
+            element.click();
+            await pause();
+          } else if (step.action === 'fill') {
+            const element = target(step.target);
+            if (!(element instanceof HTMLInputElement || element instanceof HTMLTextAreaElement || element instanceof HTMLSelectElement)) throw new Error('Target "' + step.target + '" cannot be filled');
+            const prototype = element instanceof HTMLInputElement ? HTMLInputElement.prototype : element instanceof HTMLTextAreaElement ? HTMLTextAreaElement.prototype : HTMLSelectElement.prototype;
+            const setter = Object.getOwnPropertyDescriptor(prototype, 'value')?.set;
+            if (setter) setter.call(element, step.value);
+            else element.value = step.value;
+            element.dispatchEvent(new Event('input', { bubbles: true }));
+            element.dispatchEvent(new Event('change', { bubbles: true }));
+            await pause();
+          } else if (step.assert === 'text_visible') {
+            const found = Array.from(document.body.querySelectorAll('*')).some((element) => visible(element) && text(element.textContent).includes(step.text));
+            if (!found) throw new Error('Visible text was not found: "' + step.text + '"');
+          } else if (step.assert === 'element_exists') {
+            if (!target(step.target)) throw new Error('Target "' + step.target + '" was not found');
+          } else if (step.assert === 'value_equals') {
+            const element = target(step.target);
+            if (!element || !('value' in element) || element.value !== step.value) throw new Error('Target "' + step.target + '" does not have the expected value');
+          }
+          if (runtimeFailure) throw new Error(runtimeFailure);
+        } catch (error) {
+          failure = 'Step ' + (index + 1) + ': ' + text(error instanceof Error ? error.message : error);
+          break;
+        }
+      }
+      scenarios.push({ id: scenario.id, name: scenario.name, status: failure ? 'failed' : 'passed', message: failure || 'Scenario passed' });
+    }
+    send('criteria', {
+      status: scenarios.some((scenario) => scenario.status === 'failed') ? 'failed' : 'passed',
+      scenarioCount: scenarios.length,
+      scenarios,
+    });
+  };
+  const loaded = () => {
+    send('ready', { readyState: document.readyState });
+    const run = () => { runAcceptance(); void runCriteria(); };
+    if (typeof requestAnimationFrame === 'function') requestAnimationFrame(() => requestAnimationFrame(run));
+    else setTimeout(run, 0);
+  };
+  if (document.readyState === 'complete') queueMicrotask(loaded);
+  else addEventListener('load', loaded, { once: true });
+})();`;
+const LOCAL_APP_RUNTIME_BRIDGE_HASH = createHash("sha256").update(LOCAL_APP_RUNTIME_BRIDGE_SCRIPT).digest("base64");
+function injectLocalAppRuntimeBridge(html, acceptance) {
+	const additions = [acceptance ? `<meta name="xopc-local-app-acceptance" content="${encodeLocalAppAcceptanceConfig(acceptance)}">` : "", `<script data-xopc-runtime-bridge>${LOCAL_APP_RUNTIME_BRIDGE_SCRIPT}<\/script>`].filter(Boolean).join("\n");
+	if (/<head(?:\s[^>]*)?>/i.test(html)) return html.replace(/<head(?:\s[^>]*)?>/i, (head) => `${head}\n${additions}`);
+	return `${additions}\n${html}`;
+}
+//#endregion
+export { LOCAL_APP_RUNTIME_BRIDGE_HASH, LOCAL_APP_RUNTIME_BRIDGE_SCRIPT, injectLocalAppRuntimeBridge };
+
+//# sourceMappingURL=preview-runtime-bridge.js.map

package/dist/src/local-apps/preview-runtime-bridge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"preview-runtime-bridge.js","names":[],"sources":["../../../src/local-apps/preview-runtime-bridge.ts"],"sourcesContent":["import { createHash } from 'node:crypto';\n\nimport type { LocalAppAcceptanceConfig } from './acceptance.js';\nimport { encodeLocalAppAcceptanceConfig } from './acceptance.js';\n\nexport const LOCAL_APP_RUNTIME_BRIDGE_SCRIPT = `(() => {\n  let hostPort = null;\n  const pending = [];\n  const send = (type, detail) => {\n    const message = { source: 'xopc-local-app-preview', version: 1, type, detail };\n    if (hostPort) hostPort.postMessage(message);\n    else pending.push(message);\n  };\n  const connect = (event) => {\n    const message = event.data;\n    if (event.source !== parent || message?.source !== 'xopc-local-app-host' || message?.version !== 1 || message?.type !== 'connect' || !event.ports[0]) return;\n    event.stopImmediatePropagation();\n    removeEventListener('message', connect, true);\n    hostPort = event.ports[0];\n    hostPort.start();\n    for (const queued of pending.splice(0)) hostPort.postMessage(queued);\n  };\n  addEventListener('message', connect, true);\n  const text = (value) => String(value ?? '').slice(0, 500);\n  let runtimeFailure = '';\n  const visible = (element) => {\n    const style = getComputedStyle(element);\n    const rect = element.getBoundingClientRect();\n    return style.display !== 'none' && style.visibility !== 'hidden' && Number(style.opacity) !== 0 && rect.width > 0 && rect.height > 0;\n  };\n  const accessibleName = (element) => {\n    const labelledBy = text(element.getAttribute('aria-labelledby'));\n    const labelledText = labelledBy.split(/\\\\s+/).map((id) => document.getElementById(id)?.textContent).filter(Boolean).join(' ');\n    return text(element.getAttribute('aria-label') || labelledText || element.labels?.[0]?.textContent || element.textContent || element.getAttribute('alt') || element.getAttribute('title') || element.getAttribute('placeholder') || element.getAttribute('name')).trim();\n  };\n  const target = (id) => Array.from(document.querySelectorAll('[data-xopc-test-id]'))\n    .find((element) => element.getAttribute('data-xopc-test-id') === id);\n  const pause = () => new Promise((resolve) => setTimeout(resolve, 50));\n  const readCriteria = () => {\n    const encoded = document.querySelector('meta[name=\"xopc-local-app-acceptance\"]')?.content;\n    if (!encoded) return { schemaVersion: 1, scenarios: [] };\n    const base64 = encoded.replace(/-/g, '+').replace(/_/g, '/');\n    const padded = base64.padEnd(Math.ceil(base64.length / 4) * 4, '=');\n    const bytes = Uint8Array.from(atob(padded), (char) => char.charCodeAt(0));\n    return JSON.parse(new TextDecoder().decode(bytes));\n  };\n  addEventListener('error', (event) => {\n    runtimeFailure = text(event.message || 'A preview resource failed to load');\n    send('error', {\n      kind: 'script_error',\n      message: runtimeFailure,\n      filename: text(event.filename),\n      line: Number(event.lineno) || undefined,\n      column: Number(event.colno) || undefined,\n    });\n  }, true);\n  addEventListener('unhandledrejection', (event) => {\n    runtimeFailure = text(event.reason instanceof Error ? event.reason.message : event.reason);\n    send('error', { kind: 'unhandled_rejection', message: runtimeFailure });\n  });\n  const runAcceptance = () => {\n    const checks = [];\n    const bodyReady = Boolean(document.body);\n    checks.push({ id: 'document', status: bodyReady ? 'passed' : 'failed', message: bodyReady ? 'Preview document loaded' : 'Preview document has no body' });\n    const contentNodes = bodyReady ? Array.from(document.body.querySelectorAll('*')).slice(0, 300) : [];\n    const hasVisibleContent = contentNodes.some((element) => visible(element) && (text(element.textContent).trim() || /^(IMG|SVG|CANVAS|VIDEO)$/.test(element.tagName)));\n    checks.push({ id: 'content', status: hasVisibleContent ? 'passed' : 'failed', message: hasVisibleContent ? 'Visible content rendered' : 'No visible content was rendered' });\n    const controls = bodyReady ? Array.from(document.body.querySelectorAll('a[href], button, input, select, textarea, [role=\"button\"], [tabindex]')).filter((element) => visible(element) && !element.disabled && element.getAttribute('aria-disabled') !== 'true') : [];\n    const unnamed = controls.filter((element) => !accessibleName(element));\n    let interactionStatus = controls.length ? 'passed' : 'skipped';\n    let interactionMessage = controls.length ? controls.length + ' interactive control(s) are discoverable' : 'No interactive controls to exercise';\n    if (unnamed.length) {\n      interactionStatus = 'failed';\n      interactionMessage = unnamed.length + ' interactive control(s) need an accessible name';\n    } else if (controls.length) {\n      const previous = document.activeElement;\n      controls[0].focus({ preventScroll: true });\n      if (document.activeElement !== controls[0]) {\n        interactionStatus = 'failed';\n        interactionMessage = 'The first interactive control could not receive focus';\n      }\n      if (previous && typeof previous.focus === 'function') previous.focus({ preventScroll: true });\n      else controls[0].blur();\n    }\n    checks.push({ id: 'interaction', status: interactionStatus, message: interactionMessage });\n    send('acceptance', {\n      status: checks.some((check) => check.status === 'failed') ? 'failed' : 'passed',\n      checks,\n      interactiveCount: controls.length,\n    });\n  };\n  const runCriteria = async () => {\n    const params = new URLSearchParams(location.search);\n    if (params.get('xopcAcceptance') !== '1') return;\n    let config;\n    try {\n      config = readCriteria();\n    } catch (error) {\n      send('criteria', { status: 'failed', scenarioCount: 0, scenarios: [{ id: 'config', name: 'Acceptance config', status: 'failed', message: text(error instanceof Error ? error.message : error) }] });\n      return;\n    }\n    const requestedScenario = params.get('xopcScenario');\n    const selectedScenarios = requestedScenario\n      ? (config.scenarios || []).filter((scenario) => scenario.id === requestedScenario)\n      : config.scenarios || [];\n    if (requestedScenario && !selectedScenarios.length) {\n      send('criteria', { status: 'failed', scenarioCount: 1, scenarios: [{ id: requestedScenario, name: requestedScenario, status: 'failed', message: 'Requested scenario was not found' }] });\n      return;\n    }\n    const scenarios = [];\n    for (const scenario of selectedScenarios) {\n      let failure = '';\n      for (let index = 0; index < scenario.steps.length; index += 1) {\n        const step = scenario.steps[index];\n        try {\n          if (step.action === 'click') {\n            const element = target(step.target);\n            if (!(element instanceof HTMLElement)) throw new Error('Target \"' + step.target + '\" was not found');\n            if ('disabled' in element && element.disabled || element.getAttribute('aria-disabled') === 'true') throw new Error('Target \"' + step.target + '\" is disabled');\n            element.click();\n            await pause();\n          } else if (step.action === 'fill') {\n            const element = target(step.target);\n            if (!(element instanceof HTMLInputElement || element instanceof HTMLTextAreaElement || element instanceof HTMLSelectElement)) throw new Error('Target \"' + step.target + '\" cannot be filled');\n            const prototype = element instanceof HTMLInputElement ? HTMLInputElement.prototype : element instanceof HTMLTextAreaElement ? HTMLTextAreaElement.prototype : HTMLSelectElement.prototype;\n            const setter = Object.getOwnPropertyDescriptor(prototype, 'value')?.set;\n            if (setter) setter.call(element, step.value);\n            else element.value = step.value;\n            element.dispatchEvent(new Event('input', { bubbles: true }));\n            element.dispatchEvent(new Event('change', { bubbles: true }));\n            await pause();\n          } else if (step.assert === 'text_visible') {\n            const found = Array.from(document.body.querySelectorAll('*')).some((element) => visible(element) && text(element.textContent).includes(step.text));\n            if (!found) throw new Error('Visible text was not found: \"' + step.text + '\"');\n          } else if (step.assert === 'element_exists') {\n            if (!target(step.target)) throw new Error('Target \"' + step.target + '\" was not found');\n          } else if (step.assert === 'value_equals') {\n            const element = target(step.target);\n            if (!element || !('value' in element) || element.value !== step.value) throw new Error('Target \"' + step.target + '\" does not have the expected value');\n          }\n          if (runtimeFailure) throw new Error(runtimeFailure);\n        } catch (error) {\n          failure = 'Step ' + (index + 1) + ': ' + text(error instanceof Error ? error.message : error);\n          break;\n        }\n      }\n      scenarios.push({ id: scenario.id, name: scenario.name, status: failure ? 'failed' : 'passed', message: failure || 'Scenario passed' });\n    }\n    send('criteria', {\n      status: scenarios.some((scenario) => scenario.status === 'failed') ? 'failed' : 'passed',\n      scenarioCount: scenarios.length,\n      scenarios,\n    });\n  };\n  const loaded = () => {\n    send('ready', { readyState: document.readyState });\n    const run = () => { runAcceptance(); void runCriteria(); };\n    if (typeof requestAnimationFrame === 'function') requestAnimationFrame(() => requestAnimationFrame(run));\n    else setTimeout(run, 0);\n  };\n  if (document.readyState === 'complete') queueMicrotask(loaded);\n  else addEventListener('load', loaded, { once: true });\n})();`;\n\nexport const LOCAL_APP_RUNTIME_BRIDGE_HASH = createHash('sha256')\n  .update(LOCAL_APP_RUNTIME_BRIDGE_SCRIPT)\n  .digest('base64');\n\nexport function injectLocalAppRuntimeBridge(\n  html: string,\n  acceptance?: LocalAppAcceptanceConfig,\n): string {\n  const meta = acceptance\n    ? `<meta name=\"xopc-local-app-acceptance\" content=\"${encodeLocalAppAcceptanceConfig(acceptance)}\">`\n    : '';\n  const script = `<script data-xopc-runtime-bridge>${LOCAL_APP_RUNTIME_BRIDGE_SCRIPT}</script>`;\n  const additions = [meta, script].filter(Boolean).join('\\n');\n  if (/<head(?:\\s[^>]*)?>/i.test(html)) {\n    return html.replace(/<head(?:\\s[^>]*)?>/i, (head) => `${head}\\n${additions}`);\n  }\n  return `${additions}\\n${html}`;\n}\n"],"mappings":";;;AAKA,MAAa,kCAAkC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA+J/C,MAAa,gCAAgC,WAAW,SAAS,CAC9D,OAAO,gCAAgC,CACvC,OAAO,SAAS;AAEnB,SAAgB,4BACd,MACA,YACQ;CAKR,MAAM,YAAY,CAJL,aACT,mDAAmD,+BAA+B,WAAW,CAAC,MAC9F,IAEqB,oCAD0B,gCAAgC,YACnD,CAAC,OAAO,QAAQ,CAAC,KAAK,KAAK;AAC3D,KAAI,sBAAsB,KAAK,KAAK,CAClC,QAAO,KAAK,QAAQ,wBAAwB,SAAS,GAAG,KAAK,IAAI,YAAY;AAE/E,QAAO,GAAG,UAAU,IAAI"}

package/dist/src/local-apps/runtime-entry.d.ts

@@ -0,0 +1,8 @@
+export declare const LOCAL_APP_RUNTIME_ENTRY = ".xopc/runtime/local-ui.js";
+/**
+ * Local UI Apps use host-defined runtime bytes so generated projects cannot execute
+ * arbitrary Node.js in the gateway process through the extension `main` entry.
+ */
+export declare const LOCAL_APP_RUNTIME_SOURCE = "export default Object.freeze({});\n";
+/** Exact legacy scaffold bytes accepted only to keep existing Phase 1 drafts upgradeable. */
+export declare function legacyLocalAppRuntimeSource(extensionId: string, name: string): string;

package/dist/src/local-apps/runtime-entry.js

@@ -0,0 +1,25 @@
+//#region src/local-apps/runtime-entry.ts
+const LOCAL_APP_RUNTIME_ENTRY = ".xopc/runtime/local-ui.js";
+/**
+* Local UI Apps use host-defined runtime bytes so generated projects cannot execute
+* arbitrary Node.js in the gateway process through the extension `main` entry.
+*/
+const LOCAL_APP_RUNTIME_SOURCE = `export default Object.freeze({});
+`;
+/** Exact legacy scaffold bytes accepted only to keep existing Phase 1 drafts upgradeable. */
+function legacyLocalAppRuntimeSource(extensionId, name) {
+	return `export default {
+  id: ${JSON.stringify(extensionId)},
+  name: ${JSON.stringify(name)},
+  version: '0.1.0',
+  kind: 'utility',
+  register(api) {
+    api.logger.info('Local app registered');
+  },
+};
+`;
+}
+//#endregion
+export { LOCAL_APP_RUNTIME_ENTRY, LOCAL_APP_RUNTIME_SOURCE, legacyLocalAppRuntimeSource };
+
+//# sourceMappingURL=runtime-entry.js.map

package/dist/src/local-apps/runtime-entry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-entry.js","names":[],"sources":["../../../src/local-apps/runtime-entry.ts"],"sourcesContent":["export const LOCAL_APP_RUNTIME_ENTRY = '.xopc/runtime/local-ui.js';\n\n/**\n * Local UI Apps use host-defined runtime bytes so generated projects cannot execute\n * arbitrary Node.js in the gateway process through the extension `main` entry.\n */\nexport const LOCAL_APP_RUNTIME_SOURCE = `export default Object.freeze({});\n`;\n\n/** Exact legacy scaffold bytes accepted only to keep existing Phase 1 drafts upgradeable. */\nexport function legacyLocalAppRuntimeSource(extensionId: string, name: string): string {\n  return `export default {\n  id: ${JSON.stringify(extensionId)},\n  name: ${JSON.stringify(name)},\n  version: '0.1.0',\n  kind: 'utility',\n  register(api) {\n    api.logger.info('Local app registered');\n  },\n};\n`;\n}\n"],"mappings":";AAAA,MAAa,0BAA0B;;;;;AAMvC,MAAa,2BAA2B;;;AAIxC,SAAgB,4BAA4B,aAAqB,MAAsB;AACrF,QAAO;QACD,KAAK,UAAU,YAAY,CAAC;UAC1B,KAAK,UAAU,KAAK,CAAC"}

package/dist/src/local-apps/scaffold.d.ts

@@ -0,0 +1,8 @@
+export declare function scaffoldLocalApp(input: {
+    workspaceRoot: string;
+    extensionId: string;
+    name: string;
+    idea: string;
+    description?: string;
+}): void;
+export declare function readLocalAppPermissions(workspaceRoot: string): string[];

package/dist/src/local-apps/scaffold.js

@@ -0,0 +1,122 @@
+import { LOCAL_APP_RUNTIME_ENTRY, LOCAL_APP_RUNTIME_SOURCE } from "./runtime-entry.js";
+import { dirname, join } from "node:path";
+import { mkdirSync, readFileSync, writeFileSync } from "node:fs";
+//#region src/local-apps/scaffold.ts
+const LOCAL_APP_PERMISSIONS = ["theme", "storage"];
+function writeText(root, relativePath, content) {
+	const target = join(root, relativePath);
+	mkdirSync(dirname(target), { recursive: true });
+	writeFileSync(target, content, "utf8");
+}
+function htmlEscape(value) {
+	return value.replace(/[&<>"']/g, (char) => ({
+		"&": "&amp;",
+		"<": "&lt;",
+		">": "&gt;",
+		"\"": "&quot;",
+		"'": "&#39;"
+	})[char]);
+}
+function scaffoldLocalApp(input) {
+	const { workspaceRoot, extensionId, name, idea, description } = input;
+	const manifest = {
+		id: extensionId,
+		name,
+		description: description || idea,
+		version: "0.1.0",
+		kind: "utility",
+		main: LOCAL_APP_RUNTIME_ENTRY,
+		ui: {
+			main: "ui/index.html",
+			permissions: [...LOCAL_APP_PERMISSIONS],
+			contributions: { pages: [{
+				id: "app",
+				title: name,
+				path: `/extensions/${extensionId}`,
+				entrypoint: "ui/index.html",
+				showInNav: true,
+				navIcon: "layout-dashboard"
+			}] }
+		},
+		engines: { xopc: ">=0.0.106 <1.0.0" }
+	};
+	writeText(workspaceRoot, "xopc.extension.json", `${JSON.stringify(manifest, null, 2)}\n`);
+	writeText(workspaceRoot, "package.json", `${JSON.stringify({
+		name: extensionId,
+		private: true,
+		version: "0.1.0",
+		type: "module"
+	}, null, 2)}\n`);
+	writeText(workspaceRoot, LOCAL_APP_RUNTIME_ENTRY, LOCAL_APP_RUNTIME_SOURCE);
+	writeText(workspaceRoot, "APP_BRIEF.md", `# ${name}\n\n${idea}\n\n## Product constraints\n\n- Keep the app local to this XOPC installation.\n- Preserve the extension id: \`${extensionId}\`.\n- Phase 1 is UI-only. Use only the declared theme and storage permissions.\n- Do not edit the manifest \`main\` field or \`${LOCAL_APP_RUNTIME_ENTRY}\`; xopc owns the trusted runtime entry.\n- Keep critical user journeys in \`.xopc/acceptance.json\`. Target only elements marked with \`data-xopc-test-id\`.\n- Run the local-app validation script before asking the user to install an update.\n`);
+	writeText(workspaceRoot, ".xopc/app.json", `${JSON.stringify({
+		schemaVersion: 1,
+		extensionId,
+		capabilityLevel: "ui",
+		entrypoint: "ui/index.html"
+	}, null, 2)}\n`);
+	writeText(workspaceRoot, ".xopc/acceptance.json", `${JSON.stringify({
+		schemaVersion: 1,
+		scenarios: [{
+			id: "start-app",
+			name: "Start the app",
+			steps: [{
+				action: "click",
+				target: "primary-action"
+			}, {
+				assert: "text_visible",
+				text: "应用已就绪"
+			}]
+		}]
+	}, null, 2)}\n`);
+	writeText(workspaceRoot, "ui/index.html", `<!doctype html>
+<html lang="zh-CN">
+<head>
+  <meta charset="UTF-8" />
+  <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+  <title>${htmlEscape(name)}</title>
+  <link rel="stylesheet" href="./styles.css" />
+</head>
+<body>
+  <main class="app-shell">
+    <section class="hero">
+      <h1>${htmlEscape(name)}</h1>
+      <p>${htmlEscape(description || idea)}</p>
+      <button id="primary-action" data-xopc-test-id="primary-action" type="button">开始使用</button>
+      <p id="feedback" data-xopc-test-id="feedback" class="feedback" aria-live="polite"></p>
+    </section>
+  </main>
+  <script type="module" src="./app.js"><\/script>
+</body>
+</html>
+`);
+	writeText(workspaceRoot, "ui/styles.css", `:root { color-scheme: light dark; font-family: Inter, ui-sans-serif, system-ui, sans-serif; }
+* { box-sizing: border-box; }
+body { margin: 0; min-height: 100vh; background: #f8fafc; color: #0f172a; }
+.app-shell { min-height: 100vh; display: grid; place-items: center; padding: 32px; }
+.hero { width: min(680px, 100%); padding: 40px; border: 1px solid #e2e8f0; border-radius: 16px; background: #fff; }
+h1 { margin: 0 0 12px; font-size: clamp(32px, 6vw, 56px); line-height: 1.05; letter-spacing: -.03em; text-wrap: balance; }
+p { color: #475569; line-height: 1.7; }
+button { margin-top: 18px; border: 0; border-radius: 10px; padding: 11px 18px; background: #2563eb; color: #fff; font: inherit; font-weight: 650; cursor: pointer; }
+.feedback { min-height: 24px; font-size: 14px; }
+@media (prefers-color-scheme: dark) { body { background: #0f172a; color: #f8fafc; } .hero { background: #111827; border-color: #334155; } p { color: #cbd5e1; } }
+`);
+	writeText(workspaceRoot, "ui/app.js", `const button = document.querySelector('#primary-action');
+const feedback = document.querySelector('#feedback');
+button?.addEventListener('click', () => {
+  feedback.textContent = '应用已就绪。接下来可以在 Project 中继续告诉 Coder 你的想法。';
+});
+`);
+}
+function readLocalAppPermissions(workspaceRoot) {
+	try {
+		const raw = JSON.parse(readFileSync(join(workspaceRoot, "xopc.extension.json"), "utf8"));
+		return Array.isArray(raw.ui?.permissions) ? raw.ui.permissions.filter((permission) => typeof permission === "string") : [];
+	} catch {
+		return [];
+	}
+}
+//#endregion
+export { readLocalAppPermissions, scaffoldLocalApp };
+
+//# sourceMappingURL=scaffold.js.map

package/dist/src/local-apps/scaffold.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scaffold.js","names":[],"sources":["../../../src/local-apps/scaffold.ts"],"sourcesContent":["import { mkdirSync, readFileSync, writeFileSync } from 'node:fs';\nimport { dirname, join } from 'node:path';\n\nimport { LOCAL_APP_RUNTIME_ENTRY, LOCAL_APP_RUNTIME_SOURCE } from './runtime-entry.js';\n\nconst LOCAL_APP_PERMISSIONS = ['theme', 'storage'] as const;\n\nfunction writeText(root: string, relativePath: string, content: string): void {\n  const target = join(root, relativePath);\n  mkdirSync(dirname(target), { recursive: true });\n  writeFileSync(target, content, 'utf8');\n}\n\nfunction htmlEscape(value: string): string {\n  return value.replace(/[&<>\"']/g, (char) => ({\n    '&': '&amp;', '<': '&lt;', '>': '&gt;', '\"': '&quot;', \"'\": '&#39;',\n  })[char]!);\n}\n\nexport function scaffoldLocalApp(input: {\n  workspaceRoot: string;\n  extensionId: string;\n  name: string;\n  idea: string;\n  description?: string;\n}): void {\n  const { workspaceRoot, extensionId, name, idea, description } = input;\n  const manifest = {\n    id: extensionId,\n    name,\n    description: description || idea,\n    version: '0.1.0',\n    kind: 'utility',\n    main: LOCAL_APP_RUNTIME_ENTRY,\n    ui: {\n      main: 'ui/index.html',\n      permissions: [...LOCAL_APP_PERMISSIONS],\n      contributions: {\n        pages: [{\n          id: 'app',\n          title: name,\n          path: `/extensions/${extensionId}`,\n          entrypoint: 'ui/index.html',\n          showInNav: true,\n          navIcon: 'layout-dashboard',\n        }],\n      },\n    },\n    engines: { xopc: '>=0.0.106 <1.0.0' },\n  };\n\n  writeText(workspaceRoot, 'xopc.extension.json', `${JSON.stringify(manifest, null, 2)}\\n`);\n  writeText(workspaceRoot, 'package.json', `${JSON.stringify({\n    name: extensionId,\n    private: true,\n    version: '0.1.0',\n    type: 'module',\n  }, null, 2)}\\n`);\n  writeText(workspaceRoot, LOCAL_APP_RUNTIME_ENTRY, LOCAL_APP_RUNTIME_SOURCE);\n  writeText(workspaceRoot, 'APP_BRIEF.md', `# ${name}\\n\\n${idea}\\n\\n## Product constraints\\n\\n- Keep the app local to this XOPC installation.\\n- Preserve the extension id: \\`${extensionId}\\`.\\n- Phase 1 is UI-only. Use only the declared theme and storage permissions.\\n- Do not edit the manifest \\`main\\` field or \\`${LOCAL_APP_RUNTIME_ENTRY}\\`; xopc owns the trusted runtime entry.\\n- Keep critical user journeys in \\`.xopc/acceptance.json\\`. Target only elements marked with \\`data-xopc-test-id\\`.\\n- Run the local-app validation script before asking the user to install an update.\\n`);\n  writeText(workspaceRoot, '.xopc/app.json', `${JSON.stringify({\n    schemaVersion: 1,\n    extensionId,\n    capabilityLevel: 'ui',\n    entrypoint: 'ui/index.html',\n  }, null, 2)}\\n`);\n  writeText(workspaceRoot, '.xopc/acceptance.json', `${JSON.stringify({\n    schemaVersion: 1,\n    scenarios: [{\n      id: 'start-app',\n      name: 'Start the app',\n      steps: [\n        { action: 'click', target: 'primary-action' },\n        { assert: 'text_visible', text: '应用已就绪' },\n      ],\n    }],\n  }, null, 2)}\\n`);\n  writeText(workspaceRoot, 'ui/index.html', `<!doctype html>\n<html lang=\"zh-CN\">\n<head>\n  <meta charset=\"UTF-8\" />\n  <meta name=\"viewport\" content=\"width=device-width, initial-scale=1.0\" />\n  <title>${htmlEscape(name)}</title>\n  <link rel=\"stylesheet\" href=\"./styles.css\" />\n</head>\n<body>\n  <main class=\"app-shell\">\n    <section class=\"hero\">\n      <h1>${htmlEscape(name)}</h1>\n      <p>${htmlEscape(description || idea)}</p>\n      <button id=\"primary-action\" data-xopc-test-id=\"primary-action\" type=\"button\">开始使用</button>\n      <p id=\"feedback\" data-xopc-test-id=\"feedback\" class=\"feedback\" aria-live=\"polite\"></p>\n    </section>\n  </main>\n  <script type=\"module\" src=\"./app.js\"></script>\n</body>\n</html>\n`);\n  writeText(workspaceRoot, 'ui/styles.css', `:root { color-scheme: light dark; font-family: Inter, ui-sans-serif, system-ui, sans-serif; }\n* { box-sizing: border-box; }\nbody { margin: 0; min-height: 100vh; background: #f8fafc; color: #0f172a; }\n.app-shell { min-height: 100vh; display: grid; place-items: center; padding: 32px; }\n.hero { width: min(680px, 100%); padding: 40px; border: 1px solid #e2e8f0; border-radius: 16px; background: #fff; }\nh1 { margin: 0 0 12px; font-size: clamp(32px, 6vw, 56px); line-height: 1.05; letter-spacing: -.03em; text-wrap: balance; }\np { color: #475569; line-height: 1.7; }\nbutton { margin-top: 18px; border: 0; border-radius: 10px; padding: 11px 18px; background: #2563eb; color: #fff; font: inherit; font-weight: 650; cursor: pointer; }\n.feedback { min-height: 24px; font-size: 14px; }\n@media (prefers-color-scheme: dark) { body { background: #0f172a; color: #f8fafc; } .hero { background: #111827; border-color: #334155; } p { color: #cbd5e1; } }\n`);\n  writeText(workspaceRoot, 'ui/app.js', `const button = document.querySelector('#primary-action');\nconst feedback = document.querySelector('#feedback');\nbutton?.addEventListener('click', () => {\n  feedback.textContent = '应用已就绪。接下来可以在 Project 中继续告诉 Coder 你的想法。';\n});\n`);\n}\n\nexport function readLocalAppPermissions(workspaceRoot: string): string[] {\n  try {\n    const raw = JSON.parse(readFileSync(join(workspaceRoot, 'xopc.extension.json'), 'utf8')) as {\n      ui?: { permissions?: unknown };\n    };\n    return Array.isArray(raw.ui?.permissions)\n      ? raw.ui.permissions.filter((permission): permission is string => typeof permission === 'string')\n      : [];\n  } catch {\n    return [];\n  }\n}\n"],"mappings":";;;;AAKA,MAAM,wBAAwB,CAAC,SAAS,UAAU;AAElD,SAAS,UAAU,MAAc,cAAsB,SAAuB;CAC5E,MAAM,SAAS,KAAK,MAAM,aAAa;AACvC,WAAU,QAAQ,OAAO,EAAE,EAAE,WAAW,MAAM,CAAC;AAC/C,eAAc,QAAQ,SAAS,OAAO;;AAGxC,SAAS,WAAW,OAAuB;AACzC,QAAO,MAAM,QAAQ,aAAa,UAAU;EAC1C,KAAK;EAAS,KAAK;EAAQ,KAAK;EAAQ,MAAK;EAAU,KAAK;EAC7D,EAAE,MAAO;;AAGZ,SAAgB,iBAAiB,OAMxB;CACP,MAAM,EAAE,eAAe,aAAa,MAAM,MAAM,gBAAgB;CAChE,MAAM,WAAW;EACf,IAAI;EACJ;EACA,aAAa,eAAe;EAC5B,SAAS;EACT,MAAM;EACN,MAAM;EACN,IAAI;GACF,MAAM;GACN,aAAa,CAAC,GAAG,sBAAsB;GACvC,eAAe,EACb,OAAO,CAAC;IACN,IAAI;IACJ,OAAO;IACP,MAAM,eAAe;IACrB,YAAY;IACZ,WAAW;IACX,SAAS;IACV,CAAC,EACH;GACF;EACD,SAAS,EAAE,MAAM,oBAAoB;EACtC;AAED,WAAU,eAAe,uBAAuB,GAAG,KAAK,UAAU,UAAU,MAAM,EAAE,CAAC,IAAI;AACzF,WAAU,eAAe,gBAAgB,GAAG,KAAK,UAAU;EACzD,MAAM;EACN,SAAS;EACT,SAAS;EACT,MAAM;EACP,EAAE,MAAM,EAAE,CAAC,IAAI;AAChB,WAAU,eAAe,yBAAyB,yBAAyB;AAC3E,WAAU,eAAe,gBAAgB,KAAK,KAAK,MAAM,KAAK,gHAAgH,YAAY,kIAAkI,wBAAwB,qPAAqP;AACzkB,WAAU,eAAe,kBAAkB,GAAG,KAAK,UAAU;EAC3D,eAAe;EACf;EACA,iBAAiB;EACjB,YAAY;EACb,EAAE,MAAM,EAAE,CAAC,IAAI;AAChB,WAAU,eAAe,yBAAyB,GAAG,KAAK,UAAU;EAClE,eAAe;EACf,WAAW,CAAC;GACV,IAAI;GACJ,MAAM;GACN,OAAO,CACL;IAAE,QAAQ;IAAS,QAAQ;IAAkB,EAC7C;IAAE,QAAQ;IAAgB,MAAM;IAAS,CAC1C;GACF,CAAC;EACH,EAAE,MAAM,EAAE,CAAC,IAAI;AAChB,WAAU,eAAe,iBAAiB;;;;;WAKjC,WAAW,KAAK,CAAC;;;;;;YAMhB,WAAW,KAAK,CAAC;WAClB,WAAW,eAAe,KAAK,CAAC;;;;;;;;EAQzC;AACA,WAAU,eAAe,iBAAiB;;;;;;;;;;EAU1C;AACA,WAAU,eAAe,aAAa;;;;;EAKtC;;AAGF,SAAgB,wBAAwB,eAAiC;AACvE,KAAI;EACF,MAAM,MAAM,KAAK,MAAM,aAAa,KAAK,eAAe,sBAAsB,EAAE,OAAO,CAAC;AAGxF,SAAO,MAAM,QAAQ,IAAI,IAAI,YAAY,GACrC,IAAI,GAAG,YAAY,QAAQ,eAAqC,OAAO,eAAe,SAAS,GAC/F,EAAE;SACA;AACN,SAAO,EAAE"}

package/dist/src/local-apps/service.d.ts

@@ -0,0 +1,37 @@
+import type { Config } from '../config/schema.js';
+import type { ExtensionLoader } from '../extensions/index.js';
+import type { ProjectService } from '../projects/index.js';
+import { LocalAppStore } from './store.js';
+import type { CreateLocalAppInput, LocalApp, LocalAppAcceptanceRun, LocalAppDetail, LocalAppPreviewTarget, LocalAppValidationResult, LocalAppUiGrant, RecordLocalAppAcceptanceInput } from './types.js';
+export interface LocalAppServiceOptions {
+    projects: ProjectService;
+    workspaceRoot: string;
+    getConfig: () => Config;
+    saveConfig: (config: Config) => Promise<{
+        saved: boolean;
+        error?: string;
+    }>;
+    getExtensionLoader: () => ExtensionLoader | null;
+    emit: (type: string, payload: unknown) => void;
+}
+export declare class LocalAppService {
+    private readonly options;
+    private readonly store;
+    constructor(options: LocalAppServiceOptions, store?: LocalAppStore);
+    list(): LocalApp[];
+    get(id: string): LocalAppDetail | null;
+    getUiGrant(extensionId: string): LocalAppUiGrant;
+    grantUiPermissions(extensionId: string): LocalAppUiGrant;
+    create(input: CreateLocalAppInput): LocalAppDetail;
+    resolvePreview(previewToken: string): LocalAppPreviewTarget | null;
+    validate(id: string): LocalAppValidationResult;
+    recordAcceptance(id: string, input: RecordLocalAppAcceptanceInput): LocalAppAcceptanceRun;
+    private releaseRoot;
+    private refreshExtensions;
+    private assertInstalledRuntime;
+    private activateArtifact;
+    install(id: string): Promise<LocalAppDetail>;
+    rollback(id: string, releaseId: string): Promise<LocalAppDetail>;
+    setEnabled(id: string, enabled: boolean): Promise<LocalAppDetail>;
+    uninstall(id: string): Promise<LocalAppDetail>;
+}