@async/framework 0.11.2 → 0.11.4

package/CHANGELOG.md

@@ -1,5 +1,33 @@
 # Changelog
 
+## 0.11.4 - 2026-06-18
+
+- Restored snapshot signal keys as exact IDs so dotted plain, async, and
+  component-scoped signal IDs such as `product.load` survive SSR activation
+  without becoming nested properties under their first segment.
+- Adopted async-signal descriptors before restoring matching snapshot state so
+  dotted async signals preserve `$value`, `$status`, and `$version` without an
+  immediate client refresh.
+- Kept server-result signal patches on nested first-segment path semantics for
+  updates such as `product.title`.
+- Bundle size from bundled TypeScript source: `browser.ts` 180,585 B raw /
+  33,742 B gzip -> `browser.min.js` 76,946 B raw / 22,793 B gzip
+  (-103,639 B raw, -10,949 B gzip).
+
+## 0.11.3 - 2026-06-18
+
+- Isolated runtime-owned signal, async-signal, scheduler, request, and cache
+  state so each `createApp(...)` call materializes fresh mutable state from
+  reusable app declarations.
+- Preserved reusable app declarations across runtime destroy/recreate cycles,
+  late `app.use(...)` adoption, server render repetition, and peer async-signal
+  subscribers.
+- Added direct runtime-isolation regression coverage and regenerated the
+  published browser/server artifacts.
+- Bundle size from bundled TypeScript source: `browser.ts` 179,469 B raw /
+  33,612 B gzip -> `browser.min.js` 76,458 B raw / 22,690 B gzip
+  (-103,011 B raw, -10,922 B gzip).
+
 ## 0.11.2 - 2026-06-18
 
 - Published the post-`0.11.1` feedback-regression hardening now on `main`,

package/README.md

@@ -430,7 +430,9 @@ Singular registry keys are canonical: `signal`, `handler`, `server`,
 ### Registry Inspection
 
 `Async.registry` is the global inspection surface for registered app pieces.
-Every runtime and concrete registry also points at the same backing store:
+Every runtime owns fresh mutable signal and cache state materialized from the
+app declaration store. Concrete registries inside one runtime share that
+runtime's registry view:
 
 ```js
 Async.registry.keys("signal");

package/browser.js

@@ -185,6 +185,10 @@ const __asyncSignalModule = (() => {
         };
       },
 
+      _cloneSignalDeclaration() {
+        return asyncSignal(id, fn);
+      },
+
       _restore(snapshot = {}) {
         if (!isAsyncSignalSnapshot(snapshot)) {
           return state.set(snapshot);
@@ -956,7 +960,12 @@ const __cacheModule = (() => {
         return registryStore.entries(`${type}.entries`);
       },
 
-      _adoptMany() {
+      _adoptMany(map = {}) {
+        for (const [id, definition] of Object.entries(map ?? {})) {
+          if (!definitions.has(id)) {
+            registryApi.register(id, definition);
+          }
+        }
         return registryApi;
       }
     }, registryStore, type);
@@ -1114,6 +1123,10 @@ const __signalsModule = (() => {
 
       snapshot() {
         return value;
+      },
+
+      _cloneSignalDeclaration() {
+        return createSignal(value);
       }
     };
 
@@ -1156,6 +1169,10 @@ const __signalsModule = (() => {
         return backing.snapshot();
       },
 
+      _cloneSignalDeclaration() {
+        return computed(fn);
+      },
+
       _bindRegistry(registry, id) {
         return registry.effect(() => {
           backing.set(fn.call({
@@ -1180,6 +1197,9 @@ const __signalsModule = (() => {
       [effectKind]: true,
       kind: "effect",
       fn,
+      _cloneSignalDeclaration() {
+        return effect(fn);
+      },
       _bindRegistry(registry) {
         return registry.effect(fn);
       }
@@ -1388,6 +1408,24 @@ const __signalsModule = (() => {
         return requireEntry(entries, id);
       },
 
+      _setPath(path, value) {
+        const parsed = parseRootPath(path);
+        if (!entries.has(parsed.id)) {
+          if (asyncDescriptors.has(parsed.id)) {
+            materializeAsyncSignal(parsed.id);
+          } else {
+            registry.register(parsed.id, createSignal(parsed.parts.length === 0 ? value : {}));
+          }
+        }
+        const entry = requireEntry(entries, parsed.id);
+        if (parsed.parts.length === 0) {
+          return entry.set(value);
+        }
+        const nextValue = setPath(entry.value, parsed.parts, value);
+        entry.set(nextValue);
+        return value;
+      },
+
       _setContext(context = {}) {
         Object.assign(runtimeContext, context);
         return registry;
@@ -1398,10 +1436,14 @@ const __signalsModule = (() => {
       },
 
       _adoptMany(map = {}) {
-        for (const id of Object.keys(map ?? {})) {
-          if (entries.has(id)) {
-            bindEntry(id, entries.get(id));
+        for (const [id, signalLike] of Object.entries(map ?? {})) {
+          if (!entries.has(id)) {
+            const entry = cloneSignalDeclaration(signalLike);
+            entries.set(id, entry);
+            bindEntry(id, entry);
+            continue;
           }
+          bindEntry(id, entries.get(id));
         }
         return registry;
       }
@@ -1440,6 +1482,14 @@ const __signalsModule = (() => {
       return { id, parts, path };
     }
 
+    function parseRootPath(path) {
+      if (typeof path !== "string" || path.length === 0) {
+        throw new TypeError("Signal path must be a non-empty string.");
+      }
+      const [id, ...parts] = path.split(".");
+      return { id, parts, path };
+    }
+
     function materializeAsyncSignal(id) {
       if (entries.has(id) || !asyncDescriptors.has(id)) {
         return;
@@ -1479,6 +1529,16 @@ const __signalsModule = (() => {
     return createSignal(signalLike);
   }
 
+  function cloneSignalDeclaration(signalLike) {
+    if (typeof signalLike?._cloneSignalDeclaration === "function") {
+      return signalLike._cloneSignalDeclaration();
+    }
+    if (isSignalLike(signalLike)) {
+      return createSignal(typeof signalLike.snapshot === "function" ? signalLike.snapshot() : signalLike.value);
+    }
+    return createSignal(signalLike);
+  }
+
   function isSignalLike(value) {
     return Boolean(value && typeof value === "object" && typeof value.subscribe === "function");
   }
@@ -1657,7 +1717,7 @@ const __signalsModule = (() => {
       frame.add(path);
     }
   }
-  return { createSignal, computed, effect, createSignalRegistry, isSignalRef, signal };
+  return { createSignal, computed, effect, createSignalRegistry, cloneSignalDeclaration, isSignalRef, signal };
 })();
 
 const __htmlModule = (() => {
@@ -1899,7 +1959,12 @@ const __componentModule = (() => {
         return lazyComponents.get(id);
       },
 
-      _adoptMany() {
+      _adoptMany(map = {}) {
+        for (const [id, Component] of Object.entries(map ?? {})) {
+          if (!entries.has(id)) {
+            registry.register(id, Component);
+          }
+        }
         return registry;
       }
     }, registryStore, type);
@@ -2739,7 +2804,12 @@ const __handlersModule = (() => {
         return results;
       },
 
-      _adoptMany() {
+      _adoptMany(map = {}) {
+        for (const [id, fn] of Object.entries(map ?? {})) {
+          if (!handlers.has(id)) {
+            registry.register(id, fn);
+          }
+        }
         return registry;
       }
     }, registryStore, type);
@@ -4028,7 +4098,12 @@ const __partialsModule = (() => {
         return normalizePartialResult(result, partialContext);
       },
 
-      _adoptMany() {
+      _adoptMany(map = {}) {
+        for (const [id, fn] of Object.entries(map ?? {})) {
+          if (!entries.has(id)) {
+            registry.register(id, fn);
+          }
+        }
         return registry;
       }
     }, registryStore, type);
@@ -4180,7 +4255,11 @@ const __routerModule = (() => {
       },
 
       _adoptMany(map = {}) {
-        for (const pattern of Object.keys(map ?? {})) {
+        for (const [pattern, definition] of Object.entries(map ?? {})) {
+          if (!entries.has(pattern)) {
+            registry.register(pattern, definition);
+            continue;
+          }
           adoptRoute(pattern, entries.get(pattern));
         }
         return registry;
@@ -4676,7 +4755,7 @@ const __appModule = (() => {
   const { createRouteRegistry, createRouter } = __routerModule;
   const { createScheduler } = __schedulerModule;
   const { createServerNamespace } = __serverModule;
-  const { createSignal, createSignalRegistry } = __signalsModule;
+  const { cloneSignalDeclaration, createSignal, createSignalRegistry } = __signalsModule;
   const { createRegistryStore } = __registryStoreModule;
   const { attributeName, normalizeAttributeConfig } = __attributesModule;
   const { createLazyRegistry, defineRegistrySnapshot, sameRegistryValue } = __lazyRegistryModule;
@@ -4759,7 +4838,7 @@ const __appModule = (() => {
       registryAssets: options.registryAssets,
       importModule: options.importModule
     });
-    const registry = options.registry ?? app.registry.view({ target });
+    const registry = options.registry ?? createRuntimeRegistry(app.registry, { target });
     const signals = options.signals ?? createSignalRegistry(undefined, { registry, type: "signal", lazyRegistry });
     const handlers = options.handlers ?? createHandlerRegistry(undefined, { registry, type: "handler", lazyRegistry });
     const serverCache = createCacheRegistry(undefined, { registry, type: "cache.server" });
@@ -4951,7 +5030,7 @@ const __appModule = (() => {
 
         if (result.signals) {
           for (const [path, value] of Object.entries(result.signals)) {
-            setOrRegisterSignal(signals, path, value);
+            applySignalPatch(signals, path, value);
           }
         }
         if (result.cache?.browser) {
@@ -5140,6 +5219,22 @@ const __appModule = (() => {
     registry?.registerMany?.(entries);
   }
 
+  function createRuntimeRegistry(appRegistry, { target } = {}) {
+    const declarations = appRegistry.rawSnapshot();
+    return createRegistryStore({
+      ...declarations,
+      signal: cloneSignalDeclarations(declarations.signal)
+    }, { target });
+  }
+
+  function cloneSignalDeclarations(signals = {}) {
+    const cloned = {};
+    for (const [id, signalLike] of Object.entries(signals ?? {})) {
+      cloned[id] = cloneSignalDeclaration(signalLike);
+    }
+    return cloned;
+  }
+
   function emptyDeclarations() {
     return {
       signal: {},
@@ -5213,8 +5308,9 @@ const __appModule = (() => {
 
   function applySnapshotToRuntime(runtime, snapshot = {}, options = {}) {
     const normalized = normalizeSnapshot(snapshot);
-    for (const [path, value] of Object.entries(normalized.signal)) {
-      setOrRegisterSignal(runtime.signals, path, value);
+    mergeRegistryEntries(runtime, "asyncSignal", normalized.asyncSignal, null, options);
+    for (const [id, value] of Object.entries(normalized.signal)) {
+      restoreSignalEntry(runtime.signals, id, value);
     }
     runtime.browser.cache.restore(normalized.cache.browser);
     mergeRegistryEntries(runtime, "handler", normalized.handler, runtime.handlers, options);
@@ -5222,7 +5318,6 @@ const __appModule = (() => {
     mergeRegistryEntries(runtime, "partial", normalized.partial, runtime.partials, options);
     mergeRegistryEntries(runtime, "route", normalized.route, runtime.routes, options);
     mergeRegistryEntries(runtime, "component", normalized.component, runtime.components, options);
-    mergeRegistryEntries(runtime, "asyncSignal", normalized.asyncSignal, null, options);
     return runtime;
   }
 
@@ -5328,16 +5423,26 @@ const __appModule = (() => {
     }
   }
 
-  function setOrRegisterSignal(signals, path, value) {
-    const id = String(path).split(".")[0];
+  function restoreSignalEntry(signals, id, value) {
     if (signals.has?.(id)) {
-      if (path === id) {
-        const entry = signals._entry?.(id);
-        if (typeof entry?._restore === "function" && isAsyncSignalSnapshot(value)) {
-          entry._restore(value);
-          return;
-        }
+      const entry = signals._entry?.(id);
+      if (typeof entry?._restore === "function" && isAsyncSignalSnapshot(value)) {
+        entry._restore(value);
+        return;
       }
+      signals.set(id, value);
+      return;
+    }
+    signals.register(id, createSignal(value));
+  }
+
+  function applySignalPatch(signals, path, value) {
+    if (typeof signals._setPath === "function") {
+      signals._setPath(path, value);
+      return;
+    }
+    const id = String(path).split(".")[0];
+    if (signals.has?.(id)) {
       signals.set(path, value);
       return;
     }