katanakit-js 2.2.1 → 2.12.9

package/dist/core/services/formatter.service.d.ts

@@ -1,36 +1,246 @@
-import type { CurrencyFormatOptions, IConverterService, IFormatterService, Locale } from "../../types/index.js";
-/**
- * Number/currency/string formatter (Adapter + Singleton) over `Intl`.
- */
-export declare class FormatterService implements IFormatterService {
-    private static instance;
-    private constructor();
-    static getInstance(): FormatterService;
-    useFormatNumber: (value: number, locale?: Locale, digits?: number) => string;
-    useUpperCase: (text: string, locale?: Locale) => string;
-    useLowerCase: (text: string, locale?: Locale) => string;
-    useCapitalize: (text: string, locale?: Locale) => string;
-    useFormatCurrency: (options: CurrencyFormatOptions) => string;
-    useJsonStringify: (data: unknown) => string;
-    useJsonParse: <T = unknown>(json: string) => T;
-}
-/**
- * Unit converter facade (Facade + Adapter + Singleton) built on FormatterService.
- */
-export declare class ConverterService implements IConverterService {
-    private static instance;
-    private readonly formatter;
-    private constructor();
-    static getInstance(): ConverterService;
-    useToCelsius: (fahrenheit: number, locale?: Locale, digits?: number) => string;
-    useToFahrenheit: (celsius: number, locale?: Locale, digits?: number) => string;
-    useToKilometers: (miles: number, locale?: Locale, digits?: number) => string;
-    useToMiles: (km: number, locale?: Locale, digits?: number) => string;
-    useToInches: (cm: number, locale?: Locale, digits?: number) => string;
-    useToCm: (inches: number, locale?: Locale, digits?: number) => string;
-    useToKilos: (pounds: number, locale?: Locale, digits?: number) => string;
-    useToPounds: (kilos: number, locale?: Locale, digits?: number) => string;
-}
-export declare const useToCelsius: (fahrenheit: number, locale?: Locale, digits?: number) => string, useToFahrenheit: (celsius: number, locale?: Locale, digits?: number) => string, useToKilometers: (miles: number, locale?: Locale, digits?: number) => string, useToMiles: (km: number, locale?: Locale, digits?: number) => string, useToInches: (cm: number, locale?: Locale, digits?: number) => string, useToCm: (inches: number, locale?: Locale, digits?: number) => string, useToKilos: (pounds: number, locale?: Locale, digits?: number) => string, useToPounds: (kilos: number, locale?: Locale, digits?: number) => string;
-export declare const useFormatCurrency: (options: CurrencyFormatOptions) => string, useFormatNumber: (value: number, locale?: Locale, digits?: number) => string, useJsonStringify: (data: unknown) => string, useJsonParse: <T = unknown>(json: string) => T, useUpperCase: (text: string, locale?: Locale) => string, useLowerCase: (text: string, locale?: Locale) => string, useCapitalize: (text: string, locale?: Locale) => string;
+import type { CurrencyFormatOptions, Locale } from "../../types/index.js";
+/**
+ * Pure number formatter over `Intl.NumberFormat`.
+ * Stateless — safe to call from any environment.
+ *
+ * @param value - The number to format.
+ * @param locale - BCP 47 locale tag. Defaults to `"en"`.
+ * @param digits - Maximum and minimum fraction digits. Defaults to `2`.
+ * @returns The formatted number string.
+ *
+ * @example
+ * ```ts
+ * import { useFormatNumber } from "katanakit-js";
+ *
+ * useFormatNumber(1234.5, "en", 2); // "1,234.50"
+ * useFormatNumber(1234.5, "de", 2); // "1.234,50"
+ * ```
+ */
+export declare function useFormatNumber(value: number, locale?: Locale, digits?: number): string;
+/**
+ * Pure: locale-aware upper case (trims whitespace).
+ *
+ * @param text - The string to transform.
+ * @param locale - BCP 47 locale tag. Defaults to `"en"`.
+ * @returns The upper-cased, trimmed string.
+ *
+ * @example
+ * ```ts
+ * import { useUpperCase } from "katanakit-js";
+ *
+ * useUpperCase("hello"); // "HELLO"
+ * useUpperCase("straße", "de"); // "STRASSE"
+ * ```
+ */
+export declare function useUpperCase(text: string, locale?: Locale): string;
+/**
+ * Pure: locale-aware lower case (trims whitespace).
+ *
+ * @param text - The string to transform.
+ * @param locale - BCP 47 locale tag. Defaults to `"en"`.
+ * @returns The lower-cased, trimmed string.
+ *
+ * @example
+ * ```ts
+ * import { useLowerCase } from "katanakit-js";
+ *
+ * useLowerCase("HELLO"); // "hello"
+ * ```
+ */
+export declare function useLowerCase(text: string, locale?: Locale): string;
+/**
+ * Pure: capitalizes the first character; leaves the rest unchanged.
+ *
+ * @param text - The string to capitalize.
+ * @param locale - BCP 47 locale tag. Defaults to `"en"`.
+ * @returns The string with its first character upper-cased.
+ *
+ * @example
+ * ```ts
+ * import { useCapitalize } from "katanakit-js";
+ *
+ * useCapitalize("hello world"); // "Hello world"
+ * ```
+ */
+export declare function useCapitalize(text: string, locale?: Locale): string;
+/**
+ * Pure: formats an amount as currency.
+ *
+ * `taxes` accepts either a percentage (`21` → 21%) or a decimal fraction
+ * (`0.21` → 21%). Values `> 1` are treated as percentages; values in `(0, 1]`
+ * as fractions. Prefer an explicit fraction when you need a rate ≤ 1%.
+ *
+ * @param options - Currency formatting options.
+ * @returns The formatted currency string.
+ *
+ * @example
+ * ```ts
+ * import { useFormatCurrency } from "katanakit-js";
+ *
+ * useFormatCurrency({ amount: 100, currency: "USD" }); // "$100.00"
+ * useFormatCurrency({ amount: 100, taxes: 21 }); // "$121.00"
+ * useFormatCurrency({ amount: 100, taxes: 0.21, locale: "es" }); // "121,00 €"
+ * ```
+ */
+export declare function useFormatCurrency(options: CurrencyFormatOptions): string;
+/**
+ * Pure: pretty-print JSON (3-space indent).
+ *
+ * @param data - The value to serialize.
+ * @returns The indented JSON string.
+ *
+ * @example
+ * ```ts
+ * import { useJsonStringify } from "katanakit-js";
+ *
+ * useJsonStringify({ a: 1 });
+ * // '{\n   "a": 1\n}'
+ * ```
+ */
+export declare function useJsonStringify(data: unknown): string;
+/**
+ * Pure: parse JSON (throws on invalid input — same as `JSON.parse`).
+ *
+ * @param json - The JSON string to parse.
+ * @returns The parsed value typed as `T`.
+ *
+ * @example
+ * ```ts
+ * import { useJsonParse } from "katanakit-js";
+ *
+ * const obj = useJsonParse<{ a: number }>('{"a":1}');
+ * // { a: 1 }
+ * ```
+ */
+export declare function useJsonParse<T = unknown>(json: string): T;
+/**
+ * Pure: °F → °C (formatted).
+ *
+ * @param fahrenheit - Temperature in Fahrenheit.
+ * @param locale - BCP 47 locale tag. Defaults to `"en"`.
+ * @param digits - Fraction digits. Defaults to `2`.
+ * @returns The formatted Celsius string.
+ *
+ * @example
+ * ```ts
+ * import { useToCelsius } from "katanakit-js";
+ *
+ * useToCelsius(212); // "100.00"
+ * useToCelsius(32);  // "0.00"
+ * ```
+ */
+export declare function useToCelsius(fahrenheit: number, locale?: Locale, digits?: number): string;
+/**
+ * Pure: °C → °F (formatted).
+ *
+ * @param celsius - Temperature in Celsius.
+ * @param locale - BCP 47 locale tag. Defaults to `"en"`.
+ * @param digits - Fraction digits. Defaults to `2`.
+ * @returns The formatted Fahrenheit string.
+ *
+ * @example
+ * ```ts
+ * import { useToFahrenheit } from "katanakit-js";
+ *
+ * useToFahrenheit(100); // "212.00"
+ * useToFahrenheit(0);   // "32.00"
+ * ```
+ */
+export declare function useToFahrenheit(celsius: number, locale?: Locale, digits?: number): string;
+/**
+ * Pure: miles → kilometers (formatted). Round-trips with `useToMiles`.
+ *
+ * @param miles - Distance in miles.
+ * @param locale - BCP 47 locale tag. Defaults to `"en"`.
+ * @param digits - Fraction digits. Defaults to `2`.
+ * @returns The formatted kilometer string.
+ *
+ * @example
+ * ```ts
+ * import { useToKilometers } from "katanakit-js";
+ *
+ * useToKilometers(1); // "1.61"
+ * ```
+ */
+export declare function useToKilometers(miles: number, locale?: Locale, digits?: number): string;
+/**
+ * Pure: kilometers → miles (formatted). Round-trips with `useToKilometers`.
+ *
+ * @param km - Distance in kilometers.
+ * @param locale - BCP 47 locale tag. Defaults to `"en"`.
+ * @param digits - Fraction digits. Defaults to `2`.
+ * @returns The formatted mile string.
+ *
+ * @example
+ * ```ts
+ * import { useToMiles } from "katanakit-js";
+ *
+ * useToMiles(1.60934); // "1.00"
+ * ```
+ */
+export declare function useToMiles(km: number, locale?: Locale, digits?: number): string;
+/**
+ * Pure: centimeters → inches (formatted).
+ *
+ * @param cm - Length in centimeters.
+ * @param locale - BCP 47 locale tag. Defaults to `"en"`.
+ * @param digits - Fraction digits. Defaults to `2`.
+ * @returns The formatted inch string.
+ *
+ * @example
+ * ```ts
+ * import { useToInches } from "katanakit-js";
+ *
+ * useToInches(2.54); // "1.00"
+ * ```
+ */
+export declare function useToInches(cm: number, locale?: Locale, digits?: number): string;
+/**
+ * Pure: inches → centimeters (formatted).
+ *
+ * @param inches - Length in inches.
+ * @param locale - BCP 47 locale tag. Defaults to `"en"`.
+ * @param digits - Fraction digits. Defaults to `2`.
+ * @returns The formatted centimeter string.
+ *
+ * @example
+ * ```ts
+ * import { useToCm } from "katanakit-js";
+ *
+ * useToCm(1); // "2.54"
+ * ```
+ */
+export declare function useToCm(inches: number, locale?: Locale, digits?: number): string;
+/**
+ * Pure: pounds → kilograms (formatted).
+ *
+ * @param pounds - Weight in pounds.
+ * @param locale - BCP 47 locale tag. Defaults to `"en"`.
+ * @param digits - Fraction digits. Defaults to `2`.
+ * @returns The formatted kilogram string.
+ *
+ * @example
+ * ```ts
+ * import { useToKilos } from "katanakit-js";
+ *
+ * useToKilos(1); // "0.45"
+ * ```
+ */
+export declare function useToKilos(pounds: number, locale?: Locale, digits?: number): string;
+/**
+ * Pure: kilograms → pounds (formatted).
+ *
+ * @param kilos - Weight in kilograms.
+ * @param locale - BCP 47 locale tag. Defaults to `"en"`.
+ * @param digits - Fraction digits. Defaults to `2`.
+ * @returns The formatted pound string.
+ *
+ * @example
+ * ```ts
+ * import { useToPounds } from "katanakit-js";
+ *
+ * useToPounds(1); // "2.20"
+ * ```
+ */
+export declare function useToPounds(kilos: number, locale?: Locale, digits?: number): string;
 //# sourceMappingURL=formatter.service.d.ts.map

package/dist/core/services/formatter.service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"formatter.service.d.ts","sourceRoot":"","sources":["../../../src/core/services/formatter.service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACX,qBAAqB,EACrB,iBAAiB,EACjB,iBAAiB,EACjB,MAAM,EACN,MAAM,sBAAsB,CAAC;AAE9B;;GAEG;AACH,qBAAa,gBAAiB,YAAW,iBAAiB;IACzD,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAmB;IAE1C,OAAO,eAAiB;IAExB,OAAc,WAAW,IAAI,gBAAgB,CAK5C;IAEM,eAAe,UAAW,MAAM,WAAU,MAAM,sBAAsB,MAAM,CAKjF;IAEK,YAAY,SAAU,MAAM,WAAU,MAAM,KAAU,MAAM,CAC5B;IAEhC,YAAY,SAAU,MAAM,WAAU,MAAM,KAAU,MAAM,CAC5B;IAEhC,aAAa,SAAU,MAAM,WAAU,MAAM,KAAU,MAAM,CAIlE;IAEK,iBAAiB,YAAa,qBAAqB,KAAG,MAAM,CAOjE;IAEK,gBAAgB,SAAU,OAAO,KAAG,MAAM,CAAkC;IAE5E,YAAY,GAAI,CAAC,GAAG,OAAO,QAAQ,MAAM,KAAG,CAAC,CAA0B;CAC9E;AAED;;GAEG;AACH,qBAAa,gBAAiB,YAAW,iBAAiB;IACzD,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAmB;IAC1C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAmB;IAE7C,OAAO,eAEN;IAED,OAAc,WAAW,IAAI,gBAAgB,CAK5C;IAEM,YAAY,eAAgB,MAAM,WAAU,MAAM,sBAAsB,MAAM,CACZ;IAElE,eAAe,YAAa,MAAM,WAAU,MAAM,sBAAsB,MAAM,CACjB;IAE7D,eAAe,UAAW,MAAM,WAAU,MAAM,sBAAsB,MAAM,CAClB;IAE1D,UAAU,OAAQ,MAAM,WAAU,MAAM,sBAAsB,MAAM,CACb;IAEvD,WAAW,OAAQ,MAAM,WAAU,MAAM,sBAAsB,MAAM,CACjB;IAEpD,OAAO,WAAY,MAAM,WAAU,MAAM,sBAAsB,MAAM,CACb;IAExD,UAAU,WAAY,MAAM,WAAU,MAAM,sBAAsB,MAAM,CACZ;IAE5D,WAAW,UAAW,MAAM,WAAU,MAAM,sBAAsB,MAAM,CACb;CAClE;AAGD,eAAO,MACN,YAAY,eA3BuB,MAAM,WAAU,MAAM,sBAAsB,MAAM,EA4BrF,eAAe,YAzBoB,MAAM,WAAU,MAAM,sBAAsB,MAAM,EA0BrF,eAAe,UAvBkB,MAAM,WAAU,MAAM,sBAAsB,MAAM,EAwBnF,UAAU,OArBe,MAAM,WAAU,MAAM,sBAAsB,MAAM,EAsB3E,WAAW,OAnBe,MAAM,WAAU,MAAM,sBAAsB,MAAM,EAoB5E,OAAO,WAjBmB,MAAM,WAAU,MAAM,sBAAsB,MAAM,EAkB5E,UAAU,WAfmB,MAAM,WAAU,MAAM,sBAAsB,MAAM,EAgB/E,WAAW,UAbkB,MAAM,WAAU,MAAM,sBAAsB,MActB,CAAC;AAErD,eAAO,MACN,iBAAiB,YAtEoB,qBAAqB,KAAG,MAAM,EAuEnE,eAAe,UA1FkB,MAAM,WAAU,MAAM,sBAAsB,MAAM,EA2FnF,gBAAgB,SA/DiB,OAAO,KAAG,MAAM,EAgEjD,YAAY,GA9DW,CAAC,kBAAkB,MAAM,QA+DhD,YAAY,SAtFiB,MAAM,WAAU,MAAM,KAAU,MAAM,EAuFnE,YAAY,SApFiB,MAAM,WAAU,MAAM,KAAU,MAAM,EAqFnE,aAAa,SAlFiB,MAAM,WAAU,MAAM,KAAU,MAmFX,CAAC"}
+{"version":3,"file":"formatter.service.d.ts","sourceRoot":"","sources":["../../../src/core/services/formatter.service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAO1E;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,GAAE,MAAa,EAAE,MAAM,SAAI,GAAG,MAAM,CAKxF;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,GAAE,MAAa,GAAG,MAAM,CAExE;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,GAAE,MAAa,GAAG,MAAM,CAExE;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,GAAE,MAAa,GAAG,MAAM,CAIzE;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,qBAAqB,GAAG,MAAM,CAMxE;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,CAEtD;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,YAAY,CAAC,CAAC,GAAG,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,CAAC,CAEzD;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,YAAY,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,GAAE,MAAa,EAAE,MAAM,SAAI,GAAG,MAAM,CAE1F;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,GAAE,MAAa,EAAE,MAAM,SAAI,GAAG,MAAM,CAE1F;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,GAAE,MAAa,EAAE,MAAM,SAAI,GAAG,MAAM,CAExF;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,UAAU,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,GAAE,MAAa,EAAE,MAAM,SAAI,GAAG,MAAM,CAEhF;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,WAAW,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,GAAE,MAAa,EAAE,MAAM,SAAI,GAAG,MAAM,CAEjF;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,GAAE,MAAa,EAAE,MAAM,SAAI,GAAG,MAAM,CAEjF;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,GAAE,MAAa,EAAE,MAAM,SAAI,GAAG,MAAM,CAEpF;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,GAAE,MAAa,EAAE,MAAM,SAAI,GAAG,MAAM,CAEpF"}

package/dist/core/services/formatter.service.js

@@ -1,64 +1,288 @@
+/** International statute mile in kilometers (shared by both directions). */
+const KM_PER_MILE = 1.60934;
+const KG_PER_POUND = 0.453592;
+const CM_PER_INCH = 2.54;
 /**
- * Number/currency/string formatter (Adapter + Singleton) over `Intl`.
+ * Pure number formatter over `Intl.NumberFormat`.
+ * Stateless — safe to call from any environment.
+ *
+ * @param value - The number to format.
+ * @param locale - BCP 47 locale tag. Defaults to `"en"`.
+ * @param digits - Maximum and minimum fraction digits. Defaults to `2`.
+ * @returns The formatted number string.
+ *
+ * @example
+ * ```ts
+ * import { useFormatNumber } from "katanakit-js";
+ *
+ * useFormatNumber(1234.5, "en", 2); // "1,234.50"
+ * useFormatNumber(1234.5, "de", 2); // "1.234,50"
+ * ```
  */
-export class FormatterService {
-    static instance;
-    constructor() { }
-    static getInstance() {
-        if (!FormatterService.instance) {
-            FormatterService.instance = new FormatterService();
-        }
-        return FormatterService.instance;
-    }
-    useFormatNumber = (value, locale = "en", digits = 2) => {
-        return new Intl.NumberFormat(locale, {
-            maximumFractionDigits: digits,
-            minimumFractionDigits: digits,
-        }).format(value);
-    };
-    useUpperCase = (text, locale = "en") => text.toLocaleUpperCase(locale).trim();
-    useLowerCase = (text, locale = "en") => text.toLocaleLowerCase(locale).trim();
-    useCapitalize = (text, locale = "en") => {
-        const trimmed = text.trim();
-        if (!trimmed)
-            return "";
-        return trimmed.charAt(0).toLocaleUpperCase(locale) + trimmed.slice(1);
-    };
-    useFormatCurrency = (options) => {
-        const { amount, currency = "USD", taxes = 0, locale = "en" } = options;
-        // `taxes` may be a percentage (21) or a decimal fraction (0.21).
-        const taxRate = taxes > 1 ? taxes / 100 : taxes;
-        const total = amount * (1 + taxRate);
-        return new Intl.NumberFormat(locale, { style: "currency", currency }).format(total);
-    };
-    useJsonStringify = (data) => JSON.stringify(data, null, 3);
-    useJsonParse = (json) => JSON.parse(json);
+export function useFormatNumber(value, locale = "en", digits = 2) {
+    return new Intl.NumberFormat(locale, {
+        maximumFractionDigits: digits,
+        minimumFractionDigits: digits,
+    }).format(value);
 }
 /**
- * Unit converter facade (Facade + Adapter + Singleton) built on FormatterService.
+ * Pure: locale-aware upper case (trims whitespace).
+ *
+ * @param text - The string to transform.
+ * @param locale - BCP 47 locale tag. Defaults to `"en"`.
+ * @returns The upper-cased, trimmed string.
+ *
+ * @example
+ * ```ts
+ * import { useUpperCase } from "katanakit-js";
+ *
+ * useUpperCase("hello"); // "HELLO"
+ * useUpperCase("straße", "de"); // "STRASSE"
+ * ```
  */
-export class ConverterService {
-    static instance;
-    formatter;
-    constructor() {
-        this.formatter = FormatterService.getInstance();
-    }
-    static getInstance() {
-        if (!ConverterService.instance) {
-            ConverterService.instance = new ConverterService();
-        }
-        return ConverterService.instance;
-    }
-    useToCelsius = (fahrenheit, locale = "en", digits = 2) => this.formatter.useFormatNumber((fahrenheit - 32) / 1.8, locale, digits);
-    useToFahrenheit = (celsius, locale = "en", digits = 2) => this.formatter.useFormatNumber(celsius * 1.8 + 32, locale, digits);
-    useToKilometers = (miles, locale = "en", digits = 2) => this.formatter.useFormatNumber(miles / 0.62137, locale, digits);
-    useToMiles = (km, locale = "en", digits = 2) => this.formatter.useFormatNumber(km * 1.60934, locale, digits);
-    useToInches = (cm, locale = "en", digits = 2) => this.formatter.useFormatNumber(cm / 2.54, locale, digits);
-    useToCm = (inches, locale = "en", digits = 2) => this.formatter.useFormatNumber(inches * 2.54, locale, digits);
-    useToKilos = (pounds, locale = "en", digits = 2) => this.formatter.useFormatNumber(pounds * 0.453592, locale, digits);
-    useToPounds = (kilos, locale = "en", digits = 2) => this.formatter.useFormatNumber(kilos / 0.453592, locale, digits);
+export function useUpperCase(text, locale = "en") {
+    return text.toLocaleUpperCase(locale).trim();
+}
+/**
+ * Pure: locale-aware lower case (trims whitespace).
+ *
+ * @param text - The string to transform.
+ * @param locale - BCP 47 locale tag. Defaults to `"en"`.
+ * @returns The lower-cased, trimmed string.
+ *
+ * @example
+ * ```ts
+ * import { useLowerCase } from "katanakit-js";
+ *
+ * useLowerCase("HELLO"); // "hello"
+ * ```
+ */
+export function useLowerCase(text, locale = "en") {
+    return text.toLocaleLowerCase(locale).trim();
+}
+/**
+ * Pure: capitalizes the first character; leaves the rest unchanged.
+ *
+ * @param text - The string to capitalize.
+ * @param locale - BCP 47 locale tag. Defaults to `"en"`.
+ * @returns The string with its first character upper-cased.
+ *
+ * @example
+ * ```ts
+ * import { useCapitalize } from "katanakit-js";
+ *
+ * useCapitalize("hello world"); // "Hello world"
+ * ```
+ */
+export function useCapitalize(text, locale = "en") {
+    const trimmed = text.trim();
+    if (!trimmed)
+        return "";
+    return trimmed.charAt(0).toLocaleUpperCase(locale) + trimmed.slice(1);
+}
+/**
+ * Pure: formats an amount as currency.
+ *
+ * `taxes` accepts either a percentage (`21` → 21%) or a decimal fraction
+ * (`0.21` → 21%). Values `> 1` are treated as percentages; values in `(0, 1]`
+ * as fractions. Prefer an explicit fraction when you need a rate ≤ 1%.
+ *
+ * @param options - Currency formatting options.
+ * @returns The formatted currency string.
+ *
+ * @example
+ * ```ts
+ * import { useFormatCurrency } from "katanakit-js";
+ *
+ * useFormatCurrency({ amount: 100, currency: "USD" }); // "$100.00"
+ * useFormatCurrency({ amount: 100, taxes: 21 }); // "$121.00"
+ * useFormatCurrency({ amount: 100, taxes: 0.21, locale: "es" }); // "121,00 €"
+ * ```
+ */
+export function useFormatCurrency(options) {
+    const { amount, currency = "USD", taxes = 0, locale = "en" } = options;
+    const taxRate = taxes > 1 ? taxes / 100 : taxes;
+    const total = amount * (1 + taxRate);
+    return new Intl.NumberFormat(locale, { style: "currency", currency }).format(total);
+}
+/**
+ * Pure: pretty-print JSON (3-space indent).
+ *
+ * @param data - The value to serialize.
+ * @returns The indented JSON string.
+ *
+ * @example
+ * ```ts
+ * import { useJsonStringify } from "katanakit-js";
+ *
+ * useJsonStringify({ a: 1 });
+ * // '{\n   "a": 1\n}'
+ * ```
+ */
+export function useJsonStringify(data) {
+    return JSON.stringify(data, null, 3);
+}
+/**
+ * Pure: parse JSON (throws on invalid input — same as `JSON.parse`).
+ *
+ * @param json - The JSON string to parse.
+ * @returns The parsed value typed as `T`.
+ *
+ * @example
+ * ```ts
+ * import { useJsonParse } from "katanakit-js";
+ *
+ * const obj = useJsonParse<{ a: number }>('{"a":1}');
+ * // { a: 1 }
+ * ```
+ */
+export function useJsonParse(json) {
+    return JSON.parse(json);
+}
+/**
+ * Pure: °F → °C (formatted).
+ *
+ * @param fahrenheit - Temperature in Fahrenheit.
+ * @param locale - BCP 47 locale tag. Defaults to `"en"`.
+ * @param digits - Fraction digits. Defaults to `2`.
+ * @returns The formatted Celsius string.
+ *
+ * @example
+ * ```ts
+ * import { useToCelsius } from "katanakit-js";
+ *
+ * useToCelsius(212); // "100.00"
+ * useToCelsius(32);  // "0.00"
+ * ```
+ */
+export function useToCelsius(fahrenheit, locale = "en", digits = 2) {
+    return useFormatNumber((fahrenheit - 32) / 1.8, locale, digits);
+}
+/**
+ * Pure: °C → °F (formatted).
+ *
+ * @param celsius - Temperature in Celsius.
+ * @param locale - BCP 47 locale tag. Defaults to `"en"`.
+ * @param digits - Fraction digits. Defaults to `2`.
+ * @returns The formatted Fahrenheit string.
+ *
+ * @example
+ * ```ts
+ * import { useToFahrenheit } from "katanakit-js";
+ *
+ * useToFahrenheit(100); // "212.00"
+ * useToFahrenheit(0);   // "32.00"
+ * ```
+ */
+export function useToFahrenheit(celsius, locale = "en", digits = 2) {
+    return useFormatNumber(celsius * 1.8 + 32, locale, digits);
+}
+/**
+ * Pure: miles → kilometers (formatted). Round-trips with `useToMiles`.
+ *
+ * @param miles - Distance in miles.
+ * @param locale - BCP 47 locale tag. Defaults to `"en"`.
+ * @param digits - Fraction digits. Defaults to `2`.
+ * @returns The formatted kilometer string.
+ *
+ * @example
+ * ```ts
+ * import { useToKilometers } from "katanakit-js";
+ *
+ * useToKilometers(1); // "1.61"
+ * ```
+ */
+export function useToKilometers(miles, locale = "en", digits = 2) {
+    return useFormatNumber(miles * KM_PER_MILE, locale, digits);
+}
+/**
+ * Pure: kilometers → miles (formatted). Round-trips with `useToKilometers`.
+ *
+ * @param km - Distance in kilometers.
+ * @param locale - BCP 47 locale tag. Defaults to `"en"`.
+ * @param digits - Fraction digits. Defaults to `2`.
+ * @returns The formatted mile string.
+ *
+ * @example
+ * ```ts
+ * import { useToMiles } from "katanakit-js";
+ *
+ * useToMiles(1.60934); // "1.00"
+ * ```
+ */
+export function useToMiles(km, locale = "en", digits = 2) {
+    return useFormatNumber(km / KM_PER_MILE, locale, digits);
+}
+/**
+ * Pure: centimeters → inches (formatted).
+ *
+ * @param cm - Length in centimeters.
+ * @param locale - BCP 47 locale tag. Defaults to `"en"`.
+ * @param digits - Fraction digits. Defaults to `2`.
+ * @returns The formatted inch string.
+ *
+ * @example
+ * ```ts
+ * import { useToInches } from "katanakit-js";
+ *
+ * useToInches(2.54); // "1.00"
+ * ```
+ */
+export function useToInches(cm, locale = "en", digits = 2) {
+    return useFormatNumber(cm / CM_PER_INCH, locale, digits);
+}
+/**
+ * Pure: inches → centimeters (formatted).
+ *
+ * @param inches - Length in inches.
+ * @param locale - BCP 47 locale tag. Defaults to `"en"`.
+ * @param digits - Fraction digits. Defaults to `2`.
+ * @returns The formatted centimeter string.
+ *
+ * @example
+ * ```ts
+ * import { useToCm } from "katanakit-js";
+ *
+ * useToCm(1); // "2.54"
+ * ```
+ */
+export function useToCm(inches, locale = "en", digits = 2) {
+    return useFormatNumber(inches * CM_PER_INCH, locale, digits);
+}
+/**
+ * Pure: pounds → kilograms (formatted).
+ *
+ * @param pounds - Weight in pounds.
+ * @param locale - BCP 47 locale tag. Defaults to `"en"`.
+ * @param digits - Fraction digits. Defaults to `2`.
+ * @returns The formatted kilogram string.
+ *
+ * @example
+ * ```ts
+ * import { useToKilos } from "katanakit-js";
+ *
+ * useToKilos(1); // "0.45"
+ * ```
+ */
+export function useToKilos(pounds, locale = "en", digits = 2) {
+    return useFormatNumber(pounds * KG_PER_POUND, locale, digits);
+}
+/**
+ * Pure: kilograms → pounds (formatted).
+ *
+ * @param kilos - Weight in kilograms.
+ * @param locale - BCP 47 locale tag. Defaults to `"en"`.
+ * @param digits - Fraction digits. Defaults to `2`.
+ * @returns The formatted pound string.
+ *
+ * @example
+ * ```ts
+ * import { useToPounds } from "katanakit-js";
+ *
+ * useToPounds(1); // "2.20"
+ * ```
+ */
+export function useToPounds(kilos, locale = "en", digits = 2) {
+    return useFormatNumber(kilos / KG_PER_POUND, locale, digits);
 }
-// Singleton instances and destructured exports.
-export const { useToCelsius, useToFahrenheit, useToKilometers, useToMiles, useToInches, useToCm, useToKilos, useToPounds, } = ConverterService.getInstance();
-export const { useFormatCurrency, useFormatNumber, useJsonStringify, useJsonParse, useUpperCase, useLowerCase, useCapitalize, } = FormatterService.getInstance();
 //# sourceMappingURL=formatter.service.js.map

package/dist/core/services/formatter.service.js.map

@@ -1 +1 @@
-{"version":3,"file":"formatter.service.js","sourceRoot":"","sources":["../../../src/core/services/formatter.service.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"formatter.service.js","sourceRoot":"","sources":["../../../src/core/services/formatter.service.ts"],"names":[],"mappings":"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"}