@aceshooting/lyra-ui 3.4.0 → 3.6.0

package/dist/components/known-date/known-date.class.d.ts

@@ -0,0 +1,208 @@
+import { type PropertyValues, type TemplateResult } from 'lit';
+import { LyraElement } from '../../internal/lyra-element.js';
+export type LyraKnownDateSize = 'xs' | 's' | 'm' | 'l' | 'xl';
+export type LyraKnownDateField = 'day' | 'month' | 'year';
+export interface LyraKnownDateEventDetail {
+    /** Canonical ISO 8601 date (`YYYY-MM-DD`), or `''` while incomplete/invalid. Mirrors `value`. */
+    value: string;
+    /** Per-field raw text as currently typed, always present even while incomplete. */
+    day: string;
+    month: string;
+    year: string;
+    /** Which field the user was last editing when this event fired. */
+    field: LyraKnownDateField;
+}
+export interface LyraKnownDateEventMap {
+    input: CustomEvent<LyraKnownDateEventDetail>;
+    change: CustomEvent<LyraKnownDateEventDetail>;
+    focus: CustomEvent<undefined>;
+    blur: CustomEvent<undefined>;
+}
+declare class LyraKnownDateBase extends LyraElement<LyraKnownDateEventMap> {
+}
+declare const LyraKnownDate_base: typeof LyraKnownDateBase & (new (...args: any[]) => import("../../lyra.js").FormAssociatedInterface);
+/**
+ * `<lyra-known-date>` — a date a user already knows (a birthdate, a passport
+ * issue/expiry date) collected as three plain, labeled day/month/year number
+ * fields in the locale's natural field order, rather than a calendar popup.
+ * Form-associated; the submitted form value is always canonical ISO 8601
+ * (`YYYY-MM-DD`), or `''` while any field is blank or the combination isn't a
+ * real calendar date. Mirrors Web Awesome's `wa-known-date` API surface under
+ * `lyra-`, with `appearance`/`pill`/`form` dropped and `size` normalized to
+ * this library's own `xs`–`xl` scale, matching every other lyra form control
+ * mirrored from a Web Awesome counterpart.
+ *
+ * A field's own `<input>` shows exactly what was typed (never reformatted or
+ * reverted) -- only the composite `value` is zero-padded. Auto-advance
+ * (typing a field's last digit moves focus to the next field) and
+ * backspace-to-previous-field-when-empty are this library's own additions on
+ * top of Web Awesome's bare typing model, which documents no auto-advance;
+ * don't remove them to "restore" WA parity. Arrow-key field-to-field
+ * navigation at a field's text boundary is RTL-aware: the *physical* key that
+ * means "toward the next field" flips under an inherited `dir="rtl"`, while
+ * the field order itself (locale-derived) does not. Non-digit keystrokes are
+ * rejected before they reach a field's state -- no locale-specific numeral
+ * input (e.g. Arabic-Indic digits) is supported.
+ *
+ * No resizable text-editing surface exists (three fixed-width digit fields),
+ * so resize forwarding doesn't apply, and `spellcheck`/`autocapitalize`/
+ * `autocorrect`/`wrap` don't meaningfully apply to 2–4-digit numeric fields
+ * either -- the same carve-out `lyra-input[type="number"]` already documents.
+ *
+ * @customElement lyra-known-date
+ * @event input - Fires on every keystroke in any field. `detail.value` is the canonical ISO date
+ *   only once all three fields resolve to a real calendar date, otherwise `''`; `detail.day`/
+ *   `month`/`year` always carry the live raw typed text.
+ * @event change - Fires when a field loses focus (including a Tab/auto-advance move away from it)
+ *   and the composite value has newly transitioned to a different complete date, or from complete
+ *   back to incomplete/blank. Programmatic `value`/`valueAsDate` assignment stays silent.
+ * @event focus - Re-dispatched, bubbling and composed, when any of the three internal fields
+ *   receives focus (native `focus` doesn't bubble or cross a shadow boundary).
+ * @event blur - Re-dispatched, bubbling and composed, once when focus leaves all three internal
+ *   fields for something outside the control -- not once per internal field-to-field Tab.
+ * @slot label - Custom label/legend content, alongside the `label` attribute.
+ * @slot hint - Custom hint content, alongside the `hint` attribute.
+ * @slot error - Custom error content, alongside the `errorText` attribute.
+ * @csspart form-control - The outer wrapper around legend, fieldset, hint, and error.
+ * @csspart fieldset - The `<fieldset>` grouping the three fields.
+ * @csspart legend - The `<legend>` element.
+ * @csspart fields - The row wrapping the three field blocks.
+ * @csspart field - Each field block (label + input), repeated three times; distinguished by
+ *   `data-field="day"|"month"|"year"`.
+ * @csspart field-input - The native per-field `<input type="text" inputmode="numeric">`, repeated
+ *   three times; distinguished by `data-field="day"|"month"|"year"`.
+ * @csspart field-label - The small visible per-field text label ("Day"/"Month"/"Year").
+ * @csspart hint - The hint message.
+ * @csspart error - The validation message.
+ */
+export declare class LyraKnownDate extends LyraKnownDate_base {
+    static styles: import("lit").CSSResultGroup[];
+    static properties: {
+        min: {
+            noAccessor: boolean;
+        };
+        max: {
+            noAccessor: boolean;
+        };
+        readonly: {
+            type: BooleanConstructor;
+            reflect: boolean;
+            noAccessor: boolean;
+        };
+    };
+    size: LyraKnownDateSize;
+    label: string;
+    hint: string;
+    errorText: string;
+    /** BCP-47 override for field order and field-label localization sampling. Empty string falls
+     *  back to `this.effectiveLocale` (inherited `lang`/ancestor), exactly like `lyra-date-input`'s
+     *  `locale`. Redeclared (non-reflecting) over `LyraElement`'s own reflecting `locale` for the
+     *  same reason `lyra-date-input` does. */
+    locale: string;
+    /** Forwarded to the internal day field as-is when non-empty. The special value `'bday'`
+     *  expands into `'bday-day'`/`'bday-month'`/`'bday-year'` split across the three fields; any
+     *  other non-empty value is forwarded verbatim to all three fields unmodified. */
+    autocomplete: string;
+    /** Overrides the fieldset's computed accessible name (normally the `<legend>`'s content). Applied
+     *  as `aria-label` on the `part="fieldset"` element, which owns the role -- not just the host. */
+    accessibleLabel: string | null;
+    /** Visible + accessible per-field label for the day field. Routes through
+     *  `this.localize('knownDateDay', ...)`. */
+    dayLabel: string;
+    /** Visible + accessible per-field label for the month field. Routes through
+     *  `this.localize('knownDateMonth', ...)`. */
+    monthLabel: string;
+    /** Visible + accessible per-field label for the year field. Routes through
+     *  `this.localize('knownDateYear', ...)`. */
+    yearLabel: string;
+    private dayText;
+    private monthText;
+    private yearText;
+    private touched;
+    private hasLabelSlot;
+    private hasHintSlot;
+    private hasErrorSlot;
+    private _min;
+    private _max;
+    private _readonly;
+    /** The last value a `change` event was fired for (or the constructed initial value) -- lets
+     *  `commitChangeIfNeeded()` fire `change` only on a real transition, matching `lyra-date-input`'s
+     *  own "input fires more often than change" contract. */
+    private lastCommittedValue;
+    private lastEditedField;
+    private readonly hintId;
+    private readonly errorId;
+    private readonly dayId;
+    private readonly monthId;
+    private readonly yearId;
+    constructor();
+    get min(): string;
+    set min(next: string);
+    get max(): string;
+    set max(next: string);
+    get readonly(): boolean;
+    set readonly(next: boolean);
+    get value(): string;
+    /** Normalizes an assignment to the canonical ISO date or `''`, and repopulates the three raw
+     *  field texts to match -- a declarative `value="2007-3-27"` (non-padded) or a calendar-invalid
+     *  literal (`"2007-02-30"`) sanitizes to `''`, same strict-ISO gate as `lyra-date-input`'s
+     *  `parseStrictISO()`. Programmatic assignment stays silent (no `input`/`change`), matching every
+     *  `FormAssociated` sibling's documented contract. */
+    set value(next: string);
+    /** The composite value as a local-midnight `Date`, or `null` while incomplete/invalid. */
+    get valueAsDate(): Date | null;
+    set valueAsDate(next: Date | null);
+    private parseStrictISO;
+    private get fieldOrder();
+    private textFor;
+    private setFieldText;
+    private idFor;
+    private get effectiveDayLabel();
+    private get effectiveMonthLabel();
+    private get effectiveYearLabel();
+    private labelFor;
+    /** `'bday'` expands into per-field companion tokens; any other non-empty value forwards
+     *  verbatim to all three fields (see the `autocomplete` property doc comment). */
+    private autocompleteFor;
+    /** Computes the canonical zero-padded ISO date from the three raw typed field texts, or `''`
+     *  when any field is empty or the combination isn't a real calendar date. */
+    private computeCanonicalValue;
+    /** Recomputes the composite value from the three field texts and pushes it through the base
+     *  `FormAssociated` setter directly (bypassing this class's own `value` setter above, which
+     *  would otherwise re-derive and clobber the raw per-field text this method is reading from). */
+    private commitFromFields;
+    private get eventDetail();
+    private detailFor;
+    /** Fires `change` only on a real transition of the composite value -- called on every field
+     *  blur (whether that blur stays inside the control or leaves it), which also covers an
+     *  auto-advance move since focusing another field synchronously blurs the current one first. */
+    private commitChangeIfNeeded;
+    private fieldInputElement;
+    /** Moves focus to the field `delta` steps away from `field` in locale field order; a no-op past
+     *  either end (e.g. Backspace-empty on the first field, or auto-advance past the last field). */
+    private focusAdjacentField;
+    protected updateValidity(): void;
+    protected willUpdate(): void;
+    protected updated(changed: PropertyValues): void;
+    formResetCallback(): void;
+    private onLabelSlotChange;
+    private onHintSlotChange;
+    private onErrorSlotChange;
+    private onFieldInput;
+    private onFieldKeydown;
+    private onFieldFocus;
+    private onFieldBlur;
+    /** Focuses the first field in locale order. */
+    focus(options?: FocusOptions): void;
+    /** Blurs whichever internal field currently has focus, if any. */
+    blur(): void;
+    private renderField;
+    render(): TemplateResult;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'lyra-known-date': LyraKnownDate;
+    }
+}
+export {};
+//# sourceMappingURL=known-date.class.d.ts.map

package/dist/components/known-date/known-date.class.d.ts.map

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