@declarion/react 0.65.1 → 0.66.1

package/dist-lib/components/file-widgets/ImageWidget.js

@@ -0,0 +1,354 @@
+import { useDeploymentLanguage as e, useLanguage as t } from "../../hooks/useLanguage.js";
+import { useText as n } from "../../hooks/useText.js";
+import { UploadError as r, discardFile as i, uploadCheckFailure as ee, uploadFailure as te, uploadFile as ne, validateClientSide as re } from "./upload.js";
+import { UploadFailureText as a } from "./UploadFailureText.js";
+import { getImageCropper as ie } from "./cropper.js";
+import { focalPointObjectPosition as o, preferredListThumbnailURL as s, preferredThumbnailVariant as ae, readFocalPoint as oe, resolveFileAltText as se, withFocalPoint as ce } from "./helpers.js";
+import { useDraftRegistration as le } from "./draft-scope.js";
+import { useEmbedFileSrc as ue } from "./useEmbedFileSrc.js";
+import { singleFileFromValue as de } from "./value.js";
+import { useCallback as c, useEffect as fe, useMemo as pe, useRef as l, useState as u } from "react";
+import { jsx as d, jsxs as f } from "react/jsx-runtime";
+//#region src/components/file-widgets/ImageWidget.tsx
+function me(e, t) {
+	return s(e, t);
+}
+function p(e) {
+	let t = e.trim().split(/\s+/).filter(Boolean);
+	return t.length === 1 ? t[0].slice(0, 2).toUpperCase() : (t[0][0] + t[1][0]).toUpperCase();
+}
+function m(s) {
+	let { field: p, fieldName: m, value: ve, onChange: v, mode: ye, alt: y, recordTitle: be, disabled: b, visual: x, uploadFieldCode: S, uploadSlotCode: C } = s, w = de(ve), [T, E] = u("idle"), [D, O] = u(null), [k, A] = u(null), [j, M] = u(null), [N, P] = u(!1), F = l(null), I = l(!1), L = l(null), { register: R, unregister: z, isDraft: B } = le(), V = n(), H = n("errors");
+	fe(() => () => {
+		F.current && F.current.abort();
+	}, []);
+	let U = t(), W = e(), G = pe(() => se(w, y, m, U, W), [
+		y,
+		m,
+		w,
+		U,
+		W
+	]), K = p.display?.initials ? be?.trim() : void 0, xe = (p.accepts ?? ["image/*"]).join(","), q = c(async (e) => {
+		let t = re(e, p.accepts, p.max_size_bytes);
+		if (t) {
+			A(ee(V, H, t)), E("error");
+			return;
+		}
+		let n = e;
+		if (p.display?.crop_on_upload) try {
+			let { blob: t, filename: r } = await ie()({
+				file: e,
+				aspectRatio: ge(p.display.aspect_ratio)
+			});
+			n = new File([t], r, { type: t.type || e.type });
+		} catch {
+			A({
+				code: "file.crop_failed",
+				message: H("file.crop_failed", "The image could not be cropped.")
+			}), E("error");
+			return;
+		}
+		A(null), I.current = !1, E("uploading"), O({
+			loaded: 0,
+			total: n.size,
+			pct: 0
+		});
+		let a = new AbortController();
+		F.current = a;
+		try {
+			let e = await ne({
+				file: n,
+				entityCode: s.entityCode,
+				fieldCode: S ?? m,
+				slotCode: C,
+				signal: a.signal,
+				onProgress: O
+			});
+			if (I.current) {
+				i(e.id).catch(() => {}), z(e.id);
+				return;
+			}
+			w && B(w.id) && (i(w.id).catch(() => {}), z(w.id)), R(e.id, () => i(e.id)), M(e.id), E("idle"), O(null);
+			let t = {
+				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
+			};
+			v?.(p.mode === "array" ? [t] : t);
+		} catch (e) {
+			if (e instanceof r && e.code === "ABORTED") return;
+			A(te(V, H, e)), E("error"), O(null);
+		}
+	}, [
+		H,
+		V,
+		p.accepts,
+		p.max_size_bytes,
+		p.display?.crop_on_upload,
+		p.display?.aspect_ratio,
+		p.mode,
+		m,
+		v,
+		s.entityCode,
+		R,
+		B,
+		w,
+		z,
+		S,
+		C
+	]), Se = c(() => {
+		T === "uploading" && F.current && (I.current = !0, F.current.abort(), F.current = null, E("idle"), O(null)), j && (i(j).catch(() => {}), z(j), M(null));
+	}, [
+		T,
+		j,
+		z
+	]), Ce = c(() => {
+		w && B(w.id) && (i(w.id).catch(() => {}), z(w.id), M(null)), v?.(p.mode === "array" ? [] : null);
+	}, [
+		w,
+		p.mode,
+		B,
+		v,
+		z
+	]), we = c(() => {
+		A(null), E("idle"), L.current?.click();
+	}, []), J = c(() => {
+		b || L.current?.click();
+	}, [b]), Te = c((e) => {
+		b || (e.key === "Enter" || e.key === " ") && (e.preventDefault(), J());
+	}, [b, J]), Ee = c((e) => {
+		b || (e.preventDefault(), e.dataTransfer.dropEffect = "copy");
+	}, [b]), Y = c((e) => {
+		if (b) return;
+		e.preventDefault();
+		let t = e.dataTransfer.files?.[0];
+		t && q(t);
+	}, [b, q]), De = c((e) => {
+		let t = e.target.files?.[0];
+		e.target.value = "", t && q(t);
+	}, [q]), Oe = x.aspectRatio ?? he(x.shape, p.display?.aspect_ratio), X = oe(w), Z = {
+		aspectRatio: Oe,
+		width: x.width ?? (x.shape === "wide" ? "100%" : "120px")
+	}, Q = !!w, ke = me(w, p.display?.listable_thumbnail), Ae = ae(w, p.display?.listable_thumbnail), $ = ue(w?.id, Ae, ke), je = ye === "display", Me = c((e) => {
+		e.stopPropagation(), P((e) => !e);
+	}, []), Ne = c((e) => {
+		if (!w || !N) return;
+		let t = e.currentTarget.getBoundingClientRect(), n = t.width > 0 ? (e.clientX - t.left) / t.width : .5, r = t.height > 0 ? (e.clientY - t.top) / t.height : .5, i = ce(w, {
+			x: Math.max(0, Math.min(1, n)),
+			y: Math.max(0, Math.min(1, r))
+		});
+		v?.(p.mode === "array" ? [i] : i), P(!1);
+	}, [
+		p.mode,
+		w,
+		N,
+		v
+	]);
+	return je ? /* @__PURE__ */ d("div", {
+		className: h(x.shape, !1),
+		style: Z,
+		"aria-label": G,
+		children: Q && $ ? /* @__PURE__ */ d("img", {
+			src: $,
+			alt: G,
+			className: g(x.shape),
+			style: { objectPosition: o(X) },
+			loading: "lazy"
+		}) : /* @__PURE__ */ d(_, {
+			shape: x.shape,
+			initialsTitle: K
+		})
+	}) : /* @__PURE__ */ f("div", {
+		className: h(x.shape, !b),
+		style: Z,
+		tabIndex: b ? -1 : 0,
+		role: "button",
+		"aria-label": G,
+		"aria-disabled": b || void 0,
+		"aria-busy": T === "uploading" || void 0,
+		"aria-invalid": T === "error" || void 0,
+		onClick: T === "idle" && !Q ? J : void 0,
+		onMouseDown: N ? Ne : void 0,
+		onKeyDown: Te,
+		onDragOver: Ee,
+		onDrop: Y,
+		"data-testid": N ? "focal-point-target" : `file-widget-${m}`,
+		children: [
+			/* @__PURE__ */ d("input", {
+				ref: L,
+				type: "file",
+				accept: xe,
+				onChange: De,
+				style: { display: "none" },
+				"data-testid": `file-input-${m}`
+			}),
+			Q && $ ? /* @__PURE__ */ d("img", {
+				src: $,
+				alt: G,
+				className: g(x.shape),
+				style: { objectPosition: o(X) },
+				loading: "lazy"
+			}) : T === "uploading" ? null : /* @__PURE__ */ d(_, {
+				shape: x.shape,
+				initialsTitle: K
+			}),
+			T === "uploading" && /* @__PURE__ */ d(_e, {
+				pct: D?.pct ?? 0,
+				label: V("file.upload.progress", "Uploading {pct}%", { pct: Math.round(D?.pct ?? 0) })
+			}),
+			j && /* @__PURE__ */ d("span", {
+				className: "absolute right-1 top-1 h-2 w-2 rounded-full bg-warning",
+				"aria-hidden": "true",
+				"data-testid": "draft-indicator"
+			}),
+			Q && T === "idle" && !b && /* @__PURE__ */ f("div", {
+				className: "absolute inset-0 flex items-center justify-center gap-2 bg-black/40 opacity-0 transition-opacity hover:opacity-100 focus-within:opacity-100",
+				children: [
+					p.display?.focal_point && /* @__PURE__ */ d("button", {
+						type: "button",
+						className: "rounded-sm border border-border bg-card px-2 py-1 text-xs text-foreground hover:bg-surface-2",
+						onClick: Me,
+						"data-testid": "focal-point-toggle",
+						children: N ? V("file.image.focus_cancel", "Cancel focus") : V("file.image.focus_set", "Set focus")
+					}),
+					/* @__PURE__ */ d("button", {
+						type: "button",
+						className: "rounded-sm border border-border bg-card px-2 py-1 text-xs text-foreground hover:bg-surface-2",
+						onClick: (e) => {
+							e.stopPropagation(), J();
+						},
+						children: V("file.image.change", "Change")
+					}),
+					/* @__PURE__ */ d("button", {
+						type: "button",
+						className: "rounded-sm border border-border bg-card px-2 py-1 text-xs text-destructive hover:bg-surface-2",
+						onClick: (e) => {
+							e.stopPropagation(), Ce();
+						},
+						children: V("file.remove", "Remove")
+					})
+				]
+			}),
+			X && Q && /* @__PURE__ */ d("span", {
+				className: "absolute h-3 w-3 -translate-x-1/2 -translate-y-1/2 rounded-full border border-white bg-black/70",
+				style: {
+					left: `${X.x * 100}%`,
+					top: `${X.y * 100}%`
+				},
+				"data-testid": "focal-point-marker"
+			}),
+			T === "uploading" && /* @__PURE__ */ d("button", {
+				type: "button",
+				className: "absolute bottom-1 right-1 rounded-sm border border-border bg-card px-2 py-0.5 text-xs",
+				onClick: (e) => {
+					e.stopPropagation(), Se();
+				},
+				"data-testid": "cancel-upload",
+				children: V("file.upload.cancel", "Cancel")
+			}),
+			T === "error" && k && /* @__PURE__ */ f("div", {
+				className: "absolute inset-x-0 bottom-0 flex items-center justify-between gap-2 bg-destructive-soft px-2 py-1 text-xs text-destructive",
+				role: "alert",
+				children: [/* @__PURE__ */ d("span", {
+					className: "truncate",
+					title: k.message,
+					children: /* @__PURE__ */ d(a, { failure: k })
+				}), /* @__PURE__ */ d("button", {
+					type: "button",
+					className: "underline",
+					onClick: (e) => {
+						e.stopPropagation(), we();
+					},
+					"data-testid": "retry-upload",
+					children: V("file.upload.retry", "Retry")
+				})]
+			})
+		]
+	});
+}
+function h(e, t) {
+	return [
+		"relative overflow-hidden border border-border bg-surface-2",
+		e === "circle" ? "rounded-full" : "rounded-md",
+		t ? "cursor-pointer focus-visible:outline focus-visible:outline-2 focus-visible:outline-accent" : ""
+	].filter(Boolean).join(" ");
+}
+function g(e) {
+	return "h-full w-full object-cover";
+}
+function he(e, t) {
+	return t ? t.replace(":", " / ") : e === "wide" ? "16 / 9" : "1 / 1";
+}
+function ge(e) {
+	if (!e) return;
+	let t = e.replace(/\s/g, "").match(/^(\d+(?:\.\d+)?)[:/](\d+(?:\.\d+)?)$/);
+	if (!t) return;
+	let n = Number(t[1]), r = Number(t[2]);
+	if (n && r) return n / r;
+}
+function _({ shape: e, initialsTitle: t }) {
+	let r = n();
+	return t ? /* @__PURE__ */ d("div", {
+		className: "flex h-full w-full items-center justify-center bg-surface-3 text-text-3",
+		children: /* @__PURE__ */ d("span", {
+			className: e === "circle" ? "text-lg font-medium" : "text-base font-medium",
+			children: p(t)
+		})
+	}) : /* @__PURE__ */ d("div", {
+		className: "flex h-full w-full items-center justify-center bg-surface-3 text-text-4",
+		children: /* @__PURE__ */ d("span", {
+			className: "text-xs",
+			children: e === "wide" ? r("file.image.drop", "Drop image here") : "+"
+		})
+	});
+}
+function _e({ pct: e, label: t }) {
+	let n = 2 * Math.PI * 18, r = n - Math.max(0, Math.min(100, e)) / 100 * n;
+	return /* @__PURE__ */ f("div", {
+		className: "absolute inset-0 flex items-center justify-center bg-black/30",
+		"data-testid": "upload-progress",
+		"aria-label": t,
+		role: "progressbar",
+		"aria-valuenow": Math.round(e),
+		"aria-valuemin": 0,
+		"aria-valuemax": 100,
+		children: [/* @__PURE__ */ f("svg", {
+			width: "48",
+			height: "48",
+			viewBox: "0 0 48 48",
+			children: [/* @__PURE__ */ d("circle", {
+				cx: "24",
+				cy: "24",
+				r: 18,
+				stroke: "currentColor",
+				strokeOpacity: "0.25",
+				strokeWidth: "4",
+				fill: "none",
+				className: "text-foreground"
+			}), /* @__PURE__ */ d("circle", {
+				cx: "24",
+				cy: "24",
+				r: 18,
+				stroke: "currentColor",
+				strokeWidth: "4",
+				fill: "none",
+				strokeDasharray: n,
+				strokeDashoffset: r,
+				strokeLinecap: "round",
+				className: "text-accent",
+				transform: "rotate(-90 24 24)"
+			})]
+		}), /* @__PURE__ */ f("span", {
+			className: "absolute text-xs text-foreground",
+			children: [Math.round(e), "%"]
+		})]
+	});
+}
+//#endregion
+export { m as ImageWidget };

package/dist-lib/components/file-widgets/LabeledSlots.js

@@ -0,0 +1,69 @@
+import { useText as e } from "../../hooks/useText.js";
+import { getFileWidget as t } from "./registry.js";
+import { UnknownFileWidget as n } from "./UnknownFileWidget.js";
+import { jsx as r, jsxs as i } from "react/jsx-runtime";
+//#region src/components/file-widgets/LabeledSlots.tsx
+function a(e) {
+	return !e || Array.isArray(e) || typeof e != "object" ? {} : e;
+}
+function o(e, t) {
+	return t?.content_type?.startsWith("image/") ? !0 : (e.accepts ?? []).some((e) => e === "image/*" || e.startsWith("image/"));
+}
+function s(e, t, n, r) {
+	return {
+		...e,
+		name: `${e.name}.${t}`,
+		mode: "single",
+		accepts: n.accepts ?? e.accepts,
+		max_size_bytes: n.max_size_bytes ?? e.max_size_bytes,
+		slots: void 0,
+		display: {
+			...e.display ?? { widget: "document_card" },
+			widget: o(n, r) ? "square_image" : "document_card",
+			aspect_ratio: n.aspect_ratio ?? e.display?.aspect_ratio
+		}
+	};
+}
+function c(o) {
+	let { field: c, fieldName: l, entityCode: u, value: d, recordTitle: f, onChange: p, mode: m, disabled: h } = o, g = Object.entries(c.slots ?? {}), _ = a(d), v = e();
+	return g.length === 0 ? /* @__PURE__ */ r("span", {
+		className: "text-sm text-muted-foreground",
+		children: v("file.slots.empty", "No slots configured")
+	}) : /* @__PURE__ */ r("div", {
+		className: "grid gap-3",
+		children: g.map(([e, a]) => {
+			let o = _[e] ?? null, d = s(c, e, a, o), g = d.display?.widget ?? "document_card", y = t(g);
+			return y ? /* @__PURE__ */ i("div", {
+				className: "grid gap-1.5",
+				children: [/* @__PURE__ */ r("div", {
+					className: "text-xs font-semibold text-text-2",
+					children: v(a.name)
+				}), /* @__PURE__ */ r(y, {
+					field: d,
+					fieldName: e,
+					entityCode: u,
+					value: o,
+					recordTitle: f,
+					mode: m,
+					disabled: h,
+					uploadFieldCode: l,
+					uploadSlotCode: e,
+					onChange: (t) => {
+						p && p({
+							..._,
+							[e]: t ?? null
+						});
+					}
+				})]
+			}, e) : /* @__PURE__ */ i("div", {
+				className: "grid gap-1.5",
+				children: [/* @__PURE__ */ r("div", {
+					className: "text-xs font-semibold text-text-2",
+					children: v(a.name)
+				}), /* @__PURE__ */ r(n, { widgetCode: g })]
+			}, e);
+		})
+	});
+}
+//#endregion
+export { c as LabeledSlots };

package/dist-lib/components/file-widgets/SquareImage.js

@@ -0,0 +1,11 @@
+import { ImageWidget as e } from "./ImageWidget.js";
+import { jsx as t } from "react/jsx-runtime";
+//#region src/components/file-widgets/SquareImage.tsx
+function n(n) {
+	return /* @__PURE__ */ t(e, {
+		...n,
+		visual: { shape: "square" }
+	});
+}
+//#endregion
+export { n as SquareImage };

package/dist-lib/components/file-widgets/UnknownFileWidget.js

@@ -0,0 +1,22 @@
+import { useText as e } from "../../hooks/useText.js";
+import { jsx as t, jsxs as n } from "react/jsx-runtime";
+//#region src/components/file-widgets/UnknownFileWidget.tsx
+function r({ widgetCode: r }) {
+	let i = e(), a = e("errors");
+	return r ? /* @__PURE__ */ n("span", {
+		className: "text-sm text-muted-foreground",
+		children: [
+			a("file.unknown_widget", "This file field names a widget this deployment does not have."),
+			" ",
+			/* @__PURE__ */ t("span", {
+				className: "opacity-80",
+				children: i("file.widget_code", "Widget: {widget}", { widget: r })
+			})
+		]
+	}) : /* @__PURE__ */ t("span", {
+		className: "text-sm text-muted-foreground",
+		children: a("file.missing_widget", "This file field does not name a widget to show it.")
+	});
+}
+//#endregion
+export { r as UnknownFileWidget };

package/dist-lib/components/file-widgets/UploadFailureText.js

@@ -0,0 +1,10 @@
+import { Fragment as e, jsx as t, jsxs as n } from "react/jsx-runtime";
+//#region src/components/file-widgets/UploadFailureText.tsx
+function r({ failure: r }) {
+	return /* @__PURE__ */ n(e, { children: [r.message, r.detail && /* @__PURE__ */ n(e, { children: [" ", /* @__PURE__ */ t("span", {
+		className: "opacity-80",
+		children: r.detail
+	})] })] });
+}
+//#endregion
+export { r as UploadFailureText };

package/dist-lib/components/file-widgets/WideBanner.js

@@ -0,0 +1,11 @@
+import { ImageWidget as e } from "./ImageWidget.js";
+import { jsx as t } from "react/jsx-runtime";
+//#region src/components/file-widgets/WideBanner.tsx
+function n(n) {
+	return /* @__PURE__ */ t(e, {
+		...n,
+		visual: { shape: "wide" }
+	});
+}
+//#endregion
+export { n as WideBanner };

package/dist-lib/components/file-widgets/builtins.js

@@ -0,0 +1,15 @@
+import { registerFileWidget as e } from "./registry.js";
+import { SquareImage as t } from "./SquareImage.js";
+import { CircleImage as n } from "./CircleImage.js";
+import { WideBanner as r } from "./WideBanner.js";
+import { GridLazy as i } from "./GridLazy.js";
+import { DocumentCard as a } from "./DocumentCard.js";
+import { FileList as o } from "./FileList.js";
+import { LabeledSlots as s } from "./LabeledSlots.js";
+//#region src/components/file-widgets/builtins.ts
+var c = !1;
+function l() {
+	c ||= (e("square_image", t), e("circle_image", n), e("wide_banner", r), e("grid", i), e("document_card", a), e("file_list", o), e("labeled_slots", s), !0);
+}
+//#endregion
+export { l as registerBuiltinFileWidgets };

package/dist-lib/components/file-widgets/cropper.js

@@ -0,0 +1,13 @@
+//#region src/components/file-widgets/cropper.ts
+var e = ({ file: e }) => Promise.resolve({
+	blob: e,
+	filename: e.name
+}), t = e;
+function n(n) {
+	t = n ?? e;
+}
+function r() {
+	return t;
+}
+//#endregion
+export { r as getImageCropper, n as setImageCropper };

package/dist-lib/components/file-widgets/draft-scope.js

@@ -0,0 +1,59 @@
+import { createContext as e, useCallback as t, useContext as n, useMemo as r, useRef as i } from "react";
+import { jsx as a } from "react/jsx-runtime";
+//#region src/components/file-widgets/draft-scope.tsx
+var o = e({
+	registerDraft() {},
+	unregisterDraft() {},
+	hasDraft() {
+		return !1;
+	},
+	flushAllDrafts: async () => {},
+	markCommitted() {}
+});
+function s({ children: e }) {
+	let t = i(/* @__PURE__ */ new Map()), n = r(() => ({
+		registerDraft(e) {
+			t.current.set(e.fileId, e);
+		},
+		unregisterDraft(e) {
+			t.current.delete(e);
+		},
+		hasDraft(e) {
+			return t.current.has(e);
+		},
+		markCommitted(e) {
+			t.current.delete(e);
+		},
+		async flushAllDrafts() {
+			let e = Array.from(t.current.values());
+			t.current.clear(), await Promise.allSettled(e.map((e) => Promise.resolve(e.discard())));
+		}
+	}), []);
+	return /* @__PURE__ */ a(o.Provider, {
+		value: n,
+		children: e
+	});
+}
+function c() {
+	return n(o);
+}
+function l() {
+	let e = c();
+	return {
+		register: t((t, n) => {
+			e.registerDraft({
+				fileId: t,
+				discard: n
+			});
+		}, [e]),
+		unregister: t((t) => {
+			e.unregisterDraft(t);
+		}, [e]),
+		markCommitted: t((t) => {
+			e.markCommitted(t);
+		}, [e]),
+		isDraft: t((t) => e.hasDraft(t), [e])
+	};
+}
+//#endregion
+export { s as FileDraftScope, l as useDraftRegistration, c as useFileDraftScope };

package/dist-lib/components/file-widgets/helpers.js

@@ -0,0 +1,75 @@
+import { pickLocalized as e } from "../../lib/language.js";
+//#region src/components/file-widgets/helpers.ts
+var t = ["thumb_200", "thumb_300"];
+function n(t, n, r, i, a) {
+	if (n) return n;
+	let o = t?.metadata?.alt_text;
+	if (typeof o == "string" && o.length > 0) return o;
+	if (o && typeof o == "object" && !Array.isArray(o)) {
+		let t = Object.fromEntries(Object.entries(o).filter((e) => e[0].length > 0 && typeof e[1] == "string")), n = e(t, i, a);
+		if (n) return n;
+	}
+	return r;
+}
+var r = /* @__PURE__ */ new Set([
+	"image/png",
+	"image/jpeg",
+	"image/webp",
+	"image/gif",
+	"image/avif",
+	"application/pdf"
+]);
+function i(e) {
+	let t = e.content_type?.toLowerCase().split(";")[0]?.trim() ?? "";
+	return r.has(t);
+}
+function a(e) {
+	return e.url ?? e.presigned_url;
+}
+function o(e) {
+	return e.url ? l(e.url, "attachment") : e.presigned_url;
+}
+function s(e, n) {
+	if (!e) return;
+	let r = e.derivations ?? {};
+	if (n && r[n]) return r[n];
+	for (let e of t) if (r[e]) return r[e];
+	return e.url ?? e.presigned_url;
+}
+function c(e, n) {
+	let r = e?.derivations ?? {};
+	if (n && r[n]) return { derivation: n };
+	for (let e of t) if (r[e]) return { derivation: e };
+	return "preview";
+}
+function l(e, t) {
+	try {
+		let n = new URL(e, typeof window < "u" ? window.location.origin : "http://localhost");
+		return n.searchParams.set("disposition", t), /^https?:\/\//i.test(e) ? n.toString() : `${n.pathname}${n.search}${n.hash}`;
+	} catch {
+		return `${e}${e.includes("?") ? "&" : "?"}disposition=${t}`;
+	}
+}
+function u(e) {
+	let t = e?.metadata?.focal_point;
+	if (!t || typeof t != "object" || Array.isArray(t)) return null;
+	let n = t, r = typeof n.x == "number" ? n.x : NaN, i = typeof n.y == "number" ? n.y : NaN;
+	return !Number.isFinite(r) || !Number.isFinite(i) || r < 0 || r > 1 || i < 0 || i > 1 ? null : {
+		x: r,
+		y: i
+	};
+}
+function d(e) {
+	if (e) return `${e.x * 100}% ${e.y * 100}%`;
+}
+function f(e, t) {
+	return {
+		...e,
+		metadata: {
+			...e.metadata ?? {},
+			focal_point: t
+		}
+	};
+}
+//#endregion
+export { i as canPreviewFile, o as downloadFileURL, d as focalPointObjectPosition, s as preferredListThumbnailURL, c as preferredThumbnailVariant, a as previewFileURL, u as readFocalPoint, n as resolveFileAltText, f as withFocalPoint };