@tzslot/angular 0.1.0-beta.0 → 1.0.0

package/types/tzslot-angular.d.ts

@@ -1,10 +1,10 @@
+import * as temporal_spec from 'temporal-spec';
 import * as _angular_core from '@angular/core';
 import { InjectionToken, AfterViewInit, OnDestroy } from '@angular/core';
-import * as temporal_spec from 'temporal-spec';
 import { ControlValueAccessor } from '@angular/forms';
-import { Slot, Instant, Weekday, ValueShape, PlainDate, DateLike, DailyWindowsSummary } from '@tzslot/core';
-import { SlotChoice, TzslotMessages, CalendarView, RenderCell, CalendarButton, YearMonth, FieldMode, DateRangeValue, DateTimeRangeValue, DailyRangeValue } from '@tzslot/dom';
-export { CalendarButton, CalendarView, CellRender, DailyRangeValue, DateRangeValue, DateTimeRangeValue, DayCellInfo, EN, FR, FieldMode, RenderCell, SlotChoice, TzslotMessages } from '@tzslot/dom';
+import { ValueShape, Slot, Weekday, Instant, PlainDate, DateLike, DurationLike, ShiftOption, InstantLike, PresetName, PlainTime, ShiftStep, DailyWindowsSummary } from '@tzslot/core';
+import { SlotChoice, TzslotMessages, CalendarView, RenderCell, CalendarButton, YearMonth, FieldMode, TimeLayout, RangeFieldValue, RangePreset, DateRangeValue, DateTimeRangeValue, DailyRangeValue } from '@tzslot/dom';
+export { CalendarButton, CalendarView, CellRender, DailyRangeValue, DateRangeValue, DateTimeRangeValue, DayCellInfo, EN, FR, FieldMode, RangeFieldValue, RangePreset, RenderCell, SlotChoice, TimeLayout, TzslotMessages } from '@tzslot/dom';
 
 /**
  * `<tz-time-slots>` — the slot list from @tzslot/dom, spoken in Angular.
@@ -13,9 +13,21 @@ export { CalendarButton, CalendarView, CellRender, DailyRangeValue, DateRangeVal
  * clock shows; an instant is when it happened. Only one of those can be stored.
  */
 declare class TimeSlotPicker implements ControlValueAccessor {
+    /** Set once for the application with provideTzslot(); a binding still wins. */
+    private readonly defaults;
     /** The day to list, as a PlainDate or an ISO date string. */
+    /**
+     * What the form control holds. `'utc'` gives an ISO string; the default
+     * gives an Instant.
+     */
+    readonly valueAs: _angular_core.InputSignal<ValueShape>;
     readonly date: _angular_core.InputSignal<string | temporal_spec.Temporal.PlainDate>;
-    /** An IANA identifier — 'Europe/Paris', not an offset. Offsets change twice a year. */
+    /**
+     * An IANA identifier. Required in spirit: given here, it wins; left out, it
+     * is the zone provideTzslot() settled for the application, and only when
+     * nothing was settled anywhere does it fall back to the browser's — which
+     * is a guess, and the one thing this library exists not to do silently.
+     */
     readonly timeZone: _angular_core.InputSignal<string>;
     readonly stepMinutes: _angular_core.InputSignal<number>;
     /** The working day. Slots outside these bounds are not produced at all. */
@@ -46,12 +58,13 @@ declare class TimeSlotPicker implements ControlValueAccessor {
     clear(): void;
     private onChange;
     private onTouched;
-    writeValue(value: Instant | null): void;
-    registerOnChange(fn: (value: Instant | null) => void): void;
+    /** Typed `unknown`: a form holds what the application put there. */
+    writeValue(value: unknown): void;
+    registerOnChange(fn: (value: unknown) => void): void;
     registerOnTouched(fn: () => void): void;
     setDisabledState(isDisabled: boolean): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<TimeSlotPicker, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<TimeSlotPicker, "tz-time-slots", never, { "date": { "alias": "date"; "required": true; "isSignal": true; }; "timeZone": { "alias": "timeZone"; "required": true; "isSignal": true; }; "stepMinutes": { "alias": "stepMinutes"; "required": false; "isSignal": true; }; "minTime": { "alias": "minTime"; "required": false; "isSignal": true; }; "maxTime": { "alias": "maxTime"; "required": false; "isSignal": true; }; "isDisabled": { "alias": "isDisabled"; "required": false; "isSignal": true; }; "skipNonExistent": { "alias": "skipNonExistent"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "value": { "alias": "value"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "missingLabel": { "alias": "missingLabel"; "required": false; "isSignal": true; }; "emptyLabel": { "alias": "emptyLabel"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; }, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<TimeSlotPicker, "tz-time-slots", never, { "valueAs": { "alias": "valueAs"; "required": false; "isSignal": true; }; "date": { "alias": "date"; "required": true; "isSignal": true; }; "timeZone": { "alias": "timeZone"; "required": false; "isSignal": true; }; "stepMinutes": { "alias": "stepMinutes"; "required": false; "isSignal": true; }; "minTime": { "alias": "minTime"; "required": false; "isSignal": true; }; "maxTime": { "alias": "maxTime"; "required": false; "isSignal": true; }; "isDisabled": { "alias": "isDisabled"; "required": false; "isSignal": true; }; "skipNonExistent": { "alias": "skipNonExistent"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "value": { "alias": "value"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "missingLabel": { "alias": "missingLabel"; "required": false; "isSignal": true; }; "emptyLabel": { "alias": "emptyLabel"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; }, never, never, true, never>;
 }
 
 declare const TZSLOT_MESSAGES: InjectionToken<TzslotMessages>;
@@ -61,6 +74,73 @@ declare function provideTzslotMessages(messages: TzslotMessages): {
     useValue: TzslotMessages;
 };
 
+/**
+ * The conventions an application settles once.
+ *
+ * A zone, a locale, the shape values leave in: these are decisions about the
+ * application, not about the field. Repeating them on every tag is how one
+ * screen ends up handing a `Date` to a back end that stores instants, and how
+ * a reviewer has to read every template to find out which one.
+ *
+ * Anything set on a component still wins — this is the default, not the law.
+ */
+interface TzslotDefaults {
+    /**
+     * What every component that holds a moment or a day hands to its form
+     * control. `'utc'` is the useful one here: an instant, written as an ISO
+     * string ending in Z, whatever the widget is. A date-only field gives the
+     * midnight that opens that day in `timeZone`, so a back end that stores
+     * instants gets one from it too.
+     *
+     * `<tz-daily-range>` is the exception, and not an oversight: its value is a
+     * *pattern* — two days and two clock faces repeated over them — which is
+     * not a moment and has no UTC form. It always hands out Temporal objects.
+     */
+    readonly valueAs?: ValueShape;
+    /**
+     * The IANA zone the screen is read in — and the one a day is turned into a
+     * moment on. Components that take a `timeZone` of their own use this when
+     * none is given.
+     */
+    readonly timeZone?: string;
+    readonly locale?: string;
+    readonly firstDayOfWeek?: Weekday;
+    /** The words. The same thing `provideTzslotMessages` does, in one call. */
+    readonly messages?: TzslotMessages;
+}
+declare const TZSLOT_DEFAULTS: InjectionToken<TzslotDefaults>;
+/**
+ * `providers: [provideTzslot({ valueAs: 'utc', timeZone: 'Europe/Paris' })]`
+ *
+ * In an application: `bootstrapApplication(App, { providers: [provideTzslot({ … })] })`.
+ */
+declare function provideTzslot(defaults: TzslotDefaults): {
+    provide: unknown;
+    useValue: unknown;
+}[];
+
+/**
+ * A period, as a form holds it.
+ *
+ * The single-value components have spoken `valueAs` since the beginning; the
+ * ones holding two moments did not, so `provideTzslot({ valueAs: 'utc' })`
+ * gave ISO strings from one tag and Temporal objects from the one beside it.
+ * Worse, their `writeValue` was typed as if a form could only ever contain
+ * the library's own objects, and threw on the ISO string a real back end
+ * sends.
+ */
+interface MomentPair<T> {
+    readonly start: T | null;
+    readonly end: T | null;
+}
+/** Whatever the form holds, as two moments. */
+declare function pairIn(value: unknown): MomentPair<Instant>;
+/** And back out, in the shape the application asked for. */
+declare function pairOut<Extra extends object>(pair: MomentPair<Instant>, shape: ValueShape, extra: Extra): Extra & {
+    start: unknown;
+    end: unknown;
+};
+
 /**
  * `<tz-calendar>` — the calendar from @tzslot/dom, spoken in Angular.
  *
@@ -69,10 +149,13 @@ declare function provideTzslotMessages(messages: TzslotMessages): {
  * into `valueChange` and form notifications, projected content into icons.
  */
 declare class Calendar implements ControlValueAccessor, AfterViewInit, OnDestroy {
+    /** Set once for the application with provideTzslot(); a binding still wins. */
+    private readonly defaults;
     /** The selected day. Two-way: `[(value)]`. */
     readonly value: _angular_core.ModelSignal<temporal_spec.Temporal.PlainDate | null>;
     /** Monday by default, as ISO-8601 numbers the week. */
-    readonly firstDayOfWeek: _angular_core.InputSignal<Weekday>;
+    /** Left out, the locale decides — see `provideTzslot` to settle it once. */
+    readonly firstDayOfWeek: _angular_core.InputSignal<Weekday | undefined>;
     /** A BCP-47 tag for the month and weekday names. Defaults to the browser's. */
     readonly locale: _angular_core.InputSignal<string | undefined>;
     readonly min: _angular_core.InputSignal<temporal_spec.Temporal.PlainDate | null>;
@@ -103,6 +186,8 @@ declare class Calendar implements ControlValueAccessor, AfterViewInit, OnDestroy
     readonly minView: _angular_core.InputSignal<CalendarView>;
     /** Adds to each day: a price, places left, a class, a reason to rule it out. */
     readonly renderCell: _angular_core.InputSignal<RenderCell | undefined>;
+    /** A column of ISO week numbers down the left. */
+    readonly weekNumbers: _angular_core.InputSignal<boolean>;
     /** Buttons under the grid: `['today', 'clear']`. None by default. */
     readonly buttons: _angular_core.InputSignal<readonly CalendarButton[]>;
     private readonly host;
@@ -134,7 +219,7 @@ declare class Calendar implements ControlValueAccessor, AfterViewInit, OnDestroy
     registerOnTouched(fn: () => void): void;
     setDisabledState(isDisabled: boolean): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<Calendar, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<Calendar, "tz-calendar", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "firstDayOfWeek": { "alias": "firstDayOfWeek"; "required": false; "isSignal": true; }; "locale": { "alias": "locale"; "required": false; "isSignal": true; }; "min": { "alias": "min"; "required": false; "isSignal": true; }; "max": { "alias": "max"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "valueAs": { "alias": "valueAs"; "required": false; "isSignal": true; }; "valueTimeZone": { "alias": "valueTimeZone"; "required": false; "isSignal": true; }; "isDateDisabled": { "alias": "isDateDisabled"; "required": false; "isSignal": true; }; "today": { "alias": "today"; "required": false; "isSignal": true; }; "view": { "alias": "view"; "required": false; "isSignal": true; }; "minView": { "alias": "minView"; "required": false; "isSignal": true; }; "renderCell": { "alias": "renderCell"; "required": false; "isSignal": true; }; "buttons": { "alias": "buttons"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; "view": "viewChange"; }, never, ["[tzPrev]", "[tzNext]"], true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<Calendar, "tz-calendar", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "firstDayOfWeek": { "alias": "firstDayOfWeek"; "required": false; "isSignal": true; }; "locale": { "alias": "locale"; "required": false; "isSignal": true; }; "min": { "alias": "min"; "required": false; "isSignal": true; }; "max": { "alias": "max"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "valueAs": { "alias": "valueAs"; "required": false; "isSignal": true; }; "valueTimeZone": { "alias": "valueTimeZone"; "required": false; "isSignal": true; }; "isDateDisabled": { "alias": "isDateDisabled"; "required": false; "isSignal": true; }; "today": { "alias": "today"; "required": false; "isSignal": true; }; "view": { "alias": "view"; "required": false; "isSignal": true; }; "minView": { "alias": "minView"; "required": false; "isSignal": true; }; "renderCell": { "alias": "renderCell"; "required": false; "isSignal": true; }; "weekNumbers": { "alias": "weekNumbers"; "required": false; "isSignal": true; }; "buttons": { "alias": "buttons"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; "view": "viewChange"; }, never, ["[tzPrev]", "[tzNext]"], true, never>;
 }
 
 /**
@@ -146,12 +231,15 @@ declare class Calendar implements ControlValueAccessor, AfterViewInit, OnDestroy
  * `[tzIcon]` to the field's icon.
  */
 declare class DateField implements ControlValueAccessor, AfterViewInit {
+    /** Set once for the application with provideTzslot(); a binding still wins. */
+    private readonly defaults;
     readonly value: _angular_core.ModelSignal<temporal_spec.Temporal.PlainDate | null>;
     readonly mode: _angular_core.InputSignal<FieldMode>;
     readonly placeholder: _angular_core.InputSignal<string | undefined>;
     readonly ariaLabel: _angular_core.InputSignal<string | undefined>;
     readonly locale: _angular_core.InputSignal<string | undefined>;
-    readonly firstDayOfWeek: _angular_core.InputSignal<Weekday>;
+    /** Left out, the locale decides — see `provideTzslot` to settle it once. */
+    readonly firstDayOfWeek: _angular_core.InputSignal<Weekday | undefined>;
     readonly min: _angular_core.InputSignal<temporal_spec.Temporal.PlainDate | null>;
     readonly max: _angular_core.InputSignal<temporal_spec.Temporal.PlainDate | null>;
     readonly isDateDisabled: _angular_core.InputSignal<((date: PlainDate) => boolean) | undefined>;
@@ -172,6 +260,8 @@ declare class DateField implements ControlValueAccessor, AfterViewInit {
     readonly displayWith: _angular_core.InputSignal<((date: PlainDate) => string) | undefined>;
     /** Passed to the calendar in the panel. */
     readonly renderCell: _angular_core.InputSignal<RenderCell | undefined>;
+    /** A column of ISO week numbers down the left. */
+    readonly weekNumbers: _angular_core.InputSignal<boolean>;
     /** Under the panel's grid: `['today', 'clear']`. Choosing either closes it. */
     readonly buttons: _angular_core.InputSignal<readonly CalendarButton[]>;
     readonly opened: _angular_core.OutputEmitterRef<void>;
@@ -179,6 +269,8 @@ declare class DateField implements ControlValueAccessor, AfterViewInit {
     /** Whether the panel is showing. Readable from a ViewChild. */
     readonly isOpen: _angular_core.WritableSignal<boolean>;
     protected readonly formDisabled: _angular_core.WritableSignal<boolean>;
+    /** Set while the component is being destroyed, so no output fires after it. */
+    private gone;
     private readonly host;
     private readonly messages;
     private readonly iconSlot;
@@ -203,13 +295,272 @@ declare class DateField implements ControlValueAccessor, AfterViewInit {
     registerOnTouched(fn: () => void): void;
     setDisabledState(isDisabled: boolean): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<DateField, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<DateField, "tz-date-field", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "mode": { "alias": "mode"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "locale": { "alias": "locale"; "required": false; "isSignal": true; }; "firstDayOfWeek": { "alias": "firstDayOfWeek"; "required": false; "isSignal": true; }; "min": { "alias": "min"; "required": false; "isSignal": true; }; "max": { "alias": "max"; "required": false; "isSignal": true; }; "isDateDisabled": { "alias": "isDateDisabled"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "valueAs": { "alias": "valueAs"; "required": false; "isSignal": true; }; "valueTimeZone": { "alias": "valueTimeZone"; "required": false; "isSignal": true; }; "displayWith": { "alias": "displayWith"; "required": false; "isSignal": true; }; "renderCell": { "alias": "renderCell"; "required": false; "isSignal": true; }; "buttons": { "alias": "buttons"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; "opened": "opened"; "closed": "closed"; }, never, ["[tzIcon]"], true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<DateField, "tz-date-field", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "mode": { "alias": "mode"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "locale": { "alias": "locale"; "required": false; "isSignal": true; }; "firstDayOfWeek": { "alias": "firstDayOfWeek"; "required": false; "isSignal": true; }; "min": { "alias": "min"; "required": false; "isSignal": true; }; "max": { "alias": "max"; "required": false; "isSignal": true; }; "isDateDisabled": { "alias": "isDateDisabled"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "valueAs": { "alias": "valueAs"; "required": false; "isSignal": true; }; "valueTimeZone": { "alias": "valueTimeZone"; "required": false; "isSignal": true; }; "displayWith": { "alias": "displayWith"; "required": false; "isSignal": true; }; "renderCell": { "alias": "renderCell"; "required": false; "isSignal": true; }; "weekNumbers": { "alias": "weekNumbers"; "required": false; "isSignal": true; }; "buttons": { "alias": "buttons"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; "opened": "opened"; "closed": "closed"; }, never, ["[tzIcon]"], true, never>;
+}
+
+/**
+ * `<tz-datetime-field>` — a field that opens a calendar and a time, from
+ * @tzslot/dom, spoken in Angular.
+ *
+ * Its value is an Instant, so it says which moment was meant even when the
+ * clock face does not: a time the zone skips is moved on and explained, and
+ * one that happens twice is offered by its two offsets rather than guessed.
+ */
+declare class DateTimeField implements ControlValueAccessor, AfterViewInit {
+    /** Set once for the application with provideTzslot(); a binding still wins. */
+    private readonly defaults;
+    readonly value: _angular_core.ModelSignal<temporal_spec.Temporal.Instant | null>;
+    /**
+     * An IANA identifier. Required in spirit: given here, it wins; left out, it
+     * is the zone provideTzslot() settled for the application, and only when
+     * nothing was settled anywhere does it fall back to the browser's — which
+     * is a guess, and the one thing this library exists not to do silently.
+     */
+    readonly timeZone: _angular_core.InputSignal<string>;
+    readonly mode: _angular_core.InputSignal<FieldMode>;
+    readonly placeholder: _angular_core.InputSignal<string | undefined>;
+    readonly ariaLabel: _angular_core.InputSignal<string | undefined>;
+    readonly locale: _angular_core.InputSignal<string | undefined>;
+    /** Left out, the locale decides — see `provideTzslot` to settle it once. */
+    readonly firstDayOfWeek: _angular_core.InputSignal<Weekday | undefined>;
+    readonly min: _angular_core.InputSignal<temporal_spec.Temporal.PlainDate | null>;
+    readonly max: _angular_core.InputSignal<temporal_spec.Temporal.PlainDate | null>;
+    readonly isDateDisabled: _angular_core.InputSignal<((date: PlainDate) => boolean) | undefined>;
+    /** 'input' (default) for a compact time field, 'list' for the day's times. */
+    /**
+     * Whether a time is asked for at all. False leaves a field that chooses a
+     * day and holds the moment it starts.
+     */
+    readonly showTime: _angular_core.InputSignal<boolean>;
+    readonly timeLayout: _angular_core.InputSignal<TimeLayout>;
+    /**
+     * Move a typed time to the nearest mark of this grid — 15 for quarter-hour
+     * appointments, ties upward. Off by default: a screen that accepts any
+     * minute must not have them quietly moved.
+     */
+    readonly snapMinutes: _angular_core.InputSignal<number | null>;
+    /**
+     * Arrows beside the field that step the chosen moment without opening the
+     * panel: `{ hours: 1 }`, `{ days: 1 }`. `false` — the default — draws none.
+     * Counted on the zone's clocks, so a day is 23 or 25 hours when they change.
+     */
+    readonly shift: _angular_core.InputSignal<false | DurationLike | readonly ShiftOption[]>;
+    readonly stepMinutes: _angular_core.InputSignal<number>;
+    /** With timeLayout 'select': minutes between the options. Every minute by default. */
+    readonly minuteStep: _angular_core.InputSignal<number>;
+    readonly minTime: _angular_core.InputSignal<string | temporal_spec.Temporal.PlainTime | undefined>;
+    readonly maxTime: _angular_core.InputSignal<string | temporal_spec.Temporal.PlainTime | undefined>;
+    /** Only with timeLayout 'list': rules out slots while still showing them. */
+    readonly isSlotDisabled: _angular_core.InputSignal<((slot: Omit<Slot, "disabled">) => boolean) | undefined>;
+    readonly hour12: _angular_core.InputSignal<boolean | undefined>;
+    /** The time a newly chosen day starts at. Midnight by default. */
+    readonly defaultTime: _angular_core.InputSignal<string | temporal_spec.Temporal.PlainTime>;
+    readonly disabled: _angular_core.InputSignal<boolean>;
+    /** The text can be typed as well as chosen. On by default. */
+    readonly editable: _angular_core.InputSignal<boolean>;
+    /** Separators appear as the figures are typed, like a card number. On by default. */
+    readonly mask: _angular_core.InputSignal<boolean>;
+    /** A pattern — `yyyy-MM-dd HH:mm` — when the shape matters more than the reader. */
+    readonly format: _angular_core.InputSignal<string | undefined>;
+    /** Used when the field is not typable and no pattern is given. */
+    readonly dateStyle: _angular_core.InputSignal<"full" | "long" | "medium" | "short">;
+    readonly timeStyle: _angular_core.InputSignal<"full" | "long" | "medium" | "short">;
+    /** The last word on the text. Given both, this one wins. */
+    readonly displayWith: _angular_core.InputSignal<((value: Instant, timeZone: string) => string) | undefined>;
+    readonly today: _angular_core.InputSignal<temporal_spec.Temporal.PlainDate>;
+    readonly renderCell: _angular_core.InputSignal<RenderCell | undefined>;
+    /** A column of ISO week numbers down the left. */
+    readonly weekNumbers: _angular_core.InputSignal<boolean>;
+    readonly buttons: _angular_core.InputSignal<readonly CalendarButton[]>;
+    /** What the form control holds: a Temporal Instant, a Date, or an ISO string. */
+    readonly valueAs: _angular_core.InputSignal<ValueShape>;
+    readonly opened: _angular_core.OutputEmitterRef<void>;
+    readonly closed: _angular_core.OutputEmitterRef<void>;
+    /** Whether the panel is showing. Readable from a ViewChild. */
+    readonly isOpen: _angular_core.WritableSignal<boolean>;
+    protected readonly formDisabled: _angular_core.WritableSignal<boolean>;
+    /** Set while the component is being destroyed, so no output fires after it. */
+    private gone;
+    private readonly host;
+    private readonly messages;
+    private readonly iconSlot;
+    private readonly settings;
+    /** Created before the required timeZone is bound; the first change detection fills it in. */
+    private readonly field;
+    constructor();
+    ngAfterViewInit(): void;
+    toggle(): void;
+    /** No-op when already open. */
+    open(): void;
+    close(): void;
+    /** Clears the selection and tells any form control about it. */
+    clear(): void;
+    private onChange;
+    private onTouched;
+    writeValue(value: InstantLike | null): void;
+    registerOnChange(fn: (value: unknown) => void): void;
+    registerOnTouched(fn: () => void): void;
+    setDisabledState(isDisabled: boolean): void;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<DateTimeField, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<DateTimeField, "tz-datetime-field", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "timeZone": { "alias": "timeZone"; "required": false; "isSignal": true; }; "mode": { "alias": "mode"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "locale": { "alias": "locale"; "required": false; "isSignal": true; }; "firstDayOfWeek": { "alias": "firstDayOfWeek"; "required": false; "isSignal": true; }; "min": { "alias": "min"; "required": false; "isSignal": true; }; "max": { "alias": "max"; "required": false; "isSignal": true; }; "isDateDisabled": { "alias": "isDateDisabled"; "required": false; "isSignal": true; }; "showTime": { "alias": "showTime"; "required": false; "isSignal": true; }; "timeLayout": { "alias": "timeLayout"; "required": false; "isSignal": true; }; "snapMinutes": { "alias": "snapMinutes"; "required": false; "isSignal": true; }; "shift": { "alias": "shift"; "required": false; "isSignal": true; }; "stepMinutes": { "alias": "stepMinutes"; "required": false; "isSignal": true; }; "minuteStep": { "alias": "minuteStep"; "required": false; "isSignal": true; }; "minTime": { "alias": "minTime"; "required": false; "isSignal": true; }; "maxTime": { "alias": "maxTime"; "required": false; "isSignal": true; }; "isSlotDisabled": { "alias": "isSlotDisabled"; "required": false; "isSignal": true; }; "hour12": { "alias": "hour12"; "required": false; "isSignal": true; }; "defaultTime": { "alias": "defaultTime"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "editable": { "alias": "editable"; "required": false; "isSignal": true; }; "mask": { "alias": "mask"; "required": false; "isSignal": true; }; "format": { "alias": "format"; "required": false; "isSignal": true; }; "dateStyle": { "alias": "dateStyle"; "required": false; "isSignal": true; }; "timeStyle": { "alias": "timeStyle"; "required": false; "isSignal": true; }; "displayWith": { "alias": "displayWith"; "required": false; "isSignal": true; }; "today": { "alias": "today"; "required": false; "isSignal": true; }; "renderCell": { "alias": "renderCell"; "required": false; "isSignal": true; }; "weekNumbers": { "alias": "weekNumbers"; "required": false; "isSignal": true; }; "buttons": { "alias": "buttons"; "required": false; "isSignal": true; }; "valueAs": { "alias": "valueAs"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; "opened": "opened"; "closed": "closed"; }, never, ["[tzIcon]"], true, never>;
+}
+
+/**
+ * `<tz-range-field>` — one field for a period, from @tzslot/dom, spoken in
+ * Angular. Named ranges beside the calendar, months side by side, and whole
+ * days or moments.
+ */
+declare class RangeField implements ControlValueAccessor {
+    /** Set once for the application with provideTzslot(); a binding still wins. */
+    private readonly defaults;
+    readonly value: _angular_core.ModelSignal<RangeFieldValue>;
+    /**
+     * What the form control holds. `'utc'` gives two ISO strings; the default
+     * gives the library's own moments. Settled for a whole application with
+     * provideTzslot(), which documents it as applying to every component — and
+     * this one did not listen.
+     */
+    readonly valueAs: _angular_core.InputSignal<ValueShape>;
+    /**
+     * An IANA identifier. Required in spirit: given here, it wins; left out, it
+     * is the zone provideTzslot() settled for the application, and only when
+     * nothing was settled anywhere does it fall back to the browser's — which
+     * is a guess, and the one thing this library exists not to do silently.
+     */
+    readonly timeZone: _angular_core.InputSignal<string>;
+    /** Named ranges beside the calendar: the built-in names, or your own. */
+    readonly presets: _angular_core.InputSignal<readonly (PresetName | RangePreset)[]>;
+    /**
+     * Lets a period stop at one end — "from 14 September", "until the 20th".
+     * The panel then offers Between / From / Until, and each chosen end can be
+     * dropped with the cross beside it. Off by default: a booking form must not
+     * accept a period with no end.
+     */
+    readonly openEnded: _angular_core.InputSignal<boolean>;
+    /** A word or two saying what is being chosen — "Travel dates". */
+    readonly title: _angular_core.InputSignal<string | undefined>;
+    /** How an hour is asked for: two menus (default), or figures with arrows. */
+    readonly timeLayout: _angular_core.InputSignal<"input" | "select">;
+    /**
+     * Whether the period carries times as well as days — the screen's decision,
+     * not the reader's. There is no "all day" switch: on, every chosen day
+     * starts at `defaultTimes`.
+     */
+    readonly showTime: _angular_core.InputSignal<boolean>;
+    /**
+     * The hours a newly chosen day is given: midnight unless the screen knows
+     * better — `{ start: '09:00', end: '18:00' }` for a working day. A value
+     * handed to the field keeps its own hours.
+     */
+    readonly defaultTimes: _angular_core.InputSignal<{
+        start?: PlainTime | string;
+        end?: PlainTime | string;
+    }>;
+    readonly stepMinutes: _angular_core.InputSignal<number>;
+    /**
+     * Move a time typed by hand to the nearest mark of this grid — 15 for
+     * quarter-hour appointments, ties upward. Off by default.
+     */
+    readonly snapMinutes: _angular_core.InputSignal<number | null>;
+    /**
+     * How long the period may be, and how short — `'30d'`, `{ hours: 2 }`.
+     * Moving one end pushes the other rather than refusing the move.
+     */
+    readonly maxSpan: _angular_core.InputSignal<DurationLike | null>;
+    readonly minSpan: _angular_core.InputSignal<DurationLike | null>;
+    /** Minutes between the options of the hour menu. Five by default. */
+    readonly minuteStep: _angular_core.InputSignal<number>;
+    /** Nothing is reported until Apply is pressed. */
+    readonly confirm: _angular_core.InputSignal<boolean>;
+    /**
+     * Arrows that step the whole period without opening the panel. `false` —
+     * the default — draws none. `'auto'` moves by what is selected; a duration
+     * such as `{ months: 3 }` imposes the step.
+     */
+    readonly shift: _angular_core.InputSignal<false | readonly ShiftOption[] | ShiftStep>;
+    readonly months: _angular_core.InputSignal<number>;
+    readonly weekNumbers: _angular_core.InputSignal<boolean>;
+    /** Left out, the locale decides — see `provideTzslot` to settle it once. */
+    readonly firstDayOfWeek: _angular_core.InputSignal<Weekday | undefined>;
+    readonly mode: _angular_core.InputSignal<FieldMode>;
+    readonly placeholder: _angular_core.InputSignal<string | undefined>;
+    readonly ariaLabel: _angular_core.InputSignal<string | undefined>;
+    readonly locale: _angular_core.InputSignal<string | undefined>;
+    readonly min: _angular_core.InputSignal<temporal_spec.Temporal.PlainDate | null>;
+    readonly max: _angular_core.InputSignal<temporal_spec.Temporal.PlainDate | null>;
+    readonly isDateDisabled: _angular_core.InputSignal<((date: PlainDate) => boolean) | undefined>;
+    readonly renderCell: _angular_core.InputSignal<RenderCell | undefined>;
+    readonly today: _angular_core.InputSignal<temporal_spec.Temporal.PlainDate>;
+    /** The moment the shortcuts shorter than a day are counted from. The clock by default. */
+    readonly now: _angular_core.InputSignal<temporal_spec.Temporal.Instant | null>;
+    /**
+     * The whole field, or one end of it: `{ end: true }` for a period whose end
+     * the screen works out itself. A locked end is read-only rather than
+     * disabled — still readable, still reachable by the keyboard.
+     */
+    readonly disabled: _angular_core.InputSignal<boolean | {
+        start?: boolean;
+        end?: boolean;
+    }>;
+    /** A pattern for each end — `yyyy-MM-dd`. */
+    readonly format: _angular_core.InputSignal<string | undefined>;
+    /**
+     * What is written above the panel's two fields, and between them. Words by
+     * default; `{ start: null, end: null, between: '»' }` for a screen that
+     * prefers a mark. A DOM node is taken as it is.
+     */
+    /**
+     * The mark inside the panel's two fields — a calendar by default, `null`
+     * for none, or a node of your own.
+     */
+    readonly fieldIcon: _angular_core.InputSignal<string | Node | null | undefined>;
+    readonly fieldIconSide: _angular_core.InputSignal<"start" | "end">;
+    readonly labels: _angular_core.InputSignal<{
+        start?: Node | string | null;
+        end?: Node | string | null;
+        between?: Node | string | null;
+    }>;
+    /** Separators appear as figures are typed in those fields. */
+    readonly mask: _angular_core.InputSignal<boolean>;
+    readonly displayWith: _angular_core.InputSignal<((value: RangeFieldValue, timeZone: string) => string) | undefined>;
+    readonly opened: _angular_core.OutputEmitterRef<void>;
+    readonly closed: _angular_core.OutputEmitterRef<void>;
+    /** Whether the panel is showing. Readable from a ViewChild. */
+    readonly isOpen: _angular_core.WritableSignal<boolean>;
+    protected readonly formDisabled: _angular_core.WritableSignal<boolean>;
+    private gone;
+    private readonly messages;
+    private readonly settings;
+    /** Created before the required timeZone is bound; the first change detection fills it in. */
+    private readonly field;
+    constructor();
+    open(): void;
+    close(): void;
+    toggle(): void;
+    /** Empties the period and tells any form control about it. */
+    clear(): void;
+    private onChange;
+    private onTouched;
+    /**
+     * Typed `unknown` because that is what a form control holds: a string from
+     * a back end, a Date from older code, or the library's own objects. It was
+     * typed `RangeFieldValue | null` and threw on the first of those.
+     */
+    writeValue(value: unknown): void;
+    registerOnChange(fn: (value: unknown) => void): void;
+    registerOnTouched(fn: () => void): void;
+    setDisabledState(isDisabled: boolean): void;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<RangeField, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<RangeField, "tz-range-field", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "valueAs": { "alias": "valueAs"; "required": false; "isSignal": true; }; "timeZone": { "alias": "timeZone"; "required": false; "isSignal": true; }; "presets": { "alias": "presets"; "required": false; "isSignal": true; }; "openEnded": { "alias": "openEnded"; "required": false; "isSignal": true; }; "title": { "alias": "title"; "required": false; "isSignal": true; }; "timeLayout": { "alias": "timeLayout"; "required": false; "isSignal": true; }; "showTime": { "alias": "showTime"; "required": false; "isSignal": true; }; "defaultTimes": { "alias": "defaultTimes"; "required": false; "isSignal": true; }; "stepMinutes": { "alias": "stepMinutes"; "required": false; "isSignal": true; }; "snapMinutes": { "alias": "snapMinutes"; "required": false; "isSignal": true; }; "maxSpan": { "alias": "maxSpan"; "required": false; "isSignal": true; }; "minSpan": { "alias": "minSpan"; "required": false; "isSignal": true; }; "minuteStep": { "alias": "minuteStep"; "required": false; "isSignal": true; }; "confirm": { "alias": "confirm"; "required": false; "isSignal": true; }; "shift": { "alias": "shift"; "required": false; "isSignal": true; }; "months": { "alias": "months"; "required": false; "isSignal": true; }; "weekNumbers": { "alias": "weekNumbers"; "required": false; "isSignal": true; }; "firstDayOfWeek": { "alias": "firstDayOfWeek"; "required": false; "isSignal": true; }; "mode": { "alias": "mode"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "locale": { "alias": "locale"; "required": false; "isSignal": true; }; "min": { "alias": "min"; "required": false; "isSignal": true; }; "max": { "alias": "max"; "required": false; "isSignal": true; }; "isDateDisabled": { "alias": "isDateDisabled"; "required": false; "isSignal": true; }; "renderCell": { "alias": "renderCell"; "required": false; "isSignal": true; }; "today": { "alias": "today"; "required": false; "isSignal": true; }; "now": { "alias": "now"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "format": { "alias": "format"; "required": false; "isSignal": true; }; "fieldIcon": { "alias": "fieldIcon"; "required": false; "isSignal": true; }; "fieldIconSide": { "alias": "fieldIconSide"; "required": false; "isSignal": true; }; "labels": { "alias": "labels"; "required": false; "isSignal": true; }; "mask": { "alias": "mask"; "required": false; "isSignal": true; }; "displayWith": { "alias": "displayWith"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; "opened": "opened"; "closed": "closed"; }, never, never, true, never>;
 }
 
 /** `<tz-date-range>` — the range from @tzslot/dom, spoken in Angular. */
 declare class DateRange implements ControlValueAccessor, AfterViewInit {
+    /** Set once for the application with provideTzslot(); a binding still wins. */
+    private readonly defaults;
     readonly value: _angular_core.ModelSignal<DateRangeValue>;
-    readonly firstDayOfWeek: _angular_core.InputSignal<Weekday>;
+    /** Left out, the locale decides — see `provideTzslot` to settle it once. */
+    readonly firstDayOfWeek: _angular_core.InputSignal<Weekday | undefined>;
     readonly locale: _angular_core.InputSignal<string | undefined>;
     readonly min: _angular_core.InputSignal<temporal_spec.Temporal.PlainDate | null>;
     readonly max: _angular_core.InputSignal<temporal_spec.Temporal.PlainDate | null>;
@@ -218,6 +569,10 @@ declare class DateRange implements ControlValueAccessor, AfterViewInit {
     readonly today: _angular_core.InputSignal<temporal_spec.Temporal.PlainDate>;
     /** Refuse a range that steps over a day isDateDisabled rules out. On by default. */
     readonly blockAcrossDisabled: _angular_core.InputSignal<boolean>;
+    /** A column of ISO week numbers down the left. */
+    readonly weekNumbers: _angular_core.InputSignal<boolean>;
+    /** How many months to show side by side. Two is what most ranges want. */
+    readonly months: _angular_core.InputSignal<number>;
     /** Adds to each day: a price per night, places left, a class of your own. */
     readonly renderCell: _angular_core.InputSignal<RenderCell | undefined>;
     /** Overrides the bundle for this one instance. */
@@ -240,7 +595,7 @@ declare class DateRange implements ControlValueAccessor, AfterViewInit {
     registerOnTouched(fn: () => void): void;
     setDisabledState(isDisabled: boolean): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<DateRange, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<DateRange, "tz-date-range", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "firstDayOfWeek": { "alias": "firstDayOfWeek"; "required": false; "isSignal": true; }; "locale": { "alias": "locale"; "required": false; "isSignal": true; }; "min": { "alias": "min"; "required": false; "isSignal": true; }; "max": { "alias": "max"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "isDateDisabled": { "alias": "isDateDisabled"; "required": false; "isSignal": true; }; "today": { "alias": "today"; "required": false; "isSignal": true; }; "blockAcrossDisabled": { "alias": "blockAcrossDisabled"; "required": false; "isSignal": true; }; "renderCell": { "alias": "renderCell"; "required": false; "isSignal": true; }; "rangeSpansBlockedMessage": { "alias": "rangeSpansBlockedMessage"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; }, never, ["[tzPrev]", "[tzNext]"], true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<DateRange, "tz-date-range", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "firstDayOfWeek": { "alias": "firstDayOfWeek"; "required": false; "isSignal": true; }; "locale": { "alias": "locale"; "required": false; "isSignal": true; }; "min": { "alias": "min"; "required": false; "isSignal": true; }; "max": { "alias": "max"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "isDateDisabled": { "alias": "isDateDisabled"; "required": false; "isSignal": true; }; "today": { "alias": "today"; "required": false; "isSignal": true; }; "blockAcrossDisabled": { "alias": "blockAcrossDisabled"; "required": false; "isSignal": true; }; "weekNumbers": { "alias": "weekNumbers"; "required": false; "isSignal": true; }; "months": { "alias": "months"; "required": false; "isSignal": true; }; "renderCell": { "alias": "renderCell"; "required": false; "isSignal": true; }; "rangeSpansBlockedMessage": { "alias": "rangeSpansBlockedMessage"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; }, never, ["[tzPrev]", "[tzNext]"], true, never>;
 }
 
 /**
@@ -250,9 +605,53 @@ declare class DateRange implements ControlValueAccessor, AfterViewInit {
  * faces the widget says so in words.
  */
 declare class DateTimeRange implements ControlValueAccessor {
+    /** Set once for the application with provideTzslot(); a binding still wins. */
+    private readonly defaults;
     readonly value: _angular_core.ModelSignal<DateTimeRangeValue>;
+    /**
+     * An IANA identifier. Required in spirit: given here, it wins; left out, it
+     * is the zone provideTzslot() settled for the application, and only when
+     * nothing was settled anywhere does it fall back to the browser's — which
+     * is a guess, and the one thing this library exists not to do silently.
+     */
     readonly timeZone: _angular_core.InputSignal<string>;
+    /**
+     * Whole days rather than moments. Two-way: the switch inside the widget
+     * sets it, and so can you.
+     */
+    /**
+     * What the form control holds. `'utc'` gives two ISO strings; the default
+     * gives the library's own moments.
+     */
+    readonly valueAs: _angular_core.InputSignal<ValueShape>;
+    readonly allDay: _angular_core.ModelSignal<boolean>;
+    /** Whether that switch is shown at all. */
+    readonly allDaySwitch: _angular_core.InputSignal<boolean>;
+    /**
+     * Lets the interval stop at one end. The summary then says what it means —
+     * "From 14 Sept 2026, 09:00" — instead of going blank, which reads as
+     * nothing chosen. Off by default.
+     */
+    readonly openEnded: _angular_core.InputSignal<boolean>;
+    /** How each end asks for its time: 'input', 'select' or 'list'. */
+    readonly timeLayout: _angular_core.InputSignal<TimeLayout>;
     readonly stepMinutes: _angular_core.InputSignal<number>;
+    /** With 'select': minutes between the options. Every minute by default. */
+    readonly minuteStep: _angular_core.InputSignal<number>;
+    readonly hour12: _angular_core.InputSignal<boolean | undefined>;
+    /** The time a newly chosen day starts at. Midnight by default. */
+    readonly defaultTime: _angular_core.InputSignal<string | temporal_spec.Temporal.PlainTime>;
+    /** Both ends can be typed into as well as chosen from. */
+    readonly editable: _angular_core.InputSignal<boolean>;
+    /** A pattern for both ends — `yyyy-MM-dd HH:mm`. */
+    readonly format: _angular_core.InputSignal<string | undefined>;
+    readonly isDateDisabled: _angular_core.InputSignal<((date: PlainDate) => boolean) | undefined>;
+    /** Which day is today, in both panels. */
+    readonly today: _angular_core.InputSignal<temporal_spec.Temporal.PlainDate>;
+    readonly renderCell: _angular_core.InputSignal<RenderCell | undefined>;
+    /** A column of ISO week numbers down the left. */
+    readonly weekNumbers: _angular_core.InputSignal<boolean>;
+    readonly buttons: _angular_core.InputSignal<readonly CalendarButton[]>;
     readonly minTime: _angular_core.InputSignal<string | undefined>;
     readonly maxTime: _angular_core.InputSignal<string | undefined>;
     readonly isSlotDisabled: _angular_core.InputSignal<((slot: Omit<Slot, "disabled">) => boolean) | undefined>;
@@ -273,12 +672,16 @@ declare class DateTimeRange implements ControlValueAccessor {
     clear(): void;
     private onChange;
     private onTouched;
-    writeValue(value: DateTimeRangeValue | null): void;
-    registerOnChange(fn: (value: DateTimeRangeValue) => void): void;
+    /**
+     * Typed `unknown` because that is what a form control holds: a string from
+     * a back end, a Date from older code, or the library's own objects.
+     */
+    writeValue(value: unknown): void;
+    registerOnChange(fn: (value: unknown) => void): void;
     registerOnTouched(fn: () => void): void;
     setDisabledState(isDisabled: boolean): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<DateTimeRange, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<DateTimeRange, "tz-datetime-range", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "timeZone": { "alias": "timeZone"; "required": true; "isSignal": true; }; "stepMinutes": { "alias": "stepMinutes"; "required": false; "isSignal": true; }; "minTime": { "alias": "minTime"; "required": false; "isSignal": true; }; "maxTime": { "alias": "maxTime"; "required": false; "isSignal": true; }; "isSlotDisabled": { "alias": "isSlotDisabled"; "required": false; "isSignal": true; }; "min": { "alias": "min"; "required": false; "isSignal": true; }; "max": { "alias": "max"; "required": false; "isSignal": true; }; "locale": { "alias": "locale"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "startLabel": { "alias": "startLabel"; "required": false; "isSignal": true; }; "endLabel": { "alias": "endLabel"; "required": false; "isSignal": true; }; "endBeforeStartMessage": { "alias": "endBeforeStartMessage"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; }, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<DateTimeRange, "tz-datetime-range", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "timeZone": { "alias": "timeZone"; "required": false; "isSignal": true; }; "valueAs": { "alias": "valueAs"; "required": false; "isSignal": true; }; "allDay": { "alias": "allDay"; "required": false; "isSignal": true; }; "allDaySwitch": { "alias": "allDaySwitch"; "required": false; "isSignal": true; }; "openEnded": { "alias": "openEnded"; "required": false; "isSignal": true; }; "timeLayout": { "alias": "timeLayout"; "required": false; "isSignal": true; }; "stepMinutes": { "alias": "stepMinutes"; "required": false; "isSignal": true; }; "minuteStep": { "alias": "minuteStep"; "required": false; "isSignal": true; }; "hour12": { "alias": "hour12"; "required": false; "isSignal": true; }; "defaultTime": { "alias": "defaultTime"; "required": false; "isSignal": true; }; "editable": { "alias": "editable"; "required": false; "isSignal": true; }; "format": { "alias": "format"; "required": false; "isSignal": true; }; "isDateDisabled": { "alias": "isDateDisabled"; "required": false; "isSignal": true; }; "today": { "alias": "today"; "required": false; "isSignal": true; }; "renderCell": { "alias": "renderCell"; "required": false; "isSignal": true; }; "weekNumbers": { "alias": "weekNumbers"; "required": false; "isSignal": true; }; "buttons": { "alias": "buttons"; "required": false; "isSignal": true; }; "minTime": { "alias": "minTime"; "required": false; "isSignal": true; }; "maxTime": { "alias": "maxTime"; "required": false; "isSignal": true; }; "isSlotDisabled": { "alias": "isSlotDisabled"; "required": false; "isSignal": true; }; "min": { "alias": "min"; "required": false; "isSignal": true; }; "max": { "alias": "max"; "required": false; "isSignal": true; }; "locale": { "alias": "locale"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "startLabel": { "alias": "startLabel"; "required": false; "isSignal": true; }; "endLabel": { "alias": "endLabel"; "required": false; "isSignal": true; }; "endBeforeStartMessage": { "alias": "endBeforeStartMessage"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; "allDay": "allDayChange"; }, never, never, true, never>;
 }
 
 /**
@@ -286,14 +689,28 @@ declare class DateTimeRange implements ControlValueAccessor {
  * @tzslot/dom, spoken in Angular. "The 3rd to the 7th, 09:00 to 17:00."
  */
 declare class DailyRange implements ControlValueAccessor {
+    /** Set once for the application with provideTzslot(); a binding still wins. */
+    private readonly defaults;
     readonly value: _angular_core.ModelSignal<DailyRangeValue>;
-    /** An IANA identifier. The hours are read on the clocks of this zone. */
+    /**
+     * An IANA identifier. Required in spirit: given here, it wins; left out, it
+     * is the zone provideTzslot() settled for the application, and only when
+     * nothing was settled anywhere does it fall back to the browser's — which
+     * is a guess, and the one thing this library exists not to do silently.
+     */
     readonly timeZone: _angular_core.InputSignal<string>;
     readonly stepMinutes: _angular_core.InputSignal<number>;
+    /** 'input' (default) for two compact fields, 'list' for times to click. */
+    readonly timeLayout: _angular_core.InputSignal<TimeLayout>;
+    /** 12-hour fields with an AM/PM button; the locale decides when unset. */
+    readonly hour12: _angular_core.InputSignal<boolean | undefined>;
+    /** With timeLayout 'columns': minutes between the options. Every minute by default. */
+    readonly minuteStep: _angular_core.InputSignal<number>;
     /** The first and last times offered. */
     readonly minTime: _angular_core.InputSignal<string | undefined>;
     readonly maxTime: _angular_core.InputSignal<string | undefined>;
-    readonly firstDayOfWeek: _angular_core.InputSignal<Weekday>;
+    /** Left out, the locale decides — see `provideTzslot` to settle it once. */
+    readonly firstDayOfWeek: _angular_core.InputSignal<Weekday | undefined>;
     readonly locale: _angular_core.InputSignal<string | undefined>;
     readonly min: _angular_core.InputSignal<temporal_spec.Temporal.PlainDate | null>;
     readonly max: _angular_core.InputSignal<temporal_spec.Temporal.PlainDate | null>;
@@ -313,12 +730,17 @@ declare class DailyRange implements ControlValueAccessor {
     clear(): void;
     private onChange;
     private onTouched;
+    /**
+     * A pattern, not a moment: two days and the clock faces repeated over them.
+     * `valueAs` has nothing to convert here, which is why this component does
+     * not take it — see the note on TzslotDefaults.
+     */
     writeValue(value: DailyRangeValue | null): void;
     registerOnChange(fn: (value: DailyRangeValue) => void): void;
     registerOnTouched(fn: () => void): void;
     setDisabledState(isDisabled: boolean): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<DailyRange, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<DailyRange, "tz-daily-range", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "timeZone": { "alias": "timeZone"; "required": true; "isSignal": true; }; "stepMinutes": { "alias": "stepMinutes"; "required": false; "isSignal": true; }; "minTime": { "alias": "minTime"; "required": false; "isSignal": true; }; "maxTime": { "alias": "maxTime"; "required": false; "isSignal": true; }; "firstDayOfWeek": { "alias": "firstDayOfWeek"; "required": false; "isSignal": true; }; "locale": { "alias": "locale"; "required": false; "isSignal": true; }; "min": { "alias": "min"; "required": false; "isSignal": true; }; "max": { "alias": "max"; "required": false; "isSignal": true; }; "isDateDisabled": { "alias": "isDateDisabled"; "required": false; "isSignal": true; }; "renderCell": { "alias": "renderCell"; "required": false; "isSignal": true; }; "today": { "alias": "today"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; }, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<DailyRange, "tz-daily-range", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "timeZone": { "alias": "timeZone"; "required": false; "isSignal": true; }; "stepMinutes": { "alias": "stepMinutes"; "required": false; "isSignal": true; }; "timeLayout": { "alias": "timeLayout"; "required": false; "isSignal": true; }; "hour12": { "alias": "hour12"; "required": false; "isSignal": true; }; "minuteStep": { "alias": "minuteStep"; "required": false; "isSignal": true; }; "minTime": { "alias": "minTime"; "required": false; "isSignal": true; }; "maxTime": { "alias": "maxTime"; "required": false; "isSignal": true; }; "firstDayOfWeek": { "alias": "firstDayOfWeek"; "required": false; "isSignal": true; }; "locale": { "alias": "locale"; "required": false; "isSignal": true; }; "min": { "alias": "min"; "required": false; "isSignal": true; }; "max": { "alias": "max"; "required": false; "isSignal": true; }; "isDateDisabled": { "alias": "isDateDisabled"; "required": false; "isSignal": true; }; "renderCell": { "alias": "renderCell"; "required": false; "isSignal": true; }; "today": { "alias": "today"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; }, never, never, true, never>;
 }
 
 /**
@@ -326,11 +748,14 @@ declare class DailyRange implements ControlValueAccessor {
  * @tzslot/dom, spoken in Angular. The value is always in date order.
  */
 declare class MultiDate implements ControlValueAccessor, AfterViewInit {
+    /** Set once for the application with provideTzslot(); a binding still wins. */
+    private readonly defaults;
     /** The chosen days, in date order. Two-way: `[(value)]`. */
     readonly value: _angular_core.ModelSignal<readonly temporal_spec.Temporal.PlainDate[]>;
     /** Once this many are chosen, the other days stop taking clicks. */
     readonly maxDates: _angular_core.InputSignal<number | undefined>;
-    readonly firstDayOfWeek: _angular_core.InputSignal<Weekday>;
+    /** Left out, the locale decides — see `provideTzslot` to settle it once. */
+    readonly firstDayOfWeek: _angular_core.InputSignal<Weekday | undefined>;
     readonly locale: _angular_core.InputSignal<string | undefined>;
     readonly min: _angular_core.InputSignal<temporal_spec.Temporal.PlainDate | null>;
     readonly max: _angular_core.InputSignal<temporal_spec.Temporal.PlainDate | null>;
@@ -339,6 +764,8 @@ declare class MultiDate implements ControlValueAccessor, AfterViewInit {
     readonly today: _angular_core.InputSignal<temporal_spec.Temporal.PlainDate>;
     readonly view: _angular_core.ModelSignal<CalendarView>;
     readonly renderCell: _angular_core.InputSignal<RenderCell | undefined>;
+    /** A column of ISO week numbers down the left. */
+    readonly weekNumbers: _angular_core.InputSignal<boolean>;
     readonly buttons: _angular_core.InputSignal<readonly CalendarButton[]>;
     /** What the form control holds, each day as a Temporal date, a Date, or an ISO string. */
     readonly valueAs: _angular_core.InputSignal<ValueShape>;
@@ -364,7 +791,8 @@ declare class MultiDate implements ControlValueAccessor, AfterViewInit {
     registerOnTouched(fn: () => void): void;
     setDisabledState(isDisabled: boolean): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<MultiDate, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<MultiDate, "tz-multi-date", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "maxDates": { "alias": "maxDates"; "required": false; "isSignal": true; }; "firstDayOfWeek": { "alias": "firstDayOfWeek"; "required": false; "isSignal": true; }; "locale": { "alias": "locale"; "required": false; "isSignal": true; }; "min": { "alias": "min"; "required": false; "isSignal": true; }; "max": { "alias": "max"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "isDateDisabled": { "alias": "isDateDisabled"; "required": false; "isSignal": true; }; "today": { "alias": "today"; "required": false; "isSignal": true; }; "view": { "alias": "view"; "required": false; "isSignal": true; }; "renderCell": { "alias": "renderCell"; "required": false; "isSignal": true; }; "buttons": { "alias": "buttons"; "required": false; "isSignal": true; }; "valueAs": { "alias": "valueAs"; "required": false; "isSignal": true; }; "valueTimeZone": { "alias": "valueTimeZone"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; "view": "viewChange"; }, never, ["[tzPrev]", "[tzNext]"], true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<MultiDate, "tz-multi-date", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "maxDates": { "alias": "maxDates"; "required": false; "isSignal": true; }; "firstDayOfWeek": { "alias": "firstDayOfWeek"; "required": false; "isSignal": true; }; "locale": { "alias": "locale"; "required": false; "isSignal": true; }; "min": { "alias": "min"; "required": false; "isSignal": true; }; "max": { "alias": "max"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "isDateDisabled": { "alias": "isDateDisabled"; "required": false; "isSignal": true; }; "today": { "alias": "today"; "required": false; "isSignal": true; }; "view": { "alias": "view"; "required": false; "isSignal": true; }; "renderCell": { "alias": "renderCell"; "required": false; "isSignal": true; }; "weekNumbers": { "alias": "weekNumbers"; "required": false; "isSignal": true; }; "buttons": { "alias": "buttons"; "required": false; "isSignal": true; }; "valueAs": { "alias": "valueAs"; "required": false; "isSignal": true; }; "valueTimeZone": { "alias": "valueTimeZone"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; "view": "viewChange"; }, never, ["[tzPrev]", "[tzNext]"], true, never>;
 }
 
-export { Calendar, DailyRange, DateField, DateRange, DateTimeRange, MultiDate, TZSLOT_MESSAGES, TimeSlotPicker, provideTzslotMessages };
+export { Calendar, DailyRange, DateField, DateRange, DateTimeField, DateTimeRange, MultiDate, RangeField, TZSLOT_DEFAULTS, TZSLOT_MESSAGES, TimeSlotPicker, pairIn, pairOut, provideTzslot, provideTzslotMessages };
+export type { MomentPair, TzslotDefaults };