sibujs 4.5.0 → 4.6.0

package/dist/plugins.d.cts

@@ -1,6 +1,6 @@
-import { T as TrustedHTML } from './ssr-BiPRdZ6n.cjs';
-export { P as PluginContext, a as PluginRegistry, S as SibuPlugin, c as createPlugin, b as createPluginRegistry, i as inject, p as plugin, r as resetPlugins, s as setDefaultPluginRegistry, t as triggerPluginError, d as triggerPluginMount, e as triggerPluginUnmount } from './plugin-D30wlGW5.cjs';
-export { M as Migration, S as SemVer, V as VERSION, b as bundlerMetadata, c as checkCompatibility, a as compareSemVer, d as createBootSequence, e as createBundle, f as createMigrationRunner, g as createModuleRegistry, h as createSSRCache, i as createTestHarness, j as deferNonCritical, k as env, l as healthCheck, m as lazyModule, p as packageInfo, n as parseSemVer, o as preloadCritical, q as prerenderRoutes, s as satisfies } from './startup-BMpaiMhP.cjs';
+import { T as TrustedHTML } from './ssr-Bli9XRW5.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 { 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';
 
 type Translations = Record<string, string>;
 type Params$1 = Record<string, string | number>;

package/dist/plugins.d.ts

@@ -1,6 +1,6 @@
-import { T as TrustedHTML } from './ssr-BiPRdZ6n.js';
-export { P as PluginContext, a as PluginRegistry, S as SibuPlugin, c as createPlugin, b as createPluginRegistry, i as inject, p as plugin, r as resetPlugins, s as setDefaultPluginRegistry, t as triggerPluginError, d as triggerPluginMount, e as triggerPluginUnmount } from './plugin-D30wlGW5.js';
-export { M as Migration, S as SemVer, V as VERSION, b as bundlerMetadata, c as checkCompatibility, a as compareSemVer, d as createBootSequence, e as createBundle, f as createMigrationRunner, g as createModuleRegistry, h as createSSRCache, i as createTestHarness, j as deferNonCritical, k as env, l as healthCheck, m as lazyModule, p as packageInfo, n as parseSemVer, o as preloadCritical, q as prerenderRoutes, s as satisfies } from './startup-BMpaiMhP.js';
+import { T as TrustedHTML } from './ssr-Bli9XRW5.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 { 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';
 
 type Translations = Record<string, string>;
 type Params$1 = Record<string, string | number>;

package/dist/plugins.js

@@ -1,4 +1,5 @@
 import {
+  MigrationStorageError,
   VERSION,
   bundlerMetadata,
   checkCompatibility,
@@ -18,62 +19,63 @@ import {
   preloadCritical,
   prerenderRoutes,
   satisfies
-} from "./chunk-KKLW7YWL.js";
+} from "./chunk-5MT6SJ3P.js";
 import {
   isUnsafeKey
 } from "./chunk-H3SRKIYX.js";
 import {
+  PluginInstallCancelledError,
   createPlugin,
   createPluginRegistry,
   inject,
+  isPluginInstallCancelledError,
   plugin,
   resetPlugins,
   setDefaultPluginRegistry,
   triggerPluginError,
   triggerPluginMount,
   triggerPluginUnmount
-} from "./chunk-WWV3SJ3L.js";
+} from "./chunk-J6FW5TV6.js";
 import {
   span
-} from "./chunk-PCT43HW3.js";
+} from "./chunk-JSXPZCET.js";
 import {
   escapeScriptJson,
   renderToString,
   serializeHeadEntry
-} from "./chunk-NIOYEGBQ.js";
+} from "./chunk-HURREPU2.js";
 import {
   resolveClassValue
-} from "./chunk-KEISJXBU.js";
-import "./chunk-ONOHFDLG.js";
+} from "./chunk-VVWPJ543.js";
+import "./chunk-47M47FOM.js";
 import {
   isUrlAttribute,
   sanitizeStyleAttribute,
   sanitizeUrl,
   stripControlChars
-} from "./chunk-IXKSNWV5.js";
+} from "./chunk-2INLLLMZ.js";
 import {
   globalSingleton
 } from "./chunk-7ZHH77QA.js";
 import {
   effect
-} from "./chunk-RIXRAYIU.js";
+} from "./chunk-XC4MEKGA.js";
 import {
   getRequestStore
-} from "./chunk-5DXA2J44.js";
-import {
-  dispose,
-  registerDisposer
-} from "./chunk-QKRPLZ2V.js";
+} from "./chunk-7XHATCIH.js";
+import "./chunk-5HZXGZ6T.js";
 import {
   signal
-} from "./chunk-XZZOBQAY.js";
+} from "./chunk-D33YTSX5.js";
 import {
   track
-} from "./chunk-UGRX3S57.js";
+} from "./chunk-5Q4R7HCL.js";
 import {
   devWarn,
-  isDev
-} from "./chunk-2WLZ6757.js";
+  dispose,
+  isDev,
+  registerDisposer
+} from "./chunk-NYNYSPK7.js";
 
 // src/plugins/i18n.ts
 var _i18n = globalSingleton(/* @__PURE__ */ Symbol.for("sibujs.i18n.v1"), () => ({
@@ -131,6 +133,15 @@ function getAvailableLocales() {
 }
 
 // src/plugins/router.ts
+function splitRouteUrl(url) {
+  const hashIndex = url.indexOf("#");
+  const beforeHash = hashIndex === -1 ? url : url.slice(0, hashIndex);
+  const hash = hashIndex === -1 ? "" : url.slice(hashIndex + 1);
+  const queryIndex = beforeHash.indexOf("?");
+  const path = queryIndex === -1 ? beforeHash : beforeHash.slice(0, queryIndex);
+  const query = queryIndex === -1 ? "" : beforeHash.slice(queryIndex + 1);
+  return { path, query, hash };
+}
 function classifyNavigationTarget(path) {
   if (path === "") return "internal";
   const normalized = stripControlChars(path).replace(/\\/g, "/");
@@ -849,8 +860,7 @@ var _SibuRouter = class _SibuRouter {
     return (path || "/") + window.location.search + window.location.hash;
   }
   createRouteContext(fullPath) {
-    const [pathWithQuery, hash = ""] = fullPath.split("#");
-    const [path, queryString = ""] = pathWithQuery.split("?");
+    const { path, query: queryString, hash } = splitRouteUrl(fullPath);
     const query = Object.fromEntries(new URLSearchParams(queryString));
     const match = this.matcher.match(path || "/");
     const params = match?.params || {};
@@ -1597,8 +1607,7 @@ function RouterLink(props, children) {
   const rawHref = _routerRef.current["resolvePath"](to);
   const kind = classifyNavigationTarget(rawHref);
   const href = kind === "unsafe" ? "#" : rawHref;
-  const [hrefBeforeHash, hrefHash = ""] = href.split("#");
-  const [hrefPathRaw, hrefQueryRaw = ""] = hrefBeforeHash.split("?");
+  const { path: hrefPathRaw, query: hrefQueryRaw, hash: hrefHash } = splitRouteUrl(href);
   const targetPath = normalizePathname(hrefPathRaw);
   const targetQuery = normalizeQuery(hrefQueryRaw);
   const link = document.createElement("a");
@@ -2193,8 +2202,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-Y7XOEPEN.js").then(async ({ hydrate }) => {
-    const { replaceChildrenSafely } = await import("./dispose-46BOMMQJ.js");
+  import("./ssr-XOTUASDO.js").then(async ({ hydrate }) => {
+    const { replaceChildrenSafely } = await import("./dispose-GEIG2KOF.js");
     if (__getNavigationEpoch() !== bootstrapEpoch) return;
     if (resolved.component) {
       hydrate(resolved.component, container);
@@ -2228,7 +2237,9 @@ function escapeAttrLocal(str) {
 }
 export {
   KeepAliveRoute,
+  MigrationStorageError,
   Outlet,
+  PluginInstallCancelledError,
   Route,
   RouterLink,
   SibuRouter,
@@ -2272,6 +2283,7 @@ export {
   healthCheck,
   hydrateRouter,
   inject,
+  isPluginInstallCancelledError,
   lazy,
   lazyModule,
   navigate,

package/dist/signal-EotCj4hS.d.cts

@@ -0,0 +1,110 @@
+declare const __accessor: unique symbol;
+/**
+ * A reactive signal getter returned by signal(), derived(), and similar primitives.
+ *
+ * Pass an Accessor directly into reactive prop positions — never call it there:
+ * ```ts
+ * const [count, setCount] = signal(0);
+ *
+ * div(count)                       // ✓ reactive — Accessor passed directly
+ * div(() => count())               // ✓ reactive — explicit arrow wrapper
+ * div(count())                     // ✗ static  — evaluated once, not reactive
+ * ```
+ */
+type Accessor<T> = (() => T) & {
+    readonly [__accessor]?: never;
+};
+/**
+ * An {@link Accessor} that owns a subscription, timer or listener and must be
+ * released when its consumer goes away. Returned by helpers such as `debounce`,
+ * `throttle` and `previous`.
+ */
+type DisposableAccessor<T> = Accessor<T> & {
+    /** Stop the underlying subscription and cancel pending work. The accessor keeps its last value. */
+    dispose(): void;
+};
+type SetState<T> = (next: T | ((prev: T) => T)) => void;
+type StateTuple<T> = [Accessor<T>, SetState<T>];
+/** Options for signal */
+interface SignalOptions<T = unknown> {
+    /** Debug name for devtools inspection. Only used in development. */
+    name?: string;
+    /** Custom equality function. Defaults to Object.is(). */
+    equals?: (prev: T, next: T) => boolean;
+}
+/**
+ * signal creates a reactive signal that holds a value of type T.
+ * Returns a tuple: [getter, setter].
+ *
+ * @param initial Initial value
+ * @param options Optional config: `{ name: "count" }` for devtools labeling
+ * @returns A `[getter, setter]` tuple. Calling the getter inside a reactive
+ * context subscribes to the signal; the setter accepts a value or an updater.
+ */
+declare function signal<T>(initial: T, options?: SignalOptions<T>): StateTuple<T>;
+/**
+ * A valueless reactive token standing in for state SibuJS does not own.
+ *
+ * See {@link external}.
+ */
+interface ExternalSource {
+    /**
+     * Declare, from inside a reactive computation, that it reads the external
+     * state this source represents. Call it in the same places you would read a
+     * signal — the top of a binding getter, a `derived()` body, an `effect()`.
+     *
+     * Outside a tracking context it is a no-op, exactly like reading a signal.
+     */
+    track(): void;
+    /**
+     * Declare that the external state changed. Every consumer that called
+     * {@link ExternalSource.track} is invalidated.
+     *
+     * Participates in `batch()` like any signal write: inside a batch, consumers
+     * are notified once when the outermost batch flushes.
+     */
+    invalidate(): void;
+}
+/**
+ * Create a reactive source for state that lives outside SibuJS — a domain
+ * engine, a media element, a canvas scene, an editor document, a cache a
+ * socket writes into.
+ *
+ * The pattern is two lines: `track()` where you read, `invalidate()` after you
+ * mutate.
+ *
+ * ```ts
+ * import { Chess } from "chess.js";
+ * import { external } from "sibujs";
+ *
+ * const game = new Chess();      // owns the rules and the mutable state
+ * const moved = external();      // owns "something changed"
+ *
+ * ctx.text("@status", () => {
+ *   moved.track();               // this binding reads the engine
+ *   return game.isCheckmate() ? "Checkmate" : `${game.turn()} to move`;
+ * });
+ *
+ * game.move({ from: "e2", to: "e4" });
+ * moved.invalidate();            // every consumer above re-reads
+ * ```
+ *
+ * **One source is one invalidation domain.** Every consumer of a source
+ * re-runs on every `invalidate()`, so the granularity of your updates is
+ * exactly the granularity of your sources: one for a whole engine is the
+ * cheapest to write, several (`board`, `clock`, `history`) let an update touch
+ * only what it affects. See `docs/architecture/external-state.md` for the
+ * trade-offs and when subdividing is worth it.
+ *
+ * Ownership, disposal and error routing are the consumer's, not the source's:
+ * a disposed binding or effect is never invalidated, and a consumer that
+ * throws is reported through the normal runtime error pipeline with its own
+ * phase and node.
+ *
+ * @param options `name` labels the source in devtools (development only).
+ */
+declare function external(options?: {
+    name?: string;
+}): ExternalSource;
+
+export { type Accessor as A, type DisposableAccessor as D, type ExternalSource as E, type SignalOptions as S, external as e, signal as s };

package/dist/signal-EotCj4hS.d.ts

@@ -0,0 +1,110 @@
+declare const __accessor: unique symbol;
+/**
+ * A reactive signal getter returned by signal(), derived(), and similar primitives.
+ *
+ * Pass an Accessor directly into reactive prop positions — never call it there:
+ * ```ts
+ * const [count, setCount] = signal(0);
+ *
+ * div(count)                       // ✓ reactive — Accessor passed directly
+ * div(() => count())               // ✓ reactive — explicit arrow wrapper
+ * div(count())                     // ✗ static  — evaluated once, not reactive
+ * ```
+ */
+type Accessor<T> = (() => T) & {
+    readonly [__accessor]?: never;
+};
+/**
+ * An {@link Accessor} that owns a subscription, timer or listener and must be
+ * released when its consumer goes away. Returned by helpers such as `debounce`,
+ * `throttle` and `previous`.
+ */
+type DisposableAccessor<T> = Accessor<T> & {
+    /** Stop the underlying subscription and cancel pending work. The accessor keeps its last value. */
+    dispose(): void;
+};
+type SetState<T> = (next: T | ((prev: T) => T)) => void;
+type StateTuple<T> = [Accessor<T>, SetState<T>];
+/** Options for signal */
+interface SignalOptions<T = unknown> {
+    /** Debug name for devtools inspection. Only used in development. */
+    name?: string;
+    /** Custom equality function. Defaults to Object.is(). */
+    equals?: (prev: T, next: T) => boolean;
+}
+/**
+ * signal creates a reactive signal that holds a value of type T.
+ * Returns a tuple: [getter, setter].
+ *
+ * @param initial Initial value
+ * @param options Optional config: `{ name: "count" }` for devtools labeling
+ * @returns A `[getter, setter]` tuple. Calling the getter inside a reactive
+ * context subscribes to the signal; the setter accepts a value or an updater.
+ */
+declare function signal<T>(initial: T, options?: SignalOptions<T>): StateTuple<T>;
+/**
+ * A valueless reactive token standing in for state SibuJS does not own.
+ *
+ * See {@link external}.
+ */
+interface ExternalSource {
+    /**
+     * Declare, from inside a reactive computation, that it reads the external
+     * state this source represents. Call it in the same places you would read a
+     * signal — the top of a binding getter, a `derived()` body, an `effect()`.
+     *
+     * Outside a tracking context it is a no-op, exactly like reading a signal.
+     */
+    track(): void;
+    /**
+     * Declare that the external state changed. Every consumer that called
+     * {@link ExternalSource.track} is invalidated.
+     *
+     * Participates in `batch()` like any signal write: inside a batch, consumers
+     * are notified once when the outermost batch flushes.
+     */
+    invalidate(): void;
+}
+/**
+ * Create a reactive source for state that lives outside SibuJS — a domain
+ * engine, a media element, a canvas scene, an editor document, a cache a
+ * socket writes into.
+ *
+ * The pattern is two lines: `track()` where you read, `invalidate()` after you
+ * mutate.
+ *
+ * ```ts
+ * import { Chess } from "chess.js";
+ * import { external } from "sibujs";
+ *
+ * const game = new Chess();      // owns the rules and the mutable state
+ * const moved = external();      // owns "something changed"
+ *
+ * ctx.text("@status", () => {
+ *   moved.track();               // this binding reads the engine
+ *   return game.isCheckmate() ? "Checkmate" : `${game.turn()} to move`;
+ * });
+ *
+ * game.move({ from: "e2", to: "e4" });
+ * moved.invalidate();            // every consumer above re-reads
+ * ```
+ *
+ * **One source is one invalidation domain.** Every consumer of a source
+ * re-runs on every `invalidate()`, so the granularity of your updates is
+ * exactly the granularity of your sources: one for a whole engine is the
+ * cheapest to write, several (`board`, `clock`, `history`) let an update touch
+ * only what it affects. See `docs/architecture/external-state.md` for the
+ * trade-offs and when subdividing is worth it.
+ *
+ * Ownership, disposal and error routing are the consumer's, not the source's:
+ * a disposed binding or effect is never invalidated, and a consumer that
+ * throws is reported through the normal runtime error pipeline with its own
+ * phase and node.
+ *
+ * @param options `name` labels the source in devtools (development only).
+ */
+declare function external(options?: {
+    name?: string;
+}): ExternalSource;
+
+export { type Accessor as A, type DisposableAccessor as D, type ExternalSource as E, type SignalOptions as S, external as e, signal as s };

package/dist/{ssr-BiPRdZ6n.d.cts → ssr-Bli9XRW5.d.cts}

@@ -166,6 +166,11 @@ declare function resetSSRState(): void;
  *
  * The returned element contains the fallback UI with a `data-sibu-suspense-id`
  * marker. The promise resolves to `{ id, html }` once async content is ready.
+ *
+ * The promise never rejects. Any failure to produce the content HTML — the
+ * content factory throwing synchronously, its promise rejecting, the timeout,
+ * or rendering the resolved element throwing — resolves it with the fallback
+ * HTML, so the stream still produces a deterministic swap payload.
  */
 declare function ssrSuspense(props: {
     fallback: () => HTMLElement;

package/dist/{ssr-BiPRdZ6n.d.ts → ssr-Bli9XRW5.d.ts}

@@ -166,6 +166,11 @@ declare function resetSSRState(): void;
  *
  * The returned element contains the fallback UI with a `data-sibu-suspense-id`
  * marker. The promise resolves to `{ id, html }` once async content is ready.
+ *
+ * The promise never rejects. Any failure to produce the content HTML — the
+ * content factory throwing synchronously, its promise rejecting, the timeout,
+ * or rendering the resolved element throwing — resolves it with the fallback
+ * HTML, so the stream still produces a deterministic swap payload.
  */
 declare function ssrSuspense(props: {
     fallback: () => HTMLElement;

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

@@ -17,11 +17,10 @@ import {
   ssrSuspense,
   suspenseSwapScript,
   trustHTML
-} from "./chunk-NIOYEGBQ.js";
-import "./chunk-IXKSNWV5.js";
-import "./chunk-5DXA2J44.js";
-import "./chunk-QKRPLZ2V.js";
-import "./chunk-2WLZ6757.js";
+} from "./chunk-HURREPU2.js";
+import "./chunk-2INLLLMZ.js";
+import "./chunk-7XHATCIH.js";
+import "./chunk-NYNYSPK7.js";
 export {
   collectStream,
   deserializeState,