{"name":"ui-input","entry":"component","title":"UiInput","description":"Illustrated outlined text field with a placeholder bar and a cursor you switch on or off.","category":"UI Bits","capabilities":[],"needsRemotion":false,"registryDependencies":["@jbm/tokens","@jbm/paper"],"install":"npx shadcn@latest add @jbm/ui-input","installName":"ui-input","page":"https://jbm-ui.bns.studio/c/ui-input","registryItem":"https://jbm-ui.bns.studio/r/ui-input.json","sourcePath":"registry/jbm/ui/ui-input.tsx","files":[{"source":"registry/jbm/ui/ui-input.tsx","target":"src/jbm/ui/ui-input.tsx","import":"@/jbm/ui/ui-input","type":"registry:ui"}],"endpoints":{"markdown":"https://jbm-ui.bns.studio/catalog/ui-input.md","json":"https://jbm-ui.bns.studio/catalog/ui-input.json"},"snippet":"import { UiInput } from \"@/jbm/ui/ui-input\"\n\n<UiInput w={220} h={70} cursorOn />","api":[{"export":"UiInput","kind":"component","summary":"Cream paper field with an ink outline, a 3px ink cursor (half the height), and a line-colour placeholder bar at 45% of the width. It has no internal timer and no real text entry: blink the cursor by toggling `cursorOn` from a timeline.","props":[{"name":"w","type":"number","required":false,"default":"220","description":"Width in stage pixels, including the 2px Paper edge."},{"name":"h","type":"number","required":false,"default":"70","description":"Height in stage pixels; sets the corner radius (22%), inner padding (28%), cursor height (50%), and placeholder thickness (12%, at least 6px)."},{"name":"cursorOn","type":"boolean","required":false,"default":"true","description":"Shows the cursor (opacity 1) when true, hides it (opacity 0) when false; the cursor keeps its space either way."},{"name":"style","type":"React.CSSProperties","required":false,"default":null,"description":"Inline styles merged over the field's flex row; use for positioning or opacity."}],"passthrough":[]}],"stage":{"mode":"declared","landscape":{"width":220,"height":70},"vertical":{"width":220,"height":70},"basis":"Fixed w × h box (border-box) at the defaults 220 × 70. `w` and `h` set it directly; the Paper shadow extends below the box."},"examples":[{"title":"Field with the cursor showing","code":"import { UiInput } from \"@/jbm/ui/ui-input\"\n\n<UiInput w={220} h={70} cursorOn />"},{"title":"Blink the cursor on a Remotion timeline","code":"import { UiInput } from \"@/jbm/ui/ui-input\"\nimport { useSec } from \"@/jbm/motion/hooks\" // install @jbm/motion-hooks separately\n\n// Render inside a Remotion <Composition> or <Player>: hooks run in the component body.\nexport function BlinkingInput() {\n  const sec = useSec()\n  return <UiInput w={420} h={120} cursorOn={Math.floor(sec * 2) % 2 === 0} />\n}"}],"qa":["Toggle cursorOn: the cursor appears and disappears without shifting the placeholder bar.","Check small and large h: padding, radius, and cursor scale with h while the placeholder floors at 6px thick.","At narrow w with a tall h, confirm the placeholder bar and padding still fit inside the field (it does not clip its children)."],"related":[{"name":"tokens","relation":"installs"},{"name":"paper","relation":"installs"},{"name":"ui-bits","relation":"bundled-in"},{"name":"piece","relation":"installed-by"},{"name":"motion-hooks","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"}}