range-pie 1.0.1 → 2.0.1

package/dist/py-range.js

@@ -0,0 +1,361 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PyRange = void 0;
+/**
+ * A class that simulates Python's range function, combined with several useful JavaScript array methods.
+ */
+class PyRange {
+    /**
+     * Creates a new PyRange instance.
+     * @param {...number} args - The arguments of the range. The possible forms are
+     *   - `PyRange(stop)`
+     *   - `PyRange(start, stop)`
+     *   - `PyRange(start, stop, step)`
+     * @throws {TypeError} If any of the arguments is not a number.
+     * @throws {TypeError} If any of the arguments is not an integer.
+     * @throws {Error} If the step is zero.
+     * @throws {Error} If the arguments count is not between 1 and 3.
+     * @property {number} start - The start of the range, inclusive.
+     * @property {number} stop - The stop of the range, exclusive.
+     * @property {number} step - The step of the range.
+     * @property {number} length - The length of the range.
+     */
+    constructor(...args) {
+        if (!args.every((arg) => typeof arg === "number")) {
+            throw new TypeError("All arguments must be numbers");
+        }
+        if (!args.every(Number.isInteger)) {
+            throw new TypeError("All arguments must be integers");
+        }
+        const [start, stop, step] = args.length === 1
+            ? [0, args[0], 1]
+            : args.length === 2
+                ? [args[0], args[1], 1]
+                : args.length === 3
+                    ? [args[0], args[1], args[2]]
+                    : (() => {
+                        throw new Error("Invalid arguments count: must between 1 and 3");
+                    })();
+        if (step === 0) {
+            throw new Error("Step cannot be zero");
+        }
+        this._start = start;
+        this._stop = stop;
+        this._step = stop < start && args.length !== 3 ? -step : step;
+        const diff = this._step > 0 ? stop - start : start - stop;
+        this._length = Math.max(Math.ceil(diff / Math.abs(this._step)), 0);
+    }
+    /**
+     * Gets the length of this range.
+     *
+     * @returns {number} the length of this range
+     * @readonly
+     */
+    get length() {
+        return this._length;
+    }
+    /**
+     * Gets the starting value of the range.
+     *
+     * @returns {number} The starting value of the range.
+     * @readonly
+     */
+    get start() {
+        return this._start;
+    }
+    /**
+     * Gets the ending value of the range.
+     *
+     * @returns {number} The ending value of the range.
+     * @readonly
+     */
+    get stop() {
+        return this._stop;
+    }
+    /**
+     * Gets the step value of the range.
+     *
+     * @returns {number} The step value of the range.
+     * @readonly
+     */
+    get step() {
+        return this._step;
+    }
+    /**
+     * Gets the value at the specified index in this range.
+     * @param {number} index - The index of the value to retrieve
+     * @returns {number} The value at the specified index
+     * @throws {RangeError} If the index is out of range
+     */
+    at(index) {
+        if (index < 0 || index >= this._length) {
+            throw new RangeError("Index out of range");
+        }
+        return this._start + index * this._step;
+    }
+    /**
+     * Converts the range to a string.
+     * @returns {string} A string of the form `Range(start, stop, step)`.
+     */
+    toString() {
+        return `PyRange(${this._start}, ${this._stop}, ${this._step})`;
+    }
+    /**
+     * Converts the range to an array.
+     * @returns {number[]} An array of numbers with the same elements as this range.
+     */
+    toArray() {
+        return [...this];
+    }
+    /**
+     * Validates that the callback is a function.
+     * @param {Function} cb - The callback to validate.
+     * @throws {TypeError} If the callback is not a function.
+     */
+    static validateCb(cb) {
+        if (typeof cb !== "function") {
+            throw new TypeError("Callback must be a function");
+        }
+    }
+    /**
+     * Creates a new array with the results of applying the given callback
+     * function to every element in this range.
+     * @param {function(number, number, PyRange): T} callback - The callback
+     * function to apply to every element.
+     * @returns {T[]} A new array of the same length as this range.
+     * @template T
+     */
+    map(callback) {
+        PyRange.validateCb(callback);
+        const result = new Array(this._length);
+        for (let i = 0; i < this._length; i++) {
+            result[i] = callback(this.at(i), i, this);
+        }
+        return result;
+    }
+    /**
+     * Creates a new array with all elements that pass the test implemented by
+     * the provided function.
+     * @param {function(number, number, PyRange): boolean} callback - The
+     * predicate function to apply to every element
+     * @returns {number[]} A new array of elements that pass the test
+     */
+    filter(callback) {
+        PyRange.validateCb(callback);
+        const result = [];
+        for (let i = 0; i < this._length; i++) {
+            const value = this.at(i);
+            if (callback(value, i, this)) {
+                result.push(value);
+            }
+        }
+        return result;
+    }
+    /**
+     * Reduces the range to a single value.
+     * @param {function(T, number, number, PyRange): T} callback - The callback
+     * function to apply to every element. The callback should take four
+     * arguments: the accumulator, the current value, the index of the current
+     * value, and the range object.
+     * @param {T} [initialValue] - The initial value of the accumulator.
+     * @returns {T} The final value of the accumulator.
+     * @template T
+     */
+    reduce(callback, initialValue) {
+        PyRange.validateCb(callback);
+        if (this._length === 0 && initialValue === undefined) {
+            throw new TypeError("Reduce of empty range with no initial value");
+        }
+        let accumulator;
+        let startIndex;
+        if (initialValue !== undefined) {
+            accumulator = initialValue;
+            startIndex = 0;
+        }
+        else {
+            accumulator = this.at(0);
+            startIndex = 1;
+        }
+        for (let i = startIndex; i < this._length; i++) {
+            accumulator = callback(accumulator, this.at(i), i, this);
+        }
+        return accumulator;
+    }
+    /**
+     * Determines whether at least one element of the range satisfies the
+     * provided test.
+     * @param {function(number, number, PyRange): boolean} callback - The
+     * predicate function to apply to every element
+     * @returns {boolean} True if at least one element of the range passes the
+     * test, false otherwise.
+     */
+    some(callback) {
+        PyRange.validateCb(callback);
+        for (let i = 0; i < this._length; i++) {
+            if (callback(this.at(i), i, this)) {
+                return true;
+            }
+        }
+        return false;
+    }
+    /**
+     * Determines whether all elements of the range satisfy the provided test.
+     * @param {function(number, number, PyRange): boolean} callback - The
+     * predicate function to apply to every element
+     * @returns {boolean} True if all elements of the range pass the test,
+     * false otherwise.
+     */
+    every(callback) {
+        PyRange.validateCb(callback);
+        for (let i = 0; i < this._length; i++) {
+            if (!callback(this.at(i), i, this)) {
+                return false;
+            }
+        }
+        return true;
+    }
+    /**
+     * Finds the first element in this range that satisfies the provided test.
+     * @param {function(number, number, PyRange): boolean} callback - The
+     * predicate function to apply to every element
+     * @returns {number|undefined} The first element that passes the test,
+     * or undefined if no element passes the test.
+     */
+    find(callback) {
+        PyRange.validateCb(callback);
+        for (let i = 0; i < this._length; i++) {
+            if (callback(this.at(i), i, this)) {
+                return this.at(i);
+            }
+        }
+        return undefined;
+    }
+    /**
+     * Finds the index of the first element in this range that satisfies the provided test.
+     * @param {function(number, number, PyRange): boolean} callback - The predicate function to apply to each element.
+     * @returns {number} The index of the first element that passes the test, or -1 if no element passes the test.
+     */
+    findIndex(callback) {
+        PyRange.validateCb(callback);
+        for (let i = 0; i < this._length; i++) {
+            if (callback(this.at(i), i, this)) {
+                return i;
+            }
+        }
+        return -1;
+    }
+    /**
+     * Finds the index of the last element in this range that satisfies the provided test.
+     * @param {function(number, number, PyRange): boolean} callback - The predicate function to apply to each element.
+     * @returns {number} The index of the last element that passes the test, or -1 if no element passes the test.
+     */
+    findLastIndex(callback) {
+        PyRange.validateCb(callback);
+        for (let i = this._length - 1; i >= 0; i--) {
+            if (callback(this.at(i), i, this)) {
+                return i;
+            }
+        }
+        return -1;
+    }
+    /**
+     * Executes a provided function once for each element in this range.
+     * @param {function(number, number, PyRange): void} callback - The
+     * function to execute for each element.
+     */
+    forEach(callback) {
+        PyRange.validateCb(callback);
+        for (let i = 0; i < this._length; i++) {
+            callback(this.at(i), i, this);
+        }
+    }
+    /**
+     * Determines whether the given value is present in this range.
+     * @param {any} value - The value to search for.
+     * @returns {boolean} True if the value is present, false otherwise.
+     */
+    includes(value) {
+        return this.some((item) => item === value);
+    }
+    /**
+     * Returns the index of the first occurrence of the specified value, or -1 if it is not present.
+     * @param {any} value - The value to search for.
+     * @returns {number} The index of the value, or -1 if it is not present.
+     */
+    indexOf(value) {
+        for (let i = 0; i < this._length; i++) {
+            if (this.at(i) === value) {
+                return i;
+            }
+        }
+        return -1;
+    }
+    /**
+     * Returns the index of the last occurrence of the specified value, or -1 if it is not present.
+     * @param {any} value - The value to search for.
+     * @returns {number} The index of the last occurrence of the value, or -1 if it is not present.
+     */
+    lastIndexOf(value) {
+        for (let i = this._length - 1; i >= 0; i--) {
+            if (this.at(i) === value) {
+                return i;
+            }
+        }
+        return -1;
+    }
+    /**
+     * Reverses the order of the elements in this range, returning a new PyRange object.
+     * @returns {PyRange} A new PyRange object with the elements in reverse order.
+     */
+    reverse() {
+        const result = new PyRange(this._stop, this._start, -this._step);
+        // Force the length to be the same as the original range
+        result._length = this._length;
+        return result;
+    }
+    /**
+     * Implements the iterable protocol for this range.
+     * @returns {Iterator<number>} An iterator for this range.
+     */
+    [Symbol.iterator]() {
+        let index = 0;
+        let current = this._start;
+        const { _step: step, _length: length } = this;
+        return {
+            next: () => {
+                if (index >= length) {
+                    return { done: true, value: undefined };
+                }
+                else {
+                    const value = current;
+                    current += step;
+                    index++;
+                    return { value, done: false };
+                }
+            },
+        };
+    }
+    /**
+     * Returns a Proxy for this range, allowing indexed access.
+     * This proxy enables accessing range elements via array-like indexing.
+     * If the property is a number, it will return the element at that index.
+     *
+     * @returns {any} A proxy for the PyRange instance.
+     */
+    asProxy() {
+        return new Proxy(this, {
+            get(target, prop) {
+                if (typeof prop === "symbol") {
+                    return target[prop];
+                }
+                if (!isNaN(Number(prop))) {
+                    return target.at(parseInt(String(prop), 10));
+                }
+                return target[prop];
+            },
+        });
+    }
+}
+exports.PyRange = PyRange;
+exports.default = PyRange;
+//# sourceMappingURL=py-range.js.map

package/dist/py-range.js.map

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

package/examples/advanced-usage.js

@@ -0,0 +1,61 @@
+/**
+ * Advanced usage examples for range-pie
+ * 
+ * This file demonstrates more advanced features of the PyRange class
+ */
+
+const { PyRange } = require('range-pie');
+
+console.log('\n--- Advanced PyRange Examples ---');
+
+// Example 1: Using the reverse method
+const range1 = new PyRange(1, 6);
+console.log('Original range:', [...range1]);  // [1, 2, 3, 4, 5]
+
+const reversed = range1.reverse();
+console.log('Reversed range:', [...reversed]);  // [5, 4, 3, 2, 1]
+
+// Example 2: Using the asProxy method for array-like access
+const range2 = new PyRange(10).asProxy();
+console.log('range2[0]:', range2[0]);  // 0
+console.log('range2[5]:', range2[5]);  // 5
+
+// Create an array using proxy access
+const firstThree = [range2[0], range2[1], range2[2]];
+console.log('firstThree:', firstThree);  // [0, 1, 2]
+
+// Example 3: Method chaining
+const range3 = new PyRange(1, 10);
+const result = range3
+  .filter(x => x % 2 === 0)  // Get even numbers
+  .map(x => x * x)           // Square them
+  .filter(x => x > 10);      // Filter values greater than 10
+
+console.log('Chained methods result:', result);  // [16, 36, 64]
+
+// Example 4: Using PyRange with other array methods
+const range4 = new PyRange(5);
+const array = [...range4];  // Convert to array: [0, 1, 2, 3, 4]
+
+// Now we can use native array methods
+const sorted = array.sort((a, b) => b - a);  // Sort in descending order
+console.log('Sorted array:', sorted);  // [4, 3, 2, 1, 0]
+
+// Example 5: Creating a range with custom step
+const range5 = new PyRange(0, 11, 2);
+console.log('Range with step 2:', [...range5]);  // [0, 2, 4, 6, 8, 10]
+
+// Example 6: Combining multiple ranges
+const range6a = new PyRange(0, 3);
+const range6b = new PyRange(5, 8);
+const combined = [...range6a, ...range6b];
+console.log('Combined ranges:', combined);  // [0, 1, 2, 5, 6, 7]
+
+// Example 7: Using PyRange for iteration
+console.log('\nIteration example:');
+for (const num of new PyRange(3)) {
+  console.log(`Current number: ${num}`);
+}
+// Current number: 0
+// Current number: 1
+// Current number: 2

package/examples/array-methods.js

@@ -0,0 +1,68 @@
+/**
+ * Array method examples for range-pie
+ * 
+ * This file demonstrates how to use the array-like methods provided by PyRange
+ */
+
+const { PyRange } = require('range-pie');
+
+console.log('\n--- Array Method Examples ---');
+
+// Create a range to work with
+const range = new PyRange(1, 10);
+console.log('Original range:', [...range]);  // [1, 2, 3, 4, 5, 6, 7, 8, 9]
+
+// Map: Double each value
+const doubled = range.map(x => x * 2);
+console.log('map(x => x * 2):', doubled);  // [2, 4, 6, 8, 10, 12, 14, 16, 18]
+
+// Filter: Get only even numbers
+const evens = range.filter(x => x % 2 === 0);
+console.log('filter(x => x % 2 === 0):', evens);  // [2, 4, 6, 8]
+
+// Reduce: Sum all values
+const sum = range.reduce((acc, curr) => acc + curr, 0);
+console.log('reduce((acc, curr) => acc + curr, 0):', sum);  // 45
+
+// Some: Check if any value meets a condition
+const hasEven = range.some(x => x % 2 === 0);
+console.log('some(x => x % 2 === 0):', hasEven);  // true
+
+// Every: Check if all values meet a condition
+const allPositive = range.every(x => x > 0);
+console.log('every(x => x > 0):', allPositive);  // true
+
+// Find: Get the first value that meets a condition
+const firstEven = range.find(x => x % 2 === 0);
+console.log('find(x => x % 2 === 0):', firstEven);  // 2
+
+// FindIndex: Get the index of the first value that meets a condition
+const firstEvenIndex = range.findIndex(x => x % 2 === 0);
+console.log('findIndex(x => x % 2 === 0):', firstEvenIndex);  // 1
+
+// FindLastIndex: Get the index of the last value that meets a condition
+const lastEvenIndex = range.findLastIndex(x => x % 2 === 0);
+console.log('findLastIndex(x => x % 2 === 0):', lastEvenIndex);  // 7
+
+// Includes: Check if a value exists in the range
+const includesFive = range.includes(5);
+console.log('includes(5):', includesFive);  // true
+
+// IndexOf: Get the index of a value
+const indexOfFive = range.indexOf(5);
+console.log('indexOf(5):', indexOfFive);  // 4
+
+// LastIndexOf: Get the last index of a value
+const lastIndexOfFive = range.lastIndexOf(5);
+console.log('lastIndexOf(5):', lastIndexOfFive);  // 4
+
+// ForEach: Execute a function for each value
+console.log('\nforEach example:');
+range.forEach(x => {
+  if (x % 3 === 0) {
+    console.log(`${x} is divisible by 3`);
+  }
+});
+// 3 is divisible by 3
+// 6 is divisible by 3
+// 9 is divisible by 3

package/examples/basic-usage.js

@@ -0,0 +1,42 @@
+/**
+ * Basic usage examples for range-pie
+ * 
+ * This file demonstrates the fundamental ways to use the PyRange class
+ * with JavaScript.
+ */
+
+// CommonJS import
+const { PyRange } = require('range-pie');
+
+console.log('\n--- Basic PyRange Examples ---');
+
+// Example 1: Simple range with just stop value
+const range1 = new PyRange(5);
+console.log('PyRange(5):', [...range1]);  // [0, 1, 2, 3, 4]
+
+// Example 2: Range with start and stop
+const range2 = new PyRange(2, 8);
+console.log('PyRange(2, 8):', [...range2]);  // [2, 3, 4, 5, 6, 7]
+
+// Example 3: Range with start, stop, and step
+const range3 = new PyRange(1, 10, 2);
+console.log('PyRange(1, 10, 2):', [...range3]);  // [1, 3, 5, 7, 9]
+
+// Example 4: Negative step
+const range4 = new PyRange(10, 0, -2);
+console.log('PyRange(10, 0, -2):', [...range4]);  // [10, 8, 6, 4, 2]
+
+console.log('\n--- Accessing Properties ---');
+console.log('range3.start:', range3.start);  // 1
+console.log('range3.stop:', range3.stop);    // 10
+console.log('range3.step:', range3.step);    // 2
+console.log('range3.length:', range3.length);  // 5
+
+console.log('\n--- Using at() Method ---');
+console.log('range3.at(0):', range3.at(0));  // 1
+console.log('range3.at(2):', range3.at(2));  // 5
+// console.log(range3.at(10));  // Would throw RangeError: Index out of range
+
+console.log('\n--- Converting to Array ---');
+const array = range3.toArray();
+console.log('range3.toArray():', array);  // [1, 3, 5, 7, 9]

package/examples/typescript-usage.ts

@@ -0,0 +1,61 @@
+/**
+ * TypeScript usage examples for range-pie
+ *
+ * This file demonstrates how to use the PyRange class with TypeScript,
+ * taking advantage of type safety and generics.
+ */
+
+// ES Module import
+import { PyRange } from "range-pie";
+
+console.log("\n--- TypeScript PyRange Examples ---");
+
+// Basic usage is the same as JavaScript
+const range = new PyRange(1, 10);
+console.log("Basic range:", [...range]); // [1, 2, 3, 4, 5, 6, 7, 8, 9]
+
+// TypeScript provides type safety
+// This would cause a compile-time error:
+// const badRange = new PyRange("not a number");
+
+// Type inference with generics
+// TypeScript knows this returns number[]
+const numbers = range.map((x) => x * 2);
+console.log("Doubled numbers:", numbers); // [2, 4, 6, 8, 10, 12, 14, 16, 18]
+
+// TypeScript knows this returns string[]
+const strings = range.map((x) => `Number: ${x}`);
+console.log("First string:", strings[0]); // "Number: 1"
+
+// TypeScript knows this returns boolean[]
+const booleans = range.map((x) => x % 2 === 0);
+console.log("Is even:", booleans); // [false, true, false, true, false, true, false, true, false]
+
+// Type safety with callbacks
+range.forEach((value: number, index: number) => {
+  console.log(`Value at index ${index}: ${value}`);
+});
+
+// Using reduce with proper typing
+const sum: number = range.reduce((acc, curr) => acc + curr, 0);
+console.log("Sum:", sum); // 45
+
+// Creating a custom object with map
+interface NumberInfo {
+  value: number;
+  isEven: boolean;
+  square: number;
+}
+
+const infoArray: NumberInfo[] = range.map((x) => ({
+  value: x,
+  isEven: x % 2 === 0,
+  square: x * x,
+}));
+
+console.log("First object:", infoArray[0]); // { value: 1, isEven: false, square: 1 }
+
+// Chaining methods with type safety
+const evenSquares: number[] = range.filter((x) => x % 2 === 0).map((x) => x * x);
+
+console.log("Even squares:", evenSquares); // [4, 16, 36, 64]

package/package.json

@@ -1,16 +1,31 @@
 {
   "name": "range-pie",
-  "version": "1.0.1",
-  "description": "A JavaScript class that simulate Python's range function, combined with several useful JavaScript array methods.",
-  "main": "src/index.js",
+  "version": "2.0.1",
+  "description": "A TypeScript class that simulates Python's range function, combined with several useful JavaScript array methods.",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
   "exports": {
     ".": {
-      "import": "./src/index.js",
-      "require": "./src/index.js"
+      "import": "./dist/index.js",
+      "require": "./dist/index.js",
+      "types": "./dist/index.d.ts"
     }
   },
+  "files": [
+    "dist",
+    "examples"
+  ],
   "scripts": {
-    "test": "node --experimental-vm-modules node_modules/jest/bin/jest.js"
+    "build": "tsc",
+    "prepublishOnly": "npm run build",
+    "test": "jest",
+    "clean": "rimraf dist",
+    "format": "prettier --write \"src/**/*.ts\" \"test/**/*.ts\" \"examples/**/*.ts\"",
+    "check-format": "prettier --check \"src/**/*.ts\" \"test/**/*.ts\" \"examples/**/*.ts\"",
+    "example:basic": "node examples/basic-usage.js",
+    "example:array": "node examples/array-methods.js",
+    "example:advanced": "node examples/advanced-usage.js",
+    "example:ts": "ts-node examples/typescript-usage.ts"
   },
   "keywords": [
     "range",
@@ -20,11 +35,22 @@
     "JavaScript Array",
     "Array",
     "py-range",
-    "PyRange"
+    "PyRange",
+    "TypeScript"
   ],
   "author": "SkorpionG2000",
   "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/SkorpionG/range-pie.git"
+  },
   "devDependencies": {
-    "jest": "^29.7.0"
+    "@types/jest": "^29.5.0",
+    "jest": "^29.7.0",
+    "prettier": "^3.5.3",
+    "rimraf": "^5.0.0",
+    "ts-jest": "^29.1.0",
+    "ts-node": "^10.9.1",
+    "typescript": "^5.0.4"
   }
 }

package/src/index.js

@@ -1,5 +0,0 @@
-"use strict";
-const PyRange = require("./py-range.js");
-
-module.exports = PyRange;
-module.exports.PyRange = PyRange;