if true the "build" tab appears on the RHS

What the user has typed into the catalogue's search box. Empty shows the catalogue whole, with its sections closed as before; anything else shows only components whose name or tooltip contains it, with the sections holding them open.

whether the open design builds into a simulation, for the Simulation tab's buttons

Components and connections that have been selected and copied.

The component libraries available: names and directories only, found once at startup. No library file is opened until the user opens a library. The catalogue is a pure render function, so it cannot look for them itself.

if true highlight connections from wavesim editor

the project contains, as loadable components, the state of each of its sheets

components and connections currently selected

used during step simulation: simgraph for current clock tick

stores the generated truth table

used to determine whether mouse is currently dragging the divider, or used normally

A catalogue item being dragged onto the canvas, or the position one was dropped at. None whenever no such gesture is in flight, which is nearly always.

components and connections which are highlighted

true during period when a sheet or project is loading

Which pane last received a mouse-down, and so where unmodified keys go. Set on mouse-down only - never on mouse-move - so it cannot change under the user's hand while they are typing. It replaces a flag set from the pointer's position on every mouse move, which was stale whenever the pointer had not moved and measured against the wave simulator's divider whichever tab was actually showing.

last time check for changes was made

Track the last added component

used to determine whether current canvas has been saved (includes any change)

component ids and connection ids previously selected (used to detect changes)

top-level canvas used for current wave simulation

last used bus width in bits - used as default in next component create dialog

record containing functions that create react elements of notifications

The library the catalogue is showing instead of its own contents, if any, with the component headers read when it was opened.

The library sheets the user has asked to look inside, by name. A library component is an abstraction and its sheet is not normally reachable at all, but understanding how one works is a fair thing to want, so an instance's right-click menu can open its sheet read-only. Held here rather than on the sheet's CCForm because Form is written to the .dgm on every save: this state is meant to last only as long as the project is open, and storing it in the file would both outlive that and let the Sheets menu's Unlock turn a library sheet into an ordinary editable one.

Contains a list of pending messages

How the components of an in-progress drag were added, if they were. Set when the drag starts and consumed when it settles; None the rest of the time.

data to populate popup (may not all be used)

function to create popup pane if present

Set while the project browser is open, and None the rest of the time - which is how its refresh timer knows to stop.

What the open sheet's draw block is pinned to, when it is one of the above and has finished loading. None for every ordinary sheet, and while a read-only one is still loading - loading legitimately changes the canvas, recomputing symbol sizes, rerouting wires whose ports moved and centring the circuit, so the pin cannot be armed until that has settled. See ModelHelpers.pinDrawBlock.

which of the tabbed panes is currently visible

Function to be run after rendering to update the model

used to enable "SAVE" button

component currently selected in properties dialog

Draw Canvas

The Sheet menu is normally dismissed by clicking anywhere outside it - a sheet in it, or the schematic. Pinned, it stays open until the pin is clicked again, so that a design can be navigated with the hierarchy in view. Sheets fitted while it is pinned are sized to the canvas beside it rather than to the whole canvas - see Sheet.getWindowParasToFitBox.

Whether the sheets of placed library components appear in the Sheets menu. False at startup and not settable from the ordinary UI: a library component is meant to be one thing, and seeing its innards listed beside the user's own sheets is confusing rather than informative. It is worth having for anyone writing a library, who does need to see what a component brought with it. The waveform simulator ignores this: library sheets are never offered there.

which of the subtabs for the right pane simulation is visible

If the application has a modal spinner waiting for simulation

function to create spinner popup pane if present (overrides otehr popups)

style info for the truth table

State of menus for sheets, projects etc

Projects whose top-sheet choice popup the user has cancelled. Cancelling opens the sheet at default parameter values; the question is not asked again for that project.

A breadcrumb-like trail of visited sheets used for UI back button

Bad way to tidy up the messy UI commands - better - do them all in just one message!

User data for the application

Map of sheet name to WaveSimModel

which top-level sheet is used by wavesim

viewer width in pixels altered by dragging the divider