@number10/phaserjsx 4.0.0 → 4.1.0

package/dist/hooks.d.ts

@@ -1,3 +1,4 @@
+import { BackgroundImage } from './components/backgroundImage';
 import { Signal } from '@preact/signals-core';
 import { BackgroundProps, LayoutProps, TransformProps } from './core-props';
 import { LayoutSize } from './layout/types';
@@ -144,23 +145,23 @@ export declare function useLayoutSize(ref: {
  */
 export declare function getLayoutProps(container: Phaser.GameObjects.Container | null | undefined): (LayoutProps & BackgroundProps & TransformProps) | undefined;
 /**
- * Utility function to get background graphics from a container
- * Returns the Graphics object used for backgroundColor, border, cornerRadius
+ * Utility function to get background object from a container
+ * Returns the Image object used for backgroundColor, border, cornerRadius
  * Useful for custom animations or modifications
  * @param container - Phaser container with background
- * @returns Graphics object or undefined if container has no background
+ * @returns Background image or undefined if container has no background
  */
-export declare function getBackgroundGraphics(container: Phaser.GameObjects.Container | null | undefined): Phaser.GameObjects.Graphics | undefined;
+export declare function getBackgroundGraphics(container: Phaser.GameObjects.Container | null | undefined): BackgroundImage | undefined;
 /**
- * Hook to get background graphics from a ref
- * Returns the Graphics object used for rendering the background
+ * Hook to get background image from a ref
+ * Returns the Image object used for rendering the background
  * Useful for animating background properties (tint, alpha, etc.)
  * @param ref - Ref to a Phaser container
- * @returns Graphics object or undefined
+ * @returns Background image or undefined
  */
 export declare function useBackgroundGraphics(ref: {
     current: Phaser.GameObjects.Container | null;
-}): Phaser.GameObjects.Graphics | undefined;
+}): BackgroundImage | undefined;
 /**
  * Utility function to get layout rectangle (position + size) from a container
  * Returns local position (x, y) combined with layout size

package/dist/hooks.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../src/hooks.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../src/hooks.ts"],"names":[],"mappings":"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"}

package/dist/index.cjs

@@ -1,8 +1,10 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_custom = require("./custom-BN31OAJq.cjs");
+const require_chunk = require("./chunk-C2EiDwsr.cjs");
+const require_custom = require("./custom-Dp3yAJdU.cjs");
 const require_jsx_runtime = require("./jsx-runtime.cjs");
+const require_clip_index = require("./clip/index.cjs");
 let phaser = require("phaser");
-phaser = require_custom.__toESM(phaser, 1);
+phaser = require_chunk.__toESM(phaser, 1);
 let _preact_signals_core = require("@preact/signals-core");
 //#region src/camera/use-camera-fx.ts
 /**
@@ -734,37 +736,95 @@ function useParticles(ref) {
 //#endregion
 //#region src/scene-backgrounds.ts
 var DEFAULT_LOGO_KEY = "phaser-jsx-logo";
+/**
+* Default scene background used when no explicit config is provided.
+*/
 var DEFAULT_BACKGROUND = {
 	type: "grid",
 	animation: "lemniscate",
 	opacity: .15,
 	color: 4890367
 };
+var sceneBackgroundTextureId = 0;
+function colorToCss(color) {
+	return `#${color.toString(16).padStart(6, "0")}`;
+}
+function createCanvasTexture(scene, width, height, draw) {
+	const textureKey = `__phaserjsx_scene_bg_${sceneBackgroundTextureId++}`;
+	const textureWidth = Math.max(1, Math.ceil(width));
+	const textureHeight = Math.max(1, Math.ceil(height));
+	const texture = scene.textures.createCanvas(textureKey, textureWidth, textureHeight);
+	if (!texture) throw new Error("Unable to create scene background texture");
+	const ctx = texture.getSourceImage().getContext("2d");
+	if (!ctx) throw new Error("Unable to create scene background canvas texture");
+	ctx.clearRect(0, 0, textureWidth, textureHeight);
+	draw(ctx, textureWidth, textureHeight);
+	texture.refresh();
+	return textureKey;
+}
+function removeTexture(scene, textureKey) {
+	if (textureKey && scene.textures.exists(textureKey)) scene.textures.remove(textureKey);
+}
+/**
+* Adds a decorative background object to a Phaser scene.
+*
+* The helper owns all game objects, tweens, resize listeners, and generated textures it creates.
+* It automatically cleans up on scene shutdown or destroy. Call `handle.destroy()` when removing
+* the background earlier.
+*
+* @param scene - Phaser scene that receives the background.
+* @param config - Background type, colors, opacity, animation, and optional logo texture key.
+* @returns A handle for manual resize and cleanup, or `null` when `config.type` is `'none'`.
+*
+* @example
+* ```ts
+* const handle = addSceneBackground(scene, {
+*   type: 'grid',
+*   animation: 'wave',
+*   color: 0x4a9eff,
+*   opacity: 0.12,
+* })
+*
+* // Later, if the background should be removed before scene shutdown:
+* handle?.destroy()
+* ```
+*/
 function addSceneBackground(scene, config = DEFAULT_BACKGROUND) {
 	const bgConfig = config ?? DEFAULT_BACKGROUND;
 	if (bgConfig.type === "none") return null;
 	let background;
 	let backgroundTween;
 	const particleTweens = [];
+	const textureKeys = /* @__PURE__ */ new Set();
 	let resizeFn;
 	let destroyed = false;
 	const createGridBackground = () => {
-		const graphics = scene.add.graphics();
 		const gridSize = 40;
 		const color = bgConfig.color ?? 4890367;
 		const opacity = bgConfig.opacity ?? .15;
-		const drawGrid = (offsetX, offsetY) => {
-			graphics.clear();
-			graphics.lineStyle(1, color, opacity);
-			const width = scene.scale.width;
-			const height = scene.scale.height;
-			for (let x = offsetX % gridSize; x < width; x += gridSize) graphics.lineBetween(x, 0, x, height);
-			for (let y = offsetY % gridSize; y < height; y += gridSize) graphics.lineBetween(0, y, width, y);
+		const textureKey = createCanvasTexture(scene, gridSize, gridSize, (ctx, width, height) => {
+			ctx.globalAlpha = opacity;
+			ctx.strokeStyle = colorToCss(color);
+			ctx.lineWidth = 1;
+			ctx.beginPath();
+			ctx.moveTo(.5, 0);
+			ctx.lineTo(.5, height);
+			ctx.moveTo(0, .5);
+			ctx.lineTo(width, .5);
+			ctx.stroke();
+		});
+		textureKeys.add(textureKey);
+		const tile = scene.add.tileSprite(0, 0, scene.scale.width, scene.scale.height, textureKey);
+		tile.setOrigin(0, 0);
+		const moveGrid = (offsetX, offsetY) => {
+			tile.tilePositionX = -offsetX;
+			tile.tilePositionY = -offsetY;
+		};
+		tile.__redrawFn = moveGrid;
+		background = tile;
+		resizeFn = (width, height) => {
+			tile.setSize(width, height);
 		};
-		drawGrid(0, 0);
-		graphics.__redrawFn = drawGrid;
-		background = graphics;
-		resizeFn = () => drawGrid(0, 0);
 	};
 	const createLogoBackground = () => {
 		const container = scene.add.container(scene.scale.width / 2, scene.scale.height / 2);
@@ -780,18 +840,31 @@ function addSceneBackground(scene, config = DEFAULT_BACKGROUND) {
 		};
 	};
 	const createGradientBackground = () => {
-		const graphics = scene.add.graphics();
 		const color1 = bgConfig.color ?? 4890367;
 		const color2 = bgConfig.colorSecondary ?? 7031551;
 		const opacity = bgConfig.opacity ?? .2;
-		const drawGradient = () => {
-			graphics.clear();
-			graphics.fillGradientStyle(color1, color1, color2, color2, opacity, opacity, opacity, opacity);
-			graphics.fillRect(0, 0, scene.scale.width, scene.scale.height);
+		const createGradientTexture = (width, height) => createCanvasTexture(scene, width, height, (ctx, textureWidth, textureHeight) => {
+			const gradient = ctx.createLinearGradient(0, 0, 0, textureHeight);
+			gradient.addColorStop(0, colorToCss(color1));
+			gradient.addColorStop(1, colorToCss(color2));
+			ctx.globalAlpha = opacity;
+			ctx.fillStyle = gradient;
+			ctx.fillRect(0, 0, textureWidth, textureHeight);
+		});
+		let textureKey = createGradientTexture(scene.scale.width, scene.scale.height);
+		textureKeys.add(textureKey);
+		const image = scene.add.image(0, 0, textureKey);
+		image.setOrigin(0, 0);
+		resizeFn = (width, height) => {
+			const previousTextureKey = textureKey;
+			textureKey = createGradientTexture(width, height);
+			textureKeys.add(textureKey);
+			image.setTexture(textureKey);
+			image.setDisplaySize(width, height);
+			textureKeys.delete(previousTextureKey);
+			removeTexture(scene, previousTextureKey);
 		};
-		drawGradient();
-		background = graphics;
-		resizeFn = drawGradient;
+		background = image;
 	};
 	const createParticlesBackground = () => {
 		const container = scene.add.container(0, 0);
@@ -848,6 +921,8 @@ function addSceneBackground(scene, config = DEFAULT_BACKGROUND) {
 		for (const tween of particleTweens) tween.stop();
 		background?.destroy();
 		background = void 0;
+		for (const textureKey of textureKeys) removeTexture(scene, textureKey);
+		textureKeys.clear();
 		scene.scale.off(phaser.Scale.Events.RESIZE, onResize);
 		scene.events.off(phaser.Scenes.Events.SHUTDOWN, cleanup);
 		scene.events.off(phaser.Scenes.Events.DESTROY, cleanup);
@@ -1481,10 +1556,12 @@ exports.applyDarkMode = require_custom.applyDarkMode;
 exports.applyEffectByName = require_custom.applyEffectByName;
 exports.applyFXByName = applyFXByName;
 exports.applyLightMode = require_custom.applyLightMode;
+exports.applyStencilClip = require_clip_index.applyStencilClip;
 exports.buildDeathZonesFromLayout = require_custom.buildDeathZonesFromLayout;
 exports.buildEmitZone = require_custom.buildEmitZone;
 exports.buildEmitZoneFromLayout = require_custom.buildEmitZoneFromLayout;
 exports.calculateSliderSize = require_custom.calculateSliderSize;
+exports.clearStencilClip = require_clip_index.clearStencilClip;
 exports.colorsToTheme = colorsToTheme;
 exports.computed = _preact_signals_core.computed;
 exports.createBlurFX = createBlurFX;
@@ -1551,6 +1628,7 @@ exports.getMountStats = require_custom.getMountStats;
 exports.getPreset = require_custom.getPreset;
 exports.getPresetWithMode = require_custom.getPresetWithMode;
 exports.getRenderContext = require_custom.getRenderContext;
+exports.getStencilClipHandle = require_clip_index.getStencilClipHandle;
 exports.getSurfaceColor = getSurfaceColor;
 exports.getTextColor = getTextColor;
 exports.getThemedProps = require_custom.getThemedProps;
@@ -1562,7 +1640,9 @@ exports.hexToNumber = require_custom.hexToNumber;
 exports.host = require_custom.host;
 exports.imageCreator = require_custom.imageCreator;
 exports.imagePatcher = require_custom.imagePatcher;
+exports.installStencilClipExtension = require_clip_index.installStencilClipExtension;
 exports.isAnimatedSignal = require_custom.isAnimatedSignal;
+exports.isBitmapStencilClipSource = require_clip_index.isBitmapStencilClipSource;
 exports.jsx = require_jsx_runtime.jsx;
 exports.jsxs = require_jsx_runtime.jsxs;
 exports.lighten = require_custom.lighten;
@@ -1613,6 +1693,7 @@ exports.textPatcher = require_custom.textPatcher;
 exports.themeRegistry = require_custom.themeRegistry;
 exports.tileSpriteCreator = require_custom.tileSpriteCreator;
 exports.tileSpritePatcher = require_custom.tileSpritePatcher;
+exports.uninstallStencilClipExtension = require_clip_index.uninstallStencilClipExtension;
 exports.unmount = require_custom.unmount;
 exports.unmountJSX = require_custom.unmountJSX;
 exports.unwrapSignal = require_custom.unwrapSignal;