fluidcad 0.0.32 → 0.0.33

package/lib/dist/common/scene-object.d.ts

@@ -59,6 +59,7 @@ export declare abstract class SceneObject implements Comparable<SceneObject>, Se
     constructor();
     get id(): string;
     get parentId(): string | null;
+    inheritIdentityFrom(other: SceneObject): void;
     private setParent;
     protected setAlwaysVisible(): void;
     isAlwaysVisible(): boolean;
@@ -150,6 +151,7 @@ export declare abstract class SceneObject implements Comparable<SceneObject>, Se
     setOrder(order: number): void;
     getOrder(): number;
     getName(): string;
+    hasCustomName(): boolean;
     name(value: string): this;
     guide(): this;
     reusable(): this;

package/lib/dist/common/scene-object.js

@@ -36,6 +36,9 @@ export class SceneObject {
     get parentId() {
         return this._parent?.id || null;
     }
+    inheritIdentityFrom(other) {
+        this._id = other._id;
+    }
     setParent(parent) {
         this._parent = parent;
     }
@@ -452,6 +455,9 @@ export class SceneObject {
     getName() {
         return this._name ?? this.getType();
     }
+    hasCustomName() {
+        return this._name !== null;
+    }
     name(value) {
         this._name = value;
         return this;

package/lib/dist/common/solid.d.ts

@@ -1,4 +1,4 @@
-import type { TopoDS_Edge, TopoDS_Face, TopoDS_Solid } from "occjs-wrapper";
+import type { TopoDS_Edge, TopoDS_Face, TopoDS_Solid, TopTools_IndexedDataMapOfShapeListOfShape } from "occjs-wrapper";
 import { ShapeType } from "./shape-type.js";
 import { Shape } from "./shape.js";
 import { Face } from "./face.js";
@@ -6,6 +6,7 @@ import { Edge } from "./edge.js";
 export declare class Solid extends Shape<TopoDS_Solid> {
     private faces;
     private edges;
+    private edgeToFacesIndex;
     constructor(solid: TopoDS_Solid);
     getType(): ShapeType;
     isSolid(): boolean;
@@ -15,6 +16,8 @@ export declare class Solid extends Shape<TopoDS_Solid> {
     getFace(face: TopoDS_Face): Face | null;
     hasFace(face: TopoDS_Face): boolean;
     hasEdge(edge: TopoDS_Edge): TopoDS_Edge;
+    getEdgeToFacesIndex(): TopTools_IndexedDataMapOfShapeListOfShape;
+    dispose(): void;
     copy(): Shape;
     static fromTopoDSSolid(solid: TopoDS_Solid): Solid;
 }

package/lib/dist/common/solid.js

@@ -1,8 +1,10 @@
 import { Explorer } from "../oc/explorer.js";
+import { TopologyIndex } from "../oc/topology-index.js";
 import { Shape } from "./shape.js";
 export class Solid extends Shape {
     faces = null;
     edges = null;
+    edgeToFacesIndex = null;
     constructor(solid) {
         super(solid);
     }
@@ -59,6 +61,17 @@ export class Solid extends Shape {
         }
         return null;
     }
+    getEdgeToFacesIndex() {
+        if (!this.edgeToFacesIndex) {
+            this.edgeToFacesIndex = TopologyIndex.buildEdgeToFaces(this.getShape());
+        }
+        return this.edgeToFacesIndex;
+    }
+    dispose() {
+        this.edgeToFacesIndex?.delete();
+        this.edgeToFacesIndex = null;
+        super.dispose();
+    }
     copy() {
         const copied = new Solid(this.getShape());
         for (const entry of this.colorMap) {

package/lib/dist/core/index.d.ts

@@ -1,4 +1,4 @@
-export type { ISceneObject, ITransformable, IBooleanOperation, IPlane, IAxis, ISelect, IGeometry, IExtrudableGeometry, IRect, ISlot, IPolygon, ITwoObjectsTangentLine, ITangentArcTwoObjects, IExtrude, ICut, ICommon, ISweep, ILoft, IRevolve, IDraft } from "./interfaces.js";
+export type { ISceneObject, ITransformable, IBooleanOperation, IPlane, IAxis, ISelect, IGeometry, IExtrudableGeometry, IRect, ISlot, IPolygon, ITwoObjectsTangentLine, ITangentArcTwoObjects, IExtrude, ICut, ICommon, ISweep, ILoft, IRevolve, IDraft, IRib } from "./interfaces.js";
 export { default as axis } from "./axis.js";
 export { default as local } from "./local.js";
 export { default as plane } from "./plane.js";
@@ -23,6 +23,7 @@ export { default as repeat } from "./repeat.js";
 export { default as load } from "./load.js";
 export { default as loft } from "./loft.js";
 export { default as sweep } from "./sweep.js";
+export { default as rib } from "./rib.js";
 export { default as color } from "./color.js";
 export { default as draft } from "./draft.js";
 export { default as remove } from "./remove.js";

package/lib/dist/core/index.js

@@ -22,6 +22,7 @@ export { default as repeat } from "./repeat.js";
 export { default as load } from "./load.js";
 export { default as loft } from "./loft.js";
 export { default as sweep } from "./sweep.js";
+export { default as rib } from "./rib.js";
 export { default as color } from "./color.js";
 export { default as draft } from "./draft.js";
 export { default as remove } from "./remove.js";

package/lib/dist/core/interfaces.d.ts

@@ -19,6 +19,25 @@ export interface ISceneObject {
      */
     reusable(): this;
 }
+export interface ILoadFile extends ISceneObject {
+    /**
+     * Skip applying colors from the imported file's color metadata sidecar.
+     */
+    noColors(): this;
+    /**
+     * Keep only the solids at the given 0-based indices (in load order).
+     * Combined with {@link exclude} by applying include first, then exclude.
+     * Repeated calls accumulate.
+     * @param indices - The 0-based solid indices to keep.
+     */
+    include(...indices: number[]): this;
+    /**
+     * Drop the solids at the given 0-based indices. Applied after {@link include}.
+     * Repeated calls accumulate.
+     * @param indices - The 0-based solid indices to drop.
+     */
+    exclude(...indices: number[]): this;
+}
 export interface IBooleanOperation extends ISceneObject {
     /**
      * Additive boolean operation — fuses the result with all intersecting scene objects.
@@ -695,6 +714,63 @@ export interface IRotate extends ISceneObject {
 }
 export interface IDraft extends ISceneObject {
 }
+export interface IRib extends IBooleanOperation {
+    /**
+     * Selects faces at the start (base) of the rib — the profile face at the sketch plane.
+     * @param args - Numeric indices or {@link FaceFilterBuilder} instances to filter the selection.
+     */
+    startFaces(...args: (number | FaceFilterBuilder)[]): ISceneObject;
+    /**
+     * Selects faces at the end (top) of the rib — where the rib meets the boundary.
+     * @param args - Numeric indices or {@link FaceFilterBuilder} instances to filter the selection.
+     */
+    endFaces(...args: (number | FaceFilterBuilder)[]): ISceneObject;
+    /**
+     * Selects the lateral wall faces of the rib.
+     * @param args - Numeric indices or {@link FaceFilterBuilder} instances to filter the selection.
+     */
+    sideFaces(...args: (number | FaceFilterBuilder)[]): ISceneObject;
+    /**
+     * Selects the small cap faces at the spine endpoints.
+     * @param args - Numeric indices or {@link FaceFilterBuilder} instances to filter the selection.
+     */
+    capFaces(...args: (number | FaceFilterBuilder)[]): ISceneObject;
+    /**
+     * Selects edges on the start faces.
+     * @param args - Numeric indices or {@link EdgeFilterBuilder} instances to filter the selection.
+     */
+    startEdges(...args: (number | EdgeFilterBuilder)[]): ISceneObject;
+    /**
+     * Selects edges on the end faces.
+     * @param args - Numeric indices or {@link EdgeFilterBuilder} instances to filter the selection.
+     */
+    endEdges(...args: (number | EdgeFilterBuilder)[]): ISceneObject;
+    /**
+     * Selects edges on the side faces, excluding edges shared with start/end faces.
+     * @param args - Numeric indices or {@link EdgeFilterBuilder} instances to filter the selection.
+     */
+    sideEdges(...args: (number | EdgeFilterBuilder)[]): ISceneObject;
+    /**
+     * Selects edges on the cap faces.
+     * @param args - Numeric indices or {@link EdgeFilterBuilder} instances to filter the selection.
+     */
+    capEdges(...args: (number | EdgeFilterBuilder)[]): ISceneObject;
+    /**
+     * Applies a draft (taper) angle to the rib walls.
+     * @param value - A single angle for uniform draft, or a `[start, end]` tuple for asymmetric draft.
+     */
+    draft(value: number | [number, number]): this;
+    /**
+     * Switches the extrusion direction to parallel to the sketch plane
+     * (perpendicular to the spine within the plane) instead of normal to it.
+     */
+    parallel(): this;
+    /**
+     * Extends the rib's side faces at the spine endpoints outward to blend
+     * with the target solids' walls.
+     */
+    extend(): this;
+}
 export interface IShell extends ISceneObject {
     /**
      * Selects the inner wall faces created by the shell operation (from thickness removal).

package/lib/dist/core/load.d.ts

@@ -1,10 +1,10 @@
-import { ISceneObject } from "./interfaces.js";
+import { ILoadFile } from "./interfaces.js";
 interface LoadFunction {
     /**
      * Loads a 3D model file (STEP, STL, etc.) by filename.
      * @param fileName - The path to the model file
      */
-    (fileName: string): ISceneObject;
+    (fileName: string): ILoadFile;
 }
 declare const _default: LoadFunction;
 export default _default;

package/lib/dist/core/rib.d.ts

@@ -0,0 +1,18 @@
+import { IRib, ISceneObject } from "./interfaces.js";
+interface RibFunction {
+    /**
+     * Creates a rib from the last sketch with the given thickness.
+     * The rib extends in the sketch normal direction until it reaches
+     * surrounding solids. Positive thickness = forward, negative = reverse.
+     * @param thickness - Wall thickness (sign controls direction)
+     */
+    (thickness: number): IRib;
+    /**
+     * Creates a rib from an explicit sketch spine with the given thickness.
+     * @param thickness - Wall thickness (sign controls direction)
+     * @param spine - The sketch providing the rib spine wire and plane
+     */
+    (thickness: number, spine: ISceneObject): IRib;
+}
+declare const _default: RibFunction;
+export default _default;

package/lib/dist/core/rib.js

@@ -0,0 +1,37 @@
+import { SceneObject } from "../common/scene-object.js";
+import { registerBuilder } from "../index.js";
+import { Rib } from "../features/rib.js";
+function isExtrudable(obj) {
+    return obj instanceof SceneObject && obj.isExtrudable();
+}
+function build(context) {
+    //@ts-ignore
+    return function rib() {
+        const args = [...arguments];
+        if (args.length === 0) {
+            throw new Error("rib() requires at least a thickness argument.");
+        }
+        const thickness = args[0];
+        if (typeof thickness !== 'number' || thickness === 0) {
+            throw new Error("rib() thickness must be a non-zero number.");
+        }
+        let spine;
+        let extrudable;
+        if (args.length > 1 && isExtrudable(args[1])) {
+            spine = args[1];
+            extrudable = args[1];
+        }
+        else {
+            const lastExtrudable = context.getLastExtrudable();
+            if (!lastExtrudable) {
+                throw new Error("rib() requires a sketch. No sketch found in the scene.");
+            }
+            spine = lastExtrudable;
+            extrudable = lastExtrudable;
+        }
+        const result = new Rib(thickness, spine, extrudable);
+        context.addSceneObject(result);
+        return result;
+    };
+}
+export default registerBuilder(build);

package/lib/dist/features/load.d.ts

@@ -1,7 +1,13 @@
 import { SceneObject } from "../common/scene-object.js";
 export declare class LoadFile extends SceneObject {
     fileName: string;
+    private _noColors;
+    private _include?;
+    private _exclude;
     constructor(fileName: string);
+    noColors(): this;
+    include(...indices: number[]): this;
+    exclude(...indices: number[]): this;
     build(): void;
     compareTo(other: LoadFile): boolean;
     getType(): string;

package/lib/dist/features/load.js

@@ -2,12 +2,38 @@ import { SceneObject } from "../common/scene-object.js";
 import { FileImport } from "../io/file-import.js";
 export class LoadFile extends SceneObject {
     fileName;
+    _noColors = false;
+    _include;
+    _exclude = new Set();
     constructor(fileName) {
         super();
         this.fileName = fileName;
     }
+    noColors() {
+        this._noColors = true;
+        return this;
+    }
+    include(...indices) {
+        if (!this._include) {
+            this._include = new Set();
+        }
+        for (const i of indices) {
+            this._include.add(i);
+        }
+        return this;
+    }
+    exclude(...indices) {
+        for (const i of indices) {
+            this._exclude.add(i);
+        }
+        return this;
+    }
     build() {
-        const shapes = FileImport.deserializeShapesWithMetadata(this.fileName);
+        const shapes = FileImport.deserializeShapesWithMetadata(this.fileName, {
+            noColors: this._noColors,
+            include: this._include,
+            exclude: this._exclude.size > 0 ? this._exclude : undefined,
+        });
         this.addShapes(shapes);
     }
     compareTo(other) {
@@ -20,6 +46,15 @@ export class LoadFile extends SceneObject {
         if (this.fileName !== other.fileName) {
             return false;
         }
+        if (this._noColors !== other._noColors) {
+            return false;
+        }
+        if (!equalSets(this._include, other._include)) {
+            return false;
+        }
+        if (!equalSets(this._exclude, other._exclude)) {
+            return false;
+        }
         return true;
     }
     getType() {
@@ -29,3 +64,20 @@ export class LoadFile extends SceneObject {
         return {};
     }
 }
+function equalSets(a, b) {
+    if (a === b) {
+        return true;
+    }
+    if (!a || !b) {
+        return false;
+    }
+    if (a.size !== b.size) {
+        return false;
+    }
+    for (const v of a) {
+        if (!b.has(v)) {
+            return false;
+        }
+    }
+    return true;
+}

package/lib/dist/features/rib.d.ts

@@ -0,0 +1,31 @@
+import { BuildSceneObjectContext, SceneObject } from "../common/scene-object.js";
+import { Extrudable } from "../helpers/types.js";
+import { ExtrudeBase } from "./extrude-base.js";
+import { IRib } from "../core/interfaces.js";
+export declare class Rib extends ExtrudeBase implements IRib {
+    private _thickness;
+    private _spine;
+    private _parallel;
+    private _extend;
+    constructor(thickness: number, spine: SceneObject, extrudable?: Extrudable);
+    get thickness(): number;
+    get spine(): SceneObject;
+    parallel(): this;
+    extend(): this;
+    validate(): void;
+    build(context: BuildSceneObjectContext): void;
+    private getSpineWire;
+    getDependencies(): SceneObject[];
+    createCopy(remap: Map<SceneObject, SceneObject>): SceneObject;
+    compareTo(other: Rib): boolean;
+    getType(): string;
+    serialize(): {
+        thickness: number;
+        spine: any;
+        extrudable: any;
+        operationMode: "new" | "remove";
+        parallel: true;
+        extend: true;
+        draft: number | [number, number];
+    };
+}