@rockhall/electron-offline-content 0.4.0

package/dist/renderer/runtime.js

@@ -0,0 +1,273 @@
+//#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
+export { MISSING_BRIDGE_ERROR, createMediaCacheRenderer, createMediaCacheStatusController, createMediaQueryWatcherInstance, deriveMediaCachePhase, resolveMediaCacheBridge };
+
+//# sourceMappingURL=runtime.js.map

package/dist/renderer/runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.js","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/window-globals.d.cts

@@ -0,0 +1,9 @@
+import { MediaCacheBridge } from "../shared/types.cjs";
+
+//#region src/renderer/window-globals.d.ts
+declare global {
+  interface Window {
+    mediaCache?: MediaCacheBridge;
+  }
+}
+//# sourceMappingURL=window-globals.d.cts.map

package/dist/renderer/window-globals.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"window-globals.d.cts","names":[],"sources":["../../src/renderer/window-globals.ts"],"mappings":";;;QAEQ,MAAA;EAAA,UACI,MAAA;IACR,UAAA,GAAa,gBAAA;EAAA;AAAA"}

package/dist/renderer/window-globals.d.ts

@@ -0,0 +1,9 @@
+import { MediaCacheBridge } from "../shared/types.js";
+
+//#region src/renderer/window-globals.d.ts
+declare global {
+  interface Window {
+    mediaCache?: MediaCacheBridge;
+  }
+}
+//# sourceMappingURL=window-globals.d.ts.map

package/dist/renderer/window-globals.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"window-globals.d.ts","names":[],"sources":["../../src/renderer/window-globals.ts"],"mappings":";;;QAEQ,MAAA;EAAA,UACI,MAAA;IACR,UAAA,GAAa,gBAAA;EAAA;AAAA"}

package/dist/shared/errors.cjs

@@ -0,0 +1,102 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+//#region src/shared/errors.ts
+/**
+* Base class for cache errors; use `code` for stable programmatic handling.
+* @param message - Human-readable error description.
+* @param code - Machine-readable error code for branching (for example `SYNC_FAILURE`).
+* @param options - Standard `ErrorOptions` (e.g. `{ cause }`).
+*/
+var MediaCacheError = class extends Error {
+	code;
+	constructor(message, code, options) {
+		super(message, options);
+		this.code = code;
+		this.name = "MediaCacheError";
+	}
+};
+/** Store from `resolveStore` is missing or inconsistent (indexes, assets, or structure). */
+var StoreValidationError = class extends MediaCacheError {
+	constructor(message) {
+		super(message, "STORE_VALIDATION_ERROR");
+		this.name = "StoreValidationError";
+	}
+};
+/** Store-derived URLs have passed their declared expiration time and must not be downloaded. */
+var StoreExpiredError = class extends MediaCacheError {
+	constructor(message, options) {
+		super(message, "STORE_EXPIRED", options);
+		this.name = "StoreExpiredError";
+	}
+};
+/** Another process or cache instance already owns the configured storage root. */
+var StorageOwnershipError = class extends MediaCacheError {
+	constructor(message, options) {
+		super(message, "STORAGE_OWNERSHIP_ERROR", options);
+		this.name = "StorageOwnershipError";
+	}
+};
+/**
+* Cache would exceed `maxCacheBytes`, violate `reserveFreeBytes`, disk is full (`ENOSPC`), or a
+* commit would leave insufficient free space.
+*/
+var StorageLimitError = class extends MediaCacheError {
+	constructor(message, options) {
+		super(message, "STORAGE_LIMIT_ERROR", options);
+		this.name = "StorageLimitError";
+	}
+};
+/** Persisted state on disk fails validation (for example a corrupt status snapshot). */
+var DataValidationError = class extends MediaCacheError {
+	constructor(message, options) {
+		super(message, "DATA_VALIDATION_ERROR", options);
+		this.name = "DataValidationError";
+	}
+};
+/** Network or HTTP failure while downloading an asset during sync (may be retryable internally). */
+var SyncFailureError = class extends MediaCacheError {
+	constructor(message, options) {
+		super(message, "SYNC_FAILURE", options);
+		this.name = "SyncFailureError";
+	}
+};
+function toSerializedError(error) {
+	if (error instanceof MediaCacheError) return {
+		name: error.name,
+		code: error.code,
+		message: error.message
+	};
+	if (error instanceof Error) return {
+		name: error.name,
+		code: "UNKNOWN_ERROR",
+		message: error.message
+	};
+	return {
+		name: "UnknownError",
+		code: "UNKNOWN_ERROR",
+		message: String(error)
+	};
+}
+function isNoSpaceError(error) {
+	return error instanceof Error && collectErrorChain(error).some((entry) => "code" in entry && entry.code === "ENOSPC");
+}
+function collectErrorChain(error) {
+	const chain = [];
+	let current = error;
+	while (current instanceof Error && !chain.includes(current)) {
+		chain.push(current);
+		current = current.cause;
+	}
+	return chain;
+}
+//#endregion
+exports.DataValidationError = DataValidationError;
+exports.MediaCacheError = MediaCacheError;
+exports.StorageLimitError = StorageLimitError;
+exports.StorageOwnershipError = StorageOwnershipError;
+exports.StoreExpiredError = StoreExpiredError;
+exports.StoreValidationError = StoreValidationError;
+exports.SyncFailureError = SyncFailureError;
+exports.isNoSpaceError = isNoSpaceError;
+exports.toSerializedError = toSerializedError;
+
+//# sourceMappingURL=errors.cjs.map

package/dist/shared/errors.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.cjs","names":[],"sources":["../../src/shared/errors.ts"],"sourcesContent":["import type { SerializedMediaCacheError } from \"./types.js\";\n\n/**\n * Base class for cache errors; use `code` for stable programmatic handling.\n * @param message - Human-readable error description.\n * @param code - Machine-readable error code for branching (for example `SYNC_FAILURE`).\n * @param options - Standard `ErrorOptions` (e.g. `{ cause }`).\n */\nexport class MediaCacheError extends Error {\n  constructor(\n    message: string,\n    public readonly code: string,\n    options?: ErrorOptions,\n  ) {\n    super(message, options);\n    this.name = \"MediaCacheError\";\n  }\n}\n\n/** Store from `resolveStore` is missing or inconsistent (indexes, assets, or structure). */\nexport class StoreValidationError extends MediaCacheError {\n  constructor(message: string) {\n    super(message, \"STORE_VALIDATION_ERROR\");\n    this.name = \"StoreValidationError\";\n  }\n}\n\n/** Store-derived URLs have passed their declared expiration time and must not be downloaded. */\nexport class StoreExpiredError extends MediaCacheError {\n  constructor(message: string, options?: ErrorOptions) {\n    super(message, \"STORE_EXPIRED\", options);\n    this.name = \"StoreExpiredError\";\n  }\n}\n\n/** Another process or cache instance already owns the configured storage root. */\nexport class StorageOwnershipError extends MediaCacheError {\n  constructor(message: string, options?: ErrorOptions) {\n    super(message, \"STORAGE_OWNERSHIP_ERROR\", options);\n    this.name = \"StorageOwnershipError\";\n  }\n}\n\n/**\n * Cache would exceed `maxCacheBytes`, violate `reserveFreeBytes`, disk is full (`ENOSPC`), or a\n * commit would leave insufficient free space.\n */\nexport class StorageLimitError extends MediaCacheError {\n  constructor(message: string, options?: ErrorOptions) {\n    super(message, \"STORAGE_LIMIT_ERROR\", options);\n    this.name = \"StorageLimitError\";\n  }\n}\n\n/** Persisted state on disk fails validation (for example a corrupt status snapshot). */\nexport class DataValidationError extends MediaCacheError {\n  constructor(message: string, options?: ErrorOptions) {\n    super(message, \"DATA_VALIDATION_ERROR\", options);\n    this.name = \"DataValidationError\";\n  }\n}\n\n/** Network or HTTP failure while downloading an asset during sync (may be retryable internally). */\nexport class SyncFailureError extends MediaCacheError {\n  constructor(message: string, options?: ErrorOptions) {\n    super(message, \"SYNC_FAILURE\", options);\n    this.name = \"SyncFailureError\";\n  }\n}\n\nexport function toSerializedError(error: unknown): SerializedMediaCacheError {\n  if (error instanceof MediaCacheError) {\n    return {\n      name: error.name,\n      code: error.code,\n      message: error.message,\n    };\n  }\n\n  if (error instanceof Error) {\n    return {\n      name: error.name,\n      code: \"UNKNOWN_ERROR\",\n      message: error.message,\n    };\n  }\n\n  return {\n    name: \"UnknownError\",\n    code: \"UNKNOWN_ERROR\",\n    message: String(error),\n  };\n}\n\nexport function isNoSpaceError(error: unknown): boolean {\n  return (\n    error instanceof Error &&\n    collectErrorChain(error).some(\n      (entry) => \"code\" in entry && (entry as NodeJS.ErrnoException).code === \"ENOSPC\",\n    )\n  );\n}\n\nfunction collectErrorChain(error: Error): Error[] {\n  const chain: Error[] = [];\n  let current: unknown = error;\n\n  while (current instanceof Error && !chain.includes(current)) {\n    chain.push(current);\n    current = current.cause;\n  }\n\n  return chain;\n}\n"],"mappings":";;;;;;;;AAQA,IAAa,kBAAb,cAAqC,MAAM;CAGvB;CAFlB,YACE,SACA,MACA,SACA;EACA,MAAM,SAAS,QAAQ;EAHP,KAAA,OAAA;EAIhB,KAAK,OAAO;;;;AAKhB,IAAa,uBAAb,cAA0C,gBAAgB;CACxD,YAAY,SAAiB;EAC3B,MAAM,SAAS,yBAAyB;EACxC,KAAK,OAAO;;;;AAKhB,IAAa,oBAAb,cAAuC,gBAAgB;CACrD,YAAY,SAAiB,SAAwB;EACnD,MAAM,SAAS,iBAAiB,QAAQ;EACxC,KAAK,OAAO;;;;AAKhB,IAAa,wBAAb,cAA2C,gBAAgB;CACzD,YAAY,SAAiB,SAAwB;EACnD,MAAM,SAAS,2BAA2B,QAAQ;EAClD,KAAK,OAAO;;;;;;;AAQhB,IAAa,oBAAb,cAAuC,gBAAgB;CACrD,YAAY,SAAiB,SAAwB;EACnD,MAAM,SAAS,uBAAuB,QAAQ;EAC9C,KAAK,OAAO;;;;AAKhB,IAAa,sBAAb,cAAyC,gBAAgB;CACvD,YAAY,SAAiB,SAAwB;EACnD,MAAM,SAAS,yBAAyB,QAAQ;EAChD,KAAK,OAAO;;;;AAKhB,IAAa,mBAAb,cAAsC,gBAAgB;CACpD,YAAY,SAAiB,SAAwB;EACnD,MAAM,SAAS,gBAAgB,QAAQ;EACvC,KAAK,OAAO;;;AAIhB,SAAgB,kBAAkB,OAA2C;CAC3E,IAAI,iBAAiB,iBACnB,OAAO;EACL,MAAM,MAAM;EACZ,MAAM,MAAM;EACZ,SAAS,MAAM;EAChB;CAGH,IAAI,iBAAiB,OACnB,OAAO;EACL,MAAM,MAAM;EACZ,MAAM;EACN,SAAS,MAAM;EAChB;CAGH,OAAO;EACL,MAAM;EACN,MAAM;EACN,SAAS,OAAO,MAAM;EACvB;;AAGH,SAAgB,eAAe,OAAyB;CACtD,OACE,iBAAiB,SACjB,kBAAkB,MAAM,CAAC,MACtB,UAAU,UAAU,SAAU,MAAgC,SAAS,SACzE;;AAIL,SAAS,kBAAkB,OAAuB;CAChD,MAAM,QAAiB,EAAE;CACzB,IAAI,UAAmB;CAEvB,OAAO,mBAAmB,SAAS,CAAC,MAAM,SAAS,QAAQ,EAAE;EAC3D,MAAM,KAAK,QAAQ;EACnB,UAAU,QAAQ;;CAGpB,OAAO"}

package/dist/shared/errors.d.cts

@@ -0,0 +1,45 @@
+import { SerializedMediaCacheError } from "./types.cjs";
+
+//#region src/shared/errors.d.ts
+/**
+ * Base class for cache errors; use `code` for stable programmatic handling.
+ * @param message - Human-readable error description.
+ * @param code - Machine-readable error code for branching (for example `SYNC_FAILURE`).
+ * @param options - Standard `ErrorOptions` (e.g. `{ cause }`).
+ */
+declare class MediaCacheError extends Error {
+  readonly code: string;
+  constructor(message: string, code: string, options?: ErrorOptions);
+}
+/** Store from `resolveStore` is missing or inconsistent (indexes, assets, or structure). */
+declare class StoreValidationError extends MediaCacheError {
+  constructor(message: string);
+}
+/** Store-derived URLs have passed their declared expiration time and must not be downloaded. */
+declare class StoreExpiredError extends MediaCacheError {
+  constructor(message: string, options?: ErrorOptions);
+}
+/** Another process or cache instance already owns the configured storage root. */
+declare class StorageOwnershipError extends MediaCacheError {
+  constructor(message: string, options?: ErrorOptions);
+}
+/**
+ * Cache would exceed `maxCacheBytes`, violate `reserveFreeBytes`, disk is full (`ENOSPC`), or a
+ * commit would leave insufficient free space.
+ */
+declare class StorageLimitError extends MediaCacheError {
+  constructor(message: string, options?: ErrorOptions);
+}
+/** Persisted state on disk fails validation (for example a corrupt status snapshot). */
+declare class DataValidationError extends MediaCacheError {
+  constructor(message: string, options?: ErrorOptions);
+}
+/** Network or HTTP failure while downloading an asset during sync (may be retryable internally). */
+declare class SyncFailureError extends MediaCacheError {
+  constructor(message: string, options?: ErrorOptions);
+}
+declare function toSerializedError(error: unknown): SerializedMediaCacheError;
+declare function isNoSpaceError(error: unknown): boolean;
+//#endregion
+export { DataValidationError, MediaCacheError, StorageLimitError, StorageOwnershipError, StoreExpiredError, StoreValidationError, SyncFailureError, isNoSpaceError, toSerializedError };
+//# sourceMappingURL=errors.d.cts.map

package/dist/shared/errors.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.cts","names":[],"sources":["../../src/shared/errors.ts"],"mappings":";;;;;AAQA;;;;cAAa,eAAA,SAAwB,KAAA;EAAA,SAGjB,IAAA;cADhB,OAAA,UACgB,IAAA,UAChB,OAAA,GAAU,YAAA;AAAA;;cAQD,oBAAA,SAA6B,eAAA;cAC5B,OAAA;AAAA;;cAOD,iBAAA,SAA0B,eAAA;cACzB,OAAA,UAAiB,OAAA,GAAU,YAAA;AAAA;;cAO5B,qBAAA,SAA8B,eAAA;cAC7B,OAAA,UAAiB,OAAA,GAAU,YAAA;AAAA;;;AATzC;;cAmBa,iBAAA,SAA0B,eAAA;cACzB,OAAA,UAAiB,OAAA,GAAU,YAAA;AAAA;;cAO5B,mBAAA,SAA4B,eAAA;cAC3B,OAAA,UAAiB,OAAA,GAAU,YAAA;AAAA;;cAO5B,gBAAA,SAAyB,eAAA;cACxB,OAAA,UAAiB,OAAA,GAAU,YAAA;AAAA;AAAA,iBAMzB,iBAAA,CAAkB,KAAA,YAAiB,yBAAA;AAAA,iBAwBnC,cAAA,CAAe,KAAA"}

package/dist/shared/errors.d.ts

@@ -0,0 +1,45 @@
+import { SerializedMediaCacheError } from "./types.js";
+
+//#region src/shared/errors.d.ts
+/**
+ * Base class for cache errors; use `code` for stable programmatic handling.
+ * @param message - Human-readable error description.
+ * @param code - Machine-readable error code for branching (for example `SYNC_FAILURE`).
+ * @param options - Standard `ErrorOptions` (e.g. `{ cause }`).
+ */
+declare class MediaCacheError extends Error {
+  readonly code: string;
+  constructor(message: string, code: string, options?: ErrorOptions);
+}
+/** Store from `resolveStore` is missing or inconsistent (indexes, assets, or structure). */
+declare class StoreValidationError extends MediaCacheError {
+  constructor(message: string);
+}
+/** Store-derived URLs have passed their declared expiration time and must not be downloaded. */
+declare class StoreExpiredError extends MediaCacheError {
+  constructor(message: string, options?: ErrorOptions);
+}
+/** Another process or cache instance already owns the configured storage root. */
+declare class StorageOwnershipError extends MediaCacheError {
+  constructor(message: string, options?: ErrorOptions);
+}
+/**
+ * Cache would exceed `maxCacheBytes`, violate `reserveFreeBytes`, disk is full (`ENOSPC`), or a
+ * commit would leave insufficient free space.
+ */
+declare class StorageLimitError extends MediaCacheError {
+  constructor(message: string, options?: ErrorOptions);
+}
+/** Persisted state on disk fails validation (for example a corrupt status snapshot). */
+declare class DataValidationError extends MediaCacheError {
+  constructor(message: string, options?: ErrorOptions);
+}
+/** Network or HTTP failure while downloading an asset during sync (may be retryable internally). */
+declare class SyncFailureError extends MediaCacheError {
+  constructor(message: string, options?: ErrorOptions);
+}
+declare function toSerializedError(error: unknown): SerializedMediaCacheError;
+declare function isNoSpaceError(error: unknown): boolean;
+//#endregion
+export { DataValidationError, MediaCacheError, StorageLimitError, StorageOwnershipError, StoreExpiredError, StoreValidationError, SyncFailureError, isNoSpaceError, toSerializedError };
+//# sourceMappingURL=errors.d.ts.map

package/dist/shared/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","names":[],"sources":["../../src/shared/errors.ts"],"mappings":";;;;;AAQA;;;;cAAa,eAAA,SAAwB,KAAA;EAAA,SAGjB,IAAA;cADhB,OAAA,UACgB,IAAA,UAChB,OAAA,GAAU,YAAA;AAAA;;cAQD,oBAAA,SAA6B,eAAA;cAC5B,OAAA;AAAA;;cAOD,iBAAA,SAA0B,eAAA;cACzB,OAAA,UAAiB,OAAA,GAAU,YAAA;AAAA;;cAO5B,qBAAA,SAA8B,eAAA;cAC7B,OAAA,UAAiB,OAAA,GAAU,YAAA;AAAA;;;AATzC;;cAmBa,iBAAA,SAA0B,eAAA;cACzB,OAAA,UAAiB,OAAA,GAAU,YAAA;AAAA;;cAO5B,mBAAA,SAA4B,eAAA;cAC3B,OAAA,UAAiB,OAAA,GAAU,YAAA;AAAA;;cAO5B,gBAAA,SAAyB,eAAA;cACxB,OAAA,UAAiB,OAAA,GAAU,YAAA;AAAA;AAAA,iBAMzB,iBAAA,CAAkB,KAAA,YAAiB,yBAAA;AAAA,iBAwBnC,cAAA,CAAe,KAAA"}

package/dist/shared/errors.js

@@ -0,0 +1,93 @@
+//#region src/shared/errors.ts
+/**
+* Base class for cache errors; use `code` for stable programmatic handling.
+* @param message - Human-readable error description.
+* @param code - Machine-readable error code for branching (for example `SYNC_FAILURE`).
+* @param options - Standard `ErrorOptions` (e.g. `{ cause }`).
+*/
+var MediaCacheError = class extends Error {
+	code;
+	constructor(message, code, options) {
+		super(message, options);
+		this.code = code;
+		this.name = "MediaCacheError";
+	}
+};
+/** Store from `resolveStore` is missing or inconsistent (indexes, assets, or structure). */
+var StoreValidationError = class extends MediaCacheError {
+	constructor(message) {
+		super(message, "STORE_VALIDATION_ERROR");
+		this.name = "StoreValidationError";
+	}
+};
+/** Store-derived URLs have passed their declared expiration time and must not be downloaded. */
+var StoreExpiredError = class extends MediaCacheError {
+	constructor(message, options) {
+		super(message, "STORE_EXPIRED", options);
+		this.name = "StoreExpiredError";
+	}
+};
+/** Another process or cache instance already owns the configured storage root. */
+var StorageOwnershipError = class extends MediaCacheError {
+	constructor(message, options) {
+		super(message, "STORAGE_OWNERSHIP_ERROR", options);
+		this.name = "StorageOwnershipError";
+	}
+};
+/**
+* Cache would exceed `maxCacheBytes`, violate `reserveFreeBytes`, disk is full (`ENOSPC`), or a
+* commit would leave insufficient free space.
+*/
+var StorageLimitError = class extends MediaCacheError {
+	constructor(message, options) {
+		super(message, "STORAGE_LIMIT_ERROR", options);
+		this.name = "StorageLimitError";
+	}
+};
+/** Persisted state on disk fails validation (for example a corrupt status snapshot). */
+var DataValidationError = class extends MediaCacheError {
+	constructor(message, options) {
+		super(message, "DATA_VALIDATION_ERROR", options);
+		this.name = "DataValidationError";
+	}
+};
+/** Network or HTTP failure while downloading an asset during sync (may be retryable internally). */
+var SyncFailureError = class extends MediaCacheError {
+	constructor(message, options) {
+		super(message, "SYNC_FAILURE", options);
+		this.name = "SyncFailureError";
+	}
+};
+function toSerializedError(error) {
+	if (error instanceof MediaCacheError) return {
+		name: error.name,
+		code: error.code,
+		message: error.message
+	};
+	if (error instanceof Error) return {
+		name: error.name,
+		code: "UNKNOWN_ERROR",
+		message: error.message
+	};
+	return {
+		name: "UnknownError",
+		code: "UNKNOWN_ERROR",
+		message: String(error)
+	};
+}
+function isNoSpaceError(error) {
+	return error instanceof Error && collectErrorChain(error).some((entry) => "code" in entry && entry.code === "ENOSPC");
+}
+function collectErrorChain(error) {
+	const chain = [];
+	let current = error;
+	while (current instanceof Error && !chain.includes(current)) {
+		chain.push(current);
+		current = current.cause;
+	}
+	return chain;
+}
+//#endregion
+export { DataValidationError, MediaCacheError, StorageLimitError, StorageOwnershipError, StoreExpiredError, StoreValidationError, SyncFailureError, isNoSpaceError, toSerializedError };
+
+//# sourceMappingURL=errors.js.map

package/dist/shared/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","names":[],"sources":["../../src/shared/errors.ts"],"sourcesContent":["import type { SerializedMediaCacheError } from \"./types.js\";\n\n/**\n * Base class for cache errors; use `code` for stable programmatic handling.\n * @param message - Human-readable error description.\n * @param code - Machine-readable error code for branching (for example `SYNC_FAILURE`).\n * @param options - Standard `ErrorOptions` (e.g. `{ cause }`).\n */\nexport class MediaCacheError extends Error {\n  constructor(\n    message: string,\n    public readonly code: string,\n    options?: ErrorOptions,\n  ) {\n    super(message, options);\n    this.name = \"MediaCacheError\";\n  }\n}\n\n/** Store from `resolveStore` is missing or inconsistent (indexes, assets, or structure). */\nexport class StoreValidationError extends MediaCacheError {\n  constructor(message: string) {\n    super(message, \"STORE_VALIDATION_ERROR\");\n    this.name = \"StoreValidationError\";\n  }\n}\n\n/** Store-derived URLs have passed their declared expiration time and must not be downloaded. */\nexport class StoreExpiredError extends MediaCacheError {\n  constructor(message: string, options?: ErrorOptions) {\n    super(message, \"STORE_EXPIRED\", options);\n    this.name = \"StoreExpiredError\";\n  }\n}\n\n/** Another process or cache instance already owns the configured storage root. */\nexport class StorageOwnershipError extends MediaCacheError {\n  constructor(message: string, options?: ErrorOptions) {\n    super(message, \"STORAGE_OWNERSHIP_ERROR\", options);\n    this.name = \"StorageOwnershipError\";\n  }\n}\n\n/**\n * Cache would exceed `maxCacheBytes`, violate `reserveFreeBytes`, disk is full (`ENOSPC`), or a\n * commit would leave insufficient free space.\n */\nexport class StorageLimitError extends MediaCacheError {\n  constructor(message: string, options?: ErrorOptions) {\n    super(message, \"STORAGE_LIMIT_ERROR\", options);\n    this.name = \"StorageLimitError\";\n  }\n}\n\n/** Persisted state on disk fails validation (for example a corrupt status snapshot). */\nexport class DataValidationError extends MediaCacheError {\n  constructor(message: string, options?: ErrorOptions) {\n    super(message, \"DATA_VALIDATION_ERROR\", options);\n    this.name = \"DataValidationError\";\n  }\n}\n\n/** Network or HTTP failure while downloading an asset during sync (may be retryable internally). */\nexport class SyncFailureError extends MediaCacheError {\n  constructor(message: string, options?: ErrorOptions) {\n    super(message, \"SYNC_FAILURE\", options);\n    this.name = \"SyncFailureError\";\n  }\n}\n\nexport function toSerializedError(error: unknown): SerializedMediaCacheError {\n  if (error instanceof MediaCacheError) {\n    return {\n      name: error.name,\n      code: error.code,\n      message: error.message,\n    };\n  }\n\n  if (error instanceof Error) {\n    return {\n      name: error.name,\n      code: \"UNKNOWN_ERROR\",\n      message: error.message,\n    };\n  }\n\n  return {\n    name: \"UnknownError\",\n    code: \"UNKNOWN_ERROR\",\n    message: String(error),\n  };\n}\n\nexport function isNoSpaceError(error: unknown): boolean {\n  return (\n    error instanceof Error &&\n    collectErrorChain(error).some(\n      (entry) => \"code\" in entry && (entry as NodeJS.ErrnoException).code === \"ENOSPC\",\n    )\n  );\n}\n\nfunction collectErrorChain(error: Error): Error[] {\n  const chain: Error[] = [];\n  let current: unknown = error;\n\n  while (current instanceof Error && !chain.includes(current)) {\n    chain.push(current);\n    current = current.cause;\n  }\n\n  return chain;\n}\n"],"mappings":";;;;;;;AAQA,IAAa,kBAAb,cAAqC,MAAM;CAGvB;CAFlB,YACE,SACA,MACA,SACA;EACA,MAAM,SAAS,QAAQ;EAHP,KAAA,OAAA;EAIhB,KAAK,OAAO;;;;AAKhB,IAAa,uBAAb,cAA0C,gBAAgB;CACxD,YAAY,SAAiB;EAC3B,MAAM,SAAS,yBAAyB;EACxC,KAAK,OAAO;;;;AAKhB,IAAa,oBAAb,cAAuC,gBAAgB;CACrD,YAAY,SAAiB,SAAwB;EACnD,MAAM,SAAS,iBAAiB,QAAQ;EACxC,KAAK,OAAO;;;;AAKhB,IAAa,wBAAb,cAA2C,gBAAgB;CACzD,YAAY,SAAiB,SAAwB;EACnD,MAAM,SAAS,2BAA2B,QAAQ;EAClD,KAAK,OAAO;;;;;;;AAQhB,IAAa,oBAAb,cAAuC,gBAAgB;CACrD,YAAY,SAAiB,SAAwB;EACnD,MAAM,SAAS,uBAAuB,QAAQ;EAC9C,KAAK,OAAO;;;;AAKhB,IAAa,sBAAb,cAAyC,gBAAgB;CACvD,YAAY,SAAiB,SAAwB;EACnD,MAAM,SAAS,yBAAyB,QAAQ;EAChD,KAAK,OAAO;;;;AAKhB,IAAa,mBAAb,cAAsC,gBAAgB;CACpD,YAAY,SAAiB,SAAwB;EACnD,MAAM,SAAS,gBAAgB,QAAQ;EACvC,KAAK,OAAO;;;AAIhB,SAAgB,kBAAkB,OAA2C;CAC3E,IAAI,iBAAiB,iBACnB,OAAO;EACL,MAAM,MAAM;EACZ,MAAM,MAAM;EACZ,SAAS,MAAM;EAChB;CAGH,IAAI,iBAAiB,OACnB,OAAO;EACL,MAAM,MAAM;EACZ,MAAM;EACN,SAAS,MAAM;EAChB;CAGH,OAAO;EACL,MAAM;EACN,MAAM;EACN,SAAS,OAAO,MAAM;EACvB;;AAGH,SAAgB,eAAe,OAAyB;CACtD,OACE,iBAAiB,SACjB,kBAAkB,MAAM,CAAC,MACtB,UAAU,UAAU,SAAU,MAAgC,SAAS,SACzE;;AAIL,SAAS,kBAAkB,OAAuB;CAChD,MAAM,QAAiB,EAAE;CACzB,IAAI,UAAmB;CAEvB,OAAO,mBAAmB,SAAS,CAAC,MAAM,SAAS,QAAQ,EAAE;EAC3D,MAAM,KAAK,QAAQ;EACnB,UAAU,QAAQ;;CAGpB,OAAO"}