npm - @lifeart/async-dom - Versions diffs - 2.0.0-alpha.3 - Mend

@lifeart/async-dom 2.0.0-alpha.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (117) hide show

package/LICENSE +21 -0
package/README.md +623 -0
package/dist/base.d.cts +398 -0
package/dist/base.d.cts.map +1 -0
package/dist/base.d.ts +398 -0
package/dist/base.d.ts.map +1 -0
package/dist/cli.cjs +528 -0
package/dist/cli.cjs.map +1 -0
package/dist/cli.d.cts +1 -0
package/dist/cli.d.ts +1 -0
package/dist/cli.js +493 -0
package/dist/cli.js.map +1 -0
package/dist/debug.d.cts +145 -0
package/dist/debug.d.cts.map +1 -0
package/dist/debug.d.ts +145 -0
package/dist/debug.d.ts.map +1 -0
package/dist/index.cjs +26 -0
package/dist/index.d.cts +560 -0
package/dist/index.d.cts.map +1 -0
package/dist/index.d.ts +560 -0
package/dist/index.d.ts.map +1 -0
package/dist/index.js +5 -0
package/dist/index2.d.cts +5 -0
package/dist/index2.d.ts +5 -0
package/dist/index3.d.cts +882 -0
package/dist/index3.d.cts.map +1 -0
package/dist/index3.d.ts +882 -0
package/dist/index3.d.ts.map +1 -0
package/dist/main-thread.cjs +5459 -0
package/dist/main-thread.cjs.map +1 -0
package/dist/main-thread.js +5429 -0
package/dist/main-thread.js.map +1 -0
package/dist/react.cjs +116 -0
package/dist/react.cjs.map +1 -0
package/dist/react.d.cts +91 -0
package/dist/react.d.cts.map +1 -0
package/dist/react.d.ts +91 -0
package/dist/react.d.ts.map +1 -0
package/dist/react.js +113 -0
package/dist/react.js.map +1 -0
package/dist/resolve-debug.cjs +24 -0
package/dist/resolve-debug.cjs.map +1 -0
package/dist/resolve-debug.js +19 -0
package/dist/resolve-debug.js.map +1 -0
package/dist/server.cjs +250 -0
package/dist/server.cjs.map +1 -0
package/dist/server.d.cts +127 -0
package/dist/server.d.cts.map +1 -0
package/dist/server.d.ts +127 -0
package/dist/server.d.ts.map +1 -0
package/dist/server.js +245 -0
package/dist/server.js.map +1 -0
package/dist/svelte.cjs +48 -0
package/dist/svelte.cjs.map +1 -0
package/dist/svelte.d.cts +38 -0
package/dist/svelte.d.cts.map +1 -0
package/dist/svelte.d.ts +38 -0
package/dist/svelte.d.ts.map +1 -0
package/dist/svelte.js +47 -0
package/dist/svelte.js.map +1 -0
package/dist/sync-channel.cjs +532 -0
package/dist/sync-channel.cjs.map +1 -0
package/dist/sync-channel.js +425 -0
package/dist/sync-channel.js.map +1 -0
package/dist/transport.cjs +213 -0
package/dist/transport.cjs.map +1 -0
package/dist/transport.d.cts +79 -0
package/dist/transport.d.cts.map +1 -0
package/dist/transport.d.ts +79 -0
package/dist/transport.d.ts.map +1 -0
package/dist/transport.js +202 -0
package/dist/transport.js.map +1 -0
package/dist/vite-plugin.cjs +112 -0
package/dist/vite-plugin.cjs.map +1 -0
package/dist/vite-plugin.d.cts +39 -0
package/dist/vite-plugin.d.cts.map +1 -0
package/dist/vite-plugin.d.ts +39 -0
package/dist/vite-plugin.d.ts.map +1 -0
package/dist/vite-plugin.js +107 -0
package/dist/vite-plugin.js.map +1 -0
package/dist/vue.cjs +123 -0
package/dist/vue.cjs.map +1 -0
package/dist/vue.d.cts +126 -0
package/dist/vue.d.cts.map +1 -0
package/dist/vue.d.ts +126 -0
package/dist/vue.d.ts.map +1 -0
package/dist/vue.js +120 -0
package/dist/vue.js.map +1 -0
package/dist/worker-thread.cjs +2751 -0
package/dist/worker-thread.cjs.map +1 -0
package/dist/worker-thread.js +2692 -0
package/dist/worker-thread.js.map +1 -0
package/dist/worker-transport.cjs +136 -0
package/dist/worker-transport.cjs.map +1 -0
package/dist/worker-transport.d.cts +162 -0
package/dist/worker-transport.d.cts.map +1 -0
package/dist/worker-transport.d.ts +162 -0
package/dist/worker-transport.d.ts.map +1 -0
package/dist/worker-transport.js +125 -0
package/dist/worker-transport.js.map +1 -0
package/dist/worker.cjs +12 -0
package/dist/worker.d.cts +2 -0
package/dist/worker.d.ts +2 -0
package/dist/worker.js +2 -0
package/dist/ws-server-transport.cjs +147 -0
package/dist/ws-server-transport.cjs.map +1 -0
package/dist/ws-server-transport.d.cts +64 -0
package/dist/ws-server-transport.d.cts.map +1 -0
package/dist/ws-server-transport.d.ts +64 -0
package/dist/ws-server-transport.d.ts.map +1 -0
package/dist/ws-server-transport.js +142 -0
package/dist/ws-server-transport.js.map +1 -0
package/dist/ws-transport.cjs +954 -0
package/dist/ws-transport.cjs.map +1 -0
package/dist/ws-transport.js +913 -0
package/dist/ws-transport.js.map +1 -0
package/package.json +145 -0

package/dist/cli.js ADDED Viewed

@@ -0,0 +1,493 @@
+#!/usr/bin/env node
+import * as fs from "node:fs";
+import * as path from "node:path";
+import * as readline from "node:readline";
+//#region src/cli/templates.ts
+/**
+* Returns the list of files for a given project template.
+*
+* @param template - Template name (one of {@link AVAILABLE_TEMPLATES}).
+* @param name - Project name, used in package.json and HTML title.
+* @returns Array of files to write to disk.
+* @throws If the template name is not recognized.
+*/
+function getTemplate(template, name) {
+	switch (template) {
+		case "vanilla-ts": return vanillaTs(name);
+		case "react-ts": return reactTs(name);
+		case "vue-ts": return vueTs(name);
+		default: throw new Error(`Unknown template: ${template}. Available: vanilla-ts, react-ts, vue-ts`);
+	}
+}
+/** The list of available project templates for `async-dom init`. */
+const AVAILABLE_TEMPLATES = [
+	"vanilla-ts",
+	"react-ts",
+	"vue-ts"
+];
+function escapeHtml(str) {
+	return str.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;");
+}
+function vanillaTs(name) {
+	return [
+		{
+			path: "package.json",
+			content: JSON.stringify({
+				name,
+				private: true,
+				version: "0.0.0",
+				type: "module",
+				scripts: {
+					dev: "vite",
+					build: "tsc && vite build",
+					preview: "vite preview"
+				},
+				devDependencies: {
+					typescript: "^5.8.0",
+					vite: "^6.0.0",
+					"@lifeart/async-dom": "latest"
+				}
+			}, null, 2)
+		},
+		{
+			path: "index.html",
+			content: `<!DOCTYPE html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title>${escapeHtml(name)}</title>
+  </head>
+  <body>
+    <div id="app"></div>
+    <script type="module" src="/src/main.ts"><\/script>
+  </body>
+</html>
+`
+		},
+		{
+			path: "src/main.ts",
+			content: `import { createAsyncDom } from "@lifeart/async-dom";
+const worker = new Worker(new URL("./app.worker.ts", import.meta.url), {
+  type: "module",
+});
+const instance = createAsyncDom({
+  target: document.getElementById("app")!,
+  worker,
+});
+instance.start();
+`
+		},
+		{
+			path: "src/app.worker.ts",
+			content: `import { createWorkerDom } from "@lifeart/async-dom/worker";
+const { document } = createWorkerDom();
+const heading = document.createElement("h1");
+heading.textContent = "Hello from async-dom!";
+document.body.appendChild(heading);
+const counter = document.createElement("button");
+counter.textContent = "Count: 0";
+let count = 0;
+counter.addEventListener("click", () => {
+  count++;
+  counter.textContent = \`Count: \${count}\`;
+});
+document.body.appendChild(counter);
+`
+		},
+		{
+			path: "src/vite-env.d.ts",
+			content: `/// <reference types="vite/client" />
+`
+		},
+		{
+			path: "tsconfig.json",
+			content: JSON.stringify({
+				compilerOptions: {
+					target: "ES2022",
+					module: "ESNext",
+					moduleResolution: "bundler",
+					strict: true,
+					esModuleInterop: true,
+					skipLibCheck: true,
+					forceConsistentCasingInFileNames: true,
+					isolatedModules: true,
+					noEmit: true,
+					lib: [
+						"ES2022",
+						"DOM",
+						"DOM.Iterable"
+					]
+				},
+				include: ["src"]
+			}, null, 2)
+		},
+		{
+			path: "vite.config.ts",
+			content: `import { defineConfig } from "vite";
+import { asyncDomPlugin } from "@lifeart/async-dom/vite-plugin";
+export default defineConfig({
+  plugins: [asyncDomPlugin()],
+});
+`
+		}
+	];
+}
+function reactTs(name) {
+	return [
+		{
+			path: "package.json",
+			content: JSON.stringify({
+				name,
+				private: true,
+				version: "0.0.0",
+				type: "module",
+				scripts: {
+					dev: "vite",
+					build: "tsc && vite build",
+					preview: "vite preview"
+				},
+				dependencies: {
+					react: "^19.0.0",
+					"react-dom": "^19.0.0"
+				},
+				devDependencies: {
+					"@types/react": "^19.0.0",
+					"@types/react-dom": "^19.0.0",
+					"@vitejs/plugin-react": "^4.0.0",
+					typescript: "^5.8.0",
+					vite: "^6.0.0",
+					"@lifeart/async-dom": "latest"
+				}
+			}, null, 2)
+		},
+		{
+			path: "index.html",
+			content: `<!DOCTYPE html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title>${escapeHtml(name)}</title>
+  </head>
+  <body>
+    <div id="root"></div>
+    <script type="module" src="/src/main.tsx"><\/script>
+  </body>
+</html>
+`
+		},
+		{
+			path: "src/main.tsx",
+			content: `import { StrictMode } from "react";
+import { createRoot } from "react-dom/client";
+import { App } from "./App";
+createRoot(document.getElementById("root")!).render(
+  <StrictMode>
+    <App />
+  </StrictMode>,
+);
+`
+		},
+		{
+			path: "src/App.tsx",
+			content: `import { AsyncDom } from "@lifeart/async-dom/react";
+export function App() {
+  return (
+    <AsyncDom
+      worker="./app.worker.ts"
+      fallback={<p>Loading...</p>}
+      onReady={(instance) => console.log("async-dom ready", instance)}
+    />
+  );
+}
+`
+		},
+		{
+			path: "src/app.worker.ts",
+			content: `import { createWorkerDom } from "@lifeart/async-dom/worker";
+const { document } = createWorkerDom();
+const heading = document.createElement("h1");
+heading.textContent = "Hello from async-dom + React!";
+document.body.appendChild(heading);
+`
+		},
+		{
+			path: "src/vite-env.d.ts",
+			content: `/// <reference types="vite/client" />
+`
+		},
+		{
+			path: "tsconfig.json",
+			content: JSON.stringify({
+				compilerOptions: {
+					target: "ES2022",
+					module: "ESNext",
+					moduleResolution: "bundler",
+					strict: true,
+					esModuleInterop: true,
+					skipLibCheck: true,
+					forceConsistentCasingInFileNames: true,
+					isolatedModules: true,
+					noEmit: true,
+					jsx: "react-jsx",
+					lib: [
+						"ES2022",
+						"DOM",
+						"DOM.Iterable"
+					]
+				},
+				include: ["src"]
+			}, null, 2)
+		},
+		{
+			path: "vite.config.ts",
+			content: `import { defineConfig } from "vite";
+import react from "@vitejs/plugin-react";
+import { asyncDomPlugin } from "@lifeart/async-dom/vite-plugin";
+export default defineConfig({
+  plugins: [react(), asyncDomPlugin()],
+});
+`
+		}
+	];
+}
+function vueTs(name) {
+	return [
+		{
+			path: "package.json",
+			content: JSON.stringify({
+				name,
+				private: true,
+				version: "0.0.0",
+				type: "module",
+				scripts: {
+					dev: "vite",
+					build: "vue-tsc && vite build",
+					preview: "vite preview"
+				},
+				dependencies: { vue: "^3.5.0" },
+				devDependencies: {
+					"@vitejs/plugin-vue": "^5.0.0",
+					typescript: "^5.8.0",
+					"vue-tsc": "^2.0.0",
+					vite: "^6.0.0",
+					"@lifeart/async-dom": "latest"
+				}
+			}, null, 2)
+		},
+		{
+			path: "index.html",
+			content: `<!DOCTYPE html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title>${escapeHtml(name)}</title>
+  </head>
+  <body>
+    <div id="app"></div>
+    <script type="module" src="/src/main.ts"><\/script>
+  </body>
+</html>
+`
+		},
+		{
+			path: "src/main.ts",
+			content: `import { createApp } from "vue";
+import App from "./App.vue";
+createApp(App).mount("#app");
+`
+		},
+		{
+			path: "src/App.vue",
+			content: `<script setup lang="ts">
+import { AsyncDom } from "@lifeart/async-dom/vue";
+function onReady(instance: any) {
+  console.log("async-dom ready", instance);
+}
+<\/script>
+<template>
+  <AsyncDom worker="./app.worker.ts" @ready="onReady">
+    <template #fallback>
+      <p>Loading...</p>
+    </template>
+  </AsyncDom>
+</template>
+`
+		},
+		{
+			path: "src/app.worker.ts",
+			content: `import { createWorkerDom } from "@lifeart/async-dom/worker";
+const { document } = createWorkerDom();
+const heading = document.createElement("h1");
+heading.textContent = "Hello from async-dom + Vue!";
+document.body.appendChild(heading);
+`
+		},
+		{
+			path: "src/vite-env.d.ts",
+			content: `/// <reference types="vite/client" />
+declare module "*.vue" {
+  import type { DefineComponent } from "vue";
+  const component: DefineComponent<{}, {}, any>;
+  export default component;
+}
+`
+		},
+		{
+			path: "tsconfig.json",
+			content: JSON.stringify({
+				compilerOptions: {
+					target: "ES2022",
+					module: "ESNext",
+					moduleResolution: "bundler",
+					strict: true,
+					esModuleInterop: true,
+					skipLibCheck: true,
+					forceConsistentCasingInFileNames: true,
+					isolatedModules: true,
+					noEmit: true,
+					lib: [
+						"ES2022",
+						"DOM",
+						"DOM.Iterable"
+					]
+				},
+				include: ["src"]
+			}, null, 2)
+		},
+		{
+			path: "vite.config.ts",
+			content: `import { defineConfig } from "vite";
+import vue from "@vitejs/plugin-vue";
+import { asyncDomPlugin } from "@lifeart/async-dom/vite-plugin";
+export default defineConfig({
+  plugins: [vue(), asyncDomPlugin()],
+});
+`
+		}
+	];
+}
+//#endregion
+//#region src/cli/index.ts
+function ask(question) {
+	const rl = readline.createInterface({
+		input: process.stdin,
+		output: process.stdout
+	});
+	return new Promise((resolve) => {
+		rl.question(question, (answer) => {
+			rl.close();
+			resolve(answer.trim());
+		});
+	});
+}
+async function init(args) {
+	let name;
+	let template = "";
+	for (let i = 0; i < args.length; i++) if (args[i] === "--template" && args[i + 1]) {
+		template = args[i + 1];
+		i++;
+	} else if (!args[i].startsWith("-") && !name) name = args[i];
+	if (!name) {
+		name = await ask("Project name: ");
+		if (!name) {
+			console.error("Project name is required.");
+			process.exit(1);
+		}
+	}
+	if (!template) {
+		console.log("\nAvailable templates:");
+		for (const t of AVAILABLE_TEMPLATES) console.log(`  - ${t}`);
+		template = await ask("\nTemplate (default: vanilla-ts): ");
+		if (!template) template = "vanilla-ts";
+	}
+	if (!AVAILABLE_TEMPLATES.includes(template)) {
+		console.error(`Unknown template: ${template}. Available: ${AVAILABLE_TEMPLATES.join(", ")}`);
+		process.exit(1);
+	}
+	const targetDir = path.resolve(process.cwd(), name);
+	if (fs.existsSync(targetDir)) {
+		if (fs.readdirSync(targetDir).length > 0) {
+			console.error(`Directory "${name}" already exists and is not empty.`);
+			process.exit(1);
+		}
+	}
+	console.log(`\nScaffolding project in ${targetDir}...`);
+	const files = getTemplate(template, name);
+	for (const file of files) {
+		const filePath = path.join(targetDir, file.path);
+		const dir = path.dirname(filePath);
+		fs.mkdirSync(dir, { recursive: true });
+		fs.writeFileSync(filePath, file.content);
+		console.log(`  created ${file.path}`);
+	}
+	console.log(`\nDone! Now run:\n`);
+	console.log(`  cd ${name}`);
+	console.log("  npm install");
+	console.log("  npm run dev");
+	console.log("");
+}
+function printHelp() {
+	console.log(`
+@lifeart/async-dom - Asynchronous DOM rendering CLI
+Usage:
+  async-dom init [name] [--template <template>]
+Commands:
+  init    Scaffold a new async-dom project
+Templates:
+  ${AVAILABLE_TEMPLATES.join(", ")}
+Examples:
+  npx @lifeart/async-dom init my-app
+  npx @lifeart/async-dom init my-app --template react-ts
+`);
+}
+async function main() {
+	const args = process.argv.slice(2);
+	const command = args[0];
+	switch (command) {
+		case "init":
+			await init(args.slice(1));
+			break;
+		case "--help":
+		case "-h":
+		case void 0:
+			printHelp();
+			break;
+		default:
+			console.error(`Unknown command: ${command}`);
+			printHelp();
+			process.exit(1);
+	}
+}
+main().catch((err) => {
+	console.error(err);
+	process.exit(1);
+});
+//#endregion
+export {};
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"cli.js","names":[],"sources":["../src/cli/templates.ts","../src/cli/index.ts"],"sourcesContent":["/** A file to be written during project scaffolding. */\nexport interface TemplateFile {\n\t/** Relative path from the project root (e.g., \"src/main.ts\"). */\n\tpath: string;\n\t/** The full file content to write. */\n\tcontent: string;\n}\n\n/**\n * Returns the list of files for a given project template.\n *\n * @param template - Template name (one of {@link AVAILABLE_TEMPLATES}).\n * @param name - Project name, used in package.json and HTML title.\n * @returns Array of files to write to disk.\n * @throws If the template name is not recognized.\n */\nexport function getTemplate(template: string, name: string): TemplateFile[] {\n\tswitch (template) {\n\t\tcase \"vanilla-ts\":\n\t\t\treturn vanillaTs(name);\n\t\tcase \"react-ts\":\n\t\t\treturn reactTs(name);\n\t\tcase \"vue-ts\":\n\t\t\treturn vueTs(name);\n\t\tdefault:\n\t\t\tthrow new Error(`Unknown template: ${template}. Available: vanilla-ts, react-ts, vue-ts`);\n\t}\n}\n\n/** The list of available project templates for `async-dom init`. */\nexport const AVAILABLE_TEMPLATES = [\"vanilla-ts\", \"react-ts\", \"vue-ts\"] as const;\n\nfunction escapeHtml(str: string): string {\n\treturn str\n\t\t.replace(/&/g, \"&\")\n\t\t.replace(/</g, \"<\")\n\t\t.replace(/>/g, \">\")\n\t\t.replace(/\"/g, \""\");\n}\n\nfunction vanillaTs(name: string): TemplateFile[] {\n\treturn [\n\t\t{\n\t\t\tpath: \"package.json\",\n\t\t\tcontent: JSON.stringify(\n\t\t\t\t{\n\t\t\t\t\tname,\n\t\t\t\t\tprivate: true,\n\t\t\t\t\tversion: \"0.0.0\",\n\t\t\t\t\ttype: \"module\",\n\t\t\t\t\tscripts: {\n\t\t\t\t\t\tdev: \"vite\",\n\t\t\t\t\t\tbuild: \"tsc && vite build\",\n\t\t\t\t\t\tpreview: \"vite preview\",\n\t\t\t\t\t},\n\t\t\t\t\tdevDependencies: {\n\t\t\t\t\t\ttypescript: \"^5.8.0\",\n\t\t\t\t\t\tvite: \"^6.0.0\",\n\t\t\t\t\t\t\"@lifeart/async-dom\": \"latest\",\n\t\t\t\t\t},\n\t\t\t\t},\n\t\t\t\tnull,\n\t\t\t\t2,\n\t\t\t),\n\t\t},\n\t\t{\n\t\t\tpath: \"index.html\",\n\t\t\tcontent: `<!DOCTYPE html>\n<html lang=\"en\">\n <head>\n <meta charset=\"UTF-8\" />\n <meta name=\"viewport\" content=\"width=device-width, initial-scale=1.0\" />\n <title>${escapeHtml(name)}</title>\n </head>\n <body>\n <div id=\"app\"></div>\n <script type=\"module\" src=\"/src/main.ts\"></script>\n </body>\n</html>\n`,\n\t\t},\n\t\t{\n\t\t\tpath: \"src/main.ts\",\n\t\t\tcontent: `import { createAsyncDom } from \"@lifeart/async-dom\";\n\nconst worker = new Worker(new URL(\"./app.worker.ts\", import.meta.url), {\n type: \"module\",\n});\n\nconst instance = createAsyncDom({\n target: document.getElementById(\"app\")!,\n worker,\n});\n\ninstance.start();\n`,\n\t\t},\n\t\t{\n\t\t\tpath: \"src/app.worker.ts\",\n\t\t\tcontent: `import { createWorkerDom } from \"@lifeart/async-dom/worker\";\n\nconst { document } = createWorkerDom();\n\nconst heading = document.createElement(\"h1\");\nheading.textContent = \"Hello from async-dom!\";\ndocument.body.appendChild(heading);\n\nconst counter = document.createElement(\"button\");\ncounter.textContent = \"Count: 0\";\nlet count = 0;\ncounter.addEventListener(\"click\", () => {\n count++;\n counter.textContent = \\`Count: \\${count}\\`;\n});\ndocument.body.appendChild(counter);\n`,\n\t\t},\n\t\t{\n\t\t\tpath: \"src/vite-env.d.ts\",\n\t\t\tcontent: `/// <reference types=\"vite/client\" />\n`,\n\t\t},\n\t\t{\n\t\t\tpath: \"tsconfig.json\",\n\t\t\tcontent: JSON.stringify(\n\t\t\t\t{\n\t\t\t\t\tcompilerOptions: {\n\t\t\t\t\t\ttarget: \"ES2022\",\n\t\t\t\t\t\tmodule: \"ESNext\",\n\t\t\t\t\t\tmoduleResolution: \"bundler\",\n\t\t\t\t\t\tstrict: true,\n\t\t\t\t\t\tesModuleInterop: true,\n\t\t\t\t\t\tskipLibCheck: true,\n\t\t\t\t\t\tforceConsistentCasingInFileNames: true,\n\t\t\t\t\t\tisolatedModules: true,\n\t\t\t\t\t\tnoEmit: true,\n\t\t\t\t\t\tlib: [\"ES2022\", \"DOM\", \"DOM.Iterable\"],\n\t\t\t\t\t},\n\t\t\t\t\tinclude: [\"src\"],\n\t\t\t\t},\n\t\t\t\tnull,\n\t\t\t\t2,\n\t\t\t),\n\t\t},\n\t\t{\n\t\t\tpath: \"vite.config.ts\",\n\t\t\tcontent: `import { defineConfig } from \"vite\";\nimport { asyncDomPlugin } from \"@lifeart/async-dom/vite-plugin\";\n\nexport default defineConfig({\n plugins: [asyncDomPlugin()],\n});\n`,\n\t\t},\n\t];\n}\n\nfunction reactTs(name: string): TemplateFile[] {\n\treturn [\n\t\t{\n\t\t\tpath: \"package.json\",\n\t\t\tcontent: JSON.stringify(\n\t\t\t\t{\n\t\t\t\t\tname,\n\t\t\t\t\tprivate: true,\n\t\t\t\t\tversion: \"0.0.0\",\n\t\t\t\t\ttype: \"module\",\n\t\t\t\t\tscripts: {\n\t\t\t\t\t\tdev: \"vite\",\n\t\t\t\t\t\tbuild: \"tsc && vite build\",\n\t\t\t\t\t\tpreview: \"vite preview\",\n\t\t\t\t\t},\n\t\t\t\t\tdependencies: {\n\t\t\t\t\t\treact: \"^19.0.0\",\n\t\t\t\t\t\t\"react-dom\": \"^19.0.0\",\n\t\t\t\t\t},\n\t\t\t\t\tdevDependencies: {\n\t\t\t\t\t\t\"@types/react\": \"^19.0.0\",\n\t\t\t\t\t\t\"@types/react-dom\": \"^19.0.0\",\n\t\t\t\t\t\t\"@vitejs/plugin-react\": \"^4.0.0\",\n\t\t\t\t\t\ttypescript: \"^5.8.0\",\n\t\t\t\t\t\tvite: \"^6.0.0\",\n\t\t\t\t\t\t\"@lifeart/async-dom\": \"latest\",\n\t\t\t\t\t},\n\t\t\t\t},\n\t\t\t\tnull,\n\t\t\t\t2,\n\t\t\t),\n\t\t},\n\t\t{\n\t\t\tpath: \"index.html\",\n\t\t\tcontent: `<!DOCTYPE html>\n<html lang=\"en\">\n <head>\n <meta charset=\"UTF-8\" />\n <meta name=\"viewport\" content=\"width=device-width, initial-scale=1.0\" />\n <title>${escapeHtml(name)}</title>\n </head>\n <body>\n <div id=\"root\"></div>\n <script type=\"module\" src=\"/src/main.tsx\"></script>\n </body>\n</html>\n`,\n\t\t},\n\t\t{\n\t\t\tpath: \"src/main.tsx\",\n\t\t\tcontent: `import { StrictMode } from \"react\";\nimport { createRoot } from \"react-dom/client\";\nimport { App } from \"./App\";\n\ncreateRoot(document.getElementById(\"root\")!).render(\n <StrictMode>\n <App />\n </StrictMode>,\n);\n`,\n\t\t},\n\t\t{\n\t\t\tpath: \"src/App.tsx\",\n\t\t\tcontent: `import { AsyncDom } from \"@lifeart/async-dom/react\";\n\nexport function App() {\n return (\n <AsyncDom\n worker=\"./app.worker.ts\"\n fallback={<p>Loading...</p>}\n onReady={(instance) => console.log(\"async-dom ready\", instance)}\n />\n );\n}\n`,\n\t\t},\n\t\t{\n\t\t\tpath: \"src/app.worker.ts\",\n\t\t\tcontent: `import { createWorkerDom } from \"@lifeart/async-dom/worker\";\n\nconst { document } = createWorkerDom();\n\nconst heading = document.createElement(\"h1\");\nheading.textContent = \"Hello from async-dom + React!\";\ndocument.body.appendChild(heading);\n`,\n\t\t},\n\t\t{\n\t\t\tpath: \"src/vite-env.d.ts\",\n\t\t\tcontent: `/// <reference types=\"vite/client\" />\n`,\n\t\t},\n\t\t{\n\t\t\tpath: \"tsconfig.json\",\n\t\t\tcontent: JSON.stringify(\n\t\t\t\t{\n\t\t\t\t\tcompilerOptions: {\n\t\t\t\t\t\ttarget: \"ES2022\",\n\t\t\t\t\t\tmodule: \"ESNext\",\n\t\t\t\t\t\tmoduleResolution: \"bundler\",\n\t\t\t\t\t\tstrict: true,\n\t\t\t\t\t\tesModuleInterop: true,\n\t\t\t\t\t\tskipLibCheck: true,\n\t\t\t\t\t\tforceConsistentCasingInFileNames: true,\n\t\t\t\t\t\tisolatedModules: true,\n\t\t\t\t\t\tnoEmit: true,\n\t\t\t\t\t\tjsx: \"react-jsx\",\n\t\t\t\t\t\tlib: [\"ES2022\", \"DOM\", \"DOM.Iterable\"],\n\t\t\t\t\t},\n\t\t\t\t\tinclude: [\"src\"],\n\t\t\t\t},\n\t\t\t\tnull,\n\t\t\t\t2,\n\t\t\t),\n\t\t},\n\t\t{\n\t\t\tpath: \"vite.config.ts\",\n\t\t\tcontent: `import { defineConfig } from \"vite\";\nimport react from \"@vitejs/plugin-react\";\nimport { asyncDomPlugin } from \"@lifeart/async-dom/vite-plugin\";\n\nexport default defineConfig({\n plugins: [react(), asyncDomPlugin()],\n});\n`,\n\t\t},\n\t];\n}\n\nfunction vueTs(name: string): TemplateFile[] {\n\treturn [\n\t\t{\n\t\t\tpath: \"package.json\",\n\t\t\tcontent: JSON.stringify(\n\t\t\t\t{\n\t\t\t\t\tname,\n\t\t\t\t\tprivate: true,\n\t\t\t\t\tversion: \"0.0.0\",\n\t\t\t\t\ttype: \"module\",\n\t\t\t\t\tscripts: {\n\t\t\t\t\t\tdev: \"vite\",\n\t\t\t\t\t\tbuild: \"vue-tsc && vite build\",\n\t\t\t\t\t\tpreview: \"vite preview\",\n\t\t\t\t\t},\n\t\t\t\t\tdependencies: {\n\t\t\t\t\t\tvue: \"^3.5.0\",\n\t\t\t\t\t},\n\t\t\t\t\tdevDependencies: {\n\t\t\t\t\t\t\"@vitejs/plugin-vue\": \"^5.0.0\",\n\t\t\t\t\t\ttypescript: \"^5.8.0\",\n\t\t\t\t\t\t\"vue-tsc\": \"^2.0.0\",\n\t\t\t\t\t\tvite: \"^6.0.0\",\n\t\t\t\t\t\t\"@lifeart/async-dom\": \"latest\",\n\t\t\t\t\t},\n\t\t\t\t},\n\t\t\t\tnull,\n\t\t\t\t2,\n\t\t\t),\n\t\t},\n\t\t{\n\t\t\tpath: \"index.html\",\n\t\t\tcontent: `<!DOCTYPE html>\n<html lang=\"en\">\n <head>\n <meta charset=\"UTF-8\" />\n <meta name=\"viewport\" content=\"width=device-width, initial-scale=1.0\" />\n <title>${escapeHtml(name)}</title>\n </head>\n <body>\n <div id=\"app\"></div>\n <script type=\"module\" src=\"/src/main.ts\"></script>\n </body>\n</html>\n`,\n\t\t},\n\t\t{\n\t\t\tpath: \"src/main.ts\",\n\t\t\tcontent: `import { createApp } from \"vue\";\nimport App from \"./App.vue\";\n\ncreateApp(App).mount(\"#app\");\n`,\n\t\t},\n\t\t{\n\t\t\tpath: \"src/App.vue\",\n\t\t\tcontent: `<script setup lang=\"ts\">\nimport { AsyncDom } from \"@lifeart/async-dom/vue\";\n\nfunction onReady(instance: any) {\n console.log(\"async-dom ready\", instance);\n}\n</script>\n\n<template>\n <AsyncDom worker=\"./app.worker.ts\" @ready=\"onReady\">\n <template #fallback>\n <p>Loading...</p>\n </template>\n </AsyncDom>\n</template>\n`,\n\t\t},\n\t\t{\n\t\t\tpath: \"src/app.worker.ts\",\n\t\t\tcontent: `import { createWorkerDom } from \"@lifeart/async-dom/worker\";\n\nconst { document } = createWorkerDom();\n\nconst heading = document.createElement(\"h1\");\nheading.textContent = \"Hello from async-dom + Vue!\";\ndocument.body.appendChild(heading);\n`,\n\t\t},\n\t\t{\n\t\t\tpath: \"src/vite-env.d.ts\",\n\t\t\tcontent: `/// <reference types=\"vite/client\" />\ndeclare module \"*.vue\" {\n import type { DefineComponent } from \"vue\";\n const component: DefineComponent<{}, {}, any>;\n export default component;\n}\n`,\n\t\t},\n\t\t{\n\t\t\tpath: \"tsconfig.json\",\n\t\t\tcontent: JSON.stringify(\n\t\t\t\t{\n\t\t\t\t\tcompilerOptions: {\n\t\t\t\t\t\ttarget: \"ES2022\",\n\t\t\t\t\t\tmodule: \"ESNext\",\n\t\t\t\t\t\tmoduleResolution: \"bundler\",\n\t\t\t\t\t\tstrict: true,\n\t\t\t\t\t\tesModuleInterop: true,\n\t\t\t\t\t\tskipLibCheck: true,\n\t\t\t\t\t\tforceConsistentCasingInFileNames: true,\n\t\t\t\t\t\tisolatedModules: true,\n\t\t\t\t\t\tnoEmit: true,\n\t\t\t\t\t\tlib: [\"ES2022\", \"DOM\", \"DOM.Iterable\"],\n\t\t\t\t\t},\n\t\t\t\t\tinclude: [\"src\"],\n\t\t\t\t},\n\t\t\t\tnull,\n\t\t\t\t2,\n\t\t\t),\n\t\t},\n\t\t{\n\t\t\tpath: \"vite.config.ts\",\n\t\t\tcontent: `import { defineConfig } from \"vite\";\nimport vue from \"@vitejs/plugin-vue\";\nimport { asyncDomPlugin } from \"@lifeart/async-dom/vite-plugin\";\n\nexport default defineConfig({\n plugins: [vue(), asyncDomPlugin()],\n});\n`,\n\t\t},\n\t];\n}\n","import * as fs from \"node:fs\";\nimport * as path from \"node:path\";\nimport * as readline from \"node:readline\";\nimport { AVAILABLE_TEMPLATES, getTemplate } from \"./templates.ts\";\n\nfunction ask(question: string): Promise<string> {\n\tconst rl = readline.createInterface({\n\t\tinput: process.stdin,\n\t\toutput: process.stdout,\n\t});\n\treturn new Promise((resolve) => {\n\t\trl.question(question, (answer) => {\n\t\t\trl.close();\n\t\t\tresolve(answer.trim());\n\t\t});\n\t});\n}\n\nasync function init(args: string[]): Promise<void> {\n\tlet name: string | undefined;\n\tlet template = \"\";\n\n\t// Parse flags\n\tfor (let i = 0; i < args.length; i++) {\n\t\tif (args[i] === \"--template\" && args[i + 1]) {\n\t\t\ttemplate = args[i + 1];\n\t\t\ti++;\n\t\t} else if (!args[i].startsWith(\"-\") && !name) {\n\t\t\tname = args[i];\n\t\t}\n\t}\n\n\t// Interactive prompts for missing values\n\tif (!name) {\n\t\tname = await ask(\"Project name: \");\n\t\tif (!name) {\n\t\t\tconsole.error(\"Project name is required.\");\n\t\t\tprocess.exit(1);\n\t\t}\n\t}\n\n\tif (!template) {\n\t\tconsole.log(\"\\nAvailable templates:\");\n\t\tfor (const t of AVAILABLE_TEMPLATES) {\n\t\t\tconsole.log(` - ${t}`);\n\t\t}\n\t\ttemplate = await ask(\"\\nTemplate (default: vanilla-ts): \");\n\t\tif (!template) template = \"vanilla-ts\";\n\t}\n\n\t// Validate template\n\tif (!AVAILABLE_TEMPLATES.includes(template as (typeof AVAILABLE_TEMPLATES)[number])) {\n\t\tconsole.error(`Unknown template: ${template}. Available: ${AVAILABLE_TEMPLATES.join(\", \")}`);\n\t\tprocess.exit(1);\n\t}\n\n\tconst targetDir = path.resolve(process.cwd(), name);\n\n\tif (fs.existsSync(targetDir)) {\n\t\tconst contents = fs.readdirSync(targetDir);\n\t\tif (contents.length > 0) {\n\t\t\tconsole.error(`Directory \"${name}\" already exists and is not empty.`);\n\t\t\tprocess.exit(1);\n\t\t}\n\t}\n\n\tconsole.log(`\\nScaffolding project in ${targetDir}...`);\n\n\tconst files = getTemplate(template, name);\n\n\tfor (const file of files) {\n\t\tconst filePath = path.join(targetDir, file.path);\n\t\tconst dir = path.dirname(filePath);\n\t\tfs.mkdirSync(dir, { recursive: true });\n\t\tfs.writeFileSync(filePath, file.content);\n\t\tconsole.log(` created ${file.path}`);\n\t}\n\n\tconsole.log(`\\nDone! Now run:\\n`);\n\tconsole.log(` cd ${name}`);\n\tconsole.log(\" npm install\");\n\tconsole.log(\" npm run dev\");\n\tconsole.log(\"\");\n}\n\nfunction printHelp(): void {\n\tconsole.log(`\n@lifeart/async-dom - Asynchronous DOM rendering CLI\n\nUsage:\n async-dom init [name] [--template <template>]\n\nCommands:\n init Scaffold a new async-dom project\n\nTemplates:\n ${AVAILABLE_TEMPLATES.join(\", \")}\n\nExamples:\n npx @lifeart/async-dom init my-app\n npx @lifeart/async-dom init my-app --template react-ts\n`);\n}\n\nasync function main(): Promise<void> {\n\tconst args = process.argv.slice(2);\n\tconst command = args[0];\n\n\tswitch (command) {\n\t\tcase \"init\":\n\t\t\tawait init(args.slice(1));\n\t\t\tbreak;\n\t\tcase \"--help\":\n\t\tcase \"-h\":\n\t\tcase undefined:\n\t\t\tprintHelp();\n\t\t\tbreak;\n\t\tdefault:\n\t\t\tconsole.error(`Unknown command: ${command}`);\n\t\t\tprintHelp();\n\t\t\tprocess.exit(1);\n\t}\n}\n\nmain().catch((err) => {\n\tconsole.error(err);\n\tprocess.exit(1);\n});\n"],"mappings":"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"}

package/dist/debug.d.cts ADDED Viewed

@@ -0,0 +1,145 @@
+import { c as DomMutation } from "./base.cjs";
+//#region src/core/debug.d.ts
+/**
+ * Options for enabling debug logging and the in-page devtools panel.
+ *
+ * Each `log*` flag enables a category of structured log output. Provide a
+ * custom `logger` to redirect output (e.g. to a remote telemetry service).
+ */
+interface DebugOptions {
+  /** Log every DOM mutation applied by the renderer. */
+  logMutations?: boolean;
+  /** Log event serialization and dispatch timing. */
+  logEvents?: boolean;
+  /** Log synchronous DOM read requests (getBoundingClientRect, computedStyle, etc.). */
+  logSyncReads?: boolean;
+  /** Log per-frame scheduler statistics (actions processed, frame time, queue depth). */
+  logScheduler?: boolean;
+  /** Log warnings such as missing nodes, sync timeouts, and blocked properties. */
+  logWarnings?: boolean;
+  /** Custom logger implementation. Unset methods fall back to `console.*`. */
+  logger?: Partial<DebugLogger>;
+  /** Expose `__ASYNC_DOM_DEVTOOLS__` on `globalThis` and inject the in-page devtools panel. */
+  exposeDevtools?: boolean;
+}
+/**
+ * Custom logger that receives structured debug entries.
+ *
+ * Implement any subset of these methods and pass via `DebugOptions.logger`.
+ */
+interface DebugLogger {
+  /** Called for each DOM mutation applied on the main thread. */
+  mutation(entry: MutationLogEntry): void;
+  /** Called for event serialization and dispatch timing. */
+  event(entry: EventLogEntry): void;
+  /** Called for each synchronous DOM read request. */
+  syncRead(entry: SyncReadLogEntry): void;
+  /** Called once per scheduler frame with aggregate statistics. */
+  scheduler(entry: SchedulerLogEntry): void;
+  /** Called for async-dom warnings (missing nodes, timeouts, etc.). */
+  warning(entry: WarningLogEntry): void;
+}
+/** A single DOM mutation log entry emitted by the debug system. */
+interface MutationLogEntry {
+  /** Which thread generated this entry. */
+  side: "worker" | "main";
+  /** The mutation action name (e.g. "createElement", "setAttribute"). */
+  action: string;
+  /** The full mutation payload. */
+  mutation: DomMutation;
+  /** High-resolution timestamp (via `performance.now()`). */
+  timestamp: number;
+  /** Batch UID that groups related mutations from a single flush. */
+  batchUid?: number;
+}
+/** A single event timing log entry emitted by the debug system. */
+interface EventLogEntry {
+  /** Which thread generated this entry. */
+  side: "worker" | "main";
+  /** Whether this captures serialization or dispatch timing. */
+  phase: "serialize" | "dispatch";
+  /** The DOM event type (e.g. "click", "input"). */
+  eventType: string;
+  /** Unique listener identifier. */
+  listenerId: string;
+  /** Node ID of the event target, or `null` if unavailable. */
+  targetId: string | null;
+  /** High-resolution timestamp (via `performance.now()`). */
+  timestamp: number;
+  /** Time in ms the event spent in transport between threads. */
+  transportMs?: number;
+  /** Time in ms the worker spent dispatching the event handler. */
+  dispatchMs?: number;
+  /** Number of DOM mutations produced by the event handler. */
+  mutationCount?: number;
+}
+/** A single synchronous DOM read log entry. */
+interface SyncReadLogEntry {
+  /** The query type enum value (BoundingRect, ComputedStyle, etc.). */
+  queryType: number;
+  /** The target node ID as a string. */
+  nodeId: string;
+  /** Round-trip latency in milliseconds. */
+  latencyMs: number;
+  /** Whether the read succeeded, timed out, or threw an error. */
+  result: "success" | "timeout" | "error";
+  /** High-resolution timestamp (via `performance.now()`). */
+  timestamp: number;
+}
+/** A single scheduler frame log entry. */
+interface SchedulerLogEntry {
+  /** Monotonically increasing frame counter. */
+  frameId: number;
+  /** Number of mutations processed in this frame. */
+  actionsProcessed: number;
+  /** Total wall-clock time spent processing this frame in ms. */
+  frameTimeMs: number;
+  /** Number of mutations remaining in the queue after this frame. */
+  queueDepth: number;
+  /** High-resolution timestamp (via `performance.now()`). */
+  timestamp: number;
+}
+/** A warning entry emitted when async-dom detects a potential problem. */
+interface WarningLogEntry {
+  /** Machine-readable warning code (see `WarningCode`). */
+  code: string;
+  /** Human-readable description of the problem. */
+  message: string;
+  /** Additional context data relevant to the warning. */
+  context: Record<string, unknown>;
+  /** High-resolution timestamp (via `performance.now()`). */
+  timestamp: number;
+}
+declare const WarningCode: {
+  readonly MISSING_NODE: "ASYNC_DOM_MISSING_NODE";
+  readonly SYNC_TIMEOUT: "ASYNC_DOM_SYNC_TIMEOUT";
+  readonly LISTENER_NOT_FOUND: "ASYNC_DOM_LISTENER_NOT_FOUND";
+  readonly EVENT_ATTACH_FAILED: "ASYNC_DOM_EVENT_ATTACH_FAILED";
+  readonly TRANSPORT_NOT_OPEN: "ASYNC_DOM_TRANSPORT_NOT_OPEN";
+  readonly BLOCKED_PROPERTY: "ASYNC_DOM_BLOCKED_PROPERTY";
+  readonly WORKER_ERROR: "WORKER_ERROR";
+  readonly WORKER_UNHANDLED_REJECTION: "WORKER_UNHANDLED_REJECTION";
+};
+declare class DebugStats {
+  mutationsAdded: number;
+  mutationsCoalesced: number;
+  mutationsFlushed: number;
+  mutationsApplied: number;
+  eventsForwarded: number;
+  eventsDispatched: number;
+  syncReadRequests: number;
+  syncReadTimeouts: number;
+  snapshot(): Record<string, number>;
+  reset(): void;
+}
+/**
+ * Mutation-to-event correlation index (Feature 19: "Why Was This Node Updated?").
+ *
+ * Indexes mutations by nodeId and links them to their batch and causal event,
+ * allowing reverse lookups: given a nodeId, find why it was updated.
+ */
+//#endregion
+export { MutationLogEntry as a, WarningCode as c, EventLogEntry as i, WarningLogEntry as l, DebugOptions as n, SchedulerLogEntry as o, DebugStats as r, SyncReadLogEntry as s, DebugLogger as t };
+//# sourceMappingURL=debug.d.cts.map

package/dist/debug.d.cts.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"debug.d.cts","names":[],"sources":["../src/core/debug.ts"],"sourcesContent":[],"mappings":";;;;;;AAQA;;;;AAYiB,UAZA,YAAA,CAYA;EAUA;EAAW,YAAA,CAAA,EAAA,OAAA;;WAId,CAAA,EAAA,OAAA;;cAII,CAAA,EAAA,OAAA;;EAEa,YAAA,CAAA,EAAA,OAAA;EAId;EAcA,WAAA,CAAA,EAAA,OAAa;EAsBb;EAcA,MAAA,CAAA,EA1EP,OA0EO,CA1EC,WA0EgB,CAAA;EAcjB;EAWJ,cASH,CAAA,EAAA,OAAA;AAsEV;;;;;;UAxKiB,WAAA;;kBAEA;;eAEH;;kBAEG;;mBAEC;;iBAEF;;;UAIC,gBAAA;;;;;;YAMN;;;;;;;UAQM,aAAA;;;;;;;;;;;;;;;;;;;;;UAsBA,gBAAA;;;;;;;;;;;;;UAcA,iBAAA;;;;;;;;;;;;;UAcA,eAAA;;;;;;WAMP;;;;cAKG;;;;;;;;;;cA+EA,UAAA;;;;;;;;;cAUA"}