@sqlrooms/utils 0.27.0-rc.0 → 0.27.0-rc.2

package/dist/decimal.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Determine if a decimal value is negative by checking the sign bit.
+ * Follows the two's complement representation used in Arrow decimals.
+ * @param value The Uint32Array representing the decimal value
+ * @returns true if the value is negative, false otherwise
+ * @ignore
+ */
+export declare function isNegativeDecimal(value: Uint32Array): boolean;
+/**
+ * Negate a decimal value in-place using two's complement arithmetic.
+ * @param value The Uint32Array to negate
+ * @returns The negated value (modified in-place for efficiency)
+ * @ignore
+ */
+export declare function negateDecimal(value: Uint32Array): Uint32Array;
+/**
+ * Convert a decimal value to a formatted string representation.
+ * Handles both Decimal128 (128-bit) and Decimal256 (256-bit) values.
+ *
+ * @param value The Uint32Array representing the decimal value
+ * @param scale The number of decimal places (digits after the decimal point)
+ * @returns A string representation of the decimal value
+ *
+ * @example
+ * ```ts
+ * import { toDecimalString } from 'apache-arrow';
+ *
+ * const value = new Uint32Array([1, 0, 0, 0]);
+ * const result = toDecimalString(value, 2);
+ * // Returns: "0.01"
+ * ```
+ * @ignore
+ */
+export declare function toDecimalString(value: Uint32Array, scale: number): string;
+/**
+ * Convert a decimal value to a number.
+ * Note: This may lose precision for very large decimal values
+ * that exceed JavaScript's 53-bit integer precision.
+ *
+ * @param value The Uint32Array representing the decimal value
+ * @param scale The number of decimal places
+ * @returns A number representation of the decimal value
+ * @ignore
+ */
+export declare function toDecimalNumber(value: Uint32Array, scale: number): number;
+/**
+ * Create a Decimal128 value from a string representation.
+ * @param str String representation (e.g., "123.45")
+ * @param scale The scale (number of decimal places) to use
+ * @returns Uint32Array representing the decimal value
+ *
+ * @example
+ * ```ts
+ * import { fromDecimalString } from 'apache-arrow';
+ *
+ * const value = fromDecimalString("123.45", 2);
+ * // Returns Uint32Array representing 12345 with scale 2
+ * ```
+ * @ignore
+ */
+export declare function fromDecimalString(str: string, scale: number): Uint32Array;
+//# sourceMappingURL=decimal.d.ts.map

package/dist/decimal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"decimal.d.ts","sourceRoot":"","sources":["../src/decimal.ts"],"names":[],"mappings":"AAoBA;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAM7D;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,WAAW,GAAG,WAAW,CAY7D;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAuDzE;AAED;;;;;;;;;GASG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CA+BzE;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,WAAW,CA0CzE"}

package/dist/decimal.js

@@ -0,0 +1,206 @@
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements.  See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership.  The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License.  You may obtain a copy of the License at
+//
+//   http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied.  See the License for the
+// specific language governing permissions and limitations
+// under the License.
+// TODO: Remove this file once Apache Arrow merges the PR below
+// https://github.com/apache/arrow-js/pull/341/files#diff-41952a54a60919187ac886be5edde88ec0c80027e2815342d29ec2a77b14d0a6
+/**
+ * Determine if a decimal value is negative by checking the sign bit.
+ * Follows the two's complement representation used in Arrow decimals.
+ * @param value The Uint32Array representing the decimal value
+ * @returns true if the value is negative, false otherwise
+ * @ignore
+ */
+export function isNegativeDecimal(value) {
+    // Check the sign bit of the most significant 32-bit word
+    // This follows the Arrow C++ implementation:
+    // https://github.com/apache/arrow/blob/main/cpp/src/arrow/util/basic_decimal.h
+    const MAX_INT32 = 2 ** 31 - 1;
+    return value.at(-1) > MAX_INT32;
+}
+/**
+ * Negate a decimal value in-place using two's complement arithmetic.
+ * @param value The Uint32Array to negate
+ * @returns The negated value (modified in-place for efficiency)
+ * @ignore
+ */
+export function negateDecimal(value) {
+    // Two's complement negation: flip all bits and add 1
+    // Follows the Arrow C++ implementation:
+    // https://github.com/apache/arrow/blob/main/cpp/src/arrow/util/basic_decimal.cc
+    let carry = 1;
+    for (let i = 0; i < value.length; i++) {
+        const elem = value[i];
+        const updated = ~elem + carry;
+        value[i] = updated >>> 0; // Ensure 32-bit unsigned
+        carry &= elem === 0 ? 1 : 0;
+    }
+    return value;
+}
+/**
+ * Convert a decimal value to a formatted string representation.
+ * Handles both Decimal128 (128-bit) and Decimal256 (256-bit) values.
+ *
+ * @param value The Uint32Array representing the decimal value
+ * @param scale The number of decimal places (digits after the decimal point)
+ * @returns A string representation of the decimal value
+ *
+ * @example
+ * ```ts
+ * import { toDecimalString } from 'apache-arrow';
+ *
+ * const value = new Uint32Array([1, 0, 0, 0]);
+ * const result = toDecimalString(value, 2);
+ * // Returns: "0.01"
+ * ```
+ * @ignore
+ */
+export function toDecimalString(value, scale) {
+    // Build BigInt from little-endian Uint32 words (supports 128-bit and 256-bit)
+    const toBigIntLE = (words) => {
+        let acc = BigInt(0);
+        for (let i = 0; i < words.length; i++) {
+            acc |= BigInt(words[i]) << BigInt(32 * i);
+        }
+        return acc;
+    };
+    // Detect sign via MSB of most-significant word
+    const isNegative = (value[value.length - 1] & 0x80000000) !== 0;
+    // Dynamic width mask (replaces fixed `mask128`)
+    const mask = (BigInt(1) << BigInt(value.length * 32)) - BigInt(1);
+    const n = toBigIntLE(value);
+    // If negative, convert two's complement to magnitude:
+    // magnitude = (~n + 1) & mask128
+    const magnitude = isNegative ? (~n + BigInt(1)) & mask : n;
+    // Magnitude as decimal string
+    const digits = magnitude.toString(10);
+    // Special-case: zero
+    if (magnitude === BigInt(0)) {
+        if (scale === 0) {
+            return '0';
+        }
+        // Tests expect "0.0" for zero with any positive scale
+        return '0.0';
+    }
+    if (scale === 0) {
+        const res = digits;
+        return isNegative ? '-' + res : res;
+    }
+    // Ensure we have at least scale digits for fractional part
+    let integerPart;
+    let fracPart;
+    if (digits.length <= scale) {
+        integerPart = '0';
+        fracPart = digits.padStart(scale, '0');
+    }
+    else {
+        const split = digits.length - scale;
+        integerPart = digits.slice(0, split);
+        fracPart = digits.slice(split);
+    }
+    // Trim trailing zeros in fractional part
+    fracPart = fracPart.replace(/0+$/, '');
+    const result = fracPart === '' ? integerPart : integerPart + '.' + fracPart;
+    return isNegative ? '-' + result : result;
+}
+/**
+ * Convert a decimal value to a number.
+ * Note: This may lose precision for very large decimal values
+ * that exceed JavaScript's 53-bit integer precision.
+ *
+ * @param value The Uint32Array representing the decimal value
+ * @param scale The number of decimal places
+ * @returns A number representation of the decimal value
+ * @ignore
+ */
+export function toDecimalNumber(value, scale) {
+    const negative = isNegativeDecimal(value);
+    // Create a copy to avoid modifying the original
+    const valueCopy = new Uint32Array(value);
+    if (negative) {
+        negateDecimal(valueCopy);
+    }
+    // Convert to BigInt for calculation
+    let num = BigInt(0);
+    for (let i = valueCopy.length - 1; i >= 0; i--) {
+        num = (num << BigInt(32)) | BigInt(valueCopy[i]);
+    }
+    if (negative) {
+        num = -num;
+    }
+    // Apply scale
+    if (scale === 0) {
+        return Number(num);
+    }
+    // Calculate divisor as 10^scale
+    // Using a loop instead of BigInt exponentiation (**) for ES2015 compatibility
+    let divisor = BigInt(1);
+    for (let i = 0; i < scale; i++) {
+        divisor *= BigInt(10);
+    }
+    return Number(num) / Number(divisor);
+}
+/**
+ * Create a Decimal128 value from a string representation.
+ * @param str String representation (e.g., "123.45")
+ * @param scale The scale (number of decimal places) to use
+ * @returns Uint32Array representing the decimal value
+ *
+ * @example
+ * ```ts
+ * import { fromDecimalString } from 'apache-arrow';
+ *
+ * const value = fromDecimalString("123.45", 2);
+ * // Returns Uint32Array representing 12345 with scale 2
+ * ```
+ * @ignore
+ */
+export function fromDecimalString(str, scale) {
+    // Remove leading/trailing whitespace
+    str = str.trim();
+    // Detect negative
+    const negative = str.startsWith('-');
+    if (negative) {
+        str = str.slice(1);
+    }
+    // Split on decimal point
+    const [wholePart = '0', fracPart = ''] = str.split('.');
+    // Pad or truncate fractional part to match scale
+    const adjustedFrac = (fracPart + '0'.repeat(scale)).slice(0, scale);
+    const intStr = wholePart + adjustedFrac;
+    // Convert string to BigInt
+    let num = BigInt(intStr);
+    // Apply negative if needed
+    if (negative) {
+        num = -num;
+    }
+    // Convert BigInt to Uint32Array (Decimal128 = 4 x Uint32)
+    const result = new Uint32Array(4);
+    if (negative && num !== BigInt(0)) {
+        // Use two's complement for negative numbers
+        num = -(num + BigInt(1));
+        for (let i = 0; i < 4; i++) {
+            result[i] = Number((num >> BigInt(i * 32)) & BigInt(0xffffffff));
+            result[i] = ~result[i];
+        }
+    }
+    else {
+        for (let i = 0; i < 4; i++) {
+            result[i] = Number((num >> BigInt(i * 32)) & BigInt(0xffffffff));
+        }
+    }
+    return result;
+}
+//# sourceMappingURL=decimal.js.map

package/dist/decimal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"decimal.js","sourceRoot":"","sources":["../src/decimal.ts"],"names":[],"mappings":"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","sourcesContent":["// Licensed to the Apache Software Foundation (ASF) under one\n// or more contributor license agreements.  See the NOTICE file\n// distributed with this work for additional information\n// regarding copyright ownership.  The ASF licenses this file\n// to you under the Apache License, Version 2.0 (the\n// \"License\"); you may not use this file except in compliance\n// with the License.  You may obtain a copy of the License at\n//\n//   http://www.apache.org/licenses/LICENSE-2.0\n//\n// Unless required by applicable law or agreed to in writing,\n// software distributed under the License is distributed on an\n// \"AS IS\" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY\n// KIND, either express or implied.  See the License for the\n// specific language governing permissions and limitations\n// under the License.\n\n// TODO: Remove this file once Apache Arrow merges the PR below\n// https://github.com/apache/arrow-js/pull/341/files#diff-41952a54a60919187ac886be5edde88ec0c80027e2815342d29ec2a77b14d0a6\n\n/**\n * Determine if a decimal value is negative by checking the sign bit.\n * Follows the two's complement representation used in Arrow decimals.\n * @param value The Uint32Array representing the decimal value\n * @returns true if the value is negative, false otherwise\n * @ignore\n */\nexport function isNegativeDecimal(value: Uint32Array): boolean {\n  // Check the sign bit of the most significant 32-bit word\n  // This follows the Arrow C++ implementation:\n  // https://github.com/apache/arrow/blob/main/cpp/src/arrow/util/basic_decimal.h\n  const MAX_INT32 = 2 ** 31 - 1;\n  return value.at(-1)! > MAX_INT32;\n}\n\n/**\n * Negate a decimal value in-place using two's complement arithmetic.\n * @param value The Uint32Array to negate\n * @returns The negated value (modified in-place for efficiency)\n * @ignore\n */\nexport function negateDecimal(value: Uint32Array): Uint32Array {\n  // Two's complement negation: flip all bits and add 1\n  // Follows the Arrow C++ implementation:\n  // https://github.com/apache/arrow/blob/main/cpp/src/arrow/util/basic_decimal.cc\n  let carry = 1;\n  for (let i = 0; i < value.length; i++) {\n    const elem = value[i]!;\n    const updated = ~elem + carry;\n    value[i] = updated >>> 0; // Ensure 32-bit unsigned\n    carry &= elem === 0 ? 1 : 0;\n  }\n  return value;\n}\n\n/**\n * Convert a decimal value to a formatted string representation.\n * Handles both Decimal128 (128-bit) and Decimal256 (256-bit) values.\n *\n * @param value The Uint32Array representing the decimal value\n * @param scale The number of decimal places (digits after the decimal point)\n * @returns A string representation of the decimal value\n *\n * @example\n * ```ts\n * import { toDecimalString } from 'apache-arrow';\n *\n * const value = new Uint32Array([1, 0, 0, 0]);\n * const result = toDecimalString(value, 2);\n * // Returns: \"0.01\"\n * ```\n * @ignore\n */\nexport function toDecimalString(value: Uint32Array, scale: number): string {\n  // Build BigInt from little-endian Uint32 words (supports 128-bit and 256-bit)\n  const toBigIntLE = (words: Uint32Array) => {\n    let acc = BigInt(0);\n    for (let i = 0; i < words.length; i++) {\n      acc |= BigInt(words[i]!) << BigInt(32 * i);\n    }\n    return acc;\n  };\n\n  // Detect sign via MSB of most-significant word\n  const isNegative = (value[value.length - 1]! & 0x80000000) !== 0;\n  // Dynamic width mask (replaces fixed `mask128`)\n  const mask = (BigInt(1) << BigInt(value.length * 32)) - BigInt(1);\n\n  const n = toBigIntLE(value);\n\n  // If negative, convert two's complement to magnitude:\n  // magnitude = (~n + 1) & mask128\n  const magnitude: bigint = isNegative ? (~n + BigInt(1)) & mask : n;\n\n  // Magnitude as decimal string\n  const digits = magnitude.toString(10);\n\n  // Special-case: zero\n  if (magnitude === BigInt(0)) {\n    if (scale === 0) {\n      return '0';\n    }\n    // Tests expect \"0.0\" for zero with any positive scale\n    return '0.0';\n  }\n\n  if (scale === 0) {\n    const res = digits;\n    return isNegative ? '-' + res : res;\n  }\n\n  // Ensure we have at least scale digits for fractional part\n  let integerPart: string;\n  let fracPart: string;\n  if (digits.length <= scale) {\n    integerPart = '0';\n    fracPart = digits.padStart(scale, '0');\n  } else {\n    const split = digits.length - scale;\n    integerPart = digits.slice(0, split);\n    fracPart = digits.slice(split);\n  }\n\n  // Trim trailing zeros in fractional part\n  fracPart = fracPart.replace(/0+$/, '');\n\n  const result = fracPart === '' ? integerPart : integerPart + '.' + fracPart;\n  return isNegative ? '-' + result : result;\n}\n\n/**\n * Convert a decimal value to a number.\n * Note: This may lose precision for very large decimal values\n * that exceed JavaScript's 53-bit integer precision.\n *\n * @param value The Uint32Array representing the decimal value\n * @param scale The number of decimal places\n * @returns A number representation of the decimal value\n * @ignore\n */\nexport function toDecimalNumber(value: Uint32Array, scale: number): number {\n  const negative = isNegativeDecimal(value);\n\n  // Create a copy to avoid modifying the original\n  const valueCopy = new Uint32Array(value);\n  if (negative) {\n    negateDecimal(valueCopy);\n  }\n\n  // Convert to BigInt for calculation\n  let num = BigInt(0);\n  for (let i = valueCopy.length - 1; i >= 0; i--) {\n    num = (num << BigInt(32)) | BigInt(valueCopy[i]!);\n  }\n\n  if (negative) {\n    num = -num;\n  }\n\n  // Apply scale\n  if (scale === 0) {\n    return Number(num);\n  }\n\n  // Calculate divisor as 10^scale\n  // Using a loop instead of BigInt exponentiation (**) for ES2015 compatibility\n  let divisor = BigInt(1);\n  for (let i = 0; i < scale; i++) {\n    divisor *= BigInt(10);\n  }\n  return Number(num) / Number(divisor);\n}\n\n/**\n * Create a Decimal128 value from a string representation.\n * @param str String representation (e.g., \"123.45\")\n * @param scale The scale (number of decimal places) to use\n * @returns Uint32Array representing the decimal value\n *\n * @example\n * ```ts\n * import { fromDecimalString } from 'apache-arrow';\n *\n * const value = fromDecimalString(\"123.45\", 2);\n * // Returns Uint32Array representing 12345 with scale 2\n * ```\n * @ignore\n */\nexport function fromDecimalString(str: string, scale: number): Uint32Array {\n  // Remove leading/trailing whitespace\n  str = str.trim();\n\n  // Detect negative\n  const negative = str.startsWith('-');\n  if (negative) {\n    str = str.slice(1);\n  }\n\n  // Split on decimal point\n  const [wholePart = '0', fracPart = ''] = str.split('.');\n\n  // Pad or truncate fractional part to match scale\n  const adjustedFrac = (fracPart + '0'.repeat(scale)).slice(0, scale);\n  const intStr = wholePart + adjustedFrac;\n\n  // Convert string to BigInt\n  let num = BigInt(intStr);\n\n  // Apply negative if needed\n  if (negative) {\n    num = -num;\n  }\n\n  // Convert BigInt to Uint32Array (Decimal128 = 4 x Uint32)\n  const result = new Uint32Array(4);\n\n  if (negative && num !== BigInt(0)) {\n    // Use two's complement for negative numbers\n    num = -(num + BigInt(1));\n    for (let i = 0; i < 4; i++) {\n      result[i] = Number((num >> BigInt(i * 32)) & BigInt(0xffffffff));\n      result[i] = ~result[i]!;\n    }\n  } else {\n    for (let i = 0; i < 4; i++) {\n      result[i] = Number((num >> BigInt(i * 32)) & BigInt(0xffffffff));\n    }\n  }\n\n  return result;\n}\n"]}

package/dist/index.d.ts

@@ -12,4 +12,5 @@ export { postData, downloadFile, uploadFile, type ProgressInfo } from './xhr';
 export { splitFilePath, convertToValidColumnOrTableName, convertToUniqueColumnOrTableName, generateUniqueName, generateUniquePath, convertToUniqueS3ObjectName, convertToUniqueS3FolderPath, } from './filepaths';
 export { safeJsonParse } from './json';
 export { memoizeOnce } from './memoization';
+export { isNegativeDecimal, negateDecimal, toDecimalString, toDecimalNumber, fromDecimalString, } from './decimal';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAC,UAAU,EAAC,MAAM,SAAS,CAAC;AAEnC,OAAO,EAAC,WAAW,EAAE,YAAY,EAAE,gBAAgB,EAAE,OAAO,EAAC,MAAM,UAAU,CAAC;AAE9E,OAAO,EACL,aAAa,EACb,YAAY,EACZ,cAAc,EACd,UAAU,EACV,eAAe,EACf,kBAAkB,EAClB,0BAA0B,EAC1B,yBAAyB,GAC1B,MAAM,WAAW,CAAC;AAEnB,OAAO,EAAC,OAAO,EAAC,MAAM,WAAW,CAAC;AAElC,OAAO,EAAC,YAAY,EAAC,MAAM,UAAU,CAAC;AAEtC,OAAO,EAAC,WAAW,EAAE,gBAAgB,EAAE,UAAU,EAAE,QAAQ,EAAC,MAAM,OAAO,CAAC;AAE1E,OAAO,EAAC,QAAQ,EAAE,YAAY,EAAE,UAAU,EAAE,KAAK,YAAY,EAAC,MAAM,OAAO,CAAC;AAE5E,OAAO,EACL,aAAa,EACb,+BAA+B,EAC/B,gCAAgC,EAChC,kBAAkB,EAClB,kBAAkB,EAClB,2BAA2B,EAC3B,2BAA2B,GAC5B,MAAM,aAAa,CAAC;AAErB,OAAO,EAAC,aAAa,EAAC,MAAM,QAAQ,CAAC;AACrC,OAAO,EAAC,WAAW,EAAC,MAAM,eAAe,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAC,UAAU,EAAC,MAAM,SAAS,CAAC;AAEnC,OAAO,EAAC,WAAW,EAAE,YAAY,EAAE,gBAAgB,EAAE,OAAO,EAAC,MAAM,UAAU,CAAC;AAE9E,OAAO,EACL,aAAa,EACb,YAAY,EACZ,cAAc,EACd,UAAU,EACV,eAAe,EACf,kBAAkB,EAClB,0BAA0B,EAC1B,yBAAyB,GAC1B,MAAM,WAAW,CAAC;AAEnB,OAAO,EAAC,OAAO,EAAC,MAAM,WAAW,CAAC;AAElC,OAAO,EAAC,YAAY,EAAC,MAAM,UAAU,CAAC;AAEtC,OAAO,EAAC,WAAW,EAAE,gBAAgB,EAAE,UAAU,EAAE,QAAQ,EAAC,MAAM,OAAO,CAAC;AAE1E,OAAO,EAAC,QAAQ,EAAE,YAAY,EAAE,UAAU,EAAE,KAAK,YAAY,EAAC,MAAM,OAAO,CAAC;AAE5E,OAAO,EACL,aAAa,EACb,+BAA+B,EAC/B,gCAAgC,EAChC,kBAAkB,EAClB,kBAAkB,EAClB,2BAA2B,EAC3B,2BAA2B,GAC5B,MAAM,aAAa,CAAC;AAErB,OAAO,EAAC,aAAa,EAAC,MAAM,QAAQ,CAAC;AACrC,OAAO,EAAC,WAAW,EAAC,MAAM,eAAe,CAAC;AAC1C,OAAO,EACL,iBAAiB,EACjB,aAAa,EACb,eAAe,EACf,eAAe,EACf,iBAAiB,GAClB,MAAM,WAAW,CAAC"}

package/dist/index.js

@@ -12,4 +12,5 @@ export { postData, downloadFile, uploadFile } from './xhr';
 export { splitFilePath, convertToValidColumnOrTableName, convertToUniqueColumnOrTableName, generateUniqueName, generateUniquePath, convertToUniqueS3ObjectName, convertToUniqueS3FolderPath, } from './filepaths';
 export { safeJsonParse } from './json';
 export { memoizeOnce } from './memoization';
+export { isNegativeDecimal, negateDecimal, toDecimalString, toDecimalNumber, fromDecimalString, } from './decimal';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAC,UAAU,EAAC,MAAM,SAAS,CAAC;AAEnC,OAAO,EAAC,WAAW,EAAE,YAAY,EAAE,gBAAgB,EAAE,OAAO,EAAC,MAAM,UAAU,CAAC;AAE9E,OAAO,EACL,aAAa,EACb,YAAY,EACZ,cAAc,EACd,UAAU,EACV,eAAe,EACf,kBAAkB,EAClB,0BAA0B,EAC1B,yBAAyB,GAC1B,MAAM,WAAW,CAAC;AAEnB,OAAO,EAAC,OAAO,EAAC,MAAM,WAAW,CAAC;AAElC,OAAO,EAAC,YAAY,EAAC,MAAM,UAAU,CAAC;AAEtC,OAAO,EAAC,WAAW,EAAE,gBAAgB,EAAE,UAAU,EAAE,QAAQ,EAAC,MAAM,OAAO,CAAC;AAE1E,OAAO,EAAC,QAAQ,EAAE,YAAY,EAAE,UAAU,EAAoB,MAAM,OAAO,CAAC;AAE5E,OAAO,EACL,aAAa,EACb,+BAA+B,EAC/B,gCAAgC,EAChC,kBAAkB,EAClB,kBAAkB,EAClB,2BAA2B,EAC3B,2BAA2B,GAC5B,MAAM,aAAa,CAAC;AAErB,OAAO,EAAC,aAAa,EAAC,MAAM,QAAQ,CAAC;AACrC,OAAO,EAAC,WAAW,EAAC,MAAM,eAAe,CAAC","sourcesContent":["/**\n * {@include ../README.md}\n * @packageDocumentation\n */\n\nexport {opacifyHex} from './color';\n\nexport {formatCount, formatCount4, formatCountShort, shorten} from './format';\n\nexport {\n  NUMBER_FORMAT,\n  formatNumber,\n  formatDateTime,\n  formatDate,\n  formatTimeOfDay,\n  formatTimeRelative,\n  formatTimestampForFilename,\n  getErrorMessageForDisplay,\n} from './helpers';\n\nexport {isMacOS} from './browser';\n\nexport {genRandomStr} from './random';\n\nexport {formatBytes, camelCaseToTitle, capitalize, truncate} from './str';\n\nexport {postData, downloadFile, uploadFile, type ProgressInfo} from './xhr';\n\nexport {\n  splitFilePath,\n  convertToValidColumnOrTableName,\n  convertToUniqueColumnOrTableName,\n  generateUniqueName,\n  generateUniquePath,\n  convertToUniqueS3ObjectName,\n  convertToUniqueS3FolderPath,\n} from './filepaths';\n\nexport {safeJsonParse} from './json';\nexport {memoizeOnce} from './memoization';\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAC,UAAU,EAAC,MAAM,SAAS,CAAC;AAEnC,OAAO,EAAC,WAAW,EAAE,YAAY,EAAE,gBAAgB,EAAE,OAAO,EAAC,MAAM,UAAU,CAAC;AAE9E,OAAO,EACL,aAAa,EACb,YAAY,EACZ,cAAc,EACd,UAAU,EACV,eAAe,EACf,kBAAkB,EAClB,0BAA0B,EAC1B,yBAAyB,GAC1B,MAAM,WAAW,CAAC;AAEnB,OAAO,EAAC,OAAO,EAAC,MAAM,WAAW,CAAC;AAElC,OAAO,EAAC,YAAY,EAAC,MAAM,UAAU,CAAC;AAEtC,OAAO,EAAC,WAAW,EAAE,gBAAgB,EAAE,UAAU,EAAE,QAAQ,EAAC,MAAM,OAAO,CAAC;AAE1E,OAAO,EAAC,QAAQ,EAAE,YAAY,EAAE,UAAU,EAAoB,MAAM,OAAO,CAAC;AAE5E,OAAO,EACL,aAAa,EACb,+BAA+B,EAC/B,gCAAgC,EAChC,kBAAkB,EAClB,kBAAkB,EAClB,2BAA2B,EAC3B,2BAA2B,GAC5B,MAAM,aAAa,CAAC;AAErB,OAAO,EAAC,aAAa,EAAC,MAAM,QAAQ,CAAC;AACrC,OAAO,EAAC,WAAW,EAAC,MAAM,eAAe,CAAC;AAC1C,OAAO,EACL,iBAAiB,EACjB,aAAa,EACb,eAAe,EACf,eAAe,EACf,iBAAiB,GAClB,MAAM,WAAW,CAAC","sourcesContent":["/**\n * {@include ../README.md}\n * @packageDocumentation\n */\n\nexport {opacifyHex} from './color';\n\nexport {formatCount, formatCount4, formatCountShort, shorten} from './format';\n\nexport {\n  NUMBER_FORMAT,\n  formatNumber,\n  formatDateTime,\n  formatDate,\n  formatTimeOfDay,\n  formatTimeRelative,\n  formatTimestampForFilename,\n  getErrorMessageForDisplay,\n} from './helpers';\n\nexport {isMacOS} from './browser';\n\nexport {genRandomStr} from './random';\n\nexport {formatBytes, camelCaseToTitle, capitalize, truncate} from './str';\n\nexport {postData, downloadFile, uploadFile, type ProgressInfo} from './xhr';\n\nexport {\n  splitFilePath,\n  convertToValidColumnOrTableName,\n  convertToUniqueColumnOrTableName,\n  generateUniqueName,\n  generateUniquePath,\n  convertToUniqueS3ObjectName,\n  convertToUniqueS3FolderPath,\n} from './filepaths';\n\nexport {safeJsonParse} from './json';\nexport {memoizeOnce} from './memoization';\nexport {\n  isNegativeDecimal,\n  negateDecimal,\n  toDecimalString,\n  toDecimalNumber,\n  fromDecimalString,\n} from './decimal';\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sqlrooms/utils",
-  "version": "0.27.0-rc.0",
+  "version": "0.27.0-rc.2",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "module": "dist/index.js",
@@ -43,5 +43,5 @@
     "react": ">=18",
     "react-dom": ">=18"
   },
-  "gitHead": "ceafff23c197b8188040f8c93baf4e7d3dd4b081"
+  "gitHead": "eec06537352a9e760de21d7bcc77d9aa2db2a5ec"
 }