@kudzujs/core 0.9.0 → 0.9.1

package/README.md

@@ -14,7 +14,7 @@ Kudzu compiles ordinary React-shaped TypeScript and TSX into complete static HTM
 
 > Experimental `0.9.x`: the compiler API and supported TSX surface may change.
 
-**Latest release: 0.9.0 - Semantic compression.** Ordinary React-shaped state, derived data, shared actions, effects, component ownership, and keyed collections compile through a bounded package-neutral semantic core while static pages remain zero JavaScript. Read the [release notes](./RELEASES.md#090---semantic-compression), open the [release page](https://github.com/kudzujs/kudzu/releases/tag/v0.9.0), or follow the [architecture packet](./docs/next-architecture/README.md).
+**Latest release: 0.9.1 - Positional primitive lists.** JSON-safe primitive values now render in position-keyed collections while property-keyed rows retain their plain-object boundary. Read the [release notes](./RELEASES.md#091---positional-primitive-lists), open the [release page](https://github.com/kudzujs/kudzu/releases/tag/v0.9.1), 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,30 @@
 # Kudzu Releases
 
+## 0.9.1 - Positional primitive lists
+
+Kudzu 0.9.1 allows JSON-safe primitive values in lists keyed by their authored
+position while retaining the plain-object requirement for property-keyed rows.
+
+### Changed in 0.9.1
+
+- Build and browser list validation now accept primitive positional rows.
+- Compact object-row serialization ignores primitive arrays instead of treating
+  their values as object records.
+- Lupin-derived fixtures prove realtime rooms, lobby and private-room entry,
+  stopwatch ownership, chat and spectator replacement, Canvas/RAF input,
+  IME handling, panic shortcuts, and exact cleanup without a game runtime.
+
+### Validation
+
+- Static sibling routes remain complete HTML with zero JavaScript.
+- `npm run check`, `npm test`, and `npm run test:package` pass with 253 tests.
+
+### Upgrade
+
+```sh
+npm install @kudzujs/core@^0.9.1
+```
+
 ## 0.9.0 - Semantic compression
 
 Kudzu 0.9.0 consolidates evidence-backed React migration shapes onto the existing signal, handler, effect, component-ownership, and keyed-list semantics without adding React, hydration, a VDOM, or a retained browser component tree.

package/framework/core.mjs

@@ -319,7 +319,7 @@ export function list(items, keyField, render, ownerField, selector = [], indexed
   for (const [index, item] of values.entries()) {
     const key = keyField === null ? index : item?.[keyField]
     if (!validListKey(key)) throw new Error(`Keyed list key "${keyField}" must be a string or finite number`)
-    assertListItem(item)
+    assertListItem(item, keyField === null)
     assertListValue(item, new Set())
     const token = `${typeof key}:${key}`
     if (keys.has(token)) throw new Error(`Duplicate keyed list key: ${String(key)}`)
@@ -360,7 +360,8 @@ function validListKey(key) {
   return typeof key === "string" || typeof key === "number" && Number.isFinite(key)
 }
 
-function assertListItem(item) {
+function assertListItem(item, allowPrimitive = false) {
+  if (allowPrimitive && (item === null || typeof item !== "object")) return
   const prototype = item && typeof item === "object" ? Object.getPrototypeOf(item) : undefined
   if (!item || Array.isArray(item) || prototype !== Object.prototype) throw new Error("Keyed list items must be ordinary plain objects")
 }
@@ -1103,6 +1104,7 @@ function escapeJsonAttribute(value) {
 
 function compactListState(value) {
   if (!Array.isArray(value) || !value.length) return undefined
+  if (!value[0] || typeof value[0] !== "object" || Array.isArray(value[0]) || Object.getPrototypeOf(value[0]) !== Object.prototype) return undefined
   const fields = Object.keys(value[0])
   if (!fields.length || !value.every(item => Object.keys(item).length === fields.length && fields.every(field => Object.hasOwn(item, field)))) return undefined
   return [fields, value.map(item => fields.map(field => item[field]))]

package/framework/list-runtime.js

@@ -170,7 +170,7 @@ function updateList(list) {
   for (const [index, item] of items.entries()) {
     const key = list.descriptor.key === null ? index : item?.[list.descriptor.key]
     if (!validListKey(key)) throw new Error(`Keyed list key "${list.descriptor.key}" must be a string or finite number`)
-    assertListItem(item)
+    assertListItem(item, list.descriptor.key === null)
     const seededValue = __KUDZU_LIST_SEEDS__ ? list.seedFields && seededListValue(item, list.seedFields, list.valueSeed, !referenceOnly) : undefined
     if (seededValue === undefined) assertListValue(item, seen, true)
     const token = keyToken(key)
@@ -1155,7 +1155,8 @@ function validListKey(key) {
   return typeof key === "string" || typeof key === "number" && Number.isFinite(key)
 }
 
-function assertListItem(item) {
+function assertListItem(item, allowPrimitive = false) {
+  if (allowPrimitive && (item === null || typeof item !== "object")) return
   const prototype = item && typeof item === "object" ? Object.getPrototypeOf(item) : undefined
   if (!item || Array.isArray(item) || prototype !== Object.prototype) throw new Error("Keyed list items must be ordinary plain objects")
 }

package/package.json

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