@moddable/typings 7.1.0 → 7.2.1

package/ChatAudioIO.d.ts

@@ -20,9 +20,10 @@
 
 declare module "ChatAudioIO" {
 	type ChatAudioIOOptions = {
-		specifier: "googleGeminiLive" | "openAIRealtime" | "humeAIEVI" | "elevenLabsAgent";
+		specifier: "googleGeminiLive" | "openAIRealtime" | "humeAIEVI" | "elevenLabsAgent" | "deepgramAgent";
 		voiceName?: string;
 		instructions?: string;
+		apiKey?: string;
 
 		onStateChanged?: (this: ChatAudioIO, state: number) => void;
 		onInputTranscript?: (this: ChatAudioIO, text: string, more: boolean) => void;

package/commodetto/Bitmap.d.ts

@@ -45,6 +45,10 @@ declare module "commodetto/Bitmap" {
     static readonly RGB444 = 13
     static readonly JPEG = 14
     static readonly PNG = 15
+    static readonly MonochromeAligned = 21
+    static readonly MonochromePebble = 22
+    static readonly MonochromeARGB2222 = 23
+    static readonly MonochromeGray4 = 24
 
     static readonly RLE = 0x80
   }

package/embedded/storage/files.d.ts

@@ -66,8 +66,8 @@ declare module "embedded:storage/files" {
 		status(path: string, options?: DirectoryStatusOptions): Status;
 
 		createDirectory(path: string): boolean;
-		createLink(path: string, target: string): void;
-		readLink(path: string): string;
+		createLink?(path: string, target: string): void;
+		readLink?(path: string): string;
 
 		scan(path?: string): IterableIterator<string>;
 		[Symbol.iterator](): IterableIterator<string>;

package/embedded/storage/key-value.d.ts

@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2024-2025  Moddable Tech, Inc.
+ * Copyright (c) 2024-2026  Moddable Tech, Inc.
  *
  *   This file is part of the Moddable SDK Runtime.
  *
@@ -20,6 +20,7 @@
 
 declare module "embedded:storage/key-value" {
 	export interface StorageOpenOptions {
+		format?: StorageFormat;
 		path: string;
 		mode?: "r" | "r+";
 	}

package/embedded_network/http/client.d.ts

@@ -20,10 +20,10 @@
 
 declare module "embedded:network/http/client" {
   export interface ClientOptions {
-    socket: any
-    port?:number
+    socket?: any
+    port?: number
     host: string
-    dns: any
+    dns?: any
     onError?: (err:any)=>void
   }
 
@@ -31,7 +31,8 @@ declare module "embedded:network/http/client" {
     method?: string
     path?: string
     headers?: Map<string, string|string[]>
-    onHeaders?: (this: HTTPRequest, status:number, headers: Map<String, string>) => void
+    headersMask?: Array<string>
+    onHeaders?: (this: HTTPRequest, status:number, headers: Map<string, string>, statusText: string) => void
     onReadable?: (this: HTTPRequest, count: number) => void
     onWritable?: (this: HTTPRequest, count: number) => void
     onDone?: (this: HTTPRequest, error: Error|null) => void // note: error is empty Error object

package/embedded_network/websocket/client.d.ts

@@ -0,0 +1,74 @@
+/*
+* Copyright (c) 2025 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/>.
+*
+*/
+
+// websocketclient.d.ts
+
+declare module "embedded:network/websocket/client" {
+  interface WebSocketClientOptions {
+    onReadable?: (this: WebSocketClient, count: number, options: { more: boolean; binary: boolean }) => void;
+    onWritable?: (this: WebSocketClient, count: number) => void;
+    onControl?: (this: WebSocketClient, opcode: number, data: ArrayBuffer) => void;
+    onClose?: (this: WebSocketClient) => void;
+    onError?: (this: WebSocketClient) => void;
+    format?: "buffer" | "number";
+    target?: any;
+    attach?: {
+      constructor: new (options: any) => any;
+    };
+    host?: string;
+    path?: string;
+    port?: number;
+    protocol?: string;
+    headers?: Map<string, string>;
+    dns?: {
+      io: new (options: any) => any;
+    };
+    socket?: {
+      io: new (options: any) => any;
+    };
+  }
+
+  interface WebSocketWriteOptions {
+    opcode?: number;
+    binary?: boolean;
+    more?: boolean;
+  }
+
+  class WebSocketClient {
+    constructor(options: WebSocketClientOptions);
+
+    close(): void;
+    write(data: ByteBuffer, options?: WebSocketWriteOptions): number;
+    read(): number | ArrayBuffer;
+    read(count: number): ArrayBuffer;
+    read(buffer: ByteBuffer): number;
+
+    format: "buffer" | "number";
+    target?: any;
+
+    static readonly text: 1;
+    static readonly binary: 2;
+    static readonly close: 8;
+    static readonly ping: 9;
+    static readonly pong: 10;
+  }
+
+  export default WebSocketClient;
+}

package/global.d.ts

@@ -1,9 +1,12 @@
-import System_ from "embedded:io/system"
-import Device from "embedded:provider/builtin"
+declare module "global" {
 
-export {}
-declare global {
-  // NOTE: `System` is non-standard and temporary to support the IO examples. Breaking changes are possible.
-  var System: typeof System_;
-  var device: typeof Device;
+  import System_ from "embedded:io/system"
+  import Device from "embedded:provider/builtin"
+
+  export {}
+  global {
+    // NOTE: `System` is non-standard and temporary to support the IO examples. Breaking changes are possible.
+    var System: typeof System_;
+    var device: typeof Device;
+  }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@moddable/typings",
-	"version": "7.1.0",
+	"version": "7.2.1",
 	"main": "",
 	"types": [
 		"xs.d.ts",

package/pebble/accelerometer.d.ts

@@ -0,0 +1,46 @@
+/*
+* 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/>.
+*
+*/
+
+type TapDirection = "+x" | "-x" | "+y" | "-y" | "+z" | "-z";
+
+interface AccelerometerOptions {
+  onSample?: () => void;
+  onTap?: (direction: TapDirection) => void;
+  onDoubleTap?: (direction: TapDirection) => void;
+}
+
+interface AccelerometerConfigureOptions {
+  hz?: 10 | 25 | 50 | 100;
+}
+
+interface AccelerometerSample {
+  x: number;
+  y: number;
+  z: number;
+}
+
+declare class Accelerometer {
+  constructor(options: AccelerometerOptions);
+  close(): void;
+  configure(options: AccelerometerConfigureOptions): void;
+  sample(): AccelerometerSample;
+}
+
+export default Accelerometer;

package/pebble/battery.d.ts

@@ -0,0 +1,38 @@
+/*
+* 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/>.
+*
+*/
+
+interface BatteryOptions {
+  onSample?: () => void;
+}
+
+interface BatterySample {
+  percent: number;
+  charging: boolean;
+  plugged: boolean;
+}
+
+declare class Battery {
+  constructor(options: BatteryOptions);
+  close(): void;
+  configure(options: {}): void;
+  sample(): BatterySample;
+}
+
+export default Battery;

package/pebble/button.d.ts

@@ -0,0 +1,40 @@
+/*
+* 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/>.
+*
+*/
+
+type ButtonType = "back" | "up" | "down" | "select";
+
+interface PebbleButtonSingleOptions {
+  type: ButtonType;
+  onPush: (pushed: 0 | 1, type: ButtonType) => void;
+}
+
+interface PebbleButtonMultipleOptions {
+  types: ButtonType[];
+  onPush: (pushed: 0 | 1, type: ButtonType) => void;
+}
+
+type PebbleButtonOptions = PebbleButtonSingleOptions | PebbleButtonMultipleOptions;
+
+declare class PebbleButton {
+  constructor(options: PebbleButtonOptions);
+  close(): void;
+}
+
+export default PebbleButton;

package/pebble/compass.d.ts

@@ -0,0 +1,40 @@
+/*
+* 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/>.
+*
+*/
+
+interface CompassOptions {
+  onSample?: () => void;
+}
+
+interface CompassConfigureOptions {
+  filter?: number;
+}
+
+interface CompassSample {
+  heading: number;
+}
+
+declare class Compass {
+  constructor(options: CompassOptions);
+  close(): void;
+  configure(options: CompassConfigureOptions): void;
+  sample(): CompassSample;
+}
+
+export default Compass;

package/pebble/device.d.ts

@@ -0,0 +1,51 @@
+/*
+* 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;
+}

package/pebble/global.d.ts

@@ -0,0 +1,129 @@
+/*
+* 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/>.
+*
+*/
+
+/*
+  console
+*/
+
+interface Console {
+  log(...args: any[]): void;
+}
+
+declare const console:Console;
+
+/*
+  watch global
+*/
+
+interface TimeChangeEvent {
+  date: Date;
+}
+
+interface ConnectionState {
+  app: boolean;
+  pebblekit: boolean;
+}
+
+type TimeEventType = "secondchange" | "minutechange" | "hourchange" | "daychange";
+
+type PebbleEventType = TimeEventType | "connected" | "resize";
+
+type TimeChangeCallback = (event: TimeChangeEvent) => void;
+
+type ConnectedCallback = () => void;
+
+type ResizeCallback = (progress: number) => void;
+
+interface watch {
+  addEventListener(event: TimeEventType, callback: TimeChangeCallback): void;
+  addEventListener(event: "connected", callback: ConnectedCallback): void;
+  addEventListener(event: "resize", callback: ResizeCallback): void;
+  removeEventListener(event: TimeEventType, callback: TimeChangeCallback): void;
+  removeEventListener(event: "connected", callback: ConnectedCallback): void;
+  removeEventListener(event: "resize", callback: ResizeCallback): void;
+  readonly connected: ConnectionState;
+}
+
+declare const watch: watch;
+
+/*
+  Resource
+*/
+
+declare const Resource: typeof import('Resource').default;
+
+/*
+  setTimeout and friends
+*/
+
+declare function setInterval(callback: () => void, delay: number): number;
+declare function clearInterval(id: number): void;
+declare function setTimeout(callback: () => void, delay: number): number;
+declare function clearTimeout(id: number): void;
+
+/*
+  Web
+*/
+
+declare const URL: typeof import('url').URL;
+declare const URLSearchParams: typeof import('url').URLSearchParams;
+declare const Headers: typeof import('headers').default;
+declare const localStorage: import('webstorage').default;
+declare const WebSocket: typeof import('web/websocket').default;
+declare const fetch: typeof import('fetch').fetch;
+
+/*
+  Piu
+*/
+
+type Application = import("piu/MC-types").Application;
+type Behavior = import("piu/MC-types").Behavior;
+type Column = import("piu/MC-types").Column;
+type Container = import("piu/MC-types").Container;
+type Content = import("piu/MC-types").Content;
+type ContentDictionary = import("piu/MC-types").ContentDictionary;
+type Label = import("piu/MC-types").Label;
+type Link = import("piu/MC-types").Link;
+type Locals = import("piu/MC-types").Locals;
+type Port = import("piu/MC-types").Port;
+type Row = import("piu/MC-types").Row;
+type Skin = import("piu/MC-types").Skin;
+type Style = import("piu/MC-types").Style;
+type Text = import("piu/MC-types").Text;
+type Texture = import("piu/MC-types").Texture;
+type Transition = import("piu/MC-types").Transition;
+
+declare const Inverter: InverterConstructor;
+declare const RonndRect: RoundRectConstructor;
+declare const ScreenBuffer: ScreenBufferConstructor;
+declare const SVGImage: SVGImageConsructor;
+
+/*
+  ECMA-419
+*/
+
+// device is defined in typings/pebble/device.d.ts
+
+declare module "embedded:storage/files" {
+  interface DirectoryOpenFileOptions {
+    size?: number;
+  }
+}
+

package/pebble/location.d.ts

@@ -0,0 +1,50 @@
+/*
+* 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/>.
+*
+*/
+
+interface LocationSample {
+  latitude: number;
+  longitude: number;
+  altitude?: number;
+  accuracy?: number;
+  altitudeAccuracy?: number;
+  heading?: number;
+  speed?: number;
+  timestamp?: number;
+}
+
+interface LocationOptions {
+  onSample?: () => void;
+  onError?: (error: Error) => void;
+}
+
+interface LocationConfiguration {
+  enableHighAccuracy?: boolean;
+  timeout?: number;
+  maximumAge?: number;
+}
+
+declare class Location {
+  constructor(options: LocationOptions);
+  close(): void;
+  configure(options: LocationConfiguration): void;
+  sample(): LocationSample | undefined;
+}
+
+export default Location;

package/pebble/message.d.ts

@@ -0,0 +1,46 @@
+/*
+* 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/>.
+*
+*/
+
+interface MessageOptions {
+  onReadable?: () => void;
+  onWritable?: (count: number) => void;
+  onSuspend?: () => void;
+  format?: "map";
+  input?: number;
+  output?: number;
+  keys?: Map<string, number> | Array<string>;
+}
+
+type MessageKey = string | number;
+type MessageReadValue = number | string | ArrayBuffer;
+type MessageWriteValue = number | string | ByteBuffer | boolean;
+
+declare class Message {
+  constructor(options: MessageOptions);
+  close(): void;
+  read(): Map<MessageKey, MessageReadValue>;
+  write(map: Map<MessageKey, MessageWriteValue>): void;
+  get format(): "map";
+  set format(value: "map");
+  get input(): number;
+  get output(): number;
+}
+
+export default Message;