castle-web-cli 0.4.1 → 0.4.2

package/kits/rpg-2d/package.json

@@ -0,0 +1,46 @@
+{
+  "name": "rpg-2d",
+  "private": true,
+  "type": "module",
+  "scripts": {
+    "serve": "node ../../cli/dist/index.js serve . --open",
+    "restart": "node ../../cli/dist/index.js restart .",
+    "screenshot": "node ../../cli/dist/index.js screenshot .",
+    "check": "eslint . && jscpd && tsc --noEmit && node --input-type=module -e \"const { bundleProject } = await import('../../cli/dist/bundle.js'); await bundleProject('.');\""
+  },
+  "jscpd": {
+    "path": [
+      "engine",
+      "editors",
+      "behaviors"
+    ],
+    "threshold": 0,
+    "reporters": [
+      "consoleFull"
+    ]
+  },
+  "dependencies": {
+    "@codemirror/commands": "^6.10.3",
+    "@codemirror/lang-javascript": "^6.2.5",
+    "@codemirror/language": "^6.12.3",
+    "@codemirror/state": "^6.6.0",
+    "@codemirror/view": "^6.41.1",
+    "@fortawesome/free-solid-svg-icons": "^5.15.4",
+    "@lezer/highlight": "^1.2.3",
+    "castle-web-sdk": "file:../../sdk",
+    "codemirror": "^6.0.2",
+    "react": "^19.2.4",
+    "react-dom": "^19.2.4"
+  },
+  "devDependencies": {
+    "@types/node": "^25.6.0",
+    "@types/react": "^19.2.14",
+    "@types/react-dom": "^19.2.3",
+    "eslint": "^9.0.0",
+    "eslint-plugin-react-hooks": "^5.0.0",
+    "jscpd": "^4.0.5",
+    "prettier": "^3.8.3",
+    "typescript": "^6.0.3",
+    "typescript-eslint": "^8.0.0"
+  }
+}

package/kits/rpg-2d/scenes/main.scene

@@ -0,0 +1,203 @@
+{
+  "name": "Overworld",
+  "background": "#2d5a3d",
+  "actors": [
+    {
+      "id": "player",
+      "components": {
+        "Layout": { "x": 460, "y": 620, "width": 64, "height": 64, "z": 20, "rotation": 0 },
+        "Drawing": { "file": "drawings/player-idle-down.drawing" },
+        "Collider": { "kind": "solid", "width": 40, "height": 24, "offsetX": 12, "offsetY": 36 },
+        "PlayerController": { "speed": 200, "spritePrefix": "drawings/player", "interactRange": 36 }
+      }
+    },
+    {
+      "id": "camera",
+      "components": {
+        "Layout": { "x": 0, "y": 0, "width": 1, "height": 1, "z": 0, "rotation": 0 },
+        "Camera": { "target": "player", "followX": true, "followY": true, "roomWidth": 1024, "roomHeight": 1024 }
+      }
+    },
+    {
+      "id": "manager",
+      "components": {
+        "Layout": { "x": 0, "y": 0, "width": 1, "height": 1, "z": 100, "rotation": 0 },
+        "QuestLog": {
+          "chapter": "Chapter 1",
+          "steps": [
+            { "id": "find-juno", "title": "Find Juno", "hint": "She's near the fountain." },
+            { "id": "find-opal", "title": "Talk to Opal", "hint": "Look between the cottages." }
+          ],
+          "completedIds": []
+        },
+        "SaveMenu": { "storageKey": "rpg-2d-starter/save" }
+      }
+    },
+
+    {
+      "id": "house_blue",
+      "components": {
+        "Layout": { "x": 80, "y": 80, "width": 240, "height": 208, "z": 10, "rotation": 0 },
+        "Drawing": { "file": "drawings/env-house-blue.drawing" },
+        "Collider": { "kind": "solid", "width": 216, "height": 104, "offsetX": 12, "offsetY": 96 }
+      }
+    },
+    {
+      "id": "house_green",
+      "components": {
+        "Layout": { "x": 700, "y": 100, "width": 240, "height": 208, "z": 10, "rotation": 0 },
+        "Drawing": { "file": "drawings/env-house-green.drawing" },
+        "Collider": { "kind": "solid", "width": 216, "height": 104, "offsetX": 12, "offsetY": 96 }
+      }
+    },
+    {
+      "id": "house_cottage",
+      "components": {
+        "Layout": { "x": 400, "y": 760, "width": 224, "height": 192, "z": 10, "rotation": 0 },
+        "Drawing": { "file": "drawings/bld-home.drawing" },
+        "Collider": { "kind": "solid", "width": 200, "height": 96, "offsetX": 12, "offsetY": 86 }
+      }
+    },
+
+    { "id": "fence_n_1", "components": {
+      "Layout": { "x": 0, "y": 380, "width": 96, "height": 48, "z": 12, "rotation": 0 },
+      "Drawing": { "file": "drawings/env-fence.drawing" },
+      "Collider": { "kind": "solid", "width": 96, "height": 24, "offsetX": 0, "offsetY": 12 }
+    }},
+    { "id": "fence_n_2", "components": {
+      "Layout": { "x": 96, "y": 380, "width": 96, "height": 48, "z": 12, "rotation": 0 },
+      "Drawing": { "file": "drawings/env-fence.drawing" },
+      "Collider": { "kind": "solid", "width": 96, "height": 24, "offsetX": 0, "offsetY": 12 }
+    }},
+    { "id": "fence_s_1", "components": {
+      "Layout": { "x": 700, "y": 700, "width": 96, "height": 48, "z": 12, "rotation": 0 },
+      "Drawing": { "file": "drawings/env-fence.drawing" },
+      "Collider": { "kind": "solid", "width": 96, "height": 24, "offsetX": 0, "offsetY": 12 }
+    }},
+    { "id": "fence_s_2", "components": {
+      "Layout": { "x": 796, "y": 700, "width": 96, "height": 48, "z": 12, "rotation": 0 },
+      "Drawing": { "file": "drawings/env-fence.drawing" },
+      "Collider": { "kind": "solid", "width": 96, "height": 24, "offsetX": 0, "offsetY": 12 }
+    }},
+    { "id": "fence_s_3", "components": {
+      "Layout": { "x": 892, "y": 700, "width": 96, "height": 48, "z": 12, "rotation": 0 },
+      "Drawing": { "file": "drawings/env-fence.drawing" },
+      "Collider": { "kind": "solid", "width": 96, "height": 24, "offsetX": 0, "offsetY": 12 }
+    }},
+
+    { "id": "tree_1", "components": {
+      "Layout": { "x": 40, "y": 540, "width": 112, "height": 168, "z": 15, "rotation": 0 },
+      "Drawing": { "file": "drawings/env-tree-oak.drawing" },
+      "Collider": { "kind": "solid", "width": 44, "height": 24, "offsetX": 34, "offsetY": 128 }
+    }},
+    { "id": "tree_2", "components": {
+      "Layout": { "x": 280, "y": 380, "width": 112, "height": 168, "z": 15, "rotation": 0 },
+      "Drawing": { "file": "drawings/env-tree-pine.drawing" },
+      "Collider": { "kind": "solid", "width": 44, "height": 24, "offsetX": 34, "offsetY": 128 }
+    }},
+    { "id": "tree_3", "components": {
+      "Layout": { "x": 880, "y": 380, "width": 112, "height": 168, "z": 15, "rotation": 0 },
+      "Drawing": { "file": "drawings/env-tree-oak.drawing" },
+      "Collider": { "kind": "solid", "width": 44, "height": 24, "offsetX": 34, "offsetY": 128 }
+    }},
+    { "id": "tree_4", "components": {
+      "Layout": { "x": 160, "y": 800, "width": 112, "height": 168, "z": 15, "rotation": 0 },
+      "Drawing": { "file": "drawings/env-tree-pine.drawing" },
+      "Collider": { "kind": "solid", "width": 44, "height": 24, "offsetX": 34, "offsetY": 128 }
+    }},
+    { "id": "tree_5", "components": {
+      "Layout": { "x": 760, "y": 840, "width": 112, "height": 168, "z": 15, "rotation": 0 },
+      "Drawing": { "file": "drawings/env-tree-oak.drawing" },
+      "Collider": { "kind": "solid", "width": 44, "height": 24, "offsetX": 34, "offsetY": 128 }
+    }},
+
+    { "id": "fountain", "components": {
+      "Layout": { "x": 470, "y": 450, "width": 128, "height": 128, "z": 14, "rotation": 0 },
+      "Drawing": { "file": "drawings/env-fountain.drawing" },
+      "Collider": { "kind": "solid", "width": 112, "height": 64, "offsetX": 8, "offsetY": 56 }
+    }},
+
+    { "id": "hedge_1", "components": {
+      "Layout": { "x": 360, "y": 320, "width": 96, "height": 48, "z": 13, "rotation": 0 },
+      "Drawing": { "file": "drawings/env-hedge.drawing" },
+      "Collider": { "kind": "solid", "width": 96, "height": 32, "offsetX": 0, "offsetY": 12 }
+    }},
+    { "id": "hedge_2", "components": {
+      "Layout": { "x": 600, "y": 320, "width": 96, "height": 48, "z": 13, "rotation": 0 },
+      "Drawing": { "file": "drawings/env-hedge.drawing" },
+      "Collider": { "kind": "solid", "width": 96, "height": 32, "offsetX": 0, "offsetY": 12 }
+    }},
+
+    { "id": "flowers_1", "components": {
+      "Layout": { "x": 200, "y": 480, "width": 64, "height": 64, "z": 13, "rotation": 0 },
+      "Drawing": { "file": "drawings/env-flower-bed.drawing" },
+      "Collider": { "kind": "solid", "width": 56, "height": 40, "offsetX": 4, "offsetY": 18 }
+    }},
+    { "id": "flowers_2", "components": {
+      "Layout": { "x": 640, "y": 620, "width": 64, "height": 64, "z": 13, "rotation": 0 },
+      "Drawing": { "file": "drawings/env-flower-bed.drawing" },
+      "Collider": { "kind": "solid", "width": 56, "height": 40, "offsetX": 4, "offsetY": 18 }
+    }},
+
+    { "id": "crate_1", "components": {
+      "Layout": { "x": 850, "y": 580, "width": 64, "height": 64, "z": 14, "rotation": 0 },
+      "Drawing": { "file": "drawings/env-crate.drawing" },
+      "Collider": { "kind": "solid", "width": 64, "height": 48, "offsetX": 0, "offsetY": 16 }
+    }},
+    { "id": "crate_2", "components": {
+      "Layout": { "x": 920, "y": 580, "width": 64, "height": 64, "z": 14, "rotation": 0 },
+      "Drawing": { "file": "drawings/env-crate.drawing" },
+      "Collider": { "kind": "solid", "width": 64, "height": 48, "offsetX": 0, "offsetY": 16 }
+    }},
+
+    { "id": "coin_1", "components": {
+      "Layout": { "x": 360, "y": 600, "width": 36, "height": 36, "z": 16, "rotation": 0 },
+      "Drawing": { "file": "drawings/fx-sparkle.drawing", "tint": "#ffd166ff" }
+    }},
+    { "id": "coin_2", "components": {
+      "Layout": { "x": 720, "y": 480, "width": 36, "height": 36, "z": 16, "rotation": 0 },
+      "Drawing": { "file": "drawings/fx-sparkle.drawing", "tint": "#ffd166ff" }
+    }},
+    { "id": "coin_3", "components": {
+      "Layout": { "x": 280, "y": 720, "width": 36, "height": 36, "z": 16, "rotation": 0 },
+      "Drawing": { "file": "drawings/fx-sparkle.drawing", "tint": "#ffd166ff" }
+    }},
+    { "id": "coin_4", "components": {
+      "Layout": { "x": 560, "y": 850, "width": 36, "height": 36, "z": 16, "rotation": 0 },
+      "Drawing": { "file": "drawings/fx-sparkle.drawing", "tint": "#ffd166ff" }
+    }},
+
+    {
+      "id": "npc_juno",
+      "components": {
+        "Layout": { "x": 380, "y": 540, "width": 64, "height": 64, "z": 20, "rotation": 0 },
+        "Drawing": { "file": "drawings/npc-juno-idle-down.drawing" },
+        "Friend": { "name": "Juno" },
+        "Dialog": {
+          "speaker": "Juno",
+          "lines": [
+            "Hey traveler! Welcome to the village.",
+            "There's been strange noises from the woods at night...",
+            "If you're brave enough, find Opal -- she knows the way."
+          ]
+        }
+      }
+    },
+    {
+      "id": "npc_opal",
+      "components": {
+        "Layout": { "x": 640, "y": 460, "width": 64, "height": 64, "z": 20, "rotation": 0 },
+        "Drawing": { "file": "drawings/npc-opal-idle-down.drawing" },
+        "Friend": { "name": "Opal" },
+        "Dialog": {
+          "speaker": "Opal",
+          "lines": [
+            "Hmph. You smell like the road.",
+            "The forest path is east of here. Don't go alone.",
+            "Take this -- it'll keep the dark off your boots."
+          ]
+        }
+      }
+    }
+  ]
+}

package/kits/rpg-2d/tsconfig.json

@@ -0,0 +1,17 @@
+{
+  "compilerOptions": {
+    "allowImportingTsExtensions": true,
+    "allowSyntheticDefaultImports": true,
+    "isolatedModules": true,
+    "jsx": "react",
+    "lib": ["DOM", "DOM.Iterable", "ES2023"],
+    "module": "ESNext",
+    "moduleResolution": "Bundler",
+    "noEmit": true,
+    "skipLibCheck": true,
+    "strict": true,
+    "target": "ES2023",
+    "types": ["vite/client"]
+  },
+  "include": ["**/*.ts", "**/*.tsx"]
+}

package/kits/rpg-2d/vite-env.d.ts

@@ -0,0 +1,7 @@
+/// <reference types="vite/client" />
+
+declare module 'castle-web-sdk' {
+  export function setup(): void;
+  export function isEdit(): boolean;
+  export function writeFile(path: string, contents: string): Promise<{ ok: true; path: string }>;
+}

package/kits/rpg-2d/vite.config.js

@@ -0,0 +1 @@
+export default {};

package/package.json

@@ -1,15 +1,30 @@
 {
   "name": "castle-web-cli",
-  "version": "0.4.1",
+  "version": "0.4.2",
   "type": "module",
   "bin": {
     "castle-web": "./dist/index.js"
   },
   "scripts": {
-    "build": "tsc",
-    "dev": "tsc --watch"
+    "build": "tsc && rm -rf kits && cp -R ../kits kits",
+    "dev": "tsc --watch",
+    "check": "eslint . && jscpd && tsc --noEmit"
+  },
+  "jscpd": {
+    "path": [
+      "src"
+    ],
+    "threshold": 0,
+    "reporters": [
+      "consoleFull"
+    ]
   },
   "dependencies": {
+    "@lydell/node-pty": "^1.2.0-beta.12",
+    "@xterm/addon-fit": "^0.11.0",
+    "@xterm/addon-serialize": "^0.14.0",
+    "@xterm/headless": "^6.0.0",
+    "@xterm/xterm": "^6.0.0",
     "nanoid": "^5.1.7",
     "open": "^10.0.0",
     "vite": "^8.0.3",
@@ -19,6 +34,13 @@
   "devDependencies": {
     "@types/node": "^20.0.0",
     "@types/ws": "^8.18.1",
-    "typescript": "^5.0.0"
-  }
+    "eslint": "^9.0.0",
+    "jscpd": "^4.0.5",
+    "typescript": "^5.0.0",
+    "typescript-eslint": "^8.0.0"
+  },
+  "files": [
+    "dist",
+    "kits"
+  ]
 }

package/AGENTS.md

@@ -1,25 +0,0 @@
-# Castle Web CLI
-
-## Commands
-
-- `npx castle-web-cli init <dir>` — scaffold a new project (index.html, game.js, package.json with castle-web-sdk)
-- `npx castle-web-cli serve [dir] [--port PORT] [--open]` — local dev server with Vite (default port 3737, WS on 3738). Writes `.castle/serve.json` with active ports. No auto-reload — use `restart` to reload.
-- `npx castle-web-cli restart [dir] [--port PORT]` — reload the game in the browser. Reads WS port from `.castle/serve.json` if no `--port` given.
-- `npx castle-web-cli screenshot [dir] [--out FILE] [--port PORT]` — capture a screenshot from the running game (default: screenshot.png). Reads WS port from `.castle/serve.json` if no `--port` given.
-- `npx castle-web-cli push [dir]` — bundle with Vite and publish to Castle. Creates a new deck if no castle.json exists. Automatically saves a preview image on first push if `serve` is running (reads WS port from `.castle/serve.json`).
-- `npx castle-web-cli save-preview-image [dir] [--port PORT] [--no-restart]` — restarts the deck, takes a screenshot, uploads it as the deck's preview image. Requires `serve` running and `castle.json` to exist (push first). Reads WS port from `.castle/serve.json` if no `--port` given.
-- `npx castle-web-cli login` — authenticate with Castle (saves token to ~/.castle/config.json)
-
-## Project Structure
-
-```
-my-game/
-  index.html      # entry point
-  game.js         # game code
-  package.json    # dependencies (castle-web-sdk)
-  castle.json     # deck/card IDs (created by first push)
-  .castle/        # runtime state (logs, screenshots, serve port)
-    serve.json    # active serve ports (written by serve, cleaned up on exit)
-    logs.txt      # forwarded console.log/warn/error
-    screenshots/  # captured screenshots
-```

package/dist/push.d.ts

@@ -1 +0,0 @@
-export declare function push(dir: string): Promise<void>;

package/src/api.ts

@@ -1,160 +0,0 @@
-import * as config from './config.js';
-
-const API_HOST = 'https://api.castle.xyz/graphql';
-
-async function graphql(query: string, variables?: Record<string, unknown>): Promise<any> {
-  const token = config.getToken();
-  const headers: Record<string, string> = {
-    'X-OS': 'cli',
-    'X-CLI-API-Version': '2',
-    'Content-Type': 'application/json',
-    Accept: 'application/json',
-  };
-  if (token) headers['X-Auth-Token'] = token;
-  const res = await fetch(API_HOST, {
-    method: 'POST',
-    headers,
-    body: JSON.stringify(variables ? { query, variables } : { query }),
-    signal: AbortSignal.timeout(10000),
-  });
-  return res.json();
-}
-
-function handleAPIError(data: any): void {
-  if (data?.errors?.length) {
-    const err: any = new Error(data.errors[0]?.message ?? 'GraphQL error');
-    err.extensions = data.errors[0]?.extensions;
-    throw err;
-  }
-}
-
-export async function startCLILogin(): Promise<{ pollToken: string; url: string }> {
-  const data = await graphql(`mutation { startCLILogin { pollToken url } }`);
-  handleAPIError(data);
-  return data.data.startCLILogin;
-}
-
-export async function pollForCLILogin(pollToken: string): Promise<any> {
-  const data = await graphql(
-    `query($pollToken: String!) {
-       pollForCLILogin(pollToken: $pollToken) {
-         userId username token isAnonymous
-       }
-     }`,
-    { pollToken }
-  );
-  handleAPIError(data);
-  return data.data?.pollForCLILogin ?? null;
-}
-
-export async function me(): Promise<any> {
-  try {
-    const data = await graphql(`query { me { userId username isAnonymous photo { url } photoFrame { frameUrl } } }`);
-    return data.data?.me ?? null;
-  } catch {
-    return null;
-  }
-}
-
-export async function myDecks(): Promise<any[]> {
-  const data = await graphql(`query {
-    me {
-      decks {
-        deckId
-        title
-        initialCard { cardId }
-      }
-    }
-  }`);
-  handleAPIError(data);
-  return data.data?.me?.decks ?? [];
-}
-
-export async function updateCardAndDeckV2(
-  deck: Record<string, unknown>,
-  card: Record<string, unknown>,
-): Promise<{ deckId: string; cardId: string }> {
-  const data = await graphql(
-    `mutation($deck: DeckInput!, $card: CardInput!) {
-       updateCardAndDeckV2(deck: $deck, card: $card) {
-         deck { deckId }
-         card { cardId }
-       }
-     }`,
-    { deck, card }
-  );
-  handleAPIError(data);
-  return {
-    deckId: data.data.updateCardAndDeckV2.deck.deckId,
-    cardId: data.data.updateCardAndDeckV2.card.cardId,
-  };
-}
-
-export async function createDeck(
-  deck: Record<string, unknown>,
-  card: Record<string, unknown>
-): Promise<{ deckId: string; cardId: string }> {
-  const data = await graphql(
-    `mutation($deck: DeckInput!, $card: CardInput!) {
-       createDeck(deck: $deck, card: $card) {
-         deckId
-         initialCard { cardId }
-       }
-     }`,
-    { deck, card }
-  );
-  handleAPIError(data);
-  return {
-    deckId: data.data.createDeck.deckId,
-    cardId: data.data.createDeck.initialCard.cardId,
-  };
-}
-
-export async function createSceneDataUploadConfig(cardIds: string[]): Promise<any[]> {
-  const data = await graphql(
-    `mutation($cardIds: [ID!]!) {
-       createSceneDataUploadConfig(cardIds: $cardIds) {
-         cardId uploadId postUrl postFields
-       }
-     }`,
-    { cardIds }
-  );
-  handleAPIError(data);
-  return data.data.createSceneDataUploadConfig;
-}
-
-export async function uploadSceneData(
-  cards: Array<{ cardId: string; uploadId: string }>
-): Promise<any[]> {
-  const data = await graphql(
-    `mutation($cards: [CardSceneDataInput!]!) {
-       uploadSceneData(cards: $cards) { cardId sceneDataUrl }
-     }`,
-    { cards }
-  );
-  handleAPIError(data);
-  return data.data.uploadSceneData;
-}
-
-export async function uploadBase64(base64: string, filename: string): Promise<{ fileId: string; url: string }> {
-  const data = await graphql(
-    `mutation($data: String!, $filename: String, $mimetype: String) {
-       uploadBase64(data: $data, filename: $filename, mimetype: $mimetype) {
-         fileId url
-       }
-     }`,
-    { data: base64, filename, mimetype: 'image/png' }
-  );
-  handleAPIError(data);
-  return data.data.uploadBase64;
-}
-
-export async function updateCardCustomBackgroundImage(cardId: string, backgroundImageFileId: string): Promise<void> {
-  const data = await graphql(
-    `mutation($cardId: ID!, $backgroundImageFileId: ID) {
-       updateCardCustomBackgroundImage(cardId: $cardId, backgroundImageFileId: $backgroundImageFileId)
-     }`,
-    { cardId, backgroundImageFileId }
-  );
-  handleAPIError(data);
-}

package/src/bundle.ts

@@ -1,28 +0,0 @@
-import * as path from 'path';
-import { build } from 'vite';
-import { viteSingleFile } from 'vite-plugin-singlefile';
-
-export async function bundleProject(dir: string): Promise<string> {
-  const result = await build({
-    root: dir,
-    plugins: [viteSingleFile()],
-    build: {
-      write: false,
-      rollupOptions: {
-        input: path.join(dir, 'index.html'),
-      },
-    },
-    logLevel: 'silent',
-  });
-
-  const output = Array.isArray(result) ? result[0] : result;
-  if (!('output' in output)) throw new Error('Unexpected build result');
-
-  for (const chunk of output.output) {
-    if (chunk.type === 'asset' && chunk.fileName.endsWith('.html')) {
-      return chunk.source as string;
-    }
-  }
-
-  throw new Error('No HTML output found from build');
-}

package/src/config.ts

@@ -1,36 +0,0 @@
-import * as fs from 'fs';
-import * as path from 'path';
-import * as os from 'os';
-
-function getConfigDir() {
-  return path.join(os.homedir(), '.castle');
-}
-
-function readConfigFile(filename: string): any {
-  const configDir = getConfigDir();
-  const configFilePath = path.join(configDir, filename);
-  try {
-    if (fs.existsSync(configFilePath)) {
-      return JSON.parse(fs.readFileSync(configFilePath, 'utf-8'));
-    }
-  } catch {}
-  return null;
-}
-
-export function getToken(): string | null {
-  const config = readConfigFile('config.json');
-  return config ? config.token : null;
-}
-
-export function setToken(token: string | null): void {
-  const configDir = getConfigDir();
-  fs.mkdirSync(configDir, { recursive: true });
-  const existing = readConfigFile('config.json') ?? {};
-  if (token === null) {
-    delete existing.token;
-  } else {
-    existing.token = token;
-  }
-  const configFilePath = path.join(configDir, 'config.json');
-  fs.writeFileSync(configFilePath, JSON.stringify(existing, null, 2), 'utf-8');
-}