@openrails/contentkit-ui 0.85.1 → 0.86.0

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

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

package/dist/react/versions.js

@@ -1,6 +1,6 @@
 import { toContentKitError as e } from "../client/errors.js";
-import { useMediaRead as t } from "./read.js";
-import { keyOf as n, useContentScope as r, useResource as i } from "./use-resource.js";
+import { keyOf as t, useContentScope as n, useResource as r } from "./use-resource.js";
+import { useMediaRead as i } from "./read.js";
 import { isPending as a } from "../client/versions.js";
 import { useCallback as o, useEffect as s, useMemo as c, useState as l } from "react";
 //#region src/react/versions.ts
@@ -9,11 +9,11 @@ function d(e, t = Date.now()) {
 	let n = (e?.segments ?? []).flatMap((e) => !e.released && e.release_at ? [Date.parse(e.release_at)] : []).filter((e) => e > t);
 	return n.length ? Math.min(...n) : null;
 }
-function f(e, t, o = {}) {
-	let { client: c, store: l, scope: f } = r(o.client), p = e && t ? n("reader-plan", f, e, t) : null, m = i(l, p, {
+function f(e, i, o = {}) {
+	let { client: c, store: l, scope: f } = n(o.client), p = e && i ? t("reader-plan", f, e, i) : null, m = r(l, p, {
 		type: "reader-plan",
-		id: t ?? void 0
-	}, (n) => c.versions.reader(e, t, n)), h = a(m.data), g = m.data && !h ? m.data : null, { data: _, reload: v } = m;
+		id: i ?? void 0
+	}, (t) => c.versions.reader(e, i, t)), h = a(m.data), g = m.data && !h ? m.data : null, { data: _, reload: v } = m;
 	return s(() => {
 		let e = a(_) ? Date.now() + (o.poll ?? 5e3) : d(_ || null);
 		if (e === null) return;
@@ -31,44 +31,44 @@ function f(e, t, o = {}) {
 		reload: v
 	};
 }
-function p(e, n, r = {}) {
-	let i = e?.item ?? null, a = t(i ?? {
+function p(e, t, n = {}) {
+	let r = e?.item ?? null, a = i(r ?? {
 		kind: "",
 		id: ""
 	}, {
-		window: r.window,
-		read: i ? void 0 : null,
-		client: r.client
+		window: n.window,
+		read: r ? void 0 : null,
+		client: n.client
 	});
 	return {
 		pages: c(() => {
-			let t = new Map((a.read?.files ?? []).flatMap((e) => e.url ? [[e.path, e.url]] : []));
+			let n = new Map((a.read?.files ?? []).flatMap((e) => e.url ? [[e.path, e.url]] : []));
 			return (e?.pages ?? []).map((e) => {
-				let r = e.files[n];
+				let r = e.files[t];
 				return {
 					name: e.name,
 					w: e.w,
 					h: e.h,
-					url: r ? t.get(r) : void 0
+					url: r ? n.get(r) : void 0
 				};
 			});
 		}, [
 			e,
-			n,
+			t,
 			a.read
 		]),
-		loading: !!i && a.loading,
+		loading: !!r && a.loading,
 		error: a.error
 	};
 }
-function m(t, n, i = {}) {
-	let { client: s } = r(i.client), [c, u] = l(!1), [d, f] = l();
+function m(t, r, i = {}) {
+	let { client: s } = n(i.client), [c, u] = l(!1), [d, f] = l();
 	return {
 		download: o(async () => {
 			f(void 0), u(!0);
 			try {
 				for (;;) {
-					let e = await s.versions.download(t, n);
+					let e = await s.versions.download(t, r);
 					if (!a(e)) return e;
 					await new Promise((e) => setTimeout(e, i.poll ?? 3e3));
 				}
@@ -81,7 +81,7 @@ function m(t, n, i = {}) {
 		}, [
 			s,
 			t,
-			n,
+			r,
 			i.poll
 		]),
 		preparing: c,

package/dist/react.js

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