@driftengine/script 4.3.0 → 4.4.1

package/README.md

@@ -3,7 +3,7 @@
 The `drift/*` capability bindings: what this engine provides to DriftScript, and **the only place the
 two are coupled**.
 
-**Cost: 36.9 KB gzipped on top of core.** Measured by `scripts/size-gate.test.mjs`, which fails if it
+**Cost: 37.3 KB gzipped on top of core.** Measured by `scripts/size-gate.test.mjs`, which fails if it
 drifts more than 3% — the number is derived from the same floors that gate asserts, so a README
 quoting a stale one is a red suite rather than a thing somebody notices.
 

package/capabilities.json

@@ -5887,6 +5887,32 @@
       "doc": "How much of the frame's bloom ceiling to take, 0 to 1. Held until changed. Does nothing when the quality profile's `bloom` is 0, because the chain is never built.",
       "implementation": "drift/render.bloom"
     },
+    {
+      "module": "drift/render",
+      "name": "bloomAbove",
+      "signature": "fn(renderer: Renderer, scale: f32, threshold: f32) -> void",
+      "params": [
+        {
+          "name": "renderer",
+          "type": "Renderer"
+        },
+        {
+          "name": "scale",
+          "type": "f32"
+        },
+        {
+          "name": "threshold",
+          "type": "f32"
+        }
+      ],
+      "returns": "void",
+      "effects": [
+        "scene.write"
+      ],
+      "deterministic": false,
+      "doc": "How much of the bloom ceiling to take, 0 to 1, and how bright a pixel must be before it blooms, in scene units, above 0. Both held until changed. The threshold is compared before exposure, so a script that moves `exposure` through a day moves this with it: pass the brightness wanted on screen over the exposure, or sunlit stone blooms at noon and lamps never do at night.",
+      "implementation": "drift/render.bloomAbove"
+    },
     {
       "module": "drift/render",
       "name": "exposure",

package/dist/bindings/render.d.ts

@@ -23,7 +23,7 @@ export declare const RENDER_MODULE = "drift/render";
  * from what the device can afford, and is clamped by `capabilityClamp` against what the adapter
  * actually reports; a script that wrote to one would be overruling a decision made about hardware
  * it cannot see, and two machines running the same script would draw different pictures for
- * reasons the script did not choose. So this module binds the seven dials and none of the ceilings.
+ * reasons the script did not choose. So this module binds the dials and none of the ceilings.
  *
  * ## Writes only, and the reason is the same one
  *

package/dist/bindings/render.js

@@ -23,7 +23,7 @@ export const RENDER_MODULE = 'drift/render';
  * from what the device can afford, and is clamped by `capabilityClamp` against what the adapter
  * actually reports; a script that wrote to one would be overruling a decision made about hardware
  * it cannot see, and two machines running the same script would draw different pictures for
- * reasons the script did not choose. So this module binds the seven dials and none of the ceilings.
+ * reasons the script did not choose. So this module binds the dials and none of the ceilings.
  *
  * ## Writes only, and the reason is the same one
  *
@@ -72,6 +72,11 @@ const R = { name: 'renderer', type: 'Renderer' };
 export const RENDER_CAPABILITIES = [
     define('bloom', [R, { name: 'scale', type: 'f32' }], "How much of the frame's bloom ceiling to take, 0 to 1. Held until changed. Does nothing " +
         "when the quality profile's `bloom` is 0, because the chain is never built."),
+    define('bloomAbove', [R, { name: 'scale', type: 'f32' }, { name: 'threshold', type: 'f32' }], 'How much of the bloom ceiling to take, 0 to 1, and how bright a pixel must be before it ' +
+        'blooms, in scene units, above 0. Both held until changed. The threshold is compared before ' +
+        'exposure, so a script that moves `exposure` through a day moves this with it: pass the ' +
+        'brightness wanted on screen over the exposure, or sunlit stone blooms at noon and lamps ' +
+        'never do at night.'),
     define('exposure', [R, { name: 'stops', type: 'f32' }], "How far this frame is scaled into the tone curve, above 0. Replaces the profile's " +
         '`outputExposure` for this frame onward. Adaptation is yours: a game knows it walked into a ' +
         'cave, and the renderer could only find out a frame late. Ignored unless the output ' +
@@ -133,6 +138,7 @@ export const RENDER_CAPABILITIES = [
 export function renderImplementation() {
     return {
         bloom: (renderer, scale) => renderer.setBloom(scale),
+        bloomAbove: (renderer, scale, threshold) => renderer.setBloom(scale, threshold),
         exposure: (renderer, stops) => renderer.setOutputExposure(stops),
         motionBlur: (renderer, scale) => renderer.setCameraMotionBlur(scale),
         speedBlur: (renderer, strength) => renderer.setSpeedRush(strength),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@driftengine/script",
-  "version": "4.3.0",
+  "version": "4.4.1",
   "description": "The drift/* capability bindings: what this engine provides to DriftScript, and the only place the two are coupled",
   "license": "Apache-2.0",
   "type": "module",
@@ -31,17 +31,17 @@
     "driftscript": "1.13.0"
   },
   "peerDependencies": {
-    "@driftengine/ai": "4.3.0",
-    "@driftengine/animation": "4.3.0",
-    "@driftengine/audio": "4.3.0",
-    "@driftengine/chemistry": "4.3.0",
-    "@driftengine/core": "4.3.0",
-    "@driftengine/editor": "4.3.0",
-    "@driftengine/entities": "4.3.0",
-    "@driftengine/network": "4.3.0",
-    "@driftengine/terrain": "4.3.0",
-    "@driftengine/ui2d": "4.3.0",
-    "@driftengine/xr": "4.3.0"
+    "@driftengine/ai": "4.4.1",
+    "@driftengine/animation": "4.4.1",
+    "@driftengine/audio": "4.4.1",
+    "@driftengine/chemistry": "4.4.1",
+    "@driftengine/core": "4.4.1",
+    "@driftengine/editor": "4.4.1",
+    "@driftengine/entities": "4.4.1",
+    "@driftengine/network": "4.4.1",
+    "@driftengine/terrain": "4.4.1",
+    "@driftengine/ui2d": "4.4.1",
+    "@driftengine/xr": "4.4.1"
   },
   "author": "Drift Technologies",
   "repository": {

package/src/bindings/render.ts

@@ -26,7 +26,7 @@ export const RENDER_MODULE = 'drift/render';
  * from what the device can afford, and is clamped by `capabilityClamp` against what the adapter
  * actually reports; a script that wrote to one would be overruling a decision made about hardware
  * it cannot see, and two machines running the same script would draw different pictures for
- * reasons the script did not choose. So this module binds the seven dials and none of the ceilings.
+ * reasons the script did not choose. So this module binds the dials and none of the ceilings.
  *
  * ## Writes only, and the reason is the same one
  *
@@ -87,6 +87,15 @@ export const RENDER_CAPABILITIES: readonly CapabilityDefinition[] = [
     "How much of the frame's bloom ceiling to take, 0 to 1. Held until changed. Does nothing " +
       "when the quality profile's `bloom` is 0, because the chain is never built.",
   ),
+  define(
+    'bloomAbove',
+    [R, { name: 'scale', type: 'f32' }, { name: 'threshold', type: 'f32' }],
+    'How much of the bloom ceiling to take, 0 to 1, and how bright a pixel must be before it ' +
+      'blooms, in scene units, above 0. Both held until changed. The threshold is compared before ' +
+      'exposure, so a script that moves `exposure` through a day moves this with it: pass the ' +
+      'brightness wanted on screen over the exposure, or sunlit stone blooms at noon and lamps ' +
+      'never do at night.',
+  ),
   define(
     'exposure',
     [R, { name: 'stops', type: 'f32' }],
@@ -173,6 +182,8 @@ export const RENDER_CAPABILITIES: readonly CapabilityDefinition[] = [
 export function renderImplementation(): Record<string, unknown> {
   return {
     bloom: (renderer: RendererApi, scale: number) => renderer.setBloom(scale),
+    bloomAbove: (renderer: RendererApi, scale: number, threshold: number) =>
+      renderer.setBloom(scale, threshold),
     exposure: (renderer: RendererApi, stops: number) => renderer.setOutputExposure(stops),
     motionBlur: (renderer: RendererApi, scale: number) => renderer.setCameraMotionBlur(scale),
     speedBlur: (renderer: RendererApi, strength: number) => renderer.setSpeedRush(strength),