Avatar

Surface background from the Panel scale (`surface.peak` → `surface.ground`, or `transparent`).

Border color at rest: `none`, `default`, `bold`, `muted`, or `accent`. The 1px line is always reserved when a border can appear, so changing it never shifts layout.

Border color while the surface is `active` — the explicit form of the ring `activeEmphasis` would otherwise pick. It holds through hover, so a `borderInteract` color can't steal it. `inherit` keeps whatever `activeEmphasis` chose; `none` clears it.

Border color on hover and press: `none`, `default`, `bold`, `muted`, or `accent`. Composes with `border`, e.g. a muted line at rest that turns bold on hover.

Emphasis level that tunes the avatar surface and fallback styling.

User name; initials are derived from the first and last word.

Elevation shadow applied to the surface.

Avatar shape: a circle or a square with a rounded corner.

Avatar size; matches the button scale so an avatar and button of the same size align.

Image URL. Omit to render the fallback.

Frosted glass: the chosen `background` step at /35 with a large backdrop blur, so content behind the panel shows through. A transparent background stays transparent.

Inner padding from the spacing scale.

Corner radius from the radii scale (`full` for fully rounded). `inner` computes a concentric corner from the parent panel's radius minus its padding; `inherit` mirrors the parent's corner exactly, for a child that sits flush with its edge.

Corner radius for the bottom-left and bottom-right corners.

Corner radius for the top-left and bottom-left corners.

Corner radius for the top-right and bottom-right corners.

Corner radius for the top-left and top-right corners.

Keep (or drop) the always-1px transparent border the panel reserves so a border appearing or changing never shifts layout. Computed automatically — it's reserved when a resting `border` is visible, or when `interactive` / `borderInteract` / `active` can change the border at runtime. Set `false` only on a panel that must not occupy that 1px (e.g. a borderless housing frame that would otherwise add 2px around a set).

Opt the surface into the baseline rhythm. The root takes one whole raster line of padding on every edge and its text slots round their leading UP to a whole number of lines, so the box's height comes out as a whole number of lines without anyone setting a height. Inert when off — a surface rendered without it is byte-identical to before. An ancestor scope (a `<Grid rhythm>`, any `[data-rhythm]`) quantises the text without this prop; the prop is what also puts this box on the raster.

Mark this as the chosen one in a set (a current nav item, a checked option, a selected card). Where `interactive` says it *can* be clicked, `active` says it *is* the current choice. Use `activeEmphasis` to control how loud the state is. Combined with `interactive`, hover and press restart their stepping from the active baseline rather than falling back to the unchosen ramp. The four values differ only in what drives the state: `true` by the prop (via `data-panel-active`), `"checked"` by a wrapped native input (`:has(input:checked)` — zero JS, nothing to re-render), `"current"` by an existing `aria-current` on the panel, and `"current-within"` by an `aria-current` on a direct child (a split nav row whose link carries it).

How loud the `active` state is. Defaults to the panel's own `emphasis`, so the chosen state lands on the same ramp as the resting look — this prop is the override for when the active item should be louder (or quieter) than the panel itself. `"primary"` fills with the tone accent ramp and flips text to the contrast scale (~150 RGB units of separation — the option that reads at a glance in a dense list). `"secondary"` tints the tone surface ramp and `"tertiary"` the neutral ramp; both promote text to `bold` and lift the border to the default line, but move the surface only ~7–18 units.

Enable interactive (hover / focus / press) affordances and states.

Fires when the image fails to load (the component falls back to initials/icon either way).

Accessible alt text for the image. Defaults to `name`.

Custom fallback content rendered when no image is available. Overrides the derived initials / generic user icon.

Bound reference to the root element (`bind:this`).

Per-slot style and HTML attribute override bag.

Astro / vanilla: serialize the props into `data-avatar-config` so the client runtime hydrates this instance and `getPindoba(el, "avatar")` can `update()` it. Frameworks with their own reactivity don't need it.