@react-x11/components 0.1.0 → 0.2.1

package/dist/calendar/DatePicker.d.ts

@@ -0,0 +1,52 @@
+import type { ReactElement } from 'react';
+import type { Style } from 'react-x11/style';
+import type { CalendarProps } from './Calendar.js';
+type PickerOwnProps = {
+    /** What the trigger shows. Defaults to the locale's medium date, and
+     *  `Intl`'s own range format when there are two of them. */
+    format?: (value: unknown) => string | null;
+    /** Shown when nothing is picked yet. */
+    placeholder?: string;
+    disabled?: boolean;
+    style?: Style | Style[];
+};
+/**
+ * `Omit` over a union collapses it into one member, which would cost the
+ * picker the thing that makes it pleasant to use: `mode` discriminating
+ * single from range, and with it the type of the `onChange` parameter. So the
+ * omit is distributed across the union instead, and `<DatePicker mode="range"
+ * onChange={(ev) => …}>` still knows `ev.value` is a `DateRange`.
+ */
+type DistributiveOmit<T, K extends PropertyKey> = T extends unknown ? Omit<T, K> : never;
+export type DatePickerProps = DistributiveOmit<CalendarProps, 'focusable' | 'focusVisible' | 'ref' | 'style'> & PickerOwnProps;
+/**
+ * <DatePicker value onChange …boxProps> — a `<Calendar>` on a `<popup>`, hung
+ * off a field that shows the current date.
+ *
+ *   <DatePicker value={day} onChange={(ev) => setDay(ev.value)} />
+ *   <DatePicker mode="range" value={span} onChange={…} max="2026-12-31" />
+ *
+ * Every calendar prop passes straight through — `mode`, `min`/`max`,
+ * `isDateBlocked`, `spanBlocked`, `dayContent`, `locale`, `weekStartsOn` — and
+ * the value has the same shape here as there: a `'YYYY-MM-DD'` day, or
+ * `{ start, end }` in range mode.
+ *
+ * The calendar opens on the **press**, not the release, for the reason
+ * `Select`'s menu does: a control whose whole purpose is to be looked at has
+ * nothing to gain from waiting out the length of the click. It closes when the
+ * value is complete — the day in single mode, the second end of a range — on
+ * Escape, on a second press of the trigger, and when the window loses focus.
+ *
+ * The popup is override-redirect and never takes focus, so the **trigger keeps
+ * the keyboard** and hands the calendar its keys: Down/Up/Enter/Space open it,
+ * and once it is open everything the grid understands (arrows, Home/End,
+ * PageUp/PageDown, Enter, Space) goes there. Escape and Tab stay here, which
+ * is why `handleKey` reports whether it took the key.
+ *
+ * `format(value)` is the seam for the label: the default is the locale's
+ * medium date, and `Intl`'s own range format when there are two of them, which
+ * collapses the parts the ends share ("7 – 12 Aug 2026").
+ */
+export declare function DatePicker(props: DatePickerProps): ReactElement;
+export {};
+//# sourceMappingURL=DatePicker.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"DatePicker.d.ts","sourceRoot":"","sources":["../../src/calendar/DatePicker.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,OAAO,CAAC;AAE1C,OAAO,KAAK,EAAE,KAAK,EAAmB,MAAM,iBAAiB,CAAC;AAc9D,OAAO,KAAK,EAEV,aAAa,EAGd,MAAM,eAAe,CAAC;AA0EvB,KAAK,cAAc,GAAG;IACpB;gEAC4D;IAC5D,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,MAAM,GAAG,IAAI,CAAC;IAC3C,wCAAwC;IACxC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,KAAK,CAAC,EAAE,KAAK,GAAG,KAAK,EAAE,CAAC;CACzB,CAAC;AAEF;;;;;;GAMG;AACH,KAAK,gBAAgB,CAAC,CAAC,EAAE,CAAC,SAAS,WAAW,IAAI,CAAC,SAAS,OAAO,GAC/D,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,GACV,KAAK,CAAC;AAEV,MAAM,MAAM,eAAe,GAAG,gBAAgB,CAC5C,aAAa,EACb,WAAW,GAAG,cAAc,GAAG,KAAK,GAAG,OAAO,CAC/C,GACC,cAAc,CAAC;AAEjB;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,eAAe,GAAG,YAAY,CAsN/D"}

package/dist/calendar/DatePicker.js

@@ -0,0 +1,257 @@
+// <DatePicker> — a <Calendar> on a <popup>, hung off a field that shows the
+// current date. Ported from react-x11's `src/components/DatePicker.js`.
+import React, { useRef, useState } from 'react';
+import { createStyles } from 'react-x11/style';
+import { useAnchor, useAnchorTracking, useTheme } from 'react-x11';
+import { XK_DOWN, XK_ESCAPE, XK_RETURN, XK_UP } from 'react-x11/keysyms';
+import { hx } from '../internal/hx.js';
+import { useDismissOnWindowBlur } from '../internal/widget.js';
+import { CALENDAR_HEIGHT, CALENDAR_WIDTH, Calendar } from './Calendar.js';
+import { formatDay, formatDayRange, toDay } from './dates.js';
+// A hairline round the sheet, as the menus and `Select` use: this border is
+// where the popup meets the desktop, not a control's outline, so a theme that
+// draws 2px borders on its buttons does not get a 2px frame here.
+const SHEET_BORDER = 1;
+const s = createStyles({
+    trigger: {
+        flexDirection: 'row',
+        alignItems: 'center',
+        gap: 8,
+        padding: 8,
+        paddingLeft: 10,
+        paddingRight: 10,
+        cursor: 'pointer',
+    },
+    label: { flexGrow: 1 },
+    icon: { width: 14, height: 14, flexShrink: 0 },
+    sheet: { flexGrow: 1, flexShrink: 1, borderWidth: SHEET_BORDER },
+});
+/** A wall calendar, 14×14: the page, its two hangers and the ruled week. */
+function CalendarGlyph({ color }) {
+    return hx('canvas', {
+        style: s.icon,
+        onDraw: (ctx, { width, height }) => {
+            ctx.strokeStyle = color;
+            ctx.lineWidth = 1;
+            ctx.strokeRect(0.5, 2.5, width - 1, height - 3);
+            ctx.beginPath();
+            ctx.moveTo(0.5, 6.5);
+            ctx.lineTo(width - 0.5, 6.5);
+            ctx.moveTo(4.5, 0.5);
+            ctx.lineTo(4.5, 3.5);
+            ctx.moveTo(width - 4.5, 0.5);
+            ctx.lineTo(width - 4.5, 3.5);
+            ctx.stroke();
+        },
+    });
+}
+/** What the trigger says, when the app has not said it itself. */
+function defaultFormat(mode, value, locale) {
+    if (mode === 'range') {
+        const range = (value ?? {});
+        const start = toDay(range.start);
+        const end = toDay(range.end);
+        if (!start)
+            return null;
+        if (!end)
+            return `${formatDay(start, locale)} → …`;
+        return formatDayRange(start, end, locale);
+    }
+    const day = toDay(value);
+    return day ? formatDay(day, locale) : null;
+}
+/**
+ * <DatePicker value onChange …boxProps> — a `<Calendar>` on a `<popup>`, hung
+ * off a field that shows the current date.
+ *
+ *   <DatePicker value={day} onChange={(ev) => setDay(ev.value)} />
+ *   <DatePicker mode="range" value={span} onChange={…} max="2026-12-31" />
+ *
+ * Every calendar prop passes straight through — `mode`, `min`/`max`,
+ * `isDateBlocked`, `spanBlocked`, `dayContent`, `locale`, `weekStartsOn` — and
+ * the value has the same shape here as there: a `'YYYY-MM-DD'` day, or
+ * `{ start, end }` in range mode.
+ *
+ * The calendar opens on the **press**, not the release, for the reason
+ * `Select`'s menu does: a control whose whole purpose is to be looked at has
+ * nothing to gain from waiting out the length of the click. It closes when the
+ * value is complete — the day in single mode, the second end of a range — on
+ * Escape, on a second press of the trigger, and when the window loses focus.
+ *
+ * The popup is override-redirect and never takes focus, so the **trigger keeps
+ * the keyboard** and hands the calendar its keys: Down/Up/Enter/Space open it,
+ * and once it is open everything the grid understands (arrows, Home/End,
+ * PageUp/PageDown, Enter, Space) goes there. Escape and Tab stay here, which
+ * is why `handleKey` reports whether it took the key.
+ *
+ * `format(value)` is the seam for the label: the default is the locale's
+ * medium date, and `Intl`'s own range format when there are two of them, which
+ * collapses the parts the ends share ("7 – 12 Aug 2026").
+ */
+export function DatePicker(props) {
+    const { mode = 'single', value, defaultValue, onChange, name, month, defaultMonth, onMonthChange, min, max, isDateBlocked, spanBlocked, dayContent, locale, weekStartsOn, format, placeholder, disabled = false, style, ...boxProps } = props;
+    const theme = useTheme();
+    const [open, setOpen] = useState(false);
+    // `AnchorRect` rather than `Rect`: `useAnchorTracking` reports the side the
+    // sheet actually landed on (react-x11#280), and its `setRect` is typed to
+    // hand that back. Nothing here reads `placement` — the sheet has no arrow
+    // to aim — but the state has to be able to hold it.
+    const [anchor, setAnchor] = useState(null);
+    const [focused, setFocused] = useState(false);
+    const [ownValue, setOwnValue] = useState(defaultValue ?? null);
+    const triggerRef = useRef(null);
+    const calendarRef = useRef(null);
+    const measureAnchor = useAnchor(triggerRef);
+    const current = value === undefined ? ownValue : value;
+    const width = CALENDAR_WIDTH + SHEET_BORDER * 2;
+    const height = CALENDAR_HEIGHT + SHEET_BORDER * 2;
+    const anchorOptions = () => ({
+        placement: 'bottom',
+        width,
+        height,
+    });
+    const close = () => setOpen(false);
+    const openCalendar = () => {
+        const rect = measureAnchor(anchorOptions());
+        if (!rect)
+            return;
+        setAnchor(rect);
+        setOpen(true);
+    };
+    const toggle = () => (open ? close() : openCalendar());
+    // the same two the other popups take: keep the sheet under the trigger while
+    // anything moves it, and shut it when the window itself loses focus (the
+    // trigger keeps its focus, so its own onBlur never hears about that)
+    useAnchorTracking(triggerRef, open, anchorOptions, setAnchor, close);
+    useDismissOnWindowBlur(triggerRef, open, close);
+    const handleChange = (ev) => {
+        if (value === undefined)
+            setOwnValue(ev.value);
+        onChange?.(ev);
+        // a half-picked range is the one selection that is not finished, and the
+        // calendar has to stay up for the other end of it
+        if (mode !== 'range' || ev.value?.end)
+            close();
+    };
+    const onKeyDown = (ev) => {
+        if (ev.keysym === XK_ESCAPE) {
+            if (open)
+                close();
+            return;
+        }
+        if (open && calendarRef.current?.handleKey(ev))
+            return;
+        if (ev.keysym === XK_DOWN ||
+            ev.keysym === XK_UP ||
+            ev.keysym === XK_RETURN ||
+            ev.codepoint === 32) {
+            if (!open)
+                openCalendar();
+        }
+    };
+    const label = format ? format(current) : defaultFormat(mode, current, locale);
+    const empty = label == null || label === '';
+    const text = empty
+        ? (placeholder ?? (mode === 'range' ? 'Pick dates…' : 'Pick a date…'))
+        : label;
+    return hx('box', {
+        theme,
+        role: 'combobox',
+        'aria-expanded': Boolean(open),
+        'aria-haspopup': 'dialog',
+        disabled: disabled || undefined,
+        ref: triggerRef,
+        focusable: !disabled,
+        onMouseDown: disabled ? undefined : toggle,
+        onFocus: () => setFocused(true),
+        onBlur: () => {
+            setFocused(false);
+            close();
+        },
+        onKeyDown: disabled ? undefined : onKeyDown,
+        ...boxProps,
+        style: [
+            s.trigger,
+            {
+                cursor: disabled ? 'default' : 'pointer',
+                borderWidth: theme.borderWidth,
+                borderRadius: theme.radius,
+                borderColor: focused || open ? theme.borderFocus : theme.border,
+                backgroundColor: disabled ? theme.surfaceHover : theme.background,
+            },
+            // hover and press say "this opens", so they belong to the trigger
+            // while it is shut and are simply not declared once the calendar is
+            // down — a state block always outranks the base style, so the only
+            // way for the open look to win is for nothing to be competing
+            !disabled &&
+                !open && {
+                ':hover': { backgroundColor: theme.surfaceHover },
+                ':active': { backgroundColor: theme.surfaceActive },
+            },
+            style,
+        ],
+    }, hx('text', {
+        style: [
+            s.label,
+            { color: disabled || empty ? theme.textMuted : theme.text },
+        ],
+    }, text), React.createElement(CalendarGlyph, {
+        color: disabled ? theme.border : theme.textMuted,
+    }), open &&
+        anchor &&
+        hx('popup', {
+            theme,
+            x: anchor.x,
+            y: anchor.y,
+            width,
+            height,
+            grab: true,
+            onDismiss: close,
+            // ARGB where the display has it, so the corners the sheet gives up
+            // are the desktop rather than a colour. The window paints nothing
+            // itself when it can be seen through — the box below is the whole
+            // of the sheet, and a square fill under it would put the corners
+            // straight back.
+            transparent: true,
+            style: {
+                backgroundColor: theme.background,
+                '@supports transparency': { backgroundColor: 'transparent' },
+            },
+        }, hx('box', {
+            style: [
+                s.sheet,
+                {
+                    borderColor: theme.border,
+                    backgroundColor: theme.background,
+                    '@supports transparency': { borderRadius: theme.radiusPopup },
+                },
+            ],
+        }, React.createElement(Calendar, {
+            ref: calendarRef,
+            mode,
+            value: current,
+            onChange: handleChange,
+            name,
+            month,
+            defaultMonth,
+            onMonthChange,
+            min,
+            max,
+            isDateBlocked,
+            spanBlocked,
+            dayContent,
+            locale,
+            weekStartsOn,
+            // The trigger owns the keyboard: the popup is override-redirect
+            // and never takes focus, so a focusable grid inside it would take
+            // focus on the press instead — blurring the trigger, whose onBlur
+            // closes the sheet, unmounting the day under the pointer before
+            // the release could turn into a click.
+            focusable: false,
+            // …and because it does not hold the focus, it would not draw the
+            // day cursor either, leaving the arrow keys moving something
+            // invisible.
+            focusVisible: true,
+        }))));
+}
+//# sourceMappingURL=DatePicker.js.map

package/dist/calendar/DatePicker.js.map

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

package/dist/calendar/dates.d.ts

@@ -0,0 +1,90 @@
+/** A calendar day, `'YYYY-MM-DD'`. */
+export type CalendarDay = string;
+/** A calendar month, `'YYYY-MM'`. */
+export type CalendarMonth = string;
+/** What every day-shaped prop accepts. */
+export type DayInput = CalendarDay | Date | null | undefined;
+/** The parts of a day, so a caller does not have to parse the string. */
+export interface DayParts {
+    year: number;
+    /** 1-based, unlike `Date`'s. */
+    month: number;
+    day: number;
+    /** `0`-`6` from Sunday, as `Date#getDay()` counts. */
+    weekday: number;
+    date: Date;
+}
+/**
+ * A day key from a `'YYYY-MM-DD'` string, a `Date`, or `null`/`undefined`
+ * (which is "no day", and comes back as `null`).
+ *
+ * Throws on anything else, and on a string that is not a real date —
+ * `'2026-02-30'` is a typo, not a day, and silently sliding it to March 2nd
+ * the way `new Date()` does is how a booking ends up a day out. The message
+ * names what arrived, because the value in a props object is usually miles
+ * from the line that built it.
+ */
+export declare function toDay(value: DayInput): CalendarDay | null;
+/** `'YYYY-MM'` from the same set of inputs, for the *visible month* props. */
+export declare function toMonth(value: DayInput): CalendarMonth | null;
+/** Today, on this machine, in local time — which is the day the user's wall
+ *  calendar is showing. */
+export declare function today(): CalendarDay;
+/** The day as a UTC-midnight `Date`, for `Intl` and for arithmetic. */
+export declare function dayDate(day: CalendarDay): Date;
+/**
+ * `{ year, month, day, weekday, date }` — the parts a caller needs to decide
+ * something about a day without parsing the string itself. `weekday` is
+ * `0`-`6` from Sunday, as `Date#getDay()` counts, so blocking weekends is
+ * `weekday === 0 || weekday === 6`. `month` is 1-based, unlike `Date`'s.
+ */
+export declare function dayParts(day: CalendarDay): DayParts;
+export declare function addDays(day: CalendarDay, n: number): CalendarDay;
+/** `'2026-08'` — the month a day is in. */
+export declare function monthOf(day: CalendarDay): CalendarMonth;
+/** The first day of a `'YYYY-MM'`. */
+export declare function firstOfMonth(month: CalendarMonth): CalendarDay;
+/**
+ * `n` months on from a `'YYYY-MM'`. Months, unlike days, are not all the same
+ * length, so this deliberately works on the month key and never on a day: the
+ * "same date next month" question (Jan 31 → Feb 31?) has no good answer and
+ * nothing here asks it.
+ */
+export declare function addMonths(month: CalendarMonth, n: number): CalendarMonth;
+/** `day` held inside `[min, max]`; either bound may be null. */
+export declare function clampDay(day: CalendarDay, min: CalendarDay | null, max: CalendarDay | null): CalendarDay;
+/**
+ * The grid a month is drawn on: **six weeks of seven days**, always, starting
+ * on `weekStartsOn` and running through whatever days of the neighbouring
+ * months it takes to fill the corners.
+ *
+ * Six rows even when five would do (and a 28-day February starting on the
+ * first day of the week needs only four) because the alternative is a picker
+ * whose popup changes height as you page through it, moving the very buttons
+ * the pointer is aiming at.
+ */
+export declare function monthGrid(month: CalendarMonth, weekStartsOn?: number): CalendarDay[][];
+/**
+ * Which day the week starts on for a locale: `0` Sunday … `6` Saturday.
+ *
+ * The runtime knows this — CLDR carries it — but only through
+ * `Intl.Locale#getWeekInfo`, which is recent enough that a small-ICU build or
+ * an older V8 has neither it nor the `weekInfo` property it was proposed as.
+ * So it is feature-detected, and what is left when it is missing is **Monday**:
+ * ISO 8601's answer, and the one most of the world uses.
+ */
+export declare function localeWeekStart(locale?: string): number;
+/** `['Mon', 'Tue', …]` in the locale, rotated to start on `weekStartsOn`. */
+export declare function weekdayLabels(locale?: string, weekStartsOn?: number): string[];
+/** `'August 2026'` in the locale. */
+export declare function formatMonth(month: CalendarMonth, locale?: string): string;
+/** `'7 Aug 2026'` in the locale — what a picker's trigger shows. */
+export declare function formatDay(day: CalendarDay, locale?: string, options?: Intl.DateTimeFormatOptions): string;
+/**
+ * `'7 – 12 Aug 2026'`: the locale's own way of writing a span, which collapses
+ * the parts the two ends share. `formatRange` is ES2021 and universal in the
+ * Node versions this package supports, but a small-ICU build can still throw,
+ * so a plain "a – b" is kept behind it.
+ */
+export declare function formatDayRange(start: CalendarDay, end: CalendarDay, locale?: string, options?: Intl.DateTimeFormatOptions): string;
+//# sourceMappingURL=dates.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"dates.d.ts","sourceRoot":"","sources":["../../src/calendar/dates.ts"],"names":[],"mappings":"AA8BA,sCAAsC;AACtC,MAAM,MAAM,WAAW,GAAG,MAAM,CAAC;AAEjC,qCAAqC;AACrC,MAAM,MAAM,aAAa,GAAG,MAAM,CAAC;AAEnC,0CAA0C;AAC1C,MAAM,MAAM,QAAQ,GAAG,WAAW,GAAG,IAAI,GAAG,IAAI,GAAG,SAAS,CAAC;AAE7D,yEAAyE;AACzE,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,gCAAgC;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,sDAAsD;IACtD,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,IAAI,CAAC;CACZ;AAaD;;;;;;;;;GASG;AACH,wBAAgB,KAAK,CAAC,KAAK,EAAE,QAAQ,GAAG,WAAW,GAAG,IAAI,CAsCzD;AAED,8EAA8E;AAC9E,wBAAgB,OAAO,CAAC,KAAK,EAAE,QAAQ,GAAG,aAAa,GAAG,IAAI,CAK7D;AAED;2BAC2B;AAC3B,wBAAgB,KAAK,IAAI,WAAW,CAGnC;AAED,uEAAuE;AACvE,wBAAgB,OAAO,CAAC,GAAG,EAAE,WAAW,GAAG,IAAI,CAG9C;AAED;;;;;GAKG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,WAAW,GAAG,QAAQ,CASnD;AAED,wBAAgB,OAAO,CAAC,GAAG,EAAE,WAAW,EAAE,CAAC,EAAE,MAAM,GAAG,WAAW,CAIhE;AAED,2CAA2C;AAC3C,wBAAgB,OAAO,CAAC,GAAG,EAAE,WAAW,GAAG,aAAa,CAEvD;AAED,sCAAsC;AACtC,wBAAgB,YAAY,CAAC,KAAK,EAAE,aAAa,GAAG,WAAW,CAE9D;AAED;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,aAAa,EAAE,CAAC,EAAE,MAAM,GAAG,aAAa,CAIxE;AAED,gEAAgE;AAChE,wBAAgB,QAAQ,CACtB,GAAG,EAAE,WAAW,EAChB,GAAG,EAAE,WAAW,GAAG,IAAI,EACvB,GAAG,EAAE,WAAW,GAAG,IAAI,GACtB,WAAW,CAIb;AAED;;;;;;;;;GASG;AACH,wBAAgB,SAAS,CACvB,KAAK,EAAE,aAAa,EACpB,YAAY,SAAI,GACf,WAAW,EAAE,EAAE,CAWjB;AAqBD;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAiBvD;AAED,6EAA6E;AAC7E,wBAAgB,aAAa,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,YAAY,SAAI,GAAG,MAAM,EAAE,CAMzE;AAED,qCAAqC;AACrC,wBAAgB,WAAW,CAAC,KAAK,EAAE,aAAa,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAIzE;AAED,oEAAoE;AACpE,wBAAgB,SAAS,CACvB,GAAG,EAAE,WAAW,EAChB,MAAM,CAAC,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,IAAI,CAAC,qBAAqB,GACnC,MAAM,CAIR;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAC5B,KAAK,EAAE,WAAW,EAClB,GAAG,EAAE,WAAW,EAChB,MAAM,CAAC,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,IAAI,CAAC,qBAAqB,GACnC,MAAM,CAOR"}

package/dist/calendar/dates.js

@@ -0,0 +1,236 @@
+// Calendar days, and the arithmetic the date widgets do on them.
+//
+// Vendored from react-x11's `src/components/dates.js` when `<Calendar>` moved
+// out here. It is pure — no renderer, no ntk, no React — which is what made
+// the move cheap, and core is expected to drop its copy. Divergence is fine
+// and expected; this is the owner now.
+//
+// **A day here is a string, `'2026-08-07'`, not a `Date`.** A date picker
+// selects a square on a wall calendar, and that is not an instant: it has no
+// time, no zone, and no duration that survives a DST boundary. A `Date` is an
+// instant, so every comparison the widgets need — is this the selected day, is
+// it inside the range, is it blocked — would be a comparison of two timestamps
+// that are only equal if both were built the same way. `new Date(2026, 7, 7)`
+// and `new Date('2026-08-07')` are eleven hours apart in Sydney and neither is
+// wrong.
+//
+// A string has none of that: `a === b` is "the same day", `a < b` is "earlier"
+// (fixed-width fields, so lexical order *is* chronological order), it is a
+// `Map`/`Set` key without a codec, and it is what a calendar API hands back
+// over the wire in the first place — which is exactly the shape the desktop
+// event overlay in `../desktop-calendar/` produces.
+//
+// `Date` is still accepted everywhere a day is taken: `toDay()` converts one
+// using its **local** calendar day, because that is the day the user was
+// looking at when they built it.
+//
+// The arithmetic runs in UTC (`Date.UTC`, `getUTC*`) so that "add a day" is
+// always 86400 seconds and never 23 or 25 — the local-time trap that puts a
+// month grid an hour out on the last Sunday in October.
+const DAY_RE = /^(\d{4})-(\d{2})-(\d{2})$/;
+const MONTH_RE = /^(\d{4})-(\d{2})$/;
+function pad(n, width) {
+    return String(n).padStart(width, '0');
+}
+function key(year, month, day) {
+    return `${pad(year, 4)}-${pad(month, 2)}-${pad(day, 2)}`;
+}
+/**
+ * A day key from a `'YYYY-MM-DD'` string, a `Date`, or `null`/`undefined`
+ * (which is "no day", and comes back as `null`).
+ *
+ * Throws on anything else, and on a string that is not a real date —
+ * `'2026-02-30'` is a typo, not a day, and silently sliding it to March 2nd
+ * the way `new Date()` does is how a booking ends up a day out. The message
+ * names what arrived, because the value in a props object is usually miles
+ * from the line that built it.
+ */
+export function toDay(value) {
+    if (value == null)
+        return null;
+    if (value instanceof Date) {
+        if (Number.isNaN(value.getTime())) {
+            throw new TypeError('@react-x11/components: an Invalid Date was passed where a calendar day was expected.');
+        }
+        // its *local* calendar day: `new Date(2026, 7, 7)` is local midnight, and
+        // the day the developer wrote down is the one they meant
+        return key(value.getFullYear(), value.getMonth() + 1, value.getDate());
+    }
+    if (typeof value === 'string') {
+        const m = DAY_RE.exec(value);
+        if (!m) {
+            throw new TypeError(`@react-x11/components: expected a calendar day as 'YYYY-MM-DD' or a Date, got ${JSON.stringify(value)}.`);
+        }
+        const [, y, mo, d] = m;
+        // through a real Date and back: the fields on their own are well-formed
+        // for '2026-02-30' too, and only the calendar knows February ends earlier
+        const date = new Date(Date.UTC(Number(y), Number(mo) - 1, Number(d)));
+        const round = key(date.getUTCFullYear(), date.getUTCMonth() + 1, date.getUTCDate());
+        if (round !== value) {
+            throw new TypeError(`@react-x11/components: ${JSON.stringify(value)} is not a real calendar date.`);
+        }
+        return value;
+    }
+    throw new TypeError(`@react-x11/components: expected a calendar day as 'YYYY-MM-DD' or a Date, got ${typeof value}.`);
+}
+/** `'YYYY-MM'` from the same set of inputs, for the *visible month* props. */
+export function toMonth(value) {
+    if (value == null)
+        return null;
+    if (typeof value === 'string' && MONTH_RE.test(value))
+        return value;
+    const day = toDay(value);
+    return day == null ? null : monthOf(day);
+}
+/** Today, on this machine, in local time — which is the day the user's wall
+ *  calendar is showing. */
+export function today() {
+    const now = new Date();
+    return key(now.getFullYear(), now.getMonth() + 1, now.getDate());
+}
+/** The day as a UTC-midnight `Date`, for `Intl` and for arithmetic. */
+export function dayDate(day) {
+    const [y, m, d] = day.split('-').map(Number);
+    return new Date(Date.UTC(y, m - 1, d));
+}
+/**
+ * `{ year, month, day, weekday, date }` — the parts a caller needs to decide
+ * something about a day without parsing the string itself. `weekday` is
+ * `0`-`6` from Sunday, as `Date#getDay()` counts, so blocking weekends is
+ * `weekday === 0 || weekday === 6`. `month` is 1-based, unlike `Date`'s.
+ */
+export function dayParts(day) {
+    const date = dayDate(day);
+    return {
+        year: date.getUTCFullYear(),
+        month: date.getUTCMonth() + 1,
+        day: date.getUTCDate(),
+        weekday: date.getUTCDay(),
+        date,
+    };
+}
+export function addDays(day, n) {
+    const date = dayDate(day);
+    date.setUTCDate(date.getUTCDate() + n);
+    return key(date.getUTCFullYear(), date.getUTCMonth() + 1, date.getUTCDate());
+}
+/** `'2026-08'` — the month a day is in. */
+export function monthOf(day) {
+    return day.slice(0, 7);
+}
+/** The first day of a `'YYYY-MM'`. */
+export function firstOfMonth(month) {
+    return `${month}-01`;
+}
+/**
+ * `n` months on from a `'YYYY-MM'`. Months, unlike days, are not all the same
+ * length, so this deliberately works on the month key and never on a day: the
+ * "same date next month" question (Jan 31 → Feb 31?) has no good answer and
+ * nothing here asks it.
+ */
+export function addMonths(month, n) {
+    const [y, m] = month.split('-').map(Number);
+    const total = y * 12 + (m - 1) + n;
+    return `${pad(Math.floor(total / 12), 4)}-${pad((total % 12) + 1, 2)}`;
+}
+/** `day` held inside `[min, max]`; either bound may be null. */
+export function clampDay(day, min, max) {
+    if (min && day < min)
+        return min;
+    if (max && day > max)
+        return max;
+    return day;
+}
+/**
+ * The grid a month is drawn on: **six weeks of seven days**, always, starting
+ * on `weekStartsOn` and running through whatever days of the neighbouring
+ * months it takes to fill the corners.
+ *
+ * Six rows even when five would do (and a 28-day February starting on the
+ * first day of the week needs only four) because the alternative is a picker
+ * whose popup changes height as you page through it, moving the very buttons
+ * the pointer is aiming at.
+ */
+export function monthGrid(month, weekStartsOn = 1) {
+    const first = firstOfMonth(month);
+    const lead = (dayParts(first).weekday - weekStartsOn + 7) % 7;
+    const start = addDays(first, -lead);
+    const weeks = [];
+    for (let w = 0; w < 6; w++) {
+        const days = [];
+        for (let d = 0; d < 7; d++)
+            days.push(addDays(start, w * 7 + d));
+        weeks.push(days);
+    }
+    return weeks;
+}
+// Intl formatters are expensive to build and every cell in the grid wants the
+// same three, so they are made once per (locale, shape) and kept.
+const formatters = new Map();
+function formatter(locale, options) {
+    const id = `${locale ?? ''}|${JSON.stringify(options)}`;
+    let f = formatters.get(id);
+    if (!f) {
+        // everything here is a UTC-midnight Date, so the formatter has to read it
+        // in UTC or a negative offset prints the day before
+        f = new Intl.DateTimeFormat(locale, { ...options, timeZone: 'UTC' });
+        formatters.set(id, f);
+    }
+    return f;
+}
+/**
+ * Which day the week starts on for a locale: `0` Sunday … `6` Saturday.
+ *
+ * The runtime knows this — CLDR carries it — but only through
+ * `Intl.Locale#getWeekInfo`, which is recent enough that a small-ICU build or
+ * an older V8 has neither it nor the `weekInfo` property it was proposed as.
+ * So it is feature-detected, and what is left when it is missing is **Monday**:
+ * ISO 8601's answer, and the one most of the world uses.
+ */
+export function localeWeekStart(locale) {
+    try {
+        const info = new Intl.Locale(locale ?? 'und');
+        // `getWeekInfo()` is the standardised spelling; `weekInfo` is what the
+        // proposal shipped as and what older V8 still has.
+        const withWeek = info;
+        const week = withWeek.getWeekInfo?.() ?? withWeek.weekInfo;
+        // CLDR counts 1 Monday … 7 Sunday; JS counts 0 Sunday … 6 Saturday
+        if (week?.firstDay)
+            return week.firstDay % 7;
+    }
+    catch {
+        // an invalid locale tag: the caller's formatters will complain about it
+        // more usefully than a week-start fallback could
+    }
+    return 1;
+}
+/** `['Mon', 'Tue', …]` in the locale, rotated to start on `weekStartsOn`. */
+export function weekdayLabels(locale, weekStartsOn = 1) {
+    const f = formatter(locale, { weekday: 'short' });
+    // 2026-08-02 is a Sunday, so `+ weekday` lands on the day we want a name for
+    return Array.from({ length: 7 }, (_, i) => f.format(dayDate(addDays('2026-08-02', (weekStartsOn + i) % 7))));
+}
+/** `'August 2026'` in the locale. */
+export function formatMonth(month, locale) {
+    return formatter(locale, { month: 'long', year: 'numeric' }).format(dayDate(firstOfMonth(month)));
+}
+/** `'7 Aug 2026'` in the locale — what a picker's trigger shows. */
+export function formatDay(day, locale, options) {
+    return formatter(locale, options ?? { dateStyle: 'medium' }).format(dayDate(day));
+}
+/**
+ * `'7 – 12 Aug 2026'`: the locale's own way of writing a span, which collapses
+ * the parts the two ends share. `formatRange` is ES2021 and universal in the
+ * Node versions this package supports, but a small-ICU build can still throw,
+ * so a plain "a – b" is kept behind it.
+ */
+export function formatDayRange(start, end, locale, options) {
+    const f = formatter(locale, options ?? { dateStyle: 'medium' });
+    try {
+        return f.formatRange(dayDate(start), dayDate(end));
+    }
+    catch {
+        return `${f.format(dayDate(start))} – ${f.format(dayDate(end))}`;
+    }
+}
+//# sourceMappingURL=dates.js.map