@adia-ai/a2ui-corpus 0.8.4 → 0.8.6

package/CHANGELOG.md

@@ -1,6 +1,16 @@
 # Changelog — @adia-ai/a2ui-corpus
 
-## [Unreleased]
+## [0.8.6] — 2026-07-18
+
+### Maintenance
+- **Lockstep version bump only.** No source changes in this package; bumped to maintain the 11-package version coherence enforced by `scripts/release/check-lockstep.mjs`. Substantive v0.8.6 work shipped in SSR attribute-replay fix + table declarative data + token repoints (@adia-ai/web-components), gh#268 forge modernization campaign (adia-forge). See `packages/web-components/CHANGELOG.md#086--2026-07-18` for details.
+
+## [0.8.5] — 2026-07-17
+
+### Changed
+- **Full chunk corpus + embedding index rebuilt** (`chunks/*.json`, `chunk-embeddings.json`, `manifest.json`, `_index.json`): `npm run harvest:chunks` + `npm run build:embeddings:chunks` re-run to pick up the accumulated site/component-surface changes since v0.8.4 (the gh issue 276 wave-4 `button-ui`/`option-card-ui` migrations, `<adia-mark-ui>`, the `kbd-ui` A2UI-render fix) — `check:chunks-fresh` and `check:embeddings-fresh` were red against the stale index before this regen. No manual chunk edits; content-hash-driven, deterministic re-derivation.
+
+## [0.8.4] — 2026-07-16
 
 ### Changed
 - **Catalog `composes` entries regenerated** for the gh#276 button-ui migrations: `select-ui`, `tag-ui`, `swatch-ui`, `timeline-ui`, `chat-input-ui`, and `combobox-ui` now declare `button-ui` (plus combobox's previously undeclared `spinner-ui`) so generated compositions know the stamped dependency set.

package/catalog-a2ui_0_9.json

@@ -569,6 +569,127 @@
         "version": 1
       }
     },
+    "AdiaMark": {
+      "title": "AdiaMark",
+      "description": "The Adia brand mark — a rounded square with the \"Adia\" wordmark cut out in a contrasting color. Token-driven: the background always reads as the current scheme's inverse surface, and the wordmark always reads as the current scheme's inverse foreground, so a single asset replaces separate light/dark/transparent static exports (gh#283). Not an `icon-ui` registry entry — icon-ui is the Phosphor-glyph registry only; this is a fixed, one-off brand image, a separate delivery shape.",
+      "type": "object",
+      "allOf": [
+        {
+          "$ref": "#/$defs/ComponentCommon"
+        },
+        {
+          "$ref": "#/$defs/CatalogComponentCommon"
+        }
+      ],
+      "properties": {
+        "component": {
+          "const": "AdiaMark"
+        },
+        "inline": {
+          "description": "Renders as `display:inline-block` instead of the block-level default (ADR-0037) — set this when the mark sits beside a text run (a topbar brand slot) rather than standing alone.",
+          "type": "boolean",
+          "default": false
+        },
+        "size": {
+          "description": "Diameter of the square mark. Matches avatar-ui's size ladder for visual consistency when the two sit side by side (e.g. an app switcher row).",
+          "type": "string",
+          "enum": [
+            "xs",
+            "sm",
+            "md",
+            "lg",
+            "xl"
+          ],
+          "default": "md"
+        }
+      },
+      "required": [
+        "component"
+      ],
+      "unevaluatedProperties": false,
+      "x-adiaui": {
+        "anti_patterns": [
+          {
+            "fix": "<adia-mark-ui size=\"sm\"></adia-mark-ui>\n",
+            "why": "icon-ui only resolves Phosphor glyph names from the registry; there\nis no \"adia\" Phosphor icon, and registering one would misuse a\nthird-party glyph set for a proprietary brand mark.\n",
+            "wrong": "<icon-ui name=\"adia\"></icon-ui>\n"
+          },
+          {
+            "fix": "<adia-mark-ui size=\"sm\"></adia-mark-ui>\n",
+            "why": "Hardcoding the fill colors defeats the entire point of gh#283 —\nthe mark is supposed to track the inverse-surface/inverse-foreground\ntokens automatically across scheme changes, not be pinned to one\nscheme's static values.\n",
+            "wrong": "<adia-mark-ui style=\"--adia-mark-bg: #171818; --adia-mark-fg: #E2E3E4;\"></adia-mark-ui>\n"
+          }
+        ],
+        "category": "display",
+        "composes": [],
+        "events": {},
+        "examples": [
+          {
+            "description": "Small brand mark in an admin-shell topbar, beside the product name.",
+            "a2ui": "[\n  {\n    \"id\": \"brand-row\",\n    \"component\": \"Row\",\n    \"gap\": \"2\",\n    \"align\": \"center\",\n    \"children\": [\"mark\", \"name\"]\n  },\n  {\n    \"id\": \"mark\",\n    \"component\": \"AdiaMark\",\n    \"size\": \"sm\"\n  },\n  {\n    \"id\": \"name\",\n    \"component\": \"Text\",\n    \"variant\": \"heading\",\n    \"text\": \"Adia\"\n  }\n]",
+            "name": "topbar-brand-mark"
+          }
+        ],
+        "keywords": [
+          "adia",
+          "brand",
+          "logo",
+          "wordmark",
+          "mark",
+          "identity",
+          "favicon"
+        ],
+        "name": "UIAdiaMark",
+        "related": [
+          "Icon",
+          "Avatar",
+          "Image"
+        ],
+        "slots": {},
+        "states": [
+          {
+            "description": "The only state — a static, non-interactive brand mark.",
+            "name": "default"
+          }
+        ],
+        "status": "stable",
+        "synonyms": {
+          "brand": [
+            "adia",
+            "logo",
+            "mark",
+            "identity"
+          ],
+          "logo": [
+            "adia",
+            "brand",
+            "mark",
+            "wordmark"
+          ]
+        },
+        "tag": "adia-mark-ui",
+        "tokens": {
+          "--adia-mark-bg": {
+            "description": "Background fill — always the inverse surface token, regardless of variant or scheme.",
+            "default": "var(--a-canvas-surface-inverse)"
+          },
+          "--adia-mark-fg": {
+            "description": "Wordmark fill — always the inverse foreground token, regardless of variant or scheme.",
+            "default": "var(--a-fg-inverse)"
+          },
+          "--adia-mark-radius": {
+            "description": "Corner radius of the background square.",
+            "default": "var(--a-radius-lg)"
+          },
+          "--adia-mark-size": {
+            "description": "Width and height of the square mark.",
+            "default": "2.5rem"
+          }
+        },
+        "traits": [],
+        "version": 1
+      }
+    },
     "AdminCommand": {
       "title": "AdminCommand",
       "description": "Module-tier command palette wrapper — wraps a native <dialog> and the\ninner <command-ui>. Owns the keyboard shortcut listener, focus\nmanagement, and dismiss handlers. Reflects [open].\n\nSits inside <admin-shell> as a direct child. The host wires\n[data-command-trigger] elements to <admin-command>.show() via lookup.\n\nThis is the bespoke web-component replacement for the legacy\n<dialog data-command> shape per ADR-0023. The legacy shape was\nretired in v0.4.0 per ADR-0024 and is no longer recognized.\n",
@@ -1720,7 +1841,8 @@
         "anti_patterns": [],
         "category": "agent",
         "composes": [
-          "button-ui"
+          "button-ui",
+          "option-card-ui"
         ],
         "events": {
           "questions-answer": {
@@ -3980,7 +4102,9 @@
           }
         ],
         "category": "input",
-        "composes": [],
+        "composes": [
+          "button-ui"
+        ],
         "events": {
           "change": {
             "description": "User selected a date. detail.value is the ISO string."
@@ -4153,7 +4277,9 @@
       "x-adiaui": {
         "anti_patterns": [],
         "category": "input",
-        "composes": [],
+        "composes": [
+          "button-ui"
+        ],
         "events": {
           "change": {
             "description": "Fired when a date is selected"
@@ -23163,7 +23289,7 @@
           "const": "Table"
         },
         "data": {
-          "description": "Row records. Array of plain objects keyed to columns[].key.",
+          "description": "JS property (set programmatically — `el.data = [...]`) — row records, an array of plain objects keyed to columns[].key. May also be supplied declaratively as a JSON-array `data=\"[…]\"` attribute, hydrated once at connect (gh#288) — the same pattern chart-ui's `data` attribute uses. Custom accessor on the element class, not a reflected attribute.",
           "$ref": "#/$defs/DynamicObjectList"
         },
         "density": {

package/catalog-a2ui_0_9_rules.txt

@@ -26,6 +26,11 @@
 - For popover-style menus use <menu-ui> + <menu-item-ui> instead.
 - Typical use: command palettes, settings panels, agent suggestion lists.
 
+## AdiaMark
+- Use <AdiaMark> for the Adia brand/app-identity mark — a favicon-style app-switcher tile, a splash/loading screen, an about-panel header. Do not use it as a generic icon; it has no [name] prop and always renders the same wordmark.
+- Do not wrap <AdiaMark> in <Icon> or pass it a color/tone override — the background/foreground pairing is fixed by design (always inverse-on-inverse for contrast), not a themeable variant.
+- Prefer <AdiaMark size="sm"> in a nav/topbar brand slot (a Row alongside the product name); reserve larger sizes (lg, xl) for splash screens or empty-state headers. Set [inline] only when the mark sits directly inside a run of prose text, not inside a Row/flex layout (block-level children compose fine as flex items already).
+
 ## AgentArtifact
 - Inline container for structured agent payloads inside <chat-thread-ui> message bodies or <inspector-ui> panes.
 - kind attribute (a2ui|json|ticket|code|...) sets content-type-aware rendering and icon/badge styling.