@adia-ai/a2ui-corpus 0.0.1

package/patterns/forms/image-upload-preview.json

@@ -0,0 +1,72 @@
+{
+  "$schema": "../_schema.json",
+  "name": "image-upload-preview",
+  "version": 2,
+  "domain": "forms",
+  "description": "Image upload with preview area and action buttons.",
+  "tags": {
+    "purpose": [
+      "media",
+      "data-entry"
+    ],
+    "complexity": "simple",
+    "layout": "single-column",
+    "interaction": [
+      "file-upload"
+    ]
+  },
+  "keywords": [
+    "image",
+    "upload",
+    "preview",
+    "photo",
+    "attachment"
+  ],
+  "related": [
+    "image-caption",
+    "data-import"
+  ],
+  "template": [
+    {
+      "id": "root",
+      "component": "Card",
+      "children": [
+        "sec"
+      ]
+    },
+    {
+      "id": "sec",
+      "component": "Section",
+      "children": [
+        "img",
+        "up-field",
+        "btn"
+      ]
+    },
+    {
+      "id": "img",
+      "component": "Image",
+      "src": "https://picsum.photos/400/200",
+      "aspect": "2/1"
+    },
+    {
+      "id": "up-field",
+      "component": "Field",
+      "label": "Drop image here",
+      "children": [
+        "up"
+      ]
+    },
+    {
+      "id": "up",
+      "component": "Upload",
+      "accept": "image/*"
+    },
+    {
+      "id": "btn",
+      "component": "Button",
+      "text": "Upload",
+      "variant": "primary"
+    }
+  ]
+}

package/patterns/forms/image-upload-preview.yaml

@@ -0,0 +1,42 @@
+# 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: image-upload-preview
+domain: forms
+version: 1
+description: Image upload with preview area and action buttons.
+tags:
+  purpose:
+    - media
+    - data-entry
+  complexity: simple
+  layout: single-column
+  interaction:
+    - file-upload
+keywords:
+  - image
+  - upload
+  - preview
+  - photo
+  - attachment
+related:
+  - image-caption
+  - data-import
+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
+  - Section
+  - Image
+  - Upload
+  - Button

package/patterns/forms/login-form.json

@@ -0,0 +1,213 @@
+{
+  "$schema": "../_schema.json",
+  "name": "login-form",
+  "version": 4,
+  "domain": "forms",
+  "description": "Login form with email, remember me, and a forgot-credentials link. FormController wiring with submit-to-resource + navigate-on-success.",
+  "tags": {
+    "purpose": [
+      "authentication",
+      "data-entry"
+    ],
+    "complexity": "composed",
+    "layout": "single-column",
+    "interaction": [
+      "form-submit"
+    ]
+  },
+  "keywords": [
+    "login",
+    "signin",
+    "auth",
+    "email",
+    "welcome back",
+    "sign in to your account",
+    "remember me",
+    "authenticate",
+    "credentials"
+  ],
+  "related": [
+    "auth-signup",
+    "otp-form",
+    "settings-page"
+  ],
+  "template": [
+    {
+      "id": "root",
+      "component": "Card",
+      "size": "lg",
+      "children": [
+        "root-hdr",
+        "root-sec",
+        "root-ftr"
+      ]
+    },
+    {
+      "id": "root-hdr",
+      "component": "Header",
+      "children": [
+        "root-title",
+        "root-desc"
+      ]
+    },
+    {
+      "id": "root-title",
+      "component": "Text",
+      "slot": "heading",
+      "variant": "section",
+      "textContent": "Welcome back"
+    },
+    {
+      "id": "root-desc",
+      "component": "Text",
+      "slot": "description",
+      "variant": "caption",
+      "textContent": "Sign in to your account",
+      "role": "description"
+    },
+    {
+      "id": "root-sec",
+      "component": "Section",
+      "children": [
+        "root-body"
+      ]
+    },
+    {
+      "id": "root-body",
+      "component": "Column",
+      "gap": "3",
+      "role": "container",
+      "children": [
+        "email-field",
+        "password-field",
+        "options"
+      ]
+    },
+    {
+      "id": "email-field",
+      "component": "Field",
+      "label": "Email",
+      "children": [
+        "email"
+      ]
+    },
+    {
+      "id": "email",
+      "component": "Input",
+      "role": "form-field",
+      "type": "email",
+      "name": "email",
+      "required": true,
+      "placeholder": "you@example.com"
+    },
+    {
+      "id": "password-field",
+      "component": "Field",
+      "label": "Password",
+      "children": [
+        "password"
+      ]
+    },
+    {
+      "id": "password",
+      "component": "Input",
+      "role": "form-field",
+      "type": "password",
+      "name": "password",
+      "required": true
+    },
+    {
+      "id": "options",
+      "component": "Row",
+      "gap": "2",
+      "justify": "between",
+      "children": [
+        "remember-field",
+        "forgot"
+      ]
+    },
+    {
+      "id": "remember-field",
+      "component": "Field",
+      "label": "Remember me",
+      "children": [
+        "remember"
+      ],
+      "inline": true
+    },
+    {
+      "id": "remember",
+      "component": "CheckBox",
+      "role": "form-field",
+      "name": "remember"
+    },
+    {
+      "id": "forgot",
+      "component": "Text",
+      "variant": "caption",
+      "textContent": "Forgot password?",
+      "role": "action"
+    },
+    {
+      "id": "root-ftr",
+      "component": "Footer",
+      "children": [
+        "root-action"
+      ]
+    },
+    {
+      "id": "root-action",
+      "component": "Button",
+      "variant": "primary",
+      "role": "action",
+      "text": "Sign In",
+      "block": true
+    }
+  ],
+  "wiring": {
+    "controllers": [
+      {
+        "id": "login-ctrl",
+        "type": "FormController",
+        "host": "root-body",
+        "config": {
+          "validateOn": "submit"
+        },
+        "bind": {
+          "values": "/form/values",
+          "valid": "/form/valid"
+        }
+      }
+    ],
+    "actions": [
+      {
+        "event": {
+          "event": "press",
+          "target": "root-action"
+        },
+        "handler": "submit-resource",
+        "config": {
+          "uri": "api://auth/login",
+          "method": "POST"
+        },
+        "onSuccess": [
+          {
+            "handler": "navigate",
+            "config": {
+              "navigate": "/dashboard"
+            }
+          }
+        ],
+        "onError": [
+          {
+            "handler": "notify",
+            "config": {
+              "message": "Login failed. Please check your credentials.",
+              "variant": "error"
+            }
+          }
+        ]
+      }
+    ]
+  }
+}

package/patterns/forms/login-form.yaml

@@ -0,0 +1,61 @@
+# 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: login-form
+domain: forms
+version: 3
+description: >-
+  Login form with email, password, remember me, and forgot password link. FormController wiring with submit-to-resource + navigate-on-success.
+tags:
+  purpose:
+    - authentication
+    - data-entry
+  complexity: composed
+  layout: single-column
+  interaction:
+    - form-submit
+keywords:
+  - login
+  - signin
+  - auth
+  - email
+  - password
+  - welcome back
+  - sign in to your account
+  - remember me
+  - forgot password
+  - authenticate
+  - credentials
+related:
+  - auth-signup
+  - otp-form
+  - settings-page
+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: login-ctrl
+      type: FormController
+      host: root-body
+  actions:
+    - event: press
+      target: root-action
+      handler: submit-resource
+components:
+  - Card
+  - Header
+  - Text
+  - Section
+  - Column
+  - Input
+  - Row
+  - CheckBox
+  - Footer
+  - Button

package/patterns/forms/modal-dialog-form.json

@@ -0,0 +1,233 @@
+{
+  "$schema": "../_schema.json",
+  "name": "modal-dialog-form",
+  "version": 2,
+  "domain": "forms",
+  "description": "Modal dialog containing a small form body with labeled inputs and Cancel/Save action buttons. Root is a Modal overlay, not a Card.",
+  "tags": {
+    "purpose": [
+      "data-entry",
+      "confirmation"
+    ],
+    "complexity": "composed",
+    "layout": "single-column",
+    "interaction": [
+      "form-submit",
+      "dismiss"
+    ]
+  },
+  "keywords": [
+    "modal",
+    "dialog",
+    "popup",
+    "overlay",
+    "sheet",
+    "drawer-form",
+    "edit-form",
+    "confirmation",
+    "modal dialog with form",
+    "edit profile dialog",
+    "quick edit",
+    "save and cancel"
+  ],
+  "related": [
+    "create-form",
+    "login-form"
+  ],
+  "template": [
+    {
+      "id": "root",
+      "component": "Modal",
+      "open": true,
+      "children": [
+        "hdr",
+        "sec",
+        "ftr"
+      ]
+    },
+    {
+      "id": "hdr",
+      "component": "Header",
+      "children": [
+        "title",
+        "desc"
+      ]
+    },
+    {
+      "id": "title",
+      "component": "Text",
+      "slot": "heading",
+      "variant": "section",
+      "textContent": "Edit Details",
+      "role": "heading"
+    },
+    {
+      "id": "desc",
+      "component": "Text",
+      "slot": "description",
+      "variant": "caption",
+      "textContent": "Update the fields below and save your changes.",
+      "role": "description"
+    },
+    {
+      "id": "sec",
+      "component": "Section",
+      "children": [
+        "body"
+      ]
+    },
+    {
+      "id": "body",
+      "component": "Column",
+      "gap": "3",
+      "role": "container",
+      "children": [
+        "name-field",
+        "email-field",
+        "role-field"
+      ]
+    },
+    {
+      "id": "name-field",
+      "component": "Field",
+      "label": "Name",
+      "children": [
+        "name"
+      ]
+    },
+    {
+      "id": "name",
+      "component": "Input",
+      "role": "form-field",
+      "type": "text",
+      "name": "name",
+      "required": true,
+      "placeholder": "Full name"
+    },
+    {
+      "id": "email-field",
+      "component": "Field",
+      "label": "Email",
+      "children": [
+        "email"
+      ]
+    },
+    {
+      "id": "email",
+      "component": "Input",
+      "role": "form-field",
+      "type": "email",
+      "name": "email",
+      "required": true,
+      "placeholder": "you@example.com"
+    },
+    {
+      "id": "role-field",
+      "component": "Field",
+      "label": "Role",
+      "children": [
+        "role"
+      ]
+    },
+    {
+      "id": "role",
+      "component": "Select",
+      "role": "form-field",
+      "name": "role",
+      "options": [
+        {
+          "label": "Admin",
+          "value": "admin"
+        },
+        {
+          "label": "Editor",
+          "value": "editor"
+        },
+        {
+          "label": "Viewer",
+          "value": "viewer"
+        }
+      ]
+    },
+    {
+      "id": "ftr",
+      "component": "Footer",
+      "children": [
+        "cancel-btn",
+        "save-btn"
+      ]
+    },
+    {
+      "id": "cancel-btn",
+      "component": "Button",
+      "variant": "ghost",
+      "role": "action",
+      "text": "Cancel"
+    },
+    {
+      "id": "save-btn",
+      "component": "Button",
+      "variant": "primary",
+      "role": "action",
+      "text": "Save"
+    }
+  ],
+  "wiring": {
+    "controllers": [
+      {
+        "id": "modal-form-ctrl",
+        "type": "FormController",
+        "host": "body",
+        "config": {
+          "validateOn": "submit"
+        },
+        "bind": {
+          "values": "/form/values",
+          "valid": "/form/valid"
+        }
+      }
+    ],
+    "actions": [
+      {
+        "event": {
+          "event": "press",
+          "target": "save-btn"
+        },
+        "handler": "submit-resource",
+        "config": {
+          "uri": "api://record/update",
+          "method": "POST"
+        },
+        "onSuccess": [
+          {
+            "handler": "notify",
+            "config": {
+              "message": "Saved.",
+              "variant": "success"
+            }
+          }
+        ],
+        "onError": [
+          {
+            "handler": "notify",
+            "config": {
+              "message": "Could not save.",
+              "variant": "error"
+            }
+          }
+        ]
+      },
+      {
+        "event": {
+          "event": "press",
+          "target": "cancel-btn"
+        },
+        "handler": "notify",
+        "config": {
+          "message": "Changes discarded.",
+          "variant": "info"
+        }
+      }
+    ]
+  }
+}

package/patterns/forms/modal-dialog-form.yaml

@@ -0,0 +1,52 @@
+# Narrative doc — JSON sibling remains the canonical machine source.
+
+$schema: ../../../../../scripts/schemas/pattern.yaml.schema.json
+name: modal-dialog-form
+domain: forms
+version: 1
+description: >-
+  Modal dialog containing a small form body with labeled inputs and Cancel/Save
+  action buttons. Root is a Modal overlay, not a Card.
+intent: >-
+  Edit or confirm a small set of fields in an overlay without leaving the
+  current page. Opened in response to an action (e.g. "Edit", "Add"), submitted
+  via primary Save, dismissed via Cancel or backdrop.
+when-to-use:
+  - User needs to edit 2–4 fields without a full-page navigation.
+  - A focused confirmation or quick-create flow above existing context.
+  - Any overlay / popup / sheet / drawer-style form.
+variations:
+  - name: confirmation-dialog
+    description: Replace inputs with a Text body and keep Cancel + primary action.
+  - name: drawer-form
+    description: Swap the Modal for a side-drawer container; keep the same body.
+  - name: destructive-confirm
+    description: Save button becomes a `variant:"destructive"` Delete button.
+anti-patterns:
+  - Do not use Card as the root for a modal/dialog intent — the root MUST be
+    Modal (tag `modal-ui`) so the overlay/focus-trap semantics are emitted.
+  - Do not nest a second Modal inside this one.
+  - Avoid long multi-section forms in a modal — use a full-page create-form
+    pattern instead.
+keywords:
+  - modal
+  - dialog
+  - popup
+  - overlay
+  - sheet
+  - drawer-form
+  - edit-form
+  - confirmation
+related:
+  - create-form
+  - login-form
+components:
+  - Modal
+  - Header
+  - Text
+  - Section
+  - Column
+  - Input
+  - Select
+  - Footer
+  - Button