# TapeMarker (tape-marker)

> Folded vermilion paper checkpoint marker with an optional label above it.

- Entry: component
- Category: UI Bits
- Preview capabilities: controls
- Runtime: React
- Needs Remotion: no
- QA page: https://jbm-ui.bns.studio/c/tape-marker
- JSON: https://jbm-ui.bns.studio/catalog/tape-marker.json
- Registry item: https://jbm-ui.bns.studio/r/tape-marker.json (source code in files[].content)

## Install

```sh
npx shadcn@latest add @jbm/tape-marker
```

Also installs @jbm/tokens, @jbm/paper (registry dependencies install automatically).

## Required setup

1. Add the `@jbm` registry to components.json (keep any entries already there):

   ```json
   {
     "registries": {
       "@jbm": "https://jbm-ui.bns.studio/r/{name}.json"
     }
   }
   ```

2. Map `@/*` to `./src/*` in tsconfig.json `compilerOptions.paths`, so `@/jbm/…` imports resolve to src/jbm/.

## Files

Each file's source code is in the registry item JSON (https://jbm-ui.bns.studio/r/tape-marker.json, files[].content).

| Source path | Installs to | Import |
| --- | --- | --- |
| `registry/jbm/ui/tape-marker.tsx` | `src/jbm/ui/tape-marker.tsx` | `@/jbm/ui/tape-marker` |

## API

### `TapeMarker` (component)

A 20×72 vermilion strip with the shared paper shadow and a darker 14px fold at the top. Usable alone or as PaperTape's checkpoint marker.

| Prop | Type | Default | Description |
| --- | --- | --- | --- |
| `label` | `string` | none | Optional bold vermilion text centered 8px above the marker. It does not wrap and sits outside the marker's box, so reserve headroom for it. |
| `style` | `CSSProperties` | none | Inline styles merged last onto the marker strip, e.g. for positioning. |

## Stage

Declared in stage pixels at the documented defaults.

| Orientation | Width | Height |
| --- | --- | --- |
| Landscape (1920×1080) | 20 | 72 |
| Vertical (1080×1920) | 20 | 72 |

Fixed 20×72 box. The label is absolutely positioned above it (8px gap plus one line of inherited-size text) and does not add to the box; long labels extend sideways beyond 20px.

## Examples

### Labeled checkpoint

```tsx
import { TapeMarker } from "@/jbm/ui/tape-marker"

<TapeMarker label="parar aquí" />
```

## QA

- Toggle Marker label: the marker box does not move or resize, and the label centers above it.
- Check the top fold reads as a darker band and the shadow matches other paper surfaces.
- Check long labels at narrow widths: they do not wrap, so make sure they are not clipped by a parent.

## Family

Tape, clips & marks

## Docs

- [Paper and filing illustrations guide](https://jbm-ui.bns.studio/docs/design-video-components.md)

## Related

Installs:

- [Tokens (tokens)](https://jbm-ui.bns.studio/catalog/tokens.md)
- [Paper (paper)](https://jbm-ui.bns.studio/catalog/paper.md)

Installed by:

- [PaperTape (paper-tape)](https://jbm-ui.bns.studio/catalog/paper-tape.md)

## More

- [llms.txt](https://jbm-ui.bns.studio/llms.txt): index of every item
- [catalog.json](https://jbm-ui.bns.studio/catalog.json): every item as JSON
- [Agent contract](https://jbm-ui.bns.studio/docs/agent-contract.md): what each field means
