@eclipse-docks/extension-canvas 0.0.0-stage → 0.8.0

package/dist/compile.js

@@ -0,0 +1,398 @@
+//#region src/compile.ts
+var TEXT_EXT = /* @__PURE__ */ new Set([
+	"js",
+	"mjs",
+	"css",
+	"json",
+	"svg",
+	"txt",
+	"md",
+	"html",
+	"csv"
+]);
+var MIME = {
+	png: "image/png",
+	jpg: "image/jpeg",
+	jpeg: "image/jpeg",
+	gif: "image/gif",
+	webp: "image/webp",
+	ico: "image/x-icon",
+	woff: "font/woff",
+	woff2: "font/woff2",
+	pdf: "application/pdf",
+	wasm: "application/wasm",
+	svg: "image/svg+xml"
+};
+function resolveWorkspacePath(fromFile, spec) {
+	const base = fromFile.split("/").filter(Boolean);
+	base.pop();
+	for (const part of spec.split("/")) {
+		if (part === "" || part === ".") continue;
+		if (part === "..") base.pop();
+		else base.push(part);
+	}
+	return base.join("/");
+}
+function isRelativeSpecifier(spec) {
+	return spec.startsWith("./") || spec.startsWith("../");
+}
+function bridgeRuntime(spec, bridges) {
+	if (spec === "docks/lit" || spec === "@eclipse-docks/core/externals/lit") return "__docksCanvas.lit";
+	if (spec === "docks/webawesome" || spec === "@eclipse-docks/core/externals/webawesome") return "__docksCanvas.webawesome";
+	if (spec === "docks/core" || spec === "@eclipse-docks/core") return "__docksCanvas.core";
+	const sub = coreSubpath(spec);
+	if (!sub || !bridges.coreSubpaths[sub]) return null;
+	return `__docksCanvas.subpaths[${JSON.stringify(sub)}]`;
+}
+function rewriteBridgeSpecifier(spec, bridges) {
+	if (spec === "docks/lit" || spec === "@eclipse-docks/core/externals/lit") return bridges.lit;
+	if (spec === "docks/webawesome" || spec === "@eclipse-docks/core/externals/webawesome") return bridges.webawesome;
+	if (spec === "docks/core" || spec === "@eclipse-docks/core") return bridges.core;
+	const sub = coreSubpath(spec);
+	if (!sub) return spec;
+	return bridges.coreSubpaths[sub] ?? spec;
+}
+function coreSubpath(spec) {
+	if (spec.startsWith("@eclipse-docks/core/")) return `./${spec.slice(20)}`;
+	if (spec.startsWith("docks/core/")) return `./${spec.slice(11)}`;
+	return null;
+}
+function extensionOf(path) {
+	const base = path.split("/").pop() ?? path;
+	const dot = base.lastIndexOf(".");
+	return dot >= 0 ? base.slice(dot + 1).toLowerCase() : "";
+}
+function isJavaScript(path) {
+	const ext = extensionOf(path);
+	return ext === "js" || ext === "mjs" || path.endsWith(".canvas.js");
+}
+function toBase64(bytes) {
+	const bufferCtor = globalThis.Buffer;
+	if (bufferCtor) return bufferCtor.from(bytes).toString("base64");
+	let binary = "";
+	for (const byte of bytes) binary += String.fromCharCode(byte);
+	return btoa(binary);
+}
+function findRefs(code) {
+	const patterns = [
+		{
+			form: "asset-url",
+			re: /new\s+URL\(\s*(['"])([^'"]+)\1\s*,\s*import\.meta\.url\s*\)/g
+		},
+		{
+			form: "dynamic",
+			re: /\bimport\(\s*(['"])([^'"]+)\1\s*\)/g
+		},
+		{
+			form: "export-from",
+			re: /\bexport\s+(?:type\s+)?(?:\*\s+as\s+\w+|\*|\{[^}]*\})\s+from\s*(['"])([^'"]+)\1/g
+		},
+		{
+			form: "import",
+			re: /\bimport\s+(?:type\s+)?(?:[^'";]*?\s+from\s+)?(['"])([^'"]+)\1/g
+		}
+	];
+	const refs = [];
+	for (const { form, re } of patterns) for (const match of code.matchAll(re)) {
+		const spec = match[2];
+		if (!spec || match.index === void 0) continue;
+		refs.push({
+			spec,
+			start: match.index,
+			end: match.index + match[0].length,
+			raw: match[0],
+			form
+		});
+	}
+	refs.sort((a, b) => a.start - b.start || b.end - a.end);
+	const kept = [];
+	let cursor = -1;
+	for (const ref of refs) {
+		if (ref.start < cursor) continue;
+		kept.push(ref);
+		cursor = ref.end;
+	}
+	return kept;
+}
+function rewriteLocalExports(code) {
+	let out = code.replace(/export\s+default\s+/g, "__exports.default = ");
+	out = out.replace(/export\s+(async\s+)?function\s+(\w+)/g, (_all, asyncKw, name) => {
+		return `__exports.${name} = ${asyncKw ?? ""}function ${name}`;
+	});
+	out = out.replace(/export\s+class\s+(\w+)/g, "__exports.$1 = class $1");
+	out = out.replace(/export\s+(const|let|var)\s+(\w+)\s*=/g, "$1 $2 = __exports.$2 =");
+	out = out.replace(/export\s*\{([^}]+)\}\s*;?/g, (_all, inner) => {
+		return inner.split(",").map((part) => {
+			const [from, alias] = part.split(/\s+as\s+/).map((piece) => piece.trim());
+			if (!from) return "";
+			return `__exports.${alias || from} = ${from};`;
+		}).join("\n");
+	});
+	return out;
+}
+function externalBinding(specUrl, imported, externals, seq) {
+	const existing = externals.find((item) => item.line.includes(JSON.stringify(specUrl)) && item.imported === imported);
+	if (existing) return existing.local;
+	const local = `__ext_${seq.n++}`;
+	if (imported === "*") externals.push({
+		local,
+		imported,
+		line: `import * as ${local} from ${JSON.stringify(specUrl)};`
+	});
+	else if (imported === "side") externals.push({
+		local,
+		imported,
+		line: `import ${JSON.stringify(specUrl)};`
+	});
+	else externals.push({
+		local,
+		imported,
+		line: `import { ${imported} as ${local} } from ${JSON.stringify(specUrl)};`
+	});
+	return local;
+}
+function importPrelude(raw, load) {
+	const clause = raw.replace(/\s+/g, " ").trim();
+	if (/^import\s+['"]/.test(clause)) return `await ${load};`;
+	const named = clause.match(/\{([^}]*)\}/);
+	const namespace = clause.match(/\*\s+as\s+(\w+)/);
+	const defaultName = clause.match(/^import\s+(?!type\b)(\w+)\s*(?:,|from)/);
+	const lines = [];
+	if (defaultName) lines.push(`const ${defaultName[1]} = (await ${load}).default;`);
+	if (namespace) lines.push(`const ${namespace[1]} = await ${load};`);
+	if (named) {
+		const pairs = named[1].split(",").map((part) => part.trim()).filter(Boolean).map((part) => {
+			const [imported, alias] = part.split(/\s+as\s+/).map((piece) => piece.trim());
+			return alias ? `${imported}: ${alias}` : imported;
+		});
+		if (pairs.length) lines.push(`const { ${pairs.join(", ")} } = await ${load};`);
+	}
+	return lines.join("\n");
+}
+function exportFromPrelude(raw, load) {
+	if (/\*\s+as\s+(\w+)/.test(raw)) {
+		const name = raw.match(/\*\s+as\s+(\w+)/)?.[1] ?? "ns";
+		return `const ${name} = await ${load};\nObject.assign(__exports, { ${name} });`;
+	}
+	if (raw.includes("*")) return `Object.assign(__exports, await ${load});\ndelete __exports.default;`;
+	return (raw.match(/\{([^}]*)\}/)?.[1] ?? "").split(",").map((part) => part.trim()).filter(Boolean).map((part) => {
+		const [imported, alias] = part.split(/\s+as\s+/).map((piece) => piece.trim());
+		return `__exports.${alias || imported} = (await ${load}).${imported};`;
+	}).join("\n");
+}
+async function compileCanvas(input) {
+	const modules = [];
+	const indexByPath = /* @__PURE__ */ new Map();
+	const stack = [];
+	const addModule = async (path, source) => {
+		const known = indexByPath.get(path);
+		if (known !== void 0) return known;
+		if (stack.includes(path)) return `Circular workspace import: ${[...stack, path].join(" -> ")}`;
+		stack.push(path);
+		const ext = extensionOf(path);
+		let mod;
+		if (source !== void 0) mod = {
+			path,
+			kind: "js",
+			text: source
+		};
+		else if (isJavaScript(path)) {
+			const file = await input.read(path);
+			if (!file?.text && file?.text !== "") return missing(path);
+			mod = {
+				path,
+				kind: "js",
+				text: file?.text ?? ""
+			};
+		} else if (ext === "json" || TEXT_EXT.has(ext)) {
+			const file = await input.read(path);
+			if (file?.text === void 0) return missing(path);
+			mod = {
+				path,
+				kind: ext === "json" ? "json" : "text",
+				text: file.text
+			};
+		} else {
+			const file = await input.read(path);
+			const bytes = file?.bytes ?? (file?.text !== void 0 ? new TextEncoder().encode(file.text) : void 0);
+			if (!bytes) return missing(path);
+			mod = {
+				path,
+				kind: "binary",
+				bytes,
+				mime: MIME[ext] ?? "application/octet-stream"
+			};
+		}
+		const id = modules.length;
+		modules.push(mod);
+		indexByPath.set(path, id);
+		if (mod.kind === "js" && mod.text !== void 0) for (const ref of findRefs(mod.text)) {
+			if (!isRelativeSpecifier(ref.spec)) continue;
+			const resolved = resolveWorkspacePath(path, ref.spec);
+			const child = await addModule(resolved);
+			if (typeof child === "string") return child;
+		}
+		stack.pop();
+		return id;
+	};
+	const missing = (path) => `Cannot find workspace file "${path}"`;
+	const entryId = await addModule(input.entryPath, input.entrySource);
+	if (typeof entryId === "string") return {
+		ok: false,
+		error: entryId
+	};
+	const externals = [];
+	const seq = { n: 0 };
+	const factories = [];
+	for (const mod of modules) {
+		if (mod.kind === "json") {
+			try {
+				const value = JSON.parse(mod.text ?? "");
+				factories.push(`async () => ({ default: ${JSON.stringify(value)} })`);
+			} catch (err) {
+				return {
+					ok: false,
+					error: `Invalid JSON in ${mod.path}: ${err instanceof Error ? err.message : String(err)}`
+				};
+			}
+			continue;
+		}
+		if (mod.kind === "text") {
+			const cssInject = extensionOf(mod.path) === "css" ? `const __css = ${JSON.stringify(mod.text ?? "")};
+const __cssId = ${JSON.stringify(`docks-canvas-css-${mod.path}`)};
+if (typeof document !== "undefined" && !document.getElementById(__cssId)) {
+  const __style = document.createElement("style");
+  __style.id = __cssId;
+  __style.textContent = __css;
+  document.head.append(__style);
+}
+return { default: __css };` : `return { default: ${JSON.stringify(mod.text ?? "")} };`;
+			factories.push(`async () => { ${cssInject} }`);
+			continue;
+		}
+		if (mod.kind === "binary") {
+			const href = `data:${mod.mime};base64,${toBase64(mod.bytes ?? /* @__PURE__ */ new Uint8Array())}`;
+			factories.push(`async () => ({ default: ${JSON.stringify(href)} })`);
+			continue;
+		}
+		const refs = findRefs(mod.text ?? "").sort((a, b) => b.start - a.start);
+		let body = mod.text ?? "";
+		const preludes = [];
+		for (const ref of refs) {
+			const resolvedUrl = rewriteBridgeSpecifier(ref.spec, input.bridges);
+			let replacement = "";
+			if (ref.form === "asset-url") {
+				if (!isRelativeSpecifier(ref.spec)) replacement = ref.raw;
+				else {
+					const assetPath = resolveWorkspacePath(mod.path, ref.spec);
+					const assetId = indexByPath.get(assetPath);
+					if (assetId === void 0) return {
+						ok: false,
+						error: missing(assetPath)
+					};
+					replacement = `(await __req(${assetId})).default`;
+				}
+			} else if (isRelativeSpecifier(ref.spec)) {
+				const depPath = resolveWorkspacePath(mod.path, ref.spec);
+				const depId = indexByPath.get(depPath);
+				if (depId === void 0) return {
+					ok: false,
+					error: missing(depPath)
+				};
+				const load = `__req(${depId})`;
+				if (ref.form === "dynamic") replacement = load;
+				else if (ref.form === "export-from") preludes.push(exportFromPrelude(ref.raw, load));
+				else preludes.push(importPrelude(ref.raw, load));
+			} else if (ref.form === "dynamic") {
+				const runtime = bridgeRuntime(ref.spec, input.bridges);
+				replacement = runtime ? `Promise.resolve(${runtime})` : `import(${JSON.stringify(resolvedUrl)})`;
+				if (runtime) externalBinding(resolvedUrl, "side", externals, seq);
+			} else {
+				const runtime = bridgeRuntime(ref.spec, input.bridges);
+				if (runtime) {
+					externalBinding(resolvedUrl, "side", externals, seq);
+					if (ref.form === "import" && !/^import\s+['"]/.test(ref.raw.trim())) preludes.push(runtimeImportPrelude(ref.raw, runtime));
+					else if (ref.form === "export-from") preludes.push(runtimeExportFromPrelude(ref.raw, runtime));
+					else if (ref.form === "import") preludes.push(`void ${runtime};`);
+				} else {
+					const localFor = (imported) => externalBinding(resolvedUrl, imported, externals, seq);
+					if (ref.form === "import" && /^import\s+['"]/.test(ref.raw.trim())) externalBinding(resolvedUrl, "side", externals, seq);
+					else if (ref.form === "import") preludes.push(externalImportPrelude(ref.raw, localFor));
+					else if (ref.form === "export-from") preludes.push(externalExportFromPrelude(ref.raw, localFor));
+				}
+			}
+			if (ref.form === "import" || ref.form === "export-from") replacement = "";
+			body = body.slice(0, ref.start) + replacement + body.slice(ref.end);
+		}
+		body = rewriteLocalExports(body);
+		factories.push(`async () => {
+  const __exports = {};
+  ${preludes.join("\n")}
+  ${body}
+  return __exports;
+}`);
+	}
+	return {
+		ok: true,
+		code: `${[...new Set(externals.map((item) => item.line))].join("\n")}
+const __factories = [
+${factories.join(",\n")}
+];
+const __cache = new Map();
+async function __req(id) {
+  if (__cache.has(id)) return __cache.get(id);
+  const pending = __factories[id]();
+  __cache.set(id, pending);
+  return pending;
+}
+const __entry = await __req(${entryId});
+export default __entry.default;
+`
+	};
+}
+function runtimeImportPrelude(raw, runtime) {
+	const clause = raw.replace(/\s+/g, " ").trim();
+	const lines = [];
+	const defaultName = clause.match(/^import\s+(?!type\b)(\w+)\s*(?:,|from)/);
+	const namespace = clause.match(/\*\s+as\s+(\w+)/);
+	const named = clause.match(/\{([^}]*)\}/);
+	if (defaultName) lines.push(`const ${defaultName[1]} = ${runtime}.default;`);
+	if (namespace) lines.push(`const ${namespace[1]} = ${runtime};`);
+	if (named) for (const part of named[1].split(",").map((piece) => piece.trim()).filter(Boolean)) {
+		const [imported, alias] = part.split(/\s+as\s+/).map((piece) => piece.trim());
+		lines.push(`const ${alias || imported} = ${runtime}.${imported};`);
+	}
+	return lines.join("\n");
+}
+function runtimeExportFromPrelude(raw, runtime) {
+	if (raw.includes("*") && !raw.includes("{")) return `Object.assign(__exports, ${runtime});\ndelete __exports.default;`;
+	return (raw.match(/\{([^}]*)\}/)?.[1] ?? "").split(",").map((part) => part.trim()).filter(Boolean).map((part) => {
+		const [imported, alias] = part.split(/\s+as\s+/).map((piece) => piece.trim());
+		return `__exports.${alias || imported} = ${runtime}.${imported};`;
+	}).join("\n");
+}
+function externalImportPrelude(raw, localFor) {
+	const clause = raw.replace(/\s+/g, " ").trim();
+	const lines = [];
+	const defaultName = clause.match(/^import\s+(?!type\b)(\w+)\s*(?:,|from)/);
+	const namespace = clause.match(/\*\s+as\s+(\w+)/);
+	const named = clause.match(/\{([^}]*)\}/);
+	if (defaultName) lines.push(`const ${defaultName[1]} = ${localFor("default")};`);
+	if (namespace) lines.push(`const ${namespace[1]} = ${localFor("*")};`);
+	if (named) for (const part of named[1].split(",").map((piece) => piece.trim()).filter(Boolean)) {
+		const [imported, alias] = part.split(/\s+as\s+/).map((piece) => piece.trim());
+		lines.push(`const ${alias || imported} = ${localFor(imported)};`);
+	}
+	return lines.join("\n");
+}
+function externalExportFromPrelude(raw, localFor) {
+	if (raw.includes("*") && !raw.includes("{")) return `Object.assign(__exports, ${localFor("*")});\ndelete __exports.default;`;
+	return (raw.match(/\{([^}]*)\}/)?.[1] ?? "").split(",").map((part) => part.trim()).filter(Boolean).map((part) => {
+		const [imported, alias] = part.split(/\s+as\s+/).map((piece) => piece.trim());
+		return `__exports.${alias || imported} = ${localFor(imported)};`;
+	}).join("\n");
+}
+//#endregion
+export { bridgeRuntime, compileCanvas, isRelativeSpecifier, resolveWorkspacePath, rewriteBridgeSpecifier };
+
+//# sourceMappingURL=compile.js.map

package/dist/compile.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compile.js","names":[],"sources":["../src/compile.ts"],"sourcesContent":["export interface CanvasFileBytes {\n    text?: string;\n    bytes?: Uint8Array;\n}\n\nexport type CanvasFileReader = (path: string) => Promise<CanvasFileBytes | null>;\n\nexport interface CanvasBridges {\n    lit: string;\n    webawesome: string;\n    core: string;\n    /** Package export subpath (`./parts`) to a module URL. */\n    coreSubpaths: Record<string, string>;\n}\n\nexport interface CompileCanvasInput {\n    entryPath: string;\n    entrySource: string;\n    read: CanvasFileReader;\n    bridges: CanvasBridges;\n}\n\nexport type CompileCanvasResult = { ok: true; code: string } | { ok: false; error: string };\n\ninterface GraphModule {\n    path: string;\n    kind: \"js\" | \"json\" | \"text\" | \"binary\";\n    text?: string;\n    bytes?: Uint8Array;\n    mime?: string;\n}\n\ninterface SpecRef {\n    spec: string;\n    start: number;\n    end: number;\n    raw: string;\n    form: \"import\" | \"export-from\" | \"dynamic\" | \"asset-url\";\n}\n\nconst TEXT_EXT = new Set([\"js\", \"mjs\", \"css\", \"json\", \"svg\", \"txt\", \"md\", \"html\", \"csv\"]);\nconst MIME: Record<string, string> = {\n    png: \"image/png\",\n    jpg: \"image/jpeg\",\n    jpeg: \"image/jpeg\",\n    gif: \"image/gif\",\n    webp: \"image/webp\",\n    ico: \"image/x-icon\",\n    woff: \"font/woff\",\n    woff2: \"font/woff2\",\n    pdf: \"application/pdf\",\n    wasm: \"application/wasm\",\n    svg: \"image/svg+xml\",\n};\n\nexport function resolveWorkspacePath(fromFile: string, spec: string): string {\n    const base = fromFile.split(\"/\").filter(Boolean);\n    base.pop();\n    for (const part of spec.split(\"/\")) {\n        if (part === \"\" || part === \".\") continue;\n        if (part === \"..\") base.pop();\n        else base.push(part);\n    }\n    return base.join(\"/\");\n}\n\nexport function isRelativeSpecifier(spec: string): boolean {\n    return spec.startsWith(\"./\") || spec.startsWith(\"../\");\n}\n\nexport function bridgeRuntime(spec: string, bridges: CanvasBridges): string | null {\n    if (spec === \"docks/lit\" || spec === \"@eclipse-docks/core/externals/lit\") return \"__docksCanvas.lit\";\n    if (spec === \"docks/webawesome\" || spec === \"@eclipse-docks/core/externals/webawesome\") return \"__docksCanvas.webawesome\";\n    if (spec === \"docks/core\" || spec === \"@eclipse-docks/core\") return \"__docksCanvas.core\";\n    const sub = coreSubpath(spec);\n    if (!sub || !bridges.coreSubpaths[sub]) return null;\n    return `__docksCanvas.subpaths[${JSON.stringify(sub)}]`;\n}\n\nexport function rewriteBridgeSpecifier(spec: string, bridges: CanvasBridges): string {\n    if (spec === \"docks/lit\" || spec === \"@eclipse-docks/core/externals/lit\") return bridges.lit;\n    if (spec === \"docks/webawesome\" || spec === \"@eclipse-docks/core/externals/webawesome\") return bridges.webawesome;\n    if (spec === \"docks/core\" || spec === \"@eclipse-docks/core\") return bridges.core;\n    const sub = coreSubpath(spec);\n    if (!sub) return spec;\n    return bridges.coreSubpaths[sub] ?? spec;\n}\n\nfunction coreSubpath(spec: string): string | null {\n    if (spec.startsWith(\"@eclipse-docks/core/\")) return `./${spec.slice(\"@eclipse-docks/core/\".length)}`;\n    if (spec.startsWith(\"docks/core/\")) return `./${spec.slice(\"docks/core/\".length)}`;\n    return null;\n}\n\nfunction extensionOf(path: string): string {\n    const base = path.split(\"/\").pop() ?? path;\n    const dot = base.lastIndexOf(\".\");\n    return dot >= 0 ? base.slice(dot + 1).toLowerCase() : \"\";\n}\n\nfunction isJavaScript(path: string): boolean {\n    const ext = extensionOf(path);\n    return ext === \"js\" || ext === \"mjs\" || path.endsWith(\".canvas.js\");\n}\n\nfunction toBase64(bytes: Uint8Array): string {\n    const bufferCtor = (globalThis as { Buffer?: { from(data: Uint8Array): { toString(encoding: string): string } } }).Buffer;\n    if (bufferCtor) return bufferCtor.from(bytes).toString(\"base64\");\n    let binary = \"\";\n    for (const byte of bytes) binary += String.fromCharCode(byte);\n    return btoa(binary);\n}\n\nfunction findRefs(code: string): SpecRef[] {\n    const patterns: Array<{ form: SpecRef[\"form\"]; re: RegExp }> = [\n        { form: \"asset-url\", re: /new\\s+URL\\(\\s*(['\"])([^'\"]+)\\1\\s*,\\s*import\\.meta\\.url\\s*\\)/g },\n        { form: \"dynamic\", re: /\\bimport\\(\\s*(['\"])([^'\"]+)\\1\\s*\\)/g },\n        { form: \"export-from\", re: /\\bexport\\s+(?:type\\s+)?(?:\\*\\s+as\\s+\\w+|\\*|\\{[^}]*\\})\\s+from\\s*(['\"])([^'\"]+)\\1/g },\n        { form: \"import\", re: /\\bimport\\s+(?:type\\s+)?(?:[^'\";]*?\\s+from\\s+)?(['\"])([^'\"]+)\\1/g },\n    ];\n    const refs: SpecRef[] = [];\n    for (const { form, re } of patterns) {\n        for (const match of code.matchAll(re)) {\n            const spec = match[2];\n            if (!spec || match.index === undefined) continue;\n            refs.push({\n                spec,\n                start: match.index,\n                end: match.index + match[0].length,\n                raw: match[0],\n                form,\n            });\n        }\n    }\n    refs.sort((a, b) => a.start - b.start || b.end - a.end);\n    const kept: SpecRef[] = [];\n    let cursor = -1;\n    for (const ref of refs) {\n        if (ref.start < cursor) continue;\n        kept.push(ref);\n        cursor = ref.end;\n    }\n    return kept;\n}\n\nfunction rewriteLocalExports(code: string): string {\n    let out = code.replace(/export\\s+default\\s+/g, \"__exports.default = \");\n    out = out.replace(/export\\s+(async\\s+)?function\\s+(\\w+)/g, (_all, asyncKw: string | undefined, name: string) => {\n        return `__exports.${name} = ${asyncKw ?? \"\"}function ${name}`;\n    });\n    out = out.replace(/export\\s+class\\s+(\\w+)/g, \"__exports.$1 = class $1\");\n    out = out.replace(/export\\s+(const|let|var)\\s+(\\w+)\\s*=/g, \"$1 $2 = __exports.$2 =\");\n    out = out.replace(/export\\s*\\{([^}]+)\\}\\s*;?/g, (_all, inner: string) => {\n        return inner.split(\",\").map(part => {\n            const [from, alias] = part.split(/\\s+as\\s+/).map(piece => piece.trim());\n            if (!from) return \"\";\n            return `__exports.${alias || from} = ${from};`;\n        }).join(\"\\n\");\n    });\n    return out;\n}\n\ninterface ExternalImport {\n    line: string;\n    local: string;\n    imported: string;\n}\n\nfunction externalBinding(specUrl: string, imported: string, externals: ExternalImport[], seq: { n: number }): string {\n    const existing = externals.find(item => item.line.includes(JSON.stringify(specUrl)) && item.imported === imported);\n    if (existing) return existing.local;\n    const local = `__ext_${seq.n++}`;\n    if (imported === \"*\") {\n        externals.push({ local, imported, line: `import * as ${local} from ${JSON.stringify(specUrl)};` });\n    } else if (imported === \"side\") {\n        externals.push({ local, imported, line: `import ${JSON.stringify(specUrl)};` });\n    } else {\n        externals.push({\n            local,\n            imported,\n            line: `import { ${imported} as ${local} } from ${JSON.stringify(specUrl)};`,\n        });\n    }\n    return local;\n}\n\nfunction importPrelude(raw: string, load: string): string {\n    const clause = raw.replace(/\\s+/g, \" \").trim();\n    if (/^import\\s+['\"]/.test(clause)) return `await ${load};`;\n    const named = clause.match(/\\{([^}]*)\\}/);\n    const namespace = clause.match(/\\*\\s+as\\s+(\\w+)/);\n    const defaultName = clause.match(/^import\\s+(?!type\\b)(\\w+)\\s*(?:,|from)/);\n    const lines: string[] = [];\n    if (defaultName) lines.push(`const ${defaultName[1]} = (await ${load}).default;`);\n    if (namespace) lines.push(`const ${namespace[1]} = await ${load};`);\n    if (named) {\n        const pairs = named[1].split(\",\").map(part => part.trim()).filter(Boolean).map(part => {\n            const [imported, alias] = part.split(/\\s+as\\s+/).map(piece => piece.trim());\n            return alias ? `${imported}: ${alias}` : imported;\n        });\n        if (pairs.length) lines.push(`const { ${pairs.join(\", \")} } = await ${load};`);\n    }\n    return lines.join(\"\\n\");\n}\n\nfunction exportFromPrelude(raw: string, load: string): string {\n    if (/\\*\\s+as\\s+(\\w+)/.test(raw)) {\n        const name = raw.match(/\\*\\s+as\\s+(\\w+)/)?.[1] ?? \"ns\";\n        return `const ${name} = await ${load};\\nObject.assign(__exports, { ${name} });`;\n    }\n    if (raw.includes(\"*\")) {\n        return `Object.assign(__exports, await ${load});\\ndelete __exports.default;`;\n    }\n    const inner = raw.match(/\\{([^}]*)\\}/)?.[1] ?? \"\";\n    const lines = inner.split(\",\").map(part => part.trim()).filter(Boolean).map(part => {\n        const [imported, alias] = part.split(/\\s+as\\s+/).map(piece => piece.trim());\n        return `__exports.${alias || imported} = (await ${load}).${imported};`;\n    });\n    return lines.join(\"\\n\");\n}\n\nexport async function compileCanvas(input: CompileCanvasInput): Promise<CompileCanvasResult> {\n    const modules: GraphModule[] = [];\n    const indexByPath = new Map<string, number>();\n    const stack: string[] = [];\n\n    const addModule = async (path: string, source?: string): Promise<number | string> => {\n        const known = indexByPath.get(path);\n        if (known !== undefined) return known;\n        if (stack.includes(path)) return `Circular workspace import: ${[...stack, path].join(\" -> \")}`;\n        stack.push(path);\n        const ext = extensionOf(path);\n        let mod: GraphModule;\n        if (source !== undefined) {\n            mod = { path, kind: \"js\", text: source };\n        } else if (isJavaScript(path)) {\n            const file = await input.read(path);\n            if (!file?.text && file?.text !== \"\") return missing(path);\n            mod = { path, kind: \"js\", text: file?.text ?? \"\" };\n        } else if (ext === \"json\" || TEXT_EXT.has(ext)) {\n            const file = await input.read(path);\n            if (file?.text === undefined) return missing(path);\n            mod = { path, kind: ext === \"json\" ? \"json\" : \"text\", text: file.text };\n        } else {\n            const file = await input.read(path);\n            const bytes = file?.bytes ?? (file?.text !== undefined ? new TextEncoder().encode(file.text) : undefined);\n            if (!bytes) return missing(path);\n            mod = { path, kind: \"binary\", bytes, mime: MIME[ext] ?? \"application/octet-stream\" };\n        }\n        const id = modules.length;\n        modules.push(mod);\n        indexByPath.set(path, id);\n        if (mod.kind === \"js\" && mod.text !== undefined) {\n            for (const ref of findRefs(mod.text)) {\n                if (!isRelativeSpecifier(ref.spec)) continue;\n                const resolved = resolveWorkspacePath(path, ref.spec);\n                const child = await addModule(resolved);\n                if (typeof child === \"string\") return child;\n            }\n        }\n        stack.pop();\n        return id;\n    };\n\n    const missing = (path: string) => `Cannot find workspace file \"${path}\"`;\n\n    const entryId = await addModule(input.entryPath, input.entrySource);\n    if (typeof entryId === \"string\") return { ok: false, error: entryId };\n\n    const externals: ExternalImport[] = [];\n    const seq = { n: 0 };\n    const factories: string[] = [];\n\n    for (const mod of modules) {\n        if (mod.kind === \"json\") {\n            try {\n                const value = JSON.parse(mod.text ?? \"\");\n                factories.push(`async () => ({ default: ${JSON.stringify(value)} })`);\n            } catch (err) {\n                return { ok: false, error: `Invalid JSON in ${mod.path}: ${err instanceof Error ? err.message : String(err)}` };\n            }\n            continue;\n        }\n        if (mod.kind === \"text\") {\n            const cssInject = extensionOf(mod.path) === \"css\"\n                ? `const __css = ${JSON.stringify(mod.text ?? \"\")};\nconst __cssId = ${JSON.stringify(`docks-canvas-css-${mod.path}`)};\nif (typeof document !== \"undefined\" && !document.getElementById(__cssId)) {\n  const __style = document.createElement(\"style\");\n  __style.id = __cssId;\n  __style.textContent = __css;\n  document.head.append(__style);\n}\nreturn { default: __css };`\n                : `return { default: ${JSON.stringify(mod.text ?? \"\")} };`;\n            factories.push(`async () => { ${cssInject} }`);\n            continue;\n        }\n        if (mod.kind === \"binary\") {\n            const href = `data:${mod.mime};base64,${toBase64(mod.bytes ?? new Uint8Array())}`;\n            factories.push(`async () => ({ default: ${JSON.stringify(href)} })`);\n            continue;\n        }\n\n        const refs = findRefs(mod.text ?? \"\").sort((a, b) => b.start - a.start);\n        let body = mod.text ?? \"\";\n        const preludes: string[] = [];\n        for (const ref of refs) {\n            const resolvedUrl = rewriteBridgeSpecifier(ref.spec, input.bridges);\n            let replacement = \"\";\n            if (ref.form === \"asset-url\") {\n                if (!isRelativeSpecifier(ref.spec)) {\n                    replacement = ref.raw;\n                } else {\n                    const assetPath = resolveWorkspacePath(mod.path, ref.spec);\n                    const assetId = indexByPath.get(assetPath);\n                    if (assetId === undefined) return { ok: false, error: missing(assetPath) };\n                    replacement = `(await __req(${assetId})).default`;\n                }\n            } else if (isRelativeSpecifier(ref.spec)) {\n                const depPath = resolveWorkspacePath(mod.path, ref.spec);\n                const depId = indexByPath.get(depPath);\n                if (depId === undefined) return { ok: false, error: missing(depPath) };\n                const load = `__req(${depId})`;\n                if (ref.form === \"dynamic\") replacement = load;\n                else if (ref.form === \"export-from\") preludes.push(exportFromPrelude(ref.raw, load));\n                else preludes.push(importPrelude(ref.raw, load));\n            } else if (ref.form === \"dynamic\") {\n                const runtime = bridgeRuntime(ref.spec, input.bridges);\n                replacement = runtime ? `Promise.resolve(${runtime})` : `import(${JSON.stringify(resolvedUrl)})`;\n                if (runtime) externalBinding(resolvedUrl, \"side\", externals, seq);\n            } else {\n                const runtime = bridgeRuntime(ref.spec, input.bridges);\n                if (runtime) {\n                    externalBinding(resolvedUrl, \"side\", externals, seq);\n                    if (ref.form === \"import\" && !/^import\\s+['\"]/.test(ref.raw.trim())) {\n                        preludes.push(runtimeImportPrelude(ref.raw, runtime));\n                    } else if (ref.form === \"export-from\") {\n                        preludes.push(runtimeExportFromPrelude(ref.raw, runtime));\n                    } else if (ref.form === \"import\") {\n                        preludes.push(`void ${runtime};`);\n                    }\n                } else {\n                    const localFor = (imported: string) => externalBinding(resolvedUrl, imported, externals, seq);\n                    if (ref.form === \"import\" && /^import\\s+['\"]/.test(ref.raw.trim())) {\n                        externalBinding(resolvedUrl, \"side\", externals, seq);\n                    } else if (ref.form === \"import\") {\n                        preludes.push(externalImportPrelude(ref.raw, localFor));\n                    } else if (ref.form === \"export-from\") {\n                        preludes.push(externalExportFromPrelude(ref.raw, localFor));\n                    }\n                }\n            }\n            if (ref.form === \"import\" || ref.form === \"export-from\") replacement = \"\";\n            body = body.slice(0, ref.start) + replacement + body.slice(ref.end);\n        }\n        body = rewriteLocalExports(body);\n        factories.push(`async () => {\n  const __exports = {};\n  ${preludes.join(\"\\n\")}\n  ${body}\n  return __exports;\n}`);\n    }\n\n    const uniqueLines = [...new Set(externals.map(item => item.line))];\n    const code = `${uniqueLines.join(\"\\n\")}\nconst __factories = [\n${factories.join(\",\\n\")}\n];\nconst __cache = new Map();\nasync function __req(id) {\n  if (__cache.has(id)) return __cache.get(id);\n  const pending = __factories[id]();\n  __cache.set(id, pending);\n  return pending;\n}\nconst __entry = await __req(${entryId});\nexport default __entry.default;\n`;\n    return { ok: true, code };\n}\n\nfunction runtimeImportPrelude(raw: string, runtime: string): string {\n    const clause = raw.replace(/\\s+/g, \" \").trim();\n    const lines: string[] = [];\n    const defaultName = clause.match(/^import\\s+(?!type\\b)(\\w+)\\s*(?:,|from)/);\n    const namespace = clause.match(/\\*\\s+as\\s+(\\w+)/);\n    const named = clause.match(/\\{([^}]*)\\}/);\n    if (defaultName) lines.push(`const ${defaultName[1]} = ${runtime}.default;`);\n    if (namespace) lines.push(`const ${namespace[1]} = ${runtime};`);\n    if (named) {\n        for (const part of named[1].split(\",\").map(piece => piece.trim()).filter(Boolean)) {\n            const [imported, alias] = part.split(/\\s+as\\s+/).map(piece => piece.trim());\n            lines.push(`const ${alias || imported} = ${runtime}.${imported};`);\n        }\n    }\n    return lines.join(\"\\n\");\n}\n\nfunction runtimeExportFromPrelude(raw: string, runtime: string): string {\n    if (raw.includes(\"*\") && !raw.includes(\"{\")) {\n        return `Object.assign(__exports, ${runtime});\\ndelete __exports.default;`;\n    }\n    const inner = raw.match(/\\{([^}]*)\\}/)?.[1] ?? \"\";\n    return inner.split(\",\").map(part => part.trim()).filter(Boolean).map(part => {\n        const [imported, alias] = part.split(/\\s+as\\s+/).map(piece => piece.trim());\n        return `__exports.${alias || imported} = ${runtime}.${imported};`;\n    }).join(\"\\n\");\n}\n\nfunction externalImportPrelude(raw: string, localFor: (imported: string) => string): string {\n    const clause = raw.replace(/\\s+/g, \" \").trim();\n    const lines: string[] = [];\n    const defaultName = clause.match(/^import\\s+(?!type\\b)(\\w+)\\s*(?:,|from)/);\n    const namespace = clause.match(/\\*\\s+as\\s+(\\w+)/);\n    const named = clause.match(/\\{([^}]*)\\}/);\n    if (defaultName) lines.push(`const ${defaultName[1]} = ${localFor(\"default\")};`);\n    if (namespace) lines.push(`const ${namespace[1]} = ${localFor(\"*\")};`);\n    if (named) {\n        for (const part of named[1].split(\",\").map(piece => piece.trim()).filter(Boolean)) {\n            const [imported, alias] = part.split(/\\s+as\\s+/).map(piece => piece.trim());\n            lines.push(`const ${alias || imported} = ${localFor(imported)};`);\n        }\n    }\n    return lines.join(\"\\n\");\n}\n\nfunction externalExportFromPrelude(raw: string, localFor: (imported: string) => string): string {\n    if (raw.includes(\"*\") && !raw.includes(\"{\")) {\n        return `Object.assign(__exports, ${localFor(\"*\")});\\ndelete __exports.default;`;\n    }\n    const inner = raw.match(/\\{([^}]*)\\}/)?.[1] ?? \"\";\n    return inner.split(\",\").map(part => part.trim()).filter(Boolean).map(part => {\n        const [imported, alias] = part.split(/\\s+as\\s+/).map(piece => piece.trim());\n        return `__exports.${alias || imported} = ${localFor(imported)};`;\n    }).join(\"\\n\");\n}\n"],"mappings":"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"}

package/dist/contribution.d.ts

@@ -0,0 +1,30 @@
+import { Contribution, TabContribution } from '@eclipse-docks/core';
+/** Slot for canvases an extension contributes. The toolbar dropdown lists it; it is not a tab group. */
+export declare const SYSTEM_CANVASES = "system.canvases";
+export interface CanvasToolContribution {
+    id: string;
+    name: string;
+    description: string;
+    parameters?: Array<{
+        name: string;
+        description: string;
+        type?: string;
+        required: boolean;
+        allowedValues?: string[];
+    }>;
+    execute: (context: {
+        params?: Record<string, unknown>;
+    }) => unknown | Promise<unknown>;
+}
+/** A canvas module registered on {@link SYSTEM_CANVASES} and opened from the toolbar dropdown. */
+export interface CanvasContribution extends TabContribution {
+    /** Module whose default export is an HTMLElement subclass. */
+    load: () => Promise<{
+        default: CustomElementConstructor;
+    }>;
+    /** When set, the editor can toggle between preview and source and counts as an editor. */
+    source?: string | (() => Promise<string>);
+    tools?: CanvasToolContribution[];
+}
+export declare function isCanvasContribution(contribution: Contribution): contribution is CanvasContribution;
+//# sourceMappingURL=contribution.d.ts.map

package/dist/contribution.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contribution.d.ts","sourceRoot":"","sources":["../src/contribution.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAEzE,wGAAwG;AACxG,eAAO,MAAM,eAAe,oBAAoB,CAAC;AAEjD,MAAM,WAAW,sBAAsB;IACnC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,KAAK,CAAC;QACf,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,EAAE,MAAM,CAAC;QACpB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,QAAQ,EAAE,OAAO,CAAC;QAClB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;KAC5B,CAAC,CAAC;IACH,OAAO,EAAE,CAAC,OAAO,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,KAAK,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CAC1F;AAED,kGAAkG;AAClG,MAAM,WAAW,kBAAmB,SAAQ,eAAe;IACvD,8DAA8D;IAC9D,IAAI,EAAE,MAAM,OAAO,CAAC;QAAE,OAAO,EAAE,wBAAwB,CAAA;KAAE,CAAC,CAAC;IAC3D,0FAA0F;IAC1F,MAAM,CAAC,EAAE,MAAM,GAAG,CAAC,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC;IAC1C,KAAK,CAAC,EAAE,sBAAsB,EAAE,CAAC;CACpC;AAED,wBAAgB,oBAAoB,CAAC,YAAY,EAAE,YAAY,GAAG,YAAY,IAAI,kBAAkB,CAEnG"}

package/dist/contribution.js

@@ -0,0 +1,10 @@
+//#region src/contribution.ts
+/** Slot for canvases an extension contributes. The toolbar dropdown lists it; it is not a tab group. */
+var SYSTEM_CANVASES = "system.canvases";
+function isCanvasContribution(contribution) {
+	return typeof contribution.load === "function";
+}
+//#endregion
+export { SYSTEM_CANVASES, isCanvasContribution };
+
+//# sourceMappingURL=contribution.js.map

package/dist/contribution.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contribution.js","names":[],"sources":["../src/contribution.ts"],"sourcesContent":["import type { Contribution, TabContribution } from '@eclipse-docks/core';\n\n/** Slot for canvases an extension contributes. The toolbar dropdown lists it; it is not a tab group. */\nexport const SYSTEM_CANVASES = 'system.canvases';\n\nexport interface CanvasToolContribution {\n    id: string;\n    name: string;\n    description: string;\n    parameters?: Array<{\n        name: string;\n        description: string;\n        type?: string;\n        required: boolean;\n        allowedValues?: string[];\n    }>;\n    execute: (context: { params?: Record<string, unknown> }) => unknown | Promise<unknown>;\n}\n\n/** A canvas module registered on {@link SYSTEM_CANVASES} and opened from the toolbar dropdown. */\nexport interface CanvasContribution extends TabContribution {\n    /** Module whose default export is an HTMLElement subclass. */\n    load: () => Promise<{ default: CustomElementConstructor }>;\n    /** When set, the editor can toggle between preview and source and counts as an editor. */\n    source?: string | (() => Promise<string>);\n    tools?: CanvasToolContribution[];\n}\n\nexport function isCanvasContribution(contribution: Contribution): contribution is CanvasContribution {\n    return typeof (contribution as CanvasContribution).load === 'function';\n}\n"],"mappings":";;AAGA,IAAa,kBAAkB;AAyB/B,SAAgB,qBAAqB,cAAgE;CACjG,OAAO,OAAQ,aAAoC,SAAS;AAChE"}

package/dist/help.d.ts

@@ -0,0 +1,3 @@
+export declare const CANVAS_HELP = "A canvas is a workspace file ending in .canvas.js. Extend LitElement, not HTMLElement:\n\nimport { LitElement, html } from \"docks/lit\";\nimport \"docks/webawesome\";\nexport default class extends LitElement {\n  render() { return html`<wa-button>Ready</wa-button>`; }\n}\n\nThe host defines the custom element. Do not call customElements.define. Set state with this.canvasHost.getState(key, fallback) and this.canvasHost.setState(key, value). Open a workspace file with this.canvasHost.openFile(path).\n\nImports are not filtered. docks/lit, docks/webawesome, and docks/core are the running app (Lit, Web Awesome, and @eclipse-docks/core). Relative imports are workspace files. Compiling inlines those files: JSON becomes its value, text and CSS become strings, and other binaries become data URLs.\n\nWrite the file with the workspace tools, then call canvas.open with its path. canvas.apply_source updates the open canvas and returns ready or the compile error. Extension canvases are registered with contributionRegistry.registerContribution(SYSTEM_CANVASES, contribution). Import SYSTEM_CANVASES and CanvasContribution from @eclipse-docks/extension-canvas/contribution. They are opened by name from canvas.open or the toolbar dropdown.";
+export declare const CANVAS_SKILL = "For a durable interactive view, write a workspace file ending in .canvas.js whose default export extends LitElement from \"docks/lit\". Do not extend HTMLElement. Call canvas.open, and call canvas.help for the module contract. Extension canvases registered on system.canvases open by name.";
+//# sourceMappingURL=help.d.ts.map

package/dist/help.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"help.d.ts","sourceRoot":"","sources":["../src/help.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,WAAW,8tCAY8Z,CAAC;AAEvb,eAAO,MAAM,YAAY,sSAAoS,CAAC"}

package/dist/help.js

@@ -0,0 +1,19 @@
+//#region src/help.ts
+var CANVAS_HELP = `A canvas is a workspace file ending in .canvas.js. Extend LitElement, not HTMLElement:
+
+import { LitElement, html } from "docks/lit";
+import "docks/webawesome";
+export default class extends LitElement {
+  render() { return html\`<wa-button>Ready</wa-button>\`; }
+}
+
+The host defines the custom element. Do not call customElements.define. Set state with this.canvasHost.getState(key, fallback) and this.canvasHost.setState(key, value). Open a workspace file with this.canvasHost.openFile(path).
+
+Imports are not filtered. docks/lit, docks/webawesome, and docks/core are the running app (Lit, Web Awesome, and @eclipse-docks/core). Relative imports are workspace files. Compiling inlines those files: JSON becomes its value, text and CSS become strings, and other binaries become data URLs.
+
+Write the file with the workspace tools, then call canvas.open with its path. canvas.apply_source updates the open canvas and returns ready or the compile error. Extension canvases are registered with contributionRegistry.registerContribution(SYSTEM_CANVASES, contribution). Import SYSTEM_CANVASES and CanvasContribution from @eclipse-docks/extension-canvas/contribution. They are opened by name from canvas.open or the toolbar dropdown.`;
+var CANVAS_SKILL = `For a durable interactive view, write a workspace file ending in .canvas.js whose default export extends LitElement from "docks/lit". Do not extend HTMLElement. Call canvas.open, and call canvas.help for the module contract. Extension canvases registered on system.canvases open by name.`;
+//#endregion
+export { CANVAS_HELP, CANVAS_SKILL };
+
+//# sourceMappingURL=help.js.map

package/dist/help.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"help.js","names":[],"sources":["../src/help.ts"],"sourcesContent":["export const CANVAS_HELP = `A canvas is a workspace file ending in .canvas.js. Extend LitElement, not HTMLElement:\n\nimport { LitElement, html } from \"docks/lit\";\nimport \"docks/webawesome\";\nexport default class extends LitElement {\n  render() { return html\\`<wa-button>Ready</wa-button>\\`; }\n}\n\nThe host defines the custom element. Do not call customElements.define. Set state with this.canvasHost.getState(key, fallback) and this.canvasHost.setState(key, value). Open a workspace file with this.canvasHost.openFile(path).\n\nImports are not filtered. docks/lit, docks/webawesome, and docks/core are the running app (Lit, Web Awesome, and @eclipse-docks/core). Relative imports are workspace files. Compiling inlines those files: JSON becomes its value, text and CSS become strings, and other binaries become data URLs.\n\nWrite the file with the workspace tools, then call canvas.open with its path. canvas.apply_source updates the open canvas and returns ready or the compile error. Extension canvases are registered with contributionRegistry.registerContribution(SYSTEM_CANVASES, contribution). Import SYSTEM_CANVASES and CanvasContribution from @eclipse-docks/extension-canvas/contribution. They are opened by name from canvas.open or the toolbar dropdown.`;\n\nexport const CANVAS_SKILL = `For a durable interactive view, write a workspace file ending in .canvas.js whose default export extends LitElement from \"docks/lit\". Do not extend HTMLElement. Call canvas.open, and call canvas.help for the module contract. Extension canvases registered on system.canvases open by name.`;\n"],"mappings":";AAAA,IAAa,cAAc;;;;;;;;;;;;;AAc3B,IAAa,eAAe"}

package/dist/host.d.ts

@@ -0,0 +1,11 @@
+import { File } from '@eclipse-docks/core';
+import { CanvasContribution } from './contribution';
+export interface CanvasHost {
+    getState(key: string, fallback?: unknown): unknown;
+    setState(key: string, value: unknown): void;
+    openFile(path: string): void;
+}
+export declare function createMemoryHost(initial: Record<string, unknown>, persist: (state: Record<string, unknown>) => void): CanvasHost;
+export declare function createFileHost(file: File): Promise<CanvasHost>;
+export declare function createContributionHost(contribution: CanvasContribution): Promise<CanvasHost>;
+//# sourceMappingURL=host.d.ts.map

package/dist/host.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"host.d.ts","sourceRoot":"","sources":["../src/host.ts"],"names":[],"mappings":"AAAA,OAAO,EAA+B,IAAI,EAAoB,MAAM,qBAAqB,CAAC;AAC1F,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAEzD,MAAM,WAAW,UAAU;IACvB,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC;IACnD,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI,CAAC;IAC5C,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;CAChC;AAED,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,EAAE,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,GAAG,UAAU,CAchI;AAED,wBAAsB,cAAc,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,UAAU,CAAC,CAKpE;AAED,wBAAsB,sBAAsB,CAAC,YAAY,EAAE,kBAAkB,GAAG,OAAO,CAAC,UAAU,CAAC,CAOlG"}

package/dist/host.js

@@ -0,0 +1,63 @@
+import { File, appSettings, editorRegistry, workspaceService } from "@eclipse-docks/core";
+//#region src/host.ts
+function createMemoryHost(initial, persist) {
+	const state = { ...initial };
+	return {
+		getState(key, fallback) {
+			return state[key] === void 0 ? fallback : state[key];
+		},
+		setState(key, value) {
+			state[key] = value;
+			persist(state);
+		},
+		openFile(path) {
+			openWorkspaceFile(path);
+		}
+	};
+}
+async function createFileHost(file) {
+	return createMemoryHost(await readSidecar(file), (state) => {
+		writeSidecar(file, state);
+	});
+}
+async function createContributionHost(contribution) {
+	const key = `canvas.${contribution.name}`;
+	const stored = await appSettings.get(key);
+	return createMemoryHost(stored && typeof stored === "object" ? stored : {}, (state) => {
+		appSettings.set(key, state);
+	});
+}
+function sidecarName(fileName) {
+	return fileName.replace(/\.canvas\.js$/i, ".canvas.data.json");
+}
+async function readSidecar(file) {
+	const parent = file.getParent();
+	if (!parent) return {};
+	const resource = await parent.getResource(sidecarName(file.getName()));
+	if (!(resource instanceof File)) return {};
+	try {
+		const parsed = JSON.parse(await resource.getContents());
+		return parsed && typeof parsed === "object" ? parsed : {};
+	} catch {
+		return {};
+	}
+}
+async function writeSidecar(file, state) {
+	const parent = file.getParent();
+	if (!parent) return;
+	const name = sidecarName(file.getName());
+	let resource = await parent.getResource(name);
+	if (!(resource instanceof File)) resource = await parent.getResource(name, { create: true });
+	if (!(resource instanceof File)) return;
+	await resource.saveContents(JSON.stringify(state));
+}
+async function openWorkspaceFile(path) {
+	const workspace = workspaceService.getWorkspaceSync() ?? await workspaceService.getWorkspace();
+	if (!workspace) return;
+	const resource = await workspace.getResource(path.replace(/^\/+/, ""));
+	if (resource instanceof File) await editorRegistry.loadEditor(resource);
+}
+//#endregion
+export { createContributionHost, createFileHost, createMemoryHost };
+
+//# sourceMappingURL=host.js.map

package/dist/host.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"host.js","names":[],"sources":["../src/host.ts"],"sourcesContent":["import { appSettings, editorRegistry, File, workspaceService } from '@eclipse-docks/core';\nimport type { CanvasContribution } from './contribution';\n\nexport interface CanvasHost {\n    getState(key: string, fallback?: unknown): unknown;\n    setState(key: string, value: unknown): void;\n    openFile(path: string): void;\n}\n\nexport function createMemoryHost(initial: Record<string, unknown>, persist: (state: Record<string, unknown>) => void): CanvasHost {\n    const state = { ...initial };\n    return {\n        getState(key, fallback) {\n            return state[key] === undefined ? fallback : state[key];\n        },\n        setState(key, value) {\n            state[key] = value;\n            persist(state);\n        },\n        openFile(path) {\n            void openWorkspaceFile(path);\n        },\n    };\n}\n\nexport async function createFileHost(file: File): Promise<CanvasHost> {\n    const initial = await readSidecar(file);\n    return createMemoryHost(initial, state => {\n        void writeSidecar(file, state);\n    });\n}\n\nexport async function createContributionHost(contribution: CanvasContribution): Promise<CanvasHost> {\n    const key = `canvas.${contribution.name}`;\n    const stored = await appSettings.get(key);\n    const initial = stored && typeof stored === 'object' ? stored as Record<string, unknown> : {};\n    return createMemoryHost(initial, state => {\n        void appSettings.set(key, state);\n    });\n}\n\nfunction sidecarName(fileName: string): string {\n    return fileName.replace(/\\.canvas\\.js$/i, '.canvas.data.json');\n}\n\nasync function readSidecar(file: File): Promise<Record<string, unknown>> {\n    const parent = file.getParent();\n    if (!parent) return {};\n    const resource = await parent.getResource(sidecarName(file.getName()));\n    if (!(resource instanceof File)) return {};\n    try {\n        const parsed = JSON.parse(await resource.getContents());\n        return parsed && typeof parsed === 'object' ? parsed as Record<string, unknown> : {};\n    } catch {\n        return {};\n    }\n}\n\nasync function writeSidecar(file: File, state: Record<string, unknown>): Promise<void> {\n    const parent = file.getParent();\n    if (!parent) return;\n    const name = sidecarName(file.getName());\n    let resource = await parent.getResource(name);\n    if (!(resource instanceof File)) {\n        resource = await parent.getResource(name, { create: true }) as File | null;\n    }\n    if (!(resource instanceof File)) return;\n    await resource.saveContents(JSON.stringify(state));\n}\n\nasync function openWorkspaceFile(path: string): Promise<void> {\n    const workspace = workspaceService.getWorkspaceSync() ?? await workspaceService.getWorkspace();\n    if (!workspace) return;\n    const resource = await workspace.getResource(path.replace(/^\\/+/, ''));\n    if (resource instanceof File) await editorRegistry.loadEditor(resource);\n}\n"],"mappings":";;AASA,SAAgB,iBAAiB,SAAkC,SAA+D;CAC9H,MAAM,QAAQ,EAAE,GAAG,QAAQ;CAC3B,OAAO;EACH,SAAS,KAAK,UAAU;GACpB,OAAO,MAAM,SAAS,KAAA,IAAY,WAAW,MAAM;EACvD;EACA,SAAS,KAAK,OAAO;GACjB,MAAM,OAAO;GACb,QAAQ,KAAK;EACjB;EACA,SAAS,MAAM;GACX,kBAAuB,IAAI;EAC/B;CACJ;AACJ;AAEA,eAAsB,eAAe,MAAiC;CAElE,OAAO,iBAAiB,MADF,YAAY,IAAI,IACL,UAAS;EACtC,aAAkB,MAAM,KAAK;CACjC,CAAC;AACL;AAEA,eAAsB,uBAAuB,cAAuD;CAChG,MAAM,MAAM,UAAU,aAAa;CACnC,MAAM,SAAS,MAAM,YAAY,IAAI,GAAG;CAExC,OAAO,iBADS,UAAU,OAAO,WAAW,WAAW,SAAoC,CAAC,IAC3D,UAAS;EACtC,YAAiB,IAAI,KAAK,KAAK;CACnC,CAAC;AACL;AAEA,SAAS,YAAY,UAA0B;CAC3C,OAAO,SAAS,QAAQ,kBAAkB,mBAAmB;AACjE;AAEA,eAAe,YAAY,MAA8C;CACrE,MAAM,SAAS,KAAK,UAAU;CAC9B,IAAI,CAAC,QAAQ,OAAO,CAAC;CACrB,MAAM,WAAW,MAAM,OAAO,YAAY,YAAY,KAAK,QAAQ,CAAC,CAAC;CACrE,IAAI,EAAE,oBAAoB,OAAO,OAAO,CAAC;CACzC,IAAI;EACA,MAAM,SAAS,KAAK,MAAM,MAAM,SAAS,YAAY,CAAC;EACtD,OAAO,UAAU,OAAO,WAAW,WAAW,SAAoC,CAAC;CACvF,QAAQ;EACJ,OAAO,CAAC;CACZ;AACJ;AAEA,eAAe,aAAa,MAAY,OAA+C;CACnF,MAAM,SAAS,KAAK,UAAU;CAC9B,IAAI,CAAC,QAAQ;CACb,MAAM,OAAO,YAAY,KAAK,QAAQ,CAAC;CACvC,IAAI,WAAW,MAAM,OAAO,YAAY,IAAI;CAC5C,IAAI,EAAE,oBAAoB,OACtB,WAAW,MAAM,OAAO,YAAY,MAAM,EAAE,QAAQ,KAAK,CAAC;CAE9D,IAAI,EAAE,oBAAoB,OAAO;CACjC,MAAM,SAAS,aAAa,KAAK,UAAU,KAAK,CAAC;AACrD;AAEA,eAAe,kBAAkB,MAA6B;CAC1D,MAAM,YAAY,iBAAiB,iBAAiB,KAAK,MAAM,iBAAiB,aAAa;CAC7F,IAAI,CAAC,WAAW;CAChB,MAAM,WAAW,MAAM,UAAU,YAAY,KAAK,QAAQ,QAAQ,EAAE,CAAC;CACrE,IAAI,oBAAoB,MAAM,MAAM,eAAe,WAAW,QAAQ;AAC1E"}