panelui-native 0.22.6 → 0.28.1

package/lib/module/utils/chart.js

@@ -0,0 +1,279 @@
+"use strict";
+
+/**
+ * The maths every chart shares.
+ *
+ * Scales, monotone tangents and path building, in one place because four
+ * charts need them and a copy per chart is four chances for two charts to
+ * disagree about where a point goes. A line and an area drawn from different
+ * code do not lie on top of each other, and that is exactly the pair most
+ * often drawn together.
+ *
+ * Everything here is a worklet. The paths are rebuilt on the UI thread on
+ * every frame a domain is tweening, so none of it can be allowed to need the
+ * JS thread — which also rules out reaching for a charting dependency, since
+ * that is the one thing none of them are written to survive.
+ */
+
+import { useCSSVariable } from 'uniwind';
+
+/** Only reached if the theme CSS was never imported. */
+const FALLBACK_SERIES = ['#3b82f6', '#10b981', '#f59e0b', '#8b5cf6', '#ec4899'];
+
+/** Which of the five chart tokens a series takes. */
+
+/**
+ * A series' colour: an explicit one, else the `--color-chart-*` token.
+ *
+ * Shared so every chart draws its first series in the same colour. Two charts
+ * on one screen disagreeing about what "series one" looks like is the kind of
+ * thing nobody reports and everybody notices.
+ */
+export function useSeriesColor(explicit, index) {
+  const token = useCSSVariable(`--color-chart-${index}`);
+  return explicit ?? (typeof token === 'string' ? token : FALLBACK_SERIES[index - 1]);
+}
+
+/** `12.4k` rather than `12400` — a readout has one line to say it in. */
+export function compactNumber(value) {
+  const abs = Math.abs(value);
+  if (abs >= 1_000_000) return `${(value / 1_000_000).toFixed(1)}M`;
+  if (abs >= 1_000) return `${(value / 1_000).toFixed(1)}k`;
+  return Number.isInteger(value) ? String(value) : value.toFixed(1);
+}
+
+/** The drawable box inside a chart, after its padding is taken off. */
+
+/** A point's x, spreading `total` of them evenly across the plot. */
+export function xOf(index, total, plot) {
+  'worklet';
+
+  if (total <= 1) return plot.left + plot.width / 2;
+  return plot.left + plot.width * index / (total - 1);
+}
+
+/** A value's y, with `min` at the bottom of the plot and `max` at the top. */
+export function yOf(value, plot, min, max) {
+  'worklet';
+
+  const span = max - min || 1;
+  return plot.top + plot.height - (value - min) / span * plot.height;
+}
+
+/** The centre of the `index`th of `total` bands, as used for bars and columns. */
+export function bandOf(index, total, plot) {
+  'worklet';
+
+  if (total <= 0) return plot.left + plot.width / 2;
+  const width = plot.width / total;
+  return plot.left + width * (index + 0.5);
+}
+
+/**
+ * Monotone cubic tangents.
+ *
+ * Written out rather than taken from a charting dependency, because it is forty
+ * lines and it has to run inside a worklet.
+ *
+ * Monotone is the right default for a time series. A plain cubic spline
+ * overshoots between points, so a series that never goes below zero draws a dip
+ * under the axis between two low values — a shape that is not in the data. This
+ * one cannot, because the tangent at each point is clamped against the slopes
+ * either side of it, and a local peak or trough is given a flat one.
+ */
+export function tangents(xs, ys) {
+  'worklet';
+
+  const n = xs.length;
+  const slopes = [];
+  for (let i = 0; i < n - 1; i += 1) {
+    slopes.push((ys[i + 1] - ys[i]) / (xs[i + 1] - xs[i] || 1));
+  }
+  const result = new Array(n).fill(0);
+  result[0] = slopes[0] ?? 0;
+  result[n - 1] = slopes[n - 2] ?? 0;
+  for (let i = 1; i < n - 1; i += 1) {
+    const previous = slopes[i - 1];
+    const next = slopes[i];
+    result[i] = previous * next <= 0 ? 0 : (previous + next) / 2;
+  }
+
+  // Fritsch–Carlson: pull any tangent back inside the circle of radius 3, which
+  // is the condition for the segment to stay monotone.
+  for (let i = 0; i < n - 1; i += 1) {
+    const slope = slopes[i];
+    if (slope === 0) {
+      result[i] = 0;
+      result[i + 1] = 0;
+      continue;
+    }
+    const a = result[i] / slope;
+    const b = result[i + 1] / slope;
+    const magnitude = Math.sqrt(a * a + b * b);
+    if (magnitude > 3) {
+      result[i] = 3 / magnitude * a * slope;
+      result[i + 1] = 3 / magnitude * b * slope;
+    }
+  }
+  return result;
+}
+
+/** How a series is joined between its points. */
+
+/** Points, split at the gaps — a null breaks the series rather than crossing it. */
+export function runsOf(values, plot, min, max, /** Baselines to stack each point on top of, for a stacked area. */
+baselines) {
+  'worklet';
+
+  const runs = [];
+  let run = [];
+  for (let i = 0; i < values.length; i += 1) {
+    const value = values[i];
+    if (value === null || value === undefined) {
+      if (run.length) runs.push(run);
+      run = [];
+      continue;
+    }
+    const stacked = value + (baselines?.[i] ?? 0);
+    run.push({
+      x: xOf(i, values.length, plot),
+      y: yOf(stacked, plot, min, max)
+    });
+  }
+  if (run.length) runs.push(run);
+  return runs;
+}
+
+/** One unbroken run of points as a path, curved or straight. */
+export function segment(points, curve) {
+  'worklet';
+
+  if (!points.length) return '';
+  if (points.length < 3 || curve === 'linear') {
+    return points.map((p, i) => `${i === 0 ? 'M' : 'L'}${p.x},${p.y}`).join(' ');
+  }
+  const xs = points.map(p => p.x);
+  const ys = points.map(p => p.y);
+  const ms = tangents(xs, ys);
+  let d = `M${xs[0]},${ys[0]}`;
+  for (let i = 0; i < points.length - 1; i += 1) {
+    const dx = (xs[i + 1] - xs[i]) / 3;
+    d += ` C${xs[i] + dx},${ys[i] + ms[i] * dx} ${xs[i + 1] - dx},${ys[i + 1] - ms[i + 1] * dx} ${xs[i + 1]},${ys[i + 1]}`;
+  }
+  return d;
+}
+
+/** A series as a stroked line. Flat down the middle while it is still loading. */
+export function linePath(values, plot, min, max, curve, loading, baselines) {
+  'worklet';
+
+  if (loading || plot.width <= 0) {
+    // Flat down the middle: the shape the skeleton holds, and the shape the
+    // real series grows out of once the data arrives.
+    const y = plot.top + plot.height / 2;
+    return `M${plot.left},${y} L${plot.left + plot.width},${y}`;
+  }
+  return runsOf(values, plot, min, max, baselines).map(run => segment(run, curve)).join(' ');
+}
+
+/**
+ * A series as a filled area.
+ *
+ * `floors` is what makes a stack: without it every run is closed against the
+ * bottom of the plot, and with it each run is closed against the series below,
+ * so the bands sit on each other rather than overlapping. The floor is walked
+ * backwards because the fill has to trace its underside right to left to close.
+ */
+export function areaPath(values, plot, min, max, curve, loading, baselines) {
+  'worklet';
+
+  if (loading || plot.width <= 0) return '';
+  const bottom = plot.top + plot.height;
+  const runs = runsOf(values, plot, min, max, baselines);
+  if (!baselines) {
+    return runs.map(run => {
+      const top = segment(run, curve);
+      if (!top) return '';
+      const first = run[0];
+      const last = run[run.length - 1];
+      return `${top} L${last.x},${bottom} L${first.x},${bottom} Z`;
+    }).join(' ');
+  }
+
+  // Stacked: the underside is the baseline itself, drawn as its own curve so
+  // the two edges of a band meet cleanly at both ends.
+  const floors = runsOf(values.map(value => value === null || value === undefined ? null : 0), plot, min, max, baselines);
+  return runs.map((run, index) => {
+    const top = segment(run, curve);
+    const floor = floors[index];
+    if (!top || !floor?.length) return '';
+    const under = segment([...floor].reverse(), curve).replace('M', 'L');
+    return `${top} ${under} Z`;
+  }).join(' ');
+}
+
+/**
+ * A rounded rectangle, built as a path rather than drawn as a `Rect`.
+ *
+ * A bar is rounded on the end it grows towards and square on the end it grows
+ * from, so it reads as sitting on the axis rather than floating above it —
+ * which `rx` cannot express, since it rounds all four corners or none.
+ */
+export function barPath(x, y, width, height, radius, /** Which end is the growing one. */
+towards) {
+  'worklet';
+
+  if (width <= 0 || height <= 0) return '';
+  const r = Math.max(0, Math.min(radius, width / 2, height / 2));
+  const right = x + width;
+  const bottom = y + height;
+  if (towards === 'up') {
+    return `M${x},${bottom}L${x},${y + r}Q${x},${y} ${x + r},${y}` + `L${right - r},${y}Q${right},${y} ${right},${y + r}L${right},${bottom}Z`;
+  }
+  if (towards === 'down') {
+    return `M${x},${y}L${x},${bottom - r}Q${x},${bottom} ${x + r},${bottom}` + `L${right - r},${bottom}Q${right},${bottom} ${right},${bottom - r}L${right},${y}Z`;
+  }
+  if (towards === 'right') {
+    return `M${x},${y}L${right - r},${y}Q${right},${y} ${right},${y + r}` + `L${right},${bottom - r}Q${right},${bottom} ${right - r},${bottom}L${x},${bottom}Z`;
+  }
+  return `M${right},${y}L${x + r},${y}Q${x},${y} ${x},${y + r}` + `L${x},${bottom - r}Q${x},${bottom} ${x + r},${bottom}L${right},${bottom}Z`;
+}
+
+/**
+ * An arc of a circle, as a path.
+ *
+ * Angles are in turns from twelve o'clock, clockwise, because that is how a
+ * ring chart is described — "sixty percent of the way round" — and converting
+ * at every call site is where the sign errors live.
+ */
+export function arcPath(cx, cy, radius, from, to) {
+  'worklet';
+
+  const sweep = to - from;
+  if (radius <= 0 || sweep <= 0) return '';
+
+  // A full turn cannot be drawn as one arc — start and end are the same point,
+  // and the renderer draws nothing rather than everything. Two halves can.
+  if (sweep >= 1) {
+    const top = `${cx},${cy - radius}`;
+    const bottomPoint = `${cx},${cy + radius}`;
+    return `M${top}A${radius},${radius} 0 0 1 ${bottomPoint}` + `A${radius},${radius} 0 0 1 ${top}`;
+  }
+  const angle = turn => (turn - 0.25) * Math.PI * 2;
+  const x1 = cx + radius * Math.cos(angle(from));
+  const y1 = cy + radius * Math.sin(angle(from));
+  const x2 = cx + radius * Math.cos(angle(to));
+  const y2 = cy + radius * Math.sin(angle(to));
+  return `M${x1},${y1}A${radius},${radius} 0 ${sweep > 0.5 ? 1 : 0} 1 ${x2},${y2}`;
+}
+
+/** The numbers of one column, with anything unusable left as a gap. */
+export function columnValues(data, key) {
+  'worklet';
+
+  return data.map(row => {
+    const value = row[key];
+    return typeof value === 'number' && !Number.isNaN(value) ? value : null;
+  });
+}
+//# sourceMappingURL=chart.js.map

package/lib/module/utils/chart.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["useCSSVariable","FALLBACK_SERIES","useSeriesColor","explicit","index","token","compactNumber","value","abs","Math","toFixed","Number","isInteger","String","xOf","total","plot","left","width","yOf","min","max","span","top","height","bandOf","tangents","xs","ys","n","length","slopes","i","push","result","Array","fill","previous","next","slope","a","b","magnitude","sqrt","runsOf","values","baselines","runs","run","undefined","stacked","x","y","segment","points","curve","map","p","join","ms","d","dx","linePath","loading","areaPath","bottom","first","last","floors","floor","under","reverse","replace","barPath","radius","towards","r","right","arcPath","cx","cy","from","to","sweep","bottomPoint","angle","turn","PI","x1","cos","y1","sin","x2","y2","columnValues","data","key","row","isNaN"],"sourceRoot":"../../../src","sources":["utils/chart.ts"],"mappings":"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","ignoreList":[]}

package/lib/module/utils/date.js

@@ -0,0 +1,386 @@
+"use strict";
+
+/**
+ * Date helpers for the calendar.
+ *
+ * No date library. Everything a month grid needs is arithmetic on `Date`, and
+ * a dependency that ships a full timezone database to render seven columns is
+ * a poor trade for a library whose whole runtime is three small packages.
+ *
+ * Two rules hold throughout:
+ *
+ * - **Days are compared at local midnight.** A `Date` carries a time, and two
+ *   values on the same day are not equal unless that time is stripped. Every
+ *   comparison here goes through `startOfDay`.
+ * - **Month arithmetic is done with `setMonth`, not by adding days.** The
+ *   platform already knows that a month is 28, 29, 30 or 31 days long.
+ */
+
+/** Names of the weekdays and months, in the caller's locale. */
+
+export function startOfDay(date) {
+  const copy = new Date(date);
+  copy.setHours(0, 0, 0, 0);
+  return copy;
+}
+export function isSameDay(a, b) {
+  if (!a || !b) return false;
+  return a.getFullYear() === b.getFullYear() && a.getMonth() === b.getMonth() && a.getDate() === b.getDate();
+}
+export function isSameMonth(a, b) {
+  return a.getFullYear() === b.getFullYear() && a.getMonth() === b.getMonth();
+}
+export function startOfMonth(date) {
+  return new Date(date.getFullYear(), date.getMonth(), 1);
+}
+
+/**
+ * Day 0 of the *next* month, which the platform resolves to the last day of
+ * this one — so a leap February needs no special case.
+ */
+export function endOfMonth(date) {
+  return new Date(date.getFullYear(), date.getMonth() + 1, 0);
+}
+export function addMonths(date, months) {
+  const copy = new Date(date.getFullYear(), date.getMonth(), 1);
+  copy.setMonth(copy.getMonth() + months);
+  return copy;
+}
+export function addDays(date, days) {
+  const copy = new Date(date);
+  copy.setDate(copy.getDate() + days);
+  return copy;
+}
+
+/** Whole days from `a` to `b`, ignoring the time of day on both. */
+export function daysBetween(a, b) {
+  const MS = 24 * 60 * 60 * 1000;
+  return Math.round((startOfDay(b).getTime() - startOfDay(a).getTime()) / MS);
+}
+export function isBefore(a, b) {
+  return startOfDay(a).getTime() < startOfDay(b).getTime();
+}
+export function isAfter(a, b) {
+  return startOfDay(a).getTime() > startOfDay(b).getTime();
+}
+
+/** Inclusive at both ends, which is what a selected range means to a reader. */
+export function isWithin(date, from, to) {
+  const time = startOfDay(date).getTime();
+  const start = startOfDay(from).getTime();
+  const end = startOfDay(to).getTime();
+  return time >= Math.min(start, end) && time <= Math.max(start, end);
+}
+export function clampDate(date, min, max) {
+  if (min && isBefore(date, min)) return min;
+  if (max && isAfter(date, max)) return max;
+  return date;
+}
+
+/**
+ * The six-week grid for a month.
+ *
+ * Always six rows, and always starting on the chosen first day of the week, so
+ * the calendar does not change height as the months are paged through. A grid
+ * that grows a row in March and loses it again in April makes everything below
+ * it jump, and the days themselves appear to move between months.
+ *
+ * The leading and trailing cells belong to the neighbouring months; whether
+ * they are drawn or left blank is the caller's decision.
+ */
+export function monthGrid(month, weekStartsOn) {
+  const first = startOfMonth(month);
+  // How far back to the most recent `weekStartsOn`. The `+ 7` keeps the
+  // modulo positive when the week starts later than the first of the month.
+  const lead = (first.getDay() - weekStartsOn + 7) % 7;
+  const start = addDays(first, -lead);
+  return Array.from({
+    length: 6
+  }, (_unusedWeek, week) => Array.from({
+    length: 7
+  }, (_unusedDay, day) => addDays(start, week * 7 + day)));
+}
+
+/**
+ * Formatting, guarded.
+ *
+ * `Intl` is on modern Hermes, but the data behind it is not guaranteed —
+ * builds without the full ICU set throw or return something unusable for
+ * locales they do not carry. Every formatter here falls back to English rather
+ * than taking the screen down over a month name.
+ */
+function format(date, locale, options) {
+  try {
+    return new Intl.DateTimeFormat(locale, options).format(date);
+  } catch {
+    return null;
+  }
+}
+
+/**
+ * A locale tag carrying an explicit calendar and Latin digits.
+ *
+ * The calendar has to go in the *tag*, not in the options bag. Hermes builds
+ * its `Intl` on the platform's own date formatter, which reads the Unicode
+ * extension on a locale identifier but does not reliably honour `calendar` as
+ * an option — so `{ calendar: 'gregory' }` was quietly ignored and an Arabic
+ * device kept answering in Hijri. Any extension already on the tag is dropped
+ * first, so a caller passing `ar-u-ca-islamic` cannot end up with two.
+ */
+function withCalendar(locale, calendar) {
+  const base = (locale ?? 'en').split('-u-')[0] || 'en';
+  return `${base}-u-ca-${calendar}-nu-latn`;
+}
+
+/**
+ * Gregorian formatting, pinned.
+ *
+ * Asking for a month name in Arabic without saying which calendar gets a Hijri
+ * one back, because that is what the locale resolves to — right for the
+ * language, wrong for a grid whose cells are counting Gregorian days. The
+ * digits are pinned too, so the caption and the numbers under it are in one
+ * set.
+ */
+function formatGregory(date, locale, options) {
+  return format(date, withCalendar(locale, 'gregory'), options) ??
+  // A build that cannot parse the extension at all still gets asked, in the
+  // hope that it honours the option instead.
+  format(date, locale, {
+    ...options,
+    calendar: 'gregory',
+    numberingSystem: 'latn'
+  });
+}
+
+/* -------------------------------------------------------------------------- */
+/* Calendar systems                                                           */
+/* -------------------------------------------------------------------------- */
+
+/**
+ * Which calendar the months and day numbers are counted in.
+ *
+ * `auto` takes whatever the locale resolves to, which on an Arabic device is
+ * usually islamic. It is not the default: a grid whose month boundaries move
+ * with the device's language is a surprise, and the caller who wants that can
+ * ask for it.
+ */
+
+/** Year, month and day as the chosen calendar counts them. 1-based month. */
+
+/** What `auto` resolves to for a locale, falling back to the Gregorian. */
+export function resolveCalendar(system, locale) {
+  if (system !== 'auto') return system;
+  try {
+    const resolved = new Intl.DateTimeFormat(locale).resolvedOptions().calendar ?? '';
+    return resolved.startsWith('islamic') ? 'islamic' : 'gregory';
+  } catch {
+    return 'gregory';
+  }
+}
+
+/**
+ * A date's year, month and day in the given calendar.
+ *
+ * `formatToParts` rather than a parsed string, because the order and the
+ * separators are the locale's business and we only want the numbers. The
+ * numbering system is pinned to Latin so the parts come back parseable
+ * whatever language is on the device, and so the cells and the caption above
+ * them end up in one set of digits.
+ */
+export function calendarParts(date, system, locale) {
+  if (system === 'gregory') {
+    return {
+      year: date.getFullYear(),
+      month: date.getMonth() + 1,
+      day: date.getDate()
+    };
+  }
+  try {
+    const parts = new Intl.DateTimeFormat(withCalendar(locale, 'islamic'), {
+      year: 'numeric',
+      month: 'numeric',
+      day: 'numeric'
+    }).formatToParts(date);
+    const read = type => Number(parts.find(part => part.type === type)?.value);
+    const year = read('year');
+    const month = read('month');
+    const day = read('day');
+    if (!Number.isFinite(year) || !Number.isFinite(month) || !Number.isFinite(day)) {
+      throw new Error('unusable');
+    }
+    return {
+      year,
+      month,
+      day
+    };
+  } catch {
+    // No islamic data in this build. Gregorian is wrong, but it is coherent —
+    // the grid, the caption and the cells will at least agree with each other.
+    return {
+      year: date.getFullYear(),
+      month: date.getMonth() + 1,
+      day: date.getDate()
+    };
+  }
+}
+export function isSameCalendarMonth(a, b, system, locale) {
+  if (system === 'gregory') return isSameMonth(a, b);
+  const one = calendarParts(a, system, locale);
+  const two = calendarParts(b, system, locale);
+  return one.year === two.year && one.month === two.month;
+}
+
+/**
+ * The first day of the calendar month `date` falls in.
+ *
+ * Walked back a day at a time rather than computed. A Hijri month is 29 or 30
+ * days depending on the year, and the platform's own calendar data already
+ * knows which — stepping until the day number reads 1 asks it, instead of
+ * shipping a table that will disagree with the device.
+ */
+export function startOfCalendarMonth(date, system, locale) {
+  if (system === 'gregory') return startOfMonth(date);
+  let cursor = startOfDay(date);
+  for (let step = 0; step < 31; step += 1) {
+    if (calendarParts(cursor, system, locale).day === 1) return cursor;
+    cursor = addDays(cursor, -1);
+  }
+  return cursor;
+}
+
+/** Days in the calendar month `date` falls in. */
+export function daysInCalendarMonth(date, system, locale) {
+  if (system === 'gregory') return endOfMonth(date).getDate();
+  const start = startOfCalendarMonth(date, system, locale);
+  for (let length = 28; length <= 31; length += 1) {
+    if (calendarParts(addDays(start, length), system, locale).day === 1) return length;
+  }
+  return 30;
+}
+
+/** Page by whole calendar months, forwards or back. */
+export function addCalendarMonths(date, months, system, locale) {
+  if (system === 'gregory') return addMonths(date, months);
+  let cursor = startOfCalendarMonth(date, system, locale);
+  for (let step = 0; step < Math.abs(months); step += 1) {
+    cursor = months > 0 ?
+    // One past the end of this month is the first of the next.
+    addDays(cursor, daysInCalendarMonth(cursor, system, locale)) :
+    // One before the start of this month is somewhere in the previous
+    // one, which then gets walked back to its own first day.
+    startOfCalendarMonth(addDays(cursor, -1), system, locale);
+  }
+  return cursor;
+}
+
+/** The day-of-month a cell shows. */
+export function calendarDayNumber(date, system, locale) {
+  return system === 'gregory' ? date.getDate() : calendarParts(date, system, locale).day;
+}
+
+/** "Ramadan 1447" or "March 2026", in whichever calendar is in force. */
+export function calendarMonthLabel(date, system, locale) {
+  if (system === 'gregory') return monthLabel(date, locale);
+  return format(date, withCalendar(locale, 'islamic'), {
+    month: 'long',
+    year: 'numeric'
+  }) ?? monthLabel(date, locale);
+}
+
+/**
+ * The names of a calendar's months, in order, for the dropdown.
+ *
+ * Sampled from a real year in that calendar rather than from twelve Gregorian
+ * firsts — the old code did the latter and got twelve arbitrary Hijri names in
+ * whatever order the Gregorian 1sts happened to fall, then indexed them by
+ * Gregorian month, which meant nothing at all.
+ */
+export function calendarMonthNames(reference, system, locale, style = 'short') {
+  if (system === 'gregory') return monthNames(locale, style);
+  const names = [];
+  let cursor = startOfCalendarMonth(reference, system, locale);
+  // Back to month 1 of this year, then forward through all twelve.
+  cursor = addCalendarMonths(cursor, -(calendarParts(cursor, system, locale).month - 1), system, locale);
+  for (let month = 0; month < 12; month += 1) {
+    names.push(format(cursor, withCalendar(locale, 'islamic'), {
+      month: style
+    }) ?? String(month + 1));
+    cursor = addCalendarMonths(cursor, 1, system, locale);
+  }
+  return names;
+}
+
+/** The whole date read out, in whichever calendar is in force. */
+export function calendarLongDate(date, system, locale) {
+  if (system === 'gregory') return longDate(date, locale);
+  return format(date, withCalendar(locale, 'islamic'), {
+    weekday: 'long',
+    day: 'numeric',
+    month: 'long',
+    year: 'numeric'
+  }) ?? longDate(date, locale);
+}
+
+/** The compact form a trigger shows, in whichever calendar is in force. */
+export function calendarShortDate(date, system, locale) {
+  if (system === 'gregory') return shortDate(date, locale);
+  return format(date, withCalendar(locale, 'islamic'), {
+    day: 'numeric',
+    month: 'short',
+    year: 'numeric'
+  }) ?? shortDate(date, locale);
+}
+const MONTHS_EN = ['January', 'February', 'March', 'April', 'May', 'June', 'July', 'August', 'September', 'October', 'November', 'December'];
+const WEEKDAYS_EN = ['Sun', 'Mon', 'Tue', 'Wed', 'Thu', 'Fri', 'Sat'];
+
+/** Month names in order, for the caption and its dropdown. */
+export function monthNames(locale, style = 'long') {
+  return MONTHS_EN.map((fallback, month) => {
+    const formatted = formatGregory(new Date(2021, month, 1), locale, {
+      month: style
+    });
+    return formatted ?? (style === 'short' ? fallback.slice(0, 3) : fallback);
+  });
+}
+
+/** Column headings, rotated so the first one is `weekStartsOn`. */
+export function weekdayNames(locale, weekStartsOn) {
+  // 2021-08-01 was a Sunday, so adding the index lands on each weekday in turn.
+  return Array.from({
+    length: 7
+  }, (_unused, day) => {
+    const index = (day + weekStartsOn) % 7;
+    const formatted = formatGregory(new Date(2021, 7, 1 + index), locale, {
+      weekday: 'short'
+    });
+    return formatted ?? WEEKDAYS_EN[index];
+  });
+}
+
+/** "March 2026", for the caption. */
+export function monthLabel(date, locale) {
+  return formatGregory(date, locale, {
+    month: 'long',
+    year: 'numeric'
+  }) ?? `${MONTHS_EN[date.getMonth()]} ${date.getFullYear()}`;
+}
+
+/** "12 March 2026" — the whole date, for a screen reader to read out. */
+export function longDate(date, locale) {
+  return formatGregory(date, locale, {
+    weekday: 'long',
+    day: 'numeric',
+    month: 'long',
+    year: 'numeric'
+  }) ?? `${WEEKDAYS_EN[date.getDay()]} ${date.getDate()} ${MONTHS_EN[date.getMonth()]} ${date.getFullYear()}`;
+}
+
+/** "12 Mar 2026" — the compact form a trigger shows. */
+export function shortDate(date, locale) {
+  return formatGregory(date, locale, {
+    day: 'numeric',
+    month: 'short',
+    year: 'numeric'
+  }) ?? `${date.getDate()} ${MONTHS_EN[date.getMonth()].slice(0, 3)} ${date.getFullYear()}`;
+}
+//# sourceMappingURL=date.js.map