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

package/dist/hooks/index.d.ts

@@ -0,0 +1,64 @@
+import { Context, Logger, type Ref, type Store } from "../core";
+import { type EffectFn, MaybeSignal, type Signal } from "../core/signals";
+/**
+ * Returns the Context object of the View, Store or Mixin this hook is called in.
+ */
+export declare function useContext(): Context;
+/**
+ * Returns a logger. If a name is passed it will be used as a prefix for all console messages.
+ * Otherwise the default name of the context will be used.
+ */
+export declare function useLogger(name?: MaybeSignal<string>): Logger;
+/**
+ * Sets the value of the Signal it is bound to.
+ */
+export interface Setter<T> {
+    (value: T): void;
+    (fn: (current: T) => T): void;
+}
+/**
+ * Creates a new read-only Signal and a bound Setter function.
+ */
+export declare function useState<T>(value: T): [Signal<T>, Setter<T>];
+/**
+ * Creates a new read-only Signal and a bound Setter function.
+ */
+export declare function useState<T>(): [Signal<T | undefined>, Setter<T | undefined>];
+export declare function useMemo<T>(compute: (current?: T) => T, deps?: Signal<any>[]): Signal<T>;
+export declare function useEffect(fn: EffectFn, deps?: Signal<any>[]): void;
+/**
+ * Takes the current state and a dispatched action. Returns a new state based on the action.
+ * Typically the body of this function will be a large switch statement.
+ */
+export type ReducerFn<State, Action> = (state: State, action: Action) => State;
+/**
+ * Dispatches an action to this reducer, causing the state to update.
+ */
+export type DispatchFn<Action> = (action: Action) => void;
+/**
+ *
+ */
+export declare function useReducer<State, Action>(reducer: ReducerFn<State, Action>, initialState: State): [Signal<State>, DispatchFn<Action>];
+/**
+ * Uses a previously added Store. Takes the Store function itself and returns the nearest instance.
+ */
+export declare function useStore<T>(store: Store<any, T>): T;
+/**
+ * A hybrid Ref which is both a function ref and a React-style object ref with a `current` property.
+ * Both the `current` property and the function syntax access the same value.
+ */
+export interface HybridRef<T> extends Ref<T> {
+    current: T;
+}
+/**
+ * Creates a Ref. Useful for getting references to DOM nodes.
+ */
+export declare function useRef<T>(initialValue?: T): HybridRef<T>;
+/**
+ * Calls `callback` when the context is mounted. If `callback` returns a function, that function is called when the context is unmounted.
+ */
+export declare function useMount(callback: () => void | (() => void)): void;
+/**
+ * Calls `callback` when the context is unmounted.
+ */
+export declare function useUnmount(callback: () => void): void;

package/dist/hooks/index.test.d.ts

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

package/dist/hooks.js

@@ -0,0 +1,69 @@
+import { $ as u, g as c, u as s, c as a } from "./signals-gCwiIe5X.js";
+import { r as x } from "./ref-BD79iqlg.js";
+function o() {
+  const t = a();
+  if (!t)
+    throw new Error("No context found; hooks can only be called in the body of a View, Store or Mixin.");
+  return t;
+}
+function m(t) {
+  const e = o();
+  return t && e.setName(t), e;
+}
+function l(t) {
+  o();
+  const e = u(t);
+  return [() => e(), e];
+}
+function p(t, e) {
+  return o(), e ? u(function() {
+    for (const n of e) c(n);
+    return s(() => t(this.value));
+  }) : u(function() {
+    return t(this.value);
+  });
+}
+function S(t, e) {
+  const n = o();
+  e ? n.effect(() => {
+    for (const r of e) c(r);
+    s(t);
+  }) : n.effect(t);
+}
+function v(t, e) {
+  const [n, r] = l(e);
+  return [n, (f) => {
+    r((i) => t(i, f));
+  }];
+}
+function M(t) {
+  return o().getStore(t);
+}
+function b(...t) {
+  o();
+  const e = x(...t);
+  return Object.defineProperty(e, "current", { get: e, set: e }), e;
+}
+function w(t) {
+  const e = o();
+  e.onMount(() => {
+    const n = t();
+    n && e.onUnmount(n);
+  });
+}
+function y(t) {
+  o().onUnmount(t);
+}
+export {
+  o as useContext,
+  S as useEffect,
+  m as useLogger,
+  p as useMemo,
+  w as useMount,
+  v as useReducer,
+  b as useRef,
+  l as useState,
+  M as useStore,
+  y as useUnmount
+};
+//# sourceMappingURL=hooks.js.map

package/dist/hooks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.js","sources":["../src/hooks/index.ts"],"sourcesContent":["import { Context, Logger, ref, type Ref, type Store } from \"../core\";\nimport { $, type EffectFn, get, getCurrentContext, MaybeSignal, type Signal, untracked } from \"../core/signals\";\n\n/**\n * Returns the Context object of the View, Store or Mixin this hook is called in.\n */\nexport function useContext(): Context {\n  const context = getCurrentContext();\n  if (!context) {\n    throw new Error(`No context found; hooks can only be called in the body of a View, Store or Mixin.`);\n  }\n  return context;\n}\n\n/**\n * Returns a logger. If a name is passed it will be used as a prefix for all console messages.\n * Otherwise the default name of the context will be used.\n */\nexport function useLogger(name?: MaybeSignal<string>): Logger {\n  const context = useContext();\n  if (name) context.setName(name);\n  return context;\n}\n\n/**\n * Sets the value of the Signal it is bound to.\n */\nexport interface Setter<T> {\n  (value: T): void;\n  (fn: (current: T) => T): void;\n}\n\n/**\n * Creates a new read-only Signal and a bound Setter function.\n */\nexport function useState<T>(value: T): [Signal<T>, Setter<T>];\n\n/**\n * Creates a new read-only Signal and a bound Setter function.\n */\nexport function useState<T>(): [Signal<T | undefined>, Setter<T | undefined>];\n\nexport function useState<T>(value?: T): [Signal<T>, Setter<T>] {\n  useContext(); // assert that we're in a valid context\n  const $value = $(value);\n  return [() => $value() as T, $value];\n}\n\nexport function useMemo<T>(compute: (current?: T) => T, deps?: Signal<any>[]): Signal<T> {\n  useContext(); // assert that we're in a valid context\n  if (deps) {\n    return $(function () {\n      // Track deps and run `compute` untracked.\n      for (const dep of deps) get(dep);\n      return untracked(() => compute(this.value));\n    });\n  } else {\n    return $(function () {\n      return compute(this.value);\n    });\n  }\n}\n\nexport function useEffect(fn: EffectFn, deps?: Signal<any>[]): void {\n  const context = useContext();\n  if (deps) {\n    context.effect(() => {\n      // Track deps and run `fn` untracked.\n      for (const dep of deps) get(dep);\n      untracked(fn);\n    });\n  } else {\n    context.effect(fn);\n  }\n}\n\n// TODO: What would layout effect even mean in dolla?\n// export function useLayoutEffect() {}\n\n/**\n * Takes the current state and a dispatched action. Returns a new state based on the action.\n * Typically the body of this function will be a large switch statement.\n */\nexport type ReducerFn<State, Action> = (state: State, action: Action) => State;\n\n/**\n * Dispatches an action to this reducer, causing the state to update.\n */\nexport type DispatchFn<Action> = (action: Action) => void;\n\n/**\n *\n */\nexport function useReducer<State, Action>(\n  reducer: ReducerFn<State, Action>,\n  initialState: State,\n): [Signal<State>, DispatchFn<Action>] {\n  const [state, setState] = useState(initialState);\n  const dispatch = (action: Action) => {\n    setState((current) => reducer(current, action));\n  };\n  return [state, dispatch];\n}\n\n/**\n * Uses a previously added Store. Takes the Store function itself and returns the nearest instance.\n */\nexport function useStore<T>(store: Store<any, T>): T {\n  const context = useContext();\n  return context.getStore(store);\n}\n\n/**\n * A hybrid Ref which is both a function ref and a React-style object ref with a `current` property.\n * Both the `current` property and the function syntax access the same value.\n */\nexport interface HybridRef<T> extends Ref<T> {\n  current: T;\n}\n\n/**\n * Creates a Ref. Useful for getting references to DOM nodes.\n */\nexport function useRef<T>(initialValue?: T): HybridRef<T>;\n\nexport function useRef<T>(...value: [T]): HybridRef<T> {\n  useContext(); // assert that we're in a valid context\n  const valueRef = ref(...value);\n  Object.defineProperty(valueRef, \"current\", { get: valueRef, set: valueRef });\n  return valueRef as HybridRef<T>;\n}\n\n/**\n * Calls `callback` when the context is mounted. If `callback` returns a function, that function is called when the context is unmounted.\n */\nexport function useMount(callback: () => void | (() => void)): void {\n  const context = useContext();\n  context.onMount(() => {\n    const result = callback();\n    if (result) context.onUnmount(result);\n  });\n}\n\n/**\n * Calls `callback` when the context is unmounted.\n */\nexport function useUnmount(callback: () => void): void {\n  const context = useContext();\n  context.onUnmount(callback);\n}\n"],"names":["useContext","context","getCurrentContext","useLogger","name","useState","value","$value","$","useMemo","compute","deps","dep","get","untracked","useEffect","fn","useReducer","reducer","initialState","state","setState","action","current","useStore","store","useRef","valueRef","ref","useMount","callback","result","useUnmount"],"mappings":";;AAMO,SAASA,IAAsB;AACpC,QAAMC,IAAUC,EAAkB;AAClC,MAAI,CAACD;AACG,UAAA,IAAI,MAAM,mFAAmF;AAE9F,SAAAA;AACT;AAMO,SAASE,EAAUC,GAAoC;AAC5D,QAAMH,IAAUD,EAAW;AACvB,SAAAI,KAAcH,EAAA,QAAQG,CAAI,GACvBH;AACT;AAoBO,SAASI,EAAYC,GAAmC;AAClD,EAAAN,EAAA;AACL,QAAAO,IAASC,EAAEF,CAAK;AACtB,SAAO,CAAC,MAAMC,EAAO,GAAQA,CAAM;AACrC;AAEgB,SAAAE,EAAWC,GAA6BC,GAAiC;AAEvF,SADWX,EAAA,GACPW,IACKH,EAAE,WAAY;AAER,eAAAI,KAAOD,EAAM,CAAAE,EAAID,CAAG;AAC/B,WAAOE,EAAU,MAAMJ,EAAQ,KAAK,KAAK,CAAC;AAAA,EAAA,CAC3C,IAEMF,EAAE,WAAY;AACZ,WAAAE,EAAQ,KAAK,KAAK;AAAA,EAAA,CAC1B;AAEL;AAEgB,SAAAK,EAAUC,GAAcL,GAA4B;AAClE,QAAMV,IAAUD,EAAW;AAC3B,EAAIW,IACFV,EAAQ,OAAO,MAAM;AAER,eAAAW,KAAOD,EAAM,CAAAE,EAAID,CAAG;AAC/B,IAAAE,EAAUE,CAAE;AAAA,EAAA,CACb,IAEDf,EAAQ,OAAOe,CAAE;AAErB;AAmBgB,SAAAC,EACdC,GACAC,GACqC;AACrC,QAAM,CAACC,GAAOC,CAAQ,IAAIhB,EAASc,CAAY;AAIxC,SAAA,CAACC,GAHS,CAACE,MAAmB;AACnC,IAAAD,EAAS,CAACE,MAAYL,EAAQK,GAASD,CAAM,CAAC;AAAA,EAChD,CACuB;AACzB;AAKO,SAASE,EAAYC,GAAyB;AAE5C,SADSzB,EAAW,EACZ,SAASyB,CAAK;AAC/B;AAeO,SAASC,KAAapB,GAA0B;AAC1C,EAAAN,EAAA;AACL,QAAA2B,IAAWC,EAAI,GAAGtB,CAAK;AACtB,gBAAA,eAAeqB,GAAU,WAAW,EAAE,KAAKA,GAAU,KAAKA,GAAU,GACpEA;AACT;AAKO,SAASE,EAASC,GAA2C;AAClE,QAAM7B,IAAUD,EAAW;AAC3B,EAAAC,EAAQ,QAAQ,MAAM;AACpB,UAAM8B,IAASD,EAAS;AACpB,IAAAC,KAAgB9B,EAAA,UAAU8B,CAAM;AAAA,EAAA,CACrC;AACH;AAKO,SAASC,EAAWF,GAA4B;AAErD,EADgB9B,EAAW,EACnB,UAAU8B,CAAQ;AAC5B;"}

package/dist/{modules/http.d.ts → http/index.d.ts}

@@ -37,18 +37,16 @@ export interface RequestOptions<ReqBody> {
 }
 export interface HTTPRequest<Body> {
     method: string;
-    uri: string;
-    readonly sameOrigin: boolean;
+    url: URL;
     headers: Headers;
-    query: URLSearchParams;
     body: Body;
 }
 export interface HTTPResponse<Body> {
     method: string;
-    uri: string;
+    url: URL;
+    headers: Headers;
     status: number;
     statusText: string;
-    headers: Record<string, string>;
     body: Body;
 }
 export declare class HTTPResponseError extends Error {

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 { i as w } from "./typeChecking-CbltMOUt.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/i18n/index.d.ts

@@ -0,0 +1,134 @@
+import { type MaybeSignal, type Signal } from "../core/signals.js";
+/**
+ * A JSON object of translated strings. Values can be string templates or nested objects.
+ */
+interface LocalizedStrings extends Record<string, string | LocalizedStrings> {
+}
+/**
+ * A formatter to be applied to a variable.
+ */
+type Format = {
+    name: string;
+    options: Record<string, any>;
+};
+export interface TranslationConfig {
+    /**
+     * Name of the locale this translation is for (BCP 47 locale names recommended).
+     */
+    locale: string;
+    /**
+     * An object with translated strings for this language.
+     */
+    strings?: LocalizedStrings;
+    /**
+     * A callback function that returns a Promise that resolves to the translation object for this language.
+     */
+    fetch?: () => Promise<LocalizedStrings>;
+    /**
+     * Path to a JSON file with translated strings for this language.
+     */
+    path?: string;
+}
+export type I18nSetupOptions = {
+    /**
+     * Default locale to load on startup
+     */
+    locale?: string | null;
+    translations: TranslationConfig[];
+};
+export type TOptions = {
+    /**
+     *
+     */
+    count?: MaybeSignal<number>;
+    /**
+     *
+     */
+    context?: MaybeSignal<string>;
+    /**
+     * Override formats specified in the template with the ones in the array for each named variable.
+     *
+     * @example
+     * t("example_key", {
+     *   count: 5,
+     *   formatOverrides: {
+     *     count: [ { name: "datetime", options: { style: "currency", currency: "JPY" } } ]
+     *   }
+     * });
+     */
+    formatOverrides?: MaybeSignal<Record<string, Record<string, Format[]>>>;
+    [value: string]: MaybeSignal<any>;
+};
+export type Formatter = (locale: string, value: unknown, options: Record<string, any>) => string;
+/**
+ * Dolla's I(nternationalizatio)n module. Manages language translations and locale-based formatting.
+ */
+declare class I18n {
+    #private;
+    readonly $locale: Signal<string>;
+    constructor();
+    get locales(): string[];
+    setup(options: I18nSetupOptions): Promise<void>;
+    setLocale(name: string): Promise<void>;
+    /**
+     * Returns a State containing the value at `key`.
+  
+     * @param selector - Key to the translated value.
+     * @param options - A map of `{{placeholder}}` names and the values to replace them with.
+     *
+     * @example
+     * const $value = t("your.key.here", { count: 5 });
+     */
+    t(selector: string, options?: TOptions): Signal<string>;
+    /**
+     * Add a custom format callback.
+     *
+     * @example
+     * Dolla.i18n.addFormat("uppercase", (locale, value, options) => {
+     *   return value.toUpperCase();
+     * });
+     *
+     * {
+     *   "greeting": "Hello, {{name|uppercase}}!"
+     * }
+     *
+     * t("greeting", {name: "world"}); // State<"Hello, WORLD!">
+     */
+    addFormat(name: string, callback: (locale: string, value: unknown, options: Record<string, any>) => string): void;
+    /**
+     * Creates an `Intl.Collator` configured for the current locale.
+     * NOTE: The locale is tracked if called within a signal tracking context.
+     *
+     * @see https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Intl/Collator/Collator#options
+     */
+    collator(options?: Intl.CollatorOptions): Intl.Collator;
+    /**
+     * Formats a number for the current locale. Uses `Intl.NumberFormat` under the hood.
+     *
+     * @see https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Intl/NumberFormat/NumberFormat#options
+     */
+    number(count: MaybeSignal<number | bigint>, options?: Intl.NumberFormatOptions): Signal<string>;
+    /**
+     * Formats a date for the current locale. Uses `Intl.DateTimeFormat` under the hood.
+     *
+     * @see https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Intl/DateTimeFormat/DateTimeFormat#options
+     *
+     * @example
+     * const date = new Date();
+     * const $formatted = Dolla.i18n.dateTime(date, { dateFormat: "short" });
+     */
+    dateTime(date?: MaybeSignal<string | number | Date | undefined>, options?: Intl.DateTimeFormatOptions): Signal<string>;
+    /**
+     * Formats a list for the current locale. Uses `Intl.ListFormat` under the hood.
+     *
+     * @see https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Intl/DateTimeFormat/DateTimeFormat#options
+     *
+     * @example
+     * const list = new Date();
+     * const $formatted = Dolla.i18n.list(list, {  });
+     */
+    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 {};