feat(geom): add complexPolygonFromPath()

packages/geom/package.json

@@ -232,6 +232,9 @@
 		"./closest-point": {
 			"default": "./closest-point.js"
 		},
+		"./complex-polygon-from-path": {
+			"default": "./complex-polygon-from-path.js"
+		},
 		"./complex-polygon": {
 			"default": "./complex-polygon.js"
 		},

packages/geom/src/complex-polygon-from-path.ts

@@ -0,0 +1,22 @@
+import type { Attribs, SamplingOpts } from "@thi.ng/geom-api";
+import { ComplexPolygon } from "./api/complex-polygon.js";
+import type { Path } from "./api/path.js";
+import { asPolygon } from "./as-polygon.js";
+
+/**
+ * Converts given path into a {@link ComplexPolygon}, using `opts` to control
+ * the conversion (via {@link asPolygon}). If no new `attribs` are given, those
+ * of the path will be used (shallow copy).
+ *
+ * @param path
+ * @param opts
+ * @param attribs
+ */
+export const complexPolygonFromPath = (
+	path: Path,
+	opts?: number | Partial<SamplingOpts>,
+	attribs?: Attribs
+) => {
+	const [boundary, ...children] = asPolygon(path, opts);
+	return new ComplexPolygon(boundary, children, attribs || boundary.attribs);
+};

packages/geom/src/index.ts

@@ -27,6 +27,7 @@ export * from "./arc.js";
 export * from "./bpatch.js";
 export * from "./circle.js";
 export * from "./complex-polygon.js";
+export * from "./complex-polygon-from-path.js";
 export * from "./cubic.js";
 export * from "./ellipse.js";
 export * from "./group.js";