@moddable/typings 9.0.1 → 10.0.0

package/web/websocket.d.ts

@@ -23,15 +23,15 @@ declare module "web/websocket" {
 
   interface WebSocketClientOptions {
     url: string;
-    protocol?: string;
+    protocol?: string | string[];
     keepalive?: number;
-    headers?: Headers | Record<string, string>;
+    headers?: Headers | Map<string, string>;
     ws?: any;
     wss?: any;
   }
 
   interface WebSocketAttachOptions {
-    attach: any;
+    attach: import("embedded:io/socket/tcp").default;
   }
 
   interface WebSocketCloseEvent {
@@ -55,7 +55,7 @@ declare module "web/websocket" {
   type WebSocketEventListener = (event: any) => void;
 
   class WebSocket {
-    constructor(url: string, protocol?: string);
+    constructor(url: string, protocols?: string | string[]);
     constructor(options: WebSocketClientOptions);
     constructor(options: WebSocketAttachOptions);
 
@@ -76,15 +76,15 @@ declare module "web/websocket" {
     readonly readyState: number;
     readonly url: string;
 
-    onclose?(event: WebSocketCloseEvent): void;
-    onerror?(event: WebSocketErrorEvent): void;
-    onmessage?(event: WebSocketMessageEvent): void;
-    onopen?(event: WebSocketEvent): void;
+    onclose: ((this: WebSocket, event: WebSocketCloseEvent) => void) | null;
+    onerror: ((this: WebSocket, event: WebSocketErrorEvent) => void) | null;
+    onmessage: ((this: WebSocket, event: WebSocketMessageEvent) => void) | null;
+    onopen: ((this: WebSocket, event: WebSocketEvent) => void) | null;
 
-    addEventListener(event: "close", listener: (event: WebSocketCloseEvent) => void): void;
-    addEventListener(event: "error", listener: (event: WebSocketErrorEvent) => void): void;
-    addEventListener(event: "message", listener: (event: WebSocketMessageEvent) => void): void;
-    addEventListener(event: "open", listener: (event: WebSocketEvent) => void): void;
+    addEventListener(event: "close", listener: (this: WebSocket, event: WebSocketCloseEvent) => void): void;
+    addEventListener(event: "error", listener: (this: WebSocket, event: WebSocketErrorEvent) => void): void;
+    addEventListener(event: "message", listener: (this: WebSocket, event: WebSocketMessageEvent) => void): void;
+    addEventListener(event: "open", listener: (this: WebSocket, event: WebSocketEvent) => void): void;
 
     removeEventListener(event: "close" | "error" | "message" | "open", listener: WebSocketEventListener): void;
 
@@ -93,4 +93,9 @@ declare module "web/websocket" {
   }
 
   export default WebSocket;
-}
+}
+
+// the specifier of the module in the Moddable SDK runtime
+declare module "WebSocket" {
+  export { default } from "web/websocket";
+}

package/web/webstorage.d.ts

@@ -18,6 +18,9 @@
 *
 */
 
+// the manifest that supplies this module includes the manifests of these configurations
+/// <reference path="../config/storage.d.ts" />
+
 declare module "webstorage" {
   class WebStorage {
     constructor(kvp: any);

package/web/worker.d.ts

@@ -37,6 +37,8 @@ declare module "worker" {
 			symbol?: number;
 		};
 		nativeStack?: number;
+		core?: number;
+		priority?: number;
 	}
 
 	interface MessagePort {

package/websocket.d.ts

@@ -28,6 +28,7 @@ declare module "websocket" {
   }
   export type WebSocketClientCallback = (message: number, value?: any) => void;
 
+  /** @deprecated Use WebSocket, or the ECMA-419 embedded:network/websocket/client and the embedded:network/http/server/route/ws/handshake route */
   export class Client {
     static readonly connect: number;
     static readonly handshake: number;
@@ -43,6 +44,7 @@ declare module "websocket" {
   export type WebSocketServerOptions = ListenerOptions
   export type WebSocketServerCallback = (message: number, value?: any) => void;
 
+  /** @deprecated Use WebSocket, or the ECMA-419 embedded:network/websocket/client and the embedded:network/http/server/route/ws/handshake route */
   export class Server {
     static readonly connect: number;
     static readonly handshake: number;

package/wifi.d.ts

@@ -42,6 +42,7 @@ declare module "wifi" {
     max?: number
   }
 
+  /** @deprecated Use the ECMA-419 Wi-Fi network interface, embedded:network/interface/wifi */
   class WiFi {
     static readonly gotIP: "gotIP";
     static readonly lostIP: "lostIP";

package/xs.d.ts

@@ -19,7 +19,7 @@
  */
 
  interface Trace {
-	(...log: (string | number | boolean)[]):void;
+	(...log: unknown[]):void;
 	left(log: string | ArrayBufferLike, conversation?: string):void;
 	center(log: string | ArrayBufferLike, conversation?: string):void;
 	right(log: string | ArrayBufferLike, conversation?: string):void;
@@ -53,7 +53,7 @@ interface JSON {
 }
 
 interface StringConstructor {
-	fromArrayBuffer(buffer: ArrayBufferLike): string;
+	fromArrayBuffer(buffer: ArrayBufferLike, byteOffset?: number, byteLength?: number): string;
 }
 
 interface ArrayBufferConstructor {
@@ -63,17 +63,26 @@ interface ArrayBufferConstructor {
 
 interface ArrayBuffer {
 	concat(...buffers: ArrayBufferLike[]): ArrayBuffer;
+
+	// immutable ArrayBuffers (not yet in every XS deployment: only where mxImmutableArrayBuffers is enabled)
+	readonly immutable: boolean;
+	sliceToImmutable(start?: number, end?: number): ArrayBuffer;
+	transferToImmutable(newByteLength?: number): ArrayBuffer;
+}
+
+interface ToBase64Options {
+	alphabet?: "base64url" | "base64";
+	omitPadding?: boolean;
 }
 
 interface Uint8Array {
 	toHex(): string;
-	toBase64(): string
+	toBase64(options?: ToBase64Options): string
 }
 
 interface FromBase64Options {
 	alphabet?: "base64url" | "base64";
 	lastChunkHandling?: "stop-before-partial" | "strict" | "loose";
-	omitPadding?: boolean;
 }
 
 interface Uint8ArrayConstructor {
@@ -91,7 +100,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
 }
@@ -100,4 +110,42 @@ interface Math {
 declare function Native(name: string): new (...args: any[]) => any;
 declare function native(name: string): (...args: any[]) => any;
 
-// Compartment?
+
+/*
+	Compartment (see documentation/xs/XS Compartment.md)
+*/
+interface ModuleDescriptor {
+	source?: string | ModuleSource | object;
+	importMeta?: object;
+	specifier?: string;
+	namespace?: string | object;
+	compartment?: Compartment;
+	archive?: object;
+	path?: string;
+}
+interface CompartmentOptions {
+	globals?: object;
+	globalLexicals?: object;
+	modules?: Record<string, ModuleDescriptor>;
+	loadHook?: (specifier: string) => Promise<ModuleDescriptor>;
+	loadNowHook?: (specifier: string) => ModuleDescriptor;
+	resolveHook?: (importSpecifier: string, referrerSpecifier: string) => string;
+}
+declare class Compartment {
+	constructor(options?: CompartmentOptions);
+	readonly globalThis: Record<PropertyKey, any>;
+	evaluate(script: string): any;
+	import(specifier: string): Promise<any>;
+	importNow(specifier: string): any;
+}
+declare class ModuleSource {
+	constructor(source: string);
+	readonly bindings: object[];
+	readonly needsImport: boolean;
+	readonly needsImportMeta: boolean;
+}
+
+/*
+	abort hook: when a function, XS calls it before aborting. Returning false ignores the abort.
+*/
+declare var abort: ((message: string, exception?: any) => boolean | void) | undefined;

package/display.d.ts

@@ -1,68 +0,0 @@
-/*
- * Copyright (c) 2025  Moddable Tech, Inc.
- *
- *   This file is part of the Moddable SDK Runtime.
- *
- *   The Moddable SDK Runtime is free software: you can redistribute it and/or modify
- *   it under the terms of the GNU Lesser 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 Runtime 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 Lesser General Public License for more details.
- *
- *   You should have received a copy of the GNU Lesser General Public License
- *   along with the Moddable SDK Runtime.  If not, see <http://www.gnu.org/licenses/>.
- *
- */
-
-declare module "embedded:display" {
-	export interface DisplayConstructorOptions {
-		format?: number;
-		rotation?: number;
-		brightness?: number;
-		flip?: "h" | "v" | "hv";
-	}
-
-	export interface DisplayConfigureOptions {
-		brightness?: number;
-		format?: number;
-		rotation?: number;
-	}
-
-	export interface DisplayConfiguration {
-		brightness?: number;
-		format?: number;
-		rotation?: number;
-	}
-
-	export interface DisplayBeginOptions {
-		x: number;
-		y: number;
-		width: number;
-		height: number;
-		continue?: boolean;
-	}
-
-	export interface DisplayRectangle {
-		x: number;
-		y: number;
-		width: number;
-		height: number;
-	}
-
-	export default class Display {
-		constructor(options: DisplayConstructorOptions);
-		close(): void;
-		configure(options: DisplayConfigureOptions): void;
-		get configuration(): DisplayConfiguration;
-		begin(options?: DisplayBeginOptions): void;
-		send(buffer: ByteBuffer): void;
-		end(): void;
-		adapInvalid(options: DisplayRectangle): void;
-		get width(): number;
-		get height(): number;
-	}
-}

package/pebble/device.d.ts

@@ -1,51 +0,0 @@
-/*
-* Copyright (c) 2025-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:provider/builtin" {
-
-  const device: {
-    readonly network: {
-      http: {
-        io: typeof import("embedded:network/http/client").default;
-        protocol: "http";
-      };
-      https: {
-        io: typeof import("embedded:network/http/client").default;
-        protocol: "https";
-      };
-      ws: {
-        io: typeof import("embedded:network/websocket/client").default;
-        secure: false;
-      };
-      wss: {
-        io: typeof import("embedded:network/websocket/client").default;
-        secure: true;
-      };
-    };
-    readonly info: {
-      readonly language: string,
-      readonly serialNumber: string,
-    }
-    readonly files: import("embedded:storage/files").Directory;
-    readonly keyValue: typeof import("embedded:storage/key-value").default;
-  }
-
-  export default device;
-}