@jay-framework/dev-server 0.22.1 → 0.23.0

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

@@ -616,7 +616,8 @@ 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) {
@@ -630,14 +631,29 @@ function shouldRemoveMethod(methodName, environment) {
     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 +663,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 +844,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 +858,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);
   };
@@ -2239,12 +2267,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 }
     }));
   }
   /**
@@ -2303,8 +2332,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;
@@ -2606,6 +2641,7 @@ async function handleCachedRequest(vite, route, options, cachedEntry, pageParams
     fastViewState,
     clientTrackByMap || {}
   );
+  injectJayBindings(fullViewState, pageParams, url);
   await sendResponse(
     vite,
     res,
@@ -2803,6 +2839,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 +2923,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);
@@ -3230,6 +3272,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";
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jay-framework/dev-server",
-  "version": "0.22.1",
+  "version": "0.23.0",
   "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.1",
-    "@jay-framework/compiler-shared": "^0.22.1",
-    "@jay-framework/component": "^0.22.1",
-    "@jay-framework/fullstack-component": "^0.22.1",
-    "@jay-framework/logger": "^0.22.1",
-    "@jay-framework/runtime": "^0.22.1",
-    "@jay-framework/stack-client-runtime": "^0.22.1",
-    "@jay-framework/stack-route-scanner": "^0.22.1",
-    "@jay-framework/stack-server-runtime": "^0.22.1",
-    "@jay-framework/view-state-merge": "^0.22.1",
+    "@jay-framework/compiler-jay-stack": "^0.23.0",
+    "@jay-framework/compiler-shared": "^0.23.0",
+    "@jay-framework/component": "^0.23.0",
+    "@jay-framework/fullstack-component": "^0.23.0",
+    "@jay-framework/logger": "^0.23.0",
+    "@jay-framework/runtime": "^0.23.0",
+    "@jay-framework/stack-client-runtime": "^0.23.0",
+    "@jay-framework/stack-route-scanner": "^0.23.0",
+    "@jay-framework/stack-server-runtime": "^0.23.0",
+    "@jay-framework/view-state-merge": "^0.23.0",
     "busboy": "^1.6.0",
     "vite": "^5.0.11"
   },
   "devDependencies": {
-    "@jay-framework/dev-environment": "^0.22.1",
-    "@jay-framework/jay-cli": "^0.22.1",
-    "@jay-framework/stack-client-runtime": "^0.22.1",
+    "@jay-framework/dev-environment": "^0.23.0",
+    "@jay-framework/jay-cli": "^0.23.0",
+    "@jay-framework/stack-client-runtime": "^0.23.0",
     "@playwright/test": "^1.58.2",
     "@types/busboy": "^1.5.4",
     "@types/express": "^5.0.2",