sibujs 4.14.1 → 4.15.0

package/dist/plugins.d.cts

@@ -1,9 +1,11 @@
 export { L as LazyModule, M as Migration, a as MigrationStorageError, P as PackageExportTarget, S as SemVer, V as VERSION, b as bundlerMetadata, c as checkCompatibility, d as compareSemVer, e as createBootSequence, f as createBundle, g as createMigrationRunner, h as createModuleRegistry, i as createSSRCache, j as createTestHarness, k as deferNonCritical, l as env, m as healthCheck, n as lazyModule, p as packageInfo, o as parseSemVer, q as preloadCritical, r as prerenderRoutes, s as satisfies } from './startup-BLfSeL15.cjs';
 import { A as Accessor } from './signal-EotCj4hS.cjs';
 export { P as PluginContext, a as PluginInstallCancelledError, b as PluginRegistry, S as SibuPlugin, c as createPlugin, d as createPluginRegistry, i as inject, e as isPluginInstallCancelledError, p as plugin, r as resetPlugins, s as setDefaultPluginRegistry, t as triggerPluginError, f as triggerPluginMount, g as triggerPluginUnmount } from './plugin-DVgSnTfK.cjs';
-export { A as AsyncComponent, b as AsyncRoute, C as Component, c as ComponentRoute, G as Guard, d as GuardResult, J as JsonLd, K as KeepAliveRoute, L as LazyComponent, e as LazyRoute, N as NavigationFailure, f as NavigationFailureReason, g as NavigationGuard, h as NavigationNext, i as NavigationQuery, j as NavigationResult, k as NavigationTarget, O as Outlet, P as Params, Q as QueryValues, l as RedirectRoute, m as ResolvedHeadTag, n as ResolvedRouteHead, o as Route, p as RouteBase, q as RouteContext, a as RouteDef, r as RouteHead, s as RouteHeadAlternate, t as RouteHeadOpenGraph, u as RouteHeadTwitter, v as RouteHeadValue, w as RouteMeta, x as RouteTransitionOptions, y as RouterHeadOptions, z as RouterLink, R as RouterOptions, B as RouterPlugin, S as ScrollBehavior, D as ScrollPosition, E as SibuRouter, F as Suspense, _ as __getNavigationEpoch, H as __removeRouterPagehideHandler, I as addRoute, M as afterEach, T as back, U as beforeEach, V as beforeResolve, W as buildURL, X as createMemoryRouter, Y as createRouter, Z as destroyRouter, $ as forward, a0 as getRouteInfo, a1 as getRouteTransition, a2 as go, a3 as hasRoute, a4 as jsonLdScript, a5 as lazy, a6 as navigate, a7 as preloadRoute, a8 as push, a9 as removeRoute, aa as replace, ab as resolveRouteHead, ac as route, ad as routeHeadToHTML, ae as router, af as routerPlugin, ag as routerReady, ah as routerState, ai as serializeJsonLd, aj as setRouteTransition, ak as setRoutes } from './routeHead-CE9SV-cH.cjs';
+export { A as AsyncComponent, b as AsyncRoute, C as Component, c as ComponentRoute, G as Guard, d as GuardResult, J as JsonLd, K as KeepAliveRoute, L as LazyComponent, e as LazyRoute, N as NavigationFailure, f as NavigationFailureReason, g as NavigationGuard, h as NavigationNext, i as NavigationQuery, j as NavigationResult, k as NavigationTarget, O as Outlet, P as Params, Q as QueryValues, l as RedirectRoute, m as ResolvedHeadTag, n as ResolvedRouteHead, o as Route, p as RouteBase, q as RouteContext, a as RouteDef, r as RouteHead, s as RouteHeadAlternate, t as RouteHeadOpenGraph, u as RouteHeadTwitter, v as RouteHeadValue, w as RouteMeta, x as RouteTransitionOptions, y as RouterHeadOptions, z as RouterLink, R as RouterOptions, B as RouterPlugin, S as ScrollBehavior, D as ScrollPosition, E as SibuRouter, F as Suspense, _ as __getNavigationEpoch, H as __removeRouterPagehideHandler, I as addRoute, M as afterEach, T as back, U as beforeEach, V as beforeResolve, W as buildURL, X as createMemoryRouter, Y as createRouter, Z as destroyRouter, $ as forward, a0 as getRouteInfo, a1 as getRouteTransition, a2 as go, a3 as hasRoute, a4 as jsonLdScript, a5 as lazy, a6 as navigate, a7 as preloadRoute, a8 as push, a9 as removeRoute, aa as replace, ab as resolveRouteHead, ac as route, ad as routeHeadToHTML, ae as router, af as routerPlugin, ag as routerReady, ah as routerState, ai as serializeJsonLd, aj as setRouteTransition, ak as setRoutes } from './routeHead-DLxlq15W.cjs';
 import { T as TrustedHTML } from './ssr-JpGpHnpC.cjs';
 import './types-CJFViL6Q.cjs';
+import './track-core-DN5fYLWi.cjs';
+import './signal-BnWpq6WB.cjs';
 
 type Translations = Record<string, string>;
 /**

package/dist/plugins.d.ts

@@ -1,9 +1,11 @@
 export { L as LazyModule, M as Migration, a as MigrationStorageError, P as PackageExportTarget, S as SemVer, V as VERSION, b as bundlerMetadata, c as checkCompatibility, d as compareSemVer, e as createBootSequence, f as createBundle, g as createMigrationRunner, h as createModuleRegistry, i as createSSRCache, j as createTestHarness, k as deferNonCritical, l as env, m as healthCheck, n as lazyModule, p as packageInfo, o as parseSemVer, q as preloadCritical, r as prerenderRoutes, s as satisfies } from './startup-BLfSeL15.js';
 import { A as Accessor } from './signal-EotCj4hS.js';
 export { P as PluginContext, a as PluginInstallCancelledError, b as PluginRegistry, S as SibuPlugin, c as createPlugin, d as createPluginRegistry, i as inject, e as isPluginInstallCancelledError, p as plugin, r as resetPlugins, s as setDefaultPluginRegistry, t as triggerPluginError, f as triggerPluginMount, g as triggerPluginUnmount } from './plugin-DVgSnTfK.js';
-export { A as AsyncComponent, b as AsyncRoute, C as Component, c as ComponentRoute, G as Guard, d as GuardResult, J as JsonLd, K as KeepAliveRoute, L as LazyComponent, e as LazyRoute, N as NavigationFailure, f as NavigationFailureReason, g as NavigationGuard, h as NavigationNext, i as NavigationQuery, j as NavigationResult, k as NavigationTarget, O as Outlet, P as Params, Q as QueryValues, l as RedirectRoute, m as ResolvedHeadTag, n as ResolvedRouteHead, o as Route, p as RouteBase, q as RouteContext, a as RouteDef, r as RouteHead, s as RouteHeadAlternate, t as RouteHeadOpenGraph, u as RouteHeadTwitter, v as RouteHeadValue, w as RouteMeta, x as RouteTransitionOptions, y as RouterHeadOptions, z as RouterLink, R as RouterOptions, B as RouterPlugin, S as ScrollBehavior, D as ScrollPosition, E as SibuRouter, F as Suspense, _ as __getNavigationEpoch, H as __removeRouterPagehideHandler, I as addRoute, M as afterEach, T as back, U as beforeEach, V as beforeResolve, W as buildURL, X as createMemoryRouter, Y as createRouter, Z as destroyRouter, $ as forward, a0 as getRouteInfo, a1 as getRouteTransition, a2 as go, a3 as hasRoute, a4 as jsonLdScript, a5 as lazy, a6 as navigate, a7 as preloadRoute, a8 as push, a9 as removeRoute, aa as replace, ab as resolveRouteHead, ac as route, ad as routeHeadToHTML, ae as router, af as routerPlugin, ag as routerReady, ah as routerState, ai as serializeJsonLd, aj as setRouteTransition, ak as setRoutes } from './routeHead-DzVxPviY.js';
+export { A as AsyncComponent, b as AsyncRoute, C as Component, c as ComponentRoute, G as Guard, d as GuardResult, J as JsonLd, K as KeepAliveRoute, L as LazyComponent, e as LazyRoute, N as NavigationFailure, f as NavigationFailureReason, g as NavigationGuard, h as NavigationNext, i as NavigationQuery, j as NavigationResult, k as NavigationTarget, O as Outlet, P as Params, Q as QueryValues, l as RedirectRoute, m as ResolvedHeadTag, n as ResolvedRouteHead, o as Route, p as RouteBase, q as RouteContext, a as RouteDef, r as RouteHead, s as RouteHeadAlternate, t as RouteHeadOpenGraph, u as RouteHeadTwitter, v as RouteHeadValue, w as RouteMeta, x as RouteTransitionOptions, y as RouterHeadOptions, z as RouterLink, R as RouterOptions, B as RouterPlugin, S as ScrollBehavior, D as ScrollPosition, E as SibuRouter, F as Suspense, _ as __getNavigationEpoch, H as __removeRouterPagehideHandler, I as addRoute, M as afterEach, T as back, U as beforeEach, V as beforeResolve, W as buildURL, X as createMemoryRouter, Y as createRouter, Z as destroyRouter, $ as forward, a0 as getRouteInfo, a1 as getRouteTransition, a2 as go, a3 as hasRoute, a4 as jsonLdScript, a5 as lazy, a6 as navigate, a7 as preloadRoute, a8 as push, a9 as removeRoute, aa as replace, ab as resolveRouteHead, ac as route, ad as routeHeadToHTML, ae as router, af as routerPlugin, ag as routerReady, ah as routerState, ai as serializeJsonLd, aj as setRouteTransition, ak as setRoutes } from './routeHead-w8nANZ3M.js';
 import { T as TrustedHTML } from './ssr-JpGpHnpC.js';
 import './types-CJFViL6Q.js';
+import './track-core-0edROAF5.js';
+import './signal-BnWpq6WB.js';
 
 type Translations = Record<string, string>;
 /**

package/dist/plugins.js

@@ -38,7 +38,7 @@ import {
   serializeJsonLd,
   setRouteTransition,
   setRoutes
-} from "./chunk-L2IPKGUJ.js";
+} from "./chunk-EHSJESRN.js";
 import {
   MigrationStorageError,
   VERSION,
@@ -60,8 +60,8 @@ import {
   preloadCritical,
   prerenderRoutes,
   satisfies
-} from "./chunk-VIAVYBNQ.js";
-import "./chunk-52XFPGSN.js";
+} from "./chunk-6IV5ZRG6.js";
+import "./chunk-HTPOIAAL.js";
 import {
   PluginInstallCancelledError,
   createPlugin,
@@ -74,29 +74,28 @@ import {
   triggerPluginError,
   triggerPluginMount,
   triggerPluginUnmount
-} from "./chunk-3HEX6QJQ.js";
+} from "./chunk-I2R5QALY.js";
+import "./chunk-DS5V2PRE.js";
 import {
   span
-} from "./chunk-YPLQQTWS.js";
+} from "./chunk-4AEFGRYW.js";
 import {
   escapeScriptJson,
   renderToString,
   serializeHeadEntry
-} from "./chunk-TOV4PN3P.js";
-import "./chunk-YIXMS546.js";
-import "./chunk-LJMX4SQ7.js";
+} from "./chunk-DRWOD7RZ.js";
+import "./chunk-MINLMJUY.js";
+import "./chunk-BG4BP44S.js";
 import "./chunk-3HZOSMPX.js";
 import {
   isUnsafeKey,
   readOwnGlobal
 } from "./chunk-62BDYGAG.js";
-import "./chunk-ZKI4SDZ2.js";
-import "./chunk-3T7TWMSD.js";
+import "./chunk-VSTX3XSX.js";
+import "./chunk-DNCQDFJJ.js";
+import "./chunk-XPDZ2LDR.js";
 import "./chunk-RVWJGWCL.js";
-import {
-  globalSingleton
-} from "./chunk-7ZHH77QA.js";
-import "./chunk-FFXZ6ELZ.js";
+import "./chunk-LGUXYHTZ.js";
 import {
   sanitizeUrl
 } from "./chunk-B3HOT4TK.js";
@@ -106,9 +105,11 @@ import {
 import "./chunk-5HZXGZ6T.js";
 import {
   signal
-} from "./chunk-FCWOMATN.js";
-import "./chunk-LAHX7XFG.js";
-import "./chunk-S37PZD6I.js";
+} from "./chunk-IUBV5WO5.js";
+import "./chunk-GFM5WWPU.js";
+import {
+  globalSingleton
+} from "./chunk-BF3WBJJQ.js";
 import "./chunk-NT3ZYB5S.js";
 import "./chunk-R5U7XKVJ.js";
 
@@ -430,8 +431,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-HHU3DAD2.js").then(async ({ hydrate }) => {
-    const { replaceChildrenSafely } = await import("./dispose-EIHHHDC7.js");
+  import("./ssr-EF3IUHTE.js").then(async ({ hydrate }) => {
+    const { replaceChildrenSafely } = await import("./dispose-3WDBYJMH.js");
     if (__getNavigationEpoch() !== bootstrapEpoch) return;
     if (resolved.component) {
       hydrate(resolved.component, container);

package/dist/{renderRoute-fxgsm2Ir.d.ts → renderRoute-B84MONaO.d.cts}

@@ -1,5 +1,5 @@
-import { R as RouterOptions, a as RouteDef } from './routeHead-DzVxPviY.js';
-import { A as AsyncRenderOptions, D as DocumentOptions, R as RenderResult } from './ssr-JpGpHnpC.js';
+import { R as RouterOptions, a as RouteDef } from './routeHead-DLxlq15W.cjs';
+import { A as AsyncRenderOptions, D as DocumentOptions, R as RenderResult } from './ssr-JpGpHnpC.cjs';
 
 /** How a route is treated by server renders (see `RouteBase.render`); `"default"` when no record declares one. */
 type RouteRenderMode = "ssr" | "prerender" | "client" | "default";

package/dist/{renderRoute-DP20XwMS.d.cts → renderRoute-_yxPuEQY.d.ts}

@@ -1,5 +1,5 @@
-import { R as RouterOptions, a as RouteDef } from './routeHead-CE9SV-cH.cjs';
-import { A as AsyncRenderOptions, D as DocumentOptions, R as RenderResult } from './ssr-JpGpHnpC.cjs';
+import { R as RouterOptions, a as RouteDef } from './routeHead-w8nANZ3M.js';
+import { A as AsyncRenderOptions, D as DocumentOptions, R as RenderResult } from './ssr-JpGpHnpC.js';
 
 /** How a route is treated by server renders (see `RouteBase.render`); `"default"` when no record declares one. */
 type RouteRenderMode = "ssr" | "prerender" | "client" | "default";

package/dist/{routeHead-CE9SV-cH.d.cts → routeHead-DLxlq15W.d.cts}

@@ -1,4 +1,5 @@
 import { C as Component$1, N as NodeChildren } from './types-CJFViL6Q.cjs';
+import { H as HeldCheck, S as StructuralBinding } from './track-core-DN5fYLWi.cjs';
 
 /**
  * Creation scopes for adopting hydration (see docs/architecture/hydration-adopt.md).
@@ -363,12 +364,24 @@ declare class SibuRouter {
     private handleLocationChange;
     private getCurrentPath;
     private createRouteContext;
+    /**
+     * Once no navigation is in flight: if the route is still the placeholder
+     * the router started with — every navigation that could have replaced it
+     * was cancelled by a guard, failed, or was a duplicate — that IS the
+     * outcome, and the outlets that rendered nothing for it settle (see
+     * `settleEmpty`). Checked when a navigation has definitively completed,
+     * never from `isReady` (set before the guards run). A navigation still
+     * pending — a newer one, or a guard that never resolves — keeps them
+     * pending; an outlet's enter is bounded by its own deadline then.
+     */
+    private settleBootstrap;
     navigate(to: NavigationTarget, options?: {
         replace?: boolean;
         state?: unknown;
         skipHistory?: boolean;
         initialResolution?: boolean;
     }): Promise<NavigationResult>;
+    private attemptNavigation;
     private static readonly MAX_REDIRECT_DEPTH;
     private performNavigation;
     private updateHead;
@@ -403,6 +416,13 @@ declare class SibuRouter {
     /**
      * Create exactly one real instance from an already-resolved plan. With a
      * `scope`, the factory runs in it (see `RouteScope`).
+     *
+     * When the scope belongs to an outlet whose branch is paused (playing a
+     * leave it may still be taken back from), a lazy module that resolves does
+     * not run its factory yet: the promise stays pending and continues once the
+     * branch resumes. If the branch ends, or the outlet's pass was superseded
+     * meanwhile, it rejects with a `DOMException` named `"AbortError"`. Genuine
+     * loader and component failures reject with their own error, as before.
      */
     instantiateComponent(plan: RoutePlan, route: RouteDef, routePath: string, scope?: RouteScope): Promise<Element>;
     /** Resolve a route's module/factory without creating any component instance. */
@@ -480,6 +500,21 @@ declare function setRoutes(routes: RouteDef[]): void;
 declare class RouteScope {
     /** Creation scope the instance is built in (adopting hydration); see `adoptScope`. */
     adopt: AdoptScope | null;
+    /**
+     * The outlet's pause gate: while the branch holding the outlet is paused (it
+     * began a leave and may still be taken back), a lazy module that resolves
+     * does not get its factory invoked yet; instantiation waits for the branch
+     * to resume, and is cancelled if it ends.
+     */
+    gate: PauseGate | null;
+    /** Whether the outlet pass this instance is for is still the current one. */
+    current: (() => boolean) | null;
+    /**
+     * The instance's structural owner, nested under the outlet's: its factory
+     * runs as it, so what it creates is paused with the branch holding the
+     * outlet, and ends (`lifecycleScope()` work included) with the instance.
+     */
+    owner: StructuralBinding | null;
     private readonly get;
     private readonly set;
     private released;
@@ -497,6 +532,28 @@ declare class RouteScope {
      */
     release(): void;
 }
+/**
+ * Async work an outlet does on behalf of the branch holding it, gated on that
+ * branch's lifecycle (see `captureFrozen`): `until()` resolves `true` once the
+ * branch is active, `false` once it ended or the outlet was torn down
+ * (`close`). Driven by the runtime's resume / end notifications — no polling.
+ */
+interface PauseGate {
+    /** The branch is paused or ended: gated work must not run now. */
+    held(): boolean;
+    until(): Promise<boolean>;
+    /** The error an instantiation cancelled by this gate rejects with. */
+    cancellation(): DOMException;
+    close(): void;
+    /** Run `fn` as the branch's structural owner (see `HeldCheck.run`). */
+    run<T>(fn: () => T): T;
+    /** The branch's lifecycle. */
+    frozen: HeldCheck;
+    /** Whether `close()` was called. */
+    closed(): boolean;
+    /** Call `fn` on `close()`, unless the returned function was called first. */
+    onClose(fn: () => void): () => void;
+}
 /**
  * Read the current route as a plain snapshot.
  *
@@ -660,6 +717,41 @@ declare function Route(): Node;
  * | excluded by `include` | never cached; disposed on navigation away |
  * | outlet disposed | whole cache disposed and cleared |
  *
+ * ## Inactive pages: live by default, suspended on request
+ *
+ * By default a cached page stays live while it is hidden: its bindings,
+ * effects and async work keep running against the current state. With
+ * `suspendInactive: true` a page is PAUSED when it is cached and resumed when
+ * it is shown again — the same pause a leaving `when()` branch gets:
+ *
+ * - its DOM, local state, form values and route context are kept as they are
+ *   (nothing is disposed or rebuilt);
+ * - its bindings, effects created while it rendered, and `lifecycleScope()`
+ *   work do not run; what changed meanwhile is caught up in ONE run when it
+ *   is shown, against the current state and the route it is shown for;
+ * - async work it owns (a `Suspense` result, a nested outlet's page, a core
+ *   `lazy()` component) is held, not committed, until then;
+ * - a page shown inside a branch that is itself paused stays paused until
+ *   that branch resumes;
+ * - eviction and outlet disposal end a suspended page without a catch-up run
+ *   for what the page owns: its DOM bindings, `lifecycleScope()` work, and
+ *   effects whose disposal is tied to the page (`scope.effect()`, an effect
+ *   whose stop is registered on one of its nodes).
+ *
+ * A plain `effect()` created while the page rendered pauses with it, but
+ * nothing disposes it: the page never returned its stop function to anyone.
+ * When the page is evicted it is no longer paused, so it runs ONE catch-up
+ * against the current state and stays subscribed, re-running on later
+ * changes like any unowned effect (as it would have kept doing without
+ * `suspendInactive`). Create such work with `scope.effect()`, or register its
+ * stop on a node of the page, when eviction must end it.
+ *
+ * Only the framework's reactive work pauses. Timers, sockets, media and
+ * requests keep going unless the page stops them: capture a
+ * `lifecycleScope()` while it renders and use `scope.onPause()` /
+ * `scope.onResume()` (called in the page's own route context). Pages that
+ * are not cached are disposed as before.
+ *
  * ## Cache identity is not async ownership
  *
  * The cache key answers *"which cached view is this?"*. It never answers *"may
@@ -686,6 +778,8 @@ declare function Route(): Node;
 declare function KeepAliveRoute(options?: {
     max?: number;
     include?: string[];
+    /** Pause a cached page while it is hidden (see above). Default `false`. */
+    suspendInactive?: boolean;
 }): Node;
 declare function RouterLink(props: {
     to: NavigationTarget;

package/dist/{routeHead-DzVxPviY.d.ts → routeHead-w8nANZ3M.d.ts}

@@ -1,4 +1,5 @@
 import { C as Component$1, N as NodeChildren } from './types-CJFViL6Q.js';
+import { H as HeldCheck, S as StructuralBinding } from './track-core-0edROAF5.js';
 
 /**
  * Creation scopes for adopting hydration (see docs/architecture/hydration-adopt.md).
@@ -363,12 +364,24 @@ declare class SibuRouter {
     private handleLocationChange;
     private getCurrentPath;
     private createRouteContext;
+    /**
+     * Once no navigation is in flight: if the route is still the placeholder
+     * the router started with — every navigation that could have replaced it
+     * was cancelled by a guard, failed, or was a duplicate — that IS the
+     * outcome, and the outlets that rendered nothing for it settle (see
+     * `settleEmpty`). Checked when a navigation has definitively completed,
+     * never from `isReady` (set before the guards run). A navigation still
+     * pending — a newer one, or a guard that never resolves — keeps them
+     * pending; an outlet's enter is bounded by its own deadline then.
+     */
+    private settleBootstrap;
     navigate(to: NavigationTarget, options?: {
         replace?: boolean;
         state?: unknown;
         skipHistory?: boolean;
         initialResolution?: boolean;
     }): Promise<NavigationResult>;
+    private attemptNavigation;
     private static readonly MAX_REDIRECT_DEPTH;
     private performNavigation;
     private updateHead;
@@ -403,6 +416,13 @@ declare class SibuRouter {
     /**
      * Create exactly one real instance from an already-resolved plan. With a
      * `scope`, the factory runs in it (see `RouteScope`).
+     *
+     * When the scope belongs to an outlet whose branch is paused (playing a
+     * leave it may still be taken back from), a lazy module that resolves does
+     * not run its factory yet: the promise stays pending and continues once the
+     * branch resumes. If the branch ends, or the outlet's pass was superseded
+     * meanwhile, it rejects with a `DOMException` named `"AbortError"`. Genuine
+     * loader and component failures reject with their own error, as before.
      */
     instantiateComponent(plan: RoutePlan, route: RouteDef, routePath: string, scope?: RouteScope): Promise<Element>;
     /** Resolve a route's module/factory without creating any component instance. */
@@ -480,6 +500,21 @@ declare function setRoutes(routes: RouteDef[]): void;
 declare class RouteScope {
     /** Creation scope the instance is built in (adopting hydration); see `adoptScope`. */
     adopt: AdoptScope | null;
+    /**
+     * The outlet's pause gate: while the branch holding the outlet is paused (it
+     * began a leave and may still be taken back), a lazy module that resolves
+     * does not get its factory invoked yet; instantiation waits for the branch
+     * to resume, and is cancelled if it ends.
+     */
+    gate: PauseGate | null;
+    /** Whether the outlet pass this instance is for is still the current one. */
+    current: (() => boolean) | null;
+    /**
+     * The instance's structural owner, nested under the outlet's: its factory
+     * runs as it, so what it creates is paused with the branch holding the
+     * outlet, and ends (`lifecycleScope()` work included) with the instance.
+     */
+    owner: StructuralBinding | null;
     private readonly get;
     private readonly set;
     private released;
@@ -497,6 +532,28 @@ declare class RouteScope {
      */
     release(): void;
 }
+/**
+ * Async work an outlet does on behalf of the branch holding it, gated on that
+ * branch's lifecycle (see `captureFrozen`): `until()` resolves `true` once the
+ * branch is active, `false` once it ended or the outlet was torn down
+ * (`close`). Driven by the runtime's resume / end notifications — no polling.
+ */
+interface PauseGate {
+    /** The branch is paused or ended: gated work must not run now. */
+    held(): boolean;
+    until(): Promise<boolean>;
+    /** The error an instantiation cancelled by this gate rejects with. */
+    cancellation(): DOMException;
+    close(): void;
+    /** Run `fn` as the branch's structural owner (see `HeldCheck.run`). */
+    run<T>(fn: () => T): T;
+    /** The branch's lifecycle. */
+    frozen: HeldCheck;
+    /** Whether `close()` was called. */
+    closed(): boolean;
+    /** Call `fn` on `close()`, unless the returned function was called first. */
+    onClose(fn: () => void): () => void;
+}
 /**
  * Read the current route as a plain snapshot.
  *
@@ -660,6 +717,41 @@ declare function Route(): Node;
  * | excluded by `include` | never cached; disposed on navigation away |
  * | outlet disposed | whole cache disposed and cleared |
  *
+ * ## Inactive pages: live by default, suspended on request
+ *
+ * By default a cached page stays live while it is hidden: its bindings,
+ * effects and async work keep running against the current state. With
+ * `suspendInactive: true` a page is PAUSED when it is cached and resumed when
+ * it is shown again — the same pause a leaving `when()` branch gets:
+ *
+ * - its DOM, local state, form values and route context are kept as they are
+ *   (nothing is disposed or rebuilt);
+ * - its bindings, effects created while it rendered, and `lifecycleScope()`
+ *   work do not run; what changed meanwhile is caught up in ONE run when it
+ *   is shown, against the current state and the route it is shown for;
+ * - async work it owns (a `Suspense` result, a nested outlet's page, a core
+ *   `lazy()` component) is held, not committed, until then;
+ * - a page shown inside a branch that is itself paused stays paused until
+ *   that branch resumes;
+ * - eviction and outlet disposal end a suspended page without a catch-up run
+ *   for what the page owns: its DOM bindings, `lifecycleScope()` work, and
+ *   effects whose disposal is tied to the page (`scope.effect()`, an effect
+ *   whose stop is registered on one of its nodes).
+ *
+ * A plain `effect()` created while the page rendered pauses with it, but
+ * nothing disposes it: the page never returned its stop function to anyone.
+ * When the page is evicted it is no longer paused, so it runs ONE catch-up
+ * against the current state and stays subscribed, re-running on later
+ * changes like any unowned effect (as it would have kept doing without
+ * `suspendInactive`). Create such work with `scope.effect()`, or register its
+ * stop on a node of the page, when eviction must end it.
+ *
+ * Only the framework's reactive work pauses. Timers, sockets, media and
+ * requests keep going unless the page stops them: capture a
+ * `lifecycleScope()` while it renders and use `scope.onPause()` /
+ * `scope.onResume()` (called in the page's own route context). Pages that
+ * are not cached are disposed as before.
+ *
  * ## Cache identity is not async ownership
  *
  * The cache key answers *"which cached view is this?"*. It never answers *"may
@@ -686,6 +778,8 @@ declare function Route(): Node;
 declare function KeepAliveRoute(options?: {
     max?: number;
     include?: string[];
+    /** Pause a cached page while it is hidden (see above). Default `false`. */
+    suspendInactive?: boolean;
 }): Node;
 declare function RouterLink(props: {
     to: NavigationTarget;

package/dist/{ssr-HHU3DAD2.js → ssr-EF3IUHTE.js}

@@ -19,17 +19,17 @@ import {
   ssrSuspense,
   suspenseSwapScript,
   trustHTML
-} from "./chunk-TOV4PN3P.js";
-import "./chunk-YIXMS546.js";
-import "./chunk-LJMX4SQ7.js";
+} from "./chunk-DRWOD7RZ.js";
+import "./chunk-MINLMJUY.js";
+import "./chunk-BG4BP44S.js";
 import "./chunk-3HZOSMPX.js";
 import "./chunk-62BDYGAG.js";
+import "./chunk-DNCQDFJJ.js";
 import "./chunk-RVWJGWCL.js";
-import "./chunk-7ZHH77QA.js";
 import "./chunk-B3HOT4TK.js";
 import "./chunk-UYTYNCMZ.js";
-import "./chunk-LAHX7XFG.js";
-import "./chunk-S37PZD6I.js";
+import "./chunk-GFM5WWPU.js";
+import "./chunk-BF3WBJJQ.js";
 import "./chunk-NT3ZYB5S.js";
 import "./chunk-R5U7XKVJ.js";
 export {

package/dist/ssr-dom.cjs

@@ -77,6 +77,25 @@ function requestSlot(name, create) {
   return slots.get(name);
 }
 
+// src/utils/styleKey.ts
+var EXCEPTIONS = { cssFloat: "float" };
+var VENDOR_PREFIX = /^(webkit|moz|ms|o)-/;
+var cache = /* @__PURE__ */ new Map();
+var CACHE_MAX = 1e3;
+function styleKeyToProperty(key) {
+  let name = cache.get(key);
+  if (name !== void 0) return name;
+  if (key.startsWith("--")) name = key;
+  else if (Object.hasOwn(EXCEPTIONS, key)) name = EXCEPTIONS[key];
+  else {
+    name = key.replace(/[A-Z]/g, (m) => `-${m.toLowerCase()}`);
+    if (VENDOR_PREFIX.test(name)) name = `-${name}`;
+  }
+  if (cache.size >= CACHE_MAX) cache.clear();
+  cache.set(key, name);
+  return name;
+}
+
 // src/platform/serverDom.ts
 var HTML_NS = "http://www.w3.org/1999/xhtml";
 var SVG_NS = "http://www.w3.org/2000/svg";
@@ -752,12 +771,6 @@ function splitDeclarations(text) {
   out.push(text.slice(start));
   return out;
 }
-var CAMEL_EXCEPTIONS = { cssFloat: "float" };
-function toKebab(prop) {
-  if (prop.startsWith("--")) return prop;
-  if (Object.hasOwn(CAMEL_EXCEPTIONS, prop)) return CAMEL_EXCEPTIONS[prop];
-  return prop.replace(/[A-Z]/g, (m) => `-${m.toLowerCase()}`).replace(/^(webkit|moz|ms)-/, "-$1-");
-}
 var ServerStyle = class {
   constructor(el) {
     this.el = el;
@@ -852,13 +865,13 @@ function styleProxy(style) {
     get(target, key, receiver) {
       if (typeof key === "string" && !(key in target)) {
         if (/^\d+$/.test(key)) return target.item(Number(key));
-        return target.getPropertyValue(toKebab(key));
+        return target.getPropertyValue(styleKeyToProperty(key));
       }
       return Reflect.get(target, key, receiver);
     },
     set(target, key, value, receiver) {
       if (typeof key === "string" && !(key in target)) {
-        target.setProperty(toKebab(key), value == null ? "" : String(value));
+        target.setProperty(styleKeyToProperty(key), value == null ? "" : String(value));
         return true;
       }
       return Reflect.set(target, key, value, receiver);

package/dist/ssr-dom.js

@@ -5,7 +5,8 @@ import {
   createServerDocument,
   installServerDom,
   isServerDom
-} from "./chunk-YIXMS546.js";
+} from "./chunk-MINLMJUY.js";
+import "./chunk-DNCQDFJJ.js";
 import "./chunk-UYTYNCMZ.js";
 import "./chunk-NT3ZYB5S.js";
 import "./chunk-R5U7XKVJ.js";