create-spacefn 0.1.0

package/bin/create-space-app.js

@@ -0,0 +1,4 @@
+#!/usr/bin/env node
+import { createRequire } from "node:module";
+const require = createRequire(import.meta.url);
+require("../dist/index.js");

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+
+export {  }

package/dist/index.js

@@ -0,0 +1,129 @@
+// src/index.ts
+import { execSync } from "child_process";
+import { existsSync } from "fs";
+import { mkdir, writeFile, cp, readFile } from "fs/promises";
+import * as p from "@clack/prompts";
+import { defineCommand, runMain } from "citty";
+import { resolve, join } from "pathe";
+import pc from "picocolors";
+var TEMPLATES = ["minimal"];
+var TEMPLATE_DIR = join(import.meta.dirname, "templates");
+var PKG_MANAGERS = [
+  { value: "pnpm", label: "pnpm", install: "pnpm add", addDev: "pnpm add -D" },
+  { value: "npm", label: "npm", install: "npm i", addDev: "npm i -D" },
+  { value: "yarn", label: "yarn", install: "yarn add", addDev: "yarn add -D" },
+  { value: "bun", label: "bun", install: "bun add", addDev: "bun add -d" }
+];
+async function writeTemplate(targetDir, template, projectName) {
+  const srcDir = join(TEMPLATE_DIR, template);
+  await cp(srcDir, targetDir, { recursive: true });
+  const files = ["package.json", "wrangler.toml"];
+  for (const file of files) {
+    const filePath = join(targetDir, file);
+    if (existsSync(filePath)) {
+      const content = await readFile(filePath, "utf-8");
+      await writeFile(filePath, content.replaceAll("{{app_name}}", projectName));
+    }
+  }
+}
+function install(targetDir, pm, deps, devDeps) {
+  const mgr = PKG_MANAGERS.find((m) => m.value === pm);
+  if (deps.length > 0) {
+    execSync(`${mgr.install} ${deps.join(" ")}`, { cwd: targetDir, stdio: "inherit" });
+  }
+  if (devDeps.length > 0) {
+    execSync(`${mgr.addDev} ${devDeps.join(" ")}`, { cwd: targetDir, stdio: "inherit" });
+  }
+}
+var main = defineCommand({
+  meta: {
+    name: "create-spacefn",
+    description: "Scaffold a new Space project",
+    version: "0.1.0"
+  },
+  args: {
+    name: {
+      type: "positional",
+      description: "Project name",
+      required: false
+    }
+  },
+  async run({ args }) {
+    p.intro(pc.bold(pc.cyan("Create Space App")));
+    let projectName = args.name;
+    if (!projectName) {
+      const name = await p.text({
+        message: "Project name?",
+        placeholder: "my-space-app",
+        validate(value) {
+          if (!value) return "Project name is required";
+          if (!/^[a-z0-9-_]+$/.test(value))
+            return "Use lowercase, numbers, hyphens, or underscores";
+        }
+      });
+      if (p.isCancel(name)) {
+        p.cancel("Cancelled");
+        process.exit(0);
+      }
+      projectName = name || "my-space-app";
+    }
+    const pm = await p.select({
+      message: "Package manager?",
+      options: PKG_MANAGERS.map((m) => ({
+        value: m.value,
+        label: m.label
+      })),
+      initialValue: "npm"
+    });
+    if (p.isCancel(pm)) {
+      p.cancel("Cancelled");
+      process.exit(0);
+    }
+    const template = await p.select({
+      message: "Template?",
+      options: TEMPLATES.map((t) => ({
+        value: t,
+        label: t,
+        hint: t === "minimal" ? "Basic routing and HTML" : void 0
+      })),
+      initialValue: "minimal"
+    });
+    if (p.isCancel(template)) {
+      p.cancel("Cancelled");
+      process.exit(0);
+    }
+    const targetDir = resolve(process.cwd(), projectName);
+    if (existsSync(targetDir)) {
+      p.cancel(`Directory ${projectName} already exists`);
+      process.exit(1);
+    }
+    const s = p.spinner();
+    s.start("Creating project...");
+    await mkdir(targetDir, { recursive: true });
+    await writeTemplate(targetDir, template, projectName);
+    s.stop("Project created");
+    const installDeps = await p.confirm({
+      message: "Install dependencies?",
+      initialValue: true
+    });
+    if (p.isCancel(installDeps)) {
+      p.cancel("Cancelled");
+      process.exit(0);
+    }
+    if (installDeps) {
+      const s2 = p.spinner();
+      s2.start("Installing @space packages...");
+      install(
+        targetDir,
+        pm,
+        ["@spacefn/html", "@spacefn/server", "@spacefn/datastar"],
+        ["wrangler", "oxlint", "oxfmt", "vite", "vitest"]
+      );
+      s2.stop("Dependencies installed");
+    }
+    p.outro(pc.green("Done!"));
+    p.note(`cd ${projectName}
+${pm} dev`, "Next steps");
+  }
+});
+runMain(main);

package/dist/templates/minimal/configs/oxfmt.ts

@@ -0,0 +1,8 @@
+import { defineConfig } from "oxfmt";
+
+export default defineConfig({
+	sortImports: true,
+	sortPackageJson: true,
+	sortTailwindcss: true,
+	trailingComma: "all",
+});

package/dist/templates/minimal/configs/oxlint.ts

@@ -0,0 +1,8 @@
+import { defineConfig } from "oxlint";
+
+export default defineConfig({
+	rules: {
+		"no-unused-vars": "error",
+		"typescript/no-deprecated": "error",
+	},
+});

package/dist/templates/minimal/package.json

@@ -0,0 +1,18 @@
+{
+	"name": "{{app_name}}",
+	"version": "0.0.1",
+	"type": "module",
+	"scripts": {
+		"dev": "spacefn dev",
+		"build": "spacefn build",
+		"test": "vitest run",
+		"fmt": "oxfmt -c configs/oxfmt.ts",
+		"fmt:check": "oxfmt -c configs/oxfmt.ts --check",
+		"lint": "oxlint -c configs/oxlint.ts",
+		"lint:fix": "oxlint -c configs/oxlint.ts --fix"
+	},
+	"devDependencies": {
+		"@spacefn/server": "latest",
+		"vitest": "^3.0.0"
+	}
+}

package/dist/templates/minimal/src/main.ts

@@ -0,0 +1,6 @@
+import { createServer } from "@spacefn/server";
+
+import middlewares from "#space/middlewares";
+import routes from "#space/routes";
+
+export default createServer({ routes, middlewares });

package/dist/templates/minimal/src/pages/index.page.ts

@@ -0,0 +1,9 @@
+import { defineComponent, h } from "@spacefn/html";
+
+type Props = {
+	msg: string;
+};
+
+export default defineComponent<Props>((props) => {
+	return h.main({}, h.h1({}, props.msg), h.p({}, "Welcome to your Space app"));
+});

package/dist/templates/minimal/src/pages/index.server.ts

@@ -0,0 +1,5 @@
+import { defineLoader } from "@spacefn/server";
+
+export const loader = defineLoader(async (_req) => {
+	return { msg: "Hello World!" };
+});

package/dist/templates/minimal/src/pages/index.test.ts

@@ -0,0 +1,22 @@
+import { createTestHandler } from "@spacefn/server/test";
+import { describe, it, expect } from "vitest";
+
+import Page from "./index.page";
+import { loader } from "./index.server";
+
+const handler = createTestHandler({ loader, page: Page });
+
+describe("Home page", () => {
+	it("renders with loader data", async () => {
+		const res = await handler(new Request("http://localhost/"));
+		const html = await res.text();
+
+		expect(res.status).toBe(200);
+		expect(html).toContain("Hello World!");
+	});
+
+	it("returns HTML content type", async () => {
+		const res = await handler(new Request("http://localhost/"));
+		expect(res.headers.get("Content-Type")).toBe("text/html");
+	});
+});

package/dist/templates/minimal/src/routes/index.ts

@@ -0,0 +1,14 @@
+import { h, render } from "@spacefn/html";
+
+export default function () {
+	return new Response(
+		render(
+			h.html(
+				{},
+				h.head({}, h.title({}, "Home")),
+				h.body({}, h.main({}, h.h1({}, "Hello from Space"), h.p({}, "Your app is running."))),
+			),
+		),
+		{ headers: { "Content-Type": "text/html" } },
+	);
+}

package/dist/templates/minimal/tsconfig.json

@@ -0,0 +1,14 @@
+{
+	"compilerOptions": {
+		"target": "ES2022",
+		"module": "ESNext",
+		"moduleResolution": "bundler",
+		"strict": true,
+		"esModuleInterop": true,
+		"skipLibCheck": true,
+		"paths": {
+			"#space/*": [".space/*"]
+		}
+	},
+	"include": ["src"]
+}

package/dist/templates/minimal/vite.config.ts

@@ -0,0 +1,9 @@
+import { space } from "@spacefn/server/vite";
+import { defineConfig } from "vite";
+
+export default defineConfig({
+	resolve: {
+		tsconfigPaths: true,
+	},
+	plugins: [space()],
+});

package/dist/templates/minimal/vitest.config.ts

@@ -0,0 +1,7 @@
+import { defineConfig } from "vitest/config";
+
+export default defineConfig({
+	test: {
+		include: ["src/**/*.test.ts"],
+	},
+});

package/dist/templates/minimal/wrangler.toml

@@ -0,0 +1 @@
+name = "{{app_name}}"

package/package.json

@@ -0,0 +1,23 @@
+{
+	"name": "create-spacefn",
+	"version": "0.1.0",
+	"bin": {
+		"create-spacefn": "./bin/create-space-app.js"
+	},
+	"type": "module",
+	"scripts": {
+		"build": "rm -rf dist && tsup && cp -r src/templates dist/templates",
+		"typecheck": "tsc --noEmit"
+	},
+	"dependencies": {
+		"@clack/prompts": "^0.9.0",
+		"citty": "^0.1.0",
+		"pathe": "^2.0.0",
+		"picocolors": "^1.1.0"
+	},
+	"devDependencies": {
+		"@types/node": "^22.0.0",
+		"tsup": "^8.0.0",
+		"typescript": "^5.5.0"
+	}
+}

package/src/index.ts

@@ -0,0 +1,169 @@
+import { execSync } from "node:child_process";
+import { existsSync } from "node:fs";
+// --- Create Space App ---------------------------------------------------------
+// Scaffold a new Space project
+import { mkdir, writeFile, cp, readFile } from "node:fs/promises";
+
+import * as p from "@clack/prompts";
+import { defineCommand, runMain } from "citty";
+import { resolve, join } from "pathe";
+import pc from "picocolors";
+
+// --- Templates ----------------------------------------------------------------
+
+const TEMPLATES = ["minimal"] as const;
+type Template = (typeof TEMPLATES)[number];
+
+const TEMPLATE_DIR = join(import.meta.dirname, "templates");
+
+// --- Package Manager -----------------------------------------------------------
+
+type PackageManager = "pnpm" | "npm" | "yarn" | "bun";
+
+const PKG_MANAGERS: { value: PackageManager; label: string; install: string; addDev: string }[] = [
+	{ value: "pnpm", label: "pnpm", install: "pnpm add", addDev: "pnpm add -D" },
+	{ value: "npm", label: "npm", install: "npm i", addDev: "npm i -D" },
+	{ value: "yarn", label: "yarn", install: "yarn add", addDev: "yarn add -D" },
+	{ value: "bun", label: "bun", install: "bun add", addDev: "bun add -d" },
+];
+
+// --- Helpers ------------------------------------------------------------------
+
+async function writeTemplate(
+	targetDir: string,
+	template: Template,
+	projectName: string,
+): Promise<void> {
+	const srcDir = join(TEMPLATE_DIR, template);
+	await cp(srcDir, targetDir, { recursive: true });
+
+	// Replace {{app_name}} placeholder in template files
+	const files = ["package.json", "wrangler.toml"];
+	for (const file of files) {
+		const filePath = join(targetDir, file);
+		if (existsSync(filePath)) {
+			const content = await readFile(filePath, "utf-8");
+			await writeFile(filePath, content.replaceAll("{{app_name}}", projectName));
+		}
+	}
+}
+
+function install(targetDir: string, pm: PackageManager, deps: string[], devDeps: string[]): void {
+	const mgr = PKG_MANAGERS.find((m) => m.value === pm)!;
+	if (deps.length > 0) {
+		execSync(`${mgr.install} ${deps.join(" ")}`, { cwd: targetDir, stdio: "inherit" });
+	}
+	if (devDeps.length > 0) {
+		execSync(`${mgr.addDev} ${devDeps.join(" ")}`, { cwd: targetDir, stdio: "inherit" });
+	}
+}
+
+// --- CLI ----------------------------------------------------------------------
+
+const main = defineCommand({
+	meta: {
+		name: "create-spacefn",
+		description: "Scaffold a new Space project",
+		version: "0.1.0",
+	},
+	args: {
+		name: {
+			type: "positional",
+			description: "Project name",
+			required: false,
+		},
+	},
+	async run({ args }) {
+		p.intro(pc.bold(pc.cyan("Create Space App")));
+
+		// Project name
+		let projectName = args.name as string;
+		if (!projectName) {
+			const name = await p.text({
+				message: "Project name?",
+				placeholder: "my-space-app",
+				validate(value) {
+					if (!value) return "Project name is required";
+					if (!/^[a-z0-9-_]+$/.test(value))
+						return "Use lowercase, numbers, hyphens, or underscores";
+				},
+			});
+			if (p.isCancel(name)) {
+				p.cancel("Cancelled");
+				process.exit(0);
+			}
+			projectName = name || "my-space-app";
+		}
+
+		// Package manager
+		const pm = await p.select({
+			message: "Package manager?",
+			options: PKG_MANAGERS.map((m) => ({
+				value: m.value,
+				label: m.label,
+			})),
+			initialValue: "npm",
+		});
+		if (p.isCancel(pm)) {
+			p.cancel("Cancelled");
+			process.exit(0);
+		}
+
+		// Template
+		const template = await p.select({
+			message: "Template?",
+			options: TEMPLATES.map((t) => ({
+				value: t,
+				label: t,
+				hint: t === "minimal" ? "Basic routing and HTML" : undefined,
+			})),
+			initialValue: "minimal",
+		});
+		if (p.isCancel(template)) {
+			p.cancel("Cancelled");
+			process.exit(0);
+		}
+
+		// Target directory
+		const targetDir = resolve(process.cwd(), projectName);
+		if (existsSync(targetDir)) {
+			p.cancel(`Directory ${projectName} already exists`);
+			process.exit(1);
+		}
+
+		// Create project
+		const s = p.spinner();
+		s.start("Creating project...");
+		await mkdir(targetDir, { recursive: true });
+		await writeTemplate(targetDir, template as Template, projectName);
+		s.stop("Project created");
+
+		// Install dependencies
+		const installDeps = await p.confirm({
+			message: "Install dependencies?",
+			initialValue: true,
+		});
+		if (p.isCancel(installDeps)) {
+			p.cancel("Cancelled");
+			process.exit(0);
+		}
+
+		if (installDeps) {
+			const s2 = p.spinner();
+			s2.start("Installing @space packages...");
+			install(
+				targetDir,
+				pm as PackageManager,
+				["@spacefn/html", "@spacefn/server", "@spacefn/datastar"],
+				["wrangler", "oxlint", "oxfmt", "vite", "vitest"],
+			);
+			s2.stop("Dependencies installed");
+		}
+
+		// Done
+		p.outro(pc.green("Done!"));
+		p.note(`cd ${projectName}\n${pm} dev`, "Next steps");
+	},
+});
+
+runMain(main);

package/src/templates/minimal/configs/oxfmt.ts

@@ -0,0 +1,8 @@
+import { defineConfig } from "oxfmt";
+
+export default defineConfig({
+	sortImports: true,
+	sortPackageJson: true,
+	sortTailwindcss: true,
+	trailingComma: "all",
+});

package/src/templates/minimal/configs/oxlint.ts

@@ -0,0 +1,8 @@
+import { defineConfig } from "oxlint";
+
+export default defineConfig({
+	rules: {
+		"no-unused-vars": "error",
+		"typescript/no-deprecated": "error",
+	},
+});

package/src/templates/minimal/package.json

@@ -0,0 +1,18 @@
+{
+	"name": "{{app_name}}",
+	"version": "0.0.1",
+	"type": "module",
+	"scripts": {
+		"dev": "spacefn dev",
+		"build": "spacefn build",
+		"test": "vitest run",
+		"fmt": "oxfmt -c configs/oxfmt.ts",
+		"fmt:check": "oxfmt -c configs/oxfmt.ts --check",
+		"lint": "oxlint -c configs/oxlint.ts",
+		"lint:fix": "oxlint -c configs/oxlint.ts --fix"
+	},
+	"devDependencies": {
+		"@spacefn/server": "latest",
+		"vitest": "^3.0.0"
+	}
+}

package/src/templates/minimal/src/main.ts

@@ -0,0 +1,6 @@
+import { createServer } from "@spacefn/server";
+
+import middlewares from "#space/middlewares";
+import routes from "#space/routes";
+
+export default createServer({ routes, middlewares });

package/src/templates/minimal/src/pages/index.page.ts

@@ -0,0 +1,9 @@
+import { defineComponent, h } from "@spacefn/html";
+
+type Props = {
+	msg: string;
+};
+
+export default defineComponent<Props>((props) => {
+	return h.main({}, h.h1({}, props.msg), h.p({}, "Welcome to your Space app"));
+});

package/src/templates/minimal/src/pages/index.server.ts

@@ -0,0 +1,5 @@
+import { defineLoader } from "@spacefn/server";
+
+export const loader = defineLoader(async (_req) => {
+	return { msg: "Hello World!" };
+});

package/src/templates/minimal/src/pages/index.test.ts

@@ -0,0 +1,22 @@
+import { createTestHandler } from "@spacefn/server/test";
+import { describe, it, expect } from "vitest";
+
+import Page from "./index.page";
+import { loader } from "./index.server";
+
+const handler = createTestHandler({ loader, page: Page });
+
+describe("Home page", () => {
+	it("renders with loader data", async () => {
+		const res = await handler(new Request("http://localhost/"));
+		const html = await res.text();
+
+		expect(res.status).toBe(200);
+		expect(html).toContain("Hello World!");
+	});
+
+	it("returns HTML content type", async () => {
+		const res = await handler(new Request("http://localhost/"));
+		expect(res.headers.get("Content-Type")).toBe("text/html");
+	});
+});

package/src/templates/minimal/src/routes/index.ts

@@ -0,0 +1,14 @@
+import { h, render } from "@spacefn/html";
+
+export default function () {
+	return new Response(
+		render(
+			h.html(
+				{},
+				h.head({}, h.title({}, "Home")),
+				h.body({}, h.main({}, h.h1({}, "Hello from Space"), h.p({}, "Your app is running."))),
+			),
+		),
+		{ headers: { "Content-Type": "text/html" } },
+	);
+}

package/src/templates/minimal/tsconfig.json

@@ -0,0 +1,14 @@
+{
+	"compilerOptions": {
+		"target": "ES2022",
+		"module": "ESNext",
+		"moduleResolution": "bundler",
+		"strict": true,
+		"esModuleInterop": true,
+		"skipLibCheck": true,
+		"paths": {
+			"#space/*": [".space/*"]
+		}
+	},
+	"include": ["src"]
+}

package/src/templates/minimal/vite.config.ts

@@ -0,0 +1,9 @@
+import { space } from "@spacefn/server/vite";
+import { defineConfig } from "vite";
+
+export default defineConfig({
+	resolve: {
+		tsconfigPaths: true,
+	},
+	plugins: [space()],
+});

package/src/templates/minimal/vitest.config.ts

@@ -0,0 +1,7 @@
+import { defineConfig } from "vitest/config";
+
+export default defineConfig({
+	test: {
+		include: ["src/**/*.test.ts"],
+	},
+});

package/src/templates/minimal/wrangler.toml

@@ -0,0 +1 @@
+name = "{{app_name}}"

package/tsconfig.json

@@ -0,0 +1,15 @@
+{
+	"compilerOptions": {
+		"target": "ES2022",
+		"module": "ESNext",
+		"moduleResolution": "bundler",
+		"strict": true,
+		"esModuleInterop": true,
+		"skipLibCheck": true,
+		"declaration": true,
+		"outDir": "./dist",
+		"types": ["node"]
+	},
+	"include": ["src"],
+	"exclude": ["src/templates"]
+}

package/tsup.config.ts

@@ -0,0 +1,8 @@
+import { defineConfig } from "tsup";
+
+export default defineConfig({
+	entry: ["src/index.ts"],
+	format: ["esm"],
+	dts: true,
+	clean: true,
+});