{"name":"action-link","entry":"component","title":"ActionLink","description":"A text anchor with an optional arrow and visible hover and keyboard focus.","category":"UI","capabilities":[],"needsRemotion":false,"registryDependencies":["@jbm/tokens"],"install":"npx shadcn@latest add @jbm/action-link","installName":"action-link","page":"https://jbm-ui.bns.studio/c/action-link","registryItem":"https://jbm-ui.bns.studio/r/action-link.json","sourcePath":"registry/jbm/ui/action-link.tsx","files":[{"source":"registry/jbm/ui/action-link.tsx","target":"src/jbm/ui/action-link.tsx","import":"@/jbm/ui/action-link","type":"registry:ui"}],"endpoints":{"markdown":"https://jbm-ui.bns.studio/catalog/action-link.md","json":"https://jbm-ui.bns.studio/catalog/action-link.json"},"snippet":"import { ActionLink } from \"@/jbm/ui/action-link\"\n\n<ActionLink href=\"/ideas\">Explora las ideas</ActionLink>\n<ActionLink href=\"/historia\" arrow={false}>Lee la historia completa</ActionLink>","api":[{"export":"ActionLink","kind":"component","summary":"A real <a> (all anchor attributes and the ref pass through) in Geist 18px bold with a 1px underline. On hover or keyboard focus it turns vermilion with a 2px underline; caller onMouseEnter, onMouseLeave, onFocus, and onBlur handlers still run. An optional decorative ↗ arrow follows the text.","props":[{"name":"arrow","type":"boolean","required":false,"default":"true","description":"Shows the trailing ↗ arrow (aria-hidden). Set false for a plain underlined link."}],"passthrough":["React.ComponentPropsWithRef<\"a\">"]}],"stage":{"mode":"fluid","reason":"Inline-flex, sized by its text up to 100% of the container: one line is 18px × 1.4 plus 6px padding above and below (about 37px); long text wraps anywhere and adds lines."},"examples":[{"title":"Link with and without the arrow","code":"import { ActionLink } from \"@/jbm/ui/action-link\"\n\n<ActionLink href=\"/ideas\">Explora las ideas</ActionLink>\n<ActionLink href=\"/historia\" arrow={false}>Lee la historia completa</ActionLink>"}],"qa":["Hover and Tab to each link: both switch to vermilion with a thicker underline and a visible focus outline offset 5px, then revert on leave or blur.","Check that the arrow is not read by screen readers and does not wrap onto its own line apart from the text.","Check a long link text on a narrow screen: it wraps without overflowing."],"related":[{"name":"tokens","relation":"installs"},{"name":"index-row","relation":"installed-by"}],"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"}}