@agent-ui-kit/components 0.0.3

package/dist/controls/text-field/text-field.d.ts

@@ -0,0 +1,226 @@
+import { type ReactiveProps } from '../../dom/index.js';
+import { UIFormElement, type FormValue, type ValidityResult, type FieldLabelling } from '../../dom/form.js';
+declare const props: {
+    value: import("../../index.js").PropConfig<string>;
+    label: {
+        reflect: true;
+        type: import("../../index.js").PropType<string>;
+        default: string;
+        attribute?: string | false;
+    };
+    placeholder: import("../../index.js").PropConfig<string>;
+    size: {
+        reflect: true;
+        type: import("../../index.js").PropType<"sm" | "md" | "lg">;
+        default: "sm" | "md" | "lg";
+        attribute?: string | false;
+    };
+    type: {
+        reflect: true;
+        type: import("../../index.js").PropType<"number" | "text" | "url" | "date" | "email" | "tel" | "password" | "search" | "currency" | "unit" | "percent" | "time" | "color">;
+        default: "number" | "text" | "url" | "date" | "email" | "tel" | "password" | "search" | "currency" | "unit" | "percent" | "time" | "color";
+        attribute?: string | false;
+    };
+    readonly: {
+        reflect: true;
+        type: import("../../index.js").PropType<boolean>;
+        default: boolean;
+        attribute?: string | false;
+    };
+    currency: {
+        reflect: true;
+        type: import("../../index.js").PropType<string>;
+        default: string;
+        attribute?: string | false;
+    };
+    unit: {
+        reflect: true;
+        type: import("../../index.js").PropType<string>;
+        default: string;
+        attribute?: string | false;
+    };
+    step: {
+        reflect: true;
+        type: import("../../index.js").PropType<number | null>;
+        default: number | null;
+        attribute?: string | false;
+    };
+    min: {
+        reflect: true;
+        type: import("../../index.js").PropType<string>;
+        default: string;
+        attribute?: string | false;
+    };
+    max: {
+        reflect: true;
+        type: import("../../index.js").PropType<string>;
+        default: string;
+        attribute?: string | false;
+    };
+    format: {
+        reflect: true;
+        type: import("../../index.js").PropType<"hex" | "oklch">;
+        default: "hex" | "oklch";
+        attribute?: string | false;
+    };
+    name: {
+        reflect: true;
+        type: import("../../index.js").PropType<string>;
+        default: string;
+        attribute?: string | false;
+    };
+    disabled: {
+        reflect: true;
+        type: import("../../index.js").PropType<boolean>;
+        default: boolean;
+        attribute?: string | false;
+    };
+    required: {
+        reflect: true;
+        type: import("../../index.js").PropType<boolean>;
+        default: boolean;
+        attribute?: string | false;
+    };
+};
+export interface UITextFieldElement extends ReactiveProps<typeof props> {
+}
+export declare class UITextFieldElement extends UIFormElement {
+    #private;
+    static props: {
+        value: import("../../index.js").PropConfig<string>;
+        label: {
+            reflect: true;
+            type: import("../../index.js").PropType<string>;
+            default: string;
+            attribute?: string | false;
+        };
+        placeholder: import("../../index.js").PropConfig<string>;
+        size: {
+            reflect: true;
+            type: import("../../index.js").PropType<"sm" | "md" | "lg">;
+            default: "sm" | "md" | "lg";
+            attribute?: string | false;
+        };
+        type: {
+            reflect: true;
+            type: import("../../index.js").PropType<"number" | "text" | "url" | "date" | "email" | "tel" | "password" | "search" | "currency" | "unit" | "percent" | "time" | "color">;
+            default: "number" | "text" | "url" | "date" | "email" | "tel" | "password" | "search" | "currency" | "unit" | "percent" | "time" | "color";
+            attribute?: string | false;
+        };
+        readonly: {
+            reflect: true;
+            type: import("../../index.js").PropType<boolean>;
+            default: boolean;
+            attribute?: string | false;
+        };
+        currency: {
+            reflect: true;
+            type: import("../../index.js").PropType<string>;
+            default: string;
+            attribute?: string | false;
+        };
+        unit: {
+            reflect: true;
+            type: import("../../index.js").PropType<string>;
+            default: string;
+            attribute?: string | false;
+        };
+        step: {
+            reflect: true;
+            type: import("../../index.js").PropType<number | null>;
+            default: number | null;
+            attribute?: string | false;
+        };
+        min: {
+            reflect: true;
+            type: import("../../index.js").PropType<string>;
+            default: string;
+            attribute?: string | false;
+        };
+        max: {
+            reflect: true;
+            type: import("../../index.js").PropType<string>;
+            default: string;
+            attribute?: string | false;
+        };
+        format: {
+            reflect: true;
+            type: import("../../index.js").PropType<"hex" | "oklch">;
+            default: "hex" | "oklch";
+            attribute?: string | false;
+        };
+        name: {
+            reflect: true;
+            type: import("../../index.js").PropType<string>;
+            default: string;
+            attribute?: string | false;
+        };
+        disabled: {
+            reflect: true;
+            type: import("../../index.js").PropType<boolean>;
+            default: boolean;
+            attribute?: string | false;
+        };
+        required: {
+            reflect: true;
+            type: import("../../index.js").PropType<boolean>;
+            default: boolean;
+            attribute?: string | false;
+        };
+    };
+    protected connected(): void;
+    protected disconnected(): void;
+    /** Forward host focus to the editor PART (label-association + native `.focus()` parity). */
+    focus(options?: FocusOptions): void;
+    /**
+     * The value contributed to the owning form (FACE — the base publishes it via internals.setFormValue).
+     * When a value codec is active (number/currency/unit/percent types), the CANONICAL parsed value is the
+     * form value, not `this.value` which holds the formatted display string after blur. For all other types,
+     * `this.value` IS the form value (the editor textContent is the submission value).
+     */
+    protected formValue(): FormValue;
+    /**
+     * The validity verdict: `required && value === ''` → `valueMissing`; codec parse error → `customError`
+     * (numeric) or `typeMismatch` (date/time — ADR-0048); range check (min/max) → `rangeUnderflow`/
+     * `rangeOverflow` (numeric types only); email/url format error → `typeMismatch`; valid otherwise.
+     * A disabled field is barred from constraint validation (native parity).
+     * `stepMismatch` is NOT enforced — too strict for free numeric entry (ADR-0047).
+     */
+    protected formValidity(): ValidityResult;
+    /**
+     * Form reset → value ← the initial `value` attribute (native-parity defaultValue) + clear the touched state.
+     * A reset must not leave a required-empty field showing `:state(user-invalid)` until the user re-interacts, so
+     * the timing controller is reset to its first-paint suppression (the danger treatment re-arms on the next
+     * blur/change). The optional chain is defensive — `formReset` only fires while connected (the controller is live).
+     */
+    protected formReset(): void;
+    /** Restore the value after navigation/autofill (FACE state restore). */
+    protected formStateRestore(state: File | string | FormData | null): void;
+    /**
+     * The part-role override (ADR-0051 cl.2/LLD-C2 §wire) — the editor's `role=textbox` rides a light-DOM
+     * PART, not `internals.role`, so the base's guarded internals-reflection default (dom/form.ts) never
+     * fires for this control; id-reference the editor directly instead.
+     *
+     * `aria-labelledby` is this method's OWN, exclusive concern in both directions (no other effect ever
+     * touches it): set from `refs.label` when present, removed when `null`.
+     *
+     * `aria-describedby` is only WRITTEN here on association (`refs !== null`) — on dissociation it is
+     * deliberately left untouched, NOT unconditionally cleared. Why: the user-invalid/message effect above
+     * is the exclusive, correct owner of `aria-describedby` whenever `this.fieldLabelling === null` (it
+     * fully recomputes the bare-mode value — set to the message id when invalid, removed otherwise) — and
+     * BOTH effects re-run in the SAME flush wave on a `setFieldLabelling` write. Two effects racing to write
+     * one attribute makes the OUTCOME depend on which one the kernel happens to run last (subscriber-order,
+     * an incidental scheduling detail, not a documented invariant) — clearing it here too would sometimes
+     * win that race and erase what the message effect just (correctly) set. Touching only what is
+     * EXCLUSIVELY this method's own — never the other effect's — makes the result order-independent.
+     *
+     * Guards a not-yet-created editor (the LLD-C2 override contract) — cannot happen in practice
+     * (`#ensureParts()` runs synchronously at the top of `connected()`, before the base's forwarding effect
+     * installs), but the guard costs nothing and documents the contract.
+     */
+    protected applyFieldLabelling(refs: FieldLabelling | null): void;
+    /** Feeds `FormConnectDetail.userInvalid` (ADR-0050) — the existing `trackUserInvalid` tracker IS the one
+     *  timing source; this override just exposes its gate. */
+    protected formUserInvalid(): boolean;
+}
+export {};