@iamsaroj/smart-ui 0.2.0

package/CHANGELOG.md

@@ -0,0 +1,35 @@
+# [0.2.0](https://github.com/imsaroj/automatic-octo-fiesta/compare/v0.1.0...v0.2.0) (2026-07-09)
+
+
+### Bug Fixes
+
+* publish under [@iamsaroj](https://github.com/iamsaroj) scope — npm username is iamsaroj, not imsaroj ([b9961d4](https://github.com/imsaroj/automatic-octo-fiesta/commit/b9961d4309f6a93a371252470c5a069fd011c5a6))
+
+
+### Features
+
+* grid action button added ([1260b5e](https://github.com/imsaroj/automatic-octo-fiesta/commit/1260b5eeb918e520e27ced9d1de5ea7215c51350))
+* overlay with async button ([a09f238](https://github.com/imsaroj/automatic-octo-fiesta/commit/a09f238c49e7798a42e58fd68900f83d191484a1))
+* publish @imsaroj/smart-ui to npm via semantic-release ([7944881](https://github.com/imsaroj/automatic-octo-fiesta/commit/7944881796d1b0e3a09a79bbdc9589079e3ff78d))
+
+
+### Reverts
+
+* undo v0.2.0 release commit — tag deleted, npm publish never happened ([558584e](https://github.com/imsaroj/automatic-octo-fiesta/commit/558584ee030e5efe8548a0af31e222e33b484497))
+
+# @iamsaroj/smart-ui
+
+## 0.1.0
+
+### Minor Changes
+
+- First tracked release (0.1.0). Establishes the public surface of the source-only
+  component library:
+  - **Domain engines** — form engine (TanStack Form + Zod), data grid (`SmartGrid`
+    / `SmartServerGrid` on AG Grid, Spring `Page<T>` contract), search engine,
+    tree, transfer list, calendar (views + recurrence + booking), and the Lexical
+    rich-text editor (with the `sanitizeEditorHtml` / `SafeEditorHtml` contract).
+  - **Smart wrappers** — flat-props wrappers over shadcn/Base UI primitives, the
+    action-button preset system, and the `SmartPage` slot layout system.
+  - **Security & a11y baselines** — export formula-injection guard, editor HTML
+    sanitization, and axe-clean components (unit + E2E).

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Saroj (imsaroj)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,49 @@
+# @iamsaroj/smart-ui
+
+Config-driven React 19 component library: `Smart*` shadcn/ui wrappers, a declarative form engine
+(TanStack Form + Zod v4), a search/filter bar, AG Grid data grids (client + server row models),
+tree / transfer-list / calendar engines, and a Lexical rich-text editor.
+
+Source, demos, and full docs: <https://github.com/imsaroj/automatic-octo-fiesta>
+
+## Install
+
+```bash
+pnpm add @iamsaroj/smart-ui react react-dom
+```
+
+Requires **React 19** (peer dependency) and **Tailwind CSS v4** in the consuming app.
+
+## Setup
+
+Import the stylesheet once at your app entry, and tell Tailwind to scan the package for classes:
+
+```css
+/* your app's global CSS */
+@import "tailwindcss";
+@import "@iamsaroj/smart-ui/globals.css";
+@source "../node_modules/@iamsaroj/smart-ui";
+```
+
+(Adjust the `@source` path so it points at the installed package from your CSS file's location.)
+
+## Usage
+
+Import via the export subpaths — internal files are not individually importable:
+
+```tsx
+import { Button } from "@iamsaroj/smart-ui/components/button"
+import { SmartCard } from "@iamsaroj/smart-ui/smart-components/smart-card"
+import { SmartForm } from "@iamsaroj/smart-ui/form-engine"
+import { SmartGrid, SmartServerGrid } from "@iamsaroj/smart-ui/data-grid"
+import { SmartTree } from "@iamsaroj/smart-ui/tree-engine"
+import { SmartCalendar } from "@iamsaroj/smart-ui/calendar-engine"
+import { SmartTextEditor } from "@iamsaroj/smart-ui/lexical-text-editor"
+```
+
+See the [docs folder](https://github.com/imsaroj/automatic-octo-fiesta/tree/main/docs) for a guide
+per entrypoint and the `apps/web` playground for working recipes.
+
+## License
+
+MIT

package/dist/calendar-engine/agenda-view.d.ts

@@ -0,0 +1,8 @@
+import type { CalendarViewProps } from "./shared";
+/**
+ * Agenda / schedule view: a flat, scrollable list of upcoming days (30-day
+ * window from the anchor date), each with its events in chronological order.
+ * Empty days are omitted.
+ */
+export declare function AgendaView<T>(props: CalendarViewProps<T>): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=agenda-view.d.ts.map

package/dist/calendar-engine/agenda-view.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agenda-view.d.ts","sourceRoot":"","sources":["../../src/calendar-engine/agenda-view.tsx"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAA;AAIjD;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,CAAC,EAAE,KAAK,EAAE,iBAAiB,CAAC,CAAC,CAAC,2CAuGxD"}

package/dist/calendar-engine/agenda-view.js

@@ -0,0 +1,26 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import * as React from "react";
+import { format, isSameDay } from "date-fns";
+import { cn } from "@iamsaroj/smart-ui/lib/utils";
+import { eventColorClasses } from "./event-color";
+import { formatEventTime, groupEventsByDay, viewRange } from "./calendar-utils";
+/**
+ * Agenda / schedule view: a flat, scrollable list of upcoming days (30-day
+ * window from the anchor date), each with its events in chronological order.
+ * Empty days are omitted.
+ */
+export function AgendaView(props) {
+    const { date, events, weekStartsOn, now, defaultDurationMinutes, onEventClick, renderEvent, } = props;
+    const groups = React.useMemo(() => {
+        const range = viewRange(date, "agenda", weekStartsOn);
+        return groupEventsByDay(events, range);
+    }, [date, events, weekStartsOn]);
+    if (groups.length === 0) {
+        return (_jsx("div", { className: "flex min-h-0 flex-1 items-center justify-center p-10 text-sm text-muted-foreground", children: "No events in this period." }));
+    }
+    return (_jsx("div", { className: "min-h-0 flex-1 overflow-y-auto", children: _jsx("div", { className: "divide-y divide-border", children: groups.map(({ day, events: dayEvents }) => {
+                const isToday = isSameDay(day, now);
+                return (_jsxs("div", { className: "flex gap-4 px-4 py-3", children: [_jsxs("div", { className: "w-20 shrink-0 pt-1", children: [_jsx("div", { className: cn("text-xs font-medium uppercase", isToday ? "text-primary" : "text-muted-foreground"), children: format(day, "EEE") }), _jsx("div", { className: cn("text-2xl font-semibold tabular-nums", isToday && "text-primary"), children: format(day, "d") }), _jsx("div", { className: "text-xs text-muted-foreground", children: format(day, "MMM") })] }), _jsx("div", { className: "flex min-w-0 flex-1 flex-col gap-1", children: dayEvents.map((event) => renderEvent ? (_jsx(React.Fragment, { children: renderEvent(event) }, event.id)) : (_jsxs("button", { type: "button", disabled: event.disabled, onClick: (e) => onEventClick?.(event, e), className: cn("flex items-center gap-3 rounded-md border border-transparent px-2 py-1.5 text-left transition-colors hover:border-border hover:bg-accent/40", "focus-visible:ring-2 focus-visible:ring-ring focus-visible:outline-none", event.disabled && "cursor-not-allowed opacity-50"), children: [_jsx("span", { className: cn("mt-0.5 size-2.5 shrink-0 rounded-full", eventColorClasses(event.color).dot), "aria-hidden": true }), _jsx("span", { className: "w-28 shrink-0 text-xs text-muted-foreground tabular-nums", children: formatEventTime(event, defaultDurationMinutes) }), _jsxs("span", { className: "min-w-0 flex-1", children: [_jsx("span", { className: "block truncate text-sm font-medium", children: event.title }), event.location && (_jsx("span", { className: "block truncate text-xs text-muted-foreground", children: event.location }))] })] }, event.id))) })] }, day.toISOString()));
+            }) }) }));
+}
+//# sourceMappingURL=agenda-view.js.map

package/dist/calendar-engine/agenda-view.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agenda-view.js","sourceRoot":"","sources":["../../src/calendar-engine/agenda-view.tsx"],"names":[],"mappings":"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"}

package/dist/calendar-engine/booking.d.ts

@@ -0,0 +1,13 @@
+import type { AvailabilityWindow, CalendarEvent, FreeSlot } from "./types";
+/** Availability windows that apply to a given weekday. */
+export declare function windowsForDay(windows: AvailabilityWindow[], day: Date): AvailabilityWindow[];
+/**
+ * Generate the bookable slots for a single day: walk each availability window in
+ * `slotMinutes` steps, and keep a slot only if its remaining capacity (after
+ * subtracting overlapping events) is at least 1. Past slots are dropped when
+ * `now` is supplied.
+ *
+ * Pure and range-free — the calendar calls it per visible day.
+ */
+export declare function generateFreeSlots<T>(day: Date, windows: AvailabilityWindow[], events: CalendarEvent<T>[], slotMinutes: number, slotCapacity?: number, now?: Date): FreeSlot[];
+//# sourceMappingURL=booking.d.ts.map

package/dist/calendar-engine/booking.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"booking.d.ts","sourceRoot":"","sources":["../../src/calendar-engine/booking.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,kBAAkB,EAClB,aAAa,EACb,QAAQ,EAET,MAAM,SAAS,CAAA;AAGhB,0DAA0D;AAC1D,wBAAgB,aAAa,CAC3B,OAAO,EAAE,kBAAkB,EAAE,EAC7B,GAAG,EAAE,IAAI,GACR,kBAAkB,EAAE,CAGtB;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,EACjC,GAAG,EAAE,IAAI,EACT,OAAO,EAAE,kBAAkB,EAAE,EAC7B,MAAM,EAAE,aAAa,CAAC,CAAC,CAAC,EAAE,EAC1B,WAAW,EAAE,MAAM,EACnB,YAAY,SAAI,EAChB,GAAG,CAAC,EAAE,IAAI,GACT,QAAQ,EAAE,CA6BZ"}

package/dist/calendar-engine/booking.js

@@ -0,0 +1,45 @@
+import { addMinutes, startOfDay } from "date-fns";
+import { eventEnd } from "./calendar-utils";
+/** Availability windows that apply to a given weekday. */
+export function windowsForDay(windows, day) {
+    const wd = day.getDay();
+    return windows.filter((w) => w.weekday === wd);
+}
+/**
+ * Generate the bookable slots for a single day: walk each availability window in
+ * `slotMinutes` steps, and keep a slot only if its remaining capacity (after
+ * subtracting overlapping events) is at least 1. Past slots are dropped when
+ * `now` is supplied.
+ *
+ * Pure and range-free — the calendar calls it per visible day.
+ */
+export function generateFreeSlots(day, windows, events, slotMinutes, slotCapacity = 1, now) {
+    const base = startOfDay(day);
+    const dayWindows = windowsForDay(windows, day);
+    if (dayWindows.length === 0)
+        return [];
+    const slots = [];
+    for (const win of dayWindows) {
+        for (let m = win.startMinutes; m + slotMinutes <= win.endMinutes; m += slotMinutes) {
+            const start = addMinutes(base, m);
+            const end = addMinutes(start, slotMinutes);
+            if (now && start < now)
+                continue;
+            // Count events that overlap this slot (any intersection).
+            let taken = 0;
+            for (const e of events) {
+                if (e.allDay)
+                    continue;
+                const es = e.start;
+                const ee = eventEnd(e);
+                if (es < end && ee > start)
+                    taken++;
+            }
+            const capacity = slotCapacity - taken;
+            if (capacity >= 1)
+                slots.push({ start, end, capacity });
+        }
+    }
+    return slots;
+}
+//# sourceMappingURL=booking.js.map

package/dist/calendar-engine/booking.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"booking.js","sourceRoot":"","sources":["../../src/calendar-engine/booking.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,UAAU,CAAA;AAOjD,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAA;AAE3C,0DAA0D;AAC1D,MAAM,UAAU,aAAa,CAC3B,OAA6B,EAC7B,GAAS;IAET,MAAM,EAAE,GAAG,GAAG,CAAC,MAAM,EAAa,CAAA;IAClC,OAAO,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,KAAK,EAAE,CAAC,CAAA;AAChD,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,iBAAiB,CAC/B,GAAS,EACT,OAA6B,EAC7B,MAA0B,EAC1B,WAAmB,EACnB,YAAY,GAAG,CAAC,EAChB,GAAU;IAEV,MAAM,IAAI,GAAG,UAAU,CAAC,GAAG,CAAC,CAAA;IAC5B,MAAM,UAAU,GAAG,aAAa,CAAC,OAAO,EAAE,GAAG,CAAC,CAAA;IAC9C,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAA;IAEtC,MAAM,KAAK,GAAe,EAAE,CAAA;IAC5B,KAAK,MAAM,GAAG,IAAI,UAAU,EAAE,CAAC;QAC7B,KACE,IAAI,CAAC,GAAG,GAAG,CAAC,YAAY,EACxB,CAAC,GAAG,WAAW,IAAI,GAAG,CAAC,UAAU,EACjC,CAAC,IAAI,WAAW,EAChB,CAAC;YACD,MAAM,KAAK,GAAG,UAAU,CAAC,IAAI,EAAE,CAAC,CAAC,CAAA;YACjC,MAAM,GAAG,GAAG,UAAU,CAAC,KAAK,EAAE,WAAW,CAAC,CAAA;YAC1C,IAAI,GAAG,IAAI,KAAK,GAAG,GAAG;gBAAE,SAAQ;YAEhC,0DAA0D;YAC1D,IAAI,KAAK,GAAG,CAAC,CAAA;YACb,KAAK,MAAM,CAAC,IAAI,MAAM,EAAE,CAAC;gBACvB,IAAI,CAAC,CAAC,MAAM;oBAAE,SAAQ;gBACtB,MAAM,EAAE,GAAG,CAAC,CAAC,KAAK,CAAA;gBAClB,MAAM,EAAE,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAA;gBACtB,IAAI,EAAE,GAAG,GAAG,IAAI,EAAE,GAAG,KAAK;oBAAE,KAAK,EAAE,CAAA;YACrC,CAAC;YACD,MAAM,QAAQ,GAAG,YAAY,GAAG,KAAK,CAAA;YACrC,IAAI,QAAQ,IAAI,CAAC;gBAAE,KAAK,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,GAAG,EAAE,QAAQ,EAAE,CAAC,CAAA;QACzD,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAA;AACd,CAAC"}

package/dist/calendar-engine/calendar-utils.d.ts

@@ -0,0 +1,74 @@
+import type { CalendarEvent, CalendarView, Weekday } from "./types";
+/** Inclusive `[start, end]` day range covered by a view anchored at `date`. */
+export interface DateRange {
+    start: Date;
+    end: Date;
+}
+/**
+ * The 6×7 grid of days shown in the month view: the weeks spanning the month,
+ * padded to complete weeks so leading/trailing days of adjacent months fill the
+ * grid. Always 6 rows so the grid height doesn't jump between months.
+ */
+export declare function buildMonthGrid(date: Date, weekStartsOn: Weekday): Date[][];
+/** The 7 days of the week containing `date`. */
+export declare function buildWeekDays(date: Date, weekStartsOn: Weekday): Date[];
+/** The visible day range for a view (used to filter events cheaply). */
+export declare function viewRange(date: Date, view: CalendarView, weekStartsOn: Weekday): DateRange;
+/** Advance/rewind the anchor date by one page of `view`. `dir` is +1 or -1. */
+export declare function stepDate(date: Date, view: CalendarView, dir: 1 | -1): Date;
+/** Resolved end for an event, applying a default duration when `end` is absent. */
+export declare function eventEnd(event: CalendarEvent, defaultDurationMinutes?: number): Date;
+/** Whether an event covers more than one calendar day. */
+export declare function isMultiDay(event: CalendarEvent): boolean;
+/** Chronological sort: earlier start first, longer event first on ties. */
+export declare function sortEvents<T>(events: CalendarEvent<T>[]): CalendarEvent<T>[];
+/**
+ * Events that intersect a given day, in sorted order. Handles multi-day and
+ * all-day events (they appear on every day they span).
+ */
+export declare function eventsForDay<T>(events: CalendarEvent<T>[], day: Date): CalendarEvent<T>[];
+/** Split events for a day into all-day/multi-day banners vs timed blocks. */
+export declare function partitionDayEvents<T>(events: CalendarEvent<T>[]): {
+    allDay: CalendarEvent<T>[];
+    timed: CalendarEvent<T>[];
+};
+/** Minutes since midnight for a date. */
+export declare function minutesSinceMidnight(date: Date): number;
+/**
+ * A timed event positioned within a day column. `top`/`height` are percentages
+ * of the visible `[minHour, maxHour)` window; `left`/`width` are percentages of
+ * the column, computed by packing overlapping events into side-by-side lanes.
+ */
+export interface PositionedEvent<T = unknown> {
+    event: CalendarEvent<T>;
+    top: number;
+    height: number;
+    left: number;
+    width: number;
+    /** Lane index within its overlap cluster (for stable keys / z-order). */
+    lane: number;
+    lanes: number;
+}
+/**
+ * Lay out a day's timed events into non-overlapping lanes and convert their
+ * times into top/height/left/width percentages for the given hour window.
+ *
+ * Overlapping events (by clock time) are grouped into a cluster and split into
+ * as many lanes as the max concurrency of that cluster, so simultaneous events
+ * sit side by side and never visually collide.
+ */
+export declare function layoutDayEvents<T>(events: CalendarEvent<T>[], day: Date, minHour: number, maxHour: number, defaultDurationMinutes?: number): PositionedEvent<T>[];
+/** The hour labels (integers) for a `[minHour, maxHour]` window. */
+export declare function hourLabels(minHour: number, maxHour: number): number[];
+/** Title-bar label for the current view, e.g. "July 2026" or "Jul 7 – 13, 2026". */
+export declare function viewTitle(date: Date, view: CalendarView, weekStartsOn: Weekday): string;
+/** Compact time range label, e.g. "9:00 – 10:30 AM". */
+export declare function formatEventTime(event: CalendarEvent, defaultDurationMinutes?: number): string;
+/** Group events by day (YYYY-MM-DD key), sorted, for the agenda view. */
+export declare function groupEventsByDay<T>(events: CalendarEvent<T>[], range: DateRange): {
+    day: Date;
+    events: CalendarEvent<T>[];
+}[];
+/** Whether a date falls inside an inclusive range. */
+export declare function isInRange(date: Date, range: DateRange): boolean;
+//# sourceMappingURL=calendar-utils.d.ts.map

package/dist/calendar-engine/calendar-utils.d.ts.map

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

package/dist/calendar-engine/calendar-utils.js

@@ -0,0 +1,221 @@
+import { addDays, addMinutes, addMonths, addWeeks, differenceInCalendarDays, differenceInMinutes, eachDayOfInterval, endOfDay, format, isSameDay, isSameMonth, isWithinInterval, startOfDay, startOfMonth, startOfWeek, } from "date-fns";
+/**
+ * The 6×7 grid of days shown in the month view: the weeks spanning the month,
+ * padded to complete weeks so leading/trailing days of adjacent months fill the
+ * grid. Always 6 rows so the grid height doesn't jump between months.
+ */
+export function buildMonthGrid(date, weekStartsOn) {
+    const gridStart = startOfWeek(startOfMonth(date), { weekStartsOn });
+    const weeks = [];
+    let cursor = gridStart;
+    for (let w = 0; w < 6; w++) {
+        const week = [];
+        for (let d = 0; d < 7; d++) {
+            week.push(cursor);
+            cursor = addDays(cursor, 1);
+        }
+        weeks.push(week);
+    }
+    return weeks;
+}
+/** The 7 days of the week containing `date`. */
+export function buildWeekDays(date, weekStartsOn) {
+    const start = startOfWeek(date, { weekStartsOn });
+    return Array.from({ length: 7 }, (_, i) => addDays(start, i));
+}
+/** The visible day range for a view (used to filter events cheaply). */
+export function viewRange(date, view, weekStartsOn) {
+    switch (view) {
+        case "month": {
+            const grid = buildMonthGrid(date, weekStartsOn);
+            return { start: grid[0][0], end: endOfDay(grid[5][6]) };
+        }
+        case "week": {
+            const days = buildWeekDays(date, weekStartsOn);
+            return { start: startOfDay(days[0]), end: endOfDay(days[6]) };
+        }
+        case "day":
+            return { start: startOfDay(date), end: endOfDay(date) };
+        case "agenda":
+            return { start: startOfDay(date), end: endOfDay(addDays(date, 30)) };
+    }
+}
+/** Advance/rewind the anchor date by one page of `view`. `dir` is +1 or -1. */
+export function stepDate(date, view, dir) {
+    switch (view) {
+        case "month":
+            return addMonths(date, dir);
+        case "week":
+            return addWeeks(date, dir);
+        case "day":
+            return addDays(date, dir);
+        case "agenda":
+            return addDays(date, dir * 30);
+    }
+}
+// ── Event helpers ────────────────────────────────────────────────────────────
+/** Resolved end for an event, applying a default duration when `end` is absent. */
+export function eventEnd(event, defaultDurationMinutes = 60) {
+    if (event.end && event.end > event.start)
+        return event.end;
+    return addMinutes(event.start, defaultDurationMinutes);
+}
+/** Whether an event covers more than one calendar day. */
+export function isMultiDay(event) {
+    if (event.allDay)
+        return differenceInCalendarDays(eventEnd(event, 0), event.start) >= 1;
+    return !isSameDay(event.start, eventEnd(event));
+}
+/** Chronological sort: earlier start first, longer event first on ties. */
+export function sortEvents(events) {
+    return [...events].sort((a, b) => {
+        const s = a.start.getTime() - b.start.getTime();
+        if (s !== 0)
+            return s;
+        return eventEnd(b).getTime() - eventEnd(a).getTime();
+    });
+}
+/**
+ * Events that intersect a given day, in sorted order. Handles multi-day and
+ * all-day events (they appear on every day they span).
+ */
+export function eventsForDay(events, day) {
+    const dayStart = startOfDay(day);
+    const dayEnd = endOfDay(day);
+    return sortEvents(events.filter((e) => {
+        const start = e.start;
+        const end = eventEnd(e);
+        // Overlap test: event starts before day ends AND ends after day starts.
+        return start <= dayEnd && end >= dayStart;
+    }));
+}
+/** Split events for a day into all-day/multi-day banners vs timed blocks. */
+export function partitionDayEvents(events) {
+    const allDay = [];
+    const timed = [];
+    for (const e of events) {
+        if (e.allDay || isMultiDay(e))
+            allDay.push(e);
+        else
+            timed.push(e);
+    }
+    return { allDay, timed };
+}
+// ── Time-grid geometry ───────────────────────────────────────────────────────
+/** Minutes since midnight for a date. */
+export function minutesSinceMidnight(date) {
+    return date.getHours() * 60 + date.getMinutes();
+}
+/**
+ * Lay out a day's timed events into non-overlapping lanes and convert their
+ * times into top/height/left/width percentages for the given hour window.
+ *
+ * Overlapping events (by clock time) are grouped into a cluster and split into
+ * as many lanes as the max concurrency of that cluster, so simultaneous events
+ * sit side by side and never visually collide.
+ */
+export function layoutDayEvents(events, day, minHour, maxHour, defaultDurationMinutes = 60) {
+    const dayStart = startOfDay(day);
+    const windowStart = minHour * 60;
+    const windowEnd = maxHour * 60;
+    const windowSpan = Math.max(1, windowEnd - windowStart);
+    const spans = sortEvents(events).map((event) => {
+        const rawStart = differenceInMinutes(event.start, dayStart);
+        const rawEnd = differenceInMinutes(eventEnd(event, defaultDurationMinutes), dayStart);
+        const startMin = Math.max(windowStart, Math.min(rawStart, windowEnd));
+        // Keep a minimum visible height of 15 minutes.
+        const endMin = Math.max(startMin + 15, Math.min(rawEnd, windowEnd));
+        return { event, startMin, endMin };
+    });
+    // Group into clusters of transitively-overlapping spans.
+    const positioned = [];
+    let cluster = [];
+    let clusterEnd = -Infinity;
+    const flush = () => {
+        if (cluster.length === 0)
+            return;
+        // Greedy lane assignment within the cluster.
+        const laneEnds = [];
+        const laneOf = new Map();
+        for (const span of cluster) {
+            let lane = laneEnds.findIndex((end) => end <= span.startMin);
+            if (lane === -1) {
+                lane = laneEnds.length;
+                laneEnds.push(span.endMin);
+            }
+            else {
+                laneEnds[lane] = span.endMin;
+            }
+            laneOf.set(span, lane);
+        }
+        const lanes = laneEnds.length;
+        for (const span of cluster) {
+            const lane = laneOf.get(span);
+            positioned.push({
+                event: span.event,
+                top: ((span.startMin - windowStart) / windowSpan) * 100,
+                height: ((span.endMin - span.startMin) / windowSpan) * 100,
+                left: (lane / lanes) * 100,
+                width: (1 / lanes) * 100,
+                lane,
+                lanes,
+            });
+        }
+        cluster = [];
+        clusterEnd = -Infinity;
+    };
+    for (const span of spans) {
+        if (cluster.length > 0 && span.startMin >= clusterEnd)
+            flush();
+        cluster.push(span);
+        clusterEnd = Math.max(clusterEnd, span.endMin);
+    }
+    flush();
+    return positioned;
+}
+/** The hour labels (integers) for a `[minHour, maxHour]` window. */
+export function hourLabels(minHour, maxHour) {
+    const out = [];
+    for (let h = minHour; h <= maxHour; h++)
+        out.push(h);
+    return out;
+}
+// ── Formatting ───────────────────────────────────────────────────────────────
+/** Title-bar label for the current view, e.g. "July 2026" or "Jul 7 – 13, 2026". */
+export function viewTitle(date, view, weekStartsOn) {
+    switch (view) {
+        case "month":
+            return format(date, "MMMM yyyy");
+        case "day":
+            return format(date, "EEEE, MMMM d, yyyy");
+        case "agenda":
+            return `${format(date, "MMM d")} – ${format(addDays(date, 30), "MMM d, yyyy")}`;
+        case "week": {
+            const days = buildWeekDays(date, weekStartsOn);
+            const a = days[0];
+            const b = days[6];
+            if (isSameMonth(a, b))
+                return `${format(a, "MMM d")} – ${format(b, "d, yyyy")}`;
+            return `${format(a, "MMM d")} – ${format(b, "MMM d, yyyy")}`;
+        }
+    }
+}
+/** Compact time range label, e.g. "9:00 – 10:30 AM". */
+export function formatEventTime(event, defaultDurationMinutes = 60) {
+    if (event.allDay)
+        return "All day";
+    const end = eventEnd(event, defaultDurationMinutes);
+    return `${format(event.start, "h:mm a")} – ${format(end, "h:mm a")}`;
+}
+/** Group events by day (YYYY-MM-DD key), sorted, for the agenda view. */
+export function groupEventsByDay(events, range) {
+    const days = eachDayOfInterval({ start: range.start, end: range.end });
+    return days
+        .map((day) => ({ day, events: eventsForDay(events, day) }))
+        .filter((g) => g.events.length > 0);
+}
+/** Whether a date falls inside an inclusive range. */
+export function isInRange(date, range) {
+    return isWithinInterval(date, { start: range.start, end: range.end });
+}
+//# sourceMappingURL=calendar-utils.js.map

package/dist/calendar-engine/calendar-utils.js.map

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

package/dist/calendar-engine/calendar.d.ts

@@ -0,0 +1,62 @@
+import * as React from "react";
+import type { AvailabilityWindow, CalendarEvent, CalendarSize, CalendarSlot, CalendarView, EventChangeMeta, FreeSlot, SmartCalendarHandle, TimeRange, Weekday } from "./types";
+export interface SmartCalendarProps<T = unknown> {
+    /** The events / bookings to render. */
+    events?: CalendarEvent<T>[];
+    /** Controlled anchor date. */
+    date?: Date;
+    /** Uncontrolled initial anchor date. @default today */
+    defaultDate?: Date;
+    onDateChange?: (date: Date) => void;
+    /** Controlled active view. */
+    view?: CalendarView;
+    /** Uncontrolled initial view. @default "month" */
+    defaultView?: CalendarView;
+    onViewChange?: (view: CalendarView) => void;
+    /** Which views to offer in the toolbar switcher. @default all four */
+    views?: CalendarView[];
+    size?: CalendarSize;
+    /** 0 = Sunday … 1 = Monday. @default 0 */
+    weekStartsOn?: Weekday;
+    /** First visible hour in time-grid views (0–23). @default 0 */
+    minHour?: number;
+    /** Last visible hour in time-grid views (1–24). @default 24 */
+    maxHour?: number;
+    /** Slot granularity + click-to-create duration, in minutes. @default 30 */
+    slotMinutes?: number;
+    /** Fallback duration for events without an `end`. @default 60 */
+    defaultDurationMinutes?: number;
+    /** Shade a business-hours window in time-grid views. */
+    businessHours?: TimeRange;
+    /** Max event pills per month cell before "+N more". @default 3 */
+    maxEventsPerDay?: number;
+    /** Enable drag-to-move + edge-resize (per event, gated by `event.editable`). */
+    editable?: boolean;
+    /** Fires after a completed move or resize gesture. */
+    onEventChange?: (meta: EventChangeMeta<T>) => void;
+    /** Weekly bookable windows; renders free-slot chips in time-grid views. */
+    availability?: AvailabilityWindow[];
+    /** Concurrent bookings allowed per slot. @default 1 */
+    slotCapacity?: number;
+    /** Fires when a bookable free slot is chosen. */
+    onSlotBook?: (slot: FreeSlot) => void;
+    onEventClick?: (event: CalendarEvent<T>, e: React.MouseEvent) => void;
+    onSlotSelect?: (slot: CalendarSlot) => void;
+    /** Override event rendering across every view. */
+    renderEvent?: (event: CalendarEvent<T>) => React.ReactNode;
+    /** Hide the built-in toolbar (title, nav, view switcher). */
+    hideToolbar?: boolean;
+    /** Extra toolbar content, rendered on the right of the view switcher. */
+    toolbarExtra?: React.ReactNode;
+    className?: string;
+    ref?: React.Ref<SmartCalendarHandle>;
+}
+/**
+ * `SmartCalendar` — a declarative calendar & booking surface with month, week,
+ * day, and agenda views. Date, view, and events are each independently
+ * controllable or uncontrolled; navigation, view switching, slot selection, and
+ * event activation are exposed through callbacks and an imperative
+ * `SmartCalendarHandle`.
+ */
+export declare function SmartCalendar<T = unknown>({ events, date, defaultDate, onDateChange, view, defaultView, onViewChange, views, size, weekStartsOn, minHour, maxHour, slotMinutes, defaultDurationMinutes, businessHours, maxEventsPerDay, editable, onEventChange, availability, slotCapacity, onSlotBook, onEventClick, onSlotSelect, renderEvent, hideToolbar, toolbarExtra, className, ref, }: SmartCalendarProps<T>): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=calendar.d.ts.map

package/dist/calendar-engine/calendar.d.ts.map

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