@evjs/build-tools 0.0.0

package/README.md

@@ -0,0 +1,99 @@
+# @evjs/build-tools
+
+Bundler-agnostic build utilities for the **ev** framework. Contains all core logic for server function handling, decoupled from any specific bundler.
+
+## Installation
+
+```bash
+npm install @evjs/build-tools
+```
+
+## Exports
+
+| Export | Description |
+|--------|-------------|
+| `generateServerEntry(config, modules)` | Generate server entry source from discovered modules |
+| `transformServerFile(source, options)` | SWC-based transform for `"use server"` files |
+| `detectUseServer(source)` | Check if a file starts with the `"use server"` directive |
+| `makeFnId(root, path, name)` | Derive a stable SHA-256 function ID |
+| `parseModuleRef(ref)` | Parse `"module#export"` reference strings |
+| `ServerEntryConfig` | Config type for server entry generation |
+| `TransformOptions` | Options type for file transformation |
+
+## Usage
+
+This package is consumed by bundler adapters (e.g., `@evjs/webpack-plugin`), not directly by application code.
+
+```ts
+import {
+  generateServerEntry,
+  transformServerFile,
+  detectUseServer,
+} from "@evjs/build-tools";
+
+// Generate server entry source
+const entrySource = generateServerEntry(
+  { appFactory: "@evjs/runtime/server#createApp" },
+  ["/path/to/api/users.server.ts"],
+);
+
+// Transform a "use server" file for client build
+const clientStub = await transformServerFile(source, {
+  resourcePath: "/path/to/api/users.server.ts",
+  rootContext: "/path/to/project",
+  isServer: false,
+});
+```
+
+## Architecture
+
+### Transform Pipeline
+
+`transformServerFile()` parses the source with SWC, extracts exported function names via AST traversal, then delegates to the appropriate transform:
+
+- **Client transform** — replaces function bodies with `__fn_call(fnId, args)` transport stubs and registers them via `__fn_register()` for query cache keys.
+- **Server transform** — keeps original source, prepends the `registerServerFn` import, and appends registration calls for each export.
+
+### Entry Generation
+
+`generateServerEntry()` produces a self-contained server entry that imports all discovered `"use server"` modules, creates a Hono app via `createApp()`, and optionally invokes a backend (e.g., `serve`) for self-starting bundles.
+
+### Code Emitter
+
+All generated code passes through `emitCode()` — a SWC `parseSync → printSync` roundtrip that validates syntax at build time and produces consistently formatted output.
+
+### RUNTIME Constants
+
+All runtime identifiers (module paths, function names, property names) are centralized in a single `RUNTIME` constant — no hardcoded strings in templates:
+
+```ts
+RUNTIME.serverModule          // "@evjs/runtime/server/register"
+RUNTIME.appModule             // "@evjs/runtime/server"
+RUNTIME.clientTransportModule // "@evjs/runtime/client/transport"
+RUNTIME.registerServerFn      // "registerServerFn"
+RUNTIME.clientCall            // "__fn_call"
+RUNTIME.clientRegister        // "__fn_register"
+```
+
+## Bundler Adapter Pattern
+
+```
+@evjs/build-tools (pure functions)     Bundler Adapters
+────────────────────────────────       ─────────────────
+• generateServerEntry()                @evjs/webpack-plugin
+• transformServerFile()                  → EvWebpackPlugin
+• detectUseServer()                      → server-fn-loader
+• makeFnId()
+• parseModuleRef()                     (future: @evjs/vite-plugin)
+```
+
+## Key Files
+
+| File | Purpose |
+|------|---------|
+| `src/transforms/index.ts` | `transformServerFile` — main transform |
+| `src/transforms/client/` | Client-side SWC transform (stub generation) |
+| `src/transforms/server/` | Server-side SWC transform (registration) |
+| `src/entry.ts` | `generateServerEntry` |
+| `src/utils.ts` | `makeFnId`, `parseModuleRef`, `detectUseServer` |
+| `src/types.ts` | Type definitions |

package/esm/codegen.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Parse source code and re-emit via SWC for consistent formatting.
+ * Validates the code is syntactically correct at build time.
+ */
+export declare function emitCode(source: string): string;
+//# sourceMappingURL=codegen.d.ts.map

package/esm/codegen.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codegen.d.ts","sourceRoot":"","sources":["../src/codegen.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAG/C"}

package/esm/codegen.js

@@ -0,0 +1,10 @@
+import { parseSync, printSync } from "@swc/core";
+/**
+ * Parse source code and re-emit via SWC for consistent formatting.
+ * Validates the code is syntactically correct at build time.
+ */
+export function emitCode(source) {
+    const ast = parseSync(source, { syntax: "ecmascript" });
+    return printSync(ast, { jsc: { target: "esnext" } }).code;
+}
+//# sourceMappingURL=codegen.js.map

package/esm/codegen.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"codegen.js","sourceRoot":"","sources":["../src/codegen.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAEjD;;;GAGG;AACH,MAAM,UAAU,QAAQ,CAAC,MAAc;IACrC,MAAM,GAAG,GAAG,SAAS,CAAC,MAAM,EAAE,EAAE,MAAM,EAAE,YAAY,EAAE,CAAC,CAAC;IACxD,OAAO,SAAS,CAAC,GAAG,EAAE,EAAE,GAAG,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC;AAC5D,CAAC"}

package/esm/entry.d.ts

@@ -0,0 +1,18 @@
+import { type ServerEntryConfig } from "./types.js";
+/**
+ * Generate the server entry source code from discovered server modules.
+ *
+ * The generated entry:
+ * 1. Imports user's "use server" modules (registering functions as side effects)
+ * 2. Re-exports them as named exports (_fns_0, _fns_1, ...)
+ * 3. Re-exports `createApp` so the adapter can create a Hono app that
+ *    shares the same function registry
+ *
+ * The adapter layer (node/ecma) handles server startup.
+ *
+ * @param config - Server entry configuration (setup imports)
+ * @param serverModulePaths - Absolute paths to discovered "use server" modules
+ * @returns The generated server entry source code string
+ */
+export declare function generateServerEntry(config: ServerEntryConfig | undefined, serverModulePaths: string[]): string;
+//# sourceMappingURL=entry.d.ts.map

package/esm/entry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"entry.d.ts","sourceRoot":"","sources":["../src/entry.ts"],"names":[],"mappings":"AACA,OAAO,EAAW,KAAK,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAE7D;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,iBAAiB,GAAG,SAAS,EACrC,iBAAiB,EAAE,MAAM,EAAE,GAC1B,MAAM,CAkBR"}

package/esm/entry.js

@@ -0,0 +1,33 @@
+import { emitCode } from "./codegen.js";
+import { RUNTIME } from "./types.js";
+/**
+ * Generate the server entry source code from discovered server modules.
+ *
+ * The generated entry:
+ * 1. Imports user's "use server" modules (registering functions as side effects)
+ * 2. Re-exports them as named exports (_fns_0, _fns_1, ...)
+ * 3. Re-exports `createApp` so the adapter can create a Hono app that
+ *    shares the same function registry
+ *
+ * The adapter layer (node/ecma) handles server startup.
+ *
+ * @param config - Server entry configuration (setup imports)
+ * @param serverModulePaths - Absolute paths to discovered "use server" modules
+ * @returns The generated server entry source code string
+ */
+export function generateServerEntry(config, serverModulePaths) {
+    const moduleImports = serverModulePaths
+        .map((p, i) => `import * as _fns_${i} from ${JSON.stringify(p)};`)
+        .join("\n");
+    const fnsExports = serverModulePaths.map((_p, i) => `_fns_${i}`);
+    const allExports = [...fnsExports];
+    return emitCode([
+        `export { createApp } from "${RUNTIME.appModule}";`,
+        ...(config?.middleware ?? []),
+        moduleImports,
+        allExports.length ? `export { ${allExports.join(", ")} };` : "",
+    ]
+        .filter(Boolean)
+        .join("\n"));
+}
+//# sourceMappingURL=entry.js.map

package/esm/entry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"entry.js","sourceRoot":"","sources":["../src/entry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AACxC,OAAO,EAAE,OAAO,EAA0B,MAAM,YAAY,CAAC;AAE7D;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,mBAAmB,CACjC,MAAqC,EACrC,iBAA2B;IAE3B,MAAM,aAAa,GAAG,iBAAiB;SACpC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,oBAAoB,CAAC,SAAS,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC;SACjE,IAAI,CAAC,IAAI,CAAC,CAAC;IAEd,MAAM,UAAU,GAAG,iBAAiB,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;IACjE,MAAM,UAAU,GAAG,CAAC,GAAG,UAAU,CAAC,CAAC;IAEnC,OAAO,QAAQ,CACb;QACE,8BAA8B,OAAO,CAAC,SAAS,IAAI;QACnD,GAAG,CAAC,MAAM,EAAE,UAAU,IAAI,EAAE,CAAC;QAC7B,aAAa;QACb,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,YAAY,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE;KAChE;SACE,MAAM,CAAC,OAAO,CAAC;SACf,IAAI,CAAC,IAAI,CAAC,CACd,CAAC;AACJ,CAAC"}

package/esm/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Bundler-agnostic build utilities for the ev framework.
+ */
+export { generateServerEntry } from "./entry.js";
+export type { TransformResult } from "./transforms/index.js";
+export { transformServerFile } from "./transforms/index.js";
+export type { ServerEntryConfig, TransformOptions } from "./types.js";
+export { detectUseServer, hashString, makeFnId, makeModuleId, parseModuleRef, } from "./utils.js";
+//# sourceMappingURL=index.d.ts.map

package/esm/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AACjD,YAAY,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,YAAY,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AACtE,OAAO,EACL,eAAe,EACf,UAAU,EACV,QAAQ,EACR,YAAY,EACZ,cAAc,GACf,MAAM,YAAY,CAAC"}

package/esm/index.js

@@ -0,0 +1,7 @@
+/**
+ * Bundler-agnostic build utilities for the ev framework.
+ */
+export { generateServerEntry } from "./entry.js";
+export { transformServerFile } from "./transforms/index.js";
+export { detectUseServer, hashString, makeFnId, makeModuleId, parseModuleRef, } from "./utils.js";
+//# sourceMappingURL=index.js.map

package/esm/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAEjD,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAE5D,OAAO,EACL,eAAe,EACf,UAAU,EACV,QAAQ,EACR,YAAY,EACZ,cAAc,GACf,MAAM,YAAY,CAAC"}

package/esm/transforms/client/index.d.ts

@@ -0,0 +1,5 @@
+import { type Module } from "@swc/core";
+import { type TransformOptions } from "../../types.js";
+/** Client build: replace function bodies with __fn_call transport stubs via AST replacement. */
+export declare function buildClientOutput(program: Module, exportNames: string[], options: TransformOptions): Module;
+//# sourceMappingURL=index.d.ts.map

package/esm/transforms/client/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/transforms/client/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,MAAM,EAAa,MAAM,WAAW,CAAC;AACnD,OAAO,EAAW,KAAK,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAGhE,gGAAgG;AAChG,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,MAAM,EAAE,EACrB,OAAO,EAAE,gBAAgB,GACxB,MAAM,CAoBR"}

package/esm/transforms/client/index.js

@@ -0,0 +1,21 @@
+import { parseSync } from "@swc/core";
+import { RUNTIME } from "../../types.js";
+import { makeFnId } from "../../utils.js";
+/** Client build: replace function bodies with __fn_call transport stubs via AST replacement. */
+export function buildClientOutput(program, exportNames, options) {
+    const stubs = exportNames.map((name) => {
+        const fnId = JSON.stringify(makeFnId(options.rootContext, options.resourcePath, name));
+        return [
+            `export function ${name}(...args) { return ${RUNTIME.clientCall}(${fnId}, args); }`,
+            `${RUNTIME.clientRegister}(${name}, ${fnId}, ${JSON.stringify(name)});`,
+        ].join("\n");
+    });
+    const injectCode = [
+        `import { ${RUNTIME.clientCall}, ${RUNTIME.clientRegister} } from "${RUNTIME.clientTransportModule}";`,
+        ...stubs,
+    ].join("\n");
+    const injectAst = parseSync(injectCode, { syntax: "ecmascript" });
+    program.body = injectAst.body;
+    return program;
+}
+//# sourceMappingURL=index.js.map

package/esm/transforms/client/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/transforms/client/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAe,SAAS,EAAE,MAAM,WAAW,CAAC;AACnD,OAAO,EAAE,OAAO,EAAyB,MAAM,gBAAgB,CAAC;AAChE,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE1C,gGAAgG;AAChG,MAAM,UAAU,iBAAiB,CAC/B,OAAe,EACf,WAAqB,EACrB,OAAyB;IAEzB,MAAM,KAAK,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;QACrC,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CACzB,QAAQ,CAAC,OAAO,CAAC,WAAW,EAAE,OAAO,CAAC,YAAY,EAAE,IAAI,CAAC,CAC1D,CAAC;QACF,OAAO;YACL,mBAAmB,IAAI,sBAAsB,OAAO,CAAC,UAAU,IAAI,IAAI,YAAY;YACnF,GAAG,OAAO,CAAC,cAAc,IAAI,IAAI,KAAK,IAAI,KAAK,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI;SACxE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACf,CAAC,CAAC,CAAC;IAEH,MAAM,UAAU,GAAG;QACjB,YAAY,OAAO,CAAC,UAAU,KAAK,OAAO,CAAC,cAAc,YAAY,OAAO,CAAC,qBAAqB,IAAI;QACtG,GAAG,KAAK;KACT,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAEb,MAAM,SAAS,GAAG,SAAS,CAAC,UAAU,EAAE,EAAE,MAAM,EAAE,YAAY,EAAE,CAAC,CAAC;IAClE,OAAO,CAAC,IAAI,GAAG,SAAS,CAAC,IAAI,CAAC;IAE9B,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/esm/transforms/index.d.ts

@@ -0,0 +1,14 @@
+import type { TransformOptions } from "../types.js";
+export interface TransformResult {
+    code: string;
+    map?: string;
+}
+/**
+ * Transform a "use server" file for either client or server builds.
+ * This is a pure function with no bundler dependency.
+ *
+ * - **Server**: keeps original source + appends `registerServerFn()` calls
+ * - **Client**: replaces function bodies with `__fn_call()` transport stubs
+ */
+export declare function transformServerFile(source: string, options: TransformOptions): Promise<TransformResult>;
+//# sourceMappingURL=index.d.ts.map

package/esm/transforms/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/transforms/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAMpD,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED;;;;;;GAMG;AACH,wBAAsB,mBAAmB,CACvC,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,gBAAgB,GACxB,OAAO,CAAC,eAAe,CAAC,CA+B1B"}

package/esm/transforms/index.js

@@ -0,0 +1,40 @@
+import { parse, printSync } from "@swc/core";
+import { detectUseServer } from "../utils.js";
+import { buildClientOutput } from "./client/index.js";
+import { buildServerOutput } from "./server/index.js";
+import { extractExportNames } from "./utils.js";
+/**
+ * Transform a "use server" file for either client or server builds.
+ * This is a pure function with no bundler dependency.
+ *
+ * - **Server**: keeps original source + appends `registerServerFn()` calls
+ * - **Client**: replaces function bodies with `__fn_call()` transport stubs
+ */
+export async function transformServerFile(source, options) {
+    if (!detectUseServer(source)) {
+        return { code: source };
+    }
+    const program = await parse(source, {
+        syntax: "typescript",
+        tsx: true,
+        comments: false,
+        script: false,
+        target: "esnext",
+    });
+    const exportNames = extractExportNames(program.body);
+    if (exportNames.length === 0) {
+        return { code: source };
+    }
+    const modifiedAst = options.isServer
+        ? buildServerOutput(program, exportNames, options)
+        : buildClientOutput(program, exportNames, options);
+    const { code, map } = printSync(modifiedAst, {
+        sourceMaps: true,
+        inlineSourcesContent: true,
+        filename: options.resourcePath,
+        sourceFileName: options.resourcePath,
+        jsc: { target: "esnext" },
+    });
+    return { code, map };
+}
+//# sourceMappingURL=index.js.map

package/esm/transforms/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/transforms/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAE7C,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAOhD;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,MAAc,EACd,OAAyB;IAEzB,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,EAAE,CAAC;QAC7B,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;IAC1B,CAAC;IAED,MAAM,OAAO,GAAG,MAAM,KAAK,CAAC,MAAM,EAAE;QAClC,MAAM,EAAE,YAAY;QACpB,GAAG,EAAE,IAAI;QACT,QAAQ,EAAE,KAAK;QACf,MAAM,EAAE,KAAK;QACb,MAAM,EAAE,QAAQ;KACjB,CAAC,CAAC;IAEH,MAAM,WAAW,GAAG,kBAAkB,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IACrD,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC7B,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;IAC1B,CAAC;IAED,MAAM,WAAW,GAAG,OAAO,CAAC,QAAQ;QAClC,CAAC,CAAC,iBAAiB,CAAC,OAAO,EAAE,WAAW,EAAE,OAAO,CAAC;QAClD,CAAC,CAAC,iBAAiB,CAAC,OAAO,EAAE,WAAW,EAAE,OAAO,CAAC,CAAC;IAErD,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,GAAG,SAAS,CAAC,WAAW,EAAE;QAC3C,UAAU,EAAE,IAAI;QAChB,oBAAoB,EAAE,IAAI;QAC1B,QAAQ,EAAE,OAAO,CAAC,YAAY;QAC9B,cAAc,EAAE,OAAO,CAAC,YAAY;QACpC,GAAG,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE;KAC1B,CAAC,CAAC;IAEH,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC;AACvB,CAAC"}

package/esm/transforms/server/index.d.ts

@@ -0,0 +1,5 @@
+import { type Module } from "@swc/core";
+import { type TransformOptions } from "../../types.js";
+/** Server build: inject import and appends registrations as AST nodes. */
+export declare function buildServerOutput(program: Module, exportNames: string[], options: TransformOptions): Module;
+//# sourceMappingURL=index.d.ts.map

package/esm/transforms/server/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/transforms/server/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,MAAM,EAAa,MAAM,WAAW,CAAC;AACnD,OAAO,EAAW,KAAK,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAgBhE,0EAA0E;AAC1E,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,MAAM,EAAE,EACrB,OAAO,EAAE,gBAAgB,GACxB,MAAM,CA4BR"}

package/esm/transforms/server/index.js

@@ -0,0 +1,36 @@
+import { parseSync } from "@swc/core";
+import { RUNTIME } from "../../types.js";
+import { makeFnId, makeModuleId } from "../../utils.js";
+/** Notify the manifest collector about each server function. */
+function reportToManifest(exportNames, options) {
+    if (!options.onServerFn)
+        return;
+    const moduleId = makeModuleId(options.rootContext, options.resourcePath);
+    for (const name of exportNames) {
+        const fnId = makeFnId(options.rootContext, options.resourcePath, name);
+        options.onServerFn(fnId, { moduleId, export: name });
+    }
+}
+/** Server build: inject import and appends registrations as AST nodes. */
+export function buildServerOutput(program, exportNames, options) {
+    reportToManifest(exportNames, options);
+    const registrations = exportNames.map((name) => {
+        const fnId = JSON.stringify(makeFnId(options.rootContext, options.resourcePath, name));
+        return `${RUNTIME.registerServerFn}(${fnId}, ${name});`;
+    });
+    const injectCode = [
+        `import { ${RUNTIME.registerServerFn} } from "${RUNTIME.serverModule}";`,
+        ...registrations,
+    ].join("\n");
+    const injectAst = parseSync(injectCode, { syntax: "ecmascript" });
+    // Prepend import
+    if (injectAst.body.length > 0) {
+        program.body.unshift(injectAst.body[0]);
+    }
+    // Append registrations
+    for (let i = 1; i < injectAst.body.length; i++) {
+        program.body.push(injectAst.body[i]);
+    }
+    return program;
+}
+//# sourceMappingURL=index.js.map

package/esm/transforms/server/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/transforms/server/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAe,SAAS,EAAE,MAAM,WAAW,CAAC;AACnD,OAAO,EAAE,OAAO,EAAyB,MAAM,gBAAgB,CAAC;AAChE,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAExD,gEAAgE;AAChE,SAAS,gBAAgB,CACvB,WAAqB,EACrB,OAAyB;IAEzB,IAAI,CAAC,OAAO,CAAC,UAAU;QAAE,OAAO;IAChC,MAAM,QAAQ,GAAG,YAAY,CAAC,OAAO,CAAC,WAAW,EAAE,OAAO,CAAC,YAAY,CAAC,CAAC;IACzE,KAAK,MAAM,IAAI,IAAI,WAAW,EAAE,CAAC;QAC/B,MAAM,IAAI,GAAG,QAAQ,CAAC,OAAO,CAAC,WAAW,EAAE,OAAO,CAAC,YAAY,EAAE,IAAI,CAAC,CAAC;QACvE,OAAO,CAAC,UAAU,CAAC,IAAI,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;IACvD,CAAC;AACH,CAAC;AAED,0EAA0E;AAC1E,MAAM,UAAU,iBAAiB,CAC/B,OAAe,EACf,WAAqB,EACrB,OAAyB;IAEzB,gBAAgB,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;IAEvC,MAAM,aAAa,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;QAC7C,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CACzB,QAAQ,CAAC,OAAO,CAAC,WAAW,EAAE,OAAO,CAAC,YAAY,EAAE,IAAI,CAAC,CAC1D,CAAC;QACF,OAAO,GAAG,OAAO,CAAC,gBAAgB,IAAI,IAAI,KAAK,IAAI,IAAI,CAAC;IAC1D,CAAC,CAAC,CAAC;IAEH,MAAM,UAAU,GAAG;QACjB,YAAY,OAAO,CAAC,gBAAgB,YAAY,OAAO,CAAC,YAAY,IAAI;QACxE,GAAG,aAAa;KACjB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAEb,MAAM,SAAS,GAAG,SAAS,CAAC,UAAU,EAAE,EAAE,MAAM,EAAE,YAAY,EAAE,CAAC,CAAC;IAElE,iBAAiB;IACjB,IAAI,SAAS,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC9B,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;IAC1C,CAAC;IAED,uBAAuB;IACvB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,SAAS,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QAC/C,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;IACvC,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/esm/transforms/utils.d.ts

@@ -0,0 +1,4 @@
+import type { ModuleItem } from "@swc/types";
+/** Extract exported function/variable names from a parsed SWC module. */
+export declare function extractExportNames(body: ModuleItem[]): string[];
+//# sourceMappingURL=utils.d.ts.map

package/esm/transforms/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/transforms/utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7C,yEAAyE;AACzE,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,UAAU,EAAE,GAAG,MAAM,EAAE,CA4B/D"}

package/esm/transforms/utils.js

@@ -0,0 +1,32 @@
+/** Extract exported function/variable names from a parsed SWC module. */
+export function extractExportNames(body) {
+    const names = [];
+    for (const item of body) {
+        if (item.type === "ExportDeclaration") {
+            const decl = item.declaration;
+            if (decl.type === "FunctionDeclaration") {
+                if (decl.identifier.value)
+                    names.push(decl.identifier.value);
+            }
+            else if (decl.type === "VariableDeclaration") {
+                for (const v of decl.declarations) {
+                    if (v.id.type === "Identifier") {
+                        names.push(v.id.value);
+                    }
+                }
+            }
+        }
+        else if (item.type === "ExportNamedDeclaration") {
+            for (const specifier of item.specifiers) {
+                if (specifier.type === "ExportSpecifier") {
+                    const exported = specifier.exported ?? specifier.orig;
+                    if (exported.type === "Identifier") {
+                        names.push(exported.value);
+                    }
+                }
+            }
+        }
+    }
+    return names;
+}
+//# sourceMappingURL=utils.js.map

package/esm/transforms/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../src/transforms/utils.ts"],"names":[],"mappings":"AAEA,yEAAyE;AACzE,MAAM,UAAU,kBAAkB,CAAC,IAAkB;IACnD,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,KAAK,MAAM,IAAI,IAAI,IAAI,EAAE,CAAC;QACxB,IAAI,IAAI,CAAC,IAAI,KAAK,mBAAmB,EAAE,CAAC;YACtC,MAAM,IAAI,GAAG,IAAI,CAAC,WAAW,CAAC;YAC9B,IAAI,IAAI,CAAC,IAAI,KAAK,qBAAqB,EAAE,CAAC;gBACxC,IAAI,IAAI,CAAC,UAAU,CAAC,KAAK;oBAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;YAC/D,CAAC;iBAAM,IAAI,IAAI,CAAC,IAAI,KAAK,qBAAqB,EAAE,CAAC;gBAC/C,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;oBAClC,IAAI,CAAC,CAAC,EAAE,CAAC,IAAI,KAAK,YAAY,EAAE,CAAC;wBAC/B,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC;oBACzB,CAAC;gBACH,CAAC;YACH,CAAC;QACH,CAAC;aAAM,IAAI,IAAI,CAAC,IAAI,KAAK,wBAAwB,EAAE,CAAC;YAClD,KAAK,MAAM,SAAS,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;gBACxC,IAAI,SAAS,CAAC,IAAI,KAAK,iBAAiB,EAAE,CAAC;oBACzC,MAAM,QAAQ,GAAG,SAAS,CAAC,QAAQ,IAAI,SAAS,CAAC,IAAI,CAAC;oBACtD,IAAI,QAAQ,CAAC,IAAI,KAAK,YAAY,EAAE,CAAC;wBACnC,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;oBAC7B,CAAC;gBACH,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC"}

package/esm/types.d.ts

@@ -0,0 +1,46 @@
+/** Configuration for the generated server entry. */
+export interface ServerEntryConfig {
+    /**
+     * Middleware module paths to auto-register in the server entry.
+     */
+    middleware?: string[];
+}
+/** Options for transforming a "use server" file. */
+export interface TransformOptions {
+    /** Absolute path to the source file. */
+    resourcePath: string;
+    /** Root directory of the project. */
+    rootContext: string;
+    /** Whether this is a server-side build. */
+    isServer: boolean;
+    /** Callback to register a server function in the manifest. */
+    onServerFn?: (fnId: string, meta: {
+        moduleId: string;
+        export: string;
+    }) => void;
+}
+/**
+ * Runtime identifiers used in generated code.
+ *
+ * These are build-time constants — the actual module paths and function names
+ * that appear in codegen output. They must stay in sync with the `@evjs/runtime`
+ * package exports.
+ *
+ * Note: `DEFAULT_ENDPOINT` (the default HTTP path for server functions) is a runtime
+ * concern and lives in `@evjs/runtime/src/constants.ts`, not here.
+ */
+export declare const RUNTIME: {
+    /** Module path for server-side function registration (no Hono dependency). */
+    readonly serverModule: "@evjs/runtime/server/register";
+    /** Module path for the server app factory (Hono app + server function handler). */
+    readonly appModule: "@evjs/runtime/server";
+    /** Module path for client-side transport stubs. */
+    readonly clientTransportModule: "@evjs/runtime/client/transport";
+    /** Server function registration call name. */
+    readonly registerServerFn: "registerServerFn";
+    /** Client-side server function call name. */
+    readonly clientCall: "__fn_call";
+    /** Client-side function registration call name. */
+    readonly clientRegister: "__fn_register";
+};
+//# sourceMappingURL=types.d.ts.map

package/esm/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,oDAAoD;AACpD,MAAM,WAAW,iBAAiB;IAChC;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;CACvB;AAED,oDAAoD;AACpD,MAAM,WAAW,gBAAgB;IAC/B,wCAAwC;IACxC,YAAY,EAAE,MAAM,CAAC;IACrB,qCAAqC;IACrC,WAAW,EAAE,MAAM,CAAC;IACpB,2CAA2C;IAC3C,QAAQ,EAAE,OAAO,CAAC;IAClB,8DAA8D;IAC9D,UAAU,CAAC,EAAE,CACX,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,KACvC,IAAI,CAAC;CACX;AAED;;;;;;;;;GASG;AACH,eAAO,MAAM,OAAO;IAClB,8EAA8E;;IAE9E,mFAAmF;;IAEnF,mDAAmD;;IAEnD,8CAA8C;;IAE9C,6CAA6C;;IAE7C,mDAAmD;;CAE3C,CAAC"}

package/esm/types.js

@@ -0,0 +1,25 @@
+/**
+ * Runtime identifiers used in generated code.
+ *
+ * These are build-time constants — the actual module paths and function names
+ * that appear in codegen output. They must stay in sync with the `@evjs/runtime`
+ * package exports.
+ *
+ * Note: `DEFAULT_ENDPOINT` (the default HTTP path for server functions) is a runtime
+ * concern and lives in `@evjs/runtime/src/constants.ts`, not here.
+ */
+export const RUNTIME = {
+    /** Module path for server-side function registration (no Hono dependency). */
+    serverModule: "@evjs/runtime/server/register",
+    /** Module path for the server app factory (Hono app + server function handler). */
+    appModule: "@evjs/runtime/server",
+    /** Module path for client-side transport stubs. */
+    clientTransportModule: "@evjs/runtime/client/transport",
+    /** Server function registration call name. */
+    registerServerFn: "registerServerFn",
+    /** Client-side server function call name. */
+    clientCall: "__fn_call",
+    /** Client-side function registration call name. */
+    clientRegister: "__fn_register",
+};
+//# sourceMappingURL=types.js.map

package/esm/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAuBA;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,OAAO,GAAG;IACrB,8EAA8E;IAC9E,YAAY,EAAE,+BAA+B;IAC7C,mFAAmF;IACnF,SAAS,EAAE,sBAAsB;IACjC,mDAAmD;IACnD,qBAAqB,EAAE,gCAAgC;IACvD,8CAA8C;IAC9C,gBAAgB,EAAE,kBAAkB;IACpC,6CAA6C;IAC7C,UAAU,EAAE,WAAW;IACvB,mDAAmD;IACnD,cAAc,EAAE,eAAe;CACvB,CAAC"}

package/esm/utils.d.ts

@@ -0,0 +1,14 @@
+/** Parse a "module#export" reference string. */
+export declare function parseModuleRef(ref: string): {
+    module: string;
+    exportName: string;
+};
+/** Hash a string to a 16-character hex digest (SHA-256, truncated). */
+export declare function hashString(input: string): string;
+/** Derive a stable module ID from a file path relative to root. */
+export declare function makeModuleId(rootContext: string, resourcePath: string): string;
+/** Derive a stable function ID from the file path and export name. */
+export declare function makeFnId(rootContext: string, resourcePath: string, exportName: string): string;
+/** Check whether the source starts with the "use server" directive. */
+export declare function detectUseServer(source: string): boolean;
+//# sourceMappingURL=utils.d.ts.map

package/esm/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAIA,gDAAgD;AAChD,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG;IAC3C,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;CACpB,CAQA;AAED,uEAAuE;AACvE,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEhD;AAED,mEAAmE;AACnE,wBAAgB,YAAY,CAC1B,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,MAAM,GACnB,MAAM,CAER;AAED,sEAAsE;AACtE,wBAAgB,QAAQ,CACtB,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,MAAM,EACpB,UAAU,EAAE,MAAM,GACjB,MAAM,CAGR;AAED,uEAAuE;AACvE,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAsBvD"}

package/esm/utils.js

@@ -0,0 +1,47 @@
+import { createHash } from "node:crypto";
+import path from "node:path";
+import { parseSync } from "@swc/core";
+/** Parse a "module#export" reference string. */
+export function parseModuleRef(ref) {
+    const idx = ref.indexOf("#");
+    if (idx === -1) {
+        throw new Error(`Invalid module reference "${ref}". Expected format: "module#exportName".`);
+    }
+    return { module: ref.slice(0, idx), exportName: ref.slice(idx + 1) };
+}
+/** Hash a string to a 16-character hex digest (SHA-256, truncated). */
+export function hashString(input) {
+    return createHash("sha256").update(input).digest("hex").slice(0, 16);
+}
+/** Derive a stable module ID from a file path relative to root. */
+export function makeModuleId(rootContext, resourcePath) {
+    return hashString(path.relative(rootContext, resourcePath));
+}
+/** Derive a stable function ID from the file path and export name. */
+export function makeFnId(rootContext, resourcePath, exportName) {
+    const relativePath = path.relative(rootContext, resourcePath);
+    return hashString(`${relativePath}:${exportName}`);
+}
+/** Check whether the source starts with the "use server" directive. */
+export function detectUseServer(source) {
+    try {
+        const ast = parseSync(source, {
+            syntax: "typescript",
+            tsx: true,
+            target: "esnext",
+        });
+        if (ast.body && ast.body.length > 0) {
+            const firstNode = ast.body[0];
+            if (firstNode.type === "ExpressionStatement" &&
+                firstNode.expression.type === "StringLiteral" &&
+                firstNode.expression.value === "use server") {
+                return true;
+            }
+        }
+    }
+    catch (_e) {
+        // Fallback if parsing completely fails for some reason
+    }
+    return false;
+}
+//# sourceMappingURL=utils.js.map

package/esm/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAEtC,gDAAgD;AAChD,MAAM,UAAU,cAAc,CAAC,GAAW;IAIxC,MAAM,GAAG,GAAG,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAC7B,IAAI,GAAG,KAAK,CAAC,CAAC,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CACb,6BAA6B,GAAG,0CAA0C,CAC3E,CAAC;IACJ,CAAC;IACD,OAAO,EAAE,MAAM,EAAE,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,UAAU,EAAE,GAAG,CAAC,KAAK,CAAC,GAAG,GAAG,CAAC,CAAC,EAAE,CAAC;AACvE,CAAC;AAED,uEAAuE;AACvE,MAAM,UAAU,UAAU,CAAC,KAAa;IACtC,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;AACvE,CAAC;AAED,mEAAmE;AACnE,MAAM,UAAU,YAAY,CAC1B,WAAmB,EACnB,YAAoB;IAEpB,OAAO,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC,WAAW,EAAE,YAAY,CAAC,CAAC,CAAC;AAC9D,CAAC;AAED,sEAAsE;AACtE,MAAM,UAAU,QAAQ,CACtB,WAAmB,EACnB,YAAoB,EACpB,UAAkB;IAElB,MAAM,YAAY,GAAG,IAAI,CAAC,QAAQ,CAAC,WAAW,EAAE,YAAY,CAAC,CAAC;IAC9D,OAAO,UAAU,CAAC,GAAG,YAAY,IAAI,UAAU,EAAE,CAAC,CAAC;AACrD,CAAC;AAED,uEAAuE;AACvE,MAAM,UAAU,eAAe,CAAC,MAAc;IAC5C,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,SAAS,CAAC,MAAM,EAAE;YAC5B,MAAM,EAAE,YAAY;YACpB,GAAG,EAAE,IAAI;YACT,MAAM,EAAE,QAAQ;SACjB,CAAC,CAAC;QAEH,IAAI,GAAG,CAAC,IAAI,IAAI,GAAG,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACpC,MAAM,SAAS,GAAG,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YAC9B,IACE,SAAS,CAAC,IAAI,KAAK,qBAAqB;gBACxC,SAAS,CAAC,UAAU,CAAC,IAAI,KAAK,eAAe;gBAC7C,SAAS,CAAC,UAAU,CAAC,KAAK,KAAK,YAAY,EAC3C,CAAC;gBACD,OAAO,IAAI,CAAC;YACd,CAAC;QACH,CAAC;IACH,CAAC;IAAC,OAAO,EAAE,EAAE,CAAC;QACZ,uDAAuD;IACzD,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "@evjs/build-tools",
+  "version": "0.0.0",
+  "description": "Bundler-agnostic build utilities for the ev framework",
+  "type": "module",
+  "publishConfig": {
+    "access": "public"
+  },
+  "main": "./esm/index.js",
+  "exports": {
+    ".": {
+      "types": "./esm/index.d.ts",
+      "import": "./esm/index.js"
+    }
+  },
+  "scripts": {
+    "build": "tsc",
+    "test": "vitest run",
+    "check-types": "tsc --noEmit"
+  },
+  "files": [
+    "esm"
+  ],
+  "keywords": [
+    "evjs",
+    "build-tools",
+    "server-functions",
+    "code-transform",
+    "typescript"
+  ],
+  "author": "xusd320",
+  "license": "MIT",
+  "dependencies": {
+    "@swc/core": "^1.15.18"
+  },
+  "devDependencies": {
+    "@swc/types": "^0.1.25",
+    "typescript": "^5.7.3"
+  },
+  "homepage": "https://github.com/evaijs/evjs#readme",
+  "bugs": {
+    "url": "https://github.com/evaijs/evjs/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/evaijs/evjs.git"
+  }
+}