@noambz/ui 0.7.0

package/dist/hooks/usePaginatedQuery.d.ts

@@ -0,0 +1,31 @@
+export interface IPaginatedResponse<T> {
+    data: T[];
+    total: number;
+    page: number;
+    pageSize: number;
+    totalPages: number;
+}
+export interface IUsePaginatedQueryOptions {
+    enabled?: boolean;
+    refetchInterval?: number;
+    staleTimeMs?: number;
+}
+type QueryParamValue = string | number | boolean | undefined | null;
+/**
+ * Generic paginated data-fetching hook. Builds a URL with query params from
+ * `params`, fetches the `IPaginatedResponse<T>` envelope, and returns it
+ * alongside React Query state.
+ */
+export declare function usePaginatedQuery<T>(key: readonly unknown[], url: string, params: Record<string, QueryParamValue>, options?: IUsePaginatedQueryOptions): {
+    isLoading: boolean;
+    isFetching: boolean;
+    error: Error | null;
+    dataUpdatedAt: number;
+    data: T[];
+    total: number;
+    page: number;
+    pageSize: number;
+    totalPages: number;
+};
+export {};
+//# sourceMappingURL=usePaginatedQuery.d.ts.map

package/dist/hooks/usePaginatedQuery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usePaginatedQuery.d.ts","sourceRoot":"","sources":["../../src/hooks/usePaginatedQuery.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,kBAAkB,CAAC,CAAC;IACnC,IAAI,EAAE,CAAC,EAAE,CAAC;IACV,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,yBAAyB;IACxC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAYD,KAAK,eAAe,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,GAAG,IAAI,CAAC;AAEpE;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,EACjC,GAAG,EAAE,SAAS,OAAO,EAAE,EACvB,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,EACvC,OAAO,CAAC,EAAE,yBAAyB;;;;;;WAjC5B,MAAM;UACP,MAAM;cACF,MAAM;gBACJ,MAAM;EA+DnB"}

package/dist/hooks/usePaginatedQuery.js

@@ -0,0 +1,44 @@
+"use client";
+import { keepPreviousData, useQuery } from "@tanstack/react-query";
+const DEFAULT_PAGE_SIZE = 20;
+const EMPTY = {
+  data: [],
+  total: 0,
+  page: 1,
+  pageSize: DEFAULT_PAGE_SIZE,
+  totalPages: 1
+};
+function usePaginatedQuery(key, url, params, options) {
+  const searchParams = new URLSearchParams();
+  for (const [k, v] of Object.entries(params)) {
+    if (v != null && v !== "" && v !== false) {
+      searchParams.set(k, String(v));
+    }
+  }
+  const qs = searchParams.toString();
+  const fullUrl = qs ? `${url}?${qs}` : url;
+  const query = useQuery({
+    queryKey: [...key, params],
+    queryFn: async () => {
+      const res = await fetch(fullUrl);
+      if (!res.ok) throw new Error(`HTTP ${res.status}`);
+      return res.json();
+    },
+    placeholderData: keepPreviousData,
+    enabled: options?.enabled,
+    refetchInterval: options?.refetchInterval,
+    staleTime: options?.staleTimeMs
+  });
+  const result = query.data ?? EMPTY;
+  return {
+    ...result,
+    isLoading: query.isLoading,
+    isFetching: query.isFetching,
+    error: query.error,
+    dataUpdatedAt: query.dataUpdatedAt
+  };
+}
+export {
+  usePaginatedQuery
+};
+//# sourceMappingURL=usePaginatedQuery.js.map

package/dist/hooks/usePaginatedQuery.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/hooks/usePaginatedQuery.ts"],"sourcesContent":["\"use client\";\n\nimport { keepPreviousData, useQuery } from \"@tanstack/react-query\";\n\nexport interface IPaginatedResponse<T> {\n  data: T[];\n  total: number;\n  page: number;\n  pageSize: number;\n  totalPages: number;\n}\n\nexport interface IUsePaginatedQueryOptions {\n  enabled?: boolean;\n  refetchInterval?: number;\n  staleTimeMs?: number;\n}\n\nconst DEFAULT_PAGE_SIZE = 20;\n\nconst EMPTY: IPaginatedResponse<never> = {\n  data: [],\n  total: 0,\n  page: 1,\n  pageSize: DEFAULT_PAGE_SIZE,\n  totalPages: 1,\n};\n\ntype QueryParamValue = string | number | boolean | undefined | null;\n\n/**\n * Generic paginated data-fetching hook. Builds a URL with query params from\n * `params`, fetches the `IPaginatedResponse<T>` envelope, and returns it\n * alongside React Query state.\n */\nexport function usePaginatedQuery<T>(\n  key: readonly unknown[],\n  url: string,\n  params: Record<string, QueryParamValue>,\n  options?: IUsePaginatedQueryOptions,\n) {\n  const searchParams = new URLSearchParams();\n  for (const [k, v] of Object.entries(params)) {\n    if (v != null && v !== \"\" && v !== false) {\n      searchParams.set(k, String(v));\n    }\n  }\n  const qs = searchParams.toString();\n  const fullUrl = qs ? `${url}?${qs}` : url;\n\n  const query = useQuery<IPaginatedResponse<T>>({\n    queryKey: [...key, params],\n    queryFn: async () => {\n      const res = await fetch(fullUrl);\n      if (!res.ok) throw new Error(`HTTP ${res.status}`);\n      return res.json();\n    },\n    placeholderData: keepPreviousData,\n    enabled: options?.enabled,\n    refetchInterval: options?.refetchInterval,\n    staleTime: options?.staleTimeMs,\n  });\n\n  const result = query.data ?? (EMPTY as IPaginatedResponse<T>);\n\n  return {\n    ...result,\n    isLoading: query.isLoading,\n    isFetching: query.isFetching,\n    error: query.error,\n    dataUpdatedAt: query.dataUpdatedAt,\n  };\n}\n"],"mappings":";AAEA,SAAS,kBAAkB,gBAAgB;AAgB3C,MAAM,oBAAoB;AAE1B,MAAM,QAAmC;AAAA,EACvC,MAAM,CAAC;AAAA,EACP,OAAO;AAAA,EACP,MAAM;AAAA,EACN,UAAU;AAAA,EACV,YAAY;AACd;AASO,SAAS,kBACd,KACA,KACA,QACA,SACA;AACA,QAAM,eAAe,IAAI,gBAAgB;AACzC,aAAW,CAAC,GAAG,CAAC,KAAK,OAAO,QAAQ,MAAM,GAAG;AAC3C,QAAI,KAAK,QAAQ,MAAM,MAAM,MAAM,OAAO;AACxC,mBAAa,IAAI,GAAG,OAAO,CAAC,CAAC;AAAA,IAC/B;AAAA,EACF;AACA,QAAM,KAAK,aAAa,SAAS;AACjC,QAAM,UAAU,KAAK,GAAG,GAAG,IAAI,EAAE,KAAK;AAEtC,QAAM,QAAQ,SAAgC;AAAA,IAC5C,UAAU,CAAC,GAAG,KAAK,MAAM;AAAA,IACzB,SAAS,YAAY;AACnB,YAAM,MAAM,MAAM,MAAM,OAAO;AAC/B,UAAI,CAAC,IAAI,GAAI,OAAM,IAAI,MAAM,QAAQ,IAAI,MAAM,EAAE;AACjD,aAAO,IAAI,KAAK;AAAA,IAClB;AAAA,IACA,iBAAiB;AAAA,IACjB,SAAS,SAAS;AAAA,IAClB,iBAAiB,SAAS;AAAA,IAC1B,WAAW,SAAS;AAAA,EACtB,CAAC;AAED,QAAM,SAAS,MAAM,QAAS;AAE9B,SAAO;AAAA,IACL,GAAG;AAAA,IACH,WAAW,MAAM;AAAA,IACjB,YAAY,MAAM;AAAA,IAClB,OAAO,MAAM;AAAA,IACb,eAAe,MAAM;AAAA,EACvB;AACF;","names":[]}

package/dist/i18n/createI18n.d.ts

@@ -0,0 +1,16 @@
+export type NestedKeyOf<T> = T extends object ? {
+    [K in keyof T & string]: T[K] extends object ? `${K}.${NestedKeyOf<T[K]>}` : K;
+}[keyof T & string] : never;
+export interface II18n<TLocale extends string, TKey extends string> {
+    getTranslation: (locale: TLocale) => (key: TKey) => string;
+    isRtl: (locale: TLocale) => boolean;
+}
+/**
+ * Create a strongly-typed i18n helper from a translations object. The first
+ * locale's keys are used to infer the TKey union, so consumers get
+ * IntelliSense and compile-time safety on translation keys.
+ *
+ * Missing keys fall back to the key string itself so rendering never throws.
+ */
+export declare function createI18n<TMessages extends object, TLocale extends string = string>(translations: Record<TLocale, TMessages>, rtlLocales?: readonly string[]): II18n<TLocale, NestedKeyOf<TMessages>>;
+//# sourceMappingURL=createI18n.d.ts.map

package/dist/i18n/createI18n.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createI18n.d.ts","sourceRoot":"","sources":["../../src/i18n/createI18n.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,WAAW,CAAC,CAAC,IAAI,CAAC,SAAS,MAAM,GACzC;KACG,CAAC,IAAI,MAAM,CAAC,GAAG,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,MAAM,GACxC,GAAG,CAAC,IAAI,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,GAC3B,CAAC;CACN,CAAC,MAAM,CAAC,GAAG,MAAM,CAAC,GACnB,KAAK,CAAC;AAIV,MAAM,WAAW,KAAK,CAAC,OAAO,SAAS,MAAM,EAAE,IAAI,SAAS,MAAM;IAChE,cAAc,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,CAAC,GAAG,EAAE,IAAI,KAAK,MAAM,CAAC;IAC3D,KAAK,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,OAAO,CAAC;CACrC;AAED;;;;;;GAMG;AACH,wBAAgB,UAAU,CACxB,SAAS,SAAS,MAAM,EACxB,OAAO,SAAS,MAAM,GAAG,MAAM,EAE/B,YAAY,EAAE,MAAM,CAAC,OAAO,EAAE,SAAS,CAAC,EACxC,UAAU,GAAE,SAAS,MAAM,EAAwB,GAClD,KAAK,CAAC,OAAO,EAAE,WAAW,CAAC,SAAS,CAAC,CAAC,CAwBxC"}

package/dist/i18n/createI18n.js

@@ -0,0 +1,26 @@
+const DEFAULT_RTL_LOCALES = ["he", "ar", "fa", "ur"];
+function createI18n(translations, rtlLocales = DEFAULT_RTL_LOCALES) {
+  function getTranslation(locale) {
+    const dict = translations[locale];
+    return (key) => {
+      const segments = key.split(".");
+      let value = dict;
+      for (const s of segments) {
+        if (value && typeof value === "object" && s in value) {
+          value = value[s];
+        } else {
+          return key;
+        }
+      }
+      return typeof value === "string" ? value : key;
+    };
+  }
+  function isRtl(locale) {
+    return rtlLocales.includes(locale);
+  }
+  return { getTranslation, isRtl };
+}
+export {
+  createI18n
+};
+//# sourceMappingURL=createI18n.js.map

package/dist/i18n/createI18n.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/i18n/createI18n.ts"],"sourcesContent":["export type NestedKeyOf<T> = T extends object\n  ? {\n      [K in keyof T & string]: T[K] extends object\n        ? `${K}.${NestedKeyOf<T[K]>}`\n        : K;\n    }[keyof T & string]\n  : never;\n\nconst DEFAULT_RTL_LOCALES = [\"he\", \"ar\", \"fa\", \"ur\"] as const;\n\nexport interface II18n<TLocale extends string, TKey extends string> {\n  getTranslation: (locale: TLocale) => (key: TKey) => string;\n  isRtl: (locale: TLocale) => boolean;\n}\n\n/**\n * Create a strongly-typed i18n helper from a translations object. The first\n * locale's keys are used to infer the TKey union, so consumers get\n * IntelliSense and compile-time safety on translation keys.\n *\n * Missing keys fall back to the key string itself so rendering never throws.\n */\nexport function createI18n<\n  TMessages extends object,\n  TLocale extends string = string,\n>(\n  translations: Record<TLocale, TMessages>,\n  rtlLocales: readonly string[] = DEFAULT_RTL_LOCALES,\n): II18n<TLocale, NestedKeyOf<TMessages>> {\n  type TKey = NestedKeyOf<TMessages>;\n\n  function getTranslation(locale: TLocale): (key: TKey) => string {\n    const dict = translations[locale];\n    return (key: TKey): string => {\n      const segments = (key as string).split(\".\");\n      let value: unknown = dict;\n      for (const s of segments) {\n        if (value && typeof value === \"object\" && s in (value as Record<string, unknown>)) {\n          value = (value as Record<string, unknown>)[s];\n        } else {\n          return key as string;\n        }\n      }\n      return typeof value === \"string\" ? value : (key as string);\n    };\n  }\n\n  function isRtl(locale: TLocale): boolean {\n    return rtlLocales.includes(locale);\n  }\n\n  return { getTranslation, isRtl };\n}\n"],"mappings":"AAQA,MAAM,sBAAsB,CAAC,MAAM,MAAM,MAAM,IAAI;AAc5C,SAAS,WAId,cACA,aAAgC,qBACQ;AAGxC,WAAS,eAAe,QAAwC;AAC9D,UAAM,OAAO,aAAa,MAAM;AAChC,WAAO,CAAC,QAAsB;AAC5B,YAAM,WAAY,IAAe,MAAM,GAAG;AAC1C,UAAI,QAAiB;AACrB,iBAAW,KAAK,UAAU;AACxB,YAAI,SAAS,OAAO,UAAU,YAAY,KAAM,OAAmC;AACjF,kBAAS,MAAkC,CAAC;AAAA,QAC9C,OAAO;AACL,iBAAO;AAAA,QACT;AAAA,MACF;AACA,aAAO,OAAO,UAAU,WAAW,QAAS;AAAA,IAC9C;AAAA,EACF;AAEA,WAAS,MAAM,QAA0B;AACvC,WAAO,WAAW,SAAS,MAAM;AAAA,EACnC;AAEA,SAAO,EAAE,gBAAgB,MAAM;AACjC;","names":[]}

package/dist/i18n/index.d.ts

@@ -0,0 +1,3 @@
+export { createI18n } from "./createI18n.js";
+export type { II18n, NestedKeyOf } from "./createI18n.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/i18n/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,YAAY,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/i18n/index.js

@@ -0,0 +1,5 @@
+import { createI18n } from "./createI18n.js";
+export {
+  createI18n
+};
+//# sourceMappingURL=index.js.map

package/dist/i18n/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/i18n/index.ts"],"sourcesContent":["export { createI18n } from \"./createI18n.js\";\nexport type { II18n, NestedKeyOf } from \"./createI18n.js\";\n"],"mappings":"AAAA,SAAS,kBAAkB;","names":[]}

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+export * from "./components/index.js";
+export * from "./hooks/index.js";
+export * from "./i18n/index.js";
+export * from "./utils/index.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,uBAAuB,CAAC;AACtC,cAAc,kBAAkB,CAAC;AACjC,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC"}

package/dist/index.js

@@ -0,0 +1,5 @@
+export * from "./components/index.js";
+export * from "./hooks/index.js";
+export * from "./i18n/index.js";
+export * from "./utils/index.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["export * from \"./components/index.js\";\nexport * from \"./hooks/index.js\";\nexport * from \"./i18n/index.js\";\nexport * from \"./utils/index.js\";\n"],"mappings":"AAAA,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;","names":[]}

package/dist/utils/api-client.d.ts

@@ -0,0 +1,33 @@
+export interface IApiError<TBody = unknown> extends Error {
+    status: number;
+    body: TBody;
+    url: string;
+}
+/**
+ * Construct an Error that carries HTTP metadata. Use instead of throwing a
+ * plain Error so callers can branch on `err.status` or introspect `err.body`.
+ */
+export declare function createApiError<TBody = unknown>(params: {
+    message: string;
+    status: number;
+    body: TBody;
+    url: string;
+}): IApiError<TBody>;
+export interface IApiFetchOptions extends Omit<RequestInit, "body"> {
+    /** JSON-serializable request body. Automatically stringified with JSON content-type. */
+    json?: unknown;
+    /** Alternative to `json` — raw body passthrough (form data, streams, etc.). */
+    body?: BodyInit | null;
+    /** Abort after the specified number of milliseconds. */
+    timeoutMs?: number;
+}
+/**
+ * Thin wrapper around `fetch` that:
+ * - JSON-serializes the body when you pass `json`
+ * - Sets sensible defaults (`Accept: application/json`, credentials: include)
+ * - Throws an `IApiError` for non-2xx responses with the parsed body attached
+ * - Parses JSON responses automatically; returns `null` for empty 204s
+ * - Optional abort-on-timeout with `timeoutMs`
+ */
+export declare function apiFetch<TResponse = unknown>(url: string, options?: IApiFetchOptions): Promise<TResponse>;
+//# sourceMappingURL=api-client.d.ts.map

package/dist/utils/api-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-client.d.ts","sourceRoot":"","sources":["../../src/utils/api-client.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,SAAS,CAAC,KAAK,GAAG,OAAO,CAAE,SAAQ,KAAK;IACvD,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,KAAK,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;CACb;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,KAAK,GAAG,OAAO,EAAE,MAAM,EAAE;IACtD,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,KAAK,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;CACb,GAAG,SAAS,CAAC,KAAK,CAAC,CAMnB;AAeD,MAAM,WAAW,gBAAiB,SAAQ,IAAI,CAAC,WAAW,EAAE,MAAM,CAAC;IACjE,wFAAwF;IACxF,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,+EAA+E;IAC/E,IAAI,CAAC,EAAE,QAAQ,GAAG,IAAI,CAAC;IACvB,wDAAwD;IACxD,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;GAOG;AACH,wBAAsB,QAAQ,CAAC,SAAS,GAAG,OAAO,EAChD,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,gBAAqB,GAC7B,OAAO,CAAC,SAAS,CAAC,CAiDpB"}

package/dist/utils/api-client.js

@@ -0,0 +1,69 @@
+const JSON_CONTENT_TYPE = "application/json";
+const DEFAULT_ACCEPT = "application/json";
+const NETWORK_ERROR_STATUS = 0;
+function createApiError(params) {
+  const err = new Error(params.message);
+  err.status = params.status;
+  err.body = params.body;
+  err.url = params.url;
+  return err;
+}
+async function parseResponseBody(response) {
+  const contentType = response.headers.get("content-type") ?? "";
+  if (contentType.includes("application/json")) {
+    try {
+      return await response.json();
+    } catch {
+      return null;
+    }
+  }
+  const text = await response.text();
+  return text.length > 0 ? text : null;
+}
+async function apiFetch(url, options = {}) {
+  const { json, body, timeoutMs, headers, signal, ...rest } = options;
+  const controller = timeoutMs ? new AbortController() : void 0;
+  const timeoutId = controller ? setTimeout(() => controller.abort(), timeoutMs) : void 0;
+  const mergedHeaders = new Headers(headers);
+  if (!mergedHeaders.has("Accept")) mergedHeaders.set("Accept", DEFAULT_ACCEPT);
+  if (json !== void 0 && !mergedHeaders.has("Content-Type")) {
+    mergedHeaders.set("Content-Type", JSON_CONTENT_TYPE);
+  }
+  try {
+    const response = await fetch(url, {
+      credentials: "include",
+      ...rest,
+      headers: mergedHeaders,
+      body: json !== void 0 ? JSON.stringify(json) : body,
+      signal: signal ?? controller?.signal
+    });
+    const parsedBody = await parseResponseBody(response);
+    if (!response.ok) {
+      throw createApiError({
+        message: `HTTP ${response.status} on ${url}`,
+        status: response.status,
+        body: parsedBody,
+        url
+      });
+    }
+    return parsedBody;
+  } catch (error) {
+    if (error instanceof Error && error.status !== void 0) throw error;
+    if (error instanceof Error) {
+      throw createApiError({
+        message: error.message,
+        status: NETWORK_ERROR_STATUS,
+        body: null,
+        url
+      });
+    }
+    throw error;
+  } finally {
+    if (timeoutId) clearTimeout(timeoutId);
+  }
+}
+export {
+  apiFetch,
+  createApiError
+};
+//# sourceMappingURL=api-client.js.map

package/dist/utils/api-client.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/utils/api-client.ts"],"sourcesContent":["const JSON_CONTENT_TYPE = \"application/json\";\nconst DEFAULT_ACCEPT = \"application/json\";\nconst NETWORK_ERROR_STATUS = 0;\n\nexport interface IApiError<TBody = unknown> extends Error {\n  status: number;\n  body: TBody;\n  url: string;\n}\n\n/**\n * Construct an Error that carries HTTP metadata. Use instead of throwing a\n * plain Error so callers can branch on `err.status` or introspect `err.body`.\n */\nexport function createApiError<TBody = unknown>(params: {\n  message: string;\n  status: number;\n  body: TBody;\n  url: string;\n}): IApiError<TBody> {\n  const err = new Error(params.message) as IApiError<TBody>;\n  err.status = params.status;\n  err.body = params.body;\n  err.url = params.url;\n  return err;\n}\n\nasync function parseResponseBody(response: Response): Promise<unknown> {\n  const contentType = response.headers.get(\"content-type\") ?? \"\";\n  if (contentType.includes(\"application/json\")) {\n    try {\n      return await response.json();\n    } catch {\n      return null;\n    }\n  }\n  const text = await response.text();\n  return text.length > 0 ? text : null;\n}\n\nexport interface IApiFetchOptions extends Omit<RequestInit, \"body\"> {\n  /** JSON-serializable request body. Automatically stringified with JSON content-type. */\n  json?: unknown;\n  /** Alternative to `json` — raw body passthrough (form data, streams, etc.). */\n  body?: BodyInit | null;\n  /** Abort after the specified number of milliseconds. */\n  timeoutMs?: number;\n}\n\n/**\n * Thin wrapper around `fetch` that:\n * - JSON-serializes the body when you pass `json`\n * - Sets sensible defaults (`Accept: application/json`, credentials: include)\n * - Throws an `IApiError` for non-2xx responses with the parsed body attached\n * - Parses JSON responses automatically; returns `null` for empty 204s\n * - Optional abort-on-timeout with `timeoutMs`\n */\nexport async function apiFetch<TResponse = unknown>(\n  url: string,\n  options: IApiFetchOptions = {},\n): Promise<TResponse> {\n  const { json, body, timeoutMs, headers, signal, ...rest } = options;\n\n  const controller = timeoutMs ? new AbortController() : undefined;\n  const timeoutId = controller\n    ? setTimeout(() => controller.abort(), timeoutMs)\n    : undefined;\n\n  const mergedHeaders = new Headers(headers);\n  if (!mergedHeaders.has(\"Accept\")) mergedHeaders.set(\"Accept\", DEFAULT_ACCEPT);\n  if (json !== undefined && !mergedHeaders.has(\"Content-Type\")) {\n    mergedHeaders.set(\"Content-Type\", JSON_CONTENT_TYPE);\n  }\n\n  try {\n    const response = await fetch(url, {\n      credentials: \"include\",\n      ...rest,\n      headers: mergedHeaders,\n      body: json !== undefined ? JSON.stringify(json) : body,\n      signal: signal ?? controller?.signal,\n    });\n\n    const parsedBody = await parseResponseBody(response);\n\n    if (!response.ok) {\n      throw createApiError({\n        message: `HTTP ${response.status} on ${url}`,\n        status: response.status,\n        body: parsedBody,\n        url,\n      });\n    }\n\n    return parsedBody as TResponse;\n  } catch (error) {\n    if (error instanceof Error && (error as IApiError).status !== undefined) throw error;\n    if (error instanceof Error) {\n      throw createApiError({\n        message: error.message,\n        status: NETWORK_ERROR_STATUS,\n        body: null,\n        url,\n      });\n    }\n    throw error;\n  } finally {\n    if (timeoutId) clearTimeout(timeoutId);\n  }\n}\n"],"mappings":"AAAA,MAAM,oBAAoB;AAC1B,MAAM,iBAAiB;AACvB,MAAM,uBAAuB;AAYtB,SAAS,eAAgC,QAK3B;AACnB,QAAM,MAAM,IAAI,MAAM,OAAO,OAAO;AACpC,MAAI,SAAS,OAAO;AACpB,MAAI,OAAO,OAAO;AAClB,MAAI,MAAM,OAAO;AACjB,SAAO;AACT;AAEA,eAAe,kBAAkB,UAAsC;AACrE,QAAM,cAAc,SAAS,QAAQ,IAAI,cAAc,KAAK;AAC5D,MAAI,YAAY,SAAS,kBAAkB,GAAG;AAC5C,QAAI;AACF,aAAO,MAAM,SAAS,KAAK;AAAA,IAC7B,QAAQ;AACN,aAAO;AAAA,IACT;AAAA,EACF;AACA,QAAM,OAAO,MAAM,SAAS,KAAK;AACjC,SAAO,KAAK,SAAS,IAAI,OAAO;AAClC;AAmBA,eAAsB,SACpB,KACA,UAA4B,CAAC,GACT;AACpB,QAAM,EAAE,MAAM,MAAM,WAAW,SAAS,QAAQ,GAAG,KAAK,IAAI;AAE5D,QAAM,aAAa,YAAY,IAAI,gBAAgB,IAAI;AACvD,QAAM,YAAY,aACd,WAAW,MAAM,WAAW,MAAM,GAAG,SAAS,IAC9C;AAEJ,QAAM,gBAAgB,IAAI,QAAQ,OAAO;AACzC,MAAI,CAAC,cAAc,IAAI,QAAQ,EAAG,eAAc,IAAI,UAAU,cAAc;AAC5E,MAAI,SAAS,UAAa,CAAC,cAAc,IAAI,cAAc,GAAG;AAC5D,kBAAc,IAAI,gBAAgB,iBAAiB;AAAA,EACrD;AAEA,MAAI;AACF,UAAM,WAAW,MAAM,MAAM,KAAK;AAAA,MAChC,aAAa;AAAA,MACb,GAAG;AAAA,MACH,SAAS;AAAA,MACT,MAAM,SAAS,SAAY,KAAK,UAAU,IAAI,IAAI;AAAA,MAClD,QAAQ,UAAU,YAAY;AAAA,IAChC,CAAC;AAED,UAAM,aAAa,MAAM,kBAAkB,QAAQ;AAEnD,QAAI,CAAC,SAAS,IAAI;AAChB,YAAM,eAAe;AAAA,QACnB,SAAS,QAAQ,SAAS,MAAM,OAAO,GAAG;AAAA,QAC1C,QAAQ,SAAS;AAAA,QACjB,MAAM;AAAA,QACN;AAAA,MACF,CAAC;AAAA,IACH;AAEA,WAAO;AAAA,EACT,SAAS,OAAO;AACd,QAAI,iBAAiB,SAAU,MAAoB,WAAW,OAAW,OAAM;AAC/E,QAAI,iBAAiB,OAAO;AAC1B,YAAM,eAAe;AAAA,QACnB,SAAS,MAAM;AAAA,QACf,QAAQ;AAAA,QACR,MAAM;AAAA,QACN;AAAA,MACF,CAAC;AAAA,IACH;AACA,UAAM;AAAA,EACR,UAAE;AACA,QAAI,UAAW,cAAa,SAAS;AAAA,EACvC;AACF;","names":[]}

package/dist/utils/cn.d.ts

@@ -0,0 +1,12 @@
+import { type ClassValue } from "clsx";
+/**
+ * Compose Tailwind class names with automatic de-duplication.
+ *
+ * Combines `clsx` (for conditional class handling) with `tailwind-merge` (for
+ * collapsing conflicting utilities — e.g. `px-2 px-4` resolves to `px-4`).
+ * Every component in this package authored after 0.2.0 composes classes
+ * through this helper so consumers can pass overriding `className` props
+ * without fighting specificity.
+ */
+export declare function cn(...inputs: ClassValue[]): string;
+//# sourceMappingURL=cn.d.ts.map

package/dist/utils/cn.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cn.d.ts","sourceRoot":"","sources":["../../src/utils/cn.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,UAAU,EAAQ,MAAM,MAAM,CAAC;AAG7C;;;;;;;;GAQG;AACH,wBAAgB,EAAE,CAAC,GAAG,MAAM,EAAE,UAAU,EAAE,GAAG,MAAM,CAElD"}

package/dist/utils/cn.js

@@ -0,0 +1,9 @@
+import { clsx } from "clsx";
+import { twMerge } from "tailwind-merge";
+function cn(...inputs) {
+  return twMerge(clsx(inputs));
+}
+export {
+  cn
+};
+//# sourceMappingURL=cn.js.map

package/dist/utils/cn.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/utils/cn.ts"],"sourcesContent":["import { type ClassValue, clsx } from \"clsx\";\nimport { twMerge } from \"tailwind-merge\";\n\n/**\n * Compose Tailwind class names with automatic de-duplication.\n *\n * Combines `clsx` (for conditional class handling) with `tailwind-merge` (for\n * collapsing conflicting utilities — e.g. `px-2 px-4` resolves to `px-4`).\n * Every component in this package authored after 0.2.0 composes classes\n * through this helper so consumers can pass overriding `className` props\n * without fighting specificity.\n */\nexport function cn(...inputs: ClassValue[]): string {\n  return twMerge(clsx(inputs));\n}\n"],"mappings":"AAAA,SAA0B,YAAY;AACtC,SAAS,eAAe;AAWjB,SAAS,MAAM,QAA8B;AAClD,SAAO,QAAQ,KAAK,MAAM,CAAC;AAC7B;","names":[]}

package/dist/utils/format.d.ts

@@ -0,0 +1,69 @@
+export interface IRelativeDurationLabels {
+    justNow: string;
+    secondsAgo: (n: number) => string;
+    minutesAgo: (n: number) => string;
+    hoursAgo: (n: number) => string;
+    daysAgo: (n: number) => string;
+    weeksAgo: (n: number) => string;
+    monthsAgo: (n: number) => string;
+    yearsAgo: (n: number) => string;
+}
+/**
+ * Format a past timestamp as a compact relative duration (e.g. "5m ago").
+ * Pass `labels` for localization; defaults to short English.
+ */
+export declare function formatRelativeDuration(timestamp: number | Date, now?: number | Date, labels?: IRelativeDurationLabels): string;
+/**
+ * Convert a `dd/mm` user-typed date to an ISO `YYYY-MM-DD` string by assuming
+ * the nearest upcoming occurrence of that day/month. Useful for flight-search
+ * date inputs where users type compact dates without a year.
+ */
+export declare function ddmmToISO(input: string, referenceDate?: Date): string | null;
+/**
+ * @deprecated Use `formatDate(iso, { style: "medium", locale })` instead.
+ * Format an ISO date (`YYYY-MM-DD`) as a short display string via Intl.
+ */
+export declare function formatIsoDate(iso: string, locale?: string): string;
+export type IFormatDateStyle = "short" | "medium" | "long" | "full" | "iso" | "time" | "datetime" | "relative";
+export interface IFormatDateOptions {
+    style?: IFormatDateStyle;
+    locale?: string;
+    /** `date-fns` format string. When provided, `style` is ignored. */
+    pattern?: string;
+    /** Reference point for `style: "relative"` (defaults to now). */
+    now?: number | Date;
+    relativeLabels?: IRelativeDurationLabels;
+}
+/**
+ * Format a date value (Date, timestamp ms, or ISO string) for display.
+ *
+ * Styles map to `Intl.DateTimeFormat` where possible; `iso` returns
+ * `YYYY-MM-DD`, `relative` delegates to `formatRelativeDuration`, and
+ * `pattern` uses a raw `date-fns` format string.
+ */
+export declare function formatDate(input: string | number | Date, options?: IFormatDateOptions): string;
+export interface IFormatCurrencyOptions {
+    locale?: string;
+    minimumFractionDigits?: number;
+    maximumFractionDigits?: number;
+    compact?: boolean;
+    signDisplay?: Intl.NumberFormatOptions["signDisplay"];
+}
+/**
+ * Format a numeric amount as localized currency using `Intl.NumberFormat`.
+ * Pass `compact: true` to get "$1.2K" / "$3.4M" style output.
+ */
+export declare function formatCurrency(amount: number, currency?: string, options?: IFormatCurrencyOptions): string;
+export interface IFormatNumberOptions {
+    locale?: string;
+    decimals?: number;
+    compact?: boolean;
+    percentage?: boolean;
+    signDisplay?: Intl.NumberFormatOptions["signDisplay"];
+}
+/**
+ * Format a number for display: `"1,234.5"`, `"1.2K"`, `"42.1%"`, etc.
+ * When `percentage: true`, the value is multiplied by 100 (matching Intl).
+ */
+export declare function formatNumber(value: number, options?: IFormatNumberOptions): string;
+//# sourceMappingURL=format.d.ts.map

package/dist/utils/format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../../src/utils/format.ts"],"names":[],"mappings":"AAWA,MAAM,WAAW,uBAAuB;IACtC,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,MAAM,CAAC;IAClC,UAAU,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,MAAM,CAAC;IAClC,QAAQ,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,MAAM,CAAC;IAChC,OAAO,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,MAAM,CAAC;IAC/B,QAAQ,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,MAAM,CAAC;IAChC,SAAS,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,MAAM,CAAC;IACjC,QAAQ,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,MAAM,CAAC;CACjC;AAaD;;;GAGG;AACH,wBAAgB,sBAAsB,CACpC,SAAS,EAAE,MAAM,GAAG,IAAI,EACxB,GAAG,GAAE,MAAM,GAAG,IAAiB,EAC/B,MAAM,GAAE,uBAA2C,GAClD,MAAM,CAeR;AAOD;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,aAAa,GAAE,IAAiB,GAAG,MAAM,GAAG,IAAI,CAsBxF;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,SAAU,GAAG,MAAM,CAKnE;AAED,MAAM,MAAM,gBAAgB,GAAG,OAAO,GAAG,QAAQ,GAAG,MAAM,GAAG,MAAM,GAAG,KAAK,GAAG,MAAM,GAAG,UAAU,GAAG,UAAU,CAAC;AAE/G,MAAM,WAAW,kBAAkB;IACjC,KAAK,CAAC,EAAE,gBAAgB,CAAC;IACzB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,mEAAmE;IACnE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,iEAAiE;IACjE,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,cAAc,CAAC,EAAE,uBAAuB,CAAC;CAC1C;AA8BD;;;;;;GAMG;AACH,wBAAgB,UAAU,CACxB,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,EAC7B,OAAO,GAAE,kBAAuB,GAC/B,MAAM,CAiBR;AAED,MAAM,WAAW,sBAAsB;IACrC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,WAAW,CAAC,EAAE,IAAI,CAAC,mBAAmB,CAAC,aAAa,CAAC,CAAC;CACvD;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAC5B,MAAM,EAAE,MAAM,EACd,QAAQ,GAAE,MAAc,EACxB,OAAO,GAAE,sBAA2B,GACnC,MAAM,CAiBR;AAED,MAAM,WAAW,oBAAoB;IACnC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,WAAW,CAAC,EAAE,IAAI,CAAC,mBAAmB,CAAC,aAAa,CAAC,CAAC;CACvD;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAC1B,KAAK,EAAE,MAAM,EACb,OAAO,GAAE,oBAAyB,GACjC,MAAM,CASR"}

package/dist/utils/format.js

@@ -0,0 +1,141 @@
+import { format as dfFormat, parseISO, isValid } from "date-fns";
+const ONE_SECOND_MS = 1e3;
+const ONE_MINUTE_MS = 60 * ONE_SECOND_MS;
+const ONE_HOUR_MS = 60 * ONE_MINUTE_MS;
+const ONE_DAY_MS = 24 * ONE_HOUR_MS;
+const ONE_WEEK_MS = 7 * ONE_DAY_MS;
+const ONE_MONTH_MS = 30 * ONE_DAY_MS;
+const ONE_YEAR_MS = 365 * ONE_DAY_MS;
+const JUST_NOW_SECONDS_THRESHOLD = 5;
+const DEFAULT_EN_LABELS = {
+  justNow: "just now",
+  secondsAgo: (n) => `${n}s ago`,
+  minutesAgo: (n) => `${n}m ago`,
+  hoursAgo: (n) => `${n}h ago`,
+  daysAgo: (n) => `${n}d ago`,
+  weeksAgo: (n) => `${n}w ago`,
+  monthsAgo: (n) => `${n}mo ago`,
+  yearsAgo: (n) => `${n}y ago`
+};
+function formatRelativeDuration(timestamp, now = Date.now(), labels = DEFAULT_EN_LABELS) {
+  const then = timestamp instanceof Date ? timestamp.getTime() : timestamp;
+  const ref = now instanceof Date ? now.getTime() : now;
+  const diff = Math.max(0, ref - then);
+  if (diff < ONE_MINUTE_MS) {
+    const seconds = Math.floor(diff / ONE_SECOND_MS);
+    return seconds < JUST_NOW_SECONDS_THRESHOLD ? labels.justNow : labels.secondsAgo(seconds);
+  }
+  if (diff < ONE_HOUR_MS) return labels.minutesAgo(Math.floor(diff / ONE_MINUTE_MS));
+  if (diff < ONE_DAY_MS) return labels.hoursAgo(Math.floor(diff / ONE_HOUR_MS));
+  if (diff < ONE_WEEK_MS) return labels.daysAgo(Math.floor(diff / ONE_DAY_MS));
+  if (diff < ONE_MONTH_MS) return labels.weeksAgo(Math.floor(diff / ONE_WEEK_MS));
+  if (diff < ONE_YEAR_MS) return labels.monthsAgo(Math.floor(diff / ONE_MONTH_MS));
+  return labels.yearsAgo(Math.floor(diff / ONE_YEAR_MS));
+}
+const DD_MM_LENGTH = 5;
+const ISO_DATE_LENGTH = 10;
+const MAX_MONTH = 12;
+const MAX_DAY = 31;
+function ddmmToISO(input, referenceDate = /* @__PURE__ */ new Date()) {
+  if (input.length !== DD_MM_LENGTH) return null;
+  const [ddRaw, mmRaw] = input.split("/");
+  const dd = Number(ddRaw);
+  const mm = Number(mmRaw);
+  if (!Number.isInteger(dd) || !Number.isInteger(mm)) return null;
+  if (mm < 1 || mm > MAX_MONTH || dd < 1 || dd > MAX_DAY) return null;
+  const year = referenceDate.getFullYear();
+  const candidate = new Date(year, mm - 1, dd);
+  candidate.setHours(0, 0, 0, 0);
+  const reference = new Date(referenceDate);
+  reference.setHours(0, 0, 0, 0);
+  if (candidate.getTime() < reference.getTime()) {
+    candidate.setFullYear(year + 1);
+  }
+  const isoYear = candidate.getFullYear();
+  const isoMonth = String(candidate.getMonth() + 1).padStart(2, "0");
+  const isoDay = String(candidate.getDate()).padStart(2, "0");
+  return `${isoYear}-${isoMonth}-${isoDay}`;
+}
+function formatIsoDate(iso, locale = "en-US") {
+  if (iso.length !== ISO_DATE_LENGTH) return iso;
+  const date = /* @__PURE__ */ new Date(`${iso}T00:00:00`);
+  if (Number.isNaN(date.getTime())) return iso;
+  return date.toLocaleDateString(locale, { year: "numeric", month: "short", day: "numeric" });
+}
+const DATE_STYLE_INTL_MAP = {
+  short: { year: "numeric", month: "numeric", day: "numeric" },
+  medium: { year: "numeric", month: "short", day: "numeric" },
+  long: { year: "numeric", month: "long", day: "numeric" },
+  full: { weekday: "long", year: "numeric", month: "long", day: "numeric" }
+};
+const TIME_INTL_OPTIONS = { hour: "numeric", minute: "2-digit" };
+const DATETIME_INTL_OPTIONS = {
+  year: "numeric",
+  month: "short",
+  day: "numeric",
+  hour: "numeric",
+  minute: "2-digit"
+};
+function toDate(input) {
+  if (input instanceof Date) return isValid(input) ? input : null;
+  if (typeof input === "number") {
+    const d = new Date(input);
+    return isValid(d) ? d : null;
+  }
+  const iso = parseISO(input);
+  if (isValid(iso)) return iso;
+  const fallback = new Date(input);
+  return isValid(fallback) ? fallback : null;
+}
+function formatDate(input, options = {}) {
+  const { style = "medium", locale = "en-US", pattern, now, relativeLabels } = options;
+  const date = toDate(input);
+  if (!date) return typeof input === "string" ? input : "";
+  if (pattern) return dfFormat(date, pattern);
+  if (style === "iso") {
+    const y = date.getFullYear();
+    const m = String(date.getMonth() + 1).padStart(2, "0");
+    const d = String(date.getDate()).padStart(2, "0");
+    return `${y}-${m}-${d}`;
+  }
+  if (style === "time") return date.toLocaleTimeString(locale, TIME_INTL_OPTIONS);
+  if (style === "datetime") return date.toLocaleString(locale, DATETIME_INTL_OPTIONS);
+  if (style === "relative") return formatRelativeDuration(date, now, relativeLabels);
+  return date.toLocaleDateString(locale, DATE_STYLE_INTL_MAP[style]);
+}
+function formatCurrency(amount, currency = "USD", options = {}) {
+  const {
+    locale = "en-US",
+    minimumFractionDigits,
+    maximumFractionDigits,
+    compact = false,
+    signDisplay
+  } = options;
+  return new Intl.NumberFormat(locale, {
+    style: "currency",
+    currency,
+    minimumFractionDigits,
+    maximumFractionDigits,
+    notation: compact ? "compact" : "standard",
+    signDisplay
+  }).format(amount);
+}
+function formatNumber(value, options = {}) {
+  const { locale = "en-US", decimals, compact = false, percentage = false, signDisplay } = options;
+  return new Intl.NumberFormat(locale, {
+    style: percentage ? "percent" : "decimal",
+    notation: compact ? "compact" : "standard",
+    minimumFractionDigits: decimals,
+    maximumFractionDigits: decimals,
+    signDisplay
+  }).format(value);
+}
+export {
+  ddmmToISO,
+  formatCurrency,
+  formatDate,
+  formatIsoDate,
+  formatNumber,
+  formatRelativeDuration
+};
+//# sourceMappingURL=format.js.map

package/dist/utils/format.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/utils/format.ts"],"sourcesContent":["import { format as dfFormat, parseISO, isValid } from \"date-fns\";\n\nconst ONE_SECOND_MS = 1000;\nconst ONE_MINUTE_MS = 60 * ONE_SECOND_MS;\nconst ONE_HOUR_MS = 60 * ONE_MINUTE_MS;\nconst ONE_DAY_MS = 24 * ONE_HOUR_MS;\nconst ONE_WEEK_MS = 7 * ONE_DAY_MS;\nconst ONE_MONTH_MS = 30 * ONE_DAY_MS;\nconst ONE_YEAR_MS = 365 * ONE_DAY_MS;\nconst JUST_NOW_SECONDS_THRESHOLD = 5;\n\nexport interface IRelativeDurationLabels {\n  justNow: string;\n  secondsAgo: (n: number) => string;\n  minutesAgo: (n: number) => string;\n  hoursAgo: (n: number) => string;\n  daysAgo: (n: number) => string;\n  weeksAgo: (n: number) => string;\n  monthsAgo: (n: number) => string;\n  yearsAgo: (n: number) => string;\n}\n\nconst DEFAULT_EN_LABELS: IRelativeDurationLabels = {\n  justNow: \"just now\",\n  secondsAgo: (n) => `${n}s ago`,\n  minutesAgo: (n) => `${n}m ago`,\n  hoursAgo: (n) => `${n}h ago`,\n  daysAgo: (n) => `${n}d ago`,\n  weeksAgo: (n) => `${n}w ago`,\n  monthsAgo: (n) => `${n}mo ago`,\n  yearsAgo: (n) => `${n}y ago`,\n};\n\n/**\n * Format a past timestamp as a compact relative duration (e.g. \"5m ago\").\n * Pass `labels` for localization; defaults to short English.\n */\nexport function formatRelativeDuration(\n  timestamp: number | Date,\n  now: number | Date = Date.now(),\n  labels: IRelativeDurationLabels = DEFAULT_EN_LABELS,\n): string {\n  const then = timestamp instanceof Date ? timestamp.getTime() : timestamp;\n  const ref = now instanceof Date ? now.getTime() : now;\n  const diff = Math.max(0, ref - then);\n\n  if (diff < ONE_MINUTE_MS) {\n    const seconds = Math.floor(diff / ONE_SECOND_MS);\n    return seconds < JUST_NOW_SECONDS_THRESHOLD ? labels.justNow : labels.secondsAgo(seconds);\n  }\n  if (diff < ONE_HOUR_MS) return labels.minutesAgo(Math.floor(diff / ONE_MINUTE_MS));\n  if (diff < ONE_DAY_MS) return labels.hoursAgo(Math.floor(diff / ONE_HOUR_MS));\n  if (diff < ONE_WEEK_MS) return labels.daysAgo(Math.floor(diff / ONE_DAY_MS));\n  if (diff < ONE_MONTH_MS) return labels.weeksAgo(Math.floor(diff / ONE_WEEK_MS));\n  if (diff < ONE_YEAR_MS) return labels.monthsAgo(Math.floor(diff / ONE_MONTH_MS));\n  return labels.yearsAgo(Math.floor(diff / ONE_YEAR_MS));\n}\n\nconst DD_MM_LENGTH = 5;\nconst ISO_DATE_LENGTH = 10;\nconst MAX_MONTH = 12;\nconst MAX_DAY = 31;\n\n/**\n * Convert a `dd/mm` user-typed date to an ISO `YYYY-MM-DD` string by assuming\n * the nearest upcoming occurrence of that day/month. Useful for flight-search\n * date inputs where users type compact dates without a year.\n */\nexport function ddmmToISO(input: string, referenceDate: Date = new Date()): string | null {\n  if (input.length !== DD_MM_LENGTH) return null;\n  const [ddRaw, mmRaw] = input.split(\"/\");\n  const dd = Number(ddRaw);\n  const mm = Number(mmRaw);\n  if (!Number.isInteger(dd) || !Number.isInteger(mm)) return null;\n  if (mm < 1 || mm > MAX_MONTH || dd < 1 || dd > MAX_DAY) return null;\n\n  const year = referenceDate.getFullYear();\n  const candidate = new Date(year, mm - 1, dd);\n  candidate.setHours(0, 0, 0, 0);\n  const reference = new Date(referenceDate);\n  reference.setHours(0, 0, 0, 0);\n\n  if (candidate.getTime() < reference.getTime()) {\n    candidate.setFullYear(year + 1);\n  }\n\n  const isoYear = candidate.getFullYear();\n  const isoMonth = String(candidate.getMonth() + 1).padStart(2, \"0\");\n  const isoDay = String(candidate.getDate()).padStart(2, \"0\");\n  return `${isoYear}-${isoMonth}-${isoDay}`;\n}\n\n/**\n * @deprecated Use `formatDate(iso, { style: \"medium\", locale })` instead.\n * Format an ISO date (`YYYY-MM-DD`) as a short display string via Intl.\n */\nexport function formatIsoDate(iso: string, locale = \"en-US\"): string {\n  if (iso.length !== ISO_DATE_LENGTH) return iso;\n  const date = new Date(`${iso}T00:00:00`);\n  if (Number.isNaN(date.getTime())) return iso;\n  return date.toLocaleDateString(locale, { year: \"numeric\", month: \"short\", day: \"numeric\" });\n}\n\nexport type IFormatDateStyle = \"short\" | \"medium\" | \"long\" | \"full\" | \"iso\" | \"time\" | \"datetime\" | \"relative\";\n\nexport interface IFormatDateOptions {\n  style?: IFormatDateStyle;\n  locale?: string;\n  /** `date-fns` format string. When provided, `style` is ignored. */\n  pattern?: string;\n  /** Reference point for `style: \"relative\"` (defaults to now). */\n  now?: number | Date;\n  relativeLabels?: IRelativeDurationLabels;\n}\n\nconst DATE_STYLE_INTL_MAP: Record<Exclude<IFormatDateStyle, \"iso\" | \"time\" | \"datetime\" | \"relative\">, Intl.DateTimeFormatOptions> = {\n  short: { year: \"numeric\", month: \"numeric\", day: \"numeric\" },\n  medium: { year: \"numeric\", month: \"short\", day: \"numeric\" },\n  long: { year: \"numeric\", month: \"long\", day: \"numeric\" },\n  full: { weekday: \"long\", year: \"numeric\", month: \"long\", day: \"numeric\" },\n};\n\nconst TIME_INTL_OPTIONS: Intl.DateTimeFormatOptions = { hour: \"numeric\", minute: \"2-digit\" };\nconst DATETIME_INTL_OPTIONS: Intl.DateTimeFormatOptions = {\n  year: \"numeric\",\n  month: \"short\",\n  day: \"numeric\",\n  hour: \"numeric\",\n  minute: \"2-digit\",\n};\n\nfunction toDate(input: string | number | Date): Date | null {\n  if (input instanceof Date) return isValid(input) ? input : null;\n  if (typeof input === \"number\") {\n    const d = new Date(input);\n    return isValid(d) ? d : null;\n  }\n  const iso = parseISO(input);\n  if (isValid(iso)) return iso;\n  const fallback = new Date(input);\n  return isValid(fallback) ? fallback : null;\n}\n\n/**\n * Format a date value (Date, timestamp ms, or ISO string) for display.\n *\n * Styles map to `Intl.DateTimeFormat` where possible; `iso` returns\n * `YYYY-MM-DD`, `relative` delegates to `formatRelativeDuration`, and\n * `pattern` uses a raw `date-fns` format string.\n */\nexport function formatDate(\n  input: string | number | Date,\n  options: IFormatDateOptions = {},\n): string {\n  const { style = \"medium\", locale = \"en-US\", pattern, now, relativeLabels } = options;\n  const date = toDate(input);\n  if (!date) return typeof input === \"string\" ? input : \"\";\n\n  if (pattern) return dfFormat(date, pattern);\n  if (style === \"iso\") {\n    const y = date.getFullYear();\n    const m = String(date.getMonth() + 1).padStart(2, \"0\");\n    const d = String(date.getDate()).padStart(2, \"0\");\n    return `${y}-${m}-${d}`;\n  }\n  if (style === \"time\") return date.toLocaleTimeString(locale, TIME_INTL_OPTIONS);\n  if (style === \"datetime\") return date.toLocaleString(locale, DATETIME_INTL_OPTIONS);\n  if (style === \"relative\") return formatRelativeDuration(date, now, relativeLabels);\n\n  return date.toLocaleDateString(locale, DATE_STYLE_INTL_MAP[style]);\n}\n\nexport interface IFormatCurrencyOptions {\n  locale?: string;\n  minimumFractionDigits?: number;\n  maximumFractionDigits?: number;\n  compact?: boolean;\n  signDisplay?: Intl.NumberFormatOptions[\"signDisplay\"];\n}\n\n/**\n * Format a numeric amount as localized currency using `Intl.NumberFormat`.\n * Pass `compact: true` to get \"$1.2K\" / \"$3.4M\" style output.\n */\nexport function formatCurrency(\n  amount: number,\n  currency: string = \"USD\",\n  options: IFormatCurrencyOptions = {},\n): string {\n  const {\n    locale = \"en-US\",\n    minimumFractionDigits,\n    maximumFractionDigits,\n    compact = false,\n    signDisplay,\n  } = options;\n\n  return new Intl.NumberFormat(locale, {\n    style: \"currency\",\n    currency,\n    minimumFractionDigits,\n    maximumFractionDigits,\n    notation: compact ? \"compact\" : \"standard\",\n    signDisplay,\n  }).format(amount);\n}\n\nexport interface IFormatNumberOptions {\n  locale?: string;\n  decimals?: number;\n  compact?: boolean;\n  percentage?: boolean;\n  signDisplay?: Intl.NumberFormatOptions[\"signDisplay\"];\n}\n\n/**\n * Format a number for display: `\"1,234.5\"`, `\"1.2K\"`, `\"42.1%\"`, etc.\n * When `percentage: true`, the value is multiplied by 100 (matching Intl).\n */\nexport function formatNumber(\n  value: number,\n  options: IFormatNumberOptions = {},\n): string {\n  const { locale = \"en-US\", decimals, compact = false, percentage = false, signDisplay } = options;\n  return new Intl.NumberFormat(locale, {\n    style: percentage ? \"percent\" : \"decimal\",\n    notation: compact ? \"compact\" : \"standard\",\n    minimumFractionDigits: decimals,\n    maximumFractionDigits: decimals,\n    signDisplay,\n  }).format(value);\n}\n"],"mappings":"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","names":[]}

package/dist/utils/index.d.ts

@@ -0,0 +1,8 @@
+export { cn } from "./cn.js";
+export { apiFetch, createApiError } from "./api-client.js";
+export type { IApiError, IApiFetchOptions } from "./api-client.js";
+export { parsePaginationParams, buildPaginatedResponse, } from "./pagination.js";
+export type { IPaginationParams, IPaginatedSlice } from "./pagination.js";
+export { formatRelativeDuration, ddmmToISO, formatIsoDate, formatDate, formatCurrency, formatNumber, } from "./format.js";
+export type { IRelativeDurationLabels, IFormatDateOptions, IFormatDateStyle, IFormatCurrencyOptions, IFormatNumberOptions, } from "./format.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/utils/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAE,MAAM,SAAS,CAAC;AAE7B,OAAO,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAC3D,YAAY,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAEnE,OAAO,EACL,qBAAqB,EACrB,sBAAsB,GACvB,MAAM,iBAAiB,CAAC;AACzB,YAAY,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAE1E,OAAO,EACL,sBAAsB,EACtB,SAAS,EACT,aAAa,EACb,UAAU,EACV,cAAc,EACd,YAAY,GACb,MAAM,aAAa,CAAC;AACrB,YAAY,EACV,uBAAuB,EACvB,kBAAkB,EAClB,gBAAgB,EAChB,sBAAsB,EACtB,oBAAoB,GACrB,MAAM,aAAa,CAAC"}

package/dist/utils/index.js

@@ -0,0 +1,28 @@
+import { cn } from "./cn.js";
+import { apiFetch, createApiError } from "./api-client.js";
+import {
+  parsePaginationParams,
+  buildPaginatedResponse
+} from "./pagination.js";
+import {
+  formatRelativeDuration,
+  ddmmToISO,
+  formatIsoDate,
+  formatDate,
+  formatCurrency,
+  formatNumber
+} from "./format.js";
+export {
+  apiFetch,
+  buildPaginatedResponse,
+  cn,
+  createApiError,
+  ddmmToISO,
+  formatCurrency,
+  formatDate,
+  formatIsoDate,
+  formatNumber,
+  formatRelativeDuration,
+  parsePaginationParams
+};
+//# sourceMappingURL=index.js.map

package/dist/utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/utils/index.ts"],"sourcesContent":["export { cn } from \"./cn.js\";\n\nexport { apiFetch, createApiError } from \"./api-client.js\";\nexport type { IApiError, IApiFetchOptions } from \"./api-client.js\";\n\nexport {\n  parsePaginationParams,\n  buildPaginatedResponse,\n} from \"./pagination.js\";\nexport type { IPaginationParams, IPaginatedSlice } from \"./pagination.js\";\n\nexport {\n  formatRelativeDuration,\n  ddmmToISO,\n  formatIsoDate,\n  formatDate,\n  formatCurrency,\n  formatNumber,\n} from \"./format.js\";\nexport type {\n  IRelativeDurationLabels,\n  IFormatDateOptions,\n  IFormatDateStyle,\n  IFormatCurrencyOptions,\n  IFormatNumberOptions,\n} from \"./format.js\";\n"],"mappings":"AAAA,SAAS,UAAU;AAEnB,SAAS,UAAU,sBAAsB;AAGzC;AAAA,EACE;AAAA,EACA;AAAA,OACK;AAGP;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;","names":[]}