@kudzujs/core 0.14.2 → 0.14.3

package/PERFORMANCE.md

@@ -2,6 +2,34 @@
 
 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

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.2 - Infinite loading composition.** Native `IntersectionObserver`, owned fetch, ordinary state, and existing keyed lists now compose bounded cursor loading with duplicate suppression, retry, terminal state, retained identity, and exact cleanup. Read the [release notes](./RELEASES.md#0142---infinite-loading-composition), open the [release page](https://github.com/kudzujs/kudzu/releases/tag/v0.14.2), 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,44 @@
 # 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,

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

@@ -999,6 +999,25 @@ delta is claimed. `0.14.2` publishes this accepted packet, and
 - **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
@@ -1457,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` | Release candidate | Complete commit, CI, tag, GitHub release, npm publication, and registry verification. | Release transaction |
-| `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.124` retains the explicit install instructions and generates projects with `@kudzujs/core@^0.14.2`.
+`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.2",
+  "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",