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

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 {};

package/dist/i18n.js

@@ -0,0 +1,318 @@
+var B = Object.defineProperty;
+var D = (o) => {
+  throw TypeError(o);
+};
+var J = (o, t, e) => t in o ? B(o, t, { enumerable: !0, configurable: !0, writable: !0, value: e }) : o[t] = e;
+var O = (o, t, e) => J(o, typeof t != "symbol" ? t + "" : t, e), _ = (o, t, e) => t.has(o) || D("Cannot " + e);
+var i = (o, t, e) => (_(o, t, "read from private field"), e ? e.call(o) : t.get(o)), m = (o, t, e) => t.has(o) ? D("Cannot add the same private member more than once") : t instanceof WeakSet ? t.add(o) : t.set(o, e), N = (o, t, e, n) => (_(o, t, "write to private field"), n ? n.call(o, e) : t.set(o, e), e), g = (o, t, e) => (_(o, t, "access private method"), e);
+import { $, h as K, d as Q, g as x } from "./logger-MPwl-Xqu.js";
+import { b as C, i as j, c as U, t as P } from "./typeChecking-CbltMOUt.js";
+var I, F, p, S, G;
+class W {
+  constructor(t) {
+    m(this, p);
+    O(this, "config");
+    m(this, I, !1);
+    m(this, F, /* @__PURE__ */ new Map());
+    this.config = t;
+  }
+  async load() {
+    let t;
+    if (!i(this, I)) {
+      if (j(this.config.strings))
+        t = this.config.strings;
+      else if (U(this.config.fetch)) {
+        if (t = await this.config.fetch(), !j(t))
+          throw new Error(`Fetch function did not return an object of language strings: ${t}`);
+      } else if (C(this.config.path)) {
+        const e = await fetch(this.config.path);
+        if (e.ok) {
+          const n = await e.json();
+          if (j(n))
+            t = n;
+          else
+            throw new Error(
+              `Language path '${this.config.path}' did not return an object of language strings: ${n}`
+            );
+        } else
+          throw new Error("HTTP request failed.");
+      }
+    }
+    if (t) {
+      const e = g(this, p, S).call(this, t);
+      for (const n of e)
+        i(this, F).set(n[0], n[1]);
+    } else
+      throw new Error("Language could not be loaded.");
+  }
+  getTemplate(t) {
+    return i(this, F).get(t) ?? {
+      segments: [{ type: 0, text: `[MISSING: ${t}]` }]
+    };
+  }
+  hasTemplate(t) {
+    return i(this, F).has(t);
+  }
+}
+I = new WeakMap(), F = new WeakMap(), p = new WeakSet(), S = function(t, e = []) {
+  const n = [];
+  for (const a in t)
+    switch (P(t[a])) {
+      case "string":
+        n.push([[...e, a].join("."), g(this, p, G).call(this, t[a])]);
+        break;
+      case "object":
+        n.push(...g(this, p, S).call(this, t[a], [...e, a]));
+        break;
+      default:
+        throw new Error(
+          `Expected to find a string or object at ${[...e, a].join(".")}. Got: ${P(t[a])}`
+        );
+    }
+  return n;
+}, G = function(t) {
+  let e;
+  ((f) => {
+    f[f.Static = 0] = "Static", f[f.ValueName = 1] = "ValueName", f[f.FormatName = 2] = "FormatName", f[f.FormatOptionName = 3] = "FormatOptionName", f[f.FormatOptionValue = 4] = "FormatOptionValue", f[f.FormatOptionEnd = 5] = "FormatOptionEnd";
+  })(e || (e = {}));
+  const n = {
+    segments: []
+  };
+  let a = "", s = 0, r = 0, c, w, l;
+  const k = () => {
+    c = {
+      type: 1,
+      name: "",
+      formats: []
+    };
+  }, y = () => {
+    w = {
+      name: "",
+      options: {}
+    };
+  };
+  for (; s < t.length; ) {
+    if (r !== 0 && t[s] === " ") {
+      s++;
+      continue;
+    }
+    switch (r) {
+      case 0:
+        t[s] === "{" && t[s + 1] === "{" ? (r = 1, s += 2, a.length > 0 && (n.segments.push({ type: 0, text: a }), a = ""), k()) : (a += t[s], s++);
+        break;
+      case 1:
+        t[s] === "|" ? (r = 2, s += 1, c.name = a, a = "", y()) : t[s] === "}" && t[s + 1] === "}" ? (r = 0, s += 2, c.name = a, a = "", n.segments.push(c)) : (a += t[s], s++);
+        break;
+      case 2:
+        t[s] === "(" ? (r = 3, s += 1, w.name = a, a = "") : t[s] === "}" && t[s + 1] === "}" ? (r = 0, s += 2, c.formats.push(w), n.segments.push(c)) : (a += t[s], s++);
+        break;
+      case 3:
+        t[s] === ")" || (t[s] === ":" ? (r = 4, s += 1, l = a, a = "") : t[s] === "}" && t[s + 1] === "}" || (a += t[s], s++));
+        break;
+      case 4:
+        t[s] === ")" ? (r = 5, s += 1, w.options[l] = a, a = "", c.formats.push(w)) : t[s] === "," ? (r = 3, s += 1, w.options[l] = a, a = "") : t[s] === "}" && t[s + 1] === "}" || (a += t[s], s++);
+        break;
+      case 5:
+        t[s] === "|" ? (r = 2, s += 1, y()) : t[s] === "}" && t[s + 1] === "}" && (r = 0, s += 2, n.segments.push(c));
+        break;
+    }
+  }
+  return r === 0 && a.length > 0 && n.segments.push({ type: 0, text: a }), n;
+};
+var b, h, E, T, v, d, u, H, L, V, M, A;
+class X {
+  constructor() {
+    m(this, u);
+    m(this, b);
+    m(this, h, /* @__PURE__ */ new Map());
+    m(this, E, []);
+    m(this, T, /* @__PURE__ */ new Map());
+    m(this, v, "auto");
+    m(this, d, $("en"));
+    O(this, "$locale", $(i(this, d)));
+    N(this, b, K("dolla.i18n")), this.addFormat("number", (t, e, n) => g(this, u, L).call(this, Number(e), n)), this.addFormat("datetime", (t, e, n) => g(this, u, V).call(this, e, n)), this.addFormat("list", (t, e, n) => g(this, u, M).call(this, e, n));
+  }
+  get locales() {
+    return [...i(this, h).keys()];
+  }
+  async setup(t) {
+    if (t.translations.forEach((e) => {
+      i(this, h).set(e.locale, new W(e));
+    }), t.locale && t.locale !== "auto") {
+      if (!t.translations.some((n) => n.locale === t.locale))
+        throw new Error(`Initial locale '${t.locale}' is not registered in the locales array.`);
+      N(this, v, t.locale);
+    }
+    i(this, b).info(
+      `${i(this, h).size} language${i(this, h).size === 1 ? "" : "s"} supported: '${[...i(this, h).keys()].join("', '")}'`
+    ), i(this, h).size > 0 && await this.setLocale(i(this, v));
+  }
+  async setLocale(t) {
+    var a;
+    let e;
+    if (t === "auto") {
+      let s = [];
+      if (typeof navigator < "u") {
+        const r = navigator;
+        ((a = r.languages) == null ? void 0 : a.length) > 0 ? s.push(...r.languages) : r.language ? s.push(r.language) : r.browserLanguage ? s.push(r.browserLanguage) : r.userLanguage && s.push(r.userLanguage);
+      }
+      for (const r of s)
+        i(this, h).has(r) && (e = r);
+    } else
+      i(this, h).has(t) && (e = t);
+    if (e == null) {
+      const s = i(this, h).keys().next().value;
+      s && (e = s);
+    }
+    if (!e || !i(this, h).has(e))
+      throw new Error(`Locale '${t}' has no translation.`);
+    const n = i(this, h).get(e);
+    try {
+      await n.load(), N(this, E, []), i(this, d).call(this, e), i(this, b).info("set language to " + e);
+    } catch (s) {
+      s instanceof Error && i(this, b).crash(s);
+    }
+  }
+  /**
+     * 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(t, e) {
+    if (this === void 0)
+      throw new Error(
+        `The 't' function cannot be destructured. If you need a standalone version you can import it like so: 'import { t } from "@manyducks.co/dolla"'`
+      );
+    return $(() => {
+      const n = {};
+      for (const a in e)
+        n[a] = x(e[a]);
+      return g(this, u, H).call(this, i(this, d).call(this), t, n);
+    });
+  }
+  /**
+   * 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(t, e) {
+    i(this, T).set(t, e);
+  }
+  /**
+   * 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(t) {
+    return new Intl.Collator(i(this, d).call(this), t);
+  }
+  /**
+   * 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(t, e) {
+    return $(() => g(this, u, L).call(this, x(t), e));
+  }
+  /**
+   * 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(t, e) {
+    return $(() => g(this, u, V).call(this, x(t), e));
+  }
+  /**
+   * 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(t, e) {
+    return $(() => g(this, u, M).call(this, x(t), e));
+  }
+}
+b = new WeakMap(), h = new WeakMap(), E = new WeakMap(), T = new WeakMap(), v = new WeakMap(), d = new WeakMap(), u = new WeakSet(), H = function(t, e, n) {
+  var w;
+  const a = g(this, u, A).call(this, e, n);
+  if (a) return a;
+  const s = i(this, h).get(t);
+  if (n.context != null && (e += "_" + n.context), n.count != null)
+    if (n.ordinal) {
+      const l = `${e}_ordinal_(=${n.count})`;
+      s.hasTemplate(l) ? e = l : e += "_ordinal_" + new Intl.PluralRules(t, { type: "ordinal" }).select(n.count);
+    } else {
+      const l = `${e}_(=${n.count})`;
+      s.hasTemplate(l) ? e = l : e += "_" + new Intl.PluralRules(t).select(n.count);
+    }
+  const r = s.getTemplate(e);
+  let c = "";
+  for (const l of r.segments)
+    if (l.type === 0)
+      c += l.text;
+    else if (l.type === 1) {
+      let k = Y(n, l.name);
+      const y = ((w = n.formatOverrides) == null ? void 0 : w[l.name]) ?? [...l.formats];
+      l.name === "count" && y.length === 0 && y.push({ name: "number", options: {} });
+      for (const f of y) {
+        const R = i(this, T).get(f.name);
+        if (R == null) {
+          const z = new Error(
+            `Failed to load format '${f.name}' when processing '${e}', template: ${r}`
+          );
+          throw i(this, b).crash(z), z;
+        }
+        k = R(t, k, f.options);
+      }
+      c += k;
+    }
+  return c;
+}, L = function(t, e) {
+  return new Intl.NumberFormat(i(this, d).call(this), e).format(t);
+}, V = function(t, e) {
+  return new Intl.DateTimeFormat(i(this, d).call(this), e).format(C(t) ? new Date(t) : t);
+}, M = function(t, e) {
+  return new Intl.ListFormat(i(this, d).call(this), e).format(t);
+}, // relativeTime(): State<string> {
+// }
+A = function(t, e) {
+  for (const n of i(this, E))
+    if (n[0] === t && Q(n[1], e))
+      return n[2];
+};
+function Y(o, t) {
+  const e = String(t).split(/[\.\[\]]/).filter((a) => a.trim() !== "");
+  let n = o;
+  for (; e.length > 0; ) {
+    const a = e.shift();
+    n != null ? n = n[a] : n = void 0;
+  }
+  return n;
+}
+const q = new X(), st = q.t.bind(q);
+export {
+  q as i18n,
+  st as t
+};
+//# sourceMappingURL=i18n.js.map