@faicad/sheetmetal 0.13.0

package/dist/facade.js

@@ -0,0 +1,535 @@
+/**
+ * Fluent facade — `sheetMetal(base).flange(...).miter(...).unfold()`.
+ *
+ * A lightweight immutable builder over the {@link ./api.js} wrappers. Authoring
+ * steps (`flange`, `material`) accumulate into a spec; part-consuming steps
+ * (`miter`, `miterCorner`, `unfold`, `report`, `dxf`, `validate`, `part`)
+ * materialize the folded part once and thread it through, auto-unwrapping the
+ * underlying `Result<T>` and throwing {@link SheetMetalError} on failure so the
+ * chain stays terminal-free. Use the `Result`-returning functions in `./api.js`
+ * directly when explicit error handling is preferred over throwing.
+ */
+import { isErr } from '@faicad/faijs/brepjs-compat';
+import { author, unfold, unfoldSolid, fold, miter, miterCorner, bendRelief, autoReliefs, relieveCorner, addCutout, addHole, addSlot, addPolygonCutout, addTab, tabAndSlot, louver, emboss, contourFlange, loftedFlange, hem, jog, toDXF, report, validate, } from './api.js';
+/** Thrown by the fluent facade when an underlying `Result<T>` is an `Err`. */
+export class SheetMetalError extends Error {
+    /** The machine-readable error code from the underlying `BrepError`. */
+    code;
+    /** The error kind/category from the underlying `BrepError`. */
+    kind;
+    constructor(brepError) {
+        super(brepError.suggestion
+            ? `${brepError.message}\nSuggestion: ${brepError.suggestion}`
+            : brepError.message);
+        this.name = 'SheetMetalError';
+        this.code = brepError.code;
+        this.kind = brepError.kind;
+    }
+}
+function unwrapOrThrow(result) {
+    if (isErr(result)) {
+        throw new SheetMetalError(result.error);
+    }
+    return result.value;
+}
+/** A built part already mitered/operated on, re-entering the fluent chain. */
+class SheetMetalPartHandle {
+    part;
+    constructor(part) {
+        this.part = part;
+    }
+    /**
+     * Cut by an oriented plane, removing material on the `+normal` side.
+     * @param plane - the oriented cutting plane; material on the plane's `+normal` side is removed.
+     * @returns a new `SheetMetalPartHandle` carrying the mitered part.
+     */
+    miter(plane) {
+        return new SheetMetalPartHandle(unwrapOrThrow(miter(this.part, plane)));
+    }
+    /**
+     * Auto-miter the shared corner of two flanges with an optional gap.
+     * @param flangeIdA - id of the first flange meeting at the corner.
+     * @param flangeIdB - id of the second flange meeting at the corner.
+     * @param gap - optional gap (in millimetres) left between the two mitered edges; defaults to 0.
+     * @returns a new `SheetMetalPartHandle` carrying the part with the corner mitered.
+     */
+    miterCorner(flangeIdA, flangeIdB, gap = 0) {
+        return new SheetMetalPartHandle(unwrapOrThrow(miterCorner(this.part, flangeIdA, flangeIdB, gap)));
+    }
+    /**
+     * Add a bend relief at each mid-edge end of a partial flange's bend line.
+     * @param flangeId - id of the partial flange whose bend-line ends get the relief.
+     * @param spec - optional relief specification overriding the defaults.
+     * @returns a new `SheetMetalPartHandle` carrying the part with the relief added.
+     */
+    bendRelief(flangeId, spec) {
+        return new SheetMetalPartHandle(unwrapOrThrow(bendRelief(this.part, flangeId, spec)));
+    }
+    /**
+     * Add a bend relief to every partial-span bend in the part.
+     * @param spec - optional relief specification applied to every partial bend.
+     * @returns a new `SheetMetalPartHandle` carrying the part with all reliefs added.
+     */
+    autoReliefs(spec) {
+        return new SheetMetalPartHandle(unwrapOrThrow(autoReliefs(this.part, spec)));
+    }
+    /**
+     * Cut a corner relief notch at the shared corner of two adjacent flanges.
+     * @param flangeIdA - id of the first flange forming the corner.
+     * @param flangeIdB - id of the second flange forming the corner.
+     * @param spec - optional relief specification overriding the defaults.
+     * @returns a new `SheetMetalPartHandle` carrying the part with the corner relief added.
+     */
+    cornerRelief(flangeIdA, flangeIdB, spec) {
+        return new SheetMetalPartHandle(unwrapOrThrow(relieveCorner(this.part, flangeIdA, flangeIdB, spec)));
+    }
+    /**
+     * Punch a cutout (hole / slot / polygon) through a named flat region.
+     * @param spec - the cutout definition (kind, geometry, and target region).
+     * @returns a new `SheetMetalPartHandle` carrying the part with the cutout punched.
+     */
+    cutout(spec) {
+        return new SheetMetalPartHandle(unwrapOrThrow(addCutout(this.part, spec)));
+    }
+    /**
+     * Punch a circular hole of `diameter` centred at region-local `(x, y)`.
+     * @param region - name of the flat region the hole is punched through.
+     * @param x - region-local X of the hole centre.
+     * @param y - region-local Y of the hole centre.
+     * @param diameter - hole diameter.
+     * @returns a new `SheetMetalPartHandle` carrying the part with the hole punched.
+     */
+    hole(region, x, y, diameter) {
+        return new SheetMetalPartHandle(unwrapOrThrow(addHole(this.part, region, x, y, diameter)));
+    }
+    /**
+     * Punch a slot (rectangular or obround) centred at region-local `(x, y)`.
+     * @param region - name of the flat region the slot is punched through.
+     * @param opts - slot geometry: centre `(x, y)`, `length`, `width`, optional `angleDeg` rotation, and `round` ends flag.
+     * @returns a new `SheetMetalPartHandle` carrying the part with the slot punched.
+     */
+    slot(region, opts) {
+        return new SheetMetalPartHandle(unwrapOrThrow(addSlot(this.part, region, opts)));
+    }
+    /**
+     * Punch an arbitrary polygon cutout from its region-local `points`.
+     * @param region - name of the flat region the polygon is punched through.
+     * @param points - region-local polygon vertices as `[x, y]` pairs.
+     * @returns a new `SheetMetalPartHandle` carrying the part with the polygon cutout.
+     */
+    polygonCutout(region, points) {
+        return new SheetMetalPartHandle(unwrapOrThrow(addPolygonCutout(this.part, region, points)));
+    }
+    /**
+     * Fuse a rectangular tab (additive protrusion) onto a region's edge.
+     * @param spec - tab definition: edge, width, and length.
+     * @returns a new `SheetMetalPartHandle` carrying the part with the tab added.
+     */
+    tab(spec) {
+        return new SheetMetalPartHandle(unwrapOrThrow(addTab(this.part, spec)));
+    }
+    /**
+     * Self-fixturing tab-and-slot joint: a tab on one region + a matching slot on another.
+     * @param tab - the tab to add to the first region.
+     * @param slot - placement of the matching slot on the second region.
+     * @returns a new `SheetMetalPartHandle` carrying the part with the joint added.
+     */
+    tabAndSlot(tab, slot) {
+        return new SheetMetalPartHandle(unwrapOrThrow(tabAndSlot(this.part, tab, slot)));
+    }
+    /**
+     * Form a louver (vent flap) on a region.
+     * @param opts - louver geometry: target `region`, centre `(x, y)`, `length`, `width`, `height`, and optional `direction`.
+     * @returns a new `SheetMetalPartHandle` carrying the part with the louver formed.
+     */
+    louver(opts) {
+        return new SheetMetalPartHandle(unwrapOrThrow(louver(this.part, opts)));
+    }
+    /**
+     * Form a round emboss (raised) or dimple (recessed) on a region.
+     * @param opts - emboss geometry: target `region`, centre `(x, y)`, `diameter`, `height`, and `kind` (`dimple` or `emboss`).
+     * @returns a new `SheetMetalPartHandle` carrying the part with the form added.
+     */
+    emboss(opts) {
+        return new SheetMetalPartHandle(unwrapOrThrow(emboss(this.part, opts)));
+    }
+    /**
+     * Author a contour flange (open line/arc profile swept along a base edge).
+     * @param spec - contour flange definition: profile, base edge, and bend parameters.
+     * @returns a new `SheetMetalPartHandle` carrying the part with the contour flange added.
+     */
+    contourFlange(spec) {
+        return new SheetMetalPartHandle(unwrapOrThrow(contourFlange(this.part, spec)));
+    }
+    /**
+     * Author a lofted / ruled transition flange between two parallel open profiles.
+     * @param spec - lofted flange definition: the two open profiles and their alignment.
+     * @returns a new `SheetMetalPartHandle` carrying the part with the lofted flange added.
+     */
+    loftedFlange(spec) {
+        return new SheetMetalPartHandle(unwrapOrThrow(loftedFlange(this.part, spec)));
+    }
+    /**
+     * Fold a region edge back ~180°+ onto its parent as a hem (closed/open/teardrop/rolled).
+     * @param spec - hem definition: edge, curl radius, and return leg length.
+     * @returns a new `SheetMetalPartHandle` carrying the part with the hem added.
+     */
+    hem(spec) {
+        return new SheetMetalPartHandle(unwrapOrThrow(hem(this.part, spec)));
+    }
+    /**
+     * Step a region's flat by `offsetHeight` with two opposite bends (a jog/joggle).
+     * @param spec - jog definition: bend line, offset height, and radii.
+     * @returns a new `SheetMetalPartHandle` carrying the part with the jog added.
+     */
+    jog(spec) {
+        return new SheetMetalPartHandle(unwrapOrThrow(jog(this.part, spec)));
+    }
+    /**
+     * Flatten into a developed flat pattern + bend report + warnings.
+     * @returns the `UnfoldResult` with the flat pattern, bend report, and any warnings.
+     */
+    unfold() {
+        return unwrapOrThrow(unfold(this.part));
+    }
+    /**
+     * Just the flat pattern from the unfold.
+     * @returns the developed `FlatPattern`.
+     */
+    flatPattern() {
+        return this.unfold().pattern;
+    }
+    /**
+     * Bend report built from the feature tree.
+     * @returns the `BendReport` describing every bend in the part.
+     */
+    report() {
+        return unwrapOrThrow(report(this.part));
+    }
+    /**
+     * Annotated multi-layer DXF of the developed flat pattern.
+     * @param options - optional DXF output options (layers, precision, units).
+     * @returns the DXF text of the developed flat pattern.
+     */
+    dxf(options) {
+        return unwrapOrThrow(toDXF(this.flatPattern(), options));
+    }
+    /**
+     * Manufacturability warnings (advisory, never throws).
+     * @returns the list of `SheetMetalWarning`s (empty when the part is manufacturable).
+     */
+    validate() {
+        return validate(this.part);
+    }
+    /**
+     * The materialized part (escape hatch back to the functional API).
+     * @returns the underlying `SheetMetalPart`.
+     */
+    get() {
+        return this.part;
+    }
+}
+/**
+ * An imported foreign solid (no feature tree) re-entering the fluent chain: detect
+ * its geometry and unfold it. `kFactor` defaults to the mid-surface neutral axis.
+ */
+class ForeignSolidHandle {
+    solid;
+    opts;
+    constructor(solid, opts) {
+        this.solid = solid;
+        this.opts = opts;
+    }
+    /**
+     * Override the neutral-axis K-factor (default 0.5, the mid-surface).
+     * @param kFactor - the K-factor to use for the bend allowance.
+     * @returns a new `ForeignSolidHandle` with the K-factor applied.
+     */
+    kFactor(kFactor) {
+        return new ForeignSolidHandle(this.solid, { ...this.opts, kFactor });
+    }
+    /**
+     * Detect geometry and flatten into a developed flat pattern + report + warnings.
+     * @returns the `UnfoldResult` with the detected flat pattern, report, and any warnings.
+     */
+    unfold() {
+        return unwrapOrThrow(unfoldSolid(this.solid, this.opts));
+    }
+    /**
+     * Just the flat pattern from the detected unfold.
+     * @returns the developed `FlatPattern`.
+     */
+    flatPattern() {
+        return this.unfold().pattern;
+    }
+    /**
+     * Annotated multi-layer DXF of the developed flat pattern.
+     * @param options - optional DXF output options (layers, precision, units).
+     * @returns the DXF text of the developed flat pattern.
+     */
+    dxf(options) {
+        return unwrapOrThrow(toDXF(this.flatPattern(), options));
+    }
+}
+/** Authoring builder — accumulates the base/flanges/material spec, then folds. */
+class SheetMetalBuilder {
+    spec;
+    built;
+    constructor(spec) {
+        this.spec = spec;
+    }
+    /**
+     * Add a flange folded off its parent edge (the base by default).
+     * @param flange - the flange definition to add.
+     * @returns a new `SheetMetalBuilder` with the flange appended to the spec.
+     */
+    flange(flange) {
+        return new SheetMetalBuilder({ ...this.spec, flanges: [...this.spec.flanges, flange] });
+    }
+    /**
+     * Add a seam closing a profile into a tube/box (left unfolded).
+     * @param seam - the seam definition to add.
+     * @returns a new `SheetMetalBuilder` with the seam appended to the spec.
+     */
+    seam(seam) {
+        return new SheetMetalBuilder({ ...this.spec, seams: [...(this.spec.seams ?? []), seam] });
+    }
+    /**
+     * Set the part material (its thickness/default rule).
+     * @param material - the material definition (thickness / default rule).
+     * @returns a new `SheetMetalBuilder` with the material set.
+     */
+    material(material) {
+        return new SheetMetalBuilder({ ...this.spec, material });
+    }
+    /**
+     * Fold the accumulated spec into a 3D part, re-entering the fluent chain.
+     * Memoized so chaining multiple terminal shortcuts (e.g. `unfold()` then
+     * `report()`) authors the solid only once.
+     * @returns a `SheetMetalPartHandle` for the folded part, memoized across calls.
+     */
+    build() {
+        this.built ??= new SheetMetalPartHandle(unwrapOrThrow(author(this.spec)));
+        return this.built;
+    }
+    // ----- part-consuming shortcuts (build then delegate) -----
+    /**
+     * Build the part and cut it by an oriented plane, removing material on the `+normal` side.
+     * @param plane - the oriented cutting plane; material on the plane's `+normal` side is removed.
+     * @returns a `SheetMetalPartHandle` carrying the mitered part.
+     */
+    miter(plane) {
+        return this.build().miter(plane);
+    }
+    /**
+     * Build the part and auto-miter the shared corner of two flanges with an optional gap.
+     * @param flangeIdA - id of the first flange meeting at the corner.
+     * @param flangeIdB - id of the second flange meeting at the corner.
+     * @param gap - optional gap (in millimetres) left between the two mitered edges; defaults to 0.
+     * @returns a `SheetMetalPartHandle` carrying the part with the corner mitered.
+     */
+    miterCorner(flangeIdA, flangeIdB, gap = 0) {
+        return this.build().miterCorner(flangeIdA, flangeIdB, gap);
+    }
+    /**
+     * Build the part and add a bend relief at each mid-edge end of a partial flange's bend line.
+     * @param flangeId - id of the partial flange whose bend-line ends get the relief.
+     * @param spec - optional relief specification overriding the defaults.
+     * @returns a `SheetMetalPartHandle` carrying the part with the relief added.
+     */
+    bendRelief(flangeId, spec) {
+        return this.build().bendRelief(flangeId, spec);
+    }
+    /**
+     * Build the part and add a bend relief to every partial-span bend.
+     * @param spec - optional relief specification applied to every partial bend.
+     * @returns a `SheetMetalPartHandle` carrying the part with all reliefs added.
+     */
+    autoReliefs(spec) {
+        return this.build().autoReliefs(spec);
+    }
+    /**
+     * Build the part and cut a corner relief notch at the shared corner of two adjacent flanges.
+     * @param flangeIdA - id of the first flange forming the corner.
+     * @param flangeIdB - id of the second flange forming the corner.
+     * @param spec - optional relief specification overriding the defaults.
+     * @returns a `SheetMetalPartHandle` carrying the part with the corner relief added.
+     */
+    cornerRelief(flangeIdA, flangeIdB, spec) {
+        return this.build().cornerRelief(flangeIdA, flangeIdB, spec);
+    }
+    /**
+     * Build the part and punch a cutout (hole / slot / polygon) through a named flat region.
+     * @param spec - the cutout definition (kind, geometry, and target region).
+     * @returns a `SheetMetalPartHandle` carrying the part with the cutout punched.
+     */
+    cutout(spec) {
+        return this.build().cutout(spec);
+    }
+    /**
+     * Build the part and punch a circular hole of `diameter` centred at region-local `(x, y)`.
+     * @param region - name of the flat region the hole is punched through.
+     * @param x - region-local X of the hole centre.
+     * @param y - region-local Y of the hole centre.
+     * @param diameter - hole diameter.
+     * @returns a `SheetMetalPartHandle` carrying the part with the hole punched.
+     */
+    hole(region, x, y, diameter) {
+        return this.build().hole(region, x, y, diameter);
+    }
+    /**
+     * Build the part and punch a slot (rectangular or obround) centred at region-local `(x, y)`.
+     * @param region - name of the flat region the slot is punched through.
+     * @param opts - slot geometry: centre `(x, y)`, `length`, `width`, optional `angleDeg` rotation, and `round` ends flag.
+     * @returns a `SheetMetalPartHandle` carrying the part with the slot punched.
+     */
+    slot(region, opts) {
+        return this.build().slot(region, opts);
+    }
+    /**
+     * Build the part and punch an arbitrary polygon cutout from its region-local `points`.
+     * @param region - name of the flat region the polygon is punched through.
+     * @param points - region-local polygon vertices as `[x, y]` pairs.
+     * @returns a `SheetMetalPartHandle` carrying the part with the polygon cutout.
+     */
+    polygonCutout(region, points) {
+        return this.build().polygonCutout(region, points);
+    }
+    /**
+     * Build the part and fuse a rectangular tab (additive protrusion) onto a region's edge.
+     * @param spec - tab definition: edge, width, and length.
+     * @returns a `SheetMetalPartHandle` carrying the part with the tab added.
+     */
+    tab(spec) {
+        return this.build().tab(spec);
+    }
+    /**
+     * Build the part and add a self-fixturing tab-and-slot joint across two regions.
+     * @param tab - the tab to add to the first region.
+     * @param slot - placement of the matching slot on the second region.
+     * @returns a `SheetMetalPartHandle` carrying the part with the joint added.
+     */
+    tabAndSlot(tab, slot) {
+        return this.build().tabAndSlot(tab, slot);
+    }
+    /**
+     * Build the part and form a louver (vent flap) on a region.
+     * @param opts - louver geometry: target `region`, centre `(x, y)`, `length`, `width`, `height`, and optional `direction`.
+     * @returns a `SheetMetalPartHandle` carrying the part with the louver formed.
+     */
+    louver(opts) {
+        return this.build().louver(opts);
+    }
+    /**
+     * Build the part and form a round emboss (raised) or dimple (recessed) on a region.
+     * @param opts - emboss geometry: target `region`, centre `(x, y)`, `diameter`, `height`, and `kind` (`dimple` or `emboss`).
+     * @returns a `SheetMetalPartHandle` carrying the part with the form added.
+     */
+    emboss(opts) {
+        return this.build().emboss(opts);
+    }
+    /**
+     * Build the part and author a contour flange (open line/arc profile swept along a base edge).
+     * @param spec - contour flange definition: profile, base edge, and bend parameters.
+     * @returns a `SheetMetalPartHandle` carrying the part with the contour flange added.
+     */
+    contourFlange(spec) {
+        return this.build().contourFlange(spec);
+    }
+    /**
+     * Build the part and author a lofted / ruled transition flange between two parallel open profiles.
+     * @param spec - lofted flange definition: the two open profiles and their alignment.
+     * @returns a `SheetMetalPartHandle` carrying the part with the lofted flange added.
+     */
+    loftedFlange(spec) {
+        return this.build().loftedFlange(spec);
+    }
+    /**
+     * Build the part and fold a region edge back ~180°+ onto its parent as a hem.
+     * @param spec - hem definition: edge, curl radius, and return leg length.
+     * @returns a `SheetMetalPartHandle` carrying the part with the hem added.
+     */
+    hem(spec) {
+        return this.build().hem(spec);
+    }
+    /**
+     * Build the part and step a region's flat by `offsetHeight` with two opposite bends (a jog/joggle).
+     * @param spec - jog definition: bend line, offset height, and radii.
+     * @returns a `SheetMetalPartHandle` carrying the part with the jog added.
+     */
+    jog(spec) {
+        return this.build().jog(spec);
+    }
+    /**
+     * Build the part and flatten it into a developed flat pattern + bend report + warnings.
+     * @returns the `UnfoldResult` with the flat pattern, bend report, and any warnings.
+     */
+    unfold() {
+        return this.build().unfold();
+    }
+    /**
+     * Build the part and produce the bend report from its feature tree.
+     * @returns the `BendReport` describing every bend in the part.
+     */
+    report() {
+        return this.build().report();
+    }
+    /**
+     * Build the part and emit an annotated multi-layer DXF of its developed flat pattern.
+     * @param options - optional DXF output options (layers, precision, units).
+     * @returns the DXF text of the developed flat pattern.
+     */
+    dxf(options) {
+        return this.build().dxf(options);
+    }
+    /**
+     * Build the part and run manufacturability checks (advisory, never throws).
+     * @returns the list of `SheetMetalWarning`s (empty when the part is manufacturable).
+     */
+    validate() {
+        return this.build().validate();
+    }
+    /**
+     * Build the part and return it (escape hatch back to the functional API).
+     * @returns the underlying `SheetMetalPart`.
+     */
+    get() {
+        return this.build().get();
+    }
+}
+/**
+ * Start a fluent sheet-metal chain from a base flat (`length × width`).
+ * @param base - the base flat definition (length × width).
+ * @param thickness - the sheet material thickness in millimetres.
+ * @returns a `SheetMetalBuilder` ready for authoring steps like `flange`/`seam`/`material`.
+ */
+export function sheetMetal(base, thickness) {
+    return new SheetMetalBuilder({ thickness, base, flanges: [] });
+}
+/**
+ * Re-enter the fluent chain from an already-authored part.
+ * @param part - an authored sheet-metal part to operate on.
+ * @returns a `SheetMetalPartHandle` wrapping the part.
+ */
+export function fromPart(part) {
+    return new SheetMetalPartHandle(part);
+}
+/**
+ * Fold a flat pattern up into a part and re-enter the fluent chain.
+ * @param input - the flat pattern (region tree) to fold up.
+ * @returns a `SheetMetalPartHandle` carrying the folded part.
+ */
+export function foldFlat(input) {
+    return new SheetMetalPartHandle(unwrapOrThrow(fold(input)));
+}
+/**
+ * Detect and unfold an imported foreign sheet-metal solid (no feature tree).
+ * @param solid - the imported solid (B-rep) to unfold.
+ * @param opts - optional overrides; `opts.kFactor` sets the K-factor used for the bend allowance.
+ * @returns a `ForeignSolidHandle` for detecting and unfolding the solid.
+ */
+export function fromSolid(solid, opts) {
+    return new ForeignSolidHandle(solid, opts);
+}
+export { SheetMetalBuilder, SheetMetalPartHandle, ForeignSolidHandle };
+//# sourceMappingURL=facade.js.map

package/dist/facade.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"facade.js","sourceRoot":"","sources":["../src/facade.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Fluent facade — `sheetMetal(base).flange(...).miter(...).unfold()`.\n *\n * A lightweight immutable builder over the {@link ./api.js} wrappers. Authoring\n * steps (`flange`, `material`) accumulate into a spec; part-consuming steps\n * (`miter`, `miterCorner`, `unfold`, `report`, `dxf`, `validate`, `part`)\n * materialize the folded part once and thread it through, auto-unwrapping the\n * underlying `Result<T>` and throwing {@link SheetMetalError} on failure so the\n * chain stays terminal-free. Use the `Result`-returning functions in `./api.js`\n * directly when explicit error handling is preferred over throwing.\n */\n\nimport type { BrepError, Result, Solid } from '@faicad/faijs/brepjs-compat';\nimport { isErr } from '@faicad/faijs/brepjs-compat';\nimport type { AuthorSpec, BaseFlatSpec, FlangeSpec, SeamSpec } from './authorFns.js';\nimport type { MiterPlane, DxfOptions, SlotPlacement } from './api.js';\nimport {\n  author,\n  unfold,\n  unfoldSolid,\n  fold,\n  miter,\n  miterCorner,\n  bendRelief,\n  autoReliefs,\n  relieveCorner,\n  addCutout,\n  addHole,\n  addSlot,\n  addPolygonCutout,\n  addTab,\n  tabAndSlot,\n  louver,\n  emboss,\n  contourFlange,\n  loftedFlange,\n  hem,\n  jog,\n  toDXF,\n  report,\n  validate,\n} from './api.js';\nimport type {\n  SheetMetalPart,\n  FlatPattern,\n  FlatInput,\n  BendReport,\n  MaterialSpec,\n  ReliefSpec,\n  CutoutSpec,\n  TabSpec,\n  ContourFlangeSpec,\n  LoftedFlangeSpec,\n  HemSpec,\n  JogSpec,\n  SheetMetalWarning,\n  UnfoldResult,\n} from './types.js';\n\n/** Thrown by the fluent facade when an underlying `Result<T>` is an `Err`. */\nexport class SheetMetalError extends Error {\n  /** The machine-readable error code from the underlying `BrepError`. */\n  readonly code: string;\n  /** The error kind/category from the underlying `BrepError`. */\n  readonly kind: string;\n\n  constructor(brepError: BrepError) {\n    super(\n      brepError.suggestion\n        ? `${brepError.message}\\nSuggestion: ${brepError.suggestion}`\n        : brepError.message\n    );\n    this.name = 'SheetMetalError';\n    this.code = brepError.code;\n    this.kind = brepError.kind;\n  }\n}\n\nfunction unwrapOrThrow<T>(result: Result<T>): T {\n  if (isErr(result)) {\n    throw new SheetMetalError(result.error);\n  }\n  return result.value;\n}\n\n/** A built part already mitered/operated on, re-entering the fluent chain. */\nclass SheetMetalPartHandle {\n  constructor(readonly part: SheetMetalPart) {}\n\n  /**\n   * Cut by an oriented plane, removing material on the `+normal` side.\n   * @param plane - the oriented cutting plane; material on the plane's `+normal` side is removed.\n   * @returns a new `SheetMetalPartHandle` carrying the mitered part.\n   */\n  miter(plane: MiterPlane): SheetMetalPartHandle {\n    return new SheetMetalPartHandle(unwrapOrThrow(miter(this.part, plane)));\n  }\n\n  /**\n   * Auto-miter the shared corner of two flanges with an optional gap.\n   * @param flangeIdA - id of the first flange meeting at the corner.\n   * @param flangeIdB - id of the second flange meeting at the corner.\n   * @param gap - optional gap (in millimetres) left between the two mitered edges; defaults to 0.\n   * @returns a new `SheetMetalPartHandle` carrying the part with the corner mitered.\n   */\n  miterCorner(flangeIdA: string, flangeIdB: string, gap = 0): SheetMetalPartHandle {\n    return new SheetMetalPartHandle(unwrapOrThrow(miterCorner(this.part, flangeIdA, flangeIdB, gap)));\n  }\n\n  /**\n   * Add a bend relief at each mid-edge end of a partial flange's bend line.\n   * @param flangeId - id of the partial flange whose bend-line ends get the relief.\n   * @param spec - optional relief specification overriding the defaults.\n   * @returns a new `SheetMetalPartHandle` carrying the part with the relief added.\n   */\n  bendRelief(flangeId: string, spec?: ReliefSpec): SheetMetalPartHandle {\n    return new SheetMetalPartHandle(unwrapOrThrow(bendRelief(this.part, flangeId, spec)));\n  }\n\n  /**\n   * Add a bend relief to every partial-span bend in the part.\n   * @param spec - optional relief specification applied to every partial bend.\n   * @returns a new `SheetMetalPartHandle` carrying the part with all reliefs added.\n   */\n  autoReliefs(spec?: ReliefSpec): SheetMetalPartHandle {\n    return new SheetMetalPartHandle(unwrapOrThrow(autoReliefs(this.part, spec)));\n  }\n\n  /**\n   * Cut a corner relief notch at the shared corner of two adjacent flanges.\n   * @param flangeIdA - id of the first flange forming the corner.\n   * @param flangeIdB - id of the second flange forming the corner.\n   * @param spec - optional relief specification overriding the defaults.\n   * @returns a new `SheetMetalPartHandle` carrying the part with the corner relief added.\n   */\n  cornerRelief(flangeIdA: string, flangeIdB: string, spec?: ReliefSpec): SheetMetalPartHandle {\n    return new SheetMetalPartHandle(unwrapOrThrow(relieveCorner(this.part, flangeIdA, flangeIdB, spec)));\n  }\n\n  /**\n   * Punch a cutout (hole / slot / polygon) through a named flat region.\n   * @param spec - the cutout definition (kind, geometry, and target region).\n   * @returns a new `SheetMetalPartHandle` carrying the part with the cutout punched.\n   */\n  cutout(spec: CutoutSpec): SheetMetalPartHandle {\n    return new SheetMetalPartHandle(unwrapOrThrow(addCutout(this.part, spec)));\n  }\n\n  /**\n   * Punch a circular hole of `diameter` centred at region-local `(x, y)`.\n   * @param region - name of the flat region the hole is punched through.\n   * @param x - region-local X of the hole centre.\n   * @param y - region-local Y of the hole centre.\n   * @param diameter - hole diameter.\n   * @returns a new `SheetMetalPartHandle` carrying the part with the hole punched.\n   */\n  hole(region: string, x: number, y: number, diameter: number): SheetMetalPartHandle {\n    return new SheetMetalPartHandle(unwrapOrThrow(addHole(this.part, region, x, y, diameter)));\n  }\n\n  /**\n   * Punch a slot (rectangular or obround) centred at region-local `(x, y)`.\n   * @param region - name of the flat region the slot is punched through.\n   * @param opts - slot geometry: centre `(x, y)`, `length`, `width`, optional `angleDeg` rotation, and `round` ends flag.\n   * @returns a new `SheetMetalPartHandle` carrying the part with the slot punched.\n   */\n  slot(\n    region: string,\n    opts: { x: number; y: number; length: number; width: number; angleDeg?: number; round?: boolean }\n  ): SheetMetalPartHandle {\n    return new SheetMetalPartHandle(unwrapOrThrow(addSlot(this.part, region, opts)));\n  }\n\n  /**\n   * Punch an arbitrary polygon cutout from its region-local `points`.\n   * @param region - name of the flat region the polygon is punched through.\n   * @param points - region-local polygon vertices as `[x, y]` pairs.\n   * @returns a new `SheetMetalPartHandle` carrying the part with the polygon cutout.\n   */\n  polygonCutout(region: string, points: [number, number][]): SheetMetalPartHandle {\n    return new SheetMetalPartHandle(unwrapOrThrow(addPolygonCutout(this.part, region, points)));\n  }\n\n  /**\n   * Fuse a rectangular tab (additive protrusion) onto a region's edge.\n   * @param spec - tab definition: edge, width, and length.\n   * @returns a new `SheetMetalPartHandle` carrying the part with the tab added.\n   */\n  tab(spec: TabSpec): SheetMetalPartHandle {\n    return new SheetMetalPartHandle(unwrapOrThrow(addTab(this.part, spec)));\n  }\n\n  /**\n   * Self-fixturing tab-and-slot joint: a tab on one region + a matching slot on another.\n   * @param tab - the tab to add to the first region.\n   * @param slot - placement of the matching slot on the second region.\n   * @returns a new `SheetMetalPartHandle` carrying the part with the joint added.\n   */\n  tabAndSlot(tab: TabSpec, slot: SlotPlacement): SheetMetalPartHandle {\n    return new SheetMetalPartHandle(unwrapOrThrow(tabAndSlot(this.part, tab, slot)));\n  }\n\n  /**\n   * Form a louver (vent flap) on a region.\n   * @param opts - louver geometry: target `region`, centre `(x, y)`, `length`, `width`, `height`, and optional `direction`.\n   * @returns a new `SheetMetalPartHandle` carrying the part with the louver formed.\n   */\n  louver(opts: {\n    region: string;\n    x: number;\n    y: number;\n    length: number;\n    width: number;\n    height: number;\n    direction?: 'up' | 'down';\n  }): SheetMetalPartHandle {\n    return new SheetMetalPartHandle(unwrapOrThrow(louver(this.part, opts)));\n  }\n\n  /**\n   * Form a round emboss (raised) or dimple (recessed) on a region.\n   * @param opts - emboss geometry: target `region`, centre `(x, y)`, `diameter`, `height`, and `kind` (`dimple` or `emboss`).\n   * @returns a new `SheetMetalPartHandle` carrying the part with the form added.\n   */\n  emboss(opts: {\n    region: string;\n    x: number;\n    y: number;\n    diameter: number;\n    height: number;\n    kind: 'dimple' | 'emboss';\n  }): SheetMetalPartHandle {\n    return new SheetMetalPartHandle(unwrapOrThrow(emboss(this.part, opts)));\n  }\n\n  /**\n   * Author a contour flange (open line/arc profile swept along a base edge).\n   * @param spec - contour flange definition: profile, base edge, and bend parameters.\n   * @returns a new `SheetMetalPartHandle` carrying the part with the contour flange added.\n   */\n  contourFlange(spec: ContourFlangeSpec): SheetMetalPartHandle {\n    return new SheetMetalPartHandle(unwrapOrThrow(contourFlange(this.part, spec)));\n  }\n\n  /**\n   * Author a lofted / ruled transition flange between two parallel open profiles.\n   * @param spec - lofted flange definition: the two open profiles and their alignment.\n   * @returns a new `SheetMetalPartHandle` carrying the part with the lofted flange added.\n   */\n  loftedFlange(spec: LoftedFlangeSpec): SheetMetalPartHandle {\n    return new SheetMetalPartHandle(unwrapOrThrow(loftedFlange(this.part, spec)));\n  }\n\n  /**\n   * Fold a region edge back ~180°+ onto its parent as a hem (closed/open/teardrop/rolled).\n   * @param spec - hem definition: edge, curl radius, and return leg length.\n   * @returns a new `SheetMetalPartHandle` carrying the part with the hem added.\n   */\n  hem(spec: HemSpec): SheetMetalPartHandle {\n    return new SheetMetalPartHandle(unwrapOrThrow(hem(this.part, spec)));\n  }\n\n  /**\n   * Step a region's flat by `offsetHeight` with two opposite bends (a jog/joggle).\n   * @param spec - jog definition: bend line, offset height, and radii.\n   * @returns a new `SheetMetalPartHandle` carrying the part with the jog added.\n   */\n  jog(spec: JogSpec): SheetMetalPartHandle {\n    return new SheetMetalPartHandle(unwrapOrThrow(jog(this.part, spec)));\n  }\n\n  /**\n   * Flatten into a developed flat pattern + bend report + warnings.\n   * @returns the `UnfoldResult` with the flat pattern, bend report, and any warnings.\n   */\n  unfold(): UnfoldResult {\n    return unwrapOrThrow(unfold(this.part));\n  }\n\n  /**\n   * Just the flat pattern from the unfold.\n   * @returns the developed `FlatPattern`.\n   */\n  flatPattern(): FlatPattern {\n    return this.unfold().pattern;\n  }\n\n  /**\n   * Bend report built from the feature tree.\n   * @returns the `BendReport` describing every bend in the part.\n   */\n  report(): BendReport {\n    return unwrapOrThrow(report(this.part));\n  }\n\n  /**\n   * Annotated multi-layer DXF of the developed flat pattern.\n   * @param options - optional DXF output options (layers, precision, units).\n   * @returns the DXF text of the developed flat pattern.\n   */\n  dxf(options?: DxfOptions): string {\n    return unwrapOrThrow(toDXF(this.flatPattern(), options));\n  }\n\n  /**\n   * Manufacturability warnings (advisory, never throws).\n   * @returns the list of `SheetMetalWarning`s (empty when the part is manufacturable).\n   */\n  validate(): SheetMetalWarning[] {\n    return validate(this.part);\n  }\n\n  /**\n   * The materialized part (escape hatch back to the functional API).\n   * @returns the underlying `SheetMetalPart`.\n   */\n  get(): SheetMetalPart {\n    return this.part;\n  }\n}\n\n/**\n * An imported foreign solid (no feature tree) re-entering the fluent chain: detect\n * its geometry and unfold it. `kFactor` defaults to the mid-surface neutral axis.\n */\nclass ForeignSolidHandle {\n  constructor(\n    private readonly solid: Solid,\n    private readonly opts?: { kFactor?: number }\n  ) {}\n\n  /**\n   * Override the neutral-axis K-factor (default 0.5, the mid-surface).\n   * @param kFactor - the K-factor to use for the bend allowance.\n   * @returns a new `ForeignSolidHandle` with the K-factor applied.\n   */\n  kFactor(kFactor: number): ForeignSolidHandle {\n    return new ForeignSolidHandle(this.solid, { ...this.opts, kFactor });\n  }\n\n  /**\n   * Detect geometry and flatten into a developed flat pattern + report + warnings.\n   * @returns the `UnfoldResult` with the detected flat pattern, report, and any warnings.\n   */\n  unfold(): UnfoldResult {\n    return unwrapOrThrow(unfoldSolid(this.solid, this.opts));\n  }\n\n  /**\n   * Just the flat pattern from the detected unfold.\n   * @returns the developed `FlatPattern`.\n   */\n  flatPattern(): FlatPattern {\n    return this.unfold().pattern;\n  }\n\n  /**\n   * Annotated multi-layer DXF of the developed flat pattern.\n   * @param options - optional DXF output options (layers, precision, units).\n   * @returns the DXF text of the developed flat pattern.\n   */\n  dxf(options?: DxfOptions): string {\n    return unwrapOrThrow(toDXF(this.flatPattern(), options));\n  }\n}\n\n/** Authoring builder — accumulates the base/flanges/material spec, then folds. */\nclass SheetMetalBuilder {\n  private built?: SheetMetalPartHandle;\n\n  constructor(private readonly spec: AuthorSpec) {}\n\n  /**\n   * Add a flange folded off its parent edge (the base by default).\n   * @param flange - the flange definition to add.\n   * @returns a new `SheetMetalBuilder` with the flange appended to the spec.\n   */\n  flange(flange: FlangeSpec): SheetMetalBuilder {\n    return new SheetMetalBuilder({ ...this.spec, flanges: [...this.spec.flanges, flange] });\n  }\n\n  /**\n   * Add a seam closing a profile into a tube/box (left unfolded).\n   * @param seam - the seam definition to add.\n   * @returns a new `SheetMetalBuilder` with the seam appended to the spec.\n   */\n  seam(seam: SeamSpec): SheetMetalBuilder {\n    return new SheetMetalBuilder({ ...this.spec, seams: [...(this.spec.seams ?? []), seam] });\n  }\n\n  /**\n   * Set the part material (its thickness/default rule).\n   * @param material - the material definition (thickness / default rule).\n   * @returns a new `SheetMetalBuilder` with the material set.\n   */\n  material(material: MaterialSpec): SheetMetalBuilder {\n    return new SheetMetalBuilder({ ...this.spec, material });\n  }\n\n  /**\n   * Fold the accumulated spec into a 3D part, re-entering the fluent chain.\n   * Memoized so chaining multiple terminal shortcuts (e.g. `unfold()` then\n   * `report()`) authors the solid only once.\n   * @returns a `SheetMetalPartHandle` for the folded part, memoized across calls.\n   */\n  build(): SheetMetalPartHandle {\n    this.built ??= new SheetMetalPartHandle(unwrapOrThrow(author(this.spec)));\n    return this.built;\n  }\n\n  // ----- part-consuming shortcuts (build then delegate) -----\n\n  /**\n   * Build the part and cut it by an oriented plane, removing material on the `+normal` side.\n   * @param plane - the oriented cutting plane; material on the plane's `+normal` side is removed.\n   * @returns a `SheetMetalPartHandle` carrying the mitered part.\n   */\n  miter(plane: MiterPlane): SheetMetalPartHandle {\n    return this.build().miter(plane);\n  }\n\n  /**\n   * Build the part and auto-miter the shared corner of two flanges with an optional gap.\n   * @param flangeIdA - id of the first flange meeting at the corner.\n   * @param flangeIdB - id of the second flange meeting at the corner.\n   * @param gap - optional gap (in millimetres) left between the two mitered edges; defaults to 0.\n   * @returns a `SheetMetalPartHandle` carrying the part with the corner mitered.\n   */\n  miterCorner(flangeIdA: string, flangeIdB: string, gap = 0): SheetMetalPartHandle {\n    return this.build().miterCorner(flangeIdA, flangeIdB, gap);\n  }\n\n  /**\n   * Build the part and add a bend relief at each mid-edge end of a partial flange's bend line.\n   * @param flangeId - id of the partial flange whose bend-line ends get the relief.\n   * @param spec - optional relief specification overriding the defaults.\n   * @returns a `SheetMetalPartHandle` carrying the part with the relief added.\n   */\n  bendRelief(flangeId: string, spec?: ReliefSpec): SheetMetalPartHandle {\n    return this.build().bendRelief(flangeId, spec);\n  }\n\n  /**\n   * Build the part and add a bend relief to every partial-span bend.\n   * @param spec - optional relief specification applied to every partial bend.\n   * @returns a `SheetMetalPartHandle` carrying the part with all reliefs added.\n   */\n  autoReliefs(spec?: ReliefSpec): SheetMetalPartHandle {\n    return this.build().autoReliefs(spec);\n  }\n\n  /**\n   * Build the part and cut a corner relief notch at the shared corner of two adjacent flanges.\n   * @param flangeIdA - id of the first flange forming the corner.\n   * @param flangeIdB - id of the second flange forming the corner.\n   * @param spec - optional relief specification overriding the defaults.\n   * @returns a `SheetMetalPartHandle` carrying the part with the corner relief added.\n   */\n  cornerRelief(flangeIdA: string, flangeIdB: string, spec?: ReliefSpec): SheetMetalPartHandle {\n    return this.build().cornerRelief(flangeIdA, flangeIdB, spec);\n  }\n\n  /**\n   * Build the part and punch a cutout (hole / slot / polygon) through a named flat region.\n   * @param spec - the cutout definition (kind, geometry, and target region).\n   * @returns a `SheetMetalPartHandle` carrying the part with the cutout punched.\n   */\n  cutout(spec: CutoutSpec): SheetMetalPartHandle {\n    return this.build().cutout(spec);\n  }\n\n  /**\n   * Build the part and punch a circular hole of `diameter` centred at region-local `(x, y)`.\n   * @param region - name of the flat region the hole is punched through.\n   * @param x - region-local X of the hole centre.\n   * @param y - region-local Y of the hole centre.\n   * @param diameter - hole diameter.\n   * @returns a `SheetMetalPartHandle` carrying the part with the hole punched.\n   */\n  hole(region: string, x: number, y: number, diameter: number): SheetMetalPartHandle {\n    return this.build().hole(region, x, y, diameter);\n  }\n\n  /**\n   * Build the part and punch a slot (rectangular or obround) centred at region-local `(x, y)`.\n   * @param region - name of the flat region the slot is punched through.\n   * @param opts - slot geometry: centre `(x, y)`, `length`, `width`, optional `angleDeg` rotation, and `round` ends flag.\n   * @returns a `SheetMetalPartHandle` carrying the part with the slot punched.\n   */\n  slot(\n    region: string,\n    opts: { x: number; y: number; length: number; width: number; angleDeg?: number; round?: boolean }\n  ): SheetMetalPartHandle {\n    return this.build().slot(region, opts);\n  }\n\n  /**\n   * Build the part and punch an arbitrary polygon cutout from its region-local `points`.\n   * @param region - name of the flat region the polygon is punched through.\n   * @param points - region-local polygon vertices as `[x, y]` pairs.\n   * @returns a `SheetMetalPartHandle` carrying the part with the polygon cutout.\n   */\n  polygonCutout(region: string, points: [number, number][]): SheetMetalPartHandle {\n    return this.build().polygonCutout(region, points);\n  }\n\n  /**\n   * Build the part and fuse a rectangular tab (additive protrusion) onto a region's edge.\n   * @param spec - tab definition: edge, width, and length.\n   * @returns a `SheetMetalPartHandle` carrying the part with the tab added.\n   */\n  tab(spec: TabSpec): SheetMetalPartHandle {\n    return this.build().tab(spec);\n  }\n\n  /**\n   * Build the part and add a self-fixturing tab-and-slot joint across two regions.\n   * @param tab - the tab to add to the first region.\n   * @param slot - placement of the matching slot on the second region.\n   * @returns a `SheetMetalPartHandle` carrying the part with the joint added.\n   */\n  tabAndSlot(tab: TabSpec, slot: SlotPlacement): SheetMetalPartHandle {\n    return this.build().tabAndSlot(tab, slot);\n  }\n\n  /**\n   * Build the part and form a louver (vent flap) on a region.\n   * @param opts - louver geometry: target `region`, centre `(x, y)`, `length`, `width`, `height`, and optional `direction`.\n   * @returns a `SheetMetalPartHandle` carrying the part with the louver formed.\n   */\n  louver(opts: {\n    region: string;\n    x: number;\n    y: number;\n    length: number;\n    width: number;\n    height: number;\n    direction?: 'up' | 'down';\n  }): SheetMetalPartHandle {\n    return this.build().louver(opts);\n  }\n\n  /**\n   * Build the part and form a round emboss (raised) or dimple (recessed) on a region.\n   * @param opts - emboss geometry: target `region`, centre `(x, y)`, `diameter`, `height`, and `kind` (`dimple` or `emboss`).\n   * @returns a `SheetMetalPartHandle` carrying the part with the form added.\n   */\n  emboss(opts: {\n    region: string;\n    x: number;\n    y: number;\n    diameter: number;\n    height: number;\n    kind: 'dimple' | 'emboss';\n  }): SheetMetalPartHandle {\n    return this.build().emboss(opts);\n  }\n\n  /**\n   * Build the part and author a contour flange (open line/arc profile swept along a base edge).\n   * @param spec - contour flange definition: profile, base edge, and bend parameters.\n   * @returns a `SheetMetalPartHandle` carrying the part with the contour flange added.\n   */\n  contourFlange(spec: ContourFlangeSpec): SheetMetalPartHandle {\n    return this.build().contourFlange(spec);\n  }\n\n  /**\n   * Build the part and author a lofted / ruled transition flange between two parallel open profiles.\n   * @param spec - lofted flange definition: the two open profiles and their alignment.\n   * @returns a `SheetMetalPartHandle` carrying the part with the lofted flange added.\n   */\n  loftedFlange(spec: LoftedFlangeSpec): SheetMetalPartHandle {\n    return this.build().loftedFlange(spec);\n  }\n\n  /**\n   * Build the part and fold a region edge back ~180°+ onto its parent as a hem.\n   * @param spec - hem definition: edge, curl radius, and return leg length.\n   * @returns a `SheetMetalPartHandle` carrying the part with the hem added.\n   */\n  hem(spec: HemSpec): SheetMetalPartHandle {\n    return this.build().hem(spec);\n  }\n\n  /**\n   * Build the part and step a region's flat by `offsetHeight` with two opposite bends (a jog/joggle).\n   * @param spec - jog definition: bend line, offset height, and radii.\n   * @returns a `SheetMetalPartHandle` carrying the part with the jog added.\n   */\n  jog(spec: JogSpec): SheetMetalPartHandle {\n    return this.build().jog(spec);\n  }\n\n  /**\n   * Build the part and flatten it into a developed flat pattern + bend report + warnings.\n   * @returns the `UnfoldResult` with the flat pattern, bend report, and any warnings.\n   */\n  unfold(): UnfoldResult {\n    return this.build().unfold();\n  }\n\n  /**\n   * Build the part and produce the bend report from its feature tree.\n   * @returns the `BendReport` describing every bend in the part.\n   */\n  report(): BendReport {\n    return this.build().report();\n  }\n\n  /**\n   * Build the part and emit an annotated multi-layer DXF of its developed flat pattern.\n   * @param options - optional DXF output options (layers, precision, units).\n   * @returns the DXF text of the developed flat pattern.\n   */\n  dxf(options?: DxfOptions): string {\n    return this.build().dxf(options);\n  }\n\n  /**\n   * Build the part and run manufacturability checks (advisory, never throws).\n   * @returns the list of `SheetMetalWarning`s (empty when the part is manufacturable).\n   */\n  validate(): SheetMetalWarning[] {\n    return this.build().validate();\n  }\n\n  /**\n   * Build the part and return it (escape hatch back to the functional API).\n   * @returns the underlying `SheetMetalPart`.\n   */\n  get(): SheetMetalPart {\n    return this.build().get();\n  }\n}\n\n/**\n * Start a fluent sheet-metal chain from a base flat (`length × width`).\n * @param base - the base flat definition (length × width).\n * @param thickness - the sheet material thickness in millimetres.\n * @returns a `SheetMetalBuilder` ready for authoring steps like `flange`/`seam`/`material`.\n */\nexport function sheetMetal(base: BaseFlatSpec, thickness: number): SheetMetalBuilder {\n  return new SheetMetalBuilder({ thickness, base, flanges: [] });\n}\n\n/**\n * Re-enter the fluent chain from an already-authored part.\n * @param part - an authored sheet-metal part to operate on.\n * @returns a `SheetMetalPartHandle` wrapping the part.\n */\nexport function fromPart(part: SheetMetalPart): SheetMetalPartHandle {\n  return new SheetMetalPartHandle(part);\n}\n\n/**\n * Fold a flat pattern up into a part and re-enter the fluent chain.\n * @param input - the flat pattern (region tree) to fold up.\n * @returns a `SheetMetalPartHandle` carrying the folded part.\n */\nexport function foldFlat(input: FlatInput): SheetMetalPartHandle {\n  return new SheetMetalPartHandle(unwrapOrThrow(fold(input)));\n}\n\n/**\n * Detect and unfold an imported foreign sheet-metal solid (no feature tree).\n * @param solid - the imported solid (B-rep) to unfold.\n * @param opts - optional overrides; `opts.kFactor` sets the K-factor used for the bend allowance.\n * @returns a `ForeignSolidHandle` for detecting and unfolding the solid.\n */\nexport function fromSolid(solid: Solid, opts?: { kFactor?: number }): ForeignSolidHandle {\n  return new ForeignSolidHandle(solid, opts);\n}\n\nexport { SheetMetalBuilder, SheetMetalPartHandle, ForeignSolidHandle };\n"]}