ScoreScript Language wiki

Element reference

Look up a spelling and follow its chapter for worked examples. These entries come from the current native element registry. Recorded limitations are shown as recorded; they are not a claim that every older limitation has been re-audited.

node/note

SpellingDuration of effectPlacement
4EbOneShotNone

Deleting it restores: the bar is that much shorter, and completes itself with rests.

Read the explanation

node/chord

SpellingDuration of effectPlacement
[Eb G Bb]OneShotNone

Deleting it restores: the bar is that much shorter; a chord is one node, so it goes as one.

Read the explanation · Read the explanation

node/rest

SpellingDuration of effectPlacement
rOneShotNone

Deleting it restores: the silence is still there — a short bar fills itself with rests.

Read the explanation

node/multirest

SpellingDuration of effectPlacement
r8OneShotNone

Deleting it restores: the bars it stood for are gone, not unpacked; a lone r is one bar.

Recorded limitation: the H-bar covers the first bar while the bars it stands for still take their own width (docs/LANGUAGE-COVERAGE.md names it as an honest approximation the render report says out loud)

Read the explanation

node/grace

SpellingDuration of effectPlacement
/8COneShotNone

Deleting it restores: the note it leaned on keeps its full value; a grace steals no measured time.

Read the explanation

node/measure-repeat

SpellingDuration of effectPlacement
&&OneShotNone

Deleting it restores: the bar is empty, which reads as a bar of rest.

Read the explanation

mark/staccato

SpellingDuration of effectPlacement
(.)OneShotFlipsWithStem

Deleting it restores: the note is played plain; the next note was never affected anyway.

Read the explanation

mark/staccatissimo

SpellingDuration of effectPlacement
(..)OneShotFlipsWithStem

Deleting it restores: the note is played plain.

Read the explanation

mark/accent

SpellingDuration of effectPlacement
(>)OneShotFlipsWithStem

Deleting it restores: the note takes the dynamic in force, unaccented.

Read the explanation

mark/tenuto

SpellingDuration of effectPlacement
(-)OneShotFlipsWithStem

Deleting it restores: the note takes its plain written length.

Read the explanation

mark/marcato

SpellingDuration of effectPlacement
(^)OneShotFlipsWithStem

Deleting it restores: the note is played plain.

Read the explanation

mark/portato

SpellingDuration of effectPlacement
(.-)OneShotFlipsWithStem

Deleting it restores: the note is played plain; portato is the PAIR, so deleting it drops both.

Read the explanation

mark/fermata

SpellingDuration of effectPlacement
(!)OneShotAbove

Deleting it restores: the note takes its written length and the beat keeps going.

Recorded limitation: a fermata on a REST draws nothing — paint_articulations is reached from paint_note only

Read the explanation

mark/trill

SpellingDuration of effectPlacement
(tr)OneShotAbove

Deleting it restores: the note sounds once, plain.

Read the explanation

mark/mordent

SpellingDuration of effectPlacement
(mord)OneShotAbove

Deleting it restores: the note sounds once, plain.

Read the explanation

mark/turn

SpellingDuration of effectPlacement
(turn)OneShotAbove

Deleting it restores: the note sounds once, plain.

Read the explanation

mark/inverted-turn

SpellingDuration of effectPlacement
(iturn)OneShotAbove

Deleting it restores: the note sounds once, plain.

Read the explanation

mark/sim

SpellingDuration of effectPlacement
(sim)StickyNone

Deleting it restores: every node in the run loses the copied marks and is plain again; the node that was typed once keeps its own.

Read the explanation

mark/non

SpellingDuration of effectPlacement
(non)OneShotNone

Deleting it restores: the run keeps running to the end of the line instead of stopping here.

Read the explanation

mark/tremolo

SpellingDuration of effectPlacement
(trem2)OneShotNone

Deleting it restores: the note sounds as one stroke of its written value.

Read the explanation

mark/dynamic

SpellingDuration of effectPlacement
(p)StickyByPosition

Deleting it restores: the level in force before it keeps sounding.

Recorded limitation: sticky in the clock only: scorescript_perform/src/dynamics.rs carries the level forward, while the model and the page treat a dynamic as a one-shot decoration on one event — two implementations of one law, with no shared authority

Read the explanation

mark/expression

SpellingDuration of effectPlacement
(dolce)OneShotByPosition

Deleting it restores: the passage is played without the instruction.

Read the explanation

mark/text

SpellingDuration of effectPlacement
("sul pont.")OneShotByPosition

Deleting it restores: the passage is played without the instruction.

Read the explanation

mark/tempo-text

SpellingDuration of effectPlacement
*Andante / tempo {44:,"molto rit."}StickyByPosition

Deleting it restores: the tempo in force before it stands; the words are the character, not the rate.

Read the explanation

mark/chord-symbol

SpellingDuration of effectPlacement
@F7OneShotAbove

Deleting it restores: the harmony is whatever the notes say; the letter was a reading aid.

Recorded limitation: the v0.2 statement door lands an auto chord symbol BELOW in the model; the painter then draws it above anyway, because it never reads the side

Read the explanation · Read the explanation

mark/rehearsal

SpellingDuration of effectPlacement
RH {5, 9, 13}OneShotAbove

Deleting it restores: the bar is an ordinary bar and the section it opened is unnamed.

Read the explanation

mark/rehearsal-circled

SpellingDuration of effectPlacement
(A)OneShotAbove

Deleting it restores: the bar is an ordinary bar; the ring was the face, not the mark.

Read the explanation

mark/rehearsal-spoken

SpellingDuration of effectPlacement
RH AOneShotAbove

Deleting it restores: the bar is an ordinary bar.

Read the explanation

mark/navigation

SpellingDuration of effectPlacement
[segno]OneShotAbove

Deleting it restores: the piece plays straight through this point.

Read the explanation

mark/barline

SpellingDuration of effectPlacement
||OneShotNone

Deleting it restores: the bar closes with a plain single barline.

Read the explanation

mark/repeat-barline

SpellingDuration of effectPlacement
:|OneShotNone

Deleting it restores: the music plays once and goes on; any volta it closed loses its end.

Read the explanation

mark/lyric

SpellingDuration of effectPlacement
lyrics:OneShotBelow

Deleting it restores: the line is vocalised or played; the notes do not move.

Read the explanation

mark/breath

SpellingDuration of effectPlacement
(,)OneShotAbove

Deleting it restores: the phrase runs on without a lift.

Read the explanation

mark/caesura

SpellingDuration of effectPlacement
(caesura)OneShotAbove

Deleting it restores: the phrase runs on without a break.

Read the explanation

mark/sticking

SpellingDuration of effectPlacement
(R)OneShotBelow

Deleting it restores: the note is struck with no hand named, and the player chooses.

Read the explanation

mark/figured-bass

SpellingDuration of effectPlacement
figured-bassOneShotNone

Deleting it restores: the bass note stands alone and the harmony is the player's to read.

Recorded limitation: the reader checks it and throws it away — the model seam has no figured-bass field, so nothing is drawn (the breath lane fixed the twin of this on 2026-09-01; the same shape of fix is what this row wants)

Read the explanation

span/slur

SpellingDuration of effectPlacement
4C~ DOneShotFlipsWithStem

Deleting it restores: the notes are played separately; nothing else moves.

Read the explanation

span/tie

SpellingDuration of effectPlacement
4C~ COneShotFlipsWithStem

Deleting it restores: the second note is struck again instead of held.

Read the explanation

span/hairpin-crescendo

SpellingDuration of effectPlacement
4C< DOneShotBelow

Deleting it restores: the level in force holds flat across the passage.

Recorded limitation: an authored above on the statement door is stored and never read

Read the explanation

span/hairpin-diminuendo

SpellingDuration of effectPlacement
4C> DOneShotBelow

Deleting it restores: the level in force holds flat across the passage.

Recorded limitation: an authored above on the statement door is stored and never read

Read the explanation

span/glissando

SpellingDuration of effectPlacement
4C/ GOneShotNone

Deleting it restores: the two notes are separate; the slide between them was the figure.

Recorded limitation: a glissando across a system break is not drawn, and says so on the render report

Read the explanation

span/pedal

SpellingDuration of effectPlacement
[ped..]OneShotBelow

Deleting it restores: the passage is played without the sustain pedal.

Read the explanation

span/ottava-up

SpellingDuration of effectPlacement
[8va..]OneShotAbove

Deleting it restores: the notes print where they sound, ledger lines and all.

Recorded limitation: the line moves no notes — the model already resolved the octaves — so it is ink over music that is already in the right place

Read the explanation

span/ottava-down

SpellingDuration of effectPlacement
[8vb..]OneShotBelow

Deleting it restores: the notes print where they sound.

Recorded limitation: the AUTO-CLEF octave line in paint/staff.rs puts a downward shift ABOVE the staff, disagreeing with this row and with the authored spelling

Read the explanation

span/trill-line

SpellingDuration of effectPlacement
[tr..]OneShotAbove

Deleting it restores: the note sounds once and plain for its written length.

Recorded limitation: the extension is dashed rather than a wiggle — Bravura's wiggle glyphs are not in the baked roster, and the render report says so

Read the explanation

span/custom-line

SpellingDuration of effectPlacement
span custom-lineOneShotNone

Deleting it restores: the passage carries no bracketed line.

Recorded limitation: reaches the model through the v0.2 statement door and is not painted at all

Read the explanation

span/volta

SpellingDuration of effectPlacement
[1..]OneShotAbove

Deleting it restores: the bars are played on every pass; there is no first or second time.

Recorded limitation: the inline door makes voltas NAVIGATION words on the bar, not spans — only the v0.2 statement door builds a SpanKind::Volta, and that one is not drawn

Read the explanation

span/tuplet-bracket

SpellingDuration of effectPlacement
{3: 8C D E}OneShotFlipsWithStem

Deleting it restores: the notes take their written values and the bar no longer adds up.

Read the explanation

span/tempo-transition

SpellingDuration of effectPlacement
[rit..]OneShotAbove

Deleting it restores: the tempo steps rather than ramps between its two ends.

Read the explanation

state/meter

SpellingDuration of effectPlacement
[meter 3/4]StickyNone

Deleting it restores: the meter in force before it continues (4/4 when nothing ever said).

Read the explanation

state/key

SpellingDuration of effectPlacement
[key G]StickyNone

Deleting it restores: the signature in force before it continues (C major when nothing ever said).

Read the explanation

state/tempo

SpellingDuration of effectPlacement
[tempo 120]StickyAbove

Deleting it restores: the rate in force before it continues; with none, the clock's default.

Read the explanation

state/clef

SpellingDuration of effectPlacement
[clef bass]StickyNone

Deleting it restores: the part's own clef returns — the one it was declared with, or the instrument catalog's, or the painter's auto choice.

Read the explanation

state/instrument

SpellingDuration of effectPlacement
[instrument piccolo]StickyAbove

Deleting it restores: the player stays on the instrument the part was declared with.

Read the explanation

state/beams

SpellingDuration of effectPlacement
[beams 3+3+2]DefaultRedefiningNone

Deleting it restores: [beams standard] returns this meter to its own grouping AND forgets — which is what category three needs an explicit spelling for, since simply deleting the override leaves the memory it already made.

Read the explanation

state/spell

SpellingDuration of effectPlacement
spell keyStickyNone

Deleting it restores: spell absolute returns: a written accidental means exactly itself.

Read the explanation

state/solfege

SpellingDuration of effectPlacement
solfege fixedStickyNone

Deleting it restores: movable do returns — the cores are read against the key in force.

Read the explanation

state/rehearsal-scheme

SpellingDuration of effectPlacement
rehearsal autoStickyNone

Deleting it restores: rehearsal manual returns: the marks you write are the marks you get.

Read the explanation

state/transpose

SpellingDuration of effectPlacement
transposeStickyNone

Deleting it restores: transpose 0 returns: the bar is concert pitch again and the instrument catalog's own interval derives the page.

Recorded limitation: the map spelling transpose {0, 149:-1 -2} is PROVISIONAL, open for Brandon's veto

Read the explanation

identity/version

SpellingDuration of effectPlacement
scorescript 0.3StickyNone

Deleting it restores: a fragment, read as the current spec — which is why the container swap made the header required: the same text can mean different music in two versions.

Read the explanation

identity/title

SpellingDuration of effectPlacement
score "Title"StickyNone

Deleting it restores: the page prints no title and page one starts at the top margin like any other.

Read the explanation

identity/composer

SpellingDuration of effectPlacement
composer "…"StickyNone

Deleting it restores: the title block loses that line and closes up.

Read the explanation

identity/arranger

SpellingDuration of effectPlacement
arranger "…"StickyNone

Deleting it restores: the title block loses that line and closes up.

Read the explanation

identity/movement-title

SpellingDuration of effectPlacement
movement-title "…"StickyNone

Deleting it restores: the title block loses that line and closes up.

Read the explanation

identity/part-name

SpellingDuration of effectPlacement
part fl: Flute 1StickyNone

Deleting it restores: the catalog's own printed name returns, auto-numbered among its duplicates.

Read the explanation

identity/node-name

SpellingDuration of effectPlacement
4Eb=themeStickyNone

Deleting it restores: the node keeps a deterministic path id, so hosts still address it — they just address it by where it is instead of by what it is called.

Read the explanation

identity/measure-name

SpellingDuration of effectPlacement
m1=intro:StickyNone

Deleting it restores: the bar keeps its label and its ordinal; only the stable name goes.

Read the explanation