@adia-ai/a2ui 0.8.40 → 0.8.41

package/CHANGELOG.md

@@ -4,6 +4,17 @@
 > 0.8.37 (the estate-split cut) were released under the old name and are kept
 > verbatim.
 
+## [0.8.41] — 2026-08-17
+
+### Added
+- **Surface lifecycle — pending/stale/healing (gh#1364; `spec-a2ui-surface-lifecycle.md`, ADR-0061).** `A2UIRenderer` gains regeneration brackets: `beginSurfaceUpdate(surfaceId, {generationId, reason, mode})` → `applyTo(surfaceId, messages)` (buffers while pending) → `commitSurfaceUpdate(surfaceId, generationId)` (applies the buffered bracket atomically; `async` so buffered `wireComponents` docking settles before the replace-mode sweep) / `abortSurfaceUpdate(surfaceId, generationId, error)` (stale content stays visible). Read side: `getLifecycle()`, `isPending()`, `pendingSurfaces`; state machine `empty → pending-first → live → pending-stale → error-empty/error-stale` with superseded generationIds ignored, not errored (REQ-008). `WiringEngine.undockIds()` lets the replace-mode commit sweep unwire swept component ids without tearing down the surface (REQ-004, follow-up gh#1433). `renderer.js`/`renderer.d.ts`, `wiring-engine.js`, `lifecycle.test.js`.
+- **v1.0-Candidate catch-up P0 (gh#1350).** `mcpStream` accepts the Candidate MIME `application/a2ui+json` (REQ-001; the pre-Candidate `application/json+a2ui` form is still read for the transition — `stream.js`); a duplicate `createSurface` for a live surfaceId is a HARD error with an `a2ui-duplicate-surface-id` diagnostic (REQ-002, promoted from silent last-write-wins); catalog metadata fields land in `catalog/catalog-a2ui_0_9.json`.
+- **Catalog adopts v1.0 composition constraints, ARIA live regions, and dynamic `hidden` (gh#1353, REQ-011/013/017).** Accessibility props are validated (`accessibility-props.test.js`); composition constraints ship in the catalog contract.
+
+### Changed
+- **BREAKING for raw A2UI documents only — catalog identities `AdminShell` / `UIChatThread` (gh#1427).** `admin-shell`'s catalog `component:` is now `AdminShell` (was colliding with `embed-shell`'s `AppShell`), and the `chat-thread-ui` primitive's is `UIChatThread` (was colliding with the chat module's `ChatThread`). `registry.js` maps `UIChatThread` → `chat-thread-ui`; HTML tags are unaffected. See the migration guide's [§ Shipped in `0.8.41` — A2UI catalog `component:` collision](../../../.claude/docs/MIGRATION%20GUIDE.md).
+- **Catalog regenerated for the 0.8.41 breaking wave** (`catalog/catalog-a2ui_0_9.json`, `catalog/catalog-a2ui_0_9_rules.txt`, `catalog/tier-index.json`, `catalog/tiers/l1-widgets.json`): `progress-ui[variant]` retirement, `input-ui[type]` enum trim, `segmented-ui[multiple]`, `calendar-picker-ui[precision]`, `action-item-ui` row contract, the gh#1335 attribute renames, ADR-0067 owned-`parts:` exclusion from fillable `slots:`, enum blocks + nullable schemas, and the deprecations (`ProgressRow`, `ToggleGroup`/`ToggleOption`, `DatetimePicker`) marked DEPRECATED with successor pointers in their catalog descriptions. The tier index's `composes` edges are now keyed by catalog TYPE names per R-C13 (gh#1478).
+
 ## [0.8.40] — 2026-08-15
 
 ### Maintenance

package/README.md

@@ -87,8 +87,8 @@ document listing every component, its props, and its taxonomy — enough to
 emit valid A2UI with nothing else installed. `./catalog/tiers` is the derived
 L0–L4 ladder index (L0 primitives · L1 widgets · L2 layouts · L3 shells ·
 L4 flows), under one law: **every tier-N entry is a declared composition of
-tier-(N−1) entries**. L0 is populated today; the upper rungs are reserved
-while curation lands. `./catalog/common-types` and `./catalog/functions` are
+tier-(N−1) entries**. L0 (every component) and L1 (curated widget
+compositions) are populated today; L2–L4 are reserved while curation lands. `./catalog/common-types` and `./catalog/functions` are
 the catalog's authoring sources. All of it is exported data — this package
 stays dependency-free. The harvested chunk corpus that *derives* from the
 catalog is generation fuel and lives in `@adia-ai/gen-ui`.