@slotted/angular 0.0.0-stage → 0.1.0-beta.0

package/fesm2022/slotted-angular-date-field.mjs

@@ -0,0 +1,772 @@
+import { EMPTY_SEGMENTS, plainDate, createDateFormat, dateOf, toISODate, isDateInRange, isSameDate, segmentsOf, todayIn, clearSegment, boundSegment, stepSegment, typeDigit, commitTyping, fieldRange } from '@slotted/core/date';
+import { createControllable } from '@slotted/core/state';
+import * as i0 from '@angular/core';
+import { InjectionToken, inject, input, numberAttribute, booleanAttribute, output, ElementRef, HostAttributeToken, signal, computed, effect, forwardRef, ViewEncapsulation, ChangeDetectionStrategy, Component, Directive } from '@angular/core';
+import { NG_VALUE_ACCESSOR, NG_VALIDATORS } from '@angular/forms';
+import { injectLocale, injectMessages } from '@slotted/angular/i18n';
+import { SlGlyph, SlIcon } from '@slotted/angular/icon';
+import { dateFieldMessages } from '@slotted/core/i18n';
+import { SlField } from '@slotted/angular/field';
+
+/**
+ * Two typed digits up to twenty years ahead of this year are this century, and
+ * anything above them is the last: `30` is 2030 and `80` is 1980 in 2026.
+ *
+ * A birth-date field sets it to `0`, and then only a year already past can be
+ * typed in two digits. The number is stated rather than inferred because the
+ * alternative is two bindings guessing, differently, at what `26` means.
+ */
+const DATE_FIELD_YEAR_PIVOT = 20;
+const FALLBACK = {
+    calendar: 'gregory',
+    firstDayOfWeek: undefined,
+    size: 'md',
+    timeZone: undefined,
+    variant: 'outline',
+    yearPivot: DATE_FIELD_YEAR_PIVOT,
+};
+const DATE_FIELD_DEFAULTS = new InjectionToken('slotted date field defaults', { providedIn: 'root', factory: () => FALLBACK });
+/**
+ * An application decides once what its dates look like, which zone answers
+ * "today" and how a two-digit year resolves, rather than repeating the same
+ * inputs on every control in a form. A control that states any of them itself
+ * still wins. The locale that writes the dates, and the clear button's name,
+ * come from the language in force (`provideSlotted`).
+ */
+function provideDateFieldDefaults(defaults) {
+    return {
+        provide: DATE_FIELD_DEFAULTS,
+        useFactory: () => ({ ...FALLBACK, ...defaults }),
+    };
+}
+/** What a date field renders as here, before it states anything of its own. */
+function injectDateFieldDefaults() {
+    return inject(DATE_FIELD_DEFAULTS);
+}
+
+/**
+ * How far `PageUp` and `PageDown` move each field.
+ *
+ * Five is the APG spin-button example's step, adopted for the day and the
+ * month. The year departs: five years is not a page of years, and ten is the
+ * step the calendar's own year view pages by, so the two agree. The cost is
+ * written in `specs/components/date-field/contract.json` under `departures`.
+ */
+const PAGE_STEP = { day: 5, month: 5, year: 10 };
+/**
+ * The hidden element carrying the whole date needs an identifier the group can
+ * point `aria-labelledby` at, and Angular has no `useId`. A module counter is
+ * what the framework leaves: it is stable for a given render order, which is
+ * what hydration needs, and it never reaches the public surface.
+ */
+let sequence = 0;
+/**
+ * A segmented date control: one spin button per field, in the order the locale
+ * writes them.
+ *
+ * **The frame is not the control.** The element carrying `data-ui` is the
+ * consumer's own box with no role; `role="group"` is on the row of segments,
+ * which is what the APG's spin-button example names as the thing that tells a
+ * screen-reader user that three buttons are one date.
+ *
+ * **Angular renders the segments and React renders the segments.** The two
+ * bindings share the arithmetic in `@slotted/core/date` and nothing else: this
+ * one is a component with a template and a `ControlValueAccessor`, because a
+ * date belongs in a Reactive Form and Angular has the integration point for it.
+ * It also implements `Validator`, which React has no equivalent of and which is
+ * the asymmetry `references/frameworks.md` asks to be recorded rather than
+ * levelled away — `min`, `max` and `isDateUnavailable` are validity this
+ * control owns and no other validator can see.
+ *
+ * **The segments are the state and the value is derived.** A date with a day
+ * and a month and no year is not a date, so the value is `null` — and that is
+ * not the same as an empty field. The request carries the segments so a
+ * consumer can tell them apart.
+ */
+class SlDateField {
+    /** Present means the consumer owns the value. */
+    value = input(undefined, /* @ts-ignore */
+    ...(ngDevMode ? [{ debugName: "value" }] : /* istanbul ignore next */ []));
+    /** The value the control starts from when nobody else writes one. */
+    defaultValue = input(undefined, /* @ts-ignore */
+    ...(ngDevMode ? [{ debugName: "defaultValue" }] : /* istanbul ignore next */ []));
+    /** The earliest date the control accepts. Also a form validity rule. */
+    min = input(undefined, /* @ts-ignore */
+    ...(ngDevMode ? [{ debugName: "min" }] : /* istanbul ignore next */ []));
+    /** The latest date the control accepts. Also a form validity rule. */
+    max = input(undefined, /* @ts-ignore */
+    ...(ngDevMode ? [{ debugName: "max" }] : /* istanbul ignore next */ []));
+    /** Refuses particular dates — a weekend, a holiday, a booked day. */
+    isDateUnavailable = input(undefined, /* @ts-ignore */
+    ...(ngDevMode ? [{ debugName: "isDateUnavailable" }] : /* istanbul ignore next */ []));
+    /**
+     * BCP 47. Decides the field order, the separators and the placeholder.
+     * Unset, the language in force decides.
+     */
+    locale = input(undefined, /* @ts-ignore */
+    ...(ngDevMode ? [{ debugName: "locale" }] : /* istanbul ignore next */ []));
+    /** Which zone answers "what is today", and nothing else. */
+    timeZone = input(undefined, /* @ts-ignore */
+    ...(ngDevMode ? [{ debugName: "timeZone" }] : /* istanbul ignore next */ []));
+    firstDayOfWeek = input(undefined, { ...(ngDevMode ? { debugName: "firstDayOfWeek" } : /* istanbul ignore next */ {}), transform: (value) => value === undefined || value === null ? undefined : numberAttribute(value) });
+    yearPivot = input(undefined, { ...(ngDevMode ? { debugName: "yearPivot" } : /* istanbul ignore next */ {}), transform: (value) => value === undefined || value === null ? undefined : numberAttribute(value) });
+    calendar = input(undefined, /* @ts-ignore */
+    ...(ngDevMode ? [{ debugName: "calendar" }] : /* istanbul ignore next */ []));
+    size = input(undefined, /* @ts-ignore */
+    ...(ngDevMode ? [{ debugName: "size" }] : /* istanbul ignore next */ []));
+    variant = input(undefined, /* @ts-ignore */
+    ...(ngDevMode ? [{ debugName: "variant" }] : /* istanbul ignore next */ []));
+    /** Unstated rather than `false`, so the control defers to the field. */
+    disabled = input(undefined, { ...(ngDevMode ? { debugName: "disabled" } : /* istanbul ignore next */ {}), transform: (value) => (value === undefined ? undefined : booleanAttribute(value)) });
+    readOnly = input(undefined, { ...(ngDevMode ? { debugName: "readOnly" } : /* istanbul ignore next */ {}), transform: (value) => (value === undefined ? undefined : booleanAttribute(value)) });
+    invalid = input(undefined, { ...(ngDevMode ? { debugName: "invalid" } : /* istanbul ignore next */ {}), transform: (value) => (value === undefined ? undefined : booleanAttribute(value)) });
+    required = input(undefined, { ...(ngDevMode ? { debugName: "required" } : /* istanbul ignore next */ {}), transform: (value) => (value === undefined ? undefined : booleanAttribute(value)) });
+    /** Draws a button that empties the value and returns focus to the control. */
+    clearable = input(false, { ...(ngDevMode ? { debugName: "clearable" } : /* istanbul ignore next */ {}), transform: booleanAttribute });
+    /** Words laid over the catalog of the language in force, key by key: the clear button's name. */
+    messages = input(undefined, /* @ts-ignore */
+    ...(ngDevMode ? [{ debugName: "messages" }] : /* istanbul ignore next */ []));
+    /** The name a plain form post carries the ISO string under. */
+    name = input(undefined, /* @ts-ignore */
+    ...(ngDevMode ? [{ debugName: "name" }] : /* istanbul ignore next */ []));
+    /**
+     * The accessible name, when it is bound rather than written: a static
+     * `aria-label` is read once from the host, and a family naming this field
+     * from its own input — `date-range-picker` names its two ends — has no
+     * static attribute to write.
+     */
+    label = input(undefined, /* @ts-ignore */
+    ...(ngDevMode ? [{ debugName: "label" }] : /* istanbul ignore next */ []));
+    /**
+     * The group's identifier, when it is bound rather than written: a family
+     * holding two of these inside one field — `date-range-picker` — gives each
+     * its own, where both would otherwise take the field's.
+     */
+    groupId = input(undefined, /* @ts-ignore */
+    ...(ngDevMode ? [{ debugName: "groupId" }] : /* istanbul ignore next */ []));
+    /**
+     * One output for one transition, carrying the value, the value it replaces,
+     * the segments, the reason, the originating event and `cancel()`. There is no
+     * `[(value)]`, because a two-way binding has one slot and can carry none of
+     * those; a form gets the same movement through `ControlValueAccessor`.
+     */
+    valueChange = output();
+    element = inject(ElementRef).nativeElement;
+    defaults = injectDateFieldDefaults();
+    appLocale = injectLocale();
+    /** The family's words in the language in force, with this field's `messages` laid over them. */
+    t = injectMessages(dateFieldMessages, this.messages);
+    field = inject(SlField, { optional: true });
+    /** Read before the host binding computes, so it never writes over it. */
+    writtenLabel = inject(new HostAttributeToken('aria-label'), {
+        optional: true,
+    });
+    writtenId = inject(new HostAttributeToken('id'), { optional: true });
+    writtenLabelledBy = inject(new HostAttributeToken('aria-labelledby'), {
+        optional: true,
+    });
+    writtenDescribedBy = inject(new HostAttributeToken('aria-describedby'), {
+        optional: true,
+    });
+    /** The whole date in words, for the group's own accessible name. */
+    valueTextId = `sl-date-field-${String((sequence += 1))}`;
+    segments = signal(EMPTY_SEGMENTS, /* @ts-ignore */
+    ...(ngDevMode ? [{ debugName: "segments" }] : /* istanbul ignore next */ []));
+    formDisabled = signal(undefined, /* @ts-ignore */
+    ...(ngDevMode ? [{ debugName: "formDisabled" }] : /* istanbul ignore next */ []));
+    /**
+     * Which day it is, resolved after construction rather than during it, so a
+     * server and a browser in different zones never disagree about the markup.
+     * Nothing is drawn from it: it is the date an empty segment steps to.
+     */
+    reference = signal(plainDate(2000, 1, 1), /* @ts-ignore */
+    ...(ngDevMode ? [{ debugName: "reference" }] : /* istanbul ignore next */ []));
+    activeField = signal(undefined, /* @ts-ignore */
+    ...(ngDevMode ? [{ debugName: "activeField" }] : /* istanbul ignore next */ []));
+    onChangeFn = () => undefined;
+    onTouchedFn = () => undefined;
+    onValidatorChangeFn = () => undefined;
+    format = computed(() => createDateFormat({
+        locale: this.locale() ?? this.appLocale(),
+        firstDayOfWeek: this.firstDayOfWeek() ?? this.defaults.firstDayOfWeek,
+        yearPivot: this.yearPivot() ?? this.defaults.yearPivot,
+    }), /* @ts-ignore */
+    ...(ngDevMode ? [{ debugName: "format" }] : /* istanbul ignore next */ []));
+    fields = computed(() => this.format()
+        .pattern.filter((part) => part.type !== 'literal')
+        .map((part) => part.type), /* @ts-ignore */
+    ...(ngDevMode ? [{ debugName: "fields" }] : /* istanbul ignore next */ []));
+    /** The date the segments make, or `null` while any of them is unfilled. */
+    date = computed(() => dateOf(this.segments()), /* @ts-ignore */
+    ...(ngDevMode ? [{ debugName: "date" }] : /* istanbul ignore next */ []));
+    iso = computed(() => {
+        const date = this.date();
+        return date === null ? '' : toISODate(date);
+    }, /* @ts-ignore */
+    ...(ngDevMode ? [{ debugName: "iso" }] : /* istanbul ignore next */ []));
+    spokenDate = computed(() => {
+        const date = this.date();
+        return date === null ? '' : this.format().describe(date);
+    }, /* @ts-ignore */
+    ...(ngDevMode ? [{ debugName: "spokenDate" }] : /* istanbul ignore next */ []));
+    resolvedSize = computed(() => this.size() ?? this.field?.resolvedSize() ?? this.defaults.size, /* @ts-ignore */
+    ...(ngDevMode ? [{ debugName: "resolvedSize" }] : /* istanbul ignore next */ []));
+    resolvedVariant = computed(() => this.variant() ?? this.defaults.variant, /* @ts-ignore */
+    ...(ngDevMode ? [{ debugName: "resolvedVariant" }] : /* istanbul ignore next */ []));
+    resolvedCalendar = computed(() => this.calendar() ?? this.defaults.calendar, /* @ts-ignore */
+    ...(ngDevMode ? [{ debugName: "resolvedCalendar" }] : /* istanbul ignore next */ []));
+    resolvedDisabled = computed(() => this.disabled() ?? this.formDisabled() ?? this.field?.resolvedDisabled(), /* @ts-ignore */
+    ...(ngDevMode ? [{ debugName: "resolvedDisabled" }] : /* istanbul ignore next */ []));
+    resolvedReadOnly = computed(() => this.readOnly() ?? this.field?.resolvedReadOnly(), /* @ts-ignore */
+    ...(ngDevMode ? [{ debugName: "resolvedReadOnly" }] : /* istanbul ignore next */ []));
+    resolvedRequired = computed(() => this.required() ?? this.field?.required(), /* @ts-ignore */
+    ...(ngDevMode ? [{ debugName: "resolvedRequired" }] : /* istanbul ignore next */ []));
+    /**
+     * Validity the family owns, beside the validity the consumer states. A date
+     * outside the bounds or refused by the predicate is invalid whatever the
+     * field around it says, because this control is the only thing that knows.
+     */
+    resolvedInvalid = computed(() => {
+        const date = this.date();
+        if (date !== null && !isDateInRange(date, this.min(), this.max()))
+            return true;
+        if (date !== null && this.isDateUnavailable()?.(date) === true)
+            return true;
+        return this.invalid() ?? this.field?.invalid();
+    }, /* @ts-ignore */
+    ...(ngDevMode ? [{ debugName: "resolvedInvalid" }] : /* istanbul ignore next */ []));
+    controlId = computed(() => this.groupId() ?? this.writtenId ?? this.field?.ids().control ?? null, /* @ts-ignore */
+    ...(ngDevMode ? [{ debugName: "controlId" }] : /* istanbul ignore next */ []));
+    labelledBy = computed(() => {
+        if (this.label() !== undefined || this.writtenLabel !== null)
+            return null;
+        const merged = [this.writtenLabelledBy ?? this.field?.ids().label, this.valueTextId].filter(Boolean);
+        return merged.length === 0 ? null : merged.join(' ');
+    }, /* @ts-ignore */
+    ...(ngDevMode ? [{ debugName: "labelledBy" }] : /* istanbul ignore next */ []));
+    describedBy = computed(() => {
+        const merged = [this.writtenDescribedBy, this.field?.describedBy()].filter(Boolean);
+        return merged.length === 0 ? null : merged.join(' ');
+    }, /* @ts-ignore */
+    ...(ngDevMode ? [{ debugName: "describedBy" }] : /* istanbul ignore next */ []));
+    ariaInvalid = computed(() => this.resolvedInvalid() === true ? 'true' : null, /* @ts-ignore */
+    ...(ngDevMode ? [{ debugName: "ariaInvalid" }] : /* istanbul ignore next */ []));
+    ariaRequired = computed(() => this.resolvedRequired() === true ? 'true' : null, /* @ts-ignore */
+    ...(ngDevMode ? [{ debugName: "ariaRequired" }] : /* istanbul ignore next */ []));
+    ariaReadonly = computed(() => this.resolvedReadOnly() === true ? 'true' : null, /* @ts-ignore */
+    ...(ngDevMode ? [{ debugName: "ariaReadonly" }] : /* istanbul ignore next */ []));
+    ariaDisabled = computed(() => this.resolvedDisabled() === true ? 'true' : null, /* @ts-ignore */
+    ...(ngDevMode ? [{ debugName: "ariaDisabled" }] : /* istanbul ignore next */ []));
+    editable = computed(() => this.resolvedDisabled() !== true && this.resolvedReadOnly() !== true, /* @ts-ignore */
+    ...(ngDevMode ? [{ debugName: "editable" }] : /* istanbul ignore next */ []));
+    showClear = computed(() => {
+        if (!this.clearable() || !this.editable())
+            return false;
+        const held = this.segments();
+        return held.year !== null || held.month !== null || held.day !== null;
+    }, /* @ts-ignore */
+    ...(ngDevMode ? [{ debugName: "showClear" }] : /* istanbul ignore next */ []));
+    /**
+     * Angular creates a component before it binds any input, so the starting
+     * value is read here rather than in the constructor: read there, both
+     * `value` and `defaultValue` are `undefined` and the control starts empty.
+     */
+    constructor() {
+        /**
+         * A consumer's own value writes the segments, and only when it names a
+         * different date: written on every change detection it would throw away a
+         * half-typed date on the keystroke that completes a different one.
+         *
+         * Without it a controlled `[value]` only ever reached the control once, in
+         * `ngOnInit` — which is what the first run of `date-picker`'s spec showed
+         * as a field still holding the ninth after the calendar had chosen the
+         * seventeenth.
+         */
+        effect(() => {
+            const next = this.value();
+            if (next === undefined)
+                return;
+            const segments = this.segments();
+            /* A run of digits still being typed is not a value the consumer refused;
+               the guard `time-field` records, taken here for the same reason. */
+            if (segments.typing !== null)
+                return;
+            if (isSameDate(dateOf(segments), next))
+                return;
+            this.segments.set(segmentsOf(next));
+        });
+    }
+    ngOnInit() {
+        this.segments.set(segmentsOf(this.value() ?? this.defaultValue() ?? null));
+        this.reference.set(todayIn(this.timeZone() ?? this.defaults.timeZone));
+    }
+    /* ── The value ───────────────────────────────────────────────────────── */
+    writeValue(value) {
+        this.segments.set(segmentsOf(value ?? null));
+    }
+    registerOnChange(fn) {
+        this.onChangeFn = fn;
+    }
+    registerOnTouched(fn) {
+        this.onTouchedFn = fn;
+    }
+    setDisabledState(isDisabled) {
+        this.formDisabled.set(isDisabled);
+    }
+    registerOnValidatorChange(fn) {
+        this.onValidatorChangeFn = fn;
+    }
+    /**
+     * The rules no other validator can see. `required` is left to Angular's own,
+     * because a form already has a word for it and two would disagree.
+     */
+    validate(control) {
+        const date = control.value;
+        if (date === null || date === undefined)
+            return null;
+        const min = this.min();
+        const max = this.max();
+        if (!isDateInRange(date, min, max)) {
+            return { slottedDateRange: { min, max, actual: date } };
+        }
+        if (this.isDateUnavailable()?.(date) === true) {
+            return { slottedDateUnavailable: { actual: date } };
+        }
+        return null;
+    }
+    /** Puts focus on the first segment, which is where typing starts. */
+    focus() {
+        const first = this.fields()[0];
+        if (first !== undefined)
+            this.focusField(first);
+    }
+    /**
+     * Where a press on the frame puts the reader: the first field still waiting
+     * for a value, and the first field of the date when none is.
+     *
+     * A press that landed on the frame's own padding, on the gap between two
+     * fields or on an adornment did nothing at all — the reader saw a control
+     * that looked like a text field and answered like a picture. Every text
+     * control on the page answers a press anywhere inside its border, and this
+     * one has to as well.
+     */
+    focusEntry() {
+        const held = this.segments();
+        const empty = this.fields().find((name) => held[name] === null);
+        const target = empty ?? this.fields()[0];
+        if (target !== undefined)
+            this.focusField(target);
+    }
+    /**
+     * A press inside the frame that landed on nothing of its own. The default is
+     * prevented so the press does not immediately blur the field it just gave
+     * focus to, which is what a `mousedown` on a non-focusable box would do.
+     */
+    onRootMouseDown(event) {
+        const target = event.target;
+        if (target?.closest('[data-part="segment"], button, a, input, select, textarea') != null) {
+            return;
+        }
+        event.preventDefault();
+        this.focusEntry();
+    }
+    /**
+     * Safari does not focus a `div` on a press even when it carries a
+     * `tabindex`, so the press says so itself rather than relying on it.
+     */
+    onSegmentMouseDown(event) {
+        event.preventDefault();
+        event.currentTarget.focus();
+    }
+    /** Empties every segment, with the `clear` reason. */
+    clear(source) {
+        this.commit(EMPTY_SEGMENTS, 'clear', source);
+        this.focus();
+    }
+    /* ── The keyboard ────────────────────────────────────────────────────── */
+    /**
+     * A key the field acted on is the field's, and nothing above it sees it.
+     *
+     * Every application that binds a bare key guards it with "is the target an
+     * editable element", and that guard tests for `input`, `textarea` and
+     * `contenteditable`. A `div` with `role="spinbutton"` is none of the three,
+     * so a reader typing a date into this control fires every single-key
+     * shortcut on the page: in Storybook, pressing `1` moved focus out of the
+     * story and into the sidebar, and the date could not be typed at all.
+     *
+     * `preventDefault` alone does not help — a shortcut handler reads the key,
+     * not the default. The event has to stop.
+     */
+    consume(event) {
+        event.preventDefault();
+        event.stopPropagation();
+    }
+    /**
+     * The keys are handled on the host rather than on each segment, so a
+     * consumer's own `(keydown)` on the same element still runs before the
+     * family stops the event — which is the composition React gets by calling
+     * the consumer's handler first.
+     */
+    onKeyDown(event) {
+        const segment = event.target?.closest('[data-part="segment"]');
+        const name = segment?.dataset['field'];
+        if (name === undefined)
+            return;
+        /* An inline direction is a physical pair of keys and a logical order, so
+           the arrow that walks forward is the one pointing along the writing
+           direction rather than the one pointing right. */
+        const rtl = getComputedStyle(this.element).direction === 'rtl';
+        const forward = rtl ? 'ArrowLeft' : 'ArrowRight';
+        const backward = rtl ? 'ArrowRight' : 'ArrowLeft';
+        if (event.key === forward) {
+            this.consume(event);
+            this.moveBy(name, 1);
+            return;
+        }
+        if (event.key === backward) {
+            this.consume(event);
+            this.moveBy(name, -1);
+            return;
+        }
+        if (!this.editable())
+            return;
+        /**
+         * `Alt` with an arrow is not this control's chord. `date-picker` opens its
+         * calendar with `Alt`+`ArrowDown`, and a segment that stepped on it would
+         * eat the only shortcut the surface has.
+         */
+        if (event.altKey)
+            return;
+        const held = this.segments();
+        const reference = this.reference();
+        switch (event.key) {
+            case 'ArrowUp':
+                this.consume(event);
+                this.commit(stepSegment(held, name, 1, reference), 'keyboard', event);
+                return;
+            case 'ArrowDown':
+                this.consume(event);
+                this.commit(stepSegment(held, name, -1, reference), 'keyboard', event);
+                return;
+            case 'PageUp':
+                this.consume(event);
+                this.commit(stepSegment(held, name, PAGE_STEP[name], reference), 'keyboard', event);
+                return;
+            case 'PageDown':
+                this.consume(event);
+                this.commit(stepSegment(held, name, -PAGE_STEP[name], reference), 'keyboard', event);
+                return;
+            case 'Home':
+                this.consume(event);
+                this.commit(boundSegment(held, name, 'min', reference), 'keyboard', event);
+                return;
+            case 'End':
+                this.consume(event);
+                this.commit(boundSegment(held, name, 'max', reference), 'keyboard', event);
+                return;
+            case 'Backspace':
+            case 'Delete':
+                this.consume(event);
+                this.commit(clearSegment(held, name), 'clear', event);
+                return;
+            default:
+                break;
+        }
+        if (/^\d$/.test(event.key)) {
+            this.consume(event);
+            const typed = typeDigit(held, name, Number(event.key), this.format(), reference);
+            this.commit(typed.segments, 'keyboard', event);
+            if (typed.advance)
+                this.moveBy(name, 1);
+        }
+    }
+    /**
+     * A whole date, pasted. The locale's shape is read first and ISO 8601 after
+     * it, so `12/03/2026` is December to an American and March to a Brazilian
+     * while `2026-09-09` is the ninth to both.
+     */
+    onPaste(event) {
+        if (!this.editable())
+            return;
+        const parsed = this.format().parse(event.clipboardData?.getData('text/plain') ?? '');
+        if (parsed === null)
+            return;
+        event.preventDefault();
+        this.commit(segmentsOf(parsed), 'keyboard', event);
+    }
+    /** A run of typed digits ends when focus leaves, and a short year resolves. */
+    onBlur() {
+        this.activeField.set(undefined);
+        this.onTouchedFn();
+        const held = this.segments();
+        if (held.typing === null)
+            return;
+        this.commit(commitTyping(held, this.format(), this.reference()), 'blur', undefined);
+    }
+    /* ── What the template reads ─────────────────────────────────────────── */
+    valueOf(field) {
+        return this.segments()[field];
+    }
+    rangeOf(field) {
+        const held = this.segments();
+        const reference = this.reference();
+        return fieldRange(field, {
+            year: held.year ?? reference.year,
+            month: held.month ?? reference.month,
+        });
+    }
+    /** What a reader hears instead of the number: a month says its own name. */
+    spokenOf(field) {
+        const raw = this.segments()[field];
+        if (raw === null)
+            return null;
+        if (field !== 'month')
+            return String(raw);
+        return this.format().monthNames('long')[raw - 1] ?? String(raw);
+    }
+    /**
+     * What one field shows.
+     *
+     * A finished value is padded to the field's width, so the three columns hold
+     * their place: `9` and `09` occupy the same box and the separators never step
+     * sideways. A value still being typed is **not** padded — it is the digits
+     * the reader has put in, in the order they put them. Padded, a year on its
+     * way to 2026 read `0002`, then `0020`, then `0202`, which is three numbers
+     * nobody typed.
+     */
+    textOf(field) {
+        const held = this.segments();
+        const raw = held[field];
+        if (raw === null) {
+            return this.format().pattern.find((part) => part.type === field)?.value ?? '';
+        }
+        const typing = held.typing;
+        if (typing !== null && typing.field === field) {
+            return String(raw).padStart(typing.digits, '0');
+        }
+        const reference = this.reference();
+        return this.format().formatField({
+            year: held.year ?? reference.year,
+            month: held.month ?? reference.month,
+            day: held.day ?? reference.day,
+        }, field);
+    }
+    /** Exactly one segment is in the tab sequence, which is the roving model. */
+    tabIndexOf(field) {
+        if (this.resolvedDisabled() === true)
+            return -1;
+        return field === (this.activeField() ?? this.fields()[0]) ? 0 : -1;
+    }
+    /* ── The machinery ───────────────────────────────────────────────────── */
+    focusField(name) {
+        this.activeField.set(name);
+        this.element.querySelector(`[data-part="segment"][data-field="${name}"]`)?.focus();
+    }
+    moveBy(name, step) {
+        const next = this.fields()[this.fields().indexOf(name) + step];
+        if (next !== undefined)
+            this.focusField(next);
+    }
+    /**
+     * Moves the segments, and asks before the derived value moves with them.
+     *
+     * A run of typed digits moves the display and not the value: typing `2026`
+     * into a year passes through 2, 20 and 202 on the way, and a request per
+     * digit would ask a consumer's server about the year 2. The request is
+     * emitted when the run ends.
+     */
+    commit(next, reason, source) {
+        const previous = this.date();
+        this.segments.set(next);
+        if (next.typing !== null)
+            return;
+        const nextValue = dateOf(next);
+        let cancelled = false;
+        const state = createControllable({
+            controlled: undefined,
+            initial: previous,
+            equals: isSameDate,
+            onRequest: (request) => {
+                this.valueChange.emit({ ...request, segments: next });
+                cancelled = request.cancelled;
+            },
+        });
+        state.request(nextValue, reason, source);
+        if (cancelled)
+            return;
+        this.onChangeFn(nextValue);
+        this.onValidatorChangeFn();
+    }
+    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "22.1.7", ngImport: i0, type: SlDateField, deps: [], target: i0.ɵɵFactoryTarget.Component });
+    static ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "17.0.0", version: "22.1.7", type: SlDateField, isStandalone: true, selector: "[slDateField]", inputs: { value: { classPropertyName: "value", publicName: "value", isSignal: true, isRequired: false, transformFunction: null }, defaultValue: { classPropertyName: "defaultValue", publicName: "defaultValue", isSignal: true, isRequired: false, transformFunction: null }, min: { classPropertyName: "min", publicName: "min", isSignal: true, isRequired: false, transformFunction: null }, max: { classPropertyName: "max", publicName: "max", isSignal: true, isRequired: false, transformFunction: null }, isDateUnavailable: { classPropertyName: "isDateUnavailable", publicName: "isDateUnavailable", isSignal: true, isRequired: false, transformFunction: null }, locale: { classPropertyName: "locale", publicName: "locale", isSignal: true, isRequired: false, transformFunction: null }, timeZone: { classPropertyName: "timeZone", publicName: "timeZone", isSignal: true, isRequired: false, transformFunction: null }, firstDayOfWeek: { classPropertyName: "firstDayOfWeek", publicName: "firstDayOfWeek", isSignal: true, isRequired: false, transformFunction: null }, yearPivot: { classPropertyName: "yearPivot", publicName: "yearPivot", isSignal: true, isRequired: false, transformFunction: null }, calendar: { classPropertyName: "calendar", publicName: "calendar", isSignal: true, isRequired: false, transformFunction: null }, size: { classPropertyName: "size", publicName: "size", isSignal: true, isRequired: false, transformFunction: null }, variant: { classPropertyName: "variant", publicName: "variant", isSignal: true, isRequired: false, transformFunction: null }, disabled: { classPropertyName: "disabled", publicName: "disabled", isSignal: true, isRequired: false, transformFunction: null }, readOnly: { classPropertyName: "readOnly", publicName: "readOnly", isSignal: true, isRequired: false, transformFunction: null }, invalid: { classPropertyName: "invalid", publicName: "invalid", isSignal: true, isRequired: false, transformFunction: null }, required: { classPropertyName: "required", publicName: "required", isSignal: true, isRequired: false, transformFunction: null }, clearable: { classPropertyName: "clearable", publicName: "clearable", isSignal: true, isRequired: false, transformFunction: null }, messages: { classPropertyName: "messages", publicName: "messages", isSignal: true, isRequired: false, transformFunction: null }, name: { classPropertyName: "name", publicName: "name", isSignal: true, isRequired: false, transformFunction: null }, label: { classPropertyName: "label", publicName: "label", isSignal: true, isRequired: false, transformFunction: null }, groupId: { classPropertyName: "groupId", publicName: "groupId", isSignal: true, isRequired: false, transformFunction: null } }, outputs: { valueChange: "valueChange" }, host: { attributes: { "data-ui": "date-field", "data-part": "root" }, listeners: { "mousedown": "onRootMouseDown($event)", "keydown": "onKeyDown($event)" }, properties: { "attr.data-size": "resolvedSize()", "attr.data-variant": "resolvedVariant()", "attr.data-calendar": "resolvedCalendar()", "attr.data-disabled": "resolvedDisabled() === true ? '' : null", "attr.data-invalid": "resolvedInvalid() === true ? '' : null", "attr.data-readonly": "resolvedReadOnly() === true ? '' : null", "attr.data-required": "resolvedRequired() === true ? '' : null" } }, providers: [
+            { provide: NG_VALUE_ACCESSOR, useExisting: forwardRef(() => SlDateField), multi: true },
+            { provide: NG_VALIDATORS, useExisting: forwardRef(() => SlDateField), multi: true },
+        ], exportAs: ["slDateField"], ngImport: i0, template: `<ng-content select="[slDateFieldStart]" />
+    <div
+      data-part="segments"
+      role="group"
+      [attr.id]="controlId()"
+      [attr.aria-label]="label() ?? writtenLabel"
+      [attr.aria-labelledby]="labelledBy()"
+      [attr.aria-describedby]="describedBy()"
+      [attr.aria-invalid]="ariaInvalid()"
+      [attr.aria-required]="ariaRequired()"
+      [attr.aria-readonly]="ariaReadonly()"
+      [attr.aria-disabled]="ariaDisabled()"
+      (paste)="onPaste($event)"
+    >
+      @for (part of format().pattern; track $index) {
+        @if (part.type === 'literal') {
+          <span data-part="literal" aria-hidden="true">{{ part.value }}</span>
+        } @else {
+          <div
+            data-part="segment"
+            role="spinbutton"
+            [attr.data-field]="part.type"
+            [attr.data-placeholder]="valueOf(part.type) === null ? '' : null"
+            [attr.aria-label]="part.value"
+            [attr.aria-valuenow]="valueOf(part.type)"
+            [attr.aria-valuemin]="rangeOf(part.type).min"
+            [attr.aria-valuemax]="rangeOf(part.type).max"
+            [attr.aria-valuetext]="spokenOf(part.type)"
+            [attr.aria-disabled]="ariaDisabled()"
+            [attr.aria-readonly]="ariaReadonly()"
+            [tabindex]="tabIndexOf(part.type)"
+            (mousedown)="onSegmentMouseDown($event)"
+            (focus)="activeField.set(part.type)"
+            (blur)="onBlur()"
+          >
+            {{ textOf(part.type) }}
+          </div>
+        }
+      }
+    </div>
+    <span data-part="value-text" hidden [attr.id]="valueTextId">{{ spokenDate() }}</span>
+    @if (showClear()) {
+      <button
+        data-part="clear"
+        type="button"
+        [attr.aria-label]="t('clear')"
+        (click)="clear($event)"
+      >
+        <span slIcon><svg slGlyph name="x"></svg></span>
+      </button>
+    }
+    <ng-content select="[slDateFieldEnd]" />
+    <input data-part="hidden-input" type="hidden" readonly [attr.name]="name()" [value]="iso()" />`, isInline: true, styles: ["@layer slotted.components{[data-ui=date-field][data-part=root]{--_font-size: var(--slotted-control-font-size-md, 13px);--_height: var(--slotted-control-height-md, 34px);--_padding-inline: var(--slotted-control-padding-inline-md, 13px);--_gap: var(--slotted-control-gap-md, 8px);--_icon-floor: var(--slotted-date-field-icon-size-min, 14px);--_icon-size: max(var(--_icon-floor), var(--slotted-control-icon-size-md, 16px));--_action-size: var( --slotted-date-field-action-size, min( calc(var(--_icon-size) + 2 * var(--slotted-space-2, .25rem)), calc( var(--_height) - var(--slotted-control-border-width, 1px) * 2 - var(--slotted-space-2, .25rem) ) ) );align-items:center;background-color:var(--slotted-date-field-background, var(--slotted-control-surface, Field));border:var(--slotted-control-border-width, 1px) solid var(--slotted-date-field-border-color, var(--slotted-control-border-color, ButtonBorder));border-radius:var(--slotted-date-field-radius, var(--slotted-control-radius, 4px));box-shadow:var(--slotted-date-field-shadow, var(--slotted-control-shadow, none));box-sizing:border-box;color:var(--slotted-date-field-color, var(--slotted-text, CanvasText));display:flex;font-family:var(--slotted-control-font-family, system-ui, sans-serif);font-size:var(--_font-size);gap:var(--_gap);inline-size:100%;min-block-size:var(--_height);min-inline-size:0;padding-inline:var(--_padding-inline);transition:background-color var(--slotted-control-transition-duration) var(--slotted-control-transition-easing),border-color var(--slotted-control-transition-duration) var(--slotted-control-transition-easing),box-shadow var(--slotted-control-transition-duration) var(--slotted-control-transition-easing)}[data-ui=date-field][data-part=root]:has(>[data-part=clear]:last-child){padding-inline-end:max(0px,calc(var(--_padding-inline) - (var(--_action-size) - var(--_icon-size)) / 2))}[data-ui=date-field] [data-part=segments]{align-items:center;cursor:text;display:flex;flex:1 1 auto;min-inline-size:0;overflow:hidden;font-variant-numeric:tabular-nums}[data-ui=date-field] [data-part=segment]{--_digits: 2;background-color:transparent;cursor:text;border-radius:var(--slotted-date-field-segment-radius, var(--slotted-radius-xs, 2px));box-sizing:content-box;color:inherit;caret-color:transparent;font:inherit;flex:0 0 auto;min-inline-size:var(--slotted-date-field-segment-min-inline-size, calc(var(--_digits) * 1ch));padding-inline:var( --slotted-date-field-segment-padding-inline, var(--slotted-space-1, .125rem) );text-align:center;transition:background-color var(--slotted-control-transition-duration) var(--slotted-control-transition-easing),color var(--slotted-control-transition-duration) var(--slotted-control-transition-easing);-webkit-user-select:none;user-select:none;-webkit-tap-highlight-color:transparent}[data-ui=date-field] [data-part=segment][data-field=year]{--_digits: 4}[data-ui=date-field] [data-part=segment][data-placeholder]{color:var(--slotted-date-field-placeholder-color, var(--slotted-text-muted, GrayText))}[data-ui=date-field] [data-part=literal]{color:var(--slotted-date-field-literal-color, var(--slotted-text-muted, GrayText));flex:0 0 auto;unicode-bidi:plaintext;-webkit-user-select:none;user-select:none}[data-ui=date-field][data-part=root][data-size=sm]{--_font-size: var(--slotted-control-font-size-sm, 12px);--_height: var(--slotted-control-height-sm, 30px);--_padding-inline: var(--slotted-control-padding-inline-sm, 10px);--_gap: var(--slotted-control-gap-sm, 6px);--_icon-size: max(var(--_icon-floor), var(--slotted-control-icon-size-sm, 14px))}[data-ui=date-field][data-part=root][data-size=md]{--_font-size: var(--slotted-control-font-size-md, 13px);--_height: var(--slotted-control-height-md, 34px);--_padding-inline: var(--slotted-control-padding-inline-md, 13px);--_gap: var(--slotted-control-gap-md, 8px);--_icon-size: max(var(--_icon-floor), var(--slotted-control-icon-size-md, 16px))}[data-ui=date-field][data-part=root][data-size=lg]{--_font-size: var(--slotted-control-font-size-lg, 14px);--_height: var(--slotted-control-height-lg, 38px);--_padding-inline: var(--slotted-control-padding-inline-lg, 16px);--_gap: var(--slotted-control-gap-lg, 8px);--_icon-size: max(var(--_icon-floor), var(--slotted-control-icon-size-lg, 18px))}[data-ui=date-field][data-part=root][data-variant=subtle]{background-color:var( --slotted-date-field-subtle-background, var(--slotted-surface-sunken, Canvas) );border-color:var( --slotted-date-field-subtle-border-color, var(--slotted-border-subtle, ButtonBorder) )}[data-ui=date-field][data-part=root][data-variant=plain]{background-color:transparent;border-color:transparent;border-radius:var(--slotted-radius-none, 0px);box-shadow:none}[data-ui=date-field]>[data-part=start],[data-ui=date-field]>[data-part=end]{--slotted-icon-size: var(--_icon-size);align-items:center;color:var(--slotted-date-field-adornment-color, var(--slotted-text-muted, GrayText));display:inline-flex;flex:0 0 auto;gap:var(--slotted-space-2, .25rem);line-height:1;unicode-bidi:plaintext}[data-ui=date-field]>[data-part=start]>svg,[data-ui=date-field]>[data-part=end]>svg{block-size:var(--_icon-size);inline-size:var(--_icon-size)}[data-ui=date-field]>[data-part=clear]{align-items:center;appearance:none;background-color:transparent;block-size:var(--_action-size);border:0;border-radius:var(--slotted-date-field-radius, var(--slotted-control-radius, 4px));color:var(--slotted-date-field-action-color, var(--slotted-text-muted, GrayText));cursor:pointer;display:inline-flex;flex:0 0 auto;inline-size:var(--_action-size);justify-content:center;padding:0;position:relative;touch-action:manipulation;transition:background-color var(--slotted-control-transition-duration) var(--slotted-control-transition-easing),color var(--slotted-control-transition-duration) var(--slotted-control-transition-easing);-webkit-tap-highlight-color:transparent}[data-ui=date-field]>[data-part=clear]:after{content:\"\";inset:min(0px,calc((100% - var(--slotted-target-min, 24px)) / 2));position:absolute}@media(pointer:coarse){[data-ui=date-field]>[data-part=clear]:after{inset:min(0px,calc((100% - var(--slotted-target-comfortable, 44px)) / 2))}[data-ui=date-field]>[data-part=end]+[data-part=clear]:after{inset-inline-start:0}}[data-ui=date-field]>[data-part=clear]{--slotted-icon-size: var(--_icon-size)}[data-ui=date-field]>[data-part=clear]:hover:not(:disabled):not([data-disabled]){background-color:var( --slotted-date-field-action-hover-background, var(--slotted-tone-secondary-subtle-hover) )}[data-ui=date-field]>[data-part=clear]:active:not(:disabled):not([data-disabled]){background-color:var( --slotted-date-field-action-active-background, var(--slotted-tone-secondary-subtle-active) )}[data-ui=date-field]>[data-part=clear]:focus-visible{outline:var(--slotted-focus-ring-width, 2px) solid var(--slotted-focus-ring-color, Highlight);outline-offset:calc(var(--slotted-focus-ring-offset, 2px) * -1)}[data-ui=date-field][data-part=root]:hover:not([data-disabled]):not([data-readonly]):not([data-invalid]){border-color:var(--slotted-date-field-hover-border-color, var(--slotted-tone-accent-border))}[data-ui=date-field][data-part=root][data-variant=subtle]:hover:not([data-disabled]):not([data-readonly]):not([data-invalid]){background-color:var( --slotted-date-field-subtle-hover-background, var(--slotted-tone-secondary-subtle-hover) )}[data-ui=date-field][data-part=root][data-variant=plain]:hover:not([data-disabled]):not([data-readonly]):not([data-invalid]){background-color:var( --slotted-date-field-plain-hover-background, var(--slotted-tone-secondary-subtle-hover) );border-color:transparent}[data-ui=date-field][data-part=root]:has([data-part=segment]:focus){box-shadow:var(--slotted-control-shadow-focus-geometry, 0 1px 4px -1px) var(--slotted-focus-ring-color, Highlight);outline:var(--slotted-focus-ring-width, 2px) solid var(--slotted-focus-ring-color, Highlight);outline-offset:var(--slotted-focus-ring-offset, 2px)}[data-ui=date-field][data-part=root][data-variant=plain]:has([data-part=segment]:focus){box-shadow:none;outline-offset:calc(var(--slotted-focus-ring-offset, 2px) * -1)}[data-ui=date-field] [data-part=segment]:focus{background-color:var( --slotted-date-field-segment-focus-background, var(--slotted-tone-accent-solid) );color:var(--slotted-date-field-segment-focus-color, var(--slotted-tone-accent-on-solid));outline:none}[data-ui=date-field][data-part=root][data-invalid]{--slotted-focus-ring-color: var( --slotted-date-field-invalid-focus-ring-color, var(--slotted-focus-ring-color-invalid, Highlight) );--_invalid-edge-width: var( --slotted-date-field-invalid-edge-width, var(--slotted-control-invalid-edge-width, 1px) );--_invalid-edge-color: var( --slotted-date-field-invalid-border-color, var(--slotted-tone-danger-border) );--_invalid-edge: inset 0 0 0 var(--_invalid-edge-width) var(--_invalid-edge-color);border-color:var(--slotted-date-field-invalid-border-color, var(--slotted-tone-danger-border));box-shadow:var(--_invalid-edge)}[data-ui=date-field][data-part=root][data-invalid]:has([data-part=segment]:focus){box-shadow:var(--_invalid-edge),var(--slotted-control-shadow-focus-geometry, 0 1px 4px -1px) var(--slotted-focus-ring-color, Highlight)}[data-ui=date-field][data-part=root][data-variant=plain][data-invalid]:has([data-part=segment]:focus){box-shadow:inset 0 0 0 calc(var(--slotted-focus-ring-offset, 2px) - var(--slotted-control-border-width, 1px) + var(--_invalid-edge-width)) var(--_invalid-edge-color)}@media(forced-colors:active){[data-ui=date-field][data-part=root][data-invalid]{outline:var(--_invalid-edge-width) solid CanvasText;outline-offset:calc(-1 * (var(--slotted-control-border-width, 1px) + var(--_invalid-edge-width)))}[data-ui=date-field][data-part=root][data-invalid]:has([data-part=segment]:focus){outline:calc(var(--slotted-focus-ring-width, 2px) + var(--_invalid-edge-width)) double var(--slotted-focus-ring-color, Highlight);outline-offset:var(--slotted-focus-ring-offset, 2px)}[data-ui=date-field][data-part=root][data-variant=plain][data-invalid]:has([data-part=segment]:focus){outline:calc(var(--slotted-focus-ring-width, 2px) + var(--_invalid-edge-width)) double var(--slotted-focus-ring-color, Highlight);outline-offset:calc(-1 * (var(--slotted-focus-ring-width, 2px) + var(--_invalid-edge-width)))}}[data-ui=date-field][data-part=root][data-readonly],[data-ui=date-field][data-part=root][data-readonly] [data-part=segments],[data-ui=date-field][data-part=root][data-readonly] [data-part=segment]{cursor:default}[data-ui=date-field][data-part=root][data-readonly]{background-color:var( --slotted-date-field-readonly-background, var(--slotted-tone-secondary-subtle-hover) )}[data-ui=date-field][data-part=root][data-disabled]{background-color:var( --slotted-date-field-disabled-background, var(--slotted-disabled-background) );border-color:var(--slotted-date-field-disabled-border-color, var(--slotted-disabled-border));box-shadow:none;color:var(--slotted-date-field-disabled-color, var(--slotted-disabled-foreground));cursor:not-allowed}[data-ui=date-field][data-part=root][data-disabled] [data-part=segments],[data-ui=date-field][data-part=root][data-disabled] [data-part=segment]{cursor:not-allowed}[data-ui=date-field][data-part=root][data-disabled]>[data-part=start],[data-ui=date-field][data-part=root][data-disabled]>[data-part=end],[data-ui=date-field][data-part=root][data-disabled] [data-part=literal],[data-ui=date-field][data-part=root][data-disabled] [data-part=segment][data-placeholder]{color:var(--slotted-disabled-foreground)}@media(forced-colors:active){[data-ui=date-field][data-part=root][data-variant=plain]{border-color:ButtonBorder}}}\n"], dependencies: [{ kind: "component", type: SlGlyph, selector: "svg[slGlyph]", inputs: ["name", "solid"] }, { kind: "component", type: SlIcon, selector: "[slIcon]", inputs: ["directional", "label", "size", "tone"], exportAs: ["slIcon"] }], changeDetection: i0.ChangeDetectionStrategy.OnPush, encapsulation: i0.ViewEncapsulation.None });
+}
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.1.7", ngImport: i0, type: SlDateField, decorators: [{
+            type: Component,
+            args: [{ selector: '[slDateField]', standalone: true, exportAs: 'slDateField', imports: [SlGlyph, SlIcon], template: `<ng-content select="[slDateFieldStart]" />
+    <div
+      data-part="segments"
+      role="group"
+      [attr.id]="controlId()"
+      [attr.aria-label]="label() ?? writtenLabel"
+      [attr.aria-labelledby]="labelledBy()"
+      [attr.aria-describedby]="describedBy()"
+      [attr.aria-invalid]="ariaInvalid()"
+      [attr.aria-required]="ariaRequired()"
+      [attr.aria-readonly]="ariaReadonly()"
+      [attr.aria-disabled]="ariaDisabled()"
+      (paste)="onPaste($event)"
+    >
+      @for (part of format().pattern; track $index) {
+        @if (part.type === 'literal') {
+          <span data-part="literal" aria-hidden="true">{{ part.value }}</span>
+        } @else {
+          <div
+            data-part="segment"
+            role="spinbutton"
+            [attr.data-field]="part.type"
+            [attr.data-placeholder]="valueOf(part.type) === null ? '' : null"
+            [attr.aria-label]="part.value"
+            [attr.aria-valuenow]="valueOf(part.type)"
+            [attr.aria-valuemin]="rangeOf(part.type).min"
+            [attr.aria-valuemax]="rangeOf(part.type).max"
+            [attr.aria-valuetext]="spokenOf(part.type)"
+            [attr.aria-disabled]="ariaDisabled()"
+            [attr.aria-readonly]="ariaReadonly()"
+            [tabindex]="tabIndexOf(part.type)"
+            (mousedown)="onSegmentMouseDown($event)"
+            (focus)="activeField.set(part.type)"
+            (blur)="onBlur()"
+          >
+            {{ textOf(part.type) }}
+          </div>
+        }
+      }
+    </div>
+    <span data-part="value-text" hidden [attr.id]="valueTextId">{{ spokenDate() }}</span>
+    @if (showClear()) {
+      <button
+        data-part="clear"
+        type="button"
+        [attr.aria-label]="t('clear')"
+        (click)="clear($event)"
+      >
+        <span slIcon><svg slGlyph name="x"></svg></span>
+      </button>
+    }
+    <ng-content select="[slDateFieldEnd]" />
+    <input data-part="hidden-input" type="hidden" readonly [attr.name]="name()" [value]="iso()" />`, changeDetection: ChangeDetectionStrategy.OnPush, encapsulation: ViewEncapsulation.None, providers: [
+                        { provide: NG_VALUE_ACCESSOR, useExisting: forwardRef(() => SlDateField), multi: true },
+                        { provide: NG_VALIDATORS, useExisting: forwardRef(() => SlDateField), multi: true },
+                    ], host: {
+                        'data-ui': 'date-field',
+                        'data-part': 'root',
+                        '(mousedown)': 'onRootMouseDown($event)',
+                        '(keydown)': 'onKeyDown($event)',
+                        '[attr.data-size]': 'resolvedSize()',
+                        '[attr.data-variant]': 'resolvedVariant()',
+                        '[attr.data-calendar]': 'resolvedCalendar()',
+                        '[attr.data-disabled]': "resolvedDisabled() === true ? '' : null",
+                        '[attr.data-invalid]': "resolvedInvalid() === true ? '' : null",
+                        '[attr.data-readonly]': "resolvedReadOnly() === true ? '' : null",
+                        '[attr.data-required]': "resolvedRequired() === true ? '' : null",
+                    }, styles: ["@layer slotted.components{[data-ui=date-field][data-part=root]{--_font-size: var(--slotted-control-font-size-md, 13px);--_height: var(--slotted-control-height-md, 34px);--_padding-inline: var(--slotted-control-padding-inline-md, 13px);--_gap: var(--slotted-control-gap-md, 8px);--_icon-floor: var(--slotted-date-field-icon-size-min, 14px);--_icon-size: max(var(--_icon-floor), var(--slotted-control-icon-size-md, 16px));--_action-size: var( --slotted-date-field-action-size, min( calc(var(--_icon-size) + 2 * var(--slotted-space-2, .25rem)), calc( var(--_height) - var(--slotted-control-border-width, 1px) * 2 - var(--slotted-space-2, .25rem) ) ) );align-items:center;background-color:var(--slotted-date-field-background, var(--slotted-control-surface, Field));border:var(--slotted-control-border-width, 1px) solid var(--slotted-date-field-border-color, var(--slotted-control-border-color, ButtonBorder));border-radius:var(--slotted-date-field-radius, var(--slotted-control-radius, 4px));box-shadow:var(--slotted-date-field-shadow, var(--slotted-control-shadow, none));box-sizing:border-box;color:var(--slotted-date-field-color, var(--slotted-text, CanvasText));display:flex;font-family:var(--slotted-control-font-family, system-ui, sans-serif);font-size:var(--_font-size);gap:var(--_gap);inline-size:100%;min-block-size:var(--_height);min-inline-size:0;padding-inline:var(--_padding-inline);transition:background-color var(--slotted-control-transition-duration) var(--slotted-control-transition-easing),border-color var(--slotted-control-transition-duration) var(--slotted-control-transition-easing),box-shadow var(--slotted-control-transition-duration) var(--slotted-control-transition-easing)}[data-ui=date-field][data-part=root]:has(>[data-part=clear]:last-child){padding-inline-end:max(0px,calc(var(--_padding-inline) - (var(--_action-size) - var(--_icon-size)) / 2))}[data-ui=date-field] [data-part=segments]{align-items:center;cursor:text;display:flex;flex:1 1 auto;min-inline-size:0;overflow:hidden;font-variant-numeric:tabular-nums}[data-ui=date-field] [data-part=segment]{--_digits: 2;background-color:transparent;cursor:text;border-radius:var(--slotted-date-field-segment-radius, var(--slotted-radius-xs, 2px));box-sizing:content-box;color:inherit;caret-color:transparent;font:inherit;flex:0 0 auto;min-inline-size:var(--slotted-date-field-segment-min-inline-size, calc(var(--_digits) * 1ch));padding-inline:var( --slotted-date-field-segment-padding-inline, var(--slotted-space-1, .125rem) );text-align:center;transition:background-color var(--slotted-control-transition-duration) var(--slotted-control-transition-easing),color var(--slotted-control-transition-duration) var(--slotted-control-transition-easing);-webkit-user-select:none;user-select:none;-webkit-tap-highlight-color:transparent}[data-ui=date-field] [data-part=segment][data-field=year]{--_digits: 4}[data-ui=date-field] [data-part=segment][data-placeholder]{color:var(--slotted-date-field-placeholder-color, var(--slotted-text-muted, GrayText))}[data-ui=date-field] [data-part=literal]{color:var(--slotted-date-field-literal-color, var(--slotted-text-muted, GrayText));flex:0 0 auto;unicode-bidi:plaintext;-webkit-user-select:none;user-select:none}[data-ui=date-field][data-part=root][data-size=sm]{--_font-size: var(--slotted-control-font-size-sm, 12px);--_height: var(--slotted-control-height-sm, 30px);--_padding-inline: var(--slotted-control-padding-inline-sm, 10px);--_gap: var(--slotted-control-gap-sm, 6px);--_icon-size: max(var(--_icon-floor), var(--slotted-control-icon-size-sm, 14px))}[data-ui=date-field][data-part=root][data-size=md]{--_font-size: var(--slotted-control-font-size-md, 13px);--_height: var(--slotted-control-height-md, 34px);--_padding-inline: var(--slotted-control-padding-inline-md, 13px);--_gap: var(--slotted-control-gap-md, 8px);--_icon-size: max(var(--_icon-floor), var(--slotted-control-icon-size-md, 16px))}[data-ui=date-field][data-part=root][data-size=lg]{--_font-size: var(--slotted-control-font-size-lg, 14px);--_height: var(--slotted-control-height-lg, 38px);--_padding-inline: var(--slotted-control-padding-inline-lg, 16px);--_gap: var(--slotted-control-gap-lg, 8px);--_icon-size: max(var(--_icon-floor), var(--slotted-control-icon-size-lg, 18px))}[data-ui=date-field][data-part=root][data-variant=subtle]{background-color:var( --slotted-date-field-subtle-background, var(--slotted-surface-sunken, Canvas) );border-color:var( --slotted-date-field-subtle-border-color, var(--slotted-border-subtle, ButtonBorder) )}[data-ui=date-field][data-part=root][data-variant=plain]{background-color:transparent;border-color:transparent;border-radius:var(--slotted-radius-none, 0px);box-shadow:none}[data-ui=date-field]>[data-part=start],[data-ui=date-field]>[data-part=end]{--slotted-icon-size: var(--_icon-size);align-items:center;color:var(--slotted-date-field-adornment-color, var(--slotted-text-muted, GrayText));display:inline-flex;flex:0 0 auto;gap:var(--slotted-space-2, .25rem);line-height:1;unicode-bidi:plaintext}[data-ui=date-field]>[data-part=start]>svg,[data-ui=date-field]>[data-part=end]>svg{block-size:var(--_icon-size);inline-size:var(--_icon-size)}[data-ui=date-field]>[data-part=clear]{align-items:center;appearance:none;background-color:transparent;block-size:var(--_action-size);border:0;border-radius:var(--slotted-date-field-radius, var(--slotted-control-radius, 4px));color:var(--slotted-date-field-action-color, var(--slotted-text-muted, GrayText));cursor:pointer;display:inline-flex;flex:0 0 auto;inline-size:var(--_action-size);justify-content:center;padding:0;position:relative;touch-action:manipulation;transition:background-color var(--slotted-control-transition-duration) var(--slotted-control-transition-easing),color var(--slotted-control-transition-duration) var(--slotted-control-transition-easing);-webkit-tap-highlight-color:transparent}[data-ui=date-field]>[data-part=clear]:after{content:\"\";inset:min(0px,calc((100% - var(--slotted-target-min, 24px)) / 2));position:absolute}@media(pointer:coarse){[data-ui=date-field]>[data-part=clear]:after{inset:min(0px,calc((100% - var(--slotted-target-comfortable, 44px)) / 2))}[data-ui=date-field]>[data-part=end]+[data-part=clear]:after{inset-inline-start:0}}[data-ui=date-field]>[data-part=clear]{--slotted-icon-size: var(--_icon-size)}[data-ui=date-field]>[data-part=clear]:hover:not(:disabled):not([data-disabled]){background-color:var( --slotted-date-field-action-hover-background, var(--slotted-tone-secondary-subtle-hover) )}[data-ui=date-field]>[data-part=clear]:active:not(:disabled):not([data-disabled]){background-color:var( --slotted-date-field-action-active-background, var(--slotted-tone-secondary-subtle-active) )}[data-ui=date-field]>[data-part=clear]:focus-visible{outline:var(--slotted-focus-ring-width, 2px) solid var(--slotted-focus-ring-color, Highlight);outline-offset:calc(var(--slotted-focus-ring-offset, 2px) * -1)}[data-ui=date-field][data-part=root]:hover:not([data-disabled]):not([data-readonly]):not([data-invalid]){border-color:var(--slotted-date-field-hover-border-color, var(--slotted-tone-accent-border))}[data-ui=date-field][data-part=root][data-variant=subtle]:hover:not([data-disabled]):not([data-readonly]):not([data-invalid]){background-color:var( --slotted-date-field-subtle-hover-background, var(--slotted-tone-secondary-subtle-hover) )}[data-ui=date-field][data-part=root][data-variant=plain]:hover:not([data-disabled]):not([data-readonly]):not([data-invalid]){background-color:var( --slotted-date-field-plain-hover-background, var(--slotted-tone-secondary-subtle-hover) );border-color:transparent}[data-ui=date-field][data-part=root]:has([data-part=segment]:focus){box-shadow:var(--slotted-control-shadow-focus-geometry, 0 1px 4px -1px) var(--slotted-focus-ring-color, Highlight);outline:var(--slotted-focus-ring-width, 2px) solid var(--slotted-focus-ring-color, Highlight);outline-offset:var(--slotted-focus-ring-offset, 2px)}[data-ui=date-field][data-part=root][data-variant=plain]:has([data-part=segment]:focus){box-shadow:none;outline-offset:calc(var(--slotted-focus-ring-offset, 2px) * -1)}[data-ui=date-field] [data-part=segment]:focus{background-color:var( --slotted-date-field-segment-focus-background, var(--slotted-tone-accent-solid) );color:var(--slotted-date-field-segment-focus-color, var(--slotted-tone-accent-on-solid));outline:none}[data-ui=date-field][data-part=root][data-invalid]{--slotted-focus-ring-color: var( --slotted-date-field-invalid-focus-ring-color, var(--slotted-focus-ring-color-invalid, Highlight) );--_invalid-edge-width: var( --slotted-date-field-invalid-edge-width, var(--slotted-control-invalid-edge-width, 1px) );--_invalid-edge-color: var( --slotted-date-field-invalid-border-color, var(--slotted-tone-danger-border) );--_invalid-edge: inset 0 0 0 var(--_invalid-edge-width) var(--_invalid-edge-color);border-color:var(--slotted-date-field-invalid-border-color, var(--slotted-tone-danger-border));box-shadow:var(--_invalid-edge)}[data-ui=date-field][data-part=root][data-invalid]:has([data-part=segment]:focus){box-shadow:var(--_invalid-edge),var(--slotted-control-shadow-focus-geometry, 0 1px 4px -1px) var(--slotted-focus-ring-color, Highlight)}[data-ui=date-field][data-part=root][data-variant=plain][data-invalid]:has([data-part=segment]:focus){box-shadow:inset 0 0 0 calc(var(--slotted-focus-ring-offset, 2px) - var(--slotted-control-border-width, 1px) + var(--_invalid-edge-width)) var(--_invalid-edge-color)}@media(forced-colors:active){[data-ui=date-field][data-part=root][data-invalid]{outline:var(--_invalid-edge-width) solid CanvasText;outline-offset:calc(-1 * (var(--slotted-control-border-width, 1px) + var(--_invalid-edge-width)))}[data-ui=date-field][data-part=root][data-invalid]:has([data-part=segment]:focus){outline:calc(var(--slotted-focus-ring-width, 2px) + var(--_invalid-edge-width)) double var(--slotted-focus-ring-color, Highlight);outline-offset:var(--slotted-focus-ring-offset, 2px)}[data-ui=date-field][data-part=root][data-variant=plain][data-invalid]:has([data-part=segment]:focus){outline:calc(var(--slotted-focus-ring-width, 2px) + var(--_invalid-edge-width)) double var(--slotted-focus-ring-color, Highlight);outline-offset:calc(-1 * (var(--slotted-focus-ring-width, 2px) + var(--_invalid-edge-width)))}}[data-ui=date-field][data-part=root][data-readonly],[data-ui=date-field][data-part=root][data-readonly] [data-part=segments],[data-ui=date-field][data-part=root][data-readonly] [data-part=segment]{cursor:default}[data-ui=date-field][data-part=root][data-readonly]{background-color:var( --slotted-date-field-readonly-background, var(--slotted-tone-secondary-subtle-hover) )}[data-ui=date-field][data-part=root][data-disabled]{background-color:var( --slotted-date-field-disabled-background, var(--slotted-disabled-background) );border-color:var(--slotted-date-field-disabled-border-color, var(--slotted-disabled-border));box-shadow:none;color:var(--slotted-date-field-disabled-color, var(--slotted-disabled-foreground));cursor:not-allowed}[data-ui=date-field][data-part=root][data-disabled] [data-part=segments],[data-ui=date-field][data-part=root][data-disabled] [data-part=segment]{cursor:not-allowed}[data-ui=date-field][data-part=root][data-disabled]>[data-part=start],[data-ui=date-field][data-part=root][data-disabled]>[data-part=end],[data-ui=date-field][data-part=root][data-disabled] [data-part=literal],[data-ui=date-field][data-part=root][data-disabled] [data-part=segment][data-placeholder]{color:var(--slotted-disabled-foreground)}@media(forced-colors:active){[data-ui=date-field][data-part=root][data-variant=plain]{border-color:ButtonBorder}}}\n"] }]
+        }], ctorParameters: () => [], propDecorators: { value: [{ type: i0.Input, args: [{ isSignal: true, alias: "value", required: false }] }], defaultValue: [{ type: i0.Input, args: [{ isSignal: true, alias: "defaultValue", required: false }] }], min: [{ type: i0.Input, args: [{ isSignal: true, alias: "min", required: false }] }], max: [{ type: i0.Input, args: [{ isSignal: true, alias: "max", required: false }] }], isDateUnavailable: [{ type: i0.Input, args: [{ isSignal: true, alias: "isDateUnavailable", required: false }] }], locale: [{ type: i0.Input, args: [{ isSignal: true, alias: "locale", required: false }] }], timeZone: [{ type: i0.Input, args: [{ isSignal: true, alias: "timeZone", required: false }] }], firstDayOfWeek: [{ type: i0.Input, args: [{ isSignal: true, alias: "firstDayOfWeek", required: false }] }], yearPivot: [{ type: i0.Input, args: [{ isSignal: true, alias: "yearPivot", required: false }] }], calendar: [{ type: i0.Input, args: [{ isSignal: true, alias: "calendar", required: false }] }], size: [{ type: i0.Input, args: [{ isSignal: true, alias: "size", required: false }] }], variant: [{ type: i0.Input, args: [{ isSignal: true, alias: "variant", required: false }] }], disabled: [{ type: i0.Input, args: [{ isSignal: true, alias: "disabled", required: false }] }], readOnly: [{ type: i0.Input, args: [{ isSignal: true, alias: "readOnly", required: false }] }], invalid: [{ type: i0.Input, args: [{ isSignal: true, alias: "invalid", required: false }] }], required: [{ type: i0.Input, args: [{ isSignal: true, alias: "required", required: false }] }], clearable: [{ type: i0.Input, args: [{ isSignal: true, alias: "clearable", required: false }] }], messages: [{ type: i0.Input, args: [{ isSignal: true, alias: "messages", required: false }] }], name: [{ type: i0.Input, args: [{ isSignal: true, alias: "name", required: false }] }], label: [{ type: i0.Input, args: [{ isSignal: true, alias: "label", required: false }] }], groupId: [{ type: i0.Input, args: [{ isSignal: true, alias: "groupId", required: false }] }], valueChange: [{ type: i0.Output, args: ["valueChange"] }] } });
+
+/**
+ * An adornment before the date in the reading direction: a calendar mark, a
+ * label, an icon. Named for the direction rather than for a side, so the same
+ * markup puts the mark before the date in both directions.
+ *
+ * It is a directive on the consumer's own element, so an `icon`, a `kbd` or a
+ * `span` all work and none of them loses its own semantics. The stylesheet
+ * sizes any icon inside it from the control's own glyph scale.
+ */
+class SlDateFieldStart {
+    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "22.1.7", ngImport: i0, type: SlDateFieldStart, deps: [], target: i0.ɵɵFactoryTarget.Directive });
+    static ɵdir = i0.ɵɵngDeclareDirective({ minVersion: "14.0.0", version: "22.1.7", type: SlDateFieldStart, isStandalone: true, selector: "[slDateFieldStart]", host: { attributes: { "data-part": "start" } }, exportAs: ["slDateFieldStart"], ngImport: i0 });
+}
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.1.7", ngImport: i0, type: SlDateFieldStart, decorators: [{
+            type: Directive,
+            args: [{
+                    selector: '[slDateFieldStart]',
+                    standalone: true,
+                    exportAs: 'slDateFieldStart',
+                    host: { 'data-part': 'start' },
+                }]
+        }] });
+/** An adornment after the date in the reading direction. */
+class SlDateFieldEnd {
+    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "22.1.7", ngImport: i0, type: SlDateFieldEnd, deps: [], target: i0.ɵɵFactoryTarget.Directive });
+    static ɵdir = i0.ɵɵngDeclareDirective({ minVersion: "14.0.0", version: "22.1.7", type: SlDateFieldEnd, isStandalone: true, selector: "[slDateFieldEnd]", host: { attributes: { "data-part": "end" } }, exportAs: ["slDateFieldEnd"], ngImport: i0 });
+}
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.1.7", ngImport: i0, type: SlDateFieldEnd, decorators: [{
+            type: Directive,
+            args: [{
+                    selector: '[slDateFieldEnd]',
+                    standalone: true,
+                    exportAs: 'slDateFieldEnd',
+                    host: { 'data-part': 'end' },
+                }]
+        }] });
+
+/**
+ * Generated bundle index. Do not edit.
+ */
+
+export { DATE_FIELD_DEFAULTS, DATE_FIELD_YEAR_PIVOT, SlDateField, SlDateFieldEnd, SlDateFieldStart, injectDateFieldDefaults, provideDateFieldDefaults };
+//# sourceMappingURL=slotted-angular-date-field.mjs.map