All docs
Docs/ API Reference/ lsdtools.timeline reference
API Reference

lsdtools.timeline reference

Generated public SDK reference for lsdtools.timeline.

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.

By LSD Team · Last updated Sep 09, 2026 Ask a question View as Markdown
Type to search every doc, guide, and tutorial.
↑↓ navigate openesc close