@flatkit/types 0.19.12 → 0.20.1

package/dist/index.d.ts

@@ -122,6 +122,13 @@ type Keyframe = {
 };
 /** Channels animatable by expression (= the decomposed components + opacity). */
 type ExprChannel = 'x' | 'y' | 'scaleX' | 'scaleY' | 'rotation' | 'opacity';
+/** ADDITIVE position offsets: a binding `dx = …` shifts the resolved position by `dx` in PARENT space,
+ *  on top of the body's `at` (and any absolute `x`/`y` channel) — `pos = (at.x + dx, at.y + dy)`. Solves
+ *  the recurring "absolute `x` deserts the anchor" trap for offset-style motion (`dx = 30*sin(time)`
+ *  oscillates AROUND `at`, no need to re-inject the base). Bindings only — not a keyframe/modifier channel. */
+type OffsetChannel = 'dx' | 'dy';
+/** Any channel that an expression BINDING can target: the absolute channels + the additive offsets. */
+type BindChannel = ExprChannel | OffsetChannel;
 /** A STATEFUL channel modifier: instead of a pure expression, the channel INTEGRATES over time toward
  *  `target` (a normal expression). State lives per (instance, channel) in the player, advanced at a fixed
  *  step, independent of `onEnterFrame`/input; on random access (seek/render) it snaps to `target` (the rest
@@ -180,7 +187,7 @@ type Timeline = {
 type InstanceBind = {
     symbol: string;
     as: string;
-    expr: Partial<Record<ExprChannel, string>>;
+    expr: Partial<Record<BindChannel, string>>;
 };
 /**
  * How a nested instance's OWN timeline advances (Flash's symbol-instance models):
@@ -401,7 +408,7 @@ type Group = {
         w: number;
         h: number;
     };
-    expressions?: Partial<Record<ExprChannel, string>>;
+    expressions?: Partial<Record<BindChannel, string>>;
     modifiers?: Partial<Record<ExprChannel, ChannelModifier>>;
     clip?: ClipRect;
 };
@@ -420,7 +427,7 @@ type Instance = {
     playback?: InstancePlayback;
     filters?: Filter[];
     blend?: BlendMode;
-    expressions?: Partial<Record<ExprChannel, string>>;
+    expressions?: Partial<Record<BindChannel, string>>;
     modifiers?: Partial<Record<ExprChannel, ChannelModifier>>;
     params?: Record<string, string>;
     clip?: ClipRect;
@@ -537,7 +544,7 @@ type Text = {
     pivot?: Point;
     filters?: Filter[];
     blend?: BlendMode;
-    expressions?: Partial<Record<ExprChannel, string>>;
+    expressions?: Partial<Record<BindChannel, string>>;
     modifiers?: Partial<Record<ExprChannel, ChannelModifier>>;
 };
 /** Bitmap image: a leaf item animatable like text. References an asset; `w`/`h` = intrinsic size in px
@@ -557,7 +564,7 @@ type Image = {
     pivot?: Point;
     filters?: Filter[];
     blend?: BlendMode;
-    expressions?: Partial<Record<ExprChannel, string>>;
+    expressions?: Partial<Record<BindChannel, string>>;
     modifiers?: Partial<Record<ExprChannel, ChannelModifier>>;
 };
 /** Layer content: material, one-off group, symbol instance, text, or image. */
@@ -614,4 +621,4 @@ type EditFrame = {
 };
 type Tool = 'brush' | 'rect' | 'ellipse' | 'eraser' | 'fill' | 'select' | 'transform' | 'text' | 'pan' | 'pen' | 'pathselect' | 'ink';
 
-export type { Action, Asset, BBox, BlendMode, Cel, ChannelModifier, ClipRect, ContentKey, ContentTrack, Doc, Easing, EditFrame, ExprChannel, ExprContext, Filter, Folder, FrameAction, FrameLabel, FuncDef, Group, Image, Instance, InstanceBind, InstancePlayback, Interaction, Interactor, Item, ItemEvent, ItemInteractionState, Keyframe, Layer, Paint, ParamDef, ParamType, Path, PlaybackMode, Point, PolyGroup, Polygon, Pose, Region, ResolveOpts, Ring, Seg, SendPayload, Shape, SoundClip, SpinDir, StateAnchor, StateMachine, Stop, Stroke, Subpath, SymbolDef, Text, TextPath, Timeline, TimelineTrack, Tint, Tool, Transform };
+export type { Action, Asset, BBox, BindChannel, BlendMode, Cel, ChannelModifier, ClipRect, ContentKey, ContentTrack, Doc, Easing, EditFrame, ExprChannel, ExprContext, Filter, Folder, FrameAction, FrameLabel, FuncDef, Group, Image, Instance, InstanceBind, InstancePlayback, Interaction, Interactor, Item, ItemEvent, ItemInteractionState, Keyframe, Layer, OffsetChannel, Paint, ParamDef, ParamType, Path, PlaybackMode, Point, PolyGroup, Polygon, Pose, Region, ResolveOpts, Ring, Seg, SendPayload, Shape, SoundClip, SpinDir, StateAnchor, StateMachine, Stop, Stroke, Subpath, SymbolDef, Text, TextPath, Timeline, TimelineTrack, Tint, Tool, Transform };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@flatkit/types",
-  "version": "0.19.12",
+  "version": "0.20.1",
   "description": "Shared types for the FlatInk format (Doc, Layer, Item, …). The leaf of the dependency graph.",
   "license": "MIT",
   "author": "Zwyk Studio",