@imfusion/web-ui 0.10.1-dev.34.gb01a818e → 0.10.1-dev.41.g467e0e1a

package/dist/vite/local-web-ui-link.d.ts

@@ -1,8 +1,12 @@
 import { Plugin, UserConfig } from 'vite';
-/** Returns `undefined` for an installed package; only a checkout outside `node_modules` needs the config. */
+/**
+ * Returns `undefined` for an installed package that `web-ui link` has not claimed. A linked package is excluded from
+ * dependency pre-bundling so its rebuilt files are served directly. A checkout outside `node_modules` gets peer dedupe.
+ */
 export declare function localWebUILinkConfig(root: string): UserConfig | undefined;
 /**
- * Lets a consumer link a local checkout (`"@imfusion/web-ui": "file:../web-ui"`) without loading two copies of React in
- * client dev and build. SSR is not covered. Does nothing for an installed package, so it can stay registered.
+ * Lets a consumer keep `localWebUILink()` registered for good. With no link it does nothing for an installed package.
+ * After `npx web-ui link <checkout>` it serves the linked build and reloads the page on each rebuild. Server rendering
+ * is not covered.
  */
 export declare function localWebUILink(): Plugin;

package/dist/vite.js

@@ -1,34 +1,34 @@
-import { n as e } from "./paths-B5Ht3ETc.js";
-import { readFileSync as t, readdirSync as n, realpathSync as r } from "node:fs";
-import { dirname as i, join as a, resolve as o, sep as s } from "node:path";
-import { fileURLToPath as c } from "node:url";
+import { n as e, s as t } from "./paths-CZtwNknt.js";
+import { existsSync as n, readFileSync as r, readdirSync as i, realpathSync as a, statSync as o, watch as s } from "node:fs";
+import { dirname as c, join as l, resolve as u, sep as d } from "node:path";
+import { fileURLToPath as f } from "node:url";
 //#region src/vite/brand-assets.ts
-var l = i(c(import.meta.resolve("@imfusion/web-ui/assets/favicon/favicon.svg"))), u = n(l).map((e) => ({
+var p = c(f(import.meta.resolve("@imfusion/web-ui/assets/favicon/favicon.svg"))), m = i(p).map((e) => ({
 	name: e,
-	source: t(a(l, e))
-})), d = {
+	source: r(l(p, e))
+})), h = {
 	".ico": "image/x-icon",
 	".png": "image/png",
 	".svg": "image/svg+xml"
 };
-function f(e) {
-	return d[e.slice(e.lastIndexOf("."))] ?? "application/octet-stream";
+function g(e) {
+	return h[e.slice(e.lastIndexOf("."))] ?? "application/octet-stream";
 }
-function p() {
+function _() {
 	return {
 		name: "imf-ui:brand-assets",
 		configureServer(e) {
 			e.middlewares.use((e, t, n) => {
-				let r = u.find(({ name: t }) => e.url?.split("?")[0] === `/${t}`);
+				let r = m.find(({ name: t }) => e.url?.split("?")[0] === `/${t}`);
 				if (!r) {
 					n();
 					return;
 				}
-				t.setHeader("Content-Type", f(r.name)), t.end(r.source);
+				t.setHeader("Content-Type", g(r.name)), t.end(r.source);
 			});
 		},
 		generateBundle() {
-			for (let e of u) this.emitFile({
+			for (let e of m) this.emitFile({
 				fileName: e.name,
 				source: e.source,
 				type: "asset"
@@ -38,33 +38,49 @@ function p() {
 }
 //#endregion
 //#region src/vite/local-web-ui-link.ts
-function m(e) {
-	if (r(e).split(s).includes("node_modules")) return;
-	let n = JSON.parse(t(o(e, "package.json"), "utf-8")), i = typeof n == "object" && n ? Reflect.get(n, "peerDependencies") : {};
+function v(e) {
+	if (t(e)) return { optimizeDeps: {
+		exclude: ["@imfusion/web-ui"],
+		include: ["use-sync-external-store/shim", "use-sync-external-store/shim/with-selector"]
+	} };
+	if (a(e).split(d).includes("node_modules")) return;
+	let n = JSON.parse(r(u(e, "package.json"), "utf-8")), i = typeof n == "object" && n ? Reflect.get(n, "peerDependencies") : {};
 	if (typeof i != "object" || !i) throw Error(`${e}/package.json has no peerDependencies`);
 	return { resolve: { dedupe: Object.keys(i) } };
 }
-function h() {
+function y() {
 	return {
 		name: "imf-ui:local-web-ui-link",
-		config: () => m(e)
+		config: () => v(e),
+		configureServer(r) {
+			if (!t(e)) return;
+			let i = u(e, "dist"), a = /* @__PURE__ */ new Set(), c, l = s(i, { recursive: !0 }, (e, t) => {
+				t && a.add(u(i, t)), clearTimeout(c), c = setTimeout(() => {
+					for (let e of a) n(e) && o(e).isFile() && r.watcher.emit("change", e);
+					a.clear();
+				}, 100);
+			});
+			r.httpServer?.once("close", () => {
+				clearTimeout(c), l.close();
+			});
+		}
 	};
 }
 //#endregion
 //#region src/vite/readable-css-module-names.ts
-function g(e, t) {
+function b(e, t) {
 	let { lightningcss: n, modules: r, transformer: i } = e.css ?? {}, a = n?.cssModules;
 	if (typeof a != "boolean" && r !== !1 && !a?.pattern && !(typeof r == "object" && r.generateScopedName)) return i === "postcss" ? { css: { modules: { generateScopedName: t } } } : { css: {
 		transformer: "lightningcss",
 		lightningcss: { cssModules: { pattern: t } }
 	} };
 }
-function _({ prefix: e }) {
+function x({ prefix: e }) {
 	let t = `${e}-[name]-[local]`;
 	return {
 		name: "imf-ui:readable-css-module-names",
-		config: (e) => g(e, t)
+		config: (e) => b(e, t)
 	};
 }
 //#endregion
-export { p as imfusionBrandAssets, h as localWebUILink, _ as readableCssModuleNames };
+export { _ as imfusionBrandAssets, y as localWebUILink, x as readableCssModuleNames };

package/dist/web-ui-cli.js

@@ -1,10 +1,10 @@
 #!/usr/bin/env node
-import { n as e, r as t, t as n } from "./paths-B5Ht3ETc.js";
-import { chmodSync as r, cpSync as i, existsSync as a, lstatSync as o, mkdirSync as s, readFileSync as c, readdirSync as l, readlinkSync as u, realpathSync as d, rmSync as f, symlinkSync as p, writeFileSync as m } from "node:fs";
-import { dirname as h, relative as g, resolve as _ } from "node:path";
-import { Command as ee, Option as te } from "commander";
-import * as v from "@clack/prompts";
-var y = {
+import { a as e, c as t, i as n, n as r, o as i, r as a, t as o } from "./paths-CZtwNknt.js";
+import { chmodSync as s, cpSync as c, existsSync as l, lstatSync as u, mkdirSync as d, readFileSync as f, readdirSync as p, readlinkSync as ee, realpathSync as m, rmSync as h, symlinkSync as te, writeFileSync as g } from "node:fs";
+import { dirname as ne, relative as _, resolve as v } from "node:path";
+import { Command as re, Option as ie } from "commander";
+import * as y from "@clack/prompts";
+var b = {
 	harnesses: {
 		claude: {
 			label: "Claude Code",
@@ -24,91 +24,91 @@ var y = {
 	skillsDir: ".agents/skills",
 	linkDir: ".claude/skills",
 	versionMarker: ".imf-web-ui-skill-version.json"
-}, ne = `<!-- ${y.namespace}:begin`, b = `<!-- ${y.namespace}:end -->`, re = _(e, y.templatesDir, "AGENTS.md"), x = _(t, "AGENTS.md");
-function S(e) {
-	let t = e.indexOf(ne), n = e.indexOf(b);
-	return t === -1 || n === -1 ? null : e.slice(t, n + b.length);
+}, ae = `<!-- ${b.namespace}:begin`, x = `<!-- ${b.namespace}:end -->`, oe = v(r, b.templatesDir, "AGENTS.md"), S = v(a, "AGENTS.md");
+function C(e) {
+	let t = e.indexOf(ae), n = e.indexOf(x);
+	return t === -1 || n === -1 ? null : e.slice(t, n + x.length);
 }
-function ie() {
-	if (!a(x)) return "absent";
-	let e = S(c(re, "utf-8"));
+function se() {
+	if (!l(S)) return "absent";
+	let e = C(f(oe, "utf-8"));
 	if (!e) return "absent";
-	let t = c(x, "utf-8"), n = S(t), r = n ? t.replace(n, e) : `${t.trimEnd()}\n\n${e}\n`;
-	return r === t ? "unchanged" : (m(x, r), n ? "updated" : "added");
+	let t = f(S, "utf-8"), n = C(t), r = n ? t.replace(n, e) : `${t.trimEnd()}\n\n${e}\n`;
+	return r === t ? "unchanged" : (g(S, r), n ? "updated" : "added");
 }
 //#endregion
 //#region src/cli/skills.ts
-var C = Object.keys(y.harnesses).filter((e) => e in y.harnesses), w = [...C, "all"];
+var w = Object.keys(b.harnesses).filter((e) => e in b.harnesses), ce = [...w, "all"];
 function T(e) {
-	return e === "all" ? C : [e];
+	return e === "all" ? w : [e];
 }
 function E(e) {
-	return `./${g(t, e)}`;
+	return `./${_(a, e)}`;
 }
-var D = y.namespace, O = y.versionMarker, k = _(e, y.skillsSource), A = _(t, y.skillsDir), j = _(t, y.linkDir), M = class extends Error {}, N = JSON.parse(c(_(e, "package.json"), "utf-8"));
-if (typeof N != "object" || !N || !("version" in N) || typeof N.version != "string") throw Error(`${_(e, "package.json")} has no string "version" field`);
+var D = b.namespace, O = b.versionMarker, k = v(r, b.skillsSource), A = v(a, b.skillsDir), j = v(a, b.linkDir), M = class extends Error {}, N = JSON.parse(f(v(r, "package.json"), "utf-8"));
+if (typeof N != "object" || !N || !("version" in N) || typeof N.version != "string") throw Error(`${v(r, "package.json")} has no string "version" field`);
 var P = N.version;
 function F(e) {
 	return e === D || e.startsWith(`${D}-`);
 }
 function I() {
-	return a(k) ? l(k, { withFileTypes: !0 }).filter((e) => e.isDirectory() && F(e.name)).map((e) => e.name).sort() : [];
+	return l(k) ? p(k, { withFileTypes: !0 }).filter((e) => e.isDirectory() && F(e.name)).map((e) => e.name).sort() : [];
 }
-function ae(e) {
-	let t = _(A, e, O);
-	if (!a(t)) return null;
+function le(e) {
+	let t = v(A, e, O);
+	if (!l(t)) return null;
 	try {
-		let e = JSON.parse(c(t, "utf-8"));
+		let e = JSON.parse(f(t, "utf-8"));
 		if (typeof e != "object" || !e) return null;
 		let n = "harnesses" in e && Array.isArray(e.harnesses) ? e.harnesses : null;
-		return n ? C.filter((e) => n.includes(e)) : null;
+		return n ? w.filter((e) => n.includes(e)) : null;
 	} catch {
 		return null;
 	}
 }
 function L(e) {
 	for (let t of e) {
-		let e = ae(t);
+		let e = le(t);
 		if (e && e.length > 0) return e;
 	}
 	return null;
 }
 function R(e, t, n) {
-	if (a(e)) for (let r of l(e).filter(F)) t.has(r) || (f(_(e, r), {
+	if (l(e)) for (let r of p(e).filter(F)) t.has(r) || (h(v(e, r), {
 		recursive: !0,
 		force: !0
-	}), v.log.info(`Removed skill: ${r} (${n})`));
+	}), y.log.info(`Removed skill: ${r} (${n})`));
 }
-function oe() {
-	return a(j) && a(A) && d(j) === d(A);
+function ue() {
+	return l(j) && l(A) && m(j) === m(A);
 }
-function z(e) {
-	let t = _(j, e), n = g(j, _(A, e)), r = o(t, { throwIfNoEntry: !1 });
-	r?.isSymbolicLink() && u(t) === n || (r && f(t, {
+function de(e) {
+	let t = v(j, e), n = _(j, v(A, e)), r = u(t, { throwIfNoEntry: !1 });
+	r?.isSymbolicLink() && ee(t) === n || (r && h(t, {
 		recursive: !0,
 		force: !0
-	}), s(j, { recursive: !0 }), p(n, t));
+	}), d(j, { recursive: !0 }), te(n, t));
 }
-function se(e, t) {
+function fe(e, t) {
 	try {
-		s(A, { recursive: !0 });
-		let r = [];
-		for (let n of e) {
-			let e = _(A, n);
-			f(e, {
+		d(A, { recursive: !0 });
+		let n = [];
+		for (let r of e) {
+			let e = v(A, r);
+			h(e, {
 				recursive: !0,
 				force: !0
-			}), i(_(k, n), e, { recursive: !0 });
-			let a = _(e, O);
-			m(a, JSON.stringify({
+			}), c(v(k, r), e, { recursive: !0 });
+			let i = v(e, O);
+			g(i, JSON.stringify({
 				version: P,
 				harnesses: t
-			}, null, 2) + "\n"), r.push(a);
+			}, null, 2) + "\n"), n.push(i);
 		}
-		if (n(r), R(A, new Set(e), "no longer in this bundle"), v.log.success(`Skills -> ${E(A)}/${D}*`), oe()) return;
+		if (o(n), R(A, new Set(e), "no longer in this bundle"), y.log.success(`Skills -> ${E(A)}/${D}*`), ue()) return;
 		if (t.includes("claude")) {
-			for (let t of e) z(t);
-			R(j, new Set(e), "no longer in this bundle"), v.log.success(`Claude Code -> ${E(j)}/${D}* (symlinks -> ${E(A)})`);
+			for (let t of e) de(t);
+			R(j, new Set(e), "no longer in this bundle"), y.log.success(`Claude Code -> ${E(j)}/${D}* (symlinks -> ${E(A)})`);
 		} else R(j, /* @__PURE__ */ new Set(), "claude not selected");
 	} catch (e) {
 		throw e instanceof Error ? new M(e.message) : e;
@@ -116,68 +116,68 @@ function se(e, t) {
 }
 //#endregion
 //#region src/cli/hooks.ts
-var B = _(e, y.templatesDir), V = _(B, "hooks"), H = _(t, y.hooksDir), U = class extends Error {};
-function ce(e, t) {
-	if (typeof e != "object" || !e || Array.isArray(e)) throw new U(`${t} is not a JSON object.`);
+var z = v(r, b.templatesDir), B = v(z, "hooks"), V = v(a, b.hooksDir), H = class extends Error {};
+function pe(e, t) {
+	if (typeof e != "object" || !e || Array.isArray(e)) throw new H(`${t} is not a JSON object.`);
 	let n = { ...e };
 	if ("hooks" in n) {
-		if (typeof n.hooks != "object" || n.hooks === null || Array.isArray(n.hooks)) throw new U(`${t}: "hooks" is not a JSON object.`);
-		for (let [e, r] of Object.entries(n.hooks)) if (!Array.isArray(r)) throw new U(`${t}: "hooks.${e}" is not a JSON array.`);
+		if (typeof n.hooks != "object" || n.hooks === null || Array.isArray(n.hooks)) throw new H(`${t}: "hooks" is not a JSON object.`);
+		for (let [e, r] of Object.entries(n.hooks)) if (!Array.isArray(r)) throw new H(`${t}: "hooks.${e}" is not a JSON array.`);
 	}
 	return n;
 }
-function W(e) {
+function U(e) {
 	let t;
 	try {
-		t = JSON.parse(c(e, "utf-8"));
+		t = JSON.parse(f(e, "utf-8"));
 	} catch {
-		throw new U(`${e} is not valid JSON.`);
+		throw new H(`${e} is not valid JSON.`);
 	}
-	return ce(t, e);
+	return pe(t, e);
 }
-function le() {
-	let e = l(V).filter((e) => e.endsWith(".sh"));
-	s(H, { recursive: !0 });
+function me() {
+	let e = p(B).filter((e) => e.endsWith(".sh"));
+	d(V, { recursive: !0 });
 	for (let t of e) {
-		let e = _(H, t);
-		i(_(V, t), e, { force: !0 }), r(e, 493);
+		let e = v(V, t);
+		c(v(B, t), e, { force: !0 }), s(e, 493);
 	}
-	let t = l(H).filter((t) => t.endsWith(".sh") && !e.includes(t));
-	for (let e of t) f(_(H, e), { force: !0 });
+	let t = p(V).filter((t) => t.endsWith(".sh") && !e.includes(t));
+	for (let e of t) h(v(V, e), { force: !0 });
 	return {
 		installed: e,
 		removed: t
 	};
 }
-var G = `${y.hooksDir}/`;
-function K(e) {
+var W = `${b.hooksDir}/`;
+function G(e) {
 	if (typeof e != "string") return null;
-	let t = e.lastIndexOf(G);
+	let t = e.lastIndexOf(W);
 	if (t === -1) return null;
-	let n = /^([\w.-]+)["']?$/.exec(e.slice(t + G.length));
+	let n = /^([\w.-]+)["']?$/.exec(e.slice(t + W.length));
 	return n ? n[1] : null;
 }
-function q(e) {
+function K(e) {
 	return typeof e == "object" && !!e && "hooks" in e && Array.isArray(e.hooks);
 }
-function J(e) {
-	return q(e) ? e.hooks : null;
+function q(e) {
+	return K(e) ? e.hooks : null;
 }
-function Y(e) {
+function J(e) {
 	return typeof e == "object" && e && "command" in e ? e.command : void 0;
 }
-function X(e) {
-	let t = J(e);
-	return t ? t.map((e) => K(Y(e))).filter((e) => e !== null) : [];
+function Y(e) {
+	let t = q(e);
+	return t ? t.map((e) => G(J(e))).filter((e) => e !== null) : [];
 }
-function ue(e, t, n) {
+function he(e, t, n) {
 	e.hooks ??= {};
 	let r = 0, i = 0, a = [];
 	for (let [r, o] of Object.entries(e.hooks)) {
 		let s = 0, c = o.map((e) => {
-			if (!q(e)) return e;
+			if (!K(e)) return e;
 			let t = e.hooks, r = t.filter((e) => {
-				let t = K(Y(e));
+				let t = G(J(e));
 				return t === null || n.includes(t);
 			});
 			return s += t.length - r.length, r.length === t.length ? e : {
@@ -185,7 +185,7 @@ function ue(e, t, n) {
 				hooks: r
 			};
 		}).filter((e) => {
-			let t = J(e);
+			let t = q(e);
 			return t === null || t.length > 0;
 		});
 		s !== 0 && (i += s, c.length === 0 && !(r in t) ? a.push(r) : e.hooks[r] = c);
@@ -194,8 +194,8 @@ function ue(e, t, n) {
 	for (let [n, i] of Object.entries(t)) {
 		e.hooks[n] ??= [];
 		for (let t of i) {
-			let i = X(t);
-			e.hooks[n].some((e) => X(e).some((e) => i.includes(e))) || (e.hooks[n].push(t), r++);
+			let i = Y(t);
+			e.hooks[n].some((e) => Y(e).some((e) => i.includes(e))) || (e.hooks[n].push(t), r++);
 		}
 	}
 	return {
@@ -203,72 +203,72 @@ function ue(e, t, n) {
 		removed: i
 	};
 }
-function de(e) {
-	let r = /* @__PURE__ */ new Map(), i = /* @__PURE__ */ new Map();
-	for (let n of C) {
-		let o = _(t, y.harnesses[n].hookSettings);
-		if (a(o) && r.set(n, W(o)), e.includes(n)) {
-			let e = _(B, y.harnesses[n].hookTemplate);
-			i.set(n, W(e).hooks ?? {});
+function ge(e) {
+	let t = /* @__PURE__ */ new Map(), n = /* @__PURE__ */ new Map();
+	for (let r of w) {
+		let i = v(a, b.harnesses[r].hookSettings);
+		if (l(i) && t.set(r, U(i)), e.includes(r)) {
+			let e = v(z, b.harnesses[r].hookTemplate);
+			n.set(r, U(e).hooks ?? {});
 		}
 	}
-	let { installed: o, removed: c } = le();
-	v.log.success(`Agent hooks -> ${E(H)} (${String(o.length)} scripts)`), c.length > 0 && v.log.info(`Removed stale hook script(s): ${c.join(", ")} (no longer shipped)`);
-	for (let a of C) {
-		let c = e.includes(a);
-		if (!c && !r.has(a)) continue;
-		let l = _(t, y.harnesses[a].hookSettings), u = i.get(a) ?? {}, d = r.get(a) ?? {}, f = ue(d, u, c ? o : []);
+	let { installed: r, removed: i } = me();
+	y.log.success(`Agent hooks -> ${E(V)} (${String(r.length)} scripts)`), i.length > 0 && y.log.info(`Removed stale hook script(s): ${i.join(", ")} (no longer shipped)`);
+	for (let i of w) {
+		let s = e.includes(i);
+		if (!s && !t.has(i)) continue;
+		let c = v(a, b.harnesses[i].hookSettings), l = n.get(i) ?? {}, u = t.get(i) ?? {}, f = he(u, l, s ? r : []);
 		if (f.added === 0 && f.removed === 0) {
-			c && v.log.info(`Hook registrations already present in ${E(l)}`);
+			s && y.log.info(`Hook registrations already present in ${E(c)}`);
 			continue;
 		}
-		s(h(l), { recursive: !0 }), m(l, JSON.stringify(d, null, 2) + "\n"), n([l]);
+		d(ne(c), { recursive: !0 }), g(c, JSON.stringify(u, null, 2) + "\n"), o([c]);
 		let p = [f.added > 0 && `registered ${String(f.added)}`, f.removed > 0 && `removed ${String(f.removed)} stale`].filter(Boolean);
-		v.log.success(`${p.join(", ")} hook registration(s) in ${E(l)}`);
+		y.log.success(`${p.join(", ")} hook registration(s) in ${E(c)}`);
 	}
 }
 //#endregion
 //#region src/cli/index.ts
-function Z() {
-	return new te("--harness <harness>", "claude, codex, or all").choices(w);
+function X() {
+	return new ie("--harness <harness>", "claude, codex, or all").choices(ce);
 }
-async function fe(e, t, n) {
-	if (t) return v.log.info(`Harness from --harness flag: ${t.join(", ")}`), t;
+async function Z(e, t, n) {
+	if (t) return y.log.info(`Harness from --harness flag: ${t.join(", ")}`), t;
 	let r = L(e);
-	if (r && !n) return v.log.info(`Refreshing the existing install: ${r.join(", ")} — pass --reconfigure to choose differently.`), r;
+	if (r && !n) return y.log.info(`Refreshing the existing install: ${r.join(", ")} — pass --reconfigure to choose differently.`), r;
 	if (!process.stdin.isTTY) return console.error("Pass --harness=claude|codex|all — no terminal to prompt in."), process.exitCode = 1, null;
-	let i = await v.multiselect({
+	let i = await y.multiselect({
 		message: "Install into which harness (or harnesses)?",
-		options: C.map((e) => ({
+		options: w.map((e) => ({
 			value: e,
-			label: y.harnesses[e].label
+			label: b.harnesses[e].label
 		})),
 		required: !0
 	});
-	return v.isCancel(i) ? (v.cancel("Cancelled — nothing installed."), null) : i;
+	return y.isCancel(i) ? (y.cancel("Cancelled — nothing installed."), null) : i;
 }
-async function pe(e) {
+async function _e(e) {
 	let t = e.harness ? T(e.harness) : null, n = I();
-	if (v.intro(`@imfusion/web-ui install skills — ${String(n.length)} skills`), n.length === 0) {
-		v.log.error("No skills found. Reinstall @imfusion/web-ui and try again."), v.outro("Nothing installed."), process.exitCode = 1;
+	if (y.intro(`@imfusion/web-ui install skills — ${String(n.length)} skills`), n.length === 0) {
+		y.log.error("No skills found. Reinstall @imfusion/web-ui and try again."), y.outro("Nothing installed."), process.exitCode = 1;
 		return;
 	}
-	let r = await fe(n, t, e.reconfigure === !0);
+	let r = await Z(n, t, e.reconfigure === !0);
 	if (!r) return;
-	v.log.message(`Skills in this bundle:\n${n.map((e) => `  - ${e}`).join("\n")}`);
+	y.log.message(`Skills in this bundle:\n${n.map((e) => `  - ${e}`).join("\n")}`);
 	try {
-		se(n, r);
+		fe(n, r);
 	} catch (e) {
 		if (e instanceof M) {
-			v.log.error(e.message), v.outro("Install failed."), process.exitCode = 1;
+			y.log.error(e.message), y.outro("Install failed."), process.exitCode = 1;
 			return;
 		}
 		throw e;
 	}
-	let i = ie();
-	(i === "updated" || i === "added") && v.log.success(`Refreshed the ${y.namespace} block in ./AGENTS.md`), v.outro(`Done — ${String(n.length)} skills installed.`);
+	let i = se();
+	(i === "updated" || i === "added") && y.log.success(`Refreshed the ${b.namespace} block in ./AGENTS.md`), y.outro(`Done — ${String(n.length)} skills installed.`);
 }
-function me(e) {
+function ve(e) {
 	let t = e.harness ? T(e.harness) : null, n = L(I());
 	if (!t && !n) {
 		console.error("No harness recorded. Pass --harness=claude|codex|all."), process.exitCode = 1;
@@ -280,22 +280,54 @@ function me(e) {
 		process.exitCode = 1;
 		return;
 	}
-	v.intro("@imfusion/web-ui install hooks");
+	y.intro("@imfusion/web-ui install hooks");
+	try {
+		ge(r);
+	} catch (e) {
+		if (e instanceof H) {
+			console.error(e.message), process.exitCode = 1;
+			return;
+		}
+		throw e;
+	}
+	y.outro("Done — agent hooks installed.");
+}
+function ye(r) {
+	let i = r ?? process.env.WEB_UI_CHECKOUT;
+	if (!i) {
+		console.error("Pass the checkout path, or set WEB_UI_CHECKOUT."), process.exitCode = 1;
+		return;
+	}
+	let o = v(i);
+	try {
+		let t = e(a, o);
+		y.log.success(`Linked ${o} into ${E(t)}`);
+	} catch (e) {
+		if (e instanceof n) {
+			console.error(e.message), process.exitCode = 1;
+			return;
+		}
+		throw e;
+	}
+	y.log.info("Syncing on every rebuild of dist/. Ctrl+C stops syncing; the app keeps the last synced build."), t(a, o, (e) => {
+		y.log.info(e);
+	});
+}
+function be() {
 	try {
-		de(r);
+		for (let e of i(a)) y.log.message(e);
 	} catch (e) {
-		if (e instanceof U) {
+		if (e instanceof n) {
 			console.error(e.message), process.exitCode = 1;
 			return;
 		}
 		throw e;
 	}
-	v.outro("Done — agent hooks installed.");
 }
-var Q = new ee();
+var Q = new re();
 Q.name("web-ui").description("Command-line tools for @imfusion/web-ui").version(P);
 var $ = Q.command("install").description("Install @imfusion/web-ui agent skills or hooks into a project");
-$.command("skills").description("Install skills for the chosen harness").addOption(Z()).option("--reconfigure", "Re-open the harness selection prompt on an existing install").action(pe), $.command("hooks").description("Install agent lifecycle hooks (requires skills already installed for the harness)").addOption(Z()).action(me), $.action(() => {
+$.command("skills").description("Install skills for the chosen harness").addOption(X()).option("--reconfigure", "Re-open the harness selection prompt on an existing install").action(_e), $.command("hooks").description("Install agent lifecycle hooks (requires skills already installed for the harness)").addOption(X()).action(ve), Q.command("link").description("Serve a local @imfusion/web-ui checkout from this project and sync it on every rebuild").argument("[path]", "checkout directory (default: WEB_UI_CHECKOUT)").action(ye), Q.command("unlink").description("Restore the published @imfusion/web-ui files in this project").action(be), $.action(() => {
 	$.help();
 }), Q.action(() => {
 	Q.help();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@imfusion/web-ui",
-  "version": "0.10.1-dev.34.gb01a818e",
+  "version": "0.10.1-dev.41.g467e0e1a",
   "description": "The official Web UI component library for ImFusion web apps",
   "author": "ImFusion GmbH",
   "homepage": "https://imfusion.com",
@@ -11,7 +11,7 @@
   },
   "type": "module",
   "engines": {
-    "node": ">=24"
+    "node": "^22.22.1 || ^24.11 || >=26"
   },
   "imports": {
     "#/*": "./src/*",