applySourceEdit abstract method

void applySourceEdit(
  1. TSourceDocument edit(
    1. TSourceDocument document
    )
)

Applies a source-document edit that must preserve the canonical base canvas scene.

The callback receives immutable canonical input and must be synchronous, deterministic, and free of side effects.

Use this only for host-owned metadata or canonical state outside the base scene. A callback that meaningfully changes the adapter's base scene is programmer misuse and throws before history or publication is changed.

Base-scene mutations belong on EditorController.applyEdit(), commitField(), or updateField().

Implementation

void applySourceEdit(TSourceDocument Function(TSourceDocument document) edit);