@cocoar/vue-calendar 1.16.0

package/dist/composables/useCalendarDnd.d.ts

@@ -0,0 +1,212 @@
+import { ComputedRef, Ref } from 'vue';
+import { Temporal, CalendarEvent } from '../core';
+import { CalendarDragMode, CalendarDropTarget, DstPolicy, MoveResult } from '../core/dnd/move-math';
+export type { DstPolicy } from '../core/dnd/move-math';
+export { buildDropPayload } from '../core/dnd/move-math';
+/**
+ * Re-export of the canonical `CalendarDropTarget` from
+ * `core/dnd/move-math`. Comment kept here for the existing
+ * import path.
+ *
+ * `date`: ISO date string (`YYYY-MM-DD`) of the day-column.
+ *
+ * `minutes`: minutes from local midnight, snapped to `slotDuration`.
+ * `null` for all-day drops — no time component, the drop is "place
+ * this event on this date" regardless of where vertically the
+ * pointer is.
+ */
+export type { CalendarDropTarget };
+export interface UseCalendarDndOptions {
+    /** Scrollable surface element (for auto-scroll). */
+    surfaceRef: Ref<HTMLElement | null>;
+    /**
+     * The columns container (`.coar-time-grid__columns`). Used as the
+     * hit-test reference frame for timed-event drags. Optional —
+     * month-view consumers don't have a time-grid.
+     */
+    columnsRef?: Ref<HTMLElement | null>;
+    /**
+     * Optional separate hit-test container for the all-day band
+     * (`.coar-time-grid__all-day-columns`). When set, drags initiated
+     * with `mode: 'allDay'` snap to date-only targets relative to this
+     * container, so the user can move all-day bars horizontally
+     * across days without touching the time-grid math.
+     */
+    allDayColumnsRef?: Ref<HTMLElement | null>;
+    /**
+     * Optional 6×7 month-grid container. When set, `startMonthDrag`
+     * snaps to date-only targets via a 2D cell hit-test against this
+     * container. Pair with `monthGridDates` (42 dates).
+     */
+    monthGridRef?: Ref<HTMLElement | null>;
+    /** Visible days for the time-grid (left-to-right). Required when columnsRef is set. */
+    days?: ComputedRef<ReadonlyArray<Temporal.PlainDate>> | Ref<ReadonlyArray<Temporal.PlainDate>>;
+    /**
+     * 42 dates for the month grid (6 rows × 7 cols, top-left first).
+     * Required when `monthGridRef` is set.
+     */
+    monthGridDates?: ComputedRef<ReadonlyArray<Temporal.PlainDate>> | Ref<ReadonlyArray<Temporal.PlainDate>>;
+    /** `[startHour, endHour]`. Required when columnsRef is set. */
+    timeRange?: ComputedRef<readonly [number, number]> | Ref<readonly [number, number]>;
+    /** Pixels per hour (for translating Y → minutes). Required when columnsRef is set. */
+    pixelsPerHour?: ComputedRef<number> | Ref<number>;
+    /** Slot subdivision in minutes (e.g. 30). Required when columnsRef is set. */
+    slotDuration?: ComputedRef<number> | Ref<number>;
+    /**
+     * IANA display timezone — the zone the calendar is currently
+     * rendering in. Required for timed targets so move-math can resolve
+     * the slot in the same zone the user's eyes saw it. Default `'UTC'`.
+     * Real consumers pass `builder.timezone()` (the same value the
+     * layouts use).
+     */
+    /**
+     * IANA display timezone — the zone the calendar is currently
+     * rendering in. **Required** since Phase 8.11-AC. Required for
+     * timed targets so move-math can resolve the slot in the same
+     * zone the user's eyes saw it (Article 4 + Article 9 — defaults
+     * are not decisions, the silent-UTC fallback used to be a real
+     * foot-gun for direct callers).
+     */
+    timezone: ComputedRef<string> | Ref<string>;
+    /**
+     * DST disambiguation policy. Forwarded into `applyMoveToEvent`. See
+     * `DstPolicy` in `core/dnd/move-math` for semantics. Default
+     * `'compatible'` matches the polyfill default.
+     */
+    dstPolicy?: ComputedRef<DstPolicy> | Ref<DstPolicy>;
+    /**
+     * Render-buffer offset (in minutes) the time-grid applies above the
+     * first hour. CoarTimeGrid leaves some visual padding above
+     * `timeRange[0]` so events at the boundary have room for their
+     * focus halo / resize handle. The hit-test must subtract that
+     * offset so a click in the buffer zone doesn't map to a negative
+     * time. Default 0 (no buffer). Set this to whatever
+     * `RENDER_BUFFER_MINUTES` the time-grid uses.
+     */
+    timeGridTopBufferMinutes?: ComputedRef<number> | Ref<number>;
+    /**
+     * Pointer-distance threshold (px) below which a pointerup is
+     * treated as a click instead of a drop. Default 5. Forwarded to
+     * `useCoarDrag.dragThreshold`.
+     */
+    dragThreshold?: number;
+    /**
+     * Optional drop validator. Called per pointer-move once a target
+     * slot has been hit-tested. Return `false` to mark the slot as
+     * invalid — the ghost still renders (so the user sees their
+     * pointer position) but with an invalid style, and `onEventDrop`
+     * won't fire on release. Returning `true` (or omitting the
+     * predicate) keeps the slot valid.
+     *
+     * Use this for business rules like "daily standups can't move to
+     * a weekend" or "blocked hours can't accept events".
+     */
+    canDrop?: (event: CalendarEvent, target: CalendarDropTarget) => boolean;
+    /**
+     * Called once the pointer crossed the drag threshold AND the user
+     * released over a valid slot. Consumer applies `next` to its data.
+     */
+    onEventDrop?: (payload: {
+        event: CalendarEvent;
+        original: {
+            start: Temporal.ZonedDateTime | Temporal.PlainDate;
+            end?: Temporal.ZonedDateTime | Temporal.PlainDate;
+            displayZone: string;
+        };
+        next: MoveResult;
+        target: CalendarDropTarget & {
+            disambiguation: null | 'gap' | 'overlap';
+        };
+        native: PointerEvent | null;
+    }) => void;
+    /**
+     * Called when pointer-down → up happened without crossing the
+     * drag threshold. Lets the consumer keep its `event-click` UX.
+     */
+    onEventClick?: (event: CalendarEvent, native: PointerEvent | null) => void;
+}
+/**
+ * Drag mode of the in-flight drag.
+ *
+ *   - `'timed'`               — move a timed event in the time-grid
+ *   - `'timed-resize-start'`  — drag the top edge of a timed event
+ *   - `'timed-resize-end'`    — drag the bottom edge of a timed event
+ *   - `'allDay'`              — move an all-day bar across days
+ *   - `'allDay-resize-start'` — drag the left edge of an all-day bar
+ *   - `'allDay-resize-end'`   — drag the right edge of an all-day bar
+ *   - `'month'`               — move a pill / multi-day bar across cells
+ *
+ * Resize modes only ever update one side of the event (start XOR
+ * end). Move modes preserve the duration / span. The composable
+ * picks the right `applyMoveToEvent` branch based on the mode set
+ * by the matching `start*Drag` closure.
+ */
+export type { CalendarDragMode };
+export interface UseCalendarDndReturn {
+    /** True only once the pointer has crossed the drag threshold. */
+    isDragging: ComputedRef<boolean>;
+    /** The event currently being dragged (or null when idle). */
+    draggedEvent: ComputedRef<CalendarEvent | null>;
+    /** Drag mode of the in-flight drag, or `null` when idle. */
+    dragMode: ComputedRef<CalendarDragMode | null>;
+    /** Current drop slot (or null when off-grid / idle). */
+    dropTarget: Ref<CalendarDropTarget | null>;
+    /**
+     * True for a brief window after the user released on an invalid
+     * drop target. Lets the consumer keep the "invalid" ghost
+     * rendered just long enough to play a fade-out animation, so the
+     * rejection reads as a soft snap-back rather than an instant
+     * disappear. Always `false` while the user is still dragging —
+     * use `isDragging.value || snappingBack.value` in templates.
+     */
+    snappingBack: ComputedRef<boolean>;
+    /**
+     * Pointerdown handler for a TIMED event card. Resolves to a
+     * `{ date, minutes }` slot via the time-grid hit-test.
+     */
+    startDrag: (event: CalendarEvent) => (e: PointerEvent) => void;
+    /** Top-edge handle: only the start moves, end stays anchored. */
+    startTimedResizeStart: (event: CalendarEvent) => (e: PointerEvent) => void;
+    /** Bottom-edge handle: only the end moves, start stays anchored. */
+    startTimedResizeEnd: (event: CalendarEvent) => (e: PointerEvent) => void;
+    /**
+     * Pointerdown handler for an ALL-DAY bar. Resolves to a
+     * `{ date, minutes: null }` slot via the all-day-band hit-test
+     * (X-only — the vertical position inside the band doesn't carry
+     * any meaning for an all-day event).
+     */
+    startAllDayDrag: (event: CalendarEvent) => (e: PointerEvent) => void;
+    /** Left-edge handle on a multi-day all-day bar: start moves only. */
+    startAllDayResizeStart: (event: CalendarEvent) => (e: PointerEvent) => void;
+    /** Right-edge handle on a multi-day all-day bar: end moves only. */
+    startAllDayResizeEnd: (event: CalendarEvent) => (e: PointerEvent) => void;
+    /**
+     * Pointerdown handler for a MONTH-view event (pill or multi-day
+     * bar). Resolves to a `{ date, minutes: null }` slot via the
+     * 6×7 month-grid hit-test. Drop preserves the event's wall-time
+     * (timed events) or shifts the all-day span (date-only events)
+     * by the original-vs-target date delta.
+     */
+    startMonthDrag: (event: CalendarEvent) => (e: PointerEvent) => void;
+    /** Left-edge handle on a multi-day month bar: start moves only. */
+    startMonthResizeStart: (event: CalendarEvent) => (e: PointerEvent) => void;
+    /** Right-edge handle on a multi-day month bar: end moves only. */
+    startMonthResizeEnd: (event: CalendarEvent) => (e: PointerEvent) => void;
+}
+export declare function useCalendarDnd(opts: UseCalendarDndOptions): UseCalendarDndReturn;
+/**
+ * Re-export of the pure-function move/resize math. Lives in
+ * `core/dnd/move-math.ts` since Phase 7.7 — kept here for the
+ * existing import path (`from '../composables/useCalendarDnd'`).
+ *
+ *   - Move modes preserve duration / span and shift the whole
+ *     event to the target slot.
+ *   - Resize modes only update one side (start XOR end). The other
+ *     side is preserved from the original event, with a small
+ *     minimum-duration clamp so the user can't flip the event
+ *     past zero.
+ *
+ * Pure-function on inputs — no side effects.
+ */
+export { applyMoveToEvent } from '../core/dnd/move-math';
+//# sourceMappingURL=useCalendarDnd.d.ts.map

package/dist/composables/useCalendarDnd.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useCalendarDnd.d.ts","sourceRoot":"","sources":["../../src/composables/useCalendarDnd.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,EAAwB,KAAK,WAAW,EAAE,KAAK,GAAG,EAAE,MAAM,KAAK,CAAC;AACvE,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AACnC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAC7C,OAAO,EAIL,KAAK,gBAAgB,EACrB,KAAK,kBAAkB,EACvB,KAAK,SAAS,EACd,KAAK,UAAU,EAChB,MAAM,uBAAuB,CAAC;AAC/B,YAAY,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAqDzD;;;;;;;;;;;GAWG;AACH,YAAY,EAAE,kBAAkB,EAAE,CAAC;AAEnC,MAAM,WAAW,qBAAqB;IACpC,oDAAoD;IACpD,UAAU,EAAE,GAAG,CAAC,WAAW,GAAG,IAAI,CAAC,CAAC;IACpC;;;;OAIG;IACH,UAAU,CAAC,EAAE,GAAG,CAAC,WAAW,GAAG,IAAI,CAAC,CAAC;IACrC;;;;;;OAMG;IACH,gBAAgB,CAAC,EAAE,GAAG,CAAC,WAAW,GAAG,IAAI,CAAC,CAAC;IAC3C;;;;OAIG;IACH,YAAY,CAAC,EAAE,GAAG,CAAC,WAAW,GAAG,IAAI,CAAC,CAAC;IACvC,uFAAuF;IACvF,IAAI,CAAC,EAAE,WAAW,CAAC,aAAa,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,GAAG,GAAG,CAAC,aAAa,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC;IAC/F;;;OAGG;IACH,cAAc,CAAC,EAAE,WAAW,CAAC,aAAa,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,GAAG,GAAG,CAAC,aAAa,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC;IACzG,+DAA+D;IAC/D,SAAS,CAAC,EAAE,WAAW,CAAC,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,GAAG,GAAG,CAAC,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IACpF,sFAAsF;IACtF,aAAa,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,GAAG,GAAG,CAAC,MAAM,CAAC,CAAC;IAClD,8EAA8E;IAC9E,YAAY,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,GAAG,GAAG,CAAC,MAAM,CAAC,CAAC;IACjD;;;;;;OAMG;IACH;;;;;;;OAOG;IACH,QAAQ,EAAE,WAAW,CAAC,MAAM,CAAC,GAAG,GAAG,CAAC,MAAM,CAAC,CAAC;IAC5C;;;;OAIG;IACH,SAAS,CAAC,EAAE,WAAW,CAAC,SAAS,CAAC,GAAG,GAAG,CAAC,SAAS,CAAC,CAAC;IACpD;;;;;;;;OAQG;IACH,wBAAwB,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,GAAG,GAAG,CAAC,MAAM,CAAC,CAAC;IAC7D;;;;OAIG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;;;;;;;;;OAUG;IACH,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,aAAa,EAAE,MAAM,EAAE,kBAAkB,KAAK,OAAO,CAAC;IACxE;;;OAGG;IACH,WAAW,CAAC,EAAE,CAAC,OAAO,EAAE;QACtB,KAAK,EAAE,aAAa,CAAC;QACrB,QAAQ,EAAE;YACR,KAAK,EAAE,QAAQ,CAAC,aAAa,GAAG,QAAQ,CAAC,SAAS,CAAC;YACnD,GAAG,CAAC,EAAE,QAAQ,CAAC,aAAa,GAAG,QAAQ,CAAC,SAAS,CAAC;YAClD,WAAW,EAAE,MAAM,CAAC;SACrB,CAAC;QACF,IAAI,EAAE,UAAU,CAAC;QACjB,MAAM,EAAE,kBAAkB,GAAG;YAC3B,cAAc,EAAE,IAAI,GAAG,KAAK,GAAG,SAAS,CAAC;SAC1C,CAAC;QACF,MAAM,EAAE,YAAY,GAAG,IAAI,CAAC;KAC7B,KAAK,IAAI,CAAC;IACX;;;OAGG;IACH,YAAY,CAAC,EAAE,CAAC,KAAK,EAAE,aAAa,EAAE,MAAM,EAAE,YAAY,GAAG,IAAI,KAAK,IAAI,CAAC;CAC5E;AAED;;;;;;;;;;;;;;;GAeG;AACH,YAAY,EAAE,gBAAgB,EAAE,CAAC;AAEjC,MAAM,WAAW,oBAAoB;IACnC,iEAAiE;IACjE,UAAU,EAAE,WAAW,CAAC,OAAO,CAAC,CAAC;IACjC,6DAA6D;IAC7D,YAAY,EAAE,WAAW,CAAC,aAAa,GAAG,IAAI,CAAC,CAAC;IAChD,4DAA4D;IAC5D,QAAQ,EAAE,WAAW,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAAC;IAC/C,wDAAwD;IACxD,UAAU,EAAE,GAAG,CAAC,kBAAkB,GAAG,IAAI,CAAC,CAAC;IAC3C;;;;;;;OAOG;IACH,YAAY,EAAE,WAAW,CAAC,OAAO,CAAC,CAAC;IACnC;;;OAGG;IACH,SAAS,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,CAAC,CAAC,EAAE,YAAY,KAAK,IAAI,CAAC;IAC/D,iEAAiE;IACjE,qBAAqB,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,CAAC,CAAC,EAAE,YAAY,KAAK,IAAI,CAAC;IAC3E,oEAAoE;IACpE,mBAAmB,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,CAAC,CAAC,EAAE,YAAY,KAAK,IAAI,CAAC;IACzE;;;;;OAKG;IACH,eAAe,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,CAAC,CAAC,EAAE,YAAY,KAAK,IAAI,CAAC;IACrE,qEAAqE;IACrE,sBAAsB,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,CAAC,CAAC,EAAE,YAAY,KAAK,IAAI,CAAC;IAC5E,oEAAoE;IACpE,oBAAoB,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,CAAC,CAAC,EAAE,YAAY,KAAK,IAAI,CAAC;IAC1E;;;;;;OAMG;IACH,cAAc,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,CAAC,CAAC,EAAE,YAAY,KAAK,IAAI,CAAC;IACpE,mEAAmE;IACnE,qBAAqB,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,CAAC,CAAC,EAAE,YAAY,KAAK,IAAI,CAAC;IAC3E,kEAAkE;IAClE,mBAAmB,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,CAAC,CAAC,EAAE,YAAY,KAAK,IAAI,CAAC;CAC1E;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,qBAAqB,GAAG,oBAAoB,CAggBhF;AAED;;;;;;;;;;;;;GAaG;AACH,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/composables/useCoarDrag.d.ts

@@ -0,0 +1,97 @@
+import { ComputedRef, Ref, ShallowRef } from 'vue';
+import { AutoScrollOptions } from '../core/dragHitTest';
+export interface DragContext<T> {
+    /** The data the consumer attached to the dragged item. */
+    data: T;
+    /** Pointer's current screen-x / screen-y. */
+    pointer: {
+        x: number;
+        y: number;
+    };
+    /** Pointer's offset from drag-start. */
+    delta: {
+        x: number;
+        y: number;
+    };
+    /** Surface's scrollLeft / scrollTop at drag-start. */
+    startScroll: {
+        left: number;
+        top: number;
+    };
+    /** Surface's scrollLeft / scrollTop at the moment of this callback. */
+    scroll: {
+        left: number;
+        top: number;
+    };
+    /** Pointer's offset from drag-start INCLUDING auto-scroll motion. */
+    totalDelta: {
+        x: number;
+        y: number;
+    };
+    /**
+     * `true` once the pointer has moved past `dragThreshold`. With the
+     * default `dragThreshold: 0`, this is `true` from the very first
+     * move. Read it in `onDragEnd` to disambiguate "drop" from "click"
+     * — when it stays `false`, the user just pressed-and-released
+     * without any meaningful movement.
+     */
+    crossedThreshold: boolean;
+}
+export interface UseCoarDragOptions<T> {
+    /**
+     * Element that scrolls during the drag (typically the
+     * `<VirtualizedSurface*>` root). Used both to clamp auto-scroll
+     * bounds and to write `scrollTop` / `scrollLeft` for auto-scroll.
+     * Pass `null` to disable auto-scroll entirely.
+     */
+    surfaceRef: Ref<HTMLElement | null>;
+    /**
+     * Auto-scroll behaviour. Pass `null` to disable auto-scroll while
+     * keeping drag tracking otherwise. Default: enabled with
+     * 30 px hot zone, 24 px/frame max velocity, linear curve.
+     */
+    autoScroll?: AutoScrollOptions | null;
+    /**
+     * Distance in pixels (Manhattan-style: max of |dx|, |dy|) the
+     * pointer must travel before the drag is considered "active".
+     * Below this, `onDragMove` is suppressed and `isDragging` stays
+     * `false`. On `onDragEnd`, `ctx.crossedThreshold` tells the
+     * consumer whether a real drop happened or it was just a click.
+     *
+     * Default `0` keeps the legacy behaviour: every drag is active
+     * from pointerdown. Set to e.g. `5` to get standard click-vs-drag
+     * disambiguation (typical for direct-manipulation UIs like a
+     * calendar event card you can both click AND drag).
+     */
+    dragThreshold?: number;
+    /**
+     * Called once on pointerdown that becomes a drag. Return `false`
+     * to cancel the drag (no callbacks fire afterwards).
+     */
+    onDragStart?: (ctx: {
+        event: PointerEvent;
+        data: T;
+    }) => boolean | void;
+    /**
+     * Called on each rAF tick while dragging. Coalesces multiple
+     * pointermove events between frames.
+     */
+    onDragMove?: (ctx: DragContext<T>) => void;
+    /** Called on pointerup. */
+    onDragEnd?: (ctx: DragContext<T>) => void;
+    /** Called on pointercancel or Escape key. */
+    onDragCancel?: (ctx: DragContext<T>) => void;
+}
+export interface UseCoarDragReturn<T> {
+    /** True while a drag is in progress. */
+    isDragging: ComputedRef<boolean>;
+    /** The data of the currently-dragged item (or null when idle). */
+    draggedData: ShallowRef<T | null>;
+    /**
+     * Returns a `pointerdown` handler bound to the supplied data. Use
+     * via `@pointerdown="startDrag(item)"`.
+     */
+    startDrag: (data: T) => (event: PointerEvent) => void;
+}
+export declare function useCoarDrag<T>(opts: UseCoarDragOptions<T>): UseCoarDragReturn<T>;
+//# sourceMappingURL=useCoarDrag.d.ts.map

package/dist/composables/useCoarDrag.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useCoarDrag.d.ts","sourceRoot":"","sources":["../../src/composables/useCoarDrag.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAEH,OAAO,EAIL,KAAK,WAAW,EAChB,KAAK,GAAG,EACR,KAAK,UAAU,EAChB,MAAM,KAAK,CAAC;AAEb,OAAO,EAEL,KAAK,iBAAiB,EACvB,MAAM,qBAAqB,CAAC;AAE7B,MAAM,WAAW,WAAW,CAAC,CAAC;IAC5B,0DAA0D;IAC1D,IAAI,EAAE,CAAC,CAAC;IACR,6CAA6C;IAC7C,OAAO,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAClC,wCAAwC;IACxC,KAAK,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAChC,sDAAsD;IACtD,WAAW,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC;IAC3C,uEAAuE;IACvE,MAAM,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC;IACtC,qEAAqE;IACrE,UAAU,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACrC;;;;;;OAMG;IACH,gBAAgB,EAAE,OAAO,CAAC;CAC3B;AAED,MAAM,WAAW,kBAAkB,CAAC,CAAC;IACnC;;;;;OAKG;IACH,UAAU,EAAE,GAAG,CAAC,WAAW,GAAG,IAAI,CAAC,CAAC;IACpC;;;;OAIG;IACH,UAAU,CAAC,EAAE,iBAAiB,GAAG,IAAI,CAAC;IACtC;;;;;;;;;;;OAWG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;;OAGG;IACH,WAAW,CAAC,EAAE,CAAC,GAAG,EAAE;QAAE,KAAK,EAAE,YAAY,CAAC;QAAC,IAAI,EAAE,CAAC,CAAA;KAAE,KAAK,OAAO,GAAG,IAAI,CAAC;IACxE;;;OAGG;IACH,UAAU,CAAC,EAAE,CAAC,GAAG,EAAE,WAAW,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC;IAC3C,2BAA2B;IAC3B,SAAS,CAAC,EAAE,CAAC,GAAG,EAAE,WAAW,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC;IAC1C,6CAA6C;IAC7C,YAAY,CAAC,EAAE,CAAC,GAAG,EAAE,WAAW,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC;CAC9C;AAED,MAAM,WAAW,iBAAiB,CAAC,CAAC;IAClC,wCAAwC;IACxC,UAAU,EAAE,WAAW,CAAC,OAAO,CAAC,CAAC;IACjC,kEAAkE;IAClE,WAAW,EAAE,UAAU,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;IAClC;;;OAGG;IACH,SAAS,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,KAAK,EAAE,YAAY,KAAK,IAAI,CAAC;CACvD;AAED,wBAAgB,WAAW,CAAC,CAAC,EAAE,IAAI,EAAE,kBAAkB,CAAC,CAAC,CAAC,GAAG,iBAAiB,CAAC,CAAC,CAAC,CAkOhF"}

package/dist/composables/useMonthDnd.d.ts

@@ -0,0 +1,89 @@
+import { ComputedRef, MaybeRefOrGetter, Ref } from 'vue';
+import { CalendarDragMode, UseCalendarDndReturn } from './useCalendarDnd';
+import { DstPolicy, EventDropPayload, MoveResult } from '../core/dnd/move-math';
+import { Temporal, CalendarEvent } from '../core';
+/**
+ * Month drop payload — alias for the canonical `EventDropPayload`
+ * shape from core/dnd/move-math. Kept for backward-compatible import
+ * paths; new code should use `EventDropPayload` directly.
+ */
+export type MonthEventDropPayload = EventDropPayload;
+export interface MonthDragSourceSnapshot {
+    /** Pill ranges per cell-day-key the dragged event occupied. */
+    pillCells: ReadonlyArray<string>;
+    /** Multi-day bar ranges per row, if applicable. */
+    bars: ReadonlyArray<{
+        rowIndex: number;
+        startCol: number;
+        endCol: number;
+        lane: number;
+        clippedStart: boolean;
+        clippedEnd: boolean;
+    }>;
+    event: CalendarEvent;
+}
+export interface InvalidMonthGhost {
+    rowIndex: number;
+    startCol: number;
+    endCol: number;
+    isBar: boolean;
+}
+export interface UseMonthDndOptions {
+    /** Source events. */
+    events: MaybeRefOrGetter<ReadonlyArray<CalendarEvent>>;
+    /** 42 dates for the visible month grid (6×7, top-left first). */
+    gridDates: ComputedRef<ReadonlyArray<Temporal.PlainDate>> | Ref<ReadonlyArray<Temporal.PlainDate>>;
+    /** Element used as the month-grid hit-test reference. */
+    gridRef: Ref<HTMLElement | null>;
+    /** Effective IANA timezone for instant ↔ date math. */
+    timezone: MaybeRefOrGetter<string>;
+    /** DST disambiguation policy (Article 5). Default `'compatible'`. */
+    dstPolicy?: MaybeRefOrGetter<DstPolicy>;
+    /** Drop validator. Returning false marks the target invalid. */
+    canDrop?: (event: CalendarEvent, target: {
+        date: string;
+        minutes: number | null;
+    }) => boolean;
+    /** User clicked an event without crossing the drag threshold. */
+    onEventClick?: (event: CalendarEvent, native: PointerEvent | null) => void;
+    /** A drag completed (or a keyboard move fired). */
+    onEventDrop?: (payload: MonthEventDropPayload) => void;
+    /**
+     * Optional screen-reader announcer hook. Called after every
+     * commit (mouse drop OR keyboard Enter) and after every cancel
+     * (keyboard Escape).
+     */
+    onAnnounce?: (kind: 'committed' | 'cancelled', payload?: MonthEventDropPayload) => void;
+}
+/**
+ * Snapshot of the in-flight keyboard-drag state. Drives the same
+ * preview-ghost / source-phantom rendering pipeline as a pointer
+ * drag — the visuals don't care which input modality started
+ * the drag.
+ */
+export interface KeyboardDragState {
+    event: CalendarEvent;
+    /** Working start/end after applying the arrow-key moves so far. */
+    next: MoveResult;
+    mode: CalendarDragMode;
+    /** Display zone snapshotted on first arrow keystroke. */
+    startDisplayZone: string;
+    /** Event start at first arrow keystroke (in case consumer
+     *  mutates event mid-drag). */
+    originalStart: Temporal.ZonedDateTime | Temporal.PlainDate;
+    originalEnd?: Temporal.ZonedDateTime | Temporal.PlainDate;
+}
+export interface UseMonthDndReturn {
+    dnd: UseCalendarDndReturn;
+    workingEvents: ComputedRef<ReadonlyArray<CalendarEvent>>;
+    dragSourceSnapshot: Ref<MonthDragSourceSnapshot | null>;
+    invalidMonthGhost: ComputedRef<InvalidMonthGhost | null>;
+    isPreviewId: (id: string) => boolean;
+    isInvalidPillTarget: (day: Temporal.PlainDate) => boolean;
+    onMonthEventPointerdown: (e: PointerEvent, event: CalendarEvent) => void;
+    onMonthEventKeydown: (e: KeyboardEvent, event: CalendarEvent) => void;
+    /** Active keyboard-drag state, or `null` when no kbd-drag is in flight. */
+    keyboardDrag: Ref<KeyboardDragState | null>;
+}
+export declare function useMonthDnd(opts: UseMonthDndOptions): UseMonthDndReturn;
+//# sourceMappingURL=useMonthDnd.d.ts.map

package/dist/composables/useMonthDnd.d.ts.map

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

package/dist/composables/useMonthExpansion.d.ts

@@ -0,0 +1,35 @@
+import { ComputedRef, Ref } from 'vue';
+import { MonthLayout } from '../core';
+export interface UseMonthExpansionOptions {
+    /** Pixel-perfect month layout from `layoutMonthGrid`. */
+    layout: ComputedRef<MonthLayout> | Ref<MonthLayout>;
+    /** Rows-container element used to query cell overflow. */
+    gridRef: Ref<HTMLElement | null>;
+    /** Reactive token that resets expansion when the visible
+     *  month changes (typically a `Temporal.PlainYearMonth`). */
+    resetToken: ComputedRef<unknown> | Ref<unknown>;
+}
+export interface UseMonthExpansionReturn {
+    /** Constants exposed for the parent's bar geometry math. */
+    readonly BAR_HEIGHT: number;
+    readonly BAR_GAP: number;
+    readonly DAY_NUMBER_HEIGHT: number;
+    /** Top-of-bar offset within a row for a given lane. */
+    barTopPx(lane: number): number;
+    /** Per-row total bar-area pixel height (used by the pills
+     *  container's `margin-top`). */
+    rowBarHeightsPx: ComputedRef<number[]>;
+    /** Per-row total height (collapsed vs expanded). */
+    rowHeightPx: ComputedRef<number[]>;
+    /** Set of currently expanded row indices. Single-row mode —
+     *  opening one collapses any other. */
+    expandedRows: Ref<Set<number>>;
+    /** Imperative expand / collapse helpers. */
+    expandRow(rowIdx: number): void;
+    collapseRow(rowIdx: number): void;
+    /** dateKey-keyed set of cells whose pill list outgrows their
+     *  slot (pills container scrolls). */
+    overflowingCells: Ref<Set<string>>;
+}
+export declare function useMonthExpansion(opts: UseMonthExpansionOptions): UseMonthExpansionReturn;
+//# sourceMappingURL=useMonthExpansion.d.ts.map

package/dist/composables/useMonthExpansion.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useMonthExpansion.d.ts","sourceRoot":"","sources":["../../src/composables/useMonthExpansion.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,OAAO,EACL,KAAK,WAAW,EAChB,KAAK,GAAG,EAOT,MAAM,KAAK,CAAC;AACb,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAa3C,MAAM,WAAW,wBAAwB;IACvC,yDAAyD;IACzD,MAAM,EAAE,WAAW,CAAC,WAAW,CAAC,GAAG,GAAG,CAAC,WAAW,CAAC,CAAC;IACpD,0DAA0D;IAC1D,OAAO,EAAE,GAAG,CAAC,WAAW,GAAG,IAAI,CAAC,CAAC;IACjC;iEAC6D;IAC7D,UAAU,EAAE,WAAW,CAAC,OAAO,CAAC,GAAG,GAAG,CAAC,OAAO,CAAC,CAAC;CACjD;AAED,MAAM,WAAW,uBAAuB;IACtC,4DAA4D;IAC5D,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IAEnC,uDAAuD;IACvD,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;IAE/B;qCACiC;IACjC,eAAe,EAAE,WAAW,CAAC,MAAM,EAAE,CAAC,CAAC;IAEvC,oDAAoD;IACpD,WAAW,EAAE,WAAW,CAAC,MAAM,EAAE,CAAC,CAAC;IAEnC;2CACuC;IACvC,YAAY,EAAE,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC;IAE/B,4CAA4C;IAC5C,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAElC;0CACsC;IACtC,gBAAgB,EAAE,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC;CACpC;AAED,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,wBAAwB,GAC7B,uBAAuB,CA6GzB"}

package/dist/composables/useTimeGridDnd.d.ts

@@ -0,0 +1,104 @@
+import { ComputedRef, MaybeRefOrGetter, Ref } from 'vue';
+import { CalendarDragMode, UseCalendarDndReturn } from './useCalendarDnd';
+import { DstPolicy, EventDropPayload, MoveResult } from '../core/dnd/move-math';
+import { Temporal, CalendarEvent } from '../core';
+/**
+ * Time-grid drop payload — structurally identical to the canonical
+ * `EventDropPayload` from `core/dnd/move-math`. Re-exported under this
+ * name as a convenience for time-grid-specific call sites.
+ */
+export type TimeGridEventDropPayload = EventDropPayload;
+export interface TimedDragSourceSnapshot {
+    dayKey: string;
+    lane: number;
+    laneCount: number;
+    startMinutes: number;
+    endMinutes: number;
+    event: CalendarEvent;
+}
+export interface AllDayDragSourceSnapshot {
+    startCol: number;
+    endCol: number;
+    lane: number;
+    laneCount: number;
+    clippedStart: boolean;
+    clippedEnd: boolean;
+    event: CalendarEvent;
+}
+export interface InvalidTimedGhost {
+    dayKey: string;
+    startMinutes: number;
+    durationMinutes: number;
+}
+export interface InvalidAllDayGhost {
+    startCol: number;
+    endCol: number;
+}
+export interface UseTimeGridDndOptions {
+    events: MaybeRefOrGetter<ReadonlyArray<CalendarEvent>>;
+    days: ComputedRef<ReadonlyArray<Temporal.PlainDate>> | Ref<ReadonlyArray<Temporal.PlainDate>>;
+    timeRange: ComputedRef<readonly [number, number]> | Ref<readonly [number, number]>;
+    pixelsPerHour: ComputedRef<number> | Ref<number>;
+    slotDuration: ComputedRef<5 | 10 | 15 | 30 | 60> | Ref<5 | 10 | 15 | 30 | 60>;
+    timezone: MaybeRefOrGetter<string>;
+    /** DST disambiguation policy (Article 5). Default `'compatible'`. */
+    dstPolicy?: MaybeRefOrGetter<DstPolicy>;
+    surfaceRef: Ref<HTMLElement | null>;
+    columnsRef: Ref<HTMLElement | null>;
+    allDayColumnsRef: Ref<HTMLElement | null>;
+    /** Pixels of leading render buffer in the time-grid body. */
+    topBufferMinutes: ComputedRef<number> | Ref<number>;
+    canDrop?: (event: CalendarEvent, target: {
+        date: string;
+        minutes: number | null;
+    }) => boolean;
+    onEventClick?: (event: CalendarEvent, native: PointerEvent | null) => void;
+    onEventDrop?: (payload: TimeGridEventDropPayload) => void;
+    /**
+     * Optional screen-reader announcer hook. Called after every
+     * commit (mouse drop OR keyboard Enter) and after every cancel
+     * (keyboard Escape). The view typically wires this to
+     * `useA11yAnnouncer().announce` so a `role="status"` element
+     * relays the change to assistive tech.
+     */
+    onAnnounce?: (kind: 'committed' | 'cancelled', payload?: TimeGridEventDropPayload) => void;
+}
+/**
+ * Snapshot of the in-flight keyboard-drag state. Drives the same
+ * preview-ghost / source-phantom rendering pipeline as a pointer
+ * drag (the visuals don't care which input modality started the
+ * drag).
+ */
+export interface KeyboardDragState {
+    event: CalendarEvent;
+    /** Working start/end after applying the arrow-key moves so far. */
+    next: MoveResult;
+    mode: CalendarDragMode;
+    /** Display zone snapshotted on the FIRST arrow keystroke. The
+     *  user could toggle `.timezone()` mid-drag — we anchor to the
+     *  zone the drag began in (mirroring mouse `dragStartDisplayZone`). */
+    startDisplayZone: string;
+    /** Event start snapshotted on the FIRST arrow keystroke. If the
+     *  consumer mutates the underlying event between arrows (over-eager
+     *  listener applies a preview), `original` on commit must still
+     *  reflect the pre-drag value, not the mutated one. */
+    originalStart: Temporal.ZonedDateTime | Temporal.PlainDate;
+    /** Event end snapshotted on the FIRST arrow keystroke (if any). */
+    originalEnd?: Temporal.ZonedDateTime | Temporal.PlainDate;
+}
+export interface UseTimeGridDndReturn {
+    dnd: UseCalendarDndReturn;
+    workingEvents: ComputedRef<ReadonlyArray<CalendarEvent>>;
+    dragSourceSnapshot: Ref<TimedDragSourceSnapshot | null>;
+    dragAllDaySourceSnapshot: Ref<AllDayDragSourceSnapshot | null>;
+    invalidTimedGhost: ComputedRef<InvalidTimedGhost | null>;
+    invalidAllDayGhost: ComputedRef<InvalidAllDayGhost | null>;
+    isPreviewEvent: (id: string) => boolean;
+    onEventPointerdown: (e: PointerEvent, event: CalendarEvent, start: (data: CalendarEvent) => (e: PointerEvent) => void) => void;
+    onEventKeydown: (e: KeyboardEvent, event: CalendarEvent) => void;
+    draggedDurationMinutes: ComputedRef<number | null>;
+    /** Active keyboard-drag state, or `null` when no kbd-drag is in flight. */
+    keyboardDrag: Ref<KeyboardDragState | null>;
+}
+export declare function useTimeGridDnd(opts: UseTimeGridDndOptions): UseTimeGridDndReturn;
+//# sourceMappingURL=useTimeGridDnd.d.ts.map

package/dist/composables/useTimeGridDnd.d.ts.map

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

package/dist/composables/useViewWindow.d.ts

@@ -0,0 +1,14 @@
+import { Ref } from 'vue';
+import { ViewWindow } from '../core';
+import { CalendarBuilder } from '../builders/calendar-builder';
+interface UseViewWindowReturn {
+    /**
+     * Computed reflection of the current window. Same value the
+     * builder's `api.visibleRange` exposes; provided here so the
+     * caller doesn't have to wire two refs.
+     */
+    readonly visibleRange: Readonly<Ref<ViewWindow | null>>;
+}
+export declare function useViewWindow<TMeta extends Record<string, unknown> = Record<string, unknown>>(builder: CalendarBuilder<TMeta>): UseViewWindowReturn;
+export {};
+//# sourceMappingURL=useViewWindow.d.ts.map

package/dist/composables/useViewWindow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useViewWindow.d.ts","sourceRoot":"","sources":["../../src/composables/useViewWindow.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AAEH,OAAO,EACL,KAAK,GAAG,EAKT,MAAM,KAAK,CAAC;AACb,OAAO,EACL,KAAK,UAAU,EAGhB,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAU/D,UAAU,mBAAmB;IAC3B;;;;OAIG;IACH,QAAQ,CAAC,YAAY,EAAE,QAAQ,CAAC,GAAG,CAAC,UAAU,GAAG,IAAI,CAAC,CAAC,CAAC;CACzD;AAED,wBAAgB,aAAa,CAAC,KAAK,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC3F,OAAO,EAAE,eAAe,CAAC,KAAK,CAAC,GAC9B,mBAAmB,CAoDrB"}

package/dist/core/agendaLayout.d.ts

@@ -0,0 +1,47 @@
+import { CalendarEvent } from './types';
+/** A row in the agenda's flat list. */
+export type AgendaItem<TMeta extends Record<string, unknown> = Record<string, unknown>> = AgendaHeaderItem | AgendaEventItem<TMeta>;
+export interface AgendaHeaderItem {
+    kind: 'header';
+    /** The day this header introduces. ISO date string. */
+    date: string;
+    /** True if there are no events on this day (`showEmptyDays` mode). */
+    isEmpty: boolean;
+    /** Stable key for v-for. */
+    key: string;
+}
+export interface AgendaEventItem<TMeta extends Record<string, unknown> = Record<string, unknown>> {
+    kind: 'event';
+    /** The day this row belongs to. ISO date string. */
+    date: string;
+    event: CalendarEvent<TMeta>;
+    /**
+     * True when this row is a multi-day event's continuation (i.e. the
+     * event's first day was earlier in the range). Consumers that want
+     * to elide continuations can filter on this.
+     */
+    isContinuation: boolean;
+    /** Stable key for v-for, unique within the rendered range. */
+    key: string;
+}
+export interface AgendaLayoutOptions {
+    /** Range start, inclusive. ISO date string `'YYYY-MM-DD'`. */
+    rangeStart: string;
+    /** Range end, exclusive. ISO date string. */
+    rangeEnd: string;
+    /** IANA timezone for resolving timed events. */
+    timezone: string;
+    /**
+     * Render a header even on days without any events. Default false —
+     * empty days are omitted from the agenda.
+     */
+    showEmptyDays?: boolean;
+}
+/**
+ * Flatten a list of events into an `AgendaItem[]` for rendering.
+ *
+ * Pure: same input → same output, byte-for-byte. Independent of
+ * input order (events are deterministically sorted internally).
+ */
+export declare function buildAgendaItems<TMeta extends Record<string, unknown> = Record<string, unknown>>(events: ReadonlyArray<CalendarEvent<TMeta>>, opts: AgendaLayoutOptions): AgendaItem<TMeta>[];
+//# sourceMappingURL=agendaLayout.d.ts.map

package/dist/core/agendaLayout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agendaLayout.d.ts","sourceRoot":"","sources":["../../src/core/agendaLayout.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAM7C,uCAAuC;AACvC,MAAM,MAAM,UAAU,CAAC,KAAK,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,IAClF,gBAAgB,GAChB,eAAe,CAAC,KAAK,CAAC,CAAC;AAE3B,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,QAAQ,CAAC;IACf,uDAAuD;IACvD,IAAI,EAAE,MAAM,CAAC;IACb,sEAAsE;IACtE,OAAO,EAAE,OAAO,CAAC;IACjB,4BAA4B;IAC5B,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,eAAe,CAAC,KAAK,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAC9F,IAAI,EAAE,OAAO,CAAC;IACd,oDAAoD;IACpD,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,aAAa,CAAC,KAAK,CAAC,CAAC;IAC5B;;;;OAIG;IACH,cAAc,EAAE,OAAO,CAAC;IACxB,8DAA8D;IAC9D,GAAG,EAAE,MAAM,CAAC;CACb;AAID,MAAM,WAAW,mBAAmB;IAClC,8DAA8D;IAC9D,UAAU,EAAE,MAAM,CAAC;IACnB,6CAA6C;IAC7C,QAAQ,EAAE,MAAM,CAAC;IACjB,gDAAgD;IAChD,QAAQ,EAAE,MAAM,CAAC;IACjB;;;OAGG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAID;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9F,MAAM,EAAE,aAAa,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC,EAC3C,IAAI,EAAE,mBAAmB,GACxB,UAAU,CAAC,KAAK,CAAC,EAAE,CA6HrB"}