Pre-1.0: signatures are not frozen. Generated from rustdoc JSON of the compiled crate; rustdoc JSON format version 60. Only public items are listed.
Editor admission glue for a decoded authoring workspace.
The workspace envelope (crate::workspace) persists authoring state only:
the existing graph document bytes plus editor-only positions and an
optional selection. This module is the small step that turns such a
decoded candidate into a compiled candidate: it hands the decoded
graph to the existing [Editor::open] compile step and replays the
authored positions through the existing [Editor::set_position] API.
Deliberate properties of this glue:
- There is no second validator, protocol or identity here. The envelope keeps its own bounds and refusals, the compiler keeps the type, cycle and capability rules, and the plan keeps its own process-local identity. Nothing is re-checked against a parallel rule set and no identifier is minted outside the existing compile step.
- The decoded graph is moved, never re-encoded, re-decoded or cloned.
GraphSourcehas noCloneimplementation, so the candidate keeps the exactSourceStampproduced by the decode; the plan is compiled from that same source, soplan.matches(source)holds by construction. - Only the cold authoring metadata is copied: the position map and the selection are read before the workspace is consumed. That copy is bounded by the envelope's own position limit, which the decoder already enforced.
- A refused compile leaves the caller's already accepted editor, plan and revision untouched. This helper never touches an accepted application state, never renders and never claims backend authority.
The returned candidate is a candidate. The caller adopts it only after its own renderer and application gates have passed; this module performs no rendering, no scheduling and no admission to a running application.
(documentation continues in the source)
Structs
structaster_blueprint::workspace_editor::AdmittedWorkspace
pub struct AdmittedWorkspace { /* see fields */ }A compiled workspace candidate: an admitted editor plus the selection that was authored with it. The selection is presentation state and is never compiled.
Methods
fn editor(&self) -> &Editor— The compiled candidate editor. Borrowing it does not adopt it.fn editor_mut(&mut self) -> &mut Editor— Mutable access for the caller's own editor work. Mutations still go through the editor transaction API.fn selection(&self) -> Option<NodeKey>— The selected node originally carried by the workspace, if it had one. This is historical authoring metadata; after editor_mut changes topology, the caller must validate or replace its own selection before use.fn positions(&self) -> &BTreeMap<NodeKey, EditorPosition>— The editor positions replayed from the workspace.fn into_parts(self) -> (Editor, Option<NodeKey>)— Split the candidate into its editor and its selection so the caller can adopt them through its own gates.
Trait implementations: Debug
Functions
fnaster_blueprint::workspace_editor::admit
pub fn admit(workspace: workspace::Workspace, catalog: std::sync::Arc<compiler::Catalog>, env: compiler::Environment, limits: compiler::CompileLimits) -> Result<AdmittedWorkspace, editor::EditorError>Admit a decoded workspace candidate into a compiled editor candidate.
The workspace graph is compiled through the existing editor/compiler path,
so a cycle, an unknown definition or any other compile refusal is
reported as [EditorError::Compile] with the compiler's own typed error.
Positions are then applied through [Editor::set_position], which refuses
an unknown node or a non-finite coordinate; the envelope decoder already
guarantees both, so a refusal here means the candidate was not built from
a decoded envelope.
On success the candidate owns the compiled editor and the selection. The caller decides whether to adopt it.