@urbicon-ui/sveltekit-utils 6.43.2 → 6.45.0

package/dist/url.svelte.d.ts

@@ -81,6 +81,12 @@ export declare function createUrlParam<T>(_key: string, options: UrlParamOptions
  * initial render reflects the incoming URL. The setter calls the client-only
  * `goto` and is meant to run from event handlers/effects — never during SSR.
  *
+ * Prerender-safe: SvelteKit forbids reading `url.searchParams` while
+ * prerendering (the emitted HTML must not depend on a query string that will
+ * not exist at request time). During `building` the getter therefore yields
+ * {@link UrlParamOptions.initial} — "absent" is the truth for that render;
+ * after hydration the client re-reads the real URL reactively.
+ *
  * A **getter**, not a store, is returned on purpose: call it lazily inside
  * `$derived`/`$effect` and the read is tracked there.
  *

package/dist/url.svelte.js

@@ -1,3 +1,4 @@
+import { building } from '$app/environment';
 import { goto } from '$app/navigation';
 import { page } from '$app/state';
 import { applyTableQueryToSearchParams, searchParamsToTableQuery } from './table-query';
@@ -99,6 +100,12 @@ export function createUrlParam(_key, options) {
  * initial render reflects the incoming URL. The setter calls the client-only
  * `goto` and is meant to run from event handlers/effects — never during SSR.
  *
+ * Prerender-safe: SvelteKit forbids reading `url.searchParams` while
+ * prerendering (the emitted HTML must not depend on a query string that will
+ * not exist at request time). During `building` the getter therefore yields
+ * {@link UrlParamOptions.initial} — "absent" is the truth for that render;
+ * after hydration the client re-reads the real URL reactively.
+ *
  * A **getter**, not a store, is returned on purpose: call it lazily inside
  * `$derived`/`$effect` and the read is tracked there.
  *
@@ -124,7 +131,7 @@ export function createUrlParam(_key, options) {
  */
 export function useUrlParam(key, options) {
     const { get, set } = createUrlParam(key, options);
-    const getBound = () => get(page.url.searchParams);
+    const getBound = building ? () => options.initial : () => get(page.url.searchParams);
     return [getBound, set];
 }
 /**
@@ -219,7 +226,9 @@ export function useUrlArrayParam(key, opts) {
  *   (write a query back to the URL).
  */
 export function createTableQueryUrlSync(options = {}) {
-    const initialQuery = searchParamsToTableQuery(page.url.searchParams, options);
+    // Same prerender rule as `useUrlParam`: no query string exists while
+    // building, so the seed parses from empty params instead of throwing.
+    const initialQuery = searchParamsToTableQuery(building ? new URLSearchParams() : page.url.searchParams, options);
     function syncQuery(query) {
         const next = applyTableQueryToSearchParams(page.url.searchParams, query, options);
         const qs = next.toString();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@urbicon-ui/sveltekit-utils",
-  "version": "6.43.2",
+  "version": "6.45.0",
   "description": "SvelteKit helper utilities — createCronRunner, streamSse, and URL-state runes",
   "license": "MIT",
   "repository": {