@wow-two-beta/ui-vue 0.0.2

package/dist/foundation/http/index.d.ts

@@ -0,0 +1,9 @@
+export * from './ApiResponse';
+export * from './Page';
+export * from './ProblemDetails';
+export * from './ApiError';
+export * from './Envelope';
+export * from './DateBrands';
+export * from './temporalReviver';
+export * from './CreateApiClient';
+export * from './FieldErrors';

package/dist/foundation/http/index.js

@@ -0,0 +1,180 @@
+import { A as ApiError } from "../../chunks/ApiError-l0YdcqqV.js";
+import { Temporal } from "temporal-polyfill";
+import { g as getErrorMessage } from "../../chunks/ErrorMessage-Cqt7WaFn.js";
+import { i as isAbortError } from "../../chunks/ErrorRecognizers-oTklha6D.js";
+import { shouldRetry, computeRetryDelay } from "../resilience/index.js";
+import { a, f } from "../../chunks/FieldErrors-2zjhia4U.js";
+const isJsonObject = (parsed) => parsed !== null && typeof parsed === "object" && !Array.isArray(parsed);
+const wowTwoEnvelope = {
+  unwrap: (parsed) => isJsonObject(parsed) && "data" in parsed ? parsed["data"] : parsed,
+  toError: (parsed, response) => new ApiError(response.status, isJsonObject(parsed) ? parsed : null)
+};
+const rawEnvelope = {
+  unwrap: (parsed) => parsed,
+  toError: (_parsed, response) => new ApiError(response.status, null, response.statusText || void 0)
+};
+const INSTANT = /^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}(:\d{2})?(\.\d+)?(Z|[+-]\d{2}:\d{2})$/;
+const PLAIN_DATE = /^\d{4}-\d{2}-\d{2}$/;
+const PLAIN_TIME = /^\d{2}:\d{2}(:\d{2})?(\.\d+)?$/;
+const DURATION = /^-?P(?=[\dT])(\d+Y)?(\d+M)?(\d+W)?(\d+D)?(T(\d+H)?(\d+M)?(\d+(\.\d+)?S)?)?$/;
+function temporalReviver(_key, value) {
+  if (typeof value !== "string") return value;
+  if (INSTANT.test(value)) {
+    try {
+      return Temporal.Instant.from(value);
+    } catch {
+      return value;
+    }
+  }
+  if (PLAIN_DATE.test(value)) {
+    try {
+      return Temporal.PlainDate.from(value);
+    } catch {
+      return value;
+    }
+  }
+  if (PLAIN_TIME.test(value)) {
+    try {
+      return Temporal.PlainTime.from(value);
+    } catch {
+      return value;
+    }
+  }
+  if (DURATION.test(value)) {
+    try {
+      return Temporal.Duration.from(value);
+    } catch {
+      return value;
+    }
+  }
+  return value;
+}
+function parseJson(text) {
+  return JSON.parse(text, temporalReviver);
+}
+const JsonMime = "application/json";
+function buildQueryString(query) {
+  const params = new URLSearchParams();
+  for (const [key, value] of Object.entries(query)) {
+    for (const item of Array.isArray(value) ? value : [value]) {
+      if (item != null) params.append(key, String(item));
+    }
+  }
+  return params.toString();
+}
+function wait(ms, signal) {
+  return new Promise((resolve, reject) => {
+    const abortReason = () => signal?.reason ?? new DOMException("The operation was aborted.", "AbortError");
+    if (signal?.aborted) {
+      reject(abortReason());
+      return;
+    }
+    const timer = setTimeout(() => {
+      signal?.removeEventListener("abort", onAbort);
+      resolve();
+    }, ms);
+    const onAbort = () => {
+      clearTimeout(timer);
+      reject(abortReason());
+    };
+    signal?.addEventListener("abort", onAbort, { once: true });
+  });
+}
+async function readErrorBody(response) {
+  try {
+    const text = await response.text();
+    return text === "" ? void 0 : JSON.parse(text);
+  } catch {
+    return void 0;
+  }
+}
+function createApiClient(options = {}) {
+  const {
+    baseUrl = "",
+    getAuthToken,
+    credentials,
+    onUnauthorized,
+    defaultHeaders,
+    reviveTemporal = false,
+    envelope = wowTwoEnvelope,
+    retry = false
+  } = options;
+  const buildHeaders = async (init, hasJsonBody) => {
+    const headers = new Headers({ Accept: JsonMime });
+    if (hasJsonBody) headers.set("Content-Type", JsonMime);
+    if (defaultHeaders) new Headers(defaultHeaders).forEach((value, key) => headers.set(key, value));
+    const token = getAuthToken ? await getAuthToken() : null;
+    if (token != null) headers.set("Authorization", `Bearer ${token}`);
+    if (init.headers) new Headers(init.headers).forEach((value, key) => headers.set(key, value));
+    return headers;
+  };
+  const attempt = async (url, init, body, hasJsonBody) => {
+    const headers = await buildHeaders(init, hasJsonBody);
+    const doFetch = options.fetch ?? globalThis.fetch;
+    let response;
+    try {
+      response = await doFetch(url, {
+        method: init.method ?? "GET",
+        headers,
+        // `?? null` lets callers pass an optional signal directly under exactOptionalPropertyTypes.
+        signal: init.signal ?? null,
+        ...credentials !== void 0 ? { credentials } : {},
+        ...body !== void 0 ? { body } : {}
+      });
+    } catch (error) {
+      if (isAbortError(error)) throw error;
+      throw new ApiError(0, null, getErrorMessage(error, "Network request failed"));
+    }
+    if (!response.ok) throw envelope.toError(await readErrorBody(response), response);
+    const text = await response.text();
+    if (text === "") return void 0;
+    const parsed = reviveTemporal ? parseJson(text) : JSON.parse(text);
+    if (init.unwrap === false) return parsed;
+    return envelope.unwrap(parsed, response);
+  };
+  const request = async (path, init = {}) => {
+    const queryString = init.query ? buildQueryString(init.query) : "";
+    const url = `${baseUrl}${path}${queryString ? (path.includes("?") ? "&" : "?") + queryString : ""}`;
+    const isFormData = typeof FormData !== "undefined" && init.body instanceof FormData;
+    const body = init.body === void 0 ? void 0 : isFormData ? init.body : JSON.stringify(init.body);
+    let retries = 0;
+    let previousDelayMs = 0;
+    for (; ; ) {
+      try {
+        return await attempt(url, init, body, init.body !== void 0 && !isFormData);
+      } catch (error) {
+        if (!(error instanceof ApiError)) throw error;
+        if (retry !== false && shouldRetry(retry, retries, error.status)) {
+          const attemptNumber = retries + 1;
+          const delayMs = computeRetryDelay(retry, attemptNumber, previousDelayMs);
+          retry.onRetry?.({ attempt: attemptNumber, error, status: error.status, delayMs });
+          await wait(delayMs, init.signal);
+          previousDelayMs = delayMs;
+          retries = attemptNumber;
+          continue;
+        }
+        if (error.status === 401) onUnauthorized?.(error);
+        throw error;
+      }
+    }
+  };
+  return {
+    request,
+    get: (path, init) => request(path, { ...init, method: "GET" }),
+    post: (path, init) => request(path, { ...init, method: "POST" }),
+    put: (path, init) => request(path, { ...init, method: "PUT" }),
+    patch: (path, init) => request(path, { ...init, method: "PATCH" }),
+    delete: (path, init) => request(path, { ...init, method: "DELETE" })
+  };
+}
+export {
+  ApiError,
+  createApiClient,
+  a as fieldErrors,
+  f as fieldIssues,
+  parseJson,
+  rawEnvelope,
+  temporalReviver,
+  wowTwoEnvelope
+};
+//# sourceMappingURL=index.js.map

package/dist/foundation/http/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sources":["../../../src/foundation/http/Envelope.ts","../../../src/foundation/http/temporalReviver.ts","../../../src/foundation/http/CreateApiClient.ts"],"sourcesContent":["import { ApiError } from './ApiError';\nimport type { ProblemDetails } from './ProblemDetails';\n\n/** Checks whether a parsed body is a plain JSON object — not `null`, not an array — the only shape that can carry an envelope or a problem. */\nconst isJsonObject = (parsed: unknown): parsed is Record<string, unknown> =>\n  parsed !== null && typeof parsed === 'object' && !Array.isArray(parsed);\n\n/**\n * Defines the wire-contract strategy for `createApiClient` — how a parsed 2xx body yields the payload\n * and how a parsed non-2xx body yields the thrown error. The client core stays contract-free: it reads\n * and parses the body (an empty body resolves `undefined` before any strategy runs; a network failure\n * throws a core {@link ApiError} status `0` — there is no response to delegate) and hands the rest here.\n */\nexport interface ResponseEnvelope {\n  /** Extracts the payload from a parsed 2xx body. Skipped when the request passes `unwrap: false` — the request flag wins over the strategy. */\n  readonly unwrap: (parsed: unknown, response: Response) => unknown;\n\n  /**\n   * Builds the error thrown for a non-2xx response from its parsed body (plain JSON, no Temporal\n   * revive; `undefined` when empty or malformed). Return an {@link ApiError} to keep retry and\n   * `onUnauthorized` working — both key off the thrown error's `status` — a foreign `Error` type\n   * simply never triggers them.\n   */\n  readonly toError: (parsed: unknown, response: Response) => Error;\n}\n\n/**\n * Provides the wow-two wire contract (the default): a 2xx object body shaped `{ data }` (`ApiResponse`)\n * unwraps to its `data` member — anything else, including a literal `null` body, passes through\n * unchanged — and a non-2xx JSON-object body is taken as the RFC 7807 {@link ProblemDetails} (non-object\n * bodies → `null` problem), thrown as {@link ApiError} with its message precedence: title → detail →\n * status fallback.\n */\nexport const wowTwoEnvelope: ResponseEnvelope = {\n  unwrap: (parsed) => (isJsonObject(parsed) && 'data' in parsed ? parsed['data'] : parsed),\n  toError: (parsed, response) => new ApiError(response.status, isJsonObject(parsed) ? (parsed as ProblemDetails) : null),\n};\n\n/**\n * Provides the identity contract for un-enveloped APIs: 2xx bodies pass through unchanged, and a\n * non-2xx response throws `ApiError(status, null, statusText)` — deliberately still an {@link ApiError}\n * rather than a plain `Error`, so `status`-keyed retry, `onUnauthorized`, and caller `instanceof`\n * handling stay uniform across envelopes. The error body is ignored (no contract to read a problem\n * from); an empty `statusText` (HTTP/2 sends none) falls back to `Request failed with status N`.\n */\nexport const rawEnvelope: ResponseEnvelope = {\n  unwrap: (parsed) => parsed,\n  toError: (_parsed, response) => new ApiError(response.status, null, response.statusText || undefined),\n};\n","import { Temporal } from 'temporal-polyfill';\n\n// Strict ISO-8601 shapes. Anchored (^…$) so partial / lenient strings never match — only a\n// wire value that is unambiguously one Temporal kind is upgraded; everything else stays a string.\nconst INSTANT = /^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}(:\\d{2})?(\\.\\d+)?(Z|[+-]\\d{2}:\\d{2})$/;\nconst PLAIN_DATE = /^\\d{4}-\\d{2}-\\d{2}$/;\nconst PLAIN_TIME = /^\\d{2}:\\d{2}(:\\d{2})?(\\.\\d+)?$/;\n// ISO-8601 duration: sign, `P`, then at least one designator (lookahead rejects a bare `P`).\nconst DURATION = /^-?P(?=[\\dT])(\\d+Y)?(\\d+M)?(\\d+W)?(\\d+D)?(T(\\d+H)?(\\d+M)?(\\d+(\\.\\d+)?S)?)?$/;\n\n/**\n * Upgrades a matching ISO-8601 string to its `Temporal.*` value; returns everything else unchanged.\n * Intended as the reviver argument to `JSON.parse` so inbound date fields arrive as Temporal objects\n * (outbound is automatic via each `Temporal.*.toJSON()`). Each parse is guarded — an ISO-shaped but\n * invalid value (e.g. `2026-13-40`) falls back to the raw string rather than throwing.\n */\nexport function temporalReviver(_key: string, value: unknown): unknown {\n  if (typeof value !== 'string') return value;\n\n  if (INSTANT.test(value)) {\n    try {\n      return Temporal.Instant.from(value);\n    } catch {\n      return value;\n    }\n  }\n  if (PLAIN_DATE.test(value)) {\n    try {\n      return Temporal.PlainDate.from(value);\n    } catch {\n      return value;\n    }\n  }\n  if (PLAIN_TIME.test(value)) {\n    try {\n      return Temporal.PlainTime.from(value);\n    } catch {\n      return value;\n    }\n  }\n  if (DURATION.test(value)) {\n    try {\n      return Temporal.Duration.from(value);\n    } catch {\n      return value;\n    }\n  }\n  return value;\n}\n\n/** Parses a JSON string with {@link temporalReviver} applied, upgrading ISO date fields to `Temporal.*`. */\nexport function parseJson<T>(text: string): T {\n  return JSON.parse(text, temporalReviver) as T;\n}\n","import { getErrorMessage, isAbortError } from '../errors';\nimport { computeRetryDelay, shouldRetry, type RetryPolicy } from '../resilience';\n\nimport { ApiError } from './ApiError';\nimport { wowTwoEnvelope, type ResponseEnvelope } from './Envelope';\nimport { parseJson } from './temporalReviver';\n\nconst JsonMime = 'application/json';\n\n/** Defines query params appended to a request path — arrays repeat the key; `null`/`undefined` entries are skipped; everything else is `String()`-ed. */\nexport type ApiQueryParams = Record<string, unknown>;\n\n/** Defines the per-request init accepted by every {@link ApiClient} method. */\nexport interface ApiRequestInit {\n  /** The query params appended to the path (see {@link ApiQueryParams}); merged onto any query string already in the path. */\n  readonly query?: ApiQueryParams;\n\n  /** The request body — JSON-stringified with `Content-Type: application/json`, except `FormData`, which passes through untouched (the runtime sets the multipart boundary). */\n  readonly body?: unknown;\n\n  /** Aborts the request (and any retry wait) — an abort rethrows the native `AbortError`, never an {@link ApiError}. */\n  readonly signal?: AbortSignal | null;\n\n  /** Extra headers merged last — they win over the computed JSON headers, the client defaults, and the bearer token. */\n  readonly headers?: HeadersInit;\n\n  /** Whether to run the envelope's unwrap on the parsed body. Default `true`; `false` returns the body exactly as parsed — the request flag wins over {@link ApiClientOptions.envelope}. */\n  readonly unwrap?: boolean;\n\n  /** The HTTP method for the `request` escape hatch. Default `GET`. The verb helpers force their own method. */\n  readonly method?: string;\n}\n\n/** Defines the options for {@link createApiClient}. */\nexport interface ApiClientOptions {\n  /** The prefix for every request path. Default `''` (same-origin — the SPA is served by the API host). */\n  readonly baseUrl?: string;\n\n  /** Supplies the bearer token, re-read on every attempt — return `null` to skip the `Authorization` header (signed-out / cookie mode). */\n  readonly getAuthToken?: () => string | null | Promise<string | null>;\n\n  /** The fetch credentials mode — `'include'` for cross-origin cookie auth; omit for the runtime default. */\n  readonly credentials?: RequestCredentials;\n\n  /** Fires on a 401 after the {@link ApiError} is built (which is still thrown) — wire session-expiry handling here. */\n  readonly onUnauthorized?: (error: ApiError) => void;\n\n  /** Headers applied to every request; per-request headers win. */\n  readonly defaultHeaders?: HeadersInit;\n\n  /** Whether to parse response bodies through the Temporal reviver so ISO date fields arrive as `Temporal.*`. Default `false`. */\n  readonly reviveTemporal?: boolean;\n\n  /** The wire-contract strategy — how 2xx bodies unwrap and how non-2xx bodies become thrown errors. Default {@link wowTwoEnvelope} (zero-config for wow-two APIs); use `rawEnvelope` for un-enveloped APIs, or supply your own. */\n  readonly envelope?: ResponseEnvelope;\n\n  /** The transport-level retry policy for transient failures. Default `false` (off) — leave off under `/query`, which owns retries, or requests double-retry. */\n  readonly retry?: RetryPolicy | false;\n\n  /** The fetch implementation, resolved per request. Default the global `fetch` — injectable for tests. */\n  readonly fetch?: typeof globalThis.fetch;\n}\n\n/** Defines the typed HTTP client returned by {@link createApiClient}. */\nexport interface ApiClient {\n  /** Sends a GET request. */\n  get<T = unknown>(path: string, init?: ApiRequestInit): Promise<T>;\n\n  /** Sends a POST request. */\n  post<T = unknown>(path: string, init?: ApiRequestInit): Promise<T>;\n\n  /** Sends a PUT request. */\n  put<T = unknown>(path: string, init?: ApiRequestInit): Promise<T>;\n\n  /** Sends a PATCH request. */\n  patch<T = unknown>(path: string, init?: ApiRequestInit): Promise<T>;\n\n  /** Sends a DELETE request. */\n  delete<T = unknown>(path: string, init?: ApiRequestInit): Promise<T>;\n\n  /** Sends a request with an arbitrary method (`init.method`, default `GET`) — the escape hatch under the verb helpers. */\n  request<T = unknown>(path: string, init?: ApiRequestInit): Promise<T>;\n}\n\n/** Serializes query params — arrays repeat the key, `null`/`undefined` entries are skipped. */\nfunction buildQueryString(query: ApiQueryParams): string {\n  const params = new URLSearchParams();\n  for (const [key, value] of Object.entries(query)) {\n    for (const item of Array.isArray(value) ? value : [value]) {\n      if (item != null) params.append(key, String(item));\n    }\n  }\n  return params.toString();\n}\n\n/** Waits `ms` before a retry attempt, rejecting with the signal's native abort reason if aborted mid-wait. */\nfunction wait(ms: number, signal?: AbortSignal | null): Promise<void> {\n  return new Promise((resolve, reject) => {\n    const abortReason = (): unknown => signal?.reason ?? new DOMException('The operation was aborted.', 'AbortError');\n    if (signal?.aborted) {\n      reject(abortReason());\n      return;\n    }\n    const timer = setTimeout(() => {\n      signal?.removeEventListener('abort', onAbort);\n      resolve();\n    }, ms);\n    const onAbort = (): void => {\n      clearTimeout(timer);\n      reject(abortReason());\n    };\n    signal?.addEventListener('abort', onAbort, { once: true });\n  });\n}\n\n/** Reads a non-2xx body as plain JSON for the envelope's `toError` — empty, unreadable, or malformed bodies yield `undefined`. */\nasync function readErrorBody(response: Response): Promise<unknown> {\n  try {\n    const text = await response.text();\n    return text === '' ? undefined : (JSON.parse(text) as unknown);\n  } catch {\n    return undefined;\n  }\n}\n\n/**\n * Creates the typed fetch client every wow-two frontend talks through — JSON by default, a swappable\n * wire contract ({@link ApiClientOptions.envelope}, default {@link wowTwoEnvelope}: `{ data }` unwrap +\n * ProblemDetails → {@link ApiError}), body-driven empties (an empty body resolves `undefined` and a\n * literal `null` body resolves `null`, whatever the status), bearer/cookie auth, optional Temporal\n * revive, and opt-in transport retry (network failure → {@link ApiError} status `0`, envelope-independent).\n * Aborts rethrow the native `AbortError` so `/query` cancellation semantics stay intact.\n */\nexport function createApiClient(options: ApiClientOptions = {}): ApiClient {\n  const {\n    baseUrl = '',\n    getAuthToken,\n    credentials,\n    onUnauthorized,\n    defaultHeaders,\n    reviveTemporal = false,\n    envelope = wowTwoEnvelope,\n    retry = false,\n  } = options;\n\n  /** Builds the attempt's headers — JSON base → client defaults → bearer token → per-request (last wins). */\n  const buildHeaders = async (init: ApiRequestInit, hasJsonBody: boolean): Promise<Headers> => {\n    const headers = new Headers({ Accept: JsonMime });\n    if (hasJsonBody) headers.set('Content-Type', JsonMime);\n    if (defaultHeaders) new Headers(defaultHeaders).forEach((value, key) => headers.set(key, value));\n    const token = getAuthToken ? await getAuthToken() : null;\n    if (token != null) headers.set('Authorization', `Bearer ${token}`);\n    if (init.headers) new Headers(init.headers).forEach((value, key) => headers.set(key, value));\n    return headers;\n  };\n\n  /** Performs one attempt — throws `ApiError` for transport failures, rethrows aborts natively. */\n  const attempt = async <T>(url: string, init: ApiRequestInit, body: BodyInit | undefined, hasJsonBody: boolean): Promise<T> => {\n    // Outside the try: a token-delegate crash is a programmer error, not a transport failure.\n    const headers = await buildHeaders(init, hasJsonBody);\n    const doFetch = options.fetch ?? globalThis.fetch;\n\n    let response: Response;\n    try {\n      response = await doFetch(url, {\n        method: init.method ?? 'GET',\n        headers,\n        // `?? null` lets callers pass an optional signal directly under exactOptionalPropertyTypes.\n        signal: init.signal ?? null,\n        ...(credentials !== undefined ? { credentials } : {}),\n        ...(body !== undefined ? { body } : {}),\n      });\n    } catch (error) {\n      if (isAbortError(error)) throw error;\n      throw new ApiError(0, null, getErrorMessage(error, 'Network request failed'));\n    }\n\n    if (!response.ok) throw envelope.toError(await readErrorBody(response), response);\n\n    // Body-driven, not status-driven: no 204 / Content-Length sniffing. An empty body (any\n    // status) resolves `undefined`; a literal `null` JSON body parses — and returns — as `null`.\n    const text = await response.text();\n    if (text === '') return undefined as T;\n\n    const parsed: unknown = reviveTemporal ? parseJson<unknown>(text) : (JSON.parse(text) as unknown);\n    if (init.unwrap === false) return parsed as T;\n    return envelope.unwrap(parsed, response) as T;\n  };\n\n  const request = async <T = unknown>(path: string, init: ApiRequestInit = {}): Promise<T> => {\n    const queryString = init.query ? buildQueryString(init.query) : '';\n    const url = `${baseUrl}${path}${queryString ? (path.includes('?') ? '&' : '?') + queryString : ''}`;\n    const isFormData = typeof FormData !== 'undefined' && init.body instanceof FormData;\n    const body: BodyInit | undefined =\n      init.body === undefined ? undefined : isFormData ? (init.body as FormData) : JSON.stringify(init.body);\n\n    let retries = 0;\n    let previousDelayMs = 0;\n    for (;;) {\n      try {\n        return await attempt<T>(url, init, body, init.body !== undefined && !isFormData);\n      } catch (error) {\n        // Only ApiErrors drive retry/401 — aborts, token-delegate crashes, malformed-JSON parse\n        // errors, and foreign error types from a custom envelope's `toError` all pass through\n        // natively (the `/query` layer coerces whatever it catches).\n        if (!(error instanceof ApiError)) throw error;\n        if (retry !== false && shouldRetry(retry, retries, error.status)) {\n          const attemptNumber = retries + 1;\n          const delayMs = computeRetryDelay(retry, attemptNumber, previousDelayMs);\n          retry.onRetry?.({ attempt: attemptNumber, error, status: error.status, delayMs });\n          await wait(delayMs, init.signal);\n          previousDelayMs = delayMs;\n          retries = attemptNumber;\n          continue;\n        }\n        if (error.status === 401) onUnauthorized?.(error);\n        throw error;\n      }\n    }\n  };\n\n  return {\n    request,\n    get: <T = unknown>(path: string, init?: ApiRequestInit): Promise<T> => request<T>(path, { ...init, method: 'GET' }),\n    post: <T = unknown>(path: string, init?: ApiRequestInit): Promise<T> => request<T>(path, { ...init, method: 'POST' }),\n    put: <T = unknown>(path: string, init?: ApiRequestInit): Promise<T> => request<T>(path, { ...init, method: 'PUT' }),\n    patch: <T = unknown>(path: string, init?: ApiRequestInit): Promise<T> => request<T>(path, { ...init, method: 'PATCH' }),\n    delete: <T = unknown>(path: string, init?: ApiRequestInit): Promise<T> => request<T>(path, { ...init, method: 'DELETE' }),\n  };\n}\n"],"names":[],"mappings":";;;;;;AAIA,MAAM,eAAe,CAAC,WACpB,WAAW,QAAQ,OAAO,WAAW,YAAY,CAAC,MAAM,QAAQ,MAAM;AA4BjE,MAAM,iBAAmC;AAAA,EAC9C,QAAQ,CAAC,WAAY,aAAa,MAAM,KAAK,UAAU,SAAS,OAAO,MAAM,IAAI;AAAA,EACjF,SAAS,CAAC,QAAQ,aAAa,IAAI,SAAS,SAAS,QAAQ,aAAa,MAAM,IAAK,SAA4B,IAAI;AACvH;AASO,MAAM,cAAgC;AAAA,EAC3C,QAAQ,CAAC,WAAW;AAAA,EACpB,SAAS,CAAC,SAAS,aAAa,IAAI,SAAS,SAAS,QAAQ,MAAM,SAAS,cAAc,MAAS;AACtG;AC5CA,MAAM,UAAU;AAChB,MAAM,aAAa;AACnB,MAAM,aAAa;AAEnB,MAAM,WAAW;AAQV,SAAS,gBAAgB,MAAc,OAAyB;AACrE,MAAI,OAAO,UAAU,SAAU,QAAO;AAEtC,MAAI,QAAQ,KAAK,KAAK,GAAG;AACvB,QAAI;AACF,aAAO,SAAS,QAAQ,KAAK,KAAK;AAAA,IACpC,QAAQ;AACN,aAAO;AAAA,IACT;AAAA,EACF;AACA,MAAI,WAAW,KAAK,KAAK,GAAG;AAC1B,QAAI;AACF,aAAO,SAAS,UAAU,KAAK,KAAK;AAAA,IACtC,QAAQ;AACN,aAAO;AAAA,IACT;AAAA,EACF;AACA,MAAI,WAAW,KAAK,KAAK,GAAG;AAC1B,QAAI;AACF,aAAO,SAAS,UAAU,KAAK,KAAK;AAAA,IACtC,QAAQ;AACN,aAAO;AAAA,IACT;AAAA,EACF;AACA,MAAI,SAAS,KAAK,KAAK,GAAG;AACxB,QAAI;AACF,aAAO,SAAS,SAAS,KAAK,KAAK;AAAA,IACrC,QAAQ;AACN,aAAO;AAAA,IACT;AAAA,EACF;AACA,SAAO;AACT;AAGO,SAAS,UAAa,MAAiB;AAC5C,SAAO,KAAK,MAAM,MAAM,eAAe;AACzC;AC9CA,MAAM,WAAW;AA8EjB,SAAS,iBAAiB,OAA+B;AACvD,QAAM,SAAS,IAAI,gBAAA;AACnB,aAAW,CAAC,KAAK,KAAK,KAAK,OAAO,QAAQ,KAAK,GAAG;AAChD,eAAW,QAAQ,MAAM,QAAQ,KAAK,IAAI,QAAQ,CAAC,KAAK,GAAG;AACzD,UAAI,QAAQ,KAAM,QAAO,OAAO,KAAK,OAAO,IAAI,CAAC;AAAA,IACnD;AAAA,EACF;AACA,SAAO,OAAO,SAAA;AAChB;AAGA,SAAS,KAAK,IAAY,QAA4C;AACpE,SAAO,IAAI,QAAQ,CAAC,SAAS,WAAW;AACtC,UAAM,cAAc,MAAe,QAAQ,UAAU,IAAI,aAAa,8BAA8B,YAAY;AAChH,QAAI,QAAQ,SAAS;AACnB,aAAO,aAAa;AACpB;AAAA,IACF;AACA,UAAM,QAAQ,WAAW,MAAM;AAC7B,cAAQ,oBAAoB,SAAS,OAAO;AAC5C,cAAA;AAAA,IACF,GAAG,EAAE;AACL,UAAM,UAAU,MAAY;AAC1B,mBAAa,KAAK;AAClB,aAAO,aAAa;AAAA,IACtB;AACA,YAAQ,iBAAiB,SAAS,SAAS,EAAE,MAAM,MAAM;AAAA,EAC3D,CAAC;AACH;AAGA,eAAe,cAAc,UAAsC;AACjE,MAAI;AACF,UAAM,OAAO,MAAM,SAAS,KAAA;AAC5B,WAAO,SAAS,KAAK,SAAa,KAAK,MAAM,IAAI;AAAA,EACnD,QAAQ;AACN,WAAO;AAAA,EACT;AACF;AAUO,SAAS,gBAAgB,UAA4B,IAAe;AACzE,QAAM;AAAA,IACJ,UAAU;AAAA,IACV;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA,iBAAiB;AAAA,IACjB,WAAW;AAAA,IACX,QAAQ;AAAA,EAAA,IACN;AAGJ,QAAM,eAAe,OAAO,MAAsB,gBAA2C;AAC3F,UAAM,UAAU,IAAI,QAAQ,EAAE,QAAQ,UAAU;AAChD,QAAI,YAAa,SAAQ,IAAI,gBAAgB,QAAQ;AACrD,QAAI,eAAgB,KAAI,QAAQ,cAAc,EAAE,QAAQ,CAAC,OAAO,QAAQ,QAAQ,IAAI,KAAK,KAAK,CAAC;AAC/F,UAAM,QAAQ,eAAe,MAAM,aAAA,IAAiB;AACpD,QAAI,SAAS,KAAM,SAAQ,IAAI,iBAAiB,UAAU,KAAK,EAAE;AACjE,QAAI,KAAK,QAAS,KAAI,QAAQ,KAAK,OAAO,EAAE,QAAQ,CAAC,OAAO,QAAQ,QAAQ,IAAI,KAAK,KAAK,CAAC;AAC3F,WAAO;AAAA,EACT;AAGA,QAAM,UAAU,OAAU,KAAa,MAAsB,MAA4B,gBAAqC;AAE5H,UAAM,UAAU,MAAM,aAAa,MAAM,WAAW;AACpD,UAAM,UAAU,QAAQ,SAAS,WAAW;AAE5C,QAAI;AACJ,QAAI;AACF,iBAAW,MAAM,QAAQ,KAAK;AAAA,QAC5B,QAAQ,KAAK,UAAU;AAAA,QACvB;AAAA;AAAA,QAEA,QAAQ,KAAK,UAAU;AAAA,QACvB,GAAI,gBAAgB,SAAY,EAAE,YAAA,IAAgB,CAAA;AAAA,QAClD,GAAI,SAAS,SAAY,EAAE,KAAA,IAAS,CAAA;AAAA,MAAC,CACtC;AAAA,IACH,SAAS,OAAO;AACd,UAAI,aAAa,KAAK,EAAG,OAAM;AAC/B,YAAM,IAAI,SAAS,GAAG,MAAM,gBAAgB,OAAO,wBAAwB,CAAC;AAAA,IAC9E;AAEA,QAAI,CAAC,SAAS,GAAI,OAAM,SAAS,QAAQ,MAAM,cAAc,QAAQ,GAAG,QAAQ;AAIhF,UAAM,OAAO,MAAM,SAAS,KAAA;AAC5B,QAAI,SAAS,GAAI,QAAO;AAExB,UAAM,SAAkB,iBAAiB,UAAmB,IAAI,IAAK,KAAK,MAAM,IAAI;AACpF,QAAI,KAAK,WAAW,MAAO,QAAO;AAClC,WAAO,SAAS,OAAO,QAAQ,QAAQ;AAAA,EACzC;AAEA,QAAM,UAAU,OAAoB,MAAc,OAAuB,CAAA,MAAmB;AAC1F,UAAM,cAAc,KAAK,QAAQ,iBAAiB,KAAK,KAAK,IAAI;AAChE,UAAM,MAAM,GAAG,OAAO,GAAG,IAAI,GAAG,eAAe,KAAK,SAAS,GAAG,IAAI,MAAM,OAAO,cAAc,EAAE;AACjG,UAAM,aAAa,OAAO,aAAa,eAAe,KAAK,gBAAgB;AAC3E,UAAM,OACJ,KAAK,SAAS,SAAY,SAAY,aAAc,KAAK,OAAoB,KAAK,UAAU,KAAK,IAAI;AAEvG,QAAI,UAAU;AACd,QAAI,kBAAkB;AACtB,eAAS;AACP,UAAI;AACF,eAAO,MAAM,QAAW,KAAK,MAAM,MAAM,KAAK,SAAS,UAAa,CAAC,UAAU;AAAA,MACjF,SAAS,OAAO;AAId,YAAI,EAAE,iBAAiB,UAAW,OAAM;AACxC,YAAI,UAAU,SAAS,YAAY,OAAO,SAAS,MAAM,MAAM,GAAG;AAChE,gBAAM,gBAAgB,UAAU;AAChC,gBAAM,UAAU,kBAAkB,OAAO,eAAe,eAAe;AACvE,gBAAM,UAAU,EAAE,SAAS,eAAe,OAAO,QAAQ,MAAM,QAAQ,SAAS;AAChF,gBAAM,KAAK,SAAS,KAAK,MAAM;AAC/B,4BAAkB;AAClB,oBAAU;AACV;AAAA,QACF;AACA,YAAI,MAAM,WAAW,IAAK,kBAAiB,KAAK;AAChD,cAAM;AAAA,MACR;AAAA,IACF;AAAA,EACF;AAEA,SAAO;AAAA,IACL;AAAA,IACA,KAAK,CAAc,MAAc,SAAsC,QAAW,MAAM,EAAE,GAAG,MAAM,QAAQ,OAAO;AAAA,IAClH,MAAM,CAAc,MAAc,SAAsC,QAAW,MAAM,EAAE,GAAG,MAAM,QAAQ,QAAQ;AAAA,IACpH,KAAK,CAAc,MAAc,SAAsC,QAAW,MAAM,EAAE,GAAG,MAAM,QAAQ,OAAO;AAAA,IAClH,OAAO,CAAc,MAAc,SAAsC,QAAW,MAAM,EAAE,GAAG,MAAM,QAAQ,SAAS;AAAA,IACtH,QAAQ,CAAc,MAAc,SAAsC,QAAW,MAAM,EAAE,GAAG,MAAM,QAAQ,SAAA,CAAU;AAAA,EAAA;AAE5H;"}

package/dist/foundation/http/temporalReviver.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Upgrades a matching ISO-8601 string to its `Temporal.*` value; returns everything else unchanged.
+ * Intended as the reviver argument to `JSON.parse` so inbound date fields arrive as Temporal objects
+ * (outbound is automatic via each `Temporal.*.toJSON()`). Each parse is guarded — an ISO-shaped but
+ * invalid value (e.g. `2026-13-40`) falls back to the raw string rather than throwing.
+ */
+export declare function temporalReviver(_key: string, value: unknown): unknown;
+/** Parses a JSON string with {@link temporalReviver} applied, upgrading ISO date fields to `Temporal.*`. */
+export declare function parseJson<T>(text: string): T;

package/dist/foundation/i18n/FormattedRelative.vue.d.ts

@@ -0,0 +1,10 @@
+import { DefineComponent, ComponentOptionsMixin, PublicProps, ComponentProvideOptions } from 'vue';
+/** Props for `FormattedRelative`. */
+export interface FormattedRelativeProps {
+    /** Signed magnitude — negative = past (`-3` → "3 days ago"), positive = future. */
+    value: number;
+    unit: Intl.RelativeTimeFormatUnit;
+    options?: Intl.RelativeTimeFormatOptions;
+}
+declare const _default: DefineComponent<FormattedRelativeProps, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly<FormattedRelativeProps> & Readonly<{}>, {}, {}, {}, {}, string, ComponentProvideOptions, false, {}, any>;
+export default _default;

package/dist/foundation/i18n/LocaleContext.d.ts

@@ -0,0 +1,35 @@
+import { ComputedRef, InjectionKey, MaybeRefOrGetter } from 'vue';
+/** Interpolation variables for a message template (`Hello {name}` + `{ name: 'Sam' }`). */
+export type MessageVars = Record<string, string | number>;
+/** A message resolver — a `key → template` dictionary, or a `(key, vars) => string` callback (bring-your-own ICU). */
+export type Messages = Record<string, string> | ((key: string, vars?: MessageVars) => string);
+/** Replaces `{token}` placeholders from `vars`; leaves unknown tokens untouched. */
+export declare function interpolate(template: string, vars?: MessageVars): string;
+/** Resolves a message: consumer `messages` override (dict or callback) → SDK-authored `fallback` → the raw key. */
+export declare function resolveMessage(messages: Messages | undefined, key: string, vars?: MessageVars, fallback?: string): string;
+/**
+ * The active locale + message resolver exposed by `useLocale`.
+ *
+ * `locale` is a `ComputedRef` rather than a bare string — Vue's `provide` is not reactive on its own, and a
+ * consumer switching locales must re-evaluate every descendant. `t` stays a plain function: it reads the
+ * provider's messages at CALL time, so invoking it inside a `computed` tracks a message-table swap without
+ * `t` itself ever changing identity.
+ */
+export interface LocaleContextValue {
+    /** The active BCP-47 locale (e.g. `en-US`, `de`). */
+    locale: ComputedRef<string>;
+    /** Resolves a message key — consumer override, else the SDK-authored `fallback`, else the key. */
+    t: (key: string, vars?: MessageVars, fallback?: string) => string;
+}
+/** The injection key — React's `createContext(undefined)` becomes a key plus a default at the injection site. */
+export declare const LocaleKey: InjectionKey<LocaleContextValue>;
+/**
+ * The provider half — used by `LocaleProvider`, and by any component that owns a locale.
+ *
+ * `navigator.language` is read lazily, inside the `computed`, and guarded: a `computed` is only evaluated when
+ * something reads it, so a server render that never touches `locale` never touches `navigator`, and one that
+ * does falls through to `en-US` instead of throwing.
+ */
+export declare function provideLocale(locale?: MaybeRefOrGetter<string | undefined>, messages?: MaybeRefOrGetter<Messages | undefined>): LocaleContextValue;
+/** Reads the active locale + `t`. Works without a provider — defaults to `en-US` + fallback-only messages. */
+export declare function useLocale(): LocaleContextValue;

package/dist/foundation/i18n/LocaleFormatters.d.ts

@@ -0,0 +1,24 @@
+import { ComputedRef } from 'vue';
+/** Locale-bound `Intl` formatters — the surface every embedded-text component formats through. */
+export interface LocaleFormatters {
+    /** The BCP-47 locale these formatters are bound to. */
+    locale: string;
+    number(value: number, options?: Intl.NumberFormatOptions): string;
+    currency(value: number, currency: string, options?: Intl.NumberFormatOptions): string;
+    percent(value: number, options?: Intl.NumberFormatOptions): string;
+    date(value: Date | number, options?: Intl.DateTimeFormatOptions): string;
+    time(value: Date | number, options?: Intl.DateTimeFormatOptions): string;
+    relativeTime(value: number, unit: Intl.RelativeTimeFormatUnit, options?: Intl.RelativeTimeFormatOptions): string;
+    list(items: Iterable<string>, options?: Intl.ListFormatOptions): string;
+    plural(value: number, options?: Intl.PluralRulesOptions): Intl.LDMLPluralRule;
+}
+/** Builds locale-bound formatters (pure — the testable core of `useLocaleFormatters`). */
+export declare function createLocaleFormatters(locale: string): LocaleFormatters;
+/**
+ * Returns locale-bound `Intl` formatters — `number`/`currency`/`percent`/`date`/`time`/`relativeTime`/`list`/
+ * `plural` — recomputed only when the active locale changes.
+ *
+ * A `ComputedRef` rather than a plain object: the locale is reactive, so the formatter set bound to it has to
+ * be too. Read it as `formatters.value.number(1234)`.
+ */
+export declare function useLocaleFormatters(): ComputedRef<LocaleFormatters>;

package/dist/foundation/i18n/LocaleProvider.vue.d.ts

@@ -0,0 +1,18 @@
+import { Messages } from './LocaleContext';
+import { DefineComponent, ComponentOptionsMixin, PublicProps, ComponentProvideOptions } from 'vue';
+/** Props for `LocaleProvider`. */
+export interface LocaleProviderProps {
+    /** BCP-47 locale. Defaults to `navigator.language`, then `en-US`. */
+    locale?: string;
+    /** Consumer message overrides — a dictionary or a `(key, vars) => string` callback. */
+    messages?: Messages;
+}
+declare const _default: __VLS_WithSlots< DefineComponent<LocaleProviderProps, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly<LocaleProviderProps> & Readonly<{}>, {}, {}, {}, {}, string, ComponentProvideOptions, false, {}, any>, {
+    default?: (props: {}) => any;
+}>;
+export default _default;
+type __VLS_WithSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

package/dist/foundation/i18n/index.d.ts

@@ -0,0 +1,4 @@
+export * from './LocaleContext';
+export * from './LocaleFormatters';
+export { default as LocaleProvider, type LocaleProviderProps } from './LocaleProvider.vue';
+export { default as FormattedRelative, type FormattedRelativeProps } from './FormattedRelative.vue';

package/dist/foundation/i18n/index.js

@@ -0,0 +1,79 @@
+import { u as useLocale, p as provideLocale } from "../../chunks/LocaleContext-B3UXrI6p.js";
+import { L, i, r } from "../../chunks/LocaleContext-B3UXrI6p.js";
+import { computed, defineComponent, renderSlot, toDisplayString } from "vue";
+const intlCache = /* @__PURE__ */ new Map();
+function memo(cacheKey, make) {
+  let instance = intlCache.get(cacheKey);
+  if (instance === void 0) {
+    instance = make();
+    intlCache.set(cacheKey, instance);
+  }
+  return instance;
+}
+const optKey = (options) => options ? JSON.stringify(options) : "";
+function createLocaleFormatters(locale) {
+  const nf = (options) => memo(`n|${locale}|${optKey(options)}`, () => new Intl.NumberFormat(locale, options));
+  const dtf = (options) => memo(`d|${locale}|${optKey(options)}`, () => new Intl.DateTimeFormat(locale, options));
+  return {
+    locale,
+    number: (value, options) => nf(options).format(value),
+    currency: (value, currency, options) => nf({ ...options, style: "currency", currency }).format(value),
+    percent: (value, options) => nf({ ...options, style: "percent" }).format(value),
+    date: (value, options) => dtf(options ?? { dateStyle: "medium" }).format(value),
+    time: (value, options) => dtf(options ?? { timeStyle: "short" }).format(value),
+    relativeTime: (value, unit, options) => memo(`r|${locale}|${optKey(options)}`, () => new Intl.RelativeTimeFormat(locale, options)).format(value, unit),
+    list: (items, options) => memo(`l|${locale}|${optKey(options)}`, () => new Intl.ListFormat(locale, options)).format(items),
+    plural: (value, options) => memo(`p|${locale}|${optKey(options)}`, () => new Intl.PluralRules(locale, options)).select(value)
+  };
+}
+function useLocaleFormatters() {
+  const { locale } = useLocale();
+  return computed(() => createLocaleFormatters(locale.value));
+}
+const _sfc_main$1 = /* @__PURE__ */ defineComponent({
+  ...{ name: "LocaleProvider" },
+  __name: "LocaleProvider",
+  props: {
+    locale: {},
+    messages: { type: [Object, Function] }
+  },
+  setup(__props) {
+    const props = __props;
+    provideLocale(
+      () => props.locale,
+      () => props.messages
+    );
+    return (_ctx, _cache) => {
+      return renderSlot(_ctx.$slots, "default");
+    };
+  }
+});
+const _sfc_main = /* @__PURE__ */ defineComponent({
+  ...{ name: "FormattedRelative" },
+  __name: "FormattedRelative",
+  props: {
+    value: {},
+    unit: {},
+    options: {}
+  },
+  setup(__props) {
+    const props = __props;
+    const formatters = useLocaleFormatters();
+    const text = computed(() => formatters.value.relativeTime(props.value, props.unit, props.options));
+    return (_ctx, _cache) => {
+      return toDisplayString(text.value);
+    };
+  }
+});
+export {
+  _sfc_main as FormattedRelative,
+  L as LocaleKey,
+  _sfc_main$1 as LocaleProvider,
+  createLocaleFormatters,
+  i as interpolate,
+  provideLocale,
+  r as resolveMessage,
+  useLocale,
+  useLocaleFormatters
+};
+//# sourceMappingURL=index.js.map

package/dist/foundation/i18n/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sources":["../../../src/foundation/i18n/LocaleFormatters.ts","../../../src/foundation/i18n/LocaleProvider.vue","../../../src/foundation/i18n/FormattedRelative.vue"],"sourcesContent":["import { computed, type ComputedRef } from 'vue';\n\nimport { useLocale } from './LocaleContext';\n\n// `Intl` instances are cached across components by locale + options — constructing them is the expensive part,\n// so a shared module cache keeps `useLocaleFormatters` allocation-free after warm-up.\nconst intlCache = new Map<string, unknown>();\nfunction memo<T>(cacheKey: string, make: () => T): T {\n  let instance = intlCache.get(cacheKey) as T | undefined;\n  if (instance === undefined) {\n    instance = make();\n    intlCache.set(cacheKey, instance);\n  }\n  return instance;\n}\nconst optKey = (options: object | undefined): string => (options ? JSON.stringify(options) : '');\n\n/** Locale-bound `Intl` formatters — the surface every embedded-text component formats through. */\nexport interface LocaleFormatters {\n  /** The BCP-47 locale these formatters are bound to. */\n  locale: string;\n  number(value: number, options?: Intl.NumberFormatOptions): string;\n  currency(value: number, currency: string, options?: Intl.NumberFormatOptions): string;\n  percent(value: number, options?: Intl.NumberFormatOptions): string;\n  date(value: Date | number, options?: Intl.DateTimeFormatOptions): string;\n  time(value: Date | number, options?: Intl.DateTimeFormatOptions): string;\n  relativeTime(value: number, unit: Intl.RelativeTimeFormatUnit, options?: Intl.RelativeTimeFormatOptions): string;\n  list(items: Iterable<string>, options?: Intl.ListFormatOptions): string;\n  plural(value: number, options?: Intl.PluralRulesOptions): Intl.LDMLPluralRule;\n}\n\n/** Builds locale-bound formatters (pure — the testable core of `useLocaleFormatters`). */\nexport function createLocaleFormatters(locale: string): LocaleFormatters {\n  const nf = (options?: Intl.NumberFormatOptions) =>\n    memo(`n|${locale}|${optKey(options)}`, () => new Intl.NumberFormat(locale, options));\n  const dtf = (options?: Intl.DateTimeFormatOptions) =>\n    memo(`d|${locale}|${optKey(options)}`, () => new Intl.DateTimeFormat(locale, options));\n  return {\n    locale,\n    number: (value, options) => nf(options).format(value),\n    currency: (value, currency, options) => nf({ ...options, style: 'currency', currency }).format(value),\n    percent: (value, options) => nf({ ...options, style: 'percent' }).format(value),\n    date: (value, options) => dtf(options ?? { dateStyle: 'medium' }).format(value),\n    time: (value, options) => dtf(options ?? { timeStyle: 'short' }).format(value),\n    relativeTime: (value, unit, options) =>\n      memo(`r|${locale}|${optKey(options)}`, () => new Intl.RelativeTimeFormat(locale, options)).format(value, unit),\n    list: (items, options) =>\n      memo(`l|${locale}|${optKey(options)}`, () => new Intl.ListFormat(locale, options)).format(items),\n    plural: (value, options) =>\n      memo(`p|${locale}|${optKey(options)}`, () => new Intl.PluralRules(locale, options)).select(value),\n  };\n}\n\n/**\n * Returns locale-bound `Intl` formatters — `number`/`currency`/`percent`/`date`/`time`/`relativeTime`/`list`/\n * `plural` — recomputed only when the active locale changes.\n *\n * A `ComputedRef` rather than a plain object: the locale is reactive, so the formatter set bound to it has to\n * be too. Read it as `formatters.value.number(1234)`.\n */\nexport function useLocaleFormatters(): ComputedRef<LocaleFormatters> {\n  const { locale } = useLocale();\n  return computed(() => createLocaleFormatters(locale.value));\n}\n","<script lang=\"ts\">\nimport type { Messages } from './LocaleContext';\n\n/** Props for `LocaleProvider`. */\nexport interface LocaleProviderProps {\n  /** BCP-47 locale. Defaults to `navigator.language`, then `en-US`. */\n  locale?: string;\n  /** Consumer message overrides — a dictionary or a `(key, vars) => string` callback. */\n  messages?: Messages;\n}\n</script>\n\n<script setup lang=\"ts\">\nimport { provideLocale } from './LocaleContext';\n\n/**\n * Provides the active locale + message overrides to every descendant SDK component.\n *\n * Renders no element of its own — the slot passes straight through.\n */\ndefineOptions({ name: 'LocaleProvider' });\n\nconst props = defineProps<LocaleProviderProps>();\n\nprovideLocale(\n  () => props.locale,\n  () => props.messages,\n);\n</script>\n\n<template>\n  <slot />\n</template>\n","<script lang=\"ts\">\n/** Props for `FormattedRelative`. */\nexport interface FormattedRelativeProps {\n  /** Signed magnitude — negative = past (`-3` → \"3 days ago\"), positive = future. */\n  value: number;\n  unit: Intl.RelativeTimeFormatUnit;\n  options?: Intl.RelativeTimeFormatOptions;\n}\n</script>\n\n<script setup lang=\"ts\">\nimport { computed } from 'vue';\n\nimport { useLocaleFormatters } from './LocaleFormatters';\n\n/** Renders a locale-formatted relative time (e.g. \"3 days ago\") via `Intl.RelativeTimeFormat`. */\ndefineOptions({ name: 'FormattedRelative' });\n\nconst props = defineProps<FormattedRelativeProps>();\n\nconst formatters = useLocaleFormatters();\nconst text = computed(() => formatters.value.relativeTime(props.value, props.unit, props.options));\n</script>\n\n<template>{{ text }}</template>\n"],"names":["_renderSlot"],"mappings":";;;AAMA,MAAM,gCAAgB,IAAA;AACtB,SAAS,KAAQ,UAAkB,MAAkB;AACnD,MAAI,WAAW,UAAU,IAAI,QAAQ;AACrC,MAAI,aAAa,QAAW;AAC1B,eAAW,KAAA;AACX,cAAU,IAAI,UAAU,QAAQ;AAAA,EAClC;AACA,SAAO;AACT;AACA,MAAM,SAAS,CAAC,YAAyC,UAAU,KAAK,UAAU,OAAO,IAAI;AAiBtF,SAAS,uBAAuB,QAAkC;AACvE,QAAM,KAAK,CAAC,YACV,KAAK,KAAK,MAAM,IAAI,OAAO,OAAO,CAAC,IAAI,MAAM,IAAI,KAAK,aAAa,QAAQ,OAAO,CAAC;AACrF,QAAM,MAAM,CAAC,YACX,KAAK,KAAK,MAAM,IAAI,OAAO,OAAO,CAAC,IAAI,MAAM,IAAI,KAAK,eAAe,QAAQ,OAAO,CAAC;AACvF,SAAO;AAAA,IACL;AAAA,IACA,QAAQ,CAAC,OAAO,YAAY,GAAG,OAAO,EAAE,OAAO,KAAK;AAAA,IACpD,UAAU,CAAC,OAAO,UAAU,YAAY,GAAG,EAAE,GAAG,SAAS,OAAO,YAAY,SAAA,CAAU,EAAE,OAAO,KAAK;AAAA,IACpG,SAAS,CAAC,OAAO,YAAY,GAAG,EAAE,GAAG,SAAS,OAAO,UAAA,CAAW,EAAE,OAAO,KAAK;AAAA,IAC9E,MAAM,CAAC,OAAO,YAAY,IAAI,WAAW,EAAE,WAAW,SAAA,CAAU,EAAE,OAAO,KAAK;AAAA,IAC9E,MAAM,CAAC,OAAO,YAAY,IAAI,WAAW,EAAE,WAAW,QAAA,CAAS,EAAE,OAAO,KAAK;AAAA,IAC7E,cAAc,CAAC,OAAO,MAAM,YAC1B,KAAK,KAAK,MAAM,IAAI,OAAO,OAAO,CAAC,IAAI,MAAM,IAAI,KAAK,mBAAmB,QAAQ,OAAO,CAAC,EAAE,OAAO,OAAO,IAAI;AAAA,IAC/G,MAAM,CAAC,OAAO,YACZ,KAAK,KAAK,MAAM,IAAI,OAAO,OAAO,CAAC,IAAI,MAAM,IAAI,KAAK,WAAW,QAAQ,OAAO,CAAC,EAAE,OAAO,KAAK;AAAA,IACjG,QAAQ,CAAC,OAAO,YACd,KAAK,KAAK,MAAM,IAAI,OAAO,OAAO,CAAC,IAAI,MAAM,IAAI,KAAK,YAAY,QAAQ,OAAO,CAAC,EAAE,OAAO,KAAK;AAAA,EAAA;AAEtG;AASO,SAAS,sBAAqD;AACnE,QAAM,EAAE,OAAA,IAAW,UAAA;AACnB,SAAO,SAAS,MAAM,uBAAuB,OAAO,KAAK,CAAC;AAC5D;;;;;;;;;ACzCA,UAAM,QAAQ;AAEd;AAAA,MACE,MAAM,MAAM;AAAA,MACZ,MAAM,MAAM;AAAA,IAAA;;aAKZA,WAAQ,KAAA,QAAA,SAAA;AAAA;;;;;;;;;;;;ACbV,UAAM,QAAQ;AAEd,UAAM,aAAa,oBAAA;AACnB,UAAM,OAAO,SAAS,MAAM,WAAW,MAAM,aAAa,MAAM,OAAO,MAAM,MAAM,MAAM,OAAO,CAAC;;6BAGpF,KAAA,KAAI;AAAA;;;"}

package/dist/foundation/icons/Icon.vue.d.ts

@@ -0,0 +1,40 @@
+import { Component, SVGAttributes, DefineComponent, ComponentOptionsMixin, PublicProps, ComponentProvideOptions } from 'vue';
+export interface IconAdapterProps extends SVGAttributes {
+    /**
+     * The pixel size handed to the adapter. `number` only, NOT `number | string`.
+     *
+     * Component props are contravariant: an adapter satisfies this type only if it accepts every
+     * prop declared here. `lucide-vue-next` types its own `size` as `number`, so widening this to
+     * `number | string` — as the React original did, where the looser `SVGProps` made it moot —
+     * makes every lucide icon unassignable to `IconAdapter` and forces an `as unknown as` cast at
+     * each import site. Narrow is the fix; a CSS-unit size belongs on `class`, not on this prop.
+     */
+    size?: number;
+}
+export type IconAdapter = Component<IconAdapterProps>;
+export interface IconProps extends Omit<SVGAttributes, 'aria-hidden'> {
+    /** The icon component — pass a `lucide-vue-next` icon, custom SVG component, or any matching shape. */
+    icon: IconAdapter;
+    /** The pixel size of the rendered SVG. Default 20. */
+    size?: number;
+    /**
+     * The aria-label for when the icon stands alone (decorative siblings
+     * should pass it via parent). Sets `role="img"` and unhides from AT.
+     * Without it, the icon is `aria-hidden` and decorative.
+     */
+    'aria-label'?: string;
+}
+declare const _default: DefineComponent<{
+    /** The icon component — pass a `lucide-vue-next` icon, custom SVG component, or any matching shape. */
+    icon: IconAdapter;
+    /** The pixel size of the rendered SVG. Default 20. */
+    size?: number;
+}, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly<{
+    /** The icon component — pass a `lucide-vue-next` icon, custom SVG component, or any matching shape. */
+    icon: IconAdapter;
+    /** The pixel size of the rendered SVG. Default 20. */
+    size?: number;
+}> & Readonly<{}>, {
+    size: number;
+}, {}, {}, {}, string, ComponentProvideOptions, false, {}, any>;
+export default _default;

package/dist/foundation/icons/Spinner.vue.d.ts

@@ -0,0 +1,7 @@
+import { DefineComponent, ComponentOptionsMixin, PublicProps, ComponentProvideOptions } from 'vue';
+export interface SpinnerProps {
+    /** The extra classes merged onto the underlying SVG. */
+    className?: string;
+}
+declare const _default: DefineComponent<SpinnerProps, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly<SpinnerProps> & Readonly<{}>, {}, {}, {}, {}, string, ComponentProvideOptions, false, {}, any>;
+export default _default;

package/dist/foundation/icons/index.d.ts

@@ -0,0 +1,2 @@
+export { default as Icon, type IconProps, type IconAdapter, type IconAdapterProps, } from './Icon.vue';
+export { default as Spinner, type SpinnerProps } from './Spinner.vue';

package/dist/foundation/icons/index.js

@@ -0,0 +1,7 @@
+import { _ } from "../../chunks/Icon.vue_vue_type_script_setup_true_lang-DgwdLCRR.js";
+import { _ as _2 } from "../../chunks/Spinner.vue_vue_type_script_setup_true_lang-BAepBy2n.js";
+export {
+  _ as Icon,
+  _2 as Spinner
+};
+//# sourceMappingURL=index.js.map

package/dist/foundation/icons/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;"}

package/dist/foundation/idb/IdbPromises.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Wraps a single-shot `IDBRequest` as a promise resolving to its `result`. Settles exactly once: on
+ * `success` with the result, on `error` with the request's `DOMException` (normalized to an `Error` when the
+ * browser leaves it null).
+ *
+ * Must be called in the same task the request was created in (TRAP 3), and must NOT be used for a cursor
+ * request (TRAP 2) — use `iterate` instead.
+ *
+ * Rejecting here does **not** stop the failure from propagating: an unhandled request error bubbles to the
+ * transaction and aborts it, which is IndexedDB's designed behaviour and usually what you want. A caller
+ * that needs the transaction to survive a failed request must handle it inside the request's own event
+ * callback, which this wrapper deliberately does not expose.
+ */
+export declare function requestToPromise<TResult>(request: IDBRequest<TResult>): Promise<TResult>;
+/**
+ * Wraps an `IDBTransaction` as a promise that resolves when it **commits** (`complete`) and rejects when it
+ * fails (`error`) or is rolled back (`abort`). Settles exactly once.
+ *
+ * Resolving on `complete` rather than on the last request's success is the point: only `complete` means the
+ * writes are durable. An `abort` — whether from an unhandled request error, an explicit `abort()` call, or a
+ * quota failure — rejects, so a caller cannot mistake a rolled-back transaction for a committed one.
+ *
+ * Must be called in the same task the transaction was created in (TRAP 3).
+ */
+export declare function transactionToPromise(transaction: IDBTransaction): Promise<void>;

package/dist/foundation/idb/IndexedDbSupport.d.ts

@@ -0,0 +1,32 @@
+/** The default ceiling, in milliseconds, `probeIndexedDb` waits for a verdict before answering `false`. */
+export declare const DefaultProbeTimeoutMs = 2000;
+/**
+ * Reads the ambient `IDBFactory`, or `undefined` when the runtime has none (SSR, a worker without the
+ * API) or when reading it throws (a sandboxed iframe raising `SecurityError` from the getter).
+ */
+export declare function resolveIndexedDb(): IDBFactory | undefined;
+/**
+ * Reports whether an `IDBFactory` is present and structurally usable — the synchronous gate. True in every
+ * browser; false under SSR, in a sandboxed iframe, and in runtimes without the API (plain Node).
+ *
+ * **Not a guarantee that a database will open.** Firefox private browsing exposes the full API and fails on
+ * `open()`; only {@link probeIndexedDb} detects that. Use this to skip work that would obviously fail, and
+ * the async probe before committing a feature to IndexedDB.
+ */
+export declare function isIndexedDbAvailable(): boolean;
+/**
+ * Reports whether IndexedDB actually **works**, by opening a throwaway database and deleting it again.
+ * Catches the private-mode case {@link isIndexedDbAvailable} cannot: an API that is present but whose
+ * `open()` throws or errors.
+ *
+ * Never throws and never hangs — a synchronous throw, an `error` event, a `blocked` open, and a runtime
+ * that simply never answers all resolve to `false` once `timeoutMs` elapses. Cache the result; the probe
+ * costs a real database round trip.
+ */
+export declare function probeIndexedDb(timeoutMs?: number): Promise<boolean>;
+/**
+ * Returns the ambient `IDBFactory`, throwing a diagnostic `Error` when unavailable. Internal — every public
+ * entry point in this slice is promise-returning, so this throw always surfaces to the caller as a
+ * **rejection**, never a synchronous throw. Not exported from the barrel.
+ */
+export declare function requireIndexedDb(): IDBFactory;