Repository Public
1"use client";2import { useLayoutEffect, useRef, useState, type KeyboardEvent, type PointerEvent } from "react";3import { useI18n } from "@/i18n";4import { IconButton, cx } from "@/ui";5import { moveBy, moveTo, resizeBy, resizeTo, type Widget } from "./layout";6import { FrameControls, WidgetView, widgetTitle } from "./widgets";78interface GridProps {9 layout: readonly Widget[];10 editing: boolean;11 compact: boolean;12 onLayout: (next: Widget[]) => void;13 onRemove: (id: string) => void;14 onConfig: (id: string, config: Record<string, unknown>) => void;15 announce: (message: string) => void;16}1718interface DragState {19 id: string;20 mode: "move" | "resize";21 startX: number;22 startY: number;23 base: Widget[];24 origin: Widget;25 colStep: number;26 rowStep: number;27}2829/** Applies the grid placement through the CSSOM (no style attribute in markup: the CSP forbids inline styles). */30function Cell({ widget, editing, children }: { widget: Widget; editing: boolean; children: React.ReactNode }) {31 const ref = useRef<HTMLDivElement>(null);32 useLayoutEffect(() => {33 const el = ref.current;34 if (!el) return;35 el.style.setProperty("--ov-col", `${widget.x + 1} / span ${widget.w}`);36 el.style.setProperty("--ov-row", `${widget.y + 1} / span ${widget.h}`);37 }, [widget.x, widget.y, widget.w, widget.h]);38 return <div ref={ref} className={cx("ov-cell", editing && "editing")} data-widget={widget.id} data-testid={`ov-cell-${widget.id}`} data-x={widget.x} data-y={widget.y} data-w={widget.w} data-h={widget.h}>{children}</div>;39}4041/**42 * 12-column widget grid. In edit mode each widget gets a move handle, a resize handle and a remove button.43 * Pointer: drag a handle. Keyboard: focus the move handle — arrows move, Shift+arrows resize, Esc restores the44 * layout the handle had when it received focus; the resize handle resizes with plain arrows.45 */46export function Grid({ layout, editing, compact, onLayout, onRemove, onConfig, announce }: GridProps) {47 const { t } = useI18n();48 const grid = useRef<HTMLDivElement>(null);49 const drag = useRef<DragState | null>(null);50 const keyboardBase = useRef<Widget[] | null>(null);51 // While a handle is held (focus or pointer), the DOM order is frozen: re-inserting the node of the active52 // handle would drop its focus and its pointer capture. Reading order is restored as soon as it is released.53 const [frozen, setFrozen] = useState<string[] | null>(null);54 const freeze = () => setFrozen((f) => f ?? layout.map((w) => w.id));55 const rendered = frozen ? [...layout].sort((a, b) => (frozen.indexOf(a.id) + 1 || 1e6) - (frozen.indexOf(b.id) + 1 || 1e6)) : layout;5657 const describe = (next: readonly Widget[], id: string, key: "moved" | "resized") => {58 const w = next.find((x) => x.id === id);59 if (w) announce(t(`overview.edit.${key}`, { title: widgetTitle(t, w), column: w.x + 1, row: w.y + 1, width: w.w, height: w.h }));60 };6162 const onPointerDown = (e: PointerEvent<HTMLButtonElement>, id: string, mode: "move" | "resize") => {63 const el = grid.current;64 const origin = layout.find((w) => w.id === id);65 if (!el || !origin || e.button !== 0) return;66 const cs = getComputedStyle(el);67 if (cs.getPropertyValue("--ov-single").trim() === "1") return; // single-column (narrow) layout: keyboard / buttons only68 const gap = parseFloat(cs.columnGap) || 0;69 const rowUnit = parseFloat(cs.gridAutoRows) || 80;70 freeze();71 e.currentTarget.setPointerCapture(e.pointerId);72 drag.current = { id, mode, startX: e.clientX, startY: e.clientY, base: [...layout], origin, colStep: (el.getBoundingClientRect().width + gap) / 12, rowStep: rowUnit + gap };73 };74 const onPointerMove = (e: PointerEvent<HTMLButtonElement>) => {75 const d = drag.current;76 if (!d) return;77 const dx = Math.round((e.clientX - d.startX) / d.colStep);78 const dy = Math.round((e.clientY - d.startY) / d.rowStep);79 onLayout(d.mode === "move" ? moveTo(d.base, d.id, d.origin.x + dx, d.origin.y + dy) : resizeTo(d.base, d.id, d.origin.w + dx, d.origin.h + dy));80 };81 const endDrag = (e: PointerEvent<HTMLButtonElement>, cancel: boolean) => {82 const d = drag.current;83 if (!d) return;84 drag.current = null;85 if (e.currentTarget.hasPointerCapture(e.pointerId)) e.currentTarget.releasePointerCapture(e.pointerId);86 if (document.activeElement !== e.currentTarget) setFrozen(null);87 if (cancel) onLayout(d.base);88 else describe(layout, d.id, d.mode === "move" ? "moved" : "resized");89 };9091 const onKey = (e: KeyboardEvent<HTMLButtonElement>, id: string, handle: "move" | "resize") => {92 const dir: Record<string, [number, number]> = { ArrowLeft: [-1, 0], ArrowRight: [1, 0], ArrowUp: [0, -1], ArrowDown: [0, 1] };93 if (e.key === "Escape") {94 if (drag.current) {95 e.preventDefault();96 e.stopPropagation();97 const base = drag.current.base;98 drag.current = null;99 onLayout(base);100 } else if (keyboardBase.current) {101 e.preventDefault();102 e.stopPropagation();103 onLayout(keyboardBase.current);104 announce(t("overview.edit.cancelled"));105 }106 return;107 }108 const d = dir[e.key];109 if (!d) return;110 e.preventDefault();111 const resize = handle === "resize" || e.shiftKey;112 const next = resize ? resizeBy(layout, id, d[0], d[1]) : moveBy(layout, id, d[0], d[1]);113 onLayout(next);114 describe(next, id, resize ? "resized" : "moved");115 };116117 return (118 <div ref={grid} className={cx("ov-grid", compact && "compact", editing && "editing")} data-testid="ov-grid">119 {rendered.map((w) => {120 const title = widgetTitle(t, w);121 const controls = editing ? (122 <span className="ov-controls">123 <IconButton124 icon="drag" size="sm" tip={false}125 label={t("overview.edit.moveHandle", { title, column: w.x + 1, row: w.y + 1 })}126 aria-describedby="ov-edit-help"127 data-testid={`ov-move-${w.id}`}128 data-handle="move"129 onFocus={() => { keyboardBase.current = [...layout]; freeze(); }}130 onBlur={() => { keyboardBase.current = null; setFrozen(null); }}131 onKeyDown={(e) => onKey(e, w.id, "move")}132 onPointerDown={(e) => onPointerDown(e, w.id, "move")}133 onPointerMove={onPointerMove}134 onPointerUp={(e) => endDrag(e, false)}135 onPointerCancel={(e) => endDrag(e, true)}136 />137 <IconButton138 icon="expand" size="sm" tip={false}139 label={t("overview.edit.resizeHandle", { title, width: w.w, height: w.h })}140 aria-describedby="ov-edit-help"141 data-testid={`ov-resize-${w.id}`}142 data-handle="resize"143 onFocus={() => { keyboardBase.current = [...layout]; freeze(); }}144 onBlur={() => { keyboardBase.current = null; setFrozen(null); }}145 onKeyDown={(e) => onKey(e, w.id, "resize")}146 onPointerDown={(e) => onPointerDown(e, w.id, "resize")}147 onPointerMove={onPointerMove}148 onPointerUp={(e) => endDrag(e, false)}149 onPointerCancel={(e) => endDrag(e, true)}150 />151 <IconButton icon="close" size="sm" tip={false} label={t("overview.edit.remove", { title })} data-testid={`ov-remove-${w.id}`} onClick={() => onRemove(w.id)} />152 </span>153 ) : null;154 return (155 <Cell key={w.id} widget={w} editing={editing}>156 <FrameControls.Provider value={controls}>157 <WidgetView widget={w} onConfig={(config) => onConfig(w.id, config)} />158 </FrameControls.Provider>159 </Cell>160 );161 })}162 </div>163 );164}165