release: WRNexusJS 0.2.47

.publish/ai/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wrnexus/ai",
-  "version": "0.2.39",
+  "version": "0.2.47",
   "type": "module",
   "description": "Zero-dependency Claude (Anthropic) client for WrNexus apps.",
   "license": "MIT",

.publish/authz/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wrnexus/authz",
-  "version": "0.2.39",
+  "version": "0.2.47",
   "type": "module",
   "description": "@wrnexus/authz — part of the WrNexus framework.",
   "license": "MIT",

.publish/cli/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wrnexus/cli",
-  "version": "0.2.39",
+  "version": "0.2.47",
   "type": "module",
   "description": "@wrnexus/cli — part of the WrNexus framework.",
   "license": "MIT",
@@ -28,16 +28,16 @@
     "wrnexus": "./dist/index.js"
   },
   "dependencies": {
-    "@wrnexus/core": "^0.2.39",
+    "@wrnexus/core": "^0.2.47",
-    "@wrnexus/router": "^0.2.39",
+    "@wrnexus/router": "^0.2.47",
-    "@wrnexus/csr": "^0.2.39",
+    "@wrnexus/csr": "^0.2.47",
-    "@wrnexus/compiler": "^0.2.39",
+    "@wrnexus/compiler": "^0.2.47",
-    "@wrnexus/styles": "^0.2.39",
+    "@wrnexus/styles": "^0.2.47",
-    "@wrnexus/dev-server": "^0.2.39",
+    "@wrnexus/dev-server": "^0.2.47",
-    "@wrnexus/ui": "^0.2.39",
+    "@wrnexus/ui": "^0.2.47",
-    "@wrnexus/validation": "^0.2.39",
+    "@wrnexus/validation": "^0.2.47",
-    "@wrnexus/i18n": "^0.2.39",
+    "@wrnexus/i18n": "^0.2.47",
-    "@wrnexus/db": "^0.2.39"
+    "@wrnexus/db": "^0.2.47"
   },
   "files": [
     "dist"

.publish/compiler/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wrnexus/compiler",
-  "version": "0.2.39",
+  "version": "0.2.47",
   "type": "module",
   "description": "@wrnexus/compiler — part of the WrNexus framework.",
   "license": "MIT",

.publish/core/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wrnexus/core",
-  "version": "0.2.39",
+  "version": "0.2.47",
   "type": "module",
   "description": "@wrnexus/core — part of the WrNexus framework.",
   "license": "MIT",

.publish/csr/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wrnexus/csr",
-  "version": "0.2.39",
+  "version": "0.2.47",
   "type": "module",
   "description": "@wrnexus/csr — part of the WrNexus framework.",
   "license": "MIT",
@@ -21,7 +21,7 @@
     }
   },
   "dependencies": {
-    "@wrnexus/core": "^0.2.39"
+    "@wrnexus/core": "^0.2.47"
   },
   "files": [
     "dist"

.publish/db/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wrnexus/db",
-  "version": "0.2.39",
+  "version": "0.2.47",
   "type": "module",
   "description": "@wrnexus/db — part of the WrNexus framework.",
   "license": "MIT",

.publish/dev-server/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wrnexus/dev-server",
-  "version": "0.2.39",
+  "version": "0.2.47",
   "type": "module",
   "description": "@wrnexus/dev-server — part of the WrNexus framework.",
   "license": "MIT",
@@ -25,18 +25,18 @@
     }
   },
   "dependencies": {
-    "@wrnexus/core": "^0.2.39",
+    "@wrnexus/core": "^0.2.47",
-    "@wrnexus/router": "^0.2.39",
+    "@wrnexus/router": "^0.2.47",
-    "@wrnexus/ssr": "^0.2.39",
+    "@wrnexus/ssr": "^0.2.47",
-    "@wrnexus/csr": "^0.2.39",
+    "@wrnexus/csr": "^0.2.47",
-    "@wrnexus/compiler": "^0.2.39",
+    "@wrnexus/compiler": "^0.2.47",
-    "@wrnexus/styles": "^0.2.39",
+    "@wrnexus/styles": "^0.2.47",
-    "@wrnexus/ui": "^0.2.39",
+    "@wrnexus/ui": "^0.2.47",
-    "@wrnexus/validation": "^0.2.39",
+    "@wrnexus/validation": "^0.2.47",
-    "@wrnexus/i18n": "^0.2.39",
+    "@wrnexus/i18n": "^0.2.47",
-    "@wrnexus/db": "^0.2.39",
+    "@wrnexus/db": "^0.2.47",
-    "@wrnexus/pubsub": "^0.2.39",
+    "@wrnexus/pubsub": "^0.2.47",
-    "@wrnexus/uploader": "^0.2.39"
+    "@wrnexus/uploader": "^0.2.47"
   },
   "files": [
     "dist"

.publish/encryption/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wrnexus/encryption",
-  "version": "0.2.39",
+  "version": "0.2.47",
   "type": "module",
   "description": "@wrnexus/encryption — part of the WrNexus framework.",
   "license": "MIT",

.publish/helpers/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wrnexus/helpers",
-  "version": "0.2.39",
+  "version": "0.2.47",
   "type": "module",
   "description": "Safe convenience helpers for WrNexus request contexts and common application flows.",
   "license": "MIT",
@@ -21,7 +21,7 @@
     }
   },
   "dependencies": {
-    "@wrnexus/core": "^0.2.39"
+    "@wrnexus/core": "^0.2.47"
   },
   "files": [
     "dist"

.publish/i18n/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wrnexus/i18n",
-  "version": "0.2.39",
+  "version": "0.2.47",
   "type": "module",
   "description": "@wrnexus/i18n — part of the WrNexus framework.",
   "license": "MIT",
@@ -21,7 +21,7 @@
     }
   },
   "dependencies": {
-    "@wrnexus/core": "^0.2.39"
+    "@wrnexus/core": "^0.2.47"
   },
   "files": [
     "dist"

.publish/jwt/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wrnexus/jwt",
-  "version": "0.2.39",
+  "version": "0.2.47",
   "type": "module",
   "description": "@wrnexus/jwt — part of the WrNexus framework.",
   "license": "MIT",

.publish/mobile/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wrnexus/mobile",
-  "version": "0.2.39",
+  "version": "0.2.47",
   "type": "module",
   "description": "@wrnexus/mobile — part of the WrNexus framework.",
   "license": "MIT",
@@ -21,7 +21,7 @@
     }
   },
   "dependencies": {
-    "@wrnexus/native": "^0.2.39"
+    "@wrnexus/native": "^0.2.47"
   },
   "files": [
     "dist"

.publish/native/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wrnexus/native",
-  "version": "0.2.39",
+  "version": "0.2.47",
   "type": "module",
   "description": "@wrnexus/native — part of the WrNexus framework.",
   "license": "MIT",

.publish/oauth/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wrnexus/oauth",
-  "version": "0.2.39",
+  "version": "0.2.47",
   "type": "module",
   "description": "@wrnexus/oauth — part of the WrNexus framework.",
   "license": "MIT",

.publish/pubsub/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wrnexus/pubsub",
-  "version": "0.2.39",
+  "version": "0.2.47",
   "type": "module",
   "description": "@wrnexus/pubsub — part of the WrNexus framework.",
   "license": "MIT",

.publish/queue/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wrnexus/queue",
-  "version": "0.2.39",
+  "version": "0.2.47",
   "type": "module",
   "description": "@wrnexus/queue — part of the WrNexus framework.",
   "license": "MIT",

.publish/reactive/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wrnexus/reactive",
-  "version": "0.2.39",
+  "version": "0.2.47",
   "type": "module",
   "description": "@wrnexus/reactive — part of the WrNexus framework.",
   "license": "MIT",

.publish/router/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wrnexus/router",
-  "version": "0.2.39",
+  "version": "0.2.47",
   "type": "module",
   "description": "@wrnexus/router — part of the WrNexus framework.",
   "license": "MIT",
@@ -21,8 +21,8 @@
     }
   },
   "dependencies": {
-    "@wrnexus/compiler": "^0.2.39",
+    "@wrnexus/compiler": "^0.2.47",
-    "@wrnexus/core": "^0.2.39"
+    "@wrnexus/core": "^0.2.47"
   },
   "files": [
     "dist"

.publish/ssr/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wrnexus/ssr",
-  "version": "0.2.39",
+  "version": "0.2.47",
   "type": "module",
   "description": "@wrnexus/ssr — part of the WrNexus framework.",
   "license": "MIT",
@@ -21,7 +21,7 @@
     }
   },
   "dependencies": {
-    "@wrnexus/core": "^0.2.39"
+    "@wrnexus/core": "^0.2.47"
   },
   "files": [
     "dist"

.publish/styles/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wrnexus/styles",
-  "version": "0.2.39",
+  "version": "0.2.47",
   "type": "module",
   "description": "@wrnexus/styles — part of the WrNexus framework.",
   "license": "MIT",
@@ -21,7 +21,7 @@
     }
   },
   "dependencies": {
-    "@wrnexus/uploader": "^0.2.39"
+    "@wrnexus/uploader": "^0.2.47"
   },
   "files": [
     "dist"

.publish/test/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wrnexus/test",
-  "version": "0.2.39",
+  "version": "0.2.47",
   "type": "module",
   "description": "@wrnexus/test — part of the WrNexus framework.",
   "license": "MIT",

.publish/tracking/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wrnexus/tracking",
-  "version": "0.2.39",
+  "version": "0.2.47",
   "type": "module",
   "description": "@wrnexus/tracking — part of the WrNexus framework.",
   "license": "MIT",

.publish/ui/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wrnexus/ui",
-  "version": "0.2.39",
+  "version": "0.2.47",
   "type": "module",
   "description": "@wrnexus/ui — part of the WrNexus framework.",
   "license": "MIT",
@@ -22,7 +22,7 @@
     "./ui.css": "./ui.css"
   },
   "dependencies": {
-    "@wrnexus/core": "^0.2.39"
+    "@wrnexus/core": "^0.2.47"
   },
   "files": [
     "dist",

.publish/uploader/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wrnexus/uploader",
-  "version": "0.2.39",
+  "version": "0.2.47",
   "type": "module",
   "description": "@wrnexus/uploader — part of the WrNexus framework.",
   "license": "MIT",
@@ -21,7 +21,7 @@
     }
   },
   "dependencies": {
-    "@wrnexus/core": "^0.2.39"
+    "@wrnexus/core": "^0.2.47"
   },
   "files": [
     "dist"

.publish/validation/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wrnexus/validation",
-  "version": "0.2.39",
+  "version": "0.2.47",
   "type": "module",
   "description": "@wrnexus/validation — part of the WrNexus framework.",
   "license": "MIT",

packages/ai/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wrnexus/ai",
-  "version": "0.2.39",
+  "version": "0.2.47",
   "private": true,
   "type": "module",
   "description": "Zero-dependency Claude (Anthropic) client for WrNexus apps.",

packages/authz/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wrnexus/authz",
-  "version": "0.2.39",
+  "version": "0.2.47",
   "private": true,
   "type": "module",
   "main": "src/index.ts",

packages/cli/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wrnexus/cli",
-  "version": "0.2.39",
+  "version": "0.2.47",
   "type": "module",
   "main": "src/index.ts",
   "exports": {

packages/cli/src/update.ts

@@ -429,6 +429,78 @@ const MIGRATIONS: Migration[] = [
       // No generated application files require automatic migration.
     },
   },
+  {
+    version: "0.2.40",
+    id: "conditions-bug",
+    description:
+      "Adds server-rendered component each/if blocks and fixes dynamic component rendering.",
+    apply() {
+      // No generated application files require automatic migration.
+    },
+  },
+  {
+    version: "0.2.41",
+    id: "conditions-bug",
+    description:
+      "Adds server-rendered component each/if blocks and fixes dynamic component rendering.",
+    apply() {
+      // No generated application files require automatic migration.
+    },
+  },
+  {
+    version: "0.2.42",
+    id: "conditions-bug",
+    description:
+      "Adds server-rendered component each/if blocks and fixes dynamic component rendering.",
+    apply() {
+      // No generated application files require automatic migration.
+    },
+  },
+  {
+    version: "0.2.43",
+    id: "conditions-bug",
+    description:
+      "Adds server-rendered component each/if blocks and fixes dynamic component rendering.",
+    apply() {
+      // No generated application files require automatic migration.
+    },
+  },
+  {
+    version: "0.2.44",
+    id: "conditions-bug",
+    description:
+      "Adds server-rendered component each/if blocks and fixes dynamic component rendering.",
+    apply() {
+      // No generated application files require automatic migration.
+    },
+  },
+  {
+    version: "0.2.45",
+    id: "conditions-bug",
+    description:
+      "Adds server-rendered component each/if blocks and fixes dynamic component rendering.",
+    apply() {
+      // No generated application files require automatic migration.
+    },
+  },
+  {
+    version: "0.2.46",
+    id: "conditions-bug",
+    description:
+      "Adds server-rendered component each/if blocks and fixes dynamic component rendering.",
+    apply() {
+      // No generated application files require automatic migration.
+    },
+  },
+  {
+    version: "0.2.47",
+    id: "conditions-bug",
+    description:
+      "Adds server-rendered component each/if blocks and fixes dynamic component rendering.",
+    apply() {
+      // No generated application files require automatic migration.
+    },
+  },
 ];
 
 /** Release tooling uses this to require an explicit migration entry per version. */

packages/compiler/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wrnexus/compiler",
-  "version": "0.2.39",
+  "version": "0.2.47",
   "type": "module",
   "main": "src/index.ts",
   "exports": {

packages/compiler/src/codegen.ts

@@ -524,7 +524,13 @@ function hasClientBehavior(nodes: ViewNode[]): boolean {
     // `{t:key}` is i18n sugar resolved server-side — not client reactivity.
     if (node.type === "text") return /\{(?!t:)[^{}]+\}/.test(node.value);
     // Server control blocks render on the server; they don't add client reactivity.
-    if (node.type === "each" || node.type === "if") return false;
+    if (node.type === "each") {
+      return hasClientBehavior(node.body) || hasClientBehavior(node.empty);
+    }
+
+    if (node.type === "if") {
+      return node.branches.some((branch) => hasClientBehavior(branch.body));
+    }
     return (
       node.attrs.some((attr) => attr.event || attr.name === "csrGet" || attr.name === "csrText") ||
       hasClientBehavior(node.children)
@@ -990,6 +996,20 @@ function viewHasEvents(nodes: ViewNode[]): boolean {
   });
 }
 
+function viewHasServerEach(nodes: ViewNode[]): boolean {
+  return nodes.some((node) => {
+    if (node.type === "text") return false;
+
+    if (node.type === "each") return true;
+
+    if (node.type === "if") {
+      return node.branches.some((branch) => viewHasServerEach(branch.body));
+    }
+
+    return viewHasServerEach(node.children);
+  });
+}
+
 /**
  * Compile a text node. Interpolations that reference state stay as client
  * mustaches (`{expr}`, hydrated by the reactive runtime); interpolations of
@@ -1096,6 +1116,18 @@ function renderComponentEachNode(node: EachNode, ctx: CompCtx): string {
   );
 }
 
+function serverLoopLocalsAttribute(ctx: CompCtx): string {
+  const locals = [...(ctx.serverLocals ?? [])];
+
+  if (locals.length === 0) {
+    return "";
+  }
+
+  const entries = locals.map((name) => `${JSON.stringify(name)}: ${name}`).join(", ");
+
+  return ` data-wrn-loop-locals="\${__wrnexusEncodeLoopLocals({ ${entries} })}"`;
+}
+
 /** Render a component view node into template-literal-ready source. */
 function renderComponentNode(node: ViewNode, ctx: CompCtx): string {
   if (node.type === "text") return compileText(node.value, ctx);
@@ -1112,6 +1144,16 @@ function renderComponentNode(node: ViewNode, ctx: CompCtx): string {
     return renderNestedComponentInvocation(node, ctx);
   }
 
+  const loopVariables = loopVarsOf(node);
+
+  const elementContext =
+    loopVariables.length > 0
+      ? {
+          ...ctx,
+          loopVars: new Set([...(ctx.loopVars ?? []), ...loopVariables]),
+        }
+      : ctx;
+
   let bindIndex = 0;
   const staticClasses: string[] = [];
   const conditionalClasses: Array<{
@@ -1143,9 +1185,22 @@ function renderComponentNode(node: ViewNode, ctx: CompCtx): string {
         return ` ${a.name}`;
       }
 
-      const rendered = ` ${a.name}="${compileAttrValue(a.value, ctx)}"`;
+      const rendered = ` ${a.name}="${compileAttrValue(a.value, elementContext)}"`;
 
-      if (!a.value.includes("{") || !exprRefsState(a.value, ctx.stateNames)) {
+      const referencesState = exprRefsState(a.value, ctx.stateNames);
+
+      const referencesLoopVariable = elementContext.loopVars
+        ? exprRefsState(a.value, elementContext.loopVars)
+        : false;
+
+      const referencesServerLocal = ctx.serverLocals
+        ? exprRefsState(a.value, ctx.serverLocals)
+        : false;
+
+      if (
+        !a.value.includes("{") ||
+        (!referencesState && !referencesLoopVariable && !referencesServerLocal)
+      ) {
         return rendered;
       }
 
@@ -1157,18 +1212,37 @@ function renderComponentNode(node: ViewNode, ctx: CompCtx): string {
 
   const initialConditionalClasses = conditionalClasses
     .map(({ className, expression }) => {
+      const referencesLoopVariable = elementContext.loopVars
+        ? exprRefsState(expression, elementContext.loopVars)
+        : false;
+
+      // data-for variables do not exist during
+      // initial server rendering.
+      if (referencesLoopVariable) {
+        return "";
+      }
+
       return `\${(${ctx.resolveExpr(expression)}) ? ${JSON.stringify(` ${className}`)} : ""}`;
     })
     .join("");
 
   const staticClassValue = staticClasses.join(" ");
 
+  const classReferencesState = exprRefsState(staticClassValue, ctx.stateNames);
+  const classReferencesLoopVariable = elementContext.loopVars
+    ? exprRefsState(staticClassValue, elementContext.loopVars)
+    : false;
+  const classReferencesServerLocal = ctx.serverLocals
+    ? exprRefsState(staticClassValue, ctx.serverLocals)
+    : false;
+
   const classHasReactiveExpression =
-    staticClassValue.includes("{") && exprRefsState(staticClassValue, ctx.stateNames);
+    staticClassValue.includes("{") &&
+    (classReferencesState || classReferencesLoopVariable || classReferencesServerLocal);
 
   const classAttribute =
     staticClasses.length > 0 || conditionalClasses.length > 0
-      ? ` class="${compileAttrValue(staticClassValue, ctx)}${initialConditionalClasses}"`
+      ? ` class="${compileAttrValue(staticClassValue, elementContext)}${initialConditionalClasses}"`
       : "";
 
   const classReactiveBinding = classHasReactiveExpression
@@ -1176,9 +1250,6 @@ function renderComponentNode(node: ViewNode, ctx: CompCtx): string {
     : "";
 
   const classBindings = conditionalClasses
-    .filter(({ expression }) => {
-      return !ctx.serverLocals || !exprRefsState(expression, ctx.serverLocals);
-    })
     .map(({ className, expression }, index) => {
       const marker = attrEscape(JSON.stringify([className, expression]));
 
@@ -1186,25 +1257,31 @@ function renderComponentNode(node: ViewNode, ctx: CompCtx): string {
     })
     .join("");
 
-  // A `data-for` element introduces loop variables for its subtree.
+  const loopLocalsAttribute = serverLoopLocalsAttribute(ctx);
-  const loops = loopVarsOf(node);
-  const childCtx =
-    loops.length > 0 ? { ...ctx, loopVars: new Set([...(ctx.loopVars ?? []), ...loops]) } : ctx;
 
   const allAttrs =
-    `${classAttribute}` + `${classReactiveBinding}` + `${classBindings}` + `${attrs}`;
+    `${loopLocalsAttribute}` +
+    `${classAttribute}` +
+    `${classReactiveBinding}` +
+    `${classBindings}` +
+    `${attrs}`;
 
   if (VOID_ELEMENTS.has(node.tag.toLowerCase())) {
     return `<${node.tag}${allAttrs}>`;
   }
 
-  const inner = node.children.map((child) => renderComponentNode(child, childCtx)).join("");
+  const inner = node.children.map((child) => renderComponentNode(child, elementContext)).join("");
 
   return `<${node.tag}${allAttrs}>${inner}</${node.tag}>`;
 }
 
 function generateComponent(ast: PageAst): string {
   const out: string[] = [];
+  const hasServerEach = viewHasServerEach(ast.view);
+
+  if (hasServerEach) {
+    out.push(`import { Buffer } from "node:buffer";`);
+  }
 
   const effectiveProps =
     ast.kind === "layout" && !ast.props.some((prop) => prop.name === "content")
@@ -1276,7 +1353,9 @@ function generateComponent(ast: PageAst): string {
 
   const scopeLine =
     needsScope && scopeKeys.length > 0
-      ? `  const __scope = __wrnexusScopeDecl({ ${scopeKeys.map((k) => `${JSON.stringify(k)}: ${nameRefs.get(k)}`).join(", ")} });\n`
+      ? `  const __scope = __wrnexusScopeDecl({ ${scopeKeys
+          .map((key) => `${JSON.stringify(key)}: ${nameRefs.get(key)}`)
+          .join(", ")} });\n`
       : needsScope
         ? `  const __scope = "";\n`
         : "";
@@ -1391,22 +1470,65 @@ function __wireRaw(v: any): string {
   return String(v == null ? "" : v);
 }`);
 
-  if (needsScope) {
+  if (hasServerEach) {
-    out.push(`function __wrnexusScopeDecl(obj: Record<string, any>): string {
+    out.push(`function __wrnexusEncodeLoopLocals(value: Record<string, any>): string {
-  const lit = (v: any) =>
+  return Buffer.from(JSON.stringify(value), "utf8").toString("base64");
-    typeof v === "number" || typeof v === "boolean"
-      ? String(v)
-      : "'" + String(v).replace(/\\\\/g, "\\\\\\\\").replace(/'/g, "\\\\'").replace(/\\n/g, "\\\\n") + "'";
-  return Object.keys(obj)
-    .map((k) => k + ": " + lit(obj[k]))
-    .join(", ")
-    .replace(/&/g, "&amp;")
-    .replace(/"/g, "&quot;")
-    .replace(/</g, "&lt;")
-    .replace(/>/g, "&gt;");
 }`);
   }
 
+  if (needsScope) {
+    out.push(`function __wrnexusSerializeScopeValue(value: any): string {
+    if (value === undefined) {
+      return "undefined";
+    }
+
+    if (value === null) {
+      return "null";
+    }
+
+    if (typeof value === "number") {
+      return Number.isFinite(value)
+        ? String(value)
+        : "null";
+    }
+
+    if (typeof value === "boolean") {
+      return value ? "true" : "false";
+    }
+
+    if (typeof value === "string") {
+      return JSON.stringify(value);
+    }
+
+    try {
+      const serialized = JSON.stringify(value);
+
+      return serialized === undefined
+        ? "undefined"
+        : serialized;
+    } catch {
+      return "null";
+    }
+  }
+
+  function __wrnexusScopeDecl(obj: Record<string, any>): string {
+    return Object.keys(obj)
+      .map(
+        (key) =>
+          key +
+          ": " +
+          __wrnexusSerializeScopeValue(
+            obj[key],
+          ),
+      )
+      .join(", ")
+      .replace(/&/g, "&amp;")
+      .replace(/"/g, "&quot;")
+      .replace(/</g, "&lt;")
+      .replace(/>/g, "&gt;");
+  }`);
+  }
+
   const serverFunctionSource = serverFunctions ? `${serverFunctions}\n` : "";
 
   out.push(

packages/compiler/test/compiler.test.ts

@@ -5,6 +5,7 @@ import { join } from "node:path";
 import { pathToFileURL } from "node:url";
 import { generate, parse } from "../src/index.ts";
 import { compileWireFile } from "../src/index.ts";
+import { mountHtml } from "@wrnexus/test";
 
 let seq = 0;
 /** Compile a `.wrn` source and import the resulting module. */
@@ -97,10 +98,18 @@ test("stateful component: state text baked into a reactive data-text span, prop
   );
   const render = mod.render as (p: Record<string, string>) => string;
   const out = render({ start: "10", label: "Score" });
-  expect(out).toContain("data-scope=\"start: 10, label: 'Score', count: 10\"");
+  expect(out).toContain('data-scope="start: 10, label: &quot;Score&quot;, count: 10"');
   expect(out).toContain('data-on-click="count++"');
   // label baked as static text; count baked as its initial value AND kept live.
   expect(out).toContain('Score: <span data-text="count">10</span>');
+
+  expect(out).toContain('data-scope="');
+
+  expect(out).toContain("start: 10");
+
+  expect(out).toContain("label: &quot;Score&quot;");
+
+  expect(out).toContain("count: 10");
 });
 
 test("prop type coercion follows the default value's type", async () => {
@@ -838,3 +847,102 @@ component FAQAccordion {
 
   expect(output).toContain("isOpen(index)");
 });
+test("data-for conditional classes do not evaluate loop variables during SSR", () => {
+  const output = generate(
+    parse(`
+component Accordion {
+  props {
+    items = []
+  }
+
+  state openIndexes = []
+
+  functions {
+    function isOpen(index) {
+      return openIndexes.includes(index)
+    }
+  }
+
+  view {
+    <article
+      data-for="item, index in items"
+      class:open="isOpen(index)"
+    >
+      {item.title}
+    </article>
+  }
+}
+`),
+  );
+
+  expect(output).toContain('data-for="item, index in items"');
+
+  expect(output).toContain("data-wrn-class-0");
+
+  expect(output).not.toContain('${(isOpen(index)) ? " open" : ""}');
+});
+test("server-rendered each locals work in reactive handlers", () => {
+  const firstLocals = Buffer.from(
+    JSON.stringify({
+      item: {
+        question: "First",
+      },
+      index: 0,
+    }),
+    "utf8",
+  ).toString("base64");
+
+  const secondLocals = Buffer.from(
+    JSON.stringify({
+      item: {
+        question: "Second",
+      },
+      index: 1,
+    }),
+    "utf8",
+  ).toString("base64");
+
+  const dom = mountHtml(`
+      <div
+        data-scope="openIndex: -1"
+      >
+        <article
+          data-wrn-loop-locals="${firstLocals}"
+        >
+          <button
+            data-on-click="openIndex = index"
+          >
+            First
+          </button>
+
+          <span
+            data-wrn-class-0='["open","openIndex === index"]'
+          ></span>
+        </article>
+
+        <article
+          data-wrn-loop-locals="${secondLocals}"
+        >
+          <button
+            data-on-click="openIndex = index"
+          >
+            Second
+          </button>
+
+          <span
+            data-wrn-class-0='["open","openIndex === index"]'
+          ></span>
+        </article>
+      </div>
+    `);
+
+  const buttons: any = dom.querySelectorAll("button");
+
+  buttons[1].click();
+
+  const articles = dom.querySelectorAll("article");
+
+  expect(articles[0].querySelector("span")?.classList.contains("open")).toBe(false);
+
+  expect(articles[1].querySelector("span")?.classList.contains("open")).toBe(true);
+});

packages/core/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wrnexus/core",
-  "version": "0.2.39",
+  "version": "0.2.47",
   "type": "module",
   "main": "src/index.ts",
   "exports": {

packages/csr/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wrnexus/csr",
-  "version": "0.2.39",
+  "version": "0.2.47",
   "type": "module",
   "main": "src/index.ts",
   "exports": {

packages/csr/test/reactive.test.ts

@@ -1,6 +1,7 @@
 import { test, expect, beforeEach } from "bun:test";
 import { Window } from "happy-dom";
 import { REACTIVE_RUNTIME } from "../src/reactive-runtime.ts";
+import { mountHtml } from "@wrnexus/test";
 
 // Fresh DOM per test, with the runtime's globals bound.
 function mount(html: string): Window {
@@ -164,3 +165,48 @@ test("independent signals in one scope update correctly (dependency tracking)",
   click("bb");
   expect([ta(), tb()]).toEqual(["2", "101"]);
 });
+test("data-for preserves arrays of objects from encoded component scope", () => {
+  const items = [
+    {
+      question: "One",
+      answer: "First",
+    },
+    {
+      question: "Two",
+      answer: "Second",
+    },
+    {
+      question: "Three",
+      answer: "Third",
+    },
+    {
+      question: "Four",
+      answer: "Fourth",
+    },
+  ];
+
+  const encoded = Buffer.from(
+    JSON.stringify({
+      items,
+    }),
+    "utf8",
+  ).toString("base64");
+
+  const dom = mountHtml(`
+      <div data-wrn-scope="${encoded}">
+        <article data-for="item, index in items">
+          <span>{index + 1}</span>
+          <strong>{item.question}</strong>
+        </article>
+      </div>
+    `);
+
+  expect(dom.querySelectorAll("article")).toHaveLength(4);
+
+  expect(dom.querySelectorAll("strong").map((element) => element.textContent)).toEqual([
+    "One",
+    "Two",
+    "Three",
+    "Four",
+  ]);
+});

packages/db/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wrnexus/db",
-  "version": "0.2.39",
+  "version": "0.2.47",
   "private": true,
   "type": "module",
   "main": "src/index.ts",

packages/dev-server/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wrnexus/dev-server",
-  "version": "0.2.39",
+  "version": "0.2.47",
   "type": "module",
   "main": "src/index.ts",
   "exports": {

packages/dev-server/src/cache.ts

@@ -0,0 +1,36 @@
+import { existsSync, rmSync } from "node:fs";
+import { resolve } from "node:path";
+
+export interface ResetDevCacheOptions {
+  rootDir?: string;
+  cacheDir?: string;
+  enabled?: boolean;
+}
+
+export function resetDevCache(options: ResetDevCacheOptions = {}): string {
+  const rootDir = resolve(options.rootDir ?? process.cwd());
+
+  const cacheDir = resolve(rootDir, options.cacheDir ?? ".wrnexus");
+
+  if (options.enabled === false) {
+    return cacheDir;
+  }
+
+  // Safety: never allow deleting the project root.
+  if (cacheDir === rootDir) {
+    throw new Error("Refusing to remove the project root as the WRNexus cache directory.");
+  }
+
+  if (existsSync(cacheDir)) {
+    rmSync(cacheDir, {
+      recursive: true,
+      force: true,
+      maxRetries: 3,
+      retryDelay: 100,
+    });
+
+    console.log(`[wrnexus] cleared generated cache: ${cacheDir}`);
+  }
+
+  return cacheDir;
+}

packages/dev-server/src/index.ts

@@ -29,6 +29,7 @@ import { createDevAssetServer } from "./assets.ts";
 import { HmrHub } from "./hmr.ts";
 import { startWatcher } from "./watch.ts";
 export { RESTART_EXIT_CODE } from "./restart.ts";
+import { resetDevCache } from "./cache.ts";
 
 export interface ServeOptions {
   appDir: string;
@@ -122,6 +123,12 @@ export async function startServer(opts: ServeOptions): Promise<RunningServer> {
   const router = buildRouter(appDir, { componentDirs: [uiComponentsDir()] });
   const styleEntry = opts.styleEntry ?? null;
   const appRoot = dirname(appDir);
+
+  resetDevCache({
+    rootDir: appRoot,
+    enabled: process.env.WRNEXUS_PRESERVE_CACHE !== "1",
+  });
+
   // Compile every `.wrn` into ONE cache dir at the project root, instead of a
   // `.wrnexus/` next to each source file (and inside node_modules UI dirs).
   setCompileCacheDir(join(appRoot, ".wrnexus"));

packages/encryption/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wrnexus/encryption",
-  "version": "0.2.39",
+  "version": "0.2.47",
   "private": true,
   "type": "module",
   "main": "src/index.ts",

packages/helpers/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wrnexus/helpers",
-  "version": "0.2.39",
+  "version": "0.2.47",
   "private": true,
   "type": "module",
   "description": "Safe convenience helpers for WrNexus request contexts and common application flows.",

packages/i18n/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wrnexus/i18n",
-  "version": "0.2.39",
+  "version": "0.2.47",
   "private": true,
   "type": "module",
   "main": "src/index.ts",

packages/jwt/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wrnexus/jwt",
-  "version": "0.2.39",
+  "version": "0.2.47",
   "private": true,
   "type": "module",
   "main": "src/index.ts",

packages/mobile/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wrnexus/mobile",
-  "version": "0.2.39",
+  "version": "0.2.47",
   "type": "module",
   "main": "src/index.ts",
   "exports": {

packages/native/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wrnexus/native",
-  "version": "0.2.39",
+  "version": "0.2.47",
   "type": "module",
   "main": "src/index.ts",
   "exports": {

packages/oauth/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wrnexus/oauth",
-  "version": "0.2.39",
+  "version": "0.2.47",
   "private": true,
   "type": "module",
   "main": "src/index.ts",

packages/pubsub/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wrnexus/pubsub",
-  "version": "0.2.39",
+  "version": "0.2.47",
   "private": true,
   "type": "module",
   "main": "src/index.ts",

packages/queue/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wrnexus/queue",
-  "version": "0.2.39",
+  "version": "0.2.47",
   "private": true,
   "type": "module",
   "main": "src/index.ts",

packages/reactive/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wrnexus/reactive",
-  "version": "0.2.39",
+  "version": "0.2.47",
   "type": "module",
   "main": "src/index.ts",
   "exports": {

packages/router/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wrnexus/router",
-  "version": "0.2.39",
+  "version": "0.2.47",
   "type": "module",
   "main": "src/index.ts",
   "exports": {

packages/ssr/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wrnexus/ssr",
-  "version": "0.2.39",
+  "version": "0.2.47",
   "type": "module",
   "main": "src/index.ts",
   "exports": {

packages/styles/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wrnexus/styles",
-  "version": "0.2.39",
+  "version": "0.2.47",
   "type": "module",
   "main": "src/index.ts",
   "exports": {

packages/test/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wrnexus/test",
-  "version": "0.2.39",
+  "version": "0.2.47",
   "private": true,
   "type": "module",
   "main": "src/index.ts",

packages/tracking/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wrnexus/tracking",
-  "version": "0.2.39",
+  "version": "0.2.47",
   "private": true,
   "type": "module",
   "main": "src/index.ts",

packages/ui/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wrnexus/ui",
-  "version": "0.2.39",
+  "version": "0.2.47",
   "private": true,
   "type": "module",
   "main": "src/index.ts",

packages/uploader/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wrnexus/uploader",
-  "version": "0.2.39",
+  "version": "0.2.47",
   "private": true,
   "type": "module",
   "main": "src/index.ts",

packages/validation/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wrnexus/validation",
-  "version": "0.2.39",
+  "version": "0.2.47",
   "private": true,
   "type": "module",
   "main": "src/index.ts",

update-package-versions.mjs

@@ -1,7 +1,7 @@
 import { existsSync, readdirSync, readFileSync, writeFileSync } from "node:fs";
 import { join } from "node:path";
 
-const version = "0.2.39";
+const version = "0.2.47";
 
 const dependencyGroups = [
   "dependencies",