@imfusion/web-ui 0.6.4-dev.55.g47fb2f84 → 0.6.4-dev.58.g88c8fcaa

package/dist/tokens/apply.d.ts

@@ -5,12 +5,8 @@ import { TokenOverrides } from './types';
  * Pure token-application layer — no React, no router, no DOM ownership beyond the one imperative
  * writer ({@link applyTokenOverrides}). The stateful, persistence-agnostic hook is `useTokenControls`.
  */
-/** Flatten a possibly scheme-keyed numeric value to the active scheme. */
 export declare function resolveScheme(field: number | Record<ColorScheme, number>, scheme: ColorScheme): number;
-/**
- * A control resolved to the active scheme — the panel-facing view. Slider controls carry numeric
- * bounds; select controls carry options.
- */
+/** A control resolved to the active scheme — the panel-facing view of a token control. */
 export type ResolvedControl = {
     id: TokenId;
     cssVar: string;
@@ -47,9 +43,8 @@ export declare function resolve(control: TokenControl, scheme: ColorScheme): Res
  */
 export declare function deriveAll(live: TokenOverrides): TokenOverrides;
 /**
- * Imperative core — reconcile `documentElement`'s inline custom properties to `overrides`. Sets
- * present vars, removes every registry var absent from `overrides` (both `-light`/`-dark`), so reset
- * and scheme switches leave nothing stale. This is the one DOM writer; `useTokenControls` calls it in
- * a layout effect, and hosts (Storybook, consumers) can call it directly.
+ * Reconciles `documentElement`'s inline custom properties to `overrides`: sets present vars, removes
+ * every registry var absent from `overrides` (both `-light`/`-dark`), so reset and scheme switches
+ * leave nothing stale. This is the one DOM writer.
  */
 export declare function applyTokenOverrides(overrides: TokenOverrides, root?: HTMLElement): void;

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

@@ -1,10 +1,7 @@
 import { TokenControl } from './token-registry';
 /**
- * The control registry — every {@link TokenControl}, i.e. every token that has a live adjuster. Each
- * entry spreads its token's data (including `label`/`description`) from `TOKEN_REGISTRY` and adds
- * only the control-specific metadata its UI needs.
- *
- * Not every token appears here: the semantic font aliases (`font-family-heading` / `-body` / `-ui`
- * / `-code`) are `var()` indirections with no direct control, so they have no entry.
+ * 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[];

package/dist/tokens/types.d.ts

@@ -1,13 +1,5 @@
 import { ColorScheme } from '../types/theme';
-/**
- * A **token** is a CSS custom property under `--imf-ui-` carrying a design value; every token lives
- * in `TOKEN_REGISTRY`. A **TokenControl** is a live adjuster *bound to* a token, not a kind of token —
- * it carries the token's own fields plus the control's `id`. Not every token has a control.
- *
- * The shapes below are generic over the id type to avoid an import cycle with the registry that
- * defines the concrete `TokenId` union. Import `Token` / `TokenControl` from `./token-registry` (bound
- * to the concrete id), not from here directly.
- */
+/** Import `Token` / `TokenControl` from `./token-registry`, not from here directly. */
 /** A continuous or per-scheme numeric value (slider tokens) or a fixed string (select tokens). */
 export type TokenValue = number | string | Record<ColorScheme, number>;
 /** A numeric value that may be resolved per color scheme (min / max / default on slider controls). */
@@ -15,14 +7,9 @@ export type NumericTokenValue = number | Record<ColorScheme, number>;
 /** Grouping for panel layout. */
 export type TokenGroup = "brand" | "surface" | "primary" | "status" | "accent" | "shadow" | "shape" | "font";
 /**
- * The canonical token id vocabulary — **hand-authored** (not derived from the registry). This is the
- * source of truth for what a `--imf-ui-*` token may be called, so:
- * - the registry definition site gets autocomplete and rejects typos (`TOKEN_REGISTRY` is a
- *   `Record<TokenId, Token>`, so every key and every `id` is checked against it);
- * - every `id` / `derivedFrom` on a control is checked against it.
- *
- * Adding or renaming a token is a deliberate two-step edit: this union **and** `TOKEN_REGISTRY`. The
- * `token-registry.test.ts` "union ↔ registry agree" test fails loudly if the two drift.
+ * Hand-authored, not derived from the registry. This is the source of truth for valid `--imf-ui-*` token ids.
+ * Adding or renaming a token requires updating this union and `TOKEN_REGISTRY` together;
+ * `token-registry.test.ts` fails if the two drift.
  */
 export type TokenId = "color-brand-luma" | "color-brand-chroma" | "color-brand-hue" | "color-surface-bg-luma" | "color-surface-fg-luma" | "color-surface-chroma" | "color-surface-main-hue" | "color-surface-support-hue" | "color-surface-minor-hue" | "color-primary-bg-luma" | "color-primary-fg-luma" | "color-primary-chroma" | "color-primary-hue" | "color-status-bg-luma" | "color-status-fg-luma" | "color-status-chroma" | "color-status-positive-hue" | "color-status-negative-hue" | "color-status-warning-hue" | "color-status-info-hue" | "color-accent-1-bg-luma" | "color-accent-1-fg-luma" | "color-accent-1-chroma" | "color-accent-1-hue" | "color-accent-2-bg-luma" | "color-accent-2-fg-luma" | "color-accent-2-chroma" | "color-accent-2-hue" | "color-accent-3-bg-luma" | "color-accent-3-fg-luma" | "color-accent-3-chroma" | "color-accent-3-hue" | "shadow-angle" | "shadow-hardness" | "shadow-spread" | "shadow-intensity" | "corner-radius" | "font-family-sans" | "font-family-mono" | "font-family-heading" | "font-family-body" | "font-family-ui" | "font-family-code";
 /**
@@ -43,13 +30,9 @@ export interface Token {
     description: string;
 }
 /**
- * A live adjuster bound to a token — the token's own fields plus kind-specific control metadata.
- * Discriminated on `kind`:
- * - `slider` — a continuous numeric control (min/max/step); may derive from another token.
- * - `select` — a discrete choice from an enumerated option list (e.g. font stacks).
- *
- * The finer constraint — slider ↔ numeric token, select ↔ string token — is a runtime/test guard, not
- * encoded here (encoding it would add cryptic type machinery for little gain).
+ * A live adjuster bound to a token, carrying the token's own fields plus kind-specific control metadata.
+ * The finer constraint (slider ↔ numeric token, select ↔ string token) is enforced by a
+ * runtime/test guard, not encoded in the type; that would add cryptic generics for little gain.
  */
 export type TokenControl = Token & ({
     kind: "slider";

package/dist/tokens/use-token-controls.d.ts

@@ -14,18 +14,9 @@ export interface UseTokenControlsResult {
     reset: () => void;
 }
 /**
- * The persistence-agnostic token editor. It derives effective values, resolves each control for the
- * active `scheme`, mirrors the effective map onto `documentElement`, and exposes mutators that
- * commit through the injected `overrides`/`onChange` pair.
- *
- * `useTokenControls` owns *no* persistence — the host decides where `overrides` lives and how writes
- * are debounced, then passes the current map and a commit callback in on every render.
- *
- * **Contract — synchronous read-back:** each mutator builds its next map by spreading the current
- * `overrides`. If the host debounces persistence, it must still surface each committed map as
- * `overrides` *synchronously* (e.g. a `useState` working copy) so back-to-back `setControl` calls in
- * one tick don't clobber each other. A host that only reflects the committed map after an async
- * round trip will drop rapid successive edits.
+ * Owns no persistence — the host supplies `overrides`/`onChange`. Contract: each mutator spreads the
+ * current `overrides`, so the host must surface each committed map back synchronously (e.g. a
+ * `useState` working copy) or back-to-back calls in one tick will clobber each other.
  */
 export declare function useTokenControls({ overrides, onChange, scheme }: {
     /** Current overrides, keyed by full CSS custom property name. Must update synchronously on commit. */

package/dist/types/meta.d.ts

@@ -1,12 +1,9 @@
 export type ComponentCategoryId = "buttons" | "inputs" | "layout" | "display";
 export type ComponentStatus = "stable" | "experimental" | "deprecated";
 /**
- * Provenance of a component. `"adapted"` wraps an upstream behavioral package —
- * Base UI by default, or another best-in-class library (e.g. TanStack Table);
- * `"native"` is built by us with no upstream runtime dependency, regardless of
- * whether the design took inspiration from elsewhere. Surfaces as the origin
- * badge in the docs UI and on consumer-side surfaces that disambiguate the
- * implementation source.
+ * Provenance of a component. `"adapted"` wraps an upstream behavioral package
+ * (Base UI by default, or another library); `"native"` has no upstream runtime
+ * dependency, regardless of whether the design took inspiration elsewhere.
  */
 export type ComponentOrigin = "adapted" | "native";
 /**
@@ -24,23 +21,16 @@ export interface ComponentUpstream {
     /** LLM-friendly documentation URL — typically the `.md` companion of `docLink`. */
     llmDocLink?: string;
     /**
-     * Package specifiers a consumer must install to use this primitive, when
-     * adapting from an upstream OTHER than the house dependency (Base UI) — e.g.
-     * `["@tanstack/react-table"]` for Table. Omitted for Base-UI-adapted
-     * primitives, which are already present transitively; an absent field and an
-     * empty array both mean "no extra install". An array (not a single string)
-     * because one adapt may require several independently-installable peers (a
-     * lib plus a required companion package). Docs read this to render an install
-     * hint; `name` remains the human-readable display name.
+     * Install-time package specifiers, e.g. `["@tanstack/react-table"]`. Omitted
+     * for Base-UI-adapted primitives (already present transitively); an absent
+     * field and an empty array both mean "no extra install".
      */
     runtimeDependencies?: string[];
 }
 /**
- * A taxonomic category as it appears on a component's meta. Carries both the
- * stable `id` (slug used for grouping/sorting) and a human-readable `label`.
- * Default labels are English; i18n is out of scope for v0 — a later evolution
- * can swap `ComponentCategories` for locale-aware sources without changing the
- * `ComponentCategory` shape consumers read.
+ * A taxonomic category as it appears on a component's meta: a stable `id`
+ * (slug used for grouping/sorting) and a human-readable `label`. Labels are English only;
+ * locale-aware sources can replace `ComponentCategories` without changing this shape.
  */
 export interface ComponentCategory {
     id: ComponentCategoryId;
@@ -48,8 +38,7 @@ export interface ComponentCategory {
 }
 /**
  * Canonical category objects. Every `*.meta.ts` should reference one of these
- * (e.g. `category: ComponentCategories.inputs`) rather than inlining a literal
- * — a literal allows ID/label drift and duplicates the label string per meta.
+ * rather than inlining a literal, which would allow ID/label drift.
  */
 export declare const ComponentCategories: {
     readonly buttons: {
@@ -70,13 +59,9 @@ export declare const ComponentCategories: {
     };
 };
 /**
- * Self-descriptive metadata for an exported component. Describes *what the
- * component is* — name, taxonomy, lifecycle, a one-sentence identity line, and
- * provenance (adapted from an upstream vs. native). NOT documentation prose,
- * usage examples, props, or part enumerations. Props are derived from the
- * component's TypeScript Props interface at build time; longer-form
- * documentation lives in MDX; named sub-exports are the source of truth for
- * compound-component parts.
+ * Self-descriptive metadata for an exported component: name, taxonomy,
+ * lifecycle, identity line, provenance. NOT documentation prose, usage
+ * examples, props, or part enumerations — those live in MDX and the Props interface.
  */
 export interface ComponentMeta {
     /** PascalCase component name as exported from `@imfusion/web-ui`. Matches the `data-imf-ui-component` attribute. */
@@ -99,10 +84,8 @@ export interface ComponentMeta {
     upstream?: ComponentUpstream;
     /**
      * PascalCase names of other `@imfusion/web-ui` components this component
-     * composes internally (e.g. CopyButton renders through Button).
-     * The in-library counterpart to `upstream.runtimeDependencies`: no install
-     * implication — purely discovery/documentation, surfaced by doc tooling
-     * (DocHeader "Uses" row). Omit when the component composes nothing.
+     * composes internally (e.g. CopyButton renders through Button). No install
+     * implication — surfaced by doc tooling (DocHeader "Uses" row).
      */
     internalDependencies?: string[];
 }

package/dist/vite/readable-css-module-names.d.ts

@@ -4,17 +4,8 @@ export interface ReadableCssModuleNamesOptions {
     prefix: string;
 }
 /**
- * Generates readable CSS Module class names instead of the default hash, so the DOM
- * stays legible in devtools and browser automation. `button.module.css` yields
- * `{prefix}-button-module-root` — `[name]` is the filename, which keeps its `.module`
- * suffix.
- *
- * Register it in every tool that compiles the CSS (the app build AND Storybook). A
- * compiler left out generates different class names for the same source file and its
- * styles silently don't apply.
- *
- * Defaults to opting into Lightning CSS, which drops `css.modules` options it has no
- * equivalent for (`localsConvention`). Set `css.transformer: "postcss"` to stay on
- * the PostCSS pipeline.
+ * `button.module.css` yields `{prefix}-button-module-root`. Register in every CSS-compiling
+ * tool (app build AND Storybook) or class names diverge and styles silently break. Defaults to
+ * Lightning CSS, which drops `css.modules` options like `localsConvention`.
  */
 export declare function readableCssModuleNames({ prefix }: ReadableCssModuleNamesOptions): Plugin;

package/dist/web-ui-cli.js

@@ -0,0 +1,322 @@
+#!/usr/bin/env node
+import { chmodSync as e, cpSync as t, existsSync as n, lstatSync as r, mkdirSync as i, readFileSync as a, readdirSync as o, readlinkSync as s, realpathSync as c, rmSync as l, symlinkSync as u, writeFileSync as d } from "node:fs";
+import { dirname as f, relative as p, resolve as m } from "node:path";
+import { fileURLToPath as ee } from "node:url";
+import { Command as te, Option as ne } from "commander";
+import * as h from "@clack/prompts";
+import { spawnSync as g } from "node:child_process";
+var _ = {
+	harnesses: {
+		claude: {
+			label: "Claude Code",
+			hookSettings: ".claude/settings.json",
+			hookTemplate: "settings.json"
+		},
+		codex: {
+			label: "Codex",
+			hookSettings: ".codex/hooks.json",
+			hookTemplate: "codex-hooks.json"
+		}
+	},
+	namespace: "imf-web-ui",
+	hooksDir: ".agents/hooks/imf-web-ui",
+	templatesDir: "src/llms/install-templates",
+	skillsSource: "src/llms/skills",
+	skillsDir: ".agents/skills",
+	linkDir: ".claude/skills",
+	versionMarker: ".imf-web-ui-skill-version.json"
+};
+//#endregion
+//#region src/cli/paths.ts
+function re(e) {
+	let t = e;
+	for (; !n(m(t, "package.json"));) {
+		let n = f(t);
+		if (n === t) throw Error(`Could not find package.json above ${e}`);
+		t = n;
+	}
+	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);
+}
+function oe() {
+	if (!n(x)) return "absent";
+	let e = S(a(ae, "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");
+}
+//#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];
+}
+function T(e) {
+	return `./${p(y, 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}-`);
+}
+function F() {
+	return n(O) ? o(O, { withFileTypes: !0 }).filter((e) => e.isDirectory() && P(e.name)).map((e) => e.name).sort() : [];
+}
+function I(e) {
+	let t = m(k, e, D);
+	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;
+	} catch {
+		return null;
+	}
+}
+function L(e) {
+	for (let t of e) {
+		let e = I(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), {
+		recursive: !0,
+		force: !0
+	}), h.log.info(`Removed skill: ${n} (${r})`));
+}
+function ce() {
+	return n(A) && n(k) && c(A) === c(k);
+}
+function le(e) {
+	let t = m(A, e), n = p(A, m(k, 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));
+}
+function z(e, n) {
+	try {
+		i(k, { recursive: !0 });
+		for (let r of e) {
+			let e = m(k, r);
+			l(e, {
+				recursive: !0,
+				force: !0
+			}), t(m(O, r), e, { recursive: !0 }), d(m(e, D), JSON.stringify({
+				version: N,
+				harnesses: n
+			}, null, 2) + "\n");
+		}
+		if (R(k, new Set(e), "no longer in this bundle"), h.log.success(`Skills -> ${T(k)}/${E}*`), 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");
+	} catch (e) {
+		throw e instanceof Error ? new j(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) {
+	if (typeof e != "object" || !e || Array.isArray(e)) throw new U(`${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.`);
+	}
+	return n;
+}
+function W(e) {
+	let t;
+	try {
+		t = JSON.parse(a(e, "utf-8"));
+	} 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"
+	});
+}
+function fe() {
+	let n = o(V).filter((e) => e.endsWith(".sh"));
+	i(H, { recursive: !0 });
+	for (let r of n) {
+		let n = m(H, r);
+		t(m(V, r), n, { force: !0 }), e(n, 493);
+	}
+	let r = o(H).filter((e) => e.endsWith(".sh") && !n.includes(e));
+	for (let e of r) l(m(H, e), { force: !0 });
+	return {
+		installed: n,
+		removed: r
+	};
+}
+var G = `${_.hooksDir}/`;
+function K(e) {
+	if (typeof e != "string") return null;
+	let t = e.lastIndexOf(G);
+	if (t === -1) return null;
+	let n = /^([\w.-]+)["']?$/.exec(e.slice(t + G.length));
+	return n ? n[1] : null;
+}
+function q(e) {
+	return typeof e == "object" && !!e && "hooks" in e && Array.isArray(e.hooks);
+}
+function J(e) {
+	return q(e) ? e.hooks : null;
+}
+function Y(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 pe(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;
+			let t = e.hooks, r = t.filter((e) => {
+				let t = K(Y(e));
+				return t === null || n.includes(t);
+			});
+			return s += t.length - r.length, r.length === t.length ? e : {
+				...e,
+				hooks: r
+			};
+		}).filter((e) => {
+			let t = J(e);
+			return t === null || t.length > 0;
+		});
+		s !== 0 && (i += s, c.length === 0 && !(r in t) ? a.push(r) : e.hooks[r] = c);
+	}
+	a.length > 0 && (e.hooks = Object.fromEntries(Object.entries(e.hooks).filter(([e]) => !a.includes(e))));
+	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++);
+		}
+	}
+	return {
+		added: r,
+		removed: i
+	};
+}
+function me(e) {
+	let t = /* @__PURE__ */ new Map(), r = /* @__PURE__ */ new Map();
+	for (let i of C) {
+		let a = m(y, _.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) {
+		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 : []);
+		if (u.added === 0 && u.removed === 0) {
+			o && h.log.info(`Hook registrations already present in ${T(s)}`);
+			continue;
+		}
+		i(f(s), { recursive: !0 }), d(s, JSON.stringify(l, null, 2) + "\n"), de(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)}`);
+	}
+}
+//#endregion
+//#region src/cli/index.ts
+function Z() {
+	return new ne("--harness <harness>", "claude, codex, or all").choices(se);
+}
+async function he(e, t, n) {
+	if (t) return h.log.info(`Harness from --harness flag: ${t.join(", ")}`), t;
+	let r = L(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) => ({
+			value: e,
+			label: _.harnesses[e].label
+		})),
+		required: !0
+	});
+	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();
+	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;
+	}
+	let r = await he(n, t, e.reconfigure === !0);
+	if (!r) return;
+	h.log.message(`Skills in this bundle:\n${n.map((e) => `  - ${e}`).join("\n")}`);
+	try {
+		z(n, r);
+	} catch (e) {
+		if (e instanceof j) {
+			h.log.error(e.message), h.outro("Install failed."), process.exitCode = 1;
+			return;
+		}
+		throw e;
+	}
+	let i = oe();
+	(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());
+	if (!t && !n) {
+		console.error("No harness recorded. Pass --harness=claude|codex|all."), process.exitCode = 1;
+		return;
+	}
+	let r = t ?? n ?? [], i = r.filter((e) => !(n ?? []).includes(e));
+	if (i.length > 0) {
+		for (let e of i) console.error(`No skills installed for ${e}. Run \`npx web-ui install skills --harness=${e}\` first.`);
+		process.exitCode = 1;
+		return;
+	}
+	h.intro("@imfusion/web-ui install hooks");
+	try {
+		me(r);
+	} catch (e) {
+		if (e instanceof U) {
+			console.error(e.message), process.exitCode = 1;
+			return;
+		}
+		throw 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);
+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();
+}), Q.action(() => {
+	Q.help();
+}), await Q.parseAsync();
+//#endregion