@adia-ai/gen-ui 0.8.40 → 0.8.41

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # Changelog — @adia-ai/gen-ui
 
+## [0.8.41] — 2026-08-17
+
+### Fixed
+- **Union-typed catalog props (nullable number/object) coerce again (gh#1425, regression from gh#1329's PR #1418).** A nullable prop's catalog `type` is a JSON Schema UNION (`["number","null"]`, `["object","null"]`) — every `pdef.type === 'x'` strict-equality check in the transpiler's `extractCatalogProps()` type dispatch never matched the array form, so nullable props of ANY declared type (Progress.value, Input/Select's min/max/minlength/maxlength/precision, Chart.cornerRadius, InvoiceDetail.invoice, NotificationPreferences.channelEnabled) silently fell through to the catch-all string branch. New `hasType()`/`isNumberType()` in `compose/transpiler/transpiler-maps.js` matches both forms uniformly, closing the bug class for booleans/numbers/arrays/objects at once. The same file also stops `search-ui`'s self-referencing alias from claiming the reverse-registry slot, so the docs transpiler emits `"component": "Search"` again.
+- **Category map derived from yaml, recursively, across both component trees (gh#1363 B9 + gh#1380, ADR-0065).** `retrieval/catalog.js` scanned only `components/<dir>/<dir-name>.a2ui.json`, missing family sidecars (`feed/feed-item.a2ui.json`, `tabs/tab.a2ui.json`) and the entire web-modules composite tree — every missed component silently defaulted its category to `other`. The scan is now recursive over both roots, and the engine's `categoryMap` derives from the ratified yaml category vocabulary instead of a hand-kept list.
+
+### Changed
+- **Corpus re-harvested for the 0.8.41 catalog wave (gh#764 re-harvests + gh#1382 wave 1).** Four corpus-invisible components gain harvested chunks; the spinner/progress, date-time-picker, and toggle-family chunks re-harvested against the post-consolidation markup (`progress-ui[variant]` retirement, `calendar-picker-ui[precision]`, `segmented-ui[multiple]`); `corpus/chunks/_index.json` + `corpus/chunk-embeddings.json` regenerated. Generated artifacts — regenerated, not hand-edited.
+
+### Maintenance
+- **`validate/` touched in this release window** (1 file(s), e.g. `validate/catalog-package-load.test.js`) — carried by the entries above.
+
 ## [0.8.40] — 2026-08-15
 
 ### Maintenance

package/README.md

@@ -7,7 +7,7 @@ One-way dependency: `gen-ui → a2ui`. This package produces A2UI documents;
 `@adia-ai/a2ui` is the protocol runtime that renders them. Nothing here is
 required to *render* A2UI — only to *generate* it.
 
-Minted by [ADR-0048](../../../docs/adr/adr-0048-a2ui-gen-ui-estate-split.md) by
+Minted by [ADR-0048](../../../docs/ops/adr/adr-0048-a2ui-gen-ui-estate-split.md) by
 folding together four previously separate packages.
 
 ## What's inside

package/compose/transpiler/transpiler-maps.js

@@ -137,6 +137,34 @@ const TYPE_ALIAS = (() => {
   return m;
 })();
 
+/**
+ * gh#1425 (regression from gh#1329/PR #1418): a nullable prop's catalog
+ * `type` is a JSON Schema type UNION — e.g. `["number", "null"]`,
+ * `["object", "null"]` — not a bare string. Every `pdef.type === 'x'`
+ * strict-equality check in extractCatalogProps()'s type dispatch below
+ * never matched the array form, so a nullable prop of ANY declared type
+ * (numeric — Progress.value, Input/Select's maxlength/minlength/min/max/
+ * precision, Chart.cornerRadius; object — InvoiceDetail.invoice,
+ * NotificationPreferences.channelEnabled) silently fell through to the
+ * catch-all string branch instead of being coerced/parsed. `hasType()`
+ * matches a type name against either the bare-string form or an array
+ * containing it; every branch below uses it uniformly so this bug class
+ * closes for booleans/numbers/arrays/objects at once, not just numbers.
+ *
+ * @param {{type?: string|string[]}} pdef — catalog prop schema
+ * @param {...string} names — type name(s) to match against
+ * @returns {boolean}
+ */
+function hasType(pdef, ...names) {
+  if (typeof pdef.type === 'string') return names.includes(pdef.type);
+  return Array.isArray(pdef.type) && pdef.type.some((t) => names.includes(t));
+}
+
+/** Numeric-prop convenience wrapper — gh#1425's own named fix target. */
+export function isNumberType(pdef) {
+  return hasType(pdef, 'number', 'integer');
+}
+
 /**
  * §163 generic extractor: pull every catalog-declared prop from the
  * element's attributes. Type-aware (booleans become true on presence,
@@ -170,18 +198,18 @@ function extractCatalogProps(el, a2uiType) {
     const raw = attr(pname) ?? (kebab !== pname ? attr(kebab) : null);
     if (raw === null || raw === undefined) continue;
 
-    if (pdef.type === 'boolean') {
+    if (hasType(pdef, 'boolean')) {
       // HTML boolean attr convention: presence (incl. empty string) = true.
       //   <input required>            → raw === ''      → true
       //   <input required="">         → raw === ''      → true
       //   <input required="required"> → raw === 'required' → true
       //   <input required="false">    → raw === 'false' → false (defensive)
       props[pname] = raw !== 'false';
-    } else if (pdef.type === 'number' || pdef.type === 'integer') {
+    } else if (isNumberType(pdef)) {
       if (raw === '') continue;
       const n = Number(raw);
       props[pname] = Number.isFinite(n) ? n : raw;
-    } else if (pdef.type === 'array') {
+    } else if (hasType(pdef, 'array')) {
       // TKT-0010: declarative JSON-array attribute (e.g. chart-ui/table-ui's
       // data='[{...}]'), hydrated once at connect per those components' own
       // yaml docs. Parse it — the raw string never satisfies the catalog's
@@ -193,7 +221,7 @@ function extractCatalogProps(el, a2uiType) {
         const parsed = JSON.parse(raw);
         if (Array.isArray(parsed)) props[pname] = parsed;
       } catch { /* not valid JSON — skip */ }
-    } else if (pdef.type === 'object') {
+    } else if (hasType(pdef, 'object')) {
       // gh#853 sibling of the array branch above: object-typed props (e.g.
       // InvoiceDetail.invoice, NotificationPreferences.channelEnabled) are
       // JSON-encoded HTML attributes too — same declarative-data convention,
@@ -217,6 +245,19 @@ function extractCatalogProps(el, a2uiType) {
 const ALIAS_TYPES = new Set([
   'Select', 'LoadingIndicator', 'ErrorContainer', 'Keyboard',
   'DatePicker', 'CommandPalette', 'Segmented', 'OTP', 'SideNav', 'IconSource',
+  // 'search-ui' — registry.js's "AgentUI Aliases (backwards compat with
+  // -ui tags)" block registers the tag name itself as a self-referencing
+  // type (`['search-ui', 'search-ui']`) ahead of the real canonical
+  // `['Search', 'search-ui']` entry later in the file — first-write-wins
+  // let the alias claim the reverse-registry slot, so the docs transpiler
+  // emitted `"component": "search-ui"` instead of `"component": "Search"`
+  // for any harvested chunk composing <search-ui> directly (gh#1381 PR
+  // #1414 review — packages/gen-ui/engine/corpus/chunks/
+  // members-active-table-search-filter.json). Forward resolution
+  // (`resolveTag('search-ui')`) is untouched — this only reorders which
+  // type wins the REVERSE (tag → canonical type) lookup, same mechanism
+  // already used for 'Select' above.
+  'search-ui',
 ]);
 
 // ── Reverse Registry: tag → primary A2UI type ────────────────────────────