@lightningjs/blits 1.50.0 → 1.51.0

package/CHANGELOG.md

@@ -1,5 +1,12 @@
 # Changelog
 
+## v1.51.0
+
+_04 mar 2026_
+
+- Fixed wrong message from being interrupted in announcer
+- Added `@loaded` and `@error` callbacks to Sprites
+
 ## v1.50.0
 
 _27 feb 2026_

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lightningjs/blits",
-  "version": "1.50.0",
+  "version": "1.51.0",
   "description": "Blits: The Lightning 3 App Development Framework",
   "bin": "bin/index.js",
   "exports": {

package/src/announcer/announcer.js

@@ -149,9 +149,11 @@ const processQueue = async () => {
           processQueue()
         })
         .catch((e) => {
-          currentId = null
-          currentResolveFn = null
-          isProcessing = false
+          if (id === currentId) {
+            currentId = null
+            currentResolveFn = null
+            isProcessing = false
+          }
           Log.debug(`Announcer - error ("${e.error}") while speaking: "${message}" (id: ${id})`)
           resolveFn(e.error)
           processQueue()

package/src/application.js

@@ -45,6 +45,9 @@ const Application = (config) => {
   let mouseListenersAdded = false
 
   config.hooks[symbols.destroy] = function () {
+    // Cancel pending key-hold timeout and reset hold state so focus is not left in hold mode after teardown
+    clearTimeout(holdTimeout)
+    Focus.hold = false
     document.removeEventListener('keydown', keyDownHandler)
     document.removeEventListener('keyup', keyUpHandler)
     if (mouseListenersAdded) {

package/src/components/Sprite.js

@@ -85,8 +85,7 @@ export default () =>
       ],
       context: {},
     },
-    props: ['image', 'map', 'frame', 'color', 'effects'],
-
+    props: ['image', 'map', 'frame', 'color', 'effects', '@loaded', '@error'],
     state() {
       return {
         spriteTexture: null,
@@ -94,6 +93,33 @@ export default () =>
       }
     },
 
+    hooks: {
+      ready() {
+        const loaded = this['@loaded']
+        if (loaded && typeof loaded === 'function') {
+          const cb = (payload) => loaded({ w: payload?.w, h: payload?.h }, this[symbols.wrapper])
+          this._loadedCb = cb
+          if (this.spriteTexture !== undefined && this.spriteTexture !== null) {
+            this.spriteTexture.on('loaded', cb)
+          }
+        }
+        const error = this['@error']
+        if (error && typeof error === 'function') {
+          const cb = (payload) => error(payload, this[symbols.wrapper])
+          this._failedCb = cb
+          if (this.spriteTexture !== undefined && this.spriteTexture !== null) {
+            this.spriteTexture.on('failed', cb)
+          }
+        }
+      },
+      destroy() {
+        if (this.spriteTexture !== undefined && this.spriteTexture !== null) {
+          if (this._loadedCb) this.spriteTexture.off('loaded', this._loadedCb)
+          if (this._failedCb) this.spriteTexture.off('failed', this._failedCb)
+        }
+      },
+    },
+
     computed: {
       texture() {
         // If no image - nothing to render
@@ -113,10 +139,17 @@ export default () =>
           this.spriteTexture === null ||
           this.currentSrc !== this.image
         ) {
+          const prevTexture = this.spriteTexture
+          if (prevTexture !== undefined && prevTexture !== null) {
+            if (this._loadedCb) prevTexture.off('loaded', this._loadedCb)
+            if (this._failedCb) prevTexture.off('failed', this._failedCb)
+          }
           this.spriteTexture = renderer.createTexture('ImageTexture', {
             src: this.image,
           })
           this.currentSrc = this.image
+          if (this._loadedCb) this.spriteTexture.on('loaded', this._loadedCb)
+          if (this._failedCb) this.spriteTexture.on('failed', this._failedCb)
         }
 
         // Resolve frame data from sprite map