@chelone/core 0.6.0 → 0.9.0

package/dist/controller/calendar-dates.js

@@ -1,123 +1,104 @@
-const DATE_ONLY = /^(\d{4})-(\d{2})-(\d{2})$/;
-const AGENDA_DAYS = 14;
-const atMidnight = (date, dayOffset = 0) => new Date(date.getFullYear(), date.getMonth(), date.getDate() + dayOffset);
-const atEndOfDay = (date, dayOffset = 0) => new Date(
-  date.getFullYear(),
-  date.getMonth(),
-  date.getDate() + dayOffset,
-  23,
-  59,
-  59,
-  999
-);
-const daysFromWeekStart = (date, weekStartsOn) => (date.getDay() - weekStartsOn + 7) % 7;
+// src/controller/calendar-dates.ts
+var DATE_ONLY = /^(\d{4})-(\d{2})-(\d{2})$/;
+var AGENDA_DAYS = 14;
+var atMidnight = (date, dayOffset = 0) => new Date(date.getFullYear(), date.getMonth(), date.getDate() + dayOffset);
+var atEndOfDay = (date, dayOffset = 0) => new Date(date.getFullYear(), date.getMonth(), date.getDate() + dayOffset, 23, 59, 59, 999);
+var daysFromWeekStart = (date, weekStartsOn) => (date.getDay() - weekStartsOn + 7) % 7;
+/**
+* A date-only string is local midnight: `new Date("2026-05-01")` reads it as
+* UTC, which is the previous day west of Greenwich.
+*/
 function parseCalendarDate(value) {
-  let date;
-  if (value instanceof Date) {
-    date = new Date(value.getTime());
-  } else if (typeof value === "number") {
-    date = new Date(value);
-  } else if (typeof value === "string") {
-    const dateOnly = DATE_ONLY.exec(value);
-    if (dateOnly) {
-      const [year, month, day] = [
-        Number(dateOnly[1]),
-        Number(dateOnly[2]),
-        Number(dateOnly[3])
-      ];
-      date = new Date(2e3, 0, 1);
-      date.setFullYear(year, month - 1, day);
-      if (date.getFullYear() !== year || date.getMonth() !== month - 1 || date.getDate() !== day) {
-        return void 0;
-      }
-    } else {
-      date = new Date(value);
-    }
-  } else {
-    return void 0;
-  }
-  return Number.isNaN(date.getTime()) ? void 0 : date;
+	let date;
+	if (value instanceof Date) date = new Date(value.getTime());
+	else if (typeof value === "number") date = new Date(value);
+	else if (typeof value === "string") {
+		const dateOnly = DATE_ONLY.exec(value);
+		if (dateOnly) {
+			const [year, month, day] = [
+				Number(dateOnly[1]),
+				Number(dateOnly[2]),
+				Number(dateOnly[3])
+			];
+			date = new Date(2e3, 0, 1);
+			date.setFullYear(year, month - 1, day);
+			if (date.getFullYear() !== year || date.getMonth() !== month - 1 || date.getDate() !== day) return;
+		} else date = new Date(value);
+	} else return;
+	return Number.isNaN(date.getTime()) ? void 0 : date;
 }
 function calendarRange(view, anchor, weekStartsOn) {
-  if (view === "agenda") {
-    return {
-      start: atMidnight(anchor, -AGENDA_DAYS),
-      end: atEndOfDay(anchor, AGENDA_DAYS)
-    };
-  }
-  const first = view === "month" ? new Date(anchor.getFullYear(), anchor.getMonth(), 1) : anchor;
-  const last = view === "month" ? new Date(anchor.getFullYear(), anchor.getMonth() + 1, 0) : anchor;
-  return {
-    start: atMidnight(first, -daysFromWeekStart(first, weekStartsOn)),
-    end: atEndOfDay(last, 6 - daysFromWeekStart(last, weekStartsOn))
-  };
+	if (view === "agenda") return {
+		start: atMidnight(anchor, -14),
+		end: atEndOfDay(anchor, AGENDA_DAYS)
+	};
+	const first = view === "month" ? new Date(anchor.getFullYear(), anchor.getMonth(), 1) : anchor;
+	const last = view === "month" ? new Date(anchor.getFullYear(), anchor.getMonth() + 1, 0) : anchor;
+	return {
+		start: atMidnight(first, -daysFromWeekStart(first, weekStartsOn)),
+		end: atEndOfDay(last, 6 - daysFromWeekStart(last, weekStartsOn))
+	};
 }
+/** One local midnight per day: adding to the day of the month never skips or repeats a day when the clocks change. */
 function calendarDays(range) {
-  const days = [];
-  const first = atMidnight(range.start);
-  for (let day = first; day.getTime() <= range.end.getTime(); day = atMidnight(first, days.length)) {
-    days.push(day);
-  }
-  return days;
+	const days = [];
+	const first = atMidnight(range.start);
+	for (let day = first; day.getTime() <= range.end.getTime(); day = atMidnight(first, days.length)) days.push(day);
+	return days;
+}
+/**
+* The slot a whole day is: its local midnight to its last millisecond, the same
+* inclusive end {@link calendarRange} gives a range. A day carrying a time is
+* read as its day, not that instant.
+*/
+function calendarDaySlot(day) {
+	return {
+		startISO: atMidnight(day).toISOString(),
+		endISO: atEndOfDay(day).toISOString(),
+		allDay: true
+	};
 }
 function shiftCalendarAnchor(view, anchor, direction) {
-  const time = [
-    anchor.getHours(),
-    anchor.getMinutes(),
-    anchor.getSeconds(),
-    anchor.getMilliseconds()
-  ];
-  if (view === "month") {
-    const month = anchor.getMonth() + direction;
-    const lastDay = new Date(anchor.getFullYear(), month + 1, 0).getDate();
-    return new Date(
-      anchor.getFullYear(),
-      month,
-      Math.min(anchor.getDate(), lastDay),
-      ...time
-    );
-  }
-  const step = view === "week" ? 7 : AGENDA_DAYS;
-  return new Date(
-    anchor.getFullYear(),
-    anchor.getMonth(),
-    anchor.getDate() + direction * step,
-    ...time
-  );
+	const time = [
+		anchor.getHours(),
+		anchor.getMinutes(),
+		anchor.getSeconds(),
+		anchor.getMilliseconds()
+	];
+	if (view === "month") {
+		const month = anchor.getMonth() + direction;
+		const lastDay = new Date(anchor.getFullYear(), month + 1, 0).getDate();
+		return new Date(anchor.getFullYear(), month, Math.min(anchor.getDate(), lastDay), ...time);
+	}
+	const step = view === "week" ? 7 : AGENDA_DAYS;
+	return new Date(anchor.getFullYear(), anchor.getMonth(), anchor.getDate() + direction * step, ...time);
 }
-const pad = (value) => String(value).padStart(2, "0");
-const calendarDayKey = (date) => `${date.getFullYear()}-${pad(date.getMonth() + 1)}-${pad(date.getDate())}`;
+var pad = (value) => String(value).padStart(2, "0");
+var calendarDayKey = (date) => `${date.getFullYear()}-${pad(date.getMonth() + 1)}-${pad(date.getDate())}`;
 function calendarLabels(locale) {
-  const month = new Intl.DateTimeFormat(locale, {
-    month: "long",
-    year: "numeric"
-  });
-  const span = new Intl.DateTimeFormat(locale, {
-    month: "short",
-    day: "numeric",
-    year: "numeric"
-  });
-  const weekday = new Intl.DateTimeFormat(locale, { weekday: "short" });
-  const dayNumber = new Intl.DateTimeFormat(locale, { day: "numeric" });
-  const hour = new Intl.DateTimeFormat(locale, { hour: "numeric" });
-  const agendaDay = new Intl.DateTimeFormat(locale, {
-    weekday: "long",
-    month: "long",
-    day: "numeric"
-  });
-  return {
-    title: (view, anchor, range) => view === "month" ? month.format(anchor) : span.formatRange(range.start, range.end),
-    weekday: (date) => weekday.format(date),
-    dayNumber: (date) => dayNumber.format(date),
-    hour: (value) => hour.format(new Date(2e3, 0, 1, value)),
-    agendaDay: (date) => agendaDay.format(date)
-  };
+	const month = new Intl.DateTimeFormat(locale, {
+		month: "long",
+		year: "numeric"
+	});
+	const span = new Intl.DateTimeFormat(locale, {
+		month: "short",
+		day: "numeric",
+		year: "numeric"
+	});
+	const weekday = new Intl.DateTimeFormat(locale, { weekday: "short" });
+	const dayNumber = new Intl.DateTimeFormat(locale, { day: "numeric" });
+	const hour = new Intl.DateTimeFormat(locale, { hour: "numeric" });
+	const agendaDay = new Intl.DateTimeFormat(locale, {
+		weekday: "long",
+		month: "long",
+		day: "numeric"
+	});
+	return {
+		title: (view, anchor, range) => view === "month" ? month.format(anchor) : span.formatRange(range.start, range.end),
+		weekday: (date) => weekday.format(date),
+		dayNumber: (date) => dayNumber.format(date),
+		hour: (value) => hour.format(new Date(2e3, 0, 1, value)),
+		agendaDay: (date) => agendaDay.format(date)
+	};
 }
-export {
-  calendarDayKey,
-  calendarDays,
-  calendarLabels,
-  calendarRange,
-  parseCalendarDate,
-  shiftCalendarAnchor
-};
+export { calendarDayKey, calendarDaySlot, calendarDays, calendarLabels, calendarRange, parseCalendarDate, shiftCalendarAnchor };

package/dist/controller/calendar-events.js

@@ -1,106 +1,111 @@
 import { getAtPath } from "../resource/get-at-path.js";
 import { calendarDayKey, parseCalendarDate } from "./calendar-dates.js";
-const midnight = (date, dayOffset = 0) => new Date(date.getFullYear(), date.getMonth(), date.getDate() + dayOffset);
-const isMidnight = (date) => date.getTime() === midnight(date).getTime();
+// src/controller/calendar-events.ts
+var midnight = (date, dayOffset = 0) => new Date(date.getFullYear(), date.getMonth(), date.getDate() + dayOffset);
+var isMidnight = (date) => date.getTime() === midnight(date).getTime();
+/** Records with no usable start are skipped, and an end before the start is dropped. */
 function toCalendarEvents(records, options) {
-  const events = [];
-  for (const record of records) {
-    const start = parseCalendarDate(getAtPath(record, options.startSource));
-    if (!start) continue;
-    const parsedEnd = options.endSource ? parseCalendarDate(getAtPath(record, options.endSource)) : void 0;
-    const end = parsedEnd && parsedEnd.getTime() >= start.getTime() ? parsedEnd : void 0;
-    const titleValue = options.titleSource ? getAtPath(record, options.titleSource) : void 0;
-    const title = (typeof titleValue === "string" || typeof titleValue === "number") && titleValue !== "" ? String(titleValue) : options.getTitle(record);
-    const colorValue = options.colorSource ? getAtPath(record, options.colorSource) : void 0;
-    const color = colorValue == null ? void 0 : options.colorMap?.[String(colorValue)];
-    const event = { record, start, title };
-    if (end) event.end = end;
-    if (color !== void 0) event.color = color;
-    events.push(event);
-  }
-  return events;
+	const events = [];
+	for (const record of records) {
+		const start = parseCalendarDate(getAtPath(record, options.startSource));
+		if (!start) continue;
+		const parsedEnd = options.endSource ? parseCalendarDate(getAtPath(record, options.endSource)) : void 0;
+		const end = parsedEnd && parsedEnd.getTime() >= start.getTime() ? parsedEnd : void 0;
+		const titleValue = options.titleSource ? getAtPath(record, options.titleSource) : void 0;
+		const title = (typeof titleValue === "string" || typeof titleValue === "number") && titleValue !== "" ? String(titleValue) : options.getTitle(record);
+		const colorValue = options.colorSource ? getAtPath(record, options.colorSource) : void 0;
+		const color = colorValue == null ? void 0 : options.colorMap?.[String(colorValue)];
+		const event = {
+			record,
+			start,
+			title
+		};
+		if (end) event.end = end;
+		if (color !== void 0) event.color = color;
+		events.push(event);
+	}
+	return events;
 }
+/** An event runs from its start day to its end day; an end at midnight leaves its own day out. */
 function calendarEventsOnDay(events, day) {
-  const dayTime = midnight(day).getTime();
-  return events.filter(({ start, end }) => {
-    const firstDay = midnight(start).getTime();
-    let lastDay = firstDay;
-    if (end && end.getTime() > start.getTime()) {
-      lastDay = midnight(end, isMidnight(end) ? -1 : 0).getTime();
-    }
-    return dayTime >= firstDay && dayTime <= lastDay;
-  });
+	const dayTime = midnight(day).getTime();
+	return events.filter(({ start, end }) => {
+		const firstDay = midnight(start).getTime();
+		let lastDay = firstDay;
+		if (end && end.getTime() > start.getTime()) lastDay = midnight(end, isMidnight(end) ? -1 : 0).getTime();
+		return dayTime >= firstDay && dayTime <= lastDay;
+	});
 }
 function calendarEventsInHour(events, day, hour) {
-  const key = calendarDayKey(day);
-  return events.filter(
-    ({ start }) => calendarDayKey(start) === key && start.getHours() === hour
-  );
+	const key = calendarDayKey(day);
+	return events.filter(({ start }) => calendarDayKey(start) === key && start.getHours() === hour);
 }
+/** Equal starts keep list order. */
 function groupCalendarAgenda(events, range) {
-  const inRange = events.filter(
-    ({ start }) => start.getTime() >= range.start.getTime() && start.getTime() <= range.end.getTime()
-  ).sort((a, b) => a.start.getTime() - b.start.getTime());
-  const groups = [];
-  const byKey = /* @__PURE__ */ new Map();
-  for (const event of inRange) {
-    const key = calendarDayKey(event.start);
-    let group = byKey.get(key);
-    if (!group) {
-      group = { day: midnight(event.start), key, events: [] };
-      byKey.set(key, group);
-      groups.push(group);
-    }
-    group.events.push(event);
-  }
-  return groups;
+	const inRange = events.filter(({ start }) => start.getTime() >= range.start.getTime() && start.getTime() <= range.end.getTime()).sort((a, b) => a.start.getTime() - b.start.getTime());
+	const groups = [];
+	const byKey = /* @__PURE__ */ new Map();
+	for (const event of inRange) {
+		const key = calendarDayKey(event.start);
+		let group = byKey.get(key);
+		if (!group) {
+			group = {
+				day: midnight(event.start),
+				key,
+				events: []
+			};
+			byKey.set(key, group);
+			groups.push(group);
+		}
+		group.events.push(event);
+	}
+	return groups;
 }
-const wholeDaysBetween = (from, to) => Math.round(
-  (Date.UTC(to.getFullYear(), to.getMonth(), to.getDate()) - Date.UTC(from.getFullYear(), from.getMonth(), from.getDate())) / 864e5
-);
-const addDays = (date, days) => new Date(
-  date.getFullYear(),
-  date.getMonth(),
-  date.getDate() + days,
-  date.getHours(),
-  date.getMinutes(),
-  date.getSeconds(),
-  date.getMilliseconds()
-);
+var wholeDaysBetween = (from, to) => Math.round((Date.UTC(to.getFullYear(), to.getMonth(), to.getDate()) - Date.UTC(from.getFullYear(), from.getMonth(), from.getDate())) / 864e5);
+var addDays = (date, days) => new Date(date.getFullYear(), date.getMonth(), date.getDate() + days, date.getHours(), date.getMinutes(), date.getSeconds(), date.getMilliseconds());
+/**
+* Shifts the start and the end by the whole days between the two days, each
+* keeping its time of day. Adding the duration in milliseconds instead would
+* move an all-day event's end off midnight when the move crosses a daylight
+* saving change.
+*/
 function moveCalendarEvent(event, fromDay, toDay) {
-  const days = wholeDaysBetween(fromDay, toDay);
-  const start = addDays(event.start, days);
-  return event.end ? { start, end: addDays(event.end, days) } : { start };
+	const days = wholeDaysBetween(fromDay, toDay);
+	const start = addDays(event.start, days);
+	return event.end ? {
+		start,
+		end: addDays(event.end, days)
+	} : { start };
 }
+/**
+* The list filter that asks for a range. With an `endSource`, an event is kept
+* when it starts before the range ends and ends after it starts, so one that
+* began earlier and runs into the range is fetched; a record with an empty end
+* is then left out. Without one, only the start is bounded, on both sides.
+*/
 function calendarRangeFilter(startSource, range, endSource) {
-  if (endSource) {
-    return {
-      [`${startSource}_lte`]: range.end.toISOString(),
-      [`${endSource}_gte`]: range.start.toISOString()
-    };
-  }
-  return {
-    [`${startSource}_gte`]: range.start.toISOString(),
-    [`${startSource}_lte`]: range.end.toISOString()
-  };
+	if (endSource) return {
+		[`${startSource}_lte`]: range.end.toISOString(),
+		[`${endSource}_gte`]: range.start.toISOString()
+	};
+	return {
+		[`${startSource}_gte`]: range.start.toISOString(),
+		[`${startSource}_lte`]: range.end.toISOString()
+	};
 }
+/**
+* Keys an earlier default filter wrote that the current one no longer does: a
+* list URL or store can still hold the start's lower bound, which would hide
+* the event that starts before the range.
+*/
 function staleCalendarRangeKeys(startSource, endSource) {
-  return endSource ? [`${startSource}_gte`] : [];
+	return endSource ? [`${startSource}_gte`] : [];
 }
 function omitCalendarRangeFilter(filter, startSource, endSource) {
-  const rest = { ...filter };
-  delete rest[`${startSource}_gte`];
-  delete rest[`${startSource}_lte`];
-  if (endSource) delete rest[`${endSource}_gte`];
-  return rest;
+	const rest = { ...filter };
+	delete rest[`${startSource}_gte`];
+	delete rest[`${startSource}_lte`];
+	if (endSource) delete rest[`${endSource}_gte`];
+	return rest;
 }
-export {
-  calendarEventsInHour,
-  calendarEventsOnDay,
-  calendarRangeFilter,
-  groupCalendarAgenda,
-  moveCalendarEvent,
-  omitCalendarRangeFilter,
-  staleCalendarRangeKeys,
-  toCalendarEvents
-};
+export { calendarEventsInHour, calendarEventsOnDay, calendarRangeFilter, groupCalendarAgenda, moveCalendarEvent, omitCalendarRangeFilter, staleCalendarRangeKeys, toCalendarEvents };

package/dist/controller/client-list-controller.d.ts

@@ -22,7 +22,7 @@ export interface ClientListControllerOptions<TRecord> {
     isPending?: boolean;
     isFetching?: boolean;
     /** Pass-through error. Default `null`. */
-    error?: unknown;
+    error?: Error | null;
     /** Extra predicate applied AFTER the field filters (ra-core `filterCallback`). */
     filterCallback?: (record: TRecord) => boolean;
 }
@@ -39,7 +39,7 @@ export interface ClientListControllerOptions<TRecord> {
 export interface ClientListLoadingState {
     isPending?: boolean;
     isFetching?: boolean;
-    error?: unknown;
+    error?: Error | null;
 }
 export interface ClientListController<TRecord> extends ListController<TRecord> {
     /** Replace the source records (external `data` prop change) and recompute. */