@bluevolt-tech/lumen 2.0.1 → 2.2.0

package/dist/components/bv-date-range-picker/bv-date-range-picker.d.ts

@@ -6,7 +6,7 @@ export interface DateRangeChangeDetail {
     preset: string;
 }
 export declare class BvDateRangePicker extends HTMLElement {
-    static readonly observedAttributes: readonly ["start", "end", "preset"];
+    static readonly observedAttributes: readonly ["start", "end", "preset", "min", "max", "max-range-years", "validate-order", "validate-format", "show-range-limit-banner", "error-min", "error-max", "error-order", "error-format", "range-limit-message", "range-limit-heading", "error-min-severity", "error-max-severity", "error-format-severity", "error-order-severity", "range-limit-severity"];
     private _rendered;
     private _today;
     private _start;
@@ -16,6 +16,9 @@ export declare class BvDateRangePicker extends HTMLElement {
     private _hover;
     private _leftYear;
     private _leftMonth;
+    private _startRawInvalid;
+    private _endRawInvalid;
+    private _validity;
     private _leftGrid;
     private _rightGrid;
     private _leftTitle;
@@ -23,9 +26,22 @@ export declare class BvDateRangePicker extends HTMLElement {
     private _startInput;
     private _endInput;
     private _applyBtn;
-    private _bannerEl;
+    /**
+     * Unified alert banner (BTN-10312). Shows AT MOST ONE error at a time. When
+     * multiple errors are simultaneously active, the banner reflects the
+     * most-recently-edited field (see `_lastEditedField`).
+     */
+    private _alertBannerEl;
     private _leftDayMap;
     private _rightDayMap;
+    /**
+     * BTN-10312 — tracks which field the user most-recently interacted with.
+     * When both `startError` and `endError` are active, the banner shows the
+     * error corresponding to this field. Set to `null` when no field has been
+     * touched (initial render, or external attribute set); the resolver falls
+     * back to a stable precedence in that case.
+     */
+    private _lastEditedField;
     constructor();
     get start(): string;
     set start(v: string);
@@ -35,6 +51,16 @@ export declare class BvDateRangePicker extends HTMLElement {
     set preset(v: string);
     connectedCallback(): void;
     attributeChangedCallback(name: string, _old: string | null, val: string | null): void;
+    /**
+     * BTN-10312 — public reset of the picker's internal draft state to the
+     * currently committed `start` / `end` / `preset` attributes. Called by
+     * `bv-date-range-input` when the popup closes without Apply (Cancel,
+     * Escape, outside-click) so the next open shows the last-committed value
+     * cleanly, with no leftover error banners from the discarded edit.
+     *
+     * The external value is not modified — this only clears the draft.
+     */
+    resetDraft(): void;
     private _render;
     private _buildCalendarShell;
     private _navigate;
@@ -49,8 +75,49 @@ export declare class BvDateRangePicker extends HTMLElement {
     private _onInputBlur;
     private _syncInputs;
     private _syncPresets;
-    private _syncApply;
-    private _syncBanner;
+    private _syncValidity;
+    private _readConfig;
+    /**
+     * BTN-10312 — apply the `.invalid` + `aria-invalid` state to input fields
+     * whose field-level error is currently blocking (severity `'error'`).
+     * Non-blocking severities (warning/primary/success) do not paint the input
+     * red so the visual matches the semantic ("not a fatal error").
+     */
+    private _paintInputInvalidState;
+    private _paintOne;
+    /**
+     * BTN-10312 — single alert banner. Picks the "active" error following the
+     * precedence:
+     *
+     *   1. If a form error is active, show it (form errors don't coexist with
+     *      field errors by validator design).
+     *   2. If both field errors are active, show the one for
+     *      `_lastEditedField` (falling back to `start` if `null`).
+     *   3. Else show whichever single field error is active.
+     *   4. Else hide the banner.
+     *
+     * `show-range-limit-banner="false"` still suppresses the range-limit
+     * banner specifically (existing consumer contract from BTN-10191).
+     */
+    private _applyAlertBanner;
+    /**
+     * Pick which error the banner should reflect. See `_applyAlertBanner` for
+     * the precedence rules.
+     */
+    private _resolveActiveError;
+    private _resolveFieldError;
+    /**
+     * BTN-10312 — interpolate `{field}` (always lowercase) and `{Field}` (always
+     * capitalized) in a user-provided template. Before this change, the historical
+     * behavior was that `{field}` in custom copy resolved lowercase while the
+     * built-in defaults capitalized inline — inconsistent. Now the split is
+     * explicit: `{field}` = lowercase, `{Field}` = capitalized.
+     */
+    private _interpolateField;
+    private _resolveOrderError;
+    private _applyApplyState;
+    private _applyCalendarDisabledState;
+    private _resetDayDisabled;
     private _setupDateMask;
     private _apply;
 }