@adia-ai/a2ui-corpus 0.5.11 → 0.5.13

package/CHANGELOG.md

@@ -18,6 +18,14 @@ gap registry. Consumed by `@adia-ai/a2ui-retrieval` and
 
 _No pending changes._
 
+## [0.5.13] - 2026-05-15
+
+_Lockstep ride-along (no source change in this package; companion to web-components v0.5.13 — see root CHANGELOG)._
+
+## [0.5.12] - 2026-05-15
+
+_Lockstep ride-along (no source change in this package; companion to web-components v0.5.12 — see root CHANGELOG)._
+
 ## [0.5.11] - 2026-05-15
 
 _Lockstep ride-along (no source change)._

package/catalog-a2ui_0_9.json

@@ -5363,6 +5363,222 @@
         "version": 1
       }
     },
+    "ColorInput": {
+      "title": "ColorInput",
+      "description": "Compact form-bearing color input — opens a popover-anchored\n`<color-picker-ui>` from an inline swatch button. §302 (v0.5.12,\nFEEDBACK-29 re-bucket from v0.6.0). Canonicalizes the USAGE.md §221f\nOption B recipe (popover + button + color-picker) into a single\nform-associated tag for inline form contexts (settings drawer \"source\ncolor\" field, swatch-row inline-edit, etc.).",
+      "type": "object",
+      "allOf": [
+        {
+          "$ref": "#/$defs/ComponentCommon"
+        },
+        {
+          "$ref": "#/$defs/CatalogComponentCommon"
+        }
+      ],
+      "properties": {
+        "baseHue": {
+          "description": "Reference hue (degrees) for the hueDriftMax constraint, forwarded to inner picker. Default NaN — picker falls back to its hue at first commit.",
+          "type": "number",
+          "default": "NaN"
+        },
+        "component": {
+          "const": "ColorInput"
+        },
+        "disabled": {
+          "description": "Disables the trigger button + suppresses popover.",
+          "type": "boolean",
+          "default": false
+        },
+        "format": {
+          "description": "Output format for the value property + event detail. Hex (`#rrggbb`) or OKLCH (`oklch(L C H)`).",
+          "type": "string",
+          "enum": [
+            "hex",
+            "oklch"
+          ],
+          "default": "hex"
+        },
+        "hueDriftMax": {
+          "description": "Generation constraint forwarded to inner picker — maximum allowed signed-shortest-path hue deviation (degrees) from baseHue. Default NaN (no constraint).",
+          "type": "number",
+          "default": "NaN"
+        },
+        "maxChroma": {
+          "description": "Generation constraint forwarded to the inner `<color-picker-ui>` (v0.5.13\n§-TBD, FB-33 §1). Clamp the OKLCH chroma channel to at most this value.\nDefault Infinity (no constraint).\n",
+          "type": "number",
+          "default": "Infinity"
+        },
+        "maxL": {
+          "description": "Generation constraint forwarded to inner picker — clamp OKLCH lightness to at most this value (0..1). Default 1.",
+          "type": "number",
+          "default": 1
+        },
+        "minL": {
+          "description": "Generation constraint forwarded to inner picker — clamp OKLCH lightness to at least this value (0..1). Default 0.",
+          "type": "number",
+          "default": 0
+        },
+        "name": {
+          "description": "Form field name.",
+          "type": "string",
+          "default": ""
+        },
+        "open": {
+          "description": "Reflects the popover's open state. Set programmatically to open/close the picker without a click.",
+          "type": "boolean",
+          "default": false
+        },
+        "placement": {
+          "description": "Popover placement relative to the trigger.",
+          "type": "string",
+          "enum": [
+            "top",
+            "bottom",
+            "left",
+            "right",
+            "top-start",
+            "top-end",
+            "bottom-start",
+            "bottom-end"
+          ],
+          "default": "bottom-start"
+        },
+        "value": {
+          "description": "Current color as a string in the active [format].",
+          "type": "string",
+          "default": "#3b82f6"
+        }
+      },
+      "required": [
+        "component"
+      ],
+      "unevaluatedProperties": false,
+      "x-adiaui": {
+        "anti_patterns": [],
+        "category": "input",
+        "composes": [
+          "button-ui",
+          "popover-ui",
+          "color-picker-ui"
+        ],
+        "events": {
+          "change": {
+            "description": "Fired when the color is committed (pointerup / Enter / picker close). Bubbles from inner picker.",
+            "detail": {
+              "c": {
+                "description": "Parsed OKLCH chroma scalar.",
+                "type": "number"
+              },
+              "h": {
+                "description": "Parsed OKLCH hue scalar (degrees, NaN ok for achromatic).",
+                "type": "number"
+              },
+              "hex": {
+                "description": "Hex form (`#rrggbb`).",
+                "type": "string"
+              },
+              "l": {
+                "description": "Parsed OKLCH lightness scalar (0..1). v0.5.13 §-TBD (FB-33 §1-adjacent).",
+                "type": "number"
+              },
+              "oklch": {
+                "description": "OKLCH string (`oklch(L C H)`).",
+                "type": "string"
+              },
+              "value": {
+                "description": "Color in the active [format] (hex or oklch).",
+                "type": "string"
+              }
+            }
+          },
+          "input": {
+            "description": "Fired during continuous drag of the inner picker. Bubbles from inner picker.",
+            "detail": {
+              "c": {
+                "type": "number"
+              },
+              "h": {
+                "type": "number"
+              },
+              "hex": {
+                "type": "string"
+              },
+              "l": {
+                "type": "number"
+              },
+              "oklch": {
+                "type": "string"
+              },
+              "value": {
+                "description": "Color in the active [format].",
+                "type": "string"
+              }
+            }
+          }
+        },
+        "examples": [
+          {
+            "description": "Inline compact color input — popover-anchored picker on click.",
+            "a2ui": "[\n  {\n    \"id\": \"root\",\n    \"component\": \"ColorInput\",\n    \"name\": \"brand\",\n    \"value\": \"#3b82f6\"\n  }\n]",
+            "name": "color-input-basic"
+          },
+          {
+            "description": "Compact picker exposing OKLCH value form.",
+            "a2ui": "[\n  {\n    \"id\": \"root\",\n    \"component\": \"ColorInput\",\n    \"name\": \"accent\",\n    \"format\": \"oklch\",\n    \"value\": \"oklch(0.7 0.15 220)\"\n  }\n]",
+            "name": "color-input-oklch"
+          }
+        ],
+        "keywords": [
+          "color-input",
+          "color",
+          "input",
+          "picker",
+          "swatch",
+          "inline",
+          "compact"
+        ],
+        "name": "UIColorInput",
+        "related": [
+          "color-picker",
+          "popover",
+          "button",
+          "swatch"
+        ],
+        "slots": {},
+        "states": [
+          {
+            "description": "Default, ready for interaction.",
+            "name": "idle"
+          },
+          {
+            "description": "Popover is open; picker visible.",
+            "attribute": "open",
+            "name": "open"
+          },
+          {
+            "description": "Non-interactive; dimmed.",
+            "attribute": "disabled",
+            "name": "disabled"
+          }
+        ],
+        "synonyms": {
+          "color-field": [
+            "color-input"
+          ],
+          "inline-color-picker": [
+            "color-input"
+          ]
+        },
+        "tag": "color-input-ui",
+        "tokens": {
+          "--color-input-swatch-size": {
+            "description": "Diameter (em) of the inline swatch circle inside the trigger button. Default 1em."
+          }
+        },
+        "traits": [],
+        "version": 1
+      }
+    },
     "ColorPicker": {
       "title": "ColorPicker",
       "description": "OKLCH-native color picker with 2D area and H/C/L sliders. Form-associated.",
@@ -13975,7 +14191,7 @@
       ],
       "properties": {
         "autoContrast": {
-          "description": "When set, computes the swatch color's OKLab L and switches the label /\ndetail color between light + dark so it remains legible against the\ntile background. Only applies to shape=\"block\" (where the label sits\nON the tile). Uses a 1px canvas probe to handle any CSS color form\n(oklch / hex / hsl / named / var() references).\n",
+          "description": "When set, computes the swatch color's OKLab L and switches the label /\ndetail color between light + dark so it remains legible against the\ntile background. Active when `label-position=\"overlay\"` (where the\nlabel sits ON the tile). Uses a 1px canvas probe to handle any CSS\ncolor form (oklch / hex / hsl / named / var() references).\n",
           "type": "boolean",
           "default": false
         },
@@ -14012,6 +14228,15 @@
           "type": "string",
           "default": ""
         },
+        "labelPosition": {
+          "description": "§253 (v0.5.12, FB-23 §1). Position the label relative to the tile.\n`below` (default) stacks label under the tile (current shape=\"block\"\nlayout — `flex-direction: column`). `overlay` renders the label\nINSIDE the tile via absolute positioning; pair with `[auto-contrast]`\nto keep the label legible against the tile color (`data-on-light` /\n`data-on-dark` classes auto-stamped per OKLab-L probe). Only meaningful\nwhen `shape=\"block\"` (other shapes are too small for in-tile labels).\nUnblocks Tokens Studio's C1.3 dogfood migration (label-inside-the-tile\npattern; blocked 3 cycles on this design call).",
+          "type": "string",
+          "enum": [
+            "below",
+            "overlay"
+          ],
+          "default": "below"
+        },
         "selectable": {
           "description": "When set, makes the swatch keyboard-focusable + clickable. Sets role=\"button\" + tabindex=\"0\". Dispatches a \"select\" event on activation (click / Enter / Space).",
           "type": "boolean",
@@ -14101,7 +14326,10 @@
         ],
         "slots": {
           "default": {
-            "description": "Optional rich label content. When present, replaces the [label] attribute's text."
+            "description": "Optional rich label content. When present, replaces the [label]\nattribute's text. Consumer chrome positioned absolutely against the\nswatch tile should use `[slot=\"chrome\"]` instead — default-slot\nchildren are funneled into the label region.\n"
+          },
+          "chrome": {
+            "description": "§-TBD (v0.5.13, FB-34 §1). Sibling-of-tile chrome — gamut badges,\noverride/tracked dots, custom indicators — that survives stamping as\na direct host sibling rather than being funneled into the label. Pair\nwith consumer-authored CSS `position: absolute` against the host\n(the host carries `position: relative` when `shape=\"block\"`, so\n`top/right/bottom/left` offsets anchor to the tile's geometry).\nCloses the C1.3 dogfood chrome-overlay composition gap.\n"
           }
         },
         "states": [

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adia-ai/a2ui-corpus",
-  "version": "0.5.11",
+  "version": "0.5.13",
   "type": "module",
   "description": "AdiaUI A2UI training corpus — canonical v0.9 catalog + chunks + eval fixtures + feedback + gap registry. Consumed by the compose engine's retrieval layer + the MCP pipeline.",
   "exports": {