minimal-shared 0.0.5 → 1.0.0

package/dist/hooks/index.d.ts

@@ -16,3 +16,4 @@ export { UseScrollOffsetTopReturn, useScrollOffsetTop } from './use-scroll-offse
 export { UseCountdownSecondsReturn, useCountdownSeconds } from './use-countdown-seconds/use-countdown-seconds.js';
 export { CopiedValue, CopyFn, UseCopyToClipboardReturn, useCopyToClipboard } from './use-copy-to-clipboard/use-copy-to-clipboard.js';
 import 'react';
+import '../utils/cookies/cookies.js';

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

@@ -1 +1,2 @@
 export { UseCookiesOptions, UseCookiesReturn, useCookies } from './use-cookies.js';
+import '../../utils/cookies/cookies.js';

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

@@ -1,11 +1,12 @@
+import { CookieOptions } from '../../utils/cookies/cookies.js';
+
 /**
  * Custom hook to manage state with cookies.
  *
+ * @template T
  * @param {string} key - The key for the cookie.
  * @param {T} initialState - The initial state value.
- * @param {Object} [options] - Optional settings.
- * @param {boolean} [options.initializeWithValue=true] - Whether to initialize the cookie with the initial state value.
- * @param {number} [options.daysUntilExpiration] - Number of days until the cookie expires.
+ * @param {UseCookiesOptions} [options] - Optional settings.
  *
  * @returns {UseCookiesReturn<T>} - An object containing:
  * - `state`: The current state.
@@ -25,9 +26,8 @@
  *   </div>
  * );
  */
-type UseCookiesOptions = {
+type UseCookiesOptions = CookieOptions & {
     initializeWithValue?: boolean;
-    daysUntilExpiration?: number;
 };
 type UseCookiesReturn<T> = {
     state: T;

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

@@ -1 +1 @@
-import{useMemo as h,useState as g,useEffect as x,useCallback as T}from"react";function k(o){try{let e=`${o}=`,n=decodeURIComponent(document.cookie).split("; ");for(let r of n)if(r.startsWith(e)){let s=r.substring(e.length);try{return JSON.parse(s)}catch{return s}}}catch{return null}return null}function l(o,e,i=0){try{let n=encodeURIComponent(JSON.stringify(e)),r=`${o}=${n}; path=/`;if(i>0){let s=new Date(Date.now()+i*24*60*60*1e3);r+=`; expires=${s.toUTCString()}`}document.cookie=r}catch(n){console.error("Error while setting cookie:",n)}}function C(o){try{document.cookie=`${o}=; expires=Thu, 01 Jan 1970 00:00:00 UTC; path=/;`}catch(e){console.error("Error while removing cookie:",e)}}function b(o,e,i){let{initializeWithValue:n=!0,daysUntilExpiration:r}=i??{},s=e&&typeof e=="object",[d,a]=g(e);x(()=>{let t=k(o);t?a(s?c=>({...c,...t}):t):e&&n&&l(o,e,r)},[]);let u=T(t=>{s?a(c=>{let m={...c,...t};return l(o,m,r),m}):(l(o,t,r),a(t))},[s,o,r]),p=T((t,c)=>{s&&u({[t]:c})},[s,u]),f=T(t=>{a(t??e),C(o)},[e,o]);return h(()=>({state:d,setState:u,setField:p,resetState:f}),[f,p,u,d])}export{b as useCookies};
+import{useMemo as g,useState as h,useEffect as y,useCallback as f}from"react";function m(e){if(!e||typeof e!="string")return console.warn("Invalid cookie key provided"),null;try{let o=`${e}=`,t=decodeURIComponent(document.cookie).split("; ").find(d=>d.startsWith(o));if(!t)return null;let r=t.substring(o.length);try{return JSON.parse(r)}catch{return r}}catch(o){return console.error("Error retrieving cookie:",o),null}}function T(e,o,c){if(!e||typeof e!="string"){console.error("Invalid cookie key provided");return}let{daysUntilExpiration:n=0,sameSite:t="Strict",secure:r=!1,path:d="/",domain:s}=c??{};try{let a=encodeURIComponent(typeof o=="string"?o:JSON.stringify(o)),p=[`${e}=${a}`,`path=${d}`,t&&`SameSite=${t}`,r&&"Secure",s&&`domain=${s}`];if(n>0){let l=new Date(Date.now()+n*24*60*60*1e3);p.push(`expires=${l.toUTCString()}`)}document.cookie=p.filter(Boolean).join("; ")}catch(a){console.error("Error setting cookie:",a)}}function C(e,o){if(!e||typeof e!="string"){console.error("Invalid cookie key provided");return}let{path:c="/",domain:n}=o??{};try{let t=[`${e}=`,"expires=Thu, 01 Jan 1970 00:00:00 GMT",`path=${c}`,n&&`domain=${n}`,"Secure"];document.cookie=t.filter(Boolean).join("; ")}catch(t){console.error("Error removing cookie:",t)}}function $(e,o,c){let{initializeWithValue:n=!0,...t}=c??{},r=o&&typeof o=="object",[d,s]=h(o);y(()=>{let i=m(e);i?s(r?u=>({...u,...i}):i):o&&n&&T(e,o,t)},[]);let a=f(i=>{r?s(u=>{let k={...u,...i};return T(e,k,t),k}):(T(e,i,t),s(i))},[t,r,e]),p=f((i,u)=>{r&&a({[i]:u})},[r,a]),l=f(i=>{s(i??o),C(e)},[o,e]);return g(()=>({state:d,setState:a,setField:p,resetState:l}),[l,p,a,d])}export{$ as useCookies};

package/dist/index.d.ts

@@ -4,9 +4,10 @@ export { ChannelPalette, InputPalette, createPaletteChannel, hexToRgbChannel, va
 export { hasKeys } from './utils/object/object.js';
 export { uuidv4 } from './utils/uuidv4/uuidv4.js';
 export { StateProps, mergeClasses } from './utils/classes/classes.js';
-export { getCookie, removeCookie, setCookie } from './utils/cookies/cookies.js';
+export { CookieOptions, getCookie, removeCookie, setCookie } from './utils/cookies/cookies.js';
 export { isActiveLink } from './utils/active-link/active-link.js';
 export { getStorage, localStorageAvailable, removeStorage, setStorage } from './utils/local-storage/local-storage.js';
+export { InputValue, transformNumber, transformValue, transformValueOnBlur, transformValueOnChange } from './utils/transform-number/transform-number.js';
 export { UseTabsReturn, useTabs } from './hooks/use-tabs/use-tabs.js';
 export { UseBooleanReturn, useBoolean } from './hooks/use-boolean/use-boolean.js';
 export { UsePopoverReturn, usePopover } from './hooks/use-popover/use-popover.js';

package/dist/utils/cookies/cookies.d.ts

@@ -1,34 +1,42 @@
+type CookieOptions = {
+    secure?: boolean;
+    daysUntilExpiration?: number;
+    sameSite?: 'Strict' | 'Lax' | 'None';
+    domain?: string;
+    path?: string;
+};
 /**
  * Retrieves a cookie value by key.
  *
  * @param {string} key - The key of the cookie to retrieve.
- * @returns {any | null} - The parsed value of the cookie, or null if not found or an error occurs.
+ * @returns {T | null} - The parsed value of the cookie, or null if not found or an error occurs.
  *
  * @example
- * const user = getCookie('user');
+ * const user = getCookie<{ name: string, age: number }>('user');
  * console.log(user); // { name: 'John', age: 30 }
  */
-declare function getCookie(key: string): any | null;
+declare function getCookie<T>(key: string): T | null;
 /**
- * Sets a cookie with a specified key, value, and expiration time.
+ * Sets a cookie with a specified key, value, and options.
  *
  * @template T
  * @param {string} key - The key of the cookie to set.
  * @param {T} value - The value of the cookie to set.
- * @param {number} [daysUntilExpiration=0] - The number of days until the cookie expires. Defaults to session cookie if not set.
+ * @param {CookieOptions} [options] - The options for the cookie.
  *
  * @example
- * setCookie('user', { name: 'John', age: 30 }, 7);
+ * setCookie('user', { name: 'John', age: 30 }, { daysUntilExpiration: 7, sameSite: 'Lax', secure: true });
  */
-declare function setCookie<T>(key: string, value: T, daysUntilExpiration?: number): void;
+declare function setCookie<T>(key: string, value: T, options?: CookieOptions): void;
 /**
  * Removes a cookie by key.
  *
  * @param {string} key - The key of the cookie to remove.
+ * @param {Pick<CookieOptions, 'path' | 'domain'>} [options] - The options for the cookie removal.
  *
  * @example
  * removeCookie('user');
  */
-declare function removeCookie(key: string): void;
+declare function removeCookie(key: string, options?: Pick<CookieOptions, 'path' | 'domain'>): void;
 
-export { getCookie, removeCookie, setCookie };
+export { type CookieOptions, getCookie, removeCookie, setCookie };

package/dist/utils/cookies/cookies.js

@@ -1 +1 @@
-function i(o){try{let e=`${o}=`,t=decodeURIComponent(document.cookie).split("; ");for(let r of t)if(r.startsWith(e)){let n=r.substring(e.length);try{return JSON.parse(n)}catch{return n}}}catch{return null}return null}function s(o,e,c=0){try{let t=encodeURIComponent(JSON.stringify(e)),r=`${o}=${t}; path=/`;if(c>0){let n=new Date(Date.now()+c*24*60*60*1e3);r+=`; expires=${n.toUTCString()}`}document.cookie=r}catch(t){console.error("Error while setting cookie:",t)}}function u(o){try{document.cookie=`${o}=; expires=Thu, 01 Jan 1970 00:00:00 UTC; path=/;`}catch(e){console.error("Error while removing cookie:",e)}}export{i as getCookie,u as removeCookie,s as setCookie};
+function l(o){if(!o||typeof o!="string")return console.warn("Invalid cookie key provided"),null;try{let e=`${o}=`,r=decodeURIComponent(document.cookie).split("; ").find(c=>c.startsWith(e));if(!r)return null;let n=r.substring(e.length);try{return JSON.parse(n)}catch{return n}}catch(e){return console.error("Error retrieving cookie:",e),null}}function u(o,e,i){if(!o||typeof o!="string"){console.error("Invalid cookie key provided");return}let{daysUntilExpiration:t=0,sameSite:r="Strict",secure:n=!1,path:c="/",domain:a}=i??{};try{let s=encodeURIComponent(typeof e=="string"?e:JSON.stringify(e)),d=[`${o}=${s}`,`path=${c}`,r&&`SameSite=${r}`,n&&"Secure",a&&`domain=${a}`];if(t>0){let p=new Date(Date.now()+t*24*60*60*1e3);d.push(`expires=${p.toUTCString()}`)}document.cookie=d.filter(Boolean).join("; ")}catch(s){console.error("Error setting cookie:",s)}}function k(o,e){if(!o||typeof o!="string"){console.error("Invalid cookie key provided");return}let{path:i="/",domain:t}=e??{};try{let r=[`${o}=`,"expires=Thu, 01 Jan 1970 00:00:00 GMT",`path=${i}`,t&&`domain=${t}`,"Secure"];document.cookie=r.filter(Boolean).join("; ")}catch(r){console.error("Error removing cookie:",r)}}export{l as getCookie,k as removeCookie,u as setCookie};

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

@@ -1 +1 @@
-export { getCookie, removeCookie, setCookie } from './cookies.js';
+export { CookieOptions, getCookie, removeCookie, setCookie } from './cookies.js';

package/dist/utils/index.d.ts

@@ -4,6 +4,7 @@ export { ChannelPalette, InputPalette, createPaletteChannel, hexToRgbChannel, va
 export { hasKeys } from './object/object.js';
 export { uuidv4 } from './uuidv4/uuidv4.js';
 export { StateProps, mergeClasses } from './classes/classes.js';
-export { getCookie, removeCookie, setCookie } from './cookies/cookies.js';
+export { CookieOptions, getCookie, removeCookie, setCookie } from './cookies/cookies.js';
 export { isActiveLink } from './active-link/active-link.js';
 export { getStorage, localStorageAvailable, removeStorage, setStorage } from './local-storage/local-storage.js';
+export { InputValue, transformNumber, transformValue, transformValueOnBlur, transformValueOnChange } from './transform-number/transform-number.js';

package/dist/utils/index.js

@@ -1,17 +1,10 @@
 export * from './url';
-
 export * from './font';
-
 export * from './color';
-
 export * from './object';
-
 export * from './uuidv4';
-
 export * from './classes';
-
 export * from './cookies';
-
 export * from './active-link';
-
 export * from './local-storage';
+export * from './transform-number';

package/dist/utils/transform-number/index.d.ts

@@ -0,0 +1 @@
+export { InputValue, transformNumber, transformValue, transformValueOnBlur, transformValueOnChange } from './transform-number.js';

package/dist/utils/transform-number/index.js

@@ -0,0 +1 @@
+export * from './transform-number';

package/dist/utils/transform-number/transform-number.d.ts

@@ -0,0 +1,31 @@
+type InputValue = string | number | null | undefined;
+/**
+ * Transforms the input value to a string.
+ *
+ * @param {InputValue} value - The value to transform.
+ * @param {string} [defaultValue=''] - The default value to return if the input value is null, undefined, or NaN.
+ * @returns {string} - The transformed string value.
+ */
+declare function transformValue(value: InputValue, defaultValue?: string): string;
+/**
+ * Transforms the output value on change event.
+ *
+ * @param {string | number} value - The value to transform.
+ * @returns {string} - The cleaned and transformed value.
+ */
+declare function transformValueOnChange(value: string | number): string;
+/**
+ * Transforms the output value on blur event.
+ *
+ * @param {InputValue} value - The value to transform.
+ * @param {string | number} [defaultValue=''] - The default value to return if the input value is null, undefined, or NaN.
+ * @returns {string | number} - The transformed numeric value or the default value.
+ */
+declare function transformValueOnBlur(value: InputValue, defaultValue?: string | number): string | number;
+declare const transformNumber: {
+    onChange: typeof transformValueOnChange;
+    onBlur: typeof transformValueOnBlur;
+    value: typeof transformValue;
+};
+
+export { type InputValue, transformNumber, transformValue, transformValueOnBlur, transformValueOnChange };

package/dist/utils/transform-number/transform-number.js

@@ -0,0 +1 @@
+function i(n,r=""){return n==null||typeof n=="number"&&Number.isNaN(n)?r:n.toString()}function o(n){let t=i(n).replace(/[^0-9.]/g,""),[e,...u]=t.split(".");return u.length>0?`${e}.${u.join("")}`:e}function s(n,r=""){if(n==null||typeof n=="number"&&Number.isNaN(n))return r;let t=parseFloat(n.toString());return Number.isNaN(t)?r:t}var a={onChange:o,onBlur:s,value:i};export{a as transformNumber,i as transformValue,s as transformValueOnBlur,o as transformValueOnChange};

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "minimal-shared",
   "author": "Minimals",
-  "version": "0.0.5",
+  "version": "1.0.0",
   "description": "Shared hooks and utils used by Mnimal UI and Zone UI.",
   "keywords": [
     "typescript",
@@ -53,13 +53,13 @@
     }
   },
   "dependencies": {
-    "es-toolkit": "^1.26.1"
+    "es-toolkit": "^1.27.0"
   },
   "devDependencies": {
     "@testing-library/jest-dom": "^6.6.3",
     "@testing-library/react": "^16.0.1",
     "@types/fs-extra": "^11.0.4",
-    "@types/node": "^22.8.6",
+    "@types/node": "^22.10.0",
     "@types/react": "18.3.12",
     "chalk": "^5.3.0",
     "fast-glob": "^3.3.2",
@@ -68,13 +68,13 @@
     "jsdom": "^25.0.1",
     "react": "^18.3.1",
     "tsup": "^8.3.5",
-    "typescript": "^5.5.4",
-    "vitest": "^2.1.4",
+    "typescript": "^5.7.2",
+    "vitest": "^2.1.6",
     "internal-eslint-config": "1.0.0",
     "internal-ts-config": "1.0.0"
   },
   "peerDependencies": {
-    "react": "^17 || ^18"
+    "react": "^18"
   },
   "scripts": {
     "dev": "NODE_OPTIONS='--max-old-space-size=16384' tsup --watch",