preact-intlayer 5.8.0-canary.0 → 5.8.1

package/dist/cjs/client/format/index.cjs

@@ -0,0 +1,50 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var format_exports = {};
+__export(format_exports, {
+  useCompact: () => import_useCompact.useCompact,
+  useCurrency: () => import_useCurrency.useCurrency,
+  useDate: () => import_useDate.useDate,
+  useList: () => import_useList.useList,
+  useNumber: () => import_useNumber.useNumber,
+  usePercentage: () => import_usePercentage.usePercentage,
+  useRelativeTime: () => import_useRelativeTime.useRelativeTime,
+  useUnit: () => import_useUnit.useUnit
+});
+module.exports = __toCommonJS(format_exports);
+var import_useCompact = require('./useCompact.cjs');
+var import_useCurrency = require('./useCurrency.cjs');
+var import_useDate = require('./useDate.cjs');
+var import_useList = require('./useList.cjs');
+var import_useNumber = require('./useNumber.cjs');
+var import_usePercentage = require('./usePercentage.cjs');
+var import_useRelativeTime = require('./useRelativeTime.cjs');
+var import_useUnit = require('./useUnit.cjs');
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  useCompact,
+  useCurrency,
+  useDate,
+  useList,
+  useNumber,
+  usePercentage,
+  useRelativeTime,
+  useUnit
+});
+//# sourceMappingURL=index.cjs.map

package/dist/cjs/client/format/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/client/format/index.ts"],"sourcesContent":["export { useCompact } from './useCompact';\nexport { useCurrency } from './useCurrency';\nexport { useDate } from './useDate';\nexport { useList } from './useList';\nexport { useNumber } from './useNumber';\nexport { usePercentage } from './usePercentage';\nexport { useRelativeTime } from './useRelativeTime';\nexport { useUnit } from './useUnit';\n"],"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,wBAA2B;AAC3B,yBAA4B;AAC5B,qBAAwB;AACxB,qBAAwB;AACxB,uBAA0B;AAC1B,2BAA8B;AAC9B,6BAAgC;AAChC,qBAAwB;","names":[]}

package/dist/cjs/client/format/useCompact.cjs

@@ -0,0 +1,42 @@
+"use strict";
+"use client";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var useCompact_exports = {};
+__export(useCompact_exports, {
+  useCompact: () => useCompact
+});
+module.exports = __toCommonJS(useCompact_exports);
+var import_core = require("@intlayer/core");
+var import_hooks = require("preact/hooks");
+var import_IntlayerProvider = require('../IntlayerProvider.cjs');
+const useCompact = () => {
+  const { locale } = (0, import_hooks.useContext)(import_IntlayerProvider.IntlayerClientContext);
+  return (0, import_hooks.useCallback)(
+    (...args) => (0, import_core.compact)(args[0], {
+      ...args[1],
+      locale: args[1]?.locale ?? locale
+    }),
+    [locale]
+  );
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  useCompact
+});
+//# sourceMappingURL=useCompact.cjs.map

package/dist/cjs/client/format/useCompact.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/client/format/useCompact.ts"],"sourcesContent":["'use client';\n\nimport { compact } from '@intlayer/core';\nimport { useCallback, useContext } from 'preact/hooks';\nimport { IntlayerClientContext } from '../IntlayerProvider';\n\n/**\n * React client hook that provides a compact number formatter\n * bound to the current application locale.\n *\n * @example\n * ```tsx\n * const formatCompact = useCompact();\n * formatCompact(1500); // \"1.5K\"\n * ```\n */\nexport const useCompact = () => {\n  const { locale } = useContext(IntlayerClientContext);\n\n  return useCallback(\n    (...args: Parameters<typeof compact>) =>\n      compact(args[0], {\n        ...args[1],\n        locale: args[1]?.locale ?? locale,\n      }),\n    [locale]\n  );\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAEA,kBAAwB;AACxB,mBAAwC;AACxC,8BAAsC;AAY/B,MAAM,aAAa,MAAM;AAC9B,QAAM,EAAE,OAAO,QAAI,yBAAW,6CAAqB;AAEnD,aAAO;AAAA,IACL,IAAI,aACF,qBAAQ,KAAK,CAAC,GAAG;AAAA,MACf,GAAG,KAAK,CAAC;AAAA,MACT,QAAQ,KAAK,CAAC,GAAG,UAAU;AAAA,IAC7B,CAAC;AAAA,IACH,CAAC,MAAM;AAAA,EACT;AACF;","names":[]}

package/dist/cjs/client/format/useCurrency.cjs

@@ -0,0 +1,42 @@
+"use strict";
+"use client";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var useCurrency_exports = {};
+__export(useCurrency_exports, {
+  useCurrency: () => useCurrency
+});
+module.exports = __toCommonJS(useCurrency_exports);
+var import_core = require("@intlayer/core");
+var import_hooks = require("preact/hooks");
+var import_IntlayerProvider = require('../IntlayerProvider.cjs');
+const useCurrency = () => {
+  const { locale } = (0, import_hooks.useContext)(import_IntlayerProvider.IntlayerClientContext);
+  return (0, import_hooks.useCallback)(
+    (...args) => (0, import_core.currency)(args[0], {
+      ...args[1],
+      locale: args[1]?.locale ?? locale
+    }),
+    [locale]
+  );
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  useCurrency
+});
+//# sourceMappingURL=useCurrency.cjs.map

package/dist/cjs/client/format/useCurrency.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/client/format/useCurrency.ts"],"sourcesContent":["'use client';\n\nimport { currency } from '@intlayer/core';\nimport { useCallback, useContext } from 'preact/hooks';\nimport { IntlayerClientContext } from '../IntlayerProvider';\n\n/**\n * React client hook that provides a currency formatter\n * bound to the current application locale.\n *\n * @returns {(value: string | number, options?: CurrencyProps) => string}\n * A function to format numbers into localized currency strings.\n *\n * @example\n * ```tsx\n * const formatCurrency = useCurrency();\n *\n * formatCurrency(1500, { currency: \"USD\" });\n * // \"$1,500.00\"\n *\n * formatCurrency(1500, { currency: \"EUR\", locale: \"de-DE\" });\n * // \"1.500,00 €\"\n *\n * formatCurrency(9876543.21, {\n *   currency: \"JPY\",\n *   fractionDigits: 0,\n * });\n * // \"¥9,876,543\"\n * ```\n */\nexport const useCurrency = () => {\n  const { locale } = useContext(IntlayerClientContext);\n\n  return useCallback(\n    (...args: Parameters<typeof currency>) =>\n      currency(args[0], {\n        ...args[1],\n        locale: args[1]?.locale ?? locale,\n      }),\n    [locale]\n  );\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAEA,kBAAyB;AACzB,mBAAwC;AACxC,8BAAsC;AA0B/B,MAAM,cAAc,MAAM;AAC/B,QAAM,EAAE,OAAO,QAAI,yBAAW,6CAAqB;AAEnD,aAAO;AAAA,IACL,IAAI,aACF,sBAAS,KAAK,CAAC,GAAG;AAAA,MAChB,GAAG,KAAK,CAAC;AAAA,MACT,QAAQ,KAAK,CAAC,GAAG,UAAU;AAAA,IAC7B,CAAC;AAAA,IACH,CAAC,MAAM;AAAA,EACT;AACF;","names":[]}

package/dist/cjs/client/format/useDate.cjs

@@ -0,0 +1,39 @@
+"use strict";
+"use client";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var useDate_exports = {};
+__export(useDate_exports, {
+  useDate: () => useDate
+});
+module.exports = __toCommonJS(useDate_exports);
+var import_core = require("@intlayer/core");
+var import_hooks = require("preact/hooks");
+var import_IntlayerProvider = require('../IntlayerProvider.cjs');
+const useDate = () => {
+  const { locale } = (0, import_hooks.useContext)(import_IntlayerProvider.IntlayerClientContext);
+  return (...args) => (0, import_core.date)(args[0], {
+    ...args[1],
+    locale: args[1]?.locale ?? locale
+  });
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  useDate
+});
+//# sourceMappingURL=useDate.cjs.map

package/dist/cjs/client/format/useDate.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/client/format/useDate.ts"],"sourcesContent":["'use client';\n\nimport { date } from '@intlayer/core';\nimport { useContext } from 'preact/hooks';\nimport { IntlayerClientContext } from '../IntlayerProvider';\n\n/**\n * React client hook that provides a localized date/time formatter\n * bound to the current application locale.\n *\n * @returns {(date: Date | string | number, options?: DateProps) => string}\n * A function to format dates or timestamps into localized date/time strings.\n *\n * @example\n * ```tsx\n * const formatDate = useDate();\n *\n * formatDate(new Date(\"2025-01-01\"));\n * // \"Jan 1, 2025\"\n *\n * formatDate(\"2025-01-01T15:30:00Z\", {\n *   dateStyle: \"full\",\n *   timeStyle: \"short\",\n * });\n * // \"Wednesday, January 1, 2025 at 3:30 PM\"\n *\n * formatDate(1735689600000, { locale: \"fr-FR\", dateStyle: \"long\" });\n * // \"1 janvier 2025\"\n * ```\n *\n * @see createDate\n */\nexport const useDate = () => {\n  const { locale } = useContext(IntlayerClientContext);\n\n  return (...args: Parameters<typeof date>) =>\n    date(args[0], {\n      ...args[1],\n      locale: args[1]?.locale ?? locale,\n    });\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAEA,kBAAqB;AACrB,mBAA2B;AAC3B,8BAAsC;AA4B/B,MAAM,UAAU,MAAM;AAC3B,QAAM,EAAE,OAAO,QAAI,yBAAW,6CAAqB;AAEnD,SAAO,IAAI,aACT,kBAAK,KAAK,CAAC,GAAG;AAAA,IACZ,GAAG,KAAK,CAAC;AAAA,IACT,QAAQ,KAAK,CAAC,GAAG,UAAU;AAAA,EAC7B,CAAC;AACL;","names":[]}

package/dist/cjs/client/format/useList.cjs

@@ -0,0 +1,42 @@
+"use strict";
+"use client";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var useList_exports = {};
+__export(useList_exports, {
+  useList: () => useList
+});
+module.exports = __toCommonJS(useList_exports);
+var import_core = require("@intlayer/core");
+var import_hooks = require("preact/hooks");
+var import_IntlayerProvider = require('../IntlayerProvider.cjs');
+const useList = () => {
+  const { locale } = (0, import_hooks.useContext)(import_IntlayerProvider.IntlayerClientContext);
+  return (0, import_hooks.useCallback)(
+    (...args) => (0, import_core.list)(args[0], {
+      ...args[1],
+      locale: args[1]?.locale ?? locale
+    }),
+    [locale]
+  );
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  useList
+});
+//# sourceMappingURL=useList.cjs.map

package/dist/cjs/client/format/useList.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/client/format/useList.ts"],"sourcesContent":["'use client';\n\nimport { list } from '@intlayer/core';\nimport { useCallback, useContext } from 'preact/hooks';\nimport { IntlayerClientContext } from '../IntlayerProvider';\n\n/**\n * React client hook that provides a list formatter\n * bound to the current application locale.\n *\n * @returns {(values: (string | number)[], options?: ListProps) => string}\n * A function to format arrays into localized list strings.\n *\n * @example\n * ```tsx\n * const formatList = useList();\n *\n * formatList(['apple', 'banana', 'orange']);\n * // \"apple, banana, and orange\"\n *\n * formatList(['red', 'green', 'blue'], { type: 'disjunction' });\n * // \"red, green, or blue\"\n *\n * formatList([1, 2, 3], { type: 'unit', locale: 'de-DE' });\n * // \"1, 2 und 3\"\n * ```\n */\nexport const useList = () => {\n  const { locale } = useContext(IntlayerClientContext);\n\n  return useCallback(\n    (...args: Parameters<typeof list>) =>\n      list(args[0], {\n        ...args[1],\n        locale: args[1]?.locale ?? locale,\n      }),\n    [locale]\n  );\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAEA,kBAAqB;AACrB,mBAAwC;AACxC,8BAAsC;AAuB/B,MAAM,UAAU,MAAM;AAC3B,QAAM,EAAE,OAAO,QAAI,yBAAW,6CAAqB;AAEnD,aAAO;AAAA,IACL,IAAI,aACF,kBAAK,KAAK,CAAC,GAAG;AAAA,MACZ,GAAG,KAAK,CAAC;AAAA,MACT,QAAQ,KAAK,CAAC,GAAG,UAAU;AAAA,IAC7B,CAAC;AAAA,IACH,CAAC,MAAM;AAAA,EACT;AACF;","names":[]}

package/dist/cjs/client/format/useNumber.cjs

@@ -0,0 +1,42 @@
+"use strict";
+"use client";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var useNumber_exports = {};
+__export(useNumber_exports, {
+  useNumber: () => useNumber
+});
+module.exports = __toCommonJS(useNumber_exports);
+var import_core = require("@intlayer/core");
+var import_hooks = require("preact/hooks");
+var import_IntlayerProvider = require('../IntlayerProvider.cjs');
+const useNumber = () => {
+  const { locale } = (0, import_hooks.useContext)(import_IntlayerProvider.IntlayerClientContext);
+  return (0, import_hooks.useCallback)(
+    (...args) => (0, import_core.number)(args[0], {
+      ...args[1],
+      locale: args[1]?.locale ?? locale
+    }),
+    [locale]
+  );
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  useNumber
+});
+//# sourceMappingURL=useNumber.cjs.map

package/dist/cjs/client/format/useNumber.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/client/format/useNumber.ts"],"sourcesContent":["'use client';\n\nimport { number } from '@intlayer/core';\nimport { useCallback, useContext } from 'preact/hooks';\nimport { IntlayerClientContext } from '../IntlayerProvider';\n\n/**\n * React client hook that provides a localized number formatter.\n *\n * Uses the current locale from {@link useLocaleBase} and returns\n * a function that can be used to format numbers consistently\n * according to the user's locale.\n *\n * @example\n * ```tsx\n * const formatNumber = useNumber();\n *\n * formatNumber(12345);\n * // e.g. \"12,345\" (en-US)\n * // e.g. \"12 345\" (fr-FR)\n *\n * formatNumber(0.75, { style: \"percent\" });\n * // e.g. \"75%\"\n * ```\n *\n * @returns {(value: string | number, options?: import(\"../createNumber\").NumberProps) => string}\n * A number formatting function bound to the active locale.\n */\nexport const useNumber = () => {\n  const { locale } = useContext(IntlayerClientContext);\n\n  return useCallback(\n    (...args: Parameters<typeof number>) =>\n      number(args[0], {\n        ...args[1],\n        locale: args[1]?.locale ?? locale,\n      }),\n    [locale]\n  );\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAEA,kBAAuB;AACvB,mBAAwC;AACxC,8BAAsC;AAwB/B,MAAM,YAAY,MAAM;AAC7B,QAAM,EAAE,OAAO,QAAI,yBAAW,6CAAqB;AAEnD,aAAO;AAAA,IACL,IAAI,aACF,oBAAO,KAAK,CAAC,GAAG;AAAA,MACd,GAAG,KAAK,CAAC;AAAA,MACT,QAAQ,KAAK,CAAC,GAAG,UAAU;AAAA,IAC7B,CAAC;AAAA,IACH,CAAC,MAAM;AAAA,EACT;AACF;","names":[]}

package/dist/cjs/client/format/usePercentage.cjs

@@ -0,0 +1,42 @@
+"use strict";
+"use client";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var usePercentage_exports = {};
+__export(usePercentage_exports, {
+  usePercentage: () => usePercentage
+});
+module.exports = __toCommonJS(usePercentage_exports);
+var import_core = require("@intlayer/core");
+var import_hooks = require("preact/hooks");
+var import_IntlayerProvider = require('../IntlayerProvider.cjs');
+const usePercentage = () => {
+  const { locale } = (0, import_hooks.useContext)(import_IntlayerProvider.IntlayerClientContext);
+  return (0, import_hooks.useCallback)(
+    (...args) => (0, import_core.percentage)(args[0], {
+      ...args[1],
+      locale: args[1]?.locale ?? locale
+    }),
+    [locale]
+  );
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  usePercentage
+});
+//# sourceMappingURL=usePercentage.cjs.map

package/dist/cjs/client/format/usePercentage.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/client/format/usePercentage.ts"],"sourcesContent":["'use client';\n\nimport { percentage } from '@intlayer/core';\nimport { useCallback, useContext } from 'preact/hooks';\nimport { IntlayerClientContext } from '../IntlayerProvider';\n\n/**\n * React hook to provide a percentage formatter function\n * based on the current application locale.\n *\n * This hook retrieves the active locale using {@link useLocaleBase}\n * and memoizes a `createPercentage` instance for that locale.\n *\n * @example\n * ```tsx\n * const formatPercentage = usePercentage();\n *\n * const result = formatPercentage(0.875, { maximumFractionDigits: 1 });\n * // \"87.5%\" (depending on locale)\n * ```\n *\n * @returns {(value: string | number, options?: Omit<PercentageOptions, \"value\">) => string}\n * A function that formats numbers or numeric strings into localized percentages.\n */\nexport const usePercentage = () => {\n  const { locale } = useContext(IntlayerClientContext);\n\n  return useCallback(\n    (...args: Parameters<typeof percentage>) =>\n      percentage(args[0], {\n        ...args[1],\n        locale: args[1]?.locale ?? locale,\n      }),\n    [locale]\n  );\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAEA,kBAA2B;AAC3B,mBAAwC;AACxC,8BAAsC;AAoB/B,MAAM,gBAAgB,MAAM;AACjC,QAAM,EAAE,OAAO,QAAI,yBAAW,6CAAqB;AAEnD,aAAO;AAAA,IACL,IAAI,aACF,wBAAW,KAAK,CAAC,GAAG;AAAA,MAClB,GAAG,KAAK,CAAC;AAAA,MACT,QAAQ,KAAK,CAAC,GAAG,UAAU;AAAA,IAC7B,CAAC;AAAA,IACH,CAAC,MAAM;AAAA,EACT;AACF;","names":[]}

package/dist/cjs/client/format/useRelativeTime.cjs

@@ -0,0 +1,42 @@
+"use strict";
+"use client";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var useRelativeTime_exports = {};
+__export(useRelativeTime_exports, {
+  useRelativeTime: () => useRelativeTime
+});
+module.exports = __toCommonJS(useRelativeTime_exports);
+var import_core = require("@intlayer/core");
+var import_hooks = require("preact/hooks");
+var import_IntlayerProvider = require('../IntlayerProvider.cjs');
+const useRelativeTime = () => {
+  const { locale } = (0, import_hooks.useContext)(import_IntlayerProvider.IntlayerClientContext);
+  return (0, import_hooks.useCallback)(
+    (...args) => (0, import_core.relativeTime)(args[0], args[1], {
+      ...args[2],
+      locale: args[2]?.locale ?? locale
+    }),
+    [locale]
+  );
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  useRelativeTime
+});
+//# sourceMappingURL=useRelativeTime.cjs.map

package/dist/cjs/client/format/useRelativeTime.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/client/format/useRelativeTime.ts"],"sourcesContent":["'use client';\n\nimport { relativeTime } from '@intlayer/core';\nimport { useCallback, useContext } from 'preact/hooks';\nimport { IntlayerClientContext } from '../IntlayerProvider';\n\n/**\n * Client-side React hook for accessing a localized relative time formatter.\n *\n * This hook:\n * - Reads the current locale from {@link useLocaleBase}.\n * - Creates a new relative time formatter with {@link createRelativeTime}.\n * - Returns a function that can format time differences into localized strings.\n *\n * Example:\n * ```tsx\n * const relativeTime = useRelativeTime();\n * const formatted = relativeTime(new Date(\"2024-08-01\"), new Date());\n * // e.g., \"2 weeks ago\"\n * ```\n *\n * @returns {ReturnType<typeof createRelativeTime>} A relative time formatting function\n *          bound to the current client locale.\n */\nexport const useRelativeTime = () => {\n  const { locale } = useContext(IntlayerClientContext);\n\n  return useCallback(\n    (...args: Parameters<typeof relativeTime>) =>\n      relativeTime(args[0], args[1], {\n        ...args[2],\n        locale: args[2]?.locale ?? locale,\n      }),\n    [locale]\n  );\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAEA,kBAA6B;AAC7B,mBAAwC;AACxC,8BAAsC;AAoB/B,MAAM,kBAAkB,MAAM;AACnC,QAAM,EAAE,OAAO,QAAI,yBAAW,6CAAqB;AAEnD,aAAO;AAAA,IACL,IAAI,aACF,0BAAa,KAAK,CAAC,GAAG,KAAK,CAAC,GAAG;AAAA,MAC7B,GAAG,KAAK,CAAC;AAAA,MACT,QAAQ,KAAK,CAAC,GAAG,UAAU;AAAA,IAC7B,CAAC;AAAA,IACH,CAAC,MAAM;AAAA,EACT;AACF;","names":[]}

package/dist/cjs/client/format/useUnit.cjs

@@ -0,0 +1,42 @@
+"use strict";
+"use client";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var useUnit_exports = {};
+__export(useUnit_exports, {
+  useUnit: () => useUnit
+});
+module.exports = __toCommonJS(useUnit_exports);
+var import_core = require("@intlayer/core");
+var import_hooks = require("preact/hooks");
+var import_IntlayerProvider = require('../IntlayerProvider.cjs');
+const useUnit = () => {
+  const { locale } = (0, import_hooks.useContext)(import_IntlayerProvider.IntlayerClientContext);
+  return (0, import_hooks.useCallback)(
+    (...args) => (0, import_core.units)(args[0], {
+      ...args[1],
+      locale: args[1]?.locale ?? locale
+    }),
+    [locale]
+  );
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  useUnit
+});
+//# sourceMappingURL=useUnit.cjs.map

package/dist/cjs/client/format/useUnit.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/client/format/useUnit.ts"],"sourcesContent":["'use client';\n\nimport { units } from '@intlayer/core';\nimport { useCallback, useContext } from 'preact/hooks';\nimport { IntlayerClientContext } from '../IntlayerProvider';\n\n/**\n * React hook that provides a unit formatting function\n * based on the current locale from {@link useLocaleBase}.\n *\n * This hook wraps {@link createUnit} to return a formatter\n * that can convert values into human-readable localized units\n * (e.g., \"10 km\", \"5 lbs\").\n *\n * @example\n * ```tsx\n * const formatUnit = useUnit();\n * const distance = formatUnit(10, { unit: \"kilometer\" });\n * // \"10 km\" (depending on locale)\n * ```\n *\n * @returns {Function} A unit formatting function that accepts a value and optional formatting options.\n */\nexport const useUnit = () => {\n  const { locale } = useContext(IntlayerClientContext);\n\n  return useCallback(\n    (...args: Parameters<typeof units>) =>\n      units(args[0], {\n        ...args[1],\n        locale: args[1]?.locale ?? locale,\n      }),\n    [locale]\n  );\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAEA,kBAAsB;AACtB,mBAAwC;AACxC,8BAAsC;AAmB/B,MAAM,UAAU,MAAM;AAC3B,QAAM,EAAE,OAAO,QAAI,yBAAW,6CAAqB;AAEnD,aAAO;AAAA,IACL,IAAI,aACF,mBAAM,KAAK,CAAC,GAAG;AAAA,MACb,GAAG,KAAK,CAAC;AAAA,MACT,QAAQ,KAAK,CAAC,GAAG,UAAU;AAAA,IAC7B,CAAC;AAAA,IACH,CAAC,MAAM;AAAA,EACT;AACF;","names":[]}

package/dist/esm/client/format/index.mjs

@@ -0,0 +1,19 @@
+import { useCompact } from "./useCompact.mjs";
+import { useCurrency } from "./useCurrency.mjs";
+import { useDate } from "./useDate.mjs";
+import { useList } from "./useList.mjs";
+import { useNumber } from "./useNumber.mjs";
+import { usePercentage } from "./usePercentage.mjs";
+import { useRelativeTime } from "./useRelativeTime.mjs";
+import { useUnit } from "./useUnit.mjs";
+export {
+  useCompact,
+  useCurrency,
+  useDate,
+  useList,
+  useNumber,
+  usePercentage,
+  useRelativeTime,
+  useUnit
+};
+//# sourceMappingURL=index.mjs.map

package/dist/esm/client/format/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/client/format/index.ts"],"sourcesContent":["export { useCompact } from './useCompact';\nexport { useCurrency } from './useCurrency';\nexport { useDate } from './useDate';\nexport { useList } from './useList';\nexport { useNumber } from './useNumber';\nexport { usePercentage } from './usePercentage';\nexport { useRelativeTime } from './useRelativeTime';\nexport { useUnit } from './useUnit';\n"],"mappings":"AAAA,SAAS,kBAAkB;AAC3B,SAAS,mBAAmB;AAC5B,SAAS,eAAe;AACxB,SAAS,eAAe;AACxB,SAAS,iBAAiB;AAC1B,SAAS,qBAAqB;AAC9B,SAAS,uBAAuB;AAChC,SAAS,eAAe;","names":[]}

package/dist/esm/client/format/useCompact.mjs

@@ -0,0 +1,18 @@
+"use client";
+import { compact } from "@intlayer/core";
+import { useCallback, useContext } from "preact/hooks";
+import { IntlayerClientContext } from "../IntlayerProvider.mjs";
+const useCompact = () => {
+  const { locale } = useContext(IntlayerClientContext);
+  return useCallback(
+    (...args) => compact(args[0], {
+      ...args[1],
+      locale: args[1]?.locale ?? locale
+    }),
+    [locale]
+  );
+};
+export {
+  useCompact
+};
+//# sourceMappingURL=useCompact.mjs.map

package/dist/esm/client/format/useCompact.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/client/format/useCompact.ts"],"sourcesContent":["'use client';\n\nimport { compact } from '@intlayer/core';\nimport { useCallback, useContext } from 'preact/hooks';\nimport { IntlayerClientContext } from '../IntlayerProvider';\n\n/**\n * React client hook that provides a compact number formatter\n * bound to the current application locale.\n *\n * @example\n * ```tsx\n * const formatCompact = useCompact();\n * formatCompact(1500); // \"1.5K\"\n * ```\n */\nexport const useCompact = () => {\n  const { locale } = useContext(IntlayerClientContext);\n\n  return useCallback(\n    (...args: Parameters<typeof compact>) =>\n      compact(args[0], {\n        ...args[1],\n        locale: args[1]?.locale ?? locale,\n      }),\n    [locale]\n  );\n};\n"],"mappings":";AAEA,SAAS,eAAe;AACxB,SAAS,aAAa,kBAAkB;AACxC,SAAS,6BAA6B;AAY/B,MAAM,aAAa,MAAM;AAC9B,QAAM,EAAE,OAAO,IAAI,WAAW,qBAAqB;AAEnD,SAAO;AAAA,IACL,IAAI,SACF,QAAQ,KAAK,CAAC,GAAG;AAAA,MACf,GAAG,KAAK,CAAC;AAAA,MACT,QAAQ,KAAK,CAAC,GAAG,UAAU;AAAA,IAC7B,CAAC;AAAA,IACH,CAAC,MAAM;AAAA,EACT;AACF;","names":[]}

package/dist/esm/client/format/useCurrency.mjs

@@ -0,0 +1,18 @@
+"use client";
+import { currency } from "@intlayer/core";
+import { useCallback, useContext } from "preact/hooks";
+import { IntlayerClientContext } from "../IntlayerProvider.mjs";
+const useCurrency = () => {
+  const { locale } = useContext(IntlayerClientContext);
+  return useCallback(
+    (...args) => currency(args[0], {
+      ...args[1],
+      locale: args[1]?.locale ?? locale
+    }),
+    [locale]
+  );
+};
+export {
+  useCurrency
+};
+//# sourceMappingURL=useCurrency.mjs.map

package/dist/esm/client/format/useCurrency.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/client/format/useCurrency.ts"],"sourcesContent":["'use client';\n\nimport { currency } from '@intlayer/core';\nimport { useCallback, useContext } from 'preact/hooks';\nimport { IntlayerClientContext } from '../IntlayerProvider';\n\n/**\n * React client hook that provides a currency formatter\n * bound to the current application locale.\n *\n * @returns {(value: string | number, options?: CurrencyProps) => string}\n * A function to format numbers into localized currency strings.\n *\n * @example\n * ```tsx\n * const formatCurrency = useCurrency();\n *\n * formatCurrency(1500, { currency: \"USD\" });\n * // \"$1,500.00\"\n *\n * formatCurrency(1500, { currency: \"EUR\", locale: \"de-DE\" });\n * // \"1.500,00 €\"\n *\n * formatCurrency(9876543.21, {\n *   currency: \"JPY\",\n *   fractionDigits: 0,\n * });\n * // \"¥9,876,543\"\n * ```\n */\nexport const useCurrency = () => {\n  const { locale } = useContext(IntlayerClientContext);\n\n  return useCallback(\n    (...args: Parameters<typeof currency>) =>\n      currency(args[0], {\n        ...args[1],\n        locale: args[1]?.locale ?? locale,\n      }),\n    [locale]\n  );\n};\n"],"mappings":";AAEA,SAAS,gBAAgB;AACzB,SAAS,aAAa,kBAAkB;AACxC,SAAS,6BAA6B;AA0B/B,MAAM,cAAc,MAAM;AAC/B,QAAM,EAAE,OAAO,IAAI,WAAW,qBAAqB;AAEnD,SAAO;AAAA,IACL,IAAI,SACF,SAAS,KAAK,CAAC,GAAG;AAAA,MAChB,GAAG,KAAK,CAAC;AAAA,MACT,QAAQ,KAAK,CAAC,GAAG,UAAU;AAAA,IAC7B,CAAC;AAAA,IACH,CAAC,MAAM;AAAA,EACT;AACF;","names":[]}

package/dist/esm/client/format/useDate.mjs

@@ -0,0 +1,15 @@
+"use client";
+import { date } from "@intlayer/core";
+import { useContext } from "preact/hooks";
+import { IntlayerClientContext } from "../IntlayerProvider.mjs";
+const useDate = () => {
+  const { locale } = useContext(IntlayerClientContext);
+  return (...args) => date(args[0], {
+    ...args[1],
+    locale: args[1]?.locale ?? locale
+  });
+};
+export {
+  useDate
+};
+//# sourceMappingURL=useDate.mjs.map

package/dist/esm/client/format/useDate.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/client/format/useDate.ts"],"sourcesContent":["'use client';\n\nimport { date } from '@intlayer/core';\nimport { useContext } from 'preact/hooks';\nimport { IntlayerClientContext } from '../IntlayerProvider';\n\n/**\n * React client hook that provides a localized date/time formatter\n * bound to the current application locale.\n *\n * @returns {(date: Date | string | number, options?: DateProps) => string}\n * A function to format dates or timestamps into localized date/time strings.\n *\n * @example\n * ```tsx\n * const formatDate = useDate();\n *\n * formatDate(new Date(\"2025-01-01\"));\n * // \"Jan 1, 2025\"\n *\n * formatDate(\"2025-01-01T15:30:00Z\", {\n *   dateStyle: \"full\",\n *   timeStyle: \"short\",\n * });\n * // \"Wednesday, January 1, 2025 at 3:30 PM\"\n *\n * formatDate(1735689600000, { locale: \"fr-FR\", dateStyle: \"long\" });\n * // \"1 janvier 2025\"\n * ```\n *\n * @see createDate\n */\nexport const useDate = () => {\n  const { locale } = useContext(IntlayerClientContext);\n\n  return (...args: Parameters<typeof date>) =>\n    date(args[0], {\n      ...args[1],\n      locale: args[1]?.locale ?? locale,\n    });\n};\n"],"mappings":";AAEA,SAAS,YAAY;AACrB,SAAS,kBAAkB;AAC3B,SAAS,6BAA6B;AA4B/B,MAAM,UAAU,MAAM;AAC3B,QAAM,EAAE,OAAO,IAAI,WAAW,qBAAqB;AAEnD,SAAO,IAAI,SACT,KAAK,KAAK,CAAC,GAAG;AAAA,IACZ,GAAG,KAAK,CAAC;AAAA,IACT,QAAQ,KAAK,CAAC,GAAG,UAAU;AAAA,EAC7B,CAAC;AACL;","names":[]}

package/dist/esm/client/format/useList.mjs

@@ -0,0 +1,18 @@
+"use client";
+import { list } from "@intlayer/core";
+import { useCallback, useContext } from "preact/hooks";
+import { IntlayerClientContext } from "../IntlayerProvider.mjs";
+const useList = () => {
+  const { locale } = useContext(IntlayerClientContext);
+  return useCallback(
+    (...args) => list(args[0], {
+      ...args[1],
+      locale: args[1]?.locale ?? locale
+    }),
+    [locale]
+  );
+};
+export {
+  useList
+};
+//# sourceMappingURL=useList.mjs.map

package/dist/esm/client/format/useList.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/client/format/useList.ts"],"sourcesContent":["'use client';\n\nimport { list } from '@intlayer/core';\nimport { useCallback, useContext } from 'preact/hooks';\nimport { IntlayerClientContext } from '../IntlayerProvider';\n\n/**\n * React client hook that provides a list formatter\n * bound to the current application locale.\n *\n * @returns {(values: (string | number)[], options?: ListProps) => string}\n * A function to format arrays into localized list strings.\n *\n * @example\n * ```tsx\n * const formatList = useList();\n *\n * formatList(['apple', 'banana', 'orange']);\n * // \"apple, banana, and orange\"\n *\n * formatList(['red', 'green', 'blue'], { type: 'disjunction' });\n * // \"red, green, or blue\"\n *\n * formatList([1, 2, 3], { type: 'unit', locale: 'de-DE' });\n * // \"1, 2 und 3\"\n * ```\n */\nexport const useList = () => {\n  const { locale } = useContext(IntlayerClientContext);\n\n  return useCallback(\n    (...args: Parameters<typeof list>) =>\n      list(args[0], {\n        ...args[1],\n        locale: args[1]?.locale ?? locale,\n      }),\n    [locale]\n  );\n};\n"],"mappings":";AAEA,SAAS,YAAY;AACrB,SAAS,aAAa,kBAAkB;AACxC,SAAS,6BAA6B;AAuB/B,MAAM,UAAU,MAAM;AAC3B,QAAM,EAAE,OAAO,IAAI,WAAW,qBAAqB;AAEnD,SAAO;AAAA,IACL,IAAI,SACF,KAAK,KAAK,CAAC,GAAG;AAAA,MACZ,GAAG,KAAK,CAAC;AAAA,MACT,QAAQ,KAAK,CAAC,GAAG,UAAU;AAAA,IAC7B,CAAC;AAAA,IACH,CAAC,MAAM;AAAA,EACT;AACF;","names":[]}

package/dist/esm/client/format/useNumber.mjs

@@ -0,0 +1,18 @@
+"use client";
+import { number } from "@intlayer/core";
+import { useCallback, useContext } from "preact/hooks";
+import { IntlayerClientContext } from "../IntlayerProvider.mjs";
+const useNumber = () => {
+  const { locale } = useContext(IntlayerClientContext);
+  return useCallback(
+    (...args) => number(args[0], {
+      ...args[1],
+      locale: args[1]?.locale ?? locale
+    }),
+    [locale]
+  );
+};
+export {
+  useNumber
+};
+//# sourceMappingURL=useNumber.mjs.map

package/dist/esm/client/format/useNumber.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/client/format/useNumber.ts"],"sourcesContent":["'use client';\n\nimport { number } from '@intlayer/core';\nimport { useCallback, useContext } from 'preact/hooks';\nimport { IntlayerClientContext } from '../IntlayerProvider';\n\n/**\n * React client hook that provides a localized number formatter.\n *\n * Uses the current locale from {@link useLocaleBase} and returns\n * a function that can be used to format numbers consistently\n * according to the user's locale.\n *\n * @example\n * ```tsx\n * const formatNumber = useNumber();\n *\n * formatNumber(12345);\n * // e.g. \"12,345\" (en-US)\n * // e.g. \"12 345\" (fr-FR)\n *\n * formatNumber(0.75, { style: \"percent\" });\n * // e.g. \"75%\"\n * ```\n *\n * @returns {(value: string | number, options?: import(\"../createNumber\").NumberProps) => string}\n * A number formatting function bound to the active locale.\n */\nexport const useNumber = () => {\n  const { locale } = useContext(IntlayerClientContext);\n\n  return useCallback(\n    (...args: Parameters<typeof number>) =>\n      number(args[0], {\n        ...args[1],\n        locale: args[1]?.locale ?? locale,\n      }),\n    [locale]\n  );\n};\n"],"mappings":";AAEA,SAAS,cAAc;AACvB,SAAS,aAAa,kBAAkB;AACxC,SAAS,6BAA6B;AAwB/B,MAAM,YAAY,MAAM;AAC7B,QAAM,EAAE,OAAO,IAAI,WAAW,qBAAqB;AAEnD,SAAO;AAAA,IACL,IAAI,SACF,OAAO,KAAK,CAAC,GAAG;AAAA,MACd,GAAG,KAAK,CAAC;AAAA,MACT,QAAQ,KAAK,CAAC,GAAG,UAAU;AAAA,IAC7B,CAAC;AAAA,IACH,CAAC,MAAM;AAAA,EACT;AACF;","names":[]}

package/dist/esm/client/format/usePercentage.mjs

@@ -0,0 +1,18 @@
+"use client";
+import { percentage } from "@intlayer/core";
+import { useCallback, useContext } from "preact/hooks";
+import { IntlayerClientContext } from "../IntlayerProvider.mjs";
+const usePercentage = () => {
+  const { locale } = useContext(IntlayerClientContext);
+  return useCallback(
+    (...args) => percentage(args[0], {
+      ...args[1],
+      locale: args[1]?.locale ?? locale
+    }),
+    [locale]
+  );
+};
+export {
+  usePercentage
+};
+//# sourceMappingURL=usePercentage.mjs.map

package/dist/esm/client/format/usePercentage.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/client/format/usePercentage.ts"],"sourcesContent":["'use client';\n\nimport { percentage } from '@intlayer/core';\nimport { useCallback, useContext } from 'preact/hooks';\nimport { IntlayerClientContext } from '../IntlayerProvider';\n\n/**\n * React hook to provide a percentage formatter function\n * based on the current application locale.\n *\n * This hook retrieves the active locale using {@link useLocaleBase}\n * and memoizes a `createPercentage` instance for that locale.\n *\n * @example\n * ```tsx\n * const formatPercentage = usePercentage();\n *\n * const result = formatPercentage(0.875, { maximumFractionDigits: 1 });\n * // \"87.5%\" (depending on locale)\n * ```\n *\n * @returns {(value: string | number, options?: Omit<PercentageOptions, \"value\">) => string}\n * A function that formats numbers or numeric strings into localized percentages.\n */\nexport const usePercentage = () => {\n  const { locale } = useContext(IntlayerClientContext);\n\n  return useCallback(\n    (...args: Parameters<typeof percentage>) =>\n      percentage(args[0], {\n        ...args[1],\n        locale: args[1]?.locale ?? locale,\n      }),\n    [locale]\n  );\n};\n"],"mappings":";AAEA,SAAS,kBAAkB;AAC3B,SAAS,aAAa,kBAAkB;AACxC,SAAS,6BAA6B;AAoB/B,MAAM,gBAAgB,MAAM;AACjC,QAAM,EAAE,OAAO,IAAI,WAAW,qBAAqB;AAEnD,SAAO;AAAA,IACL,IAAI,SACF,WAAW,KAAK,CAAC,GAAG;AAAA,MAClB,GAAG,KAAK,CAAC;AAAA,MACT,QAAQ,KAAK,CAAC,GAAG,UAAU;AAAA,IAC7B,CAAC;AAAA,IACH,CAAC,MAAM;AAAA,EACT;AACF;","names":[]}

package/dist/esm/client/format/useRelativeTime.mjs

@@ -0,0 +1,18 @@
+"use client";
+import { relativeTime } from "@intlayer/core";
+import { useCallback, useContext } from "preact/hooks";
+import { IntlayerClientContext } from "../IntlayerProvider.mjs";
+const useRelativeTime = () => {
+  const { locale } = useContext(IntlayerClientContext);
+  return useCallback(
+    (...args) => relativeTime(args[0], args[1], {
+      ...args[2],
+      locale: args[2]?.locale ?? locale
+    }),
+    [locale]
+  );
+};
+export {
+  useRelativeTime
+};
+//# sourceMappingURL=useRelativeTime.mjs.map

package/dist/esm/client/format/useRelativeTime.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/client/format/useRelativeTime.ts"],"sourcesContent":["'use client';\n\nimport { relativeTime } from '@intlayer/core';\nimport { useCallback, useContext } from 'preact/hooks';\nimport { IntlayerClientContext } from '../IntlayerProvider';\n\n/**\n * Client-side React hook for accessing a localized relative time formatter.\n *\n * This hook:\n * - Reads the current locale from {@link useLocaleBase}.\n * - Creates a new relative time formatter with {@link createRelativeTime}.\n * - Returns a function that can format time differences into localized strings.\n *\n * Example:\n * ```tsx\n * const relativeTime = useRelativeTime();\n * const formatted = relativeTime(new Date(\"2024-08-01\"), new Date());\n * // e.g., \"2 weeks ago\"\n * ```\n *\n * @returns {ReturnType<typeof createRelativeTime>} A relative time formatting function\n *          bound to the current client locale.\n */\nexport const useRelativeTime = () => {\n  const { locale } = useContext(IntlayerClientContext);\n\n  return useCallback(\n    (...args: Parameters<typeof relativeTime>) =>\n      relativeTime(args[0], args[1], {\n        ...args[2],\n        locale: args[2]?.locale ?? locale,\n      }),\n    [locale]\n  );\n};\n"],"mappings":";AAEA,SAAS,oBAAoB;AAC7B,SAAS,aAAa,kBAAkB;AACxC,SAAS,6BAA6B;AAoB/B,MAAM,kBAAkB,MAAM;AACnC,QAAM,EAAE,OAAO,IAAI,WAAW,qBAAqB;AAEnD,SAAO;AAAA,IACL,IAAI,SACF,aAAa,KAAK,CAAC,GAAG,KAAK,CAAC,GAAG;AAAA,MAC7B,GAAG,KAAK,CAAC;AAAA,MACT,QAAQ,KAAK,CAAC,GAAG,UAAU;AAAA,IAC7B,CAAC;AAAA,IACH,CAAC,MAAM;AAAA,EACT;AACF;","names":[]}

package/dist/esm/client/format/useUnit.mjs

@@ -0,0 +1,18 @@
+"use client";
+import { units } from "@intlayer/core";
+import { useCallback, useContext } from "preact/hooks";
+import { IntlayerClientContext } from "../IntlayerProvider.mjs";
+const useUnit = () => {
+  const { locale } = useContext(IntlayerClientContext);
+  return useCallback(
+    (...args) => units(args[0], {
+      ...args[1],
+      locale: args[1]?.locale ?? locale
+    }),
+    [locale]
+  );
+};
+export {
+  useUnit
+};
+//# sourceMappingURL=useUnit.mjs.map

package/dist/esm/client/format/useUnit.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/client/format/useUnit.ts"],"sourcesContent":["'use client';\n\nimport { units } from '@intlayer/core';\nimport { useCallback, useContext } from 'preact/hooks';\nimport { IntlayerClientContext } from '../IntlayerProvider';\n\n/**\n * React hook that provides a unit formatting function\n * based on the current locale from {@link useLocaleBase}.\n *\n * This hook wraps {@link createUnit} to return a formatter\n * that can convert values into human-readable localized units\n * (e.g., \"10 km\", \"5 lbs\").\n *\n * @example\n * ```tsx\n * const formatUnit = useUnit();\n * const distance = formatUnit(10, { unit: \"kilometer\" });\n * // \"10 km\" (depending on locale)\n * ```\n *\n * @returns {Function} A unit formatting function that accepts a value and optional formatting options.\n */\nexport const useUnit = () => {\n  const { locale } = useContext(IntlayerClientContext);\n\n  return useCallback(\n    (...args: Parameters<typeof units>) =>\n      units(args[0], {\n        ...args[1],\n        locale: args[1]?.locale ?? locale,\n      }),\n    [locale]\n  );\n};\n"],"mappings":";AAEA,SAAS,aAAa;AACtB,SAAS,aAAa,kBAAkB;AACxC,SAAS,6BAA6B;AAmB/B,MAAM,UAAU,MAAM;AAC3B,QAAM,EAAE,OAAO,IAAI,WAAW,qBAAqB;AAEnD,SAAO;AAAA,IACL,IAAI,SACF,MAAM,KAAK,CAAC,GAAG;AAAA,MACb,GAAG,KAAK,CAAC;AAAA,MACT,QAAQ,KAAK,CAAC,GAAG,UAAU;AAAA,IAC7B,CAAC;AAAA,IACH,CAAC,MAAM;AAAA,EACT;AACF;","names":[]}

package/dist/types/client/format/index.d.ts

@@ -0,0 +1,9 @@
+export { useCompact } from './useCompact';
+export { useCurrency } from './useCurrency';
+export { useDate } from './useDate';
+export { useList } from './useList';
+export { useNumber } from './useNumber';
+export { usePercentage } from './usePercentage';
+export { useRelativeTime } from './useRelativeTime';
+export { useUnit } from './useUnit';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/client/format/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/client/format/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC"}

package/dist/types/client/format/useCompact.d.ts

@@ -0,0 +1,14 @@
+/**
+ * React client hook that provides a compact number formatter
+ * bound to the current application locale.
+ *
+ * @example
+ * ```tsx
+ * const formatCompact = useCompact();
+ * formatCompact(1500); // "1.5K"
+ * ```
+ */
+export declare const useCompact: () => (value: string | number, options?: Intl.NumberFormatOptions & {
+    locale?: import("intlayer").LocalesValues;
+}) => string;
+//# sourceMappingURL=useCompact.d.ts.map

package/dist/types/client/format/useCompact.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useCompact.d.ts","sourceRoot":"","sources":["../../../../src/client/format/useCompact.ts"],"names":[],"mappings":"AAMA;;;;;;;;;GASG;AACH,eAAO,MAAM,UAAU;;YAWtB,CAAC"}

package/dist/types/client/format/useCurrency.d.ts

@@ -0,0 +1,28 @@
+/**
+ * React client hook that provides a currency formatter
+ * bound to the current application locale.
+ *
+ * @returns {(value: string | number, options?: CurrencyProps) => string}
+ * A function to format numbers into localized currency strings.
+ *
+ * @example
+ * ```tsx
+ * const formatCurrency = useCurrency();
+ *
+ * formatCurrency(1500, { currency: "USD" });
+ * // "$1,500.00"
+ *
+ * formatCurrency(1500, { currency: "EUR", locale: "de-DE" });
+ * // "1.500,00 €"
+ *
+ * formatCurrency(9876543.21, {
+ *   currency: "JPY",
+ *   fractionDigits: 0,
+ * });
+ * // "¥9,876,543"
+ * ```
+ */
+export declare const useCurrency: () => (value: string | number, options?: Intl.NumberFormatOptions & {
+    locale?: import("intlayer").LocalesValues;
+}) => string;
+//# sourceMappingURL=useCurrency.d.ts.map

package/dist/types/client/format/useCurrency.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useCurrency.d.ts","sourceRoot":"","sources":["../../../../src/client/format/useCurrency.ts"],"names":[],"mappings":"AAMA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,eAAO,MAAM,WAAW;;YAWvB,CAAC"}

package/dist/types/client/format/useDate.d.ts

@@ -0,0 +1,29 @@
+import { date } from '@intlayer/core';
+/**
+ * React client hook that provides a localized date/time formatter
+ * bound to the current application locale.
+ *
+ * @returns {(date: Date | string | number, options?: DateProps) => string}
+ * A function to format dates or timestamps into localized date/time strings.
+ *
+ * @example
+ * ```tsx
+ * const formatDate = useDate();
+ *
+ * formatDate(new Date("2025-01-01"));
+ * // "Jan 1, 2025"
+ *
+ * formatDate("2025-01-01T15:30:00Z", {
+ *   dateStyle: "full",
+ *   timeStyle: "short",
+ * });
+ * // "Wednesday, January 1, 2025 at 3:30 PM"
+ *
+ * formatDate(1735689600000, { locale: "fr-FR", dateStyle: "long" });
+ * // "1 janvier 2025"
+ * ```
+ *
+ * @see createDate
+ */
+export declare const useDate: () => (...args: Parameters<typeof date>) => string;
+//# sourceMappingURL=useDate.d.ts.map

package/dist/types/client/format/useDate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useDate.d.ts","sourceRoot":"","sources":["../../../../src/client/format/useDate.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AAItC;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,eAAO,MAAM,OAAO,SAGV,GAAG,MAAM,UAAU,CAAC,OAAO,IAAI,CAAC,WAKzC,CAAC"}

package/dist/types/client/format/useList.d.ts

@@ -0,0 +1,25 @@
+/**
+ * React client hook that provides a list formatter
+ * bound to the current application locale.
+ *
+ * @returns {(values: (string | number)[], options?: ListProps) => string}
+ * A function to format arrays into localized list strings.
+ *
+ * @example
+ * ```tsx
+ * const formatList = useList();
+ *
+ * formatList(['apple', 'banana', 'orange']);
+ * // "apple, banana, and orange"
+ *
+ * formatList(['red', 'green', 'blue'], { type: 'disjunction' });
+ * // "red, green, or blue"
+ *
+ * formatList([1, 2, 3], { type: 'unit', locale: 'de-DE' });
+ * // "1, 2 und 3"
+ * ```
+ */
+export declare const useList: () => (values: (string | number)[], options?: Intl.ListFormatOptions & {
+    locale?: import("intlayer").LocalesValues;
+}) => string;
+//# sourceMappingURL=useList.d.ts.map

package/dist/types/client/format/useList.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useList.d.ts","sourceRoot":"","sources":["../../../../src/client/format/useList.ts"],"names":[],"mappings":"AAMA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,eAAO,MAAM,OAAO;;YAWnB,CAAC"}

package/dist/types/client/format/useNumber.d.ts

@@ -0,0 +1,26 @@
+/**
+ * React client hook that provides a localized number formatter.
+ *
+ * Uses the current locale from {@link useLocaleBase} and returns
+ * a function that can be used to format numbers consistently
+ * according to the user's locale.
+ *
+ * @example
+ * ```tsx
+ * const formatNumber = useNumber();
+ *
+ * formatNumber(12345);
+ * // e.g. "12,345" (en-US)
+ * // e.g. "12 345" (fr-FR)
+ *
+ * formatNumber(0.75, { style: "percent" });
+ * // e.g. "75%"
+ * ```
+ *
+ * @returns {(value: string | number, options?: import("../createNumber").NumberProps) => string}
+ * A number formatting function bound to the active locale.
+ */
+export declare const useNumber: () => (value: string | number, options?: Intl.NumberFormatOptions & {
+    locale?: import("intlayer").LocalesValues;
+}) => string;
+//# sourceMappingURL=useNumber.d.ts.map

package/dist/types/client/format/useNumber.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useNumber.d.ts","sourceRoot":"","sources":["../../../../src/client/format/useNumber.ts"],"names":[],"mappings":"AAMA;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,eAAO,MAAM,SAAS;;YAWrB,CAAC"}

package/dist/types/client/format/usePercentage.d.ts

@@ -0,0 +1,22 @@
+/**
+ * React hook to provide a percentage formatter function
+ * based on the current application locale.
+ *
+ * This hook retrieves the active locale using {@link useLocaleBase}
+ * and memoizes a `createPercentage` instance for that locale.
+ *
+ * @example
+ * ```tsx
+ * const formatPercentage = usePercentage();
+ *
+ * const result = formatPercentage(0.875, { maximumFractionDigits: 1 });
+ * // "87.5%" (depending on locale)
+ * ```
+ *
+ * @returns {(value: string | number, options?: Omit<PercentageOptions, "value">) => string}
+ * A function that formats numbers or numeric strings into localized percentages.
+ */
+export declare const usePercentage: () => (value: string | number, options?: Intl.NumberFormatOptions & {
+    locale?: import("intlayer").LocalesValues;
+}) => string;
+//# sourceMappingURL=usePercentage.d.ts.map

package/dist/types/client/format/usePercentage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usePercentage.d.ts","sourceRoot":"","sources":["../../../../src/client/format/usePercentage.ts"],"names":[],"mappings":"AAMA;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,aAAa;;YAWzB,CAAC"}

package/dist/types/client/format/useRelativeTime.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Client-side React hook for accessing a localized relative time formatter.
+ *
+ * This hook:
+ * - Reads the current locale from {@link useLocaleBase}.
+ * - Creates a new relative time formatter with {@link createRelativeTime}.
+ * - Returns a function that can format time differences into localized strings.
+ *
+ * Example:
+ * ```tsx
+ * const relativeTime = useRelativeTime();
+ * const formatted = relativeTime(new Date("2024-08-01"), new Date());
+ * // e.g., "2 weeks ago"
+ * ```
+ *
+ * @returns {ReturnType<typeof createRelativeTime>} A relative time formatting function
+ *          bound to the current client locale.
+ */
+export declare const useRelativeTime: () => (from: string | number | Date, to?: string | number | Date, options?: Intl.RelativeTimeFormatOptions & {
+    locale?: import("intlayer").LocalesValues;
+    unit?: Intl.RelativeTimeFormatUnit;
+}) => string;
+//# sourceMappingURL=useRelativeTime.d.ts.map

package/dist/types/client/format/useRelativeTime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useRelativeTime.d.ts","sourceRoot":"","sources":["../../../../src/client/format/useRelativeTime.ts"],"names":[],"mappings":"AAMA;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,eAAe;;;YAW3B,CAAC"}

package/dist/types/client/format/useUnit.d.ts

@@ -0,0 +1,21 @@
+/**
+ * React hook that provides a unit formatting function
+ * based on the current locale from {@link useLocaleBase}.
+ *
+ * This hook wraps {@link createUnit} to return a formatter
+ * that can convert values into human-readable localized units
+ * (e.g., "10 km", "5 lbs").
+ *
+ * @example
+ * ```tsx
+ * const formatUnit = useUnit();
+ * const distance = formatUnit(10, { unit: "kilometer" });
+ * // "10 km" (depending on locale)
+ * ```
+ *
+ * @returns {Function} A unit formatting function that accepts a value and optional formatting options.
+ */
+export declare const useUnit: () => (value: string | number, options?: Intl.NumberFormatOptions & {
+    locale?: import("intlayer").LocalesValues;
+}) => string;
+//# sourceMappingURL=useUnit.d.ts.map

package/dist/types/client/format/useUnit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useUnit.d.ts","sourceRoot":"","sources":["../../../../src/client/format/useUnit.ts"],"names":[],"mappings":"AAMA;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,OAAO;;YAWnB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "preact-intlayer",
-  "version": "5.8.0-canary.0",
+  "version": "5.8.1",
   "private": false,
   "description": "Easily internationalize i18n your Preact applications with type-safe multilingual content management.",
   "keywords": [
@@ -39,6 +39,11 @@
       "require": "./dist/cjs/index.cjs",
       "import": "./dist/esm/index.mjs"
     },
+    "./format": {
+      "types": "./dist/types/client/format/index.d.ts",
+      "require": "./dist/cjs/client/format/index.cjs",
+      "import": "./dist/esm/client/format/index.mjs"
+    },
     "./package.json": "./package.json"
   },
   "main": "dist/cjs/index.cjs",
@@ -58,11 +63,11 @@
   "dependencies": {
     "js-cookie": "^3.0.5",
     "uuid": "^11.1.0",
-    "@intlayer/chokidar": "5.8.0-canary.0",
-    "@intlayer/core": "5.8.0-canary.0",
-    "@intlayer/api": "5.8.0-canary.0",
-    "@intlayer/config": "5.8.0-canary.0",
-    "@intlayer/editor": "5.8.0-canary.0"
+    "@intlayer/api": "5.8.1",
+    "@intlayer/core": "5.8.1",
+    "@intlayer/config": "5.8.1",
+    "@intlayer/chokidar": "5.8.1",
+    "@intlayer/editor": "5.8.1"
   },
   "devDependencies": {
     "@types/node": "^24.2.1",
@@ -76,18 +81,18 @@
     "tsup": "^8.5.0",
     "typescript": "^5.9.2",
     "vitest": "^3.2.2",
-    "@utils/eslint-config": "1.0.4",
     "@utils/ts-config": "1.0.4",
-    "@utils/tsup-config": "1.0.4",
-    "@utils/ts-config-types": "1.0.4"
+    "@utils/eslint-config": "1.0.4",
+    "@utils/ts-config-types": "1.0.4",
+    "@utils/tsup-config": "1.0.4"
   },
   "peerDependencies": {
     "preact": "^10.26.4",
-    "@intlayer/api": "5.8.0-canary.0",
-    "@intlayer/chokidar": "5.8.0-canary.0",
-    "@intlayer/editor": "5.8.0-canary.0",
-    "@intlayer/core": "5.8.0-canary.0",
-    "@intlayer/config": "5.8.0-canary.0"
+    "@intlayer/api": "5.8.1",
+    "@intlayer/chokidar": "5.8.1",
+    "@intlayer/config": "5.8.1",
+    "@intlayer/core": "5.8.1",
+    "@intlayer/editor": "5.8.1"
   },
   "engines": {
     "node": ">=14.18"