@openrails/contentkit-ui 0.86.0 → 0.87.0

package/dist/react/contents.d.ts

@@ -1,6 +1,6 @@
 import { ContentKitClient } from '../client/client.js';
 import { ContentKitError } from '../client/errors.js';
-import { CatalogText, Content, ContentInput, ContentPatch } from '../client/generated/wire.js';
+import { CatalogText, Content, ContentInput, ContentPatch, Version } from '../client/generated/wire.js';
 import { ManageQuery } from '../client/contents.js';
 import { UseList } from './use-resource.js';
 export interface ManageFilter extends Omit<ManageQuery, "limit" | "offset"> {
@@ -29,9 +29,15 @@ export interface UseContent {
     unpublish: () => Promise<Content>;
     remove: () => Promise<void>;
     restore: () => Promise<Content>;
-    /** Uploads the cover (null clears it); resolves with a URL that shows it now. */
+    /**
+     * The version whose cover and body images the hook edits: the one asked
+     * for, else the first. Every version has its own cover and its own copy of
+     * the body's images.
+     */
+    version: Version | null;
+    /** Uploads the version's cover (null returns to its first upload); resolves with a URL that shows it now. */
     setCover: (file: Blob | null) => Promise<string | null>;
-    /** Uploads an image for the body; resolves with a URL that shows it now, to place in the editor. */
+    /** Uploads an image for the body into the version, copied into the others; resolves with a URL that shows it now, to place in the editor. */
     uploadImage: (file: Blob) => Promise<string>;
     /**
      * A URL that shows one of the item's images now, by name ("i-{uuid}") or
@@ -40,7 +46,7 @@ export interface UseContent {
      * signed editor view from an editor read. Anything else is returned as is.
      */
     imageSrc: (image: string | null | undefined) => string | undefined;
-    /** The cover through imageSrc. */
+    /** The version's cover through imageSrc. */
     coverSrc: string | undefined;
     /** The language's stored text, its body's images through imageSrc: what an editor shows. */
     text: CatalogText | undefined;
@@ -49,9 +55,11 @@ export interface UseContent {
 }
 /**
  * One content item of kind for its editors: read, create, text in language,
- * publish, delete, restore, cover and body images. null creates a new item.
+ * publish, delete, restore, a version's cover and the body's images. null
+ * creates a new item.
  */
 export declare function useContent(id: string | null | undefined, kind: string, language: string, o?: {
     initial?: Content;
     client?: ContentKitClient;
+    version?: string;
 }): UseContent;

package/dist/react/contents.js

@@ -1,10 +1,10 @@
 import { useGuarded as e } from "./context.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";
+import { IMAGE_SCHEME as s, imageRef as c, imageRefs as l } from "../client/contents.js";
+import { useCallback as u, useEffect as d, useMemo as f, useRef as p, useState as m } from "react";
 //#region src/react/contents.ts
-function g(e = {}, a = {}) {
+function h(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",
@@ -14,201 +14,215 @@ function g(e = {}, a = {}) {
 		...e
 	}, t)));
 }
-var ee = (e) => [...new Set([...(e ?? "").matchAll(u())].map((e) => e[1]))], _ = (e) => {
+var ee = (e) => [...new Set([...(e ?? "").matchAll(l())].map((e) => e[1]))], g = (e) => {
 	let t = e.slice(e.lastIndexOf("/") + 1), n = t.lastIndexOf(".");
 	return n > 0 ? t.slice(0, n) : t;
 };
-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, {
+function _(n, i, h, _ = {}) {
+	let { client: v, store: y, scope: te } = r(_.client), [b, x] = m(null), S = n ?? b, C = S ? t("content", te, S) : null, w = a(y, C, {
 		type: "content",
-		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);
+		id: S ?? void 0
+	}, (e) => v.contents.get(S, h, e), { initial: _.initial }), T = w.data ?? null, [ne, E] = m(0), D = e(), O = u(async (e) => {
+		E((e) => e + 1);
 		try {
-			return await E(e);
+			return await D(e);
 		} finally {
-			T((e) => e - 1);
+			E((e) => e - 1);
 		}
-	}, [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 = N.current;
+	}, [D]), k = u(() => {
+		if (!S) throw Error("contentkit-ui: create the item first");
+		return S;
+	}, [S]), A = T?.text?.[h], j = A?.body, M = f(() => {
+		let e = [...T?.versions ?? []].sort((e, t) => e.position - t.position);
+		return e.find((e) => e.id === _.version) ?? e[0] ?? null;
+	}, [T?.versions, _.version]), N = M?.id, P = M?.cover, F = u(() => {
+		if (!N) throw Error("contentkit-ui: the item has no version yet");
+		return N;
+	}, [N]), [I, L] = m(/* @__PURE__ */ new Map()), R = p([]);
+	d(() => {
+		let e = R.current;
 		return () => {
 			for (let t of e) URL.revokeObjectURL(t);
 		};
 	}, []);
-	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,
+	let z = f(() => {
+		let e = new Map(Object.entries(T?.images ?? {}));
+		return P?.image && P.url && e.set(P.image, P.url), e;
+	}, [
+		T?.images,
+		P?.image,
+		P?.url
+	]), B = !!P?.image && !P.url && !I.has(P.image) && !z.has(P.image), V = f(() => ee(j).filter((e) => !I.has(e) && !z.has(e)), [
+		j,
 		I,
-		j
-	]), R = p(() => ({
+		z
+	]), H = f(() => B ? [...V, P.image] : V, [
+		B,
+		V,
+		P
+	]), U = f(() => ({
 		kind: i,
-		id: x ?? "none"
-	}), [i, x]), oe = p(() => ({
-		kind: i + s,
-		id: x ?? "none"
-	}), [i, x]), z = o(R, {
-		editor: !0,
-		read: F ? void 0 : null,
-		client: y
-	}), B = o(oe, {
+		id: S ?? "none",
+		version: N
+	}), [
+		i,
+		S,
+		N
+	]), W = o(U, {
 		editor: !0,
-		read: I.length ? void 0 : null,
-		client: y
-	}), V = p(() => [...z.read?.files ?? [], ...B.read?.files ?? []], [z.read, B.read]), H = p(() => {
+		read: H.length && N ? void 0 : null,
+		client: v
+	}), G = f(() => W.read?.files ?? [], [W.read]), K = f(() => {
 		let e = /* @__PURE__ */ new Map();
-		for (let t of V) t.upload && t.editor_url && e.set(_(t.path), t.editor_url);
+		for (let t of G) t.upload && t.editor_url && e.set(g(t.path), t.editor_url);
 		return e;
-	}, [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 (!W) {
-			G.current = 0;
+	}, [G]), re = (e) => G.some((t) => t.failed && g(t.path) === e), q = !!W.read && H.some((e) => !K.has(e) && !re(e)), J = p(0), Y = W.reload;
+	d(() => {
+		if (!q) {
+			J.current = 0;
 			return;
 		}
-		if (G.current >= 6) return;
+		if (J.current >= 6) return;
 		let e = setTimeout(() => {
-			G.current++, J();
-		}, 1e3 * 2 ** G.current);
+			J.current++, Y();
+		}, 1e3 * 2 ** J.current);
 		return () => clearTimeout(e);
 	}, [
-		W,
-		V,
-		J
+		q,
+		G,
+		Y
 	]);
-	let Y = m(/* @__PURE__ */ new Map());
-	f(() => {
+	let X = p(/* @__PURE__ */ new Map());
+	d(() => {
 		for (let e of [
-			M,
-			P,
-			H
-		]) for (let [t, n] of e) Y.current.set(n, t);
+			I,
+			z,
+			K
+		]) for (let [t, n] of e) X.current.set(n, t);
 	}, [
-		M,
-		P,
-		H
+		I,
+		z,
+		K
 	]);
-	let X = d((e) => {
+	let Z = u((e) => {
 		if (!e) return;
-		let t = e.startsWith("contentkit:") ? e.slice(c.length) : e;
-		return M.get(t) ?? P.get(t) ?? H.get(t) ?? e;
+		let t = e.startsWith("contentkit:") ? e.slice(s.length) : e;
+		return I.get(t) ?? z.get(t) ?? K.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)
+		I,
+		z,
+		K
+	]), ie = f(() => A ? {
+		...A,
+		body: (A.body ?? "").replace(l(), (e, t) => I.get(t) ?? z.get(t) ?? K.get(t) ?? e)
 	} : void 0, [
-		k,
-		M,
-		P,
-		H
-	]), Z = d((e) => {
-		let t = new Map(Y.current);
+		A,
+		I,
+		z,
+		K
+	]), Q = u((e) => {
+		let t = new Map(X.current);
 		for (let e of [
-			M,
-			P,
-			H
+			I,
+			z,
+			K
 		]) 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));
+		for (let [e, r] of t) n = n.split(e).join(c(r)).split(e.replaceAll("&", "&")).join(c(r));
 		return n;
 	}, [
-		M,
-		P,
-		H
-	]), Q = d((e, t) => {
+		I,
+		z,
+		K
+	]), $ = u((e, t) => {
 		if (typeof URL.createObjectURL != "function") return;
 		let n = URL.createObjectURL(t);
-		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 : {
+		return R.current.push(n), L((t) => new Map(t).set(e, n)), n;
+	}, []), ae = u((e) => O(async () => {
+		let t = await v.contents.create(e);
+		return x(t.id), t;
+	}), [v, O]), oe = u((e) => O(() => v.contents.update(k(), e)), [
+		v,
+		O,
+		k
+	]), se = u((e) => O(() => v.contents.putText(k(), h, e.body === void 0 ? e : {
 		...e,
-		body: Z(e.body)
+		body: Q(e.body)
 	})), [
-		y,
-		D,
+		v,
+		O,
+		k,
+		h,
+		Q
+	]), ce = u((e) => O(() => v.contents.publish(k(), e)), [
+		v,
+		O,
+		k
+	]), le = u(() => O(() => v.contents.unpublish(k())), [
+		v,
+		O,
+		k
+	]), ue = u(() => O(() => v.contents.remove(k())), [
+		v,
+		O,
+		k
+	]), de = u(() => O(() => v.contents.restore(k())), [
+		v,
 		O,
-		g,
-		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({
+		k
+	]), fe = u((e) => O(async () => {
+		if (!e) return await v.contents.setCover(k(), F(), null), null;
+		let t = {
 			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;
+			id: k(),
+			version: F()
+		}, n = await v.media.uploadNamed(t, e, { path: await v.media.presetPath(i, "cover", e) }), r = await v.contents.setCover(t.id, t.version, n.name), a = $(n.name, e) ?? r.cover?.url ?? null;
+		return a && X.current.set(a, n.name), a;
 	}), [
-		y,
-		D,
+		v,
 		O,
+		k,
+		F,
 		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;
+		$
+	]), pe = u((e) => O(async () => {
+		let t = await v.media.uploadInline({
+			kind: i,
+			id: k(),
+			version: F()
+		}, e), n = $(t.name, e) ?? t.url ?? t.ref;
+		return X.current.set(n, t.name), n;
 	}), [
-		y,
-		D,
+		v,
 		O,
+		k,
+		F,
 		i,
-		Q
+		$
 	]);
 	return {
-		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: X,
-		coverSrc: X(j?.image),
-		text: se,
-		storedBody: Z
+		content: T,
+		reload: w.reload,
+		loading: !!C && (w.loading || !w.loaded && _.initial === void 0),
+		error: w.error,
+		saving: ne > 0,
+		create: ae,
+		update: oe,
+		putText: se,
+		publish: ce,
+		unpublish: le,
+		remove: ue,
+		restore: de,
+		version: M,
+		setCover: fe,
+		uploadImage: pe,
+		imageSrc: Z,
+		coverSrc: P?.image ? Z(P.image) : P?.url ?? void 0,
+		text: ie,
+		storedBody: Q
 	};
 }
 //#endregion
-export { v as useContent, g as useManagedContents };
+export { _ as useContent, h 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, Version } from \"../client/generated/wire.js\";\nimport { 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  /**\n   * The version whose cover and body images the hook edits: the one asked\n   * for, else the first. Every version has its own cover and its own copy of\n   * the body's images.\n   */\n  version: Version | null;\n  /** Uploads the version's cover (null returns to its first upload); resolves with a URL that shows it now. */\n  setCover: (file: Blob | null) => Promise<string | null>;\n  /** Uploads an image for the body into the version, copied into the others; 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 version's 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, a version's cover and the body's images. null\n * creates a new item.\n */\nexport function useContent(\n  id: string | null | undefined,\n  kind: string,\n  language: string,\n  o: { initial?: Content; client?: ContentKitClient; version?: string } = {},\n): 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 version = useMemo(() => {\n    const vs = [...(content?.versions ?? [])].sort((a, b) => a.position - b.position);\n    return vs.find((v) => v.id === o.version) ?? vs[0] ?? null;\n  }, [content?.versions, o.version]);\n  const vid = version?.id;\n  const cover = version?.cover;\n  const needVersion = useCallback(() => {\n    if (!vid) throw new Error(\"contentkit-ui: the item has no version yet\");\n    return vid;\n  }, [vid]);\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(() => {\n    const out = new Map(Object.entries(content?.images ?? {}));\n    if (cover?.image && cover.url) out.set(cover.image, cover.url);\n    return out;\n  }, [content?.images, cover?.image, cover?.url]);\n  // The cover and the body's images are the version's.\n  const coverPending = !!cover?.image && !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\", version: vid }), [kind, cid, vid]);\n  const folderRead = useMediaRead(folder, { editor: true, read: pending.length && vid ? undefined : null, client });\n  const files = useMemo(() => folderRead.read?.files ?? [], [folderRead.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 = !!folderRead.read && pending.some((n) => !views.has(n) && !failed(n));\n  const tries = useRef(0);\n  const reload = folderRead.reload;\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(), needVersion(), null);\n          return null;\n        }\n        const ref = { kind, id: need(), version: needVersion() };\n        const up = await client.media.uploadNamed(ref, file, { path: await client.media.presetPath(kind, \"cover\", file) });\n        const saved = await client.contents.setCover(ref.id, ref.version, 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, needVersion, kind, preview],\n  );\n  const uploadImage = useCallback(\n    (file: Blob) =>\n      run(async () => {\n        const up = await client.media.uploadInline({ kind, id: need(), version: needVersion() }, 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, needVersion, 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    version,\n    setCover,\n    uploadImage,\n    imageSrc,\n    coverSrc: cover?.image ? imageSrc(cover.image) : (cover?.url ?? undefined),\n    text,\n    storedBody,\n  };\n}\n"],"mappings":"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"}

package/dist/react/context.d.ts

@@ -3,7 +3,7 @@ import { ContentKitError } from '../client/errors.js';
 import { ContentURLs } from '../urls/index.js';
 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;
+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" | "version.download" | 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" | "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. */

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  | \"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"}
+{"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  | \"version.download\"\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":";;;AAgGA,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

@@ -3,8 +3,14 @@ import { ContentKitError } from '../client/errors.js';
 import { Content, Decision, Version } from '../client/generated/wire.js';
 /** A content's live versions, first first. */
 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. */
+/**
+ * The version a reader of language opens by default: the first live one by
+ * position serving it, else the first live one. The server picks cards'
+ * versions, covers and meta by the same rule.
+ */
 export declare function defaultVersion(c: Content | null | undefined, language?: string): Version | null;
+/** defaultVersion among versions: the first by position serving language, else the first. */
+export declare function editionOf(versions: readonly Version[], 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 {

package/dist/react/detail.js

@@ -7,21 +7,24 @@ function o(e) {
 	return (e?.versions ?? []).filter((e) => e.live).sort((e, t) => e.position - t.position);
 }
 function s(e, t) {
-	let n = o(e);
-	return (t ? n.find((e) => e.languages.includes(t)) : void 0) ?? n[0] ?? null;
+	return c(o(e), t);
 }
 function c(e, t) {
+	let n = [...e].sort((e, t) => e.position - t.position);
+	return (t ? n.find((e) => e.languages.includes(t)) : void 0) ?? n[0] ?? null;
+}
+function l(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, _, {
+function u(r, c = {}) {
+	let { client: u, store: d, scope: f, language: p } = t(c.client), m = c.language ?? p, [h] = i({ location: c.location }), g = c.version === void 0 ? h : c.version, _ = r ? e("content-detail", f, r, m) : null, v = n(d, _, {
 		type: "content-detail",
 		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);
+		let e = o(y), t = l(e, g) ?? s(y, m);
 		return {
 			content: y,
 			versions: e,
@@ -44,6 +47,6 @@ function l(r, l = {}) {
 	]);
 }
 //#endregion
-export { s as defaultVersion, c as findVersion, o as liveVersions, l as useContentDetail };
+export { s as defaultVersion, c as editionOf, l as findVersion, o as liveVersions, u as useContentDetail };
 
 //# sourceMappingURL=detail.js.map