# Screenplay page

> The page a writer writes on: US Letter geometry, 12pt Courier, one 16px grid, and the same line breaks as the printed PDF.

Source: https://kwark.space/designSystem/components/screenplay-page

## Usage

### When to use
Wherever a person reads or writes screenplay text as a page: the editor, the reader, a table-read view, a printed copy, an embedded excerpt in a pitch. A screenplay is judged on its page, so the screen must agree with the PDF line for line (Decision 0041).

### When not to
- For a list of scenes or a synopsis. Use an [Index card](https://kwark.space/designSystem/components/index-card.md) or a [List row](https://kwark.space/designSystem/components/list-row.md).
- For breakdown marking. The [Breakdown page](https://kwark.space/designSystem/components/breakdown-page.md) uses a looser 13.5px reading measure on purpose, because it is marked up, not paginated.
- Never shrink the type to fit more on a phone. On a narrow screen the indents keep their printed proportions instead (below a 580px column).

### Anatomy in use
| Part | Spec | Why |
|---|---|---|
| Sheet | 85ch wide (8.5in), 1px `--k-line` border, no shadow | Flat desk, flat paper (Decision 0041) |
| Margins | Left 14.17ch, right 9.48ch, top and foot 6 lines | The app's printed proportions, measured from Highland's PDFs |
| Grid | Every line 1em; scene headings sit two lines below the last line | A heading off the grid shows on ruled paper |
| Scene numbers | Both margins, 50% `--k-text-2` | Locked scripts carry numbers on both sides, as printed |
| Page number | Top right, with a full stop | "7." is how a screenplay numbers its pages |
| Revision star | `*` in the right margin | A changed line in a revised script |

### Rooms
The page takes `--k-page` from the writing room (`data-room` on any ancestor): Studio, Daylight, Paper, Lamplight, Midnight. Rooms change paper and ink only. They never add a light, a glow or a texture over the words.

### Writing
- Sluglines are written by the writer. Kwark offers completions from places already used in the script; it never rewrites a heading.
- Sample text in specimens is real screenplay text (Scene 12, INT. EDIT SUITE – NIGHT, Mira), never lorem ipsum.

**Do:** A white page at 12pt Courier whose dialogue wraps at 33 characters, so page 7 on screen is page 7 in the PDF.

**Don't:** A page that reflows to the window width, or a proportional font "for readability". The page count stops meaning anything.

## Style

### Anatomy

1. **Sheet**: `.kw-script-page`, width `min(85ch, 100%)`, padding `6em 9.48ch 6em 14.17ch`, `--k-fs-script` (16px) Courier Prime, line-height 1.
2. **Elements**: see [Screenplay elements](https://kwark.space/designSystem/components/screenplay-elements.md) for every indent.
3. **Thumbnail**: `.kw-script-page--thumb` scales the type to 0.44, for page strips and specimens.
4. **Crop**: `.kw-script-page--crop` shortens the head and foot margins for excerpts.

### Tokens

| Token | Light | Dark |
|---|---|---|
| `--k-fs-script` | 16px |  |
| `--k-font-screenplay` | 'Courier Prime', 'Courier New', monospace |  |
| `--k-page` |  |  |
| `--k-accent` | #98633f | #98633f |
| `--k-text` | #0f172a | #e3e3e3 |
| `--k-text-2` | #5b6779 | #9ca3af |
| `--k-line` | #e2e8f0 | rgba(255, 255, 255, .1) |

### Measurements
Courier Prime at 16px is 9.6px per character, so 10 characters make one printed inch at 96dpi. Every indent is written in `ch`: 22ch is the printed 2.2in. Change `--k-fs-script` and the whole page scales without breaking a line differently.

## Code

### React

In the Kwark app: `import EditorPage from '@/pages/Understanding/EditorModule/components/EditorPage'`.

```tsx
// The page is the editor itself. Its geometry lives in styles/editor.css (.editor-page)
// and in the screenplay nodes (nodes/Scene.ts, Character.ts, Parenthetical.ts, Transition.ts).
<EditorRoute />
```

| Prop | Type | Notes |
|---|---|---|
| `room` | `'studio' \| 'daylight' \| 'paper' \| 'lamplight' \| 'midnight'` | set on the editor root as data-room; the page colour follows it |

### HTML and CSS

Works anywhere with `kwark.css`.

```html
<article class="kw-script-page kw-script-page--crop" aria-label="Page 7 of Blank Pages">
<p class="kw-sp-scene" data-number="12">INT. EDIT SUITE – NIGHT</p>
<p class="kw-sp-action">Reel 3 loops on the monitor. MIRA (30s) leans in until the glow of the screen is the only light on her face.</p>
<p class="kw-sp-character">MIRA</p>
<p class="kw-sp-paren">to herself</p>
<p class="kw-sp-dialogue">I didn’t shoot this. Nobody did.</p>
<p class="kw-sp-action">She stops the playhead on a frame nobody remembers filming.</p>
<p class="kw-sp-transition">CUT TO:</p>
</article>
```

## Accessibility

- Wrap the page in `<article>` named with the page number and project ("Page 7 of Blank Pages").
- Screenplay elements are paragraphs. Expose the element type to assistive technology through the editor's element menu, not with ARIA roles on each line.
- Scene numbers and the page number are visual duplicates of data the editor announces; keep them `aria-hidden` when they are generated content.
- Every room passes 4.5:1 for ink on page; the scene heading uses `--k-accent`, which each room sets to its pencil colour.

## For agents

### Rules

- **Must** set screenplay text in `--k-font-screenplay` at `--k-fs-script` with line-height 1, so every line sits on one grid.
- **Never** reflow the page to the window; keep the printed indents in `ch` and let the narrow-page rule keep proportions below a 580px column.
- **Never** add a glow, light layer, texture or shadow to the page or the desk (Decision 0041).
- **Always** match the PDF: if the screen and the export wrap a line differently, the screen is wrong.
- **Never** change the writer's words to fit a format; Kwark formats, it does not rewrite (Decision 0002).

### AI readiness test

**Task:** Show a read-only excerpt of Scene 12 inside a pitch document.

**Give the agent:** Screenplay page, Screenplay elements, Writing rooms.

**Constraint:** The excerpt must wrap exactly as the printed script does.

**A reliable answer:**
- Uses .kw-script-page with --crop
- Indents in ch, not px
- Courier Prime at --k-fs-script
- No glow or shadow on the sheet
- Article named with page and project
