@adia-ai/a2ui-corpus 0.0.1

package/fragments/content/wizard-step-row.json

@@ -0,0 +1,96 @@
+{
+  "$schema": "../_schema.json",
+  "name": "wizard-step-row",
+  "version": 1,
+  "kind": "fragment",
+  "semantic_role": "list-item-atom",
+  "description": "Flat row with icon, title, badge. Used inside larger step-list compositions.",
+  "shape": "Row(Icon,Text,Badge)",
+  "tags": {
+    "purpose": [
+      "row-atom"
+    ],
+    "layout": "row"
+  },
+  "keywords": [
+    "step row atom",
+    "checklist step atom"
+  ],
+  "slots": [
+    {
+      "name": "icon",
+      "targetId": "wsr-icon",
+      "attribute": "name",
+      "required": true,
+      "defaultValue": "circle"
+    },
+    {
+      "name": "title",
+      "targetId": "wsr-title",
+      "attribute": "textContent",
+      "required": true,
+      "defaultValue": "Step"
+    },
+    {
+      "name": "badgeLabel",
+      "targetId": "wsr-badge",
+      "attribute": "text",
+      "required": false,
+      "defaultValue": "todo"
+    },
+    {
+      "name": "badgeVariant",
+      "targetId": "wsr-badge",
+      "attribute": "variant",
+      "required": false,
+      "defaultValue": "neutral"
+    }
+  ],
+  "template": [
+    {
+      "id": "wsr-root",
+      "component": "Row",
+      "gap": "2",
+      "align": "center",
+      "children": [
+        "wsr-icon",
+        "wsr-title",
+        "wsr-badge"
+      ]
+    },
+    {
+      "id": "wsr-icon",
+      "component": "Icon",
+      "name": "circle"
+    },
+    {
+      "id": "wsr-title",
+      "component": "Text",
+      "textContent": "Step",
+      "grow": true
+    },
+    {
+      "id": "wsr-badge",
+      "component": "Badge",
+      "text": "todo",
+      "variant": "neutral"
+    }
+  ],
+  "links": {
+    "uses_components": [
+      "Row",
+      "Icon",
+      "Text",
+      "Badge"
+    ],
+    "used_by": [],
+    "related": [
+      "icon-text-row"
+    ]
+  },
+  "metrics": {
+    "leverage": 4,
+    "pattern_count": 1,
+    "instance_count": 4
+  }
+}

package/fragments/form/labeled-checkbox.json

@@ -0,0 +1,27 @@
+{
+  "$schema": "../_schema.json",
+  "name": "labeled-checkbox",
+  "version": 2,
+  "kind": "fragment",
+  "semantic_role": "consent-field",
+  "description": "Checkbox wrapped in a field-ui (inline mode) for consent, opt-ins, boolean preferences.",
+  "shape": "Field(CheckBox)",
+  "tags": {
+    "purpose": ["form-field", "consent"],
+    "layout": "inline"
+  },
+  "keywords": ["checkbox", "consent", "agree", "accept", "terms", "opt-in", "toggle"],
+  "slots": [
+    { "name": "label",   "targetId": "fcb-field", "attribute": "label",   "required": true },
+    { "name": "name",    "targetId": "fcb-in",    "attribute": "name",    "required": true },
+    { "name": "checked", "targetId": "fcb-in",    "attribute": "checked", "defaultValue": false }
+  ],
+  "template": [
+    { "id": "fcb-field", "component": "Field",    "label": "Label", "inline": true, "children": ["fcb-in"] },
+    { "id": "fcb-in",    "component": "CheckBox", "name": "field", "checked": false }
+  ],
+  "links": {
+    "uses_components": ["Field", "CheckBox"]
+  },
+  "metrics": { "leverage": 4.0 }
+}

package/fragments/form/labeled-checkbox.yaml

@@ -0,0 +1,36 @@
+# Generated by scripts/generate-yaml-scaffolds.mjs
+# Narrative doc — JSON sibling remains the canonical machine source.
+# Fill in TODO sections by hand.
+
+$schema: ../../../../../scripts/schemas/fragment.yaml.schema.json
+kind: fragment
+name: labeled-checkbox
+description: >-
+  Checkbox with an inline label. Use for terms acceptance, opt-ins, boolean preferences in forms.
+keywords:
+  - checkbox
+  - consent
+  - agree
+  - accept
+  - terms
+  - opt-in
+  - toggle
+slots:
+  label:
+    required: true
+    target: fcb-in.label
+    description: "TODO: describe 'label' slot"
+  name:
+    required: true
+    target: fcb-in.name
+    description: "TODO: describe 'name' slot"
+  checked:
+    required: false
+    target: fcb-in.checked
+    description: "TODO: describe 'checked' slot"
+leverage: 0
+used_by: []
+use-cases:
+  - "TODO: describe when to reach for this fragment"
+components:
+  - CheckBox

package/fragments/form/labeled-input.json

@@ -0,0 +1,28 @@
+{
+  "$schema": "../_schema.json",
+  "name": "labeled-input",
+  "version": 2,
+  "kind": "fragment",
+  "semantic_role": "form-field",
+  "description": "Single-line input wrapped in a field-ui for proper label/control association. The atomic form field; composes into any form.",
+  "shape": "Field(Input)",
+  "tags": {
+    "purpose": ["form-field"],
+    "layout": "stacked"
+  },
+  "keywords": ["input", "field", "form", "text", "label"],
+  "slots": [
+    { "name": "label",       "targetId": "fi-field", "attribute": "label",       "required": true },
+    { "name": "name",        "targetId": "fi-in",    "attribute": "name",        "required": true },
+    { "name": "placeholder", "targetId": "fi-in",    "attribute": "placeholder" },
+    { "name": "type",        "targetId": "fi-in",    "attribute": "type",        "defaultValue": "text" }
+  ],
+  "template": [
+    { "id": "fi-field", "component": "Field", "label": "Label", "children": ["fi-in"] },
+    { "id": "fi-in",    "component": "Input", "name": "field", "placeholder": "" }
+  ],
+  "links": {
+    "uses_components": ["Field", "Input"]
+  },
+  "metrics": { "leverage": 20.0, "pattern_count": 12, "instance_count": 40 }
+}

package/fragments/form/labeled-input.yaml

@@ -0,0 +1,38 @@
+# Generated by scripts/generate-yaml-scaffolds.mjs
+# Narrative doc — JSON sibling remains the canonical machine source.
+# Fill in TODO sections by hand.
+
+$schema: ../../../../../scripts/schemas/fragment.yaml.schema.json
+kind: fragment
+name: labeled-input
+description: >-
+  Single-line input with a label and placeholder. The atomic form field; composes into any form.
+keywords:
+  - input
+  - field
+  - form
+  - text
+  - label
+slots:
+  label:
+    required: true
+    target: fi-in.label
+    description: "TODO: describe 'label' slot"
+  name:
+    required: true
+    target: fi-in.name
+    description: "TODO: describe 'name' slot"
+  placeholder:
+    required: false
+    target: fi-in.placeholder
+    description: "TODO: describe 'placeholder' slot"
+  type:
+    required: false
+    target: fi-in.type
+    description: "TODO: describe 'type' slot"
+leverage: 0
+used_by: []
+use-cases:
+  - "TODO: describe when to reach for this fragment"
+components:
+  - Input

package/fragments/form/labeled-slider.json

@@ -0,0 +1,34 @@
+{
+  "$schema": "../_schema.json",
+  "name": "labeled-slider",
+  "version": 1,
+  "kind": "fragment",
+  "semantic_role": "slider-with-label",
+  "description": "Slider input preceded by a caption label and followed by a muted value readout — for volume, price ranges, settings, intensity controls.",
+  "shape": "Column(Text[v=caption],Slider,Text[v=body])",
+  "tags": {
+    "purpose": ["slider-row", "range-control"],
+    "layout": "stacked"
+  },
+  "keywords": ["slider", "range", "volume", "intensity", "control", "min", "max"],
+  "slots": [
+    { "name": "label",    "targetId": "ls-label",   "attribute": "textContent", "required": true, "defaultValue": "Value" },
+    { "name": "name",     "targetId": "ls-slider",  "attribute": "name",        "required": false, "defaultValue": "value" },
+    { "name": "min",      "targetId": "ls-slider",  "attribute": "min",         "required": false, "defaultValue": 0 },
+    { "name": "max",      "targetId": "ls-slider",  "attribute": "max",         "required": false, "defaultValue": 100 },
+    { "name": "value",    "targetId": "ls-slider",  "attribute": "value",       "required": false, "defaultValue": 50 },
+    { "name": "readout",  "targetId": "ls-readout", "attribute": "textContent", "required": false, "defaultValue": "50%" }
+  ],
+  "template": [
+    { "id": "ls-root",    "component": "Column", "children": ["ls-label", "ls-slider", "ls-readout"], "gap": "2" },
+    { "id": "ls-label",   "component": "Text", "variant": "caption", "textContent": "Value" },
+    { "id": "ls-slider",  "component": "Slider", "name": "value", "min": 0, "max": 100, "value": 50 },
+    { "id": "ls-readout", "component": "Text", "variant": "body", "color": "muted", "textContent": "50%" }
+  ],
+  "links": {
+    "uses_components": ["Column", "Text", "Slider"],
+    "used_by": [],
+    "related": ["labeled-input", "labeled-progress"]
+  },
+  "metrics": { "leverage": 3.0, "pattern_count": 1, "instance_count": 1 }
+}

package/fragments/form/labeled-slider.yaml

@@ -0,0 +1,50 @@
+# Generated by scripts/generate-yaml-scaffolds.mjs
+# Narrative doc — JSON sibling remains the canonical machine source.
+# Fill in TODO sections by hand.
+
+$schema: ../../../../../scripts/schemas/fragment.yaml.schema.json
+kind: fragment
+name: labeled-slider
+description: >-
+  Slider input preceded by a caption label and followed by a muted value readout — for volume, price ranges, settings, intensity controls.
+keywords:
+  - slider
+  - range
+  - volume
+  - intensity
+  - control
+  - min
+  - max
+slots:
+  label:
+    required: true
+    target: ls-label.textContent
+    description: "TODO: describe 'label' slot"
+  name:
+    required: false
+    target: ls-slider.name
+    description: "TODO: describe 'name' slot"
+  min:
+    required: false
+    target: ls-slider.min
+    description: "TODO: describe 'min' slot"
+  max:
+    required: false
+    target: ls-slider.max
+    description: "TODO: describe 'max' slot"
+  value:
+    required: false
+    target: ls-slider.value
+    description: "TODO: describe 'value' slot"
+  readout:
+    required: false
+    target: ls-readout.textContent
+    description: "TODO: describe 'readout' slot"
+leverage: 0
+used_by: []
+use-cases:
+  - "TODO: describe when to reach for this fragment"
+components:
+  - Column
+  - Text
+  - Slider

package/fragments/form/labeled-textarea.json

@@ -0,0 +1,28 @@
+{
+  "$schema": "../_schema.json",
+  "name": "labeled-textarea",
+  "version": 2,
+  "kind": "fragment",
+  "semantic_role": "multiline-form-field",
+  "description": "Multi-line text input wrapped in a field-ui. Use for messages, descriptions, comments — any free-form text longer than a line.",
+  "shape": "Field(TextArea)",
+  "tags": {
+    "purpose": ["form-field", "multiline"],
+    "layout": "stacked"
+  },
+  "keywords": ["textarea", "message", "comment", "description", "multiline", "notes"],
+  "slots": [
+    { "name": "label",       "targetId": "fta-field", "attribute": "label",       "required": true },
+    { "name": "name",        "targetId": "fta-in",    "attribute": "name",        "required": true },
+    { "name": "placeholder", "targetId": "fta-in",    "attribute": "placeholder" },
+    { "name": "rows",        "targetId": "fta-in",    "attribute": "rows",        "defaultValue": 4 }
+  ],
+  "template": [
+    { "id": "fta-field", "component": "Field",    "label": "Label", "children": ["fta-in"] },
+    { "id": "fta-in",    "component": "TextArea", "name": "field", "placeholder": "", "rows": 4 }
+  ],
+  "links": {
+    "uses_components": ["Field", "TextArea"]
+  },
+  "metrics": { "leverage": 8.0 }
+}

package/fragments/form/labeled-textarea.yaml

@@ -0,0 +1,39 @@
+# Generated by scripts/generate-yaml-scaffolds.mjs
+# Narrative doc — JSON sibling remains the canonical machine source.
+# Fill in TODO sections by hand.
+
+$schema: ../../../../../scripts/schemas/fragment.yaml.schema.json
+kind: fragment
+name: labeled-textarea
+description: >-
+  Multi-line text input with a label. Use for messages, descriptions, comments — any free-form text longer than a line.
+keywords:
+  - textarea
+  - message
+  - comment
+  - description
+  - multiline
+  - notes
+slots:
+  label:
+    required: true
+    target: fta-in.label
+    description: "TODO: describe 'label' slot"
+  name:
+    required: true
+    target: fta-in.name
+    description: "TODO: describe 'name' slot"
+  placeholder:
+    required: false
+    target: fta-in.placeholder
+    description: "TODO: describe 'placeholder' slot"
+  rows:
+    required: false
+    target: fta-in.rows
+    description: "TODO: describe 'rows' slot"
+leverage: 0
+used_by: []
+use-cases:
+  - "TODO: describe when to reach for this fragment"
+components:
+  - TextArea

package/fragments/form/labeled-toggle.json

@@ -0,0 +1,29 @@
+{
+  "$schema": "../_schema.json",
+  "name": "labeled-toggle",
+  "version": 1,
+  "kind": "fragment",
+  "semantic_role": "boolean-preference",
+  "description": "Toggle switch with a label and optional description. Canonical row for settings pages and preference panels.",
+  "shape": "Row(Column(Text,Text),Toggle)",
+  "tags": {
+    "purpose": ["form-field", "preference", "toggle"],
+    "layout": "row"
+  },
+  "keywords": ["toggle", "switch", "setting", "preference", "enable", "disable", "notification"],
+  "slots": [
+    { "name": "label",       "targetId": "tg-label", "attribute": "textContent", "required": true },
+    { "name": "description", "targetId": "tg-desc",  "attribute": "textContent" },
+    { "name": "name",        "targetId": "tg-sw",    "attribute": "name", "required": true },
+    { "name": "checked",     "targetId": "tg-sw",    "attribute": "checked", "defaultValue": false }
+  ],
+  "template": [
+    { "id": "tg-root",  "component": "Row",    "children": ["tg-col", "tg-sw"], "gap": "3" },
+    { "id": "tg-col",   "component": "Column", "children": ["tg-label", "tg-desc"], "gap": "0" },
+    { "id": "tg-label", "component": "Text",   "variant": "body", "textContent": "Setting" },
+    { "id": "tg-desc",  "component": "Text",   "variant": "caption", "color": "muted", "textContent": "" },
+    { "id": "tg-sw",    "component": "Toggle", "name": "field", "checked": false }
+  ],
+  "links": { "uses_components": ["Row", "Column", "Text", "Toggle"] },
+  "metrics": { "leverage": 6.0 }
+}

package/fragments/form/labeled-toggle.yaml

@@ -0,0 +1,43 @@
+# Generated by scripts/generate-yaml-scaffolds.mjs
+# Narrative doc — JSON sibling remains the canonical machine source.
+# Fill in TODO sections by hand.
+
+$schema: ../../../../../scripts/schemas/fragment.yaml.schema.json
+kind: fragment
+name: labeled-toggle
+description: >-
+  Toggle switch with a label and optional description. Canonical row for settings pages and preference panels.
+keywords:
+  - toggle
+  - switch
+  - setting
+  - preference
+  - enable
+  - disable
+  - notification
+slots:
+  label:
+    required: true
+    target: tg-label.textContent
+    description: "TODO: describe 'label' slot"
+  description:
+    required: false
+    target: tg-desc.textContent
+    description: "TODO: describe 'description' slot"
+  name:
+    required: true
+    target: tg-sw.name
+    description: "TODO: describe 'name' slot"
+  checked:
+    required: false
+    target: tg-sw.checked
+    description: "TODO: describe 'checked' slot"
+leverage: 0
+used_by: []
+use-cases:
+  - "TODO: describe when to reach for this fragment"
+components:
+  - Row
+  - Column
+  - Text
+  - Toggle

package/fragments/form/rating-row.json

@@ -0,0 +1,31 @@
+{
+  "$schema": "../_schema.json",
+  "name": "rating-row",
+  "version": 1,
+  "kind": "fragment",
+  "semantic_role": "rating-with-label",
+  "description": "Star rating paired with an inline label — for review forms, product cards, testimonial summaries. Defaults to 5-star scale with half-step precision.",
+  "shape": "Row(Text[v=body],Rating)",
+  "tags": {
+    "purpose": ["rating-row", "review", "feedback"],
+    "layout": "inline"
+  },
+  "keywords": ["rating", "stars", "review", "score", "feedback"],
+  "slots": [
+    { "name": "label",    "targetId": "rr-label",  "attribute": "textContent", "required": true, "defaultValue": "Rating" },
+    { "name": "value",    "targetId": "rr-rating", "attribute": "value",       "required": true, "defaultValue": 0 },
+    { "name": "max",      "targetId": "rr-rating", "attribute": "max",         "required": false, "defaultValue": 5 },
+    { "name": "readonly", "targetId": "rr-rating", "attribute": "readonly",    "required": false, "defaultValue": false }
+  ],
+  "template": [
+    { "id": "rr-root",   "component": "Row", "children": ["rr-label", "rr-rating"], "gap": "3", "align": "center" },
+    { "id": "rr-label",  "component": "Text", "variant": "body", "textContent": "Rating" },
+    { "id": "rr-rating", "component": "Rating", "value": 0, "max": 5 }
+  ],
+  "links": {
+    "uses_components": ["Row", "Text", "Rating"],
+    "used_by": [],
+    "related": []
+  },
+  "metrics": { "leverage": 4.0, "pattern_count": 1, "instance_count": 1 }
+}

package/fragments/form/rating-row.yaml

@@ -0,0 +1,40 @@
+# Generated by scripts/generate-yaml-scaffolds.mjs
+# Narrative doc — JSON sibling remains the canonical machine source.
+# Fill in TODO sections by hand.
+
+$schema: ../../../../../scripts/schemas/fragment.yaml.schema.json
+kind: fragment
+name: rating-row
+description: >-
+  Star rating paired with an inline label — for review forms, product cards, testimonial summaries. Defaults to 5-star scale with half-step precision.
+keywords:
+  - rating
+  - stars
+  - review
+  - score
+  - feedback
+slots:
+  label:
+    required: true
+    target: rr-label.textContent
+    description: "TODO: describe 'label' slot"
+  value:
+    required: true
+    target: rr-rating.value
+    description: "TODO: describe 'value' slot"
+  max:
+    required: false
+    target: rr-rating.max
+    description: "TODO: describe 'max' slot"
+  readonly:
+    required: false
+    target: rr-rating.readonly
+    description: "TODO: describe 'readonly' slot"
+leverage: 0
+used_by: []
+use-cases:
+  - "TODO: describe when to reach for this fragment"
+components:
+  - Row
+  - Text
+  - Rating

package/fragments/layout/card-header-heading.json

@@ -0,0 +1,39 @@
+{
+  "$schema": "../_schema.json",
+  "name": "card-header-heading",
+  "version": 1,
+  "kind": "fragment",
+  "semantic_role": "card-titlebar",
+  "description": "Minimal card header with a single section-level heading. The canonical titlebar for any Card. Use when the card needs a title but no subcopy or actions.",
+  "shape": "Header(Text[slot=heading,v=section])",
+  "tags": {
+    "purpose": ["titlebar", "card-header"],
+    "layout": "inline"
+  },
+  "keywords": ["card", "header", "title", "heading", "titlebar"],
+  "slots": [
+    {
+      "name": "heading",
+      "targetId": "h-text",
+      "attribute": "textContent",
+      "required": true,
+      "description": "The card's title text"
+    }
+  ],
+  "template": [
+    { "id": "h-root", "component": "Header", "children": ["h-text"] },
+    { "id": "h-text", "component": "Text", "slot": "heading", "variant": "section", "textContent": "Title" }
+  ],
+  "links": {
+    "uses_components": ["Header", "Text"],
+    "uses_fragments": [],
+    "used_by": [],
+    "related": ["card-header-with-description"],
+    "spawned_from": []
+  },
+  "metrics": {
+    "leverage": 32.0,
+    "pattern_count": 16,
+    "instance_count": 25
+  }
+}

package/fragments/layout/card-header-heading.yaml

@@ -0,0 +1,27 @@
+# Generated by scripts/generate-yaml-scaffolds.mjs
+# Narrative doc — JSON sibling remains the canonical machine source.
+# Fill in TODO sections by hand.
+
+$schema: ../../../../../scripts/schemas/fragment.yaml.schema.json
+kind: fragment
+name: card-header-heading
+description: >-
+  Minimal card header with a single section-level heading. The canonical titlebar for any Card. Use when the card needs a title but no subcopy or actions.
+keywords:
+  - card
+  - header
+  - title
+  - heading
+  - titlebar
+slots:
+  heading:
+    required: true
+    target: h-text.textContent
+    description: "The card's title text"
+leverage: 0
+used_by: []
+use-cases:
+  - "TODO: describe when to reach for this fragment"
+components:
+  - Header
+  - Text

package/fragments/layout/card-header-with-badge.json

@@ -0,0 +1,30 @@
+{
+  "$schema": "../_schema.json",
+  "name": "card-header-with-badge",
+  "version": 1,
+  "kind": "fragment",
+  "semantic_role": "titled-card-header",
+  "description": "Card header with a section-level heading plus a status badge — for kanban columns, product cards with stock status, task cards with priority, item cards with state tags.",
+  "shape": "Header(Text[v=section],Badge[v=success])",
+  "tags": {
+    "purpose": ["titlebar", "card-header", "status"],
+    "layout": "inline"
+  },
+  "keywords": ["card", "header", "title", "badge", "status", "tag", "label", "pill", "column"],
+  "slots": [
+    { "name": "heading", "targetId": "hb-title", "attribute": "textContent", "required": true, "defaultValue": "Title" },
+    { "name": "badgeLabel", "targetId": "hb-badge", "attribute": "textContent", "required": true, "defaultValue": "Status" },
+    { "name": "badgeVariant", "targetId": "hb-badge", "attribute": "variant", "required": false, "defaultValue": "success" }
+  ],
+  "template": [
+    { "id": "hb-root", "component": "Header", "children": ["hb-title", "hb-badge"] },
+    { "id": "hb-title", "component": "Text", "variant": "section", "textContent": "Title" },
+    { "id": "hb-badge", "component": "Badge", "variant": "success", "textContent": "Status" }
+  ],
+  "links": {
+    "uses_components": ["Header", "Text", "Badge"],
+    "used_by": [],
+    "related": ["card-header-heading", "card-header-with-description"]
+  },
+  "metrics": { "leverage": 6.0, "pattern_count": 2, "instance_count": 2 }
+}