@threadlabs/looma 0.1.22 → 0.1.23

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

@@ -2,9 +2,14 @@ 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;
     componentDidLoad(): void;
     disconnectedCallback(): void;
@@ -15,8 +20,10 @@ export declare class UITree {
     private isWithinTree;
     private acceptsChildren;
     private itemMetadata;
-    private permitsDrop;
+    private constraintDepth;
+    private dropRejection;
     private clearTarget;
+    private clearRejection;
     private finishDrag;
     private expandTarget;
     private onDragStart;
@@ -25,6 +32,7 @@ export declare class UITree {
     private onDragOver;
     private onDragLeave;
     private dispatchReorder;
+    private dispatchReorderRejected;
     private onDrop;
     private onDragEnd;
     private visibleItems;

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

@@ -6,6 +6,10 @@ export declare class UITreeItem {
     label: string;
     /** One-based visual and semantic nesting level. */
     depth: number;
+    /** Application hierarchy depth used for drop constraints. Defaults to visual depth. */
+    dropDepth?: number;
+    /** Deepest descendant distance, used with 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. */

package/dist/types/components.d.ts

@@ -5,7 +5,9 @@
  * It contains typing information for all components that exist in this project.
  */
 import { HTMLStencilElement, JSXBase } from "./stencil-public-runtime";
+import { ComboboxChange, ComboboxConfig, ComboboxOption, ComboboxValidationState } from "./field/combobox";
 import { AnchoredPlacement } from "./overlay/positioning";
+export { ComboboxChange, ComboboxConfig, ComboboxOption, ComboboxValidationState } from "./field/combobox";
 export { AnchoredPlacement } from "./overlay/positioning";
 export namespace Components {
     interface UiAffordanceScope {
@@ -84,6 +86,75 @@ export namespace Components {
          */
         "value": string;
     }
+    /**
+     * A single editable field with contextual suggestions, optional help and field validation.
+     */
+    interface UiCombobox {
+        /**
+          * @default false
+         */
+        "clearable": boolean;
+        /**
+          * Immutable configuration; replace the object/context when dependencies change.
+          * @default {}
+         */
+        "config": ComboboxConfig;
+        /**
+          * @default ''
+         */
+        "defaultQuery": string;
+        "defaultValue"?: string;
+        /**
+          * @default false
+         */
+        "disabled": boolean;
+        /**
+          * @default false
+         */
+        "disclosure": boolean;
+        /**
+          * Optional description shown by the connected question-mark button.
+          * @default ''
+         */
+        "help": string;
+        /**
+          * Accessible visible label, associated with the native text input.
+          * @default ''
+         */
+        "label": string;
+        /**
+          * @default ''
+         */
+        "name": string;
+        /**
+          * @default ''
+         */
+        "placeholder": string;
+        /**
+          * Controlled raw editing text; independent of canonical selection.
+         */
+        "query"?: string;
+        /**
+          * @default false
+         */
+        "readOnly": boolean;
+        /**
+          * @default false
+         */
+        "required": boolean;
+        /**
+          * @default 'md'
+         */
+        "size": 'sm' | 'md';
+        /**
+          * Validate for submission. Caller submits only non-pending, non-error output.
+         */
+        "validate": () => Promise<ComboboxValidationState>;
+        /**
+          * Controlled canonical value. Undefined selects uncontrolled mode; null means no selection.
+         */
+        "value"?: string | null;
+    }
     interface UiContextMenu {
         /**
           * Opens the menu on first client render.
@@ -204,10 +275,7 @@ export namespace Components {
           * @default false
          */
         "readOnly": boolean;
-        /**
-          * @default ''
-         */
-        "value": string;
+        "value"?: string;
     }
     interface UiMenu {
         /**
@@ -317,10 +385,7 @@ export namespace Components {
     interface UiSearchShell {
     }
     interface UiSelect {
-        /**
-          * @default ''
-         */
-        "defaultValue": string;
+        "defaultValue"?: string;
         /**
           * @default false
          */
@@ -333,10 +398,7 @@ export namespace Components {
           * @default false
          */
         "required": boolean;
-        /**
-          * @default ''
-         */
-        "value": string;
+        "value"?: string;
     }
     interface UiSwitch {
         /**
@@ -395,10 +457,7 @@ export namespace Components {
           * @default 4
          */
         "rows": number;
-        /**
-          * @default ''
-         */
-        "value": string;
+        "value"?: string;
     }
     interface UiToastRegion {
         /**
@@ -433,6 +492,11 @@ export namespace Components {
           * @default 500
          */
         "showDelay": number;
+        /**
+          * Click or tap pins the description; activate again to dismiss.
+          * @default false
+         */
+        "toggleOnClick": boolean;
     }
     interface UiTopBar {
     }
@@ -445,6 +509,11 @@ export namespace Components {
           * @default 'Tree'
          */
         "label": string;
+        /**
+          * Maximum resulting item depth accepted by pointer reordering. Zero is unlimited.
+          * @default 0
+         */
+        "maxDepth": number;
     }
     interface UiTreeItem {
         /**
@@ -476,6 +545,10 @@ export namespace Components {
           * @default 'item'
          */
         "dragType": string;
+        /**
+          * Application hierarchy depth used for drop constraints. Defaults to visual depth.
+         */
+        "dropDepth"?: number;
         /**
           * Application-defined parent/list identity included with reorder events.
           * @default ''
@@ -505,8 +578,20 @@ export namespace Components {
           * @default false
          */
         "sortable": boolean;
+        /**
+          * Deepest descendant distance, used with the tree's max-depth drop constraint.
+         */
+        "subtreeDepth"?: number;
     }
 }
+export interface UiComboboxCustomEvent<T> extends CustomEvent<T> {
+    detail: T;
+    target: HTMLUiComboboxElement;
+}
+export interface UiTooltipCustomEvent<T> extends CustomEvent<T> {
+    detail: T;
+    target: HTMLUiTooltipElement;
+}
 declare global {
     interface HTMLUiAffordanceScopeElement extends Components.UiAffordanceScope, HTMLStencilElement {
     }
@@ -544,6 +629,32 @@ declare global {
         prototype: HTMLUiCheckboxElement;
         new (): HTMLUiCheckboxElement;
     };
+    interface HTMLUiComboboxElementEventMap {
+        "query-change": { query: string; display: string; trigger: 'keyboard' | 'pointer' | 'programmatic' };
+        "value-change": ComboboxChange;
+        "free-entry": ComboboxChange;
+        "create-entry": ComboboxChange;
+        "dependency-invalidate": ComboboxChange;
+        "validation-change": ComboboxValidationState;
+        "options-change": readonly ComboboxOption[];
+    }
+    /**
+     * A single editable field with contextual suggestions, optional help and field validation.
+     */
+    interface HTMLUiComboboxElement extends Components.UiCombobox, HTMLStencilElement {
+        addEventListener<K extends keyof HTMLUiComboboxElementEventMap>(type: K, listener: (this: HTMLUiComboboxElement, ev: UiComboboxCustomEvent<HTMLUiComboboxElementEventMap[K]>) => any, options?: boolean | AddEventListenerOptions): void;
+        addEventListener<K extends keyof DocumentEventMap>(type: K, listener: (this: Document, ev: DocumentEventMap[K]) => any, options?: boolean | AddEventListenerOptions): void;
+        addEventListener<K extends keyof HTMLElementEventMap>(type: K, listener: (this: HTMLElement, ev: HTMLElementEventMap[K]) => any, options?: boolean | AddEventListenerOptions): void;
+        addEventListener(type: string, listener: EventListenerOrEventListenerObject, options?: boolean | AddEventListenerOptions): void;
+        removeEventListener<K extends keyof HTMLUiComboboxElementEventMap>(type: K, listener: (this: HTMLUiComboboxElement, ev: UiComboboxCustomEvent<HTMLUiComboboxElementEventMap[K]>) => any, options?: boolean | EventListenerOptions): void;
+        removeEventListener<K extends keyof DocumentEventMap>(type: K, listener: (this: Document, ev: DocumentEventMap[K]) => any, options?: boolean | EventListenerOptions): void;
+        removeEventListener<K extends keyof HTMLElementEventMap>(type: K, listener: (this: HTMLElement, ev: HTMLElementEventMap[K]) => any, options?: boolean | EventListenerOptions): void;
+        removeEventListener(type: string, listener: EventListenerOrEventListenerObject, options?: boolean | EventListenerOptions): void;
+    }
+    var HTMLUiComboboxElement: {
+        prototype: HTMLUiComboboxElement;
+        new (): HTMLUiComboboxElement;
+    };
     interface HTMLUiContextMenuElement extends Components.UiContextMenu, HTMLStencilElement {
     }
     var HTMLUiContextMenuElement: {
@@ -658,7 +769,19 @@ declare global {
         prototype: HTMLUiToastRegionElement;
         new (): HTMLUiToastRegionElement;
     };
+    interface HTMLUiTooltipElementEventMap {
+        "open": { open: boolean; reason: string; trigger: string };
+        "close": { open: boolean; reason: string; trigger: string };
+    }
     interface HTMLUiTooltipElement extends Components.UiTooltip, HTMLStencilElement {
+        addEventListener<K extends keyof HTMLUiTooltipElementEventMap>(type: K, listener: (this: HTMLUiTooltipElement, ev: UiTooltipCustomEvent<HTMLUiTooltipElementEventMap[K]>) => any, options?: boolean | AddEventListenerOptions): void;
+        addEventListener<K extends keyof DocumentEventMap>(type: K, listener: (this: Document, ev: DocumentEventMap[K]) => any, options?: boolean | AddEventListenerOptions): void;
+        addEventListener<K extends keyof HTMLElementEventMap>(type: K, listener: (this: HTMLElement, ev: HTMLElementEventMap[K]) => any, options?: boolean | AddEventListenerOptions): void;
+        addEventListener(type: string, listener: EventListenerOrEventListenerObject, options?: boolean | AddEventListenerOptions): void;
+        removeEventListener<K extends keyof HTMLUiTooltipElementEventMap>(type: K, listener: (this: HTMLUiTooltipElement, ev: UiTooltipCustomEvent<HTMLUiTooltipElementEventMap[K]>) => any, options?: boolean | EventListenerOptions): void;
+        removeEventListener<K extends keyof DocumentEventMap>(type: K, listener: (this: Document, ev: DocumentEventMap[K]) => any, options?: boolean | EventListenerOptions): void;
+        removeEventListener<K extends keyof HTMLElementEventMap>(type: K, listener: (this: HTMLElement, ev: HTMLElementEventMap[K]) => any, options?: boolean | EventListenerOptions): void;
+        removeEventListener(type: string, listener: EventListenerOrEventListenerObject, options?: boolean | EventListenerOptions): void;
     }
     var HTMLUiTooltipElement: {
         prototype: HTMLUiTooltipElement;
@@ -689,6 +812,7 @@ declare global {
         "ui-badge": HTMLUiBadgeElement;
         "ui-button": HTMLUiButtonElement;
         "ui-checkbox": HTMLUiCheckboxElement;
+        "ui-combobox": HTMLUiComboboxElement;
         "ui-context-menu": HTMLUiContextMenuElement;
         "ui-dialog": HTMLUiDialogElement;
         "ui-disclosure": HTMLUiDisclosureElement;
@@ -791,6 +915,81 @@ declare namespace LocalJSX {
          */
         "value"?: string;
     }
+    /**
+     * A single editable field with contextual suggestions, optional help and field validation.
+     */
+    interface UiCombobox {
+        /**
+          * @default false
+         */
+        "clearable"?: boolean;
+        /**
+          * Immutable configuration; replace the object/context when dependencies change.
+          * @default {}
+         */
+        "config"?: ComboboxConfig;
+        /**
+          * @default ''
+         */
+        "defaultQuery"?: string;
+        "defaultValue"?: string;
+        /**
+          * @default false
+         */
+        "disabled"?: boolean;
+        /**
+          * @default false
+         */
+        "disclosure"?: boolean;
+        /**
+          * Optional description shown by the connected question-mark button.
+          * @default ''
+         */
+        "help"?: string;
+        /**
+          * Accessible visible label, associated with the native text input.
+          * @default ''
+         */
+        "label"?: string;
+        /**
+          * @default ''
+         */
+        "name"?: string;
+        "onCreate-entry"?: (event: UiComboboxCustomEvent<ComboboxChange>) => void;
+        "onDependency-invalidate"?: (event: UiComboboxCustomEvent<ComboboxChange>) => void;
+        "onFree-entry"?: (event: UiComboboxCustomEvent<ComboboxChange>) => void;
+        /**
+          * Supplies the current result rows for framework-owned rich slots.
+         */
+        "onOptions-change"?: (event: UiComboboxCustomEvent<readonly ComboboxOption[]>) => void;
+        "onQuery-change"?: (event: UiComboboxCustomEvent<{ query: string; display: string; trigger: 'keyboard' | 'pointer' | 'programmatic' }>) => void;
+        "onValidation-change"?: (event: UiComboboxCustomEvent<ComboboxValidationState>) => void;
+        "onValue-change"?: (event: UiComboboxCustomEvent<ComboboxChange>) => void;
+        /**
+          * @default ''
+         */
+        "placeholder"?: string;
+        /**
+          * Controlled raw editing text; independent of canonical selection.
+         */
+        "query"?: string;
+        /**
+          * @default false
+         */
+        "readOnly"?: boolean;
+        /**
+          * @default false
+         */
+        "required"?: boolean;
+        /**
+          * @default 'md'
+         */
+        "size"?: 'sm' | 'md';
+        /**
+          * Controlled canonical value. Undefined selects uncontrolled mode; null means no selection.
+         */
+        "value"?: string | null;
+    }
     interface UiContextMenu {
         /**
           * Opens the menu on first client render.
@@ -911,9 +1110,6 @@ declare namespace LocalJSX {
           * @default false
          */
         "readOnly"?: boolean;
-        /**
-          * @default ''
-         */
         "value"?: string;
     }
     interface UiMenu {
@@ -1024,9 +1220,6 @@ declare namespace LocalJSX {
     interface UiSearchShell {
     }
     interface UiSelect {
-        /**
-          * @default ''
-         */
         "defaultValue"?: string;
         /**
           * @default false
@@ -1040,9 +1233,6 @@ declare namespace LocalJSX {
           * @default false
          */
         "required"?: boolean;
-        /**
-          * @default ''
-         */
         "value"?: string;
     }
     interface UiSwitch {
@@ -1102,9 +1292,6 @@ declare namespace LocalJSX {
           * @default 4
          */
         "rows"?: number;
-        /**
-          * @default ''
-         */
         "value"?: string;
     }
     interface UiToastRegion {
@@ -1127,6 +1314,8 @@ declare namespace LocalJSX {
           * @default 100
          */
         "hideDelay"?: number;
+        "onClose"?: (event: UiTooltipCustomEvent<{ open: boolean; reason: string; trigger: string }>) => void;
+        "onOpen"?: (event: UiTooltipCustomEvent<{ open: boolean; reason: string; trigger: string }>) => void;
         /**
           * @default false
          */
@@ -1140,6 +1329,11 @@ declare namespace LocalJSX {
           * @default 500
          */
         "showDelay"?: number;
+        /**
+          * Click or tap pins the description; activate again to dismiss.
+          * @default false
+         */
+        "toggleOnClick"?: boolean;
     }
     interface UiTopBar {
     }
@@ -1152,6 +1346,11 @@ declare namespace LocalJSX {
           * @default 'Tree'
          */
         "label"?: string;
+        /**
+          * Maximum resulting item depth accepted by pointer reordering. Zero is unlimited.
+          * @default 0
+         */
+        "maxDepth"?: number;
     }
     interface UiTreeItem {
         /**
@@ -1183,6 +1382,10 @@ declare namespace LocalJSX {
           * @default 'item'
          */
         "dragType"?: string;
+        /**
+          * Application hierarchy depth used for drop constraints. Defaults to visual depth.
+         */
+        "dropDepth"?: number;
         /**
           * Application-defined parent/list identity included with reorder events.
           * @default ''
@@ -1212,6 +1415,10 @@ declare namespace LocalJSX {
           * @default false
          */
         "sortable"?: boolean;
+        /**
+          * Deepest descendant distance, used with the tree's max-depth drop constraint.
+         */
+        "subtreeDepth"?: number;
     }
 
     interface UiAffordanceScopeAttributes {
@@ -1244,6 +1451,22 @@ declare namespace LocalJSX {
         "required": boolean;
         "value": string;
     }
+    interface UiComboboxAttributes {
+        "label": string;
+        "placeholder": string;
+        "name": string;
+        "value": string | null;
+        "defaultValue": string;
+        "query": string;
+        "defaultQuery": string;
+        "disabled": boolean;
+        "readOnly": boolean;
+        "required": boolean;
+        "size": 'sm' | 'md';
+        "disclosure": boolean;
+        "clearable": boolean;
+        "help": string;
+    }
     interface UiContextMenuAttributes {
         "open": boolean;
         "defaultOpen": boolean;
@@ -1357,15 +1580,19 @@ declare namespace LocalJSX {
         "placement": AnchoredPlacement;
         "showDelay": number;
         "hideDelay": number;
+        "toggleOnClick": boolean;
     }
     interface UiTreeAttributes {
         "label": string;
         "hoverExpandDelay": number;
+        "maxDepth": number;
     }
     interface UiTreeItemAttributes {
         "itemId": string;
         "label": string;
         "depth": number;
+        "dropDepth": number;
+        "subtreeDepth": number;
         "container": boolean;
         "sortable": boolean;
         "dragType": string;
@@ -1384,6 +1611,7 @@ declare namespace LocalJSX {
         "ui-badge": Omit<UiBadge, keyof UiBadgeAttributes> & { [K in keyof UiBadge & keyof UiBadgeAttributes]?: UiBadge[K] } & { [K in keyof UiBadge & keyof UiBadgeAttributes as `attr:${K}`]?: UiBadgeAttributes[K] } & { [K in keyof UiBadge & keyof UiBadgeAttributes as `prop:${K}`]?: UiBadge[K] };
         "ui-button": Omit<UiButton, keyof UiButtonAttributes> & { [K in keyof UiButton & keyof UiButtonAttributes]?: UiButton[K] } & { [K in keyof UiButton & keyof UiButtonAttributes as `attr:${K}`]?: UiButtonAttributes[K] } & { [K in keyof UiButton & keyof UiButtonAttributes as `prop:${K}`]?: UiButton[K] };
         "ui-checkbox": Omit<UiCheckbox, keyof UiCheckboxAttributes> & { [K in keyof UiCheckbox & keyof UiCheckboxAttributes]?: UiCheckbox[K] } & { [K in keyof UiCheckbox & keyof UiCheckboxAttributes as `attr:${K}`]?: UiCheckboxAttributes[K] } & { [K in keyof UiCheckbox & keyof UiCheckboxAttributes as `prop:${K}`]?: UiCheckbox[K] };
+        "ui-combobox": Omit<UiCombobox, keyof UiComboboxAttributes> & { [K in keyof UiCombobox & keyof UiComboboxAttributes]?: UiCombobox[K] } & { [K in keyof UiCombobox & keyof UiComboboxAttributes as `attr:${K}`]?: UiComboboxAttributes[K] } & { [K in keyof UiCombobox & keyof UiComboboxAttributes as `prop:${K}`]?: UiCombobox[K] };
         "ui-context-menu": Omit<UiContextMenu, keyof UiContextMenuAttributes> & { [K in keyof UiContextMenu & keyof UiContextMenuAttributes]?: UiContextMenu[K] } & { [K in keyof UiContextMenu & keyof UiContextMenuAttributes as `attr:${K}`]?: UiContextMenuAttributes[K] } & { [K in keyof UiContextMenu & keyof UiContextMenuAttributes as `prop:${K}`]?: UiContextMenu[K] };
         "ui-dialog": Omit<UiDialog, keyof UiDialogAttributes> & { [K in keyof UiDialog & keyof UiDialogAttributes]?: UiDialog[K] } & { [K in keyof UiDialog & keyof UiDialogAttributes as `attr:${K}`]?: UiDialogAttributes[K] } & { [K in keyof UiDialog & keyof UiDialogAttributes as `prop:${K}`]?: UiDialog[K] };
         "ui-disclosure": Omit<UiDisclosure, keyof UiDisclosureAttributes> & { [K in keyof UiDisclosure & keyof UiDisclosureAttributes]?: UiDisclosure[K] } & { [K in keyof UiDisclosure & keyof UiDisclosureAttributes as `attr:${K}`]?: UiDisclosureAttributes[K] } & { [K in keyof UiDisclosure & keyof UiDisclosureAttributes as `prop:${K}`]?: UiDisclosure[K] };
@@ -1419,6 +1647,10 @@ declare module "@stencil/core" {
             "ui-badge": LocalJSX.IntrinsicElements["ui-badge"] & JSXBase.HTMLAttributes<HTMLUiBadgeElement>;
             "ui-button": LocalJSX.IntrinsicElements["ui-button"] & JSXBase.HTMLAttributes<HTMLUiButtonElement>;
             "ui-checkbox": LocalJSX.IntrinsicElements["ui-checkbox"] & JSXBase.HTMLAttributes<HTMLUiCheckboxElement>;
+            /**
+             * A single editable field with contextual suggestions, optional help and field validation.
+             */
+            "ui-combobox": LocalJSX.IntrinsicElements["ui-combobox"] & JSXBase.HTMLAttributes<HTMLUiComboboxElement>;
             "ui-context-menu": LocalJSX.IntrinsicElements["ui-context-menu"] & JSXBase.HTMLAttributes<HTMLUiContextMenuElement>;
             "ui-dialog": LocalJSX.IntrinsicElements["ui-dialog"] & JSXBase.HTMLAttributes<HTMLUiDialogElement>;
             "ui-disclosure": LocalJSX.IntrinsicElements["ui-disclosure"] & JSXBase.HTMLAttributes<HTMLUiDisclosureElement>;

package/dist/types/field/combobox.d.ts

@@ -0,0 +1,46 @@
+import type { FieldFormatter, FieldIssue, FieldValidation } from './validation';
+export interface ComboboxOption<Metadata = unknown> {
+    id: string;
+    value: string;
+    label: string;
+    description?: string;
+    metadata?: Metadata;
+    group?: string;
+    disabled?: boolean;
+}
+export interface ComboboxRequest<Context = unknown> {
+    query: string;
+    context: Context;
+    signal: AbortSignal;
+    reason: 'input' | 'disclosure' | 'context';
+}
+export type ComboboxProvider = (request: ComboboxRequest) => readonly ComboboxOption[] | Promise<readonly ComboboxOption[]>;
+/** Map domain records at the boundary, preserving typed metadata for rich rows. */
+export declare function mapComboboxOptions<T>(rows: readonly T[], map: (row: T) => Omit<ComboboxOption<T>, 'metadata'>): ComboboxOption<T>[];
+export interface ComboboxConfig extends FieldValidation {
+    options?: readonly ComboboxOption[];
+    provider?: ComboboxProvider;
+    filter?: (option: ComboboxOption, query: string, context: unknown) => boolean;
+    context?: unknown;
+    invalidation?: 'clear' | 'retain-query' | 'retain';
+    debounce?: number;
+    allowFreeText?: boolean;
+    allowCreate?: boolean;
+    format?: FieldFormatter;
+    formatOn?: 'input' | 'blur';
+    validateOn?: 'input' | 'blur' | 'submit';
+}
+export interface ComboboxChange {
+    value: string | null;
+    query: string;
+    option: ComboboxOption | null;
+    kind: 'selection' | 'clear' | 'free-entry' | 'create' | 'invalidation';
+    trigger: 'keyboard' | 'pointer' | 'programmatic';
+}
+export interface ComboboxValidationState {
+    status: 'pristine' | 'pending' | 'valid' | 'warning' | 'error';
+    touched: boolean;
+    dirty: boolean;
+    issues: readonly FieldIssue[];
+    output?: unknown;
+}

package/dist/types/field/valibot.d.ts

@@ -0,0 +1,7 @@
+import type { GenericSchema, GenericSchemaAsync, InferOutput } from 'valibot';
+import type { FieldSchema, FieldValidation } from './validation';
+/** Valibot's Standard Schema implementation preserves async transforms and issue paths.
+ * Type-only Valibot imports keep the adapter free of a schema-library runtime. */
+export declare function valibotField<T extends GenericSchema | GenericSchemaAsync>(schema: T, options?: Omit<FieldValidation, 'schema'>): FieldValidation & {
+    schema: FieldSchema<InferOutput<T>>;
+};

package/dist/types/field/validation.d.ts

@@ -0,0 +1,56 @@
+/** Structural Standard Schema v1 boundary; no schema-library runtime dependency. */
+export interface FieldSchema<Output = unknown> {
+    readonly '~standard': {
+        readonly version: 1;
+        readonly vendor: string;
+        readonly validate: (value: unknown) => FieldSchemaResult<Output> | Promise<FieldSchemaResult<Output>>;
+        readonly types?: {
+            readonly input: unknown;
+            readonly output: Output;
+        };
+    };
+}
+export interface FieldIssue {
+    readonly message: string;
+    readonly path?: ReadonlyArray<PropertyKey | {
+        readonly key: PropertyKey;
+    }>;
+    readonly severity?: 'error' | 'warning';
+}
+export type FieldSchemaResult<T = unknown> = {
+    readonly value: T;
+    readonly issues?: undefined;
+} | {
+    readonly issues: readonly FieldIssue[];
+};
+export interface FieldRequest<Context = unknown> {
+    raw: string;
+    value: string | null;
+    context: Context;
+    signal: AbortSignal;
+}
+export interface FieldResult<Output = unknown> {
+    output?: Output;
+    issues: readonly FieldIssue[];
+}
+export interface FieldValidation {
+    schema?: FieldSchema;
+    parse?: (raw: string, request: FieldRequest) => unknown | Promise<unknown>;
+    normalize?: (value: unknown, request: FieldRequest) => unknown | Promise<unknown>;
+    validator?: (value: unknown, request: FieldRequest) => Partial<FieldResult> | Promise<Partial<FieldResult>>;
+    issues?: readonly FieldIssue[];
+}
+export interface FieldSelection {
+    start: number;
+    end: number;
+    direction?: 'forward' | 'backward' | 'none';
+}
+export interface FieldFormat {
+    display: string;
+    selection: FieldSelection;
+}
+export type FieldFormatter = (raw: string, selection: FieldSelection) => FieldFormat | undefined;
+/** Formatting is additive: every original character must survive in order.
+ * Normalization belongs to submitted output, never the visible editing buffer. */
+export declare function formatEditingValue(raw: string, selection: FieldSelection, format?: FieldFormatter): FieldFormat;
+export declare function validateField(request: FieldRequest, config: FieldValidation): Promise<FieldResult>;

package/dist/{ui-affordance-scope.entry-L533MECG.js → ui-affordance-scope.entry-VO4C2MZX.js}

@@ -7,7 +7,7 @@ import {
   getElement,
   h,
   registerInstance
-} from "./chunk-NIPNHZ5W.js";
+} from "./chunk-GDMQKT5F.js";
 
 // dist/esm/ui-affordance-scope.entry.js
 var uiAffordanceScopeCss = () => `:host{display:contents;--ui-affordance-scope-engaged:0}:host([data-ui-interaction='engaged']){--ui-affordance-scope-engaged:1}`;

package/dist/{ui-avatar-group.entry-BWS7E2CM.js → ui-avatar-group.entry-TAXJRIIU.js}

@@ -3,7 +3,7 @@ import {
   getElement,
   h,
   registerInstance
-} from "./chunk-NIPNHZ5W.js";
+} from "./chunk-GDMQKT5F.js";
 
 // dist/esm/ui-avatar-group.entry.js
 var uiAvatarGroupCss = () => `:host{display:flex;align-items:center;flex-direction:row-reverse;gap:0}::slotted(*:not([data-ui-avatar-group-overflow])){margin-inline-end:-0.5rem;flex-shrink:0}::slotted(*:last-of-type:not([data-ui-avatar-group-overflow])){margin-inline-end:0}.overflow{margin-inline-end:-0.5rem;display:inline-flex;align-items:center;justify-content:center;inline-size:2.5rem;block-size:2.5rem;border-radius:999px;border:1px solid var(--ui-border-default);background:var(--ui-surface-muted);color:var(--ui-text-secondary);font:inherit;font-size:0.75rem;font-weight:600;flex-shrink:0}`;

package/dist/{ui-avatar.entry-3INAY3XP.js → ui-avatar.entry-T6FU6ZYM.js}

@@ -2,7 +2,7 @@ import {
   Host,
   h,
   registerInstance
-} from "./chunk-NIPNHZ5W.js";
+} from "./chunk-GDMQKT5F.js";
 
 // dist/esm/ui-avatar.entry.js
 function toInitials(value) {