@thi.ng/hiccup 5.1.16 → 5.1.18

package/CHANGELOG.md

@@ -1,6 +1,6 @@
 # Change Log
 
-- **Last updated**: 2024-02-25T14:07:53Z
+- **Last updated**: 2024-03-02T14:05:52Z
 - **Generator**: [thi.ng/monopub](https://thi.ng/monopub)
 
 All notable changes to this project will be documented in this file.

package/README.md

@@ -1,16 +1,5 @@
 <!-- This file is generated - DO NOT EDIT! -->
 <!-- Please see: https://github.com/thi-ng/umbrella/blob/develop/CONTRIBUTING.md#changes-to-readme-files -->
-> [!IMPORTANT]
-> ‼️ Announcing the thi.ng user survey 2024 📋
->
-> [Please participate in the survey here!](https://forms.gle/XacbSDEmQMPZg8197)\
-> (open until end of February)
->
-> **To achieve a better sample size, I'd highly appreciate if you could
-> circulate the link to this survey in your own networks.**
->
-> [Discussion](https://github.com/thi-ng/umbrella/discussions/447)
-
 # ![@thi.ng/hiccup](https://media.thi.ng/umbrella/banners-20230807/thing-hiccup.svg?81af4609)
 
 [![npm version](https://img.shields.io/npm/v/@thi.ng/hiccup.svg)](https://www.npmjs.com/package/@thi.ng/hiccup)
@@ -22,7 +11,7 @@
 > of the [@thi.ng/umbrella](https://github.com/thi-ng/umbrella/) monorepo
 > and anti-framework.
 >
-> 🚀 Help me to work full-time on these projects by [sponsoring me on
+> 🚀 Please help me to work full-time on these projects by [sponsoring me on
 > GitHub](https://github.com/sponsors/postspectacular). Thank you! ❤️
 
 - [About](#about)
@@ -227,6 +216,8 @@ Tag names support
 style ID & class attribute expansion:
 
 ```ts
+import { serialize } from "@thi.ng/hiccup";
+
 serialize(
     ["div#yo.hello.world", "Look ma, ", ["strong", "no magic!"]]
 );
@@ -247,6 +238,8 @@ If the 2nd array element is not a plain object, it's treated as normal
 child node (see previous example).
 
 ```ts
+import { serialize } from "@thi.ng/hiccup";
+
 serialize(
     ["div.notice",
         {
@@ -299,6 +292,8 @@ Function values for event attributes (any attrib name starting with
 ### Simple components
 
 ```ts
+import { serialize } from "@thi.ng/hiccup";
+
 const thumb = (src) => ["img.thumb", { src, alt: "thumbnail" }];
 
 serialize(
@@ -326,6 +321,8 @@ The context object should contain any global component configuration,
 e.g. for theming purposes.
 
 ```ts
+import { serialize } from "@thi.ng/hiccup";
+
 const header = (ctx, body) =>
     ["h1", ctx.theme.title, body];
 
@@ -355,6 +352,8 @@ yourself. Likewise, if a component function doesn't make use of the context you
 can use either:
 
 ```ts
+import { serialize } from "@thi.ng/hiccup";
+
 // skip the context arg and require direct invocation
 const div = (attribs, body) => ["div", attribs, body];
 
@@ -365,6 +364,8 @@ serialize(div({id: "foo"}, "bar"));
 Or...
 
 ```ts
+import { serialize } from "@thi.ng/hiccup";
+
 // ignore the first arg (context) and support both direct & indirect calls
 const div = (_, attribs, body) => ["div", attribs, body];
 
@@ -578,7 +579,10 @@ Single or multiline comments can be included using the special `COMMENT`
 tag (`__COMMENT__`) (always WITHOUT attributes!).
 
 ```ts
+import { COMMENT } from "@thi.ng/hiccup";
+
 [COMMENT, "Hello world"]
+// serializes to:
 // <!-- Hello world -->
 
 [COMMENT, "Hello", "world"]
@@ -674,6 +678,8 @@ that function is called. The return value the function MUST be a valid
 new tree (or undefined).
 
 ```ts
+import { serialize } from "@thi.ng/hiccup";
+
 const foo = (ctx, a, b) => ["div#" + a, ctx.foo, b];
 
 serialize([foo, "id", "body"], { foo: { class: "black" } })

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@thi.ng/hiccup",
-  "version": "5.1.16",
+  "version": "5.1.18",
   "description": "HTML/SVG/XML serialization of nested data structures, iterables & closures",
   "type": "module",
   "module": "./index.js",
@@ -35,14 +35,14 @@
     "test": "bun test"
   },
   "dependencies": {
-    "@thi.ng/api": "^8.9.26",
-    "@thi.ng/checks": "^3.5.0",
-    "@thi.ng/errors": "^2.4.18",
-    "@thi.ng/strings": "^3.7.18"
+    "@thi.ng/api": "^8.9.27",
+    "@thi.ng/checks": "^3.5.1",
+    "@thi.ng/errors": "^2.4.19",
+    "@thi.ng/strings": "^3.7.20"
   },
   "devDependencies": {
     "@microsoft/api-extractor": "^7.40.1",
-    "@thi.ng/atom": "^5.2.33",
+    "@thi.ng/atom": "^5.2.35",
     "esbuild": "^0.20.0",
     "rimraf": "^5.0.5",
     "typedoc": "^0.25.7",
@@ -127,5 +127,5 @@
     ],
     "year": 2016
   },
-  "gitHead": "190d68e7f7524631b333cfdbf32c6a23be27c166\n"
+  "gitHead": "df9e312af741d87e6b450afcfea6a6e381662b1e\n"
 }

package/serialize.d.ts

@@ -100,6 +100,8 @@ export interface SerializeOpts {
  * interface.
  *
  * ```js
+ * import { serialize } from "@thi.ng/hiccup";
+ *
  * const foo = (ctx, a, b) => ["div#" + a, ctx.foo, b];
  *
  * serialize([foo, "id", "body"], { ctx: { foo: { class: "black" } } })
@@ -122,7 +124,10 @@ export interface SerializeOpts {
  * (`"__COMMENT__"`) (always WITHOUT attributes!).
  *
  * ```js
+ * import { COMMENT } from "@thi.ng/hiccup";
+ *
  * [COMMENT, "Hello world"]
+ * // serializes to:
  * // <!-- Hello world -->
  *
  * [COMMENT, "Hello", "world"]