# lsdtools.timeline reference
URL: https://lsd.tools/docs/sdk-lsdtools-timeline
Updated: 2026-09-09

SDK distribution **1.0.0**; API contract **1.0**; generator **1.0.0**.

Product source digest: `4ea39055732e8883c03ccfecf12af6ccebd2041a12ce1b843e4a769e200f5ef9`.

Generated from declared public exports and source syntax. Signatures and annotations are declaration spellings; decorators, factories and annotations are never executed. Class members below are declared members; base classes remain explicit. Source docstrings describe their owning implementation; they do not grant app permissions.

```text
Lazy headless timeline API for authorized package track providers.

Importing this facade creates no scene, provider, UI or runtime thread. Track
declarations live in ``lsdtools.extend``; this facade owns their execution seam.
```


## `lsdtools.timeline.BuildTimeline`

Kind: class. Source: `services/runtime/src/lsd_runtime/timeline/steps.py:20`.

Source docstring:

```text
Build a timeline component from one project-authored document.

Editors stage replacement ``document`` values through the host's normal
Configurable edit coordinator. This step has no private edit history and
never discovers neighboring files or constructs a track provider.
```


Implementation alias: `lsd_runtime.timeline.steps.BuildTimeline`.

Declared bases: `LoadStep`.

### `lsdtools.timeline.BuildTimeline.output_ports`

Kind: attribute. Source: `services/runtime/src/lsd_runtime/timeline/steps.py:28`.

```python
output_ports = ['timeline']
```


### `lsdtools.timeline.BuildTimeline.cache_pin`

Kind: attribute. Source: `services/runtime/src/lsd_runtime/timeline/steps.py:29`.

```python
cache_pin = 'lsd-runtime-timeline-v1'
```


### `lsdtools.timeline.BuildTimeline.document`

Kind: attribute. Source: `services/runtime/src/lsd_runtime/timeline/steps.py:30`.

```python
document = param(dict, default_factory=lambda: {'version': 1, 'instances': []}, required=True, label='Timeline document', validators=[_validate_document], description='Version 1 sequence assets and their named instance bindings.')
```


### `lsdtools.timeline.BuildTimeline.run`

Kind: method. Source: `services/runtime/src/lsd_runtime/timeline/steps.py:34`.

```python
run(self) -> StepOutputs
```


```python
self: (unannotated)
```


## `lsdtools.timeline.EventIntent`

Kind: class. Source: `services/runtime/src/lsd_runtime/timeline/evaluation.py:91`.

Source docstring:

```text
Inspection/admission data only: producing this object never calls a handler.

Targets are data identifiers, not admitted entity handles. The consuming
command adapter must validate target existence and authority. No command
journal, dispatch, checkpoint or replay authority is implied.
```


Implementation alias: `lsd_runtime.timeline.evaluation.EventIntent`.

### `lsdtools.timeline.EventIntent.instance_id`

Kind: attribute. Source: `services/runtime/src/lsd_runtime/timeline/evaluation.py:99`.

```python
instance_id: str
```


### `lsdtools.timeline.EventIntent.marker_id`

Kind: attribute. Source: `services/runtime/src/lsd_runtime/timeline/evaluation.py:100`.

```python
marker_id: str
```


### `lsdtools.timeline.EventIntent.event`

Kind: attribute. Source: `services/runtime/src/lsd_runtime/timeline/evaluation.py:101`.

```python
event: str
```


### `lsdtools.timeline.EventIntent.target`

Kind: attribute. Source: `services/runtime/src/lsd_runtime/timeline/evaluation.py:102`.

```python
target: int | str
```


### `lsdtools.timeline.EventIntent.tick`

Kind: attribute. Source: `services/runtime/src/lsd_runtime/timeline/evaluation.py:103`.

```python
tick: int
```


### `lsdtools.timeline.EventIntent.payload`

Kind: attribute. Source: `services/runtime/src/lsd_runtime/timeline/evaluation.py:104`.

```python
payload: Any
```


## `lsdtools.timeline.PreparedSequence`

Kind: class. Source: `services/runtime/src/lsd_runtime/timeline/evaluation.py:133`.

```python
PreparedSequence(self, asset: SequenceAsset, instance_id: str, scope: Any, generation: Any, providers: tuple, outputs: tuple, intents: tuple, bindings: dict) -> None
```


Source docstring:

```text
One independent forward cursor over immutable data and resolved providers.

``sample`` is read-only arbitrary-time inspection. ``advance`` writes exactly
one subsequent transition and returns only that transition's event intents.
This cursor is not a resumable world checkpoint. Close/reset requires a fresh
instance. Changes to a referenced provider's declarations or activation retire
the plan; unrelated view/catalog activity leaves it running.
```


Implementation alias: `lsd_runtime.timeline.evaluation.PreparedSequence`.

### `lsdtools.timeline.PreparedSequence.__init__`

Kind: method. Source: `services/runtime/src/lsd_runtime/timeline/evaluation.py:143`.

```python
__init__(self, asset: SequenceAsset, instance_id: str, scope: Any, generation: Any, providers: tuple, outputs: tuple, intents: tuple, bindings: dict) -> None
```


```python
asset: SequenceAsset
bindings: dict
generation: Any
instance_id: str
intents: tuple
outputs: tuple
providers: tuple
scope: Any
self: (unannotated)
```


### `lsdtools.timeline.PreparedSequence.tick`

Kind: method. Source: `services/runtime/src/lsd_runtime/timeline/evaluation.py:174`.

```python
tick(self) -> int
```


```python
self: (unannotated)
```


### `lsdtools.timeline.PreparedSequence.write_keys`

Kind: method. Source: `services/runtime/src/lsd_runtime/timeline/evaluation.py:178`.

```python
write_keys(self) -> tuple[tuple[str, ...], ...]
```


```python
self: (unannotated)
```


### `lsdtools.timeline.PreparedSequence.check_current`

Kind: method. Source: `services/runtime/src/lsd_runtime/timeline/evaluation.py:181`.

```python
check_current(self) -> None
```


```python
self: (unannotated)
```


### `lsdtools.timeline.PreparedSequence.sample`

Kind: method. Source: `services/runtime/src/lsd_runtime/timeline/evaluation.py:188`.

```python
sample(self, tick: int) -> tuple[PropertySample, ...]
```


```python
self: (unannotated)
tick: int
```


Source docstring:

```text
Sample without writing properties, moving the cursor, or emitting events.
```


### `lsdtools.timeline.PreparedSequence.apply_initial`

Kind: method. Source: `services/runtime/src/lsd_runtime/timeline/evaluation.py:208`.

```python
apply_initial(self) -> None
```


```python
self: (unannotated)
```


### `lsdtools.timeline.PreparedSequence.advance`

Kind: method. Source: `services/runtime/src/lsd_runtime/timeline/evaluation.py:214`.

```python
advance(self, tick: int) -> tuple[EventIntent, ...]
```


```python
self: (unannotated)
tick: int
```


### `lsdtools.timeline.PreparedSequence.state_hash`

Kind: method. Source: `services/runtime/src/lsd_runtime/timeline/evaluation.py:225`.

```python
state_hash(self) -> int
```


```python
self: (unannotated)
```


### `lsdtools.timeline.PreparedSequence.checkpoint_validate`

Kind: method. Source: `services/runtime/src/lsd_runtime/timeline/evaluation.py:231`.

```python
checkpoint_validate(self, state_owners: tuple[Any, ...]) -> None
```


```python
self: (unannotated)
state_owners: tuple[Any, ...]
```


Source docstring:

```text
Require every bound adapter's state to belong to qualified world owners.
```


### `lsdtools.timeline.PreparedSequence.capture_cursor`

Kind: method. Source: `services/runtime/src/lsd_runtime/timeline/evaluation.py:241`.

```python
capture_cursor(self) -> SequenceCursor
```


```python
self: (unannotated)
```


### `lsdtools.timeline.PreparedSequence.validate_cursor`

Kind: method. Source: `services/runtime/src/lsd_runtime/timeline/evaluation.py:245`.

```python
validate_cursor(self, cursor: SequenceCursor) -> None
```


```python
cursor: SequenceCursor
self: (unannotated)
```


### `lsdtools.timeline.PreparedSequence.restore_cursor`

Kind: method. Source: `services/runtime/src/lsd_runtime/timeline/evaluation.py:250`.

```python
restore_cursor(self, cursor: SequenceCursor) -> None
```


```python
cursor: SequenceCursor
self: (unannotated)
```


### `lsdtools.timeline.PreparedSequence.close`

Kind: method. Source: `services/runtime/src/lsd_runtime/timeline/evaluation.py:254`.

```python
close(self) -> None
```


```python
self: (unannotated)
```


### `lsdtools.timeline.PreparedSequence.asset`

Kind: attribute. Source: `services/runtime/src/lsd_runtime/timeline/evaluation.py:146`.

```python
asset: SequenceAsset
```


```python
asset = asset
```


### `lsdtools.timeline.PreparedSequence.instance_id`

Kind: attribute. Source: `services/runtime/src/lsd_runtime/timeline/evaluation.py:147`.

```python
instance_id: str
```


```python
instance_id = instance_id
```


## `lsdtools.timeline.PropertyBinding`

Kind: class. Source: `services/runtime/src/lsd_runtime/timeline/evaluation.py:62`.

Source docstring:

```text
One resolved writer. Keys identify the actual resource, including aliases.

An authorized provider resolves this once. ``write`` must be bounded, perform
no I/O, and accept every value of the declared type without partial failure.
Ownership covers the prepared instance's lifetime; ``close`` releases it.
```


Implementation alias: `lsd_runtime.timeline.evaluation.PropertyBinding`.

### `lsdtools.timeline.PropertyBinding.key`

Kind: attribute. Source: `services/runtime/src/lsd_runtime/timeline/evaluation.py:70`.

```python
key: tuple[str, ...]
```


### `lsdtools.timeline.PropertyBinding.value`

Kind: attribute. Source: `services/runtime/src/lsd_runtime/timeline/evaluation.py:71`.

```python
value: TimelineValueSpec
```


### `lsdtools.timeline.PropertyBinding.write`

Kind: attribute. Source: `services/runtime/src/lsd_runtime/timeline/evaluation.py:72`.

```python
write: Callable[[Any], None]
```


## `lsdtools.timeline.PropertySample`

Kind: class. Source: `services/runtime/src/lsd_runtime/timeline/evaluation.py:84`.

Implementation alias: `lsd_runtime.timeline.evaluation.PropertySample`.

### `lsdtools.timeline.PropertySample.track_id`

Kind: attribute. Source: `services/runtime/src/lsd_runtime/timeline/evaluation.py:85`.

```python
track_id: str
```


### `lsdtools.timeline.PropertySample.key`

Kind: attribute. Source: `services/runtime/src/lsd_runtime/timeline/evaluation.py:86`.

```python
key: tuple[str, ...]
```


### `lsdtools.timeline.PropertySample.value`

Kind: attribute. Source: `services/runtime/src/lsd_runtime/timeline/evaluation.py:87`.

```python
value: Any
```


## `lsdtools.timeline.ProviderStateParticipation`

Kind: class. Source: `services/runtime/src/lsd_runtime/timeline/evaluation.py:20`.

Source docstring:

```text
A prepared adapter has no private state outside its named world owners.

Owners are the actual objects captured by the world checkpoint coordinator,
not names or types. A declaration cannot qualify an unknown owner's mutable
state. An adapter with independent mutable state must refuse this contract.
```


Implementation alias: `lsd_runtime.timeline.evaluation.ProviderStateParticipation`.

### `lsdtools.timeline.ProviderStateParticipation.version`

Kind: attribute. Source: `services/runtime/src/lsd_runtime/timeline/evaluation.py:28`.

```python
version: int
```


### `lsdtools.timeline.ProviderStateParticipation.mode`

Kind: attribute. Source: `services/runtime/src/lsd_runtime/timeline/evaluation.py:29`.

```python
mode: str
```


### `lsdtools.timeline.ProviderStateParticipation.owners`

Kind: attribute. Source: `services/runtime/src/lsd_runtime/timeline/evaluation.py:30`.

```python
owners: tuple[Any, ...]
```


## `lsdtools.timeline.ScenePropertyProvider`

Kind: class. Source: `services/runtime/src/lsd_runtime/timeline/scene.py:16`.

```python
ScenePropertyProvider(self, context: Any) -> None
```


Source docstring:

```text
Basic position and render-enabled properties of unowned scene objects.

Physics/actor/camera objects require their owning provider's control adapter.
No authored table is mutated. Bind and close on the simulation thread.
```


Implementation alias: `lsd_runtime.timeline.scene.ScenePropertyProvider`.

### `lsdtools.timeline.ScenePropertyProvider.__init__`

Kind: method. Source: `services/runtime/src/lsd_runtime/timeline/scene.py:23`.

```python
__init__(self, context: Any) -> None
```


```python
context: Any
self: (unannotated)
```


### `lsdtools.timeline.ScenePropertyProvider.bind_property`

Kind: method. Source: `services/runtime/src/lsd_runtime/timeline/scene.py:31`.

```python
bind_property(self, spec: Any, target: Any) -> PropertyBinding
```


```python
self: (unannotated)
spec: Any
target: Any
```


### `lsdtools.timeline.ScenePropertyProvider.close`

Kind: method. Source: `services/runtime/src/lsd_runtime/timeline/scene.py:62`.

```python
close(self) -> None
```


```python
self: (unannotated)
```


### `lsdtools.timeline.ScenePropertyProvider.checkpoint_state_version`

Kind: attribute. Source: `services/runtime/src/lsd_runtime/timeline/scene.py:71`.

```python
checkpoint_state_version = 1
```


### `lsdtools.timeline.ScenePropertyProvider.checkpoint_state`

Kind: method. Source: `services/runtime/src/lsd_runtime/timeline/scene.py:73`.

```python
checkpoint_state(self) -> ProviderStateParticipation
```


```python
self: (unannotated)
```


## `lsdtools.timeline.SequenceAsset`

Kind: class. Source: `services/runtime/src/lsd_runtime/timeline/model.py:138`.

```python
SequenceAsset(self) -> None
```


Source docstring:

```text
Immutable reusable asset, constructed only through validated ``from_dict``.

Keys start at zero and hold after the last key. Markers belong to completed
transitions 1..duration; they never execute code. Rebinding creates a separate
prepared instance. There is no automatic unit conversion.
```


Implementation alias: `lsd_runtime.timeline.model.SequenceAsset`.

### `lsdtools.timeline.SequenceAsset.id`

Kind: attribute. Source: `services/runtime/src/lsd_runtime/timeline/model.py:146`.

```python
id: str
```


### `lsdtools.timeline.SequenceAsset.ticks_per_second`

Kind: attribute. Source: `services/runtime/src/lsd_runtime/timeline/model.py:147`.

```python
ticks_per_second: int
```


### `lsdtools.timeline.SequenceAsset.duration_ticks`

Kind: attribute. Source: `services/runtime/src/lsd_runtime/timeline/model.py:148`.

```python
duration_ticks: int
```


### `lsdtools.timeline.SequenceAsset.tracks`

Kind: attribute. Source: `services/runtime/src/lsd_runtime/timeline/model.py:149`.

```python
tracks: tuple[PropertyCurve, ...]
```


### `lsdtools.timeline.SequenceAsset.markers`

Kind: attribute. Source: `services/runtime/src/lsd_runtime/timeline/model.py:150`.

```python
markers: tuple[Marker, ...]
```


### `lsdtools.timeline.SequenceAsset.__init__`

Kind: method. Source: `services/runtime/src/lsd_runtime/timeline/model.py:152`.

```python
__init__(self) -> None
```


```python
self: (unannotated)
```


### `lsdtools.timeline.SequenceAsset.from_dict`

Kind: method. Source: `services/runtime/src/lsd_runtime/timeline/model.py:156`.

```python
from_dict(cls, data: dict) -> 'SequenceAsset'
```


```python
cls: (unannotated)
data: dict
```


### `lsdtools.timeline.SequenceAsset.to_dict`

Kind: method. Source: `services/runtime/src/lsd_runtime/timeline/model.py:214`.

```python
to_dict(self) -> dict
```


```python
self: (unannotated)
```


### `lsdtools.timeline.SequenceAsset.canonical_bytes`

Kind: method. Source: `services/runtime/src/lsd_runtime/timeline/model.py:226`.

```python
canonical_bytes(self) -> bytes
```


```python
self: (unannotated)
```


## `lsdtools.timeline.SequenceCursor`

Kind: class. Source: `services/runtime/src/lsd_runtime/timeline/evaluation.py:44`.

Source docstring:

```text
A session-local cursor qualified for one exact prepared instance.

Restoring it applies no values and emits no events. The checkpoint owner must
restore all target state independently before publishing the completed world.
```


Implementation alias: `lsd_runtime.timeline.evaluation.SequenceCursor`.

### `lsdtools.timeline.SequenceCursor.version`

Kind: attribute. Source: `services/runtime/src/lsd_runtime/timeline/evaluation.py:51`.

```python
version: int
```


### `lsdtools.timeline.SequenceCursor.prepared_id`

Kind: attribute. Source: `services/runtime/src/lsd_runtime/timeline/evaluation.py:52`.

```python
prepared_id: str
```


### `lsdtools.timeline.SequenceCursor.tick`

Kind: attribute. Source: `services/runtime/src/lsd_runtime/timeline/evaluation.py:53`.

```python
tick: int
```


## `lsdtools.timeline.TimelineDocument`

Kind: class. Source: `services/runtime/src/lsd_runtime/timeline/authoring.py:52`.

```python
TimelineDocument(self) -> None
```


Source docstring:

```text
A bounded project-authored collection of independent sequence instances.

Empty documents are valid authoring state and have no live component. The
64 KiB authoring limit leaves space for project edit review and its base
snapshot; the host still enforces its own complete transaction budget.
```


Implementation alias: `lsd_runtime.timeline.authoring.TimelineDocument`.

### `lsdtools.timeline.TimelineDocument.instances`

Kind: attribute. Source: `services/runtime/src/lsd_runtime/timeline/authoring.py:60`.

```python
instances: tuple[SequenceInstance, ...]
```


### `lsdtools.timeline.TimelineDocument.__init__`

Kind: method. Source: `services/runtime/src/lsd_runtime/timeline/authoring.py:62`.

```python
__init__(self) -> None
```


```python
self: (unannotated)
```


### `lsdtools.timeline.TimelineDocument.from_dict`

Kind: method. Source: `services/runtime/src/lsd_runtime/timeline/authoring.py:66`.

```python
from_dict(cls, data: dict) -> 'TimelineDocument'
```


```python
cls: (unannotated)
data: dict
```


### `lsdtools.timeline.TimelineDocument.to_dict`

Kind: method. Source: `services/runtime/src/lsd_runtime/timeline/authoring.py:100`.

```python
to_dict(self) -> dict
```


```python
self: (unannotated)
```


### `lsdtools.timeline.TimelineDocument.canonical_bytes`

Kind: method. Source: `services/runtime/src/lsd_runtime/timeline/authoring.py:106`.

```python
canonical_bytes(self) -> bytes
```


```python
self: (unannotated)
```


### `lsdtools.timeline.TimelineDocument.instance`

Kind: method. Source: `services/runtime/src/lsd_runtime/timeline/authoring.py:109`.

```python
instance(self, instance_id: str) -> SequenceInstance
```


```python
instance_id: str
self: (unannotated)
```


### `lsdtools.timeline.TimelineDocument.sample`

Kind: method. Source: `services/runtime/src/lsd_runtime/timeline/authoring.py:116`.

```python
sample(self, instance_id: str, tick: int) -> tuple[TimelineInspectionSample, ...]
```


```python
instance_id: str
self: (unannotated)
tick: int
```


Source docstring:

```text
Inspect authored values without touching a live world or emitting events.

This checks document types only. It does not certify active provider,
target existence, writer ownership, or playback eligibility.
```


### `lsdtools.timeline.TimelineDocument.with_asset`

Kind: method. Source: `services/runtime/src/lsd_runtime/timeline/authoring.py:129`.

```python
with_asset(self, instance_id: str, asset: SequenceAsset, *, bindings: dict | None=None) -> 'TimelineDocument'
```


```python
asset: SequenceAsset
bindings: dict | None
instance_id: str
self: (unannotated)
```


Source docstring:

```text
Insert an instance, or replace its asset and optionally its bindings.
```


### `lsdtools.timeline.TimelineDocument.without_instance`

Kind: method. Source: `services/runtime/src/lsd_runtime/timeline/authoring.py:148`.

```python
without_instance(self, instance_id: str) -> 'TimelineDocument'
```


```python
instance_id: str
self: (unannotated)
```


### `lsdtools.timeline.TimelineDocument.with_binding`

Kind: method. Source: `services/runtime/src/lsd_runtime/timeline/authoring.py:154`.

```python
with_binding(self, instance_id: str, slot: str, target: int | str) -> 'TimelineDocument'
```


```python
instance_id: str
self: (unannotated)
slot: str
target: int | str
```


### `lsdtools.timeline.TimelineDocument.with_key`

Kind: method. Source: `services/runtime/src/lsd_runtime/timeline/authoring.py:171`.

```python
with_key(self, instance_id: str, track_id: str, tick: int, value: Any) -> 'TimelineDocument'
```


```python
instance_id: str
self: (unannotated)
tick: int
track_id: str
value: Any
```


Source docstring:

```text
Insert or replace one typed key as a single candidate project edit.
```


### `lsdtools.timeline.TimelineDocument.without_key`

Kind: method. Source: `services/runtime/src/lsd_runtime/timeline/authoring.py:180`.

```python
without_key(self, instance_id: str, track_id: str, tick: int) -> 'TimelineDocument'
```


```python
instance_id: str
self: (unannotated)
tick: int
track_id: str
```


### `lsdtools.timeline.TimelineDocument.with_moved_key`

Kind: method. Source: `services/runtime/src/lsd_runtime/timeline/authoring.py:188`.

```python
with_moved_key(self, instance_id: str, track_id: str, tick: int, destination_tick: int) -> 'TimelineDocument'
```


```python
destination_tick: int
instance_id: str
self: (unannotated)
tick: int
track_id: str
```


Source docstring:

```text
Move one existing key atomically, preserving its exact typed value.

The initial key anchors the track and cannot move. An occupied destination
is refused rather than silently overwriting another authored key.
```


### `lsdtools.timeline.TimelineDocument.with_marker`

Kind: method. Source: `services/runtime/src/lsd_runtime/timeline/authoring.py:209`.

```python
with_marker(self, instance_id: str, marker: dict, *, declaration: Any, target: int | str | None=None) -> 'TimelineDocument'
```


```python
declaration: Any
instance_id: str
marker: dict
self: (unannotated)
target: int | str | None
```


Source docstring:

```text
Insert or replace one marker using an exact event declaration.

The caller resolves the currently active declaration. This data-only
operation checks its payload contract but cannot admit the target or
dispatch an effect. Existing named slots cannot be rebound implicitly.
```


### `lsdtools.timeline.TimelineDocument.without_marker`

Kind: method. Source: `services/runtime/src/lsd_runtime/timeline/authoring.py:239`.

```python
without_marker(self, instance_id: str, marker_id: str) -> 'TimelineDocument'
```


```python
instance_id: str
marker_id: str
self: (unannotated)
```


Source docstring:

```text
Remove one marker and only its orphaned slot; remove an empty instance.
```


## `lsdtools.timeline.TimelineError`

Kind: class. Source: `services/runtime/src/lsd_runtime/timeline/model.py:25`.

Source docstring:

```text
A sequence cannot be prepared or evaluated with these contracts.
```


Implementation alias: `lsd_runtime.timeline.model.TimelineError`.

Declared bases: `ValueError`.

## `lsdtools.timeline.TimelineInspectionSample`

Kind: class. Source: `services/runtime/src/lsd_runtime/timeline/authoring.py:42`.

Implementation alias: `lsd_runtime.timeline.authoring.TimelineInspectionSample`.

### `lsdtools.timeline.TimelineInspectionSample.track_id`

Kind: attribute. Source: `services/runtime/src/lsd_runtime/timeline/authoring.py:43`.

```python
track_id: str
```


### `lsdtools.timeline.TimelineInspectionSample.extension`

Kind: attribute. Source: `services/runtime/src/lsd_runtime/timeline/authoring.py:44`.

```python
extension: str
```


### `lsdtools.timeline.TimelineInspectionSample.track`

Kind: attribute. Source: `services/runtime/src/lsd_runtime/timeline/authoring.py:45`.

```python
track: str
```


### `lsdtools.timeline.TimelineInspectionSample.slot`

Kind: attribute. Source: `services/runtime/src/lsd_runtime/timeline/authoring.py:46`.

```python
slot: str
```


### `lsdtools.timeline.TimelineInspectionSample.target`

Kind: attribute. Source: `services/runtime/src/lsd_runtime/timeline/authoring.py:47`.

```python
target: int | str
```


### `lsdtools.timeline.TimelineInspectionSample.value`

Kind: attribute. Source: `services/runtime/src/lsd_runtime/timeline/authoring.py:48`.

```python
value: Any
```


## `lsdtools.timeline.TimelinePropertySources`

Kind: class. Source: `services/runtime/src/lsd_runtime/timeline/sources.py:23`.

```python
TimelinePropertySources(self, bundle, extensions)
```


Implementation alias: `lsd_runtime.timeline.sources.TimelinePropertySources`.

### `lsdtools.timeline.TimelinePropertySources.__init__`

Kind: method. Source: `services/runtime/src/lsd_runtime/timeline/sources.py:24`.

```python
__init__(self, bundle, extensions)
```


```python
bundle: (unannotated)
extensions: (unannotated)
self: (unannotated)
```


### `lsdtools.timeline.TimelinePropertySources.value`

Kind: method. Source: `services/runtime/src/lsd_runtime/timeline/sources.py:76`.

```python
value(self, extension, track, target)
```


```python
extension: (unannotated)
self: (unannotated)
target: (unannotated)
track: (unannotated)
```


### `lsdtools.timeline.TimelinePropertySources.targets`

Kind: method. Source: `services/runtime/src/lsd_runtime/timeline/sources.py:102`.

```python
targets(self)
```


```python
self: (unannotated)
```


Source docstring:

```text
Identity rows with per-property availability and actual authored values.
```


### `lsdtools.timeline.TimelinePropertySources.bundle`

Kind: attribute. Source: `services/runtime/src/lsd_runtime/timeline/sources.py:25`.

```python
bundle: (unannotated)
```


```python
bundle = bundle
```


## `lsdtools.timeline.create_timeline_editor`

Kind: function. Source: `sdk/src/lsdtools/timeline.py:40`.

```python
create_timeline_editor(host, *, entity=None, view_id)
```


```python
entity: (unannotated)
host: (unannotated)
view_id: (unannotated)
```


Source docstring:

```text
Compose the product editor over this exact host's scoped project actions.

A package contributes the main-view entrypoint; the shared widget receives
injected document contracts and action ports. No Desktop object crosses this
API and importing the facade alone never loads GTK.
```


## `lsdtools.timeline.prepare_sequence`

Kind: function. Source: `services/runtime/src/lsd_runtime/timeline/evaluation.py:269`.

```python
prepare_sequence(asset: SequenceAsset, *, bindings: dict, scope: Any, context: Any, instance_id: str) -> PreparedSequence
```


```python
asset: SequenceAsset
bindings: dict
context: Any
instance_id: str
scope: Any
```


Source docstring:

```text
Resolve active, authorized declarations once; saved data contains no code.

The context is supplied by the host. Factories return a provider with
``bind_property(spec, target) -> PropertyBinding`` and ``close()``. An event
marker produces validated data only and never invokes a provider handler.
```


Implementation alias: `lsd_runtime.timeline.evaluation.prepare_sequence`.

## `lsdtools.timeline.timeline_document_from_table`

Kind: function. Source: `services/runtime/src/lsd_runtime/timeline/persistence.py:32`.

```python
timeline_document_from_table(table: pa.Table) -> TimelineDocument
```


```python
table: pa.Table
```


Implementation alias: `lsd_runtime.timeline.persistence.timeline_document_from_table`.

## `lsdtools.timeline.timeline_document_table`

Kind: function. Source: `services/runtime/src/lsd_runtime/timeline/persistence.py:15`.

```python
timeline_document_table(document: TimelineDocument) -> pa.Table
```


```python
document: TimelineDocument
```


Implementation alias: `lsd_runtime.timeline.persistence.timeline_document_table`.

## `lsdtools.timeline.validate_property_value`

Kind: function. Source: `services/runtime/src/lsd_runtime/timeline/model.py:78`.

```python
validate_property_value(value: Any, declaration: TimelinePropertyTrackSpec) -> Any
```


```python
declaration: TimelinePropertyTrackSpec
value: Any
```


Source docstring:

```text
Normalize one property value and enforce its owner's semantic constraints.

Used for captured authored values, every key before binding, and interpolated
evaluation before application. The document never overrides owner bounds.
```


Implementation alias: `lsd_runtime.timeline.model.validate_property_value`.