@trackunit/react-components 2.5.2-alpha-3b19e5fe058.0 → 2.5.4

package/index.cjs.js

@@ -28,7 +28,6 @@ var dequal = require('dequal');
 var defaultTranslations = {
 	"breadcrumb.backButton": "back",
 	"breadcrumb.expandButton": "expand",
-	"cardHeader.closeButton": "Close",
 	"moreMenu.buttonLabel": "Show more"
 };
 
@@ -11948,6 +11947,19 @@ const useStorageKey = (key, userId) => {
     return react.useMemo(() => (userId ? `${key}-${userId}` : key), [key, userId]);
 };
 
+/**
+ * Raw localStorage access, kept in one place so this file's exemption from the
+ * no-direct-storage-access rule is centralised rather than repeated at each call site.
+ *
+ * TODO: migrate to the useLocalStorage hook — this file was exempted when the
+ * no-direct-storage-access rule was introduced.
+ */
+/* eslint-disable no-restricted-globals */
+const rawLocalStorage = {
+    read: (key) => localStorage.getItem(key),
+    write: (key, value) => localStorage.setItem(key, value),
+    remove: (key) => localStorage.removeItem(key),
+};
 /**
  * Generic persistence hook that loads state from a URL slot (search param
  * or hash fragment, depending on `urlLocation`) with localStorage fallback,
@@ -11971,6 +11983,11 @@ const useStorageKey = (key, userId) => {
  * `toUrlValue` + encoding). Duplicate writes where the state has not
  * changed (deep equality) are skipped.
  *
+ * `clearState` removes the entry from localStorage and from the URL slot,
+ * rather than writing an empty value. Use it when the state a consumer
+ * derives has become empty, so no leftover entry is stored for a value the
+ * user has reset. It is idempotent — clearing an absent entry is a no-op.
+ *
  * @param options - Configuration for the persisted state.
  * @param options.key - Unique identifier used for both the URL slot and the localStorage key.
  * @param options.validate - Called with the decoded/parsed value; must return `TState` or `undefined`.
@@ -12085,9 +12102,7 @@ const usePersistedState = ({ key, validate, serialize, toUrlValue, fromUrlValue,
         let storageState;
         if (localStorageEnabled) {
             try {
-                // TODO: migrate to useLocalStorage hook — this file was exempted when the no-direct-storage-access rule was introduced
-                // eslint-disable-next-line no-restricted-globals
-                const raw = localStorage.getItem(storageKey);
+                const raw = rawLocalStorage.read(storageKey);
                 if (raw) {
                     const parsed = storageSerializer.deserialize(raw);
                     storageState = validateState(parsed);
@@ -12222,8 +12237,7 @@ const usePersistedState = ({ key, validate, serialize, toUrlValue, fromUrlValue,
                 const serialized = serializeRef.current
                     ? serializeRef.current(migrated)
                     : storageSerializer.serialize(migrated);
-                // eslint-disable-next-line no-restricted-globals
-                localStorage.setItem(storageKey, serialized);
+                rawLocalStorage.write(storageKey, serialized);
             }
             const urlValue = toUrlValueRef.current ? toUrlValueRef.current(migrated) : migrated;
             const encoded = encode(urlValue);
@@ -12237,14 +12251,20 @@ const usePersistedState = ({ key, validate, serialize, toUrlValue, fromUrlValue,
         lastPersistedRef.current = state;
         if (localStorageEnabled) {
             const serialized = serializeRef.current ? serializeRef.current(state) : storageSerializer.serialize(state);
-            // eslint-disable-next-line no-restricted-globals
-            localStorage.setItem(storageKey, serialized);
+            rawLocalStorage.write(storageKey, serialized);
         }
         const urlValue = toUrlValueRef.current ? toUrlValueRef.current(state) : state;
         const encoded = encode(urlValue);
         updateSearchParam(encoded);
     }, [storageKey, encode, localStorageEnabled, updateSearchParam]);
-    return react.useMemo(() => ({ initialState, persistState }), [initialState, persistState]);
+    const clearState = react.useCallback(() => {
+        lastPersistedRef.current = undefined;
+        if (localStorageEnabled) {
+            rawLocalStorage.remove(storageKey);
+        }
+        updateSearchParam(undefined);
+    }, [localStorageEnabled, storageKey, updateSearchParam]);
+    return react.useMemo(() => ({ initialState, persistState, clearState }), [initialState, persistState, clearState]);
 };
 
 const OVERSCAN = 10;

package/index.esm.js

@@ -26,7 +26,6 @@ import { dequal } from 'dequal';
 var defaultTranslations = {
 	"breadcrumb.backButton": "back",
 	"breadcrumb.expandButton": "expand",
-	"cardHeader.closeButton": "Close",
 	"moreMenu.buttonLabel": "Show more"
 };
 
@@ -11946,6 +11945,19 @@ const useStorageKey = (key, userId) => {
     return useMemo(() => (userId ? `${key}-${userId}` : key), [key, userId]);
 };
 
+/**
+ * Raw localStorage access, kept in one place so this file's exemption from the
+ * no-direct-storage-access rule is centralised rather than repeated at each call site.
+ *
+ * TODO: migrate to the useLocalStorage hook — this file was exempted when the
+ * no-direct-storage-access rule was introduced.
+ */
+/* eslint-disable no-restricted-globals */
+const rawLocalStorage = {
+    read: (key) => localStorage.getItem(key),
+    write: (key, value) => localStorage.setItem(key, value),
+    remove: (key) => localStorage.removeItem(key),
+};
 /**
  * Generic persistence hook that loads state from a URL slot (search param
  * or hash fragment, depending on `urlLocation`) with localStorage fallback,
@@ -11969,6 +11981,11 @@ const useStorageKey = (key, userId) => {
  * `toUrlValue` + encoding). Duplicate writes where the state has not
  * changed (deep equality) are skipped.
  *
+ * `clearState` removes the entry from localStorage and from the URL slot,
+ * rather than writing an empty value. Use it when the state a consumer
+ * derives has become empty, so no leftover entry is stored for a value the
+ * user has reset. It is idempotent — clearing an absent entry is a no-op.
+ *
  * @param options - Configuration for the persisted state.
  * @param options.key - Unique identifier used for both the URL slot and the localStorage key.
  * @param options.validate - Called with the decoded/parsed value; must return `TState` or `undefined`.
@@ -12083,9 +12100,7 @@ const usePersistedState = ({ key, validate, serialize, toUrlValue, fromUrlValue,
         let storageState;
         if (localStorageEnabled) {
             try {
-                // TODO: migrate to useLocalStorage hook — this file was exempted when the no-direct-storage-access rule was introduced
-                // eslint-disable-next-line no-restricted-globals
-                const raw = localStorage.getItem(storageKey);
+                const raw = rawLocalStorage.read(storageKey);
                 if (raw) {
                     const parsed = storageSerializer.deserialize(raw);
                     storageState = validateState(parsed);
@@ -12220,8 +12235,7 @@ const usePersistedState = ({ key, validate, serialize, toUrlValue, fromUrlValue,
                 const serialized = serializeRef.current
                     ? serializeRef.current(migrated)
                     : storageSerializer.serialize(migrated);
-                // eslint-disable-next-line no-restricted-globals
-                localStorage.setItem(storageKey, serialized);
+                rawLocalStorage.write(storageKey, serialized);
             }
             const urlValue = toUrlValueRef.current ? toUrlValueRef.current(migrated) : migrated;
             const encoded = encode(urlValue);
@@ -12235,14 +12249,20 @@ const usePersistedState = ({ key, validate, serialize, toUrlValue, fromUrlValue,
         lastPersistedRef.current = state;
         if (localStorageEnabled) {
             const serialized = serializeRef.current ? serializeRef.current(state) : storageSerializer.serialize(state);
-            // eslint-disable-next-line no-restricted-globals
-            localStorage.setItem(storageKey, serialized);
+            rawLocalStorage.write(storageKey, serialized);
         }
         const urlValue = toUrlValueRef.current ? toUrlValueRef.current(state) : state;
         const encoded = encode(urlValue);
         updateSearchParam(encoded);
     }, [storageKey, encode, localStorageEnabled, updateSearchParam]);
-    return useMemo(() => ({ initialState, persistState }), [initialState, persistState]);
+    const clearState = useCallback(() => {
+        lastPersistedRef.current = undefined;
+        if (localStorageEnabled) {
+            rawLocalStorage.remove(storageKey);
+        }
+        updateSearchParam(undefined);
+    }, [localStorageEnabled, storageKey, updateSearchParam]);
+    return useMemo(() => ({ initialState, persistState, clearState }), [initialState, persistState, clearState]);
 };
 
 const OVERSCAN = 10;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@trackunit/react-components",
-  "version": "2.5.2-alpha-3b19e5fe058.0",
+  "version": "2.5.4",
   "repository": "https://github.com/Trackunit/manager",
   "license": "SEE LICENSE IN LICENSE.txt",
   "migrations": "./migrations.json",
@@ -14,17 +14,17 @@
     "@floating-ui/react": "^0.26.25",
     "string-ts": "^2.0.0",
     "tailwind-merge": "^2.0.0",
-    "@trackunit/ui-design-tokens": "1.14.1-alpha-3b19e5fe058.0",
-    "@trackunit/css-class-variance-utilities": "1.14.1-alpha-3b19e5fe058.0",
-    "@trackunit/shared-utils": "1.16.1-alpha-3b19e5fe058.0",
-    "@trackunit/ui-icons": "1.14.1-alpha-3b19e5fe058.0",
+    "@trackunit/ui-design-tokens": "1.14.1",
+    "@trackunit/css-class-variance-utilities": "1.14.1",
+    "@trackunit/shared-utils": "1.16.1",
+    "@trackunit/ui-icons": "1.14.1",
     "es-toolkit": "^1.39.10",
     "@tanstack/react-virtual": "^3.14.3",
     "dequal": "^2.0.3",
     "fflate": "^0.8.2",
     "superjson": "^2.2.6",
     "zod": "^3.25.76",
-    "@trackunit/i18n-library-translation": "2.3.1-alpha-3b19e5fe058.0"
+    "@trackunit/i18n-library-translation": "2.3.1"
   },
   "peerDependencies": {
     "react": "^19.0.0",

package/src/hooks/persistence/usePersistedState.d.ts

@@ -43,6 +43,7 @@ type UsePersistedStateOptions<TState> = {
 type UsePersistedStateReturn<TState> = {
     readonly initialState: TState | undefined;
     readonly persistState: (state: TState) => void;
+    readonly clearState: () => void;
 };
 /**
  * Generic persistence hook that loads state from a URL slot (search param
@@ -67,6 +68,11 @@ type UsePersistedStateReturn<TState> = {
  * `toUrlValue` + encoding). Duplicate writes where the state has not
  * changed (deep equality) are skipped.
  *
+ * `clearState` removes the entry from localStorage and from the URL slot,
+ * rather than writing an empty value. Use it when the state a consumer
+ * derives has become empty, so no leftover entry is stored for a value the
+ * user has reset. It is idempotent — clearing an absent entry is a no-op.
+ *
  * @param options - Configuration for the persisted state.
  * @param options.key - Unique identifier used for both the URL slot and the localStorage key.
  * @param options.validate - Called with the decoded/parsed value; must return `TState` or `undefined`.

package/translation.cjs.js

@@ -3,7 +3,6 @@
 var translation = {
 	"breadcrumb.backButton": "zurück",
 	"breadcrumb.expandButton": "ausklappen",
-	"cardHeader.closeButton": "Schließen",
 	"moreMenu.buttonLabel": "Mehr anzeigen"
 };
 

package/translation.esm.js

@@ -1,7 +1,6 @@
 var translation = {
 	"breadcrumb.backButton": "zurück",
 	"breadcrumb.expandButton": "ausklappen",
-	"cardHeader.closeButton": "Schließen",
 	"moreMenu.buttonLabel": "Mehr anzeigen"
 };
 

package/translation10.cjs.js

@@ -3,7 +3,6 @@
 var translation = {
 	"breadcrumb.backButton": "powrót",
 	"breadcrumb.expandButton": "rozwiń",
-	"cardHeader.closeButton": "Zamknij",
 	"moreMenu.buttonLabel": "Pokaż więcej"
 };
 

package/translation10.esm.js

@@ -1,7 +1,6 @@
 var translation = {
 	"breadcrumb.backButton": "powrót",
 	"breadcrumb.expandButton": "rozwiń",
-	"cardHeader.closeButton": "Zamknij",
 	"moreMenu.buttonLabel": "Pokaż więcej"
 };
 

package/translation11.cjs.js

@@ -3,7 +3,6 @@
 var translation = {
 	"breadcrumb.backButton": "voltar",
 	"breadcrumb.expandButton": "expandir",
-	"cardHeader.closeButton": "Fechar",
 	"moreMenu.buttonLabel": "Mostrar mais"
 };
 

package/translation11.esm.js

@@ -1,7 +1,6 @@
 var translation = {
 	"breadcrumb.backButton": "voltar",
 	"breadcrumb.expandButton": "expandir",
-	"cardHeader.closeButton": "Fechar",
 	"moreMenu.buttonLabel": "Mostrar mais"
 };
 

package/translation12.cjs.js

@@ -3,7 +3,6 @@
 var translation = {
 	"breadcrumb.backButton": "назад",
 	"breadcrumb.expandButton": "развернуть",
-	"cardHeader.closeButton": "Закрыть",
 	"moreMenu.buttonLabel": "Показать больше"
 };
 

package/translation12.esm.js

@@ -1,7 +1,6 @@
 var translation = {
 	"breadcrumb.backButton": "назад",
 	"breadcrumb.expandButton": "развернуть",
-	"cardHeader.closeButton": "Закрыть",
 	"moreMenu.buttonLabel": "Показать больше"
 };
 

package/translation13.cjs.js

@@ -3,7 +3,6 @@
 var translation = {
 	"breadcrumb.backButton": "înapoi",
 	"breadcrumb.expandButton": "extindere",
-	"cardHeader.closeButton": "Închidere",
 	"moreMenu.buttonLabel": "Afișare mai mult"
 };
 

package/translation13.esm.js

@@ -1,7 +1,6 @@
 var translation = {
 	"breadcrumb.backButton": "înapoi",
 	"breadcrumb.expandButton": "extindere",
-	"cardHeader.closeButton": "Închidere",
 	"moreMenu.buttonLabel": "Afișare mai mult"
 };
 

package/translation14.cjs.js

@@ -3,7 +3,6 @@
 var translation = {
 	"breadcrumb.backButton": "atrás",
 	"breadcrumb.expandButton": "expandir",
-	"cardHeader.closeButton": "Cerrar",
 	"moreMenu.buttonLabel": "Mostrar más"
 };
 

package/translation14.esm.js

@@ -1,7 +1,6 @@
 var translation = {
 	"breadcrumb.backButton": "atrás",
 	"breadcrumb.expandButton": "expandir",
-	"cardHeader.closeButton": "Cerrar",
 	"moreMenu.buttonLabel": "Mostrar más"
 };
 

package/translation15.cjs.js

@@ -3,7 +3,6 @@
 var translation = {
 	"breadcrumb.backButton": "tillbaka",
 	"breadcrumb.expandButton": "expandera",
-	"cardHeader.closeButton": "Stäng",
 	"moreMenu.buttonLabel": "Visa mer"
 };
 

package/translation15.esm.js

@@ -1,7 +1,6 @@
 var translation = {
 	"breadcrumb.backButton": "tillbaka",
 	"breadcrumb.expandButton": "expandera",
-	"cardHeader.closeButton": "Stäng",
 	"moreMenu.buttonLabel": "Visa mer"
 };
 

package/translation16.cjs.js

@@ -3,7 +3,6 @@
 var translation = {
 	"breadcrumb.backButton": "戻る",
 	"breadcrumb.expandButton": "展開",
-	"cardHeader.closeButton": "閉じる",
 	"moreMenu.buttonLabel": "さらに表示"
 };
 

package/translation16.esm.js

@@ -1,7 +1,6 @@
 var translation = {
 	"breadcrumb.backButton": "戻る",
 	"breadcrumb.expandButton": "展開",
-	"cardHeader.closeButton": "閉じる",
 	"moreMenu.buttonLabel": "さらに表示"
 };
 

package/translation17.cjs.js

@@ -3,7 +3,6 @@
 var translation = {
 	"breadcrumb.backButton": "ย้อนกลับ",
 	"breadcrumb.expandButton": "ขยาย",
-	"cardHeader.closeButton": "ปิด",
 	"moreMenu.buttonLabel": "แสดงเพิ่มเติม"
 };
 

package/translation17.esm.js

@@ -1,7 +1,6 @@
 var translation = {
 	"breadcrumb.backButton": "ย้อนกลับ",
 	"breadcrumb.expandButton": "ขยาย",
-	"cardHeader.closeButton": "ปิด",
 	"moreMenu.buttonLabel": "แสดงเพิ่มเติม"
 };
 

package/translation2.cjs.js

@@ -3,7 +3,6 @@
 var translation = {
 	"breadcrumb.backButton": "tilbage",
 	"breadcrumb.expandButton": "udvid",
-	"cardHeader.closeButton": "Luk",
 	"moreMenu.buttonLabel": "Vis mere"
 };
 

package/translation2.esm.js

@@ -1,7 +1,6 @@
 var translation = {
 	"breadcrumb.backButton": "tilbage",
 	"breadcrumb.expandButton": "udvid",
-	"cardHeader.closeButton": "Luk",
 	"moreMenu.buttonLabel": "Vis mere"
 };
 

package/translation3.cjs.js

@@ -3,7 +3,6 @@
 var translation = {
 	"breadcrumb.backButton": "zpět",
 	"breadcrumb.expandButton": "rozbalit",
-	"cardHeader.closeButton": "Zavřít",
 	"moreMenu.buttonLabel": "Zobrazit více"
 };
 

package/translation3.esm.js

@@ -1,7 +1,6 @@
 var translation = {
 	"breadcrumb.backButton": "zpět",
 	"breadcrumb.expandButton": "rozbalit",
-	"cardHeader.closeButton": "Zavřít",
 	"moreMenu.buttonLabel": "Zobrazit více"
 };
 

package/translation4.cjs.js

@@ -3,7 +3,6 @@
 var translation = {
 	"breadcrumb.backButton": "terug",
 	"breadcrumb.expandButton": "uitklappen",
-	"cardHeader.closeButton": "Afsluiten",
 	"moreMenu.buttonLabel": "Meer weergeven"
 };
 

package/translation4.esm.js

@@ -1,7 +1,6 @@
 var translation = {
 	"breadcrumb.backButton": "terug",
 	"breadcrumb.expandButton": "uitklappen",
-	"cardHeader.closeButton": "Afsluiten",
 	"moreMenu.buttonLabel": "Meer weergeven"
 };
 

package/translation5.cjs.js

@@ -3,7 +3,6 @@
 var translation = {
 	"breadcrumb.backButton": "retour",
 	"breadcrumb.expandButton": "développer",
-	"cardHeader.closeButton": "Fermer",
 	"moreMenu.buttonLabel": "Afficher plus"
 };
 

package/translation5.esm.js

@@ -1,7 +1,6 @@
 var translation = {
 	"breadcrumb.backButton": "retour",
 	"breadcrumb.expandButton": "développer",
-	"cardHeader.closeButton": "Fermer",
 	"moreMenu.buttonLabel": "Afficher plus"
 };
 

package/translation6.cjs.js

@@ -3,7 +3,6 @@
 var translation = {
 	"breadcrumb.backButton": "takaisin",
 	"breadcrumb.expandButton": "laajenna",
-	"cardHeader.closeButton": "Sulje",
 	"moreMenu.buttonLabel": "Näytä lisää"
 };
 

package/translation6.esm.js

@@ -1,7 +1,6 @@
 var translation = {
 	"breadcrumb.backButton": "takaisin",
 	"breadcrumb.expandButton": "laajenna",
-	"cardHeader.closeButton": "Sulje",
 	"moreMenu.buttonLabel": "Näytä lisää"
 };
 

package/translation7.cjs.js

@@ -3,7 +3,6 @@
 var translation = {
 	"breadcrumb.backButton": "vissza",
 	"breadcrumb.expandButton": "kibontás",
-	"cardHeader.closeButton": "Bezárás",
 	"moreMenu.buttonLabel": "Több megjelenítése"
 };
 

package/translation7.esm.js

@@ -1,7 +1,6 @@
 var translation = {
 	"breadcrumb.backButton": "vissza",
 	"breadcrumb.expandButton": "kibontás",
-	"cardHeader.closeButton": "Bezárás",
 	"moreMenu.buttonLabel": "Több megjelenítése"
 };
 

package/translation8.cjs.js

@@ -3,7 +3,6 @@
 var translation = {
 	"breadcrumb.backButton": "indietro",
 	"breadcrumb.expandButton": "espandi",
-	"cardHeader.closeButton": "Chiudi",
 	"moreMenu.buttonLabel": "Mostra di più"
 };
 

package/translation8.esm.js

@@ -1,7 +1,6 @@
 var translation = {
 	"breadcrumb.backButton": "indietro",
 	"breadcrumb.expandButton": "espandi",
-	"cardHeader.closeButton": "Chiudi",
 	"moreMenu.buttonLabel": "Mostra di più"
 };
 

package/translation9.cjs.js

@@ -3,7 +3,6 @@
 var translation = {
 	"breadcrumb.backButton": "tilbake",
 	"breadcrumb.expandButton": "utvid",
-	"cardHeader.closeButton": "Lukk",
 	"moreMenu.buttonLabel": "Vis mer"
 };
 

package/translation9.esm.js

@@ -1,7 +1,6 @@
 var translation = {
 	"breadcrumb.backButton": "tilbake",
 	"breadcrumb.expandButton": "utvid",
-	"cardHeader.closeButton": "Lukk",
 	"moreMenu.buttonLabel": "Vis mer"
 };