@cleanweb/oore 2.0.0-alpha.28 → 2.0.0-alpha.30

package/build/_cjs/helpers/debounce/index.js

@@ -96,15 +96,12 @@ const debounce = (...init) => {
         }
         // Execute the pending call.
         (() => __awaiter(void 0, void 0, void 0, function* () {
-            var _a;
             try {
-                const result = (_a = (yield callback(...args))) !== null && _a !== void 0 ? _a : {};
-                result.__debounceFlushedWithArgs = args;
-                resolve === null || resolve === void 0 ? void 0 : resolve(result);
+                // const result = (await callback(...args)) ?? {};
+                // result.__debounceFlushedWithArgs = args;
+                resolve === null || resolve === void 0 ? void 0 : resolve(yield callback(...args));
             }
-            catch (_reason) {
-                const reason = _reason !== null && _reason !== void 0 ? _reason : {};
-                reason.__debounceFlushedWithArgs = args;
+            catch (reason) {
                 reject === null || reject === void 0 ? void 0 : reject(reason);
             }
         }))();

package/build/_cjs/helpers/debounce/react.d.ts

@@ -1,10 +1,13 @@
+import type { SetStateAction } from 'react.js';
 import { debounce } from './index.js';
 type TDebounceConfig = Exclude<Parameters<typeof debounce>[1], number>;
 type TDelayConfig = number | TDebounceConfig & {
     staging?: boolean;
 };
 export declare function useDebouncedState<T extends any>(init: T, config: TDelayConfig): readonly [T, {
-    (value: T): void;
+    (value: SetStateAction<T>): void;
     flush: (isEager?: true) => void;
+    pause(): void;
+    resume(): void;
 }, T];
 export {};

package/build/_cjs/helpers/debounce/react.js

@@ -6,18 +6,25 @@ const _1 = require("./index.js");
 function useDebouncedState(init, config) {
     const [debouncedValue, setDebouncedValue] = (0, react_1.useState)(init);
     const [stagedValue, setStagedValue] = (0, react_1.useState)(init);
+    const [paused, setPaused] = (0, react_1.useState)(false);
     const enableStaging = typeof config === 'object' && config.staging === true;
     const debounceArgs = [setDebouncedValue, config];
     const debouncedSetter = (0, react_1.useCallback)((0, _1.debounce)(...debounceArgs), debounceArgs);
     const setter = (0, react_1.useMemo)(() => {
-        const output = (value) => {
+        const _setter = (value) => {
             if (enableStaging) {
                 setStagedValue(value);
             }
-            debouncedSetter(value);
+            if (paused) {
+                console.warn('[useDebouncedState] Skipping debounced state update. Updates were paused with `setter.pause()`. Call `setter.play()` to resume.');
+            }
+            else
+                debouncedSetter(value);
         };
-        output.flush = debouncedSetter.flush;
-        return output;
+        _setter.flush = debouncedSetter.flush;
+        _setter.pause = () => setPaused(true);
+        _setter.resume = () => setPaused(false);
+        return _setter;
     }, [enableStaging, debouncedSetter]);
     return [debouncedValue, setter, stagedValue];
 }

package/build/helpers/debounce/index.js

@@ -93,15 +93,12 @@ export const debounce = (...init) => {
         }
         // Execute the pending call.
         (() => __awaiter(void 0, void 0, void 0, function* () {
-            var _a;
             try {
-                const result = (_a = (yield callback(...args))) !== null && _a !== void 0 ? _a : {};
-                result.__debounceFlushedWithArgs = args;
-                resolve === null || resolve === void 0 ? void 0 : resolve(result);
+                // const result = (await callback(...args)) ?? {};
+                // result.__debounceFlushedWithArgs = args;
+                resolve === null || resolve === void 0 ? void 0 : resolve(yield callback(...args));
             }
-            catch (_reason) {
-                const reason = _reason !== null && _reason !== void 0 ? _reason : {};
-                reason.__debounceFlushedWithArgs = args;
+            catch (reason) {
                 reject === null || reject === void 0 ? void 0 : reject(reason);
             }
         }))();

package/build/helpers/debounce/react.d.ts

@@ -1,10 +1,13 @@
+import type { SetStateAction } from 'react.js';
 import { debounce } from './index.js';
 type TDebounceConfig = Exclude<Parameters<typeof debounce>[1], number>;
 type TDelayConfig = number | TDebounceConfig & {
     staging?: boolean;
 };
 export declare function useDebouncedState<T extends any>(init: T, config: TDelayConfig): readonly [T, {
-    (value: T): void;
+    (value: SetStateAction<T>): void;
     flush: (isEager?: true) => void;
+    pause(): void;
+    resume(): void;
 }, T];
 export {};

package/build/helpers/debounce/react.js

@@ -3,18 +3,25 @@ import { debounce } from './index.js';
 export function useDebouncedState(init, config) {
     const [debouncedValue, setDebouncedValue] = useState(init);
     const [stagedValue, setStagedValue] = useState(init);
+    const [paused, setPaused] = useState(false);
     const enableStaging = typeof config === 'object' && config.staging === true;
     const debounceArgs = [setDebouncedValue, config];
     const debouncedSetter = useCallback(debounce(...debounceArgs), debounceArgs);
     const setter = useMemo(() => {
-        const output = (value) => {
+        const _setter = (value) => {
             if (enableStaging) {
                 setStagedValue(value);
             }
-            debouncedSetter(value);
+            if (paused) {
+                console.warn('[useDebouncedState] Skipping debounced state update. Updates were paused with `setter.pause()`. Call `setter.play()` to resume.');
+            }
+            else
+                debouncedSetter(value);
         };
-        output.flush = debouncedSetter.flush;
-        return output;
+        _setter.flush = debouncedSetter.flush;
+        _setter.pause = () => setPaused(true);
+        _setter.resume = () => setPaused(false);
+        return _setter;
     }, [enableStaging, debouncedSetter]);
     return [debouncedValue, setter, stagedValue];
 }

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@cleanweb/oore",
-	"version": "2.0.0-alpha.28",
+	"version": "2.0.0-alpha.30",
 	"description": "A library of helpers for writing cleaner React function components with object-oriented patterns.",
 	"engines": {
 		"node": ">=22"