{"name":"ui-button","entry":"component","title":"UiButton","description":"Illustrated pill button with a label bar, in ink, accent, or outlined paper tones.","category":"UI Bits","capabilities":[],"needsRemotion":false,"registryDependencies":["@jbm/tokens","@jbm/paper"],"install":"npx shadcn@latest add @jbm/ui-button","installName":"ui-button","page":"https://jbm-ui.bns.studio/c/ui-button","registryItem":"https://jbm-ui.bns.studio/r/ui-button.json","sourcePath":"registry/jbm/ui/ui-button.tsx","files":[{"source":"registry/jbm/ui/ui-button.tsx","target":"src/jbm/ui/ui-button.tsx","import":"@/jbm/ui/ui-button","type":"registry:ui"}],"endpoints":{"markdown":"https://jbm-ui.bns.studio/catalog/ui-button.md","json":"https://jbm-ui.bns.studio/catalog/ui-button.json"},"snippet":"import { UiButton } from \"@/jbm/ui/ui-button\"\n\n<UiButton w={220} h={70} tone=\"accent\" />","api":[{"export":"UiButton","kind":"component","summary":"Paper cut-out pill (radius h / 2) with a centred rounded bar standing in for the label. The bar is 42% of the width and 13% of the height (at least 6px); it is cream on ink and accent, ink on paper. Pure React with no text and no click handling: an illustration, not a control.","props":[{"name":"w","type":"number","required":false,"default":"220","description":"Width in stage pixels, including the 2px Paper edge."},{"name":"h","type":"number","required":false,"default":"70","description":"Height in stage pixels; also sets the pill radius (h / 2) and the label bar thickness."},{"name":"tone","type":"PaperTone","required":false,"default":"\"ink\"","description":"Paper stock: ink (default, filled), accent (vermilion), or paper (cream with an ink outline and ink bar)."},{"name":"style","type":"React.CSSProperties","required":false,"default":null,"description":"Inline styles merged over the flex centring; use for positioning, opacity, or transforms."}],"passthrough":[]}],"stage":{"mode":"declared","landscape":{"width":220,"height":70},"vertical":{"width":220,"height":70},"basis":"Fixed w × h box (border-box, so the 2px edge is inside) at the defaults 220 × 70. `w` and `h` set it directly; the Paper shadow extends past the box by up to about 32px below."},"examples":[{"title":"Accent button","code":"import { UiButton } from \"@/jbm/ui/ui-button\"\n\n<UiButton w={220} h={70} tone=\"accent\" />"},{"title":"Outlined button in a paper row","code":"import { UiButton } from \"@/jbm/ui/ui-button\"\n\n<div style={{ display: \"flex\", gap: 24 }}>\n  <UiButton w={180} h={56} tone=\"paper\" />\n  <UiButton w={180} h={56} />\n</div>"}],"qa":["Compare ink, accent, and paper tones on cream: the paper tone keeps its 2px ink outline and ink bar; ink and accent show a cream bar.","Check extremes of h: at small heights the bar floors at 6px thick; at large heights the pill stays fully rounded.","Confirm the bar stays centred when style adds padding or positioning."],"related":[{"name":"tokens","relation":"installs"},{"name":"paper","relation":"installs"},{"name":"ui-bits","relation":"bundled-in"},{"name":"piece","relation":"installed-by"}],"family":"Interface bits","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"}}