@object-ui/plugin-timeline 17.7.0 → 18.0.0

package/dist/index.js

@@ -2,15 +2,15 @@ import * as e from "react";
 import { useCallback as t, useEffect as n, useMemo as r, useRef as i, useState as a } from "react";
 import { NavigationOverlay as o, cn as s, cva as c, renderChildren as l } from "@object-ui/components";
 import { jsx as u, jsxs as d } from "react/jsx-runtime";
-import { ComponentRegistry as f, buildExpandFields as p, convertSortToQueryParams as m, createFieldColorResolver as h, elementDataSourceBlock as g, extractRecords as _, isRealCalendarDate as v, recordDisplayValueAt as ee, toDateInputValue as y, toDisplayDate as b, toDisplayEndDate as te, toDomProps as x } from "@object-ui/core";
-import { createSafeTranslation as ne, useDisplayLocale as re } from "@object-ui/i18n";
-import { ElementDataSourceGate as ie, useDataInvalidation as ae, useDataScope as oe, useFilterScope as se, useNavigationOverlay as ce, useResolvedFilter as le, useSafeFieldLabel as ue, useSchemaContext as de, useSettledSchema as fe } from "@object-ui/react";
+import { ComponentRegistry as f, buildExpandFields as p, convertSortToQueryParams as m, createFieldColorResolver as h, elementDataSourceBlock as g, extractRecords as _, isRealCalendarDate as v, recordDisplayValueAt as y, toDateInputValue as b, toDisplayDate as x, toDisplayEndDate as ee, toDomProps as S } from "@object-ui/core";
+import { createSafeTranslation as te, firstDayOfWeek as ne, useDisplayLocale as re, useObjectTranslation as ie } from "@object-ui/i18n";
+import { ElementDataSourceGate as C, useDataInvalidation as ae, useDataScope as oe, useFilterScope as se, useNavigationOverlay as ce, useResolvedFilter as le, useSafeFieldLabel as ue, useSchemaContext as de, useSettledSchema as fe } from "@object-ui/react";
 import { usePermissions as pe } from "@object-ui/permissions";
 import { usePullToRefresh as me } from "@object-ui/mobile";
-import { z as S } from "zod";
+import { z as w } from "zod";
 //#region src/useTimelineTranslation.ts
-var C = {
-	"timeline.bucket.overdue": "Overdue",
+var T = {
+	"timeline.bucket.earlier": "Earlier",
 	"timeline.bucket.today": "Today",
 	"timeline.bucket.tomorrow": "Tomorrow",
 	"timeline.bucket.thisWeek": "This week",
@@ -26,7 +26,7 @@ var C = {
 	"timeline.gantt.unusableRange.malformedRow": "Unusable gantt rows — {{path}} is {{value}}, which is not a row shape. A gantt draws items as a list of rows, every row as an object with a label and its own items, and every row's items as a list of bars; a null, a number, a string or a plain object in any of those places cannot be drawn.",
 	"timeline.unsupported.objectBoundGantt": "Unsupported variant \"gantt\" — an object-bound timeline renders the feed variants ({{variants}}). Gantt needs literal rows, each with its own nested items, so the gantt axis (scale) has no effect here.",
 	"timeline.unconfigured.noDateAxis": "Timeline date axis required — this view declares no date field, and an object-bound timeline will not invent one. Declare one of: {{fields}}. The first is the spec spelling; the rest are legacy aliases."
-}, w = "timeline.bucket.today", he = (e, t) => Object.entries(t ?? {}).reduce((e, [t, n]) => e.split(`{{${t}}}`).join(String(n)), C[e] || e), ge = ne(C, w), T = /* @__PURE__ */ new Set([
+}, E = "timeline.bucket.today", he = (e, t) => Object.entries(t ?? {}).reduce((e, [t, n]) => e.split(`{{${t}}}`).join(String(n)), T[e] || e), ge = te(T, E), D = /* @__PURE__ */ new Set([
 	"hour",
 	"day",
 	"week",
@@ -34,14 +34,14 @@ var C = {
 	"quarter",
 	"year"
 ]);
-function E(e) {
+function O(e) {
 	let t = e.scale;
-	return typeof t == "string" && T.has(t) ? t : "month";
+	return typeof t == "string" && D.has(t) ? t : "month";
 }
-function D(e) {
-	return typeof e == "string" ? b(e) : new Date(e);
+function k(e) {
+	return typeof e == "string" ? x(e) : new Date(e);
 }
-function O(e) {
+function A(e) {
 	let t = new Date(e);
 	return t.setHours(0, 0, 0, 0), t;
 }
@@ -58,8 +58,8 @@ var _e = 36e5, ve = {
 		day: "numeric",
 		hour: "numeric"
 	})
-}, k = {
-	floor: O,
+}, ye = {
+	floor: A,
 	step: (e) => {
 		e.setDate(e.getDate() + 1);
 	},
@@ -67,15 +67,15 @@ var _e = 36e5, ve = {
 		month: "short",
 		day: "numeric"
 	})
-}, ye = {
-	floor: O,
+}, be = {
+	floor: A,
 	step: (e) => {
 		e.setDate(e.getDate() + 7);
 	},
 	label: (e, t, n, r) => r("timeline.scale.week", { n: t + 1 })
-}, A = {
+}, j = {
 	floor: (e) => {
-		let t = O(e);
+		let t = A(e);
 		return t.setDate(1), t;
 	},
 	step: (e) => {
@@ -85,9 +85,9 @@ var _e = 36e5, ve = {
 		month: "short",
 		year: "numeric"
 	})
-}, j = {
+}, M = {
 	floor: (e) => {
-		let t = O(e);
+		let t = A(e);
 		return t.setMonth(Math.floor(t.getMonth() / 3) * 3, 1), t;
 	},
 	step: (e) => {
@@ -97,9 +97,9 @@ var _e = 36e5, ve = {
 		quarter: Math.floor(e.getMonth() / 3) + 1,
 		year: e.getFullYear()
 	})
-}, be = {
+}, N = {
 	floor: (e) => {
-		let t = O(e);
+		let t = A(e);
 		return t.setMonth(0, 1), t;
 	},
 	step: (e) => {
@@ -110,18 +110,18 @@ var _e = 36e5, ve = {
 function xe(e) {
 	switch (e) {
 		case "hour": return ve;
-		case "day": return k;
-		case "week": return ye;
-		case "quarter": return j;
-		case "year": return be;
-		default: return A;
+		case "day": return ye;
+		case "week": return be;
+		case "quarter": return M;
+		case "year": return N;
+		default: return j;
 	}
 }
-function M(e) {
-	return typeof e == "string" ? te(e) : D(e);
+function P(e) {
+	return typeof e == "string" ? ee(e) : k(e);
 }
-function N(e, t, n, r, i, a) {
-	let o = D(t).getTime(), s = D(n).getTime();
+function F(e, t, n, r, i, a) {
+	let o = k(t).getTime(), s = k(n).getTime();
 	if (Number.isNaN(o) || Number.isNaN(s) || o > s) return;
 	let c = a === void 0 ? s : Math.max(s, a), l = xe(e), u = [], d = l.floor(new Date(o));
 	for (; d.getTime() <= c;) {
@@ -138,7 +138,7 @@ function N(e, t, n, r, i, a) {
 		units: u
 	};
 }
-function P(e, t, n) {
+function I(e, t, n) {
 	let r = e.end - e.start;
 	return {
 		start: (t - e.start) / r * 100,
@@ -146,17 +146,17 @@ function P(e, t, n) {
 	};
 }
 function Se(e, t, n, r = "en", i = he) {
-	let a = N(e, t, n, r, i);
+	let a = F(e, t, n, r, i);
 	return a ? a.units.map((e) => e.label) : [];
 }
-function F() {
-	let e = y(/* @__PURE__ */ new Date());
+function L() {
+	let e = b(/* @__PURE__ */ new Date());
 	return {
 		minDate: e,
 		maxDate: e
 	};
 }
-function I(e) {
+function R(e) {
 	if (!Array.isArray(e)) return {
 		ok: !1,
 		path: "items",
@@ -187,32 +187,32 @@ function I(e) {
 		rows: t
 	};
 }
-function L(e) {
+function z(e) {
 	let t = e.flatMap((e) => e.items.flatMap((e) => [e.startDate, e.endDate]));
-	if (t.length === 0) return F();
-	let n = Math.min(...t.map((e) => D(e).getTime())), r = Math.max(...t.map((e) => D(e).getTime())), i = Math.max(...e.flatMap((e) => e.items.map((e) => {
-		let t = D(e.startDate).getTime(), n = M(e.endDate).getTime();
+	if (t.length === 0) return L();
+	let n = Math.min(...t.map((e) => k(e).getTime())), r = Math.max(...t.map((e) => k(e).getTime())), i = Math.max(...e.flatMap((e) => e.items.map((e) => {
+		let t = k(e.startDate).getTime(), n = P(e.endDate).getTime();
 		return n > t ? n - 1 : t;
 	})));
 	return {
-		minDate: y(new Date(n)),
-		maxDate: y(new Date(r)),
+		minDate: b(new Date(n)),
+		maxDate: b(new Date(r)),
 		through: i
 	};
 }
-var R = (e) => {
+var B = (e) => {
 	try {
 		return Date.prototype.getTime.call(e), !0;
 	} catch {
 		return !1;
 	}
 };
-function z(e) {
-	return typeof e == "string" ? JSON.stringify(e) : e === void 0 ? "undefined" : e === null ? "null" : typeof e == "symbol" ? e.toString() : typeof e == "bigint" ? `${e}n` : typeof e == "number" || typeof e == "boolean" ? String(e) : R(e) ? Date.prototype.toString.call(e) : Array.isArray(e) ? "an array" : typeof e == "function" ? "a function" : "an object";
+function V(e) {
+	return typeof e == "string" ? JSON.stringify(e) : e === void 0 ? "undefined" : e === null ? "null" : typeof e == "symbol" ? e.toString() : typeof e == "bigint" ? `${e}n` : typeof e == "number" || typeof e == "boolean" ? String(e) : B(e) ? Date.prototype.toString.call(e) : Array.isArray(e) ? "an array" : typeof e == "function" ? "a function" : "an object";
 }
-var Ce = (e) => typeof e == "string" || typeof e == "number" && Number.isFinite(e) || R(e);
-function B(e, t, n) {
-	let r = (e) => !Ce(e) || Number.isNaN(D(e).getTime());
+var Ce = (e) => typeof e == "string" || typeof e == "number" && Number.isFinite(e) || B(e);
+function we(e, t, n) {
+	let r = (e) => !Ce(e) || Number.isNaN(k(e).getTime());
 	for (let t = 0; t < e.length; t++) {
 		let n = e[t].items;
 		for (let e = 0; e < n.length; e++) for (let i of ["startDate", "endDate"]) {
@@ -228,18 +228,18 @@ function B(e, t, n) {
 		value: i
 	};
 }
-function V(e, t, n) {
-	return P(n, D(e).getTime(), M(t).getTime());
-}
 function H(e, t, n) {
-	let r = b(e);
+	return I(n, k(e).getTime(), P(t).getTime());
+}
+function U(e, t, n) {
+	let r = x(e);
 	return t === "short" ? r.toLocaleDateString(n) : t === "long" ? r.toLocaleDateString(n, {
 		year: "numeric",
 		month: "long",
 		day: "numeric"
-	}) : Number.isNaN(r.getTime()) ? String(e) : v(e) ? y(r) : r.toISOString().split("T")[0];
+	}) : Number.isNaN(r.getTime()) ? String(e) : v(e) ? b(r) : r.toISOString().split("T")[0];
 }
-function U({ label: e, color: t }) {
+function W({ label: e, color: t }) {
 	let n = t ? {
 		backgroundColor: `${t}22`,
 		color: t,
@@ -251,26 +251,30 @@ function U({ label: e, color: t }) {
 		children: e
 	});
 }
-function we(e) {
-	let t = [];
-	for (let n of e) {
-		let e = n.group == null ? "" : String(n.group), r = t[t.length - 1];
-		r && r.key === e ? r.items.push(n) : t.push({
-			key: e,
-			items: [n]
-		});
+function Te(e) {
+	let t = [], n = /* @__PURE__ */ new Map();
+	for (let r of e) {
+		let e = r.group == null ? "" : String(r.group), i = n.get(e);
+		if (i) i.items.push(r);
+		else {
+			let i = {
+				key: e,
+				items: [r]
+			};
+			n.set(e, i), t.push(i);
+		}
 	}
 	return t;
 }
-var W = ({ schema: e, className: t, style: n, ...r }) => {
+var Ee = ({ schema: e, className: t, style: n, ...r }) => {
 	let { variant: i = "vertical", items: a = [], dateFormat: o = "short", onItemClick: c } = e, f = re(), { t: p } = ge();
 	if (i === "vertical") {
-		let e = we(a), i = e.some((e) => e.key !== ""), p = (e, t) => {
+		let e = Te(a), i = e.some((e) => e.key !== ""), p = (e, t) => {
 			let n = e.color ? {
 				backgroundColor: `${e.color}33`,
 				borderColor: e.color
-			} : void 0, r = e.time ? H(e.time, o, f) : e.startDate ? H(e.startDate, o, f) : "", i = e.endDate && e.endDate !== e.startDate ? H(e.endDate, o, f) : "", a = Array.isArray(e.meta) ? e.meta : [];
-			return /* @__PURE__ */ d(Pe, {
+			} : void 0, r = e.time ? U(e.time, o, f) : e.startDate ? U(e.startDate, o, f) : "", i = e.endDate && e.endDate !== e.startDate ? U(e.endDate, o, f) : "", a = Array.isArray(e.meta) ? e.meta : [];
+			return /* @__PURE__ */ d(Ie, {
 				density: "compact",
 				className: s(e.className, c && "cursor-pointer"),
 				onClick: () => c?.(e),
@@ -281,7 +285,7 @@ var W = ({ schema: e, className: t, style: n, ...r }) => {
 						className: "text-xs",
 						children: e.icon
 					})
-				}), /* @__PURE__ */ d(Ie, { children: [
+				}), /* @__PURE__ */ d(Re, { children: [
 					(r || i) && /* @__PURE__ */ d(J, {
 						dateTime: e.time || e.startDate,
 						className: "!mb-1 text-xs",
@@ -296,7 +300,7 @@ var W = ({ schema: e, className: t, style: n, ...r }) => {
 					}),
 					a.length > 0 && /* @__PURE__ */ u("div", {
 						className: "flex flex-wrap gap-1.5 mt-1 mb-1",
-						children: a.map((e) => /* @__PURE__ */ u(U, {
+						children: a.map((e) => /* @__PURE__ */ u(W, {
 							label: e.label,
 							color: e.color
 						}, e.key))
@@ -310,7 +314,7 @@ var W = ({ schema: e, className: t, style: n, ...r }) => {
 			}, t);
 		};
 		return i ? /* @__PURE__ */ u("div", {
-			...x(r),
+			...S(r),
 			className: s("px-4 sm:px-6 py-2", t),
 			style: n,
 			children: e.map((e, t) => /* @__PURE__ */ d("section", {
@@ -327,17 +331,17 @@ var W = ({ schema: e, className: t, style: n, ...r }) => {
 				})]
 			}, `${e.key}-${t}`))
 		}) : /* @__PURE__ */ u(G, {
-			...x(r),
+			...S(r),
 			className: t,
 			style: n,
 			children: a.map((e, t) => p(e, t))
 		});
 	}
-	if (i === "horizontal") return /* @__PURE__ */ u(Le, {
-		...x(r),
+	if (i === "horizontal") return /* @__PURE__ */ u(ze, {
+		...S(r),
 		className: s("overflow-x-auto [-webkit-overflow-scrolling:touch]", t),
 		style: n,
-		children: a.map((e, t) => /* @__PURE__ */ d(Re, {
+		children: a.map((e, t) => /* @__PURE__ */ d(Be, {
 			className: s(e.className, c && "cursor-pointer"),
 			onClick: () => c?.(e),
 			children: [/* @__PURE__ */ d("div", {
@@ -353,7 +357,7 @@ var W = ({ schema: e, className: t, style: n, ...r }) => {
 					children: [
 						e.time && /* @__PURE__ */ u(J, {
 							dateTime: e.time,
-							children: H(e.time, o, f)
+							children: U(e.time, o, f)
 						}),
 						e.title && /* @__PURE__ */ u(q, { children: e.title }),
 						e.description && /* @__PURE__ */ u(Y, {
@@ -367,32 +371,32 @@ var W = ({ schema: e, className: t, style: n, ...r }) => {
 		}, t))
 	});
 	if (i === "gantt") {
-		let i = I(a);
+		let i = R(a);
 		if (!i.ok) return /* @__PURE__ */ u("div", {
 			className: "p-4 text-destructive",
 			"data-testid": "timeline-unusable-date-range",
 			role: "alert",
 			children: p("timeline.gantt.unusableRange.malformedRow", {
 				path: i.path,
-				value: z(i.value)
+				value: V(i.value)
 			})
 		});
-		let l = i.rows, m = B(l, e.minDate, e.maxDate);
+		let l = i.rows, m = we(l, e.minDate, e.maxDate);
 		if (m) return /* @__PURE__ */ u("div", {
 			className: "p-4 text-destructive",
 			"data-testid": "timeline-unusable-date-range",
 			role: "alert",
 			children: p("timeline.gantt.unusableRange.malformedDate", {
 				path: m.path,
-				value: z(m.value)
+				value: V(m.value)
 			})
 		});
-		let h = L(l), g = e.minDate || h.minDate, _ = e.maxDate || h.maxDate, v = N(E(e), g, _, f, p, e.maxDate ? void 0 : h.through);
-		return v ? /* @__PURE__ */ d(ze, {
-			...x(r),
+		let h = z(l), g = e.minDate || h.minDate, _ = e.maxDate || h.maxDate, v = F(O(e), g, _, f, p, e.maxDate ? void 0 : h.through);
+		return v ? /* @__PURE__ */ d(Ve, {
+			...S(r),
 			className: s("overflow-x-auto [-webkit-overflow-scrolling:touch]", t),
 			style: n,
-			children: [/* @__PURE__ */ d(Be, { children: [/* @__PURE__ */ u(X, {
+			children: [/* @__PURE__ */ d(He, { children: [/* @__PURE__ */ u(X, {
 				className: "flex items-center px-2 sm:px-4 py-2 sm:py-3",
 				children: /* @__PURE__ */ u("span", {
 					className: "font-semibold text-xs sm:text-sm",
@@ -402,12 +406,12 @@ var W = ({ schema: e, className: t, style: n, ...r }) => {
 				className: "flex h-full",
 				children: v.units.map((e, t) => /* @__PURE__ */ u("div", {
 					className: "shrink-0 min-w-0 overflow-hidden px-1 sm:px-2 py-2 sm:py-3 border-r text-xs font-medium text-center",
-					style: { width: `${P(v, e.start, e.end).width}%` },
+					style: { width: `${I(v, e.start, e.end).width}%` },
 					children: e.label
 				}, t))
 			}) })] }), /* @__PURE__ */ u("div", { children: /* @__PURE__ */ d("div", {
 				className: "flex",
-				children: [/* @__PURE__ */ u(X, { children: l.map((e, t) => /* @__PURE__ */ u(Q, { children: /* @__PURE__ */ u(Ve, {
+				children: [/* @__PURE__ */ u(X, { children: l.map((e, t) => /* @__PURE__ */ u(Q, { children: /* @__PURE__ */ u(Ue, {
 					title: e.label,
 					className: "truncate",
 					children: e.label
@@ -416,14 +420,14 @@ var W = ({ schema: e, className: t, style: n, ...r }) => {
 					children: l.map((e, t) => /* @__PURE__ */ u(Q, {
 						className: "relative",
 						children: e.items.map((n, r) => {
-							let i = V(n.startDate, n.endDate, v);
-							return /* @__PURE__ */ u(He, {
+							let i = H(n.startDate, n.endDate, v);
+							return /* @__PURE__ */ u(We, {
 								start: i.start,
 								width: i.width,
 								variant: n.variant || "default",
 								onClick: () => c?.(n, e.authored, t, r),
-								title: `${n.title || ""}\n${H(n.startDate, o, f)} - ${H(n.endDate, o, f)}`,
-								children: /* @__PURE__ */ u(Ue, { children: n.title })
+								title: `${n.title || ""}\n${U(n.startDate, o, f)} - ${U(n.endDate, o, f)}`,
+								children: /* @__PURE__ */ u(Ge, { children: n.title })
 							}, r);
 						})
 					}, t))
@@ -434,14 +438,14 @@ var W = ({ schema: e, className: t, style: n, ...r }) => {
 			"data-testid": "timeline-unusable-date-range",
 			role: "alert",
 			children: p("timeline.gantt.unusableRange.inverted", {
-				minDate: z(g),
-				maxDate: z(_)
+				minDate: V(g),
+				maxDate: V(_)
 			})
 		});
 	}
 	return null;
 };
-f.register("timeline", W, {
+f.register("timeline", Ee, {
 	namespace: "plugin-timeline",
 	skipFallback: !0,
 	label: "Timeline",
@@ -473,7 +477,7 @@ f.register("timeline", W, {
 		{
 			name: "scale",
 			type: "enum",
-			enum: [...T]
+			enum: [...D]
 		},
 		{
 			name: "rowLabel",
@@ -621,37 +625,36 @@ f.register("timeline", W, {
 		}
 	}
 });
-function Te(e) {
+function De(e) {
 	return typeof e == "number" && Number.isInteger(e) && e > 0;
 }
-function Ee(e, t) {
-	return Te(e) ? e : t;
+function Oe(e, t) {
+	return De(e) ? e : t;
 }
-function De(e, t) {
-	return e == null || Te(e) ? null : `[ObjectUI] ObjectTimeline row cap: ${typeof t == "string" && t ? `object-timeline on ${t}` : "object-timeline"} declared limit: ${String(e)}, which is not a positive integer. A row cap must be a positive integer (the spec refuses zero and negative values), so it was ignored and this timeline fell back to its default row cap (100).`;
+function ke(e, t) {
+	return e == null || De(e) ? null : `[ObjectUI] ObjectTimeline row cap: ${typeof t == "string" && t ? `object-timeline on ${t}` : "object-timeline"} declared limit: ${String(e)}, which is not a positive integer. A row cap must be a positive integer (the spec refuses zero and negative values), so it was ignored and this timeline fell back to its default row cap (100).`;
 }
-var Oe = ["vertical", "horizontal"], ke = [
+var Ae = ["vertical", "horizontal"], je = [
 	"timeline.startDateField",
-	"timeline.dateField",
 	"mapping.date",
 	"startDateField",
 	"dateField"
-], Ae = S.object({
-	title: S.string().optional(),
-	date: S.string().optional(),
-	description: S.string().optional(),
-	variant: S.string().optional()
-}), je = S.object({
-	mapping: Ae.optional(),
-	objectName: S.string().optional(),
-	titleField: S.string().optional(),
-	dateField: S.string().optional(),
-	startDateField: S.string().optional(),
-	endDateField: S.string().optional(),
-	descriptionField: S.string().optional(),
-	groupByField: S.string().optional(),
-	colorField: S.string().optional(),
-	scale: S.enum([
+], Me = w.object({
+	title: w.string().optional(),
+	date: w.string().optional(),
+	description: w.string().optional(),
+	variant: w.string().optional()
+}), Ne = w.object({
+	mapping: Me.optional(),
+	objectName: w.string().optional(),
+	titleField: w.string().optional(),
+	dateField: w.string().optional(),
+	startDateField: w.string().optional(),
+	endDateField: w.string().optional(),
+	descriptionField: w.string().optional(),
+	groupByField: w.string().optional(),
+	colorField: w.string().optional(),
+	scale: w.enum([
 		"hour",
 		"day",
 		"week",
@@ -659,78 +662,78 @@ var Oe = ["vertical", "horizontal"], ke = [
 		"quarter",
 		"year"
 	]).optional()
-}), Me = ({ schema: e, dataSource: s, className: c, onRowClick: l, onItemClick: f, ...g }) => {
-	let [v, y] = a([]), [te, x] = a(() => {
+}), Pe = ({ schema: e, dataSource: s, className: c, onRowClick: l, onItemClick: f, ...g }) => {
+	let [v, b] = a([]), [ee, S] = a(() => {
 		let t = Array.isArray(e.items) && e.items.length > 0, n = Array.isArray(g.data) && g.data.length > 0;
 		return !t && !n && !!e.objectName;
-	}), [ne, re] = a(null), ie = i(0), [de, S] = a(0), C = e.timeline;
+	}), [te, ie] = a(null), C = i(0), [de, w] = a(0), T = e.timeline;
 	n(() => {
-		let t = je.safeParse(e);
+		let t = Ne.safeParse(e);
 		t.success || console.warn("[ObjectTimeline] Invalid timeline configuration:", t.error.format());
 	}, [e]), n(() => {
-		let t = De(e.limit, e.objectName);
+		let t = ke(e.limit, e.objectName);
 		t && console.warn(t);
 	}, [e.limit, e.objectName]);
-	let w = oe(e.bind), { ready: he, def: T } = fe(e.objectName ?? "", s), E = pe(), D = se(), O = le(e.filter, D), _e = JSON.stringify(O ?? null), ve = JSON.stringify(e.sort ?? null), k = !!e.objectName && !w && !e.items && !g.data, ye = ae(k ? e.objectName : void 0);
+	let E = oe(e.bind), { ready: he, def: D } = fe(e.objectName ?? "", s), O = pe(), k = se(), A = le(e.filter, k), _e = JSON.stringify(A ?? null), ve = JSON.stringify(e.sort ?? null), ye = !!e.objectName && !E && !e.items && !g.data, be = ae(ye ? e.objectName : void 0);
 	n(() => {
-		let t = ++ie.current, n = () => ie.current === t, r = async () => {
+		let t = ++C.current, n = () => C.current === t, r = async () => {
 			if (!s || typeof s.find != "function" || !e.objectName) {
-				x(!1);
+				S(!1);
 				return;
 			}
-			x(!0);
+			S(!0);
 			try {
-				let t = p(T?.fields), r = E?.isLoaded ? t.filter((t) => E.checkField(e.objectName, t, "read")) : t, i = await s.find(e.objectName, {
-					$filter: O,
+				let t = p(D?.fields), r = O?.isLoaded ? t.filter((t) => O.checkField(e.objectName, t, "read")) : t, i = await s.find(e.objectName, {
+					$filter: A,
 					$orderby: m(e.sort),
-					$top: Ee(e.limit, 100),
+					$top: Oe(e.limit, 100),
 					...r.length > 0 ? { $expand: r } : {}
 				}), a = _(i);
-				n() && (y(a), re(null));
+				n() && (b(a), ie(null));
 			} catch (e) {
-				console.error(e), n() && re(e);
+				console.error(e), n() && ie(e);
 			} finally {
-				n() && x(!1);
+				n() && S(!1);
 			}
 		};
-		if (k) {
+		if (ye) {
 			if (!he) return;
 			r();
-		} else x(!1);
+		} else S(!1);
 	}, [
 		e.objectName,
 		s,
-		w,
+		E,
 		e.items,
 		g.data,
 		de,
 		he,
-		T,
+		D,
 		_e,
 		ve,
 		e.limit,
-		E,
-		ye
+		O,
+		be
 	]);
-	let A = g.data || w || v, { t: j } = ge(), { fieldOptionLabel: be } = ue(), xe = C?.titleField ?? e.mapping?.title ?? e.titleField ?? "name", M = C?.startDateField ?? C?.dateField ?? e.mapping?.date ?? e.startDateField ?? e.dateField, N = C?.endDateField ?? e.endDateField ?? M, P = e.mapping?.description ?? e.descriptionField ?? "description", Se = e.mapping?.variant ?? "variant", F = C?.groupByField ?? e.groupByField, I = C?.colorField ?? e.colorField, L = r(() => {
+	let j = g.data || E || v, { t: M } = ge(), { fieldOptionLabel: N } = ue(), xe = re(), P = T?.titleField ?? e.mapping?.title ?? e.titleField ?? "name", F = T?.startDateField ?? e.mapping?.date ?? e.startDateField ?? e.dateField, I = T?.endDateField ?? e.endDateField ?? F, Se = e.mapping?.description ?? e.descriptionField ?? "description", L = e.mapping?.variant ?? "variant", R = T?.groupByField ?? e.groupByField, z = T?.colorField ?? e.colorField, B = r(() => {
 		if (e.items) return e.items;
-		if (!A || !Array.isArray(A) || !M) return [];
-		let t = M, n = N ?? M, r = T?.fields ?? {}, i = e.objectName || "", a = (e) => {
+		if (!j || !Array.isArray(j) || !F) return [];
+		let t = F, n = I ?? F, r = D?.fields ?? {}, i = e.objectName || "", a = (e) => {
 			if (!e || !r[e]?.options) return {};
 			let t = {};
 			for (let n of r[e].options) n && n.value != null && (t[String(n.value)] = n);
 			return t;
 		}, o = ["status", "priority"].filter((e) => r[e]), s = {};
 		for (let e of o) s[e] = a(e);
-		let c = h(r[I ?? ""]), l = (e, t, n) => {
+		let c = h(r[z ?? ""]), l = (e, t, n) => {
 			if (t == null || t === "") return null;
 			let r = n[String(t)];
 			return {
-				label: r?.label ? be(i, e, String(t), r.label) : String(t),
+				label: r?.label ? N(i, e, String(t), r.label) : String(t),
 				color: r?.color
 			};
-		}, u = A.map((e) => {
-			let r = e[t], a = e[n], u = I ? e[I] : void 0, d = F ? e[F] : void 0, f = [];
+		}, u = j.map((e) => {
+			let r = e[t], a = e[n], u = z ? e[z] : void 0, d = R ? e[R] : void 0, f = [];
 			if (i) for (let t of o) {
 				let n = l(t, e[t], s[t] || {});
 				n && f.push({
@@ -740,12 +743,12 @@ var Oe = ["vertical", "horizontal"], ke = [
 				});
 			}
 			return {
-				title: ee(e, xe),
+				title: y(e, P),
 				time: r,
 				startDate: r,
 				endDate: a,
-				description: ee(e, P),
-				variant: e[Se] || "default",
+				description: y(e, Se),
+				variant: e[L] || "default",
 				color: c(u),
 				group: d,
 				meta: f,
@@ -753,81 +756,82 @@ var Oe = ["vertical", "horizontal"], ke = [
 			};
 		}), d = (e) => {
 			if (!e) return Infinity;
-			let t = b(e).getTime();
+			let t = x(e).getTime();
 			return Number.isNaN(t) ? Infinity : t;
 		};
 		u.sort((e, t) => d(e.startDate) - d(t.startDate));
-		let f = /* @__PURE__ */ new Date(), p = (e) => new Date(e.getFullYear(), e.getMonth(), e.getDate()).getTime(), m = p(f), g = 864e5, _ = m - (f.getDay() + 6) % 7 * g + 7 * g, v = _ + 7 * g, y = (e) => {
-			if (!e) return j("timeline.bucket.noDate");
-			let t = p(b(e));
-			return Number.isNaN(t) ? j("timeline.bucket.noDate") : t < m ? j("timeline.bucket.overdue") : t === m ? j("timeline.bucket.today") : t === m + g ? j("timeline.bucket.tomorrow") : j(t < _ ? "timeline.bucket.thisWeek" : t < v ? "timeline.bucket.nextWeek" : "timeline.bucket.later");
+		let f = /* @__PURE__ */ new Date(), p = (e) => new Date(e.getFullYear(), e.getMonth(), e.getDate()).getTime(), m = (e) => new Date(f.getFullYear(), f.getMonth(), f.getDate() + e).getTime(), g = m(0), _ = m(1), v = (f.getDay() - ne(xe) + 7) % 7, b = m(7 - v), ee = m(14 - v), S = (e) => {
+			if (!e) return M("timeline.bucket.noDate");
+			let t = p(x(e));
+			return M(Number.isNaN(t) ? "timeline.bucket.noDate" : t < g ? "timeline.bucket.earlier" : t === g ? "timeline.bucket.today" : t === _ ? "timeline.bucket.tomorrow" : t < b ? "timeline.bucket.thisWeek" : t < ee ? "timeline.bucket.nextWeek" : "timeline.bucket.later");
 		};
-		if (F && !u.every((e) => e.group == null || e.group === "")) {
-			let e = a(F);
-			return u.map((t) => {
-				let n = l(F, t.group, e);
-				return {
-					...t,
-					group: n ? n.label : t.group != null && t.group !== "" ? String(t.group) : j("timeline.bucket.unassigned")
-				};
+		if (R) {
+			let e = a(R), t = u.map((t) => {
+				let n = t.group != null && t.group !== "" ? e[String(t.group)] : void 0;
+				return n?.label ? N(i, R, String(t.group), n.label) : Array.isArray(t.group) ? String(t.group) : y(t._data, R);
 			});
+			if (t.some((e) => e !== void 0)) return u.map((e, n) => ({
+				...e,
+				group: t[n] ?? M("timeline.bucket.unassigned")
+			}));
 		}
 		return u.map((e) => ({
 			...e,
-			group: y(e.startDate)
+			group: S(e.startDate)
 		}));
 	}, [
 		e.items,
-		A,
-		T,
+		j,
+		D,
 		e.objectName,
-		xe,
-		M,
-		N,
 		P,
-		Se,
-		I,
 		F,
-		j,
-		be
-	]), R = t(async () => {
-		S((e) => e + 1);
-	}, []), { ref: z, isRefreshing: Ce, pullDistance: B } = me({
-		onRefresh: R,
+		I,
+		Se,
+		L,
+		z,
+		R,
+		M,
+		N,
+		xe
+	]), V = t(async () => {
+		w((e) => e + 1);
+	}, []), { ref: Ce, isRefreshing: we, pullDistance: H } = me({
+		onRefresh: V,
 		enabled: !!e.objectName && !!s
-	}), V = ce({
+	}), U = ce({
 		navigation: e.navigation,
 		objectName: e.objectName,
 		onRowClick: l ?? f
-	}), H = C?.scale ?? e.scale, U = !!e.items;
-	if (!U && e.variant === "gantt") return /* @__PURE__ */ u("div", {
+	}), W = T?.scale ?? e.scale, Te = !!e.items;
+	if (!Te && e.variant === "gantt") return /* @__PURE__ */ u("div", {
 		className: "p-4 text-destructive",
 		"data-testid": "timeline-unsupported-variant",
 		role: "alert",
-		children: j("timeline.unsupported.objectBoundGantt", { variants: Oe.join(", ") })
+		children: M("timeline.unsupported.objectBoundGantt", { variants: Ae.join(", ") })
 	});
-	if (!U && !M) return /* @__PURE__ */ u("div", {
+	if (!Te && !F) return /* @__PURE__ */ u("div", {
 		className: "p-4 text-destructive",
 		"data-testid": "timeline-missing-date-axis",
 		role: "alert",
-		children: j("timeline.unconfigured.noDateAxis", { fields: ke.join(", ") })
+		children: M("timeline.unconfigured.noDateAxis", { fields: je.join(", ") })
 	});
-	let we = {
+	let De = {
 		...e,
-		items: L || [],
+		items: B || [],
 		className: c || e.className,
-		...H ? { scale: H } : {},
+		...W ? { scale: W } : {},
 		onItemClick: (e) => {
 			let t = e._data || e;
-			V.handleClick(t), f?.(t);
+			U.handleClick(t), f?.(t);
 		}
 	};
-	return ne ? /* @__PURE__ */ d("div", {
+	return te ? /* @__PURE__ */ d("div", {
 		className: "p-4 text-destructive",
 		"data-testid": "timeline-error",
 		role: "alert",
-		children: ["Error loading timeline: ", ne.message]
-	}) : te && (!L || L.length === 0) ? /* @__PURE__ */ d("div", {
+		children: ["Error loading timeline: ", te.message]
+	}) : ee && (!B || B.length === 0) ? /* @__PURE__ */ d("div", {
 		className: "flex flex-col h-full min-h-[200px] p-4 gap-3",
 		"data-testid": "timeline-loading",
 		role: "status",
@@ -850,18 +854,18 @@ var Oe = ["vertical", "horizontal"], ke = [
 			})]
 		}, e))]
 	}) : /* @__PURE__ */ d("div", {
-		ref: z,
+		ref: Ce,
 		className: "relative overflow-auto h-full min-w-0",
 		"data-testid": "timeline-canvas",
 		children: [
-			B > 0 && /* @__PURE__ */ u("div", {
+			H > 0 && /* @__PURE__ */ u("div", {
 				className: "flex items-center justify-center text-xs text-muted-foreground",
-				style: { height: B },
-				children: Ce ? "Refreshing…" : "Pull to refresh"
+				style: { height: H },
+				children: we ? "Refreshing…" : "Pull to refresh"
 			}),
-			/* @__PURE__ */ u(W, { schema: we }),
-			V.isOverlay && /* @__PURE__ */ u(o, {
-				...V,
+			/* @__PURE__ */ u(Ee, { schema: De }),
+			U.isOverlay && /* @__PURE__ */ u(o, {
+				...U,
 				title: "Timeline Item",
 				children: (e) => /* @__PURE__ */ u("div", {
 					className: "space-y-3",
@@ -885,20 +889,20 @@ var Oe = ["vertical", "horizontal"], ke = [
 	...t
 }));
 G.displayName = "Timeline";
-var Ne = c("ml-6", {
+var Fe = c("ml-6", {
 	variants: { density: {
 		default: "mb-10",
 		compact: "mb-3",
 		comfortable: "mb-6"
 	} },
 	defaultVariants: { density: "default" }
-}), Pe = e.forwardRef(({ className: e, density: t, ...n }, r) => /* @__PURE__ */ u("li", {
+}), Ie = e.forwardRef(({ className: e, density: t, ...n }, r) => /* @__PURE__ */ u("li", {
 	ref: r,
-	className: s(Ne({ density: t }), e),
+	className: s(Fe({ density: t }), e),
 	...n
 }));
-Pe.displayName = "TimelineItem";
-var Fe = c("absolute -left-3 w-6 h-6 rounded-full border-2 flex items-center justify-center", {
+Ie.displayName = "TimelineItem";
+var Le = c("absolute -left-3 w-6 h-6 rounded-full border-2 flex items-center justify-center", {
 	variants: { variant: {
 		default: "bg-blue-200 border-blue-400",
 		success: "bg-emerald-200 border-emerald-500",
@@ -912,16 +916,16 @@ var Fe = c("absolute -left-3 w-6 h-6 rounded-full border-2 flex items-center jus
 	defaultVariants: { variant: "default" }
 }), K = e.forwardRef(({ className: e, variant: t = "default", ...n }, r) => /* @__PURE__ */ u("div", {
 	ref: r,
-	className: s(Fe({ variant: t }), e),
+	className: s(Le({ variant: t }), e),
 	...n
 }));
 K.displayName = "TimelineMarker";
-var Ie = e.forwardRef(({ className: e, ...t }, n) => /* @__PURE__ */ u("div", {
+var Re = e.forwardRef(({ className: e, ...t }, n) => /* @__PURE__ */ u("div", {
 	ref: n,
 	className: e,
 	...t
 }));
-Ie.displayName = "TimelineContent";
+Re.displayName = "TimelineContent";
 var q = e.forwardRef(({ className: e, ...t }, n) => /* @__PURE__ */ u("h3", {
 	ref: n,
 	className: s("font-semibold text-lg mb-1", e),
@@ -940,30 +944,30 @@ var Y = e.forwardRef(({ className: e, ...t }, n) => /* @__PURE__ */ u("p", {
 	...t
 }));
 Y.displayName = "TimelineDescription";
-var Le = e.forwardRef(({ className: e, ...t }, n) => /* @__PURE__ */ u("div", {
+var ze = e.forwardRef(({ className: e, ...t }, n) => /* @__PURE__ */ u("div", {
 	ref: n,
 	className: s("relative flex overflow-x-auto py-8", e),
 	...t
 }));
-Le.displayName = "TimelineHorizontal";
-var Re = e.forwardRef(({ className: e, ...t }, n) => /* @__PURE__ */ u("div", {
+ze.displayName = "TimelineHorizontal";
+var Be = e.forwardRef(({ className: e, ...t }, n) => /* @__PURE__ */ u("div", {
 	ref: n,
 	className: s("shrink-0 w-64 relative", e),
 	...t
 }));
-Re.displayName = "TimelineHorizontalItem";
-var ze = e.forwardRef(({ className: e, ...t }, n) => /* @__PURE__ */ u("div", {
+Be.displayName = "TimelineHorizontalItem";
+var Ve = e.forwardRef(({ className: e, ...t }, n) => /* @__PURE__ */ u("div", {
 	ref: n,
 	className: s("relative w-full border rounded-lg overflow-hidden", e),
 	...t
 }));
-ze.displayName = "TimelineGantt";
-var Be = e.forwardRef(({ className: e, ...t }, n) => /* @__PURE__ */ u("div", {
+Ve.displayName = "TimelineGantt";
+var He = e.forwardRef(({ className: e, ...t }, n) => /* @__PURE__ */ u("div", {
 	ref: n,
 	className: s("flex border-b bg-gray-50", e),
 	...t
 }));
-Be.displayName = "TimelineGanttHeader";
+He.displayName = "TimelineGanttHeader";
 var X = e.forwardRef(({ className: e, ...t }, n) => /* @__PURE__ */ u("div", {
 	ref: n,
 	className: s("w-48 border-r bg-white", e),
@@ -982,13 +986,13 @@ var Q = e.forwardRef(({ className: e, ...t }, n) => /* @__PURE__ */ u("div", {
 	...t
 }));
 Q.displayName = "TimelineGanttRow";
-var Ve = e.forwardRef(({ className: e, ...t }, n) => /* @__PURE__ */ u("div", {
+var Ue = e.forwardRef(({ className: e, ...t }, n) => /* @__PURE__ */ u("div", {
 	ref: n,
 	className: s("px-4 py-2 font-medium text-sm truncate", e),
 	...t
 }));
-Ve.displayName = "TimelineGanttLabel";
-var He = e.forwardRef(({ className: e, start: t = 0, width: n = 100, variant: r = "default", ...i }, a) => /* @__PURE__ */ u("div", {
+Ue.displayName = "TimelineGanttLabel";
+var We = e.forwardRef(({ className: e, start: t = 0, width: n = 100, variant: r = "default", ...i }, a) => /* @__PURE__ */ u("div", {
 	ref: a,
 	className: s("absolute h-8 rounded-md transition-colors cursor-pointer", {
 		default: "bg-blue-500 hover:bg-blue-600",
@@ -1003,32 +1007,32 @@ var He = e.forwardRef(({ className: e, start: t = 0, width: n = 100, variant: r
 	},
 	...i
 }));
-He.displayName = "TimelineGanttBar";
-var Ue = e.forwardRef(({ className: e, ...t }, n) => /* @__PURE__ */ u("div", {
+We.displayName = "TimelineGanttBar";
+var Ge = e.forwardRef(({ className: e, ...t }, n) => /* @__PURE__ */ u("div", {
 	ref: n,
 	className: s("px-2 py-1 text-white text-xs font-medium truncate", e),
 	...t
 }));
-Ue.displayName = "TimelineGanttBarContent";
-var We = {
+Ge.displayName = "TimelineGanttBarContent";
+var Ke = {
 	filter: !0,
 	sort: !0,
 	limit: "limit"
 }, $ = g(({ schema: e, ...t }) => {
-	let { dataSource: n } = de() || {};
-	return /* @__PURE__ */ u(ie, {
+	let { dataSource: n } = de() || {}, { t: r } = ie();
+	return /* @__PURE__ */ u(C, {
 		schema: e,
-		mapping: We,
+		mapping: Ke,
 		dataSource: n,
 		testId: "object-timeline",
-		errorTitle: "This timeline’s data source could not be resolved",
-		children: (e) => /* @__PURE__ */ u(Me, {
+		errorTitle: r("element.timeline.sourceUnresolved", { defaultValue: "This timeline’s data source could not be resolved" }),
+		children: (e) => /* @__PURE__ */ u(Pe, {
 			schema: e,
 			dataSource: n,
 			...t
 		})
 	});
-}), Ge = [
+}), qe = [
 	{
 		name: "objectName",
 		type: "string",
@@ -1076,7 +1080,7 @@ var We = {
 	{
 		name: "items",
 		type: "array",
-		description: "Static inline entries — read ahead of every record source, `data` above included, and bypasses the object query entirely (the renderer becomes a pass-through). Each element is objectui's declared timeline element, `@object-ui/types`'s `TimelineFeedItem` (`variant` absent / `vertical` / `horizontal`) or `TimelineGanttItem` (`variant: 'gantt'`), the arm this node's `variant` selects. They are drawn as written: the `timeline` block’s field bindings, `mapping` and `descriptionField` do not apply to them."
+		description: "Static inline entries — read ahead of every record source, `data` above included, and bypasses the object query entirely (the renderer becomes a pass-through). Each entry is the kind this node's `variant` selects: a feed entry `{ time?, title, description?, variant?, icon?, content?, className? }` (`variant` absent / `vertical` / `horizontal`), or a gantt row `{ label, items? }` (`variant: 'gantt'`) whose bars are `{ title?, startDate?, endDate?, variant? }`, each date a string or epoch milliseconds. These are `@object-ui/types`'s `TimelineFeedItem` and `TimelineGanttItem`. They are drawn as written: the `timeline` block’s field bindings, `mapping` and `descriptionField` do not apply to them."
 	},
 	{
 		name: "dateFormat",
@@ -1111,19 +1115,19 @@ var We = {
 	{
 		name: "mapping",
 		type: "object",
-		description: "Record-to-entry field mapping ({ title, date, description, variant }) — the objectui-side binding record read BETWEEN the `timeline` block and the flat fallbacks. Its `variant` member (the field whose value picks each marker colour, renderer default `variant`) is the only spelling that binding has. On the vertical rail a colour that `timeline.colorField` resolves for an entry outranks that marker colour."
+		description: "Record-to-entry field mapping `{ title?, date?, description?, variant? }`, each a field name — the binding record read BETWEEN the `timeline` block and the flat fallbacks. Its `variant` member (the field whose value picks each marker colour, renderer default `variant`) is the only spelling that binding has. On the vertical rail a colour that `timeline.colorField` resolves for an entry outranks that marker colour."
 	}
 ];
 f.register("object-timeline", $, {
 	namespace: "plugin-timeline",
 	label: "Object Timeline",
 	category: "view",
-	inputs: [...Ge]
+	inputs: [...qe]
 }), f.register("timeline", $, {
 	namespace: "view",
 	label: "Timeline View",
 	category: "view",
-	inputs: [...Ge]
+	inputs: [...qe]
 });
 //#endregion
-export { Me as ObjectTimeline, $ as ObjectTimelineRenderer, T as TIMELINE_SCALES, G as Timeline, Ie as TimelineContent, Y as TimelineDescription, ze as TimelineGantt, He as TimelineGanttBar, Ue as TimelineGanttBarContent, Z as TimelineGanttGrid, Be as TimelineGanttHeader, Ve as TimelineGanttLabel, Q as TimelineGanttRow, X as TimelineGanttRowLabels, Le as TimelineHorizontal, Re as TimelineHorizontalItem, Pe as TimelineItem, K as TimelineMarker, W as TimelineRenderer, J as TimelineTime, q as TimelineTitle, Se as generateTimeScaleHeaders, E as resolveTimelineScale, Ne as timelineItemVariants, Fe as timelineMarkerVariants };
+export { Pe as ObjectTimeline, $ as ObjectTimelineRenderer, D as TIMELINE_SCALES, G as Timeline, Re as TimelineContent, Y as TimelineDescription, Ve as TimelineGantt, We as TimelineGanttBar, Ge as TimelineGanttBarContent, Z as TimelineGanttGrid, He as TimelineGanttHeader, Ue as TimelineGanttLabel, Q as TimelineGanttRow, X as TimelineGanttRowLabels, ze as TimelineHorizontal, Be as TimelineHorizontalItem, Ie as TimelineItem, K as TimelineMarker, Ee as TimelineRenderer, J as TimelineTime, q as TimelineTitle, Se as generateTimeScaleHeaders, O as resolveTimelineScale, Fe as timelineItemVariants, Le as timelineMarkerVariants };