@agent-ui-kit/web-components 0.0.3 → 0.0.5

package/dist/docs/traits/validate.yaml

@@ -0,0 +1,52 @@
+name: validate
+type: trait
+category: state
+summary: Form validation rules with data attribute state exposure.
+description: >
+  Applies configurable validation rules (required, pattern, min/max
+  length) on blur and input events. Exposes validity state and error
+  messages as data attributes for CSS styling. Sets validity via
+  ElementInternals when available. Emits validate events with
+  validity details.
+
+config:
+  - name: required
+    type: string
+    default: "false"
+    description: Whether the field is required.
+  - name: pattern
+    type: string
+    default: ""
+    description: Regular expression pattern the value must match.
+  - name: min-length
+    type: string
+    default: ""
+    description: Minimum character length.
+  - name: max-length
+    type: string
+    default: ""
+    description: Maximum character length.
+  - name: message
+    type: string
+    default: ""
+    description: Custom error message (overrides default messages).
+
+events:
+  - name: validate
+    description: Fires after validation with valid, message, and value in detail.
+
+exposes:
+  - name: data-validate-valid
+    description: Present and set to "true" when the value is valid.
+  - name: data-validate-message
+    description: The current validation error message (empty when valid).
+
+examples:
+  - html: |
+      <aui-input traits="{ trait: 'validate', required: 'true' }">
+      </aui-input>
+    description: Required field validation.
+  - html: |
+      <aui-input traits="{ trait: 'validate', pattern: '^[a-z]+$', message: 'Lowercase only' }">
+      </aui-input>
+    description: Pattern validation with custom error message.

package/dist/docs/traits/virtual-scroll.yaml

@@ -0,0 +1,44 @@
+name: virtual-scroll
+type: trait
+category: present
+summary: Virtual scrolling that only positions visible items.
+description: >
+  Implements virtual scrolling for long lists by only positioning
+  visible items. Uses a spacer element to maintain the full scroll
+  height and translates children to their correct positions based
+  on scroll offset. Supports configurable item height, overscan
+  buffer, and total item count.
+
+config:
+  - name: item-height
+    type: string
+    default: "40"
+    description: Height of each item in pixels.
+  - name: overscan
+    type: string
+    default: "3"
+    description: Number of extra items to render above and below the viewport.
+  - name: total
+    type: string
+    default: "0"
+    description: Total number of items in the list.
+
+events:
+  - name: virtual-range
+    description: Fires on scroll with start and end visible indices in detail.
+
+exposes:
+  - name: data-virtual-scroll-start
+    description: First visible item index.
+  - name: data-virtual-scroll-end
+    description: Last visible item index.
+
+examples:
+  - html: |
+      <aui-list traits="{ trait: 'virtual-scroll', item-height: '40', total: '1000' }">
+      </aui-list>
+    description: Virtual scrolling for a 1000-item list.
+  - html: |
+      <aui-list traits="{ trait: 'virtual-scroll', item-height: '32', overscan: '5', total: '500' }">
+      </aui-list>
+    description: Custom item height and overscan buffer.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agent-ui-kit/web-components",
-  "version": "0.0.3",
+  "version": "0.0.5",
   "type": "module",
   "main": "./dist/register.js",
   "module": "./dist/register.js",
@@ -24,6 +24,8 @@
     "./store": "./dist/store.js",
     "./icons": "./dist/icons.js",
     "./agent-ui.css": "./dist/agent-ui.css",
+    "./api.json": "./dist/api.json",
+    "./docs/*": "./dist/docs/*",
     "./dist/*": "./dist/*"
   },
   "sideEffects": [
@@ -35,7 +37,7 @@
     "dev:blocks": "vite --open /src/blocks/preview.html",
     "dev:components": "vite --open /src/components/preview.html",
     "dev:traits": "vite --open /src/traits/preview.html",
-    "build": "vite build",
+    "build": "vite build && npx tsx ../../scripts/build-api-docs.ts",
     "build:previews": "npx tsx ../../scripts/build-preview-json.ts"
   },
   "files": [