@openrails/contentkit-ui 0.99.3 → 0.100.1

package/dist/react/read.js

@@ -1,27 +1,29 @@
 import { itemRef as e } from "../client/media/ref.js";
 import { useOptionalContentKitClient as t, useReadScope as n } from "./context.js";
-import { chunkOffsets as r, mergeReads as i, processing as a } from "../client/media/windows.js";
-import { readKey as o, storeFor as s } from "./store.js";
-import { useCallback as c, useEffect as l, useMemo as u, useRef as d, useState as f, useSyncExternalStore as ee } from "react";
+import { chunkOffsets as r, mergeReads as i, processing as ee } from "../client/media/windows.js";
+import { readKey as a, storeFor as o } from "./store.js";
+import { useCallback as s, useEffect as c, useMemo as l, useRef as u, useState as d, useSyncExternalStore as te } from "react";
 //#region src/react/read.ts
-var te = 2500, p = [];
+var f = 2500, p = [];
 function m(m, h = {}) {
-	let { read: g, client: _, prefix: v, offset: y, limit: b, download: x, editor: S, window: C, refresh: w = !0 } = h, T = h.poll ?? (S ? te : !1), E = t(_), D = n(), O = E ? s(E) : null, k = C?.chunk ?? 50, A = D + o(m, {
+	let { read: g, client: _, prefix: v, offset: y, limit: b, download: x, editor: S, window: C, refresh: w = !0 } = h, T = h.poll ?? (S ? f : !1), E = t(_), D = n(), O = E ? o(E) : null, k = C?.chunk ?? 50, A = D + a(m, {
 		prefix: v,
 		download: x,
 		editor: S
-	}) + (C ? `#${k}` : `#${y ?? 0}:${b ?? 0}`), [j, M] = f({ base: A }), N = j.base === A ? j.n : void 0, P = C ? r(C.start, C.end, N ?? C.start + 1, k) : [], [F, I] = f({
+	}) + (C ? `#${k}` : `#${y ?? 0}:${b ?? 0}`), [j, M] = d({
 		base: A,
-		offsets: []
-	}), L = F.base === A ? F.offsets : [];
-	C && (F.base !== A || P.some((e) => !L.includes(e))) && I({
+		store: O,
+		read: null
+	}), N = j.base === A && j.store === O;
+	N || M({
 		base: A,
-		offsets: [.../* @__PURE__ */ new Set([...L, ...P])].sort((e, t) => e - t)
+		store: O,
+		read: null
 	});
-	let R = C ? L.length ? L : P.length ? P : [0] : [y ?? 0], z = u(() => R.map((e) => ({
+	let P = N ? j.n : void 0, F = C ? r(C.start, C.end, P ?? C.start + 1, k) : [], I = C ? F.length ? F : [0] : [y ?? 0], L = l(() => I.map((e) => ({
 		offset: e,
 		limit: C ? k : b
-	})), [R.join(","), C ? k : b]), B = u(() => z.map((e) => D + o(m, {
+	})), [I.join(","), C ? k : b]), R = l(() => L.map((e) => D + a(m, {
 		prefix: v,
 		download: x,
 		editor: S,
@@ -29,20 +31,20 @@ function m(m, h = {}) {
 		limit: e.limit
 	})), [
 		D,
-		z,
+		L,
 		m.kind,
 		m.id,
 		m.version,
 		v,
 		x,
 		S
-	]), [V, H] = f(null), [U, W] = f(null), G = V?.base === A && V.given === g ? V : null, K = !!O && (g === void 0 || !!G), ne = c((t) => {
-		if (!O || !K) return () => {};
-		let n = B.map((n, r) => O.subscribe(n, e(m), {
+	]), [z, B] = d(null), [V, H] = d(null), U = z?.base === A && z.given === g ? z : null, W = !!O && (g === void 0 || !!U), G = s((t) => {
+		if (!O || !W) return () => {};
+		let n = R.map((n, r) => O.subscribe(n, e(m), {
 			prefix: v,
 			download: x,
 			editor: S,
-			...z[r]
+			...L[r]
 		}, t, {
 			poll: T,
 			refresh: w
@@ -50,91 +52,96 @@ function m(m, h = {}) {
 		return () => n.forEach((e) => e());
 	}, [
 		O,
-		K,
-		B,
+		W,
+		R,
 		T,
 		w
-	]), q = d(p), J = c(() => {
-		if (!O || !K) return p;
-		let e = B.map((e) => O.snapshot(e)), t = q.current;
-		return t.length === e.length && t.every((t, n) => t === e[n]) ? t : q.current = e;
+	]), K = u(p), q = s(() => {
+		if (!O || !W) return p;
+		let e = R.map((e) => O.snapshot(e)), t = K.current;
+		return t.length === e.length && t.every((t, n) => t === e[n]) ? t : K.current = e;
 	}, [
 		O,
-		K,
-		B
-	]), Y = ee(ne, J, J);
-	l(() => {
-		if (O && K) for (let e of B) O.load(e, G ? "reload" : "initial");
+		W,
+		R
+	]), J = te(G, q, q);
+	c(() => {
+		if (O && W) for (let e of R) O.load(e, U ? "reload" : "initial");
 	}, [
 		O,
-		K,
-		B,
-		G
+		W,
+		R,
+		U
 	]);
-	let X = u(() => i(Y.map((e) => e.read)), [Y]);
-	l(() => {
-		C && X && X.total !== N && M({
+	let Y = l(() => i(J.map((e) => e.read)), [J]), X = J.some((e) => !!e.error);
+	c(() => {
+		let e = X ? null : Y;
+		C && (X || Y || J.length && J.every((e) => e.loaded)) && M((t) => t.base === A && t.store === O && t.read === e ? t : {
 			base: A,
-			n: X.total
+			store: O,
+			read: e,
+			n: Y?.total ?? (t.base === A && t.store === O ? t.n : void 0)
 		});
 	}, [
-		C,
+		!!C,
+		Y,
 		X,
-		N,
-		A
+		J,
+		A,
+		O
 	]);
-	let re = c(() => {
-		if (g !== void 0) H({
+	let ne = s(() => {
+		if (g !== void 0) B({
 			base: A,
 			given: g
 		});
-		else if (O) for (let e of B) O.load(e, "reload");
-		W(null);
+		else if (O) for (let e of R) O.load(e, "reload");
+		H(null);
 	}, [
 		O,
-		B,
+		R,
 		A,
 		g
-	]), ie = c(() => {
-		if (g !== void 0 && !G) H({
+	]), re = s(() => {
+		if (g !== void 0 && !U) B({
 			base: A,
 			given: g
 		});
-		else if (O) for (let e of B) O.load(e, "refresh");
+		else if (O) for (let e of R) O.load(e, "refresh");
 	}, [
 		O,
-		B,
+		R,
 		A,
 		g,
-		G
-	]), ae = c((e) => {
-		if (O && K) for (let t of B) O.set(t, e);
-		else W({
+		U
+	]), ie = s((e) => {
+		if (O && W) for (let t of R) O.set(t, e);
+		else H({
 			base: A,
 			given: g,
 			read: e
 		});
 	}, [
 		O,
-		K,
-		B,
+		W,
+		R,
 		A,
 		g
 	]), Z, Q = !1, $;
-	if (U && U.base === A && U.given === g) Z = U.read;
-	else if (!Y.length) Z = g ?? null;
+	if (V && V.base === A && V.given === g) Z = V.read;
+	else if (!J.length) Z = g ?? null;
 	else {
-		let e = Y.every((e) => e.loaded);
-		Z = X ?? (e ? null : g ?? null), Q = Y.some((e) => e.loading || !e.loaded), $ = Y.find((e) => e.error)?.error;
+		let e = J.every((e) => e.loaded);
+		Z = Y ?? (e ? null : g ?? (C && N && !X ? j.read : null)), Q = J.some((e) => e.loading || !e.loaded), $ = J.find((e) => e.error)?.error;
 	}
 	return {
 		read: Z,
 		loading: Q,
 		error: $,
-		processing: a(Z),
-		reload: re,
-		refresh: ie,
-		set: ae
+		processing: ee(Z),
+		reload: ne,
+		refresh: re,
+		set: ie
 	};
 }
 //#endregion

package/dist/react/read.js.map

@@ -1 +1 @@
-{"version":3,"file":"read.js","names":[],"sources":["../../src/react/read.ts"],"sourcesContent":["import { useCallback, useEffect, useMemo, useRef, useState, useSyncExternalStore } from \"react\";\nimport type { ContentKitClient } from \"../client/client.js\";\nimport type { ContentKitError } from \"../client/errors.js\";\nimport type { ReadResult, RefBody } from \"../client/generated/wire.js\";\nimport type { ReadOptions } from \"../client/media/api.js\";\nimport { chunkOffsets, mergeReads, processing as isProcessing, READ_CHUNK } from \"../client/media/windows.js\";\nimport { itemRef } from \"../client/media/ref.js\";\nimport { useOptionalContentKitClient, useReadScope } from \"./context.js\";\nimport { readKey, storeFor, type ReadEntry } from \"./store.js\";\n\n/** Files [start, end) get URLs. */\nexport interface ReadWindow {\n  start: number;\n  end: number;\n  /** Files per read. Default 50. */\n  chunk?: number;\n}\n\nexport interface MediaReadOptions extends Omit<ReadOptions, \"offset\" | \"limit\"> {\n  /**\n   * Read in windows of `chunk` files and merge them: the files in\n   * [start, end) get URLs, and windows once read stay loaded (and refreshed)\n   * until the item or options change. Without it, one read of the server's\n   * default range (or offset and limit).\n   */\n  window?: ReadWindow;\n  offset?: number;\n  limit?: number;\n  /** Poll at this interval (ms) while uploads process. Default 2500 for editor reads, else off. */\n  poll?: number | false;\n  /** Read again shortly before the URLs expire. Default true. */\n  refresh?: boolean;\n  /** A read the host already has: shown until reload() or set(). */\n  read?: ReadResult | null;\n  /** Overrides the provider's client. */\n  client?: ContentKitClient | null;\n}\n\nexport interface UseMediaRead {\n  /** The read (windows merged); null until it loads or when it failed. */\n  read: ReadResult | null;\n  loading: boolean;\n  error?: ContentKitError;\n  /** Uploads are still processing (editor reads). */\n  processing: boolean;\n  /** Reads again now, restarting a read in flight. */\n  reload: () => void;\n  /** Reads again unless a read is in flight: a player's grant refresh. */\n  refresh: () => void;\n  /** Replaces the read without refetching, for every hook showing it. */\n  set: (r: ReadResult) => void;\n}\n\nconst POLL = 2500;\nconst NONE: readonly ReadEntry[] = [];\n\n/**\n * A read of the item, shared with every hook reading the same item and\n * options: refreshed before its URLs expire, retried after a read rate limit,\n * polled while uploads process, reloaded after a commit through the client.\n * A window splits it into merged reads. Without a client (none passed, no\n * provider) it only shows a supplied read.\n */\nexport function useMediaRead(ref: RefBody, o: MediaReadOptions = {}): UseMediaRead {\n  const { read: given, client: own, prefix, offset, limit, download, editor, window, refresh: refreshing = true } = o;\n  const poll = o.poll ?? (editor ? POLL : false);\n  const client = useOptionalContentKitClient(own);\n  const scope = useReadScope();\n  const store = client ? storeFor(client) : null;\n  const chunk = window?.chunk ?? READ_CHUNK;\n  const base = scope + readKey(ref, { prefix, download, editor }) + (window ? `#${chunk}` : `#${offset ?? 0}:${limit ?? 0}`);\n\n  // Windows once wanted stay loaded until the item or options change.\n  const [total, setTotal] = useState<{ base: string; n?: number }>({ base });\n  const known = total.base === base ? total.n : undefined;\n  // Until the first read states the total, only the window's first chunk.\n  const wanted = window ? chunkOffsets(window.start, window.end, known ?? window.start + 1, chunk) : [];\n  const [kept, setKept] = useState<{ base: string; offsets: number[] }>({ base, offsets: [] });\n  const prior = kept.base === base ? kept.offsets : [];\n  if (window && (kept.base !== base || wanted.some((w) => !prior.includes(w)))) {\n    setKept({ base, offsets: [...new Set([...prior, ...wanted])].sort((a, b) => a - b) });\n  }\n  const offsets = window ? (prior.length ? prior : wanted.length ? wanted : [0]) : [offset ?? 0];\n  const windows = useMemo(\n    () => offsets.map((off) => ({ offset: off, limit: window ? chunk : limit })),\n    // offsets is derived from the stable kept list\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n    [offsets.join(\",\"), window ? chunk : limit],\n  );\n  const keys = useMemo(() => windows.map((w) => scope + readKey(ref, { prefix, download, editor, offset: w.offset, limit: w.limit })), [scope, windows, ref.kind, ref.id, ref.version, prefix, download, editor]); // eslint-disable-line react-hooks/exhaustive-deps\n\n  // A supplied read is shown until reload() asks the server or set() replaces it.\n  const [requested, setRequested] = useState<{ base: string; given?: ReadResult | null } | null>(null);\n  const [local, setLocal] = useState<{ base: string; given?: ReadResult | null; read: ReadResult } | null>(null);\n  const asked = requested?.base === base && requested.given === given ? requested : null;\n  const fetching = !!store && (given === undefined || !!asked);\n\n  const subscribe = useCallback(\n    (l: () => void) => {\n      if (!store || !fetching) return () => {};\n      const offs = keys.map((key, i) => store.subscribe(key, itemRef(ref), { prefix, download, editor, ...windows[i] }, l, { poll, refresh: refreshing }, scope));\n      return () => offs.forEach((off) => off());\n    },\n    // ref and options are in keys.\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n    [store, fetching, keys, poll, refreshing],\n  );\n  const last = useRef<readonly ReadEntry[]>(NONE);\n  const snapshot = useCallback(() => {\n    if (!store || !fetching) return NONE;\n    const next = keys.map((k) => store.snapshot(k));\n    const prev = last.current;\n    if (prev.length === next.length && prev.every((e, i) => e === next[i])) return prev;\n    return (last.current = next);\n  }, [store, fetching, keys]);\n  const entries = useSyncExternalStore(subscribe, snapshot, snapshot);\n  useEffect(() => {\n    if (store && fetching) for (const k of keys) store.load(k, asked ? \"reload\" : \"initial\");\n  }, [store, fetching, keys, asked]);\n\n  const merged = useMemo(() => mergeReads(entries.map((e) => e.read)), [entries]);\n  useEffect(() => {\n    if (window && merged && merged.total !== known) setTotal({ base, n: merged.total });\n  }, [window, merged, known, base]);\n\n  const reload = useCallback(() => {\n    if (given !== undefined) setRequested({ base, given });\n    else if (store) for (const k of keys) store.load(k, \"reload\");\n    setLocal(null);\n  }, [store, keys, base, given]);\n  const refresh = useCallback(() => {\n    if (given !== undefined && !asked) setRequested({ base, given });\n    else if (store) for (const k of keys) store.load(k, \"refresh\");\n  }, [store, keys, base, given, asked]);\n  const set = useCallback(\n    (read: ReadResult) => {\n      if (store && fetching) for (const k of keys) store.set(k, read);\n      else setLocal({ base, given, read });\n    },\n    [store, fetching, keys, base, given],\n  );\n\n  let read: ReadResult | null;\n  let loading = false;\n  let error: ContentKitError | undefined;\n  if (local && local.base === base && local.given === given) read = local.read;\n  else if (!entries.length) read = given ?? null;\n  else {\n    const loaded = entries.every((e) => e.loaded);\n    read = merged ?? (loaded ? null : (given ?? null));\n    loading = entries.some((e) => e.loading || !e.loaded);\n    error = entries.find((e) => e.error)?.error;\n  }\n  return { read, loading, error, processing: isProcessing(read), reload, refresh, set };\n}\n"],"mappings":"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"}
+{"version":3,"file":"read.js","names":[],"sources":["../../src/react/read.ts"],"sourcesContent":["import { useCallback, useEffect, useMemo, useRef, useState, useSyncExternalStore } from \"react\";\nimport type { ContentKitClient } from \"../client/client.js\";\nimport type { ContentKitError } from \"../client/errors.js\";\nimport type { ReadResult, RefBody } from \"../client/generated/wire.js\";\nimport type { ReadOptions } from \"../client/media/api.js\";\nimport { chunkOffsets, mergeReads, processing as isProcessing, READ_CHUNK } from \"../client/media/windows.js\";\nimport { itemRef } from \"../client/media/ref.js\";\nimport { useOptionalContentKitClient, useReadScope } from \"./context.js\";\nimport { readKey, storeFor, type ReadEntry } from \"./store.js\";\n\n/** Files [start, end) get URLs. */\nexport interface ReadWindow {\n  start: number;\n  end: number;\n  /** Files per read. Default 50. */\n  chunk?: number;\n}\n\nexport interface MediaReadOptions extends Omit<ReadOptions, \"offset\" | \"limit\"> {\n  /**\n   * Read in windows of `chunk` files and merge them: the files in\n   * [start, end) get URLs. Only the requested windows stay active and refresh;\n   * a prior read supplies placeholder metadata while the new range loads.\n   * Without it, one read of the server's\n   * default range (or offset and limit).\n   */\n  window?: ReadWindow;\n  offset?: number;\n  limit?: number;\n  /** Poll at this interval (ms) while uploads process. Default 2500 for editor reads, else off. */\n  poll?: number | false;\n  /** Read again shortly before the URLs expire. Default true. */\n  refresh?: boolean;\n  /** A read the host already has: shown until reload() or set(). */\n  read?: ReadResult | null;\n  /** Overrides the provider's client. */\n  client?: ContentKitClient | null;\n}\n\nexport interface UseMediaRead {\n  /** The read (windows merged); null until it loads or when it failed. */\n  read: ReadResult | null;\n  loading: boolean;\n  error?: ContentKitError;\n  /** Uploads are still processing (editor reads). */\n  processing: boolean;\n  /** Reads again now, restarting a read in flight. */\n  reload: () => void;\n  /** Reads again unless a read is in flight: a player's grant refresh. */\n  refresh: () => void;\n  /** Replaces the read without refetching, for every hook showing it. */\n  set: (r: ReadResult) => void;\n}\n\nconst POLL = 2500;\nconst NONE: readonly ReadEntry[] = [];\n\n/**\n * A read of the item, shared with every hook reading the same item and\n * options: refreshed before its URLs expire, retried after a read rate limit,\n * polled while uploads process, reloaded after a commit through the client.\n * A window splits it into merged reads. Without a client (none passed, no\n * provider) it only shows a supplied read.\n */\nexport function useMediaRead(ref: RefBody, o: MediaReadOptions = {}): UseMediaRead {\n  const { read: given, client: own, prefix, offset, limit, download, editor, window, refresh: refreshing = true } = o;\n  const poll = o.poll ?? (editor ? POLL : false);\n  const client = useOptionalContentKitClient(own);\n  const scope = useReadScope();\n  const store = client ? storeFor(client) : null;\n  const chunk = window?.chunk ?? READ_CHUNK;\n  const base = scope + readKey(ref, { prefix, download, editor }) + (window ? `#${chunk}` : `#${offset ?? 0}:${limit ?? 0}`);\n\n  // Keep one placeholder, never subscriptions for the reader's visit history.\n  const [previous, setPrevious] = useState<{ base: string; store: typeof store; read: ReadResult | null; n?: number }>({ base, store, read: null });\n  const same = previous.base === base && previous.store === store;\n  if (!same) setPrevious({ base, store, read: null });\n  const known = same ? previous.n : undefined;\n  // Until the first read states the total, only the window's first chunk.\n  const wanted = window ? chunkOffsets(window.start, window.end, known ?? window.start + 1, chunk) : [];\n  const offsets = window ? (wanted.length ? wanted : [0]) : [offset ?? 0];\n  const windows = useMemo(\n    () => offsets.map((off) => ({ offset: off, limit: window ? chunk : limit })),\n    // Window identity depends on its values, not the caller's array identity.\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n    [offsets.join(\",\"), window ? chunk : limit],\n  );\n  const keys = useMemo(() => windows.map((w) => scope + readKey(ref, { prefix, download, editor, offset: w.offset, limit: w.limit })), [scope, windows, ref.kind, ref.id, ref.version, prefix, download, editor]); // eslint-disable-line react-hooks/exhaustive-deps\n\n  // A supplied read is shown until reload() asks the server or set() replaces it.\n  const [requested, setRequested] = useState<{ base: string; given?: ReadResult | null } | null>(null);\n  const [local, setLocal] = useState<{ base: string; given?: ReadResult | null; read: ReadResult } | null>(null);\n  const asked = requested?.base === base && requested.given === given ? requested : null;\n  const fetching = !!store && (given === undefined || !!asked);\n\n  const subscribe = useCallback(\n    (l: () => void) => {\n      if (!store || !fetching) return () => {};\n      const offs = keys.map((key, i) => store.subscribe(key, itemRef(ref), { prefix, download, editor, ...windows[i] }, l, { poll, refresh: refreshing }, scope));\n      return () => offs.forEach((off) => off());\n    },\n    // ref and options are in keys.\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n    [store, fetching, keys, poll, refreshing],\n  );\n  const last = useRef<readonly ReadEntry[]>(NONE);\n  const snapshot = useCallback(() => {\n    if (!store || !fetching) return NONE;\n    const next = keys.map((k) => store.snapshot(k));\n    const prev = last.current;\n    if (prev.length === next.length && prev.every((e, i) => e === next[i])) return prev;\n    return (last.current = next);\n  }, [store, fetching, keys]);\n  const entries = useSyncExternalStore(subscribe, snapshot, snapshot);\n  useEffect(() => {\n    if (store && fetching) for (const k of keys) store.load(k, asked ? \"reload\" : \"initial\");\n  }, [store, fetching, keys, asked]);\n\n  const merged = useMemo(() => mergeReads(entries.map((e) => e.read)), [entries]);\n  const failed = entries.some((e) => !!e.error);\n  useEffect(() => {\n    const read = failed ? null : merged;\n    if (window && (failed || merged || (entries.length && entries.every((e) => e.loaded)))) {\n      setPrevious((prev) => prev.base === base && prev.store === store && prev.read === read ? prev : {\n        base, store, read, n: merged?.total ?? (prev.base === base && prev.store === store ? prev.n : undefined),\n      });\n    }\n  }, [!!window, merged, failed, entries, base, store]); // eslint-disable-line react-hooks/exhaustive-deps\n\n  const reload = useCallback(() => {\n    if (given !== undefined) setRequested({ base, given });\n    else if (store) for (const k of keys) store.load(k, \"reload\");\n    setLocal(null);\n  }, [store, keys, base, given]);\n  const refresh = useCallback(() => {\n    if (given !== undefined && !asked) setRequested({ base, given });\n    else if (store) for (const k of keys) store.load(k, \"refresh\");\n  }, [store, keys, base, given, asked]);\n  const set = useCallback(\n    (read: ReadResult) => {\n      if (store && fetching) for (const k of keys) store.set(k, read);\n      else setLocal({ base, given, read });\n    },\n    [store, fetching, keys, base, given],\n  );\n\n  let read: ReadResult | null;\n  let loading = false;\n  let error: ContentKitError | undefined;\n  if (local && local.base === base && local.given === given) read = local.read;\n  else if (!entries.length) read = given ?? null;\n  else {\n    const loaded = entries.every((e) => e.loaded);\n    read = merged ?? (loaded ? null : (given ?? (window && same && !failed ? previous.read : null)));\n    loading = entries.some((e) => e.loading || !e.loaded);\n    error = entries.find((e) => e.error)?.error;\n  }\n  return { read, loading, error, processing: isProcessing(read), reload, refresh, set };\n}\n"],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openrails/contentkit-ui",
-  "version": "0.99.3",
+  "version": "0.100.1",
   "description": "ContentKit in the browser: client, React hooks and styled components for media, uploads and content URLs.",
   "type": "module",
   "license": "MIT",