/**
 * Copyright Aquera Inc 2026
 *
 * This source code is licensed under the BSD-3-Clause license found in the
 * LICENSE file in the root directory of this source tree.
 */
import { CSSResultArray, TemplateResult, PropertyValues } from 'lit';
import NileElement from '../internal/nile-element';
import type { NileFloatingPanel } from '../nile-floating-panel';
import '../nile-floating-panel';
import '../nile-calendar';
import '../nile-input';
type TimeUnits = 'minutes' | 'hours' | 'days' | 'weeks' | 'months';
/**
 * @tag nile-date-time-picker
 * @event nile-change - Absolute `{ value, localTimezoneValue, unixEpoch, timezone }` (`unixEpoch` = ms since 1970, null when empty); relative `{ startDate, endDate, timezone }`.
 * @event nile-clear
 */
export declare class NileDateTimePicker extends NileElement {
    static get styles(): CSSResultArray;
    showMonthDropdown: boolean;
    showYearDropdown: boolean;
    type: 'absolute' | 'relative';
    /** Show the Absolute / Relative type switcher. Hidden by default; set to reveal it. */
    showTypes: boolean;
    hideDurationFields: string[];
    hideTimeFields: string[];
    /** Selected date/time for the inner `nile-calendar`: an instant, an offset-less wall clock read in `timezone`, the bracketed form, or date-only — all different. `unixEpoch` is the authoritative instant. */
    value: string | null;
    timezone: string;
    selectedUnit?: TimeUnits;
    selectedValue?: number;
    startYear?: number;
    endYear?: number;
    allowedDates: string;
    dateFormat: string;
    placeholder: string;
    label: string;
    accessibleLabel: string;
    private get structuredInput();
    doubleClickUnselect: boolean;
    disabled: boolean;
    open: boolean;
    panel: NileFloatingPanel;
    private calendarRef;
    private _openSyncFromPanel;
    private _skipNextSeed;
    /** true once the user has typed/pasted/deleted in the mask since the last seed, so only user edits are clamped to allowedDates */
    private _maskEdited;
    /** the zone the consumer configured (first render, or any later external change), restored on Clear instead of forcing UTC */
    private _defaultTimezone;
    /** the last zone this component assigned itself, so `updated` can tell it apart from a consumer change */
    private _internalTimezone;
    private setTimezoneInternally;
    private static readonly TIME_SPEC;
    private get resolvedTimeFields();
    private get shownTimeFields();
    private timeSep;
    private get showTimezone();
    private get defaultPlaceholder();
    private get triggerInput();
    get calendarElement(): any;
    connectedCallback(): void;
    disconnectedCallback(): void;
    private syncOpenFromPanel;
    /** keep `open` in sync with the panel's own show/hide (click, outside-click, Escape) */
    /** `performance.now()` of an Escape pressed while focus was inside the panel; 0 when there is none to honour */
    private _escapeFromPanelAt;
    /**
     * The panel hides on a document-level Escape and drops focus to <body> when the focused control disappears with it.
     * Runs in the capture phase, before the panel's own handler, to note whether focus was inside the panel; onPanelHide
     * then hands focus back to the trigger. Escape with focus anywhere else leaves focus where it is.
     */
    private onEscapeKeydown;
    /** the element that really holds focus, however deep in shadow roots */
    private deepActiveElement;
    /** tab stops inside the panel in DOM order, looking through shadow roots (the panel is portaled to <body>) */
    private panelTabbables;
    /** the panel's way in: the day that owns the grid's tab stop, else the first control */
    private focusIntoPanel;
    /**
     * The panel is portaled to the end of <body>, so the browser's own Tab order skips it (Chrome, Edge, Firefox) or
     * lands in it from the wrong side. While it is open Tab from the field enters it at its first control, Shift+Tab from its first control
     * returns to the field, and Tab from its last control hands focus back to the field so the browser's default move
     * continues to the next page element (the panel then closes: it has been left). No trap: Shift+Tab from the field and
     * every Tab outside the panel behave as usual.
     */
    private onPanelTab;
    /** ArrowDown / Alt+ArrowDown on the field opens the panel and moves focus into it. Enter, Space and typing are untouched. */
    private onTriggerKeydown;
    private focusIsInPanel;
    /**
     * nile-floating-panel creates the `role="dialog"` container itself, portals it out of this shadow root and gives it no
     * name. Name it here after the field it belongs to, so the shared panel (and nile-context-menu) stays untouched.
     */
    private applyDialogName;
    private onPanelShow;
    /** set by Apply: the next open lands on the committed date, not on whatever year/month was browsed before it */
    private _showCommittedOnOpen;
    /**
     * The month/year dropdowns only navigate, so after Apply the view can be left on a browsed month. Reopening then shows the
     * committed date's month/year. Dismissing without Apply (Escape, outside click) never takes this path: the view and any
     * pending selection stay as the user left them. With no selection the view is left alone.
     */
    private showSelectedMonth;
    private onPanelHide;
    willUpdate(changedProperties: PropertyValues): void;
    firstUpdated(changedProperties: PropertyValues): void;
    updated(changedProperties: Map<string, unknown>): void;
    private applyTriggerAriaLabel;
    private seedTriggerFromValue;
    /** `silent` is for display-only refreshes (a dateFormat/hideTimeFields change): no `nile-input`, since the user did not type or clear */
    private clearTriggerText;
    private wallClockFromRaw;
    private bindStructuredInput;
    private maskValues;
    private maskSuffix;
    /** the slot values as last seeded/committed from `value`; blur clamps only segments that differ from it (the user's edits) */
    private seedMask;
    /** the seeded value's full year, set wherever `seedMask` is: a `YY` mask holds only its last two digits */
    private seedYear;
    /** set when a YY year with no valid two-digit form was blanked; until a year is typed (or the mask is reseeded) the calendar keeps no selection built from day and month alone */
    private _yearRejected;
    /**
     * The full year for a completed year segment. A `YY` year whose two digits equal the seeded value's keeps its century
     * (editing the day of 1999-06-15, or retyping or restoring `99`, stays 1999); any other two digits read as 2000-2099.
     */
    private fullYearOf;
    private maskLayout;
    private computeDisplay;
    private initMaskState;
    private clampSegment;
    /** An abandoned year edit (digits typed over the old year, then the caret moved on) is normalised before another segment's edit builds on it. An untouched year, however far out of range, is left alone. */
    private settleYear;
    private clampDay;
    private writeMask;
    private onMaskBlur;
    private completedSegment;
    /**
     * A typed date outside the calendar's allowedDates range snaps to the nearest boundary (the calendar disables
     * those day cells but typing bypasses it). Only the date slots change; time and timezone are untouched.
     */
    private clampMaskToAllowedDates;
    private syncCalendarFromMask;
    /** Re-derive slot state from whatever the native input now holds, then redisplay it masked. */
    private reflowMaskFromNative;
    private onMaskPaste;
    /** Covers cut, undo/redo, drag-drop, IME and soft-keyboard input, none of which arrive as a usable keydown. */
    private onMaskBeforeInput;
    private onMaskKeydown;
    private maskSegments;
    private maxDayForMonth;
    render(): TemplateResult;
    private handleTypeChange;
    handleChanged(event: CustomEvent): void;
    handleClear(): void;
    private pad;
    /** Read an instant's fields in the host zone. Lossless in this direction. */
    private wallClockFromDate;
    private formatDatePartFields;
    private formatWallClock;
    private formatDateTime;
    /** A value's digits as written: bracketed `…[GMT+05:30 Zone]` or offset-less `YYYY-MM-DDTHH:mm[:ss[.SSS]]`; anything else is null. */
    private parseWallClock;
    private parseZonedValue;
    private formatValue;
}
export default NileDateTimePicker;
declare global {
    interface HTMLElementTagNameMap {
        'nile-date-time-picker': NileDateTimePicker;
    }
}