sibujs 4.2.0 → 4.4.0

package/dist/ecosystem.cjs

@@ -597,7 +597,7 @@ function forEachSubscriber(signal2, visit) {
 }
 
 // src/reactivity/track.ts
-var _runtimeVersion = true ? "4.2.0" : "dev";
+var _runtimeVersion = true ? "4.4.0" : "dev";
 var REGISTRY_KEY = /* @__PURE__ */ Symbol.for("sibujs.reactive.v1");
 function resolveReactiveApi() {
   const g = globalThis;

package/dist/ecosystem.js

@@ -7,18 +7,18 @@ import {
   mobXAdapter,
   reduxAdapter,
   zustandAdapter
-} from "./chunk-GDUNQCCW.js";
+} from "./chunk-UCALUKB5.js";
 import "./chunk-WWV3SJ3L.js";
-import "./chunk-6ZGI3RBE.js";
-import "./chunk-HJEPKZ2O.js";
-import "./chunk-2LOYNGBY.js";
+import "./chunk-PNIRUQ4C.js";
+import "./chunk-VCTAEPSB.js";
+import "./chunk-W2EQ7X2L.js";
 import "./chunk-IXKSNWV5.js";
 import "./chunk-7ZHH77QA.js";
-import "./chunk-7VEC3UD2.js";
+import "./chunk-7GIHSAWB.js";
 import "./chunk-5DXA2J44.js";
 import "./chunk-QKRPLZ2V.js";
-import "./chunk-HECVW343.js";
-import "./chunk-7ALC7KGE.js";
+import "./chunk-NVNJH22U.js";
+import "./chunk-3BTTCZ5J.js";
 import "./chunk-2WLZ6757.js";
 export {
   antdAdapter,

package/dist/extras.cjs

@@ -888,7 +888,7 @@ function forEachSubscriber(signal2, visit) {
 }
 
 // src/reactivity/track.ts
-var _runtimeVersion = true ? "4.2.0" : "dev";
+var _runtimeVersion = true ? "4.4.0" : "dev";
 var REGISTRY_KEY = /* @__PURE__ */ Symbol.for("sibujs.reactive.v1");
 function resolveReactiveApi() {
   const g2 = globalThis;
@@ -5122,31 +5122,39 @@ var validators = {
 };
 function validateProps(props, schema) {
   const result = { ...props };
-  const errors = [];
-  const isDev2 = typeof process === "undefined" || process?.env?.NODE_ENV !== "production";
-  for (const [key, def] of Object.entries(schema)) {
-    const propDef = typeof def === "function" ? { type: def } : def;
-    if (result[key] == null && propDef.default !== void 0) {
-      result[key] = typeof propDef.default === "function" ? propDef.default() : propDef.default;
-    }
-    if (!isDev2) continue;
-    if (propDef.required && result[key] == null) {
-      errors.push(`Prop '${key}' is required`);
-      continue;
-    }
-    if (result[key] == null) continue;
-    if (propDef.type) {
-      const typeResult = propDef.type(result[key], key);
-      if (typeResult !== true) errors.push(typeResult);
+  if (typeof __SIBU_DEV__ !== "undefined" ? __SIBU_DEV__ : DEV) {
+    const errors = [];
+    for (const [key, def] of Object.entries(schema)) {
+      const propDef = typeof def === "function" ? { type: def } : def;
+      if (result[key] == null && propDef.default !== void 0) {
+        result[key] = typeof propDef.default === "function" ? propDef.default() : propDef.default;
+      }
+      if (propDef.required && result[key] == null) {
+        errors.push(`Prop '${key}' is required`);
+        continue;
+      }
+      if (result[key] == null) continue;
+      if (propDef.type) {
+        const typeResult = propDef.type(result[key], key);
+        if (typeResult !== true) errors.push(typeResult);
+      }
+      if (propDef.validator) {
+        const validResult = propDef.validator(result[key], key);
+        if (validResult !== true) errors.push(validResult);
+      }
     }
-    if (propDef.validator) {
-      const validResult = propDef.validator(result[key], key);
-      if (validResult !== true) errors.push(validResult);
+    if (errors.length > 0) {
+      devWarn(`Prop validation errors:
+${errors.map((e) => `  - ${e}`).join("\n")}`);
     }
+    return result;
   }
-  if (errors.length > 0 && isDev2) {
-    console.warn(`[SibuJS] Prop validation errors:
-${errors.map((e) => `  - ${e}`).join("\n")}`);
+  for (const [key, def] of Object.entries(schema)) {
+    if (typeof def === "function") continue;
+    const fallback = def.default;
+    if (result[key] == null && fallback !== void 0) {
+      result[key] = typeof fallback === "function" ? fallback() : fallback;
+    }
   }
   return result;
 }
@@ -5157,10 +5165,11 @@ function defineStrictComponent(config) {
   };
 }
 function assertType(value, validator, label2) {
-  if (typeof process !== "undefined" && process?.env?.NODE_ENV === "production") return;
-  const result = validator(value, label2 || "value");
-  if (result !== true) {
-    throw new TypeError(`[SibuJS Contract] ${result}`);
+  if (typeof __SIBU_DEV__ !== "undefined" ? __SIBU_DEV__ : DEV) {
+    const result = validator(value, label2 || "value");
+    if (result !== true) {
+      throw new TypeError(`[SibuJS Contract] ${result}`);
+    }
   }
 }
 function createGuard(validator) {

package/dist/extras.d.cts

@@ -1,7 +1,7 @@
 export { ConflictStrategy, InfiniteQueryOptions, InfiniteQueryResult, LoaderRoute, MutationOptions, MutationResult, OfflineStore, OfflineStoreOptions, QueryOptions, QueryResult, Resource, ResourceOptions, RetryOptions, RouteLoaderFn, SyncAdapter, SyncChange, SyncConflict, SyncResult, __resetQueryCache, calculateDelay, clearQueryCache, debounce, executeLoader, getQueryData, infiniteQuery, invalidateQueries, loaderData, mutation, offlineStore, preloadRoute, previous, query, resource, setQueryData, socket, stream, syncAdapter, throttle, withRetry } from './data.cjs';
 export { AnimationFrameOptions, BoundsRect, GamepadSnapshot, ImageLoaderState, KeyboardOptions, MouseOptions, MutationObserverOptions, SpeakOptions, SwipeDirection, SwipeOptions, TextSelectionState, UrlStateOptions, animationFrame, battery, bounds, broadcast, clipboard, colorScheme, draggable, dropZone, favicon, formatCurrency, formatNumber, fullscreen, gamepad, geo, idle, imageLoader, keyboard, media, mouse, mutationObserver, network, online, permissions, pointerLock, resize, scroll, speech, svgFavicon, swipe, textSelection, title, urlState, vibrate, visibility, wakeLock, windowSize } from './browser.cjs';
 export { GlobalStore, MachineConfig, MachineReturn, Middleware, PersistOptions, Selector, StoreActionMap, TimeTravelReturn, globalStore, machine, optimistic, optimisticList, persisted, timeline } from './patterns.cjs';
-export { C as ComponentProps, P as PropDef, a as PropSchema, R as RenderProp, V as Validator, b as assertType, c as compose, d as createGuard, e as createSlots, f as defineComponent, g as defineSlottedComponent, h as defineStrictComponent, v as validateProps, i as validators, w as withBoundary, j as withDefaults, k as withProps, l as withWrapper } from './contracts-Hg6ITAEF.cjs';
+export { C as ComponentProps, P as PropDef, a as PropSchema, R as RenderProp, V as Validator, b as assertType, c as compose, d as createGuard, e as createSlots, f as defineComponent, g as defineSlottedComponent, h as defineStrictComponent, v as validateProps, i as validators, w as withBoundary, j as withDefaults, k as withProps, l as withWrapper } from './contracts-DBdg9J_a.cjs';
 export { AnimationPreset, PresetOptions, SlideDirection, SpringOptions, TransitionGroup, TransitionGroupOptions, TransitionOptions, animate, bounceIn, bounceOut, fadeIn, fadeOut, flipIn, prefersReducedMotion, pulse, reducedMotion, scaleDown, scaleUp, sequence, shake, slideIn, slideOut, spring, springSignal, stagger, transition, viewTransition } from './motion.cjs';
 export { A as AttributeSource, a as AttributeValue, B as BoundFieldProps, C as CustomElementOptions, F as FieldConfig, b as FocusTrap, c as FormConfig, d as FormField, e as FormReturn, I as IntersectionResult, M as MaskOptions, T as Toast, f as ToastInstance, V as ValidatorFn, g as VirtualList, h as VirtualListProps, _ as __resetDialogStack, i as announce, j as aria, k as bindAttrs, l as bindBoolAttr, m as bindData, n as bindField, o as creditCardMask, p as custom, q as dateMask, r as defineElement, s as dialog, t as email, u as eventBus, v as focus, w as form, x as hotkey, y as infiniteScroll, z as inputMask, D as intersection, E as lazyLoad, G as matchesPattern, H as max, J as maxLength, K as min, L as minLength, N as pagination, O as phoneMask, P as removeScopedStyle, Q as required, R as scopedStyle, S as ssnMask, U as svgElement, W as timeMask, X as toast, Y as withScopedStyle, Z as zipMask } from './customElement-CNZxEB9G.cjs';
 export { ChunkConfig, DOMPool, Features, NormalizeResult, NormalizedEntities, NormalizedSchema, NormalizedState, NormalizedStoreActions, Priority, PriorityLevel, block, cloneTemplate, conditional, createChunkRegistry, deferredValue, denormalize, devOnly, flushScheduler, getDOMPool, hoistable, lazyChunk, noSideEffect, normalize, normalizedStore, pendingTasks, precompile, prefetch, preloadImage, preloadModule, preloadModules, preloadResource, processInChunks, pure, resetIdCounter, scheduleUpdate, setIdPrefix, startTransition, staticTemplate, transitionState, uniqueId, yieldToMain } from './performance.cjs';

package/dist/extras.d.ts

@@ -1,7 +1,7 @@
 export { ConflictStrategy, InfiniteQueryOptions, InfiniteQueryResult, LoaderRoute, MutationOptions, MutationResult, OfflineStore, OfflineStoreOptions, QueryOptions, QueryResult, Resource, ResourceOptions, RetryOptions, RouteLoaderFn, SyncAdapter, SyncChange, SyncConflict, SyncResult, __resetQueryCache, calculateDelay, clearQueryCache, debounce, executeLoader, getQueryData, infiniteQuery, invalidateQueries, loaderData, mutation, offlineStore, preloadRoute, previous, query, resource, setQueryData, socket, stream, syncAdapter, throttle, withRetry } from './data.js';
 export { AnimationFrameOptions, BoundsRect, GamepadSnapshot, ImageLoaderState, KeyboardOptions, MouseOptions, MutationObserverOptions, SpeakOptions, SwipeDirection, SwipeOptions, TextSelectionState, UrlStateOptions, animationFrame, battery, bounds, broadcast, clipboard, colorScheme, draggable, dropZone, favicon, formatCurrency, formatNumber, fullscreen, gamepad, geo, idle, imageLoader, keyboard, media, mouse, mutationObserver, network, online, permissions, pointerLock, resize, scroll, speech, svgFavicon, swipe, textSelection, title, urlState, vibrate, visibility, wakeLock, windowSize } from './browser.js';
 export { GlobalStore, MachineConfig, MachineReturn, Middleware, PersistOptions, Selector, StoreActionMap, TimeTravelReturn, globalStore, machine, optimistic, optimisticList, persisted, timeline } from './patterns.js';
-export { C as ComponentProps, P as PropDef, a as PropSchema, R as RenderProp, V as Validator, b as assertType, c as compose, d as createGuard, e as createSlots, f as defineComponent, g as defineSlottedComponent, h as defineStrictComponent, v as validateProps, i as validators, w as withBoundary, j as withDefaults, k as withProps, l as withWrapper } from './contracts-Hg6ITAEF.js';
+export { C as ComponentProps, P as PropDef, a as PropSchema, R as RenderProp, V as Validator, b as assertType, c as compose, d as createGuard, e as createSlots, f as defineComponent, g as defineSlottedComponent, h as defineStrictComponent, v as validateProps, i as validators, w as withBoundary, j as withDefaults, k as withProps, l as withWrapper } from './contracts-DBdg9J_a.js';
 export { AnimationPreset, PresetOptions, SlideDirection, SpringOptions, TransitionGroup, TransitionGroupOptions, TransitionOptions, animate, bounceIn, bounceOut, fadeIn, fadeOut, flipIn, prefersReducedMotion, pulse, reducedMotion, scaleDown, scaleUp, sequence, shake, slideIn, slideOut, spring, springSignal, stagger, transition, viewTransition } from './motion.js';
 export { A as AttributeSource, a as AttributeValue, B as BoundFieldProps, C as CustomElementOptions, F as FieldConfig, b as FocusTrap, c as FormConfig, d as FormField, e as FormReturn, I as IntersectionResult, M as MaskOptions, T as Toast, f as ToastInstance, V as ValidatorFn, g as VirtualList, h as VirtualListProps, _ as __resetDialogStack, i as announce, j as aria, k as bindAttrs, l as bindBoolAttr, m as bindData, n as bindField, o as creditCardMask, p as custom, q as dateMask, r as defineElement, s as dialog, t as email, u as eventBus, v as focus, w as form, x as hotkey, y as infiniteScroll, z as inputMask, D as intersection, E as lazyLoad, G as matchesPattern, H as max, J as maxLength, K as min, L as minLength, N as pagination, O as phoneMask, P as removeScopedStyle, Q as required, R as scopedStyle, S as ssnMask, U as svgElement, W as timeMask, X as toast, Y as withScopedStyle, Z as zipMask } from './customElement-CNZxEB9G.js';
 export { ChunkConfig, DOMPool, Features, NormalizeResult, NormalizedEntities, NormalizedSchema, NormalizedState, NormalizedStoreActions, Priority, PriorityLevel, block, cloneTemplate, conditional, createChunkRegistry, deferredValue, denormalize, devOnly, flushScheduler, getDOMPool, hoistable, lazyChunk, noSideEffect, normalize, normalizedStore, pendingTasks, precompile, prefetch, preloadImage, preloadModule, preloadModules, preloadResource, processInChunks, pure, resetIdCounter, scheduleUpdate, setIdPrefix, startTransition, staticTemplate, transitionState, uniqueId, yieldToMain } from './performance.js';

package/dist/extras.js

@@ -5,7 +5,7 @@ import {
   optimisticList,
   persisted,
   timeline
-} from "./chunk-OUWAIXIK.js";
+} from "./chunk-LQFGQNMV.js";
 import {
   DOMPool,
   Features,
@@ -41,7 +41,7 @@ import {
   transitionState,
   uniqueId,
   yieldToMain
-} from "./chunk-BNKV4REK.js";
+} from "./chunk-M2F7TZHH.js";
 import {
   VERSION,
   bundlerMetadata,
@@ -88,7 +88,7 @@ import {
   wasm,
   worker,
   workerFn
-} from "./chunk-NEYWS4EX.js";
+} from "./chunk-HQSEH5F6.js";
 import {
   FocusTrap,
   VirtualList,
@@ -129,7 +129,7 @@ import {
   toast,
   withScopedStyle,
   zipMask
-} from "./chunk-SF3TB4K6.js";
+} from "./chunk-XLO7SLIX.js";
 import {
   RenderProp,
   assertType,
@@ -145,7 +145,7 @@ import {
   withDefaults,
   withProps,
   withWrapper
-} from "./chunk-VJE6DDYM.js";
+} from "./chunk-R25EFXXC.js";
 import {
   accordion,
   combobox,
@@ -156,7 +156,7 @@ import {
   select,
   tabs,
   tooltip
-} from "./chunk-QCFLDD7C.js";
+} from "./chunk-HFCOH2GN.js";
 import {
   animationFrame,
   battery,
@@ -194,7 +194,7 @@ import {
   visibility,
   wakeLock,
   windowSize
-} from "./chunk-KE4KWRDY.js";
+} from "./chunk-LYVUX7NT.js";
 import "./chunk-H3SRKIYX.js";
 import "./chunk-52XFPGSN.js";
 import {
@@ -219,7 +219,7 @@ import {
   syncAdapter,
   throttle,
   withRetry
-} from "./chunk-XZ2N525U.js";
+} from "./chunk-6GSIXTWX.js";
 import {
   SibuError,
   checkLeaks,
@@ -257,7 +257,7 @@ import {
   trackCleanup,
   walkDependencyGraph,
   withErrorTracking
-} from "./chunk-QL4UREZO.js";
+} from "./chunk-4Z3SPQ67.js";
 import {
   antdAdapter,
   chakraAdapter,
@@ -267,7 +267,7 @@ import {
   mobXAdapter,
   reduxAdapter,
   zustandAdapter
-} from "./chunk-GDUNQCCW.js";
+} from "./chunk-UCALUKB5.js";
 import {
   createPlugin,
   createPluginRegistry,
@@ -279,7 +279,7 @@ import {
   triggerPluginMount,
   triggerPluginUnmount
 } from "./chunk-WWV3SJ3L.js";
-import "./chunk-P3DHXBR6.js";
+import "./chunk-36S2YPP4.js";
 import {
   collectStream,
   deserializeState,
@@ -300,15 +300,15 @@ import {
   suspenseSwapScript,
   trustHTML
 } from "./chunk-NIOYEGBQ.js";
-import "./chunk-BMYYZWHX.js";
+import "./chunk-RR7M3FHM.js";
 import "./chunk-CCSJMTRN.js";
-import "./chunk-FOWBJZDL.js";
-import "./chunk-6ZGI3RBE.js";
-import "./chunk-HJEPKZ2O.js";
-import "./chunk-2LOYNGBY.js";
+import "./chunk-7NBDXVHS.js";
+import "./chunk-PNIRUQ4C.js";
+import "./chunk-VCTAEPSB.js";
+import "./chunk-W2EQ7X2L.js";
 import "./chunk-IXKSNWV5.js";
 import "./chunk-7ZHH77QA.js";
-import "./chunk-7VEC3UD2.js";
+import "./chunk-7GIHSAWB.js";
 import "./chunk-5DXA2J44.js";
 import {
   TransitionGroup,
@@ -332,10 +332,10 @@ import {
   stagger,
   transition,
   viewTransition
-} from "./chunk-3VTSPNC5.js";
+} from "./chunk-SKPTERHP.js";
 import "./chunk-QKRPLZ2V.js";
-import "./chunk-HECVW343.js";
-import "./chunk-7ALC7KGE.js";
+import "./chunk-NVNJH22U.js";
+import "./chunk-3BTTCZ5J.js";
 import "./chunk-2WLZ6757.js";
 export {
   DOMPool,

package/dist/index.cjs

@@ -1210,7 +1210,7 @@ function forEachSubscriber(signal2, visit) {
 }
 
 // src/reactivity/track.ts
-var _runtimeVersion = true ? "4.2.0" : "dev";
+var _runtimeVersion = true ? "4.4.0" : "dev";
 var REGISTRY_KEY = /* @__PURE__ */ Symbol.for("sibujs.reactive.v1");
 function resolveReactiveApi() {
   const g2 = globalThis;
@@ -5256,7 +5256,16 @@ function enhance(target, setup) {
   const teardowns = [];
   const owner = /* @__PURE__ */ Symbol("sibujs.enhance");
   let disposed = false;
-  const bind = (target_, fn) => {
+  let closed = false;
+  const isClosed = (method) => {
+    if (!closed) return false;
+    devWarnLazy(
+      () => `enhance: ctx.${method}() was called after this enhancement was rolled back or disposed, so it was ignored. The setup is still running past the point where its transaction ended \u2014 usually an async setup continuing after an await, or a callback it queued before it threw. Registrations made now would belong to nothing: the root carries no enhancement marker and the disposer has already run, so nothing could ever release them.`
+    );
+    return true;
+  };
+  const bind = (method, target_, fn) => {
+    if (isClosed(method)) return;
     const el = resolveTarget(root, target_);
     if (!el) {
       if (typeof console !== "undefined") {
@@ -5278,14 +5287,14 @@ function enhance(target, setup) {
       }
     },
     on: (t, event, handler, options) => {
-      bind(t, (el) => {
+      bind("on", t, (el) => {
         const wrapped = (e) => handler(e, el);
         el.addEventListener(event, wrapped, options);
         teardowns.push(() => el.removeEventListener(event, wrapped, options));
       });
     },
     text: (t, value) => {
-      bind(t, (el) => {
+      bind("text", t, (el) => {
         teardowns.push(
           bindNode(el, () => {
             const v = value();
@@ -5296,7 +5305,7 @@ function enhance(target, setup) {
       });
     },
     attr: (t, name, value) => {
-      bind(t, (el) => {
+      bind("attr", t, (el) => {
         teardowns.push(
           bindNode(el, () => {
             const v = value();
@@ -5307,7 +5316,7 @@ function enhance(target, setup) {
       });
     },
     classed: (t, name, on2) => {
-      bind(t, (el) => {
+      bind("classed", t, (el) => {
         teardowns.push(
           bindNode(el, () => {
             el.classList.toggle(name, Boolean(on2()));
@@ -5316,7 +5325,7 @@ function enhance(target, setup) {
       });
     },
     show: (t, when2) => {
-      bind(t, (el) => {
+      bind("show", t, (el) => {
         const prevHidden = el.hidden;
         teardowns.push(
           bindNode(el, () => {
@@ -5329,7 +5338,7 @@ function enhance(target, setup) {
       });
     },
     model: (t, state2, options) => {
-      bind(t, (el) => {
+      bind("model", t, (el) => {
         const control = el;
         const [get, set] = state2;
         const evt = options?.event ?? (control instanceof HTMLSelectElement || control instanceof HTMLInputElement && (control.type === "checkbox" || control.type === "radio") ? "change" : "input");
@@ -5344,6 +5353,7 @@ function enhance(target, setup) {
       });
     },
     each: (target_, describe2) => {
+      if (isClosed("each")) return;
       devAssert(typeof describe2 === "function", "ctx.each: second argument must be a function.");
       const elements = typeof target_ === "string" ? ctx.refs(target_) : Array.from(target_);
       for (let i2 = 0; i2 < elements.length; i2++) {
@@ -5354,14 +5364,25 @@ function enhance(target, setup) {
       }
     },
     cleanup: (fn) => {
+      if (isClosed("cleanup")) return;
       teardowns.push(fn);
     }
   };
   let extra;
   try {
     extra = setup(ctx);
+    const returned = extra;
+    if (returned && typeof returned.then === "function") {
+      returned.then(void 0, (reason) => {
+        devWarnLazy(() => `enhance: the promise returned by the setup also rejected: ${String(reason)}`);
+      });
+      throw new Error(
+        (typeof __SIBU_DEV__ !== "undefined" ? __SIBU_DEV__ : DEV) ? "[SibuJS enhance] the setup returned a promise, so its work did not complete inside the enhancement transaction. If it is a lazy import, register it as lazyIsland(() => import(\u2026)): an unwrapped loader is called as a setup, so its module is fetched but the setup it resolves to is discarded. If it is an async setup, make it synchronous \u2014 this enhancement has been rolled back, and ctx registrations made after this point are ignored." : "[SibuJS enhance] setup returned a promise"
+      );
+    }
   } catch (err) {
     drainTeardowns(teardowns, "enhance");
+    closed = true;
     throw err;
   }
   if (typeof extra === "function") teardowns.push(extra);
@@ -5374,6 +5395,7 @@ function enhance(target, setup) {
     }
     unregisterDisposer(root, dispose2);
     drainTeardowns(teardowns, "enhance");
+    closed = true;
   };
   registerDisposer(root, dispose2);
   enhancementOwner.set(root, owner);

package/dist/index.d.cts

@@ -1984,8 +1984,40 @@ type IslandStrategy = "load" | "idle" | "visible" | "interaction" | "media";
 type IslandLoader = () => Promise<EnhanceSetup | {
     default: EnhanceSetup;
 }>;
-/** Either an inline setup, or a {@link lazyIsland}-branded loader. */
-type IslandRegistration = EnhanceSetup | IslandLoader;
+/**
+ * A loader that has been through {@link lazyIsland}.
+ *
+ * Exported for callers that want to be explicit about having wrapped one. It is
+ * NOT required by {@link IslandRegistration}, and that is deliberate.
+ *
+ * Requiring the brand would catch a forgotten `lazyIsland(...)` at compile time,
+ * which is where a mistake is cheapest to find — but it also rejects code that
+ * compiles today, and this package's contract is that the existing public API
+ * keeps working, widening rather than replacing, with a codemod for anything
+ * that cannot be widened. There is no codemod infrastructure here to ship one
+ * through, so the narrowing is not taken: the mistake is caught at mount time
+ * instead, by the thenable guard in `enhance()`, which throws immediately with
+ * an actionable message and leaves the element unenhanced. Loud and instant at
+ * runtime beats a type error that arrives with a breaking change attached.
+ *
+ * The brand is a phantom STRING-keyed property, never a `unique symbol`. A
+ * `unique symbol` has nominal identity per declaration, so two copies of this
+ * package's `.d.ts` in one dependency tree would produce two incompatible
+ * types. That is not hypothetical: the registry is deliberately shared through
+ * `Symbol.for` precisely because duplicate copies are expected. The property
+ * exists only in the type — the runtime marker is the global symbol below.
+ */
+type LazyIslandLoader = IslandLoader & {
+    readonly __sibujsLazyIsland: true;
+};
+/**
+ * Either an inline setup, or a loader.
+ *
+ * Unchanged from 4.2: an unbranded `IslandLoader` is still accepted, so no
+ * previously-compiling code breaks. Wrapping with {@link lazyIsland} is what
+ * makes it *work* — see {@link LazyIslandLoader} for why this is not narrowed.
+ */
+type IslandRegistration = EnhanceSetup | IslandLoader | LazyIslandLoader;
 /**
  * Mark a loader as lazy island code — its module is fetched only when the island
  * activates, so a page ships ~0 JS for islands that never trigger.
@@ -1995,7 +2027,7 @@ type IslandRegistration = EnhanceSetup | IslandLoader;
  * registerIsland("chart", lazyIsland(() => import("./islands/chart.js")));
  * ```
  */
-declare function lazyIsland(loader: IslandLoader): IslandLoader;
+declare function lazyIsland(loader: IslandLoader): LazyIslandLoader;
 /**
  * Register an island by name. The setup is applied via `enhance()` when a
  * matching `[data-sibu-island="name"]` element activates.
@@ -2274,4 +2306,4 @@ declare const untracked: ReactiveApi["untracked"];
 declare const retrack: ReactiveApi["retrack"];
 declare const setMaxDrainIterations: ReactiveApi["setMaxDrainIterations"];
 
-export { type Accessor, type ActionFn, type AnchorProps, type ArrayActions, type AsyncDerivedContext, type AsyncDerivedState, type AudioProps, type ButtonProps, type Context, DynamicComponent, type EachBindings, type EachEventBindings, type EffectBody, type EffectOptions, type EnhanceContext, type EnhanceSetup, ErrorBoundary, type ErrorBoundaryOptions, type ErrorBoundaryProps, ErrorDisplay, type ErrorDisplayProps, type ErrorSeverity, type ExternalSource, type FormProps, Fragment, type ImgProps, type InputProps, type InputType, type IslandLoader, type IslandRegistration, type IslandStrategy, KeepAlive, type KeepAliveOptions, type LabelProps, Loading, type LoadingProps, type LongPressOptions, MAX_DRAIN_TEARDOWNS, type MediaProps, type MountIslandsOptions, NodeChild, NodeChildren, type OnCleanup, type OptionProps, Portal, type Ref, type RuntimeErrorContext, type RuntimeErrorHandler, type RuntimeErrorPhase, type SSRStore, type SelectProps, type SignalOptions, type SlotFn, type Slots, type StoreActions, Suspense, type SuspenseProps, TagProps, type TextareaProps, type TypedTagFunction, type VideoProps, __resetIdCounter, a, abbr, action, address, area, array, article, aside, asyncDerived, audio, autoResize, b, base, batch, bdi, bdo, bindDynamic, blockquote, body, br, button, canvas, caption, catchError, catchErrorAsync, center, checkLeaks, circle, cite, clickOutside, clipPath, code, col, colgroup, context, copyOnClick, createId, customElement, data, datalist, dd, deepEqual, deepSignal, defer, defs, del, derived, details, dfn, dialog, disableSSR, dispose, div, dl, dt, each, effect, ellipse, em, embed, enableSSR, enhance, enhanceAll, enqueueBatchedSignal, external, fieldset, figcaption, figure, font, footer, form, g, getAction, getRequestScopedCache, getRuntimeErrorHandler, getSSRStore, getSlot, h1, h2, h3, h4, h5, h6, head, header, hr, html, i, iframe, img, input, ins, isBatching, isSSR, kbd, label, lazy, lazyIsland, legend, li, line, linearGradient, link, longPress, main, map, mark, marker, marquee, mask, match, math, menu, meta, meter, mount, mountIslands, nav, nextTick, noscript, object, ol, on, onCleanup, onMount, onUnmount, optgroup, option, output, p, param, path, pattern, picture, polygon, polyline, portal, pre, progress, q, radialGradient, reactiveArray, rect, ref, registerAction, registerComponent, registerDisposer, registerIsland, replaceChildrenSafely, reportDrainRunaway, reportError, resolveComponent, retrack, rp, rt, ruby, runInSSRContext, s, samp, script, section, select, setGlobalErrorHandler, setMaxDrainIterations, setRuntimeErrorHandler, show, signal, slot, small, source, span, stop, store, strict, strictEffect, strong, style, sub, summary, sup, svg, symbol, table, takePendingError, tbody, td, template, text, textarea, tfoot, th, thead, time, title, tr, track$1 as track, transition, trapFocus, tspan, u, ul, unregisterComponent, unregisterDisposer, unregisterIsland, untracked, use, var_, video, watch, when, withSSR, writable };
+export { type Accessor, type ActionFn, type AnchorProps, type ArrayActions, type AsyncDerivedContext, type AsyncDerivedState, type AudioProps, type ButtonProps, type Context, DynamicComponent, type EachBindings, type EachEventBindings, type EffectBody, type EffectOptions, type EnhanceContext, type EnhanceSetup, ErrorBoundary, type ErrorBoundaryOptions, type ErrorBoundaryProps, ErrorDisplay, type ErrorDisplayProps, type ErrorSeverity, type ExternalSource, type FormProps, Fragment, type ImgProps, type InputProps, type InputType, type IslandLoader, type IslandRegistration, type IslandStrategy, KeepAlive, type KeepAliveOptions, type LabelProps, type LazyIslandLoader, Loading, type LoadingProps, type LongPressOptions, MAX_DRAIN_TEARDOWNS, type MediaProps, type MountIslandsOptions, NodeChild, NodeChildren, type OnCleanup, type OptionProps, Portal, type Ref, type RuntimeErrorContext, type RuntimeErrorHandler, type RuntimeErrorPhase, type SSRStore, type SelectProps, type SignalOptions, type SlotFn, type Slots, type StoreActions, Suspense, type SuspenseProps, TagProps, type TextareaProps, type TypedTagFunction, type VideoProps, __resetIdCounter, a, abbr, action, address, area, array, article, aside, asyncDerived, audio, autoResize, b, base, batch, bdi, bdo, bindDynamic, blockquote, body, br, button, canvas, caption, catchError, catchErrorAsync, center, checkLeaks, circle, cite, clickOutside, clipPath, code, col, colgroup, context, copyOnClick, createId, customElement, data, datalist, dd, deepEqual, deepSignal, defer, defs, del, derived, details, dfn, dialog, disableSSR, dispose, div, dl, dt, each, effect, ellipse, em, embed, enableSSR, enhance, enhanceAll, enqueueBatchedSignal, external, fieldset, figcaption, figure, font, footer, form, g, getAction, getRequestScopedCache, getRuntimeErrorHandler, getSSRStore, getSlot, h1, h2, h3, h4, h5, h6, head, header, hr, html, i, iframe, img, input, ins, isBatching, isSSR, kbd, label, lazy, lazyIsland, legend, li, line, linearGradient, link, longPress, main, map, mark, marker, marquee, mask, match, math, menu, meta, meter, mount, mountIslands, nav, nextTick, noscript, object, ol, on, onCleanup, onMount, onUnmount, optgroup, option, output, p, param, path, pattern, picture, polygon, polyline, portal, pre, progress, q, radialGradient, reactiveArray, rect, ref, registerAction, registerComponent, registerDisposer, registerIsland, replaceChildrenSafely, reportDrainRunaway, reportError, resolveComponent, retrack, rp, rt, ruby, runInSSRContext, s, samp, script, section, select, setGlobalErrorHandler, setMaxDrainIterations, setRuntimeErrorHandler, show, signal, slot, small, source, span, stop, store, strict, strictEffect, strong, style, sub, summary, sup, svg, symbol, table, takePendingError, tbody, td, template, text, textarea, tfoot, th, thead, time, title, tr, track$1 as track, transition, trapFocus, tspan, u, ul, unregisterComponent, unregisterDisposer, unregisterIsland, untracked, use, var_, video, watch, when, withSSR, writable };

package/dist/index.d.ts

@@ -1984,8 +1984,40 @@ type IslandStrategy = "load" | "idle" | "visible" | "interaction" | "media";
 type IslandLoader = () => Promise<EnhanceSetup | {
     default: EnhanceSetup;
 }>;
-/** Either an inline setup, or a {@link lazyIsland}-branded loader. */
-type IslandRegistration = EnhanceSetup | IslandLoader;
+/**
+ * A loader that has been through {@link lazyIsland}.
+ *
+ * Exported for callers that want to be explicit about having wrapped one. It is
+ * NOT required by {@link IslandRegistration}, and that is deliberate.
+ *
+ * Requiring the brand would catch a forgotten `lazyIsland(...)` at compile time,
+ * which is where a mistake is cheapest to find — but it also rejects code that
+ * compiles today, and this package's contract is that the existing public API
+ * keeps working, widening rather than replacing, with a codemod for anything
+ * that cannot be widened. There is no codemod infrastructure here to ship one
+ * through, so the narrowing is not taken: the mistake is caught at mount time
+ * instead, by the thenable guard in `enhance()`, which throws immediately with
+ * an actionable message and leaves the element unenhanced. Loud and instant at
+ * runtime beats a type error that arrives with a breaking change attached.
+ *
+ * The brand is a phantom STRING-keyed property, never a `unique symbol`. A
+ * `unique symbol` has nominal identity per declaration, so two copies of this
+ * package's `.d.ts` in one dependency tree would produce two incompatible
+ * types. That is not hypothetical: the registry is deliberately shared through
+ * `Symbol.for` precisely because duplicate copies are expected. The property
+ * exists only in the type — the runtime marker is the global symbol below.
+ */
+type LazyIslandLoader = IslandLoader & {
+    readonly __sibujsLazyIsland: true;
+};
+/**
+ * Either an inline setup, or a loader.
+ *
+ * Unchanged from 4.2: an unbranded `IslandLoader` is still accepted, so no
+ * previously-compiling code breaks. Wrapping with {@link lazyIsland} is what
+ * makes it *work* — see {@link LazyIslandLoader} for why this is not narrowed.
+ */
+type IslandRegistration = EnhanceSetup | IslandLoader | LazyIslandLoader;
 /**
  * Mark a loader as lazy island code — its module is fetched only when the island
  * activates, so a page ships ~0 JS for islands that never trigger.
@@ -1995,7 +2027,7 @@ type IslandRegistration = EnhanceSetup | IslandLoader;
  * registerIsland("chart", lazyIsland(() => import("./islands/chart.js")));
  * ```
  */
-declare function lazyIsland(loader: IslandLoader): IslandLoader;
+declare function lazyIsland(loader: IslandLoader): LazyIslandLoader;
 /**
  * Register an island by name. The setup is applied via `enhance()` when a
  * matching `[data-sibu-island="name"]` element activates.
@@ -2274,4 +2306,4 @@ declare const untracked: ReactiveApi["untracked"];
 declare const retrack: ReactiveApi["retrack"];
 declare const setMaxDrainIterations: ReactiveApi["setMaxDrainIterations"];
 
-export { type Accessor, type ActionFn, type AnchorProps, type ArrayActions, type AsyncDerivedContext, type AsyncDerivedState, type AudioProps, type ButtonProps, type Context, DynamicComponent, type EachBindings, type EachEventBindings, type EffectBody, type EffectOptions, type EnhanceContext, type EnhanceSetup, ErrorBoundary, type ErrorBoundaryOptions, type ErrorBoundaryProps, ErrorDisplay, type ErrorDisplayProps, type ErrorSeverity, type ExternalSource, type FormProps, Fragment, type ImgProps, type InputProps, type InputType, type IslandLoader, type IslandRegistration, type IslandStrategy, KeepAlive, type KeepAliveOptions, type LabelProps, Loading, type LoadingProps, type LongPressOptions, MAX_DRAIN_TEARDOWNS, type MediaProps, type MountIslandsOptions, NodeChild, NodeChildren, type OnCleanup, type OptionProps, Portal, type Ref, type RuntimeErrorContext, type RuntimeErrorHandler, type RuntimeErrorPhase, type SSRStore, type SelectProps, type SignalOptions, type SlotFn, type Slots, type StoreActions, Suspense, type SuspenseProps, TagProps, type TextareaProps, type TypedTagFunction, type VideoProps, __resetIdCounter, a, abbr, action, address, area, array, article, aside, asyncDerived, audio, autoResize, b, base, batch, bdi, bdo, bindDynamic, blockquote, body, br, button, canvas, caption, catchError, catchErrorAsync, center, checkLeaks, circle, cite, clickOutside, clipPath, code, col, colgroup, context, copyOnClick, createId, customElement, data, datalist, dd, deepEqual, deepSignal, defer, defs, del, derived, details, dfn, dialog, disableSSR, dispose, div, dl, dt, each, effect, ellipse, em, embed, enableSSR, enhance, enhanceAll, enqueueBatchedSignal, external, fieldset, figcaption, figure, font, footer, form, g, getAction, getRequestScopedCache, getRuntimeErrorHandler, getSSRStore, getSlot, h1, h2, h3, h4, h5, h6, head, header, hr, html, i, iframe, img, input, ins, isBatching, isSSR, kbd, label, lazy, lazyIsland, legend, li, line, linearGradient, link, longPress, main, map, mark, marker, marquee, mask, match, math, menu, meta, meter, mount, mountIslands, nav, nextTick, noscript, object, ol, on, onCleanup, onMount, onUnmount, optgroup, option, output, p, param, path, pattern, picture, polygon, polyline, portal, pre, progress, q, radialGradient, reactiveArray, rect, ref, registerAction, registerComponent, registerDisposer, registerIsland, replaceChildrenSafely, reportDrainRunaway, reportError, resolveComponent, retrack, rp, rt, ruby, runInSSRContext, s, samp, script, section, select, setGlobalErrorHandler, setMaxDrainIterations, setRuntimeErrorHandler, show, signal, slot, small, source, span, stop, store, strict, strictEffect, strong, style, sub, summary, sup, svg, symbol, table, takePendingError, tbody, td, template, text, textarea, tfoot, th, thead, time, title, tr, track$1 as track, transition, trapFocus, tspan, u, ul, unregisterComponent, unregisterDisposer, unregisterIsland, untracked, use, var_, video, watch, when, withSSR, writable };
+export { type Accessor, type ActionFn, type AnchorProps, type ArrayActions, type AsyncDerivedContext, type AsyncDerivedState, type AudioProps, type ButtonProps, type Context, DynamicComponent, type EachBindings, type EachEventBindings, type EffectBody, type EffectOptions, type EnhanceContext, type EnhanceSetup, ErrorBoundary, type ErrorBoundaryOptions, type ErrorBoundaryProps, ErrorDisplay, type ErrorDisplayProps, type ErrorSeverity, type ExternalSource, type FormProps, Fragment, type ImgProps, type InputProps, type InputType, type IslandLoader, type IslandRegistration, type IslandStrategy, KeepAlive, type KeepAliveOptions, type LabelProps, type LazyIslandLoader, Loading, type LoadingProps, type LongPressOptions, MAX_DRAIN_TEARDOWNS, type MediaProps, type MountIslandsOptions, NodeChild, NodeChildren, type OnCleanup, type OptionProps, Portal, type Ref, type RuntimeErrorContext, type RuntimeErrorHandler, type RuntimeErrorPhase, type SSRStore, type SelectProps, type SignalOptions, type SlotFn, type Slots, type StoreActions, Suspense, type SuspenseProps, TagProps, type TextareaProps, type TypedTagFunction, type VideoProps, __resetIdCounter, a, abbr, action, address, area, array, article, aside, asyncDerived, audio, autoResize, b, base, batch, bdi, bdo, bindDynamic, blockquote, body, br, button, canvas, caption, catchError, catchErrorAsync, center, checkLeaks, circle, cite, clickOutside, clipPath, code, col, colgroup, context, copyOnClick, createId, customElement, data, datalist, dd, deepEqual, deepSignal, defer, defs, del, derived, details, dfn, dialog, disableSSR, dispose, div, dl, dt, each, effect, ellipse, em, embed, enableSSR, enhance, enhanceAll, enqueueBatchedSignal, external, fieldset, figcaption, figure, font, footer, form, g, getAction, getRequestScopedCache, getRuntimeErrorHandler, getSSRStore, getSlot, h1, h2, h3, h4, h5, h6, head, header, hr, html, i, iframe, img, input, ins, isBatching, isSSR, kbd, label, lazy, lazyIsland, legend, li, line, linearGradient, link, longPress, main, map, mark, marker, marquee, mask, match, math, menu, meta, meter, mount, mountIslands, nav, nextTick, noscript, object, ol, on, onCleanup, onMount, onUnmount, optgroup, option, output, p, param, path, pattern, picture, polygon, polyline, portal, pre, progress, q, radialGradient, reactiveArray, rect, ref, registerAction, registerComponent, registerDisposer, registerIsland, replaceChildrenSafely, reportDrainRunaway, reportError, resolveComponent, retrack, rp, rt, ruby, runInSSRContext, s, samp, script, section, select, setGlobalErrorHandler, setMaxDrainIterations, setRuntimeErrorHandler, show, signal, slot, small, source, span, stop, store, strict, strictEffect, strong, style, sub, summary, sup, svg, symbol, table, takePendingError, tbody, td, template, text, textarea, tfoot, th, thead, time, title, tr, track$1 as track, transition, trapFocus, tspan, u, ul, unregisterComponent, unregisterDisposer, unregisterIsland, untracked, use, var_, video, watch, when, withSSR, writable };

package/dist/index.js

@@ -52,7 +52,7 @@ import {
   unregisterIsland,
   when,
   writable
-} from "./chunk-HZEBO22J.js";
+} from "./chunk-ADM46X22.js";
 import {
   a,
   abbr,
@@ -190,36 +190,36 @@ import {
   use,
   var_,
   video
-} from "./chunk-P3DHXBR6.js";
+} from "./chunk-36S2YPP4.js";
 import {
   trustHTML
 } from "./chunk-NIOYEGBQ.js";
 import {
   watch
-} from "./chunk-BMYYZWHX.js";
+} from "./chunk-RR7M3FHM.js";
 import {
   __resetIdCounter,
   createId
 } from "./chunk-CCSJMTRN.js";
 import {
   context
-} from "./chunk-FOWBJZDL.js";
+} from "./chunk-7NBDXVHS.js";
 import {
   SVG_NS,
   tagFactory
-} from "./chunk-6ZGI3RBE.js";
+} from "./chunk-PNIRUQ4C.js";
 import {
   bindDynamic
-} from "./chunk-HJEPKZ2O.js";
+} from "./chunk-VCTAEPSB.js";
 import {
   derived
-} from "./chunk-2LOYNGBY.js";
+} from "./chunk-W2EQ7X2L.js";
 import "./chunk-IXKSNWV5.js";
 import "./chunk-7ZHH77QA.js";
 import {
   effect,
   on
-} from "./chunk-7VEC3UD2.js";
+} from "./chunk-7GIHSAWB.js";
 import {
   disableSSR,
   enableSSR,
@@ -244,12 +244,12 @@ import {
   external,
   isBatching,
   signal
-} from "./chunk-HECVW343.js";
+} from "./chunk-NVNJH22U.js";
 import {
   retrack,
   setMaxDrainIterations,
   untracked
-} from "./chunk-7ALC7KGE.js";
+} from "./chunk-3BTTCZ5J.js";
 import {
   getRuntimeErrorHandler,
   reportError,

package/dist/motion.cjs

@@ -700,7 +700,7 @@ function forEachSubscriber(signal2, visit) {
 }
 
 // src/reactivity/track.ts
-var _runtimeVersion = true ? "4.2.0" : "dev";
+var _runtimeVersion = true ? "4.4.0" : "dev";
 var REGISTRY_KEY = /* @__PURE__ */ Symbol.for("sibujs.reactive.v1");
 function resolveReactiveApi() {
   const g = globalThis;

package/dist/motion.js

@@ -20,10 +20,10 @@ import {
   stagger,
   transition,
   viewTransition
-} from "./chunk-3VTSPNC5.js";
+} from "./chunk-SKPTERHP.js";
 import "./chunk-QKRPLZ2V.js";
-import "./chunk-HECVW343.js";
-import "./chunk-7ALC7KGE.js";
+import "./chunk-NVNJH22U.js";
+import "./chunk-3BTTCZ5J.js";
 import "./chunk-2WLZ6757.js";
 export {
   TransitionGroup,