# Removable tag

> A coloured pencil mark you can lift: active filters in their calendar colours, and breakdown elements in their department pencils, each with one clear way to remove it.

Source: https://kwark.space/designSystem/components/removable-tag

## Usage

### What it is
A removable tag is a short label with its own remove button. Kwark draws it like a pencil mark on paper: a 3px stripe in the colour that already means something (the calendar category, the breakdown department), a faint wash of the same colour, and the words. Lifting it is one small cross, or *Unlink* when it is a relation.

### Three kinds
| Kind | Example | Removing it |
|---|---|---|
| Filter | *Rehearsal*, *Shoot* on the calendar | Hides nothing permanently: the view widens. No confirmation, no undo needed. |
| Breakdown element | *Prop · Mira’s notebook* in Scene 12 | Removes the element from this scene only. A toast offers Undo. The prop stays in the project. |
| Link | *Linked to Act 2 · Beat 4* | **Unlink**: drops the relation; both things stay. Dashed edge, unlink glyph. |

A tag without a cross is read only (a viewer, or an issued call sheet).

### When to use
- Active filters above a list or calendar.
- Things attached to one record that a person adds and removes often: breakdown elements on a scene, departments on a call.

### When not to
- A choice a person switches on and off in place: a [Chip](https://kwark.space/designSystem/components/chip.md).
- A status (*Draft*, *Issued*): a [Badge](https://kwark.space/designSystem/components/badge.md), never removable.
- Choosing many items from a long list: a [Multiselect](https://kwark.space/designSystem/components/multiselect.md), which uses tokens of its own.

### Colour
- The stripe and wash use the colour the app already gives that category: calendar tokens (`--k-cal-*`) for filters, breakdown pencils (`--k-bk-*`) for elements. Never pick a new colour for a tag.
- The words carry the meaning; the colour only helps a returning eye. A department name (*Prop*) is always written.

**Do:** *Prop · Mira’s notebook* with a prop-purple stripe, removed with a cross named *Remove Prop Mira’s notebook*.

**Don't:** A row of bright pills where colour is the only sign of the department, removed by a bare × with no name.

## Style

### Anatomy

1. **Body**: 28px (32 on touch), 6px corners: square-ish like a label on a strip, not a pill like a chip. 1px edge at 45% of the pencil colour; a 12% wash on `--k-surface`.
2. **Stripe**: 3px wide, 5px from the top and bottom, 3px from the left edge, in the pencil colour.
3. **Kind**: *Prop*, *Cast*, *Linked to* in 12px `--k-text-2` before the label.
4. **Label**: 500 12px `--k-text`, never truncated below the kind.
5. **Remove**: a 24px button (28 on touch, with an invisible hit area reaching 36 × 40) with a 12px cross at stroke 2. Hover: a 22% wash of the pencil; pressed 34%.
6. **Link**: a dashed edge and the unlink glyph in place of the cross.
7. **Read only**: no button; 10px right padding.

### Tokens

| Token | Light | Dark |
|---|---|---|
| `--k-cal-rehearsal` | #4f7359 | #86b392 |
| `--k-cal-shoot` | #826d35 | #c4b068 |
| `--k-cal-recce` | #4d6a7a | #83aac0 |
| `--k-cal-reading` | #a87b32 | #dcb36a |
| `--k-bk-cast` | #e0685c |  |
| `--k-bk-prop` | #a98bd6 |  |
| `--k-bk-wardrobe` | #72b07e |  |
| `--k-bk-sound` | #a2795a |  |
| `--k-surface` | #ffffff | #1a1a1a |
| `--k-line` | #e2e8f0 | rgba(255, 255, 255, .1) |
| `--k-text` | #0f172a | #e3e3e3 |
| `--k-text-2` | #5b6779 | #9ca3af |
| `--k-focus` | #0f172a | #f4f4f5 |
| `--k-radius-control` | 6px |  |

## 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 style="display:grid;gap:20px;width:100%">
<div><p class="kw-specimen-cap">Calendar filters</p><div class="kw-tagrow"><span class="kw-pencil-tag kw-removable-tag" style="--kw-pencil: var(--k-cal-rehearsal)">Rehearsal<button class="kw-pencil-tag__x" type="button" aria-label="Remove Rehearsal filter" data-remove-tag><svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="M18 6 6 18M6 6l12 12"/></svg></button></span><span class="kw-pencil-tag kw-removable-tag" style="--kw-pencil: var(--k-cal-shoot)">Shoot<button class="kw-pencil-tag__x" type="button" aria-label="Remove Shoot filter"><svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="M18 6 6 18M6 6l12 12"/></svg></button></span><span class="kw-pencil-tag kw-removable-tag" style="--kw-pencil: var(--k-cal-recce)">Recce<button class="kw-pencil-tag__x" type="button" aria-label="Remove Recce filter"><svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="M18 6 6 18M6 6l12 12"/></svg></button></span><button class="kw-linkbtn" type="button">Clear all filters</button></div></div>
<div><p class="kw-specimen-cap">Breakdown of Scene 12</p><div class="kw-tagrow"><span class="kw-pencil-tag kw-removable-tag" style="--kw-pencil: var(--k-bk-cast)"><small>Cast</small>Mira<button class="kw-pencil-tag__x" type="button" aria-label="Remove Cast Mira"><svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="M18 6 6 18M6 6l12 12"/></svg></button></span><span class="kw-pencil-tag kw-removable-tag" style="--kw-pencil: var(--k-bk-prop)"><small>Prop</small>Mira’s notebook<button class="kw-pencil-tag__x" type="button" aria-label="Remove Prop Mira’s notebook"><svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="M18 6 6 18M6 6l12 12"/></svg></button></span><span class="kw-pencil-tag kw-removable-tag" style="--kw-pencil: var(--k-bk-wardrobe)"><small>Wardrobe</small>Grey cardigan<button class="kw-pencil-tag__x" type="button" aria-label="Remove Wardrobe Grey cardigan"><svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="M18 6 6 18M6 6l12 12"/></svg></button></span><span class="kw-pencil-tag kw-removable-tag" style="--kw-pencil: var(--k-bk-sound)"><small>Sound</small>Rain on the window<button class="kw-pencil-tag__x" type="button" aria-label="Remove Sound Rain on the window"><svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="M18 6 6 18M6 6l12 12"/></svg></button></span></div></div>
<div><p class="kw-specimen-cap">Linked, and read only</p><div class="kw-tagrow"><span class="kw-pencil-tag kw-pencil-tag--link" style="--kw-pencil: var(--k-cal-reading)"><small>Linked to</small>Act 2 · Beat 4<button class="kw-pencil-tag__x" type="button" aria-label="Unlink Scene 12 from Act 2, Beat 4" title="Unlink"><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="M9 17H7A5 5 0 0 1 7 7h2M15 7h2a5 5 0 0 1 4 8M8 12h4M2 2l20 20"/></svg></button></span><span class="kw-pencil-tag kw-pencil-tag--static" style="--kw-pencil: var(--k-bk-prop)"><small>Prop</small>Mira’s notebook</span></div></div>
</div>
```

## Accessibility

### Keyboard
| Key | Does |
|---|---|
| Tab | Each remove button in order. The tag itself is not focusable. |
| Enter / Space | Removes; focus moves to the next tag’s button, or to the row’s *Clear all*, or to the list it filtered. |
| Backspace / Delete | Same as Enter when the remove button has focus. |

### Roles and names
- The remove button names the action, the kind and the thing: *Remove Rehearsal filter*, *Remove Prop Mira’s notebook*, *Unlink Scene 12 from Act 2, Beat 4*.
- After removal, a polite status says what happened (*Rehearsal filter removed*), and focus never falls to the top of the page.
- The stripe is decoration; the kind is written.
- The cross is drawn as SVG and hidden from assistive tech; never type × as text.

## For agents

### Rules

- **Must** name each remove button with the action, the kind and the item.
- **Must** move focus to the next tag or the filtered list after a removal, and announce it.
- **Always** use the category’s existing colour token for the stripe; never invent a tag colour.
- **Always** write the kind (Prop, Cast, Linked to); colour alone never says it.
- **Never** type × as text for the remove control; draw it as SVG.
- **Must** use Unlink, not Remove, when the tag is a relation and both things remain.

### AI readiness test

**Task:** Show the active filters above the production calendar and the breakdown elements on a scene card.

**Give the agent:** Removable tag, Production calendar, Breakdown page.

**Constraint:** Filters use calendar categories; elements use department pencils.

**A reliable answer:**
- Tags with a coloured stripe from existing tokens
- Kind written
- Remove buttons named with kind and item
- Focus moves and a status announces removal
- Clear all filters as a text button
