spinup-ts 0.1.0

package/README.md

@@ -0,0 +1,82 @@
+# spinup-ts
+
+Scaffold a production-ready TypeScript project with opinionated tooling — the TypeScript sibling of [spinup-py](https://github.com/joeblackwaslike/spinup-py) and the TypeScript equivalent of [cookiecutter-uv](https://github.com/joeblackwaslike/cookiecutter-uv).
+
+`spinup-ts` ⇄ `spinup-py` share the same CLI schema, so remembering one gives you the other.
+
+## Usage
+
+```bash
+# New project (interactive)
+npx spinup-ts my-project
+# or: pnpm dlx spinup-ts my-project
+# or: bunx spinup-ts my-project
+
+# New project (defaults only, no prompts)
+npx spinup-ts my-project --non-interactive
+
+# Retrofit an existing repo with template tooling
+npx spinup-ts update .
+```
+
+Install globally if you scaffold often:
+
+```bash
+npm i -g spinup-ts
+spinup-ts my-project
+```
+
+## CLI
+
+```text
+spinup-ts [new] <project-name>     Scaffold a new TypeScript project
+spinup-ts update [dir]             Retrofit an existing repo with template tooling
+spinup-ts --update [dir]           Alias for `update`
+
+  -y, --yes, --non-interactive     Scaffold with defaults only, no prompts (needs <project-name>)
+  -v, --version                    Print version
+  -h, --help                       Show this help
+```
+
+Non-interactive defaults resolve from `~/.spinup-tsrc.json`, then local `git config`
+(author name/email), then built-in fallbacks.
+
+## What's Included
+
+| Python (cookiecutter-uv) | TypeScript equivalent |
+|---|---|
+| `uv` | `pnpm` |
+| `ruff` | `Biome` |
+| `wemake-python-styleguide` | ESLint strict (unicorn + sonarjs + import-x) |
+| `mypy --strict` | `tsc --noEmit` + `@typescript-eslint/strictTypeChecked` |
+| `pytest` + `coverage` | `Vitest` + `@vitest/coverage-v8` |
+| `mkdocs-material` | `Docusaurus` |
+| `deptry` | `depcheck` |
+| `pre-commit` | `Husky` + `lint-staged` + `commitlint` |
+| `Makefile` | `justfile` |
+| `tox` (multi-version) | CI matrix over Node 20/22 |
+| `release-please` | `release-please` (`release-type: node`) |
+
+## Prompt Options
+
+- **Project name** — kebab-case slug
+- **Description** — one-liner
+- **Author / Email / GitHub handle**
+- **Node version** — 20, 22, 23
+- **Package manager** — pnpm (default), bun, npm
+- **Project type** — library, cli, server, mcp-server
+- **GitHub Actions** — CI + release workflows
+- **Publish to npm** — with provenance
+- **Docusaurus docs** — deployed to GitHub Pages on release
+- **Codecov** — coverage reporting
+- **Dockerfile** — multi-stage Node build
+- **Devcontainer** — full Claude Code-optimized environment
+- **License** — MIT, Apache 2.0, BSD, ISC, GPL-3, None
+
+## Development
+
+```bash
+pnpm install
+pnpm build
+pnpm test
+```

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -0,0 +1,96 @@
+#!/usr/bin/env node
+import { createRequire } from 'node:module';
+import path from 'node:path';
+import * as clack from '@clack/prompts';
+// eslint-disable-next-line import-x/no-unresolved
+import { buildDefaultConfig, runPrompts } from './prompts.js';
+// eslint-disable-next-line import-x/no-unresolved
+import { checkDestinationDir, scaffold } from './scaffold.js';
+// eslint-disable-next-line import-x/no-unresolved
+import { updateProject } from './update.js';
+const require = createRequire(import.meta.url);
+const packageJson = require('../package.json');
+const HELP_TEXT = `spinup-ts — scaffold a production-ready TypeScript project (sibling of spinup-py)
+
+Usage:
+  spinup-ts [new] <project-name>     Scaffold a new TypeScript project
+  spinup-ts update [dir]             Retrofit an existing repo with template tooling
+  spinup-ts --update [dir]           Alias for \`update\`
+
+Options:
+  -y, --yes, --non-interactive       Scaffold with defaults only, no prompts (needs <project-name>)
+  -v, --version                      Print version
+  -h, --help                         Show this help
+
+Examples:
+  spinup-ts my-lib
+  spinup-ts new my-lib
+  spinup-ts my-lib --non-interactive
+  spinup-ts update .
+  spinup-ts --update /path/to/repo
+`;
+function parseArgs(argv) {
+    const help = argv.includes('--help') || argv.includes('-h');
+    const version = argv.includes('--version') || argv.includes('-v');
+    const nonInteractive = argv.includes('--non-interactive') || argv.includes('--yes') || argv.includes('-y');
+    const updateFlag = argv.includes('--update') || argv.includes('-u');
+    const positionals = argv.filter((a) => !a.startsWith('-'));
+    // Subcommand form: `new <name>` / `update [dir]`
+    if (positionals[0] === 'new') {
+        return { command: 'new', name: positionals[1], nonInteractive, help, version };
+    }
+    if (positionals[0] === 'update') {
+        return { command: 'update', dir: positionals[1], nonInteractive, help, version };
+    }
+    // Flag form: `--update [dir]`
+    if (updateFlag) {
+        return { command: 'update', dir: positionals[0], nonInteractive, help, version };
+    }
+    // Bare form: `spinup-ts <name>`
+    return { command: 'new', name: positionals[0], nonInteractive, help, version };
+}
+async function runCreate(projectName, nonInteractive) {
+    const destDir = path.resolve(projectName ?? '.');
+    await checkDestinationDir(destDir);
+    let config;
+    if (nonInteractive) {
+        if (!projectName) {
+            throw new Error('A project name is required in non-interactive mode: spinup-ts <name> --yes');
+        }
+        config = await buildDefaultConfig(projectName);
+    }
+    else {
+        config = await runPrompts(projectName);
+    }
+    await scaffold(destDir, config);
+    clack.outro(`Project created at ${destDir}`);
+}
+async function runUpdate(targetDir) {
+    await updateProject(path.resolve(targetDir));
+}
+async function main() {
+    const args = parseArgs(process.argv.slice(2));
+    if (args.help) {
+        process.stdout.write(HELP_TEXT);
+        return;
+    }
+    if (args.version) {
+        process.stdout.write(`${packageJson.version}\n`);
+        return;
+    }
+    if (args.command === 'update') {
+        await runUpdate(args.dir ?? '.');
+        return;
+    }
+    await runCreate(args.name, args.nonInteractive);
+}
+await main().catch((error) => {
+    if (error instanceof Error) {
+        clack.log.error(error.message);
+    }
+    else {
+        clack.log.error(String(error));
+    }
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/prompts.d.ts

@@ -0,0 +1,17 @@
+import { type ProjectConfig } from './types.js';
+/**
+ * Run the full interactive prompt flow and return a validated {@link ProjectConfig}.
+ *
+ * @param projectName - Optional name from CLI args; when provided, the name prompt is skipped.
+ */
+export declare function runPrompts(projectName?: string): Promise<ProjectConfig>;
+/**
+ * Build a {@link ProjectConfig} from defaults only, with no interactive prompts.
+ *
+ * Resolution order for each field: `~/.spinup-tsrc.json` → local `git config` (author
+ * name/email) → built-in fallback. Mirrors spinup-py's `--non-interactive` / `--yes` mode.
+ *
+ * @param projectName - kebab-case project name (required; validated here).
+ */
+export declare function buildDefaultConfig(projectName: string): Promise<ProjectConfig>;
+//# sourceMappingURL=prompts.d.ts.map

package/dist/prompts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompts.d.ts","sourceRoot":"","sources":["../src/prompts.ts"],"names":[],"mappings":"AAQA,OAAO,EACL,KAAK,aAAa,EAKnB,MAAM,YAAY,CAAC;AA4FpB;;;;GAIG;AAEH,wBAAsB,UAAU,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CA8K7E;AAED;;;;;;;GAOG;AACH,wBAAsB,kBAAkB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CA8BpF"}

package/dist/prompts.js

@@ -0,0 +1,264 @@
+import { exec } from 'node:child_process';
+import { readFile } from 'node:fs/promises';
+import { homedir } from 'node:os';
+import path from 'node:path';
+import { promisify } from 'node:util';
+import * as clack from '@clack/prompts';
+/* eslint-disable import-x/no-unresolved */
+import { deriveSlug, projectConfigSchema, userDefaultsSchema, } from './types.js';
+/* eslint-enable import-x/no-unresolved */
+const execAsync = promisify(exec);
+const RC_PATH = path.join(homedir(), '.spinup-tsrc.json');
+async function loadUserDefaults() {
+    try {
+        const raw = await readFile(RC_PATH, 'utf8');
+        const result = userDefaultsSchema.safeParse(JSON.parse(raw));
+        return result.success ? result.data : {};
+    }
+    catch {
+        return {};
+    }
+}
+/** Read a single `git config` value, returning undefined if unset or git is unavailable. */
+async function gitConfigValue(key) {
+    try {
+        const { stdout } = await execAsync(`git config --get ${key}`);
+        return stdout.trim() || undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+/** kebab-case identifier: starts with a letter, then letters/digits/hyphens. */
+const KEBAB_CASE = /^[a-z][a-z0-9-]*$/;
+/** Lightweight RFC 5322-ish email check; full validation happens in Zod. */
+// eslint-disable-next-line sonarjs/slow-regex
+const EMAIL_RE = /^[^\s@]+@[^\s@]+\.[^\s@]+$/;
+/**
+ * Narrow a clack prompt result, exiting cleanly if the user cancelled.
+ * Returns the value typed as `T` on success.
+ */
+function unwrap(value) {
+    if (clack.isCancel(value)) {
+        clack.cancel('Operation cancelled.');
+        process.exit(0);
+    }
+    return value;
+}
+/** Validator for the project name text prompt. */
+function validateProjectName(value) {
+    if (!value)
+        return 'Project name is required';
+    if (!KEBAB_CASE.test(value)) {
+        return 'Use kebab-case: lowercase letters, numbers, hyphens; start with a letter';
+    }
+    return undefined;
+}
+/** Validator for the author email text prompt. */
+function validateEmail(value) {
+    if (!value)
+        return 'Email is required';
+    if (!EMAIL_RE.test(value))
+        return 'Enter a valid email address';
+    return undefined;
+}
+/** Prompt for the project name, or return the provided CLI arg if valid. */
+async function promptProjectName(provided) {
+    if (provided !== undefined) {
+        const err = validateProjectName(provided);
+        if (err) {
+            clack.cancel(`Invalid project name "${provided}": ${err}`);
+            process.exit(1);
+        }
+        return provided;
+    }
+    const value = await clack.text({
+        message: 'Project name?',
+        placeholder: 'my-awesome-lib',
+        validate: validateProjectName,
+    });
+    return unwrap(value);
+}
+/** Build the human-readable feature summary line. */
+function summarizeFeatures(config) {
+    const features = [];
+    if (config.includeGithubActions)
+        features.push('GitHub Actions');
+    if (config.publishToNpm)
+        features.push('npm publish');
+    if (config.includeDocs)
+        features.push('Docusaurus docs');
+    if (config.includeCodecov)
+        features.push('Codecov');
+    if (config.includeDockerfile)
+        features.push('Dockerfile');
+    if (config.includeDevcontainer)
+        features.push('devcontainer');
+    features.push(`${config.license} license`);
+    return features.join(', ');
+}
+/**
+ * Run the full interactive prompt flow and return a validated {@link ProjectConfig}.
+ *
+ * @param projectName - Optional name from CLI args; when provided, the name prompt is skipped.
+ */
+// eslint-disable-next-line max-lines-per-function, max-statements
+export async function runPrompts(projectName) {
+    clack.intro('spinup-ts');
+    const d = await loadUserDefaults();
+    const name = await promptProjectName(projectName);
+    const description = unwrap(await clack.text({
+        message: 'Short description?',
+        placeholder: 'A delightful TypeScript project',
+    }));
+    const author = unwrap(await clack.text({
+        message: 'Author name?',
+        ...(d.author !== undefined && { initialValue: d.author }),
+        validate: (v) => (v ? undefined : 'Author name is required'),
+    }));
+    const email = unwrap(await clack.text({
+        message: 'Author email?',
+        ...(d.email !== undefined && { initialValue: d.email }),
+        validate: validateEmail,
+    }));
+    const githubHandle = unwrap(await clack.text({
+        message: 'GitHub handle?',
+        placeholder: 'octocat',
+        ...(d.githubHandle !== undefined && { initialValue: d.githubHandle }),
+        validate: (v) => (v ? undefined : 'GitHub handle is required'),
+    }));
+    const nodeVersion = unwrap(await clack.select({
+        message: 'Node version?',
+        initialValue: d.nodeVersion ?? '22',
+        options: [
+            { value: '20', label: '20' },
+            { value: '22', label: '22', hint: 'LTS ✓' },
+            { value: '23', label: '23' },
+        ],
+    }));
+    const packageManager = unwrap(await clack.select({
+        message: 'Package manager?',
+        initialValue: d.packageManager ?? 'pnpm',
+        options: [
+            { value: 'pnpm', label: 'pnpm', hint: 'recommended' },
+            { value: 'bun', label: 'bun' },
+            { value: 'npm', label: 'npm' },
+        ],
+    }));
+    const projectType = unwrap(await clack.select({
+        message: 'Project type?',
+        initialValue: d.projectType ?? 'library',
+        options: [
+            { value: 'library', label: 'library' },
+            { value: 'cli', label: 'cli' },
+            { value: 'server', label: 'server' },
+            { value: 'mcp-server', label: 'mcp-server' },
+        ],
+    }));
+    const includeGithubActions = unwrap(await clack.confirm({
+        message: 'Include GitHub Actions?',
+        initialValue: d.includeGithubActions ?? true,
+    }));
+    const publishToNpm = unwrap(await clack.confirm({
+        message: 'Publish to npm?',
+        initialValue: d.publishToNpm ?? false,
+    }));
+    const includeDocumentation = unwrap(await clack.confirm({
+        message: 'Include Docusaurus docs?',
+        initialValue: d.includeDocs ?? false,
+    }));
+    const includeCodecov = unwrap(await clack.confirm({
+        message: 'Include Codecov?',
+        initialValue: d.includeCodecov ?? false,
+    }));
+    const includeDockerfile = unwrap(await clack.confirm({
+        message: 'Include Dockerfile?',
+        initialValue: d.includeDockerfile ?? false,
+    }));
+    const includeDevcontainer = unwrap(await clack.confirm({
+        message: 'Include devcontainer?',
+        initialValue: d.includeDevcontainer ?? true,
+    }));
+    const license = unwrap(await clack.select({
+        message: 'License?',
+        initialValue: d.license ?? 'MIT',
+        options: [
+            { value: 'MIT', label: 'MIT' },
+            { value: 'Apache-2.0', label: 'Apache-2.0' },
+            { value: 'BSD-3-Clause', label: 'BSD-3-Clause' },
+            { value: 'ISC', label: 'ISC' },
+            { value: 'GPL-3.0', label: 'GPL-3.0' },
+            { value: 'UNLICENSED', label: 'Unlicensed' },
+        ],
+    }));
+    const config = projectConfigSchema.parse({
+        projectName: name,
+        projectSlug: deriveSlug(name),
+        description,
+        author,
+        email,
+        githubHandle,
+        nodeVersion,
+        packageManager,
+        projectType,
+        includeGithubActions,
+        publishToNpm,
+        includeDocs: includeDocumentation,
+        includeCodecov,
+        includeDockerfile,
+        includeDevcontainer,
+        license,
+    });
+    clack.note([
+        `Project: ${config.projectName}`,
+        `Type: ${config.projectType}  ·  Node: ${config.nodeVersion}  ·  PM: ${config.packageManager}`,
+        `Features: ${summarizeFeatures(config)}`,
+    ].join('\n'), 'Summary');
+    const proceed = unwrap(await clack.confirm({
+        message: 'Create project with these settings?',
+        initialValue: true,
+    }));
+    if (!proceed) {
+        clack.cancel('Operation cancelled.');
+        process.exit(0);
+    }
+    return config;
+}
+/**
+ * Build a {@link ProjectConfig} from defaults only, with no interactive prompts.
+ *
+ * Resolution order for each field: `~/.spinup-tsrc.json` → local `git config` (author
+ * name/email) → built-in fallback. Mirrors spinup-py's `--non-interactive` / `--yes` mode.
+ *
+ * @param projectName - kebab-case project name (required; validated here).
+ */
+export async function buildDefaultConfig(projectName) {
+    const nameError = validateProjectName(projectName);
+    if (nameError) {
+        throw new Error(`Invalid project name "${projectName}": ${nameError}`);
+    }
+    const d = await loadUserDefaults();
+    const [gitName, gitEmail] = await Promise.all([
+        gitConfigValue('user.name'),
+        gitConfigValue('user.email'),
+    ]);
+    return projectConfigSchema.parse({
+        projectName,
+        projectSlug: deriveSlug(projectName),
+        description: '',
+        author: d.author ?? gitName ?? 'Your Name',
+        email: d.email ?? gitEmail ?? 'you@example.com',
+        githubHandle: d.githubHandle ?? 'your-handle',
+        nodeVersion: d.nodeVersion ?? '22',
+        packageManager: d.packageManager ?? 'pnpm',
+        projectType: d.projectType ?? 'library',
+        includeGithubActions: d.includeGithubActions ?? true,
+        publishToNpm: d.publishToNpm ?? false,
+        includeDocs: d.includeDocs ?? false,
+        includeCodecov: d.includeCodecov ?? false,
+        includeDockerfile: d.includeDockerfile ?? false,
+        includeDevcontainer: d.includeDevcontainer ?? true,
+        license: d.license ?? 'MIT',
+    });
+}
+//# sourceMappingURL=prompts.js.map

package/dist/prompts.js.map

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

package/dist/scaffold.d.ts

@@ -0,0 +1,5 @@
+import { type ProjectConfig, type TokenMap } from './types.js';
+export declare function checkDestinationDir(destDir: string): Promise<void>;
+export declare function replaceTokensInTree(destDir: string, tokens: TokenMap): Promise<void>;
+export declare function scaffold(destDir: string, config: ProjectConfig): Promise<void>;
+//# sourceMappingURL=scaffold.d.ts.map

package/dist/scaffold.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scaffold.d.ts","sourceRoot":"","sources":["../src/scaffold.ts"],"names":[],"mappings":"AAYA,OAAO,EAAE,KAAK,aAAa,EAAE,KAAK,QAAQ,EAAc,MAAM,YAAY,CAAC;AAoB3E,wBAAsB,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAUxE;AA+BD,wBAAsB,mBAAmB,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAkB1F;AAsCD,wBAAsB,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAkBpF"}

package/dist/scaffold.js

@@ -0,0 +1,128 @@
+import { exec } from 'node:child_process';
+import { mkdir, readFile, readdir, writeFile } from 'node:fs/promises';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { promisify } from 'node:util';
+import degit from 'degit';
+import fse from 'fs-extra';
+import { globby } from 'globby';
+import pc from 'picocolors';
+// eslint-disable-next-line import-x/no-unresolved
+import { applyTransforms } from './transforms/index.js';
+// eslint-disable-next-line import-x/no-unresolved
+import { toTokenMap } from './types.js';
+const execAsync = promisify(exec);
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+const DEGIT_SOURCE = 'joeblackwaslike/spinup-ts/template';
+const INSTALL_COMMANDS = {
+    pnpm: 'pnpm install',
+    bun: 'bun install',
+    npm: 'npm install',
+};
+const logStep = (message) => {
+    // biome-ignore lint/suspicious/noConsole: intentional CLI output
+    console.log(`  ${pc.green('✓')} ${message}`);
+};
+const isDevelopmentMode = () => process.env.NODE_ENV === 'development' || process.env.__DEV_TEMPLATE_PATH__ !== undefined;
+export async function checkDestinationDir(destDir) {
+    try {
+        const entries = await readdir(destDir);
+        if (entries.length > 0) {
+            throw new Error(`Directory ${destDir} already exists and is not empty.`);
+        }
+    }
+    catch (error) {
+        if (error.code === 'ENOENT')
+            return;
+        throw error;
+    }
+}
+async function cloneTemplate(destDir) {
+    if (isDevelopmentMode()) {
+        const override = process.env.__DEV_TEMPLATE_PATH__;
+        const localPath = override ?? path.resolve(__dirname, '..', 'template');
+        await fse.copy(localPath, destDir);
+        return;
+    }
+    const emitter = degit(DEGIT_SOURCE, { cache: false, force: true, verbose: false });
+    await emitter.clone(destDir);
+}
+const BINARY_SAMPLE_SIZE = 8000;
+function isBinaryBuffer(buffer) {
+    const sampleSize = Math.min(buffer.length, BINARY_SAMPLE_SIZE);
+    for (let index = 0; index < sampleSize; index++) {
+        if (buffer[index] === 0)
+            return true;
+    }
+    return false;
+}
+function replaceTokens(content, tokens) {
+    let result = content;
+    for (const [token, value] of Object.entries(tokens)) {
+        result = result.replaceAll(token, value);
+    }
+    return result;
+}
+export async function replaceTokensInTree(destDir, tokens) {
+    const files = await globby('**/*', {
+        cwd: destDir,
+        dot: true,
+        gitignore: false,
+        onlyFiles: true,
+        ignore: ['node_modules/**', '.git/**'],
+    });
+    await Promise.all(files.map(async (relativePath) => {
+        const filePath = path.join(destDir, relativePath);
+        const buffer = await readFile(filePath);
+        if (isBinaryBuffer(buffer))
+            return;
+        const original = buffer.toString('utf8');
+        const replaced = replaceTokens(original, tokens);
+        if (replaced !== original)
+            await writeFile(filePath, replaced, 'utf8');
+    }));
+}
+async function initGit(destDir) {
+    await execAsync('git init', { cwd: destDir });
+    await execAsync('git add -A', { cwd: destDir });
+    // Inline identity so the initial commit never depends on the user's global
+    // git config (keeps scaffolding deterministic in CI and fresh environments).
+    await execAsync('git -c user.name="spinup-ts" -c user.email="spinup-ts@users.noreply.github.com" commit -m "chore: initial scaffold from spinup-ts"', { cwd: destDir });
+}
+async function installDependencies(destDir, packageManager) {
+    await execAsync(INSTALL_COMMANDS[packageManager], { cwd: destDir });
+}
+async function initializeProjectTools(destDir, config) {
+    try {
+        await execAsync('bd init --skip-agents --non-interactive', { cwd: destDir });
+        logStep('Initialized Beads task manager');
+    }
+    catch {
+        // bd not installed; skip silently
+    }
+    const serenaDir = path.join(destDir, '.serena');
+    await mkdir(serenaDir, { recursive: true });
+    await writeFile(path.join(serenaDir, 'project.yml'), `project_name: ${config.projectSlug}\nlanguages:\n  - typescript\n`, 'utf8');
+    logStep('Initialized Serena project config');
+}
+export async function scaffold(destDir, config) {
+    await cloneTemplate(destDir);
+    logStep('Cloning template...');
+    await replaceTokensInTree(destDir, toTokenMap(config));
+    logStep('Replacing tokens...');
+    await applyTransforms(destDir, config);
+    logStep('Applying transforms...');
+    await initGit(destDir);
+    logStep('Initializing git...');
+    // SPINUP_TS_SKIP_INSTALL=1 skips the (heavy, network-bound) dependency install
+    // for the generated project — used by the packaged-binary smoke test in CI.
+    if (process.env.SPINUP_TS_SKIP_INSTALL === '1') {
+        logStep('Skipping dependency install (SPINUP_TS_SKIP_INSTALL=1)');
+    }
+    else {
+        await installDependencies(destDir, config.packageManager);
+        logStep('Installing dependencies...');
+    }
+    await initializeProjectTools(destDir, config);
+}
+//# sourceMappingURL=scaffold.js.map

package/dist/scaffold.js.map

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

package/dist/transforms/devcontainer.d.ts

@@ -0,0 +1,3 @@
+import type { ProjectConfig } from '../types.js';
+export declare function transformDevcontainer(destDir: string, config: ProjectConfig): Promise<void>;
+//# sourceMappingURL=devcontainer.d.ts.map

package/dist/transforms/devcontainer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"devcontainer.d.ts","sourceRoot":"","sources":["../../src/transforms/devcontainer.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEjD,wBAAsB,qBAAqB,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAIjG"}

package/dist/transforms/devcontainer.js

@@ -0,0 +1,8 @@
+import path from 'node:path';
+import fse from 'fs-extra';
+export async function transformDevcontainer(destDir, config) {
+    if (config.includeDevcontainer)
+        return;
+    await fse.remove(path.join(destDir, '.devcontainer'));
+}
+//# sourceMappingURL=devcontainer.js.map