@elurjs/kit 2.4.4

package/dist/lib/vite/index.js

@@ -0,0 +1,229 @@
+import { a as e, c as t, l as n, n as r, o as i, t as a } from "../node-http-DRAUhO0c.js";
+import { t as o } from "../route-scanner-XcLId7lK.js";
+import { t as s } from "../scan-Dn93ycXG.js";
+import { a as c, i as l, n as u, o as d, r as f, s as p, t as m } from "../interpolation-plugin-Bt-KRKVY.js";
+import { n as h, t as g } from "../scan-CjMUgnsd.js";
+import { s as _, t as v } from "../collections-Dbc8aRLf.js";
+import { mkdir as y, writeFile as b } from "node:fs/promises";
+import { dirname as x, relative as S, resolve as C } from "node:path";
+//#region src/vite/index.ts
+function w(t = {}) {
+	let n = t.appDir ?? "src/app", i = t.islandsDir ?? "src/islands", m = t.contentDir ?? "src/content", S = t.generatedEntry ?? ".elur/entry-client.ts", w = t.clientEntry ?? "/_elur/entry-client.js", A = t.lang ?? "es", j = t.hydrateImport ?? "@elurjs/kit/island", M = t.routerImport ?? "@elurjs/kit/router", N = null, P = {}, F = ".", I = null, L = {
+		name: "elur-kit",
+		enforce: "pre",
+		async configResolved(e) {
+			F = e.root;
+			let t = C(F, S), r = await s(C(F, i)), a = p(r, t, j, M);
+			await y(x(t), { recursive: !0 }), await b(t, a, "utf8");
+			let c = C(F, n);
+			N = await o(c), P = await h(c), _(C(F, m)), I = await l(F);
+		},
+		configureServer(s) {
+			let l = E(s, F), u = D(() => P, () => N, l), f = C(F, n);
+			T(s, f, C(F, i), C(F, m), F, S, j, M, () => {
+				N = null, P = {}, v();
+			}), s.middlewares.use(async (n, i, p) => {
+				let m = new URL(n.url ?? "/", `http://${n.headers.host ?? "localhost"}`), _ = m.pathname;
+				if (_ === "/__elur-js/actions" && n.method === "POST") {
+					try {
+						let e = await O(n), o = a(n, e), s = await r(o, u, t.actionSecurity);
+						i.writeHead(s.status, Object.fromEntries(s.headers.entries())), i.end(await s.text());
+					} catch (e) {
+						console.error("[elur-kit] action error:", e), i.writeHead(500, { "Content-Type": "text/plain; charset=utf-8" }), i.end(String(e));
+					}
+					return;
+				}
+				if (_.startsWith("/_elur/entry-client.js")) {
+					let e = await s.transformRequest("/.elur/entry-client.ts");
+					if (e) {
+						i.writeHead(200, {
+							"Content-Type": "application/javascript; charset=utf-8",
+							"Cache-Control": "no-store, must-revalidate"
+						}), i.end(e.code);
+						return;
+					}
+				}
+				let v = N ??= await o(f), y = Object.keys(P).length ? P : P = await h(f);
+				if (_ === "/__elur-js/render") {
+					let { renderPageBody: e, RouteNotFoundError: t } = await import("../stream-CpOG052V.js").then((e) => e.i);
+					try {
+						let t = m.searchParams.get("page") ?? "/", r = m.searchParams.get("search") ?? "", o = (n.headers.accept ?? "").includes("application/json"), s = a(n), { body: c, title: u, head: d, clearActionErrorCookie: f } = await e({
+							routes: v,
+							pathname: t,
+							searchParams: new URLSearchParams(r),
+							config: {
+								lang: A,
+								clientEntry: w
+							},
+							actions: g(y),
+							importer: l,
+							request: s
+						});
+						if (o) {
+							let e = { "Content-Type": "application/json; charset=utf-8" };
+							f && (e["X-Elur-Action-Clear-Cookie"] = f), i.writeHead(200, e), i.end(JSON.stringify({
+								title: u,
+								body: c,
+								head: d,
+								clearActionErrorCookie: f
+							}));
+						} else {
+							let e = { "Content-Type": "text/html; charset=utf-8" };
+							f && (e["Set-Cookie"] = f), i.writeHead(200, e), i.end(c);
+						}
+						return;
+					} catch (e) {
+						if (e instanceof t) {
+							i.writeHead(404, { "Content-Type": "text/plain; charset=utf-8" }), i.end("Not Found");
+							return;
+						}
+						console.error("[elur-kit] render endpoint error:", e), i.writeHead(500, { "Content-Type": "text/plain; charset=utf-8" }), i.end(String(e));
+						return;
+					}
+				}
+				if (!_.startsWith("/@") && !_.startsWith("/node_modules/") && !_.includes(".")) {
+					let t = e(_, v.api);
+					if (t) {
+						try {
+							let e = (await l(t.route.routePath))[n.method ?? "GET"];
+							if (typeof e != "function") {
+								i.writeHead(405, { "Content-Type": "text/plain" }), i.end(`Method not allowed: ${n.method}`);
+								return;
+							}
+							let r = n.method && n.method !== "GET" && n.method !== "HEAD" ? await O(n) : void 0, o = await e(a(n, r), { params: t.params });
+							i.writeHead(o.status, Object.fromEntries(o.headers.entries())), i.end(Buffer.from(await o.arrayBuffer()));
+						} catch (e) {
+							console.error("[elur-kit] API route error:", e), i.writeHead(500, { "Content-Type": "text/plain; charset=utf-8" }), i.end(String(e));
+						}
+						return;
+					}
+				}
+				let b;
+				if (I && c(_, I.config)) {
+					let e = await d(I, a(n));
+					if (e.kind === "response") {
+						i.writeHead(e.response.status, Object.fromEntries(e.response.headers.entries())), i.end(Buffer.from(await e.response.arrayBuffer()));
+						return;
+					}
+					b = e.headers;
+				}
+				await k(n, i, p, {
+					routes: v,
+					actions: y,
+					clientEntry: w,
+					lang: A,
+					ssrLoad: l,
+					middlewareHeaders: b
+				}) || p();
+			});
+		}
+	};
+	return f(t.interpolation ?? "auto") ? [L, u({
+		appDir: n,
+		islandsDir: i
+	})] : [L];
+}
+function T(e, t, n, r, i, a, o, c, l) {
+	let u = (e) => e.startsWith(t) || e.startsWith(n) || e.startsWith(r);
+	async function d() {
+		let t = await s(n), r = C(i, a), l = p(t, r, o, c);
+		await y(x(r), { recursive: !0 }), await b(r, l, "utf8");
+		let u = e.moduleGraph.getModuleById(r);
+		u && e.moduleGraph.invalidateModule(u);
+	}
+	e.watcher.on("change", async (t) => {
+		if (!u(t)) return;
+		l();
+		let i = e.moduleGraph.getModuleById(t);
+		i && e.moduleGraph.invalidateModule(i), t.startsWith(n) ? (await d(), console.log("[elur-kit] HMR reload islands after change:", t)) : t.startsWith(r) && t.endsWith(".md") ? console.log("[elur-kit] HMR content changed:", t) : (t.includes(".action.ts") || t.includes(".data.ts") || t.includes("page.ts") || t.includes("layout.ts")) && console.log("[elur-kit] HMR reload routes/actions after change:", t);
+	}), e.watcher.on("add", async (e) => {
+		u(e) && (l(), e.startsWith(n) && await d(), console.log("[elur-kit] HMR new file detected:", e));
+	}), e.watcher.on("unlink", async (t) => {
+		if (!u(t)) return;
+		l();
+		let r = e.moduleGraph.getModuleById(t);
+		r && e.moduleGraph.invalidateModule(r), t.startsWith(n) && await d(), console.log("[elur-kit] HMR file removed:", t);
+	});
+}
+function E(e, t) {
+	return (n) => {
+		let r = "/" + S(t, n).split("\\").join("/");
+		return e.ssrLoadModule(r);
+	};
+}
+function D(e, t, n) {
+	return async (r, a) => {
+		let o = e(), s = t(), c;
+		a && s && (c = s.pages.some((e) => e.path === a) ? a : i(a, s.pages)?.route.path ?? a);
+		let l = c ? o[c] : Object.values(o).find((e) => e[r]) ?? void 0, u = l ? l[r] : void 0;
+		if (!u) return;
+		let d = (await n(u))[r];
+		if (typeof d == "function") return d;
+	};
+}
+function O(e) {
+	return new Promise((t, n) => {
+		let r = "";
+		e.setEncoding("utf8"), e.on("data", (e) => {
+			r += e;
+		}), e.on("end", () => t(r)), e.on("error", n);
+	});
+}
+async function k(e, r, o, s) {
+	if (!s.routes) return !1;
+	let c = g(s.actions), l = e.url ?? "/";
+	if (l.includes("?") && (l = l.split("?")[0]), l.startsWith("/@") || l.startsWith("/node_modules/") || l.includes(".")) return !1;
+	let u = {
+		lang: s.lang,
+		clientEntry: s.clientEntry
+	}, d = i(l, s.routes.pages);
+	if (d) try {
+		let t = a(e);
+		if (s.middlewareHeaders) for (let [e, n] of Object.entries(s.middlewareHeaders)) t.headers.set(e, n);
+		let { html: i, clearActionErrorCookie: o } = await n({
+			route: d.route,
+			params: d.params,
+			searchParams: new URLSearchParams(e.url?.split("?")[1] ?? ""),
+			config: u,
+			importer: s.ssrLoad,
+			actions: c,
+			request: t
+		}), l = {
+			"Content-Type": "text/html; charset=utf-8",
+			"Cache-Control": "no-store, must-revalidate"
+		};
+		return o && (l["Set-Cookie"] = o), r.writeHead(200, l), r.end(i), !0;
+	} catch (e) {
+		console.error("[elur-kit] SSR render error:", e);
+		let n = await t({
+			routes: s.routes,
+			status: 500,
+			error: e,
+			config: u,
+			actions: c,
+			importer: s.ssrLoad
+		});
+		return n ? (r.writeHead(n.status, {
+			"Content-Type": "text/html; charset=utf-8",
+			"Cache-Control": "no-store, must-revalidate"
+		}), r.end(n.html)) : (r.writeHead(500, {
+			"Content-Type": "text/plain; charset=utf-8",
+			"Cache-Control": "no-store, must-revalidate"
+		}), r.end(String(e))), !0;
+	}
+	let f = await t({
+		routes: s.routes,
+		status: 404,
+		config: u,
+		actions: c,
+		importer: s.ssrLoad
+	});
+	return f ? (r.writeHead(f.status, {
+		"Content-Type": "text/html; charset=utf-8",
+		"Cache-Control": "no-store, must-revalidate"
+	}), r.end(f.html), !0) : !1;
+}
+//#endregion
+export { m as coreSupportsPartialInterpolation, u as elurJsInterpolationPlugin, w as elurJsKit, f as shouldUseLegacyInterpolation };
+
+//# sourceMappingURL=index.js.map

package/dist/lib/vite/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../../../src/vite/index.ts"],"sourcesContent":["import { mkdir, writeFile } from \"node:fs/promises\";\nimport { dirname, relative, resolve } from \"node:path\";\nimport type { Plugin, Connect, ViteDevServer } from \"vite\";\nimport { scanRoutes } from \"../router/route-scanner.js\";\nimport { scanActions, actionNames, type ActionRegistry } from \"../action/scan.js\";\nimport { handleActionRequest, type ActionSecurityOptions } from \"../action/server.js\";\nimport { scanIslands } from \"../island/scan.js\";\nimport { buildEntrySource } from \"../island/generate-entry.js\";\nimport { matchApiRoute, matchRoute } from \"../ssr/match.js\";\nimport { renderPage, renderErrorPage } from \"../ssr/render.js\";\nimport { setContentRoot, clearContentCache } from \"../content/collections.js\";\nimport { loadMiddleware, matchesMiddleware, runMiddleware, type LoadedMiddleware } from \"../middleware/index.js\";\nimport { elurJsInterpolationPlugin, shouldUseLegacyInterpolation, type InterpolationMode } from \"./interpolation-plugin.js\";\nimport { incomingMessageToRequest } from \"../runtime/node-http.js\";\n\nexport interface ElurJsKitViteOptions {\n  /** App directory relative to Vite root (default: src/app). */\n  appDir?: string;\n  /** Islands directory relative to Vite root (default: src/islands). */\n  islandsDir?: string;\n  /** Content directory relative to Vite root (default: src/content). */\n  contentDir?: string;\n  /** Where to write the generated client entry (default: .elur/entry-client.ts). */\n  generatedEntry?: string;\n  /** Public path for the client entry module (default: /_elur/entry-client.js). */\n  clientEntry?: string;\n  /** HTML lang attribute (default: es). */\n  lang?: string;\n  /** Import specifier for hydrateIslands in the generated entry. */\n  hydrateImport?: string;\n  /** Import specifier for startClientRouter in the generated entry. */\n  routerImport?: string;\n  /** CSRF / origin policy applied to the server actions endpoint in dev. */\n  actionSecurity?: ActionSecurityOptions;\n  /**\n   * How the legacy interpolation transform is handled (default: \"auto\").\n   * With a Elur core that supports partial attribute interpolation natively\n   * the transform is not applied; use \"legacy\" for migrations against older\n   * cores and \"off\" to never transform.\n   */\n  interpolation?: InterpolationMode;\n}\n\n/**\n * Official Vite plugin for elur-kit.\n *\n * In dev mode it generates the islands entry and renders every page via SSR.\n * In production builds it can be combined with `elur-kit build` to generate\n * static HTML files.\n */\nexport function elurJsKit(options: ElurJsKitViteOptions = {}): Plugin[] {\n  const appDir = options.appDir ?? \"src/app\";\n  const islandsDir = options.islandsDir ?? \"src/islands\";\n  const contentDir = options.contentDir ?? \"src/content\";\n  const generatedEntry = options.generatedEntry ?? \".elur/entry-client.ts\";\n  const clientEntry = options.clientEntry ?? \"/_elur/entry-client.js\";\n  const lang = options.lang ?? \"es\";\n  const hydrateImport = options.hydrateImport ?? \"@elurjs/kit/island\";\n  const routerImport = options.routerImport ?? \"@elurjs/kit/router\";\n\n  let routes: Awaited<ReturnType<typeof scanRoutes>> | null = null;\n  let actions: ActionRegistry = {};\n  let root: string = \".\";\n  let middleware: LoadedMiddleware | null = null;\n\n  const mainPlugin: Plugin = {\n    name: \"elur-kit\",\n    enforce: \"pre\",\n\n    async configResolved(config) {\n      root = config.root;\n      const entryPath = resolve(root, generatedEntry);\n      const islands = await scanIslands(resolve(root, islandsDir));\n      const source = buildEntrySource(islands, entryPath, hydrateImport, routerImport);\n      await mkdir(dirname(entryPath), { recursive: true });\n      await writeFile(entryPath, source, \"utf8\");\n\n      const appDirPath = resolve(root, appDir);\n      routes = await scanRoutes(appDirPath);\n      actions = await scanActions(appDirPath);\n\n      // Wire up the content layer root so getCollection/getEntry resolve\n      // from the user's src/content directory.\n      setContentRoot(resolve(root, contentDir));\n\n      // Load user middleware (src/middleware.ts) if it exists.\n      middleware = await loadMiddleware(root);\n    },\n\n    configureServer(server) {\n      const ssrLoad = createSsrLoader(server, root);\n      const resolveAction = createActionResolver(() => actions, () => routes, ssrLoad);\n\n      const appDirPath = resolve(root, appDir);\n      const islandsDirPath = resolve(root, islandsDir);\n      const contentDirPath = resolve(root, contentDir);\n      setupHmr(server, appDirPath, islandsDirPath, contentDirPath, root, generatedEntry, hydrateImport, routerImport, () => {\n        routes = null;\n        actions = {};\n        clearContentCache();\n      });\n\n      server.middlewares.use(async (req, res, next) => {\n        const requestUrl = new URL(req.url ?? \"/\", `http://${req.headers.host ?? \"localhost\"}`);\n        const urlPath = requestUrl.pathname;\n\n        // Server actions endpoint.\n        if (urlPath === \"/__elur-js/actions\" && req.method === \"POST\") {\n          try {\n            const body = await readRequestBody(req);\n            const request = incomingMessageToRequest(req, body);\n            const response = await handleActionRequest(request, resolveAction, options.actionSecurity);\n            res.writeHead(response.status, Object.fromEntries(response.headers.entries()));\n            res.end(await response.text());\n          } catch (err) {\n            console.error(\"[elur-kit] action error:\", err);\n            res.writeHead(500, { \"Content-Type\": \"text/plain; charset=utf-8\" });\n            res.end(String(err));\n          }\n          return;\n        }\n\n        if (urlPath.startsWith(\"/_elur/entry-client.js\")) {\n          const transformed = await server.transformRequest(\n            \"/.elur/entry-client.ts\",\n          );\n          if (transformed) {\n            res.writeHead(200, {\n              \"Content-Type\": \"application/javascript; charset=utf-8\",\n              \"Cache-Control\": \"no-store, must-revalidate\",\n            });\n            res.end(transformed.code);\n            return;\n          }\n        }\n\n        const currentRoutes = routes ?? (routes = await scanRoutes(appDirPath));\n        const currentActions = Object.keys(actions).length ? actions : (actions = await scanActions(appDirPath));\n\n        // Render endpoint used by the SPA router and streaming boundaries.\n        if (urlPath === \"/__elur-js/render\") {\n          const { renderPageBody, RouteNotFoundError } = await import(\"../ssr/stream.js\");\n          try {\n            const page = requestUrl.searchParams.get(\"page\") ?? \"/\";\n            const search = requestUrl.searchParams.get(\"search\") ?? \"\";\n            const wantsJson = (req.headers[\"accept\"] ?? \"\").includes(\"application/json\");\n            const request = incomingMessageToRequest(req);\n            const { body, title, head, clearActionErrorCookie } = await renderPageBody({\n              routes: currentRoutes,\n              pathname: page,\n              searchParams: new URLSearchParams(search),\n              config: { lang, clientEntry },\n              actions: actionNames(currentActions),\n              importer: ssrLoad,\n              request,\n            });\n            if (wantsJson) {\n              const headers: Record<string, string> = { \"Content-Type\": \"application/json; charset=utf-8\" };\n              if (clearActionErrorCookie) headers[\"X-Elur-Action-Clear-Cookie\"] = clearActionErrorCookie;\n              res.writeHead(200, headers);\n              res.end(JSON.stringify({ title, body, head, clearActionErrorCookie }));\n            } else {\n              const headers: Record<string, string> = { \"Content-Type\": \"text/html; charset=utf-8\" };\n              if (clearActionErrorCookie) headers[\"Set-Cookie\"] = clearActionErrorCookie;\n              res.writeHead(200, headers);\n              res.end(body);\n            }\n            return;\n          } catch (err) {\n            if (err instanceof RouteNotFoundError) {\n              res.writeHead(404, { \"Content-Type\": \"text/plain; charset=utf-8\" });\n              res.end(\"Not Found\");\n              return;\n            }\n            console.error(\"[elur-kit] render endpoint error:\", err);\n            res.writeHead(500, { \"Content-Type\": \"text/plain; charset=utf-8\" });\n            res.end(String(err));\n            return;\n          }\n        }\n\n        if (!urlPath.startsWith(\"/@\") && !urlPath.startsWith(\"/node_modules/\") && !urlPath.includes(\".\")) {\n          const apiMatch = matchApiRoute(urlPath, currentRoutes.api);\n          if (apiMatch) {\n            try {\n              const mod = (await ssrLoad(apiMatch.route.routePath)) as Record<\n                string,\n                (request: Request, context?: { params: Record<string, string | string[]> }) => unknown\n              >;\n              const handler = mod[req.method ?? \"GET\"];\n              if (typeof handler !== \"function\") {\n                res.writeHead(405, { \"Content-Type\": \"text/plain\" });\n                res.end(`Method not allowed: ${req.method}`);\n                return;\n              }\n              const body = req.method && req.method !== \"GET\" && req.method !== \"HEAD\" ? await readRequestBody(req) : undefined;\n              const request = incomingMessageToRequest(req, body);\n              const response = (await handler(request, { params: apiMatch.params })) as Response;\n              res.writeHead(response.status, Object.fromEntries(response.headers.entries()));\n              res.end(Buffer.from(await response.arrayBuffer()));\n            } catch (err) {\n              console.error(\"[elur-kit] API route error:\", err);\n              res.writeHead(500, { \"Content-Type\": \"text/plain; charset=utf-8\" });\n              res.end(String(err));\n            }\n            return;\n          }\n        }\n\n        // Run middleware before SSR rendering.\n        let middlewareHeaders: Record<string, string> | undefined;\n        if (middleware && matchesMiddleware(urlPath, middleware.config)) {\n          const mwResult = await runMiddleware(middleware, incomingMessageToRequest(req));\n          if (mwResult.kind === \"response\") {\n            res.writeHead(mwResult.response.status, Object.fromEntries(mwResult.response.headers.entries()));\n            res.end(Buffer.from(await mwResult.response.arrayBuffer()));\n            return;\n          }\n          middlewareHeaders = mwResult.headers;\n        }\n\n        const handled = await handleSsrRequest(req, res, next, {\n          routes: currentRoutes,\n          actions: currentActions,\n          clientEntry,\n          lang,\n          ssrLoad,\n          middlewareHeaders,\n        });\n        if (!handled) next();\n      });\n    },\n  };\n\n  return shouldUseLegacyInterpolation(options.interpolation ?? \"auto\")\n    ? [mainPlugin, elurJsInterpolationPlugin({ appDir, islandsDir })]\n    : [mainPlugin];\n}\n\nexport { elurJsInterpolationPlugin, type InterpolationPluginOptions } from \"./interpolation-plugin.js\";\nexport type { InterpolationMode } from \"./interpolation-plugin.js\";\nexport { coreSupportsPartialInterpolation, shouldUseLegacyInterpolation } from \"./interpolation-plugin.js\";\n\nfunction setupHmr(\n  server: ViteDevServer,\n  appDirPath: string,\n  islandsDirPath: string,\n  contentDirPath: string,\n  root: string,\n  generatedEntry: string,\n  hydrateImport: string,\n  routerImport: string,\n  invalidate: () => void,\n) {\n  const isRelevant = (path: string) =>\n    path.startsWith(appDirPath) || path.startsWith(islandsDirPath) || path.startsWith(contentDirPath);\n\n  async function regenerateIslandEntry() {\n    const islands = await scanIslands(islandsDirPath);\n    const entryPath = resolve(root, generatedEntry);\n    const source = buildEntrySource(islands, entryPath, hydrateImport, routerImport);\n    await mkdir(dirname(entryPath), { recursive: true });\n    await writeFile(entryPath, source, \"utf8\");\n    const entryMod = server.moduleGraph.getModuleById(entryPath);\n    if (entryMod) server.moduleGraph.invalidateModule(entryMod);\n  }\n\n  server.watcher.on(\"change\", async (path) => {\n    if (!isRelevant(path)) return;\n    invalidate();\n    const mod = server.moduleGraph.getModuleById(path);\n    if (mod) server.moduleGraph.invalidateModule(mod);\n    if (path.startsWith(islandsDirPath)) {\n      await regenerateIslandEntry();\n      console.log(\"[elur-kit] HMR reload islands after change:\", path);\n    } else if (path.startsWith(contentDirPath) && path.endsWith(\".md\")) {\n      console.log(\"[elur-kit] HMR content changed:\", path);\n    } else if (path.includes(\".action.ts\") || path.includes(\".data.ts\") || path.includes(\"page.ts\") || path.includes(\"layout.ts\")) {\n      console.log(\"[elur-kit] HMR reload routes/actions after change:\", path);\n    }\n  });\n\n  server.watcher.on(\"add\", async (path) => {\n    if (!isRelevant(path)) return;\n    invalidate();\n    if (path.startsWith(islandsDirPath)) {\n      await regenerateIslandEntry();\n    }\n    console.log(\"[elur-kit] HMR new file detected:\", path);\n  });\n\n  server.watcher.on(\"unlink\", async (path) => {\n    if (!isRelevant(path)) return;\n    invalidate();\n    const mod = server.moduleGraph.getModuleById(path);\n    if (mod) server.moduleGraph.invalidateModule(mod);\n    if (path.startsWith(islandsDirPath)) {\n      await regenerateIslandEntry();\n    }\n    console.log(\"[elur-kit] HMR file removed:\", path);\n  });\n}\n\nfunction createSsrLoader(server: ViteDevServer, root: string) {\n  return (filePath: string) => {\n    const rel = relative(root, filePath);\n    const url = \"/\" + rel.split(\"\\\\\").join(\"/\");\n    return server.ssrLoadModule(url);\n  };\n}\n\nfunction createActionResolver(\n  getActions: () => import(\"../action/scan.js\").ActionRegistry,\n  getRoutes: () => Awaited<ReturnType<typeof scanRoutes>> | null,\n  ssrLoad: (path: string) => Promise<unknown>,\n) {\n  return async (name: string, page?: string) => {\n    const actions = getActions();\n    const routes = getRoutes();\n    let pageKey: string | undefined;\n    if (page && routes) {\n      pageKey = routes.pages.some((route) => route.path === page)\n        ? page\n        : (matchRoute(page, routes.pages)?.route.path ?? page);\n    }\n    const pageActions = pageKey ? actions[pageKey] : Object.values(actions).find((p) => p[name]) ?? undefined;\n    const actionPath = pageActions ? pageActions[name] : undefined;\n    if (!actionPath) return undefined;\n    const mod = (await ssrLoad(actionPath)) as Record<string, unknown>;\n    const action = mod[name];\n    if (typeof action === \"function\") {\n      return action as (...args: unknown[]) => unknown;\n    }\n    return undefined;\n  };\n}\n\nfunction readRequestBody(req: Connect.IncomingMessage): Promise<string> {\n  return new Promise((resolve, reject) => {\n    let body = \"\";\n    req.setEncoding(\"utf8\");\n    req.on(\"data\", (chunk) => {\n      body += chunk;\n    });\n    req.on(\"end\", () => resolve(body));\n    req.on(\"error\", reject);\n  });\n}\n\ninterface SsrHandlerOptions {\n  routes: Awaited<ReturnType<typeof scanRoutes>> | null;\n  actions: ActionRegistry;\n  clientEntry: string;\n  lang: string;\n  ssrLoad: (path: string) => Promise<unknown>;\n  middlewareHeaders?: Record<string, string>;\n}\n\nasync function handleSsrRequest(\n  req: Connect.IncomingMessage,\n  res: import(\"node:http\").ServerResponse,\n  _next: Connect.NextFunction,\n  options: SsrHandlerOptions,\n): Promise<boolean> {\n  if (!options.routes) return false;\n  const publicActions = actionNames(options.actions);\n\n  let urlPath = req.url ?? \"/\";\n  if (urlPath.includes(\"?\")) urlPath = urlPath.split(\"?\")[0];\n\n  // Let Vite handle its own internals and assets.\n  if (urlPath.startsWith(\"/@\") || urlPath.startsWith(\"/node_modules/\")) {\n    return false;\n  }\n\n  // Skip explicit file requests.\n  if (urlPath.includes(\".\")) return false;\n\n  const config = { lang: options.lang, clientEntry: options.clientEntry };\n  const match = matchRoute(urlPath, options.routes.pages);\n  if (match) {\n    try {\n      const request = incomingMessageToRequest(req);\n      if (options.middlewareHeaders) {\n        for (const [name, value] of Object.entries(options.middlewareHeaders)) request.headers.set(name, value);\n      }\n      const { html, clearActionErrorCookie } = await renderPage({\n        route: match.route,\n        params: match.params,\n        searchParams: new URLSearchParams(req.url?.split(\"?\")[1] ?? \"\"),\n        config,\n        importer: options.ssrLoad,\n        actions: publicActions,\n        request,\n      });\n      const responseHeaders: Record<string, string> = {\n        \"Content-Type\": \"text/html; charset=utf-8\",\n        \"Cache-Control\": \"no-store, must-revalidate\",\n      };\n      if (clearActionErrorCookie) responseHeaders[\"Set-Cookie\"] = clearActionErrorCookie;\n      res.writeHead(200, responseHeaders);\n      res.end(html);\n      return true;\n    } catch (err) {\n      console.error(\"[elur-kit] SSR render error:\", err);\n      const errorResult = await renderErrorPage({\n        routes: options.routes,\n        status: 500,\n        error: err,\n        config,\n        actions: publicActions,\n        importer: options.ssrLoad,\n      });\n      if (errorResult) {\n        res.writeHead(errorResult.status, {\n          \"Content-Type\": \"text/html; charset=utf-8\",\n          \"Cache-Control\": \"no-store, must-revalidate\",\n        });\n        res.end(errorResult.html);\n      } else {\n        res.writeHead(500, {\n          \"Content-Type\": \"text/plain; charset=utf-8\",\n          \"Cache-Control\": \"no-store, must-revalidate\",\n        });\n        res.end(String(err));\n      }\n      return true;\n    }\n  }\n\n  const errorResult = await renderErrorPage({\n    routes: options.routes,\n    status: 404,\n    config,\n    actions: publicActions,\n    importer: options.ssrLoad,\n  });\n  if (errorResult) {\n    res.writeHead(errorResult.status, {\n      \"Content-Type\": \"text/html; charset=utf-8\",\n      \"Cache-Control\": \"no-store, must-revalidate\",\n    });\n    res.end(errorResult.html);\n    return true;\n  }\n\n  return false;\n}\n"],"mappings":";;;;;;;;;AAkDA,SAAgB,EAAU,IAAgC,CAAC,GAAa;CACtE,IAAM,IAAS,EAAQ,UAAU,WAC3B,IAAa,EAAQ,cAAc,eACnC,IAAa,EAAQ,cAAc,eACnC,IAAiB,EAAQ,kBAAkB,yBAC3C,IAAc,EAAQ,eAAe,0BACrC,IAAO,EAAQ,QAAQ,MACvB,IAAgB,EAAQ,iBAAiB,sBACzC,IAAe,EAAQ,gBAAgB,sBAEzC,IAAwD,MACxD,IAA0B,CAAC,GAC3B,IAAe,KACf,IAAsC,MAEpC,IAAqB;EACzB,MAAM;EACN,SAAS;EAET,MAAM,eAAe,GAAQ;GAC3B,IAAO,EAAO;GACd,IAAM,IAAY,EAAQ,GAAM,CAAc,GACxC,IAAU,MAAM,EAAY,EAAQ,GAAM,CAAU,CAAC,GACrD,IAAS,EAAiB,GAAS,GAAW,GAAe,CAAY;GAE/E,AADA,MAAM,EAAM,EAAQ,CAAS,GAAG,EAAE,WAAW,GAAK,CAAC,GACnD,MAAM,EAAU,GAAW,GAAQ,MAAM;GAEzC,IAAM,IAAa,EAAQ,GAAM,CAAM;GASvC,AARA,IAAS,MAAM,EAAW,CAAU,GACpC,IAAU,MAAM,EAAY,CAAU,GAItC,EAAe,EAAQ,GAAM,CAAU,CAAC,GAGxC,IAAa,MAAM,EAAe,CAAI;EACxC;EAEA,gBAAgB,GAAQ;GACtB,IAAM,IAAU,EAAgB,GAAQ,CAAI,GACtC,IAAgB,QAA2B,SAAe,GAAQ,CAAO,GAEzE,IAAa,EAAQ,GAAM,CAAM;GASvC,AANA,EAAS,GAAQ,GAFM,EAAQ,GAAM,CAER,GADN,EAAQ,GAAM,CACQ,GAAgB,GAAM,GAAgB,GAAe,SAAoB;IAGpH,AAFA,IAAS,MACT,IAAU,CAAC,GACX,EAAkB;GACpB,CAAC,GAED,EAAO,YAAY,IAAI,OAAO,GAAK,GAAK,MAAS;IAC/C,IAAM,IAAa,IAAI,IAAI,EAAI,OAAO,KAAK,UAAU,EAAI,QAAQ,QAAQ,aAAa,GAChF,IAAU,EAAW;IAG3B,IAAI,MAAY,wBAAwB,EAAI,WAAW,QAAQ;KAC7D,IAAI;MACF,IAAM,IAAO,MAAM,EAAgB,CAAG,GAChC,IAAU,EAAyB,GAAK,CAAI,GAC5C,IAAW,MAAM,EAAoB,GAAS,GAAe,EAAQ,cAAc;MAEzF,AADA,EAAI,UAAU,EAAS,QAAQ,OAAO,YAAY,EAAS,QAAQ,QAAQ,CAAC,CAAC,GAC7E,EAAI,IAAI,MAAM,EAAS,KAAK,CAAC;KAC/B,SAAS,GAAK;MAGZ,AAFA,QAAQ,MAAM,4BAA4B,CAAG,GAC7C,EAAI,UAAU,KAAK,EAAE,gBAAgB,4BAA4B,CAAC,GAClE,EAAI,IAAI,OAAO,CAAG,CAAC;KACrB;KACA;IACF;IAEA,IAAI,EAAQ,WAAW,wBAAwB,GAAG;KAChD,IAAM,IAAc,MAAM,EAAO,iBAC/B,wBACF;KACA,IAAI,GAAa;MAKf,AAJA,EAAI,UAAU,KAAK;OACjB,gBAAgB;OAChB,iBAAiB;MACnB,CAAC,GACD,EAAI,IAAI,EAAY,IAAI;MACxB;KACF;IACF;IAEA,IAAM,IAAgB,AAAW,MAAS,MAAM,EAAW,CAAU,GAC/D,IAAiB,OAAO,KAAK,CAAO,CAAC,CAAC,SAAS,IAAW,IAAU,MAAM,EAAY,CAAU;IAGtG,IAAI,MAAY,qBAAqB;KACnC,IAAM,EAAE,mBAAgB,0BAAuB,MAAM,OAAO,wBAAA,CAAA,MAAA,MAAA,EAAA,CAAA;KAC5D,IAAI;MACF,IAAM,IAAO,EAAW,aAAa,IAAI,MAAM,KAAK,KAC9C,IAAS,EAAW,aAAa,IAAI,QAAQ,KAAK,IAClD,KAAa,EAAI,QAAQ,UAAa,GAAA,CAAI,SAAS,kBAAkB,GACrE,IAAU,EAAyB,CAAG,GACtC,EAAE,SAAM,UAAO,SAAM,8BAA2B,MAAM,EAAe;OACzE,QAAQ;OACR,UAAU;OACV,cAAc,IAAI,gBAAgB,CAAM;OACxC,QAAQ;QAAE;QAAM;OAAY;OAC5B,SAAS,EAAY,CAAc;OACnC,UAAU;OACV;MACF,CAAC;MACD,IAAI,GAAW;OACb,IAAM,IAAkC,EAAE,gBAAgB,kCAAkC;OAG5F,AAFI,MAAwB,EAAQ,gCAAgC,IACpE,EAAI,UAAU,KAAK,CAAO,GAC1B,EAAI,IAAI,KAAK,UAAU;QAAE;QAAO;QAAM;QAAM;OAAuB,CAAC,CAAC;MACvE,OAAO;OACL,IAAM,IAAkC,EAAE,gBAAgB,2BAA2B;OAGrF,AAFI,MAAwB,EAAQ,gBAAgB,IACpD,EAAI,UAAU,KAAK,CAAO,GAC1B,EAAI,IAAI,CAAI;MACd;MACA;KACF,SAAS,GAAK;MACZ,IAAI,aAAe,GAAoB;OAErC,AADA,EAAI,UAAU,KAAK,EAAE,gBAAgB,4BAA4B,CAAC,GAClE,EAAI,IAAI,WAAW;OACnB;MACF;MAGA,AAFA,QAAQ,MAAM,qCAAqC,CAAG,GACtD,EAAI,UAAU,KAAK,EAAE,gBAAgB,4BAA4B,CAAC,GAClE,EAAI,IAAI,OAAO,CAAG,CAAC;MACnB;KACF;IACF;IAEA,IAAI,CAAC,EAAQ,WAAW,IAAI,KAAK,CAAC,EAAQ,WAAW,gBAAgB,KAAK,CAAC,EAAQ,SAAS,GAAG,GAAG;KAChG,IAAM,IAAW,EAAc,GAAS,EAAc,GAAG;KACzD,IAAI,GAAU;MACZ,IAAI;OAKF,IAAM,KAAU,MAJG,EAAQ,EAAS,MAAM,SAAS,EAAA,CAI/B,EAAI,UAAU;OAClC,IAAI,OAAO,KAAY,YAAY;QAEjC,AADA,EAAI,UAAU,KAAK,EAAE,gBAAgB,aAAa,CAAC,GACnD,EAAI,IAAI,uBAAuB,EAAI,QAAQ;QAC3C;OACF;OACA,IAAM,IAAO,EAAI,UAAU,EAAI,WAAW,SAAS,EAAI,WAAW,SAAS,MAAM,EAAgB,CAAG,IAAI,KAAA,GAElG,IAAY,MAAM,EADR,EAAyB,GAAK,CACd,GAAS,EAAE,QAAQ,EAAS,OAAO,CAAC;OAEpE,AADA,EAAI,UAAU,EAAS,QAAQ,OAAO,YAAY,EAAS,QAAQ,QAAQ,CAAC,CAAC,GAC7E,EAAI,IAAI,OAAO,KAAK,MAAM,EAAS,YAAY,CAAC,CAAC;MACnD,SAAS,GAAK;OAGZ,AAFA,QAAQ,MAAM,+BAA+B,CAAG,GAChD,EAAI,UAAU,KAAK,EAAE,gBAAgB,4BAA4B,CAAC,GAClE,EAAI,IAAI,OAAO,CAAG,CAAC;MACrB;MACA;KACF;IACF;IAGA,IAAI;IACJ,IAAI,KAAc,EAAkB,GAAS,EAAW,MAAM,GAAG;KAC/D,IAAM,IAAW,MAAM,EAAc,GAAY,EAAyB,CAAG,CAAC;KAC9E,IAAI,EAAS,SAAS,YAAY;MAEhC,AADA,EAAI,UAAU,EAAS,SAAS,QAAQ,OAAO,YAAY,EAAS,SAAS,QAAQ,QAAQ,CAAC,CAAC,GAC/F,EAAI,IAAI,OAAO,KAAK,MAAM,EAAS,SAAS,YAAY,CAAC,CAAC;MAC1D;KACF;KACA,IAAoB,EAAS;IAC/B;IAUA,AAAK,MARiB,EAAiB,GAAK,GAAK,GAAM;KACrD,QAAQ;KACR,SAAS;KACT;KACA;KACA;KACA;IACF,CAAC,KACa,EAAK;GACrB,CAAC;EACH;CACF;CAEA,OAAO,EAA6B,EAAQ,iBAAiB,MAAM,IAC/D,CAAC,GAAY,EAA0B;EAAE;EAAQ;CAAW,CAAC,CAAC,IAC9D,CAAC,CAAU;AACjB;AAMA,SAAS,EACP,GACA,GACA,GACA,GACA,GACA,GACA,GACA,GACA,GACA;CACA,IAAM,KAAc,MAClB,EAAK,WAAW,CAAU,KAAK,EAAK,WAAW,CAAc,KAAK,EAAK,WAAW,CAAc;CAElG,eAAe,IAAwB;EACrC,IAAM,IAAU,MAAM,EAAY,CAAc,GAC1C,IAAY,EAAQ,GAAM,CAAc,GACxC,IAAS,EAAiB,GAAS,GAAW,GAAe,CAAY;EAE/E,AADA,MAAM,EAAM,EAAQ,CAAS,GAAG,EAAE,WAAW,GAAK,CAAC,GACnD,MAAM,EAAU,GAAW,GAAQ,MAAM;EACzC,IAAM,IAAW,EAAO,YAAY,cAAc,CAAS;EAC3D,AAAI,KAAU,EAAO,YAAY,iBAAiB,CAAQ;CAC5D;CA0BA,AAxBA,EAAO,QAAQ,GAAG,UAAU,OAAO,MAAS;EAC1C,IAAI,CAAC,EAAW,CAAI,GAAG;EACvB,EAAW;EACX,IAAM,IAAM,EAAO,YAAY,cAAc,CAAI;EAEjD,AADI,KAAK,EAAO,YAAY,iBAAiB,CAAG,GAC5C,EAAK,WAAW,CAAc,KAChC,MAAM,EAAsB,GAC5B,QAAQ,IAAI,+CAA+C,CAAI,KACtD,EAAK,WAAW,CAAc,KAAK,EAAK,SAAS,KAAK,IAC/D,QAAQ,IAAI,mCAAmC,CAAI,KAC1C,EAAK,SAAS,YAAY,KAAK,EAAK,SAAS,UAAU,KAAK,EAAK,SAAS,SAAS,KAAK,EAAK,SAAS,WAAW,MAC1H,QAAQ,IAAI,sDAAsD,CAAI;CAE1E,CAAC,GAED,EAAO,QAAQ,GAAG,OAAO,OAAO,MAAS;EAClC,EAAW,CAAI,MACpB,EAAW,GACP,EAAK,WAAW,CAAc,KAChC,MAAM,EAAsB,GAE9B,QAAQ,IAAI,qCAAqC,CAAI;CACvD,CAAC,GAED,EAAO,QAAQ,GAAG,UAAU,OAAO,MAAS;EAC1C,IAAI,CAAC,EAAW,CAAI,GAAG;EACvB,EAAW;EACX,IAAM,IAAM,EAAO,YAAY,cAAc,CAAI;EAKjD,AAJI,KAAK,EAAO,YAAY,iBAAiB,CAAG,GAC5C,EAAK,WAAW,CAAc,KAChC,MAAM,EAAsB,GAE9B,QAAQ,IAAI,gCAAgC,CAAI;CAClD,CAAC;AACH;AAEA,SAAS,EAAgB,GAAuB,GAAc;CAC5D,QAAQ,MAAqB;EAE3B,IAAM,IAAM,MADA,EAAS,GAAM,CACT,CAAA,CAAI,MAAM,IAAI,CAAC,CAAC,KAAK,GAAG;EAC1C,OAAO,EAAO,cAAc,CAAG;CACjC;AACF;AAEA,SAAS,EACP,GACA,GACA,GACA;CACA,OAAO,OAAO,GAAc,MAAkB;EAC5C,IAAM,IAAU,EAAW,GACrB,IAAS,EAAU,GACrB;EACJ,AAAI,KAAQ,MACV,IAAU,EAAO,MAAM,MAAM,MAAU,EAAM,SAAS,CAAI,IACtD,IACC,EAAW,GAAM,EAAO,KAAK,CAAC,EAAE,MAAM,QAAQ;EAErD,IAAM,IAAc,IAAU,EAAQ,KAAW,OAAO,OAAO,CAAO,CAAC,CAAC,MAAM,MAAM,EAAE,EAAK,KAAK,KAAA,GAC1F,IAAa,IAAc,EAAY,KAAQ,KAAA;EACrD,IAAI,CAAC,GAAY;EAEjB,IAAM,KAAS,MADI,EAAQ,CAAU,EAAA,CAClB;EACnB,IAAI,OAAO,KAAW,YACpB,OAAO;CAGX;AACF;AAEA,SAAS,EAAgB,GAA+C;CACtE,OAAO,IAAI,SAAS,GAAS,MAAW;EACtC,IAAI,IAAO;EAMX,AALA,EAAI,YAAY,MAAM,GACtB,EAAI,GAAG,SAAS,MAAU;GACxB,KAAQ;EACV,CAAC,GACD,EAAI,GAAG,aAAa,EAAQ,CAAI,CAAC,GACjC,EAAI,GAAG,SAAS,CAAM;CACxB,CAAC;AACH;AAWA,eAAe,EACb,GACA,GACA,GACA,GACkB;CAClB,IAAI,CAAC,EAAQ,QAAQ,OAAO;CAC5B,IAAM,IAAgB,EAAY,EAAQ,OAAO,GAE7C,IAAU,EAAI,OAAO;CASzB,IARI,EAAQ,SAAS,GAAG,MAAG,IAAU,EAAQ,MAAM,GAAG,CAAC,CAAC,KAGpD,EAAQ,WAAW,IAAI,KAAK,EAAQ,WAAW,gBAAgB,KAK/D,EAAQ,SAAS,GAAG,GAAG,OAAO;CAElC,IAAM,IAAS;EAAE,MAAM,EAAQ;EAAM,aAAa,EAAQ;CAAY,GAChE,IAAQ,EAAW,GAAS,EAAQ,OAAO,KAAK;CACtD,IAAI,GACF,IAAI;EACF,IAAM,IAAU,EAAyB,CAAG;EAC5C,IAAI,EAAQ,mBACV,KAAK,IAAM,CAAC,GAAM,MAAU,OAAO,QAAQ,EAAQ,iBAAiB,GAAG,EAAQ,QAAQ,IAAI,GAAM,CAAK;EAExG,IAAM,EAAE,SAAM,8BAA2B,MAAM,EAAW;GACxD,OAAO,EAAM;GACb,QAAQ,EAAM;GACd,cAAc,IAAI,gBAAgB,EAAI,KAAK,MAAM,GAAG,CAAC,CAAC,MAAM,EAAE;GAC9D;GACA,UAAU,EAAQ;GAClB,SAAS;GACT;EACF,CAAC,GACK,IAA0C;GAC9C,gBAAgB;GAChB,iBAAiB;EACnB;EAIA,OAHI,MAAwB,EAAgB,gBAAgB,IAC5D,EAAI,UAAU,KAAK,CAAe,GAClC,EAAI,IAAI,CAAI,GACL;CACT,SAAS,GAAK;EACZ,QAAQ,MAAM,gCAAgC,CAAG;EACjD,IAAM,IAAc,MAAM,EAAgB;GACxC,QAAQ,EAAQ;GAChB,QAAQ;GACR,OAAO;GACP;GACA,SAAS;GACT,UAAU,EAAQ;EACpB,CAAC;EAcD,OAbI,KACF,EAAI,UAAU,EAAY,QAAQ;GAChC,gBAAgB;GAChB,iBAAiB;EACnB,CAAC,GACD,EAAI,IAAI,EAAY,IAAI,MAExB,EAAI,UAAU,KAAK;GACjB,gBAAgB;GAChB,iBAAiB;EACnB,CAAC,GACD,EAAI,IAAI,OAAO,CAAG,CAAC,IAEd;CACT;CAGF,IAAM,IAAc,MAAM,EAAgB;EACxC,QAAQ,EAAQ;EAChB,QAAQ;EACR;EACA,SAAS;EACT,UAAU,EAAQ;CACpB,CAAC;CAUD,OATI,KACF,EAAI,UAAU,EAAY,QAAQ;EAChC,gBAAgB;EAChB,iBAAiB;CACnB,CAAC,GACD,EAAI,IAAI,EAAY,IAAI,GACjB,MAGF;AACT"}

package/dist/lib/vite/interpolation-plugin.d.cts

@@ -0,0 +1,64 @@
+import type { Plugin } from "vite";
+/**
+ * How the legacy interpolation transform is handled relative to the installed
+ * Elur core and Vite plugin:
+ *
+ * - `"auto"` (default): the kit's legacy transform is only applied when the
+ *   Vite plugin (`@elurjs/vite-plugin-elur` >= 1.1.0) is NOT installed.
+ *   The plugin has a more powerful state-machine lexer and takes precedence.
+ * - `"legacy"`: always apply the kit's transform (for migrations), with a
+ *   one-time deprecation warning.
+ * - `"off"`: never apply the kit's transform. Recommended when the Vite
+ *   plugin is installed.
+ */
+export type InterpolationMode = "auto" | "legacy" | "off";
+/**
+ * Detects whether the Vite plugin (`@elurjs/vite-plugin-elur`) is
+ * installed and provides compile-time partial attribute interpolation.
+ */
+export declare function pluginSupportsPartialInterpolation(): boolean;
+/**
+ * Detects whether the installed Elur core supports partial attribute
+ * interpolation natively (via the public `templateFeatures` capability).
+ * Note: as of core v3.4.0, this is always false — the lexer moved to the
+ * Vite plugin.
+ */
+export declare function coreSupportsPartialInterpolation(): boolean;
+/**
+ * Resolves whether the kit's legacy transform should be applied.
+ *
+ * In `"auto"` mode, the kit's transform runs only when neither the Vite
+ * plugin nor the core provides partial interpolation. When the Vite plugin
+ * is installed (>= 1.1.0), it takes precedence and the kit's transform is
+ * skipped to avoid double-processing.
+ */
+export declare function shouldUseLegacyInterpolation(mode: InterpolationMode): boolean;
+/**
+ * Transforms Elur `html\`\`` templates so that attributes with partial
+ * interpolation become a single interpolation expression.
+ *
+ * Elur requires every dynamic attribute to be a single interpolation covering
+ * the whole value. This plugin rewrites patterns such as:
+ *
+ *   html\`<a href="/blog/${slug}">...</a>\`
+ *
+ * into:
+ *
+ *   html\`<a href=${"/blog/" + slug}>...</a>\`
+ *
+ * Only files inside the app and islands directories are processed.
+ *
+ * @deprecated Elur core supports partial attribute interpolation natively.
+ *   Keep this transform only for migrations against older cores
+ *   (`interpolation: "legacy"`).
+ */
+export interface InterpolationPluginOptions {
+    appDir?: string;
+    islandsDir?: string;
+}
+/**
+ * @deprecated Use the native partial attribute interpolation of Elur core
+ *   (core >= 3.3). Kept for legacy migrations and direct consumers.
+ */
+export declare function transformPartialInterpolations(source: string): string;
+export declare function elurJsInterpolationPlugin(options?: InterpolationPluginOptions): Plugin;

package/dist/lib/vite/interpolation-plugin.d.ts

@@ -0,0 +1,64 @@
+import type { Plugin } from "vite";
+/**
+ * How the legacy interpolation transform is handled relative to the installed
+ * Elur core and Vite plugin:
+ *
+ * - `"auto"` (default): the kit's legacy transform is only applied when the
+ *   Vite plugin (`@elurjs/vite-plugin-elur` >= 1.1.0) is NOT installed.
+ *   The plugin has a more powerful state-machine lexer and takes precedence.
+ * - `"legacy"`: always apply the kit's transform (for migrations), with a
+ *   one-time deprecation warning.
+ * - `"off"`: never apply the kit's transform. Recommended when the Vite
+ *   plugin is installed.
+ */
+export type InterpolationMode = "auto" | "legacy" | "off";
+/**
+ * Detects whether the Vite plugin (`@elurjs/vite-plugin-elur`) is
+ * installed and provides compile-time partial attribute interpolation.
+ */
+export declare function pluginSupportsPartialInterpolation(): boolean;
+/**
+ * Detects whether the installed Elur core supports partial attribute
+ * interpolation natively (via the public `templateFeatures` capability).
+ * Note: as of core v3.4.0, this is always false — the lexer moved to the
+ * Vite plugin.
+ */
+export declare function coreSupportsPartialInterpolation(): boolean;
+/**
+ * Resolves whether the kit's legacy transform should be applied.
+ *
+ * In `"auto"` mode, the kit's transform runs only when neither the Vite
+ * plugin nor the core provides partial interpolation. When the Vite plugin
+ * is installed (>= 1.1.0), it takes precedence and the kit's transform is
+ * skipped to avoid double-processing.
+ */
+export declare function shouldUseLegacyInterpolation(mode: InterpolationMode): boolean;
+/**
+ * Transforms Elur `html\`\`` templates so that attributes with partial
+ * interpolation become a single interpolation expression.
+ *
+ * Elur requires every dynamic attribute to be a single interpolation covering
+ * the whole value. This plugin rewrites patterns such as:
+ *
+ *   html\`<a href="/blog/${slug}">...</a>\`
+ *
+ * into:
+ *
+ *   html\`<a href=${"/blog/" + slug}>...</a>\`
+ *
+ * Only files inside the app and islands directories are processed.
+ *
+ * @deprecated Elur core supports partial attribute interpolation natively.
+ *   Keep this transform only for migrations against older cores
+ *   (`interpolation: "legacy"`).
+ */
+export interface InterpolationPluginOptions {
+    appDir?: string;
+    islandsDir?: string;
+}
+/**
+ * @deprecated Use the native partial attribute interpolation of Elur core
+ *   (core >= 3.3). Kept for legacy migrations and direct consumers.
+ */
+export declare function transformPartialInterpolations(source: string): string;
+export declare function elurJsInterpolationPlugin(options?: InterpolationPluginOptions): Plugin;