@threadlabs/looma 0.1.22 → 0.1.24

package/dist/types/components/ui-combobox/ui-combobox.d.ts

@@ -0,0 +1,93 @@
+import { type EventEmitter } from '../../stencil-public-runtime';
+import type { ComboboxConfig, ComboboxOption, ComboboxChange, ComboboxValidationState } from '../../field/combobox';
+/** A single editable field with contextual suggestions, optional help and field validation. */
+export declare class UICombobox {
+    host: HTMLElement;
+    /** Accessible visible label, associated with the native text input. */
+    label: string;
+    placeholder: string;
+    name: string;
+    /** Controlled canonical value. Undefined selects uncontrolled mode; null means no selection. */
+    value?: string | null;
+    defaultValue?: string;
+    /** Controlled raw editing text; independent of canonical selection. */
+    query?: string;
+    defaultQuery: string;
+    /** Immutable configuration; replace the object/context when dependencies change. */
+    config: ComboboxConfig;
+    disabled: boolean;
+    readOnly: boolean;
+    required: boolean;
+    size: 'sm' | 'md';
+    disclosure: boolean;
+    clearable: boolean;
+    /** Optional description shown by the connected question-mark button. */
+    help: string;
+    queryChange: EventEmitter<{
+        query: string;
+        display: string;
+        trigger: 'keyboard' | 'pointer' | 'programmatic';
+    }>;
+    valueChange: EventEmitter<ComboboxChange>;
+    freeEntry: EventEmitter<ComboboxChange>;
+    createEntry: EventEmitter<ComboboxChange>;
+    dependencyInvalidate: EventEmitter<ComboboxChange>;
+    validationChange: EventEmitter<ComboboxValidationState>;
+    /** Supplies the current result rows for framework-owned rich slots. */
+    optionsChange: EventEmitter<readonly ComboboxOption[]>;
+    raw: string;
+    display: string;
+    selected: string | null;
+    expanded: boolean;
+    rows: readonly ComboboxOption[];
+    active: number;
+    loading: boolean;
+    helpOpen: boolean;
+    lookupError: string;
+    validation: ComboboxValidationState;
+    private input?;
+    private popup?;
+    private field?;
+    private surface?;
+    private lookup?;
+    private validationRun?;
+    private lookupTimer?;
+    private composing;
+    private initialRaw;
+    private overlayId;
+    private alive;
+    private fullSet;
+    private knownOptions;
+    private awaitingLabel;
+    private proposedChange?;
+    private formattedRaw?;
+    private formattedWith?;
+    componentWillLoad(): void;
+    connectedCallback(): void;
+    componentDidLoad(): void;
+    componentDidUpdate(): void;
+    disconnectedCallback(): void;
+    private setupSurface;
+    syncValue(): void;
+    syncQuery(): void;
+    syncDisabled(): void;
+    syncConfig(next: ComboboxConfig, previous: ComboboxConfig): void;
+    private applyServerIssues;
+    private resetValidation;
+    private cancelLookup;
+    private close;
+    private open;
+    private search;
+    private get canCreate();
+    private format;
+    private onInput;
+    private commit;
+    private choose;
+    private move;
+    private onKeydown;
+    private onFocusOut;
+    private setValidation;
+    /** Validate for submission. Caller submits only non-pending, non-error output. */
+    validate(): Promise<ComboboxValidationState>;
+    render(): any;
+}

package/dist/types/components/ui-dialog/ui-dialog.d.ts

@@ -1,15 +1,20 @@
 export declare class UIDialog {
     host: HTMLElement;
-    open: boolean;
+    /** Controlled open state. Omit it to use defaultOpen and local interaction state. */
+    open?: boolean;
     defaultOpen: boolean;
     modal: boolean;
     dismissible: boolean;
     /** Accessible name forwarded to the native dialog surface. */
     label?: string;
     internalOpen: boolean;
+    accessibleLabel: string;
     private overlayId;
     private dialogRef?;
+    private contentObserver;
     syncFromProp(): void;
+    syncLabelFromProp(): void;
+    componentWillLoad(): void;
     syncOpen(): void;
     componentDidLoad(): void;
     disconnectedCallback(): void;
@@ -17,5 +22,6 @@ export declare class UIDialog {
     private handleRequestClose;
     private onDialogClose;
     private onKeydown;
+    private syncAccessibleLabel;
     render(): any;
 }

package/dist/types/components/ui-disclosure/ui-disclosure.d.ts

@@ -1,6 +1,7 @@
 export declare class UIDisclosure {
     host: HTMLElement;
-    open: boolean;
+    /** Controlled open state. Omit it to use defaultOpen and local interaction state. */
+    open?: boolean;
     defaultOpen: boolean;
     disabled: boolean;
     internalOpen: boolean;

package/dist/types/components/ui-form-field/ui-form-field.d.ts

@@ -3,8 +3,16 @@ export declare class UIFormField {
     invalid: boolean;
     disabled: boolean;
     required: boolean;
+    private observer;
+    private activeInput;
+    private ownedDescriptionIds;
+    private wireQueued;
     componentDidLoad(): void;
     componentDidUpdate(): void;
+    disconnectedCallback(): void;
+    private descriptionIds;
+    private removeOwnedDescriptions;
+    private scheduleWire;
     private wire;
     render(): any;
 }

package/dist/types/components/ui-input/ui-input.d.ts

@@ -1,6 +1,6 @@
 export declare class UIInput {
     host: HTMLElement;
-    value: string;
+    value?: string;
     defaultValue: string;
     disabled: boolean;
     invalid: boolean;

package/dist/types/components/ui-menu/ui-menu.d.ts

@@ -1,7 +1,8 @@
 import { type AnchoredPlacement } from '../../overlay/positioning';
 export declare class UIMenu {
     host: HTMLElement;
-    open: boolean;
+    /** Controlled open state. Omit it to use defaultOpen and local interaction state. */
+    open?: boolean;
     defaultOpen: boolean;
     /** Id of the control that anchors this menu in the top layer. */
     for?: string;

package/dist/types/components/ui-popover/ui-popover.d.ts

@@ -1,7 +1,8 @@
 import { type AnchoredPlacement } from '../../overlay/positioning';
 export declare class UIPopover {
     host: HTMLElement;
-    open: boolean;
+    /** Controlled open state. Omit it to use defaultOpen and local interaction state. */
+    open?: boolean;
     defaultOpen: boolean;
     /** Optional id of the element this popover follows in the top layer. */
     for?: string;

package/dist/types/components/ui-radio/ui-radio.d.ts

@@ -1,12 +1,15 @@
 export declare class UIRadio {
     host: HTMLElement;
-    checked: boolean;
+    /** Controlled checked state. Omit it to use defaultChecked and local interaction state. */
+    checked?: boolean;
     defaultChecked: boolean;
     disabled: boolean;
     name: string;
     required: boolean;
     value: string;
+    internalChecked: boolean;
     private slotRef?;
+    syncFromProp(): void;
     syncToInput(): void;
     componentDidLoad(): void;
     disconnectedCallback(): void;

package/dist/types/components/ui-select/ui-select.d.ts

@@ -1,12 +1,13 @@
 export declare class UISelect {
     host: HTMLElement;
-    value: string;
-    defaultValue: string;
+    value?: string;
+    defaultValue?: string;
     disabled: boolean;
     invalid: boolean;
     required: boolean;
     internalValue: string;
     private slotRef?;
+    private initialized;
     syncFromProp(): void;
     syncToSelect(): void;
     componentDidLoad(): void;

package/dist/types/components/ui-switch/ui-switch.d.ts

@@ -1,6 +1,7 @@
 export declare class UISwitch {
     host: HTMLElement;
-    checked: boolean;
+    /** Controlled checked state. Omit it to use defaultChecked and local interaction state. */
+    checked?: boolean;
     defaultChecked: boolean;
     disabled: boolean;
     required: boolean;

package/dist/types/components/ui-tabs/ui-tabs.d.ts

@@ -1,6 +1,7 @@
 export declare class UITabs {
     host: HTMLElement;
-    value: string;
+    /** Controlled selected tab value. Omit it to use defaultValue and local interaction state. */
+    value?: string;
     defaultValue: string;
     orientation: 'horizontal' | 'vertical';
     internalValue: string;

package/dist/types/components/ui-textarea/ui-textarea.d.ts

@@ -1,6 +1,6 @@
 export declare class UITextarea {
     host: HTMLElement;
-    value: string;
+    value?: string;
     defaultValue: string;
     disabled: boolean;
     invalid: boolean;

package/dist/types/components/ui-toast-region/ui-toast-region.d.ts

@@ -3,12 +3,14 @@ export declare class UIToastRegion {
     open: boolean;
     internalOpen: boolean;
     private surface;
+    private contentObserver;
+    private pendingDismiss;
     syncFromProp(): void;
     syncSurface(): void;
     componentDidLoad(): void;
     disconnectedCallback(): void;
     private getToasts;
-    private updateOpenState;
+    private syncContents;
     private onClick;
     render(): any;
 }

package/dist/types/components/ui-tooltip/ui-tooltip.d.ts

@@ -1,14 +1,30 @@
+import { type EventEmitter } from '../../stencil-public-runtime';
 import { type AnchoredPlacement } from '../../overlay/positioning';
 export declare class UITooltip {
     host: HTMLElement;
     for: string;
-    open: boolean;
+    /** Controlled open state. Omit it to use defaultOpen and local interaction state. */
+    open?: boolean;
     defaultOpen: boolean;
     placement: AnchoredPlacement;
     /** Pointer hover intent delay in milliseconds. Keyboard focus is immediate. */
     showDelay: number;
     /** Pointer leave grace period in milliseconds. */
     hideDelay: number;
+    /** Click or tap pins the description; activate again to dismiss. */
+    toggleOnClick: boolean;
+    private pinned;
+    private focused;
+    opened: EventEmitter<{
+        open: boolean;
+        reason: string;
+        trigger: string;
+    }>;
+    closed: EventEmitter<{
+        open: boolean;
+        reason: string;
+        trigger: string;
+    }>;
     internalOpen: boolean;
     private overlayId;
     private trigger;
@@ -29,11 +45,13 @@ export declare class UITooltip {
     private clearHideTimer;
     private clearTimers;
     private setInteractionOpen;
+    private onSurfaceEnter;
+    private onTriggerClick;
+    private onTriggerKeydown;
     private onTriggerEnter;
     private onTriggerLeave;
     private onTriggerFocusIn;
     private onTriggerFocusOut;
     private handleRequestClose;
-    private onKeydown;
     render(): any;
 }

package/dist/types/components/ui-tree/ui-tree.d.ts

@@ -2,21 +2,34 @@ export declare class UITree {
     host: HTMLElement;
     label: string;
     hoverExpandDelay: number;
+    /** Maximum resulting item depth accepted by pointer reordering. Zero is unlimited. */
+    maxDepth: number;
     private source;
     private target;
     private position;
+    private rejectedTarget;
+    private rejectedPosition;
+    private rejection;
     private hoverIntent;
+    private structureObserver;
+    private tabStop;
     componentDidLoad(): void;
     disconnectedCallback(): void;
+    private syncStructuralLevels;
+    private syncTabStop;
     private itemFromEvent;
+    private eventTargetsInteractiveContent;
     private itemId;
     private rowFor;
     private itemAtPoint;
     private isWithinTree;
     private acceptsChildren;
     private itemMetadata;
-    private permitsDrop;
+    private constraintDepth;
+    private subtreeDepth;
+    private dropRejection;
     private clearTarget;
+    private clearRejection;
     private finishDrag;
     private expandTarget;
     private onDragStart;
@@ -25,9 +38,16 @@ export declare class UITree {
     private onDragOver;
     private onDragLeave;
     private dispatchReorder;
+    private dispatchReorderRejected;
     private onDrop;
     private onDragEnd;
     private visibleItems;
+    private parentItem;
+    private firstVisibleChild;
+    private focusItem;
+    private requestExpansion;
+    private onFocusIn;
+    private onExpansionChange;
     private onKeyDown;
     render(): any;
 }

package/dist/types/components/ui-tree-item/ui-tree-item.d.ts

@@ -4,8 +4,10 @@ export declare class UITreeItem {
     itemId: string;
     /** Accessible name used by the disclosure and drag handle. */
     label: string;
-    /** One-based visual and semantic nesting level. */
-    depth: number;
+    /** Application hierarchy depth override used for drop constraints. Defaults to structural nesting. */
+    dropDepth?: number;
+    /** Virtualized-tree descendant-depth override for the tree's max-depth drop constraint. */
+    subtreeDepth?: number;
     /** Whether this item accepts children and exposes disclosure behavior. */
     container: boolean;
     /** Whether this item participates in pointer drag and drop. */
@@ -16,19 +18,25 @@ export declare class UITreeItem {
     dropScope: string;
     /** Comma-separated drag kinds accepted as children. Empty accepts every kind. */
     accepts: string;
-    /** Initial controlled expansion value. */
-    expanded: boolean;
+    /** Controlled expansion value. When omitted, `default-expanded` initializes uncontrolled state. */
+    expanded?: boolean;
     /** Initial uncontrolled expansion value. */
     defaultExpanded: boolean;
     selected: boolean;
     disabled: boolean;
     internalExpanded: boolean;
+    structuralLevel: number;
+    tabStop: boolean;
     syncExpandedFromProp(): void;
     componentWillLoad(): void;
-    componentDidLoad(): void;
+    connectedCallback(): void;
     disconnectedCallback(): void;
+    private updateStructuralLevel;
     private setExpanded;
+    private isExpanded;
     private onAutoExpand;
+    private onRovingTabStop;
+    private onExpansionRequest;
     private onDisclosureClick;
     private onDisclosureKeydown;
     private onRowClick;