@zayne-labs/toolkit-react 0.11.19 → 0.11.21

package/dist/esm/utils/getSlotMap/getSlotMap.d.ts

@@ -0,0 +1,86 @@
+import { CallbackFn, EmptyObject, Prettify, UnionToIntersection, UnknownObject } from "@zayne-labs/toolkit-type-helpers";
+
+//#region src/utils/getSlotMap/getSlotMap.d.ts
+type GetSlotName<TSlotComponentProps extends GetSlotComponentProps> = string extends TSlotComponentProps["name"] ? never : "default" extends TSlotComponentProps["name"] ? never : TSlotComponentProps["name"];
+type GetSpecificSlotsType<TSlotComponentProps extends GetSlotComponentProps> = { [TName in keyof TSlotComponentProps as GetSlotName<TSlotComponentProps>]: Extract<TSlotComponentProps["children"], React.ReactNode> };
+/**
+ * Maps slot names to their corresponding children types
+ */
+type GetSlotMapResult<TSlotComponentProps extends GetSlotComponentProps> = UnionToIntersection<GetSpecificSlotsType<TSlotComponentProps>> & {
+  default: React.ReactNode[];
+};
+/**
+ * Symbol used to identify SlotComponent instances
+ */
+declare const slotComponentSymbol: unique symbol;
+/**
+ * @description Creates a map of named slots from React children. Returns an object mapping slot names to their children,
+ * with a default slot for unmatched children.
+ *
+ * @example
+ * ```tsx
+ * import { type GetSlotComponentProps, SlotComponent } from "@zayne-labs/toolkit-react/utils"
+ *
+ * type SlotProps = GetSlotComponentProps<"header" | "footer">;
+ *
+ * function Parent({ children }: { children: React.ReactNode }) {
+ *   const slots = getSlotMap<SlotProps>(children);
+ *
+ *   return (
+ *     <div>
+ *       <header>{slots.header}</header>
+ *       <main>{slots.default}</main>
+ *       <footer>{slots.footer}</footer>
+ *     </div>
+ *   );
+ * }
+ * ```
+ *
+ * Usage:
+ * ```tsx
+ * <Parent>
+ *   <SlotComponent name="header">Header Content</SlotComponent>
+ *   <div>Random stuff</div>
+ *   <SlotComponent name="footer">Footer Content</SlotComponent>
+ * </Parent>
+ * ```
+ */
+declare const getSlotMap: <TSlotComponentProps extends GetSlotComponentProps>(children: React.ReactNode) => Prettify<GetSlotMapResult<TSlotComponentProps>>;
+/**
+ * @description Produce props for the SlotComponent
+ *
+ * @example
+ * ```ts
+ * // Pattern One (slot or slots have same children type, which is just React.ReactNode by default)
+ * type SlotProps = GetSlotComponentProps<"header" | "content" | "footer">;
+ *
+ * // Pattern Two (some slots can have different children type)
+ * type SlotProps =  GetSlotComponentProps<"header", React.ReactNode> | GetSlotComponentProps<"header", (renderProp: RenderProp) => React.ReactNode>;
+ * ```
+ */
+type GetSlotComponentProps<TName extends string = string, TChildren extends CallbackFn<never, React.ReactNode> | React.ReactNode = CallbackFn<never, React.ReactNode> | React.ReactNode> = {
+  children: TChildren;
+  /**
+   * Name of the slot where content should be rendered
+   */
+  name: TName;
+};
+/**
+ * @description Creates a slot component
+ */
+declare const createSlotComponent: <TSlotComponentProps extends GetSlotComponentProps>() => {
+  (props: TSlotComponentProps): React.ReactNode;
+  slotSymbol: typeof slotComponentSymbol;
+};
+type SlotWithNameAndSymbol<TSlotComponentProps extends GetSlotComponentProps = GetSlotComponentProps, TOtherProps extends UnknownObject = EmptyObject> = {
+  (props: Pick<TSlotComponentProps, "children"> & TOtherProps): React.ReactNode;
+  readonly slotName?: TSlotComponentProps["name"];
+  readonly slotSymbol?: symbol;
+};
+/**
+ * @description Adds a slot symbol and name to a slot component passed in
+ */
+declare const withSlotNameAndSymbol: <TSlotComponentProps extends GetSlotComponentProps, TOtherProps extends UnknownObject = EmptyObject>(name: TSlotComponentProps["name"], SlotComponent?: SlotWithNameAndSymbol<TSlotComponentProps, TOtherProps>) => SlotWithNameAndSymbol<TSlotComponentProps, TOtherProps>;
+//#endregion
+export { GetSlotComponentProps, GetSlotMapResult, createSlotComponent, getSlotMap, slotComponentSymbol, withSlotNameAndSymbol };
+//# sourceMappingURL=getSlotMap.d.ts.map

package/dist/esm/utils/getSlotMap/getSlotMap.js

@@ -0,0 +1,87 @@
+import { Fragment, isValidElement } from "react";
+import { toArray } from "@zayne-labs/toolkit-core";
+import { isFunction } from "@zayne-labs/toolkit-type-helpers";
+
+//#region src/utils/getSlotMap/getSlotMap.ts
+/**
+* Symbol used to identify SlotComponent instances
+*/
+const slotComponentSymbol = Symbol("slot-component");
+/**
+* @description Creates a map of named slots from React children. Returns an object mapping slot names to their children,
+* with a default slot for unmatched children.
+*
+* @example
+* ```tsx
+* import { type GetSlotComponentProps, SlotComponent } from "@zayne-labs/toolkit-react/utils"
+*
+* type SlotProps = GetSlotComponentProps<"header" | "footer">;
+*
+* function Parent({ children }: { children: React.ReactNode }) {
+*   const slots = getSlotMap<SlotProps>(children);
+*
+*   return (
+*     <div>
+*       <header>{slots.header}</header>
+*       <main>{slots.default}</main>
+*       <footer>{slots.footer}</footer>
+*     </div>
+*   );
+* }
+* ```
+*
+* Usage:
+* ```tsx
+* <Parent>
+*   <SlotComponent name="header">Header Content</SlotComponent>
+*   <div>Random stuff</div>
+*   <SlotComponent name="footer">Footer Content</SlotComponent>
+* </Parent>
+* ```
+*/
+const getSlotMap = (children) => {
+	const slots = { default: [] };
+	const actualChildren = isValidElement(children) && children.type === Fragment ? children.props.children : children;
+	const childrenArray = toArray(actualChildren);
+	for (const child of childrenArray) {
+		if (!isValidElement(child) || !isFunction(child.type)) {
+			slots.default.push(child);
+			continue;
+		}
+		const childType = child.type;
+		if (!(childType.slotSymbol === slotComponentSymbol && Boolean(childType.slotName ?? child.props.name))) {
+			slots.default.push(child);
+			continue;
+		}
+		const slotName = childType.slotName ?? child.props.name;
+		if (slotName === "default") {
+			slots.default.push(child);
+			continue;
+		}
+		slots[slotName] = child;
+	}
+	return slots;
+};
+/**
+* @description Creates a slot component
+*/
+const createSlotComponent = () => {
+	const SlotComponent = (props) => props.children;
+	SlotComponent.slotSymbol = slotComponentSymbol;
+	return SlotComponent;
+};
+function DefaultSlotComponent(props) {
+	return props.children;
+}
+/**
+* @description Adds a slot symbol and name to a slot component passed in
+*/
+const withSlotNameAndSymbol = (name, SlotComponent = DefaultSlotComponent) => {
+	SlotComponent.slotSymbol = slotComponentSymbol;
+	SlotComponent.slotName = name;
+	return SlotComponent;
+};
+
+//#endregion
+export { createSlotComponent, getSlotMap, slotComponentSymbol, withSlotNameAndSymbol };
+//# sourceMappingURL=getSlotMap.js.map

package/dist/esm/utils/getSlotMap/getSlotMap.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getSlotMap.js","names":["slots: Record<string, TSlotComponentProps[\"children\"]> & { default: React.ReactNode[] }","ReactFragment"],"sources":["../../../../src/utils/getSlotMap/getSlotMap.ts"],"sourcesContent":["import { toArray } from \"@zayne-labs/toolkit-core\";\nimport {\n\ttype CallbackFn,\n\ttype EmptyObject,\n\tisFunction,\n\ttype Prettify,\n\ttype UnionToIntersection,\n\ttype UnknownObject,\n} from \"@zayne-labs/toolkit-type-helpers\";\nimport { isValidElement, Fragment as ReactFragment } from \"react\";\nimport type { InferProps } from \"../types\";\n\ntype GetSlotName<TSlotComponentProps extends GetSlotComponentProps> =\n\tstring extends TSlotComponentProps[\"name\"] ? never\n\t: \"default\" extends TSlotComponentProps[\"name\"] ? never\n\t: TSlotComponentProps[\"name\"];\n\ntype GetSpecificSlotsType<TSlotComponentProps extends GetSlotComponentProps> = {\n\t// This conditional before the remapping will prevent an Indexed Record type from showing up if the props are not passed, enhancing type safety\n\t[TName in keyof TSlotComponentProps as GetSlotName<TSlotComponentProps>]: Extract<\n\t\tTSlotComponentProps[\"children\"],\n\t\tReact.ReactNode\n\t>;\n};\n\n/**\n * Maps slot names to their corresponding children types\n */\nexport type GetSlotMapResult<TSlotComponentProps extends GetSlotComponentProps> = UnionToIntersection<\n\tGetSpecificSlotsType<TSlotComponentProps>\n> & { default: React.ReactNode[] };\n\n/**\n * Symbol used to identify SlotComponent instances\n */\nexport const slotComponentSymbol = Symbol(\"slot-component\");\n\n/**\n * @description Creates a map of named slots from React children. Returns an object mapping slot names to their children,\n * with a default slot for unmatched children.\n *\n * @example\n * ```tsx\n * import { type GetSlotComponentProps, SlotComponent } from \"@zayne-labs/toolkit-react/utils\"\n *\n * type SlotProps = GetSlotComponentProps<\"header\" | \"footer\">;\n *\n * function Parent({ children }: { children: React.ReactNode }) {\n *   const slots = getSlotMap<SlotProps>(children);\n *\n *   return (\n *     <div>\n *       <header>{slots.header}</header>\n *       <main>{slots.default}</main>\n *       <footer>{slots.footer}</footer>\n *     </div>\n *   );\n * }\n * ```\n *\n * Usage:\n * ```tsx\n * <Parent>\n *   <SlotComponent name=\"header\">Header Content</SlotComponent>\n *   <div>Random stuff</div>\n *   <SlotComponent name=\"footer\">Footer Content</SlotComponent>\n * </Parent>\n * ```\n */\nexport const getSlotMap = <TSlotComponentProps extends GetSlotComponentProps>(\n\tchildren: React.ReactNode\n): Prettify<GetSlotMapResult<TSlotComponentProps>> => {\n\tconst slots: Record<string, TSlotComponentProps[\"children\"]> & { default: React.ReactNode[] } = {\n\t\tdefault: [],\n\t};\n\n\tconst isFragment = isValidElement<InferProps<HTMLElement>>(children) && children.type === ReactFragment;\n\n\tconst actualChildren = isFragment ? children.props.children : children;\n\n\tconst childrenArray = toArray<React.ReactNode>(actualChildren);\n\n\tfor (const child of childrenArray) {\n\t\tif (!isValidElement<TSlotComponentProps>(child) || !isFunction(child.type)) {\n\t\t\tslots.default.push(child);\n\t\t\tcontinue;\n\t\t}\n\n\t\tconst childType = child.type as SlotWithNameAndSymbol;\n\n\t\tconst isSlotElement =\n\t\t\tchildType.slotSymbol === slotComponentSymbol && Boolean(childType.slotName ?? child.props.name);\n\n\t\tif (!isSlotElement) {\n\t\t\tslots.default.push(child);\n\t\t\tcontinue;\n\t\t}\n\n\t\tconst slotName = childType.slotName ?? child.props.name;\n\n\t\tif (slotName === \"default\") {\n\t\t\tslots.default.push(child);\n\t\t\tcontinue;\n\t\t}\n\n\t\tslots[slotName] = child;\n\t}\n\n\treturn slots as GetSlotMapResult<TSlotComponentProps>;\n};\n\n/**\n * @description Produce props for the SlotComponent\n *\n * @example\n * ```ts\n * // Pattern One (slot or slots have same children type, which is just React.ReactNode by default)\n * type SlotProps = GetSlotComponentProps<\"header\" | \"content\" | \"footer\">;\n *\n * // Pattern Two (some slots can have different children type)\n * type SlotProps =  GetSlotComponentProps<\"header\", React.ReactNode> | GetSlotComponentProps<\"header\", (renderProp: RenderProp) => React.ReactNode>;\n * ```\n */\nexport type GetSlotComponentProps<\n\tTName extends string = string,\n\tTChildren extends CallbackFn<never, React.ReactNode> | React.ReactNode =\n\t\t| CallbackFn<never, React.ReactNode>\n\t\t| React.ReactNode,\n> = {\n\tchildren: TChildren;\n\t/**\n\t * Name of the slot where content should be rendered\n\t */\n\tname: TName;\n};\n\n/**\n * @description Creates a slot component\n */\nexport const createSlotComponent = <TSlotComponentProps extends GetSlotComponentProps>() => {\n\tconst SlotComponent = (props: TSlotComponentProps) => props.children as React.ReactNode;\n\n\tSlotComponent.slotSymbol = slotComponentSymbol;\n\n\treturn SlotComponent;\n};\n\ntype SlotWithNameAndSymbol<\n\tTSlotComponentProps extends GetSlotComponentProps = GetSlotComponentProps,\n\tTOtherProps extends UnknownObject = EmptyObject,\n> = {\n\t(props: Pick<TSlotComponentProps, \"children\"> & TOtherProps): React.ReactNode;\n\treadonly slotName?: TSlotComponentProps[\"name\"];\n\treadonly slotSymbol?: symbol;\n};\n\nfunction DefaultSlotComponent(props: Pick<GetSlotComponentProps, \"children\">): React.ReactNode {\n\treturn props.children as React.ReactNode;\n}\n\n/**\n * @description Adds a slot symbol and name to a slot component passed in\n */\nexport const withSlotNameAndSymbol = <\n\tTSlotComponentProps extends GetSlotComponentProps,\n\tTOtherProps extends UnknownObject = EmptyObject,\n>(\n\tname: TSlotComponentProps[\"name\"],\n\tSlotComponent: SlotWithNameAndSymbol<TSlotComponentProps, TOtherProps> = DefaultSlotComponent\n) => {\n\t/* eslint-disable no-param-reassign -- This is necessary */\n\t// @ts-expect-error -- This is necessary for the time being, to prevent type errors and accidental overrides on consumer side\n\tSlotComponent.slotSymbol = slotComponentSymbol;\n\t// @ts-expect-error -- This is necessary for the time being, to prevent type errors and accidental overrides on consumer side\n\tSlotComponent.slotName = name;\n\n\t/* eslint-enable no-param-reassign -- This is necessary */\n\n\treturn SlotComponent;\n};\n"],"mappings":";;;;;;;;AAmCA,MAAa,sBAAsB,OAAO,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAkC3D,MAAa,cACZ,aACqD;CACrD,MAAMA,QAA0F,EAC/F,SAAS,EAAE,EACX;CAID,MAAM,iBAFa,eAAwC,SAAS,IAAI,SAAS,SAASC,WAEtD,SAAS,MAAM,WAAW;CAE9D,MAAM,gBAAgB,QAAyB,eAAe;AAE9D,MAAK,MAAM,SAAS,eAAe;AAClC,MAAI,CAAC,eAAoC,MAAM,IAAI,CAAC,WAAW,MAAM,KAAK,EAAE;AAC3E,SAAM,QAAQ,KAAK,MAAM;AACzB;;EAGD,MAAM,YAAY,MAAM;AAKxB,MAAI,EAFH,UAAU,eAAe,uBAAuB,QAAQ,UAAU,YAAY,MAAM,MAAM,KAAK,GAE5E;AACnB,SAAM,QAAQ,KAAK,MAAM;AACzB;;EAGD,MAAM,WAAW,UAAU,YAAY,MAAM,MAAM;AAEnD,MAAI,aAAa,WAAW;AAC3B,SAAM,QAAQ,KAAK,MAAM;AACzB;;AAGD,QAAM,YAAY;;AAGnB,QAAO;;;;;AA+BR,MAAa,4BAA+E;CAC3F,MAAM,iBAAiB,UAA+B,MAAM;AAE5D,eAAc,aAAa;AAE3B,QAAO;;AAYR,SAAS,qBAAqB,OAAiE;AAC9F,QAAO,MAAM;;;;;AAMd,MAAa,yBAIZ,MACA,gBAAyE,yBACrE;AAGJ,eAAc,aAAa;AAE3B,eAAc,WAAW;AAIzB,QAAO"}

package/dist/esm/utils/index.d.ts

@@ -1,2 +1,9 @@
-import { AsProp, CssWithCustomProperties, DefaultRenderErrorMessages, DefaultRenderItemErrorMessages, DiscriminatedRenderItemProps, DiscriminatedRenderProps, ForwardedRefType, FunctionalComponent, GetSlotComponentProps, GetSlotMapResult, InferProps, InferPropsStrict, PolymorphicProps, PolymorphicPropsStrict, PossibleRef, StateSetter, composeEventHandlers, composeRefs, composeTwoEventHandlers, createSlotComponent, getMultipleSlots, getRegularChildren, getSingleSlot, getSlotMap, matchesAnySlotComponent, matchesSlotComponent, mergeProps, mergeTwoProps, setRef, slotComponentSymbol, withSlotNameAndSymbol } from "../index-DlScRgBk.js";
+import { composeEventHandlers, composeTwoEventHandlers } from "./composeEventHandlers.js";
+import { PossibleRef, composeRefs, setRef } from "./composeRefs.js";
+import { FunctionalComponent, getMultipleSlots, getRegularChildren, getSingleSlot, matchesAnySlotComponent, matchesSlotComponent } from "./getSlot/getSlot.js";
+import { GetSlotComponentProps, GetSlotMapResult, createSlotComponent, getSlotMap, slotComponentSymbol, withSlotNameAndSymbol } from "./getSlotMap/getSlotMap.js";
+import { mergeProps } from "./mergeProps.js";
+import { mergeTwoProps } from "./mergeTwoProps.js";
+import { CssWithCustomProperties, DefaultRenderErrorMessages, DefaultRenderItemErrorMessages, DiscriminatedRenderItemProps, DiscriminatedRenderProps, ForwardedRefType, InferProps, InferPropsStrict, StateSetter } from "./types/common.js";
+import { AsProp, PolymorphicProps, PolymorphicPropsStrict } from "./types/polymorphism.js";
 export { AsProp, CssWithCustomProperties, DefaultRenderErrorMessages, DefaultRenderItemErrorMessages, DiscriminatedRenderItemProps, DiscriminatedRenderProps, ForwardedRefType, FunctionalComponent, GetSlotComponentProps, GetSlotMapResult, InferProps, InferPropsStrict, PolymorphicProps, PolymorphicPropsStrict, PossibleRef, StateSetter, composeEventHandlers, composeRefs, composeTwoEventHandlers, createSlotComponent, getMultipleSlots, getRegularChildren, getSingleSlot, getSlotMap, matchesAnySlotComponent, matchesSlotComponent, mergeProps, mergeTwoProps, setRef, slotComponentSymbol, withSlotNameAndSymbol };

package/dist/esm/utils/index.js

@@ -1,3 +1,8 @@
-import { composeEventHandlers, composeRefs, composeTwoEventHandlers, createSlotComponent, getMultipleSlots, getRegularChildren, getSingleSlot, getSlotMap, matchesAnySlotComponent, matchesSlotComponent, mergeProps, mergeTwoProps, setRef, slotComponentSymbol, withSlotNameAndSymbol } from "../utils-Bvs8tFDM.js";
+import { composeEventHandlers, composeTwoEventHandlers } from "./composeEventHandlers.js";
+import { composeRefs, setRef } from "./composeRefs.js";
+import { getMultipleSlots, getRegularChildren, getSingleSlot, matchesAnySlotComponent, matchesSlotComponent } from "./getSlot/getSlot.js";
+import { createSlotComponent, getSlotMap, slotComponentSymbol, withSlotNameAndSymbol } from "./getSlotMap/getSlotMap.js";
+import { mergeTwoProps } from "./mergeTwoProps.js";
+import { mergeProps } from "./mergeProps.js";
 
 export { composeEventHandlers, composeRefs, composeTwoEventHandlers, createSlotComponent, getMultipleSlots, getRegularChildren, getSingleSlot, getSlotMap, matchesAnySlotComponent, matchesSlotComponent, mergeProps, mergeTwoProps, setRef, slotComponentSymbol, withSlotNameAndSymbol };

package/dist/esm/utils/mergeProps.d.ts

@@ -0,0 +1,20 @@
+//#region src/utils/mergeProps.d.ts
+type UnionToIntersection<TUnion> = (TUnion extends unknown ? (param: TUnion) => void : "") extends ((param: infer TParam) => void) ? TParam : "";
+/**
+ * Merges multiple sets of React props.
+ *
+ * - It follows the Object.assign pattern where the rightmost object's fields overwrite
+ * the conflicting ones from others. This doesn't apply to event handlers, `className` and `style` props.
+ * - Event handlers are merged such that they are called in sequence (the rightmost one being called first),
+ * and allows the user to prevent the previous event handlers from being executed by calling the `preventDefault` method.
+ * - It also merges the `className` and `style` props, whereby the classes are concatenated
+ * and the rightmost styles overwrite the previous ones.
+ *
+ * @important **`ref` is not merged.**
+ * @param props props to merge.
+ * @returns the merged props.
+ */
+declare const mergeProps: <TProps extends Record<never, never>>(...propsObjectArray: Array<TProps | undefined>) => UnionToIntersection<TProps>;
+//#endregion
+export { mergeProps };
+//# sourceMappingURL=mergeProps.d.ts.map

package/dist/esm/utils/mergeProps.js

@@ -0,0 +1,31 @@
+import { mergeTwoProps } from "./mergeTwoProps.js";
+
+//#region src/utils/mergeProps.ts
+/**
+* Merges multiple sets of React props.
+*
+* - It follows the Object.assign pattern where the rightmost object's fields overwrite
+* the conflicting ones from others. This doesn't apply to event handlers, `className` and `style` props.
+* - Event handlers are merged such that they are called in sequence (the rightmost one being called first),
+* and allows the user to prevent the previous event handlers from being executed by calling the `preventDefault` method.
+* - It also merges the `className` and `style` props, whereby the classes are concatenated
+* and the rightmost styles overwrite the previous ones.
+*
+* @important **`ref` is not merged.**
+* @param props props to merge.
+* @returns the merged props.
+*/
+const mergeProps = (...propsObjectArray) => {
+	if (propsObjectArray.length === 0) return {};
+	if (propsObjectArray.length === 1) return propsObjectArray[0];
+	let accumulatedProps = {};
+	for (const propsObject of propsObjectArray) {
+		if (!propsObject) continue;
+		accumulatedProps = mergeTwoProps(accumulatedProps, propsObject);
+	}
+	return accumulatedProps;
+};
+
+//#endregion
+export { mergeProps };
+//# sourceMappingURL=mergeProps.js.map

package/dist/esm/utils/mergeProps.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mergeProps.js","names":["accumulatedProps: Record<string, unknown>"],"sources":["../../../src/utils/mergeProps.ts"],"sourcesContent":["import { mergeTwoProps } from \"./mergeTwoProps\";\n\ntype UnionToIntersection<TUnion> =\n\t(TUnion extends unknown ? (param: TUnion) => void : \"\") extends (param: infer TParam) => void ? TParam\n\t:\t\"\";\n\n/**\n * Merges multiple sets of React props.\n *\n * - It follows the Object.assign pattern where the rightmost object's fields overwrite\n * the conflicting ones from others. This doesn't apply to event handlers, `className` and `style` props.\n * - Event handlers are merged such that they are called in sequence (the rightmost one being called first),\n * and allows the user to prevent the previous event handlers from being executed by calling the `preventDefault` method.\n * - It also merges the `className` and `style` props, whereby the classes are concatenated\n * and the rightmost styles overwrite the previous ones.\n *\n * @important **`ref` is not merged.**\n * @param props props to merge.\n * @returns the merged props.\n */\n\nconst mergeProps = <TProps extends Record<never, never>>(\n\t...propsObjectArray: Array<TProps | undefined>\n): UnionToIntersection<TProps> => {\n\tif (propsObjectArray.length === 0) {\n\t\treturn {} as never;\n\t}\n\n\tif (propsObjectArray.length === 1) {\n\t\treturn propsObjectArray[0] as never;\n\t}\n\n\tlet accumulatedProps: Record<string, unknown> = {};\n\n\tfor (const propsObject of propsObjectArray) {\n\t\tif (!propsObject) continue;\n\n\t\taccumulatedProps = mergeTwoProps(accumulatedProps, propsObject);\n\t}\n\n\treturn accumulatedProps as never;\n};\n\nexport { mergeProps };\n"],"mappings":";;;;;;;;;;;;;;;;;AAqBA,MAAM,cACL,GAAG,qBAC8B;AACjC,KAAI,iBAAiB,WAAW,EAC/B,QAAO,EAAE;AAGV,KAAI,iBAAiB,WAAW,EAC/B,QAAO,iBAAiB;CAGzB,IAAIA,mBAA4C,EAAE;AAElD,MAAK,MAAM,eAAe,kBAAkB;AAC3C,MAAI,CAAC,YAAa;AAElB,qBAAmB,cAAc,kBAAkB,YAAY;;AAGhE,QAAO"}

package/dist/esm/utils/mergeTwoProps.d.ts

@@ -0,0 +1,5 @@
+//#region src/utils/mergeTwoProps.d.ts
+declare const mergeTwoProps: <TProps extends Record<never, never>>(formerProps: TProps | undefined, latterProps: TProps | undefined) => TProps;
+//#endregion
+export { mergeTwoProps };
+//# sourceMappingURL=mergeTwoProps.d.ts.map

package/dist/esm/utils/mergeTwoProps.js

@@ -0,0 +1,42 @@
+import { composeTwoEventHandlers } from "./composeEventHandlers.js";
+import { isFunction } from "@zayne-labs/toolkit-type-helpers";
+
+//#region src/utils/mergeTwoProps.ts
+const isEventHandler = (key, value) => {
+	const thirdCharCode = key.codePointAt(2);
+	if (!isFunction(value) || thirdCharCode === void 0) return false;
+	return key.startsWith("on") && thirdCharCode >= 65 && thirdCharCode <= 90;
+};
+const mergeTwoClassNames = (formerClassName, latterClassName) => {
+	if (!latterClassName || !formerClassName) return latterClassName || formerClassName;
+	return formerClassName + " " + latterClassName;
+};
+const mergeTwoProps = (formerProps, latterProps) => {
+	if (!latterProps || !formerProps) return latterProps ?? formerProps ?? {};
+	const propsAccumulator = { ...formerProps };
+	for (const latterPropName of Object.keys(latterProps)) {
+		const formerPropValue = formerProps[latterPropName];
+		const latterPropValue = latterProps[latterPropName];
+		if (latterPropName === "className" || latterPropName === "class") {
+			propsAccumulator[latterPropName] = mergeTwoClassNames(formerPropValue, latterPropValue);
+			continue;
+		}
+		if (latterPropName === "style") {
+			propsAccumulator[latterPropName] = {
+				...formerPropValue,
+				...latterPropValue
+			};
+			continue;
+		}
+		if (isEventHandler(latterPropName, latterPropValue)) {
+			propsAccumulator[latterPropName] = composeTwoEventHandlers(formerPropValue, latterPropValue);
+			continue;
+		}
+		propsAccumulator[latterPropName] = latterPropValue;
+	}
+	return propsAccumulator;
+};
+
+//#endregion
+export { mergeTwoProps };
+//# sourceMappingURL=mergeTwoProps.js.map

package/dist/esm/utils/mergeTwoProps.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mergeTwoProps.js","names":[],"sources":["../../../src/utils/mergeTwoProps.ts"],"sourcesContent":["import { type AnyFunction, isFunction } from \"@zayne-labs/toolkit-type-helpers\";\nimport { composeTwoEventHandlers } from \"./composeEventHandlers\";\n\n// == This approach is more efficient than using a regex.\nconst isEventHandler = (key: string, value: unknown): value is AnyFunction => {\n\tconst thirdCharCode = key.codePointAt(2);\n\n\tif (!isFunction(value) || thirdCharCode === undefined) {\n\t\treturn false;\n\t}\n\n\tconst isHandler = key.startsWith(\"on\") && thirdCharCode >= 65 /* A */ && thirdCharCode <= 90; /* Z */\n\n\treturn isHandler;\n};\n\nconst mergeTwoClassNames = (formerClassName: string | undefined, latterClassName: string | undefined) => {\n\tif (!latterClassName || !formerClassName) {\n\t\t// eslint-disable-next-line ts-eslint/prefer-nullish-coalescing -- Logical OR is fit for this case\n\t\treturn latterClassName || formerClassName;\n\t}\n\n\t// eslint-disable-next-line prefer-template -- String concatenation is more performant than template literals in this case\n\treturn formerClassName + \" \" + latterClassName;\n};\n\nexport const mergeTwoProps = <TProps extends Record<never, never>>(\n\tformerProps: TProps | undefined,\n\tlatterProps: TProps | undefined\n): TProps => {\n\t// == If no props are provided, return an empty object\n\tif (!latterProps || !formerProps) {\n\t\treturn latterProps ?? formerProps ?? ({} as TProps);\n\t}\n\n\tconst propsAccumulator = { ...formerProps } as Record<string, unknown>;\n\n\tfor (const latterPropName of Object.keys(latterProps)) {\n\t\tconst formerPropValue = (formerProps as Record<string, unknown>)[latterPropName];\n\t\tconst latterPropValue = (latterProps as Record<string, unknown>)[latterPropName];\n\n\t\t// == If the prop is `className` or `class`, we merge them\n\t\tif (latterPropName === \"className\" || latterPropName === \"class\") {\n\t\t\tpropsAccumulator[latterPropName] = mergeTwoClassNames(\n\t\t\t\tformerPropValue as string,\n\t\t\t\tlatterPropValue as string\n\t\t\t);\n\t\t\tcontinue;\n\t\t}\n\n\t\t// == If the prop is `style`, we merge them\n\t\tif (latterPropName === \"style\") {\n\t\t\tpropsAccumulator[latterPropName] = {\n\t\t\t\t...(formerPropValue as object),\n\t\t\t\t...(latterPropValue as object),\n\t\t\t};\n\t\t\tcontinue;\n\t\t}\n\n\t\t// == If the handler exists on both, we compose them\n\t\tif (isEventHandler(latterPropName, latterPropValue)) {\n\t\t\tpropsAccumulator[latterPropName] = composeTwoEventHandlers(\n\t\t\t\tformerPropValue as AnyFunction | undefined,\n\t\t\t\tlatterPropValue\n\t\t\t);\n\n\t\t\tcontinue;\n\t\t}\n\n\t\t// == latterProps override by default\n\t\tpropsAccumulator[latterPropName] = latterPropValue;\n\t}\n\n\treturn propsAccumulator as TProps;\n};\n"],"mappings":";;;;AAIA,MAAM,kBAAkB,KAAa,UAAyC;CAC7E,MAAM,gBAAgB,IAAI,YAAY,EAAE;AAExC,KAAI,CAAC,WAAW,MAAM,IAAI,kBAAkB,OAC3C,QAAO;AAKR,QAFkB,IAAI,WAAW,KAAK,IAAI,iBAAiB,MAAc,iBAAiB;;AAK3F,MAAM,sBAAsB,iBAAqC,oBAAwC;AACxG,KAAI,CAAC,mBAAmB,CAAC,gBAExB,QAAO,mBAAmB;AAI3B,QAAO,kBAAkB,MAAM;;AAGhC,MAAa,iBACZ,aACA,gBACY;AAEZ,KAAI,CAAC,eAAe,CAAC,YACpB,QAAO,eAAe,eAAgB,EAAE;CAGzC,MAAM,mBAAmB,EAAE,GAAG,aAAa;AAE3C,MAAK,MAAM,kBAAkB,OAAO,KAAK,YAAY,EAAE;EACtD,MAAM,kBAAmB,YAAwC;EACjE,MAAM,kBAAmB,YAAwC;AAGjE,MAAI,mBAAmB,eAAe,mBAAmB,SAAS;AACjE,oBAAiB,kBAAkB,mBAClC,iBACA,gBACA;AACD;;AAID,MAAI,mBAAmB,SAAS;AAC/B,oBAAiB,kBAAkB;IAClC,GAAI;IACJ,GAAI;IACJ;AACD;;AAID,MAAI,eAAe,gBAAgB,gBAAgB,EAAE;AACpD,oBAAiB,kBAAkB,wBAClC,iBACA,gBACA;AAED;;AAID,mBAAiB,kBAAkB;;AAGpC,QAAO"}

package/dist/esm/utils/types/common.d.ts

@@ -0,0 +1,43 @@
+import { UnionDiscriminator } from "@zayne-labs/toolkit-type-helpers";
+
+//#region src/utils/types/common.d.ts
+type ValidElementType = HTMLElement | React.ElementType;
+type ForwardedRefType<TElement extends ValidElementType> = TElement extends React.ElementType ? React.ForwardedRef<React.Ref<TElement>> : React.ForwardedRef<TElement>;
+type InferProps<TElement extends ValidElementType> = TElement extends React.ElementType ? React.ComponentProps<TElement> : React.HTMLAttributes<TElement>;
+type RemoveStringSignature<TObject extends object> = { [Key in keyof TObject as string extends Key ? never : Key]: TObject[Key] };
+type InferPropsStrict<TElement extends ValidElementType> = RemoveStringSignature<InferProps<TElement>>;
+type StateSetter<TSetter = unknown> = React.Dispatch<React.SetStateAction<TSetter>>;
+type CssWithCustomProperties<TExtra extends Record<string, string> = NonNullable<unknown>> = React.CSSProperties & Record<`--${string}`, string> & TExtra;
+type DefaultRenderItemErrorMessages = {
+  children: "Hey, Sorry but the children prop is redundant since you're currently using the render prop to do the same thing";
+  renderItem: "Hey, Sorry but the renderItem prop is redundant since you're currently using the children prop to do the same thing";
+};
+/**
+ * @description Represents a set of props that can be used to render a component conditionally based on a discriminated union type.
+ * This type allows for the use of either a render prop or children prop, but not both at the same time.
+ * If both are provided, a TypeScript error will be thrown.
+ * @template TErrorMessages An object of custom messages to display on the disallowed property.
+ */
+type DiscriminatedRenderItemProps<TRenderItemPropType, TErrorMessages extends Record<keyof DefaultRenderItemErrorMessages, string> = DefaultRenderItemErrorMessages> = UnionDiscriminator<[{
+  children: TRenderItemPropType;
+}, {
+  renderItem: TRenderItemPropType;
+}], TErrorMessages>;
+type DefaultRenderErrorMessages = {
+  children: "Hey, Sorry but the children prop is redundant since you're currently using the render prop to do the same thing";
+  render: "Hey, Sorry but the render prop is redundant since you're currently using the children prop to do the same thing";
+};
+/**
+ * @description Represents a set of props that can be used to render a component conditionally based on a discriminated union type.
+ * This type allows for the use of either a render prop or children prop, but not both at the same time.
+ * If both are provided, a TypeScript error will be thrown.
+ * @template TErrorMessages An object of custom messages to display on the disallowed property.
+ */
+type DiscriminatedRenderProps<TRenderPropType, TErrorMessages extends Record<keyof DefaultRenderErrorMessages, string> = DefaultRenderErrorMessages> = UnionDiscriminator<[{
+  children: TRenderPropType;
+}, {
+  render: TRenderPropType;
+}], TErrorMessages>;
+//#endregion
+export { CssWithCustomProperties, DefaultRenderErrorMessages, DefaultRenderItemErrorMessages, DiscriminatedRenderItemProps, DiscriminatedRenderProps, ForwardedRefType, InferProps, InferPropsStrict, StateSetter };
+//# sourceMappingURL=common.d.ts.map

package/dist/esm/utils/types/polymorphism.d.ts

@@ -0,0 +1,13 @@
+import { InferProps, InferPropsStrict } from "./common.js";
+import { AnyObject } from "@zayne-labs/toolkit-type-helpers";
+
+//#region src/utils/types/polymorphism.d.ts
+type AsProp<TElement extends React.ElementType> = {
+  as?: TElement;
+};
+type MergedGivenPropsWithAs<TElement extends React.ElementType, TProps> = Omit<AsProp<TElement>, keyof TProps> & TProps;
+type PolymorphicProps<TElement extends React.ElementType, TProps extends AnyObject = NonNullable<unknown>> = MergedGivenPropsWithAs<TElement, TProps> & Omit<InferProps<TElement>, keyof TProps>;
+type PolymorphicPropsStrict<TElement extends React.ElementType, TProps extends AnyObject = NonNullable<unknown>> = MergedGivenPropsWithAs<TElement, TProps> & Omit<InferPropsStrict<TElement>, keyof TProps>;
+//#endregion
+export { AsProp, PolymorphicProps, PolymorphicPropsStrict };
+//# sourceMappingURL=polymorphism.d.ts.map

package/dist/esm/zustand/createReactZustandStore.js

@@ -0,0 +1,8 @@
+import { createStore } from "@zayne-labs/toolkit-core";
+
+//#region src/zustand/createReactZustandStore.ts
+const createReactZustandStore = ((stateInitializer) => stateInitializer ? createStore(stateInitializer) : createStore);
+
+//#endregion
+export { createReactZustandStore };
+//# sourceMappingURL=createReactZustandStore.js.map

package/dist/esm/zustand/createReactZustandStore.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createReactZustandStore.js","names":[],"sources":["../../../src/zustand/createReactZustandStore.ts"],"sourcesContent":["import { createStore, type StoreApi } from \"@zayne-labs/toolkit-core\";\nimport type { Mutate, StateCreator, StoreMutatorIdentifier, UseBoundStore } from \"./types\";\n\ntype Create = {\n\t<T, Mos extends Array<[StoreMutatorIdentifier, unknown]> = []>(\n\t\tinitializer: StateCreator<T, [], Mos>\n\t): UseBoundStore<Mutate<StoreApi<T>, Mos>>;\n\t<T>(): <Mos extends Array<[StoreMutatorIdentifier, unknown]> = []>(\n\t\tinitializer: StateCreator<T, [], Mos>\n\t) => UseBoundStore<Mutate<StoreApi<T>, Mos>>;\n};\n\nexport const createReactZustandStore = (<TState>(stateInitializer: StateCreator<TState> | undefined) =>\n\tstateInitializer ? createStore(stateInitializer) : createStore) as Create;\n"],"mappings":";;;AAYA,MAAa,4BAAoC,qBAChD,mBAAmB,YAAY,iBAAiB,GAAG"}

package/dist/esm/zustand/createZustandContext.d.ts

@@ -0,0 +1,13 @@
+import { CustomContextOptions } from "../hooks/createCustomContext.js";
+import * as react11 from "react";
+import { StoreApi } from "@zayne-labs/toolkit-core";
+import { SelectorFn } from "@zayne-labs/toolkit-type-helpers";
+
+//#region src/zustand/createZustandContext.d.ts
+declare const createZustandContext: <TState extends Record<string, unknown>, TStore extends StoreApi<TState> = StoreApi<TState>>(options?: CustomContextOptions<TStore, true>) => [ZustandStoreContextProvider: (props: {
+  children: React.ReactNode;
+  store: TStore;
+}) => react11.FunctionComponentElement<react11.ProviderProps<TStore>>, useZustandStoreContext: <TResult = TState>(selector?: SelectorFn<TState, TResult>) => TResult];
+//#endregion
+export { createZustandContext };
+//# sourceMappingURL=createZustandContext.d.ts.map

package/dist/esm/zustand/createZustandContext.js

@@ -0,0 +1,21 @@
+import { createCustomContext } from "../hooks/createCustomContext.js";
+import { useStore } from "../hooks/useStore.js";
+import { createElement } from "react";
+
+//#region src/zustand/createZustandContext.ts
+const createZustandContext = (options) => {
+	const [Provider, useCustomContext] = createCustomContext(options);
+	function ZustandStoreContextProvider(props) {
+		const { children, store } = props;
+		return createElement(Provider, { value: store }, children);
+	}
+	const useZustandStoreContext = (selector) => {
+		const zustandStore = useCustomContext();
+		return useStore(zustandStore, selector);
+	};
+	return [ZustandStoreContextProvider, useZustandStoreContext];
+};
+
+//#endregion
+export { createZustandContext };
+//# sourceMappingURL=createZustandContext.js.map

package/dist/esm/zustand/createZustandContext.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createZustandContext.js","names":[],"sources":["../../../src/zustand/createZustandContext.ts"],"sourcesContent":["import type { StoreApi } from \"@zayne-labs/toolkit-core\";\nimport type { SelectorFn } from \"@zayne-labs/toolkit-type-helpers\";\nimport { createElement } from \"react\";\nimport { type CustomContextOptions, createCustomContext, useStore } from \"../hooks\";\n\nconst createZustandContext = <\n\tTState extends Record<string, unknown>,\n\tTStore extends StoreApi<TState> = StoreApi<TState>,\n>(\n\toptions?: CustomContextOptions<TStore, true>\n) => {\n\tconst [Provider, useCustomContext] = createCustomContext(options);\n\n\ttype ZustandStoreContextProviderProps = {\n\t\tchildren: React.ReactNode;\n\t\tstore: TStore;\n\t};\n\n\tfunction ZustandStoreContextProvider(props: ZustandStoreContextProviderProps) {\n\t\tconst { children, store } = props;\n\n\t\treturn createElement(Provider, { value: store }, children);\n\t}\n\n\tconst useZustandStoreContext = <TResult = TState>(selector?: SelectorFn<TState, TResult>): TResult => {\n\t\tconst zustandStore = useCustomContext();\n\n\t\treturn useStore(zustandStore, selector);\n\t};\n\n\treturn [ZustandStoreContextProvider, useZustandStoreContext] as [\n\t\tZustandStoreContextProvider: typeof ZustandStoreContextProvider,\n\t\tuseZustandStoreContext: typeof useZustandStoreContext,\n\t];\n};\n\nexport { createZustandContext };\n"],"mappings":";;;;;AAKA,MAAM,wBAIL,YACI;CACJ,MAAM,CAAC,UAAU,oBAAoB,oBAAoB,QAAQ;CAOjE,SAAS,4BAA4B,OAAyC;EAC7E,MAAM,EAAE,UAAU,UAAU;AAE5B,SAAO,cAAc,UAAU,EAAE,OAAO,OAAO,EAAE,SAAS;;CAG3D,MAAM,0BAA4C,aAAoD;EACrG,MAAM,eAAe,kBAAkB;AAEvC,SAAO,SAAS,cAAc,SAAS;;AAGxC,QAAO,CAAC,6BAA6B,uBAAuB"}

package/dist/esm/zustand/createZustandStoreWithCombine.d.ts

@@ -0,0 +1,12 @@
+import { StateCreator, StoreMutatorIdentifier, UseBoundStore } from "./types.js";
+import * as _zayne_labs_toolkit_core7 from "@zayne-labs/toolkit-core";
+import { AnyObject, Prettify } from "@zayne-labs/toolkit-type-helpers";
+
+//#region src/zustand/createZustandStoreWithCombine.d.ts
+type Write<TInitialState, TExtraState> = Prettify<Omit<TInitialState, keyof TExtraState> & TExtraState>;
+declare const combine: <TInitialState extends AnyObject, TExtraState extends AnyObject, Mps extends Array<[StoreMutatorIdentifier, unknown]> = [], Mcs extends Array<[StoreMutatorIdentifier, unknown]> = []>(initialState: TInitialState, storeCreator: StateCreator<TInitialState, Mps, Mcs, TExtraState>) => StateCreator<Write<TInitialState, TExtraState>, Mps, Mcs>;
+declare const createStoreWithCombine: <TInitialState extends AnyObject, TExtraState extends AnyObject>(...params: Parameters<typeof combine<TInitialState, TExtraState>>) => _zayne_labs_toolkit_core7.StoreApi<Omit<TInitialState, keyof TExtraState> & TExtraState extends infer T ? { [Key in keyof T]: T[Key] } : never>;
+declare const createWithCombine: <TInitialState extends AnyObject, TExtraState extends AnyObject>(...params: Parameters<typeof combine<TInitialState, TExtraState>>) => UseBoundStore<_zayne_labs_toolkit_core7.StoreApi<Omit<TInitialState, keyof TExtraState> & TExtraState extends infer T ? { [Key in keyof T]: T[Key] } : never>>;
+//#endregion
+export { combine, createStoreWithCombine, createWithCombine };
+//# sourceMappingURL=createZustandStoreWithCombine.d.ts.map

package/dist/esm/zustand/createZustandStoreWithCombine.js

@@ -0,0 +1,14 @@
+import { createReactZustandStore } from "./createReactZustandStore.js";
+import { createStore } from "@zayne-labs/toolkit-core";
+
+//#region src/zustand/createZustandStoreWithCombine.ts
+const combine = (initialState, storeCreator) => (...params) => ({
+	...initialState,
+	...storeCreator(...params)
+});
+const createStoreWithCombine = (...params) => createStore(combine(...params));
+const createWithCombine = (...params) => createReactZustandStore(combine(...params));
+
+//#endregion
+export { combine, createStoreWithCombine, createWithCombine };
+//# sourceMappingURL=createZustandStoreWithCombine.js.map

package/dist/esm/zustand/createZustandStoreWithCombine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createZustandStoreWithCombine.js","names":[],"sources":["../../../src/zustand/createZustandStoreWithCombine.ts"],"sourcesContent":["import { createStore } from \"@zayne-labs/toolkit-core\";\nimport type { AnyFunction, AnyObject, Prettify } from \"@zayne-labs/toolkit-type-helpers\";\nimport { createReactZustandStore } from \"./createReactZustandStore\";\nimport type { StateCreator, StoreMutatorIdentifier } from \"./types\";\n\ntype Write<TInitialState, TExtraState> = Prettify<Omit<TInitialState, keyof TExtraState> & TExtraState>;\n\nexport const combine =\n\t<\n\t\tTInitialState extends AnyObject,\n\t\tTExtraState extends AnyObject,\n\t\tMps extends Array<[StoreMutatorIdentifier, unknown]> = [],\n\t\tMcs extends Array<[StoreMutatorIdentifier, unknown]> = [],\n\t>(\n\t\tinitialState: TInitialState,\n\t\tstoreCreator: StateCreator<TInitialState, Mps, Mcs, TExtraState>\n\t): StateCreator<Write<TInitialState, TExtraState>, Mps, Mcs> =>\n\t// eslint-disable-next-line ts-eslint/no-unsafe-return -- We don't know what the storeCreator will return\n\t(...params) => ({\n\t\t...initialState,\n\t\t...(storeCreator as AnyFunction)(...params),\n\t});\n\nexport const createStoreWithCombine = <TInitialState extends AnyObject, TExtraState extends AnyObject>(\n\t...params: Parameters<typeof combine<TInitialState, TExtraState>>\n) => createStore(combine(...params));\n\nexport const createWithCombine = <TInitialState extends AnyObject, TExtraState extends AnyObject>(\n\t...params: Parameters<typeof combine<TInitialState, TExtraState>>\n) => createReactZustandStore(combine(...params));\n"],"mappings":";;;;AAOA,MAAa,WAOX,cACA,kBAGA,GAAG,YAAY;CACf,GAAG;CACH,GAAI,aAA6B,GAAG,OAAO;CAC3C;AAEF,MAAa,0BACZ,GAAG,WACC,YAAY,QAAQ,GAAG,OAAO,CAAC;AAEpC,MAAa,qBACZ,GAAG,WACC,wBAAwB,QAAQ,GAAG,OAAO,CAAC"}

package/dist/esm/zustand/createZustandStoreWithSubscribe.d.ts

@@ -0,0 +1,17 @@
+import { Mutate, StateCreator, StoreMutatorIdentifier, UseBoundStore } from "./types.js";
+import { StoreApi } from "@zayne-labs/toolkit-core";
+
+//#region src/zustand/createZustandStoreWithSubscribe.d.ts
+type CreateStoreWithSubscribe = {
+  <T, Mos extends Array<[StoreMutatorIdentifier, unknown]> = []>(initializer: StateCreator<T, [], Mos>): Mutate<StoreApi<T>, Mos>;
+  <T>(): <Mos extends Array<[StoreMutatorIdentifier, unknown]> = []>(initializer: StateCreator<T, [], Mos>) => Mutate<StoreApi<T>, Mos>;
+};
+declare const createStoreWithSubscribe: CreateStoreWithSubscribe;
+type CreateWithSubscribe = {
+  <T, Mos extends Array<[StoreMutatorIdentifier, unknown]> = []>(initializer: StateCreator<T, [], Mos>): UseBoundStore<Mutate<StoreApi<T>, Mos>>;
+  <T>(): <Mos extends Array<[StoreMutatorIdentifier, unknown]> = []>(initializer: StateCreator<T, [], Mos>) => UseBoundStore<Mutate<StoreApi<T>, Mos>>;
+};
+declare const createWithSubscribe: CreateWithSubscribe;
+//#endregion
+export { createStoreWithSubscribe, createWithSubscribe };
+//# sourceMappingURL=createZustandStoreWithSubscribe.d.ts.map

package/dist/esm/zustand/createZustandStoreWithSubscribe.js

@@ -0,0 +1,16 @@
+import { useStore } from "../hooks/useStore.js";
+import { createStore } from "@zayne-labs/toolkit-core";
+
+//#region src/zustand/createZustandStoreWithSubscribe.ts
+const createStoreWithSubscribe = ((stateInitializer) => stateInitializer ? createStore(stateInitializer) : createStore);
+const createWithSubscribeImpl = (createState) => {
+	const store = createStore(createState);
+	const useBoundStore = (selector) => useStore(store, selector);
+	Object.assign(useBoundStore, store);
+	return useBoundStore;
+};
+const createWithSubscribe = ((stateInitializer) => stateInitializer ? createWithSubscribeImpl(stateInitializer) : createWithSubscribeImpl);
+
+//#endregion
+export { createStoreWithSubscribe, createWithSubscribe };
+//# sourceMappingURL=createZustandStoreWithSubscribe.js.map

package/dist/esm/zustand/createZustandStoreWithSubscribe.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createZustandStoreWithSubscribe.js","names":[],"sources":["../../../src/zustand/createZustandStoreWithSubscribe.ts"],"sourcesContent":["import { createStore, type StoreApi } from \"@zayne-labs/toolkit-core\";\nimport type { SelectorFn } from \"@zayne-labs/toolkit-type-helpers\";\nimport { useStore } from \"../hooks\";\nimport type { Mutate, StateCreator, StoreMutatorIdentifier, UseBoundStore } from \"./types\";\n\ntype CreateStoreWithSubscribe = {\n\t<T, Mos extends Array<[StoreMutatorIdentifier, unknown]> = []>(\n\t\tinitializer: StateCreator<T, [], Mos>\n\t): Mutate<StoreApi<T>, Mos>;\n\n\t<T>(): <Mos extends Array<[StoreMutatorIdentifier, unknown]> = []>(\n\t\tinitializer: StateCreator<T, [], Mos>\n\t) => Mutate<StoreApi<T>, Mos>;\n};\n\nexport const createStoreWithSubscribe = (<TState>(stateInitializer: StateCreator<TState> | undefined) =>\n\tstateInitializer ? createStore(stateInitializer) : createStore) as CreateStoreWithSubscribe;\n\ntype CreateWithSubscribe = {\n\t<T, Mos extends Array<[StoreMutatorIdentifier, unknown]> = []>(\n\t\tinitializer: StateCreator<T, [], Mos>\n\t): UseBoundStore<Mutate<StoreApi<T>, Mos>>;\n\t<T>(): <Mos extends Array<[StoreMutatorIdentifier, unknown]> = []>(\n\t\tinitializer: StateCreator<T, [], Mos>\n\t) => UseBoundStore<Mutate<StoreApi<T>, Mos>>;\n};\n\nconst createWithSubscribeImpl = <TState>(createState: StateCreator<TState>) => {\n\tconst store = createStore(createState);\n\n\tconst useBoundStore = (selector?: SelectorFn<TState, unknown>) => useStore(store, selector);\n\n\tObject.assign(useBoundStore, store);\n\n\treturn useBoundStore;\n};\n\nexport const createWithSubscribe = (<TState>(stateInitializer: StateCreator<TState> | undefined) =>\n\tstateInitializer ?\n\t\tcreateWithSubscribeImpl(stateInitializer)\n\t:\tcreateWithSubscribeImpl) as CreateWithSubscribe;\n"],"mappings":";;;;AAeA,MAAa,6BAAqC,qBACjD,mBAAmB,YAAY,iBAAiB,GAAG;AAWpD,MAAM,2BAAmC,gBAAsC;CAC9E,MAAM,QAAQ,YAAY,YAAY;CAEtC,MAAM,iBAAiB,aAA2C,SAAS,OAAO,SAAS;AAE3F,QAAO,OAAO,eAAe,MAAM;AAEnC,QAAO;;AAGR,MAAa,wBAAgC,qBAC5C,mBACC,wBAAwB,iBAAiB,GACxC"}

package/dist/esm/zustand/index.d.ts

@@ -1,38 +1,4 @@
-import { CustomContextOptions } from "../index-ouFKofvj.js";
-import "../index-DlScRgBk.js";
-import * as react0 from "react";
-import { StoreApi } from "@zayne-labs/toolkit-core";
-import { AnyObject, Prettify, SelectorFn } from "@zayne-labs/toolkit-type-helpers";
-import * as zustand0 from "zustand";
-import { Mutate, StateCreator as StateCreator$1, StoreMutatorIdentifier, UseBoundStore } from "zustand";
-
-//#region src/zustand/createZustandContext.d.ts
-declare const createZustandContext: <TState extends Record<string, unknown>, TStore extends StoreApi<TState> = StoreApi<TState>>(options?: CustomContextOptions<TStore, true>) => [ZustandStoreContextProvider: (props: {
-  children: React.ReactNode;
-  store: TStore;
-}) => react0.FunctionComponentElement<react0.ProviderProps<TStore>>, useZustandStoreContext: <TResult = TState>(selector?: SelectorFn<TState, TResult>) => TResult];
-//#endregion
-//#region src/zustand/createZustandStoreWithCombine.d.ts
-type Write<TInitialState, TExtraState> = Prettify<Omit<TInitialState, keyof TExtraState> & TExtraState>;
-declare const combine: <TInitialState extends AnyObject, TExtraState extends AnyObject, Mps extends Array<[StoreMutatorIdentifier, unknown]> = [], Mcs extends Array<[StoreMutatorIdentifier, unknown]> = []>(initialState: TInitialState, storeCreator: StateCreator$1<TInitialState, Mps, Mcs, TExtraState>) => StateCreator$1<Write<TInitialState, TExtraState>, Mps, Mcs>;
-declare const createStoreWithCombine: <TInitialState extends AnyObject, TExtraState extends AnyObject>(...params: Parameters<typeof combine<TInitialState, TExtraState>>) => zustand0.StoreApi<Omit<TInitialState, keyof TExtraState> & TExtraState extends infer T ? { [Key in keyof T]: T[Key] } : never>;
-declare const createWithCombine: <TInitialState extends AnyObject, TExtraState extends AnyObject>(...params: Parameters<typeof combine<TInitialState, TExtraState>>) => zustand0.UseBoundStore<zustand0.StoreApi<Omit<TInitialState, keyof TExtraState> & TExtraState extends infer T ? { [Key in keyof T]: T[Key] } : never>>;
-//#endregion
-//#region src/zustand/createZustandStoreWithSubscribe.d.ts
-type Get<T, K, F> = K extends keyof T ? T[K] : F;
-type StateCreator<T, Mis extends Array<[StoreMutatorIdentifier, unknown]> = [], Mos extends Array<[StoreMutatorIdentifier, unknown]> = [], U = T> = {
-  $$storeMutators?: Mos;
-} & ((setState: Get<Mutate<StoreApi<T>, Mis>, "setState", never>, getState: Get<Mutate<StoreApi<T>, Mis>, "getState", never>, store: Mutate<StoreApi<T>, Mis>) => U);
-type CreateStoreWithSubscribe = {
-  <T, Mos extends Array<[StoreMutatorIdentifier, unknown]> = []>(initializer: StateCreator<T, [], Mos>): Mutate<StoreApi<T>, Mos>;
-  <T>(): <Mos extends Array<[StoreMutatorIdentifier, unknown]> = []>(initializer: StateCreator<T, [], Mos>) => Mutate<StoreApi<T>, Mos>;
-};
-declare const createStoreWithSubscribe: CreateStoreWithSubscribe;
-type CreateWithSubscribe = {
-  <T, Mos extends Array<[StoreMutatorIdentifier, unknown]> = []>(initializer: StateCreator<T, [], Mos>): UseBoundStore<Mutate<StoreApi<T>, Mos>>;
-  <T>(): <Mos extends Array<[StoreMutatorIdentifier, unknown]> = []>(initializer: StateCreator<T, [], Mos>) => UseBoundStore<Mutate<StoreApi<T>, Mos>>;
-};
-declare const createWithSubscribe: CreateWithSubscribe;
-//#endregion
-export { StateCreator, combine, createStoreWithCombine, createStoreWithSubscribe, createWithCombine, createWithSubscribe, createZustandContext };
-//# sourceMappingURL=index.d.ts.map
+import { createZustandContext } from "./createZustandContext.js";
+import { combine, createStoreWithCombine, createWithCombine } from "./createZustandStoreWithCombine.js";
+import { createStoreWithSubscribe, createWithSubscribe } from "./createZustandStoreWithSubscribe.js";
+export { combine, createStoreWithCombine, createStoreWithSubscribe, createWithCombine, createWithSubscribe, createZustandContext };