fluidcad 0.0.33 → 0.0.34

package/server/dist/routes/screenshot.js

@@ -1,8 +1,13 @@
 import { Router } from 'express';
+const NAMED_VIEWS = new Set([
+    'front', 'back', 'left', 'right', 'top', 'bottom',
+    'iso-ftr', 'iso-fbr', 'iso-ftl', 'iso-fbl',
+    'iso-btr', 'iso-bbr', 'iso-btl', 'iso-bbl',
+]);
 export function createScreenshotRouter(requestScreenshot) {
     const router = Router();
     router.post('/screenshot', async (req, res) => {
-        const { width, height, showGrid, showAxes, transparent, autoCrop, fitToModel, margin } = req.body;
+        const { width, height, showGrid, showAxes, transparent, autoCrop, fitToModel, margin, view, multi, } = req.body;
         const options = {};
         if (width !== undefined) {
             if (typeof width !== 'number' || width < 1 || width > 8192) {
@@ -60,6 +65,21 @@ export function createScreenshotRouter(requestScreenshot) {
             }
             options.margin = margin;
         }
+        if (multi !== undefined) {
+            if (typeof multi !== 'boolean') {
+                res.status(400).json({ error: 'multi must be a boolean.' });
+                return;
+            }
+            options.multi = multi;
+        }
+        if (view !== undefined) {
+            const validated = validateView(view);
+            if (typeof validated === 'string') {
+                res.status(400).json({ error: validated });
+                return;
+            }
+            options.view = validated;
+        }
         try {
             const png = await requestScreenshot(options);
             res.setHeader('Content-Type', 'image/png');
@@ -74,3 +94,50 @@ export function createScreenshotRouter(requestScreenshot) {
     });
     return router;
 }
+/** Validate the `view` payload. Returns the parsed view on success or an
+ *  error-message string on failure. */
+function validateView(raw) {
+    if (raw === null || typeof raw !== 'object') {
+        return 'view must be an object.';
+    }
+    const v = raw;
+    switch (v.kind) {
+        case 'current':
+            return { kind: 'current' };
+        case 'named': {
+            if (typeof v.name !== 'string' || !NAMED_VIEWS.has(v.name)) {
+                return `view.name must be one of: ${Array.from(NAMED_VIEWS).join(', ')}.`;
+            }
+            return { kind: 'named', name: v.name };
+        }
+        case 'orbit-from-current': {
+            if (typeof v.azimuthDeg !== 'number' || !Number.isFinite(v.azimuthDeg)) {
+                return 'view.azimuthDeg must be a finite number.';
+            }
+            if (typeof v.elevationDeg !== 'number' || !Number.isFinite(v.elevationDeg)) {
+                return 'view.elevationDeg must be a finite number.';
+            }
+            return { kind: 'orbit-from-current', azimuthDeg: v.azimuthDeg, elevationDeg: v.elevationDeg };
+        }
+        case 'look-from': {
+            if (!isVec3(v.eye)) {
+                return 'view.eye must be a 3-element array of finite numbers.';
+            }
+            if (v.target !== undefined && !isVec3(v.target)) {
+                return 'view.target must be a 3-element array of finite numbers when provided.';
+            }
+            return {
+                kind: 'look-from',
+                eye: v.eye,
+                target: v.target,
+            };
+        }
+        default:
+            return `view.kind must be one of: current, named, orbit-from-current, look-from.`;
+    }
+}
+function isVec3(value) {
+    return (Array.isArray(value) &&
+        value.length === 3 &&
+        value.every((n) => typeof n === 'number' && Number.isFinite(n)));
+}

package/server/dist/ws-protocol.d.ts

@@ -40,7 +40,16 @@ export type ExportSceneMessage = {
         customAngularDeflectionDeg?: number;
     };
 };
-export type ExtensionMessage = ProcessFileMessage | LiveUpdateMessage | RollbackMessage | ImportFileMessage | HighlightShapeMessage | ClearHighlightMessage | ShowShapePropertiesMessage | ExportSceneMessage;
+/**
+ * Sent by the editor extension whenever its dirty-buffer set changes. Paths
+ * are absolute and normalized to the same scheme the server uses elsewhere.
+ * Replaces the cached set on the server — not incremental.
+ */
+export type EditorDirtyStateMessage = {
+    type: 'editor-dirty-state';
+    dirtyFiles: string[];
+};
+export type ExtensionMessage = ProcessFileMessage | LiveUpdateMessage | RollbackMessage | ImportFileMessage | HighlightShapeMessage | ClearHighlightMessage | ShowShapePropertiesMessage | ExportSceneMessage | EditorDirtyStateMessage;
 export type ReadyMessage = {
     type: 'ready';
     port: number;
@@ -162,6 +171,21 @@ export type UIInitCompleteMessage = {
 export type UIProcessingFileMessage = {
     type: 'processing-file';
 };
+export type NamedView = 'front' | 'back' | 'left' | 'right' | 'top' | 'bottom' | 'iso-ftr' | 'iso-fbr' | 'iso-ftl' | 'iso-fbl' | 'iso-btr' | 'iso-bbr' | 'iso-btl' | 'iso-bbl';
+export type ScreenshotView = {
+    kind: 'current';
+} | {
+    kind: 'named';
+    name: NamedView;
+} | {
+    kind: 'orbit-from-current';
+    azimuthDeg: number;
+    elevationDeg: number;
+} | {
+    kind: 'look-from';
+    eye: [number, number, number];
+    target?: [number, number, number];
+};
 export type UITakeScreenshotMessage = {
     type: 'take-screenshot';
     requestId: string;
@@ -173,6 +197,36 @@ export type UITakeScreenshotMessage = {
         transparent?: boolean;
         autoCrop?: boolean;
         margin?: number;
+        view?: ScreenshotView;
+        multi?: boolean;
     };
 };
-export type ServerToUIMessage = UIInitCompleteMessage | UIProcessingFileMessage | UISceneRenderedMessage | UIHighlightShapeMessage | UIClearHighlightMessage | UIShowShapePropertiesMessage | UITakeScreenshotMessage;
+/**
+ * Lifecycle ping for a render pass. Emitted at the start of every render and
+ * again on completion (state: 'end') or compile failure (state: 'error').
+ * Intermediate renders are cancelled at the server boundary, so only the
+ * latest `version` ever emits an `end`/`error`. Used by MCP coordination tools
+ * to wait deterministically instead of sleeping.
+ */
+export type UIRenderVersionMessage = {
+    type: 'render-version';
+    version: number;
+    state: 'start' | 'end' | 'error';
+    absPath?: string;
+};
+export type ServerToUIMessage = UIInitCompleteMessage | UIProcessingFileMessage | UISceneRenderedMessage | UIHighlightShapeMessage | UIClearHighlightMessage | UIShowShapePropertiesMessage | UITakeScreenshotMessage | UIRenderVersionMessage;
+export type CameraStateMessage = {
+    type: 'camera-state';
+    position: [number, number, number];
+    target: [number, number, number];
+    up: [number, number, number];
+    projection: 'orthographic' | 'perspective';
+};
+export type ScreenshotResultMessage = {
+    type: 'screenshot-result';
+    requestId: string;
+    success: boolean;
+    data?: string;
+    error?: string;
+};
+export type UIToServerMessage = CameraStateMessage | ScreenshotResultMessage;