{"name":"mano","entry":"component","title":"Mano","description":"Position and rotate the independent Hand illustration with controlled coordinates.","category":"UI Bits","capabilities":["controls"],"needsRemotion":false,"registryDependencies":["@jbm/tokens","@jbm/hand","@jbm/scene-geometry"],"install":"npx shadcn@latest add @jbm/mano","installName":"mano","page":"https://jbm-ui.bns.studio/c/mano","registryItem":"https://jbm-ui.bns.studio/r/mano.json","sourcePath":"registry/jbm/motion/mano.tsx","files":[{"source":"registry/jbm/motion/mano.tsx","target":"src/jbm/motion/mano.tsx","import":"@/jbm/motion/mano","type":"registry:component"}],"endpoints":{"markdown":"https://jbm-ui.bns.studio/catalog/mano.md","json":"https://jbm-ui.bns.studio/catalog/mano.json"},"snippet":"import { Mano } from \"@/jbm/motion/mano\"\n\n<svg viewBox=\"0 0 500 340\">\n  <Mano at={{ x: 160, y: 30 }} pose=\"point\" size={155} angle={12} />\n</svg>","api":[{"export":"Mano","kind":"component","summary":"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>.","props":[{"name":"at","type":"Pt","required":true,"default":null,"description":"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."},{"name":"pose","type":"HandPose","required":false,"default":"\"point\"","description":"Hand pose: open, point, pinch, grip, type, or hold (see Hand)."},{"name":"size","type":"number","required":false,"default":"180","description":"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."},{"name":"angle","type":"number","required":false,"default":"0","description":"Rotation in degrees about at; positive is clockwise."},{"name":"anchor","type":"Pt","required":false,"default":null,"description":"Local point in the Hand's 30×29 viewBox held at `at`, including during rotation."},{"name":"halo","type":"boolean","required":false,"default":null,"description":"Pass Hand's card knock-out ring through, for ink art drawn behind the hand. Default false."}],"passthrough":[]}],"stage":{"mode":"declared","landscape":{"width":180,"height":264},"vertical":{"width":180,"height":264},"basis":"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":[{"title":"Pointing hand, slightly rotated","code":"import { Mano } from \"@/jbm/motion/mano\"\n\n<svg viewBox=\"0 0 500 340\">\n  <Mano at={{ x: 160, y: 30 }} pose=\"point\" size={155} angle={12} />\n</svg>"},{"title":"Follow a path with its travel tilt","code":"import { Mano, pointOn, pathTilt } from \"@/jbm/motion/mano\"\n\nconst path = [{ x: 40, y: 200 }, { x: 240, y: 60 }, { x: 440, y: 160 }]\nconst progress = 0.4 // from a slider or useProgress\n<svg viewBox=\"0 0 500 340\">\n  <Mano at={pointOn(path, progress)} angle={pathTilt(path, progress)}\n    pose=\"pinch\" size={120} anchor={{ x: 15, y: 14 }} />\n</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."],"related":[{"name":"tokens","relation":"installs"},{"name":"hand","relation":"installs"},{"name":"scene-geometry","relation":"installs"},{"name":"pluma","relation":"installed-by"}],"family":"Hands","docs":[{"title":"Paper and filing illustrations guide","url":"https://jbm-ui.bns.studio/docs/design-video-components.md"},{"title":"Desk illustrations guide","url":"https://jbm-ui.bns.studio/docs/desk-components.md"}],"setup":{"namespace":"@jbm","componentsJson":{"registries":{"@jbm":"https://jbm-ui.bns.studio/r/{name}.json"}},"command":"npx shadcn@latest add @jbm/<name>","target":"src/jbm/","importAlias":"@/jbm/…","tsconfigPaths":{"@/*":["./src/*"]}},"rules":["Install through the @jbm namespace: each registry item JSON (/r/<name>.json) carries its files' contents and each guide is served at /docs/<slug>.md, so agents never need the source repository (it is public on GitHub for people browsing the code).","Files install to src/jbm/ and import as @/jbm/…, which needs the @/* → ./src/* path alias in tsconfig.json.","Items marked needsRemotion require the remotion package and must render inside a Remotion composition or Player; every other item works in any React page.","Use one vermilion accent per composition; accent2 is for annotations only and soft is for dark surfaces only.","Stages are 1920×1080 landscape and 1080×1920 vertical with declared safe areas; each item's stage field declares its size in stage pixels, and scenes compose from YAML-shaped specs with @jbm/scene-spec."],"links":{"catalog":"https://jbm-ui.bns.studio/catalog.json","llms":"https://jbm-ui.bns.studio/llms.txt"}}