From 86aea8e2dedceebe0beb1321c4dba87f7f389cdb Mon Sep 17 00:00:00 2001
From: Axel Meyer <axel.meyer@durania.net>
Date: Sat, 23 May 2026 13:38:02 +0200
Subject: [PATCH] Scaffold sporel-tool-mapper package

Empty Node 18+ CommonJS package with bin entry and node --test
script. Subcommand implementations follow in subsequent commits.
---
 .gitignore   |  3 +++
 README.md    | 16 ++++++++++++++++
 package.json | 16 ++++++++++++++++
 3 files changed, 35 insertions(+)
 create mode 100644 .gitignore
 create mode 100644 README.md
 create mode 100644 package.json

diff --git a/.gitignore b/.gitignore
new file mode 100644
index 0000000..aafcb34
--- /dev/null
+++ b/.gitignore
@@ -0,0 +1,3 @@
+node_modules/
+.DS_Store
+*.log
diff --git a/README.md b/README.md
new file mode 100644
index 0000000..734a39d
--- /dev/null
+++ b/README.md
@@ -0,0 +1,16 @@
+# sporel-tool-mapper
+
+Standalone CLI for v2 Sporel map files.
+
+## Status
+
+`v0.1.0` — initial scaffold. See `docs/superpowers/specs/2026-05-23-sporel-tool-mapper-design.md` in `sporel-meta` for the full spec.
+
+## Subcommands
+
+- `encode <atlas_idx> <tile_id> [rotation]`
+- `decode <gid>`
+- `build <spec.txt> <out.json> [--atlas-dir <path> ...]`
+- `inspect <map.json> [--atlas-dir <path> ...]`
+
+(Detailed usage and examples are added in Task 12.)
diff --git a/package.json b/package.json
new file mode 100644
index 0000000..73d924d
--- /dev/null
+++ b/package.json
@@ -0,0 +1,16 @@
+{
+  "name": "sporel-tool-mapper",
+  "version": "0.1.0",
+  "description": "CLI for v2 Sporel map files: encode/decode packed-u32 GIDs, build maps from a text DSL, inspect stats.",
+  "bin": {
+    "sporel-mapper": "bin/mapper.js"
+  },
+  "scripts": {
+    "test": "node --test tests/*.test.js"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "license": "UNLICENSED",
+  "private": true
+}