@ishibashi0112/spreadsheet-grid-core 0.39.0

package/dist/controllers/columnHeaderDragController.js

@@ -0,0 +1,256 @@
+import { isInsideDetailCardOf as e } from "../logic/detailRow.js";
+import { findPaneDropSlot as t, getColumnPane as n, paneDropSlotBoundaryX as r } from "../logic/geometry.js";
+import { computeNextScrollPosition as i, hasPointerLeftActivationRadius as a, resolveAutoScrollAxisDirection as o, resolveScrollContentBox as s } from "../logic/autoScrollGeometry.js";
+import { applySlotToElement as c } from "../logic/slotDom.js";
+//#region src/controllers/columnHeaderDragController.ts
+function l(e, t, r, i) {
+	let a = e.find((e) => e.key === t);
+	if (!a) return null;
+	let o = n(a), s = {
+		left: [],
+		center: [],
+		right: []
+	}, c = /* @__PURE__ */ new Map();
+	for (let t of e) s[n(t)].push(t.key), c.set(t.key, t.visible !== !1);
+	let l = s[r].filter((e) => c.get(e)).indexOf(t), u = s[o].indexOf(t);
+	if (u < 0) return null;
+	s[o].splice(u, 1);
+	let d = i;
+	o === r && l >= 0 && d > l && --d;
+	let f = s[r].filter((e) => c.get(e));
+	if (d = Math.max(0, Math.min(d, f.length)), o === r && l >= 0 && d === l) return null;
+	let p;
+	return p = d >= f.length ? s[r].length : s[r].indexOf(f[d]), s[r].splice(p, 0, t), [
+		...s.left,
+		...s.center,
+		...s.right
+	];
+}
+var u = 32, d = 2, f = 14, p = 12, m = "<svg viewBox=\"0 0 24 24\" width=\"14\" height=\"14\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"2\" stroke-linecap=\"round\" stroke-linejoin=\"round\"><polyline points=\"5 9 2 12 5 15\"/><polyline points=\"9 5 12 2 15 5\"/><polyline points=\"15 19 12 22 9 19\"/><polyline points=\"19 9 22 12 19 15\"/><line x1=\"2\" y1=\"12\" x2=\"22\" y2=\"12\"/><line x1=\"12\" y1=\"2\" x2=\"12\" y2=\"22\"/></svg>", h = "<svg viewBox=\"0 0 24 24\" width=\"14\" height=\"14\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"2\" stroke-linecap=\"round\" stroke-linejoin=\"round\"><line x1=\"12\" y1=\"17\" x2=\"12\" y2=\"22\"/><path d=\"M5 17h14v-1.76a2 2 0 0 0-1.11-1.79l-1.78-.9A2 2 0 0 1 15 10.76V6h1a2 2 0 0 0 0-4H8a2 2 0 0 0 0 4h1v4.76a2 2 0 0 1-1.11 1.79l-1.78.9A2 2 0 0 0 5 15.24Z\"/></svg>", g = "<svg viewBox=\"0 0 24 24\" width=\"14\" height=\"14\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"2\" stroke-linecap=\"round\" stroke-linejoin=\"round\"><circle cx=\"12\" cy=\"12\" r=\"10\"/><line x1=\"4.9\" y1=\"4.9\" x2=\"19.1\" y2=\"19.1\"/></svg>", _ = "0.5", v = 200, y = "cubic-bezier(0.2, 0.7, 0.3, 1)", b = () => typeof window < "u" && typeof window.matchMedia == "function" && window.matchMedia("(prefers-reduced-motion: reduce)").matches, x = (t) => {
+	if (!t) return null;
+	let n = /* @__PURE__ */ new Map();
+	return t.querySelectorAll("[data-ssg-col-key]").forEach((r) => {
+		if (e(t, r)) return;
+		let i = r.dataset.ssgColKey;
+		i && !n.has(i) && n.set(i, r.getBoundingClientRect().left);
+	}), n;
+}, S = () => {
+	let S = null, C = null, w = null, T = null, E = {
+		x: 0,
+		y: 0
+	}, D = null, O = !1, k = null, A = null, j = null, M = null, N = null, P = () => ({
+		left: S?.leftIndicatorRef.current ?? null,
+		center: S?.centerIndicatorRef.current ?? null,
+		right: S?.rightIndicatorRef.current ?? null
+	}), F = () => {
+		for (let e of Object.values(P())) e && (e.style.display = "none");
+	}, I = (e) => {
+		if (j) return;
+		let t = document.createElement("div");
+		t.setAttribute("data-grid-drag-ghost", ""), S?.scrollContainerRef.current?.closest(".ssg-theme-dark") != null && t.classList.add("ssg-theme-dark"), t.style.cssText = [
+			"position:fixed",
+			"top:0",
+			"left:0",
+			"display:inline-flex",
+			"align-items:center",
+			"gap:7px",
+			"padding:7px 12px 7px 10px",
+			"border-radius:9px",
+			"border:1px solid var(--ssg-ghost-border)",
+			"background:var(--ssg-ghost-bg)",
+			"color:var(--ssg-ghost-text)",
+			"font-size:12px",
+			"font-weight:600",
+			"line-height:1",
+			"white-space:nowrap",
+			"box-shadow:var(--ssg-ghost-shadow)",
+			"pointer-events:none",
+			"user-select:none",
+			"z-index:9999",
+			"will-change:transform",
+			"transform:translate(-9999px,-9999px)"
+		].join(";"), c(t, S?.ghostSlot);
+		let n = document.createElement("span");
+		n.style.cssText = "display:inline-flex;align-items:center;justify-content:center;width:14px;height:14px;flex:none";
+		let r = document.createElement("span");
+		r.textContent = e, t.appendChild(n), t.appendChild(r), document.body.appendChild(t), j = t, M = n, N = null;
+	}, L = (e) => {
+		let t = j;
+		if (!t) return;
+		t.style.transform = "translate(" + (E.x + f) + "px," + (E.y + p) + "px)";
+		let n = e ?? "out";
+		if (N === n) return;
+		N = n;
+		let r = M;
+		n === "out" ? (t.style.opacity = _, r && (r.innerHTML = g)) : (t.style.opacity = "1", r && (r.innerHTML = n === "center" ? m : h));
+	}, R = () => {
+		j && j.parentNode && j.parentNode.removeChild(j), j = null, M = null, N = null;
+	}, z = (e, n) => {
+		if (S === null) return null;
+		let { paneLayout: i, leftPaneScrollRef: a, rightPaneScrollRef: o, bodyScrollRef: s, scrollContainerRef: c, leftLeadingWidth: l, centerLeadingWidth: f, rightLeadingWidth: p } = S, m = c.current;
+		if (m) {
+			let t = m.getBoundingClientRect();
+			if (e < t.left || e > t.right || n < t.top || n > t.bottom) return null;
+		}
+		let h = a.current, g = o.current;
+		if (h && i.left.entries.length === 0 && e <= h.getBoundingClientRect().left + u) return {
+			pane: "left",
+			slot: 0,
+			leftPx: d
+		};
+		if (h && i.left.entries.length > 0) {
+			let n = h.getBoundingClientRect();
+			if (e < n.right) {
+				let a = e - n.left - l, o = t(i.left, a);
+				return {
+					pane: "left",
+					slot: o,
+					leftPx: l + r(i.left, o)
+				};
+			}
+		}
+		if (g && i.right.entries.length === 0 && e >= g.getBoundingClientRect().left - u) return {
+			pane: "right",
+			slot: 0,
+			leftPx: -2
+		};
+		if (g && i.right.entries.length > 0) {
+			let n = g.getBoundingClientRect();
+			if (e >= n.left) {
+				let a = e - n.left - p, o = t(i.right, a);
+				return {
+					pane: "right",
+					slot: o,
+					leftPx: p + r(i.right, o)
+				};
+			}
+		}
+		let _ = s.current;
+		if (_ && i.center.entries.length > 0) {
+			let n = _.getBoundingClientRect(), a = _.scrollLeft + e - n.left - f, o = t(i.center, Math.max(a, 0));
+			return {
+				pane: "center",
+				slot: o,
+				leftPx: f + r(i.center, o)
+			};
+		}
+		return null;
+	}, B = () => {
+		let e = z(E.x, E.y);
+		if (L(e ? e.pane : null), !e) {
+			w = null, F();
+			return;
+		}
+		w = {
+			pane: e.pane,
+			slot: e.slot
+		};
+		let t = P();
+		for (let n of [
+			"left",
+			"center",
+			"right"
+		]) {
+			let r = t[n];
+			r && (n === e.pane ? (r.style.left = `${e.leftPx}px`, r.style.display = "block") : r.style.display = "none");
+		}
+	}, V = () => {
+		if (C === null) {
+			A = null;
+			return;
+		}
+		let e = S?.scrollContainerRef.current ?? null;
+		if (e && (O || (!D || a(D, E, 6)) && (O = !0), O)) {
+			let t = e.getBoundingClientRect(), n = s({
+				rectLeft: t.left,
+				rectTop: t.top,
+				clientLeft: e.clientLeft,
+				clientTop: e.clientTop,
+				clientWidth: e.clientWidth,
+				clientHeight: e.clientHeight
+			}), r = o(E.x, n.left, n.right, 24), a = i(e.scrollLeft, r, 18, e.scrollWidth - e.clientWidth);
+			a !== e.scrollLeft && e.scrollTo({
+				left: a,
+				behavior: "auto"
+			});
+		}
+		B(), A = requestAnimationFrame(V);
+	}, H = (e) => {
+		A !== null && (cancelAnimationFrame(A), A = null), document.body.style.cursor = "", F(), R();
+		let t = C, r = w;
+		if (C = null, w = null, !e || !t || !r || S === null) return;
+		let { columns: i, applyColumnOrderAndPin: a, scrollContainerRef: o } = S, s = l(i, t, r.pane, r.slot);
+		if (!s) return;
+		let c = i.find((e) => e.key === t), u = c ? n(c) : null;
+		T = u !== null && u === r.pane && !b() ? x(o.current) : null, a(s, /* @__PURE__ */ new Map([[t, r.pane === "center" ? void 0 : r.pane]]));
+	};
+	return {
+		update: (e) => {
+			S = e;
+		},
+		onColumnDragHandlePointerDown: (e, t) => {
+			if (S === null || !S.enabled || t.button !== 0) return;
+			t.stopPropagation(), t.preventDefault(), C = e.key, E = {
+				x: t.clientX,
+				y: t.clientY
+			}, D = {
+				x: t.clientX,
+				y: t.clientY
+			}, O = !1, document.body.style.cursor = "grabbing", I(e.title || e.key);
+			let n = t.currentTarget, r = t.pointerId;
+			try {
+				n.setPointerCapture(r);
+			} catch {}
+			let i = (e) => {
+				e.pointerId === r && (E = {
+					x: e.clientX,
+					y: e.clientY
+				}, B());
+			}, a = () => {
+				window.removeEventListener("pointermove", i), window.removeEventListener("pointerup", o), window.removeEventListener("pointercancel", s), k = null;
+				try {
+					n.releasePointerCapture(r);
+				} catch {}
+			};
+			function o(e) {
+				e.pointerId === r && (a(), H(!0));
+			}
+			function s(e) {
+				e.pointerId === r && (a(), H(!1));
+			}
+			window.addEventListener("pointermove", i), window.addEventListener("pointerup", o), window.addEventListener("pointercancel", s), k = a, B(), A = requestAnimationFrame(V);
+		},
+		applyReorderSettle: () => {
+			let t = T;
+			if (T = null, !t) return;
+			let n = S?.scrollContainerRef.current ?? null;
+			if (!n) return;
+			let r = /* @__PURE__ */ new Map(), i = /* @__PURE__ */ new Map();
+			n.querySelectorAll("[data-ssg-col-key]").forEach((a) => {
+				if (e(n, a)) return;
+				let o = a.dataset.ssgColKey;
+				if (!o || !t.has(o)) return;
+				let s = r.get(o);
+				s ? s.push(a) : (r.set(o, [a]), i.set(o, a.getBoundingClientRect().left));
+			});
+			let a = [];
+			if (r.forEach((e, n) => {
+				let r = t.get(n), o = i.get(n);
+				if (r === void 0 || o === void 0) return;
+				let s = r - o;
+				if (!(Math.abs(s) < .5)) for (let t of e) t.style.transition = "none", t.style.transform = `translateX(${s}px)`, t.style.willChange = "transform", a.push(t);
+			}), a.length !== 0) {
+				n.getBoundingClientRect();
+				for (let e of a) e.style.transition = `transform ${v}ms ${y}`, e.style.transform = "translateX(0)";
+				window.setTimeout(() => {
+					for (let e of a) e.style.transition = "", e.style.transform = "", e.style.willChange = "";
+				}, 280);
+			}
+		},
+		dispose: () => {
+			k?.(), k = null, A !== null && (cancelAnimationFrame(A), A = null), C = null, w = null, document.body.style.cursor = "", R();
+		}
+	};
+};
+//#endregion
+export { l as computeHeaderReorderedKeys, S as createColumnHeaderDragController };

package/dist/controllers/columnMenuController.cjs

@@ -0,0 +1 @@
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("../logic/valueStore.cjs"),t=require("./popoverSupport.cjs");var n=200,r=8,i=6,a=289,o=()=>{let o=null,s=e.createValueStore({columnKey:null,layout:null}),c={current:null},l=null,u=null,d=null,f=null,p=e=>{let t=s.getSnapshot(),n=t.layout;n===e||n!==null&&e!==null&&n.top===e.top&&n.left===e.left&&n.width===e.width&&n.maxHeight===e.maxHeight||s.setSnapshot({...t,layout:e})},m=()=>{f!==null&&(cancelAnimationFrame(f),f=null),_.detach(),s.setSnapshot({columnKey:null,layout:null})},h=()=>{if(s.getSnapshot().columnKey===null){p(null);return}let e,t,o,d=c.current,f=d?d.scrollHeight+(d.offsetHeight-d.clientHeight):a;if(l){if(!l.isConnected){l=null,m();return}let r=l.getBoundingClientRect();t=r.right-n,e=r.bottom+i,o=r.top-f-i}else if(u)t=u.x,e=u.y,o=u.y-f;else{p(null);return}t=Math.max(r,t),t=Math.min(t,window.innerWidth-n-r);let h=window.innerHeight-r;e+f>h&&o>=r&&(e=o),e=Math.max(r,e);let g=h-e;p({top:e,left:t,width:n,maxHeight:f>g?Math.max(g,0):void 0})},g=()=>{m(),l=null,u=null,o!==null&&t.restoreGridFocus(o.gridRootRef)},_=t.createPopoverWindowBindings({onResize:h,onScroll:()=>{if(u){g();return}h()},isInside:e=>c.current?.contains(e)===!0||l?.contains(e)===!0,onOutsidePointerDown:g,onKeyDown:e=>{e.key===`Escape`&&(e.preventDefault(),g())}}),v=e=>{s.setSnapshot({...s.getSnapshot(),columnKey:e}),h(),f!==null&&cancelAnimationFrame(f),f=requestAnimationFrame(()=>{f=null,h()}),_.attach()},y=(e,n)=>{t.blurForPopover(o?.gridRootRef.current??null),l=n,u=null,v(e.key)};return{update:e=>{o=e},subscribe:s.subscribe,getSnapshot:s.getSnapshot,panelRef:c,openFromButton:(e,t)=>{if(t.preventDefault(),t.stopPropagation(),!o?.enableColumnMenu||t.button!==0)return;let n=t.currentTarget;if(s.getSnapshot().columnKey===e.key&&l===n){g();return}if(t.pointerType===`touch`){d=n;return}y(e,n)},openFromButtonClick:(e,t)=>{let n=d;d=null,!(!o?.enableColumnMenu||n!==t.currentTarget)&&(t.preventDefault(),t.stopPropagation(),y(e,t.currentTarget))},openFromContextMenu:(e,n)=>{o?.enableColumnMenu&&(n.preventDefault(),n.stopPropagation(),t.blurForPopover(o.gridRootRef.current),l=null,u={x:n.clientX,y:n.clientY},v(e.key))},close:g,dispose:()=>{f!==null&&(cancelAnimationFrame(f),f=null),_.detach()}}};exports.createColumnMenuController=o;

package/dist/controllers/columnMenuController.d.ts

@@ -0,0 +1,49 @@
+import type { GridColumn } from '../model/gridTypes.unbound';
+import { type ReadonlyElementRef } from './popoverSupport';
+export type ColumnMenuLayout = {
+    top: number;
+    left: number;
+    width: number;
+    maxHeight?: number;
+};
+export type ColumnMenuSnapshot = {
+    columnKey: string | null;
+    layout: ColumnMenuLayout | null;
+};
+export type ColumnMenuControllerArgs<T> = {
+    visibleColumns: GridColumn<T>[];
+    enableColumnMenu: boolean;
+    gridRootRef: ReadonlyElementRef;
+};
+export type MenuButtonPointerEvent = {
+    button: number;
+    pointerType: string;
+    currentTarget: HTMLButtonElement;
+    preventDefault: () => void;
+    stopPropagation: () => void;
+};
+export type MenuButtonClickEvent = {
+    currentTarget: HTMLButtonElement;
+    preventDefault: () => void;
+    stopPropagation: () => void;
+};
+export type MenuContextEvent = {
+    clientX: number;
+    clientY: number;
+    preventDefault: () => void;
+    stopPropagation: () => void;
+};
+export type ColumnMenuController<T> = {
+    update: (args: ColumnMenuControllerArgs<T>) => void;
+    subscribe: (listener: () => void) => () => void;
+    getSnapshot: () => ColumnMenuSnapshot;
+    panelRef: {
+        current: HTMLDivElement | null;
+    };
+    openFromButton: (column: GridColumn<T>, event: MenuButtonPointerEvent) => void;
+    openFromButtonClick: (column: GridColumn<T>, event: MenuButtonClickEvent) => void;
+    openFromContextMenu: (column: GridColumn<T>, event: MenuContextEvent) => void;
+    close: () => void;
+    dispose: () => void;
+};
+export declare const createColumnMenuController: <T>() => ColumnMenuController<T>;

package/dist/controllers/columnMenuController.js

@@ -0,0 +1,110 @@
+import { createValueStore as e } from "../logic/valueStore.js";
+import { blurForPopover as t, createPopoverWindowBindings as n, restoreGridFocus as r } from "./popoverSupport.js";
+//#region src/controllers/columnMenuController.ts
+var i = 200, a = 8, o = 6, s = 289, c = () => {
+	let c = null, l = e({
+		columnKey: null,
+		layout: null
+	}), u = { current: null }, d = null, f = null, p = null, m = null, h = (e) => {
+		let t = l.getSnapshot(), n = t.layout;
+		n === e || n !== null && e !== null && n.top === e.top && n.left === e.left && n.width === e.width && n.maxHeight === e.maxHeight || l.setSnapshot({
+			...t,
+			layout: e
+		});
+	}, g = () => {
+		m !== null && (cancelAnimationFrame(m), m = null), y.detach(), l.setSnapshot({
+			columnKey: null,
+			layout: null
+		});
+	}, _ = () => {
+		if (l.getSnapshot().columnKey === null) {
+			h(null);
+			return;
+		}
+		let e, t, n, r = u.current, c = r ? r.scrollHeight + (r.offsetHeight - r.clientHeight) : s;
+		if (d) {
+			if (!d.isConnected) {
+				d = null, g();
+				return;
+			}
+			let r = d.getBoundingClientRect();
+			t = r.right - i, e = r.bottom + o, n = r.top - c - o;
+		} else if (f) t = f.x, e = f.y, n = f.y - c;
+		else {
+			h(null);
+			return;
+		}
+		t = Math.max(a, t), t = Math.min(t, window.innerWidth - i - a);
+		let p = window.innerHeight - a;
+		e + c > p && n >= a && (e = n), e = Math.max(a, e);
+		let m = p - e;
+		h({
+			top: e,
+			left: t,
+			width: i,
+			maxHeight: c > m ? Math.max(m, 0) : void 0
+		});
+	}, v = () => {
+		g(), d = null, f = null, c !== null && r(c.gridRootRef);
+	}, y = n({
+		onResize: _,
+		onScroll: () => {
+			if (f) {
+				v();
+				return;
+			}
+			_();
+		},
+		isInside: (e) => u.current?.contains(e) === !0 || d?.contains(e) === !0,
+		onOutsidePointerDown: v,
+		onKeyDown: (e) => {
+			e.key === "Escape" && (e.preventDefault(), v());
+		}
+	}), b = (e) => {
+		l.setSnapshot({
+			...l.getSnapshot(),
+			columnKey: e
+		}), _(), m !== null && cancelAnimationFrame(m), m = requestAnimationFrame(() => {
+			m = null, _();
+		}), y.attach();
+	}, x = (e, n) => {
+		t(c?.gridRootRef.current ?? null), d = n, f = null, b(e.key);
+	};
+	return {
+		update: (e) => {
+			c = e;
+		},
+		subscribe: l.subscribe,
+		getSnapshot: l.getSnapshot,
+		panelRef: u,
+		openFromButton: (e, t) => {
+			if (t.preventDefault(), t.stopPropagation(), !c?.enableColumnMenu || t.button !== 0) return;
+			let n = t.currentTarget;
+			if (l.getSnapshot().columnKey === e.key && d === n) {
+				v();
+				return;
+			}
+			if (t.pointerType === "touch") {
+				p = n;
+				return;
+			}
+			x(e, n);
+		},
+		openFromButtonClick: (e, t) => {
+			let n = p;
+			p = null, !(!c?.enableColumnMenu || n !== t.currentTarget) && (t.preventDefault(), t.stopPropagation(), x(e, t.currentTarget));
+		},
+		openFromContextMenu: (e, n) => {
+			c?.enableColumnMenu && (n.preventDefault(), n.stopPropagation(), t(c.gridRootRef.current), d = null, f = {
+				x: n.clientX,
+				y: n.clientY
+			}, b(e.key));
+		},
+		close: v,
+		dispose: () => {
+			m !== null && (cancelAnimationFrame(m), m = null), y.detach();
+		}
+	};
+};
+//#endregion
+export { c as createColumnMenuController };

package/dist/controllers/contextMenuController.cjs

@@ -0,0 +1 @@
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("../logic/valueStore.cjs"),t=require("./popoverSupport.cjs");var n=220,r=8,i=34,a=16,o=()=>{let o=null,s=e.createValueStore({state:null,layout:null}),c={current:null},l=null,u=0,d=e=>{let t=s.getSnapshot();t.layout===e||t.layout!==null&&e!==null&&t.layout.top===e.top&&t.layout.left===e.left&&t.layout.width===e.width||s.setSnapshot({...t,layout:e})},f=()=>{if(!l){d(null);return}let e=u*i+a,t=l.x,o=l.y,s=l.y-e;t=Math.max(r,t),t=Math.min(t,window.innerWidth-n-r),o+e>window.innerHeight-r&&(o=s),o=Math.max(r,o),d({top:o,left:t,width:n})},p=()=>{s.setSnapshot({state:null,layout:null}),l=null,u=0,m.detach(),o!==null&&t.restoreGridFocus(o.gridRootRef)},m=t.createPopoverWindowBindings({onResize:f,onScroll:p,isInside:e=>c.current?.contains(e)===!0,onOutsidePointerDown:p,onKeyDown:e=>{e.key===`Escape`&&(e.preventDefault(),p())}});return{update:e=>{o=e},subscribe:s.subscribe,getSnapshot:s.getSnapshot,panelRef:c,open:(e,n)=>{t.blurForPopover(o?.gridRootRef.current??null),l={x:e.clientX,y:e.clientY},u=n.length,s.setSnapshot({...s.getSnapshot(),state:{params:e,items:n}}),f(),m.attach()},close:p,dispose:()=>{m.detach()}}};exports.createContextMenuController=o;

package/dist/controllers/contextMenuController.d.ts

@@ -0,0 +1,30 @@
+import type { GridContextMenuItem, GridContextMenuParams } from '../model/gridTypes.unbound';
+import { type ReadonlyElementRef } from './popoverSupport';
+export type CellContextMenuLayout = {
+    top: number;
+    left: number;
+    width: number;
+};
+export type CellContextMenuState<T> = {
+    params: GridContextMenuParams<T>;
+    items: GridContextMenuItem[];
+};
+export type ContextMenuSnapshot<T> = {
+    state: CellContextMenuState<T> | null;
+    layout: CellContextMenuLayout | null;
+};
+export type ContextMenuControllerArgs = {
+    gridRootRef: ReadonlyElementRef;
+};
+export type ContextMenuController<T> = {
+    update: (args: ContextMenuControllerArgs) => void;
+    subscribe: (listener: () => void) => () => void;
+    getSnapshot: () => ContextMenuSnapshot<T>;
+    panelRef: {
+        current: HTMLDivElement | null;
+    };
+    open: (params: GridContextMenuParams<T>, items: GridContextMenuItem[]) => void;
+    close: () => void;
+    dispose: () => void;
+};
+export declare const createContextMenuController: <T>() => ContextMenuController<T>;

package/dist/controllers/contextMenuController.js

@@ -0,0 +1,65 @@
+import { createValueStore as e } from "../logic/valueStore.js";
+import { blurForPopover as t, createPopoverWindowBindings as n, restoreGridFocus as r } from "./popoverSupport.js";
+//#region src/controllers/contextMenuController.ts
+var i = 220, a = 8, o = 34, s = 16, c = () => {
+	let c = null, l = e({
+		state: null,
+		layout: null
+	}), u = { current: null }, d = null, f = 0, p = (e) => {
+		let t = l.getSnapshot();
+		t.layout === e || t.layout !== null && e !== null && t.layout.top === e.top && t.layout.left === e.left && t.layout.width === e.width || l.setSnapshot({
+			...t,
+			layout: e
+		});
+	}, m = () => {
+		if (!d) {
+			p(null);
+			return;
+		}
+		let e = f * o + s, t = d.x, n = d.y, r = d.y - e;
+		t = Math.max(a, t), t = Math.min(t, window.innerWidth - i - a), n + e > window.innerHeight - a && (n = r), n = Math.max(a, n), p({
+			top: n,
+			left: t,
+			width: i
+		});
+	}, h = () => {
+		l.setSnapshot({
+			state: null,
+			layout: null
+		}), d = null, f = 0, g.detach(), c !== null && r(c.gridRootRef);
+	}, g = n({
+		onResize: m,
+		onScroll: h,
+		isInside: (e) => u.current?.contains(e) === !0,
+		onOutsidePointerDown: h,
+		onKeyDown: (e) => {
+			e.key === "Escape" && (e.preventDefault(), h());
+		}
+	});
+	return {
+		update: (e) => {
+			c = e;
+		},
+		subscribe: l.subscribe,
+		getSnapshot: l.getSnapshot,
+		panelRef: u,
+		open: (e, n) => {
+			t(c?.gridRootRef.current ?? null), d = {
+				x: e.clientX,
+				y: e.clientY
+			}, f = n.length, l.setSnapshot({
+				...l.getSnapshot(),
+				state: {
+					params: e,
+					items: n
+				}
+			}), m(), g.attach();
+		},
+		close: h,
+		dispose: () => {
+			g.detach();
+		}
+	};
+};
+//#endregion
+export { c as createContextMenuController };

package/dist/controllers/debouncedValueStore.cjs

@@ -0,0 +1 @@
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("../logic/valueStore.cjs");var t=(t,n)=>{let r=e.createValueStore(t),i=null,a=null,o=()=>{i!==null&&(clearTimeout(i),i=null)};return{update:({value:e,enabled:t})=>{a!==null&&Object.is(a.value,e)&&a.enabled===t||(a={value:e,enabled:t},o(),t&&(i=setTimeout(()=>{i=null,r.setSnapshot(e)},n)))},getSnapshot:r.getSnapshot,subscribe:r.subscribe,dispose:o}};exports.createDebouncedValueStore=t;

package/dist/controllers/debouncedValueStore.d.ts

@@ -0,0 +1,11 @@
+export type DebouncedValueArgs<V> = {
+    value: V;
+    enabled: boolean;
+};
+export type DebouncedValueStore<V> = {
+    update: (args: DebouncedValueArgs<V>) => void;
+    getSnapshot: () => V;
+    subscribe: (listener: () => void) => () => void;
+    dispose: () => void;
+};
+export declare const createDebouncedValueStore: <V>(initial: V, delayMs: number) => DebouncedValueStore<V>;

package/dist/controllers/debouncedValueStore.js

@@ -0,0 +1,22 @@
+import { createValueStore as e } from "../logic/valueStore.js";
+//#region src/controllers/debouncedValueStore.ts
+var t = (t, n) => {
+	let r = e(t), i = null, a = null, o = () => {
+		i !== null && (clearTimeout(i), i = null);
+	};
+	return {
+		update: ({ value: e, enabled: t }) => {
+			a !== null && Object.is(a.value, e) && a.enabled === t || (a = {
+				value: e,
+				enabled: t
+			}, o(), t && (i = setTimeout(() => {
+				i = null, r.setSnapshot(e);
+			}, n)));
+		},
+		getSnapshot: r.getSnapshot,
+		subscribe: r.subscribe,
+		dispose: o
+	};
+};
+//#endregion
+export { t as createDebouncedValueStore };

package/dist/controllers/editController.cjs

@@ -0,0 +1 @@
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("../logic/detailRow.cjs"),t=require("../model/gridActions.cjs"),n=require("../logic/geometry.cjs"),r=require("../logic/editorValues.cjs"),i=require("../logic/validation.cjs");var a=()=>{let a=null,o=e=>{a=e},s=e=>{a!==null&&(a.dispatch(t.gridActions.startSelection(e)),a.dispatch(t.gridActions.endSelection()),a.dispatch(t.gridActions.activateCell(e)))},c=(e,n)=>{a!==null&&(a.setEditorInitialValue(n),a.dispatch(t.gridActions.startEdit(e)))},l=t=>{let r=a;r!==null&&requestAnimationFrame(()=>{if(e.isFocusInsideDetailCard()||r.gridRootRef.current?.focus(),t!==null&&a!==null){let e=a.rowModel.getRowCount(),r=a.visibleColumns.length;s({row:n.clamp(t.row,0,Math.max(e-1,0)),col:n.clamp(t.col,0,Math.max(r-1,0))})}r.editorActionGuardRef.current=!1})};return{update:o,activateSingleCell:s,startEditWithValue:c,commitEdit:(e,n)=>{if(a===null)return{status:`noop`};let{uiState:o,visibleColumns:s,rowModel:c,rows:u,applyServerSideCellEdits:d,onRowsChange:f,dispatch:p,editorActionGuardRef:m}=a;if(m.current||!o.editingCell)return{status:`noop`};let h=o.editingCell,g=n===`down`?{row:h.row+1,col:h.col}:n===`up`?{row:h.row-1,col:h.col}:n===`right`?{row:h.row,col:h.col+1}:n===`left`?{row:h.row,col:h.col-1}:h,_=s[h.col],v=c.getSourceIndex(h.row),y=d?c.getRow(h.row):u[v];if(!_||!y)return p(t.gridActions.stopEdit()),{status:`noop`};if(d){let t=r.parseCommittedValue(_,e,y),n=i.decideCellWrite(_,y,t);if(n.action===`reject`)return{status:`rejected`,message:n.message};d([{viewIndex:h.row,column:_,value:t}])}else if(f){let t=r.parseCommittedValue(_,e,y),n=i.decideCellWrite(_,y,t);if(n.action===`reject`)return{status:`rejected`,message:n.message};f(r.writeRowsCell(u,v,_,t))}return m.current=!0,l(g),p(t.gridActions.stopEdit()),{status:`committed`}},cancelEdit:()=>{a===null||a.editorActionGuardRef.current||(a.editorActionGuardRef.current=!0,a.dispatch(t.gridActions.stopEdit()),l(null))}}};exports.createEditController=a;

package/dist/controllers/editController.d.ts

@@ -0,0 +1,27 @@
+import { type GridUiAction } from '../model/gridActions';
+import type { CellCoord, EditorCommitDirection, EditorCommitResult, GridColumn, GridUiState, RowModel } from '../model/gridTypes.unbound';
+import type { ServerSideCellEditInput } from '../logic/serverSideEdits';
+export type EditControllerArgs<T extends object> = {
+    uiState: GridUiState;
+    rows: T[];
+    visibleColumns: GridColumn<T>[];
+    rowModel: RowModel<T>;
+    setEditorInitialValue: (value: string) => void;
+    onRowsChange?: (nextRows: T[]) => void;
+    applyServerSideCellEdits?: (edits: ServerSideCellEditInput<T>[]) => number;
+    dispatch: (action: GridUiAction) => void;
+    gridRootRef: {
+        readonly current: HTMLElement | null;
+    };
+    editorActionGuardRef: {
+        current: boolean;
+    };
+};
+export type EditController<T extends object> = {
+    update: (args: EditControllerArgs<T>) => void;
+    activateSingleCell: (cell: CellCoord) => void;
+    startEditWithValue: (cell: CellCoord, initialValue: string) => void;
+    commitEdit: (committedValue: unknown, direction?: EditorCommitDirection) => EditorCommitResult;
+    cancelEdit: () => void;
+};
+export declare const createEditController: <T extends object>() => EditController<T>;

package/dist/controllers/editController.js

@@ -0,0 +1,76 @@
+import { isFocusInsideDetailCard as e } from "../logic/detailRow.js";
+import { gridActions as t } from "../model/gridActions.js";
+import { clamp as n } from "../logic/geometry.js";
+import { parseCommittedValue as r, writeRowsCell as i } from "../logic/editorValues.js";
+import { decideCellWrite as a } from "../logic/validation.js";
+//#region src/controllers/editController.ts
+var o = () => {
+	let o = null, s = (e) => {
+		o = e;
+	}, c = (e) => {
+		o !== null && (o.dispatch(t.startSelection(e)), o.dispatch(t.endSelection()), o.dispatch(t.activateCell(e)));
+	}, l = (e, n) => {
+		o !== null && (o.setEditorInitialValue(n), o.dispatch(t.startEdit(e)));
+	}, u = (t) => {
+		let r = o;
+		r !== null && requestAnimationFrame(() => {
+			if (e() || r.gridRootRef.current?.focus(), t !== null && o !== null) {
+				let e = o.rowModel.getRowCount(), r = o.visibleColumns.length;
+				c({
+					row: n(t.row, 0, Math.max(e - 1, 0)),
+					col: n(t.col, 0, Math.max(r - 1, 0))
+				});
+			}
+			r.editorActionGuardRef.current = !1;
+		});
+	};
+	return {
+		update: s,
+		activateSingleCell: c,
+		startEditWithValue: l,
+		commitEdit: (e, n) => {
+			if (o === null) return { status: "noop" };
+			let { uiState: s, visibleColumns: c, rowModel: l, rows: d, applyServerSideCellEdits: f, onRowsChange: p, dispatch: m, editorActionGuardRef: h } = o;
+			if (h.current || !s.editingCell) return { status: "noop" };
+			let g = s.editingCell, _ = n === "down" ? {
+				row: g.row + 1,
+				col: g.col
+			} : n === "up" ? {
+				row: g.row - 1,
+				col: g.col
+			} : n === "right" ? {
+				row: g.row,
+				col: g.col + 1
+			} : n === "left" ? {
+				row: g.row,
+				col: g.col - 1
+			} : g, v = c[g.col], y = l.getSourceIndex(g.row), b = f ? l.getRow(g.row) : d[y];
+			if (!v || !b) return m(t.stopEdit()), { status: "noop" };
+			if (f) {
+				let t = r(v, e, b), n = a(v, b, t);
+				if (n.action === "reject") return {
+					status: "rejected",
+					message: n.message
+				};
+				f([{
+					viewIndex: g.row,
+					column: v,
+					value: t
+				}]);
+			} else if (p) {
+				let t = r(v, e, b), n = a(v, b, t);
+				if (n.action === "reject") return {
+					status: "rejected",
+					message: n.message
+				};
+				p(i(d, y, v, t));
+			}
+			return h.current = !0, u(_), m(t.stopEdit()), { status: "committed" };
+		},
+		cancelEdit: () => {
+			o === null || o.editorActionGuardRef.current || (o.editorActionGuardRef.current = !0, o.dispatch(t.stopEdit()), u(null));
+		}
+	};
+};
+//#endregion
+export { o as createEditController };