sibujs 4.0.1 → 4.2.0

package/dist/plugins.d.cts

@@ -350,12 +350,34 @@ declare class SibuRouter {
      */
     get routeGetter(): () => RouteContext;
 }
+/**
+ * Create the global router and make it the one `route()`, `navigate()` and
+ * `RouterLink` talk to. Any previously created router is destroyed first.
+ *
+ * @param routesOrOptions Either the route table, or the options object when
+ * routes are supplied later via {@link setRoutes}.
+ * @param options Router options when the first argument is the route table.
+ * @returns The created router instance.
+ */
 declare function createRouter(routesOrOptions: RouteDef[] | RouterOptions, options?: RouterOptions): SibuRouter;
 /**
  * Set routes on the global router (replaces existing routes).
  */
 declare function setRoutes(routes: RouteDef[]): void;
+/**
+ * Read the current route as a plain snapshot.
+ *
+ * @returns The active {@link RouteContext} (path, params, query, hash).
+ * @throws If no router has been created yet.
+ */
 declare function route(): RouteContext;
+/**
+ * Handle onto the global router's navigation surface.
+ *
+ * @returns An object exposing the current route plus `push`, `replace`, `go`,
+ * `back`, `forward` and the three guard registrars.
+ * @throws If no router has been created yet.
+ */
 declare function router(): {
     currentRoute: RouteContext;
     isReady: boolean;
@@ -369,18 +391,81 @@ declare function router(): {
     beforeResolve: (guard: NavigationGuard) => (() => void) | undefined;
     afterEach: (hook: (to: RouteContext, from: RouteContext) => void) => (() => void) | undefined;
 };
+/**
+ * Navigate to a target, running every registered guard.
+ *
+ * @param to Path string or location descriptor.
+ * @param options `replace` swaps the current history entry instead of pushing;
+ * `state` is stored on the history entry.
+ * @returns A promise for the {@link NavigationResult} — resolved even when a
+ * guard cancels, so the outcome must be inspected rather than assumed.
+ * @throws If no router has been created yet.
+ */
 declare function navigate(to: NavigationTarget, options?: {
     replace?: boolean;
     state?: unknown;
 }): Promise<NavigationResult>;
+/**
+ * Navigate by pushing a new history entry.
+ *
+ * @param to Path string or location descriptor.
+ * @returns A promise for the {@link NavigationResult}.
+ */
 declare function push(to: NavigationTarget): Promise<NavigationResult>;
+/**
+ * Navigate by replacing the current history entry.
+ *
+ * @param to Path string or location descriptor.
+ * @returns A promise for the {@link NavigationResult}.
+ */
 declare function replace(to: NavigationTarget): Promise<NavigationResult>;
+/**
+ * Move through history by a relative offset, as `history.go` does.
+ *
+ * @param delta Number of entries to move; negative goes back.
+ * @returns Nothing — history moves asynchronously, so nothing is awaited here.
+ */
 declare function go(delta: number): void;
+/** Go back one history entry. Equivalent to `go(-1)`. */
 declare function back(): void;
+/** Go forward one history entry. Equivalent to `go(1)`. */
 declare function forward(): void;
+/**
+ * Register a guard that runs before every navigation is confirmed.
+ *
+ * @param guard Called with the target and current routes; return `false` to
+ * cancel, or a target to redirect.
+ * @returns An unregister function.
+ */
 declare function beforeEach(guard: NavigationGuard): () => void;
+/**
+ * Register a guard that runs after `beforeEach` and after async components have
+ * resolved, but before the route commits.
+ *
+ * @param guard Called with the target and current routes.
+ * @returns An unregister function.
+ */
 declare function beforeResolve(guard: NavigationGuard): () => void;
+/**
+ * Register a hook that runs after every confirmed navigation. It cannot cancel
+ * or redirect — by the time it runs the route has already committed.
+ *
+ * @param hook Called with the new and previous routes.
+ * @returns An unregister function.
+ */
 declare function afterEach(hook: (to: RouteContext, from: RouteContext) => void): () => void;
+/**
+ * The route outlet: renders whichever component matches the current route, and
+ * swaps it on every navigation.
+ *
+ * @returns A Comment anchor that manages the matched component. Like every
+ * factory here it hands back a live node the caller can insert directly.
+ *
+ * TRAP — a navigation REBUILDS the outlet's subtree, so focus and selection
+ * inside the outgoing route are discarded. The runtime restores focus when the
+ * incoming route contains an element with the same `id`, `name` or
+ * `data-focus-key`, and warns in dev when it cannot.
+ */
 declare function Route(): Node;
 /**
  * A route outlet that caches rendered components using KeepAlive.
@@ -497,6 +582,13 @@ declare function preloadRoute(to: NavigationTarget): Promise<void>;
  * must stay superseded.
  */
 declare function __getNavigationEpoch(): number;
+/**
+ * Whether a named route is registered.
+ *
+ * @param name The route's `name`.
+ * @returns `true` when a route with that name exists; `false` when it does not,
+ * and also when no router has been created yet.
+ */
 declare function hasRoute(name: string): boolean;
 /**
  * Gets route information by name

package/dist/plugins.d.ts

@@ -350,12 +350,34 @@ declare class SibuRouter {
      */
     get routeGetter(): () => RouteContext;
 }
+/**
+ * Create the global router and make it the one `route()`, `navigate()` and
+ * `RouterLink` talk to. Any previously created router is destroyed first.
+ *
+ * @param routesOrOptions Either the route table, or the options object when
+ * routes are supplied later via {@link setRoutes}.
+ * @param options Router options when the first argument is the route table.
+ * @returns The created router instance.
+ */
 declare function createRouter(routesOrOptions: RouteDef[] | RouterOptions, options?: RouterOptions): SibuRouter;
 /**
  * Set routes on the global router (replaces existing routes).
  */
 declare function setRoutes(routes: RouteDef[]): void;
+/**
+ * Read the current route as a plain snapshot.
+ *
+ * @returns The active {@link RouteContext} (path, params, query, hash).
+ * @throws If no router has been created yet.
+ */
 declare function route(): RouteContext;
+/**
+ * Handle onto the global router's navigation surface.
+ *
+ * @returns An object exposing the current route plus `push`, `replace`, `go`,
+ * `back`, `forward` and the three guard registrars.
+ * @throws If no router has been created yet.
+ */
 declare function router(): {
     currentRoute: RouteContext;
     isReady: boolean;
@@ -369,18 +391,81 @@ declare function router(): {
     beforeResolve: (guard: NavigationGuard) => (() => void) | undefined;
     afterEach: (hook: (to: RouteContext, from: RouteContext) => void) => (() => void) | undefined;
 };
+/**
+ * Navigate to a target, running every registered guard.
+ *
+ * @param to Path string or location descriptor.
+ * @param options `replace` swaps the current history entry instead of pushing;
+ * `state` is stored on the history entry.
+ * @returns A promise for the {@link NavigationResult} — resolved even when a
+ * guard cancels, so the outcome must be inspected rather than assumed.
+ * @throws If no router has been created yet.
+ */
 declare function navigate(to: NavigationTarget, options?: {
     replace?: boolean;
     state?: unknown;
 }): Promise<NavigationResult>;
+/**
+ * Navigate by pushing a new history entry.
+ *
+ * @param to Path string or location descriptor.
+ * @returns A promise for the {@link NavigationResult}.
+ */
 declare function push(to: NavigationTarget): Promise<NavigationResult>;
+/**
+ * Navigate by replacing the current history entry.
+ *
+ * @param to Path string or location descriptor.
+ * @returns A promise for the {@link NavigationResult}.
+ */
 declare function replace(to: NavigationTarget): Promise<NavigationResult>;
+/**
+ * Move through history by a relative offset, as `history.go` does.
+ *
+ * @param delta Number of entries to move; negative goes back.
+ * @returns Nothing — history moves asynchronously, so nothing is awaited here.
+ */
 declare function go(delta: number): void;
+/** Go back one history entry. Equivalent to `go(-1)`. */
 declare function back(): void;
+/** Go forward one history entry. Equivalent to `go(1)`. */
 declare function forward(): void;
+/**
+ * Register a guard that runs before every navigation is confirmed.
+ *
+ * @param guard Called with the target and current routes; return `false` to
+ * cancel, or a target to redirect.
+ * @returns An unregister function.
+ */
 declare function beforeEach(guard: NavigationGuard): () => void;
+/**
+ * Register a guard that runs after `beforeEach` and after async components have
+ * resolved, but before the route commits.
+ *
+ * @param guard Called with the target and current routes.
+ * @returns An unregister function.
+ */
 declare function beforeResolve(guard: NavigationGuard): () => void;
+/**
+ * Register a hook that runs after every confirmed navigation. It cannot cancel
+ * or redirect — by the time it runs the route has already committed.
+ *
+ * @param hook Called with the new and previous routes.
+ * @returns An unregister function.
+ */
 declare function afterEach(hook: (to: RouteContext, from: RouteContext) => void): () => void;
+/**
+ * The route outlet: renders whichever component matches the current route, and
+ * swaps it on every navigation.
+ *
+ * @returns A Comment anchor that manages the matched component. Like every
+ * factory here it hands back a live node the caller can insert directly.
+ *
+ * TRAP — a navigation REBUILDS the outlet's subtree, so focus and selection
+ * inside the outgoing route are discarded. The runtime restores focus when the
+ * incoming route contains an element with the same `id`, `name` or
+ * `data-focus-key`, and warns in dev when it cannot.
+ */
 declare function Route(): Node;
 /**
  * A route outlet that caches rendered components using KeepAlive.
@@ -497,6 +582,13 @@ declare function preloadRoute(to: NavigationTarget): Promise<void>;
  * must stay superseded.
  */
 declare function __getNavigationEpoch(): number;
+/**
+ * Whether a named route is registered.
+ *
+ * @param name The route's `name`.
+ * @returns `true` when a route with that name exists; `false` when it does not,
+ * and also when no router has been created yet.
+ */
 declare function hasRoute(name: string): boolean;
 /**
  * Gets route information by name

package/dist/plugins.js

@@ -18,7 +18,7 @@ import {
   preloadCritical,
   prerenderRoutes,
   satisfies
-} from "./chunk-AW6HPJ3L.js";
+} from "./chunk-KKLW7YWL.js";
 import {
   isUnsafeKey
 } from "./chunk-H3SRKIYX.js";
@@ -35,43 +35,45 @@ import {
 } from "./chunk-WWV3SJ3L.js";
 import {
   span
-} from "./chunk-E72G5JSK.js";
+} from "./chunk-P3DHXBR6.js";
 import {
   escapeScriptJson,
   renderToString,
   serializeHeadEntry
-} from "./chunk-HYCCIYNS.js";
-import "./chunk-QD4I7ZGZ.js";
-import "./chunk-PHRH66Y7.js";
+} from "./chunk-NIOYEGBQ.js";
+import {
+  resolveClassValue
+} from "./chunk-6ZGI3RBE.js";
+import "./chunk-HJEPKZ2O.js";
 import {
   isUrlAttribute,
   sanitizeStyleAttribute,
   sanitizeUrl,
   stripControlChars
-} from "./chunk-5INI7D2L.js";
+} from "./chunk-IXKSNWV5.js";
 import {
   globalSingleton
 } from "./chunk-7ZHH77QA.js";
 import {
   effect
-} from "./chunk-XDOMTQHM.js";
+} from "./chunk-7VEC3UD2.js";
 import {
   getRequestStore
-} from "./chunk-TIRZCERI.js";
+} from "./chunk-5DXA2J44.js";
 import {
   dispose,
   registerDisposer
-} from "./chunk-DHDZ7IVN.js";
+} from "./chunk-QKRPLZ2V.js";
 import {
   signal
-} from "./chunk-TVURNWDK.js";
+} from "./chunk-HECVW343.js";
 import {
   track
-} from "./chunk-JYXQCELN.js";
+} from "./chunk-7ALC7KGE.js";
 import {
   devWarn,
   isDev
-} from "./chunk-VPP2FONR.js";
+} from "./chunk-2WLZ6757.js";
 
 // src/plugins/i18n.ts
 var _i18n = globalSingleton(/* @__PURE__ */ Symbol.for("sibujs.i18n.v1"), () => ({
@@ -1591,7 +1593,6 @@ function RouterLink(props, children) {
   if (!_routerRef.current) throw new Error("Router not initialized. Call createRouter() first.");
   const { to, replace: replace2 = false, activeClass, exactActiveClass, nodes, target, rel, class: classAttr, ...attrs } = props;
   const content = children !== void 0 ? children : nodes;
-  const baseClass = typeof classAttr === "string" ? classAttr : "";
   const routeGetter = _routerRef.current.routeGetter;
   const rawHref = _routerRef.current["resolvePath"](to);
   const kind = classifyNavigationTarget(rawHref);
@@ -1627,7 +1628,7 @@ function RouterLink(props, children) {
       if (exactActiveClass) classes.push(exactActiveClass);
       else if (options.linkExactActiveClass) classes.push(options.linkExactActiveClass);
     }
-    link.className = [baseClass, ...classes].filter(Boolean).join(" ");
+    link.className = [resolveClassValue(classAttr), ...classes].filter(Boolean).join(" ");
   });
   registerDisposer(link, effectCleanup);
   Object.entries(attrs).forEach(([key, value]) => {
@@ -1639,7 +1640,7 @@ function RouterLink(props, children) {
         const safe = sanitizeUrl(str);
         if (safe) link.setAttribute(key, safe);
       } else if (lkey === "style") {
-        link.setAttribute(key, sanitizeStyleAttribute(str));
+        link.setAttribute(key, sanitizeStyleAttribute(str, { element: link }));
       } else {
         link.setAttribute(key, str);
       }
@@ -2191,8 +2192,8 @@ function hydrateRouter(routes, options) {
   const liveUrl = `${window.location.pathname}${window.location.search}${window.location.hash}`;
   const resolved = resolveServerRoute(liveUrl, routes);
   const bootstrapEpoch = __getNavigationEpoch();
-  import("./ssr-JFP5535P.js").then(async ({ hydrate }) => {
-    const { replaceChildrenSafely } = await import("./dispose-4FZ6OFXR.js");
+  import("./ssr-Y7XOEPEN.js").then(async ({ hydrate }) => {
+    const { replaceChildrenSafely } = await import("./dispose-46BOMMQJ.js");
     if (__getNavigationEpoch() !== bootstrapEpoch) return;
     if (resolved.component) {
       hydrate(resolved.component, container);

package/dist/{ssr-JFP5535P.js → ssr-Y7XOEPEN.js}

@@ -17,11 +17,11 @@ import {
   ssrSuspense,
   suspenseSwapScript,
   trustHTML
-} from "./chunk-HYCCIYNS.js";
-import "./chunk-5INI7D2L.js";
-import "./chunk-TIRZCERI.js";
-import "./chunk-DHDZ7IVN.js";
-import "./chunk-VPP2FONR.js";
+} from "./chunk-NIOYEGBQ.js";
+import "./chunk-IXKSNWV5.js";
+import "./chunk-5DXA2J44.js";
+import "./chunk-QKRPLZ2V.js";
+import "./chunk-2WLZ6757.js";
 export {
   collectStream,
   deserializeState,