@adia-ai/web-modules 0.7.26 → 0.7.28

package/CHANGELOG.md

@@ -1,4 +1,16 @@
 # Changelog — @adia-ai/web-modules
+## [0.7.28] — 2026-07-14
+
+### Fixed — GH #223, editor-sidebar `expand()` permanent wedge
+- **`editor/editor-sidebar/editor-sidebar.js` — `expand()` no longer permanently wedges after its own transition.** `expand()` sets the pane's target width, kicking off `pane-ui`'s own CSS width transition (`editor-shell.bespoke.css`). Early `ResizeObserver` samples mid-transition are legitimately still `<= SNAP_THRESHOLD` while animating TOWARD the (above-threshold) target — `#syncCollapsed()` couldn't tell that apart from a genuine drag-to-collapse settle, so it flipped `[collapsed]` back to `true` mid-flight. That re-matches the `!important` collapsed-width CSS rule, which snaps the pane straight back to 48px and permanently interrupts the transition — no further resize ever occurs to self-correct, making `expand()`/`toggle()` silent no-ops thereafter. Fixed with an `#expandInFlight` flag (set by `expand()`, cleared by the pane's own `transitionend` — or a bounded fallback timer sized to the actual computed transition-duration, in case an interrupted transition doesn't fire `transitionend`) that suppresses collapse-inference for the duration of an explicit `expand()`'s own transition; a genuinely small sample is trusted normally once the flag clears. New tests: 6 cases (mid-transition suppression, `transitionend` settling + resumed normal inference afterward, the timer fallback, the zero-duration no-transition-to-race case).
+
+### Maintenance
+- **`dist/everything.min.js` rebuilt** to inline the `editor-sidebar.js` fix above.
+
+## [0.7.27] — 2026-07-12
+
+### Lockstep
+Ride-along PATCH cut — no source changes this cycle. `dist/` shell bundles regenerated alongside the `@adia-ai/web-components` core fixes they inline (router navigation token, markdown code-span protection).
 
 ## [0.7.26] — 2026-07-04
 
@@ -1071,7 +1083,7 @@ Internal `@adia-ai/*` dep ranges stay at `^0.4.0` (patch-cut asymmetry — `^0.4
 
 ### Added
 
-- **`<theme-panel>` module — new `theme/` cluster.** Module-tier appearance-preferences control surface. Owns the three knobs of the AdiaUI theming contract: `[theme]` named themes (8 built-in slugs + tolerant for custom), `--a-density` / `--a-radius-k` parametric overrides, and `color-scheme` light/dark switching, plus optional `localStorage` persistence behind a small attribute API ([`packages/web-modules/theme/theme-panel/`](./theme/theme-panel/)). Reflected state — `[active-theme]`, `[active-scheme]`, `[active-density]`, `[active-radius]` — lets external CSS / JS react via `:has(theme-panel[active-scheme="dark"])` patterns without listening to events. One `theme-change` event per user-visible change (source ∈ `theme | slider | preset | scheme | reset | programmatic`). Attribute API: `[themes="slug1 slug2…"]` (override default 8), `[parametric]` (renders density + radius sliders), `[presets]` (renders compact / reset / spacious preset row), `[scheme-toggle]` (renders inline light/dark toggle — absorbs the legacy standalone `#theme-toggle` button per OD-002=A). 23 unit tests. Promoted from the ~30-line inline `#theme-panel` block + ~90 LOC of controller wiring previously duplicated in `site/index.html` and `playgrounds/admin-shell/`. Spec: [`.claude/docs/specs/theme-panel-module.md`](../../.claude/docs/specs/theme-panel-module.md). Plan: [`.claude/docs/plans/theme-panel-module-2026-05-11.md`](../../.claude/docs/plans/theme-panel-module-2026-05-11.md). Commits `63d9deb4` (module Phase 1) + `a35d3131` (site consumer migration Phase 2; site.js −90 LOC + index.html −27 inline lines) + `c844aef4` (admin-shell playground consumer migration Phase 3; contents.html −25 lines + contents.js −48 LOC).
+- **`<theme-panel>` module — new `theme/` cluster.** Module-tier appearance-preferences control surface. Owns the three knobs of the AdiaUI theming contract: `[theme]` named themes (8 built-in slugs + tolerant for custom), `--a-density` / `--a-radius-k` parametric overrides, and `color-scheme` light/dark switching, plus optional `localStorage` persistence behind a small attribute API ([`packages/web-modules/theme/theme-panel/`](./theme/theme-panel/)). Reflected state — `[active-theme]`, `[active-scheme]`, `[active-density]`, `[active-radius]` — lets external CSS / JS react via `:has(theme-panel[active-scheme="dark"])` patterns without listening to events. One `theme-change` event per user-visible change (source ∈ `theme | slider | preset | scheme | reset | programmatic`). Attribute API: `[themes="slug1 slug2…"]` (override default 8), `[parametric]` (renders density + radius sliders), `[presets]` (renders compact / reset / spacious preset row), `[scheme-toggle]` (renders inline light/dark toggle — absorbs the legacy standalone `#theme-toggle` button per OD-002=A). 23 unit tests. Promoted from the ~30-line inline `#theme-panel` block + ~90 LOC of controller wiring previously duplicated in `site/index.html` and `playgrounds/admin-shell/`. Spec: [`.claude/docs/specs/theme-panel-module.md`](../../.claude/docs/specs/theme-panel-module.md). Plan: `.claude/docs/plans/theme-panel-module-2026-05-11.md`. Commits `63d9deb4` (module Phase 1) + `a35d3131` (site consumer migration Phase 2; site.js −90 LOC + index.html −27 inline lines) + `c844aef4` (admin-shell playground consumer migration Phase 3; contents.html −25 lines + contents.js −48 LOC).
 - **New subpath export `@adia-ai/web-modules/theme`** — consumers wanting just this cluster can `import '@adia-ai/web-modules/theme'` instead of the full barrel. `package.json` `exports` / `files` / `sideEffects` updated.
 
 ### Fixed
@@ -1097,7 +1109,7 @@ Internal `@adia-ai/*` dep ranges stay at `^0.4.0` (patch-cut asymmetry — `^0.4
 - Catalog count: 118 → 121 yamls (+3 from simple cluster children).
 ## [0.4.0] - 2026-05-10
 
-**⚠️ BREAKING** — first non-patch release in the 0.x line. Closes the ADR-0023 arc per [ADR-0024](../../.brain/adrs/0024-legacy-shell-shapes-retired.md). All 6 in-repo consumers migrated in v0.3.6; this release retires the legacy authoring shapes from the shell hosts.
+**⚠️ BREAKING** — first non-patch release in the 0.x line. Closes the ADR-0023 arc per `ADR-0024`. All 6 in-repo consumers migrated in v0.3.6; this release retires the legacy authoring shapes from the shell hosts.
 
 ### Removed (BREAKING)
 
@@ -1403,7 +1415,7 @@ instead of viewport width. No BREAKING changes.
 
 ⚠️ **BREAKING** — nav family removed (consolidated into
 `@adia-ai/web-components` as primitives per
-[ADR-0015 § Nav consolidation](../../.brain/adrs/0015-three-tier-naming-convention.md)).
+`ADR-0015 § Nav consolidation`).
 
 ### Removed — ⚠️ BREAKING
 
@@ -1458,7 +1470,7 @@ work in this package beyond the deletions above.
 ## [0.0.3] — 2026-05-01
 
 ⚠️ **BREAKING** — class-naming-convention sweep per
-[ADR-0016](../../.brain/adrs/0016-class-naming-convention.md).
+`ADR-0016`.
 Module classes drop the `Adia` prefix. Tag names + CSS unchanged
 from 0.0.2; this is purely a class-name rename.
 
@@ -1557,7 +1569,7 @@ no longer resolves there.
 ## [0.0.2] — 2026-05-01
 
 ⚠️ **BREAKING** — naming-convention sweep per
-[ADR-0015](../../.brain/adrs/0015-three-tier-naming-convention.md).
+`ADR-0015`.
 Modules use the new `<namespace-thing>` two-word convention; the
 `adia-` brand prefix and the doubled `-ui-ui` form are retired.
 Cluster directories renamed in lockstep with the element renames.
@@ -1637,7 +1649,7 @@ don't change.
 
 Initial extraction from `@adia-ai/web-components/patterns/`. Captures
 the three-tier architecture decision in
-[ADR-0012](../../.brain/adrs/0012-three-tier-architecture-modules.md).
+`ADR-0012`.
 
 ### Migrated from `@adia-ai/web-components/patterns/`
 

package/README.md

@@ -112,7 +112,7 @@ See the [CDN usage guide](https://ui-kit.exe.xyz/site/cdn-usage) for a full Code
 
 ### Using with AI agents
 
-When composing UI with an AI coding agent (Claude Code / Cursor / Windsurf / Claude Desktop), load the **`adia-ui-kit` skill** in the harness — it encodes the 95-primitive catalog, composition patterns for all shells (admin / chat / editor / simple), and the Plan-Execute-Verify discipline that renders the composed surface in a real demo to verify intent. Skill lives at [`.agents/skills/adia-ui-kit/`](https://github.com/adiahealth/gen-ui-kit/tree/main/.agents/skills/adia-ui-kit) in the repo.
+When composing UI with an AI coding agent (Claude Code / Cursor / Windsurf / Claude Desktop), load the **`adia-ui-kit` skill** in the harness — it encodes the 95-primitive catalog, composition patterns for all shells (admin / chat / editor / simple), and the Plan-Execute-Verify discipline that renders the composed surface in a real demo to verify intent. Skill lives at [`.agents/skills/adia-compose/`](https://github.com/adiahealth/gen-ui-kit/tree/main/.agents/skills/adia-ui-kit) in the repo.
 
 `@adia-ai/web-components` is **always required** (modules compose primitives at runtime). Two additional peer dependencies are declared but **only needed for specific clusters**:
 
@@ -184,18 +184,18 @@ equivalent of `import '@adia-ai/web-modules/shell'` +
 `import '@adia-ai/web-modules/shell/admin-shell.css'`.
 
 The default `@adia-ai/web-modules/shell` subpath stays CSS-free to
-preserve the explicit-import contract ([ADR-0030](../../.brain/adrs/0030-shell-with-css-opt-in-carve-out.md));
+preserve the explicit-import contract (`ADR-0030`);
 `/with-css` is the named opt-in. Per-element companions
 (`@adia-ai/web-modules/shell/admin-shell/with-css`) also exist for
 finer-grained imports.
 
 Each cluster carries a **shell host** (behavior-only orchestrator) plus
 a **family of bespoke shell-tier children** (cluster-namespaced custom
-elements with state-as-attribute semantics) per [ADR-0023](../../.brain/adrs/0023-bespoke-shell-tier-children.md). The bespoke vocabulary is the only recognized authoring shape since v0.4.0 ([ADR-0024](../../.brain/adrs/0024-legacy-shell-shapes-retired.md)).
+elements with state-as-attribute semantics) per `ADR-0023`. The bespoke vocabulary is the only recognized authoring shape since v0.4.0 (`ADR-0024`).
 
 > The patterns directory lived inside `@adia-ai/web-components` as
 > `patterns/` until this package was extracted (see
-> [ADR-0012](../../.brain/adrs/0012-three-tier-architecture-modules.md)).
+> `ADR-0012`).
 > Tags, CSS, and YAML/A2UI contracts are unchanged; only the import
 > path moves.
 
@@ -223,7 +223,7 @@ hunt for it:
 Future clusters on the strategic horizon: `data` (kanban, filters,
 table-toolbar), `agent` (agent-trace, reasoning panels).
 
-See [`adia-ui-authoring` skill, `references/shell-patterns.md`](../../.agents/skills/adia-ui-authoring/references/shell-patterns.md) (absorbed `bespoke-shell-children`) for the canonical decomposition recipe used by all three families.
+See [`adia-ui-authoring` skill, `references/shell-patterns.md`](../../.agents/skills/adia-author/references/shell-patterns.md) (absorbed `bespoke-shell-children`) for the canonical decomposition recipe used by all three families.
 
 ## Quick start
 
@@ -288,12 +288,12 @@ Then in your markup (bespoke shape, canonical since v0.4.0):
 Modules and themes both peer-depend `web-components` directly; they
 do not import each other. Composition happens at the consumer's
 site, not inside the library. See
-[ADR-0012](../../.brain/adrs/0012-three-tier-architecture-modules.md)
+`ADR-0012`
 for the rationale and the patterns/modules collapse.
 
 ## Migration from `@adia-ai/web-components/patterns`
 
-The `patterns/` directory was extracted from `@adia-ai/web-components` into this package in v0.0.29 ([ADR-0012](../../.brain/adrs/0012-three-tier-architecture-modules.md)). If you're upgrading from a pre-v0.0.29 release:
+The `patterns/` directory was extracted from `@adia-ai/web-components` into this package in v0.0.29 (`ADR-0012`). If you're upgrading from a pre-v0.0.29 release:
 
 ```diff
 - import '@adia-ai/web-components/patterns/app-shell/app-shell.js';
@@ -303,7 +303,7 @@ The `patterns/` directory was extracted from `@adia-ai/web-components` into this
 + import '@adia-ai/web-modules/chat';
 ```
 
-CSS paths shift the same way. Tag names + class names also changed in v0.0.31 (ADR-0015 — `<app-shell-ui>` → `<admin-shell>`, `<adia-chat-ui>` → `<chat-shell>`, `<adia-editor-ui>` → `<editor-shell>`, `<gen-ui-ui>` → `<gen-root>`) and v0.0.32 (ADR-0016 — module classes drop the `Adia` prefix). And the legacy authoring shapes (`<aside-ui slot>`, `<section data-chat-messages>`, etc.) were retired in v0.4.0 in favor of the bespoke vocabulary — see [ADR-0024](../../.brain/adrs/0024-legacy-shell-shapes-retired.md) for the full migration recipe.
+CSS paths shift the same way. Tag names + class names also changed in v0.0.31 (ADR-0015 — `<app-shell-ui>` → `<admin-shell>`, `<adia-chat-ui>` → `<chat-shell>`, `<adia-editor-ui>` → `<editor-shell>`, `<gen-ui-ui>` → `<gen-root>`) and v0.0.32 (ADR-0016 — module classes drop the `Adia` prefix). And the legacy authoring shapes (`<aside-ui slot>`, `<section data-chat-messages>`, etc.) were retired in v0.4.0 in favor of the bespoke vocabulary — see `ADR-0024` for the full migration recipe.
 
 ## Layout
 
@@ -347,7 +347,7 @@ All `<*-shell>` hosts are **behavior-only orchestrators** — they reflect state
 - **JS-bearing children** carry `connected()`/`disconnected()` lifecycle for interactive behavior (`admin-sidebar` resize, `admin-command` palette, `chat-thread` streaming scroll, `editor-canvas` zoom, etc.).
 - **CSS-only children** (no `.js` file — only `.yaml` + `.css` + `.a2ui.json`) declare slot intent for the host's styling system to attach against. Don't author a `.js` for these; the host handles their behavior via attribute selectors.
 
-The decomposition recipe (when to JS-bearing vs CSS-only, how to namespace state attributes, slot vocabulary conventions) is captured in the [`adia-ui-authoring` skill, `references/shell-patterns.md`](../../.agents/skills/adia-ui-authoring/references/shell-patterns.md) (absorbed `bespoke-shell-children`).
+The decomposition recipe (when to JS-bearing vs CSS-only, how to namespace state attributes, slot vocabulary conventions) is captured in the [`adia-ui-authoring` skill, `references/shell-patterns.md`](../../.agents/skills/adia-author/references/shell-patterns.md) (absorbed `bespoke-shell-children`).
 
 ## License