@gzl10/ts-helpers 4.2.1

package/dist/node-esm/index.js

@@ -0,0 +1,426 @@
+import {
+  async_exports,
+  handleOperation,
+  runBatch,
+  sleep,
+  wait
+} from "./chunk-LYTET5NX.js";
+import {
+  data_exports,
+  detectFileExtension,
+  detectFormatFromFilename,
+  detectUniversalFormat,
+  exportData,
+  exportTree,
+  exportTxt,
+  importData,
+  importTree,
+  importTxt,
+  readFileAsText,
+  validateCSVData,
+  validateExportData
+} from "./chunk-KBHE3K2F.js";
+import "./chunk-75XNTC34.js";
+import {
+  renderTreeAsText,
+  tree_exports
+} from "./chunk-DZZPUYMP.js";
+import {
+  detectHostname,
+  detectProtocol,
+  environment_exports,
+  getEnvironmentInfo,
+  isBrowser,
+  isBrowserEnvironment,
+  isDevelopment,
+  isLocalhost,
+  isNode,
+  isNodeEnvironment,
+  isNonProduction,
+  isPrivateIP,
+  isProduction,
+  isTest,
+  parseEnvValue
+} from "./chunk-64TBXJQS.js";
+import {
+  escapeShellCommand,
+  generateNonce,
+  generateSecureToken,
+  hashString,
+  isSecureUrl,
+  isValidBase64,
+  isValidJWTFormat,
+  removeDangerousChars,
+  sanitizeHtml,
+  validatePassword,
+  validation_crypto_exports
+} from "./chunk-XAEYT23H.js";
+import {
+  generateAlphaNumericString,
+  generateAlphaString,
+  generateComplexString,
+  generateEmail,
+  generateHexColor,
+  generatePassword,
+  generateRandomInteger,
+  generateSpanishCIF,
+  generateSpanishIBAN,
+  generateSpanishNIE,
+  generateSpanishNIF,
+  generateSpanishPostalCode,
+  generateUsername,
+  generateUsernameFromEmail,
+  isValidCIF,
+  isValidEmail,
+  isValidJSON,
+  isValidNIE,
+  isValidNIF,
+  isValidSpanishIBAN,
+  isValidSpanishPhone,
+  isValidSpanishPostalCode,
+  isValidURL,
+  validateNIF,
+  validation_core_exports
+} from "./chunk-CMDFZME3.js";
+import {
+  capitalizeEachWord,
+  capitalizeFirst,
+  cleanJsonChars,
+  contains,
+  countOccurrences,
+  endsWith,
+  ensureEndsWith,
+  ensureStartsWith,
+  envKeyToPath,
+  escapeHtmlChars,
+  isEmail,
+  isEmpty,
+  matchPathPattern,
+  padEnd,
+  padStart,
+  pathToEnvKey,
+  removeAccents,
+  repeatString,
+  replaceAllOccurrences,
+  reverseString,
+  sanitizeString,
+  startsWith,
+  strings_exports,
+  stripFromEnd,
+  stripFromStart,
+  toCamelCase,
+  toKebabCase,
+  toLowerCase,
+  toPascalCase,
+  toSnakeCase,
+  toUpperCase,
+  toUrlSlug,
+  trim,
+  trimEnd,
+  trimStart,
+  truncateString,
+  unescapeHtmlChars,
+  unescapeUnicode
+} from "./chunk-C4PKXIPB.js";
+import {
+  calculateDifferences,
+  comparator,
+  deepEqual,
+  deleteArrayElementsBy,
+  formatToReadableString,
+  generateCrcHash,
+  getDeepValue,
+  getShallowProperties,
+  hasSameType,
+  objects_exports,
+  setDeepValue,
+  updateArrayElementById,
+  updateArrayElementsBy
+} from "./chunk-HTSEHRHI.js";
+import {
+  addDays,
+  addMonths,
+  addNowDays,
+  addNowMonths,
+  addNowSeconds,
+  addNowYears,
+  addSeconds,
+  addYears,
+  areDatesEqualWithTolerance,
+  dates_exports,
+  dayOfWeek,
+  diffBusinessDays,
+  diffDays,
+  diffMilliSeconds,
+  diffMonths,
+  diffYears,
+  excelToDate,
+  format,
+  formatForMysql,
+  formatNow,
+  fromNow,
+  getFirstDayOfYear,
+  getFirstWorkdayAfterMonths,
+  getFirstWorkdayOfMonth,
+  getLastDayOfYear,
+  getLastWorkdayOfMonth,
+  isDateTime,
+  isEqualsDateTimeByDay,
+  isExpired,
+  isNew,
+  isWeekday,
+  longString,
+  now,
+  toDate,
+  toDateFromString,
+  toISO,
+  weekOfYear
+} from "./chunk-3YOF7NPT.js";
+import {
+  calculateAggregations,
+  calculateAnnuityPayment,
+  calculateCorrelation,
+  calculateEuclideanDistance,
+  calculateFutureValue,
+  calculateHistogram,
+  calculateIQR,
+  calculateIRR,
+  calculateManhattanDistance,
+  calculateMedian,
+  calculateMode,
+  calculateNPV,
+  calculatePercentile,
+  calculatePresentValue,
+  calculateQuartiles,
+  calculateStandardDeviation,
+  calculateTrendSlope,
+  calculateVariance,
+  detectOutliers,
+  math_exports,
+  normalizeToRange,
+  scaleToRange,
+  simpleKMeans
+} from "./chunk-UKGXL2QO.js";
+import {
+  isNumericValue,
+  number_exports,
+  roundToDecimals
+} from "./chunk-JCAUVOPH.js";
+import "./chunk-PZ5AY32C.js";
+
+// src/node/index.ts
+var validationFunctions = {
+  ...validation_core_exports,
+  ...validation_crypto_exports
+};
+var g = {
+  // Full validation functions (core + crypto)
+  ...validationFunctions,
+  // String functions
+  ...strings_exports,
+  // Object/Array functions
+  ...objects_exports,
+  // Date functions
+  ...dates_exports,
+  // Math functions
+  ...math_exports,
+  // Async functions
+  ...async_exports,
+  // Data functions
+  ...data_exports,
+  // Number utilities
+  ...number_exports,
+  // Tree utilities
+  ...tree_exports,
+  // Environment utilities
+  ...environment_exports
+};
+var node_default = g;
+export {
+  addDays,
+  addMonths,
+  addNowDays,
+  addNowMonths,
+  addNowSeconds,
+  addNowYears,
+  addSeconds,
+  addYears,
+  areDatesEqualWithTolerance,
+  async_exports as async,
+  calculateAggregations,
+  calculateAnnuityPayment,
+  calculateCorrelation,
+  calculateDifferences,
+  calculateEuclideanDistance,
+  calculateFutureValue,
+  calculateHistogram,
+  calculateIQR,
+  calculateIRR,
+  calculateManhattanDistance,
+  calculateMedian,
+  calculateMode,
+  calculateNPV,
+  calculatePercentile,
+  calculatePresentValue,
+  calculateQuartiles,
+  calculateStandardDeviation,
+  calculateTrendSlope,
+  calculateVariance,
+  capitalizeEachWord,
+  capitalizeFirst,
+  cleanJsonChars,
+  comparator,
+  contains,
+  countOccurrences,
+  data_exports as data,
+  dates_exports as dates,
+  dayOfWeek,
+  deepEqual,
+  node_default as default,
+  deleteArrayElementsBy,
+  detectFileExtension,
+  detectFormatFromFilename,
+  detectHostname,
+  detectOutliers,
+  detectProtocol,
+  detectUniversalFormat,
+  diffBusinessDays,
+  diffDays,
+  diffMilliSeconds,
+  diffMonths,
+  diffYears,
+  endsWith,
+  ensureEndsWith,
+  ensureStartsWith,
+  envKeyToPath,
+  environment_exports as environment,
+  escapeHtmlChars,
+  escapeShellCommand,
+  excelToDate,
+  exportData,
+  exportTree,
+  exportTxt,
+  format,
+  formatForMysql,
+  formatNow,
+  formatToReadableString,
+  fromNow,
+  generateAlphaNumericString,
+  generateAlphaString,
+  generateComplexString,
+  generateCrcHash,
+  generateEmail,
+  generateHexColor,
+  generateNonce,
+  generatePassword,
+  generateRandomInteger,
+  generateSecureToken,
+  generateSpanishCIF,
+  generateSpanishIBAN,
+  generateSpanishNIE,
+  generateSpanishNIF,
+  generateSpanishPostalCode,
+  generateUsername,
+  generateUsernameFromEmail,
+  getDeepValue,
+  getEnvironmentInfo,
+  getFirstDayOfYear,
+  getFirstWorkdayAfterMonths,
+  getFirstWorkdayOfMonth,
+  getLastDayOfYear,
+  getLastWorkdayOfMonth,
+  getShallowProperties,
+  handleOperation,
+  hasSameType,
+  hashString,
+  importData,
+  importTree,
+  importTxt,
+  isBrowser,
+  isBrowserEnvironment,
+  isDateTime,
+  isDevelopment,
+  isEmail,
+  isEmpty,
+  isEqualsDateTimeByDay,
+  isExpired,
+  isLocalhost,
+  isNew,
+  isNode,
+  isNodeEnvironment,
+  isNonProduction,
+  isNumericValue,
+  isPrivateIP,
+  isProduction,
+  isSecureUrl,
+  isTest,
+  isValidBase64,
+  isValidCIF,
+  isValidEmail,
+  isValidJSON,
+  isValidJWTFormat,
+  isValidNIE,
+  isValidNIF,
+  isValidSpanishIBAN,
+  isValidSpanishPhone,
+  isValidSpanishPostalCode,
+  isValidURL,
+  isWeekday,
+  longString,
+  matchPathPattern,
+  math_exports as math,
+  normalizeToRange,
+  now,
+  number_exports as number,
+  objects_exports as objects,
+  padEnd,
+  padStart,
+  parseEnvValue,
+  pathToEnvKey,
+  readFileAsText,
+  removeAccents,
+  removeDangerousChars,
+  renderTreeAsText,
+  repeatString,
+  replaceAllOccurrences,
+  reverseString,
+  roundToDecimals,
+  runBatch,
+  sanitizeHtml,
+  sanitizeString,
+  scaleToRange,
+  setDeepValue,
+  simpleKMeans,
+  sleep,
+  startsWith,
+  strings_exports as strings,
+  stripFromEnd,
+  stripFromStart,
+  toCamelCase,
+  toDate,
+  toDateFromString,
+  toISO,
+  toKebabCase,
+  toLowerCase,
+  toPascalCase,
+  toSnakeCase,
+  toUpperCase,
+  toUrlSlug,
+  tree_exports as tree,
+  trim,
+  trimEnd,
+  trimStart,
+  truncateString,
+  unescapeHtmlChars,
+  unescapeUnicode,
+  updateArrayElementById,
+  updateArrayElementsBy,
+  validateCSVData,
+  validateExportData,
+  validateNIF,
+  validatePassword,
+  validationFunctions as validation,
+  wait,
+  weekOfYear
+};
+//# sourceMappingURL=index.js.map

package/dist/node-esm/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/node/index.ts"],"sourcesContent":["/**\n * Node.js-specific exports - Full functionality with crypto support\n * Uses Node.js crypto module for secure operations\n */\n\n// Import universal modules\nimport * as validationCore from '../universal/validation-core'\nimport * as stringFunctions from '../strings'\nimport * as objectFunctions from '../objects'\nimport * as dateFunctions from '../dates'\nimport * as mathFunctions from '../math'\nimport * as asyncFunctions from '../async'\nimport * as dataFunctions from '../data'\nimport * as environmentModule from '../environment'\nimport * as numberModule from '../number'\nimport * as treeModule from '../tree'\n\n// Import Node.js-specific crypto functions\nimport * as validationCrypto from './validation-crypto'\n\n// Merge core validation with crypto functions for Node.js\nconst validationFunctions = {\n  ...validationCore,\n  ...validationCrypto,\n}\n\n// Create flat API object with full Node.js functionality\nconst g = {\n  // Full validation functions (core + crypto)\n  ...validationFunctions,\n\n  // String functions\n  ...stringFunctions,\n\n  // Object/Array functions\n  ...objectFunctions,\n\n  // Date functions\n  ...dateFunctions,\n\n  // Math functions\n  ...mathFunctions,\n\n  // Async functions\n  ...asyncFunctions,\n\n  // Data functions\n  ...dataFunctions,\n\n  // Number utilities\n  ...numberModule,\n\n  // Tree utilities\n  ...treeModule,\n\n  // Environment utilities\n  ...environmentModule,\n}\n\n// Export both default and named exports\nexport default g\n\n// Named exports for specific imports\nexport {\n  validationFunctions as validation,\n  stringFunctions as strings,\n  objectFunctions as objects,\n  dateFunctions as dates,\n  mathFunctions as math,\n  asyncFunctions as async,\n  dataFunctions as data,\n  environmentModule as environment,\n  numberModule as number,\n  treeModule as tree,\n}\n\n// Re-export individual functions for tree-shaking\nexport * from '../universal/validation-core'\nexport * from './validation-crypto'\nexport * from '../strings'\nexport * from '../objects'\nexport * from '../dates'\nexport * from '../math'\nexport * from '../async'\nexport * from '../data'\nexport * from '../environment'\nexport * from '../number'\n// Note: tree module exports conflict with data module, so importing through named export\nexport { renderTreeAsText, TreeExportOptions as TreeOnlyExportOptions } from '../tree'\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAqBA,IAAM,sBAAsB;AAAA,EAC1B,GAAG;AAAA,EACH,GAAG;AACL;AAGA,IAAM,IAAI;AAAA;AAAA,EAER,GAAG;AAAA;AAAA,EAGH,GAAG;AAAA;AAAA,EAGH,GAAG;AAAA;AAAA,EAGH,GAAG;AAAA;AAAA,EAGH,GAAG;AAAA;AAAA,EAGH,GAAG;AAAA;AAAA,EAGH,GAAG;AAAA;AAAA,EAGH,GAAG;AAAA;AAAA,EAGH,GAAG;AAAA;AAAA,EAGH,GAAG;AACL;AAGA,IAAO,eAAQ;","names":[]}

package/dist/node-esm/json.js

@@ -0,0 +1,68 @@
+import {
+  isNode
+} from "./chunk-64TBXJQS.js";
+import "./chunk-PZ5AY32C.js";
+
+// src/json.ts
+async function exportJSON(data, filePath, options) {
+  if (data === null || data === void 0) {
+    throw new TypeError("Data cannot be null or undefined");
+  }
+  if (!filePath || typeof filePath !== "string" || filePath.trim() === "") {
+    throw new TypeError("File path must be a non-empty string");
+  }
+  const { indent = 2 } = options || {};
+  let jsonText;
+  try {
+    jsonText = JSON.stringify(data, null, indent);
+  } catch (error) {
+    if (error instanceof TypeError && error.message.includes("circular")) {
+      throw new TypeError("Cannot serialize data with circular references");
+    }
+    throw error;
+  }
+  if (isNode()) {
+    const fs = await import("fs/promises");
+    await fs.writeFile(filePath, jsonText, { encoding: "utf-8" });
+  } else {
+    const blob = new Blob([jsonText], { type: "application/json;charset=utf-8" });
+    const url = URL.createObjectURL(blob);
+    const link = document.createElement("a");
+    link.href = url;
+    link.download = filePath.split("/").pop() || "data.json";
+    document.body.appendChild(link);
+    link.click();
+    document.body.removeChild(link);
+    URL.revokeObjectURL(url);
+  }
+}
+async function importJSON(filePath, _options) {
+  if (!filePath || typeof filePath !== "string" || filePath.trim() === "") {
+    throw new TypeError("File path must be a non-empty string");
+  }
+  if (isNode()) {
+    const fs = await import("fs/promises");
+    const content = await fs.readFile(filePath, { encoding: "utf-8" });
+    const trimmed = content.trim();
+    if (trimmed === "") {
+      throw new SyntaxError("JSON file is empty");
+    }
+    try {
+      return JSON.parse(content);
+    } catch (error) {
+      if (error instanceof SyntaxError) {
+        throw new SyntaxError(`Invalid JSON in file ${filePath}: ${error.message}`);
+      }
+      throw error;
+    }
+  } else {
+    throw new Error(
+      "JSON import not supported in browser. Use readFileAsText() with a File object."
+    );
+  }
+}
+export {
+  exportJSON,
+  importJSON
+};
+//# sourceMappingURL=json.js.map

package/dist/node-esm/json.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/json.ts"],"sourcesContent":["/**\n * JSON Import/Export utilities\n *\n * Provides reliable JSON file operations for both Node.js and Browser environments.\n * Features:\n * - UTF-8 encoding for international character support\n * - Pretty-printing with configurable indentation\n * - Dual-mode: filesystem (Node.js) vs download trigger (Browser)\n * - Native JSON.stringify/parse for maximum compatibility\n *\n * @module json\n */\n\nimport { isNode } from './environment'\n\n/**\n * Exports data as JSON file with UTF-8 encoding\n *\n * Works in both Node.js (writes to filesystem) and Browser (triggers download).\n * Uses native JSON.stringify for serialization with optional pretty-printing.\n *\n * Features:\n * - UTF-8 encoding for international characters\n * - Configurable indentation (default: 2 spaces)\n * - Automatic filename extraction in browser\n * - Pretty-printed by default for readability\n *\n * Environment behavior:\n * - **Node.js**: Writes file to filesystem at specified path\n * - **Browser**: Triggers automatic download with filename extracted from path\n *\n * ⚠️ WARNING: Cannot serialize:\n * - Functions (removed silently)\n * - Symbols (removed silently)\n * - Circular references (throws TypeError)\n * - undefined values (removed from objects, converted to null in arrays)\n * - BigInt values (throws TypeError unless custom replacer provided)\n *\n * @param data - Any serializable JavaScript value (object, array, primitive)\n * @param filePath - File path (Node.js) or download filename (Browser)\n * @param options - Export options (optional)\n * @param options.indent - Number of spaces for indentation (default: 2, use 0 for compact)\n * @returns Promise that resolves when export completes\n *\n * @example\n * ```typescript\n * // Basic export - Object\n * const config = {\n *   database: { host: 'localhost', port: 5432 },\n *   features: { auth: true, payments: false }\n * }\n *\n * // Node.js - Write to file\n * await exportJSON(config, './config/app.json')\n * // Creates: ./config/app.json with 2-space indentation\n *\n * // Browser - Trigger download\n * await exportJSON(config, 'app-config.json')\n * // Downloads: app-config.json to browser's download folder\n *\n * // Compact output (no pretty-printing)\n * await exportJSON(config, 'config.json', { indent: 0 })\n * // Single-line JSON: {\"database\":{\"host\":\"localhost\",\"port\":5432}}\n * ```\n *\n * @example\n * ```typescript\n * // Array export\n * const users = [\n *   { id: 1, name: 'Alice', email: 'alice@example.com' },\n *   { id: 2, name: 'Bob', email: 'bob@example.com' }\n * ]\n * await exportJSON(users, 'users.json')\n * ```\n *\n * @example\n * ```typescript\n * // Real-world: Configuration backup system\n * async function backupConfiguration(config: AppConfig) {\n *   const timestamp = new Date().toISOString().split('T')[0]\n *   const filename = `config-backup-${timestamp}.json`\n *\n *   try {\n *     await exportJSON(config, `./backups/${filename}`, { indent: 2 })\n *     console.log(`✅ Configuration backed up to ${filename}`)\n *   } catch (error) {\n *     console.error('❌ Backup failed:', error)\n *     throw error\n *   }\n * }\n * ```\n *\n * @example\n * ```typescript\n * // Real-world: Export API response for debugging\n * async function debugApiResponse(endpoint: string, data: any) {\n *   const filename = `api-${endpoint.replace(/\\//g, '-')}.json`\n *   await exportJSON({\n *     endpoint,\n *     timestamp: new Date().toISOString(),\n *     data\n *   }, filename)\n * }\n * ```\n *\n * @example\n * ```typescript\n * // Handle circular references\n * const obj = { name: 'test' }\n * obj.self = obj  // Circular reference\n *\n * try {\n *   await exportJSON(obj, 'circular.json')\n * } catch (error) {\n *   console.error('Cannot serialize circular structure')\n *   // Use custom replacer to handle circular refs\n * }\n * ```\n *\n * @example\n * ```typescript\n * // Different indentation levels\n * await exportJSON(data, 'compact.json', { indent: 0 })     // Single line\n * await exportJSON(data, 'readable.json', { indent: 2 })    // 2 spaces (default)\n * await exportJSON(data, 'spacious.json', { indent: 4 })    // 4 spaces\n * ```\n *\n * @throws {TypeError} If data contains circular references or BigInt values\n * @throws {Error} If file write fails in Node.js (permissions, disk space, etc.)\n * @see {@link importJSON} for importing JSON files\n * @see {@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/JSON/stringify JSON.stringify Documentation}\n */\nexport async function exportJSON(\n  data: any,\n  filePath: string,\n  options?: { indent?: number }\n): Promise<void> {\n  // ✅ Input validation\n  if (data === null || data === undefined) {\n    throw new TypeError('Data cannot be null or undefined')\n  }\n\n  if (!filePath || typeof filePath !== 'string' || filePath.trim() === '') {\n    throw new TypeError('File path must be a non-empty string')\n  }\n\n  const { indent = 2 } = options || {}\n\n  // ✅ Detect circular references before stringify\n  let jsonText: string\n  try {\n    jsonText = JSON.stringify(data, null, indent)\n  } catch (error) {\n    if (error instanceof TypeError && error.message.includes('circular')) {\n      throw new TypeError('Cannot serialize data with circular references')\n    }\n    throw error\n  }\n\n  if (isNode()) {\n    const fs = await import('fs/promises')\n    await fs.writeFile(filePath, jsonText, { encoding: 'utf-8' })\n  } else {\n    const blob = new Blob([jsonText], { type: 'application/json;charset=utf-8' })\n    const url = URL.createObjectURL(blob)\n    const link = document.createElement('a')\n    link.href = url\n    link.download = filePath.split('/').pop() || 'data.json'\n    document.body.appendChild(link)\n    link.click()\n    document.body.removeChild(link)\n    URL.revokeObjectURL(url)\n  }\n}\n\n/**\n * Imports JSON file and parses it to JavaScript value\n *\n * Reads JSON file from filesystem (Node.js only) and parses using native JSON.parse.\n * Returns the parsed JavaScript value (object, array, primitive).\n *\n * Features:\n * - UTF-8 encoding support for international characters\n * - Native JSON.parse for standard-compliant parsing\n * - Automatic type inference\n * - Whitespace and comment tolerance (standard JSON only)\n *\n * ⚠️ BROWSER LIMITATION: File reading from filesystem is not supported in browsers\n * for security reasons. For browser file uploads, use `readFileAsText()` with a File object\n * obtained from an input[type=\"file\"] element.\n *\n * @param filePath - Path to JSON file (Node.js only)\n * @param _options - Reserved for future options (currently unused)\n * @returns Promise<any> Parsed JavaScript value (object, array, primitive, null)\n *\n * @example\n * ```typescript\n * // Basic import - Node.js only\n * const config = await importJSON('./config/app.json')\n * // Returns: { database: { host: 'localhost', port: 5432 }, ... }\n *\n * console.log(config.database.host)  // 'localhost'\n *\n * // Array import\n * const users = await importJSON('./data/users.json')\n * // Returns: [{ id: 1, name: 'Alice' }, { id: 2, name: 'Bob' }]\n *\n * // Primitive values (valid JSON)\n * const version = await importJSON('./version.json')  // \"1.2.3\"\n * const enabled = await importJSON('./feature.json')   // true\n * const count = await importJSON('./count.json')       // 42\n * ```\n *\n * @example\n * ```typescript\n * // Real-world: Load configuration with fallback\n * async function loadConfiguration(configPath: string): Promise<AppConfig> {\n *   try {\n *     const config = await importJSON(configPath)\n *\n *     // Validate loaded config\n *     if (!config.database || !config.database.host) {\n *       throw new Error('Invalid configuration: missing database.host')\n *     }\n *\n *     return config\n *   } catch (error) {\n *     console.warn(`Failed to load config from ${configPath}:`, error)\n *     console.log('Using default configuration')\n *     return getDefaultConfig()\n *   }\n * }\n * ```\n *\n * @example\n * ```typescript\n * // Real-world: Restore configuration backup\n * async function restoreBackup(backupFile: string) {\n *   console.log(`Restoring configuration from ${backupFile}...`)\n *\n *   const backup = await importJSON(`./backups/${backupFile}`)\n *\n *   // Verify backup integrity\n *   if (!backup.timestamp || !backup.config) {\n *     throw new Error('Invalid backup file format')\n *   }\n *\n *   // Restore configuration\n *   await saveConfiguration(backup.config)\n *\n *   console.log(`✅ Configuration restored from ${backup.timestamp}`)\n * }\n * ```\n *\n * @example\n * ```typescript\n * // Browser alternative using File API\n * // HTML: <input type=\"file\" id=\"jsonFile\" accept=\".json\">\n *\n * document.getElementById('jsonFile').addEventListener('change', async (e) => {\n *   const file = e.target.files[0]\n *\n *   // Read file content\n *   const content = await readFileAsText(file)\n *\n *   // Parse JSON\n *   try {\n *     const data = JSON.parse(content)\n *     console.log('Imported JSON:', data)\n *   } catch (error) {\n *     console.error('Invalid JSON file:', error)\n *   }\n * })\n * ```\n *\n * @example\n * ```typescript\n * // Handle parsing errors\n * async function safeImportJSON(filePath: string): Promise<any | null> {\n *   try {\n *     return await importJSON(filePath)\n *   } catch (error) {\n *     if (error.message.includes('not supported in browser')) {\n *       console.error('Use File API for browser uploads')\n *     } else if (error.code === 'ENOENT') {\n *       console.error(`File not found: ${filePath}`)\n *     } else if (error instanceof SyntaxError) {\n *       console.error(`Invalid JSON syntax in ${filePath}:`, error.message)\n *     } else {\n *       console.error('JSON import failed:', error)\n *     }\n *     return null\n *   }\n * }\n * ```\n *\n * @example\n * ```typescript\n * // Type-safe import with validation\n * interface DatabaseConfig {\n *   host: string\n *   port: number\n *   database: string\n * }\n *\n * async function loadDatabaseConfig(path: string): Promise<DatabaseConfig> {\n *   const raw = await importJSON(path)\n *\n *   // Runtime validation\n *   if (typeof raw.host !== 'string' || typeof raw.port !== 'number') {\n *     throw new Error('Invalid database configuration structure')\n *   }\n *\n *   return raw as DatabaseConfig\n * }\n * ```\n *\n * @throws {Error} 'JSON import not supported in browser' when called in browser environment\n * @throws {SyntaxError} If file contains invalid JSON syntax\n * @throws {Error} File system errors (ENOENT, EACCES, etc.) in Node.js\n * @see {@link exportJSON} for exporting JSON files\n * @see {@link readFileAsText} for browser file reading\n * @see {@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/JSON/parse JSON.parse Documentation}\n */\nexport async function importJSON(filePath: string, _options?: any): Promise<any> {\n  // ✅ Input validation\n  if (!filePath || typeof filePath !== 'string' || filePath.trim() === '') {\n    throw new TypeError('File path must be a non-empty string')\n  }\n\n  if (isNode()) {\n    const fs = await import('fs/promises')\n    const content = await fs.readFile(filePath, { encoding: 'utf-8' })\n\n    // ✅ Validate content is not empty\n    const trimmed = content.trim()\n    if (trimmed === '') {\n      throw new SyntaxError('JSON file is empty')\n    }\n\n    // ✅ Better error message for invalid JSON\n    try {\n      return JSON.parse(content)\n    } catch (error) {\n      if (error instanceof SyntaxError) {\n        throw new SyntaxError(`Invalid JSON in file ${filePath}: ${error.message}`)\n      }\n      throw error\n    }\n  } else {\n    throw new Error(\n      'JSON import not supported in browser. Use readFileAsText() with a File object.'\n    )\n  }\n}\n"],"mappings":";;;;;;AAoIA,eAAsB,WACpB,MACA,UACA,SACe;AAEf,MAAI,SAAS,QAAQ,SAAS,QAAW;AACvC,UAAM,IAAI,UAAU,kCAAkC;AAAA,EACxD;AAEA,MAAI,CAAC,YAAY,OAAO,aAAa,YAAY,SAAS,KAAK,MAAM,IAAI;AACvE,UAAM,IAAI,UAAU,sCAAsC;AAAA,EAC5D;AAEA,QAAM,EAAE,SAAS,EAAE,IAAI,WAAW,CAAC;AAGnC,MAAI;AACJ,MAAI;AACF,eAAW,KAAK,UAAU,MAAM,MAAM,MAAM;AAAA,EAC9C,SAAS,OAAO;AACd,QAAI,iBAAiB,aAAa,MAAM,QAAQ,SAAS,UAAU,GAAG;AACpE,YAAM,IAAI,UAAU,gDAAgD;AAAA,IACtE;AACA,UAAM;AAAA,EACR;AAEA,MAAI,OAAO,GAAG;AACZ,UAAM,KAAK,MAAM,OAAO,aAAa;AACrC,UAAM,GAAG,UAAU,UAAU,UAAU,EAAE,UAAU,QAAQ,CAAC;AAAA,EAC9D,OAAO;AACL,UAAM,OAAO,IAAI,KAAK,CAAC,QAAQ,GAAG,EAAE,MAAM,iCAAiC,CAAC;AAC5E,UAAM,MAAM,IAAI,gBAAgB,IAAI;AACpC,UAAM,OAAO,SAAS,cAAc,GAAG;AACvC,SAAK,OAAO;AACZ,SAAK,WAAW,SAAS,MAAM,GAAG,EAAE,IAAI,KAAK;AAC7C,aAAS,KAAK,YAAY,IAAI;AAC9B,SAAK,MAAM;AACX,aAAS,KAAK,YAAY,IAAI;AAC9B,QAAI,gBAAgB,GAAG;AAAA,EACzB;AACF;AAuJA,eAAsB,WAAW,UAAkB,UAA8B;AAE/E,MAAI,CAAC,YAAY,OAAO,aAAa,YAAY,SAAS,KAAK,MAAM,IAAI;AACvE,UAAM,IAAI,UAAU,sCAAsC;AAAA,EAC5D;AAEA,MAAI,OAAO,GAAG;AACZ,UAAM,KAAK,MAAM,OAAO,aAAa;AACrC,UAAM,UAAU,MAAM,GAAG,SAAS,UAAU,EAAE,UAAU,QAAQ,CAAC;AAGjE,UAAM,UAAU,QAAQ,KAAK;AAC7B,QAAI,YAAY,IAAI;AAClB,YAAM,IAAI,YAAY,oBAAoB;AAAA,IAC5C;AAGA,QAAI;AACF,aAAO,KAAK,MAAM,OAAO;AAAA,IAC3B,SAAS,OAAO;AACd,UAAI,iBAAiB,aAAa;AAChC,cAAM,IAAI,YAAY,wBAAwB,QAAQ,KAAK,MAAM,OAAO,EAAE;AAAA,MAC5E;AACA,YAAM;AAAA,IACR;AAAA,EACF,OAAO;AACL,UAAM,IAAI;AAAA,MACR;AAAA,IACF;AAAA,EACF;AACF;","names":[]}

package/dist/node-esm/math.js

@@ -0,0 +1,51 @@
+import {
+  calculateAggregations,
+  calculateAnnuityPayment,
+  calculateCorrelation,
+  calculateEuclideanDistance,
+  calculateFutureValue,
+  calculateHistogram,
+  calculateIQR,
+  calculateIRR,
+  calculateManhattanDistance,
+  calculateMedian,
+  calculateMode,
+  calculateNPV,
+  calculatePercentile,
+  calculatePresentValue,
+  calculateQuartiles,
+  calculateStandardDeviation,
+  calculateTrendSlope,
+  calculateVariance,
+  detectOutliers,
+  normalizeToRange,
+  scaleToRange,
+  simpleKMeans
+} from "./chunk-UKGXL2QO.js";
+import "./chunk-JCAUVOPH.js";
+import "./chunk-PZ5AY32C.js";
+export {
+  calculateAggregations,
+  calculateAnnuityPayment,
+  calculateCorrelation,
+  calculateEuclideanDistance,
+  calculateFutureValue,
+  calculateHistogram,
+  calculateIQR,
+  calculateIRR,
+  calculateManhattanDistance,
+  calculateMedian,
+  calculateMode,
+  calculateNPV,
+  calculatePercentile,
+  calculatePresentValue,
+  calculateQuartiles,
+  calculateStandardDeviation,
+  calculateTrendSlope,
+  calculateVariance,
+  detectOutliers,
+  normalizeToRange,
+  scaleToRange,
+  simpleKMeans
+};
+//# sourceMappingURL=math.js.map

package/dist/node-esm/math.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/node-esm/number.js

@@ -0,0 +1,10 @@
+import {
+  isNumericValue,
+  roundToDecimals
+} from "./chunk-JCAUVOPH.js";
+import "./chunk-PZ5AY32C.js";
+export {
+  isNumericValue,
+  roundToDecimals
+};
+//# sourceMappingURL=number.js.map

package/dist/node-esm/number.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/node-esm/objects.js

@@ -0,0 +1,31 @@
+import {
+  calculateDifferences,
+  comparator,
+  deepEqual,
+  deleteArrayElementsBy,
+  formatToReadableString,
+  generateCrcHash,
+  getDeepValue,
+  getShallowProperties,
+  hasSameType,
+  setDeepValue,
+  updateArrayElementById,
+  updateArrayElementsBy
+} from "./chunk-HTSEHRHI.js";
+import "./chunk-3YOF7NPT.js";
+import "./chunk-PZ5AY32C.js";
+export {
+  calculateDifferences,
+  comparator,
+  deepEqual,
+  deleteArrayElementsBy,
+  formatToReadableString,
+  generateCrcHash,
+  getDeepValue,
+  getShallowProperties,
+  hasSameType,
+  setDeepValue,
+  updateArrayElementById,
+  updateArrayElementsBy
+};
+//# sourceMappingURL=objects.js.map

package/dist/node-esm/objects.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}