@med_ghoul/forge-shared 1.2.0

package/dist/hooks/use-multi-select/use-multi-select.d.cts

@@ -0,0 +1,55 @@
+import { Dispatch, SetStateAction } from 'react';
+
+/**
+ * Custom hook to manage the selection state of a list of items.
+ *
+ * @param {string[]} itemIds - The list of item IDs to manage.
+ * @param {string[]} [defaultSelected=[]] - The list of default selected item IDs.
+ *
+ * @returns {UseMultiSelectReturn} - An object containing:
+ * - `values`: The current list of selected item IDs.
+ * - `status`: The current selection status ('checked', 'unchecked', 'indeterminate').
+ * - `setValues`: A function to manually set the selected item IDs.
+ * - `onSelectAllItems`: A function to select all items.
+ * - `onDeSelectAllItems`: A function to deselect all items.
+ * - `onToggleSelectItem`: A function to toggle the selection of a specific item.
+ *
+ * @example
+ * const { values, status, onSelectAllItems, onDeSelectAllItems, onToggleSelectItem } = useMultiSelect(['item1', 'item2', 'item3'], ['item1']);
+ *
+ * return (
+ *   <div>
+ *     <button onClick={onSelectAllItems}>Select All</button>
+ *     <button onClick={onDeSelectAllItems}>Deselect All</button>
+ *     {itemIds.map(itemId => (
+ *       <div key={itemId}>
+ *         <input
+ *           type="checkbox"
+ *           checked={values.includes(itemId)}
+ *           onChange={() => onToggleSelectItem(itemId)}
+ *         />
+ *         {itemId}
+ *       </div>
+ *     ))}
+ *   </div>
+ * );
+ */
+type UseMultiSelectReturn = {
+    values: string[];
+    status: 'checked' | 'unchecked' | 'indeterminate';
+    setValues: Dispatch<SetStateAction<string[]>>;
+    onSelectAllItems: () => void;
+    onDeSelectAllItems: () => void;
+    onToggleSelectItem: (inputValue: string) => void;
+};
+declare function useMultiSelect(listItems: string[], defaultSelectedItems?: string[]): UseMultiSelectReturn;
+/**
+ * Updates the selected items list by adding or removing the specified item.
+ *
+ * @param {string[]} selectedItems - The current list of selected items.
+ * @param {string} newItem - The item to add or remove.
+ * @returns {string[]} - The updated list of selected items.
+ */
+declare function updateSelectedItems(selectedItems: string[], newItem: string): string[];
+
+export { type UseMultiSelectReturn, updateSelectedItems, useMultiSelect };

package/dist/hooks/use-multi-select/use-multi-select.d.ts

@@ -0,0 +1,55 @@
+import { Dispatch, SetStateAction } from 'react';
+
+/**
+ * Custom hook to manage the selection state of a list of items.
+ *
+ * @param {string[]} itemIds - The list of item IDs to manage.
+ * @param {string[]} [defaultSelected=[]] - The list of default selected item IDs.
+ *
+ * @returns {UseMultiSelectReturn} - An object containing:
+ * - `values`: The current list of selected item IDs.
+ * - `status`: The current selection status ('checked', 'unchecked', 'indeterminate').
+ * - `setValues`: A function to manually set the selected item IDs.
+ * - `onSelectAllItems`: A function to select all items.
+ * - `onDeSelectAllItems`: A function to deselect all items.
+ * - `onToggleSelectItem`: A function to toggle the selection of a specific item.
+ *
+ * @example
+ * const { values, status, onSelectAllItems, onDeSelectAllItems, onToggleSelectItem } = useMultiSelect(['item1', 'item2', 'item3'], ['item1']);
+ *
+ * return (
+ *   <div>
+ *     <button onClick={onSelectAllItems}>Select All</button>
+ *     <button onClick={onDeSelectAllItems}>Deselect All</button>
+ *     {itemIds.map(itemId => (
+ *       <div key={itemId}>
+ *         <input
+ *           type="checkbox"
+ *           checked={values.includes(itemId)}
+ *           onChange={() => onToggleSelectItem(itemId)}
+ *         />
+ *         {itemId}
+ *       </div>
+ *     ))}
+ *   </div>
+ * );
+ */
+type UseMultiSelectReturn = {
+    values: string[];
+    status: 'checked' | 'unchecked' | 'indeterminate';
+    setValues: Dispatch<SetStateAction<string[]>>;
+    onSelectAllItems: () => void;
+    onDeSelectAllItems: () => void;
+    onToggleSelectItem: (inputValue: string) => void;
+};
+declare function useMultiSelect(listItems: string[], defaultSelectedItems?: string[]): UseMultiSelectReturn;
+/**
+ * Updates the selected items list by adding or removing the specified item.
+ *
+ * @param {string[]} selectedItems - The current list of selected items.
+ * @param {string} newItem - The item to add or remove.
+ * @returns {string[]} - The updated list of selected items.
+ */
+declare function updateSelectedItems(selectedItems: string[], newItem: string): string[];
+
+export { type UseMultiSelectReturn, updateSelectedItems, useMultiSelect };

package/dist/hooks/use-multi-select/use-multi-select.js

@@ -0,0 +1 @@
+import{useCallback as c,useMemo as a,useState as S}from"react";function d(e,n){let[t,l]=S(n??[]),i=c(r=>{l(g=>h(g,r))},[]),o=c(()=>{l(r=>r.length===e.length?[]:e)},[e]),u=c(()=>{l([])},[]),s=a(()=>t.length===0?"unchecked":t.length===e.length?"checked":"indeterminate",[e.length,t.length]);return{values:t,status:s,setValues:l,onSelectAllItems:o,onDeSelectAllItems:u,onToggleSelectItem:i}}function h(e,n){return e.includes(n)?e.filter(t=>t!==n):[...e,n]}export{h as updateSelectedItems,d as useMultiSelect};

package/dist/hooks/use-popover/index.cjs

@@ -0,0 +1 @@
+"use strict";var s=Object.defineProperty;var p=Object.getOwnPropertyDescriptor;var u=Object.getOwnPropertyNames;var c=Object.prototype.hasOwnProperty;var T=(t,e)=>{for(var o in e)s(t,o,{get:e[o],enumerable:!0})},a=(t,e,o,r)=>{if(e&&typeof e=="object"||typeof e=="function")for(let n of u(e))!c.call(t,n)&&n!==o&&s(t,n,{get:()=>e[n],enumerable:!(r=p(e,n))||r.enumerable});return t};var E=t=>a(s({},"__esModule",{value:!0}),t);var m={};T(m,{usePopover:()=>i});module.exports=E(m);var l=require("react");function i(){let[t,e]=(0,l.useState)(null),o=(0,l.useCallback)(n=>{e(n.currentTarget)},[]),r=(0,l.useCallback)(()=>{e(null)},[]);return{open:!!t,anchorEl:t,onOpen:o,onClose:r,setAnchorEl:e}}0&&(module.exports={usePopover});

package/dist/hooks/use-popover/index.d.cts

@@ -0,0 +1,2 @@
+export { UsePopoverReturn, usePopover } from './use-popover.cjs';
+import 'react';

package/dist/hooks/use-popover/index.d.ts

@@ -0,0 +1,2 @@
+export { UsePopoverReturn, usePopover } from './use-popover.js';
+import 'react';

package/dist/hooks/use-popover/index.js

@@ -0,0 +1 @@
+import{useCallback as n,useState as s}from"react";function u(){let[t,e]=s(null),o=n(r=>{e(r.currentTarget)},[]),l=n(()=>{e(null)},[]);return{open:!!t,anchorEl:t,onOpen:o,onClose:l,setAnchorEl:e}}export{u as usePopover};

package/dist/hooks/use-popover/use-popover.cjs

@@ -0,0 +1 @@
+"use strict";var s=Object.defineProperty;var u=Object.getOwnPropertyDescriptor;var c=Object.getOwnPropertyNames;var p=Object.prototype.hasOwnProperty;var T=(t,e)=>{for(var o in e)s(t,o,{get:e[o],enumerable:!0})},a=(t,e,o,r)=>{if(e&&typeof e=="object"||typeof e=="function")for(let n of c(e))!p.call(t,n)&&n!==o&&s(t,n,{get:()=>e[n],enumerable:!(r=u(e,n))||r.enumerable});return t};var E=t=>a(s({},"__esModule",{value:!0}),t);var v={};T(v,{usePopover:()=>i});module.exports=E(v);var l=require("react");function i(){let[t,e]=(0,l.useState)(null),o=(0,l.useCallback)(n=>{e(n.currentTarget)},[]),r=(0,l.useCallback)(()=>{e(null)},[]);return{open:!!t,anchorEl:t,onOpen:o,onClose:r,setAnchorEl:e}}0&&(module.exports={usePopover});

package/dist/hooks/use-popover/use-popover.d.cts

@@ -0,0 +1,35 @@
+import { MouseEvent, Dispatch, SetStateAction } from 'react';
+
+/**
+ * Custom hook to manage the state of a popover.
+ *
+ * @returns {UsePopoverReturn<T>} - An object containing:
+ * - `open`: A boolean indicating whether the popover is open.
+ * - `anchorEl`: The current element that the popover is anchored to.
+ * - `onClose`: A function to close the popover.
+ * - `onOpen`: A function to open the popover.
+ * - `setAnchorEl`: A function to manually set the anchor element.
+ *
+ * @example
+ * const { open, anchorEl, onOpen, onClose } = usePopover<HTMLButtonElement>();
+ *
+ * return (
+ *   <>
+ *     <button variant="contained" onClick={onOpen}>Click me</button>
+ *
+ *     <Popover open={open} onClose={onClose} anchorEl={anchorEl}>
+ *        Popover content
+ *      </Popover>
+ *   </>
+ * );
+ */
+type UsePopoverReturn<T extends HTMLElement = HTMLElement> = {
+    open: boolean;
+    anchorEl: T | null;
+    onClose: () => void;
+    onOpen: (event: MouseEvent<T>) => void;
+    setAnchorEl: Dispatch<SetStateAction<T | null>>;
+};
+declare function usePopover<T extends HTMLElement = HTMLElement>(): UsePopoverReturn<T>;
+
+export { type UsePopoverReturn, usePopover };

package/dist/hooks/use-popover/use-popover.d.ts

@@ -0,0 +1,35 @@
+import { MouseEvent, Dispatch, SetStateAction } from 'react';
+
+/**
+ * Custom hook to manage the state of a popover.
+ *
+ * @returns {UsePopoverReturn<T>} - An object containing:
+ * - `open`: A boolean indicating whether the popover is open.
+ * - `anchorEl`: The current element that the popover is anchored to.
+ * - `onClose`: A function to close the popover.
+ * - `onOpen`: A function to open the popover.
+ * - `setAnchorEl`: A function to manually set the anchor element.
+ *
+ * @example
+ * const { open, anchorEl, onOpen, onClose } = usePopover<HTMLButtonElement>();
+ *
+ * return (
+ *   <>
+ *     <button variant="contained" onClick={onOpen}>Click me</button>
+ *
+ *     <Popover open={open} onClose={onClose} anchorEl={anchorEl}>
+ *        Popover content
+ *      </Popover>
+ *   </>
+ * );
+ */
+type UsePopoverReturn<T extends HTMLElement = HTMLElement> = {
+    open: boolean;
+    anchorEl: T | null;
+    onClose: () => void;
+    onOpen: (event: MouseEvent<T>) => void;
+    setAnchorEl: Dispatch<SetStateAction<T | null>>;
+};
+declare function usePopover<T extends HTMLElement = HTMLElement>(): UsePopoverReturn<T>;
+
+export { type UsePopoverReturn, usePopover };

package/dist/hooks/use-popover/use-popover.js

@@ -0,0 +1 @@
+import{useCallback as n,useState as s}from"react";function c(){let[t,e]=s(null),o=n(r=>{e(r.currentTarget)},[]),l=n(()=>{e(null)},[]);return{open:!!t,anchorEl:t,onOpen:o,onClose:l,setAnchorEl:e}}export{c as usePopover};

package/dist/hooks/use-popover-hover/index.cjs

@@ -0,0 +1 @@
+"use strict";var s=Object.defineProperty;var p=Object.getOwnPropertyDescriptor;var f=Object.getOwnPropertyNames;var u=Object.prototype.hasOwnProperty;var T=(t,e)=>{for(var n in e)s(t,n,{get:e[n],enumerable:!0})},m=(t,e,n,r)=>{if(e&&typeof e=="object"||typeof e=="function")for(let o of f(e))!u.call(t,o)&&o!==n&&s(t,o,{get:()=>e[o],enumerable:!(r=p(e,o))||r.enumerable});return t};var R=t=>m(s({},"__esModule",{value:!0}),t);var b={};T(b,{usePopoverHover:()=>i});module.exports=R(b);var l=require("react");function i(t){let e=(0,l.useRef)(null),n=t||e,[r,o]=(0,l.useState)(!1),c=(0,l.useCallback)(()=>{o(!0)},[]),a=(0,l.useCallback)(()=>{o(!1)},[]);return{elementRef:n,anchorEl:n.current,open:r,onOpen:c,onClose:a,setOpen:o}}0&&(module.exports={usePopoverHover});

package/dist/hooks/use-popover-hover/index.d.cts

@@ -0,0 +1,2 @@
+export { usePopoverHover } from './use-popover-hover.cjs';
+import 'react';

package/dist/hooks/use-popover-hover/index.d.ts

@@ -0,0 +1,2 @@
+export { usePopoverHover } from './use-popover-hover.js';
+import 'react';

package/dist/hooks/use-popover-hover/index.js

@@ -0,0 +1 @@
+import{useCallback as o,useRef as a,useState as p}from"react";function u(n){let l=a(null),t=n||l,[r,e]=p(!1),s=o(()=>{e(!0)},[]),c=o(()=>{e(!1)},[]);return{elementRef:t,anchorEl:t.current,open:r,onOpen:s,onClose:c,setOpen:e}}export{u as usePopoverHover};

package/dist/hooks/use-popover-hover/use-popover-hover.cjs

@@ -0,0 +1 @@
+"use strict";var r=Object.defineProperty;var p=Object.getOwnPropertyDescriptor;var f=Object.getOwnPropertyNames;var u=Object.prototype.hasOwnProperty;var T=(t,e)=>{for(var n in e)r(t,n,{get:e[n],enumerable:!0})},m=(t,e,n,s)=>{if(e&&typeof e=="object"||typeof e=="function")for(let o of f(e))!u.call(t,o)&&o!==n&&r(t,o,{get:()=>e[o],enumerable:!(s=p(e,o))||s.enumerable});return t};var R=t=>m(r({},"__esModule",{value:!0}),t);var b={};T(b,{usePopoverHover:()=>i});module.exports=R(b);var l=require("react");function i(t){let e=(0,l.useRef)(null),n=t||e,[s,o]=(0,l.useState)(!1),c=(0,l.useCallback)(()=>{o(!0)},[]),a=(0,l.useCallback)(()=>{o(!1)},[]);return{elementRef:n,anchorEl:n.current,open:s,onOpen:c,onClose:a,setOpen:o}}0&&(module.exports={usePopoverHover});

package/dist/hooks/use-popover-hover/use-popover-hover.d.cts

@@ -0,0 +1,41 @@
+import { RefObject, Dispatch, SetStateAction } from 'react';
+
+/**
+ * Custom hook to manage the state of a popover that opens on hover.
+ *
+ * @param {RefObject<T | null>} [inputRef] - An optional ref object to use for the popover element.
+ *
+ * @returns {UsePopoverHoverReturn<T>} - An object containing:
+ * - `open`: A boolean indicating whether the popover is open.
+ * - `onOpen`: A function to open the popover.
+ * - `anchorEl`: The current element that the popover is anchored to.
+ * - `onClose`: A function to close the popover.
+ * - `elementRef`: A ref object for the popover element.
+ * - `setOpen`: A function to manually set the open state of the popover.
+ *
+ * @example
+ * const { open, onOpen, onClose, elementRef } = usePopoverHover<HTMLButtonElement>();
+ *
+ * return (
+ *   <>
+ *      <button ref={elementRef} onMouseEnter={onOpen} onMouseLeave={onClose}>
+ *        Hover me
+ *      </button>
+ *
+ *      <Popover open={open} anchorEl={anchorEl}>
+ *        Popover content
+ *      </Popover>
+ *   </>
+ * );
+ */
+type UsePopoverHoverReturn<T extends HTMLElement = HTMLElement> = {
+    open: boolean;
+    anchorEl: T | null;
+    onOpen: () => void;
+    onClose: () => void;
+    elementRef: RefObject<T>;
+    setOpen: Dispatch<SetStateAction<boolean>>;
+};
+declare function usePopoverHover<T extends HTMLElement = HTMLElement>(inputRef?: RefObject<T | null>): UsePopoverHoverReturn<T>;
+
+export { usePopoverHover };

package/dist/hooks/use-popover-hover/use-popover-hover.d.ts

@@ -0,0 +1,41 @@
+import { RefObject, Dispatch, SetStateAction } from 'react';
+
+/**
+ * Custom hook to manage the state of a popover that opens on hover.
+ *
+ * @param {RefObject<T | null>} [inputRef] - An optional ref object to use for the popover element.
+ *
+ * @returns {UsePopoverHoverReturn<T>} - An object containing:
+ * - `open`: A boolean indicating whether the popover is open.
+ * - `onOpen`: A function to open the popover.
+ * - `anchorEl`: The current element that the popover is anchored to.
+ * - `onClose`: A function to close the popover.
+ * - `elementRef`: A ref object for the popover element.
+ * - `setOpen`: A function to manually set the open state of the popover.
+ *
+ * @example
+ * const { open, onOpen, onClose, elementRef } = usePopoverHover<HTMLButtonElement>();
+ *
+ * return (
+ *   <>
+ *      <button ref={elementRef} onMouseEnter={onOpen} onMouseLeave={onClose}>
+ *        Hover me
+ *      </button>
+ *
+ *      <Popover open={open} anchorEl={anchorEl}>
+ *        Popover content
+ *      </Popover>
+ *   </>
+ * );
+ */
+type UsePopoverHoverReturn<T extends HTMLElement = HTMLElement> = {
+    open: boolean;
+    anchorEl: T | null;
+    onOpen: () => void;
+    onClose: () => void;
+    elementRef: RefObject<T>;
+    setOpen: Dispatch<SetStateAction<boolean>>;
+};
+declare function usePopoverHover<T extends HTMLElement = HTMLElement>(inputRef?: RefObject<T | null>): UsePopoverHoverReturn<T>;
+
+export { usePopoverHover };

package/dist/hooks/use-popover-hover/use-popover-hover.js

@@ -0,0 +1 @@
+import{useCallback as o,useRef as a,useState as p}from"react";function u(n){let l=a(null),t=n||l,[s,e]=p(!1),r=o(()=>{e(!0)},[]),c=o(()=>{e(!1)},[]);return{elementRef:t,anchorEl:t.current,open:s,onOpen:r,onClose:c,setOpen:e}}export{u as usePopoverHover};

package/dist/hooks/use-scroll-offset-top/index.cjs

@@ -0,0 +1 @@
+"use strict";var f=Object.defineProperty;var T=Object.getOwnPropertyDescriptor;var p=Object.getOwnPropertyNames;var m=Object.prototype.hasOwnProperty;var i=(t,e)=>{for(var r in e)f(t,r,{get:e[r],enumerable:!0})},u=(t,e,r,s)=>{if(e&&typeof e=="object"||typeof e=="function")for(let o of p(e))!m.call(t,o)&&o!==r&&f(t,o,{get:()=>e[o],enumerable:!(s=T(e,o))||s.enumerable});return t};var w=t=>u(f({},"__esModule",{value:!0}),t);var R={};i(R,{useScrollOffsetTop:()=>O});module.exports=w(R);var n=require("react");function O(t=0){let e=(0,n.useRef)(null),[r,s]=(0,n.useState)(!1),o=(0,n.useCallback)(()=>{let l=window.scrollY;if(e.current){let c=e.current.offsetTop;s(l>c-t)}else s(l>t)},[t]);return(0,n.useEffect)(()=>(o(),window.addEventListener("scroll",o),()=>{window.removeEventListener("scroll",o)}),[o]),{elementRef:e,offsetTop:r}}0&&(module.exports={useScrollOffsetTop});

package/dist/hooks/use-scroll-offset-top/index.d.cts

@@ -0,0 +1,2 @@
+export { UseScrollOffsetTopReturn, useScrollOffsetTop } from './use-scroll-offset-top.cjs';
+import 'react';

package/dist/hooks/use-scroll-offset-top/index.d.ts

@@ -0,0 +1,2 @@
+export { UseScrollOffsetTopReturn, useScrollOffsetTop } from './use-scroll-offset-top.js';
+import 'react';

package/dist/hooks/use-scroll-offset-top/index.js

@@ -0,0 +1 @@
+import{useCallback as l,useEffect as c,useRef as T,useState as p}from"react";function i(t=0){let o=T(null),[s,n]=p(!1),e=l(()=>{let r=window.scrollY;if(o.current){let f=o.current.offsetTop;n(r>f-t)}else n(r>t)},[t]);return c(()=>(e(),window.addEventListener("scroll",e),()=>{window.removeEventListener("scroll",e)}),[e]),{elementRef:o,offsetTop:s}}export{i as useScrollOffsetTop};

package/dist/hooks/use-scroll-offset-top/use-scroll-offset-top.cjs

@@ -0,0 +1 @@
+"use strict";var l=Object.defineProperty;var T=Object.getOwnPropertyDescriptor;var p=Object.getOwnPropertyNames;var m=Object.prototype.hasOwnProperty;var i=(t,e)=>{for(var s in e)l(t,s,{get:e[s],enumerable:!0})},u=(t,e,s,r)=>{if(e&&typeof e=="object"||typeof e=="function")for(let o of p(e))!m.call(t,o)&&o!==s&&l(t,o,{get:()=>e[o],enumerable:!(r=T(e,o))||r.enumerable});return t};var w=t=>u(l({},"__esModule",{value:!0}),t);var R={};i(R,{useScrollOffsetTop:()=>O});module.exports=w(R);var n=require("react");function O(t=0){let e=(0,n.useRef)(null),[s,r]=(0,n.useState)(!1),o=(0,n.useCallback)(()=>{let f=window.scrollY;if(e.current){let c=e.current.offsetTop;r(f>c-t)}else r(f>t)},[t]);return(0,n.useEffect)(()=>(o(),window.addEventListener("scroll",o),()=>{window.removeEventListener("scroll",o)}),[o]),{elementRef:e,offsetTop:s}}0&&(module.exports={useScrollOffsetTop});

package/dist/hooks/use-scroll-offset-top/use-scroll-offset-top.d.cts

@@ -0,0 +1,28 @@
+import { RefObject } from 'react';
+
+/**
+ * Custom hook to manage the offset top state based on scroll position.
+ *
+ * @param {number} [defaultValue=0] - The offset value at which the state changes.
+ *
+ * @returns {UseScrollOffsetTopReturn<T>} - An object containing:
+ * - `offsetTop`: A boolean indicating whether the scroll position is past the offset.
+ * - `elementRef`: A ref object to attach to the element to track its offset.
+ *
+ * @example
+ * 1.Applies to top <header/>
+ * const { offsetTop } = useScrollOffsetTop(80);
+ *
+ * Or
+ *
+ * 2.Applies to element
+ * const { offsetTop, elementRef } = useScrollOffsetTop(80);
+ * <div ref={elementRef} />
+ */
+type UseScrollOffsetTopReturn<T extends HTMLElement = HTMLElement> = {
+    offsetTop: boolean;
+    elementRef: RefObject<T>;
+};
+declare function useScrollOffsetTop<T extends HTMLElement = HTMLElement>(defaultValue?: number): UseScrollOffsetTopReturn<T>;
+
+export { type UseScrollOffsetTopReturn, useScrollOffsetTop };

package/dist/hooks/use-scroll-offset-top/use-scroll-offset-top.d.ts

@@ -0,0 +1,28 @@
+import { RefObject } from 'react';
+
+/**
+ * Custom hook to manage the offset top state based on scroll position.
+ *
+ * @param {number} [defaultValue=0] - The offset value at which the state changes.
+ *
+ * @returns {UseScrollOffsetTopReturn<T>} - An object containing:
+ * - `offsetTop`: A boolean indicating whether the scroll position is past the offset.
+ * - `elementRef`: A ref object to attach to the element to track its offset.
+ *
+ * @example
+ * 1.Applies to top <header/>
+ * const { offsetTop } = useScrollOffsetTop(80);
+ *
+ * Or
+ *
+ * 2.Applies to element
+ * const { offsetTop, elementRef } = useScrollOffsetTop(80);
+ * <div ref={elementRef} />
+ */
+type UseScrollOffsetTopReturn<T extends HTMLElement = HTMLElement> = {
+    offsetTop: boolean;
+    elementRef: RefObject<T>;
+};
+declare function useScrollOffsetTop<T extends HTMLElement = HTMLElement>(defaultValue?: number): UseScrollOffsetTopReturn<T>;
+
+export { type UseScrollOffsetTopReturn, useScrollOffsetTop };

package/dist/hooks/use-scroll-offset-top/use-scroll-offset-top.js

@@ -0,0 +1 @@
+import{useCallback as f,useEffect as c,useRef as T,useState as p}from"react";function i(t=0){let o=T(null),[r,n]=p(!1),e=f(()=>{let s=window.scrollY;if(o.current){let l=o.current.offsetTop;n(s>l-t)}else n(s>t)},[t]);return c(()=>(e(),window.addEventListener("scroll",e),()=>{window.removeEventListener("scroll",e)}),[e]),{elementRef:o,offsetTop:r}}export{i as useScrollOffsetTop};

package/dist/hooks/use-set-state/index.cjs

@@ -0,0 +1 @@
+"use strict";var d=Object.defineProperty;var n=Object.getOwnPropertyDescriptor;var f=Object.getOwnPropertyNames;var p=Object.prototype.hasOwnProperty;var l=(t,e)=>{for(var a in e)d(t,a,{get:e[a],enumerable:!0})},c=(t,e,a,T)=>{if(e&&typeof e=="object"||typeof e=="function")for(let s of f(e))!p.call(t,s)&&s!==a&&d(t,s,{get:()=>e[s],enumerable:!(T=n(e,s))||T.enumerable});return t};var i=t=>c(d({},"__esModule",{value:!0}),t);var y={};l(y,{useSetState:()=>k});module.exports=i(y);var o=require("react");function k(t){let[e,a]=(0,o.useState)(t),T=(0,o.useCallback)(r=>{a(u=>({...u,...r}))},[]),s=(0,o.useCallback)((r,u)=>{T({[r]:u})},[T]),S=(0,o.useCallback)(r=>{a(r??t)},[t]);return{state:e,setState:T,setField:s,resetState:S}}0&&(module.exports={useSetState});

package/dist/hooks/use-set-state/index.d.cts

@@ -0,0 +1 @@
+export { UseSetStateReturn, useSetState } from './use-set-state.cjs';

package/dist/hooks/use-set-state/index.d.ts

@@ -0,0 +1 @@
+export { UseSetStateReturn, useSetState } from './use-set-state.js';

package/dist/hooks/use-set-state/index.js

@@ -0,0 +1 @@
+import{useCallback as T,useState as S}from"react";function f(e){let[r,o]=S(e),a=T(t=>{o(s=>({...s,...t}))},[]),u=T((t,s)=>{a({[t]:s})},[a]),d=T(t=>{o(t??e)},[e]);return{state:r,setState:a,setField:u,resetState:d}}export{f as useSetState};

package/dist/hooks/use-set-state/use-set-state.cjs

@@ -0,0 +1 @@
+"use strict";var r=Object.defineProperty;var n=Object.getOwnPropertyDescriptor;var f=Object.getOwnPropertyNames;var l=Object.prototype.hasOwnProperty;var p=(t,e)=>{for(var a in e)r(t,a,{get:e[a],enumerable:!0})},c=(t,e,a,T)=>{if(e&&typeof e=="object"||typeof e=="function")for(let s of f(e))!l.call(t,s)&&s!==a&&r(t,s,{get:()=>e[s],enumerable:!(T=n(e,s))||T.enumerable});return t};var i=t=>c(r({},"__esModule",{value:!0}),t);var y={};p(y,{useSetState:()=>k});module.exports=i(y);var o=require("react");function k(t){let[e,a]=(0,o.useState)(t),T=(0,o.useCallback)(u=>{a(d=>({...d,...u}))},[]),s=(0,o.useCallback)((u,d)=>{T({[u]:d})},[T]),S=(0,o.useCallback)(u=>{a(u??t)},[t]);return{state:e,setState:T,setField:s,resetState:S}}0&&(module.exports={useSetState});

package/dist/hooks/use-set-state/use-set-state.d.cts

@@ -0,0 +1,32 @@
+/**
+ * Custom hook to manage state with utility functions to set state, set a specific field, and reset state.
+ *
+ * @param {T} initialState - The initial state value.
+ *
+ * @returns {UseSetStateReturn<T>} - An object containing:
+ * - `state`: The current state.
+ * - `resetState`: A function to reset the state to the initial value.
+ * - `setState`: A function to update the state.
+ * - `setField`: A function to update a specific field in the state.
+ *
+ * @example
+ * const { state, setState, setField, resetState } = useSetState({ name: '', age: 0 });
+ *
+ * return (
+ *   <div>
+ *     <p>Name: {state.name}</p>
+ *     <p>Age: {state.age}</p>
+ *     <button onClick={() => setField('name', 'John')}>Set Name</button>
+ *     <button onClick={resetState}>Reset</button>
+ *   </div>
+ * );
+ */
+type UseSetStateReturn<T> = {
+    state: T;
+    resetState: (defaultState?: T) => void;
+    setState: (updateState: T | Partial<T>) => void;
+    setField: (name: keyof T, updateValue: T[keyof T]) => void;
+};
+declare function useSetState<T>(initialState?: T): UseSetStateReturn<T>;
+
+export { type UseSetStateReturn, useSetState };

package/dist/hooks/use-set-state/use-set-state.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Custom hook to manage state with utility functions to set state, set a specific field, and reset state.
+ *
+ * @param {T} initialState - The initial state value.
+ *
+ * @returns {UseSetStateReturn<T>} - An object containing:
+ * - `state`: The current state.
+ * - `resetState`: A function to reset the state to the initial value.
+ * - `setState`: A function to update the state.
+ * - `setField`: A function to update a specific field in the state.
+ *
+ * @example
+ * const { state, setState, setField, resetState } = useSetState({ name: '', age: 0 });
+ *
+ * return (
+ *   <div>
+ *     <p>Name: {state.name}</p>
+ *     <p>Age: {state.age}</p>
+ *     <button onClick={() => setField('name', 'John')}>Set Name</button>
+ *     <button onClick={resetState}>Reset</button>
+ *   </div>
+ * );
+ */
+type UseSetStateReturn<T> = {
+    state: T;
+    resetState: (defaultState?: T) => void;
+    setState: (updateState: T | Partial<T>) => void;
+    setField: (name: keyof T, updateValue: T[keyof T]) => void;
+};
+declare function useSetState<T>(initialState?: T): UseSetStateReturn<T>;
+
+export { type UseSetStateReturn, useSetState };

package/dist/hooks/use-set-state/use-set-state.js

@@ -0,0 +1 @@
+import{useCallback as T,useState as S}from"react";function f(e){let[u,o]=S(e),a=T(t=>{o(s=>({...s,...t}))},[]),d=T((t,s)=>{a({[t]:s})},[a]),r=T(t=>{o(t??e)},[e]);return{state:u,setState:a,setField:d,resetState:r}}export{f as useSetState};

package/dist/hooks/use-tabs/index.cjs

@@ -0,0 +1 @@
+"use strict";var r=Object.defineProperty;var i=Object.getOwnPropertyDescriptor;var T=Object.getOwnPropertyNames;var l=Object.prototype.hasOwnProperty;var f=(e,t)=>{for(var s in t)r(e,s,{get:t[s],enumerable:!0})},p=(e,t,s,o)=>{if(t&&typeof t=="object"||typeof t=="function")for(let n of T(t))!l.call(e,n)&&n!==s&&r(e,n,{get:()=>t[n],enumerable:!(o=i(t,n))||o.enumerable});return e};var v=e=>p(r({},"__esModule",{value:!0}),e);var S={};f(S,{useTabs:()=>u});module.exports=v(S);var a=require("react");function u(e=!1){let[t,s]=(0,a.useState)(e),o=(0,a.useCallback)((h,c)=>{s(c)},[]),n=(0,a.useCallback)(()=>{s(e)},[e]);return{value:t,setValue:s,onChange:o,reset:n}}0&&(module.exports={useTabs});

package/dist/hooks/use-tabs/index.d.cts

@@ -0,0 +1,2 @@
+export { UseTabsReturn, useTabs } from './use-tabs.cjs';
+import 'react';

package/dist/hooks/use-tabs/index.d.ts

@@ -0,0 +1,2 @@
+export { UseTabsReturn, useTabs } from './use-tabs.js';
+import 'react';

package/dist/hooks/use-tabs/index.js

@@ -0,0 +1 @@
+import{useCallback as s,useState as c}from"react";function l(e=!1){let[n,t]=c(e),a=s((i,r)=>{t(r)},[]),o=s(()=>{t(e)},[e]);return{value:n,setValue:t,onChange:a,reset:o}}export{l as useTabs};

package/dist/hooks/use-tabs/use-tabs.cjs

@@ -0,0 +1 @@
+"use strict";var c=Object.defineProperty;var i=Object.getOwnPropertyDescriptor;var T=Object.getOwnPropertyNames;var l=Object.prototype.hasOwnProperty;var v=(e,t)=>{for(var s in t)c(e,s,{get:t[s],enumerable:!0})},f=(e,t,s,o)=>{if(t&&typeof t=="object"||typeof t=="function")for(let n of T(t))!l.call(e,n)&&n!==s&&c(e,n,{get:()=>t[n],enumerable:!(o=i(t,n))||o.enumerable});return e};var p=e=>f(c({},"__esModule",{value:!0}),e);var S={};v(S,{useTabs:()=>u});module.exports=p(S);var a=require("react");function u(e=!1){let[t,s]=(0,a.useState)(e),o=(0,a.useCallback)((h,r)=>{s(r)},[]),n=(0,a.useCallback)(()=>{s(e)},[e]);return{value:t,setValue:s,onChange:o,reset:n}}0&&(module.exports={useTabs});

package/dist/hooks/use-tabs/use-tabs.d.cts

@@ -0,0 +1,58 @@
+import { Dispatch, SetStateAction, SyntheticEvent } from 'react';
+
+/**
+ * A custom React hook to manage the state of a tab component.
+ *
+ * @template T - The type of the tab value (e.g., string, number, or custom type).
+ * @param defaultValue - The initial tab value or `false` to indicate no tab is selected. Defaults to `false`.
+ * @returns An object containing the current tab state and methods to manipulate it.
+ *
+ * @remarks
+ * - Use `false` as the tab value to deselect all tabs.
+ * - The `onChange` handler is designed to work with tab components like Material-UI's `Tabs`.
+ * - The hook is memoized for performance and supports dynamic default values.
+ *
+ * @example
+ * ```tsx
+ * // Example: Using string tab values
+ * const { value, onChange, setValue, reset } = useTabs<'tab1' | 'tab2'>('tab1');
+ *
+ * return (
+ *   <Tabs value={value} onChange={onChange}>
+ *     <Tab label="Tab 1" value="tab1" />
+ *     <Tab label="Tab 2" value="tab2" />
+ *   </Tabs>
+ * );
+ *
+ * // Manually select a tab
+ * setValue('tab2');
+ *
+ * // Deselect all tabs
+ * setValue(false);
+ *
+ * // Reset to default value
+ * reset();
+ * ```
+ *
+ * @example
+ * ```tsx
+ * // Example: Using number tab values with no initial selection
+ * const { value, onChange } = useTabs<1 | 2>(false);
+ *
+ * return (
+ *   <Tabs value={value} onChange={onChange}>
+ *     <Tab label="Tab 1" value={1} />
+ *     <Tab label="Tab 2" value={2} />
+ *   </Tabs>
+ * );
+ * ```
+ */
+type UseTabsReturn<T> = {
+    value: T | false;
+    setValue: Dispatch<SetStateAction<T | false>>;
+    onChange: (event: SyntheticEvent, newValue: T | false) => void;
+    reset: () => void;
+};
+declare function useTabs<T>(defaultValue?: T | false): UseTabsReturn<T>;
+
+export { type UseTabsReturn, useTabs };

package/dist/hooks/use-tabs/use-tabs.d.ts

@@ -0,0 +1,58 @@
+import { Dispatch, SetStateAction, SyntheticEvent } from 'react';
+
+/**
+ * A custom React hook to manage the state of a tab component.
+ *
+ * @template T - The type of the tab value (e.g., string, number, or custom type).
+ * @param defaultValue - The initial tab value or `false` to indicate no tab is selected. Defaults to `false`.
+ * @returns An object containing the current tab state and methods to manipulate it.
+ *
+ * @remarks
+ * - Use `false` as the tab value to deselect all tabs.
+ * - The `onChange` handler is designed to work with tab components like Material-UI's `Tabs`.
+ * - The hook is memoized for performance and supports dynamic default values.
+ *
+ * @example
+ * ```tsx
+ * // Example: Using string tab values
+ * const { value, onChange, setValue, reset } = useTabs<'tab1' | 'tab2'>('tab1');
+ *
+ * return (
+ *   <Tabs value={value} onChange={onChange}>
+ *     <Tab label="Tab 1" value="tab1" />
+ *     <Tab label="Tab 2" value="tab2" />
+ *   </Tabs>
+ * );
+ *
+ * // Manually select a tab
+ * setValue('tab2');
+ *
+ * // Deselect all tabs
+ * setValue(false);
+ *
+ * // Reset to default value
+ * reset();
+ * ```
+ *
+ * @example
+ * ```tsx
+ * // Example: Using number tab values with no initial selection
+ * const { value, onChange } = useTabs<1 | 2>(false);
+ *
+ * return (
+ *   <Tabs value={value} onChange={onChange}>
+ *     <Tab label="Tab 1" value={1} />
+ *     <Tab label="Tab 2" value={2} />
+ *   </Tabs>
+ * );
+ * ```
+ */
+type UseTabsReturn<T> = {
+    value: T | false;
+    setValue: Dispatch<SetStateAction<T | false>>;
+    onChange: (event: SyntheticEvent, newValue: T | false) => void;
+    reset: () => void;
+};
+declare function useTabs<T>(defaultValue?: T | false): UseTabsReturn<T>;
+
+export { type UseTabsReturn, useTabs };

package/dist/hooks/use-tabs/use-tabs.js

@@ -0,0 +1 @@
+import{useCallback as s,useState as r}from"react";function l(e=!1){let[n,t]=r(e),a=s((i,c)=>{t(c)},[]),o=s(()=>{t(e)},[e]);return{value:n,setValue:t,onChange:a,reset:o}}export{l as useTabs};