@number10/phaserjsx 4.0.0 → 4.2.0

package/README.md

@@ -27,6 +27,7 @@ The 4.x line uses Phaser 4 render steps, filters, and WebGL behavior and is not
 - 📱 **Responsive Design** - Flexible layout with multiple size value formats (px, %, vw/vh, fill, auto, calc)
 - 🔧 **Custom Components** - Easy to create and integrate custom components
 - 🎮 **Phaser Integration** - Seamless integration with Phaser 4 game objects and scenes
+- ✂️ **Stencil Clipping** - Native Phaser Container stencil clips with fast rounded rectangles and bitmap masks
 - 📊 **SVG Support** - Convert SVG to Phaser textures with caching
 - 🚀 **Performance** - Optimized VDOM reconciliation with smart dirty checking
 
@@ -97,6 +98,35 @@ const config: Phaser.Types.Core.GameConfig = {
 new Phaser.Game(config)
 ```
 
+## ✂️ Standalone Stencil Clip
+
+The stencil clip extension can be used directly with native Phaser Containers, with or without PhaserJSX components:
+
+```ts
+import '@number10/phaserjsx/clip'
+
+const panel = this.add.container(40, 40)
+
+panel.setStencilClip({
+  kind: 'roundRect',
+  width: 220,
+  height: 120,
+  cornerRadius: 16,
+})
+```
+
+Bitmap masks are also supported. They are evaluated as hard stencil masks using an alpha threshold:
+
+```ts
+panel.setStencilClip({
+  kind: 'bitmap',
+  texture: 'panel-mask',
+  width: 220,
+  height: 120,
+  alphaThreshold: 0.5,
+})
+```
+
 ## 📖 Documentation
 
 [📖 Full Documentation](https://michael--.github.io/phaserjsx/)

package/dist/chunk-C2EiDwsr.cjs

@@ -0,0 +1,35 @@
+//#region \0rolldown/runtime.js
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __commonJSMin = (cb, mod) => () => (mod || (cb((mod = { exports: {} }).exports, mod), cb = null), mod.exports);
+var __copyProps = (to, from, except, desc) => {
+	if (from && typeof from === "object" || typeof from === "function") for (var keys = __getOwnPropNames(from), i = 0, n = keys.length, key; i < n; i++) {
+		key = keys[i];
+		if (!__hasOwnProp.call(to, key) && key !== except) __defProp(to, key, {
+			get: ((k) => from[k]).bind(null, key),
+			enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+		});
+	}
+	return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", {
+	value: mod,
+	enumerable: true
+}) : target, mod));
+//#endregion
+Object.defineProperty(exports, "__commonJSMin", {
+	enumerable: true,
+	get: function() {
+		return __commonJSMin;
+	}
+});
+Object.defineProperty(exports, "__toESM", {
+	enumerable: true,
+	get: function() {
+		return __toESM;
+	}
+});

package/dist/clip/index.cjs

@@ -0,0 +1,8 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_clip = require("../clip-CHmjztBQ.cjs");
+exports.applyStencilClip = require_clip.applyStencilClip;
+exports.clearStencilClip = require_clip.clearStencilClip;
+exports.getStencilClipHandle = require_clip.getStencilClipHandle;
+exports.installStencilClipExtension = require_clip.installStencilClipExtension;
+exports.isBitmapStencilClipSource = require_clip.isBitmapStencilClipSource;
+exports.uninstallStencilClipExtension = require_clip.uninstallStencilClipExtension;

package/dist/clip/index.d.ts

@@ -0,0 +1,3 @@
+export * from './stencil-clip';
+export * from './stencil-clip-extension';
+//# sourceMappingURL=index.d.ts.map

package/dist/clip/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/clip/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAA;AAC9B,cAAc,0BAA0B,CAAA"}

package/dist/clip/index.js

@@ -0,0 +1,2 @@
+import { a as getStencilClipHandle, i as clearStencilClip, n as uninstallStencilClipExtension, o as isBitmapStencilClipSource, r as applyStencilClip, t as installStencilClipExtension } from "../clip-CPufWCSD.js";
+export { applyStencilClip, clearStencilClip, getStencilClipHandle, installStencilClipExtension, isBitmapStencilClipSource, uninstallStencilClipExtension };

package/dist/clip/stencil-clip-depth.d.ts

@@ -0,0 +1,10 @@
+import type * as Phaser from 'phaser';
+export declare function getDepth(gl: WebGLRenderingContext): {
+    value: number;
+};
+/**
+ * Registers a per-frame prerender listener that resets stencil clip state.
+ * Registered at most once per Phaser.Game instance.
+ */
+export declare function ensurePrerenderReset(gl: WebGLRenderingContext, game: Phaser.Game, resetFboState: (gl: WebGLRenderingContext) => void): void;
+//# sourceMappingURL=stencil-clip-depth.d.ts.map

package/dist/clip/stencil-clip-depth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stencil-clip-depth.d.ts","sourceRoot":"","sources":["../../src/clip/stencil-clip-depth.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,MAAM,QAAQ,CAAA;AAUrC,wBAAgB,QAAQ,CAAC,EAAE,EAAE,qBAAqB,GAAG;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,CAOrE;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,EAAE,EAAE,qBAAqB,EACzB,IAAI,EAAE,MAAM,CAAC,IAAI,EACjB,aAAa,EAAE,CAAC,EAAE,EAAE,qBAAqB,KAAK,IAAI,GACjD,IAAI,CAQN"}

package/dist/clip/stencil-clip-extension.d.ts

@@ -0,0 +1,18 @@
+import { StencilClipHandle, StencilClipSource, StencilClipUpdate } from './stencil-clip';
+/** Installs stencil clip helpers on Phaser.GameObjects.Container.prototype. */
+export declare function installStencilClipExtension(): void;
+/** Restores Phaser prototypes to their previous state. Intended for tests/HMR. */
+export declare function uninstallStencilClipExtension(): void;
+declare global {
+    namespace Phaser {
+        namespace GameObjects {
+            interface Container {
+                setStencilClip(source: StencilClipSource): this;
+                updateStencilClip(source: StencilClipUpdate): this;
+                clearStencilClip(): this;
+                getStencilClipHandle(): StencilClipHandle | undefined;
+            }
+        }
+    }
+}
+//# sourceMappingURL=stencil-clip-extension.d.ts.map

package/dist/clip/stencil-clip-extension.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stencil-clip-extension.d.ts","sourceRoot":"","sources":["../../src/clip/stencil-clip-extension.ts"],"names":[],"mappings":"AAEA,OAAO,EAIL,KAAK,iBAAiB,EACtB,KAAK,iBAAiB,EACtB,KAAK,iBAAiB,EACvB,MAAM,gBAAgB,CAAA;AAkEvB,+EAA+E;AAC/E,wBAAgB,2BAA2B,IAAI,IAAI,CAkDlD;AAED,kFAAkF;AAClF,wBAAgB,6BAA6B,IAAI,IAAI,CAIpD;AAED,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,MAAM,CAAC;QACf,UAAU,WAAW,CAAC;YACpB,UAAU,SAAS;gBACjB,cAAc,CAAC,MAAM,EAAE,iBAAiB,GAAG,IAAI,CAAA;gBAC/C,iBAAiB,CAAC,MAAM,EAAE,iBAAiB,GAAG,IAAI,CAAA;gBAClD,gBAAgB,IAAI,IAAI,CAAA;gBACxB,oBAAoB,IAAI,iBAAiB,GAAG,SAAS,CAAA;aACtD;SACF;KACF;CACF"}

package/dist/clip/stencil-clip-fbo-bridge.d.ts

@@ -0,0 +1,7 @@
+export declare function resetFboPatchState(gl: WebGLRenderingContext): void;
+/**
+ * Patches gl.bindFramebuffer once per GL context so that the stencil test is
+ * disabled while Phaser renders PostFX / RenderTextures into off-screen FBOs.
+ */
+export declare function ensureFboPatch(gl: WebGLRenderingContext): void;
+//# sourceMappingURL=stencil-clip-fbo-bridge.d.ts.map

package/dist/clip/stencil-clip-fbo-bridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stencil-clip-fbo-bridge.d.ts","sourceRoot":"","sources":["../../src/clip/stencil-clip-fbo-bridge.ts"],"names":[],"mappings":"AAuBA,wBAAgB,kBAAkB,CAAC,EAAE,EAAE,qBAAqB,GAAG,IAAI,CAMlE;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,EAAE,EAAE,qBAAqB,GAAG,IAAI,CAsC9D"}

package/dist/clip/stencil-clip-renderer.d.ts

@@ -0,0 +1,7 @@
+import { MaskState } from './stencil-clip-state';
+import type * as Phaser from 'phaser';
+export type GLPolyfilled = WebGLRenderingContext & {
+    bindVertexArray(vao: WebGLVertexArrayObject | null): void;
+};
+export declare function drawMaskShape(gl: GLPolyfilled, scene: Phaser.Scene, matrix: Phaser.GameObjects.Components.TransformMatrix, cameraMatrix: Phaser.GameObjects.Components.TransformMatrix | undefined, source: MaskState, logW: number, logH: number, vertBuf: WebGLBuffer, verts: Float32Array): void;
+//# sourceMappingURL=stencil-clip-renderer.d.ts.map

package/dist/clip/stencil-clip-renderer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stencil-clip-renderer.d.ts","sourceRoot":"","sources":["../../src/clip/stencil-clip-renderer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,MAAM,QAAQ,CAAA;AACrC,OAAO,KAAK,EAAmB,SAAS,EAAE,MAAM,sBAAsB,CAAA;AAGtE,MAAM,MAAM,YAAY,GAAG,qBAAqB,GAAG;IACjD,eAAe,CAAC,GAAG,EAAE,sBAAsB,GAAG,IAAI,GAAG,IAAI,CAAA;CAC1D,CAAA;AA4YD,wBAAgB,aAAa,CAC3B,EAAE,EAAE,YAAY,EAChB,KAAK,EAAE,MAAM,CAAC,KAAK,EACnB,MAAM,EAAE,MAAM,CAAC,WAAW,CAAC,UAAU,CAAC,eAAe,EACrD,YAAY,EAAE,MAAM,CAAC,WAAW,CAAC,UAAU,CAAC,eAAe,GAAG,SAAS,EACvE,MAAM,EAAE,SAAS,EACjB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,WAAW,EACpB,KAAK,EAAE,YAAY,GAClB,IAAI,CAkCN"}

package/dist/clip/stencil-clip-state.d.ts

@@ -0,0 +1,28 @@
+import { StencilBitmapClipSource, StencilBitmapTexture, StencilClipSource, StencilClipUpdate } from './stencil-clip-types';
+export type RoundRectMaskState = {
+    kind: 'roundRect';
+    width: number;
+    height: number;
+    offsetX: number;
+    offsetY: number;
+    radii: [number, number, number, number];
+};
+export type BitmapMaskState = {
+    kind: 'bitmap';
+    texture: StencilBitmapTexture;
+    frame: string | number | undefined;
+    width: number | undefined;
+    height: number | undefined;
+    offsetX: number;
+    offsetY: number;
+    alphaThreshold: number;
+    invertAlpha: boolean;
+};
+export type MaskState = RoundRectMaskState | BitmapMaskState;
+/** Returns true when a source/update selects the bitmap mask renderer. */
+export declare function isBitmapStencilClipSource(source: StencilClipUpdate): source is Partial<StencilBitmapClipSource> & {
+    kind: 'bitmap';
+};
+export declare function toMaskState(source: StencilClipSource): MaskState;
+export declare function mergeMaskState(current: MaskState, update: StencilClipUpdate): MaskState;
+//# sourceMappingURL=stencil-clip-state.d.ts.map

package/dist/clip/stencil-clip-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stencil-clip-state.d.ts","sourceRoot":"","sources":["../../src/clip/stencil-clip-state.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,uBAAuB,EACvB,oBAAoB,EACpB,iBAAiB,EACjB,iBAAiB,EAGlB,MAAM,sBAAsB,CAAA;AAE7B,MAAM,MAAM,kBAAkB,GAAG;IAC/B,IAAI,EAAE,WAAW,CAAA;IACjB,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,CAAA;IACd,OAAO,EAAE,MAAM,CAAA;IACf,OAAO,EAAE,MAAM,CAAA;IACf,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAA;CACxC,CAAA;AAED,MAAM,MAAM,eAAe,GAAG;IAC5B,IAAI,EAAE,QAAQ,CAAA;IACd,OAAO,EAAE,oBAAoB,CAAA;IAC7B,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAA;IAClC,KAAK,EAAE,MAAM,GAAG,SAAS,CAAA;IACzB,MAAM,EAAE,MAAM,GAAG,SAAS,CAAA;IAC1B,OAAO,EAAE,MAAM,CAAA;IACf,OAAO,EAAE,MAAM,CAAA;IACf,cAAc,EAAE,MAAM,CAAA;IACtB,WAAW,EAAE,OAAO,CAAA;CACrB,CAAA;AAED,MAAM,MAAM,SAAS,GAAG,kBAAkB,GAAG,eAAe,CAAA;AAU5D,0EAA0E;AAC1E,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,iBAAiB,GACxB,MAAM,IAAI,OAAO,CAAC,uBAAuB,CAAC,GAAG;IAAE,IAAI,EAAE,QAAQ,CAAA;CAAE,CAEjE;AA2BD,wBAAgB,WAAW,CAAC,MAAM,EAAE,iBAAiB,GAAG,SAAS,CAEhE;AAED,wBAAgB,cAAc,CAAC,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,iBAAiB,GAAG,SAAS,CAyDvF"}

package/dist/clip/stencil-clip-types.d.ts

@@ -0,0 +1,67 @@
+import type * as Phaser from 'phaser';
+/** Per-corner radius specification (values in local/CSS units). */
+export type StencilCornerRadius = {
+    tl?: number;
+    tr?: number;
+    bl?: number;
+    br?: number;
+};
+/** Describes a rounded-rectangle clip in the container's local coordinate space. */
+export interface StencilRoundRectClipSource {
+    /**
+     * Clip source kind.
+     * Omit for backwards-compatible `applyStencilClip(container, { width, height })` calls.
+     */
+    kind?: 'rect' | 'roundRect';
+    /** Width of the clip rect in local units. */
+    width: number;
+    /** Height of the clip rect in local units. */
+    height: number;
+    /** X coordinate of the top-left corner in local space. Defaults to 0. */
+    offsetX?: number;
+    /** Y coordinate of the top-left corner in local space. Defaults to 0. */
+    offsetY?: number;
+    /**
+     * Corner radii in local units.
+     * A single number applies to all four corners uniformly.
+     * An object sets each corner individually; missing corners default to 0.
+     */
+    cornerRadius?: number | StencilCornerRadius;
+}
+/** Backwards-compatible alias for the original rounded-rectangle shape API. */
+export type StencilClipShape = StencilRoundRectClipSource;
+/** Texture reference accepted by bitmap stencil clips. */
+export type StencilBitmapTexture = string | Phaser.Textures.Texture | Phaser.Textures.Frame;
+/** Describes a bitmap alpha clip in the container's local coordinate space. */
+export interface StencilBitmapClipSource {
+    /** Selects the texture-alpha mask renderer. */
+    kind: 'bitmap';
+    /** Texture key, Phaser texture, or Phaser frame to sample for mask alpha. */
+    texture: StencilBitmapTexture;
+    /** Optional frame name/index when `texture` is a key or Texture. */
+    frame?: string | number;
+    /** Width of the bitmap mask in local units. Defaults to the selected frame's pixel width. */
+    width?: number;
+    /** Height of the bitmap mask in local units. Defaults to the selected frame's pixel height. */
+    height?: number;
+    /** X coordinate of the top-left corner in local space. Defaults to 0. */
+    offsetX?: number;
+    /** Y coordinate of the top-left corner in local space. Defaults to 0. */
+    offsetY?: number;
+    /** Minimum sampled alpha required to write the stencil. Defaults to 0.5. */
+    alphaThreshold?: number;
+    /** Inverts the alpha test, clipping inside transparent pixels. Defaults to false. */
+    invertAlpha?: boolean;
+}
+/** Any mask source supported by the stencil clip renderer. */
+export type StencilClipSource = StencilRoundRectClipSource | StencilBitmapClipSource;
+/** Partial source updates accepted by an existing clip handle. */
+export type StencilClipUpdate = Partial<StencilRoundRectClipSource> | Partial<StencilBitmapClipSource> | StencilClipSource;
+/** Handle returned by applyStencilClip to update or remove the clip. */
+export interface StencilClipHandle {
+    /** Updates the clip source. Changes take effect on the next rendered frame. */
+    update(source: StencilClipUpdate): void;
+    /** Removes the clip and restores the container's original render step. */
+    destroy(): void;
+}
+//# sourceMappingURL=stencil-clip-types.d.ts.map

package/dist/clip/stencil-clip-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stencil-clip-types.d.ts","sourceRoot":"","sources":["../../src/clip/stencil-clip-types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,MAAM,QAAQ,CAAA;AAErC,mEAAmE;AACnE,MAAM,MAAM,mBAAmB,GAAG;IAChC,EAAE,CAAC,EAAE,MAAM,CAAA;IACX,EAAE,CAAC,EAAE,MAAM,CAAA;IACX,EAAE,CAAC,EAAE,MAAM,CAAA;IACX,EAAE,CAAC,EAAE,MAAM,CAAA;CACZ,CAAA;AAED,oFAAoF;AACpF,MAAM,WAAW,0BAA0B;IACzC;;;OAGG;IACH,IAAI,CAAC,EAAE,MAAM,GAAG,WAAW,CAAA;IAC3B,6CAA6C;IAC7C,KAAK,EAAE,MAAM,CAAA;IACb,8CAA8C;IAC9C,MAAM,EAAE,MAAM,CAAA;IACd,yEAAyE;IACzE,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,yEAAyE;IACzE,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB;;;;OAIG;IACH,YAAY,CAAC,EAAE,MAAM,GAAG,mBAAmB,CAAA;CAC5C;AAED,+EAA+E;AAC/E,MAAM,MAAM,gBAAgB,GAAG,0BAA0B,CAAA;AAEzD,0DAA0D;AAC1D,MAAM,MAAM,oBAAoB,GAAG,MAAM,GAAG,MAAM,CAAC,QAAQ,CAAC,OAAO,GAAG,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAA;AAE3F,+EAA+E;AAC/E,MAAM,WAAW,uBAAuB;IACtC,+CAA+C;IAC/C,IAAI,EAAE,QAAQ,CAAA;IACd,6EAA6E;IAC7E,OAAO,EAAE,oBAAoB,CAAA;IAC7B,oEAAoE;IACpE,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;IACvB,6FAA6F;IAC7F,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,+FAA+F;IAC/F,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,yEAAyE;IACzE,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,yEAAyE;IACzE,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,4EAA4E;IAC5E,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,qFAAqF;IACrF,WAAW,CAAC,EAAE,OAAO,CAAA;CACtB;AAED,8DAA8D;AAC9D,MAAM,MAAM,iBAAiB,GAAG,0BAA0B,GAAG,uBAAuB,CAAA;AAEpF,kEAAkE;AAClE,MAAM,MAAM,iBAAiB,GACzB,OAAO,CAAC,0BAA0B,CAAC,GACnC,OAAO,CAAC,uBAAuB,CAAC,GAChC,iBAAiB,CAAA;AAErB,wEAAwE;AACxE,MAAM,WAAW,iBAAiB;IAChC,+EAA+E;IAC/E,MAAM,CAAC,MAAM,EAAE,iBAAiB,GAAG,IAAI,CAAA;IACvC,0EAA0E;IAC1E,OAAO,IAAI,IAAI,CAAA;CAChB"}

package/dist/clip/stencil-clip.d.ts

@@ -1,3 +1,4 @@
+import { StencilClipHandle, StencilClipSource } from './stencil-clip-types';
 /**
  * WebGL stencil-buffer clip for Phaser 4 Containers.
  *
@@ -18,46 +19,12 @@
  * render time, so no per-layout world-position tracking is needed.
  */
 import * as Phaser from 'phaser';
-/** Per-corner radius specification (values in local/CSS units). */
-export type StencilCornerRadius = {
-    tl?: number;
-    tr?: number;
-    bl?: number;
-    br?: number;
-};
-/** Describes the clip rectangle in the container's local coordinate space. */
-export interface StencilClipShape {
-    /** Width of the clip rect in local units. */
-    width: number;
-    /** Height of the clip rect in local units. */
-    height: number;
-    /**
-     * X coordinate of the top-left corner in local space.
-     * Defaults to 0 (the container's local origin).
-     */
-    offsetX?: number;
-    /**
-     * Y coordinate of the top-left corner in local space.
-     * Defaults to 0 (the container's local origin).
-     */
-    offsetY?: number;
-    /**
-     * Corner radii in local units.
-     * A single number applies to all four corners uniformly.
-     * An object sets each corner individually; missing corners default to 0.
-     */
-    cornerRadius?: number | StencilCornerRadius;
-}
-/** Handle returned by {@link applyStencilClip} to update or remove the clip. */
-export interface StencilClipHandle {
-    /**
-     * Updates the clip shape.  Changes take effect on the next rendered frame.
-     * @param shape - Partial overrides merged with the current shape.
-     */
-    update(shape: Partial<StencilClipShape>): void;
-    /** Removes the clip and restores the container's original render step. */
-    destroy(): void;
-}
+export { isBitmapStencilClipSource } from './stencil-clip-state';
+export type { StencilBitmapClipSource, StencilBitmapTexture, StencilClipHandle, StencilClipShape, StencilClipSource, StencilClipUpdate, StencilCornerRadius, StencilRoundRectClipSource, } from './stencil-clip-types';
+/** Returns the active stencil clip handle attached to a container, if any. */
+export declare function getStencilClipHandle(container: Phaser.GameObjects.Container): StencilClipHandle | undefined;
+/** Removes any active stencil clip from a container. */
+export declare function clearStencilClip(container: Phaser.GameObjects.Container): void;
 /**
  * Applies a WebGL stencil-buffer clip to a Phaser 4 Container.
  *
@@ -79,8 +46,8 @@ export interface StencilClipHandle {
  * returns it.
  *
  * @param container - The container to clip.
- * @param shape - Clip rect geometry in local units.
+ * @param source - Clip source in the container's local coordinate space.
  * @returns A handle to modify dimensions / corner radii or remove the clip.
  */
-export declare function applyStencilClip(container: Phaser.GameObjects.Container, shape: StencilClipShape): StencilClipHandle;
+export declare function applyStencilClip(container: Phaser.GameObjects.Container, source: StencilClipSource): StencilClipHandle;
 //# sourceMappingURL=stencil-clip.d.ts.map

package/dist/clip/stencil-clip.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"stencil-clip.d.ts","sourceRoot":"","sources":["../../src/clip/stencil-clip.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AACH,OAAO,KAAK,MAAM,MAAM,QAAQ,CAAA;AAehC,mEAAmE;AACnE,MAAM,MAAM,mBAAmB,GAAG;IAChC,EAAE,CAAC,EAAE,MAAM,CAAA;IACX,EAAE,CAAC,EAAE,MAAM,CAAA;IACX,EAAE,CAAC,EAAE,MAAM,CAAA;IACX,EAAE,CAAC,EAAE,MAAM,CAAA;CACZ,CAAA;AAED,8EAA8E;AAC9E,MAAM,WAAW,gBAAgB;IAC/B,6CAA6C;IAC7C,KAAK,EAAE,MAAM,CAAA;IACb,8CAA8C;IAC9C,MAAM,EAAE,MAAM,CAAA;IACd;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB;;;;OAIG;IACH,YAAY,CAAC,EAAE,MAAM,GAAG,mBAAmB,CAAA;CAC5C;AAED,gFAAgF;AAChF,MAAM,WAAW,iBAAiB;IAChC;;;OAGG;IACH,MAAM,CAAC,KAAK,EAAE,OAAO,CAAC,gBAAgB,CAAC,GAAG,IAAI,CAAA;IAC9C,0EAA0E;IAC1E,OAAO,IAAI,IAAI,CAAA;CAChB;AAkWD;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,gBAAgB,CAC9B,SAAS,EAAE,MAAM,CAAC,WAAW,CAAC,SAAS,EACvC,KAAK,EAAE,gBAAgB,GACtB,iBAAiB,CAsKnB"}
+{"version":3,"file":"stencil-clip.d.ts","sourceRoot":"","sources":["../../src/clip/stencil-clip.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AACH,OAAO,KAAK,MAAM,MAAM,QAAQ,CAAA;AAKhC,OAAO,KAAK,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAA;AAEhF,OAAO,EAAE,yBAAyB,EAAE,MAAM,sBAAsB,CAAA;AAChE,YAAY,EACV,uBAAuB,EACvB,oBAAoB,EACpB,iBAAiB,EACjB,gBAAgB,EAChB,iBAAiB,EACjB,iBAAiB,EACjB,mBAAmB,EACnB,0BAA0B,GAC3B,MAAM,sBAAsB,CAAA;AA8B7B,8EAA8E;AAC9E,wBAAgB,oBAAoB,CAClC,SAAS,EAAE,MAAM,CAAC,WAAW,CAAC,SAAS,GACtC,iBAAiB,GAAG,SAAS,CAE/B;AAED,wDAAwD;AACxD,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,CAAC,WAAW,CAAC,SAAS,GAAG,IAAI,CAE9E;AAID;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,gBAAgB,CAC9B,SAAS,EAAE,MAAM,CAAC,WAAW,CAAC,SAAS,EACvC,MAAM,EAAE,iBAAiB,GACxB,iBAAiB,CAmJnB"}