fluidcad 0.0.35 → 0.0.37

package/llm-docs/index.json

@@ -1,6 +1,6 @@
 {
   "schemaVersion": 1,
-  "generatedAt": "2026-05-29T18:50:46.977Z",
+  "generatedAt": "2026-06-12T18:19:00.445Z",
   "docs": [
     {
       "id": "api/arc",
@@ -394,6 +394,27 @@
       "file": "api/fillet.md",
       "bodyLength": 1243
     },
+    {
+      "id": "api/helix",
+      "title": "helix(axis | source)",
+      "summary": "Creates a helical wire around an axis or derived from existing geometry (cylindrical/conical face, line or circular edge) — the path for springs, threads, and coils. Sweep a profile along it to make material.",
+      "tags": [
+        "api",
+        "3d",
+        "wire"
+      ],
+      "symbols": [
+        "helix"
+      ],
+      "seeAlso": [
+        "api/sweep",
+        "api/axis",
+        "api/select",
+        "api/types/helix"
+      ],
+      "file": "api/helix.md",
+      "bodyLength": 2133
+    },
     {
       "id": "api/line",
       "title": "line(end) / line(start, end)",
@@ -887,6 +908,27 @@
       "file": "api/tcircle.md",
       "bodyLength": 755
     },
+    {
+      "id": "api/text",
+      "title": "text(string) / text(plane, string) / text(string, path)",
+      "summary": "Renders a text string as sketch geometry — glyph outlines that extrude, wrap, or follow a path like any other profile.",
+      "tags": [
+        "api",
+        "2d",
+        "sketch"
+      ],
+      "symbols": [
+        "text"
+      ],
+      "seeAlso": [
+        "api/sketch",
+        "api/wrap",
+        "api/extrude",
+        "api/types/text"
+      ],
+      "file": "api/text.md",
+      "bodyLength": 1591
+    },
     {
       "id": "api/tline",
       "title": "tLine — tangent line",
@@ -1187,6 +1229,25 @@
       "file": "api/types/geometry.md",
       "bodyLength": 909
     },
+    {
+      "id": "api/types/helix",
+      "title": "Helix",
+      "summary": "A 3D helix wire — a single edge that traces a helix curve on a cylindrical or conical surface.",
+      "tags": [
+        "api",
+        "type",
+        "interface"
+      ],
+      "symbols": [
+        "Helix",
+        "IHelix"
+      ],
+      "seeAlso": [
+        "api/types/scene-object"
+      ],
+      "file": "api/types/helix.md",
+      "bodyLength": 2680
+    },
     {
       "id": "api/types/hline",
       "title": "HLine",
@@ -1585,6 +1646,25 @@
       "file": "api/types/tangent-arc-two-objects.md",
       "bodyLength": 847
     },
+    {
+      "id": "api/types/text",
+      "title": "Text",
+      "summary": "The Text type. Extends ExtrudableGeometry; adds 11 methods.",
+      "tags": [
+        "api",
+        "type",
+        "interface"
+      ],
+      "symbols": [
+        "Text",
+        "IText"
+      ],
+      "seeAlso": [
+        "api/types/extrudable-geometry"
+      ],
+      "file": "api/types/text.md",
+      "bodyLength": 4156
+    },
     {
       "id": "api/types/transformable",
       "title": "Transformable",
@@ -1684,6 +1764,46 @@
       "file": "api/types/vline.md",
       "bodyLength": 641
     },
+    {
+      "id": "api/types/wrap",
+      "title": "Wrap",
+      "summary": "The Wrap type. Extends BooleanOperation; adds 10 methods.",
+      "tags": [
+        "api",
+        "type",
+        "interface"
+      ],
+      "symbols": [
+        "Wrap",
+        "IWrap"
+      ],
+      "seeAlso": [
+        "api/types/boolean-operation"
+      ],
+      "file": "api/types/wrap.md",
+      "bodyLength": 3888
+    },
+    {
+      "id": "api/wrap",
+      "title": "wrap(thickness, sketch, face)",
+      "summary": "Develops a sketch onto a cylindrical or conical face and raises it by a thickness — embossed or engraved labels, logos, and features that follow a curved wall.",
+      "tags": [
+        "api",
+        "3d",
+        "solid"
+      ],
+      "symbols": [
+        "wrap"
+      ],
+      "seeAlso": [
+        "api/sketch",
+        "api/types/text",
+        "api/select",
+        "api/extrude"
+      ],
+      "file": "api/wrap.md",
+      "bodyLength": 2024
+    },
     {
       "id": "concepts/coordinate-system",
       "title": "Coordinate systems and sketch axes",

package/mcp/dist/server.js

@@ -11,7 +11,7 @@ import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js'
 import { z } from 'zod';
 import { listWorkspaces } from "./tools/workspaces.js";
 import { getApiSignature, getTypeDefinition, listDocs, readDoc, searchDocs, } from "./tools/docs.js";
-import { getCompileError, getEdgeProperties, getFaceProperties, getSceneSummary, getShapeProperties, hitTest, listShapes, } from "./tools/inspection.js";
+import { getCompileError, getEdgeProperties, getFaceProperties, getSceneSummary, getShapeProperties, hitTest, listShapes, measure, } from "./tools/inspection.js";
 import { getCameraState, screenshot, screenshotMulti, screenshotShape, } from "./tools/screenshot.js";
 import { waitForIdle } from "./tools/coordination.js";
 import { editRange, listFluidFiles, readFile, writeFile, } from "./tools/source.js";
@@ -186,6 +186,25 @@ export function buildServer(options = {}) {
             edgeIndex: edgeIndexArg,
         },
     }, async ({ workspace, shapeId, edgeIndex }) => toMcp(await getEdgeProperties({ workspace, shapeId, edgeIndex })));
+    const measureEntityArg = z.object({
+        shapeId: shapeIdArg,
+        kind: z.enum(['face', 'edge']).describe('Whether the index refers to a face or an edge of the shape.'),
+        index: z.number().int().nonnegative().describe('Zero-based face/edge index inside the shape.'),
+    });
+    server.registerTool('measure', {
+        title: 'Measure distances and angles between faces/edges',
+        description: 'Measures the selected faces/edges like a CAD measure tool. One entity returns its area/length; two entities ' +
+            'return min/max distance with their realizing points, plus parallel/center/axis distance and angle when the ' +
+            'geometry relation supports them. `primary` names the headline value. All lengths are mm, angles deg.',
+        inputSchema: {
+            ...workspaceArg,
+            entities: z
+                .array(measureEntityArg)
+                .min(1)
+                .max(8)
+                .describe('Faces/edges to measure (1-8). Pairwise measurements are computed when exactly 2 are given.'),
+        },
+    }, async ({ workspace, entities }) => toMcp(await measure({ workspace, entities })));
     const namedViewArg = z.enum([
         'front', 'back', 'left', 'right', 'top', 'bottom',
         'iso-ftr', 'iso-fbr', 'iso-ftl', 'iso-fbl',

package/mcp/dist/tools/inspection.d.ts

@@ -73,3 +73,20 @@ export declare function hitTest(input: HitTestInput): Promise<{
     ok: true;
     data: unknown;
 }>;
+export type MeasureEntityInput = {
+    shapeId: string;
+    kind: 'face' | 'edge';
+    index: number;
+};
+export type MeasureInput = WorkspaceArg & {
+    entities: MeasureEntityInput[];
+};
+export declare function measure(input: MeasureInput): Promise<{
+    ok: false;
+    code: import("../types.ts").ToolErrorCode;
+    message: string;
+    details?: unknown;
+} | {
+    ok: true;
+    data: unknown;
+}>;

package/mcp/dist/tools/inspection.js

@@ -114,6 +114,20 @@ export async function hitTest(input) {
     };
     return callWithClient(input, (client) => client.postJson('/api/hit-test', body));
 }
+export async function measure(input) {
+    const entities = input?.entities;
+    if (!Array.isArray(entities) || entities.length < 1 || entities.length > 8) {
+        return err('invalid-input', '`entities` must be an array of 1-8 face/edge references.');
+    }
+    for (const entity of entities) {
+        const validKind = entity?.kind === 'face' || entity?.kind === 'edge';
+        const validIndex = typeof entity?.index === 'number' && Number.isInteger(entity.index) && entity.index >= 0;
+        if (!entity || typeof entity.shapeId !== 'string' || !entity.shapeId || !validKind || !validIndex) {
+            return err('invalid-input', 'Each entity needs a `shapeId`, a `kind` (face|edge) and a non-negative `index`.');
+        }
+    }
+    return callWithClient(input, (client) => client.postJson('/api/measure', { entities }));
+}
 function isVec3(value) {
     return (Array.isArray(value) &&
         value.length === 3 &&

package/package.json

@@ -1,8 +1,9 @@
 {
   "name": "fluidcad",
-  "version": "0.0.35",
+  "version": "0.0.37",
   "description": "Parametric CAD modeling library using javascript",
   "author": "Marwan Aouida <contact@marwan.dev>",
+  "license": "MIT",
   "homepage": "https://fluidcad.io",
   "repository": {
     "type": "git",
@@ -69,10 +70,12 @@
     "commander": "^14.0.3",
     "esbuild": "^0.27.7",
     "express": "^5.2.1",
+    "fontkit": "^2.0.4",
+    "get-system-fonts": "^2.0.2",
+    "iconoir": "^7.11.0",
     "ignore": "^5.3.2",
     "jszip": "^3.10.1",
-    "iconoir": "^7.11.0",
-    "occjs-wrapper": "npm:occjs-fluidcad@9.0.0",
+    "ocjs-fluidcad": "^1.1.0",
     "open": "^11.0.0",
     "stacktrace-parser": "^0.1.11",
     "tree-sitter-wasms": "^0.1.13",
@@ -87,6 +90,7 @@
     "@tabler/icons": "^3.40.0",
     "@tailwindcss/vite": "^4.2.2",
     "@types/express": "^5.0.6",
+    "@types/fontkit": "^2.0.9",
     "@types/js-yaml": "^4.0.9",
     "@types/node": "^22.14.1",
     "@types/three": "^0.180.0",

package/server/dist/fluidcad-server.d.ts

@@ -11,6 +11,11 @@ type SceneManager = {
     getShapeProperties(scene: any, shapeId: string): any;
     getFaceProperties(scene: any, shapeId: string, faceIndex: number): any;
     getEdgeProperties(scene: any, shapeId: string, edgeIndex: number): any;
+    measure(scene: any, refs: {
+        shapeId: string;
+        kind: 'face' | 'edge';
+        index: number;
+    }[]): any;
     hitTest(scene: any, shapeId: string, rayOrigin: [number, number, number], rayDir: [number, number, number], edgeThreshold: number): any;
     exportShapes(scene: any, shapeIds: string[], options: {
         format: 'step' | 'stl';
@@ -115,6 +120,11 @@ export declare class FluidCadServer {
     getShapeProperties(shapeId: string): any;
     getFaceProperties(shapeId: string, faceIndex: number): any;
     getEdgeProperties(shapeId: string, edgeIndex: number): any;
+    measure(refs: {
+        shapeId: string;
+        kind: 'face' | 'edge';
+        index: number;
+    }[]): any;
     exportShapes(shapeIds: string[], options: {
         format: 'step' | 'stl';
         includeColors?: boolean;
@@ -125,6 +135,25 @@ export declare class FluidCadServer {
         data: string | Uint8Array;
         fileName: string;
     } | null;
+    /**
+     * Export every solid of a hub session's latest render. The session-keyed twin
+     * of `exportShapes` (which reads the desktop `currentFileName`): hub mode keys
+     * each render's scene by `sessionId`, so exporting/downloading from a hub
+     * session must look it up the same way — exactly why `hitTestForSession`
+     * exists. Gathers all solids itself ("download the whole model"); returns null
+     * when the session has no rendered scene or it holds no solids (the caller maps
+     * that to a "nothing to export" response).
+     */
+    exportShapesForSession(sessionId: string, options: {
+        format: 'step' | 'stl';
+        includeColors?: boolean;
+        resolution?: string;
+        customLinearDeflection?: number;
+        customAngularDeflectionDeg?: number;
+    }): {
+        data: string | Uint8Array;
+        fileName: string;
+    } | null;
     hitTest(shapeId: string, rayOrigin: [number, number, number], rayDir: [number, number, number], edgeThreshold: number): any;
     hitTestForSession(sessionId: string, shapeId: string, rayOrigin: [number, number, number], rayDir: [number, number, number], edgeThreshold: number): any;
     setCompileError(err: CompileError | null): void;

package/server/dist/fluidcad-server.js

@@ -285,6 +285,16 @@ export class FluidCadServer {
         }
         return this.sceneManager.getEdgeProperties(scene, shapeId, edgeIndex);
     }
+    measure(refs) {
+        if (!this.sceneManager) {
+            return null;
+        }
+        const scene = this.previousScenes.get(this.currentFileName);
+        if (!scene) {
+            return null;
+        }
+        return this.sceneManager.measure(scene, refs);
+    }
     exportShapes(shapeIds, options) {
         if (!this.sceneManager) {
             return null;
@@ -295,6 +305,36 @@ export class FluidCadServer {
         }
         return this.sceneManager.exportShapes(scene, shapeIds, options);
     }
+    /**
+     * Export every solid of a hub session's latest render. The session-keyed twin
+     * of `exportShapes` (which reads the desktop `currentFileName`): hub mode keys
+     * each render's scene by `sessionId`, so exporting/downloading from a hub
+     * session must look it up the same way — exactly why `hitTestForSession`
+     * exists. Gathers all solids itself ("download the whole model"); returns null
+     * when the session has no rendered scene or it holds no solids (the caller maps
+     * that to a "nothing to export" response).
+     */
+    exportShapesForSession(sessionId, options) {
+        if (!this.sceneManager) {
+            return null;
+        }
+        const scene = this.previousScenes.get(sessionId);
+        if (!scene) {
+            return null;
+        }
+        const shapeIds = [];
+        for (const obj of scene.getAllSceneObjects()) {
+            for (const shape of obj.getAddedShapes()) {
+                if (shape.isSolid()) {
+                    shapeIds.push(shape.id);
+                }
+            }
+        }
+        if (shapeIds.length === 0) {
+            return null;
+        }
+        return this.sceneManager.exportShapes(scene, shapeIds, options);
+    }
     hitTest(shapeId, rayOrigin, rayDir, edgeThreshold) {
         if (!this.sceneManager) {
             return null;

package/server/dist/index.js

@@ -7,6 +7,7 @@ import { createServerCore } from "./server-core.js";
 import { createPropertiesRouter } from "./routes/properties.js";
 import { createParamsRouter } from "./routes/params.js";
 import { createHitTestRouter } from "./routes/hit-test.js";
+import { createMeasureRouter } from "./routes/measure.js";
 import { createTimelineRouter } from "./routes/timeline.js";
 import { createSketchEditsRouter } from "./routes/sketch-edits.js";
 import { createExportRouter } from "./routes/export.js";
@@ -21,7 +22,7 @@ import { createPackRouter } from "./routes/pack.js";
 import { normalizePath } from "./normalize-path.js";
 import { writeInstanceFile, deleteInstanceFile } from "./instance-file.js";
 import { addInstance, removeInstance } from "./global-registry.js";
-import { extractSourceLocation } from '../../lib/dist/index.js';
+import { extractSourceLocation, describeOcException } from '../../lib/dist/index.js';
 const PORT = parseInt(process.env.FLUIDCAD_SERVER_PORT || '3100', 10);
 const WORKSPACE_PATH = normalizePath(process.env.FLUIDCAD_WORKSPACE_PATH || '');
 const UI_DIST = path.resolve(import.meta.dirname, '../../ui/dist');
@@ -72,6 +73,7 @@ app.use('/api', createHealthRouter({
 app.use('/api', createPropertiesRouter(fluidCadServer));
 app.use('/api', createParamsRouter(fluidCadServer, sendToExtension, broadcastToUI));
 app.use('/api', createHitTestRouter(fluidCadServer));
+app.use('/api', createMeasureRouter(fluidCadServer));
 app.use('/api', createTimelineRouter(fluidCadServer, sendToExtension, broadcastToUI));
 app.use('/api', createSketchEditsRouter(fluidCadServer, sendToExtension, WORKSPACE_PATH));
 app.use('/api', createExportRouter(fluidCadServer, WORKSPACE_PATH));
@@ -252,7 +254,7 @@ async function handleExtensionMessage(msg) {
                     sendToExtension({ type: 'import-complete', success: true });
                 }
                 catch (err) {
-                    sendToExtension({ type: 'error', message: err.stack || err.message || String(err) });
+                    sendToExtension({ type: 'error', message: describeOcException(err) });
                 }
                 break;
             }

package/server/dist/model-package/pack.js

@@ -116,12 +116,13 @@ async function collectImportAssetPaths(workspacePath) {
     await walk(workspacePath);
     return out.sort();
 }
-// Enforced on top of any `.gitignore`: dependency trees and prior pack outputs
-// (the latter would otherwise recurse into the next pack). `node_modules` is
-// also pruned during the walk for speed. Hidden dot-entries are excluded by the
-// walk directly (see below), so VCS metadata (`.git`) and secrets (`.env`) need
-// no pattern here.
-const ALWAYS_EXCLUDE = ['node_modules', '*.fluidpkg'];
+// Enforced on top of any `.gitignore`: dependency trees, prior pack outputs
+// (the latter would otherwise recurse into the next pack), and `fluidcad.json`
+// (the local hub binding — model id + name — which the hub already owns and
+// should never ship as model source). `node_modules` is also pruned during the
+// walk for speed. Hidden dot-entries are excluded by the walk directly (see
+// below), so VCS metadata (`.git`) and secrets (`.env`) need no pattern here.
+const ALWAYS_EXCLUDE = ['node_modules', '*.fluidpkg', 'fluidcad.json'];
 // `ignore` ships a CJS `module.exports = factory`, but its bundled types use
 // `export default`, which loses the call signature under `module: nodenext`.
 // Pin the factory's real signature; the runtime value is the callable factory.

package/server/dist/model-package/types.d.ts

@@ -43,9 +43,10 @@ export interface ModelPackageManifest {
      * brep/STEP) are NOT repeated here; `files` + `assets` is the whole package.
      *
      * Selection respects a root `.gitignore` (via the `ignore` package) and
-     * always excludes `node_modules`, prior `*.fluidpkg` outputs, and every
-     * hidden dot-entry (`.git`, `.env`, `.claude`, `.vscode`, … — never model
-     * content, may hold secrets), whether or not they're gitignored.
+     * always excludes `node_modules`, prior `*.fluidpkg` outputs, `fluidcad.json`
+     * (the local hub binding), and every hidden dot-entry (`.git`, `.env`,
+     * `.claude`, `.vscode`, … — never model content, may hold secrets), whether or
+     * not they're gitignored.
      */
     files: string[];
     params?: Record<string, ParamValue>;

package/server/dist/preferences.d.ts

@@ -1,8 +1,12 @@
+export type MeasureLengthUnit = 'mm' | 'cm' | 'm' | 'in';
+export type MeasureAngleUnit = 'deg' | 'rad';
 export interface Preferences {
     theme: string;
     showGrid: boolean;
     cameraMode: 'perspective' | 'orthographic';
     showBuildTimings: boolean;
+    measureLengthUnit: MeasureLengthUnit;
+    measureAngleUnit: MeasureAngleUnit;
 }
 export declare function loadPreferences(): Promise<Preferences>;
 export declare function savePreferences(prefs: Preferences): Promise<void>;

package/server/dist/preferences.js

@@ -6,6 +6,8 @@ const DEFAULTS = {
     showGrid: true,
     cameraMode: 'orthographic',
     showBuildTimings: false,
+    measureLengthUnit: 'mm',
+    measureAngleUnit: 'deg',
 };
 function getConfigDir() {
     const platform = process.platform;

package/server/dist/routes/measure.d.ts

@@ -0,0 +1,3 @@
+import { Router } from 'express';
+import type { FluidCadServer } from '../fluidcad-server.ts';
+export declare function createMeasureRouter(fluidCadServer: FluidCadServer): Router;

package/server/dist/routes/measure.js

@@ -0,0 +1,32 @@
+import { Router } from 'express';
+const MAX_ENTITIES = 8;
+export function createMeasureRouter(fluidCadServer) {
+    const router = Router();
+    router.post('/measure', (req, res) => {
+        const entities = req.body?.entities;
+        if (!Array.isArray(entities) || entities.length < 1 || entities.length > MAX_ENTITIES) {
+            res.status(400).json({ error: `entities must be an array of 1-${MAX_ENTITIES} face/edge references` });
+            return;
+        }
+        for (const entity of entities) {
+            const validKind = entity?.kind === 'face' || entity?.kind === 'edge';
+            const validIndex = Number.isInteger(entity?.index) && entity.index >= 0;
+            if (!entity || typeof entity.shapeId !== 'string' || !entity.shapeId || !validKind || !validIndex) {
+                res.status(400).json({ error: 'Each entity needs a shapeId, a kind (face|edge) and a non-negative index' });
+                return;
+            }
+        }
+        try {
+            const result = fluidCadServer.measure(entities);
+            if (!result) {
+                res.status(404).json({ error: 'Entity not found' });
+                return;
+            }
+            res.json(result);
+        }
+        catch (err) {
+            res.status(500).json({ error: err?.message ?? String(err) });
+        }
+    });
+    return router;
+}

package/server/dist/routes/preferences.js

@@ -27,6 +27,12 @@ export function createPreferencesRouter() {
             if (typeof body.showBuildTimings === 'boolean') {
                 current.showBuildTimings = body.showBuildTimings;
             }
+            if (['mm', 'cm', 'm', 'in'].includes(body.measureLengthUnit)) {
+                current.measureLengthUnit = body.measureLengthUnit;
+            }
+            if (['deg', 'rad'].includes(body.measureAngleUnit)) {
+                current.measureAngleUnit = body.measureAngleUnit;
+            }
             await savePreferences(current);
             res.json(current);
         }

package/server/dist/routes/sketch-edits.js

@@ -1,4 +1,5 @@
 import { Router } from 'express';
+import { describeOcException } from '../../../lib/dist/index.js';
 import { addBreakpoint, removeBreakpoint, toggleBreakpoint, clearBreakpoints, insertPoint, removePoint, addPick, removePick, setPickPoints, insertGeometryCallWithVariable, updateGeometryPosition, setLinePosition, setChainPositions, updateDimension, updateDimensionExpressionWithVariable, getDimensionExpression, extractVariablesInScope, setRectDimensions, } from "../code-editor.js";
 const NEW_VAR_NAME_RE = /^[a-zA-Z_$][\w$]*$/;
 function validateNewVariable(input) {
@@ -32,7 +33,7 @@ export function createSketchEditsRouter(fluidCadServer, sendToExtension, workspa
             await fluidCadServer.importFile(workspacePath, fileName, data);
         }
         catch (err) {
-            res.status(500).json({ error: err.message || String(err) });
+            res.status(500).json({ error: describeOcException(err) });
             return;
         }
         const loadName = fileName.replace(/\.(step|stp)$/i, '');