@async/framework 0.5.0 → 0.7.0

package/CHANGELOG.md

@@ -1,5 +1,37 @@
 # Changelog
 
+## 0.7.0 - 2026-06-17
+
+- Added router navigation abort/version guards so stale route partials cannot
+  clobber newer navigations, and route partial contexts receive `this.abort`.
+- Added ranked route matching so static and dynamic routes win over wildcard
+  fallbacks regardless of registration order.
+- Added `readSnapshot(...)` and automatic browser activation from SSR snapshot
+  scripts.
+- Fixed repeated server result application when proxy/server envelopes pass
+  through namespace or handler callers.
+- Added in-flight `cache.getOrSet(...)` deduplication and clear proxy errors for
+  `File`, `Blob`, and `FormData` values that the JSON transport cannot send.
+- Changed `framework.ts` from a source facade to a bundled TypeScript source
+  entrypoint.
+
+## 0.6.0 - 2026-06-17
+
+- Added `Loader` as the canonical public loader factory, including
+  `Async.Loader(...)` for UMD script-tag usage, while keeping `AsyncLoader` as
+  a compatibility alias.
+- Added generated root CDN artifacts: `framework.min.js`, `framework.umd.js`,
+  `framework.umd.min.js`, `framework.ts`, and `framework.d.ts`.
+- Added package exports and docs for ESM, compact ESM, UMD, compact UMD, and
+  TypeScript source/types entrypoints.
+- Added exported helpers to the UMD-only `globalThis.Async` object for
+  script-tag CDN usage while keeping ESM `Async` as the app hub export.
+- Added UMD namespace conflict checks so generated helpers cannot silently
+  overwrite app-hub fields such as `use`, `start`, or `registry`.
+- Added `registry:lint`, a cached package linter that emits a local registry
+  manifest and detects conflicting signal, handler, server, partial, route, or
+  component declarations while skipping generated root bundles.
+
 ## 0.5.0 - 2026-06-17
 
 - Added `this.suspense(signalRef, views)` for component-owned async boundary

package/README.md

@@ -90,9 +90,18 @@ and package lifecycle tooling. Browser consumers import ESM directly.
 
 ## CDN
 
-The package ships a root `framework.js` ESM bundle for UNPKG and can be loaded
-without a build step. Use `@latest` for quick prototypes, and pin an exact
-version in production:
+The package ships root CDN artifacts for UNPKG and can be loaded without a
+build step. Use `@latest` for quick prototypes, and pin an exact version in
+production:
+
+| File | Format | Use |
+| --- | --- | --- |
+| `framework.js` | ESM | Readable browser module bundle |
+| `framework.min.js` | ESM | Compact browser module bundle |
+| `framework.umd.js` | UMD | Readable script-tag/CommonJS-style bundle |
+| `framework.umd.min.js` | UMD | Compact script-tag/CommonJS-style bundle and default CDN file |
+| `framework.ts` | Bundled TypeScript source | TS-aware runtimes and higher-layer tooling |
+| `framework.d.ts` | Type declarations | TypeScript declarations for the public API |
 
 ```html
 <main async:container>
@@ -121,6 +130,29 @@ version in production:
 </script>
 ```
 
+For a plain script tag, use the UMD bundle. In this UMD-only global form,
+`globalThis.Async` is the app hub plus the exported helper functions, with
+`globalThis.AsyncFramework` kept as an alias. Lower-level bootloader code can
+call `Async.Loader(...)` directly.
+
+```html
+<script src="https://unpkg.com/@async/framework@latest/framework.umd.min.js"></script>
+<script>
+  Async.use({
+    signal: {
+      count: Async.createSignal(0)
+    },
+    handler: {
+      increment() {
+        this.signals.update("count", (count) => count + 1);
+      }
+    }
+  });
+
+  Async.start({ root: document });
+</script>
+```
+
 You can also use an import map so app code imports `@async/framework` by name:
 
 ```html
@@ -157,8 +189,8 @@ You can also use an import map so app code imports `@async/framework` by name:
 
 ```js
 import {
-  AsyncLoader,
   Async,
+  Loader,
   attributeName,
   asyncSignal,
   createApp,
@@ -183,11 +215,15 @@ import {
   delay,
   effect,
   html,
+  readSnapshot,
   route,
   signal
 } from "@async/framework";
 ```
 
+`Loader` is the canonical loader factory. `AsyncLoader` remains as a
+compatibility alias for older code.
+
 ### App Hub
 
 `Async` is an exported app hub singleton. It is not installed on `globalThis`
@@ -376,9 +412,13 @@ await delay(250, this.abort);
 If a dependency read through `this.signals.get(...)` changes, the async signal
 reruns and the previous run is aborted.
 
+Dependency reads are captured while the async signal function starts running.
+Read signal dependencies before the first `await`; reads that happen later are
+ordinary reads and do not create refresh subscriptions.
+
 ## HTML Protocol
 
-AsyncLoader scans regular HTML attributes:
+Loader scans regular HTML attributes:
 
 | Attribute | Behavior |
 | --- | --- |
@@ -784,15 +824,21 @@ hydrate, diff, patch, or rerender:
 ```js
 createApp(browserApp, {
   root: document,
-  snapshot,
   server: createServerProxy({ endpoint: "/__async/server" })
 }).start();
 ```
 
+If an `async:snapshot` script is present under the root or document,
+`createApp(...)` reads it automatically. You can also inspect it directly:
+
+```js
+const snapshot = readSnapshot(document);
+```
+
 ## Components
 
 Components are scoped fragment functions. They return strings or `html`
-templates; AsyncLoader inserts and scans the result. There is no virtual node
+templates; Loader inserts and scans the result. There is no virtual node
 type and no rerender loop.
 
 ```js
@@ -822,7 +868,7 @@ const Toggle = defineComponent(function Toggle() {
   `;
 });
 
-const loader = AsyncLoader({ root: document });
+const loader = Loader({ root: document });
 loader.mount(document.querySelector("#app"), Toggle);
 ```
 
@@ -845,7 +891,7 @@ Component helpers:
 | `this.onMount(fn)` | Compatibility alias for `this.on("attach", fn)` |
 | `this.onVisible(fn)` | Compatibility alias for `this.on("visible", fn)` |
 
-`this.suspense(...)` is sugar for AsyncLoader boundaries:
+`this.suspense(...)` is sugar for Loader boundaries:
 `asyncSignal + async:boundary + async:* templates`. It emits only templates. The
 caller owns the boundary element, and the loader chooses the loading, ready, or
 error template from the async signal status.
@@ -967,10 +1013,19 @@ Useful commands:
 ```bash
 pnpm run pipeline:verify
 pnpm run pipeline:pages
+pnpm run registry:lint
 pnpm run pipeline:release:doctor
 pnpm run release:check
 ```
 
+`registry:lint` scans package source and examples for declared registry ids
+such as signals, handlers, server functions, partials, routes, and components.
+It writes `.async/registry-manifest.json` plus a per-file cache at
+`.async/registry-lint-cache.json`, skips generated root bundles such as
+`framework.umd.min.js`, and fails only when the same registry type and id are
+declared with different normalized content. Duplicate declarations with the
+same content are reported as dedupe candidates, not errors.
+
 GitHub Pages builds through the generated `pages` job. This private repository
 needs GitHub Pages support enabled before the generated job can deploy.
 

package/examples/cache/index.html

@@ -3,7 +3,7 @@
   <head>
     <meta charset="utf-8">
     <meta name="viewport" content="width=device-width, initial-scale=1">
-    <title>AsyncLoader Cache</title>
+    <title>Async Loader Cache</title>
   </head>
   <body>
     <main async:container>

package/examples/components/index.html

@@ -2,7 +2,7 @@
 <html lang="en">
   <head>
     <meta charset="utf-8">
-    <title>AsyncLoader Components</title>
+    <title>Async Loader Components</title>
   </head>
   <body>
     <main id="app"></main>

package/examples/components/main.js

@@ -1,4 +1,4 @@
-import { AsyncLoader, defineComponent, html } from "../../src/index.js";
+import { Loader, defineComponent, html } from "../../src/index.js";
 
 const Toggle = defineComponent(function Toggle() {
   const selected = this.signal(false);
@@ -22,5 +22,5 @@ const Toggle = defineComponent(function Toggle() {
   `;
 });
 
-const loader = AsyncLoader({ root: document });
+const loader = Loader({ root: document });
 loader.mount(document.querySelector("#app"), Toggle);

package/examples/counter/index.html

@@ -2,7 +2,7 @@
 <html lang="en">
   <head>
     <meta charset="utf-8">
-    <title>AsyncLoader Counter</title>
+    <title>Async Loader Counter</title>
   </head>
   <body async:container>
     <main>

package/examples/partials/index.html

@@ -3,7 +3,7 @@
   <head>
     <meta charset="utf-8">
     <meta name="viewport" content="width=device-width, initial-scale=1">
-    <title>AsyncLoader Partials</title>
+    <title>Async Loader Partials</title>
   </head>
   <body>
     <main async:container>

package/examples/product/index.html

@@ -2,7 +2,7 @@
 <html lang="en">
   <head>
     <meta charset="utf-8">
-    <title>AsyncLoader Product</title>
+    <title>Async Loader Product</title>
   </head>
   <body async:container>
     <main>

package/examples/product/main.js

@@ -1,4 +1,4 @@
-import { AsyncLoader, createSignal, createSignalRegistry, delay } from "../../src/index.js";
+import { Loader, createSignal, createSignalRegistry, delay } from "../../src/index.js";
 
 const products = {
   "sku-1": {
@@ -21,4 +21,4 @@ signals.asyncSignal("product", async function () {
   return products[id];
 });
 
-AsyncLoader({ root: document.body, signals }).start();
+Loader({ root: document.body, signals }).start();

package/examples/router/index.html

@@ -3,7 +3,7 @@
   <head>
     <meta charset="utf-8">
     <meta name="viewport" content="width=device-width, initial-scale=1">
-    <title>AsyncLoader CSR Router</title>
+    <title>Async Loader CSR Router</title>
   </head>
   <body>
     <main async:container>

package/examples/server-call/index.html

@@ -3,7 +3,7 @@
   <head>
     <meta charset="utf-8">
     <meta name="viewport" content="width=device-width, initial-scale=1">
-    <title>AsyncLoader Server Call</title>
+    <title>Async Loader Server Call</title>
   </head>
   <body>
     <main async:container>

package/examples/ssr/index.html

@@ -3,7 +3,7 @@
   <head>
     <meta charset="utf-8">
     <meta name="viewport" content="width=device-width, initial-scale=1">
-    <title>AsyncLoader SSR Activation</title>
+    <title>Async Loader SSR Activation</title>
   </head>
   <body>
     <main id="app" async:container></main>

package/examples/streaming/index.html

@@ -2,7 +2,7 @@
 <html lang="en">
   <head>
     <meta charset="utf-8">
-    <title>AsyncLoader Streaming</title>
+    <title>Async Loader Streaming</title>
   </head>
   <body async:container>
     <main>