{"name":"paper-clip","entry":"component","title":"PaperClip","description":"Independent ink wire clip to lay across a paper edge.","category":"UI Bits","capabilities":[],"needsRemotion":false,"registryDependencies":["@jbm/tokens"],"install":"npx shadcn@latest add @jbm/paper-clip","installName":"paper-clip","page":"https://jbm-ui.bns.studio/c/paper-clip","registryItem":"https://jbm-ui.bns.studio/r/paper-clip.json","sourcePath":"registry/jbm/ui/paper-clip.tsx","files":[{"source":"registry/jbm/ui/paper-clip.tsx","target":"src/jbm/ui/paper-clip.tsx","import":"@/jbm/ui/paper-clip","type":"registry:ui"}],"endpoints":{"markdown":"https://jbm-ui.bns.studio/catalog/paper-clip.md","json":"https://jbm-ui.bns.studio/catalog/paper-clip.json"},"snippet":"import { PaperClip } from \"@/jbm/ui/paper-clip\"\n\n<div style={{ position: \"relative\", width: 220, height: 120, background: \"white\" }}>\n  <PaperClip style={{ position: \"absolute\", left: 18, top: -24 }} />\n</div>","api":[{"export":"PaperClip","kind":"component","summary":"Decorative (aria-hidden) wire clip: one 3px round-capped ink stroke in a 34×62 viewBox. It does not own the paper; position it over an edge yourself. All SVG attributes pass through to the root <svg>, so width, height, and style (e.g. absolute positioning) are set by the caller.","props":[],"passthrough":["SVGProps<SVGSVGElement>"]}],"stage":{"mode":"declared","landscape":{"width":26,"height":48},"vertical":{"width":26,"height":48},"basis":"Default width 26 and height 48 attributes on a 34×62 viewBox. Override width and height together to scale (the gallery shows 50×92); the viewBox keeps the drawing's proportions."},"examples":[{"title":"Clip across a card edge","code":"import { PaperClip } from \"@/jbm/ui/paper-clip\"\n\n<div style={{ position: \"relative\", width: 220, height: 120, background: \"white\" }}>\n  <PaperClip style={{ position: \"absolute\", left: 18, top: -24 }} />\n</div>"}],"qa":["Inspect the loop at default and enlarged sizes: the single stroke has round caps and even width.","Place it over a paper edge and check the part above the edge reads as clipped on, not floating.","Confirm it stays aria-hidden and adds no focusable element."],"related":[{"name":"tokens","relation":"installs"},{"name":"clipped-note","relation":"installed-by"}],"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"}}