@lightningjs/blits - npm Package Compare versions

Comparing version 1.21.1 to 1.22.0

CHANGELOG.md

 # Changelog
 
+## v1.22.0
+
+_3 mar 2025_
+
+- Added default value for `createImageBitmapSupport` to `auto`
+- Added advanced launch settings
+
 ## v1.21.1
@@ -4,0 +11,0 @@

docs/transitions_animations/transitions.md

@@ -131,3 +131,3 @@ # Transitions
 
-It is also possible to keep track of the entire progress of a transition. Every frametick during a transition (ideally once every 1.6ms), the renderer reports the progress of the transition. You can hook into this event by specifying a `progress` key on the transition configuration object, with a function to excute.
+It is also possible to keep track of the entire progress of a transition. Every frametick during a transition (ideally once every 16ms), the renderer reports the progress of the transition. You can hook into this event by specifying a `progress` key on the transition configuration object, with a function to excute.
 
@@ -134,0 +134,0 @@ This function is executed _every_ frametick, and receives the current progress and the previous progress as its arguments. The progress is indicated as a value between `0` and `1`, where 0 means start and 1 means finished.

index.d.ts

@@ -21,3 +21,3 @@ /*
 
-import {type ShaderEffect as RendererShaderEffect, type WebGlCoreShader} from '@lightningjs/renderer'
+import {type ShaderEffect as RendererShaderEffect, type WebGlCoreShader, type RendererMainSettings} from '@lightningjs/renderer'
 
@@ -828,3 +828,3 @@ declare module '@lightningjs/blits' {
        */
-      target?: 0.8,
+      target?: number,
       /**
@@ -835,3 +835,3 @@ * Interval at which regular texture cleanups occur (in `ms`)
        */
-      cleanupInterval?: 5000,
+      cleanupInterval?: number,
       /**
@@ -845,3 +845,3 @@ * Baseline GPU memory usage of the App (in `mb`), without rendering any
        */
-      baseline?: 25,
+      baseline?: number,
       /**
@@ -857,3 +857,3 @@ * Whether or not the max threshold should be considered
        */
-      strict?: false,
+      strict?: boolean,
     },
@@ -894,3 +894,10 @@ /**
      */
-    textureProcessingTimeLimit?: number
+    textureProcessingTimeLimit?: number,
+    /**
+     * Advanced renderer settings to override Blits launch settings, or configure
+     * settings that are not officially exposed in Blits yet
+     *
+     * @important if you dont know what you're doing here, you probably shouldn't be doing it!
+     */
+    advanced?: Partial<RendererMainSettings>
   }
@@ -897,0 +904,0 @@

package.json

 {
   "name": "@lightningjs/blits",
-  "version": "1.21.1",
+  "version": "1.22.0",
   "description": "Blits: The Lightning 3 App Development Framework",
@@ -5,0 +5,0 @@ "bin": "bin/index.js",

src/engines/L3/launch.js

@@ -69,24 +69,28 @@ /*
     {
-      appWidth: settings.w || 1920,
-      appHeight: settings.h || 1080,
-      fpsUpdateInterval: settings.fpsInterval || 1000,
-      devicePhysicalPixelRatio:
-        RENDER_QUALITIES[settings.renderQuality] || settings.renderQuality || 1,
-      deviceLogicalPixelRatio:
-        settings.pixelRatio ||
-        SCREEN_RESOLUTIONS[settings.screenResolution] ||
-        SCREEN_RESOLUTIONS[window.innerHeight] ||
-        1,
-      numImageWorkers:
-        'webWorkersLimit' in settings
-          ? settings.webWorkersLimit
-          : window.navigator.hardwareConcurrency || 2,
-      clearColor: (settings.canvasColor && colors.normalize(settings.canvasColor)) || 0x00000000,
-      inspector: settings.inspector === true ? Inspector : undefined,
-      boundsMargin: settings.viewportMargin || 0,
-      renderEngine: renderEngine(settings),
-      fontEngines: textRenderEngines(settings),
-      canvas: settings.canvas,
-      textureProcessingTimeLimit: settings.textureProcessingTimeLimit,
-      textureMemory: textureMemorySettings(settings),
+      ...{
+        appWidth: settings.w || 1920,
+        appHeight: settings.h || 1080,
+        fpsUpdateInterval: settings.fpsInterval || 1000,
+        devicePhysicalPixelRatio:
+          RENDER_QUALITIES[settings.renderQuality] || settings.renderQuality || 1,
+        deviceLogicalPixelRatio:
+          settings.pixelRatio ||
+          SCREEN_RESOLUTIONS[settings.screenResolution] ||
+          SCREEN_RESOLUTIONS[window.innerHeight] ||
+          1,
+        numImageWorkers:
+          'webWorkersLimit' in settings
+            ? settings.webWorkersLimit
+            : window.navigator.hardwareConcurrency || 2,
+        clearColor: (settings.canvasColor && colors.normalize(settings.canvasColor)) || 0x00000000,
+        inspector: settings.inspector === true ? Inspector : undefined,
+        boundsMargin: settings.viewportMargin || 0,
+        renderEngine: renderEngine(settings),
+        fontEngines: textRenderEngines(settings),
+        canvas: settings.canvas,
+        textureProcessingTimeLimit: settings.textureProcessingTimeLimit,
+        textureMemory: textureMemorySettings(settings),
+        createImageBitmapSupport: 'auto',
+      },
+      ...(settings.advanced || {}),
     },
@@ -93,0 +97,0 @@ target

No alert changes

Improved metrics

Total package byte prevSize

687739

0.09%

Lines of code

14558

0.08%

No dependency changes