Panel

In review

Live · web

Header bar · body · footer, plus a collapsible panel

Session settings

nockerl-cli · primary

A panel is a persistent, in-layout region: a header bar with a title and actions, a padded body, and an optional footer. Larger than a card; not an overlay.

Unsaved changesResetSave

Context window

Showing usage

The header chevron collapses and expands the body. The transition animates grid height (flash-free) and freezes under reduced-motion. Click the header to toggle.

Toolbar row · inspector (key / value) · nested sections

Output

A toolbar row hosts secondary controls (toggles, actions) on a slightly raised tier between the header and the body. Word wrap is on.

Inspector

Selected session

Labelproject:nockerl-cli::primary

Enginecloud-agent

Modellarge-2.6

Statusidle

Last active12m ago

Advanced

Sampling

A panel can contain section panels: a nested surface a tier up, with its own header and body.

Permissions

Sections share the panel material at the control radius, divided by hairlines.

Split pane: two panels + a draggable, keyboard-operable splitter

Explorer

12 sessions

The left pane. Drag the splitter, or focus it and press Arrow Left / Right (Home / End to snap). Width is clamped between 25% and 75%.

Detail

nockerl-cli · gateway

The right pane fills the remaining space. A split-pane region stays in the layout; it is not an overlay like a drawer.

Saved 0 times · drag or arrow-key the splitter. The island is live.

The dev-console SIDE PANEL is a view, not a component

Per the agent-console de-phantom verdict (task 2656): the web console’s dockable side panel (inspector, outline, agent details) is a composition of this Panel (with its working splitter) beside the main surface, optionally inside a Drawer on narrow widths. It ships as an app VIEW; no DevSidePanel component exists or is planned. If drag-to-dock behavior is ever needed, it lands here as a Panel extension, never a fork.

Code

TypeScript

// Web: React, consuming @dizyx/nockerl-tokens. (Web is the laggard platform. Spec + live demo,
// not yet exported from @dizyx/nockerl-react; promotion is tracked.)

export function Inspector() {
  return (
    <Panel
      title="Session settings"
      subtitle="nockerl-cli · primary"
      leadingIcon={<SettingsIcon />}
      actions={<NockerlIconButton label="More" icon={<MoreIcon />} />}
      footer={<><NockerlButton variant="ghost">Reset</NockerlButton><NockerlButton>Save</NockerlButton></>}
    >
      <p>A persistent, in-layout region: larger than a card, not an overlay.</p>
    </Panel>
  );
}

// Collapsible: the header chevron toggles the body (aria-expanded).
<Panel title="Context window" collapsible defaultOpen>
  <UsageMeter />
</Panel>

// Split pane: two panels + a draggable, keyboard-operable resize handle.
<PanelGroup direction="horizontal">
  <Panel title="Explorer" minSize={25} defaultSize={46}><Tree /></Panel>
  <PanelResizeHandle />
  <Panel title="Detail"><Detail /></Panel>
</PanelGroup>

Kotlin

// Android: Jetpack Compose (canonical). There is no single NockerlPanel yet;
// a panel is COMPOSED from NockerlCard + NockerlPanelShape, exactly as the
// shipped ToolCallCard / AgentTranscriptPanel do. (See drift.)
import com.nockerl.app.core.theme.NockerlCard
import com.nockerl.app.core.theme.NockerlElevation
import com.nockerl.app.core.theme.NockerlPanelShape

NockerlCard(
    shape = NockerlPanelShape,                 // 12dp, a step tighter than a card
    color = LocalNockerlColors.current.cardSurface1,
    elevation = NockerlElevation.Level1,
    border = LocalNockerlColors.current.cardHairline,
    modifier = Modifier.fillMaxWidth(),
) {
    Column {
        // Header bar: icon tile + title/subtitle (start) · actions (end).
        Row(verticalAlignment = Alignment.CenterVertically, modifier = Modifier.padding(11.dp)) {
            ToolIconTile(icon = Icons.Filled.Tune, accent = colors.accentPrimary)
            Spacer(Modifier.width(8.dp))
            Text("Session settings", fontWeight = FontWeight.SemiBold, modifier = Modifier.weight(1f))
            // Collapse toggle. The header chevron drives AnimatedVisibility(expanded).
            Icon(if (expanded) Icons.Filled.KeyboardArrowUp else Icons.Filled.KeyboardArrowDown, null)
        }
        AnimatedVisibility(visible = expanded) {      // flash-free collapse
            Column(Modifier.padding(11.dp)) { /* body */ }
        }
    }
}

Swift

// macOS: SwiftUI (canonical). The titled content panel is SettingsCard
// (NockerlVoice/UI/SettingsComponents.swift): a header label row + body, on the
// chrome surface with a hairline + the lit-from-above elevation.
SettingsCard("Session settings", info: "nockerl-cli · primary") {
    Text("A persistent, in-layout region: larger than a card, not an overlay.")
        .foregroundStyle(NockerlTheme.onSurface)
}

// Split pane: Voice builds it by hand (a fixed-width pane + content in an
// HStack), deliberately NOT NavigationSplitView (its opaque sidebar fights the
// facet background). See drift.
HStack(spacing: 0) {
    leftPane.frame(width: 216)
    Rectangle().fill(NockerlTheme.hairline).frame(width: 1)   // the divider
    detail.frame(maxWidth: .infinity, maxHeight: .infinity)
}

Parameters

TypeScript

Prop	Type	Default	Description
title *	string	n/a	Header bar title. Bound to the title.small type role.
subtitle	string	n/a	Optional second line under the title (muted).
leadingIcon	ReactNode	n/a	Optional glyph rendered in the accent header tile.
actions	ReactNode	n/a	Header-bar actions, right-aligned (icon buttons / overflow).
toolbar	ReactNode	n/a	Optional control strip on a raised tier between the header and body.
footer	ReactNode	n/a	Optional footer content; actions are right-aligned by convention.
collapsible	boolean	false	Renders the header as a toggle (aria-expanded); the body collapses flush.
defaultOpen	boolean	true	Initial expanded state when collapsible.
children	ReactNode	n/a	Body content. Padded by the panel; never bleeds to the edge.

PanelGroup takes direction ('horizontal' | 'vertical'); each Panel in a group accepts minSize / maxSize / defaultSize (percent), and PanelResizeHandle is the draggable, keyboard-operable (role="separator", Arrow keys) splitter.

Kotlin

A panel is composed from NockerlCard. These are its panel-relevant parameters; the header / body / footer / collapse are built in the content lambda (icon tile, title Row, AnimatedVisibility).

Parameter	Type	Default	Description
modifier	Modifier	Modifier	External modifier (size, alignment, .clickable { } for a collapse toggle).
shape	Shape	NockerlPanelShape	Panel silhouette: the 12dp NockerlPanelShape (a step tighter than the 18dp card).
color	Color	cardSurface1	Surface fill. Nested section panels step up to cardSurface2.
elevation	Dp	NockerlElevation.Level1	Drop-shadow elevation. Panels sit low (Level1); the lift reads from the hairline + catch-light.
border	Color?	cardHairline	Hairline border. Header / body / footer dividers are separate hairlines.
content *	@Composable BoxScope.() -> Unit	n/a	Panel content: the header Row, body, and (in AnimatedVisibility) the collapsible region.

Swift

The titled panel is SettingsCard (NockerlVoice/UI). The parameters below are its real signature; the split-pane region is hand-built from layout primitives + the theme tokens (no panel wrapper).

Style	Type	Default	Description
title *	String	n/a	Header label (rendered UPPERCASE, tracked, muted) in the header row.
info	String?	nil	Optional help text. Adds an InfoTip ⓘ beside the title.
content *	@ViewBuilder -> Content	n/a	Panel body, laid out under the header.
NockerlTheme.chromeSurface	Color	n/a	Panel fill (#15171A dark / #FFFFFF light).
NockerlTheme.panelRadius	CGFloat	12	Panel corner radius, matching radius.panel (SettingsCard currently uses cardRadius = 14; see drift).
NockerlTheme.hairline	Color	n/a	Hairline border + the split-pane divider rectangle.
.nockerlElevation()	modifier	n/a	The lit-from-above neutral shadow (soft black; near-invisible on dark, structure on light).

Cross-platform drift (tracked for reconciliation)

Panel vs. card vs. drawer: a panel is a persistent, in-layout region defined by a header bar + body (+ footer). It is larger than a card (a content tile) and, unlike a drawer, it stays in the layout rather than overlaying as an edge-anchored sheet. The real divergences:

• No panel component yet (web + Android + Swift). Web ships the intended Panel / PanelGroup API above; Android composes a panel from NockerlCard + NockerlPanelShape (as ToolCallCard / AgentTranscriptPanel do); Swift’s closest is SettingsCard (title + body, no footer / toolbar / collapse). One Panel wrapper per platform is the planned step.
• Panel radius: the token radius.panel is 12 (Compose NockerlPanelShape = 12dp matches). Swift’s SettingsCard uses cardRadius (14pt) though NockerlTheme.panelRadius (12) exists; it should read the panel token.
• Split pane: web has a draggable, keyboard-operable PanelResizeHandle (role="separator" + Arrow keys). Swift builds a fixed-width pane in an HStack (no live resize) and deliberately avoids NavigationSplitView (its opaque sidebar fights the facet background). Compose has no split-pane idiom yet.
• Collapse: web animates grid height; Compose uses AnimatedVisibility; Swift SettingsCard has no collapse. One collapse affordance needs to win.