# Mano (mano)

> Position and rotate the independent Hand illustration with controlled coordinates.

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

## Install

```sh
npx shadcn@latest add @jbm/mano
```

Also installs @jbm/tokens, @jbm/hand, @jbm/scene-geometry (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/mano.json, files[].content).

| Source path | Installs to | Import |
| --- | --- | --- |
| `registry/jbm/motion/mano.tsx` | `src/jbm/motion/mano.tsx` | `@/jbm/motion/mano` |

## API

### `Mano` (component)

SVG <g> that places the Hand illustration at a point, scales it, and rotates it about that point. Hand owns the artwork and pose; callers own movement (e.g. pointOn and pathTilt along a path). No internal timer. Render inside an <svg>.

| Prop | Type | Default | Description |
| --- | --- | --- | --- |
| `at` | `Pt` | required | Point in the parent SVG's user units: the Hand box's top-left corner, or where the anchor point sits when anchor is set. Rotation pivots here. |
| `pose` | `HandPose` | `"point"` | Hand pose: open, point, pinch, grip, type, or hold (see Hand). |
| `size` | `number` | `180` | Hand width in parent SVG units. Without anchor the box is size × 44/30 tall (264 at 180) with the 30×29 art centred vertically; with anchor it is size × 29/30 tall. |
| `angle` | `number` | `0` | Rotation in degrees about at; positive is clockwise. |
| `anchor` | `Pt` | none | Local point in the Hand's 30×29 viewBox held at `at`, including during rotation. |
| `halo` | `boolean` | none | Pass Hand's card knock-out ring through, for ink art drawn behind the hand. Default false. |

## Stage

Declared in stage pixels at the documented defaults.

| Orientation | Width | Height |
| --- | --- | --- |
| Landscape (1920×1080) | 180 | 264 |
| Vertical (1080×1920) | 180 | 264 |

Parent SVG user units at size 180 without anchor: a 180 × 264 box (size × 44/30) from at, with the 180 × 174 hand centred in it (about 45 units of empty space above and below). With anchor the box is size × 29/30 tall and offset so the anchor lands on at. angle rotates the box about at.

## Examples

### Pointing hand, slightly rotated

```tsx
import { Mano } from "@/jbm/motion/mano"

<svg viewBox="0 0 500 340">
  <Mano at={{ x: 160, y: 30 }} pose="point" size={155} angle={12} />
</svg>
```

### Follow a path with its travel tilt

```tsx
import { Mano, pointOn, pathTilt } from "@/jbm/motion/mano"

const path = [{ x: 40, y: 200 }, { x: 240, y: 60 }, { x: 440, y: 160 }]
const progress = 0.4 // from a slider or useProgress
<svg viewBox="0 0 500 340">
  <Mano at={pointOn(path, progress)} angle={pathTilt(path, progress)}
    pose="pinch" size={120} anchor={{ x: 15, y: 14 }} />
</svg>
```

## QA

- Switch pose through all seven at the same at: the hand stays in its box and does not jump unexpectedly.
- Drag Rotation from −30 to 30: the hand pivots about at (or the anchor point), not its centre.
- Drag Position through Left, Center, and Right: the hand crosses the stage from its left margin to its right margin without resizing, and stays inside the viewBox at every rotation from −30° to 30°.
- Anchor coordinates are in the 30×29 viewBox but each pose applies its own internal transform, so the fingertip lands at a different local point per pose; check the anchor visually for each pose you use.

## Family

Hands

## Docs

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

## Related

Installs:

- [Tokens (tokens)](https://jbm-ui.bns.studio/catalog/tokens.md)
- [Hand (hand)](https://jbm-ui.bns.studio/catalog/hand.md)
- [SceneGeometry (scene-geometry)](https://jbm-ui.bns.studio/catalog/scene-geometry.md)

Installed by:

- [Pluma (pluma)](https://jbm-ui.bns.studio/catalog/pluma.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
