@flighthq/shape 0.3.0-next.1566.dcdf1d3 → 0.3.0-next.1584.a68fe91

package/dist/contract.d.ts

@@ -1,3 +1,5 @@
+export * from './morphShape';
+export * from './morphShapeAnimation';
 export * from './scale9Shape';
 export * from './shape';
 export * from './shapeCommands';

package/dist/contract.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"contract.d.ts","sourceRoot":"","sources":["../src/contract.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAC9B,cAAc,SAAS,CAAC;AACxB,cAAc,iBAAiB,CAAC;AAChC,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,sBAAsB,CAAC;AACrC,cAAc,wBAAwB,CAAC;AACvC,cAAc,wBAAwB,CAAC;AACvC,cAAc,uBAAuB,CAAC"}
+{"version":3,"file":"contract.d.ts","sourceRoot":"","sources":["../src/contract.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,uBAAuB,CAAC;AACtC,cAAc,eAAe,CAAC;AAC9B,cAAc,SAAS,CAAC;AACxB,cAAc,iBAAiB,CAAC;AAChC,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,sBAAsB,CAAC;AACrC,cAAc,wBAAwB,CAAC;AACvC,cAAc,wBAAwB,CAAC;AACvC,cAAc,uBAAuB,CAAC"}

package/dist/contract.js

@@ -1,3 +1,5 @@
+export * from './morphShape';
+export * from './morphShapeAnimation';
 export * from './scale9Shape';
 export * from './shape';
 export * from './shapeCommands';

package/dist/contract.js.map

@@ -1 +1 @@
-{"version":3,"file":"contract.js","sourceRoot":"","sources":["../src/contract.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAC9B,cAAc,SAAS,CAAC;AACxB,cAAc,iBAAiB,CAAC;AAChC,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,sBAAsB,CAAC;AACrC,cAAc,wBAAwB,CAAC;AACvC,cAAc,wBAAwB,CAAC;AACvC,cAAc,uBAAuB,CAAC"}
+{"version":3,"file":"contract.js","sourceRoot":"","sources":["../src/contract.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,uBAAuB,CAAC;AACtC,cAAc,eAAe,CAAC;AAC9B,cAAc,SAAS,CAAC;AACxB,cAAc,iBAAiB,CAAC;AAChC,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,sBAAsB,CAAC;AACrC,cAAc,wBAAwB,CAAC;AACvC,cAAc,wBAAwB,CAAC;AACvC,cAAc,uBAAuB,CAAC"}

package/dist/index.d.ts

@@ -1,3 +1,3 @@
-export { PathCommand, appendShapeArc, appendShapeArcTo, appendShapeBeginTextureFill, appendShapeBeginFill, appendShapeBeginGradientFill, appendShapeCircle, appendShapeCubicCurveTo, appendShapeCurveTo, appendShapeDrawTriangles, appendShapeEllipse, appendShapeEndFill, appendShapeGeometryCommand, appendShapeLineTextureStyle, appendShapeLineGradientStyle, appendShapeLineStyle, appendShapeLineTo, appendShapeMoveTo, appendShapePath, appendShapePolygon, appendShapePolyline, appendShapeRectangle, appendShapeRoundRectangle, appendShapeRoundRectangleVarying, clearShapeCommands, computeShapeLocalBoundsRectangle, copyShapeCommands, createScale9Shape, createShape, enableShapeHitTesting, getPathCommandOperandCount, getShapeBounds, getShapeCommandCount, getShapeFillRegions, getShapeStrokeRegions, getShapeStrokeOutlineRegions, hasNonSolidShapeFill, hasNonSolidShapeStroke, hasShapeFill, hitTestShapeCommandPoint, isShapeEmpty, registerShapeHitTestCommand, } from './contract';
+export { PathCommand, applyAnimationClipToMorphShape, applyMorphShapeAnimationSample, appendMorphShapePath, appendShapeArc, appendShapeArcTo, appendShapeBeginTextureFill, appendShapeBeginFill, appendShapeBeginGradientFill, appendShapeCircle, appendShapeCubicCurveTo, appendShapeCurveTo, appendShapeDrawTriangles, appendShapeEllipse, appendShapeEndFill, appendShapeGeometryCommand, appendShapeLineTextureStyle, appendShapeLineGradientStyle, appendShapeLineStyle, appendShapeLineTo, appendShapeMoveTo, appendShapePath, appendShapePolygon, appendShapePolyline, appendShapeRectangle, appendShapeRoundRectangle, appendShapeRoundRectangleVarying, clearShapeCommands, computeShapeLocalBoundsRectangle, copyShapeCommands, createMorphShape, createMorphShapeAnimationTarget, createScale9Shape, createShape, enableShapeHitTesting, getPathCommandOperandCount, getShapeBounds, getShapeCommandCount, getShapeFillRegions, getShapeStrokeRegions, getShapeStrokeOutlineRegions, hasNonSolidShapeFill, hasNonSolidShapeStroke, hasShapeFill, hitTestShapeCommandPoint, isShapeEmpty, registerShapeHitTestCommand, setMorphShapeProgress, } from './contract';
 export * from './scale9ShapeCommands';
 //# 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,WAAW,EACX,cAAc,EACd,gBAAgB,EAChB,2BAA2B,EAC3B,oBAAoB,EACpB,4BAA4B,EAC5B,iBAAiB,EACjB,uBAAuB,EACvB,kBAAkB,EAClB,wBAAwB,EACxB,kBAAkB,EAClB,kBAAkB,EAClB,0BAA0B,EAC1B,2BAA2B,EAC3B,4BAA4B,EAC5B,oBAAoB,EACpB,iBAAiB,EACjB,iBAAiB,EACjB,eAAe,EACf,kBAAkB,EAClB,mBAAmB,EACnB,oBAAoB,EACpB,yBAAyB,EACzB,gCAAgC,EAChC,kBAAkB,EAClB,gCAAgC,EAChC,iBAAiB,EACjB,iBAAiB,EACjB,WAAW,EACX,qBAAqB,EACrB,0BAA0B,EAC1B,cAAc,EACd,oBAAoB,EACpB,mBAAmB,EACnB,qBAAqB,EACrB,4BAA4B,EAC5B,oBAAoB,EACpB,sBAAsB,EACtB,YAAY,EACZ,wBAAwB,EACxB,YAAY,EACZ,2BAA2B,GAC5B,MAAM,YAAY,CAAC;AACpB,cAAc,uBAAuB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,WAAW,EACX,8BAA8B,EAC9B,8BAA8B,EAC9B,oBAAoB,EACpB,cAAc,EACd,gBAAgB,EAChB,2BAA2B,EAC3B,oBAAoB,EACpB,4BAA4B,EAC5B,iBAAiB,EACjB,uBAAuB,EACvB,kBAAkB,EAClB,wBAAwB,EACxB,kBAAkB,EAClB,kBAAkB,EAClB,0BAA0B,EAC1B,2BAA2B,EAC3B,4BAA4B,EAC5B,oBAAoB,EACpB,iBAAiB,EACjB,iBAAiB,EACjB,eAAe,EACf,kBAAkB,EAClB,mBAAmB,EACnB,oBAAoB,EACpB,yBAAyB,EACzB,gCAAgC,EAChC,kBAAkB,EAClB,gCAAgC,EAChC,iBAAiB,EACjB,gBAAgB,EAChB,+BAA+B,EAC/B,iBAAiB,EACjB,WAAW,EACX,qBAAqB,EACrB,0BAA0B,EAC1B,cAAc,EACd,oBAAoB,EACpB,mBAAmB,EACnB,qBAAqB,EACrB,4BAA4B,EAC5B,oBAAoB,EACpB,sBAAsB,EACtB,YAAY,EACZ,wBAAwB,EACxB,YAAY,EACZ,2BAA2B,EAC3B,qBAAqB,GACtB,MAAM,YAAY,CAAC;AACpB,cAAc,uBAAuB,CAAC"}

package/dist/index.js

@@ -1,3 +1,3 @@
-export { PathCommand, appendShapeArc, appendShapeArcTo, appendShapeBeginTextureFill, appendShapeBeginFill, appendShapeBeginGradientFill, appendShapeCircle, appendShapeCubicCurveTo, appendShapeCurveTo, appendShapeDrawTriangles, appendShapeEllipse, appendShapeEndFill, appendShapeGeometryCommand, appendShapeLineTextureStyle, appendShapeLineGradientStyle, appendShapeLineStyle, appendShapeLineTo, appendShapeMoveTo, appendShapePath, appendShapePolygon, appendShapePolyline, appendShapeRectangle, appendShapeRoundRectangle, appendShapeRoundRectangleVarying, clearShapeCommands, computeShapeLocalBoundsRectangle, copyShapeCommands, createScale9Shape, createShape, enableShapeHitTesting, getPathCommandOperandCount, getShapeBounds, getShapeCommandCount, getShapeFillRegions, getShapeStrokeRegions, getShapeStrokeOutlineRegions, hasNonSolidShapeFill, hasNonSolidShapeStroke, hasShapeFill, hitTestShapeCommandPoint, isShapeEmpty, registerShapeHitTestCommand, } from './contract';
+export { PathCommand, applyAnimationClipToMorphShape, applyMorphShapeAnimationSample, appendMorphShapePath, appendShapeArc, appendShapeArcTo, appendShapeBeginTextureFill, appendShapeBeginFill, appendShapeBeginGradientFill, appendShapeCircle, appendShapeCubicCurveTo, appendShapeCurveTo, appendShapeDrawTriangles, appendShapeEllipse, appendShapeEndFill, appendShapeGeometryCommand, appendShapeLineTextureStyle, appendShapeLineGradientStyle, appendShapeLineStyle, appendShapeLineTo, appendShapeMoveTo, appendShapePath, appendShapePolygon, appendShapePolyline, appendShapeRectangle, appendShapeRoundRectangle, appendShapeRoundRectangleVarying, clearShapeCommands, computeShapeLocalBoundsRectangle, copyShapeCommands, createMorphShape, createMorphShapeAnimationTarget, createScale9Shape, createShape, enableShapeHitTesting, getPathCommandOperandCount, getShapeBounds, getShapeCommandCount, getShapeFillRegions, getShapeStrokeRegions, getShapeStrokeOutlineRegions, hasNonSolidShapeFill, hasNonSolidShapeStroke, hasShapeFill, hitTestShapeCommandPoint, isShapeEmpty, registerShapeHitTestCommand, setMorphShapeProgress, } from './contract';
 export * from './scale9ShapeCommands';
 //# 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,WAAW,EACX,cAAc,EACd,gBAAgB,EAChB,2BAA2B,EAC3B,oBAAoB,EACpB,4BAA4B,EAC5B,iBAAiB,EACjB,uBAAuB,EACvB,kBAAkB,EAClB,wBAAwB,EACxB,kBAAkB,EAClB,kBAAkB,EAClB,0BAA0B,EAC1B,2BAA2B,EAC3B,4BAA4B,EAC5B,oBAAoB,EACpB,iBAAiB,EACjB,iBAAiB,EACjB,eAAe,EACf,kBAAkB,EAClB,mBAAmB,EACnB,oBAAoB,EACpB,yBAAyB,EACzB,gCAAgC,EAChC,kBAAkB,EAClB,gCAAgC,EAChC,iBAAiB,EACjB,iBAAiB,EACjB,WAAW,EACX,qBAAqB,EACrB,0BAA0B,EAC1B,cAAc,EACd,oBAAoB,EACpB,mBAAmB,EACnB,qBAAqB,EACrB,4BAA4B,EAC5B,oBAAoB,EACpB,sBAAsB,EACtB,YAAY,EACZ,wBAAwB,EACxB,YAAY,EACZ,2BAA2B,GAC5B,MAAM,YAAY,CAAC;AACpB,cAAc,uBAAuB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,WAAW,EACX,8BAA8B,EAC9B,8BAA8B,EAC9B,oBAAoB,EACpB,cAAc,EACd,gBAAgB,EAChB,2BAA2B,EAC3B,oBAAoB,EACpB,4BAA4B,EAC5B,iBAAiB,EACjB,uBAAuB,EACvB,kBAAkB,EAClB,wBAAwB,EACxB,kBAAkB,EAClB,kBAAkB,EAClB,0BAA0B,EAC1B,2BAA2B,EAC3B,4BAA4B,EAC5B,oBAAoB,EACpB,iBAAiB,EACjB,iBAAiB,EACjB,eAAe,EACf,kBAAkB,EAClB,mBAAmB,EACnB,oBAAoB,EACpB,yBAAyB,EACzB,gCAAgC,EAChC,kBAAkB,EAClB,gCAAgC,EAChC,iBAAiB,EACjB,gBAAgB,EAChB,+BAA+B,EAC/B,iBAAiB,EACjB,WAAW,EACX,qBAAqB,EACrB,0BAA0B,EAC1B,cAAc,EACd,oBAAoB,EACpB,mBAAmB,EACnB,qBAAqB,EACrB,4BAA4B,EAC5B,oBAAoB,EACpB,sBAAsB,EACtB,YAAY,EACZ,wBAAwB,EACxB,YAAY,EACZ,2BAA2B,EAC3B,qBAAqB,GACtB,MAAM,YAAY,CAAC;AACpB,cAAc,uBAAuB,CAAC"}

package/dist/morphShape.d.ts

@@ -0,0 +1,8 @@
+import type { MorphShape, MorphShapeData, MorphShapeRuntime, PartialNode, PathMorph } from '@flighthq/types/contract';
+export declare function appendMorphShapePath(shape: MorphShape): void;
+export declare function createMorphShape(morph: Readonly<PathMorph>, obj?: Readonly<PartialNode<MorphShape>>): MorphShape;
+export declare function createMorphShapeData(morph: Readonly<PathMorph>, data?: Readonly<Partial<MorphShapeData>>): MorphShapeData;
+export declare function createMorphShapeRuntime(): MorphShapeRuntime;
+export declare function getMorphShapeRuntime(source: Readonly<MorphShape>): Readonly<MorphShapeRuntime>;
+export declare function setMorphShapeProgress(shape: MorphShape, progress: number): void;
+//# sourceMappingURL=morphShape.d.ts.map

package/dist/morphShape.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"morphShape.d.ts","sourceRoot":"","sources":["../src/morphShape.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAE,cAAc,EAAE,iBAAiB,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAStH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI,CAG5D;AAMD,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,QAAQ,CAAC,SAAS,CAAC,EAAE,GAAG,CAAC,EAAE,QAAQ,CAAC,WAAW,CAAC,UAAU,CAAC,CAAC,GAAG,UAAU,CAOhH;AAED,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,QAAQ,CAAC,SAAS,CAAC,EAC1B,IAAI,CAAC,EAAE,QAAQ,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC,GACvC,cAAc,CAUhB;AAED,wBAAgB,uBAAuB,IAAI,iBAAiB,CAE3D;AAED,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,QAAQ,CAAC,UAAU,CAAC,GAAG,QAAQ,CAAC,iBAAiB,CAAC,CAE9F;AAKD,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAK/E"}

package/dist/morphShape.js

@@ -0,0 +1,48 @@
+import { invalidateContent } from '@flighthq/node/contract';
+import { createPath, samplePathMorph } from '@flighthq/path/contract';
+import { createNode2D, getNode2DRuntime } from '@flighthq/scene2d/contract';
+import { MorphShapeKind } from '@flighthq/types/contract';
+import { createShapeRuntime } from './shape';
+import { appendShapePath } from './shapeCommands';
+// Adds the MorphShape's stable sampled path at the current point in its retained command stream. This
+// composes with the ordinary beginFill/lineStyle/endFill commands: callers author styling exactly as
+// they do for Shape, then insert the live morph geometry wherever it belongs.
+export function appendMorphShapePath(shape) {
+    const path = shape.data.path;
+    appendShapePath(shape, path.commands, path.data, path.winding);
+}
+// Creates a retained MorphShape entity around a prepared path morph. The command stream starts empty,
+// like createShape; use appendMorphShapePath after the desired fill/stroke commands. Playback is
+// intentionally absent—animation/timeline code drives setMorphShapeProgress explicitly. Backends expose
+// their default MorphShape renderer as an explicit alias of their Shape command-stream renderer.
+export function createMorphShape(morph, obj) {
+    return createNode2D(MorphShapeKind, obj, (data) => createMorphShapeData(morph, data), createMorphShapeRuntime);
+}
+export function createMorphShapeData(morph, data) {
+    const progress = data?.progress ?? 0;
+    const path = createPath(morph.winding);
+    samplePathMorph(path, morph, progress);
+    return {
+        commands: data?.commands ?? [],
+        morph,
+        path,
+        progress,
+    };
+}
+export function createMorphShapeRuntime() {
+    return createShapeRuntime();
+}
+export function getMorphShapeRuntime(source) {
+    return getNode2DRuntime(source);
+}
+// Samples changed progress into the stable Path arrays retained by drawPath commands, then invalidates
+// Shape content so bounds and every backend rebuild from the new coordinates. Reapplying the same value
+// is a no-op; progress remains unclamped to preserve the path layer's deliberate easing-overshoot contract.
+export function setMorphShapeProgress(shape, progress) {
+    if (shape.data.progress === progress)
+        return;
+    shape.data.progress = progress;
+    samplePathMorph(shape.data.path, shape.data.morph, progress);
+    invalidateContent(shape);
+}
+//# sourceMappingURL=morphShape.js.map

package/dist/morphShape.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"morphShape.js","sourceRoot":"","sources":["../src/morphShape.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AACtE,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAE5E,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAE1D,OAAO,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAC7C,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAElD,sGAAsG;AACtG,qGAAqG;AACrG,8EAA8E;AAC9E,MAAM,UAAU,oBAAoB,CAAC,KAAiB;IACpD,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC;IAC7B,eAAe,CAAC,KAAK,EAAE,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;AACjE,CAAC;AAED,sGAAsG;AACtG,iGAAiG;AACjG,wGAAwG;AACxG,iGAAiG;AACjG,MAAM,UAAU,gBAAgB,CAAC,KAA0B,EAAE,GAAuC;IAClG,OAAO,YAAY,CACjB,cAAc,EACd,GAAG,EACH,CAAC,IAAI,EAAE,EAAE,CAAC,oBAAoB,CAAC,KAAK,EAAE,IAAI,CAAC,EAC3C,uBAAuB,CACV,CAAC;AAClB,CAAC;AAED,MAAM,UAAU,oBAAoB,CAClC,KAA0B,EAC1B,IAAwC;IAExC,MAAM,QAAQ,GAAG,IAAI,EAAE,QAAQ,IAAI,CAAC,CAAC;IACrC,MAAM,IAAI,GAAG,UAAU,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IACvC,eAAe,CAAC,IAAI,EAAE,KAAK,EAAE,QAAQ,CAAC,CAAC;IACvC,OAAO;QACL,QAAQ,EAAE,IAAI,EAAE,QAAQ,IAAI,EAAE;QAC9B,KAAK;QACL,IAAI;QACJ,QAAQ;KACT,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,uBAAuB;IACrC,OAAO,kBAAkB,EAAuB,CAAC;AACnD,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,MAA4B;IAC/D,OAAO,gBAAgB,CAAC,MAAM,CAAsB,CAAC;AACvD,CAAC;AAED,uGAAuG;AACvG,wGAAwG;AACxG,4GAA4G;AAC5G,MAAM,UAAU,qBAAqB,CAAC,KAAiB,EAAE,QAAgB;IACvE,IAAI,KAAK,CAAC,IAAI,CAAC,QAAQ,KAAK,QAAQ;QAAE,OAAO;IAC7C,KAAK,CAAC,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC/B,eAAe,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;IAC7D,iBAAiB,CAAC,KAAK,CAAC,CAAC;AAC3B,CAAC"}

package/dist/morphShapeAnimation.d.ts

@@ -0,0 +1,5 @@
+import type { AnimationChannel, AnimationClip, MorphShape, MorphShapeAnimationTarget } from '@flighthq/types/contract';
+export declare function applyAnimationClipToMorphShape(clip: Readonly<AnimationClip>, time: number): void;
+export declare function applyMorphShapeAnimationSample(sampled: Readonly<ArrayLike<number>>, channel: Readonly<AnimationChannel>): boolean;
+export declare function createMorphShapeAnimationTarget(shape: MorphShape): MorphShapeAnimationTarget;
+//# sourceMappingURL=morphShapeAnimation.d.ts.map

package/dist/morphShapeAnimation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"morphShapeAnimation.d.ts","sourceRoot":"","sources":["../src/morphShapeAnimation.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,aAAa,EAAE,UAAU,EAAE,yBAAyB,EAAE,MAAM,0BAA0B,CAAC;AAOvH,wBAAgB,8BAA8B,CAAC,IAAI,EAAE,QAAQ,CAAC,aAAa,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAEhG;AAID,wBAAgB,8BAA8B,CAC5C,OAAO,EAAE,QAAQ,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,EACpC,OAAO,EAAE,QAAQ,CAAC,gBAAgB,CAAC,GAClC,OAAO,CAOT;AAID,wBAAgB,+BAA+B,CAAC,KAAK,EAAE,UAAU,GAAG,yBAAyB,CAE5F"}

package/dist/morphShapeAnimation.js

@@ -0,0 +1,27 @@
+import { sampleAnimationClip } from '@flighthq/animation/contract';
+import { MorphShapeKind } from '@flighthq/types/contract';
+import { setMorphShapeProgress } from './morphShape';
+// Samples every channel at `time` and applies the channels carrying MorphShapeAnimationTarget refs.
+// Foreign targets are ignored, so one clip may compose MorphShape progress with other domain sinks.
+export function applyAnimationClipToMorphShape(clip, time) {
+    sampleAnimationClip(morphShapeAnimationScratch, clip, time, applyMorphShapeAnimationSample);
+}
+// Allocation-free visitor shared by clip, crossfade, blend-tree, state-machine, and layer-stack
+// samplers. Returns whether the channel carried a valid MorphShape animation target.
+export function applyMorphShapeAnimationSample(sampled, channel) {
+    const target = channel.targetRef;
+    if (target === null || typeof target !== 'object' || target.shape === undefined)
+        return false;
+    const shape = target.shape;
+    if (shape === null || typeof shape !== 'object' || shape.kind !== MorphShapeKind)
+        return false;
+    setMorphShapeProgress(shape, sampled[0]);
+    return true;
+}
+// Allocates one stable binding descriptor. Keep and reuse this identity when multiple animation
+// controllers should recognize their MorphShape progress channels as the same target.
+export function createMorphShapeAnimationTarget(shape) {
+    return { shape };
+}
+const morphShapeAnimationScratch = [0];
+//# sourceMappingURL=morphShapeAnimation.js.map

package/dist/morphShapeAnimation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"morphShapeAnimation.js","sourceRoot":"","sources":["../src/morphShapeAnimation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAC;AAEnE,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAE1D,OAAO,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AAErD,oGAAoG;AACpG,oGAAoG;AACpG,MAAM,UAAU,8BAA8B,CAAC,IAA6B,EAAE,IAAY;IACxF,mBAAmB,CAAC,0BAA0B,EAAE,IAAI,EAAE,IAAI,EAAE,8BAA8B,CAAC,CAAC;AAC9F,CAAC;AAED,gGAAgG;AAChG,qFAAqF;AACrF,MAAM,UAAU,8BAA8B,CAC5C,OAAoC,EACpC,OAAmC;IAEnC,MAAM,MAAM,GAAG,OAAO,CAAC,SAA6C,CAAC;IACrE,IAAI,MAAM,KAAK,IAAI,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,CAAC,KAAK,KAAK,SAAS;QAAE,OAAO,KAAK,CAAC;IAC9F,MAAM,KAAK,GAAG,MAAM,CAAC,KAA0B,CAAC;IAChD,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,KAAK,cAAc;QAAE,OAAO,KAAK,CAAC;IAC/F,qBAAqB,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;IACzC,OAAO,IAAI,CAAC;AACd,CAAC;AAED,gGAAgG;AAChG,sFAAsF;AACtF,MAAM,UAAU,+BAA+B,CAAC,KAAiB;IAC/D,OAAO,EAAE,KAAK,EAAE,CAAC;AACnB,CAAC;AAED,MAAM,0BAA0B,GAAa,CAAC,CAAC,CAAC,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@flighthq/shape",
-  "version": "0.3.0-next.1566.dcdf1d3",
+  "version": "0.3.0-next.1584.a68fe91",
   "repository": {
     "type": "git",
     "url": "https://github.com/flighthq/flight.git",
@@ -36,15 +36,16 @@
     "clean:dist": "tsx ../../scripts/clean-package-dist.ts"
   },
   "dependencies": {
-    "@flighthq/scene2d": "0.3.0-next.1566.dcdf1d3",
-    "@flighthq/geometry": "0.3.0-next.1566.dcdf1d3",
-    "@flighthq/node": "0.3.0-next.1566.dcdf1d3",
-    "@flighthq/path": "0.3.0-next.1566.dcdf1d3",
-    "@flighthq/types": "0.3.0-next.1566.dcdf1d3"
+    "@flighthq/animation": "0.3.0-next.1584.a68fe91",
+    "@flighthq/scene2d": "0.3.0-next.1584.a68fe91",
+    "@flighthq/geometry": "0.3.0-next.1584.a68fe91",
+    "@flighthq/node": "0.3.0-next.1584.a68fe91",
+    "@flighthq/path": "0.3.0-next.1584.a68fe91",
+    "@flighthq/types": "0.3.0-next.1584.a68fe91"
   },
   "devDependencies": {
     "typescript": "^5.3.0"
   },
-  "description": "Vector Shape display node: drawing commands, scale-9 shapes, and shape hit testing",
+  "description": "Vector Shape and MorphShape display nodes: retained drawing commands, path morphing, scale-9, and hit testing",
   "sideEffects": false
 }

package/src/morphShape.test.ts

@@ -0,0 +1,161 @@
+import { createRectangle } from '@flighthq/geometry/contract';
+import { getNodeLocalContentRevision } from '@flighthq/node/contract';
+import { appendPathLineTo, appendPathMoveTo, createPath, createPathMorph } from '@flighthq/path/contract';
+import type { PathMorph, ShapeCommandToken } from '@flighthq/types/contract';
+import { MorphShapeKind } from '@flighthq/types/contract';
+
+import {
+  appendMorphShapePath,
+  createMorphShape,
+  createMorphShapeData,
+  createMorphShapeRuntime,
+  getMorphShapeRuntime,
+  setMorphShapeProgress,
+} from './morphShape';
+import { getShapeBounds } from './shape';
+import { appendShapeBeginFill, appendShapeEndFill } from './shapeCommands';
+
+describe('appendMorphShapePath', () => {
+  it('inserts the live path between ordinary Shape styling commands', () => {
+    const shape = createMorphShape(createTestMorph());
+    appendShapeBeginFill(shape, 0x336699, 0.75);
+
+    appendMorphShapePath(shape);
+    appendShapeEndFill(shape);
+
+    expect(shape.data.commands).toStrictEqual([
+      'beginFill',
+      2,
+      0x336699,
+      0.75,
+      'drawPath',
+      3,
+      shape.data.path.commands,
+      shape.data.path.data,
+      'nonZero',
+      'endFill',
+      0,
+    ]);
+    expect(shape.data.commands[6]).toBe(shape.data.path.commands);
+    expect(shape.data.commands[7]).toBe(shape.data.path.data);
+  });
+});
+
+describe('createMorphShape', () => {
+  it('creates a distinct MorphShape over the prepared start sample', () => {
+    const morph = createTestMorph();
+
+    const shape = createMorphShape(morph);
+
+    expect(shape.kind).toBe(MorphShapeKind);
+    expect(shape.data.commands).toStrictEqual([]);
+    expect(shape.data.morph).toBe(morph);
+    expect(shape.data.path.commands).toStrictEqual(morph.commands);
+    expect(shape.data.path.data).toStrictEqual(morph.startData);
+    expect(shape.data.progress).toBe(0);
+  });
+
+  it('uses initial progress and a provided command buffer', () => {
+    const commands: ShapeCommandToken[] = ['beginFill', 2, 0xff0000, 1];
+
+    const shape = createMorphShape(createTestMorph(), { data: { commands, progress: 0.5 } });
+
+    expect(shape.data.commands).toBe(commands);
+    expect(shape.data.path.data).toStrictEqual([5, 10, 10, 10, 15, 10, 20, 10]);
+    expect(shape.data.progress).toBe(0.5);
+  });
+
+  it('owns a distinct sampled path for each retained shape', () => {
+    const morph = createTestMorph();
+
+    const a = createMorphShape(morph);
+    const b = createMorphShape(morph);
+
+    expect(a).not.toBe(b);
+    expect(a.data.path).not.toBe(b.data.path);
+    expect(a.data.path.commands).not.toBe(b.data.path.commands);
+    expect(a.data.path.data).not.toBe(b.data.path.data);
+  });
+});
+
+describe('createMorphShapeData', () => {
+  it('samples the requested initial endpoint exactly', () => {
+    const morph = createTestMorph();
+
+    const data = createMorphShapeData(morph, { progress: 1 });
+
+    expect(data.path.data).toStrictEqual(morph.endData);
+  });
+});
+
+describe('createMorphShapeRuntime', () => {
+  it('creates the standard Shape bounds runtime', () => {
+    expect(createMorphShapeRuntime().computeLocalBoundsRectangle).toBeTypeOf('function');
+  });
+});
+
+describe('getMorphShapeRuntime', () => {
+  it('returns the runtime attached to the retained shape', () => {
+    expect(getMorphShapeRuntime(createMorphShape(createTestMorph()))).not.toBeNull();
+  });
+});
+
+describe('setMorphShapeProgress', () => {
+  it('does not invalidate or resample unchanged progress', () => {
+    const shape = createMorphShape(createTestMorph());
+    const revision = getNodeLocalContentRevision(shape);
+    const data = shape.data.path.data.slice();
+
+    setMorphShapeProgress(shape, 0);
+
+    expect(shape.data.path.data).toStrictEqual(data);
+    expect(getNodeLocalContentRevision(shape)).toBe(revision);
+  });
+
+  it('resamples stable buffers, stores progress, and invalidates content', () => {
+    const shape = createMorphShape(createTestMorph());
+    appendMorphShapePath(shape);
+    const commands = shape.data.path.commands;
+    const data = shape.data.path.data;
+    const revision = getNodeLocalContentRevision(shape);
+
+    setMorphShapeProgress(shape, 0.5);
+
+    expect(shape.data.progress).toBe(0.5);
+    expect(shape.data.path.commands).toBe(commands);
+    expect(shape.data.path.data).toBe(data);
+    expect(shape.data.path.data).toStrictEqual([5, 10, 10, 10, 15, 10, 20, 10]);
+    expect(getNodeLocalContentRevision(shape)).toBe(revision + 1);
+  });
+
+  it('updates the bounds observed through the ordinary Shape runtime', () => {
+    const shape = createMorphShape(createTestMorph());
+    appendMorphShapePath(shape);
+    const bounds = createRectangle();
+    getShapeBounds(bounds, shape);
+    expect(bounds).toMatchObject({ x: 0, y: 0, width: 10, height: 0 });
+
+    setMorphShapeProgress(shape, 1);
+    getShapeBounds(bounds, shape);
+
+    expect(bounds).toMatchObject({ x: 10, y: 20, width: 20, height: 0 });
+  });
+
+  it('preserves unclamped easing overshoot', () => {
+    const shape = createMorphShape(createTestMorph());
+
+    setMorphShapeProgress(shape, 1.5);
+
+    expect(shape.data.path.data.slice(0, 2)).toStrictEqual([15, 30]);
+  });
+});
+
+function createTestMorph(): PathMorph {
+  const start = createPath();
+  appendPathMoveTo(start, 0, 0);
+  appendPathLineTo(start, 10, 0);
+  const end = createPath();
+  appendPathMoveTo(end, 10, 20);
+  appendPathLineTo(end, 30, 20);
+  return createPathMorph(start, end)!;
+}

package/src/morphShapeAnimation.test.ts

@@ -0,0 +1,120 @@
+import {
+  createAnimationBlendTree,
+  createAnimationBlendTreeInput,
+  createAnimationChannel,
+  createAnimationClip,
+  createAnimationPlayer,
+  createAnimationTrack,
+  sampleAnimationBlendTree,
+} from '@flighthq/animation/contract';
+import { getNodeLocalContentRevision } from '@flighthq/node/contract';
+import { appendPathLineTo, appendPathMoveTo, createPath, createPathMorph } from '@flighthq/path/contract';
+import type { MorphShape, MorphShapeAnimationTarget } from '@flighthq/types/contract';
+
+import { createMorphShape } from './morphShape';
+import {
+  applyAnimationClipToMorphShape,
+  applyMorphShapeAnimationSample,
+  createMorphShapeAnimationTarget,
+} from './morphShapeAnimation';
+
+describe('applyAnimationClipToMorphShape', () => {
+  it('samples scalar progress while preserving easing overshoot', () => {
+    const shape = createTestMorphShape();
+    const target = createMorphShapeAnimationTarget(shape);
+    const clip = createAnimationClip([
+      createAnimationChannel(
+        createAnimationTrack({ easing: (progress) => progress * 2, times: [0, 1], values: [0, 1] }),
+        target,
+      ),
+    ]);
+
+    applyAnimationClipToMorphShape(clip, 0.75);
+
+    expect(shape.data.progress).toBe(1.5);
+    expect(shape.data.path.data.slice(0, 2)).toStrictEqual([30, 45]);
+  });
+
+  it('ignores foreign channels in a composed clip', () => {
+    const shape = createTestMorphShape();
+    const clip = createAnimationClip([
+      createAnimationChannel(createAnimationTrack({ times: [0, 1], values: [0, 100] }), { node: shape, path: 'X' }),
+      createAnimationChannel(
+        createAnimationTrack({ times: [0, 1], values: [0, 1] }),
+        createMorphShapeAnimationTarget(shape),
+      ),
+    ]);
+
+    applyAnimationClipToMorphShape(clip, 0.25);
+
+    expect(shape.x).toBe(0);
+    expect(shape.data.progress).toBe(0.25);
+  });
+});
+
+describe('applyMorphShapeAnimationSample', () => {
+  it('mutates stable path buffers and invalidates retained content', () => {
+    const shape = createTestMorphShape();
+    const commands = shape.data.path.commands;
+    const data = shape.data.path.data;
+    const revision = getNodeLocalContentRevision(shape);
+    const channel = createAnimationChannel(
+      createAnimationTrack({ times: [0, 1], values: [0, 1] }),
+      createMorphShapeAnimationTarget(shape),
+    );
+
+    expect(applyMorphShapeAnimationSample([0.5], channel)).toBe(true);
+    expect(shape.data.progress).toBe(0.5);
+    expect(shape.data.path.commands).toBe(commands);
+    expect(shape.data.path.data).toBe(data);
+    expect(getNodeLocalContentRevision(shape)).toBe(revision + 1);
+  });
+
+  it('serves as the sink for composed animation samples', () => {
+    const shape = createTestMorphShape();
+    const target = createMorphShapeAnimationTarget(shape);
+    const a = createAnimationPlayer(
+      createAnimationClip([createAnimationChannel(createAnimationTrack({ times: [0, 1], values: [0, 1] }), target)]),
+      { time: 0.5 },
+    );
+    const b = createAnimationPlayer(
+      createAnimationClip([createAnimationChannel(createAnimationTrack({ times: [0, 1], values: [0, 0.2] }), target)]),
+      { time: 0.5 },
+    );
+    const tree = createAnimationBlendTree([createAnimationBlendTreeInput(a, 1), createAnimationBlendTreeInput(b, 1)]);
+
+    sampleAnimationBlendTree([0], tree, applyMorphShapeAnimationSample);
+
+    expect(shape.data.progress).toBeCloseTo(0.3);
+  });
+
+  it('returns false for foreign targets without changing the shape', () => {
+    const shape = createTestMorphShape();
+    const channel = createAnimationChannel(createAnimationTrack({ times: [0, 1], values: [0, 1] }), {
+      shape: { kind: 'acme.NotMorphShape' },
+    });
+
+    expect(applyMorphShapeAnimationSample([1], channel)).toBe(false);
+    expect(shape.data.progress).toBe(0);
+  });
+});
+
+describe('createMorphShapeAnimationTarget', () => {
+  it('allocates a reusable target descriptor for one MorphShape', () => {
+    const shape = createTestMorphShape();
+
+    const target: MorphShapeAnimationTarget = createMorphShapeAnimationTarget(shape);
+
+    expect(target).toStrictEqual({ shape });
+  });
+});
+
+function createTestMorphShape(): MorphShape {
+  const start = createPath();
+  appendPathMoveTo(start, 0, 0);
+  appendPathLineTo(start, 10, 0);
+  const end = createPath();
+  appendPathMoveTo(end, 20, 30);
+  appendPathLineTo(end, 40, 30);
+  return createMorphShape(createPathMorph(start, end)!);
+}