@jay-framework/dev-server 0.22.2 → 0.23.1

package/dist/index.d.ts

@@ -140,6 +140,8 @@ interface RouteInfo {
     path: string;
     jayHtmlPath: string;
     compPath: string;
+    /** Dev-server tooling route — consumers like AIditor may filter from page pickers. */
+    devOnly?: boolean;
 }
 type DevServerRouteRegistrar = (routes: DevServerRoute[]) => void;
 declare class DevServerService {
@@ -160,7 +162,7 @@ declare class DevServerService {
      * added since dev-server startup (e.g. after AIditor Add Page).
      */
     refreshRoutes(): Promise<RouteInfo[]>;
-    /** List all page routes in the project. */
+    /** List all page routes in the project (includes dev-only plugin routes). */
     listRoutes(): RouteInfo[];
     /**
      * Run loadParams for a route, yielding param batches as an async generator.

package/dist/index.js

@@ -1,22 +1,19 @@
 var __defProp = Object.defineProperty;
 var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
-var __publicField = (obj, key, value) => {
-  __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
-  return value;
-};
+var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
 import { createServer } from "vite";
 import { jayRuntime } from "@jay-framework/vite-plugin";
 import { createRequire } from "module";
 import "@jay-framework/compiler-shared";
 import * as path from "node:path";
 import path__default from "node:path";
-import { JAY_IMPORT_RESOLVER, injectHeadfullFSTemplates, parseContract, slowRenderTransform, assignCoordinatesToJayHtml, discoverHeadlessInstances } from "@jay-framework/compiler-jay-html";
+import { injectHeadfullFSTemplates, JAY_IMPORT_RESOLVER, parseContract, slowRenderTransform, assignCoordinatesToJayHtml, discoverHeadlessInstances } from "@jay-framework/compiler-jay-html";
 import { getLogger, getDevLogger } from "@jay-framework/logger";
 import { createRequire as createRequire$1 } from "node:module";
 import * as fsSync from "node:fs";
 import fsSync__default from "node:fs";
 import { scanRoutes, createRoute, routeToExpressRoute } from "@jay-framework/stack-route-scanner";
-import { discoverPluginsWithInit, sortPluginsByDependencies, executePluginServerInits, runInitCallbacks, actionRegistry, discoverAndRegisterActions, discoverAllPluginActions, runShutdownCallbacks, clearLifecycleCallbacks, clearServiceRegistry, clearClientInitData, loadPageParts, runLoadParams, DevSlowlyChangingPhase, SlowRenderCache, preparePluginClientInits, registerService, clearServerElementCache, scanPlugins, getServiceRegistry, materializeContracts, parseCookies, renderFastChangingData, mergeHeadTags, generateClientScript, getClientInitData, generateSSRPageHtml, generateFrozenPageHtml, slowRenderInstances, normalizeAndResolveInstanceProps } from "@jay-framework/stack-server-runtime";
+import { discoverPluginsWithInit, sortPluginsByDependencies, executePluginServerInits, runInitCallbacks, discoverAndRegisterActions, actionRegistry, discoverAllPluginActions, runShutdownCallbacks, clearLifecycleCallbacks, clearServiceRegistry, clearClientInitData, loadPageParts, runLoadParams, DevSlowlyChangingPhase, SlowRenderCache, preparePluginClientInits, registerService, getServiceRegistry, materializeContracts, scanPlugins, clearServerElementCache, parseCookies, generateFrozenPageHtml, renderFastChangingData, generateClientScript, getClientInitData, mergeHeadTags, generateSSRPageHtml, slowRenderInstances, normalizeAndResolveInstanceProps } from "@jay-framework/stack-server-runtime";
 import * as fs from "node:fs/promises";
 import fs__default from "node:fs/promises";
 import { pathToFileURL } from "node:url";
@@ -33,10 +30,7 @@ const s$1 = createRequire(import.meta.url), e$1 = s$1("typescript"), c$1 = new P
 });
 var __defProp2 = Object.defineProperty;
 var __defNormalProp2 = (obj, key, value) => key in obj ? __defProp2(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
-var __publicField2 = (obj, key, value) => {
-  __defNormalProp2(obj, typeof key !== "symbol" ? key + "" : key, value);
-  return value;
-};
+var __publicField2 = (obj, key, value) => __defNormalProp2(obj, typeof key !== "symbol" ? key + "" : key, value);
 const s = createRequire(import.meta.url), e = s("typescript"), c = new Proxy(e, {
   get(t, r) {
     return t[r];
@@ -72,6 +66,9 @@ function mkTransformer(fileTransformer, config) {
     };
   };
 }
+const { isStringLiteral: isStringLiteral$a, isImportDeclaration: isImportDeclaration$5, forEachChild: forEachChild$4, isNamedImports: isNamedImports$1 } = c;
+const { isStringLiteral: isStringLiteral$9, forEachChild: forEachChild$3, isImportDeclaration: isImportDeclaration$4 } = c;
+const { isIdentifier: isIdentifier$a, isArrowFunction: isArrowFunction$3, isFunctionDeclaration: isFunctionDeclaration$2, isVariableStatement: isVariableStatement$3, forEachChild: forEachChild$2 } = c;
 const {
   isIdentifier: isIdentifier$9,
   isStatement: isStatement$3,
@@ -89,7 +86,7 @@ const {
   isNumericLiteral,
   isToken,
   isNamespaceImport,
-  isNamedImports: isNamedImports$1,
+  isNamedImports: isNamedImports$2,
   isArrowFunction: isArrowFunction$2,
   isFunctionExpression,
   isCallExpression: isCallExpression$6,
@@ -138,12 +135,9 @@ const getAccessedByProperty = (binding, accessedFrom, propertyName) => {
   return accessedFrom ? propertyName ? isIdentifier$9(propertyName) ? propertyName.text : void 0 : binding.text : void 0;
 };
 function findDeclaringStatement(node) {
-  if (!node)
-    return void 0;
-  else if (isStatement$3(node))
-    return node;
-  else
-    return findDeclaringStatement(node.parent);
+  if (!node) return void 0;
+  else if (isStatement$3(node)) return node;
+  else return findDeclaringStatement(node.parent);
 }
 function tsBindingNameToVariable(binding, accessedFrom, assignedFrom, propertyName, root) {
   if (isIdentifier$9(binding)) {
@@ -202,8 +196,7 @@ class NameBindingResolver {
         mkParameterVariableRoot(param, paramIndex)
       );
       paramVariables.forEach((variable) => {
-        if (variable.name)
-          this.variables.set(variable.name, variable);
+        if (variable.name) this.variables.set(variable.name, variable);
       });
     });
   }
@@ -304,8 +297,7 @@ class NameBindingResolver {
     let resolved;
     while ((resolved = nameResolver.getVariable(variableName)) === UNKNOWN_VARIABLE && nameResolver.parentNameResolver)
       nameResolver = nameResolver.parentNameResolver;
-    if (resolved === UNKNOWN_VARIABLE)
-      return { root: mkGlobalVariableRoot(variableName) };
+    if (resolved === UNKNOWN_VARIABLE) return { root: mkGlobalVariableRoot(variableName) };
     return resolved;
   }
   addImportDeclaration(node) {
@@ -336,7 +328,7 @@ class NameBindingResolver {
           root
         });
         this.variables.set(namedBindings.name.text, variable);
-      } else if (isNamedImports$1(namedBindings)) {
+      } else if (isNamedImports$2(namedBindings)) {
         namedBindings.elements.forEach((importSpecifier) => {
           if (!importSpecifier.isTypeOnly) {
             let variable = mkVariable({
@@ -356,8 +348,7 @@ class NameBindingResolver {
   }
 }
 function flattenVariable(variable, path2 = []) {
-  if (variable.assignedFrom)
-    return flattenVariable(variable.assignedFrom, path2);
+  if (variable.assignedFrom) return flattenVariable(variable.assignedFrom, path2);
   else if (variable.accessedFrom) {
     return flattenVariable(variable.accessedFrom, [variable.accessedByProperty, ...path2]);
   } else if (variable.properties && !!variable.properties.find((_) => _.name === path2[0])) {
@@ -365,12 +356,19 @@ function flattenVariable(variable, path2 = []) {
       variable.properties.find((_) => _.name === path2[0]),
       path2.slice(1)
     );
-  } else
-    return { path: path2, root: variable.root };
+  } else return { path: path2, root: variable.root };
 }
+const { isIdentifier: isIdentifier$8, isPropertyAccessExpression: isPropertyAccessExpression$4 } = c;
 function byAnd() {
   return (agg, value) => agg && value;
 }
+const {
+  isCallExpression: isCallExpression$5,
+  isExpressionStatement: isExpressionStatement$1,
+  isIdentifier: isIdentifier$7,
+  isPropertyAccessExpression: isPropertyAccessExpression$3,
+  isBlock: isBlock$3
+} = c;
 const {
   isIdentifier: isIdentifier$6,
   SyntaxKind: SyntaxKind$4,
@@ -442,12 +440,8 @@ class UnionResolvedType {
     if (rightSide instanceof UnionResolvedType) {
       for (const item1 of this.types)
         for (const item2 of rightSide.types)
-          if (item1.canBeAssignedFrom(item2))
-            return true;
-    } else
-      for (const item1 of this.types)
-        if (item1.canBeAssignedFrom(rightSide))
-          return true;
+          if (item1.canBeAssignedFrom(item2)) return true;
+    } else for (const item1 of this.types) if (item1.canBeAssignedFrom(rightSide)) return true;
     return false;
   }
 }
@@ -475,15 +469,11 @@ class SourceFileBindingResolver {
       return node;
     };
     const visitor = (node) => {
-      if (isFunctionDeclaration$1(node))
-        nbResolversQueue[0].addFunctionDeclaration(node);
-      if (isVariableStatement$2(node))
-        nbResolversQueue[0].addVariableStatement(node);
-      else if (isImportDeclaration$3(node))
-        nbResolversQueue[0].addImportDeclaration(node);
-      else if (isBlock$2(node))
-        return doWithChildBindingResolver(node, () => {
-        });
+      if (isFunctionDeclaration$1(node)) nbResolversQueue[0].addFunctionDeclaration(node);
+      if (isVariableStatement$2(node)) nbResolversQueue[0].addVariableStatement(node);
+      else if (isImportDeclaration$3(node)) nbResolversQueue[0].addImportDeclaration(node);
+      else if (isBlock$2(node)) return doWithChildBindingResolver(node, () => {
+      });
       else if (isFunctionLikeDeclarationBase(node)) {
         return doWithChildBindingResolver(
           node,
@@ -516,8 +506,7 @@ class SourceFileBindingResolver {
   }
   findBindingResolver(node) {
     let found;
-    while (!(found = this.nameBindingResolvers.get(node)) && node.parent)
-      node = node.parent;
+    while (!(found = this.nameBindingResolvers.get(node)) && node.parent) node = node.parent;
     return found;
   }
   explain(identifier) {
@@ -528,8 +517,7 @@ class SourceFileBindingResolver {
       if (isImportModuleVariableRoot(flattened.root) && isStringLiteral$7(flattened.root.module)) {
         return new ImportFromModuleResolvedType(flattened.root.module.text, flattened.path);
       }
-    } else
-      return void 0;
+    } else return void 0;
   }
   explainType(type) {
     if (type) {
@@ -539,10 +527,8 @@ class SourceFileBindingResolver {
           let resolved = this.findBindingResolver(typeName).resolveIdentifier(typeName);
           let flattened = flattenVariable(resolved);
           let typeFromFlattened = this.explainFlattenedVariableType(flattened);
-          if (typeFromFlattened)
-            return typeFromFlattened;
-          if (builtInType(typeName.text))
-            return new BuiltInResolvedType(typeName.text);
+          if (typeFromFlattened) return typeFromFlattened;
+          if (builtInType(typeName.text)) return new BuiltInResolvedType(typeName.text);
         }
       } else if (type.kind === SyntaxKind$4.StringKeyword)
         return new BuiltInResolvedType("string");
@@ -550,10 +536,8 @@ class SourceFileBindingResolver {
         return new BuiltInResolvedType("number");
       else if (type.kind === SyntaxKind$4.BooleanKeyword)
         return new BuiltInResolvedType("boolean");
-      else if (type.kind === SyntaxKind$4.AnyKeyword)
-        return new BuiltInResolvedType("any");
-      else if (type.kind === SyntaxKind$4.VoidKeyword)
-        return new BuiltInResolvedType("void");
+      else if (type.kind === SyntaxKind$4.AnyKeyword) return new BuiltInResolvedType("any");
+      else if (type.kind === SyntaxKind$4.VoidKeyword) return new BuiltInResolvedType("void");
       else if (isArrayTypeNode(type))
         return new ArrayResolvedType(this.explainType(type.elementType));
       else if (isFunctionTypeNode(type)) {
@@ -569,7 +553,67 @@ class SourceFileBindingResolver {
     return new GlobalResolvedType(globalVariableRoot.name);
   }
 }
-const { isStringLiteral: isStringLiteral$2 } = c;
+const {
+  isSpreadElement,
+  isFunctionDeclaration: isFunctionDeclaration$4,
+  isDecorator,
+  isCallExpression: isCallExpression$4,
+  isIdentifier: isIdentifier$5,
+  isPropertyAccessExpression: isPropertyAccessExpression$2,
+  isReturnStatement,
+  isNewExpression: isNewExpression$1,
+  isExpressionStatement,
+  isBinaryExpression: isBinaryExpression$1,
+  SyntaxKind: SyntaxKind$3,
+  transform: transform$5,
+  visitEachChild: visitEachChild$4
+} = c;
+const { visitEachChild: visitEachChild$3, transform: transform$4, visitNode: visitNode$3 } = c;
+const { isTypeReferenceNode } = c;
+const {
+  visitEachChild: visitEachChild$2,
+  isIdentifier: isIdentifier$4,
+  SyntaxKind: SyntaxKind$2,
+  transform: transform$3,
+  isStatement: isStatement$2,
+  isBlock: isBlock$1,
+  isExpression: isExpression$1,
+  isLiteralExpression: isLiteralExpression$1,
+  visitNode: visitNode$2
+} = c;
+const { visitEachChild: visitEachChild$1, isCallExpression: isCallExpression$3, isPropertyAccessExpression: isPropertyAccessExpression$1$1 } = c;
+const {
+  isBinaryExpression,
+  isCallExpression: isCallExpression$2,
+  isIdentifier: isIdentifier$3,
+  isNewExpression,
+  isPropertyAccessExpression: isPropertyAccessExpression$6,
+  SyntaxKind: SyntaxKind$1,
+  isArrowFunction: isArrowFunction$1,
+  isLiteralExpression,
+  isStatement: isStatement$1,
+  isVariableStatement: isVariableStatement$1,
+  isBlock,
+  isIfStatement,
+  isForStatement,
+  isForOfStatement,
+  isForInStatement,
+  isWhileStatement,
+  isDoStatement,
+  isElementAccessExpression,
+  isPropertyAssignment
+} = c;
+const { isCallExpression: isCallExpression$1$1, isIdentifier: isIdentifier$2$1, isStringLiteral: isStringLiteral$6, isVariableStatement: isVariableStatement$4, forEachChild: forEachChild$1 } = c;
+const { isCallExpression: isCallExpression$7, isIdentifier: isIdentifier$1$1, isStringLiteral: isStringLiteral$5, forEachChild } = c;
+const { transform: transform$2, isArrowFunction, isExpression, visitNode: visitNode$1 } = c;
+const { SyntaxKind: SyntaxKind$6, transform: transform$1, isStringLiteral: isStringLiteral$4, isInterfaceDeclaration: isInterfaceDeclaration$1, isImportDeclaration: isImportDeclaration$2 } = c;
+const { isStringLiteral: isStringLiteral$3 } = c;
+const { isImportDeclaration: isImportDeclaration$1$1 } = c;
+const { visitEachChild: visitEachChild$6, transform, isStringLiteral: isStringLiteral$2, isImportDeclaration: isImportDeclaration$6 } = c;
+const { createSourceFile: createSourceFile$2, ScriptTarget: ScriptTarget$2, ScriptKind } = c;
+const { isStringLiteral: isStringLiteral$1$1 } = c;
+const { isIdentifier: isIdentifier$b, isStatement, visitNode } = c;
+const { isStringLiteral: isStringLiteral$b } = c;
 function areFlattenedAccessChainsEqual(chain1, chain2) {
   if (chain1.path.length !== chain2.path.length) {
     return false;
@@ -593,8 +637,8 @@ function areVariableRootsEqual(root1, root2) {
   switch (root1.kind) {
     case VariableRootType.ImportModule:
       if (isImportModuleVariableRoot(root1) && isImportModuleVariableRoot(root2)) {
-        const module1 = isStringLiteral$2(root1.module) ? root1.module.text : String(root1.module);
-        const module2 = isStringLiteral$2(root2.module) ? root2.module.text : String(root2.module);
+        const module1 = isStringLiteral$b(root1.module) ? root1.module.text : String(root1.module);
+        const module2 = isStringLiteral$b(root2.module) ? root2.module.text : String(root2.module);
         return module1 === module2 && root1.importType === root2.importType;
       }
       return false;
@@ -616,28 +660,39 @@ const COMPONENT_SERVER_METHODS = /* @__PURE__ */ new Set([
   "withSlowlyRender",
   "withFastRender"
 ]);
-const COMPONENT_CLIENT_METHODS = /* @__PURE__ */ new Set(["withInteractive", "withContexts"]);
+const COMPONENT_CLIENT_METHODS = /* @__PURE__ */ new Set(["withContexts"]);
+const COMPONENT_CLIENT_REPLACE_METHODS = /* @__PURE__ */ new Map([["withInteractive", "withInteractiveMark"]]);
 const INIT_SERVER_METHODS = /* @__PURE__ */ new Set(["withServer"]);
 const INIT_CLIENT_METHODS = /* @__PURE__ */ new Set(["withClient"]);
 function shouldRemoveMethod(methodName, environment) {
-  if (environment === "client" && COMPONENT_SERVER_METHODS.has(methodName))
-    return true;
-  if (environment === "server" && COMPONENT_CLIENT_METHODS.has(methodName))
-    return true;
-  if (environment === "client" && INIT_SERVER_METHODS.has(methodName))
-    return true;
-  if (environment === "server" && INIT_CLIENT_METHODS.has(methodName))
-    return true;
+  if (environment === "client" && COMPONENT_SERVER_METHODS.has(methodName)) return true;
+  if (environment === "server" && COMPONENT_CLIENT_METHODS.has(methodName)) return true;
+  if (environment === "client" && INIT_SERVER_METHODS.has(methodName)) return true;
+  if (environment === "server" && INIT_CLIENT_METHODS.has(methodName)) return true;
   return false;
 }
+function getReplacementMethod(methodName, environment) {
+  if (environment === "server") return COMPONENT_CLIENT_REPLACE_METHODS.get(methodName);
+  return void 0;
+}
 const { isCallExpression: isCallExpression$1, isPropertyAccessExpression: isPropertyAccessExpression$1, isIdentifier: isIdentifier$2, isStringLiteral: isStringLiteral$1 } = c$1;
 function findBuilderMethodsToRemove(sourceFile, bindingResolver, environment) {
   const callsToRemove = [];
   const removedVariables = /* @__PURE__ */ new Set();
+  const methodReplacements = [];
   const visit = (node) => {
     if (isCallExpression$1(node) && isPropertyAccessExpression$1(node.expression) && isPartOfJayStackChain(node, bindingResolver)) {
       const methodName = node.expression.name.text;
-      if (shouldRemoveMethod(methodName, environment)) {
+      const replacementName = getReplacementMethod(methodName, environment);
+      if (replacementName) {
+        const nameNode = node.expression.name;
+        methodReplacements.push({
+          start: nameNode.getStart(),
+          end: nameNode.getEnd(),
+          replacement: replacementName
+        });
+        collectVariablesFromArguments(node.arguments, bindingResolver, removedVariables);
+      } else if (shouldRemoveMethod(methodName, environment)) {
         const variable = bindingResolver.explain(node.expression);
         const flattened = flattenVariable(variable);
         callsToRemove.push(flattened);
@@ -647,7 +702,7 @@ function findBuilderMethodsToRemove(sourceFile, bindingResolver, environment) {
     node.forEachChild(visit);
   };
   sourceFile.forEachChild(visit);
-  return { callsToRemove, removedVariables };
+  return { callsToRemove, removedVariables, methodReplacements };
 }
 const JAY_BUILDER_FUNCTIONS = /* @__PURE__ */ new Set(["makeJayStackComponent", "makeJayInit"]);
 function isPartOfJayStackChain(callExpr, bindingResolver) {
@@ -828,11 +883,12 @@ function mkJayStackCodeSplitTransformer({
       workingSourceFile = factory.updateSourceFile(sourceFile, filtered);
     }
   }
-  const { callsToRemove } = findBuilderMethodsToRemove(
+  const { callsToRemove, methodReplacements } = findBuilderMethodsToRemove(
     workingSourceFile,
     bindingResolver,
     environment
   );
+  const replacementPositions = new Map(methodReplacements.map((r) => [r.start, r]));
   const transformVisitor = (node) => {
     if (isCallExpression(node) && isPropertyAccessExpression(node.expression)) {
       const variable = bindingResolver.explain(node.expression);
@@ -841,6 +897,17 @@ function mkJayStackCodeSplitTransformer({
         const receiver = node.expression.expression;
         return transformVisitor(receiver);
       }
+      const nameNode = node.expression.name;
+      const repl = replacementPositions.get(nameNode.getStart());
+      if (repl) {
+        const newName = factory.createIdentifier(repl.replacement);
+        const newAccess = factory.updatePropertyAccessExpression(
+          node.expression,
+          visitEachChild(node.expression.expression, transformVisitor, context),
+          newName
+        );
+        return factory.updateCallExpression(node, newAccess, node.typeArguments, []);
+      }
     }
     return visitEachChild(node, transformVisitor, context);
   };
@@ -897,8 +964,7 @@ function findChainRootBuilderName(statement, bindingResolver) {
   if (c$1.isExpressionStatement(statement) && isCallExpression(statement.expression)) {
     expr = statement.expression;
   }
-  if (!expr)
-    return void 0;
+  if (!expr) return void 0;
   let current = expr;
   while (true) {
     if (isCallExpression(current) && isPropertyAccessExpression(current.expression)) {
@@ -1061,8 +1127,7 @@ function createImportChainTracker(options = {}) {
     let current = moduleId;
     for (let i = 0; i < 100; i++) {
       const importer = importChain.get(current);
-      if (!importer)
-        break;
+      if (!importer) break;
       chain.push(importer);
       current = importer;
     }
@@ -1179,7 +1244,7 @@ function createImportChainTracker(options = {}) {
     }
   };
 }
-const require2 = createRequire$1(import.meta.url);
+const require$1 = createRequire$1(import.meta.url);
 function createDefaultPluginDetector() {
   const cache = /* @__PURE__ */ new Map();
   return {
@@ -1190,9 +1255,9 @@ function createDefaultPluginDetector() {
       }
       let result = false;
       try {
-        require2.resolve(`${packageName}/plugin.yaml`, { paths: [projectRoot] });
+        require$1.resolve(`${packageName}/plugin.yaml`, { paths: [projectRoot] });
         try {
-          require2.resolve(`${packageName}/client`, { paths: [projectRoot] });
+          require$1.resolve(`${packageName}/client`, { paths: [projectRoot] });
           result = true;
         } catch {
           result = false;
@@ -1230,12 +1295,9 @@ function transformImports(options) {
   let result = code;
   result = result.replace(IMPORT_REGEX, (match, clause, quote, source) => {
     const packageName = extractPackageName(source);
-    if (!packageName)
-      return match;
-    if (isSubpathImport(source, packageName))
-      return match;
-    if (!pluginDetector.isJayPluginWithClientExport(packageName, projectRoot))
-      return match;
+    if (!packageName) return match;
+    if (isSubpathImport(source, packageName)) return match;
+    if (!pluginDetector.isJayPluginWithClientExport(packageName, projectRoot)) return match;
     hasChanges = true;
     const newSource = `${packageName}/client`;
     if (verbose) {
@@ -1247,12 +1309,9 @@ function transformImports(options) {
   });
   result = result.replace(EXPORT_FROM_REGEX, (match, clause, quote, source) => {
     const packageName = extractPackageName(source);
-    if (!packageName)
-      return match;
-    if (isSubpathImport(source, packageName))
-      return match;
-    if (!pluginDetector.isJayPluginWithClientExport(packageName, projectRoot))
-      return match;
+    if (!packageName) return match;
+    if (isSubpathImport(source, packageName)) return match;
+    if (!pluginDetector.isJayPluginWithClientExport(packageName, projectRoot)) return match;
     hasChanges = true;
     const newSource = `${packageName}/client`;
     if (verbose) {
@@ -1343,7 +1402,7 @@ function jayStackCompiler(options = {}) {
     // Second: Action import transformation (client builds only)
     // Uses resolveId + load to replace action modules with virtual modules
     // containing createActionCaller calls BEFORE bundling happens.
-    (() => {
+    /* @__PURE__ */ (() => {
       let isSSRBuild = false;
       return {
         name: "jay-stack:action-transform",
@@ -1408,10 +1467,8 @@ function jayStackCompiler(options = {}) {
           const hasRegularActions = actions.some((a) => !a.isStreaming);
           const hasStreamActions = actions.some((a) => a.isStreaming);
           const importNames = [];
-          if (hasRegularActions)
-            importNames.push("createActionCaller");
-          if (hasStreamActions)
-            importNames.push("createStreamCaller");
+          if (hasRegularActions) importNames.push("createActionCaller");
+          if (hasStreamActions) importNames.push("createStreamCaller");
           const lines = [
             `import { ${importNames.join(", ")} } from '@jay-framework/stack-client-runtime';`,
             ""
@@ -1440,17 +1497,12 @@ function jayStackCompiler(options = {}) {
         // from component files in client builds. These are server-only
         // constructs that shouldn't appear in client bundles.
         transform(code, id, options2) {
-          if (options2?.ssr || isSSRBuild)
-            return null;
-          if (!id.endsWith(".ts") && !id.includes(".ts?"))
-            return null;
-          if (id.includes(".jay-html"))
-            return null;
-          if (isActionImport(id))
-            return null;
+          if (options2?.ssr || isSSRBuild) return null;
+          if (!id.endsWith(".ts") && !id.includes(".ts?")) return null;
+          if (id.includes(".jay-html")) return null;
+          if (isActionImport(id)) return null;
           const ACTION_BUILDERS = ["makeJayAction", "makeJayQuery", "makeJayStream"];
-          if (!ACTION_BUILDERS.some((b) => code.includes(b)))
-            return null;
+          if (!ACTION_BUILDERS.some((b) => code.includes(b))) return null;
           return stripInlineActionBuilders(code, ACTION_BUILDERS);
         }
       };
@@ -1758,12 +1810,9 @@ class ServiceLifecycleManager {
   }
 }
 function deepMergeViewStates(base, overlay, trackByMap, path2 = "") {
-  if (!base && !overlay)
-    return {};
-  if (!base)
-    return overlay || {};
-  if (!overlay)
-    return base || {};
+  if (!base && !overlay) return {};
+  if (!base) return overlay || {};
+  if (!overlay) return base || {};
   const result = {};
   const allKeys = /* @__PURE__ */ new Set([...Object.keys(base), ...Object.keys(overlay)]);
   for (const key of allKeys) {
@@ -1897,8 +1946,7 @@ function createActionRouter(options) {
     );
     const tempDir = req._jayTempDir;
     const cleanup = () => {
-      if (tempDir)
-        cleanupTempDir(tempDir);
+      if (tempDir) cleanupTempDir(tempDir);
     };
     if (registry.isStreaming(actionName)) {
       res.setHeader("Content-Type", "application/x-ndjson");
@@ -1962,8 +2010,7 @@ function getStatusCodeForError(code, isActionError) {
 function mergeDottedMultipartKeys(body) {
   const keys = Object.keys(body);
   for (const key of keys) {
-    if (!key.includes("."))
-      continue;
+    if (!key.includes(".")) continue;
     const val = body[key];
     delete body[key];
     const parts = key.split(".");
@@ -1991,8 +2038,7 @@ function parseMultipart(req, tempDir) {
       headers: req.headers
     });
     bb.on("file", (fieldname, stream, info) => {
-      if (errored)
-        return;
+      if (errored) return;
       fileCount++;
       const filename = info.filename || `upload-${fileCount}`;
       const tempPath = path$1.join(tempDir, `${fileCount}-${filename}`);
@@ -2027,8 +2073,7 @@ function parseMultipart(req, tempDir) {
       );
     });
     bb.on("field", (fieldname, value) => {
-      if (errored)
-        return;
+      if (errored) return;
       if (fieldname === "_json") {
         try {
           jsonData = JSON.parse(value);
@@ -2039,8 +2084,7 @@ function parseMultipart(req, tempDir) {
       }
     });
     bb.on("close", () => {
-      if (errored)
-        return;
+      if (errored) return;
       Promise.all(pendingWrites).then(() => {
         const body = { ...jsonData, ...files };
         mergeDottedMultipartKeys(body);
@@ -2164,8 +2208,7 @@ class FreezeStore {
       const files = await fs.readdir(this.dir);
       const entries = [];
       for (const file of files) {
-        if (!file.endsWith(".json"))
-          continue;
+        if (!file.endsWith(".json")) continue;
         try {
           const content = await fs.readFile(path.join(this.dir, file), "utf-8");
           const entry = JSON.parse(content);
@@ -2184,8 +2227,7 @@ class FreezeStore {
   }
   async rename(id, name) {
     const entry = await this.get(id);
-    if (!entry)
-      return false;
+    if (!entry) return false;
     entry.name = name;
     await fs.writeFile(
       path.join(this.dir, `${id}.json`),
@@ -2239,12 +2281,13 @@ class DevServerService {
     }
     return this.listRoutes();
   }
-  /** List all page routes in the project. */
+  /** List all page routes in the project (includes dev-only plugin routes). */
   listRoutes() {
     return this.routes.map((r) => ({
       path: r.path,
       jayHtmlPath: r.fsRoute.jayHtmlPath,
-      compPath: r.fsRoute.compPath
+      compPath: r.fsRoute.compPath,
+      ...r.fsRoute.devOnly && { devOnly: true }
     }));
   }
   /**
@@ -2284,8 +2327,7 @@ async function scanPluginRoutes(projectRoot, projectRoutes) {
   const projectPaths = new Set(projectRoutes.map((r) => r.rawRoute));
   const pluginRoutes = [];
   for (const [, plugin] of plugins) {
-    if (!plugin.manifest.routes)
-      continue;
+    if (!plugin.manifest.routes) continue;
     for (const route of plugin.manifest.routes) {
       if (projectPaths.has(route.path)) {
         getLogger().info(
@@ -2303,8 +2345,14 @@ async function scanPluginRoutes(projectRoot, projectRoutes) {
       const isLocalComponent = route.component.startsWith(".");
       const compPath = isLocalComponent ? path__default.resolve(plugin.pluginPath, route.component) : resolvePluginModule(plugin);
       const componentExport = isLocalComponent ? void 0 : route.component;
-      pluginRoutes.push(createRoute(route.path, jayHtmlPath, compPath, componentExport));
-      getLogger().info(`[Routes] Plugin "${plugin.name}" provides route ${route.path}`);
+      pluginRoutes.push(
+        createRoute(route.path, jayHtmlPath, compPath, componentExport, {
+          devOnly: route.devOnly === true
+        })
+      );
+      getLogger().info(
+        `[Routes] Plugin "${plugin.name}" provides route ${route.path}${route.devOnly ? " (dev-only)" : ""}`
+      );
     }
   }
   return pluginRoutes;
@@ -2346,8 +2394,7 @@ function resolvePluginModule(plugin) {
       const mainPath = typeof mainExport === "string" ? mainExport : mainExport?.default || mainExport?.import || pkg.main;
       if (mainPath) {
         const resolved = path__default.join(plugin.pluginPath, mainPath);
-        if (fsSync__default.existsSync(resolved))
-          return resolved;
+        if (fsSync__default.existsSync(resolved)) return resolved;
       }
     } catch {
     }
@@ -2400,8 +2447,7 @@ function handleOtherResponseCodes(res, renderedResult) {
     res.status(renderedResult.status).end("server error");
   else if (renderedResult.kind === `ClientError`)
     res.status(renderedResult.status).end("client error");
-  else
-    res.status(renderedResult.status).end("redirect to " + renderedResult.location);
+  else res.status(renderedResult.status).end("redirect to " + renderedResult.location);
 }
 function filterPluginsForPage(allPluginClientInits, allPluginsWithInit, usedPackages) {
   const pluginsByPackage = /* @__PURE__ */ new Map();
@@ -2418,8 +2464,7 @@ function filterPluginsForPage(allPluginClientInits, allPluginsWithInit, usedPack
   while (toProcess.length > 0) {
     const packageName = toProcess.pop();
     const plugin = pluginsByPackage.get(packageName);
-    if (!plugin)
-      continue;
+    if (!plugin) continue;
     for (const dep of plugin.dependencies) {
       if (pluginsByPackage.has(dep) && !expandedPackages.has(dep)) {
         expandedPackages.add(dep);
@@ -2606,6 +2651,7 @@ async function handleCachedRequest(vite, route, options, cachedEntry, pageParams
     fastViewState,
     clientTrackByMap || {}
   );
+  injectJayBindings(fullViewState, pageParams, url);
   await sendResponse(
     vite,
     res,
@@ -2803,6 +2849,7 @@ async function handleClientOnlyRequest(vite, route, options, slowlyPhase, pagePa
     renderedFast.rendered,
     serverTrackByMap || {}
   );
+  injectJayBindings(viewState, pageParams, url);
   const fastCF = renderedFast.carryForward;
   const pageHtml = await generateClientScript(
     viewState,
@@ -2886,6 +2933,11 @@ async function sendResponse(vite, res, url, jayHtmlPath, sourceJayHtmlPath, page
     await fs__default.mkdir(clientScriptDir, { recursive: true });
     await fs__default.writeFile(path__default.join(clientScriptDir, `${pageName}.html`), pageHtml, "utf-8");
   }
+  for (const [id, mod] of vite.moduleGraph.idToModuleMap) {
+    if (id.includes("html-proxy")) {
+      vite.moduleGraph.invalidateModule(mod);
+    }
+  }
   const viteStart = Date.now();
   const compiledPageHtml = await vite.transformIndexHtml(!!url ? url : "/", pageHtml);
   timing?.recordViteClient(Date.now() - viteStart);
@@ -2953,8 +3005,7 @@ async function preRenderJayHtml(route, slowViewState, headlessContracts, headles
   try {
     const contractContent = await fs__default.readFile(contractPath, "utf-8");
     const parseResult = parseContract(contractContent, path__default.basename(contractPath));
-    if (parseResult.val)
-      contract = parseResult.val;
+    if (parseResult.val) contract = parseResult.val;
   } catch {
   }
   const result = slowRenderTransform({
@@ -3052,8 +3103,7 @@ async function mkDevServer(rawOptions) {
     try {
       const entries = await fs__default.readdir(buildFolder).catch(() => []);
       for (const entry of entries) {
-        if (entry === "freezes")
-          continue;
+        if (entry === "freezes") continue;
         await fs__default.rm(path__default.join(buildFolder, entry), { recursive: true, force: true });
       }
     } catch {
@@ -3127,8 +3177,7 @@ async function mkDevServer(rawOptions) {
     const existingRawRoutes = new Set(devServerRoutes.map((r) => r.fsRoute.rawRoute));
     const added = [];
     for (const jayRoute of scannedJayRoutes) {
-      if (existingRawRoutes.has(jayRoute.rawRoute))
-        continue;
+      if (existingRawRoutes.has(jayRoute.rawRoute)) continue;
       const devRoute = mkRoute(
         jayRoute,
         vite,
@@ -3230,6 +3279,13 @@ function setupFreezeEndpoint(vite, freezeStore) {
   });
   getLogger().info("[Freeze] Freeze endpoint mounted at /_jay/freeze");
 }
+function injectJayBindings(viewState, params, url) {
+  const urlPath = url.split("?")[0];
+  viewState.__jay = {
+    params,
+    url: { path: urlPath.startsWith("/") ? urlPath : "/" + urlPath }
+  };
+}
 function getRouteDir(route) {
   return route.rawRoute.replace(/^\//, "") || "index";
 }
@@ -3238,8 +3294,7 @@ function getRoutePrefix(jayHtmlPath, pagesRootFolder) {
   const segments = rel.split(path__default.sep).filter(Boolean);
   const staticSegments = [];
   for (const seg of segments) {
-    if (seg.startsWith("["))
-      break;
+    if (seg.startsWith("[")) break;
     staticSegments.push(seg);
   }
   return "/" + staticSegments.join("/");
@@ -3264,8 +3319,7 @@ function setupSlowRenderCacheInvalidation(vite, cache, pagesRootFolder, projectR
         getLogger().info(`[SlowRender] Watching: ${file}`);
       }
       if (routePrefix) {
-        if (!fileToRoutes.has(file))
-          fileToRoutes.set(file, /* @__PURE__ */ new Set());
+        if (!fileToRoutes.has(file)) fileToRoutes.set(file, /* @__PURE__ */ new Set());
         fileToRoutes.get(file).add(routePrefix);
       }
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jay-framework/dev-server",
-  "version": "0.22.2",
+  "version": "0.23.1",
   "type": "module",
   "license": "Apache-2.0",
   "main": "dist/index.js",
@@ -23,23 +23,23 @@
     "test:watch": "vitest"
   },
   "dependencies": {
-    "@jay-framework/compiler-jay-stack": "^0.22.2",
-    "@jay-framework/compiler-shared": "^0.22.2",
-    "@jay-framework/component": "^0.22.2",
-    "@jay-framework/fullstack-component": "^0.22.2",
-    "@jay-framework/logger": "^0.22.2",
-    "@jay-framework/runtime": "^0.22.2",
-    "@jay-framework/stack-client-runtime": "^0.22.2",
-    "@jay-framework/stack-route-scanner": "^0.22.2",
-    "@jay-framework/stack-server-runtime": "^0.22.2",
-    "@jay-framework/view-state-merge": "^0.22.2",
+    "@jay-framework/compiler-jay-stack": "^0.23.1",
+    "@jay-framework/compiler-shared": "^0.23.1",
+    "@jay-framework/component": "^0.23.1",
+    "@jay-framework/fullstack-component": "^0.23.1",
+    "@jay-framework/logger": "^0.23.1",
+    "@jay-framework/runtime": "^0.23.1",
+    "@jay-framework/stack-client-runtime": "^0.23.1",
+    "@jay-framework/stack-route-scanner": "^0.23.1",
+    "@jay-framework/stack-server-runtime": "^0.23.1",
+    "@jay-framework/view-state-merge": "^0.23.1",
     "busboy": "^1.6.0",
     "vite": "^5.0.11"
   },
   "devDependencies": {
-    "@jay-framework/dev-environment": "^0.22.2",
-    "@jay-framework/jay-cli": "^0.22.2",
-    "@jay-framework/stack-client-runtime": "^0.22.2",
+    "@jay-framework/dev-environment": "^0.23.1",
+    "@jay-framework/jay-cli": "^0.23.1",
+    "@jay-framework/stack-client-runtime": "^0.23.1",
     "@playwright/test": "^1.58.2",
     "@types/busboy": "^1.5.4",
     "@types/express": "^5.0.2",