@uwrl/qc-utils 0.0.18 → 0.0.19

package/dist/utils/plotting/operation-cores.d.ts

@@ -1,139 +0,0 @@
-/**
- * Pure, framework-free primitive kernels for each QC operation whose
- * worker has a one-to-one inline equivalent. Shared by both the
- * `?worker&inline` Vite workers and `ObservationRecord`'s non-worker
- * fast paths so there's a single source of truth for each algorithm —
- * if the worker's hot loop drifts from the main-thread loop we get
- * silently wrong selections, which the calibration feature would make
- * far easier to trigger.
- *
- * Keep these functions:
- *   - allocation-frugal (no unnecessary intermediate arrays),
- *   - free of module-level `self` / `postMessage` references (callable
- *     in either context),
- *   - deterministic given identical inputs (so worker output can be
- *     diffed against inline output when debugging drift).
- */
-/** Opcode encoding used by `valueThresholdCore` (matches the worker). */
-export declare const enum ThresholdOp {
-    LT = 0,
-    LTE = 1,
-    GT = 2,
-    GTE = 3,
-    E = 4
-}
-/**
- * Scan `[start, end)` of `arrayY` and collect every index where the
- * value matches ANY of the supplied comparator/threshold pairs. Short-
- * circuits on first match per element (matches worker semantics).
- */
-export declare function valueThresholdCore(arrayY: Float32Array | Float32Array<SharedArrayBuffer>, start: number, end: number, ops: number[], values: number[]): number[];
-/**
- * First-difference filter: collect indexes in `[start, end)` where
- * `Y[i] - Y[i-1]` satisfies the comparator. Comparator strings match
- * the worker exactly (FilterOperation enum values).
- */
-export declare function changeCore(arrayY: Float32Array | Float32Array<SharedArrayBuffer>, start: number, end: number, comparator: string, value: number): number[];
-/**
- * Relative rate-of-change: `(Y[i] - Y[i-1]) / |Y[i-1]|`. Same
- * comparator semantics as `changeCore`.
- */
-export declare function rateOfChangeCore(arrayY: Float32Array | Float32Array<SharedArrayBuffer>, start: number, end: number, comparator: string, value: number): number[];
-/**
- * Detect datetime gaps: returns a flat `[leftIdx, rightIdx, ...]`
- * list for every pair whose datetime delta exceeds `threshold` ms.
- * Scan covers `[start, endInclusive]`.
- */
-export declare function findGapsCore(arrayX: Float64Array | Float64Array<SharedArrayBuffer>, start: number, endInclusive: number, threshold: number): number[];
-/**
- * Emit maximal runs of equal Y values in `[start, end)` as flat
- * `[startIndex, length, value, ...]` triplets. Downstream stitches
- * adjacent chunk triplets before applying the min-run-length filter.
- */
-export declare function persistenceCore(arrayY: Float32Array | Float32Array<SharedArrayBuffer>, start: number, end: number): number[];
-/**
- * Copy `[start, end]` of `sourceX` / `sourceY` into `outX` / `outY`
- * starting at `outStart`, inserting synthesized fill points after each
- * gap whose left index falls in the read range. `gaps` is a list of
- * `[leftIdx, rightIdx]` pairs, sorted by left index. `fillDelta` is
- * the spacing between inserted points in the same unit as `sourceX`.
- * When `interpolate` is true the filled Y values are linearly
- * interpolated between the gap's endpoints; otherwise `fillValue` is
- * written (used for "sentinel" -9999 fills).
- *
- * Shared by the `FillGapsWorker`'s per-segment write and the inline
- * full-array path. Returns the number of elements written so callers
- * can double-check contiguity against their pre-computed fill totals.
- */
-export declare function fillGapsCore(sourceX: Float64Array | Float64Array<SharedArrayBuffer>, sourceY: Float32Array | Float32Array<SharedArrayBuffer>, gaps: ReadonlyArray<[number, number]>, outX: Float64Array | Float64Array<SharedArrayBuffer>, outY: Float32Array | Float32Array<SharedArrayBuffer>, start: number, end: number, outStart: number, fillDelta: number, interpolate: boolean, fillValue: number): number;
-/**
- * Merge a slice `[origStart, origEnd)` of `sourceX` / `sourceY` with
- * a pre-sorted list of `(x, y)` insertions into `outX` / `outY`
- * starting at `outStart`. Originals win on datetime ties so the
- * merged order matches `findLastLessOrEqual` semantics (insertion
- * lands after equal-valued originals). Writes in order; caller is
- * responsible for pre-allocating output buffers sized to
- * `origEnd - origStart + insertions.length`.
- *
- * Shared by the `AddDataWorker`'s segment merge and the inline
- * full-array path. Returns the number of elements written so callers
- * can double-check contiguity.
- */
-export declare function addDataPointsCore(sourceX: Float64Array | Float64Array<SharedArrayBuffer>, sourceY: Float32Array | Float32Array<SharedArrayBuffer>, insertions: ReadonlyArray<[number, number]>, outX: Float64Array | Float64Array<SharedArrayBuffer>, outY: Float32Array | Float32Array<SharedArrayBuffer>, origStart: number, origEnd: number, outStart: number): number;
-/**
- * Copy `[readStart, readEnd]` of `sourceX` / `sourceY` into
- * `outX` / `outY` starting at `outStart`, skipping any index that
- * appears in `deleteIndices` (which must be sorted ascending and
- * bounded to the read range). Shared by the worker's per-segment
- * write path and the inline full-array path. Returns the number of
- * elements written so callers can double-check contiguity.
- */
-export declare function deleteDataPointsCore(sourceX: Float64Array | Float64Array<SharedArrayBuffer>, sourceY: Float32Array | Float32Array<SharedArrayBuffer>, deleteIndices: ArrayLike<number>, outX: Float64Array | Float64Array<SharedArrayBuffer>, outY: Float32Array | Float32Array<SharedArrayBuffer>, readStart: number, readEnd: number, outStart: number): number;
-/** Params for `shiftDatetimesCollection`; mirrors the worker payload. */
-export interface ShiftDatetimesParams {
-    amount: number;
-    isMonth: boolean;
-    isYear: boolean;
-    /** Precomputed scalar ms offset; unused when `isMonth || isYear`. */
-    deltaMs: number;
-}
-/**
- * Compute shifted `(x, y)` pairs for each index in `indexes` without
- * allocating a `SharedArrayBuffer`. Mirrors the shift worker's branches
- * for month / year / scalar units. Returned in the same order as
- * `indexes` so the caller can hand the collection straight to
- * `_addDataPoints` after a `_deleteDataPoints(indexes)`.
- */
-export declare function shiftDatetimesCollection(arrayX: Float64Array | Float64Array<SharedArrayBuffer>, arrayY: Float32Array | Float32Array<SharedArrayBuffer>, indexes: ArrayLike<number>, params: ShiftDatetimesParams): [number, number][];
-/** Prepared group shape shared by `_interpolate` and its worker. */
-export interface InterpolateGroup {
-    indexes: number[];
-    lowerIdx: number;
-    upperIdx: number;
-}
-/**
- * Linear-interpolate Y-values at each group's `indexes` between the
- * anchor points at `lowerIdx` / `upperIdx`. Writes in place. Matches
- * the worker's degenerate-span semantics: if `lowerIdx === upperIdx`
- * (group sits at a buffer edge with no valid anchor on one side) we
- * paste the lone anchor value for every point in the group.
- */
-export declare function interpolateCore(arrayX: Float64Array | Float64Array<SharedArrayBuffer>, arrayY: Float32Array | Float32Array<SharedArrayBuffer>, groups: InterpolateGroup[]): void;
-/**
- * Apply linear drift correction over one or more `[start, end, value]`
- * ranges in place on `arrayY`, using `arrayX` only to compute each
- * range's time anchors. Per-point formula:
- *
- *     y_i += value * (x_i - startDatetime) / extent
- *
- * where `startDatetime = x[start]` and `extent = x[end] - x[start]`.
- * Ranges with non-positive extent are skipped to match the worker's
- * behaviour. The whole operation is O(total range length) — no
- * chunking or spawning, suitable for the inline calibration path.
- */
-export declare function driftCorrectionCore(arrayX: Float64Array | Float64Array<SharedArrayBuffer>, arrayY: Float32Array | Float32Array<SharedArrayBuffer>, ranges: [number, number, number][]): void;
-/**
- * Apply an arithmetic operator to `arrayY` at each index in
- * `indexes`. Operator strings match `Operator` enum values.
- */
-export declare function changeValuesCore(arrayY: Float32Array | Float32Array<SharedArrayBuffer>, indexes: ArrayLike<number>, operator: string, value: number): void;

package/dist/utils/plotting/persistence.worker.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/utils/plotting/rate-of-change.worker.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/utils/plotting/shift-datetimes.worker.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/utils/plotting/value-threshold.worker.d.ts

@@ -1 +0,0 @@
-export {};