@v-c/util 1.0.21 → 1.2.0

package/dist/hooks/useDelayState.d.ts

@@ -0,0 +1,16 @@
+import { Ref } from 'vue';
+export type DelayConfig = {
+    frame: number;
+    ms?: never;
+} | {
+    frame?: never;
+    ms: number;
+};
+export type SetDelayState<T> = (nextValue: T | ((prev: T) => T), 
+/** `true` updates immediately. `false` delays the update by one frame. */
+immediatelyOrDelay?: boolean | DelayConfig) => void;
+/**
+ * Similar to `useState`, but updates on the next frame by default.
+ * Pending updates are always replaced by the latest one.
+ */
+export default function useDelayState<T>(defaultValue: T | (() => T)): [Ref<T>, SetDelayState<T>];

package/dist/hooks/useDelayState.js

@@ -0,0 +1,33 @@
+import wrapperRaf from "../raf.js";
+import { onBeforeUnmount, ref } from "vue";
+//#region src/hooks/useDelayState.ts
+/**
+* Similar to `useState`, but updates on the next frame by default.
+* Pending updates are always replaced by the latest one.
+*/
+function useDelayState(defaultValue) {
+	const value = ref(typeof defaultValue === "function" ? defaultValue() : defaultValue);
+	let delayInfo = null;
+	const cancelPending = () => {
+		if (delayInfo) {
+			const [isRaf, delay] = delayInfo;
+			if (isRaf) wrapperRaf.cancel(delay);
+			else clearTimeout(delay);
+			delayInfo = null;
+		}
+	};
+	const applyValue = (nextValue) => {
+		value.value = typeof nextValue === "function" ? nextValue(value.value) : nextValue;
+	};
+	const setDelayValue = (nextValue, immediatelyOrDelay) => {
+		const delayConfig = immediatelyOrDelay || { frame: 1 };
+		cancelPending();
+		if (delayConfig === true) applyValue(nextValue);
+		else if ("ms" in delayConfig) delayInfo = [false, setTimeout(() => applyValue(nextValue), delayConfig.ms)];
+		else delayInfo = [true, wrapperRaf(() => applyValue(nextValue), delayConfig.frame)];
+	};
+	onBeforeUnmount(cancelPending);
+	return [value, setDelayValue];
+}
+//#endregion
+export { useDelayState as default };

package/dist/index.d.ts

@@ -3,6 +3,7 @@ export { useControlledState } from './hooks/useControlledState';
 export { default as useId } from './hooks/useId';
 export { default as useMergedState } from './hooks/useMergedState';
 export { default as KeyCode } from './KeyCode';
+export { isNonNullable, isVueRenderable } from './is';
 export { default as omit } from './omit';
 export { default as raf } from './raf';
 export { default as RenderComponent } from './RenderComponent';

package/dist/index.js

@@ -6,7 +6,8 @@ import classNames, { clsx } from "./classnames.js";
 import { useControlledState } from "./hooks/useControlledState.js";
 import useId_default from "./hooks/useId.js";
 import useMergedState from "./hooks/useMergedState.js";
+import { isNonNullable, isVueRenderable } from "./is.js";
 import get from "./utils/get.js";
 import set, { merge, mergeWith } from "./utils/set.js";
 import warningOnce from "./warning.js";
-export { KeyCode, RenderComponent_default as RenderComponent, classNames, clsx, get, merge, mergeWith, omit, wrapperRaf as raf, set, useControlledState, useId_default as useId, useMergedState, warningOnce as warning };
+export { KeyCode, RenderComponent_default as RenderComponent, classNames, clsx, get, isNonNullable, isVueRenderable, merge, mergeWith, omit, wrapperRaf as raf, set, useControlledState, useId_default as useId, useMergedState, warningOnce as warning };

package/dist/is.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Check if a value is neither `null` nor `undefined`.
+ */
+export declare function isNonNullable<T>(value: T): value is NonNullable<T>;
+/**
+ * Check whether a value should be treated as renderable content.
+ *
+ * Returns `false` only for `null`, `undefined`, `false`, and `''`; all other
+ * values, including `0` and `true`, are treated as renderable.
+ *
+ * This is a compatibility-oriented presence check, not a complete Vue node
+ * validator.
+ */
+export declare function isVueRenderable<T>(value: T): value is Exclude<NonNullable<T>, false | ''>;

package/dist/is.js

@@ -0,0 +1,21 @@
+//#region src/is.ts
+/**
+* Check if a value is neither `null` nor `undefined`.
+*/
+function isNonNullable(value) {
+	return value !== void 0 && value !== null;
+}
+/**
+* Check whether a value should be treated as renderable content.
+*
+* Returns `false` only for `null`, `undefined`, `false`, and `''`; all other
+* values, including `0` and `true`, are treated as renderable.
+*
+* This is a compatibility-oriented presence check, not a complete Vue node
+* validator.
+*/
+function isVueRenderable(value) {
+	return isNonNullable(value) && value !== false && value !== "";
+}
+//#endregion
+export { isNonNullable, isVueRenderable };

package/dist/pickAttrs.js

@@ -16,7 +16,12 @@ var propList = `accept acceptCharset accessKey action allowFullScreen allowTrans
     onMouseEnter onMouseLeave onMouseMove onMouseOut onMouseOver onMouseUp onSelect onTouchCancel
     onTouchEnd onTouchMove onTouchStart onScroll onWheel onAbort onCanPlay onCanPlayThrough
     onDurationChange onEmptied onEncrypted onEnded onError onLoadedData onLoadedMetadata
-    onLoadStart onPause onPlay onPlaying onProgress onRateChange onSeeked onSeeking onStalled onSuspend onTimeUpdate onVolumeChange onWaiting onLoad onError`.split(/\s+/);
+    onLoadStart onPause onPlay onPlaying onProgress onRateChange onSeeked onSeeking onStalled onSuspend onTimeUpdate onVolumeChange onWaiting onLoad
+    onPointerDown onPointerMove onPointerUp onPointerCancel onPointerEnter onPointerLeave onPointerOver onPointerOut onGotPointerCapture onLostPointerCapture
+    onAnimationStart onAnimationEnd onAnimationIteration
+    onTransitionEnd onTransitionRun onTransitionStart onTransitionCancel
+    onBeforeInput onReset onInvalid
+    onAuxClick onToggle onBeforeToggle onCancel onClose onResize onScrollEnd`.split(/\s+/);
 var ariaPrefix = "aria-";
 var dataPrefix = "data-";
 function match(key, prefix) {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@v-c/util",
   "type": "module",
-  "version": "1.0.21",
+  "version": "1.2.0",
   "description": "Vue3 components utils",
   "license": "MIT",
   "homepage": "https://github.com/antdv-next/vue-components/tree/next/packages/util",