@thi.ng/rdom 1.5.0 → 1.5.1

package/CHANGELOG.md

@@ -1,6 +1,6 @@
 # Change Log
 
-- **Last updated**: 2024-07-03T08:50:04Z
+- **Last updated**: 2024-07-06T12:02:19Z
 - **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.
 
+### [1.5.1](https://github.com/thi-ng/umbrella/tree/@thi.ng/rdom@1.5.1) (2024-07-06)
+
+#### 🩹 Bug fixes
+
+- update $compile() handling of embedded functions ([#477](https://github.com/thi-ng/umbrella/issues/477)) ([5ac2831](https://github.com/thi-ng/umbrella/commit/5ac2831))
+  - add fn checks & branches to call embedded fn and compile its result
+  - update docs
+
 ## [1.5.0](https://github.com/thi-ng/umbrella/tree/@thi.ng/rdom@1.5.0) (2024-07-03)
 
 #### 🚀 Features

package/README.md

@@ -7,7 +7,7 @@
 [![Mastodon Follow](https://img.shields.io/mastodon/follow/109331703950160316?domain=https%3A%2F%2Fmastodon.thi.ng&style=social)](https://mastodon.thi.ng/@toxi)
 
 > [!NOTE]
-> This is one of 189 standalone projects, maintained as part
+> This is one of 188 standalone projects, maintained as part
 > of the [@thi.ng/umbrella](https://github.com/thi-ng/umbrella/) monorepo
 > and anti-framework.
 >
@@ -315,7 +315,7 @@ Browser ESM import:
 
 [JSDelivr documentation](https://www.jsdelivr.com/)
 
-Package sizes (brotli'd, pre-treeshake): ESM: 4.24 KB
+Package sizes (brotli'd, pre-treeshake): ESM: 4.27 KB
 
 ## Dependencies
 

package/compile.d.ts

@@ -13,6 +13,9 @@ import type { IComponent } from "./api.js";
  *   instances
  * - [`IDeref`](https://docs.thi.ng/umbrella/api/interfaces/IDeref.html)
  *   instances
+ * - functions embedded in hiccup, i.e. either:
+ *   - `[fn, ...args]`
+ *   - `["tag", {}, ... noArgFn ...]`
  *
  * Any other value type will be wrapped in a `<span>` element. Reactive
  * `ISubscribable` values can be used as element attributes or element
@@ -20,6 +23,10 @@ import type { IComponent } from "./api.js";
  * target attribute. If used as element body, the reactive value will be wrapped
  * using a {@link $sub} `<span>` with the value as its reactive body.
  *
+ * If given any of the supported embedded function forms, the function will be
+ * called with given args (or without) and the result passed back to
+ * `$compile()`.
+ *
  * **Important:** Use {@link $replace}, {@link $refresh} or {@link $switch} to
  * wrap any reactive values/subscriptions which produce actual HTML
  * elements/components/subtrees (in hiccup format). See docs for these functions

package/compile.js

@@ -1,5 +1,6 @@
 import { isArray } from "@thi.ng/checks/is-array";
 import { isAsyncIterable } from "@thi.ng/checks/is-async-iterable";
+import { isFunction } from "@thi.ng/checks/is-function";
 import { isPlainObject } from "@thi.ng/checks/is-plain-object";
 import { isSubscribable } from "@thi.ng/rstream/checks";
 import { $async, $asyncA } from "./async.js";
@@ -7,7 +8,7 @@ import { isComponent, isElement } from "./checks.js";
 import { $el, $remove, $tree } from "./dom.js";
 import { $SubA, $sub } from "./sub.js";
 import { $wrapEl, $wrapText } from "./wrap.js";
-const $compile = (tree) => isArray(tree) ? __isComplexComponent(tree) ? __complexComponent(tree) : __basicComponent(tree) : isComponent(tree) ? tree : isSubscribable(tree) ? $sub(tree, "span") : isAsyncIterable(tree) ? $async(tree, "span") : tree instanceof Element ? $wrapEl(tree) : $wrapText("span", null, tree);
+const $compile = (tree) => isArray(tree) ? isFunction(tree[0]) ? $compile(tree[0].apply(null, tree.slice(1))) : __isComplexComponent(tree) ? __complexComponent(tree) : __basicComponent(tree) : isComponent(tree) ? tree : isSubscribable(tree) ? $sub(tree, "span") : isAsyncIterable(tree) ? $async(tree, "span") : isFunction(tree) ? $compile(tree()) : tree instanceof Element ? $wrapEl(tree) : $wrapText("span", null, tree);
 const __walk = (f, x, path = []) => {
   if (isPlainObject(x)) {
     for (const k in x) {
@@ -26,7 +27,7 @@ const __isComplexComponent = (x) => {
       if (__isComplexComponent(x[i])) return true;
     }
   }
-  return isSubscribable(x) || isAsyncIterable(x) || isComponent(x) || isElement(x);
+  return isSubscribable(x) || isAsyncIterable(x) || isComponent(x) || isFunction(x) || isElement(x);
 };
 const __complexComponent = (tree) => ({
   async mount(parent, index = -1) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@thi.ng/rdom",
-  "version": "1.5.0",
+  "version": "1.5.1",
   "description": "Lightweight, reactive, VDOM-less UI/DOM components with async lifecycle and @thi.ng/hiccup compatible",
   "type": "module",
   "module": "./index.js",
@@ -37,20 +37,20 @@
     "tool:tangle": "../../node_modules/.bin/tangle src/**/*.ts"
   },
   "dependencies": {
-    "@thi.ng/api": "^8.11.4",
-    "@thi.ng/checks": "^3.6.6",
-    "@thi.ng/errors": "^2.5.9",
-    "@thi.ng/hiccup": "^5.2.3",
-    "@thi.ng/paths": "^5.1.83",
-    "@thi.ng/prefixes": "^2.3.21",
-    "@thi.ng/rstream": "^8.5.3",
-    "@thi.ng/strings": "^3.7.35"
+    "@thi.ng/api": "^8.11.5",
+    "@thi.ng/checks": "^3.6.7",
+    "@thi.ng/errors": "^2.5.10",
+    "@thi.ng/hiccup": "^5.2.4",
+    "@thi.ng/paths": "^5.1.84",
+    "@thi.ng/prefixes": "^2.3.22",
+    "@thi.ng/rstream": "^8.5.4",
+    "@thi.ng/strings": "^3.7.36"
   },
   "devDependencies": {
     "@microsoft/api-extractor": "^7.47.0",
-    "esbuild": "^0.21.5",
-    "typedoc": "^0.25.13",
-    "typescript": "^5.5.2"
+    "esbuild": "^0.23.0",
+    "typedoc": "^0.26.3",
+    "typescript": "^5.5.3"
   },
   "keywords": [
     "async",
@@ -145,5 +145,5 @@
     ],
     "year": 2020
   },
-  "gitHead": "4e1794f6c951adb73c27c3e6c08f7138d9445e8b\n"
+  "gitHead": "70f493d9ccc97c5df5dda7e808e96cd1691097fc\n"
 }