@adia-ai/a2ui-retrieval 0.7.19 → 0.7.20

package/CHANGELOG.md

@@ -1,5 +1,16 @@
 # Changelog — @adia-ai/a2ui-retrieval
 
+## [0.7.20] — 2026-06-10
+
+### Fixed
+- **Catalog loaders work on statically-served sites.** `component-catalog.js` + `catalog.js` gain the same static-fetch branch as the compose loaders: one consolidated `catalog-a2ui_0_9.json` request (181 component schemas) replaces the vite-only glob over 138 sidecars.
+
+### Added
+- **3 anti-pattern rules from the gen-UI contact-form incident** (these feed BOTH the generation prompt and post-validation): `noCssPropAttrs` (`display=`/`visibility=` as markup attributes — components silently ignore them, so "hidden" content renders visibly), `inputTypeTextarea` (`input-ui[type="textarea"]` → `textarea-ui`), `fieldOwnsLabelHintError` (a sibling `text-ui` label / raw `<label>` / `<small>` error inside `field-ui` → use `label=`/`hint=`/`error=`).
+
+### Fixed
+- **`noInventedComponents` known-tags list regenerated from the yaml `tag:` SoT (145 tags).** The hand-rolled list was stale — it was missing `field-ui` (a core primitive), so every canonical labeled form false-positived as an invented component.
+
 ## [0.7.19] — 2026-06-10
 
 ### Maintenance

package/anti-patterns.js

@@ -67,21 +67,36 @@ const antiPatterns = [
     check: (html) => {
       const tags = html.match(/<([a-z]+-(?:n|ui))\b/gi) || [];
       const known = new Set([
-        'row-ui', 'col-ui', 'list-ui', 'grid-ui', 'text-ui', 'image-ui',
-        'icon-ui', 'divider-ui', 'badge-ui', 'avatar-ui', 'progress-ui',
-        'skeleton-ui', 'input-ui', 'input-ui', 'check-ui', 'switch-ui',
-        'slider-ui', 'select-ui', 'datetime-ui', 'search-ui', 'upload-ui',
-        'button-ui', 'card-ui', 'tabs-ui', 'tab-ui', 'pane-ui', 'modal-ui',
-        'drawer-ui', 'toast-ui', 'popover-ui', 'stream-ui', 'form-container-ui',
-        'table-ui', 'chart-ui', 'embed-ui', 'stack-ui', 'block-ui', 'code-ui',
-        'textarea-ui', 'radio-ui', 'radio-ui', 'tag-ui', 'accordion-ui',
-        'modal-ui', 'alert-ui', 'tooltip-ui', 'menu-ui', 'breadcrumb-ui',
-        'nav-ui', 'pagination-ui', 'avatar-group-ui', 'segmented-ui',
-        'segment-ui', 'command-ui', 'command-item-ui', 'command-group-ui',
-        'calendar-picker-ui', 'color-picker-ui', 'kbd-ui', 'toolbar-ui',
-        'otp-input-ui',
-        'theme-ui', 'router-ui', 'adia-root', 'noodles-ui',
-        'listbox-ui', 'icon-provider',
+        // Regenerated 2026-06-10 from the per-component yaml `tag:` SoT
+        // (node: scan packages/web-components/components/*/*.yaml) + the
+        // runtime/infra extras below. The previous hand-rolled list was
+        // stale — it was MISSING field-ui (a core primitive), so every
+        // canonical labeled form flagged noInventedComponents.
+        'accordion-item-ui', 'accordion-ui', 'action-item-ui', 'action-list-ui', 'adia-root', 'agent-artifact-ui',
+        'agent-feedback-bar-ui', 'agent-questions-ui', 'agent-reasoning-ui', 'agent-suggestions-ui', 'agent-trace-ui', 'alert-ui',
+        'aside-ui', 'avatar-group-ui', 'avatar-ui', 'badge-ui', 'block-ui', 'blockquote-ui',
+        'breadcrumb-ui', 'button-ui', 'calendar-grid-ui', 'calendar-picker-ui', 'canvas-ui', 'card-ui',
+        'chart-legend-ui', 'chart-ui', 'chat-input-ui', 'chat-thread-ui', 'check-ui', 'code-ui',
+        'col-ui', 'color-input-ui', 'color-picker-ui', 'combobox-ui', 'command-ui', 'context-menu-ui',
+        'date-range-picker-ui', 'datetime-picker-ui', 'datetime-ui', 'demo-toggle-ui', 'description-list-ui', 'divider-ui',
+        'drawer-ui', 'embed-ui', 'empty-state-ui', 'feed-item-ui', 'feed-ui', 'field-ui',
+        'fields-ui', 'footer-ui', 'form-container-ui', 'frame-ui', 'grid-ui', 'header-ui',
+        'heatmap-ui', 'icon-provider', 'icon-ui', 'image-ui', 'inline-edit-ui', 'inline-message-ui',
+        'input-ui', 'inspector-ui', 'integration-card-ui', 'kbd-ui', 'link-ui', 'list-item-ui',
+        'list-ui', 'list-window-ui', 'listbox-ui', 'loading-overlay-ui', 'mark-ui', 'menu-divider-ui',
+        'menu-item-ui', 'menu-label-ui', 'menu-ui', 'modal-ui', 'nav-group-ui', 'nav-item-ui',
+        'nav-ui', 'noodles-ui', 'number-format-ui', 'option-card-ui', 'otp-input-ui', 'page-ui',
+        'pagination-ui', 'pane-ui', 'password-strength-ui', 'pipeline-status-ui', 'popover-ui', 'preview-ui',
+        'progress-row-ui', 'progress-ui', 'qr-code-ui', 'radio-ui', 'range-ui', 'rating-ui',
+        'relative-time-ui', 'richtext-ui', 'router-ui', 'row-ui', 'search-ui', 'section-ui',
+        'segment-ui', 'segmented-ui', 'select-ui', 'skeleton-ui', 'skip-nav-ui', 'slider-ui',
+        'spinner-ui', 'stack-ui', 'stat-ui', 'step-progress-ui', 'stepper-item-ui', 'stepper-ui',
+        'stream-ui', 'swatch-ui', 'swiper-ui', 'switch-ui', 'tab-ui', 'table-toolbar-ui',
+        'table-ui', 'tabs-ui', 'tag-ui', 'tags-input-ui', 'text-ui', 'textarea-ui',
+        'theme-provider', 'theme-ui', 'time-picker-ui', 'timeline-item-ui', 'timeline-ui', 'toast-ui',
+        'toc-ui', 'toggle-group-ui', 'toggle-option-ui', 'toggle-scheme-ui', 'toolbar-group-ui', 'toolbar-ui',
+        'tooltip-ui', 'tour-step-ui', 'tour-ui', 'tree-item-ui', 'tree-ui', 'upload-ui',
+        'visually-hidden-ui',
       ]);
       for (const match of tags) {
         const tag = match.slice(1).toLowerCase();
@@ -91,6 +106,32 @@ const antiPatterns = [
     },
     fix: 'Only use registered AdiaUI types. Check the registry for available components.',
   },
+  {
+    name: 'noCssPropAttrs',
+    description: 'CSS properties (display, visibility) are not markup attributes. Components silently ignore unknown attributes, so display="none" content renders VISIBLY — overlapping its siblings.',
+    check: /\s(?:display|visibility)\s*=\s*"/i,
+    fix: 'Remove the attribute. To hide content conditionally, omit the element from the tree (or use the component\'s documented state attribute, e.g. [hidden] on plain containers).',
+  },
+  {
+    name: 'inputTypeTextarea',
+    description: 'input-ui has no type="textarea" — multi-line input is its own component.',
+    check: /<input-ui[^>]*\btype\s*=\s*"textarea"/i,
+    fix: 'Use <textarea-ui rows="…"> for multi-line text input.',
+  },
+  {
+    name: 'fieldOwnsLabelHintError',
+    description: 'field-ui OWNS the label / hint / error chrome via its label= / hint= / error= attributes. Emitting a sibling text-ui "label", a raw <label>, or a <small> error inside field-ui double-renders and breaks the label-to-control binding (field-ui binds the first slot-less child as the control — a text-ui label steals that binding).',
+    check: (html) => {
+      // LLM-emitted label-ish children inside field-ui. The stamped internal
+      // label carries data-field-label — exclude it so post-render HTML
+      // doesn't false-positive.
+      if (/<field-ui[^>]*>\s*(?:<text-ui[^>]*variant\s*=\s*"label"|<label(?![^>]*data-field-label))/i.test(html)) return true;
+      // <small> is not an AdiaUI component anywhere; inside field-ui it is
+      // always a hand-rolled error line.
+      return /<field-ui[^>]*>[\s\S]*?<small[\s>]/i.test(html);
+    },
+    fix: 'Use <field-ui label="Full Name" hint="…" error="…"><input-ui …/></field-ui> — exactly ONE slot-less child (the control); field-ui renders the label, hint, and error itself.',
+  },
   {
     name: 'slotOnContainer',
     description: 'Slot attributes (slot="heading", slot="description", slot="action") must go on the content children inside Header/Footer, not on Header/Footer elements themselves.',

package/catalog.js

@@ -39,8 +39,19 @@ async function loadSchemas() {
       }
     } catch { /* components dir missing */ }
   } else {
+    // Browser. Vite rewrites the glob CALL at transform time; on the static
+    // deploy that call throws (no Vite — `import.meta.glob` is a compile-time
+    // macro, undefined at runtime) → we fall through to fetching the
+    // CONSOLIDATED catalog. `typeof import.meta.glob` is undefined in BOTH
+    // contexts, so the only reliable discriminator is whether the CALL
+    // produced loaders. See composition-library.js for the full rationale.
+    let modules = null;
     try {
-      const modules = import.meta.glob('../../web-components/components/*/*.a2ui.json', { query: '?raw', import: 'default' });
+      modules = import.meta.glob('../../web-components/components/*/*.a2ui.json', { query: '?raw', import: 'default' });
+    } catch { /* no Vite transform — static deploy */ }
+
+    if (modules && Object.keys(modules).length > 0) {
+      // Vite dev — iterate the glob loaders.
       for (const [, loader] of Object.entries(modules)) {
         try {
           const raw = await loader();
@@ -49,7 +60,26 @@ async function loadSchemas() {
           if (tag) schemaByTag.set(tag, schema);
         } catch { /* skip invalid */ }
       }
-    } catch { /* glob not available */ }
+    } else {
+      // Static deploy — fetch the consolidated catalog once. Its `components`
+      // values carry the same `x-adiaui.tag` shape as the per-component
+      // sidecars (2026-06-10). Relative-to-module so it resolves under any
+      // mount point + the dist symlink layout.
+      try {
+        const url = new URL('../corpus/catalog-a2ui_0_9.json', import.meta.url);
+        const res = await fetch(url);
+        if (res.ok) {
+          const catalog = await res.json();
+          const comps = catalog?.components;
+          if (comps && typeof comps === 'object') {
+            for (const schema of Object.values(comps)) {
+              const tag = tagFromSchema(schema);
+              if (tag) schemaByTag.set(tag, schema);
+            }
+          }
+        }
+      } catch { /* consolidated catalog not present */ }
+    }
   }
 }
 

package/component-catalog.js

@@ -24,7 +24,12 @@ const _componentData = new Map();
 let _loaded = false;
 let _loadPromise = null;
 
-// Vite resolves this at build time; at runtime in Node the variable is unused.
+// Vite rewrites this CALL at transform time. On the static deploy the call
+// throws (no Vite) → `_globA2UIModules` null → fetch the CONSOLIDATED
+// catalog (one request) instead of 138 per-component sidecars.
+// `import.meta.glob` is a compile-time macro (undefined at runtime in both
+// Vite and static) — the only reliable discriminator is whether the CALL
+// produced loaders. See composition-library.js for the full rationale.
 let _globA2UIModules = null;
 if (!IS_NODE) {
   try {
@@ -33,9 +38,20 @@ if (!IS_NODE) {
       import: 'default',
     });
   } catch {
-    // Not in a Vite context — no component data
+    // No Vite transform here (static deploy) — fall through to the fetch branch.
   }
 }
+const HAS_VITE_GLOB =
+  !IS_NODE && !!_globA2UIModules && Object.keys(_globA2UIModules).length > 0;
+
+// Static-deploy source: the consolidated catalog co-located in the corpus.
+// Its `components` map values are byte-shape-identical to the standalone
+// `.a2ui.json` sidecars (verified 2026-06-10), so one fetch replaces 138.
+// Relative-to-module from retrieval/ → ../a2ui-corpus is `../corpus/`.
+const _CONSOLIDATED_CATALOG_URL =
+  !IS_NODE && !HAS_VITE_GLOB
+    ? new URL('../corpus/catalog-a2ui_0_9.json', import.meta.url)
+    : null;
 
 async function _loadNode() {
   const fs = await import(/* @vite-ignore */ 'node:fs/promises');
@@ -103,12 +119,29 @@ async function _loadBrowser() {
   }
 }
 
+async function _loadStatic() {
+  if (!_CONSOLIDATED_CATALOG_URL) return;
+  try {
+    const res = await fetch(_CONSOLIDATED_CATALOG_URL);
+    if (!res.ok) return;
+    const catalog = await res.json();
+    const comps = catalog?.components;
+    if (!comps || typeof comps !== 'object') return;
+    for (const data of Object.values(comps)) {
+      if (data?.title) _componentData.set(data.title, data);
+    }
+  } catch {
+    // Consolidated catalog not present / unparseable — leave empty.
+  }
+}
+
 export async function loadCatalog() {
   if (_loaded) return;
   if (_loadPromise) return _loadPromise;
   _loadPromise = (async () => {
     if (IS_NODE) await _loadNode();
-    else await _loadBrowser();
+    else if (HAS_VITE_GLOB) await _loadBrowser();
+    else await _loadStatic();
   })();
   await _loadPromise;
   _loaded = true;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adia-ai/a2ui-retrieval",
-  "version": "0.7.19",
+  "version": "0.7.20",
   "description": "AdiaUI A2UI retrieval layer \u2014 catalog lookup, intent classification, domain routing, pattern + anti-pattern matching, clarity + context assembly. Consumed by the compose engine and any A2UI-protocol tooling that needs to reason about user intent against the catalog.",
   "type": "module",
   "main": "./index.js",