@rockhall/electron-offline-content 0.4.0

package/dist/react/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"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/renderer/helpers.cjs

@@ -0,0 +1,36 @@
+//#region src/renderer/helpers.ts
+function toPrimaryError(syncError) {
+	if (!syncError) return null;
+	const error = new Error(syncError.message);
+	error.name = syncError.name;
+	return error;
+}
+/** Derive {@link MediaCacheReadyState} from a status snapshot, or `null` if status is missing. */
+function mediaCacheReadyFromStatus(status) {
+	if (!status) return null;
+	return {
+		ready: status.phase === "ready",
+		syncing: status.phase === "syncing",
+		phase: status.phase,
+		activeGenerationId: status.activeGenerationId,
+		syncError: status.error
+	};
+}
+/** Combine status loading failures, sync errors, and query errors (same rules as `useMediaCacheErrors`). */
+function aggregateMediaCacheErrors(statusState, queryErrors) {
+	const syncError = statusState.data?.error ?? null;
+	const statusError = statusState.error;
+	const primaryError = statusError ?? queryErrors[0] ?? toPrimaryError(syncError);
+	return {
+		syncError,
+		statusError,
+		queryErrors,
+		hasError: primaryError !== null,
+		primaryError
+	};
+}
+//#endregion
+exports.aggregateMediaCacheErrors = aggregateMediaCacheErrors;
+exports.mediaCacheReadyFromStatus = mediaCacheReadyFromStatus;
+
+//# sourceMappingURL=helpers.cjs.map

package/dist/renderer/helpers.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.cjs","names":[],"sources":["../../src/renderer/helpers.ts"],"sourcesContent":["import type { MediaCacheErrors, MediaCacheReadyState, MediaCacheStatus } from \"../shared/types.js\";\nimport type { MediaAsyncState } from \"./runtime.js\";\n\nfunction toPrimaryError(syncError: MediaCacheStatus[\"error\"]): Error | null {\n  if (!syncError) {\n    return null;\n  }\n\n  const error = new Error(syncError.message);\n  error.name = syncError.name;\n  return error;\n}\n\n/** Derive {@link MediaCacheReadyState} from a status snapshot, or `null` if status is missing. */\nexport function mediaCacheReadyFromStatus(\n  status: MediaCacheStatus | null | undefined,\n): MediaCacheReadyState | null {\n  if (!status) {\n    return null;\n  }\n\n  return {\n    ready: status.phase === \"ready\",\n    syncing: status.phase === \"syncing\",\n    phase: status.phase,\n    activeGenerationId: status.activeGenerationId,\n    syncError: status.error,\n  };\n}\n\n/** Combine status loading failures, sync errors, and query errors (same rules as `useMediaCacheErrors`). */\nexport function aggregateMediaCacheErrors(\n  statusState: MediaAsyncState<MediaCacheStatus>,\n  queryErrors: Error[],\n): MediaCacheErrors {\n  const syncError = statusState.data?.error ?? null;\n  const statusError = statusState.error;\n  const primaryError = statusError ?? queryErrors[0] ?? toPrimaryError(syncError);\n\n  return {\n    syncError,\n    statusError,\n    queryErrors,\n    hasError: primaryError !== null,\n    primaryError,\n  };\n}\n"],"mappings":";AAGA,SAAS,eAAe,WAAoD;CAC1E,IAAI,CAAC,WACH,OAAO;CAGT,MAAM,QAAQ,IAAI,MAAM,UAAU,QAAQ;CAC1C,MAAM,OAAO,UAAU;CACvB,OAAO;;;AAIT,SAAgB,0BACd,QAC6B;CAC7B,IAAI,CAAC,QACH,OAAO;CAGT,OAAO;EACL,OAAO,OAAO,UAAU;EACxB,SAAS,OAAO,UAAU;EAC1B,OAAO,OAAO;EACd,oBAAoB,OAAO;EAC3B,WAAW,OAAO;EACnB;;;AAIH,SAAgB,0BACd,aACA,aACkB;CAClB,MAAM,YAAY,YAAY,MAAM,SAAS;CAC7C,MAAM,cAAc,YAAY;CAChC,MAAM,eAAe,eAAe,YAAY,MAAM,eAAe,UAAU;CAE/E,OAAO;EACL;EACA;EACA;EACA,UAAU,iBAAiB;EAC3B;EACD"}

package/dist/renderer/helpers.d.cts

@@ -0,0 +1,11 @@
+import { MediaCacheErrors, MediaCacheReadyState, MediaCacheStatus } from "../shared/types.cjs";
+import { MediaAsyncState } from "./runtime.cjs";
+
+//#region src/renderer/helpers.d.ts
+/** Derive {@link MediaCacheReadyState} from a status snapshot, or `null` if status is missing. */
+declare function mediaCacheReadyFromStatus(status: MediaCacheStatus | null | undefined): MediaCacheReadyState | null;
+/** Combine status loading failures, sync errors, and query errors (same rules as `useMediaCacheErrors`). */
+declare function aggregateMediaCacheErrors(statusState: MediaAsyncState<MediaCacheStatus>, queryErrors: Error[]): MediaCacheErrors;
+//#endregion
+export { aggregateMediaCacheErrors, mediaCacheReadyFromStatus };
+//# sourceMappingURL=helpers.d.cts.map

package/dist/renderer/helpers.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.d.cts","names":[],"sources":["../../src/renderer/helpers.ts"],"mappings":";;;;;iBAcgB,yBAAA,CACd,MAAA,EAAQ,gBAAA,sBACP,oBAAA;AAFH;AAAA,iBAiBgB,yBAAA,CACd,WAAA,EAAa,eAAA,CAAgB,gBAAA,GAC7B,WAAA,EAAa,KAAA,KACZ,gBAAA"}

package/dist/renderer/helpers.d.ts

@@ -0,0 +1,11 @@
+import { MediaCacheErrors, MediaCacheReadyState, MediaCacheStatus } from "../shared/types.js";
+import { MediaAsyncState } from "./runtime.js";
+
+//#region src/renderer/helpers.d.ts
+/** Derive {@link MediaCacheReadyState} from a status snapshot, or `null` if status is missing. */
+declare function mediaCacheReadyFromStatus(status: MediaCacheStatus | null | undefined): MediaCacheReadyState | null;
+/** Combine status loading failures, sync errors, and query errors (same rules as `useMediaCacheErrors`). */
+declare function aggregateMediaCacheErrors(statusState: MediaAsyncState<MediaCacheStatus>, queryErrors: Error[]): MediaCacheErrors;
+//#endregion
+export { aggregateMediaCacheErrors, mediaCacheReadyFromStatus };
+//# sourceMappingURL=helpers.d.ts.map

package/dist/renderer/helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.d.ts","names":[],"sources":["../../src/renderer/helpers.ts"],"mappings":";;;;;iBAcgB,yBAAA,CACd,MAAA,EAAQ,gBAAA,sBACP,oBAAA;AAFH;AAAA,iBAiBgB,yBAAA,CACd,WAAA,EAAa,eAAA,CAAgB,gBAAA,GAC7B,WAAA,EAAa,KAAA,KACZ,gBAAA"}

package/dist/renderer/helpers.js

@@ -0,0 +1,35 @@
+//#region src/renderer/helpers.ts
+function toPrimaryError(syncError) {
+	if (!syncError) return null;
+	const error = new Error(syncError.message);
+	error.name = syncError.name;
+	return error;
+}
+/** Derive {@link MediaCacheReadyState} from a status snapshot, or `null` if status is missing. */
+function mediaCacheReadyFromStatus(status) {
+	if (!status) return null;
+	return {
+		ready: status.phase === "ready",
+		syncing: status.phase === "syncing",
+		phase: status.phase,
+		activeGenerationId: status.activeGenerationId,
+		syncError: status.error
+	};
+}
+/** Combine status loading failures, sync errors, and query errors (same rules as `useMediaCacheErrors`). */
+function aggregateMediaCacheErrors(statusState, queryErrors) {
+	const syncError = statusState.data?.error ?? null;
+	const statusError = statusState.error;
+	const primaryError = statusError ?? queryErrors[0] ?? toPrimaryError(syncError);
+	return {
+		syncError,
+		statusError,
+		queryErrors,
+		hasError: primaryError !== null,
+		primaryError
+	};
+}
+//#endregion
+export { aggregateMediaCacheErrors, mediaCacheReadyFromStatus };
+
+//# sourceMappingURL=helpers.js.map

package/dist/renderer/helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.js","names":[],"sources":["../../src/renderer/helpers.ts"],"sourcesContent":["import type { MediaCacheErrors, MediaCacheReadyState, MediaCacheStatus } from \"../shared/types.js\";\nimport type { MediaAsyncState } from \"./runtime.js\";\n\nfunction toPrimaryError(syncError: MediaCacheStatus[\"error\"]): Error | null {\n  if (!syncError) {\n    return null;\n  }\n\n  const error = new Error(syncError.message);\n  error.name = syncError.name;\n  return error;\n}\n\n/** Derive {@link MediaCacheReadyState} from a status snapshot, or `null` if status is missing. */\nexport function mediaCacheReadyFromStatus(\n  status: MediaCacheStatus | null | undefined,\n): MediaCacheReadyState | null {\n  if (!status) {\n    return null;\n  }\n\n  return {\n    ready: status.phase === \"ready\",\n    syncing: status.phase === \"syncing\",\n    phase: status.phase,\n    activeGenerationId: status.activeGenerationId,\n    syncError: status.error,\n  };\n}\n\n/** Combine status loading failures, sync errors, and query errors (same rules as `useMediaCacheErrors`). */\nexport function aggregateMediaCacheErrors(\n  statusState: MediaAsyncState<MediaCacheStatus>,\n  queryErrors: Error[],\n): MediaCacheErrors {\n  const syncError = statusState.data?.error ?? null;\n  const statusError = statusState.error;\n  const primaryError = statusError ?? queryErrors[0] ?? toPrimaryError(syncError);\n\n  return {\n    syncError,\n    statusError,\n    queryErrors,\n    hasError: primaryError !== null,\n    primaryError,\n  };\n}\n"],"mappings":";AAGA,SAAS,eAAe,WAAoD;CAC1E,IAAI,CAAC,WACH,OAAO;CAGT,MAAM,QAAQ,IAAI,MAAM,UAAU,QAAQ;CAC1C,MAAM,OAAO,UAAU;CACvB,OAAO;;;AAIT,SAAgB,0BACd,QAC6B;CAC7B,IAAI,CAAC,QACH,OAAO;CAGT,OAAO;EACL,OAAO,OAAO,UAAU;EACxB,SAAS,OAAO,UAAU;EAC1B,OAAO,OAAO;EACd,oBAAoB,OAAO;EAC3B,WAAW,OAAO;EACnB;;;AAIH,SAAgB,0BACd,aACA,aACkB;CAClB,MAAM,YAAY,YAAY,MAAM,SAAS;CAC7C,MAAM,cAAc,YAAY;CAChC,MAAM,eAAe,eAAe,YAAY,MAAM,eAAe,UAAU;CAE/E,OAAO;EACL;EACA;EACA;EACA,UAAU,iBAAiB;EAC3B;EACD"}

package/dist/renderer/index.cjs

@@ -0,0 +1,20 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_runtime = require("./runtime.cjs");
+const require_helpers = require("./helpers.cjs");
+//#region src/renderer/index.ts
+/**
+* Framework-agnostic entry: resolves the preload bridge, subscribes to cache status,
+* and exposes watchers aligned with the React hooks’ async semantics.
+*/
+function createMediaCacheRenderer(options) {
+	return require_runtime.createMediaCacheRenderer(options);
+}
+//#endregion
+exports.MISSING_BRIDGE_ERROR = require_runtime.MISSING_BRIDGE_ERROR;
+exports.aggregateMediaCacheErrors = require_helpers.aggregateMediaCacheErrors;
+exports.createMediaCacheRenderer = createMediaCacheRenderer;
+exports.deriveMediaCachePhase = require_runtime.deriveMediaCachePhase;
+exports.mediaCacheReadyFromStatus = require_helpers.mediaCacheReadyFromStatus;
+exports.resolveMediaCacheBridge = require_runtime.resolveMediaCacheBridge;
+
+//# sourceMappingURL=index.cjs.map

package/dist/renderer/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","names":["createMediaCacheRendererImpl"],"sources":["../../src/renderer/index.ts"],"sourcesContent":["import \"./window-globals.js\";\nimport type { MediaAsyncState } from \"./runtime.js\";\nimport {\n  type CreateMediaCacheRendererOptions,\n  type MediaCacheRenderer,\n  createMediaCacheRenderer as createMediaCacheRendererImpl,\n} from \"./runtime.js\";\n\nexport { aggregateMediaCacheErrors, mediaCacheReadyFromStatus } from \"./helpers.js\";\n\nexport type { MediaAsyncState };\nexport { MISSING_BRIDGE_ERROR, deriveMediaCachePhase, resolveMediaCacheBridge } from \"./runtime.js\";\n\nexport type CreateMediaCacheRendererInput = CreateMediaCacheRendererOptions;\n\n/**\n * Framework-agnostic entry: resolves the preload bridge, subscribes to cache status,\n * and exposes watchers aligned with the React hooks’ async semantics.\n */\nexport function createMediaCacheRenderer(\n  options?: CreateMediaCacheRendererOptions,\n): MediaCacheRenderer {\n  return createMediaCacheRendererImpl(options);\n}\n\nexport type {\n  AssetKeyInput,\n  FileStemMatch,\n  MediaCacheBridge,\n  MediaCacheErrors,\n  MediaCachePhase,\n  MediaCacheReadyState,\n  MediaCacheStatus,\n  MediaQuerySyncOptions,\n  PaginationInput,\n  PaginationResult,\n  ResolvedMediaAsset,\n} from \"../shared/types.js\";\n"],"mappings":";;;;;;;;AAmBA,SAAgB,yBACd,SACoB;CACpB,OAAOA,gBAAAA,yBAA6B,QAAQ"}

package/dist/renderer/index.d.cts

@@ -0,0 +1,14 @@
+import { AssetKeyInput, FileStemMatch, MediaCacheBridge, MediaCacheErrors, MediaCachePhase, MediaCacheReadyState, MediaCacheStatus, MediaQuerySyncOptions, PaginationInput, PaginationResult, ResolvedMediaAsset } from "../shared/types.cjs";
+import { CreateMediaCacheRendererOptions, MISSING_BRIDGE_ERROR, MediaAsyncState, MediaCacheRenderer, deriveMediaCachePhase, resolveMediaCacheBridge } from "./runtime.cjs";
+import { aggregateMediaCacheErrors, mediaCacheReadyFromStatus } from "./helpers.cjs";
+
+//#region src/renderer/index.d.ts
+type CreateMediaCacheRendererInput = CreateMediaCacheRendererOptions;
+/**
+ * Framework-agnostic entry: resolves the preload bridge, subscribes to cache status,
+ * and exposes watchers aligned with the React hooks’ async semantics.
+ */
+declare function createMediaCacheRenderer(options?: CreateMediaCacheRendererOptions): MediaCacheRenderer;
+//#endregion
+export { type AssetKeyInput, CreateMediaCacheRendererInput, type FileStemMatch, MISSING_BRIDGE_ERROR, type MediaAsyncState, type MediaCacheBridge, type MediaCacheErrors, type MediaCachePhase, type MediaCacheReadyState, type MediaCacheStatus, type MediaQuerySyncOptions, type PaginationInput, type PaginationResult, type ResolvedMediaAsset, aggregateMediaCacheErrors, createMediaCacheRenderer, deriveMediaCachePhase, mediaCacheReadyFromStatus, resolveMediaCacheBridge };
+//# sourceMappingURL=index.d.cts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.cts","names":[],"sources":["../../src/renderer/index.ts"],"mappings":";;;;;KAaY,6BAAA,GAAgC,+BAAA;;;;;iBAM5B,wBAAA,CACd,OAAA,GAAU,+BAAA,GACT,kBAAA"}

package/dist/renderer/index.d.ts

@@ -0,0 +1,14 @@
+import { AssetKeyInput, FileStemMatch, MediaCacheBridge, MediaCacheErrors, MediaCachePhase, MediaCacheReadyState, MediaCacheStatus, MediaQuerySyncOptions, PaginationInput, PaginationResult, ResolvedMediaAsset } from "../shared/types.js";
+import { CreateMediaCacheRendererOptions, MISSING_BRIDGE_ERROR, MediaAsyncState, MediaCacheRenderer, deriveMediaCachePhase, resolveMediaCacheBridge } from "./runtime.js";
+import { aggregateMediaCacheErrors, mediaCacheReadyFromStatus } from "./helpers.js";
+
+//#region src/renderer/index.d.ts
+type CreateMediaCacheRendererInput = CreateMediaCacheRendererOptions;
+/**
+ * Framework-agnostic entry: resolves the preload bridge, subscribes to cache status,
+ * and exposes watchers aligned with the React hooks’ async semantics.
+ */
+declare function createMediaCacheRenderer(options?: CreateMediaCacheRendererOptions): MediaCacheRenderer;
+//#endregion
+export { type AssetKeyInput, CreateMediaCacheRendererInput, type FileStemMatch, MISSING_BRIDGE_ERROR, type MediaAsyncState, type MediaCacheBridge, type MediaCacheErrors, type MediaCachePhase, type MediaCacheReadyState, type MediaCacheStatus, type MediaQuerySyncOptions, type PaginationInput, type PaginationResult, type ResolvedMediaAsset, aggregateMediaCacheErrors, createMediaCacheRenderer, deriveMediaCachePhase, mediaCacheReadyFromStatus, resolveMediaCacheBridge };
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","names":[],"sources":["../../src/renderer/index.ts"],"mappings":";;;;;KAaY,6BAAA,GAAgC,+BAAA;;;;;iBAM5B,wBAAA,CACd,OAAA,GAAU,+BAAA,GACT,kBAAA"}

package/dist/renderer/index.js

@@ -0,0 +1,14 @@
+import { MISSING_BRIDGE_ERROR, createMediaCacheRenderer as createMediaCacheRenderer$1, deriveMediaCachePhase, resolveMediaCacheBridge } from "./runtime.js";
+import { aggregateMediaCacheErrors, mediaCacheReadyFromStatus } from "./helpers.js";
+//#region src/renderer/index.ts
+/**
+* Framework-agnostic entry: resolves the preload bridge, subscribes to cache status,
+* and exposes watchers aligned with the React hooks’ async semantics.
+*/
+function createMediaCacheRenderer(options) {
+	return createMediaCacheRenderer$1(options);
+}
+//#endregion
+export { MISSING_BRIDGE_ERROR, aggregateMediaCacheErrors, createMediaCacheRenderer, deriveMediaCachePhase, mediaCacheReadyFromStatus, resolveMediaCacheBridge };
+
+//# sourceMappingURL=index.js.map

package/dist/renderer/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":["createMediaCacheRendererImpl"],"sources":["../../src/renderer/index.ts"],"sourcesContent":["import \"./window-globals.js\";\nimport type { MediaAsyncState } from \"./runtime.js\";\nimport {\n  type CreateMediaCacheRendererOptions,\n  type MediaCacheRenderer,\n  createMediaCacheRenderer as createMediaCacheRendererImpl,\n} from \"./runtime.js\";\n\nexport { aggregateMediaCacheErrors, mediaCacheReadyFromStatus } from \"./helpers.js\";\n\nexport type { MediaAsyncState };\nexport { MISSING_BRIDGE_ERROR, deriveMediaCachePhase, resolveMediaCacheBridge } from \"./runtime.js\";\n\nexport type CreateMediaCacheRendererInput = CreateMediaCacheRendererOptions;\n\n/**\n * Framework-agnostic entry: resolves the preload bridge, subscribes to cache status,\n * and exposes watchers aligned with the React hooks’ async semantics.\n */\nexport function createMediaCacheRenderer(\n  options?: CreateMediaCacheRendererOptions,\n): MediaCacheRenderer {\n  return createMediaCacheRendererImpl(options);\n}\n\nexport type {\n  AssetKeyInput,\n  FileStemMatch,\n  MediaCacheBridge,\n  MediaCacheErrors,\n  MediaCachePhase,\n  MediaCacheReadyState,\n  MediaCacheStatus,\n  MediaQuerySyncOptions,\n  PaginationInput,\n  PaginationResult,\n  ResolvedMediaAsset,\n} from \"../shared/types.js\";\n"],"mappings":";;;;;;;AAmBA,SAAgB,yBACd,SACoB;CACpB,OAAOA,2BAA6B,QAAQ"}

package/dist/renderer/runtime.cjs

@@ -0,0 +1,278 @@
+//#region src/renderer/runtime.ts
+const MISSING_BRIDGE_ERROR = "MediaCache bridge is unavailable. Wrap your app in <MediaCacheProvider> or expose the preload bridge on window.mediaCache.";
+function toError(error) {
+	return error instanceof Error ? error : new Error(String(error));
+}
+function deriveMediaCachePhase(status) {
+	return status.data?.phase ?? (status.loading ? "loading" : "idle");
+}
+function resolveMediaCacheBridge(options) {
+	const key = options?.windowKey ?? "mediaCache";
+	const fromWindow = typeof window !== "undefined" ? window[key] : void 0;
+	const bridge = options?.bridge ?? fromWindow;
+	if (!bridge || typeof bridge.getStatus !== "function" || typeof bridge.subscribeStatus !== "function" || typeof bridge.syncNow !== "function" || typeof bridge.getAsset !== "function" || typeof bridge.listByIndex !== "function" || typeof bridge.findByFileStem !== "function") throw new Error(MISSING_BRIDGE_ERROR);
+	return bridge;
+}
+const EMPTY_DISABLED_STATUS_SNAPSHOT = {
+	data: null,
+	loading: false,
+	error: null,
+	refresh: async () => void 0
+};
+/**
+* Owns status fetch + `subscribeStatus` wiring; same behavior as the former
+* `useMediaCacheStatusState` hook.
+*/
+function createMediaCacheStatusController(bridge, enabled) {
+	if (!enabled || !bridge) return {
+		getSnapshot: () => EMPTY_DISABLED_STATUS_SNAPSHOT,
+		subscribe: () => () => void 0,
+		refresh: async () => void 0,
+		dispose: () => void 0
+	};
+	const activeBridge = bridge;
+	let data = null;
+	let loading = true;
+	let error = null;
+	let requestSequence = 0;
+	const listeners = /* @__PURE__ */ new Set();
+	let unsubscribeBridge = null;
+	let disposed = false;
+	function emit() {
+		for (const listener of listeners) listener();
+	}
+	async function refresh() {
+		const requestId = ++requestSequence;
+		loading = true;
+		emit();
+		try {
+			const nextStatus = await activeBridge.getStatus();
+			if (requestId === requestSequence) {
+				data = nextStatus;
+				error = null;
+			}
+		} catch (caught) {
+			if (requestId === requestSequence) error = toError(caught);
+		} finally {
+			if (requestId === requestSequence) {
+				loading = false;
+				emit();
+			}
+		}
+	}
+	let cachedSnapshot = null;
+	function getSnapshot() {
+		if (cachedSnapshot && cachedSnapshot.data === data && cachedSnapshot.loading === loading && cachedSnapshot.error === error) return cachedSnapshot;
+		cachedSnapshot = {
+			data,
+			loading,
+			error,
+			refresh
+		};
+		return cachedSnapshot;
+	}
+	function subscribe(listener) {
+		listeners.add(listener);
+		return () => {
+			listeners.delete(listener);
+		};
+	}
+	function dispose() {
+		if (disposed) return;
+		disposed = true;
+		if (unsubscribeBridge) {
+			unsubscribeBridge();
+			unsubscribeBridge = null;
+		}
+		requestSequence += 1;
+		listeners.clear();
+	}
+	refresh();
+	unsubscribeBridge = activeBridge.subscribeStatus((status) => {
+		requestSequence += 1;
+		if (!disposed) {
+			data = status;
+			loading = false;
+			error = null;
+			emit();
+		}
+	});
+	return {
+		getSnapshot,
+		subscribe,
+		refresh,
+		dispose
+	};
+}
+/**
+* Shared query lifecycle: dependency-based refresh + optional refetch when
+* `phase === "ready"` and `activeGenerationId` changes.
+*/
+function createMediaQueryWatcherInstance(options) {
+	const { status, getLoader, refetchOnSyncComplete, listener } = options;
+	let data = null;
+	let loading = true;
+	let error = null;
+	let requestSequence = 0;
+	let previousDeps = null;
+	let previousReadyGenerationId = null;
+	let disposed = false;
+	let cachedQuerySnapshot = null;
+	function notify() {
+		if (!disposed) listener(getSnapshot());
+	}
+	async function refresh() {
+		const requestId = ++requestSequence;
+		loading = true;
+		notify();
+		try {
+			const result = await getLoader()();
+			if (requestId === requestSequence) {
+				data = result;
+				error = null;
+			}
+		} catch (caught) {
+			if (requestId === requestSequence) error = toError(caught);
+		} finally {
+			if (requestId === requestSequence) loading = false;
+			notify();
+		}
+	}
+	function getSnapshot() {
+		if (cachedQuerySnapshot && cachedQuerySnapshot.data === data && cachedQuerySnapshot.loading === loading && cachedQuerySnapshot.error === error) return cachedQuerySnapshot;
+		cachedQuerySnapshot = {
+			data,
+			loading,
+			error,
+			refresh
+		};
+		return cachedQuerySnapshot;
+	}
+	function onStatusTick() {
+		const st = status.getSnapshot();
+		const phase = st.data?.phase;
+		const activeGenerationId = st.data?.activeGenerationId ?? null;
+		if (!refetchOnSyncComplete || phase !== "ready" || activeGenerationId === null) return;
+		if (previousReadyGenerationId !== activeGenerationId) {
+			previousReadyGenerationId = activeGenerationId;
+			refresh();
+		}
+	}
+	function syncDeps(refreshDeps) {
+		if (!(previousDeps === null || previousDeps.length !== refreshDeps.length || refreshDeps.some((dependency, index) => !Object.is(dependency, previousDeps[index])))) return;
+		previousDeps = refreshDeps;
+		refresh();
+	}
+	const unsubStatus = status.subscribe(() => {
+		onStatusTick();
+	});
+	onStatusTick();
+	return {
+		syncDeps,
+		onStatusTick,
+		getSnapshot,
+		refresh,
+		dispose() {
+			if (disposed) return;
+			disposed = true;
+			unsubStatus();
+			requestSequence += 1;
+		}
+	};
+}
+/** Framework-agnostic renderer client: shared status subscription and query watchers. */
+function createMediaCacheRenderer(options) {
+	const bridge = resolveMediaCacheBridge(options);
+	const status = createMediaCacheStatusController(bridge, true);
+	const queryWatchers = /* @__PURE__ */ new Set();
+	function addQueryWatcher(instance) {
+		queryWatchers.add(instance);
+		return () => {
+			queryWatchers.delete(instance);
+			instance.dispose();
+		};
+	}
+	function subscribeCacheStatus(listener) {
+		listener(status.getSnapshot());
+		return status.subscribe(() => {
+			listener(status.getSnapshot());
+		});
+	}
+	return {
+		bridge,
+		subscribeCacheStatus,
+		watchMediaAsset(key, queryOptions, listener) {
+			const refetch = queryOptions?.refetchOnSyncComplete ?? true;
+			const stableKey = typeof key === "string" ? key : key.join("\0");
+			const instance = createMediaQueryWatcherInstance({
+				status,
+				getLoader: () => () => bridge.getAsset(key),
+				refetchOnSyncComplete: refetch,
+				listener
+			});
+			instance.syncDeps([
+				bridge,
+				"asset",
+				stableKey
+			]);
+			return addQueryWatcher(instance);
+		},
+		watchMediaByIndex(indexName, value, listOptions, listener) {
+			const cursor = listOptions?.cursor;
+			const limit = listOptions?.limit;
+			const instance = createMediaQueryWatcherInstance({
+				status,
+				getLoader: () => () => bridge.listByIndex(indexName, value, {
+					cursor,
+					limit
+				}),
+				refetchOnSyncComplete: listOptions?.refetchOnSyncComplete ?? true,
+				listener
+			});
+			instance.syncDeps([
+				bridge,
+				"index",
+				indexName,
+				value,
+				cursor,
+				limit
+			]);
+			return addQueryWatcher(instance);
+		},
+		watchFileStemMatch(stem, stemOptions, listener) {
+			const cursor = stemOptions?.cursor;
+			const limit = stemOptions?.limit;
+			const instance = createMediaQueryWatcherInstance({
+				status,
+				getLoader: () => () => bridge.findByFileStem(stem, {
+					cursor,
+					limit
+				}),
+				refetchOnSyncComplete: stemOptions?.refetchOnSyncComplete ?? true,
+				listener
+			});
+			instance.syncDeps([
+				bridge,
+				"fileStem",
+				stem,
+				cursor,
+				limit
+			]);
+			return addQueryWatcher(instance);
+		},
+		dispose() {
+			for (const watcher of queryWatchers) watcher.dispose();
+			queryWatchers.clear();
+			status.dispose();
+		}
+	};
+}
+//#endregion
+exports.MISSING_BRIDGE_ERROR = MISSING_BRIDGE_ERROR;
+exports.createMediaCacheRenderer = createMediaCacheRenderer;
+exports.createMediaCacheStatusController = createMediaCacheStatusController;
+exports.createMediaQueryWatcherInstance = createMediaQueryWatcherInstance;
+exports.deriveMediaCachePhase = deriveMediaCachePhase;
+exports.resolveMediaCacheBridge = resolveMediaCacheBridge;
+
+//# sourceMappingURL=runtime.cjs.map

package/dist/renderer/runtime.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.cjs","names":[],"sources":["../../src/renderer/runtime.ts"],"sourcesContent":["import type {\n  AssetKeyInput,\n  FileStemMatch,\n  MediaCacheBridge,\n  MediaCachePhase,\n  MediaCacheStatus,\n  MediaQuerySyncOptions,\n  PaginationInput,\n  PaginationResult,\n  ResolvedMediaAsset,\n} from \"../shared/types.js\";\n\n/** Async snapshot aligned with React hooks (`useMedia`, `useMediaCacheStatus`, etc.). */\nexport interface MediaAsyncState<T> {\n  /** Latest resolved value, or `null` while loading/when unavailable. */\n  data: T | null;\n  /** `true` while an initial load or `refresh()` request is in flight. */\n  loading: boolean;\n  /** Last request error, or `null` when the latest request succeeded. */\n  error: Error | null;\n  /** Re-runs the underlying query and updates `data`/`error`. */\n  refresh: () => Promise<void>;\n}\n\nexport const MISSING_BRIDGE_ERROR =\n  \"MediaCache bridge is unavailable. Wrap your app in <MediaCacheProvider> or expose the preload bridge on window.mediaCache.\";\n\nexport function toError(error: unknown): Error {\n  return error instanceof Error ? error : new Error(String(error));\n}\n\nexport function deriveMediaCachePhase(status: MediaAsyncState<MediaCacheStatus>): MediaCachePhase {\n  return status.data?.phase ?? (status.loading ? \"loading\" : \"idle\");\n}\n\nexport function resolveMediaCacheBridge(options?: {\n  bridge?: MediaCacheBridge;\n  windowKey?: string;\n}): MediaCacheBridge {\n  const key = options?.windowKey ?? \"mediaCache\";\n  const fromWindow =\n    typeof window !== \"undefined\" ? (window as unknown as Record<string, unknown>)[key] : undefined;\n\n  const bridge = options?.bridge ?? (fromWindow as MediaCacheBridge | undefined);\n\n  if (\n    !bridge ||\n    typeof bridge.getStatus !== \"function\" ||\n    typeof bridge.subscribeStatus !== \"function\" ||\n    typeof bridge.syncNow !== \"function\" ||\n    typeof bridge.getAsset !== \"function\" ||\n    typeof bridge.listByIndex !== \"function\" ||\n    typeof bridge.findByFileStem !== \"function\"\n  ) {\n    throw new Error(MISSING_BRIDGE_ERROR);\n  }\n\n  return bridge;\n}\n\nconst EMPTY_DISABLED_STATUS_SNAPSHOT: MediaAsyncState<MediaCacheStatus> = {\n  data: null,\n  loading: false,\n  error: null,\n  refresh: async () => undefined,\n};\n\nexport interface MediaCacheStatusController {\n  getSnapshot(): MediaAsyncState<MediaCacheStatus>;\n  subscribe(listener: () => void): () => void;\n  refresh(): Promise<void>;\n  dispose(): void;\n}\n\n/**\n * Owns status fetch + `subscribeStatus` wiring; same behavior as the former\n * `useMediaCacheStatusState` hook.\n */\nexport function createMediaCacheStatusController(\n  bridge: MediaCacheBridge | null,\n  enabled: boolean,\n): MediaCacheStatusController {\n  if (!enabled || !bridge) {\n    return {\n      getSnapshot: () => EMPTY_DISABLED_STATUS_SNAPSHOT,\n      subscribe: () => () => undefined,\n      refresh: async () => undefined,\n      dispose: () => undefined,\n    };\n  }\n\n  const activeBridge = bridge;\n\n  let data: MediaCacheStatus | null = null;\n  let loading = true;\n  let error: Error | null = null;\n  let requestSequence = 0;\n  const listeners = new Set<() => void>();\n\n  let unsubscribeBridge: (() => void) | null = null;\n  let disposed = false;\n\n  function emit(): void {\n    for (const listener of listeners) {\n      listener();\n    }\n  }\n\n  async function refresh(): Promise<void> {\n    const requestId = ++requestSequence;\n    loading = true;\n    emit();\n    try {\n      const nextStatus = await activeBridge.getStatus();\n      if (requestId === requestSequence) {\n        data = nextStatus;\n        error = null;\n      }\n    } catch (caught) {\n      if (requestId === requestSequence) {\n        error = toError(caught);\n      }\n    } finally {\n      if (requestId === requestSequence) {\n        loading = false;\n        emit();\n      }\n    }\n  }\n\n  let cachedSnapshot: MediaAsyncState<MediaCacheStatus> | null = null;\n\n  function getSnapshot(): MediaAsyncState<MediaCacheStatus> {\n    if (\n      cachedSnapshot &&\n      cachedSnapshot.data === data &&\n      cachedSnapshot.loading === loading &&\n      cachedSnapshot.error === error\n    ) {\n      return cachedSnapshot;\n    }\n    cachedSnapshot = { data, loading, error, refresh };\n    return cachedSnapshot;\n  }\n\n  function subscribe(listener: () => void): () => void {\n    listeners.add(listener);\n    return () => {\n      listeners.delete(listener);\n    };\n  }\n\n  function dispose(): void {\n    if (disposed) {\n      return;\n    }\n    disposed = true;\n    if (unsubscribeBridge) {\n      unsubscribeBridge();\n      unsubscribeBridge = null;\n    }\n    requestSequence += 1;\n    listeners.clear();\n  }\n\n  void refresh();\n  unsubscribeBridge = activeBridge.subscribeStatus((status) => {\n    requestSequence += 1;\n    if (!disposed) {\n      data = status;\n      loading = false;\n      error = null;\n      emit();\n    }\n  });\n\n  return {\n    getSnapshot,\n    subscribe,\n    refresh,\n    dispose,\n  };\n}\n\nexport interface MediaQueryWatcherInstance<T> {\n  /** Compare deps to the previous call; refetches when the tuple changes. */\n  syncDeps(deps: ReadonlyArray<unknown>): void;\n  /** Run ready-generation refetch logic (also invoked on status updates). */\n  onStatusTick(): void;\n  getSnapshot(): MediaAsyncState<T>;\n  /** Same as snapshot `refresh` — exposed for hosts that subscribe before first snapshot. */\n  refresh(): Promise<void>;\n  dispose(): void;\n}\n\n/**\n * Shared query lifecycle: dependency-based refresh + optional refetch when\n * `phase === \"ready\"` and `activeGenerationId` changes.\n */\nexport function createMediaQueryWatcherInstance<T>(options: {\n  status: MediaCacheStatusController;\n  /** Called on each load so callers can close over fresh arguments (React ref pattern). */\n  getLoader: () => () => Promise<T>;\n  refetchOnSyncComplete: boolean;\n  listener: (state: MediaAsyncState<T>) => void;\n}): MediaQueryWatcherInstance<T> {\n  const { status, getLoader, refetchOnSyncComplete, listener } = options;\n\n  let data: T | null = null;\n  let loading = true;\n  let error: Error | null = null;\n  let requestSequence = 0;\n  let previousDeps: ReadonlyArray<unknown> | null = null;\n  let previousReadyGenerationId: number | null = null;\n  let disposed = false;\n  let cachedQuerySnapshot: MediaAsyncState<T> | null = null;\n\n  function notify(): void {\n    if (!disposed) {\n      listener(getSnapshot());\n    }\n  }\n\n  async function refresh(): Promise<void> {\n    const requestId = ++requestSequence;\n    loading = true;\n    notify();\n    try {\n      const result = await getLoader()();\n      if (requestId === requestSequence) {\n        data = result;\n        error = null;\n      }\n    } catch (caught) {\n      if (requestId === requestSequence) {\n        error = toError(caught);\n      }\n    } finally {\n      if (requestId === requestSequence) {\n        loading = false;\n      }\n      notify();\n    }\n  }\n\n  function getSnapshot(): MediaAsyncState<T> {\n    if (\n      cachedQuerySnapshot &&\n      cachedQuerySnapshot.data === data &&\n      cachedQuerySnapshot.loading === loading &&\n      cachedQuerySnapshot.error === error\n    ) {\n      return cachedQuerySnapshot;\n    }\n    cachedQuerySnapshot = { data, loading, error, refresh };\n    return cachedQuerySnapshot;\n  }\n\n  function onStatusTick(): void {\n    const st = status.getSnapshot();\n    const phase = st.data?.phase;\n    const activeGenerationId = st.data?.activeGenerationId ?? null;\n\n    if (!refetchOnSyncComplete || phase !== \"ready\" || activeGenerationId === null) {\n      return;\n    }\n\n    if (previousReadyGenerationId !== activeGenerationId) {\n      previousReadyGenerationId = activeGenerationId;\n      void refresh();\n    }\n  }\n\n  function syncDeps(refreshDeps: ReadonlyArray<unknown>): void {\n    const shouldRefresh =\n      previousDeps === null ||\n      previousDeps.length !== refreshDeps.length ||\n      refreshDeps.some((dependency, index) => !Object.is(dependency, previousDeps![index]));\n\n    if (!shouldRefresh) {\n      return;\n    }\n\n    previousDeps = refreshDeps;\n    void refresh();\n  }\n\n  const unsubStatus = status.subscribe(() => {\n    onStatusTick();\n  });\n\n  onStatusTick();\n\n  return {\n    syncDeps,\n    onStatusTick,\n    getSnapshot,\n    refresh,\n    dispose() {\n      if (disposed) {\n        return;\n      }\n      disposed = true;\n      unsubStatus();\n      requestSequence += 1;\n    },\n  };\n}\n\nexport interface CreateMediaCacheRendererOptions {\n  bridge?: MediaCacheBridge;\n  windowKey?: string;\n}\n\nexport interface MediaCacheRenderer {\n  bridge: MediaCacheBridge;\n  subscribeCacheStatus(listener: (state: MediaAsyncState<MediaCacheStatus>) => void): () => void;\n  watchMediaAsset(\n    key: AssetKeyInput,\n    options: MediaQuerySyncOptions | undefined,\n    listener: (state: MediaAsyncState<ResolvedMediaAsset | null>) => void,\n  ): () => void;\n  watchMediaByIndex(\n    indexName: string,\n    value: string,\n    options: (PaginationInput & MediaQuerySyncOptions) | undefined,\n    listener: (state: MediaAsyncState<PaginationResult<ResolvedMediaAsset>>) => void,\n  ): () => void;\n  watchFileStemMatch(\n    stem: string,\n    options: (PaginationInput & MediaQuerySyncOptions) | undefined,\n    listener: (state: MediaAsyncState<PaginationResult<FileStemMatch>>) => void,\n  ): () => void;\n  dispose(): void;\n}\n\n/** Framework-agnostic renderer client: shared status subscription and query watchers. */\nexport function createMediaCacheRenderer(\n  options?: CreateMediaCacheRendererOptions,\n): MediaCacheRenderer {\n  const bridge = resolveMediaCacheBridge(options);\n  const status = createMediaCacheStatusController(bridge, true);\n  const queryWatchers = new Set<MediaQueryWatcherInstance<unknown>>();\n\n  function addQueryWatcher<T>(instance: MediaQueryWatcherInstance<T>): () => void {\n    queryWatchers.add(instance as MediaQueryWatcherInstance<unknown>);\n    return () => {\n      queryWatchers.delete(instance as MediaQueryWatcherInstance<unknown>);\n      instance.dispose();\n    };\n  }\n\n  function subscribeCacheStatus(\n    listener: (state: MediaAsyncState<MediaCacheStatus>) => void,\n  ): () => void {\n    listener(status.getSnapshot());\n    return status.subscribe(() => {\n      listener(status.getSnapshot());\n    });\n  }\n\n  return {\n    bridge,\n    subscribeCacheStatus,\n    watchMediaAsset(key, queryOptions, listener) {\n      const refetch = queryOptions?.refetchOnSyncComplete ?? true;\n      const stableKey = typeof key === \"string\" ? key : key.join(\"\\0\");\n      const instance = createMediaQueryWatcherInstance({\n        status,\n        getLoader: () => () => bridge.getAsset(key),\n        refetchOnSyncComplete: refetch,\n        listener,\n      });\n      instance.syncDeps([bridge, \"asset\", stableKey]);\n      return addQueryWatcher(instance);\n    },\n    watchMediaByIndex(indexName, value, listOptions, listener) {\n      const cursor = listOptions?.cursor;\n      const limit = listOptions?.limit;\n      const refetchOnSyncComplete = listOptions?.refetchOnSyncComplete;\n      const refetch = refetchOnSyncComplete ?? true;\n      const instance = createMediaQueryWatcherInstance({\n        status,\n        getLoader: () => () => bridge.listByIndex(indexName, value, { cursor, limit }),\n        refetchOnSyncComplete: refetch,\n        listener,\n      });\n      instance.syncDeps([bridge, \"index\", indexName, value, cursor, limit]);\n      return addQueryWatcher(instance);\n    },\n    watchFileStemMatch(stem, stemOptions, listener) {\n      const cursor = stemOptions?.cursor;\n      const limit = stemOptions?.limit;\n      const refetch = stemOptions?.refetchOnSyncComplete ?? true;\n      const instance = createMediaQueryWatcherInstance({\n        status,\n        getLoader: () => () => bridge.findByFileStem(stem, { cursor, limit }),\n        refetchOnSyncComplete: refetch,\n        listener,\n      });\n      instance.syncDeps([bridge, \"fileStem\", stem, cursor, limit]);\n      return addQueryWatcher(instance);\n    },\n    dispose() {\n      for (const watcher of queryWatchers) {\n        watcher.dispose();\n      }\n      queryWatchers.clear();\n      status.dispose();\n    },\n  };\n}\n"],"mappings":"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"}

package/dist/renderer/runtime.d.cts

@@ -0,0 +1,35 @@
+import { AssetKeyInput, FileStemMatch, MediaCacheBridge, MediaCachePhase, MediaCacheStatus, MediaQuerySyncOptions, PaginationInput, PaginationResult, ResolvedMediaAsset } from "../shared/types.cjs";
+
+//#region src/renderer/runtime.d.ts
+/** Async snapshot aligned with React hooks (`useMedia`, `useMediaCacheStatus`, etc.). */
+interface MediaAsyncState<T> {
+  /** Latest resolved value, or `null` while loading/when unavailable. */
+  data: T | null;
+  /** `true` while an initial load or `refresh()` request is in flight. */
+  loading: boolean;
+  /** Last request error, or `null` when the latest request succeeded. */
+  error: Error | null;
+  /** Re-runs the underlying query and updates `data`/`error`. */
+  refresh: () => Promise<void>;
+}
+declare const MISSING_BRIDGE_ERROR = "MediaCache bridge is unavailable. Wrap your app in <MediaCacheProvider> or expose the preload bridge on window.mediaCache.";
+declare function deriveMediaCachePhase(status: MediaAsyncState<MediaCacheStatus>): MediaCachePhase;
+declare function resolveMediaCacheBridge(options?: {
+  bridge?: MediaCacheBridge;
+  windowKey?: string;
+}): MediaCacheBridge;
+interface CreateMediaCacheRendererOptions {
+  bridge?: MediaCacheBridge;
+  windowKey?: string;
+}
+interface MediaCacheRenderer {
+  bridge: MediaCacheBridge;
+  subscribeCacheStatus(listener: (state: MediaAsyncState<MediaCacheStatus>) => void): () => void;
+  watchMediaAsset(key: AssetKeyInput, options: MediaQuerySyncOptions | undefined, listener: (state: MediaAsyncState<ResolvedMediaAsset | null>) => void): () => void;
+  watchMediaByIndex(indexName: string, value: string, options: (PaginationInput & MediaQuerySyncOptions) | undefined, listener: (state: MediaAsyncState<PaginationResult<ResolvedMediaAsset>>) => void): () => void;
+  watchFileStemMatch(stem: string, options: (PaginationInput & MediaQuerySyncOptions) | undefined, listener: (state: MediaAsyncState<PaginationResult<FileStemMatch>>) => void): () => void;
+  dispose(): void;
+}
+//#endregion
+export { CreateMediaCacheRendererOptions, MISSING_BRIDGE_ERROR, MediaAsyncState, MediaCacheRenderer, deriveMediaCachePhase, resolveMediaCacheBridge };
+//# sourceMappingURL=runtime.d.cts.map

package/dist/renderer/runtime.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.d.cts","names":[],"sources":["../../src/renderer/runtime.ts"],"mappings":";;;;UAaiB,eAAA;EAAA;EAEf,IAAA,EAAM,CAAA;EAFwB;EAI9B,OAAA;EAEO;EAAP,KAAA,EAAO,KAAA;EAEe;EAAtB,OAAA,QAAe,OAAA;AAAA;AAAA,cAGJ,oBAAA;AAAA,iBAOG,qBAAA,CAAsB,MAAA,EAAQ,eAAA,CAAgB,gBAAA,IAAoB,eAAA;AAAA,iBAIlE,uBAAA,CAAwB,OAAA;EACtC,MAAA,GAAS,gBAAA;EACT,SAAA;AAAA,IACE,gBAAA;AAAA,UA+Qa,+BAAA;EACf,MAAA,GAAS,gBAAA;EACT,SAAA;AAAA;AAAA,UAGe,kBAAA;EACf,MAAA,EAAQ,gBAAA;EACR,oBAAA,CAAqB,QAAA,GAAW,KAAA,EAAO,eAAA,CAAgB,gBAAA;EACvD,eAAA,CACE,GAAA,EAAK,aAAA,EACL,OAAA,EAAS,qBAAA,cACT,QAAA,GAAW,KAAA,EAAO,eAAA,CAAgB,kBAAA;EAEpC,iBAAA,CACE,SAAA,UACA,KAAA,UACA,OAAA,GAAU,eAAA,GAAkB,qBAAA,eAC5B,QAAA,GAAW,KAAA,EAAO,eAAA,CAAgB,gBAAA,CAAiB,kBAAA;EAErD,kBAAA,CACE,IAAA,UACA,OAAA,GAAU,eAAA,GAAkB,qBAAA,eAC5B,QAAA,GAAW,KAAA,EAAO,eAAA,CAAgB,gBAAA,CAAiB,aAAA;EAErD,OAAA;AAAA"}

package/dist/renderer/runtime.d.ts

@@ -0,0 +1,35 @@
+import { AssetKeyInput, FileStemMatch, MediaCacheBridge, MediaCachePhase, MediaCacheStatus, MediaQuerySyncOptions, PaginationInput, PaginationResult, ResolvedMediaAsset } from "../shared/types.js";
+
+//#region src/renderer/runtime.d.ts
+/** Async snapshot aligned with React hooks (`useMedia`, `useMediaCacheStatus`, etc.). */
+interface MediaAsyncState<T> {
+  /** Latest resolved value, or `null` while loading/when unavailable. */
+  data: T | null;
+  /** `true` while an initial load or `refresh()` request is in flight. */
+  loading: boolean;
+  /** Last request error, or `null` when the latest request succeeded. */
+  error: Error | null;
+  /** Re-runs the underlying query and updates `data`/`error`. */
+  refresh: () => Promise<void>;
+}
+declare const MISSING_BRIDGE_ERROR = "MediaCache bridge is unavailable. Wrap your app in <MediaCacheProvider> or expose the preload bridge on window.mediaCache.";
+declare function deriveMediaCachePhase(status: MediaAsyncState<MediaCacheStatus>): MediaCachePhase;
+declare function resolveMediaCacheBridge(options?: {
+  bridge?: MediaCacheBridge;
+  windowKey?: string;
+}): MediaCacheBridge;
+interface CreateMediaCacheRendererOptions {
+  bridge?: MediaCacheBridge;
+  windowKey?: string;
+}
+interface MediaCacheRenderer {
+  bridge: MediaCacheBridge;
+  subscribeCacheStatus(listener: (state: MediaAsyncState<MediaCacheStatus>) => void): () => void;
+  watchMediaAsset(key: AssetKeyInput, options: MediaQuerySyncOptions | undefined, listener: (state: MediaAsyncState<ResolvedMediaAsset | null>) => void): () => void;
+  watchMediaByIndex(indexName: string, value: string, options: (PaginationInput & MediaQuerySyncOptions) | undefined, listener: (state: MediaAsyncState<PaginationResult<ResolvedMediaAsset>>) => void): () => void;
+  watchFileStemMatch(stem: string, options: (PaginationInput & MediaQuerySyncOptions) | undefined, listener: (state: MediaAsyncState<PaginationResult<FileStemMatch>>) => void): () => void;
+  dispose(): void;
+}
+//#endregion
+export { CreateMediaCacheRendererOptions, MISSING_BRIDGE_ERROR, MediaAsyncState, MediaCacheRenderer, deriveMediaCachePhase, resolveMediaCacheBridge };
+//# sourceMappingURL=runtime.d.ts.map

package/dist/renderer/runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.d.ts","names":[],"sources":["../../src/renderer/runtime.ts"],"mappings":";;;;UAaiB,eAAA;EAAA;EAEf,IAAA,EAAM,CAAA;EAFwB;EAI9B,OAAA;EAEO;EAAP,KAAA,EAAO,KAAA;EAEe;EAAtB,OAAA,QAAe,OAAA;AAAA;AAAA,cAGJ,oBAAA;AAAA,iBAOG,qBAAA,CAAsB,MAAA,EAAQ,eAAA,CAAgB,gBAAA,IAAoB,eAAA;AAAA,iBAIlE,uBAAA,CAAwB,OAAA;EACtC,MAAA,GAAS,gBAAA;EACT,SAAA;AAAA,IACE,gBAAA;AAAA,UA+Qa,+BAAA;EACf,MAAA,GAAS,gBAAA;EACT,SAAA;AAAA;AAAA,UAGe,kBAAA;EACf,MAAA,EAAQ,gBAAA;EACR,oBAAA,CAAqB,QAAA,GAAW,KAAA,EAAO,eAAA,CAAgB,gBAAA;EACvD,eAAA,CACE,GAAA,EAAK,aAAA,EACL,OAAA,EAAS,qBAAA,cACT,QAAA,GAAW,KAAA,EAAO,eAAA,CAAgB,kBAAA;EAEpC,iBAAA,CACE,SAAA,UACA,KAAA,UACA,OAAA,GAAU,eAAA,GAAkB,qBAAA,eAC5B,QAAA,GAAW,KAAA,EAAO,eAAA,CAAgB,gBAAA,CAAiB,kBAAA;EAErD,kBAAA,CACE,IAAA,UACA,OAAA,GAAU,eAAA,GAAkB,qBAAA,eAC5B,QAAA,GAAW,KAAA,EAAO,eAAA,CAAgB,gBAAA,CAAiB,aAAA;EAErD,OAAA;AAAA"}