@metamesh/modeling 0.19.0 → 0.20.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +49 -0
- package/README.md +34 -18
- package/dist/api/engine.d.ts +217 -121
- package/dist/api/export.d.ts +123 -79
- package/dist/api/geometry.d.ts +406 -2102
- package/dist/api/index.d.ts +472 -1798
- package/dist/api/math.d.ts +315 -0
- package/dist/api/mechanical.d.ts +1041 -0
- package/dist/api/mesh.d.ts +360 -88
- package/dist/api/text.d.ts +24 -44
- package/dist/docs/guides/concepts.md +67 -33
- package/dist/docs/guides/exporting.md +88 -0
- package/dist/docs/guides/fonts.md +5 -3
- package/dist/docs/guides/fundamentals.md +12 -24
- package/dist/docs/guides/generation.md +24 -16
- package/dist/docs/guides/geometry-values.md +192 -134
- package/dist/docs/guides/hosting.md +51 -96
- package/dist/docs/guides/profiles-and-extrusion.md +159 -11
- package/dist/docs/guides/recipes.md +121 -28
- package/dist/docs/guides/resolution-and-inspection.md +43 -23
- package/dist/docs/guides/solid-joins.md +12 -2
- package/dist/docs/guides/standalone-model.md +4 -2
- package/dist/docs/guides/svg-and-text.md +76 -39
- package/dist/docs/guides/sweeps-and-lofts.md +88 -44
- package/dist/docs/guides/transforms-and-placement.md +113 -103
- package/dist/docs/guides/workers.md +166 -0
- package/dist/docs/manifest.json +4133 -4153
- package/dist/docs/reference/engine/GenerationOptions.md +2 -3
- package/dist/docs/reference/engine/GeometryResource.md +6 -6
- package/dist/docs/reference/engine/ModelDependencies.md +2 -2
- package/dist/docs/reference/engine/ModelEngine.md +2 -3
- package/dist/docs/reference/engine/ModelEngineOptions.md +2 -7
- package/dist/docs/reference/engine/ModelPart.md +6 -6
- package/dist/docs/reference/engine/ModelResult.md +2 -2
- package/dist/docs/reference/engine/ModelRunArguments.md +2 -2
- package/dist/docs/reference/engine/ModelRunOptions.md +2 -3
- package/dist/docs/reference/engine/ModelSession.md +2 -2
- package/dist/docs/reference/engine/SessionOptions.md +2 -3
- package/dist/docs/reference/engine/categories/host-lifecycle.md +9 -3
- package/dist/docs/reference/engine/checkModel.md +6 -2
- package/dist/docs/reference/engine/createModelEngine.md +5 -3
- package/dist/docs/reference/engine/defaultModelingLimits.md +4 -11
- package/dist/docs/reference/engine/modelingWasmUrl.md +2 -2
- package/dist/docs/reference/engine.md +7 -1
- package/dist/docs/reference/export/Export3mfOptions.md +2 -6
- package/dist/docs/reference/export/ExportDiagnostic.md +2 -14
- package/dist/docs/reference/export/ExportFormat.md +2 -14
- package/dist/docs/reference/export/ExportGeometry.md +3 -15
- package/dist/docs/reference/export/ExportGlbOptions.md +14 -18
- package/dist/docs/reference/export/ExportLimits.md +2 -14
- package/dist/docs/reference/export/ExportMaterial.md +2 -14
- package/dist/docs/reference/export/ExportOptions.md +2 -14
- package/dist/docs/reference/export/ExportPart.md +2 -14
- package/dist/docs/reference/export/ExportReport.md +2 -14
- package/dist/docs/reference/export/ExportSink.md +5 -15
- package/dist/docs/reference/export/ExportStlOptions.md +2 -6
- package/dist/docs/reference/export/ExportedFile.md +14 -26
- package/dist/docs/reference/export/categories/mesh-serialization.md +9 -3
- package/dist/docs/reference/export/defaultExportLimits.md +2 -2
- package/dist/docs/reference/export/export3mf.md +4 -6
- package/dist/docs/reference/export/exportGlb.md +8 -10
- package/dist/docs/reference/export/exportStl.md +4 -6
- package/dist/docs/reference/export/write3mf.md +6 -6
- package/dist/docs/reference/export/writeGlb.md +10 -10
- package/dist/docs/reference/export/writeStl.md +6 -6
- package/dist/docs/reference/export.md +9 -3
- package/dist/docs/reference/geometry/AlignedCircularSegmentsOptions.md +4 -4
- package/dist/docs/reference/geometry/Anchor3-type.md +3 -7
- package/dist/docs/reference/geometry/Anchor3Options.md +70 -0
- package/dist/docs/reference/geometry/ArcCurve2.md +3 -3
- package/dist/docs/reference/geometry/ArcCurve3.md +3 -3
- package/dist/docs/reference/geometry/AttachOptions.md +4 -9
- package/dist/docs/reference/geometry/Bounds2-type.md +9 -30
- package/dist/docs/reference/geometry/Bounds2Data.md +2 -19
- package/dist/docs/reference/geometry/Bounds2Input.md +2 -10
- package/dist/docs/reference/geometry/Bounds2Options.md +2 -6
- package/dist/docs/reference/geometry/Bounds3-type.md +9 -30
- package/dist/docs/reference/geometry/Bounds3Data.md +2 -15
- package/dist/docs/reference/geometry/Bounds3Input.md +2 -10
- package/dist/docs/reference/geometry/Bounds3Options.md +2 -6
- package/dist/docs/reference/geometry/BoundsFit2.md +2 -2
- package/dist/docs/reference/geometry/BoundsFit3.md +2 -2
- package/dist/docs/reference/geometry/BoundsFitOptions.md +2 -2
- package/dist/docs/reference/geometry/BoxAnchorFace.md +3 -3
- package/dist/docs/reference/geometry/BoxAnchorOptions.md +3 -3
- package/dist/docs/reference/geometry/ChamferedEdgeTreatment.md +3 -7
- package/dist/docs/reference/geometry/CircleContourOptions.md +3 -7
- package/dist/docs/reference/geometry/CircularPrimitiveOptions.md +3 -12
- package/dist/docs/reference/geometry/CircularResolutionOptions.md +2 -2
- package/dist/docs/reference/geometry/CircularSampling.md +2 -2
- package/dist/docs/reference/geometry/CircularSamplingOptions.md +2 -2
- package/dist/docs/reference/geometry/Contour.md +4 -9
- package/dist/docs/reference/geometry/ContourCurve.md +3 -3
- package/dist/docs/reference/geometry/ContourPoint.md +3 -3
- package/dist/docs/reference/geometry/ContourSegment.md +3 -3
- package/dist/docs/reference/geometry/CorrespondingComponent.md +3 -7
- package/dist/docs/reference/geometry/CorrespondingContour.md +3 -7
- package/dist/docs/reference/geometry/CorrespondingProfile.md +3 -7
- package/dist/docs/reference/geometry/CorrespondingProfileStation.md +4 -8
- package/dist/docs/reference/geometry/CubicBezierCurve2.md +3 -3
- package/dist/docs/reference/geometry/CubicBezierCurve3.md +3 -3
- package/dist/docs/reference/geometry/Curve2.md +3 -3
- package/dist/docs/reference/geometry/Curve3.md +3 -3
- package/dist/docs/reference/geometry/CurveSamplingOptions.md +3 -11
- package/dist/docs/reference/geometry/CylinderAnchorFace.md +3 -3
- package/dist/docs/reference/geometry/CylinderAnchorOptions.md +4 -4
- package/dist/docs/reference/geometry/DEFAULT_GEOMETRY_TOLERANCE.md +2 -2
- package/dist/docs/reference/geometry/EdgeTreatment.md +2 -6
- package/dist/docs/reference/geometry/EllipseContourOptions.md +3 -7
- package/dist/docs/reference/geometry/ExtrusionSamplingOptions.md +9 -18
- package/dist/docs/reference/geometry/FittedTextLayout.md +2 -2
- package/dist/docs/reference/geometry/{Frame3.md → Frame3-type.md} +4 -11
- package/dist/docs/reference/geometry/Frame3Options.md +69 -0
- package/dist/docs/reference/geometry/GeometryError.md +2 -6
- package/dist/docs/reference/geometry/GeometryErrorCode.md +2 -6
- package/dist/docs/reference/geometry/GeometryErrorContext.md +2 -6
- package/dist/docs/reference/geometry/GeometryResolution.md +2 -10
- package/dist/docs/reference/geometry/GeometrySamplingLimits.md +3 -11
- package/dist/docs/reference/geometry/GeometryToleranceOptions.md +3 -11
- package/dist/docs/reference/geometry/GridPatternOptions.md +7 -9
- package/dist/docs/reference/geometry/ImmutableBuffer-type.md +2 -10
- package/dist/docs/reference/geometry/LineCurve2.md +3 -3
- package/dist/docs/reference/geometry/LineCurve3.md +3 -3
- package/dist/docs/reference/geometry/LinearPatternOptions.md +2 -6
- package/dist/docs/reference/geometry/LoftPlacement.md +13 -21
- package/dist/docs/reference/geometry/MatchProfilesOptions.md +3 -7
- package/dist/docs/reference/geometry/ModelingLimits.md +2 -14
- package/dist/docs/reference/geometry/NumericArray.md +2 -10
- package/dist/docs/reference/geometry/Path2-type.md +153 -12
- package/dist/docs/reference/geometry/Path2Data.md +3 -11
- package/dist/docs/reference/geometry/Path2Input.md +3 -11
- package/dist/docs/reference/geometry/Path3-type.md +153 -12
- package/dist/docs/reference/geometry/Path3Data.md +3 -11
- package/dist/docs/reference/geometry/Path3Input.md +3 -11
- package/dist/docs/reference/geometry/PathFrame.md +3 -3
- package/dist/docs/reference/geometry/PathLocation.md +3 -11
- package/dist/docs/reference/geometry/PathNormalGuide.md +4 -12
- package/dist/docs/reference/geometry/PathOptions.md +3 -7
- package/dist/docs/reference/geometry/PathPatternOptions.md +3 -7
- package/dist/docs/reference/geometry/PathPlacement.md +5 -5
- package/dist/docs/reference/geometry/PathResamplingOptions.md +3 -11
- package/dist/docs/reference/geometry/PathStation.md +87 -0
- package/dist/docs/reference/geometry/PathSubdivisionOptions.md +44 -0
- package/dist/docs/reference/geometry/Pivot2Options.md +3 -11
- package/dist/docs/reference/geometry/Pivot3Options.md +3 -11
- package/dist/docs/reference/geometry/PolygonData.md +4 -8
- package/dist/docs/reference/geometry/PolylineResamplingOptions.md +3 -3
- package/dist/docs/reference/geometry/Profile.md +3 -4
- package/dist/docs/reference/geometry/ProfileComponent2.md +3 -7
- package/dist/docs/reference/geometry/ProfileContour2.md +3 -7
- package/dist/docs/reference/geometry/ProfileSpan2.md +3 -7
- package/dist/docs/reference/geometry/ProfiledEdgeTreatment.md +5 -8
- package/dist/docs/reference/geometry/RadialPatternOptions.md +2 -6
- package/dist/docs/reference/geometry/RadialSizing.md +2 -6
- package/dist/docs/reference/geometry/RadialSizingOptions.md +2 -6
- package/dist/docs/reference/geometry/RectangleContourOptions.md +4 -7
- package/dist/docs/reference/geometry/RectangleCornerTreatment.md +3 -7
- package/dist/docs/reference/geometry/RectangleCornerTreatments.md +3 -7
- package/dist/docs/reference/geometry/RectangleProfileOptions.md +3 -3
- package/dist/docs/reference/geometry/RegionData.md +3 -7
- package/dist/docs/reference/geometry/RegularPolygonContourOptions.md +3 -3
- package/dist/docs/reference/geometry/ResolvedGeometryResolution.md +71 -0
- package/dist/docs/reference/geometry/ResolvedGeometryTolerance.md +2 -2
- package/dist/docs/reference/geometry/RoundedEdgeTreatment.md +2 -6
- package/dist/docs/reference/geometry/RowLayoutOptions.md +2 -2
- package/dist/docs/reference/geometry/SampleContourOptions.md +3 -3
- package/dist/docs/reference/geometry/SampleHelixOptions.md +3 -3
- package/dist/docs/reference/geometry/SampleSideProfileOptions.md +3 -3
- package/dist/docs/reference/geometry/SampledCurve2.md +3 -3
- package/dist/docs/reference/geometry/SampledCurve3.md +3 -3
- package/dist/docs/reference/geometry/SideProfileCurve.md +3 -3
- package/dist/docs/reference/geometry/SideProfilePoint.md +3 -3
- package/dist/docs/reference/geometry/SideProfileSegment.md +3 -3
- package/dist/docs/reference/geometry/SmoothEdgeTreatment.md +2 -6
- package/dist/docs/reference/geometry/SplineOptions.md +69 -0
- package/dist/docs/reference/geometry/StarContourOptions.md +7 -7
- package/dist/docs/reference/geometry/StrokeCap.md +2 -6
- package/dist/docs/reference/geometry/StrokeJoin.md +2 -6
- package/dist/docs/reference/geometry/StrokeOptions.md +3 -7
- package/dist/docs/reference/geometry/SvgImportOptions.md +4 -4
- package/dist/docs/reference/geometry/SvgRegionPreflight.md +2 -2
- package/dist/docs/reference/geometry/SvgRegionPreflightGeometryMetrics.md +2 -2
- package/dist/docs/reference/geometry/SvgRegionPreflightRepairs.md +2 -2
- package/dist/docs/reference/geometry/SvgRegionPreflightSourceMetrics.md +2 -2
- package/dist/docs/reference/geometry/Transform2-type.md +3 -11
- package/dist/docs/reference/geometry/Transform2Data.md +3 -11
- package/dist/docs/reference/geometry/Transform2Input.md +3 -11
- package/dist/docs/reference/geometry/Transform3-type.md +4 -12
- package/dist/docs/reference/geometry/Transform3Data.md +3 -11
- package/dist/docs/reference/geometry/Transform3Input.md +6 -13
- package/dist/docs/reference/geometry/Vector2-type.md +3 -11
- package/dist/docs/reference/geometry/Vector2Data.md +3 -15
- package/dist/docs/reference/geometry/Vector2Input.md +3 -11
- package/dist/docs/reference/geometry/Vector3-type.md +27 -11
- package/dist/docs/reference/geometry/Vector3Data.md +3 -11
- package/dist/docs/reference/geometry/Vector3Input.md +3 -11
- package/dist/docs/reference/geometry/VectorTextLayout.md +2 -10
- package/dist/docs/reference/geometry/VectorTextMetrics.md +3 -11
- package/dist/docs/reference/geometry/anchor3.md +17 -26
- package/dist/docs/reference/geometry/anchorFrame3.md +6 -6
- package/dist/docs/reference/geometry/attachmentTransform3.md +8 -8
- package/dist/docs/reference/geometry/bounds2.md +6 -8
- package/dist/docs/reference/geometry/bounds3.md +4 -6
- package/dist/docs/reference/geometry/boundsCenter.md +2 -2
- package/dist/docs/reference/geometry/boundsSize.md +2 -2
- package/dist/docs/reference/geometry/boxAnchor3.md +3 -3
- package/dist/docs/reference/geometry/categories/bounds-layout.md +9 -3
- package/dist/docs/reference/geometry/categories/curves-paths.md +24 -13
- package/dist/docs/reference/geometry/categories/immutable-data.md +40 -0
- package/dist/docs/reference/geometry/categories/pattern-placement.md +10 -4
- package/dist/docs/reference/geometry/categories/primitive-options.md +8 -13
- package/dist/docs/reference/geometry/categories/profiles-regions.md +11 -5
- package/dist/docs/reference/geometry/categories/resolution-errors.md +8 -1
- package/dist/docs/reference/geometry/categories/transforms-math.md +20 -51
- package/dist/docs/reference/geometry/categories/vector-import.md +7 -4
- package/dist/docs/reference/geometry/circleContour.md +3 -3
- package/dist/docs/reference/geometry/closeToAxis.md +7 -3
- package/dist/docs/reference/geometry/computeClosedParallelTransportFrames.md +9 -6
- package/dist/docs/reference/geometry/computeParallelTransportFrames.md +13 -6
- package/dist/docs/reference/geometry/contourContainsPoint.md +7 -3
- package/dist/docs/reference/geometry/cylinderAnchor3.md +5 -5
- package/dist/docs/reference/geometry/defaultGeometrySamplingLimits.md +3 -3
- package/dist/docs/reference/geometry/distributeAlongPath.md +16 -11
- package/dist/docs/reference/geometry/ellipseContour.md +3 -3
- package/dist/docs/reference/geometry/fitBounds.md +10 -2
- package/dist/docs/reference/geometry/fitTextLayout.md +5 -5
- package/dist/docs/reference/geometry/frame3.md +66 -0
- package/dist/docs/reference/geometry/gridPatternTransforms.md +6 -6
- package/dist/docs/reference/geometry/immutableBuffer.md +5 -7
- package/dist/docs/reference/geometry/isGeometryError.md +2 -6
- package/dist/docs/reference/geometry/layoutRow.md +4 -2
- package/dist/docs/reference/geometry/linearPatternTransforms.md +6 -6
- package/dist/docs/reference/geometry/matchProfiles.md +5 -3
- package/dist/docs/reference/geometry/normalizeContour.md +8 -4
- package/dist/docs/reference/geometry/normalizePolygon.md +5 -3
- package/dist/docs/reference/geometry/normalizeRegion.md +5 -3
- package/dist/docs/reference/geometry/path2.md +7 -7
- package/dist/docs/reference/geometry/path3.md +7 -7
- package/dist/docs/reference/geometry/pathPatternTransforms.md +12 -8
- package/dist/docs/reference/geometry/preflightSvgRegion.md +5 -5
- package/dist/docs/reference/geometry/radialPatternTransforms.md +5 -5
- package/dist/docs/reference/geometry/rectangleContour.md +3 -3
- package/dist/docs/reference/geometry/rectangleProfile.md +3 -4
- package/dist/docs/reference/geometry/regionArea.md +3 -3
- package/dist/docs/reference/geometry/regionBounds.md +6 -4
- package/dist/docs/reference/geometry/regularPolygonContour.md +3 -3
- package/dist/docs/reference/geometry/resamplePolyline2.md +7 -3
- package/dist/docs/reference/geometry/resamplePolyline3.md +7 -3
- package/dist/docs/reference/geometry/resolveAlignedCircularSegments.md +5 -5
- package/dist/docs/reference/geometry/resolveArcSegments.md +8 -6
- package/dist/docs/reference/geometry/resolveCircularSampling.md +2 -2
- package/dist/docs/reference/geometry/resolveCircularSegments.md +5 -3
- package/dist/docs/reference/geometry/{resolveExtrusionDivisions.md → resolveExtrusionSlices.md} +16 -15
- package/dist/docs/reference/geometry/resolveGeometrySamplingLimits.md +5 -3
- package/dist/docs/reference/geometry/resolveGeometryTolerance.md +3 -3
- package/dist/docs/reference/geometry/roundClosedPolylinePath.md +12 -5
- package/dist/docs/reference/geometry/sampleContour.md +5 -5
- package/dist/docs/reference/geometry/sampleCurve2.md +7 -3
- package/dist/docs/reference/geometry/sampleCurve3.md +7 -3
- package/dist/docs/reference/geometry/sampleHelix.md +3 -3
- package/dist/docs/reference/geometry/sampleSideProfile.md +5 -5
- package/dist/docs/reference/geometry/sampleTextContours.md +3 -3
- package/dist/docs/reference/geometry/signedContourArea.md +5 -3
- package/dist/docs/reference/geometry/spline2.md +68 -0
- package/dist/docs/reference/geometry/spline3.md +62 -0
- package/dist/docs/reference/geometry/starContour.md +3 -3
- package/dist/docs/reference/geometry/strokeRegionData.md +8 -5
- package/dist/docs/reference/geometry/transform2.md +5 -7
- package/dist/docs/reference/geometry/transform3.md +23 -10
- package/dist/docs/reference/geometry/transformRegionData.md +7 -3
- package/dist/docs/reference/geometry/triangulateContour.md +6 -4
- package/dist/docs/reference/geometry/vector2.md +6 -8
- package/dist/docs/reference/geometry/vector3.md +8 -8
- package/dist/docs/reference/geometry.md +13 -18
- package/dist/docs/reference/{geometry → math}/AxisAngleRotation3.md +4 -5
- package/dist/docs/reference/math/IDENTITY_TRANSFORM3.md +20 -0
- package/dist/docs/reference/math/add2.md +38 -0
- package/dist/docs/reference/math/add3.md +46 -0
- package/dist/docs/reference/math/applyTransformDirection3.md +46 -0
- package/dist/docs/reference/math/applyTransformPoint3.md +44 -0
- package/dist/docs/reference/math/categories/tuple-matrix.md +67 -0
- package/dist/docs/reference/math/cross2.md +38 -0
- package/dist/docs/reference/math/cross3.md +44 -0
- package/dist/docs/reference/math/distance2.md +38 -0
- package/dist/docs/reference/math/distance3.md +38 -0
- package/dist/docs/reference/math/dot2.md +38 -0
- package/dist/docs/reference/math/dot3.md +44 -0
- package/dist/docs/reference/math/eulerTransform3.md +43 -0
- package/dist/docs/reference/math/inverseTransform3.md +36 -0
- package/dist/docs/reference/math/length2.md +32 -0
- package/dist/docs/reference/math/length3.md +32 -0
- package/dist/docs/reference/math/lerp2.md +46 -0
- package/dist/docs/reference/math/lerp3.md +46 -0
- package/dist/docs/reference/math/multiplyTransform3.md +46 -0
- package/dist/docs/reference/math/normalize2.md +45 -0
- package/dist/docs/reference/math/normalize3.md +45 -0
- package/dist/docs/reference/math/projectOntoPlane3.md +40 -0
- package/dist/docs/reference/math/rotate2.md +40 -0
- package/dist/docs/reference/math/rotationTransform3.md +56 -0
- package/dist/docs/reference/math/scale2.md +38 -0
- package/dist/docs/reference/math/scale3.md +44 -0
- package/dist/docs/reference/math/scaleTransform3.md +39 -0
- package/dist/docs/reference/math/subtract2.md +38 -0
- package/dist/docs/reference/math/subtract3.md +44 -0
- package/dist/docs/reference/math/transformDeterminant3.md +38 -0
- package/dist/docs/reference/math/translationTransform3.md +36 -0
- package/dist/docs/reference/math/validateRigidTransform3.md +38 -0
- package/dist/docs/reference/math/validateTransform3.md +48 -0
- package/dist/docs/reference/math.md +22 -0
- package/dist/docs/reference/{geometry → mechanical}/AcmeThreadProfileSpec.md +4 -13
- package/dist/docs/reference/{geometry → mechanical}/Bevel.md +3 -11
- package/dist/docs/reference/{geometry → mechanical}/BevelSize.md +3 -11
- package/dist/docs/reference/{geometry → mechanical}/ButtressPressureFlankSide.md +3 -11
- package/dist/docs/reference/{geometry → mechanical}/ButtressThreadProfileSpec.md +4 -13
- package/dist/docs/reference/{geometry → mechanical}/ClearanceHoleDimensions.md +3 -3
- package/dist/docs/reference/{geometry → mechanical}/ClearanceHoleFit.md +3 -3
- package/dist/docs/reference/{geometry → mechanical}/CompensatedThreadDiameters.md +3 -3
- package/dist/docs/reference/{geometry → mechanical}/CustomThreadProfileSpec.md +5 -15
- package/dist/docs/reference/{geometry → mechanical}/CylindricalGearDimensions.md +3 -3
- package/dist/docs/reference/{geometry → mechanical}/CylindricalGearMeshKind.md +3 -3
- package/dist/docs/reference/{geometry → mechanical}/CylindricalGearOutlineOptions.md +5 -10
- package/dist/docs/reference/{geometry → mechanical}/CylindricalGearPairDimensions.md +3 -3
- package/dist/docs/reference/{geometry → mechanical}/CylindricalGearPairMotionOptions.md +3 -3
- package/dist/docs/reference/{geometry → mechanical}/CylindricalGearPairMotionReport.md +3 -3
- package/dist/docs/reference/{geometry → mechanical}/CylindricalGearPairSpec.md +3 -3
- package/dist/docs/reference/{geometry → mechanical}/CylindricalGearSpec.md +3 -3
- package/dist/docs/reference/{geometry → mechanical}/InternalThreadCutterOptions.md +6 -13
- package/dist/docs/reference/{geometry → mechanical}/KnuckleHingeBaseSpec.md +3 -7
- package/dist/docs/reference/{geometry → mechanical}/KnuckleHingeDimensions.md +4 -5
- package/dist/docs/reference/{geometry → mechanical}/KnuckleHingeInterval.md +3 -3
- package/dist/docs/reference/{geometry → mechanical}/KnuckleHingeSamplingOptions.md +5 -14
- package/dist/docs/reference/{geometry → mechanical}/KnuckleHingeSpec.md +3 -7
- package/dist/docs/reference/{geometry → mechanical}/METRIC_FASTENER_STANDARDS.md +3 -3
- package/dist/docs/reference/{geometry → mechanical}/MetricFastenerSize.md +3 -3
- package/dist/docs/reference/{geometry → mechanical}/MetricFastenerStandard.md +3 -3
- package/dist/docs/reference/{geometry → mechanical}/MetricHexNutDimensions.md +3 -3
- package/dist/docs/reference/{geometry → mechanical}/MetricSocketCapHeadDimensions.md +3 -3
- package/dist/docs/reference/{geometry → mechanical}/PRINTABLE_THREAD_FIT_POLICIES.md +3 -3
- package/dist/docs/reference/{geometry → mechanical}/PrintableThreadFit.md +3 -7
- package/dist/docs/reference/{geometry → mechanical}/PrintableThreadFitPolicy.md +3 -7
- package/dist/docs/reference/{geometry → mechanical}/RackPitchDimensions.md +3 -3
- package/dist/docs/reference/{geometry → mechanical}/RackPitchSpec.md +3 -3
- package/dist/docs/reference/{geometry → mechanical}/SampledThreadHelices.md +4 -8
- package/dist/docs/reference/{geometry → mechanical}/SquareThreadProfileSpec.md +4 -13
- package/dist/docs/reference/{geometry → mechanical}/ThreadBevelOptions.md +3 -7
- package/dist/docs/reference/{geometry → mechanical}/ThreadCircularSegmentsOptions.md +5 -7
- package/dist/docs/reference/{geometry → mechanical}/ThreadCompensationOptions.md +4 -5
- package/dist/docs/reference/{geometry → mechanical}/ThreadEndStyle.md +3 -11
- package/dist/docs/reference/{geometry → mechanical}/ThreadEndTreatmentOptions.md +3 -11
- package/dist/docs/reference/{geometry → mechanical}/ThreadHandedness.md +3 -11
- package/dist/docs/reference/{geometry → mechanical}/ThreadHelixOptions.md +5 -7
- package/dist/docs/reference/{geometry → mechanical}/ThreadLeadInEnvelope.md +3 -11
- package/dist/docs/reference/{geometry → mechanical}/ThreadLeadInShape.md +3 -11
- package/dist/docs/reference/{geometry → mechanical}/ThreadProfile-type.md +5 -17
- package/dist/docs/reference/{geometry → mechanical}/ThreadProfileBaseSpec.md +4 -13
- package/dist/docs/reference/{geometry → mechanical}/ThreadProfileSpec.md +3 -11
- package/dist/docs/reference/{geometry → mechanical}/ThreadRidgeOptions.md +7 -18
- package/dist/docs/reference/{geometry → mechanical}/ThreadRole.md +3 -3
- package/dist/docs/reference/{geometry → mechanical}/ThreadSolidOptions.md +8 -15
- package/dist/docs/reference/{geometry → mechanical}/ThreadSolidPreflight.md +3 -11
- package/dist/docs/reference/{geometry → mechanical}/ThreadedNutOptions.md +7 -14
- package/dist/docs/reference/{geometry → mechanical}/ThreadedNutPreflight.md +3 -7
- package/dist/docs/reference/{geometry → mechanical}/ThreadedNutShape.md +3 -7
- package/dist/docs/reference/{geometry → mechanical}/ThreadedRodOptions.md +6 -13
- package/dist/docs/reference/{geometry → mechanical}/TrapezoidalThreadProfileSpec.md +4 -13
- package/dist/docs/reference/{geometry → mechanical}/TriangularThreadProfileSpec.md +4 -13
- package/dist/docs/reference/{geometry → mechanical}/categories/mechanical.md +8 -2
- package/dist/docs/reference/{geometry → mechanical}/compensateThreadDiameters.md +4 -4
- package/dist/docs/reference/{geometry → mechanical}/compensateThreadProfileAxially.md +12 -6
- package/dist/docs/reference/{geometry → mechanical}/compensateThreadProfileForFaceting.md +13 -3
- package/dist/docs/reference/{geometry → mechanical}/getMetricClearanceHoleDiameter.md +3 -3
- package/dist/docs/reference/{geometry → mechanical}/getMetricFastenerStandard.md +3 -3
- package/dist/docs/reference/{geometry → mechanical}/measureInternalCylindricalGearPairMotion.md +9 -7
- package/dist/docs/reference/{geometry → mechanical}/minimumCylindricalGearToothCountWithoutUndercut.md +5 -3
- package/dist/docs/reference/{geometry → mechanical}/preflightInternalThreadCutter.md +8 -6
- package/dist/docs/reference/{geometry → mechanical}/preflightThreadedNut.md +9 -7
- package/dist/docs/reference/{geometry → mechanical}/preflightThreadedRod.md +8 -6
- package/dist/docs/reference/{geometry → mechanical}/resolveCylindricalGear.md +5 -3
- package/dist/docs/reference/{geometry → mechanical}/resolveCylindricalGearPair.md +5 -3
- package/dist/docs/reference/{geometry → mechanical}/resolveKnuckleHinge.md +9 -7
- package/dist/docs/reference/{geometry → mechanical}/resolvePrintableThreadFitPolicy.md +5 -3
- package/dist/docs/reference/{geometry → mechanical}/resolveRackPitch.md +5 -3
- package/dist/docs/reference/{geometry → mechanical}/resolveThreadCircularSegments.md +7 -5
- package/dist/docs/reference/{geometry → mechanical}/sampleCylindricalGearOutline.md +9 -8
- package/dist/docs/reference/{geometry → mechanical}/sampleInternalCylindricalGearSpaceOutline.md +9 -8
- package/dist/docs/reference/{geometry → mechanical}/sampleRackToothPath.md +10 -8
- package/dist/docs/reference/{geometry → mechanical}/sampleThreadHelices.md +8 -6
- package/dist/docs/reference/{geometry → mechanical}/threadProfile.md +7 -3
- package/dist/docs/reference/mechanical.md +19 -0
- package/dist/docs/reference/mesh/ExtrudeMeshOptions.md +128 -0
- package/dist/docs/reference/{geometry → mesh}/HeightfieldMeshLimits.md +5 -13
- package/dist/docs/reference/{geometry → mesh}/HeightfieldPreflight.md +3 -7
- package/dist/docs/reference/{geometry → mesh}/ImmutableTriangleMesh.md +5 -17
- package/dist/docs/reference/mesh/LoftMeshStation.md +32 -0
- package/dist/docs/reference/mesh/MeshRenderOptions.md +3 -3
- package/dist/docs/reference/{geometry → mesh}/PlanarMeshOptimizationFallbackReason.md +4 -8
- package/dist/docs/reference/{geometry → mesh}/PlanarMeshOptimizationOptions.md +4 -9
- package/dist/docs/reference/{geometry → mesh}/PlanarMeshOptimizationResult.md +4 -8
- package/dist/docs/reference/{geometry → mesh}/PlanarPatchQuality.md +4 -12
- package/dist/docs/reference/mesh/RenderMesh.md +19 -19
- package/dist/docs/reference/{geometry → mesh}/SolidMeshValidationOptions.md +4 -12
- package/dist/docs/reference/{geometry → mesh}/TriangleMesh.md +8 -12
- package/dist/docs/reference/{geometry → mesh}/TriangleMeshAnalysis.md +5 -14
- package/dist/docs/reference/{geometry → mesh}/TriangleMeshAnalysisOptions.md +4 -9
- package/dist/docs/reference/{geometry → mesh}/TriangleMeshInput.md +3 -7
- package/dist/docs/reference/{geometry → mesh}/TriangleMeshMeasurements.md +5 -14
- package/dist/docs/reference/{geometry → mesh}/TriangleMeshQualityOptions.md +4 -9
- package/dist/docs/reference/{geometry → mesh}/TriangleMeshQualityReport.md +3 -7
- package/dist/docs/reference/{geometry → mesh}/TriangleMeshSignature.md +4 -9
- package/dist/docs/reference/{geometry → mesh}/TriangleMeshSignatureOptions.md +3 -7
- package/dist/docs/reference/{geometry → mesh}/TriangleMeshSignatureTolerances.md +3 -7
- package/dist/docs/reference/{geometry → mesh}/TriangleMeshTopologyAnalysis.md +5 -14
- package/dist/docs/reference/{geometry → mesh}/TriangleMeshValidationOptions.md +4 -9
- package/dist/docs/reference/mesh/analyze.md +26 -18
- package/dist/docs/reference/mesh/analyzeQuality.md +12 -12
- package/dist/docs/reference/mesh/bounds.md +5 -6
- package/dist/docs/reference/mesh/categories/operations.md +37 -4
- package/dist/docs/reference/mesh/centroid.md +5 -6
- package/dist/docs/reference/mesh/extrude.md +21 -20
- package/dist/docs/reference/mesh/heightfield.md +8 -8
- package/dist/docs/reference/mesh/immutable.md +7 -5
- package/dist/docs/reference/mesh/join.md +7 -7
- package/dist/docs/reference/mesh/loft.md +19 -18
- package/dist/docs/reference/mesh/optimizePlanarPatches.md +21 -21
- package/dist/docs/reference/mesh/preflightHeightfield.md +8 -8
- package/dist/docs/reference/mesh/preflightThreadSolid.md +22 -25
- package/dist/docs/reference/mesh/render.md +7 -5
- package/dist/docs/reference/mesh/reverse.md +7 -7
- package/dist/docs/reference/mesh/revolve.md +12 -14
- package/dist/docs/reference/mesh/signature.md +12 -12
- package/dist/docs/reference/mesh/sweep.md +96 -25
- package/dist/docs/reference/mesh/threadRidge.md +19 -18
- package/dist/docs/reference/mesh/threadSolid.md +23 -22
- package/dist/docs/reference/mesh/transform.md +8 -9
- package/dist/docs/reference/mesh/validate.md +11 -11
- package/dist/docs/reference/mesh/validateSolid.md +10 -10
- package/dist/docs/reference/mesh.md +8 -2
- package/dist/docs/reference/model/BoxEdge.md +23 -0
- package/dist/docs/reference/model/BoxEdgeSelection.md +27 -0
- package/dist/docs/reference/model/BoxEdgeTreatments.md +27 -0
- package/dist/docs/reference/{geometry → model}/BoxOptions.md +12 -12
- package/dist/docs/reference/model/CircleOptions.md +4 -5
- package/dist/docs/reference/model/CornerCutterOptions.md +93 -0
- package/dist/docs/reference/model/CornerCutterTreatment.md +53 -0
- package/dist/docs/reference/model/{HoleCutterOverrun.md → CutterOverrun.md} +8 -7
- package/dist/docs/reference/model/CylinderOptions.md +64 -0
- package/dist/docs/reference/model/DiagnosticOptions.md +2 -2
- package/dist/docs/reference/model/EdgeCutterOptions.md +129 -0
- package/dist/docs/reference/model/EllipseOptions.md +4 -5
- package/dist/docs/reference/model/EndTreatments.md +43 -0
- package/dist/docs/reference/model/ExtrudeOptions.md +153 -0
- package/dist/docs/reference/model/GenerateCallback.md +2 -2
- package/dist/docs/reference/model/GenerateContext.md +27 -3
- package/dist/docs/reference/model/GenerationDiagnostic.md +2 -2
- package/dist/docs/reference/model/GenerationError.md +2 -2
- package/dist/docs/reference/{geometry → model}/HeightfieldOptions.md +5 -23
- package/dist/docs/reference/model/HoleCutterOpening.md +27 -0
- package/dist/docs/reference/model/HoleCutterOptions.md +9 -22
- package/dist/docs/reference/model/HoleCutterRecess.md +5 -4
- package/dist/docs/reference/model/HullOptions.md +2 -3
- package/dist/docs/reference/model/ImmutableValue.md +2 -2
- package/dist/docs/reference/model/ImplicitOptions.md +3 -9
- package/dist/docs/reference/model/JoinOptions.md +2 -5
- package/dist/docs/reference/model/JoinTransition.md +2 -2
- package/dist/docs/reference/model/KnuckleHinge-type.md +2 -3
- package/dist/docs/reference/model/KnuckleHingeHalfOptions.md +2 -2
- package/dist/docs/reference/model/KnuckleHingeOptions.md +3 -5
- package/dist/docs/reference/model/KnuckleHingeWeb.md +2 -2
- package/dist/docs/reference/{geometry → model}/LoftCorrespondence.md +8 -11
- package/dist/docs/reference/{geometry → model}/LoftOptions.md +11 -16
- package/dist/docs/reference/model/LoftStation.md +4 -5
- package/dist/docs/reference/model/Memo.md +2 -2
- package/dist/docs/reference/model/ModelProgram.md +2 -2
- package/dist/docs/reference/model/PartDeclaration.md +4 -5
- package/dist/docs/reference/model/PartGeometry.md +3 -5
- package/dist/docs/reference/model/PartOptions.md +4 -5
- package/dist/docs/reference/model/PatternSource.md +4 -4
- package/dist/docs/reference/model/PlaneOptions.md +3 -7
- package/dist/docs/reference/model/PolygonOptions.md +2 -7
- package/dist/docs/reference/model/PrimitiveAttachment.md +50 -0
- package/dist/docs/reference/model/PrimitiveAttachmentOptions.md +111 -0
- package/dist/docs/reference/model/RectangleOptions.md +21 -26
- package/dist/docs/reference/model/RegularPolygonOptions.md +4 -37
- package/dist/docs/reference/{geometry → model}/RevolveOptions.md +15 -24
- package/dist/docs/reference/model/Section.md +115 -53
- package/dist/docs/reference/model/SectionHullOptions.md +2 -3
- package/dist/docs/reference/model/SectionInspection.md +2 -6
- package/dist/docs/reference/model/SectionOffsetJoin.md +2 -2
- package/dist/docs/reference/model/SectionOffsetOptions.md +2 -3
- package/dist/docs/reference/model/Solid.md +24 -12
- package/dist/docs/reference/model/SolidInspection.md +2 -6
- package/dist/docs/reference/model/SolidSegmentHit.md +2 -6
- package/dist/docs/reference/model/SphereOptions.md +27 -0
- package/dist/docs/reference/model/StarOptions.md +21 -23
- package/dist/docs/reference/model/SvgOrigin.md +2 -2
- package/dist/docs/reference/model/SvgPathSectionOptions.md +3 -5
- package/dist/docs/reference/model/SvgSectionOptions.md +3 -6
- package/dist/docs/reference/model/SweepOptions.md +109 -0
- package/dist/docs/reference/model/SweepOrientation.md +119 -0
- package/dist/docs/reference/model/SweepTransformOptions.md +105 -0
- package/dist/docs/reference/model/TextSectionOptions.md +2 -7
- package/dist/docs/reference/{geometry → model}/TorusOptions.md +11 -10
- package/dist/docs/reference/model/TubeOptions.md +84 -0
- package/dist/docs/reference/model/box.md +11 -10
- package/dist/docs/reference/model/categories/boolean-operations.md +9 -3
- package/dist/docs/reference/model/categories/bounded-surfaces.md +13 -1
- package/dist/docs/reference/model/categories/extrude-revolve-sweep.md +26 -7
- package/dist/docs/reference/model/categories/generation.md +11 -3
- package/dist/docs/reference/model/categories/hinges.md +7 -1
- package/dist/docs/reference/model/categories/mesh-inspection.md +7 -1
- package/dist/docs/reference/model/categories/primitives.md +34 -6
- package/dist/docs/reference/model/categories/sections.md +8 -2
- package/dist/docs/reference/model/categories/threads.md +8 -5
- package/dist/docs/reference/model/categories/transforms-placement.md +15 -10
- package/dist/docs/reference/model/circle.md +7 -3
- package/dist/docs/reference/model/cornerCutter.md +88 -0
- package/dist/docs/reference/model/cylinder.md +6 -5
- package/dist/docs/reference/model/edgeCutter.md +91 -0
- package/dist/docs/reference/model/ellipse.md +7 -3
- package/dist/docs/reference/model/extrude.md +29 -23
- package/dist/docs/reference/model/generate.md +4 -2
- package/dist/docs/reference/model/gridPattern.md +11 -4
- package/dist/docs/reference/model/heightfield.md +5 -5
- package/dist/docs/reference/model/holeCutter.md +26 -12
- package/dist/docs/reference/model/hull.md +2 -2
- package/dist/docs/reference/model/implicit.md +3 -3
- package/dist/docs/reference/model/internalThreadCutter.md +32 -21
- package/dist/docs/reference/model/intersect.md +7 -3
- package/dist/docs/reference/model/join.md +6 -2
- package/dist/docs/reference/model/knuckleHinge.md +2 -3
- package/dist/docs/reference/model/linearPattern.md +11 -4
- package/dist/docs/reference/model/loft.md +28 -24
- package/dist/docs/reference/model/minkowskiSum.md +3 -3
- package/dist/docs/reference/model/pathPattern.md +17 -8
- package/dist/docs/reference/model/polygon.md +8 -3
- package/dist/docs/reference/model/radialPattern.md +11 -4
- package/dist/docs/reference/model/rectangle.md +11 -7
- package/dist/docs/reference/model/regularPolygon.md +7 -3
- package/dist/docs/reference/model/revolve.md +18 -12
- package/dist/docs/reference/model/solidFromMesh.md +10 -6
- package/dist/docs/reference/model/sphere.md +7 -6
- package/dist/docs/reference/model/star.md +11 -7
- package/dist/docs/reference/model/stroke.md +12 -8
- package/dist/docs/reference/model/svgPathSection.md +10 -4
- package/dist/docs/reference/model/svgSection.md +10 -4
- package/dist/docs/reference/model/sweep.md +102 -25
- package/dist/docs/reference/model/textSection.md +7 -3
- package/dist/docs/reference/model/threadRidge.md +16 -17
- package/dist/docs/reference/model/threadedNut.md +25 -22
- package/dist/docs/reference/model/threadedRod.md +21 -18
- package/dist/docs/reference/model/torus.md +13 -12
- package/dist/docs/reference/model/tube.md +6 -5
- package/dist/docs/reference/model/union.md +7 -3
- package/dist/docs/reference/model.md +10 -5
- package/dist/docs/reference/text/MAX_VECTOR_FONT_BYTES.md +2 -2
- package/dist/docs/reference/text/VectorFont.md +38 -34
- package/dist/docs/reference/text/VectorFontOptions.md +2 -2
- package/dist/docs/reference/{geometry → text}/VectorTextArcBaseline.md +2 -11
- package/dist/docs/reference/{geometry → text}/VectorTextLayoutOptions.md +3 -11
- package/dist/docs/reference/{geometry → text}/VectorTextOptions.md +2 -10
- package/dist/docs/reference/text/categories/font-preparation.md +10 -1
- package/dist/docs/reference/text/prepareVectorFont.md +4 -2
- package/dist/docs/reference/text.md +7 -1
- package/dist/engine/execution.js +5 -3
- package/dist/engine/finalization.js +5 -5
- package/dist/engine/index.js +9 -4
- package/dist/engine/native/adapter.js +1 -1
- package/dist/engine/native/construction-mesh.js +15 -5
- package/dist/engine/native/context.js +10 -7
- package/dist/engine/native/index.js +1 -1
- package/dist/engine/native/material-components.js +2 -2
- package/dist/engine/native/mesh-observation.js +1 -1
- package/dist/engine/native/regions.js +44 -24
- package/dist/engine/native/scoped-primitives.js +3 -3
- package/dist/engine/native/scoped-threads.js +1 -13
- package/dist/engine/native/threads.js +2 -2
- package/dist/engine/native/transforms.js +2 -2
- package/dist/engine/operations/construction.js +77 -27
- package/dist/engine/operations/context.js +13 -6
- package/dist/engine/operations/cutters.js +112 -0
- package/dist/engine/operations/environment.js +2 -2
- package/dist/engine/operations/extrusion-finishing.js +42 -16
- package/dist/engine/operations/hole-cutter.js +125 -114
- package/dist/engine/operations/join-collar-profile.js +19 -19
- package/dist/engine/operations/join.js +86 -73
- package/dist/engine/operations/knuckle-hinge.js +25 -20
- package/dist/engine/operations/loft.js +9 -16
- package/dist/engine/operations/mechanical.js +4 -15
- package/dist/engine/operations/primitives/anchors.js +23 -19
- package/dist/engine/operations/primitives/construction.js +38 -12
- package/dist/engine/operations/primitives/correspondence.js +2 -2
- package/dist/engine/operations/primitives/profile-mesh.js +41 -80
- package/dist/engine/operations/primitives/profiles.js +5 -5
- package/dist/engine/operations/sections.js +8 -8
- package/dist/engine/operations/transforms.js +19 -39
- package/dist/engine/placement.js +3 -3
- package/dist/engine/recipe-realization.js +86 -30
- package/dist/engine/session/declarations.js +98 -0
- package/dist/engine/session/dependencies.js +81 -28
- package/dist/engine/session/graph.js +39 -137
- package/dist/engine/session/parameters.js +78 -0
- package/dist/engine/session/session.js +2 -2
- package/dist/engine/session/snapshot-cache.js +2 -2
- package/dist/engine/shape-anchors.js +13 -6
- package/dist/export/3mf.js +9 -2
- package/dist/export/capture.js +10 -6
- package/dist/export/glb.js +7 -2
- package/dist/export/stl.js +21 -6
- package/dist/geometry/{bounds.js → bounds/operations.js} +3 -1
- package/dist/geometry/{bounds-value.js → bounds/value.js} +20 -16
- package/dist/geometry/curves/evaluation.js +5 -6
- package/dist/geometry/curves/sampling.js +30 -6
- package/dist/geometry/{extrusion.js → extrusion/controls.js} +58 -35
- package/dist/geometry/extrusion/mesh.js +92 -0
- package/dist/geometry/extrusion/stations.js +35 -0
- package/dist/geometry/extrusion/twisted-chamfer.js +265 -0
- package/dist/geometry/immutable-buffer.js +7 -1
- package/dist/geometry/index.js +24 -32
- package/dist/geometry/{model-limits.js → limits.js} +1 -1
- package/dist/geometry/loft/{loft-correspondence.js → correspondence.js} +31 -20
- package/dist/geometry/loft/{loft-geometry.js → geometry.js} +15 -17
- package/dist/geometry/loft/mesh.js +53 -0
- package/dist/geometry/loft/{loft-options.js → options.js} +13 -11
- package/dist/geometry/loft/{loft-simple-mesh.js → simple-mesh.js} +26 -17
- package/dist/geometry/math/interpolation.js +9 -0
- package/dist/geometry/math/vector-value.js +12 -3
- package/dist/geometry/math/vector2.js +18 -5
- package/dist/geometry/math/vector3.js +28 -5
- package/dist/geometry/math-api.js +4 -0
- package/dist/geometry/mechanical/gear-motion.js +7 -5
- package/dist/geometry/mechanical/gears.js +21 -4
- package/dist/geometry/mechanical/knuckle-hinge.js +7 -5
- package/dist/geometry/mechanical/threads/fit.js +8 -2
- package/dist/geometry/mechanical/threads/helices.js +4 -2
- package/dist/geometry/mechanical/threads/mesh-plan.js +4 -2
- package/dist/geometry/mechanical/threads/mesh.js +12 -9
- package/dist/geometry/mechanical/threads/profiles.js +18 -4
- package/dist/geometry/mechanical/threads/solids.js +11 -2
- package/dist/geometry/mechanical-api.js +10 -0
- package/dist/geometry/mesh/{mesh-centroid.js → centroid.js} +2 -1
- package/dist/geometry/{heightfield.js → mesh/heightfield.js} +9 -5
- package/dist/geometry/{join-geometry.js → mesh/join-layers.js} +53 -59
- package/dist/geometry/mesh/{mesh.js → operations.js} +11 -18
- package/dist/geometry/mesh/{mesh-planar.js → planar.js} +8 -18
- package/dist/geometry/mesh/{mesh-quality.js → quality.js} +10 -42
- package/dist/geometry/mesh/{mesh-render.js → render-buffers.js} +22 -7
- package/dist/geometry/mesh/{mesh-signature.js → signature.js} +1 -1
- package/dist/geometry/mesh/{mesh-solid-intersections.js → solid-intersections.js} +2 -0
- package/dist/geometry/mesh/{mesh-solid.js → solid.js} +4 -4
- package/dist/geometry/mesh/triangle-quality.js +42 -0
- package/dist/geometry/mesh/winding.js +11 -0
- package/dist/geometry/{numeric.js → mesh/write-vertex.js} +1 -1
- package/dist/geometry/mesh-api.js +12 -11
- package/dist/geometry/paths/distribution.js +43 -0
- package/dist/geometry/paths/editing.js +76 -0
- package/dist/geometry/paths/frames.js +16 -11
- package/dist/geometry/paths/helix.js +1 -1
- package/dist/geometry/paths/resampling.js +46 -61
- package/dist/geometry/paths/{planar.js → rounding.js} +8 -67
- package/dist/geometry/paths/spline.js +116 -0
- package/dist/geometry/paths/traversal.js +107 -0
- package/dist/geometry/paths/{path-value.js → value.js} +97 -18
- package/dist/geometry/patterns/placements.js +20 -29
- package/dist/geometry/{patterns.js → patterns/transforms.js} +11 -7
- package/dist/geometry/primitives/cutters.js +70 -0
- package/dist/geometry/{cylinder.js → primitives/cylinder.js} +4 -4
- package/dist/geometry/{edge-finishing.js → primitives/edges.js} +5 -5
- package/dist/geometry/{primitive-resolvers.js → primitives/resolvers.js} +9 -9
- package/dist/geometry/primitives/sampling.js +41 -0
- package/dist/geometry/profiles/contour.js +19 -7
- package/dist/geometry/profiles/{match-profiles.js → matching.js} +9 -6
- package/dist/geometry/profiles/primitives/circle.js +1 -1
- package/dist/geometry/profiles/primitives/ellipse.js +2 -2
- package/dist/geometry/profiles/primitives/rectangle.js +8 -8
- package/dist/geometry/profiles/primitives/star.js +1 -1
- package/dist/geometry/profiles/side-profile.js +8 -5
- package/dist/geometry/profiles/validation.js +1 -1
- package/dist/geometry/{polygon-clipping.js → regions/clipping.js} +1 -1
- package/dist/geometry/{convex-offset.js → regions/convex-offset.js} +1 -1
- package/dist/geometry/{region-offset.js → regions/offset.js} +7 -5
- package/dist/geometry/{regions.js → regions/operations.js} +59 -22
- package/dist/geometry/{stroke-path.js → regions/stroke.js} +46 -20
- package/dist/geometry/{loft/loft-triangulation.js → regions/triangulation.js} +35 -2
- package/dist/geometry/revolve/{revolve-mesh.js → mesh.js} +9 -10
- package/dist/geometry/{circular-sampling.js → sampling/circular.js} +3 -3
- package/dist/geometry/{sampling-limits.js → sampling/limits.js} +6 -2
- package/dist/geometry/{resolution.js → sampling/resolution.js} +15 -14
- package/dist/geometry/svg/fill.js +4 -3
- package/dist/geometry/svg/import.js +47 -64
- package/dist/geometry/svg/path.js +3 -3
- package/dist/geometry/sweep/closed.js +55 -0
- package/dist/geometry/sweep/mesh.js +30 -0
- package/dist/geometry/{sweeps/sweep-open.js → sweep/open.js} +9 -24
- package/dist/geometry/{sweeps → sweep}/orientation.js +14 -11
- package/dist/geometry/sweep/seam.js +30 -0
- package/dist/geometry/{sweeps → sweep}/stations.js +75 -10
- package/dist/geometry/sweep/transforms.js +30 -0
- package/dist/geometry/{sweeps → sweep}/validation.js +4 -4
- package/dist/geometry/{text-contours.js → text/contours.js} +3 -3
- package/dist/geometry/{text-fitting.js → text/fitting.js} +4 -3
- package/dist/geometry/text/layout.js +1 -0
- package/dist/geometry/{transform3.js → transforms/affine3.js} +31 -46
- package/dist/geometry/{anchors.js → transforms/anchors.js} +43 -24
- package/dist/geometry/{transform-geometry.js → transforms/apply.js} +8 -5
- package/dist/geometry/{transform2.js → transforms/dimensions.js} +23 -19
- package/dist/geometry/transforms/frame.js +64 -0
- package/dist/geometry/{transform-matrix.js → transforms/matrix-input.js} +8 -1
- package/dist/geometry/{transform-value.js → transforms/value.js} +29 -11
- package/dist/index.js +3 -9
- package/dist/model/cutters.js +1 -0
- package/dist/model/execution-binding.js +3 -3
- package/dist/model/generation.js +2 -0
- package/dist/model/immutable-generation-data.js +2 -0
- package/dist/model/operations.js +130 -94
- package/dist/model/recipe-declaration.js +5 -7
- package/dist/text/index.js +3 -0
- package/dist/text/vector-text-layout.js +1 -0
- package/package.json +15 -17
- package/dist/api/export-3mf.d.ts +0 -2
- package/dist/api/export-glb.d.ts +0 -2
- package/dist/api/export-stl.d.ts +0 -2
- package/dist/docs/reference/geometry/BoxEdge.md +0 -17
- package/dist/docs/reference/geometry/BoxEdgeSelection.md +0 -24
- package/dist/docs/reference/geometry/BoxEdgeTreatments.md +0 -25
- package/dist/docs/reference/geometry/CylinderOptions.md +0 -63
- package/dist/docs/reference/geometry/EndTreatments.md +0 -44
- package/dist/docs/reference/geometry/ExtrudeMeshOptions.md +0 -144
- package/dist/docs/reference/geometry/ExtrudeOptions.md +0 -156
- package/dist/docs/reference/geometry/IDENTITY_TRANSFORM3.md +0 -25
- package/dist/docs/reference/geometry/LoftMeshStation.md +0 -41
- package/dist/docs/reference/geometry/PrimitiveAttachment.md +0 -39
- package/dist/docs/reference/geometry/PrimitiveAttachmentOptions.md +0 -114
- package/dist/docs/reference/geometry/SphereOptions.md +0 -25
- package/dist/docs/reference/geometry/SweepOptions.md +0 -127
- package/dist/docs/reference/geometry/SweepOrientation.md +0 -127
- package/dist/docs/reference/geometry/TubeOptions.md +0 -72
- package/dist/docs/reference/geometry/add2.md +0 -43
- package/dist/docs/reference/geometry/add3.md +0 -49
- package/dist/docs/reference/geometry/applyTransformDirection3.md +0 -52
- package/dist/docs/reference/geometry/applyTransformPoint3.md +0 -50
- package/dist/docs/reference/geometry/categories/meshes.md +0 -68
- package/dist/docs/reference/geometry/composeTransform3.md +0 -51
- package/dist/docs/reference/geometry/cross2.md +0 -43
- package/dist/docs/reference/geometry/cross3.md +0 -49
- package/dist/docs/reference/geometry/distance2.md +0 -43
- package/dist/docs/reference/geometry/distance3.md +0 -43
- package/dist/docs/reference/geometry/dot2.md +0 -43
- package/dist/docs/reference/geometry/dot3.md +0 -49
- package/dist/docs/reference/geometry/eulerTransform3.md +0 -49
- package/dist/docs/reference/geometry/frameTransform3.md +0 -55
- package/dist/docs/reference/geometry/inverseTransform3.md +0 -41
- package/dist/docs/reference/geometry/length2.md +0 -37
- package/dist/docs/reference/geometry/length3.md +0 -37
- package/dist/docs/reference/geometry/lerp2.md +0 -49
- package/dist/docs/reference/geometry/lerp3.md +0 -49
- package/dist/docs/reference/geometry/normalize2.md +0 -46
- package/dist/docs/reference/geometry/normalize3.md +0 -46
- package/dist/docs/reference/geometry/projectOntoPlane3.md +0 -43
- package/dist/docs/reference/geometry/rotate2.md +0 -43
- package/dist/docs/reference/geometry/rotationTransform3.md +0 -60
- package/dist/docs/reference/geometry/scale2.md +0 -43
- package/dist/docs/reference/geometry/scale3.md +0 -49
- package/dist/docs/reference/geometry/scaleTransform3.md +0 -45
- package/dist/docs/reference/geometry/subtract2.md +0 -43
- package/dist/docs/reference/geometry/subtract3.md +0 -49
- package/dist/docs/reference/geometry/transformDeterminant3.md +0 -43
- package/dist/docs/reference/geometry/translationTransform3.md +0 -42
- package/dist/docs/reference/geometry/validateRigidTransform3.md +0 -41
- package/dist/docs/reference/geometry/validateTransform3.md +0 -54
- package/dist/docs/reference/model/Profile.md +0 -30
- package/dist/docs/reference/model/categories/explicit-profiles.md +0 -21
- package/dist/docs/reference/model/matchProfiles.md +0 -48
- package/dist/docs/reference/model/preflightInternalThreadCutter.md +0 -93
- package/dist/docs/reference/model/preflightThreadedNut.md +0 -109
- package/dist/docs/reference/model/preflightThreadedRod.md +0 -93
- package/dist/engine/operations/patterns.js +0 -47
- package/dist/geometry/loft/loft.js +0 -105
- package/dist/geometry/mechanical/index.js +0 -14
- package/dist/geometry/primitive-resolution.js +0 -20
- package/dist/geometry/svg/index.js +0 -1
- package/dist/geometry/sweeps/options.js +0 -29
- package/dist/geometry/sweeps/sweep-closed.js +0 -96
- package/dist/geometry/sweeps/sweep-mesh.js +0 -32
- /package/dist/geometry/mechanical/{standards.js → fastener-standards.js} +0 -0
- /package/dist/geometry/mesh/{mesh-edge-table.js → edge-table.js} +0 -0
- /package/dist/geometry/mesh/{mesh-types.js → types.js} +0 -0
- /package/dist/geometry/mesh/{mesh-view-cache.js → view-cache.js} +0 -0
- /package/dist/geometry/{primitive-options.js → primitives/options.js} +0 -0
- /package/dist/geometry/{text-layout.js → sweep/options.js} +0 -0
|
@@ -1,22 +1,23 @@
|
|
|
1
|
-
import { edgeTreatmentSetbacks } from "../../geometry/edge-finishing.js";
|
|
2
1
|
import { GeometryError } from "../../geometry/errors.js";
|
|
3
|
-
import {
|
|
4
|
-
import { heightfieldMesh } from "../../geometry/heightfield.js";
|
|
2
|
+
import { resolveExtrusionContourSlices, resolveExtrusionControls, } from "../../geometry/extrusion/controls.js";
|
|
5
3
|
import { immutableMeshView } from "../../geometry/immutable-buffer.js";
|
|
4
|
+
import { assertMeshAllocationWithinLimits, resolveModelingLimits } from "../../geometry/limits.js";
|
|
6
5
|
import { vector2Data, vector3Data } from "../../geometry/math/vector-value.js";
|
|
7
|
-
import {
|
|
8
|
-
import { path3InputData } from "../../geometry/paths/
|
|
9
|
-
import {
|
|
10
|
-
import {
|
|
11
|
-
import {
|
|
12
|
-
import {
|
|
13
|
-
import { sweepMesh } from "../../geometry/
|
|
6
|
+
import { heightfieldMesh } from "../../geometry/mesh/heightfield.js";
|
|
7
|
+
import { path3InputData } from "../../geometry/paths/value.js";
|
|
8
|
+
import { edgeTreatmentSetbacks } from "../../geometry/primitives/edges.js";
|
|
9
|
+
import { assertPrimitiveOptions } from "../../geometry/primitives/resolvers.js";
|
|
10
|
+
import { assertSamplingCount } from "../../geometry/sampling/limits.js";
|
|
11
|
+
import { resolveGeometryResolution } from "../../geometry/sampling/resolution.js";
|
|
12
|
+
import { sweepMesh } from "../../geometry/sweep/mesh.js";
|
|
13
|
+
import { validateSweepOptions, validateSweepTransformOptions, } from "../../geometry/sweep/orientation.js";
|
|
14
|
+
import { isSweepTransformRoute, sweepTransforms } from "../../geometry/sweep/transforms.js";
|
|
14
15
|
import { triangleMeshToManifold } from "../native/adapter.js";
|
|
15
16
|
import { ownScopedManifoldValue, scopedManifoldScope, trackScopedManifoldValue, } from "../native/context.js";
|
|
16
17
|
import * as kernel from "../native/index.js";
|
|
17
18
|
import { buildFinishedExtrusion } from "./extrusion-finishing.js";
|
|
18
19
|
import { createLoftOperation } from "./loft.js";
|
|
19
|
-
import { buildProfileSweepMesh } from "./primitives/profile-mesh.js";
|
|
20
|
+
import { buildProfileLoftMesh, buildProfileSweepMesh } from "./primitives/profile-mesh.js";
|
|
20
21
|
/** Internal host-bound construction operations. */
|
|
21
22
|
export function createConstructionOperations(environment, sections) {
|
|
22
23
|
const { module, scope, limits, assertActive, throwGeometryError, resolveHandle, nativeSolid, nativeSection, wrapSolid, wrapSection, ownSolid, ownSection, validateFiniteNumber, requirePositiveNumber, validateCoordinates, assertOperandCount, assertMeshAllocation, withResolutionDefaults, resolveCircularSegments, } = environment;
|
|
@@ -56,26 +57,67 @@ export function createConstructionOperations(environment, sections) {
|
|
|
56
57
|
}
|
|
57
58
|
assertSamplingCount(native.numVert(), "extrude", resolved.limits.maxProfilePoints);
|
|
58
59
|
const controls = resolveExtrusionControls(value.height, resolved, "extrude");
|
|
59
|
-
|
|
60
|
-
|
|
60
|
+
if (controls.scales[0] === 0 && native.numContour() > 1)
|
|
61
|
+
throwGeometryError("INVALID_TOPOLOGY", "extrude", "An extrusion apex requires one simple boundary without holes or disconnected components.");
|
|
62
|
+
let slices = value.slices;
|
|
63
|
+
if (slices === undefined) {
|
|
61
64
|
const policy = resolveGeometryResolution(resolved.resolution, resolved.limits);
|
|
62
65
|
// Untwisted uniform taper has planar sides. Its default two-cap topology
|
|
63
66
|
// needs no native contour extraction or longitudinal interpolation.
|
|
64
67
|
if (controls.twist === 0 &&
|
|
65
68
|
controls.scales[0] === controls.scales[1] &&
|
|
66
69
|
policy.maxSegmentLength === undefined)
|
|
67
|
-
|
|
70
|
+
slices = 1;
|
|
68
71
|
else {
|
|
69
72
|
const profile = corresponding(handle) ? handle : sectionProfile(handle);
|
|
70
|
-
|
|
73
|
+
slices = resolveExtrusionContourSlices(profile.components.flatMap((component) => [component.outer, ...component.holes].map((contour) => contour.points)), value.height, resolved);
|
|
71
74
|
}
|
|
72
75
|
}
|
|
73
|
-
const vertices = native.numVert() * (
|
|
76
|
+
const vertices = native.numVert() * (slices + 1),
|
|
74
77
|
// A connected extrusion has T = 2V + 4H - 4. Treating every extra contour as
|
|
75
78
|
// a hole also bounds disconnected Sections, without extracting native point data.
|
|
76
79
|
triangles = Math.max(0, vertices * 2 + 4 * native.numContour() - 8);
|
|
77
80
|
assertMeshAllocationWithinLimits(vertices, triangles, vertices * 12 + triangles * 12, "extrude", resolved.limits);
|
|
78
|
-
|
|
81
|
+
if (controls.twist !== 0 && controls.scales[0] !== controls.scales[1]) {
|
|
82
|
+
// Manifold scales its world XY axes after twisting. The authored contract scales
|
|
83
|
+
// profile-local axes first, so only this mixed case needs explicit corresponding rows.
|
|
84
|
+
const profile = corresponding(handle) ? handle : sectionProfile(handle);
|
|
85
|
+
let pointCount = 0, contourCount = 0;
|
|
86
|
+
for (const component of profile.components)
|
|
87
|
+
for (const contour of [component.outer, ...component.holes]) {
|
|
88
|
+
pointCount += contour.points.length;
|
|
89
|
+
contourCount++;
|
|
90
|
+
}
|
|
91
|
+
// Native contours can simplify repeated landmarks. These rows retain every logical
|
|
92
|
+
// slot, so bound their actual allocation before transforming any profile coordinates.
|
|
93
|
+
assertSamplingCount(pointCount, "extrude", resolved.limits.maxProfilePoints);
|
|
94
|
+
const retainedVertices = pointCount * (slices + 1), retainedTriangles = 2 * retainedVertices + 4 * contourCount;
|
|
95
|
+
assertMeshAllocationWithinLimits(retainedVertices, retainedTriangles, 12 * (retainedVertices + retainedTriangles), "extrude", resolved.limits);
|
|
96
|
+
const stations = Array.from({ length: slices + 1 }, (_, index) => {
|
|
97
|
+
const t = index / slices, angle = ((controls.twist * Math.PI) / 180) * t;
|
|
98
|
+
const c = Math.cos(angle), s = Math.sin(angle);
|
|
99
|
+
const sx = 1 + (controls.scales[0] - 1) * t, sy = 1 + (controls.scales[1] - 1) * t;
|
|
100
|
+
const contour = (value) => ({
|
|
101
|
+
...value,
|
|
102
|
+
points: value.points.map(([x, y]) => [
|
|
103
|
+
x * sx * c - y * sy * s,
|
|
104
|
+
x * sx * s + y * sy * c,
|
|
105
|
+
]),
|
|
106
|
+
});
|
|
107
|
+
return {
|
|
108
|
+
z: value.height * (controls.center ? t - 0.5 : t),
|
|
109
|
+
profile: {
|
|
110
|
+
components: profile.components.map((component) => ({
|
|
111
|
+
...component,
|
|
112
|
+
outer: contour(component.outer),
|
|
113
|
+
holes: component.holes.map(contour),
|
|
114
|
+
})),
|
|
115
|
+
},
|
|
116
|
+
};
|
|
117
|
+
});
|
|
118
|
+
return solidFromMesh(buildProfileLoftMesh(module, stations, resolved.limits));
|
|
119
|
+
}
|
|
120
|
+
return ownSolid(native.extrude(value.height, slices - 1, controls.twist, controls.scales, controls.center));
|
|
79
121
|
};
|
|
80
122
|
const applyBoolean = (values, operation) => {
|
|
81
123
|
assertOperandCount(values, operation);
|
|
@@ -83,10 +125,10 @@ export function createConstructionOperations(environment, sections) {
|
|
|
83
125
|
if (natives.some((native) => native.kind !== kind))
|
|
84
126
|
throwGeometryError("INVALID_ARGUMENT", operation, "Boolean operands must have the same dimensionality.");
|
|
85
127
|
if (kind === "solid") {
|
|
86
|
-
const solids =
|
|
128
|
+
const solids = natives.map((native) => native.value);
|
|
87
129
|
return wrapSolid(operation === "union" ? kernel.union(scope, solids) : kernel.intersect(scope, solids));
|
|
88
130
|
}
|
|
89
|
-
const sections =
|
|
131
|
+
const sections = natives.map((native) => native.value);
|
|
90
132
|
return ownSection(operation === "union"
|
|
91
133
|
? module.CrossSection.union(sections)
|
|
92
134
|
: module.CrossSection.intersection(sections));
|
|
@@ -99,10 +141,10 @@ export function createConstructionOperations(environment, sections) {
|
|
|
99
141
|
if (cutters.length === 0)
|
|
100
142
|
return value;
|
|
101
143
|
return native.kind === "solid"
|
|
102
|
-
? wrapSolid(kernel.subtract(scope, native.value,
|
|
144
|
+
? wrapSolid(kernel.subtract(scope, native.value, natives.map((cutter) => cutter.value)))
|
|
103
145
|
: ownSection(module.CrossSection.difference([
|
|
104
146
|
native.value,
|
|
105
|
-
...
|
|
147
|
+
...natives.map((cutter) => cutter.value),
|
|
106
148
|
]));
|
|
107
149
|
});
|
|
108
150
|
const solidFromMesh = (input) => {
|
|
@@ -204,14 +246,22 @@ export function createConstructionOperations(environment, sections) {
|
|
|
204
246
|
return ownSolid(native.revolve(sweepSegments, degrees));
|
|
205
247
|
},
|
|
206
248
|
loft: createLoftOperation(environment, solidFromMesh),
|
|
207
|
-
|
|
208
|
-
assertActive();
|
|
209
|
-
return matchProfiles(profiles, withResolutionDefaults(value));
|
|
210
|
-
},
|
|
211
|
-
sweep: (shape, path, value = {}) => {
|
|
249
|
+
sweep: (shape, route, value = {}) => {
|
|
212
250
|
assertActive();
|
|
251
|
+
if (isSweepTransformRoute(route)) {
|
|
252
|
+
validateSweepTransformOptions(value);
|
|
253
|
+
const selectedLimits = resolveModelingLimits(value.limits, limits);
|
|
254
|
+
const closed = value.closed ?? false;
|
|
255
|
+
const transforms = sweepTransforms(route, closed, selectedLimits);
|
|
256
|
+
const profile = corresponding(shape) ? shape : sectionProfile(shape);
|
|
257
|
+
assertSamplingCount(profile.components.reduce((count, component) => count +
|
|
258
|
+
component.outer.points.length +
|
|
259
|
+
component.holes.reduce((sum, hole) => sum + hole.points.length, 0), 0), "sweep", selectedLimits.maxSweepProfilePoints);
|
|
260
|
+
return solidFromMesh(buildProfileLoftMesh(module, transforms.map((transform) => ({ profile, transform })), selectedLimits, closed));
|
|
261
|
+
}
|
|
262
|
+
validateSweepOptions(value);
|
|
213
263
|
const defaults = withResolutionDefaults(value);
|
|
214
|
-
const data = path3InputData(
|
|
264
|
+
const data = path3InputData(route, value.closed, defaults.limits);
|
|
215
265
|
const selected = { ...defaults, closed: data.closed };
|
|
216
266
|
if (corresponding(shape))
|
|
217
267
|
return solidFromMesh(buildProfileSweepMesh(module, shape, data.points, selected, selected.limits));
|
|
@@ -1,11 +1,11 @@
|
|
|
1
|
-
import { resolveGeometryResolution } from "../../geometry/resolution.js";
|
|
1
|
+
import { resolveGeometryResolution, } from "../../geometry/sampling/resolution.js";
|
|
2
2
|
import { createConstructionOperations } from "./construction.js";
|
|
3
|
+
import { createCutterOperations } from "./cutters.js";
|
|
3
4
|
import { createOperationEnvironment } from "./environment.js";
|
|
4
5
|
import { createHoleCutterOperation } from "./hole-cutter.js";
|
|
5
6
|
import { createInspectionOperations } from "./inspection.js";
|
|
6
7
|
import { createJoinOperation } from "./join.js";
|
|
7
8
|
import { createMechanicalOperations } from "./mechanical.js";
|
|
8
|
-
import { createPatternOperations } from "./patterns.js";
|
|
9
9
|
import { createPrimitiveOperations } from "./primitives/construction.js";
|
|
10
10
|
import { createSectionOperations } from "./sections.js";
|
|
11
11
|
import { createTransformOperations } from "./transforms.js";
|
|
@@ -15,8 +15,8 @@ export function createModelingContext(owner, initialResolution) {
|
|
|
15
15
|
const environment = createOperationEnvironment(owner, resolution);
|
|
16
16
|
const transforms = createTransformOperations(environment);
|
|
17
17
|
const sections = createSectionOperations(environment, transforms);
|
|
18
|
-
const primitives = createPrimitiveOperations(environment, transforms, sections);
|
|
19
18
|
const construction = createConstructionOperations(environment, sections);
|
|
19
|
+
const primitives = createPrimitiveOperations(environment, transforms, sections, construction);
|
|
20
20
|
const mechanical = createMechanicalOperations(environment, {
|
|
21
21
|
cylinder: primitives.cylinder,
|
|
22
22
|
box: primitives.box,
|
|
@@ -29,7 +29,6 @@ export function createModelingContext(owner, initialResolution) {
|
|
|
29
29
|
translate: transforms.operations.translate,
|
|
30
30
|
subtract: construction.subtract,
|
|
31
31
|
});
|
|
32
|
-
const patterns = createPatternOperations(environment, transforms);
|
|
33
32
|
const inspection = createInspectionOperations(environment);
|
|
34
33
|
return Object.freeze({
|
|
35
34
|
withResolution: (value) => {
|
|
@@ -46,10 +45,18 @@ export function createModelingContext(owner, initialResolution) {
|
|
|
46
45
|
extrude: construction.extrude,
|
|
47
46
|
loft: construction.loft,
|
|
48
47
|
translate: transforms.operations.translate,
|
|
49
|
-
union: construction.union,
|
|
50
48
|
}),
|
|
49
|
+
...createCutterOperations(environment, {
|
|
50
|
+
polygon: sections.polygon,
|
|
51
|
+
extrude: construction.extrude,
|
|
52
|
+
box: primitives.box,
|
|
53
|
+
cylinder: primitives.cylinder,
|
|
54
|
+
sphere: primitives.sphere,
|
|
55
|
+
subtract: construction.subtract,
|
|
56
|
+
translate: transforms.operations.translate,
|
|
57
|
+
hull: construction.hull,
|
|
58
|
+
}, transforms),
|
|
51
59
|
...mechanical,
|
|
52
|
-
...patterns,
|
|
53
60
|
...inspection,
|
|
54
61
|
anchor: owner.anchor,
|
|
55
62
|
withAnchors: owner.withAnchors,
|
|
@@ -0,0 +1,112 @@
|
|
|
1
|
+
import { GeometryError } from "../../geometry/errors.js";
|
|
2
|
+
import { assertMeshAllocationWithinLimits, resolveModelingLimits, } from "../../geometry/limits.js";
|
|
3
|
+
import { chamferCornerCutterPoints, cutterExcess, edgeCutterContour, } from "../../geometry/primitives/cutters.js";
|
|
4
|
+
import { edgeTreatmentSetbacks } from "../../geometry/primitives/edges.js";
|
|
5
|
+
import { assertPositivePrimitive, assertPrimitiveOptions, } from "../../geometry/primitives/resolvers.js";
|
|
6
|
+
import { resolveSphericalPrimitiveSegments } from "../../geometry/primitives/sampling.js";
|
|
7
|
+
import { assertSamplingCount } from "../../geometry/sampling/limits.js";
|
|
8
|
+
import { anchor3 } from "../../geometry/transforms/anchors.js";
|
|
9
|
+
/** Host-bound explicit cutters; construction, placement and subtraction retain their existing owners. */
|
|
10
|
+
export function createCutterOperations(environment, operations, transforms) {
|
|
11
|
+
const empty = () => environment.ownSolid(environment.module.Manifold.union([]));
|
|
12
|
+
const origin = anchor3({ position: [0, 0, 0], direction: [0, 0, 1] });
|
|
13
|
+
const place = (options, solid, anchors) => transforms.placedSolid(options, () => environment.nativeSolid(solid), () => anchors);
|
|
14
|
+
const nonnegative = (value, name, operation) => {
|
|
15
|
+
if (!Number.isFinite(value) || value < 0)
|
|
16
|
+
throw new GeometryError("INVALID_ARGUMENT", `${name} must be finite and nonnegative.`, {
|
|
17
|
+
operation,
|
|
18
|
+
});
|
|
19
|
+
return value;
|
|
20
|
+
};
|
|
21
|
+
const roundSampling = (treatment, selected, operation) => {
|
|
22
|
+
const options = {
|
|
23
|
+
radius: treatment.radius,
|
|
24
|
+
...(treatment.segments === undefined ? {} : { segments: treatment.segments }),
|
|
25
|
+
resolution: { ...selected.resolution, ...treatment.resolution },
|
|
26
|
+
limits: resolveModelingLimits(treatment.limits, selected.limits),
|
|
27
|
+
};
|
|
28
|
+
return {
|
|
29
|
+
...options,
|
|
30
|
+
segments: resolveSphericalPrimitiveSegments(options.radius, options, operation),
|
|
31
|
+
};
|
|
32
|
+
};
|
|
33
|
+
return {
|
|
34
|
+
edgeCutter: (options) => {
|
|
35
|
+
environment.assertActive();
|
|
36
|
+
assertPrimitiveOptions(options, "edgeCutter");
|
|
37
|
+
assertPositivePrimitive(options.length, "length", "edgeCutter");
|
|
38
|
+
if (options.overrun !== undefined)
|
|
39
|
+
assertPrimitiveOptions(options.overrun, "edgeCutter");
|
|
40
|
+
const bottom = nonnegative(options.overrun?.bottom ?? 0, "overrun.bottom", "edgeCutter"), top = nonnegative(options.overrun?.top ?? 0, "overrun.top", "edgeCutter");
|
|
41
|
+
const height = options.length + bottom + top;
|
|
42
|
+
assertPositivePrimitive(height, "extended length", "edgeCutter");
|
|
43
|
+
const selected = environment.withResolutionDefaults(options);
|
|
44
|
+
const treatment = options.treatment;
|
|
45
|
+
assertPrimitiveOptions(treatment, "edgeCutter");
|
|
46
|
+
const excess = cutterExcess(options.excess ?? 0.05, "edgeCutter");
|
|
47
|
+
let solid;
|
|
48
|
+
if ((options.angle ?? 90) === 90 && treatment.kind === "round") {
|
|
49
|
+
const [radius] = edgeTreatmentSetbacks(treatment, "edgeCutter");
|
|
50
|
+
if (radius === 0)
|
|
51
|
+
solid = empty();
|
|
52
|
+
else {
|
|
53
|
+
const sampling = roundSampling(treatment, selected, "edgeCutter");
|
|
54
|
+
assertSamplingCount(sampling.segments / 4 + (excess === 0 ? 2 : 4), "edgeCutter", sampling.limits.maxProfilePoints);
|
|
55
|
+
// Native cylinder and sphere equators share coordinates and angular refinement.
|
|
56
|
+
// Passing the round through a clipped Section would introduce near-coincident seams.
|
|
57
|
+
const cube = operations.translate(operations.box({
|
|
58
|
+
size: [radius + excess, radius + excess, height],
|
|
59
|
+
center: false,
|
|
60
|
+
limits: sampling.limits,
|
|
61
|
+
}), [-excess, -excess, -bottom]);
|
|
62
|
+
const cylinder = operations.translate(operations.cylinder({ ...sampling, height, center: false }), [radius, radius, -bottom]);
|
|
63
|
+
solid = operations.subtract(cube, [cylinder]);
|
|
64
|
+
}
|
|
65
|
+
}
|
|
66
|
+
else {
|
|
67
|
+
const contour = edgeCutterContour(treatment, options.angle ?? 90, excess, selected.resolution, selected.limits);
|
|
68
|
+
solid =
|
|
69
|
+
contour.length === 0
|
|
70
|
+
? empty()
|
|
71
|
+
: operations.translate(operations.extrude(operations.polygon(contour), {
|
|
72
|
+
height,
|
|
73
|
+
resolution: selected.resolution,
|
|
74
|
+
limits: selected.limits,
|
|
75
|
+
}), [0, 0, -bottom]);
|
|
76
|
+
}
|
|
77
|
+
return place(options, solid, {
|
|
78
|
+
origin,
|
|
79
|
+
bottom: anchor3({ position: [0, 0, 0], direction: [0, 0, -1] }),
|
|
80
|
+
top: anchor3({ position: [0, 0, options.length], direction: [0, 0, 1] }),
|
|
81
|
+
});
|
|
82
|
+
},
|
|
83
|
+
cornerCutter: (options) => {
|
|
84
|
+
environment.assertActive();
|
|
85
|
+
assertPrimitiveOptions(options, "cornerCutter");
|
|
86
|
+
assertPrimitiveOptions(options.treatment, "cornerCutter");
|
|
87
|
+
const treatment = options.treatment;
|
|
88
|
+
if ((treatment.kind !== "round" && treatment.kind !== "chamfer") ||
|
|
89
|
+
(treatment.kind === "chamfer" && typeof treatment.distance !== "number"))
|
|
90
|
+
throw new GeometryError("INVALID_ARGUMENT", "Corner cutters require a round treatment or one equal chamfer distance.", { operation: "cornerCutter" });
|
|
91
|
+
const selected = environment.withResolutionDefaults(options);
|
|
92
|
+
const excess = cutterExcess(options.excess ?? 0.05, "cornerCutter");
|
|
93
|
+
const [distance] = edgeTreatmentSetbacks(treatment, "cornerCutter");
|
|
94
|
+
let solid;
|
|
95
|
+
if (distance === 0)
|
|
96
|
+
solid = empty();
|
|
97
|
+
else if (treatment.kind === "chamfer") {
|
|
98
|
+
const points = chamferCornerCutterPoints(distance, excess);
|
|
99
|
+
assertMeshAllocationWithinLimits(10, 16, 26 * 12, "cornerCutter", selected.limits);
|
|
100
|
+
solid = operations.hull({ points });
|
|
101
|
+
}
|
|
102
|
+
else {
|
|
103
|
+
const radius = treatment.radius;
|
|
104
|
+
const sampling = roundSampling(treatment, selected, "cornerCutter");
|
|
105
|
+
const cube = operations.translate(operations.box({ size: radius + excess, center: false, limits: sampling.limits }), [-excess, -excess, -excess]);
|
|
106
|
+
const sphere = operations.translate(operations.sphere(sampling), [radius, radius, radius]);
|
|
107
|
+
solid = operations.subtract(cube, [sphere]);
|
|
108
|
+
}
|
|
109
|
+
return place(options, solid, { origin });
|
|
110
|
+
},
|
|
111
|
+
};
|
|
112
|
+
}
|
|
@@ -1,5 +1,5 @@
|
|
|
1
|
-
import { resolveModelingLimits } from "../../geometry/
|
|
2
|
-
import { resolveCircularPrimitiveSegments } from "../../geometry/
|
|
1
|
+
import { resolveModelingLimits } from "../../geometry/limits.js";
|
|
2
|
+
import { resolveCircularPrimitiveSegments } from "../../geometry/primitives/sampling.js";
|
|
3
3
|
/** Applies explicit resolution inheritance once for this bound context. */
|
|
4
4
|
export function createOperationEnvironment(owner, resolution) {
|
|
5
5
|
const withResolutionDefaults = (value) => {
|
|
@@ -1,20 +1,21 @@
|
|
|
1
|
-
import { edgeTreatmentPointCount, edgeTreatmentSetbacks, sampleEdgeTreatment, } from "../../geometry/edge-finishing.js";
|
|
2
1
|
import { GeometryError } from "../../geometry/errors.js";
|
|
3
|
-
import { resolveExtrusionControls } from "../../geometry/extrusion.js";
|
|
4
|
-
import {
|
|
5
|
-
import {
|
|
6
|
-
import {
|
|
2
|
+
import { resolveExtrusionControls, } from "../../geometry/extrusion/controls.js";
|
|
3
|
+
import { mergeExtrusionStations } from "../../geometry/extrusion/stations.js";
|
|
4
|
+
import { twistedChamferStations } from "../../geometry/extrusion/twisted-chamfer.js";
|
|
5
|
+
import { assertMeshAllocationWithinLimits } from "../../geometry/limits.js";
|
|
6
|
+
import { edgeTreatmentPointCount, edgeTreatmentSetbacks, sampleEdgeTreatment, } from "../../geometry/primitives/edges.js";
|
|
7
|
+
import { planRegionOffsets } from "../../geometry/regions/offset.js";
|
|
8
|
+
import { assertSamplingCount } from "../../geometry/sampling/limits.js";
|
|
9
|
+
import { resolveGeometryResolution, } from "../../geometry/sampling/resolution.js";
|
|
7
10
|
import { buildProfileLoftMesh } from "./primitives/profile-mesh.js";
|
|
8
11
|
const fail = (message) => {
|
|
9
12
|
throw new GeometryError("INVALID_ARGUMENT", message, { operation: "extrude" });
|
|
10
13
|
};
|
|
11
|
-
/**
|
|
14
|
+
/** @internal Builds end-treated stations and lofts their corresponding material boundaries. */
|
|
12
15
|
export function buildFinishedExtrusion(module, profile, options) {
|
|
13
16
|
const controls = resolveExtrusionControls(options.height, options, "extrude");
|
|
14
|
-
if (controls.
|
|
15
|
-
|
|
16
|
-
options.divisions !== undefined)
|
|
17
|
-
fail("End treatments require a straight extrusion without twist, top scaling or divisions.");
|
|
17
|
+
if (controls.scales.some((scale) => scale !== 1))
|
|
18
|
+
fail("End treatments require unit scale.");
|
|
18
19
|
if (typeof options.ends !== "object" || options.ends === null || Array.isArray(options.ends))
|
|
19
20
|
fail("ends must be an object.");
|
|
20
21
|
const bottom = options.ends.bottom, top = options.ends.top;
|
|
@@ -24,15 +25,25 @@ export function buildFinishedExtrusion(module, profile, options) {
|
|
|
24
25
|
const topSize = top === undefined ? [0, 0] : edgeTreatmentSetbacks(top, "extrude", Math.PI / 2, options.limits);
|
|
25
26
|
if (bottomSize[1] + topSize[1] >= options.height)
|
|
26
27
|
fail("End treatments must leave positive length between their side setbacks.");
|
|
28
|
+
if (controls.twist !== 0) {
|
|
29
|
+
if ((bottomSize[0] > 0 && bottom?.kind !== "chamfer") ||
|
|
30
|
+
(topSize[0] > 0 && top?.kind !== "chamfer"))
|
|
31
|
+
fail("Twisted extrusion ends support chamfers; round, smooth and profile treatments require zero twist.");
|
|
32
|
+
return buildProfileLoftMesh(module, twistedChamferStations(profile, options, options.limits, bottomSize, topSize), options.limits);
|
|
33
|
+
}
|
|
27
34
|
const plan = planRegionOffsets(profile, [0, Math.max(bottomSize[0], topSize[0])], "extrude", options.limits);
|
|
28
35
|
const sampling = {
|
|
29
36
|
resolution: options.resolution,
|
|
30
37
|
limits: options.limits,
|
|
31
38
|
magnification: plan.magnification,
|
|
32
39
|
};
|
|
33
|
-
const
|
|
40
|
+
const policy = resolveGeometryResolution(options.resolution, options.limits);
|
|
41
|
+
const slices = options.slices ??
|
|
42
|
+
(policy.maxSegmentLength === undefined
|
|
43
|
+
? 1
|
|
44
|
+
: Math.max(1, Math.ceil(options.height / policy.maxSegmentLength)));
|
|
45
|
+
const treatmentCount = (bottom === undefined ? 1 : edgeTreatmentPointCount(bottom, "extrude", sampling)) +
|
|
34
46
|
(top === undefined ? 1 : edgeTreatmentPointCount(top, "extrude", sampling));
|
|
35
|
-
assertSamplingCount(rowCount, "extrude", options.limits.maxPathPoints);
|
|
36
47
|
let pointCount = 0, contourCount = 0;
|
|
37
48
|
for (const component of profile.components) {
|
|
38
49
|
for (const contour of [component.outer, ...component.holes]) {
|
|
@@ -40,15 +51,30 @@ export function buildFinishedExtrusion(module, profile, options) {
|
|
|
40
51
|
contourCount++;
|
|
41
52
|
}
|
|
42
53
|
}
|
|
43
|
-
const
|
|
44
|
-
|
|
54
|
+
const checkRows = (rowCount) => {
|
|
55
|
+
assertSamplingCount(rowCount, "extrude", options.limits.maxPathPoints);
|
|
56
|
+
const vertexCount = rowCount * pointCount, triangleCount = 2 * vertexCount + 4 * contourCount;
|
|
57
|
+
assertMeshAllocationWithinLimits(vertexCount, triangleCount, 12 * (vertexCount + triangleCount), "extrude", options.limits);
|
|
58
|
+
};
|
|
59
|
+
// Preflight the known minimum before sampling; check the exact merged count below.
|
|
60
|
+
checkRows(Math.max(slices + 1, treatmentCount));
|
|
45
61
|
const bottomPoints = bottom === undefined ? [[0, 0]] : sampleEdgeTreatment(bottom, "extrude", sampling);
|
|
46
62
|
const topPoints = top === undefined ? [[0, 0]] : sampleEdgeTreatment(top, "extrude", sampling);
|
|
47
|
-
const
|
|
63
|
+
const treatmentRows = [
|
|
48
64
|
...bottomPoints.map(([inset, depth]) => ({ inset, z: depth })),
|
|
49
65
|
...[...topPoints].reverse().map(([inset, depth]) => ({ inset, z: options.height - depth })),
|
|
50
66
|
];
|
|
51
|
-
|
|
67
|
+
// Interpolate only added grid heights; required knots retain same-height profile steps.
|
|
68
|
+
let interval = 0;
|
|
69
|
+
const rows = mergeExtrusionStations(options.height, slices, treatmentRows, (z) => {
|
|
70
|
+
while (interval < treatmentRows.length - 2 && z > treatmentRows[interval + 1].z)
|
|
71
|
+
interval++;
|
|
72
|
+
const a = treatmentRows[interval], b = treatmentRows[interval + 1];
|
|
73
|
+
const inset = a.inset + ((b.inset - a.inset) * (z - a.z)) / (b.z - a.z);
|
|
74
|
+
return { z, inset };
|
|
75
|
+
}, options.limits);
|
|
76
|
+
checkRows(rows.length);
|
|
77
|
+
const stations = rows.map(({ z, inset }) => ({
|
|
52
78
|
z: controls.center ? z - options.height / 2 : z,
|
|
53
79
|
profile: plan.profileAt(inset),
|
|
54
80
|
}));
|