@openrails/contentkit-ui 0.85.1 → 0.87.0-rc.1

package/dist/react/groups.js.map

@@ -1 +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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"}
+{"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. */\nconst NO_MEMBERSHIPS: Membership[] = [];\n\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  // Stable while loading or failed: effects keyed on it must not see a new list every render.\n  const memberships = useMemo(() => r.data?.memberships ?? NO_MEMBERSHIPS, [r.data]);\n  return {\n    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

@@ -3,7 +3,7 @@ export { useContentKit, useContentKitClient, useContentURLs, useErrorReporter, u
 export { useMediaRead, type MediaReadOptions, type ReadWindow, type UseMediaRead } from './read.js';
 export { nameIn, thumbnailOf, useMediaFolder, type FolderGroup, type MediaFolderOptions, type UseMediaFolder } from './folder.js';
 export { useEditorCrop, type EditorCropOptions, type EditorCropState, type UseEditorCrop } from './crop.js';
-export { usePresets, usePublicImage, type PublicImageOptions, type UsePresets, type UsePublicImage } from './public.js';
+export { useAvatar, usePresets, usePublicImage, type PublicImageOptions, type UsePresets, type UsePublicImage } from './public.js';
 export { useCanonicalContent, type CanonicalContent, type CanonicalContentOptions } from './canonical.js';
 export { useNearViewport, type NearViewportOptions } from './viewport.js';
 export { useAdminLocation, useFlowClient, useStaffAccess, type AdminLocation, type AdminNavigation, type AdminQuery, type ContentKitAuth, type FlowClientOptions, type StaffAccess, type StaffArea, } from './admin.js';
@@ -12,10 +12,12 @@ 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 { useContent, useManagedContents, type ManageFilter, type UseContent } from './contents.js';
-export { defaultVersion, liveVersions, useContentDetail, type UseContentDetail } from './detail.js';
+export { useActivity, useMyStats, useTopContents, type UseStats } from './stats.js';
+export { defaultVersion, findVersion, liveVersions, useContentDetail, type ContentDetailOptions, type UseContentDetail } from './detail.js';
+export { useVersionParam } from './location.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 { beaconsFor, useBeacons, useContentFilters, useContents, useExposure, useHistory, useLockedCount, 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 { downloadMessage, nextRelease, startDownload, 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/location.d.ts

@@ -0,0 +1,11 @@
+/** Dispatched after a history write, so location readers look again. */
+export declare const MOVED = "ckui:navigate";
+export declare const subscribeHistory: (cb: () => void) => () => void;
+/**
+ * The page's ?v= version code (null when it names none) and a setter that
+ * writes it, null removing it: through the provider's navigate (a replace),
+ * else the browser history. location overrides window.location.
+ */
+export declare function useVersionParam(o?: {
+    location?: string;
+}): [string | null, (code: string | null) => void];

package/dist/react/location.js

@@ -0,0 +1,18 @@
+import { ContentKitContext as e } from "./context.js";
+import { versionParam as t, withVersion as n } from "../urls.js";
+import { useCallback as r, useContext as i, useSyncExternalStore as a } from "react";
+//#region src/react/location.ts
+var o = "ckui:navigate", s = (e) => (addEventListener("popstate", e), addEventListener(o, e), () => {
+	removeEventListener("popstate", e), removeEventListener(o, e);
+}), c = () => location.pathname + location.search + location.hash;
+function l(l = {}) {
+	let u = i(e)?.navigate, d = a(s, c, () => ""), f = l.location ?? d, p = r((e) => {
+		let t = n(l.location ?? c(), e);
+		u ? u(t, { replace: !0 }) : history.replaceState(history.state, "", t), dispatchEvent(new Event(o));
+	}, [u, l.location]);
+	return [t(f), p];
+}
+//#endregion
+export { o as MOVED, s as subscribeHistory, l as useVersionParam };
+
+//# sourceMappingURL=location.js.map

package/dist/react/location.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"location.js","names":[],"sources":["../../src/react/location.ts"],"sourcesContent":["import { useCallback, useContext, useSyncExternalStore } from \"react\";\nimport { versionParam, withVersion } from \"../urls/index.js\";\nimport { ContentKitContext } from \"./context.js\";\n\n/** Dispatched after a history write, so location readers look again. */\nexport const MOVED = \"ckui:navigate\";\n\nexport const subscribeHistory = (cb: () => void) => {\n  addEventListener(\"popstate\", cb);\n  addEventListener(MOVED, cb);\n  return () => {\n    removeEventListener(\"popstate\", cb);\n    removeEventListener(MOVED, cb);\n  };\n};\n\nconst here = () => location.pathname + location.search + location.hash;\n\n/**\n * The page's ?v= version code (null when it names none) and a setter that\n * writes it, null removing it: through the provider's navigate (a replace),\n * else the browser history. location overrides window.location.\n */\nexport function useVersionParam(o: { location?: string } = {}): [string | null, (code: string | null) => void] {\n  const navigate = useContext(ContentKitContext)?.navigate;\n  const current = useSyncExternalStore(subscribeHistory, here, () => \"\");\n  const at = o.location ?? current;\n  const set = useCallback(\n    (code: string | null) => {\n      const to = withVersion(o.location ?? here(), code);\n      if (navigate) navigate(to, { replace: true });\n      else history.replaceState(history.state, \"\", to);\n      dispatchEvent(new Event(MOVED));\n    },\n    [navigate, o.location],\n  );\n  return [versionParam(at), set];\n}\n"],"mappings":";;;;AAKA,IAAa,IAAQ,iBAER,KAAoB,OAC/B,iBAAiB,YAAY,CAAE,GAC/B,iBAAiB,GAAO,CAAE,SACb;CAEX,AADA,oBAAoB,YAAY,CAAE,GAClC,oBAAoB,GAAO,CAAE;AAC/B,IAGI,UAAa,SAAS,WAAW,SAAS,SAAS,SAAS;AAOlE,SAAgB,EAAgB,IAA2B,CAAC,GAAmD;CAC7G,IAAM,IAAW,EAAW,CAAiB,CAAC,EAAE,UAC1C,IAAU,EAAqB,GAAkB,SAAY,EAAE,GAC/D,IAAK,EAAE,YAAY,GACnB,IAAM,GACT,MAAwB;EACvB,IAAM,IAAK,EAAY,EAAE,YAAY,EAAK,GAAG,CAAI;EAGjD,AAFI,IAAU,EAAS,GAAI,EAAE,SAAS,GAAK,CAAC,IACvC,QAAQ,aAAa,QAAQ,OAAO,IAAI,CAAE,GAC/C,cAAc,IAAI,MAAM,CAAK,CAAC;CAChC,GACA,CAAC,GAAU,EAAE,QAAQ,CACvB;CACA,OAAO,CAAC,EAAa,CAAE,GAAG,CAAG;AAC/B"}

package/dist/react/public.d.ts

@@ -38,3 +38,11 @@ export interface UsePublicImage {
  * commits through the same client.
  */
 export declare function usePublicImage(item: RefBody, preset: string, o?: PublicImageOptions): UsePublicImage;
+/**
+ * A person's avatar (the content model's `avatars`, a Stable preset): URLs
+ * built from their id on this site's media host, showing their image or
+ * the default. null while the model loads or when the site shows none.
+ */
+export declare function useAvatar(userId: string | null | undefined, o?: {
+    client?: ContentKitClient;
+}): PublicPreset | null;

package/dist/react/public.js

@@ -1,38 +1,39 @@
-import { defaultImage as e, isPattern as t, ruleDir as n } from "../client/media/rules.js";
-import { useOptionalContentKitClient as r } from "./context.js";
-import { useMediaRead as i } from "./read.js";
-import { useEffect as a, useMemo as o, useState as s } from "react";
+import { defaultImage as e, isPattern as t, ruleDir as n, stableImage as r } from "../client/media/rules.js";
+import { useOptionalContentKitClient as i } from "./context.js";
+import { useKinds as a } from "./groups.js";
+import { useMediaRead as o } from "./read.js";
+import { useEffect as s, useMemo as c, useState as l } from "react";
 //#region src/react/public.ts
-var c = /* @__PURE__ */ new WeakMap(), l = /* @__PURE__ */ new WeakMap();
-function u(e = {}) {
-	let t = r(e.client), [, n] = s(0), i = t ? c.get(t) : void 0;
-	return a(() => {
-		if (!t || c.has(t)) return;
-		let e = !0, r = l.get(t);
-		return r || (r = t.media.presets().then((e) => void c.set(t, { presets: e }), (e) => void c.set(t, {
+var u = /* @__PURE__ */ new WeakMap(), d = /* @__PURE__ */ new WeakMap();
+function f(e = {}) {
+	let t = i(e.client), [, n] = l(0), r = t ? u.get(t) : void 0;
+	return s(() => {
+		if (!t || u.has(t)) return;
+		let e = !0, r = d.get(t);
+		return r || (r = t.media.presets().then((e) => void u.set(t, { presets: e }), (e) => void u.set(t, {
 			presets: [],
 			error: e
-		})).finally(() => l.delete(t)), l.set(t, r)), r.then(() => e && n((e) => e + 1)), () => {
+		})).finally(() => d.delete(t)), d.set(t, r)), r.then(() => e && n((e) => e + 1)), () => {
 			e = !1;
 		};
 	}, [t]), {
-		presets: i?.presets ?? [],
-		loaded: !!i || !t,
-		error: i?.error
+		presets: r?.presets ?? [],
+		loaded: !!r || !t,
+		error: r?.error
 	};
 }
-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, {
+function p(r, a, s = {}) {
+	let { kind: l, id: u } = r, d = i(s.client), { presets: p, loaded: m } = f({ client: d }), h = p.find((e) => e.kind === l && e.name === a), g = s.image !== void 0, _ = h ? t(h.from) ? n(h.from) : h.from : void 0, v = o(r, {
 		prefix: _,
-		read: g || !m ? null : c.read,
-		client: f
+		read: g || !m ? null : s.read,
+		client: d
 	});
 	return {
-		...o(() => {
-			let t = g ? c.image : v.read?.public?.find((e) => e.preset === s);
+		...c(() => {
+			let t = g ? s.image : v.read?.public?.find((e) => e.preset === a);
 			if (t && t.renditions.length) return {
 				image: {
-					preset: s,
+					preset: a,
 					renditions: t.renditions,
 					aspect: "aspect" in t && t.aspect || h?.aspect
 				},
@@ -42,7 +43,7 @@ function d(a, s, c = {}) {
 				image: null,
 				isDefault: !1
 			};
-			let n = h && e(h, d);
+			let n = h && e(h, u);
 			return n ? {
 				image: n,
 				isDefault: !0
@@ -52,11 +53,11 @@ function d(a, s, c = {}) {
 			};
 		}, [
 			g,
-			c.image,
+			s.image,
 			v.read,
-			s,
+			a,
 			h,
-			d
+			u
 		]),
 		rule: h,
 		loading: !m || v.loading,
@@ -64,7 +65,11 @@ function d(a, s, c = {}) {
 		reload: v.reload
 	};
 }
+function m(e, t = {}) {
+	let { kinds: n } = a(t), i = n?.avatars;
+	return c(() => i && e ? r(i, e) : null, [i, e]);
+}
 //#endregion
-export { u as usePresets, d as usePublicImage };
+export { m as useAvatar, f as usePresets, p as usePublicImage };
 
 //# sourceMappingURL=public.js.map

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, 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"}
+{"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, stableImage } from \"../client/media/rules.js\";\nimport type { PublicPreset } from \"../client/public.js\";\nimport { useOptionalContentKitClient } from \"./context.js\";\nimport { useKinds } from \"./groups.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\n/**\n * A person's avatar (the content model's `avatars`, a Stable preset): URLs\n * built from their id on this site's media host, showing their image or\n * the default. null while the model loads or when the site shows none.\n */\nexport function useAvatar(userId: string | null | undefined, o: { client?: ContentKitClient } = {}): PublicPreset | null {\n  const { kinds } = useKinds(o);\n  const rule = kinds?.avatars;\n  return useMemo(() => (rule && userId ? stableImage(rule, userId) : null), [rule, userId]);\n}\n"],"mappings":";;;;;;AAkBA,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;AAOA,SAAgB,EAAU,GAAmC,IAAmC,CAAC,GAAwB;CACvH,IAAM,EAAE,aAAU,EAAS,CAAC,GACtB,IAAO,GAAO;CACpB,OAAO,QAAe,KAAQ,IAAS,EAAY,GAAM,CAAM,IAAI,MAAO,CAAC,GAAM,CAAM,CAAC;AAC1F"}

package/dist/react/stats.d.ts

@@ -0,0 +1,24 @@
+import { ContentKitClient } from '../client/client.js';
+import { ContentKitError } from '../client/errors.js';
+import { Activity, MyStats, TopContents } from '../client/generated/wire.js';
+import { ActivityQuery, TopQuery } from '../client/stats.js';
+export interface UseStats<T> {
+    data: T | null;
+    loading: boolean;
+    error?: ContentKitError;
+    /** The site runs without the signal plane (not_configured). */
+    unavailable: boolean;
+    reload: () => void;
+}
+/** Staff: a kind's views per UTC day, newest first; null reads nothing. */
+export declare function useActivity(q: ActivityQuery | null, o?: {
+    client?: ContentKitClient;
+}): UseStats<Activity>;
+/** Staff: a kind's content ranked by views or comments over a period; null reads nothing. */
+export declare function useTopContents(q: TopQuery | null, o?: {
+    client?: ContentKitClient;
+}): UseStats<TopContents>;
+/** The signed-in reader's statistics; nothing signed out. */
+export declare function useMyStats(o?: {
+    client?: ContentKitClient;
+}): UseStats<MyStats>;

package/dist/react/stats.js

@@ -0,0 +1,28 @@
+import { keyOf as e, useContentScope as t, useResource as n } from "./use-resource.js";
+//#region src/react/stats.ts
+function r(e, r, i) {
+	let { client: a, store: o } = t(i.client), s = n(o, e, { type: "stats" }, (e) => r(a, e)), c = s.error?.code === "not_configured";
+	return {
+		data: s.data ?? null,
+		loading: !!e && (s.loading || !s.loaded),
+		error: c ? void 0 : s.error,
+		unavailable: c,
+		reload: s.reload
+	};
+}
+function i(n, i = {}) {
+	let { scope: a } = t(i.client);
+	return r(n ? e("stats", a, "activity", n.kind, n.days) : null, (e, t) => e.stats.activity(n, t), i);
+}
+function a(n, i = {}) {
+	let { scope: a } = t(i.client);
+	return r(n ? e("stats", a, "top", n) : null, (e, t) => e.stats.top(n, t), i);
+}
+function o(n = {}) {
+	let { scope: i, viewer: a } = t(n.client);
+	return r(a === null ? null : e("stats", i, "me"), (e, t) => e.stats.mine(t), n);
+}
+//#endregion
+export { i as useActivity, o as useMyStats, a as useTopContents };
+
+//# sourceMappingURL=stats.js.map

package/dist/react/stats.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stats.js","names":[],"sources":["../../src/react/stats.ts"],"sourcesContent":["import type { ContentKitClient } from \"../client/client.js\";\nimport type { ContentKitError } from \"../client/errors.js\";\nimport type { Activity, MyStats, TopContents } from \"../client/generated/wire.js\";\nimport type { ActivityQuery, TopQuery } from \"../client/stats.js\";\nimport { keyOf, useContentScope, useResource } from \"./use-resource.js\";\n\nexport interface UseStats<T> {\n  data: T | null;\n  loading: boolean;\n  error?: ContentKitError;\n  /** The site runs without the signal plane (not_configured). */\n  unavailable: boolean;\n  reload: () => void;\n}\n\nfunction useStats<T>(key: string | null, fetch: (c: ContentKitClient, signal: AbortSignal) => Promise<T>, o: { client?: ContentKitClient }): UseStats<T> {\n  const { client, store } = useContentScope(o.client);\n  const r = useResource<T>(store, key, { type: \"stats\" }, (signal) => fetch(client, signal));\n  const unavailable = r.error?.code === \"not_configured\";\n  return { data: r.data ?? null, loading: !!key && (r.loading || !r.loaded), error: unavailable ? undefined : r.error, unavailable, reload: r.reload };\n}\n\n/** Staff: a kind's views per UTC day, newest first; null reads nothing. */\nexport function useActivity(q: ActivityQuery | null, o: { client?: ContentKitClient } = {}): UseStats<Activity> {\n  const { scope } = useContentScope(o.client);\n  return useStats(q ? keyOf(\"stats\", scope, \"activity\", q.kind, q.days) : null, (c, s) => c.stats.activity(q!, s), o);\n}\n\n/** Staff: a kind's content ranked by views or comments over a period; null reads nothing. */\nexport function useTopContents(q: TopQuery | null, o: { client?: ContentKitClient } = {}): UseStats<TopContents> {\n  const { scope } = useContentScope(o.client);\n  return useStats(q ? keyOf(\"stats\", scope, \"top\", q) : null, (c, s) => c.stats.top(q!, s), o);\n}\n\n/** The signed-in reader's statistics; nothing signed out. */\nexport function useMyStats(o: { client?: ContentKitClient } = {}): UseStats<MyStats> {\n  const { scope, viewer } = useContentScope(o.client);\n  return useStats(viewer === null ? null : keyOf(\"stats\", scope, \"me\"), (c, s) => c.stats.mine(s), o);\n}\n"],"mappings":";;AAeA,SAAS,EAAY,GAAoB,GAAiE,GAA+C;CACvJ,IAAM,EAAE,WAAQ,aAAU,EAAgB,EAAE,MAAM,GAC5C,IAAI,EAAe,GAAO,GAAK,EAAE,MAAM,QAAQ,IAAI,MAAW,EAAM,GAAQ,CAAM,CAAC,GACnF,IAAc,EAAE,OAAO,SAAS;CACtC,OAAO;EAAE,MAAM,EAAE,QAAQ;EAAM,SAAS,CAAC,CAAC,MAAQ,EAAE,WAAW,CAAC,EAAE;EAAS,OAAO,IAAc,KAAA,IAAY,EAAE;EAAO;EAAa,QAAQ,EAAE;CAAO;AACrJ;AAGA,SAAgB,EAAY,GAAyB,IAAmC,CAAC,GAAuB;CAC9G,IAAM,EAAE,aAAU,EAAgB,EAAE,MAAM;CAC1C,OAAO,EAAS,IAAI,EAAM,SAAS,GAAO,YAAY,EAAE,MAAM,EAAE,IAAI,IAAI,OAAO,GAAG,MAAM,EAAE,MAAM,SAAS,GAAI,CAAC,GAAG,CAAC;AACpH;AAGA,SAAgB,EAAe,GAAoB,IAAmC,CAAC,GAA0B;CAC/G,IAAM,EAAE,aAAU,EAAgB,EAAE,MAAM;CAC1C,OAAO,EAAS,IAAI,EAAM,SAAS,GAAO,OAAO,CAAC,IAAI,OAAO,GAAG,MAAM,EAAE,MAAM,IAAI,GAAI,CAAC,GAAG,CAAC;AAC7F;AAGA,SAAgB,EAAW,IAAmC,CAAC,GAAsB;CACnF,IAAM,EAAE,UAAO,cAAW,EAAgB,EAAE,MAAM;CAClD,OAAO,EAAS,MAAW,OAAO,OAAO,EAAM,SAAS,GAAO,IAAI,IAAI,GAAG,MAAM,EAAE,MAAM,KAAK,CAAC,GAAG,CAAC;AACpG"}

package/dist/react/use-resource.js

@@ -44,10 +44,11 @@ function f(e, t, r, a, l = {}) {
 		reload: y
 	};
 }
-function p(e, t, n, r) {
+var p = [];
+function m(e, t, n, r) {
 	let a = f(e, t, n, (e) => r(void 0, e), { more: (e, t) => r(e, t) }), o = i(() => t ? e.loadMore(t) : Promise.resolve(), [e, t]);
 	return {
-		items: a.data?.items ?? [],
+		items: a.data?.items ?? p,
 		loading: a.loading || !!t && !a.loaded,
 		loadingMore: !!a.loadingMore,
 		error: a.error,
@@ -56,7 +57,7 @@ function p(e, t, n, r) {
 		reload: a.reload
 	};
 }
-function m(e, t, n = !1) {
+function h(e, t, n = !1) {
 	return async (r, i) => {
 		let a = typeof r == "number" ? r : 0, o = await t({
 			limit: e,
@@ -68,8 +69,8 @@ function m(e, t, n = !1) {
 		};
 	};
 }
-var h = (...e) => JSON.stringify(e);
-function g(e, t, n, r, i, a) {
+var g = (...e) => JSON.stringify(e);
+function _(e, t, n, r, i, a) {
 	let o = (Math.max(1, r) - 1) * i, s = f(e, t === null ? null : `${t}#${o}`, n, async (e) => {
 		let t = await a({
 			limit: i + 1,
@@ -81,7 +82,7 @@ function g(e, t, n, r, i, a) {
 		};
 	});
 	return {
-		items: s.data?.items ?? [],
+		items: s.data?.items ?? p,
 		loading: s.loading || !!t && !s.loaded,
 		error: s.error,
 		hasNext: s.data ? s.data.next !== null : !1,
@@ -89,6 +90,6 @@ function g(e, t, n, r, i, a) {
 	};
 }
 //#endregion
-export { h as keyOf, m as offsetPages, l as useContentScope, p as useList, g as usePaged, f as useResource };
+export { g as keyOf, h as offsetPages, l as useContentScope, m as useList, _ as usePaged, f as useResource };
 
 //# sourceMappingURL=use-resource.js.map

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

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

package/dist/react/versions.d.ts

@@ -1,6 +1,7 @@
 import { ContentKitClient } from '../client/client.js';
 import { ContentKitError } from '../client/errors.js';
-import { PlanSegment, ReaderPlan } from '../client/generated/wire.js';
+import { FileDownload, PlanSegment, ReaderPlan } from '../client/generated/wire.js';
+import { Translator } from '../i18n/messages.js';
 import { ReadWindow } from './read.js';
 export interface UseReaderPlan {
     /** null while loading, pending or failed. */
@@ -44,14 +45,33 @@ export declare function useSegmentPages(segment: PlanSegment | null | undefined,
     client?: ContentKitClient;
 }): UseSegmentPages;
 export interface UseVersionDownload {
-    /** Prepares the zip (asking again while it is prepared) and resolves with it. */
-    download: () => Promise<Blob>;
-    /** Prepared by the server, waiting. */
+    /**
+     * Grants the download (asking again while it is prepared), starts it in the
+     * browser and resolves with the grant.
+     */
+    download: () => Promise<FileDownload>;
+    /** Being prepared by the server, or granted and starting. */
     preparing: boolean;
     error?: ContentKitError;
+    /** While a quota refused: when the viewer may download again (ms). */
+    retryAt?: number;
+    /**
+     * What to tell the viewer about the last refusal: when a quota frees, when
+     * a download the site holds back opens ("available to download in N
+     * days"), a locked version, nothing to download, or a failure.
+     */
+    message?: string;
 }
-/** A version's pages as a zip, charged to the viewer's download quota. */
+/** Starts a granted download: the browser fetches its URL, an attachment. */
+export declare function startDownload(d: FileDownload): void;
+/** The viewer's line for a download refusal at now. */
+export declare function downloadMessage(m: Translator, err: ContentKitError | undefined, now?: number): string | undefined;
+/**
+ * A version's download, charged to the viewer's download quota: the
+ * original or rendition its kind serves, or its pages as a zip.
+ */
 export declare function useVersionDownload(content: string, version: string, o?: {
     poll?: number;
     client?: ContentKitClient;
+    start?: (d: FileDownload) => void;
 }): UseVersionDownload;