@moddable/typings 8.1.1 → 8.2.0

package/commodetto/Poco.d.ts

@@ -102,8 +102,14 @@ declare module "commodetto/Poco" {
 
   const Poco: PocoConstructor
 
+  export interface Screen extends PixelsOut {
+    command?(id: number, data?: ByteBuffer): void;
+    frameRate?: number;
+    syncFrames?: number;
+  }
+
   global {
-    const screen: PixelsOut
+    const screen: Screen
   }
 
   export default Poco

package/embedded/update.d.ts

@@ -0,0 +1,43 @@
+/*
+ * Copyright (c) 2026  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:update" {
+    import type { Flash } from "embedded:storage/flash";
+
+    export interface UpdateOpenOptions {
+        partition: Flash;
+        mode?: "a" | "w";
+        byteLength?: number;
+    }
+
+    export interface Updater {
+        close(): void;
+        complete(): void;
+        write(bytes: ByteBuffer): void;
+        write(bytes: ByteBuffer, byteOffset: number): void;
+        format: "buffer";
+    }
+
+    const Update: {
+        open(options: UpdateOpenOptions): Updater;
+    };
+
+    export default Update;
+}

package/embedded_io/digital.d.ts

@@ -46,6 +46,8 @@ declare module "embedded:io/digital" {
     constructor(options: {
       pin: PinSpecifier;
       mode: Mode;
+      activeLow?: boolean;
+      initialValue?: 0 | 1;
       format?: "number";
       target?: any;
     } & ({

package/embedded_io/digitalbank.d.ts

@@ -41,6 +41,10 @@ declare module "embedded:io/digitalbank" {
       pins: number;
       mode: Mode;
       bank?: number | string;
+      activeLow?: boolean;
+      initialValue?: number;
+      rises?: number;
+      falls?: number;
       onReadable?: (this: DigitalBank, trigger: number) => void;
       format?: "number";
       target?: any;

package/embedded_network/dnssd.d.ts

@@ -0,0 +1,84 @@
+/*
+ * Copyright (c) 2026  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:network/dnssd" {
+    import type UDP from "embedded:io/socket/udp";
+
+    export interface DNSSDSocketOptions {
+        io: typeof UDP;
+        address?: string;
+        multicast?: string;
+        timeToLive?: number;
+    }
+
+    export interface DNSSDOptions {
+        socket: DNSSDSocketOptions;
+    }
+
+    export interface ClaimOptions {
+        host: string;
+        onReady?(): void;
+        onError?(): void;
+    }
+
+    export interface ClaimHandle {
+        close(): void;
+    }
+
+    export interface ServiceObject {
+        name: string;
+        host: string;
+        address: string;
+        port: number;
+        txt?: Map<string, string | undefined>;
+    }
+
+    export interface DiscoverOptions {
+        serviceType: string;
+        onFound?(service: ServiceObject): void;
+        onUpdate?(service: ServiceObject): void;
+        onLost?(service: ServiceObject): void;
+    }
+
+    export interface DiscoverHandle {
+        close(): void;
+    }
+
+    export interface AdvertiseOptions {
+        serviceType: string;
+        host: string;
+        name?: string;
+        port: number;
+        txt?: Map<string, string | ByteBuffer>;
+    }
+
+    export interface AdvertiseHandle {
+        close(): void;
+        updateTXT(txt: Map<string, string | ByteBuffer>): void;
+    }
+
+    export default class DNSSD {
+        constructor(options: DNSSDOptions);
+        close(): void;
+        claim(options: ClaimOptions): ClaimHandle;
+        discover(options: DiscoverOptions): DiscoverHandle;
+        advertise(options: AdvertiseOptions): AdvertiseHandle;
+    }
+}

package/embedded_network/http/server.d.ts

@@ -0,0 +1,67 @@
+/*
+ * Copyright (c) 2026  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:network/http/server" {
+    import type Listener from "embedded:io/socket/listener";
+    import type TCP from "embedded:io/socket/tcp";
+
+    export interface HTTPRequest {
+        method: string;
+        path: string;
+        headers: Map<string, string>;
+    }
+
+    export interface HTTPResponse {
+        status: number;
+        headers: Map<string, string | number>;
+    }
+
+    export interface HTTPConnectionHandlers {
+        onRequest?(this: HTTPConnection, request: HTTPRequest): void;
+        onReadable?(this: HTTPConnection, count: number): void;
+        onResponse?(this: HTTPConnection, response: HTTPResponse): void;
+        onWritable?(this: HTTPConnection, count: number): void;
+        onDone?(this: HTTPConnection): void;
+        onError?(this: HTTPConnection): void;
+    }
+
+    export interface HTTPConnection {
+        close(): void;
+        detach(): TCP;
+        accept(options: HTTPConnectionHandlers): void;
+        respond(options: HTTPResponse): void;
+        read(count?: number): ArrayBuffer | undefined;
+        write(bytes?: ByteBuffer): number;
+        route: HTTPConnectionHandlers;
+        format: "buffer";
+    }
+
+    export interface HTTPServerOptions {
+        io: typeof Listener;
+        port?: number;
+        onConnect(this: HTTPServer, connection: HTTPConnection): void;
+    }
+
+    export default class HTTPServer {
+        constructor(options: HTTPServerOptions);
+        close(): void;
+        readonly port: number;
+    }
+}

package/embedded_network/interface/wifi.d.ts

@@ -54,6 +54,8 @@ declare module "embedded:network/interface/wifi" {
 		readonly connection: number;
 		readonly address: string | undefined;
 		readonly MAC: string | undefined;
+		readonly SSID: string | undefined;
+		readonly RSSI: number | undefined;
 	}
 
 	export default WiFi;

package/mc/ffi.d.ts

@@ -0,0 +1,32 @@
+/*
+ * Copyright (c) 2026  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/>.
+ *
+ */
+
+// Fallback typing for mc/ffi. When a project's manifest declares ffi.functions,
+// mcconfig generates a project-specific mc.ffi.d.ts with the exact signatures
+// of the bound native functions; that generated typing takes precedence via
+// the per-build tsconfig paths map.
+
+declare module "mc/ffi" {
+    interface FFI {
+        [name: string]: (...args: any[]) => any;
+    }
+    const FFI: { new(): FFI };
+    export default FFI;
+}

package/package.json

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

package/piu/MC-types.d.ts

@@ -145,6 +145,7 @@ export interface ContentDictionary
     name?: string;
     anchor?: string;
     Behavior?: BehaviorConstructor;
+    behavior?: Behavior;
     skin?: Skin | SkinDictionary;
     Skin?: SkinConstructor;
     style?: Style | StyleDictionary;
@@ -424,6 +425,7 @@ export interface Application extends Container {
   displayListLength: number;
   commandListLength: number;
   touchCount: number;
+  purge(): void;
 }
 export interface ApplicationDictionary extends ContainerDictionary {
   displayListLength?: number;

package/piu/MC.d.ts

@@ -18,8 +18,10 @@
  *
  */
 
+/// <reference path="../easing.d.ts" />
+
 declare module "piu/MC" {
-  import {} from "commodetto/Poco";   // for global screen
+  import { } from "commodetto/Poco";   // for global screen
   import type * as MC from "piu/MC-types";
 
   global {

package/tsconfig.base.json

@@ -0,0 +1,33 @@
+{
+	"_comment": "Base tsconfig for projects using @moddable/typings. Project tsconfig.json should `extends` this and add its own outDir, include, sourceMap, etc.",
+	"compilerOptions": {
+		"lib": ["es2025"],
+		"module": "preserve",
+		"moduleResolution": "bundler",
+		"target": "ES2025",
+		"baseUrl": ".",
+		"paths": {
+			"embedded:io/*": ["./embedded_io/*"],
+			"embedded:io/socket/*": ["./embedded_io/socket/*"],
+			"embedded:io/audio/*": ["./embedded_io/audio/*"],
+			"embedded:io/bluetoothle/*": ["./embedded_io/ble/*"],
+			"embedded:network/*": ["./embedded_network/*"],
+			"embedded:network/http/*": ["./embedded_network/http/*"],
+			"embedded:network/interface/*": ["./embedded_network/interface/*"],
+			"embedded:network/mqtt/*": ["./embedded_network/mqtt/*"],
+			"embedded:network/websocket/*": ["./embedded_network/websocket/*"],
+			"embedded:network/dns/resolver/*": ["./embedded_network/dns/resolver/*"],
+			"embedded:network/ntp/*": ["./embedded_network/ntp/*"],
+			"embedded:storage/*": ["./embedded/storage/*"],
+			"embedded:provider/*": ["./embedded_provider/*"],
+			"embedded:*": ["./embedded/*"],
+			"mc/*": ["./mc/*"],
+			"mod/*": ["./mod/*"],
+			"pins/*": ["./pins/*"],
+			"piu/*": ["./piu/*"],
+			"commodetto/*": ["./commodetto/*"],
+			"text/*": ["./text/*"],
+			"*": ["./*"]
+		}
+	}
+}

package/web/websocket.d.ts

@@ -55,6 +55,16 @@ declare module "web/websocket" {
     constructor(url: string, protocol?: string);
     constructor(options: WebSocketOptions);
 
+    static readonly CONNECTING: 0;
+    static readonly OPEN: 1;
+    static readonly CLOSING: 2;
+    static readonly CLOSED: 3;
+
+    readonly CONNECTING: 0;
+    readonly OPEN: 1;
+    readonly CLOSING: 2;
+    readonly CLOSED: 3;
+
     binaryType: "arraybuffer";
     readonly bufferedAmount: number;
     readonly extensions: string;