@adia-ai/a2ui-corpus 0.0.1

package/patterns/agent/_domain.json

@@ -0,0 +1,27 @@
+{
+  "domain": "agent",
+  "description": "Agent interaction patterns for chat, messaging, notifications, alerts, streaming, and command interfaces.",
+  "routing_keywords": [
+    "chat", "message", "messaging", "notification", "notifications",
+    "alert", "alerts", "toast", "command", "stream", "streaming",
+    "response", "bot", "assistant", "ai", "conversation", "inbox",
+    "snackbar", "banner", "warning", "error", "success", "info",
+    "realtime", "live", "prompt"
+  ],
+  "common_components": ["Card", "Column", "Row", "Text", "Badge", "Button", "Icon"],
+  "composition_hints": {
+    "typical_root": "Column",
+    "typical_structure": "Column > message/alert items stacked vertically",
+    "common_pairs": [
+      ["Card", "Row(icon + Column(text))"],
+      ["Column", "Card[message]*"],
+      ["Row", "Badge + Text"],
+      ["Card", "Header + Section + Footer"]
+    ]
+  },
+  "patterns": [
+    "streaming-response",
+    "notifications",
+    "toast-notification"
+  ]
+}

package/patterns/agent/alert-banner.json

@@ -0,0 +1,41 @@
+{
+  "$schema": "../_schema.json",
+  "name": "alert-banner",
+  "version": 1,
+  "domain": "agent",
+  "primitive": true,
+  "description": "Single alert component with icon and dismiss action.",
+  "tags": {
+    "purpose": [
+      "feedback",
+      "primitive"
+    ],
+    "complexity": "primitive",
+    "layout": "single-column",
+    "interaction": [
+      "dismiss"
+    ]
+  },
+  "keywords": [
+    "alert",
+    "banner",
+    "notification",
+    "info",
+    "dismiss"
+  ],
+  "related": [
+    "toast-notification",
+    "error-state"
+  ],
+  "template": [
+    {
+      "id": "root",
+      "component": "Alert",
+      "variant": "info",
+      "icon": "info-circle",
+      "title": "System Update",
+      "description": "A new version is available. Please refresh to get the latest features.",
+      "dismissible": true
+    }
+  ]
+}

package/patterns/agent/alert-banner.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/pattern.yaml.schema.json
+name: alert-banner
+domain: agent
+version: 1
+description: Single alert component with icon and dismiss action.
+tags:
+  purpose:
+    - feedback
+    - primitive
+  complexity: primitive
+  layout: single-column
+  interaction:
+    - dismiss
+keywords:
+  - alert
+  - banner
+  - notification
+  - info
+  - dismiss
+related:
+  - toast-notification
+  - error-state
+use-cases:
+  - "TODO: primary use case"
+  - "TODO: secondary use case"
+variants:
+  - name: TODO
+    description: "TODO: variant description"
+wiring-intent:
+  summary: Static pattern (no interactive wiring).
+  controllers: []
+  actions: []
+components:
+  - Alert

package/patterns/agent/chat-interface.json

@@ -0,0 +1,205 @@
+{
+  "$schema": "../_schema.json",
+  "name": "chat-interface",
+  "version": 1,
+  "domain": "agent",
+  "description": "Chat interface with message bubbles containing avatar and text pairs, plus an input footer.",
+  "tags": {
+    "purpose": [
+      "messaging"
+    ],
+    "complexity": "composed",
+    "layout": "single-column",
+    "interaction": [
+      "input",
+      "scroll"
+    ]
+  },
+  "keywords": [
+    "chat",
+    "messages",
+    "conversation",
+    "ai",
+    "bubbles",
+    "interface"
+  ],
+  "related": [
+    "streaming-response",
+    "command-palette"
+  ],
+  "template": [
+    {
+      "id": "root",
+      "component": "Card",
+      "children": [
+        "hdr",
+        "sec",
+        "ftr"
+      ]
+    },
+    {
+      "id": "hdr",
+      "component": "Header",
+      "children": [
+        "title"
+      ]
+    },
+    {
+      "id": "title",
+      "component": "Text",
+      "slot": "heading",
+      "textContent": "Chat"
+    },
+    {
+      "id": "sec",
+      "component": "Section",
+      "children": [
+        "messages"
+      ]
+    },
+    {
+      "id": "messages",
+      "component": "Column",
+      "gap": "3",
+      "children": [
+        "msg1",
+        "msg2",
+        "msg3",
+        "msg4"
+      ]
+    },
+    {
+      "id": "msg1",
+      "component": "Row",
+      "gap": "2",
+      "children": [
+        "a1",
+        "t1"
+      ]
+    },
+    {
+      "id": "a1",
+      "component": "Avatar",
+      "name": "User",
+      "size": "sm"
+    },
+    {
+      "id": "t1",
+      "component": "Text",
+      "variant": "body",
+      "textContent": "Hello! Can you help me with something?"
+    },
+    {
+      "id": "msg2",
+      "component": "Row",
+      "gap": "2",
+      "children": [
+        "a2",
+        "t2"
+      ]
+    },
+    {
+      "id": "a2",
+      "component": "Avatar",
+      "name": "Assistant",
+      "size": "sm"
+    },
+    {
+      "id": "t2",
+      "component": "Text",
+      "variant": "body",
+      "textContent": "Of course! I'd be happy to help. What do you need?"
+    },
+    {
+      "id": "msg3",
+      "component": "Row",
+      "gap": "2",
+      "children": [
+        "a3",
+        "t3"
+      ]
+    },
+    {
+      "id": "a3",
+      "component": "Avatar",
+      "name": "User",
+      "size": "sm"
+    },
+    {
+      "id": "t3",
+      "component": "Text",
+      "variant": "body",
+      "textContent": "I need to build a dashboard layout."
+    },
+    {
+      "id": "msg4",
+      "component": "Row",
+      "gap": "2",
+      "children": [
+        "a4",
+        "t4"
+      ]
+    },
+    {
+      "id": "a4",
+      "component": "Avatar",
+      "name": "Assistant",
+      "size": "sm"
+    },
+    {
+      "id": "t4",
+      "component": "Text",
+      "variant": "body",
+      "textContent": "Great choice! Let me suggest some patterns for that."
+    },
+    {
+      "id": "ftr",
+      "component": "Footer",
+      "children": [
+        "input-row"
+      ]
+    },
+    {
+      "id": "input-row",
+      "component": "Row",
+      "gap": "2",
+      "children": [
+        "chat-input",
+        "send-btn"
+      ]
+    },
+    {
+      "id": "chat-input",
+      "component": "Input",
+      "placeholder": "Type a message..."
+    },
+    {
+      "id": "send-btn",
+      "component": "Button",
+      "text": "Send",
+      "icon": "send",
+      "variant": "primary"
+    }
+  ],
+  "wiring": {
+    "controllers": [
+      { "id": "stream-ctrl", "type": "DataStreamController", "host": "messages",
+        "config": { "autoScroll": true },
+        "bind": { "items": "/chat/messages" } }
+    ],
+    "actions": [
+      { "event": { "event": "press", "target": "send-btn" },
+        "handler": "submit-resource",
+        "config": { "uri": "api://chat/messages", "method": "POST" },
+        "onSuccess": [{ "handler": "refresh-source", "config": { "source": "chat-stream" } }]
+      },
+      { "event": { "event": "submit", "target": "chat-input" },
+        "handler": "submit-resource",
+        "config": { "uri": "api://chat/messages", "method": "POST" }
+      }
+    ],
+    "data": [
+      { "uri": "api://chat/messages", "refresh": "stream" }
+    ]
+  }
+}

package/patterns/agent/chat-interface.yaml

@@ -0,0 +1,58 @@
+# 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/pattern.yaml.schema.json
+name: chat-interface
+domain: agent
+version: 1
+description: >-
+  Chat interface with message bubbles containing avatar and text pairs, plus an input footer.
+tags:
+  purpose:
+    - messaging
+  complexity: composed
+  layout: single-column
+  interaction:
+    - input
+    - scroll
+keywords:
+  - chat
+  - messages
+  - conversation
+  - ai
+  - bubbles
+  - interface
+related:
+  - streaming-response
+  - command-palette
+use-cases:
+  - "TODO: primary use case"
+  - "TODO: secondary use case"
+variants:
+  - name: TODO
+    description: "TODO: variant description"
+wiring-intent:
+  summary: "TODO: describe wiring intent"
+  controllers:
+    - id: stream-ctrl
+      type: DataStreamController
+      host: messages
+  actions:
+    - event: press
+      target: send-btn
+      handler: submit-resource
+    - event: submit
+      target: chat-input
+      handler: submit-resource
+components:
+  - Card
+  - Header
+  - Text
+  - Section
+  - Column
+  - Row
+  - Avatar
+  - Footer
+  - Input
+  - Button

package/patterns/agent/command-palette.json

@@ -0,0 +1,169 @@
+{
+  "$schema": "../_schema.json",
+  "name": "command-palette",
+  "version": 1,
+  "domain": "agent",
+  "primitive": true,
+  "description": "Command palette card with search input and a list of command options.",
+  "tags": {
+    "purpose": [
+      "search",
+      "primitive"
+    ],
+    "complexity": "composed",
+    "layout": "single-column",
+    "interaction": [
+      "input",
+      "navigation"
+    ]
+  },
+  "keywords": [
+    "command",
+    "palette",
+    "search",
+    "quick-actions",
+    "spotlight",
+    "omnibar"
+  ],
+  "related": [
+    "kbd-shortcuts",
+    "chat-interface"
+  ],
+  "template": [
+    {
+      "id": "root",
+      "component": "Card",
+      "children": [
+        "hdr",
+        "sec"
+      ]
+    },
+    {
+      "id": "hdr",
+      "component": "Header",
+      "children": [
+        "search"
+      ]
+    },
+    {
+      "id": "search",
+      "component": "Input",
+      "placeholder": "Type a command or search...",
+      "icon": "search"
+    },
+    {
+      "id": "sec",
+      "component": "Section",
+      "children": [
+        "options"
+      ]
+    },
+    {
+      "id": "options",
+      "component": "Column",
+      "gap": "1",
+      "children": [
+        "opt1",
+        "opt2",
+        "opt3",
+        "opt4",
+        "opt5"
+      ]
+    },
+    {
+      "id": "opt1",
+      "component": "Row",
+      "gap": "2",
+      "children": [
+        "i1",
+        "l1"
+      ]
+    },
+    {
+      "id": "i1",
+      "component": "Icon",
+      "name": "file"
+    },
+    {
+      "id": "l1",
+      "component": "Text",
+      "textContent": "Open File"
+    },
+    {
+      "id": "opt2",
+      "component": "Row",
+      "gap": "2",
+      "children": [
+        "i2",
+        "l2"
+      ]
+    },
+    {
+      "id": "i2",
+      "component": "Icon",
+      "name": "gear"
+    },
+    {
+      "id": "l2",
+      "component": "Text",
+      "textContent": "Settings"
+    },
+    {
+      "id": "opt3",
+      "component": "Row",
+      "gap": "2",
+      "children": [
+        "i3",
+        "l3"
+      ]
+    },
+    {
+      "id": "i3",
+      "component": "Icon",
+      "name": "palette"
+    },
+    {
+      "id": "l3",
+      "component": "Text",
+      "textContent": "Change Theme"
+    },
+    {
+      "id": "opt4",
+      "component": "Row",
+      "gap": "2",
+      "children": [
+        "i4",
+        "l4"
+      ]
+    },
+    {
+      "id": "i4",
+      "component": "Icon",
+      "name": "users"
+    },
+    {
+      "id": "l4",
+      "component": "Text",
+      "textContent": "Manage Users"
+    },
+    {
+      "id": "opt5",
+      "component": "Row",
+      "gap": "2",
+      "children": [
+        "i5",
+        "l5"
+      ]
+    },
+    {
+      "id": "i5",
+      "component": "Icon",
+      "name": "sign-out"
+    },
+    {
+      "id": "l5",
+      "component": "Text",
+      "textContent": "Sign Out"
+    }
+  ]
+}

package/patterns/agent/command-palette.yaml

@@ -0,0 +1,48 @@
+# 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/pattern.yaml.schema.json
+name: command-palette
+domain: agent
+version: 1
+description: >-
+  Command palette card with search input and a list of command options.
+tags:
+  purpose:
+    - search
+    - primitive
+  complexity: composed
+  layout: single-column
+  interaction:
+    - input
+    - navigation
+keywords:
+  - command
+  - palette
+  - search
+  - quick-actions
+  - spotlight
+  - omnibar
+related:
+  - kbd-shortcuts
+  - chat-interface
+use-cases:
+  - "TODO: primary use case"
+  - "TODO: secondary use case"
+variants:
+  - name: TODO
+    description: "TODO: variant description"
+wiring-intent:
+  summary: Static pattern (no interactive wiring).
+  controllers: []
+  actions: []
+components:
+  - Card
+  - Header
+  - Input
+  - Section
+  - Column
+  - Row
+  - Icon
+  - Text

package/patterns/agent/empty-state.json

@@ -0,0 +1,77 @@
+{
+  "$schema": "../_schema.json",
+  "name": "empty-state",
+  "version": 1,
+  "domain": "agent",
+  "primitive": true,
+  "description": "Empty state component with icon, heading, description, and call-to-action button.",
+  "tags": {
+    "purpose": [
+      "feedback",
+      "primitive"
+    ],
+    "complexity": "simple",
+    "layout": "single-column",
+    "interaction": [
+      "click"
+    ]
+  },
+  "keywords": [
+    "empty",
+    "state",
+    "placeholder",
+    "no-data",
+    "cta",
+    "onboarding"
+  ],
+  "related": [
+    "error-state",
+    "loading-skeleton"
+  ],
+  "template": [
+    {
+      "id": "root",
+      "component": "EmptyState",
+      "children": [
+        "content"
+      ]
+    },
+    {
+      "id": "content",
+      "component": "Column",
+      "align": "center",
+      "gap": "3",
+      "children": [
+        "icon",
+        "heading",
+        "desc",
+        "cta"
+      ]
+    },
+    {
+      "id": "icon",
+      "component": "Icon",
+      "name": "inbox",
+      "size": "xl"
+    },
+    {
+      "id": "heading",
+      "component": "Text",
+      "variant": "heading",
+      "textContent": "No items yet"
+    },
+    {
+      "id": "desc",
+      "component": "Text",
+      "variant": "body",
+      "textContent": "Get started by creating your first item. It only takes a moment."
+    },
+    {
+      "id": "cta",
+      "component": "Button",
+      "text": "Create Item",
+      "icon": "plus",
+      "variant": "primary"
+    }
+  ]
+}

package/patterns/agent/empty-state.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/pattern.yaml.schema.json
+name: empty-state
+domain: agent
+version: 1
+description: >-
+  Empty state component with icon, heading, description, and call-to-action button.
+tags:
+  purpose:
+    - feedback
+    - primitive
+  complexity: simple
+  layout: single-column
+  interaction:
+    - click
+keywords:
+  - empty
+  - state
+  - placeholder
+  - no-data
+  - cta
+  - onboarding
+related:
+  - error-state
+  - loading-skeleton
+use-cases:
+  - "TODO: primary use case"
+  - "TODO: secondary use case"
+variants:
+  - name: TODO
+    description: "TODO: variant description"
+wiring-intent:
+  summary: Static pattern (no interactive wiring).
+  controllers: []
+  actions: []
+components:
+  - EmptyState
+  - Column
+  - Icon
+  - Text
+  - Button