@manyducks.co/dolla 2.0.0-alpha.6 → 2.0.0-alpha.60

package/dist/typeChecking-CbltMOUt.js

@@ -0,0 +1,71 @@
+function o(r) {
+  const t = typeof r;
+  switch (t) {
+    case "undefined":
+      return t;
+    case "number":
+      return isNaN(r) ? "NaN" : t;
+    case "function":
+      return /^\s*class\s+/.test(r.toString()) ? "class" : t;
+    case "object":
+      return r === null ? "null" : r instanceof Promise ? "promise" : r instanceof Map ? "map" : r instanceof Set ? "set" : Array.isArray(r) ? "array" : t;
+    default:
+      return t;
+  }
+}
+function c(r) {
+  return Array.isArray(r);
+}
+function u(r, t) {
+  return c(t) && t.every((n) => r(n));
+}
+function y(r, t, n) {
+  if (u(r, t))
+    return !0;
+  throw new TypeError(i(t, n));
+}
+function f(r) {
+  return typeof r == "string";
+}
+function p(r, t) {
+  if (f(r))
+    return !0;
+  throw new TypeError(i(r, t ?? "Expected a string. Got type: %t, value: %v"));
+}
+function w(r) {
+  return o(r) === "function";
+}
+function A(...r) {
+  const t = r[0], n = f(r[2]) ? r[2] : `Expected instance of ${t.name}. Got type: %t, value: %v`, s = (e) => {
+    if (e instanceof t)
+      return !0;
+    throw new TypeError(i(e, n));
+  };
+  return r.length < 2 ? s : s(r[1]);
+}
+function a(r) {
+  return r != null && typeof r == "object" && !c(r);
+}
+function g(r, t) {
+  if (a(r))
+    return !0;
+  throw new TypeError(i(r, t));
+}
+function i(r, t) {
+  var e;
+  const n = o(r), s = ((e = r == null ? void 0 : r.toString) == null ? void 0 : e.call(r)) || String(r);
+  return t.replaceAll("%t", n).replaceAll("%v", s);
+}
+export {
+  A as a,
+  f as b,
+  w as c,
+  y as d,
+  p as e,
+  g as f,
+  c as g,
+  u as h,
+  a as i,
+  o as t
+};
+//# sourceMappingURL=typeChecking-CbltMOUt.js.map

package/dist/typeChecking-CbltMOUt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"typeChecking-CbltMOUt.js","sources":["../src/typeChecking.ts"],"sourcesContent":["type TypeNames =\n  // These values can be returned by `typeof`.\n  | \"string\"\n  | \"number\"\n  | \"bigint\"\n  | \"boolean\"\n  | \"symbol\"\n  | \"undefined\"\n  | \"object\"\n  | \"function\"\n  // These values are more specific ones that the `typeOf` function can return.\n  | \"null\"\n  | \"array\"\n  | \"class\"\n  | \"promise\"\n  | \"map\"\n  | \"set\"\n  | \"NaN\";\n\n/**\n * Extends `typeof` operator with more specific and useful type distinctions.\n */\nexport function typeOf(value: any): TypeNames {\n  const type = typeof value;\n  switch (type) {\n    case \"undefined\":\n      return type;\n    case \"number\":\n      if (isNaN(value as any)) return \"NaN\";\n      return type;\n    case \"function\":\n      if (/^\\s*class\\s+/.test(value.toString())) return \"class\";\n      return type;\n    case \"object\":\n      if (value === null) return \"null\";\n      if (value instanceof Promise) return \"promise\";\n      if (value instanceof Map) return \"map\";\n      if (value instanceof Set) return \"set\";\n      if (Array.isArray(value)) return \"array\";\n      return type;\n    default:\n      return type;\n  }\n}\n\n/**\n * Throws a TypeError unless `condition` is truthy.\n *\n * @param condition - Value whose truthiness is in question.\n * @param errorMessage - Optional message for the thrown TypeError.\n */\nexport function assert(condition: any, errorMessage?: string): void {\n  if (!condition) {\n    throw new TypeError(\n      formatError(condition, errorMessage || \"Failed assertion. Value is not truthy. Got type: %t, value: %v\"),\n    );\n  }\n}\n\n/**\n * Returns true if `value` is an array.\n */\nexport function isArray(value: unknown): value is Array<unknown> {\n  return Array.isArray(value);\n}\n\n/**\n * Throws an error if `value` is not an array.\n */\nexport function assertArray(value: unknown, errorMessage?: string): value is Array<unknown> {\n  if (isArray(value)) {\n    return true;\n  }\n\n  throw new TypeError(formatError(value, errorMessage || \"Expected array. Got type: %t, value: %v\"));\n}\n\n/**\n * Returns true when `value` is an array and `check` returns true for every item.\n *\n * @param check - Function to check items against.\n * @param value - A possible array.\n */\n\nexport function isArrayOf<T>(check: (item: unknown) => boolean, value: unknown): value is T[] {\n  return isArray(value) && value.every((item) => check(item));\n}\n\n/**\n * Throws a TypeError unless `value` is an array and `check` returns true for every item.\n *\n * @param check - Function to check items against.\n * @param value - A possible array.\n * @param errorMessage - A custom error message.\n */\nexport function assertArrayOf<T>(\n  check: (item: unknown) => boolean,\n  value: unknown,\n  errorMessage?: string,\n): value is T[] {\n  if (isArrayOf(check, value)) {\n    return true;\n  }\n\n  throw new TypeError(formatError(value, errorMessage ?? \"Expected an array of valid items. Got type: %t, value: %v\"));\n}\n\n/**\n * Returns true if `value` is a string.\n */\nexport function isString(value: unknown): value is string {\n  return typeof value === \"string\";\n}\n\n/**\n * Throws a TypeError unless `value` is a string.\n */\nexport function assertString(value: unknown, errorMessage?: string): value is string {\n  if (isString(value)) {\n    return true;\n  }\n\n  throw new TypeError(formatError(value, errorMessage ?? \"Expected a string. Got type: %t, value: %v\"));\n}\n\n// TODO: More specific validation for common types of strings? Email address, URL, UUID, etc?\n\n/**\n * Returns true if `value` is a function (but not a class).\n */\nexport function isFunction<T = (...args: unknown[]) => unknown>(value: unknown): value is T {\n  return typeOf(value) === \"function\";\n}\n\n/**\n * Throws a TypeError unless `value` is a function.\n */\nexport function assertFunction<T = (...args: unknown[]) => unknown>(value: unknown, errorMessage?: string): value is T {\n  if (isFunction(value)) {\n    return true;\n  }\n\n  throw new TypeError(formatError(value, errorMessage ?? \"Expected a function. Got type: %t, value: %v\"));\n}\n\n/**\n * Returns true if `value` is a number.\n */\nexport function isNumber(value: unknown): value is number {\n  return typeof value === \"number\" && !isNaN(value);\n}\n\n/**\n * Throws a TypeError unless `value` is a number.\n */\nexport function assertNumber(value: unknown, errorMessage?: string): value is number {\n  if (isNumber(value)) {\n    return true;\n  }\n\n  throw new TypeError(formatError(value, errorMessage ?? \"Expected a number. Got type: %t, value: %v\"));\n}\n\n/**\n * Returns a function that takes a `value` and returns true if `value` is an instance of `constructor`.\n *\n * @param constructor - The constructor a value must be an instance of to match.\n */\nexport function isInstanceOf<T extends Function>(constructor: T): (value: unknown) => value is T;\n\n/**\n * Returns `true` if `value` is an instance of `constructor`.\n *\n * @param constructor - The constructor `value` must be an instance of.\n * @param value - A value that may be an instance of `constructor`.\n */\nexport function isInstanceOf<T extends Function>(constructor: T, value: unknown): value is T;\n\nexport function isInstanceOf<T extends Function>(...args: unknown[]) {\n  const constructor = args[0] as T;\n\n  const test = (value: unknown): value is T => {\n    return value instanceof constructor;\n  };\n\n  if (args.length < 2) {\n    return test;\n  } else {\n    return test(args[1]);\n  }\n}\n\n/**\n * Returns a function that takes a `value` and throws a TypeError unless `value` is an instance of `constructor`.\n *\n * @param constructor - The constructor a value must be an instance of to match.\n */\nexport function assertInstanceOf<T extends Function>(constructor: T): (value: unknown) => value is T;\n\n/**\n * Throws a TypeError unless `value` is an instance of `constructor`.\n *\n * @param constructor - The constructor `value` must be an instance of.\n * @param value - A value that may be an instance of `constructor`.\n * @param errorMessage - A custom error message for when the assertion fails.\n */\nexport function assertInstanceOf<T extends Function>(constructor: T, value: unknown, errorMessage?: string): value is T;\n\nexport function assertInstanceOf<T extends Function>(...args: unknown[]) {\n  const constructor = args[0] as T;\n  const errorMessage = isString(args[2])\n    ? args[2]\n    : `Expected instance of ${constructor.name}. Got type: %t, value: %v`;\n\n  const test = (value: unknown): value is T => {\n    if (value instanceof constructor) {\n      return true;\n    }\n\n    throw new TypeError(formatError(value, errorMessage));\n  };\n\n  if (args.length < 2) {\n    return test;\n  } else {\n    return test(args[1]);\n  }\n}\n\n/**\n * Returns true if `value` is a plain JavaScript object.\n */\nexport function isObject(value: unknown): value is Record<string | number | symbol, unknown> {\n  return value != null && typeof value === \"object\" && !isArray(value);\n}\n\n/**\n * Throws a TypeError unless `value` is a plain JavaScript object.\n */\nexport function assertObject(value: unknown, errorMessage?: string): value is object {\n  if (isObject(value)) {\n    return true;\n  }\n\n  throw new TypeError(formatError(value, errorMessage ?? \"Expected an object. Got type: %t, value: %v\"));\n}\n\n/**\n * Replaces `%t` and `%v` placeholders in a message with real values.\n */\nfunction formatError(value: unknown, message: string) {\n  const typeName = typeOf(value);\n\n  // TODO: Pretty format value as string based on type.\n  const valueString = value?.toString?.() || String(value);\n\n  return message.replaceAll(\"%t\", typeName).replaceAll(\"%v\", valueString);\n}\n"],"names":["typeOf","value","type","isArray","isArrayOf","check","item","assertArrayOf","errorMessage","formatError","isString","assertString","isFunction","assertInstanceOf","args","constructor","test","isObject","assertObject","message","_a","typeName","valueString"],"mappings":"AAsBO,SAASA,EAAOC,GAAuB;AAC5C,QAAMC,IAAO,OAAOD;AACpB,UAAQC,GAAM;AAAA,IACZ,KAAK;AACI,aAAAA;AAAA,IACT,KAAK;AACC,aAAA,MAAMD,CAAY,IAAU,QACzBC;AAAA,IACT,KAAK;AACH,aAAI,eAAe,KAAKD,EAAM,SAAU,CAAA,IAAU,UAC3CC;AAAA,IACT,KAAK;AACC,aAAAD,MAAU,OAAa,SACvBA,aAAiB,UAAgB,YACjCA,aAAiB,MAAY,QAC7BA,aAAiB,MAAY,QAC7B,MAAM,QAAQA,CAAK,IAAU,UAC1BC;AAAA,IACT;AACS,aAAAA;AAAA,EAAA;AAEb;AAmBO,SAASC,EAAQF,GAAyC;AACxD,SAAA,MAAM,QAAQA,CAAK;AAC5B;AAoBgB,SAAAG,EAAaC,GAAmCJ,GAA8B;AACrF,SAAAE,EAAQF,CAAK,KAAKA,EAAM,MAAM,CAACK,MAASD,EAAMC,CAAI,CAAC;AAC5D;AASgB,SAAAC,EACdF,GACAJ,GACAO,GACc;AACV,MAAAJ,EAAUC,GAAOJ,CAAK;AACjB,WAAA;AAGT,QAAM,IAAI,UAAUQ,EAAYR,GAAOO,CAA2E,CAAC;AACrH;AAKO,SAASE,EAAST,GAAiC;AACxD,SAAO,OAAOA,KAAU;AAC1B;AAKgB,SAAAU,EAAaV,GAAgBO,GAAwC;AAC/E,MAAAE,EAAST,CAAK;AACT,WAAA;AAGT,QAAM,IAAI,UAAUQ,EAAYR,GAAOO,KAAgB,4CAA4C,CAAC;AACtG;AAOO,SAASI,EAAgDX,GAA4B;AACnF,SAAAD,EAAOC,CAAK,MAAM;AAC3B;AA4EO,SAASY,KAAwCC,GAAiB;AACjE,QAAAC,IAAcD,EAAK,CAAC,GACpBN,IAAeE,EAASI,EAAK,CAAC,CAAC,IACjCA,EAAK,CAAC,IACN,wBAAwBC,EAAY,IAAI,6BAEtCC,IAAO,CAACf,MAA+B;AAC3C,QAAIA,aAAiBc;AACZ,aAAA;AAGT,UAAM,IAAI,UAAUN,EAAYR,GAAOO,CAAY,CAAC;AAAA,EACtD;AAEI,SAAAM,EAAK,SAAS,IACTE,IAEAA,EAAKF,EAAK,CAAC,CAAC;AAEvB;AAKO,SAASG,EAAShB,GAAoE;AAC3F,SAAOA,KAAS,QAAQ,OAAOA,KAAU,YAAY,CAACE,EAAQF,CAAK;AACrE;AAKgB,SAAAiB,EAAajB,GAAgBO,GAAwC;AAC/E,MAAAS,EAAShB,CAAK;AACT,WAAA;AAGT,QAAM,IAAI,UAAUQ,EAAYR,GAAOO,CAA6D,CAAC;AACvG;AAKA,SAASC,EAAYR,GAAgBkB,GAAiB;AApO/C,MAAAC;AAqOC,QAAAC,IAAWrB,EAAOC,CAAK,GAGvBqB,MAAcF,IAAAnB,KAAA,gBAAAA,EAAO,aAAP,gBAAAmB,EAAA,KAAAnB,OAAuB,OAAOA,CAAK;AAEvD,SAAOkB,EAAQ,WAAW,MAAME,CAAQ,EAAE,WAAW,MAAMC,CAAW;AACxE;"}

package/dist/typeChecking.d.ts

@@ -1,8 +1,8 @@
-type TypeNames = "string" | "number" | "bigint" | "boolean" | "symbol" | "undefined" | "object" | "function" | "null" | "array" | "class" | "promise" | "NaN";
+type TypeNames = "string" | "number" | "bigint" | "boolean" | "symbol" | "undefined" | "object" | "function" | "null" | "array" | "class" | "promise" | "map" | "set" | "NaN";
 /**
  * Extends `typeof` operator with more specific and useful type distinctions.
  */
-export declare function typeOf(value: unknown): TypeNames;
+export declare function typeOf(value: any): TypeNames;
 /**
  * Throws a TypeError unless `condition` is truthy.
  *
@@ -18,12 +18,6 @@ export declare function isArray(value: unknown): value is Array<unknown>;
  * Throws an error if `value` is not an array.
  */
 export declare function assertArray(value: unknown, errorMessage?: string): value is Array<unknown>;
-/**
- * Returns a function that takes a `value` and ensures that it is an array for which `check` returns true for every item.
- *
- * @param check - Function to check items against.
- */
-export declare function isArrayOf<T>(check: (item: unknown) => boolean): (value: unknown) => value is T[];
 /**
  * Returns true when `value` is an array and `check` returns true for every item.
  *
@@ -31,12 +25,6 @@ export declare function isArrayOf<T>(check: (item: unknown) => boolean): (value:
  * @param value - A possible array.
  */
 export declare function isArrayOf<T>(check: (item: unknown) => boolean, value: unknown): value is T[];
-/**
- * Returns a function that takes a `value` and throws a TypeError unless it is an array for which `check` returns true for every item.
- *
- * @param check - Function to check items against.
- */
-export declare function assertArrayOf<T>(check: (item: unknown) => boolean): (value: unknown) => value is T[];
 /**
  * Throws a TypeError unless `value` is an array and `check` returns true for every item.
  *
@@ -45,14 +33,6 @@ export declare function assertArrayOf<T>(check: (item: unknown) => boolean): (va
  * @param errorMessage - A custom error message.
  */
 export declare function assertArrayOf<T>(check: (item: unknown) => boolean, value: unknown, errorMessage?: string): value is T[];
-/**
- * Returns true if `value` is equal to `true` or `false`.
- */
-export declare function isBoolean(value: unknown): value is boolean;
-/**
- * Throws a TypeError unless `value` is equal to `true` or `false`.
- */
-export declare function assertBoolean(value: unknown, errorMessage?: string): value is boolean;
 /**
  * Returns true if `value` is a string.
  */
@@ -77,34 +57,6 @@ export declare function isNumber(value: unknown): value is number;
  * Throws a TypeError unless `value` is a number.
  */
 export declare function assertNumber(value: unknown, errorMessage?: string): value is number;
-/**
- * Returns true if `value` implements the Promise protocol.
- * This matches true instances of Promise as well as any object that
- * implements `next`, `catch` and `finally` methods.
- *
- * To strictly match instances of Promise, use `isInstanceOf(Promise)`.
- */
-export declare function isPromise<T = unknown>(value: unknown): value is Promise<T>;
-/**
- * Throws a TypeError unless `value` implements the Promise protocol.
- * This matches true instances of Promise as well as any object that
- * implements `next`, `catch` and `finally` methods.
- *
- * To strictly allow only instances of Promise, use `Type.assertInstanceOf(Promise)`.
- */
-export declare function assertPromise<T = unknown>(value: unknown, errorMessage?: string): value is Promise<T>;
-/**
- * Returns true if `value` is a class.
- */
-export declare function isClass(value: unknown): value is {
-    new (): unknown;
-};
-/**
- * Throws a TypeError unless `value` is a class.
- */
-export declare function assertClass(value: unknown, errorMessage?: string): value is {
-    new (): unknown;
-};
 /**
  * Returns a function that takes a `value` and returns true if `value` is an instance of `constructor`.
  *
@@ -132,30 +84,6 @@ export declare function assertInstanceOf<T extends Function>(constructor: T): (v
  * @param errorMessage - A custom error message for when the assertion fails.
  */
 export declare function assertInstanceOf<T extends Function>(constructor: T, value: unknown, errorMessage?: string): value is T;
-/**
- * Returns true if `value` is a Map.
- */
-export declare function isMap<K = unknown, V = unknown>(value: any): value is Map<K, V>;
-/**
- * Throws a TypeError unless `value` is a Map.
- */
-export declare function assertMap<K = unknown, V = unknown>(value: any, errorMessage?: string): value is Map<K, V>;
-/**
- * Returns true if `value` is a Set.
- */
-export declare function isSet<T = unknown>(value: any): value is Set<T>;
-/**
- * Throws a TypeError if `value` is not a Set.
- */
-export declare function assertSet<T = unknown>(value: any, errorMessage?: string): value is Set<T>;
-/**
- * Returns true if `value` implements the Iterable protocol.
- */
-export declare function isIterable<T>(value: any): value is Iterable<T>;
-/**
- * Throws a TypeError unless `value` implements the Iterable protocol.
- */
-export declare function assertIterable<T>(value: any, errorMessage?: string): value is Iterable<T>;
 /**
  * Returns true if `value` is a plain JavaScript object.
  */
@@ -164,28 +92,4 @@ export declare function isObject(value: unknown): value is Record<string | numbe
  * Throws a TypeError unless `value` is a plain JavaScript object.
  */
 export declare function assertObject(value: unknown, errorMessage?: string): value is object;
-/**
- * Returns true if `value` is equal to `null`.
- */
-export declare function isNull(value: unknown): value is null;
-/**
- * Throws a TypeError unless `value` is equal to `null`.
- */
-export declare function assertNull(value: unknown, errorMessage?: string): value is null;
-/**
- * Returns true if `value` is equal to `undefined`.
- */
-export declare function isUndefined(value: unknown): value is undefined;
-/**
- * Throws a TypeError unless `value` is equal to `undefined`.
- */
-export declare function assertUndefined(value: unknown, errorMessage?: string): value is undefined;
-/**
- * Returns true if `value` is equal to `null` or `undefined`.
- */
-export declare function isEmpty(value: unknown): value is void;
-/**
- * Throws a TypeError unless `value` is equal to `null` or `undefined`.
- */
-export declare function assertEmpty(value: unknown, errorMessage?: string): value is void;
 export {};

package/dist/typeChecking.test.d.ts

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

package/dist/types.d.ts

@@ -1,17 +1,31 @@
 import type * as CSS from "csstype";
-import { Ref, type Markup } from "./markup.js";
-import { SettableState, State } from "./state.js";
+import type { Markup, MarkupNode } from "./core/markup.js";
+import type { Signal } from "./core/signals.js";
+import type { Context } from "./core/context.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 | Markup | false | null | undefined | State<any> | (string | number | Markup | false | null | undefined | State<any>)[];
-export type Stringable = {
-    toString(): string;
-};
-type MaybeState<T> = T | State<T> | State<T | undefined>;
-type OptionalProperty<T> = T | State<T> | State<T | undefined>;
-type RequiredProperty<T> = T | State<T>;
+export type Renderable = string | number | Node | Markup | MarkupNode | false | null | undefined | Signal<any> | (string | number | Node | Markup | MarkupNode | false | null | undefined | Signal<any>)[];
+export interface BaseProps {
+    children?: Renderable;
+}
+/**
+ *
+ */
+export type View<P> = (this: Context, props: P, context: Context) => Renderable;
+/**
+ *
+ */
+export type Store<Options, Value> = (this: Context, options: Options, context: Context) => Value;
+/**
+ *
+ */
+export type Mixin<E extends Element = Element> = (element: E, context: Context) => void;
+type MaybeSignal<T> = T | Signal<T> | Signal<T | undefined>;
+type OptionalProperty<T> = MaybeSignal<T>;
+type RequiredProperty<T> = T | Signal<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)[]>;
@@ -23,21 +37,31 @@ type InputModeValues = "decimal" | "email" | "none" | "numeric" | "search" | "te
  * Properties common to all Elements.
  */
 export interface ElementProps {
+    /**
+     * Sets the value as an HTML attribute.
+     */
+    [key: `attr:${string}`]: OptionalProperty<any>;
+    /**
+     * Sets the value directly on the HTMLElement as a property.
+     */
+    [key: `prop:${string}`]: OptionalProperty<any>;
+    /**
+     * Attaches an event listener to the element (with `addEventListener`).
+     */
+    [key: `on:${string}`]: OptionalProperty<EventHandler<Event>>;
     /**
      * HTML attributes to assign to the element.
      */
-    attributes?: OptionalProperty<Record<string, any>>;
     /**
      * Object of event listeners.
      */
-    eventListeners?: OptionalProperty<Record<string, EventHandler<Event>>>;
     /**
      * 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.
      * Class names in a class map will be applied to the element while their values are true. Also supports an
      * array of strings and class maps.
      *
-     * Alias of `className`.
+     * @alias className
      *
      * @example
      * <div class="one-class" />
@@ -57,6 +81,8 @@ export interface ElementProps {
      * Class names in a class map will be applied to the element while their values are true. Also supports an
      * array of strings and class maps.
      *
+     * @alias class
+     *
      * @example
      * <div className="one-class" />
      *
@@ -71,22 +97,39 @@ export interface ElementProps {
     className?: OptionalProperty<ClassListValues>;
     /**
      * A unique string to identify this element.
+     *
+     * @see https://developer.mozilla.org/en-US/docs/Web/API/Element/id
      */
     id?: OptionalProperty<string>;
+    /**
+     * Renders a string of HTML as the children of this element.
+     * Equivalent to setting `innerHTML` on a DOM element.
+     *
+     * `NOTE` This property does no sanitization. If it's in the string, it's in the DOM. Be mindful when handling user-generated content.
+     */
+    innerHTML?: OptionalProperty<string>;
+    /**
+     * @see https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Global_attributes/popover
+     */
+    popover?: OptionalProperty<"auto" | "hint" | "manual" | true | false>;
+    /**
+     * Specifies the element's [WAI-ARIA role](https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Reference/Roles).
+     *
+     * @see https://developer.mozilla.org/en-US/docs/Web/API/Element/role
+     */
+    role?: OptionalProperty<string>;
     /**
      * Scroll position from the left (on the X axis), if this element is scrollable.
+     *
+     * @see https://developer.mozilla.org/en-US/docs/Web/API/Element/scrollLeft
      */
     scrollLeft?: OptionalProperty<number>;
     /**
      * Scroll position from the top (on the Y axis) if this element is scrollable.
-     */
-    scrollTop?: OptionalProperty<number>;
-    /**
-     * Enables or disables checking for spelling errors in an element's content.
      *
-     * @see https://developer.mozilla.org/en-US/docs/Web/HTML/Global_attributes/spellcheck
+     * @see https://developer.mozilla.org/en-US/docs/Web/API/Element/scrollTop
      */
-    spellcheck?: OptionalProperty<boolean>;
+    scrollTop?: OptionalProperty<number>;
     /**
      * Specifies whether an element's content should be translated when the page is localized.
      *
@@ -105,12 +148,18 @@ export interface ElementProps {
      * @see https://developer.mozilla.org/en-US/docs/Web/HTML/Global_attributes/slot
      */
     slot?: OptionalProperty<string>;
+    /**
+     * Enables or disables checking for spelling errors in an element's content.
+     *
+     * @see https://developer.mozilla.org/en-US/docs/Web/HTML/Global_attributes/spellcheck
+     */
+    spellCheck?: OptionalProperty<boolean>;
     /**
      * Inline styles applied to the element. Can be passed as a string or as an object.
      *
      * @see https://developer.mozilla.org/en-US/docs/Web/HTML/Global_attributes/style
      */
-    style?: string | CSSProperties | State<string> | State<CSSProperties> | State<string | CSSProperties> | State<string | undefined> | State<CSSProperties | undefined> | State<string | CSSProperties | undefined>;
+    style?: string | CSSProperties | Signal<string> | Signal<CSSProperties> | Signal<string | CSSProperties> | Signal<string | undefined> | Signal<CSSProperties | undefined> | Signal<string | CSSProperties | undefined>;
     /**
      * Fired when a CSS animation unexpectedly aborts.
      *
@@ -178,6 +227,12 @@ export interface ElementProps {
      * @see https://developer.mozilla.org/en-US/docs/Web/API/Element/compositionupdate_event
      */
     onCompositionUpdate?: OptionalProperty<EventHandler<CompositionEvent>>;
+    /**
+     * Fired when the user attempts to open a context menu. Typically triggered by clicking the right mouse button.
+     *
+     * @see https://developer.mozilla.org/en-US/docs/Web/API/Element/contextmenu_event
+     */
+    onContextMenu?: OptionalProperty<EventHandler<PointerEvent>>;
     /**
      * Fired when a pointing device button is rapidly clicked twice while the pointer is inside the element.
      *
@@ -452,6 +507,12 @@ export interface ElementProps {
      * @see https://developer.mozilla.org/en-US/docs/Web/API/Element/compositionupdate_event
      */
     oncompositionupdate?: OptionalProperty<EventHandler<CompositionEvent>>;
+    /**
+     * Fired when the user attempts to open a context menu. Typically triggered by clicking the right mouse button.
+     *
+     * @see https://developer.mozilla.org/en-US/docs/Web/API/Element/contextmenu_event
+     */
+    oncontextmenu?: OptionalProperty<EventHandler<PointerEvent>>;
     /**
      * Fired when a pointing device button is rapidly clicked twice while the pointer is inside the element.
      *
@@ -683,6 +744,12 @@ export interface HTMLElementProps extends ElementProps {
      * @see https://developer.mozilla.org/en-US/docs/Web/API/HTMLElement/contentEditable
      */
     contentEditable?: OptionalProperty<ContentEditableValues>;
+    /**
+     * Stores values on the element as attributes prefixed with `data-`.
+     *
+     * @see https://developer.mozilla.org/en-US/docs/Web/API/HTMLElement/dataset
+     */
+    dataset?: OptionalProperty<Record<string, string>>;
     /**
      * Specifies text directionality of the content of this element. Some languages, such as Arabic, are written from right to left (specified here as "rtl").
      *
@@ -729,7 +796,6 @@ export interface HTMLElementProps extends ElementProps {
     /**
      * TODO: Add support. Currently experimental.
      */
-    role?: OptionalProperty<string>;
     /**
      * This element's position in the tab order, or the order this element will be focused as the user cycles through elements with the tab key.
      *
@@ -938,6 +1004,10 @@ 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.
@@ -1210,7 +1280,7 @@ export type CSSProperties = {
     [K in keyof Styles]: OptionalProperty<Styles[K]>;
 };
 export interface ClassMap {
-    [className: string]: MaybeState<any>;
+    [className: string]: MaybeSignal<any>;
 }
 export type EventHandler<E> = (event: E) => void;
 export interface PropertiesOf<E extends HTMLElement> extends HTMLElementProps {
@@ -1221,7 +1291,11 @@ export interface PropertiesOf<E extends HTMLElement> extends HTMLElementProps {
     /**
      * Receives a reference to the DOM node when rendered.
      */
-    ref?: Ref<E> | Ref<HTMLElement> | Ref<Element> | Ref<Node>;
+    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>[];
 }
 /**
  * The following elements are defined based on the WHATWG HTML spec:
@@ -2098,7 +2172,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 | State<MediaStream> | State<MediaStream | undefined> | State<MediaSource> | State<MediaSource | undefined> | State<Blob> | State<Blob | undefined> | State<File> | State<File | undefined>;
+    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>;
     /**
      * The current audio volume of the media element. Must be a number between 0 and 1.
      *
@@ -2597,7 +2671,7 @@ interface HTMLImageElementProps extends PropertiesOf<HTMLImageElement> {
      *
      * @see https://developer.mozilla.org/en-US/docs/Web/API/HTMLImageElement/sizes
      */
-    sizes?: MaybeState<string>;
+    sizes?: MaybeSignal<string>;
     /**
      * The image URL.
      *
@@ -3143,7 +3217,6 @@ interface HTMLInputElementProps extends PropertiesOf<HTMLInputElement> {
     step?: OptionalProperty<number>;
     type?: OptionalProperty<InputType>;
     value?: OptionalProperty<string>;
-    $$value?: SettableState<any>;
     width?: OptionalProperty<string | number> | OptionalProperty<string> | OptionalProperty<number>;
     title?: OptionalProperty<string>;
     /**

package/dist/utils.d.ts

@@ -1,5 +1,18 @@
 export declare const noOp: () => void;
-export declare function deepEqual(one: any, two: any): boolean;
+export declare function getUniqueId(): string;
+/**
+ * Equality check that passes if both values are the same object.
+ * This is the default equality check for states.
+ */
+export declare function strictEqual(a: any, b: any): boolean;
+/**
+ * Equality check that passes if both values are the same object, or if both are objects or arrays with equal keys and values.
+ */
+export declare function shallowEqual(a: any, b: any): boolean;
+/**
+ * Equality check that passes if two objects have equal values, even if they are not the same object.
+ */
+export declare function deepEqual(a: any, b: any): boolean;
 /**
  * Takes an old value and a new value.  Returns a merged copy if both are objects, otherwise returns the new value.
  */
@@ -13,8 +26,12 @@ export declare function merge(one: unknown, two: unknown): any;
  * @param object - An object to clone without the omitted keys.
  */
 export declare function omit<O extends Record<any, any>>(keys: (keyof O)[], object: O): Record<any, any>;
-export declare function getDefaultConsole(): any;
-export declare function colorFromString(value: string): string;
+export declare function toArray<T>(value: T | T[]): T[];
+export declare function toCamelCase(s: string): string;
+/**
+ * Takes any string and returns an OKLCH color.
+ */
+export declare function okhash(value: string): string;
 export type MatcherFunction = (value: string) => boolean;
 /**
  * Parses a filter string into a matcher function.

package/docs/http.md

@@ -0,0 +1,29 @@
+# HTTP Client
+
+> TODO: Write me.
+
+This page goes into detail on how to use the built in HTTP client.
+
+```js
+import { http } from "@manyducks.co/dolla";
+
+http.use(async (req, next) => {
+  // Apply auth header to all API routes.
+  if (req.url.pathname.startsWith("/api/")) {
+    req.headers.set("authorization", `Bearer ${localStorage.getItem("api-key")}`);
+  }
+
+  await next();
+});
+
+const res = await http.get("/api/some-api-route");
+res.body; // body is already parsed as JSON if server responded with JSON
+```
+
+---
+
+End.
+
+- [🗂️ Docs](./index.md)
+- [🏠 README](../README.md)
+- [🦆 That's a lot of ducks.](https://www.manyducks.co)

package/docs/i18n.md

@@ -0,0 +1,43 @@
+# Internationalization (i18n) Support
+
+```jsx
+import { $, mount } from "@manyducks.co/dolla";
+import { i18n, t } from "@manyducks.co/dolla/i18n";
+
+
+function CounterView(props) {
+  const $count = $(0);
+
+  const increment = () => {
+    $count(count => count + 1);
+  };
+
+  return (
+    <div>
+      <p>Clicks: {$count}</p>
+      <button onClick={increment}>{t("buttonLabel")}</button>
+    </div>
+  );
+});
+
+// Await i18n setup before mounting the app to make sure translations are loaded.
+i18n
+  .setup({
+    locale: "en",
+    translations: [
+      { locale: "en", strings: { buttonLabel: "Click here to increment" } },
+      { locale: "ja", strings: { buttonLabel: "ここに押して増加する" } },
+    ],
+  })
+  .then(() => {
+    return mount(document.body, CounterView);
+  });
+```
+
+---
+
+End.
+
+- [🗂️ Docs](./index.md)
+- [🏠 README](../README.md)
+- [🦆 That's a lot of ducks.](https://www.manyducks.co)

package/docs/index.md

@@ -0,0 +1,10 @@
+# Dolla Docs
+
+> Write table of contents (see files in this folder in the meantime)
+
+---
+
+End.
+
+- [🏠 README](../README.md)
+- [🦆 That's a lot of ducks.](https://www.manyducks.co)

package/docs/markup.md

@@ -0,0 +1,16 @@
+# Markup
+
+Dolla creates a tree of views that manage the DOM, updating attributes and recreating parts of the DOM as signal values change.
+
+```js
+import { $, m, render } from "@manyducks.co/dolla";
+
+const $count = $(0);
+const labelMarkup = m("span", { children: $count });
+// or in JSX:
+const labelMarkup = <span>{$count}</span>;
+
+const rendered = render(labelMarkup);
+
+rendered.mount(document.body);
+```

package/docs/mixins.md

@@ -0,0 +1,32 @@
+# Mixins
+
+Mixins are a way to add custom lifecycle handlers to plain DOM nodes without creating an entire view. You can encapsulate reusable logic in mixin functions and apply them like CSS classes.
+
+Mixin functions take a reference to the element and a `MixinContext` object which adds lifecycle hooks similar to those of `ViewContext`.
+
+```tsx
+import { type Mixin } from "@manyducks.co/dolla";
+
+const logMe: Mixin = (element, ctx) => {
+  ctx.onMount(() => {
+    ctx.log("element mounted");
+  });
+  ctx.onUnmount(() => {
+    ctx.log("element unmounted");
+  });
+};
+
+// Pass one mixin
+<h1 mixin={logMe}>Title</h1>;
+
+// Or an array of mixins
+<p mixin={[logMe, anotherMixin, yetAnotherMixin]}>Text goes here...</p>;
+```
+
+---
+
+End.
+
+- [🗂️ Docs](./index.md)
+- [🏠 README](../README.md)
+- [🦆 That's a lot of ducks.](https://www.manyducks.co)