@openrails/contentkit-ui 0.72.0 → 0.74.0

package/dist/react/upload.d.ts

@@ -4,17 +4,17 @@ import { Rotation, Size } from '../client/crop.js';
 import { ContentKitError } from '../client/errors.js';
 import { Crop, Edit, EncodeProgress, FileInfo } from '../client/generated/wire.js';
 import { Progress, PutOptions, UploadedFile, UploadOptions } from '../client/media/client.js';
-import { UploadQueue, QueueOptions, QueueSnapshot } from '../client/media/queue.js';
+import { ItemUploadQueue, QueueOptions, QueueSnapshot } from '../client/media/queue.js';
 export interface UseUploadQueue extends QueueSnapshot {
-    queue: UploadQueue;
-    add: UploadQueue["add"];
-    move: UploadQueue["move"];
-    update: UploadQueue["update"];
-    remove: UploadQueue["remove"];
-    retry: UploadQueue["retry"];
-    start: UploadQueue["start"];
-    pause: UploadQueue["pause"];
-    commit: UploadQueue["commit"];
+    queue: ItemUploadQueue;
+    add: ItemUploadQueue["add"];
+    move: ItemUploadQueue["move"];
+    update: ItemUploadQueue["update"];
+    remove: ItemUploadQueue["remove"];
+    retry: ItemUploadQueue["retry"];
+    start: ItemUploadQueue["start"];
+    pause: ItemUploadQueue["pause"];
+    commit: ItemUploadQueue["commit"];
 }
 export interface UploadQueueOptions extends QueueOptions {
     /** Overrides the provider's client. */

package/dist/react/upload.js

@@ -2,7 +2,7 @@ import { toContentKitError as e } from "../client/errors.js";
 import { ratio as t } from "../client/aspect.js";
 import { centeredCrop as n, constrainCrop as r, editOf as i, rotation as a, sameEdit as o, toOriginal as s } from "../client/crop.js";
 import { encodeRemaining as c } from "../client/media/encode.js";
-import { UploadQueue as l } from "../client/media/queue.js";
+import { ItemUploadQueue as l } from "../client/media/queue.js";
 import { useContentKitClient as u } from "./context.js";
 import { useCallback as d, useEffect as f, useMemo as p, useRef as m, useState as h, useSyncExternalStore as g } from "react";
 //#region src/react/upload.ts

package/dist/react/upload.js.map

@@ -1 +1 @@
-{"version":3,"file":"upload.js","names":[],"sources":["../../src/react/upload.ts"],"sourcesContent":["import { useCallback, useEffect, useMemo, useRef, useState, useSyncExternalStore } from \"react\";\nimport { ratio, type AspectRatio } from \"../client/aspect.js\";\nimport type { ContentKitClient } from \"../client/client.js\";\nimport { centeredCrop, constrainCrop, editOf, rotation, sameEdit, toOriginal, type Rotation, type Size } from \"../client/crop.js\";\nimport { toContentKitError, type ContentKitError } from \"../client/errors.js\";\nimport type { Crop, Edit, EncodeProgress, FileInfo } from \"../client/generated/wire.js\";\nimport type { Progress, PutOptions, UploadedFile, UploadOptions } from \"../client/media/client.js\";\nimport { encodeRemaining } from \"../client/media/encode.js\";\nimport { UploadQueue, type QueueOptions, type QueueSnapshot } from \"../client/media/queue.js\";\nimport { useContentKitClient } from \"./context.js\";\n\nexport interface UseUploadQueue extends QueueSnapshot {\n  queue: UploadQueue;\n  add: UploadQueue[\"add\"];\n  move: UploadQueue[\"move\"];\n  update: UploadQueue[\"update\"];\n  remove: UploadQueue[\"remove\"];\n  retry: UploadQueue[\"retry\"];\n  start: UploadQueue[\"start\"];\n  pause: UploadQueue[\"pause\"];\n  commit: UploadQueue[\"commit\"];\n}\n\nexport interface UploadQueueOptions extends QueueOptions {\n  /** Overrides the provider's client. */\n  client?: ContentKitClient;\n}\n\n/**\n * A file queue for one item: another ref gets a fresh queue and the previous\n * one pauses (the other options are read once per queue). Unmounting pauses\n * running uploads.\n */\nexport function useUploadQueue({ client: own, ...options }: UploadQueueOptions): UseUploadQueue {\n  const client = useContentKitClient(own);\n  const key = `${options.ref.kind}/${options.ref.id}`;\n  const open = () => ({ key, queue: new UploadQueue(client.media, { ...options, autoStart: false }) });\n  const [current, setCurrent] = useState(open);\n  if (current.key !== key) setCurrent(open());\n  const { queue } = current;\n  const autoStart = options.autoStart ?? true;\n  useEffect(() => {\n    if (autoStart) queue.start();\n    return () => queue.pause();\n  }, [queue, autoStart]);\n  const snap = useSyncExternalStore(queue.subscribe, queue.getSnapshot, queue.getSnapshot);\n  return {\n    ...snap,\n    queue,\n    add: queue.add.bind(queue),\n    move: queue.move.bind(queue),\n    update: queue.update.bind(queue),\n    remove: queue.remove.bind(queue),\n    retry: queue.retry.bind(queue),\n    start: queue.start.bind(queue),\n    pause: queue.pause.bind(queue),\n    commit: queue.commit.bind(queue),\n  };\n}\n\nexport interface UploadStatus {\n  status: \"idle\" | \"uploading\" | \"done\" | \"error\";\n  progress?: Progress;\n  error?: ContentKitError;\n  result?: UploadedFile & { file?: FileInfo };\n}\n\nexport interface UseUpload extends UploadStatus {\n  /**\n   * Uploads one file; with put it also commits it to its path (put's edit,\n   * meta and index) and waits until it is processed (result.file).\n   */\n  upload: (file: File, opts: Omit<UploadOptions, \"signal\" | \"onProgress\"> & { put?: PutOptions }) => Promise<UploadedFile & { file?: FileInfo }>;\n  cancel: () => void;\n}\n\n/** One upload at a time (a cover, an inline image); a new upload cancels the previous. */\nexport function useUpload({ client: own }: { client?: ContentKitClient } = {}): UseUpload {\n  const { media } = useContentKitClient(own);\n  const [s, set] = useState<UploadStatus>({ status: \"idle\" });\n  const ctl = useRef<AbortController | null>(null);\n  useEffect(() => () => ctl.current?.abort(), []);\n\n  const upload = useCallback<UseUpload[\"upload\"]>(\n    async (file, { put, ...opts }) => {\n      ctl.current?.abort();\n      const c = (ctl.current = new AbortController());\n      set({ status: \"uploading\" });\n      const o: UploadOptions = {\n        ...opts,\n        signal: c.signal,\n        onProgress: (progress) => c === ctl.current && set({ status: \"uploading\", progress }),\n      };\n      try {\n        let result: UploadedFile & { file?: FileInfo };\n        if (put) {\n          let up: UploadedFile | undefined;\n          const f = await media.put(file, { ...o, ...put, onUploaded: (u) => (up = u) });\n          result = { ...up!, file: f };\n        } else result = await media.upload(file, o);\n        if (c === ctl.current) set((prev) => ({ status: \"done\", progress: prev.progress, result }));\n        return result;\n      } catch (e) {\n        const error = toContentKitError(e);\n        if (c === ctl.current) set(error.code === \"aborted\" ? { status: \"idle\" } : { status: \"error\", error });\n        throw error;\n      }\n    },\n    [media],\n  );\n  const cancel = useCallback(() => ctl.current?.abort(), []);\n  return { ...s, upload, cancel };\n}\n\nexport interface UseCropOptions {\n  /** The upload's size (an editor read's w and h). */\n  source: Size;\n  /** The edited image's \"W:H\", e.g. the public preset's aspect; \"\" or omitted is free. */\n  aspect?: AspectRatio;\n  /** The current edit to start from. */\n  initial?: Edit | null;\n}\n\nexport interface UseCrop {\n  /** In original pixels, inside the source and at the aspect. */\n  crop: Crop;\n  rotate: Rotation;\n  /** Ready for an edit or put op; null when nothing changes. Its identity changes only with its value. */\n  edit: Edit | null;\n  /** A rect in original pixels. */\n  setCrop: (rect: Crop) => void;\n  /** A rect on the image as displayed (after the rotation) at display size: a cropper's output. */\n  setFromDisplay: (rect: Crop, display: Size) => void;\n  /** Turns clockwise by deg (a multiple of 90); the crop keeps the aspect. */\n  rotateBy: (deg: number) => void;\n  reset: () => void;\n}\n\n/** Headless crop state for any cropper UI: a rect in original pixels, a rotation and the resulting edit. */\nexport function useCrop({ source: given, aspect: shape, initial }: UseCropOptions): UseCrop {\n  const aspect = ratio(shape);\n  const { width, height } = given;\n  const source = useMemo(() => ({ width, height }), [width, height]);\n  const start = (): [Crop, Rotation] => {\n    const rotate = rotation(initial?.rotate ?? 0);\n    const c = initial?.crop;\n    return [c ? constrainCrop(c, source, aspect, rotate) : centeredCrop(source, aspect, rotate), rotate];\n  };\n  const [state, setState] = useState(start);\n  const [crop, rotate] = state;\n  const set = useCallback(\n    (next: [Crop, Rotation] | ((s: [Crop, Rotation]) => [Crop, Rotation])) =>\n      setState((s) => {\n        const n = typeof next === \"function\" ? next(s) : next;\n        return sameEdit({ crop: n[0], rotate: n[1] }, { crop: s[0], rotate: s[1] }) ? s : n;\n      }),\n    [],\n  );\n  const setCrop = useCallback((r: Crop) => set(([, rot]) => [constrainCrop(r, source, aspect, rot), rot]), [set, source, aspect]);\n  const setFromDisplay = useCallback(\n    (r: Crop, display: Size) => set(([, rot]) => [constrainCrop(toOriginal(r, display, source, rot), source, aspect, rot), rot]),\n    [set, source, aspect],\n  );\n  const rotateBy = useCallback(\n    (deg: number) =>\n      set(([c, rot]) => {\n        const next = rotation(rot + deg);\n        return [constrainCrop(c, source, aspect, next), next];\n      }),\n    [set, source, aspect],\n  );\n  const reset = useCallback(() => set([centeredCrop(source, aspect), 0]), [set, source, aspect]);\n  const last = useRef<Edit | null>(null);\n  const edit = useMemo(() => {\n    const e = editOf(crop, source, rotate);\n    return sameEdit(e, last.current) ? last.current : (last.current = e);\n  }, [crop, source, rotate]);\n  return { crop, rotate, edit, setCrop, setFromDisplay, rotateBy, reset };\n}\n\nexport interface UseEncodeProgress {\n  progress?: EncodeProgress;\n  /** Seconds left, counting down each second between reports; undefined while unknown. */\n  remaining?: number;\n}\n\n/**\n * A pending video file's encode progress from the read API (`files[i].progress`),\n * with the ETA counted down locally between polls.\n */\nexport function useEncodeProgress(progress?: EncodeProgress | null): UseEncodeProgress {\n  const [base, setBase] = useState(() => ({ at: progress?.at, received: Date.now() }));\n  if (progress?.at !== base.at) setBase({ at: progress?.at, received: Date.now() });\n  const [now, setNow] = useState(() => Date.now());\n  const ticking = !!progress?.eta && !progress.stalled;\n  useEffect(() => {\n    if (!ticking) return;\n    setNow(Date.now());\n    const id = setInterval(() => setNow(Date.now()), 1000);\n    return () => clearInterval(id);\n  }, [ticking, base]);\n  return { progress: progress ?? undefined, remaining: encodeRemaining(progress, base.received, Math.max(now, base.received)) };\n}\n"],"mappings":"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"}
+{"version":3,"file":"upload.js","names":[],"sources":["../../src/react/upload.ts"],"sourcesContent":["import { useCallback, useEffect, useMemo, useRef, useState, useSyncExternalStore } from \"react\";\nimport { ratio, type AspectRatio } from \"../client/aspect.js\";\nimport type { ContentKitClient } from \"../client/client.js\";\nimport { centeredCrop, constrainCrop, editOf, rotation, sameEdit, toOriginal, type Rotation, type Size } from \"../client/crop.js\";\nimport { toContentKitError, type ContentKitError } from \"../client/errors.js\";\nimport type { Crop, Edit, EncodeProgress, FileInfo } from \"../client/generated/wire.js\";\nimport type { Progress, PutOptions, UploadedFile, UploadOptions } from \"../client/media/client.js\";\nimport { encodeRemaining } from \"../client/media/encode.js\";\nimport { ItemUploadQueue, type QueueOptions, type QueueSnapshot } from \"../client/media/queue.js\";\nimport { useContentKitClient } from \"./context.js\";\n\nexport interface UseUploadQueue extends QueueSnapshot {\n  queue: ItemUploadQueue;\n  add: ItemUploadQueue[\"add\"];\n  move: ItemUploadQueue[\"move\"];\n  update: ItemUploadQueue[\"update\"];\n  remove: ItemUploadQueue[\"remove\"];\n  retry: ItemUploadQueue[\"retry\"];\n  start: ItemUploadQueue[\"start\"];\n  pause: ItemUploadQueue[\"pause\"];\n  commit: ItemUploadQueue[\"commit\"];\n}\n\nexport interface UploadQueueOptions extends QueueOptions {\n  /** Overrides the provider's client. */\n  client?: ContentKitClient;\n}\n\n/**\n * A file queue for one item: another ref gets a fresh queue and the previous\n * one pauses (the other options are read once per queue). Unmounting pauses\n * running uploads.\n */\nexport function useUploadQueue({ client: own, ...options }: UploadQueueOptions): UseUploadQueue {\n  const client = useContentKitClient(own);\n  const key = `${options.ref.kind}/${options.ref.id}`;\n  const open = () => ({ key, queue: new ItemUploadQueue(client.media, { ...options, autoStart: false }) });\n  const [current, setCurrent] = useState(open);\n  if (current.key !== key) setCurrent(open());\n  const { queue } = current;\n  const autoStart = options.autoStart ?? true;\n  useEffect(() => {\n    if (autoStart) queue.start();\n    return () => queue.pause();\n  }, [queue, autoStart]);\n  const snap = useSyncExternalStore(queue.subscribe, queue.getSnapshot, queue.getSnapshot);\n  return {\n    ...snap,\n    queue,\n    add: queue.add.bind(queue),\n    move: queue.move.bind(queue),\n    update: queue.update.bind(queue),\n    remove: queue.remove.bind(queue),\n    retry: queue.retry.bind(queue),\n    start: queue.start.bind(queue),\n    pause: queue.pause.bind(queue),\n    commit: queue.commit.bind(queue),\n  };\n}\n\nexport interface UploadStatus {\n  status: \"idle\" | \"uploading\" | \"done\" | \"error\";\n  progress?: Progress;\n  error?: ContentKitError;\n  result?: UploadedFile & { file?: FileInfo };\n}\n\nexport interface UseUpload extends UploadStatus {\n  /**\n   * Uploads one file; with put it also commits it to its path (put's edit,\n   * meta and index) and waits until it is processed (result.file).\n   */\n  upload: (file: File, opts: Omit<UploadOptions, \"signal\" | \"onProgress\"> & { put?: PutOptions }) => Promise<UploadedFile & { file?: FileInfo }>;\n  cancel: () => void;\n}\n\n/** One upload at a time (a cover, an inline image); a new upload cancels the previous. */\nexport function useUpload({ client: own }: { client?: ContentKitClient } = {}): UseUpload {\n  const { media } = useContentKitClient(own);\n  const [s, set] = useState<UploadStatus>({ status: \"idle\" });\n  const ctl = useRef<AbortController | null>(null);\n  useEffect(() => () => ctl.current?.abort(), []);\n\n  const upload = useCallback<UseUpload[\"upload\"]>(\n    async (file, { put, ...opts }) => {\n      ctl.current?.abort();\n      const c = (ctl.current = new AbortController());\n      set({ status: \"uploading\" });\n      const o: UploadOptions = {\n        ...opts,\n        signal: c.signal,\n        onProgress: (progress) => c === ctl.current && set({ status: \"uploading\", progress }),\n      };\n      try {\n        let result: UploadedFile & { file?: FileInfo };\n        if (put) {\n          let up: UploadedFile | undefined;\n          const f = await media.put(file, { ...o, ...put, onUploaded: (u) => (up = u) });\n          result = { ...up!, file: f };\n        } else result = await media.upload(file, o);\n        if (c === ctl.current) set((prev) => ({ status: \"done\", progress: prev.progress, result }));\n        return result;\n      } catch (e) {\n        const error = toContentKitError(e);\n        if (c === ctl.current) set(error.code === \"aborted\" ? { status: \"idle\" } : { status: \"error\", error });\n        throw error;\n      }\n    },\n    [media],\n  );\n  const cancel = useCallback(() => ctl.current?.abort(), []);\n  return { ...s, upload, cancel };\n}\n\nexport interface UseCropOptions {\n  /** The upload's size (an editor read's w and h). */\n  source: Size;\n  /** The edited image's \"W:H\", e.g. the public preset's aspect; \"\" or omitted is free. */\n  aspect?: AspectRatio;\n  /** The current edit to start from. */\n  initial?: Edit | null;\n}\n\nexport interface UseCrop {\n  /** In original pixels, inside the source and at the aspect. */\n  crop: Crop;\n  rotate: Rotation;\n  /** Ready for an edit or put op; null when nothing changes. Its identity changes only with its value. */\n  edit: Edit | null;\n  /** A rect in original pixels. */\n  setCrop: (rect: Crop) => void;\n  /** A rect on the image as displayed (after the rotation) at display size: a cropper's output. */\n  setFromDisplay: (rect: Crop, display: Size) => void;\n  /** Turns clockwise by deg (a multiple of 90); the crop keeps the aspect. */\n  rotateBy: (deg: number) => void;\n  reset: () => void;\n}\n\n/** Headless crop state for any cropper UI: a rect in original pixels, a rotation and the resulting edit. */\nexport function useCrop({ source: given, aspect: shape, initial }: UseCropOptions): UseCrop {\n  const aspect = ratio(shape);\n  const { width, height } = given;\n  const source = useMemo(() => ({ width, height }), [width, height]);\n  const start = (): [Crop, Rotation] => {\n    const rotate = rotation(initial?.rotate ?? 0);\n    const c = initial?.crop;\n    return [c ? constrainCrop(c, source, aspect, rotate) : centeredCrop(source, aspect, rotate), rotate];\n  };\n  const [state, setState] = useState(start);\n  const [crop, rotate] = state;\n  const set = useCallback(\n    (next: [Crop, Rotation] | ((s: [Crop, Rotation]) => [Crop, Rotation])) =>\n      setState((s) => {\n        const n = typeof next === \"function\" ? next(s) : next;\n        return sameEdit({ crop: n[0], rotate: n[1] }, { crop: s[0], rotate: s[1] }) ? s : n;\n      }),\n    [],\n  );\n  const setCrop = useCallback((r: Crop) => set(([, rot]) => [constrainCrop(r, source, aspect, rot), rot]), [set, source, aspect]);\n  const setFromDisplay = useCallback(\n    (r: Crop, display: Size) => set(([, rot]) => [constrainCrop(toOriginal(r, display, source, rot), source, aspect, rot), rot]),\n    [set, source, aspect],\n  );\n  const rotateBy = useCallback(\n    (deg: number) =>\n      set(([c, rot]) => {\n        const next = rotation(rot + deg);\n        return [constrainCrop(c, source, aspect, next), next];\n      }),\n    [set, source, aspect],\n  );\n  const reset = useCallback(() => set([centeredCrop(source, aspect), 0]), [set, source, aspect]);\n  const last = useRef<Edit | null>(null);\n  const edit = useMemo(() => {\n    const e = editOf(crop, source, rotate);\n    return sameEdit(e, last.current) ? last.current : (last.current = e);\n  }, [crop, source, rotate]);\n  return { crop, rotate, edit, setCrop, setFromDisplay, rotateBy, reset };\n}\n\nexport interface UseEncodeProgress {\n  progress?: EncodeProgress;\n  /** Seconds left, counting down each second between reports; undefined while unknown. */\n  remaining?: number;\n}\n\n/**\n * A pending video file's encode progress from the read API (`files[i].progress`),\n * with the ETA counted down locally between polls.\n */\nexport function useEncodeProgress(progress?: EncodeProgress | null): UseEncodeProgress {\n  const [base, setBase] = useState(() => ({ at: progress?.at, received: Date.now() }));\n  if (progress?.at !== base.at) setBase({ at: progress?.at, received: Date.now() });\n  const [now, setNow] = useState(() => Date.now());\n  const ticking = !!progress?.eta && !progress.stalled;\n  useEffect(() => {\n    if (!ticking) return;\n    setNow(Date.now());\n    const id = setInterval(() => setNow(Date.now()), 1000);\n    return () => clearInterval(id);\n  }, [ticking, base]);\n  return { progress: progress ?? undefined, remaining: encodeRemaining(progress, base.received, Math.max(now, base.received)) };\n}\n"],"mappings":"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"}

package/dist/react.js

@@ -17,6 +17,7 @@ import { useFavorite as Z, useReaction as Q } from "./react/engagement.js";
 import { usePoll as $, usePollEditor as ee, usePolls as te, withVote as ne } from "./react/polls.js";
 import { useAdminLocation as re, useFlowClient as ie, useStaffAccess as ae } from "./react/admin.js";
 import { isPublished as oe, usePost as se, usePosts as ce } from "./react/posts.js";
-import { ContentKitProvider as le } from "./react/provider.js";
-import { useCanonicalContent as ue } from "./react/canonical.js";
-export { le 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, v as editOutput, oe as isPublished, N as nameIn, R as resourcesFor, x as round3, P as thumbnailOf, V as useAdminComments, re as useAdminLocation, H as useCanComment, ue as useCanonicalContent, O as useCarousel, U as useCommentBans, W as useCommentReplies, G as useComments, X as useContentConfig, a as useContentKit, o as useContentKitClient, z as useContentScope, s as useContentURLs, d as useCrop, M as useEditorCrop, f as useEncodeProgress, c as useErrorReporter, Z as useFavorite, ie as useFlowClient, S as useFrameStrip, k as useGalleryView, K as useGlobalCommentBan, l as useGuarded, A as useHlsPlayer, n as useInlinePreview, q as useLatestComments, F as useMediaFolder, h as useMediaRead, J as useModerationQueue, I as useNearViewport, u as useOptionalContentKitClient, B as usePaged, $ as usePoll, ee as usePollEditor, te as usePolls, se as usePost, ce as usePosts, g as usePresets, _ as usePublicImage, Q as useReaction, r as useReducedMotion, j as useRefreshBeforeExpiry, y as useSlotCrop, b as useSlotImage, ae as useStaffAccess, p as useUpload, m as useUploadQueue, C as useVideoFrame, w as useVideoImages, T as useVideoPoster, Y as withReaction, ne as withVote };
+import { useNotificationUnread as le, useNotifications as ue } from "./react/notifications.js";
+import { ContentKitProvider as de } from "./react/provider.js";
+import { useCanonicalContent as fe } from "./react/canonical.js";
+export { de 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, v as editOutput, oe as isPublished, N as nameIn, R as resourcesFor, x as round3, P as thumbnailOf, V as useAdminComments, re as useAdminLocation, H as useCanComment, fe as useCanonicalContent, O as useCarousel, U as useCommentBans, W as useCommentReplies, G as useComments, X as useContentConfig, a as useContentKit, o as useContentKitClient, z as useContentScope, s as useContentURLs, d as useCrop, M as useEditorCrop, f as useEncodeProgress, c as useErrorReporter, Z as useFavorite, ie as useFlowClient, S as useFrameStrip, k as useGalleryView, K as useGlobalCommentBan, l as useGuarded, A as useHlsPlayer, n as useInlinePreview, q as useLatestComments, F as useMediaFolder, h as useMediaRead, J as useModerationQueue, I as useNearViewport, le as useNotificationUnread, ue as useNotifications, u as useOptionalContentKitClient, B as usePaged, $ as usePoll, ee as usePollEditor, te as usePolls, se as usePost, ce as usePosts, g as usePresets, _ as usePublicImage, Q as useReaction, r as useReducedMotion, j as useRefreshBeforeExpiry, y as useSlotCrop, b as useSlotImage, ae as useStaffAccess, p as useUpload, m as useUploadQueue, C as useVideoFrame, w as useVideoImages, T as useVideoPoster, Y as withReaction, ne as withVote };