@imfusion/web-ui 0.6.4-dev.84.gbfc0d437 → 0.7.1-dev.1.g3b4d502e

package/CHANGELOG.md

@@ -0,0 +1,400 @@
+# Changelog
+
+## `0.7.1`          2026.09.27
+
+### Fixed
+
+- The 0.7.0 release notes install the package before running `npx web-ui install`. — Nikolaus Brunner <brunner@imfusion.com>
+
+---
+
+## `0.7.0` &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; 2026.09.27
+
+### Highlights
+
+#### Set up through your agent
+
+Web UI is now built to be installed and used through a coding agent. Once the package is installed, `npx web-ui install
+skills` and `npx web-ui install hooks` set up its agent skills and lifecycle hooks for Claude Code, Codex, or both
+([WEBSDK-241](https://imfusion.atlassian.net/browse/WEBSDK-241)). The user guides ship inside the package, and the router
+skill sends library questions to the matching page. Getting Started walks through handing the setup to your agent, and
+Agent Tooling lists what each agent reads and where ([WEBSDK-206](https://imfusion.atlassian.net/browse/WEBSDK-206)).
+
+```sh
+npm install @imfusion/web-ui
+npx web-ui install skills --harness=all
+npx web-ui install hooks --harness=all
+```
+
+Then ask your agent to wire the library into the project:
+
+```text
+Set up @imfusion/web-ui in this project.
+```
+
+That runs `/imf-web-ui-setup`, which proposes a plan and writes the stylesheet import and `WebUIProvider` only after you
+approve it. `/imf-web-ui-audit` checks an existing project against the library's conventions without changing any file.
+
+The hooks point the agent at the `imf-web-ui` router. The router answers library questions from the packaged user guides and
+hands other tasks to a skill. Setup, audit, and the UX skill work from `imf-web-ui-conventions`, a knowledge skill that
+holds the ImFusion frontend conventions. Solid outlines are the skills you run; dashed boxes are knowledge the agent
+reads:
+
+```mermaid
+flowchart TD
+  guides["Packaged<br/>user guides<br/>(knowledge)"] -.-> router
+  hooks["Automatic hooks<br/>Session start: point to the router<br/>Subagent start: same for helpers<br/>Each prompt: name matching skills"] --> router["/imf-web-ui<br/>router"]
+  conventions["imf-web-ui-<br/>conventions<br/>(knowledge)"] ~~~ router
+  router --> update["/imf-web-ui-<br/>update"]
+  router --> components["/imf-web-ui-<br/>components"]
+  router --> ux["/imf-web-ui-<br/>ux"]
+  router --> audit["/imf-web-ui-<br/>audit"]
+  router --> setup["/imf-web-ui-<br/>setup"]
+  conventions -.-> setup
+  conventions -.-> audit
+  conventions -.-> ux
+  update -. offers .-> audit
+  class router primary
+  class guides,conventions knowledge
+  class update,components,ux,audit,setup action
+```
+
+#### New and updated components
+
+- `NumberField` is new. It handles numeric entry with styled increment and decrement buttons, sizes to its content, and
+  fills its parent with `width="full"` ([WEBSDK-236](https://imfusion.atlassian.net/browse/WEBSDK-236)).
+- Adapted primitives accept every upstream prop, `ref` included, and their prop tables show the upstream descriptions and
+  defaults ([WEBSDK-229](https://imfusion.atlassian.net/browse/WEBSDK-229)).
+- `Typo` follows the ImFusion body and heading scales, with variable font weights from 450 to 600. `Typo.Hero` is a new
+  responsive display heading from 48 to 144 px. `Typo.Hero`, `Typo.H1`, and `Typo.H2` fade every line after the first;
+  `fadeAfterFirstLine` turns that off.
+- `Spinner` plays the animated ImFusion glyph in `blue`, `white`, or `black`
+  ([WEBSDK-205](https://imfusion.atlassian.net/browse/WEBSDK-205)).
+- `Button` takes `context="oncolor"` for actions on saturated primary surfaces
+  ([WEBSDK-216](https://imfusion.atlassian.net/browse/WEBSDK-216)).
+- `Separator` has a named spacing scale for the margins around it and accepts `render`
+  ([WEBSDK-229](https://imfusion.atlassian.net/browse/WEBSDK-229)).
+- Code highlighting registers every grammar TanStack Highlight ships, including C++, CMake, Go, and PHP
+  ([WEBSDK-239](https://imfusion.atlassian.net/browse/WEBSDK-239)).
+
+#### Brand assets
+
+The ImFusion favicon set and social preview image ship under `@imfusion/web-ui/assets/*`. The `imfusionBrandAssets` Vite
+plugin serves them at the site root in dev and emits them into your build
+([CP-154](https://imfusion.atlassian.net/browse/CP-154)).
+
+#### A branded Storybook
+
+Storybook carries the ImFusion look: a primary sidebar with the ImFusion logo, theme colors read from the Web UI tokens, and
+square corners with hard shadows across menus, dialogs, and the addon panel. On wide screens the sidebar and the content
+float as separate boxes ([WEBSDK-182](https://imfusion.atlassian.net/browse/WEBSDK-182)). Tokens has its own section with
+live controls, and a Changelog page renders this file.
+
+The layout adapts from a wide desktop down to a phone:
+
+![Desktop: the sidebar and the content float as separate boxes](docs/assets/changelog/0.7.0-storybook.webp)
+![Sidebar hidden: the content keeps its floating box](docs/assets/changelog/0.7.0-storybook-collapsed.webp)
+![Narrow screen: the gaps close, and the sidebar and content sit edge to edge](docs/assets/changelog/0.7.0-storybook-narrow.webp)
+![Phone: the content fills the screen, and the sidebar opens from the bottom bar](docs/assets/changelog/0.7.0-storybook-phone.webp)
+
+#### Important fixes
+
+- `WebUIProvider` applies the color scheme, and its `colorScheme` prop pins it. Under the `system` preference,
+  `useColorScheme` writes the resolved `light` or `dark` value to `data-imf-ui-color-scheme`
+  ([WEBSDK-235](https://imfusion.atlassian.net/browse/WEBSDK-235)).
+- `Select` values and `Drawer` payloads keep their types through the generic roots
+  ([WEBSDK-212](https://imfusion.atlassian.net/browse/WEBSDK-212)).
+
+#### Migrating from 0.6
+
+The skill installer is a `web-ui` command with subcommands. `--harness=claude|codex|all` replaces `--target`, and the skills
+must be installed before the hooks for the same harness:
+
+```diff
+- npx web-ui-install
+- npx web-ui-install --hooks
++ npx web-ui install skills --harness=all
++ npx web-ui install hooks --harness=all
+```
+
+`readableCssModuleNames` has a new import path:
+
+```diff
+- import { readableCssModuleNames } from "@imfusion/web-ui/build/vite-css-module-names";
++ import { readableCssModuleNames } from "@imfusion/web-ui/vite";
+```
+
+Spinner ignores `color`. Choose a baked variant:
+
+```diff
+- <Spinner style={{ color: "white" }} />
++ <Spinner variant="white" />
+```
+
+### Breaking
+
+- **Breaking:** `npx web-ui install skills` and `npx web-ui install hooks` replace `npx web-ui-install` ([WEBSDK-241](https://imfusion.atlassian.net/browse/WEBSDK-241)). — Nikolaus Brunner <brunner@imfusion.com>
+  - `--harness=claude|codex|all` replaces `--target claude|agents|all`, and `install hooks` replaces `--hooks`.
+  - `install hooks` requires the skills to be installed for the same harness.
+  - Skills install into `.agents/skills/`; `claude` adds a link per skill in `.claude/skills/`.
+  - The installer owns every `imf-web-ui` and `imf-web-ui-*` skill directory and overwrites or prunes them.
+- **Breaking:** Spinner plays the brand glyph animation in a baked color and ignores `color` ([WEBSDK-205](https://imfusion.atlassian.net/browse/WEBSDK-205)). — Nikolaus Brunner <brunner@imfusion.com>
+  - `variant` selects `blue` (default), `white`, or `black`; the animation ignores `currentColor` and the color scheme.
+  - The animation ignores `prefers-reduced-motion` and cannot pause.
+  - The frames add about 139 KB to `dist/index.js`.
+- **Breaking:** `readableCssModuleNames` moves from `@imfusion/web-ui/build/vite-css-module-names` to `@imfusion/web-ui/vite` ([CP-154](https://imfusion.atlassian.net/browse/CP-154)). — Nikolaus Brunner <brunner@imfusion.com>
+
+### Added
+
+- Tabs lists scroll when their tabs overflow, and the active tab sticks to the edge it would scroll past and draws its own box while the list overflows. — Nikolaus Brunner <brunner@imfusion.com>
+- The package ships `CHANGELOG.md`, so the packaged Changelog guide has its content. — Nikolaus Brunner <brunner@imfusion.com>
+- Storybook examples — Nikolaus Brunner <brunner@imfusion.com>
+  - The Showcase, typography prose, documentation, and a responsive type spec.
+  - An image-led page for `Typo.Hero`.
+- An advisory audit hook counts hedged findings in a written `AUDIT_REPORT.md`. — Nikolaus Brunner <brunner@imfusion.com>
+
+### Changed
+
+- Token defaults — Nikolaus Brunner <brunner@imfusion.com>
+  - The dark surface is lighter at luma `0.35`, and the support and minor backgrounds sit further from it.
+  - Shadow elevation levels share one opacity, and `--imf-ui-shadow-intensity` defaults to `15%`.
+  - In the dark scheme, primary fills are darker and primary text is lighter: `--imf-ui-color-primary-bg-luma-dark`
+    defaults to `0.6` and `--imf-ui-color-primary-fg-luma-dark` to `0.8`.
+- Links, highlights, and inline code are flatter ([WEBSDK-227](https://imfusion.atlassian.net/browse/WEBSDK-227)). — Nikolaus Brunner <brunner@imfusion.com>
+  - `Typo.Link` has no trailing arrow and underlines on hover only.
+  - `Typo.Highlight` uses the main primary background.
+  - `Code.Inline` is a flat chip on the minor background, without border or shadow.
+  - `Code.InlineLink` has no trailing arrow, uses the primary text color, and accepts any children.
+  - The Tooltip trigger underline is dotted and uses the text color.
+- Layout and display components ([WEBSDK-216](https://imfusion.atlassian.net/browse/WEBSDK-216)). — Nikolaus Brunner <brunner@imfusion.com>
+  - Card has a configurable image ratio, 16:10 by default, and its images fill horizontal layouts without gaps.
+  - AppShell's aside is 21.25rem wide, and its section padding is configurable.
+  - Table text defaults to 14px.
+  - Chip labels have higher contrast.
+- Typo and Input defaults — Nikolaus Brunner <brunner@imfusion.com>
+  - `Typo.H1` and `Typo.H2` default to the `primary` variant.
+  - `Typo.Lead` uses the medium font weight.
+  - Heading margins and list indents scale with the fluid type sizes, `Typo.H1` gets a top margin, and a heading that
+    opens its container starts flush.
+  - Input padding is `0.75em` at every size, so it scales with the font size.
+- The code highlight theme tokens (`--th-*`) are scoped to `Code.Block` and `Code.Inline` instead of `:root` ([WEBSDK-206](https://imfusion.atlassian.net/browse/WEBSDK-206)). — Nikolaus Brunner <brunner@imfusion.com>
+- Documentation ([WEBSDK-206](https://imfusion.atlassian.net/browse/WEBSDK-206)). — Nikolaus Brunner <brunner@imfusion.com>
+  - The user guide runs Getting Started, Agent Tooling, Usage Patterns, Brand Assets, and How It's Built.
+  - The Tokens page is the single place that documents the Storybook token controls, and the token reference shows them like
+    the showcase: a side panel on large screens, a drawer on smaller ones.
+  - Docs pages end with previous and next links in sidebar order.
+  - Storybook docs render `mermaid` fences as diagrams, with a diagram's `title` as a primary caption, `owned` and
+    `external` subgraphs as primary-tinted and grey-striped lanes, and GitHub alerts as Callouts.
+  - The Design System page opens with how views and components are designed in Claude Design, and shows the sync in one
+    diagram, split by who owns each step.
+  - The development docs split Architecture, the decisions and their reasons, from Rules, the checkable rules with wrong and
+    right examples. The release guide shows under Development, and the color system and release guides have flow diagrams.
+  - Docs and skills are shorter, with examples and tables in place of repeated prose.
+  - `design/DESIGN.md` describes ImFusion's characteristics, voice, type, and color in the styleguide's own words, with
+    example images under `design/examples/`, and `web-ui-dev-claude-design-sync` syncs it, the user guide, and the token and
+    icon lookups to the Claude Design project.
+- Storybook — Nikolaus Brunner <brunner@imfusion.com>
+  - Storybook and its addons use version 10.6.0 ([WEBSDK-238](https://imfusion.atlassian.net/browse/WEBSDK-238)).
+  - Prop tables show string defaults without quotes and list each default once ([WEBSDK-229](https://imfusion.atlassian.net/browse/WEBSDK-229)).
+  - The manager follows the OS color scheme without a reload and hides the onboarding checklists, the create-story button,
+    and the tag filters.
+  - The sidebar gives its header, navigation groups, and items more vertical space.
+  - Sidebar rows that expand read as bold folders without chevrons, test entries sit under their story in italics, and
+    the context-menu button stays clear of labels.
+  - Docs pages open with a `Typo.Hero` title on token-based surfaces in the library font families, and story canvases have
+    a softer border.
+  - Storybook uses the ImFusion favicon set and starts on the next free port.
+  - The production build omits the Vitest testing widget.
+  - The Storybook config is written with `defineMain` and `definePreview`.
+- Agent skills — Nikolaus Brunner <brunner@imfusion.com>
+  - `imf-web-ui-update` reads the shipped `CHANGELOG.md` in its migration audit: it maps breaking changes and migration steps
+    to the project's call sites and lists fitting new features as suggestions, changing no file until the person approves.
+  - `web-ui-dev-changelog` covers the mechanical log and the curated release section, and `web-ui-dev-release` curates
+    the release notes through it.
+  - `web-ui-dev-audit-docs` checks Mermaid diagrams against the skills and flows they draw.
+  - The Development docs have an Agent Tooling page that draws the dev skills, their hook, and the shared writing skills.
+  - `web-ui-dev-llm-framework` keeps the consumer and dev LLM framework diagrams in sync, and unit tests fail when a diagram
+    and its skills or hooks disagree.
+  - `imf-web-ui-conventions` is a knowledge skill that setup, audit, and the UX skill load; it is not user-invocable.
+  - `imf-web-ui-audit` reports improvements that no convention asks for in a separate `Suggestions` section.
+  - The consumer skills route documentation work to the `docs-structure` topic, and `imf-web-ui-conventions` invokes
+    `/documentation-writer` only when a project has it.
+  - The development skills run `humanizer` on documentation prose and keep `documentation-writer` for new pages and
+    restructures.
+  - `web-ui-dev-changelog` writes migration guidance as `diff` and code blocks.
+- CI and verification — Nikolaus Brunner <brunner@imfusion.com>
+  - TeamCity builds open pull requests and pushed release tags without a manual run ([WEBSDK-256](https://imfusion.atlassian.net/browse/WEBSDK-256)).
+  - TeamCity runs static checks before builds, tests, and publishing.
+  - Pre-commit runs whole-repository lint and format checks, and full verification runs the fast checks first.
+  - `ci:status` shows each build's published npm version and whether it went to the dev or stable channel.
+
+### Fixed
+
+- Components — Nikolaus Brunner <brunner@imfusion.com>
+  - The NumberField input minimum scales with the control size and stays slightly narrower than both controls combined.
+  - Callout slot boundaries override default Typo margins.
+  - Button rendered as a link has no text underline ([WEBSDK-206](https://imfusion.atlassian.net/browse/WEBSDK-206)).
+  - The NavigationMenu inline submenu gap and the Code block border use existing tokens ([WEBSDK-206](https://imfusion.atlassian.net/browse/WEBSDK-206)).
+- Docs and Storybook — Nikolaus Brunner <brunner@imfusion.com>
+  - Markdown tables render through the styled Web UI table components.
+  - The preview keeps the docs background in dark mode while pages load and switch ([WEBSDK-206](https://imfusion.atlassian.net/browse/WEBSDK-206)).
+  - The story frame fits the docs column: its border stays visible and the canvas does not scroll sideways on wide displays.
+  - The usage and styling examples give a wrapped `Switch.Root` its `data-imf-ui-component` attribute ([WEBSDK-206](https://imfusion.atlassian.net/browse/WEBSDK-206)).
+- Agent skills — Nikolaus Brunner <brunner@imfusion.com>
+  - Consumer skills load the UX skill for new forms and check CSS token names against the package before use ([WEBSDK-218](https://imfusion.atlassian.net/browse/WEBSDK-218)).
+  - `imf-web-ui-audit` dispatches an investigator per topic before reading any topic inline, uses the investigators'
+    evidence without re-checking it, keeps every finding in the report contract's shape, and files working code that
+    differs from a convention as a deviation ([WEBSDK-218](https://imfusion.atlassian.net/browse/WEBSDK-218)).
+  - The router sends broken-install and library-choice questions to the skill that answers them, and `imf-web-ui-setup`
+    stays on the topic it was asked about.
+  - `imf-web-ui-ux` asks a question before recommending on a vague request and builds a fully specified one without asking.
+  - `imf-web-ui-components` starts every lookup at the component index, even for a component it already knows.
+  - `imf-web-ui-update` stops on any uncommitted work before it installs or writes anything.
+  - The `imf-web-ui-conventions` audit checklist lists only sections the React topic has ([WEBSDK-206](https://imfusion.atlassian.net/browse/WEBSDK-206)).
+- The format-on-edit agent hook runs Prettier from the edited file's own worktree, so a worktree's `.prettierignore` applies. — Nikolaus Brunner <brunner@imfusion.com>
+
+---
+
+## `0.6.3` &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; 2026.09.03
+
+### Changed
+
+- The npm banner image has fixed dimensions. — Nikolaus Brunner <brunner@imfusion.com>
+- The release steps live in the release docs instead of the README. — Nikolaus Brunner <brunner@imfusion.com>
+
+---
+
+## `0.6.2` &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; 2026.09.03
+
+### Fixed
+
+- The npm package banner and public metadata render correctly ([WEBSDK-224](https://imfusion.atlassian.net/browse/WEBSDK-224)). — Nikolaus Brunner <brunner@imfusion.com>
+
+### Changed
+
+- The docs describe the manual release procedure. — Nikolaus Brunner <brunner@imfusion.com>
+- The remaining release hints move from the README to the release docs. — Nikolaus Brunner <brunner@imfusion.com>
+
+---
+
+## `0.6.1` &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; 2026.09.02
+
+### Highlights
+
+#### Public npm package
+
+Install `@imfusion/web-ui` from npm without a registry token. The package is still pre-1.0 and not meant for production use.
+
+#### Toast
+
+`WebUIProvider` mounts a Toast provider for stacked, anchored, actionable, and promise-driven notifications.
+
+#### Code highlighting
+
+CodeHighlight now covers HTML, JavaScript, JSX, Markdown, YAML, SQL, Dockerfile, and TOML.
+
+### Added
+
+- `@imfusion/web-ui` is on npm, installs without a token, and documents its pre-1.0 status ([WEBSDK-224](https://imfusion.atlassian.net/browse/WEBSDK-224)). — Nikolaus Brunner <brunner@imfusion.com>
+- Stack has a zero-gap option. — Nikolaus Brunner <brunner@imfusion.com>
+- Typo and Code support Base UI render composition ([WEBSDK-221](https://imfusion.atlassian.net/browse/WEBSDK-221)). — Nikolaus Brunner <brunner@imfusion.com>
+- CodeHighlight highlights HTML, JavaScript, JSX, Markdown, YAML, SQL, Dockerfile, and TOML. — Nikolaus Brunner <brunner@imfusion.com>
+- Toast primitive adapted from Base UI, with stacked notifications, anchored feedback, actions, and promise-driven messages; `WebUIProvider` mounts a default provider. — Nikolaus Brunner <brunner@imfusion.com>
+
+### Changed
+
+- `npm run ci:status` lists recent TeamCity builds. — Nikolaus Brunner <brunner@imfusion.com>
+- Toast viewports have width variants and adjusted typography. — Nikolaus Brunner <brunner@imfusion.com>
+- The surface and status color tokens are retuned. — Nikolaus Brunner <brunner@imfusion.com>
+- Code blocks use the support background token. — Nikolaus Brunner <brunner@imfusion.com>
+- `npm run ci:status` links each TeamCity run. — Nikolaus Brunner <brunner@imfusion.com>
+- CodeHighlight uses TanStack Highlight's GitHub Light and Dark presets for syntax colors ([WEBSDK-222](https://imfusion.atlassian.net/browse/WEBSDK-222)). — Nikolaus Brunner <brunner@imfusion.com>
+- New and updated documentation goes through the `documentation-writer` skill. — Nikolaus Brunner <brunner@imfusion.com>
+- The documentation is rewritten to read more plainly. — Nikolaus Brunner <brunner@imfusion.com>
+- Pre-commit runs focused checks, and the full CI verification runs before each push. — Nikolaus Brunner <brunner@imfusion.com>
+- One command tags and pushes a prepared release commit. — Nikolaus Brunner <brunner@imfusion.com>
+- Tagged release builds can be checked through the optional TeamCity CLI. — Nikolaus Brunner <brunner@imfusion.com>
+
+---
+
+## `0.6.0` &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; 2026.08.26
+
+### Highlights
+
+#### Icons
+
+Storybook lists all 1,671 bundled Iconoir icons, searchable by name, tag, category, or style. Each tile copies its JSX or
+named import.
+
+```tsx
+import { ArrowRight, Icon } from "@imfusion/web-ui/icons";
+
+<Icon glyph={ArrowRight} variant="primary" aria-label="Continue" role="img" />;
+```
+
+#### Forms
+
+- `Field` groups a label, control, validation state, and supporting copy.
+- `Fieldset` groups related controls under a shared legend.
+
+#### Code highlighting
+
+CodeHighlight renders C++, Python, and CMake snippets.
+
+### Breaking
+
+- **Breaking:** The consumer skills are renamed around `setup`, `audit`, and `conventions`, two retired skills are removed, and consumers need to rerun `npx web-ui-install`. — Nikolaus Brunner <brunner@imfusion.com>
+- **Breaking:** Three injection hooks (SessionStart, SubagentStart, UserPromptSubmit), registered for both Claude Code and Codex, replace the shipped post-edit lint hook; rerunning `npx web-ui-install --hooks` prunes the retired hook and its registrations. — Nikolaus Brunner <brunner@imfusion.com>
+
+### Added
+
+- The Web UI icon facade, with searchable iconography docs in Storybook. — Nikolaus Brunner <brunner@imfusion.com>
+- CodeHighlight highlights C++, Python, and CMake. — Nikolaus Brunner <brunner@imfusion.com>
+- A turn-end Stop gate hook blocks an agent turn that edited source files once, until the project's verification is addressed, on Claude Code and Codex. — Nikolaus Brunner <brunner@imfusion.com>
+- Field and Fieldset primitives. — Nikolaus Brunner <brunner@imfusion.com>
+- Readable CSS class names through an opt-in consumer plugin. — Nikolaus Brunner <brunner@imfusion.com>
+- A Web UI update skill and an ImFusion frontend setup skill. — Nikolaus Brunner <brunner@imfusion.com>
+- Automated versioning, release publishing, and a `dev` dist-tag. — Nikolaus Brunner <brunner@imfusion.com>
+- A documented Web UI release workflow. — Nikolaus Brunner <brunner@imfusion.com>
+
+### Fixed
+
+- Chip's main, support, and minor variants use the right color tokens. — Nikolaus Brunner <brunner@imfusion.com>
+- The peer contract accepts SDK 1.x prereleases as well as stable major 1. — Nikolaus Brunner <brunner@imfusion.com>
+- Storybook token overrides live in URL globals, and hidden localStorage values no longer come back. — Nikolaus Brunner <brunner@imfusion.com>
+- Callout's Title and Description slots keep their size when the content has its own margins. — Ehsan Shafiei <shafiei@imfusion.com>
+- CodeHighlight highlights Python function calls correctly. — Nikolaus Brunner <brunner@imfusion.com>
+- ESLint resolves in worktrees through the main checkout's configuration. — Nikolaus Brunner <brunner@imfusion.com>
+- Teardown finishes when a skill removes its own worktree session. — Nikolaus Brunner <brunner@imfusion.com>
+- Re-running the skill installer skips the target prompt. — Nikolaus Brunner <brunner@imfusion.com>
+- Settings with braced `${CLAUDE_PROJECT_DIR}` get no duplicate hook registrations. — Nikolaus Brunner <brunner@imfusion.com>
+- Type checking covers TypeScript outside `src/`. — Nikolaus Brunner <brunner@imfusion.com>
+
+### Changed
+
+- Library builds keep declared runtime packages external. — Nikolaus Brunner <brunner@imfusion.com>
+- The full CI verification suite runs before every push. — Nikolaus Brunner <brunner@imfusion.com>
+- Syntax highlighting stays inside the CodeHighlight integration, and Code copies the rendered content. — Nikolaus Brunner <brunner@imfusion.com>
+- The audit skill runs as an orchestrator in plan mode: one cheap investigator per topic gathers evidence, and the merged findings become a plan instead of a report file. — Nikolaus Brunner <brunner@imfusion.com>
+- Every changelog entry names its author and stays on one line. — Nikolaus Brunner <brunner@imfusion.com>
+- The conventions topics are short manifests with rule bullets per section and snippets over prose, and the audit checklist has one checkbox per topic section. — Nikolaus Brunner <brunner@imfusion.com>
+- An agent-tooling conventions topic covers the vendored skills, lifecycle hooks, host registrations, and the Codex trust gate, and the setup and audit skills can select it. — Nikolaus Brunner <brunner@imfusion.com>
+- Consumer projects get a conventions coverage checklist and a full post-setup audit. — Nikolaus Brunner <brunner@imfusion.com>
+- Every Web UI update refreshes the vendored agent hooks. — Nikolaus Brunner <brunner@imfusion.com>
+- Frontend setup assessments are static and reviewable, and cover data and agent tooling. — Nikolaus Brunner <brunner@imfusion.com>
+- The consumer skills build on a shared frontend conventions baseline. — Nikolaus Brunner <brunner@imfusion.com>
+- TanStack Intent guidance lives in the agent setup skill. — Nikolaus Brunner <brunner@imfusion.com>
+- The shipped skills carry updated TanStack Query usage conventions. — Nikolaus Brunner <brunner@imfusion.com>
+- Imports that reach parent directories use the `#/` alias, and lint enforces it. — Nikolaus Brunner <brunner@imfusion.com>
+- The update skill includes a consumer migration audit. — Nikolaus Brunner <brunner@imfusion.com>
+- The Logo README is revised, and Logo has an `oncolor` variant. — Nikolaus Brunner <brunner@imfusion.com>
+- The skills' commit-format guidance is tighter, and the installer prunes removed targets. — Nikolaus Brunner <brunner@imfusion.com>
+- The development skills include the blind alignment findings. — Nikolaus Brunner <brunner@imfusion.com>
+- Web UI commits and ready pull requests require a changelog entry. — Nikolaus Brunner <brunner@imfusion.com>
+- Each development and consumer skill pre-approves the tools it routinely needs. — Nikolaus Brunner <brunner@imfusion.com>
+
+---
+
+## `0.5.0` &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; 2026.08.03
+
+Initial tagged release.

package/README.md

@@ -70,17 +70,20 @@ npm run git:config
 
 The main development skills are:
 
-| Skill                            | Use it for                                       |
-| -------------------------------- | ------------------------------------------------ |
-| `/web-ui-dev-getting-started`    | Route a first task based on experience and goal. |
-| `/web-ui-dev-start`              | Establish task context and working location.     |
-| `/web-ui-dev-new-component`      | Add a primitive.                                 |
-| `/web-ui-dev-update-component`   | Change an existing primitive.                    |
-| `/web-ui-dev-design-component`   | Apply the ImFusion brand to a component.         |
-| `/web-ui-dev-story`              | Author a Storybook story.                        |
-| `/web-ui-dev-commit`             | Verify and commit a change.                      |
-| `/web-ui-dev-release`            | Prepare and ship a release.                      |
-| `/web-ui-dev-audit-docs`         | Check docs for drift before a commit.            |
-| `/web-ui-dev-claude-design-sync` | Update the design system in Claude Design.       |
-| `/web-ui-dev-teardown-worktree`  | Remove a finished worktree.                      |
-| `/web-ui-dev-mcp`                | Recover one optional MCP capability.             |
+| Skill                              | Use it for                                       |
+| ---------------------------------- | ------------------------------------------------ |
+| `/web-ui-dev-getting-started`      | Route a first task based on experience and goal. |
+| `/web-ui-dev-start`                | Establish task context and working location.     |
+| `/web-ui-dev-new-component`        | Add a primitive.                                 |
+| `/web-ui-dev-update-component`     | Change an existing primitive.                    |
+| `/web-ui-dev-design-component`     | Apply the ImFusion brand to a component.         |
+| `/web-ui-dev-story`                | Author a Storybook story.                        |
+| `/web-ui-dev-commit`               | Verify and commit a change.                      |
+| `/web-ui-dev-changelog`            | Write the changelog entry or curate a release.   |
+| `/web-ui-dev-release`              | Prepare and ship a release.                      |
+| `/web-ui-dev-audit-docs`           | Check docs for drift before a commit.            |
+| `/web-ui-dev-llm-framework`        | Keep the LLM framework diagrams in sync.         |
+| `/web-ui-dev-eval-consumer-skills` | Evaluate the shipped consumer skills.            |
+| `/web-ui-dev-claude-design-sync`   | Update the design system in Claude Design.       |
+| `/web-ui-dev-teardown-worktree`    | Remove a finished worktree.                      |
+| `/web-ui-dev-mcp`                  | Recover one optional MCP capability.             |

package/dist/components/tabs/tabs.d.ts

@@ -22,7 +22,7 @@ interface ListProps extends React.ComponentProps<typeof TabsPrimitive.List>, Var
     fill?: VariantProps<typeof tabsList>["fill"];
 }
 /** Tabs.List — the strip of Tabs.Tab triggers, plus the sliding Tabs.Indicator. */
-export declare function List({ fill, ...props }: ListProps): import("react/jsx-runtime").JSX.Element;
+export declare function List({ fill, ref, ...props }: ListProps): import("react/jsx-runtime").JSX.Element;
 export declare namespace List {
     var displayName: string;
 }

package/dist/index.js

@@ -1,5 +1,5 @@
 import { t as e } from "./chunk-DmhlhrBa.js";
-import { C as t, S as n, c as r, d as i, l as a, m as o, s, u as c } from "./tabs-By5ir2pt.js";
+import { C as t, S as n, c as r, d as i, l as a, m as o, s, u as c } from "./tabs-BS6rqrrA.js";
 import { t as l } from "./meta-j-7HGrWv.js";
 import { At as ee, GT as u, Kv as te, Ma as ne, Na as d, Pm as re, Qt as f, Qv as ie, RA as ae, Wk as oe, Xo as se, aE as ce, hn as le, iv as ue, r as p, rn as de, sn as fe, t as pe, zk as me } from "./icons-CaGCCwG-.js";
 import { a as he, o as ge, r as _e, t as ve } from "./code-D2lwxHgd.js";

package/dist/integrations/image-display-options.js

@@ -1,4 +1,4 @@
-import { _ as e, a as t, b as n, c as r, d as i, f as a, g as o, h as s, i as c, l, n as u, o as d, p as f, r as p, t as m, u as h, v as g, x as _, y as v } from "../tabs-By5ir2pt.js";
+import { _ as e, a as t, b as n, c as r, d as i, f as a, g as o, h as s, i as c, l, n as u, o as d, p as f, r as p, t as m, u as h, v as g, x as _, y as v } from "../tabs-BS6rqrrA.js";
 import { t as y } from "../meta-j-7HGrWv.js";
 import { cva as b } from "class-variance-authority";
 import { Fragment as x, jsx as S, jsxs as C } from "react/jsx-runtime";