@runa-cmd/create 0.0.0-stage → 0.2.0-beta.6

package/CHANGELOG.md

@@ -0,0 +1,9 @@
+# @runa-cmd/create
+
+## 0.2.0-beta.6
+
+## 0.2.0-beta.5
+
+### Minor Changes
+
+- ba3be24: New package: `npm create @runa-cmd@beta my-tool` creates a CLI ready to run, test and build. It makes the project of the getting started guide, named after yours, and installs nothing on its own.

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Runa CLI Contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,28 @@
-# Temporary Holding Version
+# @runa-cmd/create
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Create a CLI made with [Runa](https://github.com/jrodrigopuca/runa-cmd), ready to run, test and publish.
+
+```bash
+npm create @runa-cmd@beta my-tool
+cd my-tool
+npm install
+node src/main.ts hello Ana
+```
+
+Until Runa reaches 1.0, add `@beta`, as above.
+
+It works with pnpm, yarn and bun too, as `pnpm create @runa-cmd@beta my-tool`, and the next steps it prints use the one you ran it with.
+
+## What you get
+
+| File | What it is |
+|---|---|
+| `src/cli.ts` | Your commands. It exports the CLI without starting it, so tests can import it |
+| `src/main.ts` | Starts the CLI. It's the program that gets installed |
+| `src/cli.test.ts` | Tests with `testCLI()`, run by `node --test` |
+| `tsconfig.json` | Runs your TypeScript as it is while you develop, and builds `dist/` to ship |
+| `package.json` | `bin` named after your project, and `build` to compile |
+
+The name is used for the folder, the package and the command people type, so it takes lowercase letters, numbers and dashes. It won't write into a folder that already has files, and it installs nothing: you choose the package manager and when.
+
+These are the files of the [getting started guide](https://github.com/jrodrigopuca/runa-cmd/blob/main/guides/getting-started.md), which explains each of them. Its code runs in CI, so what this creates works.

package/dist/create.d.ts

@@ -0,0 +1,21 @@
+/** Something the person can fix: a name, or a folder that's taken. */
+export declare class CreateError extends Error {
+    constructor(message: string);
+}
+export interface CreateOptions {
+    /** The project, its folder, its package and the program it installs */
+    name: string;
+    /** Where the folder goes */
+    cwd: string;
+    /** A copy of examples/getting-started */
+    templateDir: string;
+    /** The @runa-cmd/core the project depends on */
+    runaVersion: string;
+}
+/** Create the project, or explain why not before writing anything. */
+export declare function createProject(options: CreateOptions): {
+    dir: string;
+};
+/** What to run next, with the package manager that ran the generator. */
+export declare function nextSteps(name: string, userAgent: string | undefined): string;
+//# sourceMappingURL=create.d.ts.map

package/dist/create.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create.d.ts","sourceRoot":"","sources":["../src/create.ts"],"names":[],"mappings":"AAUA,sEAAsE;AACtE,qBAAa,WAAY,SAAQ,KAAK;IACrC,YAAY,OAAO,EAAE,MAAM,EAG1B;CACD;AAED,MAAM,WAAW,aAAa;IAC7B,uEAAuE;IACvE,IAAI,EAAE,MAAM,CAAC;IACb,4BAA4B;IAC5B,GAAG,EAAE,MAAM,CAAC;IACZ,yCAAyC;IACzC,WAAW,EAAE,MAAM,CAAC;IACpB,gDAAgD;IAChD,WAAW,EAAE,MAAM,CAAC;CACpB;AAkDD,sEAAsE;AACtE,wBAAgB,aAAa,CAAC,OAAO,EAAE,aAAa,GAAG;IAAE,GAAG,EAAE,MAAM,CAAA;CAAE,CA0BrE;AAED,yEAAyE;AACzE,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAiB7E"}

package/dist/create.js

@@ -0,0 +1,97 @@
+/**
+ * @runa-cmd/create — Make a new CLI project (T-605)
+ *
+ * The template is the project of the getting started guide, so what this
+ * creates is what the guide teaches, and CI runs both. It installs nothing:
+ * which package manager to use, and when, is the person's call.
+ */
+import { existsSync, mkdirSync, readdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { join, resolve } from 'node:path';
+/** Something the person can fix: a name, or a folder that's taken. */
+export class CreateError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'CreateError';
+    }
+}
+/** A name that works as a folder, an npm package and a command a person types. */
+const PROJECT_NAME = /^[a-z0-9]+(-[a-z0-9]+)*$/;
+/** The files copied as they are: they're the code the guide shows. */
+const COPIED = ['tsconfig.json', 'src/cli.ts', 'src/main.ts', 'src/cli.test.ts'];
+const GITIGNORE = 'node_modules/\ndist/\n';
+function readme(name) {
+    return `# ${name}
+
+A CLI made with [Runa](https://github.com/jrodrigopuca/runa-cmd).
+
+\`\`\`bash
+node src/main.ts hello Ana   # Run it
+node --test src/cli.test.ts  # Test it
+npm run build                # Build dist/, which is what gets installed
+npm install -g .             # Install it as ${name}
+\`\`\`
+
+The commands are in \`src/cli.ts\`. The [getting started guide](https://github.com/jrodrigopuca/runa-cmd/blob/main/guides/getting-started.md) explains every file.
+`;
+}
+function packageJson(templateDir, name, runaVersion) {
+    const template = JSON.parse(readFileSync(join(templateDir, 'package.json'), 'utf8'));
+    const pkg = {
+        name,
+        // The one src/cli.ts prints with --version, so they start equal
+        version: template.version,
+        description: '',
+        type: template.type,
+        bin: { [name]: 'dist/main.js' },
+        files: template.files,
+        scripts: template.scripts,
+        dependencies: { '@runa-cmd/core': `^${runaVersion}`, zod: template.dependencies.zod },
+        devDependencies: template.devDependencies,
+        engines: template.engines,
+    };
+    return `${JSON.stringify(pkg, null, '\t')}\n`;
+}
+function named(cli, name) {
+    const marker = "name: 'greet'";
+    if (!cli.includes(marker))
+        throw new Error(`The template lost ${marker}: update the generator.`);
+    return cli.replace(marker, `name: '${name}'`);
+}
+/** Create the project, or explain why not before writing anything. */
+export function createProject(options) {
+    const { name, cwd, templateDir, runaVersion } = options;
+    if (!PROJECT_NAME.test(name)) {
+        throw new CreateError(`'${name}' can't be the name: use lowercase letters, numbers and dashes, as in 'my-tool'. It's also what people type to run it.`);
+    }
+    const dir = resolve(cwd, name);
+    if (existsSync(dir) && readdirSync(dir).length > 0) {
+        throw new CreateError(`The folder '${name}' already has files. Pick another name, or empty it.`);
+    }
+    mkdirSync(join(dir, 'src'), { recursive: true });
+    for (const file of COPIED) {
+        const content = readFileSync(join(templateDir, file), 'utf8');
+        writeFileSync(join(dir, file), file === 'src/cli.ts' ? named(content, name) : content);
+    }
+    writeFileSync(join(dir, 'package.json'), packageJson(templateDir, name, runaVersion));
+    writeFileSync(join(dir, '.gitignore'), GITIGNORE);
+    writeFileSync(join(dir, 'README.md'), readme(name));
+    return { dir };
+}
+/** What to run next, with the package manager that ran the generator. */
+export function nextSteps(name, userAgent) {
+    const manager = ['pnpm', 'yarn', 'bun'].find((tool) => userAgent?.startsWith(`${tool}/`)) ?? 'npm';
+    const build = `${manager === 'npm' ? 'npm run' : manager} build`;
+    const test = 'node --test src/cli.test.ts';
+    const width = Math.max(build.length, test.length) + 2;
+    return `
+Created ${name}. Next:
+
+  cd ${name}
+  ${manager} install
+  node src/main.ts hello Ana
+
+  ${test.padEnd(width)}# Test it
+  ${build.padEnd(width)}# Build it before installing or publishing
+`;
+}
+//# sourceMappingURL=create.js.map

package/dist/create.js.map

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

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,68 @@
+#!/usr/bin/env node
+/**
+ * @runa-cmd/create — `npm create @runa-cmd my-tool`
+ *
+ * No dependencies, Runa included: `npm create` downloads this every time, and
+ * it should take a moment, not Zod.
+ */
+import { readFileSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { parseArgs } from 'node:util';
+import { CreateError, createProject, nextSteps } from './create.js';
+const root = join(dirname(fileURLToPath(import.meta.url)), '..');
+const templateDir = join(root, 'template');
+const readJson = (path) => JSON.parse(readFileSync(path, 'utf8'));
+const { version } = readJson(join(root, 'package.json'));
+// The core this was built with, which isn't always this package's version
+const runaVersion = readJson(join(templateDir, 'runa.json')).core;
+const USAGE = `Create a CLI made with Runa.
+
+Usage: npm create @runa-cmd <name>
+
+  <name>          The folder, the package and the command, as in my-tool
+  -h, --help      Show this
+  -v, --version   Show the version`;
+function main() {
+    let parsed;
+    try {
+        parsed = parseArgs({
+            allowPositionals: true,
+            options: {
+                help: { type: 'boolean', short: 'h' },
+                version: { type: 'boolean', short: 'v' },
+            },
+        });
+    }
+    catch (error) {
+        console.error(`${error.message}\n\n${USAGE}`);
+        return 2;
+    }
+    const { values, positionals } = parsed;
+    if (values.help) {
+        console.log(USAGE);
+        return 0;
+    }
+    if (values.version) {
+        console.log(version);
+        return 0;
+    }
+    const [name, ...extra] = positionals;
+    if (!name || extra.length > 0) {
+        console.error(USAGE);
+        return 2;
+    }
+    try {
+        createProject({ name, cwd: process.cwd(), templateDir, runaVersion });
+    }
+    catch (error) {
+        if (!(error instanceof CreateError))
+            throw error;
+        console.error(error.message);
+        return 2;
+    }
+    console.log(nextSteps(name, process.env.npm_config_user_agent));
+    return 0;
+}
+process.exitCode = main();
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA;;;;;GAKG;AACH,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAEpE,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;AACjE,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;AAC3C,MAAM,QAAQ,GAAG,CAAC,IAAY,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC;AAC1E,MAAM,EAAE,OAAO,EAAE,GAAG,QAAQ,CAAC,IAAI,CAAC,IAAI,EAAE,cAAc,CAAC,CAAC,CAAC;AACzD,0EAA0E;AAC1E,MAAM,WAAW,GAAW,QAAQ,CAAC,IAAI,CAAC,WAAW,EAAE,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC;AAE1E,MAAM,KAAK,GAAG;;;;;;mCAMqB,CAAC;AAEpC,SAAS,IAAI;IACZ,IAAI,MAAoC,CAAC;IACzC,IAAI,CAAC;QACJ,MAAM,GAAG,SAAS,CAAC;YAClB,gBAAgB,EAAE,IAAI;YACtB,OAAO,EAAE;gBACR,IAAI,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,GAAG,EAAE;gBACrC,OAAO,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,GAAG,EAAE;aACxC;SACD,CAAC,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QAChB,OAAO,CAAC,KAAK,CAAC,GAAI,KAAe,CAAC,OAAO,OAAO,KAAK,EAAE,CAAC,CAAC;QACzD,OAAO,CAAC,CAAC;IACV,CAAC;IAED,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,GAAG,MAAM,CAAC;IACvC,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC;QACjB,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QACnB,OAAO,CAAC,CAAC;IACV,CAAC;IACD,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QACrB,OAAO,CAAC,CAAC;IACV,CAAC;IAED,MAAM,CAAC,IAAI,EAAE,GAAG,KAAK,CAAC,GAAG,WAAW,CAAC;IACrC,IAAI,CAAC,IAAI,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC/B,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QACrB,OAAO,CAAC,CAAC;IACV,CAAC;IAED,IAAI,CAAC;QACJ,aAAa,CAAC,EAAE,IAAI,EAAE,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE,EAAE,WAAW,EAAE,WAAW,EAAE,CAAC,CAAC;IACvE,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QAChB,IAAI,CAAC,CAAC,KAAK,YAAY,WAAW,CAAC;YAAE,MAAM,KAAK,CAAC;QACjD,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAC7B,OAAO,CAAC,CAAC;IACV,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,EAAE,OAAO,CAAC,GAAG,CAAC,qBAAqB,CAAC,CAAC,CAAC;IAChE,OAAO,CAAC,CAAC;AACV,CAAC;AAED,OAAO,CAAC,QAAQ,GAAG,IAAI,EAAE,CAAC"}

package/package.json

@@ -1,6 +1,51 @@
 {
   "name": "@runa-cmd/create",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.2.0-beta.6",
+  "description": "Create a CLI made with Runa: npm create @runa-cmd my-tool",
+  "license": "MIT",
+  "type": "module",
+  "keywords": [
+    "cli",
+    "create",
+    "scaffold",
+    "template",
+    "runa"
+  ],
+  "bin": {
+    "create": "./dist/index.js"
+  },
+  "engines": {
+    "node": ">=24.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/jrodrigopuca/runa-cmd.git",
+    "directory": "packages/create"
+  },
+  "homepage": "https://github.com/jrodrigopuca/runa-cmd/tree/main/packages/create#readme",
+  "bugs": {
+    "url": "https://github.com/jrodrigopuca/runa-cmd/issues"
+  },
+  "files": [
+    "dist",
+    "template",
+    "README.md",
+    "CHANGELOG.md"
+  ],
+  "devDependencies": {
+    "@types/node": "^24.19.2",
+    "typescript": "^7.0.2",
+    "zod": "^4.6.7",
+    "@runa-cmd/core": "0.2.0-beta.6"
+  },
+  "scripts": {
+    "build": "tsc && node scripts/copy-template.mjs",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run --dir src",
+    "lint": "biome check .",
+    "clean": "rm -rf dist template"
+  }
 }

package/template/package.json

@@ -0,0 +1,30 @@
+{
+	"name": "greet-cli",
+	"version": "1.0.0",
+	"private": true,
+	"description": "The project of guides/getting-started.md",
+	"type": "module",
+	"bin": {
+		"greet": "dist/main.js"
+	},
+	"files": [
+		"dist"
+	],
+	"scripts": {
+		"start": "node src/main.ts",
+		"test": "node --test src/cli.test.ts",
+		"build": "tsc",
+		"typecheck": "tsc --noEmit"
+	},
+	"dependencies": {
+		"@runa-cmd/core": "workspace:*",
+		"zod": "^4.6.7"
+	},
+	"devDependencies": {
+		"@types/node": "^24.19.2",
+		"typescript": "^7.0.2"
+	},
+	"engines": {
+		"node": ">=24.0.0"
+	}
+}

package/template/runa.json

@@ -0,0 +1 @@
+{"core":"0.2.0-beta.6"}

package/template/src/cli.test.ts

@@ -0,0 +1,21 @@
+import assert from 'node:assert/strict';
+import { test } from 'node:test';
+import { testCLI } from '@runa-cmd/core/testing';
+import { cli } from './cli.ts';
+
+test('greets someone', async () => {
+	const result = await testCLI(cli, ['hello', 'Ana']);
+	assert.equal(result.code, 0);
+	assert.equal(result.stdout, 'Hello, Ana!\n');
+});
+
+test('shouts with --shout', async () => {
+	const result = await testCLI(cli, ['hello', 'Ana', '--shout']);
+	assert.equal(result.stdout, 'HELLO, ANA!\n');
+});
+
+test('needs a name', async () => {
+	const result = await testCLI(cli, ['hello']);
+	assert.equal(result.code, 2);
+	assert.match(result.stderr, /<name>/);
+});

package/template/src/cli.ts

@@ -0,0 +1,17 @@
+import { defineCLI, defineCommand } from '@runa-cmd/core';
+import { z } from '@runa-cmd/core/zod';
+
+const hello = defineCommand({
+	meta: { description: 'Say hello to someone' },
+	args: { name: z.string().describe('Who to greet') },
+	options: { shout: z.boolean().default(false).describe('Use capital letters') },
+	run: ({ args, options }) => {
+		const text = `Hello, ${args.name}!`;
+		return options.shout ? text.toUpperCase() : text;
+	},
+});
+
+export const cli = defineCLI({
+	meta: { name: 'greet', version: '1.0.0', description: 'Greet people' },
+	commands: { hello },
+});

package/template/src/main.ts

@@ -0,0 +1,4 @@
+#!/usr/bin/env node
+import { cli } from './cli.ts';
+
+await cli.run();

package/template/tsconfig.json

@@ -0,0 +1,16 @@
+{
+	"compilerOptions": {
+		"target": "es2024",
+		"module": "nodenext",
+		"strict": true,
+		"outDir": "dist",
+		"rootDir": "src",
+		"rewriteRelativeImportExtensions": true,
+		"erasableSyntaxOnly": true,
+		"verbatimModuleSyntax": true,
+		"skipLibCheck": true,
+		"types": ["node"]
+	},
+	"include": ["src"],
+	"exclude": ["src/**/*.test.ts"]
+}