@modularcloud/cspec 0.2.0 → 0.3.0

package/dist/cli.d.ts

@@ -2,5 +2,10 @@ export interface CliIo {
     stdout: Pick<NodeJS.WriteStream, "write">;
     stderr: Pick<NodeJS.WriteStream, "write">;
 }
-export declare function runCli(args: string[], io?: CliIo): Promise<void>;
+export interface CliRuntime {
+    appRoot?: string;
+    openBrowser?: (url: string) => Promise<void> | void;
+    workspaceRoot?: string;
+}
+export declare function runCli(args: string[], io?: CliIo, runtime?: CliRuntime): Promise<void>;
 //# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,KAAK;IACpB,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;IAC1C,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;CAC3C;AAED,wBAAsB,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,GAAE,KAA0D,GAAG,OAAO,CAAC,IAAI,CAAC,CA6B1H"}
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AAQA,MAAM,WAAW,KAAK;IACpB,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;IAC1C,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;CAC3C;AAED,MAAM,WAAW,UAAU;IACzB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IACpD,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,wBAAsB,MAAM,CAC1B,IAAI,EAAE,MAAM,EAAE,EACd,EAAE,GAAE,KAA0D,EAC9D,OAAO,GAAE,UAAe,GACvB,OAAO,CAAC,IAAI,CAAC,CAiCf"}

package/dist/cli.js

@@ -1,7 +1,10 @@
+import { spawn } from "node:child_process";
+import fs from "node:fs";
+import http from "node:http";
+import { fileURLToPath } from "node:url";
 import path from "node:path";
-import { formatError } from "./errors.js";
-import { assertFresh, loadWorkspace, writeOutputs } from "./workspace.js";
-export async function runCli(args, io = { stdout: process.stdout, stderr: process.stderr }) {
+import { assertFresh, discoverFiles, formatError, loadConfig, loadWorkspace, writeOutputs } from "@modularcloud/cspec-core";
+export async function runCli(args, io = { stdout: process.stdout, stderr: process.stderr }, runtime = {}) {
     const [command = "build", ...rest] = args;
     try {
         if (command === "build") {
@@ -21,8 +24,12 @@ export async function runCli(args, io = { stdout: process.stdout, stderr: proces
             io.stdout.write(formatIds(workspace, rest));
             return;
         }
+        if (command === "editor" || command === "edit") {
+            await launchEditor(rest, io, runtime);
+            return;
+        }
         if (command === "--help" || command === "-h") {
-            io.stdout.write("Usage: cspec <build|check|ids> [--tree|--json]\n");
+            io.stdout.write("Usage: cspec <build|check|ids|editor> [options]\n");
             return;
         }
         throw new Error(`Unknown command "${command}".`);
@@ -32,6 +39,322 @@ export async function runCli(args, io = { stdout: process.stdout, stderr: proces
         process.exitCode = 1;
     }
 }
+async function launchEditor(args, io, runtime) {
+    const options = parseEditorOptions(args);
+    if (options.help) {
+        io.stdout.write([
+            "Usage: cspec editor [--host <host>] [--port <port>] [--no-open]",
+            "",
+            "Launches the bundled cspec hybrid editor.",
+            "",
+            "Options:",
+            "  --host <host>  Hostname to bind. Defaults to 127.0.0.1.",
+            "  --port <port>  Port to bind. Defaults to 5173 and retries upward.",
+            "  --no-open      Print the URL without opening a browser.",
+            ""
+        ].join("\n"));
+        return;
+    }
+    const appRoot = runtime.appRoot ?? path.join(path.dirname(fileURLToPath(import.meta.url)), "editor");
+    if (!fs.existsSync(path.join(appRoot, "index.html"))) {
+        throw new Error("Bundled editor assets are missing. Rebuild the cspec package before running `cspec editor`.");
+    }
+    const workspaceRoot = path.resolve(runtime.workspaceRoot ?? process.cwd());
+    let editorOrigin = "";
+    const server = http.createServer((request, response) => {
+        if (isEditorApiRequest(request)) {
+            void serveEditorApi(workspaceRoot, editorOrigin, request, response);
+            return;
+        }
+        serveEditorAsset(appRoot, request, response);
+    });
+    const port = await listen(server, options.host, options.port);
+    const url = `http://${urlHost(options.host)}:${port}/`;
+    editorOrigin = url.slice(0, -1);
+    io.stdout.write(`cspec editor running at ${url}\n`);
+    io.stdout.write("Press Ctrl+C to stop.\n");
+    if (options.open) {
+        await (runtime.openBrowser ?? openBrowser)(url);
+    }
+}
+function isEditorApiRequest(request) {
+    return new URL(request.url ?? "/", "http://localhost").pathname.startsWith("/__cspec/");
+}
+async function serveEditorApi(workspaceRoot, editorOrigin, request, response) {
+    response.setHeader("Cache-Control", "no-store");
+    const method = request.method ?? "GET";
+    const pathname = new URL(request.url ?? "/", "http://localhost").pathname;
+    if (!isSameOriginRequest(request, editorOrigin)) {
+        writeJson(response, 403, { ok: false, error: "Forbidden" });
+        return;
+    }
+    try {
+        if (method === "GET" && pathname === "/__cspec/workspace") {
+            const config = await loadConfig(workspaceRoot);
+            const files = discoverFiles(workspaceRoot, config.specs).map((file) => ({
+                file: normalizeSlashes(path.relative(workspaceRoot, file)),
+                source: fs.readFileSync(file, "utf8")
+            }));
+            writeJson(response, 200, {
+                ok: true,
+                root: workspaceRoot,
+                files
+            });
+            return;
+        }
+        if (method === "POST" && pathname === "/__cspec/files") {
+            const body = await readJsonBody(request);
+            const file = objectString(body, "file");
+            const source = objectString(body, "source");
+            if (!file.endsWith(".mdx"))
+                throw new Error("Only .mdx source files can be saved through this endpoint.");
+            const target = workspacePath(workspaceRoot, file);
+            fs.mkdirSync(path.dirname(target), { recursive: true });
+            fs.writeFileSync(target, source);
+            writeJson(response, 200, { ok: true, file });
+            return;
+        }
+        if (method === "POST" && pathname === "/__cspec/outputs") {
+            const body = await readJsonBody(request);
+            const outputs = objectArray(body, "outputs");
+            for (const output of outputs) {
+                const file = objectString(output, "file");
+                const content = objectString(output, "content");
+                if (!file.endsWith(".cspec.ts") && !file.endsWith(".md")) {
+                    throw new Error(`Refusing to write unsupported output "${file}".`);
+                }
+                const target = workspacePath(workspaceRoot, file);
+                fs.mkdirSync(path.dirname(target), { recursive: true });
+                fs.writeFileSync(target, content);
+            }
+            writeJson(response, 200, { ok: true, count: outputs.length });
+            return;
+        }
+        writeJson(response, 404, { ok: false, error: "Not found" });
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        writeJson(response, 400, { ok: false, error: message });
+    }
+}
+function isSameOriginRequest(request, editorOrigin) {
+    const origin = request.headers.origin;
+    return !origin || !editorOrigin || origin === editorOrigin;
+}
+async function readJsonBody(request) {
+    let body = "";
+    for await (const chunk of request) {
+        body += chunk;
+        if (body.length > 20 * 1024 * 1024)
+            throw new Error("Request body is too large.");
+    }
+    try {
+        return JSON.parse(body);
+    }
+    catch {
+        throw new Error("Request body must be valid JSON.");
+    }
+}
+function objectString(value, key) {
+    if (!isRecord(value) || typeof value[key] !== "string") {
+        throw new Error(`Missing string field "${key}".`);
+    }
+    return value[key];
+}
+function objectArray(value, key) {
+    if (!isRecord(value) || !Array.isArray(value[key])) {
+        throw new Error(`Missing array field "${key}".`);
+    }
+    return value[key];
+}
+function isRecord(value) {
+    return typeof value === "object" && value !== null;
+}
+function workspacePath(workspaceRoot, file) {
+    if (path.isAbsolute(file) || file.includes("\0"))
+        throw new Error(`Invalid workspace path "${file}".`);
+    const target = path.resolve(workspaceRoot, file);
+    if (!isInside(workspaceRoot, target))
+        throw new Error(`Path escapes workspace: ${file}`);
+    return target;
+}
+function normalizeSlashes(value) {
+    return value.split(path.sep).join("/");
+}
+function writeJson(response, status, value) {
+    response.writeHead(status, { "Content-Type": "application/json; charset=utf-8" });
+    response.end(JSON.stringify(value));
+}
+function parseEditorOptions(args) {
+    const options = {
+        help: false,
+        host: "127.0.0.1",
+        open: true,
+        port: 5173
+    };
+    for (let index = 0; index < args.length; index += 1) {
+        const arg = args[index];
+        if (arg === "--help" || arg === "-h") {
+            options.help = true;
+            continue;
+        }
+        if (arg === "--no-open") {
+            options.open = false;
+            continue;
+        }
+        if (arg === "--open") {
+            options.open = true;
+            continue;
+        }
+        if (arg === "--host") {
+            options.host = requiredValue(args, index, arg);
+            index += 1;
+            continue;
+        }
+        if (arg?.startsWith("--host=")) {
+            options.host = arg.slice("--host=".length);
+            continue;
+        }
+        if (arg === "--port") {
+            options.port = parsePort(requiredValue(args, index, arg));
+            index += 1;
+            continue;
+        }
+        if (arg?.startsWith("--port=")) {
+            options.port = parsePort(arg.slice("--port=".length));
+            continue;
+        }
+        throw new Error(`Unknown editor option "${arg}".`);
+    }
+    return options;
+}
+function requiredValue(args, index, name) {
+    const value = args[index + 1];
+    if (!value || value.startsWith("-"))
+        throw new Error(`${name} requires a value.`);
+    return value;
+}
+function parsePort(value) {
+    const port = Number(value);
+    if (!Number.isInteger(port) || port < 0 || port > 65535) {
+        throw new Error(`Invalid port "${value}".`);
+    }
+    return port;
+}
+async function listen(server, host, startPort) {
+    let port = startPort;
+    while (port <= 65535) {
+        try {
+            await new Promise((resolve, reject) => {
+                const onError = (error) => {
+                    server.off("listening", onListening);
+                    reject(error);
+                };
+                const onListening = () => {
+                    server.off("error", onError);
+                    resolve();
+                };
+                server.once("error", onError);
+                server.once("listening", onListening);
+                server.listen(port, host);
+            });
+            const address = server.address();
+            return typeof address === "object" && address ? address.port : port;
+        }
+        catch (error) {
+            const err = error;
+            if (startPort !== 0 && err.code === "EADDRINUSE") {
+                port += 1;
+                continue;
+            }
+            throw error;
+        }
+    }
+    throw new Error(`No available port found at or above ${startPort}.`);
+}
+function serveEditorAsset(appRoot, request, response) {
+    const method = request.method ?? "GET";
+    if (method !== "GET" && method !== "HEAD") {
+        response.writeHead(405, { Allow: "GET, HEAD" });
+        response.end();
+        return;
+    }
+    let pathname;
+    try {
+        pathname = decodeURIComponent(new URL(request.url ?? "/", "http://localhost").pathname);
+    }
+    catch {
+        response.writeHead(400);
+        response.end("Bad request");
+        return;
+    }
+    const relative = pathname === "/" ? "index.html" : pathname.replace(/^\/+/, "");
+    const filePath = path.resolve(appRoot, relative);
+    if (!isInside(appRoot, filePath)) {
+        response.writeHead(403);
+        response.end("Forbidden");
+        return;
+    }
+    fs.readFile(filePath, (error, content) => {
+        if (error) {
+            if (error.code === "ENOENT" && !path.extname(pathname)) {
+                serveIndex(appRoot, response, method);
+                return;
+            }
+            response.writeHead(error.code === "ENOENT" ? 404 : 500);
+            response.end(error.code === "ENOENT" ? "Not found" : "Server error");
+            return;
+        }
+        response.writeHead(200, { "Content-Type": contentType(filePath) });
+        response.end(method === "HEAD" ? undefined : content);
+    });
+}
+function serveIndex(appRoot, response, method) {
+    fs.readFile(path.join(appRoot, "index.html"), (error, content) => {
+        if (error) {
+            response.writeHead(500);
+            response.end("Server error");
+            return;
+        }
+        response.writeHead(200, { "Content-Type": "text/html; charset=utf-8" });
+        response.end(method === "HEAD" ? undefined : content);
+    });
+}
+function isInside(root, filePath) {
+    const relative = path.relative(path.resolve(root), filePath);
+    return relative === "" || (!relative.startsWith("..") && !path.isAbsolute(relative));
+}
+function contentType(file) {
+    const type = {
+        ".css": "text/css; charset=utf-8",
+        ".html": "text/html; charset=utf-8",
+        ".ico": "image/x-icon",
+        ".js": "text/javascript; charset=utf-8",
+        ".json": "application/json; charset=utf-8",
+        ".map": "application/json; charset=utf-8",
+        ".png": "image/png",
+        ".svg": "image/svg+xml",
+        ".wasm": "application/wasm"
+    }[path.extname(file)];
+    return type ?? "application/octet-stream";
+}
+function urlHost(host) {
+    if (host === "0.0.0.0" || host === "::")
+        return "127.0.0.1";
+    return host.includes(":") ? `[${host}]` : host;
+}
+function openBrowser(url) {
+    const platform = process.platform;
+    const command = platform === "darwin" ? "open" : platform === "win32" ? "cmd" : "xdg-open";
+    const args = platform === "win32" ? ["/c", "start", "", url] : [url];
+    const child = spawn(command, args, {
+        detached: true,
+        stdio: "ignore",
+        windowsHide: true
+    });
+    child.on("error", () => { });
+    child.unref();
+}
 function formatIds(workspace, args) {
     if (args.includes("--json")) {
         return `${JSON.stringify({

package/dist/editor/assets/index-BV-lxU2y.css

@@ -0,0 +1 @@
+:root{color:#1f2933;background:#f4f6f8;font-family:Inter,ui-sans-serif,system-ui,-apple-system,BlinkMacSystemFont,Segoe UI,sans-serif}*{box-sizing:border-box}body{margin:0}button,input{font:inherit}.app{display:grid;grid-template-columns:260px minmax(0,1fr);height:100vh;overflow:hidden}.sidebar{display:grid;grid-template-rows:auto auto minmax(0,1fr);border-right:1px solid #d9e1e8;background:#fff;min-width:0}.sidebarHeader,.toolbar,.tabs,.statusbar,.paneHeader{display:flex;align-items:center}.sidebarHeader{justify-content:space-between;padding:10px;border-bottom:1px solid #e5ebf0}.iconButton{display:grid;place-items:center;width:32px;height:32px;border:1px solid #ccd7e0;border-radius:6px;background:#fff;color:#31475c;cursor:pointer}.filter{display:flex;align-items:center;gap:8px;margin:10px;padding:8px 9px;border:1px solid #d8e1e8;border-radius:6px;background:#f8fafc}.filter input{min-width:0;width:100%;border:0;outline:0;background:transparent}.fileTree{overflow:auto;padding:4px 8px 10px}.fileItem{display:grid;grid-template-columns:auto minmax(0,1fr) auto auto;align-items:center;gap:8px;width:100%;min-height:34px;border:0;border-radius:6px;background:transparent;color:#2a3a48;cursor:pointer;text-align:left}.fileItem span{overflow:hidden;text-overflow:ellipsis;white-space:nowrap}.fileItem.active{background:#e8f1ff;color:#17345f}.dot{width:8px;height:8px;border-radius:50%;background:#e49b23}.errorIcon{color:#c24141}.workspace{display:grid;grid-template-rows:auto minmax(0,1fr) 190px auto;min-width:0;min-height:0}.toolbar{justify-content:space-between;gap:16px;height:50px;padding:0 14px;border-bottom:1px solid #d9e1e8;background:#fff}.titleCluster,.toolbarActions{display:flex;align-items:center;gap:8px;min-width:0}.titleCluster strong{overflow:hidden;text-overflow:ellipsis;white-space:nowrap}.toolbarActions button,.tabs button{display:inline-flex;align-items:center;gap:7px;min-height:32px;border:1px solid #ccd7e0;border-radius:6px;background:#fff;color:#263947;cursor:pointer}.toolbarActions button{padding:0 10px}.editorGrid{display:grid;grid-template-columns:minmax(0,1.25fr) minmax(300px,.75fr);min-width:0;min-height:0}.editorPane,.previewPane{min-width:0;min-height:0;overflow:hidden}.editorPane{border-right:1px solid #d9e1e8;background:#fff}.cmHost{height:100%}.previewPane{display:grid;grid-template-rows:auto minmax(0,1fr);background:#fbfcfd}.paneHeader{gap:8px;height:38px;padding:0 12px;border-bottom:1px solid #e3e9ef;color:#435566;font-size:13px;font-weight:700}.previewPane pre,.buildOutput{margin:0;padding:14px;overflow:auto;white-space:pre-wrap;font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;font-size:13px;line-height:1.5}.emptyState{display:flex;align-items:center;gap:8px;padding:14px;color:#8a4a18}.bottomPanel{display:grid;grid-template-rows:auto minmax(0,1fr);border-top:1px solid #d9e1e8;background:#fff;min-height:0}.tabs{gap:6px;padding:8px 10px;border-bottom:1px solid #e3e9ef}.tabs button{padding:0 9px}.tabs button.selected{background:#eef5ff;border-color:#9dbbe0;color:#17345f}.panelList,.referenceGrid{overflow:auto;padding:8px 10px}.panelList button,.referenceGrid button{display:grid;grid-template-columns:auto minmax(0,1fr) minmax(0,1.25fr);align-items:center;gap:9px;width:100%;min-height:32px;border:0;border-radius:6px;background:transparent;text-align:left;cursor:pointer}.panelList button:hover,.referenceGrid button:hover{background:#f1f5f9}.panelList p{margin:8px 2px;color:#536575}.referenceGrid{display:grid;grid-template-columns:repeat(auto-fill,minmax(280px,1fr));gap:4px 10px}.referenceGrid button{grid-template-columns:auto minmax(0,1fr)}.referenceGrid small{grid-column:2;color:#697b8d}.statusbar{gap:14px;min-height:28px;padding:0 12px;border-top:1px solid #d9e1e8;background:#263947;color:#ecf3f8;font-size:12px}@media(max-width:900px){.app{grid-template-columns:210px minmax(0,1fr)}.editorGrid{grid-template-columns:1fr}.previewPane{display:none}.toolbar{align-items:stretch;flex-direction:column;height:auto;padding:8px}.toolbarActions{flex-wrap:wrap}}