fluidcad 0.0.33 → 0.0.35

package/lib/dist/core/2d/vline.js

@@ -6,6 +6,7 @@ import { registerBuilder } from "../../index.js";
 import { isPlaneLike } from "../../math/plane.js";
 import { SceneObject } from "../../common/scene-object.js";
 import { resolvePlane } from "../../helpers/resolve.js";
+import { isNumberParam, resolveParam } from "../param.js";
 function build(context) {
     return function line() {
         let planeObj = null;
@@ -31,18 +32,19 @@ function build(context) {
             context.addSceneObject(vline);
             return vline;
         }
-        if (argOffset === 0 && typeof arguments[0] !== 'number') {
+        if (argOffset === 0 && !isNumberParam(arguments[0])) {
             // vLine(start, distance) or vLine(start, target)
             const start = normalizePoint2D(arguments[0]);
             const second = arguments[1];
             const distanceOrTarget = second instanceof SceneObject
                 ? second
-                : second;
+                : resolveParam(second);
             const vline = new VerticalLine(distanceOrTarget, planeObj);
+            vline.setHasExplicitStart();
             context.addSceneObjects([new Move(start), vline]);
             return vline;
         }
-        const distance = arguments[argOffset];
+        const distance = resolveParam(arguments[argOffset]);
         const vline = new VerticalLine(distance, planeObj);
         context.addSceneObject(vline);
         return vline;

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

@@ -1,23 +1,24 @@
 import { ISceneObject } from "./interfaces.js";
+import { type NumberParam, type BooleanParam } from "./param.js";
 interface ChamferFunction {
     /**
      * Chamfers selected edges with the given distance.
      * @param distance - The chamfer distance (defaults to 1)
      */
-    (distance?: number): ISceneObject;
+    (distance?: NumberParam): ISceneObject;
     /**
      * Chamfers the given edge selections with the given distance.
      * @param distance - The chamfer distance
      * @param sceneObjects - The edge selections to chamfer
      */
-    (distance: number, ...sceneObjects: ISceneObject[]): ISceneObject;
+    (distance: NumberParam, ...sceneObjects: ISceneObject[]): ISceneObject;
     /**
      * Chamfers selected edges with two distances or a distance and angle.
      * @param distance - The first chamfer distance
      * @param distance2 - The second distance, or angle if `isAngle` is true
      * @param isAngle - Whether `distance2` is an angle
      */
-    (distance: number, distance2: number, isAngle?: boolean): ISceneObject;
+    (distance: NumberParam, distance2: NumberParam, isAngle?: BooleanParam): ISceneObject;
     /**
      * Chamfers the given edge selections with two distances or a distance and angle.
      * @param distance - The first chamfer distance
@@ -25,7 +26,7 @@ interface ChamferFunction {
      * @param isAngle - Whether `distance2` is an angle
      * @param sceneObjects - The edge selections to chamfer
      */
-    (distance: number, distance2: number, isAngle: boolean, ...sceneObjects: ISceneObject[]): ISceneObject;
+    (distance: NumberParam, distance2: NumberParam, isAngle: BooleanParam, ...sceneObjects: ISceneObject[]): ISceneObject;
 }
 declare const _default: ChamferFunction;
 export default _default;

package/lib/dist/core/chamfer.js

@@ -1,20 +1,21 @@
 import { Chamfer } from "../features/chamfer.js";
 import { SceneObject } from "../common/scene-object.js";
 import { registerBuilder } from "../index.js";
+import { isNumberParam, isBooleanParam, resolveParam } from "./param.js";
 function build(context) {
     return function chamfer() {
         const args = Array.from(arguments);
         let distance = 1;
         let distance2 = undefined;
         let isAngle = false;
-        if (args.length >= 1 && typeof args[0] === 'number') {
-            distance = args[0];
+        if (args.length >= 1 && isNumberParam(args[0])) {
+            distance = resolveParam(args[0]);
         }
-        if (args.length >= 2 && typeof args[1] === 'number') {
-            distance2 = args[1];
+        if (args.length >= 2 && isNumberParam(args[1])) {
+            distance2 = resolveParam(args[1]);
         }
-        if (args.length >= 3 && typeof args[2] === 'boolean') {
-            isAngle = args[2];
+        if (args.length >= 3 && isBooleanParam(args[2])) {
+            isAngle = resolveParam(args[2]);
         }
         const selections = args
             .filter(a => a instanceof SceneObject);

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

@@ -1,16 +1,17 @@
 import { ISceneObject } from "./interfaces.js";
+import { type StringParam } from "./param.js";
 interface ColorFunction {
     /**
      * Applies a color to the last selection.
      * @param color - The color value (CSS color string)
      */
-    (color: string): ISceneObject;
+    (color: StringParam): ISceneObject;
     /**
      * Applies a color to the given selection.
      * @param color - The color value (CSS color string)
      * @param selection - The face or edge selection to color
      */
-    (color: string, selection: ISceneObject): ISceneObject;
+    (color: StringParam, selection: ISceneObject): ISceneObject;
 }
 declare const _default: ColorFunction;
 export default _default;

package/lib/dist/core/color.js

@@ -1,6 +1,7 @@
 import { registerBuilder } from "../index.js";
 import { SceneObject } from "../common/scene-object.js";
 import { Color } from "../features/color.js";
+import { resolveParam } from "./param.js";
 function build(context) {
     return function color() {
         let selection;
@@ -11,7 +12,7 @@ function build(context) {
             selection = context.getLastSelection() || undefined;
         }
         context.addSceneObject(selection);
-        const obj = new Color(arguments[0], selection);
+        const obj = new Color(resolveParam(arguments[0]), selection);
         context.addSceneObject(obj);
         return obj;
     };

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

@@ -1,4 +1,5 @@
 import { ICut, ISceneObject } from "./interfaces.js";
+import { type NumberParam } from "./param.js";
 interface CutFunction {
     /**
      * Cuts through all using the last sketch
@@ -15,20 +16,20 @@ interface CutFunction {
      * @param distance - The cut depth
      * @param target - The sketch to cut with
      */
-    (distance: number, target?: ISceneObject): ICut;
+    (distance: NumberParam, target?: ISceneObject): ICut;
     /**
      * Cuts by two distances using the last sketch.
      * @param distance1 - The first cut distance
      * @param distance2 - The second cut distance
      */
-    (distance1: number, distance2: number): ICut;
+    (distance1: NumberParam, distance2: NumberParam): ICut;
     /**
      * Cuts by two distances using the given sketch.
      * @param distance1 - The first cut distance
      * @param distance2 - The second cut distance
      * @param target - The sketch to cut with
      */
-    (distance1: number, distance2: number, target: ISceneObject): ICut;
+    (distance1: NumberParam, distance2: NumberParam, target: ISceneObject): ICut;
     /**
      * Cuts up to a specific face using the last sketch.
      * @param face - A face selection to cut up to

package/lib/dist/core/cut.js

@@ -3,6 +3,7 @@ import { registerBuilder } from "../index.js";
 import { Extrude } from "../features/extrude.js";
 import { ExtrudeToFace } from "../features/extrude-to-face.js";
 import { ExtrudeTwoDistances } from "../features/extrude-two-distances.js";
+import { isNumberParam, resolveParam } from "./param.js";
 function isExtrudable(obj) {
     return obj instanceof SceneObject && obj.isExtrudable();
 }
@@ -12,8 +13,8 @@ function build(context) {
             return new Extrude(0, extrudable).remove();
         }
         else if (params.length === 1) {
-            if (typeof params[0] === 'number') {
-                return new Extrude(params[0], extrudable).remove();
+            if (isNumberParam(params[0])) {
+                return new Extrude(resolveParam(params[0]), extrudable).remove();
             }
             else if (params[0] === 'first-face') {
                 return new ExtrudeToFace('first-face', extrudable).remove();
@@ -30,8 +31,8 @@ function build(context) {
             }
         }
         else if (params.length === 2) {
-            if (typeof params[0] === 'number' && typeof params[1] === 'number') {
-                return new ExtrudeTwoDistances(params[0], params[1], extrudable).remove();
+            if (isNumberParam(params[0]) && isNumberParam(params[1])) {
+                return new ExtrudeTwoDistances(resolveParam(params[0]), resolveParam(params[1]), extrudable).remove();
             }
         }
         throw new Error("Invalid parameters for cut function.");

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

@@ -1,11 +1,12 @@
 import { ITransformable } from "./interfaces.js";
+import { type NumberParam } from "./param.js";
 interface CylinderFunction {
     /**
      * Creates a cylinder with the given radius and height.
      * @param radius - The cylinder radius
      * @param height - The cylinder height
      */
-    (radius: number, height: number): ITransformable;
+    (radius: NumberParam, height: NumberParam): ITransformable;
 }
 declare const _default: CylinderFunction;
 export default _default;

package/lib/dist/core/cylinder.js

@@ -1,8 +1,9 @@
 import { Cylinder } from "../features/cylinder.js";
 import { registerBuilder } from "../index.js";
+import { resolveParam } from "./param.js";
 function build(context) {
     return function cylinder(radius, height) {
-        const cylinder = new Cylinder(radius, height);
+        const cylinder = new Cylinder(resolveParam(radius), resolveParam(height));
         context.addSceneObject(cylinder);
         return cylinder;
     };

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

@@ -1,16 +1,17 @@
 import { ISceneObject, IDraft } from "./interfaces.js";
+import { type NumberParam } from "./param.js";
 interface DraftFunction {
     /**
      * Applies a draft angle to the last selected faces.
      * @param angle - The draft angle in degrees
      */
-    (angle: number): IDraft;
+    (angle: NumberParam): IDraft;
     /**
      * Applies a draft angle to the given face selections.
      * @param angle - The draft angle in degrees
      * @param selections - The face selections to draft
      */
-    (angle: number, ...selections: ISceneObject[]): IDraft;
+    (angle: NumberParam, ...selections: ISceneObject[]): IDraft;
 }
 declare const _default: DraftFunction;
 export default _default;

package/lib/dist/core/draft.js

@@ -2,6 +2,7 @@ import { Draft } from "../features/draft.js";
 import { SceneObject } from "../common/scene-object.js";
 import { registerBuilder } from "../index.js";
 import { rad } from "../helpers/math-helpers.js";
+import { isNumberParam, resolveParam } from "./param.js";
 function build(context) {
     return function draft() {
         const args = Array.from(arguments);
@@ -15,8 +16,8 @@ function build(context) {
                 selections.push(implicit);
             }
         }
-        const angleDeg = (args.length >= 1 && typeof args[0] === 'number')
-            ? args[0]
+        const angleDeg = (args.length >= 1 && isNumberParam(args[0]))
+            ? resolveParam(args[0])
             : 5;
         for (const sel of selections) {
             context.addSceneObject(sel);

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

@@ -1,5 +1,6 @@
 import { IExtrude, ISceneObject } from "./interfaces.js";
 import { FaceFilterBuilder } from "../filters/face/face-filter.js";
+import { type NumberParam } from "./param.js";
 interface ExtrudeFunction {
     /**
      * Extrudes the last sketch with a default distance.
@@ -11,20 +12,20 @@ interface ExtrudeFunction {
      * @param distance - The extrusion distance
      * @param target - The sketch or face-bearing scene object to extrude
      */
-    (distance: number, target?: ISceneObject): IExtrude;
+    (distance: NumberParam, target?: ISceneObject): IExtrude;
     /**
      * Extrudes between two distances.
      * @param distance1 - The first extrusion distance
      * @param distance2 - The second extrusion distance
      */
-    (distance1: number, distance2: number): IExtrude;
+    (distance1: NumberParam, distance2: NumberParam): IExtrude;
     /**
      * Extrudes between two distances.
      * @param distance1 - The first extrusion distance
      * @param distance2 - The second extrusion distance
      * @param target - The sketch or face-bearing scene object to extrude
      */
-    (distance1: number, distance2: number, target: ISceneObject): IExtrude;
+    (distance1: NumberParam, distance2: NumberParam, target: ISceneObject): IExtrude;
     /**
      * Extrudes up to a specific face.
      * @param face - A face selection to extrude up to

package/lib/dist/core/extrude.js

@@ -5,6 +5,7 @@ import { ExtrudeTwoDistances } from "../features/extrude-two-distances.js";
 import { ExtrudeToFace } from "../features/extrude-to-face.js";
 import { SelectSceneObject } from "../features/select.js";
 import { FaceFilterBuilder } from "../filters/face/face-filter.js";
+import { isNumberParam, resolveParam } from "./param.js";
 function isExtrudable(obj) {
     return obj instanceof SceneObject && obj.isExtrudable();
 }
@@ -34,8 +35,8 @@ function build(context) {
             return new ExtrudeToFace(params[0], extrudable, rest);
         }
         if (params.length === 1) {
-            if (typeof params[0] === 'number') {
-                return new Extrude(params[0], extrudable);
+            if (isNumberParam(params[0])) {
+                return new Extrude(resolveParam(params[0]), extrudable);
             }
             else if (params[0] instanceof SceneObject) {
                 context.addSceneObject(params[0]);
@@ -46,8 +47,8 @@ function build(context) {
             }
         }
         else if (params.length === 2) {
-            if (typeof params[0] === 'number' && typeof params[1] === 'number') {
-                return new ExtrudeTwoDistances(params[0], params[1], extrudable);
+            if (isNumberParam(params[0]) && isNumberParam(params[1])) {
+                return new ExtrudeTwoDistances(resolveParam(params[0]), resolveParam(params[1]), extrudable);
             }
         }
         throw new Error("Invalid parameters for extrude function.");

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

@@ -1,16 +1,17 @@
 import { IGeometry, ISceneObject } from "./interfaces.js";
+import { type NumberParam } from "./param.js";
 interface FilletFunction {
     /**
      * Fillets selected edges with the given radius.
      * @param radius - The fillet radius (defaults to 1)
      */
-    (radius?: number): ISceneObject;
+    (radius?: NumberParam): ISceneObject;
     /**
      * Fillets the given edge selections with the given radius.
      * @param radius - The fillet radius
      * @param sceneObjects - The edge selections to fillet
      */
-    (radius: number, ...sceneObjects: ISceneObject[]): ISceneObject;
+    (radius: NumberParam, ...sceneObjects: ISceneObject[]): ISceneObject;
     /**
      * [2D] Fillets corners between the given geometries.
      * @param objects - The geometries whose corners to fillet
@@ -21,13 +22,13 @@ interface FilletFunction {
      * @param objects - The geometries whose corners to fillet
      * @param radius - The fillet radius
      */
-    (objects: IGeometry[], radius: number): ISceneObject;
+    (objects: IGeometry[], radius: NumberParam): ISceneObject;
     /**
      * [2D] Fillets corners at the given radius and geometries.
      * @param radius - The fillet radius
      * @param objects - The geometries whose corners to fillet
      */
-    (radius: number, ...objects: IGeometry[]): ISceneObject;
+    (radius: NumberParam, ...objects: IGeometry[]): ISceneObject;
 }
 declare const _default: FilletFunction;
 export default _default;

package/lib/dist/core/fillet.js

@@ -2,6 +2,7 @@ import { Fillet } from "../features/fillet.js";
 import { Fillet2D } from "../features/fillet2d.js";
 import { SceneObject } from "../common/scene-object.js";
 import { registerBuilder } from "../index.js";
+import { isNumberParam, resolveParam } from "./param.js";
 function build(context) {
     return function fillet() {
         const activeSketch = context.getActiveSketch();
@@ -12,8 +13,8 @@ function build(context) {
                 return fillet;
             }
             if (arguments.length === 1) {
-                if (typeof (arguments[0]) === 'number') {
-                    const radius = arguments[0];
+                if (isNumberParam(arguments[0])) {
+                    const radius = resolveParam(arguments[0]);
                     const fillet = new Fillet2D(radius);
                     context.addSceneObject(fillet);
                     return fillet;
@@ -27,7 +28,7 @@ function build(context) {
             }
             if (arguments.length === 2 && Array.isArray(arguments[0])) {
                 const objects = arguments[0];
-                const radius = arguments[1] || 1;
+                const radius = resolveParam(arguments[1]) || 1;
                 const fillet = new Fillet2D(radius, ...objects);
                 context.addSceneObject(fillet);
                 return fillet;
@@ -35,8 +36,8 @@ function build(context) {
         }
         else {
             const args = Array.from(arguments);
-            const radius = (args.length >= 1 && typeof args[0] === 'number')
-                ? args[0]
+            const radius = (args.length >= 1 && isNumberParam(args[0]))
+                ? resolveParam(args[0])
                 : 1;
             const selections = args
                 .filter(a => a instanceof SceneObject);

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

@@ -32,3 +32,4 @@ export { default as trim } from "./trim.js";
 export { default as part } from "./part.js";
 export * from "./2d/index.js";
 export { breakpoint } from "./breakpoint.js";
+export { default as param, type ParamType, type ParamOptionsMap, type NumberParamOptions, type SliderParamOptions, type SelectParamOptions, type CheckboxParamOptions, type TextParamOptions, type NumberParam, type StringParam, type BooleanParam, type ParamValue, resolveParam, isNumberParam, isBooleanParam } from "./param.js";

package/lib/dist/core/index.js

@@ -31,3 +31,4 @@ export { default as trim } from "./trim.js";
 export { default as part } from "./part.js";
 export * from "./2d/index.js";
 export { breakpoint } from "./breakpoint.js";
+export { default as param, resolveParam, isNumberParam, isBooleanParam } from "./param.js";