@rockhall/electron-offline-content 0.4.0

package/dist/preload/index.cjs

@@ -0,0 +1,36 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_shared_ipc = require("../shared/ipc.cjs");
+let electron = require("electron");
+//#region src/preload/index.ts
+/**
+* Builds a {@link import("../shared/types.js").MediaCacheBridge} that invokes main-process handlers via `ipcRenderer`.
+*/
+function createMediaCacheBridge() {
+	return {
+		getStatus: () => electron.ipcRenderer.invoke(require_shared_ipc.MEDIA_CACHE_IPC.getStatus),
+		syncNow: () => electron.ipcRenderer.invoke(require_shared_ipc.MEDIA_CACHE_IPC.syncNow),
+		getAsset: (key) => electron.ipcRenderer.invoke(require_shared_ipc.MEDIA_CACHE_IPC.getAsset, key),
+		listByIndex: (indexName, value, pagination) => electron.ipcRenderer.invoke(require_shared_ipc.MEDIA_CACHE_IPC.listByIndex, indexName, value, pagination),
+		findByFileStem: (stem, pagination) => electron.ipcRenderer.invoke(require_shared_ipc.MEDIA_CACHE_IPC.findByFileStem, stem, pagination),
+		subscribeStatus: (listener) => {
+			const wrapped = (_event, status) => listener(status);
+			electron.ipcRenderer.on(require_shared_ipc.MEDIA_CACHE_IPC.statusChanged, wrapped);
+			return () => {
+				electron.ipcRenderer.removeListener(require_shared_ipc.MEDIA_CACHE_IPC.statusChanged, wrapped);
+			};
+		}
+	};
+}
+/**
+* Exposes the bridge on the renderer's `window` under `options.key` (default `mediaCache`) using `contextBridge.exposeInMainWorld`.
+*/
+function exposeMediaCacheBridge(options) {
+	const bridge = createMediaCacheBridge();
+	electron.contextBridge.exposeInMainWorld(options?.key ?? "mediaCache", bridge);
+	return bridge;
+}
+//#endregion
+exports.createMediaCacheBridge = createMediaCacheBridge;
+exports.exposeMediaCacheBridge = exposeMediaCacheBridge;
+
+//# sourceMappingURL=index.cjs.map

package/dist/preload/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","names":["ipcRenderer","MEDIA_CACHE_IPC"],"sources":["../../src/preload/index.ts"],"sourcesContent":["import { contextBridge, ipcRenderer } from \"electron\";\nimport { MEDIA_CACHE_IPC } from \"../shared/ipc.js\";\nimport type { MediaCacheBridge, PaginationInput, PreloadExposeOptions } from \"../shared/types.js\";\n\n/**\n * Builds a {@link import(\"../shared/types.js\").MediaCacheBridge} that invokes main-process handlers via `ipcRenderer`.\n */\nexport function createMediaCacheBridge(): MediaCacheBridge {\n  return {\n    getStatus: () => ipcRenderer.invoke(MEDIA_CACHE_IPC.getStatus),\n    syncNow: () => ipcRenderer.invoke(MEDIA_CACHE_IPC.syncNow),\n    getAsset: (key) => ipcRenderer.invoke(MEDIA_CACHE_IPC.getAsset, key),\n    listByIndex: (indexName, value, pagination?: PaginationInput) =>\n      ipcRenderer.invoke(MEDIA_CACHE_IPC.listByIndex, indexName, value, pagination),\n    findByFileStem: (stem, pagination?: PaginationInput) =>\n      ipcRenderer.invoke(MEDIA_CACHE_IPC.findByFileStem, stem, pagination),\n    subscribeStatus: (listener) => {\n      const wrapped = (\n        _event: Electron.IpcRendererEvent,\n        status: Awaited<ReturnType<MediaCacheBridge[\"getStatus\"]>>,\n      ) => listener(status);\n      ipcRenderer.on(MEDIA_CACHE_IPC.statusChanged, wrapped);\n      return () => {\n        ipcRenderer.removeListener(MEDIA_CACHE_IPC.statusChanged, wrapped);\n      };\n    },\n  };\n}\n\n/**\n * Exposes the bridge on the renderer's `window` under `options.key` (default `mediaCache`) using `contextBridge.exposeInMainWorld`.\n */\nexport function exposeMediaCacheBridge(options?: PreloadExposeOptions): MediaCacheBridge {\n  const bridge = createMediaCacheBridge();\n  contextBridge.exposeInMainWorld(options?.key ?? \"mediaCache\", bridge);\n  return bridge;\n}\n\nexport type { MediaCacheBridge } from \"../shared/types.js\";\n"],"mappings":";;;;;;;AAOA,SAAgB,yBAA2C;CACzD,OAAO;EACL,iBAAiBA,SAAAA,YAAY,OAAOC,mBAAAA,gBAAgB,UAAU;EAC9D,eAAeD,SAAAA,YAAY,OAAOC,mBAAAA,gBAAgB,QAAQ;EAC1D,WAAW,QAAQD,SAAAA,YAAY,OAAOC,mBAAAA,gBAAgB,UAAU,IAAI;EACpE,cAAc,WAAW,OAAO,eAC9BD,SAAAA,YAAY,OAAOC,mBAAAA,gBAAgB,aAAa,WAAW,OAAO,WAAW;EAC/E,iBAAiB,MAAM,eACrBD,SAAAA,YAAY,OAAOC,mBAAAA,gBAAgB,gBAAgB,MAAM,WAAW;EACtE,kBAAkB,aAAa;GAC7B,MAAM,WACJ,QACA,WACG,SAAS,OAAO;GACrB,SAAA,YAAY,GAAGA,mBAAAA,gBAAgB,eAAe,QAAQ;GACtD,aAAa;IACX,SAAA,YAAY,eAAeA,mBAAAA,gBAAgB,eAAe,QAAQ;;;EAGvE;;;;;AAMH,SAAgB,uBAAuB,SAAkD;CACvF,MAAM,SAAS,wBAAwB;CACvC,SAAA,cAAc,kBAAkB,SAAS,OAAO,cAAc,OAAO;CACrE,OAAO"}

package/dist/preload/index.d.cts

@@ -0,0 +1,14 @@
+import { MediaCacheBridge, PreloadExposeOptions } from "../shared/types.cjs";
+
+//#region src/preload/index.d.ts
+/**
+ * Builds a {@link import("../shared/types.js").MediaCacheBridge} that invokes main-process handlers via `ipcRenderer`.
+ */
+declare function createMediaCacheBridge(): MediaCacheBridge;
+/**
+ * Exposes the bridge on the renderer's `window` under `options.key` (default `mediaCache`) using `contextBridge.exposeInMainWorld`.
+ */
+declare function exposeMediaCacheBridge(options?: PreloadExposeOptions): MediaCacheBridge;
+//#endregion
+export { type MediaCacheBridge, createMediaCacheBridge, exposeMediaCacheBridge };
+//# sourceMappingURL=index.d.cts.map

package/dist/preload/index.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.cts","names":[],"sources":["../../src/preload/index.ts"],"mappings":";;;;;AAOA;iBAAgB,sBAAA,CAAA,GAA0B,gBAAA;;;;iBAyB1B,sBAAA,CAAuB,OAAA,GAAU,oBAAA,GAAuB,gBAAA"}

package/dist/preload/index.d.ts

@@ -0,0 +1,14 @@
+import { MediaCacheBridge, PreloadExposeOptions } from "../shared/types.js";
+
+//#region src/preload/index.d.ts
+/**
+ * Builds a {@link import("../shared/types.js").MediaCacheBridge} that invokes main-process handlers via `ipcRenderer`.
+ */
+declare function createMediaCacheBridge(): MediaCacheBridge;
+/**
+ * Exposes the bridge on the renderer's `window` under `options.key` (default `mediaCache`) using `contextBridge.exposeInMainWorld`.
+ */
+declare function exposeMediaCacheBridge(options?: PreloadExposeOptions): MediaCacheBridge;
+//#endregion
+export { type MediaCacheBridge, createMediaCacheBridge, exposeMediaCacheBridge };
+//# sourceMappingURL=index.d.ts.map

package/dist/preload/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","names":[],"sources":["../../src/preload/index.ts"],"mappings":";;;;;AAOA;iBAAgB,sBAAA,CAAA,GAA0B,gBAAA;;;;iBAyB1B,sBAAA,CAAuB,OAAA,GAAU,oBAAA,GAAuB,gBAAA"}

package/dist/preload/index.js

@@ -0,0 +1,34 @@
+import { MEDIA_CACHE_IPC } from "../shared/ipc.js";
+import { contextBridge, ipcRenderer } from "electron";
+//#region src/preload/index.ts
+/**
+* Builds a {@link import("../shared/types.js").MediaCacheBridge} that invokes main-process handlers via `ipcRenderer`.
+*/
+function createMediaCacheBridge() {
+	return {
+		getStatus: () => ipcRenderer.invoke(MEDIA_CACHE_IPC.getStatus),
+		syncNow: () => ipcRenderer.invoke(MEDIA_CACHE_IPC.syncNow),
+		getAsset: (key) => ipcRenderer.invoke(MEDIA_CACHE_IPC.getAsset, key),
+		listByIndex: (indexName, value, pagination) => ipcRenderer.invoke(MEDIA_CACHE_IPC.listByIndex, indexName, value, pagination),
+		findByFileStem: (stem, pagination) => ipcRenderer.invoke(MEDIA_CACHE_IPC.findByFileStem, stem, pagination),
+		subscribeStatus: (listener) => {
+			const wrapped = (_event, status) => listener(status);
+			ipcRenderer.on(MEDIA_CACHE_IPC.statusChanged, wrapped);
+			return () => {
+				ipcRenderer.removeListener(MEDIA_CACHE_IPC.statusChanged, wrapped);
+			};
+		}
+	};
+}
+/**
+* Exposes the bridge on the renderer's `window` under `options.key` (default `mediaCache`) using `contextBridge.exposeInMainWorld`.
+*/
+function exposeMediaCacheBridge(options) {
+	const bridge = createMediaCacheBridge();
+	contextBridge.exposeInMainWorld(options?.key ?? "mediaCache", bridge);
+	return bridge;
+}
+//#endregion
+export { createMediaCacheBridge, exposeMediaCacheBridge };
+
+//# sourceMappingURL=index.js.map

package/dist/preload/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../../src/preload/index.ts"],"sourcesContent":["import { contextBridge, ipcRenderer } from \"electron\";\nimport { MEDIA_CACHE_IPC } from \"../shared/ipc.js\";\nimport type { MediaCacheBridge, PaginationInput, PreloadExposeOptions } from \"../shared/types.js\";\n\n/**\n * Builds a {@link import(\"../shared/types.js\").MediaCacheBridge} that invokes main-process handlers via `ipcRenderer`.\n */\nexport function createMediaCacheBridge(): MediaCacheBridge {\n  return {\n    getStatus: () => ipcRenderer.invoke(MEDIA_CACHE_IPC.getStatus),\n    syncNow: () => ipcRenderer.invoke(MEDIA_CACHE_IPC.syncNow),\n    getAsset: (key) => ipcRenderer.invoke(MEDIA_CACHE_IPC.getAsset, key),\n    listByIndex: (indexName, value, pagination?: PaginationInput) =>\n      ipcRenderer.invoke(MEDIA_CACHE_IPC.listByIndex, indexName, value, pagination),\n    findByFileStem: (stem, pagination?: PaginationInput) =>\n      ipcRenderer.invoke(MEDIA_CACHE_IPC.findByFileStem, stem, pagination),\n    subscribeStatus: (listener) => {\n      const wrapped = (\n        _event: Electron.IpcRendererEvent,\n        status: Awaited<ReturnType<MediaCacheBridge[\"getStatus\"]>>,\n      ) => listener(status);\n      ipcRenderer.on(MEDIA_CACHE_IPC.statusChanged, wrapped);\n      return () => {\n        ipcRenderer.removeListener(MEDIA_CACHE_IPC.statusChanged, wrapped);\n      };\n    },\n  };\n}\n\n/**\n * Exposes the bridge on the renderer's `window` under `options.key` (default `mediaCache`) using `contextBridge.exposeInMainWorld`.\n */\nexport function exposeMediaCacheBridge(options?: PreloadExposeOptions): MediaCacheBridge {\n  const bridge = createMediaCacheBridge();\n  contextBridge.exposeInMainWorld(options?.key ?? \"mediaCache\", bridge);\n  return bridge;\n}\n\nexport type { MediaCacheBridge } from \"../shared/types.js\";\n"],"mappings":";;;;;;AAOA,SAAgB,yBAA2C;CACzD,OAAO;EACL,iBAAiB,YAAY,OAAO,gBAAgB,UAAU;EAC9D,eAAe,YAAY,OAAO,gBAAgB,QAAQ;EAC1D,WAAW,QAAQ,YAAY,OAAO,gBAAgB,UAAU,IAAI;EACpE,cAAc,WAAW,OAAO,eAC9B,YAAY,OAAO,gBAAgB,aAAa,WAAW,OAAO,WAAW;EAC/E,iBAAiB,MAAM,eACrB,YAAY,OAAO,gBAAgB,gBAAgB,MAAM,WAAW;EACtE,kBAAkB,aAAa;GAC7B,MAAM,WACJ,QACA,WACG,SAAS,OAAO;GACrB,YAAY,GAAG,gBAAgB,eAAe,QAAQ;GACtD,aAAa;IACX,YAAY,eAAe,gBAAgB,eAAe,QAAQ;;;EAGvE;;;;;AAMH,SAAgB,uBAAuB,SAAkD;CACvF,MAAM,SAAS,wBAAwB;CACvC,cAAc,kBAAkB,SAAS,OAAO,cAAc,OAAO;CACrE,OAAO"}

package/dist/react/index.cjs

@@ -0,0 +1,199 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_runtime = require("../renderer/runtime.cjs");
+const require_helpers = require("../renderer/helpers.cjs");
+let react = require("react");
+let react_jsx_runtime = require("react/jsx-runtime");
+//#region src/react/index.tsx
+const MediaCacheContext = (0, react.createContext)(null);
+let nextQueryErrorId = 0;
+function MediaCacheProvider({ bridge, children }) {
+	const valueBridge = (0, react.useMemo)(() => bridge ?? window.mediaCache ?? null, [bridge]);
+	const statusController = (0, react.useMemo)(() => require_runtime.createMediaCacheStatusController(valueBridge, valueBridge !== null), [valueBridge]);
+	(0, react.useEffect)(() => () => statusController.dispose(), [statusController]);
+	const [queryErrorsById, setQueryErrorsById] = (0, react.useState)(() => /* @__PURE__ */ new Map());
+	const reportQueryError = (0, react.useCallback)((id, error) => {
+		setQueryErrorsById((previous) => {
+			if (error === null) {
+				if (!previous.has(id)) return previous;
+				const next = new Map(previous);
+				next.delete(id);
+				return next;
+			}
+			if (previous.get(id) === error) return previous;
+			const next = new Map(previous);
+			next.set(id, error);
+			return next;
+		});
+	}, []);
+	const queryErrors = (0, react.useMemo)(() => Array.from(queryErrorsById.values()), [queryErrorsById]);
+	const value = (0, react.useMemo)(() => ({
+		bridge: valueBridge,
+		statusController,
+		queryErrors,
+		reportQueryError
+	}), [
+		valueBridge,
+		statusController,
+		queryErrors,
+		reportQueryError
+	]);
+	return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(MediaCacheContext.Provider, {
+		value,
+		children
+	});
+}
+function useMediaBridge() {
+	const { bridge, status, queryErrors } = useMediaCacheRuntime();
+	const errors = (0, react.useMemo)(() => require_helpers.aggregateMediaCacheErrors(status, queryErrors), [status, queryErrors]);
+	return (0, react.useMemo)(() => ({
+		...bridge,
+		status,
+		phase: require_runtime.deriveMediaCachePhase(status),
+		errors
+	}), [
+		bridge,
+		status,
+		errors
+	]);
+}
+function useMediaCacheStatus() {
+	const status = useMediaCacheRuntime().status;
+	return (0, react.useMemo)(() => ({
+		...status,
+		phase: require_runtime.deriveMediaCachePhase(status)
+	}), [status]);
+}
+/**
+* Fetches a single asset by key.
+*
+* @param key - The asset key to look up. A string or array of string segments.
+* @param options - Optional sync-triggered refetch behavior.
+*/
+function useMediaAsset(key, options) {
+	const { bridge, statusController } = useMediaCacheRuntime();
+	return useAsyncResource(() => bridge.getAsset(key), [bridge, typeof key === "string" ? key : key.join("\0")], statusController, { refetchOnSyncComplete: options?.refetchOnSyncComplete });
+}
+/**
+* Lists assets matching a secondary index value.
+*
+* @param indexName - The index to query (e.g. `"mimeType"`, a user-defined index name).
+* @param value - The index value to match.
+* @param options - Optional pagination and sync-triggered refetch behavior.
+*/
+function useMediaByIndex(indexName, value, options) {
+	const { bridge, statusController } = useMediaCacheRuntime();
+	const cursor = options?.cursor;
+	const limit = options?.limit;
+	return useAsyncResource(() => bridge.listByIndex(indexName, value, {
+		cursor,
+		limit
+	}), [
+		bridge,
+		indexName,
+		value,
+		cursor,
+		limit
+	], statusController, { refetchOnSyncComplete: options?.refetchOnSyncComplete });
+}
+/**
+* Searches assets by normalized file stem (file name without extension).
+*
+* @param stem - Normalized file stem to search for.
+* @param options - Optional pagination and sync-triggered refetch behavior.
+*/
+function useFileStemMatch(stem, options) {
+	const { bridge, statusController } = useMediaCacheRuntime();
+	const cursor = options?.cursor;
+	const limit = options?.limit;
+	return useAsyncResource(() => bridge.findByFileStem(stem, {
+		cursor,
+		limit
+	}), [
+		bridge,
+		stem,
+		cursor,
+		limit
+	], statusController, { refetchOnSyncComplete: options?.refetchOnSyncComplete });
+}
+function useMediaCacheReady() {
+	const status = useMediaCacheStatus();
+	return {
+		data: require_helpers.mediaCacheReadyFromStatus(status.data ?? void 0),
+		loading: status.loading,
+		error: status.error,
+		refresh: status.refresh
+	};
+}
+function useMediaCacheErrors() {
+	const { status, queryErrors } = useMediaCacheRuntime();
+	return require_helpers.aggregateMediaCacheErrors(status, queryErrors);
+}
+function useAsyncResource(loader, refreshDeps, statusController, options) {
+	const latestLoader = (0, react.useRef)(loader);
+	latestLoader.current = loader;
+	const watcherRef = (0, react.useRef)(null);
+	const [, forceRender] = (0, react.useReducer)((count) => count + 1, 0);
+	(0, react.useLayoutEffect)(() => {
+		const instance = require_runtime.createMediaQueryWatcherInstance({
+			status: statusController,
+			getLoader: () => latestLoader.current,
+			refetchOnSyncComplete: options?.refetchOnSyncComplete ?? true,
+			listener: () => forceRender()
+		});
+		watcherRef.current = instance;
+		instance.syncDeps(refreshDeps);
+		forceRender();
+		return () => {
+			instance.dispose();
+			watcherRef.current = null;
+		};
+	}, [statusController, options?.refetchOnSyncComplete]);
+	(0, react.useEffect)(() => {
+		watcherRef.current?.syncDeps(refreshDeps);
+	});
+	const snapshot = watcherRef.current?.getSnapshot() ?? {
+		data: null,
+		loading: true,
+		error: null,
+		refresh: async () => {
+			await watcherRef.current?.refresh();
+		}
+	};
+	useQueryErrorRegistration(snapshot.error);
+	return snapshot;
+}
+function useMediaCacheRuntime() {
+	const runtime = (0, react.useContext)(MediaCacheContext);
+	const bridge = runtime?.bridge;
+	const statusController = runtime?.statusController;
+	if (!bridge || !statusController) throw new Error(require_runtime.MISSING_BRIDGE_ERROR);
+	return {
+		bridge,
+		status: (0, react.useSyncExternalStore)(statusController.subscribe, statusController.getSnapshot, statusController.getSnapshot),
+		statusController,
+		queryErrors: runtime.queryErrors
+	};
+}
+function useQueryErrorRegistration(error) {
+	const runtime = (0, react.useContext)(MediaCacheContext);
+	const queryErrorId = (0, react.useRef)(null);
+	if (queryErrorId.current === null) queryErrorId.current = `query-error-${nextQueryErrorId++}`;
+	(0, react.useEffect)(() => {
+		if (!runtime) return;
+		runtime.reportQueryError(queryErrorId.current, error);
+		return () => {
+			runtime.reportQueryError(queryErrorId.current, null);
+		};
+	}, [runtime, error]);
+}
+//#endregion
+exports.MediaCacheProvider = MediaCacheProvider;
+exports.useFileStemMatch = useFileStemMatch;
+exports.useMediaAsset = useMediaAsset;
+exports.useMediaBridge = useMediaBridge;
+exports.useMediaByIndex = useMediaByIndex;
+exports.useMediaCacheErrors = useMediaCacheErrors;
+exports.useMediaCacheReady = useMediaCacheReady;
+exports.useMediaCacheStatus = useMediaCacheStatus;
+
+//# sourceMappingURL=index.cjs.map

package/dist/react/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","names":["createMediaCacheStatusController","aggregateMediaCacheErrors","deriveMediaCachePhase","mediaCacheReadyFromStatus","createMediaQueryWatcherInstance","MISSING_BRIDGE_ERROR"],"sources":["../../src/react/index.tsx"],"sourcesContent":["import {\n  createContext,\n  useCallback,\n  useContext,\n  useEffect,\n  useLayoutEffect,\n  useMemo,\n  useReducer,\n  useRef,\n  useState,\n  useSyncExternalStore,\n  type PropsWithChildren,\n} from \"react\";\nimport type {\n  AssetKeyInput,\n  FileStemMatch,\n  MediaCacheBridge,\n  MediaCacheErrors,\n  MediaCachePhase,\n  MediaCacheReadyState,\n  MediaCacheStatus,\n  PaginationInput,\n  PaginationResult,\n  MediaQuerySyncOptions,\n  ResolvedMediaAsset,\n} from \"../shared/types.js\";\nimport \"../renderer/window-globals.js\";\nimport {\n  type MediaAsyncState,\n  type MediaCacheStatusController,\n  MISSING_BRIDGE_ERROR,\n  createMediaCacheStatusController,\n  createMediaQueryWatcherInstance,\n  deriveMediaCachePhase,\n} from \"../renderer/runtime.js\";\nimport { aggregateMediaCacheErrors, mediaCacheReadyFromStatus } from \"../renderer/helpers.js\";\n\ntype AsyncState<T> = MediaAsyncState<T>;\n\ninterface MediaCacheContextValue {\n  bridge: MediaCacheBridge | null;\n  statusController: MediaCacheStatusController | null;\n  queryErrors: Error[];\n  reportQueryError: (id: string, error: Error | null) => void;\n}\n\nexport interface UseMediaBridgeResult extends MediaCacheBridge {\n  status: AsyncState<MediaCacheStatus>;\n  phase: MediaCachePhase;\n  errors: MediaCacheErrors;\n}\n\nexport interface UseMediaCacheStatusResult extends AsyncState<MediaCacheStatus> {\n  phase: MediaCachePhase;\n}\n\nconst MediaCacheContext = createContext<MediaCacheContextValue | null>(null);\nlet nextQueryErrorId = 0;\n\nexport function MediaCacheProvider({\n  bridge,\n  children,\n}: PropsWithChildren<{ bridge?: MediaCacheBridge }>) {\n  const valueBridge = useMemo(() => bridge ?? window.mediaCache ?? null, [bridge]);\n  const statusController = useMemo(\n    () => createMediaCacheStatusController(valueBridge, valueBridge !== null),\n    [valueBridge],\n  );\n\n  useEffect(() => () => statusController.dispose(), [statusController]);\n\n  const [queryErrorsById, setQueryErrorsById] = useState<Map<string, Error>>(() => new Map());\n\n  const reportQueryError = useCallback((id: string, error: Error | null) => {\n    setQueryErrorsById((previous: Map<string, Error>) => {\n      if (error === null) {\n        if (!previous.has(id)) {\n          return previous;\n        }\n        const next = new Map(previous);\n        next.delete(id);\n        return next;\n      }\n\n      if (previous.get(id) === error) {\n        return previous;\n      }\n\n      const next = new Map(previous);\n      next.set(id, error);\n      return next;\n    });\n  }, []);\n\n  const queryErrors = useMemo(() => Array.from(queryErrorsById.values()), [queryErrorsById]);\n  const value = useMemo(\n    () => ({\n      bridge: valueBridge,\n      statusController,\n      queryErrors,\n      reportQueryError,\n    }),\n    [valueBridge, statusController, queryErrors, reportQueryError],\n  );\n\n  return <MediaCacheContext.Provider value={value}>{children}</MediaCacheContext.Provider>;\n}\n\nexport function useMediaBridge(): UseMediaBridgeResult {\n  const { bridge, status, queryErrors } = useMediaCacheRuntime();\n  const errors = useMemo(\n    () => aggregateMediaCacheErrors(status, queryErrors),\n    [status, queryErrors],\n  );\n\n  return useMemo(\n    () => ({\n      ...bridge,\n      status,\n      phase: deriveMediaCachePhase(status),\n      errors,\n    }),\n    [bridge, status, errors],\n  );\n}\n\nexport function useMediaCacheStatus(): UseMediaCacheStatusResult {\n  const status = useMediaCacheRuntime().status;\n  return useMemo(() => ({ ...status, phase: deriveMediaCachePhase(status) }), [status]);\n}\n\n/**\n * Fetches a single asset by key.\n *\n * @param key - The asset key to look up. A string or array of string segments.\n * @param options - Optional sync-triggered refetch behavior.\n */\nexport function useMediaAsset(\n  key: AssetKeyInput,\n  options?: MediaQuerySyncOptions,\n): AsyncState<ResolvedMediaAsset | null> {\n  const { bridge, statusController } = useMediaCacheRuntime();\n  const stableKey = typeof key === \"string\" ? key : key.join(\"\\0\");\n  return useAsyncResource(() => bridge.getAsset(key), [bridge, stableKey], statusController, {\n    refetchOnSyncComplete: options?.refetchOnSyncComplete,\n  });\n}\n\n/**\n * Lists assets matching a secondary index value.\n *\n * @param indexName - The index to query (e.g. `\"mimeType\"`, a user-defined index name).\n * @param value - The index value to match.\n * @param options - Optional pagination and sync-triggered refetch behavior.\n */\nexport function useMediaByIndex(\n  indexName: string,\n  value: string,\n  options?: PaginationInput & MediaQuerySyncOptions,\n): AsyncState<PaginationResult<ResolvedMediaAsset>> {\n  const { bridge, statusController } = useMediaCacheRuntime();\n  const cursor = options?.cursor;\n  const limit = options?.limit;\n  return useAsyncResource(\n    () => bridge.listByIndex(indexName, value, { cursor, limit }),\n    [bridge, indexName, value, cursor, limit],\n    statusController,\n    { refetchOnSyncComplete: options?.refetchOnSyncComplete },\n  );\n}\n\n/**\n * Searches assets by normalized file stem (file name without extension).\n *\n * @param stem - Normalized file stem to search for.\n * @param options - Optional pagination and sync-triggered refetch behavior.\n */\nexport function useFileStemMatch(\n  stem: string,\n  options?: PaginationInput & MediaQuerySyncOptions,\n): AsyncState<PaginationResult<FileStemMatch>> {\n  const { bridge, statusController } = useMediaCacheRuntime();\n  const cursor = options?.cursor;\n  const limit = options?.limit;\n  return useAsyncResource(\n    () => bridge.findByFileStem(stem, { cursor, limit }),\n    [bridge, stem, cursor, limit],\n    statusController,\n    { refetchOnSyncComplete: options?.refetchOnSyncComplete },\n  );\n}\n\nexport function useMediaCacheReady(): AsyncState<MediaCacheReadyState> {\n  const status = useMediaCacheStatus();\n\n  return {\n    data: mediaCacheReadyFromStatus(status.data ?? undefined),\n    loading: status.loading,\n    error: status.error,\n    refresh: status.refresh,\n  };\n}\n\nexport function useMediaCacheErrors(): MediaCacheErrors {\n  const { status, queryErrors } = useMediaCacheRuntime();\n  return aggregateMediaCacheErrors(status, queryErrors);\n}\n\nfunction useAsyncResource<T>(\n  loader: () => Promise<T>,\n  refreshDeps: ReadonlyArray<unknown>,\n  statusController: MediaCacheStatusController,\n  options?: MediaQuerySyncOptions,\n): AsyncState<T> {\n  const latestLoader = useRef(loader);\n  latestLoader.current = loader;\n\n  const watcherRef = useRef<ReturnType<typeof createMediaQueryWatcherInstance<T>> | null>(null);\n  const [, forceRender] = useReducer((count: number) => count + 1, 0);\n\n  useLayoutEffect(() => {\n    const instance = createMediaQueryWatcherInstance({\n      status: statusController,\n      getLoader: () => latestLoader.current,\n      refetchOnSyncComplete: options?.refetchOnSyncComplete ?? true,\n      listener: () => forceRender(),\n    });\n    watcherRef.current = instance;\n    instance.syncDeps(refreshDeps);\n    forceRender();\n    return () => {\n      instance.dispose();\n      watcherRef.current = null;\n    };\n    // eslint-disable-next-line react-hooks/exhaustive-deps -- deps compared imperatively via syncDeps\n  }, [statusController, options?.refetchOnSyncComplete]);\n\n  useEffect(() => {\n    watcherRef.current?.syncDeps(refreshDeps);\n  });\n\n  const snapshot =\n    watcherRef.current?.getSnapshot() ??\n    ({\n      data: null,\n      loading: true,\n      error: null,\n      refresh: async () => {\n        await watcherRef.current?.refresh();\n      },\n    } as AsyncState<T>);\n\n  useQueryErrorRegistration(snapshot.error);\n\n  return snapshot;\n}\n\nfunction useMediaCacheRuntime(): {\n  bridge: MediaCacheBridge;\n  status: AsyncState<MediaCacheStatus>;\n  statusController: MediaCacheStatusController;\n  queryErrors: Error[];\n} {\n  const runtime = useContext(MediaCacheContext);\n  const bridge = runtime?.bridge;\n  const statusController = runtime?.statusController;\n\n  if (!bridge || !statusController) {\n    throw new Error(MISSING_BRIDGE_ERROR);\n  }\n\n  const status = useSyncExternalStore(\n    statusController.subscribe,\n    statusController.getSnapshot,\n    statusController.getSnapshot,\n  );\n\n  return {\n    bridge,\n    status,\n    statusController,\n    queryErrors: runtime.queryErrors,\n  };\n}\n\nfunction useQueryErrorRegistration(error: Error | null): void {\n  const runtime = useContext(MediaCacheContext);\n  const queryErrorId = useRef<string | null>(null);\n\n  if (queryErrorId.current === null) {\n    queryErrorId.current = `query-error-${nextQueryErrorId++}`;\n  }\n\n  useEffect(() => {\n    if (!runtime) {\n      return;\n    }\n\n    runtime.reportQueryError(queryErrorId.current!, error);\n\n    return () => {\n      runtime.reportQueryError(queryErrorId.current!, null);\n    };\n  }, [runtime, error]);\n}\n\nexport type {\n  AssetKeyInput,\n  FileStemMatch,\n  MediaCacheBridge,\n  MediaCacheErrors,\n  MediaCachePhase,\n  MediaCacheReadyState,\n  MediaCacheStatus,\n  MediaQuerySyncOptions,\n  ResolvedMediaAsset,\n} from \"../shared/types.js\";\n"],"mappings":"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"}

package/dist/react/index.d.cts

@@ -0,0 +1,50 @@
+import { AssetKeyInput, FileStemMatch, MediaCacheBridge, MediaCacheErrors, MediaCachePhase, MediaCacheReadyState, MediaCacheStatus, MediaQuerySyncOptions, PaginationInput, PaginationResult, ResolvedMediaAsset } from "../shared/types.cjs";
+import { MediaAsyncState } from "../renderer/runtime.cjs";
+import * as _$react_jsx_runtime0 from "react/jsx-runtime";
+import { PropsWithChildren } from "react";
+
+//#region src/react/index.d.ts
+type AsyncState<T> = MediaAsyncState<T>;
+interface UseMediaBridgeResult extends MediaCacheBridge {
+  status: AsyncState<MediaCacheStatus>;
+  phase: MediaCachePhase;
+  errors: MediaCacheErrors;
+}
+interface UseMediaCacheStatusResult extends AsyncState<MediaCacheStatus> {
+  phase: MediaCachePhase;
+}
+declare function MediaCacheProvider({
+  bridge,
+  children
+}: PropsWithChildren<{
+  bridge?: MediaCacheBridge;
+}>): _$react_jsx_runtime0.JSX.Element;
+declare function useMediaBridge(): UseMediaBridgeResult;
+declare function useMediaCacheStatus(): UseMediaCacheStatusResult;
+/**
+ * Fetches a single asset by key.
+ *
+ * @param key - The asset key to look up. A string or array of string segments.
+ * @param options - Optional sync-triggered refetch behavior.
+ */
+declare function useMediaAsset(key: AssetKeyInput, options?: MediaQuerySyncOptions): AsyncState<ResolvedMediaAsset | null>;
+/**
+ * Lists assets matching a secondary index value.
+ *
+ * @param indexName - The index to query (e.g. `"mimeType"`, a user-defined index name).
+ * @param value - The index value to match.
+ * @param options - Optional pagination and sync-triggered refetch behavior.
+ */
+declare function useMediaByIndex(indexName: string, value: string, options?: PaginationInput & MediaQuerySyncOptions): AsyncState<PaginationResult<ResolvedMediaAsset>>;
+/**
+ * Searches assets by normalized file stem (file name without extension).
+ *
+ * @param stem - Normalized file stem to search for.
+ * @param options - Optional pagination and sync-triggered refetch behavior.
+ */
+declare function useFileStemMatch(stem: string, options?: PaginationInput & MediaQuerySyncOptions): AsyncState<PaginationResult<FileStemMatch>>;
+declare function useMediaCacheReady(): AsyncState<MediaCacheReadyState>;
+declare function useMediaCacheErrors(): MediaCacheErrors;
+//#endregion
+export { type AssetKeyInput, type FileStemMatch, type MediaCacheBridge, type MediaCacheErrors, type MediaCachePhase, MediaCacheProvider, type MediaCacheReadyState, type MediaCacheStatus, type MediaQuerySyncOptions, type ResolvedMediaAsset, UseMediaBridgeResult, UseMediaCacheStatusResult, useFileStemMatch, useMediaAsset, useMediaBridge, useMediaByIndex, useMediaCacheErrors, useMediaCacheReady, useMediaCacheStatus };
+//# sourceMappingURL=index.d.cts.map

package/dist/react/index.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.cts","names":[],"sources":["../../src/react/index.tsx"],"mappings":";;;;;;KAqCK,UAAA,MAAgB,eAAA,CAAgB,CAAA;AAAA,UASpB,oBAAA,SAA6B,gBAAA;EAC5C,MAAA,EAAQ,UAAA,CAAW,gBAAA;EACnB,KAAA,EAAO,eAAA;EACP,MAAA,EAAQ,gBAAA;AAAA;AAAA,UAGO,yBAAA,SAAkC,UAAA,CAAW,gBAAA;EAC5D,KAAA,EAAO,eAAA;AAAA;AAAA,iBAMO,kBAAA,CAAA;EACd,MAAA;EACA;AAAA,GACC,iBAAA;EAAoB,MAAA,GAAS,gBAAA;AAAA,KAAmB,oBAAA,CAAA,GAAA,CAAA,OAAA;AAAA,iBA8CnC,cAAA,CAAA,GAAkB,oBAAA;AAAA,iBAkBlB,mBAAA,CAAA,GAAuB,yBAAA;;;;;;;iBAWvB,aAAA,CACd,GAAA,EAAK,aAAA,EACL,OAAA,GAAU,qBAAA,GACT,UAAA,CAAW,kBAAA;;;;;;;;iBAeE,eAAA,CACd,SAAA,UACA,KAAA,UACA,OAAA,GAAU,eAAA,GAAkB,qBAAA,GAC3B,UAAA,CAAW,gBAAA,CAAiB,kBAAA;;;;AA3G/B;;;iBA6HgB,gBAAA,CACd,IAAA,UACA,OAAA,GAAU,eAAA,GAAkB,qBAAA,GAC3B,UAAA,CAAW,gBAAA,CAAiB,aAAA;AAAA,iBAYf,kBAAA,CAAA,GAAsB,UAAA,CAAW,oBAAA;AAAA,iBAWjC,mBAAA,CAAA,GAAuB,gBAAA"}

package/dist/react/index.d.ts

@@ -0,0 +1,50 @@
+import { AssetKeyInput, FileStemMatch, MediaCacheBridge, MediaCacheErrors, MediaCachePhase, MediaCacheReadyState, MediaCacheStatus, MediaQuerySyncOptions, PaginationInput, PaginationResult, ResolvedMediaAsset } from "../shared/types.js";
+import { MediaAsyncState } from "../renderer/runtime.js";
+import { PropsWithChildren } from "react";
+import * as _$react_jsx_runtime0 from "react/jsx-runtime";
+
+//#region src/react/index.d.ts
+type AsyncState<T> = MediaAsyncState<T>;
+interface UseMediaBridgeResult extends MediaCacheBridge {
+  status: AsyncState<MediaCacheStatus>;
+  phase: MediaCachePhase;
+  errors: MediaCacheErrors;
+}
+interface UseMediaCacheStatusResult extends AsyncState<MediaCacheStatus> {
+  phase: MediaCachePhase;
+}
+declare function MediaCacheProvider({
+  bridge,
+  children
+}: PropsWithChildren<{
+  bridge?: MediaCacheBridge;
+}>): _$react_jsx_runtime0.JSX.Element;
+declare function useMediaBridge(): UseMediaBridgeResult;
+declare function useMediaCacheStatus(): UseMediaCacheStatusResult;
+/**
+ * Fetches a single asset by key.
+ *
+ * @param key - The asset key to look up. A string or array of string segments.
+ * @param options - Optional sync-triggered refetch behavior.
+ */
+declare function useMediaAsset(key: AssetKeyInput, options?: MediaQuerySyncOptions): AsyncState<ResolvedMediaAsset | null>;
+/**
+ * Lists assets matching a secondary index value.
+ *
+ * @param indexName - The index to query (e.g. `"mimeType"`, a user-defined index name).
+ * @param value - The index value to match.
+ * @param options - Optional pagination and sync-triggered refetch behavior.
+ */
+declare function useMediaByIndex(indexName: string, value: string, options?: PaginationInput & MediaQuerySyncOptions): AsyncState<PaginationResult<ResolvedMediaAsset>>;
+/**
+ * Searches assets by normalized file stem (file name without extension).
+ *
+ * @param stem - Normalized file stem to search for.
+ * @param options - Optional pagination and sync-triggered refetch behavior.
+ */
+declare function useFileStemMatch(stem: string, options?: PaginationInput & MediaQuerySyncOptions): AsyncState<PaginationResult<FileStemMatch>>;
+declare function useMediaCacheReady(): AsyncState<MediaCacheReadyState>;
+declare function useMediaCacheErrors(): MediaCacheErrors;
+//#endregion
+export { type AssetKeyInput, type FileStemMatch, type MediaCacheBridge, type MediaCacheErrors, type MediaCachePhase, MediaCacheProvider, type MediaCacheReadyState, type MediaCacheStatus, type MediaQuerySyncOptions, type ResolvedMediaAsset, UseMediaBridgeResult, UseMediaCacheStatusResult, useFileStemMatch, useMediaAsset, useMediaBridge, useMediaByIndex, useMediaCacheErrors, useMediaCacheReady, useMediaCacheStatus };
+//# sourceMappingURL=index.d.ts.map

package/dist/react/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","names":[],"sources":["../../src/react/index.tsx"],"mappings":";;;;;;KAqCK,UAAA,MAAgB,eAAA,CAAgB,CAAA;AAAA,UASpB,oBAAA,SAA6B,gBAAA;EAC5C,MAAA,EAAQ,UAAA,CAAW,gBAAA;EACnB,KAAA,EAAO,eAAA;EACP,MAAA,EAAQ,gBAAA;AAAA;AAAA,UAGO,yBAAA,SAAkC,UAAA,CAAW,gBAAA;EAC5D,KAAA,EAAO,eAAA;AAAA;AAAA,iBAMO,kBAAA,CAAA;EACd,MAAA;EACA;AAAA,GACC,iBAAA;EAAoB,MAAA,GAAS,gBAAA;AAAA,KAAmB,oBAAA,CAAA,GAAA,CAAA,OAAA;AAAA,iBA8CnC,cAAA,CAAA,GAAkB,oBAAA;AAAA,iBAkBlB,mBAAA,CAAA,GAAuB,yBAAA;;;;;;;iBAWvB,aAAA,CACd,GAAA,EAAK,aAAA,EACL,OAAA,GAAU,qBAAA,GACT,UAAA,CAAW,kBAAA;;;;;;;;iBAeE,eAAA,CACd,SAAA,UACA,KAAA,UACA,OAAA,GAAU,eAAA,GAAkB,qBAAA,GAC3B,UAAA,CAAW,gBAAA,CAAiB,kBAAA;;;;AA3G/B;;;iBA6HgB,gBAAA,CACd,IAAA,UACA,OAAA,GAAU,eAAA,GAAkB,qBAAA,GAC3B,UAAA,CAAW,gBAAA,CAAiB,aAAA;AAAA,iBAYf,kBAAA,CAAA,GAAsB,UAAA,CAAW,oBAAA;AAAA,iBAWjC,mBAAA,CAAA,GAAuB,gBAAA"}

package/dist/react/index.js

@@ -0,0 +1,191 @@
+import { MISSING_BRIDGE_ERROR, createMediaCacheStatusController, createMediaQueryWatcherInstance, deriveMediaCachePhase } from "../renderer/runtime.js";
+import { aggregateMediaCacheErrors, mediaCacheReadyFromStatus } from "../renderer/helpers.js";
+import { createContext, useCallback, useContext, useEffect, useLayoutEffect, useMemo, useReducer, useRef, useState, useSyncExternalStore } from "react";
+import { jsx } from "react/jsx-runtime";
+//#region src/react/index.tsx
+const MediaCacheContext = createContext(null);
+let nextQueryErrorId = 0;
+function MediaCacheProvider({ bridge, children }) {
+	const valueBridge = useMemo(() => bridge ?? window.mediaCache ?? null, [bridge]);
+	const statusController = useMemo(() => createMediaCacheStatusController(valueBridge, valueBridge !== null), [valueBridge]);
+	useEffect(() => () => statusController.dispose(), [statusController]);
+	const [queryErrorsById, setQueryErrorsById] = useState(() => /* @__PURE__ */ new Map());
+	const reportQueryError = useCallback((id, error) => {
+		setQueryErrorsById((previous) => {
+			if (error === null) {
+				if (!previous.has(id)) return previous;
+				const next = new Map(previous);
+				next.delete(id);
+				return next;
+			}
+			if (previous.get(id) === error) return previous;
+			const next = new Map(previous);
+			next.set(id, error);
+			return next;
+		});
+	}, []);
+	const queryErrors = useMemo(() => Array.from(queryErrorsById.values()), [queryErrorsById]);
+	const value = useMemo(() => ({
+		bridge: valueBridge,
+		statusController,
+		queryErrors,
+		reportQueryError
+	}), [
+		valueBridge,
+		statusController,
+		queryErrors,
+		reportQueryError
+	]);
+	return /* @__PURE__ */ jsx(MediaCacheContext.Provider, {
+		value,
+		children
+	});
+}
+function useMediaBridge() {
+	const { bridge, status, queryErrors } = useMediaCacheRuntime();
+	const errors = useMemo(() => aggregateMediaCacheErrors(status, queryErrors), [status, queryErrors]);
+	return useMemo(() => ({
+		...bridge,
+		status,
+		phase: deriveMediaCachePhase(status),
+		errors
+	}), [
+		bridge,
+		status,
+		errors
+	]);
+}
+function useMediaCacheStatus() {
+	const status = useMediaCacheRuntime().status;
+	return useMemo(() => ({
+		...status,
+		phase: deriveMediaCachePhase(status)
+	}), [status]);
+}
+/**
+* Fetches a single asset by key.
+*
+* @param key - The asset key to look up. A string or array of string segments.
+* @param options - Optional sync-triggered refetch behavior.
+*/
+function useMediaAsset(key, options) {
+	const { bridge, statusController } = useMediaCacheRuntime();
+	return useAsyncResource(() => bridge.getAsset(key), [bridge, typeof key === "string" ? key : key.join("\0")], statusController, { refetchOnSyncComplete: options?.refetchOnSyncComplete });
+}
+/**
+* Lists assets matching a secondary index value.
+*
+* @param indexName - The index to query (e.g. `"mimeType"`, a user-defined index name).
+* @param value - The index value to match.
+* @param options - Optional pagination and sync-triggered refetch behavior.
+*/
+function useMediaByIndex(indexName, value, options) {
+	const { bridge, statusController } = useMediaCacheRuntime();
+	const cursor = options?.cursor;
+	const limit = options?.limit;
+	return useAsyncResource(() => bridge.listByIndex(indexName, value, {
+		cursor,
+		limit
+	}), [
+		bridge,
+		indexName,
+		value,
+		cursor,
+		limit
+	], statusController, { refetchOnSyncComplete: options?.refetchOnSyncComplete });
+}
+/**
+* Searches assets by normalized file stem (file name without extension).
+*
+* @param stem - Normalized file stem to search for.
+* @param options - Optional pagination and sync-triggered refetch behavior.
+*/
+function useFileStemMatch(stem, options) {
+	const { bridge, statusController } = useMediaCacheRuntime();
+	const cursor = options?.cursor;
+	const limit = options?.limit;
+	return useAsyncResource(() => bridge.findByFileStem(stem, {
+		cursor,
+		limit
+	}), [
+		bridge,
+		stem,
+		cursor,
+		limit
+	], statusController, { refetchOnSyncComplete: options?.refetchOnSyncComplete });
+}
+function useMediaCacheReady() {
+	const status = useMediaCacheStatus();
+	return {
+		data: mediaCacheReadyFromStatus(status.data ?? void 0),
+		loading: status.loading,
+		error: status.error,
+		refresh: status.refresh
+	};
+}
+function useMediaCacheErrors() {
+	const { status, queryErrors } = useMediaCacheRuntime();
+	return aggregateMediaCacheErrors(status, queryErrors);
+}
+function useAsyncResource(loader, refreshDeps, statusController, options) {
+	const latestLoader = useRef(loader);
+	latestLoader.current = loader;
+	const watcherRef = useRef(null);
+	const [, forceRender] = useReducer((count) => count + 1, 0);
+	useLayoutEffect(() => {
+		const instance = createMediaQueryWatcherInstance({
+			status: statusController,
+			getLoader: () => latestLoader.current,
+			refetchOnSyncComplete: options?.refetchOnSyncComplete ?? true,
+			listener: () => forceRender()
+		});
+		watcherRef.current = instance;
+		instance.syncDeps(refreshDeps);
+		forceRender();
+		return () => {
+			instance.dispose();
+			watcherRef.current = null;
+		};
+	}, [statusController, options?.refetchOnSyncComplete]);
+	useEffect(() => {
+		watcherRef.current?.syncDeps(refreshDeps);
+	});
+	const snapshot = watcherRef.current?.getSnapshot() ?? {
+		data: null,
+		loading: true,
+		error: null,
+		refresh: async () => {
+			await watcherRef.current?.refresh();
+		}
+	};
+	useQueryErrorRegistration(snapshot.error);
+	return snapshot;
+}
+function useMediaCacheRuntime() {
+	const runtime = useContext(MediaCacheContext);
+	const bridge = runtime?.bridge;
+	const statusController = runtime?.statusController;
+	if (!bridge || !statusController) throw new Error(MISSING_BRIDGE_ERROR);
+	return {
+		bridge,
+		status: useSyncExternalStore(statusController.subscribe, statusController.getSnapshot, statusController.getSnapshot),
+		statusController,
+		queryErrors: runtime.queryErrors
+	};
+}
+function useQueryErrorRegistration(error) {
+	const runtime = useContext(MediaCacheContext);
+	const queryErrorId = useRef(null);
+	if (queryErrorId.current === null) queryErrorId.current = `query-error-${nextQueryErrorId++}`;
+	useEffect(() => {
+		if (!runtime) return;
+		runtime.reportQueryError(queryErrorId.current, error);
+		return () => {
+			runtime.reportQueryError(queryErrorId.current, null);
+		};
+	}, [runtime, error]);
+}
+//#endregion
+export { MediaCacheProvider, useFileStemMatch, useMediaAsset, useMediaBridge, useMediaByIndex, useMediaCacheErrors, useMediaCacheReady, useMediaCacheStatus };
+
+//# sourceMappingURL=index.js.map