@anaemia/core 0.0.1

package/package.json

@@ -0,0 +1,61 @@
+{
+  "name": "@anaemia/core",
+  "version": "0.0.1",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    },
+    "./config": {
+      "types": "./dist/config.d.ts",
+      "default": "./dist/config.js"
+    },
+    "./runtime/context": {
+      "types": "./dist/runtime/context.d.ts",
+      "import": "./dist/runtime/context.js",
+      "default": "./dist/runtime/context.js"
+    },
+    "./runtime/route-data": {
+      "types": "./dist/runtime/route-data.d.ts",
+      "import": "./dist/runtime/route-data.js",
+      "default": "./dist/runtime/route-data.js"
+    },
+    "./plugins": {
+      "types": "./dist/plugins/index.d.ts",
+      "import": "./dist/plugins/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "dependencies": {
+    "@hono/node-server": "^2.0.4",
+    "@solidjs/router": "^0.16.1",
+    "hono": "^4.12.23"
+  },
+  "peerDependencies": {
+    "@rspack/core": "*",
+    "lightningcss": "^1.32.0",
+    "solid-js": "^1.9.13"
+  },
+  "peerDependenciesMeta": {
+    "@rspack/core": {
+      "optional": true
+    },
+    "lightningcss": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@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",
+    "test:integration": "pnpm run build && node --test test/integration/*.test.mjs"
+  }
+}

package/src/config.ts

@@ -0,0 +1,74 @@
+import { Hono } from "hono";
+import type { Configuration } from "@rspack/core";
+
+export interface AnaemiaPlugin {
+  /**
+   * unique identifier for the plugin.
+   */
+  name: string;
+
+  /**
+   * extend or modify the rspack config for the client bundle.
+   */
+  clientRspackConfig?: (config: Configuration) => Configuration;
+
+  /**
+   * extend or modify the rspack config for the server bundle.
+   */
+  serverRspackConfig?: (config: Configuration) => Configuration;
+
+  /**
+   * add additional babel plugins to the client transform pipeline.
+   */
+  babelPlugins?: {
+    client?: any[];
+    server?: any[];
+  };
+
+  /**
+   * hook into the Hono app instance to register additional routes or middleware.
+   */
+  configureServer?: (app: Hono) => void;
+
+  /**
+   * transform the final HTML string before it is sent to the client.
+   */
+  transformHtml?: (html: string) => string | Promise<string>;
+}
+
+export interface AnaemiaConfig {
+  port?: number;
+  assets?: {
+    publicPath?: string;
+  };
+  styles?: {
+    sass?: boolean;
+    modules?: boolean;
+  };
+  experimental?: {
+    outputModule?: boolean;
+  };
+
+  /**
+   * list of anaemia plugins to apply to the build and runtime.
+   */
+  plugins?: AnaemiaPlugin[];
+
+  /**
+   * inject global constants into the client and/or server bundles at build time.
+   * values must be JSON-serializable expressions — wrap strings in JSON.stringify.
+   * @example
+   * define: {
+   *   client: { __APP_VERSION__: JSON.stringify("1.0.0") },
+   *   server: { __DB_POOL_SIZE__: "10" }
+   * }
+  */
+  define?: {
+    client?: Record<string, string>;
+    server?: Record<string, string>;
+  };
+}
+
+export function defineConfig(config: AnaemiaConfig): AnaemiaConfig {
+  return config;
+}

package/src/index.ts

@@ -0,0 +1,13 @@
+export * from "./config.js";
+
+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 ServerFunction<Args extends any[], Return> = ((...args: Args) => Promise<Return>) & {
+  id?: string;
+  urlId?: string;
+};
+
+export type { LoaderArgs, LoaderFunction, InferServerData, GuardContext, GuardResult, GuardFn } from "./types.js";

package/src/plugins/index.ts

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

package/src/plugins/lightningcss.ts

@@ -0,0 +1,82 @@
+import { createRequire } from "node:module";
+import type { AnaemiaPlugin } from "../config.js";
+
+export function anaemiaLightningCssPlugin(options: { browserslist?: string[] } = {}): AnaemiaPlugin {
+  const targets = options.browserslist ?? ["defaults", "not IE 11"];
+
+  const localRequire = createRequire(import.meta.url);
+  let rspackModule: any;
+  
+  try {
+    rspackModule = localRequire("@rspack/core");
+  } catch (err) {
+    throw new Error(
+      "[anaemia] The LightningCSS plugin requires '@rspack/core' to be available in the execution workspace."
+    );
+  }
+
+  return {
+    name: "anaemia-lightningcss-plugin",
+
+    clientRspackConfig(config) {
+      const isProd = process.env.NODE_ENV === "production";
+
+      if (config.module?.rules) {
+        config.module.rules.forEach((rule) => {
+          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: { 
+                  targets,
+                  modules: rule.type === "css/auto",
+                },
+              },
+            ];
+          }
+        });
+      }
+
+      if (isProd) {
+        config.optimization = {
+          ...config.optimization,
+          minimize: true,
+          minimizer: [
+            ...(config.optimization?.minimizer ?? []),
+            // Native Rust CSS minification engine
+            new rspackModule.LightningCssMinimizerRspackPlugin({
+              minimizerOptions: { targets },
+            }),
+          ],
+        };
+      }
+
+      return config;
+    },
+
+    serverRspackConfig(config) {
+      if (config.module?.rules) {
+        config.module.rules.forEach((rule) => {
+          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: { 
+                  targets,
+                  modules: rule.type === "css/auto",
+                },
+              },
+            ];
+          }
+        });
+      }
+      return config;
+    },
+  };
+}

package/src/runtime/context.browser.ts

@@ -0,0 +1,5 @@
+export const ssrStorage = null as any;
+export const serverFunctionsRegistry = new Map<string, Function>();
+
+// runOnServer calls are compiled away by babel-transform-server
+export const runOnServer = null as any;

package/src/runtime/context.ts

@@ -0,0 +1,34 @@
+import { AsyncLocalStorage } from "node:async_hooks";
+
+export const serverFunctionsRegistry = new Map<string, Function>();
+export const ssrStorage = new AsyncLocalStorage<Map<string, any>>();
+
+(globalThis as any).__ANAEMIA_SERVER_STORAGE__ = ssrStorage;
+
+export function runOnServer(backendFn: Function, id?: string) {
+  const hashId = id || "";
+
+  const rpcProxy = async function (...args: any[]) {
+    const result = await backendFn(...args);
+
+    const store = ssrStorage.getStore();
+    if (store && hashId) {
+      if (!store.has("__SERVER_FUNCTION_DATA__")) {
+        store.set("__SERVER_FUNCTION_DATA__", {});
+      }
+      
+      const functionCache = store.get("__SERVER_FUNCTION_DATA__");
+      if (!functionCache[hashId]) {
+        functionCache[hashId] = {};
+      }
+      
+      const paramKey = JSON.stringify(args);
+      functionCache[hashId][paramKey] = result;
+    }
+
+    return result;
+  };
+
+  rpcProxy.id = hashId;
+  return rpcProxy;
+}

package/src/runtime/entry-client.tsx

@@ -0,0 +1,34 @@
+import { hydrate, render } from "solid-js/web";
+import { Router } from "@solidjs/router";
+
+// @ts-ignore
+import App, { preloadActiveClientRoute } from "anaemia-user-app";
+
+const mountTarget = document.querySelector(
+  "[anaemia-entry]"
+) as HTMLElement | null;
+
+if (!mountTarget) {
+  throw new Error("[anaemia] missing mount target");
+}
+
+const root = mountTarget;
+
+async function start() {
+  await preloadActiveClientRoute(window.location.pathname);
+
+  const mount = root.hasChildNodes()
+    ? hydrate
+    : render;
+
+  mount(
+    () => (
+      <Router>
+        <App />
+      </Router>
+    ),
+    root
+  );
+}
+
+start();