@openrails/contentkit-ui 0.93.0 → 0.94.0

package/dist/react/discovery.js.map

@@ -1 +1 @@
-{"version":3,"file":"discovery.js","names":[],"sources":["../../src/react/discovery.ts"],"sourcesContent":["import { useCallback, useContext, useEffect, useLayoutEffect, useMemo, useRef, useState, useSyncExternalStore } 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 { AccessMode, 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\";\nimport { recentSearchLimit } from \"../client/browser-search-history.js\";\n\nconst page = (p: ContentPage) => ({ items: p.contents, next: p.next_cursor ?? null });\nconst NO_SEARCHES: RecentSearch[] = [];\n\n// A new identity even after A → B → A, so late requests cannot write into the new visit.\nfunction useCurrentDiscoveryScope(client: ContentKitClient, scope: string): () => boolean {\n  const owner = useMemo(() => ({ client, scope }), [client, scope]);\n  const current = useRef<typeof owner | null>(owner);\n  useLayoutEffect(() => {\n    current.current = owner;\n    return () => { current.current = null; };\n  }, [owner]);\n  return useCallback(() => current.current === owner, [owner]);\n}\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/**\n * How many contents of a list the reader doesn't open: its filters' count\n * with locked cards less without them (sort and paging aside); null reads\n * nothing.\n */\nexport function useLockedCount(q: ContentQuery | null, o: { client?: ContentKitClient } = {}): { count?: number; loading: boolean } {\n  const { client, store, scope } = useContentScope(o.client);\n  const filter = useMemo(() => {\n    if (!q) return null;\n    const { sort: _s, cursor: _c, limit: _l, card_entities: _g, mode: _m, ...f } = q;\n    return f;\n  }, [q]);\n  const query = useDisplay(filter);\n  const r = useResource<number>(store, query ? keyOf(\"release-dates\", scope, \"locked\", query) : null, { type: \"release-dates\" }, async (signal) => {\n    const count = async (mode: AccessMode) =>\n      (await client.discovery.releaseDates({ ...query, mode, by: \"month\", limit: 1000 }, signal)).dates.reduce((n, d) => n + d.count, 0);\n    const [all, open] = await Promise.all([count(\"lock\"), count(\"hide\")]);\n    return Math.max(0, all - open);\n  });\n  return { count: r.data, loading: r.loading };\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, viewer } = useContentScope(o.client);\n  const query = useDisplay(q?.q.trim() ? q : null);\n  const isCurrent = useCurrentDiscoveryScope(client, scope);\n  return useList(store, query ? keyOf(\"cards\", scope, \"search\", query) : null, { type: \"cards\" }, async (cursor, signal) => {\n    const out = await client.discovery.search({ ...query!, cursor: cursor as string | undefined }, signal);\n    if (!cursor && viewer === null && !signal.aborted && isCurrent()) client.discovery.browserSearches.record(query!.q, out.contents.length);\n    return page(out);\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/** Guest history stays in this browser; account history comes only from the server. enabled false reads nothing yet. */\nexport function useRecentSearches(o: { limit?: number; enabled?: boolean; client?: ContentKitClient } = {}): UseRecentSearches {\n  const { client, store, scope, viewer } = useContentScope(o.client);\n  const guarded = useGuarded();\n  const isCurrent = useCurrentDiscoveryScope(client, scope);\n  const guest = viewer === null;\n  const enabled = o.enabled !== false;\n  const browser = client.discovery.browserSearches;\n  const subscribe = useCallback((listener: () => void) => guest && enabled ? browser.subscribe(listener) : () => {}, [browser, guest, enabled]);\n  const snapshot = useCallback(() => guest && enabled ? browser.snapshot() : NO_SEARCHES, [browser, guest, enabled]);\n  const local = useSyncExternalStore(subscribe, snapshot, () => NO_SEARCHES);\n  const searches = useMemo(() => local.slice(0, recentSearchLimit(o.limit)), [local, o.limit]);\n  const key = !enabled || guest ? 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  useEffect(() => {\n    if (!key) return;\n    const reload = () => { if (!store.snapshot(key).loading) store.load(key, true); };\n    // Reopening a panel must not leave an already-cached account list stale.\n    if (store.snapshot(key).loaded) reload();\n    const visible = () => { if (document.visibilityState === \"visible\") reload(); };\n    if (typeof window !== \"undefined\") window.addEventListener(\"focus\", reload);\n    if (typeof document !== \"undefined\") document.addEventListener(\"visibilitychange\", visible);\n    return () => {\n      if (typeof window !== \"undefined\") window.removeEventListener(\"focus\", reload);\n      if (typeof document !== \"undefined\") document.removeEventListener(\"visibilitychange\", visible);\n    };\n  }, [key, store]);\n  const clear = useCallback(async (query?: string) => {\n    if (!isCurrent()) return;\n    if (guest) { browser.clear(query); return; }\n    await guarded(() => isCurrent() ? client.discovery.clearSearches(query ? { query } : {}) : Promise.resolve());\n  }, [browser, client, guest, guarded, isCurrent]);\n  return guest\n    ? { searches: enabled ? searches : NO_SEARCHES, loading: false, clear }\n    : { searches: r.data ?? NO_SEARCHES, 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.entity?.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.entity.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  entities: GroupCard[];\n  /** The query the suggestions answer (trimmed). */\n  query: string;\n  loading: boolean;\n  error?: ContentKitError;\n}\n\nconst NONE: Pick<UseTypeahead, \"contents\" | \"entities\"> = { contents: [], entities: [] };\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, entities: r.entities, 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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"}
+{"version":3,"file":"discovery.js","names":[],"sources":["../../src/react/discovery.ts"],"sourcesContent":["import { useCallback, useContext, useEffect, useLayoutEffect, useMemo, useRef, useState, useSyncExternalStore } 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 { AccessMode, ContentQuery, HistoryQuery, RailQuery, ReleaseDatesQuery, SearchQuery, TypeaheadQuery } from \"../client/discovery.js\";\nimport { ContentKitError, toContentKitError } 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\";\nimport { recentSearchLimit } from \"../client/browser-search-history.js\";\n\nconst page = (p: ContentPage) => ({ items: p.contents, next: p.next_cursor ?? null });\nconst NO_SEARCHES: RecentSearch[] = [];\n\n// A new identity even after A → B → A, so late requests cannot write into the new visit.\nfunction useCurrentDiscoveryScope(client: ContentKitClient, scope: string): () => boolean {\n  const owner = useMemo(() => ({ client, scope }), [client, scope]);\n  const current = useRef<typeof owner | null>(owner);\n  useLayoutEffect(() => {\n    current.current = owner;\n    return () => { current.current = null; };\n  }, [owner]);\n  return useCallback(() => current.current === owner, [owner]);\n}\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/**\n * How many contents of a list the reader doesn't open: its filters' count\n * with locked cards less without them (sort and paging aside); null reads\n * nothing.\n */\nexport function useLockedCount(q: ContentQuery | null, o: { client?: ContentKitClient } = {}): { count?: number; loading: boolean } {\n  const { client, store, scope } = useContentScope(o.client);\n  const filter = useMemo(() => {\n    if (!q) return null;\n    const { sort: _s, cursor: _c, limit: _l, card_entities: _g, mode: _m, ...f } = q;\n    return f;\n  }, [q]);\n  const query = useDisplay(filter);\n  const r = useResource<number>(store, query ? keyOf(\"release-dates\", scope, \"locked\", query) : null, { type: \"release-dates\" }, async (signal) => {\n    const count = async (mode: AccessMode) =>\n      (await client.discovery.releaseDates({ ...query, mode, by: \"month\", limit: 1000 }, signal)).dates.reduce((n, d) => n + d.count, 0);\n    const [all, open] = await Promise.all([count(\"lock\"), count(\"hide\")]);\n    return Math.max(0, all - open);\n  });\n  return { count: r.data, loading: r.loading };\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, viewer } = useContentScope(o.client);\n  const query = useDisplay(q?.q.trim() ? q : null);\n  const isCurrent = useCurrentDiscoveryScope(client, scope);\n  return useList(store, query ? keyOf(\"cards\", scope, \"search\", query) : null, { type: \"cards\" }, async (cursor, signal) => {\n    const out = await client.discovery.search({ ...query!, cursor: cursor as string | undefined }, signal);\n    if (!cursor && viewer === null && !signal.aborted && isCurrent()) client.discovery.browserSearches.record(query!.q, out.contents.length);\n    return page(out);\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/** Guest history stays in this browser; account history comes only from the server. enabled false reads nothing yet. */\nexport function useRecentSearches(o: { limit?: number; enabled?: boolean; client?: ContentKitClient } = {}): UseRecentSearches {\n  const { client, store, scope, viewer } = useContentScope(o.client);\n  const guarded = useGuarded();\n  const isCurrent = useCurrentDiscoveryScope(client, scope);\n  const guest = viewer === null;\n  const enabled = o.enabled !== false;\n  const browser = client.discovery.browserSearches;\n  const subscribe = useCallback((listener: () => void) => guest && enabled ? browser.subscribe(listener) : () => {}, [browser, guest, enabled]);\n  const snapshot = useCallback(() => guest && enabled ? browser.snapshot() : NO_SEARCHES, [browser, guest, enabled]);\n  const local = useSyncExternalStore(subscribe, snapshot, () => NO_SEARCHES);\n  const searches = useMemo(() => local.slice(0, recentSearchLimit(o.limit)), [local, o.limit]);\n  const key = !enabled || guest ? 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  useEffect(() => {\n    if (!key) return;\n    const reload = () => { if (!store.snapshot(key).loading) store.load(key, true); };\n    // Reopening a panel must not leave an already-cached account list stale.\n    if (store.snapshot(key).loaded) reload();\n    const visible = () => { if (document.visibilityState === \"visible\") reload(); };\n    if (typeof window !== \"undefined\") window.addEventListener(\"focus\", reload);\n    if (typeof document !== \"undefined\") document.addEventListener(\"visibilitychange\", visible);\n    return () => {\n      if (typeof window !== \"undefined\") window.removeEventListener(\"focus\", reload);\n      if (typeof document !== \"undefined\") document.removeEventListener(\"visibilitychange\", visible);\n    };\n  }, [key, store]);\n  const clear = useCallback(async (query?: string) => {\n    if (!isCurrent()) return;\n    if (guest) { browser.clear(query); return; }\n    await guarded(() => isCurrent() ? client.discovery.clearSearches(query ? { query } : {}) : Promise.resolve());\n  }, [browser, client, guest, guarded, isCurrent]);\n  return guest\n    ? { searches: enabled ? searches : NO_SEARCHES, loading: false, clear }\n    : { searches: r.data ?? NO_SEARCHES, 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.entity?.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 the configured filters have loaded. */\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/** Configured filters: browser choices for guests, server choices for accounts. */\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 guest = viewer === null;\n  const browser = client.preferences.browser;\n  const local = useSyncExternalStore(browser.subscribe, browser.snapshot, browser.snapshot);\n  const key = keyOf(\"content-filters\", scope, language);\n  const previous = useRef<{ client: ContentKitClient; language?: string; guest: boolean; data?: ContentFilters } | null>(null);\n  const initial = guest && previous.current?.guest && previous.current.client === client && previous.current.language === language ? previous.current.data : undefined;\n  const r = useResource<ContentFilters>(store, key, { type: \"content-filters\" }, (s) => client.discovery.contentFilters(language, s), { initial });\n  previous.current = { client, language, guest, data: r.data };\n  const applyGuest = useCallback((source: ContentFilters, settings = local.filters): ContentFilters => {\n    const values = new Map(settings.map((f) => [f.group_id, f.visible]));\n    return { include_deleted: false, filters: source.filters.map((f) => ({ ...f, visible: values.get(f.entity.id) ?? f.default_visible, overridden: values.has(f.entity.id) })) };\n  }, [local.filters]);\n  const displayed = useMemo(() => r.data && guest ? applyGuest(r.data) : r.data, [r.data, guest, applyGuest]);\n  const guarded = useGuarded();\n  const isCurrent = useCurrentDiscoveryScope(client, scope);\n  const [inflight, setInflight] = useState(0);\n  const current = useRef(displayed);\n  current.current = displayed;\n  useEffect(() => { setInflight(0); }, [client, scope]);\n  const save = useCallback(\n    async (update: ContentFiltersUpdate) => {\n      if (!isCurrent()) throw new ContentKitError(\"aborted\", \"The account changed.\");\n      if (guest) {\n        const source = current.current;\n        if (!source) throw new ContentKitError(\"invalid_request\", \"Content filters have not loaded.\");\n        const allowed = new Set(source.filters.map((f) => f.entity.id));\n        if (update.filters.some((f) => !allowed.has(f.group_id))) throw new ContentKitError(\"invalid_request\", \"This content filter is not configured.\");\n        browser.setFilters(update.filters);\n        return applyGuest(source, update.filters);\n      }\n      setInflight((n) => n + 1);\n      try {\n        const out = await guarded(() => {\n          if (!isCurrent()) throw new ContentKitError(\"aborted\", \"The account changed.\");\n          return client.discovery.setContentFilters(update, language);\n        });\n        if (isCurrent()) store.set(key, out);\n        return out;\n      } finally {\n        setInflight((n) => Math.max(0, n - 1));\n      }\n    },\n    [client, guarded, language, key, store, isCurrent, guest, browser, applyGuest],\n  );\n  const settings = (f: ContentFilters) => f.filters.filter((x) => x.overridden).map((x) => ({ group_id: x.entity.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: displayed ?? null, loading: r.loading || !r.loaded, error: r.error, saving: inflight > 0, save, setVisible, setIncludeDeleted };\n}\n\nexport interface UseTypeahead {\n  contents: Card[];\n  entities: GroupCard[];\n  /** The query the suggestions answer (trimmed). */\n  query: string;\n  loading: boolean;\n  error?: ContentKitError;\n}\n\nconst NONE: Pick<UseTypeahead, \"contents\" | \"entities\"> = { contents: [], entities: [] };\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, entities: r.entities, 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/index.d.ts

@@ -1,4 +1,5 @@
 export { ContentKitProvider, type ContentKitProviderProps } from './provider.js';
+export { useReaderPreferences } from './reader-preferences.js';
 export { useContentKit, useContentKitClient, useContentURLs, useErrorReporter, useGuarded, GuardContext, useOptionalContentKitClient, type ContentKitContextValue, type ContentKitErrorHandler, type ContentKitErrorInfo, type ContentKitGuard, type ContentKitOperation, type Navigate, type SocialOperation, } from './context.js';
 export { useMediaRead, type MediaReadOptions, type ReadWindow, type UseMediaRead } from './read.js';
 export { nameIn, thumbnailOf, useMediaFolder, type FolderGroup, type MediaFolderOptions, type UseMediaFolder } from './folder.js';

package/dist/react/provider.d.ts

@@ -3,12 +3,15 @@ import { ContentKitClient } from '../client/client.js';
 import { ContentKitChange } from '../client/http.js';
 import { ContentURLs } from '../urls/index.js';
 import { ContentKitErrorHandler, Navigate } from './context.js';
+import { LanguagePreference } from '../client/reader-preferences.js';
 export interface ContentKitProviderProps {
     client: ContentKitClient;
     /** The signed-in user's id as ContentKit sees it (the actor id), or null when signed out. */
     viewer?: string | null;
     /** Request language; keep it in sync with the client's language callback. */
     language?: string;
+    /** Account storage for the preferred language; return null when unset. */
+    languagePreference?: LanguagePreference;
     /** Change when the current viewer's permissions or entitlements change. */
     accessRevision?: string | number;
     /** Asks the visitor to sign in: comments, reactions, favorites and votes prompt with it rather than act anonymously. */
@@ -24,4 +27,4 @@ export interface ContentKitProviderProps {
     children?: ReactNode;
 }
 /** Client, URL config, callbacks and the shared read store for every hook below. Renders no DOM. */
-export declare function ContentKitProvider({ client, viewer, language, accessRevision, onSignIn, urls, navigate, onChange, onError, children }: ContentKitProviderProps): import('react').JSX.Element;
+export declare function ContentKitProvider({ client, viewer, language, languagePreference, accessRevision, onSignIn, urls, navigate, onChange, onError, children }: ContentKitProviderProps): import('react').JSX.Element;

package/dist/react/provider.js

@@ -1,49 +1,56 @@
 import { ContentKitContext as e } from "./context.js";
 import { storeFor as t } from "./store.js";
-import { useEffect as n, useLayoutEffect as r, useMemo as i, useRef as a } from "react";
-import { jsx as o } from "react/jsx-runtime";
+import { useEffect as n, useLayoutEffect as r, useMemo as i, useRef as a, useSyncExternalStore as o } from "react";
+import { jsx as s } from "react/jsx-runtime";
 //#region src/react/provider.tsx
-function s({ client: s, viewer: c, language: l, accessRevision: u, onSignIn: d, urls: f, navigate: p, onChange: m, onError: h, children: g }) {
-	let _ = JSON.stringify({
-		viewer: c,
-		language: l,
-		accessRevision: u
+function c({ client: c, viewer: l, language: u, languagePreference: d, accessRevision: f, onSignIn: p, urls: m, navigate: h, onChange: g, onError: _, children: v }) {
+	let y = c.preferences.browser, b = o(y.subscribe, y.snapshot, y.snapshot), x = JSON.stringify({
+		viewer: l,
+		language: u,
+		accessRevision: f,
+		guestFilters: l === null ? b.filters : void 0
 	});
 	r(() => {
-		s.setReadScope(_);
-	}, [s, _]);
-	let v = a(m);
+		c.preferences.configure(l, d);
+	}, [
+		c,
+		l,
+		d
+	]), r(() => {
+		c.setReadScope(x);
+	}, [c, x]);
+	let S = a(g);
 	n(() => {
-		v.current = m;
-	}), n(() => s.subscribe((e, t) => v.current?.(e, t)), [s]);
-	let y = i(() => ({
-		client: s,
-		viewer: c,
-		language: l,
-		accessRevision: u,
-		readScope: _,
-		onSignIn: d,
-		urls: f,
-		navigate: p,
-		onError: h,
-		store: t(s)
+		S.current = g;
+	}), n(() => c.subscribe((e, t) => S.current?.(e, t)), [c]);
+	let C = i(() => ({
+		client: c,
+		viewer: l,
+		language: u,
+		accessRevision: f,
+		readScope: x,
+		onSignIn: p,
+		urls: m,
+		navigate: h,
+		onError: _,
+		store: t(c)
 	}), [
-		s,
 		c,
 		l,
 		u,
-		_,
-		d,
 		f,
+		x,
 		p,
-		h
+		m,
+		h,
+		_
 	]);
-	return /* @__PURE__ */ o(e.Provider, {
-		value: y,
-		children: g
+	return /* @__PURE__ */ s(e.Provider, {
+		value: C,
+		children: v
 	});
 }
 //#endregion
-export { s as ContentKitProvider };
+export { c as ContentKitProvider };
 
 //# sourceMappingURL=provider.js.map

package/dist/react/provider.js.map

@@ -1 +1 @@
-{"version":3,"file":"provider.js","names":[],"sources":["../../src/react/provider.tsx"],"sourcesContent":["import { useEffect, useLayoutEffect, useMemo, useRef, type ReactNode } from \"react\";\nimport type { ContentKitClient } from \"../client/client.js\";\nimport type { ContentKitChange } from \"../client/http.js\";\nimport type { ContentURLs } from \"../urls/index.js\";\nimport { ContentKitContext, type ContentKitErrorHandler, type Navigate } from \"./context.js\";\nimport { storeFor } from \"./store.js\";\n\nexport interface ContentKitProviderProps {\n  client: ContentKitClient;\n  /** The signed-in user's id as ContentKit sees it (the actor id), or null when signed out. */\n  viewer?: string | null;\n  /** Request language; keep it in sync with the client's language callback. */\n  language?: string;\n  /** Change when the current viewer's permissions or entitlements change. */\n  accessRevision?: string | number;\n  /** Asks the visitor to sign in: comments, reactions, favorites and votes prompt with it rather than act anonymously. */\n  onSignIn?: () => void;\n  /** Content URL helpers (createContentURLs from `/urls`). */\n  urls?: ContentURLs;\n  /** Host router for in-app navigation (a canonical replace). */\n  navigate?: Navigate;\n  /** Every successful mutation; null scope means refetch instead of applying its data. */\n  onChange?: (change: ContentKitChange, scope: string | null) => void;\n  /** Receives every failure the components show (a component's own `onError` wins). */\n  onError?: ContentKitErrorHandler;\n  children?: ReactNode;\n}\n\n/** Client, URL config, callbacks and the shared read store for every hook below. Renders no DOM. */\nexport function ContentKitProvider({ client, viewer, language, accessRevision, onSignIn, urls, navigate, onChange, onError, children }: ContentKitProviderProps) {\n  const readScope = JSON.stringify({ viewer, language, accessRevision });\n  useLayoutEffect(() => { client.setReadScope(readScope); }, [client, readScope]);\n  const changed = useRef(onChange);\n  useEffect(() => {\n    changed.current = onChange;\n  });\n  useEffect(() => client.subscribe((c, scope) => changed.current?.(c, scope)), [client]);\n  const value = useMemo(\n    () => ({ client, viewer, language, accessRevision, readScope, onSignIn, urls, navigate, onError, store: storeFor(client) }),\n    [client, viewer, language, accessRevision, readScope, onSignIn, urls, navigate, onError],\n  );\n  return <ContentKitContext.Provider value={value}>{children}</ContentKitContext.Provider>;\n}\n"],"mappings":";;;;;AA6BA,SAAgB,EAAmB,EAAE,WAAQ,WAAQ,aAAU,mBAAgB,aAAU,SAAM,aAAU,aAAU,YAAS,eAAqC;CAC/J,IAAM,IAAY,KAAK,UAAU;EAAE;EAAQ;EAAU;CAAe,CAAC;CACrE,QAAsB;EAAE,EAAO,aAAa,CAAS;CAAG,GAAG,CAAC,GAAQ,CAAS,CAAC;CAC9E,IAAM,IAAU,EAAO,CAAQ;CAI/B,AAHA,QAAgB;EACd,EAAQ,UAAU;CACpB,CAAC,GACD,QAAgB,EAAO,WAAW,GAAG,MAAU,EAAQ,UAAU,GAAG,CAAK,CAAC,GAAG,CAAC,CAAM,CAAC;CACrF,IAAM,IAAQ,SACL;EAAE;EAAQ;EAAQ;EAAU;EAAgB;EAAW;EAAU;EAAM;EAAU;EAAS,OAAO,EAAS,CAAM;CAAE,IACzH;EAAC;EAAQ;EAAQ;EAAU;EAAgB;EAAW;EAAU;EAAM;EAAU;CAAO,CACzF;CACA,OAAO,kBAAC,EAAkB,UAAnB;EAAmC;EAAQ;CAAqC,CAAA;AACzF"}
+{"version":3,"file":"provider.js","names":[],"sources":["../../src/react/provider.tsx"],"sourcesContent":["import { useEffect, useLayoutEffect, useMemo, useRef, useSyncExternalStore, type ReactNode } from \"react\";\nimport type { ContentKitClient } from \"../client/client.js\";\nimport type { ContentKitChange } from \"../client/http.js\";\nimport type { ContentURLs } from \"../urls/index.js\";\nimport { ContentKitContext, type ContentKitErrorHandler, type Navigate } from \"./context.js\";\nimport { storeFor } from \"./store.js\";\nimport type { LanguagePreference } from \"../client/reader-preferences.js\";\n\nexport interface ContentKitProviderProps {\n  client: ContentKitClient;\n  /** The signed-in user's id as ContentKit sees it (the actor id), or null when signed out. */\n  viewer?: string | null;\n  /** Request language; keep it in sync with the client's language callback. */\n  language?: string;\n  /** Account storage for the preferred language; return null when unset. */\n  languagePreference?: LanguagePreference;\n  /** Change when the current viewer's permissions or entitlements change. */\n  accessRevision?: string | number;\n  /** Asks the visitor to sign in: comments, reactions, favorites and votes prompt with it rather than act anonymously. */\n  onSignIn?: () => void;\n  /** Content URL helpers (createContentURLs from `/urls`). */\n  urls?: ContentURLs;\n  /** Host router for in-app navigation (a canonical replace). */\n  navigate?: Navigate;\n  /** Every successful mutation; null scope means refetch instead of applying its data. */\n  onChange?: (change: ContentKitChange, scope: string | null) => void;\n  /** Receives every failure the components show (a component's own `onError` wins). */\n  onError?: ContentKitErrorHandler;\n  children?: ReactNode;\n}\n\n/** Client, URL config, callbacks and the shared read store for every hook below. Renders no DOM. */\nexport function ContentKitProvider({ client, viewer, language, languagePreference, accessRevision, onSignIn, urls, navigate, onChange, onError, children }: ContentKitProviderProps) {\n  const browser = client.preferences.browser;\n  const preferences = useSyncExternalStore(browser.subscribe, browser.snapshot, browser.snapshot);\n  const readScope = JSON.stringify({ viewer, language, accessRevision, guestFilters: viewer === null ? preferences.filters : undefined });\n  useLayoutEffect(() => { client.preferences.configure(viewer, languagePreference); }, [client, viewer, languagePreference]);\n  useLayoutEffect(() => { client.setReadScope(readScope); }, [client, readScope]);\n  const changed = useRef(onChange);\n  useEffect(() => {\n    changed.current = onChange;\n  });\n  useEffect(() => client.subscribe((c, scope) => changed.current?.(c, scope)), [client]);\n  const value = useMemo(\n    () => ({ client, viewer, language, accessRevision, readScope, onSignIn, urls, navigate, onError, store: storeFor(client) }),\n    [client, viewer, language, accessRevision, readScope, onSignIn, urls, navigate, onError],\n  );\n  return <ContentKitContext.Provider value={value}>{children}</ContentKitContext.Provider>;\n}\n"],"mappings":";;;;;AAgCA,SAAgB,EAAmB,EAAE,WAAQ,WAAQ,aAAU,uBAAoB,mBAAgB,aAAU,SAAM,aAAU,aAAU,YAAS,eAAqC;CACnL,IAAM,IAAU,EAAO,YAAY,SAC7B,IAAc,EAAqB,EAAQ,WAAW,EAAQ,UAAU,EAAQ,QAAQ,GACxF,IAAY,KAAK,UAAU;EAAE;EAAQ;EAAU;EAAgB,cAAc,MAAW,OAAO,EAAY,UAAU,KAAA;CAAU,CAAC;CAEtI,AADA,QAAsB;EAAE,EAAO,YAAY,UAAU,GAAQ,CAAkB;CAAG,GAAG;EAAC;EAAQ;EAAQ;CAAkB,CAAC,GACzH,QAAsB;EAAE,EAAO,aAAa,CAAS;CAAG,GAAG,CAAC,GAAQ,CAAS,CAAC;CAC9E,IAAM,IAAU,EAAO,CAAQ;CAI/B,AAHA,QAAgB;EACd,EAAQ,UAAU;CACpB,CAAC,GACD,QAAgB,EAAO,WAAW,GAAG,MAAU,EAAQ,UAAU,GAAG,CAAK,CAAC,GAAG,CAAC,CAAM,CAAC;CACrF,IAAM,IAAQ,SACL;EAAE;EAAQ;EAAQ;EAAU;EAAgB;EAAW;EAAU;EAAM;EAAU;EAAS,OAAO,EAAS,CAAM;CAAE,IACzH;EAAC;EAAQ;EAAQ;EAAU;EAAgB;EAAW;EAAU;EAAM;EAAU;CAAO,CACzF;CACA,OAAO,kBAAC,EAAkB,UAAnB;EAAmC;EAAQ;CAAqC,CAAA;AACzF"}

package/dist/react/reader-preferences.d.ts

@@ -0,0 +1,13 @@
+import { ContentKitClient } from '../client/client.js';
+/** Stored preference state; changing a route's language never writes it. */
+export declare function useReaderPreferences(o?: {
+    client?: ContentKitClient;
+}): {
+    setLanguage: (language: string) => Promise<void>;
+    retry: () => Promise<void>;
+    language?: string;
+    loading: boolean;
+    saving: boolean;
+    pending: boolean;
+    error?: import('../client/errors.js').ContentKitError;
+};

package/dist/react/reader-preferences.js

@@ -0,0 +1,15 @@
+import { useContentKitClient as e } from "./context.js";
+import { useSyncExternalStore as t } from "react";
+//#region src/react/reader-preferences.ts
+function n(n = {}) {
+	let r = e(n.client).preferences;
+	return {
+		...t(r.subscribe, r.snapshot, r.snapshot),
+		setLanguage: (e) => r.setLanguage(e),
+		retry: () => r.retry()
+	};
+}
+//#endregion
+export { n as useReaderPreferences };
+
+//# sourceMappingURL=reader-preferences.js.map

package/dist/react/reader-preferences.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reader-preferences.js","names":[],"sources":["../../src/react/reader-preferences.ts"],"sourcesContent":["import { useSyncExternalStore } from \"react\";\nimport type { ContentKitClient } from \"../client/client.js\";\nimport { useContentKitClient } from \"./context.js\";\n\n/** Stored preference state; changing a route's language never writes it. */\nexport function useReaderPreferences(o: { client?: ContentKitClient } = {}) {\n  const preferences = useContentKitClient(o.client).preferences;\n  const state = useSyncExternalStore(preferences.subscribe, preferences.snapshot, preferences.snapshot);\n  return { ...state, setLanguage: (language: string) => preferences.setLanguage(language), retry: () => preferences.retry() };\n}\n"],"mappings":";;;AAKA,SAAgB,EAAqB,IAAmC,CAAC,GAAG;CAC1E,IAAM,IAAc,EAAoB,EAAE,MAAM,CAAC,CAAC;CAElD,OAAO;EAAE,GADK,EAAqB,EAAY,WAAW,EAAY,UAAU,EAAY,QAChF;EAAO,cAAc,MAAqB,EAAY,YAAY,CAAQ;EAAG,aAAa,EAAY,MAAM;CAAE;AAC5H"}

package/dist/react.js

@@ -25,5 +25,6 @@ import { useActivity as We, useMyStats as Ge, useTopContents as Ke } from "./rea
 import { useContent as qe, useManagedContents as Je } from "./react/contents.js";
 import { useNotificationUnread as Ye, useNotifications as Xe } from "./react/notifications.js";
 import { ContentKitProvider as Ze } from "./react/provider.js";
-import { useCanonicalContent as Qe } from "./react/canonical.js";
-export { Ze as ContentKitProvider, R as GALLERY_VIEW_KEY, i as GuardContext, e as HOVER_DELAY, t as InlinePreviewContext, z as PLAYER_QUALITY_KEY, h as ResourceStore, _e as beaconsFor, Ne as defaultVersion, Re as downloadMessage, A as editOutput, Pe as editionOf, Fe as findVersion, Ie as liveVersions, y as memberId, G as nameIn, ze as nextRelease, g as resourcesFor, N as round3, Be as startDownload, K as thumbnailOf, We as useActivity, Y as useAdminComments, me as useAdminLocation, D as useAvatar, X as useBannedWords, ve as useBeacons, Z as useCanComment, Qe as useCanonicalContent, B as useCarousel, Q as useCommentBans, $ as useCommentReplies, ee as useComments, qe as useContent, oe as useContentConfig, Le as useContentDetail, ye as useContentFilters, b as useContentGroups, a as useContentKit, o as useContentKitClient, _ as useContentScope, s as useContentURLs, be as useContents, d as useCrop, W as useEditorCrop, f as useEncodeProgress, c as useErrorReporter, xe as useExposure, se as useFavorite, he as useFlowClient, P as useFrameStrip, V as useGalleryView, te as useGlobalCommentBan, x as useGroup, S as useGroupMembers, C as useGroups, l as useGuarded, Se as useHistory, H as useHlsPlayer, ne as useIPBans, n as useInlinePreview, w as useKinds, re as useLatestComments, Ce as useLockedCount, Je as useManagedContents, q as useMediaFolder, E as useMediaRead, ie as useModerationQueue, we as useMyFavorites, T as useMyGroups, Te as useMyReactions, Ge as useMyStats, J as useNearViewport, Ye as useNotificationUnread, Xe as useNotifications, u as useOptionalContentKitClient, v as usePaged, le as usePoll, ue as usePollEditor, de as usePolls, O as usePresets, k as usePublicImage, ce as useReaction, Ve as useReaderPlan, Ee as useRecentSearches, De as useRecommendations, r as useReducedMotion, U as useRefreshBeforeExpiry, Oe as useReleaseDates, ke as useSearch, He as useSegmentPages, Ae as useSimilar, j as useSlotCrop, M as useSlotImage, ge as useStaffAccess, Ke as useTopContents, je as useTypeahead, p as useUpload, m as useUploadQueue, Ue as useVersionDownload, pe as useVersionParam, F as useVideoFrame, I as useVideoImages, L as useVideoPoster, Me as useViewSignal, ae as withReaction, fe as withVote };
+import { useReaderPreferences as Qe } from "./react/reader-preferences.js";
+import { useCanonicalContent as $e } from "./react/canonical.js";
+export { Ze as ContentKitProvider, R as GALLERY_VIEW_KEY, i as GuardContext, e as HOVER_DELAY, t as InlinePreviewContext, z as PLAYER_QUALITY_KEY, h as ResourceStore, _e as beaconsFor, Ne as defaultVersion, Re as downloadMessage, A as editOutput, Pe as editionOf, Fe as findVersion, Ie as liveVersions, y as memberId, G as nameIn, ze as nextRelease, g as resourcesFor, N as round3, Be as startDownload, K as thumbnailOf, We as useActivity, Y as useAdminComments, me as useAdminLocation, D as useAvatar, X as useBannedWords, ve as useBeacons, Z as useCanComment, $e as useCanonicalContent, B as useCarousel, Q as useCommentBans, $ as useCommentReplies, ee as useComments, qe as useContent, oe as useContentConfig, Le as useContentDetail, ye as useContentFilters, b as useContentGroups, a as useContentKit, o as useContentKitClient, _ as useContentScope, s as useContentURLs, be as useContents, d as useCrop, W as useEditorCrop, f as useEncodeProgress, c as useErrorReporter, xe as useExposure, se as useFavorite, he as useFlowClient, P as useFrameStrip, V as useGalleryView, te as useGlobalCommentBan, x as useGroup, S as useGroupMembers, C as useGroups, l as useGuarded, Se as useHistory, H as useHlsPlayer, ne as useIPBans, n as useInlinePreview, w as useKinds, re as useLatestComments, Ce as useLockedCount, Je as useManagedContents, q as useMediaFolder, E as useMediaRead, ie as useModerationQueue, we as useMyFavorites, T as useMyGroups, Te as useMyReactions, Ge as useMyStats, J as useNearViewport, Ye as useNotificationUnread, Xe as useNotifications, u as useOptionalContentKitClient, v as usePaged, le as usePoll, ue as usePollEditor, de as usePolls, O as usePresets, k as usePublicImage, ce as useReaction, Ve as useReaderPlan, Qe as useReaderPreferences, Ee as useRecentSearches, De as useRecommendations, r as useReducedMotion, U as useRefreshBeforeExpiry, Oe as useReleaseDates, ke as useSearch, He as useSegmentPages, Ae as useSimilar, j as useSlotCrop, M as useSlotImage, ge as useStaffAccess, Ke as useTopContents, je as useTypeahead, p as useUpload, m as useUploadQueue, Ue as useVersionDownload, pe as useVersionParam, F as useVideoFrame, I as useVideoImages, L as useVideoPoster, Me as useViewSignal, ae as withReaction, fe as withVote };

package/package.json

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