@eternl/formats 0.1.0

package/dist/esm/internal/intl-cache.js

@@ -0,0 +1,87 @@
+const numberFormatCache = new Map();
+const numberFormatMetaCache = new Map();
+const dateFormatCache = new Map();
+const serializeOptions = (options) => {
+    const entries = Object.entries(options)
+        .filter(([, value]) => value !== undefined)
+        .sort(([a], [b]) => (a < b ? -1 : a > b ? 1 : 0))
+        .map(([key, value]) => {
+        if (value
+            && typeof value === 'object'
+            && !Array.isArray(value)) {
+            return `${key}:{${serializeOptions(value)}}`;
+        }
+        if (Array.isArray(value)) {
+            return `${key}:[${value.join('|')}]`;
+        }
+        return `${key}:${String(value)}`;
+    });
+    return entries.join(',');
+};
+const buildNumberFormatKey = (locale, options) => `${locale}|${serializeOptions(options)}`;
+const buildDateFormatKey = (locale, options) => `${locale}|${options ? serializeOptions(options) : ''}`;
+export const getNumberFormat = (locale, options) => {
+    const key = buildNumberFormatKey(locale, options);
+    const cached = numberFormatCache.get(key);
+    if (cached) {
+        return cached;
+    }
+    const nf = new Intl.NumberFormat(locale, options);
+    numberFormatCache.set(key, nf);
+    return nf;
+};
+const deriveGrouping = (parts) => {
+    const integerParts = parts.filter((part) => part.type === 'integer');
+    if (integerParts.length <= 1) {
+        return { primary: 0 };
+    }
+    const lengths = integerParts.map((part) => part.value.length);
+    const primary = lengths[lengths.length - 1];
+    const secondary = lengths.length > 1 ? lengths[lengths.length - 2] : undefined;
+    if (secondary === primary) {
+        return { primary };
+    }
+    return { primary, secondary };
+};
+const analyzePattern = (nf) => {
+    const sampleValue = 1234567.89;
+    const positiveParts = nf.formatToParts(sampleValue);
+    const negativeParts = nf.formatToParts(-sampleValue);
+    const plusProbe = nf.formatToParts(1);
+    const groupSeparator = positiveParts.find((part) => part.type === 'group')?.value ?? '';
+    const decimalSeparator = positiveParts.find((part) => part.type === 'decimal')?.value ?? '.';
+    const grouping = deriveGrouping(positiveParts);
+    const minusSign = negativeParts.find((part) => part.type === 'minusSign')?.value;
+    const plusSign = plusProbe.find((part) => part.type === 'plusSign')?.value;
+    return {
+        positive: positiveParts,
+        negative: negativeParts,
+        groupSeparator,
+        decimalSeparator,
+        grouping,
+        minusSign,
+        plusSign
+    };
+};
+export const getNumberFormatPattern = (locale, options) => {
+    const key = buildNumberFormatKey(locale, options);
+    const cached = numberFormatMetaCache.get(key);
+    if (cached) {
+        return cached;
+    }
+    const nf = getNumberFormat(locale, options);
+    const pattern = analyzePattern(nf);
+    numberFormatMetaCache.set(key, pattern);
+    return pattern;
+};
+export const getDateFormat = (locale, options) => {
+    const key = buildDateFormatKey(locale, options);
+    const cached = dateFormatCache.get(key);
+    if (cached) {
+        return cached;
+    }
+    const df = new Intl.DateTimeFormat(locale, options);
+    dateFormatCache.set(key, df);
+    return df;
+};
+//# sourceMappingURL=intl-cache.js.map

package/dist/esm/internal/intl-cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"intl-cache.js","sourceRoot":"","sources":["../../../src/internal/intl-cache.ts"],"names":[],"mappings":"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"}

package/dist/esm/internal/numeric.js

@@ -0,0 +1,154 @@
+import Big from 'big.js';
+import { DECIMAL_DOT, DECIMAL_EMPTY, DECIMAL_ZERO, DEFAULT_SIGN_MINUS } from '../constants';
+import { FormatError, toRangeError, toTypeError } from '../errors';
+const ROUNDING_MODE_MAP = {
+    roundDown: Big.roundDown,
+    roundHalfUp: Big.roundHalfUp,
+    roundHalfEven: Big.roundHalfEven,
+    roundUp: Big.roundUp
+};
+const assertNonNegativeInteger = (value, label) => {
+    if (value === undefined) {
+        return undefined;
+    }
+    if (!Number.isInteger(value) || value < 0) {
+        throw toRangeError(FormatError.NonNegativeIntegerRequired, { label });
+    }
+    return value;
+};
+const assertPositiveInteger = (value, label) => {
+    if (value === undefined) {
+        return undefined;
+    }
+    if (!Number.isInteger(value) || value <= 0) {
+        throw toRangeError(FormatError.PositiveIntegerRequired, { label });
+    }
+    return value;
+};
+export const normalizeNumeric = (value) => {
+    if (value instanceof Big) {
+        if (!value.c) {
+            return new Big(DECIMAL_ZERO);
+        }
+        return new Big(value.toString());
+    }
+    if (typeof value === 'number') {
+        if (!Number.isFinite(value)) {
+            throw toRangeError(FormatError.NumericValueNonFinite);
+        }
+        return new Big(value);
+    }
+    if (typeof value === 'string') {
+        const trimmed = value.trim();
+        if (!trimmed) {
+            throw toRangeError(FormatError.NumericStringEmpty);
+        }
+        return new Big(trimmed);
+    }
+    throw toTypeError(FormatError.UnsupportedNumericInput);
+};
+const mapRoundingMode = (mode) => {
+    if (!mode) {
+        return Big.roundHalfUp;
+    }
+    return ROUNDING_MODE_MAP[mode];
+};
+export const toFixedNoSci = (value, fractionDigits, roundingMode) => {
+    const rm = mapRoundingMode(roundingMode);
+    let working = value;
+    if (fractionDigits !== undefined) {
+        working = working.round(fractionDigits, rm);
+    }
+    return bigToDecimalString(working);
+};
+export const computeNumericParts = (value, options = {}) => {
+    const minDecimals = assertNonNegativeInteger(options.minDecimals, 'minDecimals') ?? 0;
+    const maxDecimals = assertNonNegativeInteger(options.maxDecimals, 'maxDecimals');
+    const precision = assertPositiveInteger(options.precision, 'precision');
+    const roundingMode = mapRoundingMode(options.roundingMode);
+    if (maxDecimals !== undefined && maxDecimals < minDecimals) {
+        throw toRangeError(FormatError.MaxDecimalsLessThanMinimum);
+    }
+    let bigValue = normalizeNumeric(value);
+    if (precision !== undefined) {
+        const precise = bigValue.toPrecision(precision, roundingMode);
+        bigValue = new Big(precise);
+    }
+    if (maxDecimals !== undefined) {
+        bigValue = bigValue.round(maxDecimals, roundingMode);
+    }
+    const isZero = bigValue.eq(0);
+    const isNegative = !isZero && bigValue.s < 0;
+    const canonical = bigToDecimalString(bigValue.abs());
+    let [integerPart, fractionPart = DECIMAL_EMPTY] = canonical.split(DECIMAL_DOT);
+    integerPart = integerPart.replace(/^(0+)(\d)/, '$2');
+    if (!integerPart) {
+        integerPart = DECIMAL_ZERO;
+    }
+    if (fractionPart.length < minDecimals) {
+        fractionPart = fractionPart.padEnd(minDecimals, DECIMAL_ZERO);
+    }
+    if (maxDecimals !== undefined && fractionPart.length > maxDecimals) {
+        fractionPart = fractionPart.slice(0, maxDecimals);
+    }
+    if (options.trimTrailingZeros) {
+        const minKeep = minDecimals;
+        while (fractionPart.length > minKeep && fractionPart.endsWith(DECIMAL_ZERO)) {
+            fractionPart = fractionPart.slice(0, -1);
+        }
+    }
+    return {
+        big: bigValue,
+        integer: integerPart,
+        fraction: fractionPart,
+        isNegative,
+        isZero
+    };
+};
+export const bigToDecimalString = (value) => {
+    const coefficient = (value.c ?? [0]);
+    const exponent = value.e ?? 0;
+    const sign = value.s < 0 ? DEFAULT_SIGN_MINUS : '';
+    if (coefficient.every((digit) => digit === 0)) {
+        return DECIMAL_ZERO;
+    }
+    const digits = coefficient.join('');
+    const decimalIndex = exponent + 1;
+    if (decimalIndex <= 0) {
+        const zeros = DECIMAL_ZERO.repeat(Math.abs(decimalIndex));
+        return `${sign}${DECIMAL_ZERO}${DECIMAL_DOT}${zeros}${digits}`.replace(/\.$/, '');
+    }
+    if (decimalIndex >= digits.length) {
+        const zeros = DECIMAL_ZERO.repeat(decimalIndex - digits.length);
+        return `${sign}${digits}${zeros}`;
+    }
+    const integerPart = digits.slice(0, decimalIndex);
+    const fractionPart = digits.slice(decimalIndex);
+    return `${sign}${integerPart}${DECIMAL_DOT}${fractionPart}`;
+};
+export const applyGrouping = (integer, grouping, enableGrouping) => {
+    if (!enableGrouping || grouping.primary === 0 || integer.length <= grouping.primary) {
+        return integer;
+    }
+    const groups = [];
+    const primary = grouping.primary;
+    const secondary = grouping.secondary ?? primary;
+    let index = integer.length;
+    let usePrimary = true;
+    while (index > 0) {
+        const size = usePrimary ? primary : secondary;
+        if (size <= 0) {
+            groups.unshift(integer.slice(0, index));
+            break;
+        }
+        const start = Math.max(index - size, 0);
+        groups.unshift(integer.slice(start, index));
+        index = start;
+        if (index <= 0) {
+            break;
+        }
+        usePrimary = false;
+    }
+    return groups.join(grouping.separator);
+};
+//# sourceMappingURL=numeric.js.map

package/dist/esm/internal/numeric.js.map

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

package/dist/esm/types.js

@@ -0,0 +1,14 @@
+export const NUMBER_STYLES = {
+    decimal: 'decimal',
+    currency: 'currency',
+    percent: 'percent'
+};
+export const SIGN_DISPLAYS = {
+    auto: 'auto',
+    always: 'always',
+    exceptZero: 'exceptZero',
+    never: 'never',
+    negative: 'negative'
+};
+export const COMPACT_UNITS = ['K', 'M', 'B', 'T'];
+//# sourceMappingURL=types.js.map

package/dist/esm/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"AAKA,MAAM,CAAC,MAAM,aAAa,GAAM;IAC9B,OAAO,EAAsB,SAAS;IACtC,QAAQ,EAAqB,UAAU;IACvC,OAAO,EAAsB,SAAS;CAC9B,CAAA;AAIV,MAAM,CAAC,MAAM,aAAa,GAAM;IAC9B,IAAI,EAAyB,MAAM;IACnC,MAAM,EAAuB,QAAQ;IACrC,UAAU,EAAmB,YAAY;IACzC,KAAK,EAAwB,OAAO;IACpC,QAAQ,EAAqB,UAAU;CAC/B,CAAA;AAIV,MAAM,CAAC,MAAM,aAAa,GAAM,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,CAAU,CAAA"}

package/dist/types/constants.d.ts

@@ -0,0 +1,19 @@
+import type { CompactUnit, NumberStyle } from './types';
+export declare const STYLE_DECIMAL: NumberStyle;
+export declare const STYLE_CURRENCY: NumberStyle;
+export declare const STYLE_PERCENT: NumberStyle;
+export declare const DISPLAY_SIGNS: {
+    readonly minus: "minus";
+    readonly plus: "plus";
+    readonly none: "none";
+};
+export type DisplaySignValue = typeof DISPLAY_SIGNS[keyof typeof DISPLAY_SIGNS];
+export declare const DISPLAY_SIGN_MINUS: "minus";
+export declare const DISPLAY_SIGN_PLUS: "plus";
+export declare const DISPLAY_SIGN_NONE: "none";
+export declare const COMPACT_ORDER: CompactUnit[];
+export declare const DEFAULT_SIGN_MINUS = "-";
+export declare const DEFAULT_SIGN_PLUS = "+";
+export declare const DECIMAL_ZERO = "0";
+export declare const DECIMAL_EMPTY = "";
+export declare const DECIMAL_DOT = ".";

package/dist/types/csv.d.ts

@@ -0,0 +1,5 @@
+import type { CsvColumnSpec, CsvNumberOptions, NumericLike } from './types';
+export declare const formatCsvNumber: (value: NumericLike, options?: CsvNumberOptions) => string;
+export declare const formatCsvPercent: (value: NumericLike, options?: CsvNumberOptions) => string;
+export declare const csvCurrencyCode: (code: string, customSymbols?: Record<string, string>, useSymbol?: boolean) => string;
+export declare const buildCsv: <T>(rows: T[], columns: CsvColumnSpec<T>[], delimiter?: string, lineEnding?: string) => string;

package/dist/types/date.d.ts

@@ -0,0 +1,2 @@
+export declare const formatDisplayDate: (date: Date | number | string, locale: string, options?: Intl.DateTimeFormatOptions) => string;
+export declare const formatCsvDate: (date: Date | number | string) => string;

package/dist/types/display.d.ts

@@ -0,0 +1,9 @@
+import type { DisplayNumberOptions, NumericLike } from './types';
+export declare const formatDisplayNumber: (value: NumericLike, options: DisplayNumberOptions) => string;
+export declare const formatDisplayCurrency: (value: NumericLike, options: DisplayNumberOptions & {
+    currencyCode: string;
+}) => string;
+export declare const formatDisplayPercent: (value: NumericLike, options: DisplayNumberOptions) => string;
+export declare const formatDisplayCompact: (value: NumericLike, options: DisplayNumberOptions & {
+    compact: true;
+}) => string;

package/dist/types/errors.d.ts

@@ -0,0 +1,21 @@
+export declare enum FormatError {
+    NonNegativeIntegerRequired = "nonNegativeIntegerRequired",
+    PositiveIntegerRequired = "positiveIntegerRequired",
+    NumericValueNonFinite = "numericValueNonFinite",
+    NumericStringEmpty = "numericStringEmpty",
+    UnsupportedNumericInput = "unsupportedNumericInput",
+    MaxDecimalsLessThanMinimum = "maxDecimalsLessThanMinimum",
+    MissingLocale = "missingLocale",
+    MissingCurrencyCode = "missingCurrencyCode",
+    DateValueInvalid = "dateValueInvalid",
+    DateStringEmpty = "dateStringEmpty",
+    DateNumberNonFinite = "dateNumberNonFinite",
+    InvalidDateString = "invalidDateString",
+    UnsupportedDateInput = "unsupportedDateInput"
+}
+type ErrorDetails = Record<string, string>;
+export declare const getFormatErrorMessage: (code: FormatError, details?: ErrorDetails) => string;
+export declare const toRangeError: (code: FormatError, details?: ErrorDetails) => RangeError;
+export declare const toTypeError: (code: FormatError, details?: ErrorDetails) => TypeError;
+export declare const toError: (code: FormatError, details?: ErrorDetails) => Error;
+export {};

package/dist/types/index.d.ts

@@ -0,0 +1,5 @@
+export { formatDisplayNumber, formatDisplayCurrency, formatDisplayPercent, formatDisplayCompact } from './display';
+export { formatCsvNumber, formatCsvPercent, csvCurrencyCode, buildCsv } from './csv';
+export { formatDisplayDate, formatCsvDate } from './date';
+export { FormatError, getFormatErrorMessage, toError, toRangeError, toTypeError } from './errors';
+export type { NumericLike, RoundingMode, NumberStyle, SignDisplay, CommonNumberOptions, DisplayNumberOptions, CsvNumberOptions, CsvColumnSpec, CsvRow, CompactUnit } from './types';

package/dist/types/internal/intl-cache.d.ts

@@ -0,0 +1,17 @@
+interface GroupingMetadata {
+    primary: number;
+    secondary?: number;
+}
+export interface FormatPattern {
+    positive: Intl.NumberFormatPart[];
+    negative: Intl.NumberFormatPart[];
+    groupSeparator: string;
+    decimalSeparator: string;
+    grouping: GroupingMetadata;
+    minusSign?: string;
+    plusSign?: string;
+}
+export declare const getNumberFormat: (locale: string, options: Intl.NumberFormatOptions) => Intl.NumberFormat;
+export declare const getNumberFormatPattern: (locale: string, options: Intl.NumberFormatOptions) => FormatPattern;
+export declare const getDateFormat: (locale: string, options?: Intl.DateTimeFormatOptions) => Intl.DateTimeFormat;
+export {};

package/dist/types/internal/numeric.d.ts

@@ -0,0 +1,19 @@
+import Big from 'big.js';
+import type { CommonNumberOptions, NumericLike, RoundingMode } from '../types';
+export interface NumericParts {
+    big: Big;
+    integer: string;
+    fraction: string;
+    isNegative: boolean;
+    isZero: boolean;
+}
+export interface GroupingConfig {
+    separator: string;
+    primary: number;
+    secondary?: number;
+}
+export declare const normalizeNumeric: (value: NumericLike) => Big;
+export declare const toFixedNoSci: (value: Big, fractionDigits?: number, roundingMode?: RoundingMode) => string;
+export declare const computeNumericParts: (value: NumericLike, options?: CommonNumberOptions) => NumericParts;
+export declare const bigToDecimalString: (value: Big) => string;
+export declare const applyGrouping: (integer: string, grouping: GroupingConfig, enableGrouping: boolean) => string;

package/dist/types/types.d.ts

@@ -0,0 +1,50 @@
+import type Big from 'big.js';
+export type NumericLike = number | string | Big;
+export type RoundingMode = 'roundDown' | 'roundHalfUp' | 'roundHalfEven' | 'roundUp';
+export declare const NUMBER_STYLES: {
+    readonly decimal: "decimal";
+    readonly currency: "currency";
+    readonly percent: "percent";
+};
+export type NumberStyle = typeof NUMBER_STYLES[keyof typeof NUMBER_STYLES];
+export declare const SIGN_DISPLAYS: {
+    readonly auto: "auto";
+    readonly always: "always";
+    readonly exceptZero: "exceptZero";
+    readonly never: "never";
+    readonly negative: "negative";
+};
+export type SignDisplay = typeof SIGN_DISPLAYS[keyof typeof SIGN_DISPLAYS];
+export declare const COMPACT_UNITS: readonly ["K", "M", "B", "T"];
+export type CompactUnit = typeof COMPACT_UNITS[number];
+export interface CommonNumberOptions {
+    minDecimals?: number;
+    maxDecimals?: number;
+    precision?: number;
+    roundingMode?: RoundingMode;
+    trimTrailingZeros?: boolean;
+}
+export interface DisplayNumberOptions extends CommonNumberOptions {
+    locale: string;
+    style?: NumberStyle;
+    currencyCode?: string;
+    useSymbol?: boolean;
+    customSymbols?: Record<string, string>;
+    compact?: boolean;
+    compactThresholds?: Partial<Record<CompactUnit, NumericLike>>;
+    compactSuffixes?: Partial<Record<CompactUnit, string>>;
+    signDisplay?: SignDisplay;
+    useGrouping?: boolean;
+}
+export interface CsvNumberOptions extends CommonNumberOptions {
+}
+export type CsvRow = Record<string, unknown> | unknown[];
+export interface CsvColumnSpec<T = any> {
+    header: string;
+    accessor: (row: T) => unknown;
+    formatter?: (value: unknown) => string;
+}
+export interface FormatDisplayParams {
+    locale: string;
+    options: Intl.NumberFormatOptions;
+}

package/package.json

@@ -0,0 +1,54 @@
+{
+  "name": "@eternl/formats",
+  "version": "0.1.0",
+  "description": "Locale-aware display and CSV formatting helpers for numeric data.",
+  "type": "module",
+  "main": "dist/cjs/index.js",
+  "module": "dist/esm/index.js",
+  "types": "dist/types/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/types/index.d.ts",
+      "import": "./dist/esm/index.js",
+      "require": "./dist/cjs/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "npm run clean && tsc -p tsconfig.build.json && tsc -p tsconfig.cjs.json",
+    "clean": "rimraf dist",
+    "lint": "eslint . --fix",
+    "typecheck": "tsc --noEmit",
+    "build:eslint-plugin": "tsc -p tools/eslint-plugin-padding/tsconfig.json",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:lint-rules": "node --test tools/eslint-plugin-padding/tests/run-tests.js",
+    "publish:prepare": "npm run build && npm run build:eslint-plugin",
+    "publish:npm": "npm run publish:prepare && npm publish --access public"
+  },
+  "keywords": [
+    "number-formatting",
+    "csv",
+    "intl",
+    "browser"
+  ],
+  "author": "",
+  "license": "MIT",
+  "devDependencies": {
+    "@types/big.js": "6.2.2",
+    "@types/node": "22.18.8",
+    "@typescript-eslint/parser": "8.46.0",
+    "@typescript-eslint/utils": "8.46.0",
+    "eslint": "9.37.0",
+    "rimraf": "6.0.1",
+    "tslib": "2.8.1",
+    "tsup": "8.5.0",
+    "typescript": "5.9.3",
+    "vitest": "3.2.4"
+  },
+  "dependencies": {
+    "big.js": "7.0.1"
+  }
+}