@kudzujs/core 0.16.3 → 0.16.4

package/MIGRATION_ROADMAP.md

@@ -51,7 +51,7 @@ Syntax compatibility does not mean reproducing React wholesale. Kudzu accepts th
 - stronger JavaScript failure resilience;
 - no remaining material large-route build-scaling weakness.
 
-The completed 0.9 plan defines the cross-framework comparison and release gate. The active application packet is `0.16.4` in the capability release plan below. Benchmark-only feature omission, unmatched accessibility, weighted scores that hide losses, and unrecorded environment differences do not count as proof.
+The completed 0.9 plan defines the cross-framework comparison and release gate. The active application packet is `0.17.0` in the capability release plan below. Benchmark-only feature omission, unmatched accessibility, weighted scores that hide losses, and unrecorded environment differences do not count as proof.
 
 ### 0.10.0 Through 0.21.x: Application Capability Release Train
 

package/PERFORMANCE.md

@@ -2,6 +2,20 @@
 
 Reproducibility classes: `npm run benchmark`, `npm run benchmark:keyed`, `npm run benchmark:native`, `npm run benchmark:module-cache`, `npm run benchmark:project-navigation`, `npm run benchmark:project-state`, and `npm run benchmark:source-scale` are maintained in this repository; `npm run benchmark:commerce` is a maintained paired runner over the public external storefront; older excluded-workspace sections are historical provenance only and are not current framework rankings.
 
+## 0.16.4 Scoped GSAP Animation Lifecycle
+
+Measured 2026-08-28 on Linux x64 with Node 24.14.0 and Chrome. The real GSAP
+fixture emits 8 JavaScript files totaling 94,110 raw / 37,819 aggregate gzip
+bytes, while its static sibling emits zero JavaScript. Required Chrome proves
+scoped presentation, native reduced-motion fallback, dependency replacement,
+conditional and enhanced-route disposal, retained structure, and fresh remount.
+
+The maintained Worker benchmark remains byte-identical at 907 raw / 477 gzip B
+for the Worker graph and 14,456 raw / 6,159 gzip B for the window graph. Seven
+clean builds record a 625.9 ms median on this host. Timing is not compared with
+the prior sweep. The change adds no runtime file or animation abstraction; one
+existing package-reference ancestry helper shrinks by two lines.
+
 ## 0.16.3 State-Owned Drag And Drop
 
 Measured 2026-08-28 on Linux x64 with Node 24.14.0 and Chrome. The real

package/README.md

@@ -14,7 +14,7 @@ Kudzu compiles ordinary React-shaped TypeScript and TSX into complete static HTM
 
 > Experimental `0.16.x`: the compiler API and supported TSX surface may change.
 
-**Latest release: 0.16.3 - State-owned drag and drop.** A real SortableJS effect may move DOM during a gesture while keyed Kudzu state remains the durable order and identity owner, with keyboard parity, exact disposal, and static exclusion. Read the [release notes](./RELEASES.md#0163---state-owned-drag-and-drop), open the [release page](https://github.com/kudzujs/kudzu/releases/tag/v0.16.3), or follow the [architecture packet](./docs/next-architecture/README.md).
+**Latest release: 0.16.4 - Scoped GSAP animation lifecycle.** Inline GSAP callbacks stay inside one owned effect while Kudzu retains structural DOM, native reduced-motion fallback, dependency replacement, disposal, and static exclusion. Read the [release notes](./RELEASES.md#0164---scoped-gsap-animation-lifecycle), open the [release page](https://github.com/kudzujs/kudzu/releases/tag/v0.16.4), or follow the [architecture packet](./docs/next-architecture/README.md).
 
 - [Documentation](https://kudzujs.cloud/docs)
 - [Installation guide](https://kudzujs.cloud/docs#install)

package/RELEASES.md

@@ -1,5 +1,44 @@
 # Kudzu Releases
 
+## 0.16.4 - Scoped GSAP Animation Lifecycle
+
+Kudzu 0.16.4 lets inline GSAP callbacks remain inside one owned effect while
+Kudzu retains structural DOM and exact route, conditional, and dependency
+lifetime ownership.
+
+### Changed in 0.16.4
+
+- Accepts package references inside an unbroken chain of inline callbacks passed
+  directly within an owned effect setup or cleanup.
+- Keeps named, local, imported, render-time, and mixed package indirection
+  unsupported.
+- Preserves deterministic visible HTML before GSAP applies bounded opacity and
+  transform presentation.
+- Uses native `prefers-reduced-motion` detection for a static presentation with
+  no residual inline opacity, transform, or visibility.
+- Reverts the previous GSAP context before dependency replacement and on
+  conditional or enhanced-route disposal; remount creates a fresh owner.
+- Adds no animation IR, scheduler, runtime concept, React, VDOM, hydration, or
+  retained component tree.
+- Updates `create-kudzu@0.1.129` to generate projects on
+  `@kudzujs/core@^0.16.4`.
+
+### Output And Browser Evidence
+
+- The GSAP fixture emits 8 JavaScript files totaling 94,110 raw / 37,819
+  aggregate gzip bytes; its static sibling emits zero JavaScript.
+- Required Chrome proves scoped mount, dependency replacement, reduced-motion
+  fallback, conditional and route disposal, retained structure, and fresh
+  remount.
+- The maintained Worker and window graphs remain 907 raw / 477 gzip bytes and
+  14,456 raw / 6,159 gzip bytes respectively.
+
+### Upgrade
+
+```sh
+npm install @kudzujs/core@^0.16.4
+```
+
 ## 0.16.3 - State-Owned Drag And Drop
 
 Kudzu 0.16.3 proves that a real SortableJS drag engine can remain a bounded

package/docs/next-architecture/README.md

@@ -15,7 +15,7 @@ The completed `0.9.0` milestone is recorded in [`0.9-semantic-compression.md`](.
 
 [`1.0-large-application-compatibility-audit.md`](./1.0-large-application-compatibility-audit.md) records the first post-0.9 probes against Memos, Apache Answer, and Actual Budget. The audit finds that reduced slices build but whole-application source retention and behavior parity do not yet pass.
 
-[`application-capability-release-plan.md`](./application-capability-release-plan.md) is the authoritative post-0.9 execution queue, currently at `0.16.4`. It assigns one application-capability section to each minor release and one independently accepted evidence packet to each patch release from `0.10.0` through the `1.0.0` gate. It supersedes the provisional 0.10/0.11/0.12 tool-first ordering in the completed 0.9 handoff without rewriting that historical record.
+[`application-capability-release-plan.md`](./application-capability-release-plan.md) is the authoritative post-0.9 execution queue, currently at `0.17.0`. It assigns one application-capability section to each minor release and one independently accepted evidence packet to each patch release from `0.10.0` through the `1.0.0` gate. It supersedes the provisional 0.10/0.11/0.12 tool-first ordering in the completed 0.9 handoff without rewriting that historical record.
 
 ## Required Invariants
 

package/docs/next-architecture/application-capability-release-plan.md

@@ -1277,6 +1277,31 @@ differs from the published baseline.
 - **Done condition:** GSAP owns only bounded presentation changes and exact
   cleanup while Kudzu retains document structure and lifetime ownership.
 
+**Result:** complete. A reduction of the MIT-licensed
+Magic Modal landing page at revision
+`ab3df864de5b01d604d26345165ea5f7900eae14` reproduced one compiler failure:
+GSAP's root-scoped `context()` receives an inline callback whose direct package
+calls were rejected because package-reference validation stopped at the nearest
+function. The existing ancestry check now accepts only an unbroken chain of
+inline call arguments back to the owned effect; named, local, and imported helper
+indirection remains rejected. Required Chrome proves deterministic visible HTML,
+root-scoped presentation, native reduced-motion fallback without residual inline
+opacity/transform, dependency replacement with retained DOM identity,
+conditional and enhanced-route disposal, and fresh remount. GSAP owns only
+bounded opacity and transform changes; Kudzu retains structural DOM and lifetime
+ownership. The interactive graph is 94,110 raw / 37,819 aggregate gzip bytes
+across eight JavaScript files; the static sibling emits zero. Its normalized
+deploy archive SHA-256 is
+`2b6467f04452c51878ea81d5e80db21c60286e191e1e49ac482556dbf7c713c3`.
+Semantic primitives, IR kinds, compiler passes, normalization rules, runtime
+concepts, runtime files, animation abstractions, schedulers, and public APIs
+change by zero; one existing compiler ancestry helper shrinks by two LOC. One
+positive fixture and one two-scenario browser contract were added. The maintained
+Worker/effect benchmark remains 907 raw / 477 gzip bytes for the Worker graph and
+14,456 raw / 6,159 gzip bytes for the window graph; its seven-run Linux median was
+625.9 ms, recorded without a timing comparison because the host differs from the
+published baseline.
+
 ## `0.17.x`: Long-Lived Applications
 
 ### `0.17.0`: Endurance Harness
@@ -1653,4 +1678,5 @@ release transaction where possible or document and publish a forward-fix patch.
 | `0.16.1` | Released | Preserve the retained CodeMirror instance boundary, bidirectional updates, error recovery, accessibility, and exact cleanup. | None |
 | `0.16.2` | Closed by existing effect ownership | Preserve retained Chart.js data/resize updates, listener and route cleanup, fresh remount, accessibility, and static exclusion. | No production change; no release consumed |
 | `0.16.3` | Released | Preserve state-owned order, keyed identity, keyboard parity, invalid-input recovery, package disposal, and static exclusion. | None |
-| `0.16.4` | Active | Validate one real GSAP landing-page animation through bounded effect ownership. | None |
+| `0.16.4` | Released | Preserve scoped GSAP presentation, reduced-motion fallback, dependency/owner cleanup, fresh remount, and static exclusion. | None |
+| `0.17.0` | Active | Establish the long-session endurance harness and machine-readable ownership counters. | None |

package/docs/next-architecture/compiler-current-architecture.md

@@ -1,6 +1,6 @@
 # Current Compiler Architecture
 
-This maps the current `0.16.3` architecture, built on the completed `0.9.0` semantic-compression release and `0.8.23` Goal A compiler foundation. The active application packet is `0.16.4`; file and function names are the stable references, while line numbers are intentionally omitted because later work may still move code.
+This maps the current `0.16.4` architecture, built on the completed `0.9.0` semantic-compression release and `0.8.23` Goal A compiler foundation. The active application packet is `0.17.0`; file and function names are the stable references, while line numbers are intentionally omitted because later work may still move code.
 
 ## Responsibility Map
 

package/docs/next-architecture/large-application-ai-native-roadmap.md

@@ -2,9 +2,9 @@
 
 ## Status
 
-Completed compiler-foundation record and longer-term plan after `0.8.35`. The [`0.9-semantic-compression.md`](./0.9-semantic-compression.md) execution queue is complete. The active queue for current work is [`application-capability-release-plan.md`](./application-capability-release-plan.md) at packet `0.16.4`. This document does not mark any remaining planned capability as supported and does not authorize a React runtime, VDOM, hydration, retained browser component tree, generic rerenderer, public store/query/resource API, SPA router, or islands.
+Completed compiler-foundation record and longer-term plan after `0.8.35`. The [`0.9-semantic-compression.md`](./0.9-semantic-compression.md) execution queue is complete. The active queue for current work is [`application-capability-release-plan.md`](./application-capability-release-plan.md) at packet `0.17.0`. This document does not mark any remaining planned capability as supported and does not authorize a React runtime, VDOM, hydration, retained browser component tree, generic rerenderer, public store/query/resource API, SPA router, or islands.
 
-[`MIGRATION_ROADMAP.md`](../../MIGRATION_ROADMAP.md) remains the product authority for product invariants and fixture-driven feature selection. [`application-capability-release-plan.md`](./application-capability-release-plan.md) is authoritative for current work order and evidence at packet `0.16.4`; this plan retains the completed foundation, deferred program, and long-term production gates. If implementation evidence changes either boundary, update the relevant document before broadening a patch.
+[`MIGRATION_ROADMAP.md`](../../MIGRATION_ROADMAP.md) remains the product authority for product invariants and fixture-driven feature selection. [`application-capability-release-plan.md`](./application-capability-release-plan.md) is authoritative for current work order and evidence at packet `0.17.0`; this plan retains the completed foundation, deferred program, and long-term production gates. If implementation evidence changes either boundary, update the relevant document before broadening a patch.
 
 ## Product Outcome
 
@@ -483,4 +483,4 @@ The first comparison is Kudzu versus React + Vite using the same agent, model, t
 
 ## Immediate Decision
 
-All listed foundation and `0.9` slices are complete. Current work continues at `0.16.4` GSAP Animation Lifecycle under the [`application-capability-release-plan.md`](./application-capability-release-plan.md); keep ResourceIR limited to qualifying independent fixtures, and do not add range ownership, virtualization, optimistic transactions, a public adapter/store API, or a router before evidence justifies them.
+All listed foundation and `0.9` slices are complete. Current work continues at `0.17.0` Endurance Harness under the [`application-capability-release-plan.md`](./application-capability-release-plan.md); keep ResourceIR limited to qualifying independent fixtures, and do not add range ownership, virtualization, optimistic transactions, a public adapter/store API, or a router before evidence justifies them.

package/docs/next-architecture/versioning.md

@@ -1,6 +1,6 @@
 # Planned Version Sequence
 
-This is an execution sequence, not release history. `0.8.16` through `0.8.62` are completed scopes represented by package/release records. The `0.10.0` through `1.0.0` minor/patch sequence is maintained in [`application-capability-release-plan.md`](./application-capability-release-plan.md), currently at `0.16.4`; that plan supersedes the provisional tool-first 0.10/0.11/0.12 ordering in the completed 0.9 handoff.
+This is an execution sequence, not release history. `0.8.16` through `0.8.62` are completed scopes represented by package/release records. The `0.10.0` through `1.0.0` minor/patch sequence is maintained in [`application-capability-release-plan.md`](./application-capability-release-plan.md), currently at `0.17.0`; that plan supersedes the provisional tool-first 0.10/0.11/0.12 ordering in the completed 0.9 handoff.
 
 Keep each patch behavior-preserving and independently reviewable. If a boundary proves inseparable, revise this plan before combining releases; do not silently broaden a patch.
 
@@ -66,7 +66,7 @@ Keep each patch behavior-preserving and independently reviewable. If a boundary
 
 ## Generator Versions
 
-`create-kudzu@0.1.128` retains the explicit install instructions and generates projects with `@kudzujs/core@^0.16.3`.
+`create-kudzu@0.1.129` retains the explicit install instructions and generates projects with `@kudzujs/core@^0.16.4`.
 
 ## Release Boundary
 

package/framework/compiler/source-compiler.mjs

@@ -2630,19 +2630,17 @@ function insideJsxEventHandler(node, root) {
 }
 
 function insideOwnedEffectCallback(node, root) {
-  let callback
   for (let current = node.parent; current && current !== root.parent; current = current.parent) {
     if (!isFunctionLike(current)) continue
-    callback = current
-    break
-  }
-  if (!callback) return false
-  if (ts.isCallExpression(callback.parent) && callback.parent.arguments[0] === callback && ts.isIdentifier(callback.parent.expression) && callback.parent.expression.text === "useEffect") return true
-  const returned = callback.parent
-  if (!ts.isReturnStatement(returned)) return false
-  for (let current = returned.parent; current && current !== root.parent; current = current.parent) {
-    if (!isFunctionLike(current)) continue
-    return ts.isCallExpression(current.parent) && current.parent.arguments[0] === current && ts.isIdentifier(current.parent.expression) && current.parent.expression.text === "useEffect"
+    if (ts.isCallExpression(current.parent) && current.parent.arguments[0] === current && ts.isIdentifier(current.parent.expression) && current.parent.expression.text === "useEffect") return true
+    if (ts.isReturnStatement(current.parent)) {
+      for (let owner = current.parent.parent; owner && owner !== root.parent; owner = owner.parent) {
+        if (!isFunctionLike(owner)) continue
+        return ts.isCallExpression(owner.parent) && owner.parent.arguments[0] === owner && ts.isIdentifier(owner.parent.expression) && owner.parent.expression.text === "useEffect"
+      }
+      return false
+    }
+    if (!ts.isCallExpression(current.parent) || !current.parent.arguments.includes(current)) return false
   }
   return false
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kudzujs/core",
-  "version": "0.16.3",
+  "version": "0.16.4",
   "description": "HTML-first TSX framework with synchronous state semantics and no virtual DOM",
   "type": "module",
   "license": "MIT",
@@ -76,6 +76,7 @@
     "@codemirror/view": "^6.43.9",
     "@types/sortablejs": "^1.15.9",
     "chart.js": "^3.8.2",
+    "gsap": "^3.15.0",
     "sortablejs": "^1.15.7",
     "typed.js": "^3.0.0",
     "wrangler": "^4.112.0"