@manyducks.co/dolla 2.0.0-alpha.51 → 2.0.0-alpha.52

package/dist/typeChecking-EAVNeFyB.js

@@ -0,0 +1,75 @@
+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 m(r) {
+  return o(r) === "function";
+}
+function w(r) {
+  return typeof r == "number" && !isNaN(r);
+}
+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 b(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,
+  a as b,
+  m as c,
+  y as d,
+  p as e,
+  b as f,
+  c as g,
+  w as h,
+  f as i,
+  u as j,
+  o as t
+};
+//# sourceMappingURL=typeChecking-EAVNeFyB.js.map

package/dist/typeChecking-EAVNeFyB.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"typeChecking-EAVNeFyB.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","isNumber","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;AAgBO,SAASY,EAASZ,GAAiC;AACxD,SAAO,OAAOA,KAAU,YAAY,CAAC,MAAMA,CAAK;AAClD;AA0DO,SAASa,KAAwCC,GAAiB;AACjE,QAAAC,IAAcD,EAAK,CAAC,GACpBP,IAAeE,EAASK,EAAK,CAAC,CAAC,IACjCA,EAAK,CAAC,IACN,wBAAwBC,EAAY,IAAI,6BAEtCC,IAAO,CAAChB,MAA+B;AAC3C,QAAIA,aAAiBe;AACZ,aAAA;AAGT,UAAM,IAAI,UAAUP,EAAYR,GAAOO,CAAY,CAAC;AAAA,EACtD;AAEI,SAAAO,EAAK,SAAS,IACTE,IAEAA,EAAKF,EAAK,CAAC,CAAC;AAEvB;AAKO,SAASG,EAASjB,GAAoE;AAC3F,SAAOA,KAAS,QAAQ,OAAOA,KAAU,YAAY,CAACE,EAAQF,CAAK;AACrE;AAKgB,SAAAkB,EAAalB,GAAgBO,GAAwC;AAC/E,MAAAU,EAASjB,CAAK;AACT,WAAA;AAGT,QAAM,IAAI,UAAUQ,EAAYR,GAAOO,CAA6D,CAAC;AACvG;AAKA,SAASC,EAAYR,GAAgBmB,GAAiB;AApO/C,MAAAC;AAqOC,QAAAC,IAAWtB,EAAOC,CAAK,GAGvBsB,MAAcF,IAAApB,KAAA,gBAAAA,EAAO,aAAP,gBAAAoB,EAAA,KAAApB,OAAuB,OAAOA,CAAK;AAEvD,SAAOmB,EAAQ,WAAW,MAAME,CAAQ,EAAE,WAAW,MAAMC,CAAW;AACxE;"}

package/dist/types.d.ts

@@ -1,11 +1,19 @@
 import type * as CSS from "csstype";
 import type { Markup } from "./core/markup.js";
-import { Signal } from "./core/signals-api.js";
+import { Signal } from "./core/signals.js";
 /**
  * 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 | Signal<any> | (string | number | Markup | false | null | undefined | Signal<any>)[];
+export interface Mountable {
+    mount(parent: Node, after?: Node): void;
+    unmount(parentIsUnmounting?: boolean): void;
+}
+export interface AsyncMountable {
+    mount(parent: Node, after?: Node): Promise<void>;
+    unmount(parentIsUnmounting?: boolean): Promise<void>;
+}
 export type Stringable = {
     toString(): string;
 };