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

package/README.md

@@ -35,30 +35,34 @@ Dolla's goals include:
 A basic view. Note that the view function is called exactly once when the view is first mounted. All changes to DOM nodes thereafter happen as a result of `$state` values changing.
 
 ```jsx
-import Dolla, { $ } from "@manyducks.co/dolla";
+import { $, when, mount } from "@manyducks.co/dolla";
 
 function Counter(props, ctx) {
-  const count = $(0);
+  const $count = $(0);
 
   // An effect will re-run whenever any signal value accessed inside it changes.
   ctx.effect(() => {
-    console.log(`Count is: ${count()}`);
+    console.log(`Count is: ${$count()}`);
   });
 
   function increment() {
-    // Call signal function with a new value to set it...
-    count(count() + 1);
+    // Pass a function that takes the current value and returns a new one.
+    $count((x) => x + 1);
   }
 
   function decrement() {
-    // ... or pass a function that takes the current value and returns the next.
-    count((value) => value - 1);
+    $count((x) => x - 1);
+  }
+
+  function reset() {
+    // Set state directly by passing a (non-function) value.
+    $count(0);
   }
 
   return (
     <div>
       {/* Signals can be slotted into the DOM to render them */}
-      <p>Counter: {count}</p>
+      <p>Counter: {$count}</p>
       <div>
         <button on:click={increment}>+1</button>
         <button on:click={decrement}>-1</button>
@@ -66,7 +70,7 @@ function Counter(props, ctx) {
 
       {/* We can derive a new signal on the fly and conditionally render something based on that condition */}
       {when(
-        $(() => count() > 10),
+        $(() => $count() > 10),
         <span>That's a lot of clicks!</span>,
       )}
 
@@ -76,7 +80,7 @@ function Counter(props, ctx) {
         // If we get Dynamic to track its rendered elements and diff them by keys
         // then we may be able to do away with repeat and when and just do things like:
         //    <ul>{() => items().map(item => <li>{item}</li>)}</ul>
-        if (count() > 10) {
+        if ($count() > 10) {
           return <span>That's a lot of clicks!</span>;
         }
       }}
@@ -84,7 +88,7 @@ function Counter(props, ctx) {
   );
 }
 
-Dolla.mount(document.body, Counter);
+mount(document.body, Counter);
 ```
 
 > TODO: Show small examples for routing and stores.

package/dist/core/context.d.ts

@@ -1,12 +1,10 @@
-import type { Dolla } from "./dolla";
 import type { View } from "./nodes/view";
-import type { Source } from "./signals-api";
+import type { Source } from "./signals";
 import type { Store, StoreFunction } from "./store";
 export interface ElementContext {
     /**
      * The root Dolla instance this element belongs to.
      */
-    root: Dolla;
     /**
      * Stores attached to this context.
      */
@@ -63,3 +61,9 @@ export interface StoreConsumerContext {
      */
     get<Value>(store: StoreFunction<any, Value>): Value;
 }
+type StoreMap = Map<any, any>;
+export declare const globalStores: StoreMap;
+export declare const rootElementContext: {
+    stores: StoreMap;
+};
+export {};

package/dist/core/env.d.ts

@@ -0,0 +1,9 @@
+export type Env = "production" | "development";
+/**
+ * Gets the current environment value.
+ */
+export declare function getEnv(): Env;
+/**
+ * Sets the environment value. Affects which log messages will print and how much debugging info is included in the DOM.
+ */
+export declare function setEnv(value: Env): void;

package/dist/core/index.d.ts

@@ -0,0 +1,23 @@
+export { $, effect, get, peek } from "./signals.js";
+export type { MaybeSignal, Signal, Source } from "./signals.js";
+export { constructView } from "./nodes/view.js";
+export { deepEqual, shallowEqual, strictEqual } from "../utils.js";
+export { Stores, type StoreContext, type StoreFunction } from "./store.js";
+export { markup, portal, repeat, unless, when, constructMarkup } from "./markup.js";
+export type { Markup, MarkupElement } from "./markup.js";
+export { getEnv, setEnv } from "./env.js";
+export type { Env } from "./env.js";
+export { createLogger, setLogFilter, setLogLevels } from "./logger.js";
+export type { Logger, LoggerErrorContext, LoggerOptions, LogLevels } from "./logger.js";
+export { mount, type UnmountFn } from "./mount.js";
+export type { ViewContext, ViewElement, ViewFunction } from "./nodes/view.js";
+export type { CrashViewProps } from "./views/default-crash-view.js";
+export type { InputType, Renderable } from "../types.js";
+import type { IntrinsicElements as Elements } from "../types.js";
+declare global {
+    namespace JSX {
+        interface IntrinsicElements extends Elements {
+            [tag: string]: any;
+        }
+    }
+}

package/dist/core/logger.d.ts

@@ -0,0 +1,34 @@
+import { type Env } from "./env";
+import { type MaybeSignal } from "./signals";
+export interface LogLevels {
+    info: boolean | Env;
+    log: boolean | Env;
+    warn: boolean | Env;
+    error: boolean | Env;
+}
+export interface Logger {
+    info(...args: any[]): void;
+    log(...args: any[]): void;
+    warn(...args: any[]): void;
+    error(...args: any[]): void;
+    crash(error: Error): void;
+}
+export interface LoggerOptions {
+    /**
+     * Unique ID to print with logs. Makes it easier to track down messages from specific view instances.
+     */
+    uid?: string;
+    /**
+     * Console object to use for logging (mostly for testing). Uses window.console by default.
+     */
+    console?: any;
+}
+export interface LoggerErrorContext {
+    error: Error;
+    loggerName: string;
+    uid?: string;
+}
+export declare function onLoggerCrash(listener: (context: LoggerErrorContext) => void): () => void;
+export declare function createLogger(name: MaybeSignal<string>, options?: LoggerOptions): Logger;
+export declare function setLogFilter(filter: string | RegExp): void;
+export declare function setLogLevels(options: Partial<LogLevels>): void;

package/dist/core/markup.d.ts

@@ -1,7 +1,7 @@
-import type { Renderable } from "../types.js";
-import type { ElementContext } from "./context.js";
+import type { Mountable, Renderable } from "../types.js";
+import { type ElementContext } from "./context.js";
 import { View, type ViewContext, type ViewFunction, type ViewResult } from "./nodes/view.js";
-import { type MaybeSignal, type Signal } from "./signals-api.js";
+import { type MaybeSignal, type Signal } from "./signals.js";
 /**
  * Markup is a set of element metadata that hasn't been constructed into a MarkupElement yet.
  */
@@ -23,19 +23,14 @@ export interface Markup {
 /**
  * A DOM node that has been constructed from a Markup object.
  */
-export interface MarkupElement {
+export interface MarkupElement extends Mountable {
     readonly domNode?: Node;
     readonly isMounted: boolean;
-    mount(parent: Node, after?: Node): void;
-    /**
-     * Disconnect from the DOM and clean up. If parentIsUnmounting, DOM operations are skipped.
-     * parentIsUnmounting is set for all children by HTML nodes when they unmount.
-     */
-    unmount(parentIsUnmounting?: boolean): void;
 }
 export declare function isMarkup(value: any): value is Markup;
 export declare function isMarkupElement(value: any): value is MarkupElement;
 export declare function toMarkup(renderables: Renderable | Renderable[]): Markup[];
+export declare function constructMarkup(markup: Markup | Markup[]): MarkupElement;
 export declare enum MarkupType {
     Text = "$text",
     Repeat = "$repeat",
@@ -94,7 +89,7 @@ export declare function portal(parent: Node, content: Renderable): Markup;
 /**
  * Construct Markup metadata into a set of MarkupElements.
  */
-export declare function constructMarkup(elementContext: ElementContext, markup: Markup | Markup[]): MarkupElement[];
+export declare function toMarkupElements(elementContext: ElementContext, markup: Markup | Markup[]): MarkupElement[];
 /**
  * Combines one or more MarkupElements into a single MarkupElement.
  */

package/dist/core/mount.d.ts

@@ -0,0 +1,10 @@
+import { type LoggerErrorContext } from "./logger";
+import { type ViewFunction } from "./nodes/view";
+export type UnmountFn = () => Promise<void>;
+export interface MountOptions {
+    crashView?: ViewFunction<LoggerErrorContext>;
+}
+export declare function mount(parent: Element, view: any, options?: MountOptions): Promise<UnmountFn>;
+export declare function mount(parent: Element, router: any, options?: MountOptions): Promise<UnmountFn>;
+export declare function mount(parent: string, view: any, options?: MountOptions): Promise<UnmountFn>;
+export declare function mount(parent: string, router: any, options?: MountOptions): Promise<UnmountFn>;

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

@@ -1,7 +1,7 @@
 import type { Renderable } from "../../types.js";
 import type { ElementContext } from "../context.js";
 import { type MarkupElement } from "../markup.js";
-import { Signal } from "../signals-api.js";
+import { Signal } from "../signals.js";
 import { IS_MARKUP_ELEMENT } from "../symbols.js";
 interface DynamicOptions {
     source: Signal<Renderable>;

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

@@ -1,5 +1,5 @@
 import { type MarkupElement } from "../markup.js";
-import { type MaybeSignal } from "../signals-api.js";
+import { type MaybeSignal } from "../signals.js";
 import { IS_MARKUP_ELEMENT } from "../symbols.js";
 /**
  * Manages several MarkupElements as one.

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

@@ -1,5 +1,5 @@
 import { type MarkupElement } from "../markup.js";
-import { type Signal } from "../signals-api.js";
+import { type Signal } from "../signals.js";
 import { IS_MARKUP_ELEMENT } from "../symbols.js";
 import { View } from "./view.js";
 /**

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

@@ -1,6 +1,6 @@
 import { type ElementContext } from "../context.js";
 import { type MarkupElement } from "../markup.js";
-import { type Signal } from "../signals-api.js";
+import { type Signal } from "../signals.js";
 import { IS_MARKUP_ELEMENT } from "../symbols.js";
 import { type ViewContext, type ViewResult } from "./view.js";
 interface RepeatOptions<T> {

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

@@ -1,7 +1,8 @@
-import type { ComponentContext, ElementContext, StoreConsumerContext, StoreProviderContext } from "../context.js";
-import type { Logger } from "../dolla.js";
+import { Renderable } from "../../types.js";
+import { type ComponentContext, type ElementContext, type StoreConsumerContext, type StoreProviderContext } from "../context.js";
+import { type Logger } from "../logger.js";
 import { type Markup, type MarkupElement } from "../markup.js";
-import { type Signal, type EffectCallback, type UnsubscribeFunction } from "../signals-api.js";
+import { type EffectFn, type Signal, type UnsubscribeFn } from "../signals.js";
 import { StoreFunction } from "../store.js";
 import { IS_MARKUP_ELEMENT } from "../symbols.js";
 /**
@@ -44,7 +45,7 @@ export interface ViewContext extends Omit<Logger, "setName">, ComponentContext,
      * 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: EffectCallback): UnsubscribeFunction;
+    effect(callback: EffectFn): UnsubscribeFn;
     /**
      * Displays this view's subroutes if mounted as a router view.
      */
@@ -65,7 +66,7 @@ declare class Context implements ViewContext {
     onMount(callback: () => void): void;
     beforeUnmount(callback: () => void): void;
     onUnmount(callback: () => void): void;
-    effect(callback: EffectCallback): UnsubscribeFunction;
+    effect(callback: EffectFn): UnsubscribeFn;
     outlet(): Markup;
 }
 export declare class View<P> implements ViewElement {
@@ -78,7 +79,7 @@ export declare class View<P> implements ViewElement {
     };
     fn: ViewFunction<P>;
     element?: MarkupElement;
-    name: string;
+    name: import("../signals.js").Source<string>;
     context: Context;
     lifecycleListeners: {
         beforeMount: (() => any)[];
@@ -94,4 +95,8 @@ export declare class View<P> implements ViewElement {
     setRouteView(fn: ViewFunction<{}>): View<{}>;
     private _initialize;
 }
+export declare function constructView<P>(view: ViewFunction<P>, props: P, children?: Renderable[]): ViewElement;
+export declare function constructView(view: ViewFunction<{}>, children?: Renderable[]): ViewElement;
+export declare function constructView<P>(context: ElementContext, view: ViewFunction<P>, props: P, children?: Renderable[]): ViewElement;
+export declare function constructView(context: ElementContext, view: ViewFunction<{}>, children?: Renderable[]): ViewElement;
 export {};

package/dist/core/signals.d.ts

@@ -1,5 +1,4 @@
 import { type Dependency, type Subscriber, SubscriberFlags } from "alien-signals";
-import type { EqualityFunction } from "./signals-api";
 export interface Effect extends Subscriber, Dependency {
     /**
      * Effect function. Can return an optional cleanup callback to be invoked before the next fn() call.
@@ -9,7 +8,7 @@ export interface Effect extends Subscriber, Dependency {
 }
 export interface Computed<T = any> extends Value<T | undefined>, Subscriber {
     getter: (cachedValue?: T) => T;
-    equals: EqualityFunction<T>;
+    equals: EqualityFn<T>;
 }
 export interface Value<T = any> extends Dependency {
     current: T;
@@ -20,3 +19,45 @@ export declare function queueEffect(e: Effect): void;
 export declare function stopEffect(this: Effect): void;
 export declare function pauseTracking(): void;
 export declare function resumeTracking(): void;
+/**
+ * A getter that returns the current value held within the signal.
+ * If called inside a trackable scope this signal will be tracked as a dependency.
+ */
+export interface Signal<T> {
+    (): T;
+}
+/**
+ * Extends Signal with the ability to pass a value or an updater function to change the Signal's value.
+ */
+export interface Source<T> extends Signal<T> {
+    (value: T): void;
+    (updater: (value: T) => T): void;
+}
+export type MaybeSignal<T> = Signal<T> | T;
+export type EqualityFn<T> = (current: T, next: T) => boolean;
+export interface SignalOptions<T> {
+    /**
+     * A function to compare the current and next values. Returning `true` means the value has changed.
+     */
+    equals?: EqualityFn<T>;
+}
+export declare function isSource<T>(value: MaybeSignal<T>): value is Source<T>;
+export declare function peek<T>(value: MaybeSignal<T>): T;
+export declare function get<T>(value: MaybeSignal<T>): T;
+/**
+ * Function to be invoked for the effect. Can return an optional cleanup function to be called between invocations.
+ */
+export type EffectFn = () => void | (() => void);
+export type UnsubscribeFn = () => void;
+/**
+ * Creates a tracked scope that re-runs whenever the values of any tracked reactives changes.
+ * Reactives are tracked by accessing their `value` within the body of the function.
+ *
+ * NOTE: You must call the unsubscribe function to stop watching for changes.
+ * If you are using an effect inside a View or Store, use `ctx.effect` instead, which cleans up automatically when the component unmounts.
+ */
+export declare function effect(fn: EffectFn): UnsubscribeFn;
+export declare function $<T>(compute: () => MaybeSignal<T>, options?: SignalOptions<T>): Signal<T>;
+export declare function $<T>(value: T, options?: SignalOptions<T>): Source<T>;
+export declare function $<T>(value: undefined, options?: SignalOptions<T>): Source<T | undefined>;
+export declare function $<T>(): Source<T | undefined>;

package/dist/core/store.d.ts

@@ -1,6 +1,6 @@
-import type { ComponentContext, ElementContext, StoreConsumerContext } from "./context.js";
-import type { Logger } from "./dolla.js";
-import { type EffectCallback, type UnsubscribeFunction } from "./signals-api.js";
+import { type ComponentContext, type ElementContext, type StoreConsumerContext, type StoreProviderContext } from "./context.js";
+import { type Logger } from "./logger.js";
+import { type EffectFn, type UnsubscribeFn } from "./signals.js";
 export type StoreFunction<Options, Value> = (this: StoreContext, options: Options, context: StoreContext) => Value;
 export type StoreFactory<Options, Value> = Options extends undefined ? () => Store<Options, Value> : (options: Options) => Store<Options, Value>;
 export interface StoreContext extends Omit<Logger, "setName">, ComponentContext, StoreConsumerContext {
@@ -20,7 +20,7 @@ export interface StoreContext extends Omit<Logger, "setName">, ComponentContext,
      * 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: EffectCallback): UnsubscribeFunction;
+    effect(callback: EffectFn): UnsubscribeFn;
 }
 export declare class Store<Options, Value> {
     readonly fn: StoreFunction<Options, Value>;
@@ -37,7 +37,7 @@ export declare class Store<Options, Value> {
     };
     logger: Logger;
     id: string;
-    name: string;
+    name: import("./signals.js").Source<string>;
     constructor(fn: StoreFunction<Options, Value>, options: Options);
     /**
      * Attaches this Store to the elementContext.
@@ -50,3 +50,8 @@ export declare class Store<Options, Value> {
 export declare function isStore<Options, Value>(value: any): value is Store<Options, Value>;
 export declare class StoreError extends Error {
 }
+export type Stores = StoreProviderContext & StoreConsumerContext;
+/**
+ * Global store registry.
+ */
+export declare const Stores: Stores;

package/dist/{fragment-Bvuvw3ue.js → fragment-DSGTP-XE.js}

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

package/dist/{fragment-Bvuvw3ue.js.map → fragment-DSGTP-XE.js.map}

@@ -1 +1 @@
-{"version":3,"file":"fragment-Bvuvw3ue.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-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;"}

package/dist/http.js

@@ -0,0 +1,163 @@
+var b = Object.defineProperty;
+var f = (r) => {
+  throw TypeError(r);
+};
+var g = (r, e, t) => e in r ? b(r, e, { enumerable: !0, configurable: !0, writable: !0, value: t }) : r[e] = t;
+var a = (r, e, t) => g(r, typeof e != "symbol" ? e + "" : e, t), m = (r, e, t) => e.has(r) || f("Cannot " + t);
+var d = (r, e, t) => (m(r, e, "read from private field"), t ? t.call(r) : e.get(r)), c = (r, e, t) => e.has(r) ? f("Cannot add the same private member more than once") : e instanceof WeakSet ? e.add(r) : e.set(r, t);
+var o = (r, e, t) => (m(r, e, "access private method"), t);
+import { b as w } from "./typeChecking-EAVNeFyB.js";
+var l, p, i, h;
+class O {
+  constructor() {
+    c(this, i);
+    c(this, l, []);
+    c(this, p, S());
+  }
+  /**
+   * Adds a new middleware that will apply to subsequent requests.
+   * Returns a function to remove this middleware.
+   *
+   * @param middleware - A middleware function that will intercept requests.
+   */
+  use(e) {
+    return d(this, l).push(e), () => {
+      d(this, l).splice(d(this, l).indexOf(e), 1);
+    };
+  }
+  async get(e, t) {
+    return o(this, i, h).call(this, "get", e, t);
+  }
+  async put(e, t) {
+    return o(this, i, h).call(this, "put", e, t);
+  }
+  async patch(e, t) {
+    return o(this, i, h).call(this, "patch", e, t);
+  }
+  async post(e, t) {
+    return o(this, i, h).call(this, "post", e, t);
+  }
+  async delete(e, t) {
+    return o(this, i, h).call(this, "delete", e, t);
+  }
+  async head(e, t) {
+    return o(this, i, h).call(this, "head", e, t);
+  }
+  async options(e, t) {
+    return o(this, i, h).call(this, "options", e, t);
+  }
+  async trace(e, t) {
+    return o(this, i, h).call(this, "trace", e, t);
+  }
+}
+l = new WeakMap(), p = new WeakMap(), i = new WeakSet(), h = async function(e, t, s) {
+  return new x({
+    ...s,
+    method: e,
+    uri: t,
+    middleware: d(this, l),
+    fetch: d(this, p)
+  }).fetch();
+};
+function S() {
+  if (typeof window < "u" && window.fetch)
+    return window.fetch.bind(window);
+  if (typeof global < "u" && global.fetch)
+    return global.fetch.bind(global);
+  throw new Error("Running in neither browser nor node. Please run this app in one of the supported environments.");
+}
+class P extends Error {
+  constructor(t) {
+    const { status: s, statusText: n, method: u, url: y } = t, _ = `${s} ${n}: Request failed (${u.toUpperCase()} ${y.toString()})`;
+    super(_);
+    a(this, "response");
+    this.response = t;
+  }
+}
+class R {
+  constructor(e) {
+    a(this, "method");
+    a(this, "url");
+    a(this, "headers", new Headers());
+    a(this, "body");
+    this.method = e.method, this.body = e.body, e.uri.startsWith("http") ? this.url = new URL(e.uri) : this.url = new URL(e.uri, window.location.origin), this._applyHeaders(e.headers), this._applyQueryParams(e.query);
+  }
+  get isSameOrigin() {
+    return this.url.origin === window.location.origin;
+  }
+  _applyHeaders(e) {
+    if (e != null)
+      if (e instanceof Map || e instanceof Headers)
+        e.forEach((t, s) => {
+          this.headers.set(s, t);
+        });
+      else if (w(e))
+        for (const t in e) {
+          const s = e[t];
+          s instanceof Date ? this.headers.set(t, s.toISOString()) : s != null && this.headers.set(t, String(s));
+        }
+      else
+        throw new TypeError(`Unknown headers type. Got: ${e}`);
+  }
+  _applyQueryParams(e) {
+    if (e != null)
+      if (e instanceof Map || e instanceof URLSearchParams)
+        e.forEach((t, s) => {
+          this.url.searchParams.set(s, t);
+        });
+      else if (w(e))
+        for (const t in e) {
+          const s = e[t];
+          s instanceof Date ? this.url.searchParams.set(t, s.toISOString()) : s != null && this.url.searchParams.set(t, String(s));
+        }
+      else
+        throw new TypeError(`Unknown query params type. Got: ${e}`);
+  }
+}
+class x {
+  constructor(e) {
+    a(this, "_middleware");
+    a(this, "_fetch");
+    a(this, "_request");
+    a(this, "_response");
+    this._middleware = e.middleware, this._fetch = e.fetch, this._request = new R(e);
+  }
+  async fetch() {
+    if (this._middleware.length > 0) {
+      const e = (t = 0) => {
+        const s = this._middleware[t], n = this._middleware[t + 1] ? e(t + 1) : this._handler.bind(this);
+        return async () => s(this._request, async () => (await n(), this._response));
+      };
+      await e()();
+    } else
+      await this._handler();
+    if (this._response.status < 200 || this._response.status >= 400)
+      throw new P(this._response);
+    return this._response;
+  }
+  // This is the function that performs the actual request after the final middleware.
+  async _handler() {
+    let e;
+    const t = this._request;
+    !t.headers.has("content-type") && w(t.body) ? (t.headers.set("content-type", "application/json"), e = JSON.stringify(t.body)) : e = t.body;
+    const s = await this._fetch(t.url.toString(), {
+      method: t.method,
+      headers: t.headers,
+      body: e
+    }), n = s.headers.get("content-type");
+    let u;
+    n != null && n.includes("application/json") ? u = await s.json() : n != null && n.includes("application/x-www-form-urlencoded") ? u = await s.formData() : u = await s.text(), this._response = {
+      method: t.method,
+      url: t.url,
+      status: s.status,
+      statusText: s.statusText,
+      headers: s.headers,
+      body: u
+    };
+  }
+}
+export {
+  O as HTTP,
+  P as HTTPResponseError
+};
+//# sourceMappingURL=http.js.map

package/dist/http.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.js","sources":["../src/http/index.ts"],"sourcesContent":["import { isObject } from \"../typeChecking.js\";\n\n/**\n * A simple HTTP client with middleware support. Middleware applies to all requests made through this store,\n * so it's the perfect way to handle things like auth headers and permission checks for API calls.\n */\nexport class HTTP {\n  #middleware: HTTPMiddleware[] = [];\n  #fetch = getDefaultFetch();\n\n  /**\n   * Adds a new middleware that will apply to subsequent requests.\n   * Returns a function to remove this middleware.\n   *\n   * @param middleware - A middleware function that will intercept requests.\n   */\n  use(fn: HTTPMiddleware) {\n    this.#middleware.push(fn);\n\n    // Call returned function to remove this middleware for subsequent requests.\n    return () => {\n      this.#middleware.splice(this.#middleware.indexOf(fn), 1);\n    };\n  }\n\n  async get<ResBody = unknown>(uri: string, options?: RequestOptions<never>) {\n    return this.#request<ResBody, never>(\"get\", uri, options);\n  }\n\n  async put<ResBody = unknown, ReqBody = unknown>(uri: string, options?: RequestOptions<ReqBody>) {\n    return this.#request<ResBody, ReqBody>(\"put\", uri, options);\n  }\n\n  async patch<ResBody = unknown, ReqBody = unknown>(uri: string, options?: RequestOptions<ReqBody>) {\n    return this.#request<ResBody, ReqBody>(\"patch\", uri, options);\n  }\n\n  async post<ResBody = unknown, ReqBody = unknown>(uri: string, options?: RequestOptions<ReqBody>) {\n    return this.#request<ResBody, ReqBody>(\"post\", uri, options);\n  }\n\n  async delete<ResBody = unknown>(uri: string, options?: RequestOptions<never>) {\n    return this.#request<ResBody, never>(\"delete\", uri, options);\n  }\n\n  async head<ResBody = unknown, ReqBody = unknown>(uri: string, options?: RequestOptions<ReqBody>) {\n    return this.#request<ResBody, ReqBody>(\"head\", uri, options);\n  }\n\n  async options<ResBody = unknown, ReqBody = unknown>(uri: string, options?: RequestOptions<ReqBody>) {\n    return this.#request<ResBody, ReqBody>(\"options\", uri, options);\n  }\n\n  async trace<ResBody = unknown, ReqBody = unknown>(uri: string, options?: RequestOptions<ReqBody>) {\n    return this.#request<ResBody, ReqBody>(\"trace\", uri, options);\n  }\n\n  async #request<ResBody, ReqBody>(method: string, uri: string, options?: RequestOptions<any>) {\n    const runner = new Runner<ResBody, ReqBody>({\n      ...options,\n      method,\n      uri,\n      middleware: this.#middleware,\n      fetch: this.#fetch,\n    });\n    return runner.fetch();\n  }\n}\n\nfunction getDefaultFetch(): typeof window.fetch {\n  if (typeof window !== \"undefined\" && window.fetch) {\n    return window.fetch.bind(window);\n  }\n\n  if (typeof global !== \"undefined\" && global.fetch) {\n    return global.fetch.bind(global);\n  }\n\n  throw new Error(\"Running in neither browser nor node. Please run this app in one of the supported environments.\");\n}\n\n/*====================*\\\n||      Request       ||\n\\*====================*/\n\nexport type HTTPMiddleware = (\n  request: HTTPRequest<unknown>,\n  next: () => Promise<HTTPResponse<unknown>>,\n) => void | Promise<void>;\n\nexport interface RequestOptions<ReqBody> {\n  /**\n   * Body to send with the request.\n   */\n  body?: ReqBody;\n\n  /**\n   * Headers to send with the request.\n   */\n  headers?: Record<string, any> | Headers;\n\n  /**\n   * Query params to interpolate into the URL.\n   */\n  query?: Record<string, any> | URLSearchParams;\n}\n\nexport interface HTTPRequest<Body> {\n  method: string;\n  url: URL;\n  headers: Headers;\n  body: Body;\n}\n\nexport interface HTTPResponse<Body> {\n  method: string;\n  url: URL;\n  headers: Headers;\n  status: number;\n  statusText: string;\n  body: Body;\n}\n\ninterface MakeRequestConfig<ReqBody> extends RequestOptions<ReqBody> {\n  method: string;\n  uri: string;\n  middleware: HTTPMiddleware[];\n  fetch: typeof window.fetch;\n}\n\nexport class HTTPResponseError extends Error {\n  response;\n\n  constructor(response: HTTPResponse<any>) {\n    const { status, statusText, method, url } = response;\n    const message = `${status} ${statusText}: Request failed (${method.toUpperCase()} ${url.toString()})`;\n\n    super(message);\n\n    this.response = response;\n  }\n}\n\nclass Request<ReqBody> implements HTTPRequest<ReqBody> {\n  method: string;\n  url: URL;\n  headers = new Headers();\n  body!: ReqBody;\n\n  get isSameOrigin() {\n    return this.url.origin === window.location.origin;\n  }\n\n  constructor(config: MakeRequestConfig<ReqBody>) {\n    this.method = config.method;\n    this.body = config.body!;\n    if (config.uri.startsWith(\"http\")) {\n      this.url = new URL(config.uri);\n    } else {\n      this.url = new URL(config.uri, window.location.origin);\n    }\n\n    this._applyHeaders(config.headers);\n    this._applyQueryParams(config.query);\n  }\n\n  private _applyHeaders(headers: any) {\n    if (headers == null) return;\n\n    if (headers instanceof Map || headers instanceof Headers) {\n      headers.forEach((value, key) => {\n        this.headers.set(key, value);\n      });\n    } else if (isObject(headers)) {\n      for (const name in headers) {\n        const value = headers[name];\n        if (value instanceof Date) {\n          this.headers.set(name, value.toISOString());\n        } else if (value != null) {\n          this.headers.set(name, String(value));\n        }\n      }\n    } else {\n      throw new TypeError(`Unknown headers type. Got: ${headers}`);\n    }\n  }\n\n  private _applyQueryParams(query: any) {\n    if (query == null) return;\n\n    if (query instanceof Map || query instanceof URLSearchParams) {\n      query.forEach((value, key) => {\n        this.url.searchParams.set(key, value);\n      });\n    } else if (isObject(query)) {\n      for (const name in query) {\n        const value = query[name];\n        if (value instanceof Date) {\n          this.url.searchParams.set(name, value.toISOString());\n        } else if (value != null) {\n          this.url.searchParams.set(name, String(value));\n        }\n      }\n    } else {\n      throw new TypeError(`Unknown query params type. Got: ${query}`);\n    }\n  }\n}\n\nclass Runner<ResBody, ReqBody> {\n  private _middleware;\n  private _fetch;\n\n  private _request: Request<ReqBody>;\n  private _response?: HTTPResponse<ResBody>;\n\n  constructor(config: MakeRequestConfig<ReqBody>) {\n    this._middleware = config.middleware;\n    this._fetch = config.fetch;\n\n    this._request = new Request(config);\n  }\n\n  async fetch() {\n    if (this._middleware.length > 0) {\n      const mount = (index = 0) => {\n        const current = this._middleware[index];\n        const next = this._middleware[index + 1] ? mount(index + 1) : this._handler.bind(this);\n\n        return async () =>\n          current(this._request, async () => {\n            await next();\n            return this._response!;\n          });\n      };\n\n      await mount()();\n    } else {\n      await this._handler();\n    }\n\n    if (this._response!.status < 200 || this._response!.status >= 400) {\n      throw new HTTPResponseError(this._response!);\n    }\n\n    return this._response!;\n  }\n\n  // This is the function that performs the actual request after the final middleware.\n  private async _handler() {\n    let reqBody: BodyInit;\n\n    const req = this._request;\n\n    if (!req.headers.has(\"content-type\") && isObject(req.body)) {\n      // Auto-detect JSON bodies and encode as a string with correct headers.\n      req.headers.set(\"content-type\", \"application/json\");\n      reqBody = JSON.stringify(req.body);\n    } else {\n      reqBody = req.body as BodyInit;\n    }\n\n    const fetched = await this._fetch(req.url.toString(), {\n      method: req.method,\n      headers: req.headers,\n      body: reqBody,\n    });\n\n    // Auto-parse response body based on content-type header\n    const contentType = fetched.headers.get(\"content-type\");\n\n    let body: ResBody;\n\n    if (contentType?.includes(\"application/json\")) {\n      body = await fetched.json();\n    } else if (contentType?.includes(\"application/x-www-form-urlencoded\")) {\n      body = (await fetched.formData()) as ResBody;\n    } else {\n      body = (await fetched.text()) as ResBody;\n    }\n\n    this._response = {\n      method: req.method,\n      url: req.url,\n      status: fetched.status,\n      statusText: fetched.statusText,\n      headers: fetched.headers,\n      body,\n    };\n  }\n}\n"],"names":["HTTP","__privateAdd","_HTTP_instances","_middleware","_fetch","getDefaultFetch","fn","__privateGet","uri","options","__privateMethod","request_fn","method","Runner","HTTPResponseError","response","status","statusText","url","message","__publicField","Request","config","headers","value","key","isObject","name","query","mount","index","current","next","reqBody","req","fetched","contentType","body"],"mappings":"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"}

package/dist/{translate → i18n}/index.d.ts

@@ -1,5 +1,4 @@
-import type { Dolla } from "../core/dolla.js";
-import { type MaybeSignal, type Signal } from "../core/signals-api.js";
+import { type MaybeSignal, type Signal } from "../core/signals.js";
 /**
  * A JSON object of translated strings. Values can be string templates or nested objects.
  */
@@ -64,12 +63,12 @@ export type Formatter = (locale: string, value: unknown, options: Record<string,
 /**
  * Dolla's I(nternationalizatio)n module. Manages language translations and locale-based formatting.
  */
-export declare class I18n {
+declare class I18n {
     #private;
-    readonly locale: Signal<string>;
-    constructor(dolla: Dolla);
+    readonly $locale: Signal<string>;
+    constructor();
     get locales(): string[];
-    setup(options: I18nSetupOptions): void;
+    setup(options: I18nSetupOptions): Promise<void>;
     setLocale(name: string): Promise<void>;
     /**
      * Returns a State containing the value at `key`.
@@ -130,4 +129,6 @@ export declare class I18n {
      */
     list(list: MaybeSignal<Iterable<string>>, options?: Intl.ListFormatOptions): Signal<string>;
 }
+export declare const i18n: I18n;
+export declare const t: (selector: string, options?: TOptions) => Signal<string>;
 export {};