@number10/phaserjsx 4.0.0 → 4.1.0

package/dist/clip/index.cjs

@@ -0,0 +1,696 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_chunk = require("../chunk-C2EiDwsr.cjs");
+let phaser = require("phaser");
+phaser = require_chunk.__toESM(phaser, 1);
+//#region src/clip/stencil-clip.ts
+/**
+* WebGL stencil-buffer clip for Phaser 4 Containers.
+*
+* Supports arbitrary nesting via the INCR/DECR model: each clip level
+* increments the stencil on enter and decrements on exit, so child clips are
+* automatically intersected with their parent clips at the hardware level.
+*
+* Shape variants:
+*   - Plain rectangle   (cornerRadius omitted or 0)
+*   - Rounded rectangle (uniform radius or per-corner object)
+*
+* A single SDF-based shader handles both variants.  For plain rectangles
+* u_radii is vec4(0) and the `discard` branch never fires — no overhead
+* compared to a rectangle-only shader.
+*
+* Transforms (translate, scale, rotation) are fully supported: the quad
+* corners are transformed through `container.getWorldTransformMatrix()` at
+* render time, so no per-layout world-position tracking is needed.
+*/
+/**
+* Shared depth counter per GL context.
+* Incremented before each clip's INCR pass, decremented after the DECR pass.
+* Reset to 0 at the start of every frame via a `prerender` hook.
+*/
+var _depthByGl = /* @__PURE__ */ new WeakMap();
+function getDepth(gl) {
+	let d = _depthByGl.get(gl);
+	if (!d) {
+		d = { value: 0 };
+		_depthByGl.set(gl, d);
+	}
+	return d;
+}
+var _prerenderHooked = /* @__PURE__ */ new WeakSet();
+/**
+* Registers a per-frame `prerender` listener that resets the depth counter.
+* Registered at most once per Phaser.Game instance.
+*/
+function ensurePrerenderReset(gl, game) {
+	if (_prerenderHooked.has(game)) return;
+	_prerenderHooked.add(game);
+	game.events.on("prerender", () => {
+		const d = _depthByGl.get(gl);
+		if (d) d.value = 0;
+		const fbo = _fboPatchByGl.get(gl);
+		if (fbo) {
+			fbo.current = null;
+			fbo.saved = null;
+		}
+	});
+}
+var _fboPatchByGl = /* @__PURE__ */ new WeakMap();
+/**
+* Patches `gl.bindFramebuffer` once per GL context so that the stencil test
+* is automatically disabled when Phaser switches to an off-screen FBO (for
+* PostFX / RenderTexture rendering) and restored when switching back.
+*
+* Without this, a PostFX child rendered inside a stencil-clipped container
+* would be invisible: the FBO's stencil buffer starts at 0 while the active
+* stencil test requires `EQUAL(myDepth + 1)`, causing every fragment to fail.
+*
+* The patch is installed once per GL context and remains active for the
+* lifetime of the renderer.  It is a no-op when no stencil clip is active.
+*/
+function ensureFboPatch(gl) {
+	if (_fboPatchByGl.has(gl)) return;
+	const state = {
+		current: null,
+		saved: null
+	};
+	_fboPatchByGl.set(gl, state);
+	const origBind = gl.bindFramebuffer.bind(gl);
+	gl.bindFramebuffer = (target, fb) => {
+		const wasMain = state.current === null;
+		const willBeMain = fb === null;
+		const enteringOffscreen = wasMain && !willBeMain;
+		const leavingOffscreen = !wasMain && willBeMain;
+		if (enteringOffscreen && gl.getParameter(gl.STENCIL_TEST)) {
+			state.saved = {
+				func: gl.getParameter(gl.STENCIL_FUNC),
+				ref: gl.getParameter(gl.STENCIL_REF),
+				valueMask: gl.getParameter(gl.STENCIL_VALUE_MASK),
+				fail: gl.getParameter(gl.STENCIL_FAIL),
+				zfail: gl.getParameter(gl.STENCIL_PASS_DEPTH_FAIL),
+				zpass: gl.getParameter(gl.STENCIL_PASS_DEPTH_PASS),
+				writeMask: gl.getParameter(gl.STENCIL_WRITEMASK)
+			};
+			gl.disable(gl.STENCIL_TEST);
+		}
+		origBind(target, fb);
+		state.current = fb;
+		if (leavingOffscreen && state.saved) {
+			gl.enable(gl.STENCIL_TEST);
+			gl.stencilFunc(state.saved.func, state.saved.ref, state.saved.valueMask);
+			gl.stencilOp(state.saved.fail, state.saved.zfail, state.saved.zpass);
+			gl.stencilMask(state.saved.writeMask);
+			state.saved = null;
+		}
+	};
+}
+/**
+* Vertex attributes:
+*   a_ndc  vec2 — NDC clip-space position (CPU-computed from world transform)
+*   a_loc  vec2 — position relative to the clip rect's center (for SDF)
+*
+* All four corners are pre-transformed on the CPU so the vertex shader is a
+* pure pass-through.  This correctly handles translation, scale, and rotation
+* without a matrix uniform.
+*/
+var ROUND_RECT_VERT_SRC = `
+attribute vec2 a_ndc;
+attribute vec2 a_loc;
+varying vec2 v_loc;
+void main(){gl_Position=vec4(a_ndc,0.,1.);v_loc=a_loc;}
+`;
+/**
+* SDF rounded-rectangle fragment shader.
+*
+* sdRoundedBox uses the IQ per-corner-radius technique:
+*   r.xy = p.x > 0 ? r.yz : r.xw   (right → tr/br, left → tl/bl)
+*   r.x  = p.y > 0 ? r.y  : r.x    (bottom or top within that pair)
+*
+* u_radii layout: (tl, tr, br, bl).
+*
+* For plain rectangles u_radii = vec4(0.0) and sdRoundedBox returns ≤ 0 for
+* all fragments inside the quad, so `discard` is never executed.
+*/
+var ROUND_RECT_FRAG_SRC = `
+precision mediump float;
+varying vec2 v_loc;
+uniform vec2 u_halfSize;
+uniform vec4 u_radii;
+float sdRoundedBox(vec2 p,vec2 b,vec4 r){
+  r.xy=p.x>0.?r.yz:r.xw;
+  r.x =p.y>0.?r.y :r.x;
+  vec2 q=abs(p)-b+r.x;
+  return length(max(q,0.))+min(max(q.x,q.y),0.)-r.x;
+}
+void main(){
+  if(sdRoundedBox(v_loc,u_halfSize,u_radii)>0.)discard;
+  gl_FragColor=vec4(0.);
+}
+`;
+var BITMAP_VERT_SRC = `
+attribute vec2 a_ndc;
+attribute vec2 a_uv;
+varying vec2 v_uv;
+void main(){gl_Position=vec4(a_ndc,0.,1.);v_uv=a_uv;}
+`;
+var BITMAP_FRAG_SRC = `
+precision mediump float;
+varying vec2 v_uv;
+uniform sampler2D u_texture;
+uniform float u_alphaThreshold;
+uniform float u_invertAlpha;
+void main(){
+  float a=texture2D(u_texture,v_uv).a;
+  bool keep=u_invertAlpha>0.5 ? a<u_alphaThreshold : a>=u_alphaThreshold;
+  if(!keep)discard;
+  gl_FragColor=vec4(0.);
+}
+`;
+var _roundRectProgByGl = /* @__PURE__ */ new WeakMap();
+var _bitmapProgByGl = /* @__PURE__ */ new WeakMap();
+/**
+* Returns (or lazily creates) the SDF stencil shader program for a GL context.
+* @param gl - The WebGL context.
+* @returns Compiled and linked WebGLProgram.
+*/
+function createProgram(gl, vertSrc, fragSrc) {
+	const vs = gl.createShader(gl.VERTEX_SHADER);
+	gl.shaderSource(vs, vertSrc);
+	gl.compileShader(vs);
+	const fs = gl.createShader(gl.FRAGMENT_SHADER);
+	gl.shaderSource(fs, fragSrc);
+	gl.compileShader(fs);
+	const prog = gl.createProgram();
+	gl.attachShader(prog, vs);
+	gl.attachShader(prog, fs);
+	gl.linkProgram(prog);
+	return prog;
+}
+function getRoundRectProg(gl) {
+	let prog = _roundRectProgByGl.get(gl);
+	if (prog) return prog;
+	prog = createProgram(gl, ROUND_RECT_VERT_SRC, ROUND_RECT_FRAG_SRC);
+	_roundRectProgByGl.set(gl, prog);
+	return prog;
+}
+function getBitmapProg(gl) {
+	let prog = _bitmapProgByGl.get(gl);
+	if (prog) return prog;
+	prog = createProgram(gl, BITMAP_VERT_SRC, BITMAP_FRAG_SRC);
+	_bitmapProgByGl.set(gl, prog);
+	return prog;
+}
+var _roundRectLocsByProg = /* @__PURE__ */ new WeakMap();
+var _bitmapLocsByProg = /* @__PURE__ */ new WeakMap();
+/**
+* Returns (or resolves and caches) the attribute/uniform locations for a program.
+* @param gl - The WebGL context.
+* @param prog - The shader program.
+* @returns Cached locations.
+*/
+function getRoundRectShaderLocs(gl, prog) {
+	let l = _roundRectLocsByProg.get(prog);
+	if (!l) {
+		l = {
+			ndc: gl.getAttribLocation(prog, "a_ndc"),
+			loc: gl.getAttribLocation(prog, "a_loc"),
+			halfSize: gl.getUniformLocation(prog, "u_halfSize"),
+			radii: gl.getUniformLocation(prog, "u_radii")
+		};
+		_roundRectLocsByProg.set(prog, l);
+	}
+	return l;
+}
+function getBitmapShaderLocs(gl, prog) {
+	let l = _bitmapLocsByProg.get(prog);
+	if (!l) {
+		l = {
+			ndc: gl.getAttribLocation(prog, "a_ndc"),
+			uv: gl.getAttribLocation(prog, "a_uv"),
+			texture: gl.getUniformLocation(prog, "u_texture"),
+			alphaThreshold: gl.getUniformLocation(prog, "u_alphaThreshold"),
+			invertAlpha: gl.getUniformLocation(prog, "u_invertAlpha")
+		};
+		_bitmapLocsByProg.set(prog, l);
+	}
+	return l;
+}
+/**
+* Resolves the `cornerRadius` field to `[tl, tr, br, bl]` order matching the
+* `u_radii` vec4 uniform layout.
+* @param r - Raw corner radius value from the clip shape.
+* @returns Tuple `[tl, tr, br, bl]`.
+*/
+function resolveRadii(r) {
+	if (!r) return [
+		0,
+		0,
+		0,
+		0
+	];
+	if (typeof r === "number") return [
+		r,
+		r,
+		r,
+		r
+	];
+	return [
+		r.tl ?? 0,
+		r.tr ?? 0,
+		r.br ?? 0,
+		r.bl ?? 0
+	];
+}
+/** Returns true when a source/update selects the bitmap mask renderer. */
+function isBitmapStencilClipSource(source) {
+	return source.kind === "bitmap";
+}
+function toRoundRectState(source) {
+	return {
+		kind: "roundRect",
+		width: source.width,
+		height: source.height,
+		offsetX: source.offsetX ?? 0,
+		offsetY: source.offsetY ?? 0,
+		radii: source.kind === "rect" ? [
+			0,
+			0,
+			0,
+			0
+		] : resolveRadii(source.cornerRadius)
+	};
+}
+function toBitmapState(source) {
+	return {
+		kind: "bitmap",
+		texture: source.texture,
+		frame: source.frame,
+		width: source.width,
+		height: source.height,
+		offsetX: source.offsetX ?? 0,
+		offsetY: source.offsetY ?? 0,
+		alphaThreshold: source.alphaThreshold ?? .5,
+		invertAlpha: source.invertAlpha ?? false
+	};
+}
+function toMaskState(source) {
+	return isBitmapStencilClipSource(source) ? toBitmapState(source) : toRoundRectState(source);
+}
+function mergeMaskState(current, update) {
+	if (isBitmapStencilClipSource(update)) {
+		if (current.kind !== "bitmap" || update.texture !== void 0) return toBitmapState(update);
+		return {
+			kind: "bitmap",
+			texture: current.texture,
+			frame: update.frame !== void 0 ? update.frame : current.frame,
+			width: update.width !== void 0 ? update.width : current.width,
+			height: update.height !== void 0 ? update.height : current.height,
+			offsetX: update.offsetX !== void 0 ? update.offsetX : current.offsetX,
+			offsetY: update.offsetY !== void 0 ? update.offsetY : current.offsetY,
+			alphaThreshold: update.alphaThreshold !== void 0 ? update.alphaThreshold : current.alphaThreshold,
+			invertAlpha: update.invertAlpha !== void 0 ? update.invertAlpha : current.invertAlpha
+		};
+	}
+	if (current.kind === "bitmap" && update.kind === void 0) {
+		const bitmapUpdate = update;
+		return {
+			kind: "bitmap",
+			texture: current.texture,
+			frame: bitmapUpdate.frame !== void 0 ? bitmapUpdate.frame : current.frame,
+			width: bitmapUpdate.width !== void 0 ? bitmapUpdate.width : current.width,
+			height: bitmapUpdate.height !== void 0 ? bitmapUpdate.height : current.height,
+			offsetX: bitmapUpdate.offsetX !== void 0 ? bitmapUpdate.offsetX : current.offsetX,
+			offsetY: bitmapUpdate.offsetY !== void 0 ? bitmapUpdate.offsetY : current.offsetY,
+			alphaThreshold: bitmapUpdate.alphaThreshold !== void 0 ? bitmapUpdate.alphaThreshold : current.alphaThreshold,
+			invertAlpha: bitmapUpdate.invertAlpha !== void 0 ? bitmapUpdate.invertAlpha : current.invertAlpha
+		};
+	}
+	if (current.kind === "bitmap") return toRoundRectState(update);
+	const roundUpdate = update;
+	return {
+		kind: "roundRect",
+		width: roundUpdate.width !== void 0 ? roundUpdate.width : current.width,
+		height: roundUpdate.height !== void 0 ? roundUpdate.height : current.height,
+		offsetX: roundUpdate.offsetX !== void 0 ? roundUpdate.offsetX : current.offsetX,
+		offsetY: roundUpdate.offsetY !== void 0 ? roundUpdate.offsetY : current.offsetY,
+		radii: roundUpdate.kind === "rect" ? [
+			0,
+			0,
+			0,
+			0
+		] : "cornerRadius" in roundUpdate ? resolveRadii(roundUpdate.cornerRadius) : current.radii
+	};
+}
+/** Stride in bytes: 4 floats × 4 bytes. */
+var STRIDE = 16;
+/**
+* Transforms the four clip-rect corners through the container's world matrix,
+* uploads them to the vertex buffer, and draws the quad into the stencil.
+*
+* Vertex buffer layout (16 floats / 4 vertices, TRIANGLE_FAN, TL→TR→BR→BL):
+*   [ndcX, ndcY, locX, locY] × 4
+*   where locX/Y is the position relative to the clip rect's center (for SDF).
+*
+* The three GL states tracked by Phaser's `WebGLGlobalWrapper`
+* (`CURRENT_PROGRAM`, `ARRAY_BUFFER_BINDING`, `VERTEX_ARRAY_BINDING`) are
+* saved and restored so its internal caches stay consistent.
+*
+* @param gl - The (VAO-polyfilled) WebGL context.
+* @param matrix - Container's current world transform matrix.
+* @param offsetX - Top-left X of the clip rect in local space.
+* @param offsetY - Top-left Y of the clip rect in local space.
+* @param w - Clip rect width in local units.
+* @param h - Clip rect height in local units.
+* @param logW - Logical game width (`renderer.width`).
+* @param logH - Logical game height (`renderer.height`).
+* @param radii - Per-corner radii tuple `[tl, tr, br, bl]`.
+* @param vertBuf - Persistent WebGLBuffer (64 bytes, DYNAMIC_DRAW).
+* @param verts - Reusable Float32Array(16) to avoid per-frame allocation.
+*/
+function drawRoundRectMaskShape(gl, matrix, offsetX, offsetY, w, h, logW, logH, radii, vertBuf, verts) {
+	const { a, b, c, d, tx, ty } = matrix;
+	const hw = w / 2;
+	const hh = h / 2;
+	const cx = offsetX + hw;
+	const cy = offsetY + hh;
+	const corners = [
+		[cx - hw, cy - hh],
+		[cx + hw, cy - hh],
+		[cx + hw, cy + hh],
+		[cx - hw, cy + hh]
+	];
+	for (let i = 0; i < 4; i++) {
+		const corner = corners[i];
+		const lx = corner[0];
+		const ly = corner[1];
+		const wx = a * lx + c * ly + tx;
+		const wy = b * lx + d * ly + ty;
+		verts[i * 4 + 0] = wx / logW * 2 - 1;
+		verts[i * 4 + 1] = 1 - wy / logH * 2;
+		verts[i * 4 + 2] = lx - cx;
+		verts[i * 4 + 3] = ly - cy;
+	}
+	const prevProg = gl.getParameter(gl.CURRENT_PROGRAM);
+	const prevBuf = gl.getParameter(gl.ARRAY_BUFFER_BINDING);
+	const prevVAO = gl.getParameter(34229);
+	gl.bindVertexArray(null);
+	gl.bindBuffer(gl.ARRAY_BUFFER, vertBuf);
+	gl.bufferSubData(gl.ARRAY_BUFFER, 0, verts);
+	const prog = getRoundRectProg(gl);
+	gl.useProgram(prog);
+	const locs = getRoundRectShaderLocs(gl, prog);
+	gl.enableVertexAttribArray(locs.ndc);
+	gl.vertexAttribPointer(locs.ndc, 2, gl.FLOAT, false, STRIDE, 0);
+	gl.enableVertexAttribArray(locs.loc);
+	gl.vertexAttribPointer(locs.loc, 2, gl.FLOAT, false, STRIDE, 8);
+	gl.uniform2f(locs.halfSize, hw, hh);
+	gl.uniform4f(locs.radii, radii[0], radii[1], radii[2], radii[3]);
+	gl.drawArrays(gl.TRIANGLE_FAN, 0, 4);
+	gl.disableVertexAttribArray(locs.ndc);
+	gl.disableVertexAttribArray(locs.loc);
+	gl.bindBuffer(gl.ARRAY_BUFFER, prevBuf);
+	gl.useProgram(prevProg);
+	gl.bindVertexArray(prevVAO);
+}
+function isTextureFrame(value) {
+	return typeof value === "object" && value !== null && "glTexture" in value && "u0" in value;
+}
+function resolveBitmapFrame(scene, source) {
+	const frame = isTextureFrame(source.texture) ? source.texture : typeof source.texture === "string" ? scene.textures.getFrame(source.texture, source.frame) : source.texture.get(source.frame);
+	if (!frame?.glTexture?.webGLTexture) return null;
+	return {
+		webGLTexture: frame.glTexture.webGLTexture,
+		width: source.width ?? frame.cutWidth ?? frame.realWidth,
+		height: source.height ?? frame.cutHeight ?? frame.realHeight,
+		u0: frame.u0,
+		v0: frame.v0,
+		u1: frame.u1,
+		v1: frame.v1
+	};
+}
+function drawBitmapMaskShape(gl, matrix, source, frameInfo, logW, logH, vertBuf, verts) {
+	const { a, b, c, d, tx, ty } = matrix;
+	const x0 = source.offsetX;
+	const y0 = source.offsetY;
+	const x1 = x0 + frameInfo.width;
+	const y1 = y0 + frameInfo.height;
+	const corners = [
+		[
+			x0,
+			y0,
+			frameInfo.u0,
+			frameInfo.v0
+		],
+		[
+			x1,
+			y0,
+			frameInfo.u1,
+			frameInfo.v0
+		],
+		[
+			x1,
+			y1,
+			frameInfo.u1,
+			frameInfo.v1
+		],
+		[
+			x0,
+			y1,
+			frameInfo.u0,
+			frameInfo.v1
+		]
+	];
+	for (let i = 0; i < 4; i++) {
+		const corner = corners[i];
+		const lx = corner[0];
+		const ly = corner[1];
+		const wx = a * lx + c * ly + tx;
+		const wy = b * lx + d * ly + ty;
+		verts[i * 4 + 0] = wx / logW * 2 - 1;
+		verts[i * 4 + 1] = 1 - wy / logH * 2;
+		verts[i * 4 + 2] = corner[2];
+		verts[i * 4 + 3] = corner[3];
+	}
+	const prevProg = gl.getParameter(gl.CURRENT_PROGRAM);
+	const prevBuf = gl.getParameter(gl.ARRAY_BUFFER_BINDING);
+	const prevVAO = gl.getParameter(34229);
+	const prevActiveTexture = gl.getParameter(gl.ACTIVE_TEXTURE);
+	gl.activeTexture(gl.TEXTURE0);
+	const prevTexture = gl.getParameter(gl.TEXTURE_BINDING_2D);
+	gl.bindVertexArray(null);
+	gl.bindBuffer(gl.ARRAY_BUFFER, vertBuf);
+	gl.bufferSubData(gl.ARRAY_BUFFER, 0, verts);
+	const prog = getBitmapProg(gl);
+	gl.useProgram(prog);
+	const locs = getBitmapShaderLocs(gl, prog);
+	gl.enableVertexAttribArray(locs.ndc);
+	gl.vertexAttribPointer(locs.ndc, 2, gl.FLOAT, false, STRIDE, 0);
+	gl.enableVertexAttribArray(locs.uv);
+	gl.vertexAttribPointer(locs.uv, 2, gl.FLOAT, false, STRIDE, 8);
+	gl.bindTexture(gl.TEXTURE_2D, frameInfo.webGLTexture);
+	gl.uniform1i(locs.texture, 0);
+	gl.uniform1f(locs.alphaThreshold, source.alphaThreshold);
+	gl.uniform1f(locs.invertAlpha, source.invertAlpha ? 1 : 0);
+	gl.drawArrays(gl.TRIANGLE_FAN, 0, 4);
+	gl.disableVertexAttribArray(locs.ndc);
+	gl.disableVertexAttribArray(locs.uv);
+	gl.bindTexture(gl.TEXTURE_2D, prevTexture);
+	gl.activeTexture(prevActiveTexture);
+	gl.bindBuffer(gl.ARRAY_BUFFER, prevBuf);
+	gl.useProgram(prevProg);
+	gl.bindVertexArray(prevVAO);
+}
+function drawMaskShape(gl, scene, matrix, source, logW, logH, vertBuf, verts) {
+	if (source.kind === "bitmap") {
+		const frameInfo = resolveBitmapFrame(scene, source);
+		if (!frameInfo) return;
+		drawBitmapMaskShape(gl, matrix, source, frameInfo, logW, logH, vertBuf, verts);
+		return;
+	}
+	drawRoundRectMaskShape(gl, matrix, source.offsetX, source.offsetY, source.width, source.height, logW, logH, source.radii, vertBuf, verts);
+}
+var STENCIL_HANDLE = Symbol("stencilClipHandle");
+/** Returns the active stencil clip handle attached to a container, if any. */
+function getStencilClipHandle(container) {
+	return container[STENCIL_HANDLE];
+}
+/** Removes any active stencil clip from a container. */
+function clearStencilClip(container) {
+	getStencilClipHandle(container)?.destroy();
+}
+/**
+* Applies a WebGL stencil-buffer clip to a Phaser 4 Container.
+*
+* The clip rectangle is expressed in the container's **local coordinate
+* space**.  `offsetX`/`offsetY` mark the top-left corner (default 0/0), so
+* a container whose visual area starts at its local origin can be clipped with
+* `applyStencilClip(container, { width, height })`.
+*
+* **Nesting** is handled transparently: each clip level occupies one stencil
+* value (0 = no clip, 1 = depth 0, 2 = depth 1, …).  Child clips are always
+* the intersection of their own shape and all ancestor shapes.
+*
+* **Transforms** (translate, scale, rotation) are re-evaluated from
+* `container.getWorldTransformMatrix()` on every frame, so animated or
+* scroll-driven containers clip correctly without any manual update call.
+*
+* If a stencil clip is already attached to the container, calling this
+* function again calls `handle.update(shape)` on the existing handle and
+* returns it.
+*
+* @param container - The container to clip.
+* @param source - Clip source in the container's local coordinate space.
+* @returns A handle to modify dimensions / corner radii or remove the clip.
+*/
+function applyStencilClip(container, source) {
+	const obj = container;
+	if (obj[STENCIL_HANDLE]) {
+		obj[STENCIL_HANDLE].update(source);
+		return obj[STENCIL_HANDLE];
+	}
+	if (container.scene.renderer.type !== phaser.WEBGL) return {
+		update() {},
+		destroy() {}
+	};
+	const gl = container.scene.renderer.gl;
+	ensurePrerenderReset(gl, container.scene.game);
+	ensureFboPatch(gl);
+	const vertBuf = gl.createBuffer();
+	gl.bindBuffer(gl.ARRAY_BUFFER, vertBuf);
+	gl.bufferData(gl.ARRAY_BUFFER, new Float32Array(16), gl.DYNAMIC_DRAW);
+	gl.bindBuffer(gl.ARRAY_BUFFER, null);
+	const verts = new Float32Array(16);
+	let maskSource = toMaskState(source);
+	let destroyed = false;
+	const wrapper = (webglRenderer, go, drawingContext, parentMatrix, renderStep = 0, displayList, displayListIndex) => {
+		const renderNext = () => {
+			go.renderWebGLStep(webglRenderer, go, drawingContext, parentMatrix, renderStep + 1, displayList, displayListIndex);
+		};
+		if (destroyed) {
+			renderNext();
+			return;
+		}
+		const matrix = container.getWorldTransformMatrix();
+		const rn = webglRenderer.renderNodes;
+		const depth = getDepth(gl);
+		const myDepth = depth.value++;
+		const logW = webglRenderer.width;
+		const logH = webglRenderer.height;
+		rn.finishBatch();
+		if (myDepth === 0) gl.enable(gl.STENCIL_TEST);
+		gl.colorMask(false, false, false, false);
+		gl.stencilMask(255);
+		gl.stencilFunc(gl.EQUAL, myDepth, 255);
+		gl.stencilOp(gl.KEEP, gl.KEEP, gl.INCR);
+		drawMaskShape(gl, container.scene, matrix, maskSource, logW, logH, vertBuf, verts);
+		gl.colorMask(true, true, true, true);
+		gl.stencilFunc(gl.EQUAL, myDepth + 1, 255);
+		gl.stencilOp(gl.KEEP, gl.KEEP, gl.KEEP);
+		gl.stencilMask(0);
+		renderNext();
+		rn.finishBatch();
+		gl.colorMask(false, false, false, false);
+		gl.stencilMask(255);
+		gl.stencilFunc(gl.EQUAL, myDepth + 1, 255);
+		gl.stencilOp(gl.KEEP, gl.KEEP, gl.DECR);
+		drawMaskShape(gl, container.scene, matrix, maskSource, logW, logH, vertBuf, verts);
+		gl.colorMask(true, true, true, true);
+		depth.value--;
+		if (myDepth === 0) {
+			gl.disable(gl.STENCIL_TEST);
+			gl.stencilMask(255);
+		} else {
+			gl.stencilFunc(gl.EQUAL, myDepth, 255);
+			gl.stencilOp(gl.KEEP, gl.KEEP, gl.KEEP);
+			gl.stencilMask(0);
+		}
+	};
+	const handle = {
+		update(s) {
+			maskSource = mergeMaskState(maskSource, s);
+		},
+		destroy() {
+			if (destroyed) return;
+			destroyed = true;
+			gl.deleteBuffer(vertBuf);
+			const index = obj._renderSteps.indexOf(wrapper);
+			if (index !== -1) obj._renderSteps.splice(index, 1);
+			delete obj[STENCIL_HANDLE];
+		}
+	};
+	obj.addRenderStep(wrapper, 0);
+	obj[STENCIL_HANDLE] = handle;
+	return handle;
+}
+//#endregion
+//#region src/clip/stencil-clip-extension.ts
+function addMethod(proto, methodName, fn) {
+	const hadOwn = Object.prototype.hasOwnProperty.call(proto, methodName);
+	const previous = proto[methodName];
+	if (!hadOwn) proto[methodName] = fn;
+	return { restore: () => {
+		if (!hadOwn) delete proto[methodName];
+		else proto[methodName] = previous;
+	} };
+}
+function wrapMethod(proto, methodName, wrapper) {
+	const original = proto[methodName];
+	if (typeof original !== "function") return { restore() {} };
+	const wrapped = function(...args) {
+		return wrapper(original, this, ...args);
+	};
+	proto[methodName] = wrapped;
+	return { restore: () => {
+		proto[methodName] = original;
+	} };
+}
+var installed = false;
+var restoreHandles = [];
+function canCreateStencilClipSource(source) {
+	if (source.kind === "bitmap") return source.texture !== void 0;
+	return source.width !== void 0 && source.height !== void 0;
+}
+/** Installs stencil clip helpers on Phaser.GameObjects.Container.prototype. */
+function installStencilClipExtension() {
+	if (installed) return;
+	installed = true;
+	const proto = phaser.GameObjects.Container.prototype;
+	restoreHandles.push(addMethod(proto, "setStencilClip", function(source) {
+		applyStencilClip(this, source);
+		return this;
+	}));
+	restoreHandles.push(addMethod(proto, "updateStencilClip", function(source) {
+		const handle = getStencilClipHandle(this);
+		if (handle) handle.update(source);
+		else if (canCreateStencilClipSource(source)) applyStencilClip(this, source);
+		return this;
+	}));
+	restoreHandles.push(addMethod(proto, "clearStencilClip", function() {
+		clearStencilClip(this);
+		return this;
+	}));
+	restoreHandles.push(addMethod(proto, "getStencilClipHandle", function() {
+		return getStencilClipHandle(this);
+	}));
+	restoreHandles.push(wrapMethod(proto, "destroy", (original, self, ...args) => {
+		clearStencilClip(self);
+		return original.apply(self, args);
+	}));
+}
+/** Restores Phaser prototypes to their previous state. Intended for tests/HMR. */
+function uninstallStencilClipExtension() {
+	for (const handle of [...restoreHandles].reverse()) handle.restore();
+	restoreHandles = [];
+	installed = false;
+}
+//#endregion
+//#region src/clip/index.ts
+installStencilClipExtension();
+//#endregion
+exports.applyStencilClip = applyStencilClip;
+exports.clearStencilClip = clearStencilClip;
+exports.getStencilClipHandle = getStencilClipHandle;
+exports.installStencilClipExtension = installStencilClipExtension;
+exports.isBitmapStencilClipSource = isBitmapStencilClipSource;
+exports.uninstallStencilClipExtension = uninstallStencilClipExtension;
+
+//# sourceMappingURL=index.cjs.map