@kudzujs/core 0.4.3 → 0.4.6

package/README.md

@@ -166,7 +166,7 @@ const [items, setItems] = useState([
 )}</ul>
 ```
 
-Kudzu emits initial items as static HTML, then adds, removes, updates, and moves keyed elements directly. Existing keys move without remounting, preserving uncontrolled descendant state. Direct `item.<field>` reads use compact markers; derived item expressions compile to external ESM evaluators. Item-local handlers use delegated events and receive the latest JSON-safe item for their key, including after updates, additions, and reorders. The item remains stored once in shared list state; handler descriptors carry a placeholder that the list runtime fills when mounting or updating the keyed root.
+Kudzu emits initial items as static HTML, then adds, removes, updates, and moves keyed elements directly. Existing keys move without remounting, preserving uncontrolled descendant state. Direct `item.<field>` reads use compact markers; derived item expressions compile to external ESM evaluators. Item-local handlers use direct DOM listeners and receive the latest JSON-safe item for their key, including after updates, additions, and reorders. The item remains stored once in shared list state; handler descriptors carry a placeholder that the list runtime fills when mounting or updating the keyed root.
 
 Each item must be an ordinary plain object with a unique string or finite-number key; nested data may contain only JSON-safe arrays, ordinary plain objects, and primitive values. Null-prototype objects are rejected to preserve JSON round-trip parity. The current syntax requires a direct local-state `.map`, one identifier callback parameter, one intrinsic JSX root, and `key={item.<field>}`. Derived expressions must be pure and synchronous: item reads, literals, operators, templates, approved read-only string/array methods, deterministic `Math` methods, and `String`/`Number`/`Boolean` conversion are supported. Component state, locals, imported helpers, browser globals, Promise values, mutation, arbitrary calls, and prototype-sensitive properties are rejected. Nested conditions or lists, item spreads, component tags, fragments, and reactive `style`, `ref`, or `dangerouslySetInnerHTML` remain unsupported. Keyed rows must be placed inside an explicit `<tbody>`, `<thead>`, or `<tfoot>`.
 
@@ -190,7 +190,7 @@ async function load() {
 
 Primitive values, arrays, plain objects, and destructured props can be captured by client handlers. Functions, symbols, bigints, cycles, class instances, and imported helper functions are not yet supported as captures.
 
-Native handlers are delegated after normal event bubbling and run from the target toward matching Kudzu ancestors in deterministic order. Delegated handlers cannot call or reference `preventDefault`, `stopPropagation`, or `stopImmediatePropagation`; the compiler rejects those methods because external ESM cannot apply them with correct synchronous DOM semantics.
+Native handlers use direct DOM listeners with normal `currentTarget`, bubbling, default-action, and propagation semantics. Handler modules load before listener registration, so `preventDefault`, `stopPropagation`, and `stopImmediatePropagation` work synchronously as expected.
 
 ## Rendering
 
@@ -249,13 +249,13 @@ Same counter with initial value `7` and increment/decrement buttons:
 
 | Framework | Initial content | Initial JS gzip | Total output | Clean build |
 |---|---:|---:|---:|---:|
-| Kudzu | Yes | 487 B | 1.4 KB | **373 ms** |
-| Astro | Yes | **158 B** | **365 B** | 877 ms |
-| Svelte CSR | No | 10.5 KB | 26.9 KB | 837 ms |
-| Qwik CSR | No | 20.6 KB | 57.8 KB | 626 ms |
-| Vue CSR | No | 24.0 KB | 60.3 KB | 778 ms |
-| React CSR | No | 59.2 KB | 189.0 KB | 1049 ms |
-| Next.js | Yes | 182.1 KB | 652.2 KB | 3099 ms |
+| Kudzu | Yes | 487 B | 1.4 KB | **363 ms** |
+| Astro | Yes | **158 B** | **365 B** | 851 ms |
+| Svelte CSR | No | 10.5 KB | 26.9 KB | 827 ms |
+| Qwik CSR | No | 20.6 KB | 57.8 KB | 598 ms |
+| Vue CSR | No | 24.0 KB | 60.3 KB | 762 ms |
+| React CSR | No | 59.2 KB | 189.0 KB | 1018 ms |
+| Next.js | Yes | 182.1 KB | 652.2 KB | 2989 ms |
 
 Astro produces the smallest hand-authored counter. Kudzu's advantage in this fixture is React-shaped state code with a sub-1 KB runtime, not the smallest possible JavaScript.
 
@@ -265,15 +265,31 @@ Same content and CSS across every fixture:
 
 | Framework | Initial content | Initial JS gzip | Total output | Clean build |
 |---|---:|---:|---:|---:|
-| Kudzu | Yes | **0 B** | 3.2 KB | **478 ms** |
-| Astro | Yes | **0 B** | **3.0 KB** | 1253 ms |
-| Svelte CSR | No | 10.2 KB | 27.2 KB | 1018 ms |
-| Qwik CSR | No | 20.2 KB | 59.6 KB | 784 ms |
-| Vue CSR | No | 24.2 KB | 62.3 KB | 960 ms |
-| React CSR | No | 59.8 KB | 192.3 KB | 1253 ms |
-| Next.js | Yes | 182.6 KB | 663.6 KB | 3880 ms |
-
-Benchmark snapshot collected on July 21, 2026 with Node 24.14.0 on an Intel i5-9500. React, Vue, Svelte, and Qwik used client-rendered fixtures, while Kudzu and Astro emitted initial HTML; Qwik therefore did not exercise its SSR resumability advantage. These results compare the selected one-page fixtures, not ecosystem maturity, browser interaction speed, or each framework's full rendering options. Build times vary with machine load and filesystem cache.
+| Kudzu | Yes | **0 B** | 3.2 KB | **380 ms** |
+| Astro | Yes | **0 B** | **3.0 KB** | 965 ms |
+| Svelte CSR | No | 10.2 KB | 27.2 KB | 824 ms |
+| Qwik CSR | No | 20.2 KB | 59.6 KB | 594 ms |
+| Vue CSR | No | 24.2 KB | 62.3 KB | 755 ms |
+| React CSR | No | 59.8 KB | 192.3 KB | 1041 ms |
+| Next.js | Yes | 182.6 KB | 663.6 KB | 2975 ms |
+
+### 1,000-item Keyed List
+
+The list starts with 1,000 keyed items, then updates every label, reverses the order, removes odd IDs, and adds 500 items. Browser timings are medians from seven fresh headless Chrome runs.
+
+| Framework | Initial content | Initial JS gzip | Total output | Build | Update | Reverse | Remove | Add | Operations total |
+|---|---:|---:|---:|---:|---:|---:|---:|---:|---:|
+| Astro | Yes | **324 B** | **43.6 KB** | 852 ms | **3.5 ms** | 25.8 ms | 15.8 ms | **17.9 ms** | **63.0 ms** |
+| Kudzu | Yes | 6.3 KB | 69.3 KB | **406 ms** | 6.0 ms | 28.5 ms | 14.7 ms | 19.1 ms | **68.3 ms** |
+| Next.js | Yes | 182.2 KB | 695.2 KB | 2950 ms | 6.8 ms | 34.1 ms | **9.0 ms** | 19.3 ms | 69.2 ms |
+| React CSR | No | 59.3 KB | 189.4 KB | 1028 ms | 9.5 ms | 35.3 ms | 10.1 ms | **17.8 ms** | 72.7 ms |
+| Vue CSR | No | 24.3 KB | 61.3 KB | 759 ms | 10.2 ms | 33.9 ms | 9.3 ms | 19.7 ms | 73.1 ms |
+| Qwik CSR | No | 22.2 KB | 64.1 KB | 604 ms | 15.6 ms | **20.0 ms** | 30.4 ms | 18.1 ms | 84.1 ms |
+| Svelte CSR | No | 12.9 KB | 33.1 KB | 845 ms | 5.4 ms | 64.4 ms | 11.2 ms | 19.1 ms | 100.1 ms |
+
+Astro is the hand-authored native DOM baseline in the interactive fixtures. React, Vue, Svelte, and Qwik used client-rendered fixtures, while Kudzu and Astro emitted initial HTML; Qwik therefore did not exercise its SSR resumability advantage. Kudzu's keyed-list operations total 68.3 ms, ahead of the React fixture's 72.7 ms and within 5.3 ms of Astro across all four operations.
+
+Benchmark snapshot collected on July 22, 2026 with Node 24.14.0 on an Intel i5-9500. These results compare the selected one-page fixtures, not ecosystem maturity, browser interaction speed beyond the listed operations, or each framework's full rendering options. Build times vary with machine load and filesystem cache.
 
 ## Development
 

package/framework/build.mjs

@@ -64,12 +64,13 @@ export async function build({ quiet = false } = {}) {
   await mkdir(assetsDirectory, { recursive: true })
   const commandEvents = [...new Set(plans.flatMap(plan => plan.events.filter(event => event.commands).map(event => event.event)))].sort()
   const nativeEvents = [...new Set(plans.flatMap(plan => plan.events.filter(event => event.native).map(event => event.event)))].sort()
+  const nativeModules = handlerModules.filter(module => module.hasNativeHandlers).map(module => `/assets/${module.path}`)
+  const hasNativeHandlers = nativeModules.length > 0
   if (behaviorCount) {
-    const runtimeFile = bindingCount || listCount ? "./shared-runtime.js" : "./runtime.js"
+    const runtimeFile = bindingCount || listCount || hasNativeHandlers ? "./shared-runtime.js" : "./runtime.js"
     const runtime = specializeRuntime(await readFile(new URL(runtimeFile, import.meta.url), "utf8"), commandEvents, stateSeedCount > 0)
     await writeFile(join(assetsDirectory, "kudzu.js"), runtime)
   }
-  const hasNativeHandlers = handlerModules.some(module => module.hasNativeHandlers)
   if (bindingCount || hasNativeHandlers) await cp(new URL("./serialization.js", import.meta.url), join(assetsDirectory, "kudzu-serialization.js"))
   if (bindingCount) {
     const bindingRuntime = (await readFile(new URL("./binding-runtime.js", import.meta.url), "utf8"))
@@ -84,9 +85,9 @@ export async function build({ quiet = false } = {}) {
   }
   if (hasNativeHandlers) {
     const nativeRuntime = (await readFile(new URL("./native-runtime.js", import.meta.url), "utf8"))
-      .replace('"./runtime.js"', '"./kudzu.js"')
+      .replace('"./shared-runtime.js"', '"./kudzu.js"')
       .replace('"./serialization.js"', '"./kudzu-serialization.js"')
-    await writeFile(join(assetsDirectory, "kudzu-native.js"), specializeEvents(nativeRuntime, nativeEvents))
+    await writeFile(join(assetsDirectory, "kudzu-native.js"), specializeNativeRuntime(nativeRuntime, nativeEvents, nativeModules))
   }
   for (const handlerModule of handlerModules) {
     const output = join(assetsDirectory, handlerModule.path)
@@ -104,12 +105,18 @@ function specializeEvents(source, events) {
   return source.replace(/const eventNames = \[[^\n]+\]/, `const eventNames = ${JSON.stringify(events)}`)
 }
 
+function specializeNativeRuntime(source, events, modules) {
+  const imports = modules.map((module, index) => `import * as __kNativeModule${index} from ${JSON.stringify(module)}`).join("\n")
+  const entries = modules.map((module, index) => `[${JSON.stringify(module)}, __kNativeModule${index}]`).join(",")
+  return `${imports}\n${specializeEvents(source, events).replace(/const modules = new Map\(\[[^\n]*\]\)/, `const modules = new Map([${entries}])`)}`
+}
+
 function specializeRuntime(source, events, hasStateSeed) {
   const specialized = specializeEvents(source, events)
   if (hasStateSeed) return specialized
   return specialized
     .replace("  const initialState = document.body.dataset.kState\n", "")
-    .replace("  if (initialState) for (const [id, value] of JSON.parse(initialState)) browserState.set(id, value)\n", "")
+    .replace("  if (initialState) for (const [id, value, compact] of JSON.parse(initialState)) browserState.set(id, compact ? value[1].map(row => Object.fromEntries(value[0].map((field, index) => [field, row[index]]))) : value)\n", "")
 }
 
 export function parseDevPort(value) {
@@ -661,7 +668,6 @@ function compileEvent(expression, setters, functions, factory, nativeHandlers, h
   if (ts.isIdentifier(expression)) expression = functions.get(expression.text)
   if (!expression || (!ts.isArrowFunction(expression) && !ts.isFunctionExpression(expression) && !ts.isFunctionDeclaration(expression))) return undefined
 
-  rejectNativeEventControls(expression)
   const optimized = compileOptimizedEvent(expression, setters, factory)
   if (optimized) return optimized
 
@@ -684,34 +690,6 @@ function compileEvent(expression, setters, functions, factory, nativeHandlers, h
   ])
 }
 
-function rejectNativeEventControls(expression) {
-  const controls = new Set(["preventDefault", "stopPropagation", "stopImmediatePropagation"])
-  const found = new Set()
-  const eventAliases = new Set()
-  const parameter = expression.parameters[0]?.name
-  if (parameter && ts.isIdentifier(parameter)) eventAliases.add(parameter.text)
-  const visit = node => {
-    if (ts.isIdentifier(node) && controls.has(node.text)) found.add(node.text)
-    if (ts.isVariableDeclaration(node) && ts.isIdentifier(node.name) && node.initializer && ts.isIdentifier(unwrapEventAlias(node.initializer)) && eventAliases.has(unwrapEventAlias(node.initializer).text)) {
-      eventAliases.add(node.name.text)
-    }
-    if (ts.isBinaryExpression(node) && node.operatorToken.kind === ts.SyntaxKind.EqualsToken && ts.isIdentifier(node.left) && ts.isIdentifier(unwrapEventAlias(node.right)) && eventAliases.has(unwrapEventAlias(node.right).text)) eventAliases.add(node.left.text)
-    if (ts.isElementAccessExpression(node) && ts.isIdentifier(unwrapEventAlias(node.expression)) && eventAliases.has(unwrapEventAlias(node.expression).text)) {
-      if (ts.isStringLiteral(node.argumentExpression) && controls.has(node.argumentExpression.text)) found.add(node.argumentExpression.text)
-      else if (!ts.isStringLiteral(node.argumentExpression)) for (const control of controls) found.add(control)
-    }
-    ts.forEachChild(node, visit)
-  }
-  for (const parameter of expression.parameters) visit(parameter)
-  visit(expression.body)
-  if (found.size) throw new Error(`Delegated native handlers do not support event control methods: ${[...found].sort().join(", ")}`)
-}
-
-function unwrapEventAlias(node) {
-  if (ts.isParenthesizedExpression(node) || ts.isAsExpression(node) || ts.isTypeAssertionExpression(node) || ts.isNonNullExpression(node) || ts.isSatisfiesExpression(node)) return unwrapEventAlias(node.expression)
-  return node
-}
-
 function nativeStateNames(expression, setters) {
   return referencedStateNames(expression.body, setters, expression)
 }

package/framework/core.mjs

@@ -187,7 +187,7 @@ function serializeCapture(name, value, seen) {
 }
 
 export async function renderPage(component, metadata = {}) {
-  renderContext = { nextState: 0, nextCondition: 0, nextList: 0, conditionDepth: 0, listDepth: 0, listRoot: undefined, listTemplate: false, states: {}, textStates: new Set(), conditionStates: new Set(), events: [], bindings: [], conditions: [], lists: [], hasBehaviors: false, hasNativeBehaviors: false, hasBindings: false, hasLists: false }
+  renderContext = { nextState: 0, nextCondition: 0, nextList: 0, conditionDepth: 0, listDepth: 0, listRoot: undefined, listTemplate: false, listFields: undefined, states: {}, textStates: new Set(), conditionStates: new Set(), events: [], bindings: [], conditions: [], lists: [], hasBehaviors: false, hasNativeBehaviors: false, hasBindings: false, hasLists: false }
 
   try {
     const body = await renderNode({ type: component, props: {} })
@@ -208,8 +208,13 @@ export async function renderPage(component, metadata = {}) {
     const listRuntime = renderContext.hasLists
       ? '<script type="module" src="/assets/kudzu-list.js"></script>'
       : ""
+    const listStates = new Set(renderContext.lists.map(list => list.state))
+    const seededListStates = new Set(renderContext.lists.filter(list => list.seed && !renderContext.textStates.has(list.state) && !renderContext.conditionStates.has(list.state)).map(list => list.state))
     const initialState = renderContext.hasBehaviors
-      ? Object.entries(renderContext.states).filter(([id]) => !renderContext.textStates.has(id) || renderContext.conditionStates.has(id)).map(([id, entry]) => [id, entry.initialValue])
+      ? Object.entries(renderContext.states).filter(([id]) => (!renderContext.textStates.has(id) || renderContext.conditionStates.has(id)) && !seededListStates.has(id)).map(([id, entry]) => {
+        const compact = listStates.has(id) && compactListState(entry.initialValue)
+        return compact ? [id, compact, 1] : [id, entry.initialValue]
+      })
       : []
     const state = initialState.length
       ? ` data-k-state='${escapeJsonAttribute(initialState)}'`
@@ -305,11 +310,14 @@ async function renderNode(node, namespace, selectValue = noSelectValue) {
   }
   if (node?.[listMarker]) return renderList(node, namespace, selectValue)
   if (node?.[listFieldMarker]) {
-    return `<template data-k-list-text="${escapeAttribute(node.field)}"></template>${escapeHtml(node.value ?? "")}<template data-k-list-text-end></template>`
+    if (renderContext.listTemplate) renderContext.listFields?.add(node.field)
+    const marker = renderContext.listTemplate ? ` data-k-list-text="${escapeAttribute(node.field)}"` : ""
+    return `<template${marker}></template>${escapeHtml(node.value ?? "")}<template data-k-list-text-end></template>`
   }
   if (node?.[listExpressionMarker]) {
     const descriptor = { module: node.module, handler: node.handler }
-    return `<template data-k-list-expression='${escapeJsonAttribute(descriptor)}'></template>${escapeHtml(node.value ?? "")}<template data-k-list-expression-end></template>`
+    const marker = renderContext.listTemplate ? ` data-k-list-expression='${escapeJsonAttribute(descriptor)}'` : ""
+    return `<template${marker}></template>${escapeHtml(node.value ?? "")}<template data-k-list-expression-end></template>`
   }
   if (!node || typeof node !== "object" || !("type" in node)) {
     throw new Error(`Cannot render ${String(node)}`)
@@ -320,6 +328,7 @@ async function renderNode(node, namespace, selectValue = noSelectValue) {
 
   const tag = node.type
   const props = node.props ?? {}
+  const directListText = props.children?.[listFieldMarker] ? props.children : undefined
   const childSelectValue = tag === "select"
     ? Object.hasOwn(props, "value") ? bindingValue(props.value) : noSelectValue
     : selectValue
@@ -335,9 +344,7 @@ async function renderNode(node, namespace, selectValue = noSelectValue) {
   if (renderContext.listRoot) {
     const root = renderContext.listRoot
     renderContext.listRoot = undefined
-    attributes += root.template
-      ? ` data-k-list-root="${root.id}"`
-      : ` data-k-list-item='${escapeJsonAttribute([root.id, root.key])}'`
+    if (root.template) attributes += ` data-k-list-root="${root.id}"`
   }
 
   for (const [rawName, value] of Object.entries(props)) {
@@ -411,26 +418,36 @@ async function renderNode(node, namespace, selectValue = noSelectValue) {
   }
 
   if (attributeBindings.length) attributes += ` data-k-bind-attrs='${escapeJsonAttribute(attributeBindings)}'`
-  if (listAttributes.length) attributes += ` data-k-list-attrs='${escapeJsonAttribute(listAttributes)}'`
-  if (listExpressionAttributes.length) attributes += ` data-k-list-expression-attrs='${escapeJsonAttribute(listExpressionAttributes)}'`
-  if (listEvents.length) attributes += ` data-k-list-events='${escapeJsonAttribute(listEvents)}'`
+  if (renderContext.listTemplate && listAttributes.length) attributes += ` data-k-list-attrs='${escapeJsonAttribute(listAttributes)}'`
+  if (renderContext.listTemplate && listExpressionAttributes.length) attributes += ` data-k-list-expression-attrs='${escapeJsonAttribute(listExpressionAttributes)}'`
+  if (renderContext.listTemplate && listEvents.length) attributes += ` data-k-list-events='${escapeJsonAttribute(listEvents)}'`
+  if (renderContext.listTemplate && directListText) {
+    renderContext.listFields?.add(directListText.field)
+    attributes += ` data-k-list-text="${escapeAttribute(directListText.field)}"`
+  }
 
   if (tag === "option" && selectValue !== noSelectValue && String(optionValue(props)) === (selectValue == null ? "" : String(selectValue))) attributes += " selected"
 
   const voidElements = new Set(["area", "base", "br", "col", "embed", "hr", "img", "input", "link", "meta", "source", "track", "wbr"])
   if (voidElements.has(tag)) return `<${tag}${attributes}>`
-  return `<${tag}${attributes}>${await renderNode(props.children, childNamespace, childSelectValue)}</${tag}>`
+  const children = directListText ? escapeHtml(directListText.value ?? "") : await renderNode(props.children, childNamespace, childSelectValue)
+  return `<${tag}${attributes}>${children}</${tag}>`
 }
 
 async function renderList(node, namespace, selectValue) {
   if (namespace) throw new Error(`Reactive keyed lists are not supported inside ${namespace}`)
   const id = `l${renderContext.nextList++}`
-  const descriptor = { id, state: node.items.id, key: node.keyField }
+  const descriptor = { id, state: node.items.id, key: node.keyField, keys: node.items.value.map(item => item[node.keyField]) }
   renderContext.listDepth++
+  const previousListFields = renderContext.listFields
   try {
     renderContext.listTemplate = true
+    renderContext.listFields = new Set([node.keyField])
     renderContext.listRoot = { id, template: true }
     const template = await renderNode(node.render({}), namespace, selectValue)
+    if (template.includes("data-k-native-")) descriptor.mount = true
+    const seed = listSeed(node.items.value, renderContext.listFields)
+    if (seed) descriptor.seed = seed
     let current = ""
     renderContext.listTemplate = false
     for (const item of node.items.value) {
@@ -444,6 +461,7 @@ async function renderList(node, namespace, selectValue) {
   } finally {
     renderContext.listRoot = undefined
     renderContext.listTemplate = false
+    renderContext.listFields = previousListFields
     renderContext.listDepth--
   }
 }
@@ -490,6 +508,24 @@ function escapeJsonAttribute(value) {
   return JSON.stringify(value).replaceAll("&", "&amp;").replaceAll("<", "&lt;").replaceAll("'", "&#39;")
 }
 
+function compactListState(value) {
+  if (!Array.isArray(value) || !value.length) 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]))]
+}
+
+function listSeed(items, fields) {
+  if (!items.length || !items.every(item => Object.keys(item).length === fields.size && Object.keys(item).every(field => fields.has(field)))) return undefined
+  const seed = {}
+  for (const field of fields) {
+    const types = new Set(items.map(item => item[field] === null ? "null" : typeof item[field]))
+    if (types.size !== 1 || !["string", "number", "boolean", "null"].includes([...types][0])) return undefined
+    seed[field] = [...types][0]
+  }
+  return seed
+}
+
 function toKebabCase(value) {
   return value.replace(/[A-Z]/g, character => `-${character.toLowerCase()}`)
 }

package/framework/list-runtime.js

@@ -5,6 +5,8 @@ const listRegistrations = new WeakMap()
 const mountedLists = new WeakSet()
 const imports = new Map()
 const revisions = new WeakMap()
+const itemParts = new WeakMap()
+const itemPartsSelector = "[data-k-list-text],[data-k-list-attrs],[data-k-list-events],[data-k-list-expression],[data-k-list-expression-attrs]"
 
 function commitLists(id) {
   const lists = listTargets.get(id)
@@ -26,13 +28,22 @@ function mountLists(root) {
     if (mountedLists.has(start)) continue
     mountedLists.add(start)
     const descriptor = JSON.parse(start.dataset.kList)
-    const roots = [...start.ownerDocument.querySelectorAll("[data-k-list-item]")].filter(node => JSON.parse(node.dataset.kListItem)[0] === descriptor.id)
+    const end = findEnd(start, descriptor.id)
+    const roots = listRoots(start, end)
+    const templateRoot = start.content.firstElementChild
+    const parts = listItemPartPlan(templateRoot)
+    for (const root of roots) mapListItemParts(parts, root)
+    if (descriptor.seed && !browserState.has(descriptor.state)) browserState.set(descriptor.state, roots.map((root, index) => seedListItem(root, descriptor, index)))
+    const items = browserState.get(descriptor.state)
     const list = {
       start,
       descriptor,
-      roots: new Map(roots.map(node => [keyToken(JSON.parse(node.dataset.kListItem)[1]), node])),
+      parts,
+      seedFields: descriptor.seed && Object.keys(descriptor.seed),
+      roots: new Map(roots.map((node, index) => [keyToken(descriptor.keys[index]), node])),
+      values: new Map(),
       container: roots[0]?.parentNode,
-      boundary: roots.length ? roots.at(-1).nextSibling : findEnd(start, descriptor.id)
+      boundary: end
     }
     register(listTargets, descriptor.state, list)
     listRegistrations.set(start, { state: descriptor.state, list })
@@ -60,66 +71,111 @@ function updateList(list) {
   if (!Array.isArray(items)) throw new Error("Keyed list state must remain an array")
   const entries = []
   const keys = new Set()
+  const seen = new Set()
   for (const item of items) {
     const key = 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)
-    assertListValue(item, new Set())
+    const seededValue = list.seedFields && seededListValue(item, list.seedFields, list.descriptor.seed)
+    if (seededValue === undefined) assertListValue(item, seen, true)
     const token = keyToken(key)
     if (keys.has(token)) throw new Error(`Duplicate keyed list key: ${String(key)}`)
     keys.add(token)
-    entries.push({ item, key, token })
+    entries.push({ item, key, token, value: seededValue ?? JSON.stringify(item) })
   }
   const next = []
-  for (const { item, key, token } of entries) {
+  const values = new Map()
+  const parent = list.container ?? list.start.parentNode
+  const additions = parent.ownerDocument.createDocumentFragment()
+  let added = false
+  for (const { item, key, token, value } of entries) {
     let node = list.roots.get(token)
     if (!node) {
-      const fragment = list.start.content.cloneNode(true)
-      node = fragment.querySelector(`[data-k-list-root="${list.descriptor.id}"]`)
+      node = list.start.content.firstElementChild?.cloneNode(true)
+      if (node?.dataset.kListRoot !== list.descriptor.id) node = undefined
       if (!node) throw new Error("Keyed list template has no root element")
       node.removeAttribute("data-k-list-root")
-      node.dataset.kListItem = JSON.stringify([list.descriptor.id, key])
+      mapListItemParts(list.parts, node)
       fillListItem(node, item)
-      ;(list.container ?? list.start.parentNode).insertBefore(fragment, list.boundary)
-      list.container ??= node.parentNode
-      mountDom(node)
-    } else {
+      additions.append(node)
+      added = true
+    } else if (list.values.get(token) !== value) {
       fillListItem(node, item)
     }
     next.push([token, node])
+    values.set(token, value)
   }
+  const removals = parent.ownerDocument.createDocumentFragment()
   for (const [token, node] of list.roots) {
     if (keys.has(token)) continue
-    unmountDom(node)
-    node.remove()
+    if (list.descriptor.mount) {
+      unmountDom(node)
+      node.remove()
+    } else {
+      removals.append(node)
+    }
+  }
+  if (added) {
+    if (list.descriptor.mount) mountDom(additions)
+    parent.insertBefore(additions, list.boundary)
+    list.container ??= parent
+  }
+  let anchor = list.boundary
+  let misplaced = 0
+  for (let index = next.length - 1; index >= 0; index--) {
+    const node = next[index][1]
+    if (node.nextSibling !== anchor) misplaced++
+    anchor = node
+  }
+  if (misplaced > next.length / 2) {
+    const reordered = parent.ownerDocument.createDocumentFragment()
+    reordered.append(...next.map(([, node]) => node))
+    parent.insertBefore(reordered, list.boundary)
+  } else if (misplaced) {
+    anchor = list.boundary
+    for (let index = next.length - 1; index >= 0; index--) {
+      const node = next[index][1]
+      if (node.nextSibling !== anchor) parent.insertBefore(node, anchor)
+      anchor = node
+    }
   }
-  const parent = list.container ?? list.start.parentNode
-  for (const [, node] of next) parent.insertBefore(node, list.boundary)
   list.roots = new Map(next)
+  list.values = values
 }
 
 function fillListItem(root, item) {
   const revision = (revisions.get(root) ?? 0) + 1
   revisions.set(root, revision)
-  for (const marker of matching(root, "template[data-k-list-text]")) {
-    patchListText(marker, "template[data-k-list-text-end]", item?.[marker.dataset.kListText])
+  const parts = listItemParts(root)
+  for (const [node, field] of parts.directTexts) {
+    const text = item?.[field]
+    const value = text == null ? "" : String(text)
+    const current = node.firstChild
+    if (current?.nodeType === Node.TEXT_NODE && !current.nextSibling) {
+      if (current.data !== value) current.data = value
+    } else {
+      node.textContent = value
+    }
+  }
+  for (const [marker, field] of parts.texts) {
+    patchListText(marker, "template[data-k-list-text-end]", item?.[field])
   }
-  for (const node of matching(root, "[data-k-list-attrs]")) {
-    for (const [target, field] of JSON.parse(node.dataset.kListAttrs)) patchBinding(node, target, item?.[field])
+  for (const [node, attributes] of parts.attributes) {
+    for (const [target, field] of attributes) patchBinding(node, target, item?.[field])
   }
-  for (const node of matching(root, "[data-k-list-events]")) {
-    for (const [event, native] of JSON.parse(node.dataset.kListEvents)) {
+  for (const [node, events] of parts.events) {
+    for (const [event, native] of JSON.parse(events)) {
       native.scope = Object.fromEntries(Object.entries(native.scope).map(([name, value]) => [name, value?.type === "list-item" ? serializeItem(item) : value]))
       node.dataset[`kNative${capitalize(event)}`] = JSON.stringify(native)
     }
   }
-  for (const marker of matching(root, "template[data-k-list-expression]")) {
-    evaluate(JSON.parse(marker.dataset.kListExpression), item).then(value => {
+  for (const [marker, descriptor] of parts.expressions) {
+    evaluate(descriptor, item).then(value => {
       if (revisions.get(root) === revision && root.isConnected) patchListText(marker, "template[data-k-list-expression-end]", value)
     }).catch(error => console.error(error))
   }
-  for (const node of matching(root, "[data-k-list-expression-attrs]")) {
-    for (const [target, module, handler] of JSON.parse(node.dataset.kListExpressionAttrs)) {
+  for (const [node, attributes] of parts.expressionAttributes) {
+    for (const [target, module, handler] of attributes) {
       evaluate({ module, handler }, item).then(value => {
         if (revisions.get(root) === revision && root.isConnected) patchBinding(node, target, value)
       }).catch(error => console.error(error))
@@ -127,15 +183,91 @@ function fillListItem(root, item) {
   }
 }
 
+function listItemParts(root) {
+  let parts = itemParts.get(root)
+  if (parts) return parts
+  parts = { directTexts: [], texts: [], attributes: [], events: [], expressions: [], expressionAttributes: [] }
+  for (const node of matching(root, itemPartsSelector)) {
+    if (node.hasAttribute("data-k-list-text")) (node.tagName === "TEMPLATE" ? parts.texts : parts.directTexts).push([node, node.dataset.kListText])
+    if (node.hasAttribute("data-k-list-attrs")) parts.attributes.push([node, JSON.parse(node.dataset.kListAttrs)])
+    if (node.hasAttribute("data-k-list-events")) parts.events.push([node, node.dataset.kListEvents])
+    if (node.hasAttribute("data-k-list-expression")) parts.expressions.push([node, JSON.parse(node.dataset.kListExpression)])
+    if (node.hasAttribute("data-k-list-expression-attrs")) parts.expressionAttributes.push([node, JSON.parse(node.dataset.kListExpressionAttrs)])
+  }
+  itemParts.set(root, parts)
+  return parts
+}
+
+function listItemPartPlan(template) {
+  const source = [template, ...template.querySelectorAll("*")]
+  const indexes = new Map(source.map((node, index) => [node, index]))
+  const parts = listItemParts(template)
+  return {
+    directTexts: parts.directTexts.map(([node, field]) => [indexes.get(node), field]),
+    texts: parts.texts.map(([node, field]) => [indexes.get(node), field]),
+    attributes: parts.attributes.map(([node, attributes]) => [indexes.get(node), attributes]),
+    events: parts.events.map(([node, events]) => [indexes.get(node), events]),
+    expressions: parts.expressions.map(([node, descriptor]) => [indexes.get(node), descriptor]),
+    expressionAttributes: parts.expressionAttributes.map(([node, attributes]) => [indexes.get(node), attributes])
+  }
+}
+
+function mapListItemParts(parts, root) {
+  const target = [root, ...root.querySelectorAll("*")]
+  itemParts.set(root, {
+    directTexts: parts.directTexts.map(([index, field]) => [target[index], field]),
+    texts: parts.texts.map(([index, field]) => [target[index], field]),
+    attributes: parts.attributes.map(([index, attributes]) => [target[index], attributes]),
+    events: parts.events.map(([index, events]) => [target[index], events]),
+    expressions: parts.expressions.map(([index, descriptor]) => [target[index], descriptor]),
+    expressionAttributes: parts.expressionAttributes.map(([index, attributes]) => [target[index], attributes])
+  })
+}
+
+function listRoots(start, end) {
+  const roots = []
+  for (let node = start.nextSibling; node && node !== end; node = node.nextSibling) {
+    if (node.nodeType === Node.ELEMENT_NODE) roots.push(node)
+  }
+  return roots
+}
+
+function seedListItem(root, descriptor, index) {
+  const item = { [descriptor.key]: descriptor.keys[index] }
+  const parts = itemParts.get(root)
+  for (const [node, field] of parts.directTexts) item[field] = seedValue(node.textContent, descriptor.seed[field])
+  for (const [marker, field] of parts.texts) item[field] = seedValue(rangeText(marker, "template[data-k-list-text-end]"), descriptor.seed[field])
+  return item
+}
+
+function seedValue(value, type) {
+  if (type === "number") return Number(value)
+  if (type === "boolean") return value === "true"
+  if (type === "null") return null
+  return value
+}
+
+function rangeText(marker, endSelector) {
+  let value = ""
+  for (let node = marker.nextSibling; node && !(node.nodeType === Node.ELEMENT_NODE && node.matches(endSelector)); node = node.nextSibling) value += node.textContent
+  return value
+}
+
 function patchListText(marker, endSelector, value) {
   let end = marker.nextSibling
   while (end && !(end.nodeType === Node.ELEMENT_NODE && end.matches(endSelector))) end = end.nextSibling
   if (!end) throw new Error("Keyed list text marker has no end")
+  const text = value == null ? "" : String(value)
+  const current = marker.nextSibling
+  if (current?.nodeType === Node.TEXT_NODE && current.nextSibling === end) {
+    if (current.data !== text) current.data = text
+    return
+  }
   const range = marker.ownerDocument.createRange()
   range.setStartAfter(marker)
   range.setEndBefore(end)
   range.deleteContents()
-  end.before(marker.ownerDocument.createTextNode(value == null ? "" : String(value)))
+  end.before(marker.ownerDocument.createTextNode(text))
 }
 
 function evaluate(descriptor, item) {
@@ -189,19 +321,35 @@ function assertListItem(item) {
   if (!item || Array.isArray(item) || prototype !== Object.prototype) throw new Error("Keyed list items must be ordinary plain objects")
 }
 
-function assertListValue(value, seen) {
+function seededListValue(item, fields, seed) {
+  const keys = Reflect.ownKeys(item)
+  if (keys.length !== fields.length || keys.some(key => typeof key !== "string" || !fields.includes(key))) return undefined
+  const values = []
+  for (const field of fields) {
+    const descriptor = Object.getOwnPropertyDescriptor(item, field)
+    if (!descriptor.enumerable) throw new Error("Keyed list items must not contain non-enumerable properties")
+    if (!("value" in descriptor)) throw new Error("Keyed list items must not contain accessors")
+    const value = descriptor.value
+    const type = value === null ? "null" : typeof value
+    if (type !== seed[field] || type === "number" && (!Number.isFinite(value) || Object.is(value, -0))) return undefined
+    values.push(value)
+  }
+  return JSON.stringify(values)
+}
+
+function assertListValue(value, seen, root = false) {
   if (value === null || typeof value === "string" || typeof value === "boolean" || typeof value === "number" && Number.isFinite(value) && !Object.is(value, -0)) return
   if (!value || typeof value !== "object") throw new Error("Keyed list items must contain only JSON-safe values")
   if (seen.has(value)) throw new Error("Keyed list items must not contain cycles")
-  const prototype = Object.getPrototypeOf(value)
-  if (!Array.isArray(value) && prototype !== Object.prototype) throw new Error("Keyed list items must contain only arrays and ordinary plain objects")
-  if (Object.getOwnPropertySymbols(value).length) throw new Error("Keyed list items must not contain symbols")
+  if (!root && !Array.isArray(value) && Object.getPrototypeOf(value) !== Object.prototype) throw new Error("Keyed list items must contain only arrays and ordinary plain objects")
   seen.add(value)
-  const descriptors = Object.getOwnPropertyDescriptors(value)
-  if (Array.isArray(value) && Object.keys(descriptors).some(key => key !== "length" && !/^(0|[1-9]\d*)$/.test(key))) throw new Error("Keyed list arrays must not contain custom properties")
+  const keys = Reflect.ownKeys(value)
+  if (keys.some(key => typeof key === "symbol")) throw new Error("Keyed list items must not contain symbols")
+  if (Array.isArray(value) && keys.some(key => key !== "length" && !/^(0|[1-9]\d*)$/.test(key))) throw new Error("Keyed list arrays must not contain custom properties")
   if (Array.isArray(value) && Object.keys(value).length !== value.length) throw new Error("Keyed list arrays must not contain holes")
-  for (const [key, descriptor] of Object.entries(descriptors)) {
+  for (const key of keys) {
     if (Array.isArray(value) && key === "length") continue
+    const descriptor = Object.getOwnPropertyDescriptor(value, key)
     if (!descriptor.enumerable) throw new Error("Keyed list items must not contain non-enumerable properties")
     if (!("value" in descriptor)) throw new Error("Keyed list items must not contain accessors")
     assertListValue(descriptor.value, seen)

package/framework/native-runtime.js

@@ -1,6 +1,8 @@
-import { browserState, commitDom } from "./runtime.js"
+import { browserState, commitDom, registerMountHook, registerUnmountHook } from "./shared-runtime.js"
 import { deserialize } from "./serialization.js"
 
+const registrations = new WeakMap()
+
 export function createNativeContext(state, stateIds, commit, serializedScope = {}) {
   const changed = new Set()
   let scheduled = false
@@ -34,54 +36,44 @@ export function createNativeContext(state, stateIds, commit, serializedScope = {
 }
 
 if (typeof document !== "undefined") {
-  const modules = new Map()
-
   const eventNames = ["click", "input", "change", "submit", "keydown", "keyup"]
-  for (const eventName of eventNames) {
-    document.addEventListener(eventName, event => {
-      try {
-        dispatchNative(event, snapshotNativeTargets(event, eventName), modules).catch(error => console.error(error))
-      } catch (error) {
-        console.error(error)
-      }
-    })
-  }
+  const modules = new Map([])
+  const mount = root => mountNative(root, eventNames, modules)
+  registerMountHook(mount)
+  registerUnmountHook(unmountNative)
+  mount(document)
 }
 
-function snapshotNativeTargets(event, eventName) {
-  const selector = `[data-k-native-${eventName}]`
-  const targets = []
-  for (let target = event.target.closest(selector); target; target = target.parentElement?.closest(selector)) {
-    targets.push({ target, native: JSON.parse(target.dataset[`kNative${capitalize(eventName)}`]) })
+function mountNative(root, eventNames, modules) {
+  for (const eventName of eventNames) {
+    for (const node of matching(root, `[data-k-native-${eventName}]`)) {
+      const listeners = registrations.get(node) ?? new Map()
+      if (listeners.has(eventName)) continue
+      const listener = event => {
+        try {
+          const native = JSON.parse(node.dataset[`kNative${capitalize(eventName)}`])
+          const result = modules.get(native.module)[native.handler](createNativeContext(browserState, native.states, commitDom, native.scope), event)
+          if (result && typeof result.then === "function") result.catch(error => console.error(error))
+        } catch (error) {
+          console.error(error)
+        }
+      }
+      node.addEventListener(eventName, listener)
+      listeners.set(eventName, listener)
+      registrations.set(node, listeners)
+    }
   }
-  return targets
 }
 
-async function dispatchNative(event, targets, modules) {
-  for (const { target, native } of targets) {
-    let modulePromise = modules.get(native.module)
-    if (!modulePromise) {
-      modulePromise = import(native.module)
-      modules.set(native.module, modulePromise)
-    }
-    try {
-      const module = await modulePromise
-      const result = module[native.handler](createNativeContext(browserState, native.states, commitDom, native.scope), delegatedEvent(event, target))
-      if (result && typeof result.then === "function") result.catch(error => console.error(error))
-    } catch (error) {
-      console.error(error)
-    }
+function unmountNative(root) {
+  for (const node of matching(root, "*")) {
+    for (const [eventName, listener] of registrations.get(node) ?? []) node.removeEventListener(eventName, listener)
+    registrations.delete(node)
   }
 }
 
-function delegatedEvent(event, currentTarget) {
-  return new Proxy(event, {
-    get(source, property) {
-      if (property === "currentTarget") return currentTarget
-      const value = Reflect.get(source, property, source)
-      return typeof value === "function" ? value.bind(source) : value
-    }
-  })
+function matching(root, selector) {
+  return [...(root.matches?.(selector) ? [root] : []), ...(root.querySelectorAll?.(selector) ?? [])]
 }
 
 function capitalize(value) {

package/framework/shared-runtime.js

@@ -55,7 +55,7 @@ export function unmountDom(root) {
 
 if (typeof document !== "undefined") {
   const initialState = document.body.dataset.kState
-  if (initialState) for (const [id, value] of JSON.parse(initialState)) browserState.set(id, value)
+  if (initialState) for (const [id, value, compact] of JSON.parse(initialState)) browserState.set(id, compact ? value[1].map(row => Object.fromEntries(value[0].map((field, index) => [field, row[index]]))) : value)
   mountText(document)
 
   const eventNames = ["click", "input", "change"]

package/package.json

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