Canvas

Draw an explanation while speaking to the people who need to understand it. Keep the rough marks, select the part worth improving, and judge a proposed change before it replaces anything. Canvas owns that visual board and its revision history. Its accepted CompositionAppApp identity is canvas.board, revision 1.

The first profile is a portable board authoring demo at /canvas. A browser draft can be saved as a local document and opened again. It is not a server-retained Project, a published workflow, or evidence that the illustrated architecture is running. State of Work owns the delivered evidence and its limits.

The Vite development preview opens Canvas in the AltarControl PanelControl Panel's offline workbench profile, so drawing needs no sign-in and starts no protected status or BridgeChatChat request. The shell and dock controls remain visible with the backend unavailable until explicitly connected. The compiled application keeps the normal authenticated shell and API boundaries.

Sketch, select, and judge

Begin with a blank board or the explicitly illustrative example. Draw actual freehand strokes, add named nodes, and connect them. Lasso circles actual ink and selects whole intersecting objects; the contour itself never becomes a source stroke. Select keeps rectangular selection, and the Objects list supplies its keyboard alternative. Neither gesture cuts strokes. The highlighted objects are the permitted edit scope. Unselected objects supply context and keep their identities.

Capture the selection with an instruction. The portable packet contains the original selected strokes and objects, the bounded scene, world bounds, exact scene revision, and a PNG crop of that same paused revision when capture succeeds. Inspect the packet before taking it to a model. Creating or downloading it performs no model transmission. Instruction and label text remain data, never executable commands.

An imported model proposal names that packet's scene, revision and selected identities. Review its new objects, labels, archived source strokes and positions before applying it. Existing objects outside the selection cannot be changed. A changed scene makes the proposal stale; capture a fresh packet. Acceptance applies the complete change once, preserves original ink, and can be undone. A rejected or invalid proposal leaves the board intact.

The local Tidy helper regularizes geometry. It does not interpret an arbitrary spoken or written request. A proposal authored by CodexSettings FolderSettings Folder and manually imported is attributed as manual model transport; it does not establish a live LychD vision-provider integration.

Keep the explanation steady

Nodes have editable text, optional symbolic artwork, stable identity and explicit connections. Text is rendered separately from image pixels, including short overlays such as “DB”. Local PNG artwork keeps its declared provenance; attaching it does not claim generated-media custody or creative acceptance. World-fixed ink stays where drawn. This profile does not infer attachment of handwriting to a nearby node.

An explicit arrangement settles movable nodes using their dimensions, existing positions, connections and pinned obstacles. Drawing, selecting and dragging hold the scene steady. Arrangement is one undoable change; simulation steps do not become revision history. Motion respects reduced-motion preferences. The semantic object list offers selection and editing without requiring a pointer or pan/zoom gesture.

The board and its neighbors

No relationship is inferred from proximity or a shared label. Future exact references may open their owning instrument without transferring its records, permissions or execution authority.

Save, stop, and return

Download the local document to retain the current scene and its bounded undo/redo snapshots outside the browser; closing an unsaved draft can lose it. Save the current draft before opening another document. Before an import replaces that draft, it validates format, byte and collection bounds, finite geometry, unique identities, source-stroke references, image envelopes and edge endpoints. Untrusted imports cannot contain remote images, SVG or executable code.

The portable size budget reserves the same fixed space for numeric values in the browser and Python. This prevents differences in number formatting from changing acceptance, although the conservative budget may be larger than the compact downloaded file.

Undo and redo preserve object identities and create fresh scene revisions so an old model response cannot become current again accidentally. The board has no live external effect to reconcile in this profile. A future server-retained, concurrent or provider-backed profile must define its own admission, custody, conflict and interrupted-effect recovery before becoming supported.

The executable file and proposal contracts belong to src/lychd/compositions/canvas/. The first profile does not register an executable PatternWorkflowWorkflow or InvocationJob RequestJob Request. Live microphone capture, automatic model interpretation and image generation require separately proved integrations.

The manual Codex example provides a selection packet, a proposal bound to the untouched sample, and a reproducible draw/select/review/save journey. It runs without a GPU or model service.

Smallest falsifying journey

Draw two rough boxes and an arrow, select them beside an unrelated object, and capture the real marks and crop. Import a proposal that makes editable nodes, preview it, apply it, rename and move a node, then undo and redo. The unrelated object and original source ink survive. Change the scene after capture and verify that the old proposal is refused. Save and reopen the local document and repeat through the keyboard object list. Any lost geometry, silent out-of-scope edit, partial acceptance or successful stale application defeats this profile.