@elurjs/kit 2.4.4

package/dist/lib/adapters/node.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"node.js","names":[],"sources":["../../../src/adapters/node.ts"],"sourcesContent":["import { mkdir, rm, stat, writeFile } from \"node:fs/promises\";\nimport { relative, resolve } from \"node:path\";\nimport { build } from \"vite\";\nimport { scanRoutes } from \"../router/route-scanner.js\";\nimport type { Adapter } from \"./index.js\";\nimport { writeSsrEntry } from \"./shared.js\";\nimport { DEFAULT_CAPABILITIES } from \"../runtime/capabilities.js\";\n\n/**\n * Node adapter for elur-kit.\n *\n * Produces a self-contained Node server entry at `.elur/node-server.mjs`.\n * Run it with:\n *\n *   node .elur/node-server.mjs\n *\n * The server serves static files from `dist/` and renders pages on demand for\n * unmatched routes.\n */\nexport const nodeAdapter: Adapter = {\n  name: \"node\",\n  capabilities: DEFAULT_CAPABILITIES,\n\n  async build(options) {\n    const root = resolve(options.root);\n    const outDir = resolve(root, options.outDir);\n    const generatedDir = resolve(root, \".elur\");\n\n    try {\n      await stat(outDir);\n    } catch {\n      throw new Error(\n        `Output directory not found: ${outDir}. Run \"elur-kit build\" first.`,\n      );\n    }\n\n    await rm(generatedDir, { recursive: true, force: true });\n    await mkdir(generatedDir, { recursive: true });\n\n    const appDir = resolve(root, options.appDir);\n    const routes = await scanRoutes(appDir);\n\n    const entryPath = resolve(generatedDir, \"node-index.ts\");\n    await writeSsrEntry(entryPath, routes, options);\n\n    const serverPath = resolve(generatedDir, \"node-server.ts\");\n    await writeFile(\n      serverPath,\n      buildNodeServerSource(relativeToUrlPath(generatedDir, outDir), options),\n      \"utf8\",\n    );\n\n    await build({\n      configFile: false,\n      root,\n      build: {\n        outDir: generatedDir,\n        emptyOutDir: false,\n        ssr: true,\n        lib: {\n          entry: serverPath,\n          formats: [\"es\"],\n        },\n        rollupOptions: {\n          external: [/^@elurjs\\/kit(?:\\/.*)?$/, /^@elurjs\\/core(?:\\/.*)?$/, /^node:/],\n          output: {\n            entryFileNames: \"node-server.mjs\",\n            inlineDynamicImports: true,\n          },\n        },\n      },\n    });\n  },\n};\n\nfunction buildNodeServerSource(\n  outDirUrl: string,\n  options: {\n    clientEntry: string;\n    lang: string;\n    port?: number;\n  },\n): string {\n  return `// AUTO-GENERATED by @elurjs/kit. Do not edit.\nimport { createServer } from \"node:http\";\nimport { fileURLToPath } from \"node:url\";\nimport { createWebHandler } from \"@elurjs/kit/runtime\";\nimport { incomingMessageToRequest } from \"@elurjs/kit/runtime\";\nimport handler from \"./node-index.ts\";\n\nconst outDir = fileURLToPath(new URL(${JSON.stringify(outDirUrl)}, import.meta.url));\nconst port = Number(process.env.PORT) || ${options.port ?? 3000};\n\n// The adapter-bundled handler already handles actions, API routes, render\n// endpoint and dynamic SSR. We only need to add static file serving from\n// the output directory, then fall through to the bundled handler.\nconst webHandler = createWebHandler(\n  { pages: [], api: [], error404: undefined, error500: undefined },\n  {},\n  { staticRoot: outDir, lang: ${JSON.stringify(options.lang)}, clientEntry: ${JSON.stringify(options.clientEntry)} },\n);\n\ncreateServer(async (req, res) => {\n  const body = req.method !== \"GET\" && req.method !== \"HEAD\"\n    ? await readBody(req)\n    : undefined;\n  const request = incomingMessageToRequest(req, body);\n  // Try static files first via the unified handler, then fall back to the\n  // bundled SSR handler for dynamic routes.\n  let response = await webHandler(request);\n  if (response.status === 404) {\n    response = await handler(request);\n  }\n  res.writeHead(response.status, Object.fromEntries(response.headers.entries()));\n  res.end(Buffer.from(await response.arrayBuffer()));\n}).listen(port, () => {\n  console.log(\\`Node server running at http://localhost:\\${port}\\`);\n});\n\nfunction readBody(req: import(\"node:http\").IncomingMessage): Promise<Buffer> {\n  return new Promise((resolve, reject) => {\n    const chunks: Buffer[] = [];\n    req.on(\"data\", (chunk) => chunks.push(Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk)));\n    req.on(\"end\", () => resolve(Buffer.concat(chunks)));\n    req.on(\"error\", reject);\n  });\n}\n`;\n}\n\nfunction relativeToUrlPath(from: string, to: string): string {\n  const path = relative(from, to).split(\"\\\\\").join(\"/\");\n  return `${path.startsWith(\".\") ? path : `./${path}`}/`;\n}\n"],"mappings":";;;;;;;AAmBA,IAAa,IAAuB;CAClC,MAAM;CACN,cAAc;CAEd,MAAM,MAAM,GAAS;EACnB,IAAM,IAAO,EAAQ,EAAQ,IAAI,GAC3B,IAAS,EAAQ,GAAM,EAAQ,MAAM,GACrC,IAAe,EAAQ,GAAM,OAAO;EAE1C,IAAI;GACF,MAAM,EAAK,CAAM;EACnB,QAAQ;GACN,MAAU,MACR,+BAA+B,EAAO,8BACxC;EACF;EAGA,AADA,MAAM,EAAG,GAAc;GAAE,WAAW;GAAM,OAAO;EAAK,CAAC,GACvD,MAAM,EAAM,GAAc,EAAE,WAAW,GAAK,CAAC;EAE7C,IAAM,IAAS,EAAQ,GAAM,EAAQ,MAAM,GACrC,IAAS,MAAM,EAAW,CAAM,GAEhC,IAAY,EAAQ,GAAc,eAAe;EACvD,MAAM,EAAc,GAAW,GAAQ,CAAO;EAE9C,IAAM,IAAa,EAAQ,GAAc,gBAAgB;EAOzD,AANA,MAAM,EACJ,GACA,EAAsB,EAAkB,GAAc,CAAM,GAAG,CAAO,GACtE,MACF,GAEA,MAAM,EAAM;GACV,YAAY;GACZ;GACA,OAAO;IACL,QAAQ;IACR,aAAa;IACb,KAAK;IACL,KAAK;KACH,OAAO;KACP,SAAS,CAAC,IAAI;IAChB;IACA,eAAe;KACb,UAAU;MAAC;MAA2B;MAA4B;KAAQ;KAC1E,QAAQ;MACN,gBAAgB;MAChB,sBAAsB;KACxB;IACF;GACF;EACF,CAAC;CACH;AACF;AAEA,SAAS,EACP,GACA,GAKQ;CACR,OAAO;;;;;;;uCAO8B,KAAK,UAAU,CAAS,EAAE;2CACtB,EAAQ,QAAQ,IAAK;;;;;;;;gCAQhC,KAAK,UAAU,EAAQ,IAAI,EAAE,iBAAiB,KAAK,UAAU,EAAQ,WAAW,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA6BlH;AAEA,SAAS,EAAkB,GAAc,GAAoB;CAC3D,IAAM,IAAO,EAAS,GAAM,CAAE,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC,KAAK,GAAG;CACpD,OAAO,GAAG,EAAK,WAAW,GAAG,IAAI,IAAO,KAAK,IAAO;AACtD"}

package/dist/lib/adapters/shared.d.cts

@@ -0,0 +1,17 @@
+import { scanRoutes } from "../router/route-scanner.js";
+import type { AdapterOptions } from "./index.js";
+/**
+ * Shared helper: copy a directory recursively.
+ */
+export declare function copyStatic(from: string, to: string): Promise<void>;
+/**
+ * Build a self-contained SSR entry file for a platform adapter.
+ * The generated module exports a default `handler(request: Request): Response`
+ * and embeds the full route table plus a registry of all page/layout/data/
+ * action modules so the runtime never touches the file system.
+ */
+export declare function buildSsrEntry(routes: Awaited<ReturnType<typeof scanRoutes>>, options: AdapterOptions, entryDir: string): Promise<string>;
+/**
+ * Write a generated SSR entry file for an adapter.
+ */
+export declare function writeSsrEntry(entryPath: string, routes: Awaited<ReturnType<typeof scanRoutes>>, options: AdapterOptions): Promise<void>;

package/dist/lib/adapters/shared.d.ts

@@ -0,0 +1,17 @@
+import { scanRoutes } from "../router/route-scanner.js";
+import type { AdapterOptions } from "./index.js";
+/**
+ * Shared helper: copy a directory recursively.
+ */
+export declare function copyStatic(from: string, to: string): Promise<void>;
+/**
+ * Build a self-contained SSR entry file for a platform adapter.
+ * The generated module exports a default `handler(request: Request): Response`
+ * and embeds the full route table plus a registry of all page/layout/data/
+ * action modules so the runtime never touches the file system.
+ */
+export declare function buildSsrEntry(routes: Awaited<ReturnType<typeof scanRoutes>>, options: AdapterOptions, entryDir: string): Promise<string>;
+/**
+ * Write a generated SSR entry file for an adapter.
+ */
+export declare function writeSsrEntry(entryPath: string, routes: Awaited<ReturnType<typeof scanRoutes>>, options: AdapterOptions): Promise<void>;

package/dist/lib/adapters/vercel.cjs

@@ -0,0 +1,2 @@
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("../route-scanner-JY6YrNH5.cjs"),t=require("../shared-CfqOLsKj.cjs"),n=require("../capabilities-C0TDQoMY.cjs");let r=require("node:fs/promises"),i=require("node:path"),a=require("vite");var o={name:`vercel`,capabilities:n.r,async build(n){let o=(0,i.resolve)(n.root),s=(0,i.resolve)(o,n.outDir),c=(0,i.resolve)(o,`.vercel/output`),l=(0,i.join)(c,`functions`,`__elur-js-kit.func`),u=(0,i.resolve)(o,`.elur`);try{await(0,r.stat)(s)}catch{throw Error(`Output directory not found: ${s}. Run "elur-kit build" first.`)}await(0,r.rm)(c,{recursive:!0,force:!0}),await(0,r.mkdir)(c,{recursive:!0}),await(0,r.mkdir)(l,{recursive:!0}),await(0,r.mkdir)(u,{recursive:!0}),await t.t(s,(0,i.join)(c,`static`));let d=(0,i.resolve)(o,n.appDir),f=await e.t(d),p=(0,i.resolve)(u,`vercel-index.ts`);await t.n(p,f,n),await(0,a.build)({configFile:!1,root:o,build:{outDir:l,emptyOutDir:!0,ssr:!0,lib:{entry:p,formats:[`es`],fileName:()=>`index.js`},rollupOptions:{external:[],output:{inlineDynamicImports:!0}}}});let m=(0,i.join)(l,`vercel-index.js`),h=(0,i.join)(l,`index.js`);try{await(0,r.stat)(m),await(0,r.rename)(m,h)}catch{}await(0,r.writeFile)((0,i.join)(l,`.vc-config.json`),JSON.stringify({runtime:`nodejs20.x`,handler:`index.js`,launcherType:`Nodejs`,shouldAddHelpers:!0},null,2),`utf8`),await(0,r.writeFile)((0,i.join)(c,`config.json`),JSON.stringify({version:3,routes:[{handle:`filesystem`},{src:`/(.*)`,dest:`/__elur-js-kit`}]},null,2),`utf8`)}};exports.vercelAdapter=o;
+//# sourceMappingURL=vercel.cjs.map

package/dist/lib/adapters/vercel.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"vercel.cjs","names":[],"sources":["../../../src/adapters/vercel.ts"],"sourcesContent":["import { mkdir, rename, rm, stat, writeFile } from \"node:fs/promises\";\nimport { join, resolve } from \"node:path\";\nimport { build } from \"vite\";\nimport { scanRoutes } from \"../router/route-scanner.js\";\nimport type { Adapter } from \"./index.js\";\nimport { copyStatic, writeSsrEntry } from \"./shared.js\";\nimport { SERVERLESS_CAPABILITIES } from \"../runtime/capabilities.js\";\n\n/**\n * Vercel adapter for elur-kit.\n *\n * Produces a `.vercel/output` directory compatible with the Vercel Build Output\n * API (v3). Static files are served from `dist/` and unmatched routes fall back\n * to the SSR function.\n */\nexport const vercelAdapter: Adapter = {\n  name: \"vercel\",\n  capabilities: SERVERLESS_CAPABILITIES,\n\n  async build(options) {\n    const root = resolve(options.root);\n    const outDir = resolve(root, options.outDir);\n    const vercelOut = resolve(root, \".vercel/output\");\n    const functionsDir = join(vercelOut, \"functions\", \"__elur-js-kit.func\");\n    const generatedDir = resolve(root, \".elur\");\n\n    // Verify the production build exists.\n    try {\n      await stat(outDir);\n    } catch {\n      throw new Error(\n        `Output directory not found: ${outDir}. Run \"elur-kit build\" first.`,\n      );\n    }\n\n    // Clean previous adapter output.\n    await rm(vercelOut, { recursive: true, force: true });\n    await mkdir(vercelOut, { recursive: true });\n    await mkdir(functionsDir, { recursive: true });\n    await mkdir(generatedDir, { recursive: true });\n\n    // Copy static files.\n    await copyStatic(outDir, join(vercelOut, \"static\"));\n\n    // Scan routes and generate a self-contained function entry.\n    const appDir = resolve(root, options.appDir);\n    const routes = await scanRoutes(appDir);\n\n    const entryPath = resolve(generatedDir, \"vercel-index.ts\");\n    await writeSsrEntry(entryPath, routes, options);\n\n    // Bundle the function entry.\n    await build({\n      configFile: false,\n      root,\n      build: {\n        outDir: functionsDir,\n        emptyOutDir: true,\n        ssr: true,\n        lib: {\n          entry: entryPath,\n          formats: [\"es\"],\n          fileName: () => \"index.js\",\n        },\n        rollupOptions: {\n          external: [],\n          output: {\n            inlineDynamicImports: true,\n          },\n        },\n      },\n    });\n\n    // Vite SSR lib builds may use the entry file name, so force the expected handler name.\n    const generatedHandler = join(functionsDir, \"vercel-index.js\");\n    const targetHandler = join(functionsDir, \"index.js\");\n    try {\n      await stat(generatedHandler);\n      await rename(generatedHandler, targetHandler);\n    } catch {\n      // If the file is already named index.js, nothing to do.\n    }\n\n    // Write Vercel function config.\n    await writeFile(\n      join(functionsDir, \".vc-config.json\"),\n      JSON.stringify(\n        {\n          runtime: \"nodejs20.x\",\n          handler: \"index.js\",\n          launcherType: \"Nodejs\",\n          shouldAddHelpers: true,\n        },\n        null,\n        2,\n      ),\n      \"utf8\",\n    );\n\n    // Write Vercel root config.\n    await writeFile(\n      join(vercelOut, \"config.json\"),\n      JSON.stringify(\n        {\n          version: 3,\n          routes: [\n            { handle: \"filesystem\" },\n            { src: \"/(.*)\", \"dest\": \"/__elur-js-kit\" },\n          ],\n        },\n        null,\n        2,\n      ),\n      \"utf8\",\n    );\n  },\n};\n"],"mappings":"6QAeA,IAAa,EAAyB,CACpC,KAAM,SACN,aAAc,EAAA,EAEd,MAAM,MAAM,EAAS,CACnB,IAAM,GAAA,EAAO,EAAA,QAAA,CAAQ,EAAQ,IAAI,EAC3B,GAAA,EAAS,EAAA,QAAA,CAAQ,EAAM,EAAQ,MAAM,EACrC,GAAA,EAAY,EAAA,QAAA,CAAQ,EAAM,gBAAgB,EAC1C,GAAA,EAAe,EAAA,KAAA,CAAK,EAAW,YAAa,oBAAoB,EAChE,GAAA,EAAe,EAAA,QAAA,CAAQ,EAAM,OAAO,EAG1C,GAAI,CACF,MAAA,EAAM,EAAA,KAAA,CAAK,CAAM,CACnB,MAAQ,CACN,MAAU,MACR,+BAA+B,EAAO,8BACxC,CACF,CAGA,MAAA,EAAM,EAAA,GAAA,CAAG,EAAW,CAAE,UAAW,GAAM,MAAO,EAAK,CAAC,EACpD,MAAA,EAAM,EAAA,MAAA,CAAM,EAAW,CAAE,UAAW,EAAK,CAAC,EAC1C,MAAA,EAAM,EAAA,MAAA,CAAM,EAAc,CAAE,UAAW,EAAK,CAAC,EAC7C,MAAA,EAAM,EAAA,MAAA,CAAM,EAAc,CAAE,UAAW,EAAK,CAAC,EAG7C,MAAM,EAAA,EAAW,GAAA,EAAQ,EAAA,KAAA,CAAK,EAAW,QAAQ,CAAC,EAGlD,IAAM,GAAA,EAAS,EAAA,QAAA,CAAQ,EAAM,EAAQ,MAAM,EACrC,EAAS,MAAM,EAAA,EAAW,CAAM,EAEhC,GAAA,EAAY,EAAA,QAAA,CAAQ,EAAc,iBAAiB,EACzD,MAAM,EAAA,EAAc,EAAW,EAAQ,CAAO,EAG9C,MAAA,EAAM,EAAA,MAAA,CAAM,CACV,WAAY,GACZ,OACA,MAAO,CACL,OAAQ,EACR,YAAa,GACb,IAAK,GACL,IAAK,CACH,MAAO,EACP,QAAS,CAAC,IAAI,EACd,aAAgB,UAClB,EACA,cAAe,CACb,SAAU,CAAC,EACX,OAAQ,CACN,qBAAsB,EACxB,CACF,CACF,CACF,CAAC,EAGD,IAAM,GAAA,EAAmB,EAAA,KAAA,CAAK,EAAc,iBAAiB,EACvD,GAAA,EAAgB,EAAA,KAAA,CAAK,EAAc,UAAU,EACnD,GAAI,CACF,MAAA,EAAM,EAAA,KAAA,CAAK,CAAgB,EAC3B,MAAA,EAAM,EAAA,OAAA,CAAO,EAAkB,CAAa,CAC9C,MAAQ,CAER,CAGA,MAAA,EAAM,EAAA,UAAA,EAAA,EACJ,EAAA,KAAA,CAAK,EAAc,iBAAiB,EACpC,KAAK,UACH,CACE,QAAS,aACT,QAAS,WACT,aAAc,SACd,iBAAkB,EACpB,EACA,KACA,CACF,EACA,MACF,EAGA,MAAA,EAAM,EAAA,UAAA,EAAA,EACJ,EAAA,KAAA,CAAK,EAAW,aAAa,EAC7B,KAAK,UACH,CACE,QAAS,EACT,OAAQ,CACN,CAAE,OAAQ,YAAa,EACvB,CAAE,IAAK,QAAS,KAAQ,gBAAiB,CAC3C,CACF,EACA,KACA,CACF,EACA,MACF,CACF,CACF"}

package/dist/lib/adapters/vercel.d.cts

@@ -0,0 +1,9 @@
+import type { Adapter } from "./index.js";
+/**
+ * Vercel adapter for elur-kit.
+ *
+ * Produces a `.vercel/output` directory compatible with the Vercel Build Output
+ * API (v3). Static files are served from `dist/` and unmatched routes fall back
+ * to the SSR function.
+ */
+export declare const vercelAdapter: Adapter;

package/dist/lib/adapters/vercel.d.ts

@@ -0,0 +1,9 @@
+import type { Adapter } from "./index.js";
+/**
+ * Vercel adapter for elur-kit.
+ *
+ * Produces a `.vercel/output` directory compatible with the Vercel Build Output
+ * API (v3). Static files are served from `dist/` and unmatched routes fall back
+ * to the SSR function.
+ */
+export declare const vercelAdapter: Adapter;

package/dist/lib/adapters/vercel.js

@@ -0,0 +1,62 @@
+import { t as e } from "../route-scanner-XcLId7lK.js";
+import { n as t, t as n } from "../shared-DU3iQgr7.js";
+import { r } from "../capabilities-C7txofmY.js";
+import { mkdir as i, rename as a, rm as o, stat as s, writeFile as c } from "node:fs/promises";
+import { join as l, resolve as u } from "node:path";
+import { build as d } from "vite";
+//#region src/adapters/vercel.ts
+var f = {
+	name: "vercel",
+	capabilities: r,
+	async build(r) {
+		let f = u(r.root), p = u(f, r.outDir), m = u(f, ".vercel/output"), h = l(m, "functions", "__elur-js-kit.func"), g = u(f, ".elur");
+		try {
+			await s(p);
+		} catch {
+			throw Error(`Output directory not found: ${p}. Run "elur-kit build" first.`);
+		}
+		await o(m, {
+			recursive: !0,
+			force: !0
+		}), await i(m, { recursive: !0 }), await i(h, { recursive: !0 }), await i(g, { recursive: !0 }), await n(p, l(m, "static"));
+		let _ = u(f, r.appDir), v = await e(_), y = u(g, "vercel-index.ts");
+		await t(y, v, r), await d({
+			configFile: !1,
+			root: f,
+			build: {
+				outDir: h,
+				emptyOutDir: !0,
+				ssr: !0,
+				lib: {
+					entry: y,
+					formats: ["es"],
+					fileName: () => "index.js"
+				},
+				rollupOptions: {
+					external: [],
+					output: { inlineDynamicImports: !0 }
+				}
+			}
+		});
+		let b = l(h, "vercel-index.js"), x = l(h, "index.js");
+		try {
+			await s(b), await a(b, x);
+		} catch {}
+		await c(l(h, ".vc-config.json"), JSON.stringify({
+			runtime: "nodejs20.x",
+			handler: "index.js",
+			launcherType: "Nodejs",
+			shouldAddHelpers: !0
+		}, null, 2), "utf8"), await c(l(m, "config.json"), JSON.stringify({
+			version: 3,
+			routes: [{ handle: "filesystem" }, {
+				src: "/(.*)",
+				dest: "/__elur-js-kit"
+			}]
+		}, null, 2), "utf8");
+	}
+};
+//#endregion
+export { f as vercelAdapter };
+
+//# sourceMappingURL=vercel.js.map

package/dist/lib/adapters/vercel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vercel.js","names":[],"sources":["../../../src/adapters/vercel.ts"],"sourcesContent":["import { mkdir, rename, rm, stat, writeFile } from \"node:fs/promises\";\nimport { join, resolve } from \"node:path\";\nimport { build } from \"vite\";\nimport { scanRoutes } from \"../router/route-scanner.js\";\nimport type { Adapter } from \"./index.js\";\nimport { copyStatic, writeSsrEntry } from \"./shared.js\";\nimport { SERVERLESS_CAPABILITIES } from \"../runtime/capabilities.js\";\n\n/**\n * Vercel adapter for elur-kit.\n *\n * Produces a `.vercel/output` directory compatible with the Vercel Build Output\n * API (v3). Static files are served from `dist/` and unmatched routes fall back\n * to the SSR function.\n */\nexport const vercelAdapter: Adapter = {\n  name: \"vercel\",\n  capabilities: SERVERLESS_CAPABILITIES,\n\n  async build(options) {\n    const root = resolve(options.root);\n    const outDir = resolve(root, options.outDir);\n    const vercelOut = resolve(root, \".vercel/output\");\n    const functionsDir = join(vercelOut, \"functions\", \"__elur-js-kit.func\");\n    const generatedDir = resolve(root, \".elur\");\n\n    // Verify the production build exists.\n    try {\n      await stat(outDir);\n    } catch {\n      throw new Error(\n        `Output directory not found: ${outDir}. Run \"elur-kit build\" first.`,\n      );\n    }\n\n    // Clean previous adapter output.\n    await rm(vercelOut, { recursive: true, force: true });\n    await mkdir(vercelOut, { recursive: true });\n    await mkdir(functionsDir, { recursive: true });\n    await mkdir(generatedDir, { recursive: true });\n\n    // Copy static files.\n    await copyStatic(outDir, join(vercelOut, \"static\"));\n\n    // Scan routes and generate a self-contained function entry.\n    const appDir = resolve(root, options.appDir);\n    const routes = await scanRoutes(appDir);\n\n    const entryPath = resolve(generatedDir, \"vercel-index.ts\");\n    await writeSsrEntry(entryPath, routes, options);\n\n    // Bundle the function entry.\n    await build({\n      configFile: false,\n      root,\n      build: {\n        outDir: functionsDir,\n        emptyOutDir: true,\n        ssr: true,\n        lib: {\n          entry: entryPath,\n          formats: [\"es\"],\n          fileName: () => \"index.js\",\n        },\n        rollupOptions: {\n          external: [],\n          output: {\n            inlineDynamicImports: true,\n          },\n        },\n      },\n    });\n\n    // Vite SSR lib builds may use the entry file name, so force the expected handler name.\n    const generatedHandler = join(functionsDir, \"vercel-index.js\");\n    const targetHandler = join(functionsDir, \"index.js\");\n    try {\n      await stat(generatedHandler);\n      await rename(generatedHandler, targetHandler);\n    } catch {\n      // If the file is already named index.js, nothing to do.\n    }\n\n    // Write Vercel function config.\n    await writeFile(\n      join(functionsDir, \".vc-config.json\"),\n      JSON.stringify(\n        {\n          runtime: \"nodejs20.x\",\n          handler: \"index.js\",\n          launcherType: \"Nodejs\",\n          shouldAddHelpers: true,\n        },\n        null,\n        2,\n      ),\n      \"utf8\",\n    );\n\n    // Write Vercel root config.\n    await writeFile(\n      join(vercelOut, \"config.json\"),\n      JSON.stringify(\n        {\n          version: 3,\n          routes: [\n            { handle: \"filesystem\" },\n            { src: \"/(.*)\", \"dest\": \"/__elur-js-kit\" },\n          ],\n        },\n        null,\n        2,\n      ),\n      \"utf8\",\n    );\n  },\n};\n"],"mappings":";;;;;;;AAeA,IAAa,IAAyB;CACpC,MAAM;CACN,cAAc;CAEd,MAAM,MAAM,GAAS;EACnB,IAAM,IAAO,EAAQ,EAAQ,IAAI,GAC3B,IAAS,EAAQ,GAAM,EAAQ,MAAM,GACrC,IAAY,EAAQ,GAAM,gBAAgB,GAC1C,IAAe,EAAK,GAAW,aAAa,oBAAoB,GAChE,IAAe,EAAQ,GAAM,OAAO;EAG1C,IAAI;GACF,MAAM,EAAK,CAAM;EACnB,QAAQ;GACN,MAAU,MACR,+BAA+B,EAAO,8BACxC;EACF;EASA,AANA,MAAM,EAAG,GAAW;GAAE,WAAW;GAAM,OAAO;EAAK,CAAC,GACpD,MAAM,EAAM,GAAW,EAAE,WAAW,GAAK,CAAC,GAC1C,MAAM,EAAM,GAAc,EAAE,WAAW,GAAK,CAAC,GAC7C,MAAM,EAAM,GAAc,EAAE,WAAW,GAAK,CAAC,GAG7C,MAAM,EAAW,GAAQ,EAAK,GAAW,QAAQ,CAAC;EAGlD,IAAM,IAAS,EAAQ,GAAM,EAAQ,MAAM,GACrC,IAAS,MAAM,EAAW,CAAM,GAEhC,IAAY,EAAQ,GAAc,iBAAiB;EAIzD,AAHA,MAAM,EAAc,GAAW,GAAQ,CAAO,GAG9C,MAAM,EAAM;GACV,YAAY;GACZ;GACA,OAAO;IACL,QAAQ;IACR,aAAa;IACb,KAAK;IACL,KAAK;KACH,OAAO;KACP,SAAS,CAAC,IAAI;KACd,gBAAgB;IAClB;IACA,eAAe;KACb,UAAU,CAAC;KACX,QAAQ,EACN,sBAAsB,GACxB;IACF;GACF;EACF,CAAC;EAGD,IAAM,IAAmB,EAAK,GAAc,iBAAiB,GACvD,IAAgB,EAAK,GAAc,UAAU;EACnD,IAAI;GAEF,AADA,MAAM,EAAK,CAAgB,GAC3B,MAAM,EAAO,GAAkB,CAAa;EAC9C,QAAQ,CAER;EAmBA,AAhBA,MAAM,EACJ,EAAK,GAAc,iBAAiB,GACpC,KAAK,UACH;GACE,SAAS;GACT,SAAS;GACT,cAAc;GACd,kBAAkB;EACpB,GACA,MACA,CACF,GACA,MACF,GAGA,MAAM,EACJ,EAAK,GAAW,aAAa,GAC7B,KAAK,UACH;GACE,SAAS;GACT,QAAQ,CACN,EAAE,QAAQ,aAAa,GACvB;IAAE,KAAK;IAAS,MAAQ;GAAiB,CAC3C;EACF,GACA,MACA,CACF,GACA,MACF;CACF;AACF"}

package/dist/lib/build/build.d.cts

@@ -0,0 +1,83 @@
+import { scanRoutes, type PageRoute, type ScannedRoutes } from "../router/route-scanner.js";
+import { type IslandModule } from "../island/scan.js";
+import { type ImageFormat } from "../image/index.js";
+import { type ElurKitIntegration } from "../integrations/index.js";
+export interface BuildConfig {
+    /** Absolute path to the app directory (e.g. /project/src/app). */
+    appDir: string;
+    /** Absolute path to the output directory (e.g. /project/dist). */
+    outDir: string;
+    /** Absolute path to the project root (e.g. /project). When provided, action
+     * paths in the serialized HTML shell are made relative to this root. */
+    root?: string;
+    /** Base path for the client entry module, e.g. "/_elur/entry-client.js". */
+    clientEntry?: string;
+    /** Default language for the HTML shell. */
+    lang?: string;
+    /**
+     * Absolute path to the islands directory (e.g. /project/src/islands).
+     * When set, `build` scans it and generates a client entry module listing
+     * every island so you don't have to maintain `entry-client.ts` by hand.
+     */
+    islandsDir?: string;
+    /**
+     * Absolute path where the generated client entry module is written
+     * (e.g. /project/.elur/entry-client.ts). Required when `islandsDir` is set.
+     */
+    generatedEntry?: string;
+    /**
+     * Import specifier the generated entry uses for `hydrateIslands`.
+     * Defaults to the published subpath `@elurjs/kit/island`.
+     */
+    hydrateImport?: string;
+    /**
+     * Import specifier the generated entry uses for `startClientRouter`.
+     * Defaults to the published subpath `@elurjs/kit/router`.
+     */
+    routerImport?: string;
+    /** Absolute path to the public directory for static assets (optional). */
+    publicDir?: string;
+    /** Image formats to generate when sharp is available. Defaults to ["webp", "avif"]. */
+    imageFormats?: ImageFormat[];
+    /**
+     * Whether the SSR render endpoint (`/__elur-js/render`) exists at runtime.
+     * Defaults to `true` (dev, preview and SSR deployments). Set to `false` for
+     * fully static outputs so the emitted HTML tells the client router to skip
+     * the endpoint (no 404 storms on static hosts like Vercel).
+     */
+    renderEndpoint?: boolean;
+    /**
+     * Integrations to invoke during the build lifecycle. When provided, the
+     * `build` hook fires after all pages and image variants are generated,
+     * giving integrations a chance to write post-build artifacts (sitemaps,
+     * robots.txt, search indexes, etc.) into the output directory.
+     */
+    integrations?: ElurKitIntegration[];
+}
+export interface BuildResult {
+    /** Number of static HTML pages generated. */
+    pages: number;
+    /** Paths that were skipped because they are dynamic without a static param list. */
+    skipped: string[];
+    /** Absolute paths to the generated HTML files. */
+    files: string[];
+    /** Islands discovered when `islandsDir` is set. */
+    islands: IslandModule[];
+    /** Absolute path to the generated client entry, if one was written. */
+    generatedEntry?: string;
+    /** Number of image variants generated (0 if sharp is not installed). */
+    imagesProcessed: number;
+    /** Absolute path to the output directory where build artifacts were written.
+     * When called via the CLI, this is the atomic staging directory (not the
+     * final `dist/`). Integration `build` hooks should write post-build
+     * artifacts here so they survive the atomic swap. */
+    outDir: string;
+}
+/**
+ * Builds a static site from a scanned route tree.
+ *
+ * @param config Build configuration.
+ * @returns Summary of generated files.
+ */
+export declare function build(config: BuildConfig): Promise<BuildResult>;
+export { scanRoutes, type PageRoute, type ScannedRoutes };

package/dist/lib/build/build.d.ts

@@ -0,0 +1,83 @@
+import { scanRoutes, type PageRoute, type ScannedRoutes } from "../router/route-scanner.js";
+import { type IslandModule } from "../island/scan.js";
+import { type ImageFormat } from "../image/index.js";
+import { type ElurKitIntegration } from "../integrations/index.js";
+export interface BuildConfig {
+    /** Absolute path to the app directory (e.g. /project/src/app). */
+    appDir: string;
+    /** Absolute path to the output directory (e.g. /project/dist). */
+    outDir: string;
+    /** Absolute path to the project root (e.g. /project). When provided, action
+     * paths in the serialized HTML shell are made relative to this root. */
+    root?: string;
+    /** Base path for the client entry module, e.g. "/_elur/entry-client.js". */
+    clientEntry?: string;
+    /** Default language for the HTML shell. */
+    lang?: string;
+    /**
+     * Absolute path to the islands directory (e.g. /project/src/islands).
+     * When set, `build` scans it and generates a client entry module listing
+     * every island so you don't have to maintain `entry-client.ts` by hand.
+     */
+    islandsDir?: string;
+    /**
+     * Absolute path where the generated client entry module is written
+     * (e.g. /project/.elur/entry-client.ts). Required when `islandsDir` is set.
+     */
+    generatedEntry?: string;
+    /**
+     * Import specifier the generated entry uses for `hydrateIslands`.
+     * Defaults to the published subpath `@elurjs/kit/island`.
+     */
+    hydrateImport?: string;
+    /**
+     * Import specifier the generated entry uses for `startClientRouter`.
+     * Defaults to the published subpath `@elurjs/kit/router`.
+     */
+    routerImport?: string;
+    /** Absolute path to the public directory for static assets (optional). */
+    publicDir?: string;
+    /** Image formats to generate when sharp is available. Defaults to ["webp", "avif"]. */
+    imageFormats?: ImageFormat[];
+    /**
+     * Whether the SSR render endpoint (`/__elur-js/render`) exists at runtime.
+     * Defaults to `true` (dev, preview and SSR deployments). Set to `false` for
+     * fully static outputs so the emitted HTML tells the client router to skip
+     * the endpoint (no 404 storms on static hosts like Vercel).
+     */
+    renderEndpoint?: boolean;
+    /**
+     * Integrations to invoke during the build lifecycle. When provided, the
+     * `build` hook fires after all pages and image variants are generated,
+     * giving integrations a chance to write post-build artifacts (sitemaps,
+     * robots.txt, search indexes, etc.) into the output directory.
+     */
+    integrations?: ElurKitIntegration[];
+}
+export interface BuildResult {
+    /** Number of static HTML pages generated. */
+    pages: number;
+    /** Paths that were skipped because they are dynamic without a static param list. */
+    skipped: string[];
+    /** Absolute paths to the generated HTML files. */
+    files: string[];
+    /** Islands discovered when `islandsDir` is set. */
+    islands: IslandModule[];
+    /** Absolute path to the generated client entry, if one was written. */
+    generatedEntry?: string;
+    /** Number of image variants generated (0 if sharp is not installed). */
+    imagesProcessed: number;
+    /** Absolute path to the output directory where build artifacts were written.
+     * When called via the CLI, this is the atomic staging directory (not the
+     * final `dist/`). Integration `build` hooks should write post-build
+     * artifacts here so they survive the atomic swap. */
+    outDir: string;
+}
+/**
+ * Builds a static site from a scanned route tree.
+ *
+ * @param config Build configuration.
+ * @returns Summary of generated files.
+ */
+export declare function build(config: BuildConfig): Promise<BuildResult>;
+export { scanRoutes, type PageRoute, type ScannedRoutes };

package/dist/lib/build/document-shell.d.cts

@@ -0,0 +1,48 @@
+import type { PageMetadata } from "../types.js";
+export interface ShellOptions {
+    /** Rendered inner HTML that goes inside `#app`. */
+    body: string;
+    /** `<title>` text. */
+    title?: string;
+    /** `<html lang>` attribute. */
+    lang?: string;
+    /** Additional attributes for the `<html>` element, e.g. `{ "data-theme": "dark" }`. */
+    htmlAttributes?: Record<string, string>;
+    /**
+     * Inline scripts injected into `<head>`. They run synchronously while the
+     * document parses — before the first paint and before the (deferred) client
+     * bundle — so they are the right place for no-flash bootstrapping (e.g.
+     * applying a stored theme before the page becomes visible).
+     */
+    headScripts?: string[];
+    /**
+     * Raw HTML strings injected into `<head>` — e.g. `<link rel="icon">`,
+     * `<link rel="manifest">`, `<meta name="theme-color">`. Each string is
+     * rendered as-is inside `<head>`.
+     */
+    headLinks?: string[];
+    /** Loader data serialized into `<script id="elur-data">`. */
+    data?: unknown;
+    /** Per-page action names serialized into `<script id="elur-actions">`. */
+    actions?: Record<string, string[]>;
+    /** Path to the client entry module, e.g. `/_elur/entry-client.js`. */
+    clientEntry?: string;
+    /** Page metadata emitted as `<meta>`, `<link>` and OG/Twitter tags in `<head>`. */
+    metadata?: PageMetadata;
+    /**
+     * Whether the SSR render endpoint (`/__elur-js/render`) is available at
+     * runtime. Defaults to `true`. When `false` (static deployments), the shell
+     * emits `<meta name="elur:render-endpoint" content="off" />` so the client
+     * router skips probing the endpoint entirely — preventing a storm of 404
+     * requests on fully static sites.
+     */
+    renderEndpoint?: boolean;
+}
+/**
+ * Builds the `<head>` tags for a `PageMetadata` object. Every tag is marked with
+ * `data-elur-head` so the client-side router can replace them on navigation
+ * without touching charset/viewport or user-supplied `headScripts`.
+ */
+export declare function buildHeadTags(metadata: PageMetadata, fallbackTitle: string): string;
+/** Wraps rendered body HTML into a full HTML document. */
+export declare function documentShell(opts: ShellOptions): string;

package/dist/lib/build/document-shell.d.ts

@@ -0,0 +1,48 @@
+import type { PageMetadata } from "../types.js";
+export interface ShellOptions {
+    /** Rendered inner HTML that goes inside `#app`. */
+    body: string;
+    /** `<title>` text. */
+    title?: string;
+    /** `<html lang>` attribute. */
+    lang?: string;
+    /** Additional attributes for the `<html>` element, e.g. `{ "data-theme": "dark" }`. */
+    htmlAttributes?: Record<string, string>;
+    /**
+     * Inline scripts injected into `<head>`. They run synchronously while the
+     * document parses — before the first paint and before the (deferred) client
+     * bundle — so they are the right place for no-flash bootstrapping (e.g.
+     * applying a stored theme before the page becomes visible).
+     */
+    headScripts?: string[];
+    /**
+     * Raw HTML strings injected into `<head>` — e.g. `<link rel="icon">`,
+     * `<link rel="manifest">`, `<meta name="theme-color">`. Each string is
+     * rendered as-is inside `<head>`.
+     */
+    headLinks?: string[];
+    /** Loader data serialized into `<script id="elur-data">`. */
+    data?: unknown;
+    /** Per-page action names serialized into `<script id="elur-actions">`. */
+    actions?: Record<string, string[]>;
+    /** Path to the client entry module, e.g. `/_elur/entry-client.js`. */
+    clientEntry?: string;
+    /** Page metadata emitted as `<meta>`, `<link>` and OG/Twitter tags in `<head>`. */
+    metadata?: PageMetadata;
+    /**
+     * Whether the SSR render endpoint (`/__elur-js/render`) is available at
+     * runtime. Defaults to `true`. When `false` (static deployments), the shell
+     * emits `<meta name="elur:render-endpoint" content="off" />` so the client
+     * router skips probing the endpoint entirely — preventing a storm of 404
+     * requests on fully static sites.
+     */
+    renderEndpoint?: boolean;
+}
+/**
+ * Builds the `<head>` tags for a `PageMetadata` object. Every tag is marked with
+ * `data-elur-head` so the client-side router can replace them on navigation
+ * without touching charset/viewport or user-supplied `headScripts`.
+ */
+export declare function buildHeadTags(metadata: PageMetadata, fallbackTitle: string): string;
+/** Wraps rendered body HTML into a full HTML document. */
+export declare function documentShell(opts: ShellOptions): string;

package/dist/lib/build/transform-source.d.cts

@@ -0,0 +1,26 @@
+import { type InterpolationMode } from "../vite/interpolation-plugin.js";
+export interface TransformProjectOptions {
+    root: string;
+    appDir: string;
+    islandsDir?: string;
+    /**
+     * Absolute path to the transformed tree root. The tree mirrors the project
+     * layout relative to the common ancestor of `appDir`/`islandsDir`, so
+     * relative imports between app and islands keep resolving. Relative imports
+     * that escape that ancestor are compensated for the added directory depth.
+     */
+    outDir: string;
+    /**
+     * How the legacy interpolation transform is handled (default: "auto").
+     * With a Elur core that supports partial attribute interpolation natively
+     * the transform is not applied; use "legacy" for migrations against older
+     * cores and "off" to never transform.
+     */
+    interpolation?: InterpolationMode;
+}
+/**
+ * Absolute path of the transformed app directory inside the mirror tree,
+ * matching where `transformProjectFiles` copies the app files.
+ */
+export declare function transformedAppDir(root: string, appDir: string, islandsDir: string | undefined, outDir: string): string;
+export declare function transformProjectFiles(options: TransformProjectOptions): Promise<void>;

package/dist/lib/build/transform-source.d.ts

@@ -0,0 +1,26 @@
+import { type InterpolationMode } from "../vite/interpolation-plugin.js";
+export interface TransformProjectOptions {
+    root: string;
+    appDir: string;
+    islandsDir?: string;
+    /**
+     * Absolute path to the transformed tree root. The tree mirrors the project
+     * layout relative to the common ancestor of `appDir`/`islandsDir`, so
+     * relative imports between app and islands keep resolving. Relative imports
+     * that escape that ancestor are compensated for the added directory depth.
+     */
+    outDir: string;
+    /**
+     * How the legacy interpolation transform is handled (default: "auto").
+     * With a Elur core that supports partial attribute interpolation natively
+     * the transform is not applied; use "legacy" for migrations against older
+     * cores and "off" to never transform.
+     */
+    interpolation?: InterpolationMode;
+}
+/**
+ * Absolute path of the transformed app directory inside the mirror tree,
+ * matching where `transformProjectFiles` copies the app files.
+ */
+export declare function transformedAppDir(root: string, appDir: string, islandsDir: string | undefined, outDir: string): string;
+export declare function transformProjectFiles(options: TransformProjectOptions): Promise<void>;

package/dist/lib/build/vite-build.d.cts

@@ -0,0 +1,78 @@
+import { type InterpolationMode } from "../vite/interpolation-plugin.js";
+export interface ClientBuildOptions {
+    /** Project root (absolute). */
+    root: string;
+    /** Absolute path to the user's Vite client config (e.g. vite.client.config.ts). */
+    userConfigPath: string;
+    /** Absolute path to the app directory (used by the interpolation plugin). */
+    appDir: string;
+    /** Absolute path to the islands directory (used by the interpolation plugin). */
+    islandsDir: string;
+    /** Output directory for the client bundle (absolute). */
+    outDir: string;
+    /** Optional base path. */
+    base?: string;
+    /** Optional log prefix. */
+    logPrefix?: string;
+    /**
+     * How the legacy interpolation transform is handled (default: "auto").
+     * With a Elur core that supports partial attribute interpolation natively
+     * the transform is not applied; use "legacy" for migrations against older
+     * cores and "off" to never transform.
+     */
+    interpolation?: InterpolationMode;
+}
+export interface ClientBuildResult {
+    /** Output directory (same as `outDir` input). */
+    outDir: string;
+    /** Number of chunks/assets emitted, if reported by Vite. */
+    outputCount: number;
+}
+/**
+ * Build the client hydration bundle using the Vite JavaScript API.
+ *
+ * The user's config is loaded programmatically and the elur interpolation
+ * plugin is injected so partial attribute interpolations inside islands are
+ * transformed before reaching the browser.
+ */
+export declare function buildClientBundle(options: ClientBuildOptions): Promise<ClientBuildResult>;
+export interface AtomicStageOptions {
+    /** Final destination directory (absolute). */
+    outDir: string;
+    /** Build into this temp directory first, then rename to `outDir`. */
+    tempDir?: string;
+    /** Whether to preserve existing content in `outDir` during the swap. */
+    keepExisting?: boolean;
+}
+export interface AtomicStage {
+    tempDir: string;
+    /** Call after the build succeeds to atomically swap temp → outDir. */
+    commit: () => Promise<void>;
+    /** Call on failure to clean up the temp directory. */
+    rollback: () => Promise<void>;
+}
+/**
+ * Prepare an atomic staging directory for build output.
+ *
+ * Usage:
+ *   const stage = await beginAtomicStage({ outDir });
+ *   try {
+ *     await buildInto(stage.tempDir);
+ *     await stage.commit();
+ *   } catch (err) {
+ *     await stage.rollback();
+ *     throw err;
+ *   }
+ */
+export declare function beginAtomicStage(options: AtomicStageOptions): Promise<AtomicStage>;
+export interface CopyPublicAssetsOptions {
+    /** Absolute path to the public directory. */
+    publicDir: string;
+    /** Absolute path to the output directory. */
+    outDir: string;
+}
+/**
+ * Copy the public directory into the output directory.
+ * Returns the number of files copied.
+ */
+export declare function copyPublicAssets(options: CopyPublicAssetsOptions): Promise<number>;

package/dist/lib/build/vite-build.d.ts

@@ -0,0 +1,78 @@
+import { type InterpolationMode } from "../vite/interpolation-plugin.js";
+export interface ClientBuildOptions {
+    /** Project root (absolute). */
+    root: string;
+    /** Absolute path to the user's Vite client config (e.g. vite.client.config.ts). */
+    userConfigPath: string;
+    /** Absolute path to the app directory (used by the interpolation plugin). */
+    appDir: string;
+    /** Absolute path to the islands directory (used by the interpolation plugin). */
+    islandsDir: string;
+    /** Output directory for the client bundle (absolute). */
+    outDir: string;
+    /** Optional base path. */
+    base?: string;
+    /** Optional log prefix. */
+    logPrefix?: string;
+    /**
+     * How the legacy interpolation transform is handled (default: "auto").
+     * With a Elur core that supports partial attribute interpolation natively
+     * the transform is not applied; use "legacy" for migrations against older
+     * cores and "off" to never transform.
+     */
+    interpolation?: InterpolationMode;
+}
+export interface ClientBuildResult {
+    /** Output directory (same as `outDir` input). */
+    outDir: string;
+    /** Number of chunks/assets emitted, if reported by Vite. */
+    outputCount: number;
+}
+/**
+ * Build the client hydration bundle using the Vite JavaScript API.
+ *
+ * The user's config is loaded programmatically and the elur interpolation
+ * plugin is injected so partial attribute interpolations inside islands are
+ * transformed before reaching the browser.
+ */
+export declare function buildClientBundle(options: ClientBuildOptions): Promise<ClientBuildResult>;
+export interface AtomicStageOptions {
+    /** Final destination directory (absolute). */
+    outDir: string;
+    /** Build into this temp directory first, then rename to `outDir`. */
+    tempDir?: string;
+    /** Whether to preserve existing content in `outDir` during the swap. */
+    keepExisting?: boolean;
+}
+export interface AtomicStage {
+    tempDir: string;
+    /** Call after the build succeeds to atomically swap temp → outDir. */
+    commit: () => Promise<void>;
+    /** Call on failure to clean up the temp directory. */
+    rollback: () => Promise<void>;
+}
+/**
+ * Prepare an atomic staging directory for build output.
+ *
+ * Usage:
+ *   const stage = await beginAtomicStage({ outDir });
+ *   try {
+ *     await buildInto(stage.tempDir);
+ *     await stage.commit();
+ *   } catch (err) {
+ *     await stage.rollback();
+ *     throw err;
+ *   }
+ */
+export declare function beginAtomicStage(options: AtomicStageOptions): Promise<AtomicStage>;
+export interface CopyPublicAssetsOptions {
+    /** Absolute path to the public directory. */
+    publicDir: string;
+    /** Absolute path to the output directory. */
+    outDir: string;
+}
+/**
+ * Copy the public directory into the output directory.
+ * Returns the number of files copied.
+ */
+export declare function copyPublicAssets(options: CopyPublicAssetsOptions): Promise<number>;