@openrails/contentkit-ui 0.79.0 → 0.81.0

package/dist/react/engagement.js.map

@@ -1 +1 @@
-{"version":3,"file":"engagement.js","names":[],"sources":["../../src/react/engagement.ts"],"sourcesContent":["import { useCallback, useState } from \"react\";\nimport type { ContentKitClient } from \"../client/client.js\";\nimport type { ContentKitError } from \"../client/errors.js\";\nimport { toContentKitError } from \"../client/errors.js\";\nimport type { Reaction } from \"../client/content/types.js\";\nimport type { FavoriteState, ReactionCounts, RefBody } from \"../client/generated/wire.js\";\nimport { withReaction } from \"./comments.js\";\nimport { keyOf, useContentScope, useResource } from \"./use-resource.js\";\n\nexport interface UseReaction {\n  counts: ReactionCounts;\n  loading: boolean;\n  error?: ContentKitError;\n  /** Sets the caller's reaction at once; rolled back if the server refuses it. */\n  set: (value: Reaction) => Promise<void>;\n  /** Sets value, or clears it when it is the current one. */\n  toggle: (value: 1 | -1) => Promise<void>;\n}\n\nconst ZERO: ReactionCounts = { likes: 0, dislikes: 0, mine: 0 };\n\n/** An item's likes and dislikes and the caller's own reaction (initial: counts the host already has). */\nexport function useReaction(ref: RefBody, o: { initial?: ReactionCounts; client?: ContentKitClient } = {}): UseReaction {\n  const { client, store, scope } = useContentScope(o.client);\n  const key = keyOf(\"reaction\", scope, ref.kind, ref.id);\n  const r = useResource<ReactionCounts>(store, key, { type: \"reaction\", ref: { kind: ref.kind, id: ref.id } }, (s) => client.reactions.get(ref, s), { initial: o.initial });\n  const counts = r.data ?? ZERO;\n  const { kind, id } = ref;\n  const set = useCallback(\n    async (value: Reaction) => {\n      const prev = store.snapshot<ReactionCounts>(key).data ?? counts;\n      const token = store.mark(key);\n      store.set(key, withReaction(prev, value));\n      try {\n        await client.reactions.set({ kind, id }, value);\n      } catch (e) {\n        store.rollback(key, token, prev);\n        throw toContentKitError(e);\n      }\n    },\n    [client, store, key, kind, id, counts],\n  );\n  const toggle = useCallback((value: 1 | -1) => set(counts.mine === value ? 0 : value), [set, counts.mine]);\n  return { counts, loading: r.loading || (!r.loaded && o.initial === undefined), error: r.error, set, toggle };\n}\n\nexport interface UseFavorite {\n  favorited: boolean;\n  /** How many favorited the item; undefined until read. */\n  count?: number;\n  loading: boolean;\n  /** A write is in flight. */\n  pending: boolean;\n  error?: ContentKitError;\n  /** Sets it at once (count moved by one); rolled back if the server refuses it. */\n  set: (favorited: boolean) => Promise<void>;\n  toggle: () => Promise<void>;\n}\n\n/**\n * An item's favorite count and whether the signed-in caller favorited it\n * (initial: what the host already has). Signed out, favorited stays false.\n */\nexport function useFavorite(ref: RefBody, o: { initial?: FavoriteState; client?: ContentKitClient } = {}): UseFavorite {\n  const { client, store, scope } = useContentScope(o.client);\n  const key = keyOf(\"favorite\", scope, ref.kind, ref.id);\n  const r = useResource<FavoriteState>(store, key, { type: \"favorite\", ref: { kind: ref.kind, id: ref.id } }, (s) => client.favorites.get(ref, s), { initial: o.initial });\n  const favorited = !!r.data?.favorited;\n  const [pending, setPending] = useState(false);\n  const { kind, id } = ref;\n  const set = useCallback(\n    async (next: boolean) => {\n      const prev = store.snapshot<FavoriteState>(key).data;\n      const token = store.mark(key);\n      if (prev && prev.favorited !== next) store.set<FavoriteState>(key, { favorited: next, count: Math.max(0, prev.count + (next ? 1 : -1)) });\n      setPending(true);\n      try {\n        await client.favorites.set({ kind, id }, next);\n      } catch (e) {\n        if (prev) store.rollback(key, token, prev);\n        throw toContentKitError(e);\n      } finally {\n        setPending(false);\n      }\n    },\n    [client, store, key, kind, id],\n  );\n  const toggle = useCallback(() => set(!favorited), [set, favorited]);\n  return { favorited, count: r.data?.count, loading: r.loading || (!r.loaded && o.initial === undefined), pending, error: r.error, set, toggle };\n}\n"],"mappings":";;;;;AAmBA,IAAM,IAAuB;CAAE,OAAO;CAAG,UAAU;CAAG,MAAM;AAAE;AAG9D,SAAgB,EAAY,GAAc,IAA6D,CAAC,GAAgB;CACtH,IAAM,EAAE,WAAQ,UAAO,aAAU,EAAgB,EAAE,MAAM,GACnD,IAAM,EAAM,YAAY,GAAO,EAAI,MAAM,EAAI,EAAE,GAC/C,IAAI,EAA4B,GAAO,GAAK;EAAE,MAAM;EAAY,KAAK;GAAE,MAAM,EAAI;GAAM,IAAI,EAAI;EAAG;CAAE,IAAI,MAAM,EAAO,UAAU,IAAI,GAAK,CAAC,GAAG,EAAE,SAAS,EAAE,QAAQ,CAAC,GAClK,IAAS,EAAE,QAAQ,GACnB,EAAE,SAAM,UAAO,GACf,IAAM,EACV,OAAO,MAAoB;EACzB,IAAM,IAAO,EAAM,SAAyB,CAAG,CAAC,CAAC,QAAQ,GACnD,IAAQ,EAAM,KAAK,CAAG;EAC5B,EAAM,IAAI,GAAK,EAAa,GAAM,CAAK,CAAC;EACxC,IAAI;GACF,MAAM,EAAO,UAAU,IAAI;IAAE;IAAM;GAAG,GAAG,CAAK;EAChD,SAAS,GAAG;GAEV,MADA,EAAM,SAAS,GAAK,GAAO,CAAI,GACzB,EAAkB,CAAC;EAC3B;CACF,GACA;EAAC;EAAQ;EAAO;EAAK;EAAM;EAAI;CAAM,CACvC,GACM,IAAS,GAAa,MAAkB,EAAI,EAAO,SAAS,IAAQ,IAAI,CAAK,GAAG,CAAC,GAAK,EAAO,IAAI,CAAC;CACxG,OAAO;EAAE;EAAQ,SAAS,EAAE,WAAY,CAAC,EAAE,UAAU,EAAE,YAAY,KAAA;EAAY,OAAO,EAAE;EAAO;EAAK;CAAO;AAC7G;AAmBA,SAAgB,EAAY,GAAc,IAA4D,CAAC,GAAgB;CACrH,IAAM,EAAE,WAAQ,UAAO,aAAU,EAAgB,EAAE,MAAM,GACnD,IAAM,EAAM,YAAY,GAAO,EAAI,MAAM,EAAI,EAAE,GAC/C,IAAI,EAA2B,GAAO,GAAK;EAAE,MAAM;EAAY,KAAK;GAAE,MAAM,EAAI;GAAM,IAAI,EAAI;EAAG;CAAE,IAAI,MAAM,EAAO,UAAU,IAAI,GAAK,CAAC,GAAG,EAAE,SAAS,EAAE,QAAQ,CAAC,GACjK,IAAY,CAAC,CAAC,EAAE,MAAM,WACtB,CAAC,GAAS,KAAc,EAAS,EAAK,GACtC,EAAE,SAAM,UAAO,GACf,IAAM,EACV,OAAO,MAAkB;EACvB,IAAM,IAAO,EAAM,SAAwB,CAAG,CAAC,CAAC,MAC1C,IAAQ,EAAM,KAAK,CAAG;EAE5B,AADI,KAAQ,EAAK,cAAc,KAAM,EAAM,IAAmB,GAAK;GAAE,WAAW;GAAM,OAAO,KAAK,IAAI,GAAG,EAAK,SAAS,IAAO,IAAI,GAAG;EAAE,CAAC,GACxI,EAAW,EAAI;EACf,IAAI;GACF,MAAM,EAAO,UAAU,IAAI;IAAE;IAAM;GAAG,GAAG,CAAI;EAC/C,SAAS,GAAG;GAEV,MADI,KAAM,EAAM,SAAS,GAAK,GAAO,CAAI,GACnC,EAAkB,CAAC;EAC3B,UAAU;GACR,EAAW,EAAK;EAClB;CACF,GACA;EAAC;EAAQ;EAAO;EAAK;EAAM;CAAE,CAC/B,GACM,IAAS,QAAkB,EAAI,CAAC,CAAS,GAAG,CAAC,GAAK,CAAS,CAAC;CAClE,OAAO;EAAE;EAAW,OAAO,EAAE,MAAM;EAAO,SAAS,EAAE,WAAY,CAAC,EAAE,UAAU,EAAE,YAAY,KAAA;EAAY;EAAS,OAAO,EAAE;EAAO;EAAK;CAAO;AAC/I"}
+{"version":3,"file":"engagement.js","names":[],"sources":["../../src/react/engagement.ts"],"sourcesContent":["import { useCallback, useState } from \"react\";\nimport type { ContentKitClient } from \"../client/client.js\";\nimport type { ContentKitError } from \"../client/errors.js\";\nimport { toContentKitError } from \"../client/errors.js\";\nimport type { Reaction, Target } from \"../client/content/types.js\";\nimport type { FavoriteState, ReactionCounts } from \"../client/generated/wire.js\";\nimport { withReaction } from \"./comments.js\";\nimport { keyOf, useContentScope, useResource } from \"./use-resource.js\";\n\nexport interface UseReaction {\n  counts: ReactionCounts;\n  loading: boolean;\n  error?: ContentKitError;\n  /** Sets the caller's reaction at once; rolled back if the server refuses it. */\n  set: (value: Reaction) => Promise<void>;\n  /** Sets value, or clears it when it is the current one. */\n  toggle: (value: 1 | -1) => Promise<void>;\n}\n\nconst ZERO: ReactionCounts = { likes: 0, dislikes: 0, mine: 0 };\n\n/** A target's likes and dislikes and the caller's own reaction (initial: counts the host already has). */\nexport function useReaction(target: Target, o: { initial?: ReactionCounts; client?: ContentKitClient } = {}): UseReaction {\n  const { client, store, scope } = useContentScope(o.client);\n  const { type, id, version } = target;\n  const key = keyOf(\"reaction\", scope, type, id, version);\n  const r = useResource<ReactionCounts>(store, key, { type: \"reaction\", target: { type, id, version } }, (s) => client.reactions.get({ type, id, version }, s), {\n    initial: o.initial,\n  });\n  const counts = r.data ?? ZERO;\n  const set = useCallback(\n    async (value: Reaction) => {\n      const prev = store.snapshot<ReactionCounts>(key).data ?? counts;\n      const token = store.mark(key);\n      store.set(key, withReaction(prev, value));\n      try {\n        await client.reactions.set({ type, id, version }, value);\n      } catch (e) {\n        store.rollback(key, token, prev);\n        throw toContentKitError(e);\n      }\n    },\n    [client, store, key, type, id, version, counts],\n  );\n  const toggle = useCallback((value: 1 | -1) => set(counts.mine === value ? 0 : value), [set, counts.mine]);\n  return { counts, loading: r.loading || (!r.loaded && o.initial === undefined), error: r.error, set, toggle };\n}\n\nexport interface UseFavorite {\n  favorited: boolean;\n  /** How many favorited the item; undefined until read. */\n  count?: number;\n  loading: boolean;\n  /** A write is in flight. */\n  pending: boolean;\n  error?: ContentKitError;\n  /** Sets it at once (count moved by one); rolled back if the server refuses it. */\n  set: (favorited: boolean) => Promise<void>;\n  toggle: () => Promise<void>;\n}\n\n/**\n * An item's favorite count and whether the signed-in caller favorited it\n * (initial: what the host already has). Signed out, favorited stays false.\n */\nexport function useFavorite(target: Target, o: { initial?: FavoriteState; client?: ContentKitClient } = {}): UseFavorite {\n  const { client, store, scope } = useContentScope(o.client);\n  const { type, id, version } = target;\n  const key = keyOf(\"favorite\", scope, type, id, version);\n  const r = useResource<FavoriteState>(store, key, { type: \"favorite\", target: { type, id, version } }, (s) => client.favorites.get({ type, id, version }, s), {\n    initial: o.initial,\n  });\n  const favorited = !!r.data?.favorited;\n  const [pending, setPending] = useState(false);\n  const set = useCallback(\n    async (next: boolean) => {\n      const prev = store.snapshot<FavoriteState>(key).data;\n      const token = store.mark(key);\n      if (prev && prev.favorited !== next) store.set<FavoriteState>(key, { favorited: next, count: Math.max(0, prev.count + (next ? 1 : -1)) });\n      setPending(true);\n      try {\n        await client.favorites.set({ type, id, version }, next);\n      } catch (e) {\n        if (prev) store.rollback(key, token, prev);\n        throw toContentKitError(e);\n      } finally {\n        setPending(false);\n      }\n    },\n    [client, store, key, type, id, version],\n  );\n  const toggle = useCallback(() => set(!favorited), [set, favorited]);\n  return { favorited, count: r.data?.count, loading: r.loading || (!r.loaded && o.initial === undefined), pending, error: r.error, set, toggle };\n}\n"],"mappings":";;;;;AAmBA,IAAM,IAAuB;CAAE,OAAO;CAAG,UAAU;CAAG,MAAM;AAAE;AAG9D,SAAgB,EAAY,GAAgB,IAA6D,CAAC,GAAgB;CACxH,IAAM,EAAE,WAAQ,UAAO,aAAU,EAAgB,EAAE,MAAM,GACnD,EAAE,SAAM,OAAI,eAAY,GACxB,IAAM,EAAM,YAAY,GAAO,GAAM,GAAI,CAAO,GAChD,IAAI,EAA4B,GAAO,GAAK;EAAE,MAAM;EAAY,QAAQ;GAAE;GAAM;GAAI;EAAQ;CAAE,IAAI,MAAM,EAAO,UAAU,IAAI;EAAE;EAAM;EAAI;CAAQ,GAAG,CAAC,GAAG,EAC5J,SAAS,EAAE,QACb,CAAC,GACK,IAAS,EAAE,QAAQ,GACnB,IAAM,EACV,OAAO,MAAoB;EACzB,IAAM,IAAO,EAAM,SAAyB,CAAG,CAAC,CAAC,QAAQ,GACnD,IAAQ,EAAM,KAAK,CAAG;EAC5B,EAAM,IAAI,GAAK,EAAa,GAAM,CAAK,CAAC;EACxC,IAAI;GACF,MAAM,EAAO,UAAU,IAAI;IAAE;IAAM;IAAI;GAAQ,GAAG,CAAK;EACzD,SAAS,GAAG;GAEV,MADA,EAAM,SAAS,GAAK,GAAO,CAAI,GACzB,EAAkB,CAAC;EAC3B;CACF,GACA;EAAC;EAAQ;EAAO;EAAK;EAAM;EAAI;EAAS;CAAM,CAChD,GACM,IAAS,GAAa,MAAkB,EAAI,EAAO,SAAS,IAAQ,IAAI,CAAK,GAAG,CAAC,GAAK,EAAO,IAAI,CAAC;CACxG,OAAO;EAAE;EAAQ,SAAS,EAAE,WAAY,CAAC,EAAE,UAAU,EAAE,YAAY,KAAA;EAAY,OAAO,EAAE;EAAO;EAAK;CAAO;AAC7G;AAmBA,SAAgB,EAAY,GAAgB,IAA4D,CAAC,GAAgB;CACvH,IAAM,EAAE,WAAQ,UAAO,aAAU,EAAgB,EAAE,MAAM,GACnD,EAAE,SAAM,OAAI,eAAY,GACxB,IAAM,EAAM,YAAY,GAAO,GAAM,GAAI,CAAO,GAChD,IAAI,EAA2B,GAAO,GAAK;EAAE,MAAM;EAAY,QAAQ;GAAE;GAAM;GAAI;EAAQ;CAAE,IAAI,MAAM,EAAO,UAAU,IAAI;EAAE;EAAM;EAAI;CAAQ,GAAG,CAAC,GAAG,EAC3J,SAAS,EAAE,QACb,CAAC,GACK,IAAY,CAAC,CAAC,EAAE,MAAM,WACtB,CAAC,GAAS,KAAc,EAAS,EAAK,GACtC,IAAM,EACV,OAAO,MAAkB;EACvB,IAAM,IAAO,EAAM,SAAwB,CAAG,CAAC,CAAC,MAC1C,IAAQ,EAAM,KAAK,CAAG;EAE5B,AADI,KAAQ,EAAK,cAAc,KAAM,EAAM,IAAmB,GAAK;GAAE,WAAW;GAAM,OAAO,KAAK,IAAI,GAAG,EAAK,SAAS,IAAO,IAAI,GAAG;EAAE,CAAC,GACxI,EAAW,EAAI;EACf,IAAI;GACF,MAAM,EAAO,UAAU,IAAI;IAAE;IAAM;IAAI;GAAQ,GAAG,CAAI;EACxD,SAAS,GAAG;GAEV,MADI,KAAM,EAAM,SAAS,GAAK,GAAO,CAAI,GACnC,EAAkB,CAAC;EAC3B,UAAU;GACR,EAAW,EAAK;EAClB;CACF,GACA;EAAC;EAAQ;EAAO;EAAK;EAAM;EAAI;CAAO,CACxC,GACM,IAAS,QAAkB,EAAI,CAAC,CAAS,GAAG,CAAC,GAAK,CAAS,CAAC;CAClE,OAAO;EAAE;EAAW,OAAO,EAAE,MAAM;EAAO,SAAS,EAAE,WAAY,CAAC,EAAE,UAAU,EAAE,YAAY,KAAA;EAAY;EAAS,OAAO,EAAE;EAAO;EAAK;CAAO;AAC/I"}

package/dist/react/folder.js

@@ -1,17 +1,18 @@
 import { ContentKitError as e, failureError as t, toContentKitError as n } from "../client/errors.js";
-import { stem as r } from "../client/media/client.js";
-import { filesFor as i, isPattern as a, ruleDir as o, ruleFor as s, screenFiles as ee, uniqueName as te, uploadRules as c } from "../client/media/rules.js";
-import { useContentKitClient as l, useErrorReporter as ne } from "./context.js";
-import { useUploadQueue as u } from "./upload.js";
+import { itemKey as r } from "../client/media/ref.js";
+import { stem as i } from "../client/media/client.js";
+import { filesFor as a, isPattern as o, ruleDir as s, ruleFor as c, screenFiles as ee, uniqueName as te, uploadRules as l } from "../client/media/rules.js";
+import { useContentKitClient as u, useErrorReporter as d } from "./context.js";
+import { useUploadQueue as ne } from "./upload.js";
 import { useMediaRead as re } from "./read.js";
-import { useCallback as d, useEffect as f, useMemo as p, useRef as m, useState as h } from "react";
+import { useCallback as f, useEffect as p, useMemo as m, useRef as h, useState as g } from "react";
 //#region src/react/folder.ts
 var ie = {
 	start: 0,
 	end: 2 ** 53 - 1,
 	chunk: 200
-}, g = (e, t) => t.slice(o(e.path).length);
-function _(e, t) {
+}, _ = (e, t) => t.slice(s(e.path).length);
+function v(e, t) {
 	let n;
 	for (let r of e?.files ?? []) !r.upload && r.from === t.path && r.url && r.type.startsWith("image/") && (!n || (r.w ?? Infinity) < (n.w ?? Infinity)) && (n = r);
 	return n;
@@ -19,43 +20,43 @@ function _(e, t) {
 var ae = {
 	kind: "",
 	id: ""
-}, oe = (e) => e ? `${e.kind}/${e.id}` : "", v = /* @__PURE__ */ new WeakMap();
+}, oe = (e) => e ? r(e) : "", y = /* @__PURE__ */ new WeakMap();
 function se(t) {
-	let n = v.get(t);
-	return n || v.set(t, n = new e("forbidden", "the editor read states no upload rules", { status: 403 })), n;
+	let n = y.get(t);
+	return n || y.set(t, n = new e("forbidden", "the editor read states no upload rules", { status: 403 })), n;
 }
 function ce(e, t) {
 	return e.filter((e) => e.status !== "failed" && !(e.status === "committed" && t.has(e.path)));
 }
-function y(_, v = {}) {
-	let y = l(v.client), b = ne(v.onError), x = _ ?? null, S = oe(x), C = x ?? ae, w = re(C, {
+function b(r, v = {}) {
+	let y = u(v.client), b = d(v.onError), x = r ?? null, S = oe(x), C = x ?? ae, w = re(C, {
 		editor: !0,
 		window: ie,
 		poll: v.poll,
 		client: y,
 		read: x ? void 0 : null
-	}), T = c(w.read), E = v.paths?.join("\n"), D = p(() => E === void 0 ? T.filter((e) => a(e.path) && !e.named).map((e) => e.path) : E.split("\n").filter(Boolean), [E, T]), O = p(() => {
+	}), T = l(w.read), E = v.paths?.join("\n"), D = m(() => E === void 0 ? T.filter((e) => o(e.path) && !e.named).map((e) => e.path) : E.split("\n").filter(Boolean), [E, T]), O = m(() => {
 		let e = T.length ? T : D.map((e) => ({ path: e }));
 		return D.map((t) => ({
 			path: t,
 			rule: T.find((e) => e.path === t),
-			files: i(w.read, { path: t }, e)
+			files: a(w.read, { path: t }, e)
 		}));
 	}, [
 		D,
 		T,
 		w.read
-	]), k = p(() => O.flatMap((e) => e.files), [O]), A = p(() => new Set(k.map((e) => e.path)), [k]), j = u({
+	]), k = m(() => O.flatMap((e) => e.files), [O]), A = m(() => new Set(k.map((e) => e.path)), [k]), j = ne({
 		client: y,
 		ref: C,
-		path: `${o(D[0] ?? "{name}")}{name}`,
+		path: `${s(D[0] ?? "{name}")}{name}`,
 		concurrency: v.concurrency
-	}), M = j.queue, N = p(() => j.items.filter((e) => !(e.status === "committed" && A.has(e.path))), [j.items, A]), le = {
+	}), M = j.queue, N = m(() => j.items.filter((e) => !(e.status === "committed" && A.has(e.path))), [j.items, A]), le = {
 		...j,
 		items: N
-	}, [ue, P] = h([]), [F, I] = h([]), L = m([]), [R, de] = h(0), [z, fe] = h(!1), [pe, B] = h(), [me, V] = h(), H = me?.key === S ? me.error : void 0, U = m(v);
+	}, [ue, P] = g([]), [F, I] = g([]), L = h([]), [R, de] = g(0), [z, fe] = g(!1), [pe, B] = g(), [me, V] = g(), H = me?.key === S ? me.error : void 0, U = h(v);
 	U.current = v;
-	let W = !!x && !!w.read?.uploads, G = x ? w.read ? w.read.uploads ? void 0 : se(w.read) : w.error : void 0, K = m({
+	let W = !!x && !!w.read?.uploads, G = x ? w.read ? w.read.uploads ? void 0 : se(w.read) : w.error : void 0, K = h({
 		groups: O,
 		ref: C,
 		listed: A,
@@ -69,41 +70,41 @@ function y(_, v = {}) {
 		ready: W,
 		loadError: G
 	};
-	let he = d((e) => {
+	let he = f((e) => {
 		let { groups: t, listed: n } = K.current, r = t.map((e) => e.rule ?? {
 			path: e.path,
 			types: [],
 			max_bytes: 0
-		}), i = ce(M.getSnapshot().items, n), a = (e, t) => s(r, e)?.path === t.path, c = ee(e, r, (e) => t.find((t) => t.path === e.path).files.length + i.filter((t) => a(t.path, e)).length), l = /* @__PURE__ */ new Map(), ne = (e) => {
+		}), i = ce(M.getSnapshot().items, n), a = (e, t) => c(r, e)?.path === t.path, o = ee(e, r, (e) => t.find((t) => t.path === e.path).files.length + i.filter((t) => a(t.path, e)).length), l = /* @__PURE__ */ new Map(), u = (e) => {
 			let n = l.get(e.path);
 			if (!n) {
 				let r = t.find((t) => t.path === e.path);
-				n = [...r.files.map((e) => g(r, e.path)), ...i.filter((t) => a(t.path, e)).map((e) => g(r, e.path))], l.set(e.path, n);
+				n = [...r.files.map((e) => _(r, e.path)), ...i.filter((t) => a(t.path, e)).map((e) => _(r, e.path))], l.set(e.path, n);
 			}
 			return n;
-		}, u = /* @__PURE__ */ new Map();
-		for (let { file: e, rule: t } of c.accepted) {
-			let n = ne(t), r = U.current.name?.(e) ?? te(e.name, n);
-			n.push(r), u.set(e, o(t.path) + r);
+		}, d = /* @__PURE__ */ new Map();
+		for (let { file: e, rule: t } of o.accepted) {
+			let n = u(t), r = U.current.name?.(e) ?? te(e.name, n);
+			n.push(r), d.set(e, s(t.path) + r);
 		}
-		u.size && (M.add(u.keys(), { path: (e) => u.get(e) }), M.start(), V(void 0)), P(c.refused);
-		for (let e of c.refused) b(e.error, "upload", e.file.name);
-	}, [M, b]), q = d(() => {
+		d.size && (M.add(d.keys(), { path: (e) => d.get(e) }), M.start(), V(void 0)), P(o.refused);
+		for (let e of o.refused) b(e.error, "upload", e.file.name);
+	}, [M, b]), q = f(() => {
 		let e = L.current, { ready: t, loadError: n } = K.current;
 		return !e.length || !t && !n ? !1 : (L.current = [], I([]), t ? he(e) : P(e.map((e) => ({
 			file: e,
 			error: n
 		}))), !0);
-	}, [he]), ge = d((e) => {
+	}, [he]), ge = f((e) => {
 		let t = [...e];
 		t.length && (L.current = [...L.current, ...t], q() || I(L.current));
 	}, [q]);
-	f(() => void q(), [
+	p(() => void q(), [
 		q,
 		W,
 		G
 	]);
-	let J = d(async (e, t) => {
+	let J = f(async (e, t) => {
 		de((e) => e + 1);
 		try {
 			t ? await t() : await y.media.commit(K.current.ref, e), B(void 0);
@@ -113,7 +114,7 @@ function y(_, v = {}) {
 		} finally {
 			de((e) => e - 1);
 		}
-	}, [y, b]), Y = d(async () => {
+	}, [y, b]), Y = f(async () => {
 		fe(!0);
 		try {
 			let e = await M.commit(void 0, { head: U.current.commit === "auto" });
@@ -125,7 +126,7 @@ function y(_, v = {}) {
 			fe(!1);
 		}
 	}, [M, b]);
-	f(() => {
+	p(() => {
 		for (let e of j.items) e.status === "committed" && (A.has(e.path) || !w.loading) && M.remove(e.id);
 	}, [
 		j.items,
@@ -134,7 +135,7 @@ function y(_, v = {}) {
 		M
 	]);
 	let X = v.commit === "auto", Z = N.find((e) => e.status !== "committed")?.status === "uploaded";
-	f(() => {
+	p(() => {
 		X && Z && !z && !H && Y().catch((e) => V({
 			key: S,
 			error: n(e)
@@ -147,8 +148,8 @@ function y(_, v = {}) {
 		Y,
 		S
 	]);
-	let _e = d(async () => (V(void 0), Y()), [Y]), Q = m(/* @__PURE__ */ new Set());
-	f(() => {
+	let _e = f(async () => (V(void 0), Y()), [Y]), Q = h(/* @__PURE__ */ new Set());
+	p(() => {
 		for (let e of j.items) e.status === "failed" && e.error && !Q.current.has(e.error) && (Q.current.add(e.error), b(e.error, "upload", e.file.name));
 		j.blocked && !Q.current.has(j.blocked) && (Q.current.add(j.blocked), b(j.blocked, "upload"));
 	}, [
@@ -156,8 +157,8 @@ function y(_, v = {}) {
 		j.blocked,
 		b
 	]);
-	let $ = m(null);
-	f(() => {
+	let $ = h(null);
+	p(() => {
 		if (!w.read) return;
 		let e = k.filter((e) => e.failed);
 		if ($.current?.key !== S) {
@@ -176,8 +177,8 @@ function y(_, v = {}) {
 		k,
 		b,
 		S
-	]), f(() => void (w.error && b(w.error, "folder.load")), [w.error, b]);
-	let ve = F.length > 0 || z || R > 0 || X && Z && !H || N.some((e) => e.status === "uploading" || e.status === "queued" && !j.blocked), ye = k.length + F.length + ce(N, A).length, be = (e) => K.current.groups.find((t) => s([{ path: t.path }], e));
+	]), p(() => void (w.error && b(w.error, "folder.load")), [w.error, b]);
+	let ve = F.length > 0 || z || R > 0 || X && Z && !H || N.some((e) => e.status === "uploading" || e.status === "queued" && !j.blocked), ye = k.length + F.length + ce(N, A).length, be = (e) => K.current.groups.find((t) => c([{ path: t.path }], e));
 	return {
 		ref: x,
 		options: v,
@@ -188,20 +189,20 @@ function y(_, v = {}) {
 		waiting: F,
 		add: ge,
 		refused: ue,
-		dismiss: d(() => P([]), []),
-		move: d((e, t) => J([{
+		dismiss: f(() => P([]), []),
+		move: f((e, t) => J([{
 			op: "move",
 			path: e,
 			index: t
 		}]), [J]),
-		remove: d((e) => J(e.map((e) => ({
+		remove: f((e) => J(e.map((e) => ({
 			op: "remove",
 			path: e
 		}))), [J]),
-		rename: d((t, n) => {
-			let i = be(t), a = (i ? o(i.path) : t.slice(0, t.lastIndexOf("/") + 1)) + n.trim();
-			if (r(a) === r(t)) return Promise.resolve();
-			if (i?.files.some((e) => r(e.path) === r(a))) {
+		rename: f((t, n) => {
+			let r = be(t), a = (r ? s(r.path) : t.slice(0, t.lastIndexOf("/") + 1)) + n.trim();
+			if (i(a) === i(t)) return Promise.resolve();
+			if (r?.files.some((e) => i(e.path) === i(a))) {
 				let t = new e("conflict", `${n} exists`, { status: 409 });
 				return B(t), Promise.reject(t);
 			}
@@ -211,18 +212,18 @@ function y(_, v = {}) {
 				to: a
 			}]);
 		}, [J]),
-		edit: d((e, t) => J([{
+		edit: f((e, t) => J([{
 			op: "edit",
 			path: e,
 			...t ? { edit: t } : {}
 		}]), [J]),
-		replace: d((e, t) => J([], () => y.media.put(t, {
+		replace: f((e, t) => J([], () => y.media.put(t, {
 			ref: K.current.ref,
-			path: r(e),
+			path: i(e),
 			wait: !1
 		})), [J, y]),
 		commit: _e,
-		discard: d(() => {
+		discard: f(() => {
 			L.current = [], I([]);
 			for (let e of M.getSnapshot().items) M.remove(e.id);
 			M.pause();
@@ -235,6 +236,6 @@ function y(_, v = {}) {
 	};
 }
 //#endregion
-export { g as nameIn, _ as thumbnailOf, y as useMediaFolder };
+export { _ as nameIn, v as thumbnailOf, b as useMediaFolder };
 
 //# sourceMappingURL=folder.js.map

package/dist/react/folder.js.map

@@ -1 +1 @@
-{"version":3,"file":"folder.js","names":[],"sources":["../../src/react/folder.ts"],"sourcesContent":["import { useCallback, useEffect, useMemo, useRef, useState } from \"react\";\nimport type { ContentKitClient } from \"../client/client.js\";\nimport { ContentKitError, failureError, toContentKitError } from \"../client/errors.js\";\nimport type { Edit, FileInfo, Op, ReadResult, RefBody, UploadRule } from \"../client/generated/wire.js\";\nimport { stem } from \"../client/media/client.js\";\nimport type { QueueItem } from \"../client/media/queue.js\";\nimport { filesFor, isPattern, ruleDir, ruleFor, screenFiles, uniqueName, uploadRules, type Screened } from \"../client/media/rules.js\";\nimport { useContentKitClient, useErrorReporter, type ContentKitErrorHandler } from \"./context.js\";\nimport { useMediaRead, type UseMediaRead } from \"./read.js\";\nimport { useUploadQueue, type UseUploadQueue } from \"./upload.js\";\n\nexport interface MediaFolderOptions {\n  /**\n   * The upload paths shown and added to, e.g. [\"images/{name}\",\n   * \"videos/{name}\"]: one group each. Default every pattern path of the kind\n   * the server does not name. A file goes to the first path whose rule takes\n   * its type.\n   */\n  paths?: readonly string[];\n  /**\n   * \"manual\" (default): commit() adds the uploaded files. \"auto\": each\n   * upload commits once those before it have, in the order added (a draft).\n   */\n  commit?: \"manual\" | \"auto\";\n  /** A file's name under its path; default its own, numbered around names taken. */\n  name?: (file: File) => string;\n  /** Files uploading at once. Default 2. */\n  concurrency?: number;\n  /** Poll interval (ms) while uploads process. Default 2500. */\n  poll?: number | false;\n  /** Every failure (uploads, commits, updates, processing); default the provider's. */\n  onError?: ContentKitErrorHandler;\n  /** Overrides the provider's client. */\n  client?: ContentKitClient;\n}\n\nexport interface FolderGroup {\n  /** The upload path, e.g. \"images/{name}\". */\n  path: string;\n  /** Its rules, once an editor read states them. */\n  rule?: UploadRule;\n  /** Its uploads in manifest order. */\n  files: FileInfo[];\n}\n\nexport interface UseMediaFolder {\n  /** The item; null until the host has one (files added meanwhile wait for it). */\n  ref: RefBody | null;\n  /** The options the folder was opened with. */\n  options: MediaFolderOptions;\n  /** The editor read of the item (every window, polled while processing). */\n  read: UseMediaRead;\n  groups: FolderGroup[];\n  /** Every group's uploads. */\n  uploads: FileInfo[];\n  /** The upload queue; a file leaves it once the editor read lists it. */\n  queue: UseUploadQueue;\n  /**\n   * Files added before the item and its editor read (the upload rules) were\n   * known. They are screened and queued when the rules arrive, or refused\n   * when the read fails or states no rules (the actor may not edit the item).\n   */\n  waiting: readonly File[];\n  /** Screens files against the rules and queues the rest (once the rules are known); refusals land in refused. */\n  add: (files: Iterable<File>) => void;\n  /** The last screening's refusals. */\n  refused: Screened[\"refused\"];\n  dismiss: () => void;\n  /** Moves an upload to index among its group's uploads. */\n  move: (path: string, index: number) => Promise<void>;\n  remove: (paths: readonly string[]) => Promise<void>;\n  /** Renames an upload within its path; the extension stays unless name has one. */\n  rename: (path: string, name: string) => Promise<void>;\n  edit: (path: string, edit: Edit | null) => Promise<void>;\n  /** Uploads file in place of the upload at path (same position and meta, no edit). */\n  replace: (path: string, file: File) => Promise<void>;\n  /** Commits the uploaded files in queue order. */\n  commit: () => Promise<FileInfo[]>;\n  /** Stops every upload, aborts its multipart upload and empties the queue (before deleting a draft). */\n  discard: () => void;\n  /** An update (move, remove, rename, edit, replace) is running. */\n  updating: boolean;\n  committing: boolean;\n  /**\n   * Work is in flight: files wait for the rules, uploads are queued or\n   * running, an automatic commit is due, or a commit or update runs.\n   * Leaving the page now interrupts it.\n   */\n  busy: boolean;\n  /** The item's uploads plus the files on their way in (waiting, queued, uploading, uploaded, being added); failed uploads are not counted. */\n  fileCount: number;\n  /** The last update's or commit's failure; cleared by the next success. */\n  error?: ContentKitError;\n}\n\nconst ALL = { start: 0, end: Number.MAX_SAFE_INTEGER, chunk: 200 };\n\n/** The upload's name under its group (\"images/a.png\" in \"images/{name}\" is \"a.png\"). */\nexport const nameIn = (group: { path: string }, path: string) => path.slice(ruleDir(group.path).length);\n\n/** Its smallest derived image with a URL: a thumbnail for an editor. */\nexport function thumbnailOf(read: ReadResult | null | undefined, upload: FileInfo): FileInfo | undefined {\n  let best: FileInfo | undefined;\n  for (const f of read?.files ?? []) {\n    if (f.upload || f.from !== upload.path || !f.url || !f.type.startsWith(\"image/\")) continue;\n    if (!best || (f.w ?? Infinity) < (best.w ?? Infinity)) best = f;\n  }\n  return best;\n}\n\nconst NO_ITEM: RefBody = { kind: \"\", id: \"\" };\nconst keyOf = (ref: RefBody | null) => (ref ? `${ref.kind}/${ref.id}` : \"\");\n\nconst noRules = new WeakMap<ReadResult, ContentKitError>();\n/** The refusal for files added to an item whose read carries no upload rules (one per read). */\nfunction notEditor(read: ReadResult): ContentKitError {\n  let e = noRules.get(read);\n  if (!e) noRules.set(read, (e = new ContentKitError(\"forbidden\", \"the editor read states no upload rules\", { status: 403 })));\n  return e;\n}\n\n/** Queue items still on their way in: not failed, and not yet listed by the read. */\nfunction inbound(items: readonly QueueItem[], listed: ReadonlySet<string>) {\n  return items.filter((i) => i.status !== \"failed\" && !(i.status === \"committed\" && listed.has(i.path)));\n}\n\n/**\n * An item's folder for its editors: the editor read, an upload queue, the\n * kind's upload rules screening files before they upload, and the updates\n * (move, remove, rename, edit, replace). Files added before the editor read\n * arrives wait for its rules; with a null ref they wait for the item too (a\n * draft created on the first drop). Uploads the worker fails after the read\n * are reported once (\"folder.process\"). Another ref gets a fresh queue.\n */\nexport function useMediaFolder(ref: RefBody | null | undefined, o: MediaFolderOptions = {}): UseMediaFolder {\n  const client = useContentKitClient(o.client);\n  const report = useErrorReporter(o.onError);\n  const item = ref ?? null;\n  const key = keyOf(item);\n  const target = item ?? NO_ITEM;\n  // Without an item there is nothing to read: a supplied null read never fetches.\n  const read = useMediaRead(target, { editor: true, window: ALL, poll: o.poll, client, read: item ? undefined : null });\n  const rules = uploadRules(read.read);\n  const pathsKey = o.paths?.join(\"\\n\");\n  const groupPaths = useMemo(\n    () => (pathsKey !== undefined ? pathsKey.split(\"\\n\").filter(Boolean) : rules.filter((r) => isPattern(r.path) && !r.named).map((r) => r.path)),\n    [pathsKey, rules],\n  );\n  const groups = useMemo((): FolderGroup[] => {\n    const known: { path: string }[] = rules.length ? rules : groupPaths.map((path) => ({ path }));\n    return groupPaths.map((path) => ({ path, rule: rules.find((r) => r.path === path), files: filesFor(read.read, { path }, known) }));\n  }, [groupPaths, rules, read.read]);\n  const uploads = useMemo(() => groups.flatMap((g) => g.files), [groups]);\n  const listed = useMemo(() => new Set(uploads.map((f) => f.path)), [uploads]);\n\n  const raw = useUploadQueue({ client, ref: target, path: `${ruleDir(groupPaths[0] ?? \"{name}\")}{name}`, concurrency: o.concurrency });\n  // The ItemUploadQueue itself is stable per item; the hook's wrapper is new every render.\n  const q = raw.queue;\n  // A committed file stays in the queue until the read lists it, so it never drops out of view.\n  const items = useMemo(() => raw.items.filter((i) => !(i.status === \"committed\" && listed.has(i.path))), [raw.items, listed]);\n  const queue = { ...raw, items };\n  const [refused, setRefused] = useState<Screened[\"refused\"]>([]);\n  const [waiting, setWaiting] = useState<readonly File[]>([]);\n  const pending = useRef<File[]>([]);\n  const [updating, setUpdating] = useState(0);\n  const [committing, setCommitting] = useState(false);\n  const [error, setError] = useState<ContentKitError>();\n  // An automatic commit that failed: no more until commit() or new files.\n  const [stall, setStall] = useState<{ key: string; error: ContentKitError }>();\n  const stalled = stall?.key === key ? stall.error : undefined;\n  const opts = useRef(o);\n  opts.current = o;\n  // The rules are known once the item's editor read states them. A failed read\n  // refuses what waits, and so does one without rules: the server answered a\n  // viewer's read, so nothing uploads here.\n  const ready = !!item && !!read.read?.uploads;\n  const loadError = !item ? undefined : !read.read ? read.error : !read.read.uploads ? notEditor(read.read) : undefined;\n  const live = useRef({ groups, ref: target, listed, ready, loadError });\n  live.current = { groups, ref: target, listed, ready, loadError };\n\n  const place = useCallback(\n    (files: File[]) => {\n      const { groups, listed } = live.current;\n      const gs = groups.map((g) => g.rule ?? { path: g.path, types: [], max_bytes: 0 });\n      const queued = inbound(q.getSnapshot().items, listed);\n      const inGroup = (path: string, rule: UploadRule) => ruleFor(gs, path)?.path === rule.path;\n      const s = screenFiles(files, gs, (rule) => groups.find((g) => g.path === rule.path)!.files.length + queued.filter((i) => inGroup(i.path, rule)).length);\n      const taken = new Map<string, string[]>();\n      const takenIn = (rule: UploadRule) => {\n        let t = taken.get(rule.path);\n        if (!t) {\n          const g = groups.find((x) => x.path === rule.path)!;\n          t = [...g.files.map((f) => nameIn(g, f.path)), ...queued.filter((i) => inGroup(i.path, rule)).map((i) => nameIn(g, i.path))];\n          taken.set(rule.path, t);\n        }\n        return t;\n      };\n      const paths = new Map<File, string>();\n      for (const { file, rule } of s.accepted) {\n        const t = takenIn(rule);\n        const name = opts.current.name?.(file) ?? uniqueName(file.name, t);\n        t.push(name);\n        paths.set(file, ruleDir(rule.path) + name);\n      }\n      if (paths.size) {\n        q.add(paths.keys(), { path: (f) => paths.get(f)! });\n        // New files lift a block and restart a queue discard() paused.\n        q.start();\n        setStall(undefined);\n      }\n      setRefused(s.refused);\n      for (const r of s.refused) report(r.error, \"upload\", r.file.name);\n    },\n    [q, report],\n  );\n\n  // Screens what waits once the rules are known; a failed read refuses it (the read failure is reported once, as folder.load).\n  const flush = useCallback(() => {\n    const files = pending.current;\n    const { ready, loadError } = live.current;\n    if (!files.length || (!ready && !loadError)) return false;\n    pending.current = [];\n    setWaiting([]);\n    if (ready) place(files);\n    else setRefused(files.map((file) => ({ file, error: loadError! })));\n    return true;\n  }, [place]);\n\n  const add = useCallback(\n    (files: Iterable<File>) => {\n      const list = [...files];\n      if (!list.length) return;\n      pending.current = [...pending.current, ...list];\n      if (!flush()) setWaiting(pending.current);\n    },\n    [flush],\n  );\n  useEffect(() => void flush(), [flush, ready, loadError]);\n\n  const update = useCallback(\n    async (ops: Op[], run?: () => Promise<unknown>) => {\n      setUpdating((n) => n + 1);\n      try {\n        if (run) await run();\n        else await client.media.commit(live.current.ref, ops);\n        setError(undefined);\n      } catch (e) {\n        const err = toContentKitError(e);\n        if (err.code !== \"aborted\") setError(err);\n        report(err, \"folder.update\");\n        throw err;\n      } finally {\n        setUpdating((n) => n - 1);\n      }\n    },\n    [client, report],\n  );\n\n  const commit = useCallback(async () => {\n    setCommitting(true);\n    try {\n      const files = await q.commit(undefined, { head: opts.current.commit === \"auto\" });\n      setError(undefined);\n      return files;\n    } catch (e) {\n      const err = toContentKitError(e);\n      setError(err);\n      report(err, \"folder.commit\");\n      throw err;\n    } finally {\n      setCommitting(false);\n    }\n  }, [q, report]);\n\n  // Committed files leave the queue once the read lists them, or once a read lands without them.\n  useEffect(() => {\n    for (const i of raw.items) if (i.status === \"committed\" && (listed.has(i.path) || !read.loading)) q.remove(i.id);\n  }, [raw.items, listed, read.loading, q]);\n\n  // A draft commits the uploaded head of the queue as it finishes; a failed commit waits for commit().\n  const auto = o.commit === \"auto\";\n  const headReady = items.find((i) => i.status !== \"committed\")?.status === \"uploaded\";\n  useEffect(() => {\n    if (!auto || !headReady || committing || stalled) return;\n    commit().catch((e: unknown) => setStall({ key, error: toContentKitError(e) }));\n  }, [auto, headReady, committing, stalled, commit, key]);\n  const manualCommit = useCallback(async () => {\n    setStall(undefined);\n    return commit();\n  }, [commit]);\n\n  // Each failed upload and queue-wide refusal is reported once; rows keep showing it.\n  const seen = useRef(new Set<unknown>());\n  useEffect(() => {\n    for (const i of raw.items) {\n      if (i.status !== \"failed\" || !i.error || seen.current.has(i.error)) continue;\n      seen.current.add(i.error);\n      report(i.error, \"upload\", i.file.name);\n    }\n    if (raw.blocked && !seen.current.has(raw.blocked)) {\n      seen.current.add(raw.blocked);\n      report(raw.blocked, \"upload\");\n    }\n  }, [raw.items, raw.blocked, report]);\n\n  // Processing failures that appear after the item's first read.\n  const failures = useRef<{ key: string; seen: Set<string> } | null>(null);\n  useEffect(() => {\n    if (!read.read) return;\n    const failed = uploads.filter((f) => f.failed);\n    if (failures.current?.key !== key) {\n      failures.current = { key, seen: new Set(failed.map((f) => `${f.path}:${f.failed!.of}`)) };\n      return;\n    }\n    for (const f of failed) {\n      const id = `${f.path}:${f.failed!.of}`;\n      if (failures.current.seen.has(id)) continue;\n      failures.current.seen.add(id);\n      report(failureError(f.failed!), \"folder.process\", f.path.split(\"/\").pop());\n    }\n  }, [read.read, uploads, report, key]);\n\n  useEffect(() => void (read.error && report(read.error, \"folder.load\")), [read.error, report]);\n\n  const busy =\n    waiting.length > 0 ||\n    committing ||\n    updating > 0 ||\n    (auto && headReady && !stalled) ||\n    items.some((i) => i.status === \"uploading\" || (i.status === \"queued\" && !raw.blocked));\n  const fileCount = uploads.length + waiting.length + inbound(items, listed).length;\n\n  // Reads the latest groups, so callbacks stay stable.\n  const groupOf = (path: string) => live.current.groups.find((g) => ruleFor([{ path: g.path }], path));\n  return {\n    ref: item,\n    options: o,\n    read,\n    groups,\n    uploads,\n    queue,\n    waiting,\n    add,\n    refused,\n    dismiss: useCallback(() => setRefused([]), []),\n    move: useCallback((path, index) => update([{ op: \"move\", path, index }]), [update]),\n    remove: useCallback((paths) => update(paths.map((path): Op => ({ op: \"remove\", path }))), [update]),\n    rename: useCallback(\n      (path, name) => {\n        const g = groupOf(path);\n        const to = (g ? ruleDir(g.path) : path.slice(0, path.lastIndexOf(\"/\") + 1)) + name.trim();\n        if (stem(to) === stem(path)) return Promise.resolve();\n        if (g?.files.some((f) => stem(f.path) === stem(to))) {\n          const err = new ContentKitError(\"conflict\", `${name} exists`, { status: 409 });\n          setError(err);\n          return Promise.reject(err);\n        }\n        return update([{ op: \"rename\", path, to }]);\n      },\n      [update],\n    ),\n    edit: useCallback((path, edit) => update([{ op: \"edit\", path, ...(edit ? { edit } : {}) }]), [update]),\n    replace: useCallback(\n      (path, file) => update([], () => client.media.put(file, { ref: live.current.ref, path: stem(path), wait: false })),\n      [update, client],\n    ),\n    commit: manualCommit,\n    discard: useCallback(() => {\n      pending.current = [];\n      setWaiting([]);\n      for (const i of q.getSnapshot().items) q.remove(i.id);\n      q.pause();\n    }, [q]),\n    updating: updating > 0,\n    committing,\n    busy,\n    fileCount,\n    error: error ?? stalled,\n  };\n}\n"],"mappings":"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"}
+{"version":3,"file":"folder.js","names":[],"sources":["../../src/react/folder.ts"],"sourcesContent":["import { useCallback, useEffect, useMemo, useRef, useState } from \"react\";\nimport { itemKey } from \"../client/media/ref.js\";\nimport type { ContentKitClient } from \"../client/client.js\";\nimport { ContentKitError, failureError, toContentKitError } from \"../client/errors.js\";\nimport type { Edit, FileInfo, Op, ReadResult, RefBody, UploadRule } from \"../client/generated/wire.js\";\nimport { stem } from \"../client/media/client.js\";\nimport type { QueueItem } from \"../client/media/queue.js\";\nimport { filesFor, isPattern, ruleDir, ruleFor, screenFiles, uniqueName, uploadRules, type Screened } from \"../client/media/rules.js\";\nimport { useContentKitClient, useErrorReporter, type ContentKitErrorHandler } from \"./context.js\";\nimport { useMediaRead, type UseMediaRead } from \"./read.js\";\nimport { useUploadQueue, type UseUploadQueue } from \"./upload.js\";\n\nexport interface MediaFolderOptions {\n  /**\n   * The upload paths shown and added to, e.g. [\"images/{name}\",\n   * \"videos/{name}\"]: one group each. Default every pattern path of the kind\n   * the server does not name. A file goes to the first path whose rule takes\n   * its type.\n   */\n  paths?: readonly string[];\n  /**\n   * \"manual\" (default): commit() adds the uploaded files. \"auto\": each\n   * upload commits once those before it have, in the order added (a draft).\n   */\n  commit?: \"manual\" | \"auto\";\n  /** A file's name under its path; default its own, numbered around names taken. */\n  name?: (file: File) => string;\n  /** Files uploading at once. Default 2. */\n  concurrency?: number;\n  /** Poll interval (ms) while uploads process. Default 2500. */\n  poll?: number | false;\n  /** Every failure (uploads, commits, updates, processing); default the provider's. */\n  onError?: ContentKitErrorHandler;\n  /** Overrides the provider's client. */\n  client?: ContentKitClient;\n}\n\nexport interface FolderGroup {\n  /** The upload path, e.g. \"images/{name}\". */\n  path: string;\n  /** Its rules, once an editor read states them. */\n  rule?: UploadRule;\n  /** Its uploads in manifest order. */\n  files: FileInfo[];\n}\n\nexport interface UseMediaFolder {\n  /** The item; null until the host has one (files added meanwhile wait for it). */\n  ref: RefBody | null;\n  /** The options the folder was opened with. */\n  options: MediaFolderOptions;\n  /** The editor read of the item (every window, polled while processing). */\n  read: UseMediaRead;\n  groups: FolderGroup[];\n  /** Every group's uploads. */\n  uploads: FileInfo[];\n  /** The upload queue; a file leaves it once the editor read lists it. */\n  queue: UseUploadQueue;\n  /**\n   * Files added before the item and its editor read (the upload rules) were\n   * known. They are screened and queued when the rules arrive, or refused\n   * when the read fails or states no rules (the actor may not edit the item).\n   */\n  waiting: readonly File[];\n  /** Screens files against the rules and queues the rest (once the rules are known); refusals land in refused. */\n  add: (files: Iterable<File>) => void;\n  /** The last screening's refusals. */\n  refused: Screened[\"refused\"];\n  dismiss: () => void;\n  /** Moves an upload to index among its group's uploads. */\n  move: (path: string, index: number) => Promise<void>;\n  remove: (paths: readonly string[]) => Promise<void>;\n  /** Renames an upload within its path; the extension stays unless name has one. */\n  rename: (path: string, name: string) => Promise<void>;\n  edit: (path: string, edit: Edit | null) => Promise<void>;\n  /** Uploads file in place of the upload at path (same position and meta, no edit). */\n  replace: (path: string, file: File) => Promise<void>;\n  /** Commits the uploaded files in queue order. */\n  commit: () => Promise<FileInfo[]>;\n  /** Stops every upload, aborts its multipart upload and empties the queue (before deleting a draft). */\n  discard: () => void;\n  /** An update (move, remove, rename, edit, replace) is running. */\n  updating: boolean;\n  committing: boolean;\n  /**\n   * Work is in flight: files wait for the rules, uploads are queued or\n   * running, an automatic commit is due, or a commit or update runs.\n   * Leaving the page now interrupts it.\n   */\n  busy: boolean;\n  /** The item's uploads plus the files on their way in (waiting, queued, uploading, uploaded, being added); failed uploads are not counted. */\n  fileCount: number;\n  /** The last update's or commit's failure; cleared by the next success. */\n  error?: ContentKitError;\n}\n\nconst ALL = { start: 0, end: Number.MAX_SAFE_INTEGER, chunk: 200 };\n\n/** The upload's name under its group (\"images/a.png\" in \"images/{name}\" is \"a.png\"). */\nexport const nameIn = (group: { path: string }, path: string) => path.slice(ruleDir(group.path).length);\n\n/** Its smallest derived image with a URL: a thumbnail for an editor. */\nexport function thumbnailOf(read: ReadResult | null | undefined, upload: FileInfo): FileInfo | undefined {\n  let best: FileInfo | undefined;\n  for (const f of read?.files ?? []) {\n    if (f.upload || f.from !== upload.path || !f.url || !f.type.startsWith(\"image/\")) continue;\n    if (!best || (f.w ?? Infinity) < (best.w ?? Infinity)) best = f;\n  }\n  return best;\n}\n\nconst NO_ITEM: RefBody = { kind: \"\", id: \"\" };\nconst keyOf = (ref: RefBody | null) => (ref ? itemKey(ref) : \"\");\n\nconst noRules = new WeakMap<ReadResult, ContentKitError>();\n/** The refusal for files added to an item whose read carries no upload rules (one per read). */\nfunction notEditor(read: ReadResult): ContentKitError {\n  let e = noRules.get(read);\n  if (!e) noRules.set(read, (e = new ContentKitError(\"forbidden\", \"the editor read states no upload rules\", { status: 403 })));\n  return e;\n}\n\n/** Queue items still on their way in: not failed, and not yet listed by the read. */\nfunction inbound(items: readonly QueueItem[], listed: ReadonlySet<string>) {\n  return items.filter((i) => i.status !== \"failed\" && !(i.status === \"committed\" && listed.has(i.path)));\n}\n\n/**\n * An item's folder for its editors: the editor read, an upload queue, the\n * kind's upload rules screening files before they upload, and the updates\n * (move, remove, rename, edit, replace). Files added before the editor read\n * arrives wait for its rules; with a null ref they wait for the item too (a\n * draft created on the first drop). Uploads the worker fails after the read\n * are reported once (\"folder.process\"). Another ref gets a fresh queue.\n */\nexport function useMediaFolder(ref: RefBody | null | undefined, o: MediaFolderOptions = {}): UseMediaFolder {\n  const client = useContentKitClient(o.client);\n  const report = useErrorReporter(o.onError);\n  const item = ref ?? null;\n  const key = keyOf(item);\n  const target = item ?? NO_ITEM;\n  // Without an item there is nothing to read: a supplied null read never fetches.\n  const read = useMediaRead(target, { editor: true, window: ALL, poll: o.poll, client, read: item ? undefined : null });\n  const rules = uploadRules(read.read);\n  const pathsKey = o.paths?.join(\"\\n\");\n  const groupPaths = useMemo(\n    () => (pathsKey !== undefined ? pathsKey.split(\"\\n\").filter(Boolean) : rules.filter((r) => isPattern(r.path) && !r.named).map((r) => r.path)),\n    [pathsKey, rules],\n  );\n  const groups = useMemo((): FolderGroup[] => {\n    const known: { path: string }[] = rules.length ? rules : groupPaths.map((path) => ({ path }));\n    return groupPaths.map((path) => ({ path, rule: rules.find((r) => r.path === path), files: filesFor(read.read, { path }, known) }));\n  }, [groupPaths, rules, read.read]);\n  const uploads = useMemo(() => groups.flatMap((g) => g.files), [groups]);\n  const listed = useMemo(() => new Set(uploads.map((f) => f.path)), [uploads]);\n\n  const raw = useUploadQueue({ client, ref: target, path: `${ruleDir(groupPaths[0] ?? \"{name}\")}{name}`, concurrency: o.concurrency });\n  // The ItemUploadQueue itself is stable per item; the hook's wrapper is new every render.\n  const q = raw.queue;\n  // A committed file stays in the queue until the read lists it, so it never drops out of view.\n  const items = useMemo(() => raw.items.filter((i) => !(i.status === \"committed\" && listed.has(i.path))), [raw.items, listed]);\n  const queue = { ...raw, items };\n  const [refused, setRefused] = useState<Screened[\"refused\"]>([]);\n  const [waiting, setWaiting] = useState<readonly File[]>([]);\n  const pending = useRef<File[]>([]);\n  const [updating, setUpdating] = useState(0);\n  const [committing, setCommitting] = useState(false);\n  const [error, setError] = useState<ContentKitError>();\n  // An automatic commit that failed: no more until commit() or new files.\n  const [stall, setStall] = useState<{ key: string; error: ContentKitError }>();\n  const stalled = stall?.key === key ? stall.error : undefined;\n  const opts = useRef(o);\n  opts.current = o;\n  // The rules are known once the item's editor read states them. A failed read\n  // refuses what waits, and so does one without rules: the server answered a\n  // viewer's read, so nothing uploads here.\n  const ready = !!item && !!read.read?.uploads;\n  const loadError = !item ? undefined : !read.read ? read.error : !read.read.uploads ? notEditor(read.read) : undefined;\n  const live = useRef({ groups, ref: target, listed, ready, loadError });\n  live.current = { groups, ref: target, listed, ready, loadError };\n\n  const place = useCallback(\n    (files: File[]) => {\n      const { groups, listed } = live.current;\n      const gs = groups.map((g) => g.rule ?? { path: g.path, types: [], max_bytes: 0 });\n      const queued = inbound(q.getSnapshot().items, listed);\n      const inGroup = (path: string, rule: UploadRule) => ruleFor(gs, path)?.path === rule.path;\n      const s = screenFiles(files, gs, (rule) => groups.find((g) => g.path === rule.path)!.files.length + queued.filter((i) => inGroup(i.path, rule)).length);\n      const taken = new Map<string, string[]>();\n      const takenIn = (rule: UploadRule) => {\n        let t = taken.get(rule.path);\n        if (!t) {\n          const g = groups.find((x) => x.path === rule.path)!;\n          t = [...g.files.map((f) => nameIn(g, f.path)), ...queued.filter((i) => inGroup(i.path, rule)).map((i) => nameIn(g, i.path))];\n          taken.set(rule.path, t);\n        }\n        return t;\n      };\n      const paths = new Map<File, string>();\n      for (const { file, rule } of s.accepted) {\n        const t = takenIn(rule);\n        const name = opts.current.name?.(file) ?? uniqueName(file.name, t);\n        t.push(name);\n        paths.set(file, ruleDir(rule.path) + name);\n      }\n      if (paths.size) {\n        q.add(paths.keys(), { path: (f) => paths.get(f)! });\n        // New files lift a block and restart a queue discard() paused.\n        q.start();\n        setStall(undefined);\n      }\n      setRefused(s.refused);\n      for (const r of s.refused) report(r.error, \"upload\", r.file.name);\n    },\n    [q, report],\n  );\n\n  // Screens what waits once the rules are known; a failed read refuses it (the read failure is reported once, as folder.load).\n  const flush = useCallback(() => {\n    const files = pending.current;\n    const { ready, loadError } = live.current;\n    if (!files.length || (!ready && !loadError)) return false;\n    pending.current = [];\n    setWaiting([]);\n    if (ready) place(files);\n    else setRefused(files.map((file) => ({ file, error: loadError! })));\n    return true;\n  }, [place]);\n\n  const add = useCallback(\n    (files: Iterable<File>) => {\n      const list = [...files];\n      if (!list.length) return;\n      pending.current = [...pending.current, ...list];\n      if (!flush()) setWaiting(pending.current);\n    },\n    [flush],\n  );\n  useEffect(() => void flush(), [flush, ready, loadError]);\n\n  const update = useCallback(\n    async (ops: Op[], run?: () => Promise<unknown>) => {\n      setUpdating((n) => n + 1);\n      try {\n        if (run) await run();\n        else await client.media.commit(live.current.ref, ops);\n        setError(undefined);\n      } catch (e) {\n        const err = toContentKitError(e);\n        if (err.code !== \"aborted\") setError(err);\n        report(err, \"folder.update\");\n        throw err;\n      } finally {\n        setUpdating((n) => n - 1);\n      }\n    },\n    [client, report],\n  );\n\n  const commit = useCallback(async () => {\n    setCommitting(true);\n    try {\n      const files = await q.commit(undefined, { head: opts.current.commit === \"auto\" });\n      setError(undefined);\n      return files;\n    } catch (e) {\n      const err = toContentKitError(e);\n      setError(err);\n      report(err, \"folder.commit\");\n      throw err;\n    } finally {\n      setCommitting(false);\n    }\n  }, [q, report]);\n\n  // Committed files leave the queue once the read lists them, or once a read lands without them.\n  useEffect(() => {\n    for (const i of raw.items) if (i.status === \"committed\" && (listed.has(i.path) || !read.loading)) q.remove(i.id);\n  }, [raw.items, listed, read.loading, q]);\n\n  // A draft commits the uploaded head of the queue as it finishes; a failed commit waits for commit().\n  const auto = o.commit === \"auto\";\n  const headReady = items.find((i) => i.status !== \"committed\")?.status === \"uploaded\";\n  useEffect(() => {\n    if (!auto || !headReady || committing || stalled) return;\n    commit().catch((e: unknown) => setStall({ key, error: toContentKitError(e) }));\n  }, [auto, headReady, committing, stalled, commit, key]);\n  const manualCommit = useCallback(async () => {\n    setStall(undefined);\n    return commit();\n  }, [commit]);\n\n  // Each failed upload and queue-wide refusal is reported once; rows keep showing it.\n  const seen = useRef(new Set<unknown>());\n  useEffect(() => {\n    for (const i of raw.items) {\n      if (i.status !== \"failed\" || !i.error || seen.current.has(i.error)) continue;\n      seen.current.add(i.error);\n      report(i.error, \"upload\", i.file.name);\n    }\n    if (raw.blocked && !seen.current.has(raw.blocked)) {\n      seen.current.add(raw.blocked);\n      report(raw.blocked, \"upload\");\n    }\n  }, [raw.items, raw.blocked, report]);\n\n  // Processing failures that appear after the item's first read.\n  const failures = useRef<{ key: string; seen: Set<string> } | null>(null);\n  useEffect(() => {\n    if (!read.read) return;\n    const failed = uploads.filter((f) => f.failed);\n    if (failures.current?.key !== key) {\n      failures.current = { key, seen: new Set(failed.map((f) => `${f.path}:${f.failed!.of}`)) };\n      return;\n    }\n    for (const f of failed) {\n      const id = `${f.path}:${f.failed!.of}`;\n      if (failures.current.seen.has(id)) continue;\n      failures.current.seen.add(id);\n      report(failureError(f.failed!), \"folder.process\", f.path.split(\"/\").pop());\n    }\n  }, [read.read, uploads, report, key]);\n\n  useEffect(() => void (read.error && report(read.error, \"folder.load\")), [read.error, report]);\n\n  const busy =\n    waiting.length > 0 ||\n    committing ||\n    updating > 0 ||\n    (auto && headReady && !stalled) ||\n    items.some((i) => i.status === \"uploading\" || (i.status === \"queued\" && !raw.blocked));\n  const fileCount = uploads.length + waiting.length + inbound(items, listed).length;\n\n  // Reads the latest groups, so callbacks stay stable.\n  const groupOf = (path: string) => live.current.groups.find((g) => ruleFor([{ path: g.path }], path));\n  return {\n    ref: item,\n    options: o,\n    read,\n    groups,\n    uploads,\n    queue,\n    waiting,\n    add,\n    refused,\n    dismiss: useCallback(() => setRefused([]), []),\n    move: useCallback((path, index) => update([{ op: \"move\", path, index }]), [update]),\n    remove: useCallback((paths) => update(paths.map((path): Op => ({ op: \"remove\", path }))), [update]),\n    rename: useCallback(\n      (path, name) => {\n        const g = groupOf(path);\n        const to = (g ? ruleDir(g.path) : path.slice(0, path.lastIndexOf(\"/\") + 1)) + name.trim();\n        if (stem(to) === stem(path)) return Promise.resolve();\n        if (g?.files.some((f) => stem(f.path) === stem(to))) {\n          const err = new ContentKitError(\"conflict\", `${name} exists`, { status: 409 });\n          setError(err);\n          return Promise.reject(err);\n        }\n        return update([{ op: \"rename\", path, to }]);\n      },\n      [update],\n    ),\n    edit: useCallback((path, edit) => update([{ op: \"edit\", path, ...(edit ? { edit } : {}) }]), [update]),\n    replace: useCallback(\n      (path, file) => update([], () => client.media.put(file, { ref: live.current.ref, path: stem(path), wait: false })),\n      [update, client],\n    ),\n    commit: manualCommit,\n    discard: useCallback(() => {\n      pending.current = [];\n      setWaiting([]);\n      for (const i of q.getSnapshot().items) q.remove(i.id);\n      q.pause();\n    }, [q]),\n    updating: updating > 0,\n    committing,\n    busy,\n    fileCount,\n    error: error ?? stalled,\n  };\n}\n"],"mappings":"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"}

package/dist/react/groups.d.ts

@@ -0,0 +1,115 @@
+import { ContentKitClient } from '../client/client.js';
+import { ContentKitError } from '../client/errors.js';
+import { ContentMemberships, ContentModel, Edge, EdgeInput, Group, GroupCard, GroupDetail, GroupInput, GroupUpdate, MemberRef, Membership, MergeReport, MyGroup, Name, Edit } from '../client/generated/wire.js';
+import { GroupImageSlot, MyGroupQuery } from '../client/groups.js';
+import { UseList } from './use-resource.js';
+export interface UseKinds {
+    /** null until it loads (or when it fails). */
+    kinds: ContentModel | null;
+    loading: boolean;
+    error?: ContentKitError;
+    reload: () => void;
+}
+/** The site's content model (GET /v1/kinds): languages, tiers, kinds, group kinds and content filters; one read per client. */
+export declare function useKinds(o?: {
+    client?: ContentKitClient;
+}): UseKinds;
+export type GroupSort = "name" | "count" | "newest";
+export interface GroupFilter {
+    kind?: string;
+    /** Children of this group. */
+    parent?: string;
+    /** Groups scoped by this group (characters of a series). */
+    scope?: string;
+    slug?: string;
+    /** Sort names starting with this letter (a-z), or with anything else ("#"). */
+    letter?: string;
+    /** Names, counts and paths in this language; default the provider's. */
+    language?: string;
+    /** Count contents of this kind only. */
+    contentKind?: string;
+    /** Default "name". */
+    sort?: GroupSort;
+    /** Default 50, at most 200. */
+    pageSize?: number;
+}
+/** Active groups with name, path, cover and count, a cursor page at a time. */
+export declare function useGroups(f?: GroupFilter, o?: {
+    client?: ContentKitClient;
+}): UseList<GroupCard>;
+export interface UseGroup {
+    /** The group as its page shows it; null before create and while loading. A merged group reads as its survivor. */
+    group: GroupDetail | null;
+    /** What this hook deleted, until restored: reads no longer answer for it. */
+    deleted: Group | null;
+    loading: boolean;
+    error?: ContentKitError;
+    /** Writes in flight. */
+    saving: boolean;
+    reload: () => void;
+    /** Creates the group; the hook then shows it. */
+    create: (input: GroupInput) => Promise<Group>;
+    update: (patch: GroupUpdate) => Promise<Group>;
+    remove: () => Promise<Group>;
+    restore: () => Promise<Group>;
+    /** Replaces ("set"), adds or removes names and aliases; a new canonical name demotes the old one to an alias. */
+    names: (op: "set" | "add" | "remove", names: Name[]) => Promise<Name[]>;
+    edges: (op: "add" | "remove", edges: EdgeInput[]) => Promise<Edge[]>;
+    /** Merges the group into another of its kind; the hook then shows the survivor. */
+    merge: (into: string) => Promise<MergeReport>;
+    /** Uploads an image (cropped by edit) and selects it as the cover or avatar. */
+    uploadImage: (slot: GroupImageSlot, file: Blob & {
+        name?: string;
+    }, o?: {
+        wait?: boolean;
+        edit?: Edit;
+    }) => Promise<Group>;
+    /** Shows the images uploaded here until their renditions exist. */
+    previews: Partial<Record<GroupImageSlot, string>>;
+}
+/** One group: its page for anyone; create, edit, names, edges, cover, merge, delete and restore for staff (root:groups:write). null creates. */
+export declare function useGroup(id: string | null | undefined, o?: {
+    language?: string;
+    initial?: GroupDetail;
+    client?: ContentKitClient;
+}): UseGroup;
+/** Groups the signed-in person owns, edits or belongs to, a cursor page at a time; nothing signed out. */
+export declare function useMyGroups(q?: Omit<MyGroupQuery, "cursor" | "limit"> & {
+    pageSize?: number;
+}, o?: {
+    client?: ContentKitClient;
+}): UseList<MyGroup>;
+/** A membership with a stable id: (group, content, version, role) is its identity. */
+export type Member = Membership & {
+    id: string;
+};
+export declare const memberId: (m: Membership) => string;
+export interface UseGroupMembers extends UseList<Member> {
+    saving: boolean;
+    /** Adds members, or updates their role's position, window and state. */
+    add: (members: Membership[]) => Promise<number>;
+    remove: (members: Membership[]) => Promise<number>;
+    /** Orders an ordered group: the listed members first, in list order. */
+    reorder: (members: MemberRef[]) => Promise<number>;
+}
+/** Staff: a group's memberships in member order, with writes. */
+export declare function useGroupMembers(id: string | null | undefined, o?: {
+    pageSize?: number;
+    client?: ContentKitClient;
+}): UseGroupMembers;
+export interface UseContentGroups {
+    memberships: Membership[];
+    /** The groups the memberships name. */
+    groups: ReadonlyMap<string, GroupCard>;
+    loading: boolean;
+    error?: ContentKitError;
+    saving: boolean;
+    reload: () => void;
+    /** Replaces the content's memberships, its versions' included, in these group kinds (every kind its kind joins when omitted). */
+    set: (memberships: Membership[], kinds?: string[]) => Promise<ContentMemberships>;
+}
+/** Staff: one content's memberships, its versions' included, and their replacement. */
+export declare function useContentGroups(contentId: string | null | undefined, o?: {
+    language?: string;
+    client?: ContentKitClient;
+}): UseContentGroups;