feat: add setParams and updateParams for managing route parameters

Author: jakobrosenberg

lib/runtime/helpers/index.js

@@ -228,6 +228,27 @@ export const params = {
     },
 }
 
+const stripUndef = o =>
+    Object.fromEntries(Object.entries(o).filter(([, v]) => v !== undefined))
+
+/**
+ * @type {Readable<(params: Object.<string, any>) => void>}
+ */
+export const setParams = derived(
+    goto,
+    $goto => params => $goto('$leaf', stripUndef(params)),
+)
+
+/**
+ * @type {Readable<(callback: (params: Object.<string, any>) => Object.<string, any>) => void>}
+ */
+export const updateParams = derived(
+    [setParams, params],
+    ([$setParams, $params]) =>
+        callback =>
+            $setParams(callback({ ...$params })),
+)
+
 /**
  * @callback IsActive
  * @param {String|RNodeRuntime=} pathOrNode