{"name":"stamp","entry":"component","title":"Stamp","description":"Vermilion rubber-stamp impression that drops, makes contact, and inks in as a 0–1 press progresses.","category":"UI Bits","capabilities":["controls"],"needsRemotion":false,"registryDependencies":["@jbm/tokens","@jbm/scene-geometry"],"install":"npx shadcn@latest add @jbm/stamp","installName":"stamp","page":"https://jbm-ui.bns.studio/c/stamp","registryItem":"https://jbm-ui.bns.studio/r/stamp.json","sourcePath":"registry/jbm/ui/stamp.tsx","files":[{"source":"registry/jbm/ui/stamp.tsx","target":"src/jbm/ui/stamp.tsx","import":"@/jbm/ui/stamp","type":"registry:ui"}],"endpoints":{"markdown":"https://jbm-ui.bns.studio/catalog/stamp.md","json":"https://jbm-ui.bns.studio/catalog/stamp.json"},"snippet":"import { Stamp } from \"@/jbm/ui/stamp\"\n\n<Stamp text=\"REVISADO\" press={0.9} angle={-7} />","api":[{"export":"Stamp","kind":"component","summary":"Bordered mono text in vermilion with a faint offset second impression. An ink impression, not a validation verdict. `press` is controlled with no timer: the stamp descends from 60px above until contact at 0.62, and its ink fades in from 0.5 to fully opaque at 0.8.","props":[{"name":"text","type":"string","required":true,"default":null,"description":"Impression text in 24px bold mono; wraps anywhere when space runs out."},{"name":"press","type":"number","required":false,"default":"1","description":"Press progress 0–1 (clamped). Invisible below 0.5, touches down at 0.62, fully inked from 0.8."},{"name":"angle","type":"number","required":false,"default":"-7","description":"Rotation of the impression in degrees; negative tilts counter-clockwise."},{"name":"style","type":"CSSProperties","required":false,"default":null,"description":"Inline styles merged last onto the outer element. Setting transform or opacity here replaces the press animation."}],"passthrough":[]}],"stage":{"mode":"fluid","reason":"Inline-block sized by the text: one 24px mono line plus 8px/16px padding and a 3px border, up to 100% of the container. Before contact it sits up to 60px higher, and rotation widens the footprint, so reserve headroom (the gallery pads 70px above)."},"examples":[{"title":"Nearly settled stamp","code":"import { Stamp } from \"@/jbm/ui/stamp\"\n\n<Stamp text=\"REVISADO\" press={0.9} angle={-7} />"}],"qa":["Drag Press through 0, 0.5, 0.62, 0.8, and 1: hidden, faint while descending, touching down, fully inked, and settled with no jump.","Drag Stamp angle to both extremes: the rotated box stays inside the preview on narrow screens.","Check the offset second impression reads as ink texture, not a duplicate label, and screen readers hear the text once."],"related":[{"name":"tokens","relation":"installs"},{"name":"scene-geometry","relation":"installs"}],"family":"Tape, clips & marks","docs":[{"title":"Paper and filing illustrations guide","url":"https://jbm-ui.bns.studio/docs/design-video-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"}}