@anaemia/cli 0.0.1 → 0.1.1

package/README.md

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

package/dist/index.js

@@ -41,13 +41,12 @@ const logger = {
 const cli = cac("anaemia");
 async function loadUserConfig(appRoot) {
     const configPath = path.resolve(appRoot, "anaemia.config.ts");
-    if (!fs.existsSync(configPath)) {
+    if (!fs.existsSync(configPath))
         return {};
-    }
     try {
         const jiti = createJiti(import.meta.url);
         const module = (await jiti.import(configPath));
-        return module.default || module;
+        return (module.default ?? module);
     }
     catch (err) {
         logger.error("failed parsing your anaemia.config.ts file:", err);
@@ -316,7 +315,7 @@ cli
                         fs.writeFileSync(newPath, compiled.code, "utf8");
                         fs.unlinkSync(fullPath);
                     }
-                    catch (err) {
+                    catch {
                         logger.warn(`failed to strip types from ${file}, skipping...`);
                     }
                 }

package/dist/scaffold.js

@@ -4,6 +4,7 @@ import { toCamelCase, toKebabCase, toPascalCase } from "./utils/casing.js";
 export function scaffoldFeature(rawName, appRoot) {
     const folderName = toKebabCase(rawName);
     const componentName = toPascalCase(rawName);
+    const camelName = toCamelCase(rawName);
     const isTypeScript = fs.existsSync(path.join(appRoot, "tsconfig.json"));
     const ext = isTypeScript ? "tsx" : "jsx";
     const scriptExt = isTypeScript ? "ts" : "js";
@@ -11,110 +12,105 @@ export function scaffoldFeature(rawName, appRoot) {
     const directories = [path.join(featureDir, "components"), path.join(featureDir, "hooks"), path.join(featureDir, "server")];
     directories.forEach((dir) => fs.mkdirSync(dir, { recursive: true }));
     const componentContent = isTypeScript
-        ? `import { children, JSX } from "solid-js";
+        ? `import type { JSX } from "solid-js";
 import styles from "./${componentName}.module.scss";
 
+// data flows in from the route loader via props.
+// in your route file:
+//
+//   import { ${camelName}Action } from "@features/${folderName}/index.js";
+//
+//   export const loader = async () => await ${camelName}Action(undefined);
+//
+//   export default function Page() {
+//     const data = useRouteData();
+//     return <${componentName} data={data()} />;
+//   }
+
 interface ${componentName}Props {
   children?: JSX.Element;
+  data?: unknown;
 }
 
 export function ${componentName}(props: ${componentName}Props) {
-  const resolved = children(() => props.children);
-
   return (
     <div class={styles.wrapper}>
-      Welcome to ${componentName}
-      {resolved()}
+      {props.children}
     </div>
   );
 }
 `
-        : `import { children } from "solid-js";
-import styles from "./${componentName}.module.scss";
+        : `import styles from "./${componentName}.module.scss";
 
 export function ${componentName}(props) {
-  const resolved = children(() => props.children);
-
   return (
     <div class={styles.wrapper}>
-      Welcome to ${componentName}
-      {resolved()}
+      {props.children}
     </div>
   );
 }
 `;
     const actionsContent = isTypeScript
-        ? `import { runOnServer } from "@anaemia/core";
+        ? `// raw server-side logic — DO NOT import UI code here
+// these functions run exclusively on the server
 
-export const ${toCamelCase(componentName)}Action = runOnServer(async (input: unknown) => {
+export async function ${camelName}Query(input: unknown) {
   // TODO: implement server-side logic
   return { ok: true };
-});
+}
 `
-        : `import { runOnServer } from "@anaemia/core";
+        : `// raw server-side logic — DO NOT import UI code here
+// these functions run exclusively on the server
 
-export const ${toCamelCase(componentName)}Action = runOnServer(async (input) => {
+export async function ${camelName}Query(input) {
   // TODO: implement server-side logic
   return { ok: true };
-});
+}
 `;
     const hookContent = isTypeScript
-        ? `import { createSignal } from "solid-js";
-import { ${toCamelCase(componentName)}Action } from "../server/actions";
+        ? `import { createServerResource } from "@anaemia/core";
+import { ${camelName}Action } from "../index.js";
 
 export function use${componentName}() {
-  const [data, setData] = createSignal<unknown>(null);
-  const [error, setError] = createSignal<string | null>(null);
-  const [loading, setLoading] = createSignal(false);
-
-  const execute = async (input: unknown) => {
-    setLoading(true);
-    setError(null);
-    try {
-      const result = await ${toCamelCase(componentName)}Action(input);
-      setData(result);
-      return result;
-    } catch (err: any) {
-      setError(err.message ?? "Unknown error");
-    } finally {
-      setLoading(false);
-    }
-  };
+  const [data] = createServerResource(() => undefined, ${camelName}Action);
 
-  return { data, error, loading, execute };
+  return { data };
 }
 `
-        : `import { createSignal } from "solid-js";
-import { ${toCamelCase(componentName)}Action } from "../server/actions";
+        : `import { createServerResource } from "@anaemia/core";
+import { ${camelName}Action } from "../index.js";
 
 export function use${componentName}() {
-  const [data, setData] = createSignal(null);
-  const [error, setError] = createSignal(null);
-  const [loading, setLoading] = createSignal(false);
-
-  const execute = async (input) => {
-    setLoading(true);
-    setError(null);
-    try {
-      const result = await ${toCamelCase(componentName)}Action(input);
-      setData(result);
-      return result;
-    } catch (err) {
-      setError(err.message ?? "Unknown error");
-    } finally {
-      setLoading(false);
-    }
-  };
+  const [data] = createServerResource(() => undefined, ${camelName}Action);
 
-  return { data, error, loading, execute };
+  return { data };
 }
 `;
-    const indexContent = `export { ${componentName} } from "./components/${componentName}";
-export { use${componentName} } from "./hooks/use${componentName}";
+    const indexContent = isTypeScript
+        ? `import { runOnServer } from "@anaemia/core";
+import { ${camelName}Query } from "./server/actions.server.js";
+
+// runOnServer wrappers — import these in your route loaders
+export const ${camelName}Action = runOnServer(async (input: unknown) => {
+  return await ${camelName}Query(input);
+});
+
+export { ${componentName} } from "./components/${componentName}.js";
+export { use${componentName} } from "./hooks/use${componentName}.js";
+`
+        : `import { runOnServer } from "@anaemia/core";
+import { ${camelName}Query } from "./server/actions.server.js";
+
+export const ${camelName}Action = runOnServer(async (input) => {
+  return await ${camelName}Query(input);
+});
+
+export { ${componentName} } from "./components/${componentName}.js";
+export { use${componentName} } from "./hooks/use${componentName}.js";
 `;
     fs.writeFileSync(path.join(featureDir, `components/${componentName}.${ext}`), componentContent, "utf8");
     fs.writeFileSync(path.join(featureDir, `components/${componentName}.module.scss`), `.wrapper {\n  display: block;\n}\n`, "utf8");
-    fs.writeFileSync(path.join(featureDir, `server/actions.${scriptExt}`), actionsContent, "utf8");
+    fs.writeFileSync(path.join(featureDir, `server/actions.server.${scriptExt}`), actionsContent, "utf8");
     fs.writeFileSync(path.join(featureDir, `hooks/use${componentName}.${scriptExt}`), hookContent, "utf8");
     fs.writeFileSync(path.join(featureDir, `index.${scriptExt}`), indexContent, "utf8");
     console.log("\n🎯 successfully generated feature domain template structure:");
@@ -123,8 +119,10 @@ export { use${componentName} } from "./hooks/use${componentName}";
     console.log(`      │   ├── ${componentName}.${ext}`);
     console.log(`      │   └── ${componentName}.module.scss`);
     console.log(`      ├── hooks/`);
-    console.log(`      └── server/`);
-    console.log(`          └── actions.${scriptExt}\n`);
+    console.log(`      │   └── use${componentName}.${scriptExt}`);
+    console.log(`      ├── server/`);
+    console.log(`      │   └── actions.server.${scriptExt}`);
+    console.log(`      └── index.${scriptExt}\n`);
 }
 export function generateSharedComponent(appRoot, componentName, { logger, pc }) {
     const kebabFolder = toKebabCase(componentName);

package/package.json

@@ -1,30 +1,30 @@
 {
   "name": "@anaemia/cli",
-  "version": "0.0.1",
+  "version": "0.1.1",
   "type": "module",
   "bin": {
     "anaemia": "./dist/index.js"
   },
   "dependencies": {
-    "@rspack/core": "^2.0.4",
+    "@rspack/core": "^2.0.5",
+    "@rspack/dev-server": "2.0.1",
     "cac": "^7.0.0",
     "cross-spawn": "^7.0.6",
     "jiti": "^2.7.0",
     "picocolors": "^1.1.1",
     "prompts": "^2.4.2",
     "sucrase": "^3.35.1",
+    "fs-extra": "^11.3.5",
     "ws": "^8.21.0",
-    "@anaemia/bundler": "0.0.1",
-    "@anaemia/core": "0.0.1"
+    "@anaemia/bundler": "0.1.0",
+    "@anaemia/core": "0.1.0"
   },
   "devDependencies": {
-    "@rspack/dev-server": "^2.0.1",
     "@types/cross-spawn": "^6.0.6",
     "@types/fs-extra": "^11.0.4",
     "@types/node": "^25.9.1",
     "@types/prompts": "^2.4.9",
-    "@types/ws": "^8.18.1",
-    "fs-extra": "^11.3.5"
+    "@types/ws": "^8.18.1"
   },
   "scripts": {
     "build": "tsc",

package/src/index.ts

@@ -17,6 +17,7 @@ import { transform } from "sucrase";
 import { WebSocketServer } from "ws";
 import { WebSocket as NodeWS } from "ws";
 import http from "node:http";
+import { AnaemiaConfig } from "@anaemia/core/config";
 
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = path.dirname(__filename);
@@ -33,7 +34,7 @@ const logger = {
   warn(msg: string) {
     console.log(`${this.prefix} ${pc.yellow(msg)}`);
   },
-  error(msg: string, detail?: any) {
+  error(msg: string, detail?: unknown) {
     console.error(`${this.prefix} ${pc.red(msg)}`);
     if (detail) console.error(detail);
   },
@@ -44,17 +45,19 @@ const logger = {
 
 const cli = cac("anaemia");
 
-async function loadUserConfig(appRoot: string) {
-  const configPath = path.resolve(appRoot, "anaemia.config.ts");
+interface UserConfigModule {
+  default?: AnaemiaConfig;
+  [key: string]: unknown;
+}
 
-  if (!fs.existsSync(configPath)) {
-    return {};
-  }
+async function loadUserConfig(appRoot: string): Promise<AnaemiaConfig> {
+  const configPath = path.resolve(appRoot, "anaemia.config.ts");
+  if (!fs.existsSync(configPath)) return {};
 
   try {
     const jiti = createJiti(import.meta.url);
-    const module = (await jiti.import(configPath)) as any;
-    return module.default || module;
+    const module = (await jiti.import(configPath)) as UserConfigModule;
+    return (module.default ?? module) as AnaemiaConfig;
   } catch (err) {
     logger.error("failed parsing your anaemia.config.ts file:", err);
     return {};
@@ -375,7 +378,7 @@ cli
 
               fs.writeFileSync(newPath, compiled.code, "utf8");
               fs.unlinkSync(fullPath);
-            } catch (err) {
+            } catch {
               logger.warn(`failed to strip types from ${file}, skipping...`);
             }
           }

package/src/scaffold.ts

@@ -5,6 +5,7 @@ import { toCamelCase, toKebabCase, toPascalCase } from "./utils/casing.js";
 export function scaffoldFeature(rawName: string, appRoot: string) {
   const folderName = toKebabCase(rawName);
   const componentName = toPascalCase(rawName);
+  const camelName = toCamelCase(rawName);
 
   const isTypeScript = fs.existsSync(path.join(appRoot, "tsconfig.json"));
   const ext = isTypeScript ? "tsx" : "jsx";
@@ -17,116 +18,111 @@ export function scaffoldFeature(rawName: string, appRoot: string) {
   directories.forEach((dir) => fs.mkdirSync(dir, { recursive: true }));
 
   const componentContent = isTypeScript
-    ? `import { children, JSX } from "solid-js";
+    ? `import type { JSX } from "solid-js";
 import styles from "./${componentName}.module.scss";
 
+// data flows in from the route loader via props.
+// in your route file:
+//
+//   import { ${camelName}Action } from "@features/${folderName}/index.js";
+//
+//   export const loader = async () => await ${camelName}Action(undefined);
+//
+//   export default function Page() {
+//     const data = useRouteData();
+//     return <${componentName} data={data()} />;
+//   }
+
 interface ${componentName}Props {
   children?: JSX.Element;
+  data?: unknown;
 }
 
 export function ${componentName}(props: ${componentName}Props) {
-  const resolved = children(() => props.children);
-
   return (
     <div class={styles.wrapper}>
-      Welcome to ${componentName}
-      {resolved()}
+      {props.children}
     </div>
   );
 }
 `
-    : `import { children } from "solid-js";
-import styles from "./${componentName}.module.scss";
+    : `import styles from "./${componentName}.module.scss";
 
 export function ${componentName}(props) {
-  const resolved = children(() => props.children);
-
   return (
     <div class={styles.wrapper}>
-      Welcome to ${componentName}
-      {resolved()}
+      {props.children}
     </div>
   );
 }
 `;
 
   const actionsContent = isTypeScript
-    ? `import { runOnServer } from "@anaemia/core";
+    ? `// raw server-side logic — DO NOT import UI code here
+// these functions run exclusively on the server
 
-export const ${toCamelCase(componentName)}Action = runOnServer(async (input: unknown) => {
+export async function ${camelName}Query(input: unknown) {
   // TODO: implement server-side logic
   return { ok: true };
-});
+}
 `
-    : `import { runOnServer } from "@anaemia/core";
+    : `// raw server-side logic — DO NOT import UI code here
+// these functions run exclusively on the server
 
-export const ${toCamelCase(componentName)}Action = runOnServer(async (input) => {
+export async function ${camelName}Query(input) {
   // TODO: implement server-side logic
   return { ok: true };
-});
+}
 `;
 
   const hookContent = isTypeScript
-    ? `import { createSignal } from "solid-js";
-import { ${toCamelCase(componentName)}Action } from "../server/actions";
+    ? `import { createServerResource } from "@anaemia/core";
+import { ${camelName}Action } from "../index.js";
 
 export function use${componentName}() {
-  const [data, setData] = createSignal<unknown>(null);
-  const [error, setError] = createSignal<string | null>(null);
-  const [loading, setLoading] = createSignal(false);
-
-  const execute = async (input: unknown) => {
-    setLoading(true);
-    setError(null);
-    try {
-      const result = await ${toCamelCase(componentName)}Action(input);
-      setData(result);
-      return result;
-    } catch (err: any) {
-      setError(err.message ?? "Unknown error");
-    } finally {
-      setLoading(false);
-    }
-  };
+  const [data] = createServerResource(() => undefined, ${camelName}Action);
 
-  return { data, error, loading, execute };
+  return { data };
 }
 `
-    : `import { createSignal } from "solid-js";
-import { ${toCamelCase(componentName)}Action } from "../server/actions";
+    : `import { createServerResource } from "@anaemia/core";
+import { ${camelName}Action } from "../index.js";
 
 export function use${componentName}() {
-  const [data, setData] = createSignal(null);
-  const [error, setError] = createSignal(null);
-  const [loading, setLoading] = createSignal(false);
-
-  const execute = async (input) => {
-    setLoading(true);
-    setError(null);
-    try {
-      const result = await ${toCamelCase(componentName)}Action(input);
-      setData(result);
-      return result;
-    } catch (err) {
-      setError(err.message ?? "Unknown error");
-    } finally {
-      setLoading(false);
-    }
-  };
+  const [data] = createServerResource(() => undefined, ${camelName}Action);
 
-  return { data, error, loading, execute };
+  return { data };
 }
 `;
 
-  const indexContent = `export { ${componentName} } from "./components/${componentName}";
-export { use${componentName} } from "./hooks/use${componentName}";
+  const indexContent = isTypeScript
+    ? `import { runOnServer } from "@anaemia/core";
+import { ${camelName}Query } from "./server/actions.server.js";
+
+// runOnServer wrappers — import these in your route loaders
+export const ${camelName}Action = runOnServer(async (input: unknown) => {
+  return await ${camelName}Query(input);
+});
+
+export { ${componentName} } from "./components/${componentName}.js";
+export { use${componentName} } from "./hooks/use${componentName}.js";
+`
+    : `import { runOnServer } from "@anaemia/core";
+import { ${camelName}Query } from "./server/actions.server.js";
+
+export const ${camelName}Action = runOnServer(async (input) => {
+  return await ${camelName}Query(input);
+});
+
+export { ${componentName} } from "./components/${componentName}.js";
+export { use${componentName} } from "./hooks/use${componentName}.js";
 `;
 
   fs.writeFileSync(path.join(featureDir, `components/${componentName}.${ext}`), componentContent, "utf8");
 
   fs.writeFileSync(path.join(featureDir, `components/${componentName}.module.scss`), `.wrapper {\n  display: block;\n}\n`, "utf8");
 
-  fs.writeFileSync(path.join(featureDir, `server/actions.${scriptExt}`), actionsContent, "utf8");
+  fs.writeFileSync(path.join(featureDir, `server/actions.server.${scriptExt}`), actionsContent, "utf8");
 
   fs.writeFileSync(path.join(featureDir, `hooks/use${componentName}.${scriptExt}`), hookContent, "utf8");
 
@@ -138,8 +134,10 @@ export { use${componentName} } from "./hooks/use${componentName}";
   console.log(`      │   ├── ${componentName}.${ext}`);
   console.log(`      │   └── ${componentName}.module.scss`);
   console.log(`      ├── hooks/`);
-  console.log(`      └── server/`);
-  console.log(`          └── actions.${scriptExt}\n`);
+  console.log(`      │   └── use${componentName}.${scriptExt}`);
+  console.log(`      ├── server/`);
+  console.log(`      │   └── actions.server.${scriptExt}`);
+  console.log(`      └── index.${scriptExt}\n`);
 }
 
 interface GeneratorOptions {

package/src/types/rspack-dev-server.d.ts

@@ -0,0 +1,15 @@
+// fuck you typescript
+
+declare module "@rspack/dev-server" {
+  import type { Compiler, MultiCompiler, DevServer } from "@rspack/core";
+
+  export type DevServerConfiguration = DevServer;
+
+  export class RspackDevServer {
+    constructor(config: DevServer, compiler: Compiler | MultiCompiler);
+    start(): Promise<void>;
+    stop(): Promise<void>;
+  }
+
+  export default RspackDevServer;
+}

package/tsconfig.json

@@ -3,7 +3,6 @@
   "compilerOptions": {
     "outDir": "./dist",
     "rootDir": "./src",
-    "types": ["node"],
     "noEmit": false,
     "paths": {}
   },

package/dist/route-manifest.json

@@ -1,6 +0,0 @@
-{
-  "routes": [],
-  "errors": {},
-  "chunks": {},
-  "buildTime": "2026-05-28T16:49:33.968Z"
-}