@zayne-labs/toolkit-react 0.9.20 → 0.9.23

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

@@ -29,6 +29,11 @@ declare const matchesSlotComponent: (child: React.ReactNode, SlotComponent: Func
  */
 declare const matchesAnySlotComponent: (child: React.ReactNode, SlotComponents: FunctionalComponent[]) => boolean;
 type SlotOptions = {
+    /**
+     * @description If false, the function will bail out early and return null as the slot.
+     * @default true
+     */
+    condition?: boolean;
     /**
      * @description The error message to throw when multiple slots are found for a given slot component
      */
@@ -45,6 +50,11 @@ type SlotOptions = {
  */
 declare const getSingleSlot: (children: React.ReactNode, SlotComponent: FunctionalComponent, options?: SlotOptions) => react.ReactNode;
 type MultipleSlotsOptions = {
+    /**
+     * @description If false, the function will bail out early and return the regularChildren with the actual children and an empty slots array.
+     * @default true
+     */
+    condition?: boolean;
     /**
      * @description The error message to throw when multiple slots are found for a given slot component
      * If a string is provided, the same message will be used for all slot components
@@ -58,17 +68,20 @@ type MultipleSlotsOptions = {
      */
     throwOnMultipleSlotMatch?: boolean | boolean[];
 };
+type GetMultipleSlotsResult<TSlotComponents extends FunctionalComponent[]> = {
+    regularChildren: React.ReactNode[];
+    slots: {
+        [Key in keyof TSlotComponents]: ReturnType<TSlotComponents[Key]>;
+    };
+};
 /**
  * @description The same as getSingleSlot, but for multiple slot components
  */
-declare const getMultipleSlots: <const TSlotComponents extends FunctionalComponent[]>(children: React.ReactNode, SlotComponents: TSlotComponents, options?: MultipleSlotsOptions) => {
-    regularChildren: string[] | undefined[] | null[] | number[] | bigint[] | false[] | true[] | react.ReactElement<unknown, string | react.JSXElementConstructor<any>>[] | Iterable<react.ReactNode>[] | react.ReactPortal[] | Promise<string | number | bigint | boolean | react.ReactPortal | react.ReactElement<unknown, string | react.JSXElementConstructor<any>> | Iterable<react.ReactNode> | null | undefined>[];
-    slots: { [Key in keyof TSlotComponents]: ReturnType<TSlotComponents[Key]>; };
-};
+declare const getMultipleSlots: <const TSlotComponents extends FunctionalComponent[]>(children: React.ReactNode, SlotComponents: TSlotComponents, options?: MultipleSlotsOptions) => Prettify<GetMultipleSlotsResult<TSlotComponents>>;
 /**
  * @description Returns all children that are not slot elements (i.e., don't match any of the provided slot components)
  */
-declare const getRegularChildren: <TChildren extends React.ReactNode>(children: TChildren, SlotComponentOrComponents: FunctionalComponent | FunctionalComponent[]) => TChildren extends unknown[] ? TChildren : TChildren[];
+declare const getRegularChildren: (children: React.ReactNode, SlotComponentOrComponents: FunctionalComponent | FunctionalComponent[], options?: Pick<SlotOptions, "condition">) => react.ReactNode[];
 
 /**
  * Maps slot names to their corresponding children types

package/dist/esm/utils/index.js

@@ -54,9 +54,13 @@ var calculateSlotOccurrences = (childrenArray, SlotComponent) => {
 };
 var getSingleSlot = (children, SlotComponent, options = {}) => {
   const {
+    condition = true,
     errorMessage = "Only one instance of the SlotComponent is allowed",
     throwOnMultipleSlotMatch = false
   } = options;
+  if (!condition) {
+    return null;
+  }
   const actualChildren = isValidElement(children) && children.type === Fragment ? children.props.children : children;
   const childrenArray = toArray(actualChildren);
   const shouldThrow = throwOnMultipleSlotMatch && calculateSlotOccurrences(childrenArray, SlotComponent) > 1;
@@ -67,7 +71,10 @@ var getSingleSlot = (children, SlotComponent, options = {}) => {
   return slotElement;
 };
 var getMultipleSlots = (children, SlotComponents, options) => {
-  const { errorMessage, throwOnMultipleSlotMatch } = options ?? {};
+  const { condition = true, errorMessage, throwOnMultipleSlotMatch } = options ?? {};
+  if (!condition) {
+    return { regularChildren: children, slots: [] };
+  }
   const slots = SlotComponents.map(
     (SlotComponent, index) => getSingleSlot(children, SlotComponent, {
       errorMessage: isArray(errorMessage) ? errorMessage[index] : errorMessage,
@@ -77,7 +84,11 @@ var getMultipleSlots = (children, SlotComponents, options) => {
   const regularChildren = getRegularChildren(children, SlotComponents);
   return { regularChildren, slots };
 };
-var getRegularChildren = (children, SlotComponentOrComponents) => {
+var getRegularChildren = (children, SlotComponentOrComponents, options) => {
+  const { condition = true } = options ?? {};
+  if (!condition) {
+    return [];
+  }
   const actualChildren = isValidElement(children) && children.type === Fragment ? children.props.children : children;
   const childrenArray = toArray(actualChildren);
   const regularChildren = childrenArray.filter(

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

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/utils/composeRefs.ts","../../../src/utils/composeEventHandlers.ts","../../../src/utils/getSlotElement.ts","../../../src/utils/getSlotMap.ts","../../../src/utils/mergeProps.ts","../../../src/utils/mergeTwoProps.ts"],"names":["ReactFragment","isValidElement","toArray","isFunction","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 { AssertionError, type UnknownObject, isArray } 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\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)) {\n\t\treturn false;\n\t}\n\n\ttype WithSlot = { readonly slotSymbol?: unique symbol } | undefined;\n\n\tif (\n\t\t(child.type as WithSlot)?.slotSymbol\n\t\t&& (SlotComponent as WithSlot)?.slotSymbol\n\t\t&& Object.is((child.type as WithSlot)?.slotSymbol, (SlotComponent as WithSlot)?.slotSymbol)\n\t) {\n\t\treturn true;\n\t}\n\n\tif ((child.type as FunctionalComponent).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 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 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\terrorMessage = \"Only one instance of the SlotComponent is allowed\",\n\t\tthrowOnMultipleSlotMatch = false,\n\t} = options;\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 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\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) => {\n\ttype SlotsType = { [Key in keyof TSlotComponents]: ReturnType<TSlotComponents[Key]> };\n\n\tconst { errorMessage, throwOnMultipleSlotMatch } = options ?? {};\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) as SlotsType;\n\n\tconst regularChildren = getRegularChildren(children, SlotComponents);\n\n\treturn { regularChildren, slots };\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 = <TChildren extends React.ReactNode>(\n\tchildren: TChildren,\n\tSlotComponentOrComponents: FunctionalComponent | FunctionalComponent[]\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 as TChildren extends unknown[] ? TChildren : TChildren[];\n};\n","import { toArray } from \"@zayne-labs/toolkit-core\";\nimport type { Prettify, UnionToIntersection, UnknownObject } 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[] } = { default: [] };\n\n\tfor (const child of childrenArray) {\n\t\ttype SlotElementProps = TSlotComponentProps & { \"data-slot-name\": never };\n\n\t\ttype RegularElementProps = Pick<TSlotComponentProps, \"children\"> & {\n\t\t\t\"data-slot-name\": string;\n\t\t\tname: never;\n\t\t};\n\n\t\tconst isSlotElement =\n\t\t\tisValidElement<SlotElementProps>(child)\n\t\t\t&& (child.type as SlotComponentType).slotSymbol === slotComponentSymbol\n\t\t\t&& Boolean((child.type as WithSlotNameAndSymbol).slotName ?? child.props.name);\n\n\t\tconst isRegularElementWithDataSlotName =\n\t\t\tisValidElement<RegularElementProps>(child) && Boolean(child.props[\"data-slot-name\"]);\n\n\t\tif (!isSlotElement && !isRegularElementWithDataSlotName) {\n\t\t\tslots.default.push(child);\n\t\t\tcontinue;\n\t\t}\n\n\t\tconst slotName = isSlotElement\n\t\t\t? ((child.type as WithSlotNameAndSymbol).slotName ?? child.props.name)\n\t\t\t: child.props[\"data-slot-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 SlotComponentType = ReturnType<typeof createSlotComponent>;\n\ntype WithSlotNameAndSymbol<\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: WithSlotNameAndSymbol<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/mergeProps.ts","../../../src/utils/mergeTwoProps.ts"],"names":["ReactFragment","isValidElement","toArray","isFunction","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\tAssertionError,\n\ttype Prettify,\n\ttype UnknownObject,\n\tisArray,\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\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)) {\n\t\treturn false;\n\t}\n\n\ttype WithSlot = { readonly slotSymbol?: unique symbol } | undefined;\n\n\tif (\n\t\t(child.type as WithSlot)?.slotSymbol\n\t\t&& (SlotComponent as WithSlot)?.slotSymbol\n\t\t&& Object.is((child.type as WithSlot)?.slotSymbol, (SlotComponent as WithSlot)?.slotSymbol)\n\t) {\n\t\treturn true;\n\t}\n\n\tif ((child.type as FunctionalComponent).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 type { Prettify, UnionToIntersection, UnknownObject } 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[] } = { default: [] };\n\n\tfor (const child of childrenArray) {\n\t\ttype SlotElementProps = TSlotComponentProps & { \"data-slot-name\": never };\n\n\t\ttype RegularElementProps = Pick<TSlotComponentProps, \"children\"> & {\n\t\t\t\"data-slot-name\": string;\n\t\t\tname: never;\n\t\t};\n\n\t\tconst isSlotElement =\n\t\t\tisValidElement<SlotElementProps>(child)\n\t\t\t&& (child.type as SlotComponentType).slotSymbol === slotComponentSymbol\n\t\t\t&& Boolean((child.type as WithSlotNameAndSymbol).slotName ?? child.props.name);\n\n\t\tconst isRegularElementWithDataSlotName =\n\t\t\tisValidElement<RegularElementProps>(child) && Boolean(child.props[\"data-slot-name\"]);\n\n\t\tif (!isSlotElement && !isRegularElementWithDataSlotName) {\n\t\t\tslots.default.push(child);\n\t\t\tcontinue;\n\t\t}\n\n\t\tconst slotName = isSlotElement\n\t\t\t? ((child.type as WithSlotNameAndSymbol).slotName ?? child.props.name)\n\t\t\t: child.props[\"data-slot-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 SlotComponentType = ReturnType<typeof createSlotComponent>;\n\ntype WithSlotNameAndSymbol<\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: WithSlotNameAndSymbol<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"]}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@zayne-labs/toolkit-react",
   "type": "module",
-  "version": "0.9.20",
+  "version": "0.9.23",
   "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",
@@ -50,8 +50,8 @@
     }
   },
   "dependencies": {
-    "@zayne-labs/toolkit-core": "0.9.20",
-    "@zayne-labs/toolkit-type-helpers": "0.9.20"
+    "@zayne-labs/toolkit-core": "0.9.23",
+    "@zayne-labs/toolkit-type-helpers": "0.9.23"
   },
   "devDependencies": {
     "@arethetypeswrong/cli": "^0.17.4",