Function divider

divider(options?: number | DividerOptions): string
Draw a horizontal divider line for terminal output.
Parameters
- options: number | DividerOptions = {}
  Divider options (when a number, it’s treated as width).
Returns string
A styled divider string of length width.
Remarks
- Overload: You can pass a number directly to set width.
- Order: style (if provided) is applied first, then color.
- Graphemes & width: The width is a count of JS code units, not terminal columns. Complex graphemes (emoji/ZWJ/combining marks) and East Asian width can cause visual misalignment in monospaced terminals. For exact control, segment by grapheme (e.g., Intl.Segmenter) and/or use a wcwidth approach. :contentReference[oaicite:0]{index=0}
- ANSI/SGR: Colors use standard Select Graphic Rendition sequences (ESC[38;…m foreground, reset with ESC[0m), widely supported in modern terminals. :contentReference[oaicite:1]{index=1}
Example
Basic:
```
divider(); // "----------------------------------------"
```
Example
With options:
```
divider({ width: 30, char: "=", color: "yellow" });
```
Example
Numeric overload:
```
divider(10); // "----------"
```
- Defined in layout/divider.ts:76