@synnaxlabs/x 0.14.2 → 0.15.0

package/.turbo/turbo-build.log

@@ -1,5 +1,5 @@
 
-> @synnaxlabs/x@0.14.2 build /home/runner/work/synnax/synnax/x/ts
+> @synnaxlabs/x@0.15.0 build /home/runner/work/synnax/synnax/x/ts
 > tsc --noEmit && vite build
 
 vite v5.1.2 building for production...
@@ -10,8 +10,8 @@ rendering chunks...
 
 [vite:dts] Start generate declaration files...
 computing gzip size...
-dist/x.js  213.15 kB │ gzip: 49.72 kB │ map: 639.91 kB
-[vite:dts] Declaration files built in 3061ms.
+dist/x.js  217.59 kB │ gzip: 50.60 kB │ map: 651.51 kB
+[vite:dts] Declaration files built in 3123ms.
 
-dist/x.cjs  140.09 kB │ gzip: 39.81 kB │ map: 619.46 kB
-✓ built in 3.99s
+dist/x.cjs  143.43 kB │ gzip: 40.54 kB │ map: 630.60 kB
+✓ built in 4.05s

package/dist/telem/series.d.ts

@@ -1,12 +1,11 @@
 import { type z } from "zod";
 import { bounds } from '../spatial';
 import { type GLBufferController, type GLBufferUsage } from './gl';
-import { DataType, type TypedArray, type Rate, Size, TimeRange, TimeStamp, type CrudeDataType, type TelemValue } from './telem';
-export type SampleValue = number | bigint;
+import { DataType, type TypedArray, type Rate, Size, TimeRange, TimeStamp, type CrudeDataType, type TelemValue, type NumericTelemValue } from './telem';
 export interface SeriesDigest {
     key: string;
     dataType: string;
-    sampleOffset: SampleValue;
+    sampleOffset: NumericTelemValue;
     alignment: bounds.Bounds;
     timeRange?: string;
     length: number;
@@ -15,7 +14,7 @@ export interface SeriesDigest {
 interface BaseSeriesProps {
     dataType?: CrudeDataType;
     timeRange?: TimeRange;
-    sampleOffset?: SampleValue;
+    sampleOffset?: NumericTelemValue;
     glBufferUsage?: GLBufferUsage;
     alignment?: number;
     key?: string;
@@ -39,7 +38,7 @@ export interface SeriesMemInfo {
  * Series is a strongly typed array of telemetry samples backed by an underlying binary
  * buffer.
  */
-export declare class Series {
+export declare class Series<T extends TelemValue = TelemValue> {
     key: string;
     /** The data type of the array */
     readonly dataType: DataType;
@@ -48,7 +47,7 @@ export declare class Series {
      * downwards. Typically used to convert arrays to lower precision while preserving
      * the relative range of actual values.
      */
-    sampleOffset: SampleValue;
+    sampleOffset: NumericTelemValue;
     /**
      * Stores information about the buffer state of this array into a WebGL buffer.
      */
@@ -111,34 +110,55 @@ export declare class Series {
      * WARNING: This method is expensive and copies the entire underlying array. There
      * also may be untimely precision issues when converting between data types.
      */
-    convert(target: DataType, sampleOffset?: SampleValue): Series;
+    convert(target: DataType, sampleOffset?: NumericTelemValue): Series;
     private calcRawMax;
     /** @returns the maximum value in the array */
-    get max(): SampleValue;
+    get max(): NumericTelemValue;
     private calcRawMin;
     /** @returns the minimum value in the array */
-    get min(): SampleValue;
+    get min(): NumericTelemValue;
     /** @returns the bounds of this array. */
     get bounds(): bounds.Bounds;
     private maybeRecomputeMinMax;
     enrich(): void;
-    get range(): SampleValue;
-    at(index: number, required: true): SampleValue;
-    at(index: number, required?: false): SampleValue | undefined;
+    get range(): NumericTelemValue;
+    at(index: number, required: true): T;
+    at(index: number, required?: false): T | undefined;
+    private atVariable;
     /**
      * @returns the index of the first sample that is greater than or equal to the given value.
      * The underlying array must be sorted. If it is not, the behavior of this method is undefined.
      * @param value the value to search for.
      */
-    binarySearch(value: SampleValue): number;
+    binarySearch(value: NumericTelemValue): number;
     updateGLBuffer(gl: GLBufferController): void;
+    as(dataType: "string"): Series<string>;
+    as(dataType: "number"): Series<number>;
+    as(dataType: "bigint"): Series<bigint>;
+    as(dataType: "numeric"): Series<NumericTelemValue>;
     get digest(): SeriesDigest;
     get memInfo(): SeriesMemInfo;
     get alignmentBounds(): bounds.Bounds;
     private maybeGarbageCollectGLBuffer;
     get glBuffer(): WebGLBuffer;
+    [Symbol.iterator](): Iterator<T>;
     slice(start: number, end?: number): Series;
     reAlign(alignment: number): Series;
 }
-export declare const addSamples: (a: SampleValue, b: SampleValue) => SampleValue;
+export declare const addSamples: (a: NumericTelemValue, b: NumericTelemValue) => NumericTelemValue;
+export declare class MultiSeries<T extends TelemValue = TelemValue> implements Iterable<T> {
+    readonly series: Array<Series<T>>;
+    constructor(series: Array<Series<T>>);
+    as(dataType: "string"): MultiSeries<string>;
+    as(dataType: "number"): MultiSeries<number>;
+    as(dataType: "bigint"): MultiSeries<bigint>;
+    as(dataType: "numeric"): MultiSeries<NumericTelemValue>;
+    get dataType(): DataType;
+    get timeRange(): TimeRange;
+    push(series: Series<T>): void;
+    get length(): number;
+    at(index: number, required: true): T;
+    at(index: number, required?: false): T | undefined;
+    [Symbol.iterator](): Iterator<T>;
+}
 export {};

package/dist/telem/telem.d.ts

@@ -711,7 +711,7 @@ export interface CrudeTimeRange {
 export declare const typedArrayZ: z.ZodUnion<[z.ZodType<Uint8Array, z.ZodTypeDef, Uint8Array>, z.ZodType<Uint16Array, z.ZodTypeDef, Uint16Array>, z.ZodType<Uint32Array, z.ZodTypeDef, Uint32Array>, z.ZodType<BigUint64Array, z.ZodTypeDef, BigUint64Array>, z.ZodType<Float32Array, z.ZodTypeDef, Float32Array>, z.ZodType<Float64Array, z.ZodTypeDef, Float64Array>, z.ZodType<Int8Array, z.ZodTypeDef, Int8Array>, z.ZodType<Int16Array, z.ZodTypeDef, Int16Array>, z.ZodType<Int32Array, z.ZodTypeDef, Int32Array>, z.ZodType<BigInt64Array, z.ZodTypeDef, BigInt64Array>]>;
 export type TypedArray = z.infer<typeof typedArrayZ>;
 type TypedArrayConstructor = Uint8ArrayConstructor | Uint16ArrayConstructor | Uint32ArrayConstructor | BigUint64ArrayConstructor | Float32ArrayConstructor | Float64ArrayConstructor | Int8ArrayConstructor | Int16ArrayConstructor | Int32ArrayConstructor | BigInt64ArrayConstructor;
-type NumericTelemValue = number | bigint;
+export type NumericTelemValue = number | bigint;
 export type TelemValue = number | bigint | string | boolean | Date | TimeStamp | TimeSpan;
 export declare const isTelemValue: (value: unknown) => value is TelemValue;
 export declare const convertDataType: (source: DataType, target: DataType, value: NumericTelemValue, offset?: number | bigint) => NumericTelemValue;