@driftengine/native-host 4.7.3 → 4.8.0

package/dist/canvas.d.ts

@@ -13,12 +13,10 @@
  * drawn into the window, and copyable, to be read back by the pixel gate.
  */
 import { CanvasStyle } from './canvasStyle.ts';
-import { type Handlers, HostNode } from './domTree.ts';
-import { INPUT_TYPES, type PageDocument } from './page.ts';
+import { type PageDocument } from './page.ts';
 import { PointerCapture } from './pointerCapture.ts';
-export interface NativeCanvas extends Handlers<(typeof INPUT_TYPES)[number]> {
-}
-export declare class NativeCanvas extends HostNode {
+declare const NativeCanvas_base: abstract new () => import("./domTree.ts").HostNode & import("./domTree.ts").Handlers<"auxclick" | "blur" | "click" | "contextmenu" | "dblclick" | "focus" | "fullscreenchange" | "fullscreenerror" | "gotpointercapture" | "keydown" | "keypress" | "keyup" | "lostpointercapture" | "mousedown" | "mouseenter" | "mouseleave" | "mousemove" | "mouseout" | "mouseover" | "mouseup" | "pointercancel" | "pointerdown" | "pointerenter" | "pointerleave" | "pointermove" | "pointerout" | "pointerover" | "pointerup" | "touchcancel" | "touchend" | "touchmove" | "touchstart" | "wheel">;
+export declare class NativeCanvas extends NativeCanvas_base {
     /** The drawing buffer, in device pixels, which the engine sets. */
     width: number;
     height: number;
@@ -95,3 +93,4 @@ export declare class NativeCanvasContext {
     getCurrentTexture(): GPUTexture;
     private dropTexture;
 }
+export {};

package/dist/canvas.js

@@ -13,14 +13,14 @@
  * drawn into the window, and copyable, to be read back by the pixel gate.
  */
 import { CanvasStyle } from './canvasStyle.js';
-import { HostNode } from './domTree.js';
+import { withHandlers } from './domTree.js';
 import { INPUT_TYPES } from './page.js';
 import { PointerCapture } from './pointerCapture.js';
 /* Texture usage flags, named here rather than read off a global a host may not have installed. */
 const COPY_SRC = 0x01;
 const TEXTURE_BINDING = 0x04;
 const RENDER_ATTACHMENT = 0x10;
-export class NativeCanvas extends HostNode {
+export class NativeCanvas extends withHandlers(INPUT_TYPES) {
     /** The drawing buffer, in device pixels, which the engine sets. */
     width;
     height;
@@ -45,9 +45,6 @@ export class NativeCanvas extends HostNode {
      * reports −1 and `focus()` does nothing.
      */
     focusIndex = null;
-    static {
-        HostNode.handles(NativeCanvas.prototype, INPUT_TYPES);
-    }
     constructor(width, height, pixelRatio = 1) {
         super();
         this.pixelRatio = pixelRatio;

package/dist/domTree.d.ts

@@ -32,3 +32,13 @@ export declare class HostNode implements EventTarget {
     protected static handles(prototype: object, types: readonly string[]): void;
     private invoke;
 }
+/**
+ * A base class whose instances carry an `on<type>` attribute for each type given.
+ *
+ * `handles` defines them on this base's prototype as accessors, and the type says so. A class body
+ * cannot declare one property per member of a union, and an interface merged into the class to say
+ * it is a merge the checker cannot hold to its initialisers. The cast below is the one place the two
+ * meet, and it is true by construction: the static block above it has just defined every attribute
+ * the type names.
+ */
+export declare function withHandlers<Types extends string>(types: readonly Types[]): abstract new () => HostNode & Handlers<Types>;

package/dist/domTree.js

@@ -92,8 +92,8 @@ export class HostNode {
         list.splice(at, 1);
     }
     dispatchEvent(event) {
-        const path = [];
-        for (let node = this; node !== null; node = node.parentNode)
+        const path = [this];
+        for (let node = this.parentNode; node !== null; node = node.parentNode)
             path.push(node);
         const dispatch = {
             target: this,
@@ -192,3 +192,20 @@ export class HostNode {
         }
     }
 }
+/**
+ * A base class whose instances carry an `on<type>` attribute for each type given.
+ *
+ * `handles` defines them on this base's prototype as accessors, and the type says so. A class body
+ * cannot declare one property per member of a union, and an interface merged into the class to say
+ * it is a merge the checker cannot hold to its initialisers. The cast below is the one place the two
+ * meet, and it is true by construction: the static block above it has just defined every attribute
+ * the type names.
+ */
+export function withHandlers(types) {
+    class Handled extends HostNode {
+        static {
+            HostNode.handles(this.prototype, types);
+        }
+    }
+    return Handled;
+}

package/dist/mediaQueries.d.ts

@@ -35,6 +35,7 @@ export interface MediaFacts {
 export declare class MediaQueryList extends HostNode {
     readonly media: string;
     private readonly answer;
+    onchange: ((event: Event) => unknown) | null;
     private last;
     constructor(media: string, answer: () => boolean);
     get matches(): boolean;
@@ -44,9 +45,6 @@ export declare class MediaQueryList extends HostNode {
     /** Tell the list's listeners if its answer has flipped since they were last told. */
     recheck(): void;
 }
-export interface MediaQueryList {
-    onchange: ((event: Event) => unknown) | null;
-}
 export declare class MediaQueries {
     private readonly facts;
     private readonly lists;

package/dist/page.d.ts

@@ -20,20 +20,14 @@
  */
 import { UserActivation } from './activation.ts';
 import type { NativeCanvas } from './canvas.ts';
-import { type Handlers, HostNode } from './domTree.ts';
+import { HostNode } from './domTree.ts';
 import { PageFullscreen } from './fullscreen.ts';
 import { MediaQueries, type MediaQueryList } from './mediaQueries.ts';
 import { PointerCapture } from './pointerCapture.ts';
 /** Every input event a page can be told of, which each of the three nodes answers `on…` for. */
 export declare const INPUT_TYPES: readonly ["keydown", "keypress", "keyup", "focus", "blur", "wheel", "contextmenu", "click", "dblclick", "auxclick", "mousedown", "mouseup", "mousemove", "mouseover", "mouseout", "mouseenter", "mouseleave", "pointerdown", "pointerup", "pointermove", "pointerover", "pointerout", "pointerenter", "pointerleave", "pointercancel", "gotpointercapture", "lostpointercapture", "touchstart", "touchmove", "touchend", "touchcancel", "fullscreenchange", "fullscreenerror"];
-type InputType = (typeof INPUT_TYPES)[number];
-declare const WINDOW_TYPES: readonly ['resize', 'beforeunload', 'gamepadconnected', 'gamepaddisconnected'];
-declare const DOCUMENT_TYPES: readonly ['visibilitychange', 'pointerlockchange', 'pointerlockerror', 'fullscreenchange', 'fullscreenerror'];
-export interface PageWindow extends Handlers<InputType | (typeof WINDOW_TYPES)[number]> {
-}
-export interface PageDocument extends Handlers<InputType | (typeof DOCUMENT_TYPES)[number]> {
-}
-export declare class PageWindow extends HostNode {
+declare const PageWindow_base: abstract new () => HostNode & import("./domTree.ts").Handlers<"auxclick" | "beforeunload" | "blur" | "click" | "contextmenu" | "dblclick" | "focus" | "fullscreenchange" | "fullscreenerror" | "gamepadconnected" | "gamepaddisconnected" | "gotpointercapture" | "keydown" | "keypress" | "keyup" | "lostpointercapture" | "mousedown" | "mouseenter" | "mouseleave" | "mousemove" | "mouseout" | "mouseover" | "mouseup" | "pointercancel" | "pointerdown" | "pointerenter" | "pointerleave" | "pointermove" | "pointerout" | "pointerover" | "pointerup" | "resize" | "touchcancel" | "touchend" | "touchmove" | "touchstart" | "wheel">;
+export declare class PageWindow extends PageWindow_base {
     canvas: NativeCanvas | null;
     /** Answered by the page, which knows what a query asks about (`mediaQueries.ts`). */
     matchMedia: (query: string) => MediaQueryList;
@@ -41,7 +35,8 @@ export declare class PageWindow extends HostNode {
     get innerHeight(): number;
     get devicePixelRatio(): number;
 }
-export declare class PageDocument extends HostNode {
+declare const PageDocument_base: abstract new () => HostNode & import("./domTree.ts").Handlers<"auxclick" | "blur" | "click" | "contextmenu" | "dblclick" | "focus" | "fullscreenchange" | "fullscreenerror" | "gotpointercapture" | "keydown" | "keypress" | "keyup" | "lostpointercapture" | "mousedown" | "mouseenter" | "mouseleave" | "mousemove" | "mouseout" | "mouseover" | "mouseup" | "pointercancel" | "pointerdown" | "pointerenter" | "pointerleave" | "pointerlockchange" | "pointerlockerror" | "pointermove" | "pointerout" | "pointerover" | "pointerup" | "touchcancel" | "touchend" | "touchmove" | "touchstart" | "visibilitychange" | "wheel">;
+export declare class PageDocument extends PageDocument_base {
     visibilityState: DocumentVisibilityState;
     pointerLockElement: Element | null;
     /** What is focused: the canvas, once it is focusable and asked, or nothing. */

package/dist/page.js

@@ -19,7 +19,7 @@
  * say so; a packaged game is given the bridge.
  */
 import { UserActivation } from './activation.js';
-import { HostNode } from './domTree.js';
+import { HostNode, withHandlers } from './domTree.js';
 import { installEventClasses } from './eventClasses.js';
 import { PageFullscreen } from './fullscreen.js';
 import { MediaQueries } from './mediaQueries.js';
@@ -42,7 +42,7 @@ const DOCUMENT_TYPES = [
     'fullscreenchange',
     'fullscreenerror',
 ];
-export class PageWindow extends HostNode {
+export class PageWindow extends withHandlers([...INPUT_TYPES, ...WINDOW_TYPES]) {
     canvas = null;
     /** Answered by the page, which knows what a query asks about (`mediaQueries.ts`). */
     matchMedia = () => {
@@ -57,11 +57,8 @@ export class PageWindow extends HostNode {
     get devicePixelRatio() {
         return this.canvas?.pixelRatio ?? 1;
     }
-    static {
-        HostNode.handles(PageWindow.prototype, [...INPUT_TYPES, ...WINDOW_TYPES]);
-    }
 }
-export class PageDocument extends HostNode {
+export class PageDocument extends withHandlers([...INPUT_TYPES, ...DOCUMENT_TYPES]) {
     visibilityState = 'visible';
     pointerLockElement = null;
     /** What is focused: the canvas, once it is focusable and asked, or nothing. */
@@ -94,9 +91,6 @@ export class PageDocument extends HostNode {
     createElement(tag) {
         throw new Error(`[driftengine] the native host has no DOM to make a <${tag}> in`);
     }
-    static {
-        HostNode.handles(PageDocument.prototype, [...INPUT_TYPES, ...DOCUMENT_TYPES]);
-    }
 }
 export class HostPage {
     window = new PageWindow();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@driftengine/native-host",
-  "version": "4.7.3",
+  "version": "4.8.0",
   "description": "The engine on a native window and a native WebGPU device, with no browser between them",
   "license": "Apache-2.0",
   "type": "module",
@@ -37,13 +37,13 @@
     "node-web-audio-api": "2.2.0"
   },
   "devDependencies": {
-    "@driftengine/audio": "4.7.3"
+    "@driftengine/audio": "4.8.0"
   },
   "peerDependencies": {
-    "@driftengine/core": "4.7.3",
-    "@driftengine/package": "4.7.3",
-    "@driftengine/texture": "4.7.3",
-    "@driftengine/ui2d": "4.7.3"
+    "@driftengine/core": "4.8.0",
+    "@driftengine/package": "4.8.0",
+    "@driftengine/texture": "4.8.0",
+    "@driftengine/ui2d": "4.8.0"
   },
   "peerDependenciesMeta": {
     "@driftengine/texture": {

package/src/canvas.ts

@@ -14,7 +14,7 @@
  */
 
 import { CanvasStyle } from './canvasStyle.ts';
-import { type Handlers, HostNode } from './domTree.ts';
+import { withHandlers } from './domTree.ts';
 import { INPUT_TYPES, type PageDocument } from './page.ts';
 import { PointerCapture } from './pointerCapture.ts';
 
@@ -23,10 +23,7 @@ const COPY_SRC = 0x01;
 const TEXTURE_BINDING = 0x04;
 const RENDER_ATTACHMENT = 0x10;
 
-/* The attributes `HostNode.handles` defines below, declared for the checker. */
-export interface NativeCanvas extends Handlers<(typeof INPUT_TYPES)[number]> {}
-
-export class NativeCanvas extends HostNode {
+export class NativeCanvas extends withHandlers(INPUT_TYPES) {
   /** The drawing buffer, in device pixels, which the engine sets. */
   width: number;
   height: number;
@@ -53,10 +50,6 @@ export class NativeCanvas extends HostNode {
    */
   private focusIndex: number | null = null;
 
-  static {
-    HostNode.handles(NativeCanvas.prototype, INPUT_TYPES);
-  }
-
   constructor(width: number, height: number, pixelRatio = 1) {
     super();
     this.pixelRatio = pixelRatio;

package/src/domTree.ts

@@ -125,8 +125,8 @@ export class HostNode implements EventTarget {
   }
 
   dispatchEvent(event: Event): boolean {
-    const path: HostNode[] = [];
-    for (let node: HostNode | null = this; node !== null; node = node.parentNode) path.push(node);
+    const path: HostNode[] = [this];
+    for (let node = this.parentNode; node !== null; node = node.parentNode) path.push(node);
     const dispatch: Dispatch = {
       target: this,
       current: null,
@@ -213,3 +213,23 @@ export class HostNode implements EventTarget {
     }
   }
 }
+
+/**
+ * A base class whose instances carry an `on<type>` attribute for each type given.
+ *
+ * `handles` defines them on this base's prototype as accessors, and the type says so. A class body
+ * cannot declare one property per member of a union, and an interface merged into the class to say
+ * it is a merge the checker cannot hold to its initialisers. The cast below is the one place the two
+ * meet, and it is true by construction: the static block above it has just defined every attribute
+ * the type names.
+ */
+export function withHandlers<Types extends string>(
+  types: readonly Types[],
+): abstract new () => HostNode & Handlers<Types> {
+  abstract class Handled extends HostNode {
+    static {
+      HostNode.handles(this.prototype, types);
+    }
+  }
+  return Handled as unknown as abstract new () => HostNode & Handlers<Types>;
+}

package/src/mediaQueries.ts

@@ -82,6 +82,8 @@ function nameAndValue(condition: string): [string, string | null] {
 }
 
 export class MediaQueryList extends HostNode {
+  /* Defined on the prototype by `HostNode.handles` below; declared here for the checker. */
+  declare onchange: ((event: Event) => unknown) | null;
   private last: boolean;
   constructor(
     readonly media: string,
@@ -112,10 +114,6 @@ export class MediaQueryList extends HostNode {
   }
 }
 
-export interface MediaQueryList {
-  onchange: ((event: Event) => unknown) | null;
-}
-
 export class MediaQueries {
   private readonly lists: MediaQueryList[] = [];
   private readonly unknown = new Set<string>();

package/src/page.ts

@@ -21,7 +21,7 @@
 
 import { UserActivation } from './activation.ts';
 import type { NativeCanvas } from './canvas.ts';
-import { type Handlers, HostNode } from './domTree.ts';
+import { HostNode, withHandlers } from './domTree.ts';
 import { installEventClasses } from './eventClasses.ts';
 import { PageFullscreen } from './fullscreen.ts';
 import { MediaQueries, type MediaQueryList } from './mediaQueries.ts';
@@ -38,7 +38,6 @@ export const INPUT_TYPES = [
   ...['touchstart', 'touchmove', 'touchend', 'touchcancel', 'fullscreenchange', 'fullscreenerror'],
 ] as const;
 
-type InputType = (typeof INPUT_TYPES)[number];
 const WINDOW_TYPES = ['resize', 'beforeunload', 'gamepadconnected', 'gamepaddisconnected'] as const;
 const DOCUMENT_TYPES = [
   'visibilitychange',
@@ -48,11 +47,7 @@ const DOCUMENT_TYPES = [
   'fullscreenerror',
 ] as const;
 
-/* The attributes `HostNode.handles` defines below, declared for the checker. */
-export interface PageWindow extends Handlers<InputType | (typeof WINDOW_TYPES)[number]> {}
-export interface PageDocument extends Handlers<InputType | (typeof DOCUMENT_TYPES)[number]> {}
-
-export class PageWindow extends HostNode {
+export class PageWindow extends withHandlers([...INPUT_TYPES, ...WINDOW_TYPES]) {
   canvas: NativeCanvas | null = null;
   /** Answered by the page, which knows what a query asks about (`mediaQueries.ts`). */
   matchMedia: (query: string) => MediaQueryList = () => {
@@ -67,12 +62,9 @@ export class PageWindow extends HostNode {
   get devicePixelRatio(): number {
     return this.canvas?.pixelRatio ?? 1;
   }
-  static {
-    HostNode.handles(PageWindow.prototype, [...INPUT_TYPES, ...WINDOW_TYPES]);
-  }
 }
 
-export class PageDocument extends HostNode {
+export class PageDocument extends withHandlers([...INPUT_TYPES, ...DOCUMENT_TYPES]) {
   visibilityState: DocumentVisibilityState = 'visible';
   pointerLockElement: Element | null = null;
   /** What is focused: the canvas, once it is focusable and asked, or nothing. */
@@ -112,10 +104,6 @@ export class PageDocument extends HostNode {
   createElement(tag: string): never {
     throw new Error(`[driftengine] the native host has no DOM to make a <${tag}> in`);
   }
-
-  static {
-    HostNode.handles(PageDocument.prototype, [...INPUT_TYPES, ...DOCUMENT_TYPES]);
-  }
 }
 
 export interface HostPageOptions {