🐛 (bs/docs) Fixes (non)exsting docs target

.github/workflows/static.yml

@@ -0,0 +1,48 @@
+# Simple workflow for deploying static content to GitHub Pages
+name: Deploy Docs
+
+on:
+  # Runs on pushes targeting the default branch
+  push:
+    branches: ["main"]
+
+  # Allows you to run this workflow manually from the Actions tab
+  workflow_dispatch:
+
+# Sets permissions of the GITHUB_TOKEN to allow deployment to GitHub Pages
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+# Allow only one concurrent deployment, skipping runs queued between the run in-progress and latest queued.
+# However, do NOT cancel in-progress runs as we want to allow these production deployments to complete.
+concurrency:
+  group: "pages"
+  cancel-in-progress: false
+
+jobs:
+  # Single deploy job since we're just deploying
+  deploy:
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 # v4
+      - uses: actions/setup-node@39370e3970a6d050c480ffad4ff0ed4d3fdee5af # v4.1.0
+        with:
+          node-version: 20.16
+      - run: npm ci
+      - run: bs/docs.js
+      - name: Setup Pages
+        uses: actions/configure-pages@983d7736d9b0ae728b81ab479565c72886d7745b # v5
+      - name: Upload artifact
+        uses: actions/upload-pages-artifact@56afc609e74202658d3ffba0e8f6dda462b719fa # v3
+        with:
+          # Upload entire repository
+          path: './dist/docs'
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@d6db90164ac5ed86f2b6aed7e0febac5b3c0c03e # v4

.gitignore

@@ -1,3 +1,4 @@
+dist/docs/
 # Logs
 logs
 *.log

bs/build.js

@@ -7,7 +7,7 @@ const css= echo.css`
 `;
 
 $.api("", true)
-.option("--minify", "Level of minification [ full, partial (default) ]")
+.option("--minify", "Level of minification [ no, full, partial (default) ]")
 .action(async function main({ minify= "partial" }){
 	for(const file_root of files){
 		const file= file_root+".js";
@@ -17,11 +17,11 @@ $.api("", true)
 			"npx esbuild '::file::'",
 			"--platform=neutral",
 			"--bundle",
-			minify==="full" ? "--minify" : "--minify-syntax --minify-identifiers",
+			minifyOption(minify),
 			"--legal-comments=inline",
 			"--packages=external",
 			"--outfile='::out::'"
-		].join(" "), { file, out });
+		].filter(Boolean).join(" "), { file, out });
 		if(esbuild_output.code)
 			return $.exit(esbuild_output.code, echo(esbuild_output.stderr));
 		echoVariant(esbuild_output.stderr.split("\n")[1].trim()+ " (esbuild)");
@@ -57,6 +57,12 @@ $.api("", true)
 })
 .parse();
 
+/** @param {"no"|"full"|"partial"} level */
+function minifyOption(level= "partial"){
+	if("no"===level) return undefined;
+	if("full"===level) return "--minify";
+	return "--minify-syntax --minify-identifiers";
+}
 function echoVariant(name){
 	return echo("%c✓ "+name, css.info+css);
 }

bs/docs.js

@@ -1,14 +1,21 @@
-#!/usr/bin/env nodejsscript
+#!/usr/bin/env -S npx nodejsscript
 /* jshint esversion: 11,-W097, -W040, module: true, node: true, expr: true, undef: true *//* global echo, $, pipe, s, fetch, cyclicLoop */
 echo("Building static documentation files…");
 echo("Preparing…");
-import { path_target, pages as pages_registered, styles, dispatchEvent } from "../docs_src/ssr.js";
+import { path_target, pages as pages_registered, styles, dispatchEvent, t } from "../docs/ssr.js";
 import { createHTMl } from "./docs/jsdom.js";
 import { register } from "../jsdom.js";
 const pkg= s.cat("package.json").xargs(JSON.parse);
 
+if(s.test("-d", path_target.root)){
+	echo("Removing old files…");
+	s.rm("-rf", path_target.root+"*");
+} else {
+	echo("Creating directory…");
+	s.mkdir("-p", path_target.root);
+}
 echo("Collecting list of pages…");
-const pages= s.ls($.xdg.main`../docs_src/*.html.js`).map(addPage);
+const pages= s.ls($.xdg.main`../docs/*.html.js`).map(addPage);
 for(const { id, info } of pages){
 	echo(`Generating ${id}.html…`);
 	const serverDOM= createHTMl("");
@@ -16,7 +23,7 @@ for(const { id, info } of pages){
 		"HTMLScriptElement"
 	);
 	const { el }= await register(serverDOM.dom);
-	const { page }= await import(`../docs_src/${id}.html.js`);
+	const { page }= await import(`../docs/${id}.html.js`);
 	serverDOM.document.body.append(
 		el(page, { pkg, info }),
 	);

dist/dde-with-signals.js

@@ -61,7 +61,7 @@ function lt(t, e, n) {
 			return Reflect.set(t, e, "");
 	}
 }
-var C = "__dde_lifecyclesToEvents", _ = "dde:connected", O = "dde:disconnected", M = "dde:attributeChanged";
+var O = "__dde_lifecyclesToEvents", _ = "dde:connected", C = "dde:disconnected", M = "dde:attributeChanged";
 
 // src/dom.js
 var A = [{
@@ -102,50 +102,50 @@ function ht(t) {
 	return t.append === Y || (t.appendOriginal = t.append, t.append = Y), t;
 }
 var $;
-function j(t, e, ...n) {
+function P(t, e, ...n) {
 	let r = W(this), o = 0, c, i;
 	switch ((Object(e) !== e || r.isSignal(e)) && (e = { textContent: e }), !0) {
 		case typeof t == "function": {
-			o = 1, m.push({ scope: t, host: (...v) => v.length ? (o === 1 ? n.unshift(...v) : v.forEach((l) => l(i)), void 0) : i }), c = t(e || void 0);
+			o = 1, m.push({ scope: t, host: (...v) => v.length ? (o === 1 ? n.unshift(...v) : v.forEach((h) => h(i)), void 0) : i }), c = t(e || void 0);
 			let a = c instanceof d.F;
-			if (c.nodeName === "#comment")
-				break;
-			let h = j.mark({
+			if (c.nodeName === "#comment") break;
+			let l = P.mark({
 				type: "component",
 				name: t.name,
 				host: a ? "this" : "parentElement"
 			});
-			c.prepend(h), a && (i = h);
+			c.prepend(l), a && (i = l);
 			break;
 		}
 		case t === "#text":
-			c = P.call(this, d.D.createTextNode(""), e);
+			c = j.call(this, d.D.createTextNode(""), e);
 			break;
 		case (t === "<>" || !t):
-			c = P.call(this, d.D.createDocumentFragment(), e);
+			c = j.call(this, d.D.createDocumentFragment(), e);
 			break;
 		case !!$:
-			c = P.call(this, d.D.createElementNS($, t), e);
+			c = j.call(this, d.D.createElementNS($, t), e);
 			break;
 		case !c:
-			c = P.call(this, d.D.createElement(t), e);
+			c = j.call(this, d.D.createElement(t), e);
 	}
 	return ht(c), i || (i = c), n.forEach((a) => a(i)), o && m.pop(), o = 2, c;
 }
-function Wt(t, e = t, n = void 0) {
+function Wt(t, e, n) {
+	typeof e != "object" && (n = e, e = t);
 	let r = Symbol.for("default"), o = Array.from(e.querySelectorAll("slot")).reduce((i, a) => Reflect.set(i, a.name || r, a) && i, {}), c = T(o, r);
 	if (t.append = new Proxy(t.append, {
-		apply(i, a, h) {
-			if (!h.length)
-				return t;
+		apply(i, a, l) {
+			if (l[0] === e) return i.apply(t, l);
+			if (!l.length) return t;
 			let v = d.D.createDocumentFragment();
-			for (let l of h) {
-				if (!l || !l.slot) {
-					c && v.appendChild(l);
+			for (let h of l) {
+				if (!h || !h.slot) {
+					c && v.append(h);
 					continue;
 				}
-				let x = l.slot, y = o[x];
-				vt(l, "remove", "slot"), y && (bt(y, l, n), Reflect.deleteProperty(o, x));
+				let x = h.slot, w = o[x];
+				vt(h, "remove", "slot"), w && (bt(w, h, n), Reflect.deleteProperty(o, x));
 			}
 			return c && (o[r].replaceWith(v), Reflect.deleteProperty(o, r)), t.append = i, t;
 		}
@@ -158,12 +158,12 @@ function Wt(t, e = t, n = void 0) {
 function bt(t, e, n) {
 	n && n(t, e);
 	try {
-		t.replaceWith(P(e, { className: [e.className, t.className], dataset: { ...t.dataset } }));
+		t.replaceWith(j(e, { className: [e.className, t.className], dataset: { ...t.dataset } }));
 	} catch {
 		t.replaceWith(e);
 	}
 }
-j.mark = function(t, e = !1) {
+P.mark = function(t, e = !1) {
 	t = Object.entries(t).map(([o, c]) => o + `="${c}"`).join(" ");
 	let n = e ? "" : "/", r = d.D.createComment(`<dde:mark ${t}${d.ssr}${n}>`);
 	return e && (r.end = d.D.createComment("</dde:mark>")), r;
@@ -172,14 +172,13 @@ function qt(t) {
 	let e = this;
 	return function(...r) {
 		$ = t;
-		let o = j.call(e, ...r);
+		let o = P.call(e, ...r);
 		return $ = void 0, o;
 	};
 }
 var U = /* @__PURE__ */ new WeakMap(), { setDeleteAttr: tt } = d;
-function P(t, ...e) {
-	if (!e.length)
-		return t;
+function j(t, ...e) {
+	if (!e.length) return t;
 	U.set(t, rt(t, this));
 	for (let [n, r] of Object.entries(Object.assign({}, ...e)))
 		nt.call(this, t, n, r);
@@ -191,13 +190,11 @@ function nt(t, e, n) {
 		t,
 		e,
 		n,
-		(a, h) => nt.call(c, t, a, h)
+		(a, l) => nt.call(c, t, a, l)
 	);
 	let [i] = e;
-	if (i === "=")
-		return r(e.slice(1), n);
-	if (i === ".")
-		return et(t, e.slice(1), n);
+	if (i === "=") return r(e.slice(1), n);
+	if (i === ".") return et(t, e.slice(1), n);
 	if (/(aria|data)([A-Z])/.test(e))
 		return e = e.replace(/([a-z])([A-Z])/g, "$1-$2").toLowerCase(), r(e, n);
 	switch (e === "className" && (e = "class"), e) {
@@ -206,20 +203,19 @@ function nt(t, e, n) {
 		case "textContent":
 			return tt(t, e, n);
 		case "style":
-			if (typeof n != "object")
-				break;
+			if (typeof n != "object") break;
+		/* falls through */
 		case "dataset":
 			return I(o, n, et.bind(null, t[e]));
 		case "ariaset":
-			return I(o, n, (a, h) => r("aria-" + a, h));
+			return I(o, n, (a, l) => r("aria-" + a, l));
 		case "classList":
 			return gt.call(c, t, n);
 	}
 	return Et(t, e) ? tt(t, e, n) : r(e, n);
 }
 function rt(t, e) {
-	if (U.has(t))
-		return U.get(t);
+	if (U.has(t)) return U.get(t);
 	let r = (t instanceof d.S ? xt : mt).bind(null, t, "Attribute"), o = W(e);
 	return { setRemoveAttr: r, s: o };
 }
@@ -238,14 +234,12 @@ function vt(t, e, n, r) {
 	return t instanceof d.H ? t[e + "Attribute"](n, r) : t[e + "AttributeNS"](null, n, r);
 }
 function Et(t, e) {
-	if (!(e in t))
-		return !1;
+	if (!(e in t)) return !1;
 	let n = ot(t, e);
 	return !S(n.set);
 }
 function ot(t, e) {
-	if (t = Object.getPrototypeOf(t), !t)
-		return {};
+	if (t = Object.getPrototypeOf(t), !t) return {};
 	let n = Object.getOwnPropertyDescriptor(t, e);
 	return n || ot(t, e);
 }
@@ -270,17 +264,17 @@ function et(t, e, n) {
 }
 
 // src/events-observer.js
-var D = d.M ? wt() : new Proxy({}, {
+var D = d.M ? yt() : new Proxy({}, {
 	get() {
 		return () => {
 		};
 	}
 });
-function wt() {
+function yt() {
 	let t = /* @__PURE__ */ new Map(), e = !1, n = (s) => function(u) {
 		for (let f of u)
 			if (f.type === "childList") {
-				if (l(f.addedNodes, !0)) {
+				if (h(f.addedNodes, !0)) {
 					s();
 					continue;
 				}
@@ -299,8 +293,7 @@ function wt() {
 			f.connected.has(u) || (f.connected.add(u), f.length_c += 1);
 		},
 		offConnected(s, u) {
-			if (!t.has(s))
-				return;
+			if (!t.has(s)) return;
 			let f = t.get(s);
 			f.connected.has(u) && (f.connected.delete(u), f.length_c -= 1, o(s, f));
 		},
@@ -310,8 +303,7 @@ function wt() {
 			f.disconnected.has(u) || (f.disconnected.add(u), f.length_d += 1);
 		},
 		offDisconnected(s, u) {
-			if (!t.has(s))
-				return;
+			if (!t.has(s)) return;
 			let f = t.get(s);
 			f.disconnected.has(u) && (f.disconnected.delete(u), f.length_d -= 1, o(s, f));
 		}
@@ -320,8 +312,7 @@ function wt() {
 		u.length_c || u.length_d || (t.delete(s), a());
 	}
 	function c(s) {
-		if (t.has(s))
-			return t.get(s);
+		if (t.has(s)) return t.get(s);
 		let u = {
 			connected: /* @__PURE__ */ new WeakSet(),
 			length_c: 0,
@@ -336,25 +327,23 @@ function wt() {
 	function a() {
 		!e || t.size || (e = !1, r.disconnect());
 	}
-	function h() {
+	function l() {
 		return new Promise(function(s) {
 			(requestIdleCallback || requestAnimationFrame)(s);
 		});
 	}
 	async function v(s) {
-		t.size > 30 && await h();
+		t.size > 30 && await l();
 		let u = [];
-		if (!(s instanceof Node))
-			return u;
+		if (!(s instanceof Node)) return u;
 		for (let f of t.keys())
 			f === s || !(f instanceof Node) || s.contains(f) && u.push(f);
 		return u;
 	}
-	function l(s, u) {
+	function h(s, u) {
 		let f = !1;
 		for (let b of s) {
-			if (u && v(b).then(l), !t.has(b))
-				continue;
+			if (u && v(b).then(h), !t.has(b)) continue;
 			let N = t.get(b);
 			N.length_c && (b.dispatchEvent(new Event(_)), N.connected = /* @__PURE__ */ new WeakSet(), N.length_c = 0, N.length_d || t.delete(b), f = !0);
 		}
@@ -363,12 +352,12 @@ function wt() {
 	function x(s, u) {
 		let f = !1;
 		for (let b of s)
-			u && v(b).then(x), !(!t.has(b) || !t.get(b).length_d) && ((globalThis.queueMicrotask || setTimeout)(y(b)), f = !0);
+			u && v(b).then(x), !(!t.has(b) || !t.get(b).length_d) && ((globalThis.queueMicrotask || setTimeout)(w(b)), f = !0);
 		return f;
 	}
-	function y(s) {
+	function w(s) {
 		return () => {
-			s.isConnected || (s.dispatchEvent(new Event(O)), t.delete(s));
+			s.isConnected || (s.dispatchEvent(new Event(C)), t.delete(s));
 		};
 	}
 }
@@ -379,24 +368,24 @@ function Zt(t, e, n, r = _t) {
 		scope: t,
 		host: (...i) => i.length ? i.forEach((a) => a(t)) : t
 	}), typeof r == "function" && (r = r.call(t, t));
-	let o = t[C];
-	o || yt(t);
+	let o = t[O];
+	o || wt(t);
 	let c = n.call(t, r);
-	return o || t.dispatchEvent(new Event(_)), e.nodeType === 11 && typeof e.mode == "string" && t.addEventListener(O, D.observe(e), { once: !0 }), m.pop(), e.append(c);
+	return o || t.dispatchEvent(new Event(_)), e.nodeType === 11 && typeof e.mode == "string" && t.addEventListener(C, D.observe(e), { once: !0 }), m.pop(), e.append(c);
 }
-function yt(t) {
+function wt(t) {
 	return J(t.prototype, "connectedCallback", function(e, n, r) {
 		e.apply(n, r), n.dispatchEvent(new Event(_));
 	}), J(t.prototype, "disconnectedCallback", function(e, n, r) {
 		e.apply(n, r), (globalThis.queueMicrotask || setTimeout)(
-			() => !n.isConnected && n.dispatchEvent(new Event(O))
+			() => !n.isConnected && n.dispatchEvent(new Event(C))
 		);
 	}), J(t.prototype, "attributeChangedCallback", function(e, n, r) {
 		let [o, , c] = r;
 		n.dispatchEvent(new CustomEvent(M, {
 			detail: [o, c]
 		})), e.apply(n, r);
-	}), t.prototype[C] = !0, t;
+	}), t.prototype[O] = !0, t;
 }
 function J(t, e, n) {
 	t[e] = new Proxy(t[e] || (() => {
@@ -414,38 +403,36 @@ function Qt(t, e, n) {
 		return o.dispatchEvent(i);
 	};
 }
-function w(t, e, n) {
+function y(t, e, n) {
 	return function(o) {
 		return o.addEventListener(t, e, n), o;
 	};
 }
 var it = (t) => Object.assign({}, typeof t == "object" ? t : null, { once: !0 });
-w.connected = function(t, e) {
+y.connected = function(t, e) {
 	return e = it(e), function(r) {
-		return r.addEventListener(_, t, e), r[C] ? r : r.isConnected ? (r.dispatchEvent(new Event(_)), r) : (q(e.signal, () => D.offConnected(r, t)) && D.onConnected(r, t), r);
+		return r.addEventListener(_, t, e), r[O] ? r : r.isConnected ? (r.dispatchEvent(new Event(_)), r) : (q(e.signal, () => D.offConnected(r, t)) && D.onConnected(r, t), r);
 	};
 };
-w.disconnected = function(t, e) {
+y.disconnected = function(t, e) {
 	return e = it(e), function(r) {
-		return r.addEventListener(O, t, e), r[C] || q(e.signal, () => D.offDisconnected(r, t)) && D.onDisconnected(r, t), r;
+		return r.addEventListener(C, t, e), r[O] || q(e.signal, () => D.offDisconnected(r, t)) && D.onDisconnected(r, t), r;
 	};
 };
 var Z = /* @__PURE__ */ new WeakMap();
-w.disconnectedAsAbort = function(t) {
-	if (Z.has(t))
-		return Z.get(t);
+y.disconnectedAsAbort = function(t) {
+	if (Z.has(t)) return Z.get(t);
 	let e = new AbortController();
-	return Z.set(t, e), t(w.disconnected(() => e.abort())), e;
+	return Z.set(t, e), t(y.disconnected(() => e.abort())), e;
 };
 var At = /* @__PURE__ */ new WeakSet();
-w.attributeChanged = function(t, e) {
+y.attributeChanged = function(t, e) {
 	return typeof e != "object" && (e = {}), function(r) {
-		if (r.addEventListener(M, t, e), r[C] || At.has(r) || !d.M)
-			return r;
+		if (r.addEventListener(M, t, e), r[O] || At.has(r) || !d.M) return r;
 		let o = new d.M(function(i) {
-			for (let { attributeName: a, target: h } of i)
-				h.dispatchEvent(
-					new CustomEvent(M, { detail: [a, h.getAttribute(a)] })
+			for (let { attributeName: a, target: l } of i)
+				l.dispatchEvent(
+					new CustomEvent(M, { detail: [a, l.getAttribute(a)] })
 				);
 		});
 		return q(e.signal, () => o.disconnect()) && o.observe(r, { attributes: !0 }), r;
@@ -465,12 +452,10 @@ var H = [], g = /* @__PURE__ */ new WeakMap();
 function E(t, e) {
 	if (typeof t != "function")
 		return st(!1, t, e);
-	if (z(t))
-		return t;
+	if (z(t)) return t;
 	let n = st(!0), r = function() {
 		let [o, ...c] = g.get(r);
-		if (g.set(r, /* @__PURE__ */ new Set([o])), H.push(r), dt(n, t()), H.pop(), !c.length)
-			return;
+		if (g.set(r, /* @__PURE__ */ new Set([o])), H.push(r), dt(n, t()), H.pop(), !c.length) return;
 		let i = g.get(r);
 		for (let a of c)
 			i.has(a) || L(a, r);
@@ -481,15 +466,13 @@ E.action = function(t, e, ...n) {
 	let r = t[p], { actions: o } = r;
 	if (!o || !(e in o))
 		throw new Error(`'${t}' has no action with name '${e}'!`);
-	if (o[e].apply(r, n), r.skip)
-		return delete r.skip;
+	if (o[e].apply(r, n), r.skip) return delete r.skip;
 	r.listeners.forEach((c) => c(r.value));
 };
 E.on = function t(e, n, r = {}) {
 	let { signal: o } = r;
 	if (!(o && o.aborted)) {
-		if (Array.isArray(e))
-			return e.forEach((c) => t(c, n, r));
+		if (Array.isArray(e)) return e.forEach((c) => t(c, n, r));
 		Q(e, n), o && o.addEventListener("abort", () => L(e, n));
 	}
 };
@@ -504,8 +487,7 @@ E.clear = function(...t) {
 	}
 	function e(n, r) {
 		r.listeners.forEach((o) => {
-			if (r.listeners.delete(o), !g.has(o))
-				return;
+			if (r.listeners.delete(o), !g.has(o)) return;
 			let c = g.get(o);
 			c.delete(n), !(c.size > 1) && (n.clear(...c), g.delete(o));
 		});
@@ -513,23 +495,23 @@ E.clear = function(...t) {
 };
 var R = "__dde_reactive";
 E.el = function(t, e) {
-	let n = j.mark({ type: "reactive" }, !0), r = n.end, o = d.D.createDocumentFragment();
+	let n = P.mark({ type: "reactive" }, !0), r = n.end, o = d.D.createDocumentFragment();
 	o.append(n, r);
-	let { current: c } = m, i = {}, a = (h) => {
+	let { current: c } = m, i = {}, a = (l) => {
 		if (!n.parentNode || !r.parentNode)
 			return L(t, a);
 		let v = i;
 		i = {}, m.push(c);
-		let l = e(h, function(u, f) {
+		let h = e(l, function(u, f) {
 			let b;
 			return T(v, u) ? (b = v[u], delete v[u]) : b = f(), i[u] = b, b;
 		});
-		m.pop(), Array.isArray(l) || (l = [l]);
+		m.pop(), Array.isArray(h) || (h = [h]);
 		let x = document.createComment("");
-		l.push(x), n.after(...l);
-		let y;
-		for (; (y = x.nextSibling) && y !== r; )
-			y.remove();
+		h.push(x), n.after(...h);
+		let w;
+		for (; (w = x.nextSibling) && w !== r; )
+			w.remove();
 		x.remove(), n.isConnected && St(c.host());
 	};
 	return Q(t, a), ft(t, a, n, e), a(t()), o;
@@ -539,27 +521,26 @@ function St(t) {
 		t[R] = t[R].filter(([e, n]) => n.isConnected ? !0 : (L(...e), !1));
 	});
 }
-var Ct = {
+var Ot = {
 	_set(t) {
 		this.value = t;
 	}
 };
-function Ot(t) {
+function Ct(t) {
 	return function(e, n) {
-		let r = (...c) => c.length ? e.setAttribute(n, ...c) : K(r), o = at(r, e.getAttribute(n), Ct);
+		let r = (...c) => c.length ? e.setAttribute(n, ...c) : K(r), o = at(r, e.getAttribute(n), Ot);
 		return t[n] = o, o;
 	};
 }
 var G = "__dde_attributes";
 E.observedAttributes = function(t) {
-	let e = t[G] = {}, n = F(t, Ot(e));
-	return w.attributeChanged(function({ detail: o }) {
+	let e = t[G] = {}, n = F(t, Ct(e));
+	return y.attributeChanged(function({ detail: o }) {
 		/*! This maps attributes to signals (`S.observedAttributes`).
 			* Investigate `__dde_attributes` key of the element.*/
 		let [c, i] = o, a = this[G][c];
-		if (a)
-			return E.action(a, "_set", i);
-	})(t), w.disconnected(function() {
+		if (a) return E.action(a, "_set", i);
+	})(t), y.disconnected(function() {
 		/*! This removes all signals mapped to attributes (`S.observedAttributes`).
 			* Investigate `__dde_attributes` key of the element.*/
 		E.clear(...Object.values(this[G]));
@@ -568,8 +549,7 @@ E.observedAttributes = function(t) {
 var ut = {
 	isSignal: z,
 	processReactiveAttribute(t, e, n, r) {
-		if (!z(n))
-			return n;
+		if (!z(n)) return n;
 		let o = (c) => {
 			if (!t.isConnected)
 				return L(n, o);
@@ -581,7 +561,7 @@ var ut = {
 function ft(t, e, ...n) {
 	let { current: r } = m;
 	r.prevent || r.host(function(o) {
-		o[R] || (o[R] = [], w.disconnected(
+		o[R] || (o[R] = [], y.disconnected(
 			() => (
 				/*!
 				* Clears all Signals listeners added in the current scope/host (`S.el`, `assign`, …?).
@@ -633,14 +613,12 @@ function Rt() {
 	return H[H.length - 1];
 }
 function K(t) {
-	if (!t[p])
-		return;
+	if (!t[p]) return;
 	let { value: e, listeners: n } = t[p], r = Rt();
 	return r && n.add(r), g.has(r) && g.get(r).add(t), e;
 }
 function dt(t, e, n) {
-	if (!t[p])
-		return;
+	if (!t[p]) return;
 	let r = t[p];
 	if (!(!n && r.value === e))
 		return r.value = e, r.listeners.forEach((o) => o(e)), e;
@@ -651,15 +629,12 @@ function Q(t, e) {
 }
 function L(t, e, n) {
 	let r = t[p];
-	if (!r)
-		return;
+	if (!r) return;
 	let o = r.listeners.delete(e);
 	if (n && !r.listeners.size) {
-		if (E.clear(t), !g.has(r))
-			return o;
+		if (E.clear(t), !g.has(r)) return o;
 		let c = g.get(r);
-		if (!g.has(c))
-			return o;
+		if (!g.has(c)) return o;
 		g.get(c).forEach((i) => L(i, c, !0));
 	}
 	return o;
@@ -670,23 +645,23 @@ B(ut);
 
 globalThis.dde= {
 	S: E,
-	assign: P,
+	assign: j,
 	assignAttribute: nt,
 	chainableAppend: ht,
 	classListDeclarative: gt,
-	createElement: j,
+	createElement: P,
 	createElementNS: qt,
 	customElementRender: Zt,
-	customElementWithDDE: yt,
+	customElementWithDDE: wt,
 	dispatchEvent: Qt,
-	el: j,
+	el: P,
 	elNS: qt,
 	elementAttribute: vt,
 	empty: Ft,
 	isSignal: z,
-	lifecyclesToEvents: yt,
+	lifecyclesToEvents: wt,
 	observedAttributes: _t,
-	on: w,
+	on: y,
 	registerReactivity: B,
 	scope: m,
 	signal: E,

dist/dde.js

@@ -98,15 +98,14 @@ function Q(t) {
 	return t.append === $ || (t.appendOriginal = t.append, t.append = $), t;
 }
 var T;
-function k(t, e, ...n) {
+function j(t, e, ...n) {
 	let r = L(this), o = 0, c, f;
 	switch ((Object(e) !== e || r.isSignal(e)) && (e = { textContent: e }), !0) {
 		case typeof t == "function": {
-			o = 1, S.push({ scope: t, host: (...b) => b.length ? (o === 1 ? n.unshift(...b) : b.forEach((l) => l(f)), void 0) : f }), c = t(e || void 0);
+			o = 1, S.push({ scope: t, host: (...b) => b.length ? (o === 1 ? n.unshift(...b) : b.forEach((h) => h(f)), void 0) : f }), c = t(e || void 0);
 			let d = c instanceof a.F;
-			if (c.nodeName === "#comment")
-				break;
-			let p = k.mark({
+			if (c.nodeName === "#comment") break;
+			let p = j.mark({
 				type: "component",
 				name: t.name,
 				host: d ? "this" : "parentElement"
@@ -128,20 +127,21 @@ function k(t, e, ...n) {
 	}
 	return Q(c), f || (f = c), n.forEach((d) => d(f)), o && S.pop(), o = 2, c;
 }
-function bt(t, e = t, n = void 0) {
+function bt(t, e, n) {
+	typeof e != "object" && (n = e, e = t);
 	let r = Symbol.for("default"), o = Array.from(e.querySelectorAll("slot")).reduce((f, d) => Reflect.set(f, d.name || r, d) && f, {}), c = q(o, r);
 	if (t.append = new Proxy(t.append, {
 		apply(f, d, p) {
-			if (!p.length)
-				return t;
+			if (p[0] === e) return f.apply(t, p);
+			if (!p.length) return t;
 			let b = a.D.createDocumentFragment();
-			for (let l of p) {
-				if (!l || !l.slot) {
-					c && b.appendChild(l);
+			for (let h of p) {
+				if (!h || !h.slot) {
+					c && b.append(h);
 					continue;
 				}
-				let A = l.slot, _ = o[A];
-				tt(l, "remove", "slot"), _ && (X(_, l, n), Reflect.deleteProperty(o, A));
+				let A = h.slot, _ = o[A];
+				tt(h, "remove", "slot"), _ && (X(_, h, n), Reflect.deleteProperty(o, A));
 			}
 			return c && (o[r].replaceWith(b), Reflect.deleteProperty(o, r)), t.append = f, t;
 		}
@@ -159,7 +159,7 @@ function X(t, e, n) {
 		t.replaceWith(e);
 	}
 }
-k.mark = function(t, e = !1) {
+j.mark = function(t, e = !1) {
 	t = Object.entries(t).map(([o, c]) => o + `="${c}"`).join(" ");
 	let n = e ? "" : "/", r = a.D.createComment(`<dde:mark ${t}${a.ssr}${n}>`);
 	return e && (r.end = a.D.createComment("</dde:mark>")), r;
@@ -168,14 +168,13 @@ function gt(t) {
 	let e = this;
 	return function(...r) {
 		T = t;
-		let o = k.call(e, ...r);
+		let o = j.call(e, ...r);
 		return T = void 0, o;
 	};
 }
 var P = /* @__PURE__ */ new WeakMap(), { setDeleteAttr: U } = a;
 function O(t, ...e) {
-	if (!e.length)
-		return t;
+	if (!e.length) return t;
 	P.set(t, B(t, this));
 	for (let [n, r] of Object.entries(Object.assign({}, ...e)))
 		z.call(this, t, n, r);
@@ -190,10 +189,8 @@ function z(t, e, n) {
 		(d, p) => z.call(c, t, d, p)
 	);
 	let [f] = e;
-	if (f === "=")
-		return r(e.slice(1), n);
-	if (f === ".")
-		return H(t, e.slice(1), n);
+	if (f === "=") return r(e.slice(1), n);
+	if (f === ".") return H(t, e.slice(1), n);
 	if (/(aria|data)([A-Z])/.test(e))
 		return e = e.replace(/([a-z])([A-Z])/g, "$1-$2").toLowerCase(), r(e, n);
 	switch (e === "className" && (e = "class"), e) {
@@ -202,8 +199,8 @@ function z(t, e, n) {
 		case "textContent":
 			return U(t, e, n);
 		case "style":
-			if (typeof n != "object")
-				break;
+			if (typeof n != "object") break;
+		/* falls through */
 		case "dataset":
 			return M(o, n, H.bind(null, t[e]));
 		case "ariaset":
@@ -214,8 +211,7 @@ function z(t, e, n) {
 	return et(t, e) ? U(t, e, n) : r(e, n);
 }
 function B(t, e) {
-	if (P.has(t))
-		return P.get(t);
+	if (P.has(t)) return P.get(t);
 	let r = (t instanceof a.S ? rt : nt).bind(null, t, "Attribute"), o = L(e);
 	return { setRemoveAttr: r, s: o };
 }
@@ -234,14 +230,12 @@ function tt(t, e, n, r) {
 	return t instanceof a.H ? t[e + "Attribute"](n, r) : t[e + "AttributeNS"](null, n, r);
 }
 function et(t, e) {
-	if (!(e in t))
-		return !1;
+	if (!(e in t)) return !1;
 	let n = I(t, e);
 	return !E(n.set);
 }
 function I(t, e) {
-	if (t = Object.getPrototypeOf(t), !t)
-		return {};
+	if (t = Object.getPrototypeOf(t), !t) return {};
 	let n = Object.getOwnPropertyDescriptor(t, e);
 	return n || I(t, e);
 }
@@ -276,7 +270,7 @@ function ot() {
 	let t = /* @__PURE__ */ new Map(), e = !1, n = (i) => function(u) {
 		for (let s of u)
 			if (s.type === "childList") {
-				if (l(s.addedNodes, !0)) {
+				if (h(s.addedNodes, !0)) {
 					i();
 					continue;
 				}
@@ -295,8 +289,7 @@ function ot() {
 			s.connected.has(u) || (s.connected.add(u), s.length_c += 1);
 		},
 		offConnected(i, u) {
-			if (!t.has(i))
-				return;
+			if (!t.has(i)) return;
 			let s = t.get(i);
 			s.connected.has(u) && (s.connected.delete(u), s.length_c -= 1, o(i, s));
 		},
@@ -306,8 +299,7 @@ function ot() {
 			s.disconnected.has(u) || (s.disconnected.add(u), s.length_d += 1);
 		},
 		offDisconnected(i, u) {
-			if (!t.has(i))
-				return;
+			if (!t.has(i)) return;
 			let s = t.get(i);
 			s.disconnected.has(u) && (s.disconnected.delete(u), s.length_d -= 1, o(i, s));
 		}
@@ -316,8 +308,7 @@ function ot() {
 		u.length_c || u.length_d || (t.delete(i), d());
 	}
 	function c(i) {
-		if (t.has(i))
-			return t.get(i);
+		if (t.has(i)) return t.get(i);
 		let u = {
 			connected: /* @__PURE__ */ new WeakSet(),
 			length_c: 0,
@@ -340,26 +331,24 @@ function ot() {
 	async function b(i) {
 		t.size > 30 && await p();
 		let u = [];
-		if (!(i instanceof Node))
-			return u;
+		if (!(i instanceof Node)) return u;
 		for (let s of t.keys())
 			s === i || !(s instanceof Node) || i.contains(s) && u.push(s);
 		return u;
 	}
-	function l(i, u) {
+	function h(i, u) {
 		let s = !1;
-		for (let h of i) {
-			if (u && b(h).then(l), !t.has(h))
-				continue;
-			let m = t.get(h);
-			m.length_c && (h.dispatchEvent(new Event(g)), m.connected = /* @__PURE__ */ new WeakSet(), m.length_c = 0, m.length_d || t.delete(h), s = !0);
+		for (let l of i) {
+			if (u && b(l).then(h), !t.has(l)) continue;
+			let m = t.get(l);
+			m.length_c && (l.dispatchEvent(new Event(g)), m.connected = /* @__PURE__ */ new WeakSet(), m.length_c = 0, m.length_d || t.delete(l), s = !0);
 		}
 		return s;
 	}
 	function A(i, u) {
 		let s = !1;
-		for (let h of i)
-			u && b(h).then(A), !(!t.has(h) || !t.get(h).length_d) && ((globalThis.queueMicrotask || setTimeout)(_(h)), s = !0);
+		for (let l of i)
+			u && b(l).then(A), !(!t.has(l) || !t.get(l).length_d) && ((globalThis.queueMicrotask || setTimeout)(_(l)), s = !0);
 		return s;
 	}
 	function _(i) {
@@ -381,20 +370,20 @@ function Dt(t, e, n, r = it) {
 	return o || t.dispatchEvent(new Event(g)), e.nodeType === 11 && typeof e.mode == "string" && t.addEventListener(y, w.observe(e), { once: !0 }), S.pop(), e.append(c);
 }
 function ct(t) {
-	return W(t.prototype, "connectedCallback", function(e, n, r) {
+	return k(t.prototype, "connectedCallback", function(e, n, r) {
 		e.apply(n, r), n.dispatchEvent(new Event(g));
-	}), W(t.prototype, "disconnectedCallback", function(e, n, r) {
+	}), k(t.prototype, "disconnectedCallback", function(e, n, r) {
 		e.apply(n, r), (globalThis.queueMicrotask || setTimeout)(
 			() => !n.isConnected && n.dispatchEvent(new Event(y))
 		);
-	}), W(t.prototype, "attributeChangedCallback", function(e, n, r) {
+	}), k(t.prototype, "attributeChangedCallback", function(e, n, r) {
 		let [o, , c] = r;
 		n.dispatchEvent(new CustomEvent(D, {
 			detail: [o, c]
 		})), e.apply(n, r);
 	}), t.prototype[x] = !0, t;
 }
-function W(t, e, n) {
+function k(t, e, n) {
 	t[e] = new Proxy(t[e] || (() => {
 	}), { apply: n });
 }
@@ -426,18 +415,16 @@ R.disconnected = function(t, e) {
 		return r.addEventListener(y, t, e), r[x] || N(e.signal, () => w.offDisconnected(r, t)) && w.onDisconnected(r, t), r;
 	};
 };
-var j = /* @__PURE__ */ new WeakMap();
+var W = /* @__PURE__ */ new WeakMap();
 R.disconnectedAsAbort = function(t) {
-	if (j.has(t))
-		return j.get(t);
+	if (W.has(t)) return W.get(t);
 	let e = new AbortController();
-	return j.set(t, e), t(R.disconnected(() => e.abort())), e;
+	return W.set(t, e), t(R.disconnected(() => e.abort())), e;
 };
 var st = /* @__PURE__ */ new WeakSet();
 R.attributeChanged = function(t, e) {
 	return typeof e != "object" && (e = {}), function(r) {
-		if (r.addEventListener(D, t, e), r[x] || st.has(r) || !a.M)
-			return r;
+		if (r.addEventListener(D, t, e), r[x] || st.has(r) || !a.M) return r;
 		let o = new a.M(function(f) {
 			for (let { attributeName: d, target: p } of f)
 				p.dispatchEvent(
@@ -453,12 +440,12 @@ globalThis.dde= {
 	assignAttribute: z,
 	chainableAppend: Q,
 	classListDeclarative: Y,
-	createElement: k,
+	createElement: j,
 	createElementNS: gt,
 	customElementRender: Dt,
 	customElementWithDDE: ct,
 	dispatchEvent: _t,
-	el: k,
+	el: j,
 	elNS: gt,
 	elementAttribute: tt,
 	empty: vt,

dist/esm-with-signals.d.ts

@@ -47,7 +47,7 @@ type ExtendedHTMLElementTagNameMap= HTMLElementTagNameMap & CustomElementTagName
 type textContent= string | ddeSignal<string>;
 export function el<
 	TAG extends keyof ExtendedHTMLElementTagNameMap,
-	EL extends (TAG extends keyof ExtendedHTMLElementTagNameMap ? ExtendedHTMLElementTagNameMap[TAG] : HTMLElement)
+	EL extends ExtendedHTMLElementTagNameMap[TAG]
 >(
 	tag_name: TAG,
 	attrs?: ElementAttributes<EL> | textContent,
@@ -58,7 +58,7 @@ export function el(
 ): ddeDocumentFragment
 export function el(
 	tag_name: string,
-	attrs?: ElementAttributes<HTMLElement>,
+	attrs?: ElementAttributes<HTMLElement> | textContent,
 	...addons: ddeElementAddon<HTMLElement>[]
 ): ddeHTMLElement
 
@@ -101,7 +101,18 @@ export function elNS(
 export { elNS as createElementNS }
 
 export function chainableAppend<EL extends SupportedElement>(el: EL): EL;
-export function simulateSlots<EL extends SupportedElement | DocumentFragment>(el: EL): EL
+/**
+ * Mapper function (optional). Pass for coppying attributes, this is NOT implemented by {@link simulateSlots} itself!
+ * */
+type simulateSlotsMapper= (body: HTMLSlotElement, el: HTMLElement)=> void;
+/** Simulate slots for ddeComponents */
+export function simulateSlots<EL extends SupportedElement | DocumentFragment>(root: EL, mapper?: simulateSlotsMapper): EL
+/**
+ * Simulate slots in Custom Elements without using `shadowRoot`.
+ * @param el Custom Element root element
+ * @param body Body of the custom element
+ * */
+export function simulateSlots<EL extends SupportedElement | DocumentFragment>(el: HTMLElement, body: EL, mapper?: simulateSlotsMapper): EL
 
 export function dispatchEvent(name: keyof DocumentEventMap | string, options?: EventInit):
 	(element: SupportedElement, data?: any)=> void;
@@ -177,12 +188,12 @@ export const scope: {
 
 export function customElementRender<
 	EL extends HTMLElement,
-	P extends any = Record<string, any>
+	P extends any = Record<string, string | ddeSignal<string>>
 >(
 	custom_element: EL,
 	target: ShadowRoot | EL,
 	render: (props: P)=> SupportedElement | DocumentFragment,
-	props?: P | ((...args: any[])=> P)
+	props?: P | ((el: EL)=> P)
 ): EL
 export function customElementWithDDE<EL extends (new ()=> HTMLElement)>(custom_element: EL): EL
 export function lifecyclesToEvents<EL extends (new ()=> HTMLElement)>(custom_element: EL): EL
@@ -523,7 +534,7 @@ interface signal{
 	 * */
 	el<S extends any>(signal: Signal<S, any>, el: (v: S)=> Element | Element[] | DocumentFragment): DocumentFragment;
 
-    observedAttributes(custom_element: HTMLElement): Record<string, Signal<any, any>>;
+    observedAttributes(custom_element: HTMLElement): Record<string, Signal<string, {}>>;
 }
 export const signal: signal;
 export const S: signal;

dist/esm-with-signals.js

@@ -59,7 +59,7 @@ function lt(t, e, n) {
 			return Reflect.set(t, e, "");
 	}
 }
-var C = "__dde_lifecyclesToEvents", _ = "dde:connected", O = "dde:disconnected", M = "dde:attributeChanged";
+var O = "__dde_lifecyclesToEvents", _ = "dde:connected", C = "dde:disconnected", M = "dde:attributeChanged";
 
 // src/dom.js
 var A = [{
@@ -100,50 +100,50 @@ function ht(t) {
 	return t.append === Y || (t.appendOriginal = t.append, t.append = Y), t;
 }
 var $;
-function j(t, e, ...n) {
+function P(t, e, ...n) {
 	let r = W(this), o = 0, c, i;
 	switch ((Object(e) !== e || r.isSignal(e)) && (e = { textContent: e }), !0) {
 		case typeof t == "function": {
-			o = 1, m.push({ scope: t, host: (...v) => v.length ? (o === 1 ? n.unshift(...v) : v.forEach((l) => l(i)), void 0) : i }), c = t(e || void 0);
+			o = 1, m.push({ scope: t, host: (...v) => v.length ? (o === 1 ? n.unshift(...v) : v.forEach((h) => h(i)), void 0) : i }), c = t(e || void 0);
 			let a = c instanceof d.F;
-			if (c.nodeName === "#comment")
-				break;
-			let h = j.mark({
+			if (c.nodeName === "#comment") break;
+			let l = P.mark({
 				type: "component",
 				name: t.name,
 				host: a ? "this" : "parentElement"
 			});
-			c.prepend(h), a && (i = h);
+			c.prepend(l), a && (i = l);
 			break;
 		}
 		case t === "#text":
-			c = P.call(this, d.D.createTextNode(""), e);
+			c = j.call(this, d.D.createTextNode(""), e);
 			break;
 		case (t === "<>" || !t):
-			c = P.call(this, d.D.createDocumentFragment(), e);
+			c = j.call(this, d.D.createDocumentFragment(), e);
 			break;
 		case !!$:
-			c = P.call(this, d.D.createElementNS($, t), e);
+			c = j.call(this, d.D.createElementNS($, t), e);
 			break;
 		case !c:
-			c = P.call(this, d.D.createElement(t), e);
+			c = j.call(this, d.D.createElement(t), e);
 	}
 	return ht(c), i || (i = c), n.forEach((a) => a(i)), o && m.pop(), o = 2, c;
 }
-function Wt(t, e = t, n = void 0) {
+function Wt(t, e, n) {
+	typeof e != "object" && (n = e, e = t);
 	let r = Symbol.for("default"), o = Array.from(e.querySelectorAll("slot")).reduce((i, a) => Reflect.set(i, a.name || r, a) && i, {}), c = T(o, r);
 	if (t.append = new Proxy(t.append, {
-		apply(i, a, h) {
-			if (!h.length)
-				return t;
+		apply(i, a, l) {
+			if (l[0] === e) return i.apply(t, l);
+			if (!l.length) return t;
 			let v = d.D.createDocumentFragment();
-			for (let l of h) {
-				if (!l || !l.slot) {
-					c && v.appendChild(l);
+			for (let h of l) {
+				if (!h || !h.slot) {
+					c && v.append(h);
 					continue;
 				}
-				let x = l.slot, y = o[x];
-				vt(l, "remove", "slot"), y && (bt(y, l, n), Reflect.deleteProperty(o, x));
+				let x = h.slot, w = o[x];
+				vt(h, "remove", "slot"), w && (bt(w, h, n), Reflect.deleteProperty(o, x));
 			}
 			return c && (o[r].replaceWith(v), Reflect.deleteProperty(o, r)), t.append = i, t;
 		}
@@ -156,12 +156,12 @@ function Wt(t, e = t, n = void 0) {
 function bt(t, e, n) {
 	n && n(t, e);
 	try {
-		t.replaceWith(P(e, { className: [e.className, t.className], dataset: { ...t.dataset } }));
+		t.replaceWith(j(e, { className: [e.className, t.className], dataset: { ...t.dataset } }));
 	} catch {
 		t.replaceWith(e);
 	}
 }
-j.mark = function(t, e = !1) {
+P.mark = function(t, e = !1) {
 	t = Object.entries(t).map(([o, c]) => o + `="${c}"`).join(" ");
 	let n = e ? "" : "/", r = d.D.createComment(`<dde:mark ${t}${d.ssr}${n}>`);
 	return e && (r.end = d.D.createComment("</dde:mark>")), r;
@@ -170,14 +170,13 @@ function qt(t) {
 	let e = this;
 	return function(...r) {
 		$ = t;
-		let o = j.call(e, ...r);
+		let o = P.call(e, ...r);
 		return $ = void 0, o;
 	};
 }
 var U = /* @__PURE__ */ new WeakMap(), { setDeleteAttr: tt } = d;
-function P(t, ...e) {
-	if (!e.length)
-		return t;
+function j(t, ...e) {
+	if (!e.length) return t;
 	U.set(t, rt(t, this));
 	for (let [n, r] of Object.entries(Object.assign({}, ...e)))
 		nt.call(this, t, n, r);
@@ -189,13 +188,11 @@ function nt(t, e, n) {
 		t,
 		e,
 		n,
-		(a, h) => nt.call(c, t, a, h)
+		(a, l) => nt.call(c, t, a, l)
 	);
 	let [i] = e;
-	if (i === "=")
-		return r(e.slice(1), n);
-	if (i === ".")
-		return et(t, e.slice(1), n);
+	if (i === "=") return r(e.slice(1), n);
+	if (i === ".") return et(t, e.slice(1), n);
 	if (/(aria|data)([A-Z])/.test(e))
 		return e = e.replace(/([a-z])([A-Z])/g, "$1-$2").toLowerCase(), r(e, n);
 	switch (e === "className" && (e = "class"), e) {
@@ -204,20 +201,19 @@ function nt(t, e, n) {
 		case "textContent":
 			return tt(t, e, n);
 		case "style":
-			if (typeof n != "object")
-				break;
+			if (typeof n != "object") break;
+		/* falls through */
 		case "dataset":
 			return I(o, n, et.bind(null, t[e]));
 		case "ariaset":
-			return I(o, n, (a, h) => r("aria-" + a, h));
+			return I(o, n, (a, l) => r("aria-" + a, l));
 		case "classList":
 			return gt.call(c, t, n);
 	}
 	return Et(t, e) ? tt(t, e, n) : r(e, n);
 }
 function rt(t, e) {
-	if (U.has(t))
-		return U.get(t);
+	if (U.has(t)) return U.get(t);
 	let r = (t instanceof d.S ? xt : mt).bind(null, t, "Attribute"), o = W(e);
 	return { setRemoveAttr: r, s: o };
 }
@@ -236,14 +232,12 @@ function vt(t, e, n, r) {
 	return t instanceof d.H ? t[e + "Attribute"](n, r) : t[e + "AttributeNS"](null, n, r);
 }
 function Et(t, e) {
-	if (!(e in t))
-		return !1;
+	if (!(e in t)) return !1;
 	let n = ot(t, e);
 	return !S(n.set);
 }
 function ot(t, e) {
-	if (t = Object.getPrototypeOf(t), !t)
-		return {};
+	if (t = Object.getPrototypeOf(t), !t) return {};
 	let n = Object.getOwnPropertyDescriptor(t, e);
 	return n || ot(t, e);
 }
@@ -268,17 +262,17 @@ function et(t, e, n) {
 }
 
 // src/events-observer.js
-var D = d.M ? wt() : new Proxy({}, {
+var D = d.M ? yt() : new Proxy({}, {
 	get() {
 		return () => {
 		};
 	}
 });
-function wt() {
+function yt() {
 	let t = /* @__PURE__ */ new Map(), e = !1, n = (s) => function(u) {
 		for (let f of u)
 			if (f.type === "childList") {
-				if (l(f.addedNodes, !0)) {
+				if (h(f.addedNodes, !0)) {
 					s();
 					continue;
 				}
@@ -297,8 +291,7 @@ function wt() {
 			f.connected.has(u) || (f.connected.add(u), f.length_c += 1);
 		},
 		offConnected(s, u) {
-			if (!t.has(s))
-				return;
+			if (!t.has(s)) return;
 			let f = t.get(s);
 			f.connected.has(u) && (f.connected.delete(u), f.length_c -= 1, o(s, f));
 		},
@@ -308,8 +301,7 @@ function wt() {
 			f.disconnected.has(u) || (f.disconnected.add(u), f.length_d += 1);
 		},
 		offDisconnected(s, u) {
-			if (!t.has(s))
-				return;
+			if (!t.has(s)) return;
 			let f = t.get(s);
 			f.disconnected.has(u) && (f.disconnected.delete(u), f.length_d -= 1, o(s, f));
 		}
@@ -318,8 +310,7 @@ function wt() {
 		u.length_c || u.length_d || (t.delete(s), a());
 	}
 	function c(s) {
-		if (t.has(s))
-			return t.get(s);
+		if (t.has(s)) return t.get(s);
 		let u = {
 			connected: /* @__PURE__ */ new WeakSet(),
 			length_c: 0,
@@ -334,25 +325,23 @@ function wt() {
 	function a() {
 		!e || t.size || (e = !1, r.disconnect());
 	}
-	function h() {
+	function l() {
 		return new Promise(function(s) {
 			(requestIdleCallback || requestAnimationFrame)(s);
 		});
 	}
 	async function v(s) {
-		t.size > 30 && await h();
+		t.size > 30 && await l();
 		let u = [];
-		if (!(s instanceof Node))
-			return u;
+		if (!(s instanceof Node)) return u;
 		for (let f of t.keys())
 			f === s || !(f instanceof Node) || s.contains(f) && u.push(f);
 		return u;
 	}
-	function l(s, u) {
+	function h(s, u) {
 		let f = !1;
 		for (let b of s) {
-			if (u && v(b).then(l), !t.has(b))
-				continue;
+			if (u && v(b).then(h), !t.has(b)) continue;
 			let N = t.get(b);
 			N.length_c && (b.dispatchEvent(new Event(_)), N.connected = /* @__PURE__ */ new WeakSet(), N.length_c = 0, N.length_d || t.delete(b), f = !0);
 		}
@@ -361,12 +350,12 @@ function wt() {
 	function x(s, u) {
 		let f = !1;
 		for (let b of s)
-			u && v(b).then(x), !(!t.has(b) || !t.get(b).length_d) && ((globalThis.queueMicrotask || setTimeout)(y(b)), f = !0);
+			u && v(b).then(x), !(!t.has(b) || !t.get(b).length_d) && ((globalThis.queueMicrotask || setTimeout)(w(b)), f = !0);
 		return f;
 	}
-	function y(s) {
+	function w(s) {
 		return () => {
-			s.isConnected || (s.dispatchEvent(new Event(O)), t.delete(s));
+			s.isConnected || (s.dispatchEvent(new Event(C)), t.delete(s));
 		};
 	}
 }
@@ -377,24 +366,24 @@ function Zt(t, e, n, r = _t) {
 		scope: t,
 		host: (...i) => i.length ? i.forEach((a) => a(t)) : t
 	}), typeof r == "function" && (r = r.call(t, t));
-	let o = t[C];
-	o || yt(t);
+	let o = t[O];
+	o || wt(t);
 	let c = n.call(t, r);
-	return o || t.dispatchEvent(new Event(_)), e.nodeType === 11 && typeof e.mode == "string" && t.addEventListener(O, D.observe(e), { once: !0 }), m.pop(), e.append(c);
+	return o || t.dispatchEvent(new Event(_)), e.nodeType === 11 && typeof e.mode == "string" && t.addEventListener(C, D.observe(e), { once: !0 }), m.pop(), e.append(c);
 }
-function yt(t) {
+function wt(t) {
 	return J(t.prototype, "connectedCallback", function(e, n, r) {
 		e.apply(n, r), n.dispatchEvent(new Event(_));
 	}), J(t.prototype, "disconnectedCallback", function(e, n, r) {
 		e.apply(n, r), (globalThis.queueMicrotask || setTimeout)(
-			() => !n.isConnected && n.dispatchEvent(new Event(O))
+			() => !n.isConnected && n.dispatchEvent(new Event(C))
 		);
 	}), J(t.prototype, "attributeChangedCallback", function(e, n, r) {
 		let [o, , c] = r;
 		n.dispatchEvent(new CustomEvent(M, {
 			detail: [o, c]
 		})), e.apply(n, r);
-	}), t.prototype[C] = !0, t;
+	}), t.prototype[O] = !0, t;
 }
 function J(t, e, n) {
 	t[e] = new Proxy(t[e] || (() => {
@@ -412,38 +401,36 @@ function Qt(t, e, n) {
 		return o.dispatchEvent(i);
 	};
 }
-function w(t, e, n) {
+function y(t, e, n) {
 	return function(o) {
 		return o.addEventListener(t, e, n), o;
 	};
 }
 var it = (t) => Object.assign({}, typeof t == "object" ? t : null, { once: !0 });
-w.connected = function(t, e) {
+y.connected = function(t, e) {
 	return e = it(e), function(r) {
-		return r.addEventListener(_, t, e), r[C] ? r : r.isConnected ? (r.dispatchEvent(new Event(_)), r) : (q(e.signal, () => D.offConnected(r, t)) && D.onConnected(r, t), r);
+		return r.addEventListener(_, t, e), r[O] ? r : r.isConnected ? (r.dispatchEvent(new Event(_)), r) : (q(e.signal, () => D.offConnected(r, t)) && D.onConnected(r, t), r);
 	};
 };
-w.disconnected = function(t, e) {
+y.disconnected = function(t, e) {
 	return e = it(e), function(r) {
-		return r.addEventListener(O, t, e), r[C] || q(e.signal, () => D.offDisconnected(r, t)) && D.onDisconnected(r, t), r;
+		return r.addEventListener(C, t, e), r[O] || q(e.signal, () => D.offDisconnected(r, t)) && D.onDisconnected(r, t), r;
 	};
 };
 var Z = /* @__PURE__ */ new WeakMap();
-w.disconnectedAsAbort = function(t) {
-	if (Z.has(t))
-		return Z.get(t);
+y.disconnectedAsAbort = function(t) {
+	if (Z.has(t)) return Z.get(t);
 	let e = new AbortController();
-	return Z.set(t, e), t(w.disconnected(() => e.abort())), e;
+	return Z.set(t, e), t(y.disconnected(() => e.abort())), e;
 };
 var At = /* @__PURE__ */ new WeakSet();
-w.attributeChanged = function(t, e) {
+y.attributeChanged = function(t, e) {
 	return typeof e != "object" && (e = {}), function(r) {
-		if (r.addEventListener(M, t, e), r[C] || At.has(r) || !d.M)
-			return r;
+		if (r.addEventListener(M, t, e), r[O] || At.has(r) || !d.M) return r;
 		let o = new d.M(function(i) {
-			for (let { attributeName: a, target: h } of i)
-				h.dispatchEvent(
-					new CustomEvent(M, { detail: [a, h.getAttribute(a)] })
+			for (let { attributeName: a, target: l } of i)
+				l.dispatchEvent(
+					new CustomEvent(M, { detail: [a, l.getAttribute(a)] })
 				);
 		});
 		return q(e.signal, () => o.disconnect()) && o.observe(r, { attributes: !0 }), r;
@@ -463,12 +450,10 @@ var H = [], g = /* @__PURE__ */ new WeakMap();
 function E(t, e) {
 	if (typeof t != "function")
 		return st(!1, t, e);
-	if (z(t))
-		return t;
+	if (z(t)) return t;
 	let n = st(!0), r = function() {
 		let [o, ...c] = g.get(r);
-		if (g.set(r, /* @__PURE__ */ new Set([o])), H.push(r), dt(n, t()), H.pop(), !c.length)
-			return;
+		if (g.set(r, /* @__PURE__ */ new Set([o])), H.push(r), dt(n, t()), H.pop(), !c.length) return;
 		let i = g.get(r);
 		for (let a of c)
 			i.has(a) || L(a, r);
@@ -479,15 +464,13 @@ E.action = function(t, e, ...n) {
 	let r = t[p], { actions: o } = r;
 	if (!o || !(e in o))
 		throw new Error(`'${t}' has no action with name '${e}'!`);
-	if (o[e].apply(r, n), r.skip)
-		return delete r.skip;
+	if (o[e].apply(r, n), r.skip) return delete r.skip;
 	r.listeners.forEach((c) => c(r.value));
 };
 E.on = function t(e, n, r = {}) {
 	let { signal: o } = r;
 	if (!(o && o.aborted)) {
-		if (Array.isArray(e))
-			return e.forEach((c) => t(c, n, r));
+		if (Array.isArray(e)) return e.forEach((c) => t(c, n, r));
 		Q(e, n), o && o.addEventListener("abort", () => L(e, n));
 	}
 };
@@ -502,8 +485,7 @@ E.clear = function(...t) {
 	}
 	function e(n, r) {
 		r.listeners.forEach((o) => {
-			if (r.listeners.delete(o), !g.has(o))
-				return;
+			if (r.listeners.delete(o), !g.has(o)) return;
 			let c = g.get(o);
 			c.delete(n), !(c.size > 1) && (n.clear(...c), g.delete(o));
 		});
@@ -511,23 +493,23 @@ E.clear = function(...t) {
 };
 var R = "__dde_reactive";
 E.el = function(t, e) {
-	let n = j.mark({ type: "reactive" }, !0), r = n.end, o = d.D.createDocumentFragment();
+	let n = P.mark({ type: "reactive" }, !0), r = n.end, o = d.D.createDocumentFragment();
 	o.append(n, r);
-	let { current: c } = m, i = {}, a = (h) => {
+	let { current: c } = m, i = {}, a = (l) => {
 		if (!n.parentNode || !r.parentNode)
 			return L(t, a);
 		let v = i;
 		i = {}, m.push(c);
-		let l = e(h, function(u, f) {
+		let h = e(l, function(u, f) {
 			let b;
 			return T(v, u) ? (b = v[u], delete v[u]) : b = f(), i[u] = b, b;
 		});
-		m.pop(), Array.isArray(l) || (l = [l]);
+		m.pop(), Array.isArray(h) || (h = [h]);
 		let x = document.createComment("");
-		l.push(x), n.after(...l);
-		let y;
-		for (; (y = x.nextSibling) && y !== r; )
-			y.remove();
+		h.push(x), n.after(...h);
+		let w;
+		for (; (w = x.nextSibling) && w !== r; )
+			w.remove();
 		x.remove(), n.isConnected && St(c.host());
 	};
 	return Q(t, a), ft(t, a, n, e), a(t()), o;
@@ -537,27 +519,26 @@ function St(t) {
 		t[R] = t[R].filter(([e, n]) => n.isConnected ? !0 : (L(...e), !1));
 	});
 }
-var Ct = {
+var Ot = {
 	_set(t) {
 		this.value = t;
 	}
 };
-function Ot(t) {
+function Ct(t) {
 	return function(e, n) {
-		let r = (...c) => c.length ? e.setAttribute(n, ...c) : K(r), o = at(r, e.getAttribute(n), Ct);
+		let r = (...c) => c.length ? e.setAttribute(n, ...c) : K(r), o = at(r, e.getAttribute(n), Ot);
 		return t[n] = o, o;
 	};
 }
 var G = "__dde_attributes";
 E.observedAttributes = function(t) {
-	let e = t[G] = {}, n = F(t, Ot(e));
-	return w.attributeChanged(function({ detail: o }) {
+	let e = t[G] = {}, n = F(t, Ct(e));
+	return y.attributeChanged(function({ detail: o }) {
 		/*! This maps attributes to signals (`S.observedAttributes`).
 			* Investigate `__dde_attributes` key of the element.*/
 		let [c, i] = o, a = this[G][c];
-		if (a)
-			return E.action(a, "_set", i);
-	})(t), w.disconnected(function() {
+		if (a) return E.action(a, "_set", i);
+	})(t), y.disconnected(function() {
 		/*! This removes all signals mapped to attributes (`S.observedAttributes`).
 			* Investigate `__dde_attributes` key of the element.*/
 		E.clear(...Object.values(this[G]));
@@ -566,8 +547,7 @@ E.observedAttributes = function(t) {
 var ut = {
 	isSignal: z,
 	processReactiveAttribute(t, e, n, r) {
-		if (!z(n))
-			return n;
+		if (!z(n)) return n;
 		let o = (c) => {
 			if (!t.isConnected)
 				return L(n, o);
@@ -579,7 +559,7 @@ var ut = {
 function ft(t, e, ...n) {
 	let { current: r } = m;
 	r.prevent || r.host(function(o) {
-		o[R] || (o[R] = [], w.disconnected(
+		o[R] || (o[R] = [], y.disconnected(
 			() => (
 				/*!
 				* Clears all Signals listeners added in the current scope/host (`S.el`, `assign`, …?).
@@ -631,14 +611,12 @@ function Rt() {
 	return H[H.length - 1];
 }
 function K(t) {
-	if (!t[p])
-		return;
+	if (!t[p]) return;
 	let { value: e, listeners: n } = t[p], r = Rt();
 	return r && n.add(r), g.has(r) && g.get(r).add(t), e;
 }
 function dt(t, e, n) {
-	if (!t[p])
-		return;
+	if (!t[p]) return;
 	let r = t[p];
 	if (!(!n && r.value === e))
 		return r.value = e, r.listeners.forEach((o) => o(e)), e;
@@ -649,15 +627,12 @@ function Q(t, e) {
 }
 function L(t, e, n) {
 	let r = t[p];
-	if (!r)
-		return;
+	if (!r) return;
 	let o = r.listeners.delete(e);
 	if (n && !r.listeners.size) {
-		if (E.clear(t), !g.has(r))
-			return o;
+		if (E.clear(t), !g.has(r)) return o;
 		let c = g.get(r);
-		if (!g.has(c))
-			return o;
+		if (!g.has(c)) return o;
 		g.get(c).forEach((i) => L(i, c, !0));
 	}
 	return o;
@@ -667,23 +642,23 @@ function L(t, e, n) {
 B(ut);
 export {
 	E as S,
-	P as assign,
+	j as assign,
 	nt as assignAttribute,
 	ht as chainableAppend,
 	gt as classListDeclarative,
-	j as createElement,
+	P as createElement,
 	qt as createElementNS,
 	Zt as customElementRender,
-	yt as customElementWithDDE,
+	wt as customElementWithDDE,
 	Qt as dispatchEvent,
-	j as el,
+	P as el,
 	qt as elNS,
 	vt as elementAttribute,
 	Ft as empty,
 	z as isSignal,
-	yt as lifecyclesToEvents,
+	wt as lifecyclesToEvents,
 	_t as observedAttributes,
-	w as on,
+	y as on,
 	B as registerReactivity,
 	m as scope,
 	E as signal,

dist/esm.d.ts

@@ -47,7 +47,7 @@ type ExtendedHTMLElementTagNameMap= HTMLElementTagNameMap & CustomElementTagName
 type textContent= string | ddeSignal<string>;
 export function el<
 	TAG extends keyof ExtendedHTMLElementTagNameMap,
-	EL extends (TAG extends keyof ExtendedHTMLElementTagNameMap ? ExtendedHTMLElementTagNameMap[TAG] : HTMLElement)
+	EL extends ExtendedHTMLElementTagNameMap[TAG]
 >(
 	tag_name: TAG,
 	attrs?: ElementAttributes<EL> | textContent,
@@ -58,7 +58,7 @@ export function el(
 ): ddeDocumentFragment
 export function el(
 	tag_name: string,
-	attrs?: ElementAttributes<HTMLElement>,
+	attrs?: ElementAttributes<HTMLElement> | textContent,
 	...addons: ddeElementAddon<HTMLElement>[]
 ): ddeHTMLElement
 
@@ -101,7 +101,18 @@ export function elNS(
 export { elNS as createElementNS }
 
 export function chainableAppend<EL extends SupportedElement>(el: EL): EL;
-export function simulateSlots<EL extends SupportedElement | DocumentFragment>(el: EL): EL
+/**
+ * Mapper function (optional). Pass for coppying attributes, this is NOT implemented by {@link simulateSlots} itself!
+ * */
+type simulateSlotsMapper= (body: HTMLSlotElement, el: HTMLElement)=> void;
+/** Simulate slots for ddeComponents */
+export function simulateSlots<EL extends SupportedElement | DocumentFragment>(root: EL, mapper?: simulateSlotsMapper): EL
+/**
+ * Simulate slots in Custom Elements without using `shadowRoot`.
+ * @param el Custom Element root element
+ * @param body Body of the custom element
+ * */
+export function simulateSlots<EL extends SupportedElement | DocumentFragment>(el: HTMLElement, body: EL, mapper?: simulateSlotsMapper): EL
 
 export function dispatchEvent(name: keyof DocumentEventMap | string, options?: EventInit):
 	(element: SupportedElement, data?: any)=> void;
@@ -177,12 +188,12 @@ export const scope: {
 
 export function customElementRender<
 	EL extends HTMLElement,
-	P extends any = Record<string, any>
+	P extends any = Record<string, string | ddeSignal<string>>
 >(
 	custom_element: EL,
 	target: ShadowRoot | EL,
 	render: (props: P)=> SupportedElement | DocumentFragment,
-	props?: P | ((...args: any[])=> P)
+	props?: P | ((el: EL)=> P)
 ): EL
 export function customElementWithDDE<EL extends (new ()=> HTMLElement)>(custom_element: EL): EL
 export function lifecyclesToEvents<EL extends (new ()=> HTMLElement)>(custom_element: EL): EL

dist/esm.js

@@ -96,15 +96,14 @@ function Q(t) {
 	return t.append === $ || (t.appendOriginal = t.append, t.append = $), t;
 }
 var T;
-function k(t, e, ...n) {
+function j(t, e, ...n) {
 	let r = L(this), o = 0, c, f;
 	switch ((Object(e) !== e || r.isSignal(e)) && (e = { textContent: e }), !0) {
 		case typeof t == "function": {
-			o = 1, S.push({ scope: t, host: (...b) => b.length ? (o === 1 ? n.unshift(...b) : b.forEach((l) => l(f)), void 0) : f }), c = t(e || void 0);
+			o = 1, S.push({ scope: t, host: (...b) => b.length ? (o === 1 ? n.unshift(...b) : b.forEach((h) => h(f)), void 0) : f }), c = t(e || void 0);
 			let d = c instanceof a.F;
-			if (c.nodeName === "#comment")
-				break;
-			let p = k.mark({
+			if (c.nodeName === "#comment") break;
+			let p = j.mark({
 				type: "component",
 				name: t.name,
 				host: d ? "this" : "parentElement"
@@ -126,20 +125,21 @@ function k(t, e, ...n) {
 	}
 	return Q(c), f || (f = c), n.forEach((d) => d(f)), o && S.pop(), o = 2, c;
 }
-function bt(t, e = t, n = void 0) {
+function bt(t, e, n) {
+	typeof e != "object" && (n = e, e = t);
 	let r = Symbol.for("default"), o = Array.from(e.querySelectorAll("slot")).reduce((f, d) => Reflect.set(f, d.name || r, d) && f, {}), c = q(o, r);
 	if (t.append = new Proxy(t.append, {
 		apply(f, d, p) {
-			if (!p.length)
-				return t;
+			if (p[0] === e) return f.apply(t, p);
+			if (!p.length) return t;
 			let b = a.D.createDocumentFragment();
-			for (let l of p) {
-				if (!l || !l.slot) {
-					c && b.appendChild(l);
+			for (let h of p) {
+				if (!h || !h.slot) {
+					c && b.append(h);
 					continue;
 				}
-				let A = l.slot, _ = o[A];
-				tt(l, "remove", "slot"), _ && (X(_, l, n), Reflect.deleteProperty(o, A));
+				let A = h.slot, _ = o[A];
+				tt(h, "remove", "slot"), _ && (X(_, h, n), Reflect.deleteProperty(o, A));
 			}
 			return c && (o[r].replaceWith(b), Reflect.deleteProperty(o, r)), t.append = f, t;
 		}
@@ -157,7 +157,7 @@ function X(t, e, n) {
 		t.replaceWith(e);
 	}
 }
-k.mark = function(t, e = !1) {
+j.mark = function(t, e = !1) {
 	t = Object.entries(t).map(([o, c]) => o + `="${c}"`).join(" ");
 	let n = e ? "" : "/", r = a.D.createComment(`<dde:mark ${t}${a.ssr}${n}>`);
 	return e && (r.end = a.D.createComment("</dde:mark>")), r;
@@ -166,14 +166,13 @@ function gt(t) {
 	let e = this;
 	return function(...r) {
 		T = t;
-		let o = k.call(e, ...r);
+		let o = j.call(e, ...r);
 		return T = void 0, o;
 	};
 }
 var P = /* @__PURE__ */ new WeakMap(), { setDeleteAttr: U } = a;
 function O(t, ...e) {
-	if (!e.length)
-		return t;
+	if (!e.length) return t;
 	P.set(t, B(t, this));
 	for (let [n, r] of Object.entries(Object.assign({}, ...e)))
 		z.call(this, t, n, r);
@@ -188,10 +187,8 @@ function z(t, e, n) {
 		(d, p) => z.call(c, t, d, p)
 	);
 	let [f] = e;
-	if (f === "=")
-		return r(e.slice(1), n);
-	if (f === ".")
-		return H(t, e.slice(1), n);
+	if (f === "=") return r(e.slice(1), n);
+	if (f === ".") return H(t, e.slice(1), n);
 	if (/(aria|data)([A-Z])/.test(e))
 		return e = e.replace(/([a-z])([A-Z])/g, "$1-$2").toLowerCase(), r(e, n);
 	switch (e === "className" && (e = "class"), e) {
@@ -200,8 +197,8 @@ function z(t, e, n) {
 		case "textContent":
 			return U(t, e, n);
 		case "style":
-			if (typeof n != "object")
-				break;
+			if (typeof n != "object") break;
+		/* falls through */
 		case "dataset":
 			return M(o, n, H.bind(null, t[e]));
 		case "ariaset":
@@ -212,8 +209,7 @@ function z(t, e, n) {
 	return et(t, e) ? U(t, e, n) : r(e, n);
 }
 function B(t, e) {
-	if (P.has(t))
-		return P.get(t);
+	if (P.has(t)) return P.get(t);
 	let r = (t instanceof a.S ? rt : nt).bind(null, t, "Attribute"), o = L(e);
 	return { setRemoveAttr: r, s: o };
 }
@@ -232,14 +228,12 @@ function tt(t, e, n, r) {
 	return t instanceof a.H ? t[e + "Attribute"](n, r) : t[e + "AttributeNS"](null, n, r);
 }
 function et(t, e) {
-	if (!(e in t))
-		return !1;
+	if (!(e in t)) return !1;
 	let n = I(t, e);
 	return !E(n.set);
 }
 function I(t, e) {
-	if (t = Object.getPrototypeOf(t), !t)
-		return {};
+	if (t = Object.getPrototypeOf(t), !t) return {};
 	let n = Object.getOwnPropertyDescriptor(t, e);
 	return n || I(t, e);
 }
@@ -274,7 +268,7 @@ function ot() {
 	let t = /* @__PURE__ */ new Map(), e = !1, n = (i) => function(u) {
 		for (let s of u)
 			if (s.type === "childList") {
-				if (l(s.addedNodes, !0)) {
+				if (h(s.addedNodes, !0)) {
 					i();
 					continue;
 				}
@@ -293,8 +287,7 @@ function ot() {
 			s.connected.has(u) || (s.connected.add(u), s.length_c += 1);
 		},
 		offConnected(i, u) {
-			if (!t.has(i))
-				return;
+			if (!t.has(i)) return;
 			let s = t.get(i);
 			s.connected.has(u) && (s.connected.delete(u), s.length_c -= 1, o(i, s));
 		},
@@ -304,8 +297,7 @@ function ot() {
 			s.disconnected.has(u) || (s.disconnected.add(u), s.length_d += 1);
 		},
 		offDisconnected(i, u) {
-			if (!t.has(i))
-				return;
+			if (!t.has(i)) return;
 			let s = t.get(i);
 			s.disconnected.has(u) && (s.disconnected.delete(u), s.length_d -= 1, o(i, s));
 		}
@@ -314,8 +306,7 @@ function ot() {
 		u.length_c || u.length_d || (t.delete(i), d());
 	}
 	function c(i) {
-		if (t.has(i))
-			return t.get(i);
+		if (t.has(i)) return t.get(i);
 		let u = {
 			connected: /* @__PURE__ */ new WeakSet(),
 			length_c: 0,
@@ -338,26 +329,24 @@ function ot() {
 	async function b(i) {
 		t.size > 30 && await p();
 		let u = [];
-		if (!(i instanceof Node))
-			return u;
+		if (!(i instanceof Node)) return u;
 		for (let s of t.keys())
 			s === i || !(s instanceof Node) || i.contains(s) && u.push(s);
 		return u;
 	}
-	function l(i, u) {
+	function h(i, u) {
 		let s = !1;
-		for (let h of i) {
-			if (u && b(h).then(l), !t.has(h))
-				continue;
-			let m = t.get(h);
-			m.length_c && (h.dispatchEvent(new Event(g)), m.connected = /* @__PURE__ */ new WeakSet(), m.length_c = 0, m.length_d || t.delete(h), s = !0);
+		for (let l of i) {
+			if (u && b(l).then(h), !t.has(l)) continue;
+			let m = t.get(l);
+			m.length_c && (l.dispatchEvent(new Event(g)), m.connected = /* @__PURE__ */ new WeakSet(), m.length_c = 0, m.length_d || t.delete(l), s = !0);
 		}
 		return s;
 	}
 	function A(i, u) {
 		let s = !1;
-		for (let h of i)
-			u && b(h).then(A), !(!t.has(h) || !t.get(h).length_d) && ((globalThis.queueMicrotask || setTimeout)(_(h)), s = !0);
+		for (let l of i)
+			u && b(l).then(A), !(!t.has(l) || !t.get(l).length_d) && ((globalThis.queueMicrotask || setTimeout)(_(l)), s = !0);
 		return s;
 	}
 	function _(i) {
@@ -379,20 +368,20 @@ function Dt(t, e, n, r = it) {
 	return o || t.dispatchEvent(new Event(g)), e.nodeType === 11 && typeof e.mode == "string" && t.addEventListener(y, w.observe(e), { once: !0 }), S.pop(), e.append(c);
 }
 function ct(t) {
-	return W(t.prototype, "connectedCallback", function(e, n, r) {
+	return k(t.prototype, "connectedCallback", function(e, n, r) {
 		e.apply(n, r), n.dispatchEvent(new Event(g));
-	}), W(t.prototype, "disconnectedCallback", function(e, n, r) {
+	}), k(t.prototype, "disconnectedCallback", function(e, n, r) {
 		e.apply(n, r), (globalThis.queueMicrotask || setTimeout)(
 			() => !n.isConnected && n.dispatchEvent(new Event(y))
 		);
-	}), W(t.prototype, "attributeChangedCallback", function(e, n, r) {
+	}), k(t.prototype, "attributeChangedCallback", function(e, n, r) {
 		let [o, , c] = r;
 		n.dispatchEvent(new CustomEvent(D, {
 			detail: [o, c]
 		})), e.apply(n, r);
 	}), t.prototype[x] = !0, t;
 }
-function W(t, e, n) {
+function k(t, e, n) {
 	t[e] = new Proxy(t[e] || (() => {
 	}), { apply: n });
 }
@@ -424,18 +413,16 @@ R.disconnected = function(t, e) {
 		return r.addEventListener(y, t, e), r[x] || N(e.signal, () => w.offDisconnected(r, t)) && w.onDisconnected(r, t), r;
 	};
 };
-var j = /* @__PURE__ */ new WeakMap();
+var W = /* @__PURE__ */ new WeakMap();
 R.disconnectedAsAbort = function(t) {
-	if (j.has(t))
-		return j.get(t);
+	if (W.has(t)) return W.get(t);
 	let e = new AbortController();
-	return j.set(t, e), t(R.disconnected(() => e.abort())), e;
+	return W.set(t, e), t(R.disconnected(() => e.abort())), e;
 };
 var st = /* @__PURE__ */ new WeakSet();
 R.attributeChanged = function(t, e) {
 	return typeof e != "object" && (e = {}), function(r) {
-		if (r.addEventListener(D, t, e), r[x] || st.has(r) || !a.M)
-			return r;
+		if (r.addEventListener(D, t, e), r[x] || st.has(r) || !a.M) return r;
 		let o = new a.M(function(f) {
 			for (let { attributeName: d, target: p } of f)
 				p.dispatchEvent(
@@ -450,12 +437,12 @@ export {
 	z as assignAttribute,
 	Q as chainableAppend,
 	Y as classListDeclarative,
-	k as createElement,
+	j as createElement,
 	gt as createElementNS,
 	Dt as customElementRender,
 	ct as customElementWithDDE,
 	_t as dispatchEvent,
-	k as el,
+	j as el,
 	gt as elNS,
 	tt as elementAttribute,
 	vt as empty,

docs/components/code.html.js

@@ -14,15 +14,14 @@ ${host}{
 	--shiki-token-punctuation: var(--code);
 	--shiki-token-link: #EE0000;
 	white-space: pre;
-	tab-size: 2;${""/* TODO: allow custom tab size?! */}
+	tab-size: 2; /* TODO: allow custom tab size?! */
 	overflow: scroll;
 }
 ${host}[data-js=todo]{
 	border: 1px solid var(--border);
 	border-radius: var(--standard-border-radius);
 	margin-bottom: 1rem;
-	${/* to fix shift when → dataJS=done */""}
-	margin-top: 18.4px;
+	margin-top: 18.4px; /* to fix shift when → dataJS=done */
 	padding: 1rem 1.4rem;
 }
 `;

docs/components/examples/customElement/customElementWithDDE.js

@@ -0,0 +1,23 @@
+import { customElementWithDDE, el, on } from "deka-dom-el";
+export class HTMLCustomElement extends HTMLElement{
+	static tagName= "custom-element";
+	connectedCallback(){
+		this.append(
+			el("p", "Hello from custom element!")
+		);
+	}
+}
+customElementWithDDE(HTMLCustomElement);
+customElements.define(HTMLCustomElement.tagName, HTMLCustomElement);
+
+const instance= el(HTMLCustomElement.tagName);
+on.connected( // preffered
+	e=> console.log("Element connected to the DOM (v1):", e)
+)(instance);
+instance.addEventListener(
+	"dde:connected",
+	e=> console.log("Element connected to the DOM (v2):", e)
+);
+document.body.append(
+	instance,
+);

docs/components/examples/customElement/dde.js

@@ -0,0 +1,33 @@
+import {
+	customElementRender,
+	customElementWithDDE,
+} from "deka-dom-el";
+export class HTMLCustomElement extends HTMLElement{
+	static tagName= "custom-element";
+	static observedAttributes= [ "attr" ];
+	connectedCallback(){
+		customElementRender(
+			this,
+			this.attachShadow({ mode: "open" }),
+			ddeComponent
+		);
+	}
+	set attr(value){ this.setAttribute("attr", value); }
+	get attr(){ return this.getAttribute("attr"); }
+}
+
+import { el, on, scope } from "deka-dom-el";
+function ddeComponent({ attr }){
+	scope.host(
+		on.connected(e=> console.log(e.target.outerHTML)),
+	);
+	return el().append(
+		el("p", `Hello from Custom Element with attribute '${attr}'`)
+	);
+}
+customElementWithDDE(HTMLCustomElement);
+customElements.define(HTMLCustomElement.tagName, HTMLCustomElement);
+
+document.body.append(
+	el(HTMLCustomElement.tagName, { attr: "Attribute" })
+);

docs/components/examples/customElement/native-basic.js

@@ -1,5 +1,5 @@
-class CustomHTMLElement extends HTMLElement{
-	static tagName = "custom-element"; // just suggestion, we can use `el(CustomHTMLElement.tagName)`
+export class HTMLCustomElement extends HTMLElement{
+	static tagName= "custom-element"; // just suggestion, we can use `el(HTMLCustomElement.tagName)`
 	static observedAttributes= [ "custom-attribute" ];
 	constructor(){
 		super();
@@ -18,4 +18,4 @@ class CustomHTMLElement extends HTMLElement{
 	get customAttribute(){ return this.getAttribute("custom-attribute"); }
 	set customAttribute(value){ this.setAttribute("custom-attribute", value); }
 }
-customElements.define(CustomHTMLElement.tagName, CustomHTMLElement);
+customElements.define(HTMLCustomElement.tagName, HTMLCustomElement);

docs/components/examples/customElement/observedAttributes.js

@@ -0,0 +1,42 @@
+import {
+	customElementRender,
+	customElementWithDDE,
+	observedAttributes,
+	el, on, scope 
+} from "deka-dom-el";
+import { S } from "deka-dom-el/signals";
+export class HTMLCustomElement extends HTMLElement{
+	static tagName= "custom-element";
+	static observedAttributes= [ "attr" ];
+	connectedCallback(){
+		console.log(observedAttributes(this));
+		customElementRender(
+			this,
+			this.attachShadow({ mode: "open" }),
+			ddeComponent,
+			S.observedAttributes
+		);
+	}
+	set attr(value){ this.setAttribute("attr", value); }
+	get attr(){ return this.getAttribute("attr"); }
+}
+
+/** @param {{ attr: ddeSignal<string, {}> }} props */
+function ddeComponent({ attr }){
+	scope.host(
+		on.connected(e=> console.log(e.target.outerHTML)),
+	);
+	return el().append(
+		el("p", S(()=> `Hello from Custom Element with attribute '${attr()}'`))
+	);
+}
+customElementWithDDE(HTMLCustomElement);
+customElements.define(HTMLCustomElement.tagName, HTMLCustomElement);
+
+document.body.append(
+	el(HTMLCustomElement.tagName, { attr: "Attribute" })
+);
+setTimeout(
+	()=> document.querySelector(HTMLCustomElement.tagName).setAttribute("attr", "New Value"),
+	3*750
+);

docs/components/examples/customElement/shadowRoot.js

@@ -0,0 +1,69 @@
+import {
+	el,
+	customElementRender,
+	customElementWithDDE,
+} from "deka-dom-el";
+function ddeComponent(){
+	return el().append(
+		el("style", `
+			.red{ color: firebrick; }
+		`),
+		el("p", { className: "red" }).append(
+			"Hello from ", el("slot", "Custom Element"), "!"
+		)
+	);
+}
+
+export class A extends HTMLElement{
+	static tagName= "custom-element-without";
+	connectedCallback(){
+		customElementRender(
+			this,
+			this,
+			ddeComponent
+		);
+	}
+}
+customElementWithDDE(A);
+customElements.define(A.tagName, A);
+export class B extends HTMLElement{
+	static tagName= "custom-element-open";
+	connectedCallback(){
+		customElementRender(
+			this,
+			this.attachShadow({ mode: "open" }),
+			ddeComponent
+		);
+	}
+}
+customElementWithDDE(B);
+customElements.define(B.tagName, B);
+export class C extends HTMLElement{
+	static tagName= "custom-element-closed";
+	connectedCallback(){
+		customElementRender(
+			this,
+			this.attachShadow({ mode: "closed" }),
+			ddeComponent
+		);
+	}
+}
+customElementWithDDE(C);
+customElements.define(C.tagName, C);
+
+document.body.append(
+	el(A.tagName).append("Without shadowRoot"),
+	el("hr"),
+	el(B.tagName).append("Open shadowRoot"),
+	el("hr"),
+	el(C.tagName).append("Closed shadowRoot"),
+	el("style", `
+		.red{ color: crimson; }
+	`),
+);
+console.log(A.tagName, "expect modifications");
+document.body.querySelector(A.tagName).querySelector("p").textContent+= " (editable with JS)";
+console.log(B.tagName, "expect modifications");
+document.body.querySelector(B.tagName).shadowRoot.querySelector("p").textContent+= " (editable with JS)";
+console.log(C.tagName, "expect error ↓");
+document.body.querySelector(C.tagName).querySelector("p").textContent+= " (editable with JS)";

docs/components/examples/customElement/simulateSlots.js

@@ -0,0 +1,41 @@
+import {
+	customElementRender,
+	customElementWithDDE,
+	el,
+	simulateSlots
+} from "deka-dom-el";
+export class HTMLCustomElement extends HTMLElement{
+	static tagName= "custom-slotting";
+	connectedCallback(){
+		const c= ()=> simulateSlots(this, ddeComponent());
+		customElementRender(this, this, c);
+	}
+}
+customElementWithDDE(HTMLCustomElement);
+customElements.define(HTMLCustomElement.tagName, HTMLCustomElement);
+
+document.body.append(
+	el(HTMLCustomElement.tagName),
+	el(HTMLCustomElement.tagName).append(
+		"Slot"
+	),
+	el(ddeComponentSlot),
+	el(ddeComponentSlot).append(
+		"Slot"
+	),
+);
+
+function ddeComponent(){
+	return el().append(
+		el("p").append(
+			"Hello ", el("slot", "World")
+		)
+	);
+}
+function ddeComponentSlot(){
+	return simulateSlots(el().append(
+		el("p").append(
+			"Hello ", el("slot", "World")
+		)
+	));
+}

docs/components/examples/introducing/3ps.js

@@ -0,0 +1,6 @@
+// pseudo code!
+const onchage=
+	event=>
+		console.log("Reacting to the:", event); // A
+input.addEventListener("change", onchange); // B
+input.dispatchEvent(new Event("change")); // C

docs/components/examples/introducing/helloWorld.js

@@ -1,15 +1,15 @@
 import { el } from "deka-dom-el";
 import { S } from "deka-dom-el/signals";
-const clicks= S(0);
+const clicks= S(0); // A
 document.body.append(
 	el().append(
 		el("p", S(()=>
-			"Hello World "+"🎉".repeat(clicks())
+			"Hello World "+"🎉".repeat(clicks()) // B
 		)),
 		el("button", {
 			type: "button",
-			onclick: ()=> clicks(clicks()+1),
-			textContent: "Fire"
+			onclick: ()=> clicks(clicks()+1), // C
+			textContent: "Fire",
 		})
 	)
 );

docs/components/mnemonic/customElement-init.js

@@ -4,7 +4,7 @@ import { mnemonicUl } from "../mnemonicUl.html.js";
 export function mnemonic(){
 	return mnemonicUl().append(
 		el("li").append(
-			el("code", "customElementRender(<custom-element>, <render-function>[, <properties>])"), " — use function to render DOM structure for given <custom-element>",
+			el("code", "customElementRender(<custom-element>, <connect-target>, <render-function>[, <properties>])"), " — use function to render DOM structure for given <custom-element>",
 		),
 		el("li").append(
 			el("code", "customElementWithDDE(<custom-element>)"), " — register <custom-element> to DDE library, see also `lifecyclesToEvents`, can be also used as decorator",
@@ -17,6 +17,12 @@ export function mnemonic(){
 		),
 		el("li").append(
 			el("code", "lifecyclesToEvents(<class-declaration>)"), " — convert lifecycle methods to events, can be also used as decorator",
-		)
+		),
+		el("li").append(
+			el("code", "simulateSlots(<class-instance>, <body>[, <mapper>])"), " — simulate slots for Custom Elements without shadow DOM",
+		),
+		el("li").append(
+			el("code", "simulateSlots(<dde-component>[, <mapper>])"), " — simulate slots for “dde”/functional components",
+		),
 	);
 }

docs/flems_soubory/commandline.html

@@ -1,15 +0,0 @@
-<!DOCTYPE html>
-<html class="TridactylOwnNamespace TridactylThemeDark"><head>
-<meta http-equiv="content-type" content="text/html; charset=UTF-8">
-        <meta charset="utf-8">
-        <title>Tridactyl commandline</title>
-	<link rel="stylesheet" href="commandline_data/cleanslate.css">
-	<link rel="stylesheet" href="commandline_data/commandline.css">
-    </head>
-    <body>
-        <div id="completions"></div>
-        <div id="command-line-holder"><span id="tridactyl-colon"></span><input id="tridactyl-input"></div>
-        <script src="commandline_data/commandline_frame.js"></script>
-    
-
-</body></html>

docs/flems_soubory/commandline_data/cleanslate.css

@@ -1,449 +0,0 @@
-/*!
-* CleanSlate
-*   github.com/premasagar/cleanslate
-*
-*//*
-    An extreme CSS reset stylesheet, for normalising the styling of a container element and its children.
-
-    by Premasagar Rose
-        dharmafly.com
-
-    license
-        opensource.org/licenses/mit-license.php
-
-    **
-        
-    v0.9.3
-        
-*/
-
-/* == BLANKET RESET RULES == */
-
-/* HTML 4.01 */
-.cleanslate, .cleanslate h1, .cleanslate h2, .cleanslate h3, .cleanslate h4, .cleanslate h5, .cleanslate h6, .cleanslate p, .cleanslate td, .cleanslate dl, .cleanslate tr, .cleanslate dt, .cleanslate ol, .cleanslate form, .cleanslate select, .cleanslate option, .cleanslate pre, .cleanslate div, .cleanslate table,  .cleanslate th, .cleanslate tbody, .cleanslate tfoot, .cleanslate caption, .cleanslate thead, .cleanslate ul, .cleanslate li, .cleanslate address, .cleanslate blockquote, .cleanslate dd, .cleanslate fieldset, .cleanslate li, .cleanslate iframe, .cleanslate strong, .cleanslate legend, .cleanslate em, .cleanslate summary, .cleanslate cite, .cleanslate span, .cleanslate input, .cleanslate sup, .cleanslate label, .cleanslate dfn, .cleanslate object, .cleanslate big, .cleanslate q, .cleanslate samp, .cleanslate acronym, .cleanslate small, .cleanslate img, .cleanslate strike, .cleanslate code, .cleanslate sub, .cleanslate ins, .cleanslate textarea, .cleanslate button, .cleanslate var, .cleanslate a, .cleanslate abbr, .cleanslate applet, .cleanslate del, .cleanslate kbd, .cleanslate tt, .cleanslate b, .cleanslate i, .cleanslate hr,
-
-/* HTML5 - Sept 2013 taken from MDN https://developer.mozilla.org/en-US/docs/Web/Guide/HTML/HTML5/HTML5_element_list */
-.cleanslate article, .cleanslate aside, .cleanslate figure, .cleanslate figcaption, .cleanslate footer, .cleanslate header, .cleanslate menu, .cleanslate nav, .cleanslate section, .cleanslate time, .cleanslate mark, .cleanslate audio, .cleanslate video, .cleanslate abbr, .cleanslate address, .cleanslate area, .cleanslate blockquote, .cleanslate canvas, .cleanslate caption, .cleanslate cite, .cleanslate code, .cleanslate colgroup, .cleanslate col, .cleanslate datalist, .cleanslate fieldset, .cleanslate main, .cleanslate map, .cleanslate meta, .cleanslate optgroup, .cleanslate output, .cleanslate progress {
-    background-attachment:scroll !important;
-    background-color:transparent !important;
-    background-image:none !important; /* This rule affects the use of pngfix JavaScript http://dillerdesign.com/experiment/DD_BelatedPNG for IE6, which is used to force the browser to recognise alpha-transparent PNGs files that replace the IE6 lack of PNG transparency. (The rule overrides the VML image that is used to replace the given CSS background-image). If you don't know what that means, then you probably haven't used the pngfix script, and this comment may be ignored :) */
-    background-position:0 0 !important;
-    background-repeat:repeat !important;
-    border-color:black !important;
-    border-color:currentColor !important; /* `border-color` should match font color. Modern browsers (incl. IE9) allow the use of "currentColor" to match the current font 'color' value <http://www.w3.org/TR/css3-color/#currentcolor>. For older browsers, a default of 'black' is given before this rule. Guideline to support older browsers: if you haven't already declared a border-color for an element, be sure to do so, e.g. when you first declare the border-width. */
-    border-radius:0 !important;
-    border-style:none !important;
-    border-width:medium !important;
-    bottom:auto !important;
-    clear:none !important;
-    clip:auto !important;
-    color:inherit !important;
-    counter-increment:none !important;
-    counter-reset:none !important;
-    cursor:auto !important;
-    direction:inherit !important;
-    display:inline !important;
-    float:none !important;
-    font-family: inherit !important; /* As with other inherit values, this needs to be set on the root container element */
-    font-size: inherit !important;
-    font-style:inherit !important;
-    font-variant:normal !important;
-    font-weight:inherit !important;
-    height:auto !important;
-    left:auto !important;
-    letter-spacing:normal !important;
-    line-height:inherit !important;
-    list-style-type: inherit !important; /* Could set list-style-type to none */
-    list-style-position: outside !important;
-    list-style-image: none !important;
-    margin:0 !important;
-    max-height:none !important;
-    max-width:none !important;
-    min-height:0 !important;
-    min-width:0 !important;
-    opacity:1;
-    outline:invert none medium !important;
-    overflow:visible !important;
-    padding:0 !important;
-    position:static !important;
-    quotes: "" "" !important;
-    right:auto !important;
-    table-layout:auto !important;
-    text-align:inherit !important;
-    text-decoration:inherit !important;
-    text-indent:0 !important;
-    text-transform:none !important;
-    top:auto !important;
-    unicode-bidi:normal !important;
-    vertical-align:baseline !important;
-    visibility:inherit !important;
-    white-space:normal !important;
-    width:auto !important;
-    word-spacing:normal !important;
-    z-index:auto !important;
-    
-    /* CSS3 */
-    /* Including all prefixes according to http://caniuse.com/ */
-    /* CSS Animations don't cascade, so don't require resetting */
-    -webkit-background-origin: padding-box !important;
-            background-origin: padding-box !important;
-    -webkit-background-clip: border-box !important;
-            background-clip: border-box !important;
-    -webkit-background-size: auto !important;
-       -moz-background-size: auto !important;
-            background-size: auto !important;
-    -webkit-border-image: none !important;
-       -moz-border-image: none !important;
-         -o-border-image: none !important;
-            border-image: none !important;
-    -webkit-border-radius:0 !important;
-       -moz-border-radius:0 !important;
-            border-radius: 0 !important;
-    -webkit-box-shadow: none !important;
-            box-shadow: none !important;
-    -webkit-box-sizing: content-box !important;
-       -moz-box-sizing: content-box !important;
-            box-sizing: content-box !important;
-    -webkit-column-count: auto !important;
-       -moz-column-count: auto !important;
-            column-count: auto !important;
-    -webkit-column-gap: normal !important;
-       -moz-column-gap: normal !important;
-            column-gap: normal !important;
-    -webkit-column-rule: medium none black !important;
-       -moz-column-rule: medium none black !important;
-            column-rule: medium none black !important;
-    -webkit-column-span: 1 !important;
-       -moz-column-span: 1 !important; /* doesn't exist yet but probably will */
-            column-span: 1 !important;
-    -webkit-column-width: auto !important;
-       -moz-column-width: auto !important;
-            column-width: auto !important;
-    font-feature-settings: normal !important;
-    overflow-x: visible !important;
-    overflow-y: visible !important;
-    -webkit-hyphens: manual !important;
-       -moz-hyphens: manual !important;
-            hyphens: manual !important;
-    -webkit-perspective: none !important;
-       -moz-perspective: none !important;
-        -ms-perspective: none !important;
-         -o-perspective: none !important;
-            perspective: none !important;
-    -webkit-perspective-origin: 50% 50% !important;
-       -moz-perspective-origin: 50% 50% !important;
-        -ms-perspective-origin: 50% 50% !important;
-         -o-perspective-origin: 50% 50% !important;
-            perspective-origin: 50% 50% !important;
-    -webkit-backface-visibility: visible !important;
-       -moz-backface-visibility: visible !important;
-        -ms-backface-visibility: visible !important;
-         -o-backface-visibility: visible !important;
-            backface-visibility: visible !important;
-    text-shadow: none !important;
-    -webkit-transition: all 0s ease 0s !important;
-            transition: all 0s ease 0s !important;
-    -webkit-transform: none !important;
-       -moz-transform: none !important;
-        -ms-transform: none !important;
-         -o-transform: none !important;
-            transform: none !important;
-    -webkit-transform-origin: 50% 50% !important;
-       -moz-transform-origin: 50% 50% !important;
-        -ms-transform-origin: 50% 50% !important;
-         -o-transform-origin: 50% 50% !important;
-            transform-origin: 50% 50% !important;
-    -webkit-transform-style: flat !important;
-       -moz-transform-style: flat !important;
-        -ms-transform-style: flat !important;
-         -o-transform-style: flat !important;
-            transform-style: flat !important;
-    word-break: normal !important;
-}
-
-/* == BLOCK-LEVEL == */
-/* Actually, some of these should be inline-block and other values, but block works fine (TODO: rigorously verify this) */
-/* HTML 4.01 */
-.cleanslate, .cleanslate h3, .cleanslate h5, .cleanslate p, .cleanslate h1, .cleanslate dl, .cleanslate dt, .cleanslate h6, .cleanslate ol, .cleanslate form, .cleanslate option, .cleanslate pre, .cleanslate div, .cleanslate h2, .cleanslate caption, .cleanslate h4, .cleanslate ul, .cleanslate address, .cleanslate blockquote, .cleanslate dd, .cleanslate fieldset, .cleanslate hr,
-
-/* HTML5 new elements */
-.cleanslate article, .cleanslate dialog, .cleanslate figure, .cleanslate footer, .cleanslate header, .cleanslate hgroup, .cleanslate menu, .cleanslate nav, .cleanslate section, .cleanslate audio, .cleanslate video, .cleanslate address, .cleanslate blockquote, .cleanslate colgroup, .cleanslate main, .cleanslate progress, .cleanslate summary {
-    display:block !important; 
-}
-.cleanslate h1, .cleanslate h2, .cleanslate h3, .cleanslate h4, .cleanslate h5, .cleanslate h6 {
-    font-weight: bold !important;
-}
-.cleanslate h1 {
-    font-size: 2em !important;
-    padding: .67em 0 !important;
-}
-.cleanslate h2 {
-    font-size: 1.5em !important;
-    padding: .83em 0 !important;
-}
-.cleanslate h3 {
-    font-size: 1.17em !important;
-    padding: .83em 0 !important;
-}
-.cleanslate h4 {
-    font-size: 1em !important;
-}
-.cleanslate h5 {
-    font-size: .83em !important;
-}
-.cleanslate p {
-    margin: 1em 0 !important;
-}
-.cleanslate table {
-    display: table !important;
-}
-.cleanslate thead {
-    display: table-header-group !important;
-}
-.cleanslate tbody {
-    display: table-row-group !important;
-}
-.cleanslate tfoot {
-    display: table-footer-group !important;
-}
-.cleanslate tr {
-    display: table-row !important;
-}
-.cleanslate th, .cleanslate td {
-    display: table-cell !important;
-    padding: 2px !important;
-}
-
-/* == SPECIFIC ELEMENTS == */
-/* Some of these are browser defaults; some are just useful resets */
-.cleanslate ol, .cleanslate ul {
-    margin: 1em 0 !important;
-}
-.cleanslate ul li, .cleanslate ul ul li, .cleanslate ul ul ul li, .cleanslate ol li, .cleanslate ol ol li, .cleanslate ol ol ol li, .cleanslate ul ol ol li, .cleanslate ul ul ol li, .cleanslate ol ul ul li, .cleanslate ol ol ul li {
-    list-style-position: inside !important;
-    margin-top: .08em !important;
-}
-.cleanslate ol ol, .cleanslate ol ol ol, .cleanslate ul ul, .cleanslate ul ul ul, .cleanslate ol ul, .cleanslate ol ul ul, .cleanslate ol ol ul, .cleanslate ul ol, .cleanslate ul ol ol, .cleanslate ul ul ol {
-    padding-left: 40px !important;
-    margin: 0 !important;
-}
-/* helper for general navigation */
-.cleanslate nav ul, .cleanslate nav ol {
-    list-style-type:none !important;
-
-}
-.cleanslate ul, .cleanslate menu {
-    list-style-type:disc !important;
-}
-.cleanslate ol {
-    list-style-type:decimal !important;
-}
-.cleanslate ol ul, .cleanslate ul ul, .cleanslate menu ul, .cleanslate ol menu, .cleanslate ul menu, .cleanslate menu menu {
-    list-style-type:circle !important;
-}
-.cleanslate ol ol ul, .cleanslate ol ul ul, .cleanslate ol menu ul, .cleanslate ol ol menu, .cleanslate ol ul menu, .cleanslate ol menu menu, .cleanslate ul ol ul, .cleanslate ul ul ul, .cleanslate ul menu ul, .cleanslate ul ol menu, .cleanslate ul ul menu, .cleanslate ul menu menu, .cleanslate menu ol ul, .cleanslate menu ul ul, .cleanslate menu menu ul, .cleanslate menu ol menu, .cleanslate menu ul menu, .cleanslate menu menu menu {
-    list-style-type:square !important;
-}
-.cleanslate li {    
-    display:list-item !important;
-    /* Fixes IE7 issue with positioning of nested bullets */
-    min-height:auto !important;
-    min-width:auto !important;
-    padding-left: 20px !important; /* replace -webkit-padding-start: 40px; */
-}
-.cleanslate strong {
-    font-weight:bold !important;
-}
-.cleanslate em {
-    font-style:italic !important;
-}
-.cleanslate kbd, .cleanslate samp, .cleanslate code {
-  font-family:monospace !important;
-}
-.cleanslate a {
-    color: blue !important;
-    text-decoration: underline !important;s
-}
-.cleanslate a:visited {
-    color: #529 !important;
-}
-.cleanslate a, .cleanslate a *, .cleanslate input[type=submit], .cleanslate input[type=radio], .cleanslate input[type=checkbox], .cleanslate select {
-    cursor:pointer !important;
-}
-.cleanslate button, .cleanslate input[type=submit] {
-    text-align: center !important;
-    padding: 2px 6px 3px !important;
-    border-radius: 4px !important;
-    text-decoration: none !important;
-    font-family: arial, helvetica, sans-serif !important;
-    font-size: small !important;
-    background: white !important;
-    -webkit-appearance: push-button !important;
-    color: buttontext !important;
-    border: 1px #a6a6a6 solid !important;
-    background: lightgrey !important; /* Old browsers */
-    background: rgb(255,255,255); /* Old browsers */
-    background: -moz-linear-gradient(top,  rgba(255,255,255,1) 0%, rgba(221,221,221,1) 100%, rgba(209,209,209,1) 100%, rgba(221,221,221,1) 100%) !important; /* FF3.6+ */
-    background: -webkit-gradient(linear, left top, left bottom, color-stop(0%,rgba(255,255,255,1)), color-stop(100%,rgba(221,221,221,1)), color-stop(100%,rgba(209,209,209,1)), color-stop(100%,rgba(221,221,221,1))) !important; /* Chrome,Safari4+ */
-    background: -webkit-linear-gradient(top,  rgba(255,255,255,1) 0%,rgba(221,221,221,1) 100%,rgba(209,209,209,1) 100%,rgba(221,221,221,1) 100%) !important; /* Chrome10+,Safari5.1+ */
-    background: -o-linear-gradient(top,  rgba(255,255,255,1) 0%,rgba(221,221,221,1) 100%,rgba(209,209,209,1) 100%,rgba(221,221,221,1) 100%) !important; /* Opera 11.10+ */
-    background: -ms-linear-gradient(top,  rgba(255,255,255,1) 0%,rgba(221,221,221,1) 100%,rgba(209,209,209,1) 100%,rgba(221,221,221,1) 100%) !important; /* IE10+ */
-    background: linear-gradient(to bottom,  rgba(255,255,255,1) 0%,rgba(221,221,221,1) 100%,rgba(209,209,209,1) 100%,rgba(221,221,221,1) 100%) !important; /* W3C */
-    filter: progid:DXImageTransform.Microsoft.gradient( startColorstr='#ffffff', endColorstr='#dddddd',GradientType=0 ) !important; /* IE6-9 */
-    -webkit-box-shadow: 1px 1px 0px #eee !important;
-       -moz-box-shadow: 1px 1px 0px #eee !important;
-         -o-box-shadow: 1px 1px 0px #eee !important;
-            box-shadow: 1px 1px 0px #eee !important;
-    outline: initial !important;
-}
-.cleanslate button {
-    padding: 1px 6px 2px 6px !important;
-    margin-right: 5px !important;
-}
-.cleanslate input[type=hidden] {
-    display:none !important;
-}
-/* restore form defaults */
-.cleanslate textarea {
-    -webkit-appearance: textarea !important;
-    background: white !important;
-    padding: 2px !important;
-    margin-left: 4px !important;
-    word-wrap: break-word !important;
-    white-space: pre-wrap !important;
-    font-size: 11px !important;
-    font-family: arial, helvetica, sans-serif !important;
-    line-height: 13px !important;
-    resize: both !important;
-}
-.cleanslate select, .cleanslate textarea, .cleanslate input {
-    border:1px solid #ccc !important;
-}
-.cleanslate select {
-    font-size: 11px !important;
-    font-family: helvetica, arial, sans-serif !important;
-    display: inline-block;
-}
-.cleanslate textarea:focus, .cleanslate input:focus {
-    outline: auto 5px -webkit-focus-ring-color !important;
-    outline: initial !important;
-}
-.cleanslate input[type=text] {
-    background: white !important;
-    padding: 1px !important;
-    font-family: initial !important;
-    font-size: small !important;
-}
-.cleanslate input[type=checkbox], .cleanslate input[type=radio] {
-    border: 1px #2b2b2b solid !important;
-    border-radius: 4px !important;
-}
-.cleanslate input[type=checkbox], .cleanslate input[type=radio] {
-    outline: intial !important;
-}
-.cleanslate input[type=radio] {
-    margin: 2px 2px 3px 2px !important;
-}
-.cleanslate input[type=submit]:active, .cleanslate button:active {
-    background: rgb(59,103,158) !important; /* Old browsers */
-    background: -moz-linear-gradient(top, rgba(59,103,158,1) 0%, rgba(43,136,217,1) 50%, rgba(32,124,202,1) 51%, rgba(125,185,232,1) 100%) !important; /* FF3.6+ */
-    background: -webkit-gradient(linear, left top, left bottom, color-stop(0%,rgba(59,103,158,1)), color-stop(50%,rgba(43,136,217,1)), color-stop(51%,rgba(32,124,202,1)), color-stop(100%,rgba(125,185,232,1))) !important; /* Chrome,Safari4+ */
-    background: -webkit-linear-gradient(top, rgba(59,103,158,1) 0%,rgba(43,136,217,1) 50%,rgba(32,124,202,1) 51%,rgba(125,185,232,1) 100%) !important; /* Chrome10+,Safari5.1+ */
-    background: -o-linear-gradient(top, rgba(59,103,158,1) 0%,rgba(43,136,217,1) 50%,rgba(32,124,202,1) 51%,rgba(125,185,232,1) 100%) !important; /* Opera 11.10+ */
-    background: -ms-linear-gradient(top, rgba(59,103,158,1) 0%,rgba(43,136,217,1) 50%,rgba(32,124,202,1) 51%,rgba(125,185,232,1) 100%) !important; /* IE10+ */
-    background: linear-gradient(to bottom, rgba(59,103,158,1) 0%,rgba(43,136,217,1) 50%,rgba(32,124,202,1) 51%,rgba(125,185,232,1) 100%) !important; /* W3C */
-    border-color: #5259b0 !important;
-}
-.cleanslate abbr[title], .cleanslate acronym[title], .cleanslate dfn[title] {
-    cursor:help !important;
-    border-bottom-width:1px !important;
-    border-bottom-style:dotted !important;
-}
-.cleanslate ins {
-    background-color:#ff9 !important;
-    color:black !important;
-}
-.cleanslate del {
-    text-decoration: line-through !important;
-}
-.cleanslate blockquote, .cleanslate q  {
-    quotes:none !important; /* HTML5 */
-}
-.cleanslate blockquote:before, .cleanslate blockquote:after, .cleanslate q:before, .cleanslate q:after, .cleanslate li:before, .cleanslate li:after  {
-    content:"" !important;
-}
-.cleanslate input, .cleanslate select {
-    vertical-align:middle !important;
-}
-
-.cleanslate table {
-    border-collapse:collapse !important;
-    border-spacing:0 !important;
-}
-.cleanslate hr {
-    display:block !important;
-    height:1px !important;
-    border:0 !important;
-    border-top:1px solid #ccc !important;
-    margin:1em 0 !important;
-}
-.cleanslate *[dir=rtl] {
-    direction: rtl !important;
-}
-.cleanslate mark {
-    background-color:#ff9 !important;
-    color:black !important;
-    font-style:italic !important;
-    font-weight:bold !important;
-}
-.cleanslate menu {
-    padding-left: 40px !important;
-    padding-top: 8px !important;
-}
-
-/* additional helpers */
-.cleanslate [hidden],
-.cleanslate template {
-    display: none !important;
-}
-.cleanslate abbr[title] {
-    border-bottom: 1px dotted !important;
-}
-.cleanslate sub, .cleanslate sup {
-    font-size: 75% !important;
-    line-height: 0 !important;
-    position: relative !important;
-    vertical-align: baseline !important;
-}
-.cleanslate sup {
-    top: -0.5em !important;
-}
-.cleanslate sub {
-    bottom: -0.25em !important;
-}
-.cleanslate img {
-    border: 0 !important;
-}
-.cleanslate figure {
-    margin: 0 !important;
-}
-.cleanslate textarea {
-    overflow: auto !important;
-    vertical-align: top !important;
-}
-
-/* == ROOT CONTAINER ELEMENT == */
-/* This contains default values for child elements to inherit  */
-.cleanslate {
-    font-size: medium !important;
-    line-height: 1 !important;
-    direction:ltr !important;
-    text-align: left !important; /* for IE, Opera */
-    text-align: start !important; /* recommended W3C Spec */
-    font-family: "Times New Roman", Times, serif !important; /* Override this with whatever font-family is required */
-    color: black !important;
-    font-style:normal !important;
-    font-weight:normal !important;
-    text-decoration:none !important;
-    list-style-type:disc !important;
-}

docs/flems_soubory/commandline_data/commandline.css

@@ -1,299 +0,0 @@
-@import url("../themes/auto/auto.css");
-
-body {
-    overflow: hidden;
-    margin: 0;
-    position: absolute;
-    /* CSS is pants. Move the bar down a tiny bit to cover up the gap. */
-    top: 1px;
-    width: 100%;
-    display: flex;
-    flex-direction: column;
-}
-
-#command-line-holder {
-    background: var(--tridactyl-cmdl-bg);
-    color: var(--tridactyl-cmdl-fg);
-    font-family: var(--tridactyl-cmdl-font-family);
-    font-size: 9pt;
-    /* reduce the padding added by the colon so that the command line shows up roughly where it used to be */
-    padding-left: 0.125ex;
-}
-
-input {
-    width: 97%;
-    font-family: var(--tridactyl-cmdl-font-family);
-    font-size: var(--tridactyl-cmdl-font-size);
-    line-height: var(--tridactyl-cmdl-line-height);
-    color: var(--tridactyl-cmdl-fg);
-    background: var(--tridactyl-cmdl-bg);
-    border: unset;
-    /* reduce the padding from the colon */
-    /* margin-left: -0.25ex; */
-    /* we currently have a border from the completions */
-    /* border-top: solid 1px lightgray; */
-}
-
-input:focus {
-    outline: none;
-}
-
-#tridactyl-colon::before {
-    content: ":";
-}
-
-/* COMPLETIONS */
-
-#completions {
-    --option-height: var(--tridactyl-cmplt-option-height);
-    color: var(--tridactyl-cmplt-fg);
-    background: var(--tridactyl-cmplt-bg);
-    display: inline-block;
-    font-size: var(--tridactyl-cmplt-font-size);
-    font-family: var(--tridactyl-cmplt-font-family);
-    overflow: hidden;
-    width: 100%;
-    border-top: var(--tridactyl-cmplt-border-top);
-}
-
-/* Olie doesn't know how CSS inheritance works */
-#completions > div {
-    max-height: calc(20 * var(--option-height));
-    min-height: calc(10 * var(--option-height));
-}
-
-#completions > div > table {
-    width: 100%;
-    font-size: 9pt;
-    border-spacing: 0;
-    table-layout: fixed;
-}
-
-#completions table tr td.prefix {
-    width: 3.2em;
-    padding-left: 0.5em;
-    text-align: center;
-}
-#completions table tr td.container,
-#completions table tr td.icon,
-#completions table tr td.privatewindow {
-    width: 1.5em;
-}
-#completions table tr td.tabcount {
-    width: 6em;
-}
-#completions table tr td.tgroup {
-    width: 10em;
-    padding-left: 0.5em;
-    text-align: right;
-}
-#completions table tr td.tgroup:empty {
-    display: none;
-}
-/* #completions table tr td:nth-of-type(3) { width: 5em; } */
-#completions table tr td.content {
-    width: 50%;
-}
-
-/* Accroding to src/completions/TabHistory.ts formatTimeSpan,
- * max-width should be 14 characters (14ex), 20ex for more tolorance. */
-#completions table tr td.time {
-    width: 20ex;
-    text-align: right;
-    padding-right: 2ex;
-}
-
-#completions table tr {
-    white-space: nowrap;
-    overflow: hidden;
-}
-
-#completions table tr td {
-    overflow: hidden;
-}
-
-#completions img {
-    display: inline;
-    vertical-align: middle;
-    height: 1em;
-    width: 1em;
-}
-
-#completions .sectionHeader {
-    background: linear-gradient(
-        var(--tridactyl-header-first-bg),
-        var(--tridactyl-header-second-bg),
-        var(--tridactyl-header-third-bg)
-    );
-    font-size: var(--tridactyl-header-font-size);
-    font-weight: var(--tridactyl-header-font-weight);
-    border-bottom: var(--tridactyl-header-border-bottom);
-    padding-left: 0.5ex;
-}
-
-#completions .sectionHeader,
-#completions .option {
-    height: var(--option-height);
-    line-height: var(--option-height);
-}
-
-.url {
-    text-decoration: var(--tridactyl-url-text-decoration);
-}
-
-.option:not(.focused) .url {
-    color: var(--tridactyl-url-fg);
-    background: var(--tridactyl-url-bg);
-}
-
-a.url:hover {
-    cursor: var(--tridactyl-url-cursor);
-    text-decoration: underline;
-}
-
-/* Hide the URLs if the screen is small */
-@media all and (max-width: 500px) {
-    .url {
-        display: none;
-    }
-}
-
-.FindCompletionOption .match {
-    font-weight: bold;
-}
-
-.hidden {
-    display: none;
-}
-
-/* Pick the .url out especially because otherwise its link styles dominate. */
-.focused,
-.focused .url {
-    color: var(--tridactyl-of-fg);
-    background: var(--tridactyl-of-bg);
-}
-
-.option.incognito .privatewindow {
-    background-image: var(--tridactyl-private-window-icon-url);
-}
-
-/* Still completions, but container-related stuff */
-.option .container {
-    mask-size: 1em;
-    mask-repeat: no-repeat;
-    mask-position: center;
-}
-.option .privatewindow {
-    background-size: 1em;
-    background-repeat: no-repeat;
-    background-position: center;
-}
-.option.container_blue .container {
-    background-color: var(--tridactyl-container-color-blue);
-}
-.option.container_turquoise .container {
-    background-color: var(--tridactyl-container-color-turquoise);
-}
-.option.container_green .container {
-    background-color: var(--tridactyl-container-color-green);
-}
-.option.container_yellow .container {
-    background-color: var(--tridactyl-container-color-yellow);
-}
-.option.container_orange .container {
-    background-color: var(--tridactyl-container-color-orange);
-}
-.option.container_red .container {
-    background-color: var(--tridactyl-container-color-red);
-}
-.option.container_pink .container {
-    background-color: var(--tridactyl-container-color-pink);
-}
-.option.container_purple .container {
-    background-color: var(--tridactyl-container-color-purple);
-}
-.option.container_fingerprint .container {
-    mask-image: var(--tridactyl-container-fingerprint-url);
-}
-.option.container_briefcase .container {
-    mask-image: var(--tridactyl-container-briefcase-url);
-}
-.option.container_dollar .container {
-    mask-image: var(--tridactyl-container-dollar-url);
-}
-.option.container_cart .container {
-    mask-image: var(--tridactyl-container-cart-url);
-}
-.option.container_circle .container {
-    mask-image: var(--tridactyl-container-circle-url);
-}
-.option.container_gift .container {
-    mask-image: var(--tridactyl-container-gift-url);
-}
-.option.container_vacation .container {
-    mask-image: var(--tridactyl-container-vacation-url);
-}
-.option.container_food .container {
-    mask-image: var(--tridactyl-container-food-url);
-}
-.option.container_fruit .container {
-    mask-image: var(--tridactyl-container-fruit-url);
-}
-.option.container_pet .container {
-    mask-image: var(--tridactyl-container-pet-url);
-}
-.option.container_tree .container {
-    mask-image: var(--tridactyl-container-tree-url);
-}
-.option.container_chill .container {
-    mask-image: var(--tridactyl-container-chill-url);
-}
-
-.ExcmdCompletionOption td.excmd {
-    padding-left: 0.5em;
-    width: 20%;
-}
-
-.ExcmdCompletionOption td.documentation {
-    width: 100%;
-}
-
-.SettingsCompletionOption td.title {
-    padding-left: 0.5em;
-}
-
-#completions .SettingsCompletionOption td.title,
-#completions .SettingsCompletionOption td.content,
-#completions .SettingsCompletionOption td.type {
-    width: 15%;
-    text-overflow: ellipsis;
-}
-
-#completions .TabGroupCompletionOption td.title {
-    width: 15%;
-}
-
-#completions .TabGroupCompletionOption td.content {
-    width: auto;
-}
-
-.HelpCompletionOption td.name {
-    width: 25%;
-}
-
-#completions .SessionCompletionOption td.type {
-    width: 1ch !important;
-    padding: 0px 3pt;
-}
-
-#completions .SessionCompletionOption td.time {
-    width: 5ch !important;
-    padding: 0px 3pt;
-    text-align: right;
-}
-
-#completions .WindowCompletionOption td.id {
-    width: 6ch !important;
-    text-align: right;
-    padding: 0px 8pt;
-}

docs/global.css

@@ -1,172 +0,0 @@
-@import url(https://cdn.simplecss.org/simple.min.css);
-:root{
-	--body-max-width: 45rem;
-	--marked: #fb3779;
-	--code: #0d47a1;
-	--accent: #d81b60;
-}
-@media (prefers-color-scheme:dark) {
-	:root {
-		--accent: #f06292;
-		--code: #62c1f0;
-	}
-}
-body {
-	grid-template-columns: 100%;
-	grid-template-areas: "header" "sidebar" "content";
-}
-@media (min-width:768px) {
-	body{
-		grid-template-rows: auto auto;
-		grid-template-columns: calc(10 * var(--body-max-width) / 27) auto;
-		grid-template-areas:
-			"header header"
-			"sidebar content"
-	}
-}
-body > *{
-	grid-column: unset;
-}
-body > header{
-	grid-area: header;
-	padding: 0;
-}
-body > nav{
-	grid-area: sidebar;
-	background-color: var(--accent-bg);
-	display: flex;
-	flex-flow: column nowrap;
-}
-body > nav {
-	font-size: 1rem;
-	line-height: 2;
-	padding: 1rem 0 0 0;
-}
-body > nav ol,
-body > nav ul {
-	align-content: space-around;
-	align-items: center;
-	display: flex;
-	flex-direction: row;
-	flex-wrap: wrap;
-	justify-content: center;
-	list-style-type: none;
-	margin: 0;
-	padding: 0;
-}
-body > nav ol li,
-body > nav ul li {
-	display:inline-block
-}
-body > nav a,
-body > nav a:visited {
-	margin: 0 .5rem 1rem .5rem;
-	border: 1px solid currentColor;
-	border-radius: var(--standard-border-radius);
-	color: var(--text-light);
-	display: inline-block;
-	padding: .1rem 1rem;
-	text-decoration: none;
-	cursor: pointer;
-	transition: all .15s;
-}
-body > nav a.current,
-body > nav a[aria-current=page] {
-	background-color: var(--bg);
-	color: var(--text);
-}
-body > nav a:hover{
-	background-color: var(--bg);
-	color: var(--accent);
-}
-@media only screen and (max-width:720px) {
-	body > nav{
-		flex-flow: row wrap;
-		padding-block: .5rem;
-	}
-	body > nav a {
-		border:none;
-		text-decoration:underline;
-		margin-block: .1rem;
-		padding-block:.1rem;
-		line-height: 1rem;
-		font-size: .9rem;
-	}
-}
-main{
-	grid-area: content;
-	display: grid;
-	grid-template-columns:
-	[full-main-start] 1fr
-	[main-start] min(var(--body-max-width), 90%) [main-end]
-	1fr [full-main-end];
-}
-main > *{
-	grid-column: main;
-}
-.icon {
-	vertical-align: sub;
-	padding-right: .25rem;
-	display: inline-block;
-	width: 1em;
-	height: 1.3em;
-	margin-right: 0.2rem;
-	stroke-width: 0;
-	stroke: currentColor;
-	fill: currentColor;
-}
-.note{
-	font-size: .9rem;
-	font-style: italic;
-}
-.prevNext{
-	display: grid;
-	grid-template-columns: 1fr 2fr 1fr;
-	margin-top: 1rem;
-	border-top: 1px solid var(--border);
-}
-.prevNext [rel=prev]{
-	grid-column: 1;
-}
-.prevNext [rel=next]{
-	grid-column: 3;
-	text-align: right;
-}
-.code{
-	--shiki-color-text: #e9eded;
-	--shiki-color-background: #212121;
-	--shiki-token-constant: #82b1ff;
-	--shiki-token-string: #c3e88d;
-	--shiki-token-comment: #546e7a;
-	--shiki-token-keyword: #c792ea;
-	--shiki-token-parameter: #AA0000;
-	--shiki-token-function: #80cbae;
-	--shiki-token-string-expression: #c3e88d;
-	--shiki-token-punctuation: var(--code);
-	--shiki-token-link: #EE0000;
-	white-space: pre;
-	tab-size: 2;
-	overflow: scroll;
-}
-.code[data-js=todo]{
-	border: 1px solid var(--border);
-	border-radius: var(--standard-border-radius);
-	margin-bottom: 1rem;
-	
-	margin-top: 18.4px;
-	padding: 1rem 1.4rem;
-}
-.example{
-	grid-column: full-main;
-	width: 100%;
-	max-width: calc(9/5 * var(--body-max-width));
-	height: calc(3/5 * var(--body-max-width));
-	margin-inline: auto;
-}
-.CodeMirror, .CodeMirror-gutters {
-	background: #212121 !important;
-	border: 1px solid white;
-}
-.notice h3{
-	margin-top: 0;
-}

docs/index.html.js

@@ -0,0 +1,62 @@
+import { t, T } from "./utils/index.js";
+export const info= {
+	href: "./",
+	title: t`Introduction`,
+	description: t`Introducing a library.`,
+};
+
+import { el } from "deka-dom-el";
+import { simplePage } from "./layout/simplePage.html.js";
+import { h3 } from "./components/pageUtils.html.js";
+import { example } from "./components/example.html.js";
+import { code } from "./components/code.html.js";
+/** @param {string} url */
+const fileURL= url=> new URL(url, import.meta.url);
+const references= {
+	w_mvv:{
+		title: t`Wikipedia: Model–view–viewmodel`,
+		href: "https://en.wikipedia.org/wiki/Model%E2%80%93view%E2%80%93viewmodel",
+	},
+	w_mvc: {
+		title: t`Wikipedia: Model–view–controller`,
+		href: "https://en.wikipedia.org/wiki/Model%E2%80%93view%E2%80%93controller",
+	},
+};
+/** @param {import("./types.d.ts").PageAttrs} attrs */
+export function page({ pkg, info }){
+	const page_id= info.id;
+	return el(simplePage, { info, pkg }).append(
+		el("p", t`The library tries to provide pure JavaScript tool(s) to create reactive interfaces using …`),
+		
+		el(h3, t`Event-driven programming (3 parts separation ≡ 3PS)`),
+		el("p").append(t`
+			Let's introduce the basic principle on which the library is built. We'll use the JavaScript listener as
+			a starting point.
+		`),
+		el(code, { src: fileURL("./components/examples/introducing/3ps.js"), page_id }),
+		el("p").append(...T`
+			As we can see, in the code at location “A” we define ${el("em", t`how to react`)} when the function
+			is called with any event as an argument. At that moment, we ${el("em", t`don't care who/why/how`)}
+			the function was called. Similarly, at point “B”, we reference to a function to be called on the event
+			${el("em", t`without caring`)} what the function will do at that time. Finally, at point “C”, we tell
+			the application that a change has occurred, in the input, and we ${el("em", t`don't care if/how someone`)}
+			is listening for the event.
+		`),
+		el(example, { src: fileURL("./components/examples/introducing/helloWorld.js"), page_id }),
+		el("p").append(...T`
+			The library introduces a new “type” of variable/constant called ${el("em", t`signal`)} allowing us to
+			to use introduced 3PS pattern in our applications. As you can see it in the example above.
+		`),
+		el("p").append(...T`
+			Also please notice that there is very similar 3PS pattern used for separate creation of UI and
+			business logic.
+		`),
+		el("p").append(...T`
+			The 3PS is very simplified definition of the pattern. There are more deep/academic definitions more precisely
+			describe usage in specific situations, see for example ${el("a", { textContent: t`MVVM`, ...references.w_mvv })}
+			or ${el("a", { textContent: t`MVC`, ...references.w_mvc })}.
+		`),
+		
+		el(h3, t`Organization of the documentation`),
+	);
+}

docs/p02-elements.html.js

@@ -0,0 +1,155 @@
+import { T, t } from "./utils/index.js";
+export const info= {
+	title: t`Elements`,
+	description: t`Basic concepts of elements modifications and creations.`,
+};
+
+import { el } from "deka-dom-el";
+import { simplePage } from "./layout/simplePage.html.js";
+import { example } from "./components/example.html.js";
+import { h3 } from "./components/pageUtils.html.js";
+import { mnemonic } from "./components/mnemonic/elements-init.js";
+import { code } from "./components/code.html.js";
+/** @param {string} url */
+const fileURL= url=> new URL(url, import.meta.url);
+const references= {
+	/** document.createElement() */
+	mdn_create: {
+		title: t`MDN documentation page for document.createElement()`,
+		href: "https://developer.mozilla.org/en-US/docs/Web/API/Document/createElement",
+	},
+	/** Interface Description Language (`el.textContent`) */
+	mdn_idl: {
+		title: t`MDN page about Interface Description Language`,
+		href: "https://developer.mozilla.org/en-US/docs/Glossary/IDL",
+	},
+	/** HTMLElement */
+	mdn_el: {
+		title: t`MDN documentation page for HTMLElement`,
+		href: "https://developer.mozilla.org/en-US/docs/Web/API/HTMLElement"
+	},
+	/** HTMLParagraphElement */
+	mdn_p: {
+		title: t`MDN documentation page for HTMLParagraphElement (\`p\` tag)`,
+		href: "https://developer.mozilla.org/en-US/docs/Web/API/HTMLParagraphElement"
+	},
+	/** `[a, b] = [1, 2]` */
+	mdn_destruct: {
+		title: t`MDN page about destructuring assignment syntax (e.g. \`[a, b] = [1, 2]\`)`,
+		href: "https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Operators/Destructuring_assignment",
+	},
+	/** document.createElementNS() */
+	mdn_ns: {
+		title: t`MDN documentation page for document.createElementNS() (e.g. for SVG elements)`,
+		href: "https://developer.mozilla.org/en-US/docs/Web/API/Document/createElementNS",
+	}
+};
+/** @param {import("./types.d.ts").PageAttrs} attrs */
+export function page({ pkg, info }){
+	const page_id= info.id;
+	return el(simplePage, { info, pkg }).append(
+		el("h2", t`Native JavaScript DOM elements creations`),
+		el("p", t`
+			Let’s go through all patterns we would like to use and what needs to be improved for better experience.
+		`),
+
+		el(code, { src: fileURL("./components/examples/elements/intro.js"), page_id }),
+		
+		el(h3, t`Creating element(s) (with custom attributes)`),
+		el("p").append(...T`
+			You can create a native DOM element by using the ${el("a", references.mdn_create).append(
+			el("code", "document.createElement()") )}. It is also possible to provide a some attribute(s) declaratively
+			using ${el("code", "Object.assign()")}. More precisely, this way you can sets some
+			${el("a", references.mdn_idl).append( el("abbr", { textContent: "IDL", title: "Interface Description Language" }))}
+			also known as a JavaScript property.
+		`),
+		el(example, { src: fileURL("./components/examples/elements/nativeCreateElement.js"), page_id }),
+		el("p").append(...T`
+			To make this easier, you can use the ${el("code", "el")} function. Internally in basic examples,
+			it is wrapper around ${el("code", "assign(document.createElement(…), { … })")}.
+		`),
+		el(example, { src: fileURL("./components/examples/elements/dekaCreateElement.js"), page_id }),
+		el("p").append(...T`
+			The ${el("code", "assign")} function provides improved behaviour of ${el("code", "Object.assign()")}.
+			You can declaratively sets any IDL and attribute of the given element. Function prefers IDL and fallback
+			to the ${el("code", "element.setAttribute")} if there is no writable property in the element prototype.
+		`),
+		el("p").append(...T`
+			You can study all JavaScript elements interfaces to the corresponding HTML elements. All HTML elements
+			inherits from ${el("a", { textContent: "HTMLElement", ...references.mdn_el })}. To see
+			all available IDLs for example for paragraphs, see ${el("a", { textContent: "HTMLParagraphElement", ...references.mdn_p })}.
+			Moreover, the ${el("code", "assign")} provides a way to sets declaratively some convenient properties:
+		`),
+		el("ul").append(
+			el("li").append(...T`
+				It is possible to sets ${el("code", "data-*")}/${el("code", "aria-*")} attributes using object notation.
+			`),
+			el("li").append(...T`
+				In opposite, it is also possible to sets ${el("code", "data-*")}/${el("code", "aria-*")} attribute
+				using camelCase notation.
+			`),
+			el("li").append(...T`You can use string or object as a value for ${el("code", "style")} property.`),
+			el("li").append(...T`
+				${el("code", "className")} (IDL – preffered)/${el("code", "class")} are ways to add CSS classes
+				to the element. You can use string (similarly to ${el("code", "class=\"…\"")} syntax in  HTML) or
+				array of strings. This is handy to concat conditional classes.
+			`),
+			el("li").append(...T`
+				Use ${el("code", "classList")} to toggle specific classes. This will be handy later when
+				the reactivity via signals is beeing introduced.
+			`),
+			el("li").append(...T`
+				The ${el("code", "assign")} also accepts the ${el("code", "undefined")} as a value for any property
+				to remove it from the element declaratively. Also for some IDL the corresponding attribute is removed
+				as it can be confusing. ${el("em").append(...T`For example, natievly the element’s ${el("code", "id")}
+				is removed by setting the IDL to an empty string.`)}
+			`),
+			el("li").append(...T`
+				You can use ${el("code", "=")} or ${el("code", ".")} to force processing given key as attribute/property
+				of the element.
+			`)
+		),
+		el("p").append(...T`
+			For processing, the ${el("code", "assign")} internally uses ${el("code", "assignAttribute")} and
+			${el("code", "classListDeclarative")}.
+		`),
+		el(example, { src: fileURL("./components/examples/elements/dekaAssign.js"), page_id }),
+		
+		el(h3, t`Native JavaScript templating`),
+		el("p", t`By default, the native JS has no good way to define HTML template using DOM API:`),
+		el(example, { src: fileURL("./components/examples/elements/nativeAppend.js"), page_id }),
+		el("p").append(...T`
+			This library therefore overwrites the ${el("code", "append")} method of created elements to always return
+			parent element.
+		`),
+		el(example, { src: fileURL("./components/examples/elements/dekaAppend.js"), page_id }),
+		
+		
+		el(h3, t`Basic (state-less) components`),
+		el("p").append(...T`
+			You can use functions for encapsulation (repeating) logic. The ${el("code", "el")} accepts function
+			as first argument. In that case, the function should return dom elements and the second argument for
+			${el("code", "el")} is argument for given element.
+		`),
+		el(example, { src: fileURL("./components/examples/elements/dekaBasicComponent.js"), page_id }),
+		el("p").append(...T`
+			As you can see, in case of state-less/basic components there is no difference between calling component
+			function directly or using ${el("code", "el")} function.
+		`),
+		el("p", { className: "notice" }).append(...T`
+			It is nice to use similar naming convention as native DOM API. This allows us to use
+			${el("a", { textContent: t`the destructuring assignment syntax`, ...references.mdn_destruct })} and keep
+			track of the native API (things are best remembered through regular use).
+		`),
+
+		el(h3, t`Creating non-HTML elements`),
+		el("p").append(...T`
+			Similarly to the native DOM API (${el("a", references.mdn_ns).append(el("code", "document.createElementNS"))})
+			for non-HTML elements we need to tell JavaScript which kind of the element to create. We can use
+			the ${el("code", "elNS")} function:
+		`),
+		el(example, { src: fileURL("./components/examples/elements/dekaElNS.js"), page_id }),
+		
+		el(mnemonic)
+	);
+}

docs/p03-events.html.js

@@ -0,0 +1,149 @@
+import { T, t } from "./utils/index.js";
+export const info= {
+	title: t`Events and Addons`,
+	description: t`Using not only events in UI declaratively.`,
+};
+
+import { el } from "deka-dom-el";
+import { simplePage } from "./layout/simplePage.html.js";
+import { example } from "./components/example.html.js";
+import { h3 } from "./components/pageUtils.html.js";
+import { mnemonic } from "./components/mnemonic/events-init.js";
+import { code } from "./components/code.html.js";
+/** @param {string} url */
+const fileURL= url=> new URL(url, import.meta.url);
+const references= {
+	/** element.addEventListener() */
+	mdn_listen: {
+		title: t`MDN documentation page for elemetn.addEventListener`,
+		href: "https://developer.mozilla.org/en-US/docs/Web/API/EventTarget/addEventListener",
+	},
+	/** AbortSignal+element.addEventListener */
+	mdn_abortListener: {
+		title: t`MDN documentation page for using AbortSignal with element.addEventListener`,
+		href: "https://developer.mozilla.org/en-US/docs/Web/API/EventTarget/addEventListener#signal",
+	},
+	/** comparison listening options by WebReflection */
+	web_events: {
+		href: "https://gist.github.com/WebReflection/b404c36f46371e3b1173bf5492acc944",
+	},
+	/** Custom Element lifecycle callbacks */
+	mdn_customElement: {
+		href: "https://developer.mozilla.org/en-US/docs/Web/API/Web_components/Using_custom_elements#custom_element_lifecycle_callbacks" 
+	},
+	/** MutationObserver */
+	mdn_mutation: {
+		href: "https://developer.mozilla.org/en-US/docs/Web/API/MutationObserver",
+	},
+	/** Readding the element to the DOM fix by Vue */
+	vue_fix: {
+		title: t`Vue and Web Components, lifecycle implementation readding the element to the DOM`,
+		href: "https://vuejs.org/guide/extras/web-components.html#lifecycle",
+	}
+};
+/** @param {import("./types.d.ts").PageAttrs} attrs */
+export function page({ pkg, info }){
+	const page_id= info.id;
+	return el(simplePage, { info, pkg }).append(
+		el("h2", t`Listenning to the native DOM events and other Addons`),
+		el("p").append(...T`
+			We quickly introduce helper to listening to the native DOM events. And library syntax/pattern so-called
+			${el("em", t`Addon`)} to incorporate not only this in UI templates declaratively.
+		`),
+		
+		el(code, { src: fileURL("./components/examples/events/intro.js"), page_id }),
+		
+		el(h3, t`Events and listenners`),
+		el("p").append(...T`
+			In JavaScript you can listen to the native DOM events of the given element by using
+			${el("a", references.mdn_listen).append( el("code", "element.addEventListener(type, listener, options)") )}.
+			The library provides an alternative (${el("code", "on")}) accepting the differen order of the arguments:
+		`),
+		el(example, { src: fileURL("./components/examples/events/compare.js"), page_id }),
+		el("p").append(...T`
+			…this is actually one of the two differences. The another one is that ${el("code", "on")} accepts only
+			object as the ${el("code", "options")} (but it is still optional).
+		`),
+		el("p", { className: "notice" }).append(...T`
+			The other difference is that there is ${el("strong", "no")} ${el("code", "off")} function. You can remove
+			listener declaratively using ${el("a", { textContent: "AbortSignal", ...references.mdn_abortListener })}:
+		`),
+		el(example, { src: fileURL("./components/examples/events/abortSignal.js"), page_id }),
+		el("div", { className: "notice" }).append(
+			el("p", t`So, there are (typically) three ways to handle events. You can use:`),
+			el("ul").append(
+				el("li").append( el("code", `el("button", { textContent: "click me", "=onclick": "console.log(event)" })`)),
+				el("li").append( el("code", `el("button", { textContent: "click me", onclick: console.log })`)),
+				el("li").append( el("code", `el("button", { textContent: "click me" }, on("click", console.log))`))
+			),
+			el("p").append(...T`
+				In the first example we force to use HTML attribute (it corresponds to
+				${el("code", `<button onclick="console.log(event)">click me</button>`)}). ${el("em", t`Side note:
+				this can be useful in case of SSR.`)} To study difference, you can read a nice summary here:
+				${el("a", { textContent: "GIST @WebReflection/web_events.md", ...references.web_events })}.
+			`)
+		),
+
+		el(h3, t`Addons`),
+		el("p").append(...T`
+			From practical point of view, ${el("em", t`Addons`)} are just functions that accept any HTML element as
+			their first parameter. You can see that the ${el("code", "on(…)")} fullfills this requirement.
+		`),
+		el("p").append(...T`
+			You can use Addons as ≥3rd argument of ${el("code", "el")} function. This way is possible to extends your
+			templates by additional (3rd party) functionalities. But for now mainly, you can add events listeners:
+		`),
+		el(example, { src: fileURL("./components/examples/events/templateWithListeners.js"), page_id }),
+		el("p").append(...T`
+			As the example shows, you can also provide types in JSDoc+TypeScript by using global type
+			${el("code", "ddeElementAddon")}. Also notice, you can use Addons to get element reference.
+		`),
+		el(h3, t`Life-cycle events`),
+		el("p").append(...T`
+			Addons are called immediately when the element is created, even it is not connected to live DOM yet.
+			Therefore, you can understand the Addon to be “oncreate” event.
+		`),
+		el("p").append(...T`
+			The library provide three additional live-cycle events corresponding to how they are named in a case of
+			custom elements: ${el("code", "on.connected")}, ${el("code", "on.disconnected")} and ${el("code", "on.attributeChanged")}.
+		`),
+		el(example, { src: fileURL("./components/examples/events/live-cycle.js"), page_id }),
+		el("p").append(...T`
+			For Custom elements, we will later introduce a way to replace ${el("code", "*Callback")} syntax with
+			${el("code", "dde:*")} events. The ${el("code", "on.*")} functions then listen to the appropriate
+			Custom Elements events (see ${el("a", { textContent: t`Custom element lifecycle callbacks | MDN`, ...references.mdn_customElement })}).
+		`),
+		el("p").append(...T`
+			But, in case of regular elemnets the ${el("a", references.mdn_mutation).append(el("code", "MutationObserver"), " | MDN")}
+			is internaly used to track these events. Therefore, there are some drawbacks:
+		`),
+		el("ul").append(
+			el("li").append(...T`
+				To proper listener registration, you need to use ${el("code", "on.*")} not \`on("dde:*", …)\`!
+			`),
+			el("li").append(...T`
+				Use sparingly! Internally, library must loop of all registered events and fires event properly.
+				${el("strong", t`It is good practice to use the fact that if an element is removed, its children are
+				also removed!`)} In this spirit, we will introduce later the ${el("strong", t`host`)} syntax to
+				register, clean up procedures when the component is removed from the app.
+			`),
+		),
+		el("p").append(...T`
+			To provide intuitive behaviour, similar also to how the life-cycle events works in other
+			frameworks/libraries, deka-dom-el library ensures that ${el("code", "on.connected")} and
+			${el("code", "on.disconnected")} are called only once and only when the element, is (dis)connected to
+			live DOM. The solution is inspired by ${el("a", { textContent: "Vue", ...references.vue_fix })}. For using
+			native behaviour re-(dis)connecting element, use:
+		`),
+		el("ul").append(
+			el("li").append(...T`custom ${el("code", "MutationObserver")} or logic in (dis)${el("code", "connectedCallback")} or…`),
+			el("li").append(...T`re-add ${el("code", "on.connected")} or ${el("code", "on.disconnected")} listeners.`)
+		),
+
+		el(h3, t`Final notes`),
+		el("p", t`The library also provides a method to dispatch the events.`),
+		el(example, { src: fileURL("./components/examples/events/compareDispatch.js"), page_id }),
+		
+		el(mnemonic)
+	);
+}

docs/p04-signals.html.js

@@ -0,0 +1,128 @@
+import { T, t } from "./utils/index.js";
+export const info= {
+	title: t`Signals and reactivity`,
+	description: t`Handling reactivity in UI via signals.`,
+};
+
+import { el } from "deka-dom-el";
+import { simplePage } from "./layout/simplePage.html.js";
+import { example } from "./components/example.html.js";
+import { h3 } from "./components/pageUtils.html.js";
+import { mnemonic } from "./components/mnemonic/signals-init.js";
+import { code } from "./components/code.html.js";
+/** @param {string} url */
+const fileURL= url=> new URL(url, import.meta.url);
+const references= {
+	/** Event-driven programming */
+	wiki_event_driven: {
+		title: t`Wikipedia: Event-driven programming`,
+		href: "https://en.wikipedia.org/wiki/Event-driven_programming",
+	},
+	/** Publish–subscribe pattern */
+	wiki_pubsub: {
+		title: t`Wikipedia: Publish–subscribe pattern`,
+		href: "https://en.wikipedia.org/wiki/Publish%E2%80%93subscribe_pattern",
+	},
+	/** NPM package: fpubsub */
+	fpubsub: {
+		title: t`NPM package: fpubsub`,
+		href: "https://www.npmjs.com/package/fpubsub",
+	},
+	/** JS Primitives | MDN */
+	mdn_primitive: {
+		title: t`Primitive | MDN`,
+		href: "https://developer.mozilla.org/en-US/docs/Glossary/Primitive",
+	},
+	/** useReducer */
+	mdn_use_reducer: {
+		title: t`useReducer hook | React docs`,
+		href: "https://react.dev/reference/react/useReducer",
+	}
+};
+/** @param {import("./types.d.ts").PageAttrs} attrs */
+export function page({ pkg, info }){
+	const page_id= info.id;
+	return el(simplePage, { info, pkg }).append(
+		el("h2", t`Using signals to manage reactivity`),
+		el("p").append(...T`
+			How a program responds to variable data or user interactions is one of the fundamental problems of
+			programming. If we desire to solve the issue in a declarative manner, signals may be a viable approach.
+		`),
+		el(code, { src: fileURL("./components/examples/signals/intro.js"), page_id }),
+		
+		el(h3, t`Introducing signals`),
+		el("p").append(...T`
+			Let’s re-introduce
+			${el("a", { textContent: t`3PS principle`, href: "./#h-event-driven-programming--parts-separation--ps" })}.
+		`),
+		el("p").append(...T`
+			Using signals, we split program logic into the three parts. Firstly (α), we create a variable (constant)
+			representing reactive value. Somewhere later, we can register (β) a logic reacting to the signal value
+			changes. Similarly, in a remaining part (γ), we can update the signal value.
+		`),
+		el(example, { src: fileURL("./components/examples/signals/signals.js"), page_id }),
+		el("p").append(...T`
+			All this is just an example of 
+			${el("a", { textContent: t`Event-driven programming`, ...references.wiki_event_driven })} and
+			${el("a", { textContent: t`Publish–subscribe pattern`, ...references.wiki_pubsub })} (compare for example
+			with ${el("a", { textContent: t`fpubsub library`, ...references.fpubsub })}). All three parts can be in
+			some manner independent and still connected to the same reactive entity.
+		`),
+		el("p").append(...T`
+			Signals are implemented in the library as functions. To see current value of signal, just call it without
+			any arguments ${el("code", "console.log(signal())")}. To update the signal value, pass any argument
+			${el("code", `signal('${t`a new value`}')`)}. For listenning the signal value changes, use
+			${el("code", "S.on(signal, console.log)")}.
+		`),
+		el("p").append(...T`
+			Similarly to the ${el("code", "on")} function to register DOM events listener. You can use
+			${el("code", "AbortController")}/${el("code", "AbortSignal")} to ${el("em", "off")}/stop listenning. In
+			example, you also found the way for representing “live” piece of code computation pattern (derived signal):
+		`),
+		el(example, { src: fileURL("./components/examples/signals/computations-abort.js"), page_id }),
+
+		el(h3, t`Signals and actions`),
+		el("p").append(...T`
+			${el("code", `S(/* ${t`primitive`} */)`)} allows you to declare simple reactive variables, typically, around
+			${el("em", t`immutable`)} ${el("a", { textContent: t`primitive types`, ...references.mdn_primitive })}.
+			However, it may also be necessary to use reactive arrays, objects, or other complex reactive structures.
+		`),
+		el(example, { src: fileURL("./components/examples/signals/actions-demo.js"), page_id }),
+		el("p", t`…but typical user-case is object/array (maps, sets and other mutable objects):`),
+		el(example, { src: fileURL("./components/examples/signals/actions-todos.js"), page_id }),
+		el("p").append(...T`
+			In some way, you can compare it with ${el("a", { textContent: "useReducer", ...references.mdn_use_reducer })}
+			hook from React. So, the ${el("code", "S(<data>, <actions>)")} pattern creates a store “machine”. We can
+			then invoke (dispatch) registered action by calling ${el("code", "S.action(<signal>, <name>, ...<args>)")}
+			after the action call the signal calls all its listeners. This can be stopped by calling
+			${el("code", "this.stopPropagation()")} in the method representing the given action. As it can be seen in
+			examples, the “store” value is available also in the function for given action (${el("code", "this.value")}).
+		`),
+
+		el(h3, t`Reactive DOM attributes and elements`),
+		el("p", t`There are on basic level two distinc situation to mirror dynamic value into the DOM/UI`),
+		el("ol").append(
+			el("li", t`to change some attribute(s) of existing element(s)`),
+			el("li", t`to generate elements itself dynamically – this covers conditions and loops`)
+		),
+		el(example, { src: fileURL("./components/examples/signals/dom-attrs.js"), page_id }),
+		el("p").append(...T`
+			To derived attribute based on value of signal variable just use the signal as a value of the attribute
+			(${el("code", "assign(element, { attribute: S('value') })")}). ${el("code", "assign")}/${el("code", "el")}
+			 provides ways to glue reactive attributes/classes more granularly into the DOM. Just use dedicated build-in
+			 attributes ${el("code", "dataset")}, ${el("code", "ariaset")} and ${el("code", "classList")}.
+		`),
+		el("p").append(...T`
+			For computation, you can use the “derived signal” (see above) like
+			${el("code", "assign(element, { textContent: S(()=> 'Hello '+WorldSignal()) })")}. This is read-only signal
+			its value is computed based on given function and updated when any signal used in the function changes.
+		`),
+		el("p").append(...T`
+			To represent part of the template filled dynamically based on the signal value use
+			${el("code", "S.el(signal, DOMgenerator)")}. This was already used in the todo example above or see:
+		`),
+		el(example, { src: fileURL("./components/examples/signals/dom-el.js"), page_id }),
+
+		el(mnemonic)
+	);
+}

docs/p05-scopes.html.js

@@ -0,0 +1,87 @@
+import { T, t } from "./utils/index.js";
+export const info= {
+	title: t`Scopes and components`,
+	description: t`Organizing UI into components`,
+};
+
+import { el } from "deka-dom-el";
+import { simplePage } from "./layout/simplePage.html.js";
+import { example } from "./components/example.html.js";
+import { h3 } from "./components/pageUtils.html.js";
+import { mnemonic } from "./components/mnemonic/scopes-init.js";
+import { code } from "./components/code.html.js";
+/** @param {string} url */
+const fileURL= url=> new URL(url, import.meta.url);
+const references= {
+	/** Garbage collection on MDN */
+	garbage_collection: {
+		title: t`MDN documentation page for Garbage collection`,
+		href: "https://developer.mozilla.org/en-US/docs/Glossary/Garbage_collection",
+	},
+	/** Signals */
+	signals: {
+		title: t`Signals section on this library`,
+		href: "./p04-signals#h-introducing-signals",
+	}
+};
+/** @param {import("./types.d.ts").PageAttrs} attrs */
+export function page({ pkg, info }){
+	const page_id= info.id;
+	return el(simplePage, { info, pkg }).append(
+		el("h2", t`Using functions as UI components`),
+		el("p").append(...T`
+			For state-less components we can use functions as UI components (see “Elements” page). But in real life,
+			we may need to handle the component live-cycle and provide JavaScript the way to properly use
+			the ${el("a", { textContent: t`Garbage collection`, ...references.garbage_collection })}.
+		`),
+		el(code, { src: fileURL("./components/examples/scopes/intro.js"), page_id }),
+		el("p").append(...T`The library therefore use ${el("em", t`scopes`)} to provide these functionalities.`),
+		
+		el(h3, t`Scopes and hosts`),
+		el("p").append(...T`
+			The ${el("strong", "host")} is the name for the element representing the component. This is typically
+			element returned by function. To get reference, you can use ${el("code", "scope.host()")} to applly addons
+			just use ${el("code", "scope.host(...<addons>)")}.
+		`),
+		el(example, { src: fileURL("./components/examples/scopes/scopes-and-hosts.js"), page_id }),
+		el("p").append(...T`
+			To better understanding we implement function ${el("code", "elClass")} helping to create component as
+			class instances.
+		`),
+		el(example, { src: fileURL("./components/examples/scopes/class-component.js"), page_id }),
+		el("p").append(...T`
+			As you can see, the ${el("code", "scope.host()")} is stored temporarily and synchronously. Therefore, at
+			least in the beginning of using library, it is the good practise to store ${el("code", "host")} in the root
+			of your component. As it may be changed, typically when there is asynchronous code in the component.
+		`),
+		el(code, { src: fileURL("./components/examples/scopes/good-practise.js"), page_id }),
+
+		el(h3, t`Scopes, signals and cleaning magic`),
+		el("p").append(...T`
+			The ${el("code", "host")} is internally used to register the cleaning procedure, when the component
+			(${el("code", "host")} element) is removed from the DOM.
+		`),
+		el(example, { src: fileURL("./components/examples/scopes/cleaning.js"), page_id }),
+		el("p").append(...T`
+			The text content of the paragraph is changing when the value of the signal ${el("code", "textContent")}
+			is changed. Internally, there is association between ${el("code", "textContent")} and the paragraph,
+			similar to using ${el("code", `S.on(textContent, /* ${t`update the paragraph`} */)`)}.
+		`),
+		el("p").append(...T`
+			This listener must be removed when the component is removed from the DOM. To do it, the library assign
+			internally ${el("code", `on.disconnected(/* ${t`remove the listener`} */)(host())`)} to the host element.
+		`),
+		el("p", { className: "notice" }).append(...T`
+			The library DOM API and signals works ideally when used declaratively. It means, you split your app logic
+			into three parts as it was itroduced in ${el("a", { textContent: "Signals", ...references.signals })}.
+		`),
+		el(code, { src: fileURL("./components/examples/scopes/declarative.js"), page_id }),
+		el("p").append(...T`
+			Strictly speaking, the imperative way of using the library is not prohibited. Just be careful (rather avoid)
+			mixing declarative approach (using signals) and imperative manipulation of elements.
+		`),
+		el(code, { src: fileURL("./components/examples/scopes/imperative.js"), page_id }),
+
+		el(mnemonic)
+	);
+}

docs/p06-customElement.html

@@ -1,34 +0,0 @@
-<!DOCTYPE html><html><head><meta charset="utf-8"><meta name="viewport" content="width=device-width, initial-scale=1"><meta name="description" content="Using custom elements in combinantion with DDE"><title>`deka-dom-el` — Custom elements</title><!--<dde:mark type="component" name="metaAuthor" host="this" ssr/>--><meta name="author" content="Jan Andrle"><link type="text/plain" rel="author" href="https://jaandrle.github.io/humans.txt"><meta name="generator" content="deka-dom-el"><!--<dde:mark type="component" name="metaTwitter" host="this" ssr/>--><meta name="twitter:card" content="summary_large_image"><meta name="twitter:url" content="https://github.com/jaandrle/deka-dom-el"><meta name="twitter:title" content="deka-dom-el"><meta name="twitter:description" content="A low-code library that simplifies the creation of native DOM elements/components using small wrappers and tweaks."><meta name="twitter:creator" content="@jaandrle"><!--<dde:mark type="component" name="metaFacebook" host="this" ssr/>--><meta name="og:url" content="https://github.com/jaandrle/deka-dom-el"><meta name="og:title" content="deka-dom-el"><meta name="og:description" content="A low-code library that simplifies the creation of native DOM elements/components using small wrappers and tweaks."><meta name="og:creator" content="@jaandrle"><script src="https://cdn.jsdelivr.net/npm/shiki@0.9" defer=""></script><script type="module" src="code.js.js"></script><link rel="stylesheet" href="global.css"></head><body><!--<dde:mark type="component" name="page" host="this" ssr/>--><!--<dde:mark type="component" name="simplePage" host="this" ssr/>--><!--<dde:mark type="component" name="header" host="this" ssr/>--><header><h1>`deka-dom-el` — Custom elements</h1><p>Using custom elements in combinantion with DDE</p></header><nav><a href="https://github.com/jaandrle/deka-dom-el"><svg class="icon" viewBox="0 0 32 32"><!--<dde:mark type="component" name="iconGitHub" host="parentElement" ssr/>--><path d="M 16,0.395c -8.836,0 -16,7.163 -16,16c 0,7.069 4.585,13.067 10.942,15.182c 0.8,0.148 1.094,-0.347 1.094,-0.77c 0,-0.381 -0.015,-1.642 -0.022,-2.979c -4.452,0.968 -5.391,-1.888 -5.391,-1.888c -0.728,-1.849 -1.776,-2.341 -1.776,-2.341c -1.452,-0.993 0.11,-0.973 0.11,-0.973c 1.606,0.113 2.452,1.649 2.452,1.649c 1.427,2.446 3.743,1.739 4.656,1.33c 0.143,-1.034 0.558,-1.74 1.016,-2.14c -3.554,-0.404 -7.29,-1.777 -7.29,-7.907c 0,-1.747 0.625,-3.174 1.649,-4.295c -0.166,-0.403 -0.714,-2.03 0.155,-4.234c 0,0 1.344,-0.43 4.401,1.64c 1.276,-0.355 2.645,-0.532 4.005,-0.539c 1.359,0.006 2.729,0.184 4.008,0.539c 3.054,-2.07 4.395,-1.64 4.395,-1.64c 0.871,2.204 0.323,3.831 0.157,4.234c 1.026,1.12 1.647,2.548 1.647,4.295c 0,6.145 -3.743,7.498 -7.306,7.895c 0.574,0.497 1.085,1.47 1.085,2.963c 0,2.141 -0.019,3.864 -0.019,4.391c 0,0.426 0.288,0.925 1.099,0.768c 6.354,-2.118 10.933,-8.113 10.933,-15.18c 0,-8.837 -7.164,-16 -16,-16Z"></path></svg>GitHub</a><a href="./" title="Introducing a&nbsp;library.">1. Introduction</a><a href="p02-elements" title="Basic concepts of elements modifications and creations.">2. Elements</a><a href="p03-events" title="Using not only events in UI declaratively.">3. Events and Addons</a><a href="p04-signals" title="Handling reactivity in UI via signals.">4. Signals and reactivity</a><a href="p05-scopes" title="Organizing UI into components">5. Scopes and components</a><a href="p06-customElement" title="Using custom elements in combinantion with DDE" class="current">6. Custom elements</a></nav><main><h2>Using custom elements in combinantion with DDE</h2><p></p><div class="code" data-js="todo"><!--<dde:mark type="component" name="code" host="parentElement" ssr/>--><code class="language-js">// use NPM or for example https://cdn.jsdelivr.net/gh/jaandrle/deka-dom-el/dist/esm-with-signals.js
-import {
-	customElementRender,
-	customElementWithDDE,
-	observedAttributes,
-} from "deka-dom-el";
-/** @type {ddePublicElementTagNameMap} */
-import { S } from "deka-dom-el/signals";
-S.observedAttributes;
-
-// “internal” utils
-import { lifecyclesToEvents } from "deka-dom-el";
-</code></div><h3 id="h-custom-elements-introduction"><!--<dde:mark type="component" name="h3" host="parentElement" ssr/>--><a href="#h-custom-elements-introduction" tabindex="-1">#</a> Custom Elements Introduction</h3><p><a href="https://developer.mozilla.org/en-US/docs/Web/API/Web_components/Using_custom_elements" title="Article about custom elements on MDN">Using custom elements</a></p><div class="code" data-js="todo"><!--<dde:mark type="component" name="code" host="parentElement" ssr/>--><code class="language-js">class CustomHTMLElement extends HTMLElement{
-	static tagName = "custom-element"; // just suggestion, we can use `el(CustomHTMLElement.tagName)`
-	static observedAttributes= [ "custom-attribute" ];
-	constructor(){
-		super();
-		// nice place to prepare custom element
-	}
-	connectedCallback(){
-		// nice place to render custom element
-	}
-	attributeChangedCallback(name, oldValue, newValue){
-		// listen to attribute changes (see `observedAttributes`)
-	}
-	disconnectedCallback(){
-		// nice place to clean up
-	}
-	// for example, we can mirror get/set prop to attribute
-	get customAttribute(){ return this.getAttribute("custom-attribute"); }
-	set customAttribute(value){ this.setAttribute("custom-attribute", value); }
-}
-customElements.define(CustomHTMLElement.tagName, CustomHTMLElement);
-</code></div><p><a href="https://gist.github.com/WebReflection/ec9f6687842aa385477c4afca625bbf4" title="Ideas and tips from WebReflection">Handy Custom Elements' Patterns</a></p><div class="notice"><!--<dde:mark type="component" name="mnemonic" host="parentElement" ssr/>--><h3 id="h-mnemonic"><!--<dde:mark type="component" name="h3" host="parentElement" ssr/>--><a href="#h-mnemonic" tabindex="-1">#</a> Mnemonic</h3><ul><li><code>customElementRender(&lt;custom-element&gt;, &lt;render-function&gt;[, &lt;properties&gt;])</code> — use function to render DOM structure for given &lt;custom-element&gt;</li><li><code>customElementWithDDE(&lt;custom-element&gt;)</code> — register &lt;custom-element&gt; to DDE library, see also `lifecyclesToEvents`, can be also used as decorator</li><li><code>observedAttributes(&lt;custom-element&gt;)</code> — returns record of observed attributes (keys uses camelCase)</li><li><code>S.observedAttributes(&lt;custom-element&gt;)</code> — returns record of observed attributes (keys uses camelCase and values are signals)</li><li><code>lifecyclesToEvents(&lt;class-declaration&gt;)</code> — convert lifecycle methods to events, can be also used as decorator</li></ul></div><div class="prevNext"><!--<dde:mark type="component" name="prevNext" host="parentElement" ssr/>--><a rel="prev" href="p05-scopes" title="Organizing UI into components"><!--<dde:mark type="component" name="pageLink" host="parentElement" ssr/>-->Scopes and components (previous)</a><!--<dde:mark type="component" name="pageLink" host="this" ssr/>--></div></main></body></html>

docs/p06-customElement.html.js

@@ -0,0 +1,144 @@
+import { T, t } from "./utils/index.js";
+export const info= {
+	title: t`Web Components`,
+	description: t`Using custom elements in combinantion with DDE`,
+};
+
+import { el } from "deka-dom-el";
+import { simplePage } from "./layout/simplePage.html.js";
+import { example } from "./components/example.html.js";
+import { h3 } from "./components/pageUtils.html.js";
+import { mnemonic } from "./components/mnemonic/customElement-init.js";
+import { code } from "./components/code.html.js";
+/** @param {string} url */
+const fileURL= url=> new URL(url, import.meta.url);
+const references= {
+	/** Web Components on MDN */
+	mdn_web_components: {
+		title: t`MDN documentation page for Web Components`,
+		href: "https://developer.mozilla.org/en-US/docs/Web/API/Web_components",
+	},
+	/** observedAttributes on MDN */
+	mdn_observedAttributes: {
+		title: t`MDN documentation page for observedAttributes`,
+		href: "https://developer.mozilla.org/en-US/docs/Web/API/Web_components/Using_custom_elements#responding_to_attribute_changes",
+	},
+	/** Custom Elements on MDN */
+	mdn_custom_elements: {
+		title: t`MDN documentation page for Custom Elements`,
+		href: "https://developer.mozilla.org/en-US/docs/Web/API/Web_components/Using_custom_elements",
+	},
+	/** Custom Elements tips from WebReflection */
+	custom_elements_tips: {
+		title: t`Ideas and tips from WebReflection`,
+		href: "https://gist.github.com/WebReflection/ec9f6687842aa385477c4afca625bbf4",
+	},
+	/** Shallow DOM on mdn */
+	mdn_shadow_dom_depth: {
+		title: t`MDN documentation page for Shadow DOM`,
+		href: "https://developer.mozilla.org/en-US/docs/Web/Web_Components/Using_shadow_DOM",
+	},
+	/** Shallow DOM on mdn */
+	mdn_shadow_dom_slot: {
+		title: t`MDN documentation page for <slot>`,
+		href: "https://developer.mozilla.org/en-US/docs/Web/HTML/Element/slot",
+	},
+	/** Shallow DOM */
+	shadow_dom_depth: {
+		title: t`Everything you need to know about Shadow DOM (github repo praveenpuglia/shadow-dom-in-depth)`,
+		href: "https://github.com/praveenpuglia/shadow-dom-in-depth",
+	},
+};
+/** @param {import("./types.d.ts").PageAttrs} attrs */
+export function page({ pkg, info }){
+	const page_id= info.id;
+	return el(simplePage, { info, pkg }).append(
+		el("h2", t`Using web components in combinantion with DDE`),
+		el("p").append(...T`
+			The DDE library allows for use within ${el("a", references.mdn_web_components).append( el("strong", t`Web Components`) )}
+			for dom-tree generation. However, in order to be able to use signals (possibly mapping to registered
+			${el("a", references.mdn_observedAttributes).append( el("code", "observedAttributes") )}) and additional
+			functionality is (unfortunately) required to use helpers provided by the library.
+		`),
+		el(code, { src: fileURL("./components/examples/customElement/intro.js"), page_id }),
+
+		el(h3, t`Custom Elements Introduction`),
+		el("p").append(...T`
+			Web Components, specifically Custom Elements, are a set of web platform APIs that allow you to create
+			new HTML tags with custom functionality encapsulated within them. This allows for the creation of reusable
+			components that can be used across web applications.
+		`),
+		el("p").append(...T`
+			To start with, let’s see how to use native Custom Elements. As starting point please read
+			${el("a", references.mdn_custom_elements).append( el("strong", t`Using Custom Elements`), t` on MDN` )}.
+			To sum up and for mnemonic see following code overview:
+		`),
+		el(code, { src: fileURL("./components/examples/customElement/native-basic.js"), page_id }),
+		el("p").append(...T`
+			For more advanced use of Custom Elements, the summary ${el("a", references.custom_elements_tips)
+			.append( el("strong", t`Handy Custom Elements Patterns`) )} may be useful. Especially pay attention to
+			linking HTML attributes and defining setters/getters, this is very helpful to use in combination with
+			the library (${el("code", `el(HTMLCustomElement.tagName, { customAttribute: "${t`new-value`}" });`)}).
+		`),
+		el("p").append(...T`
+			Also see the Life Cycle Events sections, very similarly we would like to use
+			${el("a", { textContent: t`DDE events`, href: "./p03-events.html", title: t`See events part of the library documentation` })}.
+			To do it, the library provides function ${el("code", "customElementWithDDE")}…
+		`),
+		el(example, { src: fileURL("./components/examples/customElement/customElementWithDDE.js"), page_id }),
+
+		el("h3", t`Custom Elements with DDE`),
+		el("p").append(...T`
+			The ${el("code", "customElementWithDDE")} function is only (small) part of the inregration of the library.
+			More important for coexistence is render component function as a body of the Custom Element. For that, you
+			can use ${el("code", "customElementRender")} with arguments instance reference, target for connection,
+			render function and optional properties (will be passed to the render function) see later…
+		`),
+		el(example, { src: fileURL("./components/examples/customElement/dde.js"), page_id }),
+		el("p").append(...T`
+			…as you can see, you can use components created based on the documentation previously introduced. To unlock
+			full potential, use with combination ${el("code", "customElementWithDDE")} (allows to use livecycle events)
+			and ${el("code", "observedAttributes")} (converts attributes to render function arguments —
+			${el("em", "default")}) or ${el("code", "S.observedAttributes")} (converts attributes to signals).
+		`),
+		el(example, { src: fileURL("./components/examples/customElement/observedAttributes.js"), page_id }),
+
+
+		el(h3, t`Shadow DOM`),
+		el("p").append(...T`
+			Shadow DOM is a web platform feature that allows for the encapsulation of a component’s internal DOM tree
+			from the rest of the document. This means that styles and scripts applied to the document will not affect
+			the component’s internal DOM, and vice versa.
+		`),
+		el(example, { src: fileURL("./components/examples/customElement/shadowRoot.js"), page_id }),
+		el("p").append(...T`
+			Regarding to ${el("code", "this.attachShadow({ mode: 'open' })")} see quick overview
+			${el("a", { textContent: t`Using Shadow DOM`, ...references.mdn_shadow_dom_depth })}. An another source of
+			information can be ${el("a", { textContent: t`Shadow DOM in Depth`, ...references.shadow_dom_depth })}.
+		`),
+		el("p").append(...T`
+			Besides the encapsulation, the Shadow DOM allows for using the ${el("a", references.mdn_shadow_dom_slot).append(
+			el("strong", t`<slot>`), t` element(s)`)}. You can simulate this feature using ${el("code", "simulateSlots")}:
+		`),
+		el(example, { src: fileURL("./components/examples/customElement/simulateSlots.js"), page_id }),
+		el("p").append(...T`
+			To sum up:
+		`),
+		el("ul").append(
+			el("li").append(...T`
+				The use of shadow DOM to encapsulate the internal structure of the custom element, which affects how
+				the custom element can be styled and modified using JavaScript and CSS.
+			`),
+			el("li").append(...T`
+				The ability to access and modify the internal structure of the custom element using JavaScript, which
+				is affected by the use of shadow DOM and the mode of the shadow DOM.
+			`),
+			el("li").append(...T`
+				The use of slots to allow for the insertion of content from the parent document into the custom
+				element, which is affected by the use of shadow DOM and the mode of the shadow DOM.
+			`),
+		),
+
+		el(mnemonic)
+	);
+}

docs/ssr.js

@@ -1,6 +1,7 @@
+export { t } from "./utils/index.js";
 export const path_target= {
-	root: "docs/",
-	css: "docs/"
+	root: "dist/docs/",
+	css: "dist/docs/"
 };
 /**
  * This variable will be filled with the list of pages during the build process (see `bs/docs.js`).

docs/utils/index.js

@@ -0,0 +1,52 @@
+/**
+ * This is helper to write texts in code more readable
+ * and doesn’t inpact the finally generated text in HTML.
+ *
+ * ```js
+ * t`
+ *		Hello ${el("b", "world")}!
+ *		How are you?
+ * ` === "Hello <b>world</b>! How are you?"
+ * ```
+ *
+ * In future, this can be expanded to allow translations.
+ *
+ * ```js
+ * t(key)`text`; // for example
+ * ```
+ *
+ * @param {TemplateStringsArray} strings
+ * @param {...(string|Node)} values
+ * @returns {(string|Node)[]}
+ * */
+export function T(strings, ...values){
+	const out= [];
+	tT(s=> out.push(s), strings, ...values);
+	return out;
+}
+/**
+ * Similarly to {@link T}, but for only strings.
+ * @param {TemplateStringsArray} strings
+ * @param {...string} values
+ * @returns {string}
+ * */
+export function t(strings, ...values){
+	let out= "";
+	tT(s=> out+= s, strings, ...values);
+	return out;
+}
+
+/**
+ * @param {(input: string|Node)=> void} callback
+ * @param {TemplateStringsArray} strings
+ * @param {...(string|Node)} values
+ * */
+function tT(callback, strings, ...values){
+	const { length }= strings;
+	const last= length-1;
+	for(let i= 0; i<length; i++){
+		const out= strings[i].replace(/\n\s+/g, " ");
+		callback(!i ? out.trimStart() : i===last ? out.trimEnd() : out);
+		if(i<values.length) callback(values[i]);
+	}
+}

docs_src/components/code.js.js

@@ -1,12 +0,0 @@
-const highlighter= await globalThis.shiki.getHighlighter({
-	theme: "css-variables",
-	langs: ["js", "ts", "css", "html", "shell"],
-});
-const codeBlocks= document.querySelectorAll('code[class*="language-"]');
-
-codeBlocks.forEach((block)=> {
-	const lang= block.className.replace("language-", "");
-	block.parentElement.dataset.js= "done";
-	const html= highlighter.codeToHtml(block.textContent, { lang });
-	block.innerHTML= html;
-});

docs_src/index.html.js

@@ -1,41 +0,0 @@
-export const info= {
-	href: "./",
-	title: "Introduction",
-	description: "Introducing a library.",
-};
-
-import { el } from "deka-dom-el";
-import { simplePage } from "./layout/simplePage.html.js";
-import { example } from "./components/example.html.js";
-/** @param {import("./types.d.ts").PageAttrs} attrs */
-export function page({ pkg, info }){
-	const page_id= info.id;
-	return el(simplePage, { info, pkg }).append(
-		el("p", "The library tries to provide pure JavaScript tool(s) to create reactive interfaces."),
-		el("p").append(
-			"We start with creating and modifying a static elements and end up with UI templates.",
-			" ",
-			el("i").append(
-				"From ", el("code", "document.createElement"), " to ", el("code", "el"), "."
-			),
-			" ",
-			"Then we go through the native events system and the way to include it declaratively in UI templates.",
-			" ",
-			el("i").append(
-				"From ", el("code", "element.addEventListener"), " to ", el("code", "on"), "."
-			),
-		),
-		el("p").append(
-			"Next step is providing interactivity not only for our UI templates.",
-			" ",
-			"We introduce signals (", el("code", "S"), ") and how them incorporate to UI templates.",
-		),
-		el("p").append(
-			"Now we will clarify how the signals are incorporated into our templates with regard ",
-			"to application performance. This is not the only reason the library uses ",
-			el("code", "scope"), "s. We will look at how they work in components represented ",
-			"in JavaScript by functions."
-		),
-		el(example, { src: new URL("./components/examples/helloWorld.js", import.meta.url), page_id }),
-	);
-}

docs_src/p02-elements.html.js

@@ -1,125 +0,0 @@
-export const info= {
-	title: "Elements",
-	description: "Basic concepts of elements modifications and creations.",
-};
-
-import { el } from "deka-dom-el";
-import { simplePage } from "./layout/simplePage.html.js";
-import { example } from "./components/example.html.js";
-import { h3 } from "./components/pageUtils.html.js";
-import { mnemonic } from "./components/mnemonic/elements-init.js";
-import { code } from "./components/code.html.js";
-/** @param {string} url */
-const fileURL= url=> new URL(url, import.meta.url);
-/** @param {import("./types.d.ts").PageAttrs} attrs */
-export function page({ pkg, info }){
-	const page_id= info.id;
-	return el(simplePage, { info, pkg }).append(
-		el("h2", "Native JavaScript DOM elements creations"),
-		el("p", "Let’s go through all patterns we would like to use and what needs to be improved for better experience."),
-
-		el(code, { src: fileURL("./components/examples/elements/intro.js"), page_id }),
-		
-		el(h3, "Creating element(s) (with custom attributes)"),
-		el("p").append(
-			"You can create a native DOM element by using the ",
-			el("a", { href: "https://developer.mozilla.org/en-US/docs/Web/API/Document/createElement", title: "MDN documentation for document.createElement()" }).append(
-				el("code", "document.createElement()")
-			), ". ",
-			"It is also possible to provide a some attribute(s) declaratively using ", el("code", "Object.assign()"), ". ",
-			"More precisely, this way you can sets some ",
-			el("a", {
-				href: "https://developer.mozilla.org/en-US/docs/Glossary/IDL",
-				title: "MDN page about Interface Description Language"
-			}).append(
-				el("abbr", { textContent: "IDL", title: "Interface Description Language" })
-			), " also known as a JavaScript property."
-		),
-		el(example, { src: fileURL("./components/examples/elements/nativeCreateElement.js"), page_id }),
-		el("p").append(
-			"To make this easier, you can use the ", el("code", "el"), " function. ",
-			"Internally in basic examples, it is wrapper around ", el("code", "assign(document.createElement(…), { … })"), "."
-		),
-		el(example, { src: fileURL("./components/examples/elements/dekaCreateElement.js"), page_id }),
-		el("p").append(
-			"The ", el("code", "assign"), " function provides improved behaviour of ", el("code", "Object.assign()"), ". ",
-			"You can declaratively sets any IDL and attribute of the given element. ",
-			"Function prefers IDL and fallback to the ", el("code", "element.setAttribute"), " if there is no writable property in the element prototype."
-		),
-		el("p").append(
-			"You can study all JavaScript elements interfaces to the corresponding HTML elements. ",
-			"All HTML elements inherits from ", el("a", { textContent: "HTMLElement", href: "https://developer.mozilla.org/en-US/docs/Web/API/HTMLElement" }), ". ",
-			"To see all available IDLs for example for paragraphs, see ", el("a", { textContent: "HTMLParagraphElement", href: "https://developer.mozilla.org/en-US/docs/Web/API/HTMLParagraphElement" }), ". ",
-			"Moreover, the ", el("code", "assign"), " provides a way to sets declaratively some convenient properties:"
-		),
-		el("ul").append(
-			el("li").append(
-				"It is possible to sets ", el("code", "data-*"), "/", el("code", "aria-*"), " attributes using object notation."
-			),
-			el("li").append(
-				"In opposite, it is also possible to sets ", el("code", "data-*"), "/", el("code", "aria-*"), " attribute using camelCase notation."
-			),
-			el("li").append(
-				"You can use string or object as a value for ", el("code", "style"), " property."
-			),
-			el("li").append(
-				el("code", "className"), " (IDL – preffered)/", el("code", "class"), " are ways to add CSS class to the element. ",
-				"You can use string (similarly to ", el("code", "class=\"…\"") ," syntax in  HTML) or array of strings. ",
-				"This is handy to concat conditional classes."
-			),
-			el("li").append(
-				"Use ", el("code", "classList"), " to toggle specific classes. This will be handy later when the reactivity via signals is beeing introduced.",
-			),
-			el("li").append(
-				"The ", el("code", "assign"), " also accepts the ", el("code", "undefined"), " as a value for any property to remove it from the element declaratively. ",
-				"Also for some IDL the corresponding attribute is removed as it can be confusing. ",
-				el("em").append(
-					"For example, natievly the element’s ", el("code", "id"), " is removed by setting the IDL to an empty string."
-				)
-			),
-			el("li").append(
-				"You can use ", el("code", "="), " or ", el("code", "."), " to force processing given key as attribute/property of the element."
-			)
-		),
-		el("p").append(
-			"For processing, the ", el("code", "assign"), " internally uses ", el("code", "assignAttribute"), " and ", el("code", "classListDeclarative"), "."
-		),
-		el(example, { src: fileURL("./components/examples/elements/dekaAssign.js"), page_id }),
-		
-		el(h3, "Native JavaScript templating"),
-		el("p", "By default, the native JS has no good way to define HTML template using DOM API:"),
-		el(example, { src: fileURL("./components/examples/elements/nativeAppend.js"), page_id }),
-		el("p").append(
-			"This library therefore overwrites the ", el("code", "append"), " method of created elements to always return parent element."
-		),
-		el(example, { src: fileURL("./components/examples/elements/dekaAppend.js"), page_id }),
-		
-		
-		el(h3, "Basic (state-less) components"),
-		el("p").append(
-			"You can use functions for encapsulation (repeating) logic. ",
-			"The ", el("code", "el"), " accepts function as first argument. ",
-			"In that case, the function should return dom elements and the second argument for ", el("code", "el"), " is argument for given element."
-		),
-		el(example, { src: fileURL("./components/examples/elements/dekaBasicComponent.js"), page_id }),
-		el("p").append(
-			"As you can see, in case of state-less/basic components there is no difference",
-			" between calling component function directly or using ", el("code", "el"), " function.",
-		),
-		el("p", { className: "notice" }).append(
-			"It is nice to use similar naming convention as native DOM API. ",
-			"This allows us to use ", el("a", { textContent: "the destructuring assignment syntax", href: "https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Operators/Destructuring_assignment", title: "Destructuring assignment | MDN" }),
-			" and keep track of the native API (things are best remembered through regular use).",
-		),
-
-		el(h3, "Creating non-HTML elements"),
-		el("p").append(
-			"Similarly to the native DOM API (", el("a", { href: "https://developer.mozilla.org/en-US/docs/Web/API/Document/createElementNS", title: "MDN" }).append(el("code", "document.createElementNS")), ") for non-HTML elements",
-			" we need to tell JavaScript which kind of the element to create.",
-			" We can use the ", el("code", "elNS"), " function:"
-		),
-		el(example, { src: fileURL("./components/examples/elements/dekaElNS.js"), page_id }),
-		
-		el(mnemonic)
-	);
-}

docs_src/p03-events.html.js

@@ -1,133 +0,0 @@
-export const info= {
-	title: "Events and Addons",
-	description: "Using not only events in UI declaratively.",
-};
-
-import { el } from "deka-dom-el";
-import { simplePage } from "./layout/simplePage.html.js";
-import { example } from "./components/example.html.js";
-import { h3 } from "./components/pageUtils.html.js";
-import { mnemonic } from "./components/mnemonic/events-init.js";
-import { code } from "./components/code.html.js";
-/** @param {string} url */
-const fileURL= url=> new URL(url, import.meta.url);
-/** @param {import("./types.d.ts").PageAttrs} attrs */
-export function page({ pkg, info }){
-	const page_id= info.id;
-	return el(simplePage, { info, pkg }).append(
-		el("h2", "Listenning to the native DOM events and other Addons"),
-		el("p").append(
-			"We quickly introduce helper to listening to the native DOM events.",
-			" ",
-			"And library syntax/pattern so-called ", el("em", "Addon"), " to",
-			" incorporate not only this in UI templates declaratively."
-		),
-		
-		el(code, { src: fileURL("./components/examples/events/intro.js"), page_id }),
-		
-		el(h3, "Events and listenners"),
-		el("p").append(
-			"In JavaScript you can listen to the native DOM events of the given element by using ",
-			el("a", { href: "https://developer.mozilla.org/en-US/docs/Web/API/EventTarget/addEventListener", title: "addEventListener on MDN" }).append(
-				el("code", "element.addEventListener(type, listener, options)")
-			), ".",
-			" ",
-			"The library provides an alternative (", el("code", "on"), ") accepting the differen order",
-			" of the arguments:"
-		),
-		el(example, { src: fileURL("./components/examples/events/compare.js"), page_id }),
-		el("p").append(
-			"…this is actually one of the two differences. The another one is that ", el("code", "on"),
-			" accepts only object as the ", el("code", "options"), " (but it is still optional)."
-		),
-		el("p", { className: "notice" }).append(
-			"The other difference is that there is ", el("strong", "no"), " ", el("code", "off"), " function.",
-			" ",
-			"You can remove listener declaratively using ", el("a", { textContent: "AbortSignal", href: "https://developer.mozilla.org/en-US/docs/Web/API/EventTarget/addEventListener#signal", title: "part of addEventListener on MDN" }),
-			":"
-		),
-		el(example, { src: fileURL("./components/examples/events/abortSignal.js"), page_id }),
-		el("div", { className: "notice" }).append(
-			el("p", "So, there are (typically) three ways to handle events. You can use:"),
-			el("ul").append(
-				el("li").append( el("code", `el("button", { textContent: "click me", "=onclick": "console.log(event)" })`)),
-				el("li").append( el("code", `el("button", { textContent: "click me", onclick: console.log })`)),
-				el("li").append( el("code", `el("button", { textContent: "click me" }, on("click", console.log))`))
-			),
-			el("p").append(
-				"In the first example we force to use HTML attribute (it corresponds to ", el("code", `<button onclick="console.log(event)">click me</button>`), ").",
-				" ",
-				el("em", "Side note: this can be useful in case of SSR."),
-				" ",
-				"To study difference, you can read a nice summary here: ", el("a", { href: "https://gist.github.com/WebReflection/b404c36f46371e3b1173bf5492acc944", textContent: "GIST @WebReflection/web_events.md" }), "."
-			)
-		),
-
-		el(h3, "Addons"),
-		el("p").append(
-			"From practical point of view, ", el("em", "Addons"), " are just functions that accept any html element",
-			" as their first parameter. You can see that the ", el("code", "on(…)"), " fullfills this requirement."
-		),
-		el("p").append(
-			"You can use Addons as ≥3rd argument of ", el("code", "el"), " function. This way is possible to extends",
-			" you templates by additional (3rd party) functionalities. But for now mainly, you can add events listeners:"
-		),
-		el(example, { src: fileURL("./components/examples/events/templateWithListeners.js"), page_id }),
-		el("p").append(
-			"As the example shows, you can also provide types in JSDoc+TypeScript by using global type ", el("code", "ddeElementAddon"), ".",
-			" ",
-			"Also notice, you can use Addons to get element reference.",
-		),
-		el(h3, "Life-cycle events"),
-		el("p").append(
-			"Addons are called immediately when the element is created, even it is not connected to live DOM yet.",
-			" ",
-			"Therefore, you can understand the Addon to be “oncreate” event."
-		),
-		el("p").append(
-			"The library provide three additional live-cycle events corresponding to how they are named in",
-			" a case of custom elements: ", el("code", "on.connected"), ", ", el("code", "on.disconnected"),
-			" and ", el("code", "on.attributeChanged"), "."
-		),
-		el(example, { src: fileURL("./components/examples/events/live-cycle.js"), page_id }),
-		el("p").append(
-			"For Custom elements, we will later introduce a way to replace ", el("code", "*Callback"),
-			" syntax with ", el("code", "dde:*"), " events. The ", el("code", "on.*"), " functions then",
-			" listen to the appropriate Custom Elements events (see ", el("a", { textContent: "Custom element lifecycle callbacks | MDN", href: "https://developer.mozilla.org/en-US/docs/Web/API/Web_components/Using_custom_elements#custom_element_lifecycle_callbacks" }), ")."
-		),
-		el("p").append(
-			"But, in case of regular elemnets the ", el("a", { href: "https://developer.mozilla.org/en-US/docs/Web/API/MutationObserver" }).append(el("code", "MutationObserver"), " | MDN"),
-			" is internaly used to track these events. Therefore, there are some drawbacks:",
-		),
-		el("ul").append(
-			el("li").append(
-				"To proper listener registration, you need to use ", el("code", "on.*"), " not `on(\"dde:*\", …)`!"
-			),
-			el("li").append(
-				"Use sparingly! Internally, library must loop of all registered events and fires event properly.",
-				" ",
-				el("strong", "It is good practice to use the fact that if an element is removed, its children are also removed!"),
-				" ",
-				"In this spirit, we will introduce later the ", el("strong", "host"), " syntax to register",
-				" clean up procedures when the component is removed from the app."
-			),
-		),
-		el("p").append(
-			"To provide intuitive behaviour, similar also to how the life-cycle events works in other",
-			" frameworks/libraries, deka-dom-el library ensures that ", el("code", "on.connected"),
-			" and ", el("code", "on.disconnected"), " are called only once and only when the element",
-			" is (dis)connected to live DOM. The solution is inspired by ", el("a", { textContent: "Vue", href: "https://vuejs.org/guide/extras/web-components.html#lifecycle", title: "Vue and Web Components | Lifecycle" }), ".",
-			" For using native behaviour re-(dis)connecting element, use:"
-		),
-		el("ul").append(
-			el("li").append("custom ", el("code", "MutationObserver"), " or logic in (dis)", el("code", "connectedCallback"), " or…"),
-			el("li").append("re-add ", el("code", "on.connected"), " or ", el("code", "on.disconnected"), " listeners.")
-		),
-
-		el(h3, "Final notes"),
-		el("p", "The library also provides a method to dispatch the events."),
-		el(example, { src: fileURL("./components/examples/events/compareDispatch.js"), page_id }),
-		
-		el(mnemonic)
-	);
-}

docs_src/p04-signals.html.js

@@ -1,107 +0,0 @@
-export const info= {
-	title: "Signals and reactivity",
-	description: "Handling reactivity in UI via signals.",
-};
-
-import { el } from "deka-dom-el";
-import { simplePage } from "./layout/simplePage.html.js";
-import { example } from "./components/example.html.js";
-import { h3 } from "./components/pageUtils.html.js";
-import { mnemonic } from "./components/mnemonic/signals-init.js";
-import { code } from "./components/code.html.js";
-/** @param {string} url */
-const fileURL= url=> new URL(url, import.meta.url);
-
-/** @param {import("./types.d.ts").PageAttrs} attrs */
-export function page({ pkg, info }){
-	const page_id= info.id;
-	return el(simplePage, { info, pkg }).append(
-		el("h2", "Using signals to manage reactivity"),
-		el("p").append(
-			"How a program responds to variable data or user",
-			" interactions is one of the fundamental problems of programming.",
-			" If we desire to solve the issue in a declarative manner,",
-			" signals may be a viable approach.",
-		),
-		el(code, { src: fileURL("./components/examples/signals/intro.js"), page_id }),
-		
-		el(h3, "Introducing signals"),
-		el("p").append(
-			"Using signals, we split program logic into the three parts.",
-			" Firstly (α), we create a variable (constant) representing reactive",
-			" value. Somewhere later, we can register (β) a logic reacting",
-			" to the signal value changes. Similarly, in a remaining part (γ), we",
-			" can update the signal value."
-		),
-		el(example, { src: fileURL("./components/examples/signals/signals.js"), page_id }),
-		el("p").append(
-			"All this is just an example of ",
-			el("a", { textContent: "Event-driven programming", href: "https://en.wikipedia.org/wiki/Event-driven_programming", title: "Wikipedia: Event-driven programming" }),
-			" and ",
-			el("a", { textContent: "Publish–subscribe pattern", href: "https://en.wikipedia.org/wiki/Publish%E2%80%93subscribe_pattern", title: "Wikipedia: Publish–subscribe pattern" }),
-			" (compare for example with ", el("a", { textContent: "fpubsub library", href: "https://www.npmjs.com/package/fpubsub", title: "NPM package: fpubsub" }), ").",
-			" All three parts can be in some manner independent and still connected",
-			" to the same reactive entity."
-		),
-		el("p").append(
-			"Signals are implemented in the library as functions. To see current value",
-			" of signal, just call it without any arguments ", el("code", "console.log(signal())"), ".",
-			" To update the signal value, pass any argument ", el("code", "signal('a new value')"), ".",
-			" For listenning the signal value changes, use ", el("code", "S.on(signal, console.log)"), "."
-		),
-		el("p").append(
-			"Similarly to the ", el("code", "on"), " function to register DOM events listener.",
-			" You can use ", el("code", "AbortController"), "/", el("code", "AbortSignal"), " to",
-			" ", el("em", "off"), "/stop listenning. In example, you also found the way for representing",
-			" “live” piece of code computation pattern (derived signal):"
-		),
-		el(example, { src: fileURL("./components/examples/signals/computations-abort.js"), page_id }),
-
-		el(h3, "Signals and actions"),
-		el("p").append(
-			el("code", "S(/* primitive */)"), " allows you to declare simple reactive variables, typically",
-			" around ", el("em", "immutable"), " ", el("a", { textContent: "primitive types", title: "Primitive | MDN", href: "https://developer.mozilla.org/en-US/docs/Glossary/Primitive" }), ".",
-			" ",
-			"However, it may also be necessary to use reactive arrays, objects, or other complex reactive structures."
-		),
-		el(example, { src: fileURL("./components/examples/signals/actions-demo.js"), page_id }),
-		el("p", "…but typical user-case is object/array (maps, sets and other mutable objects):"),
-		el(example, { src: fileURL("./components/examples/signals/actions-todos.js"), page_id }),
-		el("p").append(
-			"In some way, you can compare it with ", el("a", { textContent: "useReducer", href: "https://react.dev/reference/react/useReducer", title: "useReducer hook | React docs" }),
-			" hook from React. So, the ", el("code", "S(<data>, <actions>)"), " pattern creates",
-			" a store “machine”. We can then invoke (dispatch) registered action by calling",
-			" ", el("code", "S.action(<signal>, <name>, ...<args>)"), " after the action call",
-			" the signal calls all its listeners. This can be stopped by calling ", el("code", "this.stopPropagation()"),
-			" in the method representing the given action. As it can be seen in examples, the “store” value is",
-			" available also in the function for given action (", el("code", "this.value"), ")."
-		),
-
-		el(h3, "Reactive DOM attributes and elements"),
-		el("p", "There are on basic level two distinc situation to mirror dynamic value into the DOM/UI"),
-		el("ol").append(
-			el("li", "to change some attribute(s) of existing element(s)"),
-			el("li", "to generate elements itself dynamically – this covers conditions and loops")
-		),
-		el(example, { src: fileURL("./components/examples/signals/dom-attrs.js"), page_id }),
-		el("p").append(
-			"To derived attribute based on value of signal variable just use the signal as",
-			" a value of the attribute (", el("code", "assign(element, { attribute: S('value') })"), ").",
-			" ", el("code", "assign"), "/", el("code", "el"), " provides ways to glue reactive attributes/classes",
-			" more granularly into the DOM. Just use dedicated build-in attributes ", el("code", "dataset"), ", ",
-			el("code", "ariaset"), " and ", el("code", "classList"), "."
-		),
-		el("p").append(
-			"For computation, you can use the “derived signal” (see above) like ", el("code", "assign(element, { textContent: S(()=> 'Hello '+WorldSignal()) })"), ".",
-			" ",
-			"This is read-only signal its value is computed based on given function and updated when any signal used in the function changes."
-		),
-		el("p").append(
-			"To represent part of the template filled dynamically based on the signal value use ", el("code", "S.el(signal, DOMgenerator)"), ".",
-			" This was already used in the todo example above or see:"
-		),
-		el(example, { src: fileURL("./components/examples/signals/dom-el.js"), page_id }),
-
-		el(mnemonic)
-	);
-}

docs_src/p05-scopes.html.js

@@ -1,79 +0,0 @@
-export const info= {
-	title: "Scopes and components",
-	description: "Organizing UI into components",
-};
-
-import { el } from "deka-dom-el";
-import { simplePage } from "./layout/simplePage.html.js";
-import { example } from "./components/example.html.js";
-import { h3 } from "./components/pageUtils.html.js";
-import { mnemonic } from "./components/mnemonic/scopes-init.js";
-import { code } from "./components/code.html.js";
-/** @param {string} url */
-const fileURL= url=> new URL(url, import.meta.url);
-
-/** @param {import("./types.d.ts").PageAttrs} attrs */
-export function page({ pkg, info }){
-	const page_id= info.id;
-	return el(simplePage, { info, pkg }).append(
-		el("h2", "Using functions as UI components"),
-		el("p").append(
-			"For state-less components we can use functions as UI components (see “Elements” page).",
-			" But in real life, we may need to handle the component live-cycle and provide",
-			" JavaScript the way to properly use the ", el("a", { textContent: "Garbage collection", href: "https://developer.mozilla.org/en-US/docs/Glossary/Garbage_collection", title: "Garbage collection | MDN" }), "."
-		),
-		el(code, { src: fileURL("./components/examples/scopes/intro.js"), page_id }),
-		el("p").append(
-			"The library therefore use ", el("em", "scopes"), " to provide these functionalities.",
-		),
-		
-		el(h3, "Scopes and hosts"),
-		el("p").append(
-			"The ", el("strong", "host"), " is the name for the element representing the component.",
-			" This is typically element returned by function. To get reference, you can use ",
-			el("code", "scope.host()"), " to applly addons just use ", el("code", "scope.host(...<addons>)"), "."
-		),
-		el(example, { src: fileURL("./components/examples/scopes/scopes-and-hosts.js"), page_id }),
-		el("p").append(
-			"To better understanding we implement function ", el("code", "elClass"), " helping to create",
-			" component as class instances."
-		),
-		el(example, { src: fileURL("./components/examples/scopes/class-component.js"), page_id }),
-		el("p").append(
-			"As you can see, the ", el("code", "scope.host()"), " is stored temporarily and synchronously.",
-			" Therefore, at least in the beginning of using library, it is the good practise to store",
-			" ", el("code", "host"), " in the root of your component. As it may be changed, typically when",
-			" there is asynchronous code in the component."
-		),
-		el(code, { src: fileURL("./components/examples/scopes/good-practise.js"), page_id }),
-
-		el(h3, "Scopes, signals and cleaning magic"),
-		el("p").append(
-			"The ", el("code", "host"), " is internally used to register the cleaning procedure,",
-			" when the component (", el("code", "host"), " element) is removed from the DOM."
-		),
-		el(example, { src: fileURL("./components/examples/scopes/cleaning.js"), page_id }),
-		el("p").append(
-			"The text content of the paragraph is changing when the value of the signal ", el("code", "textContent"),
-			" is changed. Internally, there is association between ", el("code", "textContent"), " and the paragraph",
-			" similar to using ", el("code", "S.on(textContent, /* update the paragraph */)"), "."
-		),
-		el("p").append(
-			"This listener must be removed when the component is removed from the DOM. To do it, the library",
-			" assign internally ", el("code", "on.disconnected(/* remove the listener */)(host())"), " to the host element."
-		),
-		el("p", { className: "notice" }).append(
-			"The library DOM API and signals works ideally when used declaratively.",
-			" It means, you split your app logic into three parts as it was itroduced in ", el("a", { textContent: "Signals", href: "http://localhost:40911/docs/p04-signals#h-introducing-signals" }), "."
-		),
-		el(code, { src: fileURL("./components/examples/scopes/declarative.js"), page_id }),
-		el("p").append(
-			"Strictly speaking, the imperative way of using the library is not prohibited.",
-			" Just be careful (rather avoid) mixing declarative approach (using signals)",
-			" and imperative manipulation of elements.",
-		),
-		el(code, { src: fileURL("./components/examples/scopes/imperative.js"), page_id }),
-
-		el(mnemonic)
-	);
-}

docs_src/p06-customElement.html.js

@@ -1,36 +0,0 @@
-export const info= {
-	title: "Custom elements",
-	description: "Using custom elements in combinantion with DDE",
-};
-
-import { el } from "deka-dom-el";
-import { simplePage } from "./layout/simplePage.html.js";
-import { example } from "./components/example.html.js";
-import { h3 } from "./components/pageUtils.html.js";
-import { mnemonic } from "./components/mnemonic/customElement-init.js";
-import { code } from "./components/code.html.js";
-/** @param {string} url */
-const fileURL= url=> new URL(url, import.meta.url);
-
-/** @param {import("./types.d.ts").PageAttrs} attrs */
-export function page({ pkg, info }){
-	const page_id= info.id;
-	return el(simplePage, { info, pkg }).append(
-		el("h2", "Using custom elements in combinantion with DDE"),
-		el("p").append(
-
-		),
-		el(code, { src: fileURL("./components/examples/customElement/intro.js"), page_id }),
-
-		el(h3, "Custom Elements Introduction"),
-		el("p").append(
-			el("a", { textContent: "Using custom elements", href: "https://developer.mozilla.org/en-US/docs/Web/API/Web_components/Using_custom_elements", title: "Article about custom elements on MDN" })
-		),
-		el(code, { src: fileURL("./components/examples/customElement/native-basic.js"), page_id }),
-		el("p").append(
-			el("a", { textContent: "Handy Custom Elements' Patterns", href: "https://gist.github.com/WebReflection/ec9f6687842aa385477c4afca625bbf4", title: "Ideas and tips from WebReflection" })
-		),
-
-		el(mnemonic)
-	);
-}

examples/index.js

@@ -1,18 +1,22 @@
-import { style, el } from './exports.js';
+import { style, el, S } from './exports.js';
 document.head.append(style.element);
 import { fullNameComponent } from './components/fullNameComponent.js';
 import { todosComponent } from './components/todosComponent.js';
 import { CustomHTMLTestElement, CustomSlottingHTMLElement } from "./components/webComponent.js";
 import { thirdParty } from "./components/3rd-party.js";
 
+const toggle= S(false);
 document.body.append(
 	el("h1", "Experiments:"),
 	el(fullNameComponent),
 	el(todosComponent),
 	el(CustomHTMLTestElement.tagName, { name: "attr" }),
 	el(thirdParty),
-	el(CustomSlottingHTMLElement.tagName).append(
+	el(CustomSlottingHTMLElement.tagName, { onclick: ()=> toggle(!toggle()) }).append(
 		el("strong", { slot: "name", textContent: "Honzo" }),
-		el("span", "…default slot")
+		S.el(toggle, is=> is
+			? el("span", "…default slot")
+			: el("span", "…custom slot")
+		)
 	)
 );

index.d.ts

@@ -47,7 +47,7 @@ type ExtendedHTMLElementTagNameMap= HTMLElementTagNameMap & CustomElementTagName
 type textContent= string | ddeSignal<string>;
 export function el<
 	TAG extends keyof ExtendedHTMLElementTagNameMap,
-	EL extends (TAG extends keyof ExtendedHTMLElementTagNameMap ? ExtendedHTMLElementTagNameMap[TAG] : HTMLElement)
+	EL extends ExtendedHTMLElementTagNameMap[TAG]
 >(
 	tag_name: TAG,
 	attrs?: ElementAttributes<EL> | textContent,
@@ -58,7 +58,7 @@ export function el(
 ): ddeDocumentFragment
 export function el(
 	tag_name: string,
-	attrs?: ElementAttributes<HTMLElement>,
+	attrs?: ElementAttributes<HTMLElement> | textContent,
 	...addons: ddeElementAddon<HTMLElement>[]
 ): ddeHTMLElement
 
@@ -101,7 +101,18 @@ export function elNS(
 export { elNS as createElementNS }
 
 export function chainableAppend<EL extends SupportedElement>(el: EL): EL;
-export function simulateSlots<EL extends SupportedElement | DocumentFragment>(el: EL): EL
+/**
+ * Mapper function (optional). Pass for coppying attributes, this is NOT implemented by {@link simulateSlots} itself!
+ * */
+type simulateSlotsMapper= (body: HTMLSlotElement, el: HTMLElement)=> void;
+/** Simulate slots for ddeComponents */
+export function simulateSlots<EL extends SupportedElement | DocumentFragment>(root: EL, mapper?: simulateSlotsMapper): EL
+/**
+ * Simulate slots in Custom Elements without using `shadowRoot`.
+ * @param el Custom Element root element
+ * @param body Body of the custom element
+ * */
+export function simulateSlots<EL extends SupportedElement | DocumentFragment>(el: HTMLElement, body: EL, mapper?: simulateSlotsMapper): EL
 
 export function dispatchEvent(name: keyof DocumentEventMap | string, options?: EventInit):
 	(element: SupportedElement, data?: any)=> void;
@@ -177,12 +188,12 @@ export const scope: {
 
 export function customElementRender<
 	EL extends HTMLElement,
-	P extends any = Record<string, any>
+	P extends any = Record<string, string | ddeSignal<string>>
 >(
 	custom_element: EL,
 	target: ShadowRoot | EL,
 	render: (props: P)=> SupportedElement | DocumentFragment,
-	props?: P | ((...args: any[])=> P)
+	props?: P | ((el: EL)=> P)
 ): EL
 export function customElementWithDDE<EL extends (new ()=> HTMLElement)>(custom_element: EL): EL
 export function lifecyclesToEvents<EL extends (new ()=> HTMLElement)>(custom_element: EL): EL

package.json

@@ -62,14 +62,12 @@
 			"limit": "10.5 kB",
 			"gzip": false,
 			"brotli": false
-
 		},
 		{
 			"path": "./signals.js",
 			"limit": "12 kB",
 			"gzip": false,
 			"brotli": false
-
 		},
 		{
 			"path": "./index-with-signals.js",
@@ -95,12 +93,12 @@
 		"typescript"
 	],
 	"devDependencies": {
-		"@size-limit/preset-small-lib": "^11.0.1",
-		"dts-bundler": "^0.1.0",
-		"esbuild": "^0.19.9",
-		"jsdom": "^23.0.1",
-		"jshint": "^2.13.6",
-		"nodejsscript": "github:jaandrle/nodejsscript#dev-v1",
-		"size-limit-node-esbuild": "^0.3.0"
+		"@size-limit/preset-small-lib": "~11.0",
+		"dts-bundler": "~0.1",
+		"esbuild": "~0.24",
+		"jsdom": "~25.0",
+		"jshint": "~2.13",
+		"nodejsscript": "^1.0.2",
+		"size-limit-node-esbuild": "~0.3"
 	}
 }

signals.d.ts

@@ -55,7 +55,7 @@ interface signal{
 	 * */
 	el<S extends any>(signal: Signal<S, any>, el: (v: S)=> Element | Element[] | DocumentFragment): DocumentFragment;
 
-    observedAttributes(custom_element: HTMLElement): Record<string, Signal<any, any>>;
+    observedAttributes(custom_element: HTMLElement): Record<string, Signal<string, {}>>;
 }
 export const signal: signal;
 export const S: signal;

src/dom.js

@@ -67,18 +67,23 @@ export function createElement(tag, attributes, ...addons){
 }
 import { hasOwn } from "./helpers.js";
 /** @param {HTMLElement} element @param {HTMLElement} [root] */
-export function simulateSlots(element, root= element, mapper= undefined){
+export function simulateSlots(element, root, mapper){
+	if(typeof root!=="object"){
+		mapper= root;
+		root= element;
+	}
 	const _default= Symbol.for("default");
 	const slots= Array.from(root.querySelectorAll("slot"))
 		.reduce((out, curr)=> Reflect.set(out, curr.name || _default, curr) && out, {});
 	const has_d= hasOwn(slots, _default);
 	element.append= new Proxy(element.append, {
 		apply(orig, _, els){
+			if(els[0]===root) return orig.apply(element, els);
 			if(!els.length) return element;
 
 			const d= env.D.createDocumentFragment();
 			for(const el of els){
-				if(!el || !el.slot){ if(has_d) d.appendChild(el); continue; }
+				if(!el || !el.slot){ if(has_d) d.append(el); continue; }
 				const name= el.slot;
 				const slot= slots[name];
 				elementAttribute(el, "remove", "slot");