@adia-ai/a2ui-corpus 0.0.1

package/compositions/layout/three-pane-shell.json

@@ -0,0 +1,316 @@
+{
+  "$schema": "../_schema.json",
+  "name": "three-pane-shell",
+  "version": 1,
+  "kind": "composition",
+  "domain": "layout",
+  "description": "Three-pane application shell \u2014 a list pane on the left, a detail pane in the middle, and a context pane on the right. The canonical Linear / Superhuman / Attio / Apple Mail workbench layout. Each pane is an explicitly labeled region: the list pane renders an item List, the detail pane renders a record Header with Tabs and a DescriptionList, and the context pane renders a Card with related metadata.",
+  "tags": {
+    "purpose": [
+      "app-shell",
+      "workbench",
+      "layout",
+      "list-pane",
+      "detail-pane",
+      "context-pane"
+    ],
+    "complexity": "composed",
+    "layout": "three-column"
+  },
+  "keywords": [
+    "three pane",
+    "three-pane",
+    "list pane",
+    "detail pane",
+    "context pane",
+    "list detail context",
+    "workbench",
+    "linear layout",
+    "mail app",
+    "superhuman",
+    "attio",
+    "app shell",
+    "inbox detail",
+    "master detail inspector",
+    "split view"
+  ],
+  "template": [
+    {
+      "id": "root",
+      "component": "Grid",
+      "columns": "3",
+      "gap": "0",
+      "children": [
+        "pane-list",
+        "pane-detail",
+        "pane-context"
+      ]
+    },
+    {
+      "id": "pane-list",
+      "component": "Pane",
+      "resizable": true,
+      "minWidth": 240,
+      "children": [
+        "list-label",
+        "ph1",
+        "list-search",
+        "list-nav",
+        "list-items"
+      ]
+    },
+    {
+      "id": "list-label",
+      "component": "Text",
+      "variant": "caption",
+      "color": "subtle",
+      "textContent": "LIST PANE \u00b7 selectable master list \u00b7 click or keyboard-navigate to select \u00b7 selection syncs to detail pane on the right"
+    },
+    {
+      "id": "ph1",
+      "$fragment": "card-header-heading",
+      "bindings": {
+        "heading": "Inbox \u00b7 24"
+      }
+    },
+    {
+      "id": "list-search",
+      "component": "Input",
+      "placeholder": "Search inbox\u2026",
+      "icon": "magnifying-glass",
+      "size": "sm"
+    },
+    {
+      "id": "list-nav",
+      "component": "Nav",
+      "children": [
+        "nav-all",
+        "nav-unread",
+        "nav-starred"
+      ]
+    },
+    {
+      "id": "nav-all",
+      "component": "Button",
+      "variant": "ghost",
+      "size": "sm",
+      "textContent": "All \u00b7 24"
+    },
+    {
+      "id": "nav-unread",
+      "component": "Button",
+      "variant": "ghost",
+      "size": "sm",
+      "textContent": "Unread \u00b7 6"
+    },
+    {
+      "id": "nav-starred",
+      "component": "Button",
+      "variant": "ghost",
+      "size": "sm",
+      "textContent": "Starred \u00b7 3"
+    },
+    {
+      "id": "list-items",
+      "component": "List",
+      "selectable": true,
+      "selectedKey": "lh-todo-selected",
+      "children": [
+        "lh-todo-selected",
+        "lh-doing",
+        "lh-done",
+        "lh-old",
+        "lh-5",
+        "lh-6"
+      ]
+    },
+    {
+      "id": "lh-todo-selected",
+      "component": "Row",
+      "gap": "2",
+      "align": "center",
+      "selected": true,
+      "aria-selected": "true",
+      "children": [
+        "lh-todo-sel-badge",
+        "lh-todo-inner"
+      ]
+    },
+    {
+      "id": "lh-todo-sel-badge",
+      "component": "Badge",
+      "variant": "primary",
+      "textContent": "Selected"
+    },
+    {
+      "id": "lh-todo-inner",
+      "$fragment": "user-identity-row",
+      "bindings": {
+        "avatarName": "Helena Moreau",
+        "primary": "Helena Moreau",
+        "secondary": "Ship v1.2 release notes \u00b7 9:14"
+      }
+    },
+    {
+      "id": "lh-doing",
+      "$fragment": "user-identity-row",
+      "bindings": {
+        "avatarName": "Priya Patel",
+        "primary": "Priya Patel",
+        "secondary": "Design review \u2014 inspector \u00b7 8:02"
+      }
+    },
+    {
+      "id": "lh-done",
+      "$fragment": "user-identity-row",
+      "bindings": {
+        "avatarName": "Marcus Johnson",
+        "primary": "Marcus Johnson",
+        "secondary": "Weekly eng digest \u00b7 Tue"
+      }
+    },
+    {
+      "id": "lh-old",
+      "$fragment": "user-identity-row",
+      "bindings": {
+        "avatarName": "Jordan Kim",
+        "primary": "Jordan Kim",
+        "secondary": "QA \u2014 smoke suite flaky \u00b7 Mon"
+      }
+    },
+    {
+      "id": "lh-5",
+      "$fragment": "user-identity-row",
+      "bindings": {
+        "avatarName": "Sara Ono",
+        "primary": "Sara Ono",
+        "secondary": "Invoice approved \u00b7 Mon"
+      }
+    },
+    {
+      "id": "lh-6",
+      "$fragment": "user-identity-row",
+      "bindings": {
+        "avatarName": "Luis Cruz",
+        "primary": "Luis Cruz",
+        "secondary": "Quarterly review \u00b7 Sun"
+      }
+    },
+    {
+      "id": "pane-detail",
+      "component": "Pane",
+      "resizable": true,
+      "minWidth": 400,
+      "children": [
+        "detail-label",
+        "dh",
+        "dprops",
+        "dbody",
+        "dactions"
+      ]
+    },
+    {
+      "id": "detail-label",
+      "component": "Text",
+      "variant": "caption",
+      "color": "subtle",
+      "textContent": "DETAIL PANE \u00b7 showing details for currently-selected list item (selection syncs from list pane via selectable List + selectedKey)"
+    },
+    {
+      "id": "dh",
+      "$fragment": "card-header-with-description",
+      "bindings": {
+        "heading": "Ship v1.2 release notes",
+        "description": "Helena Moreau \u00b7 9:14 AM"
+      }
+    },
+    {
+      "id": "dprops",
+      "component": "DescriptionList",
+      "layout": "inline",
+      "align": "between",
+      "textContent": "From\tHelena Moreau\nTo\tEngineering\nSubject\tShip v1.2 release notes\nLabels\trelease, docs"
+    },
+    {
+      "id": "dbody",
+      "component": "Text",
+      "textContent": "Hey team \u2014 final draft of the v1.2 release notes is ready for review. Please leave comments by EOD Thursday."
+    },
+    {
+      "id": "dactions",
+      "component": "Row",
+      "gap": "2",
+      "children": [
+        "dbtn1",
+        "dbtn2",
+        "dbtn3"
+      ]
+    },
+    {
+      "id": "dbtn1",
+      "component": "Button",
+      "variant": "primary",
+      "textContent": "Reply"
+    },
+    {
+      "id": "dbtn2",
+      "component": "Button",
+      "variant": "outline",
+      "textContent": "Reply all"
+    },
+    {
+      "id": "dbtn3",
+      "component": "Button",
+      "variant": "ghost",
+      "textContent": "Forward"
+    },
+    {
+      "id": "pane-context",
+      "component": "Pane",
+      "resizable": true,
+      "collapsed": false,
+      "minWidth": 280,
+      "children": [
+        "context-label",
+        "ch",
+        "cuser",
+        "cdiv1",
+        "clist"
+      ]
+    },
+    {
+      "id": "context-label",
+      "component": "Text",
+      "variant": "caption",
+      "color": "subtle",
+      "textContent": "CONTEXT PANE \u00b7 related metadata/records for the currently-selected item from the list"
+    },
+    {
+      "id": "ch",
+      "$fragment": "card-header-heading",
+      "bindings": {
+        "heading": "Context"
+      }
+    },
+    {
+      "id": "cuser",
+      "$fragment": "user-identity-row",
+      "bindings": {
+        "avatarName": "Helena Moreau",
+        "primary": "Helena Moreau",
+        "secondary": "helena@acme.io"
+      }
+    },
+    {
+      "id": "cdiv1",
+      "component": "Divider"
+    },
+    {
+      "id": "clist",
+      "component": "DescriptionList",
+      "layout": "inline",
+      "align": "between",
+      "textContent": "PR\t#4812 \u2014 v1.2 release\nMeeting\tRelease review \u00b7 Thu 3 PM\nDoc\tRELEASE.md"
+    }
+  ]
+}

package/compositions/layout/toolbar-actions.json

@@ -0,0 +1,22 @@
+{
+  "$schema": "../_schema.json",
+  "name": "toolbar-actions",
+  "version": 1,
+  "kind": "composition",
+  "domain": "layout",
+  "description": "Toolbar with grouped icon buttons separated by dividers — for editor surfaces, formatting bars, and action rails.",
+  "tags": { "purpose": ["toolbar", "actions"], "complexity": "atomic", "layout": "row" },
+  "keywords": ["toolbar", "actions", "icon buttons", "formatting"],
+
+  "template": [
+    { "id": "root", "component": "Toolbar", "children": ["b1", "b2", "b3", "d1", "b4", "b5", "d2", "b6"] },
+    { "id": "b1", "component": "Button", "variant": "ghost", "icon": "bold",      "ariaLabel": "Bold" },
+    { "id": "b2", "component": "Button", "variant": "ghost", "icon": "italic",    "ariaLabel": "Italic" },
+    { "id": "b3", "component": "Button", "variant": "ghost", "icon": "underline", "ariaLabel": "Underline" },
+    { "id": "d1", "component": "Divider", "orientation": "vertical" },
+    { "id": "b4", "component": "Button", "variant": "ghost", "icon": "list",     "ariaLabel": "List" },
+    { "id": "b5", "component": "Button", "variant": "ghost", "icon": "list-ol",  "ariaLabel": "Ordered list" },
+    { "id": "d2", "component": "Divider", "orientation": "vertical" },
+    { "id": "b6", "component": "Button", "variant": "ghost", "icon": "link",     "ariaLabel": "Link" }
+  ]
+}

package/compositions/layout/toolbar-actions.yaml

@@ -0,0 +1,29 @@
+# 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: toolbar-actions
+domain: layout
+description: >-
+  Toolbar with grouped icon buttons separated by dividers — for editor surfaces, formatting bars, and action rails.
+keywords:
+  - toolbar
+  - actions
+  - icon buttons
+  - formatting
+tags:
+  purpose:
+    - toolbar
+    - actions
+  complexity: atomic
+  layout: row
+related: []
+fragments_used: []
+use-cases:
+  - "TODO: primary use case"
+wiring-intent:
+  summary: Static composition (no interactive wiring).
+  controllers: []
+  actions: []

package/compositions/navigation/breadcrumb-nav.json

@@ -0,0 +1,18 @@
+{
+  "$schema": "../_schema.json",
+  "name": "breadcrumb-nav",
+  "version": 1,
+  "kind": "composition",
+  "domain": "navigation",
+  "description": "Breadcrumb navigation trail — shows the hierarchy from root to current page.",
+  "tags": { "purpose": ["navigation", "breadcrumb"], "complexity": "atomic", "layout": "row" },
+  "keywords": ["breadcrumb", "trail", "navigation", "path"],
+
+  "template": [
+    { "id": "root", "component": "Breadcrumb", "children": ["b1", "b2", "b3", "b4"] },
+    { "id": "b1", "component": "Text", "variant": "body", "textContent": "Home" },
+    { "id": "b2", "component": "Text", "variant": "body", "textContent": "Projects" },
+    { "id": "b3", "component": "Text", "variant": "body", "textContent": "Acme" },
+    { "id": "b4", "component": "Text", "variant": "body", "textContent": "Settings" }
+  ]
+}

package/compositions/navigation/breadcrumb-nav.yaml

@@ -0,0 +1,29 @@
+# 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: breadcrumb-nav
+domain: navigation
+description: >-
+  Breadcrumb navigation trail — shows the hierarchy from root to current page.
+keywords:
+  - breadcrumb
+  - trail
+  - navigation
+  - path
+tags:
+  purpose:
+    - navigation
+    - breadcrumb
+  complexity: atomic
+  layout: row
+related: []
+fragments_used: []
+use-cases:
+  - "TODO: primary use case"
+wiring-intent:
+  summary: Static composition (no interactive wiring).
+  controllers: []
+  actions: []

package/compositions/navigation/nav-menu-with-icons.json

@@ -0,0 +1,25 @@
+{
+  "$schema": "../_schema.json",
+  "name": "nav-menu-with-icons",
+  "version": 1,
+  "kind": "composition",
+  "domain": "navigation",
+  "description": "Navigation menu with icons and text labels — for sidebar menus and app navigation.",
+  "tags": {
+    "purpose": ["navigation"],
+    "complexity": "simple",
+    "layout": "single-column",
+    "interaction": ["navigation"]
+  },
+  "keywords": ["navigation", "menu", "icons", "vertical", "sidebar menu"],
+
+  "template": [
+    { "id": "root", "component": "Nav", "children": ["col"] },
+    { "id": "col",  "component": "Column", "children": ["n1", "n2", "n3", "n4"], "gap": "1" },
+
+    { "id": "n1", "$fragment": "icon-text-row", "bindings": { "icon": "house",      "label": "Dashboard" } },
+    { "id": "n2", "$fragment": "icon-text-row", "bindings": { "icon": "chart-bar",  "label": "Analytics" } },
+    { "id": "n3", "$fragment": "icon-text-row", "bindings": { "icon": "users",      "label": "Users" } },
+    { "id": "n4", "$fragment": "icon-text-row", "bindings": { "icon": "gear",       "label": "Settings" } }
+  ]
+}

package/compositions/navigation/nav-menu-with-icons.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/composition.yaml.schema.json
+kind: composition
+name: nav-menu-with-icons
+domain: navigation
+description: >-
+  Navigation menu with icons and text labels — for sidebar menus and app navigation.
+keywords:
+  - navigation
+  - menu
+  - icons
+  - vertical
+  - sidebar menu
+tags:
+  purpose:
+    - navigation
+  complexity: simple
+  layout: single-column
+  interaction:
+    - navigation
+related: []
+fragments_used:
+  - fragment: icon-text-row
+    prefix: ""
+  - fragment: icon-text-row
+    prefix: ""
+  - fragment: icon-text-row
+    prefix: ""
+  - fragment: icon-text-row
+    prefix: ""
+use-cases:
+  - "TODO: primary use case"
+wiring-intent:
+  summary: Static composition (no interactive wiring).
+  controllers: []
+  actions: []

package/compositions/navigation/pagination-controls.json

@@ -0,0 +1,44 @@
+{
+  "$schema": "../_schema.json",
+  "name": "pagination-controls",
+  "version": 1,
+  "kind": "composition",
+  "domain": "data",
+  "description": "Row with centered pagination component for navigating paged content.",
+  "tags": {
+    "purpose": [
+      "navigation",
+      "primitive",
+      "data-display"
+    ],
+    "complexity": "simple",
+    "layout": "single-row",
+    "interaction": [
+      "pagination"
+    ]
+  },
+  "keywords": [
+    "pagination",
+    "pages",
+    "next",
+    "previous",
+    "navigate",
+    "pager"
+  ],
+  "template": [
+    {
+      "id": "root",
+      "component": "Row",
+      "justify": "center",
+      "children": [
+        "pager"
+      ]
+    },
+    {
+      "id": "pager",
+      "component": "Pagination",
+      "totalPages": 10,
+      "currentPage": 1
+    }
+  ]
+}

package/compositions/navigation/pagination-controls.yaml

@@ -0,0 +1,34 @@
+# 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: pagination-controls
+domain: data
+description: >-
+  Row with centered pagination component for navigating paged content.
+keywords:
+  - pagination
+  - pages
+  - next
+  - previous
+  - navigate
+  - pager
+tags:
+  purpose:
+    - navigation
+    - primitive
+    - data-display
+  complexity: simple
+  layout: single-row
+  interaction:
+    - pagination
+related: []
+fragments_used: []
+use-cases:
+  - "TODO: primary use case"
+wiring-intent:
+  summary: Static composition (no interactive wiring).
+  controllers: []
+  actions: []

package/compositions/navigation/segmented-control-tabs.json

@@ -0,0 +1,17 @@
+{
+  "$schema": "../_schema.json",
+  "name": "segmented-control-tabs",
+  "version": 1,
+  "kind": "composition",
+  "domain": "navigation",
+  "description": "Segmented control for toggling between 2–4 views — compact alternative to full tabs.",
+  "tags": { "purpose": ["navigation", "view-toggle"], "complexity": "atomic", "layout": "row" },
+  "keywords": ["segmented control", "segment", "toggle", "view switcher"],
+
+  "template": [
+    { "id": "root", "component": "SegmentedControl", "children": ["s1", "s2", "s3"], "value": "s1" },
+    { "id": "s1", "component": "Segment", "value": "s1", "label": "Day" },
+    { "id": "s2", "component": "Segment", "value": "s2", "label": "Week" },
+    { "id": "s3", "component": "Segment", "value": "s3", "label": "Month" }
+  ]
+}

package/compositions/navigation/segmented-control-tabs.yaml

@@ -0,0 +1,29 @@
+# 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: segmented-control-tabs
+domain: navigation
+description: >-
+  Segmented control for toggling between 2–4 views — compact alternative to full tabs.
+keywords:
+  - segmented control
+  - segment
+  - toggle
+  - view switcher
+tags:
+  purpose:
+    - navigation
+    - view-toggle
+  complexity: atomic
+  layout: row
+related: []
+fragments_used: []
+use-cases:
+  - "TODO: primary use case"
+wiring-intent:
+  summary: Static composition (no interactive wiring).
+  controllers: []
+  actions: []

package/compositions/navigation/workspace-switcher.json

@@ -0,0 +1,29 @@
+{
+  "$schema": "../_schema.json",
+  "name": "workspace-switcher",
+  "version": 1,
+  "kind": "composition",
+  "domain": "navigation",
+  "description": "Workspace / organization picker popover — current workspace at the top, searchable list of teams, and a create-new affordance. The Linear / Slack / Notion top-left flyout.",
+  "tags": { "purpose": ["workspace", "org-picker", "account-switcher"], "complexity": "composed", "layout": "popover" },
+  "keywords": ["workspace switcher", "workspace picker", "org switcher", "organization picker", "team switcher", "account switcher", "tenant picker", "multi-tenant", "linear workspace", "slack workspace", "notion workspace"],
+
+  "template": [
+    { "id": "root", "component": "Popover", "open": true, "children": ["pop-header", "card"] },
+    { "id": "pop-header", "component": "Header", "textContent": "Switch workspace" },
+    { "id": "card", "component": "Card", "children": ["head", "sec", "foot"] },
+    { "id": "head", "$fragment": "card-header-with-description", "bindings": { "heading": "Acme", "description": "acme.adiaui.app · Pro plan" } },
+
+    { "id": "sec", "component": "Section", "children": ["search", "list"] },
+    { "id": "search", "component": "Input", "placeholder": "Find a workspace…", "icon": "magnifying-glass", "size": "sm" },
+    { "id": "list", "component": "List", "children": ["w1", "w2", "w3", "w4"] },
+    { "id": "w1", "$fragment": "user-notification-row", "bindings": { "avatarName": "Acme", "primary": "Acme", "secondary": "Owner · 42 members", "badgeLabel": "Current", "badgeVariant": "success" } },
+    { "id": "w2", "$fragment": "user-notification-row", "bindings": { "avatarName": "Northwind", "primary": "Northwind Co.", "secondary": "Admin · 120 members", "badgeLabel": "Admin", "badgeVariant": "muted" } },
+    { "id": "w3", "$fragment": "user-notification-row", "bindings": { "avatarName": "Globex", "primary": "Globex", "secondary": "Member · Free plan", "badgeLabel": "Member", "badgeVariant": "muted" } },
+    { "id": "w4", "$fragment": "user-notification-row", "bindings": { "avatarName": "Initech", "primary": "Initech", "secondary": "Guest", "badgeLabel": "Guest", "badgeVariant": "muted" } },
+
+    { "id": "foot", "component": "Footer", "children": ["fb1", "fb2"] },
+    { "id": "fb1", "component": "Button", "variant": "ghost", "icon": "plus", "textContent": "Create workspace", "block": true },
+    { "id": "fb2", "component": "Button", "variant": "ghost", "icon": "sign-in", "textContent": "Join a workspace", "block": true }
+  ]
+}