{"name":"ui-card","entry":"component","title":"UiCard","description":"Illustrated content card with a line-art picture (hills and a vermilion sun) over two text bars.","category":"UI Bits","capabilities":[],"needsRemotion":false,"registryDependencies":["@jbm/tokens","@jbm/paper"],"install":"npx shadcn@latest add @jbm/ui-card","installName":"ui-card","page":"https://jbm-ui.bns.studio/c/ui-card","registryItem":"https://jbm-ui.bns.studio/r/ui-card.json","sourcePath":"registry/jbm/ui/ui-card.tsx","files":[{"source":"registry/jbm/ui/ui-card.tsx","target":"src/jbm/ui/ui-card.tsx","import":"@/jbm/ui/ui-card","type":"registry:ui"}],"endpoints":{"markdown":"https://jbm-ui.bns.studio/catalog/ui-card.md","json":"https://jbm-ui.bns.studio/catalog/ui-card.json"},"snippet":"import { UiCard } from \"@/jbm/ui/ui-card\"\n\n<UiCard w={220} h={170} />","api":[{"export":"UiCard","kind":"component","summary":"Cream paper card with an ink outline: an SVG picture slot taking half the height, then an ink title bar and a lighter subtitle bar. Padding (7% of w), radius (8% of w), and gaps (7% of h) all scale with the box. Pure React; static.","props":[{"name":"w","type":"number","required":false,"default":"220","description":"Width in stage pixels, including the 2px Paper edge; sets padding, radius, and bar widths."},{"name":"h","type":"number","required":false,"default":"170","description":"Height in stage pixels; the picture is 50% of it and the bar thicknesses follow it."},{"name":"style","type":"React.CSSProperties","required":false,"default":null,"description":"Inline styles merged over the card's column layout; use for positioning or opacity."}],"passthrough":[]}],"stage":{"mode":"declared","landscape":{"width":220,"height":170},"vertical":{"width":220,"height":170},"basis":"Fixed w × h box (border-box) at the defaults 220 × 170. `w` and `h` set it directly; the Paper shadow extends below the box."},"examples":[{"title":"Card at its default size","code":"import { UiCard } from \"@/jbm/ui/ui-card\"\n\n<UiCard w={220} h={170} />"},{"title":"Card inside a phone","code":"import { UiCard } from \"@/jbm/ui/ui-card\"\nimport { PhoneFrame } from \"@/jbm/ui/phone-frame\" // install @jbm/phone-frame separately\n\n<PhoneFrame w={200} h={360} gap={14}>\n  <UiCard w={130} h={100} />\n</PhoneFrame>"}],"qa":["Inspect the picture slot: the picture width is computed as w minus padding without the 2px edges, so it may sit about 2px right of centre; confirm this is acceptable at large w.","Try a short, wide card (h well below 0.7 × w): the picture, gaps, and two bars must still fit inside the fixed height.","Check the single vermilion sun stays the only accent when the card sits next to other accent pieces."],"related":[{"name":"tokens","relation":"installs"},{"name":"paper","relation":"installs"},{"name":"ui-bits","relation":"bundled-in"},{"name":"piece","relation":"installed-by"},{"name":"phone-frame","relation":"example-import"}],"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"}}