@openrails/contentkit-ui 0.79.0 → 0.81.0

package/dist/react/upload.js

@@ -1,38 +1,39 @@
 import { toContentKitError as e } from "../client/errors.js";
 import { ratio as t } from "../client/aspect.js";
-import { centeredCrop as n, constrainCrop as r, editOf as i, rotation as a, sameEdit as o, toOriginal as s } from "../client/crop.js";
-import { encodeRemaining as c } from "../client/media/encode.js";
-import { ItemUploadQueue as l } from "../client/media/queue.js";
-import { useContentKitClient as u } from "./context.js";
-import { useCallback as d, useEffect as f, useMemo as p, useRef as m, useState as h, useSyncExternalStore as g } from "react";
+import { itemKey as n } from "../client/media/ref.js";
+import { centeredCrop as r, constrainCrop as i, editOf as a, rotation as o, sameEdit as s, toOriginal as c } from "../client/crop.js";
+import { encodeRemaining as l } from "../client/media/encode.js";
+import { ItemUploadQueue as u } from "../client/media/queue.js";
+import { useContentKitClient as d } from "./context.js";
+import { useCallback as f, useEffect as p, useMemo as m, useRef as h, useState as g, useSyncExternalStore as _ } from "react";
 //#region src/react/upload.ts
-function _({ client: e, ...t }) {
-	let n = u(e), r = `${t.ref.kind}/${t.ref.id}`, i = () => ({
-		key: r,
-		queue: new l(n.media, {
+function v({ client: e, ...t }) {
+	let r = d(e), i = n(t.ref), a = () => ({
+		key: i,
+		queue: new u(r.media, {
 			...t,
 			autoStart: !1
 		})
-	}), [a, o] = h(i);
-	a.key !== r && o(i());
-	let { queue: s } = a, c = t.autoStart ?? !0;
-	return f(() => (c && s.start(), () => s.pause()), [s, c]), {
-		...g(s.subscribe, s.getSnapshot, s.getSnapshot),
-		queue: s,
-		add: s.add.bind(s),
-		move: s.move.bind(s),
-		update: s.update.bind(s),
-		remove: s.remove.bind(s),
-		retry: s.retry.bind(s),
-		start: s.start.bind(s),
-		pause: s.pause.bind(s),
-		commit: s.commit.bind(s)
+	}), [o, s] = g(a);
+	o.key !== i && s(a());
+	let { queue: c } = o, l = t.autoStart ?? !0;
+	return p(() => (l && c.start(), () => c.pause()), [c, l]), {
+		..._(c.subscribe, c.getSnapshot, c.getSnapshot),
+		queue: c,
+		add: c.add.bind(c),
+		move: c.move.bind(c),
+		update: c.update.bind(c),
+		remove: c.remove.bind(c),
+		retry: c.retry.bind(c),
+		start: c.start.bind(c),
+		pause: c.pause.bind(c),
+		commit: c.commit.bind(c)
 	};
 }
-function v({ client: t } = {}) {
-	let { media: n } = u(t), [r, i] = h({ status: "idle" }), a = m(null);
-	f(() => () => a.current?.abort(), []);
-	let o = d(async (t, { put: r, ...o }) => {
+function y({ client: t } = {}) {
+	let { media: n } = d(t), [r, i] = g({ status: "idle" }), a = h(null);
+	p(() => () => a.current?.abort(), []);
+	let o = f(async (t, { put: r, ...o }) => {
 		a.current?.abort();
 		let s = a.current = new AbortController();
 		i({ status: "uploading" });
@@ -69,55 +70,55 @@ function v({ client: t } = {}) {
 				error: n
 			}), n;
 		}
-	}, [n]), s = d(() => a.current?.abort(), []);
+	}, [n]), s = f(() => a.current?.abort(), []);
 	return {
 		...r,
 		upload: o,
 		cancel: s
 	};
 }
-function y({ source: e, aspect: c, initial: l }) {
-	let u = t(c), { width: f, height: g } = e, _ = p(() => ({
-		width: f,
-		height: g
-	}), [f, g]), [v, y] = h(() => {
-		let e = a(l?.rotate ?? 0), t = l?.crop;
-		return [t ? r(t, _, u, e) : n(_, u, e), e];
-	}), [b, x] = v, S = d((e) => y((t) => {
+function b({ source: e, aspect: n, initial: l }) {
+	let u = t(n), { width: d, height: p } = e, _ = m(() => ({
+		width: d,
+		height: p
+	}), [d, p]), [v, y] = g(() => {
+		let e = o(l?.rotate ?? 0), t = l?.crop;
+		return [t ? i(t, _, u, e) : r(_, u, e), e];
+	}), [b, x] = v, S = f((e) => y((t) => {
 		let n = typeof e == "function" ? e(t) : e;
-		return o({
+		return s({
 			crop: n[0],
 			rotate: n[1]
 		}, {
 			crop: t[0],
 			rotate: t[1]
 		}) ? t : n;
-	}), []), C = d((e) => S(([, t]) => [r(e, _, u, t), t]), [
+	}), []), C = f((e) => S(([, t]) => [i(e, _, u, t), t]), [
 		S,
 		_,
 		u
-	]), w = d((e, t) => S(([, n]) => [r(s(e, t, _, n), _, u, n), n]), [
+	]), w = f((e, t) => S(([, n]) => [i(c(e, t, _, n), _, u, n), n]), [
 		S,
 		_,
 		u
-	]), T = d((e) => S(([t, n]) => {
-		let i = a(n + e);
-		return [r(t, _, u, i), i];
+	]), T = f((e) => S(([t, n]) => {
+		let r = o(n + e);
+		return [i(t, _, u, r), r];
 	}), [
 		S,
 		_,
 		u
-	]), E = d(() => S([n(_, u), 0]), [
+	]), E = f(() => S([r(_, u), 0]), [
 		S,
 		_,
 		u
-	]), D = m(null);
+	]), D = h(null);
 	return {
 		crop: b,
 		rotate: x,
-		edit: p(() => {
-			let e = i(b, _, x);
-			return o(e, D.current) ? D.current : D.current = e;
+		edit: m(() => {
+			let e = a(b, _, x);
+			return s(e, D.current) ? D.current : D.current = e;
 		}, [
 			b,
 			_,
@@ -129,8 +130,8 @@ function y({ source: e, aspect: c, initial: l }) {
 		reset: E
 	};
 }
-function b(e) {
-	let [t, n] = h(() => ({
+function x(e) {
+	let [t, n] = g(() => ({
 		at: e?.at,
 		received: Date.now()
 	}));
@@ -138,18 +139,18 @@ function b(e) {
 		at: e?.at,
 		received: Date.now()
 	});
-	let [r, i] = h(() => Date.now()), a = !!e?.eta && !e.stalled;
-	return f(() => {
+	let [r, i] = g(() => Date.now()), a = !!e?.eta && !e.stalled;
+	return p(() => {
 		if (!a) return;
 		i(Date.now());
 		let e = setInterval(() => i(Date.now()), 1e3);
 		return () => clearInterval(e);
 	}, [a, t]), {
 		progress: e ?? void 0,
-		remaining: c(e, t.received, Math.max(r, t.received))
+		remaining: l(e, t.received, Math.max(r, t.received))
 	};
 }
 //#endregion
-export { y as useCrop, b as useEncodeProgress, v as useUpload, _ as useUploadQueue };
+export { b as useCrop, x as useEncodeProgress, y as useUpload, v as useUploadQueue };
 
 //# sourceMappingURL=upload.js.map

package/dist/react/upload.js.map

@@ -1 +1 @@
-{"version":3,"file":"upload.js","names":[],"sources":["../../src/react/upload.ts"],"sourcesContent":["import { useCallback, useEffect, useMemo, useRef, useState, useSyncExternalStore } from \"react\";\nimport { ratio, type AspectRatio } from \"../client/aspect.js\";\nimport type { ContentKitClient } from \"../client/client.js\";\nimport { centeredCrop, constrainCrop, editOf, rotation, sameEdit, toOriginal, type Rotation, type Size } from \"../client/crop.js\";\nimport { toContentKitError, type ContentKitError } from \"../client/errors.js\";\nimport type { Crop, Edit, EncodeProgress, FileInfo } from \"../client/generated/wire.js\";\nimport type { Progress, PutOptions, UploadedFile, UploadOptions } from \"../client/media/client.js\";\nimport { encodeRemaining } from \"../client/media/encode.js\";\nimport { ItemUploadQueue, type QueueOptions, type QueueSnapshot } from \"../client/media/queue.js\";\nimport { useContentKitClient } from \"./context.js\";\n\nexport interface UseUploadQueue extends QueueSnapshot {\n  queue: ItemUploadQueue;\n  add: ItemUploadQueue[\"add\"];\n  move: ItemUploadQueue[\"move\"];\n  update: ItemUploadQueue[\"update\"];\n  remove: ItemUploadQueue[\"remove\"];\n  retry: ItemUploadQueue[\"retry\"];\n  start: ItemUploadQueue[\"start\"];\n  pause: ItemUploadQueue[\"pause\"];\n  commit: ItemUploadQueue[\"commit\"];\n}\n\nexport interface UploadQueueOptions extends QueueOptions {\n  /** Overrides the provider's client. */\n  client?: ContentKitClient;\n}\n\n/**\n * A file queue for one item: another ref gets a fresh queue and the previous\n * one pauses (the other options are read once per queue). Unmounting pauses\n * running uploads.\n */\nexport function useUploadQueue({ client: own, ...options }: UploadQueueOptions): UseUploadQueue {\n  const client = useContentKitClient(own);\n  const key = `${options.ref.kind}/${options.ref.id}`;\n  const open = () => ({ key, queue: new ItemUploadQueue(client.media, { ...options, autoStart: false }) });\n  const [current, setCurrent] = useState(open);\n  if (current.key !== key) setCurrent(open());\n  const { queue } = current;\n  const autoStart = options.autoStart ?? true;\n  useEffect(() => {\n    if (autoStart) queue.start();\n    return () => queue.pause();\n  }, [queue, autoStart]);\n  const snap = useSyncExternalStore(queue.subscribe, queue.getSnapshot, queue.getSnapshot);\n  return {\n    ...snap,\n    queue,\n    add: queue.add.bind(queue),\n    move: queue.move.bind(queue),\n    update: queue.update.bind(queue),\n    remove: queue.remove.bind(queue),\n    retry: queue.retry.bind(queue),\n    start: queue.start.bind(queue),\n    pause: queue.pause.bind(queue),\n    commit: queue.commit.bind(queue),\n  };\n}\n\nexport interface UploadStatus {\n  status: \"idle\" | \"uploading\" | \"done\" | \"error\";\n  progress?: Progress;\n  error?: ContentKitError;\n  result?: UploadedFile & { file?: FileInfo };\n}\n\nexport interface UseUpload extends UploadStatus {\n  /**\n   * Uploads one file; with put it also commits it to its path (put's edit,\n   * meta and index) and waits until it is processed (result.file).\n   */\n  upload: (file: File, opts: Omit<UploadOptions, \"signal\" | \"onProgress\"> & { put?: PutOptions }) => Promise<UploadedFile & { file?: FileInfo }>;\n  cancel: () => void;\n}\n\n/** One upload at a time (a cover, an inline image); a new upload cancels the previous. */\nexport function useUpload({ client: own }: { client?: ContentKitClient } = {}): UseUpload {\n  const { media } = useContentKitClient(own);\n  const [s, set] = useState<UploadStatus>({ status: \"idle\" });\n  const ctl = useRef<AbortController | null>(null);\n  useEffect(() => () => ctl.current?.abort(), []);\n\n  const upload = useCallback<UseUpload[\"upload\"]>(\n    async (file, { put, ...opts }) => {\n      ctl.current?.abort();\n      const c = (ctl.current = new AbortController());\n      set({ status: \"uploading\" });\n      const o: UploadOptions = {\n        ...opts,\n        signal: c.signal,\n        onProgress: (progress) => c === ctl.current && set({ status: \"uploading\", progress }),\n      };\n      try {\n        let result: UploadedFile & { file?: FileInfo };\n        if (put) {\n          let up: UploadedFile | undefined;\n          const f = await media.put(file, { ...o, ...put, onUploaded: (u) => (up = u) });\n          result = { ...up!, file: f };\n        } else result = await media.upload(file, o);\n        if (c === ctl.current) set((prev) => ({ status: \"done\", progress: prev.progress, result }));\n        return result;\n      } catch (e) {\n        const error = toContentKitError(e);\n        if (c === ctl.current) set(error.code === \"aborted\" ? { status: \"idle\" } : { status: \"error\", error });\n        throw error;\n      }\n    },\n    [media],\n  );\n  const cancel = useCallback(() => ctl.current?.abort(), []);\n  return { ...s, upload, cancel };\n}\n\nexport interface UseCropOptions {\n  /** The upload's size (an editor read's w and h). */\n  source: Size;\n  /** The edited image's \"W:H\", e.g. the public preset's aspect; \"\" or omitted is free. */\n  aspect?: AspectRatio;\n  /** The current edit to start from. */\n  initial?: Edit | null;\n}\n\nexport interface UseCrop {\n  /** In original pixels, inside the source and at the aspect. */\n  crop: Crop;\n  rotate: Rotation;\n  /** Ready for an edit or put op; null when nothing changes. Its identity changes only with its value. */\n  edit: Edit | null;\n  /** A rect in original pixels. */\n  setCrop: (rect: Crop) => void;\n  /** A rect on the image as displayed (after the rotation) at display size: a cropper's output. */\n  setFromDisplay: (rect: Crop, display: Size) => void;\n  /** Turns clockwise by deg (a multiple of 90); the crop keeps the aspect. */\n  rotateBy: (deg: number) => void;\n  reset: () => void;\n}\n\n/** Headless crop state for any cropper UI: a rect in original pixels, a rotation and the resulting edit. */\nexport function useCrop({ source: given, aspect: shape, initial }: UseCropOptions): UseCrop {\n  const aspect = ratio(shape);\n  const { width, height } = given;\n  const source = useMemo(() => ({ width, height }), [width, height]);\n  const start = (): [Crop, Rotation] => {\n    const rotate = rotation(initial?.rotate ?? 0);\n    const c = initial?.crop;\n    return [c ? constrainCrop(c, source, aspect, rotate) : centeredCrop(source, aspect, rotate), rotate];\n  };\n  const [state, setState] = useState(start);\n  const [crop, rotate] = state;\n  const set = useCallback(\n    (next: [Crop, Rotation] | ((s: [Crop, Rotation]) => [Crop, Rotation])) =>\n      setState((s) => {\n        const n = typeof next === \"function\" ? next(s) : next;\n        return sameEdit({ crop: n[0], rotate: n[1] }, { crop: s[0], rotate: s[1] }) ? s : n;\n      }),\n    [],\n  );\n  const setCrop = useCallback((r: Crop) => set(([, rot]) => [constrainCrop(r, source, aspect, rot), rot]), [set, source, aspect]);\n  const setFromDisplay = useCallback(\n    (r: Crop, display: Size) => set(([, rot]) => [constrainCrop(toOriginal(r, display, source, rot), source, aspect, rot), rot]),\n    [set, source, aspect],\n  );\n  const rotateBy = useCallback(\n    (deg: number) =>\n      set(([c, rot]) => {\n        const next = rotation(rot + deg);\n        return [constrainCrop(c, source, aspect, next), next];\n      }),\n    [set, source, aspect],\n  );\n  const reset = useCallback(() => set([centeredCrop(source, aspect), 0]), [set, source, aspect]);\n  const last = useRef<Edit | null>(null);\n  const edit = useMemo(() => {\n    const e = editOf(crop, source, rotate);\n    return sameEdit(e, last.current) ? last.current : (last.current = e);\n  }, [crop, source, rotate]);\n  return { crop, rotate, edit, setCrop, setFromDisplay, rotateBy, reset };\n}\n\nexport interface UseEncodeProgress {\n  progress?: EncodeProgress;\n  /** Seconds left, counting down each second between reports; undefined while unknown. */\n  remaining?: number;\n}\n\n/**\n * A pending video file's encode progress from the read API (`files[i].progress`),\n * with the ETA counted down locally between polls.\n */\nexport function useEncodeProgress(progress?: EncodeProgress | null): UseEncodeProgress {\n  const [base, setBase] = useState(() => ({ at: progress?.at, received: Date.now() }));\n  if (progress?.at !== base.at) setBase({ at: progress?.at, received: Date.now() });\n  const [now, setNow] = useState(() => Date.now());\n  const ticking = !!progress?.eta && !progress.stalled;\n  useEffect(() => {\n    if (!ticking) return;\n    setNow(Date.now());\n    const id = setInterval(() => setNow(Date.now()), 1000);\n    return () => clearInterval(id);\n  }, [ticking, base]);\n  return { progress: progress ?? undefined, remaining: encodeRemaining(progress, base.received, Math.max(now, base.received)) };\n}\n"],"mappings":"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"}
+{"version":3,"file":"upload.js","names":[],"sources":["../../src/react/upload.ts"],"sourcesContent":["import { useCallback, useEffect, useMemo, useRef, useState, useSyncExternalStore } from \"react\";\nimport { itemKey } from \"../client/media/ref.js\";\nimport { ratio, type AspectRatio } from \"../client/aspect.js\";\nimport type { ContentKitClient } from \"../client/client.js\";\nimport { centeredCrop, constrainCrop, editOf, rotation, sameEdit, toOriginal, type Rotation, type Size } from \"../client/crop.js\";\nimport { toContentKitError, type ContentKitError } from \"../client/errors.js\";\nimport type { Crop, Edit, EncodeProgress, FileInfo } from \"../client/generated/wire.js\";\nimport type { Progress, PutOptions, UploadedFile, UploadOptions } from \"../client/media/client.js\";\nimport { encodeRemaining } from \"../client/media/encode.js\";\nimport { ItemUploadQueue, type QueueOptions, type QueueSnapshot } from \"../client/media/queue.js\";\nimport { useContentKitClient } from \"./context.js\";\n\nexport interface UseUploadQueue extends QueueSnapshot {\n  queue: ItemUploadQueue;\n  add: ItemUploadQueue[\"add\"];\n  move: ItemUploadQueue[\"move\"];\n  update: ItemUploadQueue[\"update\"];\n  remove: ItemUploadQueue[\"remove\"];\n  retry: ItemUploadQueue[\"retry\"];\n  start: ItemUploadQueue[\"start\"];\n  pause: ItemUploadQueue[\"pause\"];\n  commit: ItemUploadQueue[\"commit\"];\n}\n\nexport interface UploadQueueOptions extends QueueOptions {\n  /** Overrides the provider's client. */\n  client?: ContentKitClient;\n}\n\n/**\n * A file queue for one item: another ref gets a fresh queue and the previous\n * one pauses (the other options are read once per queue). Unmounting pauses\n * running uploads.\n */\nexport function useUploadQueue({ client: own, ...options }: UploadQueueOptions): UseUploadQueue {\n  const client = useContentKitClient(own);\n  const key = itemKey(options.ref);\n  const open = () => ({ key, queue: new ItemUploadQueue(client.media, { ...options, autoStart: false }) });\n  const [current, setCurrent] = useState(open);\n  if (current.key !== key) setCurrent(open());\n  const { queue } = current;\n  const autoStart = options.autoStart ?? true;\n  useEffect(() => {\n    if (autoStart) queue.start();\n    return () => queue.pause();\n  }, [queue, autoStart]);\n  const snap = useSyncExternalStore(queue.subscribe, queue.getSnapshot, queue.getSnapshot);\n  return {\n    ...snap,\n    queue,\n    add: queue.add.bind(queue),\n    move: queue.move.bind(queue),\n    update: queue.update.bind(queue),\n    remove: queue.remove.bind(queue),\n    retry: queue.retry.bind(queue),\n    start: queue.start.bind(queue),\n    pause: queue.pause.bind(queue),\n    commit: queue.commit.bind(queue),\n  };\n}\n\nexport interface UploadStatus {\n  status: \"idle\" | \"uploading\" | \"done\" | \"error\";\n  progress?: Progress;\n  error?: ContentKitError;\n  result?: UploadedFile & { file?: FileInfo };\n}\n\nexport interface UseUpload extends UploadStatus {\n  /**\n   * Uploads one file; with put it also commits it to its path (put's edit,\n   * meta and index) and waits until it is processed (result.file).\n   */\n  upload: (file: File, opts: Omit<UploadOptions, \"signal\" | \"onProgress\"> & { put?: PutOptions }) => Promise<UploadedFile & { file?: FileInfo }>;\n  cancel: () => void;\n}\n\n/** One upload at a time (a cover, an inline image); a new upload cancels the previous. */\nexport function useUpload({ client: own }: { client?: ContentKitClient } = {}): UseUpload {\n  const { media } = useContentKitClient(own);\n  const [s, set] = useState<UploadStatus>({ status: \"idle\" });\n  const ctl = useRef<AbortController | null>(null);\n  useEffect(() => () => ctl.current?.abort(), []);\n\n  const upload = useCallback<UseUpload[\"upload\"]>(\n    async (file, { put, ...opts }) => {\n      ctl.current?.abort();\n      const c = (ctl.current = new AbortController());\n      set({ status: \"uploading\" });\n      const o: UploadOptions = {\n        ...opts,\n        signal: c.signal,\n        onProgress: (progress) => c === ctl.current && set({ status: \"uploading\", progress }),\n      };\n      try {\n        let result: UploadedFile & { file?: FileInfo };\n        if (put) {\n          let up: UploadedFile | undefined;\n          const f = await media.put(file, { ...o, ...put, onUploaded: (u) => (up = u) });\n          result = { ...up!, file: f };\n        } else result = await media.upload(file, o);\n        if (c === ctl.current) set((prev) => ({ status: \"done\", progress: prev.progress, result }));\n        return result;\n      } catch (e) {\n        const error = toContentKitError(e);\n        if (c === ctl.current) set(error.code === \"aborted\" ? { status: \"idle\" } : { status: \"error\", error });\n        throw error;\n      }\n    },\n    [media],\n  );\n  const cancel = useCallback(() => ctl.current?.abort(), []);\n  return { ...s, upload, cancel };\n}\n\nexport interface UseCropOptions {\n  /** The upload's size (an editor read's w and h). */\n  source: Size;\n  /** The edited image's \"W:H\", e.g. the public preset's aspect; \"\" or omitted is free. */\n  aspect?: AspectRatio;\n  /** The current edit to start from. */\n  initial?: Edit | null;\n}\n\nexport interface UseCrop {\n  /** In original pixels, inside the source and at the aspect. */\n  crop: Crop;\n  rotate: Rotation;\n  /** Ready for an edit or put op; null when nothing changes. Its identity changes only with its value. */\n  edit: Edit | null;\n  /** A rect in original pixels. */\n  setCrop: (rect: Crop) => void;\n  /** A rect on the image as displayed (after the rotation) at display size: a cropper's output. */\n  setFromDisplay: (rect: Crop, display: Size) => void;\n  /** Turns clockwise by deg (a multiple of 90); the crop keeps the aspect. */\n  rotateBy: (deg: number) => void;\n  reset: () => void;\n}\n\n/** Headless crop state for any cropper UI: a rect in original pixels, a rotation and the resulting edit. */\nexport function useCrop({ source: given, aspect: shape, initial }: UseCropOptions): UseCrop {\n  const aspect = ratio(shape);\n  const { width, height } = given;\n  const source = useMemo(() => ({ width, height }), [width, height]);\n  const start = (): [Crop, Rotation] => {\n    const rotate = rotation(initial?.rotate ?? 0);\n    const c = initial?.crop;\n    return [c ? constrainCrop(c, source, aspect, rotate) : centeredCrop(source, aspect, rotate), rotate];\n  };\n  const [state, setState] = useState(start);\n  const [crop, rotate] = state;\n  const set = useCallback(\n    (next: [Crop, Rotation] | ((s: [Crop, Rotation]) => [Crop, Rotation])) =>\n      setState((s) => {\n        const n = typeof next === \"function\" ? next(s) : next;\n        return sameEdit({ crop: n[0], rotate: n[1] }, { crop: s[0], rotate: s[1] }) ? s : n;\n      }),\n    [],\n  );\n  const setCrop = useCallback((r: Crop) => set(([, rot]) => [constrainCrop(r, source, aspect, rot), rot]), [set, source, aspect]);\n  const setFromDisplay = useCallback(\n    (r: Crop, display: Size) => set(([, rot]) => [constrainCrop(toOriginal(r, display, source, rot), source, aspect, rot), rot]),\n    [set, source, aspect],\n  );\n  const rotateBy = useCallback(\n    (deg: number) =>\n      set(([c, rot]) => {\n        const next = rotation(rot + deg);\n        return [constrainCrop(c, source, aspect, next), next];\n      }),\n    [set, source, aspect],\n  );\n  const reset = useCallback(() => set([centeredCrop(source, aspect), 0]), [set, source, aspect]);\n  const last = useRef<Edit | null>(null);\n  const edit = useMemo(() => {\n    const e = editOf(crop, source, rotate);\n    return sameEdit(e, last.current) ? last.current : (last.current = e);\n  }, [crop, source, rotate]);\n  return { crop, rotate, edit, setCrop, setFromDisplay, rotateBy, reset };\n}\n\nexport interface UseEncodeProgress {\n  progress?: EncodeProgress;\n  /** Seconds left, counting down each second between reports; undefined while unknown. */\n  remaining?: number;\n}\n\n/**\n * A pending video file's encode progress from the read API (`files[i].progress`),\n * with the ETA counted down locally between polls.\n */\nexport function useEncodeProgress(progress?: EncodeProgress | null): UseEncodeProgress {\n  const [base, setBase] = useState(() => ({ at: progress?.at, received: Date.now() }));\n  if (progress?.at !== base.at) setBase({ at: progress?.at, received: Date.now() });\n  const [now, setNow] = useState(() => Date.now());\n  const ticking = !!progress?.eta && !progress.stalled;\n  useEffect(() => {\n    if (!ticking) return;\n    setNow(Date.now());\n    const id = setInterval(() => setNow(Date.now()), 1000);\n    return () => clearInterval(id);\n  }, [ticking, base]);\n  return { progress: progress ?? undefined, remaining: encodeRemaining(progress, base.received, Math.max(now, base.received)) };\n}\n"],"mappings":"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"}

package/dist/react/use-resource.d.ts

@@ -1,12 +1,13 @@
 import { ContentKitClient } from '../client/client.js';
 import { ContentKitError } from '../client/errors.js';
 import { Fetcher, Page, Resource, ResourceStore, Tag } from './resources.js';
-/** The client, its shared store, and the provider's viewer and sign-in. */
+/** The client, its shared store, and the provider's viewer, language and sign-in. */
 export declare function useContentScope(own?: ContentKitClient | null): {
     client: ContentKitClient;
     store: ResourceStore;
     scope: string;
     viewer: string | null | undefined;
+    language: string | undefined;
     onSignIn: (() => void) | undefined;
 };
 /** A shared read: fetched once per key while shown; initial is shown (and seeds the store) until it loads. */

package/dist/react/use-resource.js

@@ -9,6 +9,7 @@ function l(i) {
 		store: r(s),
 		scope: n(),
 		viewer: o?.viewer,
+		language: o?.language,
 		onSignIn: o?.onSignIn
 	};
 }

package/dist/react/use-resource.js.map

@@ -1 +1 @@
-{"version":3,"file":"use-resource.js","names":[],"sources":["../../src/react/use-resource.ts"],"sourcesContent":["import { useCallback, useContext, useEffect, useRef, useSyncExternalStore } from \"react\";\nimport type { ContentKitClient } from \"../client/client.js\";\nimport type { ContentKitError } from \"../client/errors.js\";\nimport { ContentKitContext, useContentKitClient, useReadScope } from \"./context.js\";\nimport { resourcesFor, type Fetcher, type Page, type Resource, type ResourceStore, type Tag } from \"./resources.js\";\n\n/** The client, its shared store, and the provider's viewer and sign-in. */\nexport function useContentScope(own?: ContentKitClient | null) {\n  const ctx = useContext(ContentKitContext);\n  const client = useContentKitClient(own);\n  return { client, store: resourcesFor(client), scope: useReadScope(), viewer: ctx?.viewer, onSignIn: ctx?.onSignIn };\n}\n\nconst IDLE: Resource<never> = { data: undefined, loading: false, loaded: false };\nconst none = () => () => {};\n\n/** A shared read: fetched once per key while shown; initial is shown (and seeds the store) until it loads. */\nexport function useResource<T>(\n  store: ResourceStore,\n  key: string | null,\n  tag: Tag,\n  fetcher: Fetcher<T>,\n  o: { initial?: T; more?: (cursor: string | number, signal: AbortSignal) => Promise<Page<unknown>> } = {},\n): Resource<T> & { reload: () => void } {\n  const scope = useReadScope();\n  const fetch = useRef(fetcher);\n  const more = useRef(o.more);\n  const initial = useRef(o.initial);\n  useEffect(() => {\n    fetch.current = fetcher;\n    more.current = o.more;\n    initial.current = o.initial;\n  });\n  const subscribe = useCallback(\n    (l: () => void) => (key ? store.subscribe(key, { ...tag, readScope: scope }, l) : none()),\n    // The tag is part of the key.\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n    [store, key, scope],\n  );\n  const snapshot = useCallback(() => (key ? store.snapshot<T>(key) : IDLE), [store, key]);\n  const entry = useSyncExternalStore(subscribe, snapshot, snapshot);\n  useEffect(() => {\n    if (!key) return;\n    store.bind(key, (s) => fetch.current(s), more.current && ((c, s) => more.current!(c, s)));\n    if (initial.current !== undefined && !store.snapshot(key).loaded && !store.snapshot(key).loading) store.set(key, initial.current);\n    else store.load(key);\n  }, [store, key]);\n  const reload = useCallback(() => key && store.load(key, true), [store, key]);\n  if (!entry.loaded && o.initial !== undefined) return { ...entry, data: o.initial, reload };\n  return { ...entry, reload };\n}\n\n/** A shared list, a page at a time. */\nexport interface UseList<T> {\n  items: T[];\n  /** The first page is loading (also on reload). */\n  loading: boolean;\n  loadingMore: boolean;\n  error?: ContentKitError;\n  hasMore: boolean;\n  loadMore: () => Promise<void>;\n  reload: () => void;\n}\n\nexport type PageFetcher<T> = (cursor: string | number | undefined, signal: AbortSignal) => Promise<Page<T>>;\n\nexport function useList<T extends { id: string }>(store: ResourceStore, key: string | null, tag: Tag, page: PageFetcher<T>): UseList<T> {\n  const r = useResource<Page<T>>(store, key, tag, (s) => page(undefined, s), { more: (c, s) => page(c, s) });\n  const loadMore = useCallback(() => (key ? store.loadMore(key) : Promise.resolve()), [store, key]);\n  return {\n    items: r.data?.items ?? [],\n    loading: r.loading || (!!key && !r.loaded),\n    loadingMore: !!r.loadingMore,\n    error: r.error,\n    hasMore: r.data ? r.data.next !== null : false,\n    loadMore,\n    reload: r.reload,\n  };\n}\n\n/**\n * A limit/offset list as pages. A full page means more may follow; with\n * underfill (the latest feed drops items the caller may not see) only an\n * empty page ends it.\n */\nexport function offsetPages<T>(limit: number, list: (q: { limit: number; offset: number }, signal: AbortSignal) => Promise<T[]>, underfill = false): PageFetcher<T> {\n  return async (cursor, signal) => {\n    const offset = typeof cursor === \"number\" ? cursor : 0;\n    const items = await list({ limit, offset }, signal);\n    const end = underfill ? items.length === 0 : items.length < limit;\n    return { items, next: end ? null : offset + limit };\n  };\n}\n\n/** A stable store key. */\nexport const keyOf = (...parts: unknown[]) => JSON.stringify(parts);\n\n/** One numbered page of a list. */\nexport interface UsePaged<T> {\n  items: T[];\n  loading: boolean;\n  error?: ContentKitError;\n  /** Another page follows. */\n  hasNext: boolean;\n  reload: () => void;\n}\n\n/** Page `page` (from 1) of a limit/offset list: one read of limit + 1 tells whether another follows. */\nexport function usePaged<T extends { id: string }>(\n  store: ResourceStore,\n  key: string | null,\n  tag: Tag,\n  page: number,\n  limit: number,\n  list: (q: { limit: number; offset: number }, signal: AbortSignal) => Promise<T[]>,\n): UsePaged<T> {\n  const offset = (Math.max(1, page) - 1) * limit;\n  const r = useResource<Page<T>>(store, key === null ? null : `${key}#${offset}`, tag, async (signal) => {\n    const items = await list({ limit: limit + 1, offset }, signal);\n    return { items: items.slice(0, limit), next: items.length > limit ? offset + limit : null };\n  });\n  return { items: r.data?.items ?? [], loading: r.loading || (!!key && !r.loaded), error: r.error, hasNext: r.data ? r.data.next !== null : false, reload: r.reload };\n}\n"],"mappings":"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"}
+{"version":3,"file":"use-resource.js","names":[],"sources":["../../src/react/use-resource.ts"],"sourcesContent":["import { useCallback, useContext, useEffect, useRef, useSyncExternalStore } from \"react\";\nimport type { ContentKitClient } from \"../client/client.js\";\nimport type { ContentKitError } from \"../client/errors.js\";\nimport { ContentKitContext, useContentKitClient, useReadScope } from \"./context.js\";\nimport { resourcesFor, type Fetcher, type Page, type Resource, type ResourceStore, type Tag } from \"./resources.js\";\n\n/** The client, its shared store, and the provider's viewer, language and sign-in. */\nexport function useContentScope(own?: ContentKitClient | null) {\n  const ctx = useContext(ContentKitContext);\n  const client = useContentKitClient(own);\n  return { client, store: resourcesFor(client), scope: useReadScope(), viewer: ctx?.viewer, language: ctx?.language, onSignIn: ctx?.onSignIn };\n}\n\nconst IDLE: Resource<never> = { data: undefined, loading: false, loaded: false };\nconst none = () => () => {};\n\n/** A shared read: fetched once per key while shown; initial is shown (and seeds the store) until it loads. */\nexport function useResource<T>(\n  store: ResourceStore,\n  key: string | null,\n  tag: Tag,\n  fetcher: Fetcher<T>,\n  o: { initial?: T; more?: (cursor: string | number, signal: AbortSignal) => Promise<Page<unknown>> } = {},\n): Resource<T> & { reload: () => void } {\n  const scope = useReadScope();\n  const fetch = useRef(fetcher);\n  const more = useRef(o.more);\n  const initial = useRef(o.initial);\n  useEffect(() => {\n    fetch.current = fetcher;\n    more.current = o.more;\n    initial.current = o.initial;\n  });\n  const subscribe = useCallback(\n    (l: () => void) => (key ? store.subscribe(key, { ...tag, readScope: scope }, l) : none()),\n    // The tag is part of the key.\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n    [store, key, scope],\n  );\n  const snapshot = useCallback(() => (key ? store.snapshot<T>(key) : IDLE), [store, key]);\n  const entry = useSyncExternalStore(subscribe, snapshot, snapshot);\n  useEffect(() => {\n    if (!key) return;\n    store.bind(key, (s) => fetch.current(s), more.current && ((c, s) => more.current!(c, s)));\n    if (initial.current !== undefined && !store.snapshot(key).loaded && !store.snapshot(key).loading) store.set(key, initial.current);\n    else store.load(key);\n  }, [store, key]);\n  const reload = useCallback(() => key && store.load(key, true), [store, key]);\n  if (!entry.loaded && o.initial !== undefined) return { ...entry, data: o.initial, reload };\n  return { ...entry, reload };\n}\n\n/** A shared list, a page at a time. */\nexport interface UseList<T> {\n  items: T[];\n  /** The first page is loading (also on reload). */\n  loading: boolean;\n  loadingMore: boolean;\n  error?: ContentKitError;\n  hasMore: boolean;\n  loadMore: () => Promise<void>;\n  reload: () => void;\n}\n\nexport type PageFetcher<T> = (cursor: string | number | undefined, signal: AbortSignal) => Promise<Page<T>>;\n\nexport function useList<T extends { id: string }>(store: ResourceStore, key: string | null, tag: Tag, page: PageFetcher<T>): UseList<T> {\n  const r = useResource<Page<T>>(store, key, tag, (s) => page(undefined, s), { more: (c, s) => page(c, s) });\n  const loadMore = useCallback(() => (key ? store.loadMore(key) : Promise.resolve()), [store, key]);\n  return {\n    items: r.data?.items ?? [],\n    loading: r.loading || (!!key && !r.loaded),\n    loadingMore: !!r.loadingMore,\n    error: r.error,\n    hasMore: r.data ? r.data.next !== null : false,\n    loadMore,\n    reload: r.reload,\n  };\n}\n\n/**\n * A limit/offset list as pages. A full page means more may follow; with\n * underfill (the latest feed drops items the caller may not see) only an\n * empty page ends it.\n */\nexport function offsetPages<T>(limit: number, list: (q: { limit: number; offset: number }, signal: AbortSignal) => Promise<T[]>, underfill = false): PageFetcher<T> {\n  return async (cursor, signal) => {\n    const offset = typeof cursor === \"number\" ? cursor : 0;\n    const items = await list({ limit, offset }, signal);\n    const end = underfill ? items.length === 0 : items.length < limit;\n    return { items, next: end ? null : offset + limit };\n  };\n}\n\n/** A stable store key. */\nexport const keyOf = (...parts: unknown[]) => JSON.stringify(parts);\n\n/** One numbered page of a list. */\nexport interface UsePaged<T> {\n  items: T[];\n  loading: boolean;\n  error?: ContentKitError;\n  /** Another page follows. */\n  hasNext: boolean;\n  reload: () => void;\n}\n\n/** Page `page` (from 1) of a limit/offset list: one read of limit + 1 tells whether another follows. */\nexport function usePaged<T extends { id: string }>(\n  store: ResourceStore,\n  key: string | null,\n  tag: Tag,\n  page: number,\n  limit: number,\n  list: (q: { limit: number; offset: number }, signal: AbortSignal) => Promise<T[]>,\n): UsePaged<T> {\n  const offset = (Math.max(1, page) - 1) * limit;\n  const r = useResource<Page<T>>(store, key === null ? null : `${key}#${offset}`, tag, async (signal) => {\n    const items = await list({ limit: limit + 1, offset }, signal);\n    return { items: items.slice(0, limit), next: items.length > limit ? offset + limit : null };\n  });\n  return { items: r.data?.items ?? [], loading: r.loading || (!!key && !r.loaded), error: r.error, hasNext: r.data ? r.data.next !== null : false, reload: r.reload };\n}\n"],"mappings":"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"}

package/dist/react/versions.d.ts

@@ -0,0 +1,57 @@
+import { ContentKitClient } from '../client/client.js';
+import { ContentKitError } from '../client/errors.js';
+import { PlanSegment, ReaderPlan } from '../client/generated/wire.js';
+import { ReadWindow } from './read.js';
+export interface UseReaderPlan {
+    /** null while loading, pending or failed. */
+    plan: ReaderPlan | null;
+    /** The version has no current publication yet; the hook asks again. */
+    pending: boolean;
+    loading: boolean;
+    error?: ContentKitError;
+    reload: () => void;
+}
+/** When the plan changes by itself: its next scheduled segment's release. */
+export declare function nextRelease(plan: ReaderPlan | null, now?: number): number | null;
+/**
+ * A version's reader plan for this viewer: its segments (released or not,
+ * open or locked), previews, playback item and reader metadata. It asks again
+ * while the version is being published and when its next segment is released.
+ */
+export declare function useReaderPlan(content: string | null | undefined, version: string | null | undefined, o?: {
+    poll?: number;
+    client?: ContentKitClient;
+}): UseReaderPlan;
+/** A segment's page with the URL of one rendition, once its item's read signed it. */
+export interface ReaderPage {
+    name: string;
+    w: number;
+    h: number;
+    /** undefined until read, or when the page lacks the rendition. */
+    url?: string;
+}
+export interface UseSegmentPages {
+    pages: ReaderPage[];
+    loading: boolean;
+    error?: ContentKitError;
+}
+/**
+ * An open segment's pages with URLs of one rendition, read through its
+ * published item (windowed for long segments, refreshed before the URLs expire).
+ */
+export declare function useSegmentPages(segment: PlanSegment | null | undefined, rendition: string, o?: {
+    window?: ReadWindow;
+    client?: ContentKitClient;
+}): UseSegmentPages;
+export interface UseVersionDownload {
+    /** Prepares the zip (asking again while it is prepared) and resolves with it. */
+    download: () => Promise<Blob>;
+    /** Prepared by the server, waiting. */
+    preparing: boolean;
+    error?: ContentKitError;
+}
+/** A version's pages as a zip, charged to the viewer's download quota. */
+export declare function useVersionDownload(content: string, version: string, o?: {
+    poll?: number;
+    client?: ContentKitClient;
+}): UseVersionDownload;

package/dist/react/versions.js

@@ -0,0 +1,94 @@
+import { toContentKitError as e } from "../client/errors.js";
+import { useMediaRead as t } from "./read.js";
+import { keyOf as n, useContentScope as r, useResource as i } from "./use-resource.js";
+import { isPending as a } from "../client/versions.js";
+import { useCallback as o, useEffect as s, useMemo as c, useState as l } from "react";
+//#region src/react/versions.ts
+var u = 2 ** 31 - 1;
+function d(e, t = Date.now()) {
+	let n = (e?.segments ?? []).flatMap((e) => !e.released && e.release_at ? [Date.parse(e.release_at)] : []).filter((e) => e > t);
+	return n.length ? Math.min(...n) : null;
+}
+function f(e, t, o = {}) {
+	let { client: c, store: l, scope: f } = r(o.client), p = e && t ? n("reader-plan", f, e, t) : null, m = i(l, p, {
+		type: "reader-plan",
+		id: t ?? void 0
+	}, (n) => c.versions.reader(e, t, n)), h = a(m.data), g = m.data && !h ? m.data : null, { data: _, reload: v } = m;
+	return s(() => {
+		let e = a(_) ? Date.now() + (o.poll ?? 5e3) : d(_ || null);
+		if (e === null) return;
+		let t = setTimeout(v, Math.min(u, Math.max(0, e - Date.now()) + 500));
+		return () => clearTimeout(t);
+	}, [
+		_,
+		v,
+		o.poll
+	]), {
+		plan: g,
+		pending: h,
+		loading: !!p && (m.loading || !m.loaded),
+		error: m.error,
+		reload: v
+	};
+}
+function p(e, n, r = {}) {
+	let i = e?.item ?? null, a = t(i ?? {
+		kind: "",
+		id: ""
+	}, {
+		window: r.window,
+		read: i ? void 0 : null,
+		client: r.client
+	});
+	return {
+		pages: c(() => {
+			let t = new Map((a.read?.files ?? []).flatMap((e) => e.url ? [[e.path, e.url]] : []));
+			return (e?.pages ?? []).map((e) => {
+				let r = e.files[n];
+				return {
+					name: e.name,
+					w: e.w,
+					h: e.h,
+					url: r ? t.get(r) : void 0
+				};
+			});
+		}, [
+			e,
+			n,
+			a.read
+		]),
+		loading: !!i && a.loading,
+		error: a.error
+	};
+}
+function m(t, n, i = {}) {
+	let { client: s } = r(i.client), [c, u] = l(!1), [d, f] = l();
+	return {
+		download: o(async () => {
+			f(void 0), u(!0);
+			try {
+				for (;;) {
+					let e = await s.versions.download(t, n);
+					if (!a(e)) return e;
+					await new Promise((e) => setTimeout(e, i.poll ?? 3e3));
+				}
+			} catch (t) {
+				let n = e(t);
+				throw f(n), n;
+			} finally {
+				u(!1);
+			}
+		}, [
+			s,
+			t,
+			n,
+			i.poll
+		]),
+		preparing: c,
+		error: d
+	};
+}
+//#endregion
+export { d as nextRelease, f as useReaderPlan, p as useSegmentPages, m as useVersionDownload };
+
+//# sourceMappingURL=versions.js.map

package/dist/react/versions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"versions.js","names":[],"sources":["../../src/react/versions.ts"],"sourcesContent":["import { useCallback, useEffect, useMemo, useState } from \"react\";\nimport type { ContentKitClient } from \"../client/client.js\";\nimport { toContentKitError, type ContentKitError } from \"../client/errors.js\";\nimport type { Pending, PlanSegment, ReaderPlan } from \"../client/generated/wire.js\";\nimport { isPending } from \"../client/versions.js\";\nimport { useMediaRead, type ReadWindow } from \"./read.js\";\nimport { keyOf, useContentScope, useResource } from \"./use-resource.js\";\n\nexport interface UseReaderPlan {\n  /** null while loading, pending or failed. */\n  plan: ReaderPlan | null;\n  /** The version has no current publication yet; the hook asks again. */\n  pending: boolean;\n  loading: boolean;\n  error?: ContentKitError;\n  reload: () => void;\n}\n\n// setTimeout's longest delay.\nconst MAX_DELAY = 2 ** 31 - 1;\n\n/** When the plan changes by itself: its next scheduled segment's release. */\nexport function nextRelease(plan: ReaderPlan | null, now = Date.now()): number | null {\n  const at = (plan?.segments ?? []).flatMap((s) => (!s.released && s.release_at ? [Date.parse(s.release_at)] : [])).filter((t) => t > now);\n  return at.length ? Math.min(...at) : null;\n}\n\n/**\n * A version's reader plan for this viewer: its segments (released or not,\n * open or locked), previews, playback item and reader metadata. It asks again\n * while the version is being published and when its next segment is released.\n */\nexport function useReaderPlan(content: string | null | undefined, version: string | null | undefined, o: { poll?: number; client?: ContentKitClient } = {}): UseReaderPlan {\n  const { client, store, scope } = useContentScope(o.client);\n  const key = content && version ? keyOf(\"reader-plan\", scope, content, version) : null;\n  const r = useResource<ReaderPlan | Pending>(store, key, { type: \"reader-plan\", id: version ?? undefined }, (s) => client.versions.reader(content!, version!, s));\n  const pending = isPending(r.data);\n  const plan = r.data && !pending ? (r.data as ReaderPlan) : null;\n  const { data, reload } = r;\n  // Every answer schedules the next look: a pending one polls, a plan waits for its next release.\n  useEffect(() => {\n    const at = isPending(data) ? Date.now() + (o.poll ?? 5000) : nextRelease(data ? (data as ReaderPlan) : null);\n    if (at === null) return;\n    const t = setTimeout(reload, Math.min(MAX_DELAY, Math.max(0, at - Date.now()) + 500));\n    return () => clearTimeout(t);\n  }, [data, reload, o.poll]);\n  return { plan, pending, loading: !!key && (r.loading || !r.loaded), error: r.error, reload };\n}\n\n/** A segment's page with the URL of one rendition, once its item's read signed it. */\nexport interface ReaderPage {\n  name: string;\n  w: number;\n  h: number;\n  /** undefined until read, or when the page lacks the rendition. */\n  url?: string;\n}\n\nexport interface UseSegmentPages {\n  pages: ReaderPage[];\n  loading: boolean;\n  error?: ContentKitError;\n}\n\n/**\n * An open segment's pages with URLs of one rendition, read through its\n * published item (windowed for long segments, refreshed before the URLs expire).\n */\nexport function useSegmentPages(segment: PlanSegment | null | undefined, rendition: string, o: { window?: ReadWindow; client?: ContentKitClient } = {}): UseSegmentPages {\n  const item = segment?.item ?? null;\n  const read = useMediaRead(item ?? { kind: \"\", id: \"\" }, { window: o.window, read: item ? undefined : null, client: o.client });\n  const pages = useMemo(() => {\n    const urls = new Map((read.read?.files ?? []).flatMap((f) => (f.url ? [[f.path, f.url] as const] : [])));\n    return (segment?.pages ?? []).map((p) => {\n      const path = p.files[rendition];\n      return { name: p.name, w: p.w, h: p.h, url: path ? urls.get(path) : undefined };\n    });\n  }, [segment, rendition, read.read]);\n  return { pages, loading: !!item && read.loading, error: read.error };\n}\n\nexport interface UseVersionDownload {\n  /** Prepares the zip (asking again while it is prepared) and resolves with it. */\n  download: () => Promise<Blob>;\n  /** Prepared by the server, waiting. */\n  preparing: boolean;\n  error?: ContentKitError;\n}\n\n/** A version's pages as a zip, charged to the viewer's download quota. */\nexport function useVersionDownload(content: string, version: string, o: { poll?: number; client?: ContentKitClient } = {}): UseVersionDownload {\n  const { client } = useContentScope(o.client);\n  const [preparing, setPreparing] = useState(false);\n  const [error, setError] = useState<ContentKitError>();\n  const download = useCallback(async () => {\n    setError(undefined);\n    setPreparing(true);\n    try {\n      for (;;) {\n        const out = await client.versions.download(content, version);\n        if (!isPending(out)) return out;\n        await new Promise((r) => setTimeout(r, o.poll ?? 3000));\n      }\n    } catch (e) {\n      const err = toContentKitError(e);\n      setError(err);\n      throw err;\n    } finally {\n      setPreparing(false);\n    }\n  }, [client, content, version, o.poll]);\n  return { download, preparing, error };\n}\n"],"mappings":"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"}