@leonardaustin/ui 0.4.0 → 0.5.1

package/dist/components/ui/Calendar.d.ts

@@ -0,0 +1,174 @@
+/**
+ * Calendar — a Google-Calendar-style scheduler for bookings and availability.
+ *
+ * Views: day, 3-day, work week, week (default), month, agenda and a resource
+ * timeline. Pass `resources` to split time-grid columns per clinician/room.
+ * Availability blocks render as a background layer (time outside them is
+ * striped as busy); switch `editLayer` to "availability" to drag those instead of
+ * events.
+ *
+ * Fully controlled: the calendar never changes your data. Drag-to-create,
+ * move and resize (pointer or keyboard) call `onCreate`, `onEventChange` and
+ * `onAvailabilityChange`; apply the change to your state (or reject it in
+ * `validate`, which also drives the live drag preview).
+ *
+ * Times are local `Date`s on a wall-clock grid. See lib/calendar.ts for the
+ * timezone and DST notes.
+ *
+ * @example
+ * ```tsx
+ * <Calendar
+ *   events={bookings}
+ *   availability={expandAvailabilityRules(rules, range)}
+ *   resources={clinicians}
+ *   slotDuration={15}
+ *   onCreate={(sel) => openNewBooking(sel)}
+ *   onEventChange={(change) => moveBooking(change)}
+ *   onRangeChange={setRange}
+ * />
+ * ```
+ */
+import { type ReactNode } from "react";
+import { type CalendarAvailability, type CalendarEvent, type CalendarResource, type CalendarView, type Weekday } from "../../lib/calendar";
+import { type CalendarAvailabilityChange, type CalendarDisplay, type CalendarDraft, type CalendarEventChange, type CalendarLabelOverrides, type CalendarRange, type CalendarRenderEvent, type CalendarSelection } from "./calendar/types";
+export interface CalendarProps<T = unknown, A = unknown> {
+    /** Bookings/events to show. Filter them to the visible range for speed. */
+    events?: readonly CalendarEvent<T>[];
+    /**
+     * Availability and absence blocks, drawn behind events. Use
+     * `expandAvailabilityRules` to turn weekly rules into blocks. When provided,
+     * time no block covers is striped as busy (see `shadeOutsideAvailability`).
+     */
+    availability?: readonly CalendarAvailability<A>[];
+    /**
+     * Resources (clinicians, rooms…). Time-grid views get one column per
+     * resource per day; the timeline gets one row each. Events need a matching
+     * `resourceId` to appear in resource views — add an "Unassigned" resource
+     * for events without one.
+     */
+    resources?: readonly CalendarResource[];
+    /** Controlled view. */
+    view?: CalendarView;
+    /** Initial view when uncontrolled. Defaults to `week`. */
+    defaultView?: CalendarView;
+    onViewChange?: (view: CalendarView) => void;
+    /** Views offered by the toolbar switcher. */
+    views?: readonly CalendarView[];
+    /** Controlled anchor date (any time on the day to show). */
+    date?: Date;
+    /** Initial anchor date when uncontrolled. Defaults to today. */
+    defaultDate?: Date;
+    onDateChange?: (date: Date) => void;
+    /** Fires with the visible [start, end) range whenever it changes — fetch here. */
+    onRangeChange?: (range: CalendarRange) => void;
+    /** First day of the week. Defaults to 1 (Monday). */
+    weekStartsOn?: Weekday;
+    /** Days in the `workWeek` view. Defaults to Monday–Friday. */
+    workWeekDays?: readonly Weekday[];
+    /** Days in the `agenda` view. Defaults to 7. */
+    agendaDays?: number;
+    /** First visible time, "HH:mm". Defaults to "07:00". */
+    slotMinTime?: string;
+    /** Last visible time, "HH:mm" ("24:00" allowed). Defaults to "20:00". */
+    slotMaxTime?: string;
+    /** Snap step and keyboard step in minutes (5, 10, 15, 30…). Defaults to 15. */
+    slotDuration?: number;
+    /** Minutes between time labels. Defaults to 60. */
+    slotLabelInterval?: number;
+    /** Pixel height of one hour in time-grid views. Defaults to 48. */
+    hourHeight?: number;
+    /** Pixel width of one hour in the timeline. Defaults to 96. */
+    timelineHourWidth?: number;
+    /** Minimum width of a resource column. Defaults to 120. */
+    resourceMinWidth?: number;
+    /**
+     * Time to scroll to on mount, "HH:mm". Defaults to the earliest visible
+     * availability, else 08:00.
+     */
+    scrollToTime?: string;
+    /**
+     * Where the scroll time lands: at the top (left in the timeline) of the
+     * visible hours, or in the middle. Defaults to "start".
+     */
+    scrollAlign?: "start" | "center";
+    /** Current time for the now-line and "Today". Defaults to the live clock. */
+    now?: Date;
+    /** Show the current-time line. Defaults to true. */
+    nowIndicator?: boolean;
+    /**
+     * Which layer the pointer edits. `events` (default): availability is a
+     * passive background. `availability`: blocks become draggable cards and
+     * events are dimmed.
+     */
+    editLayer?: "events" | "availability";
+    /** Disable every create, move and resize. */
+    readOnly?: boolean;
+    /** Allow creating by drag/click on empty time. Defaults to `!!onCreate`. */
+    selectable?: boolean;
+    /** Length in minutes of a click (not drag) or keyboard create. Defaults to 30. */
+    clickCreateDuration?: number;
+    /**
+     * Stripe time no block covers as busy, like an absence. Defaults to true.
+     */
+    shadeOutsideAvailability?: boolean;
+    /** Empty time was selected (drag, click, Enter, or a month-day click). */
+    onCreate?: (selection: CalendarSelection) => void;
+    onEventClick?: (event: CalendarEvent<T>) => void;
+    /** An event was moved or resized. Enables event dragging. */
+    onEventChange?: (change: CalendarEventChange<T>) => void;
+    onAvailabilityClick?: (availability: CalendarAvailability<A>) => void;
+    /**
+     * A block was moved or resized (in `editLayer="availability"`). For a
+     * recurring occurrence (`seriesId` set) ask whether it applies to this
+     * occurrence or the series.
+     */
+    onAvailabilityChange?: (change: CalendarAvailabilityChange<A>) => void;
+    /**
+     * Return a reason to reject a proposed create/move/resize. Called while
+     * dragging (the preview shows the reason) and before each callback.
+     */
+    validate?: (draft: CalendarDraft<T, A>) => string | null | undefined | void;
+    /**
+     * A change was dropped but `validate` rejected it. Keyboard, click and
+     * month-chip changes have no live drag preview, so this is their only
+     * feedback: wire it up (e.g. to a toast) whenever you pass `validate`.
+     */
+    onInvalidChange?: (draft: CalendarDraft<T, A>, reason: string) => void;
+    /** A day header or month day number was clicked. Defaults to opening the day view. */
+    onDateClick?: (date: Date) => void;
+    /** Replace the contents of an event box. */
+    renderEvent?: CalendarRenderEvent<T>;
+    /** Rows per month cell before "+N more". Defaults to as many as fit. */
+    monthMaxEvents?: number;
+    /** List availability in the agenda view. Defaults to true. */
+    agendaShowAvailability?: boolean;
+    /**
+     * Text shown on boxes, chips and blocks outside the agenda, e.g.
+     * `{ time: false, status: false }`. Hidden text is removed, not replaced.
+     */
+    display?: CalendarDisplay;
+    /**
+     * View used instead of multi-day time grids when the calendar is narrower
+     * than `narrowWidth`. Defaults to `day`; false keeps the chosen view.
+     */
+    narrowView?: CalendarView | false;
+    /** Width in px below which `narrowView` applies. Defaults to 640. */
+    narrowWidth?: number;
+    /** Locale for dates and times. Defaults to "en-GB". */
+    locale?: string;
+    /** 12-hour clock. Defaults to false. */
+    hour12?: boolean;
+    /** Override any user-facing string. */
+    labels?: CalendarLabelOverrides;
+    /** Show the built-in toolbar. Defaults to true. */
+    toolbar?: boolean;
+    /** Extra toolbar content (filters, "New" button), before the view switcher. */
+    toolbarActions?: ReactNode;
+    /** Dim the calendar and show a spinner. */
+    loading?: boolean;
+    className?: string;
+    /** Accessible name for the calendar region. */
+    "aria-label"?: string;
+}
+export declare function Calendar<T = unknown, A = unknown>({ events, availability, resources, view: viewProp, defaultView, onViewChange, views, date: dateProp, defaultDate, onDateChange, onRangeChange, weekStartsOn, workWeekDays, agendaDays, slotMinTime, slotMaxTime, slotDuration, slotLabelInterval, hourHeight, timelineHourWidth, resourceMinWidth, scrollToTime, scrollAlign, now: nowProp, nowIndicator, editLayer, readOnly, selectable, clickCreateDuration, shadeOutsideAvailability, onCreate, onEventClick, onEventChange, onAvailabilityClick, onAvailabilityChange, validate, onInvalidChange, onDateClick, renderEvent, monthMaxEvents, agendaShowAvailability, display, narrowView, narrowWidth, locale, hour12, labels: labelOverrides, toolbar, toolbarActions, loading, className, "aria-label": ariaLabel, }: CalendarProps<T, A>): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=Calendar.d.ts.map

package/dist/components/ui/Calendar.d.ts.map

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

package/dist/components/ui/CodeInput.d.ts

@@ -0,0 +1,33 @@
+export interface CodeInputProps {
+    /**
+     * The digits entered so far (controlled). Boxes the user has cleared are
+     * left out, so `value.length === length` only when every box is filled.
+     */
+    value: string;
+    onChange: (value: string) => void;
+    /**
+     * Called with the code whenever an edit leaves every box filled — use it
+     * to auto-submit. Fires again if the user then changes a digit.
+     */
+    onComplete?: (value: string) => void;
+    /** Number of digit boxes. Only digits are accepted. */
+    length?: number;
+    /** Error message shown below the boxes; also marks them invalid. */
+    error?: string;
+    /** Marks the boxes invalid without a message (e.g. when it's shown elsewhere). */
+    invalid?: boolean;
+    disabled?: boolean;
+    autoFocus?: boolean;
+    /** Submits the joined code under this name in a native form post. */
+    name?: string;
+    /** Accessible name for the group of boxes. */
+    "aria-label"?: string;
+    className?: string;
+}
+/**
+ * A row of single-digit boxes for one-time codes (MFA, email verification).
+ * Handles typing, paste, SMS autofill, Backspace/Delete and arrow keys; each
+ * box keeps its position, so clearing one never shifts the others.
+ */
+export declare function CodeInput({ value, onChange, onComplete, length, error, invalid, disabled, autoFocus, name, "aria-label": ariaLabel, className, }: CodeInputProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=CodeInput.d.ts.map

package/dist/components/ui/CodeInput.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CodeInput.d.ts","sourceRoot":"","sources":["../../../src/components/ui/CodeInput.tsx"],"names":[],"mappings":"AAWA,MAAM,WAAW,cAAc;IAC7B;;;OAGG;IACH,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAClC;;;OAGG;IACH,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACrC,uDAAuD;IACvD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,oEAAoE;IACpE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,kFAAkF;IAClF,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,qEAAqE;IACrE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,8CAA8C;IAC9C,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,EACxB,KAAK,EACL,QAAQ,EACR,UAAU,EACV,MAAU,EACV,KAAK,EACL,OAAO,EACP,QAAQ,EACR,SAAS,EACT,IAAI,EACJ,YAAY,EAAE,SAA+B,EAC7C,SAAS,GACV,EAAE,cAAc,2CAkGhB"}

package/dist/components/ui/PasswordRequirements.d.ts

@@ -0,0 +1,13 @@
+import { type PasswordRequirement } from "../../lib/passwordRequirements";
+export interface PasswordRequirementsProps {
+    /** The password to check against each rule. */
+    password: string;
+    /** Rules to list, each with a unique label. Defaults to `defaultPasswordRequirements`. */
+    requirements?: readonly PasswordRequirement[];
+    /** Keep the list visible while the password is empty. */
+    showWhenEmpty?: boolean;
+    className?: string;
+}
+/** A live checklist of password rules, ticked off as the user types. */
+export declare function PasswordRequirements({ password, requirements, showWhenEmpty, className, }: PasswordRequirementsProps): import("react/jsx-runtime").JSX.Element | null;
+//# sourceMappingURL=PasswordRequirements.d.ts.map

package/dist/components/ui/PasswordRequirements.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PasswordRequirements.d.ts","sourceRoot":"","sources":["../../../src/components/ui/PasswordRequirements.tsx"],"names":[],"mappings":"AAGA,OAAO,EAEL,KAAK,mBAAmB,EACzB,MAAM,gCAAgC,CAAC;AAExC,MAAM,WAAW,yBAAyB;IACxC,+CAA+C;IAC/C,QAAQ,EAAE,MAAM,CAAC;IACjB,0FAA0F;IAC1F,YAAY,CAAC,EAAE,SAAS,mBAAmB,EAAE,CAAC;IAC9C,yDAAyD;IACzD,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,wEAAwE;AACxE,wBAAgB,oBAAoB,CAAC,EACnC,QAAQ,EACR,YAA0C,EAC1C,aAAqB,EACrB,SAAS,GACV,EAAE,yBAAyB,kDA+B3B"}

package/dist/components/ui/QrCode.d.ts

@@ -0,0 +1,33 @@
+import { type ReactNode } from "react";
+import { type QrErrorCorrection } from "../../lib/qrCode";
+export interface QrCodeProps {
+    /**
+     * Text to encode, e.g. a URL or an `otpauth://` URI for authenticator apps.
+     * An empty string renders nothing.
+     */
+    value: string;
+    /**
+     * How much of the code can be damaged and still scan: L ≈ 7%, M ≈ 15%,
+     * Q ≈ 25%, H ≈ 30%. Higher levels produce denser codes.
+     */
+    errorCorrection?: QrErrorCorrection;
+    /** Rendered width and height in pixels. */
+    size?: number;
+    /** Light border around the code, in modules. The spec asks for 4. */
+    margin?: number;
+    /** Accessible description of what the code contains. */
+    "aria-label"?: string;
+    /**
+     * Rendered instead when `value` is too long to fit in a QR code at this
+     * error-correction level (2,953 bytes at L down to 1,273 at H).
+     */
+    fallback?: ReactNode;
+    className?: string;
+}
+/**
+ * A scannable QR code rendered as crisp SVG, with no runtime dependencies.
+ * Colours come from `--qr-foreground` / `--qr-background` so it stays
+ * dark-on-light in every theme.
+ */
+export declare function QrCode({ value, errorCorrection, size, margin, "aria-label": ariaLabel, fallback, className, }: QrCodeProps): import("react/jsx-runtime").JSX.Element | null;
+//# sourceMappingURL=QrCode.d.ts.map

package/dist/components/ui/QrCode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"QrCode.d.ts","sourceRoot":"","sources":["../../../src/components/ui/QrCode.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAW,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAGhD,OAAO,EAGL,KAAK,iBAAiB,EACvB,MAAM,kBAAkB,CAAC;AAE1B,MAAM,WAAW,WAAW;IAC1B;;;OAGG;IACH,KAAK,EAAE,MAAM,CAAC;IACd;;;OAGG;IACH,eAAe,CAAC,EAAE,iBAAiB,CAAC;IACpC,2CAA2C;IAC3C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,qEAAqE;IACrE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,wDAAwD;IACxD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;OAGG;IACH,QAAQ,CAAC,EAAE,SAAS,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;GAIG;AACH,wBAAgB,MAAM,CAAC,EACrB,KAAK,EACL,eAAqB,EACrB,IAAU,EACV,MAAU,EACV,YAAY,EAAE,SAAqB,EACnC,QAAe,EACf,SAAS,GACV,EAAE,WAAW,kDA0Cb"}

package/dist/components/ui/StepProgress.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"StepProgress.d.ts","sourceRoot":"","sources":["../../../src/components/ui/StepProgress.tsx"],"names":[],"mappings":"AAIA,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IACjD,sEAAsE;IACtE,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,wBAAgB,YAAY,CAAC,EAC3B,KAAK,EACL,WAAW,EACX,SAAS,GACV,EAAE,iBAAiB,2CA8CnB"}
+{"version":3,"file":"StepProgress.d.ts","sourceRoot":"","sources":["../../../src/components/ui/StepProgress.tsx"],"names":[],"mappings":"AAIA,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IACjD,sEAAsE;IACtE,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,wBAAgB,YAAY,CAAC,EAC3B,KAAK,EACL,WAAW,EACX,SAAS,GACV,EAAE,iBAAiB,2CAsDnB"}

package/dist/components/ui/calendar/AgendaView.d.ts

@@ -0,0 +1,11 @@
+import { type CalendarAvailability, type CalendarEvent } from "../../../lib/calendar";
+interface AgendaViewProps {
+    days: Date[];
+    events: readonly CalendarEvent[];
+    availability: readonly CalendarAvailability[];
+    label: string;
+}
+/** A printable list of days, each with its events (and availability). */
+export declare function AgendaView({ days, events, availability, label, }: AgendaViewProps): import("react/jsx-runtime").JSX.Element;
+export {};
+//# sourceMappingURL=AgendaView.d.ts.map

package/dist/components/ui/calendar/AgendaView.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AgendaView.d.ts","sourceRoot":"","sources":["../../../../src/components/ui/calendar/AgendaView.tsx"],"names":[],"mappings":"AAAA,OAAO,EASL,KAAK,oBAAoB,EACzB,KAAK,aAAa,EACnB,MAAM,uBAAuB,CAAC;AAI/B,UAAU,eAAe;IACvB,IAAI,EAAE,IAAI,EAAE,CAAC;IACb,MAAM,EAAE,SAAS,aAAa,EAAE,CAAC;IACjC,YAAY,EAAE,SAAS,oBAAoB,EAAE,CAAC;IAC9C,KAAK,EAAE,MAAM,CAAC;CACf;AAMD,yEAAyE;AACzE,wBAAgB,UAAU,CAAC,EACzB,IAAI,EACJ,MAAM,EACN,YAAY,EACZ,KAAK,GACN,EAAE,eAAe,2CAwFjB"}

package/dist/components/ui/calendar/MonthView.d.ts

@@ -0,0 +1,10 @@
+import { type CalendarAvailability, type CalendarEvent } from "../../../lib/calendar";
+interface MonthViewProps {
+    date: Date;
+    events: readonly CalendarEvent[];
+    availability: readonly CalendarAvailability[];
+    label: string;
+}
+export declare function MonthView({ date, events, availability, label, }: MonthViewProps): import("react/jsx-runtime").JSX.Element;
+export {};
+//# sourceMappingURL=MonthView.d.ts.map

package/dist/components/ui/calendar/MonthView.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MonthView.d.ts","sourceRoot":"","sources":["../../../../src/components/ui/calendar/MonthView.tsx"],"names":[],"mappings":"AAgBA,OAAO,EAgBL,KAAK,oBAAoB,EACzB,KAAK,aAAa,EACnB,MAAM,uBAAuB,CAAC;AAK/B,UAAU,cAAc;IACtB,IAAI,EAAE,IAAI,CAAC;IACX,MAAM,EAAE,SAAS,aAAa,EAAE,CAAC;IACjC,YAAY,EAAE,SAAS,oBAAoB,EAAE,CAAC;IAC9C,KAAK,EAAE,MAAM,CAAC;CACf;AAyBD,wBAAgB,SAAS,CAAC,EACxB,IAAI,EACJ,MAAM,EACN,YAAY,EACZ,KAAK,GACN,EAAE,cAAc,2CAgehB"}

package/dist/components/ui/calendar/TimeGrid.d.ts

@@ -0,0 +1,11 @@
+import { type CalendarAvailability, type CalendarEvent } from "../../../lib/calendar";
+interface TimeGridProps {
+    days: Date[];
+    events: readonly CalendarEvent[];
+    availability: readonly CalendarAvailability[];
+    /** Accessible name for the grid, e.g. the toolbar title. */
+    label: string;
+}
+export declare function TimeGrid({ days, events, availability, label }: TimeGridProps): import("react/jsx-runtime").JSX.Element;
+export {};
+//# sourceMappingURL=TimeGrid.d.ts.map

package/dist/components/ui/calendar/TimeGrid.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TimeGrid.d.ts","sourceRoot":"","sources":["../../../../src/components/ui/calendar/TimeGrid.tsx"],"names":[],"mappings":"AAUA,OAAO,EAcL,KAAK,oBAAoB,EACzB,KAAK,aAAa,EAEnB,MAAM,uBAAuB,CAAC;AAM/B,UAAU,aAAa;IACrB,IAAI,EAAE,IAAI,EAAE,CAAC;IACb,MAAM,EAAE,SAAS,aAAa,EAAE,CAAC;IACjC,YAAY,EAAE,SAAS,oBAAoB,EAAE,CAAC;IAC9C,4DAA4D;IAC5D,KAAK,EAAE,MAAM,CAAC;CACf;AAyCD,wBAAgB,QAAQ,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,YAAY,EAAE,KAAK,EAAE,EAAE,aAAa,2CAokB5E"}

package/dist/components/ui/calendar/TimelineView.d.ts

@@ -0,0 +1,11 @@
+import { type CalendarAvailability, type CalendarEvent } from "../../../lib/calendar";
+interface TimelineViewProps {
+    day: Date;
+    events: readonly CalendarEvent[];
+    availability: readonly CalendarAvailability[];
+    label: string;
+}
+/** One day, one horizontal row per resource, grouped by `resource.group`. */
+export declare function TimelineView({ day, events, availability, label, }: TimelineViewProps): import("react/jsx-runtime").JSX.Element;
+export {};
+//# sourceMappingURL=TimelineView.d.ts.map

package/dist/components/ui/calendar/TimelineView.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TimelineView.d.ts","sourceRoot":"","sources":["../../../../src/components/ui/calendar/TimelineView.tsx"],"names":[],"mappings":"AAWA,OAAO,EASL,KAAK,oBAAoB,EACzB,KAAK,aAAa,EAEnB,MAAM,uBAAuB,CAAC;AAM/B,UAAU,iBAAiB;IACzB,GAAG,EAAE,IAAI,CAAC;IACV,MAAM,EAAE,SAAS,aAAa,EAAE,CAAC;IACjC,YAAY,EAAE,SAAS,oBAAoB,EAAE,CAAC;IAC9C,KAAK,EAAE,MAAM,CAAC;CACf;AA+BD,6EAA6E;AAC7E,wBAAgB,YAAY,CAAC,EAC3B,GAAG,EACH,MAAM,EACN,YAAY,EACZ,KAAK,GACN,EAAE,iBAAiB,2CAkdnB"}

package/dist/components/ui/calendar/context.d.ts

@@ -0,0 +1,56 @@
+import type { CalendarAvailability, CalendarColor, CalendarEvent, CalendarResource, CalendarView, TimeBounds, Weekday } from "../../../lib/calendar";
+import type { CalendarDisplay, CalendarDraft, CalendarLabels, CalendarRenderEvent } from "./types";
+/** Resolved configuration shared by every calendar view (internal). */
+export interface CalendarContextValue {
+    view: CalendarView;
+    locale: string;
+    hour12: boolean;
+    weekStartsOn: Weekday;
+    now: Date;
+    nowIndicator: boolean;
+    labels: CalendarLabels;
+    /** Id of the hidden element describing item keyboard controls. */
+    itemHelpId: string;
+    resources: readonly CalendarResource[];
+    resourceById: Map<string, CalendarResource>;
+    /** Snap step in minutes. */
+    step: number;
+    bounds: TimeBounds;
+    hourHeight: number;
+    slotLabelInterval: number;
+    timelineHourWidth: number;
+    resourceMinWidth: number;
+    editLayer: "events" | "availability";
+    selectable: boolean;
+    clickCreateDuration: number;
+    hasAvailability: boolean;
+    shadeOutsideAvailability: boolean;
+    /** Undefined = fit to the cell height. */
+    monthMaxEvents?: number;
+    agendaShowAvailability: boolean;
+    /** Text shown in the grid, month and timeline (not the agenda). */
+    display: Required<CalendarDisplay>;
+    scrollToMinute?: number;
+    scrollAlign: "start" | "center";
+    canEditEvent: (event: CalendarEvent) => boolean;
+    canEditBlock: (block: CalendarAvailability) => boolean;
+    eventColor: (event: CalendarEvent) => CalendarColor;
+    blockColor: (block: CalendarAvailability) => CalendarColor;
+    statusLabel: (event: CalendarEvent) => string | undefined;
+    describeEvent: (event: CalendarEvent) => string;
+    describeBlock: (block: CalendarAvailability) => string;
+    renderEvent?: CalendarRenderEvent<unknown>;
+    hasEventClick: boolean;
+    hasBlockClick: boolean;
+    clickEvent: (event: CalendarEvent) => void;
+    clickBlock: (block: CalendarAvailability) => void;
+    /** Returns a rejection reason for a draft, if any. */
+    check: (draft: CalendarDraft) => string | undefined;
+    /** Validates and emits a draft. Returns false when it was rejected. */
+    commit: (draft: CalendarDraft, source: "pointer" | "keyboard") => boolean;
+    /** Opens a day (header or month-cell click). */
+    openDay: (date: Date) => void;
+}
+export declare const CalendarContext: import("react").Context<CalendarContextValue | null>;
+export declare function useCalendarContext(): CalendarContextValue;
+//# sourceMappingURL=context.d.ts.map

package/dist/components/ui/calendar/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../../../src/components/ui/calendar/context.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,oBAAoB,EACpB,aAAa,EACb,aAAa,EACb,gBAAgB,EAChB,YAAY,EACZ,UAAU,EACV,OAAO,EACR,MAAM,uBAAuB,CAAC;AAC/B,OAAO,KAAK,EACV,eAAe,EACf,aAAa,EACb,cAAc,EACd,mBAAmB,EACpB,MAAM,SAAS,CAAC;AAEjB,uEAAuE;AACvE,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,YAAY,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,OAAO,CAAC;IAChB,YAAY,EAAE,OAAO,CAAC;IACtB,GAAG,EAAE,IAAI,CAAC;IACV,YAAY,EAAE,OAAO,CAAC;IACtB,MAAM,EAAE,cAAc,CAAC;IACvB,kEAAkE;IAClE,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,SAAS,gBAAgB,EAAE,CAAC;IACvC,YAAY,EAAE,GAAG,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;IAC5C,4BAA4B;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,UAAU,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,gBAAgB,EAAE,MAAM,CAAC;IACzB,SAAS,EAAE,QAAQ,GAAG,cAAc,CAAC;IACrC,UAAU,EAAE,OAAO,CAAC;IACpB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,eAAe,EAAE,OAAO,CAAC;IACzB,wBAAwB,EAAE,OAAO,CAAC;IAClC,0CAA0C;IAC1C,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,sBAAsB,EAAE,OAAO,CAAC;IAChC,mEAAmE;IACnE,OAAO,EAAE,QAAQ,CAAC,eAAe,CAAC,CAAC;IACnC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,WAAW,EAAE,OAAO,GAAG,QAAQ,CAAC;IAChC,YAAY,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,OAAO,CAAC;IAChD,YAAY,EAAE,CAAC,KAAK,EAAE,oBAAoB,KAAK,OAAO,CAAC;IACvD,UAAU,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,aAAa,CAAC;IACpD,UAAU,EAAE,CAAC,KAAK,EAAE,oBAAoB,KAAK,aAAa,CAAC;IAC3D,WAAW,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,MAAM,GAAG,SAAS,CAAC;IAC1D,aAAa,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,MAAM,CAAC;IAChD,aAAa,EAAE,CAAC,KAAK,EAAE,oBAAoB,KAAK,MAAM,CAAC;IACvD,WAAW,CAAC,EAAE,mBAAmB,CAAC,OAAO,CAAC,CAAC;IAC3C,aAAa,EAAE,OAAO,CAAC;IACvB,aAAa,EAAE,OAAO,CAAC;IACvB,UAAU,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,IAAI,CAAC;IAC3C,UAAU,EAAE,CAAC,KAAK,EAAE,oBAAoB,KAAK,IAAI,CAAC;IAClD,sDAAsD;IACtD,KAAK,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,MAAM,GAAG,SAAS,CAAC;IACpD,uEAAuE;IACvE,MAAM,EAAE,CAAC,KAAK,EAAE,aAAa,EAAE,MAAM,EAAE,SAAS,GAAG,UAAU,KAAK,OAAO,CAAC;IAC1E,gDAAgD;IAChD,OAAO,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,IAAI,CAAC;CAC/B;AAED,eAAO,MAAM,eAAe,sDAAmD,CAAC;AAEhF,wBAAgB,kBAAkB,IAAI,oBAAoB,CAIzD"}

package/dist/components/ui/calendar/items.d.ts

@@ -0,0 +1,46 @@
+import type { CSSProperties, KeyboardEvent, MouseEvent } from "react";
+import { type CalendarAvailability, type CalendarEvent } from "../../../lib/calendar";
+import type { CalendarDraft } from "./types";
+interface EventBoxProps {
+    event: CalendarEvent;
+    style: CSSProperties;
+    /** Resize handle edge, or none. */
+    resizeEdge?: "bottom" | "right";
+    compact: boolean;
+    /** Title plus one time · status line (timeline rows). */
+    dense?: boolean;
+    continuesBefore?: boolean;
+    continuesAfter?: boolean;
+    dragging?: boolean;
+    onKeyDown?: (e: KeyboardEvent<HTMLElement>) => void;
+    /**
+     * Click handler. Boxes inside the pointer-handled grid only need it for
+     * assistive-technology activation (a synthetic click, `detail === 0`).
+     */
+    onClick?: (e: MouseEvent<HTMLElement>) => void;
+}
+/** A positioned event in the time grid, all-day row or timeline. */
+export declare function EventBox({ event, style, resizeEdge, compact, dense, continuesBefore, continuesAfter, dragging, onKeyDown, onClick, }: EventBoxProps): import("react/jsx-runtime").JSX.Element;
+interface BlockBoxProps {
+    block: CalendarAvailability;
+    style: CSSProperties;
+    resizeEdge?: "bottom" | "right";
+    continuesAfter?: boolean;
+    dragging?: boolean;
+    onKeyDown?: (e: KeyboardEvent<HTMLElement>) => void;
+    /** Like `EventBox`'s `onClick`. */
+    onClick?: (e: MouseEvent<HTMLElement>) => void;
+}
+/**
+ * An availability block. In the events layer it's a passive background tint;
+ * with `editLayer="availability"` it becomes a focusable, draggable card.
+ */
+export declare function BlockBox({ block, style, resizeEdge, continuesAfter, dragging, onKeyDown, onClick, }: BlockBoxProps): import("react/jsx-runtime").JSX.Element | null;
+/** Drag preview: the proposed time, or why it's not allowed. */
+export declare function Ghost({ draft, invalid, style, }: {
+    draft: CalendarDraft;
+    invalid?: string;
+    style: CSSProperties;
+}): import("react/jsx-runtime").JSX.Element;
+export {};
+//# sourceMappingURL=items.d.ts.map

package/dist/components/ui/calendar/items.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"items.d.ts","sourceRoot":"","sources":["../../../../src/components/ui/calendar/items.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,OAAO,CAAC;AAEtE,OAAO,EAEL,KAAK,oBAAoB,EACzB,KAAK,aAAa,EACnB,MAAM,uBAAuB,CAAC;AAG/B,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAE7C,UAAU,aAAa;IACrB,KAAK,EAAE,aAAa,CAAC;IACrB,KAAK,EAAE,aAAa,CAAC;IACrB,mCAAmC;IACnC,UAAU,CAAC,EAAE,QAAQ,GAAG,OAAO,CAAC;IAChC,OAAO,EAAE,OAAO,CAAC;IACjB,yDAAyD;IACzD,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,SAAS,CAAC,EAAE,CAAC,CAAC,EAAE,aAAa,CAAC,WAAW,CAAC,KAAK,IAAI,CAAC;IACpD;;;OAGG;IACH,OAAO,CAAC,EAAE,CAAC,CAAC,EAAE,UAAU,CAAC,WAAW,CAAC,KAAK,IAAI,CAAC;CAChD;AAED,oEAAoE;AACpE,wBAAgB,QAAQ,CAAC,EACvB,KAAK,EACL,KAAK,EACL,UAAU,EACV,OAAO,EACP,KAAK,EACL,eAAe,EACf,cAAc,EACd,QAAQ,EACR,SAAS,EACT,OAAO,GACR,EAAE,aAAa,2CAwEf;AAmDD,UAAU,aAAa;IACrB,KAAK,EAAE,oBAAoB,CAAC;IAC5B,KAAK,EAAE,aAAa,CAAC;IACrB,UAAU,CAAC,EAAE,QAAQ,GAAG,OAAO,CAAC;IAChC,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,SAAS,CAAC,EAAE,CAAC,CAAC,EAAE,aAAa,CAAC,WAAW,CAAC,KAAK,IAAI,CAAC;IACpD,mCAAmC;IACnC,OAAO,CAAC,EAAE,CAAC,CAAC,EAAE,UAAU,CAAC,WAAW,CAAC,KAAK,IAAI,CAAC;CAChD;AAED;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,EACvB,KAAK,EACL,KAAK,EACL,UAAU,EACV,cAAc,EACd,QAAQ,EACR,SAAS,EACT,OAAO,GACR,EAAE,aAAa,kDAkDf;AAED,gEAAgE;AAChE,wBAAgB,KAAK,CAAC,EACpB,KAAK,EACL,OAAO,EACP,KAAK,GACN,EAAE;IACD,KAAK,EAAE,aAAa,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,aAAa,CAAC;CACtB,2CAsBA"}

package/dist/components/ui/calendar/types.d.ts

@@ -0,0 +1,125 @@
+import type { ReactNode } from "react";
+import type { CalendarAvailability, CalendarEvent, CalendarEventStatus, CalendarView, DateRange } from "../../../lib/calendar";
+/** A new range picked by dragging (or clicking) on empty time. */
+export interface CalendarSelection {
+    start: Date;
+    end: Date;
+    allDay: boolean;
+    /** Resource of the column or row the selection was made in. */
+    resourceId?: string;
+    /** How it was made. */
+    source: "pointer" | "keyboard";
+}
+interface ChangeBase {
+    action: "move" | "resize";
+    start: Date;
+    end: Date;
+    /** Resource of the column/row it was dropped on (undefined without resources). */
+    resourceId?: string;
+    /** Resource of the column/row the change started from. */
+    previousResourceId?: string;
+    /**
+     * The item's resource ids with `previousResourceId` replaced by
+     * `resourceId`; undefined when the item had none (applies to all).
+     */
+    resourceIds?: string[];
+    source: "pointer" | "keyboard";
+}
+/** A requested move or resize of an event. The consumer applies it. */
+export interface CalendarEventChange<T = unknown> extends ChangeBase {
+    event: CalendarEvent<T>;
+}
+/** A requested move or resize of an availability block. */
+export interface CalendarAvailabilityChange<A = unknown> extends ChangeBase {
+    availability: CalendarAvailability<A>;
+}
+/**
+ * A proposed create/move/resize, passed to `validate` while the user drags
+ * (and before keyboard changes) so you can reject it with a reason.
+ */
+export type CalendarDraft<T = unknown, A = unknown> = ({
+    target: "selection";
+    action: "create";
+} & Omit<CalendarSelection, "source">) | ({
+    target: "event";
+} & Omit<CalendarEventChange<T>, "source">) | ({
+    target: "availability";
+} & Omit<CalendarAvailabilityChange<A>, "source">);
+/**
+ * Text shown on event boxes, chips and availability blocks in the time
+ * grid, month and timeline. Hidden text is removed, never substituted, and
+ * stays in the screen-reader labels of events and editable blocks. The
+ * agenda always shows it all.
+ * Every field defaults to true.
+ */
+export interface CalendarDisplay {
+    /** Start and end times. */
+    time?: boolean;
+    /** The event's `description` line, e.g. service and room. */
+    description?: boolean;
+    /** Status labels such as "Tentative". The box styling still marks status. */
+    status?: boolean;
+    /** The event's `badge`, e.g. "Arrived". */
+    badge?: boolean;
+    /** Block labels. Off leaves blocks unlabelled rather than "Available". */
+    blockLabels?: boolean;
+    /**
+     * Draw `available` blocks. Off hides them but they still mark working
+     * hours for the outside-availability shading. Always on while editing
+     * availability.
+     */
+    availableBlocks?: boolean;
+}
+/** Visible range reported by `onRangeChange`. */
+export interface CalendarRange extends DateRange {
+    view: CalendarView;
+}
+/** Context passed to `renderEvent`. */
+export interface CalendarEventRenderContext {
+    view: CalendarView;
+    /** True when the box is too short for more than one line. */
+    compact: boolean;
+    /** Formatted time range, e.g. "09:00–09:30". */
+    timeLabel: string;
+    /**
+     * Text for the event's status: undefined when confirmed or when
+     * `display.status` is false.
+     */
+    statusLabel?: string;
+}
+/** Every user-facing string, for translation or different wording. */
+export interface CalendarLabels {
+    today: string;
+    previous: string;
+    next: string;
+    view: string;
+    allDay: string;
+    more: (count: number) => string;
+    /** Count announced for a month day, e.g. "3 events". */
+    eventCount: (count: number) => string;
+    showLess: string;
+    noEvents: string;
+    noResources: string;
+    earlier: (count: number) => string;
+    later: (count: number) => string;
+    available: string;
+    unavailable: string;
+    loading: string;
+    close: string;
+    views: Record<CalendarView, string>;
+    status: Record<CalendarEventStatus, string>;
+    /** Screen-reader help for the time grid's keyboard controls. */
+    gridHelp: string;
+    /** Screen-reader help for focused events and blocks. */
+    itemHelp: string;
+}
+/** Partial labels; `views` and `status` may be partial too. */
+export type CalendarLabelOverrides = Partial<Omit<CalendarLabels, "views" | "status">> & {
+    views?: Partial<CalendarLabels["views"]>;
+    status?: Partial<CalendarLabels["status"]>;
+};
+export declare const DEFAULT_CALENDAR_LABELS: CalendarLabels;
+/** Render override for an event's contents. */
+export type CalendarRenderEvent<T> = (event: CalendarEvent<T>, context: CalendarEventRenderContext) => ReactNode;
+export {};
+//# sourceMappingURL=types.d.ts.map

package/dist/components/ui/calendar/types.d.ts.map

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

package/dist/components/ui/calendar/useGridInteraction.d.ts

@@ -0,0 +1,39 @@
+import { type FocusEvent, type KeyboardEvent, type PointerEvent as ReactPointerEvent, type RefObject } from "react";
+import { type CalendarAvailability, type CalendarEvent } from "../../../lib/calendar";
+import type { CalendarDraft } from "./types";
+export interface GridColumn {
+    key: string;
+    day: Date;
+    resourceId?: string;
+}
+export interface GridDraftState {
+    draft: CalendarDraft;
+    invalid?: string;
+    itemId?: string;
+}
+export interface GridCursor {
+    column: number;
+    start: number;
+    end: number;
+}
+interface Options {
+    axis: "x" | "y";
+    columns: readonly GridColumn[];
+    pxPerMinute: number;
+    scrollRef: RefObject<HTMLElement | null>;
+    events: ReadonlyMap<string, CalendarEvent>;
+    blocks: ReadonlyMap<string, CalendarAvailability>;
+    /** Column the keyboard cursor starts in. */
+    initialColumn: number;
+}
+export declare function useGridInteraction({ axis, columns, pxPerMinute, scrollRef, events, blocks, initialColumn, }: Options): {
+    drag: GridDraftState | null;
+    cursor: GridCursor | null;
+    onPointerDown: (e: ReactPointerEvent<HTMLElement>) => void;
+    onItemKeyDown: (e: KeyboardEvent<HTMLElement>, type: "event" | "availability", id: string, columnIndex: number) => void;
+    onGridFocus: (e: FocusEvent<HTMLElement>) => void;
+    onGridBlur: (e: FocusEvent<HTMLElement>) => void;
+    onGridKeyDown: (e: KeyboardEvent<HTMLElement>) => void;
+};
+export {};
+//# sourceMappingURL=useGridInteraction.d.ts.map