{"name":"bullet-list","entry":"component","title":"BulletList","description":"Vertical list of short strings with a vermilion arrow or dot marker.","category":"UI","capabilities":[],"needsRemotion":false,"registryDependencies":["@jbm/tokens"],"install":"npx shadcn@latest add @jbm/bullet-list","installName":"bullet-list","page":"https://jbm-ui.bns.studio/c/bullet-list","registryItem":"https://jbm-ui.bns.studio/r/bullet-list.json","sourcePath":"registry/jbm/ui/bullet-list.tsx","files":[{"source":"registry/jbm/ui/bullet-list.tsx","target":"src/jbm/ui/bullet-list.tsx","import":"@/jbm/ui/bullet-list","type":"registry:ui"}],"endpoints":{"markdown":"https://jbm-ui.bns.studio/catalog/bullet-list.md","json":"https://jbm-ui.bns.studio/catalog/bullet-list.json"},"snippet":"import { BulletList } from \"@/jbm/ui/bullet-list\"\n\n<BulletList size={28} items={[\"El contexto\", \"La pregunta\", \"La respuesta\"]} />\n<BulletList size={28} marker=\"dot\" items={[\"Simple\", \"Reusable\", \"Consistente\"]} />","api":[{"export":"BulletList","kind":"component","summary":"Flex column of rows; each row is 600-weight sans ink text with line-height 1.25, preceded by an accent → or an 18px accent dot, 16px apart. Pure React; `renderItem` lets you wrap each row, for example in a motion Pop.","props":[{"name":"items","type":"string[]","required":true,"default":null,"description":"Row strings in order. Each string is also the React key, so items must be unique."},{"name":"marker","type":"\"arrow\" | \"dot\"","required":false,"default":"\"arrow\"","description":"\"arrow\" (vermilion →) or \"dot\" (18px vermilion circle)."},{"name":"size","type":"number","required":false,"default":"36","description":"Font size of each row in stage pixels."},{"name":"gap","type":"number","required":false,"default":"16","description":"Vertical space between rows in stage pixels."},{"name":"renderItem","type":"(node: React.ReactNode, i: number) => React.ReactNode","required":false,"default":null,"description":"Optional wrapper called with each finished row node and its index; return the node to render (for example inside a Pop with a staggered `at`)."},{"name":"style","type":"React.CSSProperties","required":false,"default":null,"description":"Inline styles on the column, merged last; set width here in a scene."}],"passthrough":[]}],"stage":{"mode":"fluid","reason":"Fills its container's width; height is n rows × size × 1.25 plus (n − 1) × gap, so three default rows are 3 × 45 + 2 × 16 = 167 stage px. Long items wrap and add lines."},"examples":[{"title":"Arrow and dot lists","code":"import { BulletList } from \"@/jbm/ui/bullet-list\"\n\n<BulletList size={28} items={[\"El contexto\", \"La pregunta\", \"La respuesta\"]} />\n<BulletList size={28} marker=\"dot\" items={[\"Simple\", \"Reusable\", \"Consistente\"]} />"},{"title":"Staggered entry in a video","code":"import { BulletList } from \"@/jbm/ui/bullet-list\"\nimport { Pop } from \"@/jbm/motion/pop\" // install @jbm/pop separately\n\n<BulletList\n  items={[\"El contexto\", \"La pregunta\"]}\n  renderItem={(node, i) => <Pop at={0.4 + i * 0.6} from=\"left\" dist={14}>{node}</Pop>}\n/>"}],"qa":["Compare arrow and dot markers: the dot stays vertically centered on the first line and the arrow is vermilion.","Duplicate strings share a React key and trigger a warning; keep items unique.","Check the full list height fits the safe area in portrait, where the scene compiler uses a 22px gap.","With renderItem and Pop, step through the stagger and confirm every row ends fully visible."],"related":[{"name":"tokens","relation":"installs"},{"name":"scene-spec","relation":"installed-by"},{"name":"pop","relation":"example-import"}],"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"}}