> ## Documentation Index
> Fetch the complete documentation index at: https://docs.reducto.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Font

## `Font`

Run formatting over one scope, applied immediately (no load/sync round trip).
Setters: `false` on a toggle writes an explicit off-value, overriding
inherited formatting — the escape hatch for "answer a bold prompt plainly".
Getters read effective formatting resolved through docDefaults and the
paragraph/character style chains; table styles are not layered.
Readback is Word-shaped: a boolean toggle that no run specifies reads
`false`, a value that differs across the scope reads `null`, and `undefined`
appears only for an empty scope (no runs to read) or an unset non-boolean.
On write, `null` clears the direct setting so the style shows through
(name, size, color, bold, italic, underline, strikeThrough,
doubleStrikeThrough, highlightColor, subscript, superscript).

Import from `@reductoai/docx/node`, `@reductoai/docx/officejs`.

### Font properties

| Name | Type | Description |
| - | - | - |
| `allCaps` | `boolean \| null \| undefined` | |
| `bold` | `boolean \| null \| undefined` | |
| `boldBidirectional` | `boolean \| null \| undefined` | |
| `color` | `string \| null \| undefined` | Text color: "auto" or RRGGBB hex ("#RRGGBB" accepted on write). |
| `colorIndex` | `ColorIndexValue \| null \| undefined` | |
| `colorIndexBidirectional` | `ColorIndexValue \| null \| undefined` | The facade has one direct color slot; complex-script color aliases it explicitly. |
| `contextualAlternates` | `boolean \| null \| undefined` | |
| `diacriticColor` | `string \| null \| undefined` | Diacritic color is approximated with the run's direct text color. |
| `disableCharacterSpaceGrid` | `boolean \| null \| undefined` | |
| `doubleStrikeThrough` | `boolean \| null \| undefined` | |
| `emboss` | `boolean \| null \| undefined` | |
| `emphasisMark` | `EmphasisMark \| null \| undefined` | |
| `engrave` | `boolean \| null \| undefined` | |
| `hidden` | `boolean \| null \| undefined` | |
| `highlightColor` | `string \| null \| undefined` | OfficeJS reads the highlight as `#RRGGBB`; `none` and mixed scopes read null. |
| `italic` | `boolean \| null \| undefined` | |
| `italicBidirectional` | `boolean \| null \| undefined` | |
| `kerning` | `number \| null \| undefined` | |
| `ligature` | `Ligature \| null \| undefined` | |
| `name` | `string \| null \| undefined` | An RTL or complex-script run reads its bidi face, as Word does. A theme font reads its face too; `nameAscii` and the other slots read the theme reference ("+Headings ()"). Word's theme spellings ("+Body", "+Headings", "+Body CS", "+Headings CS", "+Body Asian", "+Headings Asian", with or without a "()" suffix) write a theme font reference. |
| `nameAscii` | `string \| null \| undefined` | Latin face; a theme font reads Word's spelling, such as "+Body ()", so `other.font.name = font.nameAscii` keeps the theme link. |
| `nameBidirectional` | `string \| null \| undefined` | |
| `nameFarEast` | `string \| null \| undefined` | |
| `nameOther` | `string \| null \| undefined` | |
| `numberForm` | `NumberForm \| null \| undefined` | |
| `numberSpacing` | `NumberSpacing \| null \| undefined` | |
| `outline` | `boolean \| null \| undefined` | |
| `position` | `number \| null \| undefined` | |
| `rightToLeft` | `boolean \| null \| undefined` | Run-level `w:rtl`, Word's internal right-to-left run mark; null clears the direct setting. |
| `scaling` | `number \| null \| undefined` | |
| `shading` | `string \| null \| undefined` | Extension (VBA `Font.Shading.BackgroundPatternColor`): the run's `w:shd` fill as `#RRGGBB`; null clears it. |
| `shadow` | `boolean \| null \| undefined` | |
| `size` | `number \| null \| undefined` | Font size in points. |
| `sizeBidirectional` | `number \| null \| undefined` | |
| `smallCaps` | `boolean \| null \| undefined` | |
| `spacing` | `number \| null \| undefined` | Additional spacing between characters, in points. Negative values condense. |
| `strikeThrough` | `boolean \| null \| undefined` | |
| `stylisticSet` | `StylisticSet \| null \| undefined` | |
| `subscript` | `boolean \| null \| undefined` | |
| `superscript` | `boolean \| null \| undefined` | |
| `underline` | `UnderlineType` | |
| `underlineColor` | `string \| null \| undefined` | |

### `decreaseFontSize()`

```ts theme={null}
decreaseFontSize(): void
```

### `increaseFontSize()`

```ts theme={null}
increaseFontSize(): void
```

### `reset()`

```ts theme={null}
reset(): void
```

Remove manual character formatting while retaining any character style.

### `set()`

```ts theme={null}
set(format: FontSetFormat, options?: UpdateOptions): this
```

Apply several run properties in one pass; OfficeJS spellings (size, name,
highlightColor, strikeThrough, superscript, subscript) are accepted alongside
the core RunFormat keys.

**Not implemented.** These Office.js members throw: `borders`, `fill`, `glow`, `line`, `reflection`, `textColor`, `textShadow`, `threeDimensionalFormat`, `setAsTemplateDefault`.
