@object-ui/plugin-map 17.5.0 → 17.7.0

package/dist/index.js

@@ -1,44 +1,43 @@
 import { useCallback as e, useEffect as t, useMemo as n, useRef as r, useState as i } from "react";
-import { ComponentRegistry as a, buildExpandFields as o, extractRecords as s } from "@object-ui/core";
-import { ElementDataSourceGate as c, useNavigationOverlay as l, useSchemaContext as u } from "@object-ui/react";
-import { NavigationOverlay as ee, cn as d, useIsMobile as f } from "@object-ui/components";
-import { z as p } from "zod";
-import te, { Marker as m, NavigationControl as h, Popup as ne } from "react-map-gl/maplibre";
+import { ComponentRegistry as a, ValueDataSource as o, applyNonGridRowCeiling as s, buildExpandFields as ee, convertSortToQueryParams as te, elementDataSourceBlock as c, getRecordDisplayName as ne, nonGridRowCeilingQuery as re, recordDisplayValueAt as l, resolveRecordSourceConfig as u, resolveRecordSourceObjectName as ie } from "@object-ui/core";
+import { ElementDataSourceGate as d, NonGridRowCeilingNote as ae, useDataInvalidation as oe, useFilterScope as se, useNavigationOverlay as ce, useResolvedFilter as le, useSchemaContext as ue, useSettledSchema as de } from "@object-ui/react";
+import { ObjectMapConfigSchema as f } from "@object-ui/types/zod";
+import { NavigationOverlay as fe, cn as p, useIsMobile as pe } from "@object-ui/components";
+import { usePermissions as me } from "@object-ui/permissions";
+import he, { Marker as m, NavigationControl as ge, Popup as _e } from "react-map-gl/maplibre";
 import "maplibre-gl/dist/maplibre-gl.css";
-import { jsx as g, jsxs as _ } from "react/jsx-runtime";
-//#region src/ObjectMap.tsx
-var v = p.object({
-	latitudeField: p.string().optional(),
-	longitudeField: p.string().optional(),
-	locationField: p.string().optional(),
-	titleField: p.string().optional(),
-	descriptionField: p.string().optional(),
-	zoom: p.number().optional(),
-	center: p.tuple([p.number(), p.number()]).optional(),
-	style: p.string().optional()
-}), re = "https://demotiles.maplibre.org/style.json";
-function ie(e) {
-	return e.data ? e.data : e.staticData ? {
-		provider: "value",
-		items: e.staticData
-	} : e.objectName ? {
-		provider: "object",
-		object: e.objectName
-	} : null;
+import { jsx as h, jsxs as g } from "react/jsx-runtime";
+function _(e) {
+	return e >= -180 && e < 180 ? e : ((e + 180) % 360 + 360) % 360 - 180;
 }
-function y(e) {
-	if (e) {
-		if (typeof e == "string") {
-			let t = e.split(" "), n = t[0], r = t[1]?.toLowerCase() === "desc" ? "desc" : "asc";
-			return { [n]: r };
-		}
-		if (Array.isArray(e)) return e.reduce((e, t) => (t.field && t.order && (e[t.field] = t.order), e), {});
+var v = (e) => Math.min(85, Math.max(-85, e));
+function ve(e) {
+	if (e.length === 0) return null;
+	let t = e.map(([e]) => _(e)).sort((e, t) => e - t), n = e.map(([, e]) => v(e)), r = t.length, i = t[0] + 360 - t[r - 1], a = 0;
+	for (let e = 1; e < r; e++) {
+		let n = t[e] - t[e - 1];
+		n > i && (i = n, a = e);
 	}
+	let o = t[a], s = t[(a + r - 1) % r], ee = a === 0 ? s : s + 360;
+	return [[o, Math.min(...n)], [ee, Math.max(...n)]];
+}
+function ye(e) {
+	let [[t, n], [r, i]] = e;
+	return {
+		longitude: _((t + r) / 2),
+		latitude: (n + i) / 2
+	};
+}
+//#endregion
+//#region src/ObjectMap.tsx
+var be = "https://demotiles.maplibre.org/style.json", y = Object.keys(f.shape).filter((e) => e !== "style");
+function xe(e) {
+	return u(e, "view-data");
 }
 var b = () => globalThis.process?.env?.NODE_ENV !== "production", x = /* @__PURE__ */ new Set();
-function S(e) {
+function Se(e) {
 	if (!b()) return;
-	let t = e?.filter;
+	let t = e.filter;
 	if (!t || typeof t != "object" || Array.isArray(t) || !Object.prototype.hasOwnProperty.call(t, "map")) return;
 	let n = t.map;
 	if (!n || typeof n != "object") return;
@@ -48,41 +47,49 @@ function S(e) {
 	} catch {
 		r = `${e.type ?? "map"}::${e.objectName ?? ""}::<unserializable>`;
 	}
-	x.has(r) || (x.add(r), console.warn("[ObjectMap] `filter.map` is no longer read as map configuration, so this map is rendering with the DEFAULT field names (`latitude` / `longitude` / `name`). `filter` is the query filter; the map config belongs under the declared `map` input — move it to `schema.map` (`{ type: 'object-map', map: { latitudeField, longitudeField, titleField } }`). The old spelling was never documented and could not survive a `dataSource` binding, whose merged filter is an `and` node with no `map` key at all (objectstack#7121). If `map` is genuinely a field you are filtering on, ignore this — the filter itself is passed through untouched. objectui#4034."));
+	x.has(r) || (x.add(r), console.warn("[ObjectMap] `filter.map` is no longer read as map configuration, so this map has NO coordinate binding and renders the \"Map configuration required\" refusal (objectui#8169 — the `latitude` / `longitude` / `location` defaults are gone). `filter` is the query filter; the map config belongs under the declared `map` input — move it to `schema.map` (`{ type: 'object-map', map: { latitudeField, longitudeField, titleField } }`). The old spelling was never documented and could not survive a `dataSource` binding, whose merged filter is an `and` node with no `map` key at all (objectstack#7121). If `map` is genuinely a field you are filtering on, ignore this — the filter itself is passed through untouched. objectui#4034."));
 }
+var S = /* @__PURE__ */ new Set();
 function C(e) {
-	S(e);
-	let t = e.style || e.mapStyle || e.map?.style;
-	if (e.locationField || e.latitudeField) return {
+	if (!b()) return;
+	let t = e.style;
+	if (typeof t != "string" || t === "") return;
+	let n = `${e.type ?? "map"}::${e.objectName ?? ""}::${t}`;
+	S.has(n) || (S.add(n), console.warn(`[ObjectMap] A top-level \`style\` is NOT read as a map style, so this map is rendering with the DEFAULT public demo tiles and \`${t}\` was dropped. \`style\` is the base schema's INLINE CSS key (a record of CSS properties), which every node may carry; the map style is \`mapStyle\` — named that way precisely to avoid this collision. Write \`mapStyle: '${t}'\` at the top level, or \`map: { style: '${t}' }\` in the declared config block. On a view, write that same declared \`map: { style: ... }\`: ObjectView / ListView flatten \`options.map\` through a whitelist of the keys \`ObjectMapConfigSchema\` declares, and that whitelist carries \`style\` out under the flat spelling \`mapStyle\` (objectui#9950), so the declared block arrives and is read. \`mapStyle\` is the TOP-LEVEL spelling only — inside the \`map\` block it is undeclared, and the flatten drops it. objectui#5017.`));
+}
+var w = /* @__PURE__ */ new Set();
+function T(e) {
+	if (!b()) return;
+	let t = y.filter((t) => e[t] !== void 0);
+	if (t.length === 0) return;
+	let n = `${e.type ?? "map"}::${e.objectName ?? ""}::${t.join(",")}`;
+	w.has(n) || (w.add(n), console.warn(`[ObjectMap] The \`map\` block configures this map, so these top-level keys are IGNORED: ${t.map((e) => `\`${e}\``).join(", ")}. The \`map\` block is the authoring shape; the flat top-level spelling is the internal form ObjectView/ListView produce when they flatten \`options.map\`, and what the author wrote outranks it. Move anything you still need into \`map\`, or drop the \`map\` block. objectui#5018.`));
+}
+function Ce(e) {
+	Se(e), C(e);
+	let t = e.mapStyle || e.map?.style, n = e.map ?? null;
+	if (n) {
+		let r = f.safeParse(n);
+		return r.success || console.warn("[ObjectMap] Invalid map configuration:", r.error.format()), T(e), {
+			...n,
+			style: t
+		};
+	}
+	return e.locationField || e.latitudeField ? {
 		locationField: e.locationField,
 		latitudeField: e.latitudeField,
 		longitudeField: e.longitudeField,
-		titleField: e.titleField || "name",
+		titleField: e.titleField,
 		descriptionField: e.descriptionField,
 		zoom: e.zoom,
 		center: e.center,
 		style: t
-	};
-	let n = e.map ? e.map : null;
-	if (n) {
-		let e = v.safeParse(n);
-		return e.success || console.warn("[ObjectMap] Invalid map configuration:", e.error.format()), {
-			...n,
-			style: n.style || t
-		};
-	}
-	return {
-		latitudeField: "latitude",
-		longitudeField: "longitude",
-		locationField: "location",
-		titleField: "name",
-		descriptionField: "description",
-		zoom: 10,
-		center: [0, 0],
-		style: t
-	};
+	} : { style: t };
+}
+function we(e) {
+	return !!e.locationField || !!(e.latitudeField && e.longitudeField);
 }
-function ae(e, t) {
+function Te(e, t) {
 	if (t.latitudeField && t.longitudeField) {
 		let n = e[t.latitudeField], r = e[t.longitudeField];
 		if (typeof n == "number" && typeof r == "number") return [n, r];
@@ -104,7 +111,7 @@ function ae(e, t) {
 	}
 	return null;
 }
-function oe(e, t, n = 50) {
+function Ee(e, t, n = 50) {
 	if (e.length <= 1 || t >= 15) return e.map((e) => ({
 		id: e.id,
 		coordinates: e.coordinates,
@@ -135,102 +142,114 @@ function oe(e, t, n = 50) {
 		}
 	}), a;
 }
-var w = ({ schema: a, dataSource: c, className: u, onMarkerClick: p, onRowClick: v, onEdit: b, onDelete: x, enableClustering: S, clusterRadius: w = 50, ...T }) => {
-	let [E, D] = i([]), [se, O] = i(!0), [k, A] = i(null), [j, M] = i(null), [N, P] = i(null), [F, ce] = i(""), I = f(), L = r(null), [R, le] = i(null), [z, B] = i(null), [V, H] = i(!1), [U, ue] = i(null), de = e((e) => {
-		ue(e?.error?.message || "Failed to load the map style/tiles.");
-	}, []), fe = e(() => {
+var E = ({ schema: a, dataSource: c, className: u, data: d, onMarkerClick: ue, onRowClick: f, onEdit: _, onDelete: v, enableClustering: y, clusterRadius: b = 50 }) => {
+	let [x, Se] = i([]), [S, C] = i(!0), [w, T] = i(null), [E, De] = i(null), [D, O] = i(null), [k, Oe] = i(""), ke = pe(), A = r(null), [j, Ae] = i(null), [je, M] = i(null), [Me, N] = i(!1), [Ne, Pe] = i(null), Fe = e((e) => {
+		Pe(e?.error?.message || "Failed to load the map style/tiles.");
+	}, []), Ie = e(() => {
 		if (typeof navigator > "u" || !navigator.geolocation) {
-			B("Geolocation is not available in this browser.");
+			M("Geolocation is not available in this browser.");
 			return;
 		}
-		H(!0), B(null), navigator.geolocation.getCurrentPosition((e) => {
+		N(!0), M(null), navigator.geolocation.getCurrentPosition((e) => {
 			let { longitude: t, latitude: n } = e.coords;
-			le({
+			Ae({
 				lng: t,
 				lat: n
-			}), H(!1);
+			}), N(!1);
 			try {
-				L.current?.flyTo({
+				A.current?.flyTo({
 					center: [t, n],
 					zoom: 12,
 					duration: 800
 				});
 			} catch {}
 		}, (e) => {
-			H(!1), B(e.message || "Unable to retrieve location.");
+			N(!1), M(e.message || "Unable to retrieve location.");
 		}, {
 			enableHighAccuracy: !1,
 			timeout: 8e3,
 			maximumAge: 6e4
 		});
-	}, []), W = ie(a), G = n(() => W, [JSON.stringify(W)]), K = C(a), q = G?.provider === "value";
+	}, []), P = n(() => xe(a), [a]), F = n(() => Ce(a), [a]), I = P?.provider === "value", L = P?.provider, R = P?.provider === "object" ? P.object : void 0, z = P?.provider === "value" ? P.items : void 0, Le = ie(a, P), { ready: Re, def: B } = de(Le ?? "", I ? void 0 : c), V = me(), H = !Array.isArray(d) && L === "object", U = oe(H ? R : void 0), ze = r(U), Be = r(null), W = r(0), Ve = se(), G = le(a.filter, Ve);
 	t(() => {
-		(async () => {
+		if (H && !Re) {
+			C(!0);
+			return;
+		}
+		let e = [
+			d,
+			L,
+			R,
+			z,
+			c,
+			I,
+			G,
+			a.sort,
+			B,
+			V
+		], t = Be.current, n = t !== null && t.length === e.length && e.every((e, n) => Object.is(e, t[n])), r = U !== ze.current;
+		ze.current = U;
+		let i = r && n, ne = ++W.current, l = () => W.current === ne, u = (t, n) => {
+			l() && (Se(t), De(n), T(null), Be.current = e);
+		};
+		return (async () => {
 			try {
-				if (O(!0), T.data) {
-					let e = T.data;
-					if (Array.isArray(e)) {
-						D(e), O(!1);
-						return;
-					}
-				}
-				if (a.data) {
-					let e = a.data;
-					if (Array.isArray(e)) {
-						D(e), O(!1);
-						return;
-					}
+				if (i || C(!0), Array.isArray(d)) {
+					u(d, null);
+					return;
 				}
-				if (q && G?.provider === "value") {
-					D(G.items), O(!1);
+				if (I && L === "value") {
+					let e = await new o({ items: z ?? [] }).find("", {
+						$filter: G,
+						$orderby: te(a.sort),
+						...re()
+					}), t = s(e);
+					u(t.rows, t);
 					return;
 				}
 				if (!c || typeof c.find != "function") throw Error("DataSource required for object/api providers");
-				if (G?.provider === "object") {
-					let e = G.object, t = o(j?.fields), n = await c.find(e, {
-						$filter: a.filter,
-						$orderby: y(a.sort),
-						...t.length > 0 ? { $expand: t } : {}
-					}), r = s(n);
-					D(r);
-				} else G?.provider === "api" && (console.warn("API provider not yet implemented for ObjectMap"), D([]));
-				O(!1);
+				if (L === "object") {
+					let e = R, t = ee(B?.fields), n = V?.isLoaded ? t.filter((t) => V.checkField(e, t, "read")) : t, r = await c.find(e, {
+						$filter: G,
+						$orderby: te(a.sort),
+						...re(),
+						...n.length > 0 ? { $expand: n } : {}
+					}), i = s(r);
+					u(i.rows, i);
+				} else L === "api" && (console.warn("API provider not yet implemented for ObjectMap"), u([], null));
 			} catch (e) {
-				A(e), O(!1);
+				i ? console.error("[ObjectMap] Failed to refresh data:", e) : l() && T(e);
+			} finally {
+				l() && C(!1);
 			}
-		})();
+		})(), () => {
+			W.current += 1;
+		};
 	}, [
-		G,
+		d,
+		L,
+		R,
+		z,
 		c,
-		q,
-		a.filter,
+		I,
+		G,
 		a.sort,
-		j
-	]), t(() => {
-		!q && c && (async () => {
-			try {
-				if (!c) return;
-				let e = G?.provider === "object" ? G.object : a.objectName;
-				if (!e) return;
-				let t = await c.getObjectSchema(e);
-				M(t);
-			} catch (e) {
-				console.error("Failed to fetch object schema:", e);
-			}
-		})();
-	}, [
-		a.objectName,
-		c,
-		q,
-		G
+		Re,
+		B,
+		V,
+		U,
+		H
 	]);
-	let { markers: J, invalidCount: Y } = n(() => {
+	let { markers: K, invalidCount: q } = n(() => {
 		let e = 0;
 		return {
-			markers: E.map((t, n) => {
-				let r = ae(t, K);
+			markers: x.map((t, n) => {
+				let r = Te(t, F);
 				if (!r) return e++, null;
-				let i = K.titleField ? t[K.titleField] : "Marker", a = K.descriptionField ? t[K.descriptionField] : void 0, [o, s] = r;
+				let i = ne(B, t, {
+					titleField: F.titleField,
+					fallback: "Marker"
+				}), a = l(t, F.descriptionField), [o, s] = r;
 				return !isFinite(o) || !isFinite(s) || o < -90 || o > 90 || s < -180 || s > 180 ? (e++, null) : {
 					id: t.id || t._id || `marker-${n}`,
 					title: i,
@@ -241,146 +260,167 @@ var w = ({ schema: a, dataSource: c, className: u, onMarkerClick: p, onRowClick:
 			}).filter((e) => e !== null),
 			invalidCount: e
 		};
-	}, [E, K]), X = n(() => J.find((e) => e.id === N), [J, N]), [Z, pe] = i(K.zoom || 3), Q = l({
+	}, [
+		x,
+		F,
+		B
+	]), J = n(() => K.find((e) => e.id === D), [K, D]), [Y, He] = i(F.zoom || 3), Ue = e((e) => {
+		try {
+			let t = e?.target?.getZoom?.();
+			typeof t == "number" && Number.isFinite(t) && He(Math.round(t));
+		} catch {}
+	}, []), X = ce({
 		navigation: a.navigation,
 		objectName: a.objectName,
-		onRowClick: v
-	}), $ = n(() => {
-		if (!F.trim()) return J;
-		let e = F.toLowerCase();
-		return J.filter((t) => t.title?.toLowerCase().includes(e) || t.description?.toLowerCase().includes(e));
-	}, [J, F]), me = n(() => S ?? (a.enableClustering || $.length > 100) ? oe($, Z, w) : $.map((e) => ({
+		onRowClick: f
+	}), Z = n(() => {
+		if (!k.trim()) return K;
+		let e = k.toLowerCase();
+		return K.filter((t) => t.title?.toLowerCase().includes(e) || t.description?.toLowerCase().includes(e));
+	}, [K, k]), We = n(() => y ?? (a.enableClustering || Z.length > 100) ? Ee(Z, Y, b) : Z.map((e) => ({
 		id: e.id,
 		coordinates: e.coordinates,
 		markers: [e],
 		isCluster: !1
 	})), [
-		$,
 		Z,
-		S,
-		w,
+		Y,
+		y,
+		b,
 		a
-	]), he = n(() => {
-		if (!$.length) return {
-			longitude: K.center?.[1] || 0,
-			latitude: K.center?.[0] || 0,
-			zoom: K.zoom || 2
+	]), Q = n(() => ve(Z.map((e) => e.coordinates)), [Z]), $ = typeof F.center?.[0] == "number" ? F.center[0] : void 0, Ge = typeof F.center?.[1] == "number" ? F.center[1] : void 0, Ke = typeof F.zoom == "number" ? F.zoom : void 0, qe = $ !== void 0 || Ge !== void 0 || Ke !== void 0, Je = n(() => {
+		if (Q && !qe) return {
+			bounds: Q,
+			fitBoundsOptions: {
+				padding: 48,
+				maxZoom: 12
+			}
+		};
+		let e = Q ? ye(Q) : {
+			longitude: 0,
+			latitude: 0
 		};
-		let e = $.map((e) => e.coordinates[0]), t = $.map((e) => e.coordinates[1]), n = Math.min(...e), r = Math.max(...e), i = Math.min(...t), a = Math.max(...t);
 		return {
-			longitude: (n + r) / 2,
-			latitude: (i + a) / 2,
-			zoom: K.zoom || 3
+			longitude: Ge ?? e.longitude,
+			latitude: $ ?? e.latitude,
+			zoom: Ke ?? (Q ? 3 : 2)
 		};
-	}, [$, K]);
-	return se ? /* @__PURE__ */ g("div", {
-		className: d("min-w-0 overflow-hidden", u),
-		children: /* @__PURE__ */ g("div", {
+	}, [
+		Q,
+		qe,
+		Ge,
+		$,
+		Ke
+	]);
+	return we(F) ? S ? /* @__PURE__ */ h("div", {
+		className: p("min-w-0 overflow-hidden", u),
+		children: /* @__PURE__ */ h("div", {
 			className: "flex items-center justify-center h-96 bg-muted rounded-lg border",
-			children: /* @__PURE__ */ g("div", {
+			children: /* @__PURE__ */ h("div", {
 				className: "text-muted-foreground",
 				children: "Loading map..."
 			})
 		})
-	}) : k ? /* @__PURE__ */ g("div", {
-		className: d("min-w-0 overflow-hidden", u),
-		children: /* @__PURE__ */ g("div", {
+	}) : w ? /* @__PURE__ */ h("div", {
+		className: p("min-w-0 overflow-hidden", u),
+		children: /* @__PURE__ */ h("div", {
 			className: "flex items-center justify-center h-96 bg-muted rounded-lg border",
-			children: /* @__PURE__ */ _("div", {
+			children: /* @__PURE__ */ g("div", {
 				className: "text-destructive",
-				children: ["Error: ", k.message]
+				children: ["Error: ", w.message]
 			})
 		})
-	}) : /* @__PURE__ */ _("div", {
-		className: d("min-w-0 overflow-hidden", u),
+	}) : /* @__PURE__ */ g("div", {
+		className: p("min-w-0 overflow-hidden", u),
 		children: [
-			Y > 0 && /* @__PURE__ */ g("div", {
+			q > 0 && /* @__PURE__ */ h("div", {
 				className: "mb-2 p-2 text-sm text-yellow-800 bg-yellow-50 border border-yellow-200 rounded",
-				children: `${Y} record${Y === 1 ? "" : "s"} with missing or invalid coordinates excluded from the map.`
+				children: `${q} record${q === 1 ? "" : "s"} with missing or invalid coordinates excluded from the map.`
 			}),
-			J.length > 0 && /* @__PURE__ */ g("div", {
+			K.length > 0 && /* @__PURE__ */ h("div", {
 				className: "mb-2",
-				children: /* @__PURE__ */ g("input", {
+				children: /* @__PURE__ */ h("input", {
 					type: "text",
-					value: F,
-					onChange: (e) => ce(e.target.value),
+					value: k,
+					onChange: (e) => Oe(e.target.value),
 					placeholder: "Search locations…",
 					className: "w-full px-3 py-2 text-sm border rounded-md bg-background placeholder:text-muted-foreground focus:outline-none focus:ring-2 focus:ring-ring"
 				})
 			}),
-			/* @__PURE__ */ _("div", {
+			/* @__PURE__ */ g("div", {
 				className: "relative border rounded-lg overflow-hidden bg-muted h-[300px] sm:h-[400px] md:h-[500px] lg:h-[600px] w-full",
 				children: [
-					/* @__PURE__ */ _(te, {
+					/* @__PURE__ */ g(he, {
 						ref: (e) => {
-							L.current = e;
+							A.current = e;
 						},
-						initialViewState: he,
+						initialViewState: Je,
 						style: {
 							width: "100%",
 							height: "100%"
 						},
-						mapStyle: K.style || re,
+						mapStyle: F.style || be,
 						touchZoomRotate: !0,
 						dragRotate: !0,
 						touchPitch: !0,
-						onZoom: (e) => pe(Math.round(e.viewState.zoom)),
-						onError: de,
+						onLoad: Ue,
+						onZoom: (e) => He(Math.round(e.viewState.zoom)),
+						onError: Fe,
 						children: [
-							U && /* @__PURE__ */ _("div", {
+							Ne && /* @__PURE__ */ g("div", {
 								role: "alert",
 								className: "absolute inset-x-0 top-0 z-20 p-2 text-sm text-center text-amber-900 bg-amber-50 border-b border-amber-200",
 								children: [
 									"Map failed to load (",
-									U,
+									Ne,
 									"). Markers below are still listed in the search box;",
 									" ",
-									K.style ? "check the configured map style URL." : "configure a custom map style for production use."
+									F.style ? "check the configured map style URL." : "configure a custom map style for production use."
 								]
 							}),
-							/* @__PURE__ */ g(h, {
+							/* @__PURE__ */ h(ge, {
 								position: "top-right",
 								showCompass: !0,
 								showZoom: !0
 							}),
-							/* @__PURE__ */ g("button", {
+							/* @__PURE__ */ h("button", {
 								type: "button",
-								onClick: fe,
-								disabled: V,
+								onClick: Ie,
+								disabled: Me,
 								className: "absolute top-2 left-2 z-10 inline-flex items-center justify-center size-9 rounded-md bg-background/95 border shadow-sm hover:bg-background disabled:opacity-50",
 								"aria-label": "Show my location",
 								"data-testid": "map-geolocate",
-								children: /* @__PURE__ */ g("span", {
+								children: /* @__PURE__ */ h("span", {
 									"aria-hidden": "true",
-									children: V ? "⏳" : "🧭"
+									children: Me ? "⏳" : "🧭"
 								})
 							}),
-							R && /* @__PURE__ */ g(m, {
-								longitude: R.lng,
-								latitude: R.lat,
+							j && /* @__PURE__ */ h(m, {
+								longitude: j.lng,
+								latitude: j.lat,
 								anchor: "center",
-								children: /* @__PURE__ */ g("div", {
+								children: /* @__PURE__ */ h("div", {
 									className: "size-3 rounded-full bg-blue-500 ring-4 ring-blue-500/30 shadow",
 									"aria-label": "Your location",
 									"data-testid": "map-user-location"
 								})
 							}),
-							me.map((e) => e.isCluster ? /* @__PURE__ */ g(m, {
+							We.map((e) => e.isCluster ? /* @__PURE__ */ h(m, {
 								longitude: e.coordinates[0],
 								latitude: e.coordinates[1],
 								anchor: "center",
 								onClick: (t) => {
 									t.originalEvent.stopPropagation();
 									try {
-										let t = Math.min(20, Math.max(Z + 2, 8));
-										L.current?.flyTo({
+										let t = Math.min(20, Math.max(Y + 2, 8));
+										A.current?.flyTo({
 											center: [e.coordinates[0], e.coordinates[1]],
 											zoom: t,
 											duration: 600
 										});
 									} catch {}
 								},
-								children: /* @__PURE__ */ g("div", {
+								children: /* @__PURE__ */ h("div", {
 									className: "flex items-center justify-center rounded-full bg-primary text-primary-foreground font-bold text-xs cursor-pointer hover:scale-110 transition-transform shadow-md",
 									style: {
 										width: Math.min(48, 24 + e.markers.length * 2),
@@ -390,48 +430,48 @@ var w = ({ schema: a, dataSource: c, className: u, onMarkerClick: p, onRowClick:
 									"data-testid": "map-cluster",
 									children: e.markers.length
 								})
-							}, e.id) : /* @__PURE__ */ g(m, {
+							}, e.id) : /* @__PURE__ */ h(m, {
 								longitude: e.coordinates[0],
 								latitude: e.coordinates[1],
 								anchor: "bottom",
 								onClick: (t) => {
 									t.originalEvent.stopPropagation();
 									let n = e.markers[0];
-									P(n.id), Q.handleClick(n.data), p?.(n.data);
+									O(n.id), X.handleClick(n.data), ue?.(n.data);
 								},
-								children: /* @__PURE__ */ g("div", {
+								children: /* @__PURE__ */ h("div", {
 									className: "text-2xl cursor-pointer hover:scale-110 transition-transform",
 									children: "📍"
 								})
 							}, e.id)),
-							X && !I && /* @__PURE__ */ g(ne, {
-								longitude: X.coordinates[0],
-								latitude: X.coordinates[1],
+							J && !ke && /* @__PURE__ */ h(_e, {
+								longitude: J.coordinates[0],
+								latitude: J.coordinates[1],
 								anchor: "top",
-								onClose: () => P(null),
+								onClose: () => O(null),
 								closeOnClick: !1,
-								children: /* @__PURE__ */ _("div", {
+								children: /* @__PURE__ */ g("div", {
 									className: "p-2 min-w-[150px] sm:min-w-[200px]",
 									children: [
-										/* @__PURE__ */ g("h3", {
+										/* @__PURE__ */ h("h3", {
 											className: "font-bold text-sm mb-1",
-											children: X.title
+											children: J.title
 										}),
-										X.description && /* @__PURE__ */ g("p", {
+										J.description && /* @__PURE__ */ h("p", {
 											className: "text-xs text-muted-foreground",
-											children: X.description
+											children: J.description
 										}),
-										/* @__PURE__ */ _("div", {
+										/* @__PURE__ */ g("div", {
 											className: "mt-2 text-xs flex gap-2",
-											children: [b && /* @__PURE__ */ g("button", {
+											children: [_ && /* @__PURE__ */ h("button", {
 												type: "button",
 												className: "text-blue-500 hover:underline",
-												onClick: () => b(X.data),
+												onClick: () => _(J.data),
 												children: "Edit"
-											}), x && /* @__PURE__ */ g("button", {
+											}), v && /* @__PURE__ */ h("button", {
 												type: "button",
 												className: "text-red-500 hover:underline",
-												onClick: () => x(X.data),
+												onClick: () => v(J.data),
 												children: "Delete"
 											})]
 										})
@@ -440,69 +480,70 @@ var w = ({ schema: a, dataSource: c, className: u, onMarkerClick: p, onRowClick:
 							})
 						]
 					}),
-					X && I && /* @__PURE__ */ _("div", {
+					J && ke && /* @__PURE__ */ g("div", {
 						className: "absolute inset-x-0 bottom-0 z-30 bg-background border-t shadow-lg rounded-t-2xl p-4 pb-[max(env(safe-area-inset-bottom),1rem)]",
 						role: "dialog",
 						"aria-label": "Location details",
 						"data-testid": "map-mobile-record-sheet",
 						children: [
-							/* @__PURE__ */ g("div", {
+							/* @__PURE__ */ h("div", {
 								className: "mx-auto mb-2 h-1 w-10 rounded-full bg-muted",
 								"aria-hidden": "true"
 							}),
-							/* @__PURE__ */ _("div", {
+							/* @__PURE__ */ g("div", {
 								className: "flex items-start justify-between gap-3",
-								children: [/* @__PURE__ */ _("div", {
+								children: [/* @__PURE__ */ g("div", {
 									className: "min-w-0 flex-1",
-									children: [/* @__PURE__ */ g("h3", {
+									children: [/* @__PURE__ */ h("h3", {
 										className: "text-sm font-semibold truncate",
-										children: X.title
-									}), X.description && /* @__PURE__ */ g("p", {
+										children: J.title
+									}), J.description && /* @__PURE__ */ h("p", {
 										className: "mt-1 text-xs text-muted-foreground line-clamp-3",
-										children: X.description
+										children: J.description
 									})]
-								}), /* @__PURE__ */ g("button", {
+								}), /* @__PURE__ */ h("button", {
 									type: "button",
-									onClick: () => P(null),
+									onClick: () => O(null),
 									className: "text-muted-foreground hover:text-foreground text-lg leading-none px-2",
 									"aria-label": "Close details",
 									"data-testid": "map-mobile-record-close",
 									children: "×"
 								})]
 							}),
-							/* @__PURE__ */ _("div", {
+							/* @__PURE__ */ g("div", {
 								className: "mt-3 flex flex-wrap gap-2 text-xs",
-								children: [b && /* @__PURE__ */ g("button", {
+								children: [_ && /* @__PURE__ */ h("button", {
 									type: "button",
 									className: "px-3 py-1.5 rounded-md border bg-card hover:bg-accent",
-									onClick: () => b(X.data),
+									onClick: () => _(J.data),
 									children: "Edit"
-								}), x && /* @__PURE__ */ g("button", {
+								}), v && /* @__PURE__ */ h("button", {
 									type: "button",
 									className: "px-3 py-1.5 rounded-md border border-destructive/30 text-destructive hover:bg-destructive/10",
-									onClick: () => x(X.data),
+									onClick: () => v(J.data),
 									children: "Delete"
 								})]
 							})
 						]
 					}),
-					z && /* @__PURE__ */ g("div", {
+					je && /* @__PURE__ */ h("div", {
 						className: "absolute top-2 left-14 right-2 z-10 text-xs px-3 py-1.5 rounded-md bg-destructive/10 text-destructive border border-destructive/30",
-						children: z
+						children: je
 					})
 				]
 			}),
-			Q.isOverlay && /* @__PURE__ */ g(ee, {
-				...Q,
+			E && /* @__PURE__ */ h(ae, { result: E }),
+			X.isOverlay && /* @__PURE__ */ h(fe, {
+				...X,
 				title: "Location Details",
-				children: (e) => /* @__PURE__ */ g("div", {
+				children: (e) => /* @__PURE__ */ h("div", {
 					className: "space-y-3",
-					children: Object.entries(e).map(([e, t]) => /* @__PURE__ */ _("div", {
+					children: Object.entries(e).map(([e, t]) => /* @__PURE__ */ g("div", {
 						className: "flex flex-col",
-						children: [/* @__PURE__ */ g("span", {
+						children: [/* @__PURE__ */ h("span", {
 							className: "text-xs font-medium text-muted-foreground uppercase tracking-wide",
 							children: e.replace(/_/g, " ")
-						}), /* @__PURE__ */ g("span", {
+						}), /* @__PURE__ */ h("span", {
 							className: "text-sm",
 							children: String(t ?? "—")
 						})]
@@ -510,55 +551,105 @@ var w = ({ schema: a, dataSource: c, className: u, onMarkerClick: p, onRowClick:
 				})
 			})
 		]
+	}) : /* @__PURE__ */ h("div", {
+		className: p("min-w-0 overflow-hidden", u),
+		children: /* @__PURE__ */ h("div", {
+			className: "flex items-center justify-center h-96 bg-muted rounded-lg border p-4 text-center",
+			"data-testid": "map-missing-location-binding",
+			role: "alert",
+			children: /* @__PURE__ */ g("div", {
+				className: "text-destructive",
+				children: [
+					"Map configuration required — declare ",
+					/* @__PURE__ */ h("code", {
+						className: "font-mono",
+						children: "map.locationField"
+					}),
+					" ",
+					"or ",
+					/* @__PURE__ */ h("code", {
+						className: "font-mono",
+						children: "map.latitudeField"
+					}),
+					" +",
+					" ",
+					/* @__PURE__ */ h("code", {
+						className: "font-mono",
+						children: "map.longitudeField"
+					})
+				]
+			})
+		})
 	});
-}, T = {
+}, De = {
 	filter: !0,
 	sort: !0
-}, E = ({ schema: e, ...t }) => {
-	let { dataSource: n } = u() || {};
-	return /* @__PURE__ */ g(c, {
+}, D = c(({ schema: e, ...t }) => {
+	let { dataSource: n } = ue() || {};
+	return /* @__PURE__ */ h(d, {
 		schema: e,
-		mapping: T,
+		mapping: De,
 		dataSource: n,
 		testId: "object-map",
 		errorTitle: "This map’s data source could not be resolved",
-		children: (e) => /* @__PURE__ */ g(w, {
+		children: (e) => /* @__PURE__ */ h(E, {
 			schema: e,
 			dataSource: n,
 			...t
 		})
 	});
-};
-a.register("object-map", E, {
+});
+a.register("object-map", D, {
 	namespace: "plugin-map",
 	label: "Object Map",
 	category: "view",
-	inputs: [{
-		name: "objectName",
-		type: "string",
-		label: "Object Name",
-		required: !0
-	}, {
-		name: "map",
-		type: "object",
-		label: "Map Config",
-		description: "latitudeField, longitudeField, titleField"
-	}]
-}), a.register("map", E, {
-	namespace: "view",
-	label: "Map View",
-	category: "view",
-	inputs: [{
-		name: "objectName",
-		type: "string",
-		label: "Object Name",
-		required: !0
-	}, {
-		name: "map",
-		type: "object",
-		label: "Map Config",
-		description: "latitudeField, longitudeField, titleField"
-	}]
+	inputs: [
+		{
+			name: "objectName",
+			type: "string",
+			description: "ObjectQL object name. The record source is one of `data`, `staticData` and `objectName`, or the node’s `dataSource` binding; the `object-map` schema refuses a block that declares none of them."
+		},
+		{
+			name: "map",
+			type: "object",
+			description: "The field configuration: `latitudeField` / `longitudeField` (or one `locationField` holding a `\"lat,lng\"` string, a `{ lat, lng }` object or a `[lat, lng]` pair) place each record’s marker, and a record with no readable coordinates is not plotted; `titleField` and `descriptionField` name what the marker popup shows; `zoom` and `center` (`[latitude, longitude]`) set the initial camera, which otherwise fits the markers; `style` is a MapLibre style URL, read after the node’s `mapStyle`."
+		},
+		{
+			name: "data",
+			type: "object",
+			description: "A `{ provider, … }` data-source configuration, read FIRST on the record-source ladder: a map carrying one never reaches `staticData` and never queries `objectName`. `{ provider: 'value', items }` plots those rows and `{ provider: 'object', object }` queries that object, both narrowed by `filter` and ordered by `sort`. The `api` provider is not implemented on the map and plots no markers. A bare array is not this key’s shape and is not a record source: the map falls through to `staticData`, then `objectName`, so inline rows belong under `staticData`."
+		},
+		{
+			name: "staticData",
+			type: "array",
+			description: "Inline records, read SECOND on the record-source ladder: a `data` configuration wins and this key is then never reached, while `objectName` is read AFTER it, so a map carrying both plots these rows and never queries that object. `filter` and `sort` narrow and order these rows exactly as they do fetched ones."
+		},
+		{
+			name: "filter",
+			type: "array",
+			description: "Base query filter in the rule-array form `[{ field, operator, value }, ...]`, narrowing the markers the map plots — fetched rows and inline (`staticData`, `{ provider: 'value' }`) rows alike. Context tokens such as `{current_user_id}` are resolved first, then the filter is lowered to `$filter` on the query. The MongoDB-style record form is not this key’s shape."
+		},
+		{
+			name: "sort",
+			type: "array",
+			description: "Marker order in `[{ field, order }]` form, ordering the rows the map plots. Lowered to `$orderby` on the same query."
+		},
+		{
+			name: "mapStyle",
+			type: "string",
+			description: "MapLibre style URL or spec, overriding the public demo tiles. Read before `map.style`; NOT the base node `style`, which is an inline CSS record"
+		},
+		{
+			name: "navigation",
+			type: "object",
+			description: "What a marker 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 marker’s record in that overlay, but `split` opens nothing, because the map 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 map’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 map 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. A click handler from a parent view outranks the whole key."
+		},
+		{
+			name: "enableClustering",
+			type: "boolean",
+			description: "Group nearby markers into one numbered cluster. Absent, the map clusters only above 100 markers; `false` turns clustering off at any count."
+		}
+	]
 });
 //#endregion
-export { w as ObjectMap, E as ObjectMapRenderer };
+export { E as ObjectMap, D as ObjectMapRenderer };