@faicad/sheetmetal 0.16.0 → 0.17.0

package/dist/allowanceFns.d.ts

@@ -1,4 +1,4 @@
-import { type Result } from '@faicad/faijs/brepjs-compat';
+import { type Result } from '@faicad/faijs/api';
 import type { BendRule, SheetMetalWarning } from './types.js';
 /**
  * Bend allowance — the developed (flat) length of material consumed by a bend,

package/dist/allowanceFns.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"allowanceFns.d.ts","sourceRoot":"","sources":["../src/allowanceFns.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,MAAM,EAA4B,MAAM,6BAA6B,CAAC;AACpF,OAAO,KAAK,EAAE,QAAQ,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAe9D;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,aAAa,CAC3B,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,QAAQ,EACd,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,iBAAiB,KAAK,IAAI,GAC/C,MAAM,CAAC,MAAM,CAAC,CAEhB;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,QAAQ,EACd,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,iBAAiB,KAAK,IAAI,GAC/C,MAAM,CAAC,MAAM,CAAC,CAEhB;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,GAAG,MAAM,CAAC,MAAM,CAAC,CAO/E"}
+{"version":3,"file":"allowanceFns.d.ts","sourceRoot":"","sources":["../src/allowanceFns.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,KAAK,MAAM,EAA2B,MAAM,mBAAmB,CAAC;AACxE,OAAO,KAAK,EAAE,QAAQ,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAe9D;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,aAAa,CAC3B,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,QAAQ,EACd,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,iBAAiB,KAAK,IAAI,GAC/C,MAAM,CAAC,MAAM,CAAC,CAEhB;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,QAAQ,EACd,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,iBAAiB,KAAK,IAAI,GAC/C,MAAM,CAAC,MAAM,CAAC,CAEhB;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,GAAG,MAAM,CAAC,MAAM,CAAC,CAO/E"}

package/dist/allowanceFns.js

@@ -1,4 +1,4 @@
-import { ok, err, validationError } from '@faicad/faijs/brepjs-compat';
+import { ok, err, validationError } from '@faicad/faijs/api';
 import { resolveBendAllowance } from './bendTableFns.js';
 function validateRule(rule) {
     if (!Number.isFinite(rule.innerRadius) || rule.innerRadius < 0) {

package/dist/allowanceFns.js.map

@@ -1 +1 @@
-{"version":3,"file":"allowanceFns.js","sourceRoot":"","sources":["../src/allowanceFns.ts"],"names":[],"mappings":"AAAA,OAAO,EAAe,EAAE,EAAE,GAAG,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAEpF,OAAO,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAEzD,SAAS,YAAY,CAAC,IAAc;IAClC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,WAAW,CAAC,IAAI,IAAI,CAAC,WAAW,GAAG,CAAC,EAAE,CAAC;QAC/D,OAAO,GAAG,CACR,eAAe,CAAC,gBAAgB,EAAE,0DAA0D,IAAI,CAAC,WAAW,EAAE,CAAC,CAChH,CAAC;IACJ,CAAC;IACD,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC,OAAO,GAAG,CAAC,IAAI,IAAI,CAAC,OAAO,GAAG,CAAC,EAAE,CAAC;QAC3E,OAAO,GAAG,CAAC,eAAe,CAAC,kBAAkB,EAAE,kCAAkC,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;IACpG,CAAC;IACD,OAAO,EAAE,CAAC,SAAS,CAAC,CAAC;AACvB,CAAC;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,aAAa,CAC3B,QAAgB,EAChB,SAAiB,EACjB,IAAc,EACd,SAAgD;IAEhD,OAAO,oBAAoB,CAAC,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,SAAS,CAAC,CAAC;AACpE,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,eAAe,CAC7B,QAAgB,EAChB,SAAiB,EACjB,IAAc,EACd,SAAgD;IAEhD,OAAO,oBAAoB,CAAC,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,SAAS,CAAC,CAAC;AACpE,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,aAAa,CAAC,SAAiB,EAAE,IAAc;IAC7D,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,SAAS,IAAI,CAAC,EAAE,CAAC;QAClD,OAAO,GAAG,CAAC,eAAe,CAAC,mBAAmB,EAAE,oDAAoD,SAAS,EAAE,CAAC,CAAC,CAAC;IACpH,CAAC;IACD,MAAM,SAAS,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;IACrC,IAAI,CAAC,SAAS,CAAC,EAAE;QAAE,OAAO,SAAS,CAAC;IACpC,OAAO,EAAE,CAAC,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,OAAO,GAAG,SAAS,CAAC,CAAC;AACzD,CAAC","sourcesContent":["import { type Result, ok, err, validationError } from '@faicad/faijs/brepjs-compat';\nimport type { BendRule, SheetMetalWarning } from './types.js';\nimport { resolveBendAllowance } from './bendTableFns.js';\n\nfunction validateRule(rule: BendRule): Result<void> {\n  if (!Number.isFinite(rule.innerRadius) || rule.innerRadius < 0) {\n    return err(\n      validationError('INVALID_RADIUS', `innerRadius must be a finite, non-negative number, got ${rule.innerRadius}`)\n    );\n  }\n  if (!Number.isFinite(rule.kFactor) || rule.kFactor < 0 || rule.kFactor > 1) {\n    return err(validationError('INVALID_K_FACTOR', `kFactor must be in [0, 1], got ${rule.kFactor}`));\n  }\n  return ok(undefined);\n}\n\n/**\n * Bend allowance — the developed (flat) length of material consumed by a bend,\n * measured along the neutral axis. Resolution precedence (see\n * {@link resolveBendAllowance}): a referenced bend table, then an explicit\n * `rule.allowance` override, then the K-factor formula\n * BA = (π/180)·|angle|·(R + K·T). An optional `onWarning` receives the clamp\n * warning when a table query falls outside its tabulated range.\n * @param angleDeg the bend angle in degrees\n * @param thickness the sheet thickness\n * @param rule the bend rule used for the resolution\n * @param onWarning optional callback receiving a clamp warning when a table query\n * falls outside its tabulated range\n * @returns a `Result<number>` — `ok` with the computed bend allowance on success,\n * or `err` with a `validationError` when the inputs are invalid\n */\nexport function bendAllowance(\n  angleDeg: number,\n  thickness: number,\n  rule: BendRule,\n  onWarning?: (warning: SheetMetalWarning) => void\n): Result<number> {\n  return resolveBendAllowance(rule, angleDeg, thickness, onWarning);\n}\n\n/**\n * Developed length of the bend region when flattened — the neutral-axis arc\n * length that replaces the curved patch in the flat pattern. Identical to the\n * bend allowance (kept distinct in name for the unfold call sites that consume\n * it as a strip width), and routed through the same {@link resolveBendAllowance}\n * resolution (table → explicit allowance → K-factor).\n * @param angleDeg the bend angle in degrees\n * @param thickness the sheet thickness\n * @param rule the bend rule used for the resolution\n * @param onWarning optional callback receiving a clamp warning when a table query\n * falls outside its tabulated range\n * @returns a `Result<number>` — `ok` with the developed length on success,\n * or `err` with a `validationError` when the inputs are invalid\n */\nexport function developedLength(\n  angleDeg: number,\n  thickness: number,\n  rule: BendRule,\n  onWarning?: (warning: SheetMetalWarning) => void\n): Result<number> {\n  return resolveBendAllowance(rule, angleDeg, thickness, onWarning);\n}\n\n/**\n * Neutral-axis radius R + K·T (the radius the developed arc length is measured at).\n * @param thickness the sheet thickness\n * @param rule the bend rule providing `innerRadius` and `kFactor`\n * @returns a `Result<number>` — `ok` with the neutral-axis radius on success,\n * or `err` with a `validationError` when the inputs are invalid\n */\nexport function neutralRadius(thickness: number, rule: BendRule): Result<number> {\n  if (!Number.isFinite(thickness) || thickness <= 0) {\n    return err(validationError('INVALID_THICKNESS', `thickness must be a finite, positive number, got ${thickness}`));\n  }\n  const ruleCheck = validateRule(rule);\n  if (!ruleCheck.ok) return ruleCheck;\n  return ok(rule.innerRadius + rule.kFactor * thickness);\n}\n"]}
+{"version":3,"file":"allowanceFns.js","sourceRoot":"","sources":["../src/allowanceFns.ts"],"names":[],"mappings":"AAAA,OAAO,EAAc,EAAE,EAAE,GAAG,EAAE,eAAe,EAAC,MAAM,mBAAmB,CAAC;AAExE,OAAO,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAEzD,SAAS,YAAY,CAAC,IAAc;IAClC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,WAAW,CAAC,IAAI,IAAI,CAAC,WAAW,GAAG,CAAC,EAAE,CAAC;QAC/D,OAAO,GAAG,CACR,eAAe,CAAC,gBAAgB,EAAE,0DAA0D,IAAI,CAAC,WAAW,EAAE,CAAC,CAChH,CAAC;IACJ,CAAC;IACD,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC,OAAO,GAAG,CAAC,IAAI,IAAI,CAAC,OAAO,GAAG,CAAC,EAAE,CAAC;QAC3E,OAAO,GAAG,CAAC,eAAe,CAAC,kBAAkB,EAAE,kCAAkC,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;IACpG,CAAC;IACD,OAAO,EAAE,CAAC,SAAS,CAAC,CAAC;AACvB,CAAC;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,aAAa,CAC3B,QAAgB,EAChB,SAAiB,EACjB,IAAc,EACd,SAAgD;IAEhD,OAAO,oBAAoB,CAAC,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,SAAS,CAAC,CAAC;AACpE,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,eAAe,CAC7B,QAAgB,EAChB,SAAiB,EACjB,IAAc,EACd,SAAgD;IAEhD,OAAO,oBAAoB,CAAC,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,SAAS,CAAC,CAAC;AACpE,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,aAAa,CAAC,SAAiB,EAAE,IAAc;IAC7D,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,SAAS,IAAI,CAAC,EAAE,CAAC;QAClD,OAAO,GAAG,CAAC,eAAe,CAAC,mBAAmB,EAAE,oDAAoD,SAAS,EAAE,CAAC,CAAC,CAAC;IACpH,CAAC;IACD,MAAM,SAAS,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;IACrC,IAAI,CAAC,SAAS,CAAC,EAAE;QAAE,OAAO,SAAS,CAAC;IACpC,OAAO,EAAE,CAAC,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,OAAO,GAAG,SAAS,CAAC,CAAC;AACzD,CAAC","sourcesContent":["import {type Result, ok, err, validationError} from '@faicad/faijs/api';\nimport type { BendRule, SheetMetalWarning } from './types.js';\nimport { resolveBendAllowance } from './bendTableFns.js';\n\nfunction validateRule(rule: BendRule): Result<void> {\n  if (!Number.isFinite(rule.innerRadius) || rule.innerRadius < 0) {\n    return err(\n      validationError('INVALID_RADIUS', `innerRadius must be a finite, non-negative number, got ${rule.innerRadius}`)\n    );\n  }\n  if (!Number.isFinite(rule.kFactor) || rule.kFactor < 0 || rule.kFactor > 1) {\n    return err(validationError('INVALID_K_FACTOR', `kFactor must be in [0, 1], got ${rule.kFactor}`));\n  }\n  return ok(undefined);\n}\n\n/**\n * Bend allowance — the developed (flat) length of material consumed by a bend,\n * measured along the neutral axis. Resolution precedence (see\n * {@link resolveBendAllowance}): a referenced bend table, then an explicit\n * `rule.allowance` override, then the K-factor formula\n * BA = (π/180)·|angle|·(R + K·T). An optional `onWarning` receives the clamp\n * warning when a table query falls outside its tabulated range.\n * @param angleDeg the bend angle in degrees\n * @param thickness the sheet thickness\n * @param rule the bend rule used for the resolution\n * @param onWarning optional callback receiving a clamp warning when a table query\n * falls outside its tabulated range\n * @returns a `Result<number>` — `ok` with the computed bend allowance on success,\n * or `err` with a `validationError` when the inputs are invalid\n */\nexport function bendAllowance(\n  angleDeg: number,\n  thickness: number,\n  rule: BendRule,\n  onWarning?: (warning: SheetMetalWarning) => void\n): Result<number> {\n  return resolveBendAllowance(rule, angleDeg, thickness, onWarning);\n}\n\n/**\n * Developed length of the bend region when flattened — the neutral-axis arc\n * length that replaces the curved patch in the flat pattern. Identical to the\n * bend allowance (kept distinct in name for the unfold call sites that consume\n * it as a strip width), and routed through the same {@link resolveBendAllowance}\n * resolution (table → explicit allowance → K-factor).\n * @param angleDeg the bend angle in degrees\n * @param thickness the sheet thickness\n * @param rule the bend rule used for the resolution\n * @param onWarning optional callback receiving a clamp warning when a table query\n * falls outside its tabulated range\n * @returns a `Result<number>` — `ok` with the developed length on success,\n * or `err` with a `validationError` when the inputs are invalid\n */\nexport function developedLength(\n  angleDeg: number,\n  thickness: number,\n  rule: BendRule,\n  onWarning?: (warning: SheetMetalWarning) => void\n): Result<number> {\n  return resolveBendAllowance(rule, angleDeg, thickness, onWarning);\n}\n\n/**\n * Neutral-axis radius R + K·T (the radius the developed arc length is measured at).\n * @param thickness the sheet thickness\n * @param rule the bend rule providing `innerRadius` and `kFactor`\n * @returns a `Result<number>` — `ok` with the neutral-axis radius on success,\n * or `err` with a `validationError` when the inputs are invalid\n */\nexport function neutralRadius(thickness: number, rule: BendRule): Result<number> {\n  if (!Number.isFinite(thickness) || thickness <= 0) {\n    return err(validationError('INVALID_THICKNESS', `thickness must be a finite, positive number, got ${thickness}`));\n  }\n  const ruleCheck = validateRule(rule);\n  if (!ruleCheck.ok) return ruleCheck;\n  return ok(rule.innerRadius + rule.kFactor * thickness);\n}\n"]}

package/dist/api.d.ts

@@ -6,7 +6,8 @@
  * preserve the `Result<T>` / warning-channel contract end to end. The fluent
  * `sheetMetal()` facade in `./facade.js` is built on top of these.
  */
-import { type Result, type Solid } from '@faicad/faijs/brepjs-compat';
+import type { Solid } from './types.js';
+import { type Result } from '@faicad/faijs/api';
 import { type AuthorSpec, type FlangeSpec } from './authorFns.js';
 import { type MiterPlane } from './miterFns.js';
 import { type SlotPlacement } from './tabFns.js';
@@ -19,7 +20,7 @@ import type { SheetMetalPart, FlatPattern, FlatInput, BendReport, BendRule, Reli
  * @param spec - the part definition: base flat, material thickness, and the flange list to fold up.
  * @returns a `Result<SheetMetalPart>` carrying the authored part, or the first error encountered.
  */
-export declare function author(spec: AuthorSpec): Result<SheetMetalPart>;
+export declare function author(spec: AuthorSpec): Promise<Result<SheetMetalPart>>;
 /**
  * Extract the lone 3D solid of an authored part as its own `Result` terminal.
  *
@@ -55,14 +56,14 @@ export declare function unfoldSolid(solid: Solid, opts?: {
  * @param input - the flat pattern (region tree) to fold up.
  * @returns a `Result<SheetMetalPart>` carrying the folded 3D part, or the first error.
  */
-export declare function fold(input: FlatInput): Result<SheetMetalPart>;
+export declare function fold(input: FlatInput): Promise<Result<SheetMetalPart>>;
 /**
  * Cut a part by an oriented plane, removing material on the `+normal` side.
  * @param part - the sheet-metal part to cut.
  * @param plane - the oriented cutting plane; material on the plane's `+normal` side is removed.
  * @returns a `Result<SheetMetalPart>` carrying the mitered part, or the first error.
  */
-export declare function miter(part: SheetMetalPart, plane: MiterPlane): Result<SheetMetalPart>;
+export declare function miter(part: SheetMetalPart, plane: MiterPlane): Promise<Result<SheetMetalPart>>;
 /**
  * Auto-miter the shared corner of two flanges with an optional gap.
  * @param part - the sheet-metal part whose corner is to be mitered.
@@ -71,7 +72,7 @@ export declare function miter(part: SheetMetalPart, plane: MiterPlane): Result<S
  * @param gap - optional gap (in millimetres) left between the two mitered edges; defaults to 0.
  * @returns a `Result<SheetMetalPart>` carrying the mitered part, or the first error.
  */
-export declare function miterCorner(part: SheetMetalPart, flangeIdA: string, flangeIdB: string, gap?: number): Result<SheetMetalPart>;
+export declare function miterCorner(part: SheetMetalPart, flangeIdA: string, flangeIdB: string, gap?: number): Promise<Result<SheetMetalPart>>;
 /**
  * Add a bend relief slot at each mid-edge end of a partial flange's bend line.
  * @param part - the sheet-metal part to modify.
@@ -79,14 +80,14 @@ export declare function miterCorner(part: SheetMetalPart, flangeIdA: string, fla
  * @param spec - optional relief specification overriding the defaults.
  * @returns a `Result<SheetMetalPart>` carrying the part with the relief added, or the first error.
  */
-export declare function bendRelief(part: SheetMetalPart, flangeId: string, spec?: ReliefSpec): Result<SheetMetalPart>;
+export declare function bendRelief(part: SheetMetalPart, flangeId: string, spec?: ReliefSpec): Promise<Result<SheetMetalPart>>;
 /**
  * Add a bend relief to every partial-span bend in the part.
  * @param part - the sheet-metal part to modify.
  * @param spec - optional relief specification applied to every partial bend.
  * @returns a `Result<SheetMetalPart>` carrying the part with all reliefs added, or the first error.
  */
-export declare function autoReliefs(part: SheetMetalPart, spec?: ReliefSpec): Result<SheetMetalPart>;
+export declare function autoReliefs(part: SheetMetalPart, spec?: ReliefSpec): Promise<Result<SheetMetalPart>>;
 /**
  * Cut a corner relief notch at the shared corner of two adjacent flanges.
  * @param part - the sheet-metal part to modify.
@@ -95,14 +96,14 @@ export declare function autoReliefs(part: SheetMetalPart, spec?: ReliefSpec): Re
  * @param spec - optional relief specification overriding the defaults.
  * @returns a `Result<SheetMetalPart>` carrying the part with the corner relief added, or the first error.
  */
-export declare function relieveCorner(part: SheetMetalPart, flangeIdA: string, flangeIdB: string, spec?: ReliefSpec): Result<SheetMetalPart>;
+export declare function relieveCorner(part: SheetMetalPart, flangeIdA: string, flangeIdB: string, spec?: ReliefSpec): Promise<Result<SheetMetalPart>>;
 /**
  * Punch a cutout (hole / slot / polygon) through a named flat region's thickness.
  * @param part - the sheet-metal part to modify.
  * @param spec - the cutout definition (kind, geometry, and target region).
  * @returns a `Result<SheetMetalPart>` carrying the part with the cutout punched, or the first error.
  */
-export declare function addCutout(part: SheetMetalPart, spec: CutoutSpec): Result<SheetMetalPart>;
+export declare function addCutout(part: SheetMetalPart, spec: CutoutSpec): Promise<Result<SheetMetalPart>>;
 /**
  * Punch a circular hole of `diameter` centred at region-local `(x, y)`.
  * @param part - the sheet-metal part to modify.
@@ -112,7 +113,7 @@ export declare function addCutout(part: SheetMetalPart, spec: CutoutSpec): Resul
  * @param diameter - hole diameter.
  * @returns a `Result<SheetMetalPart>` carrying the part with the hole punched, or the first error.
  */
-export declare function addHole(part: SheetMetalPart, region: string, x: number, y: number, diameter: number): Result<SheetMetalPart>;
+export declare function addHole(part: SheetMetalPart, region: string, x: number, y: number, diameter: number): Promise<Result<SheetMetalPart>>;
 /**
  * Punch a slot (rectangular or obround) centred at region-local `(x, y)`.
  * @param part - the sheet-metal part to modify.
@@ -127,7 +128,7 @@ export declare function addSlot(part: SheetMetalPart, region: string, opts: {
     width: number;
     angleDeg?: number;
     round?: boolean;
-}): Result<SheetMetalPart>;
+}): Promise<Result<SheetMetalPart>>;
 /**
  * Punch an arbitrary polygon cutout from its region-local `points`.
  * @param part - the sheet-metal part to modify.
@@ -135,14 +136,14 @@ export declare function addSlot(part: SheetMetalPart, region: string, opts: {
  * @param points - region-local polygon vertices as `[x, y]` pairs.
  * @returns a `Result<SheetMetalPart>` carrying the part with the polygon cutout, or the first error.
  */
-export declare function addPolygonCutout(part: SheetMetalPart, region: string, points: [number, number][]): Result<SheetMetalPart>;
+export declare function addPolygonCutout(part: SheetMetalPart, region: string, points: [number, number][]): Promise<Result<SheetMetalPart>>;
 /**
  * Fuse a rectangular tab (additive protrusion) onto a region's edge.
  * @param part - the sheet-metal part to modify.
  * @param spec - tab definition: edge, width, and length.
  * @returns a `Result<SheetMetalPart>` carrying the part with the tab added, or the first error.
  */
-export declare function addTab(part: SheetMetalPart, spec: TabSpec): Result<SheetMetalPart>;
+export declare function addTab(part: SheetMetalPart, spec: TabSpec): Promise<Result<SheetMetalPart>>;
 /**
  * Self-fixturing tab-and-slot joint: a tab on one region + a matching slot on another.
  * @param part - the sheet-metal part to modify.
@@ -150,7 +151,7 @@ export declare function addTab(part: SheetMetalPart, spec: TabSpec): Result<Shee
  * @param slot - placement of the matching slot on the second region.
  * @returns a `Result<SheetMetalPart>` carrying the part with the joint added, or the first error.
  */
-export declare function tabAndSlot(part: SheetMetalPart, tab: TabSpec, slot: SlotPlacement): Result<SheetMetalPart>;
+export declare function tabAndSlot(part: SheetMetalPart, tab: TabSpec, slot: SlotPlacement): Promise<Result<SheetMetalPart>>;
 /**
  * Form a louver (vent flap cut on 3 sides, formed up along the hinge) on a region.
  * @param part - the sheet-metal part to modify.
@@ -165,7 +166,7 @@ export declare function louver(part: SheetMetalPart, opts: {
     width: number;
     height: number;
     direction?: 'up' | 'down';
-}): Result<SheetMetalPart>;
+}): Promise<Result<SheetMetalPart>>;
 /**
  * Form a round emboss (raised) or dimple (recessed) on a region.
  * @param part - the sheet-metal part to modify.
@@ -179,7 +180,7 @@ export declare function emboss(part: SheetMetalPart, opts: {
     diameter: number;
     height: number;
     kind: 'dimple' | 'emboss';
-}): Result<SheetMetalPart>;
+}): Promise<Result<SheetMetalPart>>;
 /**
  * Author a contour flange: an open line/arc profile swept along a base edge into a
  * multi-bend cross-section. The development is exact (Σ segment developed lengths).
@@ -187,7 +188,7 @@ export declare function emboss(part: SheetMetalPart, opts: {
  * @param spec - contour flange definition: profile, base edge, and bend parameters.
  * @returns a `Result<SheetMetalPart>` carrying the part with the contour flange added, or the first error.
  */
-export declare function contourFlange(part: SheetMetalPart, spec: ContourFlangeSpec): Result<SheetMetalPart>;
+export declare function contourFlange(part: SheetMetalPart, spec: ContourFlangeSpec): Promise<Result<SheetMetalPart>>;
 /**
  * Author a lofted / ruled transition flange between two parallel open profiles. The
  * development is by triangulation — exact for a developable transition, an
@@ -196,7 +197,7 @@ export declare function contourFlange(part: SheetMetalPart, spec: ContourFlangeS
  * @param spec - lofted flange definition: the two open profiles and their alignment.
  * @returns a `Result<SheetMetalPart>` carrying the part with the lofted flange added, or the first error.
  */
-export declare function loftedFlange(part: SheetMetalPart, spec: LoftedFlangeSpec): Result<SheetMetalPart>;
+export declare function loftedFlange(part: SheetMetalPart, spec: LoftedFlangeSpec): Promise<Result<SheetMetalPart>>;
 /**
  * Author a hem: fold a region edge back ~180°+ onto its parent and run a short
  * return leg. The development is exact (Σ curl bend allowances + return length).
@@ -204,7 +205,7 @@ export declare function loftedFlange(part: SheetMetalPart, spec: LoftedFlangeSpe
  * @param spec - hem definition: edge, curl radius, and return leg length.
  * @returns a `Result<SheetMetalPart>` carrying the part with the hem added, or the first error.
  */
-export declare function hem(part: SheetMetalPart, spec: HemSpec): Result<SheetMetalPart>;
+export declare function hem(part: SheetMetalPart, spec: HemSpec): Promise<Result<SheetMetalPart>>;
 /**
  * Author a jog (joggle): two opposite bends stepping the flat by `offsetHeight`
  * perpendicular to its plane, then continuing parallel. Development is exact.
@@ -212,7 +213,7 @@ export declare function hem(part: SheetMetalPart, spec: HemSpec): Result<SheetMe
  * @param spec - jog definition: bend line, offset height, and radii.
  * @returns a `Result<SheetMetalPart>` carrying the part with the jog added, or the first error.
  */
-export declare function jog(part: SheetMetalPart, spec: JogSpec): Result<SheetMetalPart>;
+export declare function jog(part: SheetMetalPart, spec: JogSpec): Promise<Result<SheetMetalPart>>;
 /**
  * Emit an annotated multi-layer DXF string for a flat pattern.
  * @param pattern - the flat pattern to serialize.

package/dist/api.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../src/api.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAA4B,KAAK,MAAM,EAAE,KAAK,KAAK,EAAE,MAAM,6BAA6B,CAAC;AAChG,OAAO,EAEL,KAAK,UAAU,EACf,KAAK,UAAU,EAChB,MAAM,gBAAgB,CAAC;AAIxB,OAAO,EAGL,KAAK,UAAU,EAChB,MAAM,eAAe,CAAC;AAYvB,OAAO,EAGL,KAAK,aAAa,EACnB,MAAM,aAAa,CAAC;AAMrB,OAAO,EAA0C,KAAK,UAAU,EAAE,MAAM,aAAa,CAAC;AACtF,OAAO,EAGL,KAAK,WAAW,EAChB,KAAK,UAAU,EAChB,MAAM,cAAc,CAAC;AAQtB,OAAO,EAIL,KAAK,SAAS,EACf,MAAM,mBAAmB,CAAC;AAC3B,OAAO,KAAK,EACV,cAAc,EACd,WAAW,EACX,SAAS,EACT,UAAU,EACV,QAAQ,EACR,UAAU,EACV,UAAU,EACV,OAAO,EACP,iBAAiB,EACjB,gBAAgB,EAChB,OAAO,EACP,OAAO,EACP,YAAY,EACZ,iBAAiB,EAClB,MAAM,YAAY,CAAC;AAEpB;;;;GAIG;AACH,wBAAgB,MAAM,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,CAAC,cAAc,CAAC,CAE/D;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE,cAAc,GAAG,MAAM,CAAC,KAAK,CAAC,CAE3D;AAED;;;;GAIG;AACH,wBAAgB,MAAM,CAAC,IAAI,EAAE,cAAc,GAAG,MAAM,CAAC,YAAY,CAAC,CAEjE;AAED;;;;;;;;GAQG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,CAAC,EAAE;IAAE,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAAC,YAAY,CAAC,CAE3F;AAED;;;;GAIG;AACH,wBAAgB,IAAI,CAAC,KAAK,EAAE,SAAS,GAAG,MAAM,CAAC,cAAc,CAAC,CAE7D;AAED;;;;;GAKG;AACH,wBAAgB,KAAK,CAAC,IAAI,EAAE,cAAc,EAAE,KAAK,EAAE,UAAU,GAAG,MAAM,CAAC,cAAc,CAAC,CAErF;AAED;;;;;;;GAOG;AACH,wBAAgB,WAAW,CACzB,IAAI,EAAE,cAAc,EACpB,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,GAAG,SAAI,GACN,MAAM,CAAC,cAAc,CAAC,CAExB;AAED;;;;;;GAMG;AACH,wBAAgB,UAAU,CACxB,IAAI,EAAE,cAAc,EACpB,QAAQ,EAAE,MAAM,EAChB,IAAI,CAAC,EAAE,UAAU,GAChB,MAAM,CAAC,cAAc,CAAC,CAExB;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,cAAc,EAAE,IAAI,CAAC,EAAE,UAAU,GAAG,MAAM,CAAC,cAAc,CAAC,CAE3F;AAED;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAC3B,IAAI,EAAE,cAAc,EACpB,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,IAAI,CAAC,EAAE,UAAU,GAChB,MAAM,CAAC,cAAc,CAAC,CAExB;AAED;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,cAAc,EAAE,IAAI,EAAE,UAAU,GAAG,MAAM,CAAC,cAAc,CAAC,CAExF;AAED;;;;;;;;GAQG;AACH,wBAAgB,OAAO,CACrB,IAAI,EAAE,cAAc,EACpB,MAAM,EAAE,MAAM,EACd,CAAC,EAAE,MAAM,EACT,CAAC,EAAE,MAAM,EACT,QAAQ,EAAE,MAAM,GACf,MAAM,CAAC,cAAc,CAAC,CAExB;AAED;;;;;;GAMG;AACH,wBAAgB,OAAO,CACrB,IAAI,EAAE,cAAc,EACpB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,OAAO,CAAA;CAAE,GAChG,MAAM,CAAC,cAAc,CAAC,CAExB;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,cAAc,EACpB,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,GACzB,MAAM,CAAC,cAAc,CAAC,CAExB;AAED;;;;;GAKG;AACH,wBAAgB,MAAM,CAAC,IAAI,EAAE,cAAc,EAAE,IAAI,EAAE,OAAO,GAAG,MAAM,CAAC,cAAc,CAAC,CAElF;AAED;;;;;;GAMG;AACH,wBAAgB,UAAU,CACxB,IAAI,EAAE,cAAc,EACpB,GAAG,EAAE,OAAO,EACZ,IAAI,EAAE,aAAa,GAClB,MAAM,CAAC,cAAc,CAAC,CAExB;AAED;;;;;GAKG;AACH,wBAAgB,MAAM,CACpB,IAAI,EAAE,cAAc,EACpB,IAAI,EAAE;IACJ,MAAM,EAAE,MAAM,CAAC;IACf,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,IAAI,GAAG,MAAM,CAAC;CAC3B,GACA,MAAM,CAAC,cAAc,CAAC,CAExB;AAED;;;;;GAKG;AACH,wBAAgB,MAAM,CACpB,IAAI,EAAE,cAAc,EACpB,IAAI,EAAE;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,QAAQ,GAAG,QAAQ,CAAA;CAAE,GAC1G,MAAM,CAAC,cAAc,CAAC,CAExB;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,cAAc,EAAE,IAAI,EAAE,iBAAiB,GAAG,MAAM,CAAC,cAAc,CAAC,CAEnG;AAED;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,cAAc,EAAE,IAAI,EAAE,gBAAgB,GAAG,MAAM,CAAC,cAAc,CAAC,CAEjG;AAED;;;;;;GAMG;AACH,wBAAgB,GAAG,CAAC,IAAI,EAAE,cAAc,EAAE,IAAI,EAAE,OAAO,GAAG,MAAM,CAAC,cAAc,CAAC,CAE/E;AAED;;;;;;GAMG;AACH,wBAAgB,GAAG,CAAC,IAAI,EAAE,cAAc,EAAE,IAAI,EAAE,OAAO,GAAG,MAAM,CAAC,cAAc,CAAC,CAE/E;AAED;;;;;GAKG;AACH,wBAAgB,KAAK,CAAC,OAAO,EAAE,WAAW,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,MAAM,CAAC,MAAM,CAAC,CAEhF;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,IAAI,CAAC,QAAQ,EAAE,WAAW,EAAE,EAAE,OAAO,EAAE,WAAW,GAAG,MAAM,CAAC,UAAU,CAAC,CAEtF;AAED;;;;;;;GAOG;AACH,wBAAgB,SAAS,CACvB,MAAM,EAAE,UAAU,EAClB,QAAQ,EAAE,WAAW,EAAE,EACvB,UAAU,EAAE,MAAM,EAClB,OAAO,CAAC,EAAE,UAAU,GACnB,MAAM,CAAC,MAAM,CAAC,CAEhB;AAED;;;;GAIG;AACH,wBAAgB,MAAM,CAAC,IAAI,EAAE,cAAc,GAAG,MAAM,CAAC,UAAU,CAAC,CAE/D;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,CAAC,UAAU,CAAC,CAEnE;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM,CAErD;AAED;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,cAAc,GAAG,iBAAiB,EAAE,CAElE;AAED;;;;;;;GAOG;AACH,wBAAgB,SAAS,CACvB,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,QAAQ,EACd,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,iBAAiB,KAAK,IAAI,GAC/C,MAAM,CAAC,MAAM,CAAC,CAEhB;AAED;;;;;;;GAOG;AACH,wBAAgB,SAAS,CACvB,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,QAAQ,EACd,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,iBAAiB,KAAK,IAAI,GAC/C,MAAM,CAAC,MAAM,CAAC,CAEhB;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,SAAS,GAAG,MAAM,CAAC,SAAS,CAAC,CAEhE;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,CAE3D;AAED;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,QAAQ,EACd,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,EACjB,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,iBAAiB,KAAK,IAAI,GAC/C,MAAM,CAAC,MAAM,CAAC,CAEhB;AAED,YAAY,EAAE,UAAU,EAAE,UAAU,EAAE,UAAU,EAAE,UAAU,EAAE,aAAa,EAAE,WAAW,EAAE,UAAU,EAAE,CAAC;AAEvG,4DAA4D;AAC5D,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC"}
+{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../src/api.ts"],"names":[],"mappings":"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"}

package/dist/api.js

@@ -6,7 +6,7 @@
  * preserve the `Result<T>` / warning-channel contract end to end. The fluent
  * `sheetMetal()` facade in `./facade.js` is built on top of these.
  */
-import { ok, err, validationError } from '@faicad/faijs/brepjs-compat';
+import { ok, err, validationError } from '@faicad/faijs/api';
 import { authorPart as authorPartFn, } from './authorFns.js';
 import { unfold as unfoldFn } from './unfoldFns.js';
 import { unfoldForeignSolid as unfoldForeignSolidFn } from './foreignUnfoldFns.js';
@@ -31,7 +31,7 @@ import { registerBendTable as registerBendTableFn, getBendTable as getBendTableF
  * @param spec - the part definition: base flat, material thickness, and the flange list to fold up.
  * @returns a `Result<SheetMetalPart>` carrying the authored part, or the first error encountered.
  */
-export function author(spec) {
+export async function author(spec) {
     return authorPartFn(spec);
 }
 /**
@@ -73,7 +73,7 @@ export function unfoldSolid(solid, opts) {
  * @param input - the flat pattern (region tree) to fold up.
  * @returns a `Result<SheetMetalPart>` carrying the folded 3D part, or the first error.
  */
-export function fold(input) {
+export async function fold(input) {
     return foldFn(input);
 }
 /**
@@ -82,7 +82,7 @@ export function fold(input) {
  * @param plane - the oriented cutting plane; material on the plane's `+normal` side is removed.
  * @returns a `Result<SheetMetalPart>` carrying the mitered part, or the first error.
  */
-export function miter(part, plane) {
+export async function miter(part, plane) {
     return miterCutFn(part, plane);
 }
 /**
@@ -93,7 +93,7 @@ export function miter(part, plane) {
  * @param gap - optional gap (in millimetres) left between the two mitered edges; defaults to 0.
  * @returns a `Result<SheetMetalPart>` carrying the mitered part, or the first error.
  */
-export function miterCorner(part, flangeIdA, flangeIdB, gap = 0) {
+export async function miterCorner(part, flangeIdA, flangeIdB, gap = 0) {
     return autoMiterCornerFn(part, flangeIdA, flangeIdB, gap);
 }
 /**
@@ -103,7 +103,7 @@ export function miterCorner(part, flangeIdA, flangeIdB, gap = 0) {
  * @param spec - optional relief specification overriding the defaults.
  * @returns a `Result<SheetMetalPart>` carrying the part with the relief added, or the first error.
  */
-export function bendRelief(part, flangeId, spec) {
+export async function bendRelief(part, flangeId, spec) {
     return addBendReliefFn(part, flangeId, spec);
 }
 /**
@@ -112,7 +112,7 @@ export function bendRelief(part, flangeId, spec) {
  * @param spec - optional relief specification applied to every partial bend.
  * @returns a `Result<SheetMetalPart>` carrying the part with all reliefs added, or the first error.
  */
-export function autoReliefs(part, spec) {
+export async function autoReliefs(part, spec) {
     return autoBendReliefsFn(part, spec);
 }
 /**
@@ -123,7 +123,7 @@ export function autoReliefs(part, spec) {
  * @param spec - optional relief specification overriding the defaults.
  * @returns a `Result<SheetMetalPart>` carrying the part with the corner relief added, or the first error.
  */
-export function relieveCorner(part, flangeIdA, flangeIdB, spec) {
+export async function relieveCorner(part, flangeIdA, flangeIdB, spec) {
     return cornerReliefFn(part, flangeIdA, flangeIdB, spec);
 }
 /**
@@ -132,7 +132,7 @@ export function relieveCorner(part, flangeIdA, flangeIdB, spec) {
  * @param spec - the cutout definition (kind, geometry, and target region).
  * @returns a `Result<SheetMetalPart>` carrying the part with the cutout punched, or the first error.
  */
-export function addCutout(part, spec) {
+export async function addCutout(part, spec) {
     return addCutoutFn(part, spec);
 }
 /**
@@ -144,7 +144,7 @@ export function addCutout(part, spec) {
  * @param diameter - hole diameter.
  * @returns a `Result<SheetMetalPart>` carrying the part with the hole punched, or the first error.
  */
-export function addHole(part, region, x, y, diameter) {
+export async function addHole(part, region, x, y, diameter) {
     return addHoleFn(part, region, x, y, diameter);
 }
 /**
@@ -154,7 +154,7 @@ export function addHole(part, region, x, y, diameter) {
  * @param opts - slot geometry: centre `(x, y)`, `length`, `width`, optional `angleDeg` rotation, and `round` ends flag.
  * @returns a `Result<SheetMetalPart>` carrying the part with the slot punched, or the first error.
  */
-export function addSlot(part, region, opts) {
+export async function addSlot(part, region, opts) {
     return addSlotFn(part, region, opts);
 }
 /**
@@ -164,7 +164,7 @@ export function addSlot(part, region, opts) {
  * @param points - region-local polygon vertices as `[x, y]` pairs.
  * @returns a `Result<SheetMetalPart>` carrying the part with the polygon cutout, or the first error.
  */
-export function addPolygonCutout(part, region, points) {
+export async function addPolygonCutout(part, region, points) {
     return addPolygonCutoutFn(part, region, points);
 }
 /**
@@ -173,7 +173,7 @@ export function addPolygonCutout(part, region, points) {
  * @param spec - tab definition: edge, width, and length.
  * @returns a `Result<SheetMetalPart>` carrying the part with the tab added, or the first error.
  */
-export function addTab(part, spec) {
+export async function addTab(part, spec) {
     return addTabFn(part, spec);
 }
 /**
@@ -183,7 +183,7 @@ export function addTab(part, spec) {
  * @param slot - placement of the matching slot on the second region.
  * @returns a `Result<SheetMetalPart>` carrying the part with the joint added, or the first error.
  */
-export function tabAndSlot(part, tab, slot) {
+export async function tabAndSlot(part, tab, slot) {
     return tabAndSlotFn(part, tab, slot);
 }
 /**
@@ -192,7 +192,7 @@ export function tabAndSlot(part, tab, slot) {
  * @param opts - louver geometry: target `region`, centre `(x, y)`, `length`, `width`, `height`, and optional `direction`.
  * @returns a `Result<SheetMetalPart>` carrying the part with the louver formed, or the first error.
  */
-export function louver(part, opts) {
+export async function louver(part, opts) {
     return louverFn(part, opts);
 }
 /**
@@ -201,7 +201,7 @@ export function louver(part, opts) {
  * @param opts - emboss geometry: target `region`, centre `(x, y)`, `diameter`, `height`, and `kind` (`dimple` or `emboss`).
  * @returns a `Result<SheetMetalPart>` carrying the part with the form added, or the first error.
  */
-export function emboss(part, opts) {
+export async function emboss(part, opts) {
     return embossFn(part, opts);
 }
 /**
@@ -211,7 +211,7 @@ export function emboss(part, opts) {
  * @param spec - contour flange definition: profile, base edge, and bend parameters.
  * @returns a `Result<SheetMetalPart>` carrying the part with the contour flange added, or the first error.
  */
-export function contourFlange(part, spec) {
+export async function contourFlange(part, spec) {
     return authorContourFlangeFn(part, spec);
 }
 /**
@@ -222,7 +222,7 @@ export function contourFlange(part, spec) {
  * @param spec - lofted flange definition: the two open profiles and their alignment.
  * @returns a `Result<SheetMetalPart>` carrying the part with the lofted flange added, or the first error.
  */
-export function loftedFlange(part, spec) {
+export async function loftedFlange(part, spec) {
     return authorLoftedFlangeFn(part, spec);
 }
 /**
@@ -232,7 +232,7 @@ export function loftedFlange(part, spec) {
  * @param spec - hem definition: edge, curl radius, and return leg length.
  * @returns a `Result<SheetMetalPart>` carrying the part with the hem added, or the first error.
  */
-export function hem(part, spec) {
+export async function hem(part, spec) {
     return hemFn(part, spec);
 }
 /**
@@ -242,7 +242,7 @@ export function hem(part, spec) {
  * @param spec - jog definition: bend line, offset height, and radii.
  * @returns a `Result<SheetMetalPart>` carrying the part with the jog added, or the first error.
  */
-export function jog(part, spec) {
+export async function jog(part, spec) {
     return jogFn(part, spec);
 }
 /**

package/dist/api.js.map

@@ -1 +1 @@
-{"version":3,"file":"api.js","sourceRoot":"","sources":["../src/api.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Public API — short-named wrappers over the sheet-metal `*Fns` modules.\n *\n * These are the canonical entry points for the domain: they delegate to the\n * underlying functional implementations without re-deriving any geometry, and\n * preserve the `Result<T>` / warning-channel contract end to end. The fluent\n * `sheetMetal()` facade in `./facade.js` is built on top of these.\n */\n\nimport { ok, err, validationError, type Result, type Solid } from '@faicad/faijs/brepjs-compat';\nimport {\n  authorPart as authorPartFn,\n  type AuthorSpec,\n  type FlangeSpec,\n} from './authorFns.js';\nimport { unfold as unfoldFn } from './unfoldFns.js';\nimport { unfoldForeignSolid as unfoldForeignSolidFn } from './foreignUnfoldFns.js';\nimport { fold as foldFn } from './foldFns.js';\nimport {\n  miterCut as miterCutFn,\n  autoMiterCorner as autoMiterCornerFn,\n  type MiterPlane,\n} from './miterFns.js';\nimport {\n  addBendRelief as addBendReliefFn,\n  autoBendReliefs as autoBendReliefsFn,\n  cornerRelief as cornerReliefFn,\n} from './reliefFns.js';\nimport {\n  addCutout as addCutoutFn,\n  addHole as addHoleFn,\n  addSlot as addSlotFn,\n  addPolygonCutout as addPolygonCutoutFn,\n} from './cutoutFns.js';\nimport {\n  addTab as addTabFn,\n  tabAndSlot as tabAndSlotFn,\n  type SlotPlacement,\n} from './tabFns.js';\nimport { louver as louverFn, emboss as embossFn } from './formFns.js';\nimport { authorContourFlange as authorContourFlangeFn } from './contourFlangeFns.js';\nimport { authorLoftedFlange as authorLoftedFlangeFn } from './loftedFlangeFns.js';\nimport { hem as hemFn } from './hemFns.js';\nimport { jog as jogFn } from './jogFns.js';\nimport { flatPatternToDXF as flatPatternToDXFFn, type DxfOptions } from './dxfFns.js';\nimport {\n  nest as nestFn,\n  nestToDXF as nestToDXFFn,\n  type NestOptions,\n  type NestResult,\n} from './nestFns.js';\nimport {\n  buildReport as buildReportFn,\n  reportFromUnfold as reportFromUnfoldFn,\n  reportToJSON as reportToJSONFn,\n} from './reportFns.js';\nimport { validatePart as validatePartFn } from './validateFns.js';\nimport { bendAllowance as bendAllowanceFn, developedLength as developedLengthFn } from './allowanceFns.js';\nimport {\n  registerBendTable as registerBendTableFn,\n  getBendTable as getBendTableFn,\n  resolveBendAllowance as resolveBendAllowanceFn,\n  type BendTable,\n} from './bendTableFns.js';\nimport type {\n  SheetMetalPart,\n  FlatPattern,\n  FlatInput,\n  BendReport,\n  BendRule,\n  ReliefSpec,\n  CutoutSpec,\n  TabSpec,\n  ContourFlangeSpec,\n  LoftedFlangeSpec,\n  HemSpec,\n  JogSpec,\n  UnfoldResult,\n  SheetMetalWarning,\n} from './types.js';\n\n/**\n * Author a straight-bend part: a base flat plus folded-up flanges.\n * @param spec - the part definition: base flat, material thickness, and the flange list to fold up.\n * @returns a `Result<SheetMetalPart>` carrying the authored part, or the first error encountered.\n */\nexport function author(spec: AuthorSpec): Result<SheetMetalPart> {\n  return authorPartFn(spec);\n}\n\n/**\n * Extract the lone 3D solid of an authored part as its own `Result` terminal.\n *\n * `author`/`fold`/`hem` return the data model `SheetMetalPart`; its `.solid`\n * field is the authored BREP solid. `.fai.js` statements cannot read nested\n * member expressions (`p1.solid`), so this explicit terminal is the sanctioned\n * way to pull the geometry out of a part.\n * @param part - the sheet-metal part carrying the authored solid.\n * @returns `Ok` with the part's surface, or `Err` (`NO_SOLID`) when the part\n * has no authored solid yet (e.g. it was only built by `flatPattern`).\n */\nexport function solidOf(part: SheetMetalPart): Result<Solid> {\n  return part.solid ? ok(part.solid) : err(validationError('NO_SOLID', 'part has no authored solid'));\n}\n\n/**\n * Flatten an authored part into a developed flat pattern + bend report + warnings.\n * @param part - the authored sheet-metal part to flatten.\n * @returns a `Result<UnfoldResult>` with the flat pattern, bend report, and any warnings.\n */\nexport function unfold(part: SheetMetalPart): Result<UnfoldResult> {\n  return unfoldFn(part);\n}\n\n/**\n * Unfold an imported sheet-metal solid that has no feature tree, by detecting its\n * geometry (planar panels + cylindrical bends) numerically. `kFactor` defaults to\n * the mid-surface neutral axis (0.5); supply a known material's K-factor to match\n * its development.\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 `Result<UnfoldResult>` with the detected flat pattern, report, and any warnings.\n */\nexport function unfoldSolid(solid: Solid, opts?: { kFactor?: number }): Result<UnfoldResult> {\n  return unfoldForeignSolidFn(solid, opts);\n}\n\n/**\n * Fold a flat pattern (region-tree) up into a 3D part — the inverse of {@link unfold}.\n * @param input - the flat pattern (region tree) to fold up.\n * @returns a `Result<SheetMetalPart>` carrying the folded 3D part, or the first error.\n */\nexport function fold(input: FlatInput): Result<SheetMetalPart> {\n  return foldFn(input);\n}\n\n/**\n * Cut a part by an oriented plane, removing material on the `+normal` side.\n * @param part - the sheet-metal part to cut.\n * @param plane - the oriented cutting plane; material on the plane's `+normal` side is removed.\n * @returns a `Result<SheetMetalPart>` carrying the mitered part, or the first error.\n */\nexport function miter(part: SheetMetalPart, plane: MiterPlane): Result<SheetMetalPart> {\n  return miterCutFn(part, plane);\n}\n\n/**\n * Auto-miter the shared corner of two flanges with an optional gap.\n * @param part - the sheet-metal part whose corner is to be mitered.\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 `Result<SheetMetalPart>` carrying the mitered part, or the first error.\n */\nexport function miterCorner(\n  part: SheetMetalPart,\n  flangeIdA: string,\n  flangeIdB: string,\n  gap = 0\n): Result<SheetMetalPart> {\n  return autoMiterCornerFn(part, flangeIdA, flangeIdB, gap);\n}\n\n/**\n * Add a bend relief slot at each mid-edge end of a partial flange's bend line.\n * @param part - the sheet-metal part to modify.\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 `Result<SheetMetalPart>` carrying the part with the relief added, or the first error.\n */\nexport function bendRelief(\n  part: SheetMetalPart,\n  flangeId: string,\n  spec?: ReliefSpec\n): Result<SheetMetalPart> {\n  return addBendReliefFn(part, flangeId, spec);\n}\n\n/**\n * Add a bend relief to every partial-span bend in the part.\n * @param part - the sheet-metal part to modify.\n * @param spec - optional relief specification applied to every partial bend.\n * @returns a `Result<SheetMetalPart>` carrying the part with all reliefs added, or the first error.\n */\nexport function autoReliefs(part: SheetMetalPart, spec?: ReliefSpec): Result<SheetMetalPart> {\n  return autoBendReliefsFn(part, spec);\n}\n\n/**\n * Cut a corner relief notch at the shared corner of two adjacent flanges.\n * @param part - the sheet-metal part to modify.\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 `Result<SheetMetalPart>` carrying the part with the corner relief added, or the first error.\n */\nexport function relieveCorner(\n  part: SheetMetalPart,\n  flangeIdA: string,\n  flangeIdB: string,\n  spec?: ReliefSpec\n): Result<SheetMetalPart> {\n  return cornerReliefFn(part, flangeIdA, flangeIdB, spec);\n}\n\n/**\n * Punch a cutout (hole / slot / polygon) through a named flat region's thickness.\n * @param part - the sheet-metal part to modify.\n * @param spec - the cutout definition (kind, geometry, and target region).\n * @returns a `Result<SheetMetalPart>` carrying the part with the cutout punched, or the first error.\n */\nexport function addCutout(part: SheetMetalPart, spec: CutoutSpec): Result<SheetMetalPart> {\n  return addCutoutFn(part, spec);\n}\n\n/**\n * Punch a circular hole of `diameter` centred at region-local `(x, y)`.\n * @param part - the sheet-metal part to modify.\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 `Result<SheetMetalPart>` carrying the part with the hole punched, or the first error.\n */\nexport function addHole(\n  part: SheetMetalPart,\n  region: string,\n  x: number,\n  y: number,\n  diameter: number\n): Result<SheetMetalPart> {\n  return addHoleFn(part, region, x, y, diameter);\n}\n\n/**\n * Punch a slot (rectangular or obround) centred at region-local `(x, y)`.\n * @param part - the sheet-metal part to modify.\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 `Result<SheetMetalPart>` carrying the part with the slot punched, or the first error.\n */\nexport function addSlot(\n  part: SheetMetalPart,\n  region: string,\n  opts: { x: number; y: number; length: number; width: number; angleDeg?: number; round?: boolean }\n): Result<SheetMetalPart> {\n  return addSlotFn(part, region, opts);\n}\n\n/**\n * Punch an arbitrary polygon cutout from its region-local `points`.\n * @param part - the sheet-metal part to modify.\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 `Result<SheetMetalPart>` carrying the part with the polygon cutout, or the first error.\n */\nexport function addPolygonCutout(\n  part: SheetMetalPart,\n  region: string,\n  points: [number, number][]\n): Result<SheetMetalPart> {\n  return addPolygonCutoutFn(part, region, points);\n}\n\n/**\n * Fuse a rectangular tab (additive protrusion) onto a region's edge.\n * @param part - the sheet-metal part to modify.\n * @param spec - tab definition: edge, width, and length.\n * @returns a `Result<SheetMetalPart>` carrying the part with the tab added, or the first error.\n */\nexport function addTab(part: SheetMetalPart, spec: TabSpec): Result<SheetMetalPart> {\n  return addTabFn(part, spec);\n}\n\n/**\n * Self-fixturing tab-and-slot joint: a tab on one region + a matching slot on another.\n * @param part - the sheet-metal part to modify.\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 `Result<SheetMetalPart>` carrying the part with the joint added, or the first error.\n */\nexport function tabAndSlot(\n  part: SheetMetalPart,\n  tab: TabSpec,\n  slot: SlotPlacement\n): Result<SheetMetalPart> {\n  return tabAndSlotFn(part, tab, slot);\n}\n\n/**\n * Form a louver (vent flap cut on 3 sides, formed up along the hinge) on a region.\n * @param part - the sheet-metal part to modify.\n * @param opts - louver geometry: target `region`, centre `(x, y)`, `length`, `width`, `height`, and optional `direction`.\n * @returns a `Result<SheetMetalPart>` carrying the part with the louver formed, or the first error.\n */\nexport function louver(\n  part: SheetMetalPart,\n  opts: {\n    region: string;\n    x: number;\n    y: number;\n    length: number;\n    width: number;\n    height: number;\n    direction?: 'up' | 'down';\n  }\n): Result<SheetMetalPart> {\n  return louverFn(part, opts);\n}\n\n/**\n * Form a round emboss (raised) or dimple (recessed) on a region.\n * @param part - the sheet-metal part to modify.\n * @param opts - emboss geometry: target `region`, centre `(x, y)`, `diameter`, `height`, and `kind` (`dimple` or `emboss`).\n * @returns a `Result<SheetMetalPart>` carrying the part with the form added, or the first error.\n */\nexport function emboss(\n  part: SheetMetalPart,\n  opts: { region: string; x: number; y: number; diameter: number; height: number; kind: 'dimple' | 'emboss' }\n): Result<SheetMetalPart> {\n  return embossFn(part, opts);\n}\n\n/**\n * Author a contour flange: an open line/arc profile swept along a base edge into a\n * multi-bend cross-section. The development is exact (Σ segment developed lengths).\n * @param part - the sheet-metal part the flange is added to.\n * @param spec - contour flange definition: profile, base edge, and bend parameters.\n * @returns a `Result<SheetMetalPart>` carrying the part with the contour flange added, or the first error.\n */\nexport function contourFlange(part: SheetMetalPart, spec: ContourFlangeSpec): Result<SheetMetalPart> {\n  return authorContourFlangeFn(part, spec);\n}\n\n/**\n * Author a lofted / ruled transition flange between two parallel open profiles. The\n * development is by triangulation — exact for a developable transition, an\n * approximation (with a `DEVELOPMENT_APPROXIMATE` unfold warning) otherwise.\n * @param part - the sheet-metal part the flange is added to.\n * @param spec - lofted flange definition: the two open profiles and their alignment.\n * @returns a `Result<SheetMetalPart>` carrying the part with the lofted flange added, or the first error.\n */\nexport function loftedFlange(part: SheetMetalPart, spec: LoftedFlangeSpec): Result<SheetMetalPart> {\n  return authorLoftedFlangeFn(part, spec);\n}\n\n/**\n * Author a hem: fold a region edge back ~180°+ onto its parent and run a short\n * return leg. The development is exact (Σ curl bend allowances + return length).\n * @param part - the sheet-metal part the hem is added to.\n * @param spec - hem definition: edge, curl radius, and return leg length.\n * @returns a `Result<SheetMetalPart>` carrying the part with the hem added, or the first error.\n */\nexport function hem(part: SheetMetalPart, spec: HemSpec): Result<SheetMetalPart> {\n  return hemFn(part, spec);\n}\n\n/**\n * Author a jog (joggle): two opposite bends stepping the flat by `offsetHeight`\n * perpendicular to its plane, then continuing parallel. Development is exact.\n * @param part - the sheet-metal part the jog is added to.\n * @param spec - jog definition: bend line, offset height, and radii.\n * @returns a `Result<SheetMetalPart>` carrying the part with the jog added, or the first error.\n */\nexport function jog(part: SheetMetalPart, spec: JogSpec): Result<SheetMetalPart> {\n  return jogFn(part, spec);\n}\n\n/**\n * Emit an annotated multi-layer DXF string for a flat pattern.\n * @param pattern - the flat pattern to serialize.\n * @param options - optional DXF output options (layers, precision, units).\n * @returns a `Result<string>` carrying the DXF text, or the first error.\n */\nexport function toDXF(pattern: FlatPattern, options?: DxfOptions): Result<string> {\n  return flatPatternToDXFFn(pattern, options);\n}\n\n/**\n * Nest developed flat patterns onto stock sheets to reduce waste. The default\n * `strategy: \"bbox\"` packs each part as its outline bounding box (fast, no\n * interlocking). `strategy: \"nfp\"` is true-shape / no-fit-polygon nesting: the actual\n * outline polygons are packed so concave (L-shaped) parts interlock for higher\n * utilization. The NFP packer is a HEURISTIC (bottom-left-fill) — not provably\n * optimal — but never overlaps parts and never drops a part silently.\n * @param patterns - the flat patterns to place onto stock sheets.\n * @param options - nesting configuration: stock sheet size, strategy, and spacing.\n * @returns a `Result<NestResult>` carrying the placed sheets and part transforms, or the first error.\n */\nexport function nest(patterns: FlatPattern[], options: NestOptions): Result<NestResult> {\n  return nestFn(patterns, options);\n}\n\n/**\n * Emit one fabrication-ready DXF for a single nested sheet (all parts placed).\n * @param result - the nesting result containing the sheet to render.\n * @param patterns - the original flat patterns referenced by `result`.\n * @param sheetIndex - index of the nested sheet to emit.\n * @param options - optional DXF output options (layers, precision, units).\n * @returns a `Result<string>` carrying the DXF text, or the first error.\n */\nexport function nestToDXF(\n  result: NestResult,\n  patterns: FlatPattern[],\n  sheetIndex: number,\n  options?: DxfOptions\n): Result<string> {\n  return nestToDXFFn(result, patterns, sheetIndex, options);\n}\n\n/**\n * Build a bend report by walking the part's feature tree.\n * @param part - the sheet-metal part to report on.\n * @returns a `Result<BendReport>` carrying the computed bend report, or the first error.\n */\nexport function report(part: SheetMetalPart): Result<BendReport> {\n  return buildReportFn(part);\n}\n\n/**\n * Project the report already computed by {@link unfold} without re-walking the tree.\n * @param result - the unfold result whose bend report is to be projected.\n * @returns a `Result<BendReport>` carrying the projected bend report, or the first error.\n */\nexport function reportFrom(result: UnfoldResult): Result<BendReport> {\n  return reportFromUnfoldFn(result);\n}\n\n/**\n * Serialize a bend report to stable pretty-printed JSON.\n * @param report - the bend report to serialize.\n * @returns the stable pretty-printed JSON string.\n */\nexport function reportJSON(report: BendReport): string {\n  return reportToJSONFn(report);\n}\n\n/**\n * Manufacturability checks — advisory warnings, never errors.\n * @param part - the sheet-metal part to check.\n * @returns the list of manufacturability warnings (empty when the part is clean).\n */\nexport function validate(part: SheetMetalPart): SheetMetalWarning[] {\n  return validatePartFn(part);\n}\n\n/**\n * Bend allowance `BA = (π/180)·|angle|·(R + K·T)` for a single bend.\n * @param angleDeg - the bend angle in degrees.\n * @param thickness - the material thickness, in the same units as the rule radii.\n * @param rule - the bend rule (K-factor, inner radius, or a bend-table reference) to apply.\n * @param onWarning - optional callback invoked for non-fatal warnings during the computation.\n * @returns a `Result<number>` carrying the bend allowance, or the first error.\n */\nexport function allowance(\n  angleDeg: number,\n  thickness: number,\n  rule: BendRule,\n  onWarning?: (warning: SheetMetalWarning) => void\n): Result<number> {\n  return bendAllowanceFn(angleDeg, thickness, rule, onWarning);\n}\n\n/**\n * Neutral-axis developed length of a bend region (numerically equal to the allowance).\n * @param angleDeg - the bend angle in degrees.\n * @param thickness - the material thickness, in the same units as the rule radii.\n * @param rule - the bend rule (K-factor, inner radius, or a bend-table reference) to apply.\n * @param onWarning - optional callback invoked for non-fatal warnings during the computation.\n * @returns a `Result<number>` carrying the developed length, or the first error.\n */\nexport function developed(\n  angleDeg: number,\n  thickness: number,\n  rule: BendRule,\n  onWarning?: (warning: SheetMetalWarning) => void\n): Result<number> {\n  return developedLengthFn(angleDeg, thickness, rule, onWarning);\n}\n\n/**\n * Register (or replace) a shop bend table so rules can reference it by id.\n * @param table - the bend table to register.\n * @returns a `Result<BendTable>` carrying the registered table, or the first error.\n */\nexport function addBendTable(table: BendTable): Result<BendTable> {\n  return registerBendTableFn(table);\n}\n\n/**\n * Look up a registered bend table by id (starter tables included).\n * @param id - the bend table id to look up.\n * @returns the matching `BendTable`, or `undefined` when no such table is registered.\n */\nexport function bendTable(id: string): BendTable | undefined {\n  return getBendTableFn(id);\n}\n\n/**\n * Resolve a bend's developed allowance through the single resolution point:\n * a referenced bend table, then an explicit `rule.allowance`, then the K-factor\n * formula. This is what {@link developed} delegates to.\n * @param rule - the bend rule (bend-table reference, explicit allowance, or K-factor) to resolve.\n * @param angleDeg - the bend angle in degrees.\n * @param thickness - the material thickness, in the same units as the rule radii.\n * @param onWarning - optional callback invoked for non-fatal warnings during the computation.\n * @returns a `Result<number>` carrying the resolved allowance, or the first error.\n */\nexport function resolveAllowance(\n  rule: BendRule,\n  angleDeg: number,\n  thickness: number,\n  onWarning?: (warning: SheetMetalWarning) => void\n): Result<number> {\n  return resolveBendAllowanceFn(rule, angleDeg, thickness, onWarning);\n}\n\nexport type { AuthorSpec, FlangeSpec, MiterPlane, DxfOptions, SlotPlacement, NestOptions, NestResult };\n\n/** The live bend-table registry (shared resource, §7.3). */\nexport { bendTables } from './bendTableFns.js';\n"]}
+{"version":3,"file":"api.js","sourceRoot":"","sources":["../src/api.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Public API — short-named wrappers over the sheet-metal `*Fns` modules.\n *\n * These are the canonical entry points for the domain: they delegate to the\n * underlying functional implementations without re-deriving any geometry, and\n * preserve the `Result<T>` / warning-channel contract end to end. The fluent\n * `sheetMetal()` facade in `./facade.js` is built on top of these.\n */\n\nimport type { Solid } from './types.js';\nimport {ok, err, validationError, type Result} from '@faicad/faijs/api';\nimport {\n  authorPart as authorPartFn,\n  type AuthorSpec,\n  type FlangeSpec,\n} from './authorFns.js';\nimport { unfold as unfoldFn } from './unfoldFns.js';\nimport { unfoldForeignSolid as unfoldForeignSolidFn } from './foreignUnfoldFns.js';\nimport { fold as foldFn } from './foldFns.js';\nimport {\n  miterCut as miterCutFn,\n  autoMiterCorner as autoMiterCornerFn,\n  type MiterPlane,\n} from './miterFns.js';\nimport {\n  addBendRelief as addBendReliefFn,\n  autoBendReliefs as autoBendReliefsFn,\n  cornerRelief as cornerReliefFn,\n} from './reliefFns.js';\nimport {\n  addCutout as addCutoutFn,\n  addHole as addHoleFn,\n  addSlot as addSlotFn,\n  addPolygonCutout as addPolygonCutoutFn,\n} from './cutoutFns.js';\nimport {\n  addTab as addTabFn,\n  tabAndSlot as tabAndSlotFn,\n  type SlotPlacement,\n} from './tabFns.js';\nimport { louver as louverFn, emboss as embossFn } from './formFns.js';\nimport { authorContourFlange as authorContourFlangeFn } from './contourFlangeFns.js';\nimport { authorLoftedFlange as authorLoftedFlangeFn } from './loftedFlangeFns.js';\nimport { hem as hemFn } from './hemFns.js';\nimport { jog as jogFn } from './jogFns.js';\nimport { flatPatternToDXF as flatPatternToDXFFn, type DxfOptions } from './dxfFns.js';\nimport {\n  nest as nestFn,\n  nestToDXF as nestToDXFFn,\n  type NestOptions,\n  type NestResult,\n} from './nestFns.js';\nimport {\n  buildReport as buildReportFn,\n  reportFromUnfold as reportFromUnfoldFn,\n  reportToJSON as reportToJSONFn,\n} from './reportFns.js';\nimport { validatePart as validatePartFn } from './validateFns.js';\nimport { bendAllowance as bendAllowanceFn, developedLength as developedLengthFn } from './allowanceFns.js';\nimport {\n  registerBendTable as registerBendTableFn,\n  getBendTable as getBendTableFn,\n  resolveBendAllowance as resolveBendAllowanceFn,\n  type BendTable,\n} from './bendTableFns.js';\nimport type {\n  SheetMetalPart,\n  FlatPattern,\n  FlatInput,\n  BendReport,\n  BendRule,\n  ReliefSpec,\n  CutoutSpec,\n  TabSpec,\n  ContourFlangeSpec,\n  LoftedFlangeSpec,\n  HemSpec,\n  JogSpec,\n  UnfoldResult,\n  SheetMetalWarning,\n} from './types.js';\n\n/**\n * Author a straight-bend part: a base flat plus folded-up flanges.\n * @param spec - the part definition: base flat, material thickness, and the flange list to fold up.\n * @returns a `Result<SheetMetalPart>` carrying the authored part, or the first error encountered.\n */\nexport async function author(spec: AuthorSpec): Promise<Result<SheetMetalPart>> {\n  return authorPartFn(spec);\n}\n\n/**\n * Extract the lone 3D solid of an authored part as its own `Result` terminal.\n *\n * `author`/`fold`/`hem` return the data model `SheetMetalPart`; its `.solid`\n * field is the authored BREP solid. `.fai.js` statements cannot read nested\n * member expressions (`p1.solid`), so this explicit terminal is the sanctioned\n * way to pull the geometry out of a part.\n * @param part - the sheet-metal part carrying the authored solid.\n * @returns `Ok` with the part's surface, or `Err` (`NO_SOLID`) when the part\n * has no authored solid yet (e.g. it was only built by `flatPattern`).\n */\nexport function solidOf(part: SheetMetalPart): Result<Solid> {\n  return part.solid ? ok(part.solid) : err(validationError('NO_SOLID', 'part has no authored solid'));\n}\n\n/**\n * Flatten an authored part into a developed flat pattern + bend report + warnings.\n * @param part - the authored sheet-metal part to flatten.\n * @returns a `Result<UnfoldResult>` with the flat pattern, bend report, and any warnings.\n */\nexport function unfold(part: SheetMetalPart): Result<UnfoldResult> {\n  return unfoldFn(part);\n}\n\n/**\n * Unfold an imported sheet-metal solid that has no feature tree, by detecting its\n * geometry (planar panels + cylindrical bends) numerically. `kFactor` defaults to\n * the mid-surface neutral axis (0.5); supply a known material's K-factor to match\n * its development.\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 `Result<UnfoldResult>` with the detected flat pattern, report, and any warnings.\n */\nexport function unfoldSolid(solid: Solid, opts?: { kFactor?: number }): Result<UnfoldResult> {\n  return unfoldForeignSolidFn(solid, opts);\n}\n\n/**\n * Fold a flat pattern (region-tree) up into a 3D part — the inverse of {@link unfold}.\n * @param input - the flat pattern (region tree) to fold up.\n * @returns a `Result<SheetMetalPart>` carrying the folded 3D part, or the first error.\n */\nexport async function fold(input: FlatInput): Promise<Result<SheetMetalPart>> {\n  return foldFn(input);\n}\n\n/**\n * Cut a part by an oriented plane, removing material on the `+normal` side.\n * @param part - the sheet-metal part to cut.\n * @param plane - the oriented cutting plane; material on the plane's `+normal` side is removed.\n * @returns a `Result<SheetMetalPart>` carrying the mitered part, or the first error.\n */\nexport async function miter(part: SheetMetalPart, plane: MiterPlane): Promise<Result<SheetMetalPart>> {\n  return miterCutFn(part, plane);\n}\n\n/**\n * Auto-miter the shared corner of two flanges with an optional gap.\n * @param part - the sheet-metal part whose corner is to be mitered.\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 `Result<SheetMetalPart>` carrying the mitered part, or the first error.\n */\nexport async function miterCorner(\n  part: SheetMetalPart,\n  flangeIdA: string,\n  flangeIdB: string,\n  gap = 0\n): Promise<Result<SheetMetalPart>> {\n  return autoMiterCornerFn(part, flangeIdA, flangeIdB, gap);\n}\n\n/**\n * Add a bend relief slot at each mid-edge end of a partial flange's bend line.\n * @param part - the sheet-metal part to modify.\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 `Result<SheetMetalPart>` carrying the part with the relief added, or the first error.\n */\nexport async function bendRelief(\n  part: SheetMetalPart,\n  flangeId: string,\n  spec?: ReliefSpec\n): Promise<Result<SheetMetalPart>> {\n  return addBendReliefFn(part, flangeId, spec);\n}\n\n/**\n * Add a bend relief to every partial-span bend in the part.\n * @param part - the sheet-metal part to modify.\n * @param spec - optional relief specification applied to every partial bend.\n * @returns a `Result<SheetMetalPart>` carrying the part with all reliefs added, or the first error.\n */\nexport async function autoReliefs(part: SheetMetalPart, spec?: ReliefSpec): Promise<Result<SheetMetalPart>> {\n  return autoBendReliefsFn(part, spec);\n}\n\n/**\n * Cut a corner relief notch at the shared corner of two adjacent flanges.\n * @param part - the sheet-metal part to modify.\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 `Result<SheetMetalPart>` carrying the part with the corner relief added, or the first error.\n */\nexport async function relieveCorner(\n  part: SheetMetalPart,\n  flangeIdA: string,\n  flangeIdB: string,\n  spec?: ReliefSpec\n): Promise<Result<SheetMetalPart>> {\n  return cornerReliefFn(part, flangeIdA, flangeIdB, spec);\n}\n\n/**\n * Punch a cutout (hole / slot / polygon) through a named flat region's thickness.\n * @param part - the sheet-metal part to modify.\n * @param spec - the cutout definition (kind, geometry, and target region).\n * @returns a `Result<SheetMetalPart>` carrying the part with the cutout punched, or the first error.\n */\nexport async function addCutout(part: SheetMetalPart, spec: CutoutSpec): Promise<Result<SheetMetalPart>> {\n  return addCutoutFn(part, spec);\n}\n\n/**\n * Punch a circular hole of `diameter` centred at region-local `(x, y)`.\n * @param part - the sheet-metal part to modify.\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 `Result<SheetMetalPart>` carrying the part with the hole punched, or the first error.\n */\nexport async function addHole(\n  part: SheetMetalPart,\n  region: string,\n  x: number,\n  y: number,\n  diameter: number\n): Promise<Result<SheetMetalPart>> {\n  return addHoleFn(part, region, x, y, diameter);\n}\n\n/**\n * Punch a slot (rectangular or obround) centred at region-local `(x, y)`.\n * @param part - the sheet-metal part to modify.\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 `Result<SheetMetalPart>` carrying the part with the slot punched, or the first error.\n */\nexport async function addSlot(\n  part: SheetMetalPart,\n  region: string,\n  opts: { x: number; y: number; length: number; width: number; angleDeg?: number; round?: boolean }\n): Promise<Result<SheetMetalPart>> {\n  return addSlotFn(part, region, opts);\n}\n\n/**\n * Punch an arbitrary polygon cutout from its region-local `points`.\n * @param part - the sheet-metal part to modify.\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 `Result<SheetMetalPart>` carrying the part with the polygon cutout, or the first error.\n */\nexport async function addPolygonCutout(\n  part: SheetMetalPart,\n  region: string,\n  points: [number, number][]\n): Promise<Result<SheetMetalPart>> {\n  return addPolygonCutoutFn(part, region, points);\n}\n\n/**\n * Fuse a rectangular tab (additive protrusion) onto a region's edge.\n * @param part - the sheet-metal part to modify.\n * @param spec - tab definition: edge, width, and length.\n * @returns a `Result<SheetMetalPart>` carrying the part with the tab added, or the first error.\n */\nexport async function addTab(part: SheetMetalPart, spec: TabSpec): Promise<Result<SheetMetalPart>> {\n  return addTabFn(part, spec);\n}\n\n/**\n * Self-fixturing tab-and-slot joint: a tab on one region + a matching slot on another.\n * @param part - the sheet-metal part to modify.\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 `Result<SheetMetalPart>` carrying the part with the joint added, or the first error.\n */\nexport async function tabAndSlot(\n  part: SheetMetalPart,\n  tab: TabSpec,\n  slot: SlotPlacement\n): Promise<Result<SheetMetalPart>> {\n  return tabAndSlotFn(part, tab, slot);\n}\n\n/**\n * Form a louver (vent flap cut on 3 sides, formed up along the hinge) on a region.\n * @param part - the sheet-metal part to modify.\n * @param opts - louver geometry: target `region`, centre `(x, y)`, `length`, `width`, `height`, and optional `direction`.\n * @returns a `Result<SheetMetalPart>` carrying the part with the louver formed, or the first error.\n */\nexport async function louver(\n  part: SheetMetalPart,\n  opts: {\n    region: string;\n    x: number;\n    y: number;\n    length: number;\n    width: number;\n    height: number;\n    direction?: 'up' | 'down';\n  }\n): Promise<Result<SheetMetalPart>> {\n  return louverFn(part, opts);\n}\n\n/**\n * Form a round emboss (raised) or dimple (recessed) on a region.\n * @param part - the sheet-metal part to modify.\n * @param opts - emboss geometry: target `region`, centre `(x, y)`, `diameter`, `height`, and `kind` (`dimple` or `emboss`).\n * @returns a `Result<SheetMetalPart>` carrying the part with the form added, or the first error.\n */\nexport async function emboss(\n  part: SheetMetalPart,\n  opts: { region: string; x: number; y: number; diameter: number; height: number; kind: 'dimple' | 'emboss' }\n): Promise<Result<SheetMetalPart>> {\n  return embossFn(part, opts);\n}\n\n/**\n * Author a contour flange: an open line/arc profile swept along a base edge into a\n * multi-bend cross-section. The development is exact (Σ segment developed lengths).\n * @param part - the sheet-metal part the flange is added to.\n * @param spec - contour flange definition: profile, base edge, and bend parameters.\n * @returns a `Result<SheetMetalPart>` carrying the part with the contour flange added, or the first error.\n */\nexport async function contourFlange(part: SheetMetalPart, spec: ContourFlangeSpec): Promise<Result<SheetMetalPart>> {\n  return authorContourFlangeFn(part, spec);\n}\n\n/**\n * Author a lofted / ruled transition flange between two parallel open profiles. The\n * development is by triangulation — exact for a developable transition, an\n * approximation (with a `DEVELOPMENT_APPROXIMATE` unfold warning) otherwise.\n * @param part - the sheet-metal part the flange is added to.\n * @param spec - lofted flange definition: the two open profiles and their alignment.\n * @returns a `Result<SheetMetalPart>` carrying the part with the lofted flange added, or the first error.\n */\nexport async function loftedFlange(part: SheetMetalPart, spec: LoftedFlangeSpec): Promise<Result<SheetMetalPart>> {\n  return authorLoftedFlangeFn(part, spec);\n}\n\n/**\n * Author a hem: fold a region edge back ~180°+ onto its parent and run a short\n * return leg. The development is exact (Σ curl bend allowances + return length).\n * @param part - the sheet-metal part the hem is added to.\n * @param spec - hem definition: edge, curl radius, and return leg length.\n * @returns a `Result<SheetMetalPart>` carrying the part with the hem added, or the first error.\n */\nexport async function hem(part: SheetMetalPart, spec: HemSpec): Promise<Result<SheetMetalPart>> {\n  return hemFn(part, spec);\n}\n\n/**\n * Author a jog (joggle): two opposite bends stepping the flat by `offsetHeight`\n * perpendicular to its plane, then continuing parallel. Development is exact.\n * @param part - the sheet-metal part the jog is added to.\n * @param spec - jog definition: bend line, offset height, and radii.\n * @returns a `Result<SheetMetalPart>` carrying the part with the jog added, or the first error.\n */\nexport async function jog(part: SheetMetalPart, spec: JogSpec): Promise<Result<SheetMetalPart>> {\n  return jogFn(part, spec);\n}\n\n/**\n * Emit an annotated multi-layer DXF string for a flat pattern.\n * @param pattern - the flat pattern to serialize.\n * @param options - optional DXF output options (layers, precision, units).\n * @returns a `Result<string>` carrying the DXF text, or the first error.\n */\nexport function toDXF(pattern: FlatPattern, options?: DxfOptions): Result<string> {\n  return flatPatternToDXFFn(pattern, options);\n}\n\n/**\n * Nest developed flat patterns onto stock sheets to reduce waste. The default\n * `strategy: \"bbox\"` packs each part as its outline bounding box (fast, no\n * interlocking). `strategy: \"nfp\"` is true-shape / no-fit-polygon nesting: the actual\n * outline polygons are packed so concave (L-shaped) parts interlock for higher\n * utilization. The NFP packer is a HEURISTIC (bottom-left-fill) — not provably\n * optimal — but never overlaps parts and never drops a part silently.\n * @param patterns - the flat patterns to place onto stock sheets.\n * @param options - nesting configuration: stock sheet size, strategy, and spacing.\n * @returns a `Result<NestResult>` carrying the placed sheets and part transforms, or the first error.\n */\nexport function nest(patterns: FlatPattern[], options: NestOptions): Result<NestResult> {\n  return nestFn(patterns, options);\n}\n\n/**\n * Emit one fabrication-ready DXF for a single nested sheet (all parts placed).\n * @param result - the nesting result containing the sheet to render.\n * @param patterns - the original flat patterns referenced by `result`.\n * @param sheetIndex - index of the nested sheet to emit.\n * @param options - optional DXF output options (layers, precision, units).\n * @returns a `Result<string>` carrying the DXF text, or the first error.\n */\nexport function nestToDXF(\n  result: NestResult,\n  patterns: FlatPattern[],\n  sheetIndex: number,\n  options?: DxfOptions\n): Result<string> {\n  return nestToDXFFn(result, patterns, sheetIndex, options);\n}\n\n/**\n * Build a bend report by walking the part's feature tree.\n * @param part - the sheet-metal part to report on.\n * @returns a `Result<BendReport>` carrying the computed bend report, or the first error.\n */\nexport function report(part: SheetMetalPart): Result<BendReport> {\n  return buildReportFn(part);\n}\n\n/**\n * Project the report already computed by {@link unfold} without re-walking the tree.\n * @param result - the unfold result whose bend report is to be projected.\n * @returns a `Result<BendReport>` carrying the projected bend report, or the first error.\n */\nexport function reportFrom(result: UnfoldResult): Result<BendReport> {\n  return reportFromUnfoldFn(result);\n}\n\n/**\n * Serialize a bend report to stable pretty-printed JSON.\n * @param report - the bend report to serialize.\n * @returns the stable pretty-printed JSON string.\n */\nexport function reportJSON(report: BendReport): string {\n  return reportToJSONFn(report);\n}\n\n/**\n * Manufacturability checks — advisory warnings, never errors.\n * @param part - the sheet-metal part to check.\n * @returns the list of manufacturability warnings (empty when the part is clean).\n */\nexport function validate(part: SheetMetalPart): SheetMetalWarning[] {\n  return validatePartFn(part);\n}\n\n/**\n * Bend allowance `BA = (π/180)·|angle|·(R + K·T)` for a single bend.\n * @param angleDeg - the bend angle in degrees.\n * @param thickness - the material thickness, in the same units as the rule radii.\n * @param rule - the bend rule (K-factor, inner radius, or a bend-table reference) to apply.\n * @param onWarning - optional callback invoked for non-fatal warnings during the computation.\n * @returns a `Result<number>` carrying the bend allowance, or the first error.\n */\nexport function allowance(\n  angleDeg: number,\n  thickness: number,\n  rule: BendRule,\n  onWarning?: (warning: SheetMetalWarning) => void\n): Result<number> {\n  return bendAllowanceFn(angleDeg, thickness, rule, onWarning);\n}\n\n/**\n * Neutral-axis developed length of a bend region (numerically equal to the allowance).\n * @param angleDeg - the bend angle in degrees.\n * @param thickness - the material thickness, in the same units as the rule radii.\n * @param rule - the bend rule (K-factor, inner radius, or a bend-table reference) to apply.\n * @param onWarning - optional callback invoked for non-fatal warnings during the computation.\n * @returns a `Result<number>` carrying the developed length, or the first error.\n */\nexport function developed(\n  angleDeg: number,\n  thickness: number,\n  rule: BendRule,\n  onWarning?: (warning: SheetMetalWarning) => void\n): Result<number> {\n  return developedLengthFn(angleDeg, thickness, rule, onWarning);\n}\n\n/**\n * Register (or replace) a shop bend table so rules can reference it by id.\n * @param table - the bend table to register.\n * @returns a `Result<BendTable>` carrying the registered table, or the first error.\n */\nexport function addBendTable(table: BendTable): Result<BendTable> {\n  return registerBendTableFn(table);\n}\n\n/**\n * Look up a registered bend table by id (starter tables included).\n * @param id - the bend table id to look up.\n * @returns the matching `BendTable`, or `undefined` when no such table is registered.\n */\nexport function bendTable(id: string): BendTable | undefined {\n  return getBendTableFn(id);\n}\n\n/**\n * Resolve a bend's developed allowance through the single resolution point:\n * a referenced bend table, then an explicit `rule.allowance`, then the K-factor\n * formula. This is what {@link developed} delegates to.\n * @param rule - the bend rule (bend-table reference, explicit allowance, or K-factor) to resolve.\n * @param angleDeg - the bend angle in degrees.\n * @param thickness - the material thickness, in the same units as the rule radii.\n * @param onWarning - optional callback invoked for non-fatal warnings during the computation.\n * @returns a `Result<number>` carrying the resolved allowance, or the first error.\n */\nexport function resolveAllowance(\n  rule: BendRule,\n  angleDeg: number,\n  thickness: number,\n  onWarning?: (warning: SheetMetalWarning) => void\n): Result<number> {\n  return resolveBendAllowanceFn(rule, angleDeg, thickness, onWarning);\n}\n\nexport type { AuthorSpec, FlangeSpec, MiterPlane, DxfOptions, SlotPlacement, NestOptions, NestResult };\n\n/** The live bend-table registry (shared resource, §7.3). */\nexport { bendTables } from './bendTableFns.js';\n"]}

package/dist/authorFns.d.ts

@@ -1,4 +1,4 @@
-import { type Result, type Vec3 } from '@faicad/faijs/brepjs-compat';
+import { type Result, type Vec3 } from '@faicad/faijs/api';
 import type { BendRule, EdgeRef, FlatSide, MaterialSpec, MiterSpec, SheetMetalPart } from './types.js';
 import { type FeatureTree } from './featureTreeFns.js';
 /** Authoring options for the base flat the flanges attach to. */
@@ -98,7 +98,7 @@ export interface FlatFrame {
  *   `err` with a `validationError` for an invalid thickness / base / flange /
  *   seam specification.
  */
-export declare function authorPart(spec: AuthorSpec): Result<SheetMetalPart>;
+export declare function authorPart(spec: AuthorSpec): Promise<Result<SheetMetalPart>>;
 /**
  * World {@link FlatFrame} of every flat region of an authored part, keyed by region
  * id (`'root'` for the base). Reconstructed from the recorded bend/flange feature

package/dist/authorFns.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"authorFns.d.ts","sourceRoot":"","sources":["../src/authorFns.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,MAAM,EACX,KAAK,IAAI,EAoBV,MAAM,6BAA6B,CAAC;AACrC,OAAO,KAAK,EAEV,QAAQ,EAER,OAAO,EACP,QAAQ,EACR,YAAY,EACZ,SAAS,EACT,cAAc,EACf,MAAM,YAAY,CAAC;AAEpB,OAAO,EAA6B,KAAK,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAElF,iEAAiE;AACjE,MAAM,WAAW,YAAY;IAC3B,sCAAsC;IACtC,MAAM,EAAE,MAAM,CAAC;IACf,wCAAwC;IACxC,KAAK,EAAE,MAAM,CAAC;CACf;AAED,4EAA4E;AAC5E,MAAM,MAAM,UAAU,GAAG,QAAQ,CAAC;AAElC,gEAAgE;AAChE,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,4EAA4E;IAC5E,MAAM,EAAE,MAAM,CAAC;IACf,oCAAoC;IACpC,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,QAAQ,CAAC;IACf,wEAAwE;IACxE,IAAI,CAAC,EAAE,UAAU,GAAG,SAAS,CAAC;IAC9B,yEAAyE;IACzE,SAAS,CAAC,EAAE,IAAI,GAAG,MAAM,GAAG,SAAS,CAAC;IACtC,yFAAyF;IACzF,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,yDAAyD;IACzD,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,uEAAuE;IACvE,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,KAAK,CAAC,EAAE,SAAS,GAAG,SAAS,CAAC;CAC/B;AAED;;;;;GAKG;AACH,MAAM,WAAW,QAAQ;IACvB,6FAA6F;IAC7F,MAAM,EAAE,MAAM,CAAC;IACf,qFAAqF;IACrF,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,QAAQ,CAAC;CAChB;AAED,qCAAqC;AACrC,MAAM,WAAW,UAAU;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,YAAY,CAAC;IACnB,OAAO,EAAE,UAAU,EAAE,CAAC;IACtB,QAAQ,CAAC,EAAE,YAAY,GAAG,SAAS,CAAC;IACpC,2EAA2E;IAC3E,KAAK,CAAC,EAAE,QAAQ,EAAE,GAAG,SAAS,CAAC;CAChC;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAEtD;AAED;;;;GAIG;AACH,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX;4EACwE;IACxE,MAAM,EAAE,IAAI,CAAC;IACb,+DAA+D;IAC/D,CAAC,EAAE,IAAI,CAAC;IACR,+DAA+D;IAC/D,CAAC,EAAE,IAAI,CAAC;IACR,0DAA0D;IAC1D,CAAC,EAAE,IAAI,CAAC;IACR,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,CAAC,cAAc,CAAC,CA6GnE;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,WAAW,CACzB,IAAI,EAAE,cAAc,EACpB,IAAI,CAAC,EAAE,WAAW,GACjB,MAAM,CAAC,GAAG,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC,CAuChC"}
+{"version":3,"file":"authorFns.d.ts","sourceRoot":"","sources":["../src/authorFns.ts"],"names":[],"mappings":"AAEA,OAAO,EAAC,KAAK,MAAM,EAAE,KAAK,IAAI,EAAqI,MAAM,mBAAmB,CAAC;AAC7L,OAAO,KAAK,EAEV,QAAQ,EAER,OAAO,EACP,QAAQ,EACR,YAAY,EACZ,SAAS,EACT,cAAc,EACf,MAAM,YAAY,CAAC;AAEpB,OAAO,EAA6B,KAAK,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAElF,iEAAiE;AACjE,MAAM,WAAW,YAAY;IAC3B,sCAAsC;IACtC,MAAM,EAAE,MAAM,CAAC;IACf,wCAAwC;IACxC,KAAK,EAAE,MAAM,CAAC;CACf;AAED,4EAA4E;AAC5E,MAAM,MAAM,UAAU,GAAG,QAAQ,CAAC;AAElC,gEAAgE;AAChE,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,4EAA4E;IAC5E,MAAM,EAAE,MAAM,CAAC;IACf,oCAAoC;IACpC,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,QAAQ,CAAC;IACf,wEAAwE;IACxE,IAAI,CAAC,EAAE,UAAU,GAAG,SAAS,CAAC;IAC9B,yEAAyE;IACzE,SAAS,CAAC,EAAE,IAAI,GAAG,MAAM,GAAG,SAAS,CAAC;IACtC,yFAAyF;IACzF,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,yDAAyD;IACzD,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,uEAAuE;IACvE,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,KAAK,CAAC,EAAE,SAAS,GAAG,SAAS,CAAC;CAC/B;AAED;;;;;GAKG;AACH,MAAM,WAAW,QAAQ;IACvB,6FAA6F;IAC7F,MAAM,EAAE,MAAM,CAAC;IACf,qFAAqF;IACrF,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,QAAQ,CAAC;CAChB;AAED,qCAAqC;AACrC,MAAM,WAAW,UAAU;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,YAAY,CAAC;IACnB,OAAO,EAAE,UAAU,EAAE,CAAC;IACtB,QAAQ,CAAC,EAAE,YAAY,GAAG,SAAS,CAAC;IACpC,2EAA2E;IAC3E,KAAK,CAAC,EAAE,QAAQ,EAAE,GAAG,SAAS,CAAC;CAChC;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAEtD;AAED;;;;GAIG;AACH,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX;4EACwE;IACxE,MAAM,EAAE,IAAI,CAAC;IACb,+DAA+D;IAC/D,CAAC,EAAE,IAAI,CAAC;IACR,+DAA+D;IAC/D,CAAC,EAAE,IAAI,CAAC;IACR,0DAA0D;IAC1D,CAAC,EAAE,IAAI,CAAC;IACR,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAsB,UAAU,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC,CA6GlF;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,WAAW,CACzB,IAAI,EAAE,cAAc,EACpB,IAAI,CAAC,EAAE,WAAW,GACjB,MAAM,CAAC,GAAG,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC,CAuChC"}