@agent-ui-kit/web-components 0.0.7 → 0.0.14

package/dist/store.js

@@ -1,4 +1,4 @@
-import { s as a } from "./chunks/agent-ciCayeod.js";
+import { s as a } from "./chunks/agent-C72JZNe6.js";
 const n = (e) => e.length > 0 && "heading" in e[0], l = (e) => {
   const t = a(e ?? []);
   return {

package/dist/traits/attach.d.ts

@@ -0,0 +1,12 @@
+import { Dispose } from '../../../../shared/reactivity/index.ts';
+export interface AttachTraitOptions {
+    /** Config overrides (same keys as declarative trait config) */
+    config?: Readonly<Record<string, string>>;
+    /** Direct element reference for anchor — avoids needing a CSS selector */
+    anchorElement?: HTMLElement;
+}
+/**
+ * Attach a registered trait to any HTMLElement programmatically.
+ * Returns a dispose function that detaches the trait and cleans up.
+ */
+export declare const attachTrait: (target: HTMLElement, traitName: string, options?: AttachTraitOptions) => Dispose;

package/dist/traits/auto-dismiss/auto-dismiss.trait.d.ts

@@ -0,0 +1,2 @@
+import { TraitDefinition } from '../types.ts';
+export declare const autoDismissTrait: TraitDefinition;

package/dist/traits/backtick-wrap/backtick-wrap.trait.d.ts

@@ -0,0 +1,2 @@
+import { TraitDefinition } from '../types.ts';
+export declare const backtickWrapTrait: TraitDefinition;

package/dist/traits/clipboard/clipboard.trait.d.ts

@@ -0,0 +1,2 @@
+import { TraitDefinition } from '../types.ts';
+export declare const clipboardTrait: TraitDefinition;

package/dist/traits/collapsible/collapsible.trait.d.ts

@@ -0,0 +1,2 @@
+import { TraitDefinition } from '../types.ts';
+export declare const collapsibleTrait: TraitDefinition;

package/dist/traits/confetti/confetti.trait.d.ts

@@ -0,0 +1,2 @@
+import { TraitDefinition } from '../types.ts';
+export declare const confettiTrait: TraitDefinition;

package/dist/traits/copy/copy.trait.d.ts

@@ -0,0 +1,2 @@
+import { TraitDefinition } from '../types.ts';
+export declare const copyTrait: TraitDefinition;

package/dist/traits/css-inspect/css-inspect-controller.d.ts

@@ -0,0 +1,38 @@
+export interface CSSInspectOptions {
+    depth?: number;
+    scale?: number;
+    maxTilt?: number;
+    tiltRadius?: number;
+    perspective?: number;
+    labels?: boolean;
+    recursive?: boolean;
+    pick?: boolean;
+    alwaysReady?: boolean;
+    dismissOnClickOutside?: boolean;
+    tiltElement?: HTMLElement;
+    disabled?: boolean;
+}
+export declare class CSSInspectController {
+    #private;
+    readonly host: HTMLElement;
+    depth: number;
+    scale: number;
+    maxTilt: number;
+    tiltRadius: number;
+    perspective: number;
+    labels: boolean;
+    recursive: boolean;
+    pick: boolean;
+    alwaysReady: boolean;
+    dismissOnClickOutside: boolean;
+    tiltElement: HTMLElement | null;
+    disabled: boolean;
+    constructor(host: HTMLElement, options?: CSSInspectOptions);
+    get active(): boolean;
+    get inspectRoot(): HTMLElement;
+    attach(): void;
+    detach(): void;
+    destroy(): void;
+    inspect(target?: HTMLElement): void;
+    dismiss(): void;
+}

package/dist/traits/css-inspect/css-inspect.trait.d.ts

@@ -0,0 +1,2 @@
+import { TraitDefinition } from '../types.ts';
+export declare const cssInspectTrait: TraitDefinition;

package/dist/traits/dismiss/dismiss.trait.d.ts

@@ -0,0 +1,2 @@
+import { TraitDefinition } from '../types.ts';
+export declare const dismissTrait: TraitDefinition;

package/dist/traits/drag/drag.trait.d.ts

@@ -0,0 +1,2 @@
+import { TraitDefinition } from '../types.ts';
+export declare const dragTrait: TraitDefinition;

package/dist/traits/drop-zone/drop-zone.trait.d.ts

@@ -0,0 +1,2 @@
+import { TraitDefinition } from '../types.ts';
+export declare const dropZoneTrait: TraitDefinition;

package/dist/traits/edit/edit.trait.d.ts

@@ -0,0 +1,2 @@
+import { TraitDefinition } from '../types.ts';
+export declare const editTrait: TraitDefinition;

package/dist/traits/flip/flip.trait.d.ts

@@ -0,0 +1,2 @@
+import { TraitDefinition } from '../types.ts';
+export declare const flipTrait: TraitDefinition;

package/dist/traits/gateway/gateway.trait.d.ts

@@ -0,0 +1,2 @@
+import { TraitDefinition } from '../types.ts';
+export declare const gatewayTrait: TraitDefinition;

package/dist/traits/hover/hover.trait.d.ts

@@ -0,0 +1,2 @@
+import { TraitDefinition } from '../types.ts';
+export declare const hoverTrait: TraitDefinition;

package/dist/traits/index.d.ts

@@ -0,0 +1,6 @@
+export type { TraitDefinition, TraitContext, TraitEntry, TraitCategory } from './types.ts';
+export { registerTrait, getTrait, getTraitNames, getTraitsByCategory, validateComposition } from './registry.ts';
+export { attachTrait } from './attach.ts';
+export { parseTraitsAttribute } from './parse.ts';
+/** Register all 50 built-in traits. Call once at app startup. */
+export declare function registerBuiltinTraits(): void;

package/dist/traits/intersect/intersect.trait.d.ts

@@ -0,0 +1,2 @@
+import { TraitDefinition } from '../types.ts';
+export declare const intersectTrait: TraitDefinition;

package/dist/traits/link-paste/link-paste.trait.d.ts

@@ -0,0 +1,2 @@
+import { TraitDefinition } from '../types.ts';
+export declare const linkPasteTrait: TraitDefinition;

package/dist/traits/linked-scroll/linked-scroll.trait.d.ts

@@ -0,0 +1,2 @@
+import { TraitDefinition } from '../types.ts';
+export declare const linkedScrollTrait: TraitDefinition;

package/dist/traits/list-navigate/list-navigate.trait.d.ts

@@ -0,0 +1,2 @@
+import { TraitDefinition } from '../types.ts';
+export declare const listNavigateTrait: TraitDefinition;

package/dist/traits/magnet/magnet.trait.d.ts

@@ -0,0 +1,2 @@
+import { TraitDefinition } from '../types.ts';
+export declare const magnetTrait: TraitDefinition;

package/dist/traits/mention/mention.trait.d.ts

@@ -0,0 +1,2 @@
+import { TraitDefinition } from '../types.ts';
+export declare const mentionTrait: TraitDefinition;

package/dist/traits/modal/modal.trait.d.ts

@@ -0,0 +1,2 @@
+import { TraitDefinition } from '../types.ts';
+export declare const modalTrait: TraitDefinition;

package/dist/traits/noodle/noodle.trait.d.ts

@@ -0,0 +1,2 @@
+import { TraitDefinition } from '../types.ts';
+export declare const noodleTrait: TraitDefinition;

package/dist/traits/overlay/overlay.trait.d.ts

@@ -0,0 +1,3 @@
+import { TraitDefinition } from '../types.ts';
+export declare const popoverTrait: TraitDefinition;
+export declare const modalTrait: TraitDefinition;

package/dist/traits/pan-zoom/pan-zoom.trait.d.ts

@@ -0,0 +1,2 @@
+import { TraitDefinition } from '../types.ts';
+export declare const panZoomTrait: TraitDefinition;

package/dist/traits/parallax/parallax.trait.d.ts

@@ -0,0 +1,2 @@
+import { TraitDefinition } from '../types.ts';
+export declare const parallaxTrait: TraitDefinition;

package/dist/traits/parse.d.ts

@@ -0,0 +1,3 @@
+import { TraitEntry } from './types.ts';
+/** Parse the `traits` attribute value into an array of TraitEntry */
+export declare const parseTraitsAttribute: (value: string | null) => readonly TraitEntry[];

package/dist/traits/persist/persist.trait.d.ts

@@ -0,0 +1,2 @@
+import { TraitDefinition } from '../types.ts';
+export declare const persistTrait: TraitDefinition;

package/dist/traits/popover/overlay.d.ts

@@ -0,0 +1,2 @@
+import { TraitDefinition } from '../types.ts';
+export declare const createOverlayTrait: (name: string, modal: boolean) => TraitDefinition;

package/dist/traits/popover/popover.trait.d.ts

@@ -0,0 +1,2 @@
+import { TraitDefinition } from '../types.ts';
+export declare const popoverTrait: TraitDefinition;

package/dist/traits/present/present.trait.d.ts

@@ -0,0 +1,2 @@
+import { TraitDefinition } from '../types.ts';
+export declare const presentTrait: TraitDefinition;

package/dist/traits/press-hold/press-hold.trait.d.ts

@@ -0,0 +1,2 @@
+import { TraitDefinition } from '../types.ts';
+export declare const pressHoldTrait: TraitDefinition;

package/dist/traits/range-select/range-select.trait.d.ts

@@ -0,0 +1,2 @@
+import { TraitDefinition } from '../types.ts';
+export declare const rangeSelectTrait: TraitDefinition;

package/dist/traits/registry.d.ts

@@ -0,0 +1,17 @@
+import { TraitDefinition, TraitEntry } from './types.ts';
+/** Register a trait definition */
+export declare const registerTrait: (def: TraitDefinition) => void;
+/** Look up a trait by name */
+export declare const getTrait: (name: string) => TraitDefinition | undefined;
+/** Get all registered trait names */
+export declare const getTraitNames: () => readonly string[];
+/** Get registered traits grouped by category */
+export declare const getTraitsByCategory: () => ReadonlyMap<string, readonly string[]>;
+/**
+ * Validate composition rules for a set of traits on one element.
+ * Logs warnings for violations. Returns only the valid entries.
+ */
+export declare const validateComposition: (entries: readonly TraitEntry[], hostTag: string) => readonly {
+    entry: TraitEntry;
+    def: TraitDefinition;
+}[];

package/dist/traits/resize/resize.trait.d.ts

@@ -0,0 +1,2 @@
+import { TraitDefinition } from '../types.ts';
+export declare const resizeTrait: TraitDefinition;

package/dist/traits/ripple/ripple.trait.d.ts

@@ -0,0 +1,2 @@
+import { TraitDefinition } from '../types.ts';
+export declare const rippleTrait: TraitDefinition;

package/dist/traits/roving-focus/roving-focus.trait.d.ts

@@ -0,0 +1,2 @@
+import { TraitDefinition } from '../types.ts';
+export declare const rovingFocusTrait: TraitDefinition;

package/dist/traits/search/search.trait.d.ts

@@ -0,0 +1,2 @@
+import { TraitDefinition } from '../types.ts';
+export declare const searchTrait: TraitDefinition;

package/dist/traits/selection/selection.trait.d.ts

@@ -0,0 +1,2 @@
+import { TraitDefinition } from '../types.ts';
+export declare const selectionTrait: TraitDefinition;

package/dist/traits/shortcut/shortcut.trait.d.ts

@@ -0,0 +1,2 @@
+import { TraitDefinition } from '../types.ts';
+export declare const shortcutTrait: TraitDefinition;

package/dist/traits/slash-command/slash-command.trait.d.ts

@@ -0,0 +1,2 @@
+import { TraitDefinition } from '../types.ts';
+export declare const slashCommandTrait: TraitDefinition;

package/dist/traits/snap-resize/snap-resize.trait.d.ts

@@ -0,0 +1,2 @@
+import { TraitDefinition } from '../types.ts';
+export declare const snapResizeTrait: TraitDefinition;

package/dist/traits/sort/sort.trait.d.ts

@@ -0,0 +1,2 @@
+import { TraitDefinition } from '../types.ts';
+export declare const sortTrait: TraitDefinition;

package/dist/traits/store/store.trait.d.ts

@@ -0,0 +1,2 @@
+import { TraitDefinition } from '../types.ts';
+export declare const storeTrait: TraitDefinition;

package/dist/traits/swipe/swipe.trait.d.ts

@@ -0,0 +1,2 @@
+import { TraitDefinition } from '../types.ts';
+export declare const swipeTrait: TraitDefinition;

package/dist/traits/text-trigger/text-trigger.trait.d.ts

@@ -0,0 +1,2 @@
+import { TraitDefinition } from '../types.ts';
+export declare const textTriggerTrait: TraitDefinition;

package/dist/traits/toast/toast.trait.d.ts

@@ -0,0 +1,2 @@
+import { TraitDefinition } from '../types.ts';
+export declare const toastTrait: TraitDefinition;

package/dist/traits/toggle-scheme/toggle-scheme.trait.d.ts

@@ -0,0 +1,2 @@
+import { TraitDefinition } from '../types.ts';
+export declare const toggleSchemeTrait: TraitDefinition;

package/dist/traits/toggle-state/toggle-state.trait.d.ts

@@ -0,0 +1,2 @@
+import { TraitDefinition } from '../types.ts';
+export declare const toggleStateTrait: TraitDefinition;

package/dist/traits/tooltip/tooltip.trait.d.ts

@@ -0,0 +1,2 @@
+import { TraitDefinition } from '../types.ts';
+export declare const tooltipTrait: TraitDefinition;

package/dist/traits/toss/toss.trait.d.ts

@@ -0,0 +1,2 @@
+import { TraitDefinition } from '../types.ts';
+export declare const tossTrait: TraitDefinition;

package/dist/traits/trap-focus/trap-focus.trait.d.ts

@@ -0,0 +1,2 @@
+import { TraitDefinition } from '../types.ts';
+export declare const trapFocusTrait: TraitDefinition;

package/dist/traits/types.d.ts

@@ -0,0 +1,45 @@
+import { Dispose } from '../../../../shared/reactivity/index.ts';
+/** Trait categories govern composition rules */
+export type TraitCategory = 'gesture' | 'state' | 'focus' | 'present' | 'effect';
+/** Parsed trait entry from the traits attribute */
+export interface TraitEntry {
+    readonly name: string;
+    readonly config: Readonly<Record<string, string>>;
+}
+/** Context passed to a trait's attach function */
+export interface TraitContext {
+    /** The host AgentElement */
+    readonly host: HTMLElement;
+    /** Register a reactive effect (auto-disposed on disconnect) */
+    readonly addEffect: (fn: () => void) => void;
+    /** Dispatch a composed bubbling event from the host */
+    readonly emit: (name: string, detail?: Record<string, unknown>) => void;
+    /** Read a config value, falling back to the trait's declared default */
+    readonly config: (key: string) => string | undefined;
+    /** Set data-{traitName}-{key} attribute on host for external state */
+    readonly expose: (key: string, value: string | boolean) => void;
+    /** Remove data-{traitName}-{key} attribute from host */
+    readonly unexpose: (key: string) => void;
+}
+/** A trait definition — pure data + functions */
+export interface TraitDefinition {
+    /** Unique trait name (e.g., 'toggle-scheme', 'draggable') */
+    readonly name: string;
+    /** Category governs composition rules */
+    readonly category: TraitCategory;
+    /** For gesture traits: interaction channel ('pointer' | 'keyboard') */
+    readonly channel?: string;
+    /** Side-effect scope: 'self' (host only) or 'external' (mutates outside DOM) */
+    readonly targets?: 'self' | 'external';
+    /** Default config values */
+    readonly defaults?: Readonly<Record<string, string>>;
+    /** Dispatchable event names the trait responds to (e.g., 'open', 'close') */
+    readonly actions?: readonly string[];
+    /**
+     * Attach the trait to a host element. Called during activate().
+     * Return a Dispose function for non-reactive cleanup
+     * (event listeners on external targets, matchMedia, etc.).
+     * Reactive effects registered via ctx.addEffect() are auto-cleaned.
+     */
+    readonly attach: (ctx: TraitContext) => Dispose | void;
+}

package/dist/traits/validate/validate.trait.d.ts

@@ -0,0 +1,2 @@
+import { TraitDefinition } from '../types.ts';
+export declare const validateTrait: TraitDefinition;

package/dist/traits/virtual-scroll/virtual-scroll.trait.d.ts

@@ -0,0 +1,2 @@
+import { TraitDefinition } from '../types.ts';
+export declare const virtualScrollTrait: TraitDefinition;