{"name":"surface-depth","entry":"doc","title":"SurfaceDepth","description":"Fine borders, inset edge lighting, and layered shadows. Compare the original surface and inspect each layer.","category":"Foundations","capabilities":["controls"],"needsRemotion":false,"registryDependencies":[],"install":"npx shadcn@latest add @jbm/tokens","installName":"tokens","page":"https://jbm-ui.bns.studio/c/surface-depth","registryItem":"https://jbm-ui.bns.studio/r/tokens.json","sourcePath":"registry/jbm/lib/tokens.ts","files":[{"source":"registry/jbm/lib/tokens.ts","target":"src/jbm/lib/tokens.ts","import":"@/jbm/lib/tokens","type":"registry:lib"}],"endpoints":{"markdown":"https://jbm-ui.bns.studio/catalog/surface-depth.md","json":"https://jbm-ui.bns.studio/catalog/surface-depth.json"},"snippet":"import { shadow, surfaceBorder } from \"@/jbm/lib/tokens\"\n\n// Light surface (use cardDark for dark surfaces)\n<div style={{\n  boxShadow: shadow.card,\n  border: surfaceBorder.card,\n}} />","api":[{"export":"shadow","kind":"constant","summary":"Complete raised-surface box-shadows: `card` for light surfaces and `cardDark` for ink surfaces. Apply the whole recipe rather than copying layers into components."},{"export":"surfaceBorder","kind":"constant","summary":"The 1px border that defines the silhouette: `card` (ink at 12%) and `cardDark` (ink at 65%). Pair with the shadow of the same name."},{"export":"shadowLayers","kind":"constant","summary":"Each recipe split into `inset` (upper edge highlight and lower inner line), `contact` (1px crisp contact), and `ambient` (offsets 3, 6, 12, 24px with negative spread and falling opacity). The gallery lab toggles these independently."}],"stage":{"mode":"n/a","reason":"Documentation entry for token recipes; nothing installs as a component. The gallery lab renders two sample surfaces with layer toggles."},"examples":[{"title":"Light raised surface","code":"import { shadow, surfaceBorder } from \"@/jbm/lib/tokens\"\n\n// Light surface (use cardDark for dark surfaces)\n<div style={{\n  boxShadow: shadow.card,\n  border: surfaceBorder.card,\n}} />"},{"title":"Dark surface","code":"import { color, radius, shadow, surfaceBorder } from \"@/jbm/lib/tokens\"\n\n<div style={{\n  background: color.codeBg,\n  borderRadius: radius.card,\n  boxShadow: shadow.cardDark,\n  border: surfaceBorder.cardDark,\n}} />"}],"qa":["Toggle Before and Layered: Before shows the original single broad shadow and 2px border and disables the layer controls.","Toggle border, inset highlight, contact shadow, and soft outer shadows one at a time on both the light and dark samples; each change should be visible and none should leave a clipped shadow.","Inspect at actual display scale: edges readable without looking embossed, and the highlight reads as edge light rather than a separate stripe.","Press Copy token usage with and without clipboard access; the status line reports success or points to the Usage snippet.","Exercise the buttons and checkboxes by keyboard and confirm visible focus."],"related":[{"name":"label","relation":"installed-by"},{"name":"big","relation":"installed-by"},{"name":"card","relation":"installed-by"},{"name":"chip","relation":"installed-by"},{"name":"stat-card","relation":"installed-by"},{"name":"callout","relation":"installed-by"},{"name":"bullet-list","relation":"installed-by"},{"name":"brand","relation":"installed-by"},{"name":"paper","relation":"installed-by"},{"name":"replay-button","relation":"installed-by"},{"name":"scene","relation":"installed-by"},{"name":"prob-bar","relation":"installed-by"},{"name":"code-card","relation":"installed-by"},{"name":"captions","relation":"installed-by"},{"name":"catalog","relation":"installed-by"},{"name":"propagate","relation":"installed-by"},{"name":"shelf","relation":"installed-by"},{"name":"scene-spec","relation":"installed-by"},{"name":"ui-button","relation":"installed-by"},{"name":"ui-input","relation":"installed-by"},{"name":"ui-card","relation":"installed-by"},{"name":"phone-frame","relation":"installed-by"},{"name":"badge","relation":"installed-by"},{"name":"token-glyph","relation":"installed-by"},{"name":"text-fill","relation":"installed-by"},{"name":"scroll-text-fill","relation":"installed-by"},{"name":"flip-text","relation":"installed-by"},{"name":"scroll-stack","relation":"installed-by"},{"name":"rule","relation":"installed-by"},{"name":"action-link","relation":"installed-by"},{"name":"index-row","relation":"installed-by"},{"name":"figure-caption","relation":"installed-by"},{"name":"ticket","relation":"installed-by"},{"name":"chat-bubble","relation":"installed-by"},{"name":"document","relation":"installed-by"},{"name":"folder","relation":"installed-by"},{"name":"score-scale","relation":"installed-by"},{"name":"comparison-bars","relation":"installed-by"},{"name":"clock","relation":"installed-by"},{"name":"cajon","relation":"installed-by"},{"name":"hand","relation":"installed-by"},{"name":"mano","relation":"installed-by"},{"name":"pluma","relation":"installed-by"},{"name":"bandeja","relation":"installed-by"},{"name":"tool-caddy","relation":"installed-by"},{"name":"escritorio","relation":"installed-by"},{"name":"desk-top","relation":"installed-by"},{"name":"ejes","relation":"installed-by"},{"name":"desk-prop","relation":"installed-by"},{"name":"burbuja","relation":"installed-by"},{"name":"file-cabinet","relation":"installed-by"},{"name":"paper-clip","relation":"installed-by"},{"name":"clipped-note","relation":"installed-by"},{"name":"punched-tag","relation":"installed-by"},{"name":"video-print","relation":"installed-by"},{"name":"hilo","relation":"installed-by"},{"name":"tear","relation":"installed-by"},{"name":"paper-line","relation":"installed-by"},{"name":"register","relation":"installed-by"},{"name":"slip","relation":"installed-by"},{"name":"stamp","relation":"installed-by"},{"name":"tape-marker","relation":"installed-by"},{"name":"paper-tape","relation":"installed-by"},{"name":"frontmatter","relation":"installed-by"},{"name":"folder-contents","relation":"installed-by"},{"name":"folder-carry","relation":"installed-by"},{"name":"icons","relation":"installed-by"}],"docs":[{"title":"Surface depth guide","url":"https://jbm-ui.bns.studio/docs/surface-depth.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"}}