@pbkware/dot-net-date-number-formatting 0.2.0

package/dist/code/datetime-style.js

@@ -0,0 +1,101 @@
+import { CommaText, Err, Ok } from "@pbkware/js-utils";
+/**
+ * Individual style flags that control date/time parsing behavior.
+ *
+ * These flags can be combined to create custom parsing rules.
+ *
+ * @example
+ * ```typescript
+ * // Combine individual flags
+ * formatter.styles = new Set([
+ *   DotNetDateTimeStyleId.AllowLeadingWhite,
+ *   DotNetDateTimeStyleId.AllowTrailingWhite
+ * ]);
+ * ```
+ *
+ * @public
+ * @category DateTime Styles
+ */
+export var DotNetDateTimeStyleId;
+(function (DotNetDateTimeStyleId) {
+    /** Allow leading whitespace characters. */
+    DotNetDateTimeStyleId["AllowLeadingWhite"] = "AllowLeadingWhite";
+    /** Allow trailing whitespace characters. */
+    DotNetDateTimeStyleId["AllowTrailingWhite"] = "AllowTrailingWhite";
+    /** Allow whitespace within the date/time string. */
+    DotNetDateTimeStyleId["AllowInnerWhite"] = "AllowInnerWhite";
+    /** Do not use current date for missing date components. */
+    DotNetDateTimeStyleId["NoCurrentDateDefault"] = "NoCurrentDateDefault";
+    /** Adjust date/time to UTC (not implemented). */
+    DotNetDateTimeStyleId["AdjustToUniversal"] = "AdjustToUniversal";
+    /** Assume local time zone if not specified (not implemented). */
+    DotNetDateTimeStyleId["AssumeLocal"] = "AssumeLocal";
+    /** Assume UTC time zone if not specified (not implemented). */
+    DotNetDateTimeStyleId["AssumeUniversal"] = "AssumeUniversal";
+    /** Preserve DateTimeKind when parsing (not implemented). */
+    DotNetDateTimeStyleId["RoundTripKind"] = "RoundTripKind";
+})(DotNetDateTimeStyleId || (DotNetDateTimeStyleId = {}));
+/**
+ * Predefined date/time style combinations for common parsing scenarios.
+ *
+ * @internal
+ * @category DateTime Styles
+ */
+export const DotNetDateTimeStyles = {
+    /** No styles - strict parsing. */
+    none: new Set(),
+    /**
+     * Allow whitespace in date/time strings.
+     * Includes: AllowLeadingWhite, AllowTrailingWhite, AllowInnerWhite.
+     */
+    allowWhiteSpaces: new Set([
+        DotNetDateTimeStyleId.AllowLeadingWhite,
+        DotNetDateTimeStyleId.AllowTrailingWhite,
+        DotNetDateTimeStyleId.AllowInnerWhite,
+    ]),
+};
+const isSameSet = (left, right) => {
+    if (left.size !== right.size)
+        return false;
+    for (const value of left) {
+        if (!right.has(value))
+            return false;
+    }
+    return true;
+};
+/** @internal */
+export class DotNetDateTimeStylesInfo {
+    static toString(styles) {
+        return this.toXmlValue(styles);
+    }
+    static toXmlValue(styles) {
+        if (isSameSet(styles, DotNetDateTimeStyles.allowWhiteSpaces)) {
+            return "AllowWhiteSpaces";
+        }
+        return CommaText.fromStringArray(Array.from(styles.values()));
+    }
+    static tryFromString(value) {
+        return this.tryFromXmlValue(value);
+    }
+    static tryFromXmlValue(value) {
+        const normalized = value.trim();
+        if (normalized.length === 0 || normalized.toLowerCase() === "none") {
+            return new Ok(new Set(DotNetDateTimeStyles.none));
+        }
+        if (normalized.toLowerCase() === "allowwhitespaces") {
+            return new Ok(new Set(DotNetDateTimeStyles.allowWhiteSpaces));
+        }
+        const commaTextResult = CommaText.tryToStringArray(normalized);
+        if (commaTextResult.isErr())
+            return commaTextResult.createOuter("Invalid comma-separated styles string");
+        const styles = new Set();
+        for (const item of commaTextResult.value) {
+            const match = Object.values(DotNetDateTimeStyleId).find((x) => x.toLowerCase() === item.toLowerCase());
+            if (match === undefined)
+                return new Err(`Invalid style: ${item}`);
+            styles.add(match);
+        }
+        return new Ok(styles);
+    }
+}
+//# sourceMappingURL=datetime-style.js.map

package/dist/code/datetime-style.js.map

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

package/dist/code/index.js

@@ -0,0 +1,6 @@
+export * from "./datetime-formatter.js";
+export * from "./datetime-style.js";
+export * from "./locale-settings.js";
+export * from "./number-formatter.js";
+export * from "./number-style.js";
+//# sourceMappingURL=index.js.map

package/dist/code/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/code/index.ts"],"names":[],"mappings":"AAAA,cAAc,yBAAyB,CAAC;AACxC,cAAc,qBAAqB,CAAC;AACpC,cAAc,sBAAsB,CAAC;AACrC,cAAc,uBAAuB,CAAC;AACtC,cAAc,mBAAmB,CAAC"}

package/dist/code/locale-settings.js

@@ -0,0 +1,404 @@
+import { Err, Ok } from "@pbkware/js-utils";
+const INVARIANT_LOCALE = "en-US";
+function parseDate(value) {
+    const date = new Date(value);
+    if (Number.isNaN(date.getTime())) {
+        return undefined;
+    }
+    return date;
+}
+function getSeparators(locale) {
+    const numberParts = new Intl.NumberFormat(locale, {
+        style: "decimal",
+        useGrouping: true,
+    }).formatToParts(12345.6);
+    const currencyParts = new Intl.NumberFormat(locale, {
+        style: "currency",
+        currency: "USD",
+    }).formatToParts(1);
+    const dateParts = new Intl.DateTimeFormat(locale, {
+        year: "numeric",
+        month: "2-digit",
+        day: "2-digit",
+    }).formatToParts(new Date(2024, 6, 5));
+    const timeParts = new Intl.DateTimeFormat(locale, {
+        hour: "2-digit",
+        minute: "2-digit",
+        second: "2-digit",
+        hour12: false,
+    }).formatToParts(new Date(2024, 6, 5, 13, 24, 35));
+    const decimalSeparator = numberParts.find((x) => x.type === "decimal")?.value ?? ".";
+    const thousandSeparator = numberParts.find((x) => x.type === "group")?.value ?? ",";
+    const currencySymbol = currencyParts.find((x) => x.type === "currency")?.value ?? "$";
+    const dateSeparator = dateParts.find((x) => x.type === "literal")?.value ?? "/";
+    const timeSeparator = timeParts.find((x) => x.type === "literal")?.value ?? ":";
+    return {
+        decimalSeparator,
+        thousandSeparator,
+        currencySymbol,
+        dateSeparator,
+        timeSeparator,
+    };
+}
+/**
+ * Represents locale-specific formatting settings for dates, times, and numbers.
+ *
+ * Provides culture-specific separators and formatting options that determine how
+ * numbers, currencies, dates, and times are formatted and parsed.
+ *
+ * @example
+ * ```typescript
+ * // Use invariant culture (en-US)
+ * const invariant = DotNetLocaleSettings.createInvariant();
+ *
+ * // Use specific locale
+ * const french = DotNetLocaleSettings.create('fr-FR');
+ * console.log(french.decimalSeparator);  // ","
+ * console.log(french.thousandSeparator);  // " "
+ *
+ * // Use current system locale
+ * const current = DotNetLocaleSettings.current;
+ * ```
+ *
+ * @public
+ * @category Locale Settings
+ */
+export class DotNetLocaleSettings {
+    /**
+     * Singleton instance for invariant culture (en-US).
+     * Provides consistent formatting across all systems.
+     */
+    static invariant = DotNetLocaleSettings.createInvariant();
+    /**
+     * Singleton instance for current system locale.
+     * Uses the locale settings from the runtime environment.
+     */
+    static current = new DotNetLocaleSettings(undefined);
+    /** The locale identifier (same as name). */
+    id;
+    /** The locale name (e.g., "en-US", "fr-FR"). */
+    name;
+    /** Character used for decimal point (e.g., "." or ","). */
+    decimalSeparator;
+    /** Character used for thousands grouping (e.g., "," or "." or " "). */
+    thousandSeparator;
+    /** Currency symbol for this locale (e.g., "$", "€", "£"). */
+    currencyString;
+    /** Character used between date components (e.g., "/", "-", "."). */
+    dateSeparator;
+    /** Character used between time components (typically ":"). */
+    timeSeparator;
+    /** Pre-configured number formatter for floating-point values. */
+    defaultFloat;
+    /** Pre-configured number formatter for high-precision decimal values. */
+    defaultDecimal;
+    /** Pre-configured number formatter for currency values. */
+    defaultCurrency;
+    /**
+     * Creates a new DotNetLocaleSettings instance.
+     *
+     * @param localeName - Optional locale name (e.g., "en-US", "fr-FR").
+     *                     If undefined, uses the system's current locale.
+     *
+     * @example
+     * ```typescript
+     * // System locale
+     * const settings = new DotNetLocaleSettings(undefined);
+     *
+     * // Specific locale
+     * const french = new DotNetLocaleSettings('fr-FR');
+     * ```
+     */
+    constructor(localeName) {
+        this.name = localeName ?? Intl.DateTimeFormat().resolvedOptions().locale;
+        this.id = this.name;
+        const separators = getSeparators(this.name || INVARIANT_LOCALE);
+        this.decimalSeparator = separators.decimalSeparator;
+        this.thousandSeparator = separators.thousandSeparator;
+        this.currencyString = separators.currencySymbol;
+        this.dateSeparator = separators.dateSeparator;
+        this.timeSeparator = separators.timeSeparator;
+        this.defaultFloat = new Intl.NumberFormat(this.name, {
+            useGrouping: false,
+            maximumFractionDigits: 20,
+        });
+        this.defaultCurrency = new Intl.NumberFormat(this.name, {
+            style: "currency",
+            currency: "USD",
+        });
+        this.defaultDecimal = new Intl.NumberFormat(this.name, {
+            useGrouping: false,
+            minimumFractionDigits: 18,
+            maximumFractionDigits: 18,
+        });
+    }
+    /**
+     * Creates a DotNetLocaleSettings instance for the specified locale.
+     *
+     * @param localeName - The locale name (e.g., "en-US", "fr-FR", "de-DE").
+     * @returns A new DotNetLocaleSettings instance configured for the specified locale.
+     *
+     * @example
+     * ```typescript
+     * const usSettings = DotNetLocaleSettings.create('en-US');
+     * const frSettings = DotNetLocaleSettings.create('fr-FR');
+     * ```
+     */
+    static create(localeName) {
+        return new DotNetLocaleSettings(localeName);
+    }
+    /**
+     * Creates a DotNetLocaleSettings instance for the invariant culture (en-US).
+     * The invariant culture provides consistent formatting across all systems.
+     *
+     * @returns A new DotNetLocaleSettings instance configured for invariant culture.
+     *
+     * @example
+     * ```typescript
+     * const settings = DotNetLocaleSettings.createInvariant();
+     * console.log(settings.decimalSeparator);  // "."
+     * console.log(settings.thousandSeparator);  // ","
+     * ```
+     */
+    static createInvariant() {
+        return new DotNetLocaleSettings(INVARIANT_LOCALE);
+    }
+    /**
+     * Converts a number or bigint to a string using locale-specific formatting.
+     *
+     * @param value - The number or bigint to format.
+     * @param options - Optional Intl.NumberFormatOptions for custom formatting.
+     * @returns The formatted number string.
+     *
+     * @example
+     * ```typescript
+     * const settings = DotNetLocaleSettings.create('en-US');
+     * settings.numberToStr(1234.56);  // "1,234.56"
+     * settings.numberToStr(1234.56, { minimumFractionDigits: 2 });  // "1,234.56"
+     * ```
+     */
+    numberToStr(value, options) {
+        return new Intl.NumberFormat(this.name, options).format(value);
+    }
+    /**
+     * Converts a Date to a string using locale-specific formatting.
+     *
+     * @param value - The Date to format.
+     * @param options - Optional Intl.DateTimeFormatOptions for custom formatting.
+     * @returns The formatted date string.
+     *
+     * @example
+     * ```typescript
+     * const settings = DotNetLocaleSettings.create('en-US');
+     * settings.dateToStr(new Date(2024, 6, 5), { dateStyle: 'short' });  // "7/5/2024"
+     * ```
+     */
+    dateToStr(value, options) {
+        return new Intl.DateTimeFormat(this.name, options).format(value);
+    }
+    /**
+     * Converts a boolean to a string.
+     *
+     * @param value - The boolean value.
+     * @returns "true" or "false".
+     *
+     * @example
+     * ```typescript
+     * settings.boolToStr(true);   // "true"
+     * settings.boolToStr(false);  // "false"
+     * ```
+     */
+    boolToStr(value) {
+        return value ? "true" : "false";
+    }
+    /**
+     * Attempts to parse a boolean value from a string.
+     *
+     * @param value - The string to parse. Accepts: "true", "1", "yes" (case-insensitive) for true,
+     *                and "false", "0", "no" for false.
+     * @returns A Result containing the boolean value if successful, or an error if parsing fails.
+     *
+     * @example
+     * ```typescript
+     * settings.tryStrToBool('yes');    // Ok(true)
+     * settings.tryStrToBool('false');  // Ok(false)
+     * settings.tryStrToBool('invalid');  // Err("Invalid boolean string")
+     * ```
+     */
+    tryStrToBool(value) {
+        const normalized = value.trim().toLowerCase();
+        if (["true", "1", "yes"].includes(normalized)) {
+            return new Ok(true);
+        }
+        if (["false", "0", "no"].includes(normalized)) {
+            return new Ok(false);
+        }
+        return new Err("Invalid boolean string");
+    }
+    /**
+     * Attempts to parse an integer from a string.
+     *
+     * @param value - The string to parse. Must contain only digits and an optional leading +/- sign.
+     * @returns A Result containing the parsed integer if successful, or an error if parsing fails.
+     *
+     * @example
+     * ```typescript
+     * settings.tryStrToInt('123');    // Ok(123)
+     * settings.tryStrToInt('-456');   // Ok(-456)
+     * settings.tryStrToInt('12.34');  // Err("Invalid integer string")
+     * ```
+     */
+    tryStrToInt(value) {
+        if (!/^[+-]?\d+$/.test(value.trim())) {
+            return new Err("Invalid integer string");
+        }
+        const parsed = Number.parseInt(value, 10);
+        return Number.isNaN(parsed)
+            ? new Err("Invalid integer string")
+            : new Ok(parsed);
+    }
+    /**
+     * Attempts to parse a BigInt from a string.
+     *
+     * @param value - The string to parse. Must contain only digits and an optional leading +/- sign.
+     * @returns A Result containing the parsed BigInt if successful, or an error if parsing fails.
+     *
+     * @example
+     * ```typescript
+     * settings.tryStrToBigInt('12345678901234567890');  // Ok(12345678901234567890n)
+     * settings.tryStrToBigInt('-999');  // Ok(-999n)
+     * ```
+     */
+    tryStrToBigInt(value) {
+        if (!/^[+-]?\d+$/.test(value.trim())) {
+            return new Err("Invalid integer string");
+        }
+        try {
+            return new Ok(BigInt(value.trim()));
+        }
+        catch {
+            return new Err("Invalid integer string");
+        }
+    }
+    /**
+     * Attempts to parse a number from a string using locale-specific formatting.
+     * Handles currency symbols, thousands separators, and locale-specific decimal separators.
+     *
+     * @param value - The string to parse.
+     * @returns A Result containing the parsed number if successful, or an error if parsing fails.
+     *
+     * @example
+     * ```typescript
+     * const usSettings = DotNetLocaleSettings.create('en-US');
+     * usSettings.tryStrToNumber('1,234.56');  // Ok(1234.56)
+     * usSettings.tryStrToNumber('$1,234.56');  // Ok(1234.56)
+     *
+     * const frSettings = DotNetLocaleSettings.create('fr-FR');
+     * frSettings.tryStrToNumber('1 234,56');  // Ok(1234.56)
+     * ```
+     */
+    tryStrToNumber(value) {
+        const normalized = value
+            .trim()
+            .replaceAll(this.currencyString, "")
+            .replaceAll(this.thousandSeparator, "")
+            .replace(this.decimalSeparator, ".");
+        const parsed = Number.parseFloat(normalized);
+        return Number.isNaN(parsed)
+            ? new Err("Invalid float string")
+            : new Ok(parsed);
+    }
+    /**
+     * Attempts to parse a Date from a string.
+     *
+     * @param value - The string to parse. Accepts various date formats understood by JavaScript Date constructor.
+     * @returns A Result containing the parsed Date if successful, or an error if parsing fails.
+     *
+     * @example
+     * ```typescript
+     * settings.tryStrToDate('2024-07-05');  // Ok(Date)
+     * settings.tryStrToDate('July 5, 2024');  // Ok(Date)
+     * settings.tryStrToDate('invalid');  // Err("Invalid date string")
+     * ```
+     */
+    tryStrToDate(value) {
+        const parsed = parseDate(value.trim());
+        return parsed === undefined
+            ? new Err("Invalid date string")
+            : new Ok(parsed);
+    }
+    /**
+     * Convert a single character to uppercase using culture-specific rules.
+     * Handles special cases like Turkish 'i' → 'İ' vs standard 'i' → 'I'.
+     *
+     * @param char - The character to convert to uppercase.
+     * @returns The uppercased character.
+     *
+     * @example
+     * ```typescript
+     * const usSettings = DotNetLocaleSettings.create('en-US');
+     * usSettings.toUpperChar('i');  // "I"
+     *
+     * const trSettings = DotNetLocaleSettings.create('tr-TR');
+     * trSettings.toUpperChar('i');  // "İ" (Turkish dotted I)
+     * ```
+     */
+    toUpperChar(char) {
+        if (char.length === 0) {
+            return char;
+        }
+        // For single character conversion, use Intl.Collator with locale-specific rules
+        // Most locales follow standard Unicode case mapping
+        const single = char[0];
+        // Turkish locale has special rules for 'i' and 'ı'
+        if (this.name.startsWith("tr")) {
+            // Turkish lowercase: i (U+0069) -> Turkish uppercase: İ (U+0130)
+            // Turkish lowercase: ı (U+0131) -> Turkish uppercase: I (U+0049)
+            if (single === "i") {
+                return "İ";
+            }
+            if (single === "ı") {
+                return "I";
+            }
+        }
+        // For other locales, use standard toUpperCase
+        return single.toUpperCase();
+    }
+    /**
+     * Convert a single character to lowercase using culture-specific rules.
+     * Handles special cases like Turkish 'I' → 'ı' vs Turkish 'İ' → 'i'.
+     *
+     * @param char - The character to convert to lowercase.
+     * @returns The lowercased character.
+     *
+     * @example
+     * ```typescript
+     * const usSettings = DotNetLocaleSettings.create('en-US');
+     * usSettings.toLowerChar('I');  // "i"
+     *
+     * const trSettings = DotNetLocaleSettings.create('tr-TR');
+     * trSettings.toLowerChar('I');  // "ı" (Turkish dotless i)
+     * trSettings.toLowerChar('İ');  // "i" (Turkish dotted i)
+     * ```
+     */
+    toLowerChar(char) {
+        if (char.length === 0) {
+            return char;
+        }
+        const single = char[0];
+        // Turkish locale has special rules for 'I' and 'İ'
+        if (this.name.startsWith("tr")) {
+            // Turkish uppercase: I (U+0049) -> Turkish lowercase: ı (U+0131)
+            // Turkish uppercase: İ (U+0130) -> Turkish lowercase: i (U+0069)
+            if (single === "I") {
+                return "ı";
+            }
+            if (single === "İ") {
+                return "i";
+            }
+        }
+        // For other locales, use standard toLowerCase
+        return single.toLowerCase();
+    }
+}
+//# sourceMappingURL=locale-settings.js.map

package/dist/code/locale-settings.js.map

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