@50arms/ui 0.0.0-stage → 35.1.0

package/dist/components/calendar/EventActions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"EventActions.js","sources":["../../../src/components/calendar/EventActions.tsx"],"sourcesContent":["import { useState } from \"react\";\nimport { tv } from \"tailwind-variants\";\nimport { cn } from \"@/lib/cn\";\nimport { Button } from \"@/components/Button\";\nimport { Select, SelectItem } from \"@/components/Select\";\nimport {\n  addDuration,\n  instantToPlainDateTime,\n  isoDateString,\n  plainDateTimeToInstant,\n  startOfDay,\n  type Instant,\n  type PlainDate,\n  type TimeZone,\n} from \"@/lib/time\";\nimport type { TimedEvent } from \"@/lib/calendar/types\";\nimport { useNumberFormat, useUiLocale, useUiStrings } from \"@/lib/i18n\";\nimport { longDate, timeOfDay } from \"./format\";\n\n/* ============================================================================\n   THE POINTER ALTERNATIVE TO DRAGGING — WCAG 2.2 SC 2.5.7.\n\n   THIS IS TIER ONE, AND THE KEYBOARD IS NOT. That ordering is the opposite of\n   what it is natural to build, and building it the other way round fails AA\n   outright. The Understanding document is unusually direct:\n\n       \"achieving keyboard equivalence for a dragging operation does not\n       automatically meet this success criterion, unless that equivalent\n       keyboard operation also provides controls that can be clicked or tapped\n       with a pointer.\"\n\n   2.5.7 and 2.1.1 are assessed independently. A keyboard grabbed-mode satisfies\n   2.1.1 and does not touch 2.5.7 at all — so a calendar with arrow-key dragging\n   and no menu is a calendar that fails.\n\n   And the pattern is not merely unproven, it has been TRIED AND WITHDRAWN.\n   Atlassian invented keyboard-drag in react-beautiful-dnd, user-tested it, and\n   abandoned it: blind users cannot reason about directional movement through\n   space they cannot see, it forces JAWS users to change mode, and complex moves\n   take many keystrokes. Their replacement guidance is an action menu. rbd was\n   deprecated in Oct 2024 and archived in Apr 2025.\n\n   WHY A FORM AND NOT NESTED MENUS. Every outcome a drag can produce has to be\n   reachable here — a new day, a new start, a new length — and a submenu tree\n   deep enough to express all three is worse to operate than three fields. Three\n   selects and an Apply button is the smallest thing that covers the whole\n   gesture, and it is operable by pointer, by keyboard, and by switch.\n   ========================================================================= */\n\nconst actions = tv({\n  slots: {\n    root: \"flex min-w-64 flex-col gap-3\",\n    title: \"text-sm font-semibold text-primary\",\n    meta: \"text-2xs text-tertiary\",\n    row: \"flex items-center justify-between gap-3\",\n    label: \"text-xs text-secondary\",\n    footer: \"flex justify-end gap-2 border-t border-border-subtle pt-3\",\n  },\n});\n\nexport interface EventActionsProps {\n  event: TimedEvent;\n  zone: TimeZone;\n  /** The days the view is showing — the destinations \"Move to\" offers. */\n  days: readonly PlainDate[];\n  /** Same step the drag snaps to, so the two paths reach the same positions. */\n  snapMinutes?: number;\n  /** Longest duration offered, in minutes. */\n  maxDurationMinutes?: number;\n  onApply: (next: TimedEvent) => void;\n  onClose?: () => void;\n  className?: string;\n}\n\n/** Every snapped time in a day, as {value, label}. Walked, so DST falls out. */\nfunction timeOptions(\n  zone: TimeZone,\n  day: PlainDate,\n  snapMinutes: number,\n  locale: string,\n): { value: string; label: string; instant: Instant }[] {\n  const from = startOfDay(zone, day);\n  const length = startOfDay(zone, { ...day, day: day.day + 1 }) - from;\n  const step = snapMinutes * 60_000;\n  const out: { value: string; label: string; instant: Instant }[] = [];\n  /* WALKED, not divided into 24 × (60/snap). On a 23-hour day this yields the\n     92 slots that exist rather than 96 including four that never happened, and\n     on a 25-hour day it yields 100 with the repeated hour present twice — which\n     is what the grid draws, so the two agree by construction. */\n  for (let elapsed = 0; elapsed < length; elapsed += step) {\n    const instant = from + elapsed;\n    out.push({ value: String(elapsed), label: timeOfDay(instant, zone, locale), instant });\n  }\n  return out;\n}\n\nconst DURATIONS = [15, 30, 45, 60, 90, 120, 180, 240, 300, 360, 480, 600, 720];\n\nexport function EventActions({\n  event,\n  zone,\n  days,\n  snapMinutes = 15,\n  maxDurationMinutes = 720,\n  onApply,\n  onClose,\n  className,\n}: EventActionsProps) {\n  const locale = useUiLocale();\n  const fmt = useNumberFormat();\n  const strings = useUiStrings().calendar.actions;\n  const s = actions();\n\n  const currentDay = (() => {\n    const wall = instantToPlainDateTime(zone, event.start);\n    return { year: wall.year, month: wall.month, day: wall.day };\n  })();\n\n  const [dayKey, setDayKey] = useState(isoDateString(currentDay));\n  const chosenDay = days.find((d) => isoDateString(d) === dayKey) ?? currentDay;\n\n  const options = timeOptions(zone, chosenDay, snapMinutes, locale);\n  const currentOffset = event.start - startOfDay(zone, currentDay);\n  const [offsetKey, setOffsetKey] = useState(String(currentOffset));\n\n  const durationMinutes = Math.round((event.endExclusive - event.start) / 60_000);\n  const [duration, setDuration] = useState(String(durationMinutes));\n\n  /* The current duration is offered even when it is not one of the presets —\n     otherwise opening the menu on a 37-minute event and pressing Apply would\n     silently round it. */\n  const durationChoices = Array.from(new Set([...DURATIONS, durationMinutes]))\n    .filter((m) => m > 0 && m <= maxDurationMinutes)\n    .sort((a, b) => a - b);\n\n  const apply = () => {\n    const chosen = options.find((o) => o.value === offsetKey) ?? options[0];\n    /* Resolved through the same wall-clock path the drag uses, so a time that\n       does not exist on the target day lands where a drag would land it. */\n    const wall = instantToPlainDateTime(zone, chosen.instant);\n    const start = plainDateTimeToInstant(zone, {\n      ...chosenDay,\n      hour: wall.hour,\n      minute: wall.minute,\n      second: 0,\n      millisecond: 0,\n    });\n    const minutes = Number(duration);\n    onApply({\n      ...event,\n      start,\n      endExclusive: addDuration(zone, start, { minutes }),\n    });\n    onClose?.();\n  };\n\n  return (\n    <div className={cn(s.root(), className)}>\n      <div>\n        <div className={s.title()}>{event.title}</div>\n        <div className={s.meta()}>\n          {timeOfDay(event.start, zone, locale)} – {timeOfDay(event.endExclusive, zone, locale)},{\" \"}\n          {longDate(currentDay, locale)}\n        </div>\n      </div>\n\n      <div className={s.row()}>\n        <span className={s.label()} id=\"cal-actions-day\">\n          {strings.moveTo}\n        </span>\n        <Select\n          value={dayKey}\n          onValueChange={(v) => {\n            setDayKey(String(v));\n            /* The offset is kept, not the instant: \"same time, different day\"\n               is what a drag across a column does, and it is what a person\n               means by moving an event to Thursday. */\n          }}\n          aria-label={strings.day}\n        >\n          {days.map((d) => (\n            <SelectItem key={isoDateString(d)} value={isoDateString(d)}>\n              {longDate(d, locale)}\n            </SelectItem>\n          ))}\n        </Select>\n      </div>\n\n      <div className={s.row()}>\n        <span className={s.label()}>{strings.startAt}</span>\n        <Select value={offsetKey} onValueChange={(v) => setOffsetKey(String(v))} aria-label={strings.startTime}>\n          {options.map((o) => (\n            <SelectItem key={o.value} value={o.value}>\n              {o.label}\n            </SelectItem>\n          ))}\n        </Select>\n      </div>\n\n      <div className={s.row()}>\n        <span className={s.label()}>{strings.lasting}</span>\n        <Select value={duration} onValueChange={(v) => setDuration(String(v))} aria-label={strings.duration}>\n          {durationChoices.map((m) => (\n            <SelectItem key={m} value={String(m)}>\n              {strings.minutes(Math.floor(m / 60), fmt(Math.floor(m / 60)), m % 60, fmt(m % 60))}\n            </SelectItem>\n          ))}\n        </Select>\n      </div>\n\n      <div className={s.footer()}>\n        <Button size=\"sm\" variant=\"ghost\" onClick={() => onClose?.()}>\n          {strings.cancel}\n        </Button>\n        <Button size=\"sm\" onClick={apply}>\n          {strings.apply}\n        </Button>\n      </div>\n    </div>\n  );\n}\n"],"names":["actions","tv","timeOptions","zone","day","snapMinutes","locale","from","startOfDay","length","step","out","elapsed","instant","timeOfDay","DURATIONS","EventActions","event","days","maxDurationMinutes","onApply","onClose","className","useUiLocale","fmt","useNumberFormat","strings","useUiStrings","s","currentDay","wall","instantToPlainDateTime","dayKey","setDayKey","useState","isoDateString","chosenDay","d","options","currentOffset","offsetKey","setOffsetKey","durationMinutes","duration","setDuration","durationChoices","m","a","b","apply","chosen","o","start","plainDateTimeToInstant","minutes","addDuration","jsxs","cn","jsx","longDate","Select","v","SelectItem","Button"],"mappings":"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"}

package/dist/components/calendar/format.js

@@ -0,0 +1,73 @@
+import { numberFormat as D, dateFormat as h, asUtcDate as g } from "../../lib/intl-cache.js";
+import { instantToPlainDateTime as y } from "../../lib/time/zone.js";
+function i(t, a) {
+  return h(t, a);
+}
+function m(t) {
+  return g(t.year, t.month, t.day);
+}
+const c = { timeZone: "UTC" };
+function Z(t, a, n) {
+  return i(n, { ...c, weekday: a }).format(m(t));
+}
+function C(t, a) {
+  return i(a, { ...c, day: "numeric" }).format(m(t));
+}
+function N(t, a) {
+  return i(a, { ...c, year: "numeric", month: "long" }).format(m(t));
+}
+function T(t, a) {
+  return i(a, {
+    ...c,
+    weekday: "long",
+    day: "numeric",
+    month: "long",
+    year: "numeric"
+  }).format(m(t));
+}
+function s(t, a, n, r = !0) {
+  const o = y(a, t), e = !r || o.minute === 0 ? { timeZone: a, hour: "numeric" } : { timeZone: a, hour: "numeric", minute: "2-digit" };
+  return i(n, e).format(new Date(t));
+}
+function x(t, a, n) {
+  return i(n, { timeZone: t, timeZoneName: "shortOffset" }).formatToParts(
+    new Date(a)
+  ).find((o) => o.type === "timeZoneName")?.value ?? t;
+}
+function p(t, a, n, r) {
+  return t.allDay ? U(t, n, r) : b(t, a, n, r);
+}
+function U(t, a, n) {
+  const r = w(t.endExclusive), o = r.year === t.start.year && r.month === t.start.month && r.day === t.start.day, e = i(a, { ...c, day: "numeric", month: "long" });
+  return o ? n.allDayOn(e.format(m(t.start))) : n.allDayRange(e.format(m(t.start)), e.format(m(r)));
+}
+function b(t, a, n, r) {
+  const o = s(t.start, a, n), e = s(t.endExclusive, a, n), f = y(a, t.start), u = y(a, t.endExclusive);
+  if (f.year === u.year && f.month === u.month && f.day === u.day)
+    return r.timedRange(o, e);
+  const l = i(n, { ...c, day: "numeric", month: "long" }), d = { year: u.year, month: u.month, day: u.day };
+  return r.timedRangeUntil(o, e, l.format(m(d)));
+}
+function w(t) {
+  const a = m(t);
+  return a.setUTCDate(a.getUTCDate() - 1), { year: a.getUTCFullYear(), month: a.getUTCMonth() + 1, day: a.getUTCDate() };
+}
+function k(t, a, n, r) {
+  return r.cellLabel(a, D(n, {}).format(a), T(t, n));
+}
+function E(t, a, n, r, o) {
+  const e = [t.title, p(t, a, r, o)];
+  return t.calendarLabel ? e.push(t.calendarLabel) : n && e.push(n), e.join(", ");
+}
+export {
+  k as cellLabel,
+  C as dayNumber,
+  E as eventLabel,
+  p as formatDateRange,
+  T as longDate,
+  N as monthTitle,
+  s as timeOfDay,
+  Z as weekdayName,
+  x as zoneLabel
+};
+//# sourceMappingURL=format.js.map

package/dist/components/calendar/format.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.js","sources":["../../../src/components/calendar/format.ts"],"sourcesContent":["import {\n  instantToPlainDateTime,\n  type Instant,\n  type PlainDate,\n  type TimeZone,\n} from \"@/lib/time\";\nimport type { AllDayEvent, CalendarEvent, TimedEvent } from \"@/lib/calendar/types\";\nimport type { CalendarStrings } from \"@/lib/i18n/areas/dates\";\nimport { dateFormat, asUtcDate, numberFormat } from \"@/lib/intl-cache\";\n\n/* ----------------------------------------------------------------------------\n   EVERY STRING A HUMAN OR A SCREEN READER RECEIVES.\n\n   All of it through `Intl`, none of it hand-assembled. A calendar that builds\n   \"Mon 15\" by indexing an array of English weekday names is a calendar that\n   only works in English, and the array is invariably in the component that\n   needed it first.\n\n   `Intl.DateTimeFormat` is expensive to construct — tens of microseconds — and\n   a month grid formats several hundred strings per render, so every formatter\n   is memoised by its full option set.\n\n   THE ±1 CONVERSION LIVES HERE, AND ONLY HERE. The model is half-open:\n   `endExclusive` is the first day NOT in the event. A human reading \"15–17\n   June\" means the 17th is included. That translation happens in\n   `formatDateRange` and nowhere else in the package, which is the whole reason\n   the field is named the way it is.\n   -------------------------------------------------------------------------- */\n\nfunction formatter(locale: string, options: Intl.DateTimeFormatOptions) {\n  return dateFormat(locale, options);\n}\n\n/** A `PlainDate` as a UTC `Date`, purely so `Intl` can read its fields. */\nfunction plainDateToUtc(date: PlainDate): Date {\n  return asUtcDate(date.year, date.month, date.day);\n}\n\n/* Every date formatter below is pinned to `timeZone: \"UTC\"`. A `PlainDate` has\n   no zone, and the `Date` above is a carrier rather than an instant — letting\n   Intl apply the host's zone would shift a date backwards for anyone west of\n   Greenwich, which is the classic \"my birthday shows a day early\" bug. */\n// I18N-ALLOW: Intl timeZone option value\nconst PLAIN = { timeZone: \"UTC\" } as const;\n\n/** `Monday` / `Mon` / `M`, in the viewer's locale. */\nexport function weekdayName(\n  date: PlainDate,\n  width: \"long\" | \"short\" | \"narrow\",\n  locale: string,\n): string {\n  return formatter(locale, { ...PLAIN, weekday: width }).format(plainDateToUtc(date));\n}\n\n/** `15` — the number in the cell. */\nexport function dayNumber(date: PlainDate, locale: string): string {\n  return formatter(locale, { ...PLAIN, day: \"numeric\" }).format(plainDateToUtc(date));\n}\n\n/** `June 2026` — the view's title. */\nexport function monthTitle(date: PlainDate, locale: string): string {\n  return formatter(locale, { ...PLAIN, year: \"numeric\", month: \"long\" }).format(plainDateToUtc(date));\n}\n\n/** `Monday, 15 June 2026` — a cell's accessible name starts with this. */\nexport function longDate(date: PlainDate, locale: string): string {\n  return formatter(locale, {\n    ...PLAIN,\n    weekday: \"long\",\n    day: \"numeric\",\n    month: \"long\",\n    year: \"numeric\",\n  }).format(plainDateToUtc(date));\n}\n\n/** `9:30 AM` in the calendar's zone — never the host's. */\nexport function timeOfDay(\n  instant: Instant,\n  zone: TimeZone,\n  locale: string,\n  withMinutes = true,\n): string {\n  const wall = instantToPlainDateTime(zone, instant);\n  /* Google, and most calendars, drop `:00` — \"9 AM\" rather than \"9:00 AM\" —\n     because in a column of times the zeros are noise. Minutes are kept whenever\n     they carry information. */\n  const options: Intl.DateTimeFormatOptions =\n    !withMinutes || wall.minute === 0\n      ? { timeZone: zone, hour: \"numeric\" }\n      : { timeZone: zone, hour: \"numeric\", minute: \"2-digit\" };\n  return formatter(locale, options).format(new Date(instant));\n}\n\n/** `GMT−6` — the label above the hour gutter. */\nexport function zoneLabel(zone: TimeZone, at: Instant, locale: string): string {\n  const parts = formatter(locale, { timeZone: zone, timeZoneName: \"shortOffset\" }).formatToParts(\n    new Date(at),\n  );\n  return parts.find((p) => p.type === \"timeZoneName\")?.value ?? zone;\n}\n\n/**\n * The human range of an event: `15–17 June`, `9:30 – 10:30 AM`, `All day`.\n *\n * THE ONLY PLACE THE EXCLUSIVE END BECOMES AN INCLUSIVE ONE. An all-day event\n * stored 15th → 16th is ONE day and reads \"15 June\"; stored 15th → 18th it\n * reads \"15 – 17 June\". Getting this wrong in the other direction is the\n * most-reported bug in calendar interoperability, so it happens once, here,\n * where a test can point at it.\n */\nexport function formatDateRange(\n  event: CalendarEvent,\n  zone: TimeZone,\n  locale: string,\n  strings: CalendarStrings,\n): string {\n  if (event.allDay) return formatAllDayRange(event, locale, strings);\n  return formatTimedRange(event, zone, locale, strings);\n}\n\nfunction formatAllDayRange(event: AllDayEvent, locale: string, strings: CalendarStrings): string {\n  const lastDay = previousDay(event.endExclusive);\n  const sameDay =\n    lastDay.year === event.start.year &&\n    lastDay.month === event.start.month &&\n    lastDay.day === event.start.day;\n\n  const medium = formatter(locale, { ...PLAIN, day: \"numeric\", month: \"long\" });\n  if (sameDay) return strings.allDayOn(medium.format(plainDateToUtc(event.start)));\n  return strings.allDayRange(medium.format(plainDateToUtc(event.start)), medium.format(plainDateToUtc(lastDay)));\n}\n\nfunction formatTimedRange(event: TimedEvent, zone: TimeZone, locale: string, strings: CalendarStrings): string {\n  const from = timeOfDay(event.start, zone, locale);\n  const to = timeOfDay(event.endExclusive, zone, locale);\n  const startDay = instantToPlainDateTime(zone, event.start);\n  const endDay = instantToPlainDateTime(zone, event.endExclusive);\n  if (startDay.year === endDay.year && startDay.month === endDay.month && startDay.day === endDay.day) {\n    return strings.timedRange(from, to);\n  }\n  const medium = formatter(locale, { ...PLAIN, day: \"numeric\", month: \"long\" });\n  const endDate: PlainDate = { year: endDay.year, month: endDay.month, day: endDay.day };\n  return strings.timedRangeUntil(from, to, medium.format(plainDateToUtc(endDate)));\n}\n\nfunction previousDay(date: PlainDate): PlainDate {\n  const d = plainDateToUtc(date);\n  d.setUTCDate(d.getUTCDate() - 1);\n  return { year: d.getUTCFullYear(), month: d.getUTCMonth() + 1, day: d.getUTCDate() };\n}\n\n/**\n * A cell's accessible name: `Monday, 15 June 2026, 3 events`.\n *\n * THE COUNT IS PART OF THE NAME, and that is the difference between a grid a\n * screen-reader user can skim and one they must enter cell by cell to discover\n * is empty. Arrowing across a month hearing \"14. 15. 16.\" tells them nothing\n * about where the work is.\n */\nexport function cellLabel(\n  date: PlainDate,\n  eventCount: number,\n  locale: string,\n  strings: CalendarStrings,\n): string {\n  return strings.cellLabel(eventCount, numberFormat(locale, {}).format(eventCount), longDate(date, locale));\n}\n\n/**\n * An event chip's accessible name.\n *\n * Title, then the range, then the calendar's colour LABEL — the last so that\n * two identically-titled events on different calendars are distinguishable\n * without seeing the colour.\n */\nexport function eventLabel(\n  event: CalendarEvent,\n  zone: TimeZone,\n  paletteLabel: string | undefined,\n  locale: string,\n  strings: CalendarStrings,\n): string {\n  const parts = [event.title, formatDateRange(event, zone, locale, strings)];\n  if (event.calendarLabel) parts.push(event.calendarLabel);\n  else if (paletteLabel) parts.push(paletteLabel);\n  return parts.join(\", \");\n}\n"],"names":["formatter","locale","options","dateFormat","plainDateToUtc","date","asUtcDate","PLAIN","weekdayName","width","dayNumber","monthTitle","longDate","timeOfDay","instant","zone","withMinutes","wall","instantToPlainDateTime","zoneLabel","at","p","formatDateRange","event","strings","formatAllDayRange","formatTimedRange","lastDay","previousDay","sameDay","medium","from","to","startDay","endDay","endDate","d","cellLabel","eventCount","numberFormat","eventLabel","paletteLabel","parts"],"mappings":"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"}

package/dist/components/calendar/palette.js

@@ -0,0 +1,31 @@
+function t(e) {
+  return {
+    key: e,
+    fill: `var(--event-${e}-fill)`,
+    text: `var(--event-${e}-text)`,
+    edge: `var(--event-${e}-edge)`
+  };
+}
+const i = [
+  t("iris"),
+  t("aqua"),
+  t("mint"),
+  t("amber"),
+  t("rose"),
+  t("azure"),
+  t("orchid"),
+  t("slate")
+], n = "iris", r = new Map(i.map((e) => [e.key, e]));
+function a(e) {
+  return e === void 0 ? r.get(n) : r.get(e) ?? r.get(n);
+}
+function o(e) {
+  return r.has(e);
+}
+export {
+  n as DEFAULT_PALETTE_KEY,
+  i as EVENT_PALETTE,
+  o as isPaletteKey,
+  a as paletteFor
+};
+//# sourceMappingURL=palette.js.map

package/dist/components/calendar/palette.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"palette.js","sources":["../../../src/components/calendar/palette.ts"],"sourcesContent":["import type { EventPalette, PaletteEntry, PaletteKey } from \"@/lib/calendar/types\";\n\n/* ----------------------------------------------------------------------------\n   THE CURATED PALETTE.\n\n   Eight swatches, each naming its own text colour and its own edge. A consumer\n   picks a KEY; it cannot supply a hex, and that refusal is the feature — see\n   `PaletteEntry` for why a computed black-or-white flip cannot be made correct,\n   and `tokens.css` for the tokens themselves.\n\n   Every pair is measured by `audit:palette` in a real browser, in both themes:\n   4.5:1 text on fill, 3:1 edge on fill, 3:1 edge against the page. The values\n   live in CSS custom properties rather than here, so a chip re-themes with the\n   page instead of needing a re-render.\n\n   The spoken colour name (`calendar.colors[key]` in the built-in strings) is not\n   decoration. It is spoken as part of the chip's accessible name so that colour\n   is never the only way to tell two calendars apart — a legend elsewhere on the\n   page does not satisfy that, because the remedy has to sit on the coded item\n   itself.\n   -------------------------------------------------------------------------- */\n\nfunction entry(key: PaletteKey): PaletteEntry {\n  return {\n    key,\n    fill: `var(--event-${key}-fill)`,\n    text: `var(--event-${key}-text)`,\n    edge: `var(--event-${key}-edge)`,\n  };\n}\n\nexport const EVENT_PALETTE: EventPalette = [\n  entry(\"iris\"),\n  entry(\"aqua\"),\n  entry(\"mint\"),\n  entry(\"amber\"),\n  entry(\"rose\"),\n  entry(\"azure\"),\n  entry(\"orchid\"),\n  entry(\"slate\"),\n];\n\n// I18N-ALLOW: palette key id, matched against the PaletteKey union\nexport const DEFAULT_PALETTE_KEY = \"iris\";\n\nconst byKey = new Map<string, PaletteEntry>(EVENT_PALETTE.map((swatch) => [swatch.key, swatch]));\n\n/**\n * The swatch for a key, falling back to the default for an unknown one.\n *\n * A FALLBACK RATHER THAN A THROW, deliberately, and this is the one place in\n * the calendar where that is the right call. Event data arrives from a server\n * and an unrecognised colour key is a data problem, not a programming error —\n * refusing to render the whole month because one event has a stale key would\n * turn a cosmetic mismatch into an outage. The event still renders, still\n * carries its title and time, and is still reachable; only its colour is\n * generic.\n */\nexport function paletteFor(key: string | undefined): PaletteEntry {\n  if (key === undefined) return byKey.get(DEFAULT_PALETTE_KEY)!;\n  return byKey.get(key) ?? byKey.get(DEFAULT_PALETTE_KEY)!;\n}\n\n/** Whether a key names a real swatch — for a consumer validating its own data. */\nexport function isPaletteKey(key: string): boolean {\n  return byKey.has(key);\n}\n"],"names":["entry","key","EVENT_PALETTE","DEFAULT_PALETTE_KEY","byKey","swatch","paletteFor","isPaletteKey"],"mappings":"AAsBA,SAASA,EAAMC,GAA+B;AAC5C,SAAO;AAAA,IACL,KAAAA;AAAA,IACA,MAAM,eAAeA,CAAG;AAAA,IACxB,MAAM,eAAeA,CAAG;AAAA,IACxB,MAAM,eAAeA,CAAG;AAAA,EAAA;AAE5B;AAEO,MAAMC,IAA8B;AAAA,EACzCF,EAAM,MAAM;AAAA,EACZA,EAAM,MAAM;AAAA,EACZA,EAAM,MAAM;AAAA,EACZA,EAAM,OAAO;AAAA,EACbA,EAAM,MAAM;AAAA,EACZA,EAAM,OAAO;AAAA,EACbA,EAAM,QAAQ;AAAA,EACdA,EAAM,OAAO;AACf,GAGaG,IAAsB,QAE7BC,IAAQ,IAAI,IAA0BF,EAAc,IAAI,CAACG,MAAW,CAACA,EAAO,KAAKA,CAAM,CAAC,CAAC;AAaxF,SAASC,EAAWL,GAAuC;AAChE,SAAIA,MAAQ,SAAkBG,EAAM,IAAID,CAAmB,IACpDC,EAAM,IAAIH,CAAG,KAAKG,EAAM,IAAID,CAAmB;AACxD;AAGO,SAASI,EAAaN,GAAsB;AACjD,SAAOG,EAAM,IAAIH,CAAG;AACtB;"}

package/dist/components/calendar/use-calendar-drag.js

@@ -0,0 +1,149 @@
+import { useState as D, useRef as E, useCallback as a, useEffect as j } from "react";
+import { attachPointerGesture as q } from "../../lib/dnd/sensors/gesture.js";
+import { describeTarget as X, resolveCalendarTarget as z, calendarDragResult as P, createdEvent as L, applyCalendarDelta as F } from "../../lib/calendar/drag.js";
+import { useUiLocale as Y, useUiStrings as Z } from "../../lib/i18n/provider.js";
+function un(H) {
+  const { zone: C, days: A, snapMinutes: R, measure: S, onCommit: T, onCreate: M, onAnnounce: _, disabled: b } = H, B = Y(), { moveCancelled: I } = Z().calendar, [l, v] = D(null), [k, g] = D(null), [J, w] = D(!1), t = E({ zone: C, days: A, snapMinutes: R, measure: S, onCommit: T, onCreate: M, onAnnounce: _, locale: B, moveCancelled: I });
+  t.current = { zone: C, days: A, snapMinutes: R, measure: S, onCommit: T, onCreate: M, onAnnounce: _, locale: B, moveCancelled: I };
+  const n = E({ columns: [], origin: null, anchor: null, last: null, spoken: null, point: null }), d = a(() => {
+    n.current.columns = t.current.measure();
+  }, []);
+  j(() => {
+    if (!l && !k) return;
+    const r = () => d();
+    return window.addEventListener("scroll", r, { capture: !0, passive: !0 }), () => window.removeEventListener("scroll", r, { capture: !0 });
+  }, [l, k, d]), j(() => {
+    if (!l && !k) return;
+    const r = (u) => {
+      u.key === "Escape" && (u.preventDefault(), n.current.origin = null, n.current.anchor = null, n.current.last = null, v(null), g(null), w(!1), t.current.onAnnounce?.(t.current.moveCancelled));
+    };
+    return window.addEventListener("keydown", r), () => window.removeEventListener("keydown", r);
+  }, [l, k]);
+  const p = a((r) => {
+    const u = X(r, t.current.zone, t.current.locale);
+    n.current.spoken !== u && (n.current.spoken = u, t.current.onAnnounce?.(u));
+  }, []), U = E(
+    /* @__PURE__ */ new Map()
+  ), $ = a(
+    (r) => (u) => {
+      if (!u || b) return;
+      const c = r.event, e = r.kind;
+      return q(u, {
+        onPress: () => c.editable !== !1,
+        onActivate: (o) => {
+          n.current.point = o, d();
+          const i = z(o, {
+            zone: t.current.zone,
+            columns: n.current.columns,
+            snapMinutes: t.current.snapMinutes
+          });
+          i && (n.current.origin = { event: c, kind: e, from: i }, n.current.last = i, n.current.spoken = null, v({ id: c.id, kind: e, delta: {} }));
+        },
+        onMove: (o) => {
+          n.current.point = o;
+          const i = n.current.origin;
+          if (!i) return;
+          const f = z(o, {
+            zone: t.current.zone,
+            columns: n.current.columns,
+            snapMinutes: t.current.snapMinutes
+          }) ?? n.current.last;
+          if (!f) return;
+          n.current.last = f;
+          const m = P(i, f, t.current.zone);
+          w(m.invalid !== void 0), v({ id: c.id, kind: e, delta: m.delta }), m.invalid || p(f);
+        },
+        onRelease: (o, i) => {
+          if (n.current.point = null, i) {
+            const G = (K) => {
+              K.stopPropagation(), K.preventDefault();
+            };
+            u.addEventListener("click", G, { capture: !0, once: !0 }), setTimeout(() => u.removeEventListener("click", G, { capture: !0 }), 0);
+          }
+          const h = n.current.origin;
+          if (n.current.origin = null, v(null), w(!1), !i || !h) return;
+          const f = n.current.last;
+          if (!f) return;
+          const m = P(h, f, t.current.zone);
+          !m.moved || m.invalid || t.current.onCommit?.(
+            c,
+            F(c, e, m.delta, t.current.zone)
+          );
+        },
+        onCancel: () => {
+          n.current.point = null, n.current.origin = null, v(null), w(!1);
+        }
+      });
+    },
+    [p, b, d]
+  ), N = a(
+    (r, u) => {
+      const c = `${r.id}:${u}`;
+      let e = U.current.get(c);
+      return e || (e = { event: r, kind: u, cb: () => {
+      } }, e.cb = $(e), U.current.set(c, e)), e.event = r, e.cb;
+    },
+    [$]
+  ), y = E(null), x = a(
+    (r) => !r || b || !M ? void 0 : q(r, {
+      onPress: (c, e) => !e.target?.closest("button"),
+      onActivate: (c) => {
+        n.current.point = c, d();
+        const e = z(c, {
+          zone: t.current.zone,
+          columns: n.current.columns,
+          snapMinutes: t.current.snapMinutes
+        });
+        e && (n.current.anchor = e, n.current.last = e, n.current.spoken = null, g(L(e, e)));
+      },
+      onMove: (c) => {
+        n.current.point = c;
+        const e = n.current.anchor;
+        if (!e) return;
+        const o = z(c, {
+          zone: t.current.zone,
+          columns: n.current.columns,
+          snapMinutes: t.current.snapMinutes
+        }) ?? n.current.last;
+        o && (n.current.last = o, g(L(e, o)), p(o));
+      },
+      onRelease: (c, e) => {
+        if (n.current.point = null, e) {
+          const i = (h) => {
+            h.stopPropagation(), h.preventDefault();
+          };
+          r.addEventListener("click", i, { capture: !0, once: !0 }), setTimeout(() => r.removeEventListener("click", i, { capture: !0 }), 0);
+        }
+        const s = n.current.anchor, o = n.current.last;
+        n.current.anchor = null, g(null), !(!e || !s || !o) && t.current.onCreate?.(L(s, o));
+      },
+      onCancel: () => {
+        n.current.point = null, n.current.anchor = null, g(null);
+      }
+    }),
+    [p, b, M, d]
+  ), O = a(() => (y.current || (y.current = x), y.current), [x]), Q = a(() => n.current.point, []), V = a(
+    (r) => {
+      d();
+      const u = n.current.origin, c = n.current.anchor, s = z(r, {
+        zone: t.current.zone,
+        columns: n.current.columns,
+        snapMinutes: t.current.snapMinutes
+      }) ?? n.current.last;
+      if (s)
+        if (n.current.last = s, u) {
+          const o = P(u, s, t.current.zone);
+          w(o.invalid !== void 0), v({ id: u.event.id, kind: u.kind, delta: o.delta }), o.invalid || p(s);
+        } else c && (g(L(c, s)), p(s));
+    },
+    [p, d]
+  ), W = a(
+    (r) => !l || l.id !== r.id ? r : F(r, l.kind, l.delta, C),
+    [l, C]
+  );
+  return { draft: l, creating: k, invalid: J, bindEvent: N, bindCanvas: O, preview: W, getPoint: Q, onScrolled: V };
+}
+export {
+  un as useCalendarDrag
+};
+//# sourceMappingURL=use-calendar-drag.js.map

package/dist/components/calendar/use-calendar-drag.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-calendar-drag.js","sources":["../../../src/components/calendar/use-calendar-drag.ts"],"sourcesContent":["import { useCallback, useEffect, useRef, useState } from \"react\";\nimport { attachPointerGesture } from \"@/lib/dnd/sensors/gesture\";\nimport {\n  applyCalendarDelta,\n  calendarDragResult,\n  createdEvent,\n  describeTarget,\n  resolveCalendarTarget,\n  type CalendarTarget,\n  type ColumnRect,\n} from \"@/lib/calendar/drag\";\nimport type { CalendarEvent, DragKind, EventDraft, TimedEvent } from \"@/lib/calendar/types\";\nimport type { Instant, PlainDate, TimeZone } from \"@/lib/time\";\nimport { useUiLocale, useUiStrings } from \"@/lib/i18n\";\n\n/* ----------------------------------------------------------------------------\n   THE REACT SIDE OF A CALENDAR GESTURE.\n\n   Everything decidable is decided in `lib/calendar/drag.ts`, which is pure and\n   carries the DST cases no browser test could reach reliably. What is left here\n   is the part that genuinely needs the DOM: measuring the columns, listening,\n   and holding the draft.\n\n   THE DRAFT IS A DELTA KEYED BY ID, never a rewritten copy of the event and\n   never a reference to one. See `EventDraft` for the two real failures that\n   shape prevents.\n\n   MEASURED AT ACTIVATION AND AGAIN ON SCROLL. A snapshot taken once at\n   pointer-down goes stale the moment the grid scrolls under the pointer — and\n   the grid scrolls constantly during a drag, because auto-scroll is doing it.\n   -------------------------------------------------------------------------- */\n\nexport interface CalendarDragOptions {\n  readonly zone: TimeZone;\n  readonly days: readonly PlainDate[];\n  readonly snapMinutes: number;\n  /** Measure the day columns. Called at activation and on every scroll. */\n  readonly measure: () => ColumnRect[];\n  /** Commit. Not called for a gesture that changed nothing. */\n  readonly onCommit?: (event: CalendarEvent, next: TimedEvent) => void;\n  /** Commit a drag-to-create. */\n  readonly onCreate?: (range: { start: Instant; endExclusive: Instant; day: PlainDate }) => void;\n  /** Fired on every committed slot change, for the live region. */\n  readonly onAnnounce?: (message: string) => void;\n  readonly disabled?: boolean;\n}\n\nexport interface CalendarDragState {\n  /** The gesture in flight, or null. */\n  readonly draft: EventDraft | null;\n  /** The rubber-band range while creating, or null. */\n  readonly creating: { start: Instant; endExclusive: Instant; day: PlainDate } | null;\n  /** True while a resize would be refused — the view dims the preview. */\n  readonly invalid: boolean;\n  /** Wire an event chip. `kind` decides which edge, if any, is being moved. */\n  readonly bindEvent: (event: TimedEvent, kind: DragKind) => (node: HTMLElement | null) => void;\n  /** Wire the empty area of a day column, for drag-to-create. */\n  readonly bindCanvas: () => (node: HTMLElement | null) => void;\n  /** The event as it would be if dropped now — for the live preview. */\n  readonly preview: (event: TimedEvent) => TimedEvent;\n  /**\n   * The two questions the edge auto-scroll loop asks. Passed straight to\n   * `attachEdgeAutoScroll` — see its `AutoScrollDriver` for why re-feeding the\n   * point on scroll is the whole reason the second one exists.\n   */\n  readonly getPoint: () => { x: number; y: number } | null;\n  readonly onScrolled: (point: { x: number; y: number }) => void;\n}\n\nexport function useCalendarDrag(options: CalendarDragOptions): CalendarDragState {\n  const { zone, days, snapMinutes, measure, onCommit, onCreate, onAnnounce, disabled } = options;\n  const locale = useUiLocale();\n  const { moveCancelled } = useUiStrings().calendar;\n\n  const [draft, setDraft] = useState<EventDraft | null>(null);\n  const [creating, setCreating] = useState<CalendarDragState[\"creating\"]>(null);\n  const [invalid, setInvalid] = useState(false);\n\n  /* Live values the gesture callbacks read. A gesture outlives several renders,\n     so closing over props directly would leave it acting on the values that\n     existed at pointer-down. */\n  const live = useRef({ zone, days, snapMinutes, measure, onCommit, onCreate, onAnnounce, locale, moveCancelled });\n  live.current = { zone, days, snapMinutes, measure, onCommit, onCreate, onAnnounce, locale, moveCancelled };\n\n  const session = useRef<{\n    columns: ColumnRect[];\n    origin: { event: TimedEvent; kind: DragKind; from: CalendarTarget } | null;\n    anchor: CalendarTarget | null;\n    last: CalendarTarget | null;\n    spoken: string | null;\n    point: { x: number; y: number } | null;\n  }>({ columns: [], origin: null, anchor: null, last: null, spoken: null, point: null });\n\n  const remeasure = useCallback(() => {\n    session.current.columns = live.current.measure();\n  }, []);\n\n  /* The columns move when anything scrolls — including the grid's own\n     auto-scroll — so the snapshot is refreshed rather than trusted. */\n  useEffect(() => {\n    if (!draft && !creating) return;\n    const onScroll = () => remeasure();\n    window.addEventListener(\"scroll\", onScroll, { capture: true, passive: true });\n    return () => window.removeEventListener(\"scroll\", onScroll, { capture: true });\n  }, [draft, creating, remeasure]);\n\n  /* Escape abandons the gesture. Window-level because the handle has pointer\n     capture, not focus, so a keypress never reaches it. */\n  useEffect(() => {\n    if (!draft && !creating) return;\n    const onKey = (e: KeyboardEvent) => {\n      if (e.key !== \"Escape\") return;\n      e.preventDefault();\n      session.current.origin = null;\n      session.current.anchor = null;\n      session.current.last = null;\n      setDraft(null);\n      setCreating(null);\n      setInvalid(false);\n      live.current.onAnnounce?.(live.current.moveCancelled);\n    };\n    window.addEventListener(\"keydown\", onKey);\n    return () => window.removeEventListener(\"keydown\", onKey);\n  }, [draft, creating]);\n\n  const announce = useCallback((target: CalendarTarget) => {\n    const message = describeTarget(target, live.current.zone, live.current.locale);\n    /* ONLY ON A COMMITTED SLOT CHANGE, never per pixel. A live region updating\n       every frame overflows the speech queue and the user hears NOTHING — which\n       is worse than silence, because the region looks like it is working. */\n    if (session.current.spoken === message) return;\n    session.current.spoken = message;\n    live.current.onAnnounce?.(message);\n  }, []);\n\n  /**\n   * Ref callbacks, cached by (event, kind).\n   *\n   * THE IDENTITY HAS TO BE STABLE, and this is not an optimisation — without it\n   * the feature does not work at all. React detaches a ref whose function\n   * identity changed and re-attaches the new one, which here means tearing down\n   * the pointer gesture and building a fresh one. The FIRST thing a gesture does\n   * on activation is `setDraft`; that re-renders; the re-render replaces this\n   * callback; React runs the cleanup; the cleanup releases pointer capture and\n   * removes the listeners. The drag killed itself at the moment it started, and\n   * a browser probe reported \"moved 0px while still held\" for every gesture.\n   *\n   * The entry holds the LATEST event, so a stable callback still acts on fresh\n   * data — the stability is in the function, not in what it closes over.\n   */\n  const bindings = useRef(\n    new Map<\n      string,\n      { event: TimedEvent; kind: DragKind; cb: (node: HTMLElement | null) => void }\n    >(),\n  );\n\n  const makeEventBinding = useCallback(\n    (entry: { event: TimedEvent; kind: DragKind }) => (node: HTMLElement | null) => {\n      if (!node || disabled) return;\n      const event = entry.event;\n      const kind = entry.kind;\n      const detach = attachPointerGesture(node, {\n        onPress: () => {\n          if (event.editable === false) return false;\n          return true;\n        },\n        onActivate: (point) => {\n          session.current.point = point;\n          remeasure();\n          const from = resolveCalendarTarget(point, {\n            zone: live.current.zone,\n            columns: session.current.columns,\n            snapMinutes: live.current.snapMinutes,\n          });\n          if (!from) return;\n          session.current.origin = { event, kind, from };\n          session.current.last = from;\n          session.current.spoken = null;\n          setDraft({ id: event.id, kind, delta: {} });\n        },\n        onMove: (point) => {\n          session.current.point = point;\n          const origin = session.current.origin;\n          if (!origin) return;\n          const hit = resolveCalendarTarget(point, {\n            zone: live.current.zone,\n            columns: session.current.columns,\n            snapMinutes: live.current.snapMinutes,\n          });\n          /* KEEP THE LAST TARGET when the pointer leaves the columns. An event\n             that snapped home every time the finger crossed the gutter would be\n             unusable. */\n          const target = hit ?? session.current.last;\n          if (!target) return;\n          session.current.last = target;\n\n          const result = calendarDragResult(origin, target, live.current.zone);\n          setInvalid(result.invalid !== undefined);\n          setDraft({ id: event.id, kind, delta: result.delta });\n          if (!result.invalid) announce(target);\n        },\n        onRelease: (_point, activated) => {\n          session.current.point = null;\n          /* A DRAG MUST NOT ALSO BE A CLICK, and until this existed it was.\n           *\n           * The browser fires `click` after `pointerup` regardless of how far\n           * the pointer travelled, so every completed drag also opened the\n           * chip's action menu — and once that menu was open it swallowed the\n           * Escape key, so cancelling a drag stopped working. The browser probe\n           * caught it as \"time unchanged\" failing on a gesture that had in fact\n           * committed.\n           *\n           * Swallowed in the CAPTURE phase and removed on the next tick: the\n           * click is dispatched synchronously after `pointerup`, so a listener\n           * added here is in place before it arrives, and one that outlived the\n           * tick would eat the user's next real click. */\n          if (activated) {\n            const swallow = (clickEvent: Event) => {\n              clickEvent.stopPropagation();\n              clickEvent.preventDefault();\n            };\n            node.addEventListener(\"click\", swallow, { capture: true, once: true });\n            setTimeout(() => node.removeEventListener(\"click\", swallow, { capture: true }), 0);\n          }\n          const origin = session.current.origin;\n          session.current.origin = null;\n          setDraft(null);\n          setInvalid(false);\n          if (!activated || !origin) return;\n\n          const target = session.current.last;\n          if (!target) return;\n          const result = calendarDragResult(origin, target, live.current.zone);\n          /* A gesture that changed nothing writes nothing — a click must not\n             produce an update, and neither must a drag that came back. */\n          if (!result.moved || result.invalid) return;\n          live.current.onCommit?.(\n            event,\n            applyCalendarDelta(event, kind, result.delta, live.current.zone),\n          );\n        },\n        onCancel: () => {\n          session.current.point = null;\n          session.current.origin = null;\n          setDraft(null);\n          setInvalid(false);\n        },\n      });\n      return detach as unknown as void;\n    },\n    [announce, disabled, remeasure],\n  );\n\n  const bindEvent = useCallback(\n    (event: TimedEvent, kind: DragKind) => {\n      const key = `${event.id}:${kind}`;\n      let entry = bindings.current.get(key);\n      if (!entry) {\n        entry = { event, kind, cb: () => {} };\n        entry.cb = makeEventBinding(entry);\n        bindings.current.set(key, entry);\n      }\n      /* Refreshed every render; the callback reads it at attach time. */\n      entry.event = event;\n      return entry.cb;\n    },\n    [makeEventBinding],\n  );\n\n  const canvasBinding = useRef<((node: HTMLElement | null) => void) | null>(null);\n\n  const bindCanvasImpl = useCallback(\n    (node: HTMLElement | null) => {\n      if (!node || disabled || !onCreate) return;\n      const detach = attachPointerGesture(node, {\n        onPress: (_point, event) => {\n          /* A press that landed on an existing chip belongs to that chip. */\n          const el = event.target as HTMLElement | null;\n          return !el?.closest(\"button\");\n        },\n        onActivate: (point) => {\n          session.current.point = point;\n          remeasure();\n          const anchor = resolveCalendarTarget(point, {\n            zone: live.current.zone,\n            columns: session.current.columns,\n            snapMinutes: live.current.snapMinutes,\n          });\n          if (!anchor) return;\n          session.current.anchor = anchor;\n          session.current.last = anchor;\n          session.current.spoken = null;\n          setCreating(createdEvent(anchor, anchor));\n        },\n        onMove: (point) => {\n          session.current.point = point;\n          const anchor = session.current.anchor;\n          if (!anchor) return;\n          const hit = resolveCalendarTarget(point, {\n            zone: live.current.zone,\n            columns: session.current.columns,\n            snapMinutes: live.current.snapMinutes,\n          });\n          const target = hit ?? session.current.last;\n          if (!target) return;\n          session.current.last = target;\n          setCreating(createdEvent(anchor, target));\n          announce(target);\n        },\n        onRelease: (_point, activated) => {\n          session.current.point = null;\n          if (activated) {\n            const swallow = (clickEvent: Event) => {\n              clickEvent.stopPropagation();\n              clickEvent.preventDefault();\n            };\n            node.addEventListener(\"click\", swallow, { capture: true, once: true });\n            setTimeout(() => node.removeEventListener(\"click\", swallow, { capture: true }), 0);\n          }\n          const anchor = session.current.anchor;\n          const target = session.current.last;\n          session.current.anchor = null;\n          setCreating(null);\n          if (!activated || !anchor || !target) return;\n          live.current.onCreate?.(createdEvent(anchor, target));\n        },\n        onCancel: () => {\n          session.current.point = null;\n          session.current.anchor = null;\n          setCreating(null);\n        },\n      });\n      return detach as unknown as void;\n    },\n    [announce, disabled, onCreate, remeasure],\n  );\n\n  /* Same stability requirement as the event bindings above. */\n  const bindCanvas = useCallback(() => {\n    if (!canvasBinding.current) canvasBinding.current = bindCanvasImpl;\n    return canvasBinding.current;\n  }, [bindCanvasImpl]);\n\n  /* THE SCROLL LOOP RE-RUNS THE MOVE, it does not merely remeasure. The pointer\n     has not moved and the CONTENT has, so nothing recomputes what the pointer\n     is over unless the same point is fed back through — the grid would\n     otherwise freeze mid-auto-scroll with the preview stuck where it was. */\n  const getPoint = useCallback(() => session.current.point, []);\n  const onScrolled = useCallback(\n    (point: { x: number; y: number }) => {\n      remeasure();\n      const origin = session.current.origin;\n      const anchor = session.current.anchor;\n      const hit = resolveCalendarTarget(point, {\n        zone: live.current.zone,\n        columns: session.current.columns,\n        snapMinutes: live.current.snapMinutes,\n      });\n      const target = hit ?? session.current.last;\n      if (!target) return;\n      session.current.last = target;\n      if (origin) {\n        const result = calendarDragResult(origin, target, live.current.zone);\n        setInvalid(result.invalid !== undefined);\n        setDraft({ id: origin.event.id, kind: origin.kind, delta: result.delta });\n        if (!result.invalid) announce(target);\n      } else if (anchor) {\n        setCreating(createdEvent(anchor, target));\n        announce(target);\n      }\n    },\n    [announce, remeasure],\n  );\n\n  const preview = useCallback(\n    (event: TimedEvent): TimedEvent => {\n      if (!draft || draft.id !== event.id) return event;\n      /* COMPOSED ONTO THE EVENT AS IT IS NOW — see `applyCalendarDelta`. */\n      return applyCalendarDelta(event, draft.kind, draft.delta, zone);\n    },\n    [draft, zone],\n  );\n\n  return { draft, creating, invalid, bindEvent, bindCanvas, preview, getPoint, onScrolled };\n}\n"],"names":["useCalendarDrag","options","zone","days","snapMinutes","measure","onCommit","onCreate","onAnnounce","disabled","locale","useUiLocale","moveCancelled","useUiStrings","draft","setDraft","useState","creating","setCreating","invalid","setInvalid","live","useRef","session","remeasure","useCallback","useEffect","onScroll","onKey","e","announce","target","message","describeTarget","bindings","makeEventBinding","entry","node","event","kind","attachPointerGesture","point","from","resolveCalendarTarget","origin","result","calendarDragResult","_point","activated","swallow","clickEvent","applyCalendarDelta","bindEvent","key","canvasBinding","bindCanvasImpl","anchor","createdEvent","bindCanvas","getPoint","onScrolled","preview"],"mappings":"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"}

package/dist/components/calendar/use-event-keyboard.js

@@ -0,0 +1,87 @@
+import { useState as I, useRef as K, useCallback as g } from "react";
+import { describeTarget as L } from "../../lib/calendar/drag.js";
+import { useUiLocale as R, useUiStrings as v } from "../../lib/i18n/provider.js";
+import { addDuration as y } from "../../lib/time/zone.js";
+function T(M) {
+  const { zone: n, snapMinutes: b, days: x, onCommit: S, onAnnounce: s } = M, w = R(), o = v().calendar, [u, D] = I(null), [m, c] = I({}), p = K(null), E = g(
+    (r, t) => {
+      const e = x[Math.max(0, Math.min(x.length - 1, t))];
+      e && s?.(
+        L({ day: e, instant: r.start }, n, w)
+      );
+    },
+    [x, w, s, n]
+  ), U = g(
+    (r) => {
+      if (u !== r.id) return r;
+      const t = y(n, r.start, m);
+      return { ...r, start: t, endExclusive: t + (r.endExclusive - r.start) };
+    },
+    [m, u, n]
+  ), C = g(
+    (r, t) => {
+      const e = u === r.id;
+      if (t.key === " " || t.key === "Spacebar") {
+        if (t.preventDefault(), !e) {
+          p.current = r, D(r.id), c({}), s?.(o.grabbed(r.title));
+          return;
+        }
+        k(r);
+        return;
+      }
+      if (!e) return;
+      if (t.key === "Escape") {
+        t.preventDefault(), D(null), c({}), p.current = null, s?.(o.returned(r.title));
+        return;
+      }
+      if (t.key === "Enter") {
+        t.preventDefault(), k(r);
+        return;
+      }
+      const i = (l) => {
+        t.preventDefault(), c((d) => {
+          const a = { ...d, minutes: (d.minutes ?? 0) + l }, f = y(n, r.start, a);
+          return E({ ...r, start: f, endExclusive: f }, A(a)), a;
+        });
+      }, h = (l) => {
+        t.preventDefault(), c((d) => {
+          const a = { ...d, days: (d.days ?? 0) + l }, f = y(n, r.start, a);
+          return E({ ...r, start: f, endExclusive: f }, A(a)), a;
+        });
+      };
+      switch (t.key) {
+        case "ArrowUp":
+          return i(-b);
+        case "ArrowDown":
+          return i(b);
+        case "ArrowLeft":
+          return h(-1);
+        case "ArrowRight":
+          return h(1);
+        default:
+          return;
+      }
+      function A(l) {
+        return l.days ?? 0;
+      }
+    },
+    [o, u, s, b, E, n]
+  );
+  function k(r) {
+    const t = p.current ?? r, e = y(n, t.start, m), i = {
+      ...t,
+      start: e,
+      endExclusive: e + (t.endExclusive - t.start)
+    };
+    if (D(null), c({}), p.current = null, i.start === t.start) {
+      s?.(o.droppedInPlace(t.title));
+      return;
+    }
+    S(t, i), s?.(o.moved(t.title));
+  }
+  return { grabbedId: u, delta: m, onKeyDown: C, preview: U };
+}
+export {
+  T as useEventKeyboard
+};
+//# sourceMappingURL=use-event-keyboard.js.map

package/dist/components/calendar/use-event-keyboard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-event-keyboard.js","sources":["../../../src/components/calendar/use-event-keyboard.ts"],"sourcesContent":["import { useCallback, useRef, useState, type KeyboardEvent } from \"react\";\nimport { addDuration, type CalendarDuration, type PlainDate, type TimeZone } from \"@/lib/time\";\nimport type { TimedEvent } from \"@/lib/calendar/types\";\nimport { describeTarget } from \"@/lib/calendar/drag\";\nimport { useUiLocale, useUiStrings } from \"@/lib/i18n\";\n\n/* ----------------------------------------------------------------------------\n   KEYBOARD GRABBED-MODE — the OPTIONAL layer, and it is optional on purpose.\n\n   THE POINTER MENU IS TIER ONE AND THIS IS TIER TWO. WCAG 2.2 SC 2.5.7 asks for\n   a single-pointer, non-dragging route to every drag outcome, and it is\n   assessed independently of 2.1.1 — so this file satisfies 2.1.1 and does\n   nothing at all for 2.5.7. Shipping it INSTEAD of `EventActions` would fail AA\n   while feeling like the harder, more thorough piece of work.\n\n   It is here because for a sighted keyboard user it is genuinely faster than\n   three selects, and because the grid already knows how to move an event by a\n   delta. It is not here because it is the accessible path.\n\n   NO Ctrl+Alt / Ctrl+Option ANYWHERE. That is VoiceOver's own modifier, and the\n   single product that ships keyboard event-moving — Apple Calendar — uses it,\n   which makes its shortcut unusable by the users most likely to need it.\n   -------------------------------------------------------------------------- */\n\nexport interface EventKeyboardOptions {\n  readonly zone: TimeZone;\n  /** Same step the drag snaps to, so both paths reach the same positions. */\n  readonly snapMinutes: number;\n  /** Days in view, for the day-change bounds and for the announcement. */\n  readonly days: readonly PlainDate[];\n  readonly onCommit: (event: TimedEvent, next: TimedEvent) => void;\n  readonly onAnnounce?: (message: string) => void;\n}\n\nexport interface EventKeyboardState {\n  /** The event currently held, or null. */\n  readonly grabbedId: string | null;\n  /** The pending delta while held. */\n  readonly delta: CalendarDuration;\n  /** Attach to an event chip. */\n  readonly onKeyDown: (event: TimedEvent, e: KeyboardEvent<HTMLElement>) => void;\n  /** The event as it would be if dropped now. */\n  readonly preview: (event: TimedEvent) => TimedEvent;\n}\n\nexport function useEventKeyboard(options: EventKeyboardOptions): EventKeyboardState {\n  const { zone, snapMinutes, days, onCommit, onAnnounce } = options;\n  const locale = useUiLocale();\n  const announcements = useUiStrings().calendar;\n\n  const [grabbedId, setGrabbedId] = useState<string | null>(null);\n  const [delta, setDelta] = useState<CalendarDuration>({});\n  /* The event as it was when grabbed, so Escape can restore without depending\n     on the consumer having kept it. */\n  const held = useRef<TimedEvent | null>(null);\n\n  const speak = useCallback(\n    (next: TimedEvent, dayIndexHint: number) => {\n      const day = days[Math.max(0, Math.min(days.length - 1, dayIndexHint))];\n      if (!day) return;\n      onAnnounce?.(\n        describeTarget({ dayIndex: dayIndexHint, day, instant: next.start }, zone, locale),\n      );\n    },\n    [days, locale, onAnnounce, zone],\n  );\n\n  const preview = useCallback(\n    (event: TimedEvent): TimedEvent => {\n      if (grabbedId !== event.id) return event;\n      const start = addDuration(zone, event.start, delta);\n      return { ...event, start, endExclusive: start + (event.endExclusive - event.start) };\n    },\n    [delta, grabbedId, zone],\n  );\n\n  const onKeyDown = useCallback(\n    (event: TimedEvent, e: KeyboardEvent<HTMLElement>) => {\n      const grabbed = grabbedId === event.id;\n\n      /* SPACE, NOT ENTER, PICKS UP. Enter on a chip is \"open it\" everywhere else\n         in this package and in every calendar product; overloading it would\n         make the primary action unreachable for a keyboard user. */\n      if (e.key === \" \" || e.key === \"Spacebar\") {\n        e.preventDefault();\n        if (!grabbed) {\n          held.current = event;\n          setGrabbedId(event.id);\n          setDelta({});\n          onAnnounce?.(announcements.grabbed(event.title));\n          return;\n        }\n        /* A second Space drops it — the same key that picked it up, which is\n           what every grabbed-mode implementation that survived user testing\n           does. */\n        commit(event);\n        return;\n      }\n\n      if (!grabbed) return;\n\n      if (e.key === \"Escape\") {\n        e.preventDefault();\n        setGrabbedId(null);\n        setDelta({});\n        held.current = null;\n        /* ANNOUNCED, and the announcement says the event went BACK. \"Cancelled\"\n           alone leaves the user unsure whether the move happened. */\n        onAnnounce?.(announcements.returned(event.title));\n        return;\n      }\n\n      if (e.key === \"Enter\") {\n        e.preventDefault();\n        commit(event);\n        return;\n      }\n\n      const step = (minutes: number) => {\n        e.preventDefault();\n        setDelta((current: CalendarDuration) => {\n          const next = { ...current, minutes: (current.minutes ?? 0) + minutes };\n          const moved = addDuration(zone, event.start, next);\n          speak({ ...event, start: moved, endExclusive: moved }, dayIndexOf(next));\n          return next;\n        });\n      };\n      const page = (dayStep: number) => {\n        e.preventDefault();\n        setDelta((current: CalendarDuration) => {\n          const next = { ...current, days: (current.days ?? 0) + dayStep };\n          const moved = addDuration(zone, event.start, next);\n          speak({ ...event, start: moved, endExclusive: moved }, dayIndexOf(next));\n          return next;\n        });\n      };\n\n      switch (e.key) {\n        case \"ArrowUp\":\n          return step(-snapMinutes);\n        case \"ArrowDown\":\n          return step(snapMinutes);\n        case \"ArrowLeft\":\n          return page(-1);\n        case \"ArrowRight\":\n          return page(1);\n        default:\n          return;\n      }\n\n      function dayIndexOf(d: CalendarDuration): number {\n        return d.days ?? 0;\n      }\n    },\n    [announcements, grabbedId, onAnnounce, snapMinutes, speak, zone],\n  );\n\n  function commit(event: TimedEvent): void {\n    const current = held.current ?? event;\n    const start = addDuration(zone, current.start, delta);\n    const next: TimedEvent = {\n      ...current,\n      start,\n      endExclusive: start + (current.endExclusive - current.start),\n    };\n    setGrabbedId(null);\n    setDelta({});\n    held.current = null;\n    /* A grab that never moved writes nothing — Space then Space must not\n       produce an update, exactly as a click must not. */\n    if (next.start === current.start) {\n      onAnnounce?.(announcements.droppedInPlace(current.title));\n      return;\n    }\n    onCommit(current, next);\n    onAnnounce?.(announcements.moved(current.title));\n  }\n\n  return { grabbedId, delta, onKeyDown, preview };\n}\n"],"names":["useEventKeyboard","options","zone","snapMinutes","days","onCommit","onAnnounce","locale","useUiLocale","announcements","useUiStrings","grabbedId","setGrabbedId","useState","delta","setDelta","held","useRef","speak","useCallback","next","dayIndexHint","day","describeTarget","preview","event","start","addDuration","onKeyDown","e","grabbed","commit","step","minutes","current","moved","dayIndexOf","page","dayStep","d"],"mappings":"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"}

package/dist/components/calendar/use-grid-navigation.js

@@ -0,0 +1,79 @@
+import { useState as D, useRef as F, useCallback as l } from "react";
+import { isSameDate as w, addMonths as p, addDays as u, startOfWeek as C } from "../../lib/time/plain.js";
+import { comparePlainDate as P } from "../../lib/time/plain.js";
+function M(r, t, n, a) {
+  const o = a.ctrl || a.meta;
+  switch (r) {
+    case "ArrowLeft":
+      return u(t, -1);
+    case "ArrowRight":
+      return u(t, 1);
+    case "ArrowUp":
+      return u(t, -7);
+    case "ArrowDown":
+      return u(t, 7);
+    case "Home":
+      return o ? { year: t.year, month: t.month, day: 1 } : C(t, n);
+    case "End":
+      return o ? k(t) : u(C(t, n), 6);
+    case "PageUp":
+      return p(t, a.shift ? -12 : -1);
+    case "PageDown":
+      return p(t, a.shift ? 12 : 1);
+    default:
+      return null;
+  }
+}
+function k(r) {
+  const t = /* @__PURE__ */ new Date(0);
+  return t.setUTCFullYear(r.year, r.month, 0), { year: t.getUTCFullYear(), month: t.getUTCMonth() + 1, day: t.getUTCDate() };
+}
+function x(r, t) {
+  const { month: n, weekStartsOn: a, onMonthChange: o } = t, [f, s] = D(r), [c, i] = D(!1), m = F(f), h = l(
+    (e) => {
+      w(m.current, e) || (m.current = e, s(e), (e.year !== n.year || e.month !== n.month) && o?.(e));
+    },
+    [n.year, n.month, o]
+  ), g = l(
+    (e) => {
+      if (c) {
+        e.key === "Escape" && (e.preventDefault(), i(!1));
+        return;
+      }
+      if (e.key === "Enter" || e.key === "F2") {
+        e.preventDefault(), i(!0);
+        return;
+      }
+      const y = M(e.key, f, a, {
+        ctrl: e.ctrlKey,
+        shift: e.shiftKey,
+        meta: e.metaKey
+      });
+      y && (e.preventDefault(), h(y));
+    },
+    [f, c, h, a]
+  );
+  return {
+    focusedDay: f,
+    setFocusedDay: h,
+    insideCell: c,
+    enterCell: l(() => i(!0), []),
+    leaveCell: l(() => i(!1), []),
+    onKeyDown: g
+  };
+}
+function A(r, t, n, a) {
+  const o = (s) => s.year === t.year && s.month === t.month;
+  return a && r.some((s) => w(s, a)) ? a : n && o(n) ? n : r.find(o) ?? r[0];
+}
+function T(r, t) {
+  return r.year === t.year && r.month === t.month;
+}
+export {
+  P as comparePlainDate,
+  A as initialFocusDay,
+  T as isInMonth,
+  M as nextDayForKey,
+  x as useGridNavigation
+};
+//# sourceMappingURL=use-grid-navigation.js.map

package/dist/components/calendar/use-grid-navigation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-grid-navigation.js","sources":["../../../src/components/calendar/use-grid-navigation.ts"],"sourcesContent":["import { useCallback, useRef, useState, type KeyboardEvent } from \"react\";\nimport {\n  addDays,\n  addMonths,\n  comparePlainDate,\n  isSameDate,\n  startOfWeek,\n  type PlainDate,\n} from \"@/lib/time\";\n\n/* ----------------------------------------------------------------------------\n   APG GRID NAVIGATION FOR A MONTH.\n\n   ROVING TABINDEX ON THE CELL — not `aria-activedescendant`, and not a button\n   inside the cell. Both alternatives are the two most repeated screen-reader\n   defects in this widget class:\n\n     `aria-activedescendant` is known to fail on grids with VoiceOver, and it\n     forfeits scroll-into-view, which the user agent gives roving tabindex for\n     free.\n\n     A focusable control INSIDE a `gridcell` — which is the shape React Aria's\n     calendar ships — makes NVDA drop to browse mode, so the arrow keys read the\n     cell's label character by character instead of moving between cells\n     (nvda#8395; #13392 is still open). The reporter noted it does NOT happen\n     when the `td` itself carries the tabindex. On macOS, VoiceOver skips the\n     nested button in the rotor, so the date cannot be selected at all.\n\n   NO `role=\"application\"`. Google uses it and consequently has to instruct\n   users to turn off browse mode, and it buys nothing that a focused control\n   does not already provide.\n\n   THE TWO-LEVEL MODEL. Arrows move between DAYS. `Enter` or `F2` enters a cell\n   and focuses its first event; `Escape` leaves and restores grid navigation.\n   That is APG's shape for a grid whose cells contain widgets, and it is what\n   keeps a month with fifty events from being fifty tab stops.\n\n   ONE COLLISION AVOIDED DELIBERATELY: no `Ctrl+Alt`/`Ctrl+Option` binding\n   anywhere. That is VoiceOver's own modifier, and the single product that ships\n   keyboard event-moving — Apple Calendar — uses it, which means its shortcut is\n   unusable by the users most likely to need a keyboard.\n   -------------------------------------------------------------------------- */\n\nexport interface GridNavigationOptions {\n  /** Any day in the displayed month. Used to clamp paging. */\n  readonly month: PlainDate;\n  readonly weekStartsOn: number;\n  /** Called when navigation lands outside the displayed month. */\n  readonly onMonthChange?: (month: PlainDate) => void;\n}\n\nexport interface GridNavigation {\n  /** The day that currently holds `tabIndex={0}`. Exactly one, always. */\n  readonly focusedDay: PlainDate;\n  readonly setFocusedDay: (day: PlainDate) => void;\n  /** True while the user is INSIDE a cell, interacting with its events. */\n  readonly insideCell: boolean;\n  readonly enterCell: () => void;\n  readonly leaveCell: () => void;\n  /** Attach to the table. Returns true when it consumed the event. */\n  readonly onKeyDown: (event: KeyboardEvent<HTMLElement>) => void;\n}\n\n/**\n * Which day a key moves to, or `null` when the key is not ours.\n *\n * PURE, AND EXPORTED, so the whole key map is testable without a DOM. Every\n * binding below is APG-normative; the file header records the two it\n * deliberately does not use.\n */\nexport function nextDayForKey(\n  key: string,\n  current: PlainDate,\n  weekStartsOn: number,\n  modifiers: { ctrl: boolean; shift: boolean; meta: boolean },\n): PlainDate | null {\n  const ctrlOrMeta = modifiers.ctrl || modifiers.meta;\n  switch (key) {\n    case \"ArrowLeft\":\n      return addDays(current, -1);\n    case \"ArrowRight\":\n      return addDays(current, 1);\n    case \"ArrowUp\":\n      return addDays(current, -7);\n    case \"ArrowDown\":\n      return addDays(current, 7);\n    case \"Home\":\n      /* Ctrl+Home is the first day of the MONTH; bare Home is the first day of\n         the week row, which is what \"Home\" means everywhere else in a grid. */\n      return ctrlOrMeta\n        ? { year: current.year, month: current.month, day: 1 }\n        : startOfWeek(current, weekStartsOn);\n    case \"End\":\n      return ctrlOrMeta\n        ? lastDayOfMonth(current)\n        : addDays(startOfWeek(current, weekStartsOn), 6);\n    case \"PageUp\":\n      return addMonths(current, modifiers.shift ? -12 : -1);\n    case \"PageDown\":\n      return addMonths(current, modifiers.shift ? 12 : 1);\n    default:\n      return null;\n  }\n}\n\nfunction lastDayOfMonth(date: PlainDate): PlainDate {\n  const d = new Date(0);\n  d.setUTCFullYear(date.year, date.month, 0);\n  return { year: d.getUTCFullYear(), month: d.getUTCMonth() + 1, day: d.getUTCDate() };\n}\n\nexport function useGridNavigation(\n  initialDay: PlainDate,\n  options: GridNavigationOptions,\n): GridNavigation {\n  const { month, weekStartsOn, onMonthChange } = options;\n  const [focusedDay, setFocusedDayState] = useState<PlainDate>(initialDay);\n  const [insideCell, setInsideCell] = useState(false);\n\n  /* IDEMPOTENT, AND THAT IS NOT AN OPTIMISATION. Two things call this for a\n     single keypress: the key handler moves the focused day, and the newly\n     focused cell's own `onFocus` reports where focus landed. Without the guard\n     the second call is a no-op for the STATE — same value — but still fires\n     `onMonthChange`, so a consumer paging on that callback advanced two months\n     per arrow press. Found by a test asserting the call count rather than the\n     resulting value, which is the only way that defect is visible. */\n  const focusedRef = useRef<PlainDate>(focusedDay);\n  const setFocusedDay = useCallback(\n    (day: PlainDate) => {\n      if (isSameDate(focusedRef.current, day)) return;\n      focusedRef.current = day;\n      setFocusedDayState(day);\n      /* Navigation that leaves the displayed month PAGES the month rather than\n         refusing to move. A grid whose arrow keys stop at the edge strands a\n         keyboard user on the 1st with no way forward that a mouse user does not\n         have — and the trailing days of the previous month are visible on\n         screen, so refusing to enter them contradicts what is drawn. */\n      if (day.year !== month.year || day.month !== month.month) onMonthChange?.(day);\n    },\n    [month.year, month.month, onMonthChange],\n  );\n\n  const onKeyDown = useCallback(\n    (event: KeyboardEvent<HTMLElement>) => {\n      if (insideCell) {\n        if (event.key === \"Escape\") {\n          event.preventDefault();\n          setInsideCell(false);\n        }\n        /* Everything else belongs to whatever is focused inside the cell.\n           Swallowing arrows here would break a menu or a text field in an\n           event's own popover. */\n        return;\n      }\n\n      if (event.key === \"Enter\" || event.key === \"F2\") {\n        event.preventDefault();\n        setInsideCell(true);\n        return;\n      }\n\n      const next = nextDayForKey(event.key, focusedDay, weekStartsOn, {\n        ctrl: event.ctrlKey,\n        shift: event.shiftKey,\n        meta: event.metaKey,\n      });\n      if (!next) return;\n\n      /* `preventDefault` only once the key is genuinely ours. Doing it before\n         the lookup swallows Tab, and a grid you cannot Tab out of is a trap. */\n      event.preventDefault();\n      setFocusedDay(next);\n    },\n    [focusedDay, insideCell, setFocusedDay, weekStartsOn],\n  );\n\n  return {\n    focusedDay,\n    setFocusedDay,\n    insideCell,\n    enterCell: useCallback(() => setInsideCell(true), []),\n    leaveCell: useCallback(() => setInsideCell(false), []),\n    onKeyDown,\n  };\n}\n\n/**\n * The day that should carry `tabIndex={0}` when the grid has never been used.\n *\n * EXACTLY ONE CELL IS TABBABLE, ALWAYS — that is the roving-tabindex contract\n * and the thing a probe should assert after every keypress. Preference order:\n * the selected day, else today if the month contains it, else the 1st. Landing\n * on today is what a user expects; landing on the 1st of a month they paged to\n * is what they expect there.\n */\nexport function initialFocusDay(\n  days: readonly PlainDate[],\n  month: PlainDate,\n  today: PlainDate | undefined,\n  selected: PlainDate | undefined,\n): PlainDate {\n  const inMonth = (d: PlainDate) => d.year === month.year && d.month === month.month;\n  if (selected && days.some((d) => isSameDate(d, selected))) return selected;\n  if (today && inMonth(today)) return today;\n  const first = days.find(inMonth);\n  /* `days` always covers the whole month by construction, so the fallback is\n     unreachable — it exists so the signature has no null, rather than as a\n     branch anyone should rely on. */\n  return first ?? days[0];\n}\n\n/** Whether `day` belongs to the displayed month rather than a neighbour. */\nexport function isInMonth(day: PlainDate, month: PlainDate): boolean {\n  return day.year === month.year && day.month === month.month;\n}\n\n/** Ordering helper for consumers rendering their own event lists. */\nexport { comparePlainDate };\n"],"names":["nextDayForKey","key","current","weekStartsOn","modifiers","ctrlOrMeta","addDays","startOfWeek","lastDayOfMonth","addMonths","date","d","useGridNavigation","initialDay","options","month","onMonthChange","focusedDay","setFocusedDayState","useState","insideCell","setInsideCell","focusedRef","useRef","setFocusedDay","useCallback","day","isSameDate","onKeyDown","event","next","initialFocusDay","days","today","selected","inMonth","isInMonth"],"mappings":"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"}

package/dist/components/calendar/use-now.js

@@ -0,0 +1,27 @@
+import { useState as d, useEffect as f } from "react";
+function v(c = {}) {
+  const { resolutionMs: i = 6e4, enabled: o = !0, fixed: t } = c, [l, r] = d(() => t ?? Date.now());
+  return f(() => {
+    if (t !== void 0) {
+      r(t);
+      return;
+    }
+    if (!o) return;
+    let e;
+    const n = () => {
+      const u = Date.now();
+      r(u);
+      const a = i - u % i + 1;
+      e = setTimeout(n, a);
+    }, s = () => {
+      document.visibilityState === "visible" && (e !== void 0 && clearTimeout(e), n());
+    };
+    return n(), document.addEventListener("visibilitychange", s), () => {
+      e !== void 0 && clearTimeout(e), document.removeEventListener("visibilitychange", s);
+    };
+  }, [o, t, i]), l;
+}
+export {
+  v as useNow
+};
+//# sourceMappingURL=use-now.js.map