{"name":"paper-line","entry":"component","title":"PaperLine","description":"Line of text with controlled grapheme reveal, ink lift, strike-through, and dotted underline.","category":"UI","capabilities":["controls"],"needsRemotion":false,"registryDependencies":["@jbm/tokens","@jbm/scene-geometry"],"install":"npx shadcn@latest add @jbm/paper-line","installName":"paper-line","page":"https://jbm-ui.bns.studio/c/paper-line","registryItem":"https://jbm-ui.bns.studio/r/paper-line.json","sourcePath":"registry/jbm/ui/paper-line.tsx","files":[{"source":"registry/jbm/ui/paper-line.tsx","target":"src/jbm/ui/paper-line.tsx","import":"@/jbm/ui/paper-line","type":"registry:ui"}],"endpoints":{"markdown":"https://jbm-ui.bns.studio/catalog/paper-line.md","json":"https://jbm-ui.bns.studio/catalog/paper-line.json"},"snippet":"import { PaperLine } from \"@/jbm/ui/paper-line\"\n\n<PaperLine text=\"Una idea clara.\" reveal={0.7} lift={0} strike={0} />","api":[{"export":"PaperLine","kind":"component","summary":"Inline-block line of handwritten-on-paper text. Every progress input is controlled 0–1 (clamped; non-finite values count as 0) with no timer, so a slider or video timeline drives it. Hidden graphemes keep their space, and a visually hidden copy exposes the full text to assistive technology.","props":[{"name":"text","type":"string","required":true,"default":null,"description":"The line's text; revealed by whole graphemes (emoji and combined characters stay intact)."},{"name":"reveal","type":"number","required":false,"default":"1","description":"Share of graphemes shown, 0–1; visible count is ceil(reveal × graphemes). The full footprint is reserved at every value."},{"name":"lift","type":"number","required":false,"default":"0","description":"Ink lift 0–1: the line moves up to 60px right and 40px up, rotates up to −9°, and fades (opacity 1 − lift²)."},{"name":"strike","type":"number","required":false,"default":"0","description":"Vermilion 2px strike-through across the middle, drawn left to right as 0–1 of the line width. Meant for single short lines."},{"name":"dotted","type":"boolean","required":false,"default":"false","description":"Adds a 2px dotted underline in the dim color."},{"name":"accent","type":"boolean","required":false,"default":"false","description":"Uses the vermilion accent for the text instead of ink."},{"name":"mono","type":"boolean","required":false,"default":"false","description":"Uses the mono font stack instead of sans."},{"name":"style","type":"CSSProperties","required":false,"default":null,"description":"Inline styles merged last onto the outer span, e.g. fontSize or fontWeight (both inherit by default)."}],"passthrough":[]}],"stage":{"mode":"fluid","reason":"Inline-block text at the inherited font size with line-height 1.4; width follows the text up to 100% of the container and height grows when it wraps. Lift translates up to 60px right and 40px up without affecting layout, so leave headroom (the gallery pads 32px above)."},"examples":[{"title":"Partly written line","code":"import { PaperLine } from \"@/jbm/ui/paper-line\"\n\n<PaperLine text=\"Una idea clara.\" reveal={0.7} lift={0} strike={0} />"},{"title":"Crossed-out mono note","code":"import { PaperLine } from \"@/jbm/ui/paper-line\"\n\n<PaperLine text=\"v1 descartada\" mono dotted strike={1} style={{ fontSize: 22 }} />"}],"qa":["Drag Reveal from 0 to 1: graphemes appear left to right, the line never changes width, and 0 shows nothing.","Drag Lift ink to 1: the line drifts up-right, tilts, and fades out completely without overlapping controls.","Drag Strike to 1 on a single line; on a wrapped line the stroke sits at the block's vertical middle, so keep struck lines short.","Toggle Dotted underline and Accent ink independently, and check each combination with mono."],"related":[{"name":"tokens","relation":"installs"},{"name":"scene-geometry","relation":"installs"}],"docs":[{"title":"Paper and filing illustrations guide","url":"https://jbm-ui.bns.studio/docs/design-video-components.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"}}