@faicad/faijs 0.16.1 → 0.17.0

package/dist/api/brepjs-compat/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/api/brepjs-compat/index.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * BREP-TS compatibility surface (P21).\n *\n * Projects the vendored BREP TS tree onto four stable groups so library authors\n * can write `import { box, fuse, Sketcher, ok } from this module` and call it\n * upstream-style:\n *\n *   ① op        — solid primitives + boolean / evolution operations\n *   ② topology  — sub-shape queries + measurements (plus the Bounds3D type)\n *   ③ sketching — stateful Sketcher / FaceSketcher DSL + drawing factories\n *   ④ combinators / types — result, vector, plane, errors, constants, types\n *\n * Every symbol is a projection (re-export or a thin dual-form wrapper) from the\n * ported tree: no reimplementation. The `.js` specifiers are the repo\n * convention (TypeScript maps `.js` → `.ts`).\n *\n * Semantic wraps (P23: both live in `api/internal/compat-projection.ts` so the\n * generated face and this hand-curated face share one mechanism):\n * - single-kernel assert: every modeling op asserts a bound BREP kernel first\n *   (see `assertKernelBound`); `getBackends()` may throw before configuration,\n *   so it is guarded and falls back to the occt-kernel binding flag.\n * - dual argument forms: object form normalizes to positional form via the\n *   shared `resolveArgs` discriminant; object keys outside the declared\n *   parameter table throw the shared `E_ARGS_FORM` token.\n * - `box` is the hand-written dual-form sample: positional\n *   `box(width, depth, height)` and `box({ size })` / `box({ width, depth,\n *   height })` both forward to the vendored primitive in its native dimension\n *   order (width = X, depth = Y, height = Z — confirm against\n *   `primitiveFns#box`), so every accepted form yields identical geometry.\n */\n\nimport { assertKernelBound, projectBrepOp } from '../internal/compat-projection'\nimport { isObjectForm } from '../internal/dual-form-args'\n\nimport type { ValidSolid } from '../../vendored/brepjs/core/shapeTypes.js'\n\n/** Signature of a compat op projection (inputs normalized before the call). */\ntype CompatOp = (...args: unknown[]) => unknown\n\n/**\n * Dual-form op wrapper (A-class): asserts the kernel, normalizes object form to\n * positional form via `resolveArgs`, then delegates to the vendored\n * implementation.\n *\n * P23: delegates to the shared {@link projectBrepOp} so the hand-curated face\n * and the generated face share one projection mechanism (§4.3.2).\n */\nfunction wrapDual<R>(\n  name: string,\n  params: string[],\n  impl: (...args: unknown[]) => R\n): CompatOp {\n  return projectBrepOp(name, params, 'A', impl as (...args: never[]) => unknown)\n}\n\n/**\n * Guard-only wrapper: forwards the arguments unchanged after the kernel assert.\n * Used for positional-first ops (booleans, evolutions) whose first argument is\n * a shape, so the object-form discriminant never applies. The exact function\n * type `F` (including its parameter and Result types) is preserved.\n */\nfunction wrapGuarded<F>(name: string, impl: F): F {\n  const fn: (...args: unknown[]) => unknown = (...args: unknown[]) => {\n    assertKernelBound(name)\n    return (impl as (...args: unknown[]) => unknown)(...args)\n  }\n  return fn as unknown as F\n}\n\n// ─────────────────────────────────────────────────────────────────────────────\n// ① primitives + booleans + evolutions\n// ─────────────────────────────────────────────────────────────────────────────\n\nimport {\n  box as primitiveBox,\n  sphere as primitiveSphere,\n  cylinder as primitiveCylinder,\n  cone as primitiveCone,\n  torus as primitiveTorus,\n  ellipsoid as primitiveEllipsoid,\n} from '../../vendored/brepjs/topology/primitiveFns.js'\n\n/**\n * Create a solid box.\n *\n * Positional form `box(width, depth, height)` uses the vendor's native\n * dimension order — X = width, Y = depth,\n * Z = height (the vendored `primitiveFns#box` dimension order; width/height are\n * NOT swapped). See the overload below for the object form.\n *\n * @param width - side length along X.\n * @param depth - side length along Y.\n * @param height - side length along Z.\n * @returns a new valid solid box.\n */\nexport function box(width: number, depth: number, height: number): ValidSolid\n/**\n * Create a solid box from an object form.\n *\n * Accepts `box({ size })` where `size` is a number (cube) or a\n * `[width, depth, height]` triple, or `box({ width, depth, height })`. Every\n * accepted form forwards to `primitiveBox(width, depth, height)`, so equal\n * dimension values always produce identical geometry.\n *\n * @param options - the dimension set: `size` (a cube edge or a triple) or\n * `width`/`depth`/`height` sides.\n * @returns a new valid solid box.\n * @throws An `Error` whose message contains the shared `E_ARGS_FORM` token when\n * no form matches (e.g. `box('x')`, `box()`, or unknown object keys).\n */\nexport function box(options: BoxDimensions): ValidSolid\nexport function box(...args: unknown[]): ValidSolid {\n  assertKernelBound('box')\n  if (isObjectForm(args)) {\n    const obj = args[0] as Record<string, unknown>\n    const keys = Object.keys(obj)\n    const unknownKeys = keys.filter((k) => !['size', 'width', 'depth', 'height'].includes(k))\n    if (unknownKeys.length > 0) throw boxArgError(args)\n    const size = obj.size\n    if (size !== undefined) {\n      if (typeof size === 'number') return primitiveBox(size, size, size)\n      if (Array.isArray(size) && size.length === 3) {\n        const [w, d, h] = size as [number, number, number]\n        return primitiveBox(w, d, h)\n      }\n      throw boxArgError(args)\n    }\n    const width = obj.width\n    const depth = obj.depth\n    const height = obj.height\n    if (typeof width === 'number' && typeof depth === 'number' && typeof height === 'number') {\n      return primitiveBox(width, depth, height)\n    }\n    throw boxArgError(args)\n  }\n  if (args.length === 3 && args.every((a) => typeof a === 'number')) {\n    const [w, d, h] = args as [number, number, number]\n    return primitiveBox(w, d, h)\n  }\n  throw boxArgError(args)\n}\n\n/** Object-form input accepted by {@link box}. */\nexport interface BoxDimensions {\n  /** All three sides as one number (cube) or a `[width, depth, height]` triple. */\n  size?: number | [number, number, number]\n  /** Side length along X. */\n  width?: number\n  /** Side length along Y. */\n  depth?: number\n  /** Side length along Z. */\n  height?: number\n}\n\n/** Shared E_ARGS_FORM error for {@link box} argument mismatches. */\nfunction boxArgError(args: unknown[]): Error {\n  return new Error(\n    '[compat:box] E_ARGS_FORM: expected box(width, depth, height), ' +\n      \"box({ size: number | [w, d, h] }) or box({ width, depth, height }); got \" +\n      args.map((a) => safeJson(a)).join(', ')\n  )\n}\n\n/** JSON stringification that never throws on cyclic or exotic values. */\nfunction safeJson(v: unknown): string {\n  try {\n    return JSON.stringify(v) ?? String(v)\n  } catch {\n    return '[unserializable]'\n  }\n}\n\n/**\n * Project the vendored `sphere(radius, options?)` verbatim (P25: the raw\n * morph form is what portable libraries call — upstream brepjs signatures,\n * no op projection).\n */\nexport { primitiveSphere as sphere }\n/** Project the vendored `cylinder(radius, height, options?)` verbatim. */\nexport { primitiveCylinder as cylinder }\n/** Project the vendored `cone(bottomRadius, topRadius, height, options?)`. */\nexport const cone = wrapDual(\n  'cone',\n  ['bottomRadius', 'topRadius', 'height'],\n  primitiveCone as CompatOp\n)\n/** Project the vendored `torus(majorRadius, minorRadius, options?)`. */\nexport const torus = wrapDual('torus', ['majorRadius', 'minorRadius'], primitiveTorus as CompatOp)\n/** Project the vendored `ellipsoid(rx, ry, rz, options?)`. */\nexport const ellipsoid = wrapDual('ellipsoid', ['rx', 'ry', 'rz'], primitiveEllipsoid as CompatOp)\n\nimport {\n  fuse as vendoredFuse,\n  cut as vendoredCut,\n  intersect as vendoredIntersect,\n  fillet as vendoredFillet,\n  chamfer as vendoredChamfer,\n  simplify as vendoredSimplify,\n} from '../../vendored/brepjs/topology/api.js'\nimport {\n  makeCompound as vendoredMakeCompound,\n  makeVertex as vendoredMakeVertex,\n} from '../../vendored/brepjs/topology/solidBuilders.js'\nimport { applyMatrix as vendoredApplyMatrix } from '../../vendored/brepjs/topology/transformFns.js'\nimport {\n  makeCircle as vendoredMakeCircle,\n  makeEllipse as vendoredMakeEllipse,\n  makeLine as vendoredMakeLine,\n  makeThreePointArc as vendoredMakeThreePointArc,\n  makeTangentArc as vendoredMakeTangentArc,\n  makeBSplineInterpolation as vendoredMakeBSplineInterpolation,\n  assembleWire as vendoredAssembleWire,\n} from '../../vendored/brepjs/topology/curveBuilders.js'\nimport {\n  curveTangentAt as vendoredCurveTangentAt,\n  curvePointAt as vendoredCurvePointAt,\n} from '../../vendored/brepjs/topology/curveFns.js'\nimport {\n  makeFace as vendoredMakeFace,\n  addHolesInFace as vendoredAddHolesInFace,\n} from '../../vendored/brepjs/topology/surfaceBuilders.js'\nimport {\n  extrude as vendoredExtrude,\n  revolve as vendoredRevolve,\n  loft as vendoredLoft,\n} from '../../vendored/brepjs/operations/api.js'\n\n/** Fuse two shapeables into one 3D result. */\nexport const fuse = wrapGuarded('fuse', vendoredFuse)\n/** Cut the second shapeable out of the first. */\nexport const cut = wrapGuarded('cut', vendoredCut)\n/** Extrude a planar profile along a height or direction vector. */\nexport const extrude = wrapGuarded('extrude', vendoredExtrude)\n/** Revolve a planar profile around an axis with optional angle. */\nexport const revolve = wrapGuarded('revolve', vendoredRevolve)\n/** Loft through a set of wire profiles. */\nexport const loft = wrapGuarded('loft', vendoredLoft)\n\n/** Intersect two shapeables (common 3D volume). */\nexport const intersect = wrapGuarded('intersect', vendoredIntersect)\n\n/**\n * Fillet all edges (2-arg form) or selected edges (3-arg form: edge array /\n * finder) of a valid solid. Selection form:\n * `fillet(shape, edgeHandles, radius)`.\n */\nexport const fillet = wrapGuarded('fillet', vendoredFillet)\n\n/**\n * Chamfer all edges (2-arg form) or selected edges (3-arg form) of a valid\n * solid. Selection form: `chamfer(shape, edgeHandles, distance)` where\n * distance is a symmetric length or an asymmetric `[d1, d2]` pair.\n */\nexport const chamfer = wrapGuarded('chamfer', vendoredChamfer)\n\n/**\n * Group shapes into a single Compound: `makeCompound(shapeArray)` (the\n * analogue of CadQuery's multi-solid compounds).\n */\nexport const makeCompound = wrapGuarded('makeCompound', vendoredMakeCompound)\n/** Single vertex at a point: `makeVertex([x, y, z])` (upstream `vertex(x, y, z)`). */\nexport const makeVertex = wrapGuarded('makeVertex', vendoredMakeVertex)\n\n/**\n * Apply a rigid affine transform to ANY shape — including compounds, which the\n * faijs `cad.translate` / `cad.rotate_euler` ops reject (\"input is not BREP\",\n * they require a solid). Needed by CadQuery's `Shape.moved(*locs)`, which can\n * move a multi-solid compound as a whole.\n *\n * Accepts the `{ linear, translation }` form of `MatrixInput`: `linear` is the\n * row-major 3x3 rotation, `translation` is applied after it (p -> R·p + t).\n */\nexport const applyMatrix = wrapGuarded('applyMatrix', vendoredApplyMatrix)\n\n/**\n * Merge same-domain faces/edges (unifySameDomain) — the analogue of\n * CadQuery's `clean=True` boolean post-processing.\n */\nexport const simplify = wrapGuarded('simplify', vendoredSimplify)\n\n// ── 2D profile construction (CadQuery pending-wire parity) ────────────────\n// Circles/lines → edges → wires → (holed) faces. These are the building blocks\n// CadQuery uses for its `pendingWires` stack: an outer wire plus zero or more\n// inner wires becomes ONE face with holes, which is then extruded. Without\n// `makeFace(wire, holes)` a nested `circle(4).circle(2)` would have to be\n// approximated by a boolean difference and would not match upstream topology.\n\n/** Circular edge: `makeCircle(radius, center?, normal?)` — closed, planar. */\nexport const makeCircle = wrapGuarded('makeCircle', vendoredMakeCircle)\n/** Elliptical edge: `makeEllipseEdge(majorRadius, minorRadius, center?, normal?, xDir?)`. Returns a `Result`. */\nexport const makeEllipseEdge = wrapGuarded('makeEllipseEdge', vendoredMakeEllipse)\n/** Straight edge from `v1` to `v2`. */\nexport const makeLine = wrapGuarded('makeLine', vendoredMakeLine)\n/** Assemble edges/wires into a single connected wire. Returns a `Result`. */\nexport const assembleWire = wrapGuarded('assembleWire', vendoredAssembleWire)\n/** Planar face from a closed wire, optionally with hole wires. Returns a `Result`. */\nexport const makeFace = wrapGuarded('makeFace', vendoredMakeFace)\n/** Punch hole wires into an existing face. */\nexport const addHolesInFace = wrapGuarded('addHolesInFace', vendoredAddHolesInFace)\n/** Circular arc edge through three points (start, mid, end). */\nexport const makeThreePointArc = wrapGuarded('makeThreePointArc', vendoredMakeThreePointArc)\n/** Circular arc edge from a start point + start tangent to an end point. */\nexport const makeTangentArc = wrapGuarded('makeTangentArc', vendoredMakeTangentArc)\n/** Interpolated cubic B-spline edge through every input point. Returns a `Result`. */\nexport const makeBSplineInterpolation = wrapGuarded('makeBSplineInterpolation', vendoredMakeBSplineInterpolation)\n/** Tangent vector of an edge/wire curve at a normalized position (1 = end). */\nexport const curveTangentAt = wrapGuarded('curveTangentAt', vendoredCurveTangentAt)\n/** Point on an edge/wire curve at a normalized position. */\nexport const curvePointAt = wrapGuarded('curvePointAt', vendoredCurvePointAt)\n\n// ─────────────────────────────────────────────────────────────────────────────\n// ①b library-building factories (P24, §8.1): spur gears, planetary trains, threads.\n// Both morphs of these factories are brep-only builders gated by the single-kernel\n// assert (wrapGuarded); the kernel is bound at the host boundary (D10).\n// ─────────────────────────────────────────────────────────────────────────────\n\nimport {\n  makeExternalGear as vendoredMakeExternalGear,\n  makeInternalGear as vendoredMakeInternalGear,\n  makePlanetaryGear as vendoredMakePlanetaryGear,\n} from '../../vendored/brepjs/gear/gearFns.js'\nimport { thread as vendoredThread } from '../../vendored/brepjs/operations/threadFns.js'\n\n/**\n * Build an external spur gear.\n * @param params - the external-gear parameters (`teeth`, `moduleSize`, `thickness`, …).\n * @returns `Ok` with the gear solid + geometry, or `Err` for invalid parameters.\n */\nexport const makeExternalGear = wrapGuarded('makeExternalGear', vendoredMakeExternalGear)\n/**\n * Build an internal (ring) spur gear.\n * @param params - the internal-gear parameters, including the optional ring wall thickness.\n * @returns `Ok` with the gear solid + geometry, or `Err` for invalid parameters.\n */\nexport const makeInternalGear = wrapGuarded('makeInternalGear', vendoredMakeInternalGear)\n/**\n * Build a planetary gear train (sun + planets + ring).\n * @param params - the planetary-gear parameters.\n * @returns `Ok` with the sun/planet/ring solids and mesh diagnostics, or `Err`.\n */\nexport const makePlanetaryGear = wrapGuarded('makePlanetaryGear', vendoredMakePlanetaryGear)\n/**\n * Build a helical screw-thread ridge.\n * @param options - the thread profile (`radius`, `pitch`, `height`, …).\n * @returns `Ok` with the thread-ridge solid, or `Err` for invalid parameters.\n */\nexport const thread = wrapGuarded('thread', vendoredThread)\n\nexport type {\n  ExternalGearParams,\n  InternalGearParams,\n  PlanetaryGearParams,\n  GearResult,\n  PlanetaryGearAssembly,\n} from '../../vendored/brepjs/gear/gearFns.js'\nexport type { ThreadOptions } from '../../vendored/brepjs/operations/threadFns.js'\n\n// ─────────────────────────────────────────────────────────────────────────────\n// ② sub-shape queries + measurements\n// ─────────────────────────────────────────────────────────────────────────────\n\nexport {\n  getEdges,\n  getFaces,\n  getWires,\n  getVertices,\n  getShells,\n  getSolids,\n  getCompSolids,\n  getBounds,\n  vertexPosition,\n} from '../../vendored/brepjs/topology/topologyQueryFns.js'\n\nexport type { Bounds3D } from '../../vendored/brepjs/topology/topologyQueryFns.js'\n\nexport {\n  measureVolume,\n  measureArea,\n  measureLength,\n} from '../../vendored/brepjs/measurement/measureFns.js'\n\n// ─────────────────────────────────────────────────────────────────────────────\n// ③ sketching DSL + drawing factories\n// ─────────────────────────────────────────────────────────────────────────────\n\nexport { default as Sketcher } from '../../vendored/brepjs/sketching/sketcher.js'\nexport { default as FaceSketcher } from '../../vendored/brepjs/sketching/faceSketcher.js'\n\nexport {\n  drawCircle,\n  drawEllipse,\n  drawRoundedRectangle,\n  drawRectangle,\n  drawSingleCircle,\n  drawSingleEllipse,\n  drawPolysides,\n  drawText,\n} from '../../vendored/brepjs/sketching/drawingFactories.js'\n\nexport { draw } from '../../vendored/brepjs/sketching/drawingPen.js'\nexport { makeBaseBox } from '../../vendored/brepjs/sketching/shortcuts.js'\n\n// ─────────────────────────────────────────────────────────────────────────────\n// ④ combinators / pure helpers / types\n// ─────────────────────────────────────────────────────────────────────────────\n\nexport {\n  ok,\n  err,\n  isOk,\n  isErr,\n  unwrap,\n  unwrapOr,\n  map,\n  andThen,\n} from '../../vendored/brepjs/core/result.js'\nexport type { Result, Ok, Err } from '../../vendored/brepjs/core/result.js'\n\nexport {\n  vecAdd,\n  vecSub,\n  vecScale,\n  vecDot,\n  vecCross,\n  vecLength,\n  vecNormalize,\n} from '../../vendored/brepjs/core/vecOps.js'\n\nexport {\n  createPlane,\n  createNamedPlane,\n  resolvePlane,\n} from '../../vendored/brepjs/core/planeOps.js'\n\nexport { kernelError, validationError } from '../../vendored/brepjs/core/errors.js'\nexport type { BrepError } from '../../vendored/brepjs/core/errors.js'\n\nexport { DEG2RAD, RAD2DEG } from '../../vendored/brepjs/core/constants.js'\n\nexport type {\n  Vertex,\n  Edge,\n  Wire,\n  Face,\n  Shell,\n  Solid,\n  CompSolid,\n  Shape3D,\n  ValidSolid,\n  ClosedWire,\n  AnyShape,\n} from '../../vendored/brepjs/core/shapeTypes.js'\n\nexport type { GearGeometry } from '../../vendored/brepjs/gear/gearMath.js'\n\nexport type { Plane, PlaneName, PlaneInput } from '../../vendored/brepjs/core/planeTypes.js'\n\nexport type { Vec3, PointInput } from '../../vendored/brepjs/core/types.js'\n\n// ─────────────────────────────────────────────────────────────────────────────\n// ⑤ raw 2D-morph + transform + face ports (P25: sheetmetal 单一说明符面)\n//\n// The sheetmetal authoring path consumes the vendored morph semantics exactly\n// (handles in, handles out, `Result` only where the vendored chain returns\n// one). These are projected verbatim from the ported tree — same names, same\n// signatures as upstream brepjs — so portable library sources only change the\n// import specifier line (§8.2).\n// ─────────────────────────────────────────────────────────────────────────────\n\nimport {\n  line as rawLine,\n  wire as rawWire,\n  wireLoop as rawWireLoop,\n  face as rawFace,\n  polygon as rawPolygon,\n} from '../../vendored/brepjs/topology/primitiveFns.js'\nimport {\n  outerWire as rawOuterWire,\n  getSurfaceType as rawSurfaceType,\n  pointOnSurface as rawPointOnSurface,\n  normalAt as rawNormalAt,\n  faceCenter as rawFaceCenter,\n} from '../../vendored/brepjs/topology/faceFns.js'\nimport { sharedEdges as rawSharedEdges } from '../../vendored/brepjs/topology/adjacencyFns.js'\nimport {\n  curveStartPoint as rawCurveStartPoint,\n  curveEndPoint as rawCurveEndPoint,\n} from '../../vendored/brepjs/topology/curveFns.js'\nimport { translate as rawTranslate } from '../../vendored/brepjs/topology/transformFns.js'\nimport { rotate as rawRotate } from '../../vendored/brepjs/topology/transformFns.js'\nimport { isSolid as rawIsSolid } from '../../vendored/brepjs/core/shapeTypes.js'\nimport { isPlanarWire as rawIsPlanarWire } from '../../vendored/brepjs/core/validityTypes.js'\nimport { isValid as rawIsValid } from '../../vendored/brepjs/topology/healingFns.js'\nimport type { AnyShape } from '../../vendored/brepjs/core/shapeTypes.js'\nimport type { Vec3 } from '../../vendored/brepjs/core/types.js'\n\nexport {\n  rawLine as line,\n  rawWire as wire,\n  rawWireLoop as wireLoop,\n  rawFace as face,\n  rawPolygon as polygon,\n  rawOuterWire as outerWire,\n  rawSurfaceType as getSurfaceType,\n  rawPointOnSurface as pointOnSurface,\n  rawNormalAt as normalAt,\n  rawFaceCenter as faceCenter,\n  rawSharedEdges as sharedEdges,\n  rawCurveStartPoint as curveStartPoint,\n  rawCurveEndPoint as curveEndPoint,\n  rawTranslate as translate,\n  rawIsSolid as isSolid,\n  rawIsPlanarWire as isPlanarWire,\n  rawIsValid as isValid,\n}\n\n// Upstream brepjs 18's `rotate` takes an axis through an `{ at, axis }` options\n// object; the vendored tree (P5-locked commit) is the four-argument positional\n// form. Export the upstream-aligned wrap so library code written for brepjs\n// rotates with `rotate(shape, angle, { at?, axis? })`.\n/**\n * Rotate a shape by an angle in degrees around an axis.\n * @param shape - The shape to rotate.\n * @param angle - Rotation angle in degrees.\n * @param options - Axis and pivot (`at`) for the rotation; defaults to the Z\n * axis through the origin, matching upstream brepjs.\n * @returns A new rotated shape.\n */\nexport function rotate<T extends AnyShape>(\n  shape: T,\n  angle: number,\n  options: { at?: Vec3; axis?: Vec3 } = {}\n): T {\n  return rawRotate(shape, angle, options.at ?? [0, 0, 0], options.axis ?? [0, 0, 1]);\n}"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/api/brepjs-compat/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,gFAAgF;AAChF,uEAAuE;AACvE,kDAAkD;AAClD,gEAAgE;AAChE,gFAAgF;AAEhF,OAAO,EACL,EAAE,EACF,GAAG,EACH,IAAI,EACJ,KAAK,EACL,MAAM,EACN,QAAQ,EACR,GAAG,EACH,OAAO,GACR,MAAM,qBAAqB,CAAA;AAG5B,OAAO,EACL,MAAM,EACN,MAAM,EACN,QAAQ,EACR,MAAM,EACN,QAAQ,EACR,SAAS,EACT,YAAY,GACb,MAAM,UAAU,CAAA;AAEjB,OAAO,EACL,WAAW,EACX,gBAAgB,EAChB,YAAY,GACb,MAAM,YAAY,CAAA;AAEnB,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAA;AAGlE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAA","sourcesContent":["/**\n * BREP-TS compatibility surface (P21) — 2026-09-25 core-decouple rewrite.\n *\n * The vendored BREP TS tree (packages/brepjs) is deleted (裁决 9). Every\n * op projection (primitives / booleans / evolutions / topology queries /\n * sketching DSL / raw 2D-morph ports) is gone with it — those symbols have no\n * receiver (裁决 1). What remains in this module is the ④ group only: the pure\n * combinators / types inlined into core (§5.2) — Result, vectors, planes,\n * errors, constants — which stay flat-exported from the core facade for\n * library authors (import { ok, vecAdd } from '@faicad/faijs').\n */\n\n// ─────────────────────────────────────────────────────────────────────────────\n// ④ combinators / pure helpers / types（2026-09-25 core-decouple：op 投影面\n// ① ② ③ ⑤ 已随 vendored 树删除；④ 全部为 core 内联实现，保留为本文件的\n// 唯一内容。vendored 句柄类型（Vertex/Edge/…/Shape3D/ValidSolid）随裁决 9 删除）\n// ─────────────────────────────────────────────────────────────────────────────\n\nexport {\n  ok,\n  err,\n  isOk,\n  isErr,\n  unwrap,\n  unwrapOr,\n  map,\n  andThen,\n} from '../../result/result'\nexport type { Result, Ok, Err } from '../../result/result'\n\nexport {\n  vecAdd,\n  vecSub,\n  vecScale,\n  vecDot,\n  vecCross,\n  vecLength,\n  vecNormalize,\n} from './vecOps'\n\nexport {\n  createPlane,\n  createNamedPlane,\n  resolvePlane,\n} from './planeOps'\n\nexport { kernelError, validationError } from '../../result/errors'\nexport type { BrepError } from '../../result/errors'\n\nexport { DEG2RAD, RAD2DEG } from './constants'\n\nexport type { Plane, PlaneName, PlaneInput } from './planeTypes'\n\nexport type { Vec3, PointInput } from './types'\n"]}

package/dist/api/brepjs-compat/planeOps.d.ts

@@ -0,0 +1,98 @@
+/**
+ * Pure plane operations — replaces the old Plane class methods.
+ *
+ * 第一方模块（2026-09-25 core-decouple Phase 1）：复制自 brepjs
+ * `src/core/planeOps.ts`（同源复制，签名不变）；import 来源改为 compat 面
+ * 第一方模块与 `result/` 第一方模块。
+ */
+import type { Vec3, Vec2, PointInput } from './types.js';
+import type { Plane, PlaneName, PlaneInput } from './planeTypes.js';
+import { type Result } from '../../result/result.js';
+/**
+ * Create a {@link Plane} from an origin, optional X direction, and a normal.
+ *
+ * If `xDirection` is omitted, the X axis is derived automatically via kernel `gp_Ax3`.
+ *
+ * @param origin - Origin point of the plane.
+ * @param xDirection - Explicit X axis direction, or `null` to auto-derive.
+ * @param normal - Plane normal (Z direction).
+ * @returns The created plane.
+ * @throws If the normal or derived xDir is zero-length.
+ */
+export declare function createPlane(origin: Vec3, xDirection?: Vec3 | null, normal?: Vec3): Plane;
+/**
+ * Create a standard named plane with an optional origin offset.
+ *
+ * @param name - One of the predefined {@link PlaneName} values.
+ * @param sourceOrigin - Origin point, or a scalar offset along the plane normal.
+ * @returns `Ok<Plane>` on success, or `Err` if the name is unknown.
+ */
+export declare function createNamedPlane(name: PlaneName, sourceOrigin?: PointInput | number): Result<Plane>;
+/**
+ * Resolve a {@link PlaneInput} to a concrete {@link Plane}.
+ *
+ * @param input - Plane input to resolve (a named plane or a `Plane` object).
+ * @param origin - Optional origin point or scalar offset along the plane normal.
+ * @returns `Ok<Plane>` on success, or `Err` if the named plane cannot be resolved.
+ */
+export declare function resolvePlane(input: PlaneInput, origin?: PointInput | number): Result<Plane>;
+/**
+ * Create or copy a {@link Plane}.
+ *
+ * When called with a `Plane` object, returns a shallow copy.
+ * When called with a `PlaneName` string (or no arguments), resolves the named
+ * plane with an optional origin offset.
+ *
+ * @param plane - A `Plane` object to copy, or a `PlaneName` string to resolve.
+ * @param origin - Origin point or scalar offset along the plane normal.
+ * @returns The copied or resolved plane.
+ * @default plane `'XY'`
+ */
+/**
+ * Copy a {@link Plane} object.
+ *
+ * @param plane - The `Plane` object to copy.
+ * @returns A shallow copy of the plane.
+ */
+declare function makePlane(plane: Plane): Plane;
+/**
+ * Resolve a named plane with an optional origin offset.
+ *
+ * @param plane - The {@link PlaneName} to resolve (defaults to `'XY'`).
+ * @param origin - Origin point or scalar offset along the plane normal.
+ * @returns The resolved plane.
+ */
+declare function makePlane(plane?: PlaneName, origin?: PointInput | number): Plane;
+export { makePlane };
+/** Convert 2D local coordinates to 3D world coordinates on the plane.
+ *
+ * @param plane - Plane defining the local coordinate system.
+ * @param local - 2D local coordinates.
+ * @returns The corresponding 3D world point.
+ */
+export declare function planeToWorld(plane: Plane, local: Vec2): Vec3;
+/**
+ * Convert 3D world coordinates to 2D local coordinates on the plane.
+ *
+ * @param plane - Plane defining the local coordinate system.
+ * @param world - 3D world point.
+ * @returns The corresponding 2D local coordinates.
+ */
+export declare function planeToLocal(plane: Plane, world: Vec3): Vec2;
+/** Translate a plane by a vector.
+ *
+ * @param plane - Plane to translate.
+ * @param offset - Translation vector.
+ * @returns The translated plane.
+ */
+export declare function translatePlane(plane: Plane, offset: Vec3): Plane;
+/**
+ * Pivot a plane by rotating its axes around a world-space axis.
+ *
+ * @param angleDeg - Rotation angle in **degrees**.
+ * @param axis - World-space axis to rotate around.
+ * @param plane - Plane to pivot.
+ * @returns The pivoted plane.
+ */
+export declare function pivotPlane(plane: Plane, angleDeg: number, axis?: Vec3): Plane;
+//# sourceMappingURL=planeOps.d.ts.map

package/dist/api/brepjs-compat/planeOps.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"planeOps.d.ts","sourceRoot":"","sources":["../../../src/api/brepjs-compat/planeOps.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAEtD,OAAO,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAYjE,OAAO,EAAE,KAAK,MAAM,EAAmB,MAAM,qBAAqB,CAAC;AAOnE;;;;;;;;;;GAUG;AACH,wBAAgB,WAAW,CACzB,MAAM,EAAE,IAAI,EACZ,UAAU,GAAE,IAAI,GAAG,IAAW,EAC9B,MAAM,GAAE,IAAgB,GACvB,KAAK,CA+BP;AAqBD;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,SAAS,EACf,YAAY,GAAE,UAAU,GAAG,MAAkB,GAC5C,MAAM,CAAC,KAAK,CAAC,CAWf;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,UAAU,EAAE,MAAM,CAAC,EAAE,UAAU,GAAG,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,CAK3F;AAMD;;;;;;;;;;;GAWG;AACH;;;;;GAKG;AACH,iBAAS,SAAS,CAAC,KAAK,EAAE,KAAK,GAAG,KAAK,CAAC;AACxC;;;;;;GAMG;AACH,iBAAS,SAAS,CAAC,KAAK,CAAC,EAAE,SAAS,EAAE,MAAM,CAAC,EAAE,UAAU,GAAG,MAAM,GAAG,KAAK,CAAC;AAU3E,OAAO,EAAE,SAAS,EAAE,CAAC;AAMrB;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,GAAG,IAAI,CAG5D;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,GAAG,IAAI,CAG5D;AAMD;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,GAAG,KAAK,CAEhE;AAED;;;;;;;GAOG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,GAAE,IAAgB,GAAG,KAAK,CAMxF"}

package/dist/api/brepjs-compat/planeOps.js

@@ -0,0 +1,170 @@
+/**
+ * Pure plane operations — replaces the old Plane class methods.
+ *
+ * 第一方模块（2026-09-25 core-decouple Phase 1）：复制自 brepjs
+ * `src/core/planeOps.ts`（同源复制，签名不变）；import 来源改为 compat 面
+ * 第一方模块与 `result/` 第一方模块。
+ */
+import { toVec3 } from './types.js';
+import { vecAdd, vecSub, vecScale, vecDot, vecCross, vecNormalize, vecIsZero, vecRotate, } from './vecOps.js';
+import { DEG2RAD } from './constants.js';
+import { ok, err, unwrap } from '../../result/result.js';
+import { validationError } from '../../result/errors.js';
+// ---------------------------------------------------------------------------
+// Plane construction
+// ---------------------------------------------------------------------------
+/**
+ * Create a {@link Plane} from an origin, optional X direction, and a normal.
+ *
+ * If `xDirection` is omitted, the X axis is derived automatically via kernel `gp_Ax3`.
+ *
+ * @param origin - Origin point of the plane.
+ * @param xDirection - Explicit X axis direction, or `null` to auto-derive.
+ * @param normal - Plane normal (Z direction).
+ * @returns The created plane.
+ * @throws If the normal or derived xDir is zero-length.
+ */
+export function createPlane(origin, xDirection = null, normal = [0, 0, 1]) {
+    const zDir = vecNormalize(normal);
+    if (vecIsZero(zDir))
+        throw new Error('Plane normal must be non-zero');
+    let xDir;
+    if (!xDirection) {
+        // Derive xDir perpendicular to zDir (same algorithm as kernel gp_Ax3)
+        const [nx, ny, nz] = zDir;
+        const absX = Math.abs(nx), absY = Math.abs(ny), absZ = Math.abs(nz);
+        // Pick the axis least aligned with zDir to cross-product with
+        let candidate;
+        if (absX <= absY && absX <= absZ)
+            candidate = [1, 0, 0];
+        else if (absY <= absZ)
+            candidate = [0, 1, 0];
+        else
+            candidate = [0, 0, 1];
+        // xDir = normalize(candidate × zDir)
+        const cx = candidate[1] * nz - candidate[2] * ny;
+        const cy = candidate[2] * nx - candidate[0] * nz;
+        const cz = candidate[0] * ny - candidate[1] * nx;
+        const len = Math.sqrt(cx * cx + cy * cy + cz * cz);
+        xDir = len > 1e-12 ? vecNormalize([cx, cy, cz]) : [1, 0, 0];
+    }
+    else {
+        xDir = vecNormalize(xDirection);
+    }
+    if (vecIsZero(xDir))
+        throw new Error('Plane xDir must be non-zero');
+    const yDir = vecNormalize(vecCross(zDir, xDir));
+    return { origin, xDir, yDir, zDir };
+}
+// ---------------------------------------------------------------------------
+// Named plane configs
+// ---------------------------------------------------------------------------
+const PLANES_CONFIG = {
+    XY: { xDir: [1, 0, 0], normal: [0, 0, 1] },
+    YZ: { xDir: [0, 1, 0], normal: [1, 0, 0] },
+    ZX: { xDir: [0, 0, 1], normal: [0, 1, 0] },
+    XZ: { xDir: [1, 0, 0], normal: [0, -1, 0] },
+    YX: { xDir: [0, 1, 0], normal: [0, 0, -1] },
+    ZY: { xDir: [0, 0, 1], normal: [-1, 0, 0] },
+    front: { xDir: [1, 0, 0], normal: [0, 0, 1] },
+    back: { xDir: [-1, 0, 0], normal: [0, 0, -1] },
+    left: { xDir: [0, 0, 1], normal: [-1, 0, 0] },
+    right: { xDir: [0, 0, -1], normal: [1, 0, 0] },
+    top: { xDir: [1, 0, 0], normal: [0, 1, 0] },
+    bottom: { xDir: [1, 0, 0], normal: [0, -1, 0] },
+};
+/**
+ * Create a standard named plane with an optional origin offset.
+ *
+ * @param name - One of the predefined {@link PlaneName} values.
+ * @param sourceOrigin - Origin point, or a scalar offset along the plane normal.
+ * @returns `Ok<Plane>` on success, or `Err` if the name is unknown.
+ */
+export function createNamedPlane(name, sourceOrigin = [0, 0, 0]) {
+    const config = PLANES_CONFIG[name];
+    if (!config)
+        return err(validationError('UNKNOWN_PLANE', `Could not find plane ${name}`));
+    let origin;
+    if (typeof sourceOrigin === 'number') {
+        origin = vecScale(config.normal, sourceOrigin);
+    }
+    else {
+        origin = toVec3(sourceOrigin);
+    }
+    return ok(createPlane(origin, config.xDir, config.normal));
+}
+/**
+ * Resolve a {@link PlaneInput} to a concrete {@link Plane}.
+ *
+ * @param input - Plane input to resolve (a named plane or a `Plane` object).
+ * @param origin - Optional origin point or scalar offset along the plane normal.
+ * @returns `Ok<Plane>` on success, or `Err` if the named plane cannot be resolved.
+ */
+export function resolvePlane(input, origin) {
+    if (typeof input === 'string') {
+        return createNamedPlane(input, origin);
+    }
+    return ok(input);
+}
+function makePlane(plane, origin) {
+    if (plane && typeof plane !== 'string') {
+        // Already a Plane object - return a copy
+        return { ...plane };
+    }
+    else {
+        return unwrap(resolvePlane(plane ?? 'XY', origin));
+    }
+}
+export { makePlane };
+// ---------------------------------------------------------------------------
+// Coordinate transforms
+// ---------------------------------------------------------------------------
+/** Convert 2D local coordinates to 3D world coordinates on the plane.
+ *
+ * @param plane - Plane defining the local coordinate system.
+ * @param local - 2D local coordinates.
+ * @returns The corresponding 3D world point.
+ */
+export function planeToWorld(plane, local) {
+    const [u, v] = local;
+    return vecAdd(vecAdd(plane.origin, vecScale(plane.xDir, u)), vecScale(plane.yDir, v));
+}
+/**
+ * Convert 3D world coordinates to 2D local coordinates on the plane.
+ *
+ * @param plane - Plane defining the local coordinate system.
+ * @param world - 3D world point.
+ * @returns The corresponding 2D local coordinates.
+ */
+export function planeToLocal(plane, world) {
+    const relative = vecSub(world, plane.origin);
+    return [vecDot(relative, plane.xDir), vecDot(relative, plane.yDir)];
+}
+// ---------------------------------------------------------------------------
+// Plane transformations (all return new Plane)
+// ---------------------------------------------------------------------------
+/** Translate a plane by a vector.
+ *
+ * @param plane - Plane to translate.
+ * @param offset - Translation vector.
+ * @returns The translated plane.
+ */
+export function translatePlane(plane, offset) {
+    return { ...plane, origin: vecAdd(plane.origin, offset) };
+}
+/**
+ * Pivot a plane by rotating its axes around a world-space axis.
+ *
+ * @param angleDeg - Rotation angle in **degrees**.
+ * @param axis - World-space axis to rotate around.
+ * @param plane - Plane to pivot.
+ * @returns The pivoted plane.
+ */
+export function pivotPlane(plane, angleDeg, axis = [1, 0, 0]) {
+    const angleRad = angleDeg * DEG2RAD;
+    const newZDir = vecRotate(plane.zDir, axis, angleRad);
+    const newXDir = vecRotate(plane.xDir, axis, angleRad);
+    const newYDir = vecNormalize(vecCross(newZDir, newXDir));
+    return { origin: plane.origin, xDir: newXDir, yDir: newYDir, zDir: newZDir };
+}
+//# sourceMappingURL=planeOps.js.map

package/dist/api/brepjs-compat/planeOps.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"planeOps.js","sourceRoot":"","sources":["../../../src/api/brepjs-compat/planeOps.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Pure plane operations — replaces the old Plane class methods.\n *\n * 第一方模块（2026-09-25 core-decouple Phase 1）：复制自 brepjs\n * `src/core/planeOps.ts`（同源复制，签名不变）；import 来源改为 compat 面\n * 第一方模块与 `result/` 第一方模块。\n */\n\nimport type { Vec3, Vec2, PointInput } from './types';\nimport { toVec3 } from './types';\nimport type { Plane, PlaneName, PlaneInput } from './planeTypes';\nimport {\n  vecAdd,\n  vecSub,\n  vecScale,\n  vecDot,\n  vecCross,\n  vecNormalize,\n  vecIsZero,\n  vecRotate,\n} from './vecOps';\nimport { DEG2RAD } from './constants';\nimport { type Result, ok, err, unwrap } from '../../result/result';\nimport { validationError } from '../../result/errors';\n\n// ---------------------------------------------------------------------------\n// Plane construction\n// ---------------------------------------------------------------------------\n\n/**\n * Create a {@link Plane} from an origin, optional X direction, and a normal.\n *\n * If `xDirection` is omitted, the X axis is derived automatically via kernel `gp_Ax3`.\n *\n * @param origin - Origin point of the plane.\n * @param xDirection - Explicit X axis direction, or `null` to auto-derive.\n * @param normal - Plane normal (Z direction).\n * @returns The created plane.\n * @throws If the normal or derived xDir is zero-length.\n */\nexport function createPlane(\n  origin: Vec3,\n  xDirection: Vec3 | null = null,\n  normal: Vec3 = [0, 0, 1]\n): Plane {\n  const zDir = vecNormalize(normal);\n  if (vecIsZero(zDir)) throw new Error('Plane normal must be non-zero');\n\n  let xDir: Vec3;\n  if (!xDirection) {\n    // Derive xDir perpendicular to zDir (same algorithm as kernel gp_Ax3)\n    const [nx, ny, nz] = zDir;\n    const absX = Math.abs(nx),\n      absY = Math.abs(ny),\n      absZ = Math.abs(nz);\n    // Pick the axis least aligned with zDir to cross-product with\n    let candidate: Vec3;\n    if (absX <= absY && absX <= absZ) candidate = [1, 0, 0];\n    else if (absY <= absZ) candidate = [0, 1, 0];\n    else candidate = [0, 0, 1];\n    // xDir = normalize(candidate × zDir)\n    const cx = candidate[1] * nz - candidate[2] * ny;\n    const cy = candidate[2] * nx - candidate[0] * nz;\n    const cz = candidate[0] * ny - candidate[1] * nx;\n    const len = Math.sqrt(cx * cx + cy * cy + cz * cz);\n    xDir = len > 1e-12 ? vecNormalize([cx, cy, cz]) : [1, 0, 0];\n  } else {\n    xDir = vecNormalize(xDirection);\n  }\n\n  if (vecIsZero(xDir)) throw new Error('Plane xDir must be non-zero');\n\n  const yDir = vecNormalize(vecCross(zDir, xDir));\n\n  return { origin, xDir, yDir, zDir };\n}\n\n// ---------------------------------------------------------------------------\n// Named plane configs\n// ---------------------------------------------------------------------------\n\nconst PLANES_CONFIG: Record<PlaneName, { xDir: Vec3; normal: Vec3 }> = {\n  XY: { xDir: [1, 0, 0], normal: [0, 0, 1] },\n  YZ: { xDir: [0, 1, 0], normal: [1, 0, 0] },\n  ZX: { xDir: [0, 0, 1], normal: [0, 1, 0] },\n  XZ: { xDir: [1, 0, 0], normal: [0, -1, 0] },\n  YX: { xDir: [0, 1, 0], normal: [0, 0, -1] },\n  ZY: { xDir: [0, 0, 1], normal: [-1, 0, 0] },\n  front: { xDir: [1, 0, 0], normal: [0, 0, 1] },\n  back: { xDir: [-1, 0, 0], normal: [0, 0, -1] },\n  left: { xDir: [0, 0, 1], normal: [-1, 0, 0] },\n  right: { xDir: [0, 0, -1], normal: [1, 0, 0] },\n  top: { xDir: [1, 0, 0], normal: [0, 1, 0] },\n  bottom: { xDir: [1, 0, 0], normal: [0, -1, 0] },\n};\n\n/**\n * Create a standard named plane with an optional origin offset.\n *\n * @param name - One of the predefined {@link PlaneName} values.\n * @param sourceOrigin - Origin point, or a scalar offset along the plane normal.\n * @returns `Ok<Plane>` on success, or `Err` if the name is unknown.\n */\nexport function createNamedPlane(\n  name: PlaneName,\n  sourceOrigin: PointInput | number = [0, 0, 0]\n): Result<Plane> {\n  const config = PLANES_CONFIG[name] as { xDir: Vec3; normal: Vec3 } | undefined;\n  if (!config) return err(validationError('UNKNOWN_PLANE', `Could not find plane ${name}`));\n\n  let origin: Vec3;\n  if (typeof sourceOrigin === 'number') {\n    origin = vecScale(config.normal, sourceOrigin);\n  } else {\n    origin = toVec3(sourceOrigin);\n  }\n  return ok(createPlane(origin, config.xDir, config.normal));\n}\n\n/**\n * Resolve a {@link PlaneInput} to a concrete {@link Plane}.\n *\n * @param input - Plane input to resolve (a named plane or a `Plane` object).\n * @param origin - Optional origin point or scalar offset along the plane normal.\n * @returns `Ok<Plane>` on success, or `Err` if the named plane cannot be resolved.\n */\nexport function resolvePlane(input: PlaneInput, origin?: PointInput | number): Result<Plane> {\n  if (typeof input === 'string') {\n    return createNamedPlane(input, origin);\n  }\n  return ok(input);\n}\n\n// ---------------------------------------------------------------------------\n// makePlane — convenience constructor (migrated from geometryHelpers.ts)\n// ---------------------------------------------------------------------------\n\n/**\n * Create or copy a {@link Plane}.\n *\n * When called with a `Plane` object, returns a shallow copy.\n * When called with a `PlaneName` string (or no arguments), resolves the named\n * plane with an optional origin offset.\n *\n * @param plane - A `Plane` object to copy, or a `PlaneName` string to resolve.\n * @param origin - Origin point or scalar offset along the plane normal.\n * @returns The copied or resolved plane.\n * @default plane `'XY'`\n */\n/**\n * Copy a {@link Plane} object.\n *\n * @param plane - The `Plane` object to copy.\n * @returns A shallow copy of the plane.\n */\nfunction makePlane(plane: Plane): Plane;\n/**\n * Resolve a named plane with an optional origin offset.\n *\n * @param plane - The {@link PlaneName} to resolve (defaults to `'XY'`).\n * @param origin - Origin point or scalar offset along the plane normal.\n * @returns The resolved plane.\n */\nfunction makePlane(plane?: PlaneName, origin?: PointInput | number): Plane;\nfunction makePlane(plane?: PlaneInput, origin?: PointInput | number): Plane {\n  if (plane && typeof plane !== 'string') {\n    // Already a Plane object - return a copy\n    return { ...plane };\n  } else {\n    return unwrap(resolvePlane(plane ?? 'XY', origin));\n  }\n}\n\nexport { makePlane };\n\n// ---------------------------------------------------------------------------\n// Coordinate transforms\n// ---------------------------------------------------------------------------\n\n/** Convert 2D local coordinates to 3D world coordinates on the plane.\n *\n * @param plane - Plane defining the local coordinate system.\n * @param local - 2D local coordinates.\n * @returns The corresponding 3D world point.\n */\nexport function planeToWorld(plane: Plane, local: Vec2): Vec3 {\n  const [u, v] = local;\n  return vecAdd(vecAdd(plane.origin, vecScale(plane.xDir, u)), vecScale(plane.yDir, v));\n}\n\n/**\n * Convert 3D world coordinates to 2D local coordinates on the plane.\n *\n * @param plane - Plane defining the local coordinate system.\n * @param world - 3D world point.\n * @returns The corresponding 2D local coordinates.\n */\nexport function planeToLocal(plane: Plane, world: Vec3): Vec2 {\n  const relative = vecSub(world, plane.origin);\n  return [vecDot(relative, plane.xDir), vecDot(relative, plane.yDir)];\n}\n\n// ---------------------------------------------------------------------------\n// Plane transformations (all return new Plane)\n// ---------------------------------------------------------------------------\n\n/** Translate a plane by a vector.\n *\n * @param plane - Plane to translate.\n * @param offset - Translation vector.\n * @returns The translated plane.\n */\nexport function translatePlane(plane: Plane, offset: Vec3): Plane {\n  return { ...plane, origin: vecAdd(plane.origin, offset) };\n}\n\n/**\n * Pivot a plane by rotating its axes around a world-space axis.\n *\n * @param angleDeg - Rotation angle in **degrees**.\n * @param axis - World-space axis to rotate around.\n * @param plane - Plane to pivot.\n * @returns The pivoted plane.\n */\nexport function pivotPlane(plane: Plane, angleDeg: number, axis: Vec3 = [1, 0, 0]): Plane {\n  const angleRad = angleDeg * DEG2RAD;\n  const newZDir = vecRotate(plane.zDir, axis, angleRad);\n  const newXDir = vecRotate(plane.xDir, axis, angleRad);\n  const newYDir = vecNormalize(vecCross(newZDir, newXDir));\n  return { origin: plane.origin, xDir: newXDir, yDir: newYDir, zDir: newZDir };\n}\n"]}

package/dist/api/brepjs-compat/planeTypes.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Plane type definitions — immutable plain objects.
+ *
+ * 第一方模块（2026-09-25 core-decouple Phase 1）：复制自 brepjs
+ * `src/core/planeTypes.ts`（同源复制，签名不变）。
+ */
+import type { Vec3 } from './types.js';
+/** Immutable plane defined by origin and three orthogonal direction vectors. */
+export interface Plane {
+    readonly origin: Vec3;
+    readonly xDir: Vec3;
+    readonly yDir: Vec3;
+    readonly zDir: Vec3;
+}
+/**
+ * Named standard planes.
+ *
+ * Axis pairs (`'XY'`, `'YZ'`, …) and view names (`'front'`, `'top'`, …)
+ * are both supported. The axis-pair order determines the normal direction.
+ */
+export type PlaneName = 'XY' | 'YZ' | 'ZX' | 'XZ' | 'YX' | 'ZY' | 'front' | 'back' | 'left' | 'right' | 'top' | 'bottom';
+/** Accept either an explicit {@link Plane} object or a {@link PlaneName} string. */
+export type PlaneInput = Plane | PlaneName;
+//# sourceMappingURL=planeTypes.d.ts.map

package/dist/api/brepjs-compat/planeTypes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"planeTypes.d.ts","sourceRoot":"","sources":["../../../src/api/brepjs-compat/planeTypes.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,SAAS,CAAC;AAEpC,gFAAgF;AAChF,MAAM,WAAW,KAAK;IACpB,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC;CACrB;AAED;;;;;GAKG;AACH,MAAM,MAAM,SAAS,GACnB,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,KAAK,GAAG,QAAQ,CAAC;AAEnG,oFAAoF;AACpF,MAAM,MAAM,UAAU,GAAG,KAAK,GAAG,SAAS,CAAC"}

package/dist/api/brepjs-compat/planeTypes.js

@@ -0,0 +1,8 @@
+/**
+ * Plane type definitions — immutable plain objects.
+ *
+ * 第一方模块（2026-09-25 core-decouple Phase 1）：复制自 brepjs
+ * `src/core/planeTypes.ts`（同源复制，签名不变）。
+ */
+export {};
+//# sourceMappingURL=planeTypes.js.map

package/dist/api/brepjs-compat/planeTypes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"planeTypes.js","sourceRoot":"","sources":["../../../src/api/brepjs-compat/planeTypes.ts"],"names":[],"mappings":"AAAA;;;;;GAKG","sourcesContent":["/**\n * Plane type definitions — immutable plain objects.\n *\n * 第一方模块（2026-09-25 core-decouple Phase 1）：复制自 brepjs\n * `src/core/planeTypes.ts`（同源复制，签名不变）。\n */\n\nimport type { Vec3 } from './types';\n\n/** Immutable plane defined by origin and three orthogonal direction vectors. */\nexport interface Plane {\n  readonly origin: Vec3;\n  readonly xDir: Vec3;\n  readonly yDir: Vec3;\n  readonly zDir: Vec3;\n}\n\n/**\n * Named standard planes.\n *\n * Axis pairs (`'XY'`, `'YZ'`, …) and view names (`'front'`, `'top'`, …)\n * are both supported. The axis-pair order determines the normal direction.\n */\nexport type PlaneName =\n  'XY' | 'YZ' | 'ZX' | 'XZ' | 'YX' | 'ZY' | 'front' | 'back' | 'left' | 'right' | 'top' | 'bottom';\n\n/** Accept either an explicit {@link Plane} object or a {@link PlaneName} string. */\nexport type PlaneInput = Plane | PlaneName;\n"]}

package/dist/api/brepjs-compat/types.d.ts

@@ -0,0 +1,64 @@
+/**
+ * Core type definitions（compat 面类型底座）。
+ *
+ * 第一方模块（2026-09-25 core-decouple Phase 1）：复制自 brepjs
+ * `src/core/types.ts`（同源复制，签名不变）。
+ * Vec3 tuples replace the old Vector class.
+ * All operations on vectors are pure functions in vecOps.ts.
+ */
+/** 3D vector/point as a readonly tuple */
+export type Vec3 = readonly [number, number, number];
+/** 2D point as a readonly tuple */
+export type Vec2 = readonly [number, number];
+/**
+ * Flexible point input — accepts various formats for convenience.
+ * Use `toVec3()` to normalize to Vec3.
+ */
+export type PointInput = Vec3 | Vec2 | readonly [number, number, number] | readonly [number, number];
+/** Normalize any point input to Vec3
+ *
+ * @param p - Point input to normalize.
+ * @returns The point as a `Vec3` (missing z defaults to 0).
+ */
+export declare function toVec3(p: PointInput): Vec3;
+/** Normalize to Vec2 (drops z)
+ *
+ * @param p - Point input to normalize.
+ * @returns The point as a `Vec2` (z component dropped).
+ */
+export declare function toVec2(p: PointInput): Vec2;
+/** Direction shorthand — a named axis (`'X'`, `'Y'`, `'Z'`) or an explicit {@link Vec3}. */
+export type Direction = Vec3 | 'X' | 'Y' | 'Z';
+/**
+ * Resolve a {@link Direction} shorthand to a unit {@link Vec3}.
+ *
+ * @param d - Direction shorthand to resolve.
+ * @returns The direction as a unit `Vec3`.
+ * @throws If the string is not a recognised axis name.
+ */
+export declare function resolveDirection(d: Direction): Vec3;
+/** A row of a 4x4 matrix. */
+type Row4 = [number, number, number, number];
+/** 4x4 affine transformation matrix in row-major order. Bottom row must be [0,0,0,1]. */
+export type Matrix4x4 = [Row4, Row4, Row4, Row4];
+/** Structured matrix input: 3x3 linear part + translation vector. */
+export interface MatrixTransform {
+    /** 3x3 linear part in row-major order: [r00, r01, r02, r10, r11, r12, r20, r21, r22]. */
+    readonly linear: readonly [
+        number,
+        number,
+        number,
+        number,
+        number,
+        number,
+        number,
+        number,
+        number
+    ];
+    /** Translation vector [tx, ty, tz]. */
+    readonly translation: Vec3;
+}
+/** Input accepted by `applyMatrix`: either a raw 4x4 array or a structured object. */
+export type MatrixInput = Matrix4x4 | MatrixTransform;
+export {};
+//# sourceMappingURL=types.d.ts.map

package/dist/api/brepjs-compat/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/api/brepjs-compat/types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,0CAA0C;AAC1C,MAAM,MAAM,IAAI,GAAG,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;AAErD,mCAAmC;AACnC,MAAM,MAAM,IAAI,GAAG,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAE7C;;;GAGG;AACH,MAAM,MAAM,UAAU,GACpB,IAAI,GAAG,IAAI,GAAG,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAE9E;;;;GAIG;AACH,wBAAgB,MAAM,CAAC,CAAC,EAAE,UAAU,GAAG,IAAI,CAG1C;AAED;;;;GAIG;AACH,wBAAgB,MAAM,CAAC,CAAC,EAAE,UAAU,GAAG,IAAI,CAE1C;AAED,4FAA4F;AAC5F,MAAM,MAAM,SAAS,GAAG,IAAI,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,CAAC;AAQ/C;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,SAAS,GAAG,IAAI,CAOnD;AAMD,6BAA6B;AAC7B,KAAK,IAAI,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;AAE7C,yFAAyF;AACzF,MAAM,MAAM,SAAS,GAAG,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;AAEjD,qEAAqE;AACrE,MAAM,WAAW,eAAe;IAC9B,yFAAyF;IACzF,QAAQ,CAAC,MAAM,EAAE,SAAS;QACxB,MAAM;QACN,MAAM;QACN,MAAM;QACN,MAAM;QACN,MAAM;QACN,MAAM;QACN,MAAM;QACN,MAAM;QACN,MAAM;KACP,CAAC;IACF,uCAAuC;IACvC,QAAQ,CAAC,WAAW,EAAE,IAAI,CAAC;CAC5B;AAED,sFAAsF;AACtF,MAAM,MAAM,WAAW,GAAG,SAAS,GAAG,eAAe,CAAC"}

package/dist/api/brepjs-compat/types.js

@@ -0,0 +1,48 @@
+/**
+ * Core type definitions（compat 面类型底座）。
+ *
+ * 第一方模块（2026-09-25 core-decouple Phase 1）：复制自 brepjs
+ * `src/core/types.ts`（同源复制，签名不变）。
+ * Vec3 tuples replace the old Vector class.
+ * All operations on vectors are pure functions in vecOps.ts.
+ */
+/** Normalize any point input to Vec3
+ *
+ * @param p - Point input to normalize.
+ * @returns The point as a `Vec3` (missing z defaults to 0).
+ */
+export function toVec3(p) {
+    if (p.length === 2)
+        return [p[0], p[1], 0];
+    return [p[0], p[1], p[2]];
+}
+/** Normalize to Vec2 (drops z)
+ *
+ * @param p - Point input to normalize.
+ * @returns The point as a `Vec2` (z component dropped).
+ */
+export function toVec2(p) {
+    return [p[0], p[1]];
+}
+const DIRECTIONS = {
+    X: [1, 0, 0],
+    Y: [0, 1, 0],
+    Z: [0, 0, 1],
+};
+/**
+ * Resolve a {@link Direction} shorthand to a unit {@link Vec3}.
+ *
+ * @param d - Direction shorthand to resolve.
+ * @returns The direction as a unit `Vec3`.
+ * @throws If the string is not a recognised axis name.
+ */
+export function resolveDirection(d) {
+    if (typeof d === 'string') {
+        const dir = DIRECTIONS[d];
+        if (!dir)
+            throw new Error(`Unknown direction: ${d}`);
+        return dir;
+    }
+    return d;
+}
+//# sourceMappingURL=types.js.map

package/dist/api/brepjs-compat/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/api/brepjs-compat/types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAeH;;;;GAIG;AACH,MAAM,UAAU,MAAM,CAAC,CAAa;IAClC,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAC3C,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAC5B,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,MAAM,CAAC,CAAa;IAClC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AACtB,CAAC;AAKD,MAAM,UAAU,GAAyB;IACvC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;IACZ,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;IACZ,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;CACb,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,UAAU,gBAAgB,CAAC,CAAY;IAC3C,IAAI,OAAO,CAAC,KAAK,QAAQ,EAAE,CAAC;QAC1B,MAAM,GAAG,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC;QAC1B,IAAI,CAAC,GAAG;YAAE,MAAM,IAAI,KAAK,CAAC,sBAAsB,CAAC,EAAE,CAAC,CAAC;QACrD,OAAO,GAAG,CAAC;IACb,CAAC;IACD,OAAO,CAAC,CAAC;AACX,CAAC","sourcesContent":["/**\n * Core type definitions（compat 面类型底座）。\n *\n * 第一方模块（2026-09-25 core-decouple Phase 1）：复制自 brepjs\n * `src/core/types.ts`（同源复制，签名不变）。\n * Vec3 tuples replace the old Vector class.\n * All operations on vectors are pure functions in vecOps.ts.\n */\n\n/** 3D vector/point as a readonly tuple */\nexport type Vec3 = readonly [number, number, number];\n\n/** 2D point as a readonly tuple */\nexport type Vec2 = readonly [number, number];\n\n/**\n * Flexible point input — accepts various formats for convenience.\n * Use `toVec3()` to normalize to Vec3.\n */\nexport type PointInput =\n  Vec3 | Vec2 | readonly [number, number, number] | readonly [number, number];\n\n/** Normalize any point input to Vec3\n *\n * @param p - Point input to normalize.\n * @returns The point as a `Vec3` (missing z defaults to 0).\n */\nexport function toVec3(p: PointInput): Vec3 {\n  if (p.length === 2) return [p[0], p[1], 0];\n  return [p[0], p[1], p[2]];\n}\n\n/** Normalize to Vec2 (drops z)\n *\n * @param p - Point input to normalize.\n * @returns The point as a `Vec2` (z component dropped).\n */\nexport function toVec2(p: PointInput): Vec2 {\n  return [p[0], p[1]];\n}\n\n/** Direction shorthand — a named axis (`'X'`, `'Y'`, `'Z'`) or an explicit {@link Vec3}. */\nexport type Direction = Vec3 | 'X' | 'Y' | 'Z';\n\nconst DIRECTIONS: Record<string, Vec3> = {\n  X: [1, 0, 0],\n  Y: [0, 1, 0],\n  Z: [0, 0, 1],\n};\n\n/**\n * Resolve a {@link Direction} shorthand to a unit {@link Vec3}.\n *\n * @param d - Direction shorthand to resolve.\n * @returns The direction as a unit `Vec3`.\n * @throws If the string is not a recognised axis name.\n */\nexport function resolveDirection(d: Direction): Vec3 {\n  if (typeof d === 'string') {\n    const dir = DIRECTIONS[d];\n    if (!dir) throw new Error(`Unknown direction: ${d}`);\n    return dir;\n  }\n  return d;\n}\n\n// ---------------------------------------------------------------------------\n// Matrix types for applyMatrix (OpenSCAD multmatrix equivalent)\n// ---------------------------------------------------------------------------\n\n/** A row of a 4x4 matrix. */\ntype Row4 = [number, number, number, number];\n\n/** 4x4 affine transformation matrix in row-major order. Bottom row must be [0,0,0,1]. */\nexport type Matrix4x4 = [Row4, Row4, Row4, Row4];\n\n/** Structured matrix input: 3x3 linear part + translation vector. */\nexport interface MatrixTransform {\n  /** 3x3 linear part in row-major order: [r00, r01, r02, r10, r11, r12, r20, r21, r22]. */\n  readonly linear: readonly [\n    number,\n    number,\n    number,\n    number,\n    number,\n    number,\n    number,\n    number,\n    number,\n  ];\n  /** Translation vector [tx, ty, tz]. */\n  readonly translation: Vec3;\n}\n\n/** Input accepted by `applyMatrix`: either a raw 4x4 array or a structured object. */\nexport type MatrixInput = Matrix4x4 | MatrixTransform;\n"]}