@openrails/contentkit-ui 0.85.1 → 0.86.0

package/dist/react/canonical.js

@@ -20,56 +20,57 @@ var s = (e, t, n) => ({
 	value: t
 });
 function c(c, l = {}) {
-	let u = t(), d = n(e)?.navigate, f = l.location ?? (typeof location > "u" ? "" : location.pathname + location.search + location.hash), p = c?.content_kind, m = c?.code, h = c?.slug, g = JSON.stringify(c?.slugs ?? {}), _ = l.languages?.join(","), v = i(() => p && m ? {
-		content_kind: p,
-		code: m,
-		slug: h ?? "",
-		slugs: JSON.parse(g)
+	let u = t(), d = n(e), f = d?.navigate, p = d?.language, m = l.location ?? (typeof location > "u" ? "" : location.pathname + location.search + location.hash), h = c?.content_kind, g = c?.code, _ = c?.slug, v = JSON.stringify(c?.slugs ?? {}), y = l.languages?.join(","), b = i(() => h && g ? {
+		content_kind: h,
+		code: g,
+		slug: _ ?? "",
+		slugs: JSON.parse(v)
 	} : null, [
-		p,
-		m,
 		h,
-		g
-	]), y = i(() => {
-		if (!v) return { alternates: {} };
-		let e = u.origin ?? (typeof location > "u" ? void 0 : location.origin), t = f.includes("#") ? f.slice(f.indexOf("#")) : "", n = u.canonical(f, v), r = n?.path ?? u.path(v), i = e ? u.hreflang(v, {
+		g,
+		_,
+		v
+	]), x = i(() => {
+		if (!b) return { alternates: {} };
+		let e = u.origin ?? (typeof location > "u" ? void 0 : location.origin), t = m.includes("#") ? m.slice(m.indexOf("#")) : "", n = p && u.languages.includes(p) ? p : void 0, r = u.canonical(m, b, { language: n }), i = r?.path ?? u.path(b, { language: n }), a = e ? u.hreflang(b, {
 			origin: e,
-			languages: _?.split(","),
+			languages: y?.split(","),
 			defaultLanguage: l.defaultLanguage
 		}) : {};
 		return {
-			path: r,
-			url: e ? e + r : void 0,
-			alternates: i,
-			redirect: n?.redirect ? n.location + t : void 0
+			path: i,
+			url: e ? e + i : void 0,
+			alternates: a,
+			redirect: r?.redirect ? r.location + t : void 0
 		};
 	}, [
-		v,
-		f,
+		b,
+		m,
 		u,
-		_,
+		p,
+		y,
 		l.defaultLanguage
-	]), { redirect: b } = y;
+	]), { redirect: S } = x;
 	r(() => {
-		b && (d ? d(b, { replace: !0 }) : history.replaceState(history.state, "", b));
-	}, [b, d]);
-	let { url: x, alternates: S } = y, { title: C, image: w } = l, T = JSON.stringify(S);
+		S && (f ? f(S, { replace: !0 }) : history.replaceState(history.state, "", S));
+	}, [S, f]);
+	let { url: C, alternates: w } = x, { title: T, image: E } = l, D = JSON.stringify(w);
 	return r(() => {
-		if (!x || typeof document > "u") return;
-		let e = [s("canonical", x), a("og:url", x)];
-		C && e.push(a("og:title", C)), w && e.push(a("og:image", w));
-		for (let [t, n] of Object.entries(JSON.parse(T))) e.push(s("alternate", n, t));
+		if (!C || typeof document > "u") return;
+		let e = [s("canonical", C), a("og:url", C)];
+		T && e.push(a("og:title", T)), E && e.push(a("og:image", E));
+		for (let [t, n] of Object.entries(JSON.parse(D))) e.push(s("alternate", n, t));
 		let t = e.map((e) => o(document.head.querySelector(e.selector) ?? document.head.appendChild(e.create()), e.attr, e.value));
 		return () => t.forEach((e) => e.remove());
 	}, [
-		x,
 		C,
-		w,
-		T
+		T,
+		E,
+		D
 	]), {
-		path: y.path,
-		url: y.url,
-		alternates: y.alternates
+		path: x.path,
+		url: x.url,
+		alternates: x.alternates
 	};
 }
 //#endregion

package/dist/react/canonical.js.map

@@ -1 +1 @@
-{"version":3,"file":"canonical.js","names":[],"sources":["../../src/react/canonical.ts"],"sourcesContent":["import { useContext, useEffect, useMemo } from \"react\";\nimport type { ContentLink } from \"../urls/index.js\";\nimport { ContentKitContext, useContentURLs } from \"./context.js\";\n\nexport interface CanonicalContentOptions {\n  /** og:title. */\n  title?: string;\n  /** og:image, an absolute URL. */\n  image?: string;\n  /**\n   * The current location (pathname, search, hash). Default\n   * window.location; pass the router's so a navigation checks again.\n   */\n  location?: string;\n  /** Languages the content exists in, for hreflang; default every configured language. */\n  languages?: readonly string[];\n  /** The language hreflang x-default points at. */\n  defaultLanguage?: string;\n}\n\nexport interface CanonicalContent {\n  /** The canonical path in the page's language; undefined until link arrives. */\n  path?: string;\n  /** Its absolute URL. */\n  url?: string;\n  /** hreflang alternates by language (and x-default). */\n  alternates: Record<string, string>;\n}\n\ntype Tag = { selector: string; create: () => HTMLElement; attr: string; value: string };\n\nconst meta = (property: string, value: string): Tag => ({\n  selector: `meta[property=\"${property}\"]`,\n  create: () => withAttr(document.createElement(\"meta\"), \"property\", property),\n  attr: \"content\",\n  value,\n});\n\nfunction withAttr<E extends HTMLElement>(el: E, name: string, value: string): E {\n  el.setAttribute(name, value);\n  return el;\n}\n\nconst link = (rel: string, value: string, hreflang?: string): Tag => ({\n  selector: hreflang ? `link[rel=\"${rel}\"][hreflang=\"${hreflang}\"]` : `link[rel=\"${rel}\"]:not([hreflang])`,\n  create: () => {\n    const el = withAttr(document.createElement(\"link\"), \"rel\", rel);\n    if (hreflang) el.setAttribute(\"hreflang\", hreflang);\n    return el;\n  },\n  attr: \"href\",\n  value,\n});\n\n/**\n * A content page's canonical URL once its data (link) arrives: replaces the\n * address with the canonical path (code spelling, merged code, current slug)\n * through the provider's navigate (else history.replaceState), and keeps\n * `<link rel=canonical>`, og:url, og:title, og:image and hreflang alternates\n * (each language's own slug) in the head while mounted; unmounting removes\n * the tags it set, server-rendered ones included. Needs the provider's `urls`.\n */\nexport function useCanonicalContent(content: ContentLink | null | undefined, o: CanonicalContentOptions = {}): CanonicalContent {\n  const urls = useContentURLs();\n  const navigate = useContext(ContentKitContext)?.navigate;\n  const at = o.location ?? (typeof location === \"undefined\" ? \"\" : location.pathname + location.search + location.hash);\n  const kind = content?.content_kind;\n  const code = content?.code;\n  const slug = content?.slug;\n  const slugs = JSON.stringify(content?.slugs ?? {});\n  const languages = o.languages?.join(\",\");\n  const lnk = useMemo(\n    () => (kind && code ? ({ content_kind: kind, code, slug: slug ?? \"\", slugs: JSON.parse(slugs) as Record<string, string> } satisfies ContentLink) : null),\n    [kind, code, slug, slugs],\n  );\n\n  const result = useMemo((): CanonicalContent & { redirect?: string } => {\n    if (!lnk) return { alternates: {} };\n    const origin = urls.origin ?? (typeof location === \"undefined\" ? undefined : location.origin);\n    const hash = at.includes(\"#\") ? at.slice(at.indexOf(\"#\")) : \"\";\n    const c = urls.canonical(at, lnk);\n    const path = c?.path ?? urls.path(lnk);\n    const alternates = origin ? urls.hreflang(lnk, { origin, languages: languages?.split(\",\"), defaultLanguage: o.defaultLanguage }) : {};\n    return { path, url: origin ? origin + path : undefined, alternates, redirect: c?.redirect ? c.location + hash : undefined };\n  }, [lnk, at, urls, languages, o.defaultLanguage]);\n\n  const { redirect } = result;\n  useEffect(() => {\n    if (!redirect) return;\n    if (navigate) navigate(redirect, { replace: true });\n    else history.replaceState(history.state, \"\", redirect);\n  }, [redirect, navigate]);\n\n  const { url, alternates } = result;\n  const { title, image } = o;\n  const alternatesKey = JSON.stringify(alternates);\n  useEffect(() => {\n    if (!url || typeof document === \"undefined\") return;\n    const tags: Tag[] = [link(\"canonical\", url), meta(\"og:url\", url)];\n    if (title) tags.push(meta(\"og:title\", title));\n    if (image) tags.push(meta(\"og:image\", image));\n    for (const [lang, href] of Object.entries(JSON.parse(alternatesKey) as Record<string, string>)) tags.push(link(\"alternate\", href, lang));\n    const set = tags.map((t) => withAttr(document.head.querySelector<HTMLElement>(t.selector) ?? document.head.appendChild(t.create()), t.attr, t.value));\n    // The tags describe this page: leaving it removes them, server-rendered ones\n    // included (restoring those would leave this page's values on the next).\n    return () => set.forEach((el) => el.remove());\n  }, [url, title, image, alternatesKey]);\n\n  return { path: result.path, url: result.url, alternates: result.alternates };\n}\n"],"mappings":"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"}
+{"version":3,"file":"canonical.js","names":[],"sources":["../../src/react/canonical.ts"],"sourcesContent":["import { useContext, useEffect, useMemo } from \"react\";\nimport type { ContentLink } from \"../urls/index.js\";\nimport { ContentKitContext, useContentURLs } from \"./context.js\";\n\nexport interface CanonicalContentOptions {\n  /** og:title. */\n  title?: string;\n  /** og:image, an absolute URL. */\n  image?: string;\n  /**\n   * The current location (pathname, search, hash). Default\n   * window.location; pass the router's so a navigation checks again.\n   */\n  location?: string;\n  /** Languages the content exists in, for hreflang; default every configured language. */\n  languages?: readonly string[];\n  /** The language hreflang x-default points at. */\n  defaultLanguage?: string;\n}\n\nexport interface CanonicalContent {\n  /** The canonical path in the page's language, never a version's (?v=); undefined until link arrives. */\n  path?: string;\n  /** Its absolute URL. */\n  url?: string;\n  /** hreflang alternates by language (and x-default). */\n  alternates: Record<string, string>;\n}\n\ntype Tag = { selector: string; create: () => HTMLElement; attr: string; value: string };\n\nconst meta = (property: string, value: string): Tag => ({\n  selector: `meta[property=\"${property}\"]`,\n  create: () => withAttr(document.createElement(\"meta\"), \"property\", property),\n  attr: \"content\",\n  value,\n});\n\nfunction withAttr<E extends HTMLElement>(el: E, name: string, value: string): E {\n  el.setAttribute(name, value);\n  return el;\n}\n\nconst link = (rel: string, value: string, hreflang?: string): Tag => ({\n  selector: hreflang ? `link[rel=\"${rel}\"][hreflang=\"${hreflang}\"]` : `link[rel=\"${rel}\"]:not([hreflang])`,\n  create: () => {\n    const el = withAttr(document.createElement(\"link\"), \"rel\", rel);\n    if (hreflang) el.setAttribute(\"hreflang\", hreflang);\n    return el;\n  },\n  attr: \"href\",\n  value,\n});\n\n/**\n * A content page's canonical URL once its data (link) arrives: replaces the\n * address with the canonical path (language prefix, the reader's when the\n * address has none; code spelling, merged code, current slug; the query, ?v=\n * included, kept) through the provider's navigate (else history.replaceState), and keeps\n * `<link rel=canonical>`, og:url, og:title, og:image and hreflang alternates\n * (each language's own slug) in the head while mounted; unmounting removes\n * the tags it set, server-rendered ones included. Needs the provider's `urls`.\n */\nexport function useCanonicalContent(content: ContentLink | null | undefined, o: CanonicalContentOptions = {}): CanonicalContent {\n  const urls = useContentURLs();\n  const ctx = useContext(ContentKitContext);\n  const navigate = ctx?.navigate;\n  const reader = ctx?.language;\n  const at = o.location ?? (typeof location === \"undefined\" ? \"\" : location.pathname + location.search + location.hash);\n  const kind = content?.content_kind;\n  const code = content?.code;\n  const slug = content?.slug;\n  const slugs = JSON.stringify(content?.slugs ?? {});\n  const languages = o.languages?.join(\",\");\n  const lnk = useMemo(\n    () => (kind && code ? ({ content_kind: kind, code, slug: slug ?? \"\", slugs: JSON.parse(slugs) as Record<string, string> } satisfies ContentLink) : null),\n    [kind, code, slug, slugs],\n  );\n\n  const result = useMemo((): CanonicalContent & { redirect?: string } => {\n    if (!lnk) return { alternates: {} };\n    const origin = urls.origin ?? (typeof location === \"undefined\" ? undefined : location.origin);\n    const hash = at.includes(\"#\") ? at.slice(at.indexOf(\"#\")) : \"\";\n    const language = reader && urls.languages.includes(reader) ? reader : undefined;\n    const c = urls.canonical(at, lnk, { language });\n    const path = c?.path ?? urls.path(lnk, { language });\n    const alternates = origin ? urls.hreflang(lnk, { origin, languages: languages?.split(\",\"), defaultLanguage: o.defaultLanguage }) : {};\n    return { path, url: origin ? origin + path : undefined, alternates, redirect: c?.redirect ? c.location + hash : undefined };\n  }, [lnk, at, urls, reader, languages, o.defaultLanguage]);\n\n  const { redirect } = result;\n  useEffect(() => {\n    if (!redirect) return;\n    if (navigate) navigate(redirect, { replace: true });\n    else history.replaceState(history.state, \"\", redirect);\n  }, [redirect, navigate]);\n\n  const { url, alternates } = result;\n  const { title, image } = o;\n  const alternatesKey = JSON.stringify(alternates);\n  useEffect(() => {\n    if (!url || typeof document === \"undefined\") return;\n    const tags: Tag[] = [link(\"canonical\", url), meta(\"og:url\", url)];\n    if (title) tags.push(meta(\"og:title\", title));\n    if (image) tags.push(meta(\"og:image\", image));\n    for (const [lang, href] of Object.entries(JSON.parse(alternatesKey) as Record<string, string>)) tags.push(link(\"alternate\", href, lang));\n    const set = tags.map((t) => withAttr(document.head.querySelector<HTMLElement>(t.selector) ?? document.head.appendChild(t.create()), t.attr, t.value));\n    // The tags describe this page: leaving it removes them, server-rendered ones\n    // included (restoring those would leave this page's values on the next).\n    return () => set.forEach((el) => el.remove());\n  }, [url, title, image, alternatesKey]);\n\n  return { path: result.path, url: result.url, alternates: result.alternates };\n}\n"],"mappings":"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"}

package/dist/react/contents.js

@@ -1,214 +1,214 @@
 import { useGuarded as e } from "./context.js";
-import { useMediaRead as t } from "./read.js";
-import { keyOf as n, offsetPages as r, useContentScope as i, useList as a, useResource as o } from "./use-resource.js";
+import { keyOf as t, offsetPages as n, useContentScope as r, useList as i, useResource as a } from "./use-resource.js";
+import { useMediaRead as o } from "./read.js";
 import { BODY_SUFFIX as s, IMAGE_SCHEME as c, imageRef as l, imageRefs as u } from "../client/contents.js";
 import { useCallback as d, useEffect as f, useMemo as p, useRef as m, useState as h } from "react";
 //#region src/react/contents.ts
-function g(e = {}, t = {}) {
-	let { client: o, store: s, scope: c } = i(t.client), { pageSize: l, ...u } = e, d = l ?? 20;
-	return a(s, n("contents", c, u.kind, u.state, u.owner_group, u.q, u.language, d), {
+function g(e = {}, a = {}) {
+	let { client: o, store: s, scope: c } = r(a.client), { pageSize: l, ...u } = e, d = l ?? 20;
+	return i(s, t("contents", c, u.kind, u.state, u.owner_group, u.q, u.language, d), {
 		type: "contents",
 		scope: u.state === "deleted" ? "deleted" : void 0
-	}, r(d, (e, t) => o.contents.manage({
+	}, n(d, (e, t) => o.contents.manage({
 		...u,
 		...e
 	}, t)));
 }
-var _ = (e) => [...new Set([...(e ?? "").matchAll(u())].map((e) => e[1]))], v = (e) => {
+var ee = (e) => [...new Set([...(e ?? "").matchAll(u())].map((e) => e[1]))], _ = (e) => {
 	let t = e.slice(e.lastIndexOf("/") + 1), n = t.lastIndexOf(".");
 	return n > 0 ? t.slice(0, n) : t;
 };
-function y(r, a, g, y = {}) {
-	let { client: b, store: ee, scope: x } = i(y.client), [te, ne] = h(null), S = r ?? te, C = S ? n("content", x, S) : null, w = o(ee, C, {
+function v(n, i, g, v = {}) {
+	let { client: y, store: te, scope: ne } = r(v.client), [b, re] = h(null), x = n ?? b, S = x ? t("content", ne, x) : null, C = a(te, S, {
 		type: "content",
-		id: S ?? void 0
-	}, (e) => b.contents.get(S, g, e), { initial: y.initial }), T = w.data ?? null, [re, E] = h(0), D = e(), O = d(async (e) => {
-		E((e) => e + 1);
+		id: x ?? void 0
+	}, (e) => y.contents.get(x, g, e), { initial: v.initial }), w = C.data ?? null, [ie, T] = h(0), E = e(), D = d(async (e) => {
+		T((e) => e + 1);
 		try {
-			return await D(e);
+			return await E(e);
 		} finally {
-			E((e) => e - 1);
+			T((e) => e - 1);
 		}
-	}, [D]), k = d(() => {
-		if (!S) throw Error("contentkit-ui: create the item first");
-		return S;
-	}, [S]), A = T?.text?.[g], j = A?.body, M = T?.cover, [N, ie] = h(/* @__PURE__ */ new Map()), P = m([]);
+	}, [E]), O = d(() => {
+		if (!x) throw Error("contentkit-ui: create the item first");
+		return x;
+	}, [x]), k = w?.text?.[g], A = k?.body, j = w?.cover, [M, ae] = h(/* @__PURE__ */ new Map()), N = m([]);
 	f(() => {
-		let e = P.current;
+		let e = N.current;
 		return () => {
 			for (let t of e) URL.revokeObjectURL(t);
 		};
 	}, []);
-	let F = p(() => new Map(Object.entries(T?.images ?? {})), [T?.images]), I = !!M && !M.url && !N.has(M.image) && !F.has(M.image), L = p(() => _(j).filter((e) => !N.has(e) && !F.has(e)), [
-		j,
-		N,
-		F
-	]), R = p(() => I ? [...L, M.image] : L, [
+	let P = p(() => new Map(Object.entries(w?.images ?? {})), [w?.images]), F = !!j && !j.url && !M.has(j.image) && !P.has(j.image), I = p(() => ee(A).filter((e) => !M.has(e) && !P.has(e)), [
+		A,
+		M,
+		P
+	]), L = p(() => F ? [...I, j.image] : I, [
+		F,
 		I,
-		L,
-		M
-	]), z = p(() => ({
-		kind: a,
-		id: S ?? "none"
-	}), [a, S]), B = p(() => ({
-		kind: a + s,
-		id: S ?? "none"
-	}), [a, S]), V = t(z, {
+		j
+	]), R = p(() => ({
+		kind: i,
+		id: x ?? "none"
+	}), [i, x]), oe = p(() => ({
+		kind: i + s,
+		id: x ?? "none"
+	}), [i, x]), z = o(R, {
 		editor: !0,
-		read: I ? void 0 : null,
-		client: b
-	}), H = t(B, {
+		read: F ? void 0 : null,
+		client: y
+	}), B = o(oe, {
 		editor: !0,
-		read: L.length ? void 0 : null,
-		client: b
-	}), U = p(() => [...V.read?.files ?? [], ...H.read?.files ?? []], [V.read, H.read]), W = p(() => {
+		read: I.length ? void 0 : null,
+		client: y
+	}), V = p(() => [...z.read?.files ?? [], ...B.read?.files ?? []], [z.read, B.read]), H = p(() => {
 		let e = /* @__PURE__ */ new Map();
-		for (let t of U) t.upload && t.editor_url && e.set(v(t.path), t.editor_url);
+		for (let t of V) t.upload && t.editor_url && e.set(_(t.path), t.editor_url);
 		return e;
-	}, [U]), ae = (e) => U.some((t) => t.failed && v(t.path) === e), G = (!!V.read || !!H.read) && R.some((e) => !W.has(e) && !ae(e)), K = m(0), q = V.reload, J = H.reload, Y = d(() => {
-		q(), J();
-	}, [q, J]);
+	}, [V]), U = (e) => V.some((t) => t.failed && _(t.path) === e), W = (!!z.read || !!B.read) && L.some((e) => !H.has(e) && !U(e)), G = m(0), K = z.reload, q = B.reload, J = d(() => {
+		K(), q();
+	}, [K, q]);
 	f(() => {
-		if (!G) {
-			K.current = 0;
+		if (!W) {
+			G.current = 0;
 			return;
 		}
-		if (K.current >= 6) return;
+		if (G.current >= 6) return;
 		let e = setTimeout(() => {
-			K.current++, Y();
-		}, 1e3 * 2 ** K.current);
+			G.current++, J();
+		}, 1e3 * 2 ** G.current);
 		return () => clearTimeout(e);
 	}, [
-		G,
-		U,
-		Y
+		W,
+		V,
+		J
 	]);
-	let X = m(/* @__PURE__ */ new Map());
+	let Y = m(/* @__PURE__ */ new Map());
 	f(() => {
 		for (let e of [
-			N,
-			F,
-			W
-		]) for (let [t, n] of e) X.current.set(n, t);
+			M,
+			P,
+			H
+		]) for (let [t, n] of e) Y.current.set(n, t);
 	}, [
-		N,
-		F,
-		W
+		M,
+		P,
+		H
 	]);
-	let Z = d((e) => {
+	let X = d((e) => {
 		if (!e) return;
 		let t = e.startsWith("contentkit:") ? e.slice(c.length) : e;
-		return N.get(t) ?? F.get(t) ?? W.get(t) ?? e;
+		return M.get(t) ?? P.get(t) ?? H.get(t) ?? e;
 	}, [
-		N,
-		F,
-		W
-	]), oe = p(() => A ? {
-		...A,
-		body: (A.body ?? "").replace(u(), (e, t) => N.get(t) ?? F.get(t) ?? W.get(t) ?? e)
+		M,
+		P,
+		H
+	]), se = p(() => k ? {
+		...k,
+		body: (k.body ?? "").replace(u(), (e, t) => M.get(t) ?? P.get(t) ?? H.get(t) ?? e)
 	} : void 0, [
-		A,
-		N,
-		F,
-		W
-	]), Q = d((e) => {
-		let t = new Map(X.current);
+		k,
+		M,
+		P,
+		H
+	]), Z = d((e) => {
+		let t = new Map(Y.current);
 		for (let e of [
-			N,
-			F,
-			W
+			M,
+			P,
+			H
 		]) for (let [n, r] of e) t.set(r, n);
 		let n = e;
 		for (let [e, r] of t) n = n.split(e).join(l(r)).split(e.replaceAll("&", "&")).join(l(r));
 		return n;
 	}, [
-		N,
-		F,
-		W
-	]), $ = d((e, t) => {
+		M,
+		P,
+		H
+	]), Q = d((e, t) => {
 		if (typeof URL.createObjectURL != "function") return;
 		let n = URL.createObjectURL(t);
-		return P.current.push(n), ie((t) => new Map(t).set(e, n)), n;
-	}, []), se = d((e) => O(async () => {
-		let t = await b.contents.create(e);
-		return ne(t.id), t;
-	}), [b, O]), ce = d((e) => O(() => b.contents.update(k(), e)), [
-		b,
-		O,
-		k
-	]), le = d((e) => O(() => b.contents.putText(k(), g, e.body === void 0 ? e : {
+		return N.current.push(n), ae((t) => new Map(t).set(e, n)), n;
+	}, []), ce = d((e) => D(async () => {
+		let t = await y.contents.create(e);
+		return re(t.id), t;
+	}), [y, D]), le = d((e) => D(() => y.contents.update(O(), e)), [
+		y,
+		D,
+		O
+	]), ue = d((e) => D(() => y.contents.putText(O(), g, e.body === void 0 ? e : {
 		...e,
-		body: Q(e.body)
+		body: Z(e.body)
 	})), [
-		b,
+		y,
+		D,
 		O,
-		k,
 		g,
-		Q
-	]), ue = d((e) => O(() => b.contents.publish(k(), e)), [
-		b,
-		O,
-		k
-	]), de = d(() => O(() => b.contents.unpublish(k())), [
-		b,
-		O,
-		k
-	]), fe = d(() => O(() => b.contents.remove(k())), [
-		b,
-		O,
-		k
-	]), pe = d(() => O(() => b.contents.restore(k())), [
-		b,
-		O,
-		k
-	]), me = d((e) => O(async () => {
-		if (!e) return await b.contents.setCover(k(), null), null;
-		let t = await b.media.uploadNamed({
-			kind: a,
-			id: k()
-		}, e), n = await b.contents.setCover(k(), t.name), r = $(t.name, e) ?? n.cover?.url ?? null;
-		return r && X.current.set(r, t.name), r;
+		Z
+	]), $ = d((e) => D(() => y.contents.publish(O(), e)), [
+		y,
+		D,
+		O
+	]), de = d(() => D(() => y.contents.unpublish(O())), [
+		y,
+		D,
+		O
+	]), fe = d(() => D(() => y.contents.remove(O())), [
+		y,
+		D,
+		O
+	]), pe = d(() => D(() => y.contents.restore(O())), [
+		y,
+		D,
+		O
+	]), me = d((e) => D(async () => {
+		if (!e) return await y.contents.setCover(O(), null), null;
+		let t = await y.media.uploadNamed({
+			kind: i,
+			id: O()
+		}, e), n = await y.contents.setCover(O(), t.name), r = Q(t.name, e) ?? n.cover?.url ?? null;
+		return r && Y.current.set(r, t.name), r;
 	}), [
-		b,
+		y,
+		D,
 		O,
-		k,
-		a,
-		$
-	]), he = d((e) => O(async () => {
-		let t = await b.media.uploadInline({
-			kind: a + s,
-			id: k()
-		}, e), n = $(t.name, e) ?? t.url ?? t.ref;
-		return X.current.set(n, t.name), n;
+		i,
+		Q
+	]), he = d((e) => D(async () => {
+		let t = await y.media.uploadInline({
+			kind: i + s,
+			id: O()
+		}, e), n = Q(t.name, e) ?? t.url ?? t.ref;
+		return Y.current.set(n, t.name), n;
 	}), [
-		b,
+		y,
+		D,
 		O,
-		k,
-		a,
-		$
+		i,
+		Q
 	]);
 	return {
-		content: T,
-		reload: w.reload,
-		loading: !!C && (w.loading || !w.loaded && y.initial === void 0),
-		error: w.error,
-		saving: re > 0,
-		create: se,
-		update: ce,
-		putText: le,
-		publish: ue,
+		content: w,
+		reload: C.reload,
+		loading: !!S && (C.loading || !C.loaded && v.initial === void 0),
+		error: C.error,
+		saving: ie > 0,
+		create: ce,
+		update: le,
+		putText: ue,
+		publish: $,
 		unpublish: de,
 		remove: fe,
 		restore: pe,
 		setCover: me,
 		uploadImage: he,
-		imageSrc: Z,
-		coverSrc: Z(M?.image),
-		text: oe,
-		storedBody: Q
+		imageSrc: X,
+		coverSrc: X(j?.image),
+		text: se,
+		storedBody: Z
 	};
 }
 //#endregion
-export { y as useContent, g as useManagedContents };
+export { v as useContent, g as useManagedContents };
 
 //# sourceMappingURL=contents.js.map

package/dist/react/contents.js.map

@@ -1 +1 @@
-{"version":3,"file":"contents.js","names":[],"sources":["../../src/react/contents.ts"],"sourcesContent":["import { useCallback, useEffect, useMemo, useRef, useState } from \"react\";\nimport type { ContentKitClient } from \"../client/client.js\";\nimport type { ContentKitError } from \"../client/errors.js\";\nimport type { CatalogText, Content, ContentInput, ContentPatch } from \"../client/generated/wire.js\";\nimport { BODY_SUFFIX, IMAGE_SCHEME, imageRef, imageRefs, type ManageQuery } from \"../client/contents.js\";\nimport { useMediaRead } from \"./read.js\";\nimport { useGuarded } from \"./context.js\";\nimport { keyOf, offsetPages, useContentScope, useList, useResource, type UseList } from \"./use-resource.js\";\n\nexport interface ManageFilter extends Omit<ManageQuery, \"limit\" | \"offset\"> {\n  pageSize?: number;\n}\n\n/** The content items the caller manages, newest first, a page at a time. */\nexport function useManagedContents(f: ManageFilter = {}, o: { client?: ContentKitClient } = {}): UseList<Content> {\n  const { client, store, scope } = useContentScope(o.client);\n  const { pageSize, ...q } = f;\n  const size = pageSize ?? 20;\n  return useList(\n    store,\n    keyOf(\"contents\", scope, q.kind, q.state, q.owner_group, q.q, q.language, size),\n    { type: \"contents\", scope: q.state === \"deleted\" ? \"deleted\" : undefined },\n    offsetPages(size, (page, signal) => client.contents.manage({ ...q, ...page }, signal)),\n  );\n}\n\nexport interface UseContent {\n  /** null before create (or while loading). */\n  content: Content | null;\n  loading: boolean;\n  error?: ContentKitError;\n  /** Writes in flight. */\n  saving: boolean;\n  /** Reads the item again. */\n  reload: () => void;\n  /** Creates the item as a draft; the hook then edits it. */\n  create: (input: ContentInput) => Promise<Content>;\n  update: (patch: ContentPatch) => Promise<Content>;\n  /** Sets the text in the hook's language; a body from the editor is stored with image references (storedBody). */\n  putText: (text: CatalogText) => Promise<Content>;\n  /** Publishes now, or schedules for at. */\n  publish: (at?: string) => Promise<Content>;\n  unpublish: () => Promise<Content>;\n  remove: () => Promise<void>;\n  restore: () => Promise<Content>;\n  /** Uploads the cover (null clears it); resolves with a URL that shows it now. */\n  setCover: (file: Blob | null) => Promise<string | null>;\n  /** Uploads an image for the body; resolves with a URL that shows it now, to place in the editor. */\n  uploadImage: (file: Blob) => Promise<string>;\n  /**\n   * A URL that shows one of the item's images now, by name (\"i-{uuid}\") or\n   * reference: a fresh upload from its file, else its public file\n   * (`content.images`), else, while it has none (an unpublished item's), its\n   * signed editor view from an editor read. Anything else is returned as is.\n   */\n  imageSrc: (image: string | null | undefined) => string | undefined;\n  /** The cover through imageSrc. */\n  coverSrc: string | undefined;\n  /** The language's stored text, its body's images through imageSrc: what an editor shows. */\n  text: CatalogText | undefined;\n  /** HTML from the editor with every image URL this hook showed turned back into the image's reference. */\n  storedBody: (html: string) => string;\n}\n\n/** The names of the images a body references, once each. */\nconst refNames = (body: string | undefined) => [...new Set([...(body ?? \"\").matchAll(imageRefs())].map((m) => m[1]!))];\nconst uploadName = (path: string) => {\n  const base = path.slice(path.lastIndexOf(\"/\") + 1);\n  const dot = base.lastIndexOf(\".\");\n  return dot > 0 ? base.slice(0, dot) : base;\n};\n\n/**\n * One content item of kind for its editors: read, create, text in language,\n * publish, delete, restore, cover and body images. null creates a new item.\n */\nexport function useContent(id: string | null | undefined, kind: string, language: string, o: { initial?: Content; client?: ContentKitClient } = {}): UseContent {\n  const { client, store, scope } = useContentScope(o.client);\n  const [created, setCreated] = useState<string | null>(null);\n  const cid = id ?? created;\n  const key = cid ? keyOf(\"content\", scope, cid) : null;\n  const r = useResource<Content | null>(store, key, { type: \"content\", id: cid ?? undefined }, (s) => client.contents.get(cid!, language, s), { initial: o.initial });\n  const content = r.data ?? null;\n  const [inflight, setInflight] = useState(0);\n  const guarded = useGuarded();\n  const run = useCallback(async <T>(fn: () => Promise<T>): Promise<T> => {\n    setInflight((n) => n + 1);\n    try {\n      return await guarded(fn);\n    } finally {\n      setInflight((n) => n - 1);\n    }\n  }, [guarded]);\n  const need = useCallback(() => {\n    if (!cid) throw new Error(\"contentkit-ui: create the item first\");\n    return cid;\n  }, [cid]);\n  const stored = content?.text?.[language];\n  const body = stored?.body;\n  const cover = content?.cover;\n\n  // Images: fresh uploads show from their file, published ones from\n  // content.images, the rest (an unpublished item's) from an editor read.\n  const [previews, setPreviews] = useState<ReadonlyMap<string, string>>(new Map());\n  const blobs = useRef<string[]>([]);\n  useEffect(() => {\n    const urls = blobs.current;\n    return () => {\n      for (const u of urls) URL.revokeObjectURL(u);\n    };\n  }, []);\n  const published = useMemo(() => new Map(Object.entries(content?.images ?? {})), [content?.images]);\n  // The cover is the item's folder's; body images are its body folder's ({kind}.body).\n  const coverPending = !!cover && !cover.url && !previews.has(cover.image) && !published.has(cover.image);\n  const bodyPending = useMemo(() => refNames(body).filter((n) => !previews.has(n) && !published.has(n)), [body, previews, published]);\n  const pending = useMemo(() => (coverPending ? [...bodyPending, cover!.image] : bodyPending), [coverPending, bodyPending, cover]);\n  const folder = useMemo(() => ({ kind, id: cid ?? \"none\" }), [kind, cid]);\n  const bodyFolder = useMemo(() => ({ kind: kind + BODY_SUFFIX, id: cid ?? \"none\" }), [kind, cid]);\n  const coverRead = useMediaRead(folder, { editor: true, read: coverPending ? undefined : null, client });\n  const bodyRead = useMediaRead(bodyFolder, { editor: true, read: bodyPending.length ? undefined : null, client });\n  const files = useMemo(() => [...(coverRead.read?.files ?? []), ...(bodyRead.read?.files ?? [])], [coverRead.read, bodyRead.read]);\n  const views = useMemo(() => {\n    const out = new Map<string, string>();\n    for (const f of files) if (f.upload && f.editor_url) out.set(uploadName(f.path), f.editor_url);\n    return out;\n  }, [files]);\n  // Editor views render on the first editor read that misses them: read again, backing off.\n  const failed = (n: string) => files.some((f) => f.failed && uploadName(f.path) === n);\n  const missing = (!!coverRead.read || !!bodyRead.read) && pending.some((n) => !views.has(n) && !failed(n));\n  const tries = useRef(0);\n  const reloadCover = coverRead.reload;\n  const reloadBody = bodyRead.reload;\n  const reload = useCallback(() => {\n    reloadCover();\n    reloadBody();\n  }, [reloadCover, reloadBody]);\n  useEffect(() => {\n    if (!missing) {\n      tries.current = 0;\n      return;\n    }\n    if (tries.current >= 6) return;\n    const t = setTimeout(() => {\n      tries.current++;\n      reload();\n    }, 1000 * 2 ** tries.current);\n    return () => clearTimeout(t);\n  }, [missing, files, reload]);\n\n  // Every URL shown for an image, of this and earlier reads, back to its name.\n  const shown = useRef(new Map<string, string>());\n  useEffect(() => {\n    for (const m of [previews, published, views]) for (const [n, u] of m) shown.current.set(u, n);\n  }, [previews, published, views]);\n\n  const imageSrc = useCallback(\n    (image: string | null | undefined) => {\n      if (!image) return undefined;\n      const n = image.startsWith(IMAGE_SCHEME) ? image.slice(IMAGE_SCHEME.length) : image;\n      return previews.get(n) ?? published.get(n) ?? views.get(n) ?? image;\n    },\n    [previews, published, views],\n  );\n  const text = useMemo(\n    () => (stored ? { ...stored, body: (stored.body ?? \"\").replace(imageRefs(), (ref, n: string) => previews.get(n) ?? published.get(n) ?? views.get(n) ?? ref) } : undefined),\n    [stored, previews, published, views],\n  );\n  const storedBody = useCallback(\n    (html: string) => {\n      const back = new Map(shown.current);\n      for (const m of [previews, published, views]) for (const [n, u] of m) back.set(u, n);\n      let out = html;\n      for (const [u, n] of back) out = out.split(u).join(imageRef(n)).split(u.replaceAll(\"&\", \"&amp;\")).join(imageRef(n));\n      return out;\n    },\n    [previews, published, views],\n  );\n  const preview = useCallback((name: string, file: Blob): string | undefined => {\n    if (typeof URL.createObjectURL !== \"function\") return undefined;\n    const url = URL.createObjectURL(file);\n    blobs.current.push(url);\n    setPreviews((m) => new Map(m).set(name, url));\n    return url;\n  }, []);\n\n  const create = useCallback(\n    (input: ContentInput) =>\n      run(async () => {\n        const c = await client.contents.create(input);\n        setCreated(c.id);\n        return c;\n      }),\n    [client, run],\n  );\n  const update = useCallback((patch: ContentPatch) => run(() => client.contents.update(need(), patch)), [client, run, need]);\n  const putText = useCallback(\n    (t: CatalogText) => run(() => client.contents.putText(need(), language, t.body === undefined ? t : { ...t, body: storedBody(t.body) })),\n    [client, run, need, language, storedBody],\n  );\n  const publish = useCallback((at?: string) => run(() => client.contents.publish(need(), at)), [client, run, need]);\n  const unpublish = useCallback(() => run(() => client.contents.unpublish(need())), [client, run, need]);\n  const remove = useCallback(() => run(() => client.contents.remove(need())), [client, run, need]);\n  const restore = useCallback(() => run(() => client.contents.restore(need())), [client, run, need]);\n  const setCover = useCallback(\n    (file: Blob | null) =>\n      run(async () => {\n        if (!file) {\n          await client.contents.setCover(need(), null);\n          return null;\n        }\n        const up = await client.media.uploadNamed({ kind, id: need() }, file);\n        const saved = await client.contents.setCover(need(), up.name);\n        const url = preview(up.name, file) ?? saved.cover?.url ?? null;\n        if (url) shown.current.set(url, up.name);\n        return url;\n      }),\n    [client, run, need, kind, preview],\n  );\n  const uploadImage = useCallback(\n    (file: Blob) =>\n      run(async () => {\n        const up = await client.media.uploadInline({ kind: kind + BODY_SUFFIX, id: need() }, file);\n        const url = preview(up.name, file) ?? up.url ?? up.ref;\n        shown.current.set(url, up.name);\n        return url;\n      }),\n    [client, run, need, kind, preview],\n  );\n  return {\n    content,\n    reload: r.reload,\n    loading: !!key && (r.loading || (!r.loaded && o.initial === undefined)),\n    error: r.error,\n    saving: inflight > 0,\n    create,\n    update,\n    putText,\n    publish,\n    unpublish,\n    remove,\n    restore,\n    setCover,\n    uploadImage,\n    imageSrc,\n    coverSrc: imageSrc(cover?.image),\n    text,\n    storedBody,\n  };\n}\n"],"mappings":"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"}
+{"version":3,"file":"contents.js","names":[],"sources":["../../src/react/contents.ts"],"sourcesContent":["import { useCallback, useEffect, useMemo, useRef, useState } from \"react\";\nimport type { ContentKitClient } from \"../client/client.js\";\nimport type { ContentKitError } from \"../client/errors.js\";\nimport type { CatalogText, Content, ContentInput, ContentPatch } from \"../client/generated/wire.js\";\nimport { BODY_SUFFIX, IMAGE_SCHEME, imageRef, imageRefs, type ManageQuery } from \"../client/contents.js\";\nimport { useMediaRead } from \"./read.js\";\nimport { useGuarded } from \"./context.js\";\nimport { keyOf, offsetPages, useContentScope, useList, useResource, type UseList } from \"./use-resource.js\";\n\nexport interface ManageFilter extends Omit<ManageQuery, \"limit\" | \"offset\"> {\n  pageSize?: number;\n}\n\n/** The content items the caller manages, newest first, a page at a time. */\nexport function useManagedContents(f: ManageFilter = {}, o: { client?: ContentKitClient } = {}): UseList<Content> {\n  const { client, store, scope } = useContentScope(o.client);\n  const { pageSize, ...q } = f;\n  const size = pageSize ?? 20;\n  return useList(\n    store,\n    keyOf(\"contents\", scope, q.kind, q.state, q.owner_group, q.q, q.language, size),\n    { type: \"contents\", scope: q.state === \"deleted\" ? \"deleted\" : undefined },\n    offsetPages(size, (page, signal) => client.contents.manage({ ...q, ...page }, signal)),\n  );\n}\n\nexport interface UseContent {\n  /** null before create (or while loading). */\n  content: Content | null;\n  loading: boolean;\n  error?: ContentKitError;\n  /** Writes in flight. */\n  saving: boolean;\n  /** Reads the item again. */\n  reload: () => void;\n  /** Creates the item as a draft; the hook then edits it. */\n  create: (input: ContentInput) => Promise<Content>;\n  update: (patch: ContentPatch) => Promise<Content>;\n  /** Sets the text in the hook's language; a body from the editor is stored with image references (storedBody). */\n  putText: (text: CatalogText) => Promise<Content>;\n  /** Publishes now, or schedules for at. */\n  publish: (at?: string) => Promise<Content>;\n  unpublish: () => Promise<Content>;\n  remove: () => Promise<void>;\n  restore: () => Promise<Content>;\n  /** Uploads the cover (null clears it); resolves with a URL that shows it now. */\n  setCover: (file: Blob | null) => Promise<string | null>;\n  /** Uploads an image for the body; resolves with a URL that shows it now, to place in the editor. */\n  uploadImage: (file: Blob) => Promise<string>;\n  /**\n   * A URL that shows one of the item's images now, by name (\"i-{uuid}\") or\n   * reference: a fresh upload from its file, else its public file\n   * (`content.images`), else, while it has none (an unpublished item's), its\n   * signed editor view from an editor read. Anything else is returned as is.\n   */\n  imageSrc: (image: string | null | undefined) => string | undefined;\n  /** The cover through imageSrc. */\n  coverSrc: string | undefined;\n  /** The language's stored text, its body's images through imageSrc: what an editor shows. */\n  text: CatalogText | undefined;\n  /** HTML from the editor with every image URL this hook showed turned back into the image's reference. */\n  storedBody: (html: string) => string;\n}\n\n/** The names of the images a body references, once each. */\nconst refNames = (body: string | undefined) => [...new Set([...(body ?? \"\").matchAll(imageRefs())].map((m) => m[1]!))];\nconst uploadName = (path: string) => {\n  const base = path.slice(path.lastIndexOf(\"/\") + 1);\n  const dot = base.lastIndexOf(\".\");\n  return dot > 0 ? base.slice(0, dot) : base;\n};\n\n/**\n * One content item of kind for its editors: read, create, text in language,\n * publish, delete, restore, cover and body images. null creates a new item.\n */\nexport function useContent(id: string | null | undefined, kind: string, language: string, o: { initial?: Content; client?: ContentKitClient } = {}): UseContent {\n  const { client, store, scope } = useContentScope(o.client);\n  const [created, setCreated] = useState<string | null>(null);\n  const cid = id ?? created;\n  const key = cid ? keyOf(\"content\", scope, cid) : null;\n  const r = useResource<Content | null>(store, key, { type: \"content\", id: cid ?? undefined }, (s) => client.contents.get(cid!, language, s), { initial: o.initial });\n  const content = r.data ?? null;\n  const [inflight, setInflight] = useState(0);\n  const guarded = useGuarded();\n  const run = useCallback(async <T>(fn: () => Promise<T>): Promise<T> => {\n    setInflight((n) => n + 1);\n    try {\n      return await guarded(fn);\n    } finally {\n      setInflight((n) => n - 1);\n    }\n  }, [guarded]);\n  const need = useCallback(() => {\n    if (!cid) throw new Error(\"contentkit-ui: create the item first\");\n    return cid;\n  }, [cid]);\n  const stored = content?.text?.[language];\n  const body = stored?.body;\n  const cover = content?.cover;\n\n  // Images: fresh uploads show from their file, published ones from\n  // content.images, the rest (an unpublished item's) from an editor read.\n  const [previews, setPreviews] = useState<ReadonlyMap<string, string>>(new Map());\n  const blobs = useRef<string[]>([]);\n  useEffect(() => {\n    const urls = blobs.current;\n    return () => {\n      for (const u of urls) URL.revokeObjectURL(u);\n    };\n  }, []);\n  const published = useMemo(() => new Map(Object.entries(content?.images ?? {})), [content?.images]);\n  // The cover is the item's folder's; body images are its body folder's ({kind}.body).\n  const coverPending = !!cover && !cover.url && !previews.has(cover.image) && !published.has(cover.image);\n  const bodyPending = useMemo(() => refNames(body).filter((n) => !previews.has(n) && !published.has(n)), [body, previews, published]);\n  const pending = useMemo(() => (coverPending ? [...bodyPending, cover!.image] : bodyPending), [coverPending, bodyPending, cover]);\n  const folder = useMemo(() => ({ kind, id: cid ?? \"none\" }), [kind, cid]);\n  const bodyFolder = useMemo(() => ({ kind: kind + BODY_SUFFIX, id: cid ?? \"none\" }), [kind, cid]);\n  const coverRead = useMediaRead(folder, { editor: true, read: coverPending ? undefined : null, client });\n  const bodyRead = useMediaRead(bodyFolder, { editor: true, read: bodyPending.length ? undefined : null, client });\n  const files = useMemo(() => [...(coverRead.read?.files ?? []), ...(bodyRead.read?.files ?? [])], [coverRead.read, bodyRead.read]);\n  const views = useMemo(() => {\n    const out = new Map<string, string>();\n    for (const f of files) if (f.upload && f.editor_url) out.set(uploadName(f.path), f.editor_url);\n    return out;\n  }, [files]);\n  // Editor views render on the first editor read that misses them: read again, backing off.\n  const failed = (n: string) => files.some((f) => f.failed && uploadName(f.path) === n);\n  const missing = (!!coverRead.read || !!bodyRead.read) && pending.some((n) => !views.has(n) && !failed(n));\n  const tries = useRef(0);\n  const reloadCover = coverRead.reload;\n  const reloadBody = bodyRead.reload;\n  const reload = useCallback(() => {\n    reloadCover();\n    reloadBody();\n  }, [reloadCover, reloadBody]);\n  useEffect(() => {\n    if (!missing) {\n      tries.current = 0;\n      return;\n    }\n    if (tries.current >= 6) return;\n    const t = setTimeout(() => {\n      tries.current++;\n      reload();\n    }, 1000 * 2 ** tries.current);\n    return () => clearTimeout(t);\n  }, [missing, files, reload]);\n\n  // Every URL shown for an image, of this and earlier reads, back to its name.\n  const shown = useRef(new Map<string, string>());\n  useEffect(() => {\n    for (const m of [previews, published, views]) for (const [n, u] of m) shown.current.set(u, n);\n  }, [previews, published, views]);\n\n  const imageSrc = useCallback(\n    (image: string | null | undefined) => {\n      if (!image) return undefined;\n      const n = image.startsWith(IMAGE_SCHEME) ? image.slice(IMAGE_SCHEME.length) : image;\n      return previews.get(n) ?? published.get(n) ?? views.get(n) ?? image;\n    },\n    [previews, published, views],\n  );\n  const text = useMemo(\n    () => (stored ? { ...stored, body: (stored.body ?? \"\").replace(imageRefs(), (ref, n: string) => previews.get(n) ?? published.get(n) ?? views.get(n) ?? ref) } : undefined),\n    [stored, previews, published, views],\n  );\n  const storedBody = useCallback(\n    (html: string) => {\n      const back = new Map(shown.current);\n      for (const m of [previews, published, views]) for (const [n, u] of m) back.set(u, n);\n      let out = html;\n      for (const [u, n] of back) out = out.split(u).join(imageRef(n)).split(u.replaceAll(\"&\", \"&amp;\")).join(imageRef(n));\n      return out;\n    },\n    [previews, published, views],\n  );\n  const preview = useCallback((name: string, file: Blob): string | undefined => {\n    if (typeof URL.createObjectURL !== \"function\") return undefined;\n    const url = URL.createObjectURL(file);\n    blobs.current.push(url);\n    setPreviews((m) => new Map(m).set(name, url));\n    return url;\n  }, []);\n\n  const create = useCallback(\n    (input: ContentInput) =>\n      run(async () => {\n        const c = await client.contents.create(input);\n        setCreated(c.id);\n        return c;\n      }),\n    [client, run],\n  );\n  const update = useCallback((patch: ContentPatch) => run(() => client.contents.update(need(), patch)), [client, run, need]);\n  const putText = useCallback(\n    (t: CatalogText) => run(() => client.contents.putText(need(), language, t.body === undefined ? t : { ...t, body: storedBody(t.body) })),\n    [client, run, need, language, storedBody],\n  );\n  const publish = useCallback((at?: string) => run(() => client.contents.publish(need(), at)), [client, run, need]);\n  const unpublish = useCallback(() => run(() => client.contents.unpublish(need())), [client, run, need]);\n  const remove = useCallback(() => run(() => client.contents.remove(need())), [client, run, need]);\n  const restore = useCallback(() => run(() => client.contents.restore(need())), [client, run, need]);\n  const setCover = useCallback(\n    (file: Blob | null) =>\n      run(async () => {\n        if (!file) {\n          await client.contents.setCover(need(), null);\n          return null;\n        }\n        const up = await client.media.uploadNamed({ kind, id: need() }, file);\n        const saved = await client.contents.setCover(need(), up.name);\n        const url = preview(up.name, file) ?? saved.cover?.url ?? null;\n        if (url) shown.current.set(url, up.name);\n        return url;\n      }),\n    [client, run, need, kind, preview],\n  );\n  const uploadImage = useCallback(\n    (file: Blob) =>\n      run(async () => {\n        const up = await client.media.uploadInline({ kind: kind + BODY_SUFFIX, id: need() }, file);\n        const url = preview(up.name, file) ?? up.url ?? up.ref;\n        shown.current.set(url, up.name);\n        return url;\n      }),\n    [client, run, need, kind, preview],\n  );\n  return {\n    content,\n    reload: r.reload,\n    loading: !!key && (r.loading || (!r.loaded && o.initial === undefined)),\n    error: r.error,\n    saving: inflight > 0,\n    create,\n    update,\n    putText,\n    publish,\n    unpublish,\n    remove,\n    restore,\n    setCover,\n    uploadImage,\n    imageSrc,\n    coverSrc: imageSrc(cover?.image),\n    text,\n    storedBody,\n  };\n}\n"],"mappings":"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"}

package/dist/react/detail.d.ts

@@ -5,11 +5,13 @@ import { Content, Decision, Version } from '../client/generated/wire.js';
 export declare function liveVersions(c: Content | null | undefined): Version[];
 /** The version a reader of language opens by default: the first live one serving it, else the first live one. */
 export declare function defaultVersion(c: Content | null | undefined, language?: string): Version | null;
+/** The version selected names: its code (any spelling, the page's ?v=) or its id; undefined when none. */
+export declare function findVersion(versions: readonly Version[], selected: string | null | undefined): Version | undefined;
 export interface UseContentDetail {
     content: Content | null;
     /** Live versions, first first. */
     versions: Version[];
-    /** The version shown: the one asked for when live, else the language's default. */
+    /** The version shown: the one asked for (?v=) when live, else the language's default. */
     version: Version | null;
     /** The shown version's access decision: allowed, what is sold, previews. */
     decision: Decision | null;
@@ -19,12 +21,16 @@ export interface UseContentDetail {
     error?: ContentKitError;
     reload: () => void;
 }
+export interface ContentDetailOptions {
+    language?: string;
+    /** The version to show, by code or id; default the page's ?v=. Unknown or not live: the language's default. */
+    version?: string | null;
+    /** The page's location for its ?v=; default window.location. */
+    location?: string;
+    client?: ContentKitClient;
+}
 /**
  * A content page's data: text in the reader's language, live versions with
  * their segments and access decisions, groups, attributes and the version to show.
  */
-export declare function useContentDetail(id: string | null | undefined, o?: {
-    language?: string;
-    version?: string | null;
-    client?: ContentKitClient;
-}): UseContentDetail;
+export declare function useContentDetail(id: string | null | undefined, o?: ContentDetailOptions): UseContentDetail;