jbmui

Frontmatter

  • UI
  • adjustable

Key/value metadata between literal YAML delimiters, with per-row emphasis, dimming, and a stacked layout.

name:
pdf-processing
description:
Extrae tablas de archivos PDF.
license:
Apache-2.0

Install

npx shadcn@latest add @jbm/frontmatter

Needs the @jbm entry in components.json; see Install once.

Also installs @jbm/tokens, @jbm/scene-geometry.

Docs

Usage

Stacked skill metadata with an emphasized and a dimmed field
import { Frontmatter } from "@/jbm/ui/frontmatter"<Frontmatter  stacked  rows={[    { key: "name", value: "pdf-processing", highlight: true },    { key: "description", value: "Extrae tablas de archivos PDF." },    { key: "license", value: "Apache-2.0", dim: 0.6 },  ]}/>

API

Stage
fluid

Width fills the container (minWidth 0) and height follows the rows. Chrome adds 36px of padding, two delimiter lines, and 24px of list margin; rows are separated by 12px (6px plus 12px per value when stacked), and long values wrap anywhere. Set style.width for a fixed box.

Frontmattercomponent

Mono definition list framed by --- lines on a cream block. Two columns (keys at least 112px, values twice as wide) by default; stacked puts each value under its key at full width. Static: no timers or animation; change row props to emphasize or dim fields.

PropTypeDefaultDescription
rowsFrontmatterRow[]requiredFields in display order. Each row renders key: and its value; key is also the React key, so keep keys unique.
stackedbooleanfalseStack each value under its key in one full-width column, for narrow or portrait compositions.
styleCSSPropertiesnoneInline styles merged last over the cream background, 18px padding, and 14px mono type; use for width or font size.

FrontmatterRowtype

One field: key (string), value (ReactNode), optional highlight (3px vermilion bar left of the key), and optional dim from 0 to 1 (clamped; 1 fades key and value to 28% opacity).

QA checks

  • Toggle Stack fields: two-column mode keeps keys aligned at 112px minimum; stacked mode indents values under their keys with no overlap.
  • Toggle Highlight fields: only the vermilion bar appears; text position does not shift because the bar space is always reserved.
  • Drag Dim optional field from 0 to 1: key and value fade together to about 28% opacity and stay legible.
  • Check a long unbroken value on a narrow screen: it wraps inside the block instead of overflowing.