@leonardaustin/ui 0.4.0 → 0.5.1

package/dist/lib/calendar.d.ts

@@ -0,0 +1,305 @@
+/**
+ * Calendar layouts. `threeDay` and `workWeek` are time grids like `week`;
+ * `timeline` is a single day with one horizontal row per resource.
+ */
+export type CalendarView = "day" | "threeDay" | "workWeek" | "week" | "month" | "agenda" | "timeline";
+/** 0 = Sunday … 6 = Saturday, matching `Date#getDay()`. */
+export type Weekday = 0 | 1 | 2 | 3 | 4 | 5 | 6;
+/** Semantic colours, mapped to the theme's colour tokens. */
+export type CalendarColor = "accent" | "blue" | "green" | "yellow" | "red" | "purple" | "gray";
+/**
+ * Booking state. `tentative` is unconfirmed (e.g. awaiting confirmation),
+ * `held` is capacity reserved without a booking, `cancelled` stays visible
+ * but muted. Non-confirmed statuses also render a text label (unless
+ * `display.status` is false), and the box styling always differs, so status
+ * never relies on colour alone.
+ */
+export type CalendarEventStatus = "confirmed" | "tentative" | "held" | "cancelled";
+/** `available` blocks are bookable time; `unavailable` blocks are absences. */
+export type AvailabilityKind = "available" | "unavailable";
+/** A column (time grid) or row (timeline): a clinician, room, etc. */
+export interface CalendarResource {
+    id: string;
+    title: string;
+    /** Second line in the header, e.g. a role or site. */
+    subtitle?: string;
+    /** Timeline rows are grouped (and collapsible) by this label. */
+    group?: string;
+    /** Default colour for this resource's events and availability. */
+    color?: CalendarColor;
+}
+/** A booking, appointment or other event. End is exclusive. */
+export interface CalendarEvent<T = unknown> {
+    id: string;
+    title: string;
+    start: Date;
+    end: Date;
+    /** Shown in the all-day row. Events lasting 24h or more go there too. */
+    allDay?: boolean;
+    /**
+     * Resource(s) the event belongs to. An array shows the event in each
+     * resource's column — e.g. both the clinician's and the room's row.
+     */
+    resourceId?: string | readonly string[];
+    color?: CalendarColor;
+    status?: CalendarEventStatus;
+    /** Secondary line, e.g. service and room. */
+    description?: string;
+    /** Short extra label, e.g. "Arrived" or "Unpaid". */
+    badge?: string;
+    /** Set false to stop this event being moved or resized. */
+    editable?: boolean;
+    /**
+     * A temporary stand-in, such as the slot behind an open "new booking"
+     * dialog. Drawn raised in its colour, it can't be focused, clicked, moved
+     * or resized, and the agenda leaves it out.
+     */
+    placeholder?: boolean;
+    /** Your own payload, passed back untouched in callbacks. */
+    data?: T;
+}
+/** A block of availability (or unavailability) drawn behind events. */
+export interface CalendarAvailability<T = unknown> {
+    id: string;
+    start: Date;
+    end: Date;
+    /** Defaults to `available`. */
+    kind?: AvailabilityKind;
+    /**
+     * Resource(s) this block applies to. Omit to apply it to every column
+     * (e.g. a practice closure).
+     */
+    resourceId?: string | readonly string[];
+    /** Label such as a room name or an absence category. */
+    label?: string;
+    color?: CalendarColor;
+    /** Set false to stop this block being moved or resized. */
+    editable?: boolean;
+    /** A temporary stand-in, like `CalendarEvent.placeholder`. */
+    placeholder?: boolean;
+    /** Recurring rule this occurrence came from (see `expandAvailabilityRules`). */
+    seriesId?: string;
+    /** The occurrence's civil date ("YYYY-MM-DD") within its series. */
+    occurrenceKey?: string;
+    data?: T;
+}
+/** Half-open range [start, end). */
+export interface DateRange {
+    start: Date;
+    end: Date;
+}
+export interface CalendarViewOptions {
+    /** First day of the week. Defaults to 1 (Monday). */
+    weekStartsOn?: Weekday;
+    /** Days shown by `workWeek`. Defaults to Monday–Friday. */
+    workWeekDays?: readonly Weekday[];
+    /** Days shown by `agenda`. Defaults to 7. */
+    agendaDays?: number;
+}
+export declare const MINUTES_PER_DAY = 1440;
+/** Local midnight at the start of `date`'s day. */
+export declare function startOfDay(date: Date): Date;
+/** Adds calendar days, keeping the wall-clock time (DST-safe). */
+export declare function addDays(date: Date, days: number): Date;
+/** Adds wall-clock minutes. */
+export declare function addMinutes(date: Date, minutes: number): Date;
+/** Adds months, clamping the day (31 Jan + 1 month = 28/29 Feb). */
+export declare function addMonths(date: Date, months: number): Date;
+/** Midnight on the first day of `date`'s week. */
+export declare function startOfWeek(date: Date, weekStartsOn?: Weekday): Date;
+export declare function startOfMonth(date: Date): Date;
+export declare function isSameDay(a: Date, b: Date): boolean;
+/** Whole calendar days from `b` to `a` (ignores time and DST). */
+export declare function differenceInDays(a: Date, b: Date): number;
+/** Wall-clock minutes since local midnight, including fractions. */
+export declare function minutesOfDay(date: Date): number;
+/** The local time `minutes` after midnight on `day` (may roll over). */
+export declare function dateAtMinutes(day: Date, minutes: number): Date;
+/** Parses "HH:mm" (or "H:mm"; "24:00" allowed) into minutes. */
+export declare function parseTime(value: string): number;
+/** Formats minutes as "HH:mm" (1440 → "24:00"). */
+export declare function formatTimeOfDay(minutes: number): string;
+/** Civil date key "YYYY-MM-DD" for `date`'s local day. */
+export declare function toDateKey(date: Date): string;
+/** Local midnight for a "YYYY-MM-DD" key. */
+export declare function fromDateKey(key: string): Date;
+/** Snaps minutes to a multiple of `step`. */
+export declare function snapMinutes(minutes: number, step: number, mode?: "round" | "floor" | "ceil"): number;
+/** Snaps a date's wall-clock time on its own day to `step` minutes. */
+export declare function snapDate(date: Date, step: number, mode?: "round" | "floor" | "ceil"): Date;
+/** Clamps `value` into [min, max]. */
+export declare function clamp(value: number, min: number, max: number): number;
+/** The time-grid views (vertical day columns). */
+export declare function isTimeGridView(view: CalendarView): boolean;
+/** Days shown by `view` for the anchor `date`, in order. */
+export declare function getVisibleDays(view: CalendarView, date: Date, options?: CalendarViewOptions): Date[];
+/** Month grid as whole weeks, from the week containing the 1st. */
+export declare function getMonthWeeks(date: Date, weekStartsOn?: Weekday): Date[][];
+/** The [start, end) range covered by `view`. */
+export declare function getViewRange(view: CalendarView, date: Date, options?: CalendarViewOptions): DateRange;
+/** The anchor date one page before (-1) or after (1) `date`. */
+export declare function shiftDate(view: CalendarView, date: Date, direction: -1 | 1, options?: CalendarViewOptions): Date;
+/** Cached `Intl.DateTimeFormat`. */
+export declare function getFormatter(locale: string, options: Intl.DateTimeFormatOptions): Intl.DateTimeFormat;
+export interface FormatOptions {
+    /** BCP 47 locale. Defaults to "en-GB". */
+    locale?: string;
+    /** 12-hour clock. Defaults to false (24-hour). */
+    hour12?: boolean;
+}
+/** "09:30" (or "9:30 am" with `hour12`). */
+export declare function formatTime(date: Date, options?: FormatOptions): string;
+/** "09:30–10:00". */
+export declare function formatTimeRange(start: Date, end: Date, options?: FormatOptions): string;
+/** Hour gutter label: "09:00" (or "9 am"). */
+export declare function formatHourLabel(minutes: number, options?: FormatOptions): string;
+/** "Thursday 16 October 2026". */
+export declare function formatLongDate(date: Date, locale?: string): string;
+/** Toolbar title for a view, e.g. "13 – 19 October 2026". */
+export declare function formatRangeTitle(view: CalendarView, date: Date, options?: CalendarViewOptions & {
+    locale?: string;
+}): string;
+/** True when [aStart, aEnd) and [bStart, bEnd) share any time. */
+export declare function rangesOverlap(aStart: number, aEnd: number, bStart: number, bEnd: number): boolean;
+/** The part of [start, end) that falls on `day`, in minutes of that day. */
+export interface DaySegment {
+    startMinute: number;
+    endMinute: number;
+    /** The interval began on an earlier day. */
+    continuesBefore: boolean;
+    /** The interval carries on into a later day. */
+    continuesAfter: boolean;
+}
+export declare function daySegment(start: Date, end: Date, day: Date): DaySegment | null;
+/** Sorts and merges overlapping or touching [start, end) pairs. */
+export declare function mergeIntervals(intervals: ReadonlyArray<readonly [number, number]>): Array<[number, number]>;
+/** [start, end) minus every interval in `cuts`. */
+export declare function subtractIntervals(start: number, end: number, cuts: ReadonlyArray<readonly [number, number]>): Array<[number, number]>;
+export interface LayoutItem {
+    id: string;
+    start: number;
+    end: number;
+}
+export interface LayoutSlot {
+    /** Zero-based column within the overlapping cluster. */
+    column: number;
+    /** Columns in the cluster. Left = column / columns. */
+    columns: number;
+    /** Columns this item can widen across. Width = span / columns. */
+    span: number;
+}
+/**
+ * Lays out overlapping intervals in side-by-side columns. Items that overlap
+ * (directly or through a chain) form a cluster sharing a column count; each
+ * item takes the first free column and then widens right across columns that
+ * have nothing overlapping it. `minDuration` treats very short items as at
+ * least that long so their rendered boxes don't collide.
+ */
+export declare function layoutOverlaps(items: readonly LayoutItem[], minDuration?: number): Map<string, LayoutSlot>;
+/**
+ * Stacks intervals into lanes (rows) so none in a lane overlap. Used by the
+ * all-day row and timeline rows. Returns each id's lane and the lane count.
+ */
+export declare function packLanes(items: readonly LayoutItem[]): {
+    lanes: Map<string, number>;
+    count: number;
+};
+/** Normalises a `resourceId` field to an array (empty = all resources). */
+export declare function resourceIdsOf(value: string | readonly string[] | undefined): readonly string[];
+/** Whether an item with `value` belongs in `resourceId`'s column. */
+export declare function matchesResource(value: string | readonly string[] | undefined, resourceId: string | undefined, { emptyMatchesAll }: {
+    emptyMatchesAll: boolean;
+}): boolean;
+/** Replaces `from` with `to` in an item's resource ids. */
+export declare function replaceResource(value: string | readonly string[] | undefined, from: string | undefined, to: string | undefined): string[] | undefined;
+/**
+ * Resources with any event or available block in `range` — an "active
+ * schedule" filter. Absences (`unavailable` blocks) don't count, and items
+ * without a resource id don't make every resource active.
+ */
+export declare function getActiveResourceIds(range: DateRange, events: ReadonlyArray<Pick<CalendarEvent, "start" | "end" | "resourceId">>, availability?: ReadonlyArray<Pick<CalendarAvailability, "start" | "end" | "resourceId" | "kind">>): Set<string>;
+export interface WeeklyRecurrence {
+    /** Days of the week the rule repeats on. */
+    weekdays: readonly Weekday[];
+    /** Repeat every N weeks, counted from the rule's start week. Default 1. */
+    interval?: number;
+    /** Last date (inclusive) as "YYYY-MM-DD". Omit for no end. */
+    until?: string;
+    /** Occurrence dates ("YYYY-MM-DD") to skip, e.g. detached exceptions. */
+    exclusions?: readonly string[];
+}
+/** A weekly (or one-off) availability rule with civil dates and times. */
+export interface AvailabilityRule<T = unknown> {
+    id: string;
+    /** First date as "YYYY-MM-DD". */
+    startDate: string;
+    /** "HH:mm" local start time. */
+    startTime: string;
+    /** "HH:mm" local end time; at or before `startTime` means overnight. */
+    endTime: string;
+    /** Omit or null for a one-off block on `startDate`. */
+    recurrence?: WeeklyRecurrence | null;
+    kind?: AvailabilityKind;
+    resourceId?: string | readonly string[];
+    label?: string;
+    color?: CalendarColor;
+    editable?: boolean;
+    data?: T;
+}
+/**
+ * Expands rules into concrete blocks overlapping `range`. Each occurrence's
+ * id is `${rule.id}@${dateKey}`, with `seriesId` and `occurrenceKey` set so a
+ * move or resize can be applied to "this occurrence" or "this and following".
+ * Intervals count whole weeks from the week containing `startDate`.
+ */
+export declare function expandAvailabilityRules<T>(rules: ReadonlyArray<AvailabilityRule<T>>, range: DateRange, options?: {
+    weekStartsOn?: Weekday;
+}): CalendarAvailability<T>[];
+/** Visible window of a time grid, in minutes of the day. */
+export interface TimeBounds {
+    min: number;
+    max: number;
+}
+/** Converts a pointer offset (px from the grid's top/left) into minutes. */
+export declare function offsetToMinutes(offsetPx: number, pxPerMinute: number, bounds: TimeBounds): number;
+/**
+ * New range when dragging to create: from the slot under the anchor to the
+ * slot under the pointer, inclusive, on `day`. Edges that fall in a
+ * spring-forward gap clamp to its end, so the range is never longer than the
+ * slots dragged over.
+ */
+export declare function computeCreateRange(day: Date, anchorMinute: number, pointerMinute: number, step: number, bounds: TimeBounds): DateRange;
+/**
+ * New range when moving an item so the point grabbed (`grabOffsetMinutes`
+ * after its start) follows the pointer on `day`. Keeps the duration (in
+ * elapsed time, so a move never resizes across a DST change), snaps the
+ * start to `step`, and keeps a single-day item inside `bounds`.
+ */
+export declare function computeMoveRange(original: DateRange, day: Date, pointerMinute: number, grabOffsetMinutes: number, step: number, bounds: TimeBounds): DateRange;
+/**
+ * New end when dragging an item's end edge on `day` (the day of its last
+ * segment). The end snaps to `step` and stays at least one step after the
+ * start (or the day's start, for an item that began earlier).
+ */
+export declare function computeResizeEnd(original: DateRange, day: Date, pointerMinute: number, step: number, bounds: TimeBounds): Date;
+/**
+ * Keyboard nudge (Alt+arrow) by `minutes`, keeping the elapsed duration.
+ * Like a pointer move, an item inside the visible window stays inside it, so
+ * it never scrolls out of view and takes focus with it.
+ */
+export declare function computeNudgeRange(range: DateRange, minutes: number, bounds: TimeBounds): DateRange;
+/** Moves a range by wall-clock minutes. */
+export declare function shiftRange(range: DateRange, minutes: number): DateRange;
+/** Moves a range by whole days, keeping wall-clock times. */
+export declare function shiftRangeDays(range: DateRange, days: number): DateRange;
+/** Whether two ranges are the same instants. */
+export declare function sameRange(a: DateRange, b: DateRange): boolean;
+/** Whether an event belongs in the all-day row rather than the time grid. */
+export declare function isAllDayLike(item: {
+    allDay?: boolean;
+    start: Date;
+    end: Date;
+}): boolean;
+/** Events touching `day`, all-day first then by start time and length. */
+export declare function eventsOnDay<E extends CalendarEvent>(events: readonly E[], day: Date): E[];
+//# sourceMappingURL=calendar.d.ts.map

package/dist/lib/calendar.d.ts.map

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

package/dist/lib/codeInput.d.ts

@@ -0,0 +1,28 @@
+export interface CodeEdit {
+    slots: string[];
+    /** Box to focus after the edit. */
+    focus: number;
+}
+/** Spreads `value`'s digits across `length` slots; anything else is dropped. */
+export declare function toSlots(value: string, length: number): string[];
+/**
+ * Works out what the user added to a box. A box that already held a digit
+ * and still contains it received an insertion; that text ends at the caret.
+ * Otherwise (empty box, or the selected digit was replaced) it's the raw value.
+ */
+export declare function insertedText(raw: string, current: string, caret: number | null): string;
+/**
+ * Applies text arriving in box `index` from typing, autofill or paste.
+ * Returns null when the text isn't usable, so the edit is ignored.
+ *
+ * - A standalone run of exactly `length` digits anywhere in the text (e.g.
+ *   "Your code is 123456") replaces the whole code.
+ * - Text made only of digits, spaces and dashes fills from `index` onward,
+ *   or replaces the whole code when it holds exactly `length` digits.
+ */
+export declare function applyText(slots: readonly string[], index: number, text: string): CodeEdit | null;
+/** Handles an input event on box `index`; an empty value clears that box. */
+export declare function applyInput(slots: readonly string[], index: number, raw: string, caret: number | null): CodeEdit | null;
+/** Backspace clears the box, or steps back and clears the previous one. */
+export declare function applyBackspace(slots: readonly string[], index: number): CodeEdit | null;
+//# sourceMappingURL=codeInput.d.ts.map

package/dist/lib/codeInput.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codeInput.d.ts","sourceRoot":"","sources":["../../src/lib/codeInput.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,QAAQ;IACvB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,mCAAmC;IACnC,KAAK,EAAE,MAAM,CAAC;CACf;AAED,gFAAgF;AAChF,wBAAgB,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAG/D;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAC1B,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,GAAG,IAAI,GACnB,MAAM,CAKR;AAED;;;;;;;;GAQG;AACH,wBAAgB,SAAS,CACvB,KAAK,EAAE,SAAS,MAAM,EAAE,EACxB,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,GACX,QAAQ,GAAG,IAAI,CAiBjB;AAED,6EAA6E;AAC7E,wBAAgB,UAAU,CACxB,KAAK,EAAE,SAAS,MAAM,EAAE,EACxB,KAAK,EAAE,MAAM,EACb,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,GAAG,IAAI,GACnB,QAAQ,GAAG,IAAI,CAOjB;AAED,2EAA2E;AAC3E,wBAAgB,cAAc,CAC5B,KAAK,EAAE,SAAS,MAAM,EAAE,EACxB,KAAK,EAAE,MAAM,GACZ,QAAQ,GAAG,IAAI,CAMjB"}

package/dist/lib/passwordRequirements.d.ts

@@ -0,0 +1,12 @@
+/** A single rule shown by `PasswordRequirements`. */
+export interface PasswordRequirement {
+    /** Shown in the checklist. Must be unique within a rule list. */
+    label: string;
+    /** Returns true when `password` satisfies this rule. */
+    test: (password: string) => boolean;
+}
+/** Length, upper, lower and digit — a sensible default rule set. Frozen. */
+export declare const defaultPasswordRequirements: readonly PasswordRequirement[];
+/** True when `password` passes every rule — use it in submit validation. */
+export declare function meetsPasswordRequirements(password: string, requirements?: readonly PasswordRequirement[]): boolean;
+//# sourceMappingURL=passwordRequirements.d.ts.map

package/dist/lib/passwordRequirements.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"passwordRequirements.d.ts","sourceRoot":"","sources":["../../src/lib/passwordRequirements.ts"],"names":[],"mappings":"AAAA,qDAAqD;AACrD,MAAM,WAAW,mBAAmB;IAClC,iEAAiE;IACjE,KAAK,EAAE,MAAM,CAAC;IACd,wDAAwD;IACxD,IAAI,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC;CACrC;AASD,4EAA4E;AAC5E,eAAO,MAAM,2BAA2B,EAAE,SAAS,mBAAmB,EAC7C,CAAC;AAE1B,4EAA4E;AAC5E,wBAAgB,yBAAyB,CACvC,QAAQ,EAAE,MAAM,EAChB,YAAY,GAAE,SAAS,mBAAmB,EAAgC,WAG3E"}

package/dist/lib/qrCode.d.ts

@@ -0,0 +1,20 @@
+export type QrErrorCorrection = "L" | "M" | "Q" | "H";
+export interface QrMatrix {
+    /** Modules per side (21 for version 1, +4 per version). */
+    readonly size: number;
+    readonly version: number;
+    /** `modules[y][x]`, `true` for a dark module. */
+    readonly modules: ReadonlyArray<ReadonlyArray<boolean>>;
+}
+/** Thrown when the text doesn't fit in a version 40 symbol at the chosen level. */
+export declare class QrCapacityError extends RangeError {
+    constructor();
+}
+/**
+ * Encodes `text` (UTF-8, byte mode) as a QR Code matrix. Throws a RangeError
+ * if the level isn't L/M/Q/H, and a QrCapacityError (also a RangeError) if the
+ * text is too long for a version 40 symbol at that level (2,953 bytes at L,
+ * 2,331 at M, 1,663 at Q, 1,273 at H).
+ */
+export declare function encodeQrCode(text: string, errorCorrection?: QrErrorCorrection): QrMatrix;
+//# sourceMappingURL=qrCode.d.ts.map

package/dist/lib/qrCode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"qrCode.d.ts","sourceRoot":"","sources":["../../src/lib/qrCode.ts"],"names":[],"mappings":"AASA,MAAM,MAAM,iBAAiB,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,CAAC;AAEtD,MAAM,WAAW,QAAQ;IACvB,2DAA2D;IAC3D,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,iDAAiD;IACjD,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC,CAAC;CACzD;AAED,mFAAmF;AACnF,qBAAa,eAAgB,SAAQ,UAAU;;CAK9C;AAwXD;;;;;GAKG;AACH,wBAAgB,YAAY,CAC1B,IAAI,EAAE,MAAM,EACZ,eAAe,GAAE,iBAAuB,GACvC,QAAQ,CA8CV"}