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

package/dist/core/index.d.ts

@@ -1,8 +1,10 @@
 export { $, effect, get, peek } from "./signals.js";
 export type { MaybeSignal, Signal, Source } from "./signals.js";
+export { ref, type Ref } from "./ref.js";
 export { constructView } from "./nodes/view.js";
 export { deepEqual, shallowEqual, strictEqual } from "../utils.js";
 export { Stores, type StoreContext, type StoreFunction } from "./store.js";
+export { type Mixin, type MixinContext } from "./mixin.js";
 export { markup, portal, repeat, unless, when, constructMarkup } from "./markup.js";
 export type { Markup, MarkupElement } from "./markup.js";
 export { getEnv, setEnv } from "./env.js";

package/dist/core/logger.d.ts

@@ -15,9 +15,13 @@ export interface Logger {
 }
 export interface LoggerOptions {
     /**
-     * Unique ID to print with logs. Makes it easier to track down messages from specific view instances.
+     * Tag value to print with logs.
      */
-    uid?: string;
+    tag?: string;
+    /**
+     * Label for tag value. Will be printed without a label if not specified.
+     */
+    tagName?: string;
     /**
      * Console object to use for logging (mostly for testing). Uses window.console by default.
      */
@@ -26,7 +30,8 @@ export interface LoggerOptions {
 export interface LoggerErrorContext {
     error: Error;
     loggerName: string;
-    uid?: string;
+    tag?: string;
+    tagName?: string;
 }
 export declare function onLoggerCrash(listener: (context: LoggerErrorContext) => void): () => void;
 export declare function createLogger(name: MaybeSignal<string>, options?: LoggerOptions): Logger;

package/dist/core/mixin.d.ts

@@ -0,0 +1,62 @@
+import type { StoreConsumerContext } from "./context";
+import { type Logger } from "./logger";
+import type { HTML } from "./nodes/html";
+import { type EffectFn, type UnsubscribeFn } from "./signals";
+import { StoreFunction } from "./store";
+export interface MixinContext extends Logger, StoreConsumerContext {
+    /**
+     * An ID unique to this element.
+     */
+    readonly uid: string;
+    /**
+     * True while this element is connected to the DOM.
+     */
+    readonly isMounted: boolean;
+    /**
+     * Registers a callback to run just before this element is mounted. DOM nodes are not yet attached to the page.
+     */
+    beforeMount(callback: () => void): void;
+    /**
+     * Registers a callback to run just after this element is mounted.
+     */
+    onMount(callback: () => void): void;
+    /**
+     * Registers a callback to run just before this element is unmounted. DOM nodes are still attached to the page.
+     */
+    beforeUnmount(callback: () => void): void;
+    /**
+     * Registers a callback to run just after this element is unmounted.
+     */
+    onUnmount(callback: () => void): void;
+    /**
+     * Passes a getter function to `callback` that will track reactive states and return their current values.
+     * Callback will be run each time a tracked state gets a new value.
+     */
+    effect(callback: EffectFn): UnsubscribeFn;
+}
+export type Mixin<E extends Element = Element> = (element: E, context: MixinContext) => void;
+interface Context extends Logger {
+}
+declare class Context implements MixinContext {
+    private html;
+    private controller;
+    constructor(html: HTML, controller: MixinController);
+    readonly uid: string;
+    get isMounted(): boolean;
+    get<Value>(store: StoreFunction<any, Value>): Value;
+    beforeMount(callback: () => void): void;
+    onMount(callback: () => void): void;
+    beforeUnmount(callback: () => void): void;
+    onUnmount(callback: () => void): void;
+    effect(callback: EffectFn): UnsubscribeFn;
+}
+export declare class MixinController {
+    context: Context;
+    lifecycleListeners: Record<string, (() => void)[]>;
+    constructor(html: HTML, mixins: Mixin[]);
+    beforeMount(): void;
+    onMount(): void;
+    beforeUnmount(): void;
+    onUnmount(): void;
+}
+export {};

package/dist/core/nodes/html.d.ts

@@ -9,12 +9,13 @@ type HTMLOptions = {
 };
 export declare class HTML implements MarkupElement {
     [IS_MARKUP_ELEMENT]: boolean;
-    domNode: HTMLElement | SVGElement;
+    domNode: SVGElement | HTMLElement;
+    elementContext: ElementContext;
     private props;
     private childMarkup;
     private children;
     private unsubscribers;
-    private elementContext;
+    private mixin?;
     private logger;
     private ref?;
     private canClickAway;

package/dist/core/nodes/view.d.ts

@@ -16,7 +16,7 @@ export type ViewFunction<P> = (this: ViewContext, props: P, context: ViewContext
 export interface ViewElement extends MarkupElement {
     setRouteView(view: ViewFunction<{}>): ViewElement;
 }
-export interface ViewContext extends Omit<Logger, "setName">, ComponentContext, StoreProviderContext, StoreConsumerContext {
+export interface ViewContext extends Logger, ComponentContext, StoreProviderContext, StoreConsumerContext {
     /**
      * An ID unique to this view.
      */
@@ -51,7 +51,7 @@ export interface ViewContext extends Omit<Logger, "setName">, ComponentContext,
      */
     outlet(): Markup;
 }
-interface Context extends Omit<Logger, "setName"> {
+interface Context extends Logger {
 }
 declare class Context implements ViewContext {
     private view;

package/dist/core/ref.d.ts

@@ -0,0 +1,22 @@
+/**
+ * A hybrid getter/setter function that stores the last value it was called with.
+ * Guarantees a value is held at runtime by throwing an error if no value is set.
+ */
+export interface Ref<T> {
+    /**
+     * Returns the currently stored value of the ref, or throws an error if no value has been set.
+     */
+    (): T;
+    /**
+     * Stores a new value to the ref and returns that value.
+     */
+    (value: T): T;
+}
+/**
+ * Creates a ref with no initial value.
+ */
+export declare function ref<T>(): Ref<T>;
+/**
+ * Creates a ref with an initial value.
+ */
+export declare function ref<T>(value: T): Ref<T>;

package/dist/core/views/default-crash-view.d.ts

@@ -13,6 +13,10 @@ export type CrashViewProps = {
     /**
      * Unique identifier to pinpoint the specific view that reported the crash.
      */
-    uid?: string;
+    tag?: string;
+    /**
+     * Label for the tag.
+     */
+    tagName?: string;
 };
 export declare function DefaultCrashView(props: CrashViewProps): import("../markup.js").Markup;

package/dist/{fragment-DSGTP-XE.js → fragment-CmWsN-4Y.js}

@@ -1,8 +1,8 @@
-import { m } from "./view-CY19Cf0X.js";
+import { m } from "./view-BKpHFpWG.js";
 function a(r, n) {
   return m("$dynamic", { source: () => r.children });
 }
 export {
   a as F
 };
-//# sourceMappingURL=fragment-DSGTP-XE.js.map
+//# sourceMappingURL=fragment-CmWsN-4Y.js.map

package/dist/{fragment-DSGTP-XE.js.map → fragment-CmWsN-4Y.js.map}

@@ -1 +1 @@
-{"version":3,"file":"fragment-DSGTP-XE.js","sources":["../src/core/views/fragment.ts"],"sourcesContent":["import type { Renderable } from \"../../types.js\";\nimport { markup } from \"../markup.js\";\nimport { type ViewContext } from \"../nodes/view.js\";\n\n/**\n * A utility view that displays its children.\n */\nexport function Fragment(props: { children?: Renderable }, ctx: ViewContext) {\n  return markup(\"$dynamic\", { source: () => props.children });\n}\n"],"names":["Fragment","props","ctx","markup"],"mappings":";AAOgB,SAAAA,EAASC,GAAkCC,GAAkB;AAC3E,SAAOC,EAAO,YAAY,EAAE,QAAQ,MAAMF,EAAM,UAAU;AAC5D;"}
+{"version":3,"file":"fragment-CmWsN-4Y.js","sources":["../src/core/views/fragment.ts"],"sourcesContent":["import type { Renderable } from \"../../types.js\";\nimport { markup } from \"../markup.js\";\nimport { type ViewContext } from \"../nodes/view.js\";\n\n/**\n * A utility view that displays its children.\n */\nexport function Fragment(props: { children?: Renderable }, ctx: ViewContext) {\n  return markup(\"$dynamic\", { source: () => props.children });\n}\n"],"names":["Fragment","props","ctx","markup"],"mappings":";AAOgB,SAAAA,EAASC,GAAkCC,GAAkB;AAC3E,SAAOC,EAAO,YAAY,EAAE,QAAQ,MAAMF,EAAM,UAAU;AAC5D;"}

package/dist/i18n.js

@@ -5,7 +5,7 @@ var z = (o) => {
 var J = (o, t, e) => t in o ? B(o, t, { enumerable: !0, configurable: !0, writable: !0, value: e }) : o[t] = e;
 var O = (o, t, e) => J(o, typeof t != "symbol" ? t + "" : t, e), _ = (o, t, e) => t.has(o) || z("Cannot " + e);
 var i = (o, t, e) => (_(o, t, "read from private field"), e ? e.call(o) : t.get(o)), m = (o, t, e) => t.has(o) ? z("Cannot add the same private member more than once") : t instanceof WeakSet ? t.add(o) : t.set(o, e), N = (o, t, e, n) => (_(o, t, "write to private field"), n ? n.call(o, e) : t.set(o, e), e), g = (o, t, e) => (_(o, t, "access private method"), e);
-import { $, f as K, d as Q, g as x } from "./logger-CSRDjb4e.js";
+import { $, f as K, d as Q, g as x } from "./logger-CBfhf3fA.js";
 import { i as C, b as j, c as U, t as P } from "./typeChecking-EAVNeFyB.js";
 var I, F, p, S, G;
 class W {

package/dist/index.js

@@ -1,11 +1,24 @@
-import { o as d } from "./logger-CSRDjb4e.js";
-import { $ as O, f as v, d as F, e as N, g as T, b as U, p as B, c as P, h as $, i as z, s as D, a as I } from "./logger-CSRDjb4e.js";
-import { m as t, w as p, c, r as g } from "./view-CY19Cf0X.js";
-import { S as A, b as G, p as _, a as j, u as H } from "./view-CY19Cf0X.js";
-import { R as h, a as y, M as E, U as b } from "./router-BYOH-To5.js";
-import { i as w, a as u } from "./typeChecking-EAVNeFyB.js";
-function k(e) {
-  return t(
+import { o as d } from "./logger-CBfhf3fA.js";
+import { $ as L, f as O, d as P, e as $, g as B, b as U, p as v, c as z, h as D, i as I, s as W, a as Y } from "./logger-CBfhf3fA.js";
+import { m as a, w as h, c, r as p } from "./view-BKpHFpWG.js";
+import { S as A, b as G, p as j, a as H, u as J } from "./view-BKpHFpWG.js";
+import { R as y, a as E, M as w, U as b } from "./router-BoJac1lD.js";
+import { i as x, a as u } from "./typeChecking-EAVNeFyB.js";
+const f = Symbol("Ref.EMPTY");
+function N(e = f) {
+  return function() {
+    if (arguments.length === 0) {
+      if (e === f)
+        throw new Error("Ref getter was called, but ref has no value! Be sure to set your refs before accessing them.");
+    } else if (arguments.length === 1)
+      e = arguments[0];
+    else
+      throw new Error("Ref called with too many arguments. Expected 0 or 1 arguments.");
+    return e;
+  };
+}
+function R(e) {
+  return a(
     "div",
     {
       style: {
@@ -17,15 +30,22 @@ function k(e) {
         fontSize: "20px"
       }
     },
-    t("h1", { style: { marginBottom: "0.5rem" } }, "The app has crashed"),
-    t(
+    a("h1", { style: { marginBottom: "0.5rem" } }, "The app has crashed"),
+    a(
       "p",
       { style: { marginBottom: "0.25rem" } },
-      t("span", { style: { fontFamily: "monospace" } }, e.loggerName),
-      p(e.uid, t("span", { style: { fontFamily: "monospace", opacity: 0.5 } }, ` [uid: ${e.uid}]`)),
+      a("span", { style: { fontFamily: "monospace" } }, e.loggerName),
+      h(
+        e.tag,
+        a(
+          "span",
+          { style: { fontFamily: "monospace", opacity: 0.5 } },
+          ` [${e.tagName ? `${e.tagName}: ` : ""}${e.tag}]`
+        )
+      ),
       " says:"
     ),
-    t(
+    a(
       "blockquote",
       {
         style: {
@@ -36,7 +56,7 @@ function k(e) {
           marginBottom: "1rem"
         }
       },
-      t(
+      a(
         "span",
         {
           style: {
@@ -53,57 +73,58 @@ function k(e) {
       ),
       e.error.message
     ),
-    t("p", {}, "Please see the browser console for details.")
+    a("p", {}, "Please see the browser console for details.")
   );
 }
-let r = !1;
-async function R(e, n, i) {
-  if (r)
+let s = !1;
+async function T(e, n, m) {
+  if (s)
     throw new Error("A Dolla app is already mounted.");
-  let o, l, s, f = (i == null ? void 0 : i.crashView) ?? k;
-  if (w(e)) {
-    const a = document.querySelector(e);
-    u(Element, a, `Selector '${e}' did not match any element.`), o = a;
+  let o, l, r, g = (m == null ? void 0 : m.crashView) ?? R;
+  if (x(e)) {
+    const t = document.querySelector(e);
+    u(Element, t, `Selector '${e}' did not match any element.`), o = t;
   } else
     u(Element, e, "Expected an element or a selector string. Got type: %t, value: %v"), o = e;
-  if (n instanceof h)
-    s = n, l = n[y];
+  if (n instanceof y)
+    r = n, l = n[E];
   else {
-    const a = t(n);
-    l = c(a.type, a.props);
+    const t = a(n);
+    l = c(t.type, t.props);
   }
-  d((a) => {
-    r && (m(), c(f, a).mount(o));
+  d((t) => {
+    s && (i(), c(g, t).mount(o));
   });
-  for (const a of g.stores.values())
-    a.handleMount();
-  s && await s[E](o), l.mount(o), r = !0;
-  async function m() {
-    r && (l.unmount(!1), s && await s[b](), r = !1);
+  for (const t of p.stores.values())
+    t.handleMount();
+  r && await r[w](o), l.mount(o), s = !0;
+  async function i() {
+    s && (l.unmount(!1), r && await r[b](), s = !1);
   }
-  return m;
+  return i;
 }
 export {
-  O as $,
+  L as $,
   A as Stores,
   G as constructMarkup,
   c as constructView,
-  v as createLogger,
-  F as deepEqual,
-  N as effect,
-  T as get,
+  O as createLogger,
+  P as deepEqual,
+  $ as effect,
+  B as get,
   U as getEnv,
-  t as markup,
-  R as mount,
-  B as peek,
-  _ as portal,
-  j as repeat,
-  P as setEnv,
-  $ as setLogFilter,
-  z as setLogLevels,
-  D as shallowEqual,
-  I as strictEqual,
-  H as unless,
-  p as when
+  a as markup,
+  T as mount,
+  v as peek,
+  j as portal,
+  N as ref,
+  H as repeat,
+  z as setEnv,
+  D as setLogFilter,
+  I as setLogLevels,
+  W as shallowEqual,
+  Y as strictEqual,
+  J as unless,
+  h as when
 };
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sources":["../src/core/views/default-crash-view.ts","../src/core/mount.ts"],"sourcesContent":["import { when, markup as m } from \"../markup.js\";\n\n/**\n * Props passed to the crash view when a crash occurs.\n */\nexport type CrashViewProps = {\n  /**\n   * JavaScript Error object.\n   */\n  error: Error;\n\n  /**\n   * A string to identify the logger that reported this error.\n   */\n  loggerName: string;\n\n  /**\n   * Unique identifier to pinpoint the specific view that reported the crash.\n   */\n  uid?: string;\n};\n\nexport function DefaultCrashView(props: CrashViewProps) {\n  return m(\n    \"div\",\n    {\n      style: {\n        backgroundColor: \"#880000\",\n        color: \"#fff\",\n        padding: \"2rem\",\n        position: \"fixed\",\n        inset: 0,\n        fontSize: \"20px\",\n      },\n    },\n    m(\"h1\", { style: { marginBottom: \"0.5rem\" } }, \"The app has crashed\"),\n    m(\n      \"p\",\n      { style: { marginBottom: \"0.25rem\" } },\n      m(\"span\", { style: { fontFamily: \"monospace\" } }, props.loggerName),\n      when(props.uid, m(\"span\", { style: { fontFamily: \"monospace\", opacity: 0.5 } }, ` [uid: ${props.uid}]`)),\n      \" says:\",\n    ),\n    m(\n      \"blockquote\",\n      {\n        style: {\n          backgroundColor: \"#991111\",\n          padding: \"0.25em\",\n          borderRadius: \"6px\",\n          fontFamily: \"monospace\",\n          marginBottom: \"1rem\",\n        },\n      },\n      m(\n        \"span\",\n        {\n          style: {\n            display: \"inline-block\",\n            backgroundColor: \"red\",\n            padding: \"0.1em 0.4em\",\n            marginRight: \"0.5em\",\n            borderRadius: \"4px\",\n            fontSize: \"0.9em\",\n            fontWeight: \"bold\",\n          },\n        },\n        props.error.name,\n      ),\n      props.error.message,\n    ),\n    m(\"p\", {}, \"Please see the browser console for details.\"),\n  );\n}\n","import { MOUNT, ROOT_VIEW, UNMOUNT, Router } from \"../router/router\";\nimport { assertInstanceOf, isString } from \"../typeChecking\";\nimport { rootElementContext } from \"./context\";\nimport { type LoggerErrorContext, onLoggerCrash } from \"./logger\";\nimport { markup } from \"./markup\";\nimport { constructView, type ViewElement, type ViewFunction } from \"./nodes/view\";\nimport { DefaultCrashView } from \"./views/default-crash-view\";\n\nlet isMounted = false;\n\nexport type UnmountFn = () => Promise<void>;\nexport interface MountOptions {\n  crashView?: ViewFunction<LoggerErrorContext>;\n}\n\nexport async function mount(parent: Element, view: any, options?: MountOptions): Promise<UnmountFn>;\nexport async function mount(parent: Element, router: any, options?: MountOptions): Promise<UnmountFn>;\n\nexport async function mount(parent: string, view: any, options?: MountOptions): Promise<UnmountFn>;\nexport async function mount(parent: string, router: any, options?: MountOptions): Promise<UnmountFn>;\n\nexport async function mount(target: any, view: any, options?: MountOptions): Promise<UnmountFn> {\n  if (isMounted) {\n    throw new Error(`A Dolla app is already mounted.`);\n  }\n\n  let rootElement: Element;\n  let rootView: ViewElement;\n  let router: any | undefined;\n  let crashView = options?.crashView ?? DefaultCrashView;\n\n  if (isString(target)) {\n    const match = document.querySelector<Element>(target);\n    assertInstanceOf(Element, match, `Selector '${target}' did not match any element.`);\n    rootElement = match!;\n  } else {\n    assertInstanceOf(Element, target, \"Expected an element or a selector string. Got type: %t, value: %v\");\n    rootElement = target;\n  }\n\n  if (view instanceof Router) {\n    router = view;\n    rootView = view[ROOT_VIEW];\n  } else {\n    // First, initialize the root view. The router store needs this to connect the initial route.\n    const rootViewMarkup = markup(view);\n    rootView = constructView(rootViewMarkup.type as ViewFunction<any>, rootViewMarkup.props);\n  }\n\n  onLoggerCrash((ctx) => {\n    if (isMounted) {\n      // Unmount the app.\n      unmount();\n\n      // Mount the crash page\n      const crashPage = constructView(crashView, ctx);\n      crashPage.mount(rootElement!);\n    }\n  });\n\n  // Run onMount for stores.\n  for (const store of rootElementContext.stores.values()) {\n    store.handleMount();\n  }\n\n  if (router) {\n    await router[MOUNT](rootElement);\n  }\n\n  rootView.mount(rootElement);\n  isMounted = true;\n\n  async function unmount() {\n    if (!isMounted) return;\n\n    rootView.unmount(false);\n\n    if (router) {\n      await router[UNMOUNT]();\n    }\n\n    isMounted = false;\n  }\n\n  return unmount;\n}\n"],"names":["DefaultCrashView","props","m","when","isMounted","mount","target","view","options","rootElement","rootView","router","crashView","isString","match","assertInstanceOf","Router","ROOT_VIEW","rootViewMarkup","markup","constructView","onLoggerCrash","ctx","unmount","store","rootElementContext","MOUNT","UNMOUNT"],"mappings":";;;;;;AAsBO,SAASA,EAAiBC,GAAuB;AAC/C,SAAAC;AAAAA,IACL;AAAA,IACA;AAAA,MACE,OAAO;AAAA,QACL,iBAAiB;AAAA,QACjB,OAAO;AAAA,QACP,SAAS;AAAA,QACT,UAAU;AAAA,QACV,OAAO;AAAA,QACP,UAAU;AAAA,MAAA;AAAA,IAEd;AAAA,IACAA,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,SAAA,EAAW,GAAG,qBAAqB;AAAA,IACpEA;AAAAA,MACE;AAAA,MACA,EAAE,OAAO,EAAE,cAAc,YAAY;AAAA,MACrCA,EAAE,QAAQ,EAAE,OAAO,EAAE,YAAY,YAAY,EAAA,GAAKD,EAAM,UAAU;AAAA,MAClEE,EAAKF,EAAM,KAAKC,EAAE,QAAQ,EAAE,OAAO,EAAE,YAAY,aAAa,SAAS,IAAM,EAAA,GAAG,UAAUD,EAAM,GAAG,GAAG,CAAC;AAAA,MACvG;AAAA,IACF;AAAA,IACAC;AAAAA,MACE;AAAA,MACA;AAAA,QACE,OAAO;AAAA,UACL,iBAAiB;AAAA,UACjB,SAAS;AAAA,UACT,cAAc;AAAA,UACd,YAAY;AAAA,UACZ,cAAc;AAAA,QAAA;AAAA,MAElB;AAAA,MACAA;AAAAA,QACE;AAAA,QACA;AAAA,UACE,OAAO;AAAA,YACL,SAAS;AAAA,YACT,iBAAiB;AAAA,YACjB,SAAS;AAAA,YACT,aAAa;AAAA,YACb,cAAc;AAAA,YACd,UAAU;AAAA,YACV,YAAY;AAAA,UAAA;AAAA,QAEhB;AAAA,QACAD,EAAM,MAAM;AAAA,MACd;AAAA,MACAA,EAAM,MAAM;AAAA,IACd;AAAA,IACAC,EAAE,KAAK,CAAA,GAAI,6CAA6C;AAAA,EAC1D;AACF;ACjEA,IAAIE,IAAY;AAaM,eAAAC,EAAMC,GAAaC,GAAWC,GAA4C;AAC9F,MAAIJ;AACI,UAAA,IAAI,MAAM,iCAAiC;AAG/C,MAAAK,GACAC,GACAC,GACAC,KAAYJ,KAAA,gBAAAA,EAAS,cAAaR;AAElC,MAAAa,EAASP,CAAM,GAAG;AACd,UAAAQ,IAAQ,SAAS,cAAuBR,CAAM;AACpD,IAAAS,EAAiB,SAASD,GAAO,aAAaR,CAAM,8BAA8B,GACpEG,IAAAK;AAAA,EAAA;AAEG,IAAAC,EAAA,SAAST,GAAQ,mEAAmE,GACvFG,IAAAH;AAGhB,MAAIC,aAAgBS;AACT,IAAAL,IAAAJ,GACTG,IAAWH,EAAKU,CAAS;AAAA,OACpB;AAEC,UAAAC,IAAiBC,EAAOZ,CAAI;AAClC,IAAAG,IAAWU,EAAcF,EAAe,MAA2BA,EAAe,KAAK;AAAA,EAAA;AAGzF,EAAAG,EAAc,CAACC,MAAQ;AACrB,IAAIlB,MAEMmB,EAAA,GAGUH,EAAcR,GAAWU,CAAG,EACpC,MAAMb,CAAY;AAAA,EAC9B,CACD;AAGD,aAAWe,KAASC,EAAmB,OAAO,OAAA;AAC5C,IAAAD,EAAM,YAAY;AAGpB,EAAIb,KACI,MAAAA,EAAOe,CAAK,EAAEjB,CAAW,GAGjCC,EAAS,MAAMD,CAAW,GACdL,IAAA;AAEZ,iBAAemB,IAAU;AACvB,IAAKnB,MAELM,EAAS,QAAQ,EAAK,GAElBC,KACI,MAAAA,EAAOgB,CAAO,EAAE,GAGZvB,IAAA;AAAA,EAAA;AAGP,SAAAmB;AACT;"}
+{"version":3,"file":"index.js","sources":["../src/core/ref.ts","../src/core/views/default-crash-view.ts","../src/core/mount.ts"],"sourcesContent":["const EMPTY_REF = Symbol(\"Ref.EMPTY\");\n\n/**\n * A hybrid getter/setter function that stores the last value it was called with.\n * Guarantees a value is held at runtime by throwing an error if no value is set.\n */\nexport interface Ref<T> {\n  /**\n   * Returns the currently stored value of the ref, or throws an error if no value has been set.\n   */\n  (): T;\n\n  /**\n   * Stores a new value to the ref and returns that value.\n   */\n  (value: T): T;\n}\n\n/**\n * Creates a ref with no initial value.\n */\nexport function ref<T>(): Ref<T>;\n\n/**\n * Creates a ref with an initial value.\n */\nexport function ref<T>(value: T): Ref<T>;\n\nexport function ref(value = EMPTY_REF) {\n  return function () {\n    if (arguments.length === 0) {\n      if (value === EMPTY_REF) {\n        throw new Error(`Ref getter was called, but ref has no value! Be sure to set your refs before accessing them.`);\n      }\n    } else if (arguments.length === 1) {\n      value = arguments[0];\n    } else {\n      throw new Error(`Ref called with too many arguments. Expected 0 or 1 arguments.`);\n    }\n\n    return value;\n  };\n}\n","import { when, markup as m } from \"../markup.js\";\n\n/**\n * Props passed to the crash view when a crash occurs.\n */\nexport type CrashViewProps = {\n  /**\n   * JavaScript Error object.\n   */\n  error: Error;\n\n  /**\n   * A string to identify the logger that reported this error.\n   */\n  loggerName: string;\n\n  /**\n   * Unique identifier to pinpoint the specific view that reported the crash.\n   */\n  tag?: string;\n\n  /**\n   * Label for the tag.\n   */\n  tagName?: string;\n};\n\nexport function DefaultCrashView(props: CrashViewProps) {\n  return m(\n    \"div\",\n    {\n      style: {\n        backgroundColor: \"#880000\",\n        color: \"#fff\",\n        padding: \"2rem\",\n        position: \"fixed\",\n        inset: 0,\n        fontSize: \"20px\",\n      },\n    },\n    m(\"h1\", { style: { marginBottom: \"0.5rem\" } }, \"The app has crashed\"),\n    m(\n      \"p\",\n      { style: { marginBottom: \"0.25rem\" } },\n      m(\"span\", { style: { fontFamily: \"monospace\" } }, props.loggerName),\n      when(\n        props.tag,\n        m(\n          \"span\",\n          { style: { fontFamily: \"monospace\", opacity: 0.5 } },\n          ` [${props.tagName ? `${props.tagName}: ` : \"\"}${props.tag}]`,\n        ),\n      ),\n      \" says:\",\n    ),\n    m(\n      \"blockquote\",\n      {\n        style: {\n          backgroundColor: \"#991111\",\n          padding: \"0.25em\",\n          borderRadius: \"6px\",\n          fontFamily: \"monospace\",\n          marginBottom: \"1rem\",\n        },\n      },\n      m(\n        \"span\",\n        {\n          style: {\n            display: \"inline-block\",\n            backgroundColor: \"red\",\n            padding: \"0.1em 0.4em\",\n            marginRight: \"0.5em\",\n            borderRadius: \"4px\",\n            fontSize: \"0.9em\",\n            fontWeight: \"bold\",\n          },\n        },\n        props.error.name,\n      ),\n      props.error.message,\n    ),\n    m(\"p\", {}, \"Please see the browser console for details.\"),\n  );\n}\n","import { MOUNT, ROOT_VIEW, UNMOUNT, Router } from \"../router/router\";\nimport { assertInstanceOf, isString } from \"../typeChecking\";\nimport { rootElementContext } from \"./context\";\nimport { type LoggerErrorContext, onLoggerCrash } from \"./logger\";\nimport { markup } from \"./markup\";\nimport { constructView, type ViewElement, type ViewFunction } from \"./nodes/view\";\nimport { DefaultCrashView } from \"./views/default-crash-view\";\n\nlet isMounted = false;\n\nexport type UnmountFn = () => Promise<void>;\nexport interface MountOptions {\n  crashView?: ViewFunction<LoggerErrorContext>;\n}\n\nexport async function mount(parent: Element, view: any, options?: MountOptions): Promise<UnmountFn>;\nexport async function mount(parent: Element, router: any, options?: MountOptions): Promise<UnmountFn>;\n\nexport async function mount(parent: string, view: any, options?: MountOptions): Promise<UnmountFn>;\nexport async function mount(parent: string, router: any, options?: MountOptions): Promise<UnmountFn>;\n\nexport async function mount(target: any, view: any, options?: MountOptions): Promise<UnmountFn> {\n  if (isMounted) {\n    throw new Error(`A Dolla app is already mounted.`);\n  }\n\n  let rootElement: Element;\n  let rootView: ViewElement;\n  let router: any | undefined;\n  let crashView = options?.crashView ?? DefaultCrashView;\n\n  if (isString(target)) {\n    const match = document.querySelector<Element>(target);\n    assertInstanceOf(Element, match, `Selector '${target}' did not match any element.`);\n    rootElement = match!;\n  } else {\n    assertInstanceOf(Element, target, \"Expected an element or a selector string. Got type: %t, value: %v\");\n    rootElement = target;\n  }\n\n  if (view instanceof Router) {\n    router = view;\n    rootView = view[ROOT_VIEW];\n  } else {\n    // First, initialize the root view. The router store needs this to connect the initial route.\n    const rootViewMarkup = markup(view);\n    rootView = constructView(rootViewMarkup.type as ViewFunction<any>, rootViewMarkup.props);\n  }\n\n  onLoggerCrash((ctx) => {\n    if (isMounted) {\n      // Unmount the app.\n      unmount();\n\n      // Mount the crash page\n      const crashPage = constructView(crashView, ctx);\n      crashPage.mount(rootElement!);\n    }\n  });\n\n  // Run onMount for stores.\n  for (const store of rootElementContext.stores.values()) {\n    store.handleMount();\n  }\n\n  if (router) {\n    await router[MOUNT](rootElement);\n  }\n\n  rootView.mount(rootElement);\n  isMounted = true;\n\n  async function unmount() {\n    if (!isMounted) return;\n\n    rootView.unmount(false);\n\n    if (router) {\n      await router[UNMOUNT]();\n    }\n\n    isMounted = false;\n  }\n\n  return unmount;\n}\n"],"names":["EMPTY_REF","ref","value","DefaultCrashView","props","m","when","isMounted","mount","target","view","options","rootElement","rootView","router","crashView","isString","match","assertInstanceOf","Router","ROOT_VIEW","rootViewMarkup","markup","constructView","onLoggerCrash","ctx","unmount","store","rootElementContext","MOUNT","UNMOUNT"],"mappings":"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"}

package/dist/jsx-dev-runtime.js

@@ -1,5 +1,5 @@
-import { m as s } from "./view-CY19Cf0X.js";
-import { F as h } from "./fragment-DSGTP-XE.js";
+import { m as s } from "./view-BKpHFpWG.js";
+import { F as h } from "./fragment-CmWsN-4Y.js";
 function d(e, r, t, n, l, u) {
   const i = { ...o(["children", "key"], r) }, c = Array.isArray(r.children) ? r.children : [r.children];
   return s(e, i, ...c);

package/dist/jsx-runtime.js

@@ -1,5 +1,5 @@
-import { m as t } from "./view-CY19Cf0X.js";
-import { F as k } from "./fragment-DSGTP-XE.js";
+import { m as t } from "./view-BKpHFpWG.js";
+import { F as k } from "./fragment-CmWsN-4Y.js";
 function d(e, n, r) {
   return t(e, n ? { ...u(["children", "key"], n) } : void 0, n.children);
 }