@cripty2001/utils 0.0.219 → 0.0.220

package/dist/react-whispr.d.ts

@@ -217,18 +217,22 @@ export declare function useAsyncInput<C extends Record<string, JSONEncodable>, R
  *                  Called once immediately to seed the Whispr, then on every refresh.
  * @param interval - If provided, the Whispr will automatically re-poll `getData`
  *                   every `interval` milliseconds. Pass `null` to disable auto-refresh.
- * @returns A tuple of:
- *   - The resulting `Whispr<T>`, seeded with the initial value from `getData`.
- *   - A `refresh` function that manually re-reads `getData` and pushes the new
+ * @returns An object with:
+ *   - `data`: The resulting `Whispr<T>`, seeded with the initial value from `getData`.
+ *   - `refresh`: A function that manually re-reads `getData` and pushes the new
  *     value into the Whispr. Hook this wherever you have a hint that the
  *     external source may have changed.
  *
  * @example
- * const [windowSize, refreshSize] = whisprFromExternal(
+ * const { data: windowSize, refresh: refreshSize } = whisprFromExternal(
  *   () => ({ width: window.innerWidth, height: window.innerHeight }),
  *   null,
  * );
  *
  * window.addEventListener("resize", refreshSize);
  */
-export declare function whisprFromExternal<T>(getData: () => T, interval: number | null): [Whispr<T>, () => void];
+export type WhisprFromExternalResult<T> = {
+    data: Whispr<T>;
+    refresh: () => void;
+};
+export declare function whisprFromExternal<T>(getData: () => T, interval: number | null): WhisprFromExternalResult<T>;

package/dist/react-whispr.js

@@ -439,32 +439,6 @@ function useAsyncInput(value, setValue, handler, setPending = () => { }) {
         result,
     ];
 }
-/**
- * Creates a Whispr from an external (non-reactive) data source.
- *
- * Unlike `Whispr.from`, which derives state from other Whisprs, this function
- * bridges an arbitrary data generator into Whispr's reactive system — useful
- * when your source of truth lives outside the Whispr graph (e.g. a DOM API,
- * a global store, or a plain function).
- *
- * @param getData - A function that returns the current value of the external source.
- *                  Called once immediately to seed the Whispr, then on every refresh.
- * @param interval - If provided, the Whispr will automatically re-poll `getData`
- *                   every `interval` milliseconds. Pass `null` to disable auto-refresh.
- * @returns A tuple of:
- *   - The resulting `Whispr<T>`, seeded with the initial value from `getData`.
- *   - A `refresh` function that manually re-reads `getData` and pushes the new
- *     value into the Whispr. Hook this wherever you have a hint that the
- *     external source may have changed.
- *
- * @example
- * const [windowSize, refreshSize] = whisprFromExternal(
- *   () => ({ width: window.innerWidth, height: window.innerHeight }),
- *   null,
- * );
- *
- * window.addEventListener("resize", refreshSize);
- */
 function whisprFromExternal(getData, interval) {
     const intervalRef = (() => {
         return interval !== null ?
@@ -479,5 +453,8 @@ function whisprFromExternal(getData, interval) {
         }
     };
     const [value, setValue] = whispr_1.Whispr.create(getData(), cleanup);
-    return [value, () => setValue(getData())];
+    return {
+        data: value,
+        refresh: () => setValue(getData()),
+    };
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cripty2001/utils",
-  "version": "0.0.219",
+  "version": "0.0.220",
   "description": "Internal Set of utils. If you need them use them, otherwise go to the next package ;)",
   "homepage": "https://github.com/cripty2001/utils#readme",
   "bugs": {