@anaemia/core 0.3.7 → 0.4.0

package/LICENSE

@@ -186,7 +186,7 @@
       same "printed page" as the copyright notice for easier
       identification within third-party archives.
 
-   Copyright [yyyy] [name of copyright owner]
+   Copyright [2026] [colourlabs]
 
    Licensed under the Apache License, Version 2.0 (the "License");
    you may not use this file except in compliance with the License.

package/README.md

@@ -1,3 +1,3 @@
 # @anaemia/core
 
-the core runtime for the [anaemia](https://github.com/colourlabs/anaemia) SolidJS SSR framework
+the core runtime for the [anaemia](https://github.com/colourlabs/anaemia) SolidJS SSR framework

package/dist/config.d.ts

@@ -38,6 +38,13 @@ export interface AnaemiaConfig {
     styles?: {
         sass?: boolean;
         modules?: boolean;
+        /**
+         * customize the generated CSS module class names.
+         * defaults to "[name]__[local]__[hash:base64:5]" in both development and production
+         * for readable, themeable class names. Set to "[hash:base64:8]" if you prefer
+         * fully hashed production output and don't need external theme support.
+         */
+        modulesLocalIdentName?: string;
     };
     experimental?: {
         outputModule?: boolean;
@@ -54,7 +61,7 @@ export interface AnaemiaConfig {
      *   client: { __APP_VERSION__: JSON.stringify("1.0.0") },
      *   server: { __DB_POOL_SIZE__: "10" }
      * }
-    */
+     */
     define?: {
         client?: Record<string, string>;
         server?: Record<string, string>;

package/dist/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AACjC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE9C,MAAM,WAAW,aAAa;IAC5B;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,kBAAkB,CAAC,EAAE,CAAC,MAAM,EAAE,aAAa,KAAK,aAAa,CAAC;IAE9D;;OAEG;IACH,kBAAkB,CAAC,EAAE,CAAC,MAAM,EAAE,aAAa,KAAK,aAAa,CAAC;IAE9D;;OAEG;IACH,YAAY,CAAC,EAAE;QACb,MAAM,CAAC,EAAE,UAAU,EAAE,CAAC;QACtB,MAAM,CAAC,EAAE,UAAU,EAAE,CAAC;KACvB,CAAC;IAEF;;OAEG;IACH,eAAe,CAAC,EAAE,CAAC,GAAG,EAAE,IAAI,KAAK,IAAI,CAAC;IAEtC;;OAEG;IACH,aAAa,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CAC5D;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE;QACP,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB,CAAC;IACF,MAAM,CAAC,EAAE;QACP,IAAI,CAAC,EAAE,OAAO,CAAC;QACf,OAAO,CAAC,EAAE,OAAO,CAAC;KACnB,CAAC;IACF,YAAY,CAAC,EAAE;QACb,YAAY,CAAC,EAAE,OAAO,CAAC;KACxB,CAAC;IAEF;;OAEG;IACH,OAAO,CAAC,EAAE,aAAa,EAAE,CAAC;IAE1B;;;;;;;;MAQE;IACF,MAAM,CAAC,EAAE;QACP,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAChC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;KACjC,CAAC;CACH;AAED,wBAAgB,YAAY,CAAC,MAAM,EAAE,aAAa,GAAG,aAAa,CAEjE"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AACjC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE9C,MAAM,WAAW,aAAa;IAC5B;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,kBAAkB,CAAC,EAAE,CAAC,MAAM,EAAE,aAAa,KAAK,aAAa,CAAC;IAE9D;;OAEG;IACH,kBAAkB,CAAC,EAAE,CAAC,MAAM,EAAE,aAAa,KAAK,aAAa,CAAC;IAE9D;;OAEG;IACH,YAAY,CAAC,EAAE;QACb,MAAM,CAAC,EAAE,UAAU,EAAE,CAAC;QACtB,MAAM,CAAC,EAAE,UAAU,EAAE,CAAC;KACvB,CAAC;IAEF;;OAEG;IACH,eAAe,CAAC,EAAE,CAAC,GAAG,EAAE,IAAI,KAAK,IAAI,CAAC;IAEtC;;OAEG;IACH,aAAa,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CAC5D;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE;QACP,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB,CAAC;IACF,MAAM,CAAC,EAAE;QACP,IAAI,CAAC,EAAE,OAAO,CAAC;QACf,OAAO,CAAC,EAAE,OAAO,CAAC;QAElB;;;;;WAKG;QACH,qBAAqB,CAAC,EAAE,MAAM,CAAC;KAChC,CAAC;IACF,YAAY,CAAC,EAAE;QACb,YAAY,CAAC,EAAE,OAAO,CAAC;KACxB,CAAC;IAEF;;OAEG;IACH,OAAO,CAAC,EAAE,aAAa,EAAE,CAAC;IAE1B;;;;;;;;OAQG;IACH,MAAM,CAAC,EAAE;QACP,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAChC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;KACjC,CAAC;CACH;AAED,wBAAgB,YAAY,CAAC,MAAM,EAAE,aAAa,GAAG,aAAa,CAEjE"}

package/dist/index.d.ts

@@ -3,5 +3,5 @@ export { runOnServer } from "./runtime/context.js";
 export { RouteDataController, useRouteData } from "./runtime/route-data.js";
 export { $$executeClientRpc } from "./runtime/rpc-client.js";
 export { createServerResource } from "./runtime/resources.js";
-export type { LoaderArgs, LoaderFunction, InferServerData, GuardContext, GuardResult, GuardFn, ServerFunction } from "./types.js";
+export type { LoaderArgs, LoaderFunction, InferServerData, GuardContext, GuardResult, GuardFn, ServerFunction, } from "./types.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAE5B,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACnD,OAAO,EAAE,mBAAmB,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAC5E,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAE9D,YAAY,EAAE,UAAU,EAAE,cAAc,EAAE,eAAe,EAAE,YAAY,EAAE,WAAW,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAE5B,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACnD,OAAO,EAAE,mBAAmB,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAC5E,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAE9D,YAAY,EACV,UAAU,EACV,cAAc,EACd,eAAe,EACf,YAAY,EACZ,WAAW,EACX,OAAO,EACP,cAAc,GACf,MAAM,YAAY,CAAC"}

package/dist/plugins/lightningcss.js

@@ -14,7 +14,7 @@ export function anaemiaLightningCssPlugin(options = {}) {
         clientRspackConfig(config) {
             const isProd = process.env.NODE_ENV === "production";
             if (config.module?.rules) {
-                config.module.rules.forEach((rule) => {
+                for (const rule of config.module.rules) {
                     if (rule && typeof rule === "object" && rule.test && rule.test.toString().includes("ss")) {
                         const currentUse = Array.isArray(rule.use) ? rule.use : [];
                         rule.use = [
@@ -28,7 +28,7 @@ export function anaemiaLightningCssPlugin(options = {}) {
                             },
                         ];
                     }
-                });
+                }
             }
             if (isProd) {
                 config.optimization = {
@@ -46,7 +46,7 @@ export function anaemiaLightningCssPlugin(options = {}) {
         },
         serverRspackConfig(config) {
             if (config.module?.rules) {
-                config.module.rules.forEach((rule) => {
+                for (const rule of config.module.rules) {
                     if (rule && typeof rule === "object" && rule.test && rule.test.toString().includes("ss")) {
                         const currentUse = Array.isArray(rule.use) ? rule.use : [];
                         rule.use = [
@@ -60,7 +60,7 @@ export function anaemiaLightningCssPlugin(options = {}) {
                             },
                         ];
                     }
-                });
+                }
             }
             return config;
         },

package/dist/runtime/context.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/runtime/context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAErD,KAAK,KAAK,GAAG,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,CAAC;AAE7C,eAAO,MAAM,uBAAuB,oBAA2B,CAAC;AAChE,eAAO,MAAM,UAAU,yCAAgD,CAAC;AAGxE,wBAAgB,WAAW,CAAC,CAAC,SAAS,KAAK,EAAE,SAAS,EAAE,CAAC,EAAE,EAAE,CAAC,EAAE,MAAM,GAAG,CAAC,GAAG;IAAE,EAAE,EAAE,MAAM,CAAA;CAAE,CAsB1F"}
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/runtime/context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAErD,KAAK,KAAK,GAAG,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,CAAC;AAE7C,eAAO,MAAM,uBAAuB,oBAA2B,CAAC;AAChE,eAAO,MAAM,UAAU,yCAAgD,CAAC;AAGxE,wBAAgB,WAAW,CAAC,CAAC,SAAS,KAAK,EAAE,SAAS,EAAE,CAAC,EAAE,EAAE,CAAC,EAAE,MAAM,GAAG,CAAC,GAAG;IAAE,EAAE,EAAE,MAAM,CAAA;CAAE,CAyB1F"}

package/dist/runtime/context.js

@@ -3,7 +3,7 @@ export const serverFunctionsRegistry = new Map();
 export const ssrStorage = new AsyncLocalStorage();
 globalThis.__ANAEMIA_SERVER_STORAGE__ = ssrStorage;
 export function runOnServer(backendFn, id) {
-    const hashId = id || "";
+    const hashId = id ?? crypto.randomUUID();
     serverFunctionsRegistry.set(hashId, backendFn);
     const rpcProxy = async function (...args) {
         const result = await backendFn(...args);

package/dist/runtime/entry-client.jsx

@@ -9,11 +9,9 @@ if (!mountTarget) {
 const root = mountTarget;
 async function start() {
     await preloadActiveClientRoute(window.location.pathname);
-    const mount = root.hasChildNodes()
-        ? hydrate
-        : render;
+    const mount = root.hasChildNodes() ? hydrate : render;
     mount(() => (<Router>
         <App />
       </Router>), root);
 }
-start();
+await start();

package/dist/runtime/entry-server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"entry-server.d.ts","sourceRoot":"","sources":["../../src/runtime/entry-server.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AA2C5B,QAAA,MAAM,GAAG,4EAAa,CAAC;AA6VvB,eAAe,GAAG,CAAC"}
+{"version":3,"file":"entry-server.d.ts","sourceRoot":"","sources":["../../src/runtime/entry-server.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AA2C5B,QAAA,MAAM,GAAG,4EAAa,CAAC;AAqXvB,eAAe,GAAG,CAAC"}

package/dist/runtime/entry-server.jsx

@@ -6,7 +6,7 @@ import { renderToStringAsync, generateHydrationScript } from "solid-js/web";
 import { Router } from "@solidjs/router";
 import { ssrStorage, serverFunctionsRegistry } from "./context.js";
 import fs from "node:fs";
-import path from "path";
+import path from "node:path";
 // @ts-expect-error - resolved by Rspack
 import App from "anaemia-user-app";
 // @ts-expect-error - resolved by Rspack
@@ -185,7 +185,9 @@ function matchRoute(manifest, reqPath) {
         });
     }
     for (const route of sortedRoutes) {
-        const regexStr = route.urlPattern.replace(/:([a-zA-Z0-9_-]+)/g, "(?<$1>[^/]+)").replace(/\*([a-zA-Z0-9_-]*)/g, "(?<catchall>.*)");
+        const regexStr = route.urlPattern
+            .replace(/:([a-zA-Z0-9_-]+)/g, "(?<$1>[^/]+)")
+            .replace(/\*([a-zA-Z0-9_-]*)/g, "(?<catchall>.*)");
         const match = new RegExp(`^${regexStr}$`).exec(reqPath);
         if (match) {
             return {
@@ -206,8 +208,8 @@ function matchRoute(manifest, reqPath) {
 app.get("*", async (c) => {
     if (isDev)
         await loadManifestAndTemplate();
-    let template = memoizedHtmlTemplate;
-    let manifest = memoizedManifest;
+    const template = memoizedHtmlTemplate;
+    const manifest = memoizedManifest;
     if (!template || !manifest) {
         return c.text("anaemia engine error: build assets are missing", 500);
     }
@@ -219,7 +221,11 @@ app.get("*", async (c) => {
     let htmlPayload;
     if (targetPattern) {
         try {
-            const guardResult = await runGuards(targetPattern, { params, request: c.req.raw, url: reqPath });
+            const guardResult = await runGuards(targetPattern, {
+                params,
+                request: c.req.raw,
+                url: reqPath,
+            });
             if (guardResult) {
                 if ("redirect" in guardResult)
                     return c.redirect(guardResult.redirect, (guardResult.status ?? 302));
@@ -275,43 +281,47 @@ app.get("*", async (c) => {
     }
     let assetScripts = "";
     let assetStyles = "";
-    if (manifest.chunks) {
-        const processChunkAssets = (chunk) => {
-            if (!chunk)
-                return;
-            if (chunk.js) {
-                const jsSpecs = Array.isArray(chunk.js) ? chunk.js : [chunk.js];
-                jsSpecs.forEach((jsFile) => {
-                    assetScripts += `<script type="module" src="${normalizeAssetUrl(jsFile)}"></script>\n`;
-                });
+    const processChunkAssets = (chunk) => {
+        if (!chunk)
+            return;
+        if (chunk.js) {
+            const jsSpecs = Array.isArray(chunk.js) ? chunk.js : [chunk.js];
+            for (const jsFile of jsSpecs) {
+                assetScripts += `<script type="module" src="${normalizeAssetUrl(jsFile)}"></script>\n`;
             }
-            if (chunk.css) {
-                const cssSpecs = Array.isArray(chunk.css) ? chunk.css : [chunk.css];
-                cssSpecs.forEach((cssFile) => {
-                    assetStyles += `<link rel="stylesheet" href="${normalizeAssetUrl(cssFile)}">\n`;
-                });
+        }
+        if (chunk.css) {
+            const cssSpecs = Array.isArray(chunk.css) ? chunk.css : [chunk.css];
+            for (const cssFile of cssSpecs) {
+                assetStyles += `<link rel="stylesheet" href="${normalizeAssetUrl(cssFile)}">\n`;
             }
-        };
-        processChunkAssets(manifest.chunks["client"]);
-        if (manifest.chunks["commons"])
-            processChunkAssets(manifest.chunks["commons"]);
-        if (manifest.chunks["vendors"])
-            processChunkAssets(manifest.chunks["vendors"]);
-        if (activeChunk && activeChunk !== "client")
-            processChunkAssets(manifest.chunks[activeChunk]);
-    }
+        }
+    };
+    processChunkAssets(manifest.chunks["client"]);
+    processChunkAssets(manifest.chunks["commons"]);
+    processChunkAssets(manifest.chunks["vendors"]);
+    if (activeChunk && activeChunk !== "client")
+        processChunkAssets(manifest.chunks[activeChunk]);
     const hydrationScript = generateHydrationScript();
     const rawStorePayload = Object.fromEntries(store);
     const finalHydrationStatePayload = {
         __LOADER_DATA__: rawStorePayload.__LOADER_DATA__ || {},
         __SERVER_FUNCTION_DATA__: rawStorePayload.__SERVER_FUNCTION_DATA__ || {},
     };
-    const serializedData = JSON.stringify(finalHydrationStatePayload).replace(/&/g, "\\u0026").replace(/</g, "\\u003c").replace(/>/g, "\\u003e").replace(/\//g, "\\u002f");
+    const serializedData = JSON.stringify(finalHydrationStatePayload)
+        .replace(/&/g, "\\u0026")
+        .replace(/</g, "\\u003c")
+        .replace(/>/g, "\\u003e")
+        .replace(/\//g, "\\u002f");
     const dataScript = `<script id="__ANAEMIA_DATA__" type="application/json">${serializedData}</script>\n`;
-    const devNoCacheTag = isDev ? `<meta http-equiv="Cache-Control" content="no-cache, no-store, must-revalidate">\n<meta http-equiv="Pragma" content="no-cache">\n<meta http-equiv="Expires" content="0">\n` : "";
+    const devNoCacheTag = isDev
+        ? `<meta http-equiv="Cache-Control" content="no-cache, no-store, must-revalidate">\n<meta http-equiv="Pragma" content="no-cache">\n<meta http-equiv="Expires" content="0">\n`
+        : "";
     const combinedHeadInjections = `${devNoCacheTag}${assetStyles}${dataScript}${hydrationScript}`;
     const sanitizedPayload = htmlPayload.trim();
-    let completeHtmlOutput = ENTRY_TAG_REGEX.test(template) ? template.replace(ENTRY_TAG_REGEX, (_, open, _tag, _inner, close) => `${open}${sanitizedPayload}${close}`) : template.replace("</body>", () => `<div anaemia-entry>${sanitizedPayload}</div></body>`);
+    let completeHtmlOutput = ENTRY_TAG_REGEX.test(template)
+        ? template.replace(ENTRY_TAG_REGEX, (_, open, _tag, _inner, close) => `${open}${sanitizedPayload}${close}`)
+        : template.replace("</body>", () => `<div anaemia-entry>${sanitizedPayload}</div></body>`);
     completeHtmlOutput = completeHtmlOutput.replace("<head>", `<head>${combinedHeadInjections}`);
     completeHtmlOutput = completeHtmlOutput.replace("</body>", `${assetScripts}</body>`);
     if (isDev) {

package/dist/runtime/route-request.js

@@ -3,7 +3,7 @@ import { ssrStorage } from "./context.js";
 export function createRouteRequest(pathname) {
     if (isServer) {
         const honoContext = ssrStorage.getStore()?.get("honoContext");
-        const request = honoContext?.req?.raw;
+        const request = honoContext?.req.raw;
         if (request)
             return request;
         return new Request(new URL(pathname, "http://localhost").toString());

package/dist/runtime/rpc-client.js

@@ -37,7 +37,7 @@ export function $$executeClientRpc(hashId) {
                         return match.data;
                 }
             }
-            return undefined;
+            return;
         }
         ensureCacheInitialized();
         const serverFunctionData = _clientCache?.__SERVER_FUNCTION_DATA__?.[hashId];
@@ -54,7 +54,7 @@ export function $$executeClientRpc(hashId) {
         });
         if (!response.ok)
             throw new Error(`[anaemia] RPC execution failed: ${response.status}`);
-        return await response.json();
+        return (await response.json());
     };
     asyncRpcCall.id = hashId;
     asyncRpcCall.readHydrationCache = function (...args) {
@@ -68,7 +68,7 @@ export function $$executeClientRpc(hashId) {
                         return match.data;
                 }
             }
-            return undefined;
+            return;
         }
         ensureCacheInitialized();
         const serverFunctionData = _clientCache?.__SERVER_FUNCTION_DATA__?.[hashId];

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAEjE;;GAEG;AACH,MAAM,WAAW,UAAU,CAAC,MAAM,SAAS,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IACxF,0EAA0E;IAC1E,MAAM,EAAE,MAAM,CAAC;IACf,iFAAiF;IACjF,OAAO,EAAE,OAAO,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,MAAM,cAAc,CAAC,YAAY,GAAG,OAAO,EAAE,MAAM,SAAS,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,UAAU,CAAC,MAAM,CAAC,KAAK,OAAO,CAAC,YAAY,CAAC,GAAG,YAAY,CAAC;AAExL;;;GAGG;AACH,MAAM,MAAM,eAAe,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,IAAI,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC;AAEhG,MAAM,MAAM,YAAY,GAAG;IACzB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,OAAO,EAAE,OAAO,CAAC;IACjB,GAAG,EAAE,MAAM,CAAC;CACb,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG,IAAI,GAAG,SAAS,GAAG;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,CAAA;CAAE,GAAG;IAAE,MAAM,EAAE,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAErJ,MAAM,MAAM,OAAO,GAAG,CAAC,GAAG,EAAE;IAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAAC,OAAO,EAAE,OAAO,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,KAAK,IAAI,GAAG,SAAS,GAAG;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,kBAAkB,CAAA;CAAE,GAAG;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAAC,IAAI,GAAG,SAAS,GAAG;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,kBAAkB,CAAA;CAAE,GAAG;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC;AAE/T,MAAM,MAAM,cAAc,CAAC,IAAI,SAAS,OAAO,EAAE,EAAE,MAAM,IAAI,CAAC,CAAC,GAAG,IAAI,EAAE,IAAI,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC,GAAG;IAClG,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAEjE;;GAEG;AACH,MAAM,WAAW,UAAU,CAAC,MAAM,SAAS,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IACxF,0EAA0E;IAC1E,MAAM,EAAE,MAAM,CAAC;IACf,iFAAiF;IACjF,OAAO,EAAE,OAAO,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,MAAM,cAAc,CAAC,YAAY,GAAG,OAAO,EAAE,MAAM,SAAS,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,IAAI,CACnH,IAAI,EAAE,UAAU,CAAC,MAAM,CAAC,KACrB,OAAO,CAAC,YAAY,CAAC,GAAG,YAAY,CAAC;AAE1C;;;GAGG;AACH,MAAM,MAAM,eAAe,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,IAAI,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC;AAEhG,MAAM,MAAM,YAAY,GAAG;IACzB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,OAAO,EAAE,OAAO,CAAC;IACjB,GAAG,EAAE,MAAM,CAAC;CACb,CAAC;AAEF,MAAM,MAAM,WAAW,GACnB,IAAI,GACJ,SAAS,GACT;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,CAAA;CAAE,GACpD;IAAE,MAAM,EAAE,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAErD,MAAM,MAAM,OAAO,GAAG,CAAC,GAAG,EAAE;IAC1B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,OAAO,EAAE,OAAO,CAAC;IACjB,GAAG,EAAE,MAAM,CAAC;CACb,KACG,IAAI,GACJ,SAAS,GACT;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,kBAAkB,CAAA;CAAE,GACjD;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GACjC,OAAO,CAAC,IAAI,GAAG,SAAS,GAAG;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,kBAAkB,CAAA;CAAE,GAAG;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC;AAEtH,MAAM,MAAM,cAAc,CAAC,IAAI,SAAS,OAAO,EAAE,EAAE,MAAM,IAAI,CAAC,CAAC,GAAG,IAAI,EAAE,IAAI,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC,GAAG;IAClG,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@anaemia/core",
-  "version": "0.3.7",
+  "version": "0.4.0",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -28,6 +28,7 @@
       "types": "./dist/plugins/index.d.ts",
       "import": "./dist/plugins/index.js"
     },
+    "./client": "./anaemia.d.ts",
     "./package.json": "./package.json"
   },
   "dependencies": {
@@ -36,6 +37,12 @@
     "@solidjs/router": "^0.16.1",
     "hono": "^4.12.23"
   },
+  "devDependencies": {
+    "@types/babel__core": "^7.20.5",
+    "@types/node": "^25.9.1",
+    "jiti": "^2.7.0",
+    "playwright": "^1.60.0"
+  },
   "peerDependencies": {
     "@rspack/core": "*",
     "lightningcss": "^1.32.0",
@@ -49,12 +56,6 @@
       "optional": true
     }
   },
-  "devDependencies": {
-    "@types/babel__core": "^7.20.5",
-    "@types/node": "^25.9.1",
-    "jiti": "^2.7.0",
-    "playwright": "^1.60.0"
-  },
   "scripts": {
     "build": "tsc",
     "test": "pnpm run build && node --test test/*.test.mjs",

package/src/anaemia.d.ts

@@ -0,0 +1,75 @@
+/// <reference types="@rspack/core/module" />
+
+// asset imports
+declare module "*.png" {
+  const src: string;
+  export default src;
+}
+declare module "*.jpg" {
+  const src: string;
+  export default src;
+}
+declare module "*.jpeg" {
+  const src: string;
+  export default src;
+}
+declare module "*.gif" {
+  const src: string;
+  export default src;
+}
+declare module "*.webp" {
+  const src: string;
+  export default src;
+}
+declare module "*.avif" {
+  const src: string;
+  export default src;
+}
+declare module "*.ico" {
+  const src: string;
+  export default src;
+}
+declare module "*.svg" {
+  const src: string;
+  export default src;
+}
+
+// query suffixes
+declare module "*?raw" {
+  const content: string;
+  export default content;
+}
+declare module "*?url" {
+  const src: string;
+  export default src;
+}
+declare module "*?inline" {
+  const src: string;
+  export default src;
+}
+
+// CSS modules
+declare module "*.module.css" {
+  const classes: Record<string, string>;
+  export default classes;
+}
+declare module "*.module.scss" {
+  const classes: Record<string, string>;
+  export default classes;
+}
+declare module "*.module.sass" {
+  const classes: Record<string, string>;
+  export default classes;
+}
+
+// import.meta.env
+interface ImportMetaEnv {
+  readonly MODE: string;
+  readonly DEV: boolean;
+  readonly PROD: boolean;
+  readonly [key: string]: string | boolean | undefined;
+}
+
+interface ImportMeta {
+  readonly env: ImportMetaEnv;
+}

package/src/config.ts

@@ -45,6 +45,14 @@ export interface AnaemiaConfig {
   styles?: {
     sass?: boolean;
     modules?: boolean;
+
+    /**
+     * customize the generated CSS module class names.
+     * defaults to "[name]__[local]__[hash:base64:5]" in both development and production
+     * for readable, themeable class names. Set to "[hash:base64:8]" if you prefer
+     * fully hashed production output and don't need external theme support.
+     */
+    modulesLocalIdentName?: string;
   };
   experimental?: {
     outputModule?: boolean;
@@ -63,7 +71,7 @@ export interface AnaemiaConfig {
    *   client: { __APP_VERSION__: JSON.stringify("1.0.0") },
    *   server: { __DB_POOL_SIZE__: "10" }
    * }
-  */
+   */
   define?: {
     client?: Record<string, string>;
     server?: Record<string, string>;

package/src/index.ts

@@ -5,4 +5,12 @@ export { RouteDataController, useRouteData } from "./runtime/route-data.js";
 export { $$executeClientRpc } from "./runtime/rpc-client.js";
 export { createServerResource } from "./runtime/resources.js";
 
-export type { LoaderArgs, LoaderFunction, InferServerData, GuardContext, GuardResult, GuardFn, ServerFunction } from "./types.js";
+export type {
+  LoaderArgs,
+  LoaderFunction,
+  InferServerData,
+  GuardContext,
+  GuardResult,
+  GuardFn,
+  ServerFunction,
+} from "./types.js";

package/src/plugins/index.ts

@@ -1 +1 @@
-export { anaemiaLightningCssPlugin } from "./lightningcss.js";
+export { anaemiaLightningCssPlugin } from "./lightningcss.js";

package/src/plugins/lightningcss.ts

@@ -11,12 +11,12 @@ export function anaemiaLightningCssPlugin(options: { browserslist?: string[] } =
 
   const localRequire = createRequire(import.meta.url);
   let rspackModule: RspackModule;
-  
+
   try {
     rspackModule = localRequire("@rspack/core");
   } catch {
     throw new Error(
-      "[anaemia] The LightningCSS plugin requires '@rspack/core' to be available in the execution workspace."
+      "[anaemia] The LightningCSS plugin requires '@rspack/core' to be available in the execution workspace.",
     );
   }
 
@@ -27,22 +27,22 @@ export function anaemiaLightningCssPlugin(options: { browserslist?: string[] } =
       const isProd = process.env.NODE_ENV === "production";
 
       if (config.module?.rules) {
-        config.module.rules.forEach((rule) => {
+        for (const rule of config.module.rules) {
           if (rule && typeof rule === "object" && rule.test && rule.test.toString().includes("ss")) {
             const currentUse = Array.isArray(rule.use) ? rule.use : [];
-            
+
             rule.use = [
               ...currentUse,
               {
                 loader: "builtin:lightningcss-loader",
-                options: { 
+                options: {
                   targets,
                   modules: rule.type === "css/auto",
                 },
               },
             ];
           }
-        });
+        }
       }
 
       if (isProd) {
@@ -63,24 +63,24 @@ export function anaemiaLightningCssPlugin(options: { browserslist?: string[] } =
 
     serverRspackConfig(config) {
       if (config.module?.rules) {
-        config.module.rules.forEach((rule) => {
+        for (const rule of config.module.rules) {
           if (rule && typeof rule === "object" && rule.test && rule.test.toString().includes("ss")) {
             const currentUse = Array.isArray(rule.use) ? rule.use : [];
-            
+
             rule.use = [
               ...currentUse,
               {
                 loader: "builtin:lightningcss-loader",
-                options: { 
+                options: {
                   targets,
                   modules: rule.type === "css/auto",
                 },
               },
             ];
           }
-        });
+        }
       }
       return config;
     },
   };
-}
+}

package/src/runtime/context.browser.ts

@@ -3,4 +3,4 @@ export const ssrStorage = null as any;
 // eslint-disable-next-line @typescript-eslint/no-unsafe-function-type
 export const serverFunctionsRegistry = new Map<string, Function>();
 // eslint-disable-next-line @typescript-eslint/no-explicit-any
-export const runOnServer = null as any;
+export const runOnServer = null as any;

package/src/runtime/context.ts

@@ -7,7 +7,7 @@ export const ssrStorage = new AsyncLocalStorage<Map<string, unknown>>();
 (globalThis as unknown as Record<string, unknown>).__ANAEMIA_SERVER_STORAGE__ = ssrStorage;
 
 export function runOnServer<T extends AnyFn>(backendFn: T, id?: string): T & { id: string } {
-  const hashId = id || "";
+  const hashId = id ?? crypto.randomUUID();
   serverFunctionsRegistry.set(hashId, backendFn);
 
   const rpcProxy = async function (...args: unknown[]) {
@@ -17,7 +17,10 @@ export function runOnServer<T extends AnyFn>(backendFn: T, id?: string): T & { i
       if (!store.has("__SERVER_FUNCTION_DATA__")) {
         store.set("__SERVER_FUNCTION_DATA__", {});
       }
-      const functionCache = store.get("__SERVER_FUNCTION_DATA__") as Record<string, Record<string, unknown>>;
+      const functionCache = store.get("__SERVER_FUNCTION_DATA__") as Record<
+        string,
+        Record<string, unknown> | undefined
+      >;
       if (!functionCache[hashId]) {
         functionCache[hashId] = {};
       }
@@ -28,4 +31,4 @@ export function runOnServer<T extends AnyFn>(backendFn: T, id?: string): T & { i
   };
   rpcProxy.id = hashId;
   return rpcProxy as unknown as T & { id: string };
-}
+}

package/src/runtime/entry-client.tsx

@@ -4,9 +4,7 @@ import { Router } from "@solidjs/router";
 // @ts-expect-error - resolved by Rspack
 import App, { preloadActiveClientRoute } from "anaemia-user-app";
 
-const mountTarget = document.querySelector(
-  "[anaemia-entry]"
-) as HTMLElement | null;
+const mountTarget = document.querySelector("[anaemia-entry]") as HTMLElement | null;
 
 if (!mountTarget) {
   throw new Error("[anaemia] missing mount target");
@@ -17,9 +15,7 @@ const root = mountTarget;
 async function start() {
   await preloadActiveClientRoute(window.location.pathname);
 
-  const mount = root.hasChildNodes()
-    ? hydrate
-    : render;
+  const mount = root.hasChildNodes() ? hydrate : render;
 
   mount(
     () => (
@@ -27,8 +23,8 @@ async function start() {
         <App />
       </Router>
     ),
-    root
+    root,
   );
 }
 
-start();
+await start();

package/src/runtime/entry-server.tsx

@@ -7,7 +7,7 @@ import { renderToStringAsync, generateHydrationScript } from "solid-js/web";
 import { Router } from "@solidjs/router";
 import { ssrStorage, serverFunctionsRegistry } from "./context.js";
 import fs from "node:fs";
-import path from "path";
+import path from "node:path";
 import type { StatusCode, RedirectStatusCode } from "hono/utils/http-status";
 
 // @ts-expect-error - resolved by Rspack
@@ -82,7 +82,7 @@ if (isDev) {
     "/assets/*",
     serveStatic({
       root: path.resolve(process.cwd(), "./dist/client"),
-    })
+    }),
   );
 }
 
@@ -191,7 +191,16 @@ type RouteMatch = {
   params: Record<string, string>;
 };
 
-type GuardFn = (ctx: { params: Record<string, string>; request: Request; url: string }) => void | undefined | { redirect: string; status?: 301 | 302 | 307 | 308 } | { status: number; body?: string } | Promise<void | undefined | { redirect: string; status?: number } | { status: number; body?: string }>;
+type GuardFn = (ctx: {
+  params: Record<string, string>;
+  request: Request;
+  url: string;
+}) =>
+  | void
+  | undefined
+  | { redirect: string; status?: 301 | 302 | 307 | 308 }
+  | { status: number; body?: string }
+  | Promise<void | undefined | { redirect: string; status?: number } | { status: number; body?: string }>;
 
 async function runGuards(pattern: string, ctx: { params: Record<string, string>; request: Request; url: string }) {
   const chain: (() => Promise<GuardFn[]>)[] = serverGuardRegistry.get(pattern) ?? [];
@@ -221,7 +230,9 @@ function matchRoute(manifest: RouteManifest, reqPath: string): RouteMatch {
   }
 
   for (const route of sortedRoutes) {
-    const regexStr = route.urlPattern.replace(/:([a-zA-Z0-9_-]+)/g, "(?<$1>[^/]+)").replace(/\*([a-zA-Z0-9_-]*)/g, "(?<catchall>.*)");
+    const regexStr = route.urlPattern
+      .replace(/:([a-zA-Z0-9_-]+)/g, "(?<$1>[^/]+)")
+      .replace(/\*([a-zA-Z0-9_-]*)/g, "(?<catchall>.*)");
 
     const match = new RegExp(`^${regexStr}$`).exec(reqPath);
     if (match) {
@@ -245,8 +256,8 @@ function matchRoute(manifest: RouteManifest, reqPath: string): RouteMatch {
 app.get("*", async (c) => {
   if (isDev) await loadManifestAndTemplate();
 
-  let template = memoizedHtmlTemplate;
-  let manifest = memoizedManifest;
+  const template = memoizedHtmlTemplate;
+  const manifest = memoizedManifest;
 
   if (!template || !manifest) {
     return c.text("anaemia engine error: build assets are missing", 500);
@@ -262,9 +273,14 @@ app.get("*", async (c) => {
 
   if (targetPattern) {
     try {
-      const guardResult = await runGuards(targetPattern, { params, request: c.req.raw, url: reqPath });
+      const guardResult = await runGuards(targetPattern, {
+        params,
+        request: c.req.raw,
+        url: reqPath,
+      });
       if (guardResult) {
-        if ("redirect" in guardResult) return c.redirect(guardResult.redirect, (guardResult.status ?? 302) as RedirectStatusCode);
+        if ("redirect" in guardResult)
+          return c.redirect(guardResult.redirect, (guardResult.status ?? 302) as RedirectStatusCode);
         if ("status" in guardResult) statusCode = guardResult.status as StatusCode;
       }
     } catch (err) {
@@ -324,28 +340,28 @@ app.get("*", async (c) => {
   let assetScripts = "";
   let assetStyles = "";
 
-  if (manifest.chunks) {
-    const processChunkAssets = (chunk: ChunkAssets | undefined) => {
-      if (!chunk) return;
-      if (chunk.js) {
-        const jsSpecs = Array.isArray(chunk.js) ? chunk.js : [chunk.js];
-        jsSpecs.forEach((jsFile: string) => {
-          assetScripts += `<script type="module" src="${normalizeAssetUrl(jsFile)}"></script>\n`;
-        });
+  const processChunkAssets = (chunk: ChunkAssets | undefined) => {
+    if (!chunk) return;
+    if (chunk.js) {
+      const jsSpecs = Array.isArray(chunk.js) ? chunk.js : [chunk.js];
+
+      for (const jsFile of jsSpecs) {
+        assetScripts += `<script type="module" src="${normalizeAssetUrl(jsFile)}"></script>\n`;
       }
-      if (chunk.css) {
-        const cssSpecs = Array.isArray(chunk.css) ? chunk.css : [chunk.css];
-        cssSpecs.forEach((cssFile: string) => {
-          assetStyles += `<link rel="stylesheet" href="${normalizeAssetUrl(cssFile)}">\n`;
-        });
+    }
+    if (chunk.css) {
+      const cssSpecs = Array.isArray(chunk.css) ? chunk.css : [chunk.css];
+
+      for (const cssFile of cssSpecs) {
+        assetStyles += `<link rel="stylesheet" href="${normalizeAssetUrl(cssFile)}">\n`;
       }
-    };
+    }
+  };
 
-    processChunkAssets(manifest.chunks["client"]);
-    if (manifest.chunks["commons"]) processChunkAssets(manifest.chunks["commons"]);
-    if (manifest.chunks["vendors"]) processChunkAssets(manifest.chunks["vendors"]);
-    if (activeChunk && activeChunk !== "client") processChunkAssets(manifest.chunks[activeChunk]);
-  }
+  processChunkAssets(manifest.chunks["client"]);
+  processChunkAssets(manifest.chunks["commons"]);
+  processChunkAssets(manifest.chunks["vendors"]);
+  if (activeChunk && activeChunk !== "client") processChunkAssets(manifest.chunks[activeChunk]);
 
   const hydrationScript = generateHydrationScript();
   const rawStorePayload = Object.fromEntries(store);
@@ -355,16 +371,24 @@ app.get("*", async (c) => {
     __SERVER_FUNCTION_DATA__: rawStorePayload.__SERVER_FUNCTION_DATA__ || {},
   };
 
-  const serializedData = JSON.stringify(finalHydrationStatePayload).replace(/&/g, "\\u0026").replace(/</g, "\\u003c").replace(/>/g, "\\u003e").replace(/\//g, "\\u002f");
+  const serializedData = JSON.stringify(finalHydrationStatePayload)
+    .replace(/&/g, "\\u0026")
+    .replace(/</g, "\\u003c")
+    .replace(/>/g, "\\u003e")
+    .replace(/\//g, "\\u002f");
 
   const dataScript = `<script id="__ANAEMIA_DATA__" type="application/json">${serializedData}</script>\n`;
 
-  const devNoCacheTag = isDev ? `<meta http-equiv="Cache-Control" content="no-cache, no-store, must-revalidate">\n<meta http-equiv="Pragma" content="no-cache">\n<meta http-equiv="Expires" content="0">\n` : "";
+  const devNoCacheTag = isDev
+    ? `<meta http-equiv="Cache-Control" content="no-cache, no-store, must-revalidate">\n<meta http-equiv="Pragma" content="no-cache">\n<meta http-equiv="Expires" content="0">\n`
+    : "";
 
   const combinedHeadInjections = `${devNoCacheTag}${assetStyles}${dataScript}${hydrationScript}`;
   const sanitizedPayload = htmlPayload.trim();
 
-  let completeHtmlOutput = ENTRY_TAG_REGEX.test(template) ? template.replace(ENTRY_TAG_REGEX, (_, open, _tag, _inner, close) => `${open}${sanitizedPayload}${close}`) : template.replace("</body>", () => `<div anaemia-entry>${sanitizedPayload}</div></body>`);
+  let completeHtmlOutput = ENTRY_TAG_REGEX.test(template)
+    ? template.replace(ENTRY_TAG_REGEX, (_, open, _tag, _inner, close) => `${open}${sanitizedPayload}${close}`)
+    : template.replace("</body>", () => `<div anaemia-entry>${sanitizedPayload}</div></body>`);
 
   completeHtmlOutput = completeHtmlOutput.replace("<head>", `<head>${combinedHeadInjections}`);
   completeHtmlOutput = completeHtmlOutput.replace("</body>", `${assetScripts}</body>`);

package/src/runtime/resources.ts

@@ -18,7 +18,7 @@ export function createServerResource<Source, Return>(
     readHydrationCache?: (s: Source) => Return | undefined;
     id?: string;
   },
-  options?: ResourceOptions<Return, Source>
+  options?: ResourceOptions<Return, Source>,
 ): ResourceReturn<Return, unknown> {
   if (isServer) {
     let ssrInitialValue: Return | undefined = undefined;

package/src/runtime/route-data.ts

@@ -61,7 +61,7 @@ export function RouteDataController<TParams extends Params = Params>(props: Rout
     {
       initialValue: ssrData,
       ssrLoadFrom: "initial",
-    }
+    },
   );
 
   return createComponent(RouteDataContext.Provider, {

package/src/runtime/route-request.ts

@@ -5,9 +5,9 @@ import { ssrStorage } from "./context.js";
 export function createRouteRequest(pathname: string): Request {
   if (isServer) {
     const honoContext = ssrStorage.getStore()?.get("honoContext") as Context | undefined;
-    const request = honoContext?.req?.raw;
+    const request = honoContext?.req.raw;
     if (request) return request;
     return new Request(new URL(pathname, "http://localhost").toString());
   }
   return new Request(new URL(pathname, window.location.origin).toString());
-}
+}

package/src/runtime/rpc-client.ts

@@ -34,8 +34,8 @@ function ensureCacheInitialized() {
 }
 
 function findLooseCacheMatch(
-  serverFunctionData: Record<string, unknown>,
-  targetArg: string
+  serverFunctionData: Record<string, unknown> | null | undefined,
+  targetArg: string,
 ): CacheMatch | undefined {
   if (!serverFunctionData) return undefined;
   const strictKey = JSON.stringify([targetArg]);
@@ -62,7 +62,7 @@ export function $$executeClientRpc(hashId: string) {
           if (match) return match.data;
         }
       }
-      return undefined;
+      return;
     }
 
     ensureCacheInitialized();
@@ -80,7 +80,7 @@ export function $$executeClientRpc(hashId: string) {
       body: JSON.stringify(args),
     });
     if (!response.ok) throw new Error(`[anaemia] RPC execution failed: ${response.status}`);
-    return await response.json() as unknown;
+    return (await response.json()) as unknown;
   };
 
   asyncRpcCall.id = hashId;
@@ -94,7 +94,7 @@ export function $$executeClientRpc(hashId: string) {
           if (match) return match.data;
         }
       }
-      return undefined;
+      return;
     }
 
     ensureCacheInitialized();
@@ -104,4 +104,4 @@ export function $$executeClientRpc(hashId: string) {
   };
 
   return asyncRpcCall;
-}
+}

package/src/runtime/webpack.d.ts

@@ -3,4 +3,4 @@ interface ImportMeta {
     accept(dep: string | string[], callback?: () => void): void;
     dispose(callback: (data: unknown) => void): void;
   };
-}
+}

package/src/types.ts

@@ -13,7 +13,9 @@ export interface LoaderArgs<Params extends Record<string, string> = Record<strin
 /**
  * represents an application page loader function.
  */
-export type LoaderFunction<ResponseData = unknown, Params extends Record<string, string> = Record<string, string>> = (args: LoaderArgs<Params>) => Promise<ResponseData> | ResponseData;
+export type LoaderFunction<ResponseData = unknown, Params extends Record<string, string> = Record<string, string>> = (
+  args: LoaderArgs<Params>,
+) => Promise<ResponseData> | ResponseData;
 
 /**
  * extracts and unwraps the true data structure returned by a server function or loader.
@@ -27,9 +29,22 @@ export type GuardContext = {
   url: string;
 };
 
-export type GuardResult = void | undefined | { redirect: string; status?: 301 | 302 | 307 | 308 } | { status: 401 | 403 | 404 | 500; body?: string };
+export type GuardResult =
+  | void
+  | undefined
+  | { redirect: string; status?: 301 | 302 | 307 | 308 }
+  | { status: 401 | 403 | 404 | 500; body?: string };
 
-export type GuardFn = (ctx: { params: Record<string, string>; request: Request; url: string }) => void | undefined | { redirect: string; status?: RedirectStatusCode } | { status: number; body?: string } | Promise<void | undefined | { redirect: string; status?: RedirectStatusCode } | { status: number; body?: string }>;
+export type GuardFn = (ctx: {
+  params: Record<string, string>;
+  request: Request;
+  url: string;
+}) =>
+  | void
+  | undefined
+  | { redirect: string; status?: RedirectStatusCode }
+  | { status: number; body?: string }
+  | Promise<void | undefined | { redirect: string; status?: RedirectStatusCode } | { status: number; body?: string }>;
 
 export type ServerFunction<Args extends unknown[], Return> = ((...args: Args) => Promise<Return>) & {
   id?: string;

package/test/integration/hmr.test.mjs

@@ -28,7 +28,9 @@ async function resolveConfigPort() {
         return userConfig.port;
       }
     } catch (err) {
-      console.warn(`[HMR test warning]: failed parsing anaemia.config.ts, falling back to port 3000. Error: ${err.message}`);
+      console.warn(
+        `[HMR test warning]: failed parsing anaemia.config.ts, falling back to port 3000. Error: ${err.message}`,
+      );
     }
   }
 
@@ -119,11 +121,18 @@ test("integration - dev server HMR & hydration lifecycle", async (t) => {
 
     const titleText = await page.textContent("h1");
     assert.equal(titleText.trim(), "anaemia");
-    assert.equal(consoleErrors.length, 0, `Errors during initial render: ${consoleErrors.map((e) => e.message).join(", ")}`);
+    assert.equal(
+      consoleErrors.length,
+      0,
+      `Errors during initial render: ${consoleErrors.map((e) => e.message).join(", ")}`,
+    );
   });
 
   await t.test("should push hot module updates to browser when files change", async () => {
-    const updatedContent = originalComponentContent.replace(`<h1 class={styles.title}>anaemia</h1>`, `<h1 class={styles.title}>anaemia updated!</h1>`);
+    const updatedContent = originalComponentContent.replace(
+      `<h1 class={styles.title}>anaemia</h1>`,
+      `<h1 class={styles.title}>anaemia updated!</h1>`,
+    );
 
     assert.notEqual(originalComponentContent, updatedContent, "Regex failed to modify component text.");
     fs.writeFileSync(componentPath, updatedContent, "utf-8");
@@ -134,7 +143,7 @@ test("integration - dev server HMR & hydration lifecycle", async (t) => {
         const h1 = document.querySelector("h1");
         return h1 && h1.textContent.trim() === "anaemia updated!";
       },
-      { timeout: 10000 }
+      { timeout: 10000 },
     );
   });
 
@@ -145,6 +154,10 @@ test("integration - dev server HMR & hydration lifecycle", async (t) => {
 
     const titleText = await page.textContent("h1");
     assert.equal(titleText.trim(), "anaemia updated!");
-    assert.equal(consoleErrors.length, 0, `Errors detected after page refresh: ${consoleErrors.map((e) => e.message).join(", ")}`);
+    assert.equal(
+      consoleErrors.length,
+      0,
+      `Errors detected after page refresh: ${consoleErrors.map((e) => e.message).join(", ")}`,
+    );
   });
 });

package/test/rpc-client.test.mjs

@@ -68,4 +68,4 @@ test("asyncRpcCall returns undefined when no SSR store exists", async () => {
   const fn = $$executeClientRpc("missing");
   const result = await fn("someArg");
   assert.equal(result, undefined);
-});
+});

package/test/run-on-server.test.mjs

@@ -1,10 +1,6 @@
 import assert from "node:assert/strict";
 import test from "node:test";
-import {
-  runOnServer,
-  serverFunctionsRegistry,
-  ssrStorage,
-} from "../dist/runtime/context.js";
+import { runOnServer, serverFunctionsRegistry, ssrStorage } from "../dist/runtime/context.js";
 import { createRouteRequest } from "../dist/runtime/route-request.js";
 
 test("runOnServer returns a callable function and registers the original implementation", async () => {
@@ -26,7 +22,7 @@ test("runOnServer records SSR results by id and argument list for hydration", as
 
   assert.deepEqual(store.get("__SERVER_FUNCTION_DATA__"), {
     greet: {
-      "[\"Ada\"]": "hello Ada",
+      '["Ada"]': "hello Ada",
     },
   });
 });

package/tsconfig.json

@@ -9,4 +9,4 @@
     "types": ["node"]
   },
   "include": ["src/**/*"]
-}
+}