@sectile/dom 0.4.0 → 0.6.0

package/README.md

@@ -13,6 +13,14 @@ DOM bindings for Sectile interaction semantics.
 
 The package does not provide markup, components, styles, themes, or application data. Consumers choose the rendered structure and bind it to a Sectile connection.
 
+## Virtualization
+
+`@sectile/dom/virtual` connects the renderer-neutral `@sectile/virtual` strategies
+to a scroll element. It coalesces scroll and resize work per animation frame,
+batches item measurements, applies anchor correction before publishing the next
+plan, and exposes manual measurement and mutation operations for track grids and
+other non-linear layouts. Content and item style helpers remain opt-in.
+
 ## Floating surface positioning
 
 Popover and tooltip placement use Floating UI. Offset, collision flip and shift, available-size data, arrow positioning, detached-anchor hiding, and open-only automatic updates are enabled by default. Boundaries, padding, strategy, update observers, and the middleware queue remain configurable. Floating UI middleware is re-exported from both component entry points for custom positioning.

package/dist/calendar.d.ts

@@ -1,98 +1,48 @@
 import { type FacadeConnection } from '@sectile/core/adapter-runtime';
-import type { Result, StableID } from '@sectile/core';
-import { type CalendarCommand, type CalendarEvent, type CalendarPolicies, type CalendarState } from '@sectile/core/calendar';
-export type { CalendarPolicies } from '@sectile/core/calendar';
-import { type Grid } from '@sectile/core/grid';
-import { type RevisionResult, type RevisionSnapshot } from '@sectile/core/revision';
-export interface KeyboardInput {
-    readonly key: string;
-    readonly altKey?: boolean;
-    readonly ctrlKey?: boolean;
-    readonly metaKey?: boolean;
-}
-export type CalendarEffect<ID extends StableID = StableID> = {
-    readonly type: 'focus-element';
-    readonly id: ID;
-} | {
-    readonly type: 'request-page';
-    readonly direction: -1 | 1;
-    readonly from: ID | null;
-};
-export interface CalendarValueChangeDetails<ID extends StableID = StableID> {
-    readonly value: ID | null;
-    readonly previousValue: ID | null;
-}
-export interface CalendarHighlightChangeDetails<ID extends StableID = StableID> {
-    readonly value: ID | null;
-    readonly previousValue: ID | null;
-}
-export interface CalendarControllerOptions<ID extends StableID = StableID> {
-    readonly grid: Grid<ID>;
-    readonly disabled?: boolean;
-    readonly policies?: CalendarPolicies<ID>;
-    readonly value?: ID | null;
-    readonly defaultValue?: ID | null;
-    readonly highlightedValue?: ID | null;
-    readonly defaultHighlightedValue?: ID | null;
-    readonly onValueChange?: (change: CalendarValueChangeDetails<ID>) => void;
-    readonly onHighlightedValueChange?: (change: CalendarHighlightChangeDetails<ID>) => void;
-}
-export type CalendarControllerValueChangeHandler<ID extends StableID = StableID> = NonNullable<CalendarControllerOptions<ID>['onValueChange']>;
-export type CalendarControllerHighlightedValueChangeHandler<ID extends StableID = StableID> = NonNullable<CalendarControllerOptions<ID>['onHighlightedValueChange']>;
-export interface CalendarControlledValues<ID extends StableID = StableID> {
-    readonly value?: ID | null;
-    readonly highlightedValue?: ID | null;
-}
-export interface CalendarController<ID extends StableID = StableID> {
-    readonly grid: Grid<ID>;
-    getSnapshot(): RevisionSnapshot<CalendarState<ID>>;
-    syncControlledValues(values: CalendarControlledValues<ID>): Result<RevisionSnapshot<CalendarState<ID>>>;
-    handleKeyboardInput(input: KeyboardInput, expectedRevision?: number): RevisionResult<CalendarState<ID>, CalendarEffect<ID>>;
-    handleEvent(event: CalendarEvent<ID>, expectedRevision?: number): RevisionResult<CalendarState<ID>, CalendarEffect<ID>>;
-}
-export interface CalendarPageRequestDetails<ID extends StableID = StableID> {
-    readonly direction: -1 | 1;
-    readonly from: ID | null;
-}
-export interface CalendarTransitionDetails<ID extends StableID = StableID> {
-    readonly event: CalendarEvent<ID>;
-    readonly result: RevisionResult<CalendarState<ID>, CalendarEffect<ID>>;
-}
-export interface CalendarConnectionOptions<ID extends StableID = StableID> {
-    readonly controller: CalendarController<ID>;
+import { type DOMTemporalResult } from './internal/result.js';
+import type { RevisionSnapshot } from '@sectile/core/revision';
+import { type CalendarEvent, type CalendarMonthValue, type CalendarPolicies, type CalendarState } from '@sectile/temporal/calendar';
+import { type DateValue } from '@sectile/temporal/date-field';
+export type { CalendarCommand, CalendarEvent, CalendarMonthValue, CalendarPolicies, CalendarState, CalendarView, CalendarViewMode, } from '@sectile/temporal/calendar';
+export type { DateValue } from '@sectile/temporal/date-field';
+export interface CalendarOptions {
     readonly root: HTMLElement;
+    readonly grid?: HTMLElement;
+    readonly policies?: CalendarPolicies;
+    readonly value?: DateValue | null;
+    readonly defaultValue?: DateValue | null;
+    readonly highlightedValue?: DateValue;
+    readonly defaultHighlightedValue?: DateValue;
+    readonly referenceDate?: DateValue;
     readonly disabled?: boolean;
-    readonly onPageRequest?: (details: CalendarPageRequestDetails<ID>) => void;
-    readonly onTransition?: (details: CalendarTransitionDetails<ID>) => void;
+    readonly readOnly?: boolean;
+    readonly required?: boolean;
+    readonly label?: string;
+    readonly onValueChange?: (value: DateValue | null) => void;
+    readonly onHighlightedValueChange?: (value: DateValue) => void;
     readonly onUpdate?: () => void;
 }
-export type CalendarConnectionPageRequestHandler<ID extends StableID = StableID> = NonNullable<CalendarConnectionOptions<ID>['onPageRequest']>;
-export type CalendarConnectionTransitionHandler<ID extends StableID = StableID> = NonNullable<CalendarConnectionOptions<ID>['onTransition']>;
-export type CalendarConnectionUpdateHandler<ID extends StableID = StableID> = NonNullable<CalendarConnectionOptions<ID>['onUpdate']>;
-export interface CalendarCellAttributes<ID extends StableID = StableID> {
-    readonly id: ID;
-    readonly rowIndex: number;
-    readonly columnIndex: number;
-    readonly disabled?: boolean;
-}
-export interface CalendarConnection<ID extends StableID = StableID> {
-    readonly grid: Grid<ID>;
-    getSnapshot(): RevisionSnapshot<CalendarState<ID>>;
-    syncControlledValues(values: CalendarControlledValues<ID>): Result<RevisionSnapshot<CalendarState<ID>>>;
-    setCalendarAttributes(label?: string): void;
-    setCellAttributes(element: HTMLElement, attributes: CalendarCellAttributes<ID>): void;
-    handleEvent(event: CalendarEvent<ID>): boolean;
+export type CalendarValueChangeHandler = NonNullable<CalendarOptions['onValueChange']>;
+export type CalendarHighlightedValueChangeHandler = NonNullable<CalendarOptions['onHighlightedValueChange']>;
+export type CalendarUpdateHandler = NonNullable<CalendarOptions['onUpdate']>;
+export interface CalendarControlledValues {
+    readonly value?: DateValue | null;
+    readonly highlightedValue?: DateValue;
+}
+export interface CalendarConnection {
+    getSnapshot(): RevisionSnapshot<CalendarState>;
+    getMonth(): readonly (readonly DateValue[])[];
+    getWeek(): readonly DateValue[];
+    getYear(): readonly (readonly CalendarMonthValue[])[];
+    syncControlledValues(values: CalendarControlledValues): DOMTemporalResult<RevisionSnapshot<CalendarState>>;
+    setCellAttributes(element: HTMLElement, value: DateValue): void;
+    handleEvent(event: CalendarEvent): boolean;
     handleKeyboardEvent(event: KeyboardEvent): boolean;
     focusCurrent(): void;
+    refresh(): void;
     disconnect(): void;
 }
-export type CalendarOptions<ID extends StableID = StableID> = Omit<CalendarControllerOptions<ID>, 'grid'> & Omit<CalendarConnectionOptions<ID>, 'controller'> & {
-    readonly rows: readonly (readonly ID[])[];
-};
-export declare function createCalendarController<ID extends StableID>(options: CalendarControllerOptions<ID>): Result<CalendarController<ID>>;
-export declare function createCalendar<ID extends StableID>(options: CalendarOptions<ID>): FacadeConnection<CalendarConnection<ID>>;
-export declare function tryCreateCalendar<ID extends StableID>(options: CalendarOptions<ID>): Result<FacadeConnection<CalendarConnection<ID>>>;
-export declare function connectCalendar<ID extends StableID>(options: CalendarConnectionOptions<ID>): CalendarConnection<ID>;
-export declare function toCalendarEvent<ID extends StableID = StableID>(input: KeyboardInput): CalendarEvent<ID> | null;
-export declare function toCalendarEffect<ID extends StableID>(command: CalendarCommand<ID>): CalendarEffect<ID>;
+export declare function createCalendar(options: CalendarOptions): FacadeConnection<CalendarConnection>;
+export declare function tryCreateCalendar(options: CalendarOptions): DOMTemporalResult<FacadeConnection<CalendarConnection>>;
+export declare function toCalendarEvent(input: Pick<KeyboardEvent, 'key' | 'altKey' | 'ctrlKey' | 'metaKey' | 'shiftKey'>): CalendarEvent | null;
 //# sourceMappingURL=calendar.d.ts.map

package/dist/calendar.d.ts.map

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

package/dist/calendar.js

@@ -1,296 +1,189 @@
-import { createFacadeConnection } from '@sectile/core/adapter-runtime';
+import {} from '@sectile/core/adapter-runtime';
 import { unwrap } from '@sectile/core/result';
-import { tryCreateInteractionState, requireInteraction, } from '@sectile/core/interaction';
-import { applyCalendarEvent, tryCreateCalendarState, } from '@sectile/core/calendar';
-import { tryCreateGrid } from '@sectile/core/grid';
-import { tryCreateRevisionSnapshot, rejectRevisionInput, } from '@sectile/core/revision';
-import { applyControllerEvent, synchronizeControllerState } from '@sectile/core/adapter-runtime';
-import { findDelegatedID } from './internal/delegated-event.js';
+import { createDOMTemporalController, createDOMTemporalFacadeConnection } from './internal/result.js';
+import { applyCalendarEvent, calendarID, createCalendarMonth, createCalendarWeek, createCalendarYear, isCalendarValueAvailable, tryCreateCalendarState, } from '@sectile/temporal/calendar';
+import { compareDateValues, parseDateValue } from '@sectile/temporal/date-field';
+import { setDatePickerCellAvailability } from './internal/date-picker-cell.js';
 import { setInteractionAttributes } from './internal/interaction.js';
-export function createCalendarController(options) {
-    const value = options.value !== undefined ? options.value : options.defaultValue ?? null;
-    const current = options.highlightedValue !== undefined
-        ? options.highlightedValue
-        : options.defaultHighlightedValue ?? null;
-    const initial = tryCreateCalendarState(options.grid, {
-        selected: value === null ? [] : [value],
-        anchor: value,
-        current,
-    });
-    if (!initial.ok)
-        return initial;
-    const snapshot = tryCreateRevisionSnapshot(initial.value);
-    if (!snapshot.ok)
-        return snapshot;
-    const interaction = tryCreateInteractionState(options);
-    if (!interaction.ok)
-        return interaction;
-    return { ok: true, value: new DOMCalendarController(options, snapshot.value, interaction.value) };
-}
+import { currentReferenceDate } from './internal/reference-date.js';
 export function createCalendar(options) {
     return unwrap(tryCreateCalendar(options));
 }
 export function tryCreateCalendar(options) {
-    return createFacadeConnection(options, (options) => tryCreateCalendarConnection(options));
-}
-function tryCreateCalendarConnection(options) {
-    const grid = tryCreateGrid(options.rows);
-    if (!grid.ok)
-        return grid;
-    const controller = createCalendarController({ ...options, grid: grid.value });
-    if (!controller.ok)
-        return controller;
-    return { ok: true, value: connectCalendar({ ...options, controller: controller.value }) };
-}
-export function connectCalendar(options) {
-    return new DOMCalendarConnection(options);
+    return createDOMTemporalFacadeConnection(options, constructCalendar);
 }
-export function toCalendarEvent(input) {
-    if (input.altKey === true || input.ctrlKey === true || input.metaKey === true)
-        return null;
-    if (input.key === 'ArrowLeft')
-        return 'left';
-    if (input.key === 'ArrowRight')
-        return 'right';
-    if (input.key === 'ArrowUp')
-        return 'up';
-    if (input.key === 'ArrowDown')
-        return 'down';
-    if (input.key === ' ' || input.key === 'Enter')
-        return 'select';
-    if (input.key === 'PageUp')
-        return 'previous-page';
-    if (input.key === 'PageDown')
-        return 'next-page';
-    return null;
-}
-export function toCalendarEffect(command) {
-    return Object.freeze(command.type === 'focus'
-        ? { type: 'focus-element', id: command.id }
-        : { type: 'request-page', direction: command.direction, from: command.from });
+function constructCalendar(options) {
+    const controls = {
+        value: options.value !== undefined,
+        highlighted: options.highlightedValue !== undefined,
+    };
+    const requestedValue = controls.value ? options.value : options.defaultValue;
+    const requestedHighlight = controls.highlighted ? options.highlightedValue : options.defaultHighlightedValue;
+    const initial = tryCreateCalendarState({
+        referenceDate: options.referenceDate ?? currentReferenceDate(),
+        ...(requestedValue === undefined ? {} : { value: requestedValue }),
+        ...(requestedHighlight === undefined ? {} : { highlighted: requestedHighlight }),
+    });
+    const runtime = createDOMTemporalController({
+        initial,
+        reducer: (state, event) => applyCalendarEvent(state, event, {
+            ...options.policies,
+            ...(options.required === undefined ? {} : { required: options.required }),
+        }),
+        reconcile: (previous, proposed) => tryCreateCalendarState({
+            value: controls.value ? previous.value : proposed.value,
+            highlighted: controls.highlighted ? previous.highlighted : proposed.highlighted,
+            view: controls.highlighted ? previous.view : proposed.view,
+            viewMode: proposed.viewMode,
+        }),
+        notify: (previous, proposed) => {
+            if (compareNullable(previous.value, proposed.value) !== 0)
+                options.onValueChange?.(proposed.value);
+            if (compareDateValues(previous.highlighted, proposed.highlighted) !== 0)
+                options.onHighlightedValueChange?.(proposed.highlighted);
+        },
+        toEffect: (command) => command,
+        interaction: options,
+        interactionIntent: calendarInteractionIntent,
+    });
+    return runtime.ok
+        ? { ok: true, value: new DOMCalendar(options, runtime.value, controls) }
+        : runtime;
 }
-class DOMCalendarConnection {
-    grid;
-    #controller;
-    #root;
-    #onPageRequest;
-    #onTransition;
-    #onUpdate;
-    #handleKeydown;
-    #handleClick;
-    constructor(options) {
-        this.#controller = options.controller;
-        this.grid = options.controller.grid;
-        this.#root = options.root;
-        this.#onPageRequest = options.onPageRequest;
-        this.#onTransition = options.onTransition;
-        this.#onUpdate = options.onUpdate;
-        setInteractionAttributes(this.#root, options);
-        this.#handleKeydown = (event) => {
-            if (this.handleKeyboardEvent(event))
-                event.preventDefault();
-        };
-        this.#handleClick = (event) => {
-            const id = findDelegatedID(event.target, this.#root, 'calendarId');
-            if (id !== null)
-                this.handleEvent({ type: 'select', id: id });
-        };
-        this.#root.addEventListener('keydown', this.#handleKeydown);
-        this.#root.addEventListener('click', this.#handleClick);
-    }
-    getSnapshot() {
-        return this.#controller.getSnapshot();
+class DOMCalendar {
+    #options;
+    #grid;
+    #runtime;
+    #controls;
+    #keydown = (event) => {
+        if (this.handleKeyboardEvent(event))
+            event.preventDefault();
+    };
+    #click = (event) => {
+        const target = event.target instanceof Element ? event.target.closest('[data-calendar-id]') : null;
+        if (target === null || !this.#grid.contains(target))
+            return;
+        const parsed = parseDateValue(target.dataset['calendarId'] ?? '');
+        if (parsed.ok)
+            this.handleEvent({ type: 'select', value: parsed.value });
+    };
+    constructor(options, runtime, controls) {
+        this.#options = options;
+        this.#grid = options.grid ?? options.root;
+        this.#runtime = runtime;
+        this.#controls = controls;
+        this.#grid.addEventListener('keydown', this.#keydown);
+        this.#grid.addEventListener('click', this.#click);
+        this.#grid.setAttribute('role', 'grid');
+        setInteractionAttributes(this.#grid, options);
+        this.refresh();
+    }
+    getSnapshot() { return this.#runtime.getSnapshot(); }
+    getMonth() {
+        return createCalendarMonth(this.getSnapshot().state.view, this.#options.policies?.weekStartsOn);
+    }
+    getWeek() {
+        return createCalendarWeek(this.getSnapshot().state.highlighted, this.#options.policies?.weekStartsOn);
+    }
+    getYear() {
+        return createCalendarYear(this.getSnapshot().state.view.year);
     }
     syncControlledValues(values) {
-        const result = this.#controller.syncControlledValues(values);
+        if (this.#controls.value !== (values.value !== undefined) || this.#controls.highlighted !== (values.highlightedValue !== undefined)) {
+            return {
+                ok: false,
+                error: {
+                    class: 'construction',
+                    code: 'controlled-shape-mismatch',
+                    message: 'Controlled calendar values must preserve their construction-time shape.',
+                },
+            };
+        }
+        const state = this.getSnapshot().state;
+        const highlighted = this.#controls.highlighted ? values.highlightedValue : state.highlighted;
+        const result = this.#runtime.replace(tryCreateCalendarState({
+            value: this.#controls.value ? values.value : state.value,
+            highlighted,
+            view: { year: highlighted.year, month: highlighted.month },
+            viewMode: state.viewMode,
+        }));
         if (result.ok) {
-            this.#onUpdate?.();
-            this.focusCurrent();
+            this.refresh();
+            this.#options.onUpdate?.();
         }
         return result;
     }
-    setCalendarAttributes(label) {
-        this.#root.setAttribute('role', 'grid');
-        this.#root.setAttribute('aria-rowcount', String(this.grid.rowCount));
-        this.#root.setAttribute('aria-colcount', String(this.grid.columnCount));
-        if (label === undefined)
-            this.#root.removeAttribute('aria-label');
-        else
-            this.#root.setAttribute('aria-label', label);
-    }
-    setCellAttributes(element, attributes) {
-        const state = this.#controller.getSnapshot().state;
-        element.dataset['calendarId'] = String(attributes.id);
-        element.tabIndex = state.cursor.current === attributes.id ? 0 : -1;
+    setCellAttributes(element, value) {
+        const state = this.getSnapshot().state;
+        element.dataset['calendarId'] = calendarID(value);
         element.setAttribute('role', 'gridcell');
-        element.setAttribute('aria-rowindex', String(attributes.rowIndex));
-        element.setAttribute('aria-colindex', String(attributes.columnIndex));
-        element.setAttribute('aria-selected', String(state.selection.has(attributes.id)));
-        if (attributes.disabled === true)
-            element.setAttribute('aria-disabled', 'true');
-        else
-            element.removeAttribute('aria-disabled');
-    }
-    handleKeyboardEvent(event) {
-        const input = {
-            key: event.key,
-            altKey: event.altKey,
-            ctrlKey: event.ctrlKey,
-            metaKey: event.metaKey,
-        };
-        const semanticEvent = toCalendarEvent(input);
-        if (semanticEvent === null)
-            return false;
-        return this.handleEvent(semanticEvent);
+        element.setAttribute('aria-selected', String(state.value !== null && compareDateValues(state.value, value) === 0));
+        setDatePickerCellAvailability(element, isCalendarValueAvailable(value, this.#options.policies));
+        element.tabIndex = compareDateValues(state.highlighted, value) === 0 ? 0 : -1;
     }
     handleEvent(event) {
-        const result = this.#controller.handleEvent(event);
-        if (result.ok)
-            this.#applyEffects(result.commands);
-        this.#onTransition?.(Object.freeze({ event, result }));
-        if (result.ok) {
-            this.#onUpdate?.();
-            this.focusCurrent();
-        }
-        return result.ok;
-    }
-    focusCurrent() {
-        queueMicrotask(() => {
-            const current = this.#controller.getSnapshot().state.cursor.current;
-            if (current === null) {
-                this.#root.focus();
-                return;
-            }
-            for (const element of this.#root.querySelectorAll('[data-calendar-id]')) {
-                if (element.dataset['calendarId'] !== String(current))
-                    continue;
-                element.focus();
-                return;
-            }
-        });
-    }
-    disconnect() {
-        this.#root.removeEventListener('keydown', this.#handleKeydown);
-        this.#root.removeEventListener('click', this.#handleClick);
-    }
-    #applyEffects(effects) {
-        for (const effect of effects) {
-            if (effect.type !== 'request-page')
-                continue;
-            this.#onPageRequest?.(Object.freeze({ direction: effect.direction, from: effect.from }));
+        const result = this.#runtime.handle(event);
+        if (!result.ok)
+            return false;
+        this.refresh();
+        this.#options.onUpdate?.();
+        if (result.commands.some((command) => command.type === 'highlight-changed')) {
+            queueMicrotask(() => this.focusCurrent());
         }
+        return true;
     }
-}
-class DOMCalendarController {
-    grid;
-    #grid;
-    #policies;
-    #valueControlled;
-    #highlightControlled;
-    #onValueChange;
-    #onHighlightedValueChange;
-    #interaction;
-    #snapshot;
-    constructor(options, snapshot, interaction) {
-        this.grid = options.grid;
-        this.#grid = options.grid;
-        this.#policies = options.policies ?? {};
-        this.#valueControlled = options.value !== undefined;
-        this.#highlightControlled = options.highlightedValue !== undefined;
-        this.#onValueChange = options.onValueChange;
-        this.#onHighlightedValueChange = options.onHighlightedValueChange;
-        this.#interaction = interaction;
-        this.#snapshot = snapshot;
+    handleKeyboardEvent(event) {
+        const semantic = toCalendarEvent(event);
+        return semantic !== null && this.handleEvent(semantic);
     }
-    getSnapshot() {
-        return this.#snapshot;
+    focusCurrent() {
+        this.#grid.querySelector('[tabindex="0"]')?.focus();
     }
-    syncControlledValues(values) {
-        const error = controlledInputError(this.#valueControlled, this.#highlightControlled, values);
-        if (error !== null)
-            return { ok: false, error };
-        const selected = this.#valueControlled
-            ? values.value
-            : selectedValue(this.#snapshot.state);
-        const state = tryCreateCalendarState(this.#grid, {
-            selected: selected === null ? [] : [selected],
-            anchor: this.#valueControlled ? selected : this.#snapshot.state.selection.anchor,
-            current: this.#highlightControlled
-                ? values.highlightedValue
-                : this.#snapshot.state.cursor.current,
+    refresh() {
+        if (this.#options.label === undefined)
+            this.#grid.removeAttribute('aria-label');
+        else
+            this.#grid.setAttribute('aria-label', this.#options.label);
+        this.#grid.querySelectorAll('[data-calendar-id]').forEach((element) => {
+            const parsed = parseDateValue(element.dataset['calendarId'] ?? '');
+            if (parsed.ok)
+                this.setCellAttributes(element, parsed.value);
         });
-        const snapshot = synchronizeControllerState(this.#snapshot, state);
-        if (!snapshot.ok)
-            return snapshot;
-        this.#snapshot = snapshot.value;
-        return snapshot;
-    }
-    handleKeyboardInput(input, expectedRevision = this.#snapshot.revision) {
-        const event = toCalendarEvent(input);
-        if (event === null) {
-            return rejectRevisionInput(this.#snapshot, {
-                class: 'transition-rejection',
-                code: 'unsupported-dom-key',
-                message: 'DOM keyboard input does not map to a calendar semantic event.',
-                details: { key: input.key },
-            });
-        }
-        return this.handleEvent(event, expectedRevision);
     }
-    handleEvent(event, expectedRevision = this.#snapshot.revision) {
-        const permitted = requireInteraction(this.#interaction, 'navigate');
-        if (!permitted.ok)
-            return rejectRevisionInput(this.#snapshot, permitted.error);
-        const result = applyControllerEvent(this.#snapshot, expectedRevision, event, (state, semanticEvent) => applyCalendarEvent(this.#grid, state, semanticEvent, this.#policies), (previous, proposed) => controlledState(this.#grid, previous, proposed, this.#valueControlled, this.#highlightControlled), (previous, proposed) => this.#notify(previous, proposed), toCalendarEffect);
-        if (result.ok)
-            this.#snapshot = result.snapshot;
-        return result;
-    }
-    #notify(previous, proposed) {
-        const previousValue = selectedValue(previous);
-        const value = selectedValue(proposed);
-        if (previousValue !== value) {
-            this.#onValueChange?.(Object.freeze({ value, previousValue }));
-        }
-        if (previous.cursor.current !== proposed.cursor.current) {
-            this.#onHighlightedValueChange?.(Object.freeze({
-                value: proposed.cursor.current,
-                previousValue: previous.cursor.current,
-            }));
-        }
+    disconnect() {
+        this.#grid.removeEventListener('keydown', this.#keydown);
+        this.#grid.removeEventListener('click', this.#click);
     }
 }
-function controlledState(grid, previous, proposed, valueControlled, highlightControlled) {
-    return tryCreateCalendarState(grid, {
-        selected: valueControlled ? previous.selection.selected : proposed.selection.selected,
-        anchor: valueControlled ? previous.selection.anchor : proposed.selection.anchor,
-        current: highlightControlled ? previous.cursor.current : proposed.cursor.current,
-    });
+export function toCalendarEvent(input) {
+    if (input.altKey || input.ctrlKey || input.metaKey)
+        return null;
+    if (input.key === 'ArrowLeft')
+        return 'previous-day';
+    if (input.key === 'ArrowRight')
+        return 'next-day';
+    if (input.key === 'ArrowUp')
+        return 'previous-week';
+    if (input.key === 'ArrowDown')
+        return 'next-week';
+    if (input.key === 'Home')
+        return 'start-of-week';
+    if (input.key === 'End')
+        return 'end-of-week';
+    if (input.key === 'PageUp')
+        return input.shiftKey ? 'previous-year' : 'previous-month';
+    if (input.key === 'PageDown')
+        return input.shiftKey ? 'next-year' : 'next-month';
+    if (input.key === 'Enter' || input.key === ' ')
+        return 'select-highlighted';
+    return null;
 }
-function selectedValue(state) {
-    return state.selection.selected[0] ?? null;
+function calendarInteractionIntent(event) {
+    if (event === 'select-highlighted')
+        return 'mutate';
+    return typeof event === 'object' && (event.type === 'select' || event.type === 'set-value') ? 'mutate' : 'navigate';
 }
-function controlledInputError(valueControlled, highlightControlled, values) {
-    if (valueControlled !== (values.value !== undefined)) {
-        return {
-            class: 'construction',
-            code: valueControlled ? 'controlled-value-required' : 'uncontrolled-value-update',
-            message: valueControlled
-                ? 'Controlled calendar selection sync requires value.'
-                : 'Uncontrolled calendar selection cannot be synchronized externally.',
-        };
-    }
-    if (highlightControlled !== (values.highlightedValue !== undefined)) {
-        return {
-            class: 'construction',
-            code: highlightControlled
-                ? 'controlled-highlighted-value-required'
-                : 'uncontrolled-highlighted-value-update',
-            message: highlightControlled
-                ? 'Controlled calendar highlight sync requires highlightedValue.'
-                : 'Uncontrolled calendar highlight cannot be synchronized externally.',
-        };
-    }
-    return null;
+function compareNullable(left, right) {
+    return left === null ? right === null ? 0 : -1 : right === null ? 1 : compareDateValues(left, right);
 }
 //# sourceMappingURL=calendar.js.map