@expressive/dom 0.0.0 → 0.2.0

package/dist/vite.js

@@ -0,0 +1,142 @@
+import { dirname } from "node:path";
+
+//#region src/vite.ts
+const SOURCE = /\.[cm]?[jt]sx?$/;
+const COMPONENT = /^[A-Z]/;
+const FUNCTION = ["ArrowFunctionExpression", "FunctionExpression"];
+/**
+* Top-level classes a module can reassign, those declaring private members,
+* function components by name, and its exports by local binding.
+*/
+function scan(body) {
+	const classes = [];
+	const hidden = [];
+	const components = [];
+	const exports = {};
+	function add(name, node) {
+		classes.push(name);
+		if (node.body.body.some((member) => member.key?.type == "PrivateIdentifier")) hidden.push(name);
+	}
+	function collect(node) {
+		if (node.type == "ClassDeclaration" && node.id) add(node.id.name, node);
+		else if (node.type == "FunctionDeclaration" && COMPONENT.test(node.id?.name)) components.push(node.id.name);
+		else if (node.type == "VariableDeclaration") for (const { id, init } of node.declarations) {
+			if (id.type != "Identifier") continue;
+			if (init?.type == "ClassExpression" && node.kind != "const") add(id.name, init);
+			else if (FUNCTION.includes(init?.type) && COMPONENT.test(id.name)) components.push(id.name);
+		}
+	}
+	function names(node) {
+		if (node.type == "VariableDeclaration") return node.declarations.flatMap(({ id }) => id.type == "Identifier" ? [id.name] : []);
+		return [node.id.name];
+	}
+	for (const node of body) if (node.type == "ExportNamedDeclaration") {
+		if (node.declaration) {
+			collect(node.declaration);
+			for (const name of names(node.declaration)) exports[name] = name;
+		} else if (!node.source) for (const { local, exported } of node.specifiers) exports[exported.name ?? exported.value] = local.name;
+	} else if (node.type == "ExportDefaultDeclaration") {
+		const { declaration } = node;
+		collect(declaration);
+		if (declaration.id) exports.default = declaration.id.name;
+	} else collect(node);
+	return {
+		classes,
+		hidden,
+		components,
+		exports
+	};
+}
+/**
+* Bind a module's classes to `hot.accept` and its function components to dom's
+* refresh. A State class it could not patch reloads the page; after an update,
+* a changed component re-renders in place and any other changed export
+* invalidates importers.
+*/
+function inject(id, body, ssr = false) {
+	const { classes, hidden, components, exports } = scan(body);
+	if (!classes.length && !components.length) return "";
+	const list = classes.join(", ");
+	const record = Object.entries(exports).map(([name, local]) => `${JSON.stringify(name)}: ${local}`);
+	const refresh = Object.keys(exports).filter((name) => components.includes(exports[name]));
+	const effect = ssr ? "replace it instead of patching" : "will trigger a full reload";
+	const notes = hidden.map((name) => `${JSON.stringify(name)}: ${JSON.stringify(`[expressive] ${name} (${id}) declares #private members, so edits to its module ${effect}. Use _ properties instead to keep HMR.`)}`);
+	const replace = ssr ? `  const __notes = { ${notes.join(", ")} };
+  const __before = import.meta.hot.data.expressive;
+  const __classes = (import.meta.hot.data.expressive = { ${list} });
+  const __warned = (import.meta.hot.data.warned ||= {});
+  for (const key in __notes)
+    if (__before && __classes[key] !== __before[key] && !__warned[key]) {
+      __warned[key] = true;
+      console.warn(__notes[key]);
+    }
+` : `  const __notes = { ${notes.join(", ")} };
+  const __flag = (key) => 'expressive:private:' + ${JSON.stringify(id)} + ':' + key;
+  for (const key in __notes)
+    try {
+      if (sessionStorage.getItem(__flag(key)) == 'due') {
+        console.warn(__notes[key]);
+        sessionStorage.setItem(__flag(key), 'shown');
+      }
+    } catch {}
+  const __before = import.meta.hot.data.expressive;
+  const __classes = (import.meta.hot.data.expressive = { ${list} });
+  for (const key in __before)
+    if (__classes[key] !== __before[key] && __classes[key]?.prototype instanceof __State) {
+      const note = __notes[key];
+      if (note)
+        try {
+          if (!sessionStorage.getItem(__flag(key))) sessionStorage.setItem(__flag(key), 'due');
+        } catch {
+          console.warn(note);
+        }
+      dispatchEvent(new CustomEvent('expressive:reload', { detail: { module: ${JSON.stringify(id)}, class: key, reason: note ? 'private members' : 'class changed shape' } }));
+      location.reload();
+      break;
+    }
+`;
+	const lines = ["", `import { State as __State } from '@expressive/mvc';`];
+	if (classes.length) lines.push(`import { hot as __expressive } from '@expressive/mvc/runtime';`, "{", `  const __hot = __expressive.accept(${JSON.stringify(id)}, { ${list} });`, ...classes.map((name) => `  ${name} = __hot.${name};`), "}");
+	if (components.length) lines.push(`import { hot as __refresh } from '@expressive/dom/jsx-dev-runtime';`, `__refresh(${JSON.stringify(id)}, { ${components.join(", ")} });`);
+	lines.push(`if (import.meta.hot) {
+${replace}  const __exports = { ${record.join(", ")} };
+  import.meta.hot.accept((next) => {
+    if (!next) return;
+    for (const key in __exports) {
+      const after = next[key];
+      if (after !== __exports[key] && !(after?.prototype instanceof __State) && !${JSON.stringify(refresh)}.includes(key))
+        return import.meta.hot.invalidate(\`"\${key}" export cannot be hot-patched.\`);
+    }
+  });
+}
+`);
+	return lines.join("\n");
+}
+/** Hot-patch classes and refresh function components in place during `vite` dev. */
+function expressive() {
+	let root = "";
+	let runtime;
+	return {
+		name: "@expressive/dom:hot",
+		apply: "serve",
+		enforce: "post",
+		configResolved(config) {
+			root = config.root;
+		},
+		async transform(code, id, options) {
+			const [file] = id.split("?");
+			if (!SOURCE.test(file) || file.includes("/node_modules/")) return;
+			runtime ||= Promise.all(["@expressive/mvc/runtime", "@expressive/dom/jsx-dev-runtime"].map((entry) => this.resolve(entry).then((found) => found && dirname(found.id))));
+			for (const own of await runtime) if (own && file.startsWith(own)) return;
+			const output = inject(file.startsWith(root + "/") ? file.slice(root.length) : file, this.parse(code).body, options?.ssr);
+			if (output) return {
+				code: code + output,
+				map: null
+			};
+		}
+	};
+}
+
+//#endregion
+export { expressive as default };
+//# sourceMappingURL=vite.js.map

package/dist/vite.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vite.js","names":[],"sources":["../src/vite.ts"],"sourcesContent":["import { dirname } from 'node:path';\nimport type { Plugin } from 'vite';\n\ntype Node = { type: string; [key: string]: any };\n\nconst SOURCE = /\\.[cm]?[jt]sx?$/;\n\nconst COMPONENT = /^[A-Z]/;\nconst FUNCTION = ['ArrowFunctionExpression', 'FunctionExpression'];\n\n/**\n * Top-level classes a module can reassign, those declaring private members,\n * function components by name, and its exports by local binding.\n */\nfunction scan(body: Node[]) {\n  const classes: string[] = [];\n  const hidden: string[] = [];\n  const components: string[] = [];\n  const exports: Record<string, string> = {};\n\n  function add(name: string, node: Node) {\n    classes.push(name);\n\n    if (node.body.body.some((member: Node) => member.key?.type == 'PrivateIdentifier')) hidden.push(name);\n  }\n\n  function collect(node: Node) {\n    if (node.type == 'ClassDeclaration' && node.id) add(node.id.name, node);\n    else if (node.type == 'FunctionDeclaration' && COMPONENT.test(node.id?.name)) components.push(node.id.name);\n    else if (node.type == 'VariableDeclaration')\n      for (const { id, init } of node.declarations) {\n        if (id.type != 'Identifier') continue;\n        if (init?.type == 'ClassExpression' && node.kind != 'const') add(id.name, init);\n        else if (FUNCTION.includes(init?.type) && COMPONENT.test(id.name)) components.push(id.name);\n      }\n  }\n\n  function names(node: Node): string[] {\n    if (node.type == 'VariableDeclaration')\n      return node.declarations.flatMap(({ id }: Node) => (id.type == 'Identifier' ? [id.name] : []));\n\n    return [node.id.name];\n  }\n\n  for (const node of body) {\n    if (node.type == 'ExportNamedDeclaration') {\n      if (node.declaration) {\n        collect(node.declaration);\n        for (const name of names(node.declaration)) exports[name] = name;\n      } else if (!node.source)\n        for (const { local, exported } of node.specifiers)\n          exports[exported.name ?? exported.value] = local.name;\n    } else if (node.type == 'ExportDefaultDeclaration') {\n      const { declaration } = node;\n\n      collect(declaration);\n\n      if (declaration.id) exports.default = declaration.id.name;\n    } else collect(node);\n  }\n\n  return { classes, hidden, components, exports };\n}\n\n/**\n * Bind a module's classes to `hot.accept` and its function components to dom's\n * refresh. A State class it could not patch reloads the page; after an update,\n * a changed component re-renders in place and any other changed export\n * invalidates importers.\n */\nfunction inject(id: string, body: Node[], ssr = false) {\n  const { classes, hidden, components, exports } = scan(body);\n\n  if (!classes.length && !components.length) return '';\n\n  const list = classes.join(', ');\n  const record = Object.entries(exports).map(([name, local]) => `${JSON.stringify(name)}: ${local}`);\n  const refresh = Object.keys(exports).filter((name) => components.includes(exports[name]));\n  const effect = ssr ? 'replace it instead of patching' : 'will trigger a full reload';\n  const notes = hidden.map(\n    (name) =>\n      `${JSON.stringify(name)}: ${JSON.stringify(`[expressive] ${name} (${id}) declares #private members, so edits to its module ${effect}. Use _ properties instead to keep HMR.`)}`\n  );\n  const replace = ssr\n    ? `  const __notes = { ${notes.join(', ')} };\n  const __before = import.meta.hot.data.expressive;\n  const __classes = (import.meta.hot.data.expressive = { ${list} });\n  const __warned = (import.meta.hot.data.warned ||= {});\n  for (const key in __notes)\n    if (__before && __classes[key] !== __before[key] && !__warned[key]) {\n      __warned[key] = true;\n      console.warn(__notes[key]);\n    }\n`\n    : `  const __notes = { ${notes.join(', ')} };\n  const __flag = (key) => 'expressive:private:' + ${JSON.stringify(id)} + ':' + key;\n  for (const key in __notes)\n    try {\n      if (sessionStorage.getItem(__flag(key)) == 'due') {\n        console.warn(__notes[key]);\n        sessionStorage.setItem(__flag(key), 'shown');\n      }\n    } catch {}\n  const __before = import.meta.hot.data.expressive;\n  const __classes = (import.meta.hot.data.expressive = { ${list} });\n  for (const key in __before)\n    if (__classes[key] !== __before[key] && __classes[key]?.prototype instanceof __State) {\n      const note = __notes[key];\n      if (note)\n        try {\n          if (!sessionStorage.getItem(__flag(key))) sessionStorage.setItem(__flag(key), 'due');\n        } catch {\n          console.warn(note);\n        }\n      dispatchEvent(new CustomEvent('expressive:reload', { detail: { module: ${JSON.stringify(id)}, class: key, reason: note ? 'private members' : 'class changed shape' } }));\n      location.reload();\n      break;\n    }\n`;\n  const lines = ['', `import { State as __State } from '@expressive/mvc';`];\n\n  if (classes.length)\n    lines.push(\n      `import { hot as __expressive } from '@expressive/mvc/runtime';`,\n      '{',\n      `  const __hot = __expressive.accept(${JSON.stringify(id)}, { ${list} });`,\n      ...classes.map((name) => `  ${name} = __hot.${name};`),\n      '}'\n    );\n\n  if (components.length)\n    lines.push(\n      `import { hot as __refresh } from '@expressive/dom/jsx-dev-runtime';`,\n      `__refresh(${JSON.stringify(id)}, { ${components.join(', ')} });`\n    );\n\n  lines.push(`if (import.meta.hot) {\n${replace}  const __exports = { ${record.join(', ')} };\n  import.meta.hot.accept((next) => {\n    if (!next) return;\n    for (const key in __exports) {\n      const after = next[key];\n      if (after !== __exports[key] && !(after?.prototype instanceof __State) && !${JSON.stringify(refresh)}.includes(key))\n        return import.meta.hot.invalidate(\\`\"\\${key}\" export cannot be hot-patched.\\`);\n    }\n  });\n}\n`);\n\n  return lines.join('\\n');\n}\n\n/** Hot-patch classes and refresh function components in place during `vite` dev. */\nexport default function expressive(): Plugin {\n  let root = '';\n  let runtime: Promise<(string | null | undefined)[]> | undefined;\n\n  return {\n    name: '@expressive/dom:hot',\n    apply: 'serve',\n    enforce: 'post',\n    configResolved(config) {\n      root = config.root;\n    },\n    async transform(code, id, options) {\n      const [file] = id.split('?');\n\n      if (!SOURCE.test(file) || file.includes('/node_modules/')) return;\n\n      runtime ||= Promise.all(\n        ['@expressive/mvc/runtime', '@expressive/dom/jsx-dev-runtime'].map((entry) =>\n          this.resolve(entry).then((found) => found && dirname(found.id))\n        )\n      );\n\n      for (const own of await runtime) if (own && file.startsWith(own)) return;\n\n      const output = inject(file.startsWith(root + '/') ? file.slice(root.length) : file, this.parse(code).body as Node[], options?.ssr);\n\n      if (output) return { code: code + output, map: null };\n    }\n  };\n}\n"],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@expressive/dom",
-  "version": "0.0.0",
+  "version": "0.2.0",
   "description": "MVC-native DOM renderer.",
   "license": "MIT",
   "author": {
@@ -36,6 +36,10 @@
     "./jsx-dev-runtime": {
       "types": "./dist/jsx-dev-runtime.d.ts",
       "default": "./dist/jsx-dev-runtime.js"
+    },
+    "./vite": {
+      "types": "./dist/vite.d.ts",
+      "default": "./dist/vite.js"
     }
   },
   "engines": {
@@ -49,11 +53,18 @@
     "test": "tsc --noEmit && vitest run --coverage"
   },
   "peerDependencies": {
-    "@expressive/mvc": "^0.85.0"
+    "@expressive/mvc": "^0.87.0",
+    "vite": ">=5"
+  },
+  "peerDependenciesMeta": {
+    "vite": {
+      "optional": true
+    }
   },
   "devDependencies": {
     "@expressive/mvc": "workspace:^",
     "@types/node": "^25.2.0",
-    "tsdown": "^0.20.1"
+    "tsdown": "^0.20.1",
+    "vite": "^7.3.1"
   }
 }