@flighthq/displayobject 0.1.0 → 0.2.0

package/dist/displayObject.d.ts

@@ -1,8 +1,12 @@
-import type { ClipRegion, DisplayObject, DisplayObjectDataFactory, DisplayObjectRuntime, DisplayObjectRuntimeFactory, Kind, MethodsOf, NodeAny, PartialNode } from '@flighthq/types';
+import type { Adjustment, ClipRegion, ColorTransform, DisplayObject, DisplayObjectDataFactory, DisplayObjectRuntime, DisplayObjectRuntimeFactory, Kind, MethodsOf, NodeAny, PartialNode } from '@flighthq/types';
+export declare function addDisplayObjectColorAdjustment(source: DisplayObject, adjustment: Adjustment): void;
 export declare function createDisplayObject(obj?: Readonly<PartialNode<DisplayObject>>): DisplayObject;
 export declare function createDisplayObjectGeneric<R extends DisplayObjectRuntime>(kind: Kind, obj?: Readonly<PartialNode<DisplayObject>>, createData?: DisplayObjectDataFactory, createDisplayObjectRuntimeFactory?: DisplayObjectRuntimeFactory<R>): DisplayObject;
 export declare function createDisplayObjectRuntime(methods?: Readonly<Partial<MethodsOf<DisplayObjectRuntime>>>): DisplayObjectRuntime;
+export declare function getDisplayObjectColorAdjustments(source: Readonly<DisplayObject>): readonly Adjustment[] | null;
 export declare function getDisplayObjectRuntime(source: Readonly<DisplayObject>): Readonly<DisplayObjectRuntime>;
 export declare function isDisplayObject(node: NodeAny): node is DisplayObject;
 export declare function setDisplayObjectClip(source: DisplayObject, value: ClipRegion | null): void;
+export declare function setDisplayObjectColorAdjustments(source: DisplayObject, value: readonly Adjustment[] | null): void;
+export declare function setDisplayObjectColorTransform(source: DisplayObject, colorTransform: Readonly<ColorTransform> | null): void;
 //# sourceMappingURL=displayObject.d.ts.map

package/dist/displayObject.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"displayObject.d.ts","sourceRoot":"","sources":["../src/displayObject.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EACV,UAAU,EACV,aAAa,EACb,wBAAwB,EACxB,oBAAoB,EACpB,2BAA2B,EAC3B,IAAI,EACJ,SAAS,EACT,OAAO,EAEP,WAAW,EACZ,MAAM,iBAAiB,CAAC;AAGzB,wBAAgB,mBAAmB,CAAC,GAAG,CAAC,EAAE,QAAQ,CAAC,WAAW,CAAC,aAAa,CAAC,CAAC,GAAG,aAAa,CAE7F;AAED,wBAAgB,0BAA0B,CAAC,CAAC,SAAS,oBAAoB,EACvE,IAAI,EAAE,IAAI,EACV,GAAG,CAAC,EAAE,QAAQ,CAAC,WAAW,CAAC,aAAa,CAAC,CAAC,EAC1C,UAAU,CAAC,EAAE,wBAAwB,EACrC,iCAAiC,CAAC,EAAE,2BAA2B,CAAC,CAAC,CAAC,GACjE,aAAa,CAaf;AAED,wBAAgB,0BAA0B,CACxC,OAAO,CAAC,EAAE,QAAQ,CAAC,OAAO,CAAC,SAAS,CAAC,oBAAoB,CAAC,CAAC,CAAC,GAC3D,oBAAoB,CAMtB;AAED,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,QAAQ,CAAC,aAAa,CAAC,GAAG,QAAQ,CAAC,oBAAoB,CAAC,CAEvG;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,IAAI,aAAa,CAEpE;AAED,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,aAAa,EAAE,KAAK,EAAE,UAAU,GAAG,IAAI,GAAG,IAAI,CAG1F"}
+{"version":3,"file":"displayObject.d.ts","sourceRoot":"","sources":["../src/displayObject.ts"],"names":[],"mappings":"AAoBA,OAAO,KAAK,EACV,UAAU,EACV,UAAU,EACV,cAAc,EACd,aAAa,EACb,wBAAwB,EACxB,oBAAoB,EACpB,2BAA2B,EAC3B,IAAI,EACJ,SAAS,EACT,OAAO,EAEP,WAAW,EACZ,MAAM,iBAAiB,CAAC;AAMzB,wBAAgB,+BAA+B,CAAC,MAAM,EAAE,aAAa,EAAE,UAAU,EAAE,UAAU,GAAG,IAAI,CAMnG;AAED,wBAAgB,mBAAmB,CAAC,GAAG,CAAC,EAAE,QAAQ,CAAC,WAAW,CAAC,aAAa,CAAC,CAAC,GAAG,aAAa,CAE7F;AAED,wBAAgB,0BAA0B,CAAC,CAAC,SAAS,oBAAoB,EACvE,IAAI,EAAE,IAAI,EACV,GAAG,CAAC,EAAE,QAAQ,CAAC,WAAW,CAAC,aAAa,CAAC,CAAC,EAC1C,UAAU,CAAC,EAAE,wBAAwB,EACrC,iCAAiC,CAAC,EAAE,2BAA2B,CAAC,CAAC,CAAC,GACjE,aAAa,CAaf;AAED,wBAAgB,0BAA0B,CACxC,OAAO,CAAC,EAAE,QAAQ,CAAC,OAAO,CAAC,SAAS,CAAC,oBAAoB,CAAC,CAAC,CAAC,GAC3D,oBAAoB,CAMtB;AAID,wBAAgB,gCAAgC,CAAC,MAAM,EAAE,QAAQ,CAAC,aAAa,CAAC,GAAG,SAAS,UAAU,EAAE,GAAG,IAAI,CAE9G;AAED,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,QAAQ,CAAC,aAAa,CAAC,GAAG,QAAQ,CAAC,oBAAoB,CAAC,CAEvG;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,IAAI,aAAa,CAEpE;AAED,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,aAAa,EAAE,KAAK,EAAE,UAAU,GAAG,IAAI,GAAG,IAAI,CAG1F;AAMD,wBAAgB,gCAAgC,CAAC,MAAM,EAAE,aAAa,EAAE,KAAK,EAAE,SAAS,UAAU,EAAE,GAAG,IAAI,GAAG,IAAI,CAKjH;AAKD,wBAAgB,8BAA8B,CAC5C,MAAM,EAAE,aAAa,EACrB,cAAc,EAAE,QAAQ,CAAC,cAAc,CAAC,GAAG,IAAI,GAC9C,IAAI,CAKN"}

package/dist/displayObject.js

@@ -1,5 +1,17 @@
+import { COLOR_ADJUSTMENT_CHANNEL_MIXING, COLOR_ADJUSTMENT_NONE, createColorTransformAdjustment, resolveColorAdjustmentsColorTransform, } from '@flighthq/adjustments';
+import { createColorTransform } from '@flighthq/materials';
 import { createNode, createNodeRuntime, getNodeRuntime, initAppearanceTrait, initBoundsRectangleRuntimeTrait, initBoundsRectangleTrait, initClipTrait, initMaterialTrait, initTransform2DRuntimeTrait, initTransform2DTrait, invalidateNodeAppearance, } from '@flighthq/node';
 import { DisplayObjectKind, DisplayObjectTraitsKey } from '@flighthq/types';
+// Appends one pointwise color adjustment to this object's stack (creating the stack if absent), re-fuses
+// the resolved cache, and invalidates appearance so the render walk hands the fold the new value.
+// Allocates a new array — the stack is a plain `readonly Adjustment[]`, never mutated in place.
+export function addDisplayObjectColorAdjustment(source, adjustment) {
+    const runtime = getNodeRuntime(source);
+    const current = runtime.colorAdjustments;
+    runtime.colorAdjustments = current === null ? [adjustment] : [...current, adjustment];
+    resolveDisplayObjectColorAdjustments(runtime);
+    invalidateNodeAppearance(source);
+}
 export function createDisplayObject(obj) {
     return createDisplayObjectGeneric(DisplayObjectKind, obj);
 }
@@ -19,6 +31,11 @@ export function createDisplayObjectRuntime(methods) {
     initBoundsRectangleRuntimeTrait(out, methods);
     return out;
 }
+// Returns this object's pointwise color-adjustment stack (the source of truth on the node runtime), or
+// null when it carries none.
+export function getDisplayObjectColorAdjustments(source) {
+    return getNodeRuntime(source).colorAdjustments;
+}
 export function getDisplayObjectRuntime(source) {
     return getNodeRuntime(source);
 }
@@ -29,4 +46,42 @@ export function setDisplayObjectClip(source, value) {
     source.clip = value;
     invalidateNodeAppearance(source);
 }
+// Sets (or clears with null) this object's pointwise color-adjustment stack — the generic replacement for
+// the removed color-transform trait. A color transform is one member: `createColorTransformAdjustment`.
+// Re-fuses the resolved cache once here (not per frame) and invalidates appearance so the render walk
+// hands the fold the affine ColorTransform the stack resolves to. Null is the untinted default.
+export function setDisplayObjectColorAdjustments(source, value) {
+    const runtime = getNodeRuntime(source);
+    runtime.colorAdjustments = value;
+    resolveDisplayObjectColorAdjustments(runtime);
+    invalidateNodeAppearance(source);
+}
+// Convenience for the common single-tint path (the color-transform an agent looks for): sets this object's
+// adjustment stack to one `ColorTransformAdjustment`, or clears it with null. Thin wrapper over
+// `setDisplayObjectColorAdjustments` — a color transform is just one adjustment in the generic stack.
+export function setDisplayObjectColorTransform(source, colorTransform) {
+    setDisplayObjectColorAdjustments(source, colorTransform === null ? null : [createColorTransformAdjustment(colorTransform)]);
+}
+// Fuses the runtime's color-adjustment stack once into its cached affine `resolvedColorTransform`, setting
+// `colorAdjustmentsChannelMixing` when the fused stack has off-diagonal channel-mixing terms the 8-float
+// fold cannot represent yet (the render walk reports that through the shakeable guard). Called by the
+// accessors on change — the render walk only reads the cache, so no fuse math weighs on the base render
+// path. The cached ColorTransform is reused in place across re-fuses to avoid per-set allocation churn.
+function resolveDisplayObjectColorAdjustments(runtime) {
+    const adjustments = runtime.colorAdjustments;
+    if (adjustments === null || adjustments.length === 0) {
+        runtime.resolvedColorTransform = null;
+        runtime.colorAdjustmentsChannelMixing = false;
+        return;
+    }
+    const out = runtime.resolvedColorTransform ?? createColorTransform();
+    const status = resolveColorAdjustmentsColorTransform(adjustments, out);
+    if (status === COLOR_ADJUSTMENT_NONE) {
+        runtime.resolvedColorTransform = null;
+        runtime.colorAdjustmentsChannelMixing = false;
+        return;
+    }
+    runtime.resolvedColorTransform = out;
+    runtime.colorAdjustmentsChannelMixing = status === COLOR_ADJUSTMENT_CHANNEL_MIXING;
+}
 //# sourceMappingURL=displayObject.js.map

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,+BAA+B,EAC/B,wBAAwB,EACxB,aAAa,EACb,iBAAiB,EACjB,2BAA2B,EAC3B,oBAAoB,EACpB,wBAAwB,GACzB,MAAM,gBAAgB,CAAC;AAaxB,OAAO,EAAE,iBAAiB,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAC;AAE5E,MAAM,UAAU,mBAAmB,CAAC,GAA0C;IAC5E,OAAO,0BAA0B,CAAC,iBAAiB,EAAE,GAAG,CAAC,CAAC;AAC5D,CAAC;AAED,MAAM,UAAU,0BAA0B,CACxC,IAAU,EACV,GAA0C,EAC1C,UAAqC,EACrC,iCAAkE;IAElE,MAAM,GAAG,GAAG,UAAU,CACpB,IAAI,EACJ,GAAG,EACH,UAAU,EACV,iCAAiC,IAAK,0BAA+D,CACrF,CAAC;IACnB,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,iBAAiB,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;IAC5B,aAAa,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;IACxB,OAAO,GAAG,CAAC;AACb,CAAC;AAED,MAAM,UAAU,0BAA0B,CACxC,OAA4D;IAE5D,MAAM,GAAG,GAAG,iBAAiB,CAAC,OAAO,CAAyB,CAAC;IAC/D,GAAG,CAAC,MAAM,GAAG,sBAAsB,CAAC;IACpC,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,uBAAuB,CAAC,MAA+B;IACrE,OAAO,cAAc,CAAC,MAAM,CAAyB,CAAC;AACxD,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,IAAa;IAC3C,OAAO,cAAc,CAAC,IAAI,CAAC,CAAC,MAAM,KAAK,sBAAsB,CAAC;AAChE,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,MAAqB,EAAE,KAAwB;IAClF,MAAM,CAAC,IAAI,GAAG,KAAK,CAAC;IACpB,wBAAwB,CAAC,MAAM,CAAC,CAAC;AACnC,CAAC"}
+{"version":3,"file":"displayObject.js","sourceRoot":"","sources":["../src/displayObject.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,11 @@
 {
   "name": "@flighthq/displayobject",
-  "version": "0.1.0",
+  "version": "0.2.0",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/flighthq/flight.git",
+    "directory": "packages/displayobject"
+  },
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -27,10 +32,12 @@
     "clean:dist": "tsx ../../scripts/clean-package-dist.ts"
   },
   "dependencies": {
-    "@flighthq/geometry": "0.1.0",
-    "@flighthq/node": "0.1.0",
-    "@flighthq/signals": "0.1.0",
-    "@flighthq/types": "0.1.0"
+    "@flighthq/adjustments": "0.2.0",
+    "@flighthq/geometry": "0.2.0",
+    "@flighthq/materials": "0.2.0",
+    "@flighthq/node": "0.2.0",
+    "@flighthq/signals": "0.2.0",
+    "@flighthq/types": "0.2.0"
   },
   "devDependencies": {
     "@flighthq/entity": "*",

package/src/bitmap.test.ts

@@ -1,5 +1,6 @@
 import { getEntityRuntime } from '@flighthq/entity';
 import { createRectangle } from '@flighthq/geometry';
+import { getNodeLocalBoundsRevision, getNodeLocalContentRevision, getNodeLocalTransformRevision } from '@flighthq/node';
 import type { Bitmap, BitmapRuntime, ImageResource, Node } from '@flighthq/types';
 import { BitmapKind } from '@flighthq/types';
 

package/src/displayObject.test.ts

@@ -1,4 +1,5 @@
 import { getEntityRuntime } from '@flighthq/entity';
+import { createColorTransform } from '@flighthq/materials';
 import type {
   BoundsNode,
   DisplayObject,
@@ -10,18 +11,47 @@ import type {
 import { BlendMode, DisplayObjectKind, DisplayObjectTraitsKey } from '@flighthq/types';
 
 import {
+  addDisplayObjectColorAdjustment,
   createDisplayObject,
   createDisplayObjectGeneric,
   createDisplayObjectRuntime,
+  getDisplayObjectColorAdjustments,
   getDisplayObjectRuntime,
   isDisplayObject,
   setDisplayObjectClip,
+  setDisplayObjectColorAdjustments,
+  setDisplayObjectColorTransform,
 } from './displayObject';
 
 function getRuntime_(obj: DisplayObject): DisplayObjectRuntime {
   return getEntityRuntime(obj) as DisplayObjectRuntime;
 }
 
+describe('addDisplayObjectColorAdjustment', () => {
+  let obj: DisplayObject;
+  beforeEach(() => {
+    obj = createDisplayObject();
+  });
+
+  it('appends to a fresh (null) stack and invalidates appearance', () => {
+    const idBefore = getRuntime_(obj).appearanceId;
+    const adjustment = { kind: 'ColorTransformAdjustment' } as never;
+    addDisplayObjectColorAdjustment(obj, adjustment);
+    expect(getDisplayObjectColorAdjustments(obj)).toEqual([adjustment]);
+    expect(getRuntime_(obj).appearanceId).not.toBe(idBefore);
+  });
+
+  it('appends to an existing stack without mutating the previous array', () => {
+    const a = { kind: 'A' } as never;
+    const b = { kind: 'B' } as never;
+    addDisplayObjectColorAdjustment(obj, a);
+    const first = getDisplayObjectColorAdjustments(obj);
+    addDisplayObjectColorAdjustment(obj, b);
+    expect(getDisplayObjectColorAdjustments(obj)).toEqual([a, b]);
+    expect(first).toEqual([a]); // the earlier array was not mutated
+  });
+});
+
 describe('createDisplayObject', () => {
   let displayObject: DisplayObject;
 
@@ -113,6 +143,12 @@ describe('createDisplayObjectRuntime', () => {
   });
 });
 
+describe('getDisplayObjectColorAdjustments', () => {
+  it('defaults to null on a fresh node', () => {
+    expect(getDisplayObjectColorAdjustments(createDisplayObject())).toBeNull();
+  });
+});
+
 describe('getDisplayObjectRuntime', () => {
   it('returns the runtime for a DisplayObject', () => {
     const obj = createDisplayObject();
@@ -161,6 +197,44 @@ describe('setDisplayObjectClip', () => {
   });
 });
 
+describe('setDisplayObjectColorAdjustments', () => {
+  let obj: DisplayObject;
+  beforeEach(() => {
+    obj = createDisplayObject();
+  });
+
+  it('sets the stack and invalidates appearance', () => {
+    const idBefore = getRuntime_(obj).appearanceId;
+    const stack = [{ kind: 'ColorTransformAdjustment' }] as never;
+    setDisplayObjectColorAdjustments(obj, stack);
+    expect(getDisplayObjectColorAdjustments(obj)).toBe(stack);
+    expect(getRuntime_(obj).appearanceId).not.toBe(idBefore);
+  });
+
+  it('accepts null', () => {
+    setDisplayObjectColorAdjustments(obj, [{ kind: 'ColorTransformAdjustment' }] as never);
+    setDisplayObjectColorAdjustments(obj, null);
+    expect(getDisplayObjectColorAdjustments(obj)).toBeNull();
+  });
+});
+
+describe('setDisplayObjectColorTransform', () => {
+  it('wraps a color transform as one ColorTransformAdjustment on the stack', () => {
+    const obj = createDisplayObject();
+    setDisplayObjectColorTransform(obj, createColorTransform({ redMultiplier: 0.5 }));
+    const stack = getDisplayObjectColorAdjustments(obj);
+    expect(stack?.length).toBe(1);
+    expect(stack?.[0].kind).toBe('ColorTransformAdjustment');
+  });
+
+  it('clears with null', () => {
+    const obj = createDisplayObject();
+    setDisplayObjectColorTransform(obj, createColorTransform({ redMultiplier: 0.5 }));
+    setDisplayObjectColorTransform(obj, null);
+    expect(getDisplayObjectColorAdjustments(obj)).toBeNull();
+  });
+});
+
 interface DisplayObjectTest extends DisplayObject {}
 
 interface DisplayObjectTestData extends DisplayObjectData {

package/src/video.test.ts

@@ -1,3 +1,4 @@
+import { getNodeLocalBoundsRevision, getNodeLocalContentRevision, getNodeLocalTransformRevision } from '@flighthq/node';
 import type { Video } from '@flighthq/types';
 import { VideoKind } from '@flighthq/types';