@rio-cloud/rio-uikit 2.1.0 → 2.2.0

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@rio-cloud/rio-uikit",
-    "version": "2.1.0",
+    "version": "2.2.0",
     "description": "The RIO UIKIT component library",
     "repository": {
         "type": "git",
@@ -46,12 +46,12 @@
         }
     },
     "devDependencies": {
-        "@biomejs/biome": "2.3.10",
+        "@biomejs/biome": "2.4.2",
         "@rio-cloud/biome-config": "1.1.0",
-        "@rio-cloud/vite-plugin-frontend-license-check": "1.1.1",
+        "@rio-cloud/vite-plugin-frontend-license-check": "1.2.0",
         "@testing-library/dom": "10.4.1",
         "@testing-library/jest-dom": "6.9.1",
-        "@testing-library/react": "16.3.1",
+        "@testing-library/react": "16.3.2",
         "@testing-library/user-event": "14.6.1",
         "@types/heremaps": "3.1.14",
         "@types/node": "24.10.1",
@@ -59,14 +59,14 @@
         "@types/react-dom": "18.3.5",
         "@types/react-redux": "7.1.34",
         "@types/resize-observer-browser": "0.1.11",
-        "@vitejs/plugin-react": "5.1.2",
+        "@vitejs/plugin-react": "5.1.4",
         "@vitest/coverage-c8": "0.33.0",
-        "autoprefixer": "10.4.23",
+        "autoprefixer": "10.4.24",
         "backstopjs": "6.3.25",
         "copyfiles": "2.4.1",
-        "dotenv": "17.2.3",
-        "glob": "13.0.0",
-        "happy-dom": "20.0.11",
+        "dotenv": "17.3.1",
+        "glob": "13.0.5",
+        "happy-dom": "20.6.3",
         "jsdom": "27.4.0",
         "jsdom-global": "3.0.2",
         "postcss": "8.5.6",
@@ -77,11 +77,11 @@
         "react-dom": "18.0.0",
         "react-intl": "7.1.14",
         "rollup-plugin-copy": "3.5.0",
-        "sass": "1.97.1",
+        "sass": "1.97.3",
         "strip-ansi": "7.1.2",
         "svgo": "4.0.0",
         "typescript": "5.9.3",
-        "vite": "7.3.0",
+        "vite": "7.3.1",
         "vite-plugin-dts": "4.5.4",
         "vite-plugin-zip-pack": "1.2.4",
         "vitest": "3.2.4",
@@ -98,30 +98,29 @@
         "@dnd-kit/utilities": "3.2.2",
         "@formkit/auto-animate": "0.9.0",
         "@popperjs/core": "2.11.8",
-        "@tanstack/react-virtual": "3.13.14",
-        "classnames": "2.5.1",
+        "@tanstack/react-virtual": "3.13.18",
         "date-fns": "4.1.0",
         "driver.js": "1.4.0",
-        "es-toolkit": "1.43.0",
+        "es-toolkit": "1.44.0",
         "events": "3.3.0",
         "iframe-resizer-react": "1.1.0",
         "moment": "2.30.1",
-        "motion": "12.23.26",
+        "motion": "12.34.2",
         "natural-orderby": "5.0.0",
         "process": "0.11.10",
         "prop-types": "15.8.1",
         "react-bootstrap": "1.6.4",
-        "react-content-loader": "7.1.1",
+        "react-content-loader": "7.1.2",
         "react-custom-scrollbars-4": "4.5.1",
         "react-datetime": "github:rio-cloud/react-datetime#v3.1.1-1-merged",
-        "react-day-picker": "9.13.0",
+        "react-day-picker": "9.13.2",
         "react-dropzone": "14.3.8",
         "react-imask": "7.6.1",
         "react-notifications": "1.7.4",
         "react-onclickoutside": "6.13.2",
         "react-popper": "2.3.0",
         "react-toastify": "11.0.5",
-        "recharts": "3.6.0",
+        "recharts": "3.7.0",
         "tiny-invariant": "1.3.3",
         "tslib": "2.8.1"
     },

package/routeUtils.js

@@ -1,8 +1,14 @@
-import { getSortDirShort as o, mapColumnsSettingsToStrings as s, parseColumnsSettingsStrings as n, parseSorting as S } from "./utils/routeUtils.js";
+import { deserializeValue as i, getSortDirShort as t, mapColumnsSettingsToStrings as o, parseColumnsSettingsStrings as s, parseSorting as a, serializeSorting as n, serializeValue as S, toQueryString as g } from "./utils/routeUtils.js";
+import { isEqual as u } from "es-toolkit";
 export {
-  o as getSortDirShort,
-  s as mapColumnsSettingsToStrings,
-  n as parseColumnsSettingsStrings,
-  S as parseSorting
+  i as deserializeValue,
+  t as getSortDirShort,
+  u as isEqual,
+  o as mapColumnsSettingsToStrings,
+  s as parseColumnsSettingsStrings,
+  a as parseSorting,
+  n as serializeSorting,
+  S as serializeValue,
+  g as toQueryString
 };
 //# sourceMappingURL=routeUtils.js.map

package/routeUtils.js.map

@@ -1 +1 @@
-{"version":3,"file":"routeUtils.js","sources":[],"sourcesContent":[],"names":[],"mappings":";"}
+{"version":3,"file":"routeUtils.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;"}

package/themes/Volkswagen/components/applicationHeader/VolkswagenApplicationHeader.js

@@ -1,7 +1,7 @@
 import { jsx as a, jsxs as p } from "react/jsx-runtime";
 import { forwardRef as d } from "react";
 import { isEmpty as i } from "es-toolkit/compat";
-import u from "classnames";
+import u from "../../../../utils/classNames.js";
 import N from "../../../../components/applicationHeader/ApplicationActionBar.js";
 const H = d(
   (r, n) => {

package/themes/Volkswagen/components/applicationHeader/VolkswagenApplicationHeader.js.map

@@ -1 +1 @@
-{"version":3,"file":"VolkswagenApplicationHeader.js","sources":["../../../../../src/themes/Volkswagen/components/applicationHeader/VolkswagenApplicationHeader.tsx"],"sourcesContent":["import React, { forwardRef, type ForwardedRef } from 'react';\nimport { isEmpty } from 'es-toolkit/compat';\nimport classNames from 'classnames';\n\nimport ApplicationActionBar from '../../../../components/applicationHeader/ApplicationActionBar';\nimport type { ApplicationHeaderProps } from '../../../../ApplicationHeader';\n\nexport type ModuleProps = {\n    key: string;\n    route: React.ReactNode;\n};\n\nexport type VolkswagenApplicationHeaderProps = ApplicationHeaderProps & {\n    homeRoute?: React.ReactNode;\n    appMenuItems?: ModuleProps[];\n    appNavigator?: React.ReactNode;\n    appNavigatorClassName?: string;\n    navItems?: ModuleProps[];\n    actionBarItems?: React.ReactNode[];\n    onMount?: VoidFunction;\n    onUnmount?: VoidFunction;\n    className?: string;\n};\n\nexport const VolkswagenApplicationHeader = forwardRef(\n    (props: VolkswagenApplicationHeaderProps, ref: ForwardedRef<HTMLElement>) => {\n        const {\n            homeRoute = '',\n            appNavigator,\n            appNavigatorClassName,\n            appMenuItems,\n            navItems = [],\n            actionBarItems = [],\n            onMount = () => {},\n            onUnmount = () => {},\n            className = '',\n            ...remainingProps\n        } = props;\n\n        const wrapperClassNames = classNames(\n            'ApplicationHeader VolkswagenApplicationHeader',\n            'user-select-none',\n            className && className\n        );\n\n        return (\n            <nav {...remainingProps} className={wrapperClassNames} ref={ref}>\n                <div className='width-100pct'>\n                    <div className='brand'>\n                        <div className='logo'>{homeRoute}</div>\n                    </div>\n                    {isEmpty(navItems) && <ul className='SubmoduleNavigation nav' />}\n                    {!isEmpty(navItems) && (\n                        <ul className='SubmoduleNavigation nav'>\n                            {navItems.map(navItem => (\n                                <li key={navItem.key} className='submodule' data-nav-item-key={navItem.key}>\n                                    {navItem.route}\n                                </li>\n                            ))}\n                        </ul>\n                    )}\n                    <ApplicationActionBar items={actionBarItems} />\n                </div>\n            </nav>\n        );\n    }\n);\n\nexport default VolkswagenApplicationHeader;\n"],"names":["VolkswagenApplicationHeader","forwardRef","props","ref","homeRoute","appNavigator","appNavigatorClassName","appMenuItems","navItems","actionBarItems","onMount","onUnmount","className","remainingProps","wrapperClassNames","classNames","jsx","jsxs","isEmpty","navItem","ApplicationActionBar"],"mappings":";;;;;AAwBO,MAAMA,IAA8BC;AAAA,EACvC,CAACC,GAAyCC,MAAmC;AACzE,UAAM;AAAA,MACF,WAAAC,IAAY;AAAA,MACZ,cAAAC;AAAA,MACA,uBAAAC;AAAA,MACA,cAAAC;AAAA,MACA,UAAAC,IAAW,CAAA;AAAA,MACX,gBAAAC,IAAiB,CAAA;AAAA,MACjB,SAAAC,IAAU,MAAM;AAAA,MAAC;AAAA,MACjB,WAAAC,IAAY,MAAM;AAAA,MAAC;AAAA,MACnB,WAAAC,IAAY;AAAA,MACZ,GAAGC;AAAA,IAAA,IACHX,GAEEY,IAAoBC;AAAA,MACtB;AAAA,MACA;AAAA,MACAH,KAAaA;AAAA,IAAA;AAGjB,WACI,gBAAAI,EAAC,OAAA,EAAK,GAAGH,GAAgB,WAAWC,GAAmB,KAAAX,GACnD,UAAA,gBAAAc,EAAC,OAAA,EAAI,WAAU,gBACX,UAAA;AAAA,MAAA,gBAAAD,EAAC,OAAA,EAAI,WAAU,SACX,UAAA,gBAAAA,EAAC,SAAI,WAAU,QAAQ,aAAU,EAAA,CACrC;AAAA,MACCE,EAAQV,CAAQ,KAAK,gBAAAQ,EAAC,MAAA,EAAG,WAAU,2BAA0B;AAAA,MAC7D,CAACE,EAAQV,CAAQ,uBACb,MAAA,EAAG,WAAU,2BACT,UAAAA,EAAS,IAAI,CAAAW,wBACT,MAAA,EAAqB,WAAU,aAAY,qBAAmBA,EAAQ,KAClE,YAAQ,MAAA,GADJA,EAAQ,GAEjB,CACH,EAAA,CACL;AAAA,MAEJ,gBAAAH,EAACI,GAAA,EAAqB,OAAOX,EAAA,CAAgB;AAAA,IAAA,EAAA,CACjD,EAAA,CACJ;AAAA,EAER;AACJ;"}
+{"version":3,"file":"VolkswagenApplicationHeader.js","sources":["../../../../../src/themes/Volkswagen/components/applicationHeader/VolkswagenApplicationHeader.tsx"],"sourcesContent":["import React, { forwardRef, type ForwardedRef } from 'react';\nimport { isEmpty } from 'es-toolkit/compat';\n\nimport classNames from '../../../../utils/classNames';\nimport ApplicationActionBar from '../../../../components/applicationHeader/ApplicationActionBar';\nimport type { ApplicationHeaderProps } from '../../../../ApplicationHeader';\n\nexport type ModuleProps = {\n    key: string;\n    route: React.ReactNode;\n};\n\nexport type VolkswagenApplicationHeaderProps = ApplicationHeaderProps & {\n    homeRoute?: React.ReactNode;\n    appMenuItems?: ModuleProps[];\n    appNavigator?: React.ReactNode;\n    appNavigatorClassName?: string;\n    navItems?: ModuleProps[];\n    actionBarItems?: React.ReactNode[];\n    onMount?: VoidFunction;\n    onUnmount?: VoidFunction;\n    className?: string;\n};\n\nexport const VolkswagenApplicationHeader = forwardRef(\n    (props: VolkswagenApplicationHeaderProps, ref: ForwardedRef<HTMLElement>) => {\n        const {\n            homeRoute = '',\n            appNavigator,\n            appNavigatorClassName,\n            appMenuItems,\n            navItems = [],\n            actionBarItems = [],\n            onMount = () => {},\n            onUnmount = () => {},\n            className = '',\n            ...remainingProps\n        } = props;\n\n        const wrapperClassNames = classNames(\n            'ApplicationHeader VolkswagenApplicationHeader',\n            'user-select-none',\n            className && className\n        );\n\n        return (\n            <nav {...remainingProps} className={wrapperClassNames} ref={ref}>\n                <div className='width-100pct'>\n                    <div className='brand'>\n                        <div className='logo'>{homeRoute}</div>\n                    </div>\n                    {isEmpty(navItems) && <ul className='SubmoduleNavigation nav' />}\n                    {!isEmpty(navItems) && (\n                        <ul className='SubmoduleNavigation nav'>\n                            {navItems.map(navItem => (\n                                <li key={navItem.key} className='submodule' data-nav-item-key={navItem.key}>\n                                    {navItem.route}\n                                </li>\n                            ))}\n                        </ul>\n                    )}\n                    <ApplicationActionBar items={actionBarItems} />\n                </div>\n            </nav>\n        );\n    }\n);\n\nexport default VolkswagenApplicationHeader;\n"],"names":["VolkswagenApplicationHeader","forwardRef","props","ref","homeRoute","appNavigator","appNavigatorClassName","appMenuItems","navItems","actionBarItems","onMount","onUnmount","className","remainingProps","wrapperClassNames","classNames","jsx","jsxs","isEmpty","navItem","ApplicationActionBar"],"mappings":";;;;;AAwBO,MAAMA,IAA8BC;AAAA,EACvC,CAACC,GAAyCC,MAAmC;AACzE,UAAM;AAAA,MACF,WAAAC,IAAY;AAAA,MACZ,cAAAC;AAAA,MACA,uBAAAC;AAAA,MACA,cAAAC;AAAA,MACA,UAAAC,IAAW,CAAA;AAAA,MACX,gBAAAC,IAAiB,CAAA;AAAA,MACjB,SAAAC,IAAU,MAAM;AAAA,MAAC;AAAA,MACjB,WAAAC,IAAY,MAAM;AAAA,MAAC;AAAA,MACnB,WAAAC,IAAY;AAAA,MACZ,GAAGC;AAAA,IAAA,IACHX,GAEEY,IAAoBC;AAAA,MACtB;AAAA,MACA;AAAA,MACAH,KAAaA;AAAA,IAAA;AAGjB,WACI,gBAAAI,EAAC,OAAA,EAAK,GAAGH,GAAgB,WAAWC,GAAmB,KAAAX,GACnD,UAAA,gBAAAc,EAAC,OAAA,EAAI,WAAU,gBACX,UAAA;AAAA,MAAA,gBAAAD,EAAC,OAAA,EAAI,WAAU,SACX,UAAA,gBAAAA,EAAC,SAAI,WAAU,QAAQ,aAAU,EAAA,CACrC;AAAA,MACCE,EAAQV,CAAQ,KAAK,gBAAAQ,EAAC,MAAA,EAAG,WAAU,2BAA0B;AAAA,MAC7D,CAACE,EAAQV,CAAQ,uBACb,MAAA,EAAG,WAAU,2BACT,UAAAA,EAAS,IAAI,CAAAW,wBACT,MAAA,EAAqB,WAAU,aAAY,qBAAmBA,EAAQ,KAClE,YAAQ,MAAA,GADJA,EAAQ,GAEjB,CACH,EAAA,CACL;AAAA,MAEJ,gBAAAH,EAACI,GAAA,EAAqB,OAAOX,EAAA,CAAgB;AAAA,IAAA,EAAA,CACjD,EAAA,CACJ;AAAA,EAER;AACJ;"}

package/useCookies.d.ts

@@ -0,0 +1,2 @@
+export { default } from './hooks/useCookies';
+export * from './hooks/useCookies';

package/useCookies.js

@@ -0,0 +1,5 @@
+import { default as o } from "./hooks/useCookies.js";
+export {
+  o as default
+};
+//# sourceMappingURL=useCookies.js.map

package/useCookies.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useCookies.js","sources":[],"sourcesContent":[],"names":[],"mappings":";"}

package/useRioCookieConsent.d.ts

@@ -0,0 +1,2 @@
+export { default } from './hooks/useRioCookieConsent';
+export * from './hooks/useRioCookieConsent';

package/useRioCookieConsent.js

@@ -0,0 +1,5 @@
+import { default as o } from "./hooks/useRioCookieConsent.js";
+export {
+  o as default
+};
+//# sourceMappingURL=useRioCookieConsent.js.map

package/useRioCookieConsent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useRioCookieConsent.js","sources":[],"sourcesContent":[],"names":[],"mappings":";"}

package/useSearchHighlight.d.ts

@@ -0,0 +1,2 @@
+export { default } from './hooks/useSearchHighlight';
+export * from './hooks/useSearchHighlight';

package/useSearchHighlight.js

@@ -0,0 +1,6 @@
+import { SEARCH_HIGHLIGHT_CLASS as e, default as f } from "./hooks/useSearchHighlight.js";
+export {
+  e as SEARCH_HIGHLIGHT_CLASS,
+  f as default
+};
+//# sourceMappingURL=useSearchHighlight.js.map

package/useSearchHighlight.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useSearchHighlight.js","sources":[],"sourcesContent":[],"names":[],"mappings":";"}

package/useUrlState.d.ts

@@ -0,0 +1,2 @@
+export { default } from './hooks/useUrlState';
+export * from './hooks/useUrlState';

package/useUrlState.js

@@ -0,0 +1,5 @@
+import { default as o } from "./hooks/useUrlState.js";
+export {
+  o as default
+};
+//# sourceMappingURL=useUrlState.js.map

package/useUrlState.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useUrlState.js","sources":[],"sourcesContent":[],"names":[],"mappings":";"}

package/utils/classNames.d.ts

@@ -0,0 +1,3 @@
+export type ClassNamePart = string | undefined | null | false | 0 | '';
+declare const classNames: (...parts: ClassNamePart[]) => string;
+export default classNames;

package/utils/classNames.js

@@ -0,0 +1,5 @@
+const e = (...a) => a.filter(Boolean).join(" ");
+export {
+  e as default
+};
+//# sourceMappingURL=classNames.js.map

package/utils/classNames.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"classNames.js","sources":["../../src/utils/classNames.ts"],"sourcesContent":["export type ClassNamePart = string | undefined | null | false | 0 | '';\n\nconst classNames = (...parts: ClassNamePart[]) => parts.filter(Boolean).join(' ');\n\nexport default classNames;\n"],"names":["classNames","parts"],"mappings":"AAEA,MAAMA,IAAa,IAAIC,MAA2BA,EAAM,OAAO,OAAO,EAAE,KAAK,GAAG;"}

package/utils/mergeClassNameOverrides.d.ts

@@ -0,0 +1 @@
+export declare const mergeClassNameOverrides: (defaultClasses: string, overrides?: string) => string;

package/utils/mergeClassNameOverrides.js

@@ -0,0 +1,55 @@
+const g = (t) => t.split(" ").map((n) => n.trim()).filter(Boolean), a = (t, n, e) => ({
+  kind: t,
+  axis: n,
+  value: e
+}), h = (t) => {
+  const n = t.match(/^(margin|padding)(?:-(x|y|top|right|bottom|left))?-(.+)$/);
+  if (!n)
+    return null;
+  const e = n[1], f = n[2] ?? "all", u = n[3];
+  return { kind: e, axis: f, value: u };
+}, $ = ({ kind: t, axis: n, value: e }) => n === "all" ? `${t}-${e}` : `${t}-${n}-${e}`, y = (t, n) => n === "all" || t === "all" || t === n || t === "x" && (n === "left" || n === "right") || t === "y" && (n === "top" || n === "bottom") || n === "x" && (t === "left" || t === "right") || n === "y" && (t === "top" || t === "bottom"), m = (t) => {
+  if (t.startsWith("margin-")) {
+    const [n, e] = t.split("-");
+    return e === "x" || e === "y" || e === "top" || e === "right" || e === "bottom" || e === "left" ? `${n}-${e}` : n;
+  }
+  if (t.startsWith("padding-")) {
+    const [n, e] = t.split("-");
+    return e === "x" || e === "y" || e === "top" || e === "right" || e === "bottom" || e === "left" ? `${n}-${e}` : n;
+  }
+  return t.startsWith("text-size-") ? "text-size" : t.startsWith("text-color-") ? "text-color" : t.startsWith("bg-") ? "bg" : t === "rounded" || t.startsWith("rounded-") ? "rounded" : t === "border" || t.startsWith("border-") ? "border" : t;
+}, k = (t, n) => {
+  if (!n || n.trim() === "")
+    return t;
+  const e = g(n), f = new Set(e.map((r) => m(r))), u = e.map(h).filter(Boolean), c = {
+    margin: u.filter((r) => r.kind === "margin").map((r) => r.axis),
+    padding: u.filter((r) => r.kind === "padding").map((r) => r.axis)
+  }, b = g(t), l = [], p = b.filter((r) => {
+    const i = h(r);
+    return i ? c[i.kind].some((S) => y(i.axis, S)) ? (l.push(i), !1) : !0 : !f.has(m(r));
+  }), x = l.filter((r) => r.axis === "x" || r.axis === "y").flatMap((r) => {
+    const i = c[r.kind];
+    if (i.includes("all") || i.includes(r.axis))
+      return [];
+    if (r.axis === "x") {
+      const o = i.includes("left"), s = i.includes("right");
+      if (o && !s)
+        return [a(r.kind, "right", r.value)];
+      if (s && !o)
+        return [a(r.kind, "left", r.value)];
+    }
+    if (r.axis === "y") {
+      const o = i.includes("top"), s = i.includes("bottom");
+      if (o && !s)
+        return [a(r.kind, "bottom", r.value)];
+      if (s && !o)
+        return [a(r.kind, "top", r.value)];
+    }
+    return [];
+  }).map($), d = /* @__PURE__ */ new Set([...p, ...e]), T = x.filter((r) => d.has(r) ? !1 : (d.add(r), !0));
+  return [...p, ...T, ...e].join(" ");
+};
+export {
+  k as mergeClassNameOverrides
+};
+//# sourceMappingURL=mergeClassNameOverrides.js.map

package/utils/mergeClassNameOverrides.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mergeClassNameOverrides.js","sources":["../../src/utils/mergeClassNameOverrides.ts"],"sourcesContent":["const splitClasses = (value: string): string[] =>\n    value\n        .split(' ')\n        .map(className => className.trim())\n        .filter(Boolean);\n\ntype SpacingKind = 'margin' | 'padding';\ntype SpacingAxis = 'all' | 'x' | 'y' | 'top' | 'right' | 'bottom' | 'left';\n\ntype SpacingToken = {\n    kind: SpacingKind;\n    axis: SpacingAxis;\n    value: string;\n};\n\nconst createSpacingToken = (kind: SpacingKind, axis: SpacingAxis, value: string): SpacingToken => ({\n    kind,\n    axis,\n    value,\n});\n\nconst parseSpacingToken = (className: string): SpacingToken | null => {\n    const matches = className.match(/^(margin|padding)(?:-(x|y|top|right|bottom|left))?-(.+)$/);\n    if (!matches) {\n        return null;\n    }\n\n    const kind = matches[1] as SpacingKind;\n    const axis = (matches[2] as Exclude<SpacingAxis, 'all'> | undefined) ?? 'all';\n    const value = matches[3];\n\n    return { kind, axis, value };\n};\n\nconst spacingTokenToClassName = ({ kind, axis, value }: SpacingToken): string =>\n    axis === 'all' ? `${kind}-${value}` : `${kind}-${axis}-${value}`;\n\nconst overrideAffectsSpacingAxis = (defaultAxis: SpacingAxis, overrideAxis: SpacingAxis): boolean => {\n    if (overrideAxis === 'all') {\n        return true;\n    }\n\n    if (defaultAxis === 'all') {\n        return true;\n    }\n\n    if (defaultAxis === overrideAxis) {\n        return true;\n    }\n\n    if (defaultAxis === 'x' && (overrideAxis === 'left' || overrideAxis === 'right')) {\n        return true;\n    }\n\n    if (defaultAxis === 'y' && (overrideAxis === 'top' || overrideAxis === 'bottom')) {\n        return true;\n    }\n\n    if (overrideAxis === 'x' && (defaultAxis === 'left' || defaultAxis === 'right')) {\n        return true;\n    }\n\n    if (overrideAxis === 'y' && (defaultAxis === 'top' || defaultAxis === 'bottom')) {\n        return true;\n    }\n\n    return false;\n};\n\nconst getUtilityClassBase = (className: string): string => {\n    if (className.startsWith('margin-')) {\n        const [prefix, axis] = className.split('-');\n        if (\n            axis === 'x' ||\n            axis === 'y' ||\n            axis === 'top' ||\n            axis === 'right' ||\n            axis === 'bottom' ||\n            axis === 'left'\n        ) {\n            return `${prefix}-${axis}`;\n        }\n        return prefix;\n    }\n\n    if (className.startsWith('padding-')) {\n        const [prefix, axis] = className.split('-');\n        if (\n            axis === 'x' ||\n            axis === 'y' ||\n            axis === 'top' ||\n            axis === 'right' ||\n            axis === 'bottom' ||\n            axis === 'left'\n        ) {\n            return `${prefix}-${axis}`;\n        }\n        return prefix;\n    }\n\n    if (className.startsWith('text-size-')) {\n        return 'text-size';\n    }\n\n    if (className.startsWith('text-color-')) {\n        return 'text-color';\n    }\n\n    if (className.startsWith('bg-')) {\n        return 'bg';\n    }\n\n    if (className === 'rounded' || className.startsWith('rounded-')) {\n        return 'rounded';\n    }\n\n    if (className === 'border' || className.startsWith('border-')) {\n        return 'border';\n    }\n\n    return className;\n};\n\nexport const mergeClassNameOverrides = (defaultClasses: string, overrides?: string): string => {\n    if (!overrides || overrides.trim() === '') {\n        return defaultClasses;\n    }\n\n    const overrideTokens = splitClasses(overrides);\n    const overrideBases = new Set(overrideTokens.map(token => getUtilityClassBase(token)));\n    const overrideSpacingTokens = overrideTokens.map(parseSpacingToken).filter(Boolean) as SpacingToken[];\n    const overrideSpacingByKind = {\n        margin: overrideSpacingTokens.filter(token => token.kind === 'margin').map(token => token.axis),\n        padding: overrideSpacingTokens.filter(token => token.kind === 'padding').map(token => token.axis),\n    } as const;\n\n    const defaultTokens = splitClasses(defaultClasses);\n    const removedDefaultSpacingTokens: SpacingToken[] = [];\n    const filteredDefaults = defaultTokens.filter(token => {\n        const defaultSpacingToken = parseSpacingToken(token);\n        if (defaultSpacingToken) {\n            const overrideAxes = overrideSpacingByKind[defaultSpacingToken.kind];\n            const isOverridden = overrideAxes.some(axis => overrideAffectsSpacingAxis(defaultSpacingToken.axis, axis));\n            if (isOverridden) {\n                removedDefaultSpacingTokens.push(defaultSpacingToken);\n                return false;\n            }\n            return true;\n        }\n\n        return !overrideBases.has(getUtilityClassBase(token));\n    });\n\n    const fallbackSpacingTokens = removedDefaultSpacingTokens\n        .filter(token => token.axis === 'x' || token.axis === 'y')\n        .flatMap<SpacingToken>(token => {\n            const overrideAxes = overrideSpacingByKind[token.kind];\n            if (overrideAxes.includes('all') || overrideAxes.includes(token.axis)) {\n                return [];\n            }\n\n            if (token.axis === 'x') {\n                const hasLeft = overrideAxes.includes('left');\n                const hasRight = overrideAxes.includes('right');\n\n                if (hasLeft && !hasRight) {\n                    return [createSpacingToken(token.kind, 'right', token.value)];\n                }\n\n                if (hasRight && !hasLeft) {\n                    return [createSpacingToken(token.kind, 'left', token.value)];\n                }\n            }\n\n            if (token.axis === 'y') {\n                const hasTop = overrideAxes.includes('top');\n                const hasBottom = overrideAxes.includes('bottom');\n\n                if (hasTop && !hasBottom) {\n                    return [createSpacingToken(token.kind, 'bottom', token.value)];\n                }\n\n                if (hasBottom && !hasTop) {\n                    return [createSpacingToken(token.kind, 'top', token.value)];\n                }\n            }\n\n            return [];\n        })\n        .map(spacingTokenToClassName);\n\n    const seenTokens = new Set([...filteredDefaults, ...overrideTokens]);\n    const uniqueFallbackSpacingTokens = fallbackSpacingTokens.filter(token => {\n        if (seenTokens.has(token)) {\n            return false;\n        }\n        seenTokens.add(token);\n        return true;\n    });\n\n    return [...filteredDefaults, ...uniqueFallbackSpacingTokens, ...overrideTokens].join(' ');\n};\n"],"names":["splitClasses","value","className","createSpacingToken","kind","axis","parseSpacingToken","matches","spacingTokenToClassName","overrideAffectsSpacingAxis","defaultAxis","overrideAxis","getUtilityClassBase","prefix","mergeClassNameOverrides","defaultClasses","overrides","overrideTokens","overrideBases","token","overrideSpacingTokens","overrideSpacingByKind","defaultTokens","removedDefaultSpacingTokens","filteredDefaults","defaultSpacingToken","fallbackSpacingTokens","overrideAxes","hasLeft","hasRight","hasTop","hasBottom","seenTokens","uniqueFallbackSpacingTokens"],"mappings":"AAAA,MAAMA,IAAe,CAACC,MAClBA,EACK,MAAM,GAAG,EACT,IAAI,CAAAC,MAAaA,EAAU,KAAA,CAAM,EACjC,OAAO,OAAO,GAWjBC,IAAqB,CAACC,GAAmBC,GAAmBJ,OAAiC;AAAA,EAC/F,MAAAG;AAAA,EACA,MAAAC;AAAA,EACA,OAAAJ;AACJ,IAEMK,IAAoB,CAACJ,MAA2C;AAClE,QAAMK,IAAUL,EAAU,MAAM,0DAA0D;AAC1F,MAAI,CAACK;AACD,WAAO;AAGX,QAAMH,IAAOG,EAAQ,CAAC,GAChBF,IAAQE,EAAQ,CAAC,KAAiD,OAClEN,IAAQM,EAAQ,CAAC;AAEvB,SAAO,EAAE,MAAAH,GAAM,MAAAC,GAAM,OAAAJ,EAAA;AACzB,GAEMO,IAA0B,CAAC,EAAE,MAAAJ,GAAM,MAAAC,GAAM,OAAAJ,EAAA,MAC3CI,MAAS,QAAQ,GAAGD,CAAI,IAAIH,CAAK,KAAK,GAAGG,CAAI,IAAIC,CAAI,IAAIJ,CAAK,IAE5DQ,IAA6B,CAACC,GAA0BC,MACtDA,MAAiB,SAIjBD,MAAgB,SAIhBA,MAAgBC,KAIhBD,MAAgB,QAAQC,MAAiB,UAAUA,MAAiB,YAIpED,MAAgB,QAAQC,MAAiB,SAASA,MAAiB,aAInEA,MAAiB,QAAQD,MAAgB,UAAUA,MAAgB,YAInEC,MAAiB,QAAQD,MAAgB,SAASA,MAAgB,WAOpEE,IAAsB,CAACV,MAA8B;AACvD,MAAIA,EAAU,WAAW,SAAS,GAAG;AACjC,UAAM,CAACW,GAAQR,CAAI,IAAIH,EAAU,MAAM,GAAG;AAC1C,WACIG,MAAS,OACTA,MAAS,OACTA,MAAS,SACTA,MAAS,WACTA,MAAS,YACTA,MAAS,SAEF,GAAGQ,CAAM,IAAIR,CAAI,KAErBQ;AAAA,EACX;AAEA,MAAIX,EAAU,WAAW,UAAU,GAAG;AAClC,UAAM,CAACW,GAAQR,CAAI,IAAIH,EAAU,MAAM,GAAG;AAC1C,WACIG,MAAS,OACTA,MAAS,OACTA,MAAS,SACTA,MAAS,WACTA,MAAS,YACTA,MAAS,SAEF,GAAGQ,CAAM,IAAIR,CAAI,KAErBQ;AAAA,EACX;AAEA,SAAIX,EAAU,WAAW,YAAY,IAC1B,cAGPA,EAAU,WAAW,aAAa,IAC3B,eAGPA,EAAU,WAAW,KAAK,IACnB,OAGPA,MAAc,aAAaA,EAAU,WAAW,UAAU,IACnD,YAGPA,MAAc,YAAYA,EAAU,WAAW,SAAS,IACjD,WAGJA;AACX,GAEaY,IAA0B,CAACC,GAAwBC,MAA+B;AAC3F,MAAI,CAACA,KAAaA,EAAU,KAAA,MAAW;AACnC,WAAOD;AAGX,QAAME,IAAiBjB,EAAagB,CAAS,GACvCE,IAAgB,IAAI,IAAID,EAAe,IAAI,CAAAE,MAASP,EAAoBO,CAAK,CAAC,CAAC,GAC/EC,IAAwBH,EAAe,IAAIX,CAAiB,EAAE,OAAO,OAAO,GAC5Ee,IAAwB;AAAA,IAC1B,QAAQD,EAAsB,OAAO,CAAAD,MAASA,EAAM,SAAS,QAAQ,EAAE,IAAI,CAAAA,MAASA,EAAM,IAAI;AAAA,IAC9F,SAASC,EAAsB,OAAO,CAAAD,MAASA,EAAM,SAAS,SAAS,EAAE,IAAI,CAAAA,MAASA,EAAM,IAAI;AAAA,EAAA,GAG9FG,IAAgBtB,EAAae,CAAc,GAC3CQ,IAA8C,CAAA,GAC9CC,IAAmBF,EAAc,OAAO,CAAAH,MAAS;AACnD,UAAMM,IAAsBnB,EAAkBa,CAAK;AACnD,WAAIM,IACqBJ,EAAsBI,EAAoB,IAAI,EACjC,KAAK,CAAApB,MAAQI,EAA2BgB,EAAoB,MAAMpB,CAAI,CAAC,KAErGkB,EAA4B,KAAKE,CAAmB,GAC7C,MAEJ,KAGJ,CAACP,EAAc,IAAIN,EAAoBO,CAAK,CAAC;AAAA,EACxD,CAAC,GAEKO,IAAwBH,EACzB,OAAO,CAAAJ,MAASA,EAAM,SAAS,OAAOA,EAAM,SAAS,GAAG,EACxD,QAAsB,CAAAA,MAAS;AAC5B,UAAMQ,IAAeN,EAAsBF,EAAM,IAAI;AACrD,QAAIQ,EAAa,SAAS,KAAK,KAAKA,EAAa,SAASR,EAAM,IAAI;AAChE,aAAO,CAAA;AAGX,QAAIA,EAAM,SAAS,KAAK;AACpB,YAAMS,IAAUD,EAAa,SAAS,MAAM,GACtCE,IAAWF,EAAa,SAAS,OAAO;AAE9C,UAAIC,KAAW,CAACC;AACZ,eAAO,CAAC1B,EAAmBgB,EAAM,MAAM,SAASA,EAAM,KAAK,CAAC;AAGhE,UAAIU,KAAY,CAACD;AACb,eAAO,CAACzB,EAAmBgB,EAAM,MAAM,QAAQA,EAAM,KAAK,CAAC;AAAA,IAEnE;AAEA,QAAIA,EAAM,SAAS,KAAK;AACpB,YAAMW,IAASH,EAAa,SAAS,KAAK,GACpCI,IAAYJ,EAAa,SAAS,QAAQ;AAEhD,UAAIG,KAAU,CAACC;AACX,eAAO,CAAC5B,EAAmBgB,EAAM,MAAM,UAAUA,EAAM,KAAK,CAAC;AAGjE,UAAIY,KAAa,CAACD;AACd,eAAO,CAAC3B,EAAmBgB,EAAM,MAAM,OAAOA,EAAM,KAAK,CAAC;AAAA,IAElE;AAEA,WAAO,CAAA;AAAA,EACX,CAAC,EACA,IAAIX,CAAuB,GAE1BwB,wBAAiB,IAAI,CAAC,GAAGR,GAAkB,GAAGP,CAAc,CAAC,GAC7DgB,IAA8BP,EAAsB,OAAO,CAAAP,MACzDa,EAAW,IAAIb,CAAK,IACb,MAEXa,EAAW,IAAIb,CAAK,GACb,GACV;AAED,SAAO,CAAC,GAAGK,GAAkB,GAAGS,GAA6B,GAAGhB,CAAc,EAAE,KAAK,GAAG;AAC5F;"}

package/utils/routeUtils.d.ts

@@ -1,15 +1,124 @@
-export type ColumnsSettings = {
-    columnOrder: string[];
-    hiddenColumns: string[];
-    columnsDetails: Record<string, {
-        width: number;
-        defaultWidth?: number;
-    }>;
-};
-export declare const getSortDirShort: (sortDir: string) => "-" | "+";
-export declare const parseSorting: (sortValueShort: string) => {
+import { isEqual } from 'es-toolkit';
+import { SortDirectionType } from './SortUtils';
+import { TableColumnDetailsMap, TableColumnsSettings } from '../components/table/TableSettingsDialog';
+export { isEqual };
+export type ColumnsSettings = TableColumnsSettings;
+/**
+ * Returns a compact sort direction prefix for use in URL params.
+ * Serialize: Ascending = "", Descending = "-"
+ *
+ * Useful for concise sort state like `sort=-name` or `sort=name`.
+ *
+ * @example
+ * getSortDirShort(SortDirection.DESCENDING) // '-'
+ */
+export declare const getSortDirShort: (sortDir: string) => "" | "-";
+/**
+ * Returns a serialized string of the sort order and sort direction.
+ *
+ * @param sortInfo { sortDir: SortDirectionType; sortBy: string }
+ * @returns
+ */
+export declare const serializeSorting: (sortInfo: {
+    sortDir: SortDirectionType;
     sortBy: string;
-    sortDir: "desc" | "asc";
-};
+}) => string | null;
+/**
+ * Parses a compact sort param (e.g. `name` or `-name`) into sort fields.
+ * Useful when reading URL params into table state.
+ *
+ * @example
+ * parseSorting('-createdAt') // { sortBy: 'createdAt', sortDir: 'DESCENDING' }
+ */
+export declare const parseSorting: (sortValueShort: string | null | undefined) => {
+    sortBy: string;
+    sortDir: string;
+} | null;
+/**
+ * Serializes column settings into compact strings for a URL param.
+ * Useful to keep table configuration URLs short and readable.
+ *
+ * @example
+ * mapColumnsSettingsToStrings({ columnOrder: ['name'], hiddenColumns: [], columnsDetails: { name: { width: 120 } } })
+ * // ['name:120']
+ */
 export declare const mapColumnsSettingsToStrings: ({ columnOrder, hiddenColumns, columnsDetails, }: ColumnsSettings) => string[];
-export declare const parseColumnsSettingsStrings: (settings: string[], defaultColumnsDetails: ColumnsSettings["columnsDetails"]) => ColumnsSettings;
+/**
+ * Parses compact column strings into column settings using defaults.
+ * Useful to restore table settings from URL state.
+ *
+ * @example
+ * parseColumnsSettingsStrings(['-name:200'], { name: { width: 120, defaultWidth: 120 } })
+ */
+export declare const parseColumnsSettingsStrings: (settings: string[], defaultColumnsDetails: TableColumnDetailsMap) => TableColumnsSettings;
+export type UrlTypeMap = {
+    string: string;
+    number: number;
+    boolean: boolean;
+    array: string[];
+    'array-number': number[];
+    object: Record<string, unknown>;
+};
+export type UrlValueType = keyof UrlTypeMap;
+export type UrlConfigItem<TState = unknown, TValue = unknown> = {
+    /**
+     * The query param key in the URL (e.g., 'q', 'sort')
+     */
+    key: string;
+    /**
+     * Selector to retrieve the current value from Redux.
+     */
+    selector: (state: TState) => TValue;
+    /**
+     * Action creator to dispatch the new value to Redux.
+     */
+    action: (value: TValue) => unknown;
+    /**
+     * The generic type for auto-parsing/serialization
+     */
+    type?: UrlValueType;
+    /**
+     * Default value for the given key. Must be explicitly provided and
+     * must not be `undefined`.
+     *
+     * 1. If URL is missing the key, this value is applied to Redux.
+     * 2. If Redux matches this value, the key is removed from URL.
+     */
+    defaultValue: Exclude<TValue, undefined>;
+    /**
+     * Navigation behavior when this specific value changes
+     *
+     * Behavior in `useUrlState`:
+     * - `'push'`: every change creates a new history entry.
+     * - `'replace'`: changes replace the current entry, except the first
+     *   transition from default -> non-default, which is pushed once.
+     *
+     * @default 'push'
+     */
+    history?: 'push' | 'replace';
+    /**
+     * Optional: Custom function to convert Redux Object -> URL String
+     */
+    customSerialize?: (reduxValue: TValue) => string | null;
+    /**
+     * Optional: Custom function to convert URL String -> Redux Object
+     */
+    customDeserialize?: (urlValue: string | null) => TValue | null;
+};
+/**
+ * Generates a URL query string that mimics 'qs' library behavior
+ * by keeping commas and plus signs unencoded for readability.
+ */
+export declare const toQueryString: (params: URLSearchParams, config: readonly UrlConfigItem[]) => string;
+/**
+ * Converts a JS value into a string suitable for URLSearchParams.
+ * Returns null if the value is empty/invalid.
+ */
+export declare const serializeValue: <K extends UrlValueType>(value: UrlTypeMap[K] | null | undefined, type: K) => string | null;
+/**
+ * Generic deserialize function. Converts a URL string value back into a JS Primitive/Object.
+ *
+ * <TUrlValueType extends UrlValueType>: Capture the specific string literal passed in (e.g. 'number').
+ * Returns: UrlTypeMap[TUrlValueType] | null (e.g. number | null).
+ */
+export declare const deserializeValue: <TUrlValueType extends UrlValueType>(value: string | null, type: TUrlValueType) => UrlTypeMap[TUrlValueType] | null;

package/utils/routeUtils.js

@@ -1,38 +1,96 @@
-import { get as m } from "es-toolkit/compat";
-import { SortDirection as c } from "./SortUtils.js";
-const a = (s) => s === c.DESCENDING ? "-" : "+", p = (s) => {
-  const i = s.startsWith("-") ? c.DESCENDING : c.ASCENDING;
-  return {
-    sortBy: s.replace(/^[+-]/, "").trim(),
-    sortDir: i
-  };
-}, S = ({
-  columnOrder: s = [],
-  hiddenColumns: i = [],
-  columnsDetails: t = {}
-}) => s.map((n) => {
-  const o = m(t[n], "width"), r = m(t[n], "defaultWidth"), e = o !== 0 && o !== r ? `:${o}` : "";
-  return `${i.includes(n) ? "-" : ""}${n}${e}`;
-}), D = (s, i) => {
-  const t = {
+import { get as l } from "es-toolkit/compat";
+import { isNil as p } from "es-toolkit";
+import { isEqual as A } from "es-toolkit";
+import { SortDirection as g } from "./SortUtils.js";
+const f = (r) => r === g.DESCENDING ? "-" : "", S = (r) => r?.sortBy ? `${f(r.sortDir)}${r.sortBy}` : null, D = (r) => r ? r.startsWith("-") ? {
+  sortBy: r.substring(1),
+  // remove '-'
+  sortDir: "DESCENDING"
+} : r.startsWith("+") ? {
+  sortBy: r.substring(1).trim(),
+  // remove '+' and potential space
+  sortDir: "ASCENDING"
+} : {
+  sortBy: r.trim(),
+  sortDir: "ASCENDING"
+} : null, $ = ({
+  columnOrder: r = [],
+  hiddenColumns: t = [],
+  columnsDetails: n = {}
+}) => r.map((e) => {
+  const o = l(n[e], "width"), i = l(n[e], "defaultWidth"), c = o !== 0 && o !== i ? `:${o}` : "";
+  return `${t.includes(e) ? "-" : ""}${e}${c}`;
+}), j = (r, t) => {
+  const n = {
     columnOrder: [],
     hiddenColumns: [],
-    columnsDetails: { ...i }
+    columnsDetails: { ...t }
   };
-  return s.forEach((d) => {
-    const [n, o] = d.split(":"), r = n.startsWith("-") ? n.substr(1) : n;
-    if (t.columnOrder = [...t.columnOrder, r], o) {
-      const e = Number.parseInt(o, 10);
-      Number.isFinite(e) && (t.columnsDetails[r] = { ...t.columnsDetails[r], width: e });
+  return r.forEach((s) => {
+    const [e, o] = s.split(":"), i = e.startsWith("-") ? e.substr(1) : e;
+    if (n.columnOrder = [...n.columnOrder, i], o) {
+      const c = Number.parseInt(o, 10);
+      Number.isFinite(c) && (n.columnsDetails[i] = { ...n.columnsDetails[i], width: c });
     } else
-      t.columnsDetails[r] = { ...i[r] };
-    n.startsWith("-") && (t.hiddenColumns = [...t.hiddenColumns, r]);
-  }), t;
-};
+      n.columnsDetails[i] = { ...t[i] };
+    e.startsWith("-") && (n.hiddenColumns = [...n.hiddenColumns, i]);
+  }), n;
+}, a = (r) => encodeURIComponent(String(r)), m = (r) => decodeURIComponent(r), E = (r, t) => {
+  const n = new Map(t.map((e) => [e.key, e])), s = [];
+  return r.forEach((e, o) => {
+    const i = n.get(o), c = encodeURIComponent(o), u = encodeURIComponent(e);
+    if (i && ["array", "array-number", "object"].includes(i.type ?? "string")) {
+      const d = u.replace(/%2C/g, ",").replace(/%3A/g, ":");
+      s.push(`${c}=${d}`);
+    } else
+      s.push(`${c}=${u}`);
+  }), s.join("&");
+}, W = (r, t) => {
+  if (p(r) || r === "")
+    return null;
+  switch (t) {
+    case "string":
+    case "number":
+      return String(r);
+    case "boolean":
+      return r ? "true" : "false";
+    case "array":
+    case "array-number":
+      return !Array.isArray(r) || r.length === 0 ? null : r.map(String).join(",");
+    case "object":
+      return typeof r != "object" || Object.keys(r).length === 0 ? null : Object.entries(r).map(([n, s]) => `${a(n)}:${a(String(s))}`).join(",");
+    default:
+      return String(r);
+  }
+}, y = {
+  string: (r) => r,
+  number: (r) => {
+    const t = Number(r);
+    return Number.isNaN(t) ? null : t;
+  },
+  boolean: (r) => {
+    const t = r.toLowerCase();
+    return t === "true" || t === "1" || t === "yes" || t === "on";
+  },
+  array: (r) => r.split(",").filter(Boolean),
+  "array-number": (r) => r.split(",").map(Number).filter((t) => !Number.isNaN(t)),
+  object: (r) => {
+    const t = {};
+    return r.split(",").forEach((n) => {
+      const [s, e] = n.split(":");
+      s && e && (t[m(s)] = m(e));
+    }), t;
+  }
+}, w = (r, t) => p(r) ? null : y[t](r);
 export {
-  a as getSortDirShort,
-  S as mapColumnsSettingsToStrings,
-  D as parseColumnsSettingsStrings,
-  p as parseSorting
+  w as deserializeValue,
+  f as getSortDirShort,
+  A as isEqual,
+  $ as mapColumnsSettingsToStrings,
+  j as parseColumnsSettingsStrings,
+  D as parseSorting,
+  S as serializeSorting,
+  W as serializeValue,
+  E as toQueryString
 };
 //# sourceMappingURL=routeUtils.js.map