@shivaedev/create-app 0.0.0-stage → 0.1.0

package/dist/createApp.d.ts

@@ -0,0 +1,5 @@
+import { Effect, FileSystem, Schema } from "effect";
+import { ChildProcessSpawner } from "effect/unstable/process";
+import { CreateAppError } from "./CreateAppError.ts";
+export declare const createApp: (folder: string, templatePath: string) => Effect.Effect<undefined, CreateAppError | import("effect/PlatformError").PlatformError | Schema.SchemaError, ChildProcessSpawner.ChildProcessSpawner | FileSystem.FileSystem>;
+//# sourceMappingURL=createApp.d.ts.map

package/dist/createApp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createApp.d.ts","sourceRoot":"","sources":["../src/createApp.ts"],"names":[],"mappings":"AAEA,OAAO,EAAW,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAC7D,OAAO,EAAgB,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAC5E,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAKrD,eAAO,MAAM,SAAS,yNA+BpB,CAAC"}

package/dist/createApp.js

@@ -0,0 +1,38 @@
+import { Buffer } from "node:buffer";
+import { basename, dirname, join, resolve } from "node:path";
+import { Console, Effect, FileSystem, Schema } from "effect";
+import { ChildProcess, ChildProcessSpawner } from "effect/unstable/process";
+import { CreateAppError } from "./CreateAppError.js";
+import { Template } from "./template.js";
+const decodeName = Schema.decodeUnknownEffect(Schema.fromJsonString(Schema.Record(Schema.String, Schema.Unknown)));
+export const createApp = Effect.fn("CreateApp.createApp")(function* (folder, templatePath) {
+    const fs = yield* FileSystem.FileSystem;
+    const target = resolve(folder);
+    const name = basename(target);
+    if (!/^[a-z0-9][a-z0-9._-]*$/u.test(name) || name.length > 214 || ["node_modules", "favicon.ico"].includes(name)) {
+        return yield* new CreateAppError({ message: "The final folder name must be a lowercase npm package name." });
+    }
+    if ((yield* fs.exists(target)) && ((yield* fs.stat(target)).type !== "Directory" || (yield* fs.readDirectory(target)).length > 0)) {
+        return yield* new CreateAppError({ message: `Refusing to write into ${folder}: the destination must be an empty folder.` });
+    }
+    const template = yield* Schema.decodeUnknownEffect(Schema.fromJsonString(Template))(yield* fs.readFileString(templatePath));
+    yield* fs.makeDirectory(target, { recursive: true });
+    for (const entry of template) {
+        const path = join(target, entry.path);
+        let content = Buffer.from(entry.content, "base64");
+        if (entry.path === "package.json") {
+            const manifest = yield* decodeName(content.toString());
+            content = Buffer.from(`${JSON.stringify({ ...manifest, name }, null, "\t")}\n`);
+        }
+        yield* fs.makeDirectory(dirname(path), { recursive: true });
+        yield* fs.writeFile(path, content);
+    }
+    const spawner = yield* ChildProcessSpawner.ChildProcessSpawner;
+    const code = yield* spawner.exitCode(ChildProcess.make("pnpm", ["install"], { cwd: target, stderr: "inherit", stdout: "inherit" }));
+    if (code !== 0) {
+        return yield* new CreateAppError({ message: `pnpm install failed (exit ${code}). Run pnpm install in ${folder} to retry.` });
+    }
+    const quotedFolder = `'${folder.replaceAll("'", "'\"'\"'")}'`;
+    yield* Console.log(`Created ${folder}.\n\nNext steps:\n  cd ${quotedFolder}\n  cp .env.example .env.local\n  Set DATABASE_URL to your PostgreSQL database.\n  Set BETTER_AUTH_SECRET to a random secret of at least 32 characters.\n  pnpm dev`);
+});
+//# sourceMappingURL=createApp.js.map

package/dist/createApp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createApp.js","sourceRoot":"","sources":["../src/createApp.ts"],"names":[],"mappings":"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"}

package/dist/pack.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=pack.d.ts.map

package/dist/pack.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pack.d.ts","sourceRoot":"","sources":["../src/pack.ts"],"names":[],"mappings":""}

package/dist/pack.js

@@ -0,0 +1,6 @@
+import { fileURLToPath } from "node:url";
+import { NodeRuntime, NodeServices } from "@effect/platform-node";
+import { Effect } from "effect";
+import { packTemplate } from "./packTemplate.js";
+NodeRuntime.runMain(packTemplate(fileURLToPath(new URL("../../../examples/starter", import.meta.url)), fileURLToPath(new URL("../template.json", import.meta.url))).pipe(Effect.provide(NodeServices.layer)));
+//# sourceMappingURL=pack.js.map

package/dist/pack.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pack.js","sourceRoot":"","sources":["../src/pack.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAClE,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAChC,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEjD,WAAW,CAAC,OAAO,CAClB,YAAY,CACX,aAAa,CAAC,IAAI,GAAG,CAAC,2BAA2B,EAAE,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EACpE,aAAa,CAAC,IAAI,GAAG,CAAC,kBAAkB,EAAE,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,CAC3D,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,CAC1C,CAAC"}

package/dist/packTemplate.d.ts

@@ -0,0 +1,4 @@
+import { Effect, FileSystem, type PlatformError, Schema } from "effect";
+import { CreateAppError } from "./CreateAppError.ts";
+export declare const packTemplate: (starter: string, output: string) => Effect.Effect<void, CreateAppError | PlatformError.PlatformError | Schema.SchemaError, FileSystem.FileSystem>;
+//# sourceMappingURL=packTemplate.d.ts.map

package/dist/packTemplate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"packTemplate.d.ts","sourceRoot":"","sources":["../src/packTemplate.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,KAAK,aAAa,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AACxE,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAQrD,eAAO,MAAM,YAAY,oJA8BvB,CAAC"}

package/dist/packTemplate.js

@@ -0,0 +1,39 @@
+import { Buffer } from "node:buffer";
+import { basename, join } from "node:path";
+import { Effect, FileSystem, Schema } from "effect";
+import { CreateAppError } from "./CreateAppError.js";
+import { prepareFile, Versions } from "./template.js";
+const excluded = new Set(["node_modules", "dist", "coverage", "pnpm-lock.yaml", ".git"]);
+function included(path) {
+    return !excluded.has(basename(path)) && (!basename(path).startsWith(".env") || basename(path) === ".env.example");
+}
+export const packTemplate = Effect.fn("CreateApp.packTemplate")(function* (starter, output) {
+    const fs = yield* FileSystem.FileSystem;
+    const versions = yield* Schema.decodeUnknownEffect(Schema.fromJsonString(Versions))(yield* fs.readFileString(join(starter, "published-versions.json")));
+    const entries = [];
+    const visit = Effect.fn("CreateApp.visit")(function* (directory) {
+        for (const name of (yield* fs.readDirectory(join(starter, directory))).sort()) {
+            const path = join(directory, name);
+            if (!included(path)) {
+                continue;
+            }
+            if ((yield* fs.stat(join(starter, path))).type === "Directory") {
+                yield* visit(path);
+            }
+            else {
+                const target = path === "pnpm-workspace.copy.yaml" ? "pnpm-workspace.yaml" : path;
+                const source = Buffer.from(yield* fs.readFile(join(starter, path)));
+                const content = yield* Effect.try({
+                    catch: (cause) => new CreateAppError({ message: String(cause) }),
+                    try: () => ["biome.json", "package.json", "tsconfig.json", "vite.config.ts", "vitest.config.ts"].includes(path)
+                        ? Buffer.from(prepareFile(path, source.toString(), versions))
+                        : source,
+                });
+                entries.push({ content: content.toString("base64"), path: target });
+            }
+        }
+    });
+    yield* visit("");
+    yield* fs.writeFileString(output, `${JSON.stringify(entries)}\n`);
+});
+//# sourceMappingURL=packTemplate.js.map

package/dist/packTemplate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"packTemplate.js","sourceRoot":"","sources":["../src/packTemplate.ts"],"names":[],"mappings":"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"}

package/dist/template.d.ts

@@ -0,0 +1,17 @@
+import { Schema } from "effect";
+export declare const Versions: Schema.$Record<Schema.String, Schema.String>;
+export declare const Template: Schema.$Array<Schema.Struct<{
+    readonly content: Schema.String;
+    readonly path: Schema.String;
+}>>;
+export type Template = typeof Template.Type;
+export declare const decodeTemplate: (input: unknown, options?: import("effect/SchemaAST").ParseOptions) => readonly {
+    readonly content: string;
+    readonly path: string;
+}[];
+export declare function registryDependencies(dependencies: Readonly<Record<string, string>>, versions: Readonly<Record<string, string>>): {
+    [k: string]: string;
+};
+export declare function prepareManifest(source: string, versions: Readonly<Record<string, string>>): string;
+export declare function prepareFile(path: string, content: string, versions: Readonly<Record<string, string>>): string;
+//# sourceMappingURL=template.d.ts.map

package/dist/template.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"template.d.ts","sourceRoot":"","sources":["../src/template.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAGhC,eAAO,MAAM,QAAQ,8CAA8C,CAAC;AACpE,eAAO,MAAM,QAAQ;;;GAA+E,CAAC;AACrG,MAAM,MAAM,QAAQ,GAAG,OAAO,QAAQ,CAAC,IAAI,CAAC;AAC5C,eAAO,MAAM,cAAc;;;GAA4D,CAAC;AAexF,wBAAgB,oBAAoB,CAAC,YAAY,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,EAAE,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;;EAa9H;AAED,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,UAazF;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,UAWpG"}

package/dist/template.js

@@ -0,0 +1,53 @@
+import { Schema } from "effect";
+import { CreateAppError } from "./CreateAppError.js";
+export const Versions = Schema.Record(Schema.String, Schema.String);
+export const Template = Schema.Array(Schema.Struct({ content: Schema.String, path: Schema.String }));
+export const decodeTemplate = Schema.decodeUnknownSync(Schema.fromJsonString(Template));
+const Manifest = Schema.Struct({
+    dependencies: Versions,
+    devDependencies: Versions,
+    engines: Versions,
+    imports: Versions,
+    name: Schema.String,
+    packageManager: Schema.String,
+    private: Schema.Boolean,
+    scripts: Versions,
+    type: Schema.String,
+    version: Schema.String,
+});
+const decodeManifest = Schema.decodeUnknownSync(Schema.fromJsonString(Manifest), { propertyOrder: "original" });
+export function registryDependencies(dependencies, versions) {
+    return Object.fromEntries(Object.entries(dependencies).map(([name, version]) => {
+        if (!version.startsWith("workspace:")) {
+            return [name, version];
+        }
+        const published = versions[name];
+        if (published === undefined || !/^\d+\.\d+\.\d+(?:-[\w.-]+)?$/u.test(published)) {
+            throw new CreateAppError({ message: `${name}: name an exact published version in published-versions.json` });
+        }
+        return [name, published];
+    }));
+}
+export function prepareManifest(source, versions) {
+    const manifest = decodeManifest(source);
+    const { "check:published": _check, ...scripts } = manifest.scripts;
+    return `${JSON.stringify({
+        ...manifest,
+        dependencies: registryDependencies(manifest.dependencies, versions),
+        devDependencies: registryDependencies(manifest.devDependencies, versions),
+        scripts: Object.fromEntries(Object.entries(scripts).map(([name, script]) => [name, script.replaceAll("--conditions=source ", "")])),
+    }, null, "\t")}\n`;
+}
+export function prepareFile(path, content, versions) {
+    if (path === "package.json") {
+        return prepareManifest(content, versions);
+    }
+    if (path === "biome.json") {
+        return content.replace('"root": false', '"root": true');
+    }
+    if (["tsconfig.json", "vite.config.ts", "vitest.config.ts"].includes(path)) {
+        return content.replaceAll('"source", ', "").replaceAll('["source"]', "[]");
+    }
+    return content;
+}
+//# sourceMappingURL=template.js.map

package/dist/template.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"template.js","sourceRoot":"","sources":["../src/template.ts"],"names":[],"mappings":"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"}

package/docs/north-star.md

@@ -0,0 +1,7 @@
+# One command to a running app
+
+New applications should start with the same small, working example that Platform maintains and tests. A newcomer should not need to understand workspace dependency protocols or repository-specific configuration before seeing their application run.
+
+The command writes only into an absent or empty folder, names the application, installs its dependencies and prints the environment and development steps. The starter owns the application's files and its published-version manifest; packaging takes a snapshot of that source. Generated files are package artifacts, never a second checked-in template.
+
+Preserving existing user files takes precedence over convenience. Real generated-app checks against npm and PostgreSQL take precedence over fast scaffolding tests. Keep the interface to the folder argument and normal CLI help and version output. Application choices, environment secrets, deployment and releases belong to the application and maintainer.

package/docs/roadmap.md

@@ -0,0 +1,16 @@
+# Roadmap
+
+## Built
+
+- A folder argument creates and installs the starter with exact published Platform versions.
+- Packing snapshots `examples/starter` without local dependencies, build output, lockfiles or environment secrets.
+- Existing nonempty folders are refused before any write or install.
+- The published-starter check runs the packed command's output through typecheck, build and PostgreSQL/authenticated HTTP tests.
+
+## Next
+
+- The maintainer selects and authorizes the first release beyond the npm placeholder.
+
+## Open questions
+
+No additional generator options are selected.

package/package.json

@@ -1,6 +1,63 @@
 {
   "name": "@shivaedev/create-app",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.1.0",
+  "description": "Create and install a Platform application from the maintained starter",
+  "homepage": "https://github.com/ShivaeDev/platform/tree/main/packages/create-app#readme",
+  "bugs": {
+    "url": "https://github.com/ShivaeDev/platform/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ShivaeDev/platform.git",
+    "directory": "packages/create-app"
+  },
+  "license": "MIT",
+  "sideEffects": false,
+  "type": "module",
+  "imports": {
+    "#*.ts": {
+      "source": "./src/*.ts",
+      "types": "./dist/*.d.ts",
+      "default": "./dist/*.js"
+    },
+    "#test/*": "./src/test-support/*"
+  },
+  "exports": {
+    "./package.json": "./package.json"
+  },
+  "bin": {
+    "create-app": "./dist/cli.js"
+  },
+  "files": [
+    "dist",
+    "src",
+    "!src/**/*.test.ts",
+    "!src/**/test-support",
+    "template.json",
+    "docs",
+    "CHANGELOG.md",
+    "README.md"
+  ],
+  "devDependencies": {
+    "@effect/platform-node": "4.0.0-rc.112",
+    "@effect/platform-node-shared": "4.0.0-rc.112",
+    "@shivaedev/quality": "0.19.0",
+    "@types/node": "24.19.1",
+    "effect": "4.0.0-rc.112",
+    "esbuild": "0.28.2",
+    "typescript": "npm:@typescript/typescript6@6.0.2",
+    "vitest": "4.1.11"
+  },
+  "engines": {
+    "node": ">=24"
+  },
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
+  "scripts": {
+    "build": "node --eval \"import('node:fs').then(({ rmSync }) => rmSync('dist', { force: true, recursive: true }))\" && tsc --project tsconfig.build.json && esbuild src/cli.ts --bundle --platform=node --format=esm --conditions=source --target=node24 --minify --outfile=dist/cli.js && node --eval \"import('node:fs').then(({ rmSync }) => rmSync('dist/cli.js.map', { force: true }))\"",
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit"
+  }
 }

package/src/CreateAppError.ts

@@ -0,0 +1,5 @@
+import { Data, Runtime } from "effect";
+
+export class CreateAppError extends Data.TaggedError("CreateAppError")<{ readonly message: string }> {
+	override readonly [Runtime.errorReported] = false;
+}

package/src/cli.ts

@@ -0,0 +1,23 @@
+#!/usr/bin/env node
+import { fileURLToPath } from "node:url";
+import * as NodeRuntime from "@effect/platform-node/NodeRuntime";
+import * as NodeServices from "@effect/platform-node/NodeServices";
+import { Console, Effect, FileSystem, Schema } from "effect";
+import { Argument, Command } from "effect/unstable/cli";
+import { createApp } from "./createApp.ts";
+
+const program = Effect.gen(function* () {
+	const fs = yield* FileSystem.FileSystem;
+	const manifest = yield* fs.readFileString(fileURLToPath(new URL("../package.json", import.meta.url)));
+	const { version } = yield* Schema.decodeUnknownEffect(Schema.fromJsonString(Schema.Struct({ version: Schema.String })))(manifest);
+	const cli = Command.make("create-app", { folder: Argument.string("folder") }, ({ folder }) =>
+		createApp(folder, fileURLToPath(new URL("../template.json", import.meta.url))),
+	).pipe(Command.withDescription("Create and install a Platform application from the maintained starter."));
+	yield* Command.run(cli, { version });
+});
+
+program.pipe(
+	Effect.tapErrorTag("CreateAppError", (error) => Console.error(`create-app: ${error.message}`)),
+	Effect.provide(NodeServices.layer),
+	NodeRuntime.runMain,
+);

package/src/createApp.ts

@@ -0,0 +1,41 @@
+import { Buffer } from "node:buffer";
+import { basename, dirname, join, resolve } from "node:path";
+import { Console, Effect, FileSystem, Schema } from "effect";
+import { ChildProcess, ChildProcessSpawner } from "effect/unstable/process";
+import { CreateAppError } from "./CreateAppError.ts";
+import { Template } from "./template.ts";
+
+const decodeName = Schema.decodeUnknownEffect(Schema.fromJsonString(Schema.Record(Schema.String, Schema.Unknown)));
+
+export const createApp = Effect.fn("CreateApp.createApp")(function* (folder: string, templatePath: string) {
+	const fs = yield* FileSystem.FileSystem;
+	const target = resolve(folder);
+	const name = basename(target);
+	if (!/^[a-z0-9][a-z0-9._-]*$/u.test(name) || name.length > 214 || ["node_modules", "favicon.ico"].includes(name)) {
+		return yield* new CreateAppError({ message: "The final folder name must be a lowercase npm package name." });
+	}
+	if ((yield* fs.exists(target)) && ((yield* fs.stat(target)).type !== "Directory" || (yield* fs.readDirectory(target)).length > 0)) {
+		return yield* new CreateAppError({ message: `Refusing to write into ${folder}: the destination must be an empty folder.` });
+	}
+	const template = yield* Schema.decodeUnknownEffect(Schema.fromJsonString(Template))(yield* fs.readFileString(templatePath));
+	yield* fs.makeDirectory(target, { recursive: true });
+	for (const entry of template) {
+		const path = join(target, entry.path);
+		let content = Buffer.from(entry.content, "base64");
+		if (entry.path === "package.json") {
+			const manifest = yield* decodeName(content.toString());
+			content = Buffer.from(`${JSON.stringify({ ...manifest, name }, null, "\t")}\n`);
+		}
+		yield* fs.makeDirectory(dirname(path), { recursive: true });
+		yield* fs.writeFile(path, content);
+	}
+	const spawner = yield* ChildProcessSpawner.ChildProcessSpawner;
+	const code = yield* spawner.exitCode(ChildProcess.make("pnpm", ["install"], { cwd: target, stderr: "inherit", stdout: "inherit" }));
+	if (code !== 0) {
+		return yield* new CreateAppError({ message: `pnpm install failed (exit ${code}). Run pnpm install in ${folder} to retry.` });
+	}
+	const quotedFolder = `'${folder.replaceAll("'", "'\"'\"'")}'`;
+	yield* Console.log(
+		`Created ${folder}.\n\nNext steps:\n  cd ${quotedFolder}\n  cp .env.example .env.local\n  Set DATABASE_URL to your PostgreSQL database.\n  Set BETTER_AUTH_SECRET to a random secret of at least 32 characters.\n  pnpm dev`,
+	);
+});

package/src/pack.ts

@@ -0,0 +1,11 @@
+import { fileURLToPath } from "node:url";
+import { NodeRuntime, NodeServices } from "@effect/platform-node";
+import { Effect } from "effect";
+import { packTemplate } from "./packTemplate.ts";
+
+NodeRuntime.runMain(
+	packTemplate(
+		fileURLToPath(new URL("../../../examples/starter", import.meta.url)),
+		fileURLToPath(new URL("../template.json", import.meta.url)),
+	).pipe(Effect.provide(NodeServices.layer)),
+);

package/src/packTemplate.ts

@@ -0,0 +1,42 @@
+import { Buffer } from "node:buffer";
+import { basename, join } from "node:path";
+import { Effect, FileSystem, type PlatformError, Schema } from "effect";
+import { CreateAppError } from "./CreateAppError.ts";
+import { prepareFile, type Template, Versions } from "./template.ts";
+
+const excluded = new Set(["node_modules", "dist", "coverage", "pnpm-lock.yaml", ".git"]);
+function included(path: string) {
+	return !excluded.has(basename(path)) && (!basename(path).startsWith(".env") || basename(path) === ".env.example");
+}
+
+export const packTemplate = Effect.fn("CreateApp.packTemplate")(function* (starter: string, output: string) {
+	const fs = yield* FileSystem.FileSystem;
+	const versions = yield* Schema.decodeUnknownEffect(Schema.fromJsonString(Versions))(
+		yield* fs.readFileString(join(starter, "published-versions.json")),
+	);
+	const entries: Template[number][] = [];
+	const visit = Effect.fn("CreateApp.visit")(function* (directory: string): Effect.fn.Return<void, PlatformError.PlatformError | CreateAppError> {
+		for (const name of (yield* fs.readDirectory(join(starter, directory))).sort()) {
+			const path = join(directory, name);
+			if (!included(path)) {
+				continue;
+			}
+			if ((yield* fs.stat(join(starter, path))).type === "Directory") {
+				yield* visit(path);
+			} else {
+				const target = path === "pnpm-workspace.copy.yaml" ? "pnpm-workspace.yaml" : path;
+				const source = Buffer.from(yield* fs.readFile(join(starter, path)));
+				const content = yield* Effect.try({
+					catch: (cause) => new CreateAppError({ message: String(cause) }),
+					try: () =>
+						["biome.json", "package.json", "tsconfig.json", "vite.config.ts", "vitest.config.ts"].includes(path)
+							? Buffer.from(prepareFile(path, source.toString(), versions))
+							: source,
+				});
+				entries.push({ content: content.toString("base64"), path: target });
+			}
+		}
+	});
+	yield* visit("");
+	yield* fs.writeFileString(output, `${JSON.stringify(entries)}\n`);
+});

package/src/template.ts

@@ -0,0 +1,63 @@
+import { Schema } from "effect";
+import { CreateAppError } from "./CreateAppError.ts";
+
+export const Versions = Schema.Record(Schema.String, Schema.String);
+export const Template = Schema.Array(Schema.Struct({ content: Schema.String, path: Schema.String }));
+export type Template = typeof Template.Type;
+export const decodeTemplate = Schema.decodeUnknownSync(Schema.fromJsonString(Template));
+const Manifest = Schema.Struct({
+	dependencies: Versions,
+	devDependencies: Versions,
+	engines: Versions,
+	imports: Versions,
+	name: Schema.String,
+	packageManager: Schema.String,
+	private: Schema.Boolean,
+	scripts: Versions,
+	type: Schema.String,
+	version: Schema.String,
+});
+const decodeManifest = Schema.decodeUnknownSync(Schema.fromJsonString(Manifest), { propertyOrder: "original" });
+
+export function registryDependencies(dependencies: Readonly<Record<string, string>>, versions: Readonly<Record<string, string>>) {
+	return Object.fromEntries(
+		Object.entries(dependencies).map(([name, version]) => {
+			if (!version.startsWith("workspace:")) {
+				return [name, version];
+			}
+			const published = versions[name];
+			if (published === undefined || !/^\d+\.\d+\.\d+(?:-[\w.-]+)?$/u.test(published)) {
+				throw new CreateAppError({ message: `${name}: name an exact published version in published-versions.json` });
+			}
+			return [name, published];
+		}),
+	);
+}
+
+export function prepareManifest(source: string, versions: Readonly<Record<string, string>>) {
+	const manifest = decodeManifest(source);
+	const { "check:published": _check, ...scripts } = manifest.scripts;
+	return `${JSON.stringify(
+		{
+			...manifest,
+			dependencies: registryDependencies(manifest.dependencies, versions),
+			devDependencies: registryDependencies(manifest.devDependencies, versions),
+			scripts: Object.fromEntries(Object.entries(scripts).map(([name, script]) => [name, script.replaceAll("--conditions=source ", "")])),
+		},
+		null,
+		"\t",
+	)}\n`;
+}
+
+export function prepareFile(path: string, content: string, versions: Readonly<Record<string, string>>) {
+	if (path === "package.json") {
+		return prepareManifest(content, versions);
+	}
+	if (path === "biome.json") {
+		return content.replace('"root": false', '"root": true');
+	}
+	if (["tsconfig.json", "vite.config.ts", "vitest.config.ts"].includes(path)) {
+		return content.replaceAll('"source", ', "").replaceAll('["source"]', "[]");
+	}
+	return content;
+}