sibujs 4.10.0 → 4.11.0

package/dist/plugins.cjs

@@ -2381,7 +2381,7 @@ function forEachSubscriber(signal2, visit) {
 }
 
 // src/reactivity/track.ts
-var _runtimeVersion = true ? "4.10.0" : "dev";
+var _runtimeVersion = true ? "4.11.0" : "dev";
 var REGISTRY_KEY = /* @__PURE__ */ Symbol.for("sibujs.reactive.v1");
 function resolveReactiveApi() {
   const g2 = globalThis;
@@ -3458,11 +3458,28 @@ function normalizePathname(path2) {
 function parseQuery(query) {
   return Object.fromEntries(new URLSearchParams(query));
 }
+function parseQueryAll(query) {
+  const all = /* @__PURE__ */ new Map();
+  for (const [key, value] of new URLSearchParams(query)) {
+    const values = all.get(key);
+    if (values) values.push(value);
+    else all.set(key, [value]);
+  }
+  return Object.fromEntries(all);
+}
+function serializeQuery(query) {
+  const search = new URLSearchParams();
+  for (const [key, value] of Object.entries(query)) {
+    if (Array.isArray(value)) for (const v of value) search.append(key, String(v));
+    else search.append(key, String(value));
+  }
+  return search.toString();
+}
 function paramsIdentity(params) {
   return JSON.stringify(Object.entries(params).sort(([a2], [b2]) => a2 < b2 ? -1 : a2 > b2 ? 1 : 0));
 }
 function queryIdentity(query) {
-  return paramsIdentity(typeof query === "string" ? parseQuery(query) : query);
+  return paramsIdentity(typeof query === "string" ? parseQueryAll(query) : query);
 }
 function isPathnameAncestor(target, current) {
   if (target === current) return true;
@@ -4138,6 +4155,7 @@ var _SibuRouter = class _SibuRouter {
       path: "/",
       params: {},
       query: {},
+      queryAll: {},
       hash: "",
       meta: {},
       matched: []
@@ -4164,6 +4182,7 @@ var _SibuRouter = class _SibuRouter {
   createRouteContext(fullPath) {
     const { path: path2, query: queryString, hash } = splitRouteUrl(fullPath);
     const query = parseQuery(queryString);
+    const queryAll = parseQueryAll(queryString);
     const match = this.matcher.match(path2 || "/");
     const params = match?.params || {};
     const meta2 = match?.route.meta || {};
@@ -4172,6 +4191,7 @@ var _SibuRouter = class _SibuRouter {
       path: path2 || "/",
       params,
       query,
+      queryAll,
       hash,
       meta: meta2,
       matched
@@ -4317,8 +4337,9 @@ var _SibuRouter = class _SibuRouter {
         path2 = path2.replace(new RegExp(`:${key}(?=[/?#]|$)`, "g"), encodeURIComponent(value));
       }
     }
-    if (to.query && Object.keys(to.query).length > 0) {
-      path2 += `?${new URLSearchParams(to.query).toString()}`;
+    const search = to.query ? serializeQuery(to.query) : "";
+    if (search) {
+      path2 += `?${search}`;
     }
     if (to.hash) {
       path2 += `#${to.hash}`;
@@ -4327,10 +4348,11 @@ var _SibuRouter = class _SibuRouter {
   }
   isSameRoute(from, to) {
     if (from.matched.length === 0 && to.matched.length > 0) return false;
-    return from.path === to.path && paramsIdentity(from.params) === paramsIdentity(to.params) && queryIdentity(from.query) === queryIdentity(to.query) && from.hash === to.hash;
+    return from.path === to.path && paramsIdentity(from.params) === paramsIdentity(to.params) && queryIdentity(from.queryAll) === queryIdentity(to.queryAll) && from.hash === to.hash;
   }
   updateHistory(to, options) {
-    const fullPath = this.options.base + to.path + (Object.keys(to.query).length ? `?${new URLSearchParams(to.query).toString()}` : "") + (to.hash ? `#${to.hash}` : "");
+    const search = serializeQuery(to.queryAll);
+    const fullPath = this.options.base + to.path + (search ? `?${search}` : "") + (to.hash ? `#${to.hash}` : "");
     const h = globalThis.history;
     if (!h) return;
     if (options.replace) {
@@ -4513,6 +4535,65 @@ function abortReasonOf(signal2) {
 }
 var ROUTER_KEY = /* @__PURE__ */ Symbol.for("sibujs.router.v1");
 var _routerRef = globalThis[ROUTER_KEY] ?? (globalThis[ROUTER_KEY] = { current: null });
+var [routerRevision, setRouterRevision] = signal(0);
+var awaitingParent = /* @__PURE__ */ new Map();
+var parentObserver = null;
+function stopParentObserverIfIdle() {
+  if (parentObserver && awaitingParent.size === 0) {
+    parentObserver.disconnect();
+    parentObserver = null;
+  }
+}
+function whenAnchorAttached(anchor, run) {
+  let cancelled = false;
+  queueMicrotask(() => {
+    if (cancelled) return;
+    if (anchor.parentNode) {
+      cancelled = true;
+      run();
+      return;
+    }
+    if (typeof MutationObserver === "undefined" || typeof document === "undefined") return;
+    awaitingParent.set(anchor, () => {
+      cancelled = true;
+      run();
+    });
+    if (!parentObserver) {
+      parentObserver = new MutationObserver(() => {
+        for (const [node, cb] of awaitingParent) {
+          if (!node.parentNode) continue;
+          awaitingParent.delete(node);
+          cb();
+        }
+        stopParentObserverIfIdle();
+      });
+      parentObserver.observe(document, { childList: true, subtree: true });
+    }
+  });
+  return () => {
+    if (cancelled) return;
+    cancelled = true;
+    awaitingParent.delete(anchor);
+    stopParentObserverIfIdle();
+  };
+}
+function attachRetry(anchor, rerun) {
+  const run = bindOwnerScope2(rerun);
+  let cancelWait = null;
+  return {
+    request: () => {
+      if (cancelWait) return;
+      cancelWait = whenAnchorAttached(anchor, () => {
+        cancelWait = null;
+        run();
+      });
+    },
+    cancel: () => {
+      cancelWait?.();
+      cancelWait = null;
+    }
+  };
+}
 function normalizeRoutes(routes) {
   return routes.map((route2) => {
     const normalizedChildren = route2.children && route2.children.length > 0 ? normalizeRoutes(route2.children) : route2.children;
@@ -4544,6 +4625,7 @@ function createRouter(routesOrOptions, options = {}) {
   }
   _routerRef.current = new SibuRouter(routes, options);
   ensureRouterPagehide();
+  setRouterRevision((n) => n + 1);
   return _routerRef.current;
 }
 function setRoutes(routes) {
@@ -4699,6 +4781,9 @@ function Route() {
   let currentKey = null;
   let routeTorn = false;
   const commitTarget = (seq) => routeTorn || seq !== navSeq ? null : anchor.parentNode;
+  const retryIfDetached = (seq) => {
+    if (!routeTorn && seq === navSeq && !anchor.parentNode) attachWait.request();
+  };
   const release = (node) => {
     if (!node) return;
     disposeOwned(node);
@@ -4781,6 +4866,7 @@ function Route() {
     anchor.parentNode.insertBefore(errorNode, anchor.nextSibling);
   };
   const update = async () => {
+    routerRevision();
     if (routeTorn || !_routerRef.current) return;
     const seq = ++navSeq;
     const route2 = scopedRoute(_routerRef.current);
@@ -4814,11 +4900,15 @@ function Route() {
             showLoading();
           }
           const plan = await _routerRef.current.loadPlan(routeDef, route2.path);
-          if (!commitTarget(seq)) return;
+          if (!commitTarget(seq)) {
+            retryIfDetached(seq);
+            return;
+          }
           const node = await instantiateScoped(_routerRef.current, plan, routeDef, route2.path, route2);
           const parent = commitTarget(seq);
           if (!parent) {
             release(node);
+            retryIfDetached(seq);
             return;
           }
           if (node) {
@@ -4832,15 +4922,31 @@ function Route() {
           if (routeTorn || seq !== navSeq) return;
           hideLoading();
           console.error("[Route] Component error:", error);
-          showError(error instanceof Error ? error : new Error(String(error)), routeDef);
+          fail(seq, error, routeDef);
         }
       }
     } catch (error) {
       if (seq !== navSeq) return;
       if (routeTorn) return;
       console.error("[Route] Update failed:", error);
-      showError(error instanceof Error ? error : new Error(String(error)));
+      fail(seq, error);
+    }
+  };
+  let unshownFailure = null;
+  const fail = (seq, error, routeDef) => {
+    const err = error instanceof Error ? error : new Error(String(error));
+    if (anchor.parentNode) {
+      showError(err, routeDef);
+      return;
     }
+    unshownFailure = { seq, error: err, routeDef };
+    attachWait.request();
+  };
+  const onAttached = () => {
+    const failure = unshownFailure;
+    unshownFailure = null;
+    if (failure && failure.seq === navSeq) showError(failure.error, failure.routeDef);
+    else update();
   };
   let routeInitialized = false;
   const originalUpdate = update;
@@ -4848,6 +4954,7 @@ function Route() {
     await originalUpdate();
     routeInitialized = true;
   };
+  const attachWait = attachRetry(anchor, onAttached);
   const routeTeardown = track2(wrappedUpdate);
   if (!routeInitialized) {
     queueMicrotask(
@@ -4861,6 +4968,8 @@ function Route() {
     routeTorn = true;
     navSeq++;
     routeTeardown();
+    attachWait.cancel();
+    unshownFailure = null;
     cleanupNodes();
     currentTopRoute = null;
     currentKey = null;
@@ -4884,6 +4993,7 @@ function KeepAliveRoute(options) {
   let updateSeq = 0;
   let kaTorn = false;
   const update = async () => {
+    routerRevision();
     if (kaTorn || !_routerRef.current) return;
     const seq = ++updateSeq;
     const router2 = _routerRef.current;
@@ -4901,13 +5011,16 @@ function KeepAliveRoute(options) {
       return;
     }
     if (!("component" in routeDef)) return;
-    const cacheKey = JSON.stringify([route2.path, queryIdentity(route2.query), route2.hash]);
+    const cacheKey = JSON.stringify([route2.path, queryIdentity(route2.queryAll), route2.hash]);
     const shouldCache = !includeNames || routeDef.name != null && includeNames.includes(routeDef.name);
     if (cacheKey === currentKey && currentNode) {
       updateInstanceRoute(currentNode, route2);
       return;
     }
-    if (!anchor.parentNode) return;
+    if (!anchor.parentNode) {
+      attachWait.request();
+      return;
+    }
     let node = null;
     let fromCache = false;
     if (shouldCache && cache.has(cacheKey)) {
@@ -4932,6 +5045,7 @@ function KeepAliveRoute(options) {
     const parent = anchor.parentNode;
     if (!parent) {
       if (!fromCache) disposeOwned(node);
+      attachWait.request();
       return;
     }
     if (currentNode && currentNode !== node) {
@@ -4970,6 +5084,7 @@ function KeepAliveRoute(options) {
     await update();
     initialized = true;
   };
+  const attachWait = attachRetry(anchor, update);
   const kaTeardown = track2(wrappedUpdate);
   if (!initialized) {
     queueMicrotask(
@@ -4983,6 +5098,7 @@ function KeepAliveRoute(options) {
     kaTorn = true;
     updateSeq++;
     kaTeardown();
+    attachWait.cancel();
     for (const node of cache.values()) {
       disposeOwned(node);
       if (node.parentNode) node.parentNode.removeChild(node);
@@ -5027,7 +5143,7 @@ function RouterLink(props, children) {
     const route2 = routeGetter();
     const currentPath = normalizePathname(route2.path);
     const isActive = kind === "internal" && isPathnameAncestor(targetPath, currentPath);
-    const isExactActive = kind === "internal" && currentPath === targetPath && queryIdentity(route2.query) === targetQuery && route2.hash === hrefHash;
+    const isExactActive = kind === "internal" && currentPath === targetPath && queryIdentity(route2.queryAll) === targetQuery && route2.hash === hrefHash;
     const classes = [];
     if (isActive) {
       if (activeClass) classes.push(activeClass);
@@ -5222,12 +5338,16 @@ function Outlet() {
     currentKey = null;
   };
   const commitTarget = (seq) => outletTorn || seq !== navSeq ? null : anchor.parentNode;
+  const retryIfDetached = (seq) => {
+    if (!outletTorn && seq === navSeq && !anchor.parentNode) attachWait.request();
+  };
   const release = (node) => {
     if (!node) return;
     disposeOwned(node);
     node.parentNode?.removeChild(node);
   };
   const update = async () => {
+    routerRevision();
     if (outletTorn || !_routerRef.current) return;
     const seq = ++navSeq;
     const route2 = scopedRoute(_routerRef.current);
@@ -5248,11 +5368,15 @@ function Outlet() {
     try {
       const cacheKey = `${route2.path}\0${childRoute.path}`;
       const plan = await _routerRef.current.loadPlan(childRoute, cacheKey);
-      if (!commitTarget(seq)) return;
+      if (!commitTarget(seq)) {
+        retryIfDetached(seq);
+        return;
+      }
       const node = await instantiateScoped(_routerRef.current, plan, childRoute, cacheKey, route2);
       const parent = commitTarget(seq);
       if (!parent) {
         release(node);
+        retryIfDetached(seq);
         return;
       }
       if (!node) return;
@@ -5266,6 +5390,7 @@ function Outlet() {
       console.error("[Outlet] Failed to render child route:", error);
     }
   };
+  const attachWait = attachRetry(anchor, update);
   const outletTeardown = track2(update);
   if (!anchor.parentNode) {
     queueMicrotask(
@@ -5279,6 +5404,7 @@ function Outlet() {
     outletTorn = true;
     navSeq++;
     outletTeardown();
+    attachWait.cancel();
     if (currentNode) {
       disposeOwned(currentNode);
       if (currentNode.parentNode) currentNode.parentNode.removeChild(currentNode);
@@ -5306,6 +5432,7 @@ function routerState() {
     currentPath: () => scopedRoute(router2).path,
     params: () => scopedRoute(router2).params,
     query: () => scopedRoute(router2).query,
+    queryAll: () => scopedRoute(router2).queryAll,
     hash: () => scopedRoute(router2).hash,
     meta: () => scopedRoute(router2).meta,
     isNavigating: () => router2.isNavigating,
@@ -6021,7 +6148,7 @@ var CDN_ENTRY_POINTS = {
 };
 var packageInfo = {
   name: "sibujs",
-  version: true ? "4.10.0" : "dev",
+  version: true ? "4.11.0" : "dev",
   entryPoints: MODULE_ENTRY_POINTS,
   /**
    * Generate the package.json `exports` map. Module entries resolve to the
@@ -6166,7 +6293,7 @@ var env = {
 };
 
 // src/plugins/versioning.ts
-var VERSION = true ? "4.10.0" : "dev";
+var VERSION = true ? "4.11.0" : "dev";
 var NUM = "(?:0|[1-9]\\d*)";
 var PRE_ID = `(?:${NUM}|\\d*[a-zA-Z-][0-9a-zA-Z-]*)`;
 var BUILD_ID = "[0-9a-zA-Z-]+";

package/dist/plugins.d.cts

@@ -177,16 +177,29 @@ type LazyComponent = () => Promise<{
     default: Component;
 }>;
 type Params = Record<string, string>;
+/** Every value of every query key, in URL order: `?tag=a&tag=b` is `{ tag: ["a", "b"] }`. */
+type QueryValues = Readonly<Record<string, readonly string[]>>;
+/**
+ * The query of a navigation object. An array value repeats its key once per
+ * value, in order: `{ tag: ["a", "b"] }` is `?tag=a&tag=b`.
+ */
+type NavigationQuery = Readonly<Record<string, string | readonly string[]>>;
 interface RouteContext {
     readonly path: string;
     readonly params: Params;
     /**
      * The decoded query (`+` is a space, `%XX` is decoded). A repeated key keeps
-     * its last value: `?tag=a&tag=b` is `{ tag: "b" }`. Two locations are the
-     * same route — for duplicate detection and `RouterLink` exact-active — when
-     * their queries have the same entries in any order.
+     * its last value here: `?tag=a&tag=b` is `{ tag: "b" }`. Read
+     * {@link RouteContext.queryAll} for every value.
      */
     readonly query: Params;
+    /**
+     * Every value of every query key, in URL order, with the same decoding as
+     * `query`: `?tag=a&tag=b` is `{ tag: ["a", "b"] }`. Two locations are the
+     * same route — for duplicate detection and `RouterLink` exact-active — when
+     * these match, key order aside.
+     */
+    readonly queryAll: QueryValues;
     readonly hash: string;
     readonly meta: RouteMeta;
     readonly matched: RouteDef[];
@@ -345,7 +358,7 @@ type NavigationTarget = string | {
     path?: string;
     name?: string;
     params?: Params;
-    query?: Params;
+    query?: NavigationQuery;
     hash?: string;
 };
 /**
@@ -812,6 +825,7 @@ declare function routerState(): {
     currentPath: () => string;
     params: () => Params;
     query: () => Params;
+    queryAll: () => QueryValues;
     hash: () => string;
     meta: () => RouteMeta;
     isNavigating: () => boolean;
@@ -960,4 +974,4 @@ declare function createSSRRouter(routes: SSRRouteDef[]): {
     }) => string;
 };
 
-export { type AsyncComponent, type AsyncRoute, type Component, type ComponentRoute, type Guard, type GuardResult, KeepAliveRoute, type LazyComponent, type LazyRoute, type NavigationFailure, type NavigationFailureReason, type NavigationGuard, type NavigationNext, type NavigationResult, type NavigationTarget, Outlet, type Params, type RedirectRoute, Route, type RouteBase, type RouteContext, type RouteDef, type RouteMeta, type RouteTransitionOptions, RouterLink, type RouterOptions, type RouterPlugin, type SSRRouteDef, type SSRRouteState, type ScrollBehavior, type ScrollPosition, SibuRouter, Suspense, Trans, type TranslationParams, __getNavigationEpoch, __removeRouterPagehideHandler, addRoute, afterEach, back, beforeEach, beforeResolve, buildURL, createMemoryRouter, createRouter, createSSRRouter, deserializeRouteState, destroyRouter, forward, getAvailableLocales, getLocale, getRouteInfo, getRouteTransition, go, hasRoute, hasTranslation, hydrateRouter, lazy, navigate, preloadRoute, push, registerTranslations, removeRoute, renderRouteToDocument, renderRouteToString, replace, resolveServerRoute, route, router, routerPlugin, routerState, serializeRouteState, setLocale, setRouteTransition, setRoutes, t, translated };
+export { type AsyncComponent, type AsyncRoute, type Component, type ComponentRoute, type Guard, type GuardResult, KeepAliveRoute, type LazyComponent, type LazyRoute, type NavigationFailure, type NavigationFailureReason, type NavigationGuard, type NavigationNext, type NavigationQuery, type NavigationResult, type NavigationTarget, Outlet, type Params, type QueryValues, type RedirectRoute, Route, type RouteBase, type RouteContext, type RouteDef, type RouteMeta, type RouteTransitionOptions, RouterLink, type RouterOptions, type RouterPlugin, type SSRRouteDef, type SSRRouteState, type ScrollBehavior, type ScrollPosition, SibuRouter, Suspense, Trans, type TranslationParams, __getNavigationEpoch, __removeRouterPagehideHandler, addRoute, afterEach, back, beforeEach, beforeResolve, buildURL, createMemoryRouter, createRouter, createSSRRouter, deserializeRouteState, destroyRouter, forward, getAvailableLocales, getLocale, getRouteInfo, getRouteTransition, go, hasRoute, hasTranslation, hydrateRouter, lazy, navigate, preloadRoute, push, registerTranslations, removeRoute, renderRouteToDocument, renderRouteToString, replace, resolveServerRoute, route, router, routerPlugin, routerState, serializeRouteState, setLocale, setRouteTransition, setRoutes, t, translated };

package/dist/plugins.d.ts

@@ -177,16 +177,29 @@ type LazyComponent = () => Promise<{
     default: Component;
 }>;
 type Params = Record<string, string>;
+/** Every value of every query key, in URL order: `?tag=a&tag=b` is `{ tag: ["a", "b"] }`. */
+type QueryValues = Readonly<Record<string, readonly string[]>>;
+/**
+ * The query of a navigation object. An array value repeats its key once per
+ * value, in order: `{ tag: ["a", "b"] }` is `?tag=a&tag=b`.
+ */
+type NavigationQuery = Readonly<Record<string, string | readonly string[]>>;
 interface RouteContext {
     readonly path: string;
     readonly params: Params;
     /**
      * The decoded query (`+` is a space, `%XX` is decoded). A repeated key keeps
-     * its last value: `?tag=a&tag=b` is `{ tag: "b" }`. Two locations are the
-     * same route — for duplicate detection and `RouterLink` exact-active — when
-     * their queries have the same entries in any order.
+     * its last value here: `?tag=a&tag=b` is `{ tag: "b" }`. Read
+     * {@link RouteContext.queryAll} for every value.
      */
     readonly query: Params;
+    /**
+     * Every value of every query key, in URL order, with the same decoding as
+     * `query`: `?tag=a&tag=b` is `{ tag: ["a", "b"] }`. Two locations are the
+     * same route — for duplicate detection and `RouterLink` exact-active — when
+     * these match, key order aside.
+     */
+    readonly queryAll: QueryValues;
     readonly hash: string;
     readonly meta: RouteMeta;
     readonly matched: RouteDef[];
@@ -345,7 +358,7 @@ type NavigationTarget = string | {
     path?: string;
     name?: string;
     params?: Params;
-    query?: Params;
+    query?: NavigationQuery;
     hash?: string;
 };
 /**
@@ -812,6 +825,7 @@ declare function routerState(): {
     currentPath: () => string;
     params: () => Params;
     query: () => Params;
+    queryAll: () => QueryValues;
     hash: () => string;
     meta: () => RouteMeta;
     isNavigating: () => boolean;
@@ -960,4 +974,4 @@ declare function createSSRRouter(routes: SSRRouteDef[]): {
     }) => string;
 };
 
-export { type AsyncComponent, type AsyncRoute, type Component, type ComponentRoute, type Guard, type GuardResult, KeepAliveRoute, type LazyComponent, type LazyRoute, type NavigationFailure, type NavigationFailureReason, type NavigationGuard, type NavigationNext, type NavigationResult, type NavigationTarget, Outlet, type Params, type RedirectRoute, Route, type RouteBase, type RouteContext, type RouteDef, type RouteMeta, type RouteTransitionOptions, RouterLink, type RouterOptions, type RouterPlugin, type SSRRouteDef, type SSRRouteState, type ScrollBehavior, type ScrollPosition, SibuRouter, Suspense, Trans, type TranslationParams, __getNavigationEpoch, __removeRouterPagehideHandler, addRoute, afterEach, back, beforeEach, beforeResolve, buildURL, createMemoryRouter, createRouter, createSSRRouter, deserializeRouteState, destroyRouter, forward, getAvailableLocales, getLocale, getRouteInfo, getRouteTransition, go, hasRoute, hasTranslation, hydrateRouter, lazy, navigate, preloadRoute, push, registerTranslations, removeRoute, renderRouteToDocument, renderRouteToString, replace, resolveServerRoute, route, router, routerPlugin, routerState, serializeRouteState, setLocale, setRouteTransition, setRoutes, t, translated };
+export { type AsyncComponent, type AsyncRoute, type Component, type ComponentRoute, type Guard, type GuardResult, KeepAliveRoute, type LazyComponent, type LazyRoute, type NavigationFailure, type NavigationFailureReason, type NavigationGuard, type NavigationNext, type NavigationQuery, type NavigationResult, type NavigationTarget, Outlet, type Params, type QueryValues, type RedirectRoute, Route, type RouteBase, type RouteContext, type RouteDef, type RouteMeta, type RouteTransitionOptions, RouterLink, type RouterOptions, type RouterPlugin, type SSRRouteDef, type SSRRouteState, type ScrollBehavior, type ScrollPosition, SibuRouter, Suspense, Trans, type TranslationParams, __getNavigationEpoch, __removeRouterPagehideHandler, addRoute, afterEach, back, beforeEach, beforeResolve, buildURL, createMemoryRouter, createRouter, createSSRRouter, deserializeRouteState, destroyRouter, forward, getAvailableLocales, getLocale, getRouteInfo, getRouteTransition, go, hasRoute, hasTranslation, hydrateRouter, lazy, navigate, preloadRoute, push, registerTranslations, removeRoute, renderRouteToDocument, renderRouteToString, replace, resolveServerRoute, route, router, routerPlugin, routerState, serializeRouteState, setLocale, setRouteTransition, setRoutes, t, translated };