@kudzujs/core 0.13.2 → 0.14.0

package/PERFORMANCE.md

@@ -6,6 +6,61 @@ Reproducibility classes: `npm run benchmark`, `npm run benchmark:keyed`, `npm ru
 
 The maintained 2026-08-13 comparison used Node 24.14.0 and an Intel Core i5-9500 Linux x64 host, one warm-up, and seven alternating fresh-process samples against clean `v0.8.44`. A narrow fast path skips Kudzu semantic transformation for 450 plain `.ts` modules whose runtime edges are exclusively resolvable relative TypeScript imports or exports; all other modules retain the existing transformer. Compile median fell from 2,323.9 ms to 1,413.2 ms (39.2%) and clean-build median from 3,325.3 ms to 2,382.4 ms (28.4%); every paired sample improved. Compile peak-RSS median fell from 571.2 MiB to 552.6 MiB, while build peak RSS was 570.9 MiB versus 568.8 MiB. Compiler scratch fell from 7,328,390 to 1,971,061 bytes. Both targets emitted the same 50 static HTML files, 10,980 bytes, and deploy SHA-256 `e107d78a7f55bc8a1af0ea6e53efeffa19b3d44d21c892484d103fa346e7ba7b`. This is a source-scale compiler comparison, not a cross-framework result.
 
+## 0.14.0 Project Table CRUD And Identity
+
+Measured 2026-08-26 on Linux x64 with Node 24.14.0 and Chrome
+142.0.7444.175. Required Chrome proves native table insert, update, delete,
+reorder, sort, filter, selection, keyboard focus, row-local edit state, and
+retained keyed DOM identity.
+
+The application emits 44 files totaling 159,258 raw / 51,627 aggregate gzip
+bytes with deploy SHA-256
+`ebb3358e7a03612459e723ae765c39d105498db9d293415b924f1066cddf4793`.
+The two-route session remains 17 JavaScript files and totals 73,304 raw / 25,930
+aggregate gzip bytes, 2,273 raw / 626 gzip bytes above `0.13.3`. `/help`
+remains 0 B JavaScript. The added bytes are route-specific authored table
+handlers, bindings, selectors, and keyed row state; there is no data-grid
+runtime.
+
+Table update samples are `[0.7, 0.8, 1.0, 0.7, 1.1, 0.7, 0.8]` ms, with a 0.8
+ms median and 0.7/1.1 ms minimum/maximum. Navigation samples are
+`[3.9, 3.9, 5.5, 4.2, 6.1, 3.5, 3.4]` ms, with a 3.9 ms median and 3.4/6.1 ms
+minimum/maximum. Table update is a new measurement, so no same-content latency
+delta is claimed.
+
+Core semantic LOC remains 5,682 with zero new semantic primitives, IR kinds,
+compiler passes, production compiler/runtime lines, normalization rules,
+adapters, runtime concepts, public APIs, or data-grid runtimes. Infinite loading,
+windowing, and the 10,000-row strategy remain later measured decisions.
+
+## 0.13.3 File Upload Boundary
+
+Measured 2026-08-25 on Linux x64 with Node 24.14.0 and Chrome
+142.0.7444.175. Required Chrome proves plain-text type and 1 KiB size
+validation before any request, native file reading, `FormData`/fetch upload,
+user cancellation, delayed failure and retry, route-departure abort, and
+successful keyed attachment mutation.
+
+The application emits 44 files totaling 150,023 raw / 50,240 aggregate gzip
+bytes with deploy SHA-256
+`a16fd5dbc08086aa6a7c0ec0aba3a38fbe2a63b96005a81e8747a7f4e45e214e`.
+The two-route session remains 17 JavaScript files and totals 71,031 raw / 25,304
+aggregate gzip bytes, 2,367 raw / 557 gzip bytes above `0.13.2`. `/help`
+remains 0 B JavaScript. The added bytes are route-specific authored file
+validation, multipart upload, effect cleanup, and keyed attachment behavior;
+there is no upload runtime.
+
+Navigation samples are `[3.7, 5.0, 3.5, 3.7, 3.8, 3.8, 4.0]` ms, with a 3.8
+ms median and 3.5/5.0 ms minimum/maximum. This changes the destination, so no
+same-content runtime regression or improvement claim is made.
+
+Core semantic LOC remains 5,682 with zero new semantic primitives, IR kinds,
+compiler passes, production compiler/runtime lines, normalization rules,
+adapters, runtime concepts, public APIs, upload schedulers, or transfer
+runtimes. Fetch does not expose upload progress, so the application states that
+boundary instead of fabricating progress. Chunking, resume, background sync,
+and files above the authored 1 KiB in-memory text limit remain unsupported.
+
 ## 0.13.2 Multistep Draft And Autosave
 
 Measured 2026-08-25 on Linux x64 with Node 24.14.0 and Chrome

package/README.md

@@ -12,9 +12,9 @@ Kudzu compiles ordinary React-shaped TypeScript and TSX into complete static HTM
 
 *Watch: React-shaped TSX to static HTML and route-specific ESM in 22 seconds.*
 
-> Experimental `0.13.x`: the compiler API and supported TSX surface may change.
+> Experimental `0.14.x`: the compiler API and supported TSX surface may change.
 
-**Latest release: 0.13.2 - Multistep draft and autosave.** Native step validation, debounced versioned saves, stale-write rejection, navigation and reload restoration, conflict retention, and reset compose without a wizard or autosave runtime. Read the [release notes](./RELEASES.md#0132---multistep-draft-and-autosave), open the [release page](https://github.com/kudzujs/kudzu/releases/tag/v0.13.2), or follow the [architecture packet](./docs/next-architecture/README.md).
+**Latest release: 0.14.0 - Project table CRUD and identity.** Native table structure, ordinary state, collection selectors, and keyed ownership compose complete project CRUD with retained row identity and no data-grid runtime. Read the [release notes](./RELEASES.md#0140---project-table-crud-and-identity), open the [release page](https://github.com/kudzujs/kudzu/releases/tag/v0.14.0), 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,105 @@
 # Kudzu Releases
 
+## 0.14.0 - Project Table CRUD And Identity
+
+Kudzu 0.14.0 composes a complete native project table from ordinary state,
+collection selectors, and keyed ownership without a data-grid runtime.
+
+### Changed in 0.14.0
+
+- Replaced the project article list with valid native table structure.
+- Added project insertion, inline name editing, save, and deletion.
+- Added reorder, immutable name sorting, active filtering, and row selection.
+- Preserved keyed row and draft-input identity through reorder and sort.
+- Recreated removed rows with fresh local state after filter restoration.
+- Kept editor controls mounted with native `hidden` and verified keyboard focus.
+- Updated `create-kudzu@0.1.122` to generate projects on
+  `@kudzujs/core@^0.14.0`.
+
+### Output Evidence
+
+- The application emits 44 files totaling 159,258 raw / 51,627 aggregate gzip
+  bytes with deploy digest
+  `ebb3358e7a03612459e723ae765c39d105498db9d293415b924f1066cddf4793`.
+- The maintained two-route session remains 17 JavaScript files and totals
+  73,304 raw / 25,930 aggregate gzip bytes; `/help` remains 0 B JavaScript.
+- No semantic primitive, IR kind, compiler pass, production compiler/runtime
+  line, runtime concept, public API, or data-grid runtime was added.
+
+### Validation
+
+- Required Chrome proves insert, update, delete, reorder, sort, filter,
+  selection, keyboard access, row-local edit state, and retained DOM identity.
+- The complete suite passes 273 tests.
+- Seven fresh Chrome profiles record a 0.8 ms table-update median with a
+  0.7-1.1 ms range and a 3.9 ms navigation median with a 3.4-6.1 ms range.
+
+### Limits
+
+This is an ordinary bounded table, not virtualization. Infinite loading,
+windowing, dynamic row measurement, and 10,000-row strategy selection remain
+separate evidence packets.
+
+### Upgrade
+
+```sh
+npm install @kudzujs/core@^0.14.0
+```
+
+## 0.13.3 - File Upload Boundary
+
+Kudzu 0.13.3 composes a bounded file-upload lifecycle from native controls,
+ordinary state, owned effects, and keyed rows without an upload runtime.
+
+### Changed in 0.13.3
+
+- Added one native plain-text file input with type and 1 KiB size validation
+  before any request.
+- Added application-owned `FormData` and fetch upload with an owned
+  `AbortController`.
+- Added explicit user cancellation, delayed transport failure, and retry without
+  requiring file reselection.
+- Aborted in-flight upload work when enhanced navigation releases the route.
+- Added successful keyed attachment mutation and an explicit statement that
+  fetch does not expose upload progress.
+- Updated `create-kudzu@0.1.121` to generate projects on
+  `@kudzujs/core@^0.13.3`.
+
+### Output Evidence
+
+- The application emits 44 files totaling 150,023 raw / 50,240 aggregate gzip
+  bytes with deploy digest
+  `a16fd5dbc08086aa6a7c0ec0aba3a38fbe2a63b96005a81e8747a7f4e45e214e`.
+- The maintained two-route session remains 17 JavaScript files and totals
+  71,031 raw / 25,304 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, upload
+  scheduler, or transfer runtime was added.
+
+### Validation
+
+- Required Chrome proves pre-request validation, user cancellation, delayed
+  `503` feedback, retry, successful attachment mutation, and route-departure
+  cancellation.
+- The complete suite passes 273 tests, including the preserved draft, nested
+  form, authentication, routing, and server retry journeys.
+- Seven fresh Chrome profiles record a 3.8 ms list-to-detail median with a
+  3.5-5.0 ms range. The destination changed, so no same-content latency change
+  is claimed.
+
+### Limits
+
+Fetch upload progress is unavailable and no fake progress is rendered. Chunking,
+resume, background sync, binary formats, concurrent files, and files above the
+authored 1 KiB in-memory text limit remain unsupported until a real application
+requires a different transport.
+
+### Upgrade
+
+```sh
+npm install @kudzujs/core@^0.13.3
+```
+
 ## 0.13.2 - Multistep Draft And Autosave
 
 Kudzu 0.13.2 composes a persistent two-step draft and debounced server save

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

@@ -834,6 +834,38 @@ no same-content latency regression or improvement is claimed.
 - **Done condition:** the supported transport and unsupported progress/resume
   boundary are explicit and tested.
 
+Development evidence is complete. The Alpha application accepts one plain-text
+attachment up to 1 KiB, rejects invalid type and size before any request, reads
+the selected file into bounded route state, and reconstructs it as a `Blob` in
+one dependency effect that owns `FormData`, fetch, and `AbortController`.
+Required Chrome proves explicit user cancellation, delayed `503` feedback,
+retry without reselection, successful keyed attachment mutation, and exact
+abort when enhanced navigation releases the route.
+
+The first failing fixture was the `0.13.3` project-application contract against
+the released `0.13.2` Alpha route. Existing native file handlers, ordinary
+state, dependency invalidation, effect cleanup, owned fetch, route release, and
+keyed list identity close it without a semantic primitive, IR kind, compiler
+pass, production compiler/runtime line, normalization rule, adapter, runtime
+concept, public API, upload scheduler, or transfer runtime. The machine-readable
+decision is `closed-by-application-composition`.
+
+Fetch does not expose upload progress, so the application renders that boundary
+explicitly and does not emit a fake progress element. Chunking, resume,
+background sync, binary formats, multiple concurrent files, and files above the
+authored 1 KiB in-memory text limit remain unsupported. Add a different
+transport only when a real application requires one of those capabilities.
+
+The application emits 44 files totaling 150,023 raw / 50,240 aggregate gzip
+bytes with deploy SHA-256
+`a16fd5dbc08086aa6a7c0ec0aba3a38fbe2a63b96005a81e8747a7f4e45e214e`.
+The maintained two-route session remains 17 JavaScript files and grows by 2,367
+raw / 557 aggregate gzip bytes to 71,031 / 25,304 bytes; `/help` remains 0 B
+JavaScript. Seven fresh Linux x64 Chrome 142 profiles record list-to-detail
+samples of `[3.7, 5.0, 3.5, 3.7, 3.8, 3.8, 4.0]` ms, a 3.8 ms median and
+3.5/5.0 ms range. The destination content changed, so no same-content latency
+regression or improvement is claimed.
+
 ## `0.14.x`: Lists, Tables, And Virtualization
 
 ### `0.14.0`: Project Table CRUD And Identity
@@ -845,6 +877,35 @@ no same-content latency regression or improvement is claimed.
 - **Stop condition:** a data-grid runtime is introduced for ordinary tables.
 - **Done condition:** complete CRUD behavior passes with measured update latency.
 
+Evidence complete. The first failing fixture was the
+`0.14.0` project-application contract against the previous article list. It now
+uses a native table, ordinary array/object state, the existing pure collection
+selector, three existing keyed row-state slots, and native button/input keyboard
+behavior for insert, update, delete, reverse, sort, filter, selection, and edit.
+The browser journey proves retained row and draft-input identity through reorder
+and sort, fresh identity/state after filter removal and restoration, and focused
+keyboard reachability. Native `hidden` keeps the editor mounted rather than
+introducing a conditional callback-scope adapter or data-grid runtime.
+
+This slice adds zero semantic primitives, zero compiler passes, zero core LOC,
+and zero runtime concepts. It changes one real fixture, its contract, the
+machine-readable capability record, and the existing project benchmark. The
+application remains 44 files and changes from the `0.13.3` baseline by +9,235
+raw / +1,387 aggregate gzip bytes to 159,258 / 51,627 bytes, with deploy SHA-256
+`ebb3358e7a03612459e723ae765c39d105498db9d293415b924f1066cddf4793`.
+The maintained two-route session remains 17 JavaScript files and grows by 2,273
+raw / 626 aggregate gzip bytes to 73,304 / 25,930 bytes; `/help` remains 0 B
+JavaScript.
+
+Seven fresh Linux x64 Chrome 142 profiles record table Save-click-to-committed-
+DOM samples of `[0.7, 0.8, 1.0, 0.7, 1.1, 0.7, 0.8]` ms, a 0.8 ms median and
+0.7/1.1 ms range. This is the first equivalent table-update measurement, so no
+same-content latency delta is claimed. The same runs record list-to-detail
+samples of `[3.9, 3.9, 5.5, 4.2, 6.1, 3.5, 3.4]` ms, a 3.9 ms median and
+3.4/6.1 ms range. No compiler/runtime production logic changed; `0.14.0`
+publishes the accepted application-capability packet and `create-kudzu@0.1.122`
+generates projects on `@kudzujs/core@^0.14.0`.
+
 ### `0.14.1`: Nested And Object-State Collections
 
 - **Purpose:** prove project/group/issue/checklist nesting from ordinary object
@@ -1332,5 +1393,7 @@ release transaction where possible or document and publish a forward-fix patch.
 | `0.13.0` | Released | Preserve native constraints, server feedback, focused field errors, retained input, and retry evidence. | None |
 | `0.13.1` | Released | Preserve application-owned nested metadata, keyed row identity, release, and reset evidence. | None |
 | `0.13.2` | Released | Preserve multistep validation, versioned persistence, stale-save rejection, conflict retention, and reset evidence. | None |
-| `0.13.3` | Active | Complete the file upload boundary packet. | None |
-| `0.14.0` onward | Blocked | Complete the `0.13.3` release transaction first. | Ordered patch boundary |
+| `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` | Active | Add the first failing nested/object-state collection fixture. | None |
+| `0.14.2` onward | Blocked | Complete or explicitly close `0.14.1` 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.120` retains the explicit install instructions and generates projects with `@kudzujs/core@^0.13.2`.
+`create-kudzu@0.1.122` retains the explicit install instructions and generates projects with `@kudzujs/core@^0.14.0`.
 
 ## Release Boundary
 

package/package.json

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