@openrails/contentkit-ui 0.79.0 → 0.81.0

package/dist/react/groups.js

@@ -0,0 +1,229 @@
+import { useGuarded as e } from "./context.js";
+import { keyOf as t, useContentScope as n, useList as r, useResource as i } from "./use-resource.js";
+import { useCallback as a, useEffect as o, useMemo as s, useRef as c, useState as l } from "react";
+//#region src/react/groups.ts
+function u(e = {}) {
+	let { client: r, store: a } = n(e.client), o = i(a, t("kinds"), { type: "kinds" }, (e) => r.kinds(e));
+	return {
+		kinds: o.data ?? null,
+		loading: !o.data && (o.loading || !o.loaded),
+		error: o.error,
+		reload: o.reload
+	};
+}
+function d(e = {}, i = {}) {
+	let { client: a, store: o, scope: s, language: c } = n(i.client), l = e.language ?? c, u = e.pageSize ?? 50;
+	return r(o, t("groups", s, e.kind, e.parent, e.scope, e.slug, e.letter, l, e.contentKind, e.sort, u), { type: "groups" }, async (t, n) => {
+		let r = await a.groups.list({
+			kind: e.kind,
+			parent: e.parent,
+			scope: e.scope,
+			slug: e.slug,
+			letter: e.letter,
+			language: l,
+			content_kind: e.contentKind,
+			sort: e.sort,
+			cursor: t,
+			limit: u
+		}, n);
+		return {
+			items: r.groups,
+			next: r.next_cursor ?? null
+		};
+	});
+}
+function f(r, s = {}) {
+	let { client: u, store: d, scope: f, language: p } = n(s.client), m = s.language ?? p, [h, g] = l(null), [_, v] = l(null), [y, b] = l(null), x = _ ?? r ?? h;
+	o(() => {
+		v(null), b(null);
+	}, [r]);
+	let S = x && !y ? t("group", f, x, m) : null, C = i(d, S, {
+		type: "group",
+		id: x ?? void 0
+	}, (e) => u.groups.get(x, m, e), { initial: s.initial }), w = e(), [T, E] = l(0), D = a(async (e) => {
+		E((e) => e + 1);
+		try {
+			return await w(e);
+		} finally {
+			E((e) => e - 1);
+		}
+	}, [w]), O = a(() => {
+		if (!x) throw Error("contentkit-ui: create the group first");
+		return x;
+	}, [x]), [k, A] = l({}), j = c([]);
+	o(() => {
+		let e = j.current;
+		return () => e.forEach((e) => URL.revokeObjectURL(e));
+	}, []);
+	let M = C.data ?? null;
+	return {
+		group: y ? null : M,
+		deleted: y,
+		loading: !!S && (C.loading || !C.loaded && s.initial === void 0),
+		error: y ? void 0 : C.error,
+		saving: T > 0,
+		reload: C.reload,
+		create: a((e) => D(async () => {
+			let [t] = await u.groups.create([e]);
+			return g(t.id), t;
+		}), [u, D]),
+		update: a((e) => D(() => u.groups.update(O(), e)), [
+			u,
+			D,
+			O
+		]),
+		remove: a(() => D(async () => {
+			let e = await u.groups.remove(O());
+			return b(e), e;
+		}), [
+			u,
+			D,
+			O
+		]),
+		restore: a(() => D(async () => {
+			let e = await u.groups.update(O(), { state: "active" });
+			return b(null), e;
+		}), [
+			u,
+			D,
+			O
+		]),
+		names: a((e, t) => D(() => u.groups.names(O(), e, t)), [
+			u,
+			D,
+			O
+		]),
+		edges: a((e, t) => D(() => u.groups.edges(O(), e, t)), [
+			u,
+			D,
+			O
+		]),
+		merge: a((e) => D(async () => {
+			let t = await u.groups.merge(O(), e);
+			return v(t.into), t;
+		}), [
+			u,
+			D,
+			O
+		]),
+		uploadImage: a((e, t, n = {}) => D(async () => {
+			let r = M?.kind;
+			if (!r) throw Error("contentkit-ui: load the group first");
+			let i = await u.groups.uploadImage({
+				kind: r,
+				id: O()
+			}, e, t, n);
+			if (typeof URL.createObjectURL == "function" && !n.edit) {
+				let n = URL.createObjectURL(t);
+				j.current.push(n), A((t) => ({
+					...t,
+					[e]: n
+				}));
+			}
+			return i;
+		}), [
+			u,
+			D,
+			O,
+			M?.kind
+		]),
+		previews: {
+			cover: M?.cover?.image ? k.cover : void 0,
+			avatar: M?.avatar?.image ? k.avatar : void 0
+		}
+	};
+}
+function p(e = {}, i = {}) {
+	let { client: a, store: o, scope: s, viewer: c, language: l } = n(i.client), { pageSize: u, ...d } = e, f = {
+		language: l,
+		...d
+	};
+	return r(o, c === null ? null : t("groups-mine", s, f, u), { type: "groups-mine" }, async (e, t) => {
+		let n = await a.groups.mine({
+			...f,
+			cursor: e,
+			limit: u
+		}, t);
+		return {
+			items: n.groups,
+			next: n.next_cursor ?? null
+		};
+	});
+}
+var m = (e) => [
+	e.group_id ?? "",
+	e.content_id ?? "",
+	e.version_id ?? "",
+	e.role ?? ""
+].join("|");
+function h(i, o = {}) {
+	let { client: s, store: c, scope: u } = n(o.client), d = o.pageSize ?? 50, f = r(c, i ? t("group-members", u, i, d) : null, {
+		type: "group-members",
+		id: i ?? void 0
+	}, async (e, t) => {
+		let n = await s.groups.members(i, {
+			cursor: e,
+			limit: d
+		}, t);
+		return {
+			items: n.members.map((e) => ({
+				...e,
+				id: m(e)
+			})),
+			next: n.next_cursor ?? null
+		};
+	}), p = e(), [h, g] = l(0), _ = a(async (e) => {
+		if (!i) throw Error("contentkit-ui: no group");
+		g((e) => e + 1);
+		try {
+			return (await p(() => e(i))).count;
+		} finally {
+			g((e) => e - 1);
+		}
+	}, [i, p]);
+	return {
+		...f,
+		saving: h > 0,
+		add: a((e) => _((t) => s.groups.addMembers(t, e)), [s, _]),
+		remove: a((e) => _((t) => s.groups.removeMembers(t, e)), [s, _]),
+		reorder: a((e) => _((t) => s.groups.reorder(t, e)), [s, _])
+	};
+}
+function g(r, o = {}) {
+	let { client: c, store: u, scope: d, language: f } = n(o.client), p = o.language ?? f, m = r ? t("group-memberships", d, r, p) : null, h = i(u, m, {
+		type: "group-memberships",
+		id: r ?? void 0
+	}, (e) => c.groups.ofContent(r, p, e)), g = e(), [_, v] = l(0), y = a(async (e, t) => {
+		if (!r) throw Error("contentkit-ui: no content");
+		v((e) => e + 1);
+		try {
+			let n = await g(() => c.groups.setOfContent(r, {
+				kinds: t,
+				memberships: e
+			}, p));
+			return m && u.set(m, n), n;
+		} finally {
+			v((e) => e - 1);
+		}
+	}, [
+		c,
+		r,
+		p,
+		g,
+		u,
+		m
+	]), b = s(() => new Map((h.data?.groups ?? []).map((e) => [e.id, e])), [h.data]);
+	return {
+		memberships: h.data?.memberships ?? [],
+		groups: b,
+		loading: !!m && (h.loading || !h.loaded),
+		error: h.error,
+		saving: _ > 0,
+		reload: h.reload,
+		set: y
+	};
+}
+//#endregion
+export { m as memberId, g as useContentGroups, f as useGroup, h as useGroupMembers, d as useGroups, u as useKinds, p as useMyGroups };
+
+//# sourceMappingURL=groups.js.map

package/dist/react/groups.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"groups.js","names":[],"sources":["../../src/react/groups.ts"],"sourcesContent":["import { useCallback, useEffect, useMemo, useRef, useState } from \"react\";\nimport type { ContentKitClient } from \"../client/client.js\";\nimport type { ContentKitError } from \"../client/errors.js\";\nimport type {\n  ContentMemberships,\n  ContentModel,\n  Edge,\n  EdgeInput,\n  Group,\n  GroupCard,\n  GroupDetail,\n  GroupInput,\n  GroupUpdate,\n  MemberRef,\n  Membership,\n  MergeReport,\n  MyGroup,\n  Name,\n  Edit,\n} from \"../client/generated/wire.js\";\nimport type { GroupImageSlot, MyGroupQuery } from \"../client/groups.js\";\nimport { useGuarded } from \"./context.js\";\nimport { keyOf, useContentScope, useList, useResource, type UseList } from \"./use-resource.js\";\n\nexport interface UseKinds {\n  /** null until it loads (or when it fails). */\n  kinds: ContentModel | null;\n  loading: boolean;\n  error?: ContentKitError;\n  reload: () => void;\n}\n\n/** The site's content model (GET /v1/kinds): languages, tiers, kinds, group kinds and content filters; one read per client. */\nexport function useKinds(o: { client?: ContentKitClient } = {}): UseKinds {\n  const { client, store } = useContentScope(o.client);\n  const r = useResource<ContentModel>(store, keyOf(\"kinds\"), { type: \"kinds\" }, (s) => client.kinds(s));\n  return { kinds: r.data ?? null, loading: !r.data && (r.loading || !r.loaded), error: r.error, reload: r.reload };\n}\n\nexport type GroupSort = \"name\" | \"count\" | \"newest\";\n\nexport interface GroupFilter {\n  kind?: string;\n  /** Children of this group. */\n  parent?: string;\n  /** Groups scoped by this group (characters of a series). */\n  scope?: string;\n  slug?: string;\n  /** Sort names starting with this letter (a-z), or with anything else (\"#\"). */\n  letter?: string;\n  /** Names, counts and paths in this language; default the provider's. */\n  language?: string;\n  /** Count contents of this kind only. */\n  contentKind?: string;\n  /** Default \"name\". */\n  sort?: GroupSort;\n  /** Default 50, at most 200. */\n  pageSize?: number;\n}\n\n/** Active groups with name, path, cover and count, a cursor page at a time. */\nexport function useGroups(f: GroupFilter = {}, o: { client?: ContentKitClient } = {}): UseList<GroupCard> {\n  const { client, store, scope, language: provided } = useContentScope(o.client);\n  const language = f.language ?? provided;\n  const size = f.pageSize ?? 50;\n  return useList(\n    store,\n    keyOf(\"groups\", scope, f.kind, f.parent, f.scope, f.slug, f.letter, language, f.contentKind, f.sort, size),\n    { type: \"groups\" },\n    async (cursor, signal) => {\n      const page = await client.groups.list(\n        { kind: f.kind, parent: f.parent, scope: f.scope, slug: f.slug, letter: f.letter, language, content_kind: f.contentKind, sort: f.sort, cursor: cursor as string | undefined, limit: size },\n        signal,\n      );\n      return { items: page.groups, next: page.next_cursor ?? null };\n    },\n  );\n}\n\nexport interface UseGroup {\n  /** The group as its page shows it; null before create and while loading. A merged group reads as its survivor. */\n  group: GroupDetail | null;\n  /** What this hook deleted, until restored: reads no longer answer for it. */\n  deleted: Group | null;\n  loading: boolean;\n  error?: ContentKitError;\n  /** Writes in flight. */\n  saving: boolean;\n  reload: () => void;\n  /** Creates the group; the hook then shows it. */\n  create: (input: GroupInput) => Promise<Group>;\n  update: (patch: GroupUpdate) => Promise<Group>;\n  remove: () => Promise<Group>;\n  restore: () => Promise<Group>;\n  /** Replaces (\"set\"), adds or removes names and aliases; a new canonical name demotes the old one to an alias. */\n  names: (op: \"set\" | \"add\" | \"remove\", names: Name[]) => Promise<Name[]>;\n  edges: (op: \"add\" | \"remove\", edges: EdgeInput[]) => Promise<Edge[]>;\n  /** Merges the group into another of its kind; the hook then shows the survivor. */\n  merge: (into: string) => Promise<MergeReport>;\n  /** Uploads an image (cropped by edit) and selects it as the cover or avatar. */\n  uploadImage: (slot: GroupImageSlot, file: Blob & { name?: string }, o?: { wait?: boolean; edit?: Edit }) => Promise<Group>;\n  /** Shows the images uploaded here until their renditions exist. */\n  previews: Partial<Record<GroupImageSlot, string>>;\n}\n\n/** One group: its page for anyone; create, edit, names, edges, cover, merge, delete and restore for staff (root:groups:write). null creates. */\nexport function useGroup(id: string | null | undefined, o: { language?: string; initial?: GroupDetail; client?: ContentKitClient } = {}): UseGroup {\n  const { client, store, scope, language: provided } = useContentScope(o.client);\n  const language = o.language ?? provided;\n  const [created, setCreated] = useState<string | null>(null);\n  const [merged, setMerged] = useState<string | null>(null);\n  const [deleted, setDeleted] = useState<Group | null>(null);\n  const gid = merged ?? id ?? created;\n  useEffect(() => {\n    setMerged(null);\n    setDeleted(null);\n  }, [id]);\n  const key = gid && !deleted ? keyOf(\"group\", scope, gid, language) : null;\n  const r = useResource<GroupDetail>(store, key, { type: \"group\", id: gid ?? undefined }, (s) => client.groups.get(gid!, language, s), { initial: o.initial });\n  const guarded = useGuarded();\n  const [inflight, setInflight] = useState(0);\n  const run = useCallback(\n    async <T>(fn: () => Promise<T>): Promise<T> => {\n      setInflight((n) => n + 1);\n      try {\n        return await guarded(fn);\n      } finally {\n        setInflight((n) => n - 1);\n      }\n    },\n    [guarded],\n  );\n  const need = useCallback(() => {\n    if (!gid) throw new Error(\"contentkit-ui: create the group first\");\n    return gid;\n  }, [gid]);\n\n  const [previews, setPreviews] = useState<Partial<Record<GroupImageSlot, string>>>({});\n  const blobs = useRef<string[]>([]);\n  useEffect(() => {\n    const urls = blobs.current;\n    return () => urls.forEach((u) => URL.revokeObjectURL(u));\n  }, []);\n\n  const group = r.data ?? null;\n  return {\n    group: deleted ? null : group,\n    deleted,\n    loading: !!key && (r.loading || (!r.loaded && o.initial === undefined)),\n    error: deleted ? undefined : r.error,\n    saving: inflight > 0,\n    reload: r.reload,\n    create: useCallback(\n      (input: GroupInput) =>\n        run(async () => {\n          const [g] = await client.groups.create([input]);\n          setCreated(g!.id);\n          return g!;\n        }),\n      [client, run],\n    ),\n    update: useCallback((patch: GroupUpdate) => run(() => client.groups.update(need(), patch)), [client, run, need]),\n    remove: useCallback(\n      () =>\n        run(async () => {\n          const g = await client.groups.remove(need());\n          setDeleted(g);\n          return g;\n        }),\n      [client, run, need],\n    ),\n    restore: useCallback(\n      () =>\n        run(async () => {\n          const g = await client.groups.update(need(), { state: \"active\" });\n          setDeleted(null);\n          return g;\n        }),\n      [client, run, need],\n    ),\n    names: useCallback((op: \"set\" | \"add\" | \"remove\", names: Name[]) => run(() => client.groups.names(need(), op, names)), [client, run, need]),\n    edges: useCallback((op: \"add\" | \"remove\", edges: EdgeInput[]) => run(() => client.groups.edges(need(), op, edges)), [client, run, need]),\n    merge: useCallback(\n      (into: string) =>\n        run(async () => {\n          const report = await client.groups.merge(need(), into);\n          setMerged(report.into);\n          return report;\n        }),\n      [client, run, need],\n    ),\n    uploadImage: useCallback(\n      (slot: GroupImageSlot, file: Blob & { name?: string }, u: { wait?: boolean; edit?: Edit } = {}) =>\n        run(async () => {\n          const kind = group?.kind;\n          if (!kind) throw new Error(\"contentkit-ui: load the group first\");\n          const g = await client.groups.uploadImage({ kind, id: need() }, slot, file, u);\n          // A cropped upload's renditions show the crop; until then the file shows uncropped.\n          if (typeof URL.createObjectURL === \"function\" && !u.edit) {\n            const url = URL.createObjectURL(file);\n            blobs.current.push(url);\n            setPreviews((p) => ({ ...p, [slot]: url }));\n          }\n          return g;\n        }),\n      [client, run, need, group?.kind],\n    ),\n    previews: { cover: group?.cover?.image ? previews.cover : undefined, avatar: group?.avatar?.image ? previews.avatar : undefined },\n  };\n}\n\n/** Groups the signed-in person owns, edits or belongs to, a cursor page at a time; nothing signed out. */\nexport function useMyGroups(q: Omit<MyGroupQuery, \"cursor\" | \"limit\"> & { pageSize?: number } = {}, o: { client?: ContentKitClient } = {}): UseList<MyGroup> {\n  const { client, store, scope, viewer, language } = useContentScope(o.client);\n  const { pageSize, ...rest } = q;\n  const query = { language, ...rest };\n  return useList(store, viewer === null ? null : keyOf(\"groups-mine\", scope, query, pageSize), { type: \"groups-mine\" }, async (cursor, signal) => {\n    const page = await client.groups.mine({ ...query, cursor: cursor as string | undefined, limit: pageSize }, signal);\n    return { items: page.groups, next: page.next_cursor ?? null };\n  });\n}\n\n/** A membership with a stable id: (group, content, version, role) is its identity. */\nexport type Member = Membership & { id: string };\n\nexport const memberId = (m: Membership): string => [m.group_id ?? \"\", m.content_id ?? \"\", m.version_id ?? \"\", m.role ?? \"\"].join(\"|\");\n\nexport interface UseGroupMembers extends UseList<Member> {\n  saving: boolean;\n  /** Adds members, or updates their role's position, window and state. */\n  add: (members: Membership[]) => Promise<number>;\n  remove: (members: Membership[]) => Promise<number>;\n  /** Orders an ordered group: the listed members first, in list order. */\n  reorder: (members: MemberRef[]) => Promise<number>;\n}\n\n/** Staff: a group's memberships in member order, with writes. */\nexport function useGroupMembers(id: string | null | undefined, o: { pageSize?: number; client?: ContentKitClient } = {}): UseGroupMembers {\n  const { client, store, scope } = useContentScope(o.client);\n  const size = o.pageSize ?? 50;\n  const list = useList<Member>(store, id ? keyOf(\"group-members\", scope, id, size) : null, { type: \"group-members\", id: id ?? undefined }, async (cursor, signal) => {\n    const page = await client.groups.members(id!, { cursor: cursor as string | undefined, limit: size }, signal);\n    return { items: page.members.map((m) => ({ ...m, id: memberId(m) })), next: page.next_cursor ?? null };\n  });\n  const guarded = useGuarded();\n  const [inflight, setInflight] = useState(0);\n  const write = useCallback(\n    async (fn: (gid: string) => Promise<{ count: number }>) => {\n      if (!id) throw new Error(\"contentkit-ui: no group\");\n      setInflight((n) => n + 1);\n      try {\n        return (await guarded(() => fn(id))).count;\n      } finally {\n        setInflight((n) => n - 1);\n      }\n    },\n    [id, guarded],\n  );\n  return {\n    ...list,\n    saving: inflight > 0,\n    add: useCallback((ms: Membership[]) => write((g) => client.groups.addMembers(g, ms)), [client, write]),\n    remove: useCallback((ms: Membership[]) => write((g) => client.groups.removeMembers(g, ms)), [client, write]),\n    reorder: useCallback((ms: MemberRef[]) => write((g) => client.groups.reorder(g, ms)), [client, write]),\n  };\n}\n\nexport interface UseContentGroups {\n  memberships: Membership[];\n  /** The groups the memberships name. */\n  groups: ReadonlyMap<string, GroupCard>;\n  loading: boolean;\n  error?: ContentKitError;\n  saving: boolean;\n  reload: () => void;\n  /** Replaces the content's memberships, its versions' included, in these group kinds (every kind its kind joins when omitted). */\n  set: (memberships: Membership[], kinds?: string[]) => Promise<ContentMemberships>;\n}\n\n/** Staff: one content's memberships, its versions' included, and their replacement. */\nexport function useContentGroups(contentId: string | null | undefined, o: { language?: string; client?: ContentKitClient } = {}): UseContentGroups {\n  const { client, store, scope, language: provided } = useContentScope(o.client);\n  const language = o.language ?? provided;\n  const key = contentId ? keyOf(\"group-memberships\", scope, contentId, language) : null;\n  const r = useResource<ContentMemberships>(store, key, { type: \"group-memberships\", id: contentId ?? undefined }, (s) => client.groups.ofContent(contentId!, language, s));\n  const guarded = useGuarded();\n  const [inflight, setInflight] = useState(0);\n  const set = useCallback(\n    async (memberships: Membership[], kinds?: string[]) => {\n      if (!contentId) throw new Error(\"contentkit-ui: no content\");\n      setInflight((n) => n + 1);\n      try {\n        const out = await guarded(() => client.groups.setOfContent(contentId, { kinds, memberships }, language));\n        if (key) store.set(key, out);\n        return out;\n      } finally {\n        setInflight((n) => n - 1);\n      }\n    },\n    [client, contentId, language, guarded, store, key],\n  );\n  const groups = useMemo(() => new Map((r.data?.groups ?? []).map((g) => [g.id, g])), [r.data]);\n  return {\n    memberships: r.data?.memberships ?? [],\n    groups,\n    loading: !!key && (r.loading || !r.loaded),\n    error: r.error,\n    saving: inflight > 0,\n    reload: r.reload,\n    set,\n  };\n}\n"],"mappings":"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"}

package/dist/react/index.d.ts

@@ -11,7 +11,11 @@ export { useAdminComments, useCanComment, useCommentBans, useGlobalCommentBan, u
 export { useContentConfig, type UseContentConfig } from './config.js';
 export { useFavorite, useReaction, type UseFavorite, type UseReaction } from './engagement.js';
 export { usePoll, usePollEditor, usePolls, withVote, type PollFilter, type PollImages, type UsePoll, type UsePollEditor } from './polls.js';
-export { isPublished, usePost, usePosts, type PostFilter, type UsePost } from './posts.js';
+export { useContent, useManagedContents, type ManageFilter, type UseContent } from './contents.js';
+export { defaultVersion, liveVersions, useContentDetail, type UseContentDetail } from './detail.js';
+export { memberId, useContentGroups, useGroup, useGroupMembers, useGroups, useKinds, useMyGroups, type GroupFilter, type GroupSort, type Member, type UseContentGroups, type UseGroup, type UseGroupMembers, type UseKinds, } from './groups.js';
+export { beaconsFor, useBeacons, useContentFilters, useContents, useExposure, useHistory, useMyFavorites, useMyReactions, useRecentSearches, useRecommendations, useReleaseDates, useSearch, useSimilar, useTypeahead, useViewSignal, type ExposureOptions, type MyInteraction, type ReleaseDate, type UseContentFilters, type UseExposure, type UseHistory, type UseRail, type UseRecentSearches, type UseTypeahead, } from './discovery.js';
+export { nextRelease, useReaderPlan, useSegmentPages, useVersionDownload, type ReaderPage, type UseReaderPlan, type UseSegmentPages, type UseVersionDownload, } from './versions.js';
 export { useContentScope, usePaged, type UseList, type UsePaged } from './use-resource.js';
 export { ResourceStore, resourcesFor, type Page, type Resource } from './resources.js';
 export { useCrop, useEncodeProgress, useUpload, useUploadQueue, type UploadQueueOptions, type UploadStatus, type UseCrop, type UseCropOptions, type UseEncodeProgress, type UseUpload, type UseUploadQueue, } from './upload.js';

package/dist/react/public.d.ts

@@ -1,6 +1,6 @@
 import { ContentKitClient } from '../client/client.js';
 import { ContentKitError } from '../client/errors.js';
-import { ReadResult, PresetRule } from '../client/generated/wire.js';
+import { ReadResult, RefBody, PresetRule } from '../client/generated/wire.js';
 import { PublicPreset } from '../client/public.js';
 export interface UsePresets {
     /** Every kind's public presets; empty until they load (or when the server has none). */
@@ -32,8 +32,9 @@ export interface UsePublicImage {
     reload: () => void;
 }
 /**
- * An item's public image for a preset ("avatar", "cover"): the exact
- * renditions from a read's `public` (or the host's listing), else the kind's
- * default image, else none. Reads refresh after commits through the same client.
+ * An item's public image for a preset ("avatar", "cover", a version's
+ * "poster"): the exact renditions from a read's `public` (or the host's
+ * listing), else the kind's default image, else none. Reads refresh after
+ * commits through the same client.
  */
-export declare function usePublicImage(kind: string, id: string, preset: string, o?: PublicImageOptions): UsePublicImage;
+export declare function usePublicImage(item: RefBody, preset: string, o?: PublicImageOptions): UsePublicImage;

package/dist/react/public.js

@@ -21,31 +21,28 @@ function u(e = {}) {
 		error: i?.error
 	};
 }
-function d(a, s, c, l = {}) {
-	let d = r(l.client), { presets: f, loaded: p } = u({ client: d }), m = f.find((e) => e.kind === a && e.name === c), h = l.image !== void 0, g = m ? t(m.from) ? n(m.from) : m.from : void 0, _ = i({
-		kind: a,
-		id: s
-	}, {
-		prefix: g,
-		read: h || !p ? null : l.read,
-		client: d
+function d(a, s, c = {}) {
+	let { kind: l, id: d } = a, f = r(c.client), { presets: p, loaded: m } = u({ client: f }), h = p.find((e) => e.kind === l && e.name === s), g = c.image !== void 0, _ = h ? t(h.from) ? n(h.from) : h.from : void 0, v = i(a, {
+		prefix: _,
+		read: g || !m ? null : c.read,
+		client: f
 	});
 	return {
 		...o(() => {
-			let t = h ? l.image : _.read?.public?.find((e) => e.preset === c);
+			let t = g ? c.image : v.read?.public?.find((e) => e.preset === s);
 			if (t && t.renditions.length) return {
 				image: {
-					preset: c,
+					preset: s,
 					renditions: t.renditions,
-					aspect: "aspect" in t && t.aspect || m?.aspect
+					aspect: "aspect" in t && t.aspect || h?.aspect
 				},
 				isDefault: !1
 			};
-			if (!h && !_.read) return {
+			if (!g && !v.read) return {
 				image: null,
 				isDefault: !1
 			};
-			let n = m && e(m, s);
+			let n = h && e(h, d);
 			return n ? {
 				image: n,
 				isDefault: !0
@@ -54,17 +51,17 @@ function d(a, s, c, l = {}) {
 				isDefault: !1
 			};
 		}, [
+			g,
+			c.image,
+			v.read,
+			s,
 			h,
-			l.image,
-			_.read,
-			c,
-			m,
-			s
+			d
 		]),
-		rule: m,
-		loading: !p || _.loading,
-		error: _.error,
-		reload: _.reload
+		rule: h,
+		loading: !m || v.loading,
+		error: v.error,
+		reload: v.reload
 	};
 }
 //#endregion

package/dist/react/public.js.map

@@ -1 +1 @@
-{"version":3,"file":"public.js","names":[],"sources":["../../src/react/public.ts"],"sourcesContent":["import { useEffect, useMemo, useState } from \"react\";\nimport type { ContentKitClient } from \"../client/client.js\";\nimport type { ContentKitError } from \"../client/errors.js\";\nimport type { ReadResult } from \"../client/generated/wire.js\";\nimport type { PresetRule } from \"../client/generated/wire.js\";\nimport { defaultImage, isPattern, ruleDir } from \"../client/media/rules.js\";\nimport type { PublicPreset } from \"../client/public.js\";\nimport { useOptionalContentKitClient } from \"./context.js\";\nimport { useMediaRead } from \"./read.js\";\n\nexport interface UsePresets {\n  /** Every kind's public presets; empty until they load (or when the server has none). */\n  presets: PresetRule[];\n  loaded: boolean;\n  error?: ContentKitError;\n}\n\nconst settled = new WeakMap<ContentKitClient, { presets: PresetRule[]; error?: ContentKitError }>();\nconst inflight = new WeakMap<ContentKitClient, Promise<void>>();\n\n/** The public presets (`GET /media/presets`), fetched once per client. */\nexport function usePresets(o: { client?: ContentKitClient | null } = {}): UsePresets {\n  const client = useOptionalContentKitClient(o.client);\n  const [, rerender] = useState(0);\n  const done = client ? settled.get(client) : undefined;\n  useEffect(() => {\n    if (!client || settled.has(client)) return;\n    let live = true;\n    let load = inflight.get(client);\n    if (!load) {\n      load = client.media.presets().then(\n        (presets) => void settled.set(client, { presets }),\n        (error: ContentKitError) => void settled.set(client, { presets: [], error }),\n      ).finally(() => inflight.delete(client));\n      inflight.set(client, load);\n    }\n    void load.then(() => live && rerender((n) => n + 1));\n    return () => {\n      live = false;\n    };\n  }, [client]);\n  return { presets: done?.presets ?? [], loaded: !!done || !client, error: done?.error };\n}\n\nexport interface PublicImageOptions {\n  /** The host's listing of the item's image (its API's): shown without a read. */\n  image?: PublicPreset | null;\n  /** A read of the item the host already has. */\n  read?: ReadResult | null;\n  /** Overrides the provider's client. */\n  client?: ContentKitClient | null;\n}\n\nexport interface UsePublicImage {\n  /** The item's current renditions; else the kind's default image (when the preset has one); null while unknown or when there is neither. */\n  image: PublicPreset | null;\n  /** The preset's rules (aspect, widths, min_width) once the presets load. */\n  rule?: PresetRule;\n  /** image is the kind's default, not the item's own. */\n  isDefault: boolean;\n  loading: boolean;\n  error?: ContentKitError;\n  reload: () => void;\n}\n\n/**\n * An item's public image for a preset (\"avatar\", \"cover\"): the exact\n * renditions from a read's `public` (or the host's listing), else the kind's\n * default image, else none. Reads refresh after commits through the same client.\n */\nexport function usePublicImage(kind: string, id: string, preset: string, o: PublicImageOptions = {}): UsePublicImage {\n  const client = useOptionalContentKitClient(o.client);\n  const { presets, loaded } = usePresets({ client });\n  const rule = presets.find((p) => p.kind === kind && p.name === preset);\n  const listed = o.image !== undefined;\n  // The read waits for the presets, so it lists only the preset's upload.\n  const prefix = rule ? (isPattern(rule.from) ? ruleDir(rule.from) : rule.from) : undefined;\n  const r = useMediaRead({ kind, id }, { prefix, read: listed || !loaded ? null : o.read, client });\n  const image = useMemo((): { image: PublicPreset | null; isDefault: boolean } => {\n    const own = listed ? o.image : r.read?.public?.find((p) => p.preset === preset);\n    if (own && own.renditions.length) return { image: { preset, renditions: own.renditions, aspect: (\"aspect\" in own && own.aspect) || rule?.aspect }, isDefault: false };\n    if (!listed && !r.read) return { image: null, isDefault: false };\n    const def = rule && defaultImage(rule, id);\n    return def ? { image: def, isDefault: true } : { image: null, isDefault: false };\n  }, [listed, o.image, r.read, preset, rule, id]);\n  return { ...image, rule, loading: !loaded || r.loading, error: r.error, reload: r.reload };\n}\n"],"mappings":";;;;;AAiBA,IAAM,oBAAU,IAAI,QAA8E,GAC5F,oBAAW,IAAI,QAAyC;AAG9D,SAAgB,EAAW,IAA0C,CAAC,GAAe;CACnF,IAAM,IAAS,EAA4B,EAAE,MAAM,GAC7C,GAAG,KAAY,EAAS,CAAC,GACzB,IAAO,IAAS,EAAQ,IAAI,CAAM,IAAI,KAAA;CAiB5C,OAhBA,QAAgB;EACd,IAAI,CAAC,KAAU,EAAQ,IAAI,CAAM,GAAG;EACpC,IAAI,IAAO,IACP,IAAO,EAAS,IAAI,CAAM;EAS9B,OARK,MACH,IAAO,EAAO,MAAM,QAAQ,CAAC,CAAC,MAC3B,MAAY,KAAK,EAAQ,IAAI,GAAQ,EAAE,WAAQ,CAAC,IAChD,MAA2B,KAAK,EAAQ,IAAI,GAAQ;GAAE,SAAS,CAAC;GAAG;EAAM,CAAC,CAC7E,CAAC,CAAC,cAAc,EAAS,OAAO,CAAM,CAAC,GACvC,EAAS,IAAI,GAAQ,CAAI,IAE3B,EAAU,WAAW,KAAQ,GAAU,MAAM,IAAI,CAAC,CAAC,SACtC;GACX,IAAO;EACT;CACF,GAAG,CAAC,CAAM,CAAC,GACJ;EAAE,SAAS,GAAM,WAAW,CAAC;EAAG,QAAQ,CAAC,CAAC,KAAQ,CAAC;EAAQ,OAAO,GAAM;CAAM;AACvF;AA4BA,SAAgB,EAAe,GAAc,GAAY,GAAgB,IAAwB,CAAC,GAAmB;CACnH,IAAM,IAAS,EAA4B,EAAE,MAAM,GAC7C,EAAE,YAAS,cAAW,EAAW,EAAE,UAAO,CAAC,GAC3C,IAAO,EAAQ,MAAM,MAAM,EAAE,SAAS,KAAQ,EAAE,SAAS,CAAM,GAC/D,IAAS,EAAE,UAAU,KAAA,GAErB,IAAS,IAAQ,EAAU,EAAK,IAAI,IAAI,EAAQ,EAAK,IAAI,IAAI,EAAK,OAAQ,KAAA,GAC1E,IAAI,EAAa;EAAE;EAAM;CAAG,GAAG;EAAE;EAAQ,MAAM,KAAU,CAAC,IAAS,OAAO,EAAE;EAAM;CAAO,CAAC;CAQhG,OAAO;EAAE,GAPK,QAAkE;GAC9E,IAAM,IAAM,IAAS,EAAE,QAAQ,EAAE,MAAM,QAAQ,MAAM,MAAM,EAAE,WAAW,CAAM;GAC9E,IAAI,KAAO,EAAI,WAAW,QAAQ,OAAO;IAAE,OAAO;KAAE;KAAQ,YAAY,EAAI;KAAY,QAAS,YAAY,KAAO,EAAI,UAAW,GAAM;IAAO;IAAG,WAAW;GAAM;GACpK,IAAI,CAAC,KAAU,CAAC,EAAE,MAAM,OAAO;IAAE,OAAO;IAAM,WAAW;GAAM;GAC/D,IAAM,IAAM,KAAQ,EAAa,GAAM,CAAE;GACzC,OAAO,IAAM;IAAE,OAAO;IAAK,WAAW;GAAK,IAAI;IAAE,OAAO;IAAM,WAAW;GAAM;EACjF,GAAG;GAAC;GAAQ,EAAE;GAAO,EAAE;GAAM;GAAQ;GAAM;EAAE,CACjC;EAAO;EAAM,SAAS,CAAC,KAAU,EAAE;EAAS,OAAO,EAAE;EAAO,QAAQ,EAAE;CAAO;AAC3F"}
+{"version":3,"file":"public.js","names":[],"sources":["../../src/react/public.ts"],"sourcesContent":["import { useEffect, useMemo, useState } 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 { PresetRule } from \"../client/generated/wire.js\";\nimport { defaultImage, isPattern, ruleDir } from \"../client/media/rules.js\";\nimport type { PublicPreset } from \"../client/public.js\";\nimport { useOptionalContentKitClient } from \"./context.js\";\nimport { useMediaRead } from \"./read.js\";\n\nexport interface UsePresets {\n  /** Every kind's public presets; empty until they load (or when the server has none). */\n  presets: PresetRule[];\n  loaded: boolean;\n  error?: ContentKitError;\n}\n\nconst settled = new WeakMap<ContentKitClient, { presets: PresetRule[]; error?: ContentKitError }>();\nconst inflight = new WeakMap<ContentKitClient, Promise<void>>();\n\n/** The public presets (`GET /media/presets`), fetched once per client. */\nexport function usePresets(o: { client?: ContentKitClient | null } = {}): UsePresets {\n  const client = useOptionalContentKitClient(o.client);\n  const [, rerender] = useState(0);\n  const done = client ? settled.get(client) : undefined;\n  useEffect(() => {\n    if (!client || settled.has(client)) return;\n    let live = true;\n    let load = inflight.get(client);\n    if (!load) {\n      load = client.media.presets().then(\n        (presets) => void settled.set(client, { presets }),\n        (error: ContentKitError) => void settled.set(client, { presets: [], error }),\n      ).finally(() => inflight.delete(client));\n      inflight.set(client, load);\n    }\n    void load.then(() => live && rerender((n) => n + 1));\n    return () => {\n      live = false;\n    };\n  }, [client]);\n  return { presets: done?.presets ?? [], loaded: !!done || !client, error: done?.error };\n}\n\nexport interface PublicImageOptions {\n  /** The host's listing of the item's image (its API's): shown without a read. */\n  image?: PublicPreset | null;\n  /** A read of the item the host already has. */\n  read?: ReadResult | null;\n  /** Overrides the provider's client. */\n  client?: ContentKitClient | null;\n}\n\nexport interface UsePublicImage {\n  /** The item's current renditions; else the kind's default image (when the preset has one); null while unknown or when there is neither. */\n  image: PublicPreset | null;\n  /** The preset's rules (aspect, widths, min_width) once the presets load. */\n  rule?: PresetRule;\n  /** image is the kind's default, not the item's own. */\n  isDefault: boolean;\n  loading: boolean;\n  error?: ContentKitError;\n  reload: () => void;\n}\n\n/**\n * An item's public image for a preset (\"avatar\", \"cover\", a version's\n * \"poster\"): the exact renditions from a read's `public` (or the host's\n * listing), else the kind's default image, else none. Reads refresh after\n * commits through the same client.\n */\nexport function usePublicImage(item: RefBody, preset: string, o: PublicImageOptions = {}): UsePublicImage {\n  const { kind, id } = item;\n  const client = useOptionalContentKitClient(o.client);\n  const { presets, loaded } = usePresets({ client });\n  const rule = presets.find((p) => p.kind === kind && p.name === preset);\n  const listed = o.image !== undefined;\n  // The read waits for the presets, so it lists only the preset's upload.\n  const prefix = rule ? (isPattern(rule.from) ? ruleDir(rule.from) : rule.from) : undefined;\n  const r = useMediaRead(item, { prefix, read: listed || !loaded ? null : o.read, client });\n  const image = useMemo((): { image: PublicPreset | null; isDefault: boolean } => {\n    const own = listed ? o.image : r.read?.public?.find((p) => p.preset === preset);\n    if (own && own.renditions.length) return { image: { preset, renditions: own.renditions, aspect: (\"aspect\" in own && own.aspect) || rule?.aspect }, isDefault: false };\n    if (!listed && !r.read) return { image: null, isDefault: false };\n    const def = rule && defaultImage(rule, id);\n    return def ? { image: def, isDefault: true } : { image: null, isDefault: false };\n  }, [listed, o.image, r.read, preset, rule, id]);\n  return { ...image, rule, loading: !loaded || r.loading, error: r.error, reload: r.reload };\n}\n"],"mappings":";;;;;AAiBA,IAAM,oBAAU,IAAI,QAA8E,GAC5F,oBAAW,IAAI,QAAyC;AAG9D,SAAgB,EAAW,IAA0C,CAAC,GAAe;CACnF,IAAM,IAAS,EAA4B,EAAE,MAAM,GAC7C,GAAG,KAAY,EAAS,CAAC,GACzB,IAAO,IAAS,EAAQ,IAAI,CAAM,IAAI,KAAA;CAiB5C,OAhBA,QAAgB;EACd,IAAI,CAAC,KAAU,EAAQ,IAAI,CAAM,GAAG;EACpC,IAAI,IAAO,IACP,IAAO,EAAS,IAAI,CAAM;EAS9B,OARK,MACH,IAAO,EAAO,MAAM,QAAQ,CAAC,CAAC,MAC3B,MAAY,KAAK,EAAQ,IAAI,GAAQ,EAAE,WAAQ,CAAC,IAChD,MAA2B,KAAK,EAAQ,IAAI,GAAQ;GAAE,SAAS,CAAC;GAAG;EAAM,CAAC,CAC7E,CAAC,CAAC,cAAc,EAAS,OAAO,CAAM,CAAC,GACvC,EAAS,IAAI,GAAQ,CAAI,IAE3B,EAAU,WAAW,KAAQ,GAAU,MAAM,IAAI,CAAC,CAAC,SACtC;GACX,IAAO;EACT;CACF,GAAG,CAAC,CAAM,CAAC,GACJ;EAAE,SAAS,GAAM,WAAW,CAAC;EAAG,QAAQ,CAAC,CAAC,KAAQ,CAAC;EAAQ,OAAO,GAAM;CAAM;AACvF;AA6BA,SAAgB,EAAe,GAAe,GAAgB,IAAwB,CAAC,GAAmB;CACxG,IAAM,EAAE,SAAM,UAAO,GACf,IAAS,EAA4B,EAAE,MAAM,GAC7C,EAAE,YAAS,cAAW,EAAW,EAAE,UAAO,CAAC,GAC3C,IAAO,EAAQ,MAAM,MAAM,EAAE,SAAS,KAAQ,EAAE,SAAS,CAAM,GAC/D,IAAS,EAAE,UAAU,KAAA,GAErB,IAAS,IAAQ,EAAU,EAAK,IAAI,IAAI,EAAQ,EAAK,IAAI,IAAI,EAAK,OAAQ,KAAA,GAC1E,IAAI,EAAa,GAAM;EAAE;EAAQ,MAAM,KAAU,CAAC,IAAS,OAAO,EAAE;EAAM;CAAO,CAAC;CAQxF,OAAO;EAAE,GAPK,QAAkE;GAC9E,IAAM,IAAM,IAAS,EAAE,QAAQ,EAAE,MAAM,QAAQ,MAAM,MAAM,EAAE,WAAW,CAAM;GAC9E,IAAI,KAAO,EAAI,WAAW,QAAQ,OAAO;IAAE,OAAO;KAAE;KAAQ,YAAY,EAAI;KAAY,QAAS,YAAY,KAAO,EAAI,UAAW,GAAM;IAAO;IAAG,WAAW;GAAM;GACpK,IAAI,CAAC,KAAU,CAAC,EAAE,MAAM,OAAO;IAAE,OAAO;IAAM,WAAW;GAAM;GAC/D,IAAM,IAAM,KAAQ,EAAa,GAAM,CAAE;GACzC,OAAO,IAAM;IAAE,OAAO;IAAK,WAAW;GAAK,IAAI;IAAE,OAAO;IAAM,WAAW;GAAM;EACjF,GAAG;GAAC;GAAQ,EAAE;GAAO,EAAE;GAAM;GAAQ;GAAM;EAAE,CACjC;EAAO;EAAM,SAAS,CAAC,KAAU,EAAE;EAAS,OAAO,EAAE;EAAO,QAAQ,EAAE;CAAO;AAC3F"}

package/dist/react/read.js

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