@kudzujs/core 0.16.33 → 0.16.35

package/README.md

@@ -14,7 +14,7 @@ Kudzu compiles ordinary React-shaped TypeScript and TSX into complete static HTM
 
 > Experimental `0.16.x`: the compiler API and supported TSX surface may change.
 
-**Current release: [0.16.33](https://github.com/kudzujs/kudzu/releases/tag/v0.16.33).** Write reusable components, native event handlers, and pure collection expressions; Kudzu specializes supported source into static content and direct browser updates. Presentation-only conditional branches omit descendant lifecycle traversal when no owner in their runtime family needs it, removing a further 215 raw / 116 aggregate gzip JavaScript bytes from search. Stateful remounts and effect cleanup are preserved; measured search-transition medians remain approximately equal. AI-cost and 1.0 gates remain blocked.
+**Current release: [0.16.35](https://github.com/kudzujs/kudzu/releases/tag/v0.16.35).** Flat evaluator families omit nested context preparation and recursive dependency collection, removing another 172 raw / 50 aggregate gzip JavaScript bytes from search. Nested component-prop evaluators retain current-state reads. The optional `create-kudzu --ai` authoring tools introduced in 0.16.34 remain available; AI-token savings are unmeasured and the AI-cost/1.0 gates remain blocked.
 
 - [Documentation](https://kudzujs.cloud/docs)
 - [Installation guide](https://kudzujs.cloud/docs#install)
@@ -36,6 +36,13 @@ npm run dev
 
 The generated project includes reusable components, an interactive state example, a zero-JavaScript static route, metadata, and responsive CSS.
 
+For optional AI authoring guidance and local developer tools, use
+`npm create kudzu@latest my-app -- --ai`. The generated `AGENTS.md` describes
+`npm run ai -- docs` for installed documentation and `npm run ai -- check` for
+typecheck/build execution with bounded output and full retained logs. These tools
+stay outside default browser output. AI-token savings have not been measured.
+See the [generator guide](https://github.com/kudzujs/kudzu/tree/main/packages/create-kudzu#optional-ai-authoring-guidance).
+
 To add Kudzu to an existing project:
 
 ```bash

package/framework/binding-runtime.js

@@ -286,14 +286,14 @@ export async function loadEvaluator(descriptor) {
 
 async function createBindingContext(descriptor) {
   const scope = Object.fromEntries(Object.entries(descriptor.scope).map(([name, value]) => [name, deserialize(value, id => browserState.get(id))]))
-  const nested = {}
-  await Promise.all(Object.entries(descriptor.scopeBindings).map(async ([name, binding]) => {
+  const nested = globalThis.__KUDZU_NESTED_EVALUATORS__ !== false && {}
+  if (globalThis.__KUDZU_NESTED_EVALUATORS__ !== false) await Promise.all(Object.entries(descriptor.scopeBindings).map(async ([name, binding]) => {
     const evaluator = await loadEvaluator(binding)
     nested[name] = evaluator.read
   }))
   return {
     get: name => browserState.get(descriptor.states[name]),
-    scope: name => name in descriptor.scopeStates ? browserState.get(descriptor.scopeStates[name]) : name in nested ? nested[name]() : scope[name]
+    scope: name => name in descriptor.scopeStates ? browserState.get(descriptor.scopeStates[name]) : globalThis.__KUDZU_NESTED_EVALUATORS__ !== false && name in nested ? nested[name]() : scope[name]
   }
 }
 
@@ -302,7 +302,7 @@ function bindingStateIds(descriptor) {
     ...Object.values(descriptor.states),
     ...Object.values(descriptor.scopeStates),
     ...(globalThis.__KUDZU_CAPTURE_STATE__ ? Object.values(descriptor.scope).flatMap(serializedStateIds) : []),
-    ...Object.values(descriptor.scopeBindings).flatMap(binding => [...bindingStateIds(binding)])
+    ...(globalThis.__KUDZU_NESTED_EVALUATORS__ !== false ? Object.values(descriptor.scopeBindings).flatMap(binding => [...bindingStateIds(binding)]) : [])
   ])
 }
 

package/framework/compiler/route-capability-planner.mjs

@@ -15,7 +15,7 @@ export function planRouteCapabilities(records, { navigationRouteCount = 0 } = {}
   for (const plan of plans) assertRouteIR(plan, { concrete: true })
   const commandEvents = new Set()
   const nativeEvents = new Set()
-  const bindings = { count: 0, text: false, style: false, conditions: false, conditionState: false, conditionMounts: false, svgConditions: false }
+  const bindings = { count: 0, text: false, style: false, conditions: false, conditionState: false, conditionMounts: false, svgConditions: false, nestedEvaluators: false }
   const lists = {
     count: 0,
     styleCount: 0,
@@ -57,6 +57,7 @@ export function planRouteCapabilities(records, { navigationRouteCount = 0 } = {}
     bindings.conditionState ||= plan.conditions.some(condition => Object.values(condition.owned ?? {}).some(states => states.length > 0))
     bindings.conditionMounts ||= plan.conditions.some(condition => condition.mount)
     bindings.svgConditions ||= plan.conditions.some(condition => condition.svg)
+    bindings.nestedEvaluators ||= [...plan.bindings, ...plan.conditions, ...plan.lists.map(list => list.source)].some(descriptor => Object.keys(descriptor?.scopeBindings ?? {}).length > 0)
     effects.any ||= plan.effects.length > 0
     effects.derivedDependencies ||= plan.effects.some(effect => effect.dependencyExpressions?.length)
     effects.itemDependencies ||= plan.effects.some(effect => effect.itemDependencies?.length)
@@ -127,7 +128,7 @@ export function assertCapabilityIR(capabilityIR, records, options = {}) {
   if (!sections.every(name => isRecord(capabilityIR[name]))) throw new Error("Invalid CapabilityIR v1 structure")
   if (!["behaviors", "regularBehaviors", "regularStateSeeds", "dependencyStateSeeds"].every(name => isCount(capabilityIR.routes[name]))) throw new Error("Invalid CapabilityIR v1 route counts")
   if (!["command", "native"].every(name => Array.isArray(capabilityIR.events[name]) && capabilityIR.events[name].every(event => typeof event === "string")) || typeof capabilityIR.events.hasNativeHandlers !== "boolean") throw new Error("Invalid CapabilityIR v1 events")
-  if (!isCount(capabilityIR.bindings.count) || !["text", "style", "conditions", "conditionState", "conditionMounts", "svgConditions", "attributes"].every(name => typeof capabilityIR.bindings[name] === "boolean")) throw new Error("Invalid CapabilityIR v1 bindings")
+  if (!isCount(capabilityIR.bindings.count) || !["text", "style", "conditions", "conditionState", "conditionMounts", "svgConditions", "nestedEvaluators", "attributes"].every(name => typeof capabilityIR.bindings[name] === "boolean")) throw new Error("Invalid CapabilityIR v1 bindings")
   if (capabilityIR.bindings.conditionState && !capabilityIR.bindings.conditions) throw new Error("CapabilityIR conditional state requires conditions")
   if (capabilityIR.bindings.conditionMounts && !capabilityIR.bindings.conditions) throw new Error("CapabilityIR conditional mounts require conditions")
   if (!Array.isArray(capabilityIR.bindings.properties) || capabilityIR.bindings.properties.some(target => !propertyBindings.includes(target)) || new Set(capabilityIR.bindings.properties).size !== capabilityIR.bindings.properties.length) throw new Error("Invalid CapabilityIR v1 binding properties")

package/framework/compiler/runtime-codegen.mjs

@@ -57,6 +57,7 @@ export function generateBindingRuntime(source, capabilityIR, navigable) {
       "globalThis.__KUDZU_CONDITION_STATE__": String(capabilityIR.bindings.conditionState),
       "globalThis.__KUDZU_CONDITION_MOUNTS__": String(capabilityIR.bindings.conditionMounts),
       "globalThis.__KUDZU_SVG_CONDITIONS__": String(capabilityIR.bindings.svgConditions),
+      "globalThis.__KUDZU_NESTED_EVALUATORS__": String(capabilityIR.bindings.nestedEvaluators),
       "globalThis.__KUDZU_CAPTURE_STATE__": String(capabilityIR.captures.nestedState)
     }
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kudzujs/core",
-  "version": "0.16.33",
+  "version": "0.16.35",
   "description": "HTML-first TSX framework with synchronous state semantics and no virtual DOM",
   "type": "module",
   "license": "MIT",
@@ -50,7 +50,7 @@
     "check": "tsc --noEmit && tsc -p test/fixtures/tsconfig.json --noEmit && node ./bin/kudzu.mjs build",
     "test": "node --test test/project-application.test.mjs && node --test --test-skip-pattern='^establishes the 0\\.17\\.0 notification WebSocket ownership contract$' test/*.test.mjs",
     "test:endurance": "node test/endurance.mjs",
-    "test:package": "node test/package-smoke.mjs",
+    "test:package": "node test/package-smoke.mjs && node test/create-kudzu-smoke.mjs",
     "benchmark": "node test/performance.mjs",
     "benchmark:keyed": "node test/keyed-performance.mjs",
     "benchmark:commerce": "node test/commerce-build-performance.mjs",