@naturalcycles/js-lib 15.7.0 → 15.8.0

package/dist/array/range.d.ts

@@ -1,5 +1,7 @@
 import { AsyncIterable2 } from '../iter/asyncIterable2.js';
 import { Iterable2 } from '../iter/iterable2.js';
+import type { Primitive } from '../typeFest.js';
+import type { Integer } from '../types.js';
 /**
  * Returns an array with ranges from `from` up to (but not including) `to`.
  *
@@ -10,15 +12,24 @@ import { Iterable2 } from '../iter/iterable2.js';
  * range(3, 6) // [ 3, 4, 5 ]
  * range(1, 10, 2) // [ 1, 3, 5, 7, 9 ]
  */
-export declare function _range(toExcl: number): number[];
-export declare function _range(fromIncl: number, toExcl: number, step?: number): number[];
+export declare function _range(toExcl: Integer): number[];
+export declare function _range(fromIncl: Integer, toExcl: Integer, step?: number): number[];
+/**
+ * Returns an array of `length` filled with `fill` primitive value.
+ * Performance-optimized implementation.
+ * `Array.from({ length }, () => fill)` shows ~25x perf regression in benchmarks
+ *
+ * Fill is Primitive, because it's safe to shallow-copy.
+ * If it was an object - it'll paste the same object reference, which can create bugs.
+ */
+export declare function _rangeFilled<T extends Primitive>(length: Integer, fill: T): T[];
 /**
  * Like _range, but returns an Iterable2.
  */
-export declare function _rangeIterable(toExcl: number): Iterable2<number>;
-export declare function _rangeIterable(fromIncl: number, toExcl: number, step?: number): Iterable2<number>;
+export declare function _rangeIterable(toExcl: Integer): Iterable2<number>;
+export declare function _rangeIterable(fromIncl: Integer, toExcl: Integer, step?: number): Iterable2<number>;
 /**
  * Like _range, but returns an AsyncIterable2.
  */
-export declare function _rangeAsyncIterable(toExcl: number): AsyncIterable2<number>;
-export declare function _rangeAsyncIterable(fromIncl: number, toExcl: number, step?: number): AsyncIterable2<number>;
+export declare function _rangeAsyncIterable(toExcl: Integer): AsyncIterable2<number>;
+export declare function _rangeAsyncIterable(fromIncl: Integer, toExcl: Integer, step?: number): AsyncIterable2<number>;

package/dist/array/range.js

@@ -2,9 +2,26 @@ import { AsyncIterable2 } from '../iter/asyncIterable2.js';
 import { Iterable2 } from '../iter/iterable2.js';
 export function _range(fromIncl, toExcl, step = 1) {
     if (toExcl === undefined) {
-        return Array.from(new Array(fromIncl), (_, i) => i);
+        toExcl = fromIncl;
+        fromIncl = 0;
     }
-    return Array.from({ length: Math.ceil((toExcl - fromIncl) / step) }, (_, i) => i * step + fromIncl);
+    const a = [];
+    for (let i = fromIncl; i < toExcl; i += step) {
+        a.push(i);
+    }
+    return a;
+}
+/**
+ * Returns an array of `length` filled with `fill` primitive value.
+ * Performance-optimized implementation.
+ * `Array.from({ length }, () => fill)` shows ~25x perf regression in benchmarks
+ *
+ * Fill is Primitive, because it's safe to shallow-copy.
+ * If it was an object - it'll paste the same object reference, which can create bugs.
+ */
+export function _rangeFilled(length, fill) {
+    // biome-ignore lint/style/useConsistentBuiltinInstantiation: ok
+    return Array(length).fill(fill);
 }
 export function _rangeIterable(fromIncl, toExcl, step = 1) {
     if (toExcl === undefined) {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@naturalcycles/js-lib",
   "type": "module",
-  "version": "15.7.0",
+  "version": "15.8.0",
   "dependencies": {
     "tslib": "^2",
     "zod": "^3"

package/src/array/range.ts

@@ -1,7 +1,7 @@
 import { AsyncIterable2 } from '../iter/asyncIterable2.js'
 import { Iterable2 } from '../iter/iterable2.js'
-
-/* eslint-disable unicorn/no-new-array */
+import type { Primitive } from '../typeFest.js'
+import type { Integer } from '../types.js'
 
 /**
  * Returns an array with ranges from `from` up to (but not including) `to`.
@@ -13,25 +13,40 @@ import { Iterable2 } from '../iter/iterable2.js'
  * range(3, 6) // [ 3, 4, 5 ]
  * range(1, 10, 2) // [ 1, 3, 5, 7, 9 ]
  */
-export function _range(toExcl: number): number[]
-export function _range(fromIncl: number, toExcl: number, step?: number): number[]
-export function _range(fromIncl: number, toExcl?: number, step = 1): number[] {
+export function _range(toExcl: Integer): number[]
+export function _range(fromIncl: Integer, toExcl: Integer, step?: number): number[]
+export function _range(fromIncl: Integer, toExcl?: Integer, step = 1): number[] {
   if (toExcl === undefined) {
-    return Array.from(new Array(fromIncl), (_, i) => i)
+    toExcl = fromIncl
+    fromIncl = 0
   }
 
-  return Array.from(
-    { length: Math.ceil((toExcl - fromIncl) / step) },
-    (_, i) => i * step + fromIncl,
-  )
+  const a: number[] = []
+  for (let i = fromIncl; i < toExcl; i += step) {
+    a.push(i)
+  }
+  return a
+}
+
+/**
+ * Returns an array of `length` filled with `fill` primitive value.
+ * Performance-optimized implementation.
+ * `Array.from({ length }, () => fill)` shows ~25x perf regression in benchmarks
+ *
+ * Fill is Primitive, because it's safe to shallow-copy.
+ * If it was an object - it'll paste the same object reference, which can create bugs.
+ */
+export function _rangeFilled<T extends Primitive>(length: Integer, fill: T): T[] {
+  // biome-ignore lint/style/useConsistentBuiltinInstantiation: ok
+  return Array(length).fill(fill)
 }
 
 /**
  * Like _range, but returns an Iterable2.
  */
-export function _rangeIterable(toExcl: number): Iterable2<number>
-export function _rangeIterable(fromIncl: number, toExcl: number, step?: number): Iterable2<number>
-export function _rangeIterable(fromIncl: number, toExcl?: number, step = 1): Iterable2<number> {
+export function _rangeIterable(toExcl: Integer): Iterable2<number>
+export function _rangeIterable(fromIncl: Integer, toExcl: Integer, step?: number): Iterable2<number>
+export function _rangeIterable(fromIncl: Integer, toExcl?: Integer, step = 1): Iterable2<number> {
   if (toExcl === undefined) {
     toExcl = fromIncl
     fromIncl = 0
@@ -49,15 +64,15 @@ export function _rangeIterable(fromIncl: number, toExcl?: number, step = 1): Ite
 /**
  * Like _range, but returns an AsyncIterable2.
  */
-export function _rangeAsyncIterable(toExcl: number): AsyncIterable2<number>
+export function _rangeAsyncIterable(toExcl: Integer): AsyncIterable2<number>
 export function _rangeAsyncIterable(
-  fromIncl: number,
-  toExcl: number,
+  fromIncl: Integer,
+  toExcl: Integer,
   step?: number,
 ): AsyncIterable2<number>
 export function _rangeAsyncIterable(
-  fromIncl: number,
-  toExcl?: number,
+  fromIncl: Integer,
+  toExcl?: Integer,
   step = 1,
 ): AsyncIterable2<number> {
   if (toExcl === undefined) {