@adia-ai/a2ui-compose 0.5.4 → 0.5.5

package/CHANGELOG.md

@@ -12,6 +12,22 @@ generator graph.
 
 _No pending changes._
 
+## [0.5.5] - 2026-05-14
+
+### Changed — §179 (v0.5.5) — principled `deprecated:` yaml field
+
+Three new yaml schema fields under each prop:
+
+- **`deprecated`** (boolean, default `false`) — when `true`, the LLM prompt builder appends `(deprecated, do not use)` to the prop's line in CORPUS CONTEXT.
+- **`deprecated_since`** (string) — version when deprecation was introduced.
+- **`deprecated_reason`** (string) — human-readable migration guidance.
+
+Build pipeline (`scripts/build/components.mjs::compileProp`) collects deprecation metadata and inlines onto the prop schema. Prompt builder (`packages/a2ui/compose/strategies/monolithic/_shared.js`) reads `v.deprecated === true` FIRST; falls back to `/deprecated/i.test(v.description)` (the v0.5.4 §167a substring detection) for back-compat. Existing §167a-tagged props continue to work without yaml changes.
+
+Demonstrated on `Avatar.name`. Verified via `buildSystemPrompt`: `name:String[] (deprecated, do not use)` surfaces in CORPUS CONTEXT.
+
+Commit `0379dd498`. See root CHANGELOG and journal §179 for full context.
+
 ## [0.5.4] - 2026-05-14
 
 ### Fixed — §163 transpiler prop-fidelity; catalog-driven extractor closes the harvester drop class (v0.5.4)

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@adia-ai/a2ui-compose",
-  "version": "0.5.4",
-  "description": "AdiaUI A2UI compose engine — framework-agnostic. Takes natural-language intents + a catalog and produces A2UI protocol messages. Pairs with `@adia-ai/a2ui-retrieval` (intent classification, catalog lookup) and `@adia-ai/a2ui-validator` (schema + semantic checks).",
+  "version": "0.5.5",
+  "description": "AdiaUI A2UI compose engine \u2014 framework-agnostic. Takes natural-language intents + a catalog and produces A2UI protocol messages. Pairs with `@adia-ai/a2ui-retrieval` (intent classification, catalog lookup) and `@adia-ai/a2ui-validator` (schema + semantic checks).",
   "type": "module",
   "exports": {
     ".": "./index.js",

package/strategies/monolithic/_shared.js

@@ -307,7 +307,8 @@ KEY RULES:
           // but never read here, so deprecated props (Avatar.name, Field.persist
           // alias, etc.) looked indistinguishable from canonical props. LLM
           // would pick e.g. <avatar-ui name="..."> instead of text="...".
-          if (v.description && /deprecated/i.test(v.description)) desc += ' (deprecated, do not use)';
+          // §179 (v0.5.5): principled `deprecated:` field wins; falls back to §167a substring detection for back-compat.
+          if (v.deprecated === true || (v.description && /deprecated/i.test(v.description))) desc += ' (deprecated, do not use)';
           return desc;
         }).join(', ') : '';
         const events = a2uiData.events?.length ? ` events: ${a2uiData.events.join(', ')}` : '';
@@ -350,7 +351,8 @@ KEY RULES:
           // but never read here, so deprecated props (Avatar.name, Field.persist
           // alias, etc.) looked indistinguishable from canonical props. LLM
           // would pick e.g. <avatar-ui name="..."> instead of text="...".
-          if (v.description && /deprecated/i.test(v.description)) desc += ' (deprecated, do not use)';
+          // §179 (v0.5.5): principled `deprecated:` field wins; falls back to §167a substring detection for back-compat.
+          if (v.deprecated === true || (v.description && /deprecated/i.test(v.description))) desc += ' (deprecated, do not use)';
           return desc;
         }).join(', ') : '';
         const events = comp.events?.length ? ` events: ${comp.events.join(', ')}` : '';