npm - castle-web-cli - Versions diffs - 0.4.1 → 0.4.2 - Mend

castle-web-cli 0.4.1 → 0.4.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (158) hide show

package/dist/api.d.ts +53 -5
package/dist/api.js +42 -15
package/dist/config.d.ts +2 -0
package/dist/config.js +25 -11
package/dist/get-deck.d.ts +3 -0
package/dist/get-deck.js +64 -0
package/dist/ide-client.d.ts +1 -0
package/dist/ide-client.js +537 -0
package/dist/ide.d.ts +16 -0
package/dist/ide.js +546 -0
package/dist/index.js +36 -41
package/dist/init.d.ts +3 -1
package/dist/init.js +170 -24
package/dist/localPaths.d.ts +6 -0
package/dist/localPaths.js +33 -0
package/dist/login.js +1 -1
package/dist/preview.d.ts +3 -0
package/dist/preview.js +53 -34
package/dist/save-deck.d.ts +2 -0
package/dist/{push.js → save-deck.js} +66 -5
package/dist/serve.d.ts +2 -0
package/dist/serve.js +290 -27
package/kits/basic-2d/.prettierrc +8 -0
package/kits/basic-2d/CLAUDE.md +131 -0
package/kits/basic-2d/behaviors/Camera.jsx +43 -0
package/kits/basic-2d/behaviors/Collider.jsx +71 -0
package/kits/basic-2d/behaviors/Drawing.jsx +139 -0
package/kits/basic-2d/behaviors/Layout.jsx +16 -0
package/kits/basic-2d/drawings/floor.drawing +70 -0
package/kits/basic-2d/editors/App.jsx +152 -0
package/kits/basic-2d/editors/CodeEditor.jsx +112 -0
package/kits/basic-2d/editors/DrawingEditor.jsx +222 -0
package/kits/basic-2d/editors/FileBrowser.jsx +143 -0
package/kits/basic-2d/editors/PlayOnly.jsx +21 -0
package/kits/basic-2d/editors/SceneEditor.jsx +1012 -0
package/kits/basic-2d/editors/behaviorRegistry.js +24 -0
package/kits/basic-2d/editors/editorHistory.js +52 -0
package/kits/basic-2d/engine/ScenePlayer.jsx +83 -0
package/kits/basic-2d/engine/SceneUI.jsx +67 -0
package/kits/basic-2d/engine/TouchControls.jsx +136 -0
package/kits/basic-2d/engine/autoInspector.jsx +51 -0
package/kits/basic-2d/engine/files.js +62 -0
package/kits/basic-2d/engine/scene.js +420 -0
package/kits/basic-2d/engine/ui.jsx +344 -0
package/kits/basic-2d/engine/ui.module.css +928 -0
package/kits/basic-2d/eslint.config.js +50 -0
package/kits/basic-2d/index.html +11 -0
package/kits/basic-2d/main.jsx +10 -0
package/kits/basic-2d/package-lock.json +2706 -0
package/kits/basic-2d/package.json +41 -0
package/kits/basic-2d/scenes/main.scene +108 -0
package/kits/basic-2d/vite.config.js +1 -0
package/kits/basic-2d-frozen/.prettierrc +8 -0
package/kits/basic-2d-frozen/CLAUDE.md +131 -0
package/kits/basic-2d-frozen/behaviors/Camera.jsx +43 -0
package/kits/basic-2d-frozen/behaviors/Collider.jsx +71 -0
package/kits/basic-2d-frozen/behaviors/Drawing.jsx +139 -0
package/kits/basic-2d-frozen/behaviors/Layout.jsx +16 -0
package/kits/basic-2d-frozen/drawings/floor.drawing +70 -0
package/kits/basic-2d-frozen/editors/App.jsx +152 -0
package/kits/basic-2d-frozen/editors/CodeEditor.jsx +112 -0
package/kits/basic-2d-frozen/editors/DrawingEditor.jsx +222 -0
package/kits/basic-2d-frozen/editors/FileBrowser.jsx +143 -0
package/kits/basic-2d-frozen/editors/PlayOnly.jsx +21 -0
package/kits/basic-2d-frozen/editors/SceneEditor.jsx +1012 -0
package/kits/basic-2d-frozen/editors/behaviorRegistry.js +24 -0
package/kits/basic-2d-frozen/editors/editorHistory.js +52 -0
package/kits/basic-2d-frozen/engine/ScenePlayer.jsx +83 -0
package/kits/basic-2d-frozen/engine/SceneUI.jsx +67 -0
package/kits/basic-2d-frozen/engine/TouchControls.jsx +136 -0
package/kits/basic-2d-frozen/engine/autoInspector.jsx +51 -0
package/kits/basic-2d-frozen/engine/files.js +62 -0
package/kits/basic-2d-frozen/engine/scene.js +420 -0
package/kits/basic-2d-frozen/engine/ui.jsx +344 -0
package/kits/basic-2d-frozen/engine/ui.module.css +928 -0
package/kits/basic-2d-frozen/eslint.config.js +50 -0
package/kits/basic-2d-frozen/index.html +11 -0
package/kits/basic-2d-frozen/main.jsx +10 -0
package/kits/basic-2d-frozen/package-lock.json +2706 -0
package/kits/basic-2d-frozen/package.json +41 -0
package/kits/basic-2d-frozen/scenes/main.scene +108 -0
package/kits/basic-2d-frozen/vite.config.js +1 -0
package/kits/rpg-2d/.prettierrc +8 -0
package/kits/rpg-2d/behaviors/Camera.tsx +52 -0
package/kits/rpg-2d/behaviors/Collider.tsx +98 -0
package/kits/rpg-2d/behaviors/Dialog.tsx +184 -0
package/kits/rpg-2d/behaviors/Drawing.tsx +161 -0
package/kits/rpg-2d/behaviors/Friend.tsx +45 -0
package/kits/rpg-2d/behaviors/Layout.tsx +29 -0
package/kits/rpg-2d/behaviors/PlayerController.tsx +255 -0
package/kits/rpg-2d/behaviors/Portal.tsx +60 -0
package/kits/rpg-2d/behaviors/QuestLog.tsx +90 -0
package/kits/rpg-2d/behaviors/SaveMenu.tsx +123 -0
package/kits/rpg-2d/behaviors/Tilemap.tsx +90 -0
package/kits/rpg-2d/drawings/bld-home.drawing +8136 -0
package/kits/rpg-2d/drawings/env-crate.drawing +509 -0
package/kits/rpg-2d/drawings/env-fence.drawing +536 -0
package/kits/rpg-2d/drawings/env-flower-bed.drawing +607 -0
package/kits/rpg-2d/drawings/env-fountain.drawing +2622 -0
package/kits/rpg-2d/drawings/env-hedge.drawing +601 -0
package/kits/rpg-2d/drawings/env-house-blue.drawing +1 -0
package/kits/rpg-2d/drawings/env-house-green.drawing +1 -0
package/kits/rpg-2d/drawings/env-tree-oak.drawing +1540 -0
package/kits/rpg-2d/drawings/env-tree-pine.drawing +1315 -0
package/kits/rpg-2d/drawings/floor.drawing +70 -0
package/kits/rpg-2d/drawings/fx-sparkle.drawing +926 -0
package/kits/rpg-2d/drawings/npc-juno-idle-down.drawing +1099 -0
package/kits/rpg-2d/drawings/npc-juno-walk-down.drawing +4177 -0
package/kits/rpg-2d/drawings/npc-opal-idle-down.drawing +1099 -0
package/kits/rpg-2d/drawings/npc-opal-walk-down.drawing +4177 -0
package/kits/rpg-2d/drawings/player-idle-down.drawing +1070 -0
package/kits/rpg-2d/drawings/player-idle-left.drawing +1070 -0
package/kits/rpg-2d/drawings/player-idle-right.drawing +1070 -0
package/kits/rpg-2d/drawings/player-idle-up.drawing +1070 -0
package/kits/rpg-2d/drawings/player-walk-down.drawing +4148 -0
package/kits/rpg-2d/drawings/player-walk-left.drawing +4148 -0
package/kits/rpg-2d/drawings/player-walk-right.drawing +4148 -0
package/kits/rpg-2d/drawings/player-walk-up.drawing +4148 -0
package/kits/rpg-2d/editors/App.tsx +163 -0
package/kits/rpg-2d/editors/CodeEditor.tsx +120 -0
package/kits/rpg-2d/editors/DrawingEditor.tsx +278 -0
package/kits/rpg-2d/editors/FileBrowser.tsx +191 -0
package/kits/rpg-2d/editors/PlayOnly.tsx +26 -0
package/kits/rpg-2d/editors/SceneEditor.tsx +1093 -0
package/kits/rpg-2d/editors/behaviorRegistry.ts +33 -0
package/kits/rpg-2d/editors/editorHistory.ts +75 -0
package/kits/rpg-2d/editors/editorProps.ts +10 -0
package/kits/rpg-2d/engine/ScenePlayer.tsx +130 -0
package/kits/rpg-2d/engine/SceneUI.tsx +74 -0
package/kits/rpg-2d/engine/TouchControls.tsx +157 -0
package/kits/rpg-2d/engine/autoInspector.tsx +111 -0
package/kits/rpg-2d/engine/drawing.ts +81 -0
package/kits/rpg-2d/engine/files.ts +215 -0
package/kits/rpg-2d/engine/scene.ts +484 -0
package/kits/rpg-2d/engine/ui.module.css +928 -0
package/kits/rpg-2d/engine/ui.tsx +483 -0
package/kits/rpg-2d/eslint.config.js +46 -0
package/kits/rpg-2d/index.html +11 -0
package/kits/rpg-2d/main.tsx +14 -0
package/kits/rpg-2d/package-lock.json +3149 -0
package/kits/rpg-2d/package.json +46 -0
package/kits/rpg-2d/scenes/main.scene +203 -0
package/kits/rpg-2d/tsconfig.json +17 -0
package/kits/rpg-2d/vite-env.d.ts +7 -0
package/kits/rpg-2d/vite.config.js +1 -0
package/package.json +27 -5
package/AGENTS.md +0 -25
package/dist/push.d.ts +0 -1
package/src/api.ts +0 -160
package/src/bundle.ts +0 -28
package/src/config.ts +0 -36
package/src/index.ts +0 -143
package/src/init.ts +0 -71
package/src/login.ts +0 -24
package/src/preview.ts +0 -94
package/src/push.ts +0 -118
package/src/serve.ts +0 -134
package/tsconfig.json +0 -13

package/dist/init.js CHANGED Viewed

@@ -1,5 +1,6 @@
 import * as fs from 'fs';
 import * as path from 'path';
+import { getCliEntryPath, getKitsDir, getRepoRoot, getSdkPackagePath, toPosixPath } from './localPaths.js';
 const INDEX_HTML = `<!DOCTYPE html>
 <html>
 <head>
@@ -25,38 +26,183 @@ el.style.cssText = \`
 el.textContent = 'Hello Castle!';
 card.appendChild(el);
 `;
-const CLAUDE_MD = `@node_modules/castle-web-cli/AGENTS.md
-@node_modules/castle-web-sdk/AGENTS.md
-`;
-export async function init(dir) {
-    const projectDir = path.resolve(dir);
-    if (fs.existsSync(projectDir) && fs.readdirSync(projectDir).length > 0) {
-        console.error(`Directory "${dir}" is not empty.`);
-        process.exit(1);
+// Default kit copied by `init` when no --kit is given. `none`/`bare` skip the
+// kit and produce the minimal index.html + game.js stub above.
+const DEFAULT_KIT = 'basic-2d';
+// Registry version of castle-web-sdk to inject when scaffolding from a
+// globally-installed castle-web (not from inside the workspace). Bumped
+// alongside cli/sdk version bumps.
+const PUBLISHED_SDK_VERSION = '0.4.2';
+// Never copied into a fresh deck: build/dependency junk, and castle.json (a
+// fresh deck has no deckId until its first save-deck).
+const KIT_COPY_EXCLUDE = new Set(['node_modules', '.castle', 'dist', '.git', 'castle.json']);
+function relativeFromProject(projectDir, target) {
+    return toPosixPath(path.relative(projectDir, target));
+}
+function makeClaudeMd() {
+    // Inline the upstream CLAUDE.md content. An @-import works inside the
+    // castle-experimental-web checkout, but breaks when the scaffold lives
+    // outside the repo (the relative path no longer resolves).
+    const repoRoot = getRepoRoot();
+    const upstream = path.join(repoRoot, 'CLAUDE.md');
+    try {
+        return fs.readFileSync(upstream, 'utf8').trimEnd() + '\n';
     }
-    fs.mkdirSync(projectDir, { recursive: true });
-    fs.writeFileSync(path.join(projectDir, 'index.html'), INDEX_HTML);
-    fs.writeFileSync(path.join(projectDir, 'game.js'), GAME_JS);
-    fs.writeFileSync(path.join(projectDir, 'CLAUDE.md'), CLAUDE_MD);
-    const packageJson = {
+    catch {
+        return `# Castle Experimental Web\n\nSee https://github.com/castle-xyz/castle-experimental-web for the agent guide.\n`;
+    }
+}
+function tryMakeAgentsSymlink(agentsPath) {
+    try {
+        fs.symlinkSync('CLAUDE.md', agentsPath);
+    }
+    catch {
+        // symlink already exists / unsupported FS — non-fatal
+    }
+}
+function makePackageJson(projectDir) {
+    const cliEntry = relativeFromProject(projectDir, getCliEntryPath());
+    const sdkPackage = relativeFromProject(projectDir, getSdkPackagePath());
+    return {
         name: path.basename(projectDir),
         private: true,
         type: 'module',
-        dependencies: {
-            'castle-web-sdk': '*',
+        scripts: {
+            serve: `node ${cliEntry} serve . --open`,
+            restart: `node ${cliEntry} restart .`,
+            screenshot: `node ${cliEntry} screenshot .`,
+            'save-deck': `node ${cliEntry} save-deck .`,
         },
-        devDependencies: {
-            'castle-web-cli': '*',
+        dependencies: {
+            'castle-web-sdk': `file:${sdkPackage}`,
         },
     };
-    fs.writeFileSync(path.join(projectDir, 'package.json'), JSON.stringify(packageJson, null, 2) + '\n');
-    const { execSync } = await import('child_process');
-    execSync('npm install', { cwd: projectDir, stdio: 'inherit' });
-    console.log(`Created project in ${projectDir}/`);
+}
+// Some coding agents read AGENTS.md by convention. Symlink so they get the
+// same guidance without a duplicate copy.
+function ensureAgentsSymlink(projectDir) {
+    const agentsPath = path.join(projectDir, 'AGENTS.md');
+    if (fs.lstatSync(agentsPath, { throwIfNoEntry: false }))
+        return;
+    // Don't create a dangling link — only symlink when CLAUDE.md is present.
+    if (!fs.existsSync(path.join(projectDir, 'CLAUDE.md')))
+        return;
+    tryMakeAgentsSymlink(agentsPath);
+}
+// Bare scaffold: a plain code-only deck with no kit framework.
+function scaffoldBare(projectDir) {
+    fs.mkdirSync(projectDir, { recursive: true });
+    fs.writeFileSync(path.join(projectDir, 'index.html'), INDEX_HTML);
+    fs.writeFileSync(path.join(projectDir, 'game.js'), GAME_JS);
+    fs.writeFileSync(path.join(projectDir, 'CLAUDE.md'), makeClaudeMd());
+    ensureAgentsSymlink(projectDir);
+    fs.writeFileSync(path.join(projectDir, 'package.json'), JSON.stringify(makePackageJson(projectDir), null, 2) + '\n');
+}
+// Copy a framework kit from kits/<kit>/ into the new deck dir, dropping
+// build/dependency junk and castle.json.
+function scaffoldFromKit(kit, projectDir) {
+    const kitDir = path.join(getKitsDir(), kit);
+    if (!fs.existsSync(kitDir) || !fs.statSync(kitDir).isDirectory()) {
+        console.error(`Kit "${kit}" not found at ${kitDir}.`);
+        console.error('Available kits:');
+        try {
+            const kits = fs
+                .readdirSync(getKitsDir())
+                .filter((name) => fs.statSync(path.join(getKitsDir(), name)).isDirectory());
+            if (kits.length)
+                for (const name of kits)
+                    console.error(`  ${name}`);
+            else
+                console.error('  (none)');
+        }
+        catch {
+            console.error('  (none — kits/ directory is missing)');
+        }
+        console.error('Or use `--kit none` for a bare code-only deck.');
+        process.exit(1);
+    }
+    fs.cpSync(kitDir, projectDir, {
+        recursive: true,
+        // Keep symlinks verbatim so the kit's AGENTS.md -> CLAUDE.md stays a link.
+        verbatimSymlinks: true,
+        filter: (src) => src === kitDir || !KIT_COPY_EXCLUDE.has(path.basename(src)),
+    });
+    // The kit's package.json carries the kit's name; rename it to the deck dir.
+    // Kit-relative refs to `../../sdk` and `../../cli/dist` only resolve when the
+    // deck lives at castle-experimental-web/decks/<name>/. Rewrite both to
+    // absolute paths so the scaffolded deck works anywhere -- including under
+    // /tmp where macOS's /tmp -> /private/tmp symlink breaks relative-path math.
+    const pkgPath = path.join(projectDir, 'package.json');
+    if (fs.existsSync(pkgPath)) {
+        try {
+            const pkg = JSON.parse(fs.readFileSync(pkgPath, 'utf8'));
+            pkg.name = path.basename(projectDir);
+            // Local-dev paths (`file:../../sdk` / `node ../../cli/dist/index.js`) only
+            // work when the deck lives inside the castle-experimental-web workspace.
+            // For a deck scaffolded from a globally-installed castle-web, rewrite to
+            // the published packages instead.
+            const sdkPath = getSdkPackagePath();
+            const cliEntry = getCliEntryPath();
+            const sdkIsLocal = fs.existsSync(sdkPath);
+            const cliIsLocal = fs.existsSync(cliEntry);
+            const sdkRef = sdkIsLocal ? `file:${toPosixPath(sdkPath)}` : `^${PUBLISHED_SDK_VERSION}`;
+            const cliDistAbs = cliIsLocal ? toPosixPath(path.dirname(cliEntry)) : null;
+            if (pkg.dependencies &&
+                typeof pkg.dependencies['castle-web-sdk'] === 'string' &&
+                pkg.dependencies['castle-web-sdk'].startsWith('file:')) {
+                pkg.dependencies['castle-web-sdk'] = sdkRef;
+            }
+            if (pkg.scripts) {
+                for (const k of Object.keys(pkg.scripts)) {
+                    if (typeof pkg.scripts[k] !== 'string')
+                        continue;
+                    if (cliDistAbs) {
+                        pkg.scripts[k] = pkg.scripts[k]
+                            .replace(/\.\.\/\.\.\/cli\/dist/g, cliDistAbs)
+                            .replace(/\.\.\/\.\.\/sdk/g, sdkIsLocal ? toPosixPath(sdkPath) : '');
+                    }
+                    else {
+                        // Globally-installed: route through the `castle-web` binary on PATH.
+                        pkg.scripts[k] = pkg.scripts[k]
+                            .replace(/node\s+\.\.\/\.\.\/cli\/dist\/index\.js/g, 'castle-web')
+                            .replace(/await import\((['"])\.\.\/\.\.\/cli\/dist\/bundle\.js\1\)/g, "await import('castle-web-cli/dist/bundle.js')")
+                            .replace(/\.\.\/\.\.\/sdk/g, '');
+                    }
+                }
+            }
+            fs.writeFileSync(pkgPath, JSON.stringify(pkg, null, 2) + '\n');
+        }
+        catch {
+            // kit shipped an unparseable package.json — leave it for the user to fix
+        }
+    }
+    // Every deck needs a CLAUDE.md so coding agents know how castle-web works.
+    // Keep the kit's own if it ships one; otherwise generate from the upstream.
+    const claudePath = path.join(projectDir, 'CLAUDE.md');
+    if (!fs.existsSync(claudePath)) {
+        fs.writeFileSync(claudePath, makeClaudeMd());
+    }
+    ensureAgentsSymlink(projectDir);
+}
+export function init(dir, opts = {}) {
+    const projectDir = path.resolve(dir);
+    if (fs.existsSync(projectDir) && fs.readdirSync(projectDir).length > 0) {
+        console.error(`Directory "${dir}" is not empty.`);
+        process.exit(1);
+    }
+    const kit = opts.kit ?? DEFAULT_KIT;
+    const bare = kit === 'none' || kit === 'bare';
+    if (bare) {
+        scaffoldBare(projectDir);
+    }
+    else {
+        scaffoldFromKit(kit, projectDir);
+    }
+    console.log(`Created project in ${projectDir}/${bare ? '' : ` (from kit "${kit}")`}`);
     console.log('');
     console.log('Next steps:');
     console.log(`  cd ${dir}`);
-    console.log('  npx castle-web-cli serve --open');
-    console.log('  npx castle-web-cli login');
-    console.log('  npx castle-web-cli push');
+    console.log('  npm install');
+    console.log('  npm run serve');
+    console.log('  npm run save-deck');
 }

package/dist/localPaths.d.ts ADDED Viewed

@@ -0,0 +1,6 @@
+export declare function getPackageRoot(): string;
+export declare function getRepoRoot(): string;
+export declare function getCliEntryPath(): string;
+export declare function getSdkPackagePath(): string;
+export declare function getKitsDir(): string;
+export declare function toPosixPath(filepath: string): string;

package/dist/localPaths.js ADDED Viewed

@@ -0,0 +1,33 @@
+import * as fs from 'fs';
+import * as path from 'path';
+import { fileURLToPath } from 'url';
+// Root of the castle-web-cli package itself (one up from dist/), regardless of
+// whether we're running from a workspace checkout or a globally-installed npm
+// package.
+export function getPackageRoot() {
+    return path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..');
+}
+// Kept for backward compat: the "repo root" only makes sense in workspace
+// dev mode. Two levels up from dist/, i.e. one above the cli package.
+export function getRepoRoot() {
+    return path.resolve(getPackageRoot(), '..');
+}
+export function getCliEntryPath() {
+    return path.join(getPackageRoot(), 'dist', 'index.js');
+}
+// Workspace-only: kits live alongside cli/ in the repo. When castle-web is
+// installed globally we bundle kits inside the package itself (see below).
+export function getSdkPackagePath() {
+    return path.join(getRepoRoot(), 'sdk');
+}
+export function getKitsDir() {
+    // Prefer bundled kits (shipped inside the published cli package);
+    // fall back to the workspace `kits/` alongside cli/.
+    const bundled = path.join(getPackageRoot(), 'kits');
+    if (fs.existsSync(bundled))
+        return bundled;
+    return path.join(getRepoRoot(), 'kits');
+}
+export function toPosixPath(filepath) {
+    return filepath.split(path.sep).join('/');
+}

package/dist/login.js CHANGED Viewed

@@ -11,7 +11,7 @@ export async function login() {
         await new Promise((r) => setTimeout(r, 1000));
         const user = await api.pollForCLILogin(pollToken);
         if (user) {
-            config.setToken(user.token);
+            config.setAuth(user.token, user.userId);
             console.log(`Logged in as @${user.username}`);
             return;
         }

package/dist/preview.d.ts CHANGED Viewed

@@ -1,2 +1,5 @@
+import type { WebSocket as WSClient } from 'ws';
+export declare function connectWS(wsPort: number): Promise<WSClient>;
+export declare function takeScreenshot(ws: WSClient): Promise<string>;
 export declare function savePreviewImage(dir: string, wsPort: number, noRestart?: boolean): Promise<void>;
 export declare function savePreviewIfNeeded(dir: string, wsPort: number): Promise<void>;

package/dist/preview.js CHANGED Viewed

@@ -2,30 +2,46 @@ import * as fs from 'fs';
 import * as path from 'path';
 import * as api from './api.js';
 import * as config from './config.js';
-function connectWS(wsPort) {
-    return new Promise(async (resolve, reject) => {
-        const { default: WS } = await import('ws');
+export async function connectWS(wsPort) {
+    const { default: WS } = await import('ws');
+    return new Promise((resolve, reject) => {
         const ws = new WS(`ws://localhost:${wsPort}`);
         ws.on('error', () => reject(new Error('Could not connect. Is castle-web serve running?')));
         ws.on('open', () => resolve(ws));
     });
 }
-function takeScreenshot(ws) {
+export function takeScreenshot(ws) {
     return new Promise((resolve, reject) => {
         const requestId = Math.random().toString(36).slice(2);
+        const cleanup = () => {
+            clearTimeout(timeout);
+            ws.off('message', onMessage);
+        };
+        const fail = (error) => {
+            cleanup();
+            reject(error);
+        };
         const timeout = setTimeout(() => {
-            reject(new Error('Screenshot timed out.'));
+            fail(new Error('Screenshot timed out. The deck must be open in a browser tab to capture a screenshot. Start `castle-web serve --open` or open the served URL in a browser.'));
         }, 10000);
-        ws.on('message', (raw) => {
+        const onMessage = (raw) => {
             try {
                 const msg = JSON.parse(raw.toString());
-                if (msg.type === 'screenshot_response' && msg.requestId === requestId) {
-                    clearTimeout(timeout);
+                if (msg.type !== 'screenshot_response' || msg.requestId !== requestId)
+                    return;
+                if (typeof msg.data === 'string') {
+                    cleanup();
                     resolve(msg.data.replace(/^data:image\/png;base64,/, ''));
                 }
+                else if (msg.ok === false) {
+                    fail(new Error(msg.error || 'Could not capture screenshot.'));
+                }
+            }
+            catch {
+                // ignore malformed frames
             }
-            catch { }
-        });
+        };
+        ws.on('message', onMessage);
         ws.send(JSON.stringify({ type: 'screenshot_request', requestId }));
     });
 }
@@ -35,14 +51,28 @@ function waitForRestart(ws) {
         setTimeout(resolve, 2000);
     });
 }
+function readCastleJson(projectDir) {
+    const castleJsonPath = path.join(projectDir, 'castle.json');
+    if (!fs.existsSync(castleJsonPath))
+        return null;
+    return JSON.parse(fs.readFileSync(castleJsonPath, 'utf-8'));
+}
+async function captureAndUpload(projectDir, ws, castleJson) {
+    const base64 = await takeScreenshot(ws);
+    ws.close();
+    fs.writeFileSync(path.join(projectDir, 'preview.png'), Buffer.from(base64, 'base64'));
+    console.log('Saved preview.png');
+    const file = await api.uploadBase64(base64, 'preview.png');
+    await api.updateCardCustomBackgroundImage(castleJson.cardId, file.fileId);
+    console.log('Set deck preview image.');
+}
 export async function savePreviewImage(dir, wsPort, noRestart = false) {
     const projectDir = path.resolve(dir);
-    const castleJsonPath = path.join(projectDir, 'castle.json');
-    if (!fs.existsSync(castleJsonPath)) {
-        console.error('No castle.json found. Push the deck first.');
+    const castleJson = readCastleJson(projectDir);
+    if (!castleJson) {
+        console.error('No castle.json found. Save the deck first.');
         process.exit(1);
     }
-    const castleJson = JSON.parse(fs.readFileSync(castleJsonPath, 'utf-8'));
     if (!config.getToken()) {
         console.error('Not logged in. Run `castle-web login` first.');
         process.exit(1);
@@ -50,38 +80,27 @@ export async function savePreviewImage(dir, wsPort, noRestart = false) {
     const ws = await connectWS(wsPort);
     if (!noRestart)
         await waitForRestart(ws);
-    const base64 = await takeScreenshot(ws);
-    ws.close();
-    fs.writeFileSync(path.join(projectDir, 'preview.png'), Buffer.from(base64, 'base64'));
-    console.log('Saved preview.png');
-    const file = await api.uploadBase64(base64, 'preview.png');
-    await api.updateCardCustomBackgroundImage(castleJson.cardId, file.fileId);
-    console.log('Set deck preview image.');
+    await captureAndUpload(projectDir, ws, castleJson);
 }
 export async function savePreviewIfNeeded(dir, wsPort) {
     const projectDir = path.resolve(dir);
-    if (fs.existsSync(path.join(projectDir, 'preview.png'))) {
+    if (fs.existsSync(path.join(projectDir, 'preview.png')))
         return;
-    }
     let ws;
     try {
         ws = await connectWS(wsPort);
         await waitForRestart(ws);
-        const base64 = await takeScreenshot(ws);
-        ws.close();
-        const castleJsonPath = path.join(projectDir, 'castle.json');
-        if (!fs.existsSync(castleJsonPath))
+        const castleJson = readCastleJson(projectDir);
+        if (!castleJson) {
+            ws.close();
             return;
-        const castleJson = JSON.parse(fs.readFileSync(castleJsonPath, 'utf-8'));
-        fs.writeFileSync(path.join(projectDir, 'preview.png'), Buffer.from(base64, 'base64'));
-        console.log('Saved preview.png');
-        const file = await api.uploadBase64(base64, 'preview.png');
-        await api.updateCardCustomBackgroundImage(castleJson.cardId, file.fileId);
-        console.log('Set deck preview image.');
+        }
+        await captureAndUpload(projectDir, ws, castleJson);
     }
     catch (e) {
         if (ws)
             ws.close();
-        console.log(`Preview skipped: ${e?.message ?? e}`);
+        const msg = e instanceof Error ? e.message : String(e);
+        console.log(`Preview skipped: ${msg}`);
     }
 }

package/dist/save-deck.d.ts ADDED Viewed

	@@ -0,0 +1,2 @@
1	+ export declare function archiveSource(projectDir: string): Promise<Buffer>;
2	+ export declare function saveDeck(dir: string): Promise<void>;

package/dist/{push.js → save-deck.js} RENAMED Viewed

@@ -1,9 +1,67 @@
 import * as fs from 'fs';
+import * as os from 'os';
 import * as path from 'path';
+import { spawn } from 'child_process';
 import { nanoid } from 'nanoid';
 import * as api from './api.js';
 import * as config from './config.js';
 import { bundleProject } from './bundle.js';
+const SOURCE_ARCHIVE_EXCLUDES = ['node_modules', 'dist', '.castle', '.git'];
+export function archiveSource(projectDir) {
+    return new Promise((resolve, reject) => {
+        const tmpFile = path.join(os.tmpdir(), `castle-source-${nanoid(8)}.tar.gz`);
+        const args = ['-czf', tmpFile];
+        for (const ex of SOURCE_ARCHIVE_EXCLUDES)
+            args.push(`--exclude=./${ex}`);
+        args.push('-C', projectDir, '.');
+        const child = spawn('tar', args, { stdio: ['ignore', 'ignore', 'pipe'] });
+        let stderr = '';
+        child.stderr?.on('data', (chunk) => { stderr += chunk.toString(); });
+        child.on('error', reject);
+        child.on('close', (code) => {
+            if (code !== 0) {
+                try {
+                    fs.unlinkSync(tmpFile);
+                }
+                catch { /* nothing to clean */ }
+                reject(new Error(`tar exited with code ${code}: ${stderr}`));
+                return;
+            }
+            try {
+                const buf = fs.readFileSync(tmpFile);
+                fs.unlinkSync(tmpFile);
+                resolve(buf);
+            }
+            catch (e) {
+                reject(e instanceof Error ? e : new Error(String(e)));
+            }
+        });
+    });
+}
+async function uploadSource(projectDir, deckId) {
+    const archive = await archiveSource(projectDir);
+    const sizeKB = archive.length / 1024;
+    console.log(`Source archive: ${sizeKB.toFixed(1)}KB`);
+    const uploadConfig = await api.createWebDeckSourceUploadConfig(deckId);
+    const formData = new FormData();
+    formData.append('Content-Type', 'application/gzip');
+    for (const [k, v] of Object.entries(uploadConfig.postFields)) {
+        formData.append(k, String(v));
+    }
+    // FormData expects a Blob; copy the Buffer's bytes so we don't share the underlying ArrayBuffer.
+    const view = new Uint8Array(archive.byteLength);
+    view.set(archive);
+    formData.append('file', new Blob([view], { type: 'application/gzip' }));
+    const s3Res = await fetch(uploadConfig.postUrl, {
+        method: 'POST',
+        body: formData,
+        signal: AbortSignal.timeout(60000),
+    });
+    if (s3Res.status >= 300) {
+        throw new Error(`Source upload failed: HTTP ${s3Res.status}`);
+    }
+    await api.saveWebDeckSource(deckId, uploadConfig.uploadId);
+}
 function readCastleJson(dir) {
     const p = path.join(dir, 'castle.json');
     if (!fs.existsSync(p))
@@ -27,7 +85,7 @@ function buildSceneData(bundle) {
         },
     };
 }
-export async function push(dir) {
+export async function saveDeck(dir) {
     if (!config.getToken()) {
         console.error('Not logged in. Run `castle-web login` first.');
         process.exit(1);
@@ -37,7 +95,7 @@ export async function push(dir) {
         console.error(`No index.html found in ${projectDir}`);
         process.exit(1);
     }
-    let castleJson = readCastleJson(projectDir);
+    const castleJson = readCastleJson(projectDir);
     console.log('Bundling...');
     const bundle = await bundleProject(projectDir);
     const sizeKB = bundle.length / 1024;
@@ -59,7 +117,7 @@ export async function push(dir) {
     const formData = new FormData();
     formData.append('Content-Type', 'application/json');
     for (const [k, v] of Object.entries(uploadConfig.postFields)) {
-        formData.append(k, `${v}`);
+        formData.append(k, String(v));
     }
     formData.append('file', new Blob([JSON.stringify(sceneData)]));
     const s3Res = await fetch(uploadConfig.postUrl, {
@@ -80,8 +138,11 @@ export async function push(dir) {
             console.log(`Created deck "${title}" (${result.deckId}). Saved castle.json.`);
         }
         else {
-            console.log('Pushed to Castle.');
+            console.log('Saved to Castle.');
         }
+        console.log('Uploading source archive...');
+        await uploadSource(projectDir, result.deckId);
+        console.log('Source archive saved.');
     }
     catch (e) {
         const code = e?.extensions?.code ?? '';
@@ -89,7 +150,7 @@ export async function push(dir) {
             console.error('Not logged in. Run `castle-web login` first.');
         }
         else if (code === 'DECK_INVALID_PERMISSIONS') {
-            console.error('You do not have permission to push to this deck.');
+            console.error('You do not have permission to save this deck.');
         }
         else {
             throw e;

package/dist/serve.d.ts CHANGED Viewed

@@ -1,4 +1,6 @@
 export declare function serve(dir: string, options?: {
     port?: string;
+    host?: string;
     open?: boolean;
+    detach?: boolean;
 }): Promise<void>;