@manyducks.co/dolla 2.0.0 → 3.0.0

package/dist/types.d.ts

@@ -1,30 +1,21 @@
 import type * as CSS from "csstype";
-import type { Markup, MarkupNode } from "./core/markup.js";
-import type { Signal } from "./core/signals.js";
+import type { ComponentState, Context } from "./core/context.js";
+import type { Markup, MarkupNode } from "./core/markup/types.js";
+import type { Getter } from "./core/signals.js";
 export type Env = "production" | "development";
 /**
  * Represents everything that can be handled as a DOM node.
  * These are all the items considered valid to pass as children to any element.
  */
-export type Renderable = string | number | Node | Markup | MarkupNode | false | null | undefined | Signal<any> | (string | number | Node | Markup | MarkupNode | false | null | undefined | Signal<any>)[];
+export type Renderable = string | number | Node | Markup | MarkupNode | false | null | undefined | void | Getter<any> | Renderable[];
 export interface BaseProps {
     children?: Renderable;
 }
-/**
- *
- */
-export type View<Props> = (props: Props) => Renderable;
-/**
- *
- */
-export type Store<Options, Value> = (options: Options) => Value;
-/**
- *
- */
-export type Mixin<E extends Element = Element> = (element: E) => void;
-type MaybeSignal<T> = T | Signal<T> | Signal<T | undefined>;
-type OptionalProperty<T> = MaybeSignal<T>;
-type RequiredProperty<T> = T | Signal<T>;
+export type View<Props = {}, State = Record<string | symbol, any>> = (this: Context<ComponentState & State>, props: Props, context: Context<ComponentState & State>) => Renderable;
+export type Store<Props, Value, State = Record<string | symbol, any>> = (this: Context<ComponentState & State>, props: Props, context: Context<ComponentState & State>) => Value;
+export type MaybeGetter<T> = Getter<T> | T;
+type RequiredProperty<T> = Getter<T> | T;
+type OptionalProperty<T> = Getter<T> | Getter<T | undefined> | T;
 type AutocapitalizeValues = "off" | "on" | "none" | "sentences" | "words" | "characters";
 type ContentEditableValues = true | false | "true" | "false" | "plaintext-only" | "inherit";
 type ClassListValues = string | ClassMap | Array<string | ClassMap | (string | ClassMap)[]>;
@@ -48,12 +39,6 @@ export interface ElementProps {
      * Attaches an event listener to the element (with `addEventListener`).
      */
     [key: `on:${string}`]: OptionalProperty<EventHandler<Event>>;
-    /**
-     * HTML attributes to assign to the element.
-     */
-    /**
-     * Object of event listeners.
-     */
     /**
      * CSS classes to be applied to this element. In addition to the standard space-separated list of class names,
      * this property also supports a class map object with class names as keys and booleans as values.
@@ -158,7 +143,7 @@ export interface ElementProps {
      *
      * @see https://developer.mozilla.org/en-US/docs/Web/HTML/Global_attributes/style
      */
-    style?: string | CSSProperties | Signal<string> | Signal<CSSProperties> | Signal<string | CSSProperties> | Signal<string | undefined> | Signal<CSSProperties | undefined> | Signal<string | CSSProperties | undefined>;
+    style?: string | CSSProperties | Getter<string> | Getter<CSSProperties> | Getter<string | CSSProperties> | Getter<string | undefined> | Getter<CSSProperties | undefined> | Getter<string | CSSProperties | undefined>;
     /**
      * Fired when a CSS animation unexpectedly aborts.
      *
@@ -721,6 +706,10 @@ export interface ElementProps {
     onwheel?: OptionalProperty<EventHandler<WheelEvent>>;
 }
 export interface HTMLElementProps extends ElementProps {
+    /**
+     * Data attribute.
+     */
+    [key: `data-${string}`]: OptionalProperty<any>;
     /**
      * Sets the key a user can press to jump to this element.
      *
@@ -1002,12 +991,6 @@ export interface HTMLElementProps extends ElementProps {
      */
     onpaste?: OptionalProperty<EventHandler<ClipboardEvent>>;
 }
-export interface SVGElementProps extends ElementProps {
-    /**
-     * A mixin function or an array of mixin functions to be applied to this element.
-     */
-    mixin?: Mixin<SVGElement> | Mixin<SVGElement>[];
-}
 /**
  * Mapping of event props to event names.
  */
@@ -1279,7 +1262,7 @@ export type CSSProperties = {
     [K in keyof Styles]: OptionalProperty<Styles[K]>;
 };
 export interface ClassMap {
-    [className: string]: MaybeSignal<any>;
+    [className: string]: OptionalProperty<any>;
 }
 export type EventHandler<E> = (event: E) => void;
 export interface PropertiesOf<E extends HTMLElement> extends HTMLElementProps {
@@ -1289,12 +1272,9 @@ export interface PropertiesOf<E extends HTMLElement> extends HTMLElementProps {
     children?: any;
     /**
      * Receives a reference to the DOM node when rendered.
+     * Returns a cleanup function that is called when the node is removed.
      */
-    ref?: ((value: E | undefined) => void) | ((value: HTMLElement | undefined) => void) | ((value: Element | undefined) => void) | ((value: Node | undefined) => void);
-    /**
-     * A mixin function or an array of mixin functions to be applied to this element.
-     */
-    mixin?: Mixin<E> | Mixin<E>[];
+    ref?: ((value: E) => () => void) | ((value: HTMLElement) => () => void) | ((value: Element) => () => void) | ((value: Node) => () => void);
 }
 /**
  * The following elements are defined based on the WHATWG HTML spec:
@@ -2171,7 +2151,7 @@ interface HTMLMediaElementProps<T extends HTMLMediaElement> extends HTMLElementP
      *
      * @see https://developer.mozilla.org/en-US/docs/Web/API/HTMLMediaElement/srcObject
      */
-    srcObject?: MediaStream | MediaSource | Blob | File | Signal<MediaStream> | Signal<MediaStream | undefined> | Signal<MediaSource> | Signal<MediaSource | undefined> | Signal<Blob> | Signal<Blob | undefined> | Signal<File> | Signal<File | undefined>;
+    srcObject?: MediaStream | MediaSource | Blob | File | Getter<MediaStream> | Getter<MediaStream | undefined> | Getter<MediaSource> | Getter<MediaSource | undefined> | Getter<Blob> | Getter<Blob | undefined> | Getter<File> | Getter<File | undefined>;
     /**
      * The current audio volume of the media element. Must be a number between 0 and 1.
      *
@@ -2670,7 +2650,7 @@ interface HTMLImageElementProps extends PropertiesOf<HTMLImageElement> {
      *
      * @see https://developer.mozilla.org/en-US/docs/Web/API/HTMLImageElement/sizes
      */
-    sizes?: MaybeSignal<string>;
+    sizes?: OptionalProperty<string>;
     /**
      * The image URL.
      *
@@ -3425,4 +3405,6 @@ interface HTMLCanvasElementProps extends PropertiesOf<HTMLCanvasElement> {
      */
     height?: OptionalProperty<string | number> | OptionalProperty<string> | OptionalProperty<number>;
 }
+export interface IntrinsicElements {
+}
 export {};

package/dist/utils.d.ts

@@ -1,46 +1,58 @@
-export declare const noOp: () => void;
-export declare function getUniqueId(): string;
-export declare function getIntegerId(): number;
+export declare function uniqueId(): string;
 /**
- * Equality check that passes if both values are the same object.
- * This is the default equality check for states.
+ * Returns a new object without the specified keys.
+ * If called without object, returns a function that takes an object
+ * and returns a version with the original keys omitted.
+ *
+ * @param keys - An array of keys to omit.
+ * @param object - An object to clone without the omitted keys.
  */
-export declare function strictEqual(a: any, b: any): boolean;
+export declare function omit<O extends Record<any, any>>(keys: (keyof O)[], object: O): Record<any, any>;
 /**
- * Equality check that passes if both values are the same object, or if both are objects or arrays with equal keys and values.
+ * Throws a TypeError unless `condition` is truthy.
+ *
+ * @param value - Value whose truthiness is in question.
+ * @param errorMessage - Optional message for the thrown TypeError.
  */
-export declare function shallowEqual(a: any, b: any): boolean;
+export declare function assert<T = any>(value: T, errorMessage: string): asserts value is NonNullable<T>;
 /**
- * Equality check that passes if two objects have equal values, even if they are not the same object.
+ * Returns true if `value` is an array.
  */
-export declare function deepEqual(a: any, b: any): boolean;
+export declare function isArray(value: unknown): value is Array<unknown>;
 /**
- * Takes an old value and a new value.  Returns a merged copy if both are objects, otherwise returns the new value.
+ * Returns true when `value` is an array and `check` returns true for every item.
+ *
+ * @param check - Function to check items against.
+ * @param value - A possible array.
  */
-export declare function merge(one: unknown, two: unknown): any;
+export declare function isArrayOf<T>(check: (item: unknown) => boolean, value: unknown): value is T[];
+export declare function isArrayOf<T>(check: (item: unknown) => boolean): (value: unknown) => value is T[];
 /**
- * Returns a new object without the specified keys.
- * If called without object, returns a function that takes an object
- * and returns a version with the original keys omitted.
- *
- * @param keys - An array of keys to omit.
- * @param object - An object to clone without the omitted keys.
+ * Returns true if `value` is a string.
  */
-export declare function omit<O extends Record<any, any>>(keys: (keyof O)[], object: O): Record<any, any>;
-export declare function toArray<T>(value: T | T[]): T[];
-export declare function toCamelCase(s: string): string;
+export declare function isString(value: unknown): value is string;
 /**
- * Moves an element using `moveBefore` if the browser supports it, otherwise falls back to `insertBefore`.
+ * Returns true if `value` is a function (but not a class).
  */
-export declare function moveBefore(parent: Node, node: Node, child: Node | null): void;
+export declare function isFunction<T = (...args: unknown[]) => unknown>(value: unknown): value is T;
+export declare function isClass(value: unknown): boolean;
 /**
- * Takes any string and returns an OKLCH color.
+ * Returns true if `value` is a number.
  */
-export declare function okhash(value: string): string;
-export type MatcherFunction = (value: string) => boolean;
+export declare function isNumber(value: unknown): value is number;
 /**
- * Parses a filter string into a matcher function.
+ * Returns `true` if `value` is an instance of `constructor`.
  *
- * @param pattern - A string or regular expression that specifies a pattern for names of loggers whose messages you want to display.
+ * @param constructor - The constructor `value` must be an instance of.
+ * @param value - A value that may be an instance of `constructor`.
+ */
+export declare function isInstanceOf<T extends Function>(constructor: T, value: unknown): value is T;
+export declare function isInstanceOf<T extends Function>(constructor: T): (value: unknown) => value is T;
+/**
+ * Returns true if `value` is a JavaScript Promise.
+ */
+export declare function isPromise<T = unknown>(value: unknown): value is Promise<T>;
+/**
+ * Returns true if `value` is a plain JavaScript object.
  */
-export declare function createMatcher(pattern: string | RegExp): MatcherFunction;
+export declare function isObject<T = Record<string | number | symbol, unknown>>(value: unknown): value is T;

package/dist/utils.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/view-cBN-hn_T.js

@@ -0,0 +1,360 @@
+import { a as e, c as t, d as n, f as r, i, l as a, m as o, o as s, p as c, u as l } from "./signals-CMJPGr_M.js";
+//#region src/core/context.ts
+var u = Symbol("Context.mountListeners"), d = Symbol("Context.cleanupListeners");
+function f(e) {
+	return Object.assign(Object.create(e ?? null), { isMounted: !1 });
+}
+function p(e) {
+	e.isMounted || (e.isMounted = !0, h(e, u));
+}
+function m(e) {
+	e.isMounted && (e.isMounted = !1, h(e, d));
+}
+function h(e, t) {
+	if (Object.hasOwn(e, t)) {
+		for (let n of e[t]) n();
+		e[t].length = 0;
+	}
+}
+function g(e, t) {
+	Object.hasOwn(e, u) ? e[u].push(t) : e[u] = [t];
+}
+function _(e, t) {
+	Object.hasOwn(e, d) ? e[d].push(t) : e[d] = [t];
+}
+function v(e, t) {
+	e.isMounted ? _(e, i(t)) : g(e, () => {
+		_(e, i(t));
+	});
+}
+var y = Symbol("Dolla.StoreId");
+function b(e, n, ...r) {
+	n[y] ??= Symbol(n.name), t(!Object.hasOwn(e, n[y]), "Store was already provided on this context.");
+	let i = f(e);
+	return g(e, () => p(i)), _(e, () => m(i)), i.name = n.name, e[n[y]] = n.call(i, r[0], i);
+}
+function x(e, n) {
+	let r = n[y], i = r ? e[r] : void 0;
+	return t(i != null, `Store '${n.name}' is not provided by this context.`), i;
+}
+//#endregion
+//#region src/core/markup/types.ts
+var S = Symbol(), C = Symbol(), w = Symbol(), T = class {
+	static [w] = !0;
+	get [C]() {
+		return !0;
+	}
+}, E = class extends T {
+	#e;
+	constructor(e, t) {
+		super(), this.#e = t;
+	}
+	getRoot() {
+		return this.#e;
+	}
+	isMounted() {
+		return this.#e.parentNode != null;
+	}
+	mount(e, t) {
+		G(e, this.#e, t);
+	}
+	unmount(e = !1) {
+		e || this.#e.parentNode?.removeChild(this.#e);
+	}
+	move(e, t) {
+		q(e, this.#e, t);
+	}
+};
+//#endregion
+//#region src/core/markup/scheduler.ts
+function D(e) {
+	e();
+}
+//#endregion
+//#region src/core/markup/nodes/dynamic.ts
+var O = class extends T {
+	#e = K("");
+	#t = [];
+	#n;
+	#r;
+	#i;
+	constructor(e, t) {
+		super(), this.#n = e, this.#r = t;
+	}
+	getRoot() {
+		return this.#e;
+	}
+	isMounted() {
+		return this.#e.parentNode != null;
+	}
+	mount(e, t) {
+		this.isMounted() || (G(e, this.#e, t), this.#i = s(this.#r, (e) => {
+			D(() => {
+				this.#o(e);
+			});
+		}));
+	}
+	unmount(e = !1) {
+		this.#i?.(), this.isMounted() && (e || this.#e.parentNode?.removeChild(this.#e), this.#a(e));
+	}
+	move(e, t) {
+		let n = t?.nextSibling ?? null;
+		if (e.moveBefore) try {
+			e.moveBefore(this.#e, n), n = this.#e.nextSibling;
+			for (let t = 0; t < this.#t.length; t++) {
+				let r = this.#t[t].getRoot();
+				r && e.moveBefore(r, n);
+			}
+			return;
+		} catch {}
+		e.insertBefore(this.#e, n), n = this.#e.nextSibling;
+		for (let t = 0; t < this.#t.length; t++) this.#t[t].move(e, this.#t[t - 1]?.getRoot() ?? this.#e);
+	}
+	#a(e) {
+		for (let t = 0; t < this.#t.length; t++) this.#t[t].unmount(e);
+		this.#t.length = 0;
+	}
+	#o(e) {
+		if (!this.isMounted()) return;
+		if ((typeof e == "string" || typeof e == "number") && this.#t.length === 1) {
+			let t = this.#t[0];
+			if (t instanceof E) {
+				let n = t.getRoot();
+				if (n && n.nodeType === Node.TEXT_NODE) {
+					n.nodeValue = String(e);
+					return;
+				}
+			}
+		}
+		if (this.#a(!1), e == null || e === !1) return;
+		let t = W(this.#n, e), n = this.#e.parentElement, r = this.#e;
+		for (let e = 0; e < t.length; e++) {
+			let i = t[e];
+			i.mount(n, r), this.#t.push(i);
+			let a = i.getRoot();
+			a && (r = a);
+		}
+	}
+}, k = Symbol("parentElement"), A = Symbol("debug"), j = Symbol("isSVG"), M = ["ref", "children"], N = class extends T {
+	#e;
+	#t;
+	#n;
+	#r = !1;
+	#i = [];
+	#a = /* @__PURE__ */ new Set();
+	#o;
+	constructor(e, t, n) {
+		if (super(), this.#t = n, this.#n = e, t === "svg" ? (this.#n = f(e), this.#n[j] = !0, this.#r = !0) : this.#n[j] && t === "foreignObject" && (this.#n = f(e), this.#n[j] = !1, this.#r = !1), this.#n[j] ? this.#e = document.createElementNS("http://www.w3.org/2000/svg", t) : this.#e = document.createElement(t), this.#n[A]) {
+			let e = this.#n[Y];
+			e && (this.#e.dataset.view = e.context.name);
+		}
+	}
+	getRoot() {
+		return this.#e;
+	}
+	isMounted() {
+		return this.#e.parentNode != null;
+	}
+	mount(e, t) {
+		let n = this.isMounted();
+		if (!n && (this.#c(this.#e, o(M, this.#t)), this.#t.children)) {
+			this.#i = W(this.#n, this.#t.children);
+			for (let e of this.#i) e.mount(this.#e);
+		}
+		let r = t?.nextSibling ?? null;
+		if ((this.#e.parentNode !== e || this.#e.nextSibling !== r) && G(e, this.#e, r), !n) {
+			if (l(this.#t.ref)) {
+				let e = this.#t.ref(this.#e);
+				l(e) && (this.#o = e);
+			}
+			this.#r && p(this.#n);
+		}
+	}
+	unmount(e = !1) {
+		!e && this.#e.parentNode && this.#e.parentNode.removeChild(this.#e);
+		for (let e of this.#i) e.unmount(!0);
+		this.#a.forEach((e) => e()), this.#a.clear(), this.#r && m(this.#n), this.#o &&= (this.#o(), void 0), this.#i.length = 0;
+	}
+	move(e, t) {
+		if (e.moveBefore) try {
+			e.moveBefore(this.#e, t?.nextSibling ?? null);
+			return;
+		} catch {}
+		this.mount(e, t);
+	}
+	#s(e, t) {
+		l(e) ? this.#a.add(s(e, (e) => {
+			D(() => t(e));
+		})) : t(e);
+	}
+	#c(e, t) {
+		for (let n in t) {
+			let r = t[n];
+			if (n === "style") this.#l(e, r);
+			else if (n === "class" || n === "className") this.#u(e, r);
+			else if (n === "for") this.#s(r, (t) => {
+				e.htmlFor = t;
+			});
+			else if (n[0] === "." || n.startsWith("prop:")) {
+				let t = n.substring(5);
+				this.#s(r, (n) => {
+					e[t] = n;
+				});
+			} else if (n[0] === ":" || n.startsWith("attr:")) {
+				let t = n.substring(5).toLowerCase();
+				this.#s(r, (n) => {
+					R(e, t, n);
+				});
+			} else if (n[0] === "@" && l(r)) {
+				let t = n.substring(1);
+				this.#a.add(J(e, t, r));
+			} else if (n.startsWith("on") && l(r)) {
+				let t = n.toLowerCase().slice(2);
+				this.#a.add(J(e, t, r));
+			} else n in e && !this.#n[j] ? typeof e[n] == "boolean" ? this.#s(r, (t) => {
+				let r = !!t;
+				e[n] = r, R(e, n, r);
+			}) : this.#s(r, (t) => {
+				e[n] = t;
+			}) : this.#s(r, (t) => {
+				R(e, n, t);
+			});
+		}
+	}
+	#l(e, t) {
+		let n = /* @__PURE__ */ new Set(), r = (t) => {
+			n.forEach((e) => {
+				e(), this.#a.delete(e);
+			}), n.clear(), e.style.cssText = "";
+			let r = F(t);
+			for (let [t, { value: i, priority: a }] of Object.entries(r)) if (l(i)) {
+				let r = s(i, (n) => {
+					n ? e.style.setProperty(t, L(n), a) : e.style.removeProperty(t);
+				});
+				this.#a.add(r), n.add(r);
+			} else i != null && e.style.setProperty(t, L(i), a);
+		};
+		l(t) ? this.#a.add(s(t, r)) : r(t);
+	}
+	#u(e, t) {
+		let n = /* @__PURE__ */ new Set(), r = (t) => {
+			n.forEach((e) => {
+				e(), this.#a.delete(e);
+			}), n.clear(), R(e, "class", null);
+			let r = P(t);
+			for (let [t, i] of Object.entries(r)) if (t !== "undefined") if (l(i)) {
+				let r = s(i, (n) => e.classList.toggle(t, !!n));
+				this.#a.add(r), n.add(r);
+			} else i && e.classList.add(t);
+		};
+		l(t) ? this.#a.add(s(t, r)) : r(t);
+	}
+};
+function P(e) {
+	return c(e) ? Object.fromEntries(e.split(" ").map((e) => [e, !0])) : a(e) ? Object.assign({}, ...e.filter(Boolean).map(P)) : r(e) ? e : {};
+}
+function F(e) {
+	return c(e) ? Object.fromEntries(e.split(";").filter((e) => e.trim()).map((e) => {
+		let [t, n] = e.split(":");
+		return [I(t.trim()), {
+			value: n.replace("!important", "").trim(),
+			priority: n.includes("!important") ? "important" : ""
+		}];
+	})) : a(e) ? Object.assign({}, ...e.filter(Boolean).map(F)) : r(e) ? Object.fromEntries(Object.entries(e).map(([e, t]) => [e.startsWith("--") ? e : I(e), { value: t }])) : {};
+}
+function I(e) {
+	return e.replace(/[A-Z]+(?![a-z])|[A-Z]/g, (e, t) => (t ? "-" : "") + e.toLowerCase());
+}
+function L(e) {
+	return n(e) ? `${e}px` : e;
+}
+function R(e, t, n) {
+	n ? e.setAttribute(t, String(n)) : e.removeAttribute(t);
+}
+//#endregion
+//#region src/core/markup/utils.ts
+function z(e, t) {
+	return {
+		[S]: !0,
+		type: e,
+		props: t
+	};
+}
+function B(e) {
+	return e && e[S];
+}
+function V(e) {
+	return e && e[C];
+}
+function H(e) {
+	return e && e[w];
+}
+function U(e, t = f()) {
+	let n = W(t, e);
+	return n.length === 1 ? n[0] : new O(t, () => n);
+}
+function W(e, ...t) {
+	let r = [];
+	function i(t) {
+		if (!(t == null || t === !1)) if (a(t)) for (let e = 0; e < t.length; e++) i(t[e]);
+		else if (c(t) || n(t)) r.push(new E(e, K(String(t))));
+		else if (B(t)) {
+			let { type: n, props: i } = t;
+			H(n) ? r.push(new n(e, ...i.args)) : l(n) ? r.push(new X(e, n, i)) : c(n) && r.push(new N(e, n, i));
+		} else V(t) ? r.push(t) : t instanceof Node ? r.push(new E(e, t)) : l(t) && r.push(new O(e, t));
+	}
+	for (let e = 0; e < t.length; e++) i(t[e]);
+	return r;
+}
+function G(e, t, n) {
+	n ? e.insertBefore(t, n?.nextSibling) : e.appendChild(t);
+}
+function K(e) {
+	return document.createTextNode(e);
+}
+function q(e, t, n) {
+	let r = n?.nextSibling ?? null;
+	if (e.moveBefore) try {
+		e.moveBefore(t, r);
+		return;
+	} catch {}
+	e.insertBefore(t, r);
+}
+function J(e, t, n) {
+	return e.addEventListener(t, n), () => e.removeEventListener(t, n);
+}
+//#endregion
+//#region src/core/markup/nodes/view.ts
+var Y = Symbol.for("ViewNode"), X = class extends T {
+	#e;
+	#t;
+	#n;
+	context;
+	constructor(e, t, n) {
+		super(), this.context = f(e), this.context[Y] = this, this.context.name = t.name, this.#e = n, this.#t = t;
+	}
+	getRoot() {
+		return this.#n?.getRoot();
+	}
+	isMounted() {
+		return this.context.isMounted;
+	}
+	mount(t, n) {
+		let r = this.isMounted();
+		if (!r) {
+			let t = e(() => this.#t.call(this.context, this.#e, this.context));
+			t != null && t !== !1 ? this.#n = U(t, this.context) : this.#n = new E(this.context, K(""));
+		}
+		this.#n.mount(t, n), r || p(this.context);
+	}
+	unmount(e = !1) {
+		this.#n?.unmount(e), m(this.context);
+	}
+	move(e, t) {
+		this.#n?.move(e, t);
+	}
+};
+//#endregion
+export { _, K as a, m as b, A as c, D as d, T as f, p as g, x as h, z as i, k as l, f as m, G as n, q as o, b as p, J as r, U as s, X as t, O as u, v, g as y };
+
+//# sourceMappingURL=view-cBN-hn_T.js.map