@aceshooting/lyra-ui 2.0.0 → 2.2.0

package/dist/components/date-picker/calendar-core.d.ts

@@ -1,4 +1,18 @@
 export type WeekdayFormat = 'narrow' | 'short' | 'long';
+export type CalendarMode = 'single' | 'range';
+/** Normalize an untyped calendar count to the supported one- or two-month range. */
+export declare function normalizeCalendarMonths(value: unknown): 1 | 2;
+/** Normalize an untyped weekday format before passing it to `Intl.DateTimeFormat`. */
+export declare function normalizeWeekdayFormat(value: unknown): WeekdayFormat;
+/** Normalize an untyped picker mode to the single-date default. */
+export declare function normalizeCalendarMode(value: unknown): CalendarMode;
+/**
+ * Construct a date formatter while treating a malformed runtime locale as
+ * the platform default. Attribute values and JavaScript property writes are
+ * not constrained by TypeScript's declarations, so they must not be allowed
+ * to turn a calendar render into a `RangeError`.
+ */
+export declare function dateTimeFormat(locale: unknown, options: Intl.DateTimeFormatOptions): Intl.DateTimeFormat;
 /** Parse `YYYY-MM-DD` into a local Date, or null if invalid. */
 export declare function parseISO(s: string): Date | null;
 /** Format a Date as local `YYYY-MM-DD`. */
@@ -6,6 +20,16 @@ export declare function formatISO(d: Date): string;
 export declare function isSameDay(a: Date, b: Date): boolean;
 /** First day of the month `n` months from `d`. */
 export declare function addMonths(d: Date, n: number): Date;
+/**
+ * `d` shifted by `n` months, keeping the same day-of-month unless the target
+ * month is shorter, in which case the day is clamped to that month's last
+ * day. Plain `new Date(year, month + n, d.getDate())` construction instead
+ * overflows a too-large day-of-month into the *following* month (e.g. Jan 31
+ * + 1 month rolls into March, skipping February entirely) because the Date
+ * constructor normalizes out-of-range day components rather than clamping
+ * them.
+ */
+export declare function addMonthsClampingDay(d: Date, n: number): Date;
 export declare function clampDate(d: Date, min: Date | null, max: Date | null): Date;
 /**
  * A 6×7 grid of Dates covering the given month, week-aligned to `firstDayOfWeek`
@@ -22,3 +46,4 @@ export declare function monthTitle(year: number, month: number, locale?: string)
  * when the runtime supports it, falling back to Sunday otherwise.
  */
 export declare function resolveFirstDayOfWeek(value: string, locale?: string): number;
+//# sourceMappingURL=calendar-core.d.ts.map

package/dist/components/date-picker/calendar-core.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"calendar-core.d.ts","sourceRoot":"","sources":["../../../src/components/date-picker/calendar-core.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,aAAa,GAAG,QAAQ,GAAG,OAAO,GAAG,MAAM,CAAC;AACxD,MAAM,MAAM,YAAY,GAAG,QAAQ,GAAG,OAAO,CAAC;AAE9C,oFAAoF;AACpF,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,OAAO,GAAG,CAAC,GAAG,CAAC,CAI7D;AAED,sFAAsF;AACtF,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,OAAO,GAAG,aAAa,CAEpE;AAED,mEAAmE;AACnE,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,OAAO,GAAG,YAAY,CAElE;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAC5B,MAAM,EAAE,OAAO,EACf,OAAO,EAAE,IAAI,CAAC,qBAAqB,GAClC,IAAI,CAAC,cAAc,CAMrB;AAED,gEAAgE;AAChE,wBAAgB,QAAQ,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAe/C;AAED,2CAA2C;AAC3C,wBAAgB,SAAS,CAAC,CAAC,EAAE,IAAI,GAAG,MAAM,CAIzC;AAED,wBAAgB,SAAS,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,IAAI,GAAG,OAAO,CAInD;AAED,kDAAkD;AAClD,wBAAgB,SAAS,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI,CAElD;AAED;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI,CAI7D;AAED,wBAAgB,SAAS,CAAC,CAAC,EAAE,IAAI,EAAE,GAAG,EAAE,IAAI,GAAG,IAAI,EAAE,GAAG,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,CAI3E;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,cAAc,SAAI,GAAG,IAAI,EAAE,EAAE,CAcrF;AAED,sEAAsE;AACtE,wBAAgB,aAAa,CAAC,cAAc,SAAI,EAAE,MAAM,GAAE,aAAuB,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAa5G;AAED,oCAAoC;AACpC,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAI/E;AAiCD;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAM5E"}

package/dist/components/date-picker/calendar-core.js

@@ -1,3 +1,32 @@
+/** Normalize an untyped calendar count to the supported one- or two-month range. */
+export function normalizeCalendarMonths(value) {
+    const numeric = typeof value === 'number' ? value : Number(value);
+    if (!Number.isFinite(numeric))
+        return 1;
+    return Math.min(2, Math.max(1, Math.trunc(numeric)));
+}
+/** Normalize an untyped weekday format before passing it to `Intl.DateTimeFormat`. */
+export function normalizeWeekdayFormat(value) {
+    return value === 'narrow' || value === 'long' ? value : 'short';
+}
+/** Normalize an untyped picker mode to the single-date default. */
+export function normalizeCalendarMode(value) {
+    return value === 'range' ? 'range' : 'single';
+}
+/**
+ * Construct a date formatter while treating a malformed runtime locale as
+ * the platform default. Attribute values and JavaScript property writes are
+ * not constrained by TypeScript's declarations, so they must not be allowed
+ * to turn a calendar render into a `RangeError`.
+ */
+export function dateTimeFormat(locale, options) {
+    try {
+        return new Intl.DateTimeFormat(typeof locale === 'string' && locale ? locale : undefined, options);
+    }
+    catch {
+        return new Intl.DateTimeFormat(undefined, options);
+    }
+}
 /** Parse `YYYY-MM-DD` into a local Date, or null if invalid. */
 export function parseISO(s) {
     if (!s)
@@ -32,6 +61,20 @@ export function isSameDay(a, b) {
 export function addMonths(d, n) {
     return new Date(d.getFullYear(), d.getMonth() + n, 1);
 }
+/**
+ * `d` shifted by `n` months, keeping the same day-of-month unless the target
+ * month is shorter, in which case the day is clamped to that month's last
+ * day. Plain `new Date(year, month + n, d.getDate())` construction instead
+ * overflows a too-large day-of-month into the *following* month (e.g. Jan 31
+ * + 1 month rolls into March, skipping February entirely) because the Date
+ * constructor normalizes out-of-range day components rather than clamping
+ * them.
+ */
+export function addMonthsClampingDay(d, n) {
+    const targetMonth = d.getMonth() + n;
+    const lastDayOfTargetMonth = new Date(d.getFullYear(), targetMonth + 1, 0).getDate();
+    return new Date(d.getFullYear(), targetMonth, Math.min(d.getDate(), lastDayOfTargetMonth));
+}
 export function clampDate(d, min, max) {
     if (min && d < min)
         return min;
@@ -60,18 +103,22 @@ export function monthMatrix(year, month, firstDayOfWeek = 0) {
 }
 /** Localized weekday header labels, ordered from `firstDayOfWeek`. */
 export function weekdayLabels(firstDayOfWeek = 0, format = 'short', locale) {
-    const fmt = new Intl.DateTimeFormat(locale || undefined, { weekday: format });
+    const numericFirstDay = Number(firstDayOfWeek);
+    const start = Number.isFinite(numericFirstDay)
+        ? ((Math.trunc(numericFirstDay) % 7) + 7) % 7
+        : 0;
+    const fmt = dateTimeFormat(locale, { weekday: normalizeWeekdayFormat(format) });
     const labels = [];
     // 2021-08-01 is a Sunday, so index i maps cleanly to a weekday.
     for (let i = 0; i < 7; i++) {
-        const day = (firstDayOfWeek + i) % 7;
+        const day = (start + i) % 7;
         labels.push(fmt.format(new Date(2021, 7, 1 + day)));
     }
     return labels;
 }
 /** Localized "Month YYYY" title. */
 export function monthTitle(year, month, locale) {
-    return new Intl.DateTimeFormat(locale || undefined, { month: 'long', year: 'numeric' }).format(new Date(year, month, 1));
+    return dateTimeFormat(locale, { month: 'long', year: 'numeric' }).format(new Date(year, month, 1));
 }
 const FDOW = { sun: 0, mon: 1, tue: 2, wed: 3, thu: 4, fri: 5, sat: 6 };
 /** Locale-derived first day of week (0=Sunday … 6=Saturday), or null if unsupported. */
@@ -97,5 +144,6 @@ export function resolveFirstDayOfWeek(value, locale) {
         const derived = locale ? localeFirstDayOfWeek(locale) : null;
         return derived ?? 0;
     }
-    return FDOW[value.toLowerCase()] ?? 0;
+    return typeof value === 'string' ? (FDOW[value.toLowerCase()] ?? 0) : 0;
 }
+//# sourceMappingURL=calendar-core.js.map

package/dist/components/date-picker/calendar-core.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"calendar-core.js","sourceRoot":"","sources":["../../../src/components/date-picker/calendar-core.ts"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,185 @@
+import { type TemplateResult, type PropertyValues } from 'lit';
+import { LyraElement } from '../../internal/lyra-element.js';
+import { type WeekdayFormat } from './calendar-core.js';
+import './date-picker.class.js';
+/**
+ * `<lyra-date-input>` — a date field with an attached calendar popover.
+ * Mirrors the core `<wa-date-input>` API under `lyra-`. Value is ISO 8601
+ * (`YYYY-MM-DD`, or `YYYY-MM-DD/YYYY-MM-DD` in range mode). Form-associated.
+ *
+ * This component uses a single text field; typing accepts ISO or a
+ * locale-parseable date.
+ *
+ * @customElement lyra-date-input
+ * @event input - Fired on edits.
+ * @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 - 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 interface LyraDateInputEventMap {
+    'lyra-show': CustomEvent<undefined>;
+    'lyra-hide': CustomEvent<undefined>;
+    'lyra-clear': CustomEvent<undefined>;
+    input: CustomEvent<undefined>;
+    change: CustomEvent<undefined>;
+}
+declare class LyraDateInputBase extends LyraElement<LyraDateInputEventMap> {
+}
+declare const LyraDateInput_base: typeof LyraDateInputBase & (new (...args: any[]) => import("../../lyra.js").FormAssociatedInterface);
+export declare class LyraDateInput extends LyraDateInput_base {
+    static styles: import("lit").CSSResultGroup[];
+    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;
+    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 validityRevision;
+    private _mode;
+    private _min;
+    private _max;
+    private _readonly;
+    private _disablePast;
+    private _disableFuture;
+    private typedBadInput;
+    /** Clock seam for temporal validity and deterministic day-boundary tests. */
+    private now;
+    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;
+    checkValidity(): boolean;
+    reportValidity(): boolean;
+    private onVisibilityChange;
+    private get displayText();
+    protected willUpdate(changed: PropertyValues): void;
+    /** Open the calendar popover. */
+    show(): void;
+    /** Close the calendar popover. */
+    hide(restoreFocus?: boolean): void;
+    private onDocPointer;
+    connectedCallback(): void;
+    /** 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;
+    private onPickerInput;
+    private onPickerChange;
+    render(): TemplateResult;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'lyra-date-input': LyraDateInput;
+    }
+}
+export {};
+//# sourceMappingURL=date-input.class.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"date-input.class.d.ts","sourceRoot":"","sources":["../../../src/components/date-picker/date-input.class.ts"],"names":[],"mappings":"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"}