# Callout

> A bordered note at the top of a working page: what someone should know before they trust what is below it.

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

## Usage

### What it is
The production office’s notice (`.po-notice`): *what production should know before trusting the page*. It sits at the top of a module, in the flow of the page, with an optional action at its end.

### When to use
- A fact about this page’s data that changes how someone reads it: unscheduled scenes, a call sheet issued against an older draft, a budget line still estimated.

### When not to use
- For the state of saving: [Sync status](https://kwark.space/designSystem/components/sync-status.md).
- For something that happened just now: [Toast](https://kwark.space/designSystem/components/toast.md).
- For a whole-screen condition (not downloaded, changed elsewhere): a banner across the editor.
- For tips or coaching. Kwark does not teach (Decision 0004).

### Variants
| Variant | Use for |
|---|---|
| Warn | Something on this page is incomplete or out of date |
| Info | Where the data comes from, once, when it is not obvious |

### Writing
Lead with a bold sentence that states the fact; follow with what it means. One action at most, named for where it goes.

## Style

### Anatomy

1. **Box**: 12px 14px, 10px corners, 1px border `color-mix(tone 45%, --k-line)`, background `color-mix(tone 9%, transparent)`, 18px below it.
2. **Glyph**: 16px in the tone, 2px down to sit on the first line.
3. **Text**: 14px (the app uses 13.5px), line height 1.55; the lead in 600.
4. **Action**: a small secondary button, pushed to the end.

### Tokens

| Token | Light | Dark |
|---|---|---|
| `--k-warn` | #8a5a00 | #d8a44a |
| `--k-info` | #255799 | #7db4f0 |
| `--k-line` | #e2e8f0 | rgba(255, 255, 255, .1) |
| `--k-text` | #0f172a | #e3e3e3 |
| `--k-radius-card` | 10px |  |
| `--k-fs-body` | 14px |  |

## 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-callout" data-tone="warn"><svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.75" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="m21.7 18-8-14a2 2 0 0 0-3.5 0l-8 14A2 2 0 0 0 4 21h16a2 2 0 0 0 1.7-3M12 9v4M12 17h.01"/></svg><div><strong>Two scenes have no day yet.</strong> The call sheet lists only scheduled scenes; Scene 12 and Scene 14 are waiting on the stripboard.</div><button class="kw-button kw-button--sm" type="button">Open stripboard</button></div>
<div class="kw-callout" data-tone="info"><svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.75" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><circle cx="12" cy="12" r="10"/><path d="M12 16v-4M12 8h.01"/></svg><div><strong>Read from the screenplay.</strong> Edit a scene’s heading in the script and it changes here.</div></div>
```

## Accessibility

### Keyboard
| Key | Does |
|---|---|
| Tab | Reaches the action, if any. |

### ARIA
- Static callouts are plain content; give them `role="note"` when they explain the region below. Do not use `role="alert"` for something that was there when the page loaded.

## For agents

### Rules

- **Must** open with the fact in bold, then what it means.
- **Never** use a callout for tips, coaching or praise (Decision 0004).
- **Always** keep at most one action, named for its destination.
- **Never** stack more than two callouts; merge them.

### AI readiness test

**Task:** Warn on the call sheet that it was issued from draft 3 and the script is now on draft 4.

**Give the agent:** This page, Decision 0020.

**Constraint:** Re-issuing creates Rev 2.

**A reliable answer:**
- Uses a warn callout at the top of the call sheet
- Leads with "Issued from draft 3
- the script is now draft 4."
- Offers one action "Issue Rev 2"
- Does not use a toast
