iterable-linq-utility 0.1.0 → 0.2.0

package/dist/index.d.cts

@@ -433,6 +433,19 @@ export declare interface IIterableLinqBase<T> {
      * @since 0.0.8
      */
     min(comparer?: Comparer<T>): T | undefined;
+    /**
+     * Runs the chain and accumulates its values into a single result, starting from the first value.
+     * @operation `Action`
+     * @param reducer - called with the accumulator, each value from the second one and its index (starting at 1); returns the new accumulator
+     * @returns the final accumulator; the only value when the chain has one value, without calling `reducer`
+     * @throws Error if the chain is empty or if `reducer` is not a function
+     * @example
+     * ```ts
+     * IterableLinq.from([3, 7, 2]).reduce((acc, v) => (v > acc ? v : acc)); // 7
+     * ```
+     * @since 0.2.0
+     */
+    reduce(reducer: Reducer<T, T>): T;
     /**
      * Runs the chain and accumulates its values into a single result.
      * @operation `Action`
@@ -702,6 +715,21 @@ declare function range(end: number, options?: IRangeOptions): Iterable<number>;
  */
 declare function range(start: number, end: number, options?: IRangeOptions): Iterable<number>;
 
+/**
+ * Accumulates the values of `iterable` into a single result, starting from the first value.
+ * @operation `Action`
+ * @param iterable - the source `Iterable`
+ * @param reducer - called with the accumulator, each value from the second one and its index (starting at 1); returns the new accumulator
+ * @returns the final accumulator; the only value when `iterable` has one value, without calling `reducer`
+ * @throws Error if `iterable` is missing, does not implement `[Symbol.iterator]` or is empty, or if `reducer` is not a function
+ * @example
+ * ```ts
+ * Functions.reduce([3, 7, 2], (acc, v) => (v > acc ? v : acc)); // 7
+ * ```
+ * @since 0.2.0
+ */
+declare function reduce<T>(iterable: Iterable<T>, reducer: Reducer<T, T>): T;
+
 /**
  * Accumulates the values of `iterable` into a single result.
  * @operation `Action`

package/dist/index.d.ts

@@ -433,6 +433,19 @@ export declare interface IIterableLinqBase<T> {
      * @since 0.0.8
      */
     min(comparer?: Comparer<T>): T | undefined;
+    /**
+     * Runs the chain and accumulates its values into a single result, starting from the first value.
+     * @operation `Action`
+     * @param reducer - called with the accumulator, each value from the second one and its index (starting at 1); returns the new accumulator
+     * @returns the final accumulator; the only value when the chain has one value, without calling `reducer`
+     * @throws Error if the chain is empty or if `reducer` is not a function
+     * @example
+     * ```ts
+     * IterableLinq.from([3, 7, 2]).reduce((acc, v) => (v > acc ? v : acc)); // 7
+     * ```
+     * @since 0.2.0
+     */
+    reduce(reducer: Reducer<T, T>): T;
     /**
      * Runs the chain and accumulates its values into a single result.
      * @operation `Action`
@@ -702,6 +715,21 @@ declare function range(end: number, options?: IRangeOptions): Iterable<number>;
  */
 declare function range(start: number, end: number, options?: IRangeOptions): Iterable<number>;
 
+/**
+ * Accumulates the values of `iterable` into a single result, starting from the first value.
+ * @operation `Action`
+ * @param iterable - the source `Iterable`
+ * @param reducer - called with the accumulator, each value from the second one and its index (starting at 1); returns the new accumulator
+ * @returns the final accumulator; the only value when `iterable` has one value, without calling `reducer`
+ * @throws Error if `iterable` is missing, does not implement `[Symbol.iterator]` or is empty, or if `reducer` is not a function
+ * @example
+ * ```ts
+ * Functions.reduce([3, 7, 2], (acc, v) => (v > acc ? v : acc)); // 7
+ * ```
+ * @since 0.2.0
+ */
+declare function reduce<T>(iterable: Iterable<T>, reducer: Reducer<T, T>): T;
+
 /**
  * Accumulates the values of `iterable` into a single result.
  * @operation `Action`

package/dist/iterable-linq-utility.js

@@ -57,21 +57,21 @@ function c(e) {
 function l(e, t) {
 	if (!n(e)) throw Error(`The "${t}" function must be provided`);
 }
-function u(e, t) {
+function ee(e, t) {
 	if (!Number.isInteger(e) || e < 0) throw Error(`The "${t}" parameter must be a non-negative integer`);
 }
-function d(e, t) {
+function u(e, t) {
 	if (!Number.isFinite(e) || e === 0) throw Error(`The "${t}" parameter must be a finite number other than 0`);
 }
-function ee(e, t) {
+function te(e, t) {
 	if (typeof e != "object" || !e) throw Error(`The "${t}" parameter must be an object`);
 }
-function te(e, t) {
+function ne(e, t) {
 	if (typeof e != "string" || e.length === 0) throw Error(`The "${t}" parameter must be a non-empty string`);
 }
 //#endregion
 //#region src/functions/collectToArray.ts
-function f(e) {
+function d(e) {
 	if (c(e), Array.isArray(e) || e instanceof Set) return Array.from(e);
 	let t = [];
 	for (let n of e) t.push(n);
@@ -79,7 +79,7 @@ function f(e) {
 }
 //#endregion
 //#region src/iterators/baseIterator.ts
-var p = class {
+var f = class {
 	done = !1;
 	next() {
 		if (this.done) return s();
@@ -101,7 +101,7 @@ var p = class {
 			} catch {}
 		}
 	}
-}, m = class {
+}, p = class {
 	createIterator;
 	constructor(e) {
 		this.createIterator = e;
@@ -109,7 +109,7 @@ var p = class {
 	[Symbol.iterator]() {
 		return this.createIterator();
 	}
-}, h = class extends p {
+}, m = class extends f {
 	source;
 	index = 0;
 	constructor(e) {
@@ -121,10 +121,10 @@ var p = class {
 };
 //#endregion
 //#region src/iterators/unfold.ts
-function g(e, t) {
-	return new m(() => new ne(e, t));
+function h(e, t) {
+	return new p(() => new g(e, t));
 }
-var ne = class extends p {
+var g = class extends f {
 	state;
 	step;
 	constructor(e, t) {
@@ -138,14 +138,14 @@ var ne = class extends p {
 //#endregion
 //#region src/functions/empty.ts
 function _() {
-	return g(void 0, () => void 0);
+	return h(void 0, () => void 0);
 }
 //#endregion
 //#region src/functions/filter.ts
 function v(e, t) {
-	return c(e), l(t, "predicate"), new m(() => new re(e, t));
+	return c(e), l(t, "predicate"), new p(() => new y(e, t));
 }
-var re = class extends h {
+var y = class extends m {
 	predicate;
 	constructor(e, t) {
 		super(e), this.predicate = t;
@@ -165,10 +165,10 @@ var re = class extends h {
 };
 //#endregion
 //#region src/functions/flatMap.ts
-function y(e, t) {
-	return c(e), l(t, "mapper"), new m(() => new b(e, t));
+function b(e, t) {
+	return c(e), l(t, "mapper"), new p(() => new re(e, t));
 }
-var b = class e extends h {
+var re = class e extends m {
 	mapper;
 	static steps = {
 		outer: (t) => {
@@ -257,9 +257,9 @@ async function w(e, t) {
 //#endregion
 //#region src/functions/map.ts
 function T(e, t) {
-	return c(e), l(t, "mapper"), new m(() => new ie(e, t));
+	return c(e), l(t, "mapper"), new p(() => new E(e, t));
 }
-var ie = class extends h {
+var E = class extends m {
 	mapper;
 	constructor(e, t) {
 		super(e), this.mapper = t;
@@ -278,18 +278,18 @@ var ie = class extends h {
 };
 //#endregion
 //#region src/collections/linkedList.ts
-function E(e) {
+function D(e) {
 	c(e);
-	let t = new D();
+	let t = new ie();
 	for (let n of e) t.addLast(n);
 	return t;
 }
-var D = class {
+var ie = class {
 	internalSize = 0;
 	head = null;
 	tail = null;
 	[Symbol.iterator]() {
-		return new O(this.head);
+		return new ae(this.head);
 	}
 	addFirst(e) {
 		let t = {
@@ -308,7 +308,7 @@ var D = class {
 	size() {
 		return this.internalSize;
 	}
-}, O = class extends p {
+}, ae = class extends f {
 	current;
 	constructor(e) {
 		super(), this.current = e;
@@ -320,13 +320,13 @@ var D = class {
 };
 //#endregion
 //#region src/functions/materialize.ts
-function k(e) {
-	return c(e), e instanceof A ? e : new A(e);
+function O(e) {
+	return c(e), e instanceof k ? e : new k(e);
 }
-var A = class {
+var k = class {
 	source;
 	constructor(e) {
-		this.source = E(e);
+		this.source = D(e);
 	}
 	[Symbol.iterator]() {
 		return this.source[Symbol.iterator]();
@@ -334,29 +334,29 @@ var A = class {
 };
 //#endregion
 //#region src/functions/max.ts
-function j(e, t) {
+function A(e, t) {
 	return c(e), a(e, i(t), 1);
 }
 //#endregion
 //#region src/functions/memoize.ts
-function M() {
+function j() {
 	return { allowPartialMemoization: !0 };
 }
-function N(e, t) {
+function M(e, t) {
 	c(e);
 	let n = {
-		...M(),
+		...j(),
 		...t
 	}.allowPartialMemoization;
-	return e instanceof I ? n ? e.changePartialMemoizationBehaviour() : e : e instanceof L ? n ? e : e.changePartialMemoizationBehaviour() : n ? new L(e) : new I(e);
+	return e instanceof F ? n ? e.changePartialMemoizationBehaviour() : e : e instanceof I ? n ? e : e.changePartialMemoizationBehaviour() : n ? new I(e) : new F(e);
 }
-function P() {
+function N() {
 	return {
 		values: [],
 		finished: !1
 	};
 }
-function F(e, t) {
+function P(e, t) {
 	if (t.error) throw t.error.value;
 	if (t.finished) return !1;
 	t.source ??= e[Symbol.iterator]();
@@ -368,31 +368,31 @@ function F(e, t) {
 	}
 	return n.done === !0 ? (t.finished = !0, t.source = void 0, !1) : (t.values.push(n.value), !0);
 }
-var I = class {
+var F = class {
 	source;
-	cache = P();
+	cache = N();
 	constructor(e) {
 		this.source = e;
 	}
 	[Symbol.iterator]() {
-		return new R(this.source, this.cache, !0);
+		return new L(this.source, this.cache, !0);
 	}
 	changePartialMemoizationBehaviour() {
-		return new L(this.source);
+		return new I(this.source);
 	}
-}, L = class {
+}, I = class {
 	source;
-	cache = P();
+	cache = N();
 	constructor(e) {
 		this.source = e;
 	}
 	[Symbol.iterator]() {
-		return new R(this.source, this.cache, !1);
+		return new L(this.source, this.cache, !1);
 	}
 	changePartialMemoizationBehaviour() {
-		return new I(this.source);
+		return new F(this.source);
 	}
-}, R = class extends p {
+}, L = class extends f {
 	source;
 	cache;
 	drainFirst;
@@ -401,28 +401,28 @@ var I = class {
 		super(), this.source = e, this.cache = t, this.drainFirst = n;
 	}
 	advance() {
-		if (this.drainFirst) for (; F(this.source, this.cache););
-		return this.index < this.cache.values.length || F(this.source, this.cache) ? o(this.cache.values[this.index++]) : s();
+		if (this.drainFirst) for (; P(this.source, this.cache););
+		return this.index < this.cache.values.length || P(this.source, this.cache) ? o(this.cache.values[this.index++]) : s();
 	}
 };
 //#endregion
 //#region src/functions/min.ts
-function z(e, t) {
+function R(e, t) {
 	return c(e), a(e, i(t), -1);
 }
 //#endregion
 //#region src/functions/range.ts
-function B(e, t, n) {
+function z(e, t, n) {
 	let r = typeof t == "number", i = r ? e : 0, a = r ? t : e;
 	if (!r && n !== void 0) throw Error("The \"options\" parameter must be the second argument when \"start\" is omitted");
 	let o = r ? n : t;
-	o !== void 0 && ee(o, "options");
+	o !== void 0 && te(o, "options");
 	let { step: s = 1, reverse: c = !1 } = o ?? {};
-	d(s, "step");
-	let l = ae(i, a, Math.abs(s), c);
-	return l.length > 0 ? new m(() => new oe(l.first, l.step, l.length)) : _();
+	u(s, "step");
+	let l = oe(i, a, Math.abs(s), c);
+	return l.length > 0 ? new p(() => new se(l.first, l.step, l.length)) : _();
 }
-function ae(e, t, n, r) {
+function oe(e, t, n, r) {
 	let i = t < e ? -n : n, a = Math.ceil(Math.abs(t - e) / n);
 	return r ? {
 		first: e + (a - 1) * i,
@@ -434,7 +434,7 @@ function ae(e, t, n, r) {
 		length: a
 	};
 }
-var oe = class extends p {
+var se = class extends f {
 	first;
 	step;
 	length;
@@ -448,16 +448,25 @@ var oe = class extends p {
 };
 //#endregion
 //#region src/functions/reduce.ts
-function V(e, t, n) {
-	c(e), l(n, "reducer");
-	let r = t, i = 0;
-	for (let t of e) r = n(r, t, i++);
-	return r;
+function B(e, ...t) {
+	if (c(e), t.length === 1) return V(e, t[0]);
+	let [n, r] = t;
+	l(r, "reducer");
+	let i = n, a = 0;
+	for (let t of e) i = r(i, t, a++);
+	return i;
+}
+function V(e, t) {
+	l(t, "reducer");
+	let n, r = 0;
+	for (let i of e) n = r === 0 ? i : t(n, i, r), r++;
+	if (r === 0) throw Error("The \"sourceIterable\" must not be empty when \"reduce\" has no seed");
+	return n;
 }
 //#endregion
 //#region src/functions/repeat.ts
 function H(e, t) {
-	return u(t, "count"), g(t, (t) => t > 0 ? [e, t - 1] : void 0);
+	return ee(t, "count"), h(t, (t) => t > 0 ? [e, t - 1] : void 0);
 }
 //#endregion
 //#region src/functions/some.ts
@@ -470,9 +479,9 @@ function U(e, t) {
 //#endregion
 //#region src/functions/tap.ts
 function W(e, t) {
-	return c(e), l(t, "tapper"), new m(() => new G(e, t));
+	return c(e), l(t, "tapper"), new p(() => new G(e, t));
 }
-var G = class extends h {
+var G = class extends m {
 	tapper;
 	constructor(e, t) {
 		super(e), this.tapper = t;
@@ -491,25 +500,25 @@ var G = class extends h {
 //#endregion
 //#region src/functions/tapChain.ts
 function K(e, t) {
-	return c(e), l(t, "tapper"), new m(() => (t(e, 0), e[Symbol.iterator]()));
+	return c(e), l(t, "tapper"), new p(() => (t(e, 0), e[Symbol.iterator]()));
 }
 //#endregion
 //#region src/functions/index.ts
-var se = /* @__PURE__ */ t({
-	collectToArray: () => f,
+var ce = /* @__PURE__ */ t({
+	collectToArray: () => d,
 	empty: () => _,
 	filter: () => v,
-	flatMap: () => y,
+	flatMap: () => b,
 	forEach: () => C,
 	forEachAsync: () => w,
-	getMemoizeDefaultOptions: () => M,
+	getMemoizeDefaultOptions: () => j,
 	map: () => T,
-	materialize: () => k,
-	max: () => j,
-	memoize: () => N,
-	min: () => z,
-	range: () => B,
-	reduce: () => V,
+	materialize: () => O,
+	max: () => A,
+	memoize: () => M,
+	min: () => R,
+	range: () => z,
+	reduce: () => B,
 	repeat: () => H,
 	some: () => U,
 	tap: () => W,
@@ -529,13 +538,13 @@ var Y = class {
 		return this.iterable[Symbol.iterator]();
 	}
 	collectToArray() {
-		return f(this.iterable);
+		return d(this.iterable);
 	}
 	filter(e) {
 		return J(v(this.iterable, e));
 	}
 	flatMap(e) {
-		return J(y(this.iterable, e));
+		return J(b(this.iterable, e));
 	}
 	forEach(e) {
 		return C(this.iterable, e);
@@ -547,19 +556,19 @@ var Y = class {
 		return J(T(this.iterable, e));
 	}
 	materialize() {
-		return J(k(this.iterable));
+		return J(O(this.iterable));
 	}
 	max(e) {
-		return j(this.iterable, e);
+		return A(this.iterable, e);
 	}
 	memoize(e) {
-		return J(N(this.iterable, e));
+		return J(M(this.iterable, e));
 	}
 	min(e) {
-		return z(this.iterable, e);
+		return R(this.iterable, e);
 	}
-	reduce(e, t) {
-		return V(this.iterable, e, t);
+	reduce(...e) {
+		return e.length === 1 ? B(this.iterable, e[0]) : B(this.iterable, e[0], e[1]);
 	}
 	some(e) {
 		return U(this.iterable, e);
@@ -587,7 +596,7 @@ Object.defineProperty(Y.prototype, q, {
 function X() {
 	return Y.prototype;
 }
-function ce(e) {
+function le(e) {
 	return typeof e == "object" && !!e && e[q] === !0;
 }
 function Z(e, t) {
@@ -600,13 +609,13 @@ function Z(e, t) {
 	});
 }
 function Q(e, t) {
-	te(e, "name"), l(t, "implementation");
+	ne(e, "name"), l(t, "implementation");
 }
-function le(e, t) {
+function ue(e, t) {
 	if (Q(e, t), e in J([])) throw Error(`"${e}" already exists on IIterableLinq: use override() to replace it`);
 	Z(e, t);
 }
-function ue(e, t) {
+function de(e, t) {
 	Q(e, t);
 	let n = e;
 	if (!(n !== "constructor" && Object.prototype.hasOwnProperty.call(X(), n))) throw Error(`"${n}" is not a method of IIterableLinq: use extend() to add it`);
@@ -614,19 +623,19 @@ function ue(e, t) {
 }
 //#endregion
 //#region src/index.ts
-function de() {
+function fe() {
 	return $(_());
 }
 function $(e) {
 	return c(e), J(e);
 }
-function fe(e, t, n) {
-	if (typeof t == "number") return $(B(e, t, n));
+function pe(e, t, n) {
+	if (typeof t == "number") return $(z(e, t, n));
 	if (n !== void 0) throw Error("The \"options\" parameter must be the second argument when \"start\" is omitted");
-	return $(B(e, t));
+	return $(z(e, t));
 }
-function pe(e, t) {
+function me(e, t) {
 	return $(H(e, t));
 }
 //#endregion
-export { se as Functions, x as Unit, de as empty, le as extend, $ as from, fe as fromRange, ce as isIterableLinq, ue as override, pe as repeat, S as unit };
+export { ce as Functions, x as Unit, fe as empty, ue as extend, $ as from, pe as fromRange, le as isIterableLinq, de as override, me as repeat, S as unit };

package/dist/iterable-linq-utility.umd.cjs

@@ -1 +1 @@
-(function(e,t){typeof exports==`object`&&typeof module<`u`?t(exports):typeof define==`function`&&define.amd?define([`exports`],t):(e=typeof globalThis<`u`?globalThis:e||self,t(e.IterableLinq={}))})(this,function(e){Object.defineProperty(e,Symbol.toStringTag,{value:`Module`});var t=Object.defineProperty,n=(e,n)=>{let r={};for(var i in e)t(r,i,{get:e[i],enumerable:!0});return n||t(r,Symbol.toStringTag,{value:`Module`}),r};function r(e){return typeof e==`function`}function i(e,t){return e<t?-1:e===t?0:1}function a(e){if(e==null)return i;if(r(e))return e;let t=Array.isArray(e)?e:[e];return(e,n)=>{for(let r of t){let t=i(e[r],n[r]);if(t!==0)return t}return 0}}function o(e,t,n){let r,i=!1;for(let a of e)!i||r==null&&a!=null?(r=a,i=!0):a!=null&&n*t(r,a)<0&&(r=a);return r}function s(e){return{done:!1,value:e}}function c(e){return{done:!0,value:e}}function l(e){if(e==null)throw Error(`The "sourceIterable" must be provided`);if(!r(e[Symbol.iterator]))throw Error(`The provided "sourceIterable" does not conform to the iterator protocol https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Iteration_protocols#the_iterable_protocol. It must implement the "[Symbol.iterator]" function.`)}function u(e,t){if(!r(e))throw Error(`The "${t}" function must be provided`)}function d(e,t){if(!Number.isInteger(e)||e<0)throw Error(`The "${t}" parameter must be a non-negative integer`)}function f(e,t){if(!Number.isFinite(e)||e===0)throw Error(`The "${t}" parameter must be a finite number other than 0`)}function p(e,t){if(typeof e!=`object`||!e)throw Error(`The "${t}" parameter must be an object`)}function ee(e,t){if(typeof e!=`string`||e.length===0)throw Error(`The "${t}" parameter must be a non-empty string`)}function m(e){if(l(e),Array.isArray(e)||e instanceof Set)return Array.from(e);let t=[];for(let n of e)t.push(n);return t}var h=class{done=!1;next(){if(this.done)return c();let e=this.advance();return e.done===!0&&(this.done=!0),e}return(e){return this.done||(this.done=!0,this.onReturn(e)),c(e)}[Symbol.iterator](){return this}onReturn(e){}closeAfterCallbackError(){if(!this.done){this.done=!0;try{this.onReturn()}catch{}}}},g=class{createIterator;constructor(e){this.createIterator=e}[Symbol.iterator](){return this.createIterator()}},_=class extends h{source;index=0;constructor(e){super(),this.source=e[Symbol.iterator]()}onReturn(e){this.source.return?.(e)}};function v(e,t){return new g(()=>new te(e,t))}var te=class extends h{state;step;constructor(e,t){super(),this.state=e,this.step=t}advance(){let e=this.step(this.state);return e===void 0?c():(this.state=e[1],s(e[0]))}};function y(){return v(void 0,()=>void 0)}function b(e,t){return l(e),u(t,`predicate`),new g(()=>new ne(e,t))}var ne=class extends _{predicate;constructor(e,t){super(e),this.predicate=t}advance(){for(let e=this.source.next();;e=this.source.next()){if(e.done===!0)return e;let t;try{t=this.predicate(e.value,this.index++)}catch(e){throw this.closeAfterCallbackError(),e}if(t)return e}}};function x(e,t){return l(e),u(t,`mapper`),new g(()=>new S(e,t))}var S=class e extends _{mapper;static steps={outer:t=>{let n=t.source.next();if(n.done===!0)return n;let r=e.mapNext(t,n.value);if(r===void 0){t.state=`inner`;return}if(r.length!==0)return t.array=r,t.position=1,t.state=`array`,s(r[0])},inner:t=>{let n=e.nextInner(t);if(n.done!==!0)return n;t.inner=void 0,t.state=`outer`},array:e=>{if(e.position<e.array.length)return s(e.array[e.position++]);e.array=void 0,e.state=`outer`}};state=`outer`;inner;array;position=0;constructor(e,t){super(e),this.mapper=t}advance(){for(;;){let t=e.steps[this.state](this);if(t!==void 0)return t}}onReturn(e){this.array=void 0;try{this.inner?.return?.(e)}finally{super.onReturn(e)}}static mapNext(e,t){try{let n=e.mapper(t,e.index++);if(Array.isArray(n))return n;e.inner=n[Symbol.iterator]();return}catch(t){throw e.closeAfterCallbackError(),t}}static nextInner(e){try{return e.inner.next()}catch(t){throw e.inner=void 0,e.closeAfterCallbackError(),t}}},C=class e{static instance=e.createFrozen();constructor(){}static createFrozen(){let t=new e;return Object.freeze(t),t}};function w(){return C.instance}function T(e,t){l(e),u(t,`action`);let n=0;for(let r of e)t(r,n++);return w()}async function E(e,t){l(e),u(t,`action`);let n=0;for(let r of e)await t(r,n++);return w()}function D(e,t){return l(e),u(t,`mapper`),new g(()=>new O(e,t))}var O=class extends _{mapper;constructor(e,t){super(e),this.mapper=t}advance(){let e=this.source.next();if(e.done===!0)return e;let t;try{t=this.mapper(e.value,this.index++)}catch(e){throw this.closeAfterCallbackError(),e}return s(t)}};function re(e){l(e);let t=new ie;for(let n of e)t.addLast(n);return t}var ie=class{internalSize=0;head=null;tail=null;[Symbol.iterator](){return new ae(this.head)}addFirst(e){let t={data:e,nextNode:this.head};return this.tail===null&&(this.tail=t),this.head=t,this.internalSize++,this}addLast(e){let t={data:e,nextNode:null};return this.tail===null?this.head=t:this.tail.nextNode=t,this.tail=t,this.internalSize++,this}size(){return this.internalSize}},ae=class extends h{current;constructor(e){super(),this.current=e}advance(){let e=this.current;return e===null?c():(this.current=e.nextNode,s(e.data))}};function k(e){return l(e),e instanceof A?e:new A(e)}var A=class{source;constructor(e){this.source=re(e)}[Symbol.iterator](){return this.source[Symbol.iterator]()}};function j(e,t){return l(e),o(e,a(t),1)}function M(){return{allowPartialMemoization:!0}}function N(e,t){l(e);let n={...M(),...t}.allowPartialMemoization;return e instanceof I?n?e.changePartialMemoizationBehaviour():e:e instanceof L?n?e:e.changePartialMemoizationBehaviour():n?new L(e):new I(e)}function P(){return{values:[],finished:!1}}function F(e,t){if(t.error)throw t.error.value;if(t.finished)return!1;t.source??=e[Symbol.iterator]();let n;try{n=t.source.next()}catch(e){throw t.error={value:e},t.source=void 0,e}return n.done===!0?(t.finished=!0,t.source=void 0,!1):(t.values.push(n.value),!0)}var I=class{source;cache=P();constructor(e){this.source=e}[Symbol.iterator](){return new R(this.source,this.cache,!0)}changePartialMemoizationBehaviour(){return new L(this.source)}},L=class{source;cache=P();constructor(e){this.source=e}[Symbol.iterator](){return new R(this.source,this.cache,!1)}changePartialMemoizationBehaviour(){return new I(this.source)}},R=class extends h{source;cache;drainFirst;index=0;constructor(e,t,n){super(),this.source=e,this.cache=t,this.drainFirst=n}advance(){if(this.drainFirst)for(;F(this.source,this.cache););return this.index<this.cache.values.length||F(this.source,this.cache)?s(this.cache.values[this.index++]):c()}};function z(e,t){return l(e),o(e,a(t),-1)}function B(e,t,n){let r=typeof t==`number`,i=r?e:0,a=r?t:e;if(!r&&n!==void 0)throw Error(`The "options" parameter must be the second argument when "start" is omitted`);let o=r?n:t;o!==void 0&&p(o,`options`);let{step:s=1,reverse:c=!1}=o??{};f(s,`step`);let l=oe(i,a,Math.abs(s),c);return l.length>0?new g(()=>new se(l.first,l.step,l.length)):y()}function oe(e,t,n,r){let i=t<e?-n:n,a=Math.ceil(Math.abs(t-e)/n);return r?{first:e+(a-1)*i,step:-i,length:a}:{first:e,step:i,length:a}}var se=class extends h{first;step;length;index=0;constructor(e,t,n){super(),this.first=e,this.step=t,this.length=n}advance(){return this.index>=this.length?c():s(this.first+this.index++*this.step)}};function V(e,t,n){l(e),u(n,`reducer`);let r=t,i=0;for(let t of e)r=n(r,t,i++);return r}function H(e,t){return d(t,`count`),v(t,t=>t>0?[e,t-1]:void 0)}function U(e,t){l(e),u(t,`predicate`);let n=0;for(let r of e)if(t(r,n++))return!0;return!1}function W(e,t){return l(e),u(t,`tapper`),new g(()=>new G(e,t))}var G=class extends _{tapper;constructor(e,t){super(e),this.tapper=t}advance(){let e=this.source.next();if(e.done===!0)return e;try{this.tapper(e.value,this.index++)}catch(e){throw this.closeAfterCallbackError(),e}return e}};function K(e,t){return l(e),u(t,`tapper`),new g(()=>(t(e,0),e[Symbol.iterator]()))}var ce=n({collectToArray:()=>m,empty:()=>y,filter:()=>b,flatMap:()=>x,forEach:()=>T,forEachAsync:()=>E,getMemoizeDefaultOptions:()=>M,map:()=>D,materialize:()=>k,max:()=>j,memoize:()=>N,min:()=>z,range:()=>B,reduce:()=>V,repeat:()=>H,some:()=>U,tap:()=>W,tapChain:()=>K}),q=Symbol.for(`iterable-linq-utility.IIterableLinq`);function J(e){return new Y(e)}var Y=class{iterable;constructor(e){this.iterable=e}[Symbol.iterator](){return this.iterable[Symbol.iterator]()}collectToArray(){return m(this.iterable)}filter(e){return J(b(this.iterable,e))}flatMap(e){return J(x(this.iterable,e))}forEach(e){return T(this.iterable,e)}forEachAsync(e){return E(this.iterable,e)}map(e){return J(D(this.iterable,e))}materialize(){return J(k(this.iterable))}max(e){return j(this.iterable,e)}memoize(e){return J(N(this.iterable,e))}min(e){return z(this.iterable,e)}reduce(e,t){return V(this.iterable,e,t)}some(e){return U(this.iterable,e)}tap(e){return J(W(this.iterable,e))}tapChain(e){return J(K(this.iterable,e))}tapChainCreation(e){u(e,`chainCreationTapper`);let t=this;return e(t),t}};Object.defineProperty(Y.prototype,q,{value:!0,enumerable:!1,writable:!1,configurable:!1});function X(){return Y.prototype}function le(e){return typeof e==`object`&&!!e&&e[q]===!0}function Z(e,t){let n=Object.getOwnPropertyDescriptor(X(),e);Object.defineProperty(X(),e,{value:t,enumerable:!1,writable:n?.writable??!1,configurable:!0})}function Q(e,t){ee(e,`name`),u(t,`implementation`)}function ue(e,t){if(Q(e,t),e in J([]))throw Error(`"${e}" already exists on IIterableLinq: use override() to replace it`);Z(e,t)}function de(e,t){Q(e,t);let n=e;if(!(n!==`constructor`&&Object.prototype.hasOwnProperty.call(X(),n)))throw Error(`"${n}" is not a method of IIterableLinq: use extend() to add it`);Z(n,t)}function fe(){return $(y())}function $(e){return l(e),J(e)}function pe(e,t,n){if(typeof t==`number`)return $(B(e,t,n));if(n!==void 0)throw Error(`The "options" parameter must be the second argument when "start" is omitted`);return $(B(e,t))}function me(e,t){return $(H(e,t))}Object.defineProperty(e,"Functions",{enumerable:!0,get:function(){return ce}}),e.Unit=C,e.empty=fe,e.extend=ue,e.from=$,e.fromRange=pe,e.isIterableLinq=le,e.override=de,e.repeat=me,e.unit=w});
+(function(e,t){typeof exports==`object`&&typeof module<`u`?t(exports):typeof define==`function`&&define.amd?define([`exports`],t):(e=typeof globalThis<`u`?globalThis:e||self,t(e.IterableLinq={}))})(this,function(e){Object.defineProperty(e,Symbol.toStringTag,{value:`Module`});var t=Object.defineProperty,n=(e,n)=>{let r={};for(var i in e)t(r,i,{get:e[i],enumerable:!0});return n||t(r,Symbol.toStringTag,{value:`Module`}),r};function r(e){return typeof e==`function`}function i(e,t){return e<t?-1:e===t?0:1}function a(e){if(e==null)return i;if(r(e))return e;let t=Array.isArray(e)?e:[e];return(e,n)=>{for(let r of t){let t=i(e[r],n[r]);if(t!==0)return t}return 0}}function o(e,t,n){let r,i=!1;for(let a of e)!i||r==null&&a!=null?(r=a,i=!0):a!=null&&n*t(r,a)<0&&(r=a);return r}function s(e){return{done:!1,value:e}}function c(e){return{done:!0,value:e}}function l(e){if(e==null)throw Error(`The "sourceIterable" must be provided`);if(!r(e[Symbol.iterator]))throw Error(`The provided "sourceIterable" does not conform to the iterator protocol https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Iteration_protocols#the_iterable_protocol. It must implement the "[Symbol.iterator]" function.`)}function u(e,t){if(!r(e))throw Error(`The "${t}" function must be provided`)}function d(e,t){if(!Number.isInteger(e)||e<0)throw Error(`The "${t}" parameter must be a non-negative integer`)}function ee(e,t){if(!Number.isFinite(e)||e===0)throw Error(`The "${t}" parameter must be a finite number other than 0`)}function te(e,t){if(typeof e!=`object`||!e)throw Error(`The "${t}" parameter must be an object`)}function ne(e,t){if(typeof e!=`string`||e.length===0)throw Error(`The "${t}" parameter must be a non-empty string`)}function f(e){if(l(e),Array.isArray(e)||e instanceof Set)return Array.from(e);let t=[];for(let n of e)t.push(n);return t}var p=class{done=!1;next(){if(this.done)return c();let e=this.advance();return e.done===!0&&(this.done=!0),e}return(e){return this.done||(this.done=!0,this.onReturn(e)),c(e)}[Symbol.iterator](){return this}onReturn(e){}closeAfterCallbackError(){if(!this.done){this.done=!0;try{this.onReturn()}catch{}}}},m=class{createIterator;constructor(e){this.createIterator=e}[Symbol.iterator](){return this.createIterator()}},h=class extends p{source;index=0;constructor(e){super(),this.source=e[Symbol.iterator]()}onReturn(e){this.source.return?.(e)}};function g(e,t){return new m(()=>new re(e,t))}var re=class extends p{state;step;constructor(e,t){super(),this.state=e,this.step=t}advance(){let e=this.step(this.state);return e===void 0?c():(this.state=e[1],s(e[0]))}};function _(){return g(void 0,()=>void 0)}function v(e,t){return l(e),u(t,`predicate`),new m(()=>new ie(e,t))}var ie=class extends h{predicate;constructor(e,t){super(e),this.predicate=t}advance(){for(let e=this.source.next();;e=this.source.next()){if(e.done===!0)return e;let t;try{t=this.predicate(e.value,this.index++)}catch(e){throw this.closeAfterCallbackError(),e}if(t)return e}}};function y(e,t){return l(e),u(t,`mapper`),new m(()=>new ae(e,t))}var ae=class e extends h{mapper;static steps={outer:t=>{let n=t.source.next();if(n.done===!0)return n;let r=e.mapNext(t,n.value);if(r===void 0){t.state=`inner`;return}if(r.length!==0)return t.array=r,t.position=1,t.state=`array`,s(r[0])},inner:t=>{let n=e.nextInner(t);if(n.done!==!0)return n;t.inner=void 0,t.state=`outer`},array:e=>{if(e.position<e.array.length)return s(e.array[e.position++]);e.array=void 0,e.state=`outer`}};state=`outer`;inner;array;position=0;constructor(e,t){super(e),this.mapper=t}advance(){for(;;){let t=e.steps[this.state](this);if(t!==void 0)return t}}onReturn(e){this.array=void 0;try{this.inner?.return?.(e)}finally{super.onReturn(e)}}static mapNext(e,t){try{let n=e.mapper(t,e.index++);if(Array.isArray(n))return n;e.inner=n[Symbol.iterator]();return}catch(t){throw e.closeAfterCallbackError(),t}}static nextInner(e){try{return e.inner.next()}catch(t){throw e.inner=void 0,e.closeAfterCallbackError(),t}}},b=class e{static instance=e.createFrozen();constructor(){}static createFrozen(){let t=new e;return Object.freeze(t),t}};function x(){return b.instance}function S(e,t){l(e),u(t,`action`);let n=0;for(let r of e)t(r,n++);return x()}async function C(e,t){l(e),u(t,`action`);let n=0;for(let r of e)await t(r,n++);return x()}function w(e,t){return l(e),u(t,`mapper`),new m(()=>new T(e,t))}var T=class extends h{mapper;constructor(e,t){super(e),this.mapper=t}advance(){let e=this.source.next();if(e.done===!0)return e;let t;try{t=this.mapper(e.value,this.index++)}catch(e){throw this.closeAfterCallbackError(),e}return s(t)}};function E(e){l(e);let t=new D;for(let n of e)t.addLast(n);return t}var D=class{internalSize=0;head=null;tail=null;[Symbol.iterator](){return new oe(this.head)}addFirst(e){let t={data:e,nextNode:this.head};return this.tail===null&&(this.tail=t),this.head=t,this.internalSize++,this}addLast(e){let t={data:e,nextNode:null};return this.tail===null?this.head=t:this.tail.nextNode=t,this.tail=t,this.internalSize++,this}size(){return this.internalSize}},oe=class extends p{current;constructor(e){super(),this.current=e}advance(){let e=this.current;return e===null?c():(this.current=e.nextNode,s(e.data))}};function O(e){return l(e),e instanceof k?e:new k(e)}var k=class{source;constructor(e){this.source=E(e)}[Symbol.iterator](){return this.source[Symbol.iterator]()}};function A(e,t){return l(e),o(e,a(t),1)}function j(){return{allowPartialMemoization:!0}}function M(e,t){l(e);let n={...j(),...t}.allowPartialMemoization;return e instanceof F?n?e.changePartialMemoizationBehaviour():e:e instanceof I?n?e:e.changePartialMemoizationBehaviour():n?new I(e):new F(e)}function N(){return{values:[],finished:!1}}function P(e,t){if(t.error)throw t.error.value;if(t.finished)return!1;t.source??=e[Symbol.iterator]();let n;try{n=t.source.next()}catch(e){throw t.error={value:e},t.source=void 0,e}return n.done===!0?(t.finished=!0,t.source=void 0,!1):(t.values.push(n.value),!0)}var F=class{source;cache=N();constructor(e){this.source=e}[Symbol.iterator](){return new L(this.source,this.cache,!0)}changePartialMemoizationBehaviour(){return new I(this.source)}},I=class{source;cache=N();constructor(e){this.source=e}[Symbol.iterator](){return new L(this.source,this.cache,!1)}changePartialMemoizationBehaviour(){return new F(this.source)}},L=class extends p{source;cache;drainFirst;index=0;constructor(e,t,n){super(),this.source=e,this.cache=t,this.drainFirst=n}advance(){if(this.drainFirst)for(;P(this.source,this.cache););return this.index<this.cache.values.length||P(this.source,this.cache)?s(this.cache.values[this.index++]):c()}};function R(e,t){return l(e),o(e,a(t),-1)}function z(e,t,n){let r=typeof t==`number`,i=r?e:0,a=r?t:e;if(!r&&n!==void 0)throw Error(`The "options" parameter must be the second argument when "start" is omitted`);let o=r?n:t;o!==void 0&&te(o,`options`);let{step:s=1,reverse:c=!1}=o??{};ee(s,`step`);let l=se(i,a,Math.abs(s),c);return l.length>0?new m(()=>new B(l.first,l.step,l.length)):_()}function se(e,t,n,r){let i=t<e?-n:n,a=Math.ceil(Math.abs(t-e)/n);return r?{first:e+(a-1)*i,step:-i,length:a}:{first:e,step:i,length:a}}var B=class extends p{first;step;length;index=0;constructor(e,t,n){super(),this.first=e,this.step=t,this.length=n}advance(){return this.index>=this.length?c():s(this.first+this.index++*this.step)}};function V(e,...t){if(l(e),t.length===1)return H(e,t[0]);let[n,r]=t;u(r,`reducer`);let i=n,a=0;for(let t of e)i=r(i,t,a++);return i}function H(e,t){u(t,`reducer`);let n,r=0;for(let i of e)n=r===0?i:t(n,i,r),r++;if(r===0)throw Error(`The "sourceIterable" must not be empty when "reduce" has no seed`);return n}function U(e,t){return d(t,`count`),g(t,t=>t>0?[e,t-1]:void 0)}function W(e,t){l(e),u(t,`predicate`);let n=0;for(let r of e)if(t(r,n++))return!0;return!1}function G(e,t){return l(e),u(t,`tapper`),new m(()=>new ce(e,t))}var ce=class extends h{tapper;constructor(e,t){super(e),this.tapper=t}advance(){let e=this.source.next();if(e.done===!0)return e;try{this.tapper(e.value,this.index++)}catch(e){throw this.closeAfterCallbackError(),e}return e}};function K(e,t){return l(e),u(t,`tapper`),new m(()=>(t(e,0),e[Symbol.iterator]()))}var le=n({collectToArray:()=>f,empty:()=>_,filter:()=>v,flatMap:()=>y,forEach:()=>S,forEachAsync:()=>C,getMemoizeDefaultOptions:()=>j,map:()=>w,materialize:()=>O,max:()=>A,memoize:()=>M,min:()=>R,range:()=>z,reduce:()=>V,repeat:()=>U,some:()=>W,tap:()=>G,tapChain:()=>K}),q=Symbol.for(`iterable-linq-utility.IIterableLinq`);function J(e){return new Y(e)}var Y=class{iterable;constructor(e){this.iterable=e}[Symbol.iterator](){return this.iterable[Symbol.iterator]()}collectToArray(){return f(this.iterable)}filter(e){return J(v(this.iterable,e))}flatMap(e){return J(y(this.iterable,e))}forEach(e){return S(this.iterable,e)}forEachAsync(e){return C(this.iterable,e)}map(e){return J(w(this.iterable,e))}materialize(){return J(O(this.iterable))}max(e){return A(this.iterable,e)}memoize(e){return J(M(this.iterable,e))}min(e){return R(this.iterable,e)}reduce(...e){return e.length===1?V(this.iterable,e[0]):V(this.iterable,e[0],e[1])}some(e){return W(this.iterable,e)}tap(e){return J(G(this.iterable,e))}tapChain(e){return J(K(this.iterable,e))}tapChainCreation(e){u(e,`chainCreationTapper`);let t=this;return e(t),t}};Object.defineProperty(Y.prototype,q,{value:!0,enumerable:!1,writable:!1,configurable:!1});function X(){return Y.prototype}function ue(e){return typeof e==`object`&&!!e&&e[q]===!0}function Z(e,t){let n=Object.getOwnPropertyDescriptor(X(),e);Object.defineProperty(X(),e,{value:t,enumerable:!1,writable:n?.writable??!1,configurable:!0})}function Q(e,t){ne(e,`name`),u(t,`implementation`)}function de(e,t){if(Q(e,t),e in J([]))throw Error(`"${e}" already exists on IIterableLinq: use override() to replace it`);Z(e,t)}function fe(e,t){Q(e,t);let n=e;if(!(n!==`constructor`&&Object.prototype.hasOwnProperty.call(X(),n)))throw Error(`"${n}" is not a method of IIterableLinq: use extend() to add it`);Z(n,t)}function pe(){return $(_())}function $(e){return l(e),J(e)}function me(e,t,n){if(typeof t==`number`)return $(z(e,t,n));if(n!==void 0)throw Error(`The "options" parameter must be the second argument when "start" is omitted`);return $(z(e,t))}function he(e,t){return $(U(e,t))}Object.defineProperty(e,"Functions",{enumerable:!0,get:function(){return le}}),e.Unit=b,e.empty=pe,e.extend=de,e.from=$,e.fromRange=me,e.isIterableLinq=ue,e.override=fe,e.repeat=he,e.unit=x});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "iterable-linq-utility",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "An Iterable mutation utility inspired by .net Linq and Javascript Array interface",
   "type": "module",
   "main": "./dist/iterable-linq-utility.umd.cjs",
@@ -24,9 +24,14 @@
   "scripts": {
     "build": "tsc -p tsconfig.build.json && vite build && cp dist/index.d.ts dist/index.d.cts",
     "check:package": "attw --pack .",
+    "check:changeset": "changeset status --since=origin/main",
+    "check:since": "node scripts/check-since.ts",
+    "check:instructions": "node scripts/check-instructions.ts",
+    "check:structure": "node scripts/check-structure.ts",
     "dev": "vite",
     "lint": "eslint .",
     "lint-fix": "eslint . --fix",
+    "release:version": "changeset version && node scripts/set-since.ts",
     "typecheck": "tsc -p tsconfig.test.json --noEmit",
     "test": "vitest run",
     "bench": "vite build --logLevel error && vitest bench --run",
@@ -51,6 +56,8 @@
   ],
   "devDependencies": {
     "@arethetypeswrong/cli": "^0.18.5",
+    "@changesets/changelog-github": "^1.0.1",
+    "@changesets/cli": "^3.0.3",
     "@eslint/js": "^10.0.1",
     "@microsoft/api-extractor": "^7.59.2",
     "@stylistic/eslint-plugin": "^5.10.0",