@declarion/react 0.1.91 → 0.1.93

package/dist-lib/Grid-C69-4exi.js

@@ -0,0 +1,405 @@
+import { _ as e, b as t, d as n, f as r, i, o as a, t as o, v as s, x as c, y as l } from "./value-DFpIiSZ-.js";
+import { useCallback as u, useEffect as d, useMemo as f, useRef as p, useState as m } from "react";
+import { Fragment as h, jsx as g, jsxs as _ } from "react/jsx-runtime";
+import { DndContext as v, PointerSensor as y, closestCenter as b, useSensor as x, useSensors as S } from "@dnd-kit/core";
+import { SortableContext as C, arrayMove as ee, rectSortingStrategy as te, useSortable as w } from "@dnd-kit/sortable";
+import { CSS as T } from "@dnd-kit/utilities";
+//#region src/components/file-widgets/Grid.tsx
+function E(e, t) {
+	return n(e, t);
+}
+function D(n) {
+	let { field: r, fieldName: i, value: l, onChange: h, mode: w, disabled: T } = n, E = o(l), [D, k] = m([]), [A, j] = m(/* @__PURE__ */ new Set()), [M, N] = m(null), { register: P, unregister: F, isDraft: I } = a(), L = p(/* @__PURE__ */ new Set()), R = p([]);
+	R.current = D;
+	let z = p(E);
+	z.current = E, d(() => () => {
+		R.current.forEach((e) => e.abort());
+	}, []);
+	let B = S(x(y, { activationConstraint: { distance: 5 } })), V = r.display?.placeholder || i, H = (r.accepts ?? ["image/*"]).join(","), U = r.display?.reorderable !== !1, W = r.display?.listable_thumbnail, G = u(async (a) => {
+		let o = c(a, r.accepts, r.max_size_bytes), l = `tile-${Math.random().toString(36).slice(2)}-${Date.now()}`, u = new AbortController();
+		if (o) {
+			k((e) => [...e, {
+				localId: l,
+				filename: a.name,
+				progress: null,
+				error: o,
+				abort: () => {}
+			}]);
+			return;
+		}
+		k((e) => [...e, {
+			localId: l,
+			filename: a.name,
+			progress: {
+				loaded: 0,
+				total: a.size,
+				pct: 0
+			},
+			error: null,
+			abort: () => u.abort()
+		}]);
+		try {
+			let e = await t({
+				file: a,
+				entityCode: n.entityCode,
+				fieldCode: i,
+				signal: u.signal,
+				onProgress: (e) => k((t) => t.map((t) => t.localId === l ? {
+					...t,
+					progress: e
+				} : t))
+			});
+			if (L.current.delete(l)) {
+				s(e.id).catch(() => {}), F(e.id);
+				return;
+			}
+			P(e.id, () => s(e.id));
+			let r = {
+				id: e.id,
+				filename: e.filename,
+				content_type: e.content_type,
+				size_bytes: e.size_bytes,
+				sha256: e.sha256,
+				width: e.width,
+				height: e.height,
+				url: e.url,
+				metadata: e.metadata
+			}, o = [...z.current, r];
+			z.current = o, h?.(o), k((e) => e.filter((e) => e.localId !== l));
+		} catch (t) {
+			if (t instanceof e && t.code === "ABORTED") {
+				k((e) => e.filter((e) => e.localId !== l));
+				return;
+			}
+			let n = t instanceof e ? {
+				code: t.code,
+				message: t.message
+			} : {
+				code: "UNKNOWN",
+				message: t instanceof Error ? t.message : "Upload failed"
+			};
+			k((e) => e.map((e) => e.localId === l ? {
+				...e,
+				error: n,
+				progress: null,
+				abort: () => {}
+			} : e));
+		}
+	}, [
+		r.accepts,
+		r.max_size_bytes,
+		i,
+		h,
+		n.entityCode,
+		P,
+		F
+	]), K = u((e) => {
+		Array.from(e).forEach((e) => void G(e));
+	}, [G]), q = p(null), J = u(() => {
+		T || q.current?.click();
+	}, [T]), ie = u((e) => {
+		T || (e.preventDefault(), e.dataTransfer.dropEffect = "copy");
+	}, [T]), ae = u((e) => {
+		if (T) return;
+		e.preventDefault();
+		let t = e.dataTransfer.files;
+		t && t.length > 0 && K(t);
+	}, [T, K]), oe = u((e) => {
+		let t = e.target.files;
+		e.target.value = "", t && t.length > 0 && K(t);
+	}, [K]), se = u((e) => {
+		I(e) && (s(e).catch(() => {}), F(e));
+		let t = E.filter((t) => t.id !== e);
+		h?.(t), j((t) => {
+			let n = new Set(t);
+			return n.delete(e), n;
+		});
+	}, [
+		I,
+		E,
+		h,
+		F
+	]), ce = u(() => {
+		A.size !== 0 && (Array.from(A).forEach((e) => {
+			I(e) && (s(e).catch(() => {}), F(e));
+		}), h?.(E.filter((e) => !A.has(e.id))), j(/* @__PURE__ */ new Set()));
+	}, [
+		I,
+		E,
+		A,
+		h,
+		F
+	]), le = u((e) => {
+		let { active: t, over: n } = e;
+		if (!n || t.id === n.id) return;
+		let r = E.findIndex((e) => e.id === t.id), i = E.findIndex((e) => e.id === n.id);
+		r < 0 || i < 0 || h?.(ee(E, r, i));
+	}, [E, h]), ue = u((e) => {
+		j((t) => {
+			let n = new Set(t);
+			return n.has(e) ? n.delete(e) : n.add(e), n;
+		});
+	}, []), Y = M == null ? null : E[M], X = u(() => {
+		N((e) => e == null ? e : Math.min(E.length - 1, e + 1));
+	}, [E.length]), Z = u(() => {
+		N((e) => e == null ? e : Math.max(0, e - 1));
+	}, []), Q = u(() => N(null), []);
+	d(() => {
+		if (M == null) return;
+		let e = (e) => {
+			e.key === "Escape" ? Q() : e.key === "ArrowRight" ? X() : e.key === "ArrowLeft" && Z();
+		};
+		return window.addEventListener("keydown", e), () => window.removeEventListener("keydown", e);
+	}, [
+		M,
+		Q,
+		X,
+		Z
+	]);
+	let de = u((e) => {
+		T || (e.key === "Enter" || e.key === " ") && e.target === e.currentTarget && (e.preventDefault(), J());
+	}, [T, J]), $ = w === "display", fe = f(() => E.map((e) => e.id), [E]);
+	return /* @__PURE__ */ _("div", {
+		"data-testid": `file-widget-${i}`,
+		className: "flex flex-col gap-2",
+		children: [
+			!$ && A.size > 0 && /* @__PURE__ */ _("div", {
+				className: "flex items-center gap-2 rounded-md border border-border bg-surface-2 p-2 text-sm",
+				role: "toolbar",
+				"aria-label": "Bulk actions",
+				children: [
+					/* @__PURE__ */ _("span", {
+						className: "text-foreground",
+						children: [A.size, " selected"]
+					}),
+					/* @__PURE__ */ g("button", {
+						type: "button",
+						className: "rounded-sm border border-border bg-card px-2 py-1 text-xs text-destructive hover:bg-surface-2",
+						onClick: ce,
+						"data-testid": "bulk-delete",
+						children: "Delete"
+					}),
+					/* @__PURE__ */ g("button", {
+						type: "button",
+						className: "rounded-sm border border-border bg-card px-2 py-1 text-xs text-foreground hover:bg-surface-2",
+						onClick: () => j(/* @__PURE__ */ new Set()),
+						children: "Clear"
+					})
+				]
+			}),
+			/* @__PURE__ */ g(v, {
+				sensors: B,
+				collisionDetection: b,
+				onDragEnd: le,
+				children: /* @__PURE__ */ g(C, {
+					items: fe,
+					strategy: te,
+					children: /* @__PURE__ */ _("div", {
+						className: "grid grid-cols-[repeat(auto-fill,minmax(140px,1fr))] gap-3 rounded-md border border-dashed border-border bg-surface p-3 outline-none focus-visible:outline-2 focus-visible:outline-accent",
+						role: "grid",
+						"aria-label": V,
+						tabIndex: $ || T ? -1 : 0,
+						onDragOver: ie,
+						onDrop: ae,
+						onKeyDown: de,
+						"data-testid": "grid-container",
+						children: [
+							E.map((e, t) => /* @__PURE__ */ g(O, {
+								file: e,
+								selected: A.has(e.id),
+								disabled: T || $,
+								reorderable: U && !$,
+								preferredThumbnail: W,
+								onSelect: () => ue(e.id),
+								onRemove: () => se(e.id),
+								onPreview: () => N(t)
+							}, e.id)),
+							D.map((e) => /* @__PURE__ */ g(ne, {
+								tile: e,
+								onCancel: () => {
+									e.abort(), L.current.add(e.localId), k((t) => t.filter((t) => t.localId !== e.localId));
+								},
+								onDismiss: () => k((t) => t.filter((t) => t.localId !== e.localId))
+							}, e.localId)),
+							E.length === 0 && D.length === 0 && /* @__PURE__ */ g("div", {
+								className: "col-span-full flex h-24 cursor-pointer items-center justify-center text-sm text-muted-foreground",
+								onClick: J,
+								"data-testid": "grid-empty",
+								children: r.display?.placeholder || "Drop files here or click to browse"
+							})
+						]
+					})
+				})
+			}),
+			!$ && /* @__PURE__ */ g("input", {
+				ref: q,
+				type: "file",
+				accept: H,
+				multiple: !0,
+				onChange: oe,
+				style: { display: "none" },
+				"data-testid": `file-input-${i}`
+			}),
+			Y && /* @__PURE__ */ g(re, {
+				file: Y,
+				hasPrev: M > 0,
+				hasNext: M < E.length - 1,
+				onPrev: Z,
+				onNext: X,
+				onClose: Q
+			})
+		]
+	});
+}
+function O({ file: e, selected: t, disabled: n, reorderable: a, preferredThumbnail: o, onSelect: s, onRemove: c, onPreview: l }) {
+	let { attributes: u, listeners: d, setNodeRef: f, transform: p, transition: m, isDragging: v } = w({
+		id: e.id,
+		disabled: !a
+	}), y = {
+		transform: T.Transform.toString(p),
+		transition: m,
+		opacity: v ? .5 : 1
+	}, b = i(e.id, r(e, o), E(e, o));
+	return /* @__PURE__ */ _("div", {
+		ref: f,
+		style: y,
+		className: `group relative aspect-square overflow-hidden rounded-md border ${t ? "border-accent" : "border-border"} bg-surface-2`,
+		"data-testid": `grid-tile-${e.id}`,
+		"data-selected": t || void 0,
+		children: [b ? /* @__PURE__ */ g("img", {
+			src: b,
+			alt: e.filename,
+			className: "h-full w-full cursor-pointer object-cover",
+			loading: "lazy",
+			onClick: l
+		}) : /* @__PURE__ */ g("div", {
+			className: "flex h-full w-full cursor-pointer items-center justify-center bg-surface-3 text-xs text-muted-foreground",
+			onClick: l,
+			children: e.filename
+		}), !n && /* @__PURE__ */ _(h, { children: [
+			/* @__PURE__ */ g("input", {
+				type: "checkbox",
+				className: "absolute left-1 top-1 h-4 w-4 cursor-pointer",
+				checked: t,
+				onChange: s,
+				"aria-label": `Select ${e.filename}`,
+				"data-testid": `select-${e.id}`,
+				onClick: (e) => e.stopPropagation()
+			}),
+			a && /* @__PURE__ */ g("button", {
+				type: "button",
+				className: "absolute right-1 top-1 cursor-grab rounded-sm border border-border bg-card px-1 text-xs",
+				"aria-label": `Drag to reorder ${e.filename}`,
+				"data-testid": `drag-${e.id}`,
+				...u,
+				...d,
+				children: "⋮⋮"
+			}),
+			/* @__PURE__ */ _("div", {
+				className: "absolute inset-x-0 bottom-0 flex items-center justify-end gap-1 bg-black/50 p-1 opacity-0 transition-opacity group-hover:opacity-100 group-focus-within:opacity-100",
+				children: [/* @__PURE__ */ g("button", {
+					type: "button",
+					className: "rounded-sm border border-border bg-card px-2 py-0.5 text-xs",
+					onClick: l,
+					children: "View"
+				}), /* @__PURE__ */ g("button", {
+					type: "button",
+					className: "rounded-sm border border-border bg-card px-2 py-0.5 text-xs text-destructive",
+					onClick: c,
+					"data-testid": `remove-${e.id}`,
+					children: "Delete"
+				})]
+			})
+		] })]
+	});
+}
+function ne({ tile: e, onCancel: t, onDismiss: n }) {
+	return /* @__PURE__ */ _("div", {
+		className: `relative flex aspect-square flex-col items-center justify-center rounded-md border ${e.error ? "border-destructive" : "border-border"} bg-surface-2 p-2 text-center text-xs`,
+		"data-testid": `pending-tile-${e.localId}`,
+		children: [
+			/* @__PURE__ */ g("span", {
+				className: "truncate",
+				title: e.filename,
+				children: e.filename
+			}),
+			e.progress && !e.error && /* @__PURE__ */ _("span", {
+				className: "mt-1 text-muted-foreground",
+				role: "progressbar",
+				"aria-valuenow": e.progress.pct,
+				"aria-valuemin": 0,
+				"aria-valuemax": 100,
+				children: [e.progress.pct, "%"]
+			}),
+			e.error && /* @__PURE__ */ g("div", {
+				role: "alert",
+				className: "mt-1 text-destructive",
+				children: e.error.message
+			}),
+			/* @__PURE__ */ g("button", {
+				type: "button",
+				className: "mt-1 rounded-sm border border-border bg-card px-2 py-0.5",
+				onClick: e.error ? n : t,
+				children: e.error ? "Dismiss" : "Cancel"
+			})
+		]
+	});
+}
+function re({ file: e, hasPrev: t, hasNext: n, onPrev: r, onNext: a, onClose: o }) {
+	let s = i(e.id, "preview", e.presigned_url ?? e.url ?? E(e));
+	return /* @__PURE__ */ _("div", {
+		className: "fixed inset-0 z-50 flex items-center justify-center bg-black/80",
+		role: "dialog",
+		"aria-modal": "true",
+		"aria-label": e.filename,
+		"data-testid": "lightbox",
+		onClick: o,
+		children: [
+			/* @__PURE__ */ g("button", {
+				type: "button",
+				className: "absolute right-4 top-4 rounded-sm border border-border bg-card px-3 py-1 text-foreground",
+				onClick: (e) => {
+					e.stopPropagation(), o();
+				},
+				"data-testid": "lightbox-close",
+				children: "Close"
+			}),
+			t && /* @__PURE__ */ g("button", {
+				type: "button",
+				className: "absolute left-4 rounded-sm border border-border bg-card px-3 py-2 text-foreground",
+				onClick: (e) => {
+					e.stopPropagation(), r();
+				},
+				"data-testid": "lightbox-prev",
+				children: "‹"
+			}),
+			n && /* @__PURE__ */ g("button", {
+				type: "button",
+				className: "absolute right-4 bottom-4 rounded-sm border border-border bg-card px-3 py-2 text-foreground",
+				onClick: (e) => {
+					e.stopPropagation(), a();
+				},
+				"data-testid": "lightbox-next",
+				children: "›"
+			}),
+			s ? /* @__PURE__ */ g("img", {
+				src: s,
+				alt: e.filename,
+				className: "max-h-[90vh] max-w-[90vw] object-contain",
+				onClick: (e) => e.stopPropagation()
+			}) : /* @__PURE__ */ _("div", {
+				className: "rounded-md bg-card p-4 text-foreground",
+				children: [
+					e.filename,
+					" (",
+					l(e.size_bytes),
+					")"
+				]
+			})
+		]
+	});
+}
+//#endregion
+export { D as Grid };
+
+//# sourceMappingURL=Grid-C69-4exi.js.map

package/dist-lib/Grid-C69-4exi.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Grid-C69-4exi.js","names":[],"sources":["../src/components/file-widgets/Grid.tsx"],"sourcesContent":["import {\n  useCallback,\n  useEffect,\n  useMemo,\n  useRef,\n  useState,\n} from \"react\";\nimport type { CSSProperties, DragEvent, KeyboardEvent } from \"react\";\nimport {\n  DndContext,\n  closestCenter,\n  PointerSensor,\n  useSensor,\n  useSensors,\n  type DragEndEvent,\n} from \"@dnd-kit/core\";\nimport {\n  SortableContext,\n  rectSortingStrategy,\n  useSortable,\n  arrayMove,\n} from \"@dnd-kit/sortable\";\nimport { CSS } from \"@dnd-kit/utilities\";\nimport {\n  uploadFile,\n  discardFile,\n  validateClientSide,\n  formatBytes,\n  UploadError,\n} from \"./upload\";\nimport { useDraftRegistration } from \"./draft-scope\";\nimport { preferredListThumbnailURL, preferredThumbnailVariant } from \"./helpers\";\nimport { useEmbedFileSrc } from \"./useEmbedFileSrc\";\nimport { fileArrayFromValue } from \"./value\";\nimport type {\n  FileWidgetProps,\n  HydratedFile,\n  UploadProgress,\n} from \"./types\";\n\n// Grid widget: thumbnail grid for `mode: array` files. Per einstein §6.4.\n//\n// Behaviors:\n//   - drag-drop multi-upload (each file gets its own progress tile)\n//   - per-item hover overlay (View / Metadata / Delete)\n//   - drag-handle reorder via @dnd-kit\n//   - multi-select toolbar with Bulk Delete\n//   - click → lightbox with prev/next + keyboard nav\n//   - IntersectionObserver lazy thumbnail loading\n//   - per-tile thumbnail prefers the schema-selected list derivation, then\n//     falls back to built-in thumbs or the primary file URL\n//\n// Value contract: array of HydratedFile. onChange emits the full new array\n// (callers persist it via the entity's $files payload on save).\n\ninterface InFlightTile {\n  // Local-only tiles representing uploads in progress. Once finished they\n  // are appended to the value array and removed from this list.\n  localId: string;\n  filename: string;\n  progress: UploadProgress | null;\n  error: { code: string; message: string } | null;\n  abort: () => void;\n}\n\nfunction thumbUrl(f: HydratedFile, preferredDerivationKey?: string): string | undefined {\n  return preferredListThumbnailURL(f, preferredDerivationKey);\n}\n\nexport function Grid(props: FileWidgetProps) {\n  const { field, fieldName, value, onChange, mode, disabled } = props;\n  const items = fileArrayFromValue(value);\n  const [tiles, setTiles] = useState<InFlightTile[]>([]);\n  const [selected, setSelected] = useState<Set<string>>(new Set());\n  const [lightbox, setLightbox] = useState<number | null>(null);\n  const { register, unregister, isDraft } = useDraftRegistration();\n  const cancelledUploadsRef = useRef<Set<string>>(new Set());\n  const tilesRef = useRef<InFlightTile[]>([]);\n  tilesRef.current = tiles;\n  // valueRef snapshots the current value array so parallel uploads append\n  // against the most recent state, not the closure they were created with.\n  const valueRef = useRef<HydratedFile[]>(items);\n  valueRef.current = items;\n\n  // Cleanup all in-flight uploads on unmount.\n  useEffect(() => {\n    return () => {\n      tilesRef.current.forEach((t) => t.abort());\n    };\n  }, []);\n\n  const sensors = useSensors(\n    useSensor(PointerSensor, { activationConstraint: { distance: 5 } }),\n  );\n\n  const ariaLabel = field.display?.placeholder || fieldName;\n  const accept = (field.accepts ?? [\"image/*\"]).join(\",\");\n  const reorderable = field.display?.reorderable !== false;\n  const preferredThumbnail = field.display?.listable_thumbnail;\n\n  const startUpload = useCallback(\n    async (raw: File) => {\n      const v = validateClientSide(raw, field.accepts, field.max_size_bytes);\n      const localId = `tile-${Math.random().toString(36).slice(2)}-${Date.now()}`;\n      const ctrl = new AbortController();\n\n      if (v) {\n        setTiles((prev) => [\n          ...prev,\n          {\n            localId,\n            filename: raw.name,\n            progress: null,\n            error: v,\n            abort: () => {},\n          },\n        ]);\n        return;\n      }\n\n      setTiles((prev) => [\n        ...prev,\n        {\n          localId,\n          filename: raw.name,\n          progress: { loaded: 0, total: raw.size, pct: 0 },\n          error: null,\n          abort: () => ctrl.abort(),\n        },\n      ]);\n\n      try {\n        const result = await uploadFile({\n          file: raw,\n          entityCode: props.entityCode,\n          fieldCode: fieldName,\n          signal: ctrl.signal,\n          onProgress: (p) =>\n            setTiles((prev) =>\n              prev.map((t) =>\n                t.localId === localId ? { ...t, progress: p } : t,\n              ),\n            ),\n        });\n        if (cancelledUploadsRef.current.delete(localId)) {\n          void discardFile(result.id).catch(() => {});\n          unregister(result.id);\n          return;\n        }\n        register(result.id, () => discardFile(result.id));\n        const next: HydratedFile = {\n          id: result.id,\n          filename: result.filename,\n          content_type: result.content_type,\n          size_bytes: result.size_bytes,\n          sha256: result.sha256,\n          width: result.width,\n          height: result.height,\n          url: result.url,\n          metadata: result.metadata,\n        };\n        const merged = [...valueRef.current, next];\n        valueRef.current = merged;\n        onChange?.(merged);\n        setTiles((prev) => prev.filter((t) => t.localId !== localId));\n      } catch (err) {\n        if (err instanceof UploadError && err.code === \"ABORTED\") {\n          setTiles((prev) => prev.filter((t) => t.localId !== localId));\n          return;\n        }\n        const e =\n          err instanceof UploadError\n            ? { code: err.code, message: err.message }\n            : {\n                code: \"UNKNOWN\",\n                message: err instanceof Error ? err.message : \"Upload failed\",\n              };\n        setTiles((prev) =>\n          prev.map((t) =>\n            t.localId === localId\n              ? { ...t, error: e, progress: null, abort: () => {} }\n              : t,\n          ),\n        );\n      }\n    },\n    [field.accepts, field.max_size_bytes, fieldName, onChange, props.entityCode, register, unregister],\n  );\n\n  const handleFiles = useCallback(\n    (files: FileList | File[]) => {\n      const arr = Array.from(files);\n      arr.forEach((f) => void startUpload(f));\n    },\n    [startUpload],\n  );\n\n  const fileInputRef = useRef<HTMLInputElement | null>(null);\n  const onPick = useCallback(() => {\n    if (disabled) return;\n    fileInputRef.current?.click();\n  }, [disabled]);\n\n  const onDragOver = useCallback(\n    (e: DragEvent<HTMLDivElement>) => {\n      if (disabled) return;\n      e.preventDefault();\n      e.dataTransfer.dropEffect = \"copy\";\n    },\n    [disabled],\n  );\n\n  const onDrop = useCallback(\n    (e: DragEvent<HTMLDivElement>) => {\n      if (disabled) return;\n      e.preventDefault();\n      const files = e.dataTransfer.files;\n      if (files && files.length > 0) handleFiles(files);\n    },\n    [disabled, handleFiles],\n  );\n\n  const onChangeFile = useCallback(\n    (e: React.ChangeEvent<HTMLInputElement>) => {\n      const files = e.target.files;\n      e.target.value = \"\";\n      if (files && files.length > 0) handleFiles(files);\n    },\n    [handleFiles],\n  );\n\n  const handleRemove = useCallback(\n    (id: string) => {\n      if (isDraft(id)) {\n        void discardFile(id).catch(() => {});\n        unregister(id);\n      }\n      const next = items.filter((f) => f.id !== id);\n      onChange?.(next);\n      setSelected((prev) => {\n        const n = new Set(prev);\n        n.delete(id);\n        return n;\n      });\n    },\n    [isDraft, items, onChange, unregister],\n  );\n\n  const handleBulkDelete = useCallback(() => {\n    if (selected.size === 0) return;\n    const ids = Array.from(selected);\n    ids.forEach((id) => {\n      if (isDraft(id)) {\n        void discardFile(id).catch(() => {});\n        unregister(id);\n      }\n    });\n    onChange?.(items.filter((f) => !selected.has(f.id)));\n    setSelected(new Set());\n  }, [isDraft, items, selected, onChange, unregister]);\n\n  const handleDragEnd = useCallback(\n    (event: DragEndEvent) => {\n      const { active, over } = event;\n      if (!over || active.id === over.id) return;\n      const oldIdx = items.findIndex((f) => f.id === active.id);\n      const newIdx = items.findIndex((f) => f.id === over.id);\n      if (oldIdx < 0 || newIdx < 0) return;\n      onChange?.(arrayMove(items, oldIdx, newIdx));\n    },\n    [items, onChange],\n  );\n\n  const toggleSelect = useCallback((id: string) => {\n    setSelected((prev) => {\n      const n = new Set(prev);\n      if (n.has(id)) n.delete(id);\n      else n.add(id);\n      return n;\n    });\n  }, []);\n\n  const lightboxFile = lightbox != null ? items[lightbox] : null;\n  const lightboxNext = useCallback(() => {\n    setLightbox((cur) =>\n      cur == null ? cur : Math.min(items.length - 1, cur + 1),\n    );\n  }, [items.length]);\n  const lightboxPrev = useCallback(() => {\n    setLightbox((cur) => (cur == null ? cur : Math.max(0, cur - 1)));\n  }, []);\n  const lightboxClose = useCallback(() => setLightbox(null), []);\n\n  useEffect(() => {\n    if (lightbox == null) return;\n    const handler = (e: globalThis.KeyboardEvent) => {\n      if (e.key === \"Escape\") lightboxClose();\n      else if (e.key === \"ArrowRight\") lightboxNext();\n      else if (e.key === \"ArrowLeft\") lightboxPrev();\n    };\n    window.addEventListener(\"keydown\", handler);\n    return () => window.removeEventListener(\"keydown\", handler);\n  }, [lightbox, lightboxClose, lightboxNext, lightboxPrev]);\n\n  const onGridKeyDown = useCallback(\n    (e: KeyboardEvent<HTMLDivElement>) => {\n      if (disabled) return;\n      if (e.key === \"Enter\" || e.key === \" \") {\n        if (e.target === e.currentTarget) {\n          e.preventDefault();\n          onPick();\n        }\n      }\n    },\n    [disabled, onPick],\n  );\n\n  const isDisplay = mode === \"display\";\n\n  const sortableIds = useMemo(() => items.map((f) => f.id), [items]);\n\n  return (\n    <div data-testid={`file-widget-${fieldName}`} className=\"flex flex-col gap-2\">\n      {!isDisplay && selected.size > 0 && (\n        <div\n          className=\"flex items-center gap-2 rounded-md border border-border bg-surface-2 p-2 text-sm\"\n          role=\"toolbar\"\n          aria-label=\"Bulk actions\"\n        >\n          <span className=\"text-foreground\">{selected.size} selected</span>\n          <button\n            type=\"button\"\n            className=\"rounded-sm border border-border bg-card px-2 py-1 text-xs text-destructive hover:bg-surface-2\"\n            onClick={handleBulkDelete}\n            data-testid=\"bulk-delete\"\n          >\n            Delete\n          </button>\n          <button\n            type=\"button\"\n            className=\"rounded-sm border border-border bg-card px-2 py-1 text-xs text-foreground hover:bg-surface-2\"\n            onClick={() => setSelected(new Set())}\n          >\n            Clear\n          </button>\n        </div>\n      )}\n\n      <DndContext\n        sensors={sensors}\n        collisionDetection={closestCenter}\n        onDragEnd={handleDragEnd}\n      >\n        <SortableContext items={sortableIds} strategy={rectSortingStrategy}>\n          <div\n            className=\"grid grid-cols-[repeat(auto-fill,minmax(140px,1fr))] gap-3 rounded-md border border-dashed border-border bg-surface p-3 outline-none focus-visible:outline-2 focus-visible:outline-accent\"\n            role=\"grid\"\n            aria-label={ariaLabel}\n            tabIndex={isDisplay || disabled ? -1 : 0}\n            onDragOver={onDragOver}\n            onDrop={onDrop}\n            onKeyDown={onGridKeyDown}\n            data-testid=\"grid-container\"\n          >\n            {items.map((f, idx) => (\n              <SortableTile\n                key={f.id}\n              file={f}\n              selected={selected.has(f.id)}\n              disabled={disabled || isDisplay}\n              reorderable={reorderable && !isDisplay}\n              preferredThumbnail={preferredThumbnail}\n              onSelect={() => toggleSelect(f.id)}\n              onRemove={() => handleRemove(f.id)}\n              onPreview={() => setLightbox(idx)}\n              />\n            ))}\n            {tiles.map((t) => (\n              <PendingTile\n                key={t.localId}\n                tile={t}\n                onCancel={() => {\n                  t.abort();\n                  cancelledUploadsRef.current.add(t.localId);\n                  setTiles((prev) =>\n                    prev.filter((x) => x.localId !== t.localId),\n                  );\n                }}\n                onDismiss={() =>\n                  setTiles((prev) =>\n                    prev.filter((x) => x.localId !== t.localId),\n                  )\n                }\n              />\n            ))}\n            {items.length === 0 && tiles.length === 0 && (\n              <div\n                className=\"col-span-full flex h-24 cursor-pointer items-center justify-center text-sm text-muted-foreground\"\n                onClick={onPick}\n                data-testid=\"grid-empty\"\n              >\n                {field.display?.placeholder || \"Drop files here or click to browse\"}\n              </div>\n            )}\n          </div>\n        </SortableContext>\n      </DndContext>\n\n      {!isDisplay && (\n        <input\n          ref={fileInputRef}\n          type=\"file\"\n          accept={accept}\n          multiple\n          onChange={onChangeFile}\n          style={{ display: \"none\" }}\n          data-testid={`file-input-${fieldName}`}\n        />\n      )}\n\n      {lightboxFile && (\n        <Lightbox\n          file={lightboxFile}\n          hasPrev={lightbox! > 0}\n          hasNext={lightbox! < items.length - 1}\n          onPrev={lightboxPrev}\n          onNext={lightboxNext}\n          onClose={lightboxClose}\n        />\n      )}\n    </div>\n  );\n}\n\nfunction SortableTile({\n  file,\n  selected,\n  disabled,\n  reorderable,\n  preferredThumbnail,\n  onSelect,\n  onRemove,\n  onPreview,\n}: {\n  file: HydratedFile;\n  selected: boolean;\n  disabled?: boolean;\n  reorderable: boolean;\n  preferredThumbnail?: string;\n  onSelect: () => void;\n  onRemove: () => void;\n  onPreview: () => void;\n}) {\n  const {\n    attributes,\n    listeners,\n    setNodeRef,\n    transform,\n    transition,\n    isDragging,\n  } = useSortable({ id: file.id, disabled: !reorderable });\n  const style: CSSProperties = {\n    transform: CSS.Transform.toString(transform),\n    transition,\n    opacity: isDragging ? 0.5 : 1,\n  };\n  // Cookie mode: `thumbUrl` is the static thumbnail URL, returned unchanged.\n  // Embed mode: resolved through the Bearer-authenticated file URL endpoint.\n  const url = useEmbedFileSrc(\n    file.id,\n    preferredThumbnailVariant(file, preferredThumbnail),\n    thumbUrl(file, preferredThumbnail),\n  );\n  return (\n    <div\n      ref={setNodeRef}\n      style={style}\n      className={`group relative aspect-square overflow-hidden rounded-md border ${\n        selected ? \"border-accent\" : \"border-border\"\n      } bg-surface-2`}\n      data-testid={`grid-tile-${file.id}`}\n      data-selected={selected || undefined}\n    >\n      {/* Lazy thumb: native loading=\"lazy\" approximates IntersectionObserver\n          and is what the rest of the SDK uses (see ImageWidget). */}\n      {url ? (\n        <img\n          src={url}\n          alt={file.filename}\n          className=\"h-full w-full cursor-pointer object-cover\"\n          loading=\"lazy\"\n          onClick={onPreview}\n        />\n      ) : (\n        <div\n          className=\"flex h-full w-full cursor-pointer items-center justify-center bg-surface-3 text-xs text-muted-foreground\"\n          onClick={onPreview}\n        >\n          {file.filename}\n        </div>\n      )}\n      {!disabled && (\n        <>\n          <input\n            type=\"checkbox\"\n            className=\"absolute left-1 top-1 h-4 w-4 cursor-pointer\"\n            checked={selected}\n            onChange={onSelect}\n            aria-label={`Select ${file.filename}`}\n            data-testid={`select-${file.id}`}\n            onClick={(e) => e.stopPropagation()}\n          />\n          {reorderable && (\n            <button\n              type=\"button\"\n              className=\"absolute right-1 top-1 cursor-grab rounded-sm border border-border bg-card px-1 text-xs\"\n              aria-label={`Drag to reorder ${file.filename}`}\n              data-testid={`drag-${file.id}`}\n              {...attributes}\n              {...listeners}\n            >\n              ⋮⋮\n            </button>\n          )}\n          <div className=\"absolute inset-x-0 bottom-0 flex items-center justify-end gap-1 bg-black/50 p-1 opacity-0 transition-opacity group-hover:opacity-100 group-focus-within:opacity-100\">\n            <button\n              type=\"button\"\n              className=\"rounded-sm border border-border bg-card px-2 py-0.5 text-xs\"\n              onClick={onPreview}\n            >\n              View\n            </button>\n            <button\n              type=\"button\"\n              className=\"rounded-sm border border-border bg-card px-2 py-0.5 text-xs text-destructive\"\n              onClick={onRemove}\n              data-testid={`remove-${file.id}`}\n            >\n              Delete\n            </button>\n          </div>\n        </>\n      )}\n    </div>\n  );\n}\n\nfunction PendingTile({\n  tile,\n  onCancel,\n  onDismiss,\n}: {\n  tile: InFlightTile;\n  onCancel: () => void;\n  onDismiss: () => void;\n}) {\n  return (\n    <div\n      className={`relative flex aspect-square flex-col items-center justify-center rounded-md border ${\n        tile.error ? \"border-destructive\" : \"border-border\"\n      } bg-surface-2 p-2 text-center text-xs`}\n      data-testid={`pending-tile-${tile.localId}`}\n    >\n      <span className=\"truncate\" title={tile.filename}>\n        {tile.filename}\n      </span>\n      {tile.progress && !tile.error && (\n        <span\n          className=\"mt-1 text-muted-foreground\"\n          role=\"progressbar\"\n          aria-valuenow={tile.progress.pct}\n          aria-valuemin={0}\n          aria-valuemax={100}\n        >\n          {tile.progress.pct}%\n        </span>\n      )}\n      {tile.error && (\n        <div role=\"alert\" className=\"mt-1 text-destructive\">\n          {tile.error.message}\n        </div>\n      )}\n      <button\n        type=\"button\"\n        className=\"mt-1 rounded-sm border border-border bg-card px-2 py-0.5\"\n        onClick={tile.error ? onDismiss : onCancel}\n      >\n        {tile.error ? \"Dismiss\" : \"Cancel\"}\n      </button>\n    </div>\n  );\n}\n\nfunction Lightbox({\n  file,\n  hasPrev,\n  hasNext,\n  onPrev,\n  onNext,\n  onClose,\n}: {\n  file: HydratedFile;\n  hasPrev: boolean;\n  hasNext: boolean;\n  onPrev: () => void;\n  onNext: () => void;\n  onClose: () => void;\n}) {\n  // The lightbox shows the full image. Cookie mode: the static primary URL.\n  // Embed mode: the primary file resolved through the embed file URL endpoint.\n  const url = useEmbedFileSrc(\n    file.id,\n    \"preview\",\n    file.presigned_url ?? file.url ?? thumbUrl(file),\n  );\n  return (\n    <div\n      className=\"fixed inset-0 z-50 flex items-center justify-center bg-black/80\"\n      role=\"dialog\"\n      aria-modal=\"true\"\n      aria-label={file.filename}\n      data-testid=\"lightbox\"\n      onClick={onClose}\n    >\n      <button\n        type=\"button\"\n        className=\"absolute right-4 top-4 rounded-sm border border-border bg-card px-3 py-1 text-foreground\"\n        onClick={(e) => {\n          e.stopPropagation();\n          onClose();\n        }}\n        data-testid=\"lightbox-close\"\n      >\n        Close\n      </button>\n      {hasPrev && (\n        <button\n          type=\"button\"\n          className=\"absolute left-4 rounded-sm border border-border bg-card px-3 py-2 text-foreground\"\n          onClick={(e) => {\n            e.stopPropagation();\n            onPrev();\n          }}\n          data-testid=\"lightbox-prev\"\n        >\n          ‹\n        </button>\n      )}\n      {hasNext && (\n        <button\n          type=\"button\"\n          className=\"absolute right-4 bottom-4 rounded-sm border border-border bg-card px-3 py-2 text-foreground\"\n          onClick={(e) => {\n            e.stopPropagation();\n            onNext();\n          }}\n          data-testid=\"lightbox-next\"\n        >\n          ›\n        </button>\n      )}\n      {url ? (\n        <img\n          src={url}\n          alt={file.filename}\n          className=\"max-h-[90vh] max-w-[90vw] object-contain\"\n          onClick={(e) => e.stopPropagation()}\n        />\n      ) : (\n        <div className=\"rounded-md bg-card p-4 text-foreground\">\n          {file.filename} ({formatBytes(file.size_bytes)})\n        </div>\n      )}\n    </div>\n  );\n}\n"],"mappings":";;;;;;;AAiEA,SAAS,EAAS,GAAiB,GAAqD;CACtF,OAAO,EAA0B,GAAG,CAAsB;AAC5D;AAEA,SAAgB,EAAK,GAAwB;CAC3C,IAAM,EAAE,UAAO,cAAW,UAAO,aAAU,SAAM,gBAAa,GACxD,IAAQ,EAAmB,CAAK,GAChC,CAAC,GAAO,KAAY,EAAyB,CAAC,CAAC,GAC/C,CAAC,GAAU,KAAe,kBAAsB,IAAI,IAAI,CAAC,GACzD,CAAC,GAAU,KAAe,EAAwB,IAAI,GACtD,EAAE,aAAU,eAAY,eAAY,EAAqB,GACzD,IAAsB,kBAAoB,IAAI,IAAI,CAAC,GACnD,IAAW,EAAuB,CAAC,CAAC;CAC1C,EAAS,UAAU;CAGnB,IAAM,IAAW,EAAuB,CAAK;CAI7C,AAHA,EAAS,UAAU,GAGnB,cACe;EACX,EAAS,QAAQ,SAAS,MAAM,EAAE,MAAM,CAAC;CAC3C,GACC,CAAC,CAAC;CAEL,IAAM,IAAU,EACd,EAAU,GAAe,EAAE,sBAAsB,EAAE,UAAU,EAAE,EAAE,CAAC,CACpE,GAEM,IAAY,EAAM,SAAS,eAAe,GAC1C,KAAU,EAAM,WAAW,CAAC,SAAS,GAAG,KAAK,GAAG,GAChD,IAAc,EAAM,SAAS,gBAAgB,IAC7C,IAAqB,EAAM,SAAS,oBAEpC,IAAc,EAClB,OAAO,MAAc;EACnB,IAAM,IAAI,EAAmB,GAAK,EAAM,SAAS,EAAM,cAAc,GAC/D,IAAU,QAAQ,KAAK,OAAO,EAAE,SAAS,EAAE,EAAE,MAAM,CAAC,EAAE,GAAG,KAAK,IAAI,KAClE,IAAO,IAAI,gBAAgB;EAEjC,IAAI,GAAG;GACL,GAAU,MAAS,CACjB,GAAG,GACH;IACE;IACA,UAAU,EAAI;IACd,UAAU;IACV,OAAO;IACP,aAAa,CAAC;GAChB,CACF,CAAC;GACD;EACF;EAEA,GAAU,MAAS,CACjB,GAAG,GACH;GACE;GACA,UAAU,EAAI;GACd,UAAU;IAAE,QAAQ;IAAG,OAAO,EAAI;IAAM,KAAK;GAAE;GAC/C,OAAO;GACP,aAAa,EAAK,MAAM;EAC1B,CACF,CAAC;EAED,IAAI;GACF,IAAM,IAAS,MAAM,EAAW;IAC9B,MAAM;IACN,YAAY,EAAM;IAClB,WAAW;IACX,QAAQ,EAAK;IACb,aAAa,MACX,GAAU,MACR,EAAK,KAAK,MACR,EAAE,YAAY,IAAU;KAAE,GAAG;KAAG,UAAU;IAAE,IAAI,CAClD,CACF;GACJ,CAAC;GACD,IAAI,EAAoB,QAAQ,OAAO,CAAO,GAAG;IAE/C,AADA,EAAiB,EAAO,EAAE,EAAE,YAAY,CAAC,CAAC,GAC1C,EAAW,EAAO,EAAE;IACpB;GACF;GACA,EAAS,EAAO,UAAU,EAAY,EAAO,EAAE,CAAC;GAChD,IAAM,IAAqB;IACzB,IAAI,EAAO;IACX,UAAU,EAAO;IACjB,cAAc,EAAO;IACrB,YAAY,EAAO;IACnB,QAAQ,EAAO;IACf,OAAO,EAAO;IACd,QAAQ,EAAO;IACf,KAAK,EAAO;IACZ,UAAU,EAAO;GACnB,GACM,IAAS,CAAC,GAAG,EAAS,SAAS,CAAI;GAGzC,AAFA,EAAS,UAAU,GACnB,IAAW,CAAM,GACjB,GAAU,MAAS,EAAK,QAAQ,MAAM,EAAE,YAAY,CAAO,CAAC;EAC9D,SAAS,GAAK;GACZ,IAAI,aAAe,KAAe,EAAI,SAAS,WAAW;IACxD,GAAU,MAAS,EAAK,QAAQ,MAAM,EAAE,YAAY,CAAO,CAAC;IAC5D;GACF;GACA,IAAM,IACJ,aAAe,IACX;IAAE,MAAM,EAAI;IAAM,SAAS,EAAI;GAAQ,IACvC;IACE,MAAM;IACN,SAAS,aAAe,QAAQ,EAAI,UAAU;GAChD;GACN,GAAU,MACR,EAAK,KAAK,MACR,EAAE,YAAY,IACV;IAAE,GAAG;IAAG,OAAO;IAAG,UAAU;IAAM,aAAa,CAAC;GAAE,IAClD,CACN,CACF;EACF;CACF,GACA;EAAC,EAAM;EAAS,EAAM;EAAgB;EAAW;EAAU,EAAM;EAAY;EAAU;CAAU,CACnG,GAEM,IAAc,GACjB,MAA6B;EAE5B,MADkB,KAAK,CACvB,EAAI,SAAS,MAAM,KAAK,EAAY,CAAC,CAAC;CACxC,GACA,CAAC,CAAW,CACd,GAEM,IAAe,EAAgC,IAAI,GACnD,IAAS,QAAkB;EAC3B,KACJ,EAAa,SAAS,MAAM;CAC9B,GAAG,CAAC,CAAQ,CAAC,GAEP,KAAa,GAChB,MAAiC;EAC5B,MACJ,EAAE,eAAe,GACjB,EAAE,aAAa,aAAa;CAC9B,GACA,CAAC,CAAQ,CACX,GAEM,KAAS,GACZ,MAAiC;EAChC,IAAI,GAAU;EACd,EAAE,eAAe;EACjB,IAAM,IAAQ,EAAE,aAAa;EAC7B,AAAI,KAAS,EAAM,SAAS,KAAG,EAAY,CAAK;CAClD,GACA,CAAC,GAAU,CAAW,CACxB,GAEM,KAAe,GAClB,MAA2C;EAC1C,IAAM,IAAQ,EAAE,OAAO;EAEvB,AADA,EAAE,OAAO,QAAQ,IACb,KAAS,EAAM,SAAS,KAAG,EAAY,CAAK;CAClD,GACA,CAAC,CAAW,CACd,GAEM,KAAe,GAClB,MAAe;EACd,AAAI,EAAQ,CAAE,MACZ,EAAiB,CAAE,EAAE,YAAY,CAAC,CAAC,GACnC,EAAW,CAAE;EAEf,IAAM,IAAO,EAAM,QAAQ,MAAM,EAAE,OAAO,CAAE;EAE5C,AADA,IAAW,CAAI,GACf,GAAa,MAAS;GACpB,IAAM,IAAI,IAAI,IAAI,CAAI;GAEtB,OADA,EAAE,OAAO,CAAE,GACJ;EACT,CAAC;CACH,GACA;EAAC;EAAS;EAAO;EAAU;CAAU,CACvC,GAEM,KAAmB,QAAkB;EACrC,EAAS,SAAS,MAEtB,MADkB,KAAK,CACvB,EAAI,SAAS,MAAO;GAClB,AAAI,EAAQ,CAAE,MACZ,EAAiB,CAAE,EAAE,YAAY,CAAC,CAAC,GACnC,EAAW,CAAE;EAEjB,CAAC,GACD,IAAW,EAAM,QAAQ,MAAM,CAAC,EAAS,IAAI,EAAE,EAAE,CAAC,CAAC,GACnD,kBAAY,IAAI,IAAI,CAAC;CACvB,GAAG;EAAC;EAAS;EAAO;EAAU;EAAU;CAAU,CAAC,GAE7C,KAAgB,GACnB,MAAwB;EACvB,IAAM,EAAE,WAAQ,YAAS;EACzB,IAAI,CAAC,KAAQ,EAAO,OAAO,EAAK,IAAI;EACpC,IAAM,IAAS,EAAM,WAAW,MAAM,EAAE,OAAO,EAAO,EAAE,GAClD,IAAS,EAAM,WAAW,MAAM,EAAE,OAAO,EAAK,EAAE;EAClD,IAAS,KAAK,IAAS,KAC3B,IAAW,GAAU,GAAO,GAAQ,CAAM,CAAC;CAC7C,GACA,CAAC,GAAO,CAAQ,CAClB,GAEM,KAAe,GAAa,MAAe;EAC/C,GAAa,MAAS;GACpB,IAAM,IAAI,IAAI,IAAI,CAAI;GAGtB,OAFI,EAAE,IAAI,CAAE,IAAG,EAAE,OAAO,CAAE,IACrB,EAAE,IAAI,CAAE,GACN;EACT,CAAC;CACH,GAAG,CAAC,CAAC,GAEC,IAAe,KAAY,OAAyB,OAAlB,EAAM,IACxC,IAAe,QAAkB;EACrC,GAAa,MACX,KAAO,OAAO,IAAM,KAAK,IAAI,EAAM,SAAS,GAAG,IAAM,CAAC,CACxD;CACF,GAAG,CAAC,EAAM,MAAM,CAAC,GACX,IAAe,QAAkB;EACrC,GAAa,MAAS,KAAO,OAAO,IAAM,KAAK,IAAI,GAAG,IAAM,CAAC,CAAE;CACjE,GAAG,CAAC,CAAC,GACC,IAAgB,QAAkB,EAAY,IAAI,GAAG,CAAC,CAAC;CAE7D,QAAgB;EACd,IAAI,KAAY,MAAM;EACtB,IAAM,KAAW,MAAgC;GAC/C,AAAI,EAAE,QAAQ,WAAU,EAAc,IAC7B,EAAE,QAAQ,eAAc,EAAa,IACrC,EAAE,QAAQ,eAAa,EAAa;EAC/C;EAEA,OADA,OAAO,iBAAiB,WAAW,CAAO,SAC7B,OAAO,oBAAoB,WAAW,CAAO;CAC5D,GAAG;EAAC;EAAU;EAAe;EAAc;CAAY,CAAC;CAExD,IAAM,KAAgB,GACnB,MAAqC;EAChC,MACA,EAAE,QAAQ,WAAW,EAAE,QAAQ,QAC7B,EAAE,WAAW,EAAE,kBACjB,EAAE,eAAe,GACjB,EAAO;CAGb,GACA,CAAC,GAAU,CAAM,CACnB,GAEM,IAAY,MAAS,WAErB,KAAc,QAAc,EAAM,KAAK,MAAM,EAAE,EAAE,GAAG,CAAC,CAAK,CAAC;CAEjE,OACE,kBAAC,OAAD;EAAK,eAAa,eAAe;EAAa,WAAU;YAAxD;GACG,CAAC,KAAa,EAAS,OAAO,KAC7B,kBAAC,OAAD;IACE,WAAU;IACV,MAAK;IACL,cAAW;cAHb;KAKE,kBAAC,QAAD;MAAM,WAAU;gBAAhB,CAAmC,EAAS,MAAK,WAAe;;KAChE,kBAAC,UAAD;MACE,MAAK;MACL,WAAU;MACV,SAAS;MACT,eAAY;gBACb;KAEO,CAAA;KACR,kBAAC,UAAD;MACE,MAAK;MACL,WAAU;MACV,eAAe,kBAAY,IAAI,IAAI,CAAC;gBACrC;KAEO,CAAA;IACL;;GAGP,kBAAC,GAAD;IACW;IACT,oBAAoB;IACpB,WAAW;cAEX,kBAAC,GAAD;KAAiB,OAAO;KAAa,UAAU;eAC7C,kBAAC,OAAD;MACE,WAAU;MACV,MAAK;MACL,cAAY;MACZ,UAAU,KAAa,IAAW,KAAK;MAC3B;MACJ;MACR,WAAW;MACX,eAAY;gBARd;OAUG,EAAM,KAAK,GAAG,MACb,kBAAC,GAAD;QAEA,MAAM;QACN,UAAU,EAAS,IAAI,EAAE,EAAE;QAC3B,UAAU,KAAY;QACtB,aAAa,KAAe,CAAC;QACT;QACpB,gBAAgB,GAAa,EAAE,EAAE;QACjC,gBAAgB,GAAa,EAAE,EAAE;QACjC,iBAAiB,EAAY,CAAG;OAC/B,GATM,EAAE,EASR,CACF;OACA,EAAM,KAAK,MACV,kBAAC,IAAD;QAEE,MAAM;QACN,gBAAgB;SAGd,AAFA,EAAE,MAAM,GACR,EAAoB,QAAQ,IAAI,EAAE,OAAO,GACzC,GAAU,MACR,EAAK,QAAQ,MAAM,EAAE,YAAY,EAAE,OAAO,CAC5C;QACF;QACA,iBACE,GAAU,MACR,EAAK,QAAQ,MAAM,EAAE,YAAY,EAAE,OAAO,CAC5C;OAEH,GAdM,EAAE,OAcR,CACF;OACA,EAAM,WAAW,KAAK,EAAM,WAAW,KACtC,kBAAC,OAAD;QACE,WAAU;QACV,SAAS;QACT,eAAY;kBAEX,EAAM,SAAS,eAAe;OAC5B,CAAA;MAEJ;;IACU,CAAA;GACP,CAAA;GAEX,CAAC,KACA,kBAAC,SAAD;IACE,KAAK;IACL,MAAK;IACG;IACR,UAAA;IACA,UAAU;IACV,OAAO,EAAE,SAAS,OAAO;IACzB,eAAa,cAAc;GAC5B,CAAA;GAGF,KACC,kBAAC,IAAD;IACE,MAAM;IACN,SAAS,IAAY;IACrB,SAAS,IAAY,EAAM,SAAS;IACpC,QAAQ;IACR,QAAQ;IACR,SAAS;GACV,CAAA;EAEA;;AAET;AAEA,SAAS,EAAa,EACpB,SACA,aACA,aACA,gBACA,uBACA,aACA,aACA,gBAUC;CACD,IAAM,EACJ,eACA,cACA,eACA,cACA,eACA,kBACE,EAAY;EAAE,IAAI,EAAK;EAAI,UAAU,CAAC;CAAY,CAAC,GACjD,IAAuB;EAC3B,WAAW,EAAI,UAAU,SAAS,CAAS;EAC3C;EACA,SAAS,IAAa,KAAM;CAC9B,GAGM,IAAM,EACV,EAAK,IACL,EAA0B,GAAM,CAAkB,GAClD,EAAS,GAAM,CAAkB,CACnC;CACA,OACE,kBAAC,OAAD;EACE,KAAK;EACE;EACP,WAAW,kEACT,IAAW,kBAAkB,gBAC9B;EACD,eAAa,aAAa,EAAK;EAC/B,iBAAe,KAAY,KAAA;YAP7B,CAWG,IACC,kBAAC,OAAD;GACE,KAAK;GACL,KAAK,EAAK;GACV,WAAU;GACV,SAAQ;GACR,SAAS;EACV,CAAA,IAED,kBAAC,OAAD;GACE,WAAU;GACV,SAAS;aAER,EAAK;EACH,CAAA,GAEN,CAAC,KACA,kBAAA,GAAA,EAAA,UAAA;GACE,kBAAC,SAAD;IACE,MAAK;IACL,WAAU;IACV,SAAS;IACT,UAAU;IACV,cAAY,UAAU,EAAK;IAC3B,eAAa,UAAU,EAAK;IAC5B,UAAU,MAAM,EAAE,gBAAgB;GACnC,CAAA;GACA,KACC,kBAAC,UAAD;IACE,MAAK;IACL,WAAU;IACV,cAAY,mBAAmB,EAAK;IACpC,eAAa,QAAQ,EAAK;IAC1B,GAAI;IACJ,GAAI;cACL;GAEO,CAAA;GAEV,kBAAC,OAAD;IAAK,WAAU;cAAf,CACE,kBAAC,UAAD;KACE,MAAK;KACL,WAAU;KACV,SAAS;eACV;IAEO,CAAA,GACR,kBAAC,UAAD;KACE,MAAK;KACL,WAAU;KACV,SAAS;KACT,eAAa,UAAU,EAAK;eAC7B;IAEO,CAAA,CACL;;EACL,EAAA,CAAA,CAED;;AAET;AAEA,SAAS,GAAY,EACnB,SACA,aACA,gBAKC;CACD,OACE,kBAAC,OAAD;EACE,WAAW,sFACT,EAAK,QAAQ,uBAAuB,gBACrC;EACD,eAAa,gBAAgB,EAAK;YAJpC;GAME,kBAAC,QAAD;IAAM,WAAU;IAAW,OAAO,EAAK;cACpC,EAAK;GACF,CAAA;GACL,EAAK,YAAY,CAAC,EAAK,SACtB,kBAAC,QAAD;IACE,WAAU;IACV,MAAK;IACL,iBAAe,EAAK,SAAS;IAC7B,iBAAe;IACf,iBAAe;cALjB,CAOG,EAAK,SAAS,KAAI,GACf;;GAEP,EAAK,SACJ,kBAAC,OAAD;IAAK,MAAK;IAAQ,WAAU;cACzB,EAAK,MAAM;GACT,CAAA;GAEP,kBAAC,UAAD;IACE,MAAK;IACL,WAAU;IACV,SAAS,EAAK,QAAQ,IAAY;cAEjC,EAAK,QAAQ,YAAY;GACpB,CAAA;EACL;;AAET;AAEA,SAAS,GAAS,EAChB,SACA,YACA,YACA,WACA,WACA,cAQC;CAGD,IAAM,IAAM,EACV,EAAK,IACL,WACA,EAAK,iBAAiB,EAAK,OAAO,EAAS,CAAI,CACjD;CACA,OACE,kBAAC,OAAD;EACE,WAAU;EACV,MAAK;EACL,cAAW;EACX,cAAY,EAAK;EACjB,eAAY;EACZ,SAAS;YANX;GAQE,kBAAC,UAAD;IACE,MAAK;IACL,WAAU;IACV,UAAU,MAAM;KAEd,AADA,EAAE,gBAAgB,GAClB,EAAQ;IACV;IACA,eAAY;cACb;GAEO,CAAA;GACP,KACC,kBAAC,UAAD;IACE,MAAK;IACL,WAAU;IACV,UAAU,MAAM;KAEd,AADA,EAAE,gBAAgB,GAClB,EAAO;IACT;IACA,eAAY;cACb;GAEO,CAAA;GAET,KACC,kBAAC,UAAD;IACE,MAAK;IACL,WAAU;IACV,UAAU,MAAM;KAEd,AADA,EAAE,gBAAgB,GAClB,EAAO;IACT;IACA,eAAY;cACb;GAEO,CAAA;GAET,IACC,kBAAC,OAAD;IACE,KAAK;IACL,KAAK,EAAK;IACV,WAAU;IACV,UAAU,MAAM,EAAE,gBAAgB;GACnC,CAAA,IAED,kBAAC,OAAD;IAAK,WAAU;cAAf;KACG,EAAK;KAAS;KAAG,EAAY,EAAK,UAAU;KAAE;IAC5C;;EAEJ;;AAET"}

package/dist-lib/api/data.d.ts

@@ -8,6 +8,7 @@ export declare function getEntity(entity: string, pkValues: PkValues | string):
 export declare function createEntity(entity: string, data: Record<string, unknown>): Promise<DataResponse>;
 export declare function updateEntity(entity: string, pkValues: PkValues | string, data: Record<string, unknown>): Promise<DataResponse>;
 export declare function deleteEntity(entity: string, pkValues: PkValues | string): Promise<void>;
+export declare function encodeObjectId(pkValues: PkValues): string;
 export declare function restoreEntity(entity: string, pkValues: PkValues | string): Promise<void>;
 /** Result of POST /api/data/{entity}/export. The server streams a CSV
  *  blob; the client gets the bytes plus the server-resolved filename

package/dist-lib/api/events.d.ts

@@ -42,5 +42,19 @@ export declare class SSEAuthError extends Error {
 export interface StreamEventsOptions {
     signal?: AbortSignal;
     lastEventID?: string;
+    /**
+     * Embed token mode: the scoped embed JWT. When set, it is sent as
+     * `Authorization: Bearer <token>` and the request omits cookies (see
+     * `credentials` below). Outside embed mode this is undefined and the
+     * cookie path runs unchanged.
+     */
+    bearerToken?: string;
+    /**
+     * Cookie policy for the SSE fetch. Defaults to `"include"` (the cookie
+     * path). Embed mode passes `"omit"`: the iframe is same-origin to
+     * Declarion and the auth middleware reads the cookie before the Bearer
+     * header, so a sent cookie would bypass the scoped embed token.
+     */
+    credentials?: RequestCredentials;
 }
 export declare function streamEvents(options?: StreamEventsOptions): AsyncGenerator<SSEEvent>;

package/dist-lib/components/detail-layout/AssociatedBlock.d.ts

@@ -1,4 +1,4 @@
-import type { LayoutNode, Action } from "../../types/schema";
+import type { LayoutNode, Entity, Action } from "../../types/schema";
 import type { LayoutContext } from "./LayoutRenderer";
 interface AssociatedBlockProps {
     node: LayoutNode;
@@ -12,5 +12,8 @@ export declare function resolveAssociatedToolbarActions(actions: Record<string,
     code: string;
     action: Action;
 }>;
+export declare function resolveAssociatedForeignKey(entities: Record<string, Entity>, parentEntityCode: string, assocCode: string): string | null;
+export declare function associatedEditableColumns(entity: Entity, columns: string[], foreignKey: string): Set<string>;
+export declare function associatedDraftEditableColumns(entity: Entity, columns: string[], foreignKey: string): Set<string>;
 export declare function AssociatedBlock({ node, ctx }: AssociatedBlockProps): import("react/jsx-runtime").JSX.Element | null;
 export {};

package/dist-lib/components/file-widgets/helpers.d.ts

@@ -1,3 +1,4 @@
+import type { EmbedFileVariant } from "../../embed/file-src";
 import type { HydratedFile } from "./types";
 export interface FocalPoint {
     x: number;
@@ -8,6 +9,7 @@ export declare function canPreviewFile(file: HydratedFile): boolean;
 export declare function previewFileURL(file: HydratedFile): string | undefined;
 export declare function downloadFileURL(file: HydratedFile): string | undefined;
 export declare function preferredListThumbnailURL(file: HydratedFile | null, preferredDerivationKey?: string): string | undefined;
+export declare function preferredThumbnailVariant(file: HydratedFile | null, preferredDerivationKey?: string): EmbedFileVariant;
 export declare function readFocalPoint(file: HydratedFile | null): FocalPoint | null;
 export declare function focalPointObjectPosition(point: FocalPoint | null): string | undefined;
 export declare function withFocalPoint(file: HydratedFile, point: FocalPoint): HydratedFile;

package/dist-lib/components/file-widgets/useEmbedFileSrc.d.ts

@@ -0,0 +1,42 @@
+import { type EmbedFileVariant } from "../../embed/file-src";
+/**
+ * Reactively resolve a file `src` for a native `<img>` element.
+ *
+ * Outside embed token mode the hook returns `staticUrl` unchanged and does no
+ * work - the cookie carries auth and the browser loads the URL directly, so
+ * behavior is identical to passing `staticUrl` straight to `<img src>`.
+ *
+ * In embed token mode the hook resolves through `resolveEmbedFileSrc`:
+ *  - a presigned (non-proxy) URL is used directly;
+ *  - a proxy-backed file is fetched as bytes and rendered from a `blob:` URL.
+ * The hook returns `undefined` until the async resolution settles, so the
+ * widget shows its placeholder rather than a broken image during the fetch.
+ *
+ * `fileId` may be undefined when the widget is empty; the hook then returns
+ * `staticUrl` (also typically undefined) and does nothing.
+ *
+ * A `blob:` object URL is revoked when `fileId` / `variant` changes and on
+ * unmount. A `DerivationPendingError` (the derived endpoint returned 202)
+ * resolves to `undefined` so the caller can fall back to the primary file.
+ */
+export declare function useEmbedFileSrc(fileId: string | undefined, variant: EmbedFileVariant, staticUrl: string | undefined): string | undefined;
+/**
+ * An imperative opener for the download / preview buttons.
+ *
+ * `window.open(url)` cannot attach an `Authorization` header, so in embed
+ * token mode a click must FIRST resolve the file to a presigned or `blob:`
+ * URL and THEN open that. Outside embed mode the returned function opens the
+ * static URL directly, unchanged from before.
+ *
+ * The returned `open(fileId, variant, staticUrl)` function:
+ *  - non-embed mode: `window.open(staticUrl)` synchronously, as before;
+ *  - embed mode: resolves via `resolveEmbedFileSrc`, then `window.open` the
+ *    result. A `blob:` URL opened this way is revoked on unmount (it must
+ *    outlive the click so the new tab can load it; revoking immediately would
+ *    break the open).
+ *
+ * Returns `{ open }`. `open` is a no-op when `fileId` / `staticUrl` is absent.
+ */
+export declare function useEmbedFileOpener(): {
+    open: (fileId: string | undefined, variant: EmbedFileVariant, staticUrl: string | undefined) => void;
+};