@kudzujs/core 0.16.43 → 0.16.45

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.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.
+**Current release: [0.16.45](https://github.com/kudzujs/kudzu/releases/tag/v0.16.45).** Unsupported non-null refs in named components now receive an authored-source diagnostic without hiding keyed-row or setter-child diagnostics. Accepted WebSocket output remains unchanged. 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)

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

@@ -80,6 +80,11 @@ export function normalizeEffectPrivateRefs(sourceFile, factory, context) {
         const callback = effect.arguments[0]
         return callback && accesses.every(access => isNodeWithin(access, callback))
       })
+      const effectCallbacks = effectCalls.map(effect => effect.arguments[0]).filter(Boolean)
+      const outsideEffect = accesses.find(access => !effectCallbacks.some(callback => isNodeWithin(access, callback)))
+      if (!attachedToJsx && outsideEffect && mutations.some(access => effectCallbacks.some(callback => isNodeWithin(access, callback)))) {
+        throw sourceNodeError(outsideEffect, sourceFile, "Effect-owned mutable refs cannot be used outside their owning effect; use a state-driven effect and keep resource callbacks effect-local")
+      }
       if (!frameAssignments.length && refInitializer?.kind === ts.SyntaxKind.NullKeyword && !invalidReference && !effects.length) {
         const owners = effectCalls.filter(effect => {
           const callback = effect.arguments[0]

package/framework/compiler/source-compiler.mjs

@@ -911,7 +911,8 @@ function createKudzuTransformer({ semantic, handlerUrl, file, sourceFiles, sourc
         const owner = nearestFunction(node)
         if (owner && node.initializer.expression.text === "useRef") {
           const nullInitializer = node.initializer.arguments.length === 1 && node.initializer.arguments[0].kind === ts.SyntaxKind.NullKeyword
-          if (!nullInitializer && owner.modifiers?.some(modifier => modifier.kind === ts.SyntaxKind.DefaultKeyword)) throw sourceNodeError(node.initializer, sourceFile, "Mutable useRef() values must be referenced exclusively inside one owned effect; DOM refs require useRef(null)")
+          const attachedToJsx = !nullInitializer && referenceIdentifiers(owner.body, node.name.text).some(reference => ts.isJsxExpression(reference.parent) && ts.isJsxAttribute(reference.parent.parent) && reference.parent.parent.name.text === "ref")
+          if (!nullInitializer && !attachedToJsx && (owner.parent === sourceFile || ts.isVariableDeclaration(owner.parent) && owner.parent.parent?.parent?.parent === sourceFile)) throw sourceNodeError(node.initializer, sourceFile, "Mutable useRef() values must be referenced exclusively inside one owned effect; DOM refs require useRef(null)")
           if (nullInitializer) {
             ensureOwner(owner)
             componentAnalysis.registerRef(owner, { name: node.name.text, site: analysisSite(node, "hook"), source: analysisSource(node) })

package/package.json

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