# Normalization option reference

Generated from the native formatter menu built with this wiki. Read [consolidation and normalization](normalization.md) for recipes, refusal conditions, comment handling, and the difference between compact spacing and musical reuse. Check your installed build with `scorescript format --list`.

## arrange

part streams, measure systems, system breaks or rehearsal sections.

| Group | Values | Availability | Default on |
| --- | --- | --- | --- |
| orientation | parts, measures, systems, rehearsals | Implemented | No |

## maps

meter/key/tempo/transpose: header maps, or `at mN { … }` in place; system/page cuts are separate.

| Group | Values | Availability | Default on |
| --- | --- | --- | --- |
| maps | top, inline | Implemented | No |

## hoist-breaks

replace matching per-part system/page maps with ONE score-level map.

| Group | Values | Availability | Default on |
| --- | --- | --- | --- |
| maps | Bare switch | Implemented | No |

## labels

written headings as a map at the top, or on the bars they head.

| Group | Values | Availability | Default on |
| --- | --- | --- | --- |
| maps | top, inline | Implemented | No |

## exercises

the collection as a header index, or each exercise owning its music from m1.

| Group | Values | Availability | Default on |
| --- | --- | --- | --- |
| maps | top, inline | Implemented | No |

## sections

the book's sections as a map at the top, or holding their exercises.

| Group | Values | Availability | Default on |
| --- | --- | --- | --- |
| maps | top, inline | Implemented | No |

## expand

one line the rest read -> every reader's part written out (consolidate, backwards).

| Group | Values | Availability | Default on |
| --- | --- | --- | --- |
| consolidation | Bare switch | Implemented | No |

## consolidate

identical, transposed or octave-translated part bodies -> one line the rest read.

| Group | Values | Availability | Default on |
| --- | --- | --- | --- |
| consolidation | Bare switch | Implemented | No |

## named-spans

a repeated bar range written once and named.

| Group | Values | Availability | Default on |
| --- | --- | --- | --- |
| consolidation | Bare switch | Coming | No |

Not available: `consolidate` writes them inside a head; spans have no door outside one.

## durations

how a duration is written: `4Eb` or `qEb`.

| Group | Values | Availability | Default on |
| --- | --- | --- | --- |
| spelling | numbers, letters | Implemented | Yes |

## key

decide the file's key spelling: no signature, or the one it implies.

| Group | Values | Availability | Default on |
| --- | --- | --- | --- |
| spelling | open, signature, auto | Implemented | No |

## chromatic

inside a chromatic run: sharps ascending, flats descending.

| Group | Values | Availability | Default on |
| --- | --- | --- | --- |
| spelling | Bare switch | Implemented | No |

## octaves

the octave digit: only where the ladder needs it, or pinned on every note.

| Group | Values | Availability | Default on |
| --- | --- | --- | --- |
| spelling | minimal, explicit | Coming | No |

Not available: the octave ladder runs unconditionally inside emit; needs a Style axis.

## preset

a PRESET: one word for a whole selection (see the presets below).

| Group | Values | Availability | Default on |
| --- | --- | --- | --- |
| compression | readable, condensed, max | Implemented | No |

## align

pad grid cells so the barlines line up down the page.

| Group | Values | Availability | Default on |
| --- | --- | --- | --- |
| compression | on, off | Implemented | Yes |

## compact

no indent, no padding, no blank lines — one edit, one line.

| Group | Values | Availability | Default on |
| --- | --- | --- | --- |
| compression | on, off | Implemented | No |

## strip-dev-text

remove header text that is dev jargon, never a name or a real subtitle.

| Group | Values | Availability | Default on |
| --- | --- | --- | --- |
| lint | Bare switch | Implemented | No |

## strip-comments

remove every `//` comment, so a score can be made comment-free by the tool.

| Group | Values | Availability | Default on |
| --- | --- | --- | --- |
| lint | Bare switch | Implemented | No |

## jargon-lint

report (never rewrite) student-facing text carrying internal jargon.

| Group | Values | Availability | Default on |
| --- | --- | --- | --- |
| lint | Bare switch | Implemented | No |

## Presets

| Selector | Exact expansion |
| --- | --- |
| preset=readable | align=on, compact=off, maps=top |
| preset=condensed | compact=on, align=off, hoist-breaks, maps=top, durations=numbers |
| preset=max | compact=on, align=off, hoist-breaks, maps=top, durations=numbers, strip-dev-text, consolidate |

The `named-spans` entry being marked coming does not mean named reuse is missing: `consolidate` already writes named ranges inside shared reader heads. [Write a named exercise](reuse.md).

[Machine-readable menu](/reference/normalization.json)
