@debuffjp/cli 0.0.0-stage → 0.1.0

package/package.json

@@ -1,6 +1,65 @@
 {
   "name": "@debuffjp/cli",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.0",
+  "description": "The debuff CLI: dev server, builds with size reports, assets, scenarios",
+  "keywords": [
+    "game",
+    "cli",
+    "vite",
+    "gamedev",
+    "debuff"
+  ],
+  "license": "MIT",
+  "homepage": "https://debuff.jp",
+  "bugs": "https://github.com/debuffjp/debuff/issues",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/debuffjp/debuff.git",
+    "directory": "tooling/cli"
+  },
+  "type": "module",
+  "bin": {
+    "debuff": "bin/debuff.js"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./schema/scenario.schema.json": "./schema/scenario.schema.json",
+    "./client": {
+      "types": "./client.d.ts"
+    }
+  },
+  "files": [
+    "bin",
+    "dist",
+    "schema",
+    "README.md",
+    "client.d.ts"
+  ],
+  "scripts": {
+    "build": "tsc -b"
+  },
+  "dependencies": {
+    "@clack/prompts": "^1.8.1",
+    "cac": "^7.1.0",
+    "create-debuff": "0.1.0",
+    "fast-png": "^8.0.0",
+    "picocolors": "^1.1.1",
+    "playwright-core": "^1.64.1",
+    "vite": "^8.3.4"
+  },
+  "devDependencies": {
+    "@types/node": "^24.0.0"
+  },
+  "engines": {
+    "node": ">=22"
+  },
+  "publishConfig": {
+    "access": "public",
+    "provenance": false
+  }
+}

package/schema/scenario.schema.json

@@ -0,0 +1,111 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://raw.githubusercontent.com/debuffjp/debuff/main/tooling/cli/schema/scenario.schema.json",
+  "title": "debuff scenario",
+  "description": "Deterministic gameplay scenario run by `debuff scenario`. Time only advances through `wait` steps.",
+  "type": "object",
+  "required": ["steps"],
+  "additionalProperties": false,
+  "properties": {
+    "$schema": { "type": "string" },
+    "name": { "type": "string", "description": "Defaults to the file name." },
+    "page": { "type": "string", "description": "Path to open on the dev server.", "default": "/" },
+    "steps": { "type": "array", "items": { "$ref": "#/$defs/step" } }
+  },
+  "$defs": {
+    "point": { "type": "array", "prefixItems": [{ "type": "number" }, { "type": "number" }], "minItems": 2, "maxItems": 2 },
+    "comparison": {
+      "type": "object",
+      "description": "All given conditions must hold.",
+      "additionalProperties": false,
+      "properties": {
+        "eq": { "description": "Deep equality." },
+        "gt": { "type": "number" },
+        "gte": { "type": "number" },
+        "lt": { "type": "number" },
+        "lte": { "type": "number" },
+        "approx": { "$ref": "#/$defs/point", "description": "[target, tolerance]" }
+      }
+    },
+    "step": {
+      "oneOf": [
+        {
+          "type": "object",
+          "required": ["wait"],
+          "additionalProperties": false,
+          "properties": { "wait": { "type": "integer", "minimum": 0, "description": "Advance N fixed simulation steps." } }
+        },
+        {
+          "type": "object",
+          "required": ["press"],
+          "additionalProperties": false,
+          "properties": { "press": { "type": "string", "description": "KeyboardEvent.code to hold, e.g. \"Space\"." } }
+        },
+        { "type": "object", "required": ["release"], "additionalProperties": false, "properties": { "release": { "type": "string" } } },
+        {
+          "type": "object",
+          "required": ["tap"],
+          "additionalProperties": false,
+          "properties": { "tap": { "$ref": "#/$defs/point", "description": "Logical [x, y]." } }
+        },
+        {
+          "type": "object",
+          "required": ["pointerDown"],
+          "additionalProperties": false,
+          "properties": { "pointerDown": { "$ref": "#/$defs/point" } }
+        },
+        {
+          "type": "object",
+          "required": ["pointerMove"],
+          "additionalProperties": false,
+          "properties": { "pointerMove": { "$ref": "#/$defs/point" } }
+        },
+        { "type": "object", "required": ["pointerUp"], "additionalProperties": false, "properties": { "pointerUp": { "const": true } } },
+        {
+          "type": "object",
+          "required": ["set"],
+          "additionalProperties": false,
+          "properties": {
+            "set": {
+              "type": "object",
+              "description": "Params to set, keyed \"group.key\".",
+              "propertyNames": { "pattern": "^[^.]+\\..+$" },
+              "additionalProperties": { "type": ["number", "boolean"] }
+            }
+          }
+        },
+        {
+          "type": "object",
+          "required": ["expect"],
+          "additionalProperties": false,
+          "properties": {
+            "expect": {
+              "type": "object",
+              "description": "Dotted paths into dev state (scene, tick, time, frozen, stats.*, state.*).",
+              "additionalProperties": { "$ref": "#/$defs/comparison" }
+            }
+          }
+        },
+        {
+          "type": "object",
+          "required": ["capture"],
+          "additionalProperties": false,
+          "properties": {
+            "capture": {
+              "type": "string",
+              "pattern": "^[\\w-]+$",
+              "description": "Screenshot name, compared to the per-platform baseline."
+            },
+            "tolerance": {
+              "type": "number",
+              "minimum": 0,
+              "maximum": 1,
+              "default": 0.002,
+              "description": "Max fraction of differing pixels."
+            }
+          }
+        }
+      ]
+    }
+  }
+}