@zayne-labs/toolkit-react 0.9.28 → 0.9.29

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

@@ -1,6 +1,6 @@
 import * as react from 'react';
 import { RefCallback } from 'react';
-import { UnknownObject, Prettify, UnionToIntersection as UnionToIntersection$1, UnionDiscriminator, AnyObject } from '@zayne-labs/toolkit-type-helpers';
+import { AnyFunction, UnknownObject, Prettify, UnionToIntersection as UnionToIntersection$1, UnionDiscriminator, AnyObject } from '@zayne-labs/toolkit-type-helpers';
 
 type PossibleRef<TRef> = React.Ref<TRef> | undefined;
 /**
@@ -12,10 +12,11 @@ declare const setRef: <TRef>(ref: PossibleRef<TRef>, node: TRef) => ReturnType<R
 /**
  * @description A utility to combine refs. Accepts callback refs and RefObject(s)
  */
-declare const composeRefs: <TRef extends HTMLElement>(refs: Array<PossibleRef<TRef>>) => RefCallback<TRef>;
+declare const composeRefs: <TRef extends HTMLElement>(...refs: Array<PossibleRef<TRef>>) => RefCallback<TRef>;
+declare const useComposeRefs: <TRef extends HTMLElement>(...refs: Array<PossibleRef<TRef>>) => () => RefCallback<TRef>;
 
-type PossibleEventHandler<TSyntheticEvent extends React.SyntheticEvent> = React.EventHandler<TSyntheticEvent> | undefined;
-declare const composeEventHandlers: <TSyntheticEvent extends React.SyntheticEvent>(eventHandlers: Array<PossibleEventHandler<TSyntheticEvent>>) => React.EventHandler<TSyntheticEvent>;
+declare const composeTwoEventHandlers: (formerHandler: AnyFunction | undefined, latterHandler: AnyFunction | undefined) => (event: unknown) => unknown;
+declare const composeEventHandlers: (...eventHandlerArray: Array<AnyFunction | undefined>) => (event: unknown) => unknown;
 
 type FunctionalComponent<TProps extends UnknownObject = never> = React.FunctionComponent<TProps>;
 /**
@@ -159,11 +160,23 @@ type SlotWithNameAndSymbol<TSlotComponentProps extends Pick<GetSlotComponentProp
 declare const withSlotNameAndSymbol: <TSlotComponentProps extends Pick<GetSlotComponentProps, "name">, TActualProps extends UnknownObject = UnknownObject>(name: TSlotComponentProps["name"], SlotComponent?: SlotWithNameAndSymbol<TSlotComponentProps, TActualProps>) => SlotWithNameAndSymbol<TSlotComponentProps, TActualProps>;
 
 type UnionToIntersection<TUnion> = (TUnion extends unknown ? (param: TUnion) => void : "") extends (param: infer TParam) => void ? TParam : "";
-type UnknownProps$1 = Record<never, never>;
-declare const mergeProps: <TProps extends UnknownProps$1>(...parameters: Array<TProps | undefined>) => UnionToIntersection<TProps>;
+/**
+ * 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>;
 
-type UnknownProps = Record<never, never>;
-declare const mergeTwoProps: <TProps extends UnknownProps>(slotProps: TProps | undefined, childProps: TProps | undefined) => TProps;
+declare const mergeTwoProps: <TProps extends Record<never, never>>(formerProps: TProps | undefined, latterProps: TProps | undefined) => TProps;
 
 type ForwardedRefType<TComponent extends HTMLElement | React.ElementType> = TComponent extends React.ElementType ? React.ForwardedRef<React.Ref<TComponent>> : React.ForwardedRef<TComponent>;
 type InferProps<TComponent extends HTMLElement | React.ElementType> = TComponent extends React.ElementType ? React.ComponentPropsWithRef<TComponent> : React.HTMLAttributes<TComponent>;
@@ -192,4 +205,4 @@ type InferRestOfProps<TElement extends React.ElementType, TProps> = Omit<React.C
 type MergedPropsWithAs<TElement extends React.ElementType, TProps> = Prettify<Omit<AsProp<TElement>, keyof TProps> & TProps>;
 type PolymorphicProps<TElement extends React.ElementType, TProps extends AnyObject = NonNullable<unknown>> = MergedPropsWithAs<TElement, TProps> & InferRestOfProps<TElement, TProps>;
 
-export { type AsProp, type CssWithCustomProperties, type DiscriminatedRenderProps, type ForwardedRefType, type FunctionalComponent, type GetSlotComponentProps, type InferProps, type PolymorphicProps, type StateSetter, composeEventHandlers, composeRefs, createSlotComponent, getMultipleSlots, getRegularChildren, getSingleSlot, getSlotMap, matchesAnySlotComponent, matchesSlotComponent, mergeProps, mergeTwoProps, setRef, slotComponentSymbol, withSlotNameAndSymbol };
+export { type AsProp, type CssWithCustomProperties, type DiscriminatedRenderProps, type ForwardedRefType, type FunctionalComponent, type GetSlotComponentProps, type InferProps, type PolymorphicProps, type StateSetter, composeEventHandlers, composeRefs, composeTwoEventHandlers, createSlotComponent, getMultipleSlots, getRegularChildren, getSingleSlot, getSlotMap, matchesAnySlotComponent, matchesSlotComponent, mergeProps, mergeTwoProps, setRef, slotComponentSymbol, useComposeRefs, withSlotNameAndSymbol };

package/dist/esm/utils/index.js

@@ -1,6 +1,6 @@
-import { isFunction, isArray, isPlainObject, AssertionError } from '@zayne-labs/toolkit-type-helpers';
-import { toArray, mergeClassNames, mergeFunctions } from '@zayne-labs/toolkit-core';
-import { isValidElement, Fragment } from 'react';
+import { isFunction, isArray, isObject, AssertionError } from '@zayne-labs/toolkit-type-helpers';
+import { useCallback, isValidElement, Fragment } from 'react';
+import { toArray } from '@zayne-labs/toolkit-core';
 
 // src/utils/composeRefs.ts
 var setRef = (ref, node) => {
@@ -10,22 +10,49 @@ var setRef = (ref, node) => {
   }
   ref.current = node;
 };
-var composeRefs = (refs) => {
+var composeRefs = (...refs) => {
   const mergedRefCallBack = (node) => {
     const cleanupFnArray = refs.map((ref) => setRef(ref, node));
     const cleanupFn = () => cleanupFnArray.forEach((cleanup) => cleanup?.());
-    if (!node) {
-      cleanupFn();
-      return;
-    }
     return cleanupFn;
   };
   return mergedRefCallBack;
 };
-
-// src/utils/composeEventHandlers.ts
-var composeEventHandlers = (eventHandlers) => {
-  const mergedEventHandler = (event) => eventHandlers.forEach((handler) => handler?.(event));
+var useComposeRefs = (...refs) => {
+  const mergedRef = useCallback(() => composeRefs(...refs), refs);
+  return mergedRef;
+};
+var isSyntheticEvent = (event) => {
+  return isObject(event) && Object.hasOwn(event, "nativeEvent");
+};
+var composeTwoEventHandlers = (formerHandler, latterHandler) => {
+  const mergedEventHandler = (event) => {
+    if (isSyntheticEvent(event)) {
+      const result2 = latterHandler?.(event);
+      if (!event.defaultPrevented) {
+        formerHandler?.(event);
+      }
+      return result2;
+    }
+    const result = latterHandler?.(event);
+    formerHandler?.(event);
+    return result;
+  };
+  return mergedEventHandler;
+};
+var composeEventHandlers = (...eventHandlerArray) => {
+  const mergedEventHandler = (event) => {
+    if (eventHandlerArray.length === 0) return;
+    if (eventHandlerArray.length === 1) {
+      return eventHandlerArray[0]?.(event);
+    }
+    let accumulatedHandlers;
+    for (const eventHandler of eventHandlerArray) {
+      if (!eventHandler) continue;
+      accumulatedHandlers = composeTwoEventHandlers(accumulatedHandlers, eventHandler);
+    }
+    return accumulatedHandlers?.(event);
+  };
   return mergedEventHandler;
 };
 var isWithSlotSymbol = (component) => {
@@ -141,66 +168,70 @@ var withSlotNameAndSymbol = (name, SlotComponent = (props) => props.children) =>
   SlotComponent.slotName = name;
   return SlotComponent;
 };
-var handleMergePropsIntoResult = (mergedResult, propsObject) => {
-  for (const propName of Object.keys(mergedResult)) {
-    const mergedResultValue = mergedResult[propName];
-    const propsObjectValue = propsObject[propName];
-    if (propName === "className" || propName === "class") {
-      mergedResult[propName] = mergeClassNames(mergedResultValue, propsObjectValue);
-      continue;
-    }
-    if (propName === "style" && isPlainObject(mergedResultValue) && isPlainObject(propsObjectValue)) {
-      mergedResult[propName] = { ...mergedResultValue, ...propsObjectValue };
-      continue;
-    }
-    const isHandler = propName.startsWith("on");
-    if (isHandler && isFunction(mergedResultValue) && isFunction(propsObjectValue)) {
-      mergedResult[propName] = mergeFunctions(propsObjectValue, mergedResultValue);
-      continue;
-    }
-    mergedResult[propName] = propsObjectValue !== void 0 ? propsObjectValue : mergedResultValue;
-  }
-};
-var addMissingPropsToResult = (mergedResult, propsObject) => {
-  for (const propName of Object.keys(propsObject)) {
-    if (mergedResult[propName] === void 0) {
-      mergedResult[propName] = propsObject[propName];
-    }
+var isEventHandler = (key, value) => {
+  const thirdCharCode = key.codePointAt(2);
+  if (!isFunction(value) || thirdCharCode === void 0) {
+    return false;
   }
+  const isHandler = key.startsWith("on") && thirdCharCode >= 65 && thirdCharCode <= 90;
+  return isHandler;
 };
-var mergeProps = (...parameters) => {
-  const mergedResult = {};
-  for (const propsObject of parameters) {
-    if (!propsObject) continue;
-    handleMergePropsIntoResult(mergedResult, propsObject);
-    addMissingPropsToResult(mergedResult, propsObject);
+var mergeTwoClassNames = (formerClassName, latterClassName) => {
+  if (!latterClassName || !formerClassName) {
+    return latterClassName || formerClassName;
   }
-  return mergedResult;
+  return formerClassName + " " + latterClassName;
 };
-var mergeTwoProps = (slotProps, childProps) => {
-  if (!slotProps || !childProps) {
-    return childProps ?? slotProps ?? {};
+var mergeTwoProps = (formerProps, latterProps) => {
+  if (!latterProps || !formerProps) {
+    return latterProps ?? formerProps ?? {};
   }
-  const overrideProps = { ...childProps };
-  for (const propName of Object.keys(slotProps)) {
-    const slotPropValue = slotProps[propName];
-    const childPropValue = childProps[propName];
-    if (propName === "style" && isPlainObject(slotPropValue) && isPlainObject(childPropValue)) {
-      overrideProps[propName] = { ...slotPropValue, ...childPropValue };
+  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 (propName === "className" || propName === "class") {
-      overrideProps[propName] = mergeClassNames(slotPropValue, childPropValue);
+    if (latterPropName === "style") {
+      propsAccumulator[latterPropName] = {
+        ...formerPropValue,
+        ...latterPropValue
+      };
       continue;
     }
-    const isHandler = propName.startsWith("on");
-    if (isHandler && isFunction(slotPropValue) && isFunction(childPropValue)) {
-      overrideProps[propName] = mergeFunctions(childPropValue, slotPropValue);
+    if (isEventHandler(latterPropName, latterPropValue)) {
+      propsAccumulator[latterPropName] = composeTwoEventHandlers(
+        formerPropValue,
+        latterPropValue
+      );
+      continue;
     }
+    propsAccumulator[latterPropName] = latterPropValue;
+  }
+  return propsAccumulator;
+};
+
+// src/utils/mergeProps.ts
+var 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 { ...slotProps, ...overrideProps };
+  return accumulatedProps;
 };
 
-export { composeEventHandlers, composeRefs, createSlotComponent, getMultipleSlots, getRegularChildren, getSingleSlot, getSlotMap, matchesAnySlotComponent, matchesSlotComponent, mergeProps, mergeTwoProps, setRef, slotComponentSymbol, withSlotNameAndSymbol };
+export { composeEventHandlers, composeRefs, composeTwoEventHandlers, createSlotComponent, getMultipleSlots, getRegularChildren, getSingleSlot, getSlotMap, matchesAnySlotComponent, matchesSlotComponent, mergeProps, mergeTwoProps, setRef, slotComponentSymbol, useComposeRefs, withSlotNameAndSymbol };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

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

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/utils/composeRefs.ts","../../../src/utils/composeEventHandlers.ts","../../../src/utils/getSlot.ts","../../../src/utils/getSlotMap.ts","../../../src/utils/mergeProps.ts","../../../src/utils/mergeTwoProps.ts"],"names":["isFunction","ReactFragment","isValidElement","toArray","isPlainObject","mergeClassNames","mergeFunctions"],"mappings":"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","file":"index.js","sourcesContent":["import { isFunction } from \"@zayne-labs/toolkit-type-helpers\";\nimport type { RefCallback } from \"react\";\n\ntype PossibleRef<TRef> = React.Ref<TRef> | undefined;\n\n/**\n * @description Set a given ref to a given value.\n *\n * This utility takes care of different types of refs: callback refs and RefObject(s)\n */\nexport const setRef = <TRef>(ref: PossibleRef<TRef>, node: TRef): ReturnType<RefCallback<TRef>> => {\n\tif (!ref) return;\n\n\tif (isFunction(ref)) {\n\t\treturn ref(node);\n\t}\n\n\t// eslint-disable-next-line no-param-reassign -- Mutation is needed here\n\tref.current = node;\n};\n\n/**\n * @description A utility to combine refs. Accepts callback refs and RefObject(s)\n */\nexport const composeRefs = <TRef extends HTMLElement>(\n\trefs: Array<PossibleRef<TRef>>\n): RefCallback<TRef> => {\n\tconst mergedRefCallBack: RefCallback<TRef> = (node) => {\n\t\tconst cleanupFnArray = refs.map((ref) => setRef(ref, node));\n\n\t\tconst cleanupFn = () => cleanupFnArray.forEach((cleanup) => cleanup?.());\n\n\t\t// == React 18 may not call the cleanup function so we need to call it manually on element unmount\n\t\tif (!node) {\n\t\t\tcleanupFn();\n\t\t\treturn;\n\t\t}\n\n\t\treturn cleanupFn;\n\t};\n\n\treturn mergedRefCallBack;\n};\n","type PossibleEventHandler<TSyntheticEvent extends React.SyntheticEvent> =\n\t| React.EventHandler<TSyntheticEvent>\n\t| undefined;\n\nexport const composeEventHandlers = <TSyntheticEvent extends React.SyntheticEvent>(\n\teventHandlers: Array<PossibleEventHandler<TSyntheticEvent>>\n): React.EventHandler<TSyntheticEvent> => {\n\t// prettier-ignore\n\tconst mergedEventHandler: React.EventHandler<TSyntheticEvent> = (event) => eventHandlers.forEach((handler) => handler?.(event));\n\n\treturn mergedEventHandler;\n};\n","import { toArray } from \"@zayne-labs/toolkit-core\";\nimport {\n\ttype AnyFunction,\n\tAssertionError,\n\ttype Prettify,\n\ttype UnknownObject,\n\tisArray,\n\tisFunction,\n} from \"@zayne-labs/toolkit-type-helpers\";\nimport { Fragment as ReactFragment, isValidElement } from \"react\";\nimport type { InferProps } from \"./types\";\n\nexport type FunctionalComponent<TProps extends UnknownObject = never> = React.FunctionComponent<TProps>;\n\nconst isWithSlotSymbol = <TFunction extends AnyFunction>(\n\tcomponent: TFunction\n): component is Record<\"slotSymbol\", unknown> & TFunction => {\n\treturn \"slotSymbol\" in component && Boolean(component.slotSymbol);\n};\n\nconst isWithSlotReference = <TFunction extends AnyFunction>(\n\tcomponent: TFunction\n): component is Record<\"slotReference\", unknown> & TFunction => {\n\treturn \"slotReference\" in component && Boolean(component.slotReference);\n};\n/**\n * @description Checks if a react child (within the children array) matches the provided SlotComponent using multiple matching strategies:\n * 1. Matches by slot symbol property\n * 2. Matches by component name\n */\n\nexport const matchesSlotComponent = (child: React.ReactNode, SlotComponent: FunctionalComponent) => {\n\tif (!isValidElement(child) || !isFunction(child.type)) {\n\t\treturn false;\n\t}\n\n\tconst resolvedChildType = isWithSlotReference(child.type)\n\t\t? (child.type.slotReference as FunctionalComponent)\n\t\t: child.type;\n\n\tconst hasMatchingSlotSymbol =\n\t\tisWithSlotSymbol(resolvedChildType)\n\t\t&& isWithSlotSymbol(SlotComponent)\n\t\t&& resolvedChildType.slotSymbol === SlotComponent.slotSymbol;\n\n\tif (hasMatchingSlotSymbol) {\n\t\treturn true;\n\t}\n\n\tif (child.type.name === SlotComponent.name) {\n\t\treturn true;\n\t}\n\n\treturn false;\n};\n\n/**\n * @description Checks if a react child (within the children array) matches any of the provided SlotComponents.\n */\nexport const matchesAnySlotComponent = (child: React.ReactNode, SlotComponents: FunctionalComponent[]) => {\n\tconst matchesSlot = SlotComponents.some((SlotComponent) => matchesSlotComponent(child, SlotComponent));\n\n\treturn matchesSlot;\n};\n\ntype SlotOptions = {\n\t/**\n\t * @description If false, the function will bail out early and return null as the slot.\n\t * @default true\n\t */\n\tcondition?: boolean;\n\t/**\n\t * @description The error message to throw when multiple slots are found for a given slot component\n\t */\n\terrorMessage?: string;\n\t/**\n\t * @description When true, an AssertionError will be thrown if multiple slots are found for a given slot component\n\t */\n\tthrowOnMultipleSlotMatch?: boolean;\n};\n\n/**\n * @description Counts how many times a given slot component appears in an array of children\n * @internal\n */\nconst calculateSlotOccurrences = (\n\tchildrenArray: React.ReactNode[],\n\tSlotComponent: FunctionalComponent\n) => {\n\tlet count = 0;\n\n\tfor (const child of childrenArray) {\n\t\tif (!matchesSlotComponent(child, SlotComponent)) continue;\n\n\t\tcount += 1;\n\t}\n\n\treturn count;\n};\n\n/**\n * @description Retrieves a single slot element from a collection of React children that matches the provided SlotComponent component.\n *\n * @throws { AssertionError } when throwOnMultipleSlotMatch is true and multiple slots are found\n */\nexport const getSingleSlot = (\n\tchildren: React.ReactNode,\n\tSlotComponent: FunctionalComponent,\n\toptions: SlotOptions = {}\n) => {\n\tconst {\n\t\tcondition = true,\n\t\terrorMessage = \"Only one instance of the SlotComponent is allowed\",\n\t\tthrowOnMultipleSlotMatch = false,\n\t} = options;\n\n\tif (!condition) {\n\t\treturn null;\n\t}\n\n\tconst actualChildren =\n\t\tisValidElement<InferProps<typeof ReactFragment>>(children) && children.type === ReactFragment\n\t\t\t? children.props.children\n\t\t\t: children;\n\n\tconst childrenArray = toArray<React.ReactNode>(actualChildren);\n\n\tconst shouldThrow =\n\t\tthrowOnMultipleSlotMatch && calculateSlotOccurrences(childrenArray, SlotComponent) > 1;\n\n\tif (shouldThrow) {\n\t\tthrow new AssertionError(errorMessage);\n\t}\n\n\tconst slotElement = childrenArray.find((child) => matchesSlotComponent(child, SlotComponent));\n\n\treturn slotElement;\n};\n\n// NOTE -  You can imitate const type parameter by extending readonly[] | []\n\ntype MultipleSlotsOptions = {\n\t/**\n\t * @description If false, the function will bail out early and return the regularChildren with the actual children and an empty slots array.\n\t * @default true\n\t */\n\tcondition?: boolean;\n\t/**\n\t * @description The error message to throw when multiple slots are found for a given slot component\n\t * If a string is provided, the same message will be used for all slot components\n\t * If an array is provided, each string in the array will be used as the errorMessage for the corresponding slot component\n\t */\n\terrorMessage?: string | string[];\n\t/**\n\t * @description When true, an AssertionError will be thrown if multiple slots are found for a given slot component\n\t * If a boolean is provided, the same value will be used for all slot components\n\t * If an array is provided, each boolean in the array will be used as the throwOnMultipleSlotMatch value for the corresponding slot component\n\t */\n\tthrowOnMultipleSlotMatch?: boolean | boolean[];\n};\n\ntype GetMultipleSlotsResult<TSlotComponents extends FunctionalComponent[]> = {\n\tregularChildren: React.ReactNode[];\n\tslots: { [Key in keyof TSlotComponents]: ReturnType<TSlotComponents[Key]> };\n};\n\n/**\n * @description The same as getSingleSlot, but for multiple slot components\n */\nexport const getMultipleSlots = <const TSlotComponents extends FunctionalComponent[]>(\n\tchildren: React.ReactNode,\n\tSlotComponents: TSlotComponents,\n\toptions?: MultipleSlotsOptions\n): Prettify<GetMultipleSlotsResult<TSlotComponents>> => {\n\tconst { condition = true, errorMessage, throwOnMultipleSlotMatch } = options ?? {};\n\n\tif (!condition) {\n\t\treturn { regularChildren: children as never, slots: [] } as GetMultipleSlotsResult<TSlotComponents>;\n\t}\n\n\tconst slots = SlotComponents.map((SlotComponent, index) =>\n\t\tgetSingleSlot(children, SlotComponent, {\n\t\t\terrorMessage: isArray(errorMessage) ? errorMessage[index] : errorMessage,\n\t\t\tthrowOnMultipleSlotMatch: isArray(throwOnMultipleSlotMatch)\n\t\t\t\t? throwOnMultipleSlotMatch[index]\n\t\t\t\t: throwOnMultipleSlotMatch,\n\t\t})\n\t);\n\n\tconst regularChildren = getRegularChildren(children, SlotComponents);\n\n\treturn { regularChildren, slots } as GetMultipleSlotsResult<TSlotComponents>;\n};\n\n/**\n * @description Returns all children that are not slot elements (i.e., don't match any of the provided slot components)\n */\nexport const getRegularChildren = (\n\tchildren: React.ReactNode,\n\tSlotComponentOrComponents: FunctionalComponent | FunctionalComponent[],\n\toptions?: Pick<SlotOptions, \"condition\">\n) => {\n\tconst { condition = true } = options ?? {};\n\n\tif (!condition) {\n\t\treturn [];\n\t}\n\n\tconst actualChildren =\n\t\tisValidElement<InferProps<typeof ReactFragment>>(children) && children.type === ReactFragment\n\t\t\t? children.props.children\n\t\t\t: children;\n\n\tconst childrenArray = toArray<React.ReactNode>(actualChildren);\n\n\tconst regularChildren = childrenArray.filter(\n\t\t(child) => !matchesAnySlotComponent(child, toArray(SlotComponentOrComponents))\n\t);\n\n\treturn regularChildren;\n};\n","import { toArray } from \"@zayne-labs/toolkit-core\";\nimport {\n\ttype AnyFunction,\n\ttype Prettify,\n\ttype UnionToIntersection,\n\ttype UnknownObject,\n\tisFunction,\n} from \"@zayne-labs/toolkit-type-helpers\";\nimport { Fragment as ReactFragment, isValidElement } from \"react\";\nimport type { InferProps } from \"./types\";\n\n/**\n * Maps slot names to their corresponding children types\n */\ntype GetSlotMapResult<TSlotComponentProps extends GetSlotComponentProps> = UnionToIntersection<{\n\t[TName in keyof TSlotComponentProps as TSlotComponentProps[\"name\"]]: TSlotComponentProps[\"children\"];\n}> & { default: React.ReactNode[] };\n\n/**\n * Symbol used to identify SlotComponent instances\n */\nexport const slotComponentSymbol = Symbol(\"slot-component\");\n\ntype GetSlotMapOptions = {\n\t/**\n\t * If false, the function will bail out early and return only the default slot with the actual children.\n\t * @default true\n\t */\n\tcondition?: boolean;\n};\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\toptions?: GetSlotMapOptions\n): Prettify<GetSlotMapResult<TSlotComponentProps>> => {\n\tconst { condition = true } = options ?? {};\n\n\tif (!condition) {\n\t\treturn { default: children } as GetSlotMapResult<TSlotComponentProps>;\n\t}\n\n\tconst actualChildren =\n\t\tisValidElement<InferProps<typeof ReactFragment>>(children) && children.type === ReactFragment\n\t\t\t? children.props.children\n\t\t\t: children;\n\n\tconst childrenArray = toArray<React.ReactNode>(actualChildren);\n\n\tconst slots: Record<string, React.ReactNode> & { default: React.ReactNode[] } = {\n\t\tdefault: [],\n\t};\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\ttype ElementWithSlotReference = AnyFunction & { slotReference: SlotWithNameAndSymbol };\n\n\t\tconst resolvedChildType = Object.hasOwn(child.type, \"slotReference\")\n\t\t\t? (child.type as ElementWithSlotReference).slotReference\n\t\t\t: (child.type as SlotWithNameAndSymbol);\n\n\t\tconst isSlotElement =\n\t\t\tresolvedChildType.slotSymbol === slotComponentSymbol\n\t\t\t&& Boolean(resolvedChildType.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 = resolvedChildType.slotName ?? child.props.name;\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 */\nexport type GetSlotComponentProps<\n\tTName extends string = string,\n\tTChildren extends React.ReactNode = React.ReactNode,\n> = {\n\t/** Content to render in the slot */\n\tchildren: TChildren;\n\t/** Name of the slot where content should be rendered */\n\tname: TName;\n};\n\n/**\n * @description Slot component created by createSlotComponent\n */\n\nexport const createSlotComponent = <TSlotComponentProps extends GetSlotComponentProps>() => {\n\tconst SlotComponent = (props: TSlotComponentProps) => props.children;\n\n\tSlotComponent.slotSymbol = slotComponentSymbol;\n\n\treturn SlotComponent;\n};\n\ntype SlotWithNameAndSymbol<\n\tTSlotComponentProps extends Pick<GetSlotComponentProps, \"name\"> = Pick<GetSlotComponentProps, \"name\">,\n\tTActualProps extends UnknownObject = UnknownObject,\n> = {\n\t(props: Pick<GetSlotComponentProps, \"children\"> & TActualProps): React.ReactNode;\n\treadonly slotName?: TSlotComponentProps[\"name\"];\n\treadonly slotSymbol?: symbol;\n};\n\nexport const withSlotNameAndSymbol = <\n\tTSlotComponentProps extends Pick<GetSlotComponentProps, \"name\">,\n\tTActualProps extends UnknownObject = UnknownObject,\n>(\n\tname: TSlotComponentProps[\"name\"],\n\tSlotComponent: SlotWithNameAndSymbol<TSlotComponentProps, TActualProps> = (props) => props.children\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\t/* eslint-enable no-param-reassign -- This is necessary */\n\n\treturn SlotComponent;\n};\n","import { mergeClassNames, mergeFunctions } from \"@zayne-labs/toolkit-core\";\nimport { isFunction, isPlainObject } from \"@zayne-labs/toolkit-type-helpers\";\n\n// const CSS_REGEX = /((?:--)?(?:\\w+-?)+)\\s*:\\s*([^;]*)/g;\n\n// const serialize = (style: string): Record<string, string> => {\n// \tconst res: Record<string, string> = {};\n// \tlet match: RegExpExecArray | null;\n// \twhile ((match = CSS_REGEX.exec(style))) {\n// \t\tres[match[1]!] = match[2]!;\n// \t}\n// \treturn res;\n// };\n\n// const css = (\n// \ta: Record<string, string> | string | undefined,\n// \tb: Record<string, string> | string | undefined\n// ): Record<string, string> | string => {\n// \tif (isString(a)) {\n// \t\tif (isString(b)) return `${a};${b}`;\n// \t\ta = serialize(a);\n// \t} else if (isString(b)) {\n// \t\tb = serialize(b);\n// \t}\n// \treturn Object.assign({}, a ?? {}, b ?? {});\n// };\n\ntype UnionToIntersection<TUnion> = (TUnion extends unknown ? (param: TUnion) => void : \"\") extends (\n\tparam: infer TParam\n) => void\n\t? TParam\n\t: \"\";\n\n/* eslint-disable no-param-reassign -- Mutation is fine here since it's an internally managed object */\nconst handleMergePropsIntoResult = (\n\tmergedResult: Record<string, unknown>,\n\tpropsObject: Record<string, unknown>\n) => {\n\tfor (const propName of Object.keys(mergedResult)) {\n\t\tconst mergedResultValue = mergedResult[propName];\n\t\tconst propsObjectValue = propsObject[propName];\n\n\t\tif (propName === \"className\" || propName === \"class\") {\n\t\t\tmergedResult[propName] = mergeClassNames(mergedResultValue as string, propsObjectValue as string);\n\t\t\tcontinue;\n\t\t}\n\n\t\tif (propName === \"style\" && isPlainObject(mergedResultValue) && isPlainObject(propsObjectValue)) {\n\t\t\t// mergedResult[propName] = css(mergedResultValue, propsObjectValue);\n\t\t\tmergedResult[propName] = { ...mergedResultValue, ...propsObjectValue };\n\t\t\tcontinue;\n\t\t}\n\n\t\tconst isHandler = propName.startsWith(\"on\");\n\n\t\tif (isHandler && isFunction(mergedResultValue) && isFunction(propsObjectValue)) {\n\t\t\tmergedResult[propName] = mergeFunctions(propsObjectValue, mergedResultValue);\n\t\t\tcontinue;\n\t\t}\n\n\t\tmergedResult[propName] = propsObjectValue !== undefined ? propsObjectValue : mergedResultValue;\n\t}\n};\n\nconst addMissingPropsToResult = (\n\tmergedResult: Record<string, unknown>,\n\tpropsObject: Record<string, unknown>\n) => {\n\tfor (const propName of Object.keys(propsObject)) {\n\t\tif (mergedResult[propName] === undefined) {\n\t\t\tmergedResult[propName] = propsObject[propName];\n\t\t}\n\t}\n};\n/* eslint-enable no-param-reassign -- Mutation is fine here since it's an internally managed object */\n\ntype UnknownProps = Record<never, never>;\n\nconst mergeProps = <TProps extends UnknownProps>(\n\t...parameters: Array<TProps | undefined>\n): UnionToIntersection<TProps> => {\n\tconst mergedResult: Record<string, unknown> = {};\n\n\tfor (const propsObject of parameters) {\n\t\tif (!propsObject) continue;\n\n\t\thandleMergePropsIntoResult(mergedResult, propsObject);\n\n\t\t// == Add props from propsObject that are not in the mergedResult\n\t\taddMissingPropsToResult(mergedResult, propsObject);\n\t}\n\n\treturn mergedResult as never;\n};\n\nexport { mergeProps };\n","import { mergeClassNames, mergeFunctions } from \"@zayne-labs/toolkit-core\";\nimport { isFunction, isPlainObject } from \"@zayne-labs/toolkit-type-helpers\";\n\ntype UnknownProps = Record<never, never>;\n\nconst mergeTwoProps = <TProps extends UnknownProps>(\n\tslotProps: TProps | undefined,\n\tchildProps: TProps | undefined\n): TProps => {\n\tif (!slotProps || !childProps) {\n\t\treturn childProps ?? slotProps ?? ({} as TProps);\n\t}\n\n\t// == all child props should override slotProps\n\tconst overrideProps = { ...childProps } as Record<string, unknown>;\n\n\tfor (const propName of Object.keys(slotProps)) {\n\t\tconst slotPropValue = (slotProps as Record<string, unknown>)[propName];\n\t\tconst childPropValue = (childProps as Record<string, unknown>)[propName];\n\n\t\t// == if it's `style`, we merge them\n\t\tif (propName === \"style\" && isPlainObject(slotPropValue) && isPlainObject(childPropValue)) {\n\t\t\toverrideProps[propName] = { ...slotPropValue, ...childPropValue };\n\t\t\tcontinue;\n\t\t}\n\n\t\t// == if it's `className` or `class`, we merge them\n\t\tif (propName === \"className\" || propName === \"class\") {\n\t\t\toverrideProps[propName] = mergeClassNames(slotPropValue as string, childPropValue as string);\n\t\t\tcontinue;\n\t\t}\n\n\t\tconst isHandler = propName.startsWith(\"on\");\n\n\t\t// == if the handler exists on both, we compose them\n\t\tif (isHandler && isFunction(slotPropValue) && isFunction(childPropValue)) {\n\t\t\toverrideProps[propName] = mergeFunctions(childPropValue, slotPropValue);\n\t\t}\n\t}\n\n\treturn { ...slotProps, ...overrideProps };\n};\n\nexport { mergeTwoProps };\n"]}
+{"version":3,"sources":["../../../src/utils/composeRefs.ts","../../../src/utils/composeEventHandlers.ts","../../../src/utils/getSlot.ts","../../../src/utils/getSlotMap.ts","../../../src/utils/mergeTwoProps.ts","../../../src/utils/mergeProps.ts"],"names":["result","isFunction","ReactFragment","isValidElement","toArray"],"mappings":";;;;;AAUa,IAAA,MAAA,GAAS,CAAO,GAAA,EAAwB,IAA8C,KAAA;AAClG,EAAA,IAAI,CAAC,GAAK,EAAA;AAEV,EAAI,IAAA,UAAA,CAAW,GAAG,CAAG,EAAA;AACpB,IAAA,OAAO,IAAI,IAAI,CAAA;AAAA;AAIhB,EAAA,GAAA,CAAI,OAAU,GAAA,IAAA;AACf;AAKa,IAAA,WAAA,GAAc,IACvB,IACoB,KAAA;AACvB,EAAM,MAAA,iBAAA,GAAuC,CAAC,IAAS,KAAA;AACtD,IAAM,MAAA,cAAA,GAAiB,KAAK,GAAI,CAAA,CAAC,QAAQ,MAAO,CAAA,GAAA,EAAK,IAAI,CAAC,CAAA;AAE1D,IAAA,MAAM,YAAY,MAAM,cAAA,CAAe,QAAQ,CAAC,OAAA,KAAY,WAAW,CAAA;AAEvE,IAAO,OAAA,SAAA;AAAA,GACR;AAEA,EAAO,OAAA,iBAAA;AACR;AAEa,IAAA,cAAA,GAAiB,IAA8B,IAAmC,KAAA;AAE9F,EAAA,MAAM,YAAY,WAAY,CAAA,MAAM,YAAY,GAAG,IAAI,GAAG,IAAI,CAAA;AAE9D,EAAO,OAAA,SAAA;AACR;ACzCA,IAAM,gBAAA,GAAmB,CAAC,KAAkD,KAAA;AAC3E,EAAA,OAAO,SAAS,KAAK,CAAA,IAAK,MAAO,CAAA,MAAA,CAAO,OAAO,aAAa,CAAA;AAC7D,CAAA;AAEa,IAAA,uBAAA,GAA0B,CACtC,aAAA,EACA,aACI,KAAA;AACJ,EAAM,MAAA,kBAAA,GAAqB,CAAC,KAAmB,KAAA;AAC9C,IAAI,IAAA,gBAAA,CAAiB,KAAK,CAAG,EAAA;AAC5B,MAAMA,MAAAA,OAAAA,GAAS,gBAAgB,KAAK,CAAA;AAEpC,MAAI,IAAA,CAAC,MAAM,gBAAkB,EAAA;AAC5B,QAAA,aAAA,GAAgB,KAAK,CAAA;AAAA;AAGtB,MAAOA,OAAAA,OAAAA;AAAA;AAGR,IAAM,MAAA,MAAA,GAAS,gBAAgB,KAAK,CAAA;AACpC,IAAA,aAAA,GAAgB,KAAK,CAAA;AACrB,IAAO,OAAA,MAAA;AAAA,GACR;AAEA,EAAO,OAAA,kBAAA;AACR;AAEa,IAAA,oBAAA,GAAuB,IAAI,iBAAsD,KAAA;AAC7F,EAAM,MAAA,kBAAA,GAAqB,CAAC,KAAmB,KAAA;AAC9C,IAAI,IAAA,iBAAA,CAAkB,WAAW,CAAG,EAAA;AAEpC,IAAI,IAAA,iBAAA,CAAkB,WAAW,CAAG,EAAA;AACnC,MAAO,OAAA,iBAAA,CAAkB,CAAC,CAAA,GAAI,KAAK,CAAA;AAAA;AAGpC,IAAI,IAAA,mBAAA;AAEJ,IAAA,KAAA,MAAW,gBAAgB,iBAAmB,EAAA;AAC7C,MAAA,IAAI,CAAC,YAAc,EAAA;AAEnB,MAAsB,mBAAA,GAAA,uBAAA,CAAwB,qBAAqB,YAAY,CAAA;AAAA;AAGhF,IAAA,OAAO,sBAAsB,KAAK,CAAA;AAAA,GACnC;AAEA,EAAO,OAAA,kBAAA;AACR;ACnCA,IAAM,gBAAA,GAAmB,CACxB,SAC4D,KAAA;AAC5D,EAAA,OAAO,YAAgB,IAAA,SAAA,IAAa,OAAQ,CAAA,SAAA,CAAU,UAAU,CAAA;AACjE,CAAA;AAEA,IAAM,mBAAA,GAAsB,CAC3B,SAC+D,KAAA;AAC/D,EAAA,OAAO,eAAmB,IAAA,SAAA,IAAa,OAAQ,CAAA,SAAA,CAAU,aAAa,CAAA;AACvE,CAAA;AAOa,IAAA,oBAAA,GAAuB,CAAC,KAAA,EAAwB,aAAuC,KAAA;AACnG,EAAI,IAAA,CAAC,eAAe,KAAK,CAAA,IAAK,CAACC,UAAW,CAAA,KAAA,CAAM,IAAI,CAAG,EAAA;AACtD,IAAO,OAAA,KAAA;AAAA;AAGR,EAAM,MAAA,iBAAA,GAAoB,oBAAoB,KAAM,CAAA,IAAI,IACpD,KAAM,CAAA,IAAA,CAAK,gBACZ,KAAM,CAAA,IAAA;AAET,EAAM,MAAA,qBAAA,GACL,iBAAiB,iBAAiB,CAAA,IAC/B,iBAAiB,aAAa,CAAA,IAC9B,iBAAkB,CAAA,UAAA,KAAe,aAAc,CAAA,UAAA;AAEnD,EAAA,IAAI,qBAAuB,EAAA;AAC1B,IAAO,OAAA,IAAA;AAAA;AAGR,EAAA,IAAI,KAAM,CAAA,IAAA,CAAK,IAAS,KAAA,aAAA,CAAc,IAAM,EAAA;AAC3C,IAAO,OAAA,IAAA;AAAA;AAGR,EAAO,OAAA,KAAA;AACR;AAKa,IAAA,uBAAA,GAA0B,CAAC,KAAA,EAAwB,cAA0C,KAAA;AACzG,EAAM,MAAA,WAAA,GAAc,eAAe,IAAK,CAAA,CAAC,kBAAkB,oBAAqB,CAAA,KAAA,EAAO,aAAa,CAAC,CAAA;AAErG,EAAO,OAAA,WAAA;AACR;AAsBA,IAAM,wBAAA,GAA2B,CAChC,aAAA,EACA,aACI,KAAA;AACJ,EAAA,IAAI,KAAQ,GAAA,CAAA;AAEZ,EAAA,KAAA,MAAW,SAAS,aAAe,EAAA;AAClC,IAAA,IAAI,CAAC,oBAAA,CAAqB,KAAO,EAAA,aAAa,CAAG,EAAA;AAEjD,IAAS,KAAA,IAAA,CAAA;AAAA;AAGV,EAAO,OAAA,KAAA;AACR,CAAA;AAOO,IAAM,gBAAgB,CAC5B,QAAA,EACA,aACA,EAAA,OAAA,GAAuB,EACnB,KAAA;AACJ,EAAM,MAAA;AAAA,IACL,SAAY,GAAA,IAAA;AAAA,IACZ,YAAe,GAAA,mDAAA;AAAA,IACf,wBAA2B,GAAA;AAAA,GACxB,GAAA,OAAA;AAEJ,EAAA,IAAI,CAAC,SAAW,EAAA;AACf,IAAO,OAAA,IAAA;AAAA;AAGR,EAAM,MAAA,cAAA,GACL,eAAiD,QAAQ,CAAA,IAAK,SAAS,IAAS,KAAAC,QAAA,GAC7E,QAAS,CAAA,KAAA,CAAM,QACf,GAAA,QAAA;AAEJ,EAAM,MAAA,aAAA,GAAgB,QAAyB,cAAc,CAAA;AAE7D,EAAA,MAAM,WACL,GAAA,wBAAA,IAA4B,wBAAyB,CAAA,aAAA,EAAe,aAAa,CAAI,GAAA,CAAA;AAEtF,EAAA,IAAI,WAAa,EAAA;AAChB,IAAM,MAAA,IAAI,eAAe,YAAY,CAAA;AAAA;AAGtC,EAAM,MAAA,WAAA,GAAc,cAAc,IAAK,CAAA,CAAC,UAAU,oBAAqB,CAAA,KAAA,EAAO,aAAa,CAAC,CAAA;AAE5F,EAAO,OAAA,WAAA;AACR;AAgCO,IAAM,gBAAmB,GAAA,CAC/B,QACA,EAAA,cAAA,EACA,OACuD,KAAA;AACvD,EAAA,MAAM,EAAE,SAAY,GAAA,IAAA,EAAM,cAAc,wBAAyB,EAAA,GAAI,WAAW,EAAC;AAEjF,EAAA,IAAI,CAAC,SAAW,EAAA;AACf,IAAA,OAAO,EAAE,eAAA,EAAiB,QAAmB,EAAA,KAAA,EAAO,EAAG,EAAA;AAAA;AAGxD,EAAA,MAAM,QAAQ,cAAe,CAAA,GAAA;AAAA,IAAI,CAAC,aAAA,EAAe,KAChD,KAAA,aAAA,CAAc,UAAU,aAAe,EAAA;AAAA,MACtC,cAAc,OAAQ,CAAA,YAAY,CAAI,GAAA,YAAA,CAAa,KAAK,CAAI,GAAA,YAAA;AAAA,MAC5D,0BAA0B,OAAQ,CAAA,wBAAwB,CACvD,GAAA,wBAAA,CAAyB,KAAK,CAC9B,GAAA;AAAA,KACH;AAAA,GACF;AAEA,EAAM,MAAA,eAAA,GAAkB,kBAAmB,CAAA,QAAA,EAAU,cAAc,CAAA;AAEnE,EAAO,OAAA,EAAE,iBAAiB,KAAM,EAAA;AACjC;AAKO,IAAM,kBAAqB,GAAA,CACjC,QACA,EAAA,yBAAA,EACA,OACI,KAAA;AACJ,EAAA,MAAM,EAAE,SAAA,GAAY,IAAK,EAAA,GAAI,WAAW,EAAC;AAEzC,EAAA,IAAI,CAAC,SAAW,EAAA;AACf,IAAA,OAAO,EAAC;AAAA;AAGT,EAAM,MAAA,cAAA,GACL,eAAiD,QAAQ,CAAA,IAAK,SAAS,IAAS,KAAAA,QAAA,GAC7E,QAAS,CAAA,KAAA,CAAM,QACf,GAAA,QAAA;AAEJ,EAAM,MAAA,aAAA,GAAgB,QAAyB,cAAc,CAAA;AAE7D,EAAA,MAAM,kBAAkB,aAAc,CAAA,MAAA;AAAA,IACrC,CAAC,KAAU,KAAA,CAAC,wBAAwB,KAAO,EAAA,OAAA,CAAQ,yBAAyB,CAAC;AAAA,GAC9E;AAEA,EAAO,OAAA,eAAA;AACR;ACvMa,IAAA,mBAAA,GAAsB,OAAO,gBAAgB;AA0C7C,IAAA,UAAA,GAAa,CACzB,QAAA,EACA,OACqD,KAAA;AACrD,EAAA,MAAM,EAAE,SAAA,GAAY,IAAK,EAAA,GAAI,WAAW,EAAC;AAEzC,EAAA,IAAI,CAAC,SAAW,EAAA;AACf,IAAO,OAAA,EAAE,SAAS,QAAS,EAAA;AAAA;AAG5B,EAAM,MAAA,cAAA,GACLC,eAAiD,QAAQ,CAAA,IAAK,SAAS,IAASD,KAAAA,QAAAA,GAC7E,QAAS,CAAA,KAAA,CAAM,QACf,GAAA,QAAA;AAEJ,EAAM,MAAA,aAAA,GAAgBE,QAAyB,cAAc,CAAA;AAE7D,EAAA,MAAM,KAA0E,GAAA;AAAA,IAC/E,SAAS;AAAC,GACX;AAEA,EAAA,KAAA,MAAW,SAAS,aAAe,EAAA;AAClC,IAAI,IAAA,CAACD,eAAoC,KAAK,CAAA,IAAK,CAACF,UAAW,CAAA,KAAA,CAAM,IAAI,CAAG,EAAA;AAC3E,MAAM,KAAA,CAAA,OAAA,CAAQ,KAAK,KAAK,CAAA;AACxB,MAAA;AAAA;AAKD,IAAM,MAAA,iBAAA,GAAoB,MAAO,CAAA,MAAA,CAAO,KAAM,CAAA,IAAA,EAAM,eAAe,CAC/D,GAAA,KAAA,CAAM,IAAkC,CAAA,aAAA,GACxC,KAAM,CAAA,IAAA;AAEV,IAAM,MAAA,aAAA,GACL,kBAAkB,UAAe,KAAA,mBAAA,IAC9B,QAAQ,iBAAkB,CAAA,QAAA,IAAY,KAAM,CAAA,KAAA,CAAM,IAAI,CAAA;AAE1D,IAAA,IAAI,CAAC,aAAe,EAAA;AACnB,MAAM,KAAA,CAAA,OAAA,CAAQ,KAAK,KAAK,CAAA;AACxB,MAAA;AAAA;AAGD,IAAA,MAAM,QAAW,GAAA,iBAAA,CAAkB,QAAY,IAAA,KAAA,CAAM,KAAM,CAAA,IAAA;AAE3D,IAAA,KAAA,CAAM,QAAQ,CAAI,GAAA,KAAA;AAAA;AAGnB,EAAO,OAAA,KAAA;AACR;AAmBO,IAAM,sBAAsB,MAAyD;AAC3F,EAAM,MAAA,aAAA,GAAgB,CAAC,KAAA,KAA+B,KAAM,CAAA,QAAA;AAE5D,EAAA,aAAA,CAAc,UAAa,GAAA,mBAAA;AAE3B,EAAO,OAAA,aAAA;AACR;AAWO,IAAM,wBAAwB,CAIpC,IAAA,EACA,gBAA0E,CAAC,KAAA,KAAU,MAAM,QACvF,KAAA;AAGJ,EAAA,aAAA,CAAc,UAAa,GAAA,mBAAA;AAE3B,EAAA,aAAA,CAAc,QAAW,GAAA,IAAA;AAGzB,EAAO,OAAA,aAAA;AACR;AC9JA,IAAM,cAAA,GAAiB,CAAC,GAAA,EAAa,KAAyC,KAAA;AAC7E,EAAM,MAAA,aAAA,GAAgB,GAAI,CAAA,WAAA,CAAY,CAAC,CAAA;AAEvC,EAAA,IAAI,CAACA,UAAAA,CAAW,KAAK,CAAA,IAAK,kBAAkB,MAAW,EAAA;AACtD,IAAO,OAAA,KAAA;AAAA;AAGR,EAAA,MAAM,YAAY,GAAI,CAAA,UAAA,CAAW,IAAI,CAAK,IAAA,aAAA,IAAiB,MAAc,aAAiB,IAAA,EAAA;AAE1F,EAAO,OAAA,SAAA;AACR,CAAA;AAEA,IAAM,kBAAA,GAAqB,CAAC,eAAA,EAAqC,eAAwC,KAAA;AACxG,EAAI,IAAA,CAAC,eAAmB,IAAA,CAAC,eAAiB,EAAA;AAEzC,IAAA,OAAO,eAAmB,IAAA,eAAA;AAAA;AAI3B,EAAA,OAAO,kBAAkB,GAAM,GAAA,eAAA;AAChC,CAAA;AAEa,IAAA,aAAA,GAAgB,CAC5B,WAAA,EACA,WACY,KAAA;AAEZ,EAAI,IAAA,CAAC,WAAe,IAAA,CAAC,WAAa,EAAA;AACjC,IAAO,OAAA,WAAA,IAAe,eAAgB,EAAC;AAAA;AAGxC,EAAM,MAAA,gBAAA,GAAmB,EAAE,GAAG,WAAY,EAAA;AAE1C,EAAA,KAAA,MAAW,cAAkB,IAAA,MAAA,CAAO,IAAK,CAAA,WAAW,CAAG,EAAA;AACtD,IAAM,MAAA,eAAA,GAAmB,YAAwC,cAAc,CAAA;AAC/E,IAAM,MAAA,eAAA,GAAmB,YAAwC,cAAc,CAAA;AAG/E,IAAI,IAAA,cAAA,KAAmB,WAAe,IAAA,cAAA,KAAmB,OAAS,EAAA;AACjE,MAAA,gBAAA,CAAiB,cAAc,CAAI,GAAA,kBAAA;AAAA,QAClC,eAAA;AAAA,QACA;AAAA,OACD;AACA,MAAA;AAAA;AAID,IAAA,IAAI,mBAAmB,OAAS,EAAA;AAC/B,MAAA,gBAAA,CAAiB,cAAc,CAAI,GAAA;AAAA,QAClC,GAAI,eAAA;AAAA,QACJ,GAAI;AAAA,OACL;AACA,MAAA;AAAA;AAID,IAAI,IAAA,cAAA,CAAe,cAAgB,EAAA,eAAe,CAAG,EAAA;AACpD,MAAA,gBAAA,CAAiB,cAAc,CAAI,GAAA,uBAAA;AAAA,QAClC,eAAA;AAAA,QACA;AAAA,OACD;AAEA,MAAA;AAAA;AAID,IAAA,gBAAA,CAAiB,cAAc,CAAI,GAAA,eAAA;AAAA;AAGpC,EAAO,OAAA,gBAAA;AACR;;;ACnDM,IAAA,UAAA,GAAa,IACf,gBAC8B,KAAA;AACjC,EAAI,IAAA,gBAAA,CAAiB,WAAW,CAAG,EAAA;AAClC,IAAA,OAAO,EAAC;AAAA;AAGT,EAAI,IAAA,gBAAA,CAAiB,WAAW,CAAG,EAAA;AAClC,IAAA,OAAO,iBAAiB,CAAC,CAAA;AAAA;AAG1B,EAAA,IAAI,mBAA4C,EAAC;AAEjD,EAAA,KAAA,MAAW,eAAe,gBAAkB,EAAA;AAC3C,IAAA,IAAI,CAAC,WAAa,EAAA;AAElB,IAAmB,gBAAA,GAAA,aAAA,CAAc,kBAAkB,WAAW,CAAA;AAAA;AAG/D,EAAO,OAAA,gBAAA;AACR","file":"index.js","sourcesContent":["import { isFunction } from \"@zayne-labs/toolkit-type-helpers\";\nimport { type RefCallback, useCallback } from \"react\";\n\ntype PossibleRef<TRef> = React.Ref<TRef> | undefined;\n\n/**\n * @description Set a given ref to a given value.\n *\n * This utility takes care of different types of refs: callback refs and RefObject(s)\n */\nexport const setRef = <TRef>(ref: PossibleRef<TRef>, node: TRef): ReturnType<RefCallback<TRef>> => {\n\tif (!ref) return;\n\n\tif (isFunction(ref)) {\n\t\treturn ref(node);\n\t}\n\n\t// eslint-disable-next-line no-param-reassign -- Mutation is needed here\n\tref.current = node;\n};\n\n/**\n * @description A utility to combine refs. Accepts callback refs and RefObject(s)\n */\nexport const composeRefs = <TRef extends HTMLElement>(\n\t...refs: Array<PossibleRef<TRef>>\n): RefCallback<TRef> => {\n\tconst mergedRefCallBack: RefCallback<TRef> = (node) => {\n\t\tconst cleanupFnArray = refs.map((ref) => setRef(ref, node));\n\n\t\tconst cleanupFn = () => cleanupFnArray.forEach((cleanup) => cleanup?.());\n\n\t\treturn cleanupFn;\n\t};\n\n\treturn mergedRefCallBack;\n};\n\nexport const useComposeRefs = <TRef extends HTMLElement>(...refs: Array<PossibleRef<TRef>>) => {\n\t// eslint-disable-next-line react-hooks/exhaustive-deps -- Allow\n\tconst mergedRef = useCallback(() => composeRefs(...refs), refs);\n\n\treturn mergedRef;\n};\n","import { type AnyFunction, isObject } from \"@zayne-labs/toolkit-type-helpers\";\n\nconst isSyntheticEvent = (event: unknown): event is React.SyntheticEvent => {\n\treturn isObject(event) && Object.hasOwn(event, \"nativeEvent\");\n};\n\nexport const composeTwoEventHandlers = (\n\tformerHandler: AnyFunction | undefined,\n\tlatterHandler: AnyFunction | undefined\n) => {\n\tconst mergedEventHandler = (event: unknown) => {\n\t\tif (isSyntheticEvent(event)) {\n\t\t\tconst result = latterHandler?.(event) as unknown;\n\n\t\t\tif (!event.defaultPrevented) {\n\t\t\t\tformerHandler?.(event);\n\t\t\t}\n\n\t\t\treturn result;\n\t\t}\n\n\t\tconst result = latterHandler?.(event) as unknown;\n\t\tformerHandler?.(event);\n\t\treturn result;\n\t};\n\n\treturn mergedEventHandler;\n};\n\nexport const composeEventHandlers = (...eventHandlerArray: Array<AnyFunction | undefined>) => {\n\tconst mergedEventHandler = (event: unknown) => {\n\t\tif (eventHandlerArray.length === 0) return;\n\n\t\tif (eventHandlerArray.length === 1) {\n\t\t\treturn eventHandlerArray[0]?.(event) as unknown;\n\t\t}\n\n\t\tlet accumulatedHandlers: AnyFunction | undefined;\n\n\t\tfor (const eventHandler of eventHandlerArray) {\n\t\t\tif (!eventHandler) continue;\n\n\t\t\taccumulatedHandlers = composeTwoEventHandlers(accumulatedHandlers, eventHandler);\n\t\t}\n\n\t\treturn accumulatedHandlers?.(event) as unknown;\n\t};\n\n\treturn mergedEventHandler;\n};\n","import { toArray } from \"@zayne-labs/toolkit-core\";\nimport {\n\ttype AnyFunction,\n\tAssertionError,\n\ttype Prettify,\n\ttype UnknownObject,\n\tisArray,\n\tisFunction,\n} from \"@zayne-labs/toolkit-type-helpers\";\nimport { Fragment as ReactFragment, isValidElement } from \"react\";\nimport type { InferProps } from \"./types\";\n\nexport type FunctionalComponent<TProps extends UnknownObject = never> = React.FunctionComponent<TProps>;\n\nconst isWithSlotSymbol = <TFunction extends AnyFunction>(\n\tcomponent: TFunction\n): component is Record<\"slotSymbol\", unknown> & TFunction => {\n\treturn \"slotSymbol\" in component && Boolean(component.slotSymbol);\n};\n\nconst isWithSlotReference = <TFunction extends AnyFunction>(\n\tcomponent: TFunction\n): component is Record<\"slotReference\", unknown> & TFunction => {\n\treturn \"slotReference\" in component && Boolean(component.slotReference);\n};\n/**\n * @description Checks if a react child (within the children array) matches the provided SlotComponent using multiple matching strategies:\n * 1. Matches by slot symbol property\n * 2. Matches by component name\n */\n\nexport const matchesSlotComponent = (child: React.ReactNode, SlotComponent: FunctionalComponent) => {\n\tif (!isValidElement(child) || !isFunction(child.type)) {\n\t\treturn false;\n\t}\n\n\tconst resolvedChildType = isWithSlotReference(child.type)\n\t\t? (child.type.slotReference as FunctionalComponent)\n\t\t: child.type;\n\n\tconst hasMatchingSlotSymbol =\n\t\tisWithSlotSymbol(resolvedChildType)\n\t\t&& isWithSlotSymbol(SlotComponent)\n\t\t&& resolvedChildType.slotSymbol === SlotComponent.slotSymbol;\n\n\tif (hasMatchingSlotSymbol) {\n\t\treturn true;\n\t}\n\n\tif (child.type.name === SlotComponent.name) {\n\t\treturn true;\n\t}\n\n\treturn false;\n};\n\n/**\n * @description Checks if a react child (within the children array) matches any of the provided SlotComponents.\n */\nexport const matchesAnySlotComponent = (child: React.ReactNode, SlotComponents: FunctionalComponent[]) => {\n\tconst matchesSlot = SlotComponents.some((SlotComponent) => matchesSlotComponent(child, SlotComponent));\n\n\treturn matchesSlot;\n};\n\ntype SlotOptions = {\n\t/**\n\t * @description If false, the function will bail out early and return null as the slot.\n\t * @default true\n\t */\n\tcondition?: boolean;\n\t/**\n\t * @description The error message to throw when multiple slots are found for a given slot component\n\t */\n\terrorMessage?: string;\n\t/**\n\t * @description When true, an AssertionError will be thrown if multiple slots are found for a given slot component\n\t */\n\tthrowOnMultipleSlotMatch?: boolean;\n};\n\n/**\n * @description Counts how many times a given slot component appears in an array of children\n * @internal\n */\nconst calculateSlotOccurrences = (\n\tchildrenArray: React.ReactNode[],\n\tSlotComponent: FunctionalComponent\n) => {\n\tlet count = 0;\n\n\tfor (const child of childrenArray) {\n\t\tif (!matchesSlotComponent(child, SlotComponent)) continue;\n\n\t\tcount += 1;\n\t}\n\n\treturn count;\n};\n\n/**\n * @description Retrieves a single slot element from a collection of React children that matches the provided SlotComponent component.\n *\n * @throws { AssertionError } when throwOnMultipleSlotMatch is true and multiple slots are found\n */\nexport const getSingleSlot = (\n\tchildren: React.ReactNode,\n\tSlotComponent: FunctionalComponent,\n\toptions: SlotOptions = {}\n) => {\n\tconst {\n\t\tcondition = true,\n\t\terrorMessage = \"Only one instance of the SlotComponent is allowed\",\n\t\tthrowOnMultipleSlotMatch = false,\n\t} = options;\n\n\tif (!condition) {\n\t\treturn null;\n\t}\n\n\tconst actualChildren =\n\t\tisValidElement<InferProps<typeof ReactFragment>>(children) && children.type === ReactFragment\n\t\t\t? children.props.children\n\t\t\t: children;\n\n\tconst childrenArray = toArray<React.ReactNode>(actualChildren);\n\n\tconst shouldThrow =\n\t\tthrowOnMultipleSlotMatch && calculateSlotOccurrences(childrenArray, SlotComponent) > 1;\n\n\tif (shouldThrow) {\n\t\tthrow new AssertionError(errorMessage);\n\t}\n\n\tconst slotElement = childrenArray.find((child) => matchesSlotComponent(child, SlotComponent));\n\n\treturn slotElement;\n};\n\n// NOTE -  You can imitate const type parameter by extending readonly[] | []\n\ntype MultipleSlotsOptions = {\n\t/**\n\t * @description If false, the function will bail out early and return the regularChildren with the actual children and an empty slots array.\n\t * @default true\n\t */\n\tcondition?: boolean;\n\t/**\n\t * @description The error message to throw when multiple slots are found for a given slot component\n\t * If a string is provided, the same message will be used for all slot components\n\t * If an array is provided, each string in the array will be used as the errorMessage for the corresponding slot component\n\t */\n\terrorMessage?: string | string[];\n\t/**\n\t * @description When true, an AssertionError will be thrown if multiple slots are found for a given slot component\n\t * If a boolean is provided, the same value will be used for all slot components\n\t * If an array is provided, each boolean in the array will be used as the throwOnMultipleSlotMatch value for the corresponding slot component\n\t */\n\tthrowOnMultipleSlotMatch?: boolean | boolean[];\n};\n\ntype GetMultipleSlotsResult<TSlotComponents extends FunctionalComponent[]> = {\n\tregularChildren: React.ReactNode[];\n\tslots: { [Key in keyof TSlotComponents]: ReturnType<TSlotComponents[Key]> };\n};\n\n/**\n * @description The same as getSingleSlot, but for multiple slot components\n */\nexport const getMultipleSlots = <const TSlotComponents extends FunctionalComponent[]>(\n\tchildren: React.ReactNode,\n\tSlotComponents: TSlotComponents,\n\toptions?: MultipleSlotsOptions\n): Prettify<GetMultipleSlotsResult<TSlotComponents>> => {\n\tconst { condition = true, errorMessage, throwOnMultipleSlotMatch } = options ?? {};\n\n\tif (!condition) {\n\t\treturn { regularChildren: children as never, slots: [] } as GetMultipleSlotsResult<TSlotComponents>;\n\t}\n\n\tconst slots = SlotComponents.map((SlotComponent, index) =>\n\t\tgetSingleSlot(children, SlotComponent, {\n\t\t\terrorMessage: isArray(errorMessage) ? errorMessage[index] : errorMessage,\n\t\t\tthrowOnMultipleSlotMatch: isArray(throwOnMultipleSlotMatch)\n\t\t\t\t? throwOnMultipleSlotMatch[index]\n\t\t\t\t: throwOnMultipleSlotMatch,\n\t\t})\n\t);\n\n\tconst regularChildren = getRegularChildren(children, SlotComponents);\n\n\treturn { regularChildren, slots } as GetMultipleSlotsResult<TSlotComponents>;\n};\n\n/**\n * @description Returns all children that are not slot elements (i.e., don't match any of the provided slot components)\n */\nexport const getRegularChildren = (\n\tchildren: React.ReactNode,\n\tSlotComponentOrComponents: FunctionalComponent | FunctionalComponent[],\n\toptions?: Pick<SlotOptions, \"condition\">\n) => {\n\tconst { condition = true } = options ?? {};\n\n\tif (!condition) {\n\t\treturn [];\n\t}\n\n\tconst actualChildren =\n\t\tisValidElement<InferProps<typeof ReactFragment>>(children) && children.type === ReactFragment\n\t\t\t? children.props.children\n\t\t\t: children;\n\n\tconst childrenArray = toArray<React.ReactNode>(actualChildren);\n\n\tconst regularChildren = childrenArray.filter(\n\t\t(child) => !matchesAnySlotComponent(child, toArray(SlotComponentOrComponents))\n\t);\n\n\treturn regularChildren;\n};\n","import { toArray } from \"@zayne-labs/toolkit-core\";\nimport {\n\ttype AnyFunction,\n\ttype Prettify,\n\ttype UnionToIntersection,\n\ttype UnknownObject,\n\tisFunction,\n} from \"@zayne-labs/toolkit-type-helpers\";\nimport { Fragment as ReactFragment, isValidElement } from \"react\";\nimport type { InferProps } from \"./types\";\n\n/**\n * Maps slot names to their corresponding children types\n */\ntype GetSlotMapResult<TSlotComponentProps extends GetSlotComponentProps> = UnionToIntersection<{\n\t[TName in keyof TSlotComponentProps as TSlotComponentProps[\"name\"]]: TSlotComponentProps[\"children\"];\n}> & { default: React.ReactNode[] };\n\n/**\n * Symbol used to identify SlotComponent instances\n */\nexport const slotComponentSymbol = Symbol(\"slot-component\");\n\ntype GetSlotMapOptions = {\n\t/**\n\t * If false, the function will bail out early and return only the default slot with the actual children.\n\t * @default true\n\t */\n\tcondition?: boolean;\n};\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\toptions?: GetSlotMapOptions\n): Prettify<GetSlotMapResult<TSlotComponentProps>> => {\n\tconst { condition = true } = options ?? {};\n\n\tif (!condition) {\n\t\treturn { default: children } as GetSlotMapResult<TSlotComponentProps>;\n\t}\n\n\tconst actualChildren =\n\t\tisValidElement<InferProps<typeof ReactFragment>>(children) && children.type === ReactFragment\n\t\t\t? children.props.children\n\t\t\t: children;\n\n\tconst childrenArray = toArray<React.ReactNode>(actualChildren);\n\n\tconst slots: Record<string, React.ReactNode> & { default: React.ReactNode[] } = {\n\t\tdefault: [],\n\t};\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\ttype ElementWithSlotReference = AnyFunction & { slotReference: SlotWithNameAndSymbol };\n\n\t\tconst resolvedChildType = Object.hasOwn(child.type, \"slotReference\")\n\t\t\t? (child.type as ElementWithSlotReference).slotReference\n\t\t\t: (child.type as SlotWithNameAndSymbol);\n\n\t\tconst isSlotElement =\n\t\t\tresolvedChildType.slotSymbol === slotComponentSymbol\n\t\t\t&& Boolean(resolvedChildType.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 = resolvedChildType.slotName ?? child.props.name;\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 */\nexport type GetSlotComponentProps<\n\tTName extends string = string,\n\tTChildren extends React.ReactNode = React.ReactNode,\n> = {\n\t/** Content to render in the slot */\n\tchildren: TChildren;\n\t/** Name of the slot where content should be rendered */\n\tname: TName;\n};\n\n/**\n * @description Slot component created by createSlotComponent\n */\n\nexport const createSlotComponent = <TSlotComponentProps extends GetSlotComponentProps>() => {\n\tconst SlotComponent = (props: TSlotComponentProps) => props.children;\n\n\tSlotComponent.slotSymbol = slotComponentSymbol;\n\n\treturn SlotComponent;\n};\n\ntype SlotWithNameAndSymbol<\n\tTSlotComponentProps extends Pick<GetSlotComponentProps, \"name\"> = Pick<GetSlotComponentProps, \"name\">,\n\tTActualProps extends UnknownObject = UnknownObject,\n> = {\n\t(props: Pick<GetSlotComponentProps, \"children\"> & TActualProps): React.ReactNode;\n\treadonly slotName?: TSlotComponentProps[\"name\"];\n\treadonly slotSymbol?: symbol;\n};\n\nexport const withSlotNameAndSymbol = <\n\tTSlotComponentProps extends Pick<GetSlotComponentProps, \"name\">,\n\tTActualProps extends UnknownObject = UnknownObject,\n>(\n\tname: TSlotComponentProps[\"name\"],\n\tSlotComponent: SlotWithNameAndSymbol<TSlotComponentProps, TActualProps> = (props) => props.children\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\t/* eslint-enable no-param-reassign -- This is necessary */\n\n\treturn SlotComponent;\n};\n","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","import { mergeTwoProps } from \"./mergeTwoProps\";\n\ntype UnionToIntersection<TUnion> = (TUnion extends unknown ? (param: TUnion) => void : \"\") extends (\n\tparam: infer TParam\n) => void\n\t? TParam\n\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"]}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@zayne-labs/toolkit-react",
   "type": "module",
-  "version": "0.9.28",
+  "version": "0.9.29",
   "description": "A collection of utility functions, types and composables used by my other projects. Nothing too fancy but can be useful.",
   "author": "Ryan Zayne",
   "license": "MIT",
@@ -24,9 +24,6 @@
     "./utils": "./dist/esm/utils/index.js",
     "./zustand": "./dist/esm/zustand/index.js"
   },
-  "main": "./dist/esm/hooks/index.js",
-  "module": "./dist/esm/hooks/index.js",
-  "types": "./dist/esm/hooks/index.d.ts",
   "files": [
     "dist"
   ],
@@ -50,8 +47,8 @@
     }
   },
   "dependencies": {
-    "@zayne-labs/toolkit-core": "0.9.28",
-    "@zayne-labs/toolkit-type-helpers": "0.9.28"
+    "@zayne-labs/toolkit-core": "0.9.29",
+    "@zayne-labs/toolkit-type-helpers": "0.9.29"
   },
   "devDependencies": {
     "@arethetypeswrong/cli": "^0.17.4",