@n-dx/web 0.1.0

package/dist/viewer/performance/memory-monitor.d.ts

@@ -0,0 +1,78 @@
+/**
+ * Client-side memory usage monitoring and early warning system.
+ *
+ * Tracks browser memory consumption in real-time, detects approaching
+ * memory limits, and triggers graceful degradation before OOM crashes.
+ *
+ * Uses `performance.memory` (Chrome/Edge) for precise readings and
+ * falls back to heuristic-based estimation on other browsers.
+ *
+ * Designed as a standalone module with zero framework dependencies —
+ * the Preact hook (`useMemoryMonitor`) is provided separately.
+ */
+/** Memory usage snapshot at a point in time. */
+export interface MemorySnapshot {
+    /** JS heap currently used (bytes). -1 if unavailable. */
+    usedJSHeapSize: number;
+    /** Total JS heap allocated by the browser (bytes). -1 if unavailable. */
+    totalJSHeapSize: number;
+    /** JS heap size limit (bytes). -1 if unavailable. */
+    jsHeapSizeLimit: number;
+    /** Usage ratio: usedJSHeapSize / jsHeapSizeLimit (0–1). -1 if unavailable. */
+    usageRatio: number;
+    /** Current warning level based on threshold configuration. */
+    level: MemoryLevel;
+    /** ISO timestamp of when this snapshot was taken. */
+    timestamp: string;
+    /** Whether precise memory data is available (Chrome/Edge only). */
+    precise: boolean;
+}
+/** Warning levels ordered by severity. */
+export type MemoryLevel = "normal" | "elevated" | "warning" | "critical";
+/** Threshold configuration for memory warning levels. */
+export interface MemoryThresholds {
+    /** Ratio above which level becomes "elevated" (default: 0.50). */
+    elevated: number;
+    /** Ratio above which level becomes "warning" (default: 0.70). */
+    warning: number;
+    /** Ratio above which level becomes "critical" (default: 0.85). */
+    critical: number;
+}
+/** Callback invoked when memory level changes. */
+export type MemoryLevelChangeHandler = (snapshot: MemorySnapshot, previousLevel: MemoryLevel) => void;
+/** Configuration for the memory monitor. */
+export interface MemoryMonitorConfig {
+    /** Polling interval in milliseconds (default: 5000). */
+    intervalMs: number;
+    /** Warning thresholds (ratios 0–1). */
+    thresholds: MemoryThresholds;
+    /** Called when the memory level changes (e.g. normal → warning). */
+    onLevelChange: MemoryLevelChangeHandler | null;
+}
+/** Check if the browser exposes precise memory metrics. */
+export declare function hasPerformanceMemory(): boolean;
+/** Determine the memory level for a given usage ratio. */
+export declare function classifyLevel(ratio: number, thresholds: MemoryThresholds): MemoryLevel;
+/** Take a memory snapshot using the best available API. */
+export declare function takeSnapshot(thresholds?: MemoryThresholds): MemorySnapshot;
+/** Format bytes as a human-readable string (e.g. "142.5 MB"). */
+export declare function formatBytes(bytes: number): string;
+/** Format a usage ratio as a percentage string (e.g. "72.3%"). */
+export declare function formatRatio(ratio: number): string;
+/** Subscribe to every new snapshot. Returns an unsubscribe function. */
+export declare function onSnapshot(listener: (snapshot: MemorySnapshot) => void): () => void;
+/**
+ * Start the memory monitor with the given configuration overrides.
+ * Safe to call multiple times — restarts with new config if already running.
+ */
+export declare function startMemoryMonitor(overrides?: Partial<MemoryMonitorConfig>): void;
+/** Stop the memory monitor and clean up. */
+export declare function stopMemoryMonitor(): void;
+/** Get the most recent memory snapshot, or null if the monitor has not run. */
+export declare function getLatestSnapshot(): MemorySnapshot | null;
+/** Get the snapshot history (up to MAX_HISTORY_LENGTH entries). */
+export declare function getSnapshotHistory(): readonly MemorySnapshot[];
+/** Get the current memory warning level. */
+export declare function getCurrentLevel(): MemoryLevel;
+/** Reset all module state (for testing). */
+export declare function resetMemoryMonitor(): void;

package/dist/viewer/performance/memory-monitor.js

@@ -0,0 +1,218 @@
+/**
+ * Client-side memory usage monitoring and early warning system.
+ *
+ * Tracks browser memory consumption in real-time, detects approaching
+ * memory limits, and triggers graceful degradation before OOM crashes.
+ *
+ * Uses `performance.memory` (Chrome/Edge) for precise readings and
+ * falls back to heuristic-based estimation on other browsers.
+ *
+ * Designed as a standalone module with zero framework dependencies —
+ * the Preact hook (`useMemoryMonitor`) is provided separately.
+ */
+import { registerPollingSource, } from "../polling/polling-state.js";
+// ─── Constants ───────────────────────────────────────────────────────────────
+const DEFAULT_THRESHOLDS = {
+    elevated: 0.50,
+    warning: 0.70,
+    critical: 0.85,
+};
+const DEFAULT_INTERVAL_MS = 5000;
+/** Key used to register with the centralized polling state manager. */
+const POLLING_STATE_KEY = "memory-monitor";
+/** Heuristic heap limit for browsers without performance.memory (2 GB). */
+const FALLBACK_HEAP_LIMIT = 2 * 1024 * 1024 * 1024;
+/** Maximum number of snapshots kept in history for debugging. */
+const MAX_HISTORY_LENGTH = 60;
+// ─── Module state ────────────────────────────────────────────────────────────
+let config = {
+    intervalMs: DEFAULT_INTERVAL_MS,
+    thresholds: { ...DEFAULT_THRESHOLDS },
+    onLevelChange: null,
+};
+let pollTimer = null;
+let stateUnsub = null;
+let currentLevel = "normal";
+let latestSnapshot = null;
+let snapshotHistory = [];
+let changeListeners = [];
+// ─── Detection ───────────────────────────────────────────────────────────────
+/** Check if the browser exposes precise memory metrics. */
+export function hasPerformanceMemory() {
+    const perf = performance;
+    return (typeof perf.memory !== "undefined" &&
+        typeof perf.memory.usedJSHeapSize === "number");
+}
+// ─── Snapshot ────────────────────────────────────────────────────────────────
+/** Determine the memory level for a given usage ratio. */
+export function classifyLevel(ratio, thresholds) {
+    if (ratio < 0)
+        return "normal"; // no data
+    if (ratio >= thresholds.critical)
+        return "critical";
+    if (ratio >= thresholds.warning)
+        return "warning";
+    if (ratio >= thresholds.elevated)
+        return "elevated";
+    return "normal";
+}
+/** Take a memory snapshot using the best available API. */
+export function takeSnapshot(thresholds = config.thresholds) {
+    const perf = performance;
+    if (perf.memory) {
+        const { usedJSHeapSize, totalJSHeapSize, jsHeapSizeLimit } = perf.memory;
+        const usageRatio = jsHeapSizeLimit > 0 ? usedJSHeapSize / jsHeapSizeLimit : -1;
+        return {
+            usedJSHeapSize,
+            totalJSHeapSize,
+            jsHeapSizeLimit,
+            usageRatio,
+            level: classifyLevel(usageRatio, thresholds),
+            timestamp: new Date().toISOString(),
+            precise: true,
+        };
+    }
+    // Fallback: no precise data available. Return unknowns.
+    return {
+        usedJSHeapSize: -1,
+        totalJSHeapSize: -1,
+        jsHeapSizeLimit: FALLBACK_HEAP_LIMIT,
+        usageRatio: -1,
+        level: "normal",
+        timestamp: new Date().toISOString(),
+        precise: false,
+    };
+}
+// ─── Formatting ──────────────────────────────────────────────────────────────
+/** Format bytes as a human-readable string (e.g. "142.5 MB"). */
+export function formatBytes(bytes) {
+    if (bytes < 0)
+        return "N/A";
+    if (bytes < 1024)
+        return `${bytes} B`;
+    if (bytes < 1024 * 1024)
+        return `${(bytes / 1024).toFixed(1)} KB`;
+    if (bytes < 1024 * 1024 * 1024)
+        return `${(bytes / (1024 * 1024)).toFixed(1)} MB`;
+    return `${(bytes / (1024 * 1024 * 1024)).toFixed(2)} GB`;
+}
+/** Format a usage ratio as a percentage string (e.g. "72.3%"). */
+export function formatRatio(ratio) {
+    if (ratio < 0)
+        return "N/A";
+    return `${(ratio * 100).toFixed(1)}%`;
+}
+// ─── Monitor lifecycle ───────────────────────────────────────────────────────
+/** Subscribe to every new snapshot. Returns an unsubscribe function. */
+export function onSnapshot(listener) {
+    changeListeners.push(listener);
+    return () => {
+        changeListeners = changeListeners.filter((l) => l !== listener);
+    };
+}
+function notifyListeners(snapshot) {
+    for (const listener of changeListeners) {
+        try {
+            listener(snapshot);
+        }
+        catch (err) {
+            console.error("[memory-monitor] listener error:", err);
+        }
+    }
+}
+function poll() {
+    const snapshot = takeSnapshot(config.thresholds);
+    latestSnapshot = snapshot;
+    // Keep a bounded history ring for debugging.
+    snapshotHistory.push(snapshot);
+    if (snapshotHistory.length > MAX_HISTORY_LENGTH) {
+        snapshotHistory = snapshotHistory.slice(-MAX_HISTORY_LENGTH);
+    }
+    // Detect level transitions.
+    const previousLevel = currentLevel;
+    if (snapshot.level !== currentLevel) {
+        currentLevel = snapshot.level;
+        if (config.onLevelChange) {
+            config.onLevelChange(snapshot, previousLevel);
+        }
+    }
+    notifyListeners(snapshot);
+}
+/**
+ * Start the memory monitor with the given configuration overrides.
+ * Safe to call multiple times — restarts with new config if already running.
+ */
+export function startMemoryMonitor(overrides = {}) {
+    // Stop any existing monitor before applying new config.
+    stopMemoryMonitor();
+    config = {
+        intervalMs: overrides.intervalMs ?? DEFAULT_INTERVAL_MS,
+        thresholds: overrides.thresholds
+            ? { ...DEFAULT_THRESHOLDS, ...overrides.thresholds }
+            : { ...DEFAULT_THRESHOLDS },
+        onLevelChange: overrides.onLevelChange ?? null,
+    };
+    // Take an immediate snapshot on start.
+    poll();
+    pollTimer = setInterval(poll, config.intervalMs);
+    // Register with centralized polling state as ESSENTIAL — the memory
+    // monitor must keep running during memory pressure to detect recovery.
+    stateUnsub = registerPollingSource(POLLING_STATE_KEY, {
+        suspend: () => stopPollTimer(),
+        resume: () => {
+            if (pollTimer === null) {
+                pollTimer = setInterval(poll, config.intervalMs);
+            }
+        },
+        dispose: () => {
+            stopPollTimer();
+            stateUnsub = null;
+        },
+        getStatus: () => (pollTimer !== null ? "active" : "idle"),
+    }, { essential: true });
+}
+/** Stop the poll interval timer without touching polling-state registration. */
+function stopPollTimer() {
+    if (pollTimer) {
+        clearInterval(pollTimer);
+        pollTimer = null;
+    }
+}
+/** Stop the memory monitor and clean up. */
+export function stopMemoryMonitor() {
+    stopPollTimer();
+    // Deregister from centralized polling state. Nullify first to
+    // prevent re-entrant dispose.
+    if (stateUnsub) {
+        const unsub = stateUnsub;
+        stateUnsub = null;
+        unsub();
+    }
+}
+/** Get the most recent memory snapshot, or null if the monitor has not run. */
+export function getLatestSnapshot() {
+    return latestSnapshot;
+}
+/** Get the snapshot history (up to MAX_HISTORY_LENGTH entries). */
+export function getSnapshotHistory() {
+    return snapshotHistory;
+}
+/** Get the current memory warning level. */
+export function getCurrentLevel() {
+    return currentLevel;
+}
+/** Reset all module state (for testing). */
+export function resetMemoryMonitor() {
+    stopMemoryMonitor();
+    currentLevel = "normal";
+    latestSnapshot = null;
+    snapshotHistory = [];
+    changeListeners = [];
+    stateUnsub = null;
+    config = {
+        intervalMs: DEFAULT_INTERVAL_MS,
+        thresholds: { ...DEFAULT_THRESHOLDS },
+        onLevelChange: null,
+    };
+}
+//# sourceMappingURL=memory-monitor.js.map

package/dist/viewer/performance/memory-monitor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-monitor.js","sourceRoot":"","sources":["../../../src/viewer/performance/memory-monitor.ts"],"names":[],"mappings":"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"}

package/dist/viewer/performance/refresh-throttle.d.ts

@@ -0,0 +1,90 @@
+/**
+ * Memory-aware refresh throttling and queuing.
+ *
+ * Provides intelligent refresh scheduling that considers current memory usage
+ * and queues or delays refresh operations when memory pressure is high.
+ *
+ * Behaviour by memory level:
+ *
+ *   normal   → Full-speed refresh, max concurrency (3 parallel fetches).
+ *   elevated → 2× interval, reduced concurrency (2 parallel fetches).
+ *   warning  → 4× interval, serial execution only (1 at a time).
+ *   critical → All refreshes paused, queue frozen until memory subsides.
+ *
+ * Designed as a standalone module with zero framework dependencies —
+ * the Preact hook (`useRefreshThrottle`) is provided separately.
+ */
+import type { MemoryLevel } from "./memory-monitor.js";
+/** Priority levels for refresh operations — higher number = higher priority. */
+export type RefreshPriority = "low" | "normal" | "high";
+/** A single queued refresh operation. */
+export interface QueuedRefresh {
+    /** Unique key to deduplicate same-resource refreshes. */
+    readonly key: string;
+    /** The async work to perform. */
+    readonly execute: () => Promise<void>;
+    /** Priority determines dequeue order (high first). */
+    readonly priority: RefreshPriority;
+    /** ISO timestamp when the request entered the queue. */
+    readonly enqueuedAt: string;
+}
+/** Read-only snapshot of the current queue state. */
+export interface RefreshQueueState {
+    /** Number of items waiting in the queue. */
+    readonly queueLength: number;
+    /** Number of refresh operations currently in flight. */
+    readonly activeCount: number;
+    /** Whether the queue is paused due to memory pressure. */
+    readonly paused: boolean;
+    /** Current memory level informing throttle decisions. */
+    readonly memoryLevel: MemoryLevel;
+    /** Recommended polling interval in milliseconds for the current level. */
+    readonly recommendedIntervalMs: number;
+    /** Maximum concurrent refresh operations allowed at the current level. */
+    readonly maxConcurrency: number;
+    /** Estimated milliseconds until the queue is fully drained (-1 if unknown). */
+    readonly estimatedCompletionMs: number;
+    /** Total refreshes completed since the throttle was started. */
+    readonly completedCount: number;
+}
+/** Callback invoked when the queue state changes. */
+export type QueueChangeHandler = (state: RefreshQueueState) => void;
+/** Configuration for the refresh throttle. */
+export interface RefreshThrottleConfig {
+    /** Base polling interval in milliseconds (default: 5000). */
+    baseIntervalMs: number;
+    /** Average time a single refresh takes, for ETA estimation (default: 800ms). */
+    avgRefreshMs: number;
+    /** Called when the queue state changes. */
+    onChange: QueueChangeHandler | null;
+}
+/**
+ * Start the refresh throttle. Subscribes to the memory monitor and
+ * immediately evaluates the current memory level.
+ *
+ * Safe to call multiple times — restarts with new config.
+ */
+export declare function startRefreshThrottle(overrides?: Partial<RefreshThrottleConfig>): void;
+/** Stop the refresh throttle and clean up subscriptions. */
+export declare function stopRefreshThrottle(): void;
+/**
+ * Enqueue a refresh operation. If an entry with the same key already exists
+ * in the queue, it is replaced (deduplication). The operation will be
+ * executed when concurrency allows and memory pressure permits.
+ *
+ * Returns `true` if the item was queued, `false` if executed immediately.
+ */
+export declare function enqueueRefresh(key: string, execute: () => Promise<void>, priority?: RefreshPriority): boolean;
+/**
+ * Get the recommended polling interval for the current memory level.
+ * Callers can use this to dynamically adjust their setInterval timing.
+ */
+export declare function getRecommendedInterval(baseIntervalMs?: number): number;
+/** Subscribe to queue state changes. Returns an unsubscribe function. */
+export declare function onQueueChange(listener: (state: RefreshQueueState) => void): () => void;
+/** Get the current queue state. */
+export declare function getQueueState(): RefreshQueueState;
+/** Get the current memory level being used for throttle decisions. */
+export declare function getThrottleLevel(): MemoryLevel;
+/** Reset all module state (for testing). */
+export declare function resetRefreshThrottle(): void;

package/dist/viewer/performance/refresh-throttle.js

@@ -0,0 +1,266 @@
+/**
+ * Memory-aware refresh throttling and queuing.
+ *
+ * Provides intelligent refresh scheduling that considers current memory usage
+ * and queues or delays refresh operations when memory pressure is high.
+ *
+ * Behaviour by memory level:
+ *
+ *   normal   → Full-speed refresh, max concurrency (3 parallel fetches).
+ *   elevated → 2× interval, reduced concurrency (2 parallel fetches).
+ *   warning  → 4× interval, serial execution only (1 at a time).
+ *   critical → All refreshes paused, queue frozen until memory subsides.
+ *
+ * Designed as a standalone module with zero framework dependencies —
+ * the Preact hook (`useRefreshThrottle`) is provided separately.
+ */
+import { onSnapshot, getLatestSnapshot, getCurrentLevel } from "./memory-monitor.js";
+// ─── Constants ───────────────────────────────────────────────────────────────
+const DEFAULT_BASE_INTERVAL_MS = 5000;
+const DEFAULT_AVG_REFRESH_MS = 800;
+/** Interval multiplier per memory level. */
+const INTERVAL_MULTIPLIERS = {
+    normal: 1,
+    elevated: 2,
+    warning: 4,
+    critical: Infinity, // effectively paused
+};
+/** Maximum concurrent refresh operations per memory level. */
+const CONCURRENCY_LIMITS = {
+    normal: 3,
+    elevated: 2,
+    warning: 1,
+    critical: 0,
+};
+const PRIORITY_ORDER = {
+    low: 0,
+    normal: 1,
+    high: 2,
+};
+// ─── Module state ────────────────────────────────────────────────────────────
+let config = {
+    baseIntervalMs: DEFAULT_BASE_INTERVAL_MS,
+    avgRefreshMs: DEFAULT_AVG_REFRESH_MS,
+    onChange: null,
+};
+let queue = [];
+let activeCount = 0;
+let completedCount = 0;
+let currentMemoryLevel = "normal";
+let unsubscribeMonitor = null;
+let drainTimer = null;
+let listeners = [];
+// ─── Helpers ─────────────────────────────────────────────────────────────────
+/** Get the recommended interval for the current memory level. */
+function computeRecommendedInterval() {
+    const multiplier = INTERVAL_MULTIPLIERS[currentMemoryLevel];
+    if (!isFinite(multiplier))
+        return Infinity;
+    return config.baseIntervalMs * multiplier;
+}
+/** Get max concurrency for the current memory level. */
+function computeMaxConcurrency() {
+    return CONCURRENCY_LIMITS[currentMemoryLevel];
+}
+/** Estimate milliseconds until the queue is fully drained. */
+function computeEstimatedCompletion() {
+    const total = queue.length + activeCount;
+    if (total === 0)
+        return 0;
+    if (currentMemoryLevel === "critical")
+        return -1; // paused, unknown
+    const maxConcurrency = computeMaxConcurrency();
+    if (maxConcurrency === 0)
+        return -1;
+    const batches = Math.ceil(total / maxConcurrency);
+    return batches * config.avgRefreshMs;
+}
+/** Build the queue state snapshot from current module state. */
+function buildState() {
+    return {
+        queueLength: queue.length,
+        activeCount,
+        paused: currentMemoryLevel === "critical",
+        memoryLevel: currentMemoryLevel,
+        recommendedIntervalMs: computeRecommendedInterval(),
+        maxConcurrency: computeMaxConcurrency(),
+        estimatedCompletionMs: computeEstimatedCompletion(),
+        completedCount,
+    };
+}
+function notifyListeners() {
+    const state = buildState();
+    if (config.onChange)
+        config.onChange(state);
+    for (const listener of listeners) {
+        listener(state);
+    }
+}
+/** Sort queue by priority (high first), then by enqueue time (FIFO within same priority). */
+function sortQueue() {
+    queue.sort((a, b) => {
+        const priorityDiff = PRIORITY_ORDER[b.priority] - PRIORITY_ORDER[a.priority];
+        if (priorityDiff !== 0)
+            return priorityDiff;
+        return a.enqueuedAt.localeCompare(b.enqueuedAt);
+    });
+}
+// ─── Queue drain ─────────────────────────────────────────────────────────────
+/**
+ * Attempt to drain the queue by starting as many operations as allowed
+ * by the current concurrency limit.
+ */
+function drain() {
+    const maxConcurrency = computeMaxConcurrency();
+    while (queue.length > 0 && activeCount < maxConcurrency) {
+        const item = queue.shift();
+        if (!item)
+            break;
+        activeCount++;
+        notifyListeners();
+        item
+            .execute()
+            .catch(() => {
+            // Swallow errors — individual refresh failures shouldn't break the queue.
+        })
+            .finally(() => {
+            activeCount--;
+            completedCount++;
+            notifyListeners();
+            // Continue draining after each completion.
+            scheduleDrain();
+        });
+    }
+}
+/** Schedule a drain attempt — debounced to avoid tight loops. */
+function scheduleDrain() {
+    if (drainTimer !== null)
+        return;
+    drainTimer = setTimeout(() => {
+        drainTimer = null;
+        drain();
+    }, 0);
+}
+// ─── Memory snapshot handler ─────────────────────────────────────────────────
+function handleMemorySnapshot(snapshot) {
+    const newLevel = snapshot.level;
+    if (newLevel === currentMemoryLevel)
+        return;
+    const previousLevel = currentMemoryLevel;
+    currentMemoryLevel = newLevel;
+    notifyListeners();
+    // If memory pressure eased, try to drain the queue.
+    if (PRIORITY_ORDER[newLevel] === undefined &&
+        computeMaxConcurrency() > 0) {
+        scheduleDrain();
+    }
+    // More reliably: if new concurrency > 0 and we have queued items, drain.
+    if (computeMaxConcurrency() > 0 && queue.length > 0) {
+        scheduleDrain();
+    }
+}
+// ─── Public API ──────────────────────────────────────────────────────────────
+/**
+ * Start the refresh throttle. Subscribes to the memory monitor and
+ * immediately evaluates the current memory level.
+ *
+ * Safe to call multiple times — restarts with new config.
+ */
+export function startRefreshThrottle(overrides = {}) {
+    stopRefreshThrottle();
+    config = {
+        baseIntervalMs: overrides.baseIntervalMs ?? DEFAULT_BASE_INTERVAL_MS,
+        avgRefreshMs: overrides.avgRefreshMs ?? DEFAULT_AVG_REFRESH_MS,
+        onChange: overrides.onChange ?? null,
+    };
+    // Evaluate current memory level immediately.
+    const latest = getLatestSnapshot();
+    if (latest) {
+        currentMemoryLevel = latest.level;
+    }
+    else {
+        currentMemoryLevel = getCurrentLevel();
+    }
+    // Subscribe to ongoing memory snapshots.
+    unsubscribeMonitor = onSnapshot(handleMemorySnapshot);
+    notifyListeners();
+    // Drain any items that may have been enqueued before start.
+    if (queue.length > 0) {
+        scheduleDrain();
+    }
+}
+/** Stop the refresh throttle and clean up subscriptions. */
+export function stopRefreshThrottle() {
+    if (unsubscribeMonitor) {
+        unsubscribeMonitor();
+        unsubscribeMonitor = null;
+    }
+    if (drainTimer !== null) {
+        clearTimeout(drainTimer);
+        drainTimer = null;
+    }
+}
+/**
+ * Enqueue a refresh operation. If an entry with the same key already exists
+ * in the queue, it is replaced (deduplication). The operation will be
+ * executed when concurrency allows and memory pressure permits.
+ *
+ * Returns `true` if the item was queued, `false` if executed immediately.
+ */
+export function enqueueRefresh(key, execute, priority = "normal") {
+    // Deduplicate: remove any existing entry with the same key.
+    queue = queue.filter((item) => item.key !== key);
+    const item = {
+        key,
+        execute,
+        priority,
+        enqueuedAt: new Date().toISOString(),
+    };
+    queue.push(item);
+    sortQueue();
+    notifyListeners();
+    scheduleDrain();
+    // Return true if the item is still in the queue (queued, not immediately drained).
+    // Since drain is async, the item is always initially queued.
+    return true;
+}
+/**
+ * Get the recommended polling interval for the current memory level.
+ * Callers can use this to dynamically adjust their setInterval timing.
+ */
+export function getRecommendedInterval(baseIntervalMs = config.baseIntervalMs) {
+    const multiplier = INTERVAL_MULTIPLIERS[currentMemoryLevel];
+    if (!isFinite(multiplier))
+        return Infinity;
+    return baseIntervalMs * multiplier;
+}
+/** Subscribe to queue state changes. Returns an unsubscribe function. */
+export function onQueueChange(listener) {
+    listeners.push(listener);
+    return () => {
+        listeners = listeners.filter((l) => l !== listener);
+    };
+}
+/** Get the current queue state. */
+export function getQueueState() {
+    return buildState();
+}
+/** Get the current memory level being used for throttle decisions. */
+export function getThrottleLevel() {
+    return currentMemoryLevel;
+}
+/** Reset all module state (for testing). */
+export function resetRefreshThrottle() {
+    stopRefreshThrottle();
+    queue = [];
+    activeCount = 0;
+    completedCount = 0;
+    currentMemoryLevel = "normal";
+    listeners = [];
+    config = {
+        baseIntervalMs: DEFAULT_BASE_INTERVAL_MS,
+        avgRefreshMs: DEFAULT_AVG_REFRESH_MS,
+        onChange: null,
+    };
+}
+//# sourceMappingURL=refresh-throttle.js.map

package/dist/viewer/performance/refresh-throttle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"refresh-throttle.js","sourceRoot":"","sources":["../../../src/viewer/performance/refresh-throttle.ts"],"names":[],"mappings":"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"}