castle-web-cli 0.4.120 → 0.4.122

package/dist/editorConfig.d.ts

@@ -15,11 +15,16 @@ export interface FileTypeConfig {
     new?: string;
     icon?: string;
     editor?: string;
-    data?: boolean;
+    data?: boolean | DataMode;
     unsupported?: string;
 }
+export type DataMode = 'json' | 'text';
+export declare function dataModeOf(type: {
+    data?: boolean | DataMode;
+}): DataMode | null;
 export interface ResolvedFileType extends FileTypeConfig {
     from?: string;
+    module?: string;
 }
 export interface EditorConfig {
     initialPanels?: InitialPanel[];

package/dist/editorConfig.js

@@ -17,6 +17,13 @@ import * as fs from 'fs';
 import * as path from 'path';
 import { readCastleJson } from './castleJson.js';
 import { IMPORTS_DIR } from './imports.js';
+export function dataModeOf(type) {
+    if (type.data === true)
+        return 'json';
+    if (type.data === 'json' || type.data === 'text')
+        return type.data;
+    return null;
+}
 // An array with no usable entries stays an (empty) array rather than becoming
 // undefined: "I declare no file types" is a real answer, distinct from "I say
 // nothing about file types", and only the second one defers to the imports.
@@ -121,5 +128,17 @@ export function resolveFileTypes(deckDir) {
         if (imported)
             add(imported, alias);
     }
-    return anyDeclared ? [...byExt.values()] : null;
+    if (!anyDeclared)
+        return null;
+    // Rewrite each declared editor path so it is addressable from the DECK root.
+    // This is the whole routing decision: the deck's entry imports the named
+    // module, whoever declared it, instead of anything guessing which page owns
+    // the type.
+    for (const type of byExt.values()) {
+        if (!type.editor || type.editor === 'kit')
+            continue;
+        const declared = type.editor.replace(/^\.\//, '');
+        type.module = type.from ? `${IMPORTS_DIR}/${type.from}/${declared}` : declared;
+    }
+    return [...byExt.values()];
 }

package/dist/ide.d.ts

@@ -3,6 +3,7 @@ import { Duplex } from 'stream';
 import { type RawData } from 'ws';
 export declare const IDE_ASSET_PREFIX = "/__castle/ide/";
 export declare const PTY_WS_PATH = "/__castle/pty";
+export declare const VENDOR_PREFIX = "/__castle/vendor/";
 export declare const FAVICON_FILES: string[];
 export declare const FAVICON_LINK_TAGS: string;
 export declare const FILES_API_PREFIX = "/__castle/files/";

package/dist/ide.js

@@ -10,6 +10,7 @@ import * as fs from 'fs';
 import * as path from 'path';
 import picomatch from 'picomatch';
 import { fileURLToPath } from 'url';
+import { createRequire } from 'module';
 import { spawn as spawnPty } from '@lydell/node-pty';
 import headlessPkg from '@xterm/headless';
 import { SerializeAddon } from '@xterm/addon-serialize';
@@ -49,6 +50,32 @@ const SHELL_MIME = {
 function deckHasFile(deckDir, name) {
     return (fs.existsSync(path.join(deckDir, name)) || fs.existsSync(path.join(deckDir, 'public', name)));
 }
+// Serve a vendored library from the CLI's own dependencies. Resolved through
+// require rather than a path relative to dist/, so it works the same whether the
+// CLI runs from a checkout or from a global npm install.
+function serveVendorFile(res, asset) {
+    const spec = VENDOR_FILES[asset];
+    if (!spec) {
+        res.writeHead(404).end();
+        return true;
+    }
+    let filePath;
+    try {
+        filePath = createRequire(import.meta.url).resolve(spec);
+    }
+    catch {
+        res.writeHead(404).end();
+        return true;
+    }
+    res.writeHead(200, {
+        'content-type': 'text/javascript; charset=utf-8',
+        // Immutable for the session: the file only changes when the CLI does, and
+        // a capture shouldn't pay for re-fetching 194KB every time.
+        'cache-control': 'public, max-age=3600',
+    });
+    fs.createReadStream(filePath).pipe(res);
+    return true;
+}
 // Serve a file from the bundled shell dir, guarding against path traversal.
 function serveShellFile(res, asset) {
     const rel = path.normalize(asset).replace(/^(\.\.[/\\])+/, '');
@@ -75,6 +102,20 @@ function serveShellFile(res, asset) {
 // upgrade handler on Vite's HTTP server).
 export const IDE_ASSET_PREFIX = '/__castle/ide/';
 export const PTY_WS_PATH = '/__castle/pty';
+// Libraries the PLATFORM lends a deck at runtime, served from this serve's own
+// origin rather than fetched from a CDN.
+//
+// html2canvas is the only one so far: the SDK composites a card (canvas + the
+// deck's own DOM) with it to capture a cover. Serving it here instead of
+// bundling it into the SDK keeps it out of every published deck -- it is ~194KB
+// that only an editor ever runs, and a deck is bundled into a single file, so
+// bundling it could not be made lazy. And it removes a live failure: a CDN
+// import fails closed, silently downgrading a cover to canvas-only whenever the
+// network is slow, blocked, or absent.
+export const VENDOR_PREFIX = '/__castle/vendor/';
+const VENDOR_FILES = {
+    'html2canvas.js': 'html2canvas/dist/html2canvas.esm.js',
+};
 // Castle's favicon (the same files castle.xyz serves), shipped in the shell
 // bundle and also served from the origin root so every page under the serve
 // gets it -- the shell at `/`, the deck page at `/index.html`, and the
@@ -209,7 +250,9 @@ function listDeckFiles(deckDir) {
 // editors, and the builtin code editor renders everything.
 function kitEditorExtensions(config, fileTypes) {
     if (fileTypes) {
-        return fileTypes.filter((t) => t.editor === 'kit').map((t) => t.ext);
+        // ANY declared editor means "not the builtin code editor" -- the legacy
+        // "kit" (this deck's own dispatcher) and a named module both count.
+        return fileTypes.filter((t) => Boolean(t.editor)).map((t) => t.ext);
     }
     // A deck saved before file types existed named its kit extensions directly.
     return config.extensions ?? [];
@@ -941,6 +984,9 @@ export function createIdeServer(opts) {
         if (favicon && !deckHasFile(deckDir, favicon)) {
             return serveShellFile(res, favicon);
         }
+        if (reqPath.startsWith(VENDOR_PREFIX)) {
+            return serveVendorFile(res, reqPath.slice(VENDOR_PREFIX.length));
+        }
         if (reqPath.startsWith(IDE_ASSET_PREFIX)) {
             return serveShellFile(res, reqPath.slice(IDE_ASSET_PREFIX.length) || 'index.html');
         }

package/dist/init.js

@@ -37,7 +37,7 @@ const DEFAULT_KIT = 'physics-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.12';
+const PUBLISHED_SDK_VERSION = '0.4.13';
 // The account the first-party kits are (to be) published under, so a kit
 // imported from the CLI's copy is named the same as one fetched from the server.
 const KIT_AUTHOR = 'castle';