@vitus-labs/core 1.4.0 → 1.4.2

package/lib/index.d.ts

@@ -199,6 +199,14 @@ declare const hoistNonReactStatics: <T, S>(target: T, source: S, excludeList?: R
 type IsEmpty = <T extends Record<number | string, any> | any[] | null | undefined>(param: T) => T extends null | undefined ? true : keyof T extends never ? true : T extends T[] ? T[number] extends never ? true : false : false;
 declare const isEmpty: IsEmpty;
 //#endregion
+//#region src/isEqual.d.ts
+/**
+ * Order-independent deep equality for plain objects, arrays, and primitives.
+ * Handles null, undefined, nested structures. Does not handle Date, RegExp,
+ * Map, Set, or circular references — not needed for theme/props comparison.
+ */
+declare const isEqual: (a: unknown, b: unknown) => boolean;
+//#endregion
 //#region src/render.d.ts
 type CreateTypes = Parameters<typeof createElement>[0];
 type CloneTypes = Parameters<typeof cloneElement>[0];
@@ -214,6 +222,18 @@ type RenderProps<T extends Record<string, unknown> | undefined> = (props: Partia
 type Render = <T extends Record<string, any> | undefined>(content?: CreateTypes | CloneTypes | ReactNode | ReactNode[] | RenderProps<T>, attachProps?: T) => ReturnType<typeof createElement> | ReturnType<typeof cloneElement> | null;
 declare const render: Render;
 //#endregion
+//#region src/useStableValue.d.ts
+/**
+ * Returns a referentially stable version of `value`. The returned reference
+ * only changes when the value is no longer deeply equal to the previous one.
+ *
+ * Use this to stabilize object/array props before passing them as hook
+ * dependencies, preventing unnecessary recalculations in useMemo/useEffect.
+ *
+ * Based on the useDeepCompareMemoize pattern from use-deep-compare.
+ */
+declare const useStableValue: <T>(value: T) => T;
+//#endregion
 //#region src/utils.d.ts
 declare const omit: <T extends Record<string, any>>(obj: T | null | undefined, keys?: readonly (string | keyof T)[]) => Partial<T>;
 declare const pick: <T extends Record<string, any>>(obj: T | null | undefined, keys?: readonly (string | keyof T)[]) => Partial<T>;
@@ -227,5 +247,5 @@ declare const throttle: <T extends (...args: any[]) => any>(fn: T, wait?: number
 };
 declare const merge: <T extends Record<string, any>>(target: T, ...sources: Record<string, any>[]) => T;
 //#endregion
-export { type BreakpointKeys, type Breakpoints, type HTMLElementAttrs, type HTMLTagAttrsByTag, type HTMLTags, type HTMLTextTags, HTML_TAGS, HTML_TEXT_TAGS, type IsEmpty, Provider, type Render, compose, config, context, get, hoistNonReactStatics, init, isEmpty, merge, omit, pick, render, set, throttle };
+export { type BreakpointKeys, type Breakpoints, type HTMLElementAttrs, type HTMLTagAttrsByTag, type HTMLTags, type HTMLTextTags, HTML_TAGS, HTML_TEXT_TAGS, type IsEmpty, Provider, type Render, compose, config, context, get, hoistNonReactStatics, init, isEmpty, isEqual, merge, omit, pick, render, set, throttle, useStableValue };
 //# sourceMappingURL=index2.d.ts.map

package/lib/index.js

@@ -1,5 +1,5 @@
 import { ThemeProvider, css, styled } from "styled-components";
-import { cloneElement, createContext, createElement, isValidElement, useMemo } from "react";
+import { cloneElement, createContext, createElement, isValidElement, useMemo, useRef } from "react";
 import { Fragment, jsx } from "react/jsx-runtime";
 import { isFragment, isMemo, isValidElementType } from "react-is";
 
@@ -54,6 +54,52 @@ const isEmpty = (param) => {
 	return Object.keys(param).length === 0;
 };
 
+//#endregion
+//#region src/isEqual.ts
+/**
+* Order-independent deep equality for plain objects, arrays, and primitives.
+* Handles null, undefined, nested structures. Does not handle Date, RegExp,
+* Map, Set, or circular references — not needed for theme/props comparison.
+*/
+const isArrayEqual = (a, b) => {
+	if (a.length !== b.length) return false;
+	for (let i = 0; i < a.length; i++) if (!isEqual(a[i], b[i])) return false;
+	return true;
+};
+const isObjectEqual = (a, b) => {
+	const aKeys = Object.keys(a);
+	if (aKeys.length !== Object.keys(b).length) return false;
+	for (const key of aKeys) {
+		if (!Object.hasOwn(b, key)) return false;
+		if (!isEqual(a[key], b[key])) return false;
+	}
+	return true;
+};
+const isEqual = (a, b) => {
+	if (Object.is(a, b)) return true;
+	if (typeof a !== typeof b || a == null || b == null || typeof a !== "object") return false;
+	if (Array.isArray(a)) return Array.isArray(b) && isArrayEqual(a, b);
+	if (Array.isArray(b)) return false;
+	return isObjectEqual(a, b);
+};
+
+//#endregion
+//#region src/useStableValue.ts
+/**
+* Returns a referentially stable version of `value`. The returned reference
+* only changes when the value is no longer deeply equal to the previous one.
+*
+* Use this to stabilize object/array props before passing them as hook
+* dependencies, preventing unnecessary recalculations in useMemo/useEffect.
+*
+* Based on the useDeepCompareMemoize pattern from use-deep-compare.
+*/
+const useStableValue = (value) => {
+	const ref = useRef(value);
+	if (!isEqual(ref.current, value)) ref.current = value;
+	return ref.current;
+};
+
 //#endregion
 //#region src/context.tsx
 /**
@@ -69,14 +115,10 @@ const VitusLabsProvider = context.Provider;
 */
 const Provider = ({ theme, children, ...props }) => {
 	const ExternalProvider = useMemo(() => config.ExternalProvider, []);
-	const context = useMemo(() => ({
+	const context = useStableValue({
 		theme,
 		...props
-	}), [
-		theme,
-		...Object.values(props),
-		props
-	]);
+	});
 	if (isEmpty(theme) || !theme) return /* @__PURE__ */ jsx(Fragment, { children });
 	if (ExternalProvider) return /* @__PURE__ */ jsx(VitusLabsProvider, {
 		value: context,
@@ -436,5 +478,5 @@ const merge = (target, ...sources) => {
 };
 
 //#endregion
-export { HTML_TAGS, HTML_TEXT_TAGS, Provider, compose, config, context, get, hoistNonReactStatics, init, isEmpty, merge, omit, pick, render, set, throttle };
+export { HTML_TAGS, HTML_TEXT_TAGS, Provider, compose, config, context, get, hoistNonReactStatics, init, isEmpty, isEqual, merge, omit, pick, render, set, throttle, useStableValue };
 //# sourceMappingURL=index.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vitus-labs/core",
-  "version": "1.4.0",
+  "version": "1.4.2",
   "license": "MIT",
   "author": "Vit Bokisch <vit@bokisch.cz>",
   "maintainers": [
@@ -61,5 +61,5 @@
     "@vitus-labs/tools-rolldown": "^1.6.0",
     "@vitus-labs/tools-typescript": "^1.6.0"
   },
-  "gitHead": "297985a88495c40ddebfdccdd3ab35f9e41bbe0c"
+  "gitHead": "f12f43c61149964ff4f3f4b80cb6f92da2825915"
 }