@moku-labs/game 0.15.26 → 0.15.28

package/dist/{visual-kEC9nb-o.mjs → visual-ClVRMUAi.mjs}

@@ -259,13 +259,14 @@ const spriteDefaults = {
 const Transform = /*#__PURE__*/ component("Transform", transformDefaults);
 /**
 * One textured quad. `texture` is an asset key, resolved through the texture providers; a size
-* and a `fit` draw it into a box.
+* and a `fit` draw it into a box. `blend: "add"` or `"screen"` lays it over what is under it.
 */
 const Sprite = /*#__PURE__*/ component("Sprite", spriteDefaults);
 /**
 * A stretchable panel, sized in reference units, with its own alpha and tint. `debug: true` draws
 * the slice outline over it. `clip: true` masks the children of the entity to the panel box.
-* `hollow: true` draws its rim alone, never the centre cell.
+* `hollow: true` draws its rim alone, never the centre cell. `blend: "add"` or `"screen"` lays it over what is under
+* it.
 */
 const NineSlice = /*#__PURE__*/ component("NineSlice", {
 	texture: "",
@@ -1213,6 +1214,32 @@ function hollowOf(element, hollow) {
 	}
 	return element.hollowed === true ? { hollow: false } : {};
 }
+/** What an element that never blended spreads into its visual: no field at all. */
+const NO_BLEND = Object.freeze({});
+/** What an element that blended once spreads once its style no longer blends: the glow turned off. */
+const NORMAL_BLEND = Object.freeze({ blend: "normal" });
+/** What an element spreads while its style blends, one frozen object per mode. */
+const BLENDS = Object.freeze({
+	add: Object.freeze({ blend: "add" }),
+	screen: Object.freeze({ blend: "screen" })
+});
+/**
+* How an image or a nine-slice lays its pixels over what is under it: the style's blend while it
+* says one, `"normal"` once it did and no longer does (a live element is patched, so the old blend
+* would stay), and no field on an element that never blended, so a game's describe and saved
+* values stay as they were without it. Each answer is a frozen module constant: nothing is built.
+*
+* @param element - The element drawn with the sprite or the nine-slice.
+* @param blend - The style's `blend`.
+* @returns `{ blend }`, or nothing.
+*/
+function blendOf(element, blend) {
+	if (blend !== void 0) {
+		element.blended = true;
+		return BLENDS[blend];
+	}
+	return element.blended === true ? NORMAL_BLEND : NO_BLEND;
+}
 /**
 * The box a text wraps at: its laid-out width while it wraps at it, 0 once it fits again, so a
 * text that wrapped draws on one line, and no field on a text that never wrapped.
@@ -1230,7 +1257,8 @@ function boxOf(element) {
 /**
 * The visual component of an element: a sprite for an image or an icon, the text for a text (with
 * its laid-out width as the box a `"box"` style wraps at), the nine-slice of its style (outlined
-* when the style sets `debug`, its rim alone when it sets `hollow`), or a rounded rectangle, a triangle with `shape: "triangle"`, its
+* when the style sets `debug`, its rim alone when it sets `hollow`; the sprite and the nine-slice
+* blended by the style's `blend`), or a rounded rectangle, a triangle with `shape: "triangle"`, its
 * stroke dashed with `dash`, or an arc with `shape: "arc"`
 * over the `sweep` of its style, ended by its `cap`. A clipping element (`scroll`,
 * `overflow: "hidden"`) keeps the rectangle, which carries the clip; a text field's rectangle
@@ -1257,7 +1285,8 @@ function visualOf(element) {
 		},
 		width: rect.w,
 		height: rect.h,
-		fit: spriteFitOf(node.props)
+		fit: spriteFitOf(node.props),
+		...blendOf(element, style.blend)
 	})];
 	if (type === "text") {
 		const styleKey = typeof node.props.style === "string" ? node.props.style : "body";
@@ -1281,7 +1310,8 @@ function visualOf(element) {
 		tint,
 		debug: style.debug ?? false,
 		clip: type === "input",
-		...hollowOf(element, style.hollow)
+		...hollowOf(element, style.hollow),
+		...blendOf(element, style.blend)
 	})];
 	const filled = style.fill !== void 0 || style.stroke !== void 0;
 	const invisible = isContainer(type) && !filled;

package/dist/visual.d.mts

@@ -1,2 +1,2 @@
-import { a as VisualApp, c as VisualRenderer, d as VisualStart, f as VisualStep, h as VisualTolerance, i as CheckpointResult, l as VisualReport, m as VisualTestResult, n as runVisualTests, o as VisualOptions, p as VisualTest, r as defineVisualTest, s as VisualPage, t as parseVisualArgv, u as VisualSetup } from "./visual-DmDWJEzs.mjs";
+import { a as VisualApp, c as VisualRenderer, d as VisualStart, f as VisualStep, h as VisualTolerance, i as CheckpointResult, l as VisualReport, m as VisualTestResult, n as runVisualTests, o as VisualOptions, p as VisualTest, r as defineVisualTest, s as VisualPage, t as parseVisualArgv, u as VisualSetup } from "./visual-BMRHt4IB.mjs";
 export { type CheckpointResult, type VisualApp, type VisualOptions, type VisualPage, type VisualRenderer, type VisualReport, type VisualSetup, type VisualStart, type VisualStep, type VisualTest, type VisualTestResult, type VisualTolerance, defineVisualTest, parseVisualArgv, runVisualTests };

package/dist/visual.mjs

@@ -1,4 +1,4 @@
-import { n as read, t as sources } from "./sources-Dpc4NXvG.mjs";
+import { n as read, t as sources } from "./sources-ncFMQIus.mjs";
 import { n as commands, t as run } from "./run-DRcc2SKF.mjs";
 import path from "node:path";
 import { createBrandConsole } from "@moku-labs/common/cli";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@moku-labs/game",
-  "version": "0.15.26",
+  "version": "0.15.28",
   "description": "2D puzzle game engine on TypeScript and PixiJS, built on @moku-labs/core.",
   "type": "module",
   "sideEffects": [