@kudzujs/core 0.16.27 → 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.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.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)
@@ -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/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
@@ -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/package.json

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