fluidcad 0.0.37 → 0.0.39

package/llm-docs/api/index.json

@@ -1,6 +1,6 @@
 {
   "schemaVersion": 1,
-  "generatedAt": "2026-06-12T18:19:00.445Z",
+  "generatedAt": "2026-07-05T08:56:29.709Z",
   "symbols": {
     "arc": "api/arc",
     "axis": "api/axis",

package/llm-docs/api/types/loft.md

@@ -1,7 +1,7 @@
 ---
 id: api/types/loft
 title: Loft
-summary: "The Loft type. Extends BooleanOperation; adds 11 methods."
+summary: "The Loft type. Extends BooleanOperation; adds 14 methods."
 tags: [api, type, interface]
 symbols: [Loft, ILoft]
 seeAlso: [api/loft, api/types/boolean-operation]
@@ -10,6 +10,9 @@ seeAlso: [api/loft, api/types/boolean-operation]
 
 ```ts
 interface Loft extends BooleanOperation {
+  guides(...guides: SceneObject[]): this;
+  startCondition(type: LoftConditionType, magnitude?: NumberParam): this;
+  endCondition(type: LoftConditionType, magnitude?: NumberParam): this;
   startFaces(...args: (number | FaceFilter)[]): SceneObject;
   endFaces(...args: (number | FaceFilter)[]): SceneObject;
   sideFaces(...args: (number | FaceFilter)[]): SceneObject;
@@ -29,6 +32,38 @@ Extends [[api/types/boolean-operation]].
 
 ## Methods
 
+### `guides()`
+
+Adds side guide curves (rails) the loft surface must follow. Supports one
+or two guides in total; a single argument may carry several separate
+curves (e.g. a sketch holding a curve and its mirror) — each connected
+chain counts as one guide. Every guide must pass through every profile.
+Composes with start/end conditions (the condition fades out around each
+guide's contact point — rails win locally, the condition shapes the
+rest). Cannot be combined with thin mode.
+
+| Parameter | Type | Description |
+| --- | --- | --- |
+| `...guides` | [[api/types/scene-object]][] | Sketches or edges forming the guide curves. *(optional)* |
+
+### `startCondition()`
+
+Constrains how the surface leaves the first profile.
+
+| Parameter | Type | Description |
+| --- | --- | --- |
+| `type` | `LoftConditionType` | `'none'`, `'normal'` or `'tangent'` — see LoftConditionType. |
+| `magnitude` | `NumberParam` | Scales the takeoff strength; defaults to 1. Negative values flip the direction (e.g. inward instead of outward for `'tangent'`). *(optional)* |
+
+### `endCondition()`
+
+Constrains how the surface arrives at the last profile.
+
+| Parameter | Type | Description |
+| --- | --- | --- |
+| `type` | `LoftConditionType` | `'none'`, `'normal'` or `'tangent'` — see LoftConditionType. |
+| `magnitude` | `NumberParam` | Scales the arrival strength; defaults to 1. Negative values flip the direction (e.g. inward instead of outward for `'tangent'`). *(optional)* |
+
 ### `startFaces()`
 
 Selects faces on the first profile plane of the loft.

package/llm-docs/api/types/sweep.md

@@ -1,7 +1,7 @@
 ---
 id: api/types/sweep
 title: Sweep
-summary: "The Sweep type. Extends BooleanOperation; adds 15 methods."
+summary: "The Sweep type. Extends BooleanOperation; adds 16 methods."
 tags: [api, type, interface]
 symbols: [Sweep, ISweep]
 seeAlso: [api/sweep, api/types/boolean-operation]
@@ -20,6 +20,7 @@ interface Sweep extends BooleanOperation {
   internalEdges(...args: (number | EdgeFilter)[]): SceneObject;
   draft(value: NumberParam | [NumberParam, NumberParam]): this;
   endOffset(value: NumberParam): this;
+  extend(side: SweepSide, amount: NumberParam): this;
   drill(value?: boolean): this;
   pick(...points: Point2DLike[]): this;
   thin(offset: NumberParam): this;
@@ -129,6 +130,17 @@ Offsets the end face by a specified distance along the sweep direction.
 | --- | --- | --- |
 | `value` | `NumberParam` | The offset distance. |
 
+### `extend()`
+
+Extends the swept solid beyond the path at the given end by `amount`,
+continuing straight along the path's tangent direction there. Chain twice to
+extend both ends, e.g. `.extend('start', 10).extend('end', 5)`.
+
+| Parameter | Type | Description |
+| --- | --- | --- |
+| `side` | `SweepSide` | Which end of the path to extend: `'start'` or `'end'`. |
+| `amount` | `NumberParam` | Distance to extend, in mm (positive; non-positive is a no-op). |
+
 ### `drill()`
 
 Enables or disables drill mode.

package/llm-docs/api/types/text.md

@@ -15,7 +15,7 @@ interface Text extends ExtrudableGeometry {
   weight(value: string | number): this;
   bold(): this;
   italic(value?: boolean): this;
-  align(value: "left" | "right" | "center" | "start" | "end" | "space-between" | "space-around"): this;
+  align(value: "left" | "right" | "start" | "end" | "center" | "space-between" | "space-around"): this;
   lineSpacing(value: number): this;
   letterSpacing(value: number): this;
   offset(value: number): this;
@@ -82,7 +82,7 @@ synonyms of `"start"` and `"end"`.
 
 | Parameter | Type | Description |
 | --- | --- | --- |
-| `value` | `"left"` \| `"right"` \| `"center"` \| `"start"` \| `"end"` \| `"space-between"` \| `"space-around"` | `"left"`/`"start"` (default), `"center"`, `"right"`/`"end"`, `"space-between"`, or `"space-around"`. |
+| `value` | `"left"` \| `"right"` \| `"start"` \| `"end"` \| `"center"` \| `"space-between"` \| `"space-around"` | `"left"`/`"start"` (default), `"center"`, `"right"`/`"end"`, `"space-between"`, or `"space-around"`. |
 
 ### `lineSpacing()`
 

package/llm-docs/index.json

@@ -1,6 +1,6 @@
 {
   "schemaVersion": 1,
-  "generatedAt": "2026-06-12T18:19:00.445Z",
+  "generatedAt": "2026-07-05T08:56:29.709Z",
   "docs": [
     {
       "id": "api/arc",
@@ -1289,7 +1289,7 @@
     {
       "id": "api/types/loft",
       "title": "Loft",
-      "summary": "The Loft type. Extends BooleanOperation; adds 11 methods.",
+      "summary": "The Loft type. Extends BooleanOperation; adds 14 methods.",
       "tags": [
         "api",
         "type",
@@ -1304,7 +1304,7 @@
         "api/types/boolean-operation"
       ],
       "file": "api/types/loft.md",
-      "bodyLength": 4872
+      "bodyLength": 6520
     },
     {
       "id": "api/types/mirror",
@@ -1609,7 +1609,7 @@
     {
       "id": "api/types/sweep",
       "title": "Sweep",
-      "summary": "The Sweep type. Extends BooleanOperation; adds 15 methods.",
+      "summary": "The Sweep type. Extends BooleanOperation; adds 16 methods.",
       "tags": [
         "api",
         "type",
@@ -1624,7 +1624,7 @@
         "api/types/boolean-operation"
       ],
       "file": "api/types/sweep.md",
-      "bodyLength": 5877
+      "bodyLength": 6391
     },
     {
       "id": "api/types/tangent-arc-two-objects",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "fluidcad",
-  "version": "0.0.37",
+  "version": "0.0.39",
   "description": "Parametric CAD modeling library using javascript",
   "author": "Marwan Aouida <contact@marwan.dev>",
   "license": "MIT",

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

@@ -114,7 +114,7 @@ export declare class FluidCadServer {
     processFile(filePath: string, ignoreCache?: boolean): Promise<SceneRenderedData | null>;
     updateLiveCode(fileName: string, code: string): Promise<SceneRenderedData | null>;
     rollbackFromUI(index: number): Promise<SceneRenderedData | null>;
-    recomputeCurrentFile(): Promise<SceneRenderedData | null>;
+    recomputeCurrentFile(forceFullRebuild?: boolean): Promise<SceneRenderedData | null>;
     rollback(fileName: string, index: number): Promise<SceneRenderedData | null>;
     importFile(workspacePath: string, fileName: string, data: string): Promise<void>;
     getShapeProperties(shapeId: string): any;

package/server/dist/fluidcad-server.js

@@ -220,13 +220,23 @@ export class FluidCadServer {
     async rollbackFromUI(index) {
         return this.rollback(this.currentFileName, index);
     }
-    async recomputeCurrentFile() {
+    async recomputeCurrentFile(forceFullRebuild = false) {
         if (!this.currentFilePath) {
             return null;
         }
         const sessionId = this.currentFileName;
         this.renderingCache.delete(sessionId);
         this.lastRendered.delete(sessionId);
+        if (forceFullRebuild) {
+            // Drop the incremental-compare baseline so every object is rebuilt from
+            // scratch instead of being carried over as cached. Without this, an
+            // unchanged file compares equal at every index, the whole scene is
+            // marked cached, and the render reuses all geometry — so the explicit
+            // "Recompute scene" action does no visible work and reports no build
+            // timings (buildDurationMs is only recorded for objects that rebuild).
+            // Param edits keep the baseline so slider drags stay fast.
+            this.previousScenes.delete(sessionId);
+        }
         return this.processFileInternal(sessionId, this.currentFilePath, true);
     }
     async rollback(fileName, index) {

package/server/dist/routes/params.js

@@ -2,7 +2,7 @@ import { Router } from 'express';
 export function createParamsRouter(fluidCadServer, sendToExtension, broadcastToUI) {
     const router = Router();
     router.post('/recompute', async (_req, res) => {
-        const data = await fluidCadServer.recomputeCurrentFile();
+        const data = await fluidCadServer.recomputeCurrentFile(true);
         if (!data) {
             res.status(404).json({ error: 'No active scene' });
             return;