@adia-ai/a2ui-corpus 0.0.1

package/compositions/data/saved-views-filter-bar.json

@@ -0,0 +1,52 @@
+{
+  "$schema": "../_schema.json",
+  "name": "saved-views-filter-bar",
+  "version": 1,
+  "kind": "composition",
+  "domain": "data",
+  "description": "Filter bar with facet chips, operators, and a saved-views dropdown. Active filters render as removable chips; a plus button opens the add-filter menu. The Linear / Attio / HubSpot view header.",
+  "tags": { "purpose": ["filter-bar", "saved-views", "facets"], "complexity": "composed", "layout": "toolbar" },
+  "keywords": ["saved views", "filter bar", "facet chips", "filter chips", "view dropdown", "linear views", "attio views", "hubspot filters", "query builder", "filter operators", "view tabs", "faceted search"],
+
+  "template": [
+    { "id": "root", "component": "Column", "gap": "3", "children": ["viewsRow", "chipsBar", "meta", "resultsTable"] },
+
+    { "id": "viewsRow", "component": "Row", "gap": "2", "align": "center", "children": ["savedLabel", "viewsBtn", "tabs"] },
+    { "id": "savedLabel", "component": "Text", "variant": "caption", "color": "subtle", "textContent": "SAVED VIEWS" },
+    { "id": "viewsBtn", "component": "Button", "variant": "outline", "size": "sm", "icon": "squares-four", "textContent": "All issues ▾" },
+    { "id": "tabs", "component": "Tabs", "value": "all", "children": ["t1", "t2", "t3", "t4"] },
+    { "id": "t1", "component": "Tab", "value": "all", "textContent": "All" },
+    { "id": "t2", "component": "Tab", "value": "my", "textContent": "My issues" },
+    { "id": "t3", "component": "Tab", "value": "triage", "textContent": "Triage" },
+    { "id": "t4", "component": "Tab", "value": "backlog", "textContent": "Backlog" },
+
+    { "id": "chipsBar", "component": "Toolbar", "children": ["chip1", "chip2", "chip3", "chip4", "addBtn", "sep", "saveBtn"] },
+    { "id": "chip1", "component": "Tag", "textContent": "Status is In progress, Todo" },
+    { "id": "chip2", "component": "Tag", "textContent": "Assignee is Priya P." },
+    { "id": "chip3", "component": "Tag", "textContent": "Priority is at least Medium" },
+    { "id": "chip4", "component": "Tag", "textContent": "Due before Apr 30" },
+    { "id": "addBtn", "component": "Button", "variant": "ghost", "size": "sm", "icon": "plus", "textContent": "Add filter" },
+    { "id": "sep", "component": "Divider", "vertical": true },
+    { "id": "saveBtn", "component": "Button", "variant": "outline", "size": "sm", "textContent": "Save view" },
+
+    { "id": "meta", "component": "Text", "variant": "caption", "color": "muted", "textContent": "142 issues match · sorted by updated" },
+
+    { "id": "resultsTable", "component": "Table",
+      "columns": [
+        { "key": "id", "label": "ID", "type": "text", "width": 90 },
+        { "key": "title", "label": "Title", "type": "text", "flex": 3 },
+        { "key": "status", "label": "Status", "type": "badge", "width": 120 },
+        { "key": "assignee", "label": "Assignee", "type": "text", "width": 140 },
+        { "key": "priority", "label": "Priority", "type": "text", "width": 100 },
+        { "key": "due", "label": "Due", "type": "date", "width": 110 }
+      ],
+      "data": [
+        { "id": "ENG-812", "title": "Sticky column scroll jank on Safari", "status": "In progress", "assignee": "Priya Patel", "priority": "High", "due": "2026-04-24" },
+        { "id": "ENG-809", "title": "Virtualized table spacer off-by-one", "status": "Todo", "assignee": "Priya Patel", "priority": "Medium", "due": "2026-04-25" },
+        { "id": "ENG-807", "title": "Inspector tab focus ring", "status": "In progress", "assignee": "Priya Patel", "priority": "Medium", "due": "2026-04-26" },
+        { "id": "ENG-804", "title": "Command palette keyboard trap", "status": "Todo", "assignee": "Priya Patel", "priority": "High", "due": "2026-04-28" },
+        { "id": "ENG-801", "title": "Dark theme contrast on muted tags", "status": "In progress", "assignee": "Priya Patel", "priority": "Medium", "due": "2026-04-30" }
+      ]
+    }
+  ]
+}

package/compositions/data/shopping-cart-summary.json

@@ -0,0 +1,28 @@
+{
+  "$schema": "../_schema.json",
+  "name": "shopping-cart-summary",
+  "version": 1,
+  "kind": "composition",
+  "domain": "data",
+  "description": "Shopping cart summary with line items, subtotal, shipping, and total — checkout sidebar surface.",
+  "tags": { "purpose": ["cart", "checkout", "ecommerce"], "complexity": "medium", "layout": "stacked" },
+  "keywords": ["cart", "shopping cart", "checkout", "summary", "order total"],
+
+  "template": [
+    { "id": "root", "component": "Card", "children": ["hdr", "sec", "ftr"] },
+    { "id": "hdr", "$fragment": "card-header-with-description",
+      "bindings": { "heading": "Your cart", "description": "3 items" } },
+    { "id": "sec", "component": "Section", "children": ["grid"] },
+    { "id": "grid", "component": "Grid", "children": ["l1", "l2", "l3", "div", "tot"], "columns": "1", "gap": "2" },
+    { "id": "l1", "$fragment": "key-value-row",
+      "bindings": { "label": "Pro plan × 1", "value": "$29.00" } },
+    { "id": "l2", "$fragment": "key-value-row",
+      "bindings": { "label": "Extra seat × 2", "value": "$20.00" } },
+    { "id": "l3", "$fragment": "key-value-row",
+      "bindings": { "label": "Shipping", "value": "Free" } },
+    { "id": "div","component": "Divider" },
+    { "id": "tot","$fragment": "key-value-row",
+      "bindings": { "label": "Total", "value": "$49.00" } },
+    { "id": "ftr", "$fragment": "footer-primary-only", "bindings": { "label": "Checkout" } }
+  ]
+}

package/compositions/data/shopping-cart-summary.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/composition.yaml.schema.json
+kind: composition
+name: shopping-cart-summary
+domain: data
+description: >-
+  Shopping cart summary with line items, subtotal, shipping, and total — checkout sidebar surface.
+keywords:
+  - cart
+  - shopping cart
+  - checkout
+  - summary
+  - order total
+tags:
+  purpose:
+    - cart
+    - checkout
+    - ecommerce
+  complexity: medium
+  layout: stacked
+related: []
+fragments_used:
+  - fragment: card-header-with-description
+    prefix: ""
+  - fragment: key-value-row
+    prefix: ""
+  - fragment: key-value-row
+    prefix: ""
+  - fragment: key-value-row
+    prefix: ""
+  - fragment: key-value-row
+    prefix: ""
+  - fragment: footer-primary-only
+    prefix: ""
+use-cases:
+  - "TODO: primary use case"
+wiring-intent:
+  summary: Static composition (no interactive wiring).
+  controllers: []
+  actions: []

package/compositions/data/stat-card-dashboard.json

@@ -0,0 +1,30 @@
+{
+  "$schema": "../_schema.json",
+  "name": "stat-card-dashboard",
+  "version": 1,
+  "kind": "composition",
+  "domain": "data",
+  "description": "Dashboard overview with 4 stat tiles in a row — revenue, users, orders, conversion. The canonical KPI summary.",
+  "tags": {
+    "purpose": ["dashboard", "kpi", "overview"],
+    "complexity": "simple",
+    "layout": "grid",
+    "interaction": []
+  },
+  "keywords": ["dashboard", "stat cards", "kpi", "metrics", "overview", "tiles", "analytics"],
+
+  "template": [
+    { "id": "root", "component": "Section", "children": ["hdr", "grid"] },
+    { "id": "hdr", "$fragment": "card-header-heading",
+      "bindings": { "heading": "Overview" } },
+    { "id": "grid", "component": "Row", "children": ["stat1", "stat2", "stat3", "stat4"], "gap": "4" },
+    { "id": "stat1", "$fragment": "stat-card",
+      "bindings": { "label": "Revenue",    "value": "$24,500", "trend": "↑ 12% vs last month" } },
+    { "id": "stat2", "$fragment": "stat-card",
+      "bindings": { "label": "Active users", "value": "1,284", "trend": "↑ 8% this week" } },
+    { "id": "stat3", "$fragment": "stat-card",
+      "bindings": { "label": "Orders",     "value": "342",    "trend": "↓ 3% vs last week" } },
+    { "id": "stat4", "$fragment": "stat-card",
+      "bindings": { "label": "Conversion", "value": "3.8%",   "trend": "↑ 0.4pt" } }
+  ]
+}

package/compositions/data/stat-card-dashboard.yaml

@@ -0,0 +1,44 @@
+# 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/composition.yaml.schema.json
+kind: composition
+name: stat-card-dashboard
+domain: data
+description: >-
+  Dashboard overview with 4 stat tiles in a row — revenue, users, orders, conversion. The canonical KPI summary.
+keywords:
+  - dashboard
+  - stat cards
+  - kpi
+  - metrics
+  - overview
+  - tiles
+  - analytics
+tags:
+  purpose:
+    - dashboard
+    - kpi
+    - overview
+  complexity: simple
+  layout: grid
+  interaction: []
+related: []
+fragments_used:
+  - fragment: card-header-heading
+    prefix: ""
+  - fragment: stat-card
+    prefix: ""
+  - fragment: stat-card
+    prefix: ""
+  - fragment: stat-card
+    prefix: ""
+  - fragment: stat-card
+    prefix: ""
+use-cases:
+  - "TODO: primary use case"
+wiring-intent:
+  summary: Static composition (no interactive wiring).
+  controllers: []
+  actions: []

package/compositions/data/status-page.json

@@ -0,0 +1,48 @@
+{
+  "$schema": "../_schema.json",
+  "name": "status-page",
+  "version": 1,
+  "kind": "composition",
+  "domain": "data",
+  "description": "Public status page with component statuses grid (operational/degraded/outage), 90-day uptime bars per component, active incident banner, and incident timeline with postmortem links.",
+  "tags": {
+    "purpose": ["status", "uptime", "incident", "monitoring", "availability"],
+    "complexity": "complex",
+    "layout": "stacked"
+  },
+  "keywords": [
+    "status page", "statuspage", "uptime", "availability",
+    "component status", "operational", "degraded", "outage", "incident",
+    "incident timeline", "postmortem", "SLA",
+    "system status", "service health", "downtime",
+    "reliability", "monitoring", "90 day uptime"
+  ],
+  "related": ["activity-feed", "changelog-feed"],
+
+  "template": [
+    { "id": "root", "component": "Column", "gap": "4", "children": ["banner", "card"] },
+    { "id": "banner", "component": "Alert", "variant": "success", "icon": "check-circle", "title": "All systems operational", "description": "Last checked 47 seconds ago · All 8 components green." },
+
+    { "id": "card", "component": "Card", "children": ["hdr", "sec", "ftr"] },
+    { "id": "hdr", "$fragment": "card-header-with-description",
+      "bindings": { "heading": "Component status", "description": "Updated every 30s · 90-day rolling uptime per component." } },
+    { "id": "sec", "component": "Section", "children": ["col"] },
+    { "id": "col", "component": "Column", "gap": "3", "children": ["cu1", "cu2", "cu3", "cu4", "cu5", "inc-title", "incidents"] },
+
+    { "id": "cu1", "$fragment": "health-entry-atom", "bindings": { "componentName": "Dashboard",       "status": "Operational", "statusVariant": "success", "uptime": "100.00% uptime · 90d" } },
+    { "id": "cu2", "$fragment": "health-entry-atom", "bindings": { "componentName": "Public API",      "status": "Operational", "statusVariant": "success", "uptime": "99.982% uptime · 90d" } },
+    { "id": "cu3", "$fragment": "health-entry-atom", "bindings": { "componentName": "Background jobs", "status": "Degraded",    "statusVariant": "warning", "uptime": "99.941% uptime · 90d" } },
+    { "id": "cu4", "$fragment": "health-entry-atom", "bindings": { "componentName": "CDN",             "status": "Operational", "statusVariant": "success", "uptime": "99.999% uptime · 90d" } },
+    { "id": "cu5", "$fragment": "health-entry-atom", "bindings": { "componentName": "Email delivery",  "status": "Operational", "statusVariant": "success", "uptime": "99.991% uptime · 90d" } },
+
+    { "id": "inc-title", "component": "Text", "variant": "section", "textContent": "Incidents — last 30 days" },
+    { "id": "incidents", "component": "Timeline", "children": ["ti1", "ti2", "ti3"] },
+
+    { "id": "ti1", "$fragment": "incident-row", "bindings": { "severity": "Warning",  "severityVariant": "warning", "title": "Elevated job latency",  "description": "Background queue workers saturated · mitigated in 28 min", "time": "Today · 14:32 UTC" } },
+    { "id": "ti2", "$fragment": "incident-row", "bindings": { "severity": "Info",     "severityVariant": "info",    "title": "Minor API latency",     "description": "p99 spike on api.acme.com · resolved",                    "time": "Apr 12 · 09:05 UTC" } },
+    { "id": "ti3", "$fragment": "incident-row", "bindings": { "severity": "Resolved", "severityVariant": "success", "title": "Scheduled maintenance", "description": "DB failover rehearsal · no customer impact",               "time": "Apr 04 · 02:00 UTC" } },
+
+    { "id": "ftr", "component": "Footer", "children": ["ftr-legend"] },
+    { "id": "ftr-legend", "$fragment": "metadata-description-list", "bindings": { "layout": "inline", "align": "between", "items": "[{\"term\":\"Operational\",\"description\":\"green · all systems green\"},{\"term\":\"Degraded\",\"description\":\"amber · partial outage or latency\"},{\"term\":\"Outage\",\"description\":\"red · customer impact confirmed\"},{\"term\":\"Window\",\"description\":\"90-day rolling uptime\"}]" } }
+  ]
+}

package/compositions/data/virtualized-table.json

@@ -0,0 +1,50 @@
+{
+  "$schema": "../_schema.json",
+  "name": "virtualized-table",
+  "version": 1,
+  "kind": "composition",
+  "domain": "data",
+  "description": "Virtualized table for 10k rows — large-scale data table with a sticky header row, sticky first column, and a virtualized scroll window that renders only the visible slice of rows plus a spacer for the remaining rows. Presentational stub for 10,000+ row virtualization (tanstack/ag-grid style).",
+  "tags": { "purpose": ["data-table", "virtualization", "large-data", "virtual-scroll"], "complexity": "composed", "layout": "stacked" },
+  "keywords": ["virtualized table", "virtualization", "virtual scroll", "virtual window", "10k rows", "10000 rows", "sticky header", "sticky column", "frozen column", "pinned column", "large table", "infinite scroll table", "windowed list", "tanstack table", "ag grid", "big data table"],
+
+  "template": [
+    { "id": "root", "component": "Card", "children": ["hdr", "toolbar", "sec", "ftr"] },
+    { "id": "hdr", "$fragment": "card-header-with-description", "bindings": { "heading": "Orders", "description": "Virtualized table · sticky header and first column · windowed scroll" } },
+    { "id": "toolbar", "component": "Toolbar", "children": ["tb-count", "tb-spacer", "tb-sticky", "tb-pin", "tb-virt"] },
+    { "id": "tb-count", "component": "Badge", "variant": "muted", "textContent": "10,247 rows" },
+    { "id": "tb-spacer", "component": "Text", "variant": "caption", "color": "muted", "textContent": "Showing rows 1–45" },
+    { "id": "tb-sticky", "component": "Tag", "textContent": "sticky header" },
+    { "id": "tb-pin", "component": "Tag", "textContent": "pinned first column" },
+    { "id": "tb-virt", "component": "Tag", "textContent": "virtualized window" },
+    { "id": "sec", "component": "Section", "children": ["virtual-window", "tbl", "spacer", "virt-stream"] },
+    { "id": "virtual-window", "component": "Column", "children": ["vw-label", "vw-top", "vw-viewport"], "gap": "1" },
+    { "id": "vw-label", "component": "Text", "variant": "caption", "color": "subtle", "textContent": "VIRTUAL SCROLL WINDOW · viewport renders only visible rows · spacer above/below simulates 10,000+ row dataset" },
+    { "id": "vw-top", "component": "Skeleton", "variant": "row", "textContent": "↑ 3,120 virtualized rows above (spacer band)" },
+    { "id": "vw-viewport", "component": "Badge", "variant": "primary", "textContent": "virtualized viewport · rows 3121–3165" },
+    { "id": "spacer", "component": "Skeleton", "variant": "row", "textContent": "↓ 7,082 virtualized rows below (spacer band)" },
+    { "id": "virt-stream", "component": "Stream", "aria-label": "Virtualized row stream", "textContent": "Row virtualization engine · window size 45 · overscan 10 · total rows 10,247" },
+    { "id": "tbl", "component": "Table",
+      "columns": [
+        { "key": "orderId", "label": "Order ID", "type": "text", "width": 120, "pin": "left" },
+        { "key": "customer", "label": "Customer", "type": "text", "flex": 2 },
+        { "key": "product", "label": "Product", "type": "text", "flex": 2 },
+        { "key": "status", "label": "Status", "type": "badge", "width": 110 },
+        { "key": "amount", "label": "Amount", "type": "number", "width": 110 },
+        { "key": "date", "label": "Date", "type": "date", "width": 120 },
+        { "key": "region", "label": "Region", "type": "text", "width": 120 }
+      ],
+      "data": [
+        { "orderId": "ORD-1240", "customer": "Globex Corp", "product": "Enterprise Suite", "status": "Active", "amount": 12500, "date": "2025-12-01", "region": "NA-East" },
+        { "orderId": "ORD-1241", "customer": "Initech LLC", "product": "Starter Plan", "status": "Active", "amount": 2400, "date": "2025-12-01", "region": "NA-West" },
+        { "orderId": "ORD-1242", "customer": "Umbrella Inc", "product": "Pro License", "status": "Pending", "amount": 7800, "date": "2025-12-02", "region": "EU-Central" },
+        { "orderId": "ORD-1243", "customer": "Stark Industries", "product": "Enterprise Suite", "status": "Active", "amount": 18900, "date": "2025-12-02", "region": "NA-East" },
+        { "orderId": "ORD-1244", "customer": "Wayne Enterprises", "product": "Custom Integration", "status": "Pending", "amount": 34000, "date": "2025-12-03", "region": "NA-East" }
+      ]
+    },
+    { "id": "ftr", "component": "Footer", "children": ["ftxt", "ftxt2", "pagination"] },
+    { "id": "ftxt", "component": "Text", "variant": "caption", "color": "muted", "textContent": "Rendering 45 of 10,247 rows (virtualized window) · scroll to load more" },
+    { "id": "ftxt2", "component": "Text", "variant": "caption", "color": "muted", "textContent": "Virtual scroll · sticky header · sticky first column · row height 36px · overscan 10 rows · 60fps on 10,000+ rows" },
+    { "id": "pagination", "component": "Pagination", "total": 10247, "page": 1, "pageSize": 45 }
+  ]
+}

package/compositions/data/weather-widget.json

@@ -0,0 +1,20 @@
+{
+  "$schema": "../_schema.json",
+  "name": "weather-widget",
+  "version": 1,
+  "kind": "composition",
+  "domain": "data",
+  "description": "Compact weather widget — location, temperature, condition icon and description.",
+  "tags": { "purpose": ["weather", "widget"], "complexity": "atomic", "layout": "stacked" },
+  "keywords": ["weather", "forecast", "temperature", "widget"],
+
+  "template": [
+    { "id": "root", "component": "Card", "children": ["hdr", "sec"] },
+    { "id": "hdr", "$fragment": "card-header-with-description",
+      "bindings": { "heading": "San Francisco", "description": "Partly cloudy" } },
+    { "id": "sec", "component": "Section", "children": ["row"] },
+    { "id": "row", "component": "Row", "children": ["icon", "temp"], "gap": "3", "align": "center" },
+    { "id": "icon","component": "Icon", "name": "cloud-sun", "size": "lg" },
+    { "id": "temp","component": "Text", "variant": "display", "textContent": "68°" }
+  ]
+}

package/compositions/data/weather-widget.yaml

@@ -0,0 +1,31 @@
+# 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/composition.yaml.schema.json
+kind: composition
+name: weather-widget
+domain: data
+description: >-
+  Compact weather widget — location, temperature, condition icon and description.
+keywords:
+  - weather
+  - forecast
+  - temperature
+  - widget
+tags:
+  purpose:
+    - weather
+    - widget
+  complexity: atomic
+  layout: stacked
+related: []
+fragments_used:
+  - fragment: card-header-with-description
+    prefix: ""
+use-cases:
+  - "TODO: primary use case"
+wiring-intent:
+  summary: Static composition (no interactive wiring).
+  controllers: []
+  actions: []

package/compositions/form/data-import-wizard.json

@@ -0,0 +1,217 @@
+{
+  "$schema": "../_schema.json",
+  "name": "data-import-wizard",
+  "version": 1,
+  "kind": "composition",
+  "domain": "form",
+  "description": "Multi-step data import wizard with a step progress indicator, file upload input, column-mapping form, preview feedback, and prev/next wizard navigation.",
+  "tags": {
+    "purpose": [
+      "wizard",
+      "import",
+      "form",
+      "multi-step"
+    ],
+    "complexity": "high",
+    "layout": "stacked"
+  },
+  "keywords": [
+    "data import",
+    "import wizard",
+    "data import wizard",
+    "csv import",
+    "upload data",
+    "wizard",
+    "multi-step form",
+    "stepper",
+    "step indicator",
+    "step progress",
+    "file upload",
+    "column mapping",
+    "preview",
+    "validate",
+    "next previous",
+    "import csv",
+    "import spreadsheet",
+    "bulk import",
+    "data migration"
+  ],
+  "template": [
+    {
+      "id": "root",
+      "component": "Card",
+      "children": [
+        "hdr",
+        "sec",
+        "ftr"
+      ]
+    },
+    {
+      "id": "hdr",
+      "$fragment": "card-header-with-description",
+      "bindings": {
+        "heading": "Import data",
+        "description": "Upload a CSV, map columns, preview the import, then finish."
+      }
+    },
+    {
+      "id": "sec",
+      "component": "Section",
+      "children": [
+        "col"
+      ]
+    },
+    {
+      "id": "col",
+      "component": "Column",
+      "gap": "4",
+      "children": [
+        "steps",
+        "divider",
+        "upload",
+        "mapping",
+        "preview"
+      ]
+    },
+    {
+      "id": "steps",
+      "component": "Timeline",
+      "mode": "steps",
+      "children": [
+        "s1",
+        "s2",
+        "s3",
+        "s4"
+      ]
+    },
+    {
+      "id": "s1",
+      "$fragment": "wizard-step-row",
+      "bindings": {
+        "icon": "check",
+        "title": "Upload",
+        "badgeLabel": "complete",
+        "badgeVariant": "success"
+      }
+    },
+    {
+      "id": "s2",
+      "$fragment": "wizard-step-row",
+      "bindings": {
+        "icon": "circle-dot",
+        "title": "Map",
+        "badgeLabel": "current",
+        "badgeVariant": "primary"
+      }
+    },
+    {
+      "id": "s3",
+      "$fragment": "wizard-step-row",
+      "bindings": {
+        "icon": "circle",
+        "title": "Preview",
+        "badgeLabel": "pending",
+        "badgeVariant": "muted"
+      }
+    },
+    {
+      "id": "s4",
+      "$fragment": "wizard-step-row",
+      "bindings": {
+        "icon": "circle",
+        "title": "Finish",
+        "badgeLabel": "pending",
+        "badgeVariant": "muted"
+      }
+    },
+    {
+      "id": "divider",
+      "component": "Divider"
+    },
+    {
+      "id": "upload",
+      "component": "Upload",
+      "accept": ".csv,.tsv,.xlsx",
+      "label": "Drop a CSV or spreadsheet file"
+    },
+    {
+      "id": "mapping",
+      "component": "Column",
+      "gap": "3",
+      "children": [
+        "maptitle",
+        "mr1",
+        "mr2",
+        "mr3"
+      ]
+    },
+    {
+      "id": "maptitle",
+      "component": "Text",
+      "variant": "section",
+      "textContent": "Map columns"
+    },
+    {
+      "id": "mr1",
+      "$fragment": "labeled-input",
+      "bindings": {
+        "label": "Name",
+        "value": "full_name"
+      }
+    },
+    {
+      "id": "mr2",
+      "$fragment": "labeled-input",
+      "bindings": {
+        "label": "Email",
+        "value": "email_addr"
+      }
+    },
+    {
+      "id": "mr3",
+      "$fragment": "labeled-input",
+      "bindings": {
+        "label": "Role",
+        "value": "team_role"
+      }
+    },
+    {
+      "id": "preview",
+      "component": "Alert",
+      "variant": "info",
+      "title": "Preview: 248 rows ready to import",
+      "description": "3 warnings found \u2014 click Next to review."
+    },
+    {
+      "id": "ftr",
+      "component": "Footer",
+      "children": [
+        "ftrow"
+      ]
+    },
+    {
+      "id": "ftrow",
+      "component": "Row",
+      "gap": "2",
+      "align": "center",
+      "children": [
+        "prev",
+        "next"
+      ]
+    },
+    {
+      "id": "prev",
+      "component": "Button",
+      "variant": "outline",
+      "icon": "chevron-left",
+      "text": "Previous"
+    },
+    {
+      "id": "next",
+      "component": "Button",
+      "variant": "primary",
+      "icon": "chevron-right",
+      "text": "Next"
+    }
+  ]
+}

package/compositions/forms/change-password-form.json

@@ -0,0 +1,32 @@
+{
+  "$schema": "../_schema.json",
+  "name": "change-password-form",
+  "version": 1,
+  "kind": "composition",
+  "domain": "forms",
+  "description": "Change existing password — current password plus new password with confirmation.",
+  "tags": {
+    "purpose": ["auth", "account", "security"],
+    "complexity": "simple",
+    "layout": "single-column",
+    "interaction": ["form-submit"]
+  },
+  "keywords": ["change password", "update password", "security", "credentials"],
+  "related": ["password-reset-form", "login-form"],
+
+  "template": [
+    { "id": "root", "component": "Card", "children": ["hdr", "sec", "ftr"] },
+    { "id": "hdr", "$fragment": "card-header-with-description",
+      "bindings": { "heading": "Change password", "description": "Use at least 8 characters with a mix of letters and numbers." } },
+    { "id": "sec", "component": "Section", "children": ["col"] },
+    { "id": "col", "component": "Column", "children": ["current", "next", "confirm"], "gap": "4" },
+    { "id": "current", "$fragment": "labeled-input",
+      "bindings": { "label": "Current password", "name": "currentPassword", "type": "password", "placeholder": "••••••••" } },
+    { "id": "next",    "$fragment": "labeled-input",
+      "bindings": { "label": "New password",     "name": "newPassword",     "type": "password", "placeholder": "••••••••" } },
+    { "id": "confirm", "$fragment": "labeled-input",
+      "bindings": { "label": "Confirm new password", "name": "confirmPassword", "type": "password", "placeholder": "••••••••" } },
+    { "id": "ftr", "$fragment": "footer-cancel-save",
+      "bindings": { "cancelLabel": "Cancel", "confirmLabel": "Update password" } }
+  ]
+}