range-pie 1.0.1 → 2.0.0

package/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2024 SkorpionG2000
+Copyright (c) 2025 SkorpionG2000
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

package/README.md

@@ -1,11 +1,15 @@
 # range-pie
 
-A JavaScript library that brings Python's range functionality to JavaScript, enhanced with familiar array methods. This lightweight utility provides a seamless way to work with numeric sequences while maintaining JavaScript's functional programming paradigm.
+A TypeScript/JavaScript library that brings Python's range functionality to JavaScript, enhanced with familiar array methods. This lightweight utility provides a seamless way to work with numeric sequences while maintaining JavaScript's functional programming paradigm. Fully typed for TypeScript users while remaining compatible with JavaScript projects.
 
 ## Table of Contents
 
 - [Installation](#installation)
 - [Basic Usage](#basic-usage)
+
+  - [JavaScript](#javascript)
+  - [TypeScript](#typescript)
+
 - [API Reference](#api-reference)
 
   - [Constructor Options](#constructor-options)
@@ -36,6 +40,9 @@ A JavaScript library that brings Python's range functionality to JavaScript, enh
 
   - [Methods chaining](#methods-chaining)
   - [Using as Array-like Object](#using-as-array-like-object)
+  - [Example Files](#example-files)
+    - [Running the Examples](#running-the-examples)
+    - [Available Examples](#available-examples)
 
 ## Installation
 
@@ -45,7 +52,10 @@ npm install range-pie
 
 ## Basic Usage
 
+### JavaScript
+
 ```javascript
+// CommonJS
 const { PyRange } = require('range-pie');
 
 // Create a range from 0 to 5
@@ -61,6 +71,25 @@ const range3 = new PyRange(0, 10, 2);
 console.log([...range3]); // [0, 2, 4, 6, 8]
 ```
 
+### TypeScript
+
+```typescript
+// ES Modules
+import { PyRange } from 'range-pie';
+
+// Create a range from 0 to 5
+const range = new PyRange(5);
+console.log([...range]); // [0, 1, 2, 3, 4]
+
+// Type-safe operations
+const doubledValues: number[] = range.map(x => x * 2);
+console.log(doubledValues); // [0, 2, 4, 6, 8]
+
+// Type inference works with generics
+const stringValues: string[] = range.map(x => `Value: ${x}`);
+console.log(stringValues); // ['Value: 0', 'Value: 1', 'Value: 2', 'Value: 3', 'Value: 4']
+```
+
 ## API Reference
 
 ### Constructor Options
@@ -304,6 +333,29 @@ console.log(proxy[0]); // 0
 console.log(proxy[3]); // 3
 ```
 
+### TypeScript Support
+
+This package is written in TypeScript and provides full type definitions for all methods and properties. TypeScript users get the following benefits:
+
+- Type checking for all method parameters and return values
+- Autocompletion in IDEs
+- Generic type support for methods like `map()` and `reduce()`
+- Better documentation through type annotations
+
+```typescript
+// Type inference with generics
+const range = new PyRange(5);
+
+// TypeScript knows this is a number[]
+const numbers = range.map(x => x * 2);
+
+// TypeScript knows this is a string[]
+const strings = range.map(x => `Number: ${x}`);
+
+// TypeScript knows this is a boolean[]
+const booleans = range.map(x => x % 2 === 0);
+```
+
 ## Examples
 
 ### Methods chaining
@@ -323,3 +375,43 @@ const range = new PyRange(5).asProxy();
 const firstThree = [range[0], range[1], range[2]];
 console.log(firstThree); // [0, 1, 2]
 ```
+
+### Example Files
+
+This package includes several example files to help you get started. You can find them in the `examples` directory after installing the package.
+
+#### Running the Examples
+
+If you've cloned the repository, you can run the examples using npm scripts:
+
+```bash
+# Run basic usage examples
+npm run example:basic
+
+# Run array methods examples
+npm run example:array
+
+# Run advanced usage examples
+npm run example:advanced
+
+# Run TypeScript examples (requires ts-node)
+npm run example:ts
+```
+
+Or you can run them directly with Node.js:
+
+```bash
+node node_modules/range-pie/examples/basic-usage.js
+node node_modules/range-pie/examples/array-methods.js
+node node_modules/range-pie/examples/advanced-usage.js
+
+# For TypeScript examples
+ts-node node_modules/range-pie/examples/typescript-usage.ts
+```
+
+#### Available Examples
+
+- **basic-usage.js**: Shows fundamental PyRange operations
+- **array-methods.js**: Demonstrates all array-like methods
+- **advanced-usage.js**: Covers advanced features like method chaining and proxy usage
+- **typescript-usage.ts**: Shows TypeScript-specific features and type safety

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+import PyRange, { PyRange as PyRangeClass } from "./py-range";
+export { PyRangeClass as PyRange };
+export default PyRange;

package/dist/index.js

@@ -0,0 +1,40 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PyRange = void 0;
+const py_range_1 = __importStar(require("./py-range"));
+Object.defineProperty(exports, "PyRange", { enumerable: true, get: function () { return py_range_1.PyRange; } });
+exports.default = py_range_1.default;
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,uDAA8D;AAGrC,wFAHI,kBAAY,OAGT;AAChC,kBAAe,kBAAO,CAAC"}

package/dist/py-range.d.ts

@@ -0,0 +1,185 @@
+/**
+ * A class that simulates Python's range function, combined with several useful JavaScript array methods.
+ */
+declare class PyRange implements Iterable<number> {
+    private _start;
+    private _stop;
+    private _step;
+    private _length;
+    /**
+     * 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: number[]);
+    /**
+     * Gets the length of this range.
+     *
+     * @returns {number} the length of this range
+     * @readonly
+     */
+    get length(): number;
+    /**
+     * Gets the starting value of the range.
+     *
+     * @returns {number} The starting value of the range.
+     * @readonly
+     */
+    get start(): number;
+    /**
+     * Gets the ending value of the range.
+     *
+     * @returns {number} The ending value of the range.
+     * @readonly
+     */
+    get stop(): number;
+    /**
+     * Gets the step value of the range.
+     *
+     * @returns {number} The step value of the range.
+     * @readonly
+     */
+    get step(): number;
+    /**
+     * 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: number): number;
+    /**
+     * Converts the range to a string.
+     * @returns {string} A string of the form `Range(start, stop, step)`.
+     */
+    toString(): string;
+    /**
+     * Converts the range to an array.
+     * @returns {number[]} An array of numbers with the same elements as this range.
+     */
+    toArray(): number[];
+    /**
+     * Validates that the callback is a function.
+     * @param {Function} cb - The callback to validate.
+     * @throws {TypeError} If the callback is not a function.
+     */
+    private static validateCb;
+    /**
+     * 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<T>(callback: (value: number, index: number, range: PyRange) => T): T[];
+    /**
+     * 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: (value: number, index: number, range: PyRange) => boolean): number[];
+    /**
+     * 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<T>(callback: (accumulator: T, value: number, index: number, range: PyRange) => T, initialValue?: T): T;
+    /**
+     * 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: (value: number, index: number, range: PyRange) => boolean): boolean;
+    /**
+     * 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: (value: number, index: number, range: PyRange) => boolean): boolean;
+    /**
+     * 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: (value: number, index: number, range: PyRange) => boolean): number | 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: (value: number, index: number, range: PyRange) => boolean): number;
+    /**
+     * 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: (value: number, index: number, range: PyRange) => boolean): number;
+    /**
+     * 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: (value: number, index: number, range: PyRange) => void): void;
+    /**
+     * 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: any): boolean;
+    /**
+     * 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: any): number;
+    /**
+     * 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: any): number;
+    /**
+     * 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(): PyRange;
+    /**
+     * Implements the iterable protocol for this range.
+     * @returns {Iterator<number>} An iterator for this range.
+     */
+    [Symbol.iterator](): Iterator<number>;
+    /**
+     * 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(): any;
+}
+export { PyRange };
+export default PyRange;

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/package.json

@@ -1,16 +1,30 @@
 {
   "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.0",
+  "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"
+  ],
   "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 +34,22 @@
     "JavaScript Array",
     "Array",
     "py-range",
-    "PyRange"
+    "PyRange",
+    "TypeScript"
   ],
   "author": "SkorpionG2000",
   "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "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;

package/src/py-range.js

@@ -1,376 +0,0 @@
-"use strict";
-
-class PyRange {
-  /**
-   * A class that simulate Python's range function, combined with several useful JavaScript array methods.
-   * @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];
-  }
-
-  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): *} callback - The callback
-   * function to apply to every element.
-   * @returns {Array.<*>} A new array of the same length as this range.
-   */
-  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++) {
-      if (callback(this.at(i), i, this)) {
-        result.push(this.at(i));
-      }
-    }
-
-    return result;
-  }
-
-  /**
-   * Reduces the range to a single value.
-   * @param {function(*, number, number, PyRange): *} 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 {*} [initialValue] - The initial value of the accumulator.
-   * @returns {*} The final value of the accumulator.
-   */
-  reduce(callback, initialValue) {
-    PyRange.#validateCb(callback);
-
-    let accumulator = initialValue;
-
-    for (let i = 0; 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 {*} 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 {*} 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 {*} 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);
-    result._length = this._length;
-    return result;
-  }
-
-  [Symbol.iterator]() {
-    let index = 0;
-    let current = this._start;
-    const { _stop: _, _step: step, _length: length } = this;
-
-    return {
-      next: () => {
-        if (index >= length) {
-          return { done: true };
-        } 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 {Proxy} A proxy for the PyRange instance.
-   */
-  asProxy() {
-    return new Proxy(this, {
-      get(target, prop) {
-        if (typeof prop === "symbol") {
-          return target[prop];
-        }
-        if (!isNaN(prop)) {
-          return target.at(parseInt(prop));
-        }
-        return target[prop];
-      },
-    });
-  }
-}
-
-module.exports = PyRange;
-module.exports.PyRange = PyRange;