@flatkit/types 0.17.3 → 0.19.0

package/dist/index.d.ts

@@ -45,11 +45,15 @@ type Shape = PolyGroup[];
 type Stop = {
     offset: number;
     color: string;
+    param?: string;
+    alpha?: number;
 };
-/** A Flash-style "tint" color effect: recolors a container toward `color` by `amount` (0..1). */
+/** A Flash-style "tint" color effect: recolors a container toward `color` by `amount` (0..1). `param` (if
+ *  set) binds the tint hue to a symbol COLOR param, resolved per instance at render (else the literal `color`). */
 type Tint = {
     color: string;
     amount: number;
+    param?: string;
 };
 /** Blend mode (Flash / After Effects style). `add`/`screen` = additive light (glow, mixing); `multiply` = shadow. */
 type BlendMode = 'add' | 'screen' | 'multiply';
@@ -164,12 +168,25 @@ type InstanceBind = {
     as: string;
     expr: Partial<Record<ExprChannel, string>>;
 };
-type PlaybackMode = 'synced' | 'singleFrame' | 'independent';
+/**
+ * How a nested instance's OWN timeline advances (Flash's symbol-instance models):
+ *  - `synced`      — Graphic symbol: the local frame DERIVES from the ancestor's (a slave clock). Scrubbed
+ *                    and TRUNCATED by the parent (looped within [0,duration)). The default — deterministic,
+ *                    lip-sync / editor scrub friendly.
+ *  - `independent` — MovieClip: an INDEPENDENT clock. The playhead is driven by the runtime's monotone
+ *                    heartbeat (`mono`), looped on the instance's OWN duration, immune to any ancestor's
+ *                    loop length. For state-loops / idles that must keep their phase across the parent's wrap.
+ *  - `once`        — like `independent` but CLAMPED to [0, duration-1]: plays through once, then HOLDS the
+ *                    last frame forever (a one-shot: a splash, an explosion, a "fried" pose that stays fried).
+ *  - `singleFrame` — frozen on a fixed `frame` (a dead pose).
+ */
+type PlaybackMode = 'synced' | 'singleFrame' | 'independent' | 'once';
 type InstancePlayback = {
     mode: PlaybackMode;
     frame?: number;
     speed?: number;
     loop?: boolean;
+    startFrame?: number;
 };
 /**
  * Payload of a `send`: numeric (DSL expression) or textual (`text("itemId")`, the live content of a

package/package.json

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