pixelize-design-library 2.4.2 → 3.0.0

package/dist/Components/CalendarGrid/CalendarGrid.js

@@ -0,0 +1,176 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const jsx_runtime_1 = require("react/jsx-runtime");
+const react_1 = require("react");
+const react_2 = require("@chakra-ui/react");
+const lucide_react_1 = require("lucide-react");
+const Button_1 = __importDefault(require("../Button/Button"));
+const Skeletons_1 = __importDefault(require("../Skeletons/Skeletons"));
+const VisuallyHidden_1 = __importDefault(require("../VisuallyHidden/VisuallyHidden"));
+const useCustomTheme_1 = require("../../Theme/useCustomTheme");
+const focusRing_styles_1 = require("../../Theme/chakra/focusRing.styles");
+const tone_1 = require("../../Theme/tokens/builders/tone");
+const calendarMath_1 = require("./calendarMath");
+const activationKey_1 = require("../Common/activationKey");
+const plural = (n, one, many) => `${n} ${n === 1 ? one : many}`;
+const DEFAULT_LABELS = {
+    today: "Today",
+    previous: "Previous",
+    next: "Next",
+    month: "Month",
+    week: "Week",
+    day: "Day",
+    more: (count) => `+${count} more`,
+    moreLabel: (count, date) => `${plural(count, "more event", "more events")} on ${date}`,
+    eventCount: (count) => plural(count, "event", "events"),
+};
+const VIEWS = ["month", "week", "day"];
+const MAX_LANES = { month: 3, week: 6, day: Infinity };
+const MIN_CELL_HEIGHT = { month: "6.5rem", week: "12rem", day: "16rem" };
+const LANE_HEIGHT = "1.5rem";
+const CHIP_HEIGHT = "1.375rem";
+const CHIP_INSET = "2px";
+const EventChip = ({ event, colors, surface, onEventClick, segment }) => {
+    var _a;
+    const tone = (0, tone_1.resolveSoftTone)(colors, (0, tone_1.toneScale)(colors, (_a = event.tone) !== null && _a !== void 0 ? _a : "neutral"), surface);
+    const left = (segment === null || segment === void 0 ? void 0 : segment.continuesBefore) ? "0px" : CHIP_INSET;
+    const right = (segment === null || segment === void 0 ? void 0 : segment.continuesAfter) ? "0px" : CHIP_INSET;
+    const span = segment ? segment.endCol - segment.startCol + 1 : 1;
+    const placement = segment
+        ? {
+            position: "absolute",
+            zIndex: 1,
+            top: `calc(${segment.lane} * ${LANE_HEIGHT})`,
+            left,
+            width: `calc(${span * 100}% + ${span - 1}px - ${left} - ${right})`,
+        }
+        : { width: "100%" };
+    const common = {
+        ...placement,
+        display: "flex",
+        alignItems: "center",
+        h: CHIP_HEIGHT,
+        px: 2,
+        fontSize: "xs",
+        fontWeight: 500,
+        lineHeight: 1,
+        textAlign: "left",
+        whiteSpace: "nowrap",
+        overflow: "hidden",
+        textOverflow: "ellipsis",
+        textDecoration: "none",
+        cursor: "pointer",
+        bg: tone.bg,
+        color: tone.fg,
+        border: "1px solid",
+        borderColor: tone.border,
+        borderLeftRadius: (segment === null || segment === void 0 ? void 0 : segment.continuesBefore) ? 0 : "md",
+        borderRightRadius: (segment === null || segment === void 0 ? void 0 : segment.continuesAfter) ? 0 : "md",
+        title: event.label,
+        "data-event-id": event.id,
+        onClick: () => onEventClick === null || onEventClick === void 0 ? void 0 : onEventClick(event),
+        _hover: { bg: tone.hoverBg, borderColor: tone.hoverBorder },
+        _active: { bg: tone.activeBg, borderColor: tone.activeBorder },
+        sx: (0, focusRing_styles_1.focusVisibleStyles)(colors),
+    };
+    return event.href ? ((0, jsx_runtime_1.jsx)(react_2.Box, { as: "a", href: event.href, ...common, children: event.label })) : ((0, jsx_runtime_1.jsx)(react_2.Box, { as: "button", type: "button", ...common, children: event.label }));
+};
+/** Controlled month, week or day grid that places date-granularity events as chips and spanning bars, with a toolbar and arrow-key navigation. */
+const CalendarGrid = ({ view, date, events, onViewChange, onDateChange, onEventClick, renderDayCell, weekStartsOn = 0, locale, isLoading = false, labels, }) => {
+    const { colors } = (0, useCustomTheme_1.useCustomTheme)();
+    const text = { ...DEFAULT_LABELS, ...labels };
+    const today = new Date();
+    const anchor = (0, calendarMath_1.startOfDay)(date);
+    const anchorKey = (0, calendarMath_1.dayKey)(anchor);
+    const weeks = (0, calendarMath_1.visibleWeeks)(view, anchor, weekStartsOn);
+    const columns = weeks[0].length;
+    const visibleKeys = new Set(weeks.flat().map(calendarMath_1.dayKey));
+    const shownEvents = isLoading ? [] : events;
+    const maxLanes = MAX_LANES[view];
+    const [focusedKey, setFocusedKey] = (0, react_1.useState)(anchorKey);
+    const pendingFocus = (0, react_1.useRef)(false);
+    const cellRefs = (0, react_1.useRef)(new Map());
+    const activeKey = visibleKeys.has(focusedKey) ? focusedKey : visibleKeys.has(anchorKey) ? anchorKey : (0, calendarMath_1.dayKey)(weeks[0][0]);
+    (0, react_1.useEffect)(() => {
+        setFocusedKey(anchorKey);
+    }, [anchorKey]);
+    (0, react_1.useEffect)(() => {
+        if (!pendingFocus.current)
+            return;
+        const el = cellRefs.current.get(activeKey);
+        if (!el)
+            return;
+        pendingFocus.current = false;
+        el.focus();
+    });
+    const handleCellKeyDown = (e, cellDate) => {
+        if (e.target !== e.currentTarget)
+            return;
+        if ((0, calendarMath_1.isNavKey)(e.key)) {
+            e.preventDefault();
+            const next = (0, calendarMath_1.moveFocus)(view, cellDate, e.key, weekStartsOn);
+            const inRange = visibleKeys.has((0, calendarMath_1.dayKey)(next));
+            if (!inRange && !onDateChange)
+                return;
+            setFocusedKey((0, calendarMath_1.dayKey)(next));
+            pendingFocus.current = true;
+            if (!inRange)
+                onDateChange === null || onDateChange === void 0 ? void 0 : onDateChange(next);
+            return;
+        }
+        if ((0, activationKey_1.isActivationKey)(e) && onDateChange) {
+            e.preventDefault();
+            onDateChange(cellDate);
+        }
+    };
+    const drillIntoDay = (day) => {
+        onDateChange === null || onDateChange === void 0 ? void 0 : onDateChange(day);
+        onViewChange === null || onViewChange === void 0 ? void 0 : onViewChange("day");
+    };
+    const weekdayShort = (0, calendarMath_1.weekdayLabels)(locale, weekStartsOn, "short");
+    const weekdayLong = (0, calendarMath_1.weekdayLabels)(locale, weekStartsOn, "long");
+    const headerDays = view === "day" ? [(anchor.getDay() - weekStartsOn + 7) % 7] : weekdayShort.map((_, i) => i);
+    const title = (0, calendarMath_1.formatTitle)(view, anchor, locale, weekStartsOn);
+    const template = `repeat(${columns}, minmax(0, 1fr))`;
+    const border = colors.boxborder[200];
+    const renderCell = (day, col, weekIndex, layout) => {
+        const key = (0, calendarMath_1.dayKey)(day);
+        const isToday = (0, calendarMath_1.isSameDay)(day, today);
+        const inMonth = view !== "month" || day.getMonth() === anchor.getMonth();
+        const surface = (0, calendarMath_1.isWeekend)(day) ? colors.backgroundColor.secondary : colors.backgroundColor.main;
+        const dayEvents = (0, calendarMath_1.eventsOnDay)(shownEvents, day);
+        const hidden = layout.hiddenByCol[col];
+        const active = key === activeKey;
+        const label = `${(0, calendarMath_1.formatFullDate)(day, locale)}${dayEvents.length ? `, ${text.eventCount(dayEvents.length)}` : ""}`;
+        const ownSegments = layout.segments.filter((s) => s.startCol === col && s.lane < maxLanes);
+        let body = null;
+        if (isLoading) {
+            body = ((0, jsx_runtime_1.jsx)(react_2.Box, { mt: 1, "aria-hidden": true, children: (weekIndex * 7 + col) % 3 === 0 ? (0, jsx_runtime_1.jsx)(Skeletons_1.default, { type: "skeleton", height: CHIP_HEIGHT, borderRadius: "md" }) : null }));
+        }
+        else if (renderDayCell) {
+            body = (0, jsx_runtime_1.jsx)(react_2.Box, { mt: 1, children: renderDayCell(day, dayEvents) });
+        }
+        else if (view === "day") {
+            body = ((0, jsx_runtime_1.jsx)(react_2.Flex, { direction: "column", gap: 1, mt: 2, children: dayEvents.map((event) => ((0, jsx_runtime_1.jsx)(EventChip, { event: event, colors: colors, surface: surface, onEventClick: onEventClick }, event.id))) }));
+        }
+        else {
+            body = ((0, jsx_runtime_1.jsxs)(jsx_runtime_1.Fragment, { children: [(0, jsx_runtime_1.jsx)(react_2.Box, { position: "relative", mt: 1, h: `calc(${layout.visibleLanes} * ${LANE_HEIGHT})`, children: ownSegments.map((s) => ((0, jsx_runtime_1.jsx)(EventChip, { event: s.event, colors: colors, surface: surface, onEventClick: onEventClick, segment: s }, s.event.id))) }), hidden > 0 ? ((0, jsx_runtime_1.jsx)(react_2.Box, { as: "button", type: "button", "aria-label": text.moreLabel(hidden, (0, calendarMath_1.formatFullDate)(day, locale)), onClick: () => drillIntoDay(day), px: 1, fontSize: "xs", fontWeight: 600, color: colors.header[900], textAlign: "left", textDecoration: "underline", sx: (0, focusRing_styles_1.focusVisibleStyles)(colors), children: text.more(hidden) })) : null] }));
+        }
+        return ((0, jsx_runtime_1.jsxs)(react_2.Box, { role: "gridcell", ref: (el) => {
+                if (el)
+                    cellRefs.current.set(key, el);
+                else
+                    cellRefs.current.delete(key);
+            }, "data-date": key, "aria-current": isToday ? "date" : undefined, tabIndex: active ? 0 : -1, onFocus: () => setFocusedKey(key), onKeyDown: (e) => handleCellKeyDown(e, day), position: "relative", minH: MIN_CELL_HEIGHT[view], p: 1, bg: surface, borderRight: "1px solid", borderBottom: "1px solid", borderColor: border, outline: "none", _focusVisible: {
+                boxShadow: (0, focusRing_styles_1.insetFocusRingShadow)(colors),
+            }, children: [(0, jsx_runtime_1.jsx)(react_2.Text, { as: "span", display: "inline-flex", alignItems: "center", justifyContent: "center", minW: "1.5rem", h: "1.5rem", px: 1, borderRadius: "full", fontSize: "xs-plus", fontWeight: isToday ? 700 : 500, color: isToday ? colors.accentText : inMonth ? colors.header[900] : colors.textMuted, boxShadow: isToday ? `inset 0 0 0 1.5px ${colors.accentText}` : undefined, "aria-hidden": true, children: day.getDate() }), (0, jsx_runtime_1.jsx)(VisuallyHidden_1.default, { position: "absolute", children: label }), body] }, key));
+    };
+    return ((0, jsx_runtime_1.jsxs)(react_2.Box, { children: [(0, jsx_runtime_1.jsxs)(react_2.Flex, { align: "center", justify: "space-between", wrap: "wrap", gap: 2, mb: 3, children: [(0, jsx_runtime_1.jsxs)(react_2.Flex, { align: "center", gap: 2, children: [onDateChange ? ((0, jsx_runtime_1.jsxs)(jsx_runtime_1.Fragment, { children: [(0, jsx_runtime_1.jsx)(Button_1.default, { label: text.today, size: "sm", variant: "outline", onClick: () => onDateChange((0, calendarMath_1.startOfDay)(new Date())) }), (0, jsx_runtime_1.jsx)(Button_1.default, { "aria-label": text.previous, size: "sm", variant: "ghost", leftIcon: (0, jsx_runtime_1.jsx)(lucide_react_1.ChevronLeft, { size: 16, "aria-hidden": true }), onClick: () => onDateChange((0, calendarMath_1.shiftAnchor)(view, anchor, -1)) }), (0, jsx_runtime_1.jsx)(Button_1.default, { "aria-label": text.next, size: "sm", variant: "ghost", leftIcon: (0, jsx_runtime_1.jsx)(lucide_react_1.ChevronRight, { size: 16, "aria-hidden": true }), onClick: () => onDateChange((0, calendarMath_1.shiftAnchor)(view, anchor, 1)) })] })) : null, (0, jsx_runtime_1.jsx)(react_2.Text, { as: "h2", fontSize: "md", fontWeight: 600, color: colors.header[900], children: title })] }), onViewChange ? ((0, jsx_runtime_1.jsx)(react_2.Flex, { role: "group", "aria-label": text[view], gap: 1, children: VIEWS.map((v) => ((0, jsx_runtime_1.jsx)(Button_1.default, { label: text[v], size: "sm", variant: v === view ? "solid" : "outline", "aria-pressed": v === view, onClick: () => onViewChange(v) }, v))) })) : null] }), (0, jsx_runtime_1.jsx)(react_2.Box, { overflowX: "auto", children: (0, jsx_runtime_1.jsxs)(react_2.Box, { role: "grid", "aria-label": title, "aria-busy": isLoading || undefined, "data-view": view, minW: view === "day" ? undefined : "42rem", borderTop: "1px solid", borderLeft: "1px solid", borderColor: border, borderRadius: "lg", overflow: "hidden", children: [(0, jsx_runtime_1.jsx)(react_2.Grid, { role: "row", templateColumns: template, children: headerDays.map((i) => ((0, jsx_runtime_1.jsx)(react_2.Box, { role: "columnheader", "aria-label": weekdayLong[i], px: 2, py: 1, fontSize: "xs", fontWeight: 600, color: colors.textMuted, bg: colors.backgroundColor.main, borderRight: "1px solid", borderBottom: "1px solid", borderColor: border, children: weekdayShort[i] }, i))) }), weeks.map((week, weekIndex) => {
+                            const layout = (0, calendarMath_1.layoutWeek)(week, shownEvents, maxLanes);
+                            return ((0, jsx_runtime_1.jsx)(react_2.Grid, { role: "row", templateColumns: template, children: week.map((day, col) => renderCell(day, col, weekIndex, layout)) }, (0, calendarMath_1.dayKey)(week[0])));
+                        })] }) })] }));
+};
+exports.default = CalendarGrid;

package/dist/Components/CalendarGrid/CalendarGridProps.d.ts

@@ -0,0 +1,65 @@
+import type { ReactNode } from "react";
+import type { Tone } from "../../Theme/tokens/builders/tone";
+/** Which span the grid shows: a month of weeks, one week, or a single day. */
+export type CalendarGridView = "month" | "week" | "day";
+/** A date-granularity event; time of day is ignored. */
+export type CalendarEvent = {
+    /** Unique key; also the last tie-break when ordering events that start together. */
+    id: string;
+    /** First day covered; only the date part is read. */
+    start: Date;
+    /** Last day covered, inclusive. Omit for a single-day event; a value before `start` is swapped. */
+    end?: Date;
+    /** Chip text; also breaks ties when ordering events that start on the same day. */
+    label: string;
+    /** Status tint of the chip, same tones as Tag. Defaults to "neutral". */
+    tone?: Tone;
+    /** Renders the chip as a link; without it the chip is a button that fires `onEventClick`. */
+    href?: string;
+};
+/** Visible text and accessible names; every key falls back to English. */
+export type CalendarGridLabels = {
+    /** Toolbar button that moves the anchor to the current day. */
+    today: string;
+    /** Accessible name of the previous-period button. */
+    previous: string;
+    /** Accessible name of the next-period button. */
+    next: string;
+    /** View switcher entry for the month view. */
+    month: string;
+    /** View switcher entry for the week view. */
+    week: string;
+    /** View switcher entry for the day view. */
+    day: string;
+    /** Receives the number of hidden events, e.g. "+3 more". */
+    more: (count: number) => string;
+    /** Accessible name of the "more" button, e.g. "3 more events on Tuesday, 14 October 2026". */
+    moreLabel: (count: number, date: string) => string;
+    /** Follows the date in a day cell's accessible name, e.g. "3 events"; the cell's own content comes after it. */
+    eventCount: (count: number) => string;
+};
+/** Props for the month/week/day event grid; fully controlled through `view` and `date`. */
+export interface CalendarGridProps {
+    /** Span shown: a month of weeks, one week or one day. */
+    view: CalendarGridView;
+    /** Anchor date: any day inside the month, week or day being shown. */
+    date: Date;
+    /** Events to place; multi-day events span cells and long days collapse into "+N more". */
+    events: CalendarEvent[];
+    /** Called by the toolbar's view switcher and by a cell's "+N more" button (with "day"). */
+    onViewChange?: (view: CalendarGridView) => void;
+    /** Called when the anchor should move: toolbar, arrow keys leaving the visible range, Enter on a cell, "+N more". */
+    onDateChange?: (date: Date) => void;
+    /** Called when an event chip is activated; link chips still navigate to `href`. */
+    onEventClick?: (event: CalendarEvent) => void;
+    /** Replaces a cell's event chips (and the multi-day spanning) with your own content, under the day number. */
+    renderDayCell?: (date: Date, events: CalendarEvent[]) => ReactNode;
+    /** First column of the week; defaults to 0 (Sunday). */
+    weekStartsOn?: 0 | 1;
+    /** BCP 47 tag for month, weekday and date names via Intl; defaults to the runtime locale. */
+    locale?: string;
+    /** Keeps the grid's shape and swaps the events for skeleton bars; sets aria-busy. */
+    isLoading?: boolean;
+    /** Overrides the default English strings; unset keys keep their default. */
+    labels?: Partial<CalendarGridLabels>;
+}

package/dist/Components/CalendarGrid/CalendarGridProps.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/Components/CalendarGrid/calendarMath.d.ts

@@ -0,0 +1,62 @@
+export type CalendarView = "month" | "week" | "day";
+export type WeekStart = 0 | 1;
+export type SpanEvent = {
+    /** Unique key of the event. */
+    id: string;
+    /** First day covered; time of day is ignored. */
+    start: Date;
+    /** Last day covered, inclusive; omit for a single-day event. */
+    end?: Date;
+    /** Event text, used as a sort tie-break when laying out lanes. */
+    label: string;
+};
+export type WeekSegment<E extends SpanEvent> = {
+    /** The event this bar draws. */
+    event: E;
+    /** First column the bar covers, clamped to the week. */
+    startCol: number;
+    /** Last column the bar covers, clamped to the week. */
+    endCol: number;
+    /** Row index of the bar; lanes at or past `maxLanes` are counted in `hiddenByCol`, not drawn. */
+    lane: number;
+    /** True when the event began in an earlier week. */
+    continuesBefore: boolean;
+    /** True when the event runs into a later week. */
+    continuesAfter: boolean;
+};
+export type WeekLayout<E extends SpanEvent> = {
+    /** Every bar for the week, including those in hidden lanes. */
+    segments: WeekSegment<E>[];
+    /** Number of lanes to draw, capped at `maxLanes`. */
+    visibleLanes: number;
+    /** Per column, how many events fall in lanes that are not drawn. */
+    hiddenByCol: number[];
+};
+export declare const startOfDay: (d: Date) => Date;
+export declare const addDays: (d: Date, n: number) => Date;
+export declare const addMonths: (d: Date, n: number) => Date;
+export declare const isSameDay: (a: Date, b: Date) => boolean;
+export declare const dayKey: (d: Date) => string;
+export declare const isWeekend: (d: Date) => boolean;
+/** Whole calendar days from `a` to `b`, counted on date components so a DST day is still one day. */
+export declare const diffDays: (a: Date, b: Date) => number;
+export declare const startOfWeek: (d: Date, weekStartsOn: WeekStart) => Date;
+export declare const weekDays: (d: Date, weekStartsOn: WeekStart) => Date[];
+/** Whole weeks that cover the month of `d`, padded with the neighbouring months' days. */
+export declare const monthWeeks: (d: Date, weekStartsOn: WeekStart) => Date[][];
+export declare const visibleWeeks: (view: CalendarView, d: Date, weekStartsOn: WeekStart) => Date[][];
+export declare const shiftAnchor: (view: CalendarView, d: Date, direction: 1 | -1) => Date;
+export declare const eventRange: (e: Pick<SpanEvent, "start" | "end">) => {
+    start: Date;
+    end: Date;
+};
+export declare const eventsOnDay: <E extends SpanEvent>(events: readonly E[], day: Date) => E[];
+/** Lays events out in lanes across one week row; lanes past `maxLanes` are counted per column, not drawn. */
+export declare const layoutWeek: <E extends SpanEvent>(days: readonly Date[], events: readonly E[], maxLanes: number) => WeekLayout<E>;
+export type NavKey = "ArrowLeft" | "ArrowRight" | "ArrowUp" | "ArrowDown" | "Home" | "End" | "PageUp" | "PageDown";
+export declare const NAV_KEYS: readonly string[];
+export declare const isNavKey: (key: string) => key is NavKey;
+export declare const moveFocus: (view: CalendarView, d: Date, key: NavKey, weekStartsOn: WeekStart) => Date;
+export declare const weekdayLabels: (locale: string | undefined, weekStartsOn: WeekStart, style?: "short" | "long") => string[];
+export declare const formatTitle: (view: CalendarView, d: Date, locale: string | undefined, weekStartsOn: WeekStart) => string;
+export declare const formatFullDate: (d: Date, locale: string | undefined) => string;

package/dist/Components/CalendarGrid/calendarMath.js

@@ -0,0 +1,190 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.formatFullDate = exports.formatTitle = exports.weekdayLabels = exports.moveFocus = exports.isNavKey = exports.NAV_KEYS = exports.layoutWeek = exports.eventsOnDay = exports.eventRange = exports.shiftAnchor = exports.visibleWeeks = exports.monthWeeks = exports.weekDays = exports.startOfWeek = exports.diffDays = exports.isWeekend = exports.dayKey = exports.isSameDay = exports.addMonths = exports.addDays = exports.startOfDay = void 0;
+const MS_PER_DAY = 86400000;
+const startOfDay = (d) => new Date(d.getFullYear(), d.getMonth(), d.getDate());
+exports.startOfDay = startOfDay;
+const addDays = (d, n) => new Date(d.getFullYear(), d.getMonth(), d.getDate() + n);
+exports.addDays = addDays;
+const addMonths = (d, n) => {
+    const target = new Date(d.getFullYear(), d.getMonth() + n, 1);
+    const lastDay = new Date(target.getFullYear(), target.getMonth() + 1, 0).getDate();
+    return new Date(target.getFullYear(), target.getMonth(), Math.min(d.getDate(), lastDay));
+};
+exports.addMonths = addMonths;
+const isSameDay = (a, b) => a.getFullYear() === b.getFullYear() && a.getMonth() === b.getMonth() && a.getDate() === b.getDate();
+exports.isSameDay = isSameDay;
+const dayKey = (d) => `${String(d.getFullYear()).padStart(4, "0")}-${String(d.getMonth() + 1).padStart(2, "0")}-${String(d.getDate()).padStart(2, "0")}`;
+exports.dayKey = dayKey;
+const isWeekend = (d) => d.getDay() === 0 || d.getDay() === 6;
+exports.isWeekend = isWeekend;
+/** Whole calendar days from `a` to `b`, counted on date components so a DST day is still one day. */
+const diffDays = (a, b) => Math.round((Date.UTC(b.getFullYear(), b.getMonth(), b.getDate()) - Date.UTC(a.getFullYear(), a.getMonth(), a.getDate())) /
+    MS_PER_DAY);
+exports.diffDays = diffDays;
+const startOfWeek = (d, weekStartsOn) => (0, exports.addDays)(d, -((d.getDay() - weekStartsOn + 7) % 7));
+exports.startOfWeek = startOfWeek;
+const weekDays = (d, weekStartsOn) => {
+    const first = (0, exports.startOfWeek)(d, weekStartsOn);
+    return Array.from({ length: 7 }, (_, i) => (0, exports.addDays)(first, i));
+};
+exports.weekDays = weekDays;
+/** Whole weeks that cover the month of `d`, padded with the neighbouring months' days. */
+const monthWeeks = (d, weekStartsOn) => {
+    const first = new Date(d.getFullYear(), d.getMonth(), 1);
+    const last = new Date(d.getFullYear(), d.getMonth() + 1, 0);
+    const gridStart = (0, exports.startOfWeek)(first, weekStartsOn);
+    const weekCount = Math.ceil(((0, exports.diffDays)(gridStart, last) + 1) / 7);
+    return Array.from({ length: weekCount }, (_, w) => Array.from({ length: 7 }, (_, i) => (0, exports.addDays)(gridStart, w * 7 + i)));
+};
+exports.monthWeeks = monthWeeks;
+const visibleWeeks = (view, d, weekStartsOn) => {
+    if (view === "month")
+        return (0, exports.monthWeeks)(d, weekStartsOn);
+    if (view === "week")
+        return [(0, exports.weekDays)(d, weekStartsOn)];
+    return [[(0, exports.startOfDay)(d)]];
+};
+exports.visibleWeeks = visibleWeeks;
+const shiftAnchor = (view, d, direction) => {
+    if (view === "month")
+        return (0, exports.addMonths)(d, direction);
+    return (0, exports.addDays)(d, view === "week" ? 7 * direction : direction);
+};
+exports.shiftAnchor = shiftAnchor;
+const eventRange = (e) => {
+    const start = (0, exports.startOfDay)(e.start);
+    const end = e.end ? (0, exports.startOfDay)(e.end) : start;
+    return end < start ? { start: end, end: start } : { start, end };
+};
+exports.eventRange = eventRange;
+const eventsOnDay = (events, day) => {
+    const d = (0, exports.startOfDay)(day);
+    return events.filter((e) => {
+        const r = (0, exports.eventRange)(e);
+        return r.start <= d && d <= r.end;
+    });
+};
+exports.eventsOnDay = eventsOnDay;
+/** Lays events out in lanes across one week row; lanes past `maxLanes` are counted per column, not drawn. */
+const layoutWeek = (days, events, maxLanes) => {
+    const first = days[0];
+    const lastCol = days.length - 1;
+    const candidates = events
+        .map((event) => {
+        const r = (0, exports.eventRange)(event);
+        const rawStart = (0, exports.diffDays)(first, r.start);
+        const rawEnd = (0, exports.diffDays)(first, r.end);
+        if (rawEnd < 0 || rawStart > lastCol)
+            return null;
+        return {
+            event,
+            rawStart,
+            length: rawEnd - rawStart,
+            startCol: Math.max(0, rawStart),
+            endCol: Math.min(lastCol, rawEnd),
+            continuesBefore: rawStart < 0,
+            continuesAfter: rawEnd > lastCol,
+        };
+    })
+        .filter((c) => c !== null)
+        .sort((a, b) => a.rawStart - b.rawStart ||
+        b.length - a.length ||
+        a.event.label.localeCompare(b.event.label) ||
+        a.event.id.localeCompare(b.event.id));
+    const occupied = [];
+    const segments = [];
+    for (const c of candidates) {
+        let lane = occupied.findIndex((row) => row.slice(c.startCol, c.endCol + 1).every((taken) => !taken));
+        if (lane === -1) {
+            lane = occupied.length;
+            occupied.push(new Array(days.length).fill(false));
+        }
+        for (let col = c.startCol; col <= c.endCol; col += 1)
+            occupied[lane][col] = true;
+        segments.push({
+            event: c.event,
+            startCol: c.startCol,
+            endCol: c.endCol,
+            lane,
+            continuesBefore: c.continuesBefore,
+            continuesAfter: c.continuesAfter,
+        });
+    }
+    const hiddenByCol = new Array(days.length).fill(0);
+    for (const s of segments) {
+        if (s.lane < maxLanes)
+            continue;
+        for (let col = s.startCol; col <= s.endCol; col += 1)
+            hiddenByCol[col] += 1;
+    }
+    return { segments, visibleLanes: Math.min(occupied.length, maxLanes), hiddenByCol };
+};
+exports.layoutWeek = layoutWeek;
+exports.NAV_KEYS = [
+    "ArrowLeft",
+    "ArrowRight",
+    "ArrowUp",
+    "ArrowDown",
+    "Home",
+    "End",
+    "PageUp",
+    "PageDown",
+];
+const isNavKey = (key) => exports.NAV_KEYS.includes(key);
+exports.isNavKey = isNavKey;
+const moveFocus = (view, d, key, weekStartsOn) => {
+    const columns = view === "day" ? 1 : 7;
+    switch (key) {
+        case "ArrowLeft":
+            return (0, exports.addDays)(d, -1);
+        case "ArrowRight":
+            return (0, exports.addDays)(d, 1);
+        case "ArrowUp":
+            return (0, exports.addDays)(d, -columns);
+        case "ArrowDown":
+            return (0, exports.addDays)(d, columns);
+        case "Home":
+            return view === "day" ? d : (0, exports.startOfWeek)(d, weekStartsOn);
+        case "End":
+            return view === "day" ? d : (0, exports.addDays)((0, exports.startOfWeek)(d, weekStartsOn), 6);
+        case "PageUp":
+            return (0, exports.shiftAnchor)(view, d, -1);
+        default:
+            return (0, exports.shiftAnchor)(view, d, 1);
+    }
+};
+exports.moveFocus = moveFocus;
+const probe = (weekday) => new Date(2024, 0, 7 + weekday);
+const dateFormatters = new Map();
+const dateFormatter = (locale, options) => {
+    const key = JSON.stringify([locale, options]);
+    let formatter = dateFormatters.get(key);
+    if (!formatter) {
+        formatter = new Intl.DateTimeFormat(locale, options);
+        dateFormatters.set(key, formatter);
+    }
+    return formatter;
+};
+const FULL_DATE = { weekday: "long", day: "numeric", month: "long", year: "numeric" };
+const MONTH_TITLE = { month: "long", year: "numeric" };
+const WEEK_RANGE = { day: "numeric", month: "short", year: "numeric" };
+const weekdayLabels = (locale, weekStartsOn, style = "short") => {
+    const fmt = dateFormatter(locale, { weekday: style });
+    return Array.from({ length: 7 }, (_, i) => fmt.format(probe((i + weekStartsOn) % 7)));
+};
+exports.weekdayLabels = weekdayLabels;
+const formatTitle = (view, d, locale, weekStartsOn) => {
+    if (view === "month")
+        return dateFormatter(locale, MONTH_TITLE).format(d);
+    if (view === "day")
+        return dateFormatter(locale, FULL_DATE).format(d);
+    const days = (0, exports.weekDays)(d, weekStartsOn);
+    const fmt = dateFormatter(locale, WEEK_RANGE);
+    return typeof fmt.formatRange === "function"
+        ? fmt.formatRange(days[0], days[6])
+        : `${fmt.format(days[0])} - ${fmt.format(days[6])}`;
+};
+exports.formatTitle = formatTitle;
+const formatFullDate = (d, locale) => dateFormatter(locale, FULL_DATE).format(d);
+exports.formatFullDate = formatFullDate;

package/dist/Components/Card/Card.d.ts

@@ -1,2 +1,21 @@
-import { CardProps } from "./CardProps";
-export default function Card({ maxW, align, variant, direction, justify, children, size, color, overflow, sx, }: CardProps): import("react/jsx-runtime").JSX.Element;
+import { CardPadding } from "./CardProps";
+/** Themed card; `header` and `footer` render outside the body, `padding` sets density. */
+declare const Card: import("react").ForwardRefExoticComponent<Omit<import("@chakra-ui/react").CardProps, "color" | "colorScheme" | "direction" | "padding" | "size" | "justify" | "children" | "variant" | "align"> & {
+    dividercolor?: "gray" | "red" | "orange" | "yellow" | "green" | "teal" | "blue" | "cyan" | "purple" | "pink" | "whiteAlpha" | "blackAlpha";
+    dividersize?: string;
+    dividervariant?: "solid" | "dashed";
+} & {
+    header?: React.ReactNode;
+    footer?: React.ReactNode;
+    children: React.ReactNode;
+    variant?: "elevated" | "outline" | "filled" | "unstyled";
+    size?: "sm" | "md" | "lg";
+    colorScheme?: "gray" | "red" | "orange" | "yellow" | "green" | "teal" | "blue" | "cyan" | "purple" | "pink" | "whiteAlpha" | "blackAlpha";
+    color?: "gray" | "red" | "orange" | "yellow" | "green" | "teal" | "blue" | "cyan" | "purple" | "pink" | "whiteAlpha" | "blackAlpha";
+    direction?: import("@chakra-ui/react").ResponsiveValue<"row" | "column" | "row-reverse" | "column-reverse">;
+    align?: import("@chakra-ui/react").CardBodyProps["alignItems"];
+    justify?: import("@chakra-ui/react").CardBodyProps["justifyContent"];
+    padding?: CardPadding;
+    bodyProps?: import("@chakra-ui/react").CardBodyProps;
+} & import("react").RefAttributes<HTMLDivElement>>;
+export default Card;

package/dist/Components/Card/Card.js

@@ -1,8 +1,24 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.default = Card;
 const jsx_runtime_1 = require("react/jsx-runtime");
-const react_1 = require("@chakra-ui/react");
-function Card({ maxW, align, variant, direction, justify, children, size, color, overflow, sx, }) {
-    return ((0, jsx_runtime_1.jsx)(react_1.Card, { maxW: maxW, align: align, variant: variant, direction: direction, justify: justify, size: size, overflow: overflow, colorScheme: color, p: 4, sx: sx, children: children }));
-}
+const react_1 = require("react");
+const react_2 = require("@chakra-ui/react");
+const HEADER_PADDING_WHEN_FLUSH = "0.75rem";
+const PADDING_VALUES = {
+    none: "0",
+    "2xs": "0.375rem",
+    xs: "0.75rem",
+    sm: "0.75rem 1rem",
+    md: "1rem 1.25rem",
+    lg: "1.25rem 1.5rem",
+};
+/** Themed card; `header` and `footer` render outside the body, `padding` sets density. */
+const Card = (0, react_1.forwardRef)(function Card({ header, footer, children, color, colorScheme, direction = "column", align, justify, bodyProps, padding, ...rest }, ref) {
+    const cardProps = { ...rest };
+    delete cardProps.dividercolor;
+    delete cardProps.dividersize;
+    delete cardProps.dividervariant;
+    const sx = padding ? { "--card-padding": PADDING_VALUES[padding], ...cardProps.sx } : cardProps.sx;
+    return ((0, jsx_runtime_1.jsxs)(react_2.Card, { ref: ref, colorScheme: colorScheme !== null && colorScheme !== void 0 ? colorScheme : color, ...cardProps, sx: sx, children: [header && ((0, jsx_runtime_1.jsx)(react_2.CardHeader, { sx: padding === "none" ? { "--card-padding": HEADER_PADDING_WHEN_FLUSH } : undefined, children: header })), (0, jsx_runtime_1.jsx)(react_2.CardBody, { display: "flex", flexDirection: direction, alignItems: align, justifyContent: justify, ...bodyProps, children: children }), footer && (0, jsx_runtime_1.jsx)(react_2.CardFooter, { children: footer })] }));
+});
+exports.default = Card;

package/dist/Components/Card/CardProps.d.ts

@@ -1,12 +1,41 @@
-import { CardProps as ChakraCardProps } from "@chakra-ui/react";
-export type CardProps = Pick<ChakraCardProps, "direction" | "maxW" | "align" | "justify" | "overflow" | "sx"> & {
+import { CardProps as ChakraCardProps, CardBodyProps, ResponsiveValue } from "@chakra-ui/react";
+type CardColorScheme = "whiteAlpha" | "blackAlpha" | "gray" | "red" | "orange" | "yellow" | "green" | "teal" | "blue" | "cyan" | "purple" | "pink";
+/** @deprecated Never rendered — Card draws no divider; parts are separated by theme padding. */
+type DeadDividerProps = {
+    /** Ignored; Card draws no divider. */
+    dividercolor?: CardColorScheme;
+    /** Ignored; Card draws no divider. */
+    dividersize?: string;
+    /** Ignored; Card draws no divider. */
+    dividervariant?: "solid" | "dashed";
+};
+/** Padding steps: "none" flush, "2xs" 0.375rem, "xs" 0.75rem all round, "sm" / "md" / "lg" match `size`. */
+export type CardPadding = "none" | "2xs" | "xs" | "sm" | "md" | "lg";
+/** Themed card surface (outline rule or borderless elevated) with optional header/footer slots; direction/align/justify apply to the body. */
+export type CardProps = Omit<ChakraCardProps, "children" | "variant" | "size" | "color" | "colorScheme" | "direction" | "align" | "justify" | "padding"> & DeadDividerProps & {
+    /** Rendered in CardHeader (semibold header ink) only when truthy. */
     header?: React.ReactNode;
+    /** Rendered in CardFooter only when truthy. */
     footer?: React.ReactNode;
+    /** Body content, rendered inside the flex body wrapper. */
     children: React.ReactNode;
+    /** "elevated" (default): borderless, lifted by `shadows.card`. "outline": 1px rule, no shadow, for tables and row lists. */
     variant?: "elevated" | "outline" | "filled" | "unstyled";
+    /** Padding scale for header/body/footer; defaults to "md". */
     size?: "sm" | "md" | "lg";
-    color?: "whiteAlpha" | "blackAlpha" | "gray" | "red" | "orange" | "yellow" | "green" | "teal" | "blue" | "cyan" | "purple" | "pink";
-    dividercolor?: "whiteAlpha" | "blackAlpha" | "gray" | "red" | "orange" | "yellow" | "green" | "teal" | "blue" | "cyan" | "purple" | "pink";
-    dividersize?: string;
-    dividervariant?: "solid" | "dashed";
+    /** @deprecated No visual effect — neither Chakra's nor this theme's Card styles read a colour scheme. */
+    colorScheme?: CardColorScheme;
+    /** @deprecated Alias of the no-op `colorScheme`, and not a CSS color. */
+    color?: CardColorScheme;
+    /** Body flex direction; defaults to "column". */
+    direction?: ResponsiveValue<"row" | "column" | "row-reverse" | "column-reverse">;
+    /** Body alignItems; `bodyProps` wins if it sets the same thing. */
+    align?: CardBodyProps["alignItems"];
+    /** Body justifyContent; `bodyProps` wins if it sets the same thing. */
+    justify?: CardBodyProps["justifyContent"];
+    /** Overrides `size`'s padding for header, body and footer; "none" is flush (a header keeps "xs"), "2xs" is 6px. */
+    padding?: CardPadding;
+    /** Props for the body wrapper, e.g. `p={0}` for edge-to-edge media. */
+    bodyProps?: CardBodyProps;
 };
+export {};

package/dist/Components/Card/PaymentCard/PaymentCard.d.ts

@@ -1,3 +1,4 @@
 import { PaymentCardProps } from "./PaymentCardProps";
+/** Subscription plan card with price, feature list and a call-to-action; badge and accent follow active, upgrade and popular state. */
 declare const PaymentCard: ({ plan, isActive, isNextUpgrade, billingCycle, onSelect, onHover, buttonLoading, isLoading, isRenewal, }: PaymentCardProps) => import("react/jsx-runtime").JSX.Element;
 export default PaymentCard;