@moddable/typings 9.0.1 → 9.5.0

package/captiveportal.d.ts

@@ -0,0 +1,71 @@
+/*
+* Copyright (c) 2026 Moddable Tech, Inc.
+*
+*   This file is part of the Moddable SDK Tools.
+*
+*   The Moddable SDK Tools is free software: you can redistribute it and/or modify
+*   it under the terms of the GNU General Public License as published by
+*   the Free Software Foundation, either version 3 of the License, or
+*   (at your option) any later version.
+*
+*   The Moddable SDK Tools is distributed in the hope that it will be useful,
+*   but WITHOUT ANY WARRANTY; without even the implied warranty of
+*   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+*   GNU General Public License for more details.
+*
+*   You should have received a copy of the GNU General Public License
+*   along with the Moddable SDK Tools.  If not, see <http://www.gnu.org/licenses/>.
+*
+*/
+
+declare module "captiveportal" {
+	export type CaptivePortalPhase = "initializing" | "ready" | "connected" | "waiting" |
+		"connecting" | "provisioned" | "failed";
+
+	export interface CaptivePortalAccess {
+		SSID: string;
+		password?: string;
+	}
+
+	export interface CaptivePortalCredentials {
+		SSID: string;
+		password?: string;
+		channel?: number;
+		secure?: boolean;
+	}
+
+	export interface CaptivePortalNetwork {
+		SSID: string;
+		RSSI: number;
+		channel: number;
+		security?: string;
+	}
+
+	export interface CaptivePortalPage {
+		content: string | ArrayBuffer | HostBuffer;
+		mimeType: string;
+	}
+
+	export interface CaptivePortalOptions {
+		onPage: (this: void, path: string) => CaptivePortalPage | undefined;
+
+		onStatus?: (this: void, phase: CaptivePortalPhase, detail?: CaptivePortalAccess | CaptivePortalCredentials) => void;
+		onInfo?: (this: void, msg: any) => void;
+		onClose?: (this: void) => void;
+		onError?: (this: void, error: Error) => void;
+
+		SSID?: string;
+		password?: string;
+		channel?: number;
+	}
+
+	class CaptivePortal {
+		constructor(options: CaptivePortalOptions);
+
+		close(): void;
+
+		readonly SSID: string | undefined;
+	}
+
+	export default CaptivePortal;
+}

package/data/location/nmea.d.ts

@@ -0,0 +1,103 @@
+/*
+* Copyright (c) 2026 Moddable Tech, Inc.
+*
+*   This file is part of the Moddable SDK Tools.
+*
+*   The Moddable SDK Tools is free software: you can redistribute it and/or modify
+*   it under the terms of the GNU General Public License as published by
+*   the Free Software Foundation, either version 3 of the License, or
+*   (at your option) any later version.
+*
+*   The Moddable SDK Tools is distributed in the hope that it will be useful,
+*   but WITHOUT ANY WARRANTY; without even the implied warranty of
+*   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+*   GNU General Public License for more details.
+*
+*   You should have received a copy of the GNU General Public License
+*   along with the Moddable SDK Tools.  If not, see <http://www.gnu.org/licenses/>.
+*
+*/
+
+declare module "data/location/nmea" {
+  interface NMEATalker {
+    readonly GP: "GPS";
+    readonly GN: "GNSS";
+    readonly GL: "GLONASS";
+    readonly GA: "Galileo";
+    readonly GB: "BeiDou";
+    readonly BD: "BeiDou";
+    readonly QZ: "QZSS";
+    readonly P: "Proprietary";
+    readonly [id: string]: string | undefined;
+  }
+
+  interface NMEASatellite {
+    prn: number;
+    elevation: number | null;
+    azimuth: number | null;
+    snr: number | null;
+  }
+
+  interface NMEASentence {
+    type: string;
+    talker: string;
+    system: string;
+    raw: string;
+    time?: string | null;
+    date?: string | null;
+    latitude?: number | null;
+    longitude?: number | null;
+    altitude?: number | null;
+    geoidSeparation?: number | null;
+    quality?: number;
+    satellites?: number | NMEASatellite[];
+    hdop?: number | null;
+    pdop?: number | null;
+    vdop?: number | null;
+    speed?: number | null;
+    course?: number | null;
+    status?: string | null;
+    mode?: string | null;
+    fix?: boolean;
+    fixType?: number;
+    satellitesUsed?: number[];
+    totalMessages?: number;
+    messageNumber?: number;
+    satellitesInView?: number;
+    day?: number | null;
+    month?: number | null;
+    year?: number | null;
+    fields?: string[];
+    [key: string]: unknown;
+  }
+
+  interface NMEALocationUpdate {
+    latitude?: number;
+    longitude?: number;
+    altitude?: number;
+    accuracy?: number;
+    heading?: number;
+    speed?: number;
+    fix?: boolean;
+  }
+
+  class NMEA {
+    constructor(onParsed?: (parsed: NMEASentence) => void);
+    push(data: number | ArrayBuffer | ArrayBufferView): NMEASentence | undefined;
+
+    static readonly Talker: NMEATalker;
+    static readonly identification: {
+      readonly model: string;
+      readonly classification: string;
+      readonly description: string;
+    };
+    static parse(sentence: string | ArrayBuffer | ArrayBufferView): NMEASentence | null;
+    static validateChecksum(sentence: string | ArrayBuffer | ArrayBufferView): Uint8Array | null;
+    static toDecimalDegrees(value: string, hemi: string): number | null;
+    static checksum(payload: string): string;
+    static format(payload: string): string;
+    static location(parsed: NMEASentence | null | undefined): NMEALocationUpdate | undefined;
+  }
+
+  export { NMEA as default, NMEA };
+}

package/data/location/ubx.d.ts

@@ -0,0 +1,78 @@
+/*
+* Copyright (c) 2026 Moddable Tech, Inc.
+*
+*   This file is part of the Moddable SDK Tools.
+*
+*   The Moddable SDK Tools is free software: you can redistribute it and/or modify
+*   it under the terms of the GNU General Public License as published by
+*   the Free Software Foundation, either version 3 of the License, or
+*   (at your option) any later version.
+*
+*   The Moddable SDK Tools is distributed in the hope that it will be useful,
+*   but WITHOUT ANY WARRANTY; without even the implied warranty of
+*   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+*   GNU General Public License for more details.
+*
+*   You should have received a copy of the GNU General Public License
+*   along with the Moddable SDK Tools.  If not, see <http://www.gnu.org/licenses/>.
+*
+*/
+
+declare module "data/location/ubx" {
+  interface UBXMessage {
+    type: string;
+    class?: number;
+    id?: number;
+    payloadLength?: number;
+    latitude?: number;
+    longitude?: number;
+    altitude?: number;
+    accuracy?: number;
+    altitudeAccuracy?: number;
+    speed?: number;
+    course?: number;
+    pdop?: number;
+    satellites?: number;
+    fixType?: number;
+    fix?: boolean;
+    status?: string;
+    quality?: number;
+    [key: string]: unknown;
+  }
+
+  interface UBXLocationUpdate {
+    latitude?: number;
+    longitude?: number;
+    altitude?: number;
+    accuracy?: number;
+    altitudeAccuracy?: number;
+    heading?: number;
+    speed?: number;
+    fix: boolean;
+  }
+
+  class UBX {
+    constructor(onParsed?: (parsed: UBXMessage) => void);
+    push(data: number | ArrayBuffer | ArrayBufferView): UBXMessage | undefined;
+
+    static readonly SYNC1: 0xb5;
+    static readonly SYNC2: 0x62;
+    static readonly CLASS_NAV: 0x01;
+    static readonly ID_NAV_PVT: 0x07;
+    static readonly CLASS_CFG: 0x06;
+    static readonly ID_CFG_MSG: 0x01;
+    static readonly identification: {
+      readonly model: string;
+      readonly classification: string;
+      readonly description: string;
+    };
+    static checksum(bytes: Uint8Array, offset: number, length: number): [number, number];
+    static format(msgClass: number, msgId: number, payload?: ArrayBuffer | ArrayBufferView): ArrayBuffer;
+    static parse(frame: ArrayBuffer | ArrayBufferView): UBXMessage | null;
+    static parseNAVPVT(view: DataView): UBXMessage | null;
+    static location(parsed: UBXMessage | null | undefined): UBXLocationUpdate | undefined;
+    static setup(): ArrayBuffer[];
+  }
+
+  export { UBX as default, UBX };
+}

package/embedded/sensor/Barometer-Humidity-Temperature/BME280.d.ts

@@ -0,0 +1,102 @@
+/*
+* Copyright (c) 2026 Moddable Tech, Inc.
+*
+*   This file is part of the Moddable SDK Tools.
+*
+*   The Moddable SDK Tools is free software: you can redistribute it and/or modify
+*   it under the terms of the GNU General Public License as published by
+*   the Free Software Foundation, either version 3 of the License, or
+*   (at your option) any later version.
+*
+*   The Moddable SDK Tools is distributed in the hope that it will be useful,
+*   but WITHOUT ANY WARRANTY; without even the implied warranty of
+*   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+*   GNU General Public License for more details.
+*
+*   You should have received a copy of the GNU General Public License
+*   along with the Moddable SDK Tools.  If not, see <http://www.gnu.org/licenses/>.
+*
+*/
+
+declare module "embedded:sensor/Barometer-Humidity-Temperature/BME280" {
+  interface BME280IO {
+    write(buffer: ArrayBuffer | ArrayBufferView, stop?: boolean): void;
+    read(buffer: ArrayBuffer | ArrayBufferView): void;
+    close(): void;
+  }
+
+  interface BME280SensorOptions {
+    io: new (options: object) => BME280IO;
+    address?: number;
+    hz?: number;
+    data?: number | string;
+    clock?: number | string;
+    [key: string]: unknown;
+  }
+
+  interface BME280Options {
+    sensor: BME280SensorOptions;
+    target?: unknown;
+  }
+
+  interface BME280Configuration {
+    mode?: number;
+    temperatureSampling?: number;
+    pressureSampling?: number;
+    humiditySampling?: number;
+    filter?: number;
+    standbyDuration?: number;
+  }
+
+  interface BME280Sample {
+    thermometer: { temperature: number };
+    hygrometer: { humidity?: number };
+    barometer: { pressure: number };
+  }
+
+  interface BME280ConfigConstants {
+    readonly Sampling: {
+      readonly SKIPPED: 0x00;
+      readonly X1: 0x01;
+      readonly X2: 0x02;
+      readonly X4: 0x03;
+      readonly X8: 0x04;
+      readonly X16: 0x05;
+    };
+    readonly Filter: {
+      readonly OFF: 0x00;
+      readonly X2: 0x01;
+      readonly X4: 0x02;
+      readonly X8: 0x03;
+      readonly X16: 0x04;
+    };
+    readonly Mode: {
+      readonly SLEEP: 0x00;
+      readonly FORCED: 0x01;
+      readonly NORMAL: 0x03;
+    };
+    readonly Standby: {
+      readonly MS_0_5: 0x00;
+      readonly MS_62_5: 0x01;
+      readonly MS_125: 0x02;
+      readonly MS_250: 0x03;
+      readonly MS_500: 0x04;
+      readonly MS_1000: 0x05;
+      readonly MS_10: 0x06;
+      readonly MS_20: 0x07;
+    };
+  }
+
+  class BME280 {
+    constructor(options: BME280Options);
+    configure(options: BME280Configuration): void;
+    sample(): BME280Sample;
+    close(): void;
+    target?: unknown;
+  }
+  interface BME280 extends Disposable {}
+
+  const Config: BME280ConfigConstants;
+
+  export { BME280 as default, BME280, Config };
+}

package/embedded/sensor/Location/GPS.d.ts

@@ -0,0 +1,96 @@
+/*
+* Copyright (c) 2026 Moddable Tech, Inc.
+*
+*   This file is part of the Moddable SDK Tools.
+*
+*   The Moddable SDK Tools is free software: you can redistribute it and/or modify
+*   it under the terms of the GNU General Public License as published by
+*   the Free Software Foundation, either version 3 of the License, or
+*   (at your option) any later version.
+*
+*   The Moddable SDK Tools is distributed in the hope that it will be useful,
+*   but WITHOUT ANY WARRANTY; without even the implied warranty of
+*   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+*   GNU General Public License for more details.
+*
+*   You should have received a copy of the GNU General Public License
+*   along with the Moddable SDK Tools.  If not, see <http://www.gnu.org/licenses/>.
+*
+*/
+
+declare module "embedded:sensor/Location/GPS" {
+  interface GPSSensorIO {
+    write(value: ByteBuffer, stop?: boolean): void;
+    writeRead?(writeBuffer: ByteBuffer, readByteLength: number, stop?: boolean): ArrayBuffer;
+    read?(byteLength?: number): number | ArrayBuffer | undefined;
+    close(): void;
+  }
+
+  interface GPSSensorOptions {
+    io: new (options: object) => GPSSensorIO;
+    address?: number;
+    hz?: number;
+    data?: number | string;
+    clock?: number | string;
+    receive?: number | string;
+    transmit?: number | string;
+    baud?: number;
+    port?: number | string;
+    [key: string]: unknown;
+  }
+
+  interface GPSProtocol {
+    new (onParsed?: (parsed: object) => void): {
+      push(data: number | ArrayBuffer | ArrayBufferView): object | undefined;
+    };
+    location(parsed: object | null | undefined): object | undefined;
+    identification: {
+      model: string;
+      classification: string;
+      description: string;
+    };
+    setup?(): ArrayBuffer[];
+  }
+
+  interface GPSOptions {
+    sensor: GPSSensorOptions;
+    protocol: GPSProtocol;
+    onSample?: (this: GPS) => void;
+    onError?: (this: GPS, error: Error) => void;
+    target?: unknown;
+  }
+
+  /** enableHighAccuracy is accepted for Location API alignment; currently a no-op. */
+  interface GPSConfiguration {
+    enableHighAccuracy?: boolean;
+    timeout?: number;
+    maximumAge?: number;
+  }
+
+  interface GPSSample {
+    latitude: number;
+    longitude: number;
+    altitude?: number;
+    accuracy?: number;
+    altitudeAccuracy?: number;
+    heading?: number;
+    speed?: number;
+    timestamp?: number;
+  }
+
+  class GPS {
+    constructor(options: GPSOptions);
+    configure(options: GPSConfiguration): void;
+    sample(): GPSSample | undefined;
+    close(): void;
+    readonly identification: {
+      model: string;
+      classification: string;
+      description: string;
+    };
+    target?: unknown;
+  }
+  interface GPS extends Disposable {}
+
+  export { GPS as default, GPS };
+}

package/embedded/sensor/Location/IP.d.ts

@@ -0,0 +1,67 @@
+/*
+* Copyright (c) 2026 Moddable Tech, Inc.
+*
+*   This file is part of the Moddable SDK Tools.
+*
+*   The Moddable SDK Tools is free software: you can redistribute it and/or modify
+*   it under the terms of the GNU General Public License as published by
+*   the Free Software Foundation, either version 3 of the License, or
+*   (at your option) any later version.
+*
+*   The Moddable SDK Tools is distributed in the hope that it will be useful,
+*   but WITHOUT ANY WARRANTY; without even the implied warranty of
+*   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+*   GNU General Public License for more details.
+*
+*   You should have received a copy of the GNU General Public License
+*   along with the Moddable SDK Tools.  If not, see <http://www.gnu.org/licenses/>.
+*
+*/
+
+declare module "embedded:sensor/Location/IP" {
+  interface IPHTTPOptions {
+    io: new (options: object) => {
+      request(options: object): {
+        read(byteLength?: number): ArrayBuffer | undefined;
+      };
+      close(): void;
+    };
+    host: string;
+    path?: string;
+    port?: number;
+    [key: string]: unknown;
+  }
+
+  interface IPOptions {
+    http?: IPHTTPOptions;
+    onSample?: (this: IP) => void;
+    onError?: (this: IP, error: Error) => void;
+    target?: unknown;
+  }
+
+  interface IPSample {
+    latitude: number;
+    longitude: number;
+    altitude?: number;
+    accuracy?: number;
+    timestamp?: number;
+    timezone?: number;
+    dst?: boolean;
+  }
+
+  class IP {
+    constructor(options: IPOptions);
+    configure(options?: object): void;
+    sample(): IPSample | undefined;
+    close(): void;
+    readonly identification: {
+      model: string;
+      classification: string;
+      description: string;
+    };
+    target?: unknown;
+  }
+  interface IP extends Disposable {}
+
+  export { IP as default, IP };
+}

package/embedded_io/smbus.d.ts

@@ -22,7 +22,7 @@ declare module "embedded:io/smbus" {
   import I2C from "embedded:io/i2c"
 
   class SMBus extends I2C {
-    constructor(options: ConstructorParameters<typeof I2C> & {
+    constructor(options: ConstructorParameters<typeof I2C>[0] & {
       stop?: boolean;
     });
     readUint8(register: number): number;

package/embedded_io/system.d.ts

@@ -19,18 +19,12 @@
 */
 
 declare module "embedded:io/system" {
-  import Timer from "timer";
   /**
-   * @experimetnal
+   * @experimental
    */
   class System {
     static deepSleep(us: number, mode: number): void;
     static restart(): void;
-    static resolve(name: string, callback: (name: string, ip: string) => void) : void;
-    static setTimeout: typeof Timer.set;
-    static clearTimeout: typeof Timer.clear;
-    static setInterval: typeof Timer.repeat;
-    static clearInterval: typeof Timer.clear;
   }
   export default System;
 }

package/embedded_network/http/client.d.ts

@@ -41,7 +41,8 @@ declare module "embedded:network/http/client" {
   export interface HTTPRequest {
     read(byteLength?: number): ArrayBuffer|undefined;
     read(buffer: ByteBuffer): void;
-    write(value: ByteBuffer|undefined): void;
+    write(): number;
+    write(value: ByteBuffer|undefined): number;
   }
 
   class HTTPClient {

package/embedded_network/http/server.d.ts

@@ -26,6 +26,7 @@ declare module "embedded:network/http/server" {
         method: string;
         path: string;
         headers: Map<string, string>;
+        query: string;
     }
 
     export interface HTTPResponse {

package/embedded_network/websocket/client.d.ts

@@ -1,5 +1,5 @@
 /*
-* Copyright (c) 2025 Moddable Tech, Inc.
+* Copyright (c) 2025-2026 Moddable Tech, Inc.
 *
 *   This file is part of the Moddable SDK Tools.
 *
@@ -61,6 +61,7 @@ declare module "embedded:network/websocket/client" {
     read(buffer: ByteBuffer): number;
 
     format: "buffer" | "number";
+    protocol: string | undefined;
     target?: any;
 
     static readonly text: 1;

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@moddable/typings",
-	"version": "9.0.1",
+	"version": "9.5.0",
 	"main": "",
 	"types": "xs",
 	"typesVersions": {

package/xs.d.ts

@@ -91,7 +91,8 @@ interface Math {
 	idiv(a: number, b: number): number
 	imod(a: number, b: number): number
 	imuldiv(a: number, b: number, c: number): number
-	irandom(a: number, b: number): number
+	irandom(min: number, max: number): number
+	irandom(max: number): number
 	irem(a: number, b: number): number
 	mod(a: number, b: number): number
 }