@alfadocs/ui-kit 0.0.12

package/dist/agent-catalog.json

@@ -0,0 +1,813 @@
+{
+  "schemaVersion": 1,
+  "packageVersion": "0.0.12",
+  "components": [
+    {
+      "kind": "component",
+      "id": "accordion",
+      "capabilities": [
+        "expand",
+        "select_single",
+        "select_multiple"
+      ],
+      "state": [],
+      "actions": [],
+      "domHooks": {
+        "root": {
+          "attr": "data-component",
+          "value": "accordion"
+        },
+        "item": {
+          "attr": "data-item-id",
+          "description": "Each Accordion.Item emits its value as data-item-id."
+        }
+      }
+    },
+    {
+      "kind": "component",
+      "id": "autocomplete",
+      "capabilities": [
+        "filter",
+        "pick",
+        "open",
+        "close"
+      ],
+      "state": [],
+      "actions": [],
+      "domHooks": {
+        "root": {
+          "attr": "data-component",
+          "value": "autocomplete"
+        },
+        "item": {
+          "attr": "data-option-id",
+          "description": "Each suggestion emits its value as data-option-id."
+        }
+      }
+    },
+    {
+      "kind": "component",
+      "id": "button",
+      "capabilities": [],
+      "state": [],
+      "actions": [],
+      "domHooks": {
+        "root": {
+          "attr": "data-component",
+          "value": "button",
+          "description": "Marks the element as a kit Button. Safety is declared by the host pattern, not the button. Buttons inherit native `id` from props, which is what agents address them by."
+        }
+      }
+    },
+    {
+      "kind": "component",
+      "id": "calendar",
+      "capabilities": [
+        "view_change",
+        "range_navigate",
+        "pick"
+      ],
+      "state": [
+        {
+          "name": "currentView",
+          "type": "CalendarView",
+          "description": "Active view name (e.g. dayGridMonth, timeGridWeek)."
+        },
+        {
+          "name": "currentDate",
+          "type": "iso-date",
+          "description": "ISO date anchor of the visible range."
+        },
+        {
+          "name": "currentTitle",
+          "type": "string",
+          "description": "Human title of the current range (e.g. \"April 2026\")."
+        }
+      ],
+      "actions": [
+        {
+          "name": "today",
+          "safety": "read",
+          "description": "Jump to the current day."
+        },
+        {
+          "name": "prev",
+          "safety": "read",
+          "description": "Move to the previous range."
+        },
+        {
+          "name": "next",
+          "safety": "read",
+          "description": "Move to the next range."
+        },
+        {
+          "name": "goto_date",
+          "safety": "read",
+          "argsType": "{ date: string | Date }",
+          "description": "Navigate to a specific date."
+        },
+        {
+          "name": "change_view",
+          "safety": "read",
+          "argsType": "{ view: CalendarView }",
+          "description": "Switch the calendar to the given view."
+        },
+        {
+          "name": "focus_event",
+          "safety": "read",
+          "argsType": "{ eventId: string }",
+          "description": "Scroll an event into view and briefly highlight it."
+        }
+      ],
+      "domHooks": {
+        "root": {
+          "attr": "data-component",
+          "value": "calendar",
+          "description": "Marks the Calendar wrapper."
+        },
+        "instanceId": {
+          "attr": "data-component-id",
+          "sourceProp": "id",
+          "description": "Sourced from the id prop."
+        },
+        "item": {
+          "attr": "data-event-id",
+          "description": "Emitted on every rendered FullCalendar event by the kit event renderer. Used by focusEvent."
+        }
+      }
+    },
+    {
+      "kind": "component",
+      "id": "chart",
+      "capabilities": [],
+      "state": [],
+      "actions": [
+        {
+          "name": "update_series",
+          "safety": "read",
+          "argsType": "series",
+          "description": "Replace the chart series without remounting."
+        },
+        {
+          "name": "export_png",
+          "safety": "read",
+          "description": "Return a PNG data URI of the chart for export or screenshotting."
+        }
+      ],
+      "domHooks": {
+        "root": {
+          "attr": "data-component",
+          "value": "chart"
+        }
+      }
+    },
+    {
+      "kind": "component",
+      "id": "chat-container",
+      "capabilities": [
+        "navigate"
+      ],
+      "state": [],
+      "actions": [
+        {
+          "name": "scroll_to_bottom",
+          "safety": "read",
+          "argsType": "{ smooth?: boolean }",
+          "description": "Scroll the conversation viewport to the latest message."
+        }
+      ],
+      "domHooks": {
+        "root": {
+          "attr": "data-component",
+          "value": "chat-container"
+        }
+      }
+    },
+    {
+      "kind": "component",
+      "id": "combobox",
+      "capabilities": [
+        "select_single",
+        "pick",
+        "filter",
+        "open",
+        "close"
+      ],
+      "state": [],
+      "actions": [],
+      "domHooks": {
+        "root": {
+          "attr": "data-component",
+          "value": "combobox"
+        },
+        "item": {
+          "attr": "data-option-id",
+          "description": "Each option emits its value as data-option-id."
+        }
+      }
+    },
+    {
+      "kind": "component",
+      "id": "command-palette",
+      "capabilities": [
+        "open",
+        "close",
+        "filter",
+        "pick",
+        "submit"
+      ],
+      "state": [],
+      "actions": [],
+      "domHooks": {
+        "root": {
+          "attr": "data-component",
+          "value": "command-palette"
+        },
+        "item": {
+          "attr": "data-command-id",
+          "description": "Each command item emits its key as data-command-id."
+        }
+      }
+    },
+    {
+      "kind": "component",
+      "id": "data-table",
+      "capabilities": [
+        "select_single",
+        "select_multiple",
+        "range_pick",
+        "filter",
+        "sort",
+        "paginate"
+      ],
+      "state": [
+        {
+          "name": "selection",
+          "type": "string[]",
+          "description": "Row ids of currently-selected rows."
+        },
+        {
+          "name": "filter",
+          "type": "object",
+          "description": "Current ag-grid filter model, keyed by column id."
+        },
+        {
+          "name": "sort",
+          "type": "Array<{ colId, sort }>",
+          "description": "Active sort, in priority order."
+        },
+        {
+          "name": "currentPage",
+          "type": "number",
+          "description": "Zero-indexed page number."
+        }
+      ],
+      "actions": [
+        {
+          "name": "select_rows",
+          "safety": "read",
+          "argsType": "{ ids: string[] }",
+          "description": "Replace the current selection with the given row ids."
+        },
+        {
+          "name": "select_range",
+          "safety": "read",
+          "argsType": "{ fromId: string, toId: string }",
+          "description": "Select every row between fromId and toId, inclusive, in current sort order."
+        },
+        {
+          "name": "clear_selection",
+          "safety": "read",
+          "description": "Deselect all rows."
+        },
+        {
+          "name": "apply_filter",
+          "safety": "read",
+          "argsType": "{ model: Record<string, unknown> }",
+          "description": "Replace the filter model with the given object."
+        },
+        {
+          "name": "sort_by",
+          "safety": "read",
+          "argsType": "{ model: DataTableSortEntry[] }",
+          "description": "Replace the active sort with the given list (priority order)."
+        },
+        {
+          "name": "go_to_page",
+          "safety": "read",
+          "argsType": "{ page: number }",
+          "description": "Navigate to the given zero-indexed page."
+        }
+      ],
+      "domHooks": {
+        "root": {
+          "attr": "data-component",
+          "value": "data-table",
+          "description": "Marks the DataTable wrapper."
+        },
+        "instanceId": {
+          "attr": "data-component-id",
+          "sourceProp": "gridId",
+          "description": "Sourced from the gridId prop. Required to address a specific table from the agent."
+        },
+        "item": {
+          "attr": "row-id",
+          "description": "Native ag-grid row-id attribute on each rendered row. Selection is performed via the curated handle, not by DOM mutation."
+        }
+      }
+    },
+    {
+      "kind": "component",
+      "id": "dialog",
+      "capabilities": [
+        "open",
+        "close",
+        "dismiss"
+      ],
+      "state": [],
+      "actions": [],
+      "domHooks": {
+        "root": {
+          "attr": "data-component",
+          "value": "dialog"
+        }
+      }
+    },
+    {
+      "kind": "component",
+      "id": "dropdown-menu",
+      "capabilities": [
+        "open",
+        "close",
+        "pick"
+      ],
+      "state": [],
+      "actions": [],
+      "domHooks": {
+        "root": {
+          "attr": "data-component",
+          "value": "dropdown-menu"
+        },
+        "item": {
+          "attr": "data-item-id",
+          "description": "Each menu item emits its value as data-item-id."
+        }
+      }
+    },
+    {
+      "kind": "component",
+      "id": "file-upload",
+      "capabilities": [
+        "submit",
+        "dismiss"
+      ],
+      "state": [],
+      "actions": [],
+      "domHooks": {
+        "root": {
+          "attr": "data-component",
+          "value": "file-upload"
+        }
+      }
+    },
+    {
+      "kind": "component",
+      "id": "multi-select",
+      "capabilities": [
+        "select_multiple",
+        "filter",
+        "open",
+        "close"
+      ],
+      "state": [],
+      "actions": [],
+      "domHooks": {
+        "root": {
+          "attr": "data-component",
+          "value": "multi-select"
+        },
+        "item": {
+          "attr": "data-option-id",
+          "description": "Each option emits its value as data-option-id."
+        }
+      }
+    },
+    {
+      "kind": "component",
+      "id": "pagination",
+      "capabilities": [
+        "paginate",
+        "range_navigate"
+      ],
+      "state": [],
+      "actions": [],
+      "domHooks": {
+        "root": {
+          "attr": "data-component",
+          "value": "pagination"
+        }
+      }
+    },
+    {
+      "kind": "component",
+      "id": "payment-form",
+      "capabilities": [
+        "submit"
+      ],
+      "state": [],
+      "actions": [
+        {
+          "name": "submit",
+          "safety": "destructive",
+          "description": "Submit the payment. Charges the configured payment method — irreversible."
+        },
+        {
+          "name": "reset",
+          "safety": "destructive",
+          "description": "Reset the form to its initial state. Loses any in-progress input."
+        }
+      ],
+      "domHooks": {
+        "root": {
+          "attr": "data-component",
+          "value": "payment-form"
+        }
+      }
+    },
+    {
+      "kind": "component",
+      "id": "pdf-viewer",
+      "capabilities": [
+        "paginate",
+        "view_change",
+        "filter"
+      ],
+      "state": [],
+      "actions": [
+        {
+          "name": "go_to_page",
+          "safety": "read",
+          "argsType": "{ page: number }",
+          "description": "Navigate to a specific 1-indexed page."
+        },
+        {
+          "name": "set_zoom",
+          "safety": "read",
+          "argsType": "{ zoom: PDFZoomPreset }",
+          "description": "Apply a zoom preset."
+        },
+        {
+          "name": "search",
+          "safety": "read",
+          "argsType": "{ query: string }",
+          "description": "Search the document for the given query and highlight matches."
+        },
+        {
+          "name": "print",
+          "safety": "read",
+          "description": "Open the browser print dialog for the document."
+        }
+      ],
+      "domHooks": {
+        "root": {
+          "attr": "data-component",
+          "value": "pdf-viewer"
+        }
+      }
+    },
+    {
+      "kind": "component",
+      "id": "popover",
+      "capabilities": [
+        "open",
+        "close"
+      ],
+      "state": [],
+      "actions": [],
+      "domHooks": {
+        "root": {
+          "attr": "data-component",
+          "value": "popover"
+        }
+      }
+    },
+    {
+      "kind": "component",
+      "id": "progress",
+      "capabilities": [],
+      "state": [],
+      "actions": [
+        {
+          "name": "set_value",
+          "safety": "read",
+          "argsType": "{ value: number }",
+          "description": "Set the displayed progress value (0–100)."
+        }
+      ],
+      "domHooks": {
+        "root": {
+          "attr": "data-component",
+          "value": "progress"
+        }
+      }
+    },
+    {
+      "kind": "component",
+      "id": "resizable",
+      "capabilities": [
+        "range_navigate"
+      ],
+      "state": [],
+      "actions": [],
+      "domHooks": {
+        "root": {
+          "attr": "data-component",
+          "value": "resizable"
+        },
+        "item": {
+          "attr": "data-panel-id",
+          "description": "Each Panel forwards its `id` to react-resizable-panels which emits it as `data-panel-id`."
+        }
+      }
+    },
+    {
+      "kind": "component",
+      "id": "rich-text-editor",
+      "capabilities": [
+        "edit_inline"
+      ],
+      "state": [
+        {
+          "name": "html",
+          "type": "string",
+          "description": "Sanitised HTML representation of the editor content."
+        },
+        {
+          "name": "markdown",
+          "type": "string",
+          "description": "Markdown representation of the editor content."
+        }
+      ],
+      "actions": [
+        {
+          "name": "set_content",
+          "safety": "destructive",
+          "argsType": "{ html: string }",
+          "description": "Replace the editor content. Loses unsaved input."
+        },
+        {
+          "name": "clear",
+          "safety": "destructive",
+          "description": "Empty the editor. Loses unsaved input."
+        },
+        {
+          "name": "focus",
+          "safety": "read",
+          "description": "Move keyboard focus to the editor surface."
+        }
+      ],
+      "domHooks": {
+        "root": {
+          "attr": "data-component",
+          "value": "rich-text-editor"
+        }
+      }
+    },
+    {
+      "kind": "component",
+      "id": "sheet",
+      "capabilities": [
+        "open",
+        "close",
+        "dismiss"
+      ],
+      "state": [],
+      "actions": [],
+      "domHooks": {
+        "root": {
+          "attr": "data-component",
+          "value": "sheet"
+        }
+      }
+    },
+    {
+      "kind": "component",
+      "id": "sidebar",
+      "capabilities": [
+        "expand",
+        "select_single",
+        "navigate"
+      ],
+      "state": [],
+      "actions": [],
+      "domHooks": {
+        "root": {
+          "attr": "data-component",
+          "value": "sidebar"
+        },
+        "item": {
+          "attr": "data-nav-id",
+          "description": "Each Sidebar.Item emits its key as data-nav-id."
+        }
+      }
+    },
+    {
+      "kind": "component",
+      "id": "signature-capture",
+      "capabilities": [
+        "edit_inline",
+        "submit"
+      ],
+      "state": [
+        {
+          "name": "isEmpty",
+          "type": "boolean",
+          "description": "True when no signature has been drawn or typed."
+        }
+      ],
+      "actions": [
+        {
+          "name": "clear",
+          "safety": "destructive",
+          "description": "Erase the current signature. Loses unsaved input."
+        },
+        {
+          "name": "undo",
+          "safety": "write",
+          "description": "Undo the last stroke."
+        },
+        {
+          "name": "confirm",
+          "safety": "write",
+          "description": "Commit the signature and return its serialised payload."
+        }
+      ],
+      "domHooks": {
+        "root": {
+          "attr": "data-component",
+          "value": "signature-capture"
+        }
+      }
+    },
+    {
+      "kind": "component",
+      "id": "sparkline",
+      "capabilities": [],
+      "state": [],
+      "actions": [
+        {
+          "name": "update_series",
+          "safety": "read",
+          "argsType": "{ data: number[] }",
+          "description": "Replace the sparkline data without remounting."
+        },
+        {
+          "name": "export_png",
+          "safety": "read",
+          "description": "Return a PNG data URI of the sparkline."
+        }
+      ],
+      "domHooks": {
+        "root": {
+          "attr": "data-component",
+          "value": "sparkline"
+        }
+      }
+    },
+    {
+      "kind": "component",
+      "id": "tabs",
+      "capabilities": [
+        "select_single",
+        "navigate"
+      ],
+      "state": [],
+      "actions": [],
+      "domHooks": {
+        "root": {
+          "attr": "data-component",
+          "value": "tabs"
+        },
+        "item": {
+          "attr": "data-tab-id",
+          "description": "Each Tab.Trigger emits its value as data-tab-id. The agent reads this to identify the active tab via the DOM."
+        }
+      }
+    },
+    {
+      "kind": "component",
+      "id": "tooth-scheme",
+      "capabilities": [
+        "pick"
+      ],
+      "state": [
+        {
+          "name": "chart",
+          "type": "object",
+          "description": "Current dental chart state — tooth conditions keyed by FDI id."
+        }
+      ],
+      "actions": [
+        {
+          "name": "focus_tooth",
+          "safety": "read",
+          "argsType": "{ id: FdiId }",
+          "description": "Move focus to a specific tooth by FDI id."
+        }
+      ],
+      "domHooks": {
+        "root": {
+          "attr": "data-component",
+          "value": "tooth-scheme"
+        },
+        "item": {
+          "attr": "data-fdi",
+          "description": "Each rendered tooth `<g>` carries its FDI id as `data-fdi`. Tests still use `data-testid=\"tooth-<fdi>\"` separately."
+        }
+      }
+    }
+  ],
+  "patterns": [
+    {
+      "kind": "pattern",
+      "id": "entity-index-table",
+      "composes": [
+        {
+          "component": "data-table",
+          "as": "roster",
+          "entity": "entity"
+        },
+        {
+          "component": "button",
+          "as": "addNew"
+        },
+        {
+          "component": "button",
+          "as": "exportCsv"
+        },
+        {
+          "component": "button",
+          "as": "print"
+        },
+        {
+          "component": "button",
+          "as": "applyFilters"
+        },
+        {
+          "component": "button",
+          "as": "resetFilters"
+        }
+      ],
+      "workflows": [
+        {
+          "name": "select_rows",
+          "safety": "read",
+          "description": "Select one or more rows in the table.",
+          "uiActions": [
+            "data-table.select_rows"
+          ],
+          "apiActions": []
+        },
+        {
+          "name": "apply_filter",
+          "safety": "read",
+          "description": "Set the filter strip values and apply.",
+          "uiActions": [
+            "data-table.apply_filter"
+          ],
+          "apiActions": []
+        },
+        {
+          "name": "create_entity",
+          "safety": "write",
+          "description": "Open the create form and submit a new entity.",
+          "uiActions": [],
+          "apiActions": [
+            "entity.create"
+          ]
+        },
+        {
+          "name": "delete_selected",
+          "safety": "destructive",
+          "description": "Delete every selected row. Irreversible.",
+          "uiActions": [
+            "data-table.get_selection",
+            "data-table.clear_selection"
+          ],
+          "apiActions": [
+            "entity.delete"
+          ]
+        },
+        {
+          "name": "export_csv",
+          "safety": "read",
+          "description": "Trigger the CSV export of the current filtered set.",
+          "uiActions": [],
+          "apiActions": [
+            "entity.export"
+          ]
+        }
+      ]
+    }
+  ]
+}