@geastack/core 0.1.38 → 0.1.40

package/index.d.ts

@@ -6,6 +6,7 @@ export type * from './audio-worklet'
 export declare function flushAudioWorkletOutput(): void
 export type * from './typed-arrays'
 import type { AudioContextOptions, AudioWorklet, MediaStreamAudioSourceNode } from './audio-worklet'
+export type * from './audio-worklet'
 
 // Opt-in native 64-bit integer. Structurally a `number` (assign/read without
 // casts), but where a binding, parameter, field, or return is annotated `int`,
@@ -18,6 +19,19 @@ import type { AudioContextOptions, AudioWorklet, MediaStreamAudioSourceNode } fr
 declare const __gea_int_brand: unique symbol
 declare global {
   type int = number & { readonly [__gea_int_brand]?: never }
+  type i64 = number & { readonly [__gea_int_brand]?: never }
+  type int64 = number & { readonly [__gea_int_brand]?: never }
+}
+
+// Opt-in native 32-bit integer: `int` at the width of a 32-bit core, held in an
+// `int32_t`. On an ESP32-S3 a 64-bit `int` sum is two instructions and its
+// quotient a library call; an `i32` one is a single instruction. Arithmetic
+// wraps at 32 bits, `/` landing in an `i32` truncates, and a Number stored into
+// one converts by ToInt32 (truncate, wrap, NaN -> 0). Under Node it is a number.
+declare const __gea_i32_brand: unique symbol
+declare global {
+  type i32 = number & { readonly [__gea_i32_brand]?: never }
+  type int32 = number & { readonly [__gea_i32_brand]?: never }
 }
 
 // Opt-in single-precision float. Structurally a `number` (assign/read without
@@ -82,6 +96,10 @@ export interface GeaIntrinsicElements {
   img: ImageProps
   input: NativeInputElementProps
   textarea: NativeTextAreaElementProps
+  select: NativeSelectProps
+  option: NativeOptionProps
+  stepper: NativeStepperProps
+  progress: NativeProgressProps
   'virtual-list': NativeVirtualListProps
 }
 
@@ -116,7 +134,11 @@ declare global {
   }
   const console: Console
 
-  function requestAnimationFrame(callback: (timestampMs: number) => void): number
+  // Retains the callback and runs it next frame, so it cannot be inert -- but it
+  // writes no property on anything, which is all the argument stamp asks.
+  // Native frames supply whole milliseconds; the request handle stays numeric.
+  /** @gea-host-no-property-writes */
+  function requestAnimationFrame(callback: (timestampMs: int) => void): number
 
   // Native one-shot / repeating timers (gea::host::setTimeout/setInterval,
   // engine/../host/include/host/timers.h), NOT Node's `NodeJS.Timeout` (there is
@@ -172,8 +194,20 @@ declare global {
     // fillText anchors the top of the line box, which carries ascender and
     // descender the glyphs do not fill, so subtracting half the font size sags.
     measureTextInkCenter(text: string): number
-    drawImageCircle(image: GeaEmbeddedImage, dx: number, dy: number, width: number, height: number): void
-    drawImageRotated90CW(image: GeaEmbeddedImage, dx: number, dy: number, width: number, height: number): void
+    drawImageCircle(
+      image: GeaEmbeddedImage,
+      dx: number,
+      dy: number,
+      width: number,
+      height: number,
+    ): void
+    drawImageRotated90CW(
+      image: GeaEmbeddedImage,
+      dx: number,
+      dy: number,
+      width: number,
+      height: number,
+    ): void
     drawImageTiledX(image: GeaEmbeddedImage, dx: number, dy: number, width: number): void
   }
 
@@ -197,7 +231,8 @@ export type StyleLength =
   | `max(${string})`
   | `clamp(${string})`
 export type StyleBox = StyleLength | string
-export type StylePreferredSize = StyleLength | 'auto' | 'min-content' | 'max-content' | 'fit-content'
+export type StylePreferredSize =
+  StyleLength | 'auto' | 'min-content' | 'max-content' | 'fit-content'
 export type StyleOverflow = 'visible' | 'hidden' | 'clip' | 'scroll' | 'auto' | 'overlay'
 export type ClassMap = Record<string, string | number | boolean | null | undefined>
 export type ClassValue = string | ClassMap
@@ -312,7 +347,10 @@ export interface Event {
 }
 
 export interface EventTarget {
-  addEventListener<K extends keyof GeaEventMap>(type: K, listener: (event: GeaEventMap[K]) => void): void
+  addEventListener<K extends keyof GeaEventMap>(
+    type: K,
+    listener: (event: GeaEventMap[K]) => void,
+  ): void
   addEventListener(type: string, listener: (event: Event) => void): void
 }
 
@@ -414,7 +452,9 @@ export interface PressEvent extends PointerEvent {
   readonly currentTarget: PressEventTarget
 }
 
-export type PressEventArgument = number & PressEvent
+// Native listeners receive the engine event. Numeric press metadata is exposed
+// through pressId/pressValue; the event itself is not an arithmetic value.
+export type PressEventArgument = PressEvent
 export type PressHandler = (event: PressEventArgument) => void
 
 export interface TouchPoint {
@@ -461,9 +501,8 @@ export interface RotaryEvent extends Event {
  * `keydown` is the engine's hardware-button/shortcut event and carries a
  * `KeyEvent`; `input` carries an `InputEvent`. Both are dispatched off-tree by
  * the runtime (`dispatch_key_input`, and `virtual_keyboard.cpp`'s synthetic
- * pair). `keyup` and `pointercancel` are deliberately ABSENT: `eventTypeIndex`
- * returns -1 for both, so `addEventListener` drops them and the handler would
- * never run. Declaring them would promise a callback the engine does not make.
+ * pair). Hardware button releases dispatch `keyup` with the same KeyEvent.
+ * `pointercancel` remains unsupported by the native event dispatcher.
  */
 export interface GeaEventMap {
   click: PressEvent
@@ -475,6 +514,7 @@ export interface GeaEventMap {
   pointerup: PointerEvent
   input: InputEvent
   keydown: KeyEvent
+  keyup: KeyEvent
   rotary: RotaryEvent
   scroll: Event
 }
@@ -501,9 +541,12 @@ export interface NativeTouchEventAttributes {
 }
 
 export interface NativeEventAttributes extends NativeTouchEventAttributes {
+  /** Text services and app-owned editors may dispatch input on ordinary views. */
+  onInput?: (event: InputEvent) => void
   onClick?: PressHandler
   onPress?: PressHandler
   onKeyDown?: (event: KeyEvent) => void
+  onKeyUp?: (event: KeyEvent) => void
   onRotary?: RotaryEventHandler
 }
 
@@ -612,7 +655,10 @@ export interface AudioProps extends DataAttributes {
   autoplay?: boolean | string | number
   controls?: boolean | string | number
   loop?: boolean | string | number
-  ref?: HTMLAudioElement | (typeof globalThis extends { HTMLAudioElement: { prototype: infer E } } ? E : never) | null
+  ref?:
+    | HTMLAudioElement
+    | (typeof globalThis extends { HTMLAudioElement: { prototype: infer E } } ? E : never)
+    | null
   autoPlay?: boolean
   children?: any
 }
@@ -626,7 +672,10 @@ export interface VideoProps extends DataAttributes {
   playsinline?: boolean
   autoPlay?: boolean
   playsInline?: boolean
-  ref?: HTMLVideoElement | (typeof globalThis extends { HTMLVideoElement: { prototype: infer E } } ? E : never) | null
+  ref?:
+    | HTMLVideoElement
+    | (typeof globalThis extends { HTMLVideoElement: { prototype: infer E } } ? E : never)
+    | null
 }
 
 export type ImageSource = string | ArrayBuffer | Uint8Array | GeaEmbeddedImage
@@ -688,7 +737,10 @@ export interface LoadImageOptions {
 // native `GeaEmbeddedImage` handle directly rather than a Promise — `await` still
 // works and keeps the value (and any `GeaEmbeddedImage[]` cache) a concrete
 // struct instead of a boxed gea_cpp_value.
-export declare function loadImage(src: string | ArrayBuffer | Uint8Array, options?: LoadImageOptions): GeaEmbeddedImage
+export declare function loadImage(
+  src: string | ArrayBuffer | Uint8Array,
+  options?: LoadImageOptions,
+): GeaEmbeddedImage
 export declare function loadImageWithOpaque(src: Uint8Array, opaque: boolean): GeaEmbeddedImage
 
 // Load + decode an image directly from a persistent-cache file (e.g. a microSD
@@ -713,6 +765,9 @@ export declare function writeCacheFile(path: string, bytes: Uint8Array): boolean
 // pushed to /sdcard). Empty Uint8Array when the file is absent / no storage.
 export declare function readCacheFile(path: string): Uint8Array
 
+/** Delete a persistent-cache file. */
+export declare function removeCacheFile(path: string): boolean
+
 // Read a .pmtiles archive flashed into the spare ota_1 partition over USB
 // (esptool). Empty Uint8Array when none present (or off-device).
 export declare function readMapArchive(): Uint8Array
@@ -798,7 +853,7 @@ export class Component<RootElement extends GeaElement = GeaElement, Props = void
 // reactive overhead. Extend this only when the component manages its own state.
 export class ReactiveComponent<
   RootElement extends GeaElement = GeaElement,
-  Props = void
+  Props = void,
 > extends Component<RootElement, Props> {}
 
 export interface BluetoothKeyboard {
@@ -969,9 +1024,28 @@ export interface CanvasRenderingContext2D {
   fillCircle(x: number, y: number, radius: number, fill?: string | number): void
   strokeCircle(x: number, y: number, radius: number): void
   fillCircleRgb565(x: number, y: number, radius: number, color: number): void
-  fillTriangleRgb565(x0: number, y0: number, x1: number, y1: number, x2: number, y2: number, color: number): void
-  fillCirclesRgb565(xs: ArrayLike<number>, ys: ArrayLike<number>, radius: number, colors: ArrayLike<number>, count?: number): void
-  fillCirclesRgb565Uniform(xs: ArrayLike<number>, ys: ArrayLike<number>, radius: number, color: number): void
+  fillTriangleRgb565(
+    x0: number,
+    y0: number,
+    x1: number,
+    y1: number,
+    x2: number,
+    y2: number,
+    color: number,
+  ): void
+  fillCirclesRgb565(
+    xs: ArrayLike<number>,
+    ys: ArrayLike<number>,
+    radius: number,
+    colors: ArrayLike<number>,
+    count?: number,
+  ): void
+  fillCirclesRgb565Uniform(
+    xs: ArrayLike<number>,
+    ys: ArrayLike<number>,
+    radius: number,
+    color: number,
+  ): void
   /**
    * Batched opaque triangles as ONE recorded present command. `order[0..count)`
    * indexes the coordinate/colour arrays in paint (depth) order; colours are
@@ -1012,8 +1086,20 @@ export interface CanvasRenderingContext2D {
   // with no alpha plane: the blit skips the pixels outside the shape rather
   // than blending them. A square opaque tile would otherwise paint its
   // corners over whatever it overlaps.
-  drawImageCircle(image: GeaEmbeddedImage, dx: number, dy: number, width: number, height: number): void
-  drawImageRotated90CW(image: GeaEmbeddedImage, dx: number, dy: number, width: number, height: number): void
+  drawImageCircle(
+    image: GeaEmbeddedImage,
+    dx: number,
+    dy: number,
+    width: number,
+    height: number,
+  ): void
+  drawImageRotated90CW(
+    image: GeaEmbeddedImage,
+    dx: number,
+    dy: number,
+    width: number,
+    height: number,
+  ): void
   drawImageTiledX(image: GeaEmbeddedImage, dx: number, dy: number, width: number): void
   /**
    * An RGB565 pixel buffer the app writes directly:
@@ -1023,6 +1109,16 @@ export interface CanvasRenderingContext2D {
   createImageData565(width: number, height: number): ImageData565
   /** Draw an `ImageData565` with its top-left corner at (dx, dy): one blit. */
   putImageData(image: ImageData565, dx: number, dy: number): void
+  /** Draw only the dirty rectangle of an `ImageData565`, at (dx + dirtyX, dy + dirtyY). */
+  putImageData(
+    image: ImageData565,
+    dx: number,
+    dy: number,
+    dirtyX: number,
+    dirtyY: number,
+    dirtyWidth: number,
+    dirtyHeight: number,
+  ): void
   flush(): void
   beginBatch(): void
   endBatch(): void
@@ -1067,7 +1163,8 @@ export interface DisplayEpaperRefreshConfig {
   fullOnCover?: boolean
 }
 
-export type DisplayOrientation = 'portrait-primary' | 'portrait-secondary' | 'landscape-primary' | 'landscape-secondary'
+export type DisplayOrientation =
+  'portrait-primary' | 'portrait-secondary' | 'landscape-primary' | 'landscape-secondary'
 
 export type DisplayOrientationSupport = DisplayOrientation | 'portrait' | 'landscape' | 'all'
 
@@ -1094,7 +1191,9 @@ export interface DisplayController {
   getOrientation(): DisplayOrientation
   setOrientation(orientation: DisplayOrientation): void
   getSupportedOrientations(): DisplayOrientationSupport[]
-  setSupportedOrientations(orientations: DisplayOrientationSupport | DisplayOrientationSupport[]): void
+  setSupportedOrientations(
+    orientations: DisplayOrientationSupport | DisplayOrientationSupport[],
+  ): void
   getAutoRotate(): boolean
   setAutoRotate(enabled: boolean): void
   /**
@@ -1244,6 +1343,9 @@ export interface LedController {
 export declare const Led: LedController
 
 export interface ClockController {
+  /** Set wall time and persist to the board RTC when present. */
+  setEpochMs(timestamp: number): boolean
+
   // Milliseconds since the Unix epoch from the platform real-time clock
   // (gettimeofday). Reflects a host-set time (GEADEV SETTIME / the companion
   // app on launch). Unlike Date.now() — which reads a monotonic clock on
@@ -1283,12 +1385,21 @@ declare global {
 }
 
 export interface BatteryController {
+  /** External power is present. */
+  charging(): boolean
+
   // Battery charge percentage (0-100) read from the platform PMU.
   level(): number
 }
 
 export declare const Battery: BatteryController
 
+export interface HapticsController {
+  vibrate(durationMs: number, strength?: number): boolean
+}
+
+export declare const Haptics: HapticsController
+
 export interface NotifyController {
   // Transient host->app notification channel (e.g. pushed from the companion
   // via GEADEV NOTIFY). text() is the latest message; seq() increments on each
@@ -1327,9 +1438,17 @@ export interface AudioBuffer {
   readonly length: number
   readonly duration: number
   readonly numberOfChannels: number
-  copyFromChannel(destination: Float32Array<ArrayBuffer>, channelNumber: number, bufferOffset?: number): void
-  copyToChannel(source: Float32Array<ArrayBuffer>, channelNumber: number, bufferOffset?: number): void
-  getChannelData(channel: number): Float32Array<ArrayBuffer>
+  copyFromChannel(
+    destination: Float32Array<ArrayBufferLike>,
+    channelNumber: number,
+    bufferOffset?: number,
+  ): void
+  copyToChannel(
+    source: Float32Array<ArrayBufferLike>,
+    channelNumber: number,
+    bufferOffset?: number,
+  ): void
+  getChannelData(channel: number): Float32Array<ArrayBufferLike>
 }
 
 export interface AudioBufferSourceNode {
@@ -1358,6 +1477,7 @@ export interface AudioContext {
   readonly currentTime: number
   readonly destination: AudioDestinationNode
   createOscillator(): OscillatorNode
+  createBuffer(numberOfChannels: number, length: number, sampleRate: number): AudioBuffer
   createBufferSource(): AudioBufferSourceNode
   decodeAudioData(audioData: ArrayBuffer | Uint8Array | GeaAudioBlob): Promise<AudioBuffer>
   createMediaStreamSource(stream: MediaStream): MediaStreamAudioSourceNode
@@ -1486,6 +1606,8 @@ export interface CameraController {
   /** Capture a still frame. `capturePhoto` is the preferred alias of `capture`. */
   capture(options?: CameraCaptureOptions): Promise<CameraPhoto>
   capturePhoto(options?: CameraCaptureOptions): Promise<CameraPhoto>
+  /** Take the newest encoded JPEG data URL without waiting; empty when no fresh frame is ready. */
+  captureFrame(): string
   /** Record a video clip (esp32-p4: Motion-JPEG; iOS movie: later). */
   startRecording(options: CameraRecordOptions): Promise<void>
   stopRecording(): Promise<CameraClip>
@@ -1545,12 +1667,12 @@ export interface GeolocationController {
   getCurrentPosition(
     success: (position: GeolocationPosition) => void,
     error?: (error: GeolocationPositionError) => void,
-    options?: PositionOptions
+    options?: PositionOptions,
   ): void
   watchPosition(
     success: (position: GeolocationPosition) => void,
     error?: (error: GeolocationPositionError) => void,
-    options?: PositionOptions
+    options?: PositionOptions,
   ): number
   clearWatch(id: number): void
 }
@@ -1559,6 +1681,12 @@ export declare const Geolocation: GeolocationController
 export declare const geolocation: GeolocationController
 
 export interface WiFiController {
+  accessPointMac(): string
+  startCaptivePortal(): boolean
+  stopCaptivePortal(): void
+  startAccessPoint(ssid: string, password?: string): boolean
+  stopAccessPoint(): void
+
   enabled(): boolean
   setEnabled(enabled: boolean): void
   connected(): boolean
@@ -1589,7 +1717,8 @@ export interface ButtonProps {
   children?: any
 }
 
-export interface NativeButtonProps extends NativeEventAttributes {
+export interface NativeButtonProps extends DataAttributes, NativeEventAttributes {
+  id?: string
   disabled?: boolean
   key?: string | number
   class?: ClassValue
@@ -1621,12 +1750,9 @@ export interface NativeVirtualListProps extends NativeEventAttributes {
 export interface InputElementProps {
   class?: ClassValue
   style?: Style
-  // The three shapes the renderer actually materializes: `range` becomes an
-  // NSSlider and `checkbox` an NSSwitch, everything else an NSTextField
-  // (`apple/targets/macos/main/macos_renderer.mm`, `makeViewForType`). The union
-  // had drifted to the text-field spellings alone, so an app writing the switch
-  // the renderer has always drawn did not typecheck.
-  type?: 'text' | 'password' | 'button' | 'range' | 'checkbox'
+  // macOS uses NSSlider for range, NSButton for radio, and NSSwitch for checkbox.
+  // Add data-control="checkbox" for an AppKit checkbox button.
+  type?: 'text' | 'password' | 'button' | 'range' | 'checkbox' | 'radio'
   // Optional, because the renderer treats it as one: every reader guards with
   // `if (value && value[0])`, and `applySwitchProps` never reads it at all --
   // a switch's state is `checked`. Requiring it made `<input type="checkbox">`
@@ -1639,7 +1765,11 @@ export interface InputElementProps {
   // switch's state and is written back on toggle.
   min?: number | string
   max?: number | string
+  step?: number | string
   checked?: boolean | string
+  disabled?: boolean
+  readOnly?: boolean
+  name?: string
   placeholder?: string
   autoFocus?: boolean | number
   pressId?: number
@@ -1649,13 +1779,16 @@ export interface InputElementProps {
   onFocus?: () => void
   onBlur?: () => void
   onKeyDown?: (event: KeyEvent) => void
+  onKeyUp?: (event: KeyEvent) => void
   input?: (value: string) => void
   focus?: () => void
   blur?: () => void
   keydown?: (keyCode: number) => void
+  keyup?: (keyCode: number) => void
 }
 
-export interface NativeInputElementProps extends InputElementProps {
+export interface NativeInputElementProps extends InputElementProps, DataAttributes {
+  id?: string
   ref?: GeaElement | null
 }
 
@@ -1669,10 +1802,40 @@ export interface TextAreaElementProps {
   onBlur?: () => void
 }
 
-export interface NativeTextAreaElementProps extends TextAreaElementProps {
+export interface NativeTextAreaElementProps extends TextAreaElementProps, DataAttributes {
+  id?: string
+  disabled?: boolean
+  readOnly?: boolean
   ref?: GeaElement | null
 }
 
+export interface NativeSelectProps extends NativeViewProps {
+  value?: string
+  disabled?: boolean
+  onInput?: (event: InputEvent) => void
+}
+
+export interface NativeOptionProps extends TextProps {
+  value?: string
+  selected?: boolean
+  disabled?: boolean
+}
+
+export interface NativeStepperProps extends NativeViewProps {
+  value?: string
+  min?: number | string
+  max?: number | string
+  step?: number | string
+  disabled?: boolean
+  onInput?: (event: InputEvent) => void
+}
+
+export interface NativeProgressProps extends NativeViewProps {
+  value?: number | string
+  max?: number | string
+  indeterminate?: boolean
+}
+
 export declare function mount(component: new () => Component): void
 
 /**
@@ -1735,7 +1898,7 @@ export declare function fetchUploadFileAsync(
   contentType: string,
   prefix: string,
   filePath: string,
-  suffix: string
+  suffix: string,
 ): number
 
 /**
@@ -1764,7 +1927,7 @@ declare global {
     contentType: string,
     prefix: string,
     filePath: string,
-    suffix: string
+    suffix: string,
   ): number
   function fetchDownloadFileAsync(url: string, auth: string, destPath: string): number
   function fetchUploadProgress(id: number): number
@@ -1830,7 +1993,16 @@ declare global {
  * off disk — a reply that sets `file` streams that path on the server worker
  * without ever loading the bytes into JS.
  */
+export interface HttpHeader {
+  name: string
+  value: string
+}
+
 export interface IncomingMessage {
+  readonly headers: HttpHeader[]
+  /** Raw request body, limited to 2 MiB by the native server. */
+  readonly body: Uint8Array
+
   /** "GET", "POST", ... */
   readonly method: string
   /** Full request target including the query string (e.g. "/n/3.wav?x=1"). */
@@ -1842,6 +2014,7 @@ export interface IncomingMessage {
 }
 
 export interface HttpReply {
+  headers?: HttpHeader[]
   /** HTTP status code. Defaults to 200. */
   status?: number
   /** Response Content-Type. Defaults to "text/plain". */
@@ -1899,7 +2072,13 @@ export interface MediaStreamConstructor {
 }
 
 export interface MediaStreamConstraints {
-  audio?: boolean | { sampleRate?: number; channelCount?: number; echoCancellation?: boolean }
+  audio?:
+    | boolean
+    | {
+        sampleRate?: number
+        channelCount?: number
+        echoCancellation?: boolean
+      }
   video?: false
 }
 
@@ -2095,7 +2274,9 @@ export interface RTCDataChannelInit {
   negotiated?: boolean
   id?: number
 }
-export interface RTCDataChannelMessageEvent { readonly data: string | ArrayBuffer }
+export interface RTCDataChannelMessageEvent {
+  readonly data: string | ArrayBuffer
+}
 export interface RTCDataChannel {
   readonly label: string
   readonly protocol: string
@@ -2118,8 +2299,12 @@ export interface RTCRtpSender {
   readonly track: MediaStreamTrack | null
   replaceTrack(track: MediaStreamTrack | null): Promise<void>
 }
-export interface RTCRtpReceiver { readonly track: MediaStreamTrack | null }
-export interface RTCRtpTransceiverInit { direction?: 'sendrecv' | 'sendonly' | 'recvonly' | 'inactive' }
+export interface RTCRtpReceiver {
+  readonly track: MediaStreamTrack | null
+}
+export interface RTCRtpTransceiverInit {
+  direction?: 'sendrecv' | 'sendonly' | 'recvonly' | 'inactive'
+}
 export interface RTCRtpTransceiver {
   readonly sender: RTCRtpSender
   readonly receiver: RTCRtpReceiver
@@ -2131,8 +2316,10 @@ export interface RTCRtpTransceiver {
 }
 
 export interface RTCPeerConnectionInstance {
-  readonly connectionState: 'new' | 'connecting' | 'connected' | 'disconnected' | 'failed' | 'closed'
-  readonly iceConnectionState: 'new' | 'checking' | 'connected' | 'completed' | 'failed' | 'disconnected' | 'closed'
+  readonly connectionState:
+    'new' | 'connecting' | 'connected' | 'disconnected' | 'failed' | 'closed'
+  readonly iceConnectionState:
+    'new' | 'checking' | 'connected' | 'completed' | 'failed' | 'disconnected' | 'closed'
 
   onicecandidate: ((event: RTCPeerConnectionIceEvent) => void) | null
   ontrack: ((event: RTCTrackEvent) => void) | null
@@ -2147,7 +2334,10 @@ export interface RTCPeerConnectionInstance {
   ondatachannel: ((event: { channel: RTCDataChannel }) => void) | null
   addTrack(track: MediaStreamTrack, stream?: MediaStream): RTCRtpSender
   removeTrack(sender: RTCRtpSender): void
-  addTransceiver(trackOrKind: MediaStreamTrack | 'audio', init?: RTCRtpTransceiverInit): RTCRtpTransceiver
+  addTransceiver(
+    trackOrKind: MediaStreamTrack | 'audio',
+    init?: RTCRtpTransceiverInit,
+  ): RTCRtpTransceiver
   getTransceivers(): RTCRtpTransceiver[]
   getSenders(): RTCRtpSender[]
   getReceivers(): RTCRtpReceiver[]
@@ -2169,7 +2359,6 @@ declare global {
   function Image(props: ImageProps): GeaJsxElement
 }
 
-
 /** Streaming mono signed PCM16, little endian, carried as base64 text. */
 export interface PcmAudioStream {
   setInput(stream: MediaStream): void

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@geastack/core",
-  "version": "0.1.38",
+  "version": "0.1.40",
   "description": "GeaStack app API, reactivity headers, runtime sources, and type declarations.",
   "license": "Apache-2.0",
   "repository": {
@@ -65,8 +65,8 @@
     "@babel/types": "^7.23.0",
     "@geajs/core": "1.5.1",
     "@geajs/vite-plugin": "1.5.0",
-    "@geastack/compiler": "^1.0.23",
-    "@geastack/geatsc-plugin-gea": "^0.1.20",
+    "@geastack/compiler": "^1.0.29",
+    "@geastack/geatsc-plugin-gea": "^0.1.22",
     "opentype.js": "^2.0.0",
     "vite": "^8.0.0"
   }

package/runtime/audio-worklet.ts

@@ -13,14 +13,10 @@ export function flushAudioWorkletOutput(): void {
   __geaFlushAudioWorkletOutput()
 }
 
-declare function __geaRegisterAudioWorkletProcessor(
+declare function __geaRegisterAudioWorkletProcessor<T extends AudioWorkletProcessor>(
   name: string,
-  create: () => AudioWorkletProcessor,
-  process: (
-    processor: AudioWorkletProcessor,
-    inputs: Float32Array[][],
-    outputs: Float32Array[][]
-  ) => boolean
+  create: () => T,
+  process: (processor: T, inputs: Float32Array[][], outputs: Float32Array[][]) => boolean,
 ): void
 
 export abstract class AudioWorkletProcessor {
@@ -33,19 +29,19 @@ export abstract class AudioWorkletProcessor {
   abstract process(
     inputs: Float32Array[][],
     outputs: Float32Array[][],
-    parameters: Record<string, Float32Array>
+    parameters: Record<string, Float32Array>,
   ): boolean
 }
 
 // The native module builder validates the concrete registration constructor.
 // AudioParam descriptors are explicitly unsupported, before code generation.
-export function registerProcessor(
+export function registerProcessor<T extends AudioWorkletProcessor>(
   name: string,
-  constructor: new () => AudioWorkletProcessor
+  constructor: new () => T,
 ): void {
   __geaRegisterAudioWorkletProcessor(
     name,
     () => new constructor(),
-    (processor, inputs, outputs) => processor.process(inputs, outputs, {})
+    (processor, inputs, outputs) => processor.process(inputs, outputs, {}),
   )
 }