Expand description
§dotloom-engine
The headless Dotloom engine. It owns the only editable copy of a document and runs every change through one pipeline:
commands → working overlay → structural validation → solve (affected component)
→ independent hard-rule check → atomic commit → revision + eventsA failed transaction leaves the document untouched. Undo/redo apply stored
before/after states without re-solving. Drags produce transient previews and a
single history entry. Plugin entity types are data (EntityTypeDef) compiled
from a typed expression language; no host code runs inside the solver.
The engine has no DOM, window or GPU dependency.
Re-exports§
pub use registry::EntityTypeDef;pub use registry::Registry;pub use registry::RegistryError;pub use dotloom_constraints as constraints;pub use dotloom_document as document;pub use dotloom_geometry as geometry;pub use dotloom_scene as scene;
Modules§
- eval
- Numeric evaluation of entities: world anchors, drawable shapes and texts.
- lang
- The Dotloom expression language used by plugin model definitions.
- registry
- Entity type definitions and the type registry (ADR-0006).
Structs§
- Apply
Options - Options of a single request.
- Commit
Report - Successful commit.
- Constraint
Patch - Partial constraint update.
- Constraint
Spec - Constraint content (the engine assigns or validates the ID).
- Diagnostic
Report - A solver diagnostic mapped back to document objects.
- Drag
Preview - Result of a drag update.
- Engine
- The Dotloom engine.
- Engine
Options - Engine configuration.
- Entity
Patch - Partial update of an entity.
propsentries set tonullremove the property. - Hit
- A hit.
- Layer
Patch - Layer update.
- Nearest
Value - Nearest feasible value for an edit that could not be satisfied.
- NewEntity
- Data for a new entity.
- Overlay
- Copy-on-write overlay over a document used while a transaction runs.
- Param
Value - A numeric parameter assignment.
- Settings
Patch - Settings update.
- Snap
- A snap result.
- Snap
Options - Snap options.
- Snap
Query - A snap query.
- Solve
Failure - Why solving rejected a transaction.
- Solver
Stats - What the solver did for a commit (diagnostics and performance work).
- Transaction
- A group of commands applied atomically.
Enums§
- Command
- One command of a transaction.
- Command
Error - Command errors (the transaction is rejected, nothing changes).
- Delete
Policy - What to do with constraints and referencing entities when deleting.
- Drag
Spec - What is dragged.
- Edit
Mode - How numeric edits are applied.
- Engine
Error - Engine errors. A failed request never changes the document.
- Event
- Engine event, emitted after state changes (never during a commit).
- Pending
State - Progress of a pending commit.
- Select
Mode - Area selection mode.
- Snap
Kind - Snap kinds in priority order.
Constants§
- THEME_
DEFAULT - Theme-default color marker.
Traits§
- DocView
- Read-only view of document content.
Functions§
- migrate_
entities - Upgrade plugin entities whose
type_versionis older than the registered definition, applying the definition’s migration steps in order. Entities written by a newer version are left untouched (they evaluate as read-only).