Expose remaining Part/Staff editing methods to Plugin API

[manolo]

Related to: #31201
Follow-up to: #31205, #32185

Summary

This is the third and final PR for exposing NotationParts methods to the Plugin API (issue #31201). It implements the 7 methods that were deferred in PR #32185 due to prerequisite work.

All new methods follow the established pattern: shared static methods in EditPart (used by both the Plugin API and NotationParts), with Q_INVOKABLE wrappers on the Score API class. NotationParts is refactored to delegate to EditPart, eliminating logic duplication.

Changes

Commit 1: appendStaff and appendLinkedStaff

• appendStaff(destinationPart) : Creates and appends a new default staff to a part, returns the new staff
• appendLinkedStaff(sourceStaff, destinationPart) : Creates a staff linked to a source staff, appends it to a part, returns the new staff
• Private helper doAppendStaff extracted from NotationParts for shared use

Commit 2: setVoiceVisible

• setVoiceVisible(staff, voiceIndex, visible) : Shows or hides a voice in an excerpt score. Returns false if called on a main score (excerpt only limitation)
• Refactors NotationParts::setVoiceVisible to delegate to EditPart

Commit 3: replaceDrumset

• replaceDrumset(part, drumset) : Applies a modified drumset to all matching instruments in a part (undoable)
• Instrument::cloneDrumset() : Creates a writable copy of an instrument's drumset
• Drumset individual setters for modifying cloned drumsets: setName, setNoteHead, setLine, setVoice, setStemDirection, setShortcut
• Drumset ownership model (m_owned flag) for safe lifecycle of cloned drumsets
• Refactors NotationParts::replaceDrumset undoable path to delegate to EditPart

Commit 4: insertPart and replacePart

• insertPart(instrumentId, index) : Creates a new part from an instrument template and inserts it at the given index
• replacePart(part, instrumentId) : Replaces an existing part with a new one created from an instrument template

Commit 5: setScoreOrder

• setScoreOrder(orderId) : Sets the score order (e.g. "orchestral", "marching-band") which controls part ordering and bracket/barline layout
• Refactors NotationParts::doSetScoreOrder to delegate to EditPart

Implementation checklist

Completed in PR #31205:

• replaceInstrument(part, instrumentId)

Completed in PR #32185:

• setPartVisible(part, visible)
• setPartSharpFlat(part, sharpFlat)
• setInstrumentName(part, tick, name)
• setInstrumentAbbreviature(part, tick, abbreviature)
• setStaffType(staff, staffTypeId)
• removeParts(parts)
• removeStaves(staves)
• moveParts(sourceParts, destinationPart, mode)
• moveStaves(sourceStaves, destinationStaff, mode)
• addSystemObjects(staves)
• removeSystemObjects(staves)
• moveSystemObjects(sourceStaff, destinationStaff)
• Staff writable properties via Pid (visible, cutaway, hideSystemBarLine, mergeMatchingRests, reflectTranspositionInLinkedTab)

Completed in this PR:

• appendStaff(destinationPart)
• appendLinkedStaff(sourceStaff, destinationPart)
• setVoiceVisible(staff, voiceIndex, visible)
• replaceDrumset(part, drumset)
• insertPart(instrumentId, index)
• replacePart(part, instrumentId)
• setScoreOrder(orderId)

Usage examples

curScore.startCmd("Append staff");

// Append a new staff to the first part
var newStaff = curScore.appendStaff(curScore.parts[0]);

// Append a linked staff (content mirrors the source)
var linked = curScore.appendLinkedStaff(curScore.staves[0], curScore.parts[0]);

curScore.endCmd();

curScore.startCmd("Edit drumset");

// Clone the drumset, modify entries, and apply
var instrument = curScore.parts[0].instrumentAtTick(0);
var drumset = instrument.cloneDrumset();
drumset.setName(36, "Kick Drum");
drumset.setLine(36, 4);
drumset.setVoice(36, 1);
drumset.setStemDirection(36, 1);
curScore.replaceDrumset(curScore.parts[0], drumset);

curScore.endCmd();

curScore.startCmd("Insert and replace parts");

// Insert a flute at position 0
curScore.insertPart("flute", 0);

// Replace the last part with a cello
var lastPart = curScore.parts[curScore.parts.length - 1];
curScore.replacePart(lastPart, "cello");

// Set orchestral score order
curScore.setScoreOrder("orchestral");

curScore.endCmd();

---

• I signed the CLA
• The title of the PR describes the problem it addresses
• Each commit's message describes its purpose and effects, and references the issue it resolves
• If changes are extensive, there is a sequence of easily reviewable commits
• The code in the PR follows the coding rules
• There are no unnecessary changes
• The code compiles and runs on my machine, preferably after each commit individually
• I created a unit test or vtest to verify the changes I made (if applicable)

[DmitryArefiev]

Tested Layout (Instruments) panel on Win10. No regressions found

[Jojo-Schmitz]

Won't easily git cherry-pick into the 4.7 branch