@thi.ng/hiccup 5.0.9 → 5.1.0

package/CHANGELOG.md

@@ -1,6 +1,6 @@
 # Change Log
 
-- **Last updated**: 2023-12-03T12:13:31Z
+- **Last updated**: 2023-12-09T19:12:03Z
 - **Generator**: [thi.ng/monopub](https://thi.ng/monopub)
 
 All notable changes to this project will be documented in this file.
@@ -9,6 +9,18 @@ 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.
 
+## [5.1.0](https://github.com/thi-ng/umbrella/tree/@thi.ng/hiccup@5.1.0) (2023-12-09)
+
+#### 🚀 Features
+
+- allow `class` attrib as string array ([448edd0](https://github.com/thi-ng/umbrella/commit/448edd0))
+  - update mergeClasses()
+  - update docs & tests
+
+#### 🩹 Bug fixes
+
+- fix mergeClasses(), add tests ([c734794](https://github.com/thi-ng/umbrella/commit/c734794))
+
 ### [5.0.6](https://github.com/thi-ng/umbrella/tree/@thi.ng/hiccup@5.0.6) (2023-11-09)
 
 #### ♻️ Refactoring

package/README.md

@@ -173,7 +173,7 @@ For Node.js REPL:
 const hiccup = await import("@thi.ng/hiccup");
 ```
 
-Package sizes (brotli'd, pre-treeshake): ESM: 2.14 KB
+Package sizes (brotli'd, pre-treeshake): ESM: 2.17 KB
 
 ## Dependencies
 

package/attribs.d.ts

@@ -1,23 +1,28 @@
 /**
- * Takes a space separated string of existing CSS class names and merges
- * it with `val`, which is either another string of class names, an
- * object of booleans or an `IDeref` evaluating to either. Returns
- * updated class string.
+ * Takes a space separated string of existing CSS class names and merges it with
+ * `val`, which is either another string or string array of class names, an
+ * object of booleans or an `IDeref` evaluating to either. Returns updated class
+ * string.
  *
  * @remarks
  * If `val` evaluates to a string, it will be appended to `existing`.
  *
- * If `val` is an object, its keys are used as class names and their
- * values indicate if the class should be added or removed from the
- * existing set.
+ * If `val` is an array, it will be joined as space-separated string and
+ * concatenated to the existing one.
+ *
+ * If `val` is an object, its keys are used as class names and their values
+ * indicate if the class should be added or removed from the existing set.
  *
  * @example
  * ```ts
  * mergeClasses("foo bar", { foo: false, baz: true })
  * // "bar baz"
  *
+ * mergeClasses("foo", ["bar", "baz"]);
+ * // "foo bar baz"
+ *
  * mergeClasses("foo bar", "baz");
- * // "baz"
+ * // "foo bar baz"
  * ```
  *
  * @param existing -

package/attribs.js

@@ -1,25 +1,31 @@
 import { deref } from "@thi.ng/api/deref";
+import { isArray } from "@thi.ng/checks/is-array";
 import { isString } from "@thi.ng/checks/is-string";
 /**
- * Takes a space separated string of existing CSS class names and merges
- * it with `val`, which is either another string of class names, an
- * object of booleans or an `IDeref` evaluating to either. Returns
- * updated class string.
+ * Takes a space separated string of existing CSS class names and merges it with
+ * `val`, which is either another string or string array of class names, an
+ * object of booleans or an `IDeref` evaluating to either. Returns updated class
+ * string.
  *
  * @remarks
  * If `val` evaluates to a string, it will be appended to `existing`.
  *
- * If `val` is an object, its keys are used as class names and their
- * values indicate if the class should be added or removed from the
- * existing set.
+ * If `val` is an array, it will be joined as space-separated string and
+ * concatenated to the existing one.
+ *
+ * If `val` is an object, its keys are used as class names and their values
+ * indicate if the class should be added or removed from the existing set.
  *
  * @example
  * ```ts
  * mergeClasses("foo bar", { foo: false, baz: true })
  * // "bar baz"
  *
+ * mergeClasses("foo", ["bar", "baz"]);
+ * // "foo bar baz"
+ *
  * mergeClasses("foo bar", "baz");
- * // "baz"
+ * // "foo bar baz"
  * ```
  *
  * @param existing -
@@ -29,9 +35,11 @@ export const mergeClasses = (existing, val) => {
     val = deref(val);
     if (val == null)
         return existing;
+    if (isArray(val))
+        val = val.join(" ");
     if (isString(val))
-        return existing + " " + val;
-    const classes = new Set(existing.split(" "));
+        return existing ? existing + " " + val : val;
+    const classes = new Set(existing ? existing.split(" ") : undefined);
     for (let id in val) {
         deref(val[id]) ? classes.add(id) : classes.delete(id);
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@thi.ng/hiccup",
-  "version": "5.0.9",
+  "version": "5.1.0",
   "description": "HTML/SVG/XML serialization of nested data structures, iterables & closures",
   "type": "module",
   "module": "./index.js",
@@ -33,15 +33,14 @@
     "test": "bun test"
   },
   "dependencies": {
-    "@thi.ng/api": "^8.9.10",
-    "@thi.ng/checks": "^3.4.10",
-    "@thi.ng/errors": "^2.4.4",
-    "@thi.ng/strings": "^3.7.1"
+    "@thi.ng/api": "^8.9.11",
+    "@thi.ng/checks": "^3.4.11",
+    "@thi.ng/errors": "^2.4.5",
+    "@thi.ng/strings": "^3.7.2"
   },
   "devDependencies": {
     "@microsoft/api-extractor": "^7.38.3",
-    "@thi.ng/atom": "^5.2.16",
-    "@thi.ng/testament": "^0.4.3",
+    "@thi.ng/atom": "^5.2.17",
     "rimraf": "^5.0.5",
     "tools": "^0.0.1",
     "typedoc": "^0.25.4",
@@ -126,5 +125,5 @@
     ],
     "year": 2016
   },
-  "gitHead": "04d1de79f256d7a53c6b5fd157b37f49bc88e11d\n"
+  "gitHead": "25f2ac8ff795a432a930119661b364d4d93b59a0\n"
 }