Migrate semantic color tokens to 6×4 seeds with pure CSS color-mix() aliases
Replaced static 12-step ramps with primary, info, success, warning, error, and accent state seeds so ConfigProvider overrides cascade automatically.
Use Outline to navigate a long conversation or document from a narrow rail at its edge, which takes almost no width until it is hovered or focused. For a classic “On this page” list that is always readable, use Anchor.
Outline is a compact edge-mounted navigation rail modeled on conversation and workspace outlines. At rest it occupies only a narrow strip of horizontal ticks so content keeps its full width; on pointer hover or keyboard focus it expands in place into a floating card showing single-line summaries, metadata, and optional preview tooltips, jumping on click.
Use targetId + offsetTarget to track DOM scroll position automatically like Anchor, or drive value + onSelect directly when pairing with VirtualList where off-screen items are not mounted in the DOM.
Each milestone or user prompt becomes a tick: emphasized highlights the current user’s own turns at rest, meta renders the timestamp, and tooltip previews the full prompt beside the floating row. Scrolling updates and auto-centers the active Jade tick; hovering the right rail opens the jump card.
Migrate semantic color tokens to 6×4 seeds with pure CSS color-mix() aliases
Replaced static 12-step ramps with primary, info, success, warning, error, and accent state seeds so ConfigProvider overrides cascade automatically.
Verify dark mode surface contrast across canvas, card, modal, and raised popovers
Mapped canvas (#101014), card (#18181c), modal (#2c2c32), and raised popover (#48484e) surfaces so floating layers separate cleanly.
Switch dark mode solid primary button text ink to obsidian #101014 for APCA readability
Flipped base ink polarity on Mint #63e2b7 fills while keeping suppl anchors deep for fixed-white Switch thumbs.
Audit Tag and Badge subtle backgrounds so dark surfaces never stack muddy gray fills
Updated bordered tags to use crisp translucent hairlines over transparent ground in dark scopes.
Align ButtonGroup shared borders and split-button dividers with Naive UI behavior
Collapsed resting shared inner edges while keeping hover/focus rings intact, and added a 1px inner separator between adjacent solid buttons.
Check subpixel height consistency on soft secondary and tertiary horizontal ButtonGroups
Switched soft buttons inside groups to border-box background clipping so first, middle, and last buttons share identical height.
Keep only the official VirtualList implementation in docs, routes, and package exports
Removed experimental reference virtual lists and verified zero residual build plugins or native scrollbar regressions.
Ensure ScrollArea inside VirtualList and floating popovers hides native scrollbars everywhere
Passed the repository-wide no-native-scrollbars contract across all component stylesheets.
Extract a generic Outline rail component modeled on Raft's conversation outline strip
Built Outline with a 30px edge tick strip, hover/keyboard floating card, and active tick auto-centering.
Cap the floating card height with ScrollArea when a thread grows past ten turns
Wrapped both the rail and the floating card in ScrollArea with hover-triggered small scrollbars and inset gutters that clear the right-hand ticks.
Constrain Outline row width with PerformantEllipsis truncation and automatic full-text Tooltip
Locked card width to --p-outline-card-width and composed PerformantEllipsis so overlong rows truncate cleanly and reveal full text on hover.
Add keyboard ArrowUp, ArrowDown, Home, End, and Escape focus restoration to Outline
Roving tabIndex keeps a single Tab stop on the active tick, and Escape closes the card while returning focus cleanly.
Rebrand package scope to @pika-lab/react with .p-* classes and --p-* / --pw-* / --pl-* CSS variables
Migrated workspace packages, defaultClsPrefix, token scopes, and bilingual documentation to Pika.
Run full build, type-aware lint, SSR prerender, and unit test suite before opening preview
Verified all prerendered documentation routes and component contract tests pass with zero warnings.
Pass depth to indent nested sections, switch sides with placement="left", or pin the floating card open with controlled show.
Semantic state seeds define hue and polarity once at the root scope so overrides cascade without rebuilding ramps.
Light anchors crisp Jade (#18a058) while Dark shifts to Mint (#63e2b7) with dark ink on solid fills.
Deep suppl tokens keep fixed-white Switch thumbs and status badges legible in dark mode.
Terracotta (#c85a32 / #e89574) pairs warm earth tones with Jade without cold violet drift.
Four obsidian Z-elevation tiers separate canvas, card, modal, and floating popovers.
Canvas and sunken code wells sit below card surfaces so layout framing stays quiet.
Dialogs and floating menus step up in lightness instead of relying on heavy drop shadows.
Components consume only semantic alias roles so nested ConfigProvider scopes re-evaluate cleanly.
Local --pl-* slots isolate variant overrides from the public token surface.
Focus halos combine a crisp 1px border shift with a soft translucent outer ring.
Overlay scrollbars use native scroll containers with sticky zero-height gutter layers.
PerformantEllipsis defers DOM truncation measurement until pointer entry or focus.
Outline combines ScrollArea and PerformantEllipsis for dense navigation strips.
Omit targetId to control Outline purely via value, onUpdateValue, and onSelect—ideal for calling listRef.current?.scrollTo({ key }) on a VirtualList.
Active ticks stay centered in the compact rail even when a thread grows past hundreds of turns.
| Name | Type | Default | Description | Version |
|---|---|---|---|---|
items | readonly OutlineItem[] | Ordered outline entries; renders nothing when empty. | Unreleased | |
value | string | null | undefined | Controlled active item key. | Unreleased |
defaultValue | string | null | null | Initial active item key when uncontrolled. | Unreleased |
onUpdateValue | (value: string | null) => void | undefined | Called whenever scroll-spy or selection changes the active key. | Unreleased |
onSelect | (key: string, item: OutlineItem) => void | undefined | Called when a compact tick or floating card row is clicked. | Unreleased |
placement | 'right' | 'left' | 'right' | Edge the rail sits on; the floating card opens inward. | Unreleased |
show | boolean | undefined | Controlled visibility of the floating card. | Unreleased |
defaultShow | boolean | false | Initial visibility of the floating card when uncontrolled. | Unreleased |
onUpdateShow | (show: boolean) => void | undefined | Called when hover, keyboard focus, Escape, or outside clicks open or close the card. | Unreleased |
closeOnSelect | boolean | false | Close the floating card immediately after clicking an item. | Unreleased |
maxVisibleItems | number | 10 | Maximum visible rows in the floating card before its ScrollArea scrolls. | Unreleased |
maxRailHeight | number | string | 240 | Maximum height of the compact tick strip before auto-centering scroll kicks in. | Unreleased |
bound | number | 24 | Distance in px from the scroll container’s top at which a targetId counts as reached. | Unreleased |
ignoreGap | boolean | true | Keep the last passed item active across gaps between targets. | Unreleased |
offsetTarget | OutlineOffsetTarget | window | Scroll container for targetId scroll-spy and smooth scrolling (selector, element, ref, or getter). | Unreleased |
zIndex | number | undefined | Fixed z-index for the floating card instead of automatic overlay stacking. | Unreleased |
aria-label | string | Locale Outline.label | Accessible name of the nav landmark ("Outline" by default). | Unreleased |
| Name | Type | Default | Description |
|---|---|---|---|
key | string | Unique identifier matched against value and passed to onSelect. | |
label | ReactNode | Single-line summary in the floating card; string labels also name the compact tick button. | |
textValue | string | undefined | Plain-text accessible name for the compact tick when label is non-string JSX. |
meta | ReactNode | undefined | Trailing metadata in the floating card (for example a timestamp or turn number). |
tooltip | ReactNode | (() => ReactNode) | undefined | Rich preview tooltip displayed beside the floating row on hover. |
targetId | string | undefined | Target element id (with or without #) inside offsetTarget. |
emphasized | boolean | undefined | Renders a stronger tick at rest (e.g. for the current user’s own turns or top-level headings). |
depth | number | 0 | Nesting depth (0, 1, 2…); nested items draw shorter ticks and indented card labels. |