@kudzujs/core 0.8.9 → 0.8.11

package/README.md

@@ -8,9 +8,13 @@ HTML-first TSX framework with synchronous state semantics and no virtual DOM.
 
 Kudzu compiles ordinary React-shaped TypeScript and TSX into complete static HTML, CSS, and only the route-specific ESM capabilities actually used. Static pages ship zero JavaScript. React, hydration, a VDOM, and a retained browser component tree are not part of the output.
 
+[![Watch the 22-second Kudzu compiler overview](https://raw.githubusercontent.com/kudzujs/kudzu/main/media/kudzu-demo-cover.png)](https://github.com/kudzujs/kudzu/blob/main/media/kudzu-demo.mp4)
+
+*Watch: React-shaped TSX to static HTML and route-specific ESM in 22 seconds.*
+
 > Experimental `0.8.x`: the compiler API and supported TSX surface may change.
 
-**Latest release: 0.8.9 - Context-backed CRUD actions.** A relative custom hook may directly return `useContext(Context)` for one analyzable Provider whose state-backed actions compile into existing route handler ESM, without a browser Context tree. Read the [release notes](./RELEASES.md#089---context-backed-crud-actions) or open the [release page](https://kudzujs.cloud/releases/0.8.9).
+**Latest release: 0.8.11 - Stale-safe data migration.** Build-known query data moves to async pages, browser-only reads move to route effects, and superseded promise or fetch setters can no longer overwrite newer state. Read the [release notes](./RELEASES.md#0811---stale-safe-data-migration) or open the [release page](https://kudzujs.cloud/releases/0.8.11).
 
 - [Documentation](https://kudzujs.cloud/docs)
 - [Installation guide](https://kudzujs.cloud/docs#install)

package/RELEASES.md

@@ -1,5 +1,61 @@
 # Kudzu Releases
 
+## 0.8.11 - Stale-safe data migration
+
+Kudzu 0.8.11 proves source migration paths for TanStack Query-shaped data and React Hook Form-shaped forms while strengthening dependency-effect stale-write isolation.
+
+### New in 0.8.11
+
+- Build-known query data moves to async pages and emits complete zero-JavaScript HTML.
+- Browser-only query data uses one dependency effect with application-owned loading, error, result, and primitive refetch state.
+- Superseded unowned dependency effects invalidate their invocation before cleanup, so late promise or fetch setters cannot overwrite newer state.
+- A deterministic Chrome race verifies that a fast refetch remains visible after a delayed prior response arrives, followed by HTTP failure and recovery.
+- React Hook Form-shaped signup source migrates to native controls, constraint validation, `FormData`, one async submit handler, accessible server errors, and retained uncontrolled values.
+- Static sibling routes remain JavaScript-free, with no TanStack Query or React Hook Form runtime in deploy output.
+
+### Fixed in 0.8.11
+
+- Mobile documentation now uses a true 100% layout wrapper with explicit inner gutters instead of a reduced outer width.
+- The complete suite passes 142/142 tests.
+
+### Boundary
+
+This release does not execute TanStack Query or React Hook Form. Query clients, Providers, caches, retries, deduplication, optimistic cache updates, query-key arrays, Suspense, controllers, watchers, resolvers, and dynamic field registration remain source migration work.
+
+### Upgrade
+
+```bash
+npm install @kudzujs/core@^0.8.11
+```
+
+## 0.8.10 - Native dialog migration
+
+Kudzu 0.8.10 proves a source migration path from a shadcn/Radix-shaped dialog to the native `<dialog>` element without adding package compatibility runtime.
+
+### New in 0.8.10
+
+- A reduced migration fixture preserves a relative `forwardRef` component, props, children, object refs, and ordinary JSX event handlers.
+- Package-owned Portal and Context behavior becomes native `showModal()`, `close()`, and cancel handling.
+- Complete accessible dialog markup is pre-rendered while route output includes only the `click` and `cancel` events it uses.
+- Chrome coverage verifies modal top-layer behavior, initial focus, confirm and cancel paths, and explicit trigger-focus restoration.
+- Public documentation now includes the migration recipe and its deliberate library boundary.
+
+### Fixed in 0.8.10
+
+- Mobile documentation code blocks stay within the content grid and scroll horizontally instead of widening the viewport.
+- Browser tests allow slower CI Chrome startup and report process timeouts directly instead of failing later against empty DOM output.
+- The complete suite passes 140/140 tests.
+
+### Boundary
+
+This release does not execute Radix or arbitrary React UI packages. `Portal`, `asChild`/`Slot`, element cloning, and arbitrary compound-component Context must be removed during source migration. Applications remain responsible for dialog labeling and explicit focus restoration.
+
+### Upgrade
+
+```bash
+npm install @kudzujs/core@^0.8.10
+```
+
 ## 0.8.9 - Context-backed CRUD actions
 
 Kudzu 0.8.9 specializes state-backed actions exposed through one conventional Context Provider and relative custom hook.

package/framework/build.mjs

@@ -581,7 +581,7 @@ addEventListener("pagehide", event => {
   if (hasDependencies) return `${imports.join("\n")}
 const effects = ${inlineJson(effects)}
 const modules = new Map([${entries}])
-const records = effects.map((effect, index) => ({ effect, index, values: undefined, cleanup: undefined }))
+const records = effects.map((effect, index) => ({ effect, index, values: undefined, cleanup: undefined, token: undefined }))
 const dependencies = new Map()
 const pending = new Set()
 let scheduled = false
@@ -649,7 +649,9 @@ ${hasDependencyExpressions ? printDerivedDependencyRead("browserState") : ""}
 function invoke(record) {
   try {
     const effect = record.effect
-    const result = modules.get(effect.module)[effect.handler](createEffectContext(browserState, effect.states, commitDom, effect.scope))
+    const token = { active: true }
+    record.token = token
+    const result = modules.get(effect.module)[effect.handler](createEffectContext(browserState, effect.states, commitDom, effect.scope, () => active && token.active && record.token === token))
     if (effect.cleanup && typeof result === "function") record.cleanup = result
     else if (result && typeof result.then === "function") result.catch(error => console.error(error))
   } catch (error) {
@@ -657,6 +659,8 @@ function invoke(record) {
   }
 }
 async function invokeCleanup(record) {
+  if (record.token) record.token.active = false
+  record.token = undefined
   const cleanup = record.cleanup
   record.cleanup = undefined
   if (!cleanup) return
@@ -1352,6 +1356,7 @@ const effect = ${inlineJson(effect)}
 const dependency = effect.dependencies[0]
 let value
 let cleanup
+let token
 let active = true
 let pending = false
 let scheduled = false
@@ -1402,7 +1407,9 @@ function readDependency() {
 }
 function invoke() {
   try {
-    const result = __kEffectModule0[effect.handler](createEffectContext(browserState, effect.states, commitDom, effect.scope))
+    const current = { active: true }
+    token = current
+    const result = __kEffectModule0[effect.handler](createEffectContext(browserState, effect.states, commitDom, effect.scope, () => active && current.active && token === current))
     if (effect.cleanup && typeof result === "function") cleanup = result
     else if (result && typeof result.then === "function") result.catch(error => console.error(error))
   } catch (error) {
@@ -1410,6 +1417,8 @@ function invoke() {
   }
 }
 async function invokeCleanup() {
+  if (token) token.active = false
+  token = undefined
   const current = cleanup
   cleanup = undefined
   if (!current) return

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kudzujs/core",
-  "version": "0.8.9",
+  "version": "0.8.11",
   "description": "HTML-first TSX framework with synchronous state semantics and no virtual DOM",
   "type": "module",
   "license": "MIT",