Config Reference

`Field`

Shared Field clearance, pin badges, close-focus restoration, and outward-only zoom.

Defaults

Defaults shown here are the effective built-in defaults for the selected wiki version.

Default Config Shape

Use this as the section shape when editing halley.rune.

field:
  gap 20.0
  pins:
    corner "top-right"
    colour "auto"
    background-colour "auto"
    size 1.0
  end
  close-restore-focus true
  close-restore-nodes false
  close-restore-pan "if-offscreen"
  zoom:
    enabled true
    min 0.35
    step 1.10
    smooth-rate 12.5
  end
end

`field`

Spatial Field policy.

Option	Type	Default	Notes
`gap`	f32	`20.0`	Clearance for maximized windows and readable landmarks.
`pins`	nested block	`see field.pins`	Pinned entity badge styling.
`close-restore-focus`	bool	`true`	Selects a cluster, same-output, or global MRU successor after close.
`close-restore-nodes`	bool	`false`	Restores a collapsed successor before focusing it.
`close-restore-pan`	never \| if-offscreen \| always	`if-offscreen`	Camera policy for the selected successor.
`zoom`	nested block	`see field.zoom`	Outward-only camera zoom.

`field.pins`

Pinned badge position, palette, and scale.

Option	Type	Default	Notes
`corner`	top-left \| top-right	`top-right`	Badge corner; titlebar pins are placed opposite controls.
`colour`	auto \| light \| dark \| hex	`auto`	Pin glyph color.
`background-colour`	auto \| light \| dark \| hex	`auto`	Badge background color.
`size`	f32	`1.0`	Badge scale from 0.5 through 3.0.

`field.zoom`

Zoom only moves outward from native scale and back to 1.0.

Option	Type	Default	Notes
`enabled`	bool	`true`	Enables field zoom.
`min`	f32	`0.35`	Minimum scale.
`step`	f32	`1.10`	Per-step multiplier.
`smooth-rate`	f32	`12.5`	Camera interpolation rate. max and smooth are intentionally unsupported.