> ## 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.

# Types: OfficeJS: Lists

## `CountNumberedItemsOptions`

Word.ListFormatCountNumberedItemsOptions; `level` is 1-based like listLevelNumber.

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

| Name | Type | Description |
| - | - | - |
| `level?` | `number` | |
| `numberType?` | `string` | |

## `InsertListItemOptions`

Import from `@reductoai/docx/node`.

```ts theme={null}
type InsertListItemOptions = InsertParagraphOptions & { continue?: boolean; level?: number; numFmt?: ListNumberFormat }
```

## `ListFormatUpdateData`

Import from `@reductoai/docx/officejs`.

```ts theme={null}
type ListFormatUpdateData = WritableProperties<ListFormat>
```

## `ListItemUpdateData`

Import from `@reductoai/docx/officejs`.

```ts theme={null}
type ListItemUpdateData = WritableProperties<ListItem>
```

## `ListLevelDefinition`

One level of a multilevel list, in Word's Define New Multilevel List terms.

Import from `@reductoai/docx-editor`, `@reductoai/docx-editor/model`.

| Name | Type | Description |
| - | - | - |
| `alignment?` | `"left" \| "center" \| "right"` | |
| `font?` | `string` | The number's font; a bullet needs one for its glyph. |
| `format` | `ListNumberFormat` | |
| `indentPt` | `number` | Text indent (`w:ind@left`) in points. |
| `legal?` | `boolean` | Legal style: every level's number shows as Arabic (`w:isLgl`). |
| `numberAtPt` | `number` | Where the number sits, from the margin, in points; at most `indentPt`. |
| `restartAfter?` | `number` | Restart after this level (1-based); 0 never restarts. Absent = after the level above. |
| `start?` | `number` | |
| `style?` | `string` | A paragraph style linked to the level (`w:pStyle`): that style shows this level's number. |
| `suffix?` | `"tab" \| "space" \| "nothing"` | What follows the number. |
| `text` | `string` | `w:lvlText`: `%1`..`%9` stand for the numbers of levels 1..9. |

## `ListLevelType`

Import from `@reductoai/docx/officejs`.

```ts theme={null}
type ListLevelType = typeof ListLevelType[keyof typeof ListLevelType]
```

## `ListLevelUpdateData`

Import from `@reductoai/docx/officejs`.

```ts theme={null}
type ListLevelUpdateData = WritableProperties<ListLevel>
```

## `ListNumberFormat`

Import from `@reductoai/docx-editor`, `@reductoai/docx-editor/model`, `@reductoai/docx/node`.

```ts theme={null}
type ListNumberFormat = typeof LIST_NUMBER_FORMATS[number]
```

## `ListTemplateUpdateData`

Import from `@reductoai/docx/officejs`.

```ts theme={null}
type ListTemplateUpdateData = WritableProperties<ListTemplate>
```

## `ListTypeValue`

Word.ListType, the vocabulary `listType` reports.

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

```ts theme={null}
type ListTypeValue = "ListNoNumbering" | "ListListNumOnly" | "ListBullet" | "ListSimpleNumbering" | "ListOutlineNumbering" | "ListMixedNumbering" | "ListPictureBullet"
```

## `NumberedItem`

A numbered body paragraph, for Insert Cross-reference's "Numbered item" list.

Import from `@reductoai/docx-editor`, `@reductoai/docx-editor/model`.

| Name | Type | Description |
| - | - | - |
| `number` | `string` | |
| `target` | `EditTarget` | |
| `text` | `string` | |

## `NumberForm`

Import from `@reductoai/docx/officejs`.

```ts theme={null}
type NumberForm = typeof NumberForm[keyof typeof NumberForm]
```

## `NumberFormValue`

Not exported by name. You get it from the API.

```ts theme={null}
type NumberFormValue = typeof NUMBER_FORM_VALUES[number]
```

## `NumberingChoices`

What Word offers for the list item: restart it, or join the list above.

Not exported by name. You get it from the API.

| Name | Type | Description |
| - | - | - |
| `canContinue` | `boolean` | |
| `canRestart` | `boolean` | |

## `NumberSpacing`

Import from `@reductoai/docx/officejs`.

```ts theme={null}
type NumberSpacing = typeof NumberSpacing[keyof typeof NumberSpacing]
```

## `NumberSpacingValue`

Not exported by name. You get it from the API.

```ts theme={null}
type NumberSpacingValue = typeof NUMBER_SPACING_VALUES[number]
```

## `OutlineEntry`

Not exported by name. You get it from the API.

| Name | Type | Description |
| - | - | - |
| `level` | `number` | 1 for Heading 1, up to 9; the effective `w:outlineLvl` plus one. |
| `target` | `EditTarget` | |
| `text` | `string` | The heading's text, trimmed; empty for a heading with no characters. |

## `RunTextOutline`

Text Effects > Outline. Each field is optional: the rest keeps what the run has.

Not exported by name. You get it from the API.

| Name | Type | Description |
| - | - | - |
| `color?` | `string \| null` | accent1-6 or RRGGBB; null is No Outline (noFill). |
| `dash?` | `RunTextOutlineDash` | |
| `widthPt?` | `number` | |

## `RunTextOutlineDash`

Not exported by name. You get it from the API.

```ts theme={null}
type RunTextOutlineDash = "solid" | "sysDot" | "sysDash" | "dash" | "dashDot" | "lgDash" | "lgDashDot" | "lgDashDotDot"
```
