@stacksjs/arrays 0.75.118 → 0.75.120

package/dist/arr.d.ts

@@ -2,3 +2,4 @@ export * from './contains';
 export * from './helpers';
 export * from './math';
 export * from './transform';
+export * from './series';

package/dist/arr.js

@@ -1 +1 @@
-export*from"./contains";export*from"./helpers";export*from"./math";export*from"./transform";
+export*from"./contains";export*from"./helpers";export*from"./math";export*from"./transform";export*from"./series";

package/dist/series.d.ts

@@ -0,0 +1,26 @@
+/** Reject absent and nonnumeric values without turning null, false or blanks into zero. */
+export declare function finiteNumeric(value: unknown): number | null;
+/** Prefer a direct source per field; a missing field can fall back to another source. */
+export declare function mergeDailySeries(rows: readonly DailyObservation[], priority?: readonly string[]): DailySeriesPoint[];
+/** Statistics over valid observations, including zero; latest is by date rather than input order. */
+export declare function summarizeSeries(points: readonly NumericSeriesPoint[]): NumericSeriesSummary;
+/** Numeric observations grouped by calendar day, with provenance per field. */
+export declare interface DailyObservation {
+  day: string
+  source: string
+  values: Record<string, unknown>
+  updatedAt?: string
+}
+export declare interface DailySeriesPoint {
+  date: string
+  values: Record<string, number>
+  sources: Record<string, string>
+}
+export declare interface NumericSeriesPoint { date: string, value: number, source?: string }
+export declare interface NumericSeriesSummary {
+  count: number
+  latest: NumericSeriesPoint | null
+  average: number | null
+  lowest: number | null
+  highest: number | null
+}

package/dist/series.js

@@ -0,0 +1 @@
+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}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)||String(b.updatedAt||"").localeCompare(String(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 sum=0,lowest=1/0,highest=-1/0;for(const point of valid){sum+=point.value;lowest=Math.min(lowest,point.value);highest=Math.max(highest,point.value)}return{count:valid.length,latest:valid.at(-1)??null,average:valid.length?sum/valid.length:null,lowest:valid.length?lowest:null,highest:valid.length?highest:null}}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@stacksjs/arrays",
   "type": "module",
-  "version": "0.75.118",
+  "version": "0.75.120",
   "description": "The Stacks array utilities.",
   "author": "Chris Breuer",
   "contributors": [