iterflow 0.4.0 → 0.7.0

package/dist/index.cjs

@@ -213,6 +213,7 @@ function validateIndex(index, size, operation) {
 // src/iter-flow.ts
 var iterflow = class _iterflow {
   source;
+  _sourceArray;
   /**
    * Creates a new iterflow instance from an iterable or iterator.
    *
@@ -224,7 +225,13 @@ var iterflow = class _iterflow {
    * ```
    */
   constructor(source) {
-    this.source = Symbol.iterator in source ? source[Symbol.iterator]() : source;
+    if (Array.isArray(source)) {
+      this._sourceArray = source;
+      this.source = source[Symbol.iterator]();
+    } else {
+      this._sourceArray = void 0;
+      this.source = Symbol.iterator in source ? source[Symbol.iterator]() : source;
+    }
   }
   // Iterator protocol
   /**
@@ -300,6 +307,9 @@ var iterflow = class _iterflow {
    * ```
    */
   take(limit) {
+    if (this._sourceArray) {
+      return new _iterflow(this._sourceArray.slice(0, limit));
+    }
     const self = this;
     return new _iterflow({
       *[Symbol.iterator]() {
@@ -323,6 +333,9 @@ var iterflow = class _iterflow {
    * ```
    */
   drop(count) {
+    if (this._sourceArray) {
+      return new _iterflow(this._sourceArray.slice(count));
+    }
     const self = this;
     return new _iterflow({
       *[Symbol.iterator]() {
@@ -475,6 +488,9 @@ var iterflow = class _iterflow {
    * ```
    */
   reverse() {
+    if (this._sourceArray) {
+      return new _iterflow(this._sourceArray.slice().reverse());
+    }
     const self = this;
     return new _iterflow({
       *[Symbol.iterator]() {
@@ -502,6 +518,16 @@ var iterflow = class _iterflow {
    * ```
    */
   sort() {
+    if (this._sourceArray) {
+      return new _iterflow(
+        this._sourceArray.slice().sort((a, b) => {
+          if (typeof a === "number" && typeof b === "number") {
+            return a - b;
+          }
+          return String(a).localeCompare(String(b));
+        })
+      );
+    }
     const self = this;
     return new _iterflow({
       *[Symbol.iterator]() {
@@ -534,6 +560,9 @@ var iterflow = class _iterflow {
    * ```
    */
   sortBy(compareFn) {
+    if (this._sourceArray) {
+      return new _iterflow(this._sourceArray.slice().sort(compareFn));
+    }
     const self = this;
     return new _iterflow({
       *[Symbol.iterator]() {
@@ -555,6 +584,9 @@ var iterflow = class _iterflow {
    * ```
    */
   toArray() {
+    if (this._sourceArray) {
+      return this._sourceArray.slice();
+    }
     return Array.from(this);
   }
   /**
@@ -568,6 +600,9 @@ var iterflow = class _iterflow {
    * ```
    */
   count() {
+    if (this._sourceArray) {
+      return this._sourceArray.length;
+    }
     let count = 0;
     for (const _ of this) {
       count++;
@@ -588,6 +623,13 @@ var iterflow = class _iterflow {
    * ```
    */
   sum() {
+    if (this._sourceArray) {
+      let total2 = 0;
+      for (let i = 0; i < this._sourceArray.length; i++) {
+        total2 += this._sourceArray[i];
+      }
+      return total2;
+    }
     let total = 0;
     for (const value of this) {
       total += value;
@@ -676,14 +718,14 @@ var iterflow = class _iterflow {
    * ```
    */
   median() {
-    const values = this.toArray();
+    const values = this._sourceArray || this.toArray();
     if (values.length === 0) return void 0;
-    values.sort((a, b) => a - b);
-    const mid = Math.floor(values.length / 2);
-    if (values.length % 2 === 0) {
-      return (values[mid - 1] + values[mid]) / 2;
+    const sorted = values.slice().sort((a, b) => a - b);
+    const mid = Math.floor(sorted.length / 2);
+    if (sorted.length % 2 === 0) {
+      return (sorted[mid - 1] + sorted[mid]) / 2;
     } else {
-      return values[mid];
+      return sorted[mid];
     }
   }
   /**
@@ -701,7 +743,7 @@ var iterflow = class _iterflow {
    * ```
    */
   variance() {
-    const values = this.toArray();
+    const values = this._sourceArray || this.toArray();
     if (values.length === 0) return void 0;
     const mean = values.reduce((sum, val) => sum + val, 0) / values.length;
     let sumSquaredDiffs = 0;
@@ -749,19 +791,19 @@ var iterflow = class _iterflow {
    */
   percentile(p) {
     validateRange(p, 0, 100, "percentile", "percentile");
-    const values = this.toArray();
+    const values = this._sourceArray || this.toArray();
     if (values.length === 0) return void 0;
-    values.sort((a, b) => a - b);
-    if (p === 0) return values[0];
-    if (p === 100) return values[values.length - 1];
-    const index = p / 100 * (values.length - 1);
+    const sorted = values.slice().sort((a, b) => a - b);
+    if (p === 0) return sorted[0];
+    if (p === 100) return sorted[sorted.length - 1];
+    const index = p / 100 * (sorted.length - 1);
     const lower = Math.floor(index);
     const upper = Math.ceil(index);
     if (lower === upper) {
-      return values[lower];
+      return sorted[lower];
     }
     const weight = index - lower;
-    return values[lower] * (1 - weight) + values[upper] * weight;
+    return sorted[lower] * (1 - weight) + sorted[upper] * weight;
   }
   /**
    * Finds the most frequent value(s) in the dataset.
@@ -779,7 +821,7 @@ var iterflow = class _iterflow {
    * ```
    */
   mode() {
-    const values = this.toArray();
+    const values = this._sourceArray || this.toArray();
     if (values.length === 0) return void 0;
     const frequency = /* @__PURE__ */ new Map();
     let maxFreq = 0;
@@ -812,20 +854,20 @@ var iterflow = class _iterflow {
    * ```
    */
   quartiles() {
-    const values = this.toArray();
+    const values = this._sourceArray || this.toArray();
     if (values.length === 0) return void 0;
-    values.sort((a, b) => a - b);
+    const sorted = values.slice().sort((a, b) => a - b);
     const calculatePercentile = (p) => {
-      if (p === 0) return values[0];
-      if (p === 100) return values[values.length - 1];
-      const index = p / 100 * (values.length - 1);
+      if (p === 0) return sorted[0];
+      if (p === 100) return sorted[sorted.length - 1];
+      const index = p / 100 * (sorted.length - 1);
       const lower = Math.floor(index);
       const upper = Math.ceil(index);
       if (lower === upper) {
-        return values[lower];
+        return sorted[lower];
       }
       const weight = index - lower;
-      return values[lower] * (1 - weight) + values[upper] * weight;
+      return sorted[lower] * (1 - weight) + sorted[upper] * weight;
     };
     return {
       Q1: calculatePercentile(25),
@@ -897,7 +939,7 @@ var iterflow = class _iterflow {
    * ```
    */
   covariance(other) {
-    const values1 = this.toArray();
+    const values1 = this._sourceArray || this.toArray();
     const values2 = Array.from(other);
     if (values1.length === 0 || values2.length === 0 || values1.length !== values2.length) {
       return void 0;
@@ -928,7 +970,7 @@ var iterflow = class _iterflow {
    * ```
    */
   correlation(other) {
-    const values1 = this.toArray();
+    const values1 = this._sourceArray || this.toArray();
     const values2 = Array.from(other);
     if (values1.length === 0 || values2.length === 0 || values1.length !== values2.length) {
       return void 0;
@@ -1352,6 +1394,9 @@ var iterflow = class _iterflow {
    * ```
    */
   first(defaultValue) {
+    if (this._sourceArray) {
+      return this._sourceArray.length > 0 ? this._sourceArray[0] : defaultValue;
+    }
     const result = this.source.next();
     return result.done ? defaultValue : result.value;
   }
@@ -1369,6 +1414,9 @@ var iterflow = class _iterflow {
    * ```
    */
   last(defaultValue) {
+    if (this._sourceArray) {
+      return this._sourceArray.length > 0 ? this._sourceArray[this._sourceArray.length - 1] : defaultValue;
+    }
     let lastValue = defaultValue;
     let hasValue = false;
     for (const value of this) {
@@ -1391,6 +1439,9 @@ var iterflow = class _iterflow {
    * ```
    */
   nth(index) {
+    if (this._sourceArray) {
+      return index >= 0 && index < this._sourceArray.length ? this._sourceArray[index] : void 0;
+    }
     if (index < 0) {
       return void 0;
     }
@@ -1415,6 +1466,9 @@ var iterflow = class _iterflow {
    * ```
    */
   isEmpty() {
+    if (this._sourceArray) {
+      return this._sourceArray.length === 0;
+    }
     const result = this.source.next();
     return result.done === true;
   }
@@ -1433,6 +1487,9 @@ var iterflow = class _iterflow {
    * ```
    */
   includes(searchValue) {
+    if (this._sourceArray) {
+      return this._sourceArray.includes(searchValue);
+    }
     for (const value of this) {
       if (value === searchValue) {
         return true;
@@ -3375,12 +3432,12 @@ var DebugState = class {
   /**
    * Enable debug mode with optional configuration
    */
-  enable(config2) {
+  enable(config) {
     this.config = {
       ...this.config,
       enabled: true,
       traceOperations: true,
-      ...config2
+      ...config
     };
     if (this.config.logToConsole) {
       console.log("[iterflow Debug] Debug mode enabled", this.config);
@@ -3500,8 +3557,8 @@ var DebugState = class {
   }
 };
 var debugState = new DebugState();
-function enableDebug(config2) {
-  debugState.enable(config2);
+function enableDebug(config) {
+  debugState.enable(config);
 }
 function disableDebug() {
   debugState.disable();
@@ -3734,85 +3791,6 @@ function errorBoundary(fn, options = {}) {
   };
 }
 
-// src/deprecation.ts
-var config = {
-  enabled: typeof process !== "undefined" && process.env.NODE_ENV !== "production",
-  showStackTrace: false
-};
-var warnedFeatures = /* @__PURE__ */ new Set();
-function configureDeprecation(options) {
-  config = { ...config, ...options };
-}
-function getDeprecationConfig() {
-  return { ...config };
-}
-function clearDeprecationWarnings() {
-  warnedFeatures.clear();
-}
-function emitWarning(warning) {
-  if (!config.enabled) return;
-  if (warnedFeatures.has(warning.feature)) return;
-  warnedFeatures.add(warning.feature);
-  if (config.handler) {
-    config.handler(warning);
-    return;
-  }
-  let message = `[iterflow] DEPRECATED: ${warning.feature} has been deprecated since v${warning.since}`;
-  if (warning.removeIn) {
-    message += ` and will be removed in v${warning.removeIn}`;
-  }
-  if (warning.alternative) {
-    message += `
-Please use ${warning.alternative} instead.`;
-  }
-  if (warning.message) {
-    message += `
-${warning.message}`;
-  }
-  if (typeof process !== "undefined" && process.emitWarning) {
-    const options = {
-      type: "DeprecationWarning",
-      code: "ITERFLOW_DEPRECATION",
-      detail: warning.message
-    };
-    process.emitWarning(message, options);
-  } else {
-    console.warn(message);
-  }
-  if (config.showStackTrace && warning.stack) {
-    console.warn("Stack trace:", warning.stack);
-  }
-}
-function deprecate(options) {
-  const warning = {
-    ...options,
-    stack: config.showStackTrace ? new Error().stack : void 0
-  };
-  emitWarning(warning);
-}
-function deprecated(options) {
-  return function(target, propertyKey, descriptor) {
-    const originalMethod = descriptor.value;
-    if (!originalMethod) return;
-    const className = target.constructor?.name || "Object";
-    const feature = `${className}.${propertyKey}`;
-    descriptor.value = function(...args) {
-      deprecate({ ...options, feature });
-      return originalMethod.apply(this, args);
-    };
-    return descriptor;
-  };
-}
-function deprecatedFunction(fn, options) {
-  return function(...args) {
-    deprecate(options);
-    return fn.apply(this, args);
-  };
-}
-function hasDeprecationWarning(feature) {
-  return warnedFeatures.has(feature);
-}
-
 // src/index.ts
 function iter(source) {
   return new iterflow(source);
@@ -3979,21 +3957,14 @@ exports.TypeConversionError = TypeConversionError;
 exports.ValidationError = ValidationError;
 exports.addTrace = addTrace;
 exports.asyncIter = asyncIter;
-exports.clearDeprecationWarnings = clearDeprecationWarnings;
 exports.clearTraces = clearTraces;
-exports.configureDeprecation = configureDeprecation;
-exports.deprecate = deprecate;
-exports.deprecated = deprecated;
-exports.deprecatedFunction = deprecatedFunction;
 exports.disableDebug = disableDebug;
 exports.enableDebug = enableDebug;
 exports.errorBoundary = errorBoundary;
 exports.getDebugConfig = getDebugConfig;
-exports.getDeprecationConfig = getDeprecationConfig;
 exports.getTraceSummary = getTraceSummary;
 exports.getTraces = getTraces;
 exports.getTracesForOperation = getTracesForOperation;
-exports.hasDeprecationWarning = hasDeprecationWarning;
 exports.isDebugEnabled = isDebugEnabled;
 exports.iter = iter;
 exports.iterflow = iterflow;