# Divider

> A 1px line where one group really ends. Two Kwark forms carry their numbers: the act break with its scene and page count, and the page break with the printed page number.

Source: https://kwark.space/designSystem/components/divider

## Usage

### What it is
A 1px line. Kwark's first tool for grouping is space; a line is for when space is not enough: a menu's destructive item, the end of an act in the outline, the edge of a printed page in the continuous script.

### The Kwark idea: breaks that carry their numbers
Two breaks in a film are real, and they carry information:

- **The act break** in the outline and the scene navigator: *Act 2 · 14 scenes · 38 pp*. The name is the writer's own (Decision 0004); Kwark adds only the counts. If the writer has no acts, there are no act breaks (Decision 0003).
- **The page break** in the screenplay's continuous view: a dashed line with the printed page number at the right, *27.*, as it will sit on paper, and *(MORE)* at the left when a speech runs over. The writer always knows where the page turns before they print (Decision 0005).

### Forms
| Form | Class | Use |
|---|---|---|
| Line | `kw-rule` | Between sections of a page; 16px above and below |
| Inset | `kw-rule--inset` | Inside a [menu](https://kwark.space/designSystem/components/menu.md), 6px in from the sides |
| Vertical | `kw-rule--vertical` | Between groups in a [toolbar](https://kwark.space/designSystem/components/toolbar.md) or a meta line |
| Act break | `kw-rule-label` | The act's name and its counts, line after; `--centre` for a line on both sides |
| Page break | `kw-rule-page` | Continuous script view: dashed, page number at the right |

### When not to use
- Between every row of a list: rows already have their own line ([list row](https://kwark.space/designSystem/components/list-row.md)).
- To decorate. If removing the line changes nothing, remove it.
- Under a heading that already starts a section.

## Style

### Anatomy

1. **Line**: 1px `--k-line`; `--strong` mixes 45% `--k-text-2` in, for a line that must be seen in a room.
2. **Spacing**: 16px above and below; 8px for `--tight`; 5px 6px inside menus (as `.kw-menu-sep`).
3. **Act break**: Poppins 600 12px name in `--k-text`, counts in 400 tabular `--k-text-2`, a 12px gap, then the line to the end; 24px above, 12px below.
4. **Page break**: a 1px dashed line at 45% `--k-text-2`; the page number with its full stop in Courier Prime 12px at the right; *(MORE)* at the left when a speech continues.
5. **Vertical**: 1px wide, at least 20px tall, 8px either side.

### Tokens

| Token | Light | Dark |
|---|---|---|
| `--k-line` | #e2e8f0 | rgba(255, 255, 255, .1) |
| `--k-text` | #0f172a | #e3e3e3 |
| `--k-text-2` | #5b6779 | #9ca3af |
| `--k-font-screenplay` | 'Courier Prime', 'Courier New', monospace |  |
| `--k-fs-meta` | 12px |  |
| `--k-space-2` | 8px |  |
| `--k-space-4` | 16px |  |
| `--k-space-5` | 24px |  |

## Code

### React

Use the HTML below with `kwark.css`. The example shows the markup and styling. Supply any application behavior described on this page.

### HTML and CSS

Works anywhere with `kwark.css`.

```html
<div class="kw-rule-sample">
  <p class="kw-script-line">Mira pockets the reel and kills the monitor.</p>
  <div class="kw-rule-page" role="separator" aria-label="Page break, page 27"><span class="kw-rule-page__more">(MORE)</span><span>27.</span></div>
  <p class="kw-script-line">INT. ROOFTOP – CONTINUOUS</p>
</div>
<div class="kw-rule-sample">
  <div class="kw-rule-label" role="separator" aria-label="Act 2, 14 scenes, 38 pages">Act 2 <small>14 scenes · 38 pp</small></div>
  <p>Mira finds the splice · Nana’s tapes · The rooftop</p>
  <div class="kw-rule-label kw-rule-label--centre" role="separator" aria-label="Act 3, 9 scenes, 26 pages">Act 3 <small>9 scenes · 26 pp</small></div>
</div>
<div class="kw-menu" role="menu" aria-label="Cover">
  <button class="kw-menu-item" role="menuitem" type="button">Upload cover</button>
  <button class="kw-menu-item" role="menuitem" type="button">Change illustration</button>
  <hr class="kw-rule kw-rule--inset" role="separator">
  <button class="kw-menu-item is-danger" role="menuitem" type="button">Remove cover</button>
</div>
<div style="display:flex;align-items:center;height:32px;color:var(--k-text-2);font-size:var(--k-fs-meta)">Scene 12<span class="kw-rule kw-rule--vertical" role="separator" aria-orientation="vertical"></span>Page 26<span class="kw-rule kw-rule--vertical" role="separator" aria-orientation="vertical"></span>Day 7</div>
```

## Accessibility

### ARIA
- A line that separates content is an `<hr>` or `role="separator"`. A purely visual line is `aria-hidden`.
- An act break or page break is a separator with a name: *Act 2, 14 scenes, 38 pages*; *Page break, page 27*.
- Vertical separators set `aria-orientation="vertical"`.
- Inside a menu, separators are skipped by arrow keys.

### Contrast
Dividers are decorative by WCAG's measure, so `--k-line` may sit under 3:1; meaning is never carried by a line alone. The page number and counts are text at 4.5:1.

## For agents

### Rules

- **Never** add a divider where space alone already separates the groups.
- **Must** name act breaks with the writer's own act name and only add counts; never invent an act.
- **Always** show the printed page number at a page break in the continuous script view, with (MORE) when a speech runs over.
- **Must** put a separator before the destructive item in a menu.
- **Must** give separators that carry information an accessible name.

### AI readiness test

**Task:** Mark where printed pages end while the writer scrolls the continuous screenplay.

**Give the agent:** This page, Screenplay page, Decision 0005.

**Constraint:** A speech by MIRA runs over the page.

**A reliable answer:**
- Dashed page break with "27." at the right in Courier Prime
- "(MORE)" at the left
- role="separator" named "Page break, page 27"
- No other decoration
