From e37fb3e5cad3ee3fb2e0105463bd419774b58bd2 Mon Sep 17 00:00:00 2001
From: Florin Malita <fmalita@gmail.com>
Date: Tue, 16 Jul 2024 16:11:39 -0400
Subject: [PATCH] Add time remap specs (#56)

---
 docs/specs/layers.md                    |  114 +++
 docs/static/examples/time_remap.json    | 1090 +++++++++++++++++++++++
 schema/layers/precomposition-layer.json |    5 +
 3 files changed, 1209 insertions(+)
 create mode 100644 docs/static/examples/time_remap.json

diff --git a/docs/specs/layers.md b/docs/specs/layers.md
index b9f56f1..1cb706e 100644
--- a/docs/specs/layers.md
+++ b/docs/specs/layers.md
@@ -87,6 +87,8 @@ In this example there's a layer with a rectangle and a star being masked by an e
 
 {schema_object:layers/precomposition-layer}
 
+<h4 id="precomposition-time-stretch">Time Stretch</h4>
+
 The `st` property specifies a start time offset, while `sr` defines a time stretch factor,
 to be applied when evaluating animated properties pertaining to the layer:
 
@@ -107,3 +109,115 @@ decrease it ("stretching" the layer timeline).
     </script>
 </lottie-playground>
 
+<h4 id="precomposition-time-remap">Time Remap</h4>
+
+The `tm` property specifies a time remap function as an animatable property, allowing full control
+over the precomp timeline (subset, speedup/slowdown, reverse, frame-freeze, or any other arbitrary
+transformation).
+
+It maps the current layer time (in the frame index $[ip \ldots op]$ domain) to a precomp time
+expressed in seconds, and evaluates all animatable precomp properties based on the new time value:
+
+$$tm \colon \left[ip \ldots op\right] \mapsto seconds$$
+$$t\prime = tm(t) \cdot FPS$$
+
+Note: the global frame rate factor $FPS$ ([Animation](composition.md#Animation) `fr` property) is
+required to convert back into the frame index domain.
+
+When both time stretch (`sr`) and time remap (`tm`) are specified, time stretch is applied first.
+
+
+<lottie-playground example="time_remap.json">
+    <title>Example</title>
+    <form>
+        <select title="Time Remap">
+            <option value="0">Linear</option>
+            <option value="1">Reverse</option>
+            <option value="2">Subset</option>
+            <option value="3">Discrete</option>
+            <option value="4">Easing 1</option>
+            <option value="5">Easing 2</option>
+            <option value="6">Easing-Reverse</option>
+        </select>
+    </form>
+    <json>lottie.layers[1].tm</json>
+    <script>
+        const time_maps = [
+            { 'a': 1, k: [
+                { 't':   0, 's': [ 0], 'o': { 'x': [0], 'y': [0]}, 'i': { 'x': [1], 'y': [1] }},
+                { 't': 600, 's': [10] }
+            ]},
+            { 'a': 1, k: [
+                { 't':   0, 's': [10], 'o': { 'x': [0], 'y': [0]}, 'i': { 'x': [1], 'y': [1] }},
+                { 't': 600, 's': [ 0] }
+            ]},
+            { 'a': 1, k: [
+                { 't':   0, 's': [3], 'o': { 'x': [0], 'y': [0]}, 'i': { 'x': [1], 'y': [1] }},
+                { 't': 600, 's': [7] }
+            ]},
+            { 'a': 1, k: [
+                { 't':   0, 's': [ 0.0], 'o': { 'x': [0], 'y': [0]}, 'i': { 'x': [1], 'y': [1] }, 'h': 1 },
+                { 't': 150, 's': [ 2.5], 'o': { 'x': [0], 'y': [0]}, 'i': { 'x': [1], 'y': [1] }, 'h': 1 },
+                { 't': 300, 's': [ 5.0], 'o': { 'x': [0], 'y': [0]}, 'i': { 'x': [1], 'y': [1] }, 'h': 1 },
+                { 't': 450, 's': [ 7.5], 'o': { 'x': [0], 'y': [0]}, 'i': { 'x': [1], 'y': [1] }, 'h': 1 },
+                { 't': 600, 's': [10.0] }
+            ]},
+            { 'a': 1, k: [
+                { 't':   0, 's': [ 0], 'o': { 'x': [0], 'y': [0.5]}, 'i': { 'x': [0.5], 'y': [1] }},
+                { 't': 600, 's': [10] }
+            ]},
+            { 'a': 1, k: [
+                { 't':   0, 's': [ 0], 'o': { 'x': [0], 'y': [0.5]}, 'i': { 'x': [1], 'y': [0.5] }},
+                { 't': 600, 's': [10] }
+            ]},
+            { 'a': 1, k: [
+                { 't':   0, 's': [ 0], 'o': { 'x': [0.2], 'y': [0]}, 'i': { 'x': [0.8], 'y': [1] }},
+                { 't': 300, 's': [ 7], 'o': { 'x': [0.2], 'y': [0]}, 'i': { 'x': [0.8], 'y': [1] }},
+                { 't': 600, 's': [ 0] }
+            ]},
+        ];
+        const time_paths = [
+            {
+                'v': [[-250, 50], [250, -50]],
+                'o': [[   0,  0], [  0,   0]],
+                'i': [[   0,  0], [  0,   0]],
+                'c': false
+            }, {
+                'v': [[250, 50], [-250, -50]],
+                'o': [[  0,  0], [   0,   0]],
+                'i': [[  0,  0], [   0,   0]],
+                'c': false
+            }, {
+                'v': [[250, 20], [-250, -20]],
+                'o': [[  0,  0], [   0,   0]],
+                'i': [[  0,  0], [   0,   0]],
+                'c': false
+            }, {
+                'v': [[-250, 50], [-125, 50], [-125, 25], [0, 25], [0, 0], [125, 0], [125, -25], [250, -25]],
+                'o': [[   0,  0], [  0,   0], [   0,  0], [0,  0], [0, 0], [  0, 0], [  0,   0], [  0,   0]],
+                'i': [[   0,  0], [  0,   0], [   0,  0], [0,  0], [0, 0], [  0, 0], [  0,   0], [  0,   0]],
+                'c': false
+            }, {
+                'v': [[-250,  50], [ 250, -50]],
+                'o': [[   0, -50], [   0,   0]],
+                'i': [[   0,   0], [-250,   0]],
+                'c': false
+            }, {
+                'v': [[-250,  50], [250, -50]],
+                'o': [[   0, -50], [  0,   0]],
+                'i': [[   0,   0], [  0,  50]],
+                'c': false
+            }, {
+                'v': [[-250, 50], [   0, -20], [ 250, 50]],
+                'o': [[ 100,  0], [ 100,   0], [   0,  0]],
+                'i': [[   0,  0], [-100,   0], [-100,  0]],
+                'c': false
+            },
+        ];
+        const sample_index = data["Time Remap"];
+        const precomp_layer = lottie.layers[1];
+        precomp_layer.tm = time_maps[sample_index];
+        const time_shape = lottie.layers[0].shapes[1].it[0];
+        time_shape.ks.k = time_paths[sample_index];
+    </script>
+</lottie-playground>
diff --git a/docs/static/examples/time_remap.json b/docs/static/examples/time_remap.json
new file mode 100644
index 0000000..cf68d0a
--- /dev/null
+++ b/docs/static/examples/time_remap.json
@@ -0,0 +1,1090 @@
+{
+    "v": "5.12.0",
+    "fr": 60,
+    "ip": 0,
+    "op": 600,
+    "w": 500,
+    "h": 500,
+    "nm": "time_remap",
+    "ddd": 0,
+    "assets": [
+        {
+            "id": "comp_0",
+            "nm": "time_remap_precomp",
+            "fr": 60,
+            "layers": [
+                {
+                    "ddd": 0,
+                    "ind": 1,
+                    "ty": 4,
+                    "nm": "Shape Layer 1",
+                    "sr": 1,
+                    "ks": {
+                        "o": {
+                            "a": 0,
+                            "k": 100,
+                            "ix": 11
+                        },
+                        "r": {
+                            "a": 0,
+                            "k": 0,
+                            "ix": 10
+                        },
+                        "p": {
+                            "a": 0,
+                            "k": [
+                                250,
+                                250,
+                                0
+                            ],
+                            "ix": 2,
+                            "l": 2
+                        },
+                        "a": {
+                            "a": 0,
+                            "k": [
+                                0,
+                                0,
+                                0
+                            ],
+                            "ix": 1,
+                            "l": 2
+                        },
+                        "s": {
+                            "a": 0,
+                            "k": [
+                                100,
+                                100,
+                                100
+                            ],
+                            "ix": 6,
+                            "l": 2
+                        }
+                    },
+                    "ao": 0,
+                    "shapes": [
+                        {
+                            "ty": "gr",
+                            "it": [
+                                {
+                                    "d": 1,
+                                    "ty": "el",
+                                    "s": {
+                                        "a": 0,
+                                        "k": [
+                                            100,
+                                            100
+                                        ],
+                                        "ix": 2
+                                    },
+                                    "p": {
+                                        "a": 0,
+                                        "k": [
+                                            0,
+                                            0
+                                        ],
+                                        "ix": 3
+                                    },
+                                    "nm": "Ellipse Path 1",
+                                    "mn": "ADBE Vector Shape - Ellipse",
+                                    "hd": false
+                                },
+                                {
+                                    "ty": "st",
+                                    "c": {
+                                        "a": 0,
+                                        "k": [
+                                            0,
+                                            0.858823537827,
+                                            0,
+                                            1
+                                        ],
+                                        "ix": 3
+                                    },
+                                    "o": {
+                                        "a": 0,
+                                        "k": 100,
+                                        "ix": 4
+                                    },
+                                    "w": {
+                                        "a": 0,
+                                        "k": 7,
+                                        "ix": 5
+                                    },
+                                    "lc": 1,
+                                    "lj": 1,
+                                    "ml": 5,
+                                    "bm": 0,
+                                    "d": [
+                                        {
+                                            "n": "d",
+                                            "nm": "dash",
+                                            "v": {
+                                                "a": 0,
+                                                "k": 4.5,
+                                                "ix": 1
+                                            }
+                                        },
+                                        {
+                                            "n": "g",
+                                            "nm": "gap",
+                                            "v": {
+                                                "a": 0,
+                                                "k": 15,
+                                                "ix": 2
+                                            }
+                                        },
+                                        {
+                                            "n": "o",
+                                            "nm": "offset",
+                                            "v": {
+                                                "a": 0,
+                                                "k": 0,
+                                                "ix": 7
+                                            }
+                                        }
+                                    ],
+                                    "nm": "Stroke 1",
+                                    "mn": "ADBE Vector Graphic - Stroke",
+                                    "hd": false
+                                },
+                                {
+                                    "ty": "fl",
+                                    "c": {
+                                        "a": 0,
+                                        "k": [
+                                            1,
+                                            0.266666680574,
+                                            0.270588248968,
+                                            1
+                                        ],
+                                        "ix": 4
+                                    },
+                                    "o": {
+                                        "a": 0,
+                                        "k": 100,
+                                        "ix": 5
+                                    },
+                                    "r": 1,
+                                    "bm": 0,
+                                    "nm": "Fill 1",
+                                    "mn": "ADBE Vector Graphic - Fill",
+                                    "hd": false
+                                },
+                                {
+                                    "ty": "tr",
+                                    "p": {
+                                        "a": 1,
+                                        "k": [
+                                            {
+                                                "i": {
+                                                    "x": 0.833,
+                                                    "y": 0.833
+                                                },
+                                                "o": {
+                                                    "x": 0.167,
+                                                    "y": 0.167
+                                                },
+                                                "t": 0,
+                                                "s": [
+                                                    -250,
+                                                    0
+                                                ],
+                                                "to": [
+                                                    83.333,
+                                                    0
+                                                ],
+                                                "ti": [
+                                                    -83.333,
+                                                    0
+                                                ]
+                                            },
+                                            {
+                                                "t": 599,
+                                                "s": [
+                                                    250,
+                                                    0
+                                                ]
+                                            }
+                                        ],
+                                        "ix": 2
+                                    },
+                                    "a": {
+                                        "a": 0,
+                                        "k": [
+                                            0,
+                                            0
+                                        ],
+                                        "ix": 1
+                                    },
+                                    "s": {
+                                        "a": 0,
+                                        "k": [
+                                            100,
+                                            100
+                                        ],
+                                        "ix": 3
+                                    },
+                                    "r": {
+                                        "a": 1,
+                                        "k": [
+                                            {
+                                                "i": {
+                                                    "x": [
+                                                        0.833
+                                                    ],
+                                                    "y": [
+                                                        0.833
+                                                    ]
+                                                },
+                                                "o": {
+                                                    "x": [
+                                                        0.167
+                                                    ],
+                                                    "y": [
+                                                        0.167
+                                                    ]
+                                                },
+                                                "t": 0,
+                                                "s": [
+                                                    0
+                                                ]
+                                            },
+                                            {
+                                                "t": 599,
+                                                "s": [
+                                                    540
+                                                ]
+                                            }
+                                        ],
+                                        "ix": 6
+                                    },
+                                    "o": {
+                                        "a": 0,
+                                        "k": 100,
+                                        "ix": 7
+                                    },
+                                    "sk": {
+                                        "a": 0,
+                                        "k": 0,
+                                        "ix": 4
+                                    },
+                                    "sa": {
+                                        "a": 0,
+                                        "k": 0,
+                                        "ix": 5
+                                    },
+                                    "nm": "Transform"
+                                }
+                            ],
+                            "nm": "Group 1",
+                            "np": 3,
+                            "cix": 2,
+                            "bm": 0,
+                            "ix": 1,
+                            "mn": "ADBE Vector Group",
+                            "hd": false
+                        },
+                        {
+                            "ty": "gr",
+                            "it": [
+                                {
+                                    "ty": "rc",
+                                    "d": 1,
+                                    "s": {
+                                        "a": 0,
+                                        "k": [
+                                            500,
+                                            5
+                                        ],
+                                        "ix": 2
+                                    },
+                                    "p": {
+                                        "a": 0,
+                                        "k": [
+                                            0,
+                                            50
+                                        ],
+                                        "ix": 3
+                                    },
+                                    "r": {
+                                        "a": 0,
+                                        "k": 0,
+                                        "ix": 4
+                                    },
+                                    "nm": "Rectangle Path 1",
+                                    "mn": "ADBE Vector Shape - Rect",
+                                    "hd": false
+                                },
+                                {
+                                    "ty": "fl",
+                                    "c": {
+                                        "a": 0,
+                                        "k": [
+                                            0,
+                                            0,
+                                            0,
+                                            1
+                                        ],
+                                        "ix": 4
+                                    },
+                                    "o": {
+                                        "a": 0,
+                                        "k": 100,
+                                        "ix": 5
+                                    },
+                                    "r": 1,
+                                    "bm": 0,
+                                    "nm": "Fill 1",
+                                    "mn": "ADBE Vector Graphic - Fill",
+                                    "hd": false
+                                },
+                                {
+                                    "ty": "tr",
+                                    "p": {
+                                        "a": 0,
+                                        "k": [
+                                            0,
+                                            0
+                                        ],
+                                        "ix": 2
+                                    },
+                                    "a": {
+                                        "a": 0,
+                                        "k": [
+                                            0,
+                                            0
+                                        ],
+                                        "ix": 1
+                                    },
+                                    "s": {
+                                        "a": 0,
+                                        "k": [
+                                            100,
+                                            100
+                                        ],
+                                        "ix": 3
+                                    },
+                                    "r": {
+                                        "a": 0,
+                                        "k": 0,
+                                        "ix": 6
+                                    },
+                                    "o": {
+                                        "a": 0,
+                                        "k": 100,
+                                        "ix": 7
+                                    },
+                                    "sk": {
+                                        "a": 0,
+                                        "k": 0,
+                                        "ix": 4
+                                    },
+                                    "sa": {
+                                        "a": 0,
+                                        "k": 0,
+                                        "ix": 5
+                                    },
+                                    "nm": "Transform"
+                                }
+                            ],
+                            "nm": "Group 3",
+                            "np": 2,
+                            "cix": 2,
+                            "bm": 0,
+                            "ix": 2,
+                            "mn": "ADBE Vector Group",
+                            "hd": false
+                        },
+                        {
+                            "ty": "gr",
+                            "it": [
+                                {
+                                    "ty": "rc",
+                                    "d": 1,
+                                    "s": {
+                                        "a": 0,
+                                        "k": [
+                                            500,
+                                            200
+                                        ],
+                                        "ix": 2
+                                    },
+                                    "p": {
+                                        "a": 0,
+                                        "k": [
+                                            0,
+                                            0
+                                        ],
+                                        "ix": 3
+                                    },
+                                    "r": {
+                                        "a": 0,
+                                        "k": 0,
+                                        "ix": 4
+                                    },
+                                    "nm": "Rectangle Path 1",
+                                    "mn": "ADBE Vector Shape - Rect",
+                                    "hd": false
+                                },
+                                {
+                                    "ty": "fl",
+                                    "c": {
+                                        "a": 0,
+                                        "k": [
+                                            1,
+                                            1,
+                                            1,
+                                            1
+                                        ],
+                                        "ix": 4
+                                    },
+                                    "o": {
+                                        "a": 0,
+                                        "k": 100,
+                                        "ix": 5
+                                    },
+                                    "r": 1,
+                                    "bm": 0,
+                                    "nm": "Fill 1",
+                                    "mn": "ADBE Vector Graphic - Fill",
+                                    "hd": false
+                                },
+                                {
+                                    "ty": "tr",
+                                    "p": {
+                                        "a": 0,
+                                        "k": [
+                                            0,
+                                            0
+                                        ],
+                                        "ix": 2
+                                    },
+                                    "a": {
+                                        "a": 0,
+                                        "k": [
+                                            0,
+                                            0
+                                        ],
+                                        "ix": 1
+                                    },
+                                    "s": {
+                                        "a": 0,
+                                        "k": [
+                                            100,
+                                            100
+                                        ],
+                                        "ix": 3
+                                    },
+                                    "r": {
+                                        "a": 0,
+                                        "k": 0,
+                                        "ix": 6
+                                    },
+                                    "o": {
+                                        "a": 0,
+                                        "k": 100,
+                                        "ix": 7
+                                    },
+                                    "sk": {
+                                        "a": 0,
+                                        "k": 0,
+                                        "ix": 4
+                                    },
+                                    "sa": {
+                                        "a": 0,
+                                        "k": 0,
+                                        "ix": 5
+                                    },
+                                    "nm": "Transform"
+                                }
+                            ],
+                            "nm": "Group 2",
+                            "np": 2,
+                            "cix": 2,
+                            "bm": 0,
+                            "ix": 3,
+                            "mn": "ADBE Vector Group",
+                            "hd": false
+                        }
+                    ],
+                    "ip": 0,
+                    "op": 600,
+                    "st": 0,
+                    "ct": 1,
+                    "bm": 0
+                }
+            ]
+        }
+    ],
+    "layers": [
+        {
+            "ddd": 0,
+            "ind": 1,
+            "ty": 4,
+            "nm": "Shape Layer 1",
+            "sr": 1,
+            "ks": {
+                "o": {
+                    "a": 0,
+                    "k": 100,
+                    "ix": 11
+                },
+                "r": {
+                    "a": 0,
+                    "k": 0,
+                    "ix": 10
+                },
+                "p": {
+                    "a": 0,
+                    "k": [
+                        250,
+                        350,
+                        0
+                    ],
+                    "ix": 2,
+                    "l": 2
+                },
+                "a": {
+                    "a": 0,
+                    "k": [
+                        0,
+                        0,
+                        0
+                    ],
+                    "ix": 1,
+                    "l": 2
+                },
+                "s": {
+                    "a": 0,
+                    "k": [
+                        100,
+                        100,
+                        100
+                    ],
+                    "ix": 6,
+                    "l": 2
+                }
+            },
+            "ao": 0,
+            "shapes": [
+                {
+                    "ty": "gr",
+                    "it": [
+                        {
+                            "ty": "rc",
+                            "d": 1,
+                            "s": {
+                                "a": 0,
+                                "k": [
+                                    2,
+                                    120
+                                ],
+                                "ix": 2
+                            },
+                            "p": {
+                                "a": 1,
+                                "k": [
+                                    {
+                                        "i": {
+                                            "x": 0.833,
+                                            "y": 0.833
+                                        },
+                                        "o": {
+                                            "x": 0.167,
+                                            "y": 0.167
+                                        },
+                                        "t": 0,
+                                        "s": [
+                                            -250,
+                                            0
+                                        ],
+                                        "to": [
+                                            83.333,
+                                            0
+                                        ],
+                                        "ti": [
+                                            -83.333,
+                                            0
+                                        ]
+                                    },
+                                    {
+                                        "t": 599,
+                                        "s": [
+                                            250,
+                                            0
+                                        ]
+                                    }
+                                ],
+                                "ix": 3
+                            },
+                            "r": {
+                                "a": 0,
+                                "k": 0,
+                                "ix": 4
+                            },
+                            "nm": "Rectangle Path 1",
+                            "mn": "ADBE Vector Shape - Rect",
+                            "hd": false
+                        },
+                        {
+                            "ty": "fl",
+                            "c": {
+                                "a": 0,
+                                "k": [
+                                    1,
+                                    0,
+                                    0,
+                                    1
+                                ],
+                                "ix": 4
+                            },
+                            "o": {
+                                "a": 0,
+                                "k": 100,
+                                "ix": 5
+                            },
+                            "r": 1,
+                            "bm": 0,
+                            "nm": "Fill 1",
+                            "mn": "ADBE Vector Graphic - Fill",
+                            "hd": false
+                        },
+                        {
+                            "ty": "tr",
+                            "p": {
+                                "a": 0,
+                                "k": [
+                                    0,
+                                    0
+                                ],
+                                "ix": 2
+                            },
+                            "a": {
+                                "a": 0,
+                                "k": [
+                                    0,
+                                    0
+                                ],
+                                "ix": 1
+                            },
+                            "s": {
+                                "a": 0,
+                                "k": [
+                                    100,
+                                    100
+                                ],
+                                "ix": 3
+                            },
+                            "r": {
+                                "a": 0,
+                                "k": 0,
+                                "ix": 6
+                            },
+                            "o": {
+                                "a": 0,
+                                "k": 100,
+                                "ix": 7
+                            },
+                            "sk": {
+                                "a": 0,
+                                "k": 0,
+                                "ix": 4
+                            },
+                            "sa": {
+                                "a": 0,
+                                "k": 0,
+                                "ix": 5
+                            },
+                            "nm": "Transform"
+                        }
+                    ],
+                    "nm": "Group 3",
+                    "np": 2,
+                    "cix": 2,
+                    "bm": 0,
+                    "ix": 1,
+                    "mn": "ADBE Vector Group",
+                    "hd": false
+                },
+                {
+                    "ty": "gr",
+                    "it": [
+                        {
+                            "ind": 0,
+                            "ty": "sh",
+                            "ix": 1,
+                            "ks": {
+                                "a": 0,
+                                "k": {
+                                    "i": [
+                                        [
+                                            0,
+                                            0
+                                        ],
+                                        [
+                                            0,
+                                            0
+                                        ],
+                                        [
+                                            0,
+                                            0
+                                        ]
+                                    ],
+                                    "o": [
+                                        [
+                                            0,
+                                            0
+                                        ],
+                                        [
+                                            0,
+                                            0
+                                        ],
+                                        [
+                                            0,
+                                            0
+                                        ]
+                                    ],
+                                    "v": [
+                                        [
+                                            -229.358,
+                                            0.147
+                                        ],
+                                        [
+                                            5.161,
+                                            0.72
+                                        ],
+                                        [
+                                            204.128,
+                                            2.44
+                                        ]
+                                    ],
+                                    "c": false
+                                },
+                                "ix": 2
+                            },
+                            "nm": "Path 1",
+                            "mn": "ADBE Vector Shape - Group",
+                            "hd": false
+                        },
+                        {
+                            "ty": "st",
+                            "c": {
+                                "a": 0,
+                                "k": [
+                                    0,
+                                    0.470588237047,
+                                    0,
+                                    1
+                                ],
+                                "ix": 3
+                            },
+                            "o": {
+                                "a": 0,
+                                "k": 100,
+                                "ix": 4
+                            },
+                            "w": {
+                                "a": 0,
+                                "k": 2,
+                                "ix": 5
+                            },
+                            "lc": 1,
+                            "lj": 1,
+                            "ml": 4,
+                            "bm": 0,
+                            "nm": "Stroke 1",
+                            "mn": "ADBE Vector Graphic - Stroke",
+                            "hd": false
+                        },
+                        {
+                            "ty": "tr",
+                            "p": {
+                                "a": 0,
+                                "k": [
+                                    0,
+                                    0
+                                ],
+                                "ix": 2
+                            },
+                            "a": {
+                                "a": 0,
+                                "k": [
+                                    0,
+                                    0
+                                ],
+                                "ix": 1
+                            },
+                            "s": {
+                                "a": 0,
+                                "k": [
+                                    100,
+                                    100
+                                ],
+                                "ix": 3
+                            },
+                            "r": {
+                                "a": 0,
+                                "k": 0,
+                                "ix": 6
+                            },
+                            "o": {
+                                "a": 0,
+                                "k": 100,
+                                "ix": 7
+                            },
+                            "sk": {
+                                "a": 0,
+                                "k": 0,
+                                "ix": 4
+                            },
+                            "sa": {
+                                "a": 0,
+                                "k": 0,
+                                "ix": 5
+                            },
+                            "nm": "Transform"
+                        }
+                    ],
+                    "nm": "Group 1",
+                    "np": 2,
+                    "cix": 2,
+                    "bm": 0,
+                    "ix": 2,
+                    "mn": "ADBE Vector Group",
+                    "hd": false
+                },
+                {
+                    "ty": "gr",
+                    "it": [
+                        {
+                            "ty": "rc",
+                            "d": 1,
+                            "s": {
+                                "a": 0,
+                                "k": [
+                                    500,
+                                    100
+                                ],
+                                "ix": 2
+                            },
+                            "p": {
+                                "a": 0,
+                                "k": [
+                                    0,
+                                    0
+                                ],
+                                "ix": 3
+                            },
+                            "r": {
+                                "a": 0,
+                                "k": 0,
+                                "ix": 4
+                            },
+                            "nm": "Rectangle Path 1",
+                            "mn": "ADBE Vector Shape - Rect",
+                            "hd": false
+                        },
+                        {
+                            "ty": "fl",
+                            "c": {
+                                "a": 0,
+                                "k": [
+                                    0.917647063732,
+                                    0.917647063732,
+                                    0.705882370472,
+                                    1
+                                ],
+                                "ix": 4
+                            },
+                            "o": {
+                                "a": 0,
+                                "k": 100,
+                                "ix": 5
+                            },
+                            "r": 1,
+                            "bm": 0,
+                            "nm": "Fill 1",
+                            "mn": "ADBE Vector Graphic - Fill",
+                            "hd": false
+                        },
+                        {
+                            "ty": "tr",
+                            "p": {
+                                "a": 0,
+                                "k": [
+                                    0,
+                                    0
+                                ],
+                                "ix": 2
+                            },
+                            "a": {
+                                "a": 0,
+                                "k": [
+                                    0,
+                                    0
+                                ],
+                                "ix": 1
+                            },
+                            "s": {
+                                "a": 0,
+                                "k": [
+                                    100,
+                                    100
+                                ],
+                                "ix": 3
+                            },
+                            "r": {
+                                "a": 0,
+                                "k": 0,
+                                "ix": 6
+                            },
+                            "o": {
+                                "a": 0,
+                                "k": 100,
+                                "ix": 7
+                            },
+                            "sk": {
+                                "a": 0,
+                                "k": 0,
+                                "ix": 4
+                            },
+                            "sa": {
+                                "a": 0,
+                                "k": 0,
+                                "ix": 5
+                            },
+                            "nm": "Transform"
+                        }
+                    ],
+                    "nm": "Group 2",
+                    "np": 2,
+                    "cix": 2,
+                    "bm": 0,
+                    "ix": 3,
+                    "mn": "ADBE Vector Group",
+                    "hd": false
+                }
+            ],
+            "ip": 0,
+            "op": 600,
+            "st": 0,
+            "ct": 1,
+            "bm": 0
+        },
+        {
+            "ddd": 0,
+            "ind": 2,
+            "ty": 0,
+            "nm": "time_remap_precomp",
+            "refId": "comp_0",
+            "sr": 1,
+            "ks": {
+                "o": {
+                    "a": 0,
+                    "k": 100,
+                    "ix": 11
+                },
+                "r": {
+                    "a": 0,
+                    "k": 0,
+                    "ix": 10
+                },
+                "p": {
+                    "a": 0,
+                    "k": [
+                        250,
+                        180,
+                        0
+                    ],
+                    "ix": 2,
+                    "l": 2
+                },
+                "a": {
+                    "a": 0,
+                    "k": [
+                        250,
+                        250,
+                        0
+                    ],
+                    "ix": 1,
+                    "l": 2
+                },
+                "s": {
+                    "a": 0,
+                    "k": [
+                        100,
+                        100,
+                        100
+                    ],
+                    "ix": 6,
+                    "l": 2
+                }
+            },
+            "ao": 0,
+            "tm": {
+                "a": 1,
+                "k": [
+                    {
+                        "i": {
+                            "x": [
+                                0.833
+                            ],
+                            "y": [
+                                0.833
+                            ]
+                        },
+                        "o": {
+                            "x": [
+                                0.167
+                            ],
+                            "y": [
+                                0.167
+                            ]
+                        },
+                        "t": 0,
+                        "s": [
+                            0
+                        ]
+                    },
+                    {
+                        "i": {
+                            "x": [
+                                0.833
+                            ],
+                            "y": [
+                                0.833
+                            ]
+                        },
+                        "o": {
+                            "x": [
+                                0.167
+                            ],
+                            "y": [
+                                0.167
+                            ]
+                        },
+                        "t": 120,
+                        "s": [
+                            7
+                        ]
+                    },
+                    {
+                        "t": 600,
+                        "s": [
+                            10
+                        ]
+                    }
+                ],
+                "ix": 2
+            },
+            "w": 500,
+            "h": 500,
+            "ip": 0,
+            "op": 600,
+            "st": 0,
+            "bm": 0
+        }
+    ],
+    "markers": []
+}
diff --git a/schema/layers/precomposition-layer.json b/schema/layers/precomposition-layer.json
index c1815c3..8bce129 100644
--- a/schema/layers/precomposition-layer.json
+++ b/schema/layers/precomposition-layer.json
@@ -40,6 +40,11 @@
                     "title": "Start Time",
                     "type": "number",
                     "default": 0
+                },
+                "tm": {
+                    "title": "Time Remap",
+                    "description": "Timeline remap function (frame index -> time in seconds)",
+                    "$ref": "#/$defs/properties/scalar-property"
                 }
             },
             "required": [