@kudzujs/core 0.16.27 → 0.16.29

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.27](https://github.com/kudzujs/kudzu/releases/tag/v0.16.27).** Write reusable components, native event handlers, and pure collection expressions; Kudzu specializes supported source into static content and direct browser updates.
+**Current release: [0.16.29](https://github.com/kudzujs/kudzu/releases/tag/v0.16.29).** Write reusable components, native event handlers, and pure collection expressions; Kudzu specializes supported source into static content and direct browser updates, excluding unused style and conditional capabilities.
 
 - [Documentation](https://kudzujs.cloud/docs)
 - [Installation guide](https://kudzujs.cloud/docs#install)
@@ -138,6 +138,13 @@ interactions, labels, status updates, keyboard focus, and responsive layouts in
 browser as needed. Binding comments and inert templates mean raw HTML string
 matches or tag stripping are not reliable checks of rendered text.
 
+Normal builds also scan generated route HTML after `afterBuild`, reporting counts
+with/without script or modulepreload text markers and unreadable files, with up to
+five paths per category (long paths are truncated). This is a literal text scan,
+not proof of script freedom: comments and inert content can match, inline event
+attributes are not checked, and extra public HTML files are outside the route
+inventory. Quiet and JSON builds omit this summary.
+
 Keep checks bounded and report concise counts and failing paths rather than
 repeatedly dumping minified artifacts. A missing tool or truncated response is
 not a pass. After source changes, rerun affected checks. Optional compiler/artifact

package/framework/binding-runtime.js

@@ -4,11 +4,11 @@ import { serializeStyle } from "./style.js"
 
 const imports = new Map()
 const bindingTargets = new Map()
-const conditionTargets = new Map()
+const conditionTargets = globalThis.__KUDZU_CONDITIONS__ && new Map()
 const mountedBindings = new WeakSet()
-const mountedConditions = new WeakSet()
+const mountedConditions = globalThis.__KUDZU_CONDITIONS__ && new WeakSet()
 const bindingRegistrations = new WeakMap()
-const conditionRegistrations = new WeakMap()
+const conditionRegistrations = globalThis.__KUDZU_CONDITIONS__ && new WeakMap()
 const textDescriptors = globalThis.__KUDZU_TEXT_BINDINGS__ && typeof document !== "undefined" ? JSON.parse(document.body.dataset.kTextBindings ?? "[]") : []
 const bindingTypes = ["class", "disabled", "value", "checked", "style"]
 const bindingSelector = [...bindingTypes.map(target => `[data-k-bind-${target}]`), "[data-k-bind-attrs]"].join(",")
@@ -47,6 +47,7 @@ function commitBindings(id) {
       else patchBinding(binding.node, binding.target, binding.read())
     }
   }
+  if (!globalThis.__KUDZU_CONDITIONS__) return
   const conditions = conditionTargets.get(id)
   if (!conditions) return
   for (const condition of conditions) {
@@ -57,9 +58,9 @@ function commitBindings(id) {
 
 registerCommitter(commitBindings)
 registerMountHook(mountBindings, "bindings")
-registerMountHook(mountConditions, "conditions")
+if (globalThis.__KUDZU_CONDITIONS__) registerMountHook(mountConditions, "conditions")
 registerUnmountHook(unmountBindings, "bindings")
-registerUnmountHook(unmountConditions, "conditions")
+if (globalThis.__KUDZU_CONDITIONS__) registerUnmountHook(unmountConditions, "conditions")
 registerStateReleaseHook(releaseBindings)
 
 if (typeof document !== "undefined") mountDom(document)
@@ -206,6 +207,7 @@ function releaseBindings(id) {
     bindingRegistrations.delete(binding.node)
   }
   bindingTargets.delete(id)
+  if (!globalThis.__KUDZU_CONDITIONS__) return
   for (const condition of conditionTargets.get(id) ?? []) {
     const registration = conditionRegistrations.get(condition.start)
     for (const [conditionId, entry] of registration?.registrations ?? []) conditionTargets.get(conditionId)?.delete(entry)

package/framework/build.mjs

@@ -59,13 +59,14 @@ export async function buildWithSession(project, { changedFiles, quiet = false, m
   try {
     await recoverOutput(outputDirectory, backupOutput)
     await rm(stagedOutput, { recursive: true, force: true })
-    const { result, pageCount, behaviorCount, cache, inspectionData, explanation } = await buildInto(project, stagedOutput, { changedFiles, minify, quiet, retainCache, explanationRoute })
+    const { result, pageCount, behaviorCount, cache, inspectionData, explanation, htmlSummary } = await buildInto(project, stagedOutput, { changedFiles, minify, quiet, retainCache, explanationRoute })
     const promoteStarted = project.timings ? performance.now() : 0
     await promoteOutput(stagedOutput, outputDirectory, backupOutput)
     addTiming(project.timings, "writeMs", promoteStarted)
     project.buildCache = retainCache ? cache : undefined
     if (!quiet) {
       console.log(`Built ${pageCount} page(s), ${behaviorCount} interactive page(s) into dist/`)
+      console.log(htmlSummary)
       console.log("Browser behavior and accessibility need verification: https://kudzujs.cloud/docs#build")
     }
     return explanationRoute ? explanation : inspection ? createInspectionReport(inspectionData) : result
@@ -460,7 +461,7 @@ async function buildInto(project, outputDirectory, { changedFiles, minify, quiet
       const generated = generateEffectRuntime(await readFile(new URL("./effect-runtime.js", import.meta.url), "utf8"), capabilityIR)
       await writeBundledJavaScript(join(familyDirectory, "kudzu-effect.js"), generated.source, minify, generated.define)
     }
-    if (bindings.count || lists.styleCount) await writeJavaScript(join(familyDirectory, "kudzu-style.js"), await readFile(new URL("./style.js", import.meta.url), "utf8"), minify)
+    if (bindings.style || lists.styleCount) await writeJavaScript(join(familyDirectory, "kudzu-style.js"), await readFile(new URL("./style.js", import.meta.url), "utf8"), minify)
     if (bindings.count) {
       const generated = generateBindingRuntime(await readFile(new URL("./binding-runtime.js", import.meta.url), "utf8"), capabilityIR, family.navigation)
       await writeBundledJavaScript(join(familyDirectory, "kudzu-binding.js"), generated.source, minify, generated.define)
@@ -553,6 +554,34 @@ async function buildInto(project, outputDirectory, { changedFiles, minify, quiet
     if (typeof config.afterBuild !== "function") throw new Error("kudzu.config afterBuild must be a function")
     await config.afterBuild({ root, outDir: outputDirectory, sourceDir: sourceDirectory, base, routes: plans.map(plan => plan.route), plans, rewrites: sortedRewrites, artifacts })
   }
+  let htmlSummary
+  if (!quiet) {
+    const counts = { "With markers": 0, Unreadable: 0 }
+    const samples = { "With markers": [], Unreadable: [] }
+    // Scan final route files, not compiler closure metadata or a previous build's scratch report.
+    const outputs = routeRecords.map(record => record.output).sort()
+    for (let offset = 0; offset < outputs.length; offset += 64) {
+      const batch = outputs.slice(offset, offset + 64)
+      const categories = await Promise.all(batch.map(async output => {
+        try {
+          const html = await readFile(join(outputDirectory, output, "index.html"), "utf8")
+          if (/<script(?=[\s/>])|<link(?=[\s/>])[^>]*\bmodulepreload\b/i.test(html)) return "With markers"
+        } catch {
+          return "Unreadable"
+        }
+      }))
+      for (const [index, category] of categories.entries()) {
+        if (!category) continue
+        counts[category]++
+        if (samples[category].length < 5) {
+          const path = join("dist", batch[index], "index.html").replaceAll(sep, "/")
+          samples[category].push(JSON.stringify(path.length > 240 ? `${path.slice(0, 240)}...` : path))
+        }
+      }
+    }
+    htmlSummary = `Route HTML scan: ${routeRecords.length - counts["With markers"] - counts.Unreadable} without script/modulepreload text markers, ${counts["With markers"]} with markers, ${counts.Unreadable} unreadable.`
+    for (const category of Object.keys(counts)) if (counts[category]) htmlSummary += `\n  ${category}: ${samples[category].join(", ")}${counts[category] > 5 ? ` (+${counts[category] - 5} more)` : ""}`
+  }
   addTiming(project.timings, "writeMs", writeStarted)
 
   let explanation
@@ -570,6 +599,7 @@ async function buildInto(project, outputDirectory, { changedFiles, minify, quiet
     result: { sourceResults, incremental },
     inspectionData: { sourceFiles: sourceFiles.map(file => relative(root, file).replaceAll(sep, "/")), sourceResults, compatibility, artifacts },
     explanation,
+    htmlSummary,
     pageCount: routeRecords.length,
     behaviorCount,
     cache: { pageRenders, pageSources, placeholders, sourceResults: sourceResultsByFile }

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

@@ -13,7 +13,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, svgConditions: false }
+  const bindings = { count: 0, text: false, style: false, conditions: false, svgConditions: false }
   const lists = {
     count: 0,
     styleCount: 0,
@@ -50,6 +50,8 @@ export function planRouteCapabilities(records, { navigationRouteCount = 0 } = {}
       if (event.native) nativeEvents.add(event.event)
     }
     bindings.text ||= plan.bindings.some(binding => binding.target === "text")
+    bindings.style ||= plan.bindings.some(binding => binding.target === "style")
+    bindings.conditions ||= plan.conditions.length > 0
     bindings.svgConditions ||= plan.conditions.some(condition => condition.svg)
     effects.any ||= plan.effects.length > 0
     effects.derivedDependencies ||= plan.effects.some(effect => effect.dependencyExpressions?.length)
@@ -118,7 +120,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", "svgConditions"].every(name => typeof capabilityIR.bindings[name] === "boolean")) throw new Error("Invalid CapabilityIR v1 bindings")
+  if (!isCount(capabilityIR.bindings.count) || !["text", "style", "conditions", "svgConditions"].every(name => typeof capabilityIR.bindings[name] === "boolean")) throw new Error("Invalid CapabilityIR v1 bindings")
   const listFlags = ["conditions", "svg", "deepConditions", "textRanges", "attributes", "events", "expressions", "expressionAttributes", "seeds", "effects", "rowHooks", "rowRefs", "complexRowState", "nested", "selectors", "calculated", "static", "indexes", "stableFastPaths", "generalRowHooks", "asyncParts", "mounts"]
   if (!isCount(capabilityIR.lists.count) || !isCount(capabilityIR.lists.styleCount) || !listFlags.every(name => typeof capabilityIR.lists[name] === "boolean")) throw new Error("Invalid CapabilityIR v1 lists")
   if (!["any", "derivedDependencies", "itemDependencies", "captures", "navigable", "navigableOwners"].every(name => typeof capabilityIR.effects[name] === "boolean") || !["nestedState", "setter"].every(name => typeof capabilityIR.captures[name] === "boolean") || !["shared", "dependency"].every(name => typeof capabilityIR.runtime[name] === "boolean")) throw new Error("Invalid CapabilityIR v1 effect, capture, or runtime flags")

package/framework/compiler/runtime-codegen.mjs

@@ -29,12 +29,18 @@ export function generateBindingRuntime(source, capabilityIR, navigable) {
   assertCapabilityIR(capabilityIR)
   let runtime = replaceRequired(source, '"./shared-runtime.js"', '"./kudzu.js"', "shared runtime import", "binding-runtime.js")
   runtime = replaceRequired(runtime, '"./serialization.js"', '"./kudzu-serialization.js"', "serialization import", "binding-runtime.js")
-  runtime = replaceRequired(runtime, '"./style.js"', '"./kudzu-style.js"', "style import", "binding-runtime.js")
+  runtime = capabilityIR.bindings.style
+    ? replaceRequired(runtime, '"./style.js"', '"./kudzu-style.js"', "style import", "binding-runtime.js")
+    : replaceSequenceRequired(runtime, [
+      ['import { serializeStyle } from "./style.js"\n', "", "unused style import"],
+      ['  } else if (target === "style") {\n    const style = serializeStyle(value)\n    if (style) node.setAttribute("style", style)\n    else node.removeAttribute("style")\n', "", "unused style branch"]
+    ], "binding-runtime.js")
   if (navigable) runtime = specializeNavigationTextDescriptors(runtime)
   return {
     source: runtime,
     define: {
       "globalThis.__KUDZU_TEXT_BINDINGS__": String(capabilityIR.bindings.text),
+      "globalThis.__KUDZU_CONDITIONS__": String(capabilityIR.bindings.conditions),
       "globalThis.__KUDZU_SVG_CONDITIONS__": String(capabilityIR.bindings.svgConditions),
       "globalThis.__KUDZU_CAPTURE_STATE__": String(capabilityIR.captures.nestedState)
     }

package/package.json

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