@moddable/typings 9.0.1 → 10.0.0

package/pebble/button.d.ts

@@ -58,10 +58,10 @@ interface PebbleButtonMultipleOptions extends PebbleButtonRecognizers {
 
 type PebbleButtonOptions = PebbleButtonSingleOptions | PebbleButtonMultipleOptions;
 
-declare class PebbleButton {
+declare class PebbleButton implements Disposable {
   constructor(options: PebbleButtonOptions);
   close(): void;
+  [Symbol.dispose](): void;
 }
-interface PebbleButton extends Disposable {}
 
 export default PebbleButton;

package/pebble/compass.d.ts

@@ -19,7 +19,7 @@
 */
 
 interface CompassOptions {
-  onSample?: () => void;
+  onSample?: (this: Compass) => void;
 }
 
 interface CompassConfigureOptions {
@@ -30,12 +30,12 @@ interface CompassSample {
   heading: number;
 }
 
-declare class Compass {
+declare class Compass implements Disposable {
   constructor(options: CompassOptions);
   close(): void;
   configure(options: CompassConfigureOptions): void;
   sample(): CompassSample;
+  [Symbol.dispose](): void;
 }
-interface Compass extends Disposable {}
 
 export default Compass;

package/pebble/dictation.d.ts

@@ -29,7 +29,7 @@ interface DictationConfigureOptions {
   errorDialogs?: boolean;
 }
 
-declare class Dictation {
+declare class Dictation implements Disposable {
   constructor(options: DictationOptions);
   close(): void;
   configure(options: DictationConfigureOptions): void;
@@ -37,7 +37,7 @@ declare class Dictation {
   stop(): void;
   read(): string | undefined;
   readonly format: "string";
+  [Symbol.dispose](): void;
 }
-interface Dictation extends Disposable {}
 
 export default Dictation;

package/pebble/global.d.ts

@@ -18,6 +18,13 @@
 *
 */
 
+// on Pebble, a texture may be created from the id of a GBitmap resource
+/// <reference path="./texture.d.ts" />
+// the Piu QRCode, RoundRect and SVGImage contents are the same modules as on every other target; their typings declare the globals
+/// <reference path="../piu/QRCode.d.ts" />
+/// <reference path="../piu/RoundRect.d.ts" />
+/// <reference path="../piu/SVGImage.d.ts" />
+
 /*
   console
 */
@@ -116,6 +123,35 @@ 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;
+declare function setImmediate(callback: () => void): number;
+declare function clearImmediate(id: number): void;
+
+/*
+  Modules and native functions
+*/
+
+/** imports a module of the application and returns its namespace */
+declare function importNow(specifier: string): any;
+/** the application's C functions, when it has any (see XS FFI) */
+declare const Natives: Record<string, (...args: any[]) => any>;
+
+/*
+  Screen: Pebble's display adds whether it is color and round, and the area not obstructed by the system
+*/
+
+declare module "commodetto/Poco" {
+	interface Screen {
+		readonly color: boolean;
+		readonly round: boolean;
+		readonly frameBuffer: true;
+		readonly unobstructed: {
+			readonly x: number;
+			readonly y: number;
+			readonly width: number;
+			readonly height: number;
+		};
+	}
+}
 
 /*
   Web
@@ -150,15 +186,13 @@ 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
+// device is typed by typings/host/pebble.d.ts
 
 declare module "embedded:storage/files" {
   interface DirectoryOpenFileOptions {

package/pebble/health.d.ts

@@ -76,11 +76,11 @@ interface HealthMetricAlertOptions {
   threshold: number;
 }
 
-declare class HealthMetricAlert {
+declare class HealthMetricAlert implements Disposable {
   constructor(options: HealthMetricAlertOptions);
   close(): void;
+  [Symbol.dispose](): void;
 }
-interface HealthMetricAlert extends Disposable {}
 
 interface HealthMinuteHistoryOptions {
   length: number;

package/pebble/location.d.ts

@@ -40,12 +40,12 @@ interface LocationConfiguration {
   maximumAge?: number;
 }
 
-declare class Location {
+declare class Location implements Disposable {
   constructor(options: LocationOptions);
   close(): void;
   configure(options: LocationConfiguration): void;
   sample(): LocationSample | undefined;
+  [Symbol.dispose](): void;
 }
-interface Location extends Disposable {}
 
 export default Location;

package/pebble/message.d.ts

@@ -19,9 +19,9 @@
 */
 
 interface MessageOptions {
-  onReadable?: () => void;
-  onWritable?: (count: number) => void;
-  onSuspend?: () => void;
+  onReadable?: (this: Message) => void;
+  onWritable?: (this: Message, count: number) => void;
+  onSuspend?: (this: Message) => void;
   format?: "map";
   input?: number;
   output?: number;
@@ -32,7 +32,7 @@ type MessageKey = string | number;
 type MessageReadValue = number | string | ArrayBuffer;
 type MessageWriteValue = number | string | ByteBuffer | boolean;
 
-declare class Message {
+declare class Message implements Disposable {
   constructor(options: MessageOptions);
   close(): void;
   read(): Map<MessageKey, MessageReadValue>;
@@ -41,7 +41,7 @@ declare class Message {
   set format(value: "map");
   get input(): number;
   get output(): number;
+  [Symbol.dispose](): void;
 }
-interface Message extends Disposable {}
 
 export default Message;

package/pebble/piu.d.ts

@@ -18,63 +18,6 @@
 *
 */
 
-/*
-	SVGImage
-*/
-
-interface SVGImageDictionary extends ContentDictionary {
-	clip?: boolean;
-	id?: number;
-	path?: string;
-}
-
-interface SVGImage extends Content {
-	opacity: number;
-	center(x: number, y: number): void;
-	cx: number;
-	cy: number;
-	rotate(a: number): void;
-	r: number;
-	scale(x: number, y: number): void;
-	s: number;
-	sx: number;
-	sy: number;
-	translate(x: number, y: number): void;
-	tx: number;
-	ty: number;
-}
-
-interface SVGImageConsructor {
-	new(behaviorData?: any, dictionary?: SVGImageDictionary): SVGImage;
-	template<T>(this: T, fn: (arg: any) => SVGImageDictionary): T;
-  (behaviorData?: any, dictionary?: SVGImageDictionary): SVGImage;
-}
-
-/*
-	RoundRect
-*/
-
-interface RoundRectDictionary extends ContentDictionary {
-	corners?: number;
-	radius?: number;
-}
-
-interface RoundRect extends Content {
-	corners: number;
-	radius: number;
-}
-
-interface RoundRectConstructor {
-	new(behaviorData?: any, dictionary?: RoundRectDictionary): RoundRect;
-	template<T>(this: T, fn: (arg: any) => RoundRectDictionary): T;
-	(behaviorData?: any, dictionary?: RoundRectDictionary): RoundRect;
-
-	readonly topLeft: 1;
-	readonly topRight: 2;
-	readonly bottomLeft: 4;
-	readonly bottomRight: 8;
-}
-
 /*
 	Inverter
 */
@@ -85,6 +28,7 @@ interface Inverter extends Content {
 interface InverterConstructor {
 	new(behaviorData?: any, dictionary?: ContentDictionary): Inverter;
 	template<T>(this: T, fn: (arg: any) => ContentDictionary): T;
+	(behaviorData?: any, dictionary?: ContentDictionary): Inverter;
 }
 
 /*
@@ -97,4 +41,5 @@ interface ScreenBuffer extends Content {
 interface ScreenBufferConstructor {
 	new(behaviorData?: any, dictionary?: ContentDictionary): ScreenBuffer;
 	template<T>(this: T, fn: (arg: any) => ContentDictionary): T;
+	(behaviorData?: any, dictionary?: ContentDictionary): ScreenBuffer;
 }

package/pebble/poco.d.ts

@@ -37,8 +37,8 @@ declare module "commodetto/Poco" {
 			readonly height: number
 		};
 		drawLine(x0: number, y0: number, x1: number, y1: number, color: number, width: number): void;
-		drawRoundRect(x0: number, y0: number, x1: number, y1: number, color: number, radius: number, corners: number): void;
-		frameRoundRect(x0: number, y0: number, x1: number, y1: number, color: number, radius: number): void;
+		drawRoundRect(x0: number, y0: number, x1: number, y1: number, color: number, radius?: number, corners?: number): void;
+		frameRoundRect(x0: number, y0: number, x1: number, y1: number, color: number, radius?: number): void;
 		drawCircle(color: number, x: number, y: number, r: number, from: number, to: number): void;
 		drawDCI(dci: PebbleDrawCommandImage | PebbleDrawCommandSequence, x: number, y: number): void;
 	}

package/pebble/texture.d.ts

@@ -0,0 +1,33 @@
+/*
+* 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/>.
+*
+*/
+
+// on Pebble, a texture may be created from the id of a GBitmap resource (modules/piu/Pebble/piuPebble.js).
+// A module, so that this augments the real module piu/MC-types rather than replacing it.
+
+import type { Texture } from "piu/MC-types";
+import type Bitmap from "commodetto/Bitmap";
+
+declare module "piu/MC-types" {
+	interface TextureConstructor {
+		new(resourceID: number): Texture;
+		/** a texture over bitmaps already in memory, for example from parseRLE */
+		new(path: null | undefined, alphaBitmap: Bitmap | null | undefined, colorBitmap?: Bitmap | null): Texture;
+	}
+}

package/pebble/touch.d.ts

@@ -0,0 +1,47 @@
+/*
+* 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/>.
+*
+*/
+
+// the Pebble touch screen, as an ECMA-419 Touch sensor (build/devices/pebble/modules/touch)
+
+declare module "embedded:sensor/Touch/pebble" {
+	interface TouchOptions {
+		/** invoked when the touch state changes: call sample() for the touch in progress */
+		onSample?: (this: Touch) => void;
+		target?: any;
+	}
+
+	interface TouchPoint {
+		x: number;
+		y: number;
+		id: number;
+	}
+
+	class Touch implements Disposable {
+		constructor(options?: TouchOptions);
+		close(): void;
+		configure(options?: {}): void;
+		/** the touch in progress, if any */
+		sample(): TouchPoint[];
+		target?: any;
+		[Symbol.dispose](): void;
+	}
+
+	export default Touch;
+}

package/ping.d.ts

@@ -19,6 +19,7 @@
 */
 
 declare module "ping" {
+  /** @deprecated The network modules are legacy; prefer the ECMA-419 embedded:network/* and embedded:io/socket/* modules */
   class Ping {
     constructor(
       options: {

package/pins/analog.d.ts

@@ -19,6 +19,7 @@
  */
 
 declare module 'pins/analog' {
+  /** @deprecated Use the ECMA-419 Analog class, embedded:io/analog */
   class Analog {
     static read(pin: number): number
   }

package/pins/audioin.d.ts

@@ -19,6 +19,7 @@
  */
 
 declare module 'pins/audioin' {
+  /** @deprecated Use the ECMA-419 audio input, embedded:io/audio/in */
   class AudioIn {
     public constructor()
     public close(): void

package/pins/digital.d.ts

@@ -26,6 +26,7 @@ declare module 'pins/digital' {
   type Output = 8
   type OutputOpenDrain = 9
   export type Mode = Input | InputPullUp | InputPullDown | InputPullUpDown | Output | OutputOpenDrain
+  /** @deprecated Use the ECMA-419 Digital class, embedded:io/digital */
   export class Digital {
     public constructor(dictionary: { pin: number; mode: number; port?: string })
     public constructor(pin: number, mode: number)

package/pins/i2c.d.ts

@@ -29,6 +29,7 @@ declare module 'pins/i2c' {
     | Uint8ClampedArray
     | Float32Array
     | Float64Array
+  /** @deprecated Use the ECMA-419 I2C class, embedded:io/i2c */
   class I2C {
     public constructor(dictionary: { address: number; scl?: number; sda?: number; hz?: number; timeout?: number })
     public constructor(port: number[], pin: number, mode: number)

package/pins/pwm.d.ts

@@ -19,6 +19,7 @@
  */
 
 declare module 'pins/pwm' {
+  /** @deprecated Use the ECMA-419 PWM class, embedded:io/pwm */
   class PWM {
     public constructor(dictionary: { pin: number; port?: string })
     public write(value: number): void

package/pins/rmt.d.ts

@@ -18,6 +18,7 @@
  *
  */
 declare module 'pins/rmt' {
+  /** @deprecated The pins modules are legacy; prefer the ECMA-419 embedded:io/* classes */
   class RMT {
     public constructor(
       dictionary: {

package/pins/servo.d.ts

@@ -19,6 +19,7 @@
  */
 
 declare module 'pins/servo' {
+  /** @deprecated The pins modules are legacy; prefer the ECMA-419 embedded:io/* classes */
   class Servo {
     public constructor(dictionary: { pin: number; min?: number; max?: number })
     public write(degrees: number): void

package/pins/smbus.d.ts

@@ -29,6 +29,7 @@ declare module 'pins/smbus' {
     | Uint8ClampedArray
     | Float32Array
     | Float64Array
+  /** @deprecated Use the ECMA-419 SMBus class, embedded:io/smbus */
   class SMBus {
     public constructor(dictionary: { address: number; scl?: number; sda?: number; hz?: number; timeout?: number })
     public constructor(port: number[], pin: number, mode: number)