@kudzujs/core 0.16.26 → 0.16.28

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.26](https://github.com/kudzujs/kudzu/releases/tag/v0.16.26).** 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.28](https://github.com/kudzujs/kudzu/releases/tag/v0.16.28).** Write reusable components, native event handlers, and pure collection expressions; Kudzu specializes supported source into static content and direct browser updates.
 
 - [Documentation](https://kudzujs.cloud/docs)
 - [Installation guide](https://kudzujs.cloud/docs#install)
@@ -130,6 +130,26 @@ A static sibling outside an enhanced-navigation group ships no JavaScript merely
 because another page is interactive. Shared layout effects or explicit navigation
 groups have their own lifetime; native anchors remain the default.
 
+## Verify
+
+A successful build validates supported source and emits deployable outputs; it
+does not verify browser behavior or accessibility. Check visible DOM and relevant
+interactions, labels, status updates, keyboard focus, and responsive layouts in a
+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
+reports and their limits are documented under [Build output](https://kudzujs.cloud/docs#build).
+
 ## How It Works
 
 ```text

package/framework/build.mjs

@@ -59,12 +59,16 @@ 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/`)
+    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
   } catch (error) {
     const normalized = normalizeDiagnosticError(error, root)
@@ -550,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
@@ -567,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/package.json

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