saltfish 0.3.2 → 0.3.4

package/dist/utils/constants.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Application-wide constants for timing, thresholds, and configuration values.
+ *
+ * This file centralizes magic numbers to improve code readability and maintainability.
+ * All timing values are in milliseconds unless otherwise noted.
+ */
+/**
+ * Analytics-related constants
+ */
+export declare const ANALYTICS: {
+    /** Interval for flushing analytics events to the backend (30 seconds) */
+    readonly FLUSH_INTERVAL_MS: 30000;
+    /** Maximum number of events to queue before forcing a flush */
+    readonly MAX_QUEUE_SIZE: 10;
+};
+/**
+ * Timing constants for various operations
+ */
+export declare const TIMING: {
+    /** Delay for DOM stabilization before cursor operations (0.5 seconds) */
+    readonly DOM_STABILIZATION_DELAY_MS: 500;
+    /** Delay for state processing operations (100 milliseconds) */
+    readonly STATE_PROCESSING_DELAY_MS: 100;
+    /** Interval for checking URL path changes (5 seconds) */
+    readonly URL_PATH_CHECK_INTERVAL_MS: 5000;
+    /** Retry delay for failed operations (0.5 seconds) */
+    readonly RETRY_DELAY_MS: 500;
+};
+/**
+ * UI interaction thresholds
+ */
+export declare const THRESHOLDS: {
+    /** Minimum scroll distance in pixels to trigger scroll events */
+    readonly SCROLL_THRESHOLD_PX: 10;
+};
+//# sourceMappingURL=constants.d.ts.map

package/dist/utils/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/utils/constants.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;GAEG;AACH,eAAO,MAAM,SAAS;IACpB,yEAAyE;;IAEzE,+DAA+D;;CAEvD,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,MAAM;IACjB,yEAAyE;;IAGzE,+DAA+D;;IAG/D,yDAAyD;;IAGzD,sDAAsD;;CAE9C,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,UAAU;IACrB,iEAAiE;;CAEzD,CAAC"}

package/dist/utils/storeUtils.d.ts

@@ -0,0 +1,20 @@
+import { useSaltfishStore } from '../core/store';
+/**
+ * Safely get the Saltfish store state with error handling
+ *
+ * This utility provides a consistent way to access the Zustand store
+ * across all managers and components, with built-in error handling.
+ *
+ * @returns The current store state, or null if access fails
+ *
+ * @example
+ * ```typescript
+ * const store = getSaltfishStore();
+ * if (store) {
+ *   const currentState = store.currentState;
+ *   // Use store data...
+ * }
+ * ```
+ */
+export declare function getSaltfishStore(): ReturnType<typeof useSaltfishStore.getState> | null;
+//# sourceMappingURL=storeUtils.d.ts.map

package/dist/utils/storeUtils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storeUtils.d.ts","sourceRoot":"","sources":["../../src/utils/storeUtils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAGjD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,gBAAgB,IAAI,UAAU,CAAC,OAAO,gBAAgB,CAAC,QAAQ,CAAC,GAAG,IAAI,CAOtF"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "saltfish",
-  "version": "0.3.2",
+  "version": "0.3.4",
   "description": "An interactive video-guided tour system for web applications",
   "main": "dist/saltfish-playlist-player.umd.js",
   "types": "dist/index.d.ts",