@cadit-app/script-params 0.5.2 → 0.5.3

package/dist/params/geometry.js

@@ -0,0 +1,207 @@
+/**
+ * Geometry-related parameter types for CADit parametric scripts.
+ *
+ * This module defines the shape2d and shape3d parameter types and their
+ * associated value types, as well as utility functions for working with
+ * path geometry (bezier curves, point extraction, etc.).
+ */
+// =============================================================================
+// Geometry Utility Functions
+// =============================================================================
+/**
+ * Type guard to check if a path point is a bezier segment with handles.
+ *
+ * @example
+ * ```typescript
+ * for (const point of path.points) {
+ *   if (isPathSegment(point)) {
+ *     // point is PathSegment with handleIn/handleOut
+ *     console.log('Bezier point:', point.point, point.handleIn, point.handleOut);
+ *   } else {
+ *     // point is Point3D (simple point)
+ *     console.log('Simple point:', point.x, point.y);
+ *   }
+ * }
+ * ```
+ */
+export function isPathSegment(point) {
+    return point !== null && typeof point === 'object' && 'point' in point;
+}
+/**
+ * Get the x, y coordinates from a path point.
+ * Works for both simple Point3D and PathSegment.
+ *
+ * @example
+ * ```typescript
+ * const points2D = path.points.map(p => {
+ *   const { x, y } = getPathPointXY(p);
+ *   return [x, y];
+ * });
+ * ```
+ */
+export function getPathPointXY(point) {
+    if (isPathSegment(point)) {
+        return { x: point.point.x, y: point.point.y };
+    }
+    return { x: point.x, y: point.y };
+}
+/**
+ * Evaluate a cubic bezier curve at parameter t.
+ * @internal
+ */
+function cubicBezier(p0, p1, p2, p3, t) {
+    const oneMinusT = 1 - t;
+    return (oneMinusT * oneMinusT * oneMinusT * p0 +
+        3 * oneMinusT * oneMinusT * t * p1 +
+        3 * oneMinusT * t * t * p2 +
+        t * t * t * p3);
+}
+/**
+ * Convert a path with bezier segments to simple 2D points.
+ * This samples the bezier curves at regular intervals.
+ *
+ * @param points - Array of path points (can include bezier segments)
+ * @param samplesPerSegment - Number of samples per bezier segment (default: 8)
+ * @returns Array of [x, y] tuples suitable for CrossSection
+ *
+ * @example
+ * ```typescript
+ * const path = inputShape.shapeData.doodlePaths[0];
+ * const points2D = samplePathTo2D(path.points);
+ * const crossSection = Module.CrossSection(points2D);
+ * ```
+ */
+export function samplePathTo2D(points, samplesPerSegment = 8) {
+    const result = [];
+    for (let i = 0; i < points.length; i++) {
+        const current = points[i];
+        const next = points[(i + 1) % points.length];
+        // Get current point position
+        const currentXY = getPathPointXY(current);
+        // Check if we have bezier handles
+        const currentSegment = isPathSegment(current) ? current : null;
+        const nextSegment = isPathSegment(next) ? next : null;
+        // If no handles, just add the point
+        if (!currentSegment?.handleOut && !nextSegment?.handleIn) {
+            result.push([currentXY.x, currentXY.y]);
+            continue;
+        }
+        // Sample the bezier curve
+        const nextXY = getPathPointXY(next);
+        // Control point 1: current point + handleOut (or just current point)
+        const cp1x = currentSegment?.handleOut
+            ? currentXY.x + currentSegment.handleOut.x
+            : currentXY.x;
+        const cp1y = currentSegment?.handleOut
+            ? currentXY.y + currentSegment.handleOut.y
+            : currentXY.y;
+        // Control point 2: next point + handleIn (or just next point)
+        const cp2x = nextSegment?.handleIn
+            ? nextXY.x + nextSegment.handleIn.x
+            : nextXY.x;
+        const cp2y = nextSegment?.handleIn
+            ? nextXY.y + nextSegment.handleIn.y
+            : nextXY.y;
+        // Sample cubic bezier curve
+        for (let t = 0; t < 1; t += 1 / samplesPerSegment) {
+            const x = cubicBezier(currentXY.x, cp1x, cp2x, nextXY.x, t);
+            const y = cubicBezier(currentXY.y, cp1y, cp2y, nextXY.y, t);
+            result.push([x, y]);
+        }
+    }
+    return result;
+}
+/**
+ * Type guard to check if a Shape3dValue has valid mesh data.
+ * Use this to narrow the type before accessing meshData properties.
+ *
+ * @param shape3d - The Shape3dValue to check (may be null/undefined)
+ * @returns True if the shape has valid mesh data with vertices and triangles
+ *
+ * @example
+ * ```typescript
+ * import { Manifold, Mesh } from '@cadit-app/manifold-3d/manifoldCAD';
+ * import { hasShape3dMesh, getShape3dMeshOptions } from '@cadit-app/script-params';
+ *
+ * if (hasShape3dMesh(params.inputMesh)) {
+ *   const manifold = new Manifold(new Mesh(getShape3dMeshOptions(params.inputMesh)));
+ *   // use manifold...
+ * }
+ * ```
+ */
+export function hasShape3dMesh(shape3d) {
+    if (!shape3d?.meshData)
+        return false;
+    const { vertices, triangles } = shape3d.meshData;
+    // Need at least 1 triangle (3 vertices = 9 coords, 3 indices)
+    return !!(vertices && vertices.length >= 9 && triangles && triangles.length >= 3);
+}
+/**
+ * Get mesh options from a Shape3dValue for use with Manifold's Mesh constructor.
+ *
+ * IMPORTANT: Always call hasShape3dMesh() first to validate the shape,
+ * or use toManifold() for a simpler one-liner.
+ *
+ * @param shape3d - A Shape3dValue that has valid meshData (use hasShape3dMesh to check)
+ * @returns MeshOptions ready to pass to `new Mesh(options)`
+ *
+ * @example
+ * ```typescript
+ * import { Manifold, Mesh } from '@cadit-app/manifold-3d/manifoldCAD';
+ * import { hasShape3dMesh, getShape3dMeshOptions } from '@cadit-app/script-params';
+ *
+ * if (hasShape3dMesh(baseShape)) {
+ *   const opts = getShape3dMeshOptions(baseShape);
+ *   const manifold = new Manifold(new Mesh(opts));
+ * }
+ * ```
+ */
+export function getShape3dMeshOptions(shape3d) {
+    const { vertices, triangles } = shape3d.meshData;
+    return {
+        numProp: 3,
+        vertProperties: new Float32Array(vertices),
+        triVerts: new Uint32Array(triangles),
+    };
+}
+/**
+ * Convert a Shape3dValue to a Manifold in a single expression.
+ *
+ * This is a convenience function that combines hasShape3dMesh check and
+ * Manifold construction. Pass your Mesh and Manifold constructors.
+ *
+ * Note: We can't import Manifold/Mesh directly in script-params because
+ * manifold-3d requires async WASM initialization. The worker pre-initializes
+ * it and exposes the classes, which you import in your script.
+ *
+ * @param shape3d - The Shape3dValue from a shape3d parameter (may be null)
+ * @param Mesh - The Mesh constructor from manifold-3d
+ * @param Manifold - The Manifold constructor from manifold-3d
+ * @returns A Manifold object, or null if the shape3d is invalid
+ *
+ * @example
+ * ```typescript
+ * import { Manifold, Mesh } from '@cadit-app/manifold-3d/manifoldCAD';
+ * import { toManifold } from '@cadit-app/script-params';
+ *
+ * const manifoldA = toManifold(params.baseShape, Mesh, Manifold);
+ * const manifoldB = toManifold(params.sweepShape, Mesh, Manifold);
+ *
+ * if (manifoldA && manifoldB) {
+ *   return manifoldA.add(manifoldB);
+ * }
+ * ```
+ */
+export function toManifold(shape3d, Mesh, Manifold) {
+    if (!hasShape3dMesh(shape3d))
+        return null;
+    try {
+        const mesh = new Mesh(getShape3dMeshOptions(shape3d));
+        return new Manifold(mesh);
+    }
+    catch (error) {
+        console.error('[toManifold] Error creating manifold:', error);
+        return null;
+    }
+}
+//# sourceMappingURL=geometry.js.map

package/dist/params/geometry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"geometry.js","sourceRoot":"","sources":["../../src/params/geometry.ts"],"names":[],"mappings":"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"}

package/dist/params/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Parameter types and schema for CADit parametric scripts.
+ *
+ * Re-exports all parameter-related types from the params submodule.
+ */
+export type { ParamDefBase, NumberParamDef, FloatParamDef, IntParamDef, SliderParamDef, TextParamDef, FontParamDef, BooleanParamDef, SwitchParamDef, CheckboxParamDef, ChoiceOption, ChoiceParamDef, RadioParamDef, ImageFileValue, ImageParamDef, ButtonGridOption, ButtonGridParamDef, PresetOption, PresetParamDef, } from './types';
+export type { Point2D, Point3D, PathSegment, PathPoint, DoodlePath, SerializedShapeData, Shape2dValue, Shape2dParamDef, Triangle, SerializedMeshData, Shape3dValue, Shape3dParamDef, MeshOptions, } from './geometry';
+export { isPathSegment, getPathPointXY, samplePathTo2D, hasShape3dMesh, getShape3dMeshOptions, toManifold, } from './geometry';
+export type { EmbeddedParamDef, EmbeddedParamValue, ParamDef, ParamSchema, ParamValue, Params, } from './schema';
+//# sourceMappingURL=index.d.ts.map

package/dist/params/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/params/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,YAAY,EACV,YAAY,EAEZ,cAAc,EACd,aAAa,EACb,WAAW,EACX,cAAc,EAEd,YAAY,EACZ,YAAY,EAEZ,eAAe,EACf,cAAc,EACd,gBAAgB,EAEhB,YAAY,EACZ,cAAc,EACd,aAAa,EAEb,cAAc,EACd,aAAa,EAEb,gBAAgB,EAChB,kBAAkB,EAElB,YAAY,EACZ,cAAc,GACf,MAAM,SAAS,CAAC;AAGjB,YAAY,EACV,OAAO,EACP,OAAO,EACP,WAAW,EACX,SAAS,EACT,UAAU,EACV,mBAAmB,EACnB,YAAY,EACZ,eAAe,EACf,QAAQ,EACR,kBAAkB,EAClB,YAAY,EACZ,eAAe,EACf,WAAW,GACZ,MAAM,YAAY,CAAC;AAGpB,OAAO,EACL,aAAa,EACb,cAAc,EACd,cAAc,EACd,cAAc,EACd,qBAAqB,EACrB,UAAU,GACX,MAAM,YAAY,CAAC;AAGpB,YAAY,EACV,gBAAgB,EAChB,kBAAkB,EAClB,QAAQ,EACR,WAAW,EACX,UAAU,EACV,MAAM,GACP,MAAM,UAAU,CAAC"}

package/dist/params/index.js

@@ -0,0 +1,8 @@
+/**
+ * Parameter types and schema for CADit parametric scripts.
+ *
+ * Re-exports all parameter-related types from the params submodule.
+ */
+// Geometry utility functions
+export { isPathSegment, getPathPointXY, samplePathTo2D, hasShape3dMesh, getShape3dMeshOptions, toManifold, } from './geometry';
+//# sourceMappingURL=index.js.map

package/dist/params/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/params/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAiDH,6BAA6B;AAC7B,OAAO,EACL,aAAa,EACb,cAAc,EACd,cAAc,EACd,cAAc,EACd,qBAAqB,EACrB,UAAU,GACX,MAAM,YAAY,CAAC"}

package/dist/params/schema.d.ts

@@ -0,0 +1,95 @@
+/**
+ * Parameter schema and embedded parameter types.
+ *
+ * This module defines the EmbeddedParamDef for nesting parameters,
+ * the ParamDef union type, ParamSchema, and type inference utilities.
+ */
+import type { NumberParamDef, FloatParamDef, IntParamDef, SliderParamDef, TextParamDef, FontParamDef, BooleanParamDef, SwitchParamDef, CheckboxParamDef, ChoiceParamDef, RadioParamDef, ImageParamDef, ImageFileValue, ButtonGridParamDef, PresetParamDef, ParamDefBase } from './types';
+import type { Shape2dParamDef, Shape2dValue, Shape3dParamDef, Shape3dValue } from './geometry';
+/**
+ * Embedded parameter - nests another script's parameters.
+ * The embedded params can be enabled/disabled and expanded/collapsed.
+ *
+ * @example
+ * ```typescript
+ * import qrCodeScript from './qr-code';
+ *
+ * export default defineParams({
+ *   size: { type: 'number', default: 10 },
+ *   qrCode: {
+ *     type: 'embedded',
+ *     label: 'QR Code (Optional)',
+ *     params: qrCodeScript.params,
+ *     enabled: false,
+ *     showSettings: false
+ *   }
+ * }, (p) => {
+ *   if (p.qrCode.enabled) {
+ *     const qrMesh = qrCodeScript(p.qrCode.params);
+ *     // combine meshes...
+ *   }
+ * });
+ * ```
+ */
+export interface EmbeddedParamDef extends ParamDefBase {
+    type: 'embedded';
+    /** The nested parameter schema. */
+    params: ParamSchema;
+    /** Whether the embedded feature is initially enabled. */
+    enabled?: boolean;
+    /** Whether the settings panel is initially expanded. */
+    showSettings?: boolean;
+    /**
+     * NPM package name for resolving relative asset paths (like buttonGrid images).
+     * This is automatically set when using the `embedParams()` helper.
+     *
+     * @example '@cadit-app/qr-code'
+     */
+    npmPackage?: string;
+}
+/**
+ * Value type for embedded parameters.
+ * Contains the enabled state, showSettings state, and the resolved param values.
+ */
+export interface EmbeddedParamValue<S extends ParamSchema = ParamSchema> {
+    enabled: boolean;
+    showSettings: boolean;
+    params: Params<S>;
+}
+/**
+ * Union of all parameter definition types.
+ */
+export type ParamDef = NumberParamDef | FloatParamDef | IntParamDef | SliderParamDef | TextParamDef | FontParamDef | BooleanParamDef | SwitchParamDef | CheckboxParamDef | ChoiceParamDef | RadioParamDef | ImageParamDef | ButtonGridParamDef | PresetParamDef | Shape2dParamDef | Shape3dParamDef | EmbeddedParamDef;
+/**
+ * A schema defining all parameters for a script.
+ * Keys are parameter names, values are parameter definitions.
+ */
+export type ParamSchema = Record<string, ParamDef>;
+/**
+ * Infer the runtime value type from a parameter definition.
+ *
+ * @example
+ * ```typescript
+ * type T = ParamValue<{ type: 'number'; default: 10 }>; // number
+ * type S = ParamValue<{ type: 'text'; default: 'hi' }>;  // string
+ * ```
+ */
+export type ParamValue<P extends ParamDef> = P['type'] extends 'number' | 'float' | 'int' | 'slider' ? number : P['type'] extends 'text' | 'choice' | 'radio' | 'buttonGrid' | 'font' | 'preset' ? string : P['type'] extends 'boolean' | 'switch' | 'checkbox' ? boolean : P['type'] extends 'image' ? ImageFileValue | null : P['type'] extends 'shape2d' ? Shape2dValue | null : P['type'] extends 'shape3d' ? Shape3dValue | null : P['type'] extends 'embedded' ? P extends EmbeddedParamDef ? EmbeddedParamValue<P['params']> : EmbeddedParamValue : never;
+/**
+ * Infer the full params object type from a schema.
+ *
+ * @example
+ * ```typescript
+ * const schema = {
+ *   size: { type: 'number', default: 10 },
+ *   label: { type: 'text', default: 'Hi' },
+ * } as const;
+ *
+ * type P = Params<typeof schema>;
+ * // { size: number; label: string }
+ * ```
+ */
+export type Params<S extends ParamSchema> = {
+    [K in keyof S]: ParamValue<S[K]>;
+};
+//# sourceMappingURL=schema.d.ts.map

package/dist/params/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/params/schema.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EACV,cAAc,EACd,aAAa,EACb,WAAW,EACX,cAAc,EACd,YAAY,EACZ,YAAY,EACZ,eAAe,EACf,cAAc,EACd,gBAAgB,EAChB,cAAc,EACd,aAAa,EACb,aAAa,EACb,cAAc,EACd,kBAAkB,EAClB,cAAc,EACd,YAAY,EACb,MAAM,SAAS,CAAC;AAEjB,OAAO,KAAK,EACV,eAAe,EACf,YAAY,EACZ,eAAe,EACf,YAAY,EACb,MAAM,YAAY,CAAC;AAMpB;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,WAAW,gBAAiB,SAAQ,YAAY;IACpD,IAAI,EAAE,UAAU,CAAC;IACjB,mCAAmC;IACnC,MAAM,EAAE,WAAW,CAAC;IACpB,yDAAyD;IACzD,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,wDAAwD;IACxD,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB;;;;;OAKG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;GAGG;AACH,MAAM,WAAW,kBAAkB,CAAC,CAAC,SAAS,WAAW,GAAG,WAAW;IACrE,OAAO,EAAE,OAAO,CAAC;IACjB,YAAY,EAAE,OAAO,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC;CACnB;AAMD;;GAEG;AACH,MAAM,MAAM,QAAQ,GAEhB,cAAc,GACd,aAAa,GACb,WAAW,GACX,cAAc,GAEd,YAAY,GACZ,YAAY,GAEZ,eAAe,GACf,cAAc,GACd,gBAAgB,GAEhB,cAAc,GACd,aAAa,GAEb,aAAa,GACb,kBAAkB,GAElB,cAAc,GAEd,eAAe,GACf,eAAe,GAEf,gBAAgB,CAAC;AAErB;;;GAGG;AACH,MAAM,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;AAMnD;;;;;;;;GAQG;AACH,MAAM,MAAM,UAAU,CAAC,CAAC,SAAS,QAAQ,IAEvC,CAAC,CAAC,MAAM,CAAC,SAAS,QAAQ,GAAG,OAAO,GAAG,KAAK,GAAG,QAAQ,GACnD,MAAM,GAER,CAAC,CAAC,MAAM,CAAC,SAAS,MAAM,GAAG,QAAQ,GAAG,OAAO,GAAG,YAAY,GAAG,MAAM,GAAG,QAAQ,GAC9E,MAAM,GAER,CAAC,CAAC,MAAM,CAAC,SAAS,SAAS,GAAG,QAAQ,GAAG,UAAU,GACjD,OAAO,GAET,CAAC,CAAC,MAAM,CAAC,SAAS,OAAO,GACvB,cAAc,GAAG,IAAI,GAEvB,CAAC,CAAC,MAAM,CAAC,SAAS,SAAS,GACzB,YAAY,GAAG,IAAI,GACrB,CAAC,CAAC,MAAM,CAAC,SAAS,SAAS,GACzB,YAAY,GAAG,IAAI,GAErB,CAAC,CAAC,MAAM,CAAC,SAAS,UAAU,GAC1B,CAAC,SAAS,gBAAgB,GACxB,kBAAkB,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,GAC/B,kBAAkB,GACtB,KAAK,CAAC;AAEV;;;;;;;;;;;;;GAaG;AACH,MAAM,MAAM,MAAM,CAAC,CAAC,SAAS,WAAW,IAAI;KACzC,CAAC,IAAI,MAAM,CAAC,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;CACjC,CAAC"}

package/dist/params/schema.js

@@ -0,0 +1,8 @@
+/**
+ * Parameter schema and embedded parameter types.
+ *
+ * This module defines the EmbeddedParamDef for nesting parameters,
+ * the ParamDef union type, ParamSchema, and type inference utilities.
+ */
+export {};
+//# sourceMappingURL=schema.js.map

package/dist/params/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../src/params/schema.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/dist/params/types.d.ts

@@ -0,0 +1,239 @@
+/**
+ * Parameter definition types for CADit parametric scripts.
+ *
+ * This module defines all the parameter types that can be used in script definitions.
+ * Each parameter type maps to a corresponding UI input component in Core.
+ */
+/**
+ * Base properties shared by all parameter types.
+ */
+export interface ParamDefBase {
+    /** Human-readable label for the parameter. If omitted, the key is used. */
+    label?: string;
+    /** Description shown as tooltip or help text. */
+    description?: string;
+}
+/**
+ * Number parameter - floating point values.
+ */
+export interface NumberParamDef extends ParamDefBase {
+    type: 'number';
+    default: number;
+    min?: number;
+    max?: number;
+    step?: number;
+}
+/**
+ * Float parameter - alias for number (floating point values).
+ * This is provided for compatibility with Core's float type.
+ */
+export interface FloatParamDef extends ParamDefBase {
+    type: 'float';
+    default: number;
+    min?: number;
+    max?: number;
+    step?: number;
+}
+/**
+ * Integer parameter - whole number values.
+ */
+export interface IntParamDef extends ParamDefBase {
+    type: 'int';
+    default: number;
+    min?: number;
+    max?: number;
+    step?: number;
+}
+/**
+ * Slider parameter - number with visual slider control.
+ */
+export interface SliderParamDef extends ParamDefBase {
+    type: 'slider';
+    default: number;
+    min: number;
+    max: number;
+    step?: number;
+}
+/**
+ * Text parameter - string values.
+ */
+export interface TextParamDef extends ParamDefBase {
+    type: 'text';
+    default: string;
+    maxLength?: number;
+    placeholder?: string;
+}
+/**
+ * Font parameter - font selector.
+ * Allows selecting from available fonts in the CADit system.
+ */
+export interface FontParamDef extends ParamDefBase {
+    type: 'font';
+    default: string;
+}
+/**
+ * Boolean parameter - true/false toggle.
+ */
+export interface BooleanParamDef extends ParamDefBase {
+    type: 'boolean';
+    default: boolean;
+}
+/**
+ * Switch parameter - true/false toggle (alias for boolean).
+ * Renders as a toggle switch in the UI.
+ */
+export interface SwitchParamDef extends ParamDefBase {
+    type: 'switch';
+    default: boolean;
+}
+/**
+ * Checkbox parameter - true/false toggle (alias for boolean).
+ * Renders as a checkbox in the UI.
+ */
+export interface CheckboxParamDef extends ParamDefBase {
+    type: 'checkbox';
+    default: boolean;
+}
+/**
+ * Option for choice/radio parameter.
+ * Can be a simple string or an object with value and optional label.
+ */
+export type ChoiceOption = string | {
+    value: string;
+    label?: string;
+};
+/**
+ * Choice parameter - select from predefined options (dropdown).
+ * Options can be simple strings or objects with value/label pairs.
+ *
+ * @example
+ * ```typescript
+ * // Simple options
+ * color: { type: 'choice', default: 'red', options: ['red', 'green', 'blue'] }
+ *
+ * // Options with labels
+ * errorLevel: {
+ *   type: 'choice',
+ *   default: 'M',
+ *   options: [
+ *     { value: 'L', label: 'L - ~7% recovery' },
+ *     { value: 'M', label: 'M - ~15% recovery' },
+ *     { value: 'Q', label: 'Q - ~25% recovery' },
+ *     { value: 'H', label: 'H - ~30% recovery' },
+ *   ]
+ * }
+ * ```
+ */
+export interface ChoiceParamDef extends ParamDefBase {
+    type: 'choice';
+    default: string;
+    options: readonly ChoiceOption[];
+}
+/**
+ * Radio parameter - select from predefined options (radio buttons).
+ * Similar to choice but renders as radio buttons instead of a dropdown.
+ * Options can be simple strings or objects with value/label pairs.
+ *
+ * @example
+ * ```typescript
+ * alignment: {
+ *   type: 'radio',
+ *   default: 'center',
+ *   options: ['left', 'center', 'right']
+ * }
+ * ```
+ */
+export interface RadioParamDef extends ParamDefBase {
+    type: 'radio';
+    default: string;
+    options: readonly ChoiceOption[];
+}
+/**
+ * Value type for image parameters.
+ * Represents an image file that can be loaded via URL or embedded as a data URL.
+ */
+export interface ImageFileValue {
+    /** Remote URL to fetch the image from (e.g., HTTP URL or relative path). */
+    imageUrl?: string;
+    /** Base64-encoded data URL of the image content. */
+    dataUrl?: string;
+    /** MIME type of the image (e.g., 'image/svg+xml', 'image/png'). */
+    fileType?: string;
+    /** Original filename of the image. */
+    fileName?: string;
+}
+/**
+ * Image parameter - for image file uploads with URL or data URL.
+ */
+export interface ImageParamDef extends ParamDefBase {
+    type: 'image';
+    default: ImageFileValue | null;
+}
+/**
+ * Option for buttonGrid parameter.
+ * Each option can have an image, caption, or both.
+ */
+export interface ButtonGridOption {
+    /** The value returned when this option is selected. */
+    value: string;
+    /** Optional image URL (absolute or relative to script location). */
+    image?: string;
+    /** Optional caption/label for the button. Used as alt text if image is present. */
+    caption?: string;
+}
+/**
+ * ButtonGrid parameter - visual grid of buttons with images/captions.
+ * Useful for pattern selection, style options, etc.
+ *
+ * @example
+ * ```typescript
+ * pattern: {
+ *   type: 'buttonGrid',
+ *   default: 'style1',
+ *   options: [
+ *     { value: 'style1', image: './images/style1.svg', caption: 'Style 1' },
+ *     { value: 'style2', image: './images/style2.svg', caption: 'Style 2' },
+ *   ]
+ * }
+ * ```
+ */
+export interface ButtonGridParamDef extends ParamDefBase {
+    type: 'buttonGrid';
+    default: string;
+    options: readonly ButtonGridOption[];
+}
+/**
+ * A preset option that contains predefined parameter values.
+ * @template T - The type of the preset values object.
+ */
+export interface PresetOption<T = Record<string, unknown>> {
+    /** The value/identifier for this preset. */
+    value: string;
+    /** Human-readable label for the preset. */
+    label: string;
+    /** Partial parameter values to apply when this preset is selected. */
+    presetValues: Partial<T>;
+}
+/**
+ * Preset parameter - allows selecting from predefined parameter configurations.
+ * When a preset is selected, it overrides multiple other parameter values.
+ *
+ * @example
+ * ```typescript
+ * preset: {
+ *   type: 'preset',
+ *   default: 'small',
+ *   presets: [
+ *     { value: 'small', label: 'Small', presetValues: { width: 10, height: 10 } },
+ *     { value: 'medium', label: 'Medium', presetValues: { width: 20, height: 20 } },
+ *     { value: 'large', label: 'Large', presetValues: { width: 40, height: 40 } },
+ *   ]
+ * }
+ * ```
+ */
+export interface PresetParamDef<T = Record<string, unknown>> extends ParamDefBase {
+    type: 'preset';
+    default: string;
+    presets: readonly PresetOption<T>[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/params/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/params/types.ts"],"names":[],"mappings":"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"}

package/dist/params/types.js

@@ -0,0 +1,8 @@
+/**
+ * Parameter definition types for CADit parametric scripts.
+ *
+ * This module defines all the parameter types that can be used in script definitions.
+ * Each parameter type maps to a corresponding UI input component in Core.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/params/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/params/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}