@thi.ng/geom 7.0.0 → 8.0.0

package/CHANGELOG.md

@@ -1,6 +1,6 @@
 # Change Log
 
-- **Last updated**: 2024-05-08T18:24:31Z
+- **Last updated**: 2024-06-21T19:34:38Z
 - **Generator**: [thi.ng/monopub](https://thi.ng/monopub)
 
 All notable changes to this project will be documented in this file.
@@ -9,6 +9,201 @@ See [Conventional Commits](https://conventionalcommits.org/) for commit guidelin
 **Note:** Unlisted _patch_ versions only involve non-code or otherwise excluded changes
 and/or version bumps of transitive dependencies.
 
+# [8.0.0](https://github.com/thi-ng/umbrella/tree/@thi.ng/geom@8.0.0) (2024-06-21)
+
+#### 🛑 Breaking changes
+
+- add/update asCubic()/asPath() impls/types/signatures ([9b4df2e](https://github.com/thi-ng/umbrella/commit/9b4df2e))
+- BREAKING CHANGE: update asCubic/asPath() to use new CubicOpts
+  - add support for more shape types, incl. 3D
+- update svgDoc(), add SVGDocAttribs ([a26628b](https://github.com/thi-ng/umbrella/commit/a26628b))
+- BREAKING CHANGE: rename `__bleed` attrib => `__margin`
+  - set default SVG precision to 3 (fractional digits)
+- update clipConvex(), add support for more shape types ([5d594c6](https://github.com/thi-ng/umbrella/commit/5d594c6))
+- BREAKING CHANGE: update clipConvex() to return array of result shapes (rather than single)
+  - add support for polyline & open paths
+- update/extend tessellate() to use new setup/behavior ([c4dadfd](https://github.com/thi-ng/umbrella/commit/c4dadfd))
+- BREAKING CHANGE: update/extend tessellate() to use new setup/behavior
+  - update signature to return `Tessellation`
+  - add/update impls for complex polygons & groups
+  - add `groupFromTessellation()` to process tessellation results
+  - add `TESSELLATE_EARCUT_COMPLEX` preset
+  - remove `TESSELLATE_EDGE_SPLIT_THRESHOLD` & `TESSELLATE_TRI_FAN_SPLIT_THRESHOLD` (see [97f1f66200](https://github.com/thi-ng/umbrella/commit/97f1f66200))
+- migrate types from [@thi.ng/geom-api](https://github.com/thi-ng/umbrella/tree/main/packages/geom-api) ([3182726](https://github.com/thi-ng/umbrella/commit/3182726))
+- BREAKING CHANGE: migrate/internalize types from [@thi.ng/geom-api](https://github.com/thi-ng/umbrella/tree/main/packages/geom-api)
+  - add/migrate:
+    - Attribs, GroupAttribs, IAttributed
+    - IShape, IShape2/3
+    - AABBLike, SphereLike
+    - PCLike, PCLikeConstructor
+    - IHiccupShape, IHiccupShape2/3
+    - SegmentType2/3
+    - PathSegment, PathSegment2/3
+    - HiccupPathSegment, IHiccupPathSegment
+    - CubicOpts
+  - re-export types from geom helper packages (to avoid extraneous imports in user code):
+    - IntersectionResult, IntersectionType, NONE (geom-isec)
+    - SamplingOpts, setDefaultSamples (geom-resample)
+    - SubdivKernel (geom-subdiv-curve)
+    - Tessellator, Tessellation (geom-tessellate)
+  - update CubicOpts.mode, rename `breakpoints` => `break`
+  - update imports
+  - update deps
+- update tessellate() for new API ([4c6a5f4](https://github.com/thi-ng/umbrella/commit/4c6a5f4))
+- BREAKING CHANGE: update tessellate() for new API
+  - add optional ITessellation arg
+  - add `basicTessellation()` & `meshTessellation()` factory fns
+  - update tessellation post-processors (`graphFromTessellation()` etc.)
+- update PathBuilder to support 2D/3D, add pathBuilder3() ([dcf5210](https://github.com/thi-ng/umbrella/commit/dcf5210))
+- BREAKING CHANGE: PathBuilder now using injected segment ctors
+  - users should only use pathBuilder() & pathBuilder3() factory functions
+  - add internal P2D & P3D shape ctor configs
+  - update PathBuilder ctor & internals to use injected shape ctors for segments
+  - update pathFromSvg()
+  - migrate roundedRect() to own file
+
+#### 🚀 Features
+
+- add/update various 2d/3d shape types ([262188c](https://github.com/thi-ng/umbrella/commit/262188c))
+  - add 3d shape types & factory functions:
+    - Cubic3
+    - Line3
+    - Path3
+    - Points3
+    - Polygon3
+    - Polyline3
+    - Quad3
+    - Quadratic3
+    - Ray3
+    - Triangle3
+  - update existing shape type impls & ctors/factories
+- add/update rotate, scale, translate, transform ops (signatures & type support, impls) ([cb04a96](https://github.com/thi-ng/umbrella/commit/cb04a96))
+- add rotateAroundAxis(), add rotateX/Y/Z() ops ([8831cc1](https://github.com/thi-ng/umbrella/commit/8831cc1))
+- update applyTransforms(), add support for 3D shapes/transforms ([91be2ec](https://github.com/thi-ng/umbrella/commit/91be2ec))
+- add/update internal helpers ([10a73f2](https://github.com/thi-ng/umbrella/commit/10a73f2))
+- add/update bounds() impls and fitIntoBounds2/3() types/signatures ([e7a0b5c](https://github.com/thi-ng/umbrella/commit/e7a0b5c))
+- add/update asPolygon()/asPolyline() / vertices() impls/types/signatures ([3ba9714](https://github.com/thi-ng/umbrella/commit/3ba9714))
+- add/update resample()/simplify()/subdivCurve() impls ([1682577](https://github.com/thi-ng/umbrella/commit/1682577))
+- add/update splitAt()/splitArcLength() impls/types ([e6f9e64](https://github.com/thi-ng/umbrella/commit/e6f9e64))
+- add/update clipConvex()/convexHull() impls/types ([a6215c7](https://github.com/thi-ng/umbrella/commit/a6215c7))
+- add shape types support for flip() ([9628c7b](https://github.com/thi-ng/umbrella/commit/9628c7b))
+- add shape types support for arcLength() & center() ([2a9af0d](https://github.com/thi-ng/umbrella/commit/2a9af0d))
+- add Group3 shape type, update pkg exports ([1646263](https://github.com/thi-ng/umbrella/commit/1646263))
+- add sector() path builder ([807b5f1](https://github.com/thi-ng/umbrella/commit/807b5f1))
+- update SVG default attribs & handling ([f80f67a](https://github.com/thi-ng/umbrella/commit/f80f67a))
+  - update setSvgDefaultAttribs() to allow merging
+- add/update splitAt() & splitNearPoint() impls ([1851b1d](https://github.com/thi-ng/umbrella/commit/1851b1d))
+- add planeFromRay() ([c44d8da](https://github.com/thi-ng/umbrella/commit/c44d8da))
+- add 2d line impl for classifyPoint() ([92e54ea](https://github.com/thi-ng/umbrella/commit/92e54ea))
+- fix [#429](https://github.com/thi-ng/umbrella/issues/429), add polygon support for classifyPoint() ([b56ecc1](https://github.com/thi-ng/umbrella/commit/b56ecc1))
+  - refactor plane impl
+- add/update subdivCurve() type support, args & impls ([6233379](https://github.com/thi-ng/umbrella/commit/6233379))
+- update AABB & Rect ctors to clamp size to zero ([7cec7d2](https://github.com/thi-ng/umbrella/commit/7cec7d2))
+- add convolve() w/ impls for poly/polyline (incl. 3d versions) ([b682d34](https://github.com/thi-ng/umbrella/commit/b682d34))
+  - also re-export kernel presets (KERNEL_BOX, KERNEL_TRIANGLE, KERNEL_GAUSSIAN)
+- update convolve(), add ComplexPolygon support ([bfaa0aa](https://github.com/thi-ng/umbrella/commit/bfaa0aa))
+- add/update/fix type info, docs & impls for various ops ([d5ccb1a](https://github.com/thi-ng/umbrella/commit/d5ccb1a))
+- update convolve(), add group support ([00bdc66](https://github.com/thi-ng/umbrella/commit/00bdc66))
+- add Dummy shape type to wrap arbitrary hiccup data ([b6e18bc](https://github.com/thi-ng/umbrella/commit/b6e18bc))
+- add various dummy op impls for Dummy shape type ([05eeb9f](https://github.com/thi-ng/umbrella/commit/05eeb9f))
+- add arcLength(), area() default impls (return 0) ([f2a30bf](https://github.com/thi-ng/umbrella/commit/f2a30bf))
+- add TESSELLATE_EDGE_SPLIT_THRESHOLD() tessellator ([1d8feff](https://github.com/thi-ng/umbrella/commit/1d8feff))
+- add new tessellators presets ([95d6f70](https://github.com/thi-ng/umbrella/commit/95d6f70))
+  - add TESSELLATE_TRI_FAN_SPLIT
+  - add TESSELLATE_TRI_FAN_SPLIT_THRESHOLD
+- add tessellation post-processing helpers ([7687975](https://github.com/thi-ng/umbrella/commit/7687975))
+  - add graphFromTessellation()
+  - add edgesFromTessellation()
+  - add edgePointsFromTessellation()
+  - update deps (adjacency)
+  - update pkg exports/meta
+- add smoothPolygon()/smoothPolyline() ([217a8c2](https://github.com/thi-ng/umbrella/commit/217a8c2))
+- add warpPoint(), add docs ([bf91ff3](https://github.com/thi-ng/umbrella/commit/bf91ff3))
+- add internal __ensurePCLike() helper ([7306b35](https://github.com/thi-ng/umbrella/commit/7306b35))
+- update tessellate(), add `TESSELLATE_TRI_FAN_BOUNDARY` ([1c0d1ce](https://github.com/thi-ng/umbrella/commit/1c0d1ce))
+- add AABB impl for `asPolygon()` ([16e005c](https://github.com/thi-ng/umbrella/commit/16e005c))
+- update/extend subdivCurve() shape type support ([b389db1](https://github.com/thi-ng/umbrella/commit/b389db1))
+  - add docs
+  - add example
+- update subdivCurve() to reflect new API, update kernel presets ([b715d43](https://github.com/thi-ng/umbrella/commit/b715d43))
+  - update/rename subdiv kernels to reflect upstream changes (cd69dd4e20)
+  - update subdivCurve() impls
+  - update docs
+- add `ICopyTransformed` interface & impls for various shape types ([35781b2](https://github.com/thi-ng/umbrella/commit/35781b2))
+- update/extend/simplify resample() impls ([c13c37a](https://github.com/thi-ng/umbrella/commit/c13c37a))
+- update/extend/simplify convolve() impls, fix kernel naming ([5907a2a](https://github.com/thi-ng/umbrella/commit/5907a2a))
+- add AABBLike.min(), fix AABBLike.offset() impls ([a4dec6b](https://github.com/thi-ng/umbrella/commit/a4dec6b))
+- add centerOfWeight(), centroidOfBounds(), update centroid() ([9048aac](https://github.com/thi-ng/umbrella/commit/9048aac))
+  - update centroid() impls for complex poly & poly, moved to centerOfWeight()
+  - update centroid() to support more types
+  - update pkg exports
+- add/update iterator impls, add IEmpty impls ([0a15df5](https://github.com/thi-ng/umbrella/commit/0a15df5))
+  - update ComplexPolygon
+  - update Path/Path3
+- update asPolygon() / asPolyline() ([80b8d9a](https://github.com/thi-ng/umbrella/commit/80b8d9a))
+  - add support for more types
+  - dedupe impls
+- update pathFromCubics() closed shape check ([10a7558](https://github.com/thi-ng/umbrella/commit/10a7558))
+  - use eqDelta() to check if path is closed
+- update splitAt()/splitNearPoint() ([d863cdd](https://github.com/thi-ng/umbrella/commit/d863cdd))
+  - add support for more shape types
+  - dedupe internals
+- add IPath, update Path/Path3 impls ([eb7a97d](https://github.com/thi-ng/umbrella/commit/eb7a97d))
+- merge 2D/3D versions of pathFromCubics() & normalizedPath() ([159cd56](https://github.com/thi-ng/umbrella/commit/159cd56))
+  - add PathConstructor type
+  - update pathFromCubics() & normalizedPath()
+  - migrate fns to separate files
+  - update asPath()
+
+#### 🩹 Bug fixes
+
+- fix path `__samples` attrib handling in asPolygon() & asPolyline() impls ([3d7bd8c](https://github.com/thi-ng/umbrella/commit/3d7bd8c))
+- update various transform op impls for ComplexPolygon ([1e12707](https://github.com/thi-ng/umbrella/commit/1e12707))
+  - minor other internal refactoring
+- update attrib checks in applyTransforms() ([a19f7be](https://github.com/thi-ng/umbrella/commit/a19f7be))
+- fix vertices() impl for Polygon3 ([a968737](https://github.com/thi-ng/umbrella/commit/a968737))
+- update pathFromCubics to mark path as closed if needed ([c95b5a8](https://github.com/thi-ng/umbrella/commit/c95b5a8))
+- fix typo in centroid() dispatch table ([f1f986b](https://github.com/thi-ng/umbrella/commit/f1f986b))
+- rename KERNEL_TRIANGLE, fix pkg exports ([ed776ed](https://github.com/thi-ng/umbrella/commit/ed776ed))
+
+#### ⏱ Performance improvements
+
+- update rotate() impls to reuse precomputed matrices ([00e33f0](https://github.com/thi-ng/umbrella/commit/00e33f0))
+- internal update shape attrib copying ([fe0609a](https://github.com/thi-ng/umbrella/commit/fe0609a))
+  - rename __copyAttribsRaw => __copyAttribs
+  - avoid extraneous fn calls
+
+#### ♻️ Refactoring
+
+- update offset() & union() ops/signatures ([a943342](https://github.com/thi-ng/umbrella/commit/a943342))
+- rename sector() => asSector(), minor refactor ([d1fb9bf](https://github.com/thi-ng/umbrella/commit/d1fb9bf))
+- minor internal updates asPolygon() ([599572e](https://github.com/thi-ng/umbrella/commit/599572e))
+- rename Dummy => Extra (dummy() => extra()) ([beb4bf0](https://github.com/thi-ng/umbrella/commit/beb4bf0))
+  - update various op impls
+  - update pkg exports
+- update group to use GroupAttribs ([6f913ff](https://github.com/thi-ng/umbrella/commit/6f913ff))
+- update SVGDocAttribs ([102bb5c](https://github.com/thi-ng/umbrella/commit/102bb5c))
+  - remove `__prec` (now part of base`Attribs`)
+- dedupe 2d/3d versions of pathFromCubics(), normalizedPath() ([da8ed42](https://github.com/thi-ng/umbrella/commit/da8ed42))
+- simplify `applyTransforms()` for groups ([d1f5873](https://github.com/thi-ng/umbrella/commit/d1f5873))
+- simplify various shape transform ops & impls ([ba32846](https://github.com/thi-ng/umbrella/commit/ba32846))
+  - better re-use of impls for `PCLike` types
+  - remove obsolete internal helpers
+- simplify subdivCurve() impls ([e978fab](https://github.com/thi-ng/umbrella/commit/e978fab))
+- minor internal updates ([644a478](https://github.com/thi-ng/umbrella/commit/644a478))
+- minor update complex poly hiccup serialization ([b394842](https://github.com/thi-ng/umbrella/commit/b394842))
+- enforce uniform naming convention of internal functions ([56992b2](https://github.com/thi-ng/umbrella/commit/56992b2))
+- minor updates splitAt()/splitNearPoint() ([3e65f82](https://github.com/thi-ng/umbrella/commit/3e65f82))
+- update proximity() to accept optional distance fn ([df7aef2](https://github.com/thi-ng/umbrella/commit/df7aef2))
+- dedupe union() impls ([c1880c8](https://github.com/thi-ng/umbrella/commit/c1880c8))
+- dedupe path impls for scale()/translate() ([b20cb32](https://github.com/thi-ng/umbrella/commit/b20cb32))
+
+### [7.0.1](https://github.com/thi-ng/umbrella/tree/@thi.ng/geom@7.0.1) (2024-05-09)
+
+#### 🩹 Bug fixes
+
+- update arc() arg defaults, add docs ([cc57a57](https://github.com/thi-ng/umbrella/commit/cc57a57))
+
 # [7.0.0](https://github.com/thi-ng/umbrella/tree/@thi.ng/geom@7.0.0) (2024-05-08)
 
 #### 🛑 Breaking changes