@imfusion/web-ui 0.7.1-dev.1.g3b4d502e → 0.7.2-dev.10.gaae39295

package/dist/tokens/control-registry.d.ts

@@ -1,7 +1,12 @@
 import { TokenControl } from './token-registry';
+import { TokenOverrides } from './types';
 /**
  * Every {@link TokenControl}: a token with a live adjuster, spreading its data from
  * `TOKEN_REGISTRY`. Semantic font aliases (`font-family-heading`/`-body`/`-ui`/`-code`) are
  * `var()` indirections with no direct control, so they have no entry here.
  */
 export declare const TOKEN_CONTROLS: readonly TokenControl[];
+/** Storybook drops URL globals whose value holds quotes or commas, so select overrides travel as option ids. */
+export declare function encodeOverrides(overrides: TokenOverrides): TokenOverrides;
+/** Inverse of {@link encodeOverrides}; drops select overrides whose id matches no option. */
+export declare function decodeOverrides(overrides: TokenOverrides): TokenOverrides;

package/dist/tokens/types.d.ts

@@ -46,6 +46,7 @@ export type TokenControl = Token & ({
 } | {
     kind: "select";
     options: readonly {
+        id: string;
         label: string;
         value: string;
     }[];

package/dist/web-ui-cli.js

@@ -28,7 +28,7 @@ var _ = {
 };
 //#endregion
 //#region src/cli/paths.ts
-function re(e) {
+function v(e) {
 	let t = e;
 	for (; !n(m(t, "package.json"));) {
 		let n = f(t);
@@ -37,97 +37,112 @@ function re(e) {
 	}
 	return t;
 }
-var v = re(f(ee(import.meta.url))), y = process.cwd(), ie = `<!-- ${_.namespace}:begin`, b = `<!-- ${_.namespace}:end -->`, ae = m(v, _.templatesDir, "AGENTS.md"), x = m(y, "AGENTS.md");
-function S(e) {
-	let t = e.indexOf(ie), n = e.indexOf(b);
-	return t === -1 || n === -1 ? null : e.slice(t, n + b.length);
+var y = v(f(ee(import.meta.url))), b = process.cwd();
+function x(e) {
+	let t = b;
+	for (; t !== f(t) && !n(m(t, "node_modules", ".bin"));) t = f(t);
+	let r = m(t, "node_modules", ".bin", "prettier");
+	n(r) && g(r, ["--write", ...e], {
+		cwd: b,
+		stdio: "ignore"
+	});
 }
-function oe() {
-	if (!n(x)) return "absent";
-	let e = S(a(ae, "utf-8"));
+//#endregion
+//#region src/cli/agents-md.ts
+var re = `<!-- ${_.namespace}:begin`, S = `<!-- ${_.namespace}:end -->`, ie = m(y, _.templatesDir, "AGENTS.md"), C = m(b, "AGENTS.md");
+function w(e) {
+	let t = e.indexOf(re), n = e.indexOf(S);
+	return t === -1 || n === -1 ? null : e.slice(t, n + S.length);
+}
+function ae() {
+	if (!n(C)) return "absent";
+	let e = w(a(ie, "utf-8"));
 	if (!e) return "absent";
-	let t = a(x, "utf-8"), r = S(t), i = r ? t.replace(r, e) : `${t.trimEnd()}\n\n${e}\n`;
-	return i === t ? "unchanged" : (d(x, i), r ? "updated" : "added");
+	let t = a(C, "utf-8"), r = w(t), i = r ? t.replace(r, e) : `${t.trimEnd()}\n\n${e}\n`;
+	return i === t ? "unchanged" : (d(C, i), r ? "updated" : "added");
 }
 //#endregion
 //#region src/cli/skills.ts
-var C = Object.keys(_.harnesses).filter((e) => e in _.harnesses), se = [...C, "all"];
-function w(e) {
-	return e === "all" ? C : [e];
+var T = Object.keys(_.harnesses).filter((e) => e in _.harnesses), oe = [...T, "all"];
+function E(e) {
+	return e === "all" ? T : [e];
 }
-function T(e) {
-	return `./${p(y, e)}`;
+function D(e) {
+	return `./${p(b, e)}`;
 }
-var E = _.namespace, D = _.versionMarker, O = m(v, _.skillsSource), k = m(y, _.skillsDir), A = m(y, _.linkDir), j = class extends Error {}, M = JSON.parse(a(m(v, "package.json"), "utf-8"));
-if (typeof M != "object" || !M || !("version" in M) || typeof M.version != "string") throw Error(`${m(v, "package.json")} has no string "version" field`);
-var N = M.version;
-function P(e) {
-	return e === E || e.startsWith(`${E}-`);
+var O = _.namespace, k = _.versionMarker, A = m(y, _.skillsSource), j = m(b, _.skillsDir), M = m(b, _.linkDir), N = class extends Error {}, P = JSON.parse(a(m(y, "package.json"), "utf-8"));
+if (typeof P != "object" || !P || !("version" in P) || typeof P.version != "string") throw Error(`${m(y, "package.json")} has no string "version" field`);
+var F = P.version;
+function I(e) {
+	return e === O || e.startsWith(`${O}-`);
 }
-function F() {
-	return n(O) ? o(O, { withFileTypes: !0 }).filter((e) => e.isDirectory() && P(e.name)).map((e) => e.name).sort() : [];
+function L() {
+	return n(A) ? o(A, { withFileTypes: !0 }).filter((e) => e.isDirectory() && I(e.name)).map((e) => e.name).sort() : [];
 }
-function I(e) {
-	let t = m(k, e, D);
+function se(e) {
+	let t = m(j, e, k);
 	if (!n(t)) return null;
 	try {
 		let e = JSON.parse(a(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 ? T.filter((e) => n.includes(e)) : null;
 	} catch {
 		return null;
 	}
 }
-function L(e) {
+function R(e) {
 	for (let t of e) {
-		let e = I(t);
+		let e = se(t);
 		if (e && e.length > 0) return e;
 	}
 	return null;
 }
-function R(e, t, r) {
-	if (n(e)) for (let n of o(e).filter(P)) t.has(n) || (l(m(e, n), {
+function z(e, t, r) {
+	if (n(e)) for (let n of o(e).filter(I)) t.has(n) || (l(m(e, n), {
 		recursive: !0,
 		force: !0
 	}), h.log.info(`Removed skill: ${n} (${r})`));
 }
 function ce() {
-	return n(A) && n(k) && c(A) === c(k);
+	return n(M) && n(j) && c(M) === c(j);
 }
 function le(e) {
-	let t = m(A, e), n = p(A, m(k, e)), a = r(t, { throwIfNoEntry: !1 });
+	let t = m(M, e), n = p(M, m(j, e)), a = r(t, { throwIfNoEntry: !1 });
 	a?.isSymbolicLink() && s(t) === n || (a && l(t, {
 		recursive: !0,
 		force: !0
-	}), i(A, { recursive: !0 }), u(n, t));
+	}), i(M, { recursive: !0 }), u(n, t));
 }
-function z(e, n) {
+function ue(e, n) {
 	try {
-		i(k, { recursive: !0 });
-		for (let r of e) {
-			let e = m(k, r);
+		i(j, { recursive: !0 });
+		let r = [];
+		for (let i of e) {
+			let e = m(j, i);
 			l(e, {
 				recursive: !0,
 				force: !0
-			}), t(m(O, r), e, { recursive: !0 }), d(m(e, D), JSON.stringify({
-				version: N,
+			}), t(m(A, i), e, { recursive: !0 });
+			let a = m(e, k);
+			d(a, JSON.stringify({
+				version: F,
 				harnesses: n
-			}, null, 2) + "\n");
+			}, null, 2) + "\n"), r.push(a);
 		}
-		if (R(k, new Set(e), "no longer in this bundle"), h.log.success(`Skills -> ${T(k)}/${E}*`), ce()) return;
+		if (x(r), z(j, new Set(e), "no longer in this bundle"), h.log.success(`Skills -> ${D(j)}/${O}*`), ce()) return;
 		if (n.includes("claude")) {
 			for (let t of e) le(t);
-			R(A, new Set(e), "no longer in this bundle"), h.log.success(`Claude Code -> ${T(A)}/${E}* (symlinks -> ${T(k)})`);
-		} else R(A, /* @__PURE__ */ new Set(), "claude not selected");
+			z(M, new Set(e), "no longer in this bundle"), h.log.success(`Claude Code -> ${D(M)}/${O}* (symlinks -> ${D(j)})`);
+		} else z(M, /* @__PURE__ */ new Set(), "claude not selected");
 	} catch (e) {
-		throw e instanceof Error ? new j(e.message) : e;
+		throw e instanceof Error ? new N(e.message) : e;
 	}
 }
 //#endregion
 //#region src/cli/hooks.ts
-var B = m(v, _.templatesDir), V = m(B, "hooks"), H = m(y, _.hooksDir), U = class extends Error {};
-function ue(e, t) {
+var B = m(y, _.templatesDir), V = m(B, "hooks"), H = m(b, _.hooksDir), U = class extends Error {};
+function de(e, t) {
 	if (typeof e != "object" || !e || Array.isArray(e)) throw new U(`${t} is not a JSON object.`);
 	let n = { ...e };
 	if ("hooks" in n) {
@@ -143,16 +158,7 @@ function W(e) {
 	} catch {
 		throw new U(`${e} is not valid JSON.`);
 	}
-	return ue(t, e);
-}
-function de(e) {
-	let t = y;
-	for (; t !== f(t) && !n(m(t, "node_modules", ".bin"));) t = f(t);
-	let r = m(t, "node_modules", ".bin", "prettier");
-	n(r) && g(r, ["--write", e], {
-		cwd: y,
-		stdio: "ignore"
-	});
+	return de(t, e);
 }
 function fe() {
 	let n = o(V).filter((e) => e.endsWith(".sh"));
@@ -224,41 +230,41 @@ function pe(e, t, n) {
 }
 function me(e) {
 	let t = /* @__PURE__ */ new Map(), r = /* @__PURE__ */ new Map();
-	for (let i of C) {
-		let a = m(y, _.harnesses[i].hookSettings);
+	for (let i of T) {
+		let a = m(b, _.harnesses[i].hookSettings);
 		if (n(a) && t.set(i, W(a)), e.includes(i)) {
 			let e = m(B, _.harnesses[i].hookTemplate);
 			r.set(i, W(e).hooks ?? {});
 		}
 	}
 	let { installed: a, removed: o } = fe();
-	h.log.success(`Agent hooks -> ${T(H)} (${String(a.length)} scripts)`), o.length > 0 && h.log.info(`Removed stale hook script(s): ${o.join(", ")} (no longer shipped)`);
-	for (let n of C) {
+	h.log.success(`Agent hooks -> ${D(H)} (${String(a.length)} scripts)`), o.length > 0 && h.log.info(`Removed stale hook script(s): ${o.join(", ")} (no longer shipped)`);
+	for (let n of T) {
 		let o = e.includes(n);
 		if (!o && !t.has(n)) continue;
-		let s = m(y, _.harnesses[n].hookSettings), c = r.get(n) ?? {}, l = t.get(n) ?? {}, u = pe(l, c, o ? a : []);
+		let s = m(b, _.harnesses[n].hookSettings), c = r.get(n) ?? {}, l = t.get(n) ?? {}, u = pe(l, c, o ? a : []);
 		if (u.added === 0 && u.removed === 0) {
-			o && h.log.info(`Hook registrations already present in ${T(s)}`);
+			o && h.log.info(`Hook registrations already present in ${D(s)}`);
 			continue;
 		}
-		i(f(s), { recursive: !0 }), d(s, JSON.stringify(l, null, 2) + "\n"), de(s);
+		i(f(s), { recursive: !0 }), d(s, JSON.stringify(l, null, 2) + "\n"), x([s]);
 		let p = [u.added > 0 && `registered ${String(u.added)}`, u.removed > 0 && `removed ${String(u.removed)} stale`].filter(Boolean);
-		h.log.success(`${p.join(", ")} hook registration(s) in ${T(s)}`);
+		h.log.success(`${p.join(", ")} hook registration(s) in ${D(s)}`);
 	}
 }
 //#endregion
 //#region src/cli/index.ts
 function Z() {
-	return new ne("--harness <harness>", "claude, codex, or all").choices(se);
+	return new ne("--harness <harness>", "claude, codex, or all").choices(oe);
 }
 async function he(e, t, n) {
 	if (t) return h.log.info(`Harness from --harness flag: ${t.join(", ")}`), t;
-	let r = L(e);
+	let r = R(e);
 	if (r && !n) return h.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 h.multiselect({
 		message: "Install into which harness (or harnesses)?",
-		options: C.map((e) => ({
+		options: T.map((e) => ({
 			value: e,
 			label: _.harnesses[e].label
 		})),
@@ -267,7 +273,7 @@ async function he(e, t, n) {
 	return h.isCancel(i) ? (h.cancel("Cancelled — nothing installed."), null) : i;
 }
 async function ge(e) {
-	let t = e.harness ? w(e.harness) : null, n = F();
+	let t = e.harness ? E(e.harness) : null, n = L();
 	if (h.intro(`@imfusion/web-ui install skills — ${String(n.length)} skills`), n.length === 0) {
 		h.log.error("No skills found. Reinstall @imfusion/web-ui and try again."), h.outro("Nothing installed."), process.exitCode = 1;
 		return;
@@ -276,19 +282,19 @@ async function ge(e) {
 	if (!r) return;
 	h.log.message(`Skills in this bundle:\n${n.map((e) => `  - ${e}`).join("\n")}`);
 	try {
-		z(n, r);
+		ue(n, r);
 	} catch (e) {
-		if (e instanceof j) {
+		if (e instanceof N) {
 			h.log.error(e.message), h.outro("Install failed."), process.exitCode = 1;
 			return;
 		}
 		throw e;
 	}
-	let i = oe();
+	let i = ae();
 	(i === "updated" || i === "added") && h.log.success(`Refreshed the ${_.namespace} block in ./AGENTS.md`), h.outro(`Done — ${String(n.length)} skills installed.`);
 }
 function _e(e) {
-	let t = e.harness ? w(e.harness) : null, n = L(F());
+	let t = e.harness ? E(e.harness) : null, n = R(L());
 	if (!t && !n) {
 		console.error("No harness recorded. Pass --harness=claude|codex|all."), process.exitCode = 1;
 		return;
@@ -312,7 +318,7 @@ function _e(e) {
 	h.outro("Done — agent hooks installed.");
 }
 var Q = new te();
-Q.name("web-ui").description("Command-line tools for @imfusion/web-ui").version(N);
+Q.name("web-ui").description("Command-line tools for @imfusion/web-ui").version(F);
 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(ge), $.command("hooks").description("Install agent lifecycle hooks (requires skills already installed for the harness)").addOption(Z()).action(_e), $.action(() => {
 	$.help();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@imfusion/web-ui",
-  "version": "0.7.1-dev.1.g3b4d502e",
+  "version": "0.7.2-dev.10.gaae39295",
   "description": "The official Web UI component library for ImFusion web apps",
   "author": "ImFusion GmbH",
   "homepage": "https://imfusion.com",

package/src/docgen/doc.gen.json

@@ -2461,7 +2461,7 @@
       },
       {
         "name": "NavigationMenu.Link",
-        "description": "NavigationMenu.Link — a top-strip (rail) link: a peer of `Trigger` for a\nsection that navigates directly instead of opening a flyout. Renders an `<a>`.\nFor a link inside a flyout, use `NavigationMenu.FlyoutLink`.\n\nA trailing `ArrowRight` slides in on hover/focus. When a custom `render` is\nsupplied the icon is omitted — the consumer's element owns its content.",
+        "description": "NavigationMenu.Link — a top-strip (rail) link: a peer of `Trigger` for a\nsection that navigates directly instead of opening a flyout. Renders an `<a>`.\nFor a link inside a flyout, use `NavigationMenu.FlyoutLink`.",
         "props": [
           {
             "name": "active",

package/src/llms/skills/imf-web-ui-update/SKILL.md

@@ -99,6 +99,11 @@ section after the pre-update version, up to and including the new one. Each sect
 `Breaking` entries are the release's own account of what changed. Then compare the old and new package metadata, current
 generated docs, types, and examples, and run the full verification again.
 
+A prerelease baseline (`<version>-dev.*`) already ships part of the next release, so its changelog sections overstate the
+delta. Measure the delta directly: `npm pack @imfusion/web-ui@<pre-update-version>` into a scratch directory, then diff its
+`dist/**/*.d.ts` and `dist/style.css` (one rule per line) against the installed package. A changelog entry with no matching
+diff was already in the baseline; report it as present.
+
 This phase reads and reports: every file stays as it is until the person approves the migration. Open the report with the
 releases read, then report separately: