@synnaxlabs/x 0.14.1 → 0.14.2

package/.turbo/turbo-build.log

@@ -1,5 +1,5 @@
 
-> @synnaxlabs/x@0.14.1 build /home/runner/work/synnax/synnax/x/ts
+> @synnaxlabs/x@0.14.2 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  209.89 kB │ gzip: 49.04 kB │ map: 632.82 kB
-[vite:dts] Declaration files built in 3265ms.
+dist/x.js  213.15 kB │ gzip: 49.72 kB │ map: 639.91 kB
+[vite:dts] Declaration files built in 3061ms.
 
-dist/x.cjs  137.61 kB │ gzip: 39.21 kB │ map: 612.53 kB
-✓ built in 4.16s
+dist/x.cjs  140.09 kB │ gzip: 39.81 kB │ map: 619.46 kB
+✓ built in 3.99s

package/dist/telem/generate.d.ts

@@ -1,2 +1,2 @@
-import { DataTypeT, NativeTypedArray } from './telem';
-export declare const randomSeries: (length: number, dataType: DataTypeT) => NativeTypedArray;
+import { type DataTypeT, type TypedArray } from './telem';
+export declare const randomSeries: (length: number, dataType: DataTypeT) => TypedArray;

package/dist/telem/series.d.ts

@@ -1,7 +1,7 @@
 import { type z } from "zod";
 import { bounds } from '../spatial';
 import { type GLBufferController, type GLBufferUsage } from './gl';
-import { DataType, type NativeTypedArray, type Rate, Size, TimeRange, type TimeStamp, type CrudeDataType } from './telem';
+import { DataType, type TypedArray, type Rate, Size, TimeRange, TimeStamp, type CrudeDataType, type TelemValue } from './telem';
 export type SampleValue = number | bigint;
 export interface SeriesDigest {
     key: string;
@@ -20,8 +20,10 @@ interface BaseSeriesProps {
     alignment?: number;
     key?: string;
 }
+export type CrudeSeries = Series | ArrayBuffer | TypedArray | string[] | number[] | boolean[] | unknown[] | TimeStamp[] | Date[] | TelemValue;
+export declare const isCrudeSeries: (value: unknown) => value is CrudeSeries;
 export interface SeriesProps extends BaseSeriesProps {
-    data: ArrayBuffer | NativeTypedArray;
+    data: CrudeSeries;
 }
 export interface SeriesAllocProps extends BaseSeriesProps {
     capacity: number;
@@ -56,19 +58,20 @@ export declare class Series {
     readonly _timeRange?: TimeRange;
     readonly alignment: number;
     /** A cached minimum value. */
-    private _min?;
+    private _cachedMin?;
     /** A cached maximum value. */
-    private _max?;
+    private _cachedMax?;
     /** The write position of the buffer. */
     private writePos;
     /** Tracks the number of entities currently using this array. */
     private _refCount;
+    private _cachedLength?;
+    constructor(props: SeriesProps | CrudeSeries);
     static alloc({ capacity: length, dataType, ...props }: SeriesAllocProps): Series;
     static generateTimestamps(length: number, rate: Rate, start: TimeStamp): Series;
     get refCount(): number;
     static fromStrings(data: string[], timeRange?: TimeRange): Series;
     static fromJSON<T>(data: T[], timeRange?: TimeRange): Series;
-    constructor({ data, dataType, timeRange, sampleOffset, glBufferUsage, alignment, key, }: SeriesProps);
     acquire(gl?: GLBufferController): void;
     release(): void;
     /**
@@ -84,7 +87,7 @@ export declare class Series {
     get buffer(): ArrayBufferLike;
     private get underlyingData();
     /** @returns a native typed array with the proper data type. */
-    get data(): NativeTypedArray;
+    get data(): TypedArray;
     toStrings(): string[];
     toUUIDs(): string[];
     parseJSON<Z extends z.ZodTypeAny>(schema: Z): Array<z.output<Z>>;
@@ -98,6 +101,7 @@ export declare class Series {
     get byteLength(): Size;
     /** @returns the number of samples in this array. */
     get length(): number;
+    private calculateCachedLength;
     /**
      * Creates a new array with a different data type.
      * @param target the data type to convert to.

package/dist/telem/telem.d.ts

@@ -565,10 +565,11 @@ export declare class DataType extends String implements Stringer {
     /**
      * @returns the TypedArray constructor for the DataType.
      */
-    get Array(): NativeTypedArrayConstructor;
+    get Array(): TypedArrayConstructor;
     equals(other: DataType): boolean;
     /** @returns a string representation of the DataType. */
     toString(): string;
+    get isVariable(): boolean;
     get density(): Density;
     /**
      * Checks whether the given TypedArray is of the same type as the DataType.
@@ -576,7 +577,7 @@ export declare class DataType extends String implements Stringer {
      * @param array - The TypedArray to check.
      * @returns True if the TypedArray is of the same type as the DataType.
      */
-    checkArray(array: NativeTypedArray): boolean;
+    checkArray(array: TypedArray): boolean;
     toJSON(): string;
     get usesBigInt(): boolean;
     /** Represents an Unknown/Invalid DataType. */
@@ -601,6 +602,8 @@ export declare class DataType extends String implements Stringer {
     static readonly UINT16: DataType;
     /** Represents a 8-bit unsigned integer value. */
     static readonly UINT8: DataType;
+    /** Represents a boolean value. Alias for UINT8. */
+    static readonly BOOLEAN: DataType;
     /** Represents a 64-bit unix epoch. */
     static readonly TIMESTAMP: DataType;
     /** Represents a UUID data type */
@@ -611,7 +614,7 @@ export declare class DataType extends String implements Stringer {
     /** Represents a JSON data type. JSON has an unknown density, and is separated by a
      * newline character. */
     static readonly JSON: DataType;
-    static readonly ARRAY_CONSTRUCTORS: Map<string, NativeTypedArrayConstructor>;
+    static readonly ARRAY_CONSTRUCTORS: Map<string, TypedArrayConstructor>;
     static readonly ARRAY_CONSTRUCTOR_DATA_TYPES: Map<string, DataType>;
     static readonly DENSITIES: Map<string, Density>;
     /** All the data types. */
@@ -697,7 +700,7 @@ export type CrudeRate = Rate | number | Number;
 export type RateT = number;
 export type CrudeDensity = Density | number | Number;
 export type DensityT = number;
-export type CrudeDataType = DataType | string | NativeTypedArray;
+export type CrudeDataType = DataType | string | TypedArray;
 export type DataTypeT = string;
 export type CrudeSize = Size | number | Number;
 export type SizeT = number;
@@ -705,9 +708,11 @@ export interface CrudeTimeRange {
     start: CrudeTimeStamp;
     end: CrudeTimeStamp;
 }
-export declare const nativeTypedArray: 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 NativeTypedArray = z.infer<typeof nativeTypedArray>;
-type NativeTypedArrayConstructor = Uint8ArrayConstructor | Uint16ArrayConstructor | Uint32ArrayConstructor | BigUint64ArrayConstructor | Float32ArrayConstructor | Float64ArrayConstructor | Int8ArrayConstructor | Int16ArrayConstructor | Int32ArrayConstructor | BigInt64ArrayConstructor;
-type TelemValue = number | bigint;
-export declare const convertDataType: (source: DataType, target: DataType, value: TelemValue, offset?: number | bigint) => TelemValue;
+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 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;
 export {};