@moddable/typings 5.12.0 → 6.0.0

package/Resource.d.ts

@@ -1,5 +1,6 @@
 /*
 * Copyright (c) 2019-2020 Bradley Farias
+* Copyright (c) 2025 Moddable Tech, Inc.
 *
 *   This file is part of the Moddable SDK Tools.
 *
@@ -19,12 +20,17 @@
 */
 
 declare module "Resource" {
-  class Resource extends HostBuffer {
-    constructor(path: string);
+  interface ResourcePrototype extends HostBuffer {
     slice(begin: number, end?: number): ArrayBuffer;
     slice(begin: number, end?: number, copy?: boolean): HostBuffer;
-    static exists(path: string): boolean;
   }
 
+  export interface ResourceConstructor {
+    new(path: string): ResourcePrototype;
+
+    exists(path: string): boolean;
+  }
+  const Resource: ResourceConstructor
+
   export {Resource as default};
 }

package/commodetto/BufferOut.d.ts

@@ -0,0 +1,53 @@
+/*
+* 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/>.
+*
+*/
+
+declare module "commodetto/BufferOut" {
+  import type Bitmap from "commodetto/Bitmap";
+  import type {Rectangle} from "commodetto/Poco";
+
+  interface BufferOutOptions {
+    width: number;
+    height: number;
+    pixelFormat: number;
+    buffer?: BufferLike;
+  }
+
+  class BufferOut {
+    constructor(options: BufferOutOptions);
+    begin(x: number, y: number, width: number, height: number): void;
+    end(): void;
+    continue(x: number, y: number, width: number, height: number): void;
+    send(
+      pixels: BufferLike,
+      offset: number,
+      count: number
+    ): void;
+
+    pixelsToBytes(count: number): number;
+    adaptInvalid(area: Rectangle): void;
+
+    readonly width: number;
+    readonly height: number;
+    readonly pixelFormat: number;
+    readonly bitmap: Bitmap;
+  }
+
+  export {BufferOut as default};
+}

package/commodetto/Convert.d.ts

@@ -0,0 +1,29 @@
+/*
+* 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/>.
+*
+*/
+
+declare module "commodetto/Convert" {
+  class Convert {
+    constructor(srcFormat: number, dstFormat: number, clut?: BufferLike);
+    process(src: BufferLike, dst: BufferLike): void;
+    process(src: BufferLike, srcOffset: number, srcCount: number, dst: BufferLike, dstOffset: number, dstCount: number): void;
+  }
+
+  export {Convert as default};
+}

package/commodetto/PixelsOut.d.ts

@@ -1,5 +1,5 @@
 /*
-* Copyright (c) 2019-2020 Bradley Farias
+* Copyright (c) 2019-2025 Bradley Farias
 *
 *   This file is part of the Moddable SDK Tools.
 *
@@ -19,8 +19,16 @@
 */
 
 declare module "commodetto/PixelsOut" {
+  import type {Rectangle} from "commodetto/Poco";
+
+  interface PixelsOutOptions {
+    width: number;
+    height: number;
+    pixelFormat: number;
+  }
+
   class PixelsOut {
-    constructor(width: number, height: number, pixelFormat: number);
+    constructor(options: PixelsOutOptions);
     begin(x: number, y: number, width: number, height: number): void;
     end(): void;
     continue(x: number, y: number, width: number, height: number): void;
@@ -30,7 +38,7 @@ declare module "commodetto/PixelsOut" {
       count: number
     ): void;
 
-    adaptInvalid(area: { x: number, y: number, width: number, height: number }): void;
+    adaptInvalid(area: Rectangle): void;
     pixelsToBytes(count: number): number;
     /**
      * The width of the PixelsOut instance in pixels.
@@ -49,18 +57,18 @@ declare module "commodetto/PixelsOut" {
      * Returns true if the PixelsOut supports asynchronous rendering.
      * This means pixels passed to send are not copied, and must remain unchanged through the completion of the next call to send or end.
      */
-    readonly async: boolean;
+    readonly async?: boolean;
     /**
      * Optionally returns a pointer to a HostBuffer that contains a native PixelsOutDispatchRecord.
      * Returns undefined if no native dispatch table is available.
      * The native PixelsOutDispatchRecord allows native code to call the PixelsOut's begin, send, continue, end, and adaptInvalid functions directly, without going through the XS virtual machine.
      * The native dispatch table is strictly an optimization and provides only functionality in the JavaScript API.
      */
-    readonly c_dispatch: HostBuffer | undefined;
+    readonly c_dispatch?: HostBuffer | undefined;
     /**
      * (Not documented yet)
      */
-    clut: unknown;
+    clut?: unknown;
   }
 
   export {PixelsOut as default};

package/commodetto/Poco.d.ts

@@ -1,5 +1,5 @@
 /*
-* Copyright (c) 2020 Moddable Tech, Inc.
+* Copyright (c) 2020-2025 Moddable Tech, Inc.
 *
 *   This file is part of the Moddable SDK Tools.
 *
@@ -23,14 +23,22 @@ declare module "commodetto/Poco" {
   import PixelsOut from "commodetto/PixelsOut"
   import Bitmap from "commodetto/Bitmap"
 
-  type Rectangle = {
+  export type Rectangle = {
     x: number,
     y: number,
     width: number,
     height: number,
   }
 
-  type Font = any    //@@ share full interface with commodetto/parseBMF
+  export type Font = {
+    readonly byteLength: number
+    readonly height: number
+    readonly ascent: number
+    readonly position: number
+    readonly charCount: number,
+    readonly leading: number,
+    bitmap: Bitmap
+  }
 
   export interface PocoPrototype {
     close(): void
@@ -68,8 +76,6 @@ declare module "commodetto/Poco" {
     fillPattern(bits: Bitmap, x: number, y: number, w: number, h: number): void
     fillPattern(bits: Bitmap, x: number, y: number, w: number, h: number, sx: number, sy: number, sw: number, sh: number): void
   
-    drawFrame(frame: ArrayBuffer | HostBuffer, stream: { width: number, height: number }, x: number, y: number): void
-
     drawText(text: string, font: Font, color: number, x: number, y: number, width?: number): void
     getTextWidth(text: string, font: Font): number
 
@@ -79,8 +85,6 @@ declare module "commodetto/Poco" {
     bitmapRemove(bits: Bitmap): void
     compact(): void
 
-    drawQRCode(qrcode:ArrayBuffer, x: number, y: number, scale: number, fore: number)
-
     readonly width: number
     readonly height: number
     readonly pixelsOut: PixelsOut
@@ -96,7 +100,7 @@ declare module "commodetto/Poco" {
     new(pixelsOut: PixelsOut, options?: PocoDictionary): PocoPrototype
   }
 
-  var Poco: PocoConstructor
+  const Poco: PocoConstructor
 
   global {
     const screen: PixelsOut

package/commodetto/ReadGIF.d.ts

@@ -0,0 +1,56 @@
+/*
+* 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/>.
+*
+*/
+
+declare module "commodetto/ReadGIF" {
+  import Bitmap from "commodetto/Bitmap"
+
+  class ReadGIF extends Bitmap {
+    constructor(buffer: BufferLike);
+    close(): void;
+    first(): void;
+    next(): void;
+
+    readonly duration: number
+    readonly frameBounds: {x: number, y: number, width: number, height: number}
+    readonly frameCount: number
+    readonly frameDuration: number
+    readonly frameNumber: number
+    readonly frameX: number
+    readonly frameY: number
+    readonly frameWidth: number
+    readonly frameHeight: number
+
+    readonly transparent: boolean;
+    transparentColor: number;
+
+    readonly ready: boolean
+    avaiable: number
+  }
+
+  export {ReadGIF as default};
+}
+
+declare module "commodetto/Poco" {
+  import ReadGIF from "commodetto/ReadGIF"
+
+  interface PocoPrototype {
+    drawBitmapWithKeyColor(reader: ReadGIF, x: number, y: number): void
+  }
+}

package/commodetto/ReadPNG.d.ts

@@ -0,0 +1,43 @@
+/*
+* 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/>.
+*
+*/
+
+declare module "commodetto/ReadPNG" {
+  import Bitmap from "commodetto/Bitmap"
+
+  interface ReadPNG {
+    read(): Uint8Array;
+
+    readonly width: number;
+    readonly height: number;
+    readonly channels: number;
+    readonly depth: number;
+    readonly palette?: ArrayBuffer;
+  }
+
+  interface ReadPNGConstructor {
+    new(buffer: BufferLike, options?: { pixelFormat: number }): ReadPNG
+
+    decompress(data: BufferLike, pixelFormat: number, alphaPixelFormat?: number): Bitmap;
+  }
+
+  const ReadPNG: ReadPNGConstructor
+
+  export {ReadPNG as default};
+}

package/commodetto/loadJPEG.d.ts

@@ -0,0 +1,25 @@
+/*
+* 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/>.
+*
+*/
+
+declare module "commodetto/loadJPEG" {
+  import Bitmap from "commodetto/Bitmap"
+
+  export default function (data: BufferLike, options?: {pixelFormat?: number}): Bitmap;
+}

package/commodetto/parseBMF.d.ts

@@ -1,5 +1,5 @@
 /*
-* Copyright (c) 2020-2022 Moddable Tech, Inc.
+* Copyright (c) 2020-2025 Moddable Tech, Inc.
 *
 *   This file is part of the Moddable SDK Tools.
 *
@@ -19,16 +19,7 @@
 */
 
 declare module "commodetto/parseBMF" {
-  import Bitmap from "commodetto/Bitmap"
+  import type {Font} from "commodetto/Poco"
 
-  type Font = {
-    readonly byteLength: number
-    height: number
-    ascent: number
-    position: number
-    charCount: number,
-    bitmap: Bitmap
-  }
-    
   export default function (bmp: BufferLike): Font
 }

package/commodetto/parseNFNT.d.ts

@@ -0,0 +1,25 @@
+/*
+* 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/>.
+*
+*/
+
+declare module "commodetto/parseNFNT" {
+  import type {Font} from "commodetto/Poco"
+
+  export default function (bmp: BufferLike): Font
+}

package/commodetto/readJPEG.d.ts

@@ -1,5 +1,5 @@
 /*
-* Copyright (c) 2020-2022 Moddable Tech, Inc.
+* Copyright (c) 2020-2025 Moddable Tech, Inc.
 *
 *   This file is part of the Moddable SDK Tools.
 *
@@ -27,7 +27,7 @@ declare module "commodetto/readJPEG" {
   }
 
   class JPEG {
-    constructor(buffer: (BufferLike), options?: { pixelFormat: number })
+    constructor(buffer?: (BufferLike), options?: { pixelFormat: number })
 
     read(): Block
     push(buffer: BufferLike): void

package/commodetto/readStream.d.ts

@@ -0,0 +1,34 @@
+/*
+* 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/>.
+*
+*/
+
+declare module "commodetto/readStream" {
+
+  class Stream {
+    constructor(buffer: ArrayBuffer | HostBuffer, options?: {loop?: boolean});
+    next(): ArrayBuffer | HostBuffer
+
+    readonly width: number;
+    readonly height: number;
+    readonly pixelFormat: number;
+    readonly buffer: ArrayBuffer | HostBuffer;
+  }
+  
+  export default Stream;
+}

package/deflate.ts

@@ -0,0 +1,36 @@
+/*
+* 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/>.
+*
+*/
+
+declare module "deflate" {
+
+  class Deflate {
+    constructor(options?: {windowBits?: number, level?: number, strategy?: number});
+    close(): void;
+
+    push(buffer: BufferLike | string, end?: boolean): boolean;
+
+    onData: (data: ArrayBuffer) => void;
+    onEnd: (status: number) => void;
+
+    readonly result?: Uint8Array;
+  }
+
+  export {Deflate as default};
+}

package/embedded_io/ble/client.d.ts

@@ -37,7 +37,7 @@ declare module "embedded:io/bluetoothle/central" {
         authenticate?: boolean,
         keyboard?: boolean | "yes/no",
         display?: boolean,
-        lazy?: boolean
+        immediate?: boolean
     }
 
     interface GATTSecurityState {

package/embedded_io/serial.d.ts

@@ -1,5 +1,5 @@
 /*
-* Copyright (c) 2022 Shinya Ishikawa
+* Copyright (c) 2022-2025  Shinya Ishikawa
 *
 *   This file is part of the Moddable SDK Tools.
 *
@@ -52,7 +52,7 @@ declare module "embedded:io/serial" {
       dataTerminalReady?: PinSpecifier;
       requestToSend?: PinSpecifier;
       break?: boolean;
-    })
+    }): void
     get format(): "number" | "buffer"
     set format(value: "number" | "buffer")
   }

package/embedded_io/smbus.d.ts

@@ -1,5 +1,5 @@
 /*
-* Copyright (c) 2022 Shinya Ishikawa
+* Copyright (c) 2022-2025 Shinya Ishikawa
 *
 *   This file is part of the Moddable SDK Tools.
 *
@@ -33,10 +33,10 @@ declare module "embedded:io/smbus" {
     readBuffer(register: number, byteLength: number): ArrayBuffer;
     readBuffer(register: number, buffer: Buffer): void;
     writeBuffer(register: number, buffer: Buffer): void;
-    readQuick();
-    writeQuick();
+    readQuick(): void;
+    writeQuick(): void;
     receiveByte(): number;
-    sendByte(command: number);
+    sendByte(command: number): void;
   }
 
   export default SMBus;

package/embedded_io/socket/udp.d.ts

@@ -1,5 +1,5 @@
 /*
-* Copyright (c) 2022 Shinya Ishikawa
+* Copyright (c) 2022-2025 Shinya Ishikawa
 *
 *   This file is part of the Moddable SDK Tools.
 *
@@ -37,7 +37,6 @@ declare module "embedded:io/socket/udp" {
       address: string;
       port: number;
     };
-    read(buffer: Buffer);
     get format(): "buffer"
     set format(value: "buffer")
   }

package/file.d.ts

@@ -1,5 +1,5 @@
 /*
-* Copyright (c) 2019-2020 Bradley Farias
+* Copyright (c) 2019-2025 Bradley Farias
 *
 *   This file is part of the Moddable SDK Tools.
 *
@@ -56,8 +56,8 @@ declare module "file" {
   }
 
   class Directory {
-    static create(path): void;
-    static delete(path): void;
+    static create(path: string): void;
+    static delete(path: string): void;
   }
 
   class System {

package/inflate.d.ts

@@ -0,0 +1,37 @@
+/*
+* 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/>.
+*
+*/
+
+declare module "inflate" {
+
+  class Inflate {
+    constructor(options?: {windowBits?: number});
+    close(): void;
+
+    push(buffer: BufferLike, end?: boolean): number;
+
+    onData: (data: ArrayBuffer) => void;
+    onEnd: (status: number) => void;
+
+    readonly result?: Uint8Array;
+    readonly strm: {readonly avail_in: number}
+  }
+
+  export {Inflate as default};
+}

package/package.json

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

package/pins/audioout.d.ts

@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2020 Moddable Tech, Inc.
+ * Copyright (c) 2020-2025  Moddable Tech, Inc.
  *
  *   This file is part of the Moddable SDK Tools.
  *
@@ -80,7 +80,7 @@ declare module 'pins/audioout' {
       stop(): void
       callback: AudioOutCallback
       callbacks: AudioOutCallback[]
-      readonly mix: undefined
+      mix(): never
   }
   export { AudioOut as default }
 }

package/pins/rmt.d.ts

@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2021 Satoshi Tanaka
+ * Copyright (c) 2021-2025  Satoshi Tanaka
  *
  *   This file is part of the Moddable SDK Tools.
  *
@@ -42,7 +42,7 @@ declare module 'pins/rmt' {
     public write(firstValue: 0 | 1, durations: number[]): void;
     public onWritable: () => void;
     public read(buffer: ArrayBuffer | ArrayBufferLike): {buffer: ArrayBuffer, count: number, phase: 0 | 1};
-    public close();
+    public close(): void;
   }
   export { RMT as default }
 }

package/piu/MC.d.ts

@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2020-21 Shinya Ishikawa
+ * Copyright (c) 2020-2025 Shinya Ishikawa
  *
  *   This file is part of the Moddable SDK Tools.
  *
@@ -19,6 +19,8 @@
  */
 
 declare module "piu/MC" {
+  import {} from "commodetto/Poco";   // for global screen
+
   /* type aliases */
   type Coordinates = {
     top?: number;
@@ -64,19 +66,29 @@ declare module "piu/MC" {
   ) => TemplateStyle<Partial<ConstructorParameters<T>[1]>, T>;
 
   type TemplateComponent<P, C extends new (...args: any) => any> = {
-    new (dictionary: P): InstanceType<C>;
+    new (behaviorData?: any, dictionary?: P): InstanceType<C>;
     template: TemplateComponentFactory<C>;
   };
   type TemplateComponentFactory<T extends new (...args: any) => any> = (
     func: (param: any) => ConstructorParameters<T>[1]
   ) => TemplateComponent<Parameters<typeof func>[0], T>;
 
-  interface Behavior {}
-
-  interface BehaviorConstructor {
-    new(any): Behavior;
+  interface Behavior<T extends Content = Content>{
+    onCreate?(content: T, data: object, context: any): void;
+    onDisplaying?(content: T): void;
+    onFinished?(content: T): void;
+    onTimeChanged?(content: T): void;
+    onTouchBegan?(content: T, id: number, x: number, y: number, ticks: number): void;
+    onTouchCancelled?(content: T, id: number): void;
+    onTouchended?( content: T, id: number, x: number, y: number, ticks: number): void;
+    onTouchMoved?( content: T, id: number, x: number, y: number, ticks: number): void;
+    // TODO: complete callbacks
   }
 
+interface BehaviorConstructor<T extends Content = Content> {
+  new(): Behavior<T>;
+}
+
   interface Content {
     // TODO: consider type parameter to avoid any
     adjust(x: number, y: number): void;
@@ -93,33 +105,7 @@ declare module "piu/MC" {
     sizeBy(width: number, height: number): void;
     start(): void;
     stop(): void;
-    onCreate(content: Content, data: object, context: object): void;
-    onDisplaying(content: Content): void;
-    onFinished(content: Content): void;
-    onTimeChanged(content: Content): void;
-    onTouchBegan(
-      content: Content,
-      id: string,
-      x: number,
-      y: number,
-      ticks: number
-    ): void;
-    onTouchCancelled(content: Content, id: string): void;
-    onTouchended(
-      content: Content,
-      id: string,
-      x: number,
-      y: number,
-      ticks: number
-    ): void;
-    onTouchMoved(
-      content: Content,
-      id: string,
-      x: number,
-      y: number,
-      ticks: number
-    ): void;
-    // TODO: Avoid any
+
     readonly previous: Content | null;
     readonly next: Content | null;
     readonly container: Container | null;
@@ -164,17 +150,16 @@ declare module "piu/MC" {
     Behavior?: BehaviorConstructor;
     skin?: Skin | SkinDictionary;
     Skin?: SkinConstructor;
-    style?: Style;
+    style?: Style | StyleDictionary;
     Style?: StyleConstructor;
     visible?: boolean;
   }
   interface ContentConstructor {
-    new(behaviorData: any, dictionary: ContentDictionary): Content;
-    (behaviorData: any, dictionary: ContentDictionary): Content;
+    new(behaviorData?: any, dictionary?: ContentDictionary): Content;
+    (behaviorData?: any, dictionary?: ContentDictionary): Content;
     readonly prototype: Content;
 
     template: TemplateComponentFactory<typeof Content>;
-    getAll<T>(this: { new (): T }): T[];
   }
 
   interface Style {
@@ -189,7 +174,7 @@ declare module "piu/MC" {
   interface StyleConstructor {
     new(dictionary: StyleDictionary): Style;
 
-    template<T>(this: T, any): T;
+    template<T>(this: T, dictionary: StyleDictionary): T;
   }
   
   interface TextStyleDictionary extends StyleDictionaryBase {
@@ -243,7 +228,7 @@ declare module "piu/MC" {
   }
 
   interface TextureSkinDictionary extends Coordinates, Bounds {
-    texture?: Texture;
+    texture?: Texture | TextureDictionary;
     Texture?: TextureConstructor;
     color?: Color | Color[];
     states?: number;
@@ -291,9 +276,10 @@ declare module "piu/MC" {
     contents?: Content[];
   }
   interface ContainerConstructor {
-    new(behaviorData: any, dictionary?: ContainerDictionary);
+    new(behaviorData?: any, dictionary?: ContainerDictionary): Container;
+    (behaviorData?: any, dictionary?: ContainerDictionary): Container;
 
-    template<T>(this: T, any): T;
+    template<T>(this: T, fn: (arg: any) => ContainerDictionary): T;
   }
 
   interface Label extends Content {
@@ -303,9 +289,10 @@ declare module "piu/MC" {
     string?: string;
   }
   interface LabelConstructor {
-    new(behaviorData: any, dictionary: LabelDictionary): Label;
+    new(behaviorData?: any, dictionary?: LabelDictionary): Label;
+    (behaviorData?: any, dictionary?: LabelDictionary): Label;
 
-    template<T>(this: T, any): T;
+    template<T>(this: T, fn: (arg: any) => LabelDictionary): T;
   }
 
   interface Port extends Content {
@@ -404,12 +391,18 @@ declare module "piu/MC" {
   interface PortConstructor extends ContentConstructor {
   }
 
+  interface TextBlock {
+      behavior?: object | null;
+      style?: Style | null;
+      spans: (string | TextSpan)[] | string,
+  }
+
+  interface TextSpan extends TextBlock {
+      link?: any
+  }
+
   interface Text extends Content {
-    blocks: {
-      behavior: object | null;
-      style: Style | null;
-      spans: string | string[];
-    }[];
+    blocks: TextBlock[],
     string: string;
     begin(): void;
     beginBlock(style?: Style, behavior?: object): void;
@@ -420,17 +413,14 @@ declare module "piu/MC" {
     endSpan(): void;
   }
   interface TextDictionary extends ContentDictionary {
-    blocks?: {
-      behavior?: Behavior;
-      style?: Style;
-      spans: string | string[];
-    }[];
-    string: string;
+    blocks?: TextBlock[],
+    string?: string;
   }
-  interface TextConstructor extends ContentConstructor {
-    new(behaviorData: any, dictionary: TextDictionary): Text;
+  interface TextConstructor {
+    new(behaviorData?: any, dictionary?: TextDictionary): Text;
+    (behaviorData?: any, dictionary?: TextDictionary): Text;
 
-    template<T>(this: T, any): T;
+    template<T>(this: T, fn: (arg: any) => TextDictionary): T;
   }
 
   interface Application extends Container {
@@ -445,9 +435,9 @@ declare module "piu/MC" {
     pixels?: number;
   }
   interface ApplicationConstructor {
-    new(behaviorData: any, dictionary: ApplicationDictionary): Application;
+    new(behaviorData?: any, dictionary?: ApplicationDictionary): Application;
 
-    template<T>(this: T, any): T;
+    template<T>(this: T, fn: (arg: any) => ApplicationDictionary): T;
   }
 
   interface Column extends Container {
@@ -471,10 +461,11 @@ declare module "piu/MC" {
   interface ImageDictionary extends ContentDictionary {
     path: string;
   }
-  interface ImageConstructor extends ContentConstructor {
-    new(behaviorData: any, dictionary: ImageDictionary): Image;
+  interface ImageConstructor {
+    new(behaviorData?: any, dictionary?: ImageDictionary): Image;
+    (behaviorData?: any, dictionary?: ImageDictionary): Image;
 
-    template<T>(this: T, any): T;
+    template<T>(this: T, fn: (arg: any) => ImageDictionary): T;
   }
 
   interface Die extends Layout {
@@ -510,10 +501,43 @@ declare module "piu/MC" {
   interface ScrollerDictionary extends ContainerDictionary {
     loop?: boolean;
   }
-  interface ScrollerConstructor extends ContainerConstructor {
-    new(behaviorData: any, dictionary: ScrollerDictionary): Scroller;
+  interface ScrollerConstructor {
+    new(behaviorData?: any, dictionary?: ScrollerDictionary): Scroller;
+    (behaviorData?: any, dictionary?: ScrollerDictionary): Scroller;
+
+    template<T>(this: T, fn: (arg: any) => ScrollerDictionary): T;
+  }
+
+  interface LinkDictionary {
+    Behavior?: BehaviorConstructor;
+  }
+  interface Link {
+    readonly container: Container;
+    state: number;
+    captureTouch(id: number, x: number, y: number, ticks: number): void;
+  }
+  interface LinkConstructor {
+    new(behaviorData?: any, dictionary?: LinkDictionary): Link;
+    (behaviorData?: any, dictionary?: LinkDictionary): Link;
+
+    template<T>(this: T, fn: (arg: any) => LinkDictionary): T;
+  }
+
+  interface Locals {
+    new(name?: string, language?: string): Locals
+    language: string;
+    get(textToLocalize: string): string
   }
 
+  interface blendColors {
+    (a: number, c1: number, c2: number): Color
+  }
+  interface hsl {
+    (h: number, s: number, l: number): Color
+  }
+  interface hsla {
+    (h: number, s: number, l: number, a: number): Color
+  }
   interface rgb {
     (r: number, g: number, b: number): Color
   }
@@ -534,11 +558,18 @@ declare module "piu/MC" {
     const Row: RowConstructor
     const Column: ColumnConstructor
     const Layout: LayoutConstructor
+    const Image: ImageConstructor
     const Die: DieConstructor
     const Port: PortConstructor
     const Label: LabelConstructor
     const Transition: TransitionConstructor
     const Text: TextConstructor
+    const Link: LinkConstructor
+    const application: Application
+    const Locals: Locals
+    const blendColors: blendColors
+    const hsl: hsl
+    const hsla: hsla
     const rgb: rgb
     const rgba: rgba
   }

package/piu/QRCode.d.ts

@@ -0,0 +1,42 @@
+/*
+ * 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/>.
+ *
+ */
+
+
+declare module "piu/QRCode" {
+  import { Content, ContentDictionary } from "piu/MC";
+
+  interface QRCode extends Content {
+    string: string
+  }
+  interface QRCodeDictionary extends ContentDictionary {
+    string?: string,
+    maxVersion?: number,
+  }
+  interface QRCodeConstructor {
+    new(behaviorData?: any, dictionary?: QRCodeDictionary): QRCode;
+    (behaviorData?: any, dictionary?: QRCodeDictionary): QRCode;
+
+    template<T>(this: T, fn: (arg: any) => QRCodeDictionary): T;
+  }
+
+  global {
+    const QRCode: QRCodeConstructor
+  }
+}

package/piu/Timeline.d.ts

@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2020-2021 Shinya Ishikawa
+ * Copyright (c) 2020-2025 Shinya Ishikawa
  *
  *   This file is part of the Moddable SDK Tools.
  *
@@ -27,14 +27,14 @@ declare module "piu/Timeline" {
       target: object,
       fromProperties: object,
       duration: number,
-      easing?: string,
+      easing?: (fraction: number) => number,
       delay?: number
     ): Timeline;
     on(
       target: object,
       onProperties: object,
       duration: number,
-      easing?: number,
+      easing?: (fraction: number) => number,
       delay?: number
     ): Timeline;
     seekTo(time: number): void;
@@ -42,7 +42,7 @@ declare module "piu/Timeline" {
       target: object,
       fromProperties: object,
       duration: number,
-      easing?: string,
+      easing?: (fraction: number) => number,
       delay?: number
     ): Timeline;
   }

package/piu/shape.d.ts

@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2022 Moddable Tech, Inc
+ * Copyright (c) 2022-2025 Moddable Tech, Inc
  *
  *   This file is part of the Moddable SDK Tools.
  *
@@ -31,10 +31,10 @@ declare module "piu/shape" {
     string?: string;
   }
   interface ShapeConstructor {
-    new (behaviorData: any, dictionary: ShapeDictionary): Shape;
-    (behaviorData: any, dictionary: ShapeDictionary): Shape;
+    new(behaviorData?: any, dictionary?: ShapeDictionary): Shape;
+    (behaviorData?: any, dictionary?: ShapeDictionary): Shape;
 
-    template<T>(this: T, any): T;
+    template<T>(this: T, fn: (arg: object) => ShapeDictionary): T;
   }
 
   global {

package/socket.d.ts

@@ -1,5 +1,5 @@
 /*
-* Copyright (c) 2019-2020 Bradley Farias
+* Copyright (c) 2019-2025  Bradley Farias
 *
 *   This file is part of the Moddable SDK Tools.
 *
@@ -67,15 +67,15 @@ declare module "socket" {
     callback: (message: MessageStatus, value?: number) => void;
   }
   class RawSocket extends SocketBase {
-    write(ip: string, data: ArrayBuffer);
+    write(ip: string, data: ArrayBuffer): void;
     write(): number;
   }
   class TCPSocket extends SocketBase {
-    write(data: WriteData, ...moreData: WriteData[]);
+    write(data: WriteData, ...moreData: WriteData[]): void;
     write(): number;
   }
   class UDPSocket extends SocketBase {
-    write(ip: string, port: number, data: ArrayBuffer);
+    write(ip: string, port: number, data: ArrayBuffer): void;
     write(): number;
   }
   export type ListenerOptions = {

package/text/decoder.d.ts

@@ -1,5 +1,5 @@
 /*
-* Copyright (c) 2022 Satoshi Tanaka
+* Copyright (c) 2022-2025  Satoshi Tanaka
 *
 *   This file is part of the Moddable SDK Tools.
 *
@@ -31,7 +31,7 @@ declare module "text/decoder" {
     decode(input?: Uint8Array | ArrayBufferLike, options?: TextDecodeOptions): string;
   }
 
-  var TextDecoder: {
+  const TextDecoder: {
     prototype: TextDecoder;
     new(label?: "utf-8", options?: TextDecoderOptions): TextDecoder;
   };

package/text/encoder.d.ts

@@ -1,5 +1,5 @@
 /*
-* Copyright (c) 2022 Satoshi Tanaka
+* Copyright (c) 2022-2025  Satoshi Tanaka
 *
 *   This file is part of the Moddable SDK Tools.
 *
@@ -29,7 +29,7 @@ declare module "text/encoder" {
         encodeInto(source: string, destination: Uint8Array): TextEncoderEncodeIntoResult;
     }
 
-    var TextEncoder: {
+    const TextEncoder: {
         prototype: TextEncoder;
         new(): TextEncoder;
     };

package/websocket.d.ts

@@ -1,5 +1,5 @@
 /*
-* Copyright (c) 2019-2020 Bradley Farias
+* Copyright (c) 2019-2025 Bradley Farias
 *
 *   This file is part of the Moddable SDK Tools.
 *
@@ -36,7 +36,7 @@ declare module "websocket" {
 
     constructor(options: WebSocketClientOptions);
     close(): void;
-    write(data: string | ArrayBuffer);
+    write(data: string | ArrayBuffer): void;
     callback: WebSocketClientCallback;
   }
 

package/xs.d.ts

@@ -58,7 +58,7 @@ interface StringConstructor {
 
 interface ArrayBufferConstructor {
 	fromString(string: string): ArrayBuffer;
-	fromBigInt(value: BigInt): ArrayBuffer;
+	fromBigInt(value: bigint): ArrayBuffer;
 }
 
 interface ArrayBuffer {
@@ -82,8 +82,8 @@ interface Uint8ArrayConstructor {
 }
 
 interface BigIntConstructor {
-	bitLength(value: BigInt): number
-	fromArrayBuffer(buffer: ArrayBufferLike): BigInt
+	bitLength(value: bigint): number
+	fromArrayBuffer(buffer: ArrayBufferLike): bigint
 }
 
 // integer math proposal
@@ -96,4 +96,8 @@ interface Math {
 	mod(a: number, b: number): number
 }
 
+// xs host objects, host functions
+declare function Native(name: string): new (...args: any[]) => any;
+declare function native(name: string): (...args: any[]) => any;
+
 // Compartment?