@agent-ui-kit/components 0.0.3

package/dist/controls/calendar/calendar.d.ts

@@ -0,0 +1,161 @@
+import { UIFormElement } from '../../dom/index.js';
+import type { ReactiveProps } from '../../dom/index.js';
+import type { FormValue, ValidityResult, FieldLabelling } from '../../dom/index.js';
+declare const props: {
+    mode: {
+        reflect: true;
+        type: import("../../index.js").PropType<"single" | "range">;
+        default: "single" | "range";
+        attribute?: string | false;
+    };
+    value: {
+        reflect: true;
+        type: import("../../index.js").PropType<string>;
+        default: string;
+        attribute?: string | false;
+    };
+    valueStart: {
+        reflect: true;
+        attribute: string;
+        type: import("../../index.js").PropType<string>;
+        default: string;
+    };
+    valueEnd: {
+        reflect: true;
+        attribute: string;
+        type: import("../../index.js").PropType<string>;
+        default: string;
+    };
+    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;
+    };
+    size: {
+        reflect: true;
+        type: import("../../index.js").PropType<"sm" | "md" | "lg">;
+        default: "sm" | "md" | "lg";
+        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 UICalendarElement extends ReactiveProps<typeof props> {
+}
+export declare class UICalendarElement extends UIFormElement {
+    #private;
+    static props: {
+        mode: {
+            reflect: true;
+            type: import("../../index.js").PropType<"single" | "range">;
+            default: "single" | "range";
+            attribute?: string | false;
+        };
+        value: {
+            reflect: true;
+            type: import("../../index.js").PropType<string>;
+            default: string;
+            attribute?: string | false;
+        };
+        valueStart: {
+            reflect: true;
+            attribute: string;
+            type: import("../../index.js").PropType<string>;
+            default: string;
+        };
+        valueEnd: {
+            reflect: true;
+            attribute: string;
+            type: import("../../index.js").PropType<string>;
+            default: string;
+        };
+        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;
+        };
+        size: {
+            reflect: true;
+            type: import("../../index.js").PropType<"sm" | "md" | "lg">;
+            default: "sm" | "md" | "lg";
+            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 formValue(): FormValue;
+    protected formValidity(): ValidityResult;
+    protected formReset(): void;
+    protected formStateRestore(state: File | string | FormData | null): void;
+    protected connected(): void;
+    protected disconnected(): void;
+    /** Feeds `FormConnectDetail.userInvalid` (ADR-0050) — the `trackUserInvalid` tracker IS the one
+     *  timing source; this override just exposes its gate (the text-field/select precedent). */
+    protected formUserInvalid(): boolean;
+    /**
+     * The part-role override (ADR-0051 cl.2/cl.Consequences "calendar is a follow-up too") — the
+     * grid's `role='grid'` rides a light-DOM PART attribute, not `internals.role`, so the base's
+     * guarded internals-reflection default (dom/form.ts) never fires for this control. UNLIKE
+     * text-field/select, the grid ALREADY self-labels to its own month title
+     * (`aria-labelledby=titleId`, set once at `#ensureShell()`) — this override must MERGE the
+     * field's label ref into that existing relationship, never clobber it (the calendar always
+     * needs its own month/year context alongside whatever name the field supplies).
+     *
+     * `aria-describedby` has no other owner (the grid carries no internal validity-message node,
+     * unlike text-field's editor) — written from `[refs.description, refs.error]` when fielded,
+     * cleared on dissociation, in both branches below (the combo-box precedent, which has the same
+     * no-competing-owner shape).
+     *
+     * Guards a not-yet-created grid/title (the LLD-C2 override contract) — cannot happen in practice
+     * (`#ensureShell()` 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;
+}
+export {};