@arcane-engine/create 0.1.0

package/README.md

@@ -0,0 +1,80 @@
+# @arcane/create
+
+Scaffolding tool for creating new Arcane game projects.
+
+## Usage
+
+```bash
+npm create @arcane/game my-game
+cd my-game
+npm install
+arcane dev
+```
+
+This creates a new Arcane project with:
+- `package.json` with @arcane/runtime dependency
+- `tsconfig.json` for TypeScript
+- `src/game.ts` for pure game logic
+- `src/visual.ts` for rendering (entry point)
+- `README.md` with usage instructions
+
+## Prerequisites
+
+The Arcane CLI must be installed:
+
+```bash
+cargo install arcane-cli
+```
+
+Or build from source:
+
+```bash
+git clone https://github.com/anthropics/arcane.git
+cd arcane
+cargo build --release
+export PATH="$PATH:$(pwd)/target/release"
+```
+
+## What This Does
+
+`@arcane/create` is a thin wrapper around `arcane new <name>`. It's provided for npm ecosystem ergonomics:
+
+```bash
+# These are equivalent:
+npm create @arcane/game my-game
+arcane new my-game
+```
+
+## After Creation
+
+1. **Install dependencies:**
+   ```bash
+   cd my-game
+   npm install
+   ```
+
+2. **Run with hot-reload:**
+   ```bash
+   arcane dev
+   ```
+
+3. **Run tests:**
+   ```bash
+   arcane test
+   ```
+
+4. **Add recipes:**
+   ```bash
+   arcane add turn-based-combat
+   ```
+
+## Next Steps
+
+- [Getting Started Guide](https://github.com/anthropics/arcane/blob/main/docs/getting-started.md)
+- [Tutorials](https://github.com/anthropics/arcane/blob/main/docs/)
+- [API Reference](https://github.com/anthropics/arcane/blob/main/docs/api-reference.md)
+- [Examples](https://github.com/anthropics/arcane/tree/main/examples/)
+
+## License
+
+Apache 2.0 — see [LICENSE](../../LICENSE)

package/bin/create-arcane.js

@@ -0,0 +1,54 @@
+#!/usr/bin/env node
+
+/**
+ * @arcane/create — Project scaffolding tool
+ *
+ * Usage: npm create @arcane/game my-game
+ *
+ * This is a thin wrapper around `arcane new` command.
+ */
+
+import { spawn } from 'child_process';
+import { fileURLToPath } from 'url';
+import { dirname, join } from 'path';
+
+const args = process.argv.slice(2);
+const projectName = args[0];
+
+if (!projectName) {
+  console.error('Usage: npm create @arcane-engine/game <project-name>');
+  console.error('Example: npm create @arcane-engine/game my-game');
+  process.exit(1);
+}
+
+console.log(`Creating Arcane project "${projectName}"...`);
+
+// Check if arcane CLI is installed
+const arcane = spawn('arcane', ['new', projectName], {
+  stdio: 'inherit',
+  shell: true,
+});
+
+arcane.on('error', (err) => {
+  console.error('\n❌ Error: arcane CLI not found');
+  console.error('\nPlease install the Arcane CLI first:');
+  console.error('  cargo install arcane-cli');
+  console.error('\nOr build from source:');
+  console.error('  git clone https://github.com/anthropics/arcane.git');
+  console.error('  cd arcane');
+  console.error('  cargo build --release');
+  console.error('  export PATH="$PATH:$(pwd)/target/release"');
+  process.exit(1);
+});
+
+arcane.on('close', (code) => {
+  if (code === 0) {
+    console.log(`\n✓ Created Arcane project "${projectName}"`);
+    console.log('\nNext steps:');
+    console.log(`  cd ${projectName}`);
+    console.log('  npm install');
+    console.log('  arcane dev');
+  } else {
+    process.exit(code);
+  }
+});

package/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "@arcane-engine/create",
+  "version": "0.1.0",
+  "description": "Create a new Arcane game project",
+  "type": "module",
+  "bin": {
+    "create-arcane": "./bin/create-arcane.js"
+  },
+  "files": [
+    "bin",
+    "README.md"
+  ],
+  "keywords": [
+    "arcane",
+    "game-engine",
+    "2d",
+    "gamedev",
+    "scaffolding",
+    "create"
+  ],
+  "author": "Anthropic",
+  "license": "Apache-2.0",
+  "homepage": "https://github.com/anthropics/arcane",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/anthropics/arcane.git",
+    "directory": "packages/create"
+  },
+  "bugs": {
+    "url": "https://github.com/anthropics/arcane/issues"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "peerDependencies": {
+    "arcane-cli": "^0.1.0"
+  }
+}