of a bare callout into its own flex column. */
.callout {
padding: 0.9rem 1.15rem;
border-radius: var(--radius-md);
border: 1px solid;
border-left-width: 3px;
margin: 1.5rem 0;
color: var(--text-secondary);
line-height: 1.7;
}
.callout:has(> .callout-icon) {
display: flex;
gap: 0.75rem;
}
.callout strong {
color: var(--text-primary);
font-weight: 600;
}
/* Callout text already sits on a tinted panel, so the default inline-code
chip would stack a second background on top of it. */
.callout code {
background: color-mix(in srgb, var(--text-primary) 8%, transparent);
}
.callout > :first-child {
margin-top: 0;
}
.callout > :last-child {
margin-bottom: 0;
}
.callout-icon {
flex-shrink: 0;
width: 20px;
height: 20px;
/* Nudge onto the first line's optical centre rather than its box top. */
margin-top: 0.2em;
}
.callout-content {
flex: 1;
min-width: 0;
}
.callout-content > :first-child {
margin-top: 0;
}
.callout-content > :last-child {
margin-bottom: 0;
}
.callout-info {
background: color-mix(in srgb, var(--accent) 8%, transparent);
border-color: color-mix(in srgb, var(--accent) 22%, transparent);
border-left-color: var(--accent);
}
.callout-info .callout-icon {
color: var(--accent);
}
.callout-warning {
background: color-mix(in srgb, var(--warning) 10%, transparent);
border-color: color-mix(in srgb, var(--warning) 25%, transparent);
border-left-color: var(--warning);
}
.callout-warning .callout-icon {
color: var(--warning);
}
/* ===========================================
SIDEBAR - Pure CSS Responsive Behavior
=========================================== */
/* Sidebar base styles */
.sidebar {
position: fixed;
top: 0;
left: 0;
bottom: 0;
width: 280px;
background: var(--bg-secondary);
border-right: 1px solid var(--border);
display: flex;
flex-direction: column;
z-index: 100;
transition: transform 0.25s ease;
}
/* Hidden checkbox for mobile toggle */
.sidebar-checkbox {
display: none;
}
/* Hamburger button - mobile only */
.sidebar-hamburger {
display: none;
position: fixed;
top: 1rem;
left: 1rem;
z-index: 101;
width: 32px;
height: 32px;
cursor: pointer;
flex-direction: column;
justify-content: center;
align-items: center;
gap: 5px;
background: var(--bg-elevated);
border: 1px solid var(--border);
border-radius: var(--radius-md);
transition: all 0.15s ease;
}
.sidebar-hamburger:hover {
background: var(--bg-hover);
border-color: var(--border-hover);
}
.sidebar-hamburger span {
display: block;
width: 16px;
height: 2px;
background: var(--text-secondary);
transition: all 0.25s ease;
}
/* Overlay for mobile */
.sidebar-overlay {
display: none;
position: fixed;
inset: 0;
background: rgba(0, 0, 0, 0.5);
z-index: 99;
opacity: 0;
transition: opacity 0.25s ease;
pointer-events: none;
}
/* The docs column is a flex item (`flex-1` in docs/layout.html), and a flex
item's default `min-width: auto` floors it at its own min-content width
instead of at zero. Anything inside that refuses to wrap - a long code line
in a , the package-manager tab bar, an unbreakable token - therefore
pushed the WHOLE column wider than the viewport rather than scrolling inside
its own box. Measured on /docs/quick-start at a 375px viewport: the column
came out 583px wide, so every paragraph wrapped to 487px and was clipped at
the right edge (this is the "no build conf...", "PascalCa..." cut-off).
`min-width: 0` lets the column shrink to the viewport again; the and
.pm-body boxes already carry `overflow-x: auto`, so the wide content scrolls
inside them where it belongs. Not scoped to a media query on purpose - the
same floor applies at any width where the content's min-content exceeds the
space, and at desktop widths the column is far wider than its min-content so
nothing about the desktop layout changes. */
.docs-main {
min-width: 0;
}
/* Mobile: ≤1000px */
@media (max-width: 1000px) {
/* Show hamburger */
.sidebar-hamburger {
display: flex;
}
/* Sidebar hidden by default, with top padding to match desktop header height */
.sidebar {
transform: translateX(-100%);
padding-top: 2rem;
}
/* Main content full width */
.docs-main {
margin-left: 0 !important;
}
/* `px-12` is 48px a side - a third of a 375px phone spent on margin, which
left prose wrapping in a 279px ribbon. 24px matches what the homepage
hero drops to at this same breakpoint (`max-[1000px]:px-6`), so the two
templates share one mobile gutter. */
.docs-content {
padding-left: 1.5rem;
padding-right: 1.5rem;
}
/* A table whose columns cannot fit the phone would otherwise punch out of
the column and re-break the page the way the flex floor above did. As a
block box the table scrolls inside itself instead. It still lays out at
the column width whenever it fits - every table currently in the docs
does (widest min-content measured: 179px against 327px available) - so
this is a floor, not a change to how today's tables render. */
.docs-content table {
display: block;
overflow-x: auto;
}
/* The nav's home logo is already `visibility: hidden` on docs pages (the
sidebar carries the brand), and on mobile the sidebar's own logo is
hidden too - so the row was reserving 67px for the invisible logo plus
the 48px this rule used to keep clear for the hamburger. Measured on
/docs/quick-start at 375px, that pushed the theme toggle out to x=395:
entirely off the screen and untappable. Nothing is there to see or to
clear, so take the box out of the flow. `justify-between` cannot hold the
links against the right edge with only one child left, hence the auto
margin. Both halves are keyed to `body:has(.docs-main)` because docs.css
stays in the document after a client-side navigation away from /docs -
the old unguarded rule leaked its 3rem indent onto the homepage nav. */
body:has(.docs-main) .nav a[href="/"]:not(.nav-link) {
display: none;
}
body:has(.docs-main) .nav-links {
margin-left: auto;
}
/* Show overlay element (still invisible until checked) */
.sidebar-overlay {
display: block;
}
/* When checkbox is checked: show sidebar */
.sidebar-checkbox:checked ~ .sidebar,
.sidebar-checkbox:checked ~ * .sidebar {
transform: translateX(0);
}
/* When checkbox is checked: show overlay */
.sidebar-checkbox:checked ~ .sidebar-overlay {
opacity: 1;
pointer-events: auto;
}
/* Animate hamburger to X when open */
.sidebar-checkbox:checked ~ .sidebar-hamburger span:nth-child(1) {
transform: rotate(45deg) translate(5px, 5px);
}
.sidebar-checkbox:checked ~ .sidebar-hamburger span:nth-child(2) {
opacity: 0;
}
.sidebar-checkbox:checked ~ .sidebar-hamburger span:nth-child(3) {
transform: rotate(-45deg) translate(5px, -5px);
}
}
/* Desktop: >1000px - sidebar always visible */
@media (min-width: 1001px) {
.sidebar {
transform: translateX(0);
}
.docs-main {
margin-left: 280px;
}
}
/* Right-hand Table of Contents */
.toc-sidebar {
display: none;
}
@media (min-width: 1280px) {
.docs-main {
display: grid;
grid-template-columns: minmax(0, 900px) 160px;
gap: 1.5rem;
justify-content: center;
padding-inline: 1.5rem;
}
.toc-sidebar {
display: block;
position: sticky;
top: 5rem;
align-self: start;
max-height: calc(100vh - 6rem);
overflow-y: auto;
}
.toc-nav {
padding: 2.5rem 0 1rem 0;
}
.toc-title {
font-size: 0.75rem;
font-weight: 600;
text-transform: uppercase;
letter-spacing: 0.05em;
color: var(--text-tertiary);
margin-bottom: 0.75rem;
padding-left: 0.75rem;
}
.toc-list {
list-style: none;
margin: 0;
padding: 0;
}
.toc-item {
margin: 0;
}
.toc-item-nested {
padding-left: 0.75rem;
}
.toc-link {
display: block;
padding: 0.375rem 0.75rem;
font-size: 0.8125rem;
color: var(--text-tertiary);
text-decoration: none;
border-left: 2px solid transparent;
transition: all 0.15s ease;
line-height: 1.4;
}
.toc-link:hover {
color: var(--text-secondary);
}
.toc-link.active {
color: var(--accent);
border-left-color: var(--accent);
}
}
/* Adjust for extra-wide screens */
@media (min-width: 1536px) {
.docs-main {
grid-template-columns: minmax(0, 900px) 180px;
gap: 2rem;
}
}
/* JSX component demo (docs/advanced/react) -------------------------------- */
/* Plain CSS rather than a scoped