@alfadocs/ui-kit 0.1.9 → 0.2.0

package/dist/agent-catalog.json

@@ -1,6 +1,6 @@
 {
   "schemaVersion": 1,
-  "packageVersion": "0.1.9",
+  "packageVersion": "0.2.0",
   "components": [
     {
       "kind": "component",
@@ -172,6 +172,50 @@
         }
       }
     },
+    {
+      "kind": "component",
+      "id": "alert",
+      "capabilities": [
+        "dismiss"
+      ],
+      "state": [],
+      "actions": [],
+      "domHooks": {
+        "root": {
+          "attr": "data-component",
+          "value": "alert",
+          "description": "Marks the element as a kit Alert. The root also emits `data-state=\"open\" | \"closing\"` while the dismiss animation runs. Alerts inherit native `id` from props, which is what agents address them by."
+        }
+      }
+    },
+    {
+      "kind": "component",
+      "id": "app-frame",
+      "capabilities": [],
+      "state": [],
+      "actions": [],
+      "domHooks": {
+        "root": {
+          "attr": "data-component",
+          "value": "app-frame",
+          "description": "Marks the AppFrame layout wrapper. Inner landmarks (Header, Sidebar, main) carry their own component hooks."
+        }
+      }
+    },
+    {
+      "kind": "component",
+      "id": "aspect-ratio",
+      "capabilities": [],
+      "state": [],
+      "actions": [],
+      "domHooks": {
+        "root": {
+          "attr": "data-component",
+          "value": "aspect-ratio",
+          "description": "Marks the element as a kit AspectRatio wrapper."
+        }
+      }
+    },
     {
       "kind": "component",
       "id": "audio-recorder",
@@ -230,6 +274,20 @@
         }
       }
     },
+    {
+      "kind": "component",
+      "id": "audio-visualiser",
+      "capabilities": [],
+      "state": [],
+      "actions": [],
+      "domHooks": {
+        "root": {
+          "attr": "data-component",
+          "value": "audio-visualiser",
+          "description": "Marks the element as a kit AudioVisualiser canvas."
+        }
+      }
+    },
     {
       "kind": "component",
       "id": "autocomplete",
@@ -301,6 +359,34 @@
         }
       }
     },
+    {
+      "kind": "component",
+      "id": "avatar",
+      "capabilities": [],
+      "state": [],
+      "actions": [],
+      "domHooks": {
+        "root": {
+          "attr": "data-component",
+          "value": "avatar",
+          "description": "Marks the element as a kit Avatar."
+        }
+      }
+    },
+    {
+      "kind": "component",
+      "id": "badge",
+      "capabilities": [],
+      "state": [],
+      "actions": [],
+      "domHooks": {
+        "root": {
+          "attr": "data-component",
+          "value": "badge",
+          "description": "Marks the element as a kit Badge."
+        }
+      }
+    },
     {
       "kind": "component",
       "id": "breadcrumb",
@@ -353,6 +439,20 @@
         }
       }
     },
+    {
+      "kind": "component",
+      "id": "button-group",
+      "capabilities": [],
+      "state": [],
+      "actions": [],
+      "domHooks": {
+        "root": {
+          "attr": "data-component",
+          "value": "button-group",
+          "description": "Marks the ButtonGroup wrapper. Agents target individual Buttons inside the group via their native `id`."
+        }
+      }
+    },
     {
       "kind": "component",
       "id": "calendar",
@@ -430,6 +530,20 @@
         }
       }
     },
+    {
+      "kind": "component",
+      "id": "card",
+      "capabilities": [],
+      "state": [],
+      "actions": [],
+      "domHooks": {
+        "root": {
+          "attr": "data-component",
+          "value": "card",
+          "description": "Marks the Card root. Interactive Cards inherit `role=\"button\"` (unless `asChild` is used) and are addressed by their native `id`."
+        }
+      }
+    },
     {
       "kind": "component",
       "id": "chart",
@@ -542,6 +656,20 @@
         }
       }
     },
+    {
+      "kind": "component",
+      "id": "chat-message",
+      "capabilities": [],
+      "state": [],
+      "actions": [],
+      "domHooks": {
+        "root": {
+          "attr": "data-component",
+          "value": "chat-message",
+          "description": "Marks the ChatMessage article element. Agents address an individual message by its native `id` and read role / status from the DOM."
+        }
+      }
+    },
     {
       "kind": "component",
       "id": "checkbox",
@@ -1084,6 +1212,20 @@
         }
       }
     },
+    {
+      "kind": "component",
+      "id": "description-list",
+      "capabilities": [],
+      "state": [],
+      "actions": [],
+      "domHooks": {
+        "root": {
+          "attr": "data-component",
+          "value": "description-list",
+          "description": "Marks the element as a kit DescriptionList."
+        }
+      }
+    },
     {
       "kind": "component",
       "id": "dialog",
@@ -1171,6 +1313,20 @@
         }
       }
     },
+    {
+      "kind": "component",
+      "id": "empty-state",
+      "capabilities": [],
+      "state": [],
+      "actions": [],
+      "domHooks": {
+        "root": {
+          "attr": "data-component",
+          "value": "empty-state",
+          "description": "Marks the EmptyState wrapper. CTAs inside are kit Buttons / Links and carry their own DOM hooks."
+        }
+      }
+    },
     {
       "kind": "component",
       "id": "file-upload",
@@ -1214,6 +1370,48 @@
         }
       }
     },
+    {
+      "kind": "component",
+      "id": "flag",
+      "capabilities": [],
+      "state": [],
+      "actions": [],
+      "domHooks": {
+        "root": {
+          "attr": "data-component",
+          "value": "flag",
+          "description": "Marks the element as a kit Flag glyph."
+        }
+      }
+    },
+    {
+      "kind": "component",
+      "id": "floating-action-button",
+      "capabilities": [],
+      "state": [],
+      "actions": [],
+      "domHooks": {
+        "root": {
+          "attr": "data-component",
+          "value": "floating-action-button",
+          "description": "Marks the element as a kit FloatingActionButton. Safety is declared by the host pattern, not the button."
+        }
+      }
+    },
+    {
+      "kind": "component",
+      "id": "form-field",
+      "capabilities": [],
+      "state": [],
+      "actions": [],
+      "domHooks": {
+        "root": {
+          "attr": "data-component",
+          "value": "form-field",
+          "description": "Marks the FormField wrapper. The label, description, and error are siblings of the inner input; agents address the input by its native `id`, which FormField wires up via context."
+        }
+      }
+    },
     {
       "kind": "component",
       "id": "freemium-paywall",
@@ -1258,6 +1456,92 @@
         }
       }
     },
+    {
+      "kind": "component",
+      "id": "header",
+      "capabilities": [],
+      "state": [],
+      "actions": [],
+      "domHooks": {
+        "root": {
+          "attr": "data-component",
+          "value": "header",
+          "description": "Marks the page Header banner. Emits `data-scrolled=\"true\"` while the user has scrolled past the sentinel. Inner controls (HeaderBrand, HeaderMenuButton, etc.) carry their own component hooks."
+        }
+      }
+    },
+    {
+      "kind": "component",
+      "id": "icon-button",
+      "capabilities": [],
+      "state": [],
+      "actions": [],
+      "domHooks": {
+        "root": {
+          "attr": "data-component",
+          "value": "icon-button",
+          "description": "Marks the element as a kit IconButton. Safety is declared by the host pattern, not the button. IconButtons inherit native `id` from props, which is what agents address them by."
+        }
+      }
+    },
+    {
+      "kind": "component",
+      "id": "icon-button-group",
+      "capabilities": [],
+      "state": [],
+      "actions": [],
+      "domHooks": {
+        "root": {
+          "attr": "data-component",
+          "value": "icon-button-group",
+          "description": "Marks the IconButtonGroup wrapper. Agents target individual IconButtons inside the group via their native `id`."
+        }
+      }
+    },
+    {
+      "kind": "component",
+      "id": "kbd",
+      "capabilities": [],
+      "state": [],
+      "actions": [],
+      "domHooks": {
+        "root": {
+          "attr": "data-component",
+          "value": "kbd",
+          "description": "Marks the element as a kit Kbd glyph."
+        }
+      }
+    },
+    {
+      "kind": "component",
+      "id": "key-value-pair",
+      "capabilities": [],
+      "state": [],
+      "actions": [],
+      "domHooks": {
+        "root": {
+          "attr": "data-component",
+          "value": "key-value-pair",
+          "description": "Marks the element as a kit KeyValuePair row."
+        }
+      }
+    },
+    {
+      "kind": "component",
+      "id": "link",
+      "capabilities": [
+        "navigate"
+      ],
+      "state": [],
+      "actions": [],
+      "domHooks": {
+        "root": {
+          "attr": "data-component",
+          "value": "link",
+          "description": "Marks the element as a kit Link. The destination URL is the native `href` attribute on the anchor; agents read it directly from the DOM."
+        }
+      }
+    },
     {
       "kind": "component",
       "id": "list",
@@ -1302,6 +1586,48 @@
         }
       }
     },
+    {
+      "kind": "component",
+      "id": "live-region",
+      "capabilities": [],
+      "state": [],
+      "actions": [],
+      "domHooks": {
+        "root": {
+          "attr": "data-component",
+          "value": "live-region",
+          "description": "Marks the LiveRegion element. `aria-live` politeness and `role` are emitted as native attributes; announcement content is the element's text content."
+        }
+      }
+    },
+    {
+      "kind": "component",
+      "id": "logo",
+      "capabilities": [],
+      "state": [],
+      "actions": [],
+      "domHooks": {
+        "root": {
+          "attr": "data-component",
+          "value": "logo",
+          "description": "Marks the element as the AlfaDocs Logo asset."
+        }
+      }
+    },
+    {
+      "kind": "component",
+      "id": "matrix-rain",
+      "capabilities": [],
+      "state": [],
+      "actions": [],
+      "domHooks": {
+        "root": {
+          "attr": "data-component",
+          "value": "matrix-rain",
+          "description": "Marks the decorative MatrixRain canvas."
+        }
+      }
+    },
     {
       "kind": "component",
       "id": "message-card",
@@ -2053,6 +2379,20 @@
         }
       }
     },
+    {
+      "kind": "component",
+      "id": "radio",
+      "capabilities": [],
+      "state": [],
+      "actions": [],
+      "domHooks": {
+        "root": {
+          "attr": "data-component",
+          "value": "radio",
+          "description": "Marks a single Radio item. Group-level selection is exposed by the parent RadioGroup adapter."
+        }
+      }
+    },
     {
       "kind": "component",
       "id": "radio-group",
@@ -2214,6 +2554,20 @@
         }
       }
     },
+    {
+      "kind": "component",
+      "id": "scroll-area",
+      "capabilities": [],
+      "state": [],
+      "actions": [],
+      "domHooks": {
+        "root": {
+          "attr": "data-component",
+          "value": "scroll-area",
+          "description": "Marks the element as a kit ScrollArea."
+        }
+      }
+    },
     {
       "kind": "component",
       "id": "search-bar",
@@ -2391,6 +2745,20 @@
         }
       }
     },
+    {
+      "kind": "component",
+      "id": "separator",
+      "capabilities": [],
+      "state": [],
+      "actions": [],
+      "domHooks": {
+        "root": {
+          "attr": "data-component",
+          "value": "separator",
+          "description": "Marks the element as a kit Separator."
+        }
+      }
+    },
     {
       "kind": "component",
       "id": "sheet",
@@ -2439,20 +2807,13 @@
       "kind": "component",
       "id": "sidebar",
       "capabilities": [
-        "expand",
-        "select_single",
-        "navigate"
+        "expand"
       ],
       "state": [
         {
           "name": "isCollapsed",
           "type": "boolean",
           "description": "True when the sidebar is in its collapsed (rail) state."
-        },
-        {
-          "name": "activeItem",
-          "type": "string | null",
-          "description": "Id of the currently-active navigation item, or null."
         }
       ],
       "actions": [
@@ -2460,12 +2821,6 @@
           "name": "toggle_collapsed",
           "safety": "read",
           "description": "Toggle the sidebar between collapsed and expanded."
-        },
-        {
-          "name": "select_item",
-          "safety": "read",
-          "argsType": "{ id: string }",
-          "description": "Mark the navigation item with the given id as active."
         }
       ],
       "domHooks": {
@@ -2484,6 +2839,20 @@
         }
       }
     },
+    {
+      "kind": "component",
+      "id": "sign-in-with-alfadocs-button",
+      "capabilities": [],
+      "state": [],
+      "actions": [],
+      "domHooks": {
+        "root": {
+          "attr": "data-component",
+          "value": "sign-in-with-alfadocs-button",
+          "description": "Marks the branded sign-in trigger. Safety is declared by the host auth pattern."
+        }
+      }
+    },
     {
       "kind": "component",
       "id": "signature-capture",
@@ -2527,6 +2896,36 @@
         }
       }
     },
+    {
+      "kind": "component",
+      "id": "skeleton",
+      "capabilities": [],
+      "state": [],
+      "actions": [],
+      "domHooks": {
+        "root": {
+          "attr": "data-component",
+          "value": "skeleton",
+          "description": "Marks the element as a kit Skeleton placeholder."
+        }
+      }
+    },
+    {
+      "kind": "component",
+      "id": "skip-link",
+      "capabilities": [
+        "navigate"
+      ],
+      "state": [],
+      "actions": [],
+      "domHooks": {
+        "root": {
+          "attr": "data-component",
+          "value": "skip-link",
+          "description": "Marks the SkipLink anchor. Destination is the native `href` attribute."
+        }
+      }
+    },
     {
       "kind": "component",
       "id": "slider",
@@ -2562,6 +2961,29 @@
         }
       }
     },
+    {
+      "kind": "component",
+      "id": "slot-grid",
+      "capabilities": [
+        "pick",
+        "range_navigate",
+        "expand"
+      ],
+      "state": [],
+      "actions": [],
+      "domHooks": {
+        "root": {
+          "attr": "data-component",
+          "value": "slot-grid",
+          "description": "Marks the SlotGrid region. Emits `data-state` reflecting the public `state` prop (default / loading / disabled / empty)."
+        },
+        "item": {
+          "attr": "data-slot-id",
+          "sourceProp": "days[].slots[].id",
+          "description": "Per-slot button identifier sourced from each `SlotGridSlot.id`. Agents activate a slot via native click on the matching button."
+        }
+      }
+    },
     {
       "kind": "component",
       "id": "sparkline",
@@ -2592,6 +3014,34 @@
         }
       }
     },
+    {
+      "kind": "component",
+      "id": "spinner",
+      "capabilities": [],
+      "state": [],
+      "actions": [],
+      "domHooks": {
+        "root": {
+          "attr": "data-component",
+          "value": "spinner",
+          "description": "Marks the element as a kit Spinner."
+        }
+      }
+    },
+    {
+      "kind": "component",
+      "id": "stat",
+      "capabilities": [],
+      "state": [],
+      "actions": [],
+      "domHooks": {
+        "root": {
+          "attr": "data-component",
+          "value": "stat",
+          "description": "Marks the element as a kit Stat tile."
+        }
+      }
+    },
     {
       "kind": "component",
       "id": "stepper-accordion",
@@ -2750,6 +3200,20 @@
         }
       }
     },
+    {
+      "kind": "component",
+      "id": "streaming-text",
+      "capabilities": [],
+      "state": [],
+      "actions": [],
+      "domHooks": {
+        "root": {
+          "attr": "data-component",
+          "value": "streaming-text",
+          "description": "Marks the element as a kit StreamingText surface."
+        }
+      }
+    },
     {
       "kind": "component",
       "id": "suggestion-chip",
@@ -2866,6 +3330,20 @@
         }
       }
     },
+    {
+      "kind": "component",
+      "id": "tag",
+      "capabilities": [],
+      "state": [],
+      "actions": [],
+      "domHooks": {
+        "root": {
+          "attr": "data-component",
+          "value": "tag",
+          "description": "Marks the element as a kit Tag."
+        }
+      }
+    },
     {
       "kind": "component",
       "id": "task-card",
@@ -3036,6 +3514,20 @@
         }
       }
     },
+    {
+      "kind": "component",
+      "id": "theme-root",
+      "capabilities": [],
+      "state": [],
+      "actions": [],
+      "domHooks": {
+        "root": {
+          "attr": "data-component",
+          "value": "theme-root",
+          "description": "Marks the ThemeRoot wrapper. The active theme is encoded in the element's class list (`theme-light` / `theme-dark` / `theme-accessible`)."
+        }
+      }
+    },
     {
       "kind": "component",
       "id": "theme-toggle",
@@ -3176,6 +3668,20 @@
         }
       }
     },
+    {
+      "kind": "component",
+      "id": "timestamp",
+      "capabilities": [],
+      "state": [],
+      "actions": [],
+      "domHooks": {
+        "root": {
+          "attr": "data-component",
+          "value": "timestamp",
+          "description": "Marks the element as a kit Timestamp. The machine-readable value lives in the native `datetime` attribute on the inner `<time>` element."
+        }
+      }
+    },
     {
       "kind": "component",
       "id": "toast",
@@ -3216,6 +3722,20 @@
         }
       }
     },
+    {
+      "kind": "component",
+      "id": "tooltip",
+      "capabilities": [],
+      "state": [],
+      "actions": [],
+      "domHooks": {
+        "root": {
+          "attr": "data-component",
+          "value": "tooltip",
+          "description": "Marks the element as a kit Tooltip content surface."
+        }
+      }
+    },
     {
       "kind": "component",
       "id": "tooth-scheme",
@@ -3297,6 +3817,51 @@
         }
       }
     },
+    {
+      "kind": "component",
+      "id": "typing-indicator",
+      "capabilities": [],
+      "state": [],
+      "actions": [],
+      "domHooks": {
+        "root": {
+          "attr": "data-component",
+          "value": "typing-indicator",
+          "description": "Marks the element as a kit TypingIndicator."
+        }
+      }
+    },
+    {
+      "kind": "component",
+      "id": "visually-hidden",
+      "capabilities": [],
+      "state": [],
+      "actions": [],
+      "domHooks": {
+        "root": {
+          "attr": "data-component",
+          "value": "visually-hidden",
+          "description": "Marks the element as a kit VisuallyHidden wrapper."
+        }
+      }
+    },
+    {
+      "kind": "component",
+      "id": "warning-stack",
+      "capabilities": [
+        "dismiss",
+        "expand"
+      ],
+      "state": [],
+      "actions": [],
+      "domHooks": {
+        "root": {
+          "attr": "data-component",
+          "value": "warning-stack",
+          "description": "Marks the WarningStack region. Each item inside is a kit Alert; agents address an individual warning via the Alert's native `id`."
+        }
+      }
+    },
     {
       "kind": "component",
       "id": "workflow-card",