@manyducks.co/dolla 2.0.0-alpha.8 → 2.0.0

package/dist/core/signals.d.ts

@@ -0,0 +1,100 @@
+import { Context } from "./context";
+export declare function getCurrentContext(): Context | undefined;
+export declare function setCurrentContext(context: Context | undefined): Context | undefined;
+/**
+ * A function that returns the current value of a signal.
+ * Automatically tracked as a dependency when called within a tracking scope (such as `memo` or `effect` functions).
+ */
+export interface Signal<T> {
+    (): T;
+}
+/**
+ * A function that sets the value of the signal.
+ */
+export interface Setter<T> {
+    (value: T | ((previousValue: T) => T)): void;
+}
+/**
+ * A getter and setter in a single object. Callable like a getter, but includes a `set` method for updating the signal's value.
+ */
+export interface Writable<T> extends Signal<T> {
+    set: Setter<T>;
+}
+/**
+ * Utility type for a value that may be a getter or a plain value.
+ * This value can be unwrapped to a plain value with `get` or `untracked` (depending on whether you're in a tracking context and need to track it).
+ */
+export type MaybeSignal<T> = Signal<T> | T;
+export type EqualityFn<T> = (previousValue: T, nextValue: 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 writable<T>(): Writable<T | undefined>;
+export declare function writable<T>(initialValue: undefined, options: SignalOptions<T | undefined>): Writable<T | undefined>;
+export declare function writable<T>(initialValue: T, options?: SignalOptions<T>): Writable<T>;
+/**
+ * Ensures that a value is a read-only signal.
+ *
+ * @example
+ * const $number = readable(5); // converts plain values to signals
+ *
+ * const $number = writable(5);
+ * const $value = readable($number);
+ * $number(); // 5
+ * $value(); // 5
+ * $number.set(6);
+ * $number(); // 6
+ * $value(); // 6 (tracks value but can't be written)
+ */
+export declare function readable<T>(signal: MaybeSignal<T>): Signal<T>;
+/**
+ * Creates a new signal, returning a getter and setter pair.
+ *
+ * @example
+ * const [$count, setCount] = signal(0);
+ */
+export declare function signal<T>(initialValue: T, options?: SignalOptions<T>): [Signal<T>, Setter<T>];
+export declare function signal<T>(initialValue: undefined, options: SignalOptions<T>): [Signal<T | undefined>, Setter<T | undefined>];
+export declare function signal<T>(): [Signal<T | undefined>, Setter<T | undefined>];
+export interface MemoOptions<T> extends SignalOptions<T> {
+    /**
+     * An array of signals this `memo` depends on. If this is passed, calls to signals within `fn` will NOT be tracked.
+     * Instead the `deps` array will be tracked and `fn` will re-run when any value in `deps` changes.
+     */
+    deps?: Signal<any>[];
+}
+/**
+ * Creates a derived signal that recomputes its value only when its dependencies change.
+ * Subsequent calls will return a cached value.
+ * Dependencies are tracked when called inside `fn` by default,
+ * but can be overridden by passing a `deps` array in the options object.
+ */
+export declare function memo<T>(compute: (previousValue?: T) => MaybeSignal<T>, options?: MemoOptions<T>): Signal<T>;
+/**
+ * Suspends effects during `fn`. Effects for all updated Signal values are called at the end of the batch.
+ */
+export declare function batch(fn: () => void): void;
+/**
+ * Call a Signal function without tracking its value.
+ */
+export declare function untracked<T>(value: MaybeSignal<T>): T;
+/**
+ * Unwraps the plain value from a Signal. If the value is not a Signal it is returned as-is.
+ */
+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 clean up the effect.
+ * If you are using an effect inside a View or Store, try the `useEffect` hook instead, which cleans up automatically when the component unmounts.
+ */
+export declare function effect(fn: EffectFn): UnsubscribeFn;

package/dist/core/signals.test.d.ts

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

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

@@ -1,7 +1,7 @@
 /**
  * Props passed to the crash view when a crash occurs.
  */
-export type CrashViewProps = {
+export interface CrashViewProps {
     /**
      * JavaScript Error object.
      */
@@ -13,6 +13,13 @@ export type CrashViewProps = {
     /**
      * Unique identifier to pinpoint the specific view that reported the crash.
      */
-    uid?: string;
-};
-export declare function DefaultCrashView(props: CrashViewProps): import("../markup.js").Markup | import("../markup.js").Markup[];
+    tag?: string;
+    /**
+     * Label for the tag.
+     */
+    tagName?: string;
+}
+/**
+ * The crash view displayed unless you specify your own.
+ */
+export declare function DefaultCrashView(props: CrashViewProps): import("../markup.js").Markup<string | import("../index.js").View<any>>;

package/dist/core/views/for.d.ts

@@ -0,0 +1,21 @@
+import { type Key, RenderFn, RepeatNode } from "../nodes/repeat";
+import { type MaybeSignal } from "../signals";
+export interface ForProps<T> {
+    /**
+     * An array of items to render.
+     */
+    each: MaybeSignal<T[]>;
+    /**
+     * A function to extract a unique key that identifies each item.
+     * If no `key` function is passed, object identity (===) will be used.
+     */
+    key?: (item: T, index: number) => Key;
+    /**
+     * A render function. Takes the item and its index in signal form and returns something to display for each item.
+     */
+    children: RenderFn<T>;
+}
+/**
+ *
+ */
+export declare function For<T>(props: ForProps<T>): RepeatNode<T>;

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

@@ -0,0 +1,7 @@
+import type { Renderable } from "../../types.js";
+/**
+ * A utility view that displays its children.
+ */
+export declare function Fragment(props: {
+    children?: Renderable;
+}): Renderable;

package/dist/core/views/portal.d.ts

@@ -0,0 +1,16 @@
+import type { Renderable } from "../../types";
+import { Markup, MarkupType } from "../markup";
+export interface PortalProps {
+    /**
+     * The parent element or a selector that will match it.
+     */
+    into: Element | string;
+    /**
+     * Content to render inside the `into` element.
+     */
+    children: Renderable;
+}
+/**
+ * Render content into any element on the page.
+ */
+export declare function Portal(props: PortalProps): Markup<MarkupType.Portal>;

package/dist/core/views/show.d.ts

@@ -0,0 +1,25 @@
+import type { Renderable } from "../../types";
+import { DynamicNode } from "../nodes/dynamic";
+import { type MaybeSignal } from "../signals";
+export interface ShowProps {
+    /**
+     * If present, children will be rendered only when this signal holds a truthy value.
+     */
+    when?: MaybeSignal<any>;
+    /**
+     * If present, children will be rendered only when this signal holds a falsy value.
+     */
+    unless?: MaybeSignal<any>;
+    /**
+     * Content to render if conditions permit.
+     */
+    children: Renderable;
+    /**
+     * Content to render when conditions don't permit `children` to render.
+     */
+    fallback?: Renderable;
+}
+/**
+ * Conditionally display children.
+ */
+export declare function Show(props: ShowProps): DynamicNode;

package/dist/fragment-BahD_BJA.js

@@ -0,0 +1,7 @@
+function r(n) {
+  return n.children;
+}
+export {
+  r as F
+};
+//# sourceMappingURL=fragment-BahD_BJA.js.map

package/dist/fragment-BahD_BJA.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fragment-BahD_BJA.js","sources":["../src/core/views/fragment.ts"],"sourcesContent":["import type { Renderable } from \"../../types.js\";\n\n/**\n * A utility view that displays its children.\n */\nexport function Fragment(props: { children?: Renderable }) {\n  return props.children;\n}\n"],"names":["Fragment","props"],"mappings":"AAKO,SAASA,EAASC,GAAkC;AACzD,SAAOA,EAAM;AACf;"}

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,150 @@
+import { a } from "./typeChecking-5kmX0ulW.js";
+class p {
+  #t = [];
+  #s = h();
+  /**
+   * 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 this.#t.push(e), () => {
+      this.#t.splice(this.#t.indexOf(e), 1);
+    };
+  }
+  async get(e, t) {
+    return this.#e("get", e, t);
+  }
+  async put(e, t) {
+    return this.#e("put", e, t);
+  }
+  async patch(e, t) {
+    return this.#e("patch", e, t);
+  }
+  async post(e, t) {
+    return this.#e("post", e, t);
+  }
+  async delete(e, t) {
+    return this.#e("delete", e, t);
+  }
+  async head(e, t) {
+    return this.#e("head", e, t);
+  }
+  async options(e, t) {
+    return this.#e("options", e, t);
+  }
+  async trace(e, t) {
+    return this.#e("trace", e, t);
+  }
+  async #e(e, t, s) {
+    return new u({
+      ...s,
+      method: e,
+      uri: t,
+      middleware: this.#t,
+      fetch: this.#s
+    }).fetch();
+  }
+}
+function h() {
+  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 l extends Error {
+  response;
+  constructor(e) {
+    const { status: t, statusText: s, method: r, url: n } = e, o = `${t} ${s}: Request failed (${r.toUpperCase()} ${n.toString()})`;
+    super(o), this.response = e;
+  }
+}
+class c {
+  method;
+  url;
+  headers = new Headers();
+  body;
+  get isSameOrigin() {
+    return this.url.origin === window.location.origin;
+  }
+  constructor(e) {
+    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);
+  }
+  _applyHeaders(e) {
+    if (e != null)
+      if (e instanceof Map || e instanceof Headers)
+        e.forEach((t, s) => {
+          this.headers.set(s, t);
+        });
+      else if (a(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 (a(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 u {
+  _middleware;
+  _fetch;
+  _request;
+  _response;
+  constructor(e) {
+    this._middleware = e.middleware, this._fetch = e.fetch, this._request = new c(e);
+  }
+  async fetch() {
+    if (this._middleware.length > 0) {
+      const e = (t = 0) => {
+        const s = this._middleware[t], r = this._middleware[t + 1] ? e(t + 1) : this._handler.bind(this);
+        return async () => s(this._request, async () => (await r(), this._response));
+      };
+      await e()();
+    } else
+      await this._handler();
+    if (this._response.status < 200 || this._response.status >= 400)
+      throw new l(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") && a(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
+    }), r = s.headers.get("content-type");
+    let n;
+    r?.includes("application/json") ? n = await s.json() : r?.includes("application/x-www-form-urlencoded") ? n = await s.formData() : n = await s.text(), this._response = {
+      method: t.method,
+      url: t.url,
+      status: s.status,
+      statusText: s.statusText,
+      headers: s.headers,
+      body: n
+    };
+  }
+}
+export {
+  p as HTTP,
+  l 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","#middleware","#fetch","getDefaultFetch","fn","uri","options","#request","method","Runner","HTTPResponseError","response","status","statusText","url","message","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 {};