@manyducks.co/dolla 3.2.0 → 3.3.0

package/dist/core/index.d.ts

@@ -1,6 +1,6 @@
 export { createRoot } from "./root.js";
 export type { DollaPlugin } from "./root.js";
-export { batch, compose, createAtom, createEffect, createStream, peek, subscribe, unwrap } from "./signals.js";
+export { batch, compose, createAtom, createEffect, createSetter, createStream, peek, subscribe, unwrap, } from "./signals.js";
 export type { Getter, Setter } from "./signals.js";
 export { addStore, getNearestViewNode, getRootElement, getStore, onCleanup, onEffect, onMount } from "./context.js";
 export type { Context } from "./context.js";

package/dist/core/signals.d.ts

@@ -42,7 +42,25 @@ export declare function createAtom<T>(): AtomAccessors<T | undefined>;
  * getValue("overwritten");
  * getInputValue(); // "overwritten"
  */
-export declare function createAtom<T>(compute: Getter<T>): AtomAccessors<T>;
+export declare function createAtom<T>(initialValue: Getter<T>): AtomAccessors<T>;
+/**
+ * Creates a new atom with a value computed from an existing getter.
+ * This is usually used to create a 'settable' getter, in which you can store
+ * a temporary value until it gets overwritten by a _real_ update.
+ *
+ * @example
+ * const [getValue, setValue] = createAtom("");
+ * const [getInputValue, setInputValue] = createAtom(getValue);
+ *
+ * setInputValue("temporary");
+ * getValue("");
+ * getInputValue(); // "temporary"
+ *
+ * setValue("overwritten");
+ * getValue("overwritten");
+ * getInputValue(); // "overwritten"
+ */
+export declare function createAtom<T>(initialValue: MaybeGetter<T>): AtomAccessors<T>;
 /**
  * Creates a new atom with an initial value.
  * Returns a `[getter, setter]` function tuple.
@@ -51,6 +69,10 @@ export declare function createAtom<T>(compute: Getter<T>): AtomAccessors<T>;
  * const [getCount, setCount] = createAtom(5);
  */
 export declare function createAtom<T>(initialValue: T): AtomAccessors<T>;
+/**
+ * Creates a customsetter with a `getter` as its source.
+ */
+export declare function createSetter<T>(getter: Getter<T>, callback: (current: T) => T | void): Setter<T>;
 export declare function compose<T>(getter: T | ((previousValue?: T) => Getter<T> | T)): Getter<T>;
 export declare function createEffect(fn: () => void): () => void;
 /**

package/dist/{core-2CFW0uRa.js → core-BRSu5hVw.js}

@@ -56,7 +56,7 @@ function _(e, t, n) {
 	i !== void 0 && (i._prevDep = o), r === void 0 ? t._deps = o : r._nextDep = o, a === void 0 ? e._subs = o : a._nextSub = o;
 }
 function ee(e) {
-	e._flags & u.Mutable ? e._depsTail !== void 0 && (e._depsTail = void 0, e._flags = u.Mutable | u.Dirty, S(e)) : me.call(e);
+	e._flags & u.Mutable ? e._depsTail !== void 0 && (e._depsTail = void 0, e._flags = u.Mutable | u.Dirty, S(e)) : he.call(e);
 }
 function te(e, t = e._sub) {
 	let n = e._dep, r = e._prevDep, i = e._nextDep, a = e._nextSub, o = e._prevSub;
@@ -267,7 +267,11 @@ function pe(e) {
 		e !== void 0 && (re(e), f || x());
 	}
 }
-function me() {
+function me(e, t) {
+	let n = typeof t == "function" ? t(D(this)) : t;
+	return e(n) ?? n;
+}
+function he() {
 	this._depsTail = void 0, this._flags = u.None, S(this);
 	let e = this._subs;
 	e !== void 0 && te(e), this._cleanup?.(), this._cleanup = void 0;
@@ -296,6 +300,9 @@ function C(e) {
 		return [fe.bind(t), pe.bind(t)];
 	}
 }
+function ge(e, t) {
+	return me.bind(e, t);
+}
 function w(e) {
 	return o(e) ? ue.bind({
 		_value: void 0,
@@ -324,7 +331,7 @@ function T(e) {
 	} finally {
 		h = n, t._flags &= ~u.RecursedCheck;
 	}
-	return me.bind(t);
+	return he.bind(t);
 }
 function E(e) {
 	return o(e) ? e() : e;
@@ -337,7 +344,7 @@ function D(e) {
 		b(t);
 	}
 }
-function he(e) {
+function _e(e) {
 	++f;
 	try {
 		e();
@@ -429,7 +436,7 @@ function k({ value: e, signal: t }) {
 		}
 	};
 }
-function ge(e) {
+function ve(e) {
 	let t = {
 		_currentValue: e?.initialValue,
 		_pendingValue: e?.initialValue,
@@ -447,9 +454,9 @@ function ge(e) {
 }
 //#endregion
 //#region src/core/markup/types.ts
-var _e = Symbol(), ve = Symbol(), ye = Symbol(), A = class {
-	static [ye] = !0;
-	get [ve]() {
+var ye = Symbol(), be = Symbol(), xe = Symbol(), A = class {
+	static [xe] = !0;
+	get [be]() {
 		return !0;
 	}
 }, j = class extends A {
@@ -470,7 +477,7 @@ var _e = Symbol(), ve = Symbol(), ye = Symbol(), A = class {
 		e || this.#e.parentNode?.removeChild(this.#e);
 	}
 	move(e, t) {
-		Ae(e, this.#e, t);
+		Me(e, this.#e, t);
 	}
 };
 //#endregion
@@ -543,7 +550,7 @@ var N = class extends A {
 			a && (r = a);
 		}
 	}
-}, be = Symbol("parentElement"), P = Symbol("debug"), F = Symbol("isSVG"), xe = ["ref", "children"], Se = class extends A {
+}, Se = Symbol("parentElement"), P = Symbol("debug"), F = Symbol("isSVG"), Ce = ["ref", "children"], we = class extends A {
 	#e;
 	#t;
 	#n;
@@ -553,7 +560,7 @@ var N = class extends A {
 	#o;
 	constructor(e, t, n) {
 		if (super(), this.#t = n, this.#n = e, t === "svg" ? (this.#n = K(e), this.#n[F] = !0, this.#r = !0) : this.#n[F] && t === "foreignObject" && (this.#n = K(e), this.#n[F] = !1, this.#r = !1), this.#n[F] ? this.#e = document.createElementNS("http://www.w3.org/2000/svg", t) : this.#e = document.createElement(t), this.#n[P]) {
-			let e = Fe(this.#n);
+			let e = Le(this.#n);
 			e && (this.#e.dataset.view = e.context.name);
 		}
 	}
@@ -565,7 +572,7 @@ var N = class extends A {
 	}
 	mount(e, t) {
 		let r = this.isMounted();
-		if (!r && (this.#c(this.#e, n(xe, this.#t)), this.#t.children)) {
+		if (!r && (this.#c(this.#e, n(Ce, this.#t)), this.#t.children)) {
 			this.#i = z(this.#n, this.#t.children);
 			for (let e of this.#i) e.mount(this.#e);
 		}
@@ -634,13 +641,13 @@ var N = class extends A {
 			n.forEach((e) => {
 				e(), this.#a.delete(e);
 			}), n.clear(), e.style.cssText = "";
-			let r = we(t);
+			let r = Ee(t);
 			for (let [t, { value: i, priority: a }] of Object.entries(r)) if (o(i)) {
 				let r = O(i, (n) => {
-					n ? e.style.setProperty(t, Ee(n), a) : e.style.removeProperty(t);
+					n ? e.style.setProperty(t, Oe(n), a) : e.style.removeProperty(t);
 				});
 				this.#a.add(r), n.add(r);
-			} else i != null && e.style.setProperty(t, Ee(i), a);
+			} else i != null && e.style.setProperty(t, Oe(i), a);
 		};
 		o(t) ? this.#a.add(O(t, r)) : r(t);
 	}
@@ -649,7 +656,7 @@ var N = class extends A {
 			n.forEach((e) => {
 				e(), this.#a.delete(e);
 			}), n.clear(), I(e, "class", null);
-			let r = Ce(t);
+			let r = Te(t);
 			for (let [t, i] of Object.entries(r)) if (t !== "undefined") if (o(i)) {
 				let r = O(i, (n) => e.classList.toggle(t, !!n));
 				this.#a.add(r), n.add(r);
@@ -658,22 +665,22 @@ var N = class extends A {
 		o(t) ? this.#a.add(O(t, r)) : r(t);
 	}
 };
-function Ce(e) {
-	return a(e) ? Object.fromEntries(e.split(" ").map((e) => [e, !0])) : i(e) ? Object.assign({}, ...e.filter(Boolean).map(Ce)) : l(e) ? e : {};
+function Te(e) {
+	return a(e) ? Object.fromEntries(e.split(" ").map((e) => [e, !0])) : i(e) ? Object.assign({}, ...e.filter(Boolean).map(Te)) : l(e) ? e : {};
 }
-function we(e) {
+function Ee(e) {
 	return a(e) ? Object.fromEntries(e.split(";").filter((e) => e.trim()).map((e) => {
 		let [t, n] = e.split(":");
-		return [Te(t.trim()), {
+		return [De(t.trim()), {
 			value: n.replace("!important", "").trim(),
 			priority: n.includes("!important") ? "important" : ""
 		}];
-	})) : i(e) ? Object.assign({}, ...e.filter(Boolean).map(we)) : l(e) ? Object.fromEntries(Object.entries(e).map(([e, t]) => [e.startsWith("--") ? e : Te(e), { value: t }])) : {};
+	})) : i(e) ? Object.assign({}, ...e.filter(Boolean).map(Ee)) : l(e) ? Object.fromEntries(Object.entries(e).map(([e, t]) => [e.startsWith("--") ? e : De(e), { value: t }])) : {};
 }
-function Te(e) {
+function De(e) {
 	return e.replace(/[A-Z]+(?![a-z])|[A-Z]/g, (e, t) => (t ? "-" : "") + e.toLowerCase());
 }
-function Ee(e) {
+function Oe(e) {
 	return c(e) ? `${e}px` : e;
 }
 function I(e, t, n) {
@@ -683,20 +690,20 @@ function I(e, t, n) {
 //#region src/core/markup/utils.ts
 function L(e, t) {
 	return {
-		[_e]: !0,
+		[ye]: !0,
 		type: e,
 		props: t
 	};
 }
-function De(e) {
-	return e && e[_e];
-}
-function Oe(e) {
-	return e && e[ve];
-}
 function ke(e) {
 	return e && e[ye];
 }
+function Ae(e) {
+	return e && e[be];
+}
+function je(e) {
+	return e && e[xe];
+}
 function R(e, t = K()) {
 	let n = z(t, e);
 	return n.length === 1 ? n[0] : new N(t, () => n);
@@ -706,10 +713,10 @@ function z(e, ...t) {
 	function r(t) {
 		if (!(t == null || t === !1)) if (i(t)) for (let e = 0; e < t.length; e++) r(t[e]);
 		else if (a(t) || c(t)) n.push(new j(e, V(String(t))));
-		else if (De(t)) {
+		else if (ke(t)) {
 			let { type: r, props: i } = t;
-			ke(r) ? n.push(new r(e, ...i.args)) : o(r) ? n.push(new U(e, r, i)) : a(r) && n.push(new Se(e, r, i));
-		} else Oe(t) ? n.push(t) : t instanceof Node ? n.push(new j(e, t)) : o(t) && n.push(new N(e, t));
+			je(r) ? n.push(new r(e, ...i.args)) : o(r) ? n.push(new U(e, r, i)) : a(r) && n.push(new we(e, r, i));
+		} else Ae(t) ? n.push(t) : t instanceof Node ? n.push(new j(e, t)) : o(t) && n.push(new N(e, t));
 	}
 	for (let e = 0; e < t.length; e++) r(t[e]);
 	return n;
@@ -720,7 +727,7 @@ function B(e, t, n) {
 function V(e) {
 	return document.createTextNode(e);
 }
-function Ae(e, t, n) {
+function Me(e, t, n) {
 	let r = n?.nextSibling ?? null;
 	if (e.moveBefore) try {
 		e.moveBefore(t, r);
@@ -733,13 +740,13 @@ function H(e, t, n) {
 }
 //#endregion
 //#region src/core/markup/nodes/view.ts
-var je = Symbol.for("ViewNode"), U = class extends A {
+var Ne = Symbol.for("ViewNode"), U = class extends A {
 	#e;
 	#t;
 	#n;
 	context;
 	constructor(e, t, n) {
-		super(), this.context = K(e), this.context[je] = this, this.context.name = t.name, this.#e = n, this.#t = t;
+		super(), this.context = K(e), this.context[Ne] = this, this.context.name = t.name, this.#e = n, this.#t = t;
 	}
 	getRoot() {
 		return this.#n?.getRoot();
@@ -766,12 +773,12 @@ function K(e) {
 	return Object.assign(Object.create(e ?? null), { isMounted: !1 });
 }
 function q(e) {
-	e.isMounted || (e.isMounted = !0, Me(e, W));
+	e.isMounted || (e.isMounted = !0, Pe(e, W));
 }
 function J(e) {
-	e.isMounted && (e.isMounted = !1, Me(e, G));
+	e.isMounted && (e.isMounted = !1, Pe(e, G));
 }
-function Me(e, t) {
+function Pe(e, t) {
 	if (Object.hasOwn(e, t)) {
 		for (let n of e[t]) n();
 		e[t].length = 0;
@@ -783,36 +790,36 @@ function Y(e, t) {
 function X(e, t) {
 	Object.hasOwn(e, G) ? e[G].push(t) : e[G] = [t];
 }
-function Ne(e, t) {
+function Fe(e, t) {
 	e.isMounted ? X(e, T(t)) : Y(e, () => {
 		X(e, T(t));
 	});
 }
-function Pe(e) {
-	return e[be];
+function Ie(e) {
+	return e[Se];
 }
-function Fe(e) {
-	return e[je];
+function Le(e) {
+	return e[Ne];
 }
 var Z = Symbol("Dolla.StoreId");
-function Ie(e, t, ...n) {
+function Re(e, t, ...n) {
 	t[Z] ??= Symbol(t.name), r(!Object.hasOwn(e, t[Z]), "Store was already provided on this context.");
 	let i = K(e);
 	return Y(e, () => q(i)), X(e, () => J(i)), i.name = t.name, e[t[Z]] = t.call(i, n[0], i);
 }
-function Le(e, t) {
+function ze(e, t) {
 	let n = t[Z], i = n ? e[n] : void 0;
 	return r(i != null, `Store '${t.name}' is not provided by this context.`), i;
 }
 //#endregion
 //#region src/core/root.ts
-function Re(e, t) {
+function Be(e, t) {
 	let n = a(e) ? document.querySelector(e) : e;
 	r(n, "Element cannot be null.");
 	let i = K();
 	i.name = "dolla:root";
 	let s = [], c = [];
-	i[be] = n, i[P] = !!t?.debug;
+	i[Se] = n, i[P] = !!t?.debug;
 	let l = null, u = {
 		plugin: d,
 		mount: f,
@@ -834,23 +841,23 @@ function Re(e, t) {
 }
 //#endregion
 //#region src/core/debug.ts
-var ze = () => {}, Be = {
+var Ve = () => {}, He = {
 	trace: 1,
 	info: 1,
 	log: 2,
 	warn: 3,
 	error: 4,
 	silent: 5
-}, Ve = 1, He = (e) => !e.startsWith("dolla:"), Ue = (e) => {
-	Ve = Be[e] || 1;
-}, We = (e) => {
-	He = e;
+}, Ue = 1, We = (e) => !e.startsWith("dolla:"), Ge = (e) => {
+	Ue = He[e] || 1;
+}, Ke = (e) => {
+	We = e;
 }, Q = globalThis.console || {};
-function Ge(e, ...t) {
+function qe(e, ...t) {
 	let n = e.name, r, i = (e, i) => {
-		if (i < Ve || !He(n) || !Q[e]) return ze;
+		if (i < Ue || !We(n) || !Q[e]) return Ve;
 		if (!r) {
-			let e = "%c" + n, i = [`color:${qe(n)};font-weight:bold`];
+			let e = "%c" + n, i = [`color:${Ye(n)};font-weight:bold`];
 			for (let [n, r] of t) e += `%c[${n}: %c${r}%c]`, i.push("color:#777", "color:#aaa", "color:#777");
 			r = [e, ...i];
 		}
@@ -874,18 +881,18 @@ function Ge(e, ...t) {
 		}
 	};
 }
-function Ke(e, ...t) {
+function Je(e, ...t) {
 	let n = K();
-	return n.name = e, Ge(n, ...t);
+	return n.name = e, qe(n, ...t);
 }
-function qe(e) {
+function Ye(e) {
 	let t = 0;
 	for (let n = 0; n < e.length; n++) t = (t + e.charCodeAt(n) * 10) % 360;
 	return `oklch(0.68 0.15 ${t}deg)`;
 }
 //#endregion
 //#region src/core/markup/nodes/portal.ts
-var Je = class extends A {
+var Xe = class extends A {
 	#e = V("");
 	#t;
 	#n;
@@ -907,9 +914,9 @@ var Je = class extends A {
 		this.isMounted() && (e || this.#e.parentNode?.removeChild(this.#e), this.#i?.isMounted() && this.#i.unmount(!1));
 	}
 	move(e, t) {
-		Ae(e, this.#e, t);
+		Me(e, this.#e, t);
 	}
-}, Ye = class extends A {
+}, Ze = class extends A {
 	#e = V("");
 	#t;
 	#n;
@@ -947,7 +954,7 @@ var Je = class extends A {
 		if (!this.isMounted()) return;
 		if (e.length === 0) return this._cleanup(!1);
 		let t = /* @__PURE__ */ new Map();
-		he(() => {
+		_e(() => {
 			let n = new Set(e.map((e, t) => this.#r(e, t)));
 			for (let [e, t] of this.#o.entries()) n.has(e) || t._node.unmount(!1);
 			for (let r = 0; r < e.length; r++) {
@@ -976,31 +983,31 @@ var Je = class extends A {
 };
 //#endregion
 //#region src/core/markup/helpers.ts
-function Xe(e, t, n) {
-	return o(e) ? L(Ye, { args: [
+function Qe(e, t, n) {
+	return o(e) ? L(Ze, { args: [
 		e,
 		t,
 		n
 	] }) : Array.from(e).map((e, t) => n(() => e, () => t));
 }
-function Ze(e, t, n) {
+function $e(e, t, n) {
 	return o(e) ? L(N, { args: [w(() => e() ? t : n)] }) : e ? t : n;
 }
-function Qe(e, t, n) {
-	return Ze(e, t, n);
+function et(e, t, n) {
+	return $e(e, t, n);
 }
-function $e(e, t, n) {
-	return Ze(e, n, t);
+function tt(e, t, n) {
+	return $e(e, n, t);
 }
-function et(e, t) {
-	return L(Je, { args: [t, e] });
+function nt(e, t) {
+	return L(Xe, { args: [t, e] });
 }
 //#endregion
 //#region src/core/markup/html.ts
 var $ = /* @__PURE__ */ function(e) {
 	return e[e.Slash = 0] = "Slash", e[e.Text = 1] = "Text", e[e.Whitespace = 2] = "Whitespace", e[e.TagName = 3] = "TagName", e[e.Comment = 4] = "Comment", e[e.PropSet = 5] = "PropSet", e[e.PropAppend = 6] = "PropAppend", e;
 }($ || {});
-function tt(e, ...t) {
+function rt(e, ...t) {
 	let n = [e, ...t], r = $.Text, i = "", a = "", o = [0], s = "", c = (e) => {
 		r === $.Text && (e || (i = i.replace(/^\s*\n\s*|\s*\n\s*$/g, ""))) ? o.push(e ? n[e] : i) : r === $.TagName && (e || i) ? (o[1] = e ? n[e] : i, r = $.Whitespace) : r === $.Whitespace && i === "..." && e ? o[2] = Object.assign(o[2] || {}, n[e]) : r === $.Whitespace && i && !e ? (o[2] = o[2] || {})[i] = !0 : r >= $.PropSet && (r === $.PropSet ? ((o[2] = o[2] || {})[s] = e ? i ? i + n[e] : n[e] : i, r = $.PropAppend) : (e || i) && (o[2][s] += e ? i + n[e] : i)), i = "";
 	};
@@ -1035,13 +1042,13 @@ function tt(e, ...t) {
 }
 //#endregion
 //#region src/core/ref.ts
-function nt() {
+function it() {
 	let e;
 	return ((...t) => t.length ? (e = t[0], () => {
 		e = void 0;
 	}) : e);
 }
 //#endregion
-export { ge as A, R as C, w as D, he as E, i as F, o as I, l as L, O as M, E as N, C as O, r as P, a as R, L as S, N as T, X as _, $e as a, U as b, Ge as c, Re as d, Ie as f, Le as g, Pe as h, Xe as i, D as j, T as k, We as l, Fe as m, tt as n, Qe as o, K as p, et as r, Ke as s, nt as t, Ue as u, Ne as v, P as w, H as x, Y as y, t as z };
+export { ge as A, t as B, R as C, w as D, _e as E, r as F, i as I, o as L, D as M, O as N, C as O, E as P, l as R, L as S, N as T, X as _, tt as a, U as b, qe as c, Be as d, Re as f, ze as g, Ie as h, Qe as i, ve as j, T as k, Ke as l, Le as m, rt as n, et as o, K as p, nt as r, Je as s, it as t, Ge as u, Fe as v, P as w, H as x, Y as y, a as z };
 
-//# sourceMappingURL=core-2CFW0uRa.js.map
+//# sourceMappingURL=core-BRSu5hVw.js.map