@kudzujs/core 0.16.40 → 0.16.43

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.36](https://github.com/kudzujs/kudzu/releases/tag/v0.16.36).** The optional `create-kudzu --ai` check tool now respects managed process-group cancellation while retaining its own timeout, failure reporting and full logs. Compiler/runtime behavior is unchanged; AI-token savings are unmeasured and the AI-cost/1.0 gates remain blocked.
+**Current release: [0.16.43](https://github.com/kudzujs/kudzu/releases/tag/v0.16.43).** This forward release carries 0.16.42's source-graph and opt-in AI-check improvements through a publication workflow that retains required Chrome in exact-commit CI. No reliable AI-token saving is established; the AI-cost/1.0 gates remain blocked.
 
 - [Documentation](https://kudzujs.cloud/docs)
 - [Installation guide](https://kudzujs.cloud/docs#install)
@@ -40,7 +40,7 @@ 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.
+stay outside default browser output. No reliable AI-cost saving has been established.
 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:

package/framework/compiler/effect-private-ref-pass.mjs

@@ -73,7 +73,7 @@ export function normalizeEffectPrivateRefs(sourceFile, factory, context) {
       if (frameAssignments.length && !topLevelConst) throw sourceNodeError(node, sourceFile, "Animation frame refs must be one top-level component const")
       if (attachedToJsx && mutations.length) throw sourceNodeError(mutations[0], sourceFile, "JSX object refs may not assign to ref.current")
       const renderWrite = mutations.find(access => nearestFunction(access) === owner)
-      if (renderWrite) throw sourceNodeError(renderWrite, sourceFile, "Mutable refs cannot be assigned during render; use component state for values retained across effect replacements, or an effect-private ref with cleanup for invocation-local values")
+      if (renderWrite) throw sourceNodeError(renderWrite, sourceFile, "Mutable refs cannot be assigned during render; use component state for values retained across effect replacements, or an effect-private ref with cleanup for invocation-local values; for one effect, use an effect-local variable and return resource cleanup")
       if (!topLevelConst || invalidReference || !accesses.length) return
       const effectCalls = owner.body.statements.flatMap(statement => hasUseEffectImport && ts.isExpressionStatement(statement) && ts.isCallExpression(statement.expression) && ts.isIdentifier(statement.expression.expression) && statement.expression.expression.text === "useEffect" && !isShadowedIdentifier(statement.expression.expression, sourceFile) ? [statement.expression] : [])
       const effects = effectCalls.filter(effect => {
@@ -118,7 +118,7 @@ export function normalizeEffectPrivateRefs(sourceFile, factory, context) {
         if (callback && (ts.isArrowFunction(callback) || ts.isFunctionExpression(callback)) && ts.isBlock(callback.body)) {
           const cleanups = effectReturns(callback).cleanups
           const cleanupWrites = cleanups.length === 1 && accesses.some(access => isNodeWithin(access, cleanups[0]) && ts.isBinaryExpression(access.parent) && unwrapExpression(access.parent.left) === access && access.parent.operatorToken.kind >= ts.SyntaxKind.FirstAssignment && access.parent.operatorToken.kind <= ts.SyntaxKind.LastAssignment)
-          if (!cleanupWrites) throw sourceNodeError(node, sourceFile, "Effect-private refs require one cleanup that directly resets or invalidates ref.current")
+          if (!cleanupWrites) throw sourceNodeError(node, sourceFile, "Effect-private refs require one cleanup that directly resets or invalidates ref.current; for one effect, use an effect-local variable and return resource cleanup")
           registerPrivateRef(node, callback)
         }
         return

package/framework/compiler/source-graph.mjs

@@ -18,12 +18,12 @@ export function createSourceGraph(root) {
 
   const ordinaryRuntimeDependencies = (file, sourceFile, sourceFiles, isStaticImport) => {
     const dependencies = []
-    const bindingIndex = createBindingIndex(sourceFile)
+    let bindingIndex
     const rejectDynamicImports = node => {
       if (ts.isCallExpression(node) && node.expression.kind === ts.SyntaxKind.ImportKeyword) {
         const argument = node.arguments[0]
         const specifier = node.arguments.length === 1 && ts.isStringLiteralLike(argument) ? JSON.stringify(argument.text) : argument?.getText(sourceFile) ?? "<missing>"
-        if (ownedLazyPackageImport(node, bindingIndex)) return
+        if (ownedLazyPackageImport(node, bindingIndex ??= createBindingIndex(sourceFile))) return
         throw sourceNodeError(node, sourceFile, `Dynamic import ${specifier} is not supported in ordinary source modules`, {
           code: "source.dynamic-import.unsupported",
           stage: "graph",

package/package.json

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