@cerberus-design/react 0.0.0-next-bd980a6d9bd07d60e8d7200bd4d56624754e936c

package/dist/system/index.d.ts

@@ -0,0 +1,38 @@
+import { CerberusPrimitive } from './primitive-factory';
+import { CerberusFactory, CerberusPrimitiveRecipe } from './types';
+/**
+ * This module contains the user interface for creating Cerberus primitives.
+ * @module @cerberus/core/system/create-cerb-primitive
+ */
+/**
+ * A factory function that creates a Cerberus primitive instance with the given
+ * recipe.
+ * @param recipe
+ * @returns An object with three methods: `withNoRecipe`, `withRecipe`, and `withSlotRecipe` that
+ * apply the recipes and special Cerberus helpers like `css`.
+ *
+ * @example
+ * ```tsx
+ * const { withRecipe } = createCerberusPrimitive(myCustomRecipe);
+ * export const Button = withRecipe(MyCustomButton)
+ * ```
+ */
+export declare function createCerberusPrimitive<T extends CerberusPrimitiveRecipe>(recipe?: T): CerberusPrimitive;
+/**
+ * A utility function to access Cerberus components by their name.
+ * @param component - The name of the Cerberus component to access.
+ * @returns The Cerberus component corresponding to the provided name.
+ * @throws An error if the component name is not valid.
+ *
+ * @example
+ * ```tsx
+ * import { cerberus } from '@cerberus/react'
+ * const Button = cerberus('button')
+ *
+ * <Button css={{ color: 'blue' }} asChild>
+ *  <Link href="/some-page">Click me</Link>
+ * </Button>
+ * ```
+ */
+export declare const cerberus: CerberusFactory;
+export * from './types';

package/dist/system/index.js

@@ -0,0 +1,42 @@
+import { CerberusPrimitive } from "./primitive-factory.js";
+import { cerberusFactoryProxy } from "./factory.js";
+//#region src/system/index.ts
+/**
+* This module contains the user interface for creating Cerberus primitives.
+* @module @cerberus/core/system/create-cerb-primitive
+*/
+/**
+* A factory function that creates a Cerberus primitive instance with the given
+* recipe.
+* @param recipe
+* @returns An object with three methods: `withNoRecipe`, `withRecipe`, and `withSlotRecipe` that
+* apply the recipes and special Cerberus helpers like `css`.
+*
+* @example
+* ```tsx
+* const { withRecipe } = createCerberusPrimitive(myCustomRecipe);
+* export const Button = withRecipe(MyCustomButton)
+* ```
+*/
+function createCerberusPrimitive(recipe) {
+	return new CerberusPrimitive(recipe);
+}
+/**
+* A utility function to access Cerberus components by their name.
+* @param component - The name of the Cerberus component to access.
+* @returns The Cerberus component corresponding to the provided name.
+* @throws An error if the component name is not valid.
+*
+* @example
+* ```tsx
+* import { cerberus } from '@cerberus/react'
+* const Button = cerberus('button')
+*
+* <Button css={{ color: 'blue' }} asChild>
+*  <Link href="/some-page">Click me</Link>
+* </Button>
+* ```
+*/
+var cerberus = cerberusFactoryProxy;
+//#endregion
+export { cerberus, createCerberusPrimitive };

package/dist/system/primitive-factory.cjs

@@ -0,0 +1,107 @@
+let _ark_ui_react_factory = require("@ark-ui/react/factory");
+let react = require("react");
+let styled_system_css = require("styled-system/css");
+let styled_system_jsx_factory = require("styled-system/jsx/factory");
+let react_jsx_runtime = require("react/jsx-runtime");
+//#region src/system/primitive-factory.tsx
+/**
+* This module contains a factory for creating Cerberus primitives.
+* @module @cerberus/core/system/factory
+*/
+var CerberusPrimitive = class {
+	recipe;
+	constructor(recipe) {
+		this.recipe = recipe ?? null;
+	}
+	setupStyledComponent(component) {
+		const arkComponent = _ark_ui_react_factory.ark[component];
+		if (typeof component !== "string") return (0, styled_system_jsx_factory.cerberus)(component);
+		if (arkComponent) return (0, styled_system_jsx_factory.cerberus)(arkComponent);
+		throw new Error(`Unknown component: ${component}`);
+	}
+	/**
+	* Creates a Cerberus component with bare features and no recipe.
+	* @param Component - The React component to enhance with Cerberus features.
+	* Can be a string or a component reference.
+	* @returns A new React component that applies Cerberus features to the
+	* original component.
+	*
+	* @example
+	* ```ts
+	* const { withNoRecipe } = createCerberusPrimitive(buttonRecipe)
+	* const Button = withNoRecipe('button')
+	* ```
+	*/
+	withNoRecipe = (Component, options) => {
+		const { defaultProps } = options || {};
+		const El = this.setupStyledComponent(Component);
+		const CerbComponent = (0, react.forwardRef)((props, ref) => {
+			return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(El, {
+				...defaultProps,
+				...props,
+				ref
+			});
+		});
+		CerbComponent.displayName = `Cerberus.${typeof El === "string" ? El : El.displayName || El.name}`;
+		return CerbComponent;
+	};
+	/**
+	* Creates a Cerberus component with the given recipe.
+	* @param Component - The React component to enhance with the recipe.
+	* @param options - Options for the recipe.
+	* @returns A new React component that applies the recipe to the original
+	* component.
+	*/
+	withRecipe = (Component, options) => {
+		const { defaultProps } = options || {};
+		const El = this.setupStyledComponent(Component);
+		const recipe = this.recipe;
+		const CerbComponent = (0, react.forwardRef)((internalProps, ref) => {
+			const { css: customCss, ...restOfInternalProps } = internalProps;
+			const [variantOptions, nativeProps] = recipe.splitVariantProps(restOfInternalProps);
+			const recipeStyles = recipe(variantOptions);
+			const className = typeof nativeProps.className === "string" ? nativeProps.className : void 0;
+			return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(El, {
+				...defaultProps,
+				...nativeProps,
+				ref,
+				className: (0, styled_system_css.cx)(className, recipeStyles, (0, styled_system_css.css)(customCss))
+			});
+		});
+		CerbComponent.displayName = typeof El === "string" ? El : El.displayName || El.name;
+		return CerbComponent;
+	};
+	/**
+	* Creates a Cerberus component with a slot recipe applied.
+	* @param Component - The React component to enhance with Cerberus features.
+	* @param recipe - The slot recipe to apply to the component.
+	* @returns A new React component that applies Cerberus features and the
+	* specified slot recipe to the original component.
+	* @example
+	* ```typescript
+	* const { withSlotRecipe } = createCerberusPrimitive(field)
+	* const Field = withSlotRecipe(RawField, field)
+	* ```
+	*/
+	withSlotRecipe = (Component, slot, options) => {
+		const { defaultProps } = options || {};
+		const El = this.setupStyledComponent(Component);
+		const recipe = this.recipe;
+		const CerbComponent = (0, react.forwardRef)((internalProps, ref) => {
+			const { css: customCss, ...restOfInternalProps } = internalProps;
+			const [variantOptions, nativeProps] = recipe.splitVariantProps(restOfInternalProps);
+			const slotStyles = recipe(variantOptions)[slot];
+			const className = typeof nativeProps.className === "string" ? nativeProps.className : void 0;
+			return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(El, {
+				...defaultProps,
+				...nativeProps,
+				ref,
+				className: (0, styled_system_css.cx)(className, slotStyles, (0, styled_system_css.css)(customCss))
+			});
+		});
+		CerbComponent.displayName = typeof El === "string" ? El : El.displayName || El.name;
+		return CerbComponent;
+	};
+};
+//#endregion
+exports.CerberusPrimitive = CerberusPrimitive;

package/dist/system/primitive-factory.d.cts

@@ -0,0 +1,48 @@
+import { ElementType, ForwardRefExoticComponent, PropsWithoutRef, RefAttributes } from 'react';
+import { RecipeVariantRecord } from 'styled-system/types';
+import { ExtractProps } from '../types';
+import { CerberusPrimitiveEl, CerberusPrimitiveProps, CerberusPrimitiveRecipe, WithRecipeOptions } from './types';
+/**
+ * This module contains a factory for creating Cerberus primitives.
+ * @module @cerberus/core/system/factory
+ */
+export declare class CerberusPrimitive {
+    recipe: CerberusPrimitiveRecipe | null;
+    constructor(recipe?: CerberusPrimitiveRecipe);
+    private setupStyledComponent;
+    /**
+     * Creates a Cerberus component with bare features and no recipe.
+     * @param Component - The React component to enhance with Cerberus features.
+     * Can be a string or a component reference.
+     * @returns A new React component that applies Cerberus features to the
+     * original component.
+     *
+     * @example
+     * ```ts
+     * const { withNoRecipe } = createCerberusPrimitive(buttonRecipe)
+     * const Button = withNoRecipe('button')
+     * ```
+     */
+    withNoRecipe: <T extends ElementType>(Component: T | CerberusPrimitiveEl<T>, options?: WithRecipeOptions) => ForwardRefExoticComponent< PropsWithoutRef<CerberusPrimitiveProps<ExtractProps<T>>> & RefAttributes<HTMLElement>>;
+    /**
+     * Creates a Cerberus component with the given recipe.
+     * @param Component - The React component to enhance with the recipe.
+     * @param options - Options for the recipe.
+     * @returns A new React component that applies the recipe to the original
+     * component.
+     */
+    withRecipe: <T extends ElementType>(Component: T, options?: WithRecipeOptions) => ForwardRefExoticComponent< PropsWithoutRef<CerberusPrimitiveProps<ExtractProps<T>>> & RefAttributes<HTMLElement>>;
+    /**
+     * Creates a Cerberus component with a slot recipe applied.
+     * @param Component - The React component to enhance with Cerberus features.
+     * @param recipe - The slot recipe to apply to the component.
+     * @returns A new React component that applies Cerberus features and the
+     * specified slot recipe to the original component.
+     * @example
+     * ```typescript
+     * const { withSlotRecipe } = createCerberusPrimitive(field)
+     * const Field = withSlotRecipe(RawField, field)
+     * ```
+     */
+    withSlotRecipe: <T extends ElementType>(Component: T, slot: keyof RecipeVariantRecord, options?: WithRecipeOptions) => ForwardRefExoticComponent< PropsWithoutRef<CerberusPrimitiveProps<ExtractProps<T>>> & RefAttributes<HTMLElement>>;
+}

package/dist/system/primitive-factory.d.ts

@@ -0,0 +1,48 @@
+import { ElementType, ForwardRefExoticComponent, PropsWithoutRef, RefAttributes } from 'react';
+import { RecipeVariantRecord } from 'styled-system/types';
+import { ExtractProps } from '../types';
+import { CerberusPrimitiveEl, CerberusPrimitiveProps, CerberusPrimitiveRecipe, WithRecipeOptions } from './types';
+/**
+ * This module contains a factory for creating Cerberus primitives.
+ * @module @cerberus/core/system/factory
+ */
+export declare class CerberusPrimitive {
+    recipe: CerberusPrimitiveRecipe | null;
+    constructor(recipe?: CerberusPrimitiveRecipe);
+    private setupStyledComponent;
+    /**
+     * Creates a Cerberus component with bare features and no recipe.
+     * @param Component - The React component to enhance with Cerberus features.
+     * Can be a string or a component reference.
+     * @returns A new React component that applies Cerberus features to the
+     * original component.
+     *
+     * @example
+     * ```ts
+     * const { withNoRecipe } = createCerberusPrimitive(buttonRecipe)
+     * const Button = withNoRecipe('button')
+     * ```
+     */
+    withNoRecipe: <T extends ElementType>(Component: T | CerberusPrimitiveEl<T>, options?: WithRecipeOptions) => ForwardRefExoticComponent< PropsWithoutRef<CerberusPrimitiveProps<ExtractProps<T>>> & RefAttributes<HTMLElement>>;
+    /**
+     * Creates a Cerberus component with the given recipe.
+     * @param Component - The React component to enhance with the recipe.
+     * @param options - Options for the recipe.
+     * @returns A new React component that applies the recipe to the original
+     * component.
+     */
+    withRecipe: <T extends ElementType>(Component: T, options?: WithRecipeOptions) => ForwardRefExoticComponent< PropsWithoutRef<CerberusPrimitiveProps<ExtractProps<T>>> & RefAttributes<HTMLElement>>;
+    /**
+     * Creates a Cerberus component with a slot recipe applied.
+     * @param Component - The React component to enhance with Cerberus features.
+     * @param recipe - The slot recipe to apply to the component.
+     * @returns A new React component that applies Cerberus features and the
+     * specified slot recipe to the original component.
+     * @example
+     * ```typescript
+     * const { withSlotRecipe } = createCerberusPrimitive(field)
+     * const Field = withSlotRecipe(RawField, field)
+     * ```
+     */
+    withSlotRecipe: <T extends ElementType>(Component: T, slot: keyof RecipeVariantRecord, options?: WithRecipeOptions) => ForwardRefExoticComponent< PropsWithoutRef<CerberusPrimitiveProps<ExtractProps<T>>> & RefAttributes<HTMLElement>>;
+}

package/dist/system/primitive-factory.js

@@ -0,0 +1,107 @@
+import { ark } from "@ark-ui/react/factory";
+import { forwardRef } from "react";
+import { css, cx } from "styled-system/css";
+import { cerberus } from "styled-system/jsx/factory";
+import { jsx } from "react/jsx-runtime";
+//#region src/system/primitive-factory.tsx
+/**
+* This module contains a factory for creating Cerberus primitives.
+* @module @cerberus/core/system/factory
+*/
+var CerberusPrimitive = class {
+	recipe;
+	constructor(recipe) {
+		this.recipe = recipe ?? null;
+	}
+	setupStyledComponent(component) {
+		const arkComponent = ark[component];
+		if (typeof component !== "string") return cerberus(component);
+		if (arkComponent) return cerberus(arkComponent);
+		throw new Error(`Unknown component: ${component}`);
+	}
+	/**
+	* Creates a Cerberus component with bare features and no recipe.
+	* @param Component - The React component to enhance with Cerberus features.
+	* Can be a string or a component reference.
+	* @returns A new React component that applies Cerberus features to the
+	* original component.
+	*
+	* @example
+	* ```ts
+	* const { withNoRecipe } = createCerberusPrimitive(buttonRecipe)
+	* const Button = withNoRecipe('button')
+	* ```
+	*/
+	withNoRecipe = (Component, options) => {
+		const { defaultProps } = options || {};
+		const El = this.setupStyledComponent(Component);
+		const CerbComponent = forwardRef((props, ref) => {
+			return /* @__PURE__ */ jsx(El, {
+				...defaultProps,
+				...props,
+				ref
+			});
+		});
+		CerbComponent.displayName = `Cerberus.${typeof El === "string" ? El : El.displayName || El.name}`;
+		return CerbComponent;
+	};
+	/**
+	* Creates a Cerberus component with the given recipe.
+	* @param Component - The React component to enhance with the recipe.
+	* @param options - Options for the recipe.
+	* @returns A new React component that applies the recipe to the original
+	* component.
+	*/
+	withRecipe = (Component, options) => {
+		const { defaultProps } = options || {};
+		const El = this.setupStyledComponent(Component);
+		const recipe = this.recipe;
+		const CerbComponent = forwardRef((internalProps, ref) => {
+			const { css: customCss, ...restOfInternalProps } = internalProps;
+			const [variantOptions, nativeProps] = recipe.splitVariantProps(restOfInternalProps);
+			const recipeStyles = recipe(variantOptions);
+			const className = typeof nativeProps.className === "string" ? nativeProps.className : void 0;
+			return /* @__PURE__ */ jsx(El, {
+				...defaultProps,
+				...nativeProps,
+				ref,
+				className: cx(className, recipeStyles, css(customCss))
+			});
+		});
+		CerbComponent.displayName = typeof El === "string" ? El : El.displayName || El.name;
+		return CerbComponent;
+	};
+	/**
+	* Creates a Cerberus component with a slot recipe applied.
+	* @param Component - The React component to enhance with Cerberus features.
+	* @param recipe - The slot recipe to apply to the component.
+	* @returns A new React component that applies Cerberus features and the
+	* specified slot recipe to the original component.
+	* @example
+	* ```typescript
+	* const { withSlotRecipe } = createCerberusPrimitive(field)
+	* const Field = withSlotRecipe(RawField, field)
+	* ```
+	*/
+	withSlotRecipe = (Component, slot, options) => {
+		const { defaultProps } = options || {};
+		const El = this.setupStyledComponent(Component);
+		const recipe = this.recipe;
+		const CerbComponent = forwardRef((internalProps, ref) => {
+			const { css: customCss, ...restOfInternalProps } = internalProps;
+			const [variantOptions, nativeProps] = recipe.splitVariantProps(restOfInternalProps);
+			const slotStyles = recipe(variantOptions)[slot];
+			const className = typeof nativeProps.className === "string" ? nativeProps.className : void 0;
+			return /* @__PURE__ */ jsx(El, {
+				...defaultProps,
+				...nativeProps,
+				ref,
+				className: cx(className, slotStyles, css(customCss))
+			});
+		});
+		CerbComponent.displayName = typeof El === "string" ? El : El.displayName || El.name;
+		return CerbComponent;
+	};
+};
+//#endregion
+export { CerberusPrimitive };

package/dist/system/types.d.cts

@@ -0,0 +1,38 @@
+import { ark } from '@ark-ui/react/factory';
+import { CSSProperties, ElementType, PropsWithChildren } from 'react';
+import { AsProps, Assign, ComponentProps, Dict, JsxHTMLProps, JsxStyleProps, RecipeVariantFn, RecipeVariantRecord, SlotRecipeVariantFn, SlotRecipeVariantRecord, UnstyledProps } from 'styled-system/types';
+type RecipeBase = {
+    splitVariantProps: (props: Record<string, unknown>) => [Record<string, unknown>, Record<string, unknown>];
+};
+export type CerberusRecipe = RecipeVariantFn<RecipeVariantRecord> & RecipeBase;
+export type CerberusSlotRecipe<T extends string> = SlotRecipeVariantFn<string, SlotRecipeVariantRecord<T>> & RecipeBase;
+export type CerberusPrimitiveRecipe = CerberusRecipe | CerberusSlotRecipe<string>;
+export type WithRecipeOptions = {
+    defaultProps?: Record<string, unknown>;
+};
+export interface BaseCerberusProps extends ArkFactoryProps, JsxStyleProps, Dict, UnstyledProps, AsProps {
+    /**
+     * The CSS styles applied to the component. Supports CSS Properties
+     * declarations and style objects.
+     */
+    style?: CSSProperties | Record<string, string>;
+}
+export type CerberusProps<T extends ElementType, P extends Dict = {}> = JsxHTMLProps<ComponentProps<T> & UnstyledProps & AsProps & ArkFactoryProps, Assign<JsxStyleProps, P>>;
+export type CerberusPrimitiveProps<T> = PropsWithChildren<BaseCerberusProps> & T;
+export type CerberusPrimitiveEl<T extends ElementType = ElementType> = ElementType<CerberusProps<T>>;
+export interface ArkFactoryProps {
+    /**
+     * If true, the component will render as a child as the provided element
+     * passing all the given props to the child.
+     */
+    asChild?: boolean;
+}
+export type ArkPropsWithRef<T extends keyof typeof ark> = {
+    [K in keyof (typeof ark)[T]]: K extends 'asChild' ? never : (typeof ark)[T][K];
+} & ArkFactoryProps;
+export type CerberusFactoryFn = <T extends Record<string, unknown>>(component: keyof typeof ark, defaultProps?: T) => CerberusPrimitiveEl;
+export type CerberusFactoryObject = {
+    [K in keyof typeof ark]: CerberusPrimitiveEl;
+};
+export type CerberusFactory = CerberusFactoryFn & CerberusFactoryObject;
+export {};

package/dist/system/types.d.ts

@@ -0,0 +1,38 @@
+import { ark } from '@ark-ui/react/factory';
+import { CSSProperties, ElementType, PropsWithChildren } from 'react';
+import { AsProps, Assign, ComponentProps, Dict, JsxHTMLProps, JsxStyleProps, RecipeVariantFn, RecipeVariantRecord, SlotRecipeVariantFn, SlotRecipeVariantRecord, UnstyledProps } from 'styled-system/types';
+type RecipeBase = {
+    splitVariantProps: (props: Record<string, unknown>) => [Record<string, unknown>, Record<string, unknown>];
+};
+export type CerberusRecipe = RecipeVariantFn<RecipeVariantRecord> & RecipeBase;
+export type CerberusSlotRecipe<T extends string> = SlotRecipeVariantFn<string, SlotRecipeVariantRecord<T>> & RecipeBase;
+export type CerberusPrimitiveRecipe = CerberusRecipe | CerberusSlotRecipe<string>;
+export type WithRecipeOptions = {
+    defaultProps?: Record<string, unknown>;
+};
+export interface BaseCerberusProps extends ArkFactoryProps, JsxStyleProps, Dict, UnstyledProps, AsProps {
+    /**
+     * The CSS styles applied to the component. Supports CSS Properties
+     * declarations and style objects.
+     */
+    style?: CSSProperties | Record<string, string>;
+}
+export type CerberusProps<T extends ElementType, P extends Dict = {}> = JsxHTMLProps<ComponentProps<T> & UnstyledProps & AsProps & ArkFactoryProps, Assign<JsxStyleProps, P>>;
+export type CerberusPrimitiveProps<T> = PropsWithChildren<BaseCerberusProps> & T;
+export type CerberusPrimitiveEl<T extends ElementType = ElementType> = ElementType<CerberusProps<T>>;
+export interface ArkFactoryProps {
+    /**
+     * If true, the component will render as a child as the provided element
+     * passing all the given props to the child.
+     */
+    asChild?: boolean;
+}
+export type ArkPropsWithRef<T extends keyof typeof ark> = {
+    [K in keyof (typeof ark)[T]]: K extends 'asChild' ? never : (typeof ark)[T][K];
+} & ArkFactoryProps;
+export type CerberusFactoryFn = <T extends Record<string, unknown>>(component: keyof typeof ark, defaultProps?: T) => CerberusPrimitiveEl;
+export type CerberusFactoryObject = {
+    [K in keyof typeof ark]: CerberusPrimitiveEl;
+};
+export type CerberusFactory = CerberusFactoryFn & CerberusFactoryObject;
+export {};

package/dist/types.d.cts

@@ -0,0 +1,12 @@
+import { ComponentType, ElementType, JSX } from 'react';
+export type Positions = 'top' | 'right' | 'bottom' | 'left';
+/**
+ * Utility type to enforce never on all properties of a given type.
+ */
+export type EnforceNoProperties<T> = {
+    [K in keyof T]: never;
+};
+/**
+ * Utility type to extract props for string elements or custom components
+ */
+export type ExtractProps<T> = T extends keyof JSX.IntrinsicElements ? JSX.IntrinsicElements[T] : T extends ComponentType<infer P> ? P : T extends ElementType<infer P> ? P : Record<string, unknown>;

package/dist/types.d.ts

@@ -0,0 +1,12 @@
+import { ComponentType, ElementType, JSX } from 'react';
+export type Positions = 'top' | 'right' | 'bottom' | 'left';
+/**
+ * Utility type to enforce never on all properties of a given type.
+ */
+export type EnforceNoProperties<T> = {
+    [K in keyof T]: never;
+};
+/**
+ * Utility type to extract props for string elements or custom components
+ */
+export type ExtractProps<T> = T extends keyof JSX.IntrinsicElements ? JSX.IntrinsicElements[T] : T extends ComponentType<infer P> ? P : T extends ElementType<infer P> ? P : Record<string, unknown>;

package/dist/utils/index.cjs

@@ -0,0 +1,46 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_localStorage = require("./localStorage.cjs");
+//#region src/utils/index.ts
+/**
+* This module contains utility functions that are used across your app.
+* @module Utils
+*/
+/**
+* Formats the count of notifications to be displayed in the notification badge.
+* @param count - The number of notifications.
+* @returns The formatted count of notifications.
+* @example
+* ```tsx
+* const count = formatNotifyCount(100)
+* console.log(count) // '99+'
+* ```
+*/
+function formatNotifyCount(count) {
+	if (count > 99) return "99+";
+	return count.toString();
+}
+/**
+* Splits the properties of an object into multiple groups based on lists of keys.
+* @param props - The object to split.
+* @param keyGroups - The lists of keys to include in each group.
+* @returns An array of objects: each containing the properties specified in the corresponding key group, and the last object containing the remaining keys.
+*/
+function splitProps(props, ...keyGroups) {
+	const result = keyGroups.map(() => ({}));
+	const rest = {};
+	for (const key in props) {
+		let assigned = false;
+		for (let i = 0; i < keyGroups.length; i++) if (keyGroups[i].includes(key)) {
+			result[i][key] = props[key];
+			assigned = true;
+			break;
+		}
+		if (!assigned) rest[key] = props[key];
+	}
+	return [...result, rest];
+}
+//#endregion
+exports.formatNotifyCount = formatNotifyCount;
+exports.getLocalStorage = require_localStorage.getLocalStorage;
+exports.setLocalStorage = require_localStorage.setLocalStorage;
+exports.splitProps = splitProps;

package/dist/utils/index.d.cts

@@ -0,0 +1,25 @@
+/**
+ * This module contains utility functions that are used across your app.
+ * @module Utils
+ */
+/**
+ * Formats the count of notifications to be displayed in the notification badge.
+ * @param count - The number of notifications.
+ * @returns The formatted count of notifications.
+ * @example
+ * ```tsx
+ * const count = formatNotifyCount(100)
+ * console.log(count) // '99+'
+ * ```
+ */
+export declare function formatNotifyCount(count: number): string;
+/**
+ * Splits the properties of an object into multiple groups based on lists of keys.
+ * @param props - The object to split.
+ * @param keyGroups - The lists of keys to include in each group.
+ * @returns An array of objects: each containing the properties specified in the corresponding key group, and the last object containing the remaining keys.
+ */
+export declare function splitProps<T extends object>(props: T, ...keyGroups: (keyof T)[][]): {
+    [K in keyof T]?: T[K];
+}[];
+export * from './localStorage';

package/dist/utils/index.d.ts

@@ -0,0 +1,25 @@
+/**
+ * This module contains utility functions that are used across your app.
+ * @module Utils
+ */
+/**
+ * Formats the count of notifications to be displayed in the notification badge.
+ * @param count - The number of notifications.
+ * @returns The formatted count of notifications.
+ * @example
+ * ```tsx
+ * const count = formatNotifyCount(100)
+ * console.log(count) // '99+'
+ * ```
+ */
+export declare function formatNotifyCount(count: number): string;
+/**
+ * Splits the properties of an object into multiple groups based on lists of keys.
+ * @param props - The object to split.
+ * @param keyGroups - The lists of keys to include in each group.
+ * @returns An array of objects: each containing the properties specified in the corresponding key group, and the last object containing the remaining keys.
+ */
+export declare function splitProps<T extends object>(props: T, ...keyGroups: (keyof T)[][]): {
+    [K in keyof T]?: T[K];
+}[];
+export * from './localStorage';

package/dist/utils/index.js

@@ -0,0 +1,42 @@
+import { getLocalStorage, setLocalStorage } from "./localStorage.js";
+//#region src/utils/index.ts
+/**
+* This module contains utility functions that are used across your app.
+* @module Utils
+*/
+/**
+* Formats the count of notifications to be displayed in the notification badge.
+* @param count - The number of notifications.
+* @returns The formatted count of notifications.
+* @example
+* ```tsx
+* const count = formatNotifyCount(100)
+* console.log(count) // '99+'
+* ```
+*/
+function formatNotifyCount(count) {
+	if (count > 99) return "99+";
+	return count.toString();
+}
+/**
+* Splits the properties of an object into multiple groups based on lists of keys.
+* @param props - The object to split.
+* @param keyGroups - The lists of keys to include in each group.
+* @returns An array of objects: each containing the properties specified in the corresponding key group, and the last object containing the remaining keys.
+*/
+function splitProps(props, ...keyGroups) {
+	const result = keyGroups.map(() => ({}));
+	const rest = {};
+	for (const key in props) {
+		let assigned = false;
+		for (let i = 0; i < keyGroups.length; i++) if (keyGroups[i].includes(key)) {
+			result[i][key] = props[key];
+			assigned = true;
+			break;
+		}
+		if (!assigned) rest[key] = props[key];
+	}
+	return [...result, rest];
+}
+//#endregion
+export { formatNotifyCount, getLocalStorage, setLocalStorage, splitProps };

package/dist/utils/localStorage.cjs

@@ -0,0 +1,26 @@
+"use client";
+"use client";
+//#region src/utils/localStorage.ts
+/**
+* A utility function to get a value from local storage.
+* @param key The key to get from local storage.
+* @param defaultValue The fallback value if the key is not found.
+* @returns key or defaultValue
+*/
+function getLocalStorage(key, defaultValue) {
+	const value = window.localStorage.getItem(key);
+	if (value) return value;
+	return defaultValue;
+}
+/**
+* A utility function to set a value in local storage.
+* @param key The key to set in local storage.
+* @param value The value to set in local storage.
+*/
+function setLocalStorage(key, value) {
+	const stringValue = typeof value === "string" ? value : JSON.stringify(value);
+	window.localStorage.setItem(key, stringValue);
+}
+//#endregion
+exports.getLocalStorage = getLocalStorage;
+exports.setLocalStorage = setLocalStorage;