@stacksjs/arrays 0.75.515 → 0.75.519

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/helpers.js CHANGED
@@ -1 +1 @@
1
- export function toArray(array){array=array??[];return Array.isArray(array)?array:[array]}export function flatten(array){return toArray(array).reduce((acc,val)=>acc.concat(Array.isArray(val)?flatten(val):val),[])}export function mergeArrayable(...args){return args.flatMap((i)=>toArray(i))}export function partition(array,...filters){const result=Array.from({length:filters.length+1}).fill(null).map(()=>[]);array.forEach((e,idx,arr)=>{let i=0;for(const filter of filters){if(filter(e,idx,arr)){result[i].push(e);return}i+=1}result[i].push(e)});return result}export function uniq(array){return Array.from(new Set(array))}export function unique(array){return uniq(array)}export function uniqueBy(array,equalFn){return array.reduce((acc,cur)=>{if(acc.findIndex((item)=>equalFn(cur,item))===-1)acc.push(cur);return acc},[])}export function last(array){return at(array,-1)}export function remove(array,value){if(!array)return!1;const index=array.indexOf(value);if(index>=0){array.splice(index,1);return!0}return!1}export function at(array,index){const len=array.length;if(!len)return;if(index<0)index+=len;return array[index]}export function move(array,from,to){const len=array.length;if(!Number.isSafeInteger(from)||!Number.isSafeInteger(to))throw RangeError("move indices must be safe integers");if(!len)return array;if(from<0)from+=len;if(to<0)to+=len;if(from<0||from>=len||to<0||to>len)throw RangeError("move index is out of bounds");const item=array.splice(from,1)[0];array.splice(to,0,item);return array}function clamp(n,min,max){return Math.min(max,Math.max(min,n))}export function clampArrayRange(arr,n){return clamp(n,0,arr.length-1)}export function sample(arr,count){if(!Number.isSafeInteger(count)||count<0)throw RangeError("sample count must be a non-negative safe integer");if(arr.length===0)return[];return Array.from({length:count},()=>arr[Math.floor(Math.random()*arr.length)])}export function shuffle(array){for(let i=array.length-1;i>0;i--){const j=Math.floor(Math.random()*(i+1));[array[i],array[j]]=[array[j],array[i]]}return array}
1
+ export function toArray(array){array=array??[];return Array.isArray(array)?array:[array]}export function flatten(array){return toArray(array).reduce((acc,val)=>acc.concat(Array.isArray(val)?flatten(val):val),[])}export function mergeArrayable(...args){return args.flatMap((i)=>toArray(i))}export function partition(array,...filters){const result=Array.from({length:filters.length+1}).fill(null).map(()=>[]);array.forEach((e,idx,arr)=>{let i=0;for(const filter of filters){if(filter(e,idx,arr)){result[i].push(e);return}i+=1}result[i].push(e)});return result}export function uniq(array){return Array.from(new Set(array))}export function unique(array){return uniq(array)}export function uniqueBy(array,equalFn){return array.reduce((acc,cur)=>{const index=acc.findIndex((item)=>equalFn(cur,item));if(index===-1)acc.push(cur);return acc},[])}export function last(array){return at(array,-1)}export function remove(array,value){if(!array)return false;const index=array.indexOf(value);if(index>=0){array.splice(index,1);return true}return false}export function at(array,index){const len=array.length;if(!len)return;if(index<0)index+=len;return array[index]}export function move(array,from,to){const len=array.length;if(!Number.isSafeInteger(from)||!Number.isSafeInteger(to))throw new RangeError("move indices must be safe integers");if(!len)return array;if(from<0)from+=len;if(to<0)to+=len;if(from<0||from>=len||to<0||to>len)throw new RangeError("move index is out of bounds");const item=array.splice(from,1)[0];array.splice(to,0,item);return array}function clamp(n,min,max){return Math.min(max,Math.max(min,n))}export function clampArrayRange(arr,n){return clamp(n,0,arr.length-1)}export function sample(arr,count){if(!Number.isSafeInteger(count)||count<0)throw new RangeError("sample count must be a non-negative safe integer");if(arr.length===0)return[];return Array.from({length:count},()=>arr[Math.floor(Math.random()*arr.length)])}export function shuffle(array){for(let i=array.length-1;i>0;i--){const j=Math.floor(Math.random()*(i+1));[array[i],array[j]]=[array[j],array[i]]}return array}
package/dist/macro.js CHANGED
@@ -1 +1 @@
1
- import{contains,containsAll,containsAny,containsNone,containsOnly,doesNotContain}from"./contains";import{at,clampArrayRange,flatten,last,mergeArrayable,move,partition,remove,sample,shuffle,toArray,uniq,uniqueBy}from"./helpers";import{average,median,mode,range,sum}from"./math";export const Arr={contains(needle,haystack){return contains(needle,haystack)},containsAll(needles,haystack){return containsAll(needles,haystack)},containsAny(needles,haystack){return containsAny(needles,haystack)},containsNone(needles,haystack){return containsNone(needles,haystack)},containsOnly(needles,haystack){return containsOnly(needles,haystack)},doesNotContain(needle,haystack){return doesNotContain(needle,haystack)},toArray(array){return toArray(array)},flatten(array){return flatten(array)},mergeArrayable(...args){return mergeArrayable(...args)},partition(array,filter){return partition(array,filter)},random(arr,count=1){return sample(arr,count).filter((item)=>item!=null)},sample(arr,count=1){return sample(arr,count)},unique(arr){return uniq(arr)},uniqueBy(arr,equalFn){return uniqueBy(arr,equalFn)},last(arr){return last(arr)},remove(arr,value){return remove(arr,value)},at(arr,index){return at(arr,index)},range(arr){return range(arr)},move(arr,from,to){return move(arr,from,to)},clampArrayRange(arr,n){return clampArrayRange(arr,n)},shuffle(arr){return shuffle(arr)},sum(arr){return sum(arr)},average(arr){return average(arr)},avg(arr){return average(arr)},median(arr){return median(arr)},mode(arr){return mode(arr)}},arr=Arr;
1
+ import{contains,containsAll,containsAny,containsNone,containsOnly,doesNotContain}from"./contains";import{at,clampArrayRange,flatten,last,mergeArrayable,move,partition,remove,sample,shuffle,toArray,uniq,uniqueBy}from"./helpers";import{average,median,mode,range,sum}from"./math";export const Arr={contains(needle,haystack){return contains(needle,haystack)},containsAll(needles,haystack){return containsAll(needles,haystack)},containsAny(needles,haystack){return containsAny(needles,haystack)},containsNone(needles,haystack){return containsNone(needles,haystack)},containsOnly(needles,haystack){return containsOnly(needles,haystack)},doesNotContain(needle,haystack){return doesNotContain(needle,haystack)},toArray(array){return toArray(array)},flatten(array){return flatten(array)},mergeArrayable(...args){return mergeArrayable(...args)},partition(array,filter){return partition(array,filter)},random(arr,count=1){return sample(arr,count).filter((item)=>item!=null)},sample(arr,count=1){return sample(arr,count)},unique(arr){return uniq(arr)},uniqueBy(arr,equalFn){return uniqueBy(arr,equalFn)},last(arr){return last(arr)},remove(arr,value){return remove(arr,value)},at(arr,index){return at(arr,index)},range(arr){return range(arr)},move(arr,from,to){return move(arr,from,to)},clampArrayRange(arr,n){return clampArrayRange(arr,n)},shuffle(arr){return shuffle(arr)},sum(arr){return sum(arr)},average(arr){return average(arr)},avg(arr){return average(arr)},median(arr){return median(arr)},mode(arr){return mode(arr)}};export const arr=Arr;
package/dist/math.js CHANGED
@@ -1 +1 @@
1
- export function average(arr){if(arr.length===0)throw Error("Cannot compute average of an empty array");const total=sum(arr);if(Number.isFinite(total)||arr.some((value)=>!Number.isFinite(value)))return total/arr.length;const scale=arr.reduce((largest,value)=>Math.max(largest,Math.abs(value)),0);return arr.reduce((acc,value)=>acc+value/scale,0)/arr.length*scale}export function avg(arr){return average(arr)}export function median(arr){if(arr.length===0)throw Error("Cannot compute median of an empty array");const sorted=[...arr].sort((a,b)=>a-b),mid=Math.floor(sorted.length/2);let medianValue;if(sorted.length%2!==0)medianValue=sorted[mid];else medianValue=average([sorted[mid],sorted[mid-1]]);return medianValue}export function mode(arr){if(arr.length===0)throw Error("Cannot compute mode of an empty array");const counts=new Map;for(const v of arr)counts.set(v,(counts.get(v)||0)+1);let maxCount=0,result=arr[0];for(const[value,count]of counts)if(count>maxCount){maxCount=count;result=value}return result}export function sum(array){return array.reduce((acc,cur)=>acc+cur,0)}export function product(array){let acc=1;for(const cur of array){acc*=cur;if(Number.isFinite(acc)&&Math.abs(acc)>Number.MAX_SAFE_INTEGER)throw RangeError(`[arrays.product] Result exceeds Number.MAX_SAFE_INTEGER (${Number.MAX_SAFE_INTEGER}); use BigInt for large products.`)}return acc}export function min(array){if(array.length===0)throw Error("Cannot compute min of an empty array");let result=1/0;for(const value of array)result=Math.min(result,value);return result}export function max(array){if(array.length===0)throw Error("Cannot compute max of an empty array");let result=-1/0;for(const value of array)result=Math.max(result,value);return result}export function range(array){return max(array)-min(array)}export function variance(array){const centered=centeredValues(array);if(centered)return scaledProduct(centered.variance,centered.scale,centered.scale);const mean=average(array);return average(array.map((num)=>(num-mean)**2))}export function standardDeviation(array){const centered=centeredValues(array);if(centered)return Math.sqrt(centered.variance)*centered.scale;return Math.sqrt(variance(array))}export function zScore(array,num){const centered=centeredValues(array);if(centered)return(normalizedDifference(num,centered.anchor,centered.scale)-centered.mean)/Math.sqrt(centered.variance);return(num-average(array))/standardDeviation(array)}export function percentile(array,num){if(array.length===0)throw Error("Cannot compute a percentile of an empty array");if(!Number.isFinite(num)||num<0||num>100)throw RangeError(`A percentile is between 0 and 100, got ${num}`);const sorted=[...array].sort((a,b)=>a-b),index=num/100*(sorted.length-1),lower=Math.floor(index),upper=Math.ceil(index),weight=index-lower;if(upper===lower)return sorted[index]??0;return(1-weight)*(sorted[lower]??0)+weight*(sorted[upper]??0)}export function interquartileRange(array){if(array.length===0)throw Error("Cannot compute the interquartile range of an empty array");if(array.length===1)return 0;const sorted=[...array].sort((a,b)=>a-b),q1=median(sorted.slice(0,Math.floor(sorted.length/2)));return median(sorted.slice(Math.ceil(sorted.length/2)))-q1}export function covariance(array1,array2){if(array1.length!==array2.length)throw Error("Arrays must have the same length");const exact=finiteCovariance(array1,array2);if(exact!==void 0)return exact;const mean1=average(array1),mean2=average(array2);return average(array1.map((num1,i)=>(num1-mean1)*(array2[i]-mean2)))}function finiteCovariance(first,second){if(first.length===0)throw Error("Cannot compute average of an empty array");const view=new DataView(new ArrayBuffer(8));let sumFirst=0n,sumSecond=0n,sumProducts=0n;for(let index=0;index<first.length;index++){const x=first[index],y=second[index];if(!Number.isFinite(x)||!Number.isFinite(y))return;const[a,shiftA]=binaryCoefficient(x,view),[b,shiftB]=binaryCoefficient(y,view);sumFirst+=a<<shiftA;sumSecond+=b<<shiftB;sumProducts+=a*b<<shiftA+shiftB}const count=BigInt(first.length),numerator=count*sumProducts-sumFirst*sumSecond;return binaryRatio(numerator,count*count)}function binaryCoefficient(value,view){view.setFloat64(0,value);const bits=view.getBigUint64(0),exponent=bits>>52n&0x7ffn;let coefficient=bits&0xfffffffffffffn;if(exponent!==0n)coefficient|=1n<<52n;if(bits>>63n)coefficient=-coefficient;return[coefficient,exponent===0n?0n:exponent-1n]}function binaryRatio(numerator,denominator){const negative=numerator<0n,magnitude=negative?-numerator:numerator,integer=magnitude/denominator,shift=Math.max(1074,integer.toString(2).length-53),divisor=denominator<<BigInt(shift);let coefficient=magnitude/divisor;const remainder=magnitude%divisor;if(remainder*2n>divisor||remainder*2n===divisor&&(coefficient&1n)!==0n)coefficient++;const result=Number(coefficient)*2**(shift-2148);return negative?-result:result}function centeredValues(array){if(array.length===0)throw Error("Cannot compute average of an empty array");let scale=0;for(const value of array){if(!Number.isFinite(value))return;scale=Math.max(scale,Math.abs(value))}if(scale===0)scale=1;const anchor=array[0],differences=array.map((value)=>normalizedDifference(value,anchor,scale)),mean=average(differences),deviations=differences.map((value)=>value-mean);return{scale,anchor,mean,variance:average(deviations.map((value)=>value*value))}}function normalizedDifference(value,anchor,scale){const difference=value-anchor;return Number.isFinite(difference)?difference/scale:value/scale-anchor/scale}function scaledProduct(value,first,second){const factors=[value,first,second].sort((a,b)=>Math.abs(a)-Math.abs(b));return factors[0]*factors[2]*factors[1]}
1
+ export function average(arr){if(arr.length===0)throw new Error("Cannot compute average of an empty array");const total=sum(arr);if(Number.isFinite(total)||arr.some((value)=>!Number.isFinite(value)))return total/arr.length;const scale=arr.reduce((largest,value)=>Math.max(largest,Math.abs(value)),0);return arr.reduce((acc,value)=>acc+value/scale,0)/arr.length*scale}export function avg(arr){return average(arr)}export function median(arr){if(arr.length===0)throw new Error("Cannot compute median of an empty array");const sorted=[...arr].sort((a,b)=>a-b);const mid=Math.floor(sorted.length/2);let medianValue;if(sorted.length%2!==0)medianValue=sorted[mid];else medianValue=average([sorted[mid],sorted[mid-1]]);return medianValue}export function mode(arr){if(arr.length===0)throw new Error("Cannot compute mode of an empty array");const counts=new Map;for(const v of arr){counts.set(v,(counts.get(v)||0)+1)}let maxCount=0;let result=arr[0];for(const[value,count]of counts){if(count>maxCount){maxCount=count;result=value}}return result}export function sum(array){return array.reduce((acc,cur)=>acc+cur,0)}export function product(array){let acc=1;for(const cur of array){acc*=cur;if(Number.isFinite(acc)&&Math.abs(acc)>Number.MAX_SAFE_INTEGER){throw new RangeError(`[arrays.product] Result exceeds Number.MAX_SAFE_INTEGER (${Number.MAX_SAFE_INTEGER}); use BigInt for large products.`)}}return acc}export function min(array){if(array.length===0)throw new Error("Cannot compute min of an empty array");let result=1/0;for(const value of array)result=Math.min(result,value);return result}export function max(array){if(array.length===0)throw new Error("Cannot compute max of an empty array");let result=-1/0;for(const value of array)result=Math.max(result,value);return result}export function range(array){return max(array)-min(array)}export function variance(array){const centered=centeredValues(array);if(centered)return scaledProduct(centered.variance,centered.scale,centered.scale);const mean=average(array);return average(array.map((num)=>(num-mean)**2))}export function standardDeviation(array){const centered=centeredValues(array);if(centered)return Math.sqrt(centered.variance)*centered.scale;return Math.sqrt(variance(array))}export function zScore(array,num){const centered=centeredValues(array);if(centered)return(normalizedDifference(num,centered.anchor,centered.scale)-centered.mean)/Math.sqrt(centered.variance);return(num-average(array))/standardDeviation(array)}export function percentile(array,num){if(array.length===0)throw new Error("Cannot compute a percentile of an empty array");if(!Number.isFinite(num)||num<0||num>100)throw new RangeError(`A percentile is between 0 and 100, got ${num}`);const sorted=[...array].sort((a,b)=>a-b);const index=num/100*(sorted.length-1);const lower=Math.floor(index);const upper=Math.ceil(index);const weight=index-lower;if(upper===lower)return sorted[index]??0;return(1-weight)*(sorted[lower]??0)+weight*(sorted[upper]??0)}export function interquartileRange(array){if(array.length===0)throw new Error("Cannot compute the interquartile range of an empty array");if(array.length===1)return 0;const sorted=[...array].sort((a,b)=>a-b);const q1=median(sorted.slice(0,Math.floor(sorted.length/2)));const q3=median(sorted.slice(Math.ceil(sorted.length/2)));return q3-q1}export function covariance(array1,array2){if(array1.length!==array2.length)throw new Error("Arrays must have the same length");const exact=finiteCovariance(array1,array2);if(exact!==undefined)return exact;const mean1=average(array1);const mean2=average(array2);return average(array1.map((num1,i)=>(num1-mean1)*(array2[i]-mean2)))}function finiteCovariance(first,second){if(first.length===0)throw new Error("Cannot compute average of an empty array");const view=new DataView(new ArrayBuffer(8));let sumFirst=0n,sumSecond=0n,sumProducts=0n;for(let index=0;index<first.length;index++){const x=first[index],y=second[index];if(!Number.isFinite(x)||!Number.isFinite(y))return;const[a,shiftA]=binaryCoefficient(x,view);const[b,shiftB]=binaryCoefficient(y,view);sumFirst+=a<<shiftA;sumSecond+=b<<shiftB;sumProducts+=a*b<<shiftA+shiftB}const count=BigInt(first.length);const numerator=count*sumProducts-sumFirst*sumSecond;return binaryRatio(numerator,count*count)}function binaryCoefficient(value,view){view.setFloat64(0,value);const bits=view.getBigUint64(0);const exponent=bits>>52n&0x7ffn;let coefficient=bits&0xfffffffffffffn;if(exponent!==0n)coefficient|=1n<<52n;if(bits>>63n)coefficient=-coefficient;return[coefficient,exponent===0n?0n:exponent-1n]}function binaryRatio(numerator,denominator){const negative=numerator<0n;const magnitude=negative?-numerator:numerator;const integer=magnitude/denominator;const shift=Math.max(1074,integer.toString(2).length-53);const divisor=denominator<<BigInt(shift);let coefficient=magnitude/divisor;const remainder=magnitude%divisor;if(remainder*2n>divisor||remainder*2n===divisor&&(coefficient&1n)!==0n)coefficient++;const result=Number(coefficient)*2**(shift-2148);return negative?-result:result}function centeredValues(array){if(array.length===0)throw new Error("Cannot compute average of an empty array");let scale=0;for(const value of array){if(!Number.isFinite(value))return;scale=Math.max(scale,Math.abs(value))}if(scale===0)scale=1;const anchor=array[0];const differences=array.map((value)=>normalizedDifference(value,anchor,scale));const mean=average(differences);const deviations=differences.map((value)=>value-mean);return{scale,anchor,mean,variance:average(deviations.map((value)=>value*value))}}function normalizedDifference(value,anchor,scale){const difference=value-anchor;return Number.isFinite(difference)?difference/scale:value/scale-anchor/scale}function scaledProduct(value,first,second){const factors=[value,first,second].sort((a,b)=>Math.abs(a)-Math.abs(b));return factors[0]*factors[2]*factors[1]}
package/dist/series.js CHANGED
@@ -1 +1 @@
1
- import{average}from"./math";export function finiteNumeric(value){if(typeof value!=="number"&&typeof value!=="string")return null;if(typeof value==="string"&&!value.trim())return null;const number=Number(value);return Number.isFinite(number)?number:null}function updateInstant(value){const instant=value?Date.parse(value):NaN;return Number.isFinite(instant)?instant:-1/0}export function mergeDailySeries(rows,priority=[]){const rank=(source)=>{const at=priority.indexOf(source);return at<0?priority.length:at},sorted=[...rows].sort((a,b)=>rank(a.source)-rank(b.source)||updateInstant(b.updatedAt)-updateInstant(a.updatedAt)||a.source.localeCompare(b.source)),days=new Map;for(const row of sorted){if(!/^\d{4}-\d{2}-\d{2}$/.test(row.day))continue;const parsed=new Date(`${row.day}T00:00:00Z`);if(!Number.isFinite(parsed.getTime())||parsed.toISOString().slice(0,10)!==row.day)continue;const point=days.get(row.day)||{date:row.day,values:{},sources:{}};for(const[key,raw]of Object.entries(row.values)){if(Object.hasOwn(point.values,key))continue;const value=finiteNumeric(raw);if(value===null)continue;Object.defineProperty(point.values,key,{value,enumerable:!0,configurable:!0,writable:!0});Object.defineProperty(point.sources,key,{value:row.source,enumerable:!0,configurable:!0,writable:!0})}if(Object.keys(point.values).length)days.set(row.day,point)}return[...days.values()].sort((a,b)=>a.date.localeCompare(b.date))}export function summarizeSeries(points){const valid=points.filter((point)=>Number.isFinite(point.value)).sort((a,b)=>a.date.localeCompare(b.date));let lowest=1/0,highest=-1/0;for(const point of valid){lowest=Math.min(lowest,point.value);highest=Math.max(highest,point.value)}return{count:valid.length,latest:valid.at(-1)??null,average:valid.length?average(valid.map((point)=>point.value)):null,lowest:valid.length?lowest:null,highest:valid.length?highest:null}}
1
+ import{average}from"./math";export function finiteNumeric(value){if(typeof value!=="number"&&typeof value!=="string")return null;if(typeof value==="string"&&!value.trim())return null;const number=Number(value);return Number.isFinite(number)?number:null}function updateInstant(value){const instant=value?Date.parse(value):NaN;return Number.isFinite(instant)?instant:-1/0}export function mergeDailySeries(rows,priority=[]){const rank=(source)=>{const at=priority.indexOf(source);return at<0?priority.length:at};const sorted=[...rows].sort((a,b)=>rank(a.source)-rank(b.source)||updateInstant(b.updatedAt)-updateInstant(a.updatedAt)||a.source.localeCompare(b.source));const days=new Map;for(const row of sorted){if(!/^\d{4}-\d{2}-\d{2}$/.test(row.day))continue;const parsed=new Date(`${row.day}T00:00:00Z`);if(!Number.isFinite(parsed.getTime())||parsed.toISOString().slice(0,10)!==row.day)continue;const point=days.get(row.day)||{date:row.day,values:{},sources:{}};for(const[key,raw]of Object.entries(row.values)){if(Object.hasOwn(point.values,key))continue;const value=finiteNumeric(raw);if(value===null)continue;Object.defineProperty(point.values,key,{value,enumerable:true,configurable:true,writable:true});Object.defineProperty(point.sources,key,{value:row.source,enumerable:true,configurable:true,writable:true})}if(Object.keys(point.values).length)days.set(row.day,point)}return[...days.values()].sort((a,b)=>a.date.localeCompare(b.date))}export function summarizeSeries(points){const valid=points.filter((point)=>Number.isFinite(point.value)).sort((a,b)=>a.date.localeCompare(b.date));let lowest=1/0;let highest=-1/0;for(const point of valid){lowest=Math.min(lowest,point.value);highest=Math.max(highest,point.value)}return{count:valid.length,latest:valid.at(-1)??null,average:valid.length?average(valid.map((point)=>point.value)):null,lowest:valid.length?lowest:null,highest:valid.length?highest:null}}
package/dist/transform.js CHANGED
@@ -1 +1 @@
1
- import{average}from"./math";export function chunk(array,size){if(!Number.isInteger(size)||size<1)throw TypeError(`chunk: size must be a positive integer, got ${size}`);const chunks=[];for(let index=0;index<array.length;index+=size)chunks.push(array.slice(index,index+size));return chunks}export function compact(array){return array.filter((value)=>value!==null&&value!==void 0)}export function first(array){return array[0]}export function tail(array){return array.slice(1)}export function take(array,count){return array.slice(0,normalizedCount(count))}export function takeLast(array,count){count=normalizedCount(count);return count<=0?[]:array.slice(Math.max(0,array.length-count))}export function takeWhile(array,predicate){const result=[];for(const[index,value]of array.entries()){if(!predicate(value,index))break;result.push(value)}return result}export function takeLastWhile(array,predicate){for(let index=array.length-1;index>=0;index--)if(!predicate(array[index],index))return array.slice(index+1);return array.slice()}export function drop(array,count){return array.slice(normalizedCount(count))}export function dropLast(array,count){count=normalizedCount(count);return count<=0?array.slice():array.slice(0,Math.max(0,array.length-count))}function normalizedCount(count){return Math.max(0,Math.trunc(count)||0)}export function dropWhile(array,predicate){for(const[index,value]of array.entries())if(!predicate(value,index))return array.slice(index);return[]}export function dropLastWhile(array,predicate){for(let index=array.length-1;index>=0;index--)if(!predicate(array[index],index))return array.slice(0,index+1);return[]}function defineValue(target,key,value){Object.defineProperty(target,key,{value,enumerable:!0,configurable:!0,writable:!0})}export function groupBy(array,key){const groups={};for(const[index,value]of array.entries()){const group=key(value,index);if(group===void 0)continue;if(!Object.hasOwn(groups,group))defineValue(groups,group,[]);groups[group].push(value)}return groups}export function keyBy(array,key){const indexed={};for(const[index,value]of array.entries()){const at=key(value,index);if(at!==void 0)defineValue(indexed,at,value)}return indexed}export function countBy(array,key){const counts={};for(const[index,value]of array.entries()){const at=key(value,index);if(at!==void 0)defineValue(counts,at,(Object.hasOwn(counts,at)?counts[at]:0)+1)}return counts}function compareSelected(a,b){if(a instanceof Date&&b instanceof Date)return a.getTime()-b.getTime();if(typeof a==="string"&&typeof b==="string")return a<b?-1:a>b?1:0;if(typeof a==="boolean"&&typeof b==="boolean")return Number(a)-Number(b);if(typeof a==="bigint"&&typeof b==="bigint")return a<b?-1:a>b?1:0;return Number(a)-Number(b)}export function sortBy(array,...selectors){const normalized=selectors.map((selector)=>typeof selector==="function"?{by:selector,order:"asc"}:{order:"asc",...selector});if(normalized.length===0)return array.slice();return array.map((value)=>({value,keys:normalized.map(({by})=>by(value))})).sort((left,right)=>{for(let index=0;index<normalized.length;index++){const{order}=normalized[index],comparison=compareSelected(left.keys[index],right.keys[index]);if(comparison!==0)return order==="desc"?-comparison:comparison}return 0}).map((entry)=>entry.value)}export function sumBy(array,value){let total=0;for(const[index,item]of array.entries())total+=value(item,index);return total}export function meanBy(array,value){return array.length===0?void 0:average(Array.from(array,value))}export function maxBy(array,value){let found=!1,best,bestValue=Number.NEGATIVE_INFINITY;for(const[index,item]of array.entries()){const candidate=value(item,index);if(!Number.isNaN(candidate)&&(!found||candidate>bestValue)){found=!0;bestValue=candidate;best=item}}return best}export function minBy(array,value){let found=!1,best,bestValue=Number.POSITIVE_INFINITY;for(const[index,item]of array.entries()){const candidate=value(item,index);if(!Number.isNaN(candidate)&&(!found||candidate<bestValue)){found=!0;bestValue=candidate;best=item}}return best}export function zip(first,second){const length=Math.min(first.length,second.length),pairs=[];for(let index=0;index<length;index++)pairs.push([first[index],second[index]]);return pairs}export function zipWith(first,second,combine){const length=Math.min(first.length,second.length),combined=[];for(let index=0;index<length;index++)combined.push(combine(first[index],second[index],index));return combined}export function unzip(pairs){const first=[],second=[];for(const[a,b]of pairs){first.push(a);second.push(b)}return[first,second]}export function difference(array,other){const exclude=new Set(other);return array.filter((value)=>!exclude.has(value))}export function intersection(array,other){const include=new Set(other),seen=new Set;return array.filter((value)=>{if(!include.has(value)||seen.has(value))return!1;seen.add(value);return!0})}export function union(...arrays){return[...new Set(arrays.flat())]}export function splitAt(array,index){return[array.slice(0,index),array.slice(index)]}export function splitWhen(array,predicate){for(const[index,value]of array.entries())if(predicate(value,index))return[array.slice(0,index),array.slice(index)];return[array.slice(),[]]}export function times(count,create){if(!Number.isInteger(count)||count<0)throw TypeError(`times: count must be a non-negative integer, got ${count}`);const result=Array.from({length:count});for(let index=0;index<count;index++)result[index]=create(index);return result}
1
+ import{average}from"./math";export function chunk(array,size){if(!Number.isInteger(size)||size<1)throw new TypeError(`chunk: size must be a positive integer, got ${size}`);const chunks=[];for(let index=0;index<array.length;index+=size)chunks.push(array.slice(index,index+size));return chunks}export function compact(array){return array.filter((value)=>value!==null&&value!==undefined)}export function first(array){return array[0]}export function tail(array){return array.slice(1)}export function take(array,count){return array.slice(0,normalizedCount(count))}export function takeLast(array,count){count=normalizedCount(count);return count<=0?[]:array.slice(Math.max(0,array.length-count))}export function takeWhile(array,predicate){const result=[];for(const[index,value]of array.entries()){if(!predicate(value,index))break;result.push(value)}return result}export function takeLastWhile(array,predicate){for(let index=array.length-1;index>=0;index--){if(!predicate(array[index],index))return array.slice(index+1)}return array.slice()}export function drop(array,count){return array.slice(normalizedCount(count))}export function dropLast(array,count){count=normalizedCount(count);return count<=0?array.slice():array.slice(0,Math.max(0,array.length-count))}function normalizedCount(count){return Math.max(0,Math.trunc(count)||0)}export function dropWhile(array,predicate){for(const[index,value]of array.entries()){if(!predicate(value,index))return array.slice(index)}return[]}export function dropLastWhile(array,predicate){for(let index=array.length-1;index>=0;index--){if(!predicate(array[index],index))return array.slice(0,index+1)}return[]}function defineValue(target,key,value){Object.defineProperty(target,key,{value,enumerable:true,configurable:true,writable:true})}export function groupBy(array,key){const groups={};for(const[index,value]of array.entries()){const group=key(value,index);if(group===undefined)continue;if(!Object.hasOwn(groups,group))defineValue(groups,group,[]);groups[group].push(value)}return groups}export function keyBy(array,key){const indexed={};for(const[index,value]of array.entries()){const at=key(value,index);if(at!==undefined)defineValue(indexed,at,value)}return indexed}export function countBy(array,key){const counts={};for(const[index,value]of array.entries()){const at=key(value,index);if(at!==undefined)defineValue(counts,at,(Object.hasOwn(counts,at)?counts[at]:0)+1)}return counts}function compareSelected(a,b){if(a instanceof Date&&b instanceof Date)return a.getTime()-b.getTime();if(typeof a==="string"&&typeof b==="string")return a<b?-1:a>b?1:0;if(typeof a==="boolean"&&typeof b==="boolean")return Number(a)-Number(b);if(typeof a==="bigint"&&typeof b==="bigint")return a<b?-1:a>b?1:0;return Number(a)-Number(b)}export function sortBy(array,...selectors){const normalized=selectors.map((selector)=>typeof selector==="function"?{by:selector,order:"asc"}:{order:"asc",...selector});if(normalized.length===0)return array.slice();return array.map((value)=>({value,keys:normalized.map(({by})=>by(value))})).sort((left,right)=>{for(let index=0;index<normalized.length;index++){const{order}=normalized[index];const comparison=compareSelected(left.keys[index],right.keys[index]);if(comparison!==0)return order==="desc"?-comparison:comparison}return 0}).map((entry)=>entry.value)}export function sumBy(array,value){let total=0;for(const[index,item]of array.entries())total+=value(item,index);return total}export function meanBy(array,value){return array.length===0?undefined:average(Array.from(array,value))}export function maxBy(array,value){let found=false;let best;let bestValue=Number.NEGATIVE_INFINITY;for(const[index,item]of array.entries()){const candidate=value(item,index);if(!Number.isNaN(candidate)&&(!found||candidate>bestValue)){found=true;bestValue=candidate;best=item}}return best}export function minBy(array,value){let found=false;let best;let bestValue=Number.POSITIVE_INFINITY;for(const[index,item]of array.entries()){const candidate=value(item,index);if(!Number.isNaN(candidate)&&(!found||candidate<bestValue)){found=true;bestValue=candidate;best=item}}return best}export function zip(first,second){const length=Math.min(first.length,second.length);const pairs=[];for(let index=0;index<length;index++)pairs.push([first[index],second[index]]);return pairs}export function zipWith(first,second,combine){const length=Math.min(first.length,second.length);const combined=[];for(let index=0;index<length;index++)combined.push(combine(first[index],second[index],index));return combined}export function unzip(pairs){const first=[];const second=[];for(const[a,b]of pairs){first.push(a);second.push(b)}return[first,second]}export function difference(array,other){const exclude=new Set(other);return array.filter((value)=>!exclude.has(value))}export function intersection(array,other){const include=new Set(other);const seen=new Set;return array.filter((value)=>{if(!include.has(value)||seen.has(value))return false;seen.add(value);return true})}export function union(...arrays){return[...new Set(arrays.flat())]}export function splitAt(array,index){return[array.slice(0,index),array.slice(index)]}export function splitWhen(array,predicate){for(const[index,value]of array.entries()){if(predicate(value,index))return[array.slice(0,index),array.slice(index)]}return[array.slice(),[]]}export function times(count,create){if(!Number.isInteger(count)||count<0)throw new TypeError(`times: count must be a non-negative integer, got ${count}`);const result=Array.from({length:count});for(let index=0;index<count;index++)result[index]=create(index);return result}
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "@stacksjs/arrays",
3
3
  "type": "module",
4
- "version": "0.75.515",
4
+ "version": "0.75.519",
5
5
  "description": "The Stacks array utilities.",
6
6
  "author": "Chris Breuer",
7
7
  "contributors": [