@naturalcycles/js-lib 15.7.1 → 15.8.1

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 _arrayFilled<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

@@ -11,6 +11,18 @@ export function _range(fromIncl, toExcl, step = 1) {
     }
     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 _arrayFilled(length, fill) {
+    // biome-ignore lint/style/useConsistentBuiltinInstantiation: ok
+    return Array(length).fill(fill);
+}
 export function _rangeIterable(fromIncl, toExcl, step = 1) {
     if (toExcl === undefined) {
         toExcl = fromIncl;

package/package.json

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

package/src/array/range.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`.
@@ -11,9 +13,9 @@ 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) {
     toExcl = fromIncl
     fromIncl = 0
@@ -26,12 +28,25 @@ export function _range(fromIncl: number, toExcl?: number, step = 1): number[] {
   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 _arrayFilled<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) {