@openrails/contentkit-ui 0.79.0 → 0.81.0

package/dist/react/contents.js

@@ -0,0 +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 { 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), {
+		type: "contents",
+		scope: u.state === "deleted" ? "deleted" : void 0
+	}, r(d, (e, t) => o.contents.manage({
+		...u,
+		...e
+	}, t)));
+}
+var _ = (e) => [...new Set([...(e ?? "").matchAll(u())].map((e) => e[1]))], v = (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, {
+		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);
+		try {
+			return await D(e);
+		} finally {
+			E((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([]);
+	f(() => {
+		let e = P.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, [
+		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, {
+		editor: !0,
+		read: I ? void 0 : null,
+		client: b
+	}), H = t(B, {
+		editor: !0,
+		read: L.length ? void 0 : null,
+		client: b
+	}), U = p(() => [...V.read?.files ?? [], ...H.read?.files ?? []], [V.read, H.read]), W = p(() => {
+		let e = /* @__PURE__ */ new Map();
+		for (let t of U) t.upload && t.editor_url && e.set(v(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]);
+	f(() => {
+		if (!G) {
+			K.current = 0;
+			return;
+		}
+		if (K.current >= 6) return;
+		let e = setTimeout(() => {
+			K.current++, Y();
+		}, 1e3 * 2 ** K.current);
+		return () => clearTimeout(e);
+	}, [
+		G,
+		U,
+		Y
+	]);
+	let X = m(/* @__PURE__ */ new Map());
+	f(() => {
+		for (let e of [
+			N,
+			F,
+			W
+		]) for (let [t, n] of e) X.current.set(n, t);
+	}, [
+		N,
+		F,
+		W
+	]);
+	let Z = 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;
+	}, [
+		N,
+		F,
+		W
+	]), oe = p(() => A ? {
+		...A,
+		body: (A.body ?? "").replace(u(), (e, t) => N.get(t) ?? F.get(t) ?? W.get(t) ?? e)
+	} : void 0, [
+		A,
+		N,
+		F,
+		W
+	]), Q = d((e) => {
+		let t = new Map(X.current);
+		for (let e of [
+			N,
+			F,
+			W
+		]) 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) => {
+		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 : {
+		...e,
+		body: Q(e.body)
+	})), [
+		b,
+		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;
+	}), [
+		b,
+		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;
+	}), [
+		b,
+		O,
+		k,
+		a,
+		$
+	]);
+	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,
+		unpublish: de,
+		remove: fe,
+		restore: pe,
+		setCover: me,
+		uploadImage: he,
+		imageSrc: Z,
+		coverSrc: Z(M?.image),
+		text: oe,
+		storedBody: Q
+	};
+}
+//#endregion
+export { y as useContent, g as useManagedContents };
+
+//# sourceMappingURL=contents.js.map

package/dist/react/contents.js.map

@@ -0,0 +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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"}

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" | "post.save" | "moderation.load" | "moderation.resolve" | "taxonomy.load" | "taxonomy.save" | "media.save" | "notifications.load" | "notifications.read" | "notifications.dismiss";
+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";
 /** 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  | \"post.save\"\n  | \"moderation.load\"\n  | \"moderation.resolve\"\n  | \"taxonomy.load\"\n  | \"taxonomy.save\"\n  | \"media.save\"\n  | \"notifications.load\"\n  | \"notifications.read\"\n  | \"notifications.dismiss\";\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":";;;AAwFA,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  | \"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"}

package/dist/react/crop.js

@@ -1,29 +1,30 @@
 import { toContentKitError as e } from "../client/errors.js";
-import { useContentKitClient as t, useErrorReporter as n } from "./context.js";
-import { useCallback as r, useEffect as i, useRef as a, useState as o } from "react";
+import { itemKey as t } from "../client/media/ref.js";
+import { useContentKitClient as n, useErrorReporter as r } from "./context.js";
+import { useCallback as i, useEffect as a, useRef as o, useState as s } from "react";
 //#region src/react/crop.ts
-function s(s, c, l = {}) {
-	let { media: u } = t(l.client), d = n(l.onError), f = c ? `${s.kind}/${s.id}/${c}` : "", [p, m] = o(0), [h, g] = o({
+function c(c, l, u = {}) {
+	let { media: d } = n(u.client), f = r(u.onError), p = l ? `${t(c)}:${l}` : "", [m, h] = s(0), [g, _] = s({
 		key: "",
 		state: { status: "idle" }
-	}), _ = a({
-		o: l,
-		ref: s,
-		path: c
+	}), v = o({
+		o: u,
+		ref: c,
+		path: l
 	});
-	_.current = {
-		o: l,
-		ref: s,
-		path: c
-	}, i(() => {
-		let { ref: t, path: n } = _.current;
+	v.current = {
+		o: u,
+		ref: c,
+		path: l
+	}, a(() => {
+		let { ref: t, path: n } = v.current;
 		if (!n) return;
 		let r = new AbortController();
-		return g({
-			key: f,
+		return _({
+			key: p,
 			state: { status: "loading" }
-		}), u.editorView(t, n, { signal: r.signal }).then((e) => g({
-			key: f,
+		}), d.editorView(t, n, { signal: r.signal }).then((e) => _({
+			key: p,
 			state: {
 				status: "cropping",
 				source: {
@@ -36,27 +37,27 @@ function s(s, c, l = {}) {
 		}), (t) => {
 			if (r.signal.aborted) return;
 			let i = e(t);
-			g({
-				key: f,
+			_({
+				key: p,
 				state: {
 					status: "error",
 					error: i
 				}
-			}), d(i, "crop.load", n.split("/").pop());
+			}), f(i, "crop.load", n.split("/").pop());
 		}), () => r.abort();
 	}, [
-		u,
-		f,
+		d,
 		p,
-		d
+		m,
+		f
 	]);
-	let v = h.key === f ? h.state : { status: f ? "loading" : "idle" }, y = a(v);
-	y.current = v;
-	let b = r(async (t) => {
-		let n = y.current, { ref: r, path: i, o: a } = _.current, o = "source" in n ? n.source : void 0;
+	let y = g.key === p ? g.state : { status: p ? "loading" : "idle" }, b = o(y);
+	b.current = y;
+	let x = i(async (t) => {
+		let n = b.current, { ref: r, path: i, o: a } = v.current, o = "source" in n ? n.source : void 0;
 		if (i && o) {
-			g({
-				key: f,
+			_({
+				key: p,
 				state: {
 					status: "saving",
 					source: o,
@@ -64,13 +65,13 @@ function s(s, c, l = {}) {
 				}
 			});
 			try {
-				let e = await u.commit(r, [{
+				let e = await d.commit(r, [{
 					op: "edit",
 					path: i,
 					...t ? { edit: t } : {}
 				}]);
-				return a.wait && await u.waitFor(r, i), g({
-					key: f,
+				return a.wait && await d.waitFor(r, i), _({
+					key: p,
 					state: {
 						status: "done",
 						files: e
@@ -78,30 +79,30 @@ function s(s, c, l = {}) {
 				}), a.onSaved?.(e), e;
 			} catch (n) {
 				let r = e(n);
-				g({
-					key: f,
+				_({
+					key: p,
 					state: {
 						status: "error",
 						error: r,
 						source: o,
 						edit: t
 					}
-				}), d(r, "crop.save", i.split("/").pop());
+				}), f(r, "crop.save", i.split("/").pop());
 				return;
 			}
 		}
 	}, [
-		u,
-		f,
-		d
-	]), x = r(() => m((e) => e + 1), []);
+		d,
+		p,
+		f
+	]), S = i(() => h((e) => e + 1), []);
 	return {
-		...v,
-		save: b,
-		retry: x
+		...y,
+		save: x,
+		retry: S
 	};
 }
 //#endregion
-export { s as useEditorCrop };
+export { c as useEditorCrop };
 
 //# sourceMappingURL=crop.js.map

package/dist/react/crop.js.map

@@ -1 +1 @@
-{"version":3,"file":"crop.js","names":[],"sources":["../../src/react/crop.ts"],"sourcesContent":["import { useCallback, useEffect, useRef, useState } from \"react\";\nimport type { ContentKitClient } from \"../client/client.js\";\nimport { toContentKitError, type ContentKitError } from \"../client/errors.js\";\nimport type { Edit, FileInfo, RefBody } from \"../client/generated/wire.js\";\nimport type { CropSource } from \"../client/image.js\";\nimport { useContentKitClient, useErrorReporter, type ContentKitErrorHandler } from \"./context.js\";\n\nexport interface EditorCropOptions {\n  /** save() also waits until the worker rendered the edit. Default false (an editor read shows it processing). */\n  wait?: boolean;\n  /** With the item's uploads after each save. */\n  onSaved?: (files: FileInfo[]) => void;\n  /** Every failed load or save; default the provider's. */\n  onError?: ContentKitErrorHandler;\n  /** Overrides the provider's client. */\n  client?: ContentKitClient;\n}\n\n/** source is the upload's editor view and its oriented size; edit its current edit. */\nexport type EditorCropState =\n  | { status: \"idle\" }\n  | { status: \"loading\" }\n  | { status: \"cropping\"; source: CropSource; edit: Edit | null }\n  | { status: \"saving\"; source: CropSource; edit: Edit | null }\n  | { status: \"done\"; files: FileInfo[] }\n  | { status: \"error\"; error: ContentKitError; source?: CropSource; edit?: Edit | null };\n\nexport type UseEditorCrop = EditorCropState & {\n  /** Commits the edit (null removes it); resolves with the item's uploads, or undefined on failure. */\n  save: (edit: Edit | null) => Promise<FileInfo[] | undefined>;\n  /** Loads the editor view again after a failure. */\n  retry: () => void;\n};\n\n/**\n * Re-crops a kept upload: while path is set, its editor view (the original,\n * oriented, unedited) loads for a cropper; save() commits an edit op. Nothing\n * is uploaded. Clear path to close.\n */\nexport function useEditorCrop(ref: RefBody, path: string | null | undefined, o: EditorCropOptions = {}): UseEditorCrop {\n  const { media } = useContentKitClient(o.client);\n  const report = useErrorReporter(o.onError);\n  const key = path ? `${ref.kind}/${ref.id}/${path}` : \"\";\n  const [attempt, setAttempt] = useState(0);\n  const [s, setS] = useState<{ key: string; state: EditorCropState }>({ key: \"\", state: { status: \"idle\" } });\n  const opts = useRef({ o, ref, path });\n  opts.current = { o, ref, path };\n\n  useEffect(() => {\n    const { ref, path } = opts.current;\n    if (!path) return;\n    const ctl = new AbortController();\n    setS({ key, state: { status: \"loading\" } });\n    media.editorView(ref, path, { signal: ctl.signal }).then(\n      (v) => setS({ key, state: { status: \"cropping\", source: { url: v.url, width: v.width, height: v.height }, edit: v.edit ?? null } }),\n      (e: unknown) => {\n        if (ctl.signal.aborted) return;\n        const error = toContentKitError(e);\n        setS({ key, state: { status: \"error\", error } });\n        report(error, \"crop.load\", path.split(\"/\").pop());\n      },\n    );\n    return () => ctl.abort();\n  }, [media, key, attempt, report]);\n\n  const current = s.key === key ? s.state : ({ status: key ? \"loading\" : \"idle\" } as EditorCropState);\n  const now = useRef(current);\n  now.current = current;\n\n  const save = useCallback(\n    async (edit: Edit | null) => {\n      const c = now.current;\n      const { ref, path, o } = opts.current;\n      const source = \"source\" in c ? c.source : undefined;\n      if (!path || !source) return undefined;\n      setS({ key, state: { status: \"saving\", source, edit } });\n      try {\n        const files = await media.commit(ref, [{ op: \"edit\", path, ...(edit ? { edit } : {}) }]);\n        if (o.wait) await media.waitFor(ref, path);\n        setS({ key, state: { status: \"done\", files } });\n        o.onSaved?.(files);\n        return files;\n      } catch (e) {\n        const error = toContentKitError(e);\n        setS({ key, state: { status: \"error\", error, source, edit } });\n        report(error, \"crop.save\", path.split(\"/\").pop());\n        return undefined;\n      }\n    },\n    [media, key, report],\n  );\n  const retry = useCallback(() => setAttempt((n) => n + 1), []);\n  return { ...current, save, retry };\n}\n"],"mappings":";;;;AAuCA,SAAgB,EAAc,GAAc,GAAiC,IAAuB,CAAC,GAAkB;CACrH,IAAM,EAAE,aAAU,EAAoB,EAAE,MAAM,GACxC,IAAS,EAAiB,EAAE,OAAO,GACnC,IAAM,IAAO,GAAG,EAAI,KAAK,GAAG,EAAI,GAAG,GAAG,MAAS,IAC/C,CAAC,GAAS,KAAc,EAAS,CAAC,GAClC,CAAC,GAAG,KAAQ,EAAkD;EAAE,KAAK;EAAI,OAAO,EAAE,QAAQ,OAAO;CAAE,CAAC,GACpG,IAAO,EAAO;EAAE;EAAG;EAAK;CAAK,CAAC;CAGpC,AAFA,EAAK,UAAU;EAAE;EAAG;EAAK;CAAK,GAE9B,QAAgB;EACd,IAAM,EAAE,QAAK,YAAS,EAAK;EAC3B,IAAI,CAAC,GAAM;EACX,IAAM,IAAM,IAAI,gBAAgB;EAWhC,OAVA,EAAK;GAAE;GAAK,OAAO,EAAE,QAAQ,UAAU;EAAE,CAAC,GAC1C,EAAM,WAAW,GAAK,GAAM,EAAE,QAAQ,EAAI,OAAO,CAAC,CAAC,CAAC,MACjD,MAAM,EAAK;GAAE;GAAK,OAAO;IAAE,QAAQ;IAAY,QAAQ;KAAE,KAAK,EAAE;KAAK,OAAO,EAAE;KAAO,QAAQ,EAAE;IAAO;IAAG,MAAM,EAAE,QAAQ;GAAK;EAAE,CAAC,IACjI,MAAe;GACd,IAAI,EAAI,OAAO,SAAS;GACxB,IAAM,IAAQ,EAAkB,CAAC;GAEjC,AADA,EAAK;IAAE;IAAK,OAAO;KAAE,QAAQ;KAAS;IAAM;GAAE,CAAC,GAC/C,EAAO,GAAO,aAAa,EAAK,MAAM,GAAG,CAAC,CAAC,IAAI,CAAC;EAClD,CACF,SACa,EAAI,MAAM;CACzB,GAAG;EAAC;EAAO;EAAK;EAAS;CAAM,CAAC;CAEhC,IAAM,IAAU,EAAE,QAAQ,IAAM,EAAE,QAAS,EAAE,QAAQ,IAAM,YAAY,OAAO,GACxE,IAAM,EAAO,CAAO;CAC1B,EAAI,UAAU;CAEd,IAAM,IAAO,EACX,OAAO,MAAsB;EAC3B,IAAM,IAAI,EAAI,SACR,EAAE,QAAK,SAAM,SAAM,EAAK,SACxB,IAAS,YAAY,IAAI,EAAE,SAAS,KAAA;EACtC,IAAC,KAAS,GACd;KAAK;IAAE;IAAK,OAAO;KAAE,QAAQ;KAAU;KAAQ;IAAK;GAAE,CAAC;GACvD,IAAI;IACF,IAAM,IAAQ,MAAM,EAAM,OAAO,GAAK,CAAC;KAAE,IAAI;KAAQ;KAAM,GAAI,IAAO,EAAE,QAAK,IAAI,CAAC;IAAG,CAAC,CAAC;IAIvF,OAHI,EAAE,QAAM,MAAM,EAAM,QAAQ,GAAK,CAAI,GACzC,EAAK;KAAE;KAAK,OAAO;MAAE,QAAQ;MAAQ;KAAM;IAAE,CAAC,GAC9C,EAAE,UAAU,CAAK,GACV;GACT,SAAS,GAAG;IACV,IAAM,IAAQ,EAAkB,CAAC;IAEjC,AADA,EAAK;KAAE;KAAK,OAAO;MAAE,QAAQ;MAAS;MAAO;MAAQ;KAAK;IAAE,CAAC,GAC7D,EAAO,GAAO,aAAa,EAAK,MAAM,GAAG,CAAC,CAAC,IAAI,CAAC;IAChD;GACF;EAZuD;CAazD,GACA;EAAC;EAAO;EAAK;CAAM,CACrB,GACM,IAAQ,QAAkB,GAAY,MAAM,IAAI,CAAC,GAAG,CAAC,CAAC;CAC5D,OAAO;EAAE,GAAG;EAAS;EAAM;CAAM;AACnC"}
+{"version":3,"file":"crop.js","names":[],"sources":["../../src/react/crop.ts"],"sourcesContent":["import { useCallback, useEffect, useRef, useState } from \"react\";\nimport { itemKey } from \"../client/media/ref.js\";\nimport type { ContentKitClient } from \"../client/client.js\";\nimport { toContentKitError, type ContentKitError } from \"../client/errors.js\";\nimport type { Edit, FileInfo, RefBody } from \"../client/generated/wire.js\";\nimport type { CropSource } from \"../client/image.js\";\nimport { useContentKitClient, useErrorReporter, type ContentKitErrorHandler } from \"./context.js\";\n\nexport interface EditorCropOptions {\n  /** save() also waits until the worker rendered the edit. Default false (an editor read shows it processing). */\n  wait?: boolean;\n  /** With the item's uploads after each save. */\n  onSaved?: (files: FileInfo[]) => void;\n  /** Every failed load or save; default the provider's. */\n  onError?: ContentKitErrorHandler;\n  /** Overrides the provider's client. */\n  client?: ContentKitClient;\n}\n\n/** source is the upload's editor view and its oriented size; edit its current edit. */\nexport type EditorCropState =\n  | { status: \"idle\" }\n  | { status: \"loading\" }\n  | { status: \"cropping\"; source: CropSource; edit: Edit | null }\n  | { status: \"saving\"; source: CropSource; edit: Edit | null }\n  | { status: \"done\"; files: FileInfo[] }\n  | { status: \"error\"; error: ContentKitError; source?: CropSource; edit?: Edit | null };\n\nexport type UseEditorCrop = EditorCropState & {\n  /** Commits the edit (null removes it); resolves with the item's uploads, or undefined on failure. */\n  save: (edit: Edit | null) => Promise<FileInfo[] | undefined>;\n  /** Loads the editor view again after a failure. */\n  retry: () => void;\n};\n\n/**\n * Re-crops a kept upload: while path is set, its editor view (the original,\n * oriented, unedited) loads for a cropper; save() commits an edit op. Nothing\n * is uploaded. Clear path to close.\n */\nexport function useEditorCrop(ref: RefBody, path: string | null | undefined, o: EditorCropOptions = {}): UseEditorCrop {\n  const { media } = useContentKitClient(o.client);\n  const report = useErrorReporter(o.onError);\n  const key = path ? `${itemKey(ref)}:${path}` : \"\";\n  const [attempt, setAttempt] = useState(0);\n  const [s, setS] = useState<{ key: string; state: EditorCropState }>({ key: \"\", state: { status: \"idle\" } });\n  const opts = useRef({ o, ref, path });\n  opts.current = { o, ref, path };\n\n  useEffect(() => {\n    const { ref, path } = opts.current;\n    if (!path) return;\n    const ctl = new AbortController();\n    setS({ key, state: { status: \"loading\" } });\n    media.editorView(ref, path, { signal: ctl.signal }).then(\n      (v) => setS({ key, state: { status: \"cropping\", source: { url: v.url, width: v.width, height: v.height }, edit: v.edit ?? null } }),\n      (e: unknown) => {\n        if (ctl.signal.aborted) return;\n        const error = toContentKitError(e);\n        setS({ key, state: { status: \"error\", error } });\n        report(error, \"crop.load\", path.split(\"/\").pop());\n      },\n    );\n    return () => ctl.abort();\n  }, [media, key, attempt, report]);\n\n  const current = s.key === key ? s.state : ({ status: key ? \"loading\" : \"idle\" } as EditorCropState);\n  const now = useRef(current);\n  now.current = current;\n\n  const save = useCallback(\n    async (edit: Edit | null) => {\n      const c = now.current;\n      const { ref, path, o } = opts.current;\n      const source = \"source\" in c ? c.source : undefined;\n      if (!path || !source) return undefined;\n      setS({ key, state: { status: \"saving\", source, edit } });\n      try {\n        const files = await media.commit(ref, [{ op: \"edit\", path, ...(edit ? { edit } : {}) }]);\n        if (o.wait) await media.waitFor(ref, path);\n        setS({ key, state: { status: \"done\", files } });\n        o.onSaved?.(files);\n        return files;\n      } catch (e) {\n        const error = toContentKitError(e);\n        setS({ key, state: { status: \"error\", error, source, edit } });\n        report(error, \"crop.save\", path.split(\"/\").pop());\n        return undefined;\n      }\n    },\n    [media, key, report],\n  );\n  const retry = useCallback(() => setAttempt((n) => n + 1), []);\n  return { ...current, save, retry };\n}\n"],"mappings":";;;;;AAwCA,SAAgB,EAAc,GAAc,GAAiC,IAAuB,CAAC,GAAkB;CACrH,IAAM,EAAE,aAAU,EAAoB,EAAE,MAAM,GACxC,IAAS,EAAiB,EAAE,OAAO,GACnC,IAAM,IAAO,GAAG,EAAQ,CAAG,EAAE,GAAG,MAAS,IACzC,CAAC,GAAS,KAAc,EAAS,CAAC,GAClC,CAAC,GAAG,KAAQ,EAAkD;EAAE,KAAK;EAAI,OAAO,EAAE,QAAQ,OAAO;CAAE,CAAC,GACpG,IAAO,EAAO;EAAE;EAAG;EAAK;CAAK,CAAC;CAGpC,AAFA,EAAK,UAAU;EAAE;EAAG;EAAK;CAAK,GAE9B,QAAgB;EACd,IAAM,EAAE,QAAK,YAAS,EAAK;EAC3B,IAAI,CAAC,GAAM;EACX,IAAM,IAAM,IAAI,gBAAgB;EAWhC,OAVA,EAAK;GAAE;GAAK,OAAO,EAAE,QAAQ,UAAU;EAAE,CAAC,GAC1C,EAAM,WAAW,GAAK,GAAM,EAAE,QAAQ,EAAI,OAAO,CAAC,CAAC,CAAC,MACjD,MAAM,EAAK;GAAE;GAAK,OAAO;IAAE,QAAQ;IAAY,QAAQ;KAAE,KAAK,EAAE;KAAK,OAAO,EAAE;KAAO,QAAQ,EAAE;IAAO;IAAG,MAAM,EAAE,QAAQ;GAAK;EAAE,CAAC,IACjI,MAAe;GACd,IAAI,EAAI,OAAO,SAAS;GACxB,IAAM,IAAQ,EAAkB,CAAC;GAEjC,AADA,EAAK;IAAE;IAAK,OAAO;KAAE,QAAQ;KAAS;IAAM;GAAE,CAAC,GAC/C,EAAO,GAAO,aAAa,EAAK,MAAM,GAAG,CAAC,CAAC,IAAI,CAAC;EAClD,CACF,SACa,EAAI,MAAM;CACzB,GAAG;EAAC;EAAO;EAAK;EAAS;CAAM,CAAC;CAEhC,IAAM,IAAU,EAAE,QAAQ,IAAM,EAAE,QAAS,EAAE,QAAQ,IAAM,YAAY,OAAO,GACxE,IAAM,EAAO,CAAO;CAC1B,EAAI,UAAU;CAEd,IAAM,IAAO,EACX,OAAO,MAAsB;EAC3B,IAAM,IAAI,EAAI,SACR,EAAE,QAAK,SAAM,SAAM,EAAK,SACxB,IAAS,YAAY,IAAI,EAAE,SAAS,KAAA;EACtC,IAAC,KAAS,GACd;KAAK;IAAE;IAAK,OAAO;KAAE,QAAQ;KAAU;KAAQ;IAAK;GAAE,CAAC;GACvD,IAAI;IACF,IAAM,IAAQ,MAAM,EAAM,OAAO,GAAK,CAAC;KAAE,IAAI;KAAQ;KAAM,GAAI,IAAO,EAAE,QAAK,IAAI,CAAC;IAAG,CAAC,CAAC;IAIvF,OAHI,EAAE,QAAM,MAAM,EAAM,QAAQ,GAAK,CAAI,GACzC,EAAK;KAAE;KAAK,OAAO;MAAE,QAAQ;MAAQ;KAAM;IAAE,CAAC,GAC9C,EAAE,UAAU,CAAK,GACV;GACT,SAAS,GAAG;IACV,IAAM,IAAQ,EAAkB,CAAC;IAEjC,AADA,EAAK;KAAE;KAAK,OAAO;MAAE,QAAQ;MAAS;MAAO;MAAQ;KAAK;IAAE,CAAC,GAC7D,EAAO,GAAO,aAAa,EAAK,MAAM,GAAG,CAAC,CAAC,IAAI,CAAC;IAChD;GACF;EAZuD;CAazD,GACA;EAAC;EAAO;EAAK;CAAM,CACrB,GACM,IAAQ,QAAkB,GAAY,MAAM,IAAI,CAAC,GAAG,CAAC,CAAC;CAC5D,OAAO;EAAE,GAAG;EAAS;EAAM;CAAM;AACnC"}

package/dist/react/detail.d.ts

@@ -0,0 +1,30 @@
+import { ContentKitClient } from '../client/client.js';
+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. */
+export declare function defaultVersion(c: Content | null | undefined, language?: string): Version | null;
+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. */
+    version: Version | null;
+    /** The shown version's access decision: allowed, what is sold, previews. */
+    decision: Decision | null;
+    /** Every language a live version serves, in version order. */
+    languages: string[];
+    loading: boolean;
+    error?: ContentKitError;
+    reload: () => void;
+}
+/**
+ * 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;

package/dist/react/detail.js

@@ -0,0 +1,42 @@
+import { keyOf as e, useContentScope as t, useResource as n } from "./use-resource.js";
+import { useMemo as r } from "react";
+//#region src/react/detail.ts
+function i(e) {
+	return (e?.versions ?? []).filter((e) => e.live).sort((e, t) => e.position - t.position);
+}
+function a(e, t) {
+	let n = i(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, {
+		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);
+		return {
+			content: h,
+			versions: e,
+			version: t,
+			decision: t?.decision ?? h?.decision ?? null,
+			languages: [...new Set(e.flatMap((e) => e.languages))],
+			loading: !!p && (m.loading || !m.loaded),
+			error: m.error,
+			reload: m.reload
+		};
+	}, [
+		h,
+		s.version,
+		f,
+		p,
+		m.loading,
+		m.loaded,
+		m.error,
+		m.reload
+	]);
+}
+//#endregion
+export { a as defaultVersion, i as liveVersions, o as useContentDetail };
+
+//# sourceMappingURL=detail.js.map

package/dist/react/detail.js.map

@@ -0,0 +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"}