@async/framework 0.11.2 → 0.11.4

package/framework.ts

@@ -188,6 +188,10 @@ const __asyncSignalModule = (() => {
         };
       },
 
+      _cloneSignalDeclaration() {
+        return asyncSignal(id, fn);
+      },
+
       _restore(snapshot = {}) {
         if (!isAsyncSignalSnapshot(snapshot)) {
           return state.set(snapshot);
@@ -959,7 +963,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);
@@ -1117,6 +1126,10 @@ const __signalsModule = (() => {
 
       snapshot() {
         return value;
+      },
+
+      _cloneSignalDeclaration() {
+        return createSignal(value);
       }
     };
 
@@ -1159,6 +1172,10 @@ const __signalsModule = (() => {
         return backing.snapshot();
       },
 
+      _cloneSignalDeclaration() {
+        return computed(fn);
+      },
+
       _bindRegistry(registry, id) {
         return registry.effect(() => {
           backing.set(fn.call({
@@ -1183,6 +1200,9 @@ const __signalsModule = (() => {
       [effectKind]: true,
       kind: "effect",
       fn,
+      _cloneSignalDeclaration() {
+        return effect(fn);
+      },
       _bindRegistry(registry) {
         return registry.effect(fn);
       }
@@ -1391,6 +1411,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;
@@ -1401,10 +1439,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;
       }
@@ -1443,6 +1485,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;
@@ -1482,6 +1532,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");
   }
@@ -1660,7 +1720,7 @@ const __signalsModule = (() => {
       frame.add(path);
     }
   }
-  return { createSignal, computed, effect, createSignalRegistry, isSignalRef, signal };
+  return { createSignal, computed, effect, createSignalRegistry, cloneSignalDeclaration, isSignalRef, signal };
 })();
 
 const __htmlModule = (() => {
@@ -1902,7 +1962,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);
@@ -2742,7 +2807,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);
@@ -4031,7 +4101,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);
@@ -4183,7 +4258,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;
@@ -4679,7 +4758,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;
@@ -4762,7 +4841,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" });
@@ -4954,7 +5033,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) {
@@ -5143,6 +5222,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: {},
@@ -5216,8 +5311,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);
@@ -5225,7 +5321,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;
   }
 
@@ -5331,16 +5426,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;
     }
@@ -5611,7 +5716,12 @@ const __serverRegistryModule = (() => {
         return registry;
       },
 
-      _adoptMany() {
+      _adoptMany(map = {}) {
+        for (const [id, fn] of Object.entries(map ?? {})) {
+          if (!entries.has(id)) {
+            registry.register(id, fn);
+          }
+        }
         return registry;
       }
     }, registryStore, type);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@async/framework",
-  "version": "0.11.2",
+  "version": "0.11.4",
   "description": "No-build Loader app runtime with browser and server entrypoints, signals, command events, route partials, cache split, SSR activation, and streaming boundaries.",
   "type": "module",
   "main": "./server.js",

package/server.js

@@ -187,6 +187,10 @@ const __asyncSignalModule = (() => {
         };
       },
 
+      _cloneSignalDeclaration() {
+        return asyncSignal(id, fn);
+      },
+
       _restore(snapshot = {}) {
         if (!isAsyncSignalSnapshot(snapshot)) {
           return state.set(snapshot);
@@ -958,7 +962,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);
@@ -1116,6 +1125,10 @@ const __signalsModule = (() => {
 
       snapshot() {
         return value;
+      },
+
+      _cloneSignalDeclaration() {
+        return createSignal(value);
       }
     };
 
@@ -1158,6 +1171,10 @@ const __signalsModule = (() => {
         return backing.snapshot();
       },
 
+      _cloneSignalDeclaration() {
+        return computed(fn);
+      },
+
       _bindRegistry(registry, id) {
         return registry.effect(() => {
           backing.set(fn.call({
@@ -1182,6 +1199,9 @@ const __signalsModule = (() => {
       [effectKind]: true,
       kind: "effect",
       fn,
+      _cloneSignalDeclaration() {
+        return effect(fn);
+      },
       _bindRegistry(registry) {
         return registry.effect(fn);
       }
@@ -1390,6 +1410,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;
@@ -1400,10 +1438,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;
       }
@@ -1442,6 +1484,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;
@@ -1481,6 +1531,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");
   }
@@ -1659,7 +1719,7 @@ const __signalsModule = (() => {
       frame.add(path);
     }
   }
-  return { createSignal, computed, effect, createSignalRegistry, isSignalRef, signal };
+  return { createSignal, computed, effect, createSignalRegistry, cloneSignalDeclaration, isSignalRef, signal };
 })();
 
 const __htmlModule = (() => {
@@ -1901,7 +1961,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);
@@ -2741,7 +2806,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);
@@ -4030,7 +4100,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);
@@ -4182,7 +4257,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;
@@ -4678,7 +4757,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;
@@ -4761,7 +4840,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" });
@@ -4953,7 +5032,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) {
@@ -5142,6 +5221,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: {},
@@ -5215,8 +5310,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);
@@ -5224,7 +5320,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;
   }
 
@@ -5330,16 +5425,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;
     }
@@ -5610,7 +5715,12 @@ const __serverRegistryModule = (() => {
         return registry;
       },
 
-      _adoptMany() {
+      _adoptMany(map = {}) {
+        for (const [id, fn] of Object.entries(map ?? {})) {
+          if (!entries.has(id)) {
+            registry.register(id, fn);
+          }
+        }
         return registry;
       }
     }, registryStore, type);