@openrails/contentkit-ui 0.83.0 → 0.86.0

package/dist/react/discovery.js

@@ -210,7 +210,7 @@ function A(t, n = {}) {
 var j = /* @__PURE__ */ new WeakMap();
 function M(e, t) {
 	let n = j.get(e);
-	return n || j.set(e, n = new s(e.discovery, t)), n;
+	return n || j.set(e, n = new s(e, t)), n;
 }
 function N(e = {}) {
 	let { client: t } = i(e.client);

package/dist/react/discovery.js.map

@@ -1 +1 @@
-{"version":3,"file":"discovery.js","names":[],"sources":["../../src/react/discovery.ts"],"sourcesContent":["import { useCallback, useContext, useEffect, useMemo, useRef, useState } from \"react\";\nimport { Beacons, eventId, type Attribution, type BeaconOptions, type ViewSession } from \"../client/beacons.js\";\nimport type { ContentKitClient } from \"../client/client.js\";\nimport type { MineQuery } from \"../client/content/favorites.js\";\nimport type { ContentQuery, HistoryQuery, RailQuery, ReleaseDatesQuery, SearchQuery, TypeaheadQuery } from \"../client/discovery.js\";\nimport { toContentKitError, type ContentKitError } from \"../client/errors.js\";\nimport type { Card, ContentFilters, ContentFiltersUpdate, ContentPage, DateCount, GroupCard, Interaction, InteractionPage, RecentSearch } from \"../client/generated/wire.js\";\nimport { ContentKitContext, useGuarded } from \"./context.js\";\nimport { keyOf, useContentScope, useList, useResource, type UseList } from \"./use-resource.js\";\n\nconst page = (p: ContentPage) => ({ items: p.contents, next: p.next_cursor ?? null });\n\n/** Titles, names and paths in the provider's language unless the query says otherwise. */\nfunction useDisplay<T extends { display_language?: string }>(q: T | null): T | null {\n  const language = useContext(ContentKitContext)?.language;\n  return useMemo(() => (q && !q.display_language && language ? { ...q, display_language: language } : q), [q, language]);\n}\n\n/** Contents as cards, a cursor page at a time; null reads nothing. */\nexport function useContents(q: ContentQuery | null, o: { client?: ContentKitClient } = {}): UseList<Card> {\n  const { client, store, scope } = useContentScope(o.client);\n  const query = useDisplay(q);\n  return useList(store, query ? keyOf(\"cards\", scope, \"list\", query) : null, { type: \"cards\" }, async (cursor, signal) =>\n    page(await client.discovery.list({ ...query, cursor: cursor as string | undefined }, signal)),\n  );\n}\n\n/** Keyword search results as cards; nothing while q.q is empty. */\nexport function useSearch(q: SearchQuery | null, o: { client?: ContentKitClient } = {}): UseList<Card> {\n  const { client, store, scope } = useContentScope(o.client);\n  const query = useDisplay(q?.q.trim() ? q : null);\n  return useList(store, query ? keyOf(\"cards\", scope, \"search\", query) : null, { type: \"cards\" }, async (cursor, signal) =>\n    page(await client.discovery.search({ ...query!, cursor: cursor as string | undefined }, signal)),\n  );\n}\n\nexport interface UseRail {\n  items: Card[];\n  loading: boolean;\n  error?: ContentKitError;\n  /** The site runs without the signal plane (not_configured): leave the rail out. */\n  unavailable: boolean;\n  reload: () => void;\n}\n\nfunction useRail(key: string | null, fetch: (signal: AbortSignal) => Promise<ContentPage>, o: { client?: ContentKitClient }): UseRail {\n  const { store } = useContentScope(o.client);\n  const r = useResource<Card[]>(store, key, { type: \"cards\" }, async (signal) => (await fetch(signal)).contents);\n  const unavailable = r.error?.code === \"not_configured\";\n  return { items: r.data ?? [], loading: !!key && (r.loading || !r.loaded), error: unavailable ? undefined : r.error, unavailable, reload: r.reload };\n}\n\n/** Contents like one: co-engagement, or the site's configured source. */\nexport function useSimilar(id: string | null | undefined, q: RailQuery = {}, o: { client?: ContentKitClient } = {}): UseRail {\n  const { client, scope } = useContentScope(o.client);\n  const query = useDisplay(q)!;\n  return useRail(id ? keyOf(\"cards\", scope, \"similar\", id, query) : null, (s) => client.discovery.similar(id!, query, s), o);\n}\n\n/** Contents for the signed-in reader; nothing signed out, or when q is null. */\nexport function useRecommendations(q: RailQuery | null = {}, o: { client?: ContentKitClient } = {}): UseRail {\n  const { client, scope, viewer } = useContentScope(o.client);\n  const query = useDisplay(q);\n  return useRail(viewer === null || !query ? null : keyOf(\"cards\", scope, \"recommended\", query), (s) => client.discovery.recommendations(query!, s), o);\n}\n\n/** A release date bucket, keyed by its date. */\nexport type ReleaseDate = DateCount & { id: string };\n\n/** The release date index: per month or day, newest first. */\nexport function useReleaseDates(q: ReleaseDatesQuery = {}, o: { client?: ContentKitClient } = {}): UseList<ReleaseDate> {\n  const { client, store, scope } = useContentScope(o.client);\n  const query = useDisplay(q)!;\n  return useList(store, keyOf(\"release-dates\", scope, query), { type: \"release-dates\" }, async (cursor, signal) => {\n    const r = await client.discovery.releaseDates({ ...query, cursor: cursor as string | undefined }, signal);\n    return { items: r.dates.map((d) => ({ ...d, id: d.date })), next: r.next_cursor ?? null };\n  });\n}\n\nexport interface UseHistory extends UseList<Card> {\n  /** Erases the reader's history: of one content item, one kind, or (no argument) everything. */\n  forget: (o?: { kind?: string; content_id?: string }) => Promise<void>;\n}\n\n/** What the signed-in reader engaged with, most recent first; nothing signed out, or when q is null. */\nexport function useHistory(q: HistoryQuery | null = {}, o: { client?: ContentKitClient } = {}): UseHistory {\n  const { client, store, scope, viewer } = useContentScope(o.client);\n  const query = useDisplay(q);\n  const guarded = useGuarded();\n  const list = useList(store, viewer === null || !query ? null : keyOf(\"history\", scope, query), { type: \"history\" }, async (cursor, signal) =>\n    page(await client.discovery.history({ ...query, cursor: cursor as string | undefined }, signal)),\n  );\n  const forget = useCallback((f: { kind?: string; content_id?: string } = {}) => guarded(() => client.discovery.forgetHistory(f)), [client, guarded]);\n  return { ...list, forget };\n}\n\nexport interface UseRecentSearches {\n  searches: RecentSearch[];\n  loading: boolean;\n  error?: ContentKitError;\n  /** Clears one query, or every recent search. */\n  clear: (query?: string) => Promise<void>;\n}\n\n/** The reader's recent searches, newest first (signed out, of this tab's session); enabled false reads nothing yet. */\nexport function useRecentSearches(o: { limit?: number; enabled?: boolean; client?: ContentKitClient } = {}): UseRecentSearches {\n  const { client, store, scope } = useContentScope(o.client);\n  const guarded = useGuarded();\n  const key = o.enabled === false ? null : keyOf(\"searches\", scope, o.limit ?? 10);\n  const r = useResource<RecentSearch[]>(store, key, { type: \"searches\" }, async (s) => (await client.discovery.recentSearches({ limit: o.limit }, s)).searches);\n  const clear = useCallback((query?: string) => guarded(() => client.discovery.clearSearches(query ? { query } : {})), [client, guarded]);\n  return { searches: r.data ?? [], loading: !!key && (r.loading || !r.loaded), error: r.error, clear };\n}\n\n/** A favorite or reaction with its content's or group's id. */\nexport type MyInteraction = Interaction & { id: string };\n\nconst interactions = (p: InteractionPage) => ({ items: p.items.map((x) => ({ ...x, id: x.content?.id ?? x.group?.id ?? \"\" })), next: p.next_cursor ?? null });\n\n/** The signed-in reader's favorites, most recent first: content cards or groups. */\nexport function useMyFavorites(q: MineQuery = {}, o: { client?: ContentKitClient } = {}): UseList<MyInteraction> {\n  const { client, store, scope, viewer } = useContentScope(o.client);\n  const query = useDisplay(q)!;\n  return useList(store, viewer === null ? null : keyOf(\"favorites\", scope, query), { type: \"favorites\" }, async (cursor, signal) =>\n    interactions(await client.favorites.mine({ ...query, cursor: cursor as string | undefined }, signal)),\n  );\n}\n\n/** What the signed-in reader liked (or, with value, disliked), most recent first. */\nexport function useMyReactions(q: MineQuery & { value?: \"like\" | \"dislike\" } = {}, o: { client?: ContentKitClient } = {}): UseList<MyInteraction> {\n  const { client, store, scope, viewer } = useContentScope(o.client);\n  const query = useDisplay(q)!;\n  return useList(store, viewer === null ? null : keyOf(\"reactions\", scope, query), { type: \"reactions\" }, async (cursor, signal) =>\n    interactions(await client.reactions.mine({ ...query, cursor: cursor as string | undefined }, signal)),\n  );\n}\n\nexport interface UseContentFilters {\n  /** null until read (and signed out). */\n  filters: ContentFilters | null;\n  loading: boolean;\n  error?: ContentKitError;\n  saving: boolean;\n  /** Replaces every setting; the lists showing re-read. */\n  save: (update: ContentFiltersUpdate) => Promise<ContentFilters>;\n  /** Shows or hides one filter's group, keeping the other settings. */\n  setVisible: (groupId: string, visible: boolean) => Promise<ContentFilters>;\n  setIncludeDeleted: (include: boolean) => Promise<ContentFilters>;\n}\n\n/** The signed-in reader's content filters: each configured group, its default and their setting. */\nexport function useContentFilters(o: { language?: string; client?: ContentKitClient } = {}): UseContentFilters {\n  const { client, store, scope, viewer, language: provided } = useContentScope(o.client);\n  const language = o.language ?? provided;\n  const key = viewer === null ? null : keyOf(\"content-filters\", scope, language);\n  const r = useResource<ContentFilters>(store, key, { type: \"content-filters\" }, (s) => client.discovery.contentFilters(language, s));\n  const guarded = useGuarded();\n  const [inflight, setInflight] = useState(0);\n  const current = useRef(r.data);\n  current.current = r.data;\n  const save = useCallback(\n    async (update: ContentFiltersUpdate) => {\n      setInflight((n) => n + 1);\n      try {\n        const out = await guarded(() => client.discovery.setContentFilters(update, language));\n        if (key) store.set(key, out);\n        return out;\n      } finally {\n        setInflight((n) => n - 1);\n      }\n    },\n    [client, guarded, language, key, store],\n  );\n  const settings = (f: ContentFilters) => f.filters.filter((x) => x.overridden).map((x) => ({ group_id: x.group.id, visible: x.visible }));\n  const setVisible = useCallback(\n    (groupId: string, visible: boolean) => {\n      const f = current.current;\n      if (!f) return Promise.reject(new Error(\"contentkit-ui: the content filters have not loaded\"));\n      return save({ filters: [...settings(f).filter((x) => x.group_id !== groupId), { group_id: groupId, visible }], include_deleted: f.include_deleted });\n    },\n    [save],\n  );\n  const setIncludeDeleted = useCallback(\n    (include: boolean) => {\n      const f = current.current;\n      if (!f) return Promise.reject(new Error(\"contentkit-ui: the content filters have not loaded\"));\n      return save({ filters: settings(f), include_deleted: include });\n    },\n    [save],\n  );\n  return { filters: r.data ?? null, loading: !!key && (r.loading || !r.loaded), error: r.error, saving: inflight > 0, save, setVisible, setIncludeDeleted };\n}\n\nexport interface UseTypeahead {\n  contents: Card[];\n  groups: GroupCard[];\n  /** The query the suggestions answer (trimmed). */\n  query: string;\n  loading: boolean;\n  error?: ContentKitError;\n}\n\nconst NONE: Pick<UseTypeahead, \"contents\" | \"groups\"> = { contents: [], groups: [] };\n\n/** Suggestions while the reader types: debounced, the stale ones abandoned. */\nexport function useTypeahead(\n  text: string,\n  o: Omit<TypeaheadQuery, \"q\"> & { debounce?: number; minLength?: number; client?: ContentKitClient } = {},\n): UseTypeahead {\n  const { client, language } = useContentScope(o.client);\n  const { debounce = 150, minLength = 1, client: _own, ...rest } = o;\n  const q = text.trim();\n  const query = useMemo(() => ({ display_language: language, ...rest, q }), [language, q, JSON.stringify(rest)]); // eslint-disable-line react-hooks/exhaustive-deps\n  const [state, setState] = useState<UseTypeahead>({ ...NONE, query: \"\", loading: false });\n  useEffect(() => {\n    if (q.length < minLength) {\n      setState({ ...NONE, query: \"\", loading: false });\n      return;\n    }\n    setState((s) => ({ ...s, loading: true }));\n    const ctl = new AbortController();\n    const timer = setTimeout(() => {\n      client.discovery.typeahead(query, ctl.signal).then(\n        (r) => setState({ contents: r.contents, groups: r.groups, query: q, loading: false }),\n        (e) => {\n          const error = toContentKitError(e);\n          if (error.code !== \"aborted\") setState({ ...NONE, query: q, loading: false, error });\n        },\n      );\n    }, debounce);\n    return () => {\n      clearTimeout(timer);\n      ctl.abort();\n    };\n  }, [client, query, q, debounce, minLength]);\n  return state;\n}\n\nconst beacons = new WeakMap<ContentKitClient, Beacons>();\n\n/** The client's signal and exposure batcher: one per client. */\nexport function beaconsFor(client: ContentKitClient, o?: BeaconOptions): Beacons {\n  let b = beacons.get(client);\n  if (!b) beacons.set(client, (b = new Beacons(client.discovery, o)));\n  return b;\n}\n\nexport function useBeacons(o: { client?: ContentKitClient } = {}): Beacons {\n  const { client } = useContentScope(o.client);\n  return beaconsFor(client);\n}\n\n/** A view of a content (or one version) while it is shown: report its progress as it changes. */\nexport function useViewSignal(content: string | null | undefined, version?: string, o: Attribution & { client?: ContentKitClient } = {}): ViewSession[\"update\"] {\n  const b = useBeacons(o);\n  const { client: _c, ...attribution } = o;\n  const session = useMemo(() => (content ? b.view(content, version, attribution) : null), [b, content, version]); // eslint-disable-line react-hooks/exhaustive-deps\n  return useCallback((u) => session?.update(u), [session]);\n}\n\nexport interface ExposureOptions {\n  /** Where the list is: \"home\", \"search\", \"similar\". */\n  surface: string;\n  /** Changes with what the list shows: a new render id. */\n  render: string;\n  ranker?: string;\n  query_id?: string;\n  language?: string;\n  client?: ContentKitClient;\n}\n\nexport interface UseExposure {\n  render_id: string;\n  /** A card's ref: reports it shown once at least half of it is in view. */\n  track: (content: string, position: number) => (el: Element | null) => void;\n  /** Reports a click on the card at position. */\n  click: (content: string, position: number) => void;\n}\n\n/** A rendered result list: each page rendered, each card shown, clicks attributed to the render. */\nexport function useExposure(items: readonly { id: string }[], o: ExposureOptions): UseExposure {\n  const b = useBeacons(o);\n  const renderId = useMemo(() => eventId(), [o.render]); // eslint-disable-line react-hooks/exhaustive-deps\n  const base = useMemo(() => ({ render_id: renderId, surface: o.surface, ranker: o.ranker, query_id: o.query_id, language: o.language }), [renderId, o.surface, o.ranker, o.query_id, o.language]);\n  const rendered = useRef(new Set<string>());\n  const visible = useRef(new Set<string>());\n  useEffect(() => {\n    rendered.current = new Set();\n    visible.current = new Set();\n  }, [renderId]);\n  useEffect(() => {\n    const shown = items.flatMap((it, i) => (rendered.current.has(it.id) ? [] : [{ content_id: it.id, position: i + 1 }]));\n    for (const s of shown) rendered.current.add(s.content_id);\n    if (shown.length) b.exposure({ ...base, stage: \"rendered\", occurred_at: new Date().toISOString(), shown });\n  }, [b, base, items]);\n  const pending = useRef<{ content_id: string; position: number }[]>([]);\n  const timer = useRef<ReturnType<typeof setTimeout>>(undefined);\n  const observer = useMemo(() => {\n    if (typeof IntersectionObserver !== \"function\") return null;\n    return new IntersectionObserver(\n      (entries) => {\n        for (const e of entries) {\n          if (!e.isIntersecting) continue;\n          const el = e.target as HTMLElement;\n          const content = el.dataset.exposureContent!;\n          if (visible.current.has(content)) continue;\n          visible.current.add(content);\n          pending.current.push({ content_id: content, position: Number(el.dataset.exposurePosition) });\n        }\n        timer.current ??= setTimeout(() => {\n          timer.current = undefined;\n          const shown = pending.current.splice(0);\n          if (shown.length) b.exposure({ ...base, stage: \"visible\", occurred_at: new Date().toISOString(), shown });\n        }, 300);\n      },\n      { threshold: 0.5 },\n    );\n  }, [b, base]);\n  useEffect(() => () => observer?.disconnect(), [observer]);\n  const track = useCallback(\n    (content: string, position: number) => (el: Element | null) => {\n      if (!el || !observer) return;\n      (el as HTMLElement).dataset.exposureContent = content;\n      (el as HTMLElement).dataset.exposurePosition = String(position);\n      observer.observe(el);\n    },\n    [observer],\n  );\n  const click = useCallback((content: string, position: number) => b.click(content, { render_id: renderId, surface: o.surface, position }), [b, renderId, o.surface]);\n  return { render_id: renderId, track, click };\n}\n"],"mappings":"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"}
+{"version":3,"file":"discovery.js","names":[],"sources":["../../src/react/discovery.ts"],"sourcesContent":["import { useCallback, useContext, useEffect, useMemo, useRef, useState } from \"react\";\nimport { Beacons, eventId, type Attribution, type BeaconOptions, type ViewSession } from \"../client/beacons.js\";\nimport type { ContentKitClient } from \"../client/client.js\";\nimport type { MineQuery } from \"../client/content/favorites.js\";\nimport type { ContentQuery, HistoryQuery, RailQuery, ReleaseDatesQuery, SearchQuery, TypeaheadQuery } from \"../client/discovery.js\";\nimport { toContentKitError, type ContentKitError } from \"../client/errors.js\";\nimport type { Card, ContentFilters, ContentFiltersUpdate, ContentPage, DateCount, GroupCard, Interaction, InteractionPage, RecentSearch } from \"../client/generated/wire.js\";\nimport { ContentKitContext, useGuarded } from \"./context.js\";\nimport { keyOf, useContentScope, useList, useResource, type UseList } from \"./use-resource.js\";\n\nconst page = (p: ContentPage) => ({ items: p.contents, next: p.next_cursor ?? null });\n\n/** Titles, names and paths in the provider's language unless the query says otherwise. */\nfunction useDisplay<T extends { display_language?: string }>(q: T | null): T | null {\n  const language = useContext(ContentKitContext)?.language;\n  return useMemo(() => (q && !q.display_language && language ? { ...q, display_language: language } : q), [q, language]);\n}\n\n/** Contents as cards, a cursor page at a time; null reads nothing. */\nexport function useContents(q: ContentQuery | null, o: { client?: ContentKitClient } = {}): UseList<Card> {\n  const { client, store, scope } = useContentScope(o.client);\n  const query = useDisplay(q);\n  return useList(store, query ? keyOf(\"cards\", scope, \"list\", query) : null, { type: \"cards\" }, async (cursor, signal) =>\n    page(await client.discovery.list({ ...query, cursor: cursor as string | undefined }, signal)),\n  );\n}\n\n/** Keyword search results as cards; nothing while q.q is empty. */\nexport function useSearch(q: SearchQuery | null, o: { client?: ContentKitClient } = {}): UseList<Card> {\n  const { client, store, scope } = useContentScope(o.client);\n  const query = useDisplay(q?.q.trim() ? q : null);\n  return useList(store, query ? keyOf(\"cards\", scope, \"search\", query) : null, { type: \"cards\" }, async (cursor, signal) =>\n    page(await client.discovery.search({ ...query!, cursor: cursor as string | undefined }, signal)),\n  );\n}\n\nexport interface UseRail {\n  items: Card[];\n  loading: boolean;\n  error?: ContentKitError;\n  /** The site runs without the signal plane (not_configured): leave the rail out. */\n  unavailable: boolean;\n  reload: () => void;\n}\n\nfunction useRail(key: string | null, fetch: (signal: AbortSignal) => Promise<ContentPage>, o: { client?: ContentKitClient }): UseRail {\n  const { store } = useContentScope(o.client);\n  const r = useResource<Card[]>(store, key, { type: \"cards\" }, async (signal) => (await fetch(signal)).contents);\n  const unavailable = r.error?.code === \"not_configured\";\n  return { items: r.data ?? [], loading: !!key && (r.loading || !r.loaded), error: unavailable ? undefined : r.error, unavailable, reload: r.reload };\n}\n\n/** Contents like one: co-engagement, or the site's configured source. */\nexport function useSimilar(id: string | null | undefined, q: RailQuery = {}, o: { client?: ContentKitClient } = {}): UseRail {\n  const { client, scope } = useContentScope(o.client);\n  const query = useDisplay(q)!;\n  return useRail(id ? keyOf(\"cards\", scope, \"similar\", id, query) : null, (s) => client.discovery.similar(id!, query, s), o);\n}\n\n/** Contents for the signed-in reader; nothing signed out, or when q is null. */\nexport function useRecommendations(q: RailQuery | null = {}, o: { client?: ContentKitClient } = {}): UseRail {\n  const { client, scope, viewer } = useContentScope(o.client);\n  const query = useDisplay(q);\n  return useRail(viewer === null || !query ? null : keyOf(\"cards\", scope, \"recommended\", query), (s) => client.discovery.recommendations(query!, s), o);\n}\n\n/** A release date bucket, keyed by its date. */\nexport type ReleaseDate = DateCount & { id: string };\n\n/** The release date index: per month or day, newest first. */\nexport function useReleaseDates(q: ReleaseDatesQuery = {}, o: { client?: ContentKitClient } = {}): UseList<ReleaseDate> {\n  const { client, store, scope } = useContentScope(o.client);\n  const query = useDisplay(q)!;\n  return useList(store, keyOf(\"release-dates\", scope, query), { type: \"release-dates\" }, async (cursor, signal) => {\n    const r = await client.discovery.releaseDates({ ...query, cursor: cursor as string | undefined }, signal);\n    return { items: r.dates.map((d) => ({ ...d, id: d.date })), next: r.next_cursor ?? null };\n  });\n}\n\nexport interface UseHistory extends UseList<Card> {\n  /** Erases the reader's history: of one content item, one kind, or (no argument) everything. */\n  forget: (o?: { kind?: string; content_id?: string }) => Promise<void>;\n}\n\n/** What the signed-in reader engaged with, most recent first; nothing signed out, or when q is null. */\nexport function useHistory(q: HistoryQuery | null = {}, o: { client?: ContentKitClient } = {}): UseHistory {\n  const { client, store, scope, viewer } = useContentScope(o.client);\n  const query = useDisplay(q);\n  const guarded = useGuarded();\n  const list = useList(store, viewer === null || !query ? null : keyOf(\"history\", scope, query), { type: \"history\" }, async (cursor, signal) =>\n    page(await client.discovery.history({ ...query, cursor: cursor as string | undefined }, signal)),\n  );\n  const forget = useCallback((f: { kind?: string; content_id?: string } = {}) => guarded(() => client.discovery.forgetHistory(f)), [client, guarded]);\n  return { ...list, forget };\n}\n\nexport interface UseRecentSearches {\n  searches: RecentSearch[];\n  loading: boolean;\n  error?: ContentKitError;\n  /** Clears one query, or every recent search. */\n  clear: (query?: string) => Promise<void>;\n}\n\n/** The reader's recent searches, newest first (signed out, of this tab's session); enabled false reads nothing yet. */\nexport function useRecentSearches(o: { limit?: number; enabled?: boolean; client?: ContentKitClient } = {}): UseRecentSearches {\n  const { client, store, scope } = useContentScope(o.client);\n  const guarded = useGuarded();\n  const key = o.enabled === false ? null : keyOf(\"searches\", scope, o.limit ?? 10);\n  const r = useResource<RecentSearch[]>(store, key, { type: \"searches\" }, async (s) => (await client.discovery.recentSearches({ limit: o.limit }, s)).searches);\n  const clear = useCallback((query?: string) => guarded(() => client.discovery.clearSearches(query ? { query } : {})), [client, guarded]);\n  return { searches: r.data ?? [], loading: !!key && (r.loading || !r.loaded), error: r.error, clear };\n}\n\n/** A favorite or reaction with its content's or group's id. */\nexport type MyInteraction = Interaction & { id: string };\n\nconst interactions = (p: InteractionPage) => ({ items: p.items.map((x) => ({ ...x, id: x.content?.id ?? x.group?.id ?? \"\" })), next: p.next_cursor ?? null });\n\n/** The signed-in reader's favorites, most recent first: content cards or groups. */\nexport function useMyFavorites(q: MineQuery = {}, o: { client?: ContentKitClient } = {}): UseList<MyInteraction> {\n  const { client, store, scope, viewer } = useContentScope(o.client);\n  const query = useDisplay(q)!;\n  return useList(store, viewer === null ? null : keyOf(\"favorites\", scope, query), { type: \"favorites\" }, async (cursor, signal) =>\n    interactions(await client.favorites.mine({ ...query, cursor: cursor as string | undefined }, signal)),\n  );\n}\n\n/** What the signed-in reader liked (or, with value, disliked), most recent first. */\nexport function useMyReactions(q: MineQuery & { value?: \"like\" | \"dislike\" } = {}, o: { client?: ContentKitClient } = {}): UseList<MyInteraction> {\n  const { client, store, scope, viewer } = useContentScope(o.client);\n  const query = useDisplay(q)!;\n  return useList(store, viewer === null ? null : keyOf(\"reactions\", scope, query), { type: \"reactions\" }, async (cursor, signal) =>\n    interactions(await client.reactions.mine({ ...query, cursor: cursor as string | undefined }, signal)),\n  );\n}\n\nexport interface UseContentFilters {\n  /** null until read (and signed out). */\n  filters: ContentFilters | null;\n  loading: boolean;\n  error?: ContentKitError;\n  saving: boolean;\n  /** Replaces every setting; the lists showing re-read. */\n  save: (update: ContentFiltersUpdate) => Promise<ContentFilters>;\n  /** Shows or hides one filter's group, keeping the other settings. */\n  setVisible: (groupId: string, visible: boolean) => Promise<ContentFilters>;\n  setIncludeDeleted: (include: boolean) => Promise<ContentFilters>;\n}\n\n/** The signed-in reader's content filters: each configured group, its default and their setting. */\nexport function useContentFilters(o: { language?: string; client?: ContentKitClient } = {}): UseContentFilters {\n  const { client, store, scope, viewer, language: provided } = useContentScope(o.client);\n  const language = o.language ?? provided;\n  const key = viewer === null ? null : keyOf(\"content-filters\", scope, language);\n  const r = useResource<ContentFilters>(store, key, { type: \"content-filters\" }, (s) => client.discovery.contentFilters(language, s));\n  const guarded = useGuarded();\n  const [inflight, setInflight] = useState(0);\n  const current = useRef(r.data);\n  current.current = r.data;\n  const save = useCallback(\n    async (update: ContentFiltersUpdate) => {\n      setInflight((n) => n + 1);\n      try {\n        const out = await guarded(() => client.discovery.setContentFilters(update, language));\n        if (key) store.set(key, out);\n        return out;\n      } finally {\n        setInflight((n) => n - 1);\n      }\n    },\n    [client, guarded, language, key, store],\n  );\n  const settings = (f: ContentFilters) => f.filters.filter((x) => x.overridden).map((x) => ({ group_id: x.group.id, visible: x.visible }));\n  const setVisible = useCallback(\n    (groupId: string, visible: boolean) => {\n      const f = current.current;\n      if (!f) return Promise.reject(new Error(\"contentkit-ui: the content filters have not loaded\"));\n      return save({ filters: [...settings(f).filter((x) => x.group_id !== groupId), { group_id: groupId, visible }], include_deleted: f.include_deleted });\n    },\n    [save],\n  );\n  const setIncludeDeleted = useCallback(\n    (include: boolean) => {\n      const f = current.current;\n      if (!f) return Promise.reject(new Error(\"contentkit-ui: the content filters have not loaded\"));\n      return save({ filters: settings(f), include_deleted: include });\n    },\n    [save],\n  );\n  return { filters: r.data ?? null, loading: !!key && (r.loading || !r.loaded), error: r.error, saving: inflight > 0, save, setVisible, setIncludeDeleted };\n}\n\nexport interface UseTypeahead {\n  contents: Card[];\n  groups: GroupCard[];\n  /** The query the suggestions answer (trimmed). */\n  query: string;\n  loading: boolean;\n  error?: ContentKitError;\n}\n\nconst NONE: Pick<UseTypeahead, \"contents\" | \"groups\"> = { contents: [], groups: [] };\n\n/** Suggestions while the reader types: debounced, the stale ones abandoned. */\nexport function useTypeahead(\n  text: string,\n  o: Omit<TypeaheadQuery, \"q\"> & { debounce?: number; minLength?: number; client?: ContentKitClient } = {},\n): UseTypeahead {\n  const { client, language } = useContentScope(o.client);\n  const { debounce = 150, minLength = 1, client: _own, ...rest } = o;\n  const q = text.trim();\n  const query = useMemo(() => ({ display_language: language, ...rest, q }), [language, q, JSON.stringify(rest)]); // eslint-disable-line react-hooks/exhaustive-deps\n  const [state, setState] = useState<UseTypeahead>({ ...NONE, query: \"\", loading: false });\n  useEffect(() => {\n    if (q.length < minLength) {\n      setState({ ...NONE, query: \"\", loading: false });\n      return;\n    }\n    setState((s) => ({ ...s, loading: true }));\n    const ctl = new AbortController();\n    const timer = setTimeout(() => {\n      client.discovery.typeahead(query, ctl.signal).then(\n        (r) => setState({ contents: r.contents, groups: r.groups, query: q, loading: false }),\n        (e) => {\n          const error = toContentKitError(e);\n          if (error.code !== \"aborted\") setState({ ...NONE, query: q, loading: false, error });\n        },\n      );\n    }, debounce);\n    return () => {\n      clearTimeout(timer);\n      ctl.abort();\n    };\n  }, [client, query, q, debounce, minLength]);\n  return state;\n}\n\nconst beacons = new WeakMap<ContentKitClient, Beacons>();\n\n/** The client's signal and exposure batcher: one per client. */\nexport function beaconsFor(client: ContentKitClient, o?: BeaconOptions): Beacons {\n  let b = beacons.get(client);\n  if (!b) beacons.set(client, (b = new Beacons(client, o)));\n  return b;\n}\n\nexport function useBeacons(o: { client?: ContentKitClient } = {}): Beacons {\n  const { client } = useContentScope(o.client);\n  return beaconsFor(client);\n}\n\n/** A view of a content (or one version) while it is shown: report its progress as it changes. */\nexport function useViewSignal(content: string | null | undefined, version?: string, o: Attribution & { client?: ContentKitClient } = {}): ViewSession[\"update\"] {\n  const b = useBeacons(o);\n  const { client: _c, ...attribution } = o;\n  const session = useMemo(() => (content ? b.view(content, version, attribution) : null), [b, content, version]); // eslint-disable-line react-hooks/exhaustive-deps\n  return useCallback((u) => session?.update(u), [session]);\n}\n\nexport interface ExposureOptions {\n  /** Where the list is: \"home\", \"search\", \"similar\". */\n  surface: string;\n  /** Changes with what the list shows: a new render id. */\n  render: string;\n  ranker?: string;\n  query_id?: string;\n  language?: string;\n  client?: ContentKitClient;\n}\n\nexport interface UseExposure {\n  render_id: string;\n  /** A card's ref: reports it shown once at least half of it is in view. */\n  track: (content: string, position: number) => (el: Element | null) => void;\n  /** Reports a click on the card at position. */\n  click: (content: string, position: number) => void;\n}\n\n/** A rendered result list: each page rendered, each card shown, clicks attributed to the render. */\nexport function useExposure(items: readonly { id: string }[], o: ExposureOptions): UseExposure {\n  const b = useBeacons(o);\n  const renderId = useMemo(() => eventId(), [o.render]); // eslint-disable-line react-hooks/exhaustive-deps\n  const base = useMemo(() => ({ render_id: renderId, surface: o.surface, ranker: o.ranker, query_id: o.query_id, language: o.language }), [renderId, o.surface, o.ranker, o.query_id, o.language]);\n  const rendered = useRef(new Set<string>());\n  const visible = useRef(new Set<string>());\n  useEffect(() => {\n    rendered.current = new Set();\n    visible.current = new Set();\n  }, [renderId]);\n  useEffect(() => {\n    const shown = items.flatMap((it, i) => (rendered.current.has(it.id) ? [] : [{ content_id: it.id, position: i + 1 }]));\n    for (const s of shown) rendered.current.add(s.content_id);\n    if (shown.length) b.exposure({ ...base, stage: \"rendered\", occurred_at: new Date().toISOString(), shown });\n  }, [b, base, items]);\n  const pending = useRef<{ content_id: string; position: number }[]>([]);\n  const timer = useRef<ReturnType<typeof setTimeout>>(undefined);\n  const observer = useMemo(() => {\n    if (typeof IntersectionObserver !== \"function\") return null;\n    return new IntersectionObserver(\n      (entries) => {\n        for (const e of entries) {\n          if (!e.isIntersecting) continue;\n          const el = e.target as HTMLElement;\n          const content = el.dataset.exposureContent!;\n          if (visible.current.has(content)) continue;\n          visible.current.add(content);\n          pending.current.push({ content_id: content, position: Number(el.dataset.exposurePosition) });\n        }\n        timer.current ??= setTimeout(() => {\n          timer.current = undefined;\n          const shown = pending.current.splice(0);\n          if (shown.length) b.exposure({ ...base, stage: \"visible\", occurred_at: new Date().toISOString(), shown });\n        }, 300);\n      },\n      { threshold: 0.5 },\n    );\n  }, [b, base]);\n  useEffect(() => () => observer?.disconnect(), [observer]);\n  const track = useCallback(\n    (content: string, position: number) => (el: Element | null) => {\n      if (!el || !observer) return;\n      (el as HTMLElement).dataset.exposureContent = content;\n      (el as HTMLElement).dataset.exposurePosition = String(position);\n      observer.observe(el);\n    },\n    [observer],\n  );\n  const click = useCallback((content: string, position: number) => b.click(content, { render_id: renderId, surface: o.surface, position }), [b, renderId, o.surface]);\n  return { render_id: renderId, track, click };\n}\n"],"mappings":"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"}

package/dist/react/folder.d.ts

@@ -49,6 +49,11 @@ export interface UseMediaFolder {
     uploads: FileInfo[];
     /** The upload queue; a file leaves it once the editor read lists it. */
     queue: UseUploadQueue;
+    /**
+     * Uploads on the server not yet added and not in the queue: an earlier
+     * visit's, or another editor's. commit() adds them; remove() discards them.
+     */
+    pending: FileInfo[];
     /**
      * Files added before the item and its editor read (the upload rules) were
      * known. They are screened and queued when the rules arrive, or refused
@@ -68,7 +73,7 @@ export interface UseMediaFolder {
     edit: (path: string, edit: Edit | null) => Promise<void>;
     /** Uploads file in place of the upload at path (same position and meta, no edit). */
     replace: (path: string, file: File) => Promise<void>;
-    /** Commits the uploaded files in queue order. */
+    /** Commits the uploaded files in queue order, then the pending ones. */
     commit: () => Promise<FileInfo[]>;
     /** Stops every upload, aborts its multipart upload and empties the queue (before deleting a draft). */
     discard: () => void;
@@ -81,7 +86,7 @@ export interface UseMediaFolder {
      * Leaving the page now interrupts it.
      */
     busy: boolean;
-    /** The item's uploads plus the files on their way in (waiting, queued, uploading, uploaded, being added); failed uploads are not counted. */
+    /** The item's uploads plus the files on their way in (waiting, queued, uploading, uploaded, pending, being added); failed uploads are not counted. */
     fileCount: number;
     /** The last update's or commit's failure; cleared by the next success. */
     error?: ContentKitError;

package/dist/react/folder.js

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