create-octane-xplat 0.9.0 → 0.11.0

package/README.md

@@ -16,8 +16,21 @@ With Node.js and pnpm 11.24.0 installed:
 pnpm create octane-xplat my-app
 ```
 
+The creator asks which platforms to target — web, iOS, and Android are all
+pre-selected. Pass `--targets` to skip the prompt:
+
+```sh
+pnpm create octane-xplat my-app --targets web          # web only
+pnpm create octane-xplat my-app --targets web,android  # web + Android
+```
+
+Platforms skipped here can be enabled later with `pnpm xplat add <platform>`
+inside the app. (Non-interactive runs without `--targets` scaffold all
+three.)
+
 The creator copies the template, installs dependencies with pnpm, and starts
-the web dev server. Open the printed URL and open `my-app` in your agent.
+the web dev server when the web target is included. Open the printed URL and
+open `my-app` in your agent.
 Ask it to read `AGENTS.md` and `.agents/skills/xplat/SKILL.md`, then build a
 packing checklist with add, pack, and remove actions using in-memory state.
 Check the result before asking for the next feature: add “Passport” and
@@ -38,13 +51,15 @@ cd my-app
 pnpm dev            # web
 ```
 
-From that directory, these commands run other targets or check the app:
+From that directory, these commands run other targets or check the app — the
+`dev:*`/`build:*` entries exist only for platforms chosen at create time
+(`pnpm xplat add` adds the rest later):
 
 ```sh
 pnpm dev:ios        # needs macOS, Xcode, and NativeScript setup
 pnpm dev:android    # needs Android SDK, compatible JDK, and NativeScript setup
 pnpm lint
-pnpm typecheck      # web + native tsconfigs
+pnpm typecheck      # every enabled tsconfig
 pnpm build          # web production bundle
 ```
 

package/index.mjs

@@ -1,11 +1,34 @@
 #!/usr/bin/env node
-import { existsSync, readdirSync, cpSync, renameSync } from 'node:fs'
-import { dirname, join, resolve } from 'node:path'
-import { fileURLToPath } from 'node:url'
+import { existsSync, readdirSync } from 'node:fs'
+import { resolve } from 'node:path'
 import { spawnSync } from 'node:child_process'
+import {
+	composeTargets,
+	defaultTargets,
+	resolveTargets,
+	selectableTargets,
+	targets,
+} from './scaffold.mjs'
 
-const positional = process.argv.slice(2).filter((arg) => !arg.startsWith('-'))
-const noInstall = process.argv.includes('--no-install')
+const argv = process.argv.slice(2)
+const noInstall = argv.includes('--no-install')
+const targetsIndex = argv.findIndex((arg) => arg === '--targets' || arg.startsWith('--targets='))
+const targetsValueIndex =
+	targetsIndex !== -1 && argv[targetsIndex] === '--targets' ? targetsIndex + 1 : -1
+
+const targetsArg =
+	targetsIndex === -1
+		? undefined
+		: targetsValueIndex !== -1
+			? argv[targetsValueIndex]
+			: argv[targetsIndex].slice('--targets='.length)
+
+if (targetsIndex !== -1 && (targetsArg === undefined || targetsArg.startsWith('-'))) {
+	console.error(`✗ --targets needs a comma list: ${selectableTargets.join(', ')}`)
+	process.exit(1)
+}
+
+const positional = argv.filter((arg, i) => !arg.startsWith('-') && i !== targetsValueIndex)
 const dir = resolve(positional[0] ?? 'octane-xplat-app')
 
 if (existsSync(dir) && readdirSync(dir).length > 0) {
@@ -13,27 +36,94 @@ if (existsSync(dir) && readdirSync(dir).length > 0) {
 	process.exit(1)
 }
 
-const template = join(dirname(fileURLToPath(import.meta.url)), 'template')
-cpSync(template, dir, { recursive: true })
-// npm packs .gitignore as a renamed file or drops it — ship it undotted.
-try {
-	renameSync(join(dir, 'gitignore'), join(dir, '.gitignore'))
-} catch {}
+const parseTargets = (value) => {
+	const ids = value
+		.split(',')
+		.map((s) => s.trim())
+		.filter(Boolean)
+
+	if (ids.length === 0) {
+		throw new Error(`--targets needs a comma list: ${selectableTargets.join(', ')}`)
+	}
+
+	for (const id of ids) {
+		if (!selectableTargets.includes(id)) {
+			throw new Error(
+				`unknown target "${id}" — expected a comma list of: ${selectableTargets.join(', ')}`,
+			)
+		}
+	}
+
+	return resolveTargets(ids)
+}
 
-console.log(`\n✓ scaffolded ${dir}`)
+let ids
+if (targetsArg !== undefined) {
+	try {
+		ids = parseTargets(targetsArg)
+	} catch (error) {
+		console.error(`✗ ${error.message}`)
+		process.exit(1)
+	}
+} else if (process.stdout.isTTY) {
+	// Lazy: the extracted tarball has no installed deps — only the interactive
+	// path needs @clack/prompts (verify-consumer runs the bin dep-free).
+	const p = await import('@clack/prompts')
+	p.intro('create-octane-xplat')
+	const picked = await p.multiselect({
+		message: 'Target platforms',
+		options: selectableTargets.map((id) => ({
+			value: id,
+			label: targets[id].label,
+			hint: targets[id].note,
+		})),
+		initialValues: [...defaultTargets],
+		required: true,
+	})
+
+	if (p.isCancel(picked)) {
+		p.cancel('Cancelled')
+		process.exit(0)
+	}
+
+	ids = picked
+} else {
+	ids = defaultTargets
+}
+
+composeTargets(ids, dir)
+
+console.log(
+	`\n✓ scaffolded ${dir} (${[...new Set(resolveTargets(ids))].filter((id) => !targets[id].hidden).join(', ')})`,
+)
 
 if (noInstall) {
 	console.log('\nSkipped install (--no-install). To run manually:')
-	console.log(`  cd ${dir}\n  pnpm install\n  pnpm dev`)
+	printNextSteps(dir, ids)
 	process.exit(0)
 }
 
 const install = spawnSync('pnpm', ['install'], { cwd: dir, stdio: 'inherit' })
 if (install.status !== 0) {
 	console.log(`\nInstall didn't finish (pnpm missing?). To run manually:`)
-	console.log(`  cd ${dir}\n  pnpm install\n  pnpm dev`)
+	printNextSteps(dir, ids)
 	process.exit(install.status ?? 1)
 }
 
-console.log('\n✓ installed — starting dev server (Ctrl+C to stop)\n')
-spawnSync('pnpm', ['dev'], { cwd: dir, stdio: 'inherit' })
+if (ids.includes('web')) {
+	console.log('\n✓ installed — starting dev server (Ctrl+C to stop)\n')
+	spawnSync('pnpm', ['dev'], { cwd: dir, stdio: 'inherit' })
+} else {
+	console.log('\n✓ installed. To run:')
+	printNextSteps(dir, ids)
+}
+
+function printNextSteps(dir, ids) {
+	console.log(`  cd ${dir}\n  pnpm install`)
+	if (ids.includes('web')) {
+		console.log('  pnpm dev')
+	} else {
+		// No web entry — `xplat dev` discovers whichever native targets exist.
+		console.log('  pnpm xplat dev')
+	}
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-octane-xplat",
-  "version": "0.9.0",
+  "version": "0.11.0",
   "description": "Scaffold a minimal @octane-xplat/ui app — one Octane codebase for web + iOS + Android",
   "keywords": [
     "create",
@@ -24,10 +24,17 @@
   },
   "files": [
     "index.mjs",
+    "scaffold.mjs",
     "template"
   ],
   "type": "module",
+  "exports": {
+    "./scaffold": "./scaffold.mjs"
+  },
   "publishConfig": {
     "access": "public"
+  },
+  "dependencies": {
+    "@clack/prompts": "1.8.1"
   }
 }