@imfusion/web-ui 0.5.1-dev.5.gb4de52d7 → 0.5.1-dev.50.ga7a4f1c3

package/dist/{tabs-DqBFSqq6.js → tabs-CVp_SgBl.js}

@@ -3786,4 +3786,4 @@ function Mo({ className: e, ...t }) {
 }
 Mo.displayName = "Tabs.Panel";
 //#endregion
-export { Hn as $, M as $n, Vt as $t, Kr as A, Ue as An, xn as At, Tr as B, J as Bn, pn as Bt, ha as C, st as Cn, Tn as Ct, gi as D, Je as Dn, kn as Dt, hi as E, $e as En, wn as Et, Fr as F, X as Fn, vn as Ft, mr as G, F as Gn, en as Gt, Sr as H, V as Hn, fn as Ht, Nr as I, ke as In, yn as It, fr as J, T as Jn, Jt, pr as K, N as Kn, $t as Kt, Mr as L, Ee as Ln, hn as Lt, zr as M, Pe as Mn, Cn as Mt, Ir as N, Ae as Nn, bn as Nt, mi as O, Ke as On, Dn as Ot, Pr as P, je as Pn, _n as Pt, Kn as Q, k as Qn, Kt as Qt, kr as R, be as Rn, mn as Rt, _a as S, ct as Sn, jn as St, ra as T, rt as Tn, En as Tt, br as U, B as Un, sn as Ut, Cr as V, U as Vn, ln as Vt, hr as W, L as Wn, tn as Wt, Gn as X, ee as Xn, qt as Xt, gr as Y, f as Yn, Zt as Yt, Un as Z, u as Zn, Gt as Zt, Ta as _, _t as _n, In as _t, Do as a, jt as an, D as ar, Yn as at, fa as b, ft as bn, Fn as bt, to as c, Pt as cn, g as cr, ur as ct, Xa as d, Ot as dn, E as dr, Bn as dt, zt as en, A as er, Jn as et, Ua as f, gt as fn, zn as ft, ka as g, vt as gn, Ln as gt, Oa as h, yt as hn, Rn as ht, jo as i, Dt as in, h as ir, er as it, Wr as j, Z as jn, Sn as jt, ai as k, qe as kn, An as kt, $a as l, xt as ln, v as lr, qn as lt, Na as m, Ft as mn, Vn as mt, Oo as n, At as nn, w as nr, $n as nt, ko as o, Et as on, p as or, sr as ot, Ra as p, bt as pn, dr as pt, vr as q, O as qn, Qt as qt, Mo as r, St as rn, m as rr, Xn as rt, bo as s, Tt as sn, _ as sr, cr as st, Ao as t, Lt as tn, d as tr, Qn as tt, Za as u, Ct as un, y as ur, Zn as ut, ma as v, It as vn, Nn as vt, pa as w, it as wn, On as wt, da as x, ut as xn, Mn as xt, ga as y, pt as yn, Pn as yt, Or as z, _e as zn, dn as zt };
+export { Hn as $, ee as $n, Vt as $t, Kr as A, Je as An, xn as At, Tr as B, Ee as Bn, pn as Bt, ha as C, ct as Cn, Tn as Ct, gi as D, rt as Dn, kn as Dt, hi as E, it as En, wn as Et, Fr as F, Pe as Fn, vn as Ft, mr as G, V as Gn, en as Gt, Sr as H, _e as Hn, fn as Ht, Nr as I, Ae as In, yn as It, fr as J, F as Jn, Jt, pr as K, B as Kn, $t as Kt, Mr as L, je as Ln, hn as Lt, zr as M, qe as Mn, Cn as Mt, Ir as N, Ue as Nn, bn as Nt, mi as O, Xe as On, Dn as Ot, Pr as P, Z as Pn, _n as Pt, Kn as Q, f as Qn, Kt as Qt, kr as R, X as Rn, mn as Rt, _a as S, ut as Sn, jn as St, ra as T, st as Tn, En as Tt, br as U, J as Un, sn as Ut, Cr as V, be as Vn, ln as Vt, hr as W, U as Wn, tn as Wt, Gn as X, O as Xn, qt as Xt, gr as Y, N as Yn, Zt as Yt, Un as Z, T as Zn, Gt as Zt, Ta as _, _t as _n, In as _t, Do as a, jt as an, w as ar, Yn as at, fa as b, dt as bn, Fn as bt, to as c, Pt as cn, D as cr, ur as ct, Xa as d, Ot as dn, g as dr, Bn as dt, zt as en, u as er, Jn as et, Ua as f, gt as fn, v as fr, zn as ft, ka as g, vt as gn, Ln as gt, Oa as h, yt as hn, Rn as ht, jo as i, Dt as in, d as ir, er as it, Wr as j, Ke as jn, Sn as jt, ai as k, $e as kn, An as kt, $a as l, xt as ln, p as lr, qn as lt, Na as m, Ft as mn, E as mr, Vn as mt, Oo as n, At as nn, M as nr, $n as nt, ko as o, Et as on, m as or, sr as ot, Ra as p, bt as pn, y as pr, dr as pt, vr as q, L as qn, Qt as qt, Mo as r, St as rn, A as rr, Xn as rt, bo as s, Tt as sn, h as sr, cr as st, Ao as t, Lt as tn, k as tr, Qn as tt, Za as u, Ct as un, _ as ur, Zn as ut, ma as v, It as vn, Nn as vt, pa as w, ot as wn, On as wt, da as x, ft as xn, Mn as xt, ga as y, pt as yn, Pn as yt, Or as z, ke as zn, dn as zt };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@imfusion/web-ui",
-  "version": "0.5.1-dev.5.gb4de52d7",
+  "version": "0.5.1-dev.50.ga7a4f1c3",
   "description": "The official Web UI component library for ImFusion web apps",
   "author": "ImFusion GmbH",
   "license": "UNLICENSED",
@@ -9,10 +9,17 @@
     "access": "restricted"
   },
   "type": "module",
+  "engines": {
+    "node": ">=24"
+  },
+  "imports": {
+    "#/*": "./src/*",
+    "#/storybook/*": "./.storybook/*"
+  },
   "module": "./dist/index.js",
   "types": "./dist/index.d.ts",
   "bin": {
-    "web-ui-install-skills": "bin/install-skill.js"
+    "web-ui-install": "bin/install.js"
   },
   "exports": {
     ".": {
@@ -23,6 +30,10 @@
       "types": "./dist/integrations/*/index.d.ts",
       "import": "./dist/integrations/*.js"
     },
+    "./build/*": {
+      "types": "./dist/build/*/index.d.ts",
+      "import": "./dist/build/*.js"
+    },
     "./styles.css": "./dist/style.css",
     "./docgen.json": "./src/docgen/doc.gen.json",
     "./llms.txt": "./src/llms/llms.gen.txt",
@@ -30,44 +41,46 @@
   },
   "files": [
     "dist",
+    "src/llms/install-templates",
     "src/docgen/doc.gen.json",
     "src/llms/llms.gen.txt",
+    "src/llms/tokens.gen.json",
     "src/llms/skills",
     "bin"
   ],
   "scripts": {
-    "codegen:docgen": "tsx src/docgen/gen-docgen.ts",
-    "codegen:llms": "tsx src/llms/gen-llms.ts",
-    "codegen:watch": "tsx watch src/codegen/run.ts",
-    "codegen:storybook": "tsx src/codegen/run.ts --storybook",
-    "codegen": "tsx src/codegen/run.ts",
-    "build": "npm run codegen && rm -rf dist && vite build && npm run codegen:docgen && npm run codegen:llms",
     "dev": "tsx scripts/dev.ts",
     "dev:host": "tsx scripts/dev.ts --host",
     "dev:lib": "concurrently -n codegen,lib -c yellow,blue \"npm run codegen:watch\" \"vite build --watch\"",
-    "typecheck": "npm run codegen && tsc -p tsconfig.lib.json --noEmit && tsc -p .storybook/tsconfig.json --noEmit",
+    "build": "npm run codegen && rm -rf dist && vite build && npm run codegen:docgen && npm run codegen:llms && npm run codegen:tokens",
+    "build:storybook": "npm run codegen:storybook && storybook build",
+    "storybook": "npm run codegen:storybook && storybook dev -p 6006 --no-open",
+    "storybook:free-ports": "tsx scripts/free-storybook-ports.ts",
+    "codegen": "tsx src/codegen/run.ts",
+    "codegen:watch": "tsx watch src/codegen/run.ts",
+    "codegen:storybook": "tsx src/codegen/run.ts --storybook",
+    "codegen:docgen": "tsx src/docgen/gen-docgen.ts",
+    "codegen:llms": "tsx src/llms/gen-llms.ts",
+    "codegen:tokens": "tsx src/llms/gen-tokens.ts",
+    "verify:format": "prettier --check .",
+    "verify:lint": "eslint . --cache --max-warnings=0",
+    "verify:typecheck": "npm run codegen && tsc -p tsconfig.json --noEmit && tsc -p tsconfig.lib.json --noEmit && tsc -p .storybook/tsconfig.json --noEmit",
+    "verify:tests": "vitest run",
+    "verify:knip": "knip",
+    "verify:deps": "tsx scripts/check-pinned-dependencies.ts",
+    "verify:changelog": "tsx scripts/verify/changelog.ts",
+    "verify:staged": "tsx scripts/verify/staged.ts",
+    "verify:full": "tsx scripts/verify/full.ts && npm run verify:tests",
     "format": "prettier --write .",
-    "format:check": "prettier --check .",
-    "lint": "eslint . --cache --max-warnings=0",
-    "lint:fix": "eslint . --cache --fix",
+    "lint": "eslint . --cache --fix",
     "lint:inspect": "npx @eslint/config-inspector@latest",
+    "test:unit": "vitest run --project unit",
+    "test:stories": "vitest run --project storybook",
+    "test:watch": "vitest",
     "skills:eval": "node src/llms/evals/run.mjs",
     "skills:eval:dev": "WEB_UI_SKILL_EVAL_ROOT=/private/tmp/web-ui-dev-skill-evals WEB_UI_SKILL_EVAL_RESULTS_DIR=.agents/evals/results WEB_UI_SKILL_EVAL_REPORT_PATH=.agents/evals/REPORT.md WEB_UI_SKILL_EVAL_SKILL_FAMILY=web-ui-dev WEB_UI_SKILL_EVAL_WORKSPACE_LABEL='development repository' node src/llms/evals/run.mjs --scenarios-dir .agents/evals/scenarios --setup .agents/evals/setup-env.sh",
     "skills:eval:compare": "node src/llms/evals/compare.mjs",
     "skills:eval:report": "node src/llms/evals/report.mjs",
-    "storybook": "npm run codegen:storybook && storybook dev -p 6006 --no-open",
-    "storybook:free-ports": "tsx scripts/free-storybook-ports.ts",
-    "build:storybook": "npm run codegen:storybook && storybook build",
-    "test": "vitest run",
-    "test:unit": "vitest run --project unit",
-    "test:stories": "vitest run --project storybook",
-    "test:watch": "vitest",
-    "verify:preflight": "tsx scripts/verify/full.ts",
-    "verify:full": "npm run verify:preflight && npm run test",
-    "worktree:create": "tsx scripts/worktrees.ts create",
-    "worktree:close": "tsx scripts/worktrees.ts close",
-    "worktree:discard": "tsx scripts/worktrees.ts discard",
-    "knip": "knip",
     "git:config": "git config core.hooksPath .githooks && git config pull.rebase true && git config merge.ff only"
   },
   "peerDependencies": {
@@ -124,6 +137,7 @@
     "globals": "15.15.0",
     "jiti": "2.7.0",
     "knip": "6.14.2",
+    "lightningcss": "1.32.0",
     "nano-staged": "1.0.2",
     "playwright": "1.60.0",
     "prettier": "3.8.3",

package/src/docgen/doc.gen.json

@@ -1194,6 +1194,333 @@
       }
     ]
   },
+  "field": {
+    "root": {
+      "name": "Field.Root",
+      "description": "Field.Root — groups a label, control, validation state, and supporting copy.",
+      "props": [
+        {
+          "name": "actionsRef",
+          "required": false,
+          "type": "RefObject<FieldRootActions | null>",
+          "defaultValue": null,
+          "description": ""
+        },
+        {
+          "name": "className",
+          "required": false,
+          "type": "string | ((state: FieldRootState) => string)",
+          "defaultValue": null,
+          "description": ""
+        },
+        {
+          "name": "dirty",
+          "required": false,
+          "type": "boolean",
+          "defaultValue": null,
+          "description": ""
+        },
+        {
+          "name": "disabled",
+          "required": false,
+          "type": "boolean",
+          "defaultValue": "false",
+          "description": ""
+        },
+        {
+          "name": "invalid",
+          "required": false,
+          "type": "boolean",
+          "defaultValue": null,
+          "description": ""
+        },
+        {
+          "name": "name",
+          "required": false,
+          "type": "string",
+          "defaultValue": null,
+          "description": ""
+        },
+        {
+          "name": "render",
+          "required": false,
+          "type": "| ReactElement<\n    unknown,\n    string | JSXElementConstructor<any>\n  >\n| ComponentRenderFn<HTMLProps, FieldRootState>",
+          "defaultValue": null,
+          "description": ""
+        },
+        {
+          "name": "style",
+          "required": false,
+          "type": "| CSSProperties\n| ((state: FieldRootState) => CSSProperties)",
+          "defaultValue": null,
+          "description": ""
+        },
+        {
+          "name": "touched",
+          "required": false,
+          "type": "boolean",
+          "defaultValue": null,
+          "description": ""
+        },
+        {
+          "name": "validate",
+          "required": false,
+          "type": "(\n  value: unknown,\n  formValues: Record<string, any>\n) =>\n  | string\n  | string[]\n  | Promise<string | string[] | null>\n  | null",
+          "defaultValue": null,
+          "description": ""
+        },
+        {
+          "name": "validationDebounceTime",
+          "required": false,
+          "type": "number",
+          "defaultValue": "0",
+          "description": ""
+        },
+        {
+          "name": "validationMode",
+          "required": false,
+          "type": "FormValidationMode",
+          "defaultValue": "onSubmit",
+          "description": ""
+        }
+      ]
+    },
+    "subComponents": [
+      {
+        "name": "Field.Control",
+        "description": "Field.Control — a native input control with Field labeling and validation.",
+        "props": [
+          {
+            "name": "className",
+            "required": false,
+            "type": "string | ((state: FieldControlState) => string)",
+            "defaultValue": null,
+            "description": ""
+          },
+          {
+            "name": "defaultValue",
+            "required": false,
+            "type": "string | number | readonly string[]",
+            "defaultValue": null,
+            "description": ""
+          },
+          {
+            "name": "onValueChange",
+            "required": false,
+            "type": "(\n  value: string,\n  eventDetails: {\n    reason: \"none\";\n    event: Event;\n    cancel: () => void;\n    allowPropagation: () => void;\n    isCanceled: boolean;\n    isPropagationAllowed: boolean;\n    trigger: Element;\n  }\n) => void",
+            "defaultValue": null,
+            "description": ""
+          },
+          {
+            "name": "render",
+            "required": false,
+            "type": "| ReactElement<\n    unknown,\n    string | JSXElementConstructor<any>\n  >\n| ComponentRenderFn<HTMLProps, FieldControlState>",
+            "defaultValue": null,
+            "description": ""
+          },
+          {
+            "name": "style",
+            "required": false,
+            "type": "| CSSProperties\n| ((state: FieldControlState) => CSSProperties)",
+            "defaultValue": null,
+            "description": ""
+          }
+        ]
+      },
+      {
+        "name": "Field.Description",
+        "description": "Field.Description — supporting information for a field.",
+        "props": [
+          {
+            "name": "className",
+            "required": false,
+            "type": "| string\n| ((state: FieldDescriptionState) => string)",
+            "defaultValue": null,
+            "description": ""
+          },
+          {
+            "name": "render",
+            "required": false,
+            "type": "| ReactElement<\n    unknown,\n    string | JSXElementConstructor<any>\n  >\n| ComponentRenderFn<HTMLProps, FieldDescriptionState>",
+            "defaultValue": null,
+            "description": ""
+          },
+          {
+            "name": "style",
+            "required": false,
+            "type": "| CSSProperties\n| ((state: FieldDescriptionState) => CSSProperties)",
+            "defaultValue": null,
+            "description": ""
+          }
+        ]
+      },
+      {
+        "name": "Field.Error",
+        "description": "Field.Error — an inline validation message shown when its match condition fails.",
+        "props": [
+          {
+            "name": "className",
+            "required": false,
+            "type": "string | ((state: FieldErrorState) => string)",
+            "defaultValue": null,
+            "description": ""
+          },
+          {
+            "name": "match",
+            "required": false,
+            "type": "boolean | keyof ValidityState",
+            "defaultValue": null,
+            "description": ""
+          },
+          {
+            "name": "render",
+            "required": false,
+            "type": "| ReactElement<\n    unknown,\n    string | JSXElementConstructor<any>\n  >\n| ComponentRenderFn<HTMLProps, FieldErrorState>",
+            "defaultValue": null,
+            "description": ""
+          },
+          {
+            "name": "style",
+            "required": false,
+            "type": "| CSSProperties\n| ((state: FieldErrorState) => CSSProperties)",
+            "defaultValue": null,
+            "description": ""
+          }
+        ]
+      },
+      {
+        "name": "Field.Item",
+        "description": "Field.Item — groups one checkable option with its label and description.",
+        "props": [
+          {
+            "name": "className",
+            "required": false,
+            "type": "string | ((state: FieldItemState) => string)",
+            "defaultValue": null,
+            "description": ""
+          },
+          {
+            "name": "disabled",
+            "required": false,
+            "type": "boolean",
+            "defaultValue": "false",
+            "description": ""
+          },
+          {
+            "name": "render",
+            "required": false,
+            "type": "| ReactElement<\n    unknown,\n    string | JSXElementConstructor<any>\n  >\n| ComponentRenderFn<HTMLProps, FieldItemState>",
+            "defaultValue": null,
+            "description": ""
+          },
+          {
+            "name": "style",
+            "required": false,
+            "type": "| CSSProperties\n| ((state: FieldItemState) => CSSProperties)",
+            "defaultValue": null,
+            "description": ""
+          }
+        ]
+      },
+      {
+        "name": "Field.Label",
+        "description": "Field.Label — an accessible label automatically associated with the control.",
+        "props": [
+          {
+            "name": "className",
+            "required": false,
+            "type": "string | ((state: FieldLabelState) => string)",
+            "defaultValue": null,
+            "description": ""
+          },
+          {
+            "name": "nativeLabel",
+            "required": false,
+            "type": "boolean",
+            "defaultValue": "true",
+            "description": ""
+          },
+          {
+            "name": "render",
+            "required": false,
+            "type": "| ReactElement<\n    unknown,\n    string | JSXElementConstructor<any>\n  >\n| ComponentRenderFn<HTMLProps, FieldLabelState>",
+            "defaultValue": null,
+            "description": ""
+          },
+          {
+            "name": "style",
+            "required": false,
+            "type": "| CSSProperties\n| ((state: FieldLabelState) => CSSProperties)",
+            "defaultValue": null,
+            "description": ""
+          }
+        ]
+      },
+      {
+        "name": "Field.Validity",
+        "description": "Field.Validity — renderless access to the field validity data for custom messages.\nIts function child owns the rendered element and therefore its identity and styling.",
+        "props": []
+      }
+    ]
+  },
+  "fieldset": {
+    "root": {
+      "name": "Fieldset.Root",
+      "description": "Fieldset.Root — semantic grouping for related form controls and a shared legend.",
+      "props": [
+        {
+          "name": "className",
+          "required": false,
+          "type": "string | ((state: FieldsetRootState) => string)",
+          "defaultValue": null,
+          "description": ""
+        },
+        {
+          "name": "render",
+          "required": false,
+          "type": "| ReactElement<\n    unknown,\n    string | JSXElementConstructor<any>\n  >\n| ComponentRenderFn<HTMLProps, FieldsetRootState>",
+          "defaultValue": null,
+          "description": ""
+        },
+        {
+          "name": "style",
+          "required": false,
+          "type": "| CSSProperties\n| ((state: FieldsetRootState) => CSSProperties)",
+          "defaultValue": null,
+          "description": ""
+        }
+      ]
+    },
+    "subComponents": [
+      {
+        "name": "Fieldset.Legend",
+        "description": "Fieldset.Legend — the accessible label for its related controls.",
+        "props": [
+          {
+            "name": "className",
+            "required": false,
+            "type": "string | ((state: FieldsetLegendState) => string)",
+            "defaultValue": null,
+            "description": ""
+          },
+          {
+            "name": "render",
+            "required": false,
+            "type": "| ReactElement<\n    unknown,\n    string | JSXElementConstructor<any>\n  >\n| ComponentRenderFn<HTMLProps, FieldsetLegendState>",
+            "defaultValue": null,
+            "description": ""
+          },
+          {
+            "name": "style",
+            "required": false,
+            "type": "| CSSProperties\n| ((state: FieldsetLegendState) => CSSProperties)",
+            "defaultValue": null,
+            "description": ""
+          }
+        ]
+      }
+    ]
+  },
   "input": {
     "root": {
       "name": "Input",

package/src/llms/install-templates/AGENTS.md

@@ -0,0 +1,34 @@
+# AGENTS.md
+
+<Keep this file lean — target ~50 lines. Decision test for every line: would the agent make a costly mistake without it? If
+it would just need to read a file first, cut it. Dev commands, path aliases, and tool config are discoverable from the files
+themselves.>
+
+<One paragraph: what the app is and the stack in one line.>
+
+Scripts, deps, and setup: [`README.md`](./README.md) and [`package.json`](./package.json) are the source of truth. Check the
+`package.json` scripts before running or suggesting a command — don't infer one exists by pattern-matching a sibling.
+
+## Read before you write
+
+<One bullet per doc in docs/, each with when to read it, e.g.:>
+
+- [`docs/<topic>.md`](./docs/<topic>.md) — <what it covers>. Read before <the change it governs>.
+
+[`docs/index.md`](./docs/index.md) registers all of them.
+
+## Working here
+
+<The fenced block below is the only part of this file `npx web-ui-install` touches: its content comes from this template and
+is refreshed on every skills install. Everything else in the file is scaffolded once by the setup skill and then owned by the
+repo.>
+
+<!-- imf-web-ui:begin — managed by `npx web-ui-install`; edits inside the fence are overwritten -->
+
+`.agents/skills/imf-web-ui-*` is vendored from `@imfusion/web-ui` and resynced with `npx web-ui-install`. Don't edit it and
+don't put repo conventions there. Load the matching `imf-web-ui-*` skill before writing code, styles, data fetching, or docs;
+repo docs hold only what is unique to this repo.
+
+<!-- imf-web-ui:end -->
+
+<Repo-specific agent guidance: generated files that are committed, tools to verify APIs against, things never to touch.>

package/src/llms/install-templates/codex-hooks.json

@@ -0,0 +1,44 @@
+{
+  "hooks": {
+    "SessionStart": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "\"$(git rev-parse --show-toplevel)/.agents/hooks/imf-web-ui/session-start.sh\""
+          }
+        ]
+      }
+    ],
+    "Stop": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "\"$(git rev-parse --show-toplevel)/.agents/hooks/imf-web-ui/stop.sh\""
+          }
+        ]
+      }
+    ],
+    "SubagentStart": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "\"$(git rev-parse --show-toplevel)/.agents/hooks/imf-web-ui/subagent-start.sh\""
+          }
+        ]
+      }
+    ],
+    "UserPromptSubmit": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "\"$(git rev-parse --show-toplevel)/.agents/hooks/imf-web-ui/user-prompt-submit.sh\""
+          }
+        ]
+      }
+    ]
+  }
+}

package/src/llms/install-templates/hooks/baseline-staleness.sh

@@ -0,0 +1,17 @@
+#!/usr/bin/env sh
+# Advisory baseline-staleness check, meant to be called from the repo's pre-commit hook.
+# Compares the installed imf-web-ui skill markers against the installed package version
+# and warns on drift. Always exits 0 — staleness never blocks a commit.
+PKG=node_modules/@imfusion/web-ui/package.json
+[ -f "$PKG" ] || exit 0
+CURRENT=$(node -p "require('./$PKG').version" 2>/dev/null) || exit 0
+
+for marker in .agents/skills/imf-web-ui-*/.imf-web-ui-skill-version.json; do
+  [ -f "$marker" ] || continue
+  INSTALLED=$(node -p "require('./$marker').version" 2>/dev/null) || continue
+  if [ "$INSTALLED" != "$CURRENT" ]; then
+    echo "imf-web-ui skills are stale ($INSTALLED installed, package is $CURRENT) — run: npx web-ui-install"
+    break
+  fi
+done
+exit 0

package/src/llms/install-templates/hooks/session-start.sh

@@ -0,0 +1,5 @@
+#!/usr/bin/env sh
+# SessionStart: inject the web-ui router pointer once per session. Fixed string — the
+# hook-injection eval asserts on it verbatim.
+echo "This project depends on @imfusion/web-ui. Start at the imf-web-ui skill: it decides whether guidance is needed and routes to the right companion. Repo docs carry only what is unique to this repo."
+exit 0

package/src/llms/install-templates/hooks/stop.sh

@@ -0,0 +1,18 @@
+#!/usr/bin/env sh
+# Stop: the turn-end verify gate. When this turn edited source files, block the
+# agent from finishing once, instructing it to run the project's verification.
+# Both hosts send stop_hook_active=true when the turn continues because of a
+# prior block, so the gate can never loop. Fails open everywhere else: no git,
+# a clean tree, or no edit evidence in the transcript all pass silently.
+PAYLOAD=$(cat)
+printf '%s' "$PAYLOAD" | grep -q '"stop_hook_active"[[:space:]]*:[[:space:]]*true' && exit 0
+git rev-parse --is-inside-work-tree >/dev/null 2>&1 || exit 0
+[ -n "$(git status --porcelain -- '*.ts' '*.tsx' '*.js' '*.jsx' '*.css' 2>/dev/null)" ] || exit 0
+# Gate only turns that actually edited files — a tree left dirty by an earlier
+# session must not block a question-answering turn. Edit evidence: Write/Edit
+# tool calls (Claude transcript) or apply_patch calls (Codex rollout).
+TRANSCRIPT=$(printf '%s' "$PAYLOAD" | sed -n 's/.*"transcript_path"[[:space:]]*:[[:space:]]*"\([^"]*\)".*/\1/p' | head -n 1)
+[ -f "$TRANSCRIPT" ] || exit 0
+grep -q '"name":"Write"\|"name":"Edit"\|"name":"MultiEdit"\|"name":"NotebookEdit"\|apply_patch' "$TRANSCRIPT" || exit 0
+printf '{"decision":"block","reason":"web-ui stop gate: this turn changed source files. Run the project verification (verify:typecheck, verify:lint, and verify:format at minimum), fix what it reports, then finish. If it already ran after the last change, say so and finish."}\n'
+exit 0

package/src/llms/install-templates/hooks/subagent-start.sh

@@ -0,0 +1,5 @@
+#!/usr/bin/env sh
+# SubagentStart: subagents don't reliably inherit the parent session's SessionStart
+# context, so they get the same router pointer. Text byte-identical to session-start.sh.
+echo "This project depends on @imfusion/web-ui. Start at the imf-web-ui skill: it decides whether guidance is needed and routes to the right companion. Repo docs carry only what is unique to this repo."
+exit 0

package/src/llms/install-templates/hooks/user-prompt-submit.sh

@@ -0,0 +1,5 @@
+#!/usr/bin/env sh
+# UserPromptSubmit: one-line per-prompt pointer to the companion skills. Fixed string —
+# the hook-injection eval asserts on it verbatim.
+echo "web-ui: check imf-web-ui-components before using a component API, imf-web-ui-conventions before writing code, styles or docs, and imf-web-ui-ux when shaping a screen or flow."
+exit 0

package/src/llms/install-templates/settings.json

@@ -0,0 +1,45 @@
+{
+  "$schema": "https://json.schemastore.org/claude-code-settings.json",
+  "hooks": {
+    "SessionStart": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "\"$CLAUDE_PROJECT_DIR/.agents/hooks/imf-web-ui/session-start.sh\""
+          }
+        ]
+      }
+    ],
+    "Stop": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "\"$CLAUDE_PROJECT_DIR/.agents/hooks/imf-web-ui/stop.sh\""
+          }
+        ]
+      }
+    ],
+    "SubagentStart": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "\"$CLAUDE_PROJECT_DIR/.agents/hooks/imf-web-ui/subagent-start.sh\""
+          }
+        ]
+      }
+    ],
+    "UserPromptSubmit": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "\"$CLAUDE_PROJECT_DIR/.agents/hooks/imf-web-ui/user-prompt-submit.sh\""
+          }
+        ]
+      }
+    ]
+  }
+}