@aceshooting/lyra-ui 1.2.0 → 2.1.0

package/dist/components/date-picker/date-input.d.ts

@@ -16,52 +16,143 @@ declare const LyraDateInput_base: typeof LyraElement & (new (...args: any[]) =>
  * @event change - Fired on committed date transitions.
  * @event lyra-show / lyra-hide - Calendar popover lifecycle.
  * @event lyra-clear - The clear button was used.
- * @csspart form-control, form-control-label, input-wrapper, input, clear-button, expand-button, expand-icon, popup, date-picker, hint, error
+ * @csspart form-control - The outer form-control wrapper.
+ * @csspart form-control-label - The label wrapper.
+ * @csspart input-wrapper - The input and button wrapper.
+ * @csspart input - The text input.
+ * @csspart clear-button - The clear control.
+ * @csspart expand-button - The calendar popup toggle.
+ * @csspart expand-icon - The calendar icon.
+ * @csspart popup - The positioned calendar popup.
+ * @csspart date-picker - The nested date picker.
+ * @csspart hint - The hint message.
+ * @csspart error - The validation message.
  * @slot label - Custom label content.
  * @slot error - Custom error content.
  * @slot hint - Custom hint content.
  */
 export declare class LyraDateInput extends LyraDateInput_base {
     static styles: import("lit").CSSResultGroup[];
-    mode: 'single' | 'range';
-    min: string;
-    max: string;
-    readonly: boolean;
+    static properties: {
+        mode: {
+            noAccessor: boolean;
+        };
+        min: {
+            noAccessor: boolean;
+        };
+        max: {
+            noAccessor: boolean;
+        };
+        readonly: {
+            type: BooleanConstructor;
+            reflect: boolean;
+            noAccessor: boolean;
+        };
+        disablePast: {
+            type: BooleanConstructor;
+            attribute: string;
+            noAccessor: boolean;
+        };
+        disableFuture: {
+            type: BooleanConstructor;
+            attribute: string;
+            noAccessor: boolean;
+        };
+    };
     open: boolean;
     withClear: boolean;
     label: string;
     hint: string;
     errorText: string;
     placeholder: string;
+    private accessibleLabel;
     locale: string;
     months: 1 | 2;
     firstDayOfWeek: string;
     weekdayFormat: WeekdayFormat;
-    disablePast: boolean;
-    disableFuture: boolean;
     withOutsideDays: boolean;
+    /** Accessible label for the clear button. Override for a non-English `locale`. */
+    clearLabel: string;
+    /** Accessible label for the calendar-toggle button. Override for a non-English `locale`. */
+    openLabel: string;
+    /** Accessible name for the calendar popover dialog. Override for a non-English `locale`. */
+    dialogLabel: string;
     private cleanupFn?;
+    private popupTrigger?;
+    private restorePopupFocusOnClose;
     private inputId;
     private popupId;
     private touched;
+    constructor();
     private hasHintSlot;
     private hasErrorSlot;
     private hasLabelSlot;
+    private _mode;
+    private _min;
+    private _max;
+    private _readonly;
+    private _disablePast;
+    private _disableFuture;
+    private typedBadInput;
+    get mode(): 'single' | 'range';
+    set mode(next: 'single' | 'range');
+    get min(): string;
+    set min(next: string);
+    get max(): string;
+    set max(next: string);
+    get readonly(): boolean;
+    set readonly(next: boolean);
+    get disablePast(): boolean;
+    set disablePast(next: boolean);
+    get disableFuture(): boolean;
+    set disableFuture(next: boolean);
+    get value(): string;
+    set value(next: string);
+    private setTypedBadInput;
+    private parseStrictISO;
+    private normalizeCommittedValue;
+    private valueDates;
+    protected updateValidity(): void;
     private get displayText();
-    protected willUpdate(): void;
+    protected willUpdate(changed: PropertyValues): void;
     /** Open the calendar popover. */
     show(): void;
     /** Close the calendar popover. */
-    hide(): void;
+    hide(restoreFocus?: boolean): void;
     private onDocPointer;
     /** Clear the value. */
     clear(): void;
     disconnectedCallback(): void;
     protected updated(changed: PropertyValues): void;
     private onInputChange;
+    /** Parses one date, ISO-first (so a calendar-invalid ISO string like
+     *  "2026-02-30" is rejected rather than silently rolled over by Date.parse()).
+     *  A 3-part, ambiguous slash/dot/dash-separated date (e.g. "15/07/2026") is
+     *  parsed according to the locale's own day/month/year order (via a real
+     *  Intl.DateTimeFormat sample, see localeDateOrder()) rather than
+     *  Date.parse()'s implementation-defined heuristics -- this is what prevents
+     *  e.g. an en-GB "15/07/2026" from being silently misread as some other day.
+     *  A 4-digit first group (e.g. "2026-7-15") is never locale-guessed, though:
+     *  it's unambiguously a year regardless of locale/separator (ISO's own
+     *  year-first convention, just without zero-padding), so it's routed
+     *  straight through parseISO() instead -- this is what lets a non-padded
+     *  ISO-ish date keep parsing correctly (it did via Date.parse() before the
+     *  ambiguous-date regex below existed at all).
+     *  Anything else (e.g. "July 15, 2026") still falls through to Date.parse(). */
+    private parseOneDate;
+    private parseSingleText;
+    /** Only round-trips the exact `displayText` shape this component itself
+     *  renders (`"<locale from> – <locale to>"`) — a raw ISO range typed
+     *  directly (`"2026-05-01/2026-05-15"`) is also accepted as a convenience.
+     *  A reversed typed range (`to` before `from`) is normalized into
+     *  from-before-to order, matching what the date-picker's own UI-driven
+     *  `commit()` already does for a UI-picked range. */
+    private parseRangeText;
     private onInputKey;
     private onFormControlKey;
     private onInputBlur;
+    formStateRestoreCallback(state: string | File | FormData | null, _mode?: 'restore' | 'autocomplete'): void;
+    formResetCallback(): void;
     private onHintSlotChange;
     private onErrorSlotChange;
     private onLabelSlotChange;