@thi.ng/geom 4.0.2 → 4.1.0

package/CHANGELOG.md

@@ -1,6 +1,6 @@
 # Change Log
 
-- **Last updated**: 2022-12-20T16:33:11Z
+- **Last updated**: 2022-12-22T21:47:07Z
 - **Generator**: [thi.ng/monopub](https://thi.ng/monopub)
 
 All notable changes to this project will be documented in this file.
@@ -9,6 +9,14 @@ 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.
 
+## [4.1.0](https://github.com/thi-ng/umbrella/tree/@thi.ng/geom@4.1.0) (2022-12-22)
+
+#### 🚀 Features
+
+- add SVG default attribs & setter ([3cb07a6](https://github.com/thi-ng/umbrella/commit/3cb07a6))
+  - set defaults to no fill & black stroke
+  - add setSvgDefaultAttribs()
+
 # [4.0.0](https://github.com/thi-ng/umbrella/tree/@thi.ng/geom@4.0.0) (2022-12-10)
 
 #### 🛑 Breaking changes

package/README.md

@@ -27,7 +27,7 @@ For the Clojure version, please visit: [thi.ng/geom-clj](https://thi.ng/geom-clj
 
 ## About
 
-Functional, polymorphic API for 2D geometry types & SVG generation
+Functional, polymorphic API for 2D geometry types & SVG generation.
 
 This project is a partially ported from the [Clojure version of the same
 name](http://thi.ng/geom-clj). All polymorphic operations built on
@@ -186,7 +186,7 @@ For Node.js REPL:
 const geom = await import("@thi.ng/geom");
 ```
 
-Package sizes (brotli'd, pre-treeshake): ESM: 11.98 KB
+Package sizes (brotli'd, pre-treeshake): ESM: 12.03 KB
 
 ## Dependencies
 

package/as-svg.d.ts

@@ -1,10 +1,22 @@
 import type { Attribs, IShape } from "@thi.ng/geom-api";
+/**
+ * Sets the SVG root element attribs used by default by {@link svgDoc}.
+ *
+ * @param attribs
+ */
+export declare const setSvgDefaultAttribs: (attribs: Attribs) => void;
+/**
+ * Serializes given hiccup tree to an actual SVG source string.
+ *
+ * @param args
+ */
 export declare const asSvg: (...args: any[]) => string;
 /**
- * Creates a hiccup SVG doc element for given {@link IShape}s and attribs. If
- * the attribs do not include a `viewBox`, it will be computed automatically.
- * Furthermore (and only for the case a viewbox needs to be computed), a `bleed`
- * attrib can be provided to include a bleed/margin for the viewbox.
+ * Creates a hiccup SVG doc element for given {@link IShape}s and attribs
+ * (merged with default attribs). If the attribs do not include a `viewBox`, it
+ * will be computed automatically. Furthermore (and only for the case a viewbox
+ * needs to be computed), a `bleed` attrib can be provided to include a
+ * bleed/margin for the viewbox.
  *
  * @remarks
  * Use {@link asSvg} to serialize the resulting doc to an SVG string.

package/as-svg.js

@@ -5,12 +5,30 @@ import { svg } from "@thi.ng/hiccup-svg/svg";
 import { serialize } from "@thi.ng/hiccup/serialize";
 import { bounds } from "./bounds.js";
 import { __collBounds } from "./internal/bounds.js";
+/**
+ * Can be overridden via {@link setSvgDefaultAttribs}.
+ */
+let DEFAULT_ATTRIBS = { fill: "none", stroke: "#000" };
+/**
+ * Sets the SVG root element attribs used by default by {@link svgDoc}.
+ *
+ * @param attribs
+ */
+export const setSvgDefaultAttribs = (attribs) => {
+    DEFAULT_ATTRIBS = attribs;
+};
+/**
+ * Serializes given hiccup tree to an actual SVG source string.
+ *
+ * @param args
+ */
 export const asSvg = (...args) => args.map((x) => serialize(convertTree(x))).join("");
 /**
- * Creates a hiccup SVG doc element for given {@link IShape}s and attribs. If
- * the attribs do not include a `viewBox`, it will be computed automatically.
- * Furthermore (and only for the case a viewbox needs to be computed), a `bleed`
- * attrib can be provided to include a bleed/margin for the viewbox.
+ * Creates a hiccup SVG doc element for given {@link IShape}s and attribs
+ * (merged with default attribs). If the attribs do not include a `viewBox`, it
+ * will be computed automatically. Furthermore (and only for the case a viewbox
+ * needs to be computed), a `bleed` attrib can be provided to include a
+ * bleed/margin for the viewbox.
  *
  * @remarks
  * Use {@link asSvg} to serialize the resulting doc to an SVG string.
@@ -19,6 +37,7 @@ export const asSvg = (...args) => args.map((x) => serialize(convertTree(x))).joi
  * @param xs
  */
 export const svgDoc = (attribs, ...xs) => {
+    attribs = { ...DEFAULT_ATTRIBS, ...attribs };
     if (xs.length > 0) {
         if (!attribs.viewBox) {
             const cbounds = __collBounds(xs, bounds);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@thi.ng/geom",
-  "version": "4.0.2",
+  "version": "4.1.0",
   "description": "Functional, polymorphic API for 2D geometry types & SVG generation",
   "type": "module",
   "module": "./index.js",
@@ -35,37 +35,37 @@
     "tool:bpatch": "tools:node-esm tools/bpatch.ts"
   },
   "dependencies": {
-    "@thi.ng/api": "^8.6.1",
-    "@thi.ng/arrays": "^2.4.6",
-    "@thi.ng/associative": "^6.2.20",
-    "@thi.ng/checks": "^3.3.5",
-    "@thi.ng/defmulti": "^2.1.25",
-    "@thi.ng/equiv": "^2.1.15",
-    "@thi.ng/errors": "^2.2.6",
-    "@thi.ng/geom-api": "^3.3.22",
-    "@thi.ng/geom-arc": "^2.1.40",
-    "@thi.ng/geom-clip-line": "^2.2.2",
-    "@thi.ng/geom-clip-poly": "^2.1.39",
-    "@thi.ng/geom-closest-point": "^2.1.36",
-    "@thi.ng/geom-hull": "^2.1.36",
-    "@thi.ng/geom-isec": "^2.1.39",
-    "@thi.ng/geom-poly-utils": "^2.3.23",
-    "@thi.ng/geom-resample": "^2.1.40",
-    "@thi.ng/geom-splines": "^2.2.14",
-    "@thi.ng/geom-subdiv-curve": "^2.1.39",
-    "@thi.ng/geom-tessellate": "^2.1.39",
-    "@thi.ng/hiccup": "^4.2.27",
-    "@thi.ng/hiccup-svg": "^4.3.25",
-    "@thi.ng/math": "^5.3.17",
-    "@thi.ng/matrices": "^2.1.37",
-    "@thi.ng/random": "^3.3.19",
-    "@thi.ng/strings": "^3.3.21",
-    "@thi.ng/transducers": "^8.3.27",
-    "@thi.ng/vectors": "^7.5.28"
+    "@thi.ng/api": "^8.6.2",
+    "@thi.ng/arrays": "^2.4.7",
+    "@thi.ng/associative": "^6.2.21",
+    "@thi.ng/checks": "^3.3.6",
+    "@thi.ng/defmulti": "^2.1.26",
+    "@thi.ng/equiv": "^2.1.16",
+    "@thi.ng/errors": "^2.2.7",
+    "@thi.ng/geom-api": "^3.3.23",
+    "@thi.ng/geom-arc": "^2.1.41",
+    "@thi.ng/geom-clip-line": "^2.2.3",
+    "@thi.ng/geom-clip-poly": "^2.1.40",
+    "@thi.ng/geom-closest-point": "^2.1.37",
+    "@thi.ng/geom-hull": "^2.1.37",
+    "@thi.ng/geom-isec": "^2.1.40",
+    "@thi.ng/geom-poly-utils": "^2.3.24",
+    "@thi.ng/geom-resample": "^2.1.41",
+    "@thi.ng/geom-splines": "^2.2.15",
+    "@thi.ng/geom-subdiv-curve": "^2.1.40",
+    "@thi.ng/geom-tessellate": "^2.1.40",
+    "@thi.ng/hiccup": "^4.2.28",
+    "@thi.ng/hiccup-svg": "^4.3.26",
+    "@thi.ng/math": "^5.3.18",
+    "@thi.ng/matrices": "^2.1.38",
+    "@thi.ng/random": "^3.3.20",
+    "@thi.ng/strings": "^3.3.22",
+    "@thi.ng/transducers": "^8.3.28",
+    "@thi.ng/vectors": "^7.5.29"
   },
   "devDependencies": {
     "@microsoft/api-extractor": "^7.33.7",
-    "@thi.ng/testament": "^0.3.7",
+    "@thi.ng/testament": "^0.3.8",
     "rimraf": "^3.0.2",
     "tools": "^0.0.1",
     "typedoc": "^0.23.22",
@@ -383,5 +383,5 @@
   "thi.ng": {
     "year": 2013
   },
-  "gitHead": "7b2af448da8a63fb21704a79cc4cdf1f3d7d7a64\n"
+  "gitHead": "bc6f7f5e2765bb96fe64db804eaf4b2443b47fc6\n"
 }