agentui-wc 0.1.56 → 0.1.59

package/AGENTS.md

@@ -451,10 +451,10 @@ A `custom-elements.json` manifest is included in the root. Agents can read this
 - CSS Custom Properties (theming)
 
 **2. Runtime Debugging (Agent Logger)**
-Components validate usage and log structured errors to `window.__MICROUI_ERRORS__`.
+Components validate usage and log structured errors to `window.__AGENTUI_ERRORS__`.
 ```javascript
 // Check for errors in E2E tests
-const errors = await page.evaluate(() => window.__MICROUI_ERRORS__);
+const errors = await page.evaluate(() => window.__AGENTUI_ERRORS__);
 if (errors.length > 0) console.error('AgentUI Errors:', errors);
 ```
 
@@ -641,7 +641,7 @@ if (window.AgentUI?.ready) {
 Enable verbose logging for troubleshooting:
 
 ```html
-<script>window.MICROUI_DEBUG = true;</script>
+<script>window.AGENTUI_DEBUG = true;</script>
 <script type="module" src="dist/agentui.esm.js"></script>
 ```
 
@@ -1399,14 +1399,14 @@ this.style.zIndex = Z_INDEX.modal;
 
 ### Confirm Dialog (Agent-Friendly)
 ```javascript
-import { muConfirm } from 'agentui-wc';
+import { auConfirm } from 'agentui-wc';
 
 // Simple confirm - returns Promise<boolean>
-const ok = await muConfirm('Delete this item?');
+const ok = await auConfirm('Delete this item?');
 if (ok) deleteItem();
 
 // With options
-const confirmed = await muConfirm('Are you sure?', {
+const confirmed = await auConfirm('Are you sure?', {
     title: 'Confirm Delete',
     confirmText: 'Delete',
     cancelText: 'Cancel',
@@ -2268,11 +2268,11 @@ document.querySelectorAll('a[data-route]').forEach(link => {
 
 ### 1. Runtime Error Collection
 
-AgentUI logs all component errors to `window.__MICROUI_ERRORS__`:
+AgentUI logs all component errors to `window.__AGENTUI_ERRORS__`:
 
 ```javascript
 // In E2E tests or debug console
-const errors = window.__MICROUI_ERRORS__ || [];
+const errors = window.__AGENTUI_ERRORS__ || [];
 errors.forEach(err => {
     console.error(`[${err.component}] ${err.message}`, err.details);
 });
@@ -2351,7 +2351,7 @@ async function fetchWithRetry(url, options = {}, retries = 3) {
 
 ```javascript
 // Enable verbose logging
-window.__MICROUI_DEBUG__ = true;
+window.window.AGENTUI_DEBUG = true;
 
 // Check component registration
 customElements.get('au-button'); // Returns class or undefined
@@ -2719,7 +2719,7 @@ list.renderItem = (item) => `
 ### Runtime Error Detection
 ```javascript
 // Check for AgentUI component errors
-const errors = window.__MICROUI_ERRORS__ || [];
+const errors = window.__AGENTUI_ERRORS__ || [];
 if (errors.length) {
     console.error('AgentUI component errors:', errors);
     // Report to monitoring service
@@ -2955,7 +2955,7 @@ node lighthouse-audit.mjs
 # Results saved to /tmp/lighthouse-shell.json
 ```
 
-### Current Lighthouse Scores (v0.1.0)
+### Current Lighthouse Scores
 
 | Page | Performance | Accessibility | Best Practices | SEO |
 |------|-------------|---------------|----------------|-----|

package/README.md

@@ -75,7 +75,7 @@ AgentUI is built on four ideas:
 | **Bundle** | 60KB gzipped (JS+CSS), all 50 components | Tree-shake to ~20KB, then add deps |
 | **Performance** | Lighthouse 100/100/100/100 ([verify](https://pagespeed.web.dev/analysis?url=https://giuseppescottolavina.github.io/AgentUI/demo/)) | Varies |
 | **Dependencies** | Zero. Forever. | npm audit anxiety |
-| **Tests** | 1272 tests, 0 failures, isolated runner | Coverage varies |
+| **Tests** | 1300+ tests, 0 failures, isolated runner | Coverage varies |
 | **Memory** | Managed listeners (AbortController), zero leaks verified | Framework-dependent |
 | **Security** | Every component XSS-audited, CSP-compatible, no `eval()` | Trust your deps |
 | **Stability** | W3C Web Components — no migration treadmill | React 16→17→18→19... |
@@ -123,7 +123,7 @@ AgentUI is in **alpha** (v0.1.x). Here's an honest look at where we are:
 - 500 component DOM instantiation in <8ms, 500 updates in <3ms
 
 **Engineering**
-- 1272 isolated tests, zero failures, across 75 test files
+- 1300+ isolated tests, zero failures, across 99 test files
 - Every component XSS-audited — `escapeHTML()` on all user-facing content
 - Zero runtime dependencies — zero supply chain risk
 - Managed event listeners via AbortController — verified zero memory leaks

package/dist/AGENTS.md

@@ -451,10 +451,10 @@ A `custom-elements.json` manifest is included in the root. Agents can read this
 - CSS Custom Properties (theming)
 
 **2. Runtime Debugging (Agent Logger)**
-Components validate usage and log structured errors to `window.__MICROUI_ERRORS__`.
+Components validate usage and log structured errors to `window.__AGENTUI_ERRORS__`.
 ```javascript
 // Check for errors in E2E tests
-const errors = await page.evaluate(() => window.__MICROUI_ERRORS__);
+const errors = await page.evaluate(() => window.__AGENTUI_ERRORS__);
 if (errors.length > 0) console.error('AgentUI Errors:', errors);
 ```
 
@@ -641,7 +641,7 @@ if (window.AgentUI?.ready) {
 Enable verbose logging for troubleshooting:
 
 ```html
-<script>window.MICROUI_DEBUG = true;</script>
+<script>window.AGENTUI_DEBUG = true;</script>
 <script type="module" src="dist/agentui.esm.js"></script>
 ```
 
@@ -1399,14 +1399,14 @@ this.style.zIndex = Z_INDEX.modal;
 
 ### Confirm Dialog (Agent-Friendly)
 ```javascript
-import { muConfirm } from 'agentui-wc';
+import { auConfirm } from 'agentui-wc';
 
 // Simple confirm - returns Promise<boolean>
-const ok = await muConfirm('Delete this item?');
+const ok = await auConfirm('Delete this item?');
 if (ok) deleteItem();
 
 // With options
-const confirmed = await muConfirm('Are you sure?', {
+const confirmed = await auConfirm('Are you sure?', {
     title: 'Confirm Delete',
     confirmText: 'Delete',
     cancelText: 'Cancel',
@@ -2268,11 +2268,11 @@ document.querySelectorAll('a[data-route]').forEach(link => {
 
 ### 1. Runtime Error Collection
 
-AgentUI logs all component errors to `window.__MICROUI_ERRORS__`:
+AgentUI logs all component errors to `window.__AGENTUI_ERRORS__`:
 
 ```javascript
 // In E2E tests or debug console
-const errors = window.__MICROUI_ERRORS__ || [];
+const errors = window.__AGENTUI_ERRORS__ || [];
 errors.forEach(err => {
     console.error(`[${err.component}] ${err.message}`, err.details);
 });
@@ -2351,7 +2351,7 @@ async function fetchWithRetry(url, options = {}, retries = 3) {
 
 ```javascript
 // Enable verbose logging
-window.__MICROUI_DEBUG__ = true;
+window.window.AGENTUI_DEBUG = true;
 
 // Check component registration
 customElements.get('au-button'); // Returns class or undefined
@@ -2719,7 +2719,7 @@ list.renderItem = (item) => `
 ### Runtime Error Detection
 ```javascript
 // Check for AgentUI component errors
-const errors = window.__MICROUI_ERRORS__ || [];
+const errors = window.__AGENTUI_ERRORS__ || [];
 if (errors.length) {
     console.error('AgentUI component errors:', errors);
     // Report to monitoring service
@@ -2955,7 +2955,7 @@ node lighthouse-audit.mjs
 # Results saved to /tmp/lighthouse-shell.json
 ```
 
-### Current Lighthouse Scores (v0.1.0)
+### Current Lighthouse Scores
 
 | Page | Performance | Accessibility | Best Practices | SEO |
 |------|-------------|---------------|----------------|-----|

package/dist/README.md

@@ -75,7 +75,7 @@ AgentUI is built on four ideas:
 | **Bundle** | 60KB gzipped (JS+CSS), all 50 components | Tree-shake to ~20KB, then add deps |
 | **Performance** | Lighthouse 100/100/100/100 ([verify](https://pagespeed.web.dev/analysis?url=https://giuseppescottolavina.github.io/AgentUI/demo/)) | Varies |
 | **Dependencies** | Zero. Forever. | npm audit anxiety |
-| **Tests** | 1272 tests, 0 failures, isolated runner | Coverage varies |
+| **Tests** | 1300+ tests, 0 failures, isolated runner | Coverage varies |
 | **Memory** | Managed listeners (AbortController), zero leaks verified | Framework-dependent |
 | **Security** | Every component XSS-audited, CSP-compatible, no `eval()` | Trust your deps |
 | **Stability** | W3C Web Components — no migration treadmill | React 16→17→18→19... |
@@ -123,7 +123,7 @@ AgentUI is in **alpha** (v0.1.x). Here's an honest look at where we are:
 - 500 component DOM instantiation in <8ms, 500 updates in <3ms
 
 **Engineering**
-- 1272 isolated tests, zero failures, across 75 test files
+- 1300+ isolated tests, zero failures, across 99 test files
 - Every component XSS-audited — `escapeHTML()` on all user-facing content
 - Zero runtime dependencies — zero supply chain risk
 - Managed event listeners via AbortController — verified zero memory leaks

package/dist/agentui.d.ts

@@ -1,16 +1,32 @@
 /**
  * AgentUI v2 TypeScript Definitions
- * Complete types for 40+ components
+ * Complete types for all components
  */
 
 // ============================================
 // CORE
 // ============================================
+
+/** Component description returned by AuElement.describe() */
+export interface ComponentDescription {
+    name: string;
+    description: string;
+    props?: Record<string, { type: string; values?: string[]; default?: any; description?: string }>;
+    events?: string[] | { name: string; detail?: string; description?: string }[];
+    methods?: string[];
+    slots?: string[];
+    examples?: string[];
+    tips?: string[];
+}
+
 export declare class AuElement extends HTMLElement {
     static observedAttributes: string[];
     static baseClass: string;
     static useContainment: boolean;
 
+    /** Returns machine-readable component metadata for AI agent discovery */
+    static describe(): ComponentDescription;
+
     connectedCallback(): void;
     disconnectedCallback(): void;
     attributeChangedCallback(name: string, oldValue: string | null, newValue: string | null): void;
@@ -30,7 +46,7 @@ export declare class AuElement extends HTMLElement {
 export declare function define(tagName: string, ComponentClass: typeof AuElement): void;
 
 // ============================================
-// EVENT BUS (CrossBus 1.0.0)
+// EVENT BUS (LightBus)
 // ============================================
 export interface EventBus {
     on(event: string, callback: (data: any) => void): () => void;
@@ -42,11 +58,14 @@ export interface EventBus {
     request(peerId: string, handler: string, payload?: any): Promise<any>;
     broadcastRequest(handler: string, payload?: any): Promise<Map<string, any>>;
     handle(name: string, handler: (payload: any) => any): () => void;
+    unhandle(name: string): void;
+    hasListeners(event: string): boolean;
     destroy(): void;
     setMaxListeners(n: number): void;
     readonly peerId: string;
     readonly peers: string[];
     readonly peerCount: number;
+    readonly raw: any;
 }
 
 export declare const bus: EventBus;
@@ -68,6 +87,20 @@ export declare function showToast(message: string, options?: {
     duration?: number;
 }): void;
 
+export declare const AGENTUI_VERSION: string;
+export declare function isDebugEnabled(): boolean;
+export declare function enableDebug(): boolean;
+export declare function disableDebug(): void;
+export declare function getHealth(): { peerId: string; uptime: number; listeners: number };
+export declare function getCapabilities(): { peerId: string; capabilities: string[]; meta: any; version: string };
+export declare function addInboundHook(fn: (payload: any) => any): () => void;
+export declare function addOutboundHook(fn: (payload: any) => any): () => void;
+export declare function registerComponent(tag: string, caps: { signals: string[]; options?: any }): void;
+export declare function unregisterComponent(tag: string): void;
+export declare function getComponentCapabilities(tag: string): any;
+export declare function getRegisteredComponents(): Record<string, any>;
+export declare function getComponentsForSignal(signal: string): string[];
+
 // ============================================
 // SIGNALS 
 // ============================================
@@ -157,6 +190,12 @@ export declare class HttpError extends Error {
     body: string;
 }
 
+// ============================================
+// FORM UTILITIES
+// ============================================
+export declare function createFormState(initialValues: Record<string, any>): any;
+export declare function getFormValues(form: HTMLElement): Record<string, any>;
+
 // ============================================
 // THEME
 // ============================================
@@ -170,39 +209,64 @@ export interface Theme {
 export declare const Theme: Theme;
 
 // ============================================
-// COMPONENTS
+// AGENT API
+// ============================================
+export declare function getAuComponentTree(): any;
+export declare function findByLabel(label: string): HTMLElement | null;
+export declare function enableVisualMarkers(): void;
+export declare function disableVisualMarkers(): void;
+export declare function getMarkerMap(): Map<string, HTMLElement>;
+export declare function getMarkerElement(id: string): HTMLElement | null;
+export declare function getMCPActions(): any[];
+export declare function getErrors(): any[];
+export declare function clearErrors(): void;
+
+// ============================================
+// COMPONENTS — Layout
 // ============================================
-// Layout
 export declare class AuStack extends AuElement { }
 export declare class AuGrid extends AuElement { }
 export declare class AuContainer extends AuElement { }
+export declare class AuLayout extends AuElement { }
+export declare class AuPage extends AuElement { }
 export declare class AuNavbar extends AuElement { }
 export declare class AuNavbarBrand extends AuElement { }
 export declare class AuNavbarLinks extends AuElement { }
 export declare class AuNavbarActions extends AuElement { }
+export declare class AuNavItem extends AuElement { }
 export declare class AuSidebar extends AuElement { open(): void; close(): void; toggle(): void; }
 export declare class AuSidebarItem extends AuElement { }
+export declare class AuDrawer extends AuElement { toggle(): void; }
+export declare class AuDrawerItem extends AuElement { }
+export declare class AuBottomNav extends AuElement { }
 export declare class AuDivider extends AuElement { }
 
-// Form
+// ============================================
+// COMPONENTS — Form
+// ============================================
 export declare class AuButton extends AuElement { }
 export declare class AuInput extends AuElement { value: string; focus(): void; }
 export declare class AuTextarea extends AuElement { value: string; }
-export declare class AuForm extends AuElement { }
-export declare class AuDropdown extends AuElement { open(): void; close(): void; toggle(): void; }
+export declare class AuForm extends AuElement { getValues(): Record<string, any>; getFormData(): FormData; validate(): boolean; reset(): void; }
+export declare class AuSchemaForm extends AuElement { }
+export declare class AuDropdown extends AuElement { value: string; open(): void; close(): void; toggle(): void; }
 export declare class AuOption extends AuElement { }
 export declare class AuCheckbox extends AuElement { checked: boolean; toggle(): void; }
 export declare class AuSwitch extends AuElement { on: boolean; toggle(): void; }
 export declare class AuRadioGroup extends AuElement { value: string; }
 export declare class AuRadio extends AuElement { }
 export declare class AuChip extends AuElement { selected: boolean; }
+export declare class AuPromptInput extends AuElement { value: string; }
 
-// Display
+// ============================================
+// COMPONENTS — Display
+// ============================================
 export declare class AuCard extends AuElement { }
 export declare class AuTabs extends AuElement { }
 export declare class AuTab extends AuElement { }
 export declare class AuAlert extends AuElement { dismiss(): void; }
 export declare class AuBadge extends AuElement { }
+export declare class AuCallout extends AuElement { }
 export declare class AuProgress extends AuElement { }
 export declare class AuTable extends AuElement { }
 export declare class AuThead extends AuElement { }
@@ -210,25 +274,59 @@ export declare class AuTbody extends AuElement { }
 export declare class AuTr extends AuElement { }
 export declare class AuTh extends AuElement { }
 export declare class AuTd extends AuElement { }
+export declare class AuDataTable extends AuElement { setData(data: any[]): void; getData(): any[]; sortBy(field: string, dir?: string): void; filter(query: string): void; goToPage(n: number): void; getSelectedRows(): any[]; }
 export declare class AuAvatar extends AuElement { }
 export declare class AuSkeleton extends AuElement { }
+export declare class AuCode extends AuElement { }
+export declare class AuCodeBlock extends AuElement { }
+export declare class AuMessageBubble extends AuElement { }
 
-// Feedback
+// ============================================
+// COMPONENTS — Feedback
+// ============================================
 export declare class AuSpinner extends AuElement { }
 export declare class AuModal extends AuElement { open(): void; close(): void; }
+export declare class AuConfirm extends AuElement { }
 export declare class AuToast extends AuElement { dismiss(): void; }
+export declare class AuToastContainer extends AuElement { }
 export declare class AuTooltip extends AuElement { show(): void; hide(): void; }
+export declare class AuErrorBoundary extends AuElement { }
+export declare class AuSplash extends AuElement { }
 
-// Utility
+// ============================================
+// COMPONENTS — Utility
+// ============================================
 export declare class AuThemeToggle extends AuElement { }
 export declare class AuIcon extends AuElement { }
-export declare const IconNames: string[];
-
-// Performance
-export declare class AuVirtualList extends AuElement { items: any[]; renderItem: (item: any, index: number) => string; scrollToIndex(index: number): void; }
+export declare class AuFetch extends AuElement { }
 export declare class AuLazy extends AuElement { load(): void; }
 export declare class AuRepeat extends AuElement { items: any[]; keyFn: (item: any, index: number) => any; renderItem: (item: any, index: number) => string; refresh(): void; }
+export declare class AuVirtualList extends AuElement { items: any[]; renderItem: (item: any, index: number) => string; scrollToIndex(index: number): void; }
+export declare class AuRouter extends AuElement { }
+export declare class AuComponentTree extends AuElement { }
+export declare class AuAgentToolbar extends AuElement { }
+
+// ============================================
+// COMPONENTS — Documentation
+// ============================================
+export declare class AuDocPage extends AuElement { }
+export declare class AuExample extends AuElement { }
+export declare class AuApiTable extends AuElement { }
+export declare class AuApiRow extends AuElement { }
+
+export declare const IconNames: string[];
+
+// ============================================
+// PROGRAMMATIC DIALOGS
+// ============================================
+export declare function auConfirm(message: string, options?: {
+    title?: string;
+    confirmText?: string;
+    cancelText?: string;
+    variant?: 'primary' | 'danger' | 'warning';
+    size?: 'sm' | 'md' | 'lg';
+}): Promise<boolean>;
 
 export declare const Toast: {
-    show(message: string, options?: { severity?: string; duration?: number }): AuToast;
+    show(message: string, options?: { severity?: string; duration?: number; position?: string }): AuToast;
 };