radFormatter / docs / config-options

Configuration options reference

radFormatter is configured with a JSON document. Every key is optional; any key you omit keeps the value from the active profile (see Profiles). A missing or empty config therefore applies the chosen profile's defaults — with no profile selected, that is the built-in Default profile.

There are 72 options across nine sections: casing, spacing, indent, lineBreaks, reshaping, alignment, input, output, and conditional.

Generate a fully populated config with the current defaults using the CLI:

> radFormatter -writeDefaultConfig radFormatter.json

See the CLI reference for how the CLI loads and overlays configuration.

casing

Casing changes are the only non-whitespace edits radFormatter makes; every other change is whitespace or line breaks.

spacing

indent

lineBreaks

reshaping

Structural rewrites of a construct's layout. All default off / conservative.

alignment

Column alignment across consecutive, structurally similar lines. All off by default. Alignment runs after indentation and only inserts interior padding.

input

The source-read policy: how a file's encoding is resolved before formatting. These keys correlate 1:1 with the CLI encoding flags and use the same utf8 / utf16le / utf16be / cpNNNN / NNNN grammar, so a value set here is the committed, per-directory equivalent of the flag (a mixed monorepo can declare each tree's code page in its own radFormatter.json). Defaults reproduce the known-encoding-only default, so an absent input section changes nothing. See the Source encoding section for the model. Precedence: built-in default < input config < CLI flag.

output

output.emptyLines

Integer counts for blank lines at structural boundaries. -1 (default) means “leave as-is”; a value N >= 0 ensures exactly N blank lines there.

conditional

How {$IFDEF}/{$IF} branches are parsed and formatted. See the Conditional Compilation section of Known limitations for the full behavior contract.

Full default configuration

This is exactly what -writeDefaultConfig emits (the Default profile).

{
  "schemaVersion": "3.5",
  "casing": {
    "keywords": "asis",
    "numbers": "asis",
    "directives": "asis",
    "identifiers": "asis"
  },
  "spacing": {
    "assignment": "asis",
    "comma": "asis",
    "colon": "asis",
    "semicolon": "asis",
    "insideParens": "asis",
    "insideBrackets": "asis",
    "beforeParens": "asis",
    "aroundRange": "asis",
    "beforeBracket": "asis",
    "genericBrackets": "asis",
    "aroundUnaryOperators": "asis",
    "aroundBinaryOperators": "asis",
    "maxConsecutiveSpaces": -1
  },
  "indent": {
    "size": 2,
    "style": "asIs",
    "tabWidth": 0,
    "directives": "asIs",
    "continuationSize": 2,
    "anchorBased": false,
    "maxColumn": 0,
    "caseLabels": true,
    "caseContent": true,
    "caseSingleLine": true,
    "caseElseAlignment": "asIs",
    "commentSingleLine": "structural",
    "commentMultiLine": "structural",
    "labelIndent": "bodyLevel"
  },
  "lineBreaks": {
    "keepUser": true,
    "beforeSingleInstr": "asis",
    "beforeBegin": "asis",
    "betweenElseAndIf": false,
    "afterBegin": false,
    "afterSectionKeyword": false,
    "afterLabel": "asis",
    "usesMode": "preserve",
    "lineAfterSemicolon": false,
    "sectionKeywordJoin": "preserve"
  },
  "reshaping": {
    "oneParamPerLineInCalls": false,
    "collapseEndElse": false,
    "collapseEndElseBegin": false,
    "joinMultilineParens": false,
    "arrayInitPerLine": false,
    "inheritancePerLine": false,
    "enumPerLine": false,
    "delimitedGroupStyle": "compact"
  },
  "alignment": {
    "assignments": false,
    "colons": false,
    "consts": false,
    "trailingComments": false,
    "maxPadWidth": 0
  },
  "input": {
    "assumeEncoding": "",
    "fallback": [],
    "heuristic": true
  },
  "output": {
    "lineEnding": "platform",
    "rightMargin": 0,
    "maxEmptyLines": -1,
    "emptyLines": {
      "beforeVisibility": -1,
      "aroundSections": -1,
      "betweenDeclarations": -1,
      "beforeTypeKeyword": -1
    },
    "trimTrailingWhitespace": true,
    "strictMode": true
  },
  "conditional": {
    "mode": "activeBranch",
    "platform": "",
    "compilerVersion": "",
    "defines": [],
    "includePaths": []
  }
}

Safety guarantees

radFormatter is non-destructive. No token is ever lost: it only adds, removes, or replaces whitespace and line endings, and recases keyword, directive, number, and identifier text. Every format is checked two ways — a non-whitespace content hash and a re-lexed token fingerprint. If any rule would alter non-whitespace content, the change is discarded and your original source is returned unchanged.

Appendix: value types

The value types referenced in the Type columns above. Each entry in an option table links back here.

Case mode (casing.keywords, casing.numbers, casing.directives)

Identifier case mode (casing.identifiers)

Spacing option (spacing.assignment, spacing.comma, spacing.colon, spacing.semicolon)

Controls whitespace on each side of a token. String values only.

Tri-state (yes / no / asis)

Used by the toggle-style spacing options and several line-break options. Accepts a JSON boolean (true = yes, false = no) or a string ("yes", "no", "asis").

Configuration options as of radFormatter v2.7.986 (Alpha) · config schema 3.5 — see release notes