lecodes-sdk 2.8.2 → 2.8.3

package/package.json

@@ -43,7 +43,7 @@
     "marcidb-embedded": "^0.18.0",
     "sharp": "^0.35.2"
   },
-  "version": "2.8.2",
+  "version": "2.8.3",
   "files": [
     "src",
     "dist",

package/src/bridges/tree.d.ts

@@ -267,14 +267,16 @@ export interface HostUI {
    *  dispatch bridge — `onComplete` with the result as ONE value, or with none.
    *  @immediate its callbacks and the borrowed `args` cannot wait for a commit */
   viewCall?(viewId: i32, method: string, args: value, onComplete: (result?: value) => void, onReject: (message: string) => void): void
-  /** A LAYER root is shown: a pass-through root the runtime lays out at the frame, above every
-   *  destination (the app layer) or over the presented surface (a scene's / a native view's / a
-   *  video's content layer). Its own box is never hit — only its children are — so a touch outside
-   *  them reaches what is under the layer; it is painted after the destination, layers in open
-   *  order. Its children are widgets (the runtime inserts them with insertNode, as under a screen
-   *  root): a widget child with an overlay layer (`overlayColor`, any color — "transparent" too)
-   *  intercepts every touch outside its own box within its root and reports it as the overlay tap. */
-  layerOpen(node: nodeid): void
+  /** A LAYER root is shown: a pass-through root the runtime lays out at the frame. `surface` false =
+   *  the app layer, above everything, screens included; true = the content layer of the presented
+   *  surface (a scene's / a native view's / a video's widgets): right over the surface and UNDER
+   *  every screen — a screen that covers the surface covers its widgets, the screen that leaves
+   *  when the surface is pushed stays over them until its drop. Its own box is never hit — only its
+   *  children are — so a touch outside them reaches what is under the layer; layers of a kind paint
+   *  in open order. Its children are widgets (the runtime inserts them with insertNode, as under a
+   *  screen root): a widget child with an overlay layer (`overlayColor`, any color — "transparent"
+   *  too) intercepts every touch outside its own box within its root and reports it as the overlay tap. */
+  layerOpen(node: nodeid, surface: boolean): void
   /** The layer root is hidden (its view stays; releaseNode says when it is gone). */
   layerClose(node: nodeid): void
   /** Load a font face for `fontFamily` (weight 100–900, style 0 normal / 2 italic) from `url`; settle

package/src/g2/Scene2D.ts

@@ -203,9 +203,12 @@ export class Scene2D implements Presentable {
     return _surfaceWidgets(this)
   }
   /** @internal presentation lifecycle from the runtime */
-  _emitOpen(): void { for (const cb of this.ol.slice()) cb() }
+  // The ACTIVE scene — what the pointer dispatch (g2/touch.ts) routes to — follows the runtime's
+  // presentation, not only open(): a Router.push / pop presents a scene without it, and the first
+  // push of a world had no active scene at all (every touch was dropped until an open() set one).
+  _emitOpen(): void { Scene2D._active = this; for (const cb of this.ol.slice()) cb() }
   /** @internal */
-  _emitClose(): void { for (const cb of this.cl.slice()) cb() }
+  _emitClose(): void { if (Scene2D._active === this) Scene2D._active = null; for (const cb of this.cl.slice()) cb() }
   /** @internal */
   _emitBack(): boolean {
     if (!this._backButtonCallback) return false

package/src/gl/Scene.ts

@@ -526,9 +526,15 @@ export class Scene implements Presentable {
     return _surfaceWidgets(this)
   }
   /** @internal presentation lifecycle from the runtime */
-  _emitOpen(): void { for (const cb of this.ol.slice()) cb() }
+  // The ACTIVE scene follows the runtime's presentation, not only open(): a Router.push / pop
+  // presents a scene without it (the 2D twin: Scene2D._emitOpen).
+  _emitOpen(): void { Scene._active = this; glState.activeScene = this; for (const cb of this.ol.slice()) cb() }
   /** @internal */
-  _emitClose(): void { for (const cb of this.cl.slice()) cb() }
+  _emitClose(): void {
+    if (Scene._active === this) Scene._active = null
+    if (glState.activeScene === this) glState.activeScene = null
+    for (const cb of this.cl.slice()) cb()
+  }
   /** @internal */
   _emitBack(): boolean {
     if (!this._backButtonCallback) return false

package/src/version.ts

@@ -4,7 +4,7 @@
 // same manifest). Its MAJOR is the bundle ↔ runtime contract: a bundle's `// sdk:` header line
 // and a host's embedded version must agree on the major for the host to run the bundle; minor
 // and patch never gate anything (features are detected, never versioned).
-export const SDK_VERSION = "2.8.2"
+export const SDK_VERSION = "2.8.3"
 
 /** The major of a semver string, or null when it is not one. */
 export const sdkMajor = (version: string | null | undefined): number | null => {