@flatkit/types 0.17.2 → 0.18.0

package/dist/index.d.ts

@@ -164,12 +164,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.2",
+  "version": "0.18.0",
   "description": "Shared types for the FlatInk format (Doc, Layer, Item, …). The leaf of the dependency graph.",
   "license": "MIT",
   "author": "Zwyk Studio",