@toist/in 0.2.0 → 0.2.1

package/CHANGELOG.md

@@ -2,6 +2,17 @@
 
 All notable changes to `@toist/in` are recorded here.
 
+## 0.2.1 — 2026-05-05
+
+- Scaffold now writes `package.json` directly into the target directory
+  instead of printing a snippet to stdout for manual merge. The empty-dir
+  check that the scaffold already enforces means there's never an existing
+  `package.json` to collide with — writing it is unambiguously simpler and
+  removes a manual step. The template ships as `_package.json` (the leading
+  underscore dodges npm's publish-time stripping rules) and is renamed to
+  `package.json` at scaffold time.
+- Stdout is now a brief "next steps" block: `cd <path>; bun install; bun start.ts`.
+
 ## 0.2.0 — 2026-05-05
 
 Initial release. Scaffold CLI for new toist instances.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@toist/in",
-  "version": "0.2.0",
+  "version": "0.2.1",
   "type": "module",
   "description": "Scaffold a new toist instance: bunx @toist/in <path>",
   "main": "./src/index.ts",

package/src/scaffold.ts

@@ -1,25 +1,30 @@
 // 2121 toist
 // Scaffold logic for @toist/in. Recursively copies templates/default/* into
-// the target directory, with two special filename rules:
+// the target directory, with two `_`-prefixed filenames renamed at copy time:
 //
-//   - `_gitignore` -> `.gitignore` (npm strips real .gitignore files at publish
-//     time, so the templates ship them prefixed with an underscore)
-//   - `_package-snippet.json` is NOT copied — it is read and printed to stdout
-//     so the host can merge it into their existing package.json
+//   - `_gitignore`   -> `.gitignore`
+//   - `_package.json` -> `package.json`
+//
+// The underscore prefix exists because npm strips files like `.gitignore` and
+// (in some configurations) `package.json` from publishable subdirs. Prefixing
+// dodges those rules; the runtime rename produces the real names in the host.
 //
 // Templates live in `<package>/templates/default/`, relative to this file's
 // runtime location. Works whether the package is consumed as a workspace
 // link (in this repo) or from node_modules (in a host repo).
 
-import { mkdir, copyFile, readdir, stat, readFile } from "node:fs/promises"
+import { mkdir, copyFile, readdir, stat } from "node:fs/promises"
 import { existsSync } from "node:fs"
 import { dirname, join, resolve } from "node:path"
 import { fileURLToPath } from "node:url"
 
-const __dir         = dirname(fileURLToPath(import.meta.url))
-const TEMPLATE_DIR  = resolve(__dir, "..", "templates", "default")
-const SNIPPET_FILE  = "_package-snippet.json"
-const GITIGNORE_TPL = "_gitignore"
+const __dir        = dirname(fileURLToPath(import.meta.url))
+const TEMPLATE_DIR = resolve(__dir, "..", "templates", "default")
+
+const RENAMES: Record<string, string> = {
+  _gitignore:     ".gitignore",
+  "_package.json": "package.json",
+}
 
 export async function scaffold(target: string): Promise<void> {
   const dest = resolve(process.cwd(), target)
@@ -36,13 +41,8 @@ export async function scaffold(target: string): Promise<void> {
 
   await copyTree(TEMPLATE_DIR, dest)
 
-  const snippet = await readFile(join(TEMPLATE_DIR, SNIPPET_FILE), "utf8")
-
   console.log(`\nScaffolded toist instance at ${dest}\n`)
-  console.log(`Add to your package.json (or create one at ${target}/package.json):`)
-  console.log("")
-  console.log(snippet)
-  console.log("Then:")
+  console.log("Next:")
   console.log(`  cd ${target}`)
   console.log(`  bun install`)
   console.log(`  bun start.ts`)
@@ -53,9 +53,8 @@ export async function scaffold(target: string): Promise<void> {
 
 async function copyTree(src: string, dest: string): Promise<void> {
   for (const entry of await readdir(src)) {
-    if (entry === SNIPPET_FILE) continue   // printed, not copied
     const srcPath  = join(src, entry)
-    const destName = entry === GITIGNORE_TPL ? ".gitignore" : entry
+    const destName = RENAMES[entry] ?? entry
     const destPath = join(dest, destName)
     const info     = await stat(srcPath)
     if (info.isDirectory()) {

package/templates/default/README.md

@@ -4,9 +4,8 @@ Generated with [`bunx @toist/in`](https://toist.in).
 
 ## First run
 
-1. Add the suggested deps to your `package.json` (printed by the scaffold output).
-2. `bun install`
-3. `bun start.ts` — runner boots on `http://localhost:3000`.
+1. `bun install`
+2. `bun start.ts` — runner boots on `http://localhost:3000`.
 
 Open `http://localhost:3000` to use the UI.
 

package/templates/default/{_package-snippet.json → _package.json}

@@ -7,7 +7,7 @@
     "dev":   "bun --watch start.ts"
   },
   "dependencies": {
-    "@toist/run":  "^0.2.0",
-    "@toist/spec": "^0.2.0"
+    "@toist/run":  "^0.2.1",
+    "@toist/spec": "^0.2.1"
   }
 }