@kudzujs/core 0.14.1 → 0.14.3

package/PERFORMANCE.md

@@ -2,6 +2,60 @@
 
 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.14.3 10,000-Item Browser Decision Intake
+
+Measured 2026-08-27 on Linux x64 with Node 24.14.0 and Chrome
+142.0.7444.175 using `RUNS=7 npm run benchmark:project-list-decision`.
+The tracked fixture rotates three fresh-profile routes, forces garbage collection,
+and records navigation completion, range replacement, DOM counters, JavaScript
+heap, native edit identity, and bounded-row release.
+
+| Strategy | Load median | Range median | Rows | DOM nodes median | JS heap median |
+|---|---:|---:|---:|---:|---:|
+| Direct DOM | 806.6 ms | n/a | 10,000 | 90,023 | 535,572 B |
+| Pagination | 165.4 ms | 12.1 ms | 100 | 1,470 | 1,407,412 B |
+| Scroll window | 161.2 ms | 16.5 ms | 100 | 1,471 | 1,507,712 B |
+
+Direct load samples are `[767, 790.1, 882.8, 908.8, 753, 826.7, 806.6]`
+ms. Pagination load/range samples are `[253.6, 138.6, 157, 133.7, 181.9,
+202, 165.4]` / `[10.8, 22.1, 15.8, 13.7, 12.1, 10.5, 11]` ms. Scroll
+window load/range samples are `[156.7, 154.6, 163.4, 161.2, 175.9, 203.5,
+137.1]` / `[21.3, 16.4, 14.6, 17.1, 15.9, 16.5, 20.4]` ms.
+
+The direct route is static and therefore has the lowest JavaScript heap; that
+does not offset its 61.2x DOM-node count and 4.9x load median. Pagination and the
+scroll window have overlapping load ranges, while pagination has the lower range
+median, lower JavaScript heap, no scroll listener, native focus/page semantics,
+and no fixed-row-height policy. Pagination is selected for 10,000-item project
+tables. The window experiment adds no framework primitive and does not authorize
+`0.14.4`; three independent failing fixtures remain required.
+
+## 0.14.2 Infinite Loading Composition
+
+Measured 2026-08-26 on macOS arm64 with Node 24.14.0 and Chrome
+151.0.7922.174.
+
+The project route adds one intrinsic sentinel, an owned `IntersectionObserver`,
+cursor fetch, duplicate suppression, error/retry/end state, and immutable keyed
+append. Required Chrome proves a three-request bound across two successful pages,
+at most six retained projects, retained existing-row identity, observer cleanup,
+and route-owned fetch abort. `/help` remains 0 B JavaScript.
+
+The application emits 44 files totaling 168,037 raw / 52,955 aggregate gzip
+bytes with deploy SHA-256
+`230dea098442275e42a966ca595743a4da9c832327ba52d4d09de663c68f8f1a`.
+The two-route session remains 17 JavaScript files and totals 76,889 raw / 26,750
+aggregate gzip bytes. The authored application composition adds 3,732 raw / 770
+gzip deploy bytes and 2,063 raw / 546 gzip session bytes over `0.14.1`; no
+semantic primitive, IR kind, compiler pass, production compiler/runtime line,
+runtime concept, or public API was added.
+
+Table update samples are `[0.4, 0.5, 0.5, 0.3, 0.5, 0.4, 0.6]` ms, with a 0.5
+ms median and 0.3/0.6 ms minimum/maximum. Navigation samples are
+`[2.3, 2.3, 2.2, 2.6, 2.5, 2.5, 2.3]` ms, with a 2.3 ms median and 2.2/2.6 ms
+minimum/maximum. The environment differs from the `0.14.1` release evidence, so
+no improvement or regression claim is made.
+
 ## 0.14.1 Nested Object-State Collections
 
 Measured 2026-08-26 on Linux x64 with Node 24.14.0 and Chrome

package/README.md

@@ -14,7 +14,7 @@ Kudzu compiles ordinary React-shaped TypeScript and TSX into complete static HTM
 
 > Experimental `0.14.x`: the compiler API and supported TSX surface may change.
 
-**Latest release: 0.14.1 - Nested and object-state collections.** Direct immutable array fields of ordinary object state now compose root and nested keyed ownership with retained identity, latest handlers, and exact row-state release. Read the [release notes](./RELEASES.md#0141---nested-and-object-state-collections), open the [release page](https://github.com/kudzujs/kudzu/releases/tag/v0.14.1), or follow the [architecture packet](./docs/next-architecture/README.md).
+**Latest release: 0.14.3 - 10,000-item browser decision.** Measured direct DOM, pagination, and scroll-window alternatives select native pagination for large project tables without adding virtualization or range runtime semantics. Read the [release notes](./RELEASES.md#0143---10000-item-browser-decision), open the [release page](https://github.com/kudzujs/kudzu/releases/tag/v0.14.3), 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,92 @@
 # Kudzu Releases
 
+## 0.14.3 - 10,000-Item Browser Decision
+
+Kudzu 0.14.3 measures direct DOM, pagination, and scroll-window alternatives
+for one deterministic 10,000-project table and selects native pagination.
+
+### Changed in 0.14.3
+
+- Added a tracked three-route large-list decision fixture.
+- Added rotating fresh-Chrome load, range, DOM, heap, and identity measurement.
+- Rejected direct 10,000-row DOM after its 90,023-node result.
+- Rejected fixed-height scroll windowing for the project table because pagination
+  is faster to change range, uses less heap, and preserves native page/focus and
+  variable-row-height behavior.
+- Added no range primitive, virtualization runtime, compiler pass, or public API.
+- Updated `create-kudzu@0.1.125` to generate projects on
+  `@kudzujs/core@^0.14.3`.
+
+### Browser Evidence
+
+- Direct DOM loads in 806.6 ms median with 90,023 DOM nodes.
+- Pagination loads in 165.4 ms and changes its 100-row page in 12.1 ms median
+  with 1,470 DOM nodes.
+- The scroll window loads in 161.2 ms and changes range in 16.5 ms median with
+  1,471 DOM nodes.
+- Both bounded strategies release an edited off-range row and restore fresh
+  native input identity.
+
+### Decision
+
+Use pagination for 10,000-item project tables. `0.14.4` virtual range ownership
+remains blocked until three independent real fixtures prove pagination and
+application-owned bounded ranges insufficient.
+
+### Upgrade
+
+```sh
+npm install @kudzujs/core@^0.14.3
+```
+
+## 0.14.2 - Infinite Loading Composition
+
+Kudzu 0.14.2 composes bounded sentinel-driven loading from ordinary state,
+owned effects, native `IntersectionObserver`, fetch, and existing keyed lists.
+
+### Changed in 0.14.2
+
+- Added an intrinsic sentinel with an owned observer and exact disconnect.
+- Added cursor-based incremental fetch with duplicate project suppression.
+- Added accessible loading, error, retry, and terminal states.
+- Aborted in-flight incremental work when enhanced navigation releases the route.
+- Bounded successful incremental pages to two and retained projects to six.
+- Updated `create-kudzu@0.1.124` to generate projects on
+  `@kudzujs/core@^0.14.2`.
+
+### Output Evidence
+
+- The application emits 44 files totaling 168,037 raw / 52,955 aggregate gzip
+  bytes with deploy digest
+  `230dea098442275e42a966ca595743a4da9c832327ba52d4d09de663c68f8f1a`.
+- The maintained two-route session remains 17 JavaScript files and totals
+  76,889 raw / 26,750 aggregate gzip bytes; `/help` remains 0 B JavaScript.
+- No semantic primitive, IR kind, compiler pass, production compiler/runtime
+  line, normalization rule, adapter, runtime concept, public API, infinite-query
+  runtime, or observer scheduler was added.
+
+### Validation
+
+- Required Chrome proves cursor progression, duplicate trigger and record
+  suppression, HTTP error and retry, terminal state, retained row identity,
+  bounded requests/results, observer disconnect, and route-owned fetch abort.
+- The complete suite passes 274 tests, package smoke, and serialized required-
+  Chrome execution.
+- Seven fresh Chrome 151 profiles record a 0.5 ms table-update median with a
+  0.3-0.6 ms range and a 2.3 ms navigation median with a 2.2-2.6 ms range.
+
+### Limits
+
+Incremental loading is capped at two successful pages of two records and six
+retained projects. Unbounded datasets, automatic query caching, windowing, and
+virtualization remain separate measured decisions.
+
+### Upgrade
+
+```sh
+npm install @kudzujs/core@^0.14.2
+```
+
 ## 0.14.1 - Nested And Object-State Collections
 
 Kudzu 0.14.1 lets one direct immutable array field of ordinary object state own

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

@@ -959,6 +959,36 @@ projects on `@kudzujs/core@^0.14.1`.
 - **Done condition:** the full journey passes with explicit network and memory
   bounds.
 
+Release candidate evidence complete. The maintained project application adds one
+intrinsic sentinel, an owned native `IntersectionObserver`, cursor and request
+primitive state, an owned fetch with `AbortController`, immutable keyed append,
+duplicate ID suppression, and explicit loading/error/retry/end UI. The authored
+policy permits two successful pages of two records and retains at most six unique
+projects. It adds no infinite-query runtime, observer scheduler, cache, retained
+component tree, or virtualization machinery.
+
+Required Chrome proves duplicate sentinel triggers issue one request, duplicate
+records do not remount retained rows, cursor progression reaches an authored
+`503`, retry reaches terminal state, post-terminal triggers issue no request, and
+enhanced navigation disconnects the observer and aborts the in-flight fetch
+signal. Exact request counts and retained DOM identity pass. `/help` remains
+complete HTML with 0 B JavaScript.
+
+The slice adds zero semantic primitives, IR kinds, compiler passes, production
+compiler/runtime lines, normalization rules, adapters, runtime concepts, or
+public APIs. The application emits 44 files totaling 168,037 raw / 52,955
+aggregate gzip bytes with deploy SHA-256
+`230dea098442275e42a966ca595743a4da9c832327ba52d4d09de663c68f8f1a`.
+The maintained two-route session remains 17 JavaScript files totaling 76,889 raw
+/ 26,750 aggregate gzip bytes.
+
+Seven fresh macOS arm64 Chrome 151 profiles record table update samples of
+`[0.4, 0.5, 0.5, 0.3, 0.5, 0.4, 0.6]` ms, a 0.5 ms median and 0.3/0.6 ms range,
+plus navigation samples of `[2.3, 2.3, 2.2, 2.6, 2.5, 2.5, 2.3]` ms, a 2.3 ms
+median and 2.2/2.6 ms range. The environment differs from `0.14.1`, so no timing
+delta is claimed. `0.14.2` publishes this accepted packet, and
+`create-kudzu@0.1.124` generates projects on `@kudzujs/core@^0.14.2`.
+
 ### `0.14.3`: 10,000-Item Browser Decision
 
 - **Purpose:** measure direct DOM, pagination, and windowing alternatives.
@@ -969,6 +999,25 @@ projects on `@kudzujs/core@^0.14.1`.
 - **Done condition:** the selected strategy and thresholds are recorded without
   assuming direct 10,000-row rendering is acceptable.
 
+Decision evidence is complete. A tracked three-route fixture and
+`npm run benchmark:project-list-decision` now compare one static 10,000-row
+table with pagination and a scroll-driven 100-row window over the same
+deterministic records and native edit controls. Seven rotating fresh Chrome 142
+profiles show direct DOM
+at an 806.6 ms load median and 90,023 DOM nodes, versus 165.4/161.2 ms and a
+1,470/1,471-node median for pagination and the scroll window. Direct JavaScript
+heap is lower because its route is static; DOM size and load remain materially
+worse.
+
+Pagination is selected. Its 12.1 ms range median is lower than the window's 16.5
+ms, it uses 100,300 fewer median JavaScript-heap bytes, and it preserves native
+page, keyboard, focus, and variable-row-height behavior without a scroll listener
+or measurement policy. Both bounded routes release an edited off-range row and
+restore fresh native input identity. The experiment adds no semantic primitive,
+IR kind, compiler pass, production compiler/runtime line, runtime concept, or
+public API. `0.14.4` remains blocked because this one fixture cannot authorize
+virtual range ownership.
+
 ### `0.14.4`: Virtual Range Ownership
 
 - **Purpose:** implement bounded DOM only if `0.14.3` and three independent
@@ -1427,5 +1476,6 @@ release transaction where possible or document and publish a forward-fix patch.
 | `0.13.3` | Released | Preserve the published upload validation, cancellation, retry, route cleanup, and attachment mutation evidence. | None |
 | `0.14.0` | Released | Preserve native table CRUD, retained identity, keyboard access, and measured update evidence. | None |
 | `0.14.1` | Released | Preserve immutable object-state replacement, nested keyed identity, latest handlers, and exact row release. | None |
-| `0.14.2` | Active | Add the first failing infinite-loading composition fixture. | None |
-| `0.14.3` onward | Blocked | Complete or explicitly close `0.14.2` first. | Ordered patch boundary |
+| `0.14.2` | Released | Preserve bounded cursor loading, duplicate suppression, retry/end behavior, retained identity, and route cleanup. | None |
+| `0.14.3` | Release candidate | Complete commit, CI, tag, GitHub release, npm publication, and registry verification. | Release transaction |
+| `0.14.4` onward | Blocked | Complete or explicitly close `0.14.3` first. | Ordered patch boundary |

package/docs/next-architecture/versioning.md

@@ -66,7 +66,7 @@ Keep each patch behavior-preserving and independently reviewable. If a boundary
 
 ## Generator Versions
 
-`create-kudzu@0.1.123` retains the explicit install instructions and generates projects with `@kudzujs/core@^0.14.1`.
+`create-kudzu@0.1.125` retains the explicit install instructions and generates projects with `@kudzujs/core@^0.14.3`.
 
 ## Release Boundary
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kudzujs/core",
-  "version": "0.14.1",
+  "version": "0.14.3",
   "description": "HTML-first TSX framework with synchronous state semantics and no virtual DOM",
   "type": "module",
   "license": "MIT",
@@ -61,6 +61,7 @@
     "benchmark:module-cache": "node test/module-cache-performance.mjs",
     "benchmark:native": "node test/native-performance.mjs",
     "benchmark:project-navigation": "node test/project-navigation-performance.mjs",
+    "benchmark:project-list-decision": "node test/project-list-decision-performance.mjs",
     "benchmark:project-state": "node test/project-state-performance.mjs",
     "benchmark:source-scale": "node test/source-scale-performance.mjs",
     "prepublishOnly": "npm run check && npm test",