@cocoar/vue-calendar 3.1.0 → 3.2.0-beta.11

package/dist/builders/calendar-builder.d.ts

@@ -1,489 +1,78 @@
-import { MaybeRefOrGetter, Ref, ShallowRef } from 'vue';
-import { CalendarEvent, CalendarDayMode, CalendarMonthDensity, CalendarView, DayOfWeek, RecurringSeries, ViewWindow, Temporal } from '../core';
-import { SET_VISIBLE_RANGE, INVALIDATE_LOADER_CACHE } from './calendar-builder-internals';
-import { CalendarDensity, CanDropFn, DateClickHandler, DayHeaderRenderer, DstPolicy, EventClickHandler, EventDoubleClickHandler, EventDropHandler, EventHoverHandler, EventHoverLeaveHandler, EventRenderer, EventsLoader, MoreClickHandler, RangeChangeHandler, SeriesLoader, TimeClickHandler, TimeRange } from './types';
-import { RecurrenceEngine } from '../recurrence/types';
-/**
- * Reactive state owned by a `CalendarBuilder`. All reads go through
- * `toValue()` for `MaybeRefOrGetter<T>` fields and `.value` for
- * `Ref<T>` fields. Function fields (canDrop / handlers / renderers)
- * are stored verbatim and called at the read site.
- */
-export interface CalendarBuilderState<TMeta extends Record<string, unknown> = Record<string, unknown>> {
-    events: MaybeRefOrGetter<CalendarEvent<TMeta>[]> | null;
-    eventsLoader: EventsLoader<TMeta> | null;
-    /**
-     * Recurring-series source (Phase 4). Reactive — expansion re-runs
-     * when the source changes or the visible range changes.
-     * Mutually exclusive with `seriesLoader`.
-     */
-    series: MaybeRefOrGetter<RecurringSeries<TMeta>[]> | null;
-    /**
-     * Calendar-managed recurring-series loader (Phase 4). Called per
-     * visible-range change; results are expanded by the configured
-     * engine and cached per-window key. Mutually exclusive with `series`.
-     */
-    seriesLoader: SeriesLoader<TMeta> | null;
-    /** Display zone (C5). Defaults to the browser's IANA zone. */
-    timezone: MaybeRefOrGetter<string>;
-    locale: MaybeRefOrGetter<string>;
-    /** Locale-derived when undefined (Article 9 — defaults are not decisions). */
-    firstDayOfWeek: MaybeRefOrGetter<DayOfWeek | undefined>;
-    /**
-     * Days that count as "working days" for the `'workWeek'` view.
-     * 0 = Sun … 6 = Sat. Default is Mon–Fri (`[1, 2, 3, 4, 5]`).
-     * Empty array yields an empty workWeek (rendered as "no working
-     * days configured" — UI concern, not a runtime error).
-     *
-     * Article 9: this is an explicit decision — the locale gets a
-     * vote on `firstDayOfWeek` but NOT on which weekdays are
-     * working days (varies by country/industry independently of
-     * BCP-47).
-     */
-    workDays: MaybeRefOrGetter<readonly DayOfWeek[]>;
-    /** Tint Saturday and Sunday cells in month views. Enabled by default. */
-    shadeWeekends: MaybeRefOrGetter<boolean>;
-    density: MaybeRefOrGetter<CalendarDensity>;
-    /** Apple-style month presentation. Default `details` preserves the classic web grid. */
-    monthDensity: MaybeRefOrGetter<CalendarMonthDensity>;
-    /** One fixed day or a width-driven 1…7-day surface. */
-    dayMode: MaybeRefOrGetter<CalendarDayMode>;
-    /** Intl date style (C6 — independent of timeStyle / hour12).
-     *  Locale-derived when undefined (Article 9). */
-    dateStyle: MaybeRefOrGetter<'short' | 'medium' | 'long' | 'full' | undefined>;
-    /** Intl time style (C6). */
-    /** Intl time style (C6). Locale-derived when undefined (Article 9). */
-    timeStyle: MaybeRefOrGetter<'short' | 'medium' | 'long' | undefined>;
-    /** 12h vs 24h clock (C6 — independent of locale). */
-    hour12: MaybeRefOrGetter<boolean | undefined>;
-    /** DST disambiguation policy (C4). Default `'compatible'`. */
-    dstPolicy: MaybeRefOrGetter<DstPolicy>;
-    /**
-     * Recurrence engine (Phase 4 §A8). One of:
-     *   - `RecurrenceEngine` instance — eager.
-     *   - `() => RecurrenceEngine` factory — SSR-friendly lazy.
-     *   - `null` — defer to the lazy default (rrule-temporal adapter
-     *     loaded via dynamic import on first `expandSeries` call).
-     *
-     * Intentionally NOT `MaybeRefOrGetter`: mid-session swap has no
-     * sensible semantics (in-flight requests, worker lifecycle). Set
-     * once at construction.
-     */
-    recurrenceEngine: RecurrenceEngine | (() => RecurrenceEngine) | null;
-    /** Subset of CalendarView the view-switcher offers. */
-    availableViews: MaybeRefOrGetter<readonly CalendarView[]>;
-    timeRange: MaybeRefOrGetter<TimeRange>;
-    slotDuration: MaybeRefOrGetter<number>;
-    pixelsPerHour: MaybeRefOrGetter<number>;
-    maxEventsPerCell: MaybeRefOrGetter<number>;
-    /** Minimum number of adjacent columns in the responsive day view. */
-    dayColumnCount: MaybeRefOrGetter<number>;
-    /** Target width of one responsive day column in CSS pixels. */
-    dayColumnMinWidth: MaybeRefOrGetter<number>;
-    agendaLengthDays: MaybeRefOrGetter<number>;
-    showEmptyDays: MaybeRefOrGetter<boolean>;
-    /**
-     * Number of days the `'timeline'` view spans starting from the
-     * cursor. Default 60 (~two months — fits sprint-planning horizons
-     * without overwhelming the horizontal scroll).
-     */
-    timelineRangeDays: MaybeRefOrGetter<number>;
-    /**
-     * Horizontal pixel density of the `'timeline'` view's time axis.
-     * Default 56 — a localized "DD. Mon" label (e.g. "15. Juni") fits
-     * on one line at the default font size. Bump to 80 for hour-
-     * granularity layout, drop to 24 for quarter-zoomed sprint
-     * overviews.
-     */
-    timelinePixelsPerDay: MaybeRefOrGetter<number>;
-    /**
-     * Height of each event row in the `'timeline'` view, in pixels.
-     * Default 32 — matches the default density's pill height.
-     */
-    timelineRowHeight: MaybeRefOrGetter<number>;
-    /**
-     * Width of the left label-pane in the `'timeline'` view, in pixels.
-     * Default 200 — wide enough for most event titles without
-     * crowding the time-grid.
-     */
-    timelineLabelWidth: MaybeRefOrGetter<number>;
-    /** Active view. Held as Ref so api.setView can write back. */
-    view: Ref<CalendarView>;
-    /** Cursor date. Held as Ref so api.next/prev/goTo can write back. */
-    date: Ref<Temporal.PlainDate>;
-    canDrop: CanDropFn<TMeta> | null;
-    eventRenderer: EventRenderer<TMeta> | null;
-    dayHeaderRenderer: DayHeaderRenderer | null;
-    onEventClick: EventClickHandler<TMeta> | null;
-    onEventDoubleClick: EventDoubleClickHandler<TMeta> | null;
-    onEventHover: EventHoverHandler<TMeta> | null;
-    onEventHoverLeave: EventHoverLeaveHandler<TMeta> | null;
-    onEventDrop: EventDropHandler<TMeta> | null;
-    onDateClick: DateClickHandler | null;
-    onTimeClick: TimeClickHandler | null;
-    onMoreClick: MoreClickHandler<TMeta> | null;
-    onRangeChange: RangeChangeHandler | null;
-}
-/**
- * Imperative + reactive surface returned alongside the builder.
- */
-export interface CalendarApi<TMeta extends Record<string, unknown> = Record<string, unknown>> {
-    /** `true` while at least one `eventsLoader` invocation is in flight. */
-    readonly loading: Readonly<Ref<boolean>>;
-    /** Currently rendered window. `null` before first paint. */
-    readonly visibleRange: Readonly<ShallowRef<ViewWindow | null>>;
-    /** `true` once the active view's grid has reported ready. */
-    readonly gridReady: Readonly<Ref<boolean>>;
-    goTo(date: Temporal.PlainDate): void;
-    goToToday(): void;
-    next(): void;
-    prev(): void;
-    setView(view: CalendarView): void;
-    setMonthDensity(density: CalendarMonthDensity): void;
-    setDayMode(mode: CalendarDayMode): void;
-    /** Wired in Session 3 (component-side). No-op until then. */
-    scrollToTime(time: Temporal.PlainTime): void;
-    /** Wired in Session 3 (component-side). No-op until then. */
-    scrollToDate(date: Temporal.PlainDate): void;
-    /** Invalidate the entire loader cache and re-fetch the current window. */
-    refresh(): void;
-    /** Invalidate any cached entries that intersect `window` and re-fetch
-     *  if the current window intersects. */
-    refreshRange(window: ViewWindow): void;
-    /** Synchronous read of the current window. `null` before first paint. */
-    getVisibleRange(): ViewWindow | null;
-    /** Snapshot of events visible in the current window — from
-     *  `events()` source if set, else the loader cache (or empty if no
-     *  cache hit yet). */
-    getVisibleEvents(): CalendarEvent<TMeta>[];
-}
-export declare class CalendarBuilder<TMeta extends Record<string, unknown> = Record<string, unknown>> {
-    /** Reactive state — single source of truth (C7 read site). */
-    readonly state: CalendarBuilderState<TMeta>;
+import { CalendarEvent, ViewWindow, Temporal } from '../core';
+import { SET_TOPMOST_VISIBLE_MONTH, SET_VISIBLE_RANGE, INVALIDATE_LOADER_CACHE, PREFETCH_WINDOWS } from './calendar-builder-internals';
+import { CalendarBuilderHandlers } from './calendar-builder-handlers';
+import { CalendarApi } from './calendar-builder-state';
+export type { CalendarApi, CalendarBuilderState } from './calendar-builder-state';
+export declare class CalendarBuilder<TMeta extends Record<string, unknown> = Record<string, unknown>> extends CalendarBuilderHandlers<TMeta> {
     /** Imperative + reactive surface. */
     readonly api: CalendarApi<TMeta>;
-    private readonly _loading;
     private readonly _visibleRange;
+    private readonly _topmostVisibleMonth;
     private readonly _gridReady;
-    /** Active view's scroll-to-time delegate. View registers on mount
-     *  via `_setScrollToTime(fn)` and clears on unmount. */
+    /** Active view's scroll delegates. Registered on mount, cleared on unmount. */
     private _scrollToTimeImpl;
-    /** Active view's scroll-to-date delegate. */
     private _scrollToDateImpl;
-    /** Map<windowKey, events>. Wrapped in shallowRef so cache swaps
-     *  trigger reactivity for `getVisibleEvents`. */
-    private readonly _loaderCache;
-    /** In-flight loader counter — `loading.value = (counter > 0)`.
-     *  Counter (not boolean) so concurrent fetches don't race the flag. */
-    private _inFlight;
-    /** Pending debounced loader handle — cleared on subsequent
-     *  `_setVisibleRange` calls within the debounce window. */
-    private _debounceHandle;
-    /**
-     * Generation counter — bumped on `refresh()` so an in-flight loader
-     * whose result arrives AFTER an invalidation is discarded instead
-     * of poisoning the cache.
-     */
-    private _generation;
-    /** Map<windowKey, expanded events>. Same key shape as _loaderCache.
-     *  Holds occurrences expanded from `state.series` / `state.seriesLoader`. */
-    private readonly _seriesCache;
-    /** Bumped on series invalidation. Independent of `_generation` so
-     *  series and events caches don't fight over the same counter. */
-    private _seriesGeneration;
-    /** Resolved engine instance (lazy-constructed from
-     *  `state.recurrenceEngine`). `null` means "use the lazy default
-     *  inside expandSeries". */
-    private _resolvedEngine;
-    /** Window keys with a pending series expansion. Prevents duplicate
-     *  dispatches when series-watcher and [SET_VISIBLE_RANGE] both fire
-     *  for the same window in close succession. */
-    private readonly _inFlightSeriesKeys;
-    /** Memoized lazy import of `expandSeries`. Dynamic-import keeps
-     *  the recurrence runtime out of the main bundle for apps that
-     *  don't use series — the chunk only loads on first
-     *  `_runSeriesExpansion` call. Per Phase 4 §A1 topology rule. */
-    private _expandSeriesFnPromise;
-    /** Effect scope for builder-owned watchers (audit fix #1 — events
-     *  source watcher). Cleaned up if/when a `.dispose()` is added in
-     *  Phase 4+; currently builders live for the page lifetime. */
+    private readonly _warnedScrollMethods;
+    private readonly _loading;
+    private readonly _validator;
+    private readonly _loader;
+    private readonly _series;
+    /** Effect scope for builder-owned watchers. Builders live for the page lifetime. */
     private readonly _scope;
-    /** Tracks event-array references already validated, so re-renders
-     *  don't re-walk them. Per-event-object validation; consumers who
-     *  recreate event objects on every render pay the validation cost
-     *  every render (cheap — a few `instanceof` checks). */
-    private readonly _validatedEventObjects;
     private constructor();
-    /** Factory — keep `new` private so the only entry point is
-     *  `useCalendar()`. */
+    /** Factory — `new` is private so the only entry point is `useCalendar()`. */
     static create<TMeta extends Record<string, unknown> = Record<string, unknown>>(): CalendarBuilder<TMeta>;
-    /**
-     * Bind the event source. Mutually exclusive with `eventsLoader()`
-     * — calling this clears any previously-set loader and drops the
-     * cache (cache only makes sense for loader mode).
-     *
-     * The library accepts ONLY `Temporal.ZonedDateTime` (timed) or
-     * `Temporal.PlainDate` (all-day) on event start/end. Strings,
-     * `Date`, floating `PlainDateTime` etc. throw at index-insert via
-     * `validateCalendarEvent` (C1).
-     */
-    events(source: MaybeRefOrGetter<CalendarEvent<TMeta>[]>): this;
-    /**
-     * Bind a calendar-managed loader. Called whenever the visible
-     * window changes; results cached per `(view, timezone, start, end)`
-     * so navigation back to a previously-seen window doesn't re-fetch.
-     * Mutually exclusive with `events()`.
-     */
-    eventsLoader(loader: EventsLoader<TMeta>): this;
-    /**
-     * Phase 4 — bind a recurring-series source. Reactive: expansion
-     * re-runs whenever the source changes or the visible range changes.
-     *
-     * Composes with `events()` / `eventsLoader()`; `getVisibleEvents()`
-     * returns the merged set. Mutually exclusive with `seriesLoader()`
-     * (one or the other, not both).
-     *
-     * Expansion uses the engine from `recurrenceEngine()` if set, else
-     * the lazy default rrule-temporal adapter. DST policy from
-     * `dstPolicy()` applies uniformly to every expanded occurrence.
-     */
-    series(source: MaybeRefOrGetter<RecurringSeries<TMeta>[]>): this;
-    /**
-     * Phase 4 — bind a calendar-managed recurring-series loader.
-     * Called per visible-range change; results expanded by the
-     * configured engine and cached per-window. Mutually exclusive with
-     * `series()`.
-     */
-    seriesLoader(loader: SeriesLoader<TMeta>): this;
-    /** C5 — Display zone (IANA). Source zones on individual events
-     *  remain independent and per-endpoint preserved (C3). */
-    timezone(tz: MaybeRefOrGetter<string>): this;
-    locale(loc: MaybeRefOrGetter<string>): this;
-    firstDayOfWeek(d: MaybeRefOrGetter<DayOfWeek>): this;
-    /**
-     * Working-day set for the `'workWeek'` view. 0 = Sun … 6 = Sat.
-     * Default is Mon–Fri. Reactive — changing it while a workWeek
-     * view is active reflows the rendered columns.
-     */
-    workDays(d: MaybeRefOrGetter<readonly DayOfWeek[]>): this;
-    /** Tint Saturday and Sunday cells in month views. */
-    shadeWeekends(enabled: MaybeRefOrGetter<boolean>): this;
-    density(d: MaybeRefOrGetter<CalendarDensity>): this;
-    monthDensity(density: MaybeRefOrGetter<CalendarMonthDensity>): this;
-    dayMode(mode: MaybeRefOrGetter<CalendarDayMode>): this;
-    /** C6 — independent of timeStyle / hour12. */
-    dateStyle(s: MaybeRefOrGetter<'short' | 'medium' | 'long' | 'full'>): this;
-    /** C6 — independent of dateStyle / hour12. */
-    timeStyle(s: MaybeRefOrGetter<'short' | 'medium' | 'long'>): this;
-    /**
-     * C6 — independent of locale. `undefined` lets Intl derive from
-     * locale (default); `true` / `false` overrides explicitly.
-     */
-    hour12(h: MaybeRefOrGetter<boolean | undefined>): this;
-    /**
-     * C4 — DST disambiguation policy. Read by every wall-time → instant
-     * conversion in the drop pipeline. Default `'compatible'`.
-     */
-    dstPolicy(p: MaybeRefOrGetter<DstPolicy>): this;
-    /**
-     * Phase 4 §A8 — recurrence engine.
-     *
-     * Bind a specific engine for `expandSeries` calls associated with
-     * this builder. Without this call, the lazy default
-     * (rrule-temporal adapter) is used.
-     *
-     * The factory form is the SSR escape: pass
-     * `() => new SyncOnlyRecurrenceEngine()` so the engine is
-     * constructed only when actually needed (SSR with non-recurring
-     * events doesn't trigger construction).
-     *
-     * Use cases:
-     *   - Custom engines: implement the `RecurrenceEngine` interface
-     *     in consumer code (e.g. server-side pre-expansion, alternate
-     *     RRULE parser, mock for tests).
-     *   - SSR: pass a factory form to defer engine construction to
-     *     the first client-side call.
-     *   - Tests: pass a mock engine for deterministic output.
-     *
-     * **Set once at construction.** Mid-session swap has no sensible
-     * semantics (in-flight requests, worker lifecycle, cache coherency)
-     * — calling this method after a series expansion has been
-     * dispatched does NOT cancel or re-route in-flight calls.
-     */
-    recurrenceEngine(engineOrFactory: RecurrenceEngine | (() => RecurrenceEngine)): this;
-    /**
-     * Active view. Setter accepts a `Ref<CalendarView>` (two-way
-     * binding) or a plain value (wrapped into an internal ref).
-     * Function-getters are rejected — `api.setView` must be able to
-     * write back.
-     */
-    view(v: Ref<CalendarView> | CalendarView): this;
-    availableViews(views: MaybeRefOrGetter<readonly CalendarView[]>): this;
-    /**
-     * Cursor date. Setter accepts a `Ref<PlainDate>` or a plain
-     * `PlainDate`; function-getters rejected (api.next/prev/goTo
-     * must write).
-     */
-    date(d: Ref<Temporal.PlainDate> | Temporal.PlainDate): this;
-    /** Time-grid view setting (`day` / `week`). */
-    timeRange(r: MaybeRefOrGetter<TimeRange>): this;
-    slotDuration(minutes: MaybeRefOrGetter<number>): this;
-    pixelsPerHour(px: MaybeRefOrGetter<number>): this;
-    /** Month view setting — pills before "+N more". */
-    maxEventsPerCell(n: MaybeRefOrGetter<number>): this;
-    /** Responsive day view: minimum number of full day columns. */
-    dayColumnCount(n: MaybeRefOrGetter<number>): this;
-    /** Responsive day view: target width used to derive additional columns. */
-    dayColumnMinWidth(px: MaybeRefOrGetter<number>): this;
-    /** Agenda view setting — number of days the linear list covers. */
-    agendaLengthDays(n: MaybeRefOrGetter<number>): this;
-    /** Agenda view setting — show day headers even when no events. */
-    showEmptyDays(b: MaybeRefOrGetter<boolean>): this;
-    /** Days the `'timeline'` view spans starting from the cursor. Default 60. */
-    timelineRangeDays(n: MaybeRefOrGetter<number>): this;
-    /** Horizontal pixel density of the `'timeline'` view (pixels per day). Default 56. */
-    timelinePixelsPerDay(p: MaybeRefOrGetter<number>): this;
-    /** Event-row height in the `'timeline'` view, in pixels. Default 32. */
-    timelineRowHeight(h: MaybeRefOrGetter<number>): this;
-    /** Left-pane label width in the `'timeline'` view, in pixels. Default 200. */
-    timelineLabelWidth(w: MaybeRefOrGetter<number>): this;
-    /**
-     * Drop validator. Read on EVERY hit-test (C7 + D4 — no library-
-     * side memoization). If you do expensive work in here, memoize
-     * client-side; the library reading fresh state is the correct
-     * behaviour and intentionally not cached.
-     *
-     * @example
-     * ```ts
-     * // Consumer-side memoization for expensive checks:
-     * const memoized = computed(() => {
-     *   const rules = expensivelyCompiledRules.value;
-     *   return (event, target) => rules.matches(event, target);
-     * });
-     * builder.canDrop(memoized.value);
-     * ```
-     */
-    canDrop(fn: CanDropFn<TMeta>): this;
-    eventRenderer(r: EventRenderer<TMeta>): this;
-    dayHeaderRenderer(r: DayHeaderRenderer): this;
-    onEventClick(h: EventClickHandler<TMeta>): this;
-    onEventDoubleClick(h: EventDoubleClickHandler<TMeta>): this;
-    /**
-     * Fires on `pointerenter` over an event element in any view.
-     * Pair with `useOverlay()` (from `@cocoar/vue-ui`) to anchor a
-     * popover at `payload.native.currentTarget`. The library does
-     * NOT apply hover delay — consumer wraps the handler if a delay
-     * is wanted.
-     */
-    onEventHover(h: EventHoverHandler<TMeta>): this;
-    /** Companion to `onEventHover` — fires on `pointerleave`. */
-    onEventHoverLeave(h: EventHoverLeaveHandler<TMeta>): this;
-    onEventDrop(h: EventDropHandler<TMeta>): this;
-    onDateClick(h: DateClickHandler): this;
-    onTimeClick(h: TimeClickHandler): this;
-    /**
-     * Audit Session 5 N1 — `onMoreClick` is wired by month-view's
-     * "+N more" overflow surface, which is a Session 3.5+ visual
-     * polish item. The setter is honoured today (handler stored on
-     * state, read-on-fire), but the overflow trigger is not yet
-     * implemented in `<CoarMonthView>`. A one-shot dev-warn surfaces
-     * the gap so consumers don't ship features that never fire.
-     */
-    onMoreClick(h: MoreClickHandler<TMeta>): this;
-    onRangeChange(h: RangeChangeHandler): this;
+    private _installWatchers;
+    protected _validateEvents(events: ReadonlyArray<CalendarEvent<TMeta>>): void;
+    protected _resetLoaderCache(): void;
+    protected _invalidateSeries(rerun: boolean): void;
+    protected _resetRecurrenceEngine(): void;
     private _goTo;
     private _goToToday;
     private _navigate;
     private _setView;
     private _setMonthDensity;
     private _setDayMode;
+    private _warnScrollNotWired;
     /**
      * SOLE writer of `_visibleRange`. Called by `useViewWindow` only.
      *
-     * **Audit fix #2 (Session 2):** symbol-keyed instead of
-     * underscore-prefixed-public so consumers cannot forge windows by
-     * calling `builder._setVisibleRange(...)` from outside. The symbol
-     * is exported from `calendar-builder-internals.ts` which is
-     * intentionally NOT in `index.ts`'s public surface.
+     * Symbol-keyed instead of underscore-prefixed-public so consumers
+     * cannot forge windows by calling `builder._setVisibleRange(...)`
+     * from outside. The symbol is exported from
+     * `calendar-builder-internals.ts`, which is intentionally NOT in
+     * `index.ts`'s public surface.
      *
-     * Side effects:
-     *   1. Updates the readonly `api.visibleRange` ref.
-     *   2. Fires the consumer's `onRangeChange` handler (deduped via
-     *      window-equality check — no-op if the window didn't change).
-     *   3. Schedules a debounced loader call if `eventsLoader` is set
-     *      and the cache doesn't already have this window.
+     * Side effects (no-op when the window didn't change): updates
+     * `api.visibleRange`, fires `onRangeChange`, schedules the loader on
+     * a cache miss, runs the recurring-series expansion.
      *
      * @internal symbol-keyed; reachable only via the internal symbol.
      */
     [SET_VISIBLE_RANGE](window: ViewWindow | null): void;
+    /** @internal symbol-keyed — the continuous month surface's live anchor. */
+    [SET_TOPMOST_VISIBLE_MONTH](month: Temporal.PlainYearMonth | null): void;
     /**
-     * Invalidate the entire loader cache. Called by `api.refresh()`.
-     * Bumps the generation counter so any in-flight loader resolves
-     * into the void instead of poisoning fresh data.
+     * Invalidate both caches. Called by `api.refresh()`. In-flight
+     * results are discarded on arrival instead of poisoning fresh data.
      *
      * @internal symbol-keyed; reachable only via the internal symbol.
      */
     [INVALIDATE_LOADER_CACHE](): void;
-    private _maybeScheduleLoad;
-    private _runLoader;
     /**
-     * Audit fix #1 — validate every event in `events` against C1 at the
-     * runtime boundary. WeakSet-memoized per-event-object so repeated
-     * renders of the same array don't pay the cost.
+     * Warm both caches for windows the user is about to see — the
+     * neighbour pages drawn during a swipe. Cache hits and in-flight
+     * windows are skipped; `_visibleRange` and `onRangeChange` are NOT
+     * touched, so consumers see no navigation.
      *
-     * Throws on the first bad event with `validateCalendarEvent`'s
-     * error (which names the event id). Loader path catches this in
-     * the `.catch` and logs without caching; events-source path lets
-     * it propagate so the consumer's render fails loudly (Article 9 —
-     * silent partial-render hiding bad data is the worse outcome).
-     */
-    private _validateEvents;
-    private _warnedScrollMethods;
-    /**
-     * Audit fix #16 — `scrollTo*` is wired by component mount in
-     * Session 3. Until then, calling it is a no-op; in dev we log
-     * once-per-method so consumer e2e tests don't false-pass.
+     * @internal symbol-keyed; reachable only via the internal symbol.
      */
-    private _warnScrollNotWired;
+    [PREFETCH_WINDOWS](windows: ReadonlyArray<ViewWindow>): void;
     private _refresh;
     private _refreshRange;
-    private _getVisibleEvents;
-    private _getNonRecurringEvents;
-    private _getRecurringEvents;
-    /**
-     * Resolve the configured engine, lazy-constructing factory form
-     * once. Returns `undefined` when no engine is configured —
-     * `expandSeries` falls back to its own lazy default
-     * (rrule-temporal) in that case.
-     */
-    private _resolveEngine;
-    /**
-     * Trigger a recurring-series expansion for `window`. No-op if no
-     * series source is configured. Cache hit short-circuits.
-     *
-     * Async by design (the engine interface is async). Result lands in
-     * `_seriesCache` on success; consumers read via
-     * `getVisibleEvents()` which reactively re-renders when the cache
-     * shallowRef updates.
-     *
-     * Generation-guarded: a result that arrives after `refresh()` /
-     * source-replacement is discarded so it doesn't poison fresh data.
-     */
-    private _runSeriesExpansion;
-    private _loadExpandSeries;
-    private _readSeriesForWindow;
-    /**
-     * Snapshot of the loader cache keys for diagnostics / tests.
-     * Not part of the public API surface.
-     *
-     * @internal
-     */
+    /** Snapshot of the loader cache keys for diagnostics / tests. @internal */
     _debug_cacheKeys(): string[];
-    /**
-     * Current in-flight counter for diagnostics / tests.
-     *
-     * @internal
-     */
+    /** Current in-flight counter for diagnostics / tests. @internal */
     _debug_inFlight(): number;
     /** @internal */
     _setScrollToTime(fn: ((time: Temporal.PlainTime) => void) | undefined): void;

package/dist/builders/calendar-builder.d.ts.map

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

package/dist/builders/internal/event-validation.d.ts

@@ -0,0 +1,13 @@
+import { CalendarEvent } from '../../core';
+export declare class EventValidator<TMeta extends Record<string, unknown>> {
+    private readonly _validated;
+    /**
+     * Throws on the first bad event with `validateCalendarEvent`'s
+     * error (which names the event id). The loader path catches this
+     * and logs without caching; the events-source path lets it
+     * propagate so the consumer's setup fails loudly (Article 9 —
+     * silent partial-render hiding bad data is the worse outcome).
+     */
+    validate(events: ReadonlyArray<CalendarEvent<TMeta>>): void;
+}
+//# sourceMappingURL=event-validation.d.ts.map

package/dist/builders/internal/event-validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-validation.d.ts","sourceRoot":"","sources":["../../../src/builders/internal/event-validation.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAyB,KAAK,aAAa,EAAE,MAAM,YAAY,CAAC;AAEvE,qBAAa,cAAc,CAAC,KAAK,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAC/D,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAyB;IAEpD;;;;;;OAMG;IACH,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC,GAAG,IAAI;CAY5D"}

package/dist/builders/internal/events-for-window.d.ts

@@ -0,0 +1,6 @@
+import { CalendarEvent, ViewWindow } from '../../core';
+import { CalendarBuilderState } from '../calendar-builder-state';
+import { LoaderPipeline } from './loader-pipeline';
+import { SeriesPipeline } from './series-pipeline';
+export declare function eventsForWindow<TMeta extends Record<string, unknown>>(state: Pick<CalendarBuilderState<TMeta>, 'events'>, loader: LoaderPipeline<TMeta>, series: SeriesPipeline<TMeta>, window: ViewWindow | null): CalendarEvent<TMeta>[];
+//# sourceMappingURL=events-for-window.d.ts.map

package/dist/builders/internal/events-for-window.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"events-for-window.d.ts","sourceRoot":"","sources":["../../../src/builders/internal/events-for-window.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,KAAK,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAC5D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AACtE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAExD,wBAAgB,eAAe,CAAC,KAAK,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACnE,KAAK,EAAE,IAAI,CAAC,oBAAoB,CAAC,KAAK,CAAC,EAAE,QAAQ,CAAC,EAClD,MAAM,EAAE,cAAc,CAAC,KAAK,CAAC,EAC7B,MAAM,EAAE,cAAc,CAAC,KAAK,CAAC,EAC7B,MAAM,EAAE,UAAU,GAAG,IAAI,GACxB,aAAa,CAAC,KAAK,CAAC,EAAE,CAMxB"}

package/dist/builders/internal/loader-pipeline.d.ts

@@ -0,0 +1,50 @@
+import { ShallowRef } from 'vue';
+import { CalendarEvent, ViewWindow } from '../../core';
+import { EventsLoader } from '../types';
+import { LoadingTracker } from './loading-tracker';
+import { EventValidator } from './event-validation';
+export interface LoaderPipelineDeps<TMeta extends Record<string, unknown>> {
+    /** Read on every call (C7). `null` = `events()` mode, nothing to load. */
+    loader: () => EventsLoader<TMeta> | null;
+    validator: EventValidator<TMeta>;
+    loading: LoadingTracker;
+}
+export declare class LoaderPipeline<TMeta extends Record<string, unknown>> {
+    private readonly deps;
+    /** Map<windowKey, events>. */
+    readonly cache: ShallowRef<Map<string, CalendarEvent<TMeta>[]>>;
+    /**
+     * Bumped on every invalidation so an in-flight loader whose result
+     * arrives AFTER the invalidation is discarded instead of poisoning
+     * fresh data.
+     */
+    private _generation;
+    private _debounceHandle;
+    /** Window keys with a fetch in flight — `prefetch` must not double-dispatch. */
+    private readonly _inFlightKeys;
+    constructor(deps: LoaderPipelineDeps<TMeta>);
+    /** Cached events for `window`, or `undefined` on a miss. */
+    get(window: ViewWindow): CalendarEvent<TMeta>[] | undefined;
+    has(window: ViewWindow): boolean;
+    /** Schedule a debounced load unless the window is already cached. */
+    maybeSchedule(window: ViewWindow): void;
+    /**
+     * Warm the cache for a window the user is about to see. No
+     * debounce — this runs AFTER the visible window settled — and no
+     * double dispatch while the same window is already in flight.
+     */
+    prefetch(window: ViewWindow): void;
+    /** Invoke the loader for `window` now (no debounce). */
+    run(window: ViewWindow): void;
+    /** Drop everything; in-flight results are discarded on arrival. */
+    invalidateAll(): void;
+    /**
+     * Drop cached entries whose window intersects `window` (same view
+     * + zone, overlapping bounds). Returns `true` when something was
+     * dropped.
+     */
+    invalidateIntersecting(window: ViewWindow): boolean;
+    /** Snapshot of the cache keys (diagnostics / tests). */
+    keys(): string[];
+}
+//# sourceMappingURL=loader-pipeline.d.ts.map