@flighthq/scene2d 0.3.0-next.1220.6982c21 → 0.3.0-next.1248.f867198

package/dist/displayObject.d.ts

@@ -1,6 +1,6 @@
 import type { ClipRegion, Node2D, Node2DDataFactory, Node2DRuntime, Node2DRuntimeFactory, Kind, MethodsOf, NodeAny, PartialNode } from '@flighthq/types/contract';
 export declare function createNode2D<R extends Node2DRuntime>(kind: Kind, obj?: Readonly<PartialNode<Node2D>>, createData?: Node2DDataFactory, createNode2DRuntimeFactory?: Node2DRuntimeFactory<R>): Node2D;
-export declare function createNode2DRuntime(methods?: Readonly<Partial<MethodsOf<Node2DRuntime>>>): Node2DRuntime;
+export declare function createNode2DRuntime(methods?: Readonly<Partial<MethodsOf<Node2DRuntime> & Pick<Node2DRuntime, 'isLocalBoundsRectangleValid'>>>): Node2DRuntime;
 export declare function getNode2DRuntime(source: Readonly<Node2D>): Readonly<Node2DRuntime>;
 export declare function isNode2D(node: NodeAny): node is Node2D;
 export declare function setNode2DClip(source: Node2D, value: ClipRegion | null): void;

package/dist/displayObject.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"displayObject.d.ts","sourceRoot":"","sources":["../src/displayObject.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EACV,UAAU,EACV,MAAM,EACN,iBAAiB,EACjB,aAAa,EACb,oBAAoB,EACpB,IAAI,EACJ,SAAS,EACT,OAAO,EAEP,WAAW,EACZ,MAAM,0BAA0B,CAAC;AAGlC,wBAAgB,YAAY,CAAC,CAAC,SAAS,aAAa,EAClD,IAAI,EAAE,IAAI,EACV,GAAG,CAAC,EAAE,QAAQ,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,EACnC,UAAU,CAAC,EAAE,iBAAiB,EAC9B,0BAA0B,CAAC,EAAE,oBAAoB,CAAC,CAAC,CAAC,GACnD,MAAM,CAcR;AAED,wBAAgB,mBAAmB,CAAC,OAAO,CAAC,EAAE,QAAQ,CAAC,OAAO,CAAC,SAAS,CAAC,aAAa,CAAC,CAAC,CAAC,GAAG,aAAa,CAOxG;AAED,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,GAAG,QAAQ,CAAC,aAAa,CAAC,CAElF;AAED,wBAAgB,QAAQ,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,IAAI,MAAM,CAEtD;AAED,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,GAAG,IAAI,GAAG,IAAI,CAG5E;AAED,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC"}
+{"version":3,"file":"displayObject.d.ts","sourceRoot":"","sources":["../src/displayObject.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EACV,UAAU,EACV,MAAM,EACN,iBAAiB,EACjB,aAAa,EACb,oBAAoB,EACpB,IAAI,EACJ,SAAS,EACT,OAAO,EAEP,WAAW,EACZ,MAAM,0BAA0B,CAAC;AAGlC,wBAAgB,YAAY,CAAC,CAAC,SAAS,aAAa,EAClD,IAAI,EAAE,IAAI,EACV,GAAG,CAAC,EAAE,QAAQ,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,EACnC,UAAU,CAAC,EAAE,iBAAiB,EAC9B,0BAA0B,CAAC,EAAE,oBAAoB,CAAC,CAAC,CAAC,GACnD,MAAM,CAcR;AAED,wBAAgB,mBAAmB,CACjC,OAAO,CAAC,EAAE,QAAQ,CAAC,OAAO,CAAC,SAAS,CAAC,aAAa,CAAC,GAAG,IAAI,CAAC,aAAa,EAAE,6BAA6B,CAAC,CAAC,CAAC,GACzG,aAAa,CAOf;AAED,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,GAAG,QAAQ,CAAC,aAAa,CAAC,CAElF;AAED,wBAAgB,QAAQ,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,IAAI,MAAM,CAEtD;AAED,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,GAAG,IAAI,GAAG,IAAI,CAG5E;AAED,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/displayObject.js.map

@@ -1 +1 @@
-{"version":3,"file":"displayObject.js","sourceRoot":"","sources":["../src/displayObject.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,UAAU,EACV,iBAAiB,EACjB,cAAc,EACd,mBAAmB,EACnB,kBAAkB,EAClB,+BAA+B,EAC/B,wBAAwB,EACxB,aAAa,EACb,iBAAiB,EACjB,2BAA2B,EAC3B,oBAAoB,EACpB,wBAAwB,GACzB,MAAM,yBAAyB,CAAC;AAajC,OAAO,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAE3D,MAAM,UAAU,YAAY,CAC1B,IAAU,EACV,GAAmC,EACnC,UAA8B,EAC9B,0BAAoD;IAEpD,MAAM,GAAG,GAAG,UAAU,CACpB,IAAI,EACJ,GAAG,EACH,UAAU,EACV,0BAA0B,IAAK,mBAAwD,CAC9E,CAAC;IACZ,oBAAoB,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;IAC/B,wBAAwB,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;IACnC,mBAAmB,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;IAC9B,kBAAkB,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;IAC7B,iBAAiB,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;IAC5B,aAAa,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;IACxB,OAAO,GAAG,CAAC;AACb,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,OAAqD;IACvF,MAAM,GAAG,GAAG,iBAAiB,CAAC,OAAO,CAAkB,CAAC;IACxD,GAAG,CAAC,MAAM,GAAG,eAAe,CAAC;IAC7B,GAAG,CAAC,OAAO,GAAG,IAAI,CAAC;IACnB,2BAA2B,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;IAC1C,+BAA+B,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;IAC9C,OAAO,GAAG,CAAC;AACb,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,MAAwB;IACvD,OAAO,cAAc,CAAC,MAAM,CAAkB,CAAC;AACjD,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,IAAa;IACpC,OAAO,cAAc,CAAC,IAAI,CAAC,CAAC,MAAM,KAAK,eAAe,CAAC;AACzD,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,MAAc,EAAE,KAAwB;IACpE,MAAM,CAAC,IAAI,GAAG,KAAK,CAAC;IACpB,wBAAwB,CAAC,MAAM,CAAC,CAAC;AACnC,CAAC;AAED,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC"}
+{"version":3,"file":"displayObject.js","sourceRoot":"","sources":["../src/displayObject.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,UAAU,EACV,iBAAiB,EACjB,cAAc,EACd,mBAAmB,EACnB,kBAAkB,EAClB,+BAA+B,EAC/B,wBAAwB,EACxB,aAAa,EACb,iBAAiB,EACjB,2BAA2B,EAC3B,oBAAoB,EACpB,wBAAwB,GACzB,MAAM,yBAAyB,CAAC;AAajC,OAAO,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAE3D,MAAM,UAAU,YAAY,CAC1B,IAAU,EACV,GAAmC,EACnC,UAA8B,EAC9B,0BAAoD;IAEpD,MAAM,GAAG,GAAG,UAAU,CACpB,IAAI,EACJ,GAAG,EACH,UAAU,EACV,0BAA0B,IAAK,mBAAwD,CAC9E,CAAC;IACZ,oBAAoB,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;IAC/B,wBAAwB,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;IACnC,mBAAmB,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;IAC9B,kBAAkB,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;IAC7B,iBAAiB,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;IAC5B,aAAa,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;IACxB,OAAO,GAAG,CAAC;AACb,CAAC;AAED,MAAM,UAAU,mBAAmB,CACjC,OAA0G;IAE1G,MAAM,GAAG,GAAG,iBAAiB,CAAC,OAAO,CAAkB,CAAC;IACxD,GAAG,CAAC,MAAM,GAAG,eAAe,CAAC;IAC7B,GAAG,CAAC,OAAO,GAAG,IAAI,CAAC;IACnB,2BAA2B,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;IAC1C,+BAA+B,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;IAC9C,OAAO,GAAG,CAAC;AACb,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,MAAwB;IACvD,OAAO,cAAc,CAAC,MAAM,CAAkB,CAAC;AACjD,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,IAAa;IACpC,OAAO,cAAc,CAAC,IAAI,CAAC,CAAC,MAAM,KAAK,eAAe,CAAC;AACzD,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,MAAc,EAAE,KAAwB;IACpE,MAAM,CAAC,IAAI,GAAG,KAAK,CAAC;IACpB,wBAAwB,CAAC,MAAM,CAAC,CAAC;AACnC,CAAC;AAED,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/index.d.ts

@@ -1,2 +1,2 @@
-export { applyAnimationClipToNode2D, cloneSprite, computeSpriteLocalBoundsRectangle, computeHtmlViewLocalBoundsRectangle, createSprite, createDisplayObject, createHtmlView, createNode2D, createScene2D, enableScene2DSignals, getScene2DRoot, getScene2DSignals, isNode2D, setSpriteTexture, setHtmlViewSize, setNode2DClip, setScene2DSize, } from './contract';
+export { applyAnimationClipToNode2D, cloneSprite, computeSpriteLocalBoundsRectangle, computeHtmlViewLocalBoundsRectangle, createSprite, createDisplayObject, createHtmlView, createNode2D, createScene2D, enableScene2DSignals, getScene2DRoot, getScene2DSignals, isNode2D, setHtmlViewSize, setNode2DClip, setScene2DSize, } from './contract';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,0BAA0B,EAC1B,WAAW,EACX,iCAAiC,EACjC,mCAAmC,EACnC,YAAY,EACZ,mBAAmB,EACnB,cAAc,EACd,YAAY,EACZ,aAAa,EACb,oBAAoB,EACpB,cAAc,EACd,iBAAiB,EACjB,QAAQ,EACR,gBAAgB,EAChB,eAAe,EACf,aAAa,EACb,cAAc,GACf,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,0BAA0B,EAC1B,WAAW,EACX,iCAAiC,EACjC,mCAAmC,EACnC,YAAY,EACZ,mBAAmB,EACnB,cAAc,EACd,YAAY,EACZ,aAAa,EACb,oBAAoB,EACpB,cAAc,EACd,iBAAiB,EACjB,QAAQ,EACR,eAAe,EACf,aAAa,EACb,cAAc,GACf,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -1,2 +1,2 @@
-export { applyAnimationClipToNode2D, cloneSprite, computeSpriteLocalBoundsRectangle, computeHtmlViewLocalBoundsRectangle, createSprite, createDisplayObject, createHtmlView, createNode2D, createScene2D, enableScene2DSignals, getScene2DRoot, getScene2DSignals, isNode2D, setSpriteTexture, setHtmlViewSize, setNode2DClip, setScene2DSize, } from './contract';
+export { applyAnimationClipToNode2D, cloneSprite, computeSpriteLocalBoundsRectangle, computeHtmlViewLocalBoundsRectangle, createSprite, createDisplayObject, createHtmlView, createNode2D, createScene2D, enableScene2DSignals, getScene2DRoot, getScene2DSignals, isNode2D, setHtmlViewSize, setNode2DClip, setScene2DSize, } from './contract';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,0BAA0B,EAC1B,WAAW,EACX,iCAAiC,EACjC,mCAAmC,EACnC,YAAY,EACZ,mBAAmB,EACnB,cAAc,EACd,YAAY,EACZ,aAAa,EACb,oBAAoB,EACpB,cAAc,EACd,iBAAiB,EACjB,QAAQ,EACR,gBAAgB,EAChB,eAAe,EACf,aAAa,EACb,cAAc,GACf,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,0BAA0B,EAC1B,WAAW,EACX,iCAAiC,EACjC,mCAAmC,EACnC,YAAY,EACZ,mBAAmB,EACnB,cAAc,EACd,YAAY,EACZ,aAAa,EACb,oBAAoB,EACpB,cAAc,EACd,iBAAiB,EACjB,QAAQ,EACR,eAAe,EACf,aAAa,EACb,cAAc,GACf,MAAM,YAAY,CAAC"}

package/dist/sprite.d.ts

@@ -1,9 +1,10 @@
-import type { Node, PartialNode, Rectangle, Sprite, SpriteData, SpriteRuntime } from '@flighthq/types/contract';
+import type { Node, PartialNode, Rectangle, Renderable, RendererData, RenderState, Sprite, SpriteData, SpriteRuntime } from '@flighthq/types/contract';
 export declare function cloneSprite(source: Readonly<Sprite>): Sprite;
 export declare function computeSpriteLocalBoundsRectangle(out: Rectangle, source: Readonly<Node>): void;
 export declare function createSprite(obj?: Readonly<PartialNode<Sprite>>): Sprite;
 export declare function createSpriteData(data?: Readonly<Partial<SpriteData>>): SpriteData;
+export declare function createSpriteRendererData(_state: RenderState, source: Renderable): RendererData;
 export declare function createSpriteRuntime(): SpriteRuntime;
 export declare function getSpriteRuntime(source: Readonly<Sprite>): Readonly<SpriteRuntime>;
-export declare function setSpriteTexture(source: Sprite, value: SpriteData['texture']): void;
+export declare function isSpriteRendererDirty(_state: RenderState, source: Renderable, rendererData: RendererData | null): boolean;
 //# sourceMappingURL=sprite.d.ts.map

package/dist/sprite.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sprite.d.ts","sourceRoot":"","sources":["../src/sprite.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAEV,IAAI,EACJ,WAAW,EACX,SAAS,EACT,MAAM,EACN,UAAU,EACV,aAAa,EACd,MAAM,0BAA0B,CAAC;AAKlC,wBAAgB,WAAW,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,GAAG,MAAM,CAE5D;AAED,wBAAgB,iCAAiC,CAAC,GAAG,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,CAAC,IAAI,CAAC,GAAG,IAAI,CAI9F;AAED,wBAAgB,YAAY,CAAC,GAAG,CAAC,EAAE,QAAQ,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,GAAG,MAAM,CAExE;AAED,wBAAgB,gBAAgB,CAAC,IAAI,CAAC,EAAE,QAAQ,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,GAAG,UAAU,CAIjF;AAED,wBAAgB,mBAAmB,IAAI,aAAa,CAEnD;AAED,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,GAAG,QAAQ,CAAC,aAAa,CAAC,CAElF;AAED,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,CAAC,SAAS,CAAC,GAAG,IAAI,CAInF"}
+{"version":3,"file":"sprite.d.ts","sourceRoot":"","sources":["../src/sprite.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAEV,IAAI,EACJ,WAAW,EACX,SAAS,EACT,UAAU,EACV,YAAY,EACZ,WAAW,EACX,MAAM,EACN,UAAU,EACV,aAAa,EAEd,MAAM,0BAA0B,CAAC;AAKlC,wBAAgB,WAAW,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,GAAG,MAAM,CAE5D;AAED,wBAAgB,iCAAiC,CAAC,GAAG,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,CAAC,IAAI,CAAC,GAAG,IAAI,CAQ9F;AAED,wBAAgB,YAAY,CAAC,GAAG,CAAC,EAAE,QAAQ,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,GAAG,MAAM,CAExE;AAED,wBAAgB,gBAAgB,CAAC,IAAI,CAAC,EAAE,QAAQ,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,GAAG,UAAU,CAIjF;AAID,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,UAAU,GAAG,YAAY,CAG9F;AAED,wBAAgB,mBAAmB,IAAI,aAAa,CAKnD;AAED,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,GAAG,QAAQ,CAAC,aAAa,CAAC,CAElF;AAID,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,WAAW,EACnB,MAAM,EAAE,UAAU,EAClB,YAAY,EAAE,YAAY,GAAG,IAAI,GAChC,OAAO,CAST"}

package/dist/sprite.js

@@ -1,4 +1,4 @@
-import { invalidateNodeLocalBounds, invalidateNodeLocalContent } from '@flighthq/node/contract';
+import { createEntity } from '@flighthq/entity/contract';
 import { getTextureHeight, getTextureWidth } from '@flighthq/texture/contract';
 import { SpriteKind } from '@flighthq/types/contract';
 import { createNode2D, createNode2DRuntime, getNode2DRuntime } from './displayObject';
@@ -6,9 +6,13 @@ export function cloneSprite(source) {
     return createSprite({ data: { texture: source.data.texture } });
 }
 export function computeSpriteLocalBoundsRectangle(out, source) {
-    const texture = source.data.texture;
+    const sprite = source;
+    const texture = sprite.data.texture;
     out.width = texture === null ? 0 : Math.max(0, getTextureWidth(texture)) * Math.abs(texture.uvScale.x);
     out.height = texture === null ? 0 : Math.max(0, getTextureHeight(texture)) * Math.abs(texture.uvScale.y);
+    const runtime = getNode2DRuntime(sprite);
+    runtime.localBoundsTexture = texture;
+    runtime.localBoundsTextureVersion = texture?.version ?? -1;
 }
 export function createSprite(obj) {
     return createNode2D(SpriteKind, obj, createSpriteData, createSpriteRuntime);
@@ -18,18 +22,42 @@ export function createSpriteData(data) {
         texture: data?.texture ?? null,
     };
 }
+// Creates the per-state identity stamp used by a Sprite renderer's optional dirty hook. The data is
+// attached to that state's render proxy, so separate render pipelines compare independently.
+export function createSpriteRendererData(_state, source) {
+    const texture = source.data.texture;
+    return createEntity({ textureIdentity: texture, textureVersion: texture?.version ?? -1 });
+}
 export function createSpriteRuntime() {
-    return createNode2DRuntime(defaultMethods);
+    const runtime = createNode2DRuntime(defaultMethods);
+    runtime.localBoundsTexture = null;
+    runtime.localBoundsTextureVersion = -1;
+    return runtime;
 }
 export function getSpriteRuntime(source) {
     return getNode2DRuntime(source);
 }
-export function setSpriteTexture(source, value) {
-    source.data.texture = value;
-    invalidateNodeLocalContent(source);
-    invalidateNodeLocalBounds(source);
+// Detects Texture identity/version changes before requiresInvalidation can skip a Sprite. Each
+// backend opts into this through its registered renderer; the generic walk never knows SpriteKind.
+export function isSpriteRendererDirty(_state, source, rendererData) {
+    if (rendererData === null)
+        return false;
+    const data = rendererData;
+    const texture = source.data.texture;
+    const version = texture?.version ?? -1;
+    const dirty = data.textureIdentity !== texture || data.textureVersion !== version;
+    data.textureIdentity = texture;
+    data.textureVersion = version;
+    return dirty;
+}
+function isSpriteLocalBoundsRectangleValid(source) {
+    const sprite = source;
+    const runtime = getNode2DRuntime(sprite);
+    const texture = sprite.data.texture;
+    return runtime.localBoundsTexture === texture && runtime.localBoundsTextureVersion === (texture?.version ?? -1);
 }
 const defaultMethods = {
     computeLocalBoundsRectangle: computeSpriteLocalBoundsRectangle,
+    isLocalBoundsRectangleValid: isSpriteLocalBoundsRectangleValid,
 };
 //# sourceMappingURL=sprite.js.map

package/dist/sprite.js.map

@@ -1 +1 @@
-{"version":3,"file":"sprite.js","sourceRoot":"","sources":["../src/sprite.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yBAAyB,EAAE,0BAA0B,EAAE,MAAM,yBAAyB,CAAC;AAChG,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAU/E,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAEtD,OAAO,EAAE,YAAY,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAEtF,MAAM,UAAU,WAAW,CAAC,MAAwB;IAClD,OAAO,YAAY,CAAC,EAAE,IAAI,EAAE,EAAE,OAAO,EAAE,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;AAClE,CAAC;AAED,MAAM,UAAU,iCAAiC,CAAC,GAAc,EAAE,MAAsB;IACtF,MAAM,OAAO,GAAI,MAAM,CAAC,IAAmB,CAAC,OAAO,CAAC;IACpD,GAAG,CAAC,KAAK,GAAG,OAAO,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,eAAe,CAAC,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;IACvG,GAAG,CAAC,MAAM,GAAG,OAAO,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,gBAAgB,CAAC,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;AAC3G,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,GAAmC;IAC9D,OAAO,YAAY,CAAC,UAAU,EAAE,GAAG,EAAE,gBAAgB,EAAE,mBAAmB,CAAW,CAAC;AACxF,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,IAAoC;IACnE,OAAO;QACL,OAAO,EAAE,IAAI,EAAE,OAAO,IAAI,IAAI;KAC/B,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,mBAAmB;IACjC,OAAO,mBAAmB,CAAC,cAAc,CAAkB,CAAC;AAC9D,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,MAAwB;IACvD,OAAO,gBAAgB,CAAC,MAAM,CAAkB,CAAC;AACnD,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,MAAc,EAAE,KAA4B;IAC3E,MAAM,CAAC,IAAI,CAAC,OAAO,GAAG,KAAK,CAAC;IAC5B,0BAA0B,CAAC,MAAM,CAAC,CAAC;IACnC,yBAAyB,CAAC,MAAM,CAAC,CAAC;AACpC,CAAC;AAED,MAAM,cAAc,GAAsC;IACxD,2BAA2B,EAAE,iCAAiC;CAC/D,CAAC"}
+{"version":3,"file":"sprite.js","sourceRoot":"","sources":["../src/sprite.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@flighthq/scene2d",
-  "version": "0.3.0-next.1220.6982c21",
+  "version": "0.3.0-next.1248.f867198",
   "repository": {
     "type": "git",
     "url": "https://github.com/flighthq/flight.git",
@@ -36,15 +36,15 @@
     "clean:dist": "tsx ../../scripts/clean-package-dist.ts"
   },
   "dependencies": {
-    "@flighthq/adjustments": "0.3.0-next.1220.6982c21",
-    "@flighthq/animation": "0.3.0-next.1220.6982c21",
-    "@flighthq/entity": "0.3.0-next.1220.6982c21",
-    "@flighthq/geometry": "0.3.0-next.1220.6982c21",
-    "@flighthq/materials": "0.3.0-next.1220.6982c21",
-    "@flighthq/node": "0.3.0-next.1220.6982c21",
-    "@flighthq/signals": "0.3.0-next.1220.6982c21",
-    "@flighthq/texture": "0.3.0-next.1220.6982c21",
-    "@flighthq/types": "0.3.0-next.1220.6982c21"
+    "@flighthq/adjustments": "0.3.0-next.1248.f867198",
+    "@flighthq/animation": "0.3.0-next.1248.f867198",
+    "@flighthq/entity": "0.3.0-next.1248.f867198",
+    "@flighthq/geometry": "0.3.0-next.1248.f867198",
+    "@flighthq/materials": "0.3.0-next.1248.f867198",
+    "@flighthq/node": "0.3.0-next.1248.f867198",
+    "@flighthq/signals": "0.3.0-next.1248.f867198",
+    "@flighthq/texture": "0.3.0-next.1248.f867198",
+    "@flighthq/types": "0.3.0-next.1248.f867198"
   },
   "devDependencies": {
     "typescript": "^5.3.0"

package/src/sprite.test.ts

@@ -1,5 +1,6 @@
 import { getEntityRuntime } from '@flighthq/entity/contract';
 import { createRectangle } from '@flighthq/geometry/contract';
+import { getNodeLocalBoundsRectangle } from '@flighthq/node/contract';
 import { createTexture, setTextureUvFromPixelRect } from '@flighthq/texture/contract';
 import type { Image, Node, Sprite, SpriteRuntime } from '@flighthq/types/contract';
 import { SpriteKind } from '@flighthq/types/contract';
@@ -9,9 +10,10 @@ import {
   computeSpriteLocalBoundsRectangle,
   createSprite,
   createSpriteData,
+  createSpriteRendererData,
   createSpriteRuntime,
   getSpriteRuntime,
-  setSpriteTexture,
+  isSpriteRendererDirty,
 } from './sprite';
 
 describe('cloneSprite', () => {
@@ -79,6 +81,15 @@ describe('createSpriteData', () => {
   });
 });
 
+describe('createSpriteRendererData', () => {
+  it('creates a clean per-state stamp for the current texture', () => {
+    const sprite = createSprite({ data: { texture: texture(16, 16) } });
+    const data = createSpriteRendererData({} as never, sprite);
+
+    expect(isSpriteRendererDirty({} as never, sprite, data)).toBe(false);
+  });
+});
+
 describe('createSpriteRuntime', () => {
   it('returns a non-null runtime', () => {
     const runtime = createSpriteRuntime();
@@ -88,6 +99,13 @@ describe('createSpriteRuntime', () => {
   it('uses computeSpriteLocalBoundsRectangle', () => {
     expect(createSpriteRuntime().computeLocalBoundsRectangle).toStrictEqual(computeSpriteLocalBoundsRectangle);
   });
+
+  it('installs the texture-aware local-bounds validity hook', () => {
+    const runtime = createSpriteRuntime();
+    expect(typeof runtime.isLocalBoundsRectangleValid).toBe('function');
+    expect(runtime.localBoundsTexture).toBeNull();
+    expect(runtime.localBoundsTextureVersion).toBe(-1);
+  });
 });
 
 describe('getSpriteRuntime', () => {
@@ -96,34 +114,40 @@ describe('getSpriteRuntime', () => {
   });
 });
 
-describe('setSpriteTexture', () => {
-  it('sets the texture', () => {
-    const sprite = createSprite();
-    const imageTexture = texture(64, 64);
-    setSpriteTexture(sprite, imageTexture);
-    expect(sprite.data.texture).toBe(imageTexture);
-  });
+describe('isSpriteRendererDirty', () => {
+  it('detects same-size bare texture assignment once without node invalidation', () => {
+    const sprite = createSprite({ data: { texture: texture(64, 64) } });
+    const data = createSpriteRendererData({} as never, sprite);
+    const runtime = getEntityRuntime(sprite) as SpriteRuntime;
+    const contentId = runtime.localContentId;
 
-  it('accepts null', () => {
-    const sprite = createSprite({ data: { texture: texture(1, 1) } });
-    setSpriteTexture(sprite, null);
-    expect(sprite.data.texture).toBeNull();
+    sprite.data.texture = texture(64, 64);
+
+    expect(isSpriteRendererDirty({} as never, sprite, data)).toBe(true);
+    expect(isSpriteRendererDirty({} as never, sprite, data)).toBe(false);
+    expect(runtime.localContentId).toBe(contentId);
   });
 
-  it('invalidates local bounds', () => {
-    const sprite = createSprite();
-    const runtime = getEntityRuntime(sprite) as SpriteRuntime;
-    const idBefore = runtime.localBoundsId;
-    setSpriteTexture(sprite, texture(64, 64));
-    expect(runtime.localBoundsId).not.toBe(idBefore);
+  it('detects a version bump on the same texture identity', () => {
+    const sprite = createSprite({ data: { texture: texture(64, 64) } });
+    const data = createSpriteRendererData({} as never, sprite);
+    sprite.data.texture!.version++;
+
+    expect(isSpriteRendererDirty({} as never, sprite, data)).toBe(true);
   });
+});
 
-  it('invalidates local content', () => {
-    const sprite = createSprite();
+describe('Sprite local bounds validity', () => {
+  it('refreshes bounds after bare texture assignment without changing localBoundsId', () => {
+    const sprite = createSprite({ data: { texture: texture(16, 12) } });
+    expect(getNodeLocalBoundsRectangle(sprite)).toMatchObject({ width: 16, height: 12 });
     const runtime = getEntityRuntime(sprite) as SpriteRuntime;
-    const idBefore = runtime.localContentId;
-    setSpriteTexture(sprite, texture(64, 64));
-    expect(runtime.localContentId).not.toBe(idBefore);
+    const localBoundsId = runtime.localBoundsId;
+
+    sprite.data.texture = texture(48, 30);
+
+    expect(getNodeLocalBoundsRectangle(sprite)).toMatchObject({ width: 48, height: 30 });
+    expect(runtime.localBoundsId).toBe(localBoundsId);
   });
 });