@openrails/contentkit-ui 0.83.0 → 0.86.0

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/context.d.ts

@@ -5,7 +5,7 @@ import { ReadStore } from './store.js';
 /** What failed: a component's or hook's save, load or render step. */
 export type ContentKitOperation = "poster.load" | "poster.frame" | "poster.save" | "slot.load" | "slot.decode" | "slot.save" | "slot.remove" | "upload" | "folder.load" | "folder.commit" | "folder.update" | "folder.process" | "crop.load" | "crop.save" | SocialOperation;
 /** What failed in a content component: a load or a write. */
-export type SocialOperation = "comment.load" | "comment.post" | "comment.edit" | "comment.delete" | "comment.react" | "comment.restore" | "ban.save" | "ban.lift" | "reaction.save" | "favorite.save" | "poll.load" | "poll.vote" | "poll.answer" | "poll.save" | "post.load" | "content.save" | "moderation.load" | "moderation.resolve" | "media.save" | "notifications.load" | "notifications.read" | "notifications.dismiss" | "group.load" | "group.save" | "membership.save" | "history.forget" | "filters.save" | "offer.save" | "membership.join";
+export type SocialOperation = "comment.load" | "comment.post" | "comment.edit" | "comment.delete" | "comment.react" | "comment.restore" | "ban.save" | "ban.lift" | "reaction.save" | "favorite.save" | "poll.load" | "poll.vote" | "poll.answer" | "poll.save" | "post.load" | "content.save" | "moderation.load" | "moderation.resolve" | "rules.save" | "reader.save" | "media.save" | "notifications.load" | "notifications.read" | "notifications.dismiss" | "group.load" | "group.save" | "membership.save" | "history.forget" | "filters.save" | "offer.save" | "membership.join";
 /** The failure's context: the operation and, for one file, its name. */
 export interface ContentKitErrorInfo {
     operation: ContentKitOperation;

package/dist/react/context.js.map

@@ -1 +1 @@
-{"version":3,"file":"context.js","names":[],"sources":["../../src/react/context.ts"],"sourcesContent":["import { createContext, useCallback, useContext, useLayoutEffect, useRef } from \"react\";\nimport type { ContentKitClient } from \"../client/client.js\";\nimport { toContentKitError, type ContentKitError } from \"../client/errors.js\";\nimport type { ContentURLs } from \"../urls/index.js\";\nimport type { ReadStore } from \"./store.js\";\n\n/** What failed: a component's or hook's save, load or render step. */\nexport type ContentKitOperation =\n  | \"poster.load\"\n  | \"poster.frame\"\n  | \"poster.save\"\n  | \"slot.load\"\n  | \"slot.decode\"\n  | \"slot.save\"\n  | \"slot.remove\"\n  | \"upload\"\n  | \"folder.load\"\n  | \"folder.commit\"\n  | \"folder.update\"\n  | \"folder.process\"\n  | \"crop.load\"\n  | \"crop.save\"\n  | SocialOperation;\n\n/** What failed in a content component: a load or a write. */\nexport type SocialOperation =\n  | \"comment.load\"\n  | \"comment.post\"\n  | \"comment.edit\"\n  | \"comment.delete\"\n  | \"comment.react\"\n  | \"comment.restore\"\n  | \"ban.save\"\n  | \"ban.lift\"\n  | \"reaction.save\"\n  | \"favorite.save\"\n  | \"poll.load\"\n  | \"poll.vote\"\n  | \"poll.answer\"\n  | \"poll.save\"\n  | \"post.load\"\n  | \"content.save\"\n  | \"moderation.load\"\n  | \"moderation.resolve\"\n  | \"media.save\"\n  | \"notifications.load\"\n  | \"notifications.read\"\n  | \"notifications.dismiss\"\n  | \"group.load\"\n  | \"group.save\"\n  | \"membership.save\"\n  | \"history.forget\"\n  | \"filters.save\"\n  | \"offer.save\"\n  | \"membership.join\";\n\n/** The failure's context: the operation and, for one file, its name. */\nexport interface ContentKitErrorInfo {\n  operation: ContentKitOperation;\n  file?: string;\n}\n\n/**\n * Every failure a component shows is also reported here (aborts excepted), so\n * the host can toast or log it. Components still show it in place.\n */\nexport type ContentKitErrorHandler = (error: ContentKitError, info: ContentKitErrorInfo) => void;\n\n/** The host router: in-app navigation, e.g. a canonical replace. */\nexport type Navigate = (to: string, options?: { replace?: boolean }) => void;\n\nexport interface ContentKitContextValue {\n  client: ContentKitClient;\n  /**\n   * The signed-in user's id as ContentKit sees it, null when signed out,\n   * undefined when the host does not say. Content reads are kept per viewer.\n   */\n  viewer?: string | null;\n  /** Request language; keep it in sync with the client's language callback. */\n  language?: string;\n  /** Change when the current viewer's permissions or entitlements change. */\n  accessRevision?: string | number;\n  readScope: string;\n  /** Asks the visitor to sign in; with it, signed-out visitors are prompted instead of acting anonymously. */\n  onSignIn?: () => void;\n  /** The host's content URL config (createContentURLs). */\n  urls?: ContentURLs;\n  navigate?: Navigate;\n  onError?: ContentKitErrorHandler;\n  /** The reads hooks share. */\n  store: ReadStore;\n}\n\nexport const ContentKitContext = createContext<ContentKitContextValue | null>(null);\n\n/** Values that can change a read without changing its content reference. */\nexport function useReadScope(): string {\n  return useContext(ContentKitContext)?.readScope ?? \"{}\";\n}\n\n/** The ContentKitProvider's value; throws outside one. */\nexport function useContentKit(): ContentKitContextValue {\n  const ctx = useContext(ContentKitContext);\n  if (!ctx) throw new Error(\"contentkit-ui: wrap the tree in <ContentKitProvider client>\");\n  return ctx;\n}\n\n/** The client a hook or component uses: its own, else the provider's; throws without either. */\nexport function useContentKitClient(own?: ContentKitClient | null): ContentKitClient {\n  const c = useOptionalContentKitClient(own);\n  if (!c) throw new Error(\"contentkit-ui: pass `client` or render inside <ContentKitProvider client>\");\n  return c;\n}\n\nexport function useOptionalContentKitClient(own?: ContentKitClient | null): ContentKitClient | null {\n  const ctx = useContext(ContentKitContext);\n  const client = own ?? ctx?.client ?? null;\n  const scope = useReadScope();\n  useLayoutEffect(() => { client?.setReadScope(scope); }, [client, scope]);\n  return client;\n}\n\n/** The provider's content URL helpers; throws when none were given. */\nexport function useContentURLs(): ContentURLs {\n  const urls = useContext(ContentKitContext)?.urls;\n  if (!urls) throw new Error(\"contentkit-ui: pass `urls` to <ContentKitProvider>\");\n  return urls;\n}\n\n/** A stable reporter: the component's own `onError`, else the provider's. */\nexport function useErrorReporter(own?: ContentKitErrorHandler): (e: unknown, operation: ContentKitOperation, file?: string) => void {\n  const ctx = useContext(ContentKitContext)?.onError;\n  const handler = useRef(own ?? ctx);\n  handler.current = own ?? ctx;\n  return useCallback((e: unknown, operation: ContentKitOperation, file?: string) => {\n    const error = toContentKitError(e);\n    if (error.code !== \"aborted\") handler.current?.(error, file === undefined ? { operation } : { operation, file });\n  }, []);\n}\n\n/** Runs a write, e.g. auth-ui's useStepUpGuard(): re-authenticates when the write asks for a recent sign-in, then retries. */\nexport type ContentKitGuard = <T>(write: () => Promise<T>) => Promise<T>;\n\n/** The admin flow's guard; hooks run their writes through it. */\nexport const GuardContext = createContext<ContentKitGuard | undefined>(undefined);\n\n/** Runs fn through the flow's guard, when the host gave one. */\nexport function useGuarded(): <T>(fn: () => Promise<T>) => Promise<T> {\n  const guard = useContext(GuardContext);\n  return useCallback(<T,>(fn: () => Promise<T>) => (guard ? guard(fn) : fn()), [guard]);\n}\n"],"mappings":";;;AA6FA,IAAa,IAAoB,EAA6C,IAAI;AAGlF,SAAgB,IAAuB;CACrC,OAAO,EAAW,CAAiB,CAAC,EAAE,aAAa;AACrD;AAGA,SAAgB,IAAwC;CACtD,IAAM,IAAM,EAAW,CAAiB;CACxC,IAAI,CAAC,GAAK,MAAU,MAAM,6DAA6D;CACvF,OAAO;AACT;AAGA,SAAgB,EAAoB,GAAiD;CACnF,IAAM,IAAI,EAA4B,CAAG;CACzC,IAAI,CAAC,GAAG,MAAU,MAAM,2EAA2E;CACnG,OAAO;AACT;AAEA,SAAgB,EAA4B,GAAwD;CAClG,IAAM,IAAM,EAAW,CAAiB,GAClC,IAAS,KAAO,GAAK,UAAU,MAC/B,IAAQ,EAAa;CAE3B,OADA,QAAsB;EAAE,GAAQ,aAAa,CAAK;CAAG,GAAG,CAAC,GAAQ,CAAK,CAAC,GAChE;AACT;AAGA,SAAgB,IAA8B;CAC5C,IAAM,IAAO,EAAW,CAAiB,CAAC,EAAE;CAC5C,IAAI,CAAC,GAAM,MAAU,MAAM,oDAAoD;CAC/E,OAAO;AACT;AAGA,SAAgB,EAAiB,GAAmG;CAClI,IAAM,IAAM,EAAW,CAAiB,CAAC,EAAE,SACrC,IAAU,EAAO,KAAO,CAAG;CAEjC,OADA,EAAQ,UAAU,KAAO,GAClB,GAAa,GAAY,GAAgC,MAAkB;EAChF,IAAM,IAAQ,EAAkB,CAAC;EACjC,AAAI,EAAM,SAAS,aAAW,EAAQ,UAAU,GAAO,MAAS,KAAA,IAAY,EAAE,aAAU,IAAI;GAAE;GAAW;EAAK,CAAC;CACjH,GAAG,CAAC,CAAC;AACP;AAMA,IAAa,IAAe,EAA2C,KAAA,CAAS;AAGhF,SAAgB,IAAsD;CACpE,IAAM,IAAQ,EAAW,CAAY;CACrC,OAAO,GAAiB,MAA0B,IAAQ,EAAM,CAAE,IAAI,EAAG,GAAI,CAAC,CAAK,CAAC;AACtF"}
+{"version":3,"file":"context.js","names":[],"sources":["../../src/react/context.ts"],"sourcesContent":["import { createContext, useCallback, useContext, useLayoutEffect, useRef } from \"react\";\nimport type { ContentKitClient } from \"../client/client.js\";\nimport { toContentKitError, type ContentKitError } from \"../client/errors.js\";\nimport type { ContentURLs } from \"../urls/index.js\";\nimport type { ReadStore } from \"./store.js\";\n\n/** What failed: a component's or hook's save, load or render step. */\nexport type ContentKitOperation =\n  | \"poster.load\"\n  | \"poster.frame\"\n  | \"poster.save\"\n  | \"slot.load\"\n  | \"slot.decode\"\n  | \"slot.save\"\n  | \"slot.remove\"\n  | \"upload\"\n  | \"folder.load\"\n  | \"folder.commit\"\n  | \"folder.update\"\n  | \"folder.process\"\n  | \"crop.load\"\n  | \"crop.save\"\n  | SocialOperation;\n\n/** What failed in a content component: a load or a write. */\nexport type SocialOperation =\n  | \"comment.load\"\n  | \"comment.post\"\n  | \"comment.edit\"\n  | \"comment.delete\"\n  | \"comment.react\"\n  | \"comment.restore\"\n  | \"ban.save\"\n  | \"ban.lift\"\n  | \"reaction.save\"\n  | \"favorite.save\"\n  | \"poll.load\"\n  | \"poll.vote\"\n  | \"poll.answer\"\n  | \"poll.save\"\n  | \"post.load\"\n  | \"content.save\"\n  | \"moderation.load\"\n  | \"moderation.resolve\"\n  | \"rules.save\"\n  | \"reader.save\"\n  | \"media.save\"\n  | \"notifications.load\"\n  | \"notifications.read\"\n  | \"notifications.dismiss\"\n  | \"group.load\"\n  | \"group.save\"\n  | \"membership.save\"\n  | \"history.forget\"\n  | \"filters.save\"\n  | \"offer.save\"\n  | \"membership.join\";\n\n/** The failure's context: the operation and, for one file, its name. */\nexport interface ContentKitErrorInfo {\n  operation: ContentKitOperation;\n  file?: string;\n}\n\n/**\n * Every failure a component shows is also reported here (aborts excepted), so\n * the host can toast or log it. Components still show it in place.\n */\nexport type ContentKitErrorHandler = (error: ContentKitError, info: ContentKitErrorInfo) => void;\n\n/** The host router: in-app navigation, e.g. a canonical replace. */\nexport type Navigate = (to: string, options?: { replace?: boolean }) => void;\n\nexport interface ContentKitContextValue {\n  client: ContentKitClient;\n  /**\n   * The signed-in user's id as ContentKit sees it, null when signed out,\n   * undefined when the host does not say. Content reads are kept per viewer.\n   */\n  viewer?: string | null;\n  /** Request language; keep it in sync with the client's language callback. */\n  language?: string;\n  /** Change when the current viewer's permissions or entitlements change. */\n  accessRevision?: string | number;\n  readScope: string;\n  /** Asks the visitor to sign in; with it, signed-out visitors are prompted instead of acting anonymously. */\n  onSignIn?: () => void;\n  /** The host's content URL config (createContentURLs). */\n  urls?: ContentURLs;\n  navigate?: Navigate;\n  onError?: ContentKitErrorHandler;\n  /** The reads hooks share. */\n  store: ReadStore;\n}\n\nexport const ContentKitContext = createContext<ContentKitContextValue | null>(null);\n\n/** Values that can change a read without changing its content reference. */\nexport function useReadScope(): string {\n  return useContext(ContentKitContext)?.readScope ?? \"{}\";\n}\n\n/** The ContentKitProvider's value; throws outside one. */\nexport function useContentKit(): ContentKitContextValue {\n  const ctx = useContext(ContentKitContext);\n  if (!ctx) throw new Error(\"contentkit-ui: wrap the tree in <ContentKitProvider client>\");\n  return ctx;\n}\n\n/** The client a hook or component uses: its own, else the provider's; throws without either. */\nexport function useContentKitClient(own?: ContentKitClient | null): ContentKitClient {\n  const c = useOptionalContentKitClient(own);\n  if (!c) throw new Error(\"contentkit-ui: pass `client` or render inside <ContentKitProvider client>\");\n  return c;\n}\n\nexport function useOptionalContentKitClient(own?: ContentKitClient | null): ContentKitClient | null {\n  const ctx = useContext(ContentKitContext);\n  const client = own ?? ctx?.client ?? null;\n  const scope = useReadScope();\n  useLayoutEffect(() => { client?.setReadScope(scope); }, [client, scope]);\n  return client;\n}\n\n/** The provider's content URL helpers; throws when none were given. */\nexport function useContentURLs(): ContentURLs {\n  const urls = useContext(ContentKitContext)?.urls;\n  if (!urls) throw new Error(\"contentkit-ui: pass `urls` to <ContentKitProvider>\");\n  return urls;\n}\n\n/** A stable reporter: the component's own `onError`, else the provider's. */\nexport function useErrorReporter(own?: ContentKitErrorHandler): (e: unknown, operation: ContentKitOperation, file?: string) => void {\n  const ctx = useContext(ContentKitContext)?.onError;\n  const handler = useRef(own ?? ctx);\n  handler.current = own ?? ctx;\n  return useCallback((e: unknown, operation: ContentKitOperation, file?: string) => {\n    const error = toContentKitError(e);\n    if (error.code !== \"aborted\") handler.current?.(error, file === undefined ? { operation } : { operation, file });\n  }, []);\n}\n\n/** Runs a write, e.g. auth-ui's useStepUpGuard(): re-authenticates when the write asks for a recent sign-in, then retries. */\nexport type ContentKitGuard = <T>(write: () => Promise<T>) => Promise<T>;\n\n/** The admin flow's guard; hooks run their writes through it. */\nexport const GuardContext = createContext<ContentKitGuard | undefined>(undefined);\n\n/** Runs fn through the flow's guard, when the host gave one. */\nexport function useGuarded(): <T>(fn: () => Promise<T>) => Promise<T> {\n  const guard = useContext(GuardContext);\n  return useCallback(<T,>(fn: () => Promise<T>) => (guard ? guard(fn) : fn()), [guard]);\n}\n"],"mappings":";;;AA+FA,IAAa,IAAoB,EAA6C,IAAI;AAGlF,SAAgB,IAAuB;CACrC,OAAO,EAAW,CAAiB,CAAC,EAAE,aAAa;AACrD;AAGA,SAAgB,IAAwC;CACtD,IAAM,IAAM,EAAW,CAAiB;CACxC,IAAI,CAAC,GAAK,MAAU,MAAM,6DAA6D;CACvF,OAAO;AACT;AAGA,SAAgB,EAAoB,GAAiD;CACnF,IAAM,IAAI,EAA4B,CAAG;CACzC,IAAI,CAAC,GAAG,MAAU,MAAM,2EAA2E;CACnG,OAAO;AACT;AAEA,SAAgB,EAA4B,GAAwD;CAClG,IAAM,IAAM,EAAW,CAAiB,GAClC,IAAS,KAAO,GAAK,UAAU,MAC/B,IAAQ,EAAa;CAE3B,OADA,QAAsB;EAAE,GAAQ,aAAa,CAAK;CAAG,GAAG,CAAC,GAAQ,CAAK,CAAC,GAChE;AACT;AAGA,SAAgB,IAA8B;CAC5C,IAAM,IAAO,EAAW,CAAiB,CAAC,EAAE;CAC5C,IAAI,CAAC,GAAM,MAAU,MAAM,oDAAoD;CAC/E,OAAO;AACT;AAGA,SAAgB,EAAiB,GAAmG;CAClI,IAAM,IAAM,EAAW,CAAiB,CAAC,EAAE,SACrC,IAAU,EAAO,KAAO,CAAG;CAEjC,OADA,EAAQ,UAAU,KAAO,GAClB,GAAa,GAAY,GAAgC,MAAkB;EAChF,IAAM,IAAQ,EAAkB,CAAC;EACjC,AAAI,EAAM,SAAS,aAAW,EAAQ,UAAU,GAAO,MAAS,KAAA,IAAY,EAAE,aAAU,IAAI;GAAE;GAAW;EAAK,CAAC;CACjH,GAAG,CAAC,CAAC;AACP;AAMA,IAAa,IAAe,EAA2C,KAAA,CAAS;AAGhF,SAAgB,IAAsD;CACpE,IAAM,IAAQ,EAAW,CAAY;CACrC,OAAO,GAAiB,MAA0B,IAAQ,EAAM,CAAE,IAAI,EAAG,GAAI,CAAC,CAAK,CAAC;AACtF"}

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;

package/dist/react/detail.js

@@ -1,42 +1,49 @@
 import { keyOf as e, useContentScope as t, useResource as n } from "./use-resource.js";
-import { useMemo as r } from "react";
+import { parseVersionCode as r } from "../urls.js";
+import { useVersionParam as i } from "./location.js";
+import { useMemo as a } from "react";
 //#region src/react/detail.ts
-function i(e) {
+function o(e) {
 	return (e?.versions ?? []).filter((e) => e.live).sort((e, t) => e.position - t.position);
 }
-function a(e, t) {
-	let n = i(e);
+function s(e, t) {
+	let n = o(e);
 	return (t ? n.find((e) => e.languages.includes(t)) : void 0) ?? n[0] ?? null;
 }
-function o(o, s = {}) {
-	let { client: c, store: l, scope: u, language: d } = t(s.client), f = s.language ?? d, p = o ? e("content-detail", u, o, f) : null, m = n(l, p, {
+function c(e, t) {
+	if (!t) return;
+	let n = r(t);
+	return e.find((e) => e.id === t) ?? (n ? e.find((e) => e.code === n) : void 0);
+}
+function l(r, l = {}) {
+	let { client: u, store: d, scope: f, language: p } = t(l.client), m = l.language ?? p, [h] = i({ location: l.location }), g = l.version === void 0 ? h : l.version, _ = r ? e("content-detail", f, r, m) : null, v = n(d, _, {
 		type: "content-detail",
-		id: o ?? void 0
-	}, (e) => c.contents.get(o, f, e)), h = m.data ?? null;
-	return r(() => {
-		let e = i(h), t = e.find((e) => e.id === s.version) ?? a(h, f);
+		id: r ?? void 0
+	}, (e) => u.contents.get(r, m, e)), y = v.data ?? null;
+	return a(() => {
+		let e = o(y), t = c(e, g) ?? s(y, m);
 		return {
-			content: h,
+			content: y,
 			versions: e,
 			version: t,
-			decision: t?.decision ?? h?.decision ?? null,
+			decision: t?.decision ?? y?.decision ?? null,
 			languages: [...new Set(e.flatMap((e) => e.languages))],
-			loading: !!p && (m.loading || !m.loaded),
-			error: m.error,
-			reload: m.reload
+			loading: !!_ && (v.loading || !v.loaded),
+			error: v.error,
+			reload: v.reload
 		};
 	}, [
-		h,
-		s.version,
-		f,
-		p,
-		m.loading,
-		m.loaded,
-		m.error,
-		m.reload
+		y,
+		g,
+		m,
+		_,
+		v.loading,
+		v.loaded,
+		v.error,
+		v.reload
 	]);
 }
 //#endregion
-export { a as defaultVersion, i as liveVersions, o as useContentDetail };
+export { s as defaultVersion, c as findVersion, o as liveVersions, l as useContentDetail };
 
 //# sourceMappingURL=detail.js.map

package/dist/react/detail.js.map

@@ -1 +1 @@
-{"version":3,"file":"detail.js","names":[],"sources":["../../src/react/detail.ts"],"sourcesContent":["import { useMemo } from \"react\";\nimport type { ContentKitClient } from \"../client/client.js\";\nimport type { ContentKitError } from \"../client/errors.js\";\nimport type { Content, Decision, Version } from \"../client/generated/wire.js\";\nimport { keyOf, useContentScope, useResource } from \"./use-resource.js\";\n\n/** A content's live versions, first first. */\nexport function liveVersions(c: Content | null | undefined): Version[] {\n  return (c?.versions ?? []).filter((v) => v.live).sort((a, b) => a.position - b.position);\n}\n\n/** The version a reader of language opens by default: the first live one serving it, else the first live one. */\nexport function defaultVersion(c: Content | null | undefined, language?: string): Version | null {\n  const live = liveVersions(c);\n  return (language ? live.find((v) => v.languages.includes(language)) : undefined) ?? live[0] ?? null;\n}\n\nexport interface UseContentDetail {\n  content: Content | null;\n  /** Live versions, first first. */\n  versions: Version[];\n  /** The version shown: the one asked for when live, else the language's default. */\n  version: Version | null;\n  /** The shown version's access decision: allowed, what is sold, previews. */\n  decision: Decision | null;\n  /** Every language a live version serves, in version order. */\n  languages: string[];\n  loading: boolean;\n  error?: ContentKitError;\n  reload: () => void;\n}\n\n/**\n * A content page's data: text in the reader's language, live versions with\n * their segments and access decisions, groups, attributes and the version to show.\n */\nexport function useContentDetail(id: string | null | undefined, o: { language?: string; version?: string | null; client?: ContentKitClient } = {}): UseContentDetail {\n  const { client, store, scope, language: provided } = useContentScope(o.client);\n  const language = o.language ?? provided;\n  const key = id ? keyOf(\"content-detail\", scope, id, language) : null;\n  const r = useResource<Content>(store, key, { type: \"content-detail\", id: id ?? undefined }, (s) => client.contents.get(id!, language, s));\n  const content = r.data ?? null;\n  return useMemo(() => {\n    const versions = liveVersions(content);\n    const version = versions.find((v) => v.id === o.version) ?? defaultVersion(content, language);\n    return {\n      content,\n      versions,\n      version,\n      decision: version?.decision ?? content?.decision ?? null,\n      languages: [...new Set(versions.flatMap((v) => v.languages))],\n      loading: !!key && (r.loading || !r.loaded),\n      error: r.error,\n      reload: r.reload,\n    };\n  }, [content, o.version, language, key, r.loading, r.loaded, r.error, r.reload]);\n}\n"],"mappings":";;;AAOA,SAAgB,EAAa,GAA0C;CACrE,QAAQ,GAAG,YAAY,CAAC,EAAA,CAAG,QAAQ,MAAM,EAAE,IAAI,CAAC,CAAC,MAAM,GAAG,MAAM,EAAE,WAAW,EAAE,QAAQ;AACzF;AAGA,SAAgB,EAAe,GAA+B,GAAmC;CAC/F,IAAM,IAAO,EAAa,CAAC;CAC3B,QAAQ,IAAW,EAAK,MAAM,MAAM,EAAE,UAAU,SAAS,CAAQ,CAAC,IAAI,KAAA,MAAc,EAAK,MAAM;AACjG;AAqBA,SAAgB,EAAiB,GAA+B,IAA+E,CAAC,GAAqB;CACnK,IAAM,EAAE,WAAQ,UAAO,UAAO,UAAU,MAAa,EAAgB,EAAE,MAAM,GACvE,IAAW,EAAE,YAAY,GACzB,IAAM,IAAK,EAAM,kBAAkB,GAAO,GAAI,CAAQ,IAAI,MAC1D,IAAI,EAAqB,GAAO,GAAK;EAAE,MAAM;EAAkB,IAAI,KAAM,KAAA;CAAU,IAAI,MAAM,EAAO,SAAS,IAAI,GAAK,GAAU,CAAC,CAAC,GAClI,IAAU,EAAE,QAAQ;CAC1B,OAAO,QAAc;EACnB,IAAM,IAAW,EAAa,CAAO,GAC/B,IAAU,EAAS,MAAM,MAAM,EAAE,OAAO,EAAE,OAAO,KAAK,EAAe,GAAS,CAAQ;EAC5F,OAAO;GACL;GACA;GACA;GACA,UAAU,GAAS,YAAY,GAAS,YAAY;GACpD,WAAW,CAAC,GAAG,IAAI,IAAI,EAAS,SAAS,MAAM,EAAE,SAAS,CAAC,CAAC;GAC5D,SAAS,CAAC,CAAC,MAAQ,EAAE,WAAW,CAAC,EAAE;GACnC,OAAO,EAAE;GACT,QAAQ,EAAE;EACZ;CACF,GAAG;EAAC;EAAS,EAAE;EAAS;EAAU;EAAK,EAAE;EAAS,EAAE;EAAQ,EAAE;EAAO,EAAE;CAAM,CAAC;AAChF"}
+{"version":3,"file":"detail.js","names":[],"sources":["../../src/react/detail.ts"],"sourcesContent":["import { useMemo } from \"react\";\nimport type { ContentKitClient } from \"../client/client.js\";\nimport type { ContentKitError } from \"../client/errors.js\";\nimport type { Content, Decision, Version } from \"../client/generated/wire.js\";\nimport { parseVersionCode } from \"../urls/index.js\";\nimport { useVersionParam } from \"./location.js\";\nimport { keyOf, useContentScope, useResource } from \"./use-resource.js\";\n\n/** A content's live versions, first first. */\nexport function liveVersions(c: Content | null | undefined): Version[] {\n  return (c?.versions ?? []).filter((v) => v.live).sort((a, b) => a.position - b.position);\n}\n\n/** The version a reader of language opens by default: the first live one serving it, else the first live one. */\nexport function defaultVersion(c: Content | null | undefined, language?: string): Version | null {\n  const live = liveVersions(c);\n  return (language ? live.find((v) => v.languages.includes(language)) : undefined) ?? live[0] ?? null;\n}\n\n/** The version selected names: its code (any spelling, the page's ?v=) or its id; undefined when none. */\nexport function findVersion(versions: readonly Version[], selected: string | null | undefined): Version | undefined {\n  if (!selected) return undefined;\n  const code = parseVersionCode(selected);\n  return versions.find((v) => v.id === selected) ?? (code ? versions.find((v) => v.code === code) : undefined);\n}\n\nexport interface UseContentDetail {\n  content: Content | null;\n  /** Live versions, first first. */\n  versions: Version[];\n  /** The version shown: the one asked for (?v=) when live, else the language's default. */\n  version: Version | null;\n  /** The shown version's access decision: allowed, what is sold, previews. */\n  decision: Decision | null;\n  /** Every language a live version serves, in version order. */\n  languages: string[];\n  loading: boolean;\n  error?: ContentKitError;\n  reload: () => void;\n}\n\nexport interface ContentDetailOptions {\n  language?: string;\n  /** The version to show, by code or id; default the page's ?v=. Unknown or not live: the language's default. */\n  version?: string | null;\n  /** The page's location for its ?v=; default window.location. */\n  location?: string;\n  client?: ContentKitClient;\n}\n\n/**\n * A content page's data: text in the reader's language, live versions with\n * their segments and access decisions, groups, attributes and the version to show.\n */\nexport function useContentDetail(id: string | null | undefined, o: ContentDetailOptions = {}): UseContentDetail {\n  const { client, store, scope, language: provided } = useContentScope(o.client);\n  const language = o.language ?? provided;\n  const [param] = useVersionParam({ location: o.location });\n  const selected = o.version === undefined ? param : o.version;\n  const key = id ? keyOf(\"content-detail\", scope, id, language) : null;\n  const r = useResource<Content>(store, key, { type: \"content-detail\", id: id ?? undefined }, (s) => client.contents.get(id!, language, s));\n  const content = r.data ?? null;\n  return useMemo(() => {\n    const versions = liveVersions(content);\n    const version = findVersion(versions, selected) ?? defaultVersion(content, language);\n    return {\n      content,\n      versions,\n      version,\n      decision: version?.decision ?? content?.decision ?? null,\n      languages: [...new Set(versions.flatMap((v) => v.languages))],\n      loading: !!key && (r.loading || !r.loaded),\n      error: r.error,\n      reload: r.reload,\n    };\n  }, [content, selected, language, key, r.loading, r.loaded, r.error, r.reload]);\n}\n"],"mappings":";;;;;AASA,SAAgB,EAAa,GAA0C;CACrE,QAAQ,GAAG,YAAY,CAAC,EAAA,CAAG,QAAQ,MAAM,EAAE,IAAI,CAAC,CAAC,MAAM,GAAG,MAAM,EAAE,WAAW,EAAE,QAAQ;AACzF;AAGA,SAAgB,EAAe,GAA+B,GAAmC;CAC/F,IAAM,IAAO,EAAa,CAAC;CAC3B,QAAQ,IAAW,EAAK,MAAM,MAAM,EAAE,UAAU,SAAS,CAAQ,CAAC,IAAI,KAAA,MAAc,EAAK,MAAM;AACjG;AAGA,SAAgB,EAAY,GAA8B,GAA0D;CAClH,IAAI,CAAC,GAAU;CACf,IAAM,IAAO,EAAiB,CAAQ;CACtC,OAAO,EAAS,MAAM,MAAM,EAAE,OAAO,CAAQ,MAAM,IAAO,EAAS,MAAM,MAAM,EAAE,SAAS,CAAI,IAAI,KAAA;AACpG;AA8BA,SAAgB,EAAiB,GAA+B,IAA0B,CAAC,GAAqB;CAC9G,IAAM,EAAE,WAAQ,UAAO,UAAO,UAAU,MAAa,EAAgB,EAAE,MAAM,GACvE,IAAW,EAAE,YAAY,GACzB,CAAC,KAAS,EAAgB,EAAE,UAAU,EAAE,SAAS,CAAC,GAClD,IAAW,EAAE,YAAY,KAAA,IAAY,IAAQ,EAAE,SAC/C,IAAM,IAAK,EAAM,kBAAkB,GAAO,GAAI,CAAQ,IAAI,MAC1D,IAAI,EAAqB,GAAO,GAAK;EAAE,MAAM;EAAkB,IAAI,KAAM,KAAA;CAAU,IAAI,MAAM,EAAO,SAAS,IAAI,GAAK,GAAU,CAAC,CAAC,GAClI,IAAU,EAAE,QAAQ;CAC1B,OAAO,QAAc;EACnB,IAAM,IAAW,EAAa,CAAO,GAC/B,IAAU,EAAY,GAAU,CAAQ,KAAK,EAAe,GAAS,CAAQ;EACnF,OAAO;GACL;GACA;GACA;GACA,UAAU,GAAS,YAAY,GAAS,YAAY;GACpD,WAAW,CAAC,GAAG,IAAI,IAAI,EAAS,SAAS,MAAM,EAAE,SAAS,CAAC,CAAC;GAC5D,SAAS,CAAC,CAAC,MAAQ,EAAE,WAAW,CAAC,EAAE;GACnC,OAAO,EAAE;GACT,QAAQ,EAAE;EACZ;CACF,GAAG;EAAC;EAAS;EAAU;EAAU;EAAK,EAAE;EAAS,EAAE;EAAQ,EAAE;EAAO,EAAE;CAAM,CAAC;AAC/E"}