oakscriptjs 0.8.1 → 0.9.0

package/dist/esm/str/index.js

@@ -0,0 +1,540 @@
+/**
+ * String namespace
+ * Mirrors PineScript's str.* functions for string manipulation and analysis.
+ *
+ * @remarks
+ * All string functions in this namespace follow PineScript v6 API specifications.
+ * String operations are case-sensitive unless otherwise specified.
+ *
+ * @version 6
+ */
+import { formatNumber } from './numberformat.js';
+import { formatMessage } from './messageformat.js';
+import { formatDate } from './dateformat.js';
+/**
+ * Returns the length of a string.
+ *
+ * @param str - The string to measure
+ * @returns The number of characters in the string
+ *
+ * @example
+ * ```typescript
+ * str.length("Hello") // Returns: 5
+ * str.length("") // Returns: 0
+ * ```
+ */
+export function length(str) {
+    return str.length;
+}
+/**
+ * Converts a value to its string representation (PineScript `str.tostring`).
+ *
+ * @param value - The value to convert (number, boolean, string, etc.)
+ * @param format - Optional number format: a pattern ("#.##", "#,###.00", "0.00%", "0.00E0") or
+ *   `format.percent` ("percent"), `format.volume` ("volume"), `format.price` / `format.inherit`
+ * @returns String representation of the value
+ *
+ * @remarks
+ * As in PineScript:
+ * - without format, numbers show up to 10 decimals ("0.3333333333"); 1e21 and more use "1E21"
+ * - patterns round half away from zero on the shortest decimal form: 1.005 with "#.##" gives "1.01"
+ * - "#" is an optional digit ("1.5" with "#.##"), "0" a required digit ("1.50" with "0.00"),
+ *   "," groups thousands, "%" multiplies by 100, 'text' is literal text
+ * - `format.percent` shows 2 decimals and "%" without multiplying; `format.volume` uses K, M, B, T
+ * - `format.price` and `format.inherit` give "price1" / "inherit1" in PineScript: they are patterns
+ *   without digit characters, and oakscriptjs does the same
+ * - `format.mintick` needs the symbol's tick size and throws here
+ *
+ * @example
+ * ```typescript
+ * str.tostring(123) // "123"
+ * str.tostring(1.5, "#.##") // "1.5"
+ * str.tostring(0.5, "#.00") // ".50"
+ * str.tostring(12345.678, format.volume) // "12.346K"
+ * ```
+ */
+export function tostring(value, format) {
+    if (typeof value !== 'number')
+        return String(value);
+    if (!Number.isFinite(value))
+        return String(value); // NaN (na), Infinity
+    if (format === undefined || format === '') {
+        if (Math.abs(value) >= 1e21 && Number.isFinite(value)) {
+            return String(value).replace('e+', 'E').replace(/\.0+E/, 'E');
+        }
+        return formatNumber(value, '#.##########', 'halfUpShortest');
+    }
+    switch (format) {
+        case 'percent':
+            return formatNumber(value, '0.00', 'halfUpShortest') + '%';
+        case 'volume': {
+            const abs = Math.abs(value);
+            for (const [size, unit] of [[1e12, 'T'], [1e9, 'B'], [1e6, 'M'], [1e3, 'K']]) {
+                if (abs >= size)
+                    return formatNumber(value / size, '#.###', 'halfUpShortest') + unit;
+            }
+            return formatNumber(value, '#', 'halfUpShortest');
+        }
+        case 'mintick':
+            throw new Error('str.tostring(x, format.mintick) needs the symbol tick size (syminfo.mintick), which is not known here');
+        default:
+            return formatNumber(value, format, 'halfUpShortest');
+    }
+}
+/**
+ * Converts a string to a number (float).
+ *
+ * @param str - The string to convert
+ * @returns The numeric value, or null if conversion fails
+ *
+ * @remarks
+ * - Returns null for invalid number strings
+ * - Supports scientific notation (e.g., "1e3")
+ * - Supports decimal numbers (e.g., "0.5", ".5")
+ * - Whitespace is ignored
+ * - "NaN" string returns null
+ *
+ * @example
+ * ```typescript
+ * str.tonumber("123") // Returns: 123
+ * str.tonumber("45.67") // Returns: 45.67
+ * str.tonumber("abc") // Returns: null
+ * str.tonumber("1e3") // Returns: 1000
+ * ```
+ */
+export function tonumber(str) {
+    const num = parseFloat(str);
+    return isNaN(num) ? null : num;
+}
+/**
+ * Extracts a substring from a string.
+ *
+ * @param str - The source string
+ * @param begin - Starting index (0-based, inclusive)
+ * @param end - Ending index (0-based, exclusive). If omitted, extracts to end of string
+ * @returns The extracted substring
+ *
+ * @remarks
+ * - If begin > end, indices are swapped (JavaScript behavior)
+ * - Negative indices are treated as 0
+ * - Indices beyond string length return empty string
+ *
+ * @example
+ * ```typescript
+ * str.substring("hello world", 0, 5) // Returns: "hello"
+ * str.substring("hello world", 6) // Returns: "world"
+ * str.substring("test", 1, 3) // Returns: "es"
+ * ```
+ */
+export function substring(str, begin, end) {
+    return str.substring(begin, end);
+}
+/**
+ * Converts all characters in a string to uppercase.
+ *
+ * @param str - The string to convert
+ * @returns The uppercase string
+ *
+ * @example
+ * ```typescript
+ * str.upper("hello") // Returns: "HELLO"
+ * str.upper("Hello World") // Returns: "HELLO WORLD"
+ * str.upper("test123") // Returns: "TEST123"
+ * ```
+ */
+export function upper(str) {
+    return str.toUpperCase();
+}
+/**
+ * Converts all characters in a string to lowercase.
+ *
+ * @param str - The string to convert
+ * @returns The lowercase string
+ *
+ * @example
+ * ```typescript
+ * str.lower("HELLO") // Returns: "hello"
+ * str.lower("Hello World") // Returns: "hello world"
+ * str.lower("TEST123") // Returns: "test123"
+ * ```
+ */
+export function lower(str) {
+    return str.toLowerCase();
+}
+/**
+ * Checks if a string contains a substring.
+ *
+ * @param source - The string to search in
+ * @param str - The substring to search for
+ * @returns True if source contains str, false otherwise
+ *
+ * @remarks
+ * - Search is case-sensitive
+ * - Empty string is contained in any string
+ *
+ * @example
+ * ```typescript
+ * str.contains("hello world", "world") // Returns: true
+ * str.contains("hello world", "World") // Returns: false (case-sensitive)
+ * str.contains("test", "xyz") // Returns: false
+ * ```
+ */
+export function contains(source, str) {
+    return source.includes(str);
+}
+/**
+ * Returns the position of the first occurrence of a substring.
+ *
+ * @param source - The string to search in
+ * @param str - The substring to search for
+ * @returns The 0-based index of the first occurrence, or -1 if not found
+ *
+ * @remarks
+ * - Search is case-sensitive
+ * - Returns 0 for empty search string
+ * - Returns -1 if substring is not found
+ *
+ * @example
+ * ```typescript
+ * str.pos("hello world", "world") // Returns: 6
+ * str.pos("hello world", "o") // Returns: 4 (first occurrence)
+ * str.pos("hello", "xyz") // Returns: -1
+ * ```
+ */
+export function pos(source, str) {
+    return source.indexOf(str);
+}
+/**
+ * Replaces occurrences of a substring with another string.
+ *
+ * @param source - The source string
+ * @param target - The substring to replace
+ * @param replacement - The string to replace with
+ * @param occurrence - If 0, replaces first occurrence only; otherwise replaces all occurrences (default: all)
+ * @returns The string with replacements made
+ *
+ * @remarks
+ * - Search is case-sensitive
+ * - If target is not found, returns source unchanged
+ * - occurrence parameter: 0 = first only, any other value = all occurrences
+ *
+ * @example
+ * ```typescript
+ * str.replace("hello world hello", "hello", "hi", 0) // Returns: "hi world hello"
+ * str.replace("hello world hello", "hello", "hi") // Returns: "hi world hi"
+ * str.replace("test", "xyz", "abc") // Returns: "test"
+ * ```
+ */
+export function replace(source, target, replacement, occurrence) {
+    if (occurrence === 0) {
+        return source.replace(target, replacement);
+    }
+    else {
+        return source.replaceAll(target, replacement);
+    }
+}
+/**
+ * Replaces all occurrences of a target string with a replacement string.
+ *
+ * @param source - The source string
+ * @param target - The substring to find
+ * @param replacement - The replacement string
+ * @returns String with all occurrences replaced
+ *
+ * @remarks
+ * - Replaces all occurrences of the target string
+ * - Case sensitive
+ * - If target is empty string, returns original string
+ * - This matches PineScript's `str.replace_all()` behavior
+ *
+ * @example
+ * ```typescript
+ * str.replace_all("hello world hello", "hello", "hi") // Returns: "hi world hi"
+ * str.replace_all("a-b-c", "-", "_") // Returns: "a_b_c"
+ * str.replace_all("test", "x", "y") // Returns: "test" (no match)
+ * ```
+ */
+export function replace_all(source, target, replacement) {
+    return source.replaceAll(target, replacement);
+}
+/**
+ * Splits a string into an array of substrings using a separator.
+ *
+ * @param str - The string to split
+ * @param separator - The separator string
+ * @returns Array of substrings
+ *
+ * @remarks
+ * - Empty separator splits into individual characters
+ * - If separator is not found, returns array with original string
+ * - Consecutive separators create empty strings in result
+ *
+ * @example
+ * ```typescript
+ * str.split("a,b,c", ",") // Returns: ["a", "b", "c"]
+ * str.split("hello", "") // Returns: ["h", "e", "l", "l", "o"]
+ * str.split("a,,b", ",") // Returns: ["a", "", "b"]
+ * ```
+ */
+export function split(str, separator) {
+    return str.split(separator);
+}
+/**
+ * Concatenates multiple strings into one.
+ *
+ * @param strings - Variable number of strings to concatenate
+ * @returns The concatenated string
+ *
+ * @example
+ * ```typescript
+ * str.concat("hello", " ", "world") // Returns: "hello world"
+ * str.concat("a", "b", "c") // Returns: "abc"
+ * str.concat("test") // Returns: "test"
+ * ```
+ */
+export function concat(...strings) {
+    return strings.join('');
+}
+/**
+ * Formats a string with placeholders (PineScript `str.format`, Java MessageFormat syntax).
+ *
+ * @param formatStr - Pattern with `{0}`, `{1,number,#.##}`, `{0,number,percent}`, `{0,date,yyyy-MM-dd}`...
+ * @param args - Values for the placeholders
+ * @returns Formatted string
+ *
+ * @remarks
+ * As in PineScript: numbers in `{n}` use
+ * "#,##0.###" (1234.5678 gives "1,234.568"); number patterns round half to even on the exact
+ * value; `'...'` is literal text and `''` a quote; a missing argument leaves `{n}` in the text.
+ * Dates are formatted in UTC here; PineScript uses the exchange time zone.
+ *
+ * @example
+ * ```typescript
+ * str.format('Close: {0,number,#.##}', 101.456) // "Close: 101.46"
+ * str.format('{0} and {1}', 'a', 2) // "a and 2"
+ * ```
+ */
+export function format(formatStr, ...args) {
+    return formatMessage(formatStr, args, 'Etc/UTC');
+}
+/**
+ * Checks if a string starts with a specific prefix.
+ *
+ * @param source - The string to check
+ * @param str - The prefix to look for
+ * @returns True if source starts with str, false otherwise
+ *
+ * @remarks
+ * - Search is case-sensitive
+ * - Empty string prefix always returns true
+ *
+ * @example
+ * ```typescript
+ * str.startswith("hello world", "hello") // Returns: true
+ * str.startswith("hello world", "Hello") // Returns: false (case-sensitive)
+ * str.startswith("test", "testing") // Returns: false
+ * ```
+ */
+export function startswith(source, str) {
+    return source.startsWith(str);
+}
+/**
+ * Checks if a string ends with a specific suffix.
+ *
+ * @param source - The string to check
+ * @param str - The suffix to look for
+ * @returns True if source ends with str, false otherwise
+ *
+ * @remarks
+ * - Search is case-sensitive
+ * - Empty string suffix always returns true
+ *
+ * @example
+ * ```typescript
+ * str.endswith("hello world", "world") // Returns: true
+ * str.endswith("hello world", "World") // Returns: false (case-sensitive)
+ * str.endswith("testing", "test") // Returns: false
+ * ```
+ */
+export function endswith(source, str) {
+    return source.endsWith(str);
+}
+/**
+ * Returns the character at a specific position in a string.
+ *
+ * @param str - The source string
+ * @param pos - The 0-based position
+ * @returns The character at the position, or empty string if out of bounds
+ *
+ * @remarks
+ * - Returns empty string for negative or out-of-bounds positions
+ * - Unicode characters may span multiple code units
+ *
+ * @example
+ * ```typescript
+ * str.charAt("hello", 0) // Returns: "h"
+ * str.charAt("hello", 4) // Returns: "o"
+ * str.charAt("hello", 10) // Returns: ""
+ * ```
+ */
+export function charAt(str, pos) {
+    return str.charAt(pos);
+}
+/**
+ * Removes whitespace from both ends of a string.
+ *
+ * @param str - The string to trim
+ * @returns The trimmed string
+ *
+ * @remarks
+ * - Removes spaces, tabs, newlines, and other whitespace characters
+ * - Preserves internal whitespace
+ *
+ * @example
+ * ```typescript
+ * str.trim("  hello  ") // Returns: "hello"
+ * str.trim("  hello world  ") // Returns: "hello world"
+ * str.trim("\thello\n") // Returns: "hello"
+ * ```
+ */
+export function trim(str) {
+    return str.trim();
+}
+/**
+ * Removes whitespace from the left (start) of a string.
+ *
+ * @param str - The string to trim
+ * @returns The trimmed string
+ *
+ * @remarks
+ * - Only removes leading whitespace
+ * - Preserves trailing and internal whitespace
+ *
+ * @example
+ * ```typescript
+ * str.trimLeft("  hello  ") // Returns: "hello  "
+ * str.trimLeft("  hello") // Returns: "hello"
+ * str.trimLeft("\thello") // Returns: "hello"
+ * ```
+ */
+export function trimLeft(str) {
+    return str.trimStart();
+}
+/**
+ * Removes whitespace from the right (end) of a string.
+ *
+ * @param str - The string to trim
+ * @returns The trimmed string
+ *
+ * @remarks
+ * - Only removes trailing whitespace
+ * - Preserves leading and internal whitespace
+ *
+ * @example
+ * ```typescript
+ * str.trimRight("  hello  ") // Returns: "  hello"
+ * str.trimRight("hello  ") // Returns: "hello"
+ * str.trimRight("hello\t") // Returns: "hello"
+ * ```
+ */
+export function trimRight(str) {
+    return str.trimEnd();
+}
+/**
+ * Tests if a string matches a regular expression pattern.
+ *
+ * @param source - The string to test
+ * @param regex - The regular expression pattern
+ * @returns True if the pattern matches, false otherwise
+ *
+ * @remarks
+ * - Uses JavaScript regex syntax
+ * - Match is case-sensitive by default
+ * - Pattern is tested against entire string
+ *
+ * @example
+ * ```typescript
+ * str.match("hello123", "\\d+") // Returns: true
+ * str.match("test@example.com", "^[a-z]+@[a-z]+\\.[a-z]+$") // Returns: true
+ * str.match("abc", "[A-Z]+") // Returns: false
+ * ```
+ */
+export function match(source, regex) {
+    return new RegExp(regex).test(source);
+}
+/**
+ * Formats a timestamp as a string according to the specified format.
+ *
+ * @param time - Unix timestamp in milliseconds
+ * @param format - Format string using PineScript format specifiers
+ * @returns Formatted date/time string
+ *
+ * @remarks
+ * Supported format specifiers (case-sensitive):
+ * - `yyyy` - 4-digit year (e.g., "2024")
+ * - `yy` - 2-digit year (e.g., "24")
+ * - `MMMM` - Full month name (e.g., "January")
+ * - `MMM` - Abbreviated month name (e.g., "Jan")
+ * - `MM` - 2-digit month (01-12)
+ * - `M` - Month (1-12)
+ * - `dd` - 2-digit day (01-31)
+ * - `d` - Day (1-31)
+ * - `HH` - 2-digit hour (00-23)
+ * - `H` - Hour (0-23)
+ * - `hh` - 2-digit hour (01-12)
+ * - `h` - Hour (1-12)
+ * - `mm` - 2-digit minute (00-59)
+ * - `m` - Minute (0-59)
+ * - `ss` - 2-digit second (00-59)
+ * - `s` - Second (0-59)
+ * - `a` - AM/PM
+ *
+ * @example
+ * ```typescript
+ * const timestamp = 1609459200000; // Jan 1, 2021 00:00:00 UTC
+ * str.format_time(timestamp, "dd MMM yyyy") // Returns: "01 Jan 2021"
+ * str.format_time(timestamp, "yyyy-MM-dd HH:mm:ss") // Returns: "2021-01-01 00:00:00"
+ * str.format_time(timestamp, "MMM d, yyyy") // Returns: "Jan 1, 2021"
+ * str.format_time(timestamp, "hh:mm a") // Returns: "12:00 AM"
+ * ```
+ */
+/**
+ * Constructs a new string containing the source string repeated N times with an optional separator.
+ *
+ * @param source - The string to repeat
+ * @param count - Number of times to repeat (must be >= 0)
+ * @param separator - String to inject between repeated instances. Optional, defaults to empty string.
+ * @returns The repeated string, or null if source is null/undefined
+ *
+ * @example
+ * ```typescript
+ * str.repeat("ab", 3) // Returns: "ababab"
+ * str.repeat("?", 3, ",") // Returns: "?,?,?"
+ * str.repeat("hello", 0) // Returns: ""
+ * str.repeat("x", 1) // Returns: "x"
+ * ```
+ */
+export function repeat(source, count, separator = '') {
+    if (source == null)
+        return null;
+    if (count <= 0)
+        return '';
+    return Array(count).fill(source).join(separator);
+}
+/**
+ * Formats a UNIX time (ms) with a date pattern (PineScript `str.format_time`).
+ *
+ * @param time - UNIX time in milliseconds
+ * @param format - Java SimpleDateFormat pattern, e.g. "yyyy-MM-dd HH:mm:ss", "dd MMM yyyy", "hh:mm a"
+ * @param timezone - UTC/GMT offset ("UTC-5") or IANA name ("America/New_York"). PineScript's default is
+ *   the exchange time zone, which is not known here: the default is UTC
+ * @returns Formatted date string
+ *
+ * @remarks
+ * Letters: y, M, d, E, u, D, w,
+ * H, k, K, h, a, m, s, S, Z, z; 'text' is literal text.
+ */
+export function format_time(time, format = "yyyy-MM-dd'T'HH:mm:ssZ", timezone = 'Etc/UTC') {
+    return formatDate(time, format, timezone);
+}
+//# sourceMappingURL=index.js.map

package/dist/esm/str/index.js.map

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

package/dist/esm/str/messageformat.d.ts

@@ -0,0 +1,14 @@
+/**
+ * `str.format` patterns as PineScript formats them (Java MessageFormat):
+ *
+ * - `{n}` inserts argument n; numbers use "#,##0.###" (1234.5678 gives "1,234.568")
+ * - `{n,number}`, `{n,number,integer}` ("#,##0"), `{n,number,percent}` ("#,##0%"),
+ *   `{n,number,currency}` ("$1,234.57", "-$7.00"), `{n,number,<pattern>}`
+ * - `{n,date}`, `{n,time}`, `{n,date,<pattern>}`, `{n,time,<pattern>}` (styles short, medium, long, full)
+ * - `{n,choice,0#zero|1#one|1<many}`
+ * - numbers round half to even on the exact binary value (0.5 as integer gives "0")
+ * - `'...'` is literal text and `''` is a quote; a missing argument leaves `{n}` in the text
+ */
+/** Formats `pattern` with `args` like PineScript `str.format`; dates use `timezone` (read only when a date is formatted). */
+export declare function formatMessage(pattern: string, args: unknown[], timezone: string | (() => string)): string;
+//# sourceMappingURL=messageformat.d.ts.map

package/dist/esm/str/messageformat.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"messageformat.d.ts","sourceRoot":"","sources":["../../../src/str/messageformat.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AA2DH,6HAA6H;AAC7H,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,QAAQ,EAAE,MAAM,GAAG,CAAC,MAAM,MAAM,CAAC,GAAG,MAAM,CAsCzG"}

package/dist/esm/str/messageformat.js

@@ -0,0 +1,111 @@
+/**
+ * `str.format` patterns as PineScript formats them (Java MessageFormat):
+ *
+ * - `{n}` inserts argument n; numbers use "#,##0.###" (1234.5678 gives "1,234.568")
+ * - `{n,number}`, `{n,number,integer}` ("#,##0"), `{n,number,percent}` ("#,##0%"),
+ *   `{n,number,currency}` ("$1,234.57", "-$7.00"), `{n,number,<pattern>}`
+ * - `{n,date}`, `{n,time}`, `{n,date,<pattern>}`, `{n,time,<pattern>}` (styles short, medium, long, full)
+ * - `{n,choice,0#zero|1#one|1<many}`
+ * - numbers round half to even on the exact binary value (0.5 as integer gives "0")
+ * - `'...'` is literal text and `''` is a quote; a missing argument leaves `{n}` in the text
+ */
+import { formatNumber } from './numberformat.js';
+import { formatDate } from './dateformat.js';
+const DATE_STYLES = {
+    short: 'M/d/yy', medium: 'MMM d, yyyy', long: 'MMMM d, yyyy', full: 'EEEE, MMMM d, yyyy',
+};
+// PineScript writes a narrow no-break space (U+202F) before AM/PM in the time styles
+const TIME_STYLES = {
+    short: 'h:mm a', medium: 'h:mm:ss a', long: 'h:mm:ss a z', full: 'h:mm:ss a z',
+};
+function number(value, pattern) {
+    return typeof value === 'number' ? formatNumber(value, pattern, 'halfEvenExact') : String(value);
+}
+function choice(value, spec) {
+    const options = spec.split('|').map((part) => {
+        const m = /^\s*(-?[\d.]+|-?∞)\s*([#<≤])(.*)$/.exec(part);
+        if (!m)
+            throw new SyntaxError(`Invalid choice format "${spec}"`);
+        const limit = m[1].includes('∞') ? (m[1].startsWith('-') ? -Infinity : Infinity) : Number(m[1]);
+        return { limit: m[2] === '<' ? limit + Number.EPSILON * Math.max(1, Math.abs(limit)) : limit, text: m[3] };
+    });
+    let chosen = options[0];
+    for (const o of options)
+        if (value >= o.limit)
+            chosen = o;
+    return chosen.text;
+}
+function formatArgument(value, type, style, timezone) {
+    if (value === undefined)
+        return '';
+    if (!type)
+        return typeof value === 'number' ? number(value, '#,##0.###') : String(value);
+    switch (type.trim()) {
+        case 'number': {
+            const s = style?.trim();
+            if (!s)
+                return number(value, '#,##0.###');
+            if (s === 'integer')
+                return number(value, '#,##0');
+            if (s === 'percent')
+                return number(value, '#,##0%');
+            if (s === 'currency')
+                return number(value, "'$'#,##0.00");
+            return number(value, style);
+        }
+        case 'date':
+        case 'time': {
+            const styles = type.trim() === 'date' ? DATE_STYLES : TIME_STYLES;
+            const s = style?.trim() ?? 'medium';
+            return formatDate(Number(value), styles[s] ?? style, typeof timezone === 'function' ? timezone() : timezone);
+        }
+        case 'choice':
+            return choice(Number(value), style ?? '');
+        default:
+            throw new SyntaxError(`Unknown format type "${type}"`);
+    }
+}
+/** Formats `pattern` with `args` like PineScript `str.format`; dates use `timezone` (read only when a date is formatted). */
+export function formatMessage(pattern, args, timezone) {
+    let out = '';
+    for (let i = 0; i < pattern.length;) {
+        const ch = pattern[i];
+        if (ch === "'") {
+            if (pattern[i + 1] === "'") {
+                out += "'";
+                i += 2;
+                continue;
+            }
+            const end = pattern.indexOf("'", i + 1);
+            out += pattern.slice(i + 1, end === -1 ? undefined : end);
+            i = end === -1 ? pattern.length : end + 1;
+            continue;
+        }
+        if (ch !== '{') {
+            out += ch;
+            i++;
+            continue;
+        }
+        // {index[,type[,style]]}; the style may contain quoted text and nested braces
+        let depth = 1;
+        let j = i + 1;
+        let inQuote = false;
+        for (; j < pattern.length && depth > 0; j++) {
+            const c = pattern[j];
+            if (c === "'")
+                inQuote = !inQuote;
+            else if (!inQuote && c === '{')
+                depth++;
+            else if (!inQuote && c === '}')
+                depth--;
+        }
+        const inner = pattern.slice(i + 1, j - 1);
+        const [index = '', type, ...rest] = inner.split(',');
+        const style = rest.length ? rest.join(',') : undefined;
+        const n = Number(index.trim());
+        out += n < args.length ? formatArgument(args[n], type, style, timezone) : `{${inner}}`;
+        i = j;
+    }
+    return out;
+}
+//# sourceMappingURL=messageformat.js.map

package/dist/esm/str/messageformat.js.map

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