{"name":"icons","entry":"component","title":"JbmIcon","description":"Twelve original geometric SVG icons with outline and paper treatments, inherited color, and optional accessible labels.","category":"UI","capabilities":[],"needsRemotion":false,"registryDependencies":["@jbm/tokens"],"install":"npx shadcn@latest add @jbm/icons","installName":"icons","page":"https://jbm-ui.bns.studio/c/icons","registryItem":"https://jbm-ui.bns.studio/r/icons.json","sourcePath":"registry/jbm/ui/icons.tsx","files":[{"source":"registry/jbm/ui/icons.tsx","target":"src/jbm/ui/icons.tsx","import":"@/jbm/ui/icons","type":"registry:ui"}],"endpoints":{"markdown":"https://jbm-ui.bns.studio/catalog/icons.md","json":"https://jbm-ui.bns.studio/catalog/icons.json"},"snippet":"import { JbmIcon } from \"@/jbm/ui/icons\"\n\n<button><JbmIcon name=\"play\" size={20} /> Start lesson</button>","api":[{"export":"JbmIcon","kind":"component","summary":"A static 24-unit icon. Uses a 2.5-unit stroke derived from the shared outline token, round caps and joins. No timer, client boundary, or Remotion dependency. Decorative unless label is supplied; label an icon-only parent button separately.","props":[{"name":"name","type":"IconName","required":true,"default":null,"description":"arrow-right, search, close, check, play, replay, folder, notebook, dataset, chart, code, or agent."},{"name":"size","type":"number","required":false,"default":"24","description":"Square CSS-pixel size. Non-positive or non-finite values fall back to 24. Inspect 16, 20, 24 and 32px before use."},{"name":"color","type":"string","required":false,"default":"\"currentColor\"","description":"Stroke color. Inherits text color by default."},{"name":"treatment","type":"IconTreatment","required":false,"default":"\"outline\"","description":"outline has no fill; paper fills enclosed silhouettes. Open marks are identical in both treatments."},{"name":"paperColor","type":"string","required":false,"default":"palette.bg","description":"Paper fill, cream by default. Set explicitly on dark surfaces."},{"name":"label","type":"string","required":false,"default":null,"description":"Accessible name for standalone meaningful icons. Omit for decorative icons beside text."},{"name":"style","type":"CSSProperties","required":false,"default":null,"description":"Inline style overrides; width and height overrides can supersede size."}],"passthrough":[]},{"export":"iconPaths","kind":"constant","summary":"Original body and interior-mark SVG paths on a 24×24 grid, keyed by IconName. Body paths are closed and may be filled; marks remain unfilled."},{"export":"IconName","kind":"type","summary":"Union of the twelve keys in iconPaths."},{"export":"IconTreatment","kind":"type","summary":"outline | paper."}],"stage":{"mode":"declared","landscape":{"width":24,"height":24},"vertical":{"width":24,"height":24},"basis":"Square 24×24 viewBox; size sets width and height in pixels, default 24."},"examples":[{"title":"Beside a label","code":"import { JbmIcon } from \"@/jbm/ui/icons\"\n\n<button><JbmIcon name=\"play\" size={20} /> Start lesson</button>"},{"title":"Standalone paper icon","code":"import { JbmIcon } from \"@/jbm/ui/icons\"\n\n<JbmIcon name=\"folder\" treatment=\"paper\" paperColor=\"#C63D24\" color=\"#20241F\" size={32} label=\"Project folder\" />"}],"qa":["Open /icons to inspect all twelve silhouettes at 16, 20, 24, 32 and 48px and enlarged. Compare outline and paper treatments on cream and ink.","Check icon-only controls have an accessible name on the button; decorative SVGs must stay out of the accessibility tree.","Download an SVG from /icons and compare its treatment, size and colors with the selected grid specimen.","The notebook, folder and table are optically simplified icons, not scaled-down animated illustrations. No overlapping paper layers or animation are implied."],"related":[{"name":"tokens","relation":"installs"}],"docs":[{"title":"Icon drawing and review guide","url":"https://jbm-ui.bns.studio/docs/icons.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"}}