@trackunit/react-components 2.13.25 → 2.13.27-alpha-55a192f4ee4.0

package/index.cjs.js

@@ -13105,8 +13105,8 @@ const writeHashKey = (hash, key, value) => {
 
 /**
  * Default maximum length of the resulting URL fragment after adding one
- * persisted entry. Writes are skipped (localStorage continues to hold the
- * full state) when adding the entry would push the fragment past this cap.
+ * persisted entry. Oversized new entries are skipped; oversized replacements
+ * remove the stale entry so localStorage remains authoritative.
  *
  * The fragment is never sent to the server, so it is not subject to the
  * AWS WAF managed-rule `SizeRestrictions_QUERYSTRING` cap that applies to
@@ -13121,8 +13121,8 @@ const MAX_HASH_LENGTH = 64 * 1024;
  *
  * Behaviour mirrors `useSearchParamSync`, with two differences:
  *  - Reads from and writes to `location.hash` instead of `location.search`.
- *  - Writes are guarded against {@link MAX_HASH_LENGTH} rather than the
- *    AWS-WAF-driven search-param cap.
+ *  - Oversized replacements remove stale values using
+ *    {@link MAX_HASH_LENGTH}, rather than the AWS-WAF-driven search-param cap.
  *
  * The fragment is treated as a sequence of `&`-separated tokens via the
  * pure utilities in `./hashFragment`. Foreign tokens (bare anchors, other
@@ -13204,15 +13204,18 @@ const useHashParamSync = ({ key, enabled = true, onExternalChange, replace: repl
         }
         pendingWriteRef.current = null;
         const { encodedValue, options } = pending;
-        const nextHash = writeHashKey(location.hash, key, encodedValue);
+        let nextHash = writeHashKey(location.hash, key, encodedValue);
+        let removedOversizedValue = false;
         if (nextHash.length > MAX_HASH_LENGTH) {
-            // Drop the write so the fragment never grows past the cap. The
-            // localStorage write performed by `usePersistedState` still holds
-            // the full state, so the layout survives a reload on the same
-            // browser; only the shareable URL is degraded.
-            return;
+            if (currentHashValue === undefined) {
+                return;
+            }
+            nextHash = writeHashKey(location.hash, key, undefined);
+            removedOversizedValue = true;
         }
-        const shouldReplace = options?.replace ?? replaceOption ?? !Boolean(currentHashValue);
+        const shouldReplace = removedOversizedValue
+            ? true
+            : (options?.replace ?? replaceOption ?? !Boolean(currentHashValue));
         // Tanstack Router's `navigate({ hash })` expects the fragment body
         // *without* the leading `#` — the router adds the delimiter itself
         // when serialising the URL. Forwarding the `#`-prefixed value from

package/index.esm.js

@@ -13104,8 +13104,8 @@ const writeHashKey = (hash, key, value) => {
 
 /**
  * Default maximum length of the resulting URL fragment after adding one
- * persisted entry. Writes are skipped (localStorage continues to hold the
- * full state) when adding the entry would push the fragment past this cap.
+ * persisted entry. Oversized new entries are skipped; oversized replacements
+ * remove the stale entry so localStorage remains authoritative.
  *
  * The fragment is never sent to the server, so it is not subject to the
  * AWS WAF managed-rule `SizeRestrictions_QUERYSTRING` cap that applies to
@@ -13120,8 +13120,8 @@ const MAX_HASH_LENGTH = 64 * 1024;
  *
  * Behaviour mirrors `useSearchParamSync`, with two differences:
  *  - Reads from and writes to `location.hash` instead of `location.search`.
- *  - Writes are guarded against {@link MAX_HASH_LENGTH} rather than the
- *    AWS-WAF-driven search-param cap.
+ *  - Oversized replacements remove stale values using
+ *    {@link MAX_HASH_LENGTH}, rather than the AWS-WAF-driven search-param cap.
  *
  * The fragment is treated as a sequence of `&`-separated tokens via the
  * pure utilities in `./hashFragment`. Foreign tokens (bare anchors, other
@@ -13203,15 +13203,18 @@ const useHashParamSync = ({ key, enabled = true, onExternalChange, replace: repl
         }
         pendingWriteRef.current = null;
         const { encodedValue, options } = pending;
-        const nextHash = writeHashKey(location.hash, key, encodedValue);
+        let nextHash = writeHashKey(location.hash, key, encodedValue);
+        let removedOversizedValue = false;
         if (nextHash.length > MAX_HASH_LENGTH) {
-            // Drop the write so the fragment never grows past the cap. The
-            // localStorage write performed by `usePersistedState` still holds
-            // the full state, so the layout survives a reload on the same
-            // browser; only the shareable URL is degraded.
-            return;
+            if (currentHashValue === undefined) {
+                return;
+            }
+            nextHash = writeHashKey(location.hash, key, undefined);
+            removedOversizedValue = true;
         }
-        const shouldReplace = options?.replace ?? replaceOption ?? !Boolean(currentHashValue);
+        const shouldReplace = removedOversizedValue
+            ? true
+            : (options?.replace ?? replaceOption ?? !Boolean(currentHashValue));
         // Tanstack Router's `navigate({ hash })` expects the fragment body
         // *without* the leading `#` — the router adds the delimiter itself
         // when serialising the URL. Forwarding the `#`-prefixed value from

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@trackunit/react-components",
-  "version": "2.13.25",
+  "version": "2.13.27-alpha-55a192f4ee4.0",
   "repository": "https://github.com/Trackunit/manager",
   "license": "SEE LICENSE IN LICENSE.txt",
   "migrations": "./migrations.json",
@@ -14,16 +14,16 @@
     "@floating-ui/react": "^0.26.25",
     "string-ts": "^2.0.0",
     "tailwind-merge": "^2.0.0",
-    "@trackunit/ui-design-tokens": "1.15.34",
-    "@trackunit/css-class-variance-utilities": "2.0.14",
-    "@trackunit/shared-utils": "1.16.49",
-    "@trackunit/ui-icons": "1.14.43",
+    "@trackunit/ui-design-tokens": "1.15.35-alpha-55a192f4ee4.0",
+    "@trackunit/css-class-variance-utilities": "2.0.15-alpha-55a192f4ee4.0",
+    "@trackunit/shared-utils": "1.16.50-alpha-55a192f4ee4.0",
+    "@trackunit/ui-icons": "1.14.44-alpha-55a192f4ee4.0",
     "es-toolkit": "^1.39.10",
     "@tanstack/react-virtual": "^3.14.3",
     "dequal": "^2.0.3",
     "fflate": "^0.8.2",
     "zod": "^3.25.76",
-    "@trackunit/i18n-library-translation": "2.4.63"
+    "@trackunit/i18n-library-translation": "2.4.65-alpha-55a192f4ee4.0"
   },
   "peerDependencies": {
     "react": "^19.0.0",

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

@@ -1,7 +1,7 @@
 /**
  * Default maximum length of the resulting URL fragment after adding one
- * persisted entry. Writes are skipped (localStorage continues to hold the
- * full state) when adding the entry would push the fragment past this cap.
+ * persisted entry. Oversized new entries are skipped; oversized replacements
+ * remove the stale entry so localStorage remains authoritative.
  *
  * The fragment is never sent to the server, so it is not subject to the
  * AWS WAF managed-rule `SizeRestrictions_QUERYSTRING` cap that applies to
@@ -37,8 +37,8 @@ type UseHashParamSyncReturn = {
  *
  * Behaviour mirrors `useSearchParamSync`, with two differences:
  *  - Reads from and writes to `location.hash` instead of `location.search`.
- *  - Writes are guarded against {@link MAX_HASH_LENGTH} rather than the
- *    AWS-WAF-driven search-param cap.
+ *  - Oversized replacements remove stale values using
+ *    {@link MAX_HASH_LENGTH}, rather than the AWS-WAF-driven search-param cap.
  *
  * The fragment is treated as a sequence of `&`-separated tokens via the
  * pure utilities in `./hashFragment`. Foreign tokens (bare anchors, other