@bitmagic/cli 0.1.21 → 0.1.24

package/dist/commands/edit.js

@@ -1,148 +0,0 @@
-/**
- * `bitmagic edit` — `dev` plus a visual scene editor.
- *
- * Everything `dev` does (build, `tsc --watch`, vite) plus a loopback sidecar that serves the editor
- * shell and writes scene edits into `src/work/world.json`. Deliberately a superset rather than a
- * flag on `dev`: `dev` is the plain run-the-game loop and must stay offline, minimal and boring,
- * while `edit` opens a second port and a write path into the creator's project.
- */
-import { defineCommand } from 'citty';
-import { spawn, spawnSync } from 'child_process';
-import * as path from 'path';
-import { CliError } from '../errors.js';
-import { loadProjectContext, projectBin } from '../project/context.js';
-import { startEditorServer } from '../editor/server.js';
-import { CORS_ALLOWED_PORT_MAX, CORS_ALLOWED_PORT_MIN } from '../local-port.js';
-import { waitForServer } from '../verify/wait-for-server.js';
-const DEFAULT_GAME_PORT = 3010;
-const DEFAULT_EDITOR_PORT = 3011;
-/**
- * Both ports must sit inside the CDN's CORS window.
- *
- * The game port for the reason `local-port.ts` documents at length: a project fetches its forged
- * level and its GLBs cross-origin from the portal CDN, which allowlists `localhost:3000`-`3199`
- * and nothing else. Outside it the fetch is blocked, the world loads with no terrain, and the
- * symptom reads as a broken game rather than a blocked request.
- *
- * The editor port is checked too, even though the shell itself fetches nothing from the CDN,
- * because the two are adjacent by default and a creator who moves one will move the other — being
- * told the rule once, at the point of the mistake, beats discovering it as a terrain-less world.
- */
-function parsePort(value, fallback, flag) {
-    if (value === undefined)
-        return fallback;
-    const port = Number(value);
-    if (!Number.isInteger(port)) {
-        throw new CliError(`\`${flag}\` must be a whole number, got "${value}".`);
-    }
-    if (port < CORS_ALLOWED_PORT_MIN || port > CORS_ALLOWED_PORT_MAX) {
-        throw new CliError(`\`${flag}\` must be between ${CORS_ALLOWED_PORT_MIN} and ${CORS_ALLOWED_PORT_MAX}. `
-            + 'The asset CDN only allows those origins; outside that window the game loads with no terrain.');
-    }
-    return port;
-}
-export const editCommand = defineCommand({
-    meta: {
-        name: 'edit',
-        description: 'Serve the game with a visual scene editor, saving edits to world.json.',
-    },
-    args: {
-        port: { type: 'string', description: `Port to serve the game on (default ${DEFAULT_GAME_PORT}).` },
-        'editor-port': { type: 'string', description: `Port to serve the editor on (default ${DEFAULT_EDITOR_PORT}).` },
-    },
-    async run({ args }) {
-        const context = loadProjectContext();
-        const tsc = projectBin(context.root, 'tsc');
-        const vite = projectBin(context.root, 'vite');
-        const gamePort = parsePort(args.port, DEFAULT_GAME_PORT, '--port');
-        const editorPort = parsePort(args['editor-port'], DEFAULT_EDITOR_PORT, '--editor-port');
-        if (gamePort === editorPort) {
-            throw new CliError('`--port` and `--editor-port` must differ — the game and the editor are two servers.');
-        }
-        // Build to completion first, exactly as `dev` does: every alias resolves into dist/, so serving
-        // before the first emit 404s every module.
-        console.log('Building…');
-        const build = spawnSync(tsc, [], { cwd: context.root, stdio: 'inherit' });
-        if (build.error) {
-            throw new CliError(`Could not run the TypeScript compiler: ${build.error.message}`);
-        }
-        if (build.status !== 0) {
-            throw new CliError('Build failed. Fix the errors above, then run `bitmagic edit` again.', build.status ?? 1);
-        }
-        // Before the children, so a port clash fails fast rather than after vite has claimed its port.
-        const editor = await startEditorServer({
-            root: context.root,
-            metadata: context.metadata,
-            gameId: context.metadata.gameId,
-            gamePort,
-            port: editorPort,
-            log: (message) => console.log(message),
-        });
-        const children = [
-            {
-                name: 'tsc --watch',
-                process: spawn(tsc, ['--watch', '--preserveWatchOutput'], { cwd: context.root, stdio: 'inherit' }),
-            },
-            {
-                name: 'vite',
-                process: spawn(vite, ['--port', String(gamePort), '--strictPort'], { cwd: context.root, stdio: 'inherit' }),
-            },
-        ];
-        let shuttingDown = false;
-        let requestedByUser = false;
-        const shutdown = () => {
-            if (shuttingDown)
-                return;
-            shuttingDown = true;
-            for (const child of children)
-                child.process.kill('SIGTERM');
-            void editor.close();
-        };
-        process.on('SIGINT', () => {
-            requestedByUser = true;
-            shutdown();
-        });
-        process.on('SIGTERM', () => {
-            requestedByUser = true;
-            shutdown();
-        });
-        void waitForServer(gamePort, 30_000)
-            .then(() => {
-            console.log(`\nServing the game at ${`http://localhost:${gamePort}/`}`);
-            console.log(`Editor ready at      ${editor.url}`);
-            console.log('\nOpen the editor URL, click an object and drag the gizmo.');
-            console.log('Every change is saved to src/work/world.json.');
-            // Named on startup so the agent that launched this command knows where to look without
-            // being told — the journal is the only record of intentions the editor cannot carry out
-            // itself, and of who changed what.
-            console.log(`Editor actions are journalled to ${path.relative(context.root, editor.journalPath)}`);
-        })
-            .catch(() => {
-            // The child-exit watcher below reports a vite that never comes up.
-        });
-        const failure = await new Promise((resolve) => {
-            let exitedCount = 0;
-            for (const child of children) {
-                child.process.on('error', (error) => {
-                    shutdown();
-                    resolve({ name: child.name, detail: `could not start: ${error.message}` });
-                });
-                child.process.on('exit', (code, signal) => {
-                    exitedCount += 1;
-                    if (!requestedByUser && !shuttingDown) {
-                        shutdown();
-                        resolve({ name: child.name, detail: `exited with code ${code}${signal ? ` (signal ${signal})` : ''}` });
-                    }
-                    else if (exitedCount === children.length) {
-                        resolve(undefined);
-                    }
-                });
-            }
-        });
-        await editor.close();
-        if (failure) {
-            throw new CliError(`${failure.name} ${failure.detail}. \`bitmagic edit\` stopped.`);
-        }
-    },
-});
-//# sourceMappingURL=edit.js.map

package/dist/commands/edit.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"edit.js","sourceRoot":"","sources":["../../src/commands/edit.ts"],"names":[],"mappings":"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"}