@object-ui/plugin-timeline 17.6.0 → 18.0.0

package/dist/index.js

@@ -1,15 +1,16 @@
 import * as e from "react";
-import { useCallback as t, useEffect as n, useMemo as r, useState as i } from "react";
-import { NavigationOverlay as a, cn as o, cva as s, renderChildren as c } from "@object-ui/components";
-import { jsx as l, jsxs as u } from "react/jsx-runtime";
-import { ComponentRegistry as d, buildExpandFields as f, convertSortToQueryParams as p, extractRecords as m } from "@object-ui/core";
-import { createSafeTranslation as h, useDisplayLocale as g } from "@object-ui/i18n";
-import { ElementDataSourceGate as ee, useDataScope as te, useNavigationOverlay as ne, useSafeFieldLabel as re, useSchemaContext as _ } from "@object-ui/react";
-import { usePullToRefresh as ie } from "@object-ui/mobile";
-import { z as v } from "zod";
+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 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 w } from "zod";
 //#region src/useTimelineTranslation.ts
-var y = {
-	"timeline.bucket.overdue": "Overdue",
+var T = {
+	"timeline.bucket.earlier": "Earlier",
 	"timeline.bucket.today": "Today",
 	"timeline.bucket.tomorrow": "Tomorrow",
 	"timeline.bucket.thisWeek": "This week",
@@ -17,15 +18,15 @@ var y = {
 	"timeline.bucket.later": "Later",
 	"timeline.bucket.noDate": "No date",
 	"timeline.bucket.unassigned": "Unassigned",
-	"timeline.relative.today": "Today",
-	"timeline.relative.tomorrow": "Tomorrow",
-	"timeline.relative.yesterday": "Yesterday",
-	"timeline.relative.inDays": "In {{n}} days",
-	"timeline.relative.daysAgo": "{{n}} days ago",
 	"timeline.scale.week": "Week {{n}}",
 	"timeline.scale.quarter": "Q{{quarter}} {{year}}",
-	"timeline.gantt.rowLabel": "Items"
-}, b = "timeline.bucket.today", x = (e, t) => Object.entries(t ?? {}).reduce((e, [t, n]) => e.split(`{{${t}}}`).join(String(n)), y[e] || e), S = h(y, b), C = /* @__PURE__ */ new Set([
+	"timeline.gantt.rowLabel": "Items",
+	"timeline.gantt.unusableRange.malformedDate": "Unusable gantt date range — {{path}} is {{value}}, which is not a valid date. Every gantt date has to parse: the startDate and endDate on every row item, plus any minDate / maxDate pinned on the schema.",
+	"timeline.gantt.unusableRange.inverted": "Unusable gantt date range — minDate {{minDate}} is after maxDate {{maxDate}}. A pinned minDate / maxDate overrides the range computed from the rows, so this axis has no columns and no bar can be placed on it; swap the two values.",
+	"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."
+}, 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",
@@ -33,242 +34,420 @@ var y = {
 	"quarter",
 	"year"
 ]);
-function w(e) {
-	let t = e.scale ?? e.timeScale;
-	return typeof t == "string" && C.has(t) ? t : "month";
+function O(e) {
+	let t = e.scale;
+	return typeof t == "string" && D.has(t) ? t : "month";
 }
-function T(e, t, n, r = "en", i = x) {
-	let a = [], o = new Date(t), s = new Date(n);
-	if (Number.isNaN(o.getTime()) || Number.isNaN(s.getTime()) || o > s) return a;
-	let c = new Date(o);
+function k(e) {
+	return typeof e == "string" ? x(e) : new Date(e);
+}
+function A(e) {
+	let t = new Date(e);
+	return t.setHours(0, 0, 0, 0), t;
+}
+var _e = 36e5, ve = {
+	floor: (e) => {
+		let t = new Date(e);
+		return t.setMinutes(0, 0, 0), t;
+	},
+	step: (e) => {
+		e.setTime(e.getTime() + _e);
+	},
+	label: (e, t, n) => e.toLocaleString(n, {
+		month: "short",
+		day: "numeric",
+		hour: "numeric"
+	})
+}, ye = {
+	floor: A,
+	step: (e) => {
+		e.setDate(e.getDate() + 1);
+	},
+	label: (e, t, n) => e.toLocaleDateString(n, {
+		month: "short",
+		day: "numeric"
+	})
+}, be = {
+	floor: A,
+	step: (e) => {
+		e.setDate(e.getDate() + 7);
+	},
+	label: (e, t, n, r) => r("timeline.scale.week", { n: t + 1 })
+}, j = {
+	floor: (e) => {
+		let t = A(e);
+		return t.setDate(1), t;
+	},
+	step: (e) => {
+		e.setMonth(e.getMonth() + 1);
+	},
+	label: (e, t, n) => e.toLocaleDateString(n, {
+		month: "short",
+		year: "numeric"
+	})
+}, M = {
+	floor: (e) => {
+		let t = A(e);
+		return t.setMonth(Math.floor(t.getMonth() / 3) * 3, 1), t;
+	},
+	step: (e) => {
+		e.setMonth(e.getMonth() + 3);
+	},
+	label: (e, t, n, r) => r("timeline.scale.quarter", {
+		quarter: Math.floor(e.getMonth() / 3) + 1,
+		year: e.getFullYear()
+	})
+}, N = {
+	floor: (e) => {
+		let t = A(e);
+		return t.setMonth(0, 1), t;
+	},
+	step: (e) => {
+		e.setFullYear(e.getFullYear() + 1);
+	},
+	label: (e) => String(e.getFullYear())
+};
+function xe(e) {
 	switch (e) {
-		case "hour":
-			for (; c <= s;) a.push(c.toLocaleString(r, {
-				month: "short",
-				day: "numeric",
-				hour: "numeric"
-			})), c.setHours(c.getHours() + 1);
-			break;
-		case "day":
-			for (; c <= s;) a.push(c.toLocaleDateString(r, {
-				month: "short",
-				day: "numeric"
-			})), c.setDate(c.getDate() + 1);
-			break;
-		case "week": {
-			let e = 1;
-			for (; c <= s;) a.push(i("timeline.scale.week", { n: e++ })), c.setDate(c.getDate() + 7);
-			break;
-		}
-		case "quarter":
-			for (c.setMonth(Math.floor(c.getMonth() / 3) * 3, 1); c <= s;) a.push(i("timeline.scale.quarter", {
-				quarter: Math.floor(c.getMonth() / 3) + 1,
-				year: c.getFullYear()
-			})), c.setMonth(c.getMonth() + 3);
-			break;
-		case "year":
-			for (c.setMonth(0, 1); c <= s;) a.push(String(c.getFullYear())), c.setFullYear(c.getFullYear() + 1);
-			break;
-		default: for (; c <= s;) a.push(c.toLocaleDateString(r, {
-			month: "short",
-			year: "numeric"
-		})), c.setMonth(c.getMonth() + 1);
+		case "hour": return ve;
+		case "day": return ye;
+		case "week": return be;
+		case "quarter": return M;
+		case "year": return N;
+		default: return j;
+	}
+}
+function P(e) {
+	return typeof e == "string" ? ee(e) : k(e);
+}
+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;) {
+		let e = d.getTime(), t = l.label(new Date(e), u.length, r, i);
+		l.step(d), u.push({
+			start: e,
+			end: d.getTime(),
+			label: t
+		});
 	}
-	return a;
+	return {
+		start: u[0].start,
+		end: u[u.length - 1].end,
+		units: u
+	};
 }
-function E(e) {
-	let t = e.flatMap((e) => (e.items || []).flatMap((e) => [e.startDate, e.endDate])), n = Math.min(...t.map((e) => new Date(e).getTime())), r = Math.max(...t.map((e) => new Date(e).getTime()));
+function I(e, t, n) {
+	let r = e.end - e.start;
+	return {
+		start: (t - e.start) / r * 100,
+		width: (n - t) / r * 100
+	};
+}
+function Se(e, t, n, r = "en", i = he) {
+	let a = F(e, t, n, r, i);
+	return a ? a.units.map((e) => e.label) : [];
+}
+function L() {
+	let e = b(/* @__PURE__ */ new Date());
+	return {
+		minDate: e,
+		maxDate: e
+	};
+}
+function R(e) {
+	if (!Array.isArray(e)) return {
+		ok: !1,
+		path: "items",
+		value: e
+	};
+	let t = [];
+	for (let n = 0; n < e.length; n++) {
+		let r = e[n];
+		if (typeof r != "object" || !r || Array.isArray(r)) return {
+			ok: !1,
+			path: `items[${n}]`,
+			value: r
+		};
+		let i = r.items;
+		if (i && !Array.isArray(i)) return {
+			ok: !1,
+			path: `items[${n}].items`,
+			value: i
+		};
+		t.push({
+			authored: r,
+			label: r.label,
+			items: i || []
+		});
+	}
 	return {
-		minDate: new Date(n).toISOString().split("T")[0],
-		maxDate: new Date(r).toISOString().split("T")[0]
+		ok: !0,
+		rows: t
 	};
 }
-function D(e, t, n, r) {
-	let i = new Date(e).getTime(), a = new Date(t).getTime(), o = new Date(n).getTime(), s = new Date(r).getTime() - o, c = i - o, l = a - i;
+function z(e) {
+	let t = e.flatMap((e) => e.items.flatMap((e) => [e.startDate, e.endDate]));
+	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 {
-		start: c / s * 100,
-		width: l / s * 100
+		minDate: b(new Date(n)),
+		maxDate: b(new Date(r)),
+		through: i
 	};
 }
-function O(e, t, n) {
-	let r = new Date(e);
+var B = (e) => {
+	try {
+		return Date.prototype.getTime.call(e), !0;
+	} catch {
+		return !1;
+	}
+};
+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) || 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"]) {
+			let a = n[e]?.[i];
+			if (r(a)) return {
+				path: `items[${t}].items[${e}].${i}`,
+				value: a
+			};
+		}
+	}
+	for (let [e, i] of [["minDate", t], ["maxDate", n]]) if (i && r(i)) return {
+		path: e,
+		value: i
+	};
+}
+function H(e, t, n) {
+	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"
-	}) : r.toISOString().split("T")[0];
+	}) : Number.isNaN(r.getTime()) ? String(e) : v(e) ? b(r) : r.toISOString().split("T")[0];
 }
-function k({ label: e, color: t }) {
+function W({ label: e, color: t }) {
 	let n = t ? {
 		backgroundColor: `${t}22`,
 		color: t,
 		borderColor: `${t}55`
 	} : void 0;
-	return /* @__PURE__ */ l("span", {
-		className: o("inline-flex items-center rounded-full border px-2 py-0.5 text-xs font-medium", !t && "bg-muted text-muted-foreground border-transparent"),
+	return /* @__PURE__ */ u("span", {
+		className: s("inline-flex items-center rounded-full border px-2 py-0.5 text-xs font-medium", !t && "bg-muted text-muted-foreground border-transparent"),
 		style: n,
 		children: e
 	});
 }
-function A(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 j = ({ schema: e, className: t, ...n }) => {
-	let { variant: r = "vertical", items: i = [], dateFormat: a = "short", onItemClick: s } = e, d = g(), { t: f } = S();
-	if (r === "vertical") {
-		let e = A(i), r = e.some((e) => e.key !== ""), f = (e, t) => {
+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 = 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 ? O(e.time, a, d) : e.startDate ? O(e.startDate, a, d) : "", i = e.endDate && e.endDate !== e.startDate ? O(e.endDate, a, d) : "", f = Array.isArray(e.meta) ? e.meta : [];
-			return /* @__PURE__ */ u(I, {
+			} : 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: o(e.className, s && "cursor-pointer"),
-				onClick: () => s?.(e),
-				children: [/* @__PURE__ */ l(R, {
+				className: s(e.className, c && "cursor-pointer"),
+				onClick: () => c?.(e),
+				children: [/* @__PURE__ */ u(K, {
 					variant: e.color ? "default" : e.variant || "default",
 					style: n,
-					children: e.icon && /* @__PURE__ */ l("span", {
+					children: e.icon && /* @__PURE__ */ u("span", {
 						className: "text-xs",
 						children: e.icon
 					})
-				}), /* @__PURE__ */ u(z, { children: [
-					(r || i) && /* @__PURE__ */ u(V, {
+				}), /* @__PURE__ */ d(Re, { children: [
+					(r || i) && /* @__PURE__ */ d(J, {
 						dateTime: e.time || e.startDate,
 						className: "!mb-1 text-xs",
-						children: [r, i && /* @__PURE__ */ u("span", {
+						children: [r, i && /* @__PURE__ */ d("span", {
 							className: "text-muted-foreground/70",
 							children: [" → ", i]
 						})]
 					}),
-					e.title && /* @__PURE__ */ l(B, {
+					e.title && /* @__PURE__ */ u(q, {
 						className: "text-sm sm:text-base mb-1",
 						children: e.title
 					}),
-					f.length > 0 && /* @__PURE__ */ l("div", {
+					a.length > 0 && /* @__PURE__ */ u("div", {
 						className: "flex flex-wrap gap-1.5 mt-1 mb-1",
-						children: f.map((e) => /* @__PURE__ */ l(k, {
+						children: a.map((e) => /* @__PURE__ */ u(W, {
 							label: e.label,
 							color: e.color
 						}, e.key))
 					}),
-					e.description && /* @__PURE__ */ l(H, {
+					e.description && /* @__PURE__ */ u(Y, {
 						className: "text-sm text-muted-foreground line-clamp-2 sm:line-clamp-none",
 						children: e.description
 					}),
-					e.content && c(e.content)
+					l(e.content)
 				] })]
 			}, t);
 		};
-		return r ? /* @__PURE__ */ l("div", {
-			className: o("px-4 sm:px-6 py-2", t),
-			...n,
-			children: e.map((e, t) => /* @__PURE__ */ u("section", {
+		return i ? /* @__PURE__ */ u("div", {
+			...S(r),
+			className: s("px-4 sm:px-6 py-2", t),
+			style: n,
+			children: e.map((e, t) => /* @__PURE__ */ d("section", {
 				className: "mb-4",
-				children: [/* @__PURE__ */ u("header", {
+				children: [/* @__PURE__ */ d("header", {
 					className: "sticky top-0 z-10 -mx-4 sm:-mx-6 px-4 sm:px-6 py-1.5 backdrop-blur bg-background/90 text-xs font-semibold uppercase tracking-wide text-muted-foreground border-b",
-					children: [/* @__PURE__ */ l("span", { children: e.key }), /* @__PURE__ */ l("span", {
+					children: [/* @__PURE__ */ u("span", { children: e.key }), /* @__PURE__ */ u("span", {
 						className: "ml-2 text-muted-foreground/60 font-normal normal-case",
 						children: e.items.length
 					})]
-				}), /* @__PURE__ */ l(P, {
+				}), /* @__PURE__ */ u(G, {
 					className: "mt-3",
-					children: e.items.map((e, n) => f(e, `${t}-${n}`))
+					children: e.items.map((e, n) => p(e, `${t}-${n}`))
 				})]
 			}, `${e.key}-${t}`))
-		}) : /* @__PURE__ */ l(P, {
+		}) : /* @__PURE__ */ u(G, {
+			...S(r),
 			className: t,
-			...n,
-			children: i.map((e, t) => f(e, t))
+			style: n,
+			children: a.map((e, t) => p(e, t))
 		});
 	}
-	if (r === "horizontal") return /* @__PURE__ */ l(U, {
-		className: o("overflow-x-auto [-webkit-overflow-scrolling:touch]", t),
-		...n,
-		children: i.map((e, t) => /* @__PURE__ */ u(W, {
-			className: o(e.className, s && "cursor-pointer"),
-			onClick: () => s?.(e),
-			children: [/* @__PURE__ */ u("div", {
+	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(Be, {
+			className: s(e.className, c && "cursor-pointer"),
+			onClick: () => c?.(e),
+			children: [/* @__PURE__ */ d("div", {
 				className: "flex flex-col items-center",
-				children: [/* @__PURE__ */ l(R, {
+				children: [/* @__PURE__ */ u(K, {
 					variant: e.variant || "default",
-					children: e.icon && /* @__PURE__ */ l("span", {
+					children: e.icon && /* @__PURE__ */ u("span", {
 						className: "text-xs",
 						children: e.icon
 					})
-				}), /* @__PURE__ */ u("div", {
+				}), /* @__PURE__ */ d("div", {
 					className: "mt-4 text-center",
 					children: [
-						e.time && /* @__PURE__ */ l(V, {
+						e.time && /* @__PURE__ */ u(J, {
 							dateTime: e.time,
-							children: O(e.time, a, d)
+							children: U(e.time, o, f)
 						}),
-						e.title && /* @__PURE__ */ l(B, { children: e.title }),
-						e.description && /* @__PURE__ */ l(H, {
+						e.title && /* @__PURE__ */ u(q, { children: e.title }),
+						e.description && /* @__PURE__ */ u(Y, {
 							className: "text-center line-clamp-2 sm:line-clamp-none",
 							children: e.description
 						}),
-						e.content && c(e.content)
+						l(e.content)
 					]
 				})]
-			}), t < i.length - 1 && /* @__PURE__ */ l("div", { className: "absolute left-full w-16 border-t-2 border-gray-200 top-3" })]
+			}), t < a.length - 1 && /* @__PURE__ */ u("div", { className: "absolute left-full w-16 border-t-2 border-gray-200 top-3" })]
 		}, t))
 	});
-	if (r === "gantt") {
-		let r = E(i), c = e.minDate || r.minDate, p = e.maxDate || r.maxDate, m = T(w(e), c, p, d, f);
-		return /* @__PURE__ */ u(G, {
-			className: o("overflow-x-auto [-webkit-overflow-scrolling:touch]", t),
-			...n,
-			children: [/* @__PURE__ */ u(K, { children: [/* @__PURE__ */ l(q, {
+	if (i === "gantt") {
+		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: V(i.value)
+			})
+		});
+		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: V(m.value)
+			})
+		});
+		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(He, { children: [/* @__PURE__ */ u(X, {
 				className: "flex items-center px-2 sm:px-4 py-2 sm:py-3",
-				children: /* @__PURE__ */ l("span", {
+				children: /* @__PURE__ */ u("span", {
 					className: "font-semibold text-xs sm:text-sm",
-					children: e.rowLabel || f("timeline.gantt.rowLabel")
+					children: e.rowLabel || p("timeline.gantt.rowLabel")
 				})
-			}), /* @__PURE__ */ l(J, { children: /* @__PURE__ */ l("div", {
+			}), /* @__PURE__ */ u(Z, { children: /* @__PURE__ */ u("div", {
 				className: "flex h-full",
-				children: m.map((e, t) => /* @__PURE__ */ l("div", {
-					className: "flex-1 px-1 sm:px-2 py-2 sm:py-3 border-r text-xs font-medium text-center",
-					children: e
+				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: `${I(v, e.start, e.end).width}%` },
+					children: e.label
 				}, t))
-			}) })] }), /* @__PURE__ */ l("div", { children: /* @__PURE__ */ u("div", {
+			}) })] }), /* @__PURE__ */ u("div", { children: /* @__PURE__ */ d("div", {
 				className: "flex",
-				children: [/* @__PURE__ */ l(q, { children: i.map((e, t) => /* @__PURE__ */ l(Y, { children: /* @__PURE__ */ l(X, {
+				children: [/* @__PURE__ */ u(X, { children: l.map((e, t) => /* @__PURE__ */ u(Q, { children: /* @__PURE__ */ u(Ue, {
 					title: e.label,
 					className: "truncate",
 					children: e.label
-				}) }, t)) }), /* @__PURE__ */ l(J, {
+				}) }, t)) }), /* @__PURE__ */ u(Z, {
 					className: "relative",
-					children: i.map((e, t) => /* @__PURE__ */ l(Y, {
+					children: l.map((e, t) => /* @__PURE__ */ u(Q, {
 						className: "relative",
-						children: (e.items || []).map((n, r) => {
-							let i = D(n.startDate, n.endDate, c, p);
-							return /* @__PURE__ */ l(Z, {
+						children: e.items.map((n, r) => {
+							let i = H(n.startDate, n.endDate, v);
+							return /* @__PURE__ */ u(We, {
 								start: i.start,
 								width: i.width,
 								variant: n.variant || "default",
-								onClick: () => s?.(n, e, t, r),
-								title: `${n.title || ""}\n${O(n.startDate, a, d)} - ${O(n.endDate, a, d)}`,
-								children: /* @__PURE__ */ l(Q, { children: n.title })
+								onClick: () => c?.(n, e.authored, t, r),
+								title: `${n.title || ""}\n${U(n.startDate, o, f)} - ${U(n.endDate, o, f)}`,
+								children: /* @__PURE__ */ u(Ge, { children: n.title })
 							}, r);
 						})
 					}, t))
 				})]
 			}) })]
+		}) : /* @__PURE__ */ u("div", {
+			className: "p-4 text-destructive",
+			"data-testid": "timeline-unusable-date-range",
+			role: "alert",
+			children: p("timeline.gantt.unusableRange.inverted", {
+				minDate: V(g),
+				maxDate: V(_)
+			})
 		});
 	}
 	return null;
 };
-d.register("timeline", j, {
+f.register("timeline", Ee, {
 	namespace: "plugin-timeline",
+	skipFallback: !0,
 	label: "Timeline",
 	category: "data-display",
 	inputs: [
@@ -279,14 +458,11 @@ d.register("timeline", j, {
 				"vertical",
 				"horizontal",
 				"gantt"
-			],
-			label: "Timeline Variant",
-			defaultValue: "vertical"
+			]
 		},
 		{
 			name: "items",
 			type: "array",
-			label: "Timeline Items",
 			description: "For vertical/horizontal: Array of { time, title, description, variant, icon, content }. For gantt: Array of { label, items: [{ title, startDate, endDate, variant }] }"
 		},
 		{
@@ -296,43 +472,30 @@ d.register("timeline", j, {
 				"short",
 				"long",
 				"iso"
-			],
-			label: "Date Format",
-			defaultValue: "short"
+			]
 		},
 		{
-			name: "timeScale",
+			name: "scale",
 			type: "enum",
-			enum: [
-				"day",
-				"week",
-				"month"
-			],
-			label: "Time Scale (Gantt only)",
-			defaultValue: "month"
+			enum: [...D]
 		},
 		{
 			name: "rowLabel",
-			type: "string",
-			label: "Row Label (Gantt only)",
-			defaultValue: "Items"
+			type: "string"
 		},
 		{
 			name: "minDate",
 			type: "string",
-			label: "Min Date (Gantt only)",
 			description: "Override auto-calculated min date (YYYY-MM-DD)"
 		},
 		{
 			name: "maxDate",
 			type: "string",
-			label: "Max Date (Gantt only)",
 			description: "Override auto-calculated max date (YYYY-MM-DD)"
 		},
 		{
 			name: "className",
-			type: "string",
-			label: "CSS Class"
+			type: "string"
 		}
 	],
 	defaultProps: {
@@ -418,7 +581,7 @@ d.register("timeline", j, {
 		gantt: {
 			variant: "gantt",
 			dateFormat: "short",
-			timeScale: "month",
+			scale: "month",
 			rowLabel: "Projects",
 			items: [
 				{
@@ -462,22 +625,36 @@ d.register("timeline", j, {
 		}
 	}
 });
-var M = v.object({
-	title: v.string().optional(),
-	date: v.string().optional(),
-	description: v.string().optional(),
-	variant: v.string().optional()
-}), ae = v.object({
-	mapping: M.optional(),
-	objectName: v.string().optional(),
-	titleField: v.string().optional(),
-	dateField: v.string().optional(),
-	startDateField: v.string().optional(),
-	endDateField: v.string().optional(),
-	descriptionField: v.string().optional(),
-	groupByField: v.string().optional(),
-	colorField: v.string().optional(),
-	scale: v.enum([
+function De(e) {
+	return typeof e == "number" && Number.isInteger(e) && e > 0;
+}
+function Oe(e, t) {
+	return De(e) ? e : t;
+}
+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 Ae = ["vertical", "horizontal"], je = [
+	"timeline.startDateField",
+	"mapping.date",
+	"startDateField",
+	"dateField"
+], 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",
@@ -485,174 +662,182 @@ var M = v.object({
 		"quarter",
 		"year"
 	]).optional()
-}), N = ({ schema: e, dataSource: o, className: s, onRowClick: c, onItemClick: d, ...h }) => {
-	let [g, ee] = i([]), [_, v] = i(() => {
-		let t = Array.isArray(e.items) && e.items.length > 0, n = Array.isArray(h.data) && h.data.length > 0;
+}), 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;
-	}), [y, b] = i(null), [x, C] = i(0), [w, T] = i(null), E = e.timeline;
+	}), [te, ie] = a(null), C = i(0), [de, w] = a(0), T = e.timeline;
 	n(() => {
-		let t = ae.safeParse(e);
+		let t = Ne.safeParse(e);
 		t.success || console.warn("[ObjectTimeline] Invalid timeline configuration:", t.error.format());
-	}, [e]);
-	let D = te(e.bind);
-	n(() => {
-		let t = !0;
-		return (async () => {
-			if (!(!o || typeof o.getObjectSchema != "function" || !e.objectName)) try {
-				let n = await o.getObjectSchema(e.objectName);
-				t && T(n);
-			} catch (e) {
-				console.warn("Failed to fetch object def for ObjectTimeline", e);
-			}
-		})(), () => {
-			t = !1;
-		};
-	}, [e.objectName, o]);
-	let O = JSON.stringify(e.filter ?? null), k = JSON.stringify(e.sort ?? null);
+	}, [e]), n(() => {
+		let t = ke(e.limit, e.objectName);
+		t && console.warn(t);
+	}, [e.limit, e.objectName]);
+	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(() => {
-		e.objectName && !D && !e.items && !h.data ? (async () => {
-			if (!o || typeof o.find != "function" || !e.objectName) {
-				v(!1);
+		let t = ++C.current, n = () => C.current === t, r = async () => {
+			if (!s || typeof s.find != "function" || !e.objectName) {
+				S(!1);
 				return;
 			}
-			v(!0);
+			S(!0);
 			try {
-				let t = f(w?.fields), n = await o.find(e.objectName, {
-					$filter: e.filter,
-					$orderby: p(e.sort),
-					$top: e.limit ?? 100,
-					...t.length > 0 ? { $expand: t } : {}
-				}), r = m(n);
-				ee(r);
+				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: Oe(e.limit, 100),
+					...r.length > 0 ? { $expand: r } : {}
+				}), a = _(i);
+				n() && (b(a), ie(null));
 			} catch (e) {
-				console.error(e), b(e);
+				console.error(e), n() && ie(e);
 			} finally {
-				v(!1);
+				n() && S(!1);
 			}
-		})() : v(!1);
+		};
+		if (ye) {
+			if (!he) return;
+			r();
+		} else S(!1);
 	}, [
 		e.objectName,
-		o,
-		D,
+		s,
+		E,
 		e.items,
-		h.data,
-		x,
-		w,
+		g.data,
+		de,
+		he,
+		D,
+		_e,
+		ve,
+		e.limit,
 		O,
-		k,
-		e.limit
+		be
 	]);
-	let A = h.data || D || g, { t: M } = S(), { fieldOptionLabel: N } = re(), P = E?.titleField ?? e.mapping?.title ?? e.titleField ?? "name", F = E?.startDateField ?? E?.dateField ?? e.mapping?.date ?? e.startDateField ?? e.dateField ?? "date", I = E?.endDateField ?? e.endDateField ?? F, L = e.mapping?.description ?? e.descriptionField ?? "description", R = e.mapping?.variant ?? "variant", z = E?.groupByField ?? e.groupByField, B = E?.colorField ?? e.colorField, V = 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)) return [];
-		let t = w?.fields ?? {}, n = e.objectName || "", r = (e) => {
-			if (!e || !t[e]?.options) return {};
-			let n = {};
-			for (let r of t[e].options) r && r.value != null && (n[String(r.value)] = r);
-			return n;
-		}, i = r(B), a = Array.isArray(E?.metaFields) ? E.metaFields.filter((e) => typeof e == "string" && e) : ["status", "priority"].filter((e) => t[e]), o = {};
-		for (let e of a) o[e] = r(e);
-		let s = (e) => {
-			if (e == null || e === "") return;
-			let t = i[String(e)];
-			if (t?.color) return String(t.color);
-			let n = String(e);
-			if (/^#([0-9a-f]{3}){1,2}$/i.test(n) || n.startsWith("rgb") || n.startsWith("hsl")) return n;
-		}, c = (e, t, r) => {
+		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[z ?? ""]), l = (e, t, n) => {
 			if (t == null || t === "") return null;
-			let i = r[String(t)];
+			let r = n[String(t)];
 			return {
-				label: i?.label ? N(n, e, String(t), i.label) : String(t),
-				color: i?.color
+				label: r?.label ? N(i, e, String(t), r.label) : String(t),
+				color: r?.color
 			};
-		}, l = A.map((e) => {
-			let t = e[F], r = e[I], i = B ? e[B] : void 0, l = z ? e[z] : void 0, u = [];
-			if (n) for (let t of a) {
-				let n = c(t, e[t], o[t] || {});
-				n && u.push({
+		}, 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({
 					key: t,
 					label: n.label,
 					color: n.color
 				});
 			}
 			return {
-				title: e[P],
-				time: t,
-				startDate: t,
-				endDate: r,
-				description: e[L],
-				variant: e[R] || "default",
-				color: s(i),
-				group: l,
-				meta: u,
+				title: y(e, P),
+				time: r,
+				startDate: r,
+				endDate: a,
+				description: y(e, Se),
+				variant: e[L] || "default",
+				color: c(u),
+				group: d,
+				meta: f,
 				_data: e
 			};
-		});
-		l.sort((e, t) => (e.startDate ? new Date(e.startDate).getTime() : Infinity) - (t.startDate ? new Date(t.startDate).getTime() : Infinity));
-		let u = /* @__PURE__ */ new Date(), d = (e) => new Date(e.getFullYear(), e.getMonth(), e.getDate()).getTime(), f = d(u), p = 864e5, m = f - (u.getDay() + 6) % 7 * p + 7 * p, h = m + 7 * p, g = (e) => {
+		}), d = (e) => {
+			if (!e) return Infinity;
+			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 = (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 = d(new Date(e));
-			return Number.isNaN(t) ? M("timeline.bucket.noDate") : t < f ? M("timeline.bucket.overdue") : t === f ? M("timeline.bucket.today") : t === f + p ? M("timeline.bucket.tomorrow") : M(t < m ? "timeline.bucket.thisWeek" : t < h ? "timeline.bucket.nextWeek" : "timeline.bucket.later");
+			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 (z && !l.every((e) => e.group == null || e.group === "")) {
-			let e = r(z);
-			return l.map((t) => {
-				let n = c(z, t.group, e);
-				return {
-					...t,
-					group: n ? n.label : t.group != null && t.group !== "" ? String(t.group) : M("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 l.map((e) => ({
+		return u.map((e) => ({
 			...e,
-			group: g(e.startDate)
+			group: S(e.startDate)
 		}));
 	}, [
 		e.items,
-		A,
-		w,
+		j,
+		D,
 		e.objectName,
 		P,
 		F,
 		I,
+		Se,
 		L,
-		R,
-		B,
 		z,
+		R,
 		M,
-		N
-	]), H = t(async () => {
-		C((e) => e + 1);
-	}, []), { ref: U, isRefreshing: W, pullDistance: G } = ie({
-		onRefresh: H,
-		enabled: !!e.objectName && !!o
-	}), K = ne({
+		N,
+		xe
+	]), V = t(async () => {
+		w((e) => e + 1);
+	}, []), { ref: Ce, isRefreshing: we, pullDistance: H } = me({
+		onRefresh: V,
+		enabled: !!e.objectName && !!s
+	}), U = ce({
 		navigation: e.navigation,
 		objectName: e.objectName,
-		onRowClick: c ?? d
-	}), q = E?.scale ?? e.scale, J = {
+		onRowClick: l ?? f
+	}), 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: M("timeline.unsupported.objectBoundGantt", { variants: Ae.join(", ") })
+	});
+	if (!Te && !F) return /* @__PURE__ */ u("div", {
+		className: "p-4 text-destructive",
+		"data-testid": "timeline-missing-date-axis",
+		role: "alert",
+		children: M("timeline.unconfigured.noDateAxis", { fields: je.join(", ") })
+	});
+	let De = {
 		...e,
-		items: V || [],
-		className: s || e.className,
-		...q ? { timeScale: q } : {},
+		items: B || [],
+		className: c || e.className,
+		...W ? { scale: W } : {},
 		onItemClick: (e) => {
 			let t = e._data || e;
-			K.handleClick(t), d?.(t);
+			U.handleClick(t), f?.(t);
 		}
 	};
-	return y ? /* @__PURE__ */ u("div", {
+	return te ? /* @__PURE__ */ d("div", {
 		className: "p-4 text-destructive",
 		"data-testid": "timeline-error",
 		role: "alert",
-		children: ["Error loading timeline: ", y.message]
-	}) : _ && (!V || V.length === 0) ? /* @__PURE__ */ u("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",
 		"aria-live": "polite",
 		"aria-busy": "true",
-		children: [/* @__PURE__ */ l("span", {
+		children: [/* @__PURE__ */ u("span", {
 			className: "sr-only",
 			children: "Loading timeline…"
 		}), [
@@ -660,35 +845,36 @@ var M = v.object({
 			1,
 			2,
 			3
-		].map((e) => /* @__PURE__ */ u("div", {
+		].map((e) => /* @__PURE__ */ d("div", {
 			className: "flex items-start gap-3",
 			style: { opacity: Math.max(.3, 1 - e * .18) },
-			children: [/* @__PURE__ */ l("div", { className: "h-3 w-3 rounded-full bg-muted/70 animate-pulse mt-1.5 shrink-0" }), /* @__PURE__ */ u("div", {
+			children: [/* @__PURE__ */ u("div", { className: "h-3 w-3 rounded-full bg-muted/70 animate-pulse mt-1.5 shrink-0" }), /* @__PURE__ */ d("div", {
 				className: "flex-1 space-y-2",
-				children: [/* @__PURE__ */ l("div", { className: "h-4 w-1/3 rounded bg-muted/70 animate-pulse" }), /* @__PURE__ */ l("div", { className: "h-3 w-2/3 rounded bg-muted/50 animate-pulse" })]
+				children: [/* @__PURE__ */ u("div", { className: "h-4 w-1/3 rounded bg-muted/70 animate-pulse" }), /* @__PURE__ */ u("div", { className: "h-3 w-2/3 rounded bg-muted/50 animate-pulse" })]
 			})]
 		}, e))]
-	}) : /* @__PURE__ */ u("div", {
-		ref: U,
+	}) : /* @__PURE__ */ d("div", {
+		ref: Ce,
 		className: "relative overflow-auto h-full min-w-0",
+		"data-testid": "timeline-canvas",
 		children: [
-			G > 0 && /* @__PURE__ */ l("div", {
+			H > 0 && /* @__PURE__ */ u("div", {
 				className: "flex items-center justify-center text-xs text-muted-foreground",
-				style: { height: G },
-				children: W ? "Refreshing…" : "Pull to refresh"
+				style: { height: H },
+				children: we ? "Refreshing…" : "Pull to refresh"
 			}),
-			/* @__PURE__ */ l(j, { schema: J }),
-			K.isOverlay && /* @__PURE__ */ l(a, {
-				...K,
+			/* @__PURE__ */ u(Ee, { schema: De }),
+			U.isOverlay && /* @__PURE__ */ u(o, {
+				...U,
 				title: "Timeline Item",
-				children: (e) => /* @__PURE__ */ l("div", {
+				children: (e) => /* @__PURE__ */ u("div", {
 					className: "space-y-3",
-					children: Object.entries(e).map(([e, t]) => /* @__PURE__ */ u("div", {
+					children: Object.entries(e).map(([e, t]) => /* @__PURE__ */ d("div", {
 						className: "flex flex-col",
-						children: [/* @__PURE__ */ l("span", {
+						children: [/* @__PURE__ */ u("span", {
 							className: "text-xs font-medium text-muted-foreground uppercase tracking-wide",
 							children: e.replace(/_/g, " ")
-						}), /* @__PURE__ */ l("span", {
+						}), /* @__PURE__ */ u("span", {
 							className: "text-sm",
 							children: String(t ?? "—")
 						})]
@@ -697,26 +883,26 @@ var M = v.object({
 			})
 		]
 	});
-}, P = e.forwardRef(({ className: e, ...t }, n) => /* @__PURE__ */ l("ol", {
+}, G = e.forwardRef(({ className: e, ...t }, n) => /* @__PURE__ */ u("ol", {
 	ref: n,
-	className: o("relative ml-3 border-l border-gray-200", e),
+	className: s("relative ml-3 border-l border-gray-200", e),
 	...t
 }));
-P.displayName = "Timeline";
-var F = s("ml-6", {
+G.displayName = "Timeline";
+var Fe = c("ml-6", {
 	variants: { density: {
 		default: "mb-10",
 		compact: "mb-3",
 		comfortable: "mb-6"
 	} },
 	defaultVariants: { density: "default" }
-}), I = e.forwardRef(({ className: e, density: t, ...n }, r) => /* @__PURE__ */ l("li", {
+}), Ie = e.forwardRef(({ className: e, density: t, ...n }, r) => /* @__PURE__ */ u("li", {
 	ref: r,
-	className: o(F({ density: t }), e),
+	className: s(Fe({ density: t }), e),
 	...n
 }));
-I.displayName = "TimelineItem";
-var L = s("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",
@@ -728,87 +914,87 @@ var L = s("absolute -left-3 w-6 h-6 rounded-full border-2 flex items-center just
 		done: "bg-emerald-200 border-emerald-500"
 	} },
 	defaultVariants: { variant: "default" }
-}), R = e.forwardRef(({ className: e, variant: t = "default", ...n }, r) => /* @__PURE__ */ l("div", {
+}), K = e.forwardRef(({ className: e, variant: t = "default", ...n }, r) => /* @__PURE__ */ u("div", {
 	ref: r,
-	className: o(L({ variant: t }), e),
+	className: s(Le({ variant: t }), e),
 	...n
 }));
-R.displayName = "TimelineMarker";
-var z = e.forwardRef(({ className: e, ...t }, n) => /* @__PURE__ */ l("div", {
+K.displayName = "TimelineMarker";
+var Re = e.forwardRef(({ className: e, ...t }, n) => /* @__PURE__ */ u("div", {
 	ref: n,
 	className: e,
 	...t
 }));
-z.displayName = "TimelineContent";
-var B = e.forwardRef(({ className: e, ...t }, n) => /* @__PURE__ */ l("h3", {
+Re.displayName = "TimelineContent";
+var q = e.forwardRef(({ className: e, ...t }, n) => /* @__PURE__ */ u("h3", {
 	ref: n,
-	className: o("font-semibold text-lg mb-1", e),
+	className: s("font-semibold text-lg mb-1", e),
 	...t
 }));
-B.displayName = "TimelineTitle";
-var V = e.forwardRef(({ className: e, ...t }, n) => /* @__PURE__ */ l("time", {
+q.displayName = "TimelineTitle";
+var J = e.forwardRef(({ className: e, ...t }, n) => /* @__PURE__ */ u("time", {
 	ref: n,
-	className: o("text-sm font-normal text-gray-500 mb-2 block", e),
+	className: s("text-sm font-normal text-gray-500 mb-2 block", e),
 	...t
 }));
-V.displayName = "TimelineTime";
-var H = e.forwardRef(({ className: e, ...t }, n) => /* @__PURE__ */ l("p", {
+J.displayName = "TimelineTime";
+var Y = e.forwardRef(({ className: e, ...t }, n) => /* @__PURE__ */ u("p", {
 	ref: n,
-	className: o("text-base text-gray-700", e),
+	className: s("text-base text-gray-700", e),
 	...t
 }));
-H.displayName = "TimelineDescription";
-var U = e.forwardRef(({ className: e, ...t }, n) => /* @__PURE__ */ l("div", {
+Y.displayName = "TimelineDescription";
+var ze = e.forwardRef(({ className: e, ...t }, n) => /* @__PURE__ */ u("div", {
 	ref: n,
-	className: o("relative flex overflow-x-auto py-8", e),
+	className: s("relative flex overflow-x-auto py-8", e),
 	...t
 }));
-U.displayName = "TimelineHorizontal";
-var W = e.forwardRef(({ className: e, ...t }, n) => /* @__PURE__ */ l("div", {
+ze.displayName = "TimelineHorizontal";
+var Be = e.forwardRef(({ className: e, ...t }, n) => /* @__PURE__ */ u("div", {
 	ref: n,
-	className: o("shrink-0 w-64 relative", e),
+	className: s("shrink-0 w-64 relative", e),
 	...t
 }));
-W.displayName = "TimelineHorizontalItem";
-var G = e.forwardRef(({ className: e, ...t }, n) => /* @__PURE__ */ l("div", {
+Be.displayName = "TimelineHorizontalItem";
+var Ve = e.forwardRef(({ className: e, ...t }, n) => /* @__PURE__ */ u("div", {
 	ref: n,
-	className: o("relative w-full border rounded-lg overflow-hidden", e),
+	className: s("relative w-full border rounded-lg overflow-hidden", e),
 	...t
 }));
-G.displayName = "TimelineGantt";
-var K = e.forwardRef(({ className: e, ...t }, n) => /* @__PURE__ */ l("div", {
+Ve.displayName = "TimelineGantt";
+var He = e.forwardRef(({ className: e, ...t }, n) => /* @__PURE__ */ u("div", {
 	ref: n,
-	className: o("flex border-b bg-gray-50", e),
+	className: s("flex border-b bg-gray-50", e),
 	...t
 }));
-K.displayName = "TimelineGanttHeader";
-var q = e.forwardRef(({ className: e, ...t }, n) => /* @__PURE__ */ l("div", {
+He.displayName = "TimelineGanttHeader";
+var X = e.forwardRef(({ className: e, ...t }, n) => /* @__PURE__ */ u("div", {
 	ref: n,
-	className: o("w-48 border-r bg-white", e),
+	className: s("w-48 border-r bg-white", e),
 	...t
 }));
-q.displayName = "TimelineGanttRowLabels";
-var J = e.forwardRef(({ className: e, ...t }, n) => /* @__PURE__ */ l("div", {
+X.displayName = "TimelineGanttRowLabels";
+var Z = e.forwardRef(({ className: e, ...t }, n) => /* @__PURE__ */ u("div", {
 	ref: n,
-	className: o("flex-1 overflow-x-auto", e),
+	className: s("flex-1 overflow-x-auto", e),
 	...t
 }));
-J.displayName = "TimelineGanttGrid";
-var Y = e.forwardRef(({ className: e, ...t }, n) => /* @__PURE__ */ l("div", {
+Z.displayName = "TimelineGanttGrid";
+var Q = e.forwardRef(({ className: e, ...t }, n) => /* @__PURE__ */ u("div", {
 	ref: n,
-	className: o("flex items-center border-b min-h-12", e),
+	className: s("flex items-center border-b min-h-12", e),
 	...t
 }));
-Y.displayName = "TimelineGanttRow";
-var X = e.forwardRef(({ className: e, ...t }, n) => /* @__PURE__ */ l("div", {
+Q.displayName = "TimelineGanttRow";
+var Ue = e.forwardRef(({ className: e, ...t }, n) => /* @__PURE__ */ u("div", {
 	ref: n,
-	className: o("px-4 py-2 font-medium text-sm truncate", e),
+	className: s("px-4 py-2 font-medium text-sm truncate", e),
 	...t
 }));
-X.displayName = "TimelineGanttLabel";
-var Z = e.forwardRef(({ className: e, start: t = 0, width: n = 100, variant: r = "default", ...i }, a) => /* @__PURE__ */ l("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: o("absolute h-8 rounded-md transition-colors cursor-pointer", {
+	className: s("absolute h-8 rounded-md transition-colors cursor-pointer", {
 		default: "bg-blue-500 hover:bg-blue-600",
 		success: "bg-green-500 hover:bg-green-600",
 		warning: "bg-yellow-500 hover:bg-yellow-600",
@@ -821,70 +1007,127 @@ var Z = e.forwardRef(({ className: e, start: t = 0, width: n = 100, variant: r =
 	},
 	...i
 }));
-Z.displayName = "TimelineGanttBar";
-var Q = e.forwardRef(({ className: e, ...t }, n) => /* @__PURE__ */ l("div", {
+We.displayName = "TimelineGanttBar";
+var Ge = e.forwardRef(({ className: e, ...t }, n) => /* @__PURE__ */ u("div", {
 	ref: n,
-	className: o("px-2 py-1 text-white text-xs font-medium truncate", e),
+	className: s("px-2 py-1 text-white text-xs font-medium truncate", e),
 	...t
 }));
-Q.displayName = "TimelineGanttBarContent";
-var oe = {
+Ge.displayName = "TimelineGanttBarContent";
+var Ke = {
 	filter: !0,
 	sort: !0,
 	limit: "limit"
-}, $ = ({ schema: e, ...t }) => {
-	let { dataSource: n } = _() || {};
-	return /* @__PURE__ */ l(ee, {
+}, $ = g(({ schema: e, ...t }) => {
+	let { dataSource: n } = de() || {}, { t: r } = ie();
+	return /* @__PURE__ */ u(C, {
 		schema: e,
-		mapping: oe,
+		mapping: Ke,
 		dataSource: n,
 		testId: "object-timeline",
-		errorTitle: "This timeline’s data source could not be resolved",
-		children: (e) => /* @__PURE__ */ l(N, {
+		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
 		})
 	});
-};
-d.register("object-timeline", $, {
-	namespace: "plugin-timeline",
-	label: "Object Timeline",
-	category: "view",
-	inputs: [{
+}), qe = [
+	{
 		name: "objectName",
 		type: "string",
-		label: "Object Name",
-		required: !0
-	}, {
+		description: "Object this timeline binds to. Optional because the component-level `dataSource` binding can supply the object instead — this block registers through `ElementDataSourceGate`, which lowers the binding onto this key before the renderer sees the node. A timeline drawn from `items`, `data` or a `bind` path issues no query and needs none to draw, but `navigation` still reads it: without it `page` opens nothing and `new_window` / `openNewTab` open no record page."
+	},
+	{
 		name: "variant",
 		type: "enum",
 		enum: [
 			"vertical",
 			"horizontal",
 			"gantt"
+		]
+	},
+	{
+		name: "filter",
+		type: "array",
+		description: "Base query filter in the rule-array form `[{ field, operator, value }, ...]`, narrowing the records the timeline fetches. Context tokens such as `{current_user_id}` are resolved first, then the filter is lowered to `$filter` on the query. Authored `items` or `data` suppress that query, so the key then narrows nothing. The MongoDB-style record form is not this key’s shape."
+	},
+	{
+		name: "sort",
+		type: "array",
+		description: "Order of the records the timeline fetches, in `[{ field, order }]` form, lowered to `$orderby` on the same query. The rail draws entries composed from records by their start date, earliest first, whatever this order. Authored `items` or `data` suppress the query, so the key then orders nothing."
+	},
+	{
+		name: "navigation",
+		type: "object",
+		description: "What an entry click opens — the `{ mode, size, openNewTab, preventNavigation }` block a list view declares. With the key ABSENT a click opens nothing: this renderer supplies no drawer default. `mode` is an overlay (`drawer`, `modal`, `split`, `popover`), `new_window`, `page` or `none`, and a block written without `mode` takes the spec’s `page` default. `drawer`, `modal` and `popover` open the entry’s record in that overlay, but `split` opens nothing, because the timeline hands the split shell no main panel; `new_window` opens the record page in a new tab; `none` opens nothing. `page` opens the record page of the timeline’s `objectName` through the record navigator the host publishes (the console publishes one on its custom pages, record pages and list views); under a host that publishes none, such as an embedded renderer, or on a timeline that names no `objectName`, there is no record page to open and the click opens nothing. `preventNavigation: true` opens nothing whatever the mode, `openNewTab: true` opens the record page in a new tab and outranks every mode except `none`, and `size` sets the overlay width. On a timeline that names no `objectName`, `new_window` and `openNewTab` open no record page either: the new tab’s address is a slash and the entry’s `id` alone (its `_id` when it has no `id`, `undefined` when it has neither). A click handler from a parent view outranks the whole key."
+	},
+	{
+		name: "timeline",
+		type: "object",
+		description: "Timeline configuration, the author face — the same block `ListViewSchema.timeline` declares: { startDateField, endDateField, titleField, groupByField, colorField, scale }. The flat top-level spellings beside it are the runtime handoff, not a second authoring spelling. On entries composed from records, `startDateField` is the entry’s date, `endDateField` the end printed after it, `titleField` the title, `groupByField` the field whose value heads each group (without it, entries group into date buckets), and `colorField` the field whose option colour, or the value itself when it is a colour literal, paints the marker. Each outranks the flat key of the same binding, and `titleField` / `startDateField` outrank `mapping`’s `title` / `date`. `scale` sets the axis unit of the gantt branch, which on this block draws authored `items` only."
+	},
+	{
+		name: "limit",
+		type: "number",
+		description: "Maximum number of records loaded onto the rail (row cap); lowered to the query's top-level `$top` (renderer default 100). A timeline renders one rail with no pagination control, so this is the author's window rather than a page size. A value that is not a positive integer is ignored with a console warning, and the default cap applies."
+	},
+	{
+		name: "data",
+		type: "array",
+		description: "Pre-fetched records — read FIRST as the rail's row source, ahead of the data-scope binding and the fetch, and composed into entries through the same `timeline` field bindings a fetched row takes; authoring it suppresses the object query entirely. Distinct from `items`, which is the already-composed entry shape and wins over this key when both are written."
+	},
+	{
+		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 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",
+		type: "enum",
+		enum: [
+			"short",
+			"long",
+			"iso"
 		],
-		defaultValue: "vertical"
-	}]
-}), d.register("timeline", $, {
+		description: "How each entry's date is rendered (renderer default `short`): `short` / `long` are locale-formatted, `iso` is the locale-free machine form."
+	},
+	{
+		name: "rowLabel",
+		type: "string",
+		description: "Header label for the gantt row column — read by the gantt branch only, which on this block needs authored `items`. Without it the header shows the default label."
+	},
+	{
+		name: "minDate",
+		type: "string",
+		description: "Pin the gantt axis start (ISO `yyyy-mm-dd`) instead of deriving it from the rows; only a non-empty value is honoured. A value that is not a date, or a `minDate` after `maxDate`, refuses the chart with a diagnostic naming it."
+	},
+	{
+		name: "maxDate",
+		type: "string",
+		description: "Pin the gantt axis end (ISO `yyyy-mm-dd`) instead of deriving it from the rows; only a non-empty value is honoured. A value that is not a date, or a `maxDate` before `minDate`, refuses the chart with a diagnostic naming it."
+	},
+	{
+		name: "descriptionField",
+		type: "string",
+		description: "Field rendered as each entry's description (renderer default `description`). It is declared flat because the `timeline` block has no member for it, and `mapping.description` outranks it when both are written."
+	},
+	{
+		name: "mapping",
+		type: "object",
+		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: [...qe]
+}), f.register("timeline", $, {
 	namespace: "view",
 	label: "Timeline View",
 	category: "view",
-	inputs: [{
-		name: "objectName",
-		type: "string",
-		label: "Object Name",
-		required: !0
-	}, {
-		name: "variant",
-		type: "enum",
-		enum: [
-			"vertical",
-			"horizontal",
-			"gantt"
-		],
-		defaultValue: "vertical"
-	}]
+	inputs: [...qe]
 });
 //#endregion
-export { N as ObjectTimeline, $ as ObjectTimelineRenderer, C as TIMELINE_SCALES, P as Timeline, z as TimelineContent, H as TimelineDescription, G as TimelineGantt, Z as TimelineGanttBar, Q as TimelineGanttBarContent, J as TimelineGanttGrid, K as TimelineGanttHeader, X as TimelineGanttLabel, Y as TimelineGanttRow, q as TimelineGanttRowLabels, U as TimelineHorizontal, W as TimelineHorizontalItem, I as TimelineItem, R as TimelineMarker, j as TimelineRenderer, V as TimelineTime, B as TimelineTitle, T as generateTimeScaleHeaders, w as resolveTimelineScale, F as timelineItemVariants, L 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 };