--gog-*
Theming
Every value the library paints with is a plain CSS custom property. No build step, no Sass config, no JS theming API required to change how it looks.
Pick a component, tweak its tokens live and copy the result — no IDE guesswork.
Guild of Gleks UI is themed entirely through CSS custom properties (--gog-*). There is
no build step, Sass config or JS theming API required to change how it looks — every
value the library paints with can be overridden from plain CSS.
How theming is layered
Foundation — the base palette, type scale, spacing and motion tokens (
--gog-accent-color,--gog-background-color,--gog-text-xs,--gog-radius, …). Overriding these restyles the whole library at once.Component — tokens scoped to one component (
--gog-button-*,--gog-accordion-*,--gog-table-*, …). Most derive from the foundation layer, so a palette swap already carries through; override a component token directly only when you need to restyle just that component.Instance — a handful of tokens (
--gog-button-bg,--gog-tag-bg, …) are left undeclared on purpose, as an escape hatch for styling a single element without touching a theme at all:html<gog-button style="--gog-button-bg: #ff4edb">One-off button</gog-button>
The character layer
A named part of Foundation, and the short path to a custom look: corner rounding
(--gog-radius), the three border-weight tiers (--gog-control-border-* for form fields,
--gog-panel-border-* for raised surfaces like dialogs, and the plain --gog-border-* pair
for everything smaller and inline — chip, tag, table row), emphasis casing and tracking
(--gog-text-transform, --gog-letter-spacing), weight (--gog-font-weight-regular …
-heavy) and leading (--gog-line-height-none … -loose), and density (--gog-density,
the single multiplier every padding and gap in the library derives from). Most component tokens
read one of these instead of declaring their own literal, so a theme is expected to set these —
not the dozens of component tokens that derive from them. material.css, primeng.css and
ledger.css are what a theme with real character looks like once it uses this layer instead of
re-listing component tokens: each is a short list of declarations, not a fork of the whole
stylesheet. Try them in the Theme Generator, which edits this exact
layer live.
One number instead of fifty
The axes above are all the same bet: a value that appears in many component tokens is worth
extracting so a theme can move all of them at once. It is worth stating plainly, because the
alternative looks reasonable right up until you try it — a house style that wants lighter chrome
edits --gog-font-weight-*, not the fifteen component weights that used to each hold a bare
number, and one that wants roomier text edits --gog-line-height-* rather than the twenty that
held theirs. Seven of those twenty were the same 1.4, which is what a missing axis looks like
from the inside: the same decision made over and over, independently, with nothing naming it.
Field labels are the same bet one level up. 21.15.0
Every form control's label — inputfield, select, multiselect, autocomplete, datepicker, slider,
radio group — reads one family, --gog-field-label-* (-color, -font-family, -font-size,
-font-weight, -letter-spacing, -line-height, -text-transform). Set it to restyle all of
them at once. The per-component tokens (--gog-select-label-color and the rest) still work, one
component at a time.
--gog-z-base is the clearest demonstration, because you can watch the whole library move.
It is the stacking floor, and every layer is base + N — badge +1, toast +100, dropdowns,
dialogs and menus +300, tooltip +400, the blocking spinner overlay +8000. An app with its
own fixed header that has to sit above or below the library changes one number:
:root {
--gog-z-base: 10000;
}
Every layer follows and the order between them is untouched — the badge is still under the
toast, the tooltip still over the dropdown. Setting --gog-dropdown-z directly is the version
of this that goes wrong: it moves one layer out of a stack the other four still agree on.
The elevation ladder
The same bet again, and the clearest case of it, because before the ladder eleven themes hand-authored twenty-two shadow values with no stated relationship between any two of them — and two of those themes gave a modal dialog the elevation of a card, because restating the second value was work.
There is now one ladder of six heights, --gog-elevation-0 through -5, and every raised
surface in the package reads a step off it. Z doubles: 0, 1, 2, 4, 8, 16. A height is assigned by
what a thing is, not by how heavy it should look:
| Step | What sits on it |
|---|---|
| 0 | flat — in the flow of the page |
| 1 | a thumb riding on a control (the toggle's) |
| 2 | an elevated card or panel |
| 3 | anything anchored to a control — the four dropdown panels, the menu, the tooltip |
| 4 | a toast |
| 5 | a modal dialog |
You do not write a step. A theme turns ten knobs and all six follow:
:root[data-theme='midnight'],
[data-theme='midnight'] {
--gog-elevation-ink: 0 0 0; /* unwrapped RGB, so the alphas below can composite it */
--gog-elevation-key-alpha: 0.55;
--gog-elevation-ambient-alpha: 0.28;
--gog-elevation-contact-blur: 3px;
--gog-elevation-key-x: 0;
--gog-elevation-key-y: 1;
--gog-elevation-key-blur: 3;
--gog-elevation-ring-width: 1px;
--gog-elevation-highlight-ink: 255 255 255;
--gog-elevation-highlight-alpha: 0.07;
}
State all ten or none — and this is the one that will bite. Custom properties inherit, so a theme block declaring six of them silently borrows the other four from whatever encloses it. There is no error; you get a shadow that looks nearly right, on some surfaces, in one theme.
A step is two lights. The contact shadow hugs the object and does not grow with height — that
is what ambient occlusion does, and it is what this library already did every time it hand-wrote
two soft layers. The key light is the one that moves: its offset is Z and its blur three times
it. Those three multipliers are the style axis, and between them they cover every look the eleven
shipped presets actually use. Soft is the default. A hard-offset theme — bevel, ledger — sets
x and y to a fraction and blur to 0. A glow theme — terminal — sets y to 0 and keeps the
blur, and the key light becomes a halo without the ladder knowing anything about halos.
Two things are deliberately outside the steps, as their own tokens: the hairline ring and the
top-edge catch light. They belong to particular surfaces rather than to height — a dark theme's
overlay wants the ring and its in-flow elevated card must not have it, or elevated and
outlined render identically. A component composes them:
box-shadow: var(--gog-elevation-ring), var(--gog-elevation-3).
--gog-panel-shadow, --gog-dialog-shadow and --gog-toast-shadow are still the names you
override for one surface, and overriding one works exactly as it always did. What changed is their
value: each is now a step rather than a literal, so a theme that turns one knob moves all of them
together and keeps the order between them intact.
--gog-density is the same idea applied to spacing, and since 21.9.0 the claim above it is
literally true rather than nearly so. Fourteen lengths were still bare pixels that ignored it —
dropdown panel gaps, the menu offset, a clear button's inset, two error-line offsets — so a
theme that tightened everything left those where they were. They read the scale now, which is
worth knowing if you had compensated for it.
What index.css pulls in
One import is the whole setup, and it is a thin wrapper over four files:
| File | What it carries |
|---|---|
theme.css |
every --gog-* token the components read, in both the light and dark layers |
typography.css |
the font-body / font-heading helpers component templates apply to themselves |
utilities.css |
the utility classes those templates rely on (gog-contained-layout, …) |
button.css |
the [gogButton] directive's styles — global because that directive styles an element you wrote (an <a>), which no component stylesheet can reach |
fonts.css is deliberately not among them: it pulls three families from Google Fonts, which a
library has no business imposing. Import it explicitly if you want this site's typography.
The full catalogue of tokens ships with the package as TOKENS.md — generated from
theme.css, so it cannot drift. The Token Reference at the bottom of this page is the same data,
browsable.
Built-in themes
The library ships two themes, light and dark, switched with a data-theme
attribute on any element (usually <html>):
<html data-theme="dark"></html>
data-theme can also be scoped to a smaller subtree, so several themes can render
side by side on the same page.
Ready-made presets
Nine presets ship as importable stylesheets, each at styles/presets/<name>.css and
activated by data-theme="<name>". Until 21.7.0 there were three and each declared palette
tokens only; that framing is gone. All nine now set palette and character — corner
rounding, border weight, density, label casing — which is what makes them identities rather than
recolours. None of them names a single component token it does not have to.
| Preset | data-theme |
The identity |
|---|---|---|
| Slate | slate |
soft modern — 12px corners, hairline borders, roomier than the default |
| One Dark / One Light | one-dark, one-light |
editor chrome — 4px corners, compact, sentence case; one UI, two tones |
| Material / PrimeNG | material, primeng |
Material Design 3 and PrimeNG Aura, including their shape and density |
| Ledger | ledger |
administrative software — square corners, hard offset shadow, no motion |
| Terminal | terminal |
green phosphor — monospaced throughout, square, no motion |
| Bevel | bevel |
the early-web desktop — raised buttons, sunken fields, grey and navy |
| Parchment | parchment |
ink on laid paper — old-style serif, oxblood accent, roomy |
Every one of them is in the theme switcher in this site's header. Try material or primeng
against the comparison pages: those two are the point of the exercise made literal — the
library wearing another ecosystem's identity, from one imported stylesheet and no component code.
Add the one you want to your global styles, then set the attribute:
"styles": [
"node_modules/@guildofgleks/ui/styles/index.css",
"node_modules/@guildofgleks/ui/styles/presets/one-dark.css",
"src/styles.scss"
]
The short path arrived in 21.3.2 and is the only one from 21.5.0, which dropped the duplicate
./src/styles/*export. If yourangular.jsonstill names@guildofgleks/ui/src/styles/…, drop thesrc/segment. The short path is listed in the package'sexportsmap, which means it resolves from a SCSS@import '@guildofgleks/ui/styles/theme.css'as well; the old path never did.
<html data-theme="one-dark"></html>
The One presets map the editor's syntax hues onto the library's semantic roles — blue becomes the
accent, and green / red / yellow / cyan become success / danger / warning / info. Neither preset
mentions --gog-button-primary-bg by name, yet buttons pick it up: that is the derived layer
re-resolving, and it is why a preset can be a short list of declarations rather than a fork of the
whole stylesheet.
No preset downloads a font
Importing a preset never adds a network request. Each one sets a stack that resolves to a real
system face — the platform's own monospace for terminal, Tahoma/Verdana for bevel, Iowan Old
Style/Palatino for parchment. Where a webfont makes a visible difference it lives in a separate
opt-in file you import after the preset:
@import '@guildofgleks/ui/styles/presets/parchment.css';
@import '@guildofgleks/ui/styles/presets/parchment.fonts.css'; /* optional: EB Garamond */
terminal.fonts.css (IBM Plex Mono) is the other one. This site imports neither, on purpose:
a global stylesheet is loaded whether or not anyone picks that theme, and making every visitor pay
for a font two of eleven themes use would contradict the rule this section is stating. So
terminal and parchment render here in their system stacks — which is exactly what a consumer
who imports the preset alone will see.
Switching the theme from code
ThemeService wraps that attribute in a signal-based API:
import { Component, inject } from '@angular/core';
import { ThemeService } from '@guildofgleks/ui';
@Component({
selector: 'app-theme-switcher',
template: `
<button (click)="setDark()">Dark</button>
<button (click)="toggle()">Toggle</button>
`,
})
export class ThemeSwitcher {
private readonly themeService = inject(ThemeService);
protected readonly theme = this.themeService.theme; // Signal<string> — read-only
setDark(): void {
this.themeService.setTheme('dark');
}
toggle(): void {
this.themeService.toggleTheme(); // flips between 'light' and 'dark'
}
}
theme is a read-only Signal, so setTheme / toggleTheme are the only way to change it.
That is the point: the service also writes the data-theme attribute and persists the choice, and
a .set() straight onto the signal skipped both — the document kept its old theme while the signal
claimed otherwise.
Which theme it starts on, whether the choice survives a reload, and whether it follows the OS
setting are all configured through GOG_CONFIG.theme
— see
Global Configuration.
This is exactly what the theme switcher (the palette icon) in this site's header uses.
Building your own theme
Declare a palette against a new data-theme value. List both selectors so the theme
works at the document root and on any subtree:
:root[data-theme='midnight'],
[data-theme='midnight'] {
color-scheme: dark;
/* Surfaces */
--gog-background-color: #0b0f1a;
--gog-surface-color: #131a2b;
--gog-hover-color: #1c2540;
--gog-border-color: #2a355a; /* decoration: dividers, table rules, panel outlines */
--gog-control-boundary-color: #6b7aa8; /* identity: the edge of a chip, a switch, a segment */
/* Text */
--gog-text-color: #e8ecf7;
--gog-muted-text-color: #8892b0;
--gog-accent-text-color: #0b0f1a;
/* Brand & accents */
--gog-primary-color: #e8ecf7;
--gog-accent-color: #5b8dff;
--gog-accent-bright: #82a9ff;
--gog-accent-dim: #35528f;
--gog-accent-pale: #1c2c52;
--gog-secondary-color: #7b6bff;
/* Semantic */
--gog-success-color: #2fbf71;
--gog-danger-color: #ef4565;
--gog-warning-color: #f2a541;
--gog-info-color: #38bdf8;
/* Elevation — all ten knobs or none; see the ladder above */
--gog-elevation-ink: 0 0 0;
--gog-elevation-key-alpha: 0.55;
--gog-elevation-ambient-alpha: 0.28;
--gog-elevation-contact-blur: 3px;
--gog-elevation-key-x: 0;
--gog-elevation-key-y: 1;
--gog-elevation-key-blur: 3;
--gog-elevation-ring-width: 1px;
--gog-elevation-highlight-ink: 255 255 255;
--gog-elevation-highlight-alpha: 0.07;
}
Then switch to it exactly like a built-in theme:
themeService.setTheme('midnight');
Because every component token derives from these foundation tokens, a new palette propagates through buttons, tables, dialogs and everything else without touching a single component stylesheet.
Colour that is checked rather than eyeballed
A theme is the one part of this library a consumer writes from scratch, and colour is the part of that which fails silently: nothing renders wrong, nothing throws, and some fraction of your readers simply cannot use the result. So the palettes here are computed and gated rather than picked, and the tooling that does it ships in the repository.
Two kinds of border, and only one of them is a boundary
--gog-border-color is decoration — dividers, table rules, panel outlines — and is deliberately
faint. --gog-control-boundary-color
is the edge that identifies a
control, and WCAG SC 1.4.11 requires it to clear 3:1 against whatever the control sits on.
They cannot be one token, and the proof is what happened while they were: gog-chip, gog-toggle
and gog-button-toggle read the decorative colour as their own edge and measured 1.18 to 2.17:1
in every shipped theme — neither their border nor their fill carried the boundary, so a switch in
its off state was, to WCAG, not there. A theme that sets only the decorative colour has to choose
between shouting its dividers and hiding its controls. Set both.
suggest:color — a check that names the value that would pass
A failing ratio tells you something is wrong; it does not tell you what to write instead. The repository ships a solver that does:
npm run suggest:color -- '#2a355a' '#131a2b' 3.2
# #2a355a on #131a2b: 1.45:1 → #5b6991 3.20:1 (hue and chroma held)
It walks lightness in OKLCH and holds hue and chroma, so the value it hands back is still recognisably your theme's neutral rather than a grey that happens to pass. Every one of the eleven shipped presets' boundary colours was produced this way.
What a contrast ratio cannot see
WCAG's ratio is a luminance formula. It is the right tool for "can this text be read", and it is
blind to three things that are just as much defects — all three passed it comfortably while being
wrong. npm run check:oklch
gates them, in OKLCH, where lightness,
chroma and hue come apart:
- A state step that is invisible. Hover and pressed have to read as different from the rest state. Gated at ΔL ≥ 0.03, roughly the just-noticeable difference for an area of flat colour.
- A status colour that has stopped being a colour. Near-grey stops signalling; maximum chroma reads as neon in a parchment theme. Gated to a band, 0.04 ≤ C ≤ 0.25.
- Two statuses that are the same colour. Every pair of the four must differ by ≥15° of hue
or ≥0.10 of lightness — a disjunction, because hue alone fails a reader with achromatopsia
and lightness alone fails nothing at all.
terminal's success and info sat 4.6° apart, which is two statuses one badge could not tell apart in any rendering.
Every threshold was measured across all eleven palettes before it was set, never the other way round — a threshold chosen in advance is a threshold chosen to flatter what is already there. One rule that looked obvious did not survive that: "the ramp must be monotonic in lightness" fails eight of the eleven, and eight of them are right, because on a light ground the hover fill is darker than the rest state. What is checkable is that the step exists, not which way it points.
Between them, check:contrast (3995 pairs across the eleven themes, including every control
boundary and every focus indicator) and check:oklch are CI steps. If you fork a preset, they are
worth running against your own file.
Rules of thumb
- Prefer overriding foundation tokens over chasing individual component tokens — you get the whole library restyled for the price of one palette.
- Don't hardcode colors in your app that duplicate a token — reference the token instead, so it keeps following theme switches.
- A panel appended to
<body>(dropdowns with[appendToBody], toasts, tooltips, the datepicker's calendar) follows its trigger's theme, not the DOM position it renders at — no extra wiring needed on your side. When the theme is scoped to a subtree the panel gets a copy of thatdata-theme; when it sits on<html>, as it usually does, plain inheritance already does the job. - Custom properties set inline on
<html>reach overlays too, which is what makes a runtime theme editor — like this site's Theme Generator — work. Before 21.4.1 an overlay copied the document'sdata-themeonto itself and, in doing so, re-declared every component token from the plain preset, discarding anything the page had set on the root.
The Elevation Ladder
Six heights, one per step, on this theme's own surface colour. Z doubles — 0, 1, 2, 4, 8, 16 — and every raised surface in the package reads one of them. Change the theme in the header and watch all six move together: that is the whole point of the family.
On a dark theme these six will look nearly alike, and that is the honest result rather than a broken demo: a black blur on a near-black page reads as smudge, not as lift. Each tile here paints the step alone, which is what the token is. A real component composes it with the two layers that sit outside the ladder — box-shadow: var(--gog-elevation-ring), var(--gog-elevation-3) — and on a dark theme it is that hairline ring and the top-edge catch light doing the work the shadow cannot. Switch to a light theme to watch the ladder itself climb.
Token Reference
Every CSS custom property a component paints with, grouped by area. Override any of them — on a single instance, a subtree, or a theme — to restyle the library.
| Token | Value | Description |
|---|---|---|
--gog-background-color | | Page / app background. |
--gog-surface-color | | Card, panel and control surface background. |
--gog-hover-color | | Hover background for interactive surfaces. |
--gog-border-color | | The decorative hairline — dividers, table rules, panel outlines — and deliberately faint. It is not the edge of a control; that is the token below. |
--gog-control-boundary-color | | The edge that identifies a control, and the one WCAG SC 1.4.11 measures: it has to clear 3:1 against whatever the control sits on. Split off from --gog-border-color in 21.12.0, because one token cannot be both — a theme that sets only the decorative one either shouts its dividers or hides its controls, and three of this package’s own presets were doing the second, at 1.18 to 2.17:1. gog-chip, gog-toggle and gog-button-toggle read it. Set both, and check the boundary rather than eyeballing it: npm run suggest:color in the repo computes a value that clears a target ratio while holding your theme’s own hue and chroma. |
--gog-text-color | | Primary text color. |
--gog-muted-text-color | | Secondary / placeholder text color. |
--gog-accent-text-color | | Text color placed on top of an accent-colored background. |
--gog-primary-color | | Primary brand color. |
--gog-accent-color | | Accent / brand color used for interactive elements. |
--gog-accent-bright | | Brighter accent, used for hover states. |
--gog-accent-dim | | Dimmed accent, used for borders and strokes. |
--gog-accent-pale | | Pale accent tint, used for subtle backgrounds. |
--gog-secondary-color | | Secondary brand color. |
--gog-success-color | | Semantic success color. |
--gog-danger-color | | Semantic danger / error color. |
--gog-warning-color | | Semantic warning color. |
--gog-info-color | | Semantic info color. |
--gog-success-text-color / --gog-danger-text-color / --gog-warning-text-color / --gog-info-text-color | | The label a status fill carries, the way --gog-accent-text-color is the accent’s. Each defaults to the accent’s answer, so state one only where your own hue disagrees — and check it, because getting this wrong is silent: white on a bright amber measured 1.97:1 in one of this package’s own presets before these existed. |
--gog-success-shade / --gog-danger-shade / --gog-warning-shade / --gog-info-shade | | Which way a status fill deepens when hovered or held: away from its own label, so the state always makes the label easier to read rather than harder. Defaults to the page’s ink, which is right when the label is white — set it to the opposite when the label is the ink itself. |
--gog-panel-shadow / --gog-dialog-shadow / --gog-toast-shadow | | The surfaces that lift, and still the names you override for one of them. Since 21.12.0 their value is a step off the elevation ladder rather than a hand-written shadow — panel 3, toast 4, dialog 5 — so turning one knob in the Elevation family moves all of them together and keeps the order between them. The gog-panel component reads the first. |
| Token | Value | Description |
|---|---|---|
--gog-font-heading | | Font stack used for headings and titles. |
--gog-font-body | | Font stack used for body text. |
--gog-font-mono | | Monospace font stack (code, numeric values). |
--gog-text-xs … --gog-text-3xl | | Type scale, from 0.75rem to 3rem. |
--gog-text-2xs | | 0.6875rem (11px), one step below xs and the bottom of the scale. It exists because the smallest chip and the smallest tag were already painting 11px as a literal — the step was being used before it had a name. |
--gog-text-slg | | 20px, between lg and xl — named for the control size it serves rather than continuing the t-shirt run, because that is what asked for it. gog-button and the field controls both needed a step for their slg size and, having none, both wrote 1.25rem as a literal. |
| Token | Value | Description |
|---|---|---|
--gog-radius | | Base corner radius used across most components. |
--gog-panel-radius | | Corner radius for larger panels, derived from --gog-radius — and the gog-panel component’s own, which reads the same token. |
--gog-border-width / --gog-border-style | | Border weight for small inline elements — chip, tag, table row — the tier below panel and control. |
--gog-panel-border-width / --gog-panel-border-style | | Border width and style for elevated panels — and for the gog-panel component, which reads the same pair. |
--gog-control-border-width / -style | | Border weight for form controls (buttons, fields) — the thickest of the three tiers. |
--gog-text-transform | | Emphasis casing shared by buttons, section headers, table headers and field labels. |
--gog-letter-spacing | | Emphasis tracking, paired with --gog-text-transform. |
--gog-font-weight-regular / -medium / -semibold / -bold / -heavy | | Weight, the third character axis. Set these and every component weight follows; before them, fifteen component tokens each held a bare number. The regular (400) step arrived in 21.15.0 and is what field labels are set in. |
--gog-line-height-none / -tight / -snug / -normal / -relaxed / -loose | | Leading, the fourth. Six steps because six values are painted. gog-panel’s heading keeps its own 1.25, off this scale on purpose the way an 11px chip is off the type scale. |
--gog-density | | Single multiplier every component padding and gap derives from — set once for a tighter or roomier library, never a component padding directly. |
| Token | Value | Description |
|---|---|---|
--gog-space-4 … --gog-space-48 | | The ten-step scale every padding and gap in the library is built from — 4, 8, 12, 16, 20, 24, 28, 32, 40, 48, every one of them a multiple of 4. Each step is calc(Npx * var(--gog-density)), so the whole scale moves together when density changes. It was fourteen steps until 21.11.0; the five odd ones (2, 6, 10, 14, 18) are gone, and a stylesheet still naming one should take the neighbouring step, rounding up, which is the direction the library itself took. |
--gog-space-xs … --gog-space-2xl | | Five named aliases onto that scale — 4, 8, 16, 24 and 48px at density 1. Convenience names, not a second scale: they derive from the numeric steps above, so overriding one with a literal takes it out of density. |
| Token | Value | Description |
|---|---|---|
--gog-duration-fast / -base / -slow | | Transition durations used by every animated component. |
--gog-easing | | Default transition easing function. |
--gog-focus-ring-width / --gog-focus-ring-offset | | Keyboard focus ring size and offset. |
--gog-disabled-opacity | | Opacity applied to disabled controls. |
--gog-{block}-press-bg | | The pressed background, on each of the nine pressable surfaces (button, menu item, chip, tab and accordion header, button-toggle option and the three dropdowns’ option rows). Listed here as well because they share a rule: a press is a colour and not only a movement, so it is the half that survives prefers-reduced-motion. The ripple is the deliberate exception — it is suppressed there, being decoration rather than state. |
| Token | Value | Description |
|---|---|---|
--gog-z-base | | The library’s stacking floor, and the only one of these you set. Every layer is base + N, so moving it lifts the whole library at once and keeps the internal order intact. |
--gog-badge-z / --gog-toast-base-z / --gog-dropdown-z / --gog-tooltip-z / --gog-spinner-overlay-z | | The five layers themselves — +1, +100, +300 (dropdowns, dialogs and menus), +400 and +8000 (the blocking overlay, which outranks even a dialog it covers). Derived, so overriding one takes it out of the base and should be a deliberate exception rather than the way you move the stack. |
| Token | Value | Description |
|---|---|---|
--gog-elevation-0 … --gog-elevation-5 | | The ladder: six heights, generated from the knobs below, and every raised surface in the package reads one. Z doubles — 0, 1, 2, 4, 8, 16 — and the heights are assigned by what a thing is, not by how it looks: 0 flat, 1 a thumb riding on a control, 2 an elevated card or panel, 3 anything anchored to a control (the four dropdown panels, the menu, the tooltip), 4 a toast, 5 a modal dialog. You do not write a step; you turn the knobs and all six follow. |
--gog-elevation-ink / -key-alpha / -ambient-alpha | | The colour of the shadow, as an unwrapped RGB triple, and the two opacities it composites at. A step is two lights: the ambient contact shadow that hugs the object and the key light that moves with height. The default ambient is half the key, which is the ratio the light theme’s hand-written panel already held. |
--gog-elevation-key-x / -key-y / -key-blur | | The style axis, as three unitless multipliers per unit of Z. Soft is the default: x 0, y 1, blur 3. A hard-offset theme (bevel, ledger) sets x and y to a fraction and blur to 0; a glow theme (terminal) sets y to 0 and keeps blur, and the key light becomes a halo without the ladder knowing anything about halos. Blur is 3× Z rather than the 2× the general rule gives, because across the 26 shadow layers this library shipped before the ladder the median ratio was exactly 3.00. |
--gog-elevation-contact-blur | | The contact shadow’s blur, and the one length in the family that does not grow with height — that is what ambient occlusion does, and it is what this library already did every time it hand-wrote two layers. |
--gog-elevation-ring-width / -highlight-ink / -highlight-alpha | | The hairline ring and the top-edge catch light, deliberately outside the steps: they belong to particular surfaces rather than to height. A dark theme’s overlay wants the ring and its in-flow elevated card must not have it, or elevated and outlined render identically. Both are inert by default (0px, 0 alpha); a component that wants one composes it — box-shadow: var(--gog-elevation-ring), var(--gog-elevation-3). |
--gog-elevation-ring / -highlight / -contact | | The three composable layers themselves, derived from the knobs above so a component can prepend one to a step. Derived, so override the knobs rather than these. |
| Token | Value | Description |
|---|---|---|
--gog-control-padding-y / -x | | Shared padding for form controls (buttons, fields). |
--gog-control-icon-offset | | Icon inset shared by form controls. |
--gog-control-clear-icon-ratio | | The clear (×) button’s glyph as a fraction of its box, shared by the five single-line controls that draw one. gog-textarea keeps its own 1 deliberately: its clear button sits in a corner rather than in the field’s icon row. |
--gog-control-checkbox-box-size-{size} / -label-size-{size} / -icon-size-{size} | | Checkbox box, label and icon size, per size step (xsm/sm/md/lg/slg). |
--gog-field-line-height / -label-line-height / -error-line-height | | Leading for the three things every field renders — its own text, its label and its error line — declared once here and aliased by all eight controls that draw them. The role is what sets the value, not the size: all five size steps of a field share one leading, which is why there is no per-size token to override. |
--gog-field-label-color / -label-font-family / -label-font-size / -label-font-weight / -label-letter-spacing / -label-text-transform | | The label above every form control, declared once in 21.15.0 so a theme restyles every form control’s label at once. Each component’s own --gog-{control}-label-* tokens alias these, so one control can still be set on its own. Defaults: the accent colour, the heading font at --gog-text-sm, regular weight, and the theme’s casing and tracking. |
--gog-field-float-label-reserve / -in-top / -over-gap / -over-reserve | | Float-label geometry shared by every field. Each control’s own --gog-{control}-float-label-* tokens derive from these, so one declaration retunes them all while a single control can still be overridden. |
| Token | Value | Description |
|---|---|---|
--gog-accordion-border-color / -width / -style | | Header border. |
--gog-accordion-text-color / -accent-color | | Text and accent color. |
--gog-accordion-hover-bg | | Header hover background. --gog-accordion-hover-ring was removed in 21.13.0: the hover never drew a ring, so nothing read it. |
--gog-accordion-focus-ring-color / -width | | The keyboard focus ring, and its own colour since 21.12.0. The header’s :focus-visible outline used to read --gog-accordion-hover-ring, so a hover-weight colour was doing focus duty and missed 3:1 in all eleven themes. Hover and focus are different signals and now carry different colours. |
--gog-accordion-press-bg | | Header press background, one step past its own hover. |
--gog-accordion-radius / -body-radius | | Corner radius for the header and body. |
--gog-accordion-header-bg / -body-bg | | Header and body background. |
--gog-accordion-header-gap | | Gap between chevron and title. |
--gog-accordion-transition-duration / -body-transition-duration / -chevron-transition-duration | | Expand/collapse animation timing. |
--gog-accordion-{size}-padding-y / -x / -font-size / -chevron-size / -chevron-font-size | | Header padding and font size, per size step (xsm/sm/md/lg/slg). The chevron is a ratio of the header’s own type since 21.11.0 — 1.4em of box, 1em of glyph, one value at every size — so the three smallest sizes, which all label at --gog-text-xs, now carry identical chevrons. Making it a ratio also surfaced a glyph that had been overflowing its own box at every size. |
| Token | Value | Description |
|---|---|---|
--gog-alert-bg / -color / -font-family | | Surface, body text colour and font stack. The ordinary surface and text pair, not a status tint — the library ships no per-status tint family, and the alert does not invent one. |
--gog-alert-border-color / -border-width / -border-style / -radius | | The frame on three sides, and the corner radius. |
--gog-alert-edge-color / -edge-width | | The leading edge that carries the severity, and the icon colour. Written by the severity class, which outranks a plain class of yours — to repaint a severity, set its own colour token below instead. |
--gog-alert-accent-color / -success-color / -danger-color / -warning-color / -info-color | | What each severity points --gog-alert-edge-color at. Default to the foundation status colours, so a theme that sets those needs nothing here. |
--gog-alert-padding-y / -padding-x / -gap / -main-gap | | Inner padding, the gap between icon, text and close button, and the gap between heading and body. |
--gog-alert-icon-font-size / -icon-line-height | | The glyph, and the box that holds it. |
--gog-alert-heading-color / -heading-font-size / -heading-font-weight / -heading-line-height | | The optional heading. |
--gog-alert-body-font-size / -body-line-height | | The projected body. |
| Token | Value | Description |
|---|---|---|
--gog-breadcrumbs-font-family / -line-height / -gap | | The trail’s typeface, its leading, and the space either side of a separator. |
--gog-breadcrumbs-xsm-font-size / -sm-font-size / -md-font-size / -lg-font-size / -slg-font-size | | The text at each size; the separator glyph is drawn from it. |
--gog-breadcrumbs-link-color / -link-hover-color | | A parent link, at rest and under the pointer. |
--gog-breadcrumbs-current-color / -current-font-weight | | The last item — the current page, which is not a link. |
--gog-breadcrumbs-separator-color | | The separator icon between items. Decorative and hidden from assistive tech. |
--gog-breadcrumbs-more-padding-y / -more-padding-x / -more-radius / -more-hover-bg | | The … button a collapsed trail draws in place of its middle. |
--gog-breadcrumbs-focus-ring-width / -focus-ring-offset / -focus-ring-color | | The keyboard focus ring on a link and on the … button. |
| Token | Value | Description |
|---|---|---|
--gog-stepper-font-family / -line-height / -gap | | The step’s typeface, its leading, and the space between indicator, label and connector. |
--gog-stepper-xsm-font-size / -sm-font-size / -md-font-size / -lg-font-size / -slg-font-size | | The label at each size; the indicator is a ratio of it, so the five sizes are five text steps. |
--gog-stepper-trigger-padding-y / -trigger-padding-x / -trigger-radius / -trigger-hover-bg / -trigger-press-bg | | A reachable step is a button: its padding, corner, hover and press. |
--gog-stepper-focus-ring-width / -focus-ring-offset / -focus-ring-color | | The keyboard focus ring on a reachable step. |
--gog-stepper-indicator-ratio | | The indicator’s diameter as a multiple of the label’s font size (2: the number with half an em clear). |
--gog-stepper-indicator-border-width / -indicator-border-color / -indicator-bg / -indicator-color / -indicator-font-weight | | A pending step’s indicator: the ring, its fill, and the number. |
--gog-stepper-label-color / -description-color / -description-font-size / -description-line-height | | The label, and the description under it (a step down the type scale, as a ratio). |
--gog-stepper-current-color / -current-label-color / -current-font-weight | | The current step: the accent ring and number, and its label. |
--gog-stepper-complete-bg / -complete-color | | A complete step’s filled indicator and the check on it. |
--gog-stepper-error-bg / -error-color / -error-label-color | | A step with an error: the filled indicator, its glyph, and the label. |
--gog-stepper-unreachable-color | | The label of a step a linear stepper cannot reach yet. |
--gog-stepper-connector-thickness / -connector-min-length / -connector-color / -connector-done-color | | The line between indicators: its weight, the shortest it gets before the row overflows, and its colour pending and after a complete step. |
| Token | Value | Description |
|---|---|---|
--gog-file-upload-font-family / -line-height / -gap | | The component’s typeface, leading, and the space between label, zone, list and error. |
--gog-file-upload-label-font-family / -label-font-size / -label-line-height / -label-font-weight / -label-color / -label-text-transform / -label-letter-spacing | | The label above the zone — the field label’s tokens by reference, so it matches every other field. |
--gog-file-upload-xsm-font-size / -sm-font-size / -md-font-size / -lg-font-size / -slg-font-size | | The prompt at each size. |
--gog-file-upload-xsm-zone-padding / -sm-zone-padding / -md-zone-padding / -lg-zone-padding / -slg-zone-padding | | The drop zone’s padding at each size. A surface, so one value on every side. |
--gog-file-upload-zone-gap / -zone-border-width / -zone-border-color / -zone-radius / -zone-bg | | The dashed zone at rest. The dash is the control boundary colour, so the zone stays visible at 3:1. |
--gog-file-upload-zone-active-border-color / -zone-active-bg / -transition-duration | | The zone under the pointer and while a file is dragged over it. |
--gog-file-upload-prompt-color / -browse-color / -browse-font-weight | | "Drop files here or browse". "browse" is marked by its underline and weight, not a colour. |
--gog-file-upload-icon-color / -icon-font-size / -icon-line-height | | The upload glyph above the prompt. |
--gog-file-upload-hint-color / -hint-font-size / -hint-line-height | | The hint line in the zone; the error line uses the same size. |
--gog-file-upload-list-gap / -file-gap / -name-color / -remove-radius | | The list of chosen files: rows, the space within a row, the file name, and the remove button’s corner. |
--gog-file-upload-error-color | | The error line, and the zone’s border while there is one. |
--gog-file-upload-focus-ring-width / -focus-ring-offset / -focus-ring-color | | The ring the zone draws while the input inside it has keyboard focus, and the remove button’s. |
--gog-file-upload-disabled-opacity | | The whole component, disabled. |
| Token | Value | Description |
|---|---|---|
--gog-rating-font-family / -gap | | The typeface, and the space between label, stars and error. |
--gog-rating-label-font-family / -label-font-size / -label-line-height / -label-font-weight / -label-color / -label-text-transform / -label-letter-spacing | | The label — the field label’s tokens by reference. |
--gog-rating-xsm-star-size / -sm-star-size / -md-star-size / -lg-star-size / -slg-star-size | | The star at each size: 16, 20, 24, 28 and 32px. |
--gog-rating-star-padding / -star-radius / -glyph-line-height | | The least room around a star (raised so the pressable box is never under 24x24), its focus corner, and the glyph’s own box. |
--gog-rating-empty-color / -fill-color | | An empty star’s outline (the control boundary colour, 3:1) and a filled one (the accent). |
--gog-rating-focus-ring-width / -focus-ring-offset / -focus-ring-color | | The ring round the focused star. |
--gog-rating-error-color / -error-font-size / -error-line-height | | The error line. |
--gog-rating-disabled-opacity | | The whole rating, disabled. |
| Token | Value | Description |
|---|---|---|
--gog-empty-state-font-family / -gap / -message-gap | | The typeface; the space between media, message and actions; and between title and description. |
--gog-empty-state-xsm-padding / -sm-padding / -md-padding / -lg-padding / -slg-padding | | The padding at each size. A surface, so one value on every side; it draws no border or fill. |
--gog-empty-state-xsm-icon-size / -sm-icon-size / -md-icon-size / -lg-icon-size / -slg-icon-size | | The icon at each size, 24 to 64px. |
--gog-empty-state-icon-color / -icon-line-height | | The icon’s muted colour, which an illustration drawn in currentColor takes too. |
--gog-empty-state-xsm-heading-font-size / -sm-heading-font-size / -md-heading-font-size / -lg-heading-font-size / -slg-heading-font-size | | The title at each size. |
--gog-empty-state-heading-color / -heading-font-weight / -heading-line-height | | The title. |
--gog-empty-state-xsm-description-font-size / -sm-description-font-size / -md-description-font-size / -lg-description-font-size / -slg-description-font-size | | The description at each size. |
--gog-empty-state-description-color / -description-line-height / -measure | | The description, and the widest it sets before wrapping (48ch). |
--gog-empty-state-actions-gap / -actions-offset | | Between the buttons, and the extra step above the row. |
| Token | Value | Description |
|---|---|---|
--gog-avatar-xsm-size / -sm-size / -md-size / -lg-size / -slg-size | | The diameter at each size: the skeleton circle’s sizes by reference (24/32/48/64/96px), so a circle skeleton swaps for an avatar without moving anything. |
--gog-avatar-size | | Undeclared instance override of the diameter. gog-avatar-group sets it on itself, which is how one size reaches the whole row. |
--gog-avatar-bg / -color | | The fill behind the initials or the icon, and their colour. The fill is the skeleton’s step made opaque, so it stands off any ground and matches its own placeholder. |
--gog-avatar-font-family / -font-weight / -line-height | | How the initials are set. |
--gog-avatar-initials-ratio / -icon-ratio | | The initials and the icon, as a fraction of the diameter, so they scale with whichever size resolves. |
--gog-avatar-rounded-radius | | The corner of shape="rounded". A circle needs none. |
--gog-avatar-badge-inset-ratio | | Where a circle crosses its box’s diagonal, as a fraction of the diameter: where a gogBadge on a round avatar anchors. |
--gog-avatar-group-overlap-ratio | | How far each avatar in a group steps back over the one before, of the diameter — an eighth, which leaves a typical pair of initials uncovered. |
--gog-avatar-group-ring-width / -ring-color | | The ring between overlapping avatars. The colour is the page’s; set it to the surface the group sits on, a card or a panel. |
--gog-avatar-group-more-initials-ratio | | The +N avatar’s text, smaller because it can be three characters (99+). |
| Token | Value | Description |
|---|---|---|
--gog-autocomplete-label-color / -label-font-family / -label-font-size / -label-font-weight / -label-letter-spacing / -label-line-height / -label-text-transform | | Field label. Each aliases its --gog-field-label-* counterpart. |
--gog-autocomplete-field-bg / -border-color / -text-color | | Field surface, border and text. |
--gog-autocomplete-radius / -min-width | | Field corner radius and the floor an auto-width field cannot collapse past. |
--gog-autocomplete-focus-ring-color / -focus-ring-width / -hover-border-color | | Focus and hover states. |
--gog-autocomplete-panel-bg / -panel-border-color / -panel-shadow / -panel-max-height | | Suggestion panel surface and height cap. |
--gog-autocomplete-option-hover-bg / -option-press-bg / -option-selected-bg | | Suggestion row states. |
--gog-autocomplete-option-height / -panel-gap | | A seed for the first frame rather than the row height — the component measures a real row and corrects itself, which is also what places the panel above or below the field. And the gap between the field and its panel. |
--gog-autocomplete-empty-color / -spinner-size | | The "nothing found" message and the loading spinner. |
--gog-autocomplete-clear-color / -clear-hover-color / -actions-inset | | Clear button color and how far the trailing actions sit from the edge. |
--gog-autocomplete-float-label-reserve / -in-top / -over-gap / -over-reserve | | Float-label geometry, derived from the shared --gog-field-float-label-* scale. |
| Token | Value | Description |
|---|---|---|
--gog-badge-success-bg / -danger-bg / -warning-bg / -info-bg (+ matching -color) | | Fill and text color per semantic variant. |
--gog-badge-size / -dot-size / -padding-inline | | Badge height, the bare-dot diameter, and horizontal padding around a count. |
--gog-badge-radius / -border-color / -border-width / -border-style | | Corner radius and the ring separating the badge from its host. |
--gog-badge-font-family / -font-size / -font-weight / -line-height | | Count typography. |
--gog-badge-offset / -z | | How far the badge overhangs its host corner, and its stacking order. |
--gog-badge-host-inset / -dot-offset | | Where the badge anchors, in from the host’s box corner (0 for a box), and the dot’s own overhang (the shared offset by default). A round gog-avatar sets both on itself, so a count sits on the edge of its circle and a dot is centred on it. |
| Token | Value | Description |
|---|---|---|
--gog-button-font-family / -font-weight / -letter-spacing / -text-transform | | Label typography. |
--gog-button-radius | | Corner radius. |
--gog-button-border-width / -style | | Border. |
--gog-button-transition-duration | | Hover / active transition timing. |
--gog-button-{variant}-bg / -color / -border / -shadow | | Fill, text, border and shadow per variant (primary/secondary/outline/ghost). |
--gog-button-{variant}-hover-bg / -hover-color / -hover-shadow | | Hover state per variant. |
--gog-button-{variant}-press-bg / -press-color | | Pressed state per variant. The press is a colour and not only the scale below, so it survives prefers-reduced-motion. |
--gog-button-focus-ring-color / -focus-ring-width / -focus-ring-offset | | The keyboard focus ring. Its colour is its own token since 21.13.0 and reads the accent; it used to follow each variant’s hover wash, which on ghost and the severity outline buttons made the ring invisible in four themes (1.07:1 at worst). |
--gog-button-active-scale | | How far a press shrinks the button. Dropped under prefers-reduced-motion, where the press colour carries the state on its own. |
--gog-button-{variant}-toggled-shadow / --gog-button-toggled-ring-width | | The inset ring a button with aria-pressed="true" (or "mixed") draws. A ring rather than a fill, because hover and press already own the background. |
--gog-button-{status}-fill / -fill-hover / -fill-press / -on-fill / -ink / -wash | | The severity palette, per status (danger/success/warning/info). fill and on-fill are a filled button and its label; ink is the label of a transparent one, the status hue mixed halfway toward the page ink; wash is the hover background under it. |
--gog-button-{variant}-spinner-color | | The loading spinner, per variant. |
--gog-button-bg / -color / -border / -padding / -font-size / -press-bg / -press-color / -toggled-shadow | | Undeclared by default — the escape hatch for styling a single button instance. |
| Token | Value | Description |
|---|---|---|
--gog-button-toggle-rest-bg / -rest-color | | An unselected button. |
--gog-button-toggle-selected-bg / -selected-color / -selected-border-color | | The selected button. |
--gog-button-toggle-hover-bg / -hover-color | | Hover state. |
--gog-button-toggle-press-bg / -selected-press-bg | | Press state, with its own value for a button that is already selected — pressing one has to read as a press rather than as a deselection. |
--gog-button-toggle-border-color / -border-width / -border-style / -radius | | Group border and corner radius. The colour defaults to --gog-control-boundary-color since 21.12.0 — it read the decorative hairline before, which is why a segmented control now shows a visibly firmer edge in every theme. |
--gog-button-toggle-separated-gap | | Gap between buttons in the "separated" appearance. "joined" shares borders. |
--gog-button-toggle-font-family / -font-weight / -letter-spacing / -text-transform / -icon-size | | Button typography and icon size. |
--gog-button-toggle-focus-ring-color / -focus-ring-width / -focus-ring-offset | | Keyboard focus ring. |
| Token | Value | Description |
|---|---|---|
--gog-calendar-max-width | | How wide the calendar may get. Defaults to max-content, which caps it at its own month grid and follows the size steps, numberOfMonths and showTime on its own — set it to 100% for a calendar that fills its container instead. Also sizes gog-datepicker in inline mode, which renders this component. |
--gog-calendar-padding / -header-gap / -footer-gap / -months-gap | | Grid padding and the gaps between header, footer and side-by-side months. |
--gog-calendar-day-size (per size step: xsm/sm/md/lg/slg) / -day-radius | | Day cell size and shape. |
--gog-calendar-day-rest-bg / -day-hover-bg / -day-outside-color | | Day cell states, including days spilling in from the neighbouring month. |
--gog-calendar-selected-bg / -selected-color / -selected-font-weight | | The selected day. |
--gog-calendar-range-bg / -range-color | | Days between the two ends of a range selection. |
--gog-calendar-today-border-color / -today-font-weight | | The ring marking today. |
--gog-calendar-nav-bg / -nav-hover-bg / -nav-size / -nav-icon-size | | Previous/next month and year buttons. |
--gog-calendar-weekday-color / -weekday-font-size / -weekday-text-transform | | Weekday header row. |
--gog-calendar-time-input-bg / -time-input-width / -time-gap | | The clock section shown under the grid when showTime is on. |
| Token | Value | Description |
|---|---|---|
--gog-card-bg / -border-color / -shadow / -padding-y / -padding-x / -gap | | The instance tier — left undeclared by the library on purpose, so setting one on an element beats the variant and size classes without a specificity fight. |
--gog-card-outlined-bg / -outlined-border-color / -outlined-shadow | | The outlined variant (the default): a border, no shadow. |
--gog-card-elevated-bg / -elevated-border-color / -elevated-shadow | | The elevated variant: the shared surface shadow, no border. |
--gog-card-filled-bg / -filled-border-color / -filled-shadow | | The filled variant: a tint, neither border nor shadow. |
--gog-card-color / --gog-card-font-family / --gog-card-radius | | Body text color, font stack and corner radius. |
--gog-card-heading-color / -heading-font-family / -heading-font-size / -heading-font-weight / -heading-line-height | | The projected gogCardHeader. The visual size comes from these regardless of which heading level you use. |
--gog-card-footer-border-color / -footer-gap / -footer-padding-top | | The projected gogCardFooter row and the rule above it. |
--gog-card-hover-border-color / --gog-card-hover-shadow | | Hover treatment, which only appears on a card holding a gogCardLink. |
--gog-card-focus-ring / -focus-ring-width / -focus-ring-offset | | The ring drawn around the whole card when its stretched link takes focus. |
--gog-card-xsm-padding-y … --gog-card-slg-padding-y (and -padding-x, -gap) | | Padding and row gap per size tier, xsm through slg. |
--gog-card-disabled-opacity / --gog-card-transition-duration | | Disabled dimming, and the hover/focus transition. |
| Token | Value | Description |
|---|---|---|
--gog-checkbox-gap | | Gap between box and label. |
--gog-checkbox-radius | | Box corner radius. |
--gog-checkbox-border-width / -style / -color | | Box border. |
--gog-checkbox-bg / -checked-bg / -checked-border | | Box background, unchecked and checked. |
--gog-checkbox-icon-color | | Checkmark color. |
--gog-checkbox-label-color | | Label text color. |
--gog-checkbox-focus-ring / -focus-ring-width / -focus-ring-offset | | Keyboard focus ring. The colour reads --gog-accent-color rather than the pale wash it used to, corrected in 21.12.0: this outline is the only thing marking focus on this control, and a wash measured 1.38:1 against the light page where WCAG asks for 3:1. |
| Token | Value | Description |
|---|---|---|
--gog-chip-bg / -hover-bg / -press-bg | | Background, default, hover and pressed. |
--gog-chip-selected-shadow / -selected-ring-width | | The inset ring a filter chip draws while selected ([(selected)], 21.9.0). A ring rather than a fill, because hover and press already own the background. |
--gog-chip-border / -border-width / -style | | Border. Since 21.12.0 the colour defaults to --gog-control-boundary-color rather than the decorative --gog-border-color: a chip is a control, and its edge is what identifies it. That is why chips look outlined more firmly than they did — they were at 1.18:1 in primeng before. |
--gog-chip-focus-ring-color / -width / -offset | | The keyboard focus ring. The colour is new in 21.12.0 — the chip had a width and an offset but no colour of its own, so the stylesheet reached for --gog-chip-border and the ring came out as a hairline. A focus indicator needs its own colour. |
--gog-chip-color / -font-weight | | Text color and weight. |
--gog-chip-radius / -pill-radius | | Corner radius, square and pill shape. |
--gog-chip-remove-color / -remove-hover-color | | Remove (×) icon color. |
--gog-chip-{size}-font-size / -padding-block / -padding-inline / -gap / -avatar-size / -icon-size / -remove-size | | Full sizing scale, per size step (xsm/sm/md/lg/slg). The three glyph sizes are ratios of the chip’s own type rather than px ladders since 21.11.0 — avatar 1.5em, icon 1em, remove mark 1.125em, one value at every size — so overriding a size’s font-size carries its glyphs with it, which the rem ladder did not. |
| Token | Value | Description |
|---|---|---|
--gog-collapsible-transition-duration | | Expand/collapse animation timing. |
--gog-collapsible-max-height | | Height an open panel transitions toward. Defaults to max-content, so a panel is as tall as its content and never truncates it. Set a length to cap one deliberately — the panel is overflow: hidden, so a cap clips rather than scrolls. |
--gog-collapsible-disabled-opacity | | Opacity applied to a disabled trigger. |
| Token | Value | Description |
|---|---|---|
--gog-datepicker-label-color / -label-font-family / -label-font-size / -label-font-weight / -label-letter-spacing / -label-line-height / -label-text-transform | | Field label. Each aliases its --gog-field-label-* counterpart. |
--gog-datepicker-field-bg / -border-color / -text-color | | Field surface, border and text. |
--gog-datepicker-radius / -min-width | | Field corner radius and minimum width. |
--gog-datepicker-focus-ring-color / -focus-ring-width / -hover-border-color | | Focus and hover states. |
--gog-datepicker-icon-color / -icon-hover-color / -toggle-icon-size | | The calendar toggle icon. |
--gog-datepicker-panel-bg / -panel-border-color / -panel-shadow / -panel-radius | | The panel wrapping the calendar. The grid itself is themed by --gog-calendar-*. |
--gog-datepicker-panel-width | | Width of the dropdown panel, max-content by default. Inline mode has no panel — it is gog-calendar on its own, so it sizes from --gog-calendar-max-width. |
--gog-datepicker-clear-color / -clear-icon-ratio / -actions-inset | | Clear button color, glyph size and inset. |
--gog-datepicker-error-color / -error-border-color / -error-font-size | | Validation error message and border. |
--gog-datepicker-float-label-reserve / -in-top / -over-gap / -over-reserve | | Float-label geometry, derived from the shared --gog-field-float-label-* scale. |
| Token | Value | Description |
|---|---|---|
--gog-dialog-backdrop-bg / -backdrop-blur | | Scrim behind the dialog. |
--gog-dialog-bg / -color / -border / -radius / -shadow | | Panel surface. |
--gog-dialog-title-font-size / -title-line-height | | The dialog’s <h2>. New tokens in 21.11.0 and the value is the size it was already rendering — the title had simply been inheriting from the browser rather than reading the type scale, so it was outside a theme’s reach. |
--gog-dialog-header-padding / -body-padding | | Section padding. |
--gog-dialog-close-color / -close-hover-color / -close-hover-bg | | Close button. |
--gog-confirmation-dialog-color / -description-color / -actions-gap | | Confirmation dialog variant. |
--gog-confirmation-dialog-title-font-size / -description-font-size (and their line heights) | | The title and the description, on the type scale since 21.11.0 rather than inherited. The description is the one that visibly moved: 16px to 14px, a step smaller than it was. |
--gog-confirmation-dialog-max-width | | The panel’s cap, in ch since 21.11.0 so raising the font size widens the panel with it. It resolves against .confirm-dialog’s own inherited size, not the description’s — a ch cap always reads the font of the element carrying max-width, never a descendant’s. |
| Token | Value | Description |
|---|---|---|
--gog-divider-line-color / -line-thickness | | The rule itself. |
--gog-divider-solid-style / -dashed-style / -dotted-style | | The border-style each variant maps to. |
--gog-divider-block-spacing / -inline-spacing | | Margin around a horizontal and a vertical divider respectively. |
--gog-divider-vertical-length | | Fallback length for a vertical divider whose row has no height of its own. |
--gog-divider-inset-size | | How far the inset variant is indented from the leading edge. |
--gog-divider-label-color / -label-font-size / -label-font-weight / -label-gap | | The projected label and the gap punched in the rule around it. |
| Token | Value | Description |
|---|---|---|
--gog-icon-size | | Default icon size. |
--gog-icon-stroke-width | | Stroke width for outline icons. |
--gog-icon-fallback-size | | Size used when no size is set. |
| Token | Value | Description |
|---|---|---|
--gog-input-label-color / -label-font-family / -label-font-size / -label-font-weight / -label-letter-spacing / -label-line-height / -label-text-transform | | Field label. Each aliases its --gog-field-label-* counterpart. |
--gog-input-field-bg / -field-border / -field-color | | Field surface, border and text. |
--gog-input-radius | | Field corner radius. |
--gog-input-focus-border / -focus-ring / -focus-glow | | Focus state. |
--gog-input-error-color | | Validation error color. |
--gog-input-icon-color / -icon-hover-color | | Prefix / suffix icon color. |
--gog-input-float-label-reserve / -in-top / -on-bg / -over-gap / -over-reserve | | Float-label geometry, derived from the shared --gog-field-float-label-* scale. -on-bg is an instance-layer token (undeclared) — the patch that masks the border behind an "on" label. |
--gog-textarea-clear-icon-ratio | | Size of gog-textarea’s clear glyph relative to the field. A textarea is a large multi-line box, so it takes a full-size glyph rather than the dropdowns’ denser 0.7 ratio. |
--gog-textarea-scrollbar-width | | Instance-layer (undeclared): written by the component from its own measured scrollbar width, so a clear button on a scrolling textarea does not end up under the thumb. |
| Token | Value | Description |
|---|---|---|
--gog-menu-z | | Stacking order of the portaled panel. Defaults to --gog-dropdown-z, and the panel takes the value its trigger inherits — which is how a menu opened inside a dialog stacks above it. |
--gog-menu-bg | | Panel background. |
--gog-menu-border-color / -border-width / -border-style | | Panel border. |
--gog-menu-radius / --gog-menu-item-radius | | The panel’s corner, and the item’s. The item derives from the panel less the panel’s own padding since 21.11.0, so the first and last rows stay concentric with the corner they sit in instead of looking squarer than it — at the default theme that moved the item from 8px to 12px. |
--gog-menu-shadow | | Panel shadow. Defaults to --gog-panel-shadow, the same step the four dropdown panels sit on. It aliased the dialog’s until 21.12.0, which put a modal’s shadow on a dropdown menu — two overlays of one kind, four steps apart, and the alias is why nobody saw it. |
--gog-menu-font-family | | Panel font family. |
--gog-menu-padding | | Space between the panel edge and its items. |
--gog-menu-gap | | Space between items. |
--gog-menu-item-hover-bg / -item-press-bg | | An item under the pointer, and under a press. |
--gog-menu-panel-gap | | Gap between the trigger and the panel. |
--gog-menu-min-width / -max-width | | Panel width bounds. The panel sizes to its widest item between them, never to the trigger. |
--gog-menu-max-height | | Height past which the panel scrolls itself with gog-scroll instead of growing. The panel takes the smallest of this, its own content, and the room between its trigger and the viewport edge. |
--gog-menu-available-height | | Instance-layer (undeclared): written by the component from the room it measured beside the trigger. Listed because it is the other half of the min() above, not because you would set it. |
--gog-menu-transition-duration | | Open/close transition. |
--gog-menu-focus-ring / -focus-ring-width | | Focus ring on the item the arrow keys landed on. |
--gog-menu-item-color / -hover-bg / -hover-color | | Item foreground, and the pair it swaps to under the pointer or focus. |
--gog-menu-item-font-size / -line-height / -padding / -radius | | Item metrics. |
--gog-menu-item-gap | | Space between an item's icon and its label. |
--gog-menu-item-icon-size | | Size of an icon projected into an item, relative to the item's own text. |
--gog-menu-item-disabled-opacity / -disabled-color | | How a disabled item reads. It stays in the list rather than disappearing. |
| Token | Value | Description |
|---|---|---|
--gog-multiselect-label-color / -label-font-family / -label-font-size / -label-font-weight / -label-letter-spacing / -label-line-height / -label-text-transform | | Field label. Each aliases its --gog-field-label-* counterpart. |
--gog-multiselect-field-bg / -field-border | | Field surface and border. |
--gog-multiselect-radius / -min-width | | The field’s corner radius — the field only, since 21.12.0 — and the floor an auto-width trigger cannot collapse past. |
--gog-multiselect-focus-border / -focus-ring | | Focus state. |
--gog-multiselect-panel-bg / -panel-border / -panel-shadow / -panel-max-width | | Dropdown panel surface, and the cap on a panel that sizes to its own content rather than to the trigger. |
--gog-multiselect-panel-gap | | Gap between the trigger and the panel. It was --gog-multiselect-panel-offset until 21.13.0, and the old name stopped resolving in 21.14.0. |
--gog-multiselect-option-height | | A seed for the first frame, not the row height: the component measures a real row and corrects itself, which is also what decides whether the panel opens up or down. |
--gog-multiselect-panel-radius | | The panel’s own corner, new in 21.12.0 and defaulting to var(--gog-radius). Splitting it off the field’s radius is why shaping the trigger no longer reshapes the overlay; the option row and the filter input both stay concentric with whatever you set here. |
--gog-multiselect-option-hover-bg / -option-press-bg / -option-color | | Option row, default, hover and pressed. |
--gog-multiselect-checkbox-border / -checkbox-checked-bg | | Per-option selection mark. The mark is a glyph, so -checkbox-bg and -checkbox-checked-color had nothing to paint and were removed in 21.13.0. |
--gog-multiselect-float-label-reserve / -in-top / -on-bg / -over-gap / -over-reserve | | Float-label geometry, derived from the shared --gog-field-float-label-* scale. |
| Token | Value | Description |
|---|---|---|
--gog-paginator-gap | | Gap between page controls. |
--gog-paginator-ellipsis-color / -ellipsis-font-size | | The "…" truncation marker. |
| Token | Value | Description |
|---|---|---|
--gog-panel-radius / --gog-panel-shadow / --gog-panel-border-width / --gog-panel-border-style | | Shared with the foundation surface tier — the same four tokens dialogs and dropdown panels read, so a theme’s idea of a raised surface reaches gog-panel for free. Setting them here restyles those surfaces too. |
--gog-panel-outlined-bg / -outlined-border-color / -outlined-shadow | | The outlined variant: a border, no shadow. |
--gog-panel-elevated-bg / -elevated-border-color | | The elevated variant (the default) — takes the shared surface shadow above. |
--gog-panel-filled-bg / -filled-border-color / -filled-shadow | | The filled variant: a tint, neither border nor shadow. |
--gog-panel-color / --gog-panel-font-family | | Body text color and font stack. |
--gog-panel-heading-color / -heading-font-family / -heading-font-size / -heading-font-weight / -heading-line-height | | The projected gogPanelHeader heading. |
--gog-panel-header-gap | | Gap between the heading and the collapse toggle. |
--gog-panel-toggle-size / -toggle-color / -toggle-hover-bg / -toggle-radius / --gog-panel-chevron-size | | The collapse toggle button and its chevron. |
--gog-panel-footer-border-color / -footer-gap / -footer-padding-top | | The projected gogPanelFooter row and the rule above it. |
--gog-panel-xsm-padding-y … --gog-panel-slg-padding-y (and -padding-x, -gap) | | Padding and row gap per size tier, xsm through slg. |
--gog-panel-focus-ring / -focus-ring-width / -focus-ring-offset | | Focus ring on the collapse toggle. |
--gog-panel-disabled-opacity / --gog-panel-transition-duration | | Disabled dimming, and the collapse/hover transition. |
| Token | Value | Description |
|---|---|---|
--gog-progressbar-accent-bg / -success-bg / -danger-bg / -warning-bg / -info-bg | | Fill color per variant. |
--gog-progressbar-{variant}-buffer-bg | | The lighter buffer level shown ahead of the fill in "buffer" mode. |
--gog-progressbar-track-base-bg / -radius | | The unfilled track. |
--gog-progressbar-{size}-height | | Bar thickness, per size step (xsm/sm/md/lg/slg). |
--gog-progressbar-indeterminate-duration / -indeterminate-easing | | Indeterminate animation timing. Replaced by a static stripe under prefers-reduced-motion. |
--gog-progressbar-stripe-color / -stripe-size | | The static stripe that stands in for the animation when motion is reduced. |
--gog-progressbar-value-color / -value-font-size / -value-min-width / -value-gap | | The percentage readout rendered when showValue is on. |
--gog-progressbar-edge-color / -edge-backing-color / -edge-width | | Two hairlines marking where the fill ends — and where the buffer level ends — off by default since 21.15.0 (-edge-width: 0px). Set the width to 1px to turn them on. The reason to: with showValue off, the boundary between fill and track is the only thing stating the value, and the fill and track colours alone do not clear WCAG 1.4.11’s 3:1 in every theme. On, they do — the ink line sits outermost against the track, the surface-coloured one just inside the fill. They are off because a light line on a dark fill reads as an outline rather than as the value. |
| Token | Value | Description |
|---|---|---|
--gog-radio-bg / -border-color / -border-width / -border-style | | The circle, unchecked. |
--gog-radio-checked-bg / -checked-border / -dot-color / -dot-size-ratio | | The circle and its dot once checked. |
--gog-radio-label-color / -label-line-height / -gap | | Per-option label and the gap to its circle. |
--gog-radio-group-label-color / -group-label-size / -group-label-font-family / -group-label-font-weight / -group-label-line-height / -group-label-letter-spacing / -group-label-text-transform / -group-gap | | The group’s own label, and its gap to the options. Since 21.15.0 it aliases --gog-field-label-*, so it wears the same colour and font as every other field label — the accent in most themes, where it used to be the muted grey. |
--gog-radio-group-option-gap / -group-option-gap-horizontal | | Gap between options, vertical and horizontal orientation respectively. |
--gog-radio-focus-ring / -focus-ring-width / -focus-ring-offset | | Keyboard focus ring. The colour reads --gog-accent-color rather than the pale wash it used to, corrected in 21.12.0: this outline is the only thing marking focus on this control, and a wash measured 1.38:1 against the light page where WCAG asks for 3:1. |
--gog-radio-error-color / -error-font-size / -disabled-opacity | | Validation error message and the disabled state. |
| Token | Value | Description |
|---|---|---|
--gog-ripple-color | | The wash. Defaults to currentColor rather than a palette token — the only token in this catalogue that does — so it reads as the surface’s own foreground on a filled surface and a ghost one alike, which is why the ripple needs no per-variant tier. |
--gog-ripple-opacity | | Peak opacity of the wash. |
--gog-ripple-enter-duration | | How long the wave takes to expand from the press point. |
--gog-ripple-exit-duration | | How long it fades once the pointer is released. |
--gog-ripple-easing | | Easing curve for both phases. |
| Token | Value | Description |
|---|---|---|
--gog-scroll-track-bg / -track-radius | | Track background and corner radius. |
--gog-scroll-thumb-bg / -thumb-hover-bg / -thumb-active-bg | | Draggable thumb color, per interaction state. |
--gog-scroll-thumb-radius / -thumb-inset | | Thumb shape and inset from the track edges. |
--gog-scroll-corner-bg | | Background of the corner square where two tracks meet. |
--gog-scroll-track-start | | Where the vertical track starts, 0px by default. Content that pins a header over the top of the viewport sets it to that header’s height, so the thumb never runs over the header; gog-table does this itself for its stickyHeader. New in 21.15.0. |
--gog-scroll-fade-duration | | Auto-hide fade animation timing. |
--gog-scroll-focus-ring / -focus-ring-width | | Keyboard focus ring on the viewport. |
--gog-scroll-{normal|thin}-track-width / -thumb-min-size | | Track width and minimum thumb length, per size step. |
| Token | Value | Description |
|---|---|---|
--gog-select-label-color / -label-font-family / -label-font-size / -label-font-weight / -label-letter-spacing / -label-line-height / -label-text-transform | | Field label. Each aliases its --gog-field-label-* counterpart. |
--gog-select-field-bg / -field-border | | Field surface and border. |
--gog-select-radius | | The field’s corner radius — the field only. Until 21.12.0 it shaped the dropdown panel too, so rounding the trigger into a pill rounded the overlay into one as well; that box has its own token now. |
--gog-select-focus-border / -focus-ring | | Focus state. |
--gog-select-panel-bg / -panel-shadow / -panel-max-width | | Dropdown panel surface, and the cap on a panel that sizes to its own content rather than to the trigger. |
--gog-select-panel-gap | | Gap between the trigger and the panel. It was --gog-select-panel-offset until 21.13.0, and the old name stopped resolving in 21.14.0. |
--gog-select-option-height | | A seed for the first frame, not the row height: the component measures a real row and corrects itself, which is also what decides whether the panel opens up or down. |
--gog-select-panel-radius | | The panel’s own corner, new in 21.12.0 and defaulting to var(--gog-radius), so nothing moves unless you change it. gog-autocomplete and gog-datepicker already declared theirs; this and the multiselect’s are the pair that completes the family. |
--gog-select-options-padding / --gog-select-option-radius | | The gutter around the option list and the row’s own corner, matching what gog-autocomplete and gog-multiselect already had. This panel had no interior at all before 21.12.0, which is why its first and last rows were square inside a rounded corner. The row radius derives from the panel radius less the gutter, so it stays concentric once --gog-density moves the padding. |
--gog-select-min-width | | The floor an auto-width trigger cannot collapse past (120px). |
--gog-select-chevron-color / -chevron-inset | | Dropdown arrow color and inset. Since 21.3.0 the inset lands on --gog-control-icon-offset, the same line as gog-inputfield’s icons — the three controls now line up in a form. |
--gog-select-option-hover-bg / -option-press-bg / -option-selected-color | | Option row states. |
--gog-select-float-label-reserve / -in-top / -on-bg / -over-gap / -over-reserve | | Float-label geometry, derived from the shared --gog-field-float-label-* scale. |
| Token | Value | Description |
|---|---|---|
--gog-skeleton-base / -shine | | Placeholder base colour and shimmer. Since 21.15.0 the base is translucent ink — color-mix(in srgb, var(--gog-text-color) 12%, transparent) — rather than a fixed colour, so a bone stands off whatever it sits on by the same step: a filled card’s tint as much as the page. The fixed colour vanished on a filled surface. |
--gog-skeleton-radius / -line-radius | | Corner radius, block and line shapes. |
--gog-skeleton-pulse-duration / -wave-duration | | Loading animation timing. |
| Token | Value | Description |
|---|---|---|
--gog-slider-label-color / -label-font-family / -label-font-size / -label-font-weight / -label-letter-spacing / -label-line-height / -label-text-transform | | Field label. Each aliases its --gog-field-label-* counterpart. |
--gog-slider-value-color | | The current value readout. |
--gog-slider-track-bg / -fill-bg | | Track, empty and filled. The fill is applied as background rather than background-color, so -fill-bg also accepts a gradient. |
--gog-slider-track-border-width / -track-border-style / -track-border-color | | An optional border on the track — transparent by default, the same opt-in convention as --gog-button-primary-border. |
--gog-slider-thumb-bg / -thumb-border / -thumb-glow-color / -thumb-glow-size | | Drag handle, and the glow around it. -thumb-glow-color was --gog-slider-thumb-shadow until 21.13.0 — it always held a colour, not a shadow — and the old name stopped resolving in 21.14.0. |
--gog-slider-range-target-size | | A range thumb’s pointer target, 24px (WCAG 2.5.8). The drawn thumb stays --gog-slider-thumb-size; this is the invisible area around it that takes the press. New in 21.15.0. |
--gog-slider-auto-width / -vertical-length | | Size of a slider that does not fill its container: width when horizontal, length when vertical. |
--gog-slider-focus-ring | | Keyboard focus ring. |
| Token | Value | Description |
|---|---|---|
--gog-spinner-track-color | | Background ring. |
--gog-spinner-arc-outer-color / -arc-inner-color | | Spinning arc colors. |
--gog-spinner-diamond-color / -rune-color / -glow-color | | Decorative elements on the larger spinner variants. |
--gog-spinner-spin-duration / -pulse-duration | | Animation timing. |
| Token | Value | Description |
|---|---|---|
--gog-table-border-color / -border-width | | Outer border. |
--gog-table-surface / -text-color / -accent-color | | Surface, body text and header accent. |
--gog-table-hover-bg | | Row hover background. |
--gog-table-row-press-bg | | An interactiveRows row under the finger, since 21.13.0 — a colour rather than a ripple, so it survives prefers-reduced-motion. A plain row does not use it. |
--gog-table-muted-color | | Secondary text (e.g. empty state). |
--gog-table-header-letter-spacing / -text-transform | | Header cell typography. |
--gog-table-{size}-padding-v / -th-font-size / -td-font-size | | Row density, per size step (xsm/sm/md/lg/slg). |
| Token | Value | Description |
|---|---|---|
--gog-tabs-rest-color / -hover-color / -active-color | | Tab header label, per state. |
--gog-tabs-press-bg / -press-color | | A header under a press. It carries a label colour as well as a background, the way the button does, because a header has little fill of its own to deepen. |
--gog-tabs-indicator-color / -indicator-thickness / -indicator-radius | | The bar marking the active tab. |
--gog-tabs-header-border-color / -header-border-width / -header-border-style | | The rule under the tablist. |
--gog-tabs-{size}-font-size / -{size}-padding | | Header typography and padding, per size step (sm/md/lg/slg). |
--gog-tabs-tab-gap / -gap / -icon-size | | Gap between headers, between a header’s icon and its label, and icon size. |
--gog-tabs-panel-padding / -panel-color | | The content panel below the tablist. |
--gog-tabs-focus-ring-color / -focus-ring-width / -focus-ring-offset / -disabled-opacity | | Keyboard focus ring and the disabled state. |
| Token | Value | Description |
|---|---|---|
--gog-tag-default-color / -success-color / -danger-color / -warning-color / -info-color | | Base color per semantic variant. |
--gog-tag-bg-base / -color-base / -bg-mix / -color-mix | | How the variant color is mixed into background and text. |
--gog-tag-radius / -pill-radius | | Corner radius, square and pill shape. |
--gog-tag-{size}-font-size / -padding-block / -padding-inline / -gap / -icon-size | | Full sizing scale, per size step (xsm/sm/md/lg/slg). |
| Token | Value | Description |
|---|---|---|
--gog-toast-bg / -color / -border | | Card surface. |
--gog-toast-success-color / -error-color / -warning-color / -info-color | | Accent stripe and icon color, per toast type. |
--gog-toast-padding / -radius | | Card padding and corner radius. |
--gog-toast-stack-peek / -stack-scale-step / -stack-expanded-gap | | Card-stack geometry when several toasts are visible at once. |
| Token | Value | Description |
|---|---|---|
--gog-toggle-track-off-bg / -track-on-bg / -on-border-color | | The track, off and on. |
--gog-toggle-border-color / -border-width / -border-style | | The track’s edge in the off state, which is the whole of the control when it is off. It defaults to --gog-control-boundary-color since 21.12.0; reading the decorative hairline instead had left an off switch at under 3:1 in all eleven themes, which is to say invisible to WCAG. |
--gog-toggle-thumb-off-bg / -thumb-on-bg / -thumb-shadow / -thumb-inset | | The sliding thumb. |
--gog-toggle-{size}-track-width / -track-height / -thumb-size / -label-size | | Full sizing scale, per size step (xsm/sm/md/lg/slg). |
--gog-toggle-state-color / -state-font-weight / -state-padding-inline / -state-thumb-gap | | The onLabel / offLabel text rendered inside the track. |
--gog-toggle-label-color / -gap / -radius | | The label next to the switch, its gap, and the track corner radius. |
--gog-toggle-focus-ring-color / -focus-ring-width / -focus-ring-offset / -disabled-opacity | | Keyboard focus ring and the disabled state. |
| Token | Value | Description |
|---|---|---|
--gog-tooltip-bg / -color / -border-color / -shadow / -radius | | The bubble surface. Deliberately the same floating-panel recipe as a dialog or dropdown, not a bespoke inverted bubble. |
--gog-tooltip-max-width / -max-height | | Content wraps at the width and scrolls past the height, inside an internal gog-scroll. |
--gog-tooltip-padding / -gap / -arrow-size | | Bubble padding, its distance from the trigger, and the arrow. |
--gog-tooltip-font-family / -font-size / -line-height | | Bubble typography. |
--gog-tooltip-z / -transition-duration | | Stacking order (raised inside a dialog so a tooltip stacks above it) and fade timing. |
Or copy this one block — every token worth overriding to build a fully custom theme, from fonts through the palette to the component layer:
/*
* Theme starter — every token the library paints with, ready to override.
* Order: fonts, palette, character layer (radius/borders/casing/density — the
* short path to a custom look), structure (motion, focus, the metrics that are
* literals), then every component token grouped by component.
*
* Copy this after the library import and replace the values. Load order is the
* point: this file is meant to come second, so anything you set here beats the
* library's own value at equal specificity.
*
* **"Every token" is now checked, not claimed.** It used to be neither — this
* file carried 714 of the library's 1312 tokens, with fifteen components missing
* outright, because it was hand-copied and nothing compared it to the source.
* The component block is generated by `npm run generate:theme-starter` and
* `npm run check:theme-starter` fails the build if any token is unaccounted for.
* Edit the head freely; leave the generated block to the script.
*/
/* ── Fonts & type scale ──────────────────────────────────────────────────── */
:root {
--gog-font-heading: 'YourHeadingFont', serif;
--gog-font-body: 'YourBodyFont', sans-serif;
--gog-font-mono: 'YourMonoFont', monospace;
/* 11px, the bottom of the scale. It exists because the smallest chip and the smallest
tag were already painting it as a literal — the step was in use before it had a name. */
--gog-text-2xs: 0.6875rem;
--gog-text-xs: 0.75rem;
--gog-text-sm: 0.875rem;
--gog-text-md: 1rem;
--gog-text-lg: 1.125rem;
/* 20px, between `lg` and `xl`, and named for the control size it serves rather than
continuing the t-shirt run: `gog-button` and the field controls both needed a step for
their `slg` size and, having none, both wrote `1.25rem` as a literal. */
--gog-text-slg: 1.25rem;
--gog-text-xl: 1.5rem;
--gog-text-2xl: 2rem;
--gog-text-3xl: 3rem;
}
/* ── Palette — Light (also the default with no data-theme set) ──────────── */
:root,
[data-theme='light'] {
color-scheme: light;
--gog-background-color: #f6f0e6;
--gog-surface-color: #eae0d0;
--gog-hover-color: #dfd3bf;
--gog-border-color: #c4b496;
--gog-text-color: #1e170e;
--gog-accent-text-color: #ece4d0;
--gog-muted-text-color: #6e5438;
--gog-primary-color: #1e170e;
--gog-accent-color: #8c6200;
--gog-accent-bright: #b8860b;
--gog-accent-dim: #634500;
--gog-accent-pale: #f4e8c1;
--gog-secondary-color: #a07800;
--gog-success-color: #2d6a4f;
--gog-danger-color: #9b2226;
--gog-warning-color: #bb3e03;
--gog-info-color: #4a6fa5;
/* The edge that identifies a control, as distinct from --gog-border-color above, which
is the decorative hairline this library draws dividers, table rules and panel outlines
with and deliberately keeps faint. This one has to clear 3:1 under WCAG SC 1.4.11, and
the two cannot be one token: a theme that sets only the decorative colour either shouts
its dividers or hides its controls. Computed rather than picked —
`npm run suggest:color -- #c4b496 #eae0d0 3.2` holds this palette's own hue and chroma
and lands here, 3.21:1 on the surface and 3.70:1 on the page. */
--gog-control-boundary-color: #897a5e;
/* ── Elevation, light ──────────────────────────────────────────────────────
Ten knobs, and the six steps every raised surface reads are generated from them in
the block below — so there is no --gog-panel-shadow or --gog-dialog-shadow here any
more, and there should not be: writing one would take that surface off the ladder
while the others stayed on it, which is the inconsistency the family exists to end.
**State all ten or none.** Custom properties inherit, so a theme block declaring six
of them silently borrows the other four from whatever encloses it, and the failure is
a shadow that looks nearly right rather than an error.
A step is two lights: the contact shadow, which hugs the object and does not grow with
height, and the key light, whose offset is Z and whose blur is three times it. The three
multipliers are the style axis — this is the soft default; a hard-offset theme sets x
and y to a fraction and blur to 0, and a glow theme sets y to 0 and keeps the blur. */
--gog-elevation-ink: 30 23 14;
--gog-elevation-key-alpha: 0.08;
--gog-elevation-ambient-alpha: 0.04;
--gog-elevation-contact-blur: 3px;
--gog-elevation-key-x: 0;
--gog-elevation-key-y: 1;
--gog-elevation-key-blur: 3;
/* The hairline ring and the top-edge catch light are outside the steps on purpose: they
belong to particular surfaces rather than to height. Both inert on a light ground. */
--gog-elevation-ring-width: 0px;
--gog-elevation-highlight-ink: 255 255 255;
--gog-elevation-highlight-alpha: 0;
--gog-spinner-overlay-bg: rgba(246, 240, 230, 0.75);
}
/*
* ── Palette — Dark ─────────────────────────────────────────────────────────
* Same tokens as the light block above, just different values — that's the
* whole pattern for any theme-specific override. Scope it under
* [data-theme='dark'], not a bare :root, or it also becomes the light theme.
*/
[data-theme='dark'] {
color-scheme: dark;
--gog-background-color: #0f0d0a;
--gog-surface-color: #191510;
--gog-hover-color: #262018;
--gog-border-color: #382e22;
--gog-text-color: #e5dec9;
--gog-accent-text-color: #e5dec9;
--gog-muted-text-color: #9e8c72;
--gog-primary-color: #e5dec9;
--gog-accent-color: #f3be3a;
--gog-accent-bright: #ffd05b;
--gog-accent-dim: #b5881a;
--gog-accent-pale: #3d2f0e;
--gog-secondary-color: #d4a373;
--gog-success-color: #52b788;
--gog-danger-color: #e63946;
--gog-warning-color: #f4a261;
--gog-info-color: #64dfdf;
--gog-control-boundary-color: #716558;
--gog-spinner-overlay-bg: rgba(15, 13, 10, 0.75);
/* ── Elevation, dark ───────────────────────────────────────────────────────
All ten again, which is the rule: a theme states the whole family or none of it.
A dark theme genuinely does have to say something different here, and this is where it
says it. On a near-black page a black blur reads as smudge rather than lift, so the two
alphas are far higher than the light theme's; the ring and the catch light, both inert
above, are what actually carry the edge of a raised surface here.
The two hand-written `elevated` shadows this block used to carry are gone, and not
because they were wrong — because the ladder now reproduces them exactly. `inset 0 1px 0
rgba(255, 255, 255, 0.07)` over `0 2px 6px rgba(0, 0, 0, 0.55)` is precisely
`var(--gog-elevation-highlight), var(--gog-elevation-2)` under these knobs. */
--gog-elevation-ink: 0 0 0;
--gog-elevation-key-alpha: 0.55;
--gog-elevation-ambient-alpha: 0.28;
--gog-elevation-contact-blur: 3px;
--gog-elevation-key-x: 0;
--gog-elevation-key-y: 1;
--gog-elevation-key-blur: 3;
--gog-elevation-ring-width: 1px;
--gog-elevation-highlight-ink: 255 255 255;
--gog-elevation-highlight-alpha: 0.07;
}
/*
* ── Character layer — radius, borders, casing ────────────────────────────────
* The short path to a custom look: most component tokens further down read
* these instead of declaring their own literal, so changing a value here
* reshapes the whole library at once, before you ever touch a per-component
* token.
*/
:root {
--gog-radius: 8px;
/* Three border-weight tiers: --gog-control-border-width is form fields,
--gog-panel-border-width is raised/floating surfaces (dialog), and this
plain pair is everything smaller and inline (chip, tag, table row). */
--gog-border-width: 1px;
--gog-border-style: solid;
--gog-panel-border-width: 1px;
--gog-panel-border-style: solid;
--gog-control-border-width: 2px;
--gog-control-border-style: solid;
/* The "emphasis" casing/tracking shared by buttons, section headers, table
headers and field labels. */
--gog-text-transform: uppercase;
--gog-letter-spacing: 1px;
/* Weight, the third character axis. Set these and every component weight follows. The 400
step is what field labels are set in. */
--gog-font-weight-regular: 400;
--gog-font-weight-medium: 500;
--gog-font-weight-semibold: 600;
--gog-font-weight-bold: 700;
--gog-font-weight-heavy: 900;
/* Leading, the fourth. Six steps because six values are painted. `gog-panel`'s heading keeps
its own 1.25, off this scale on purpose the way an 11px chip is off the type scale. */
--gog-line-height-none: 1;
--gog-line-height-tight: 1.2;
--gog-line-height-snug: 1.3;
--gog-line-height-normal: 1.4;
--gog-line-height-relaxed: 1.5;
--gog-line-height-loose: 1.6;
/* One multiplier under every padding and gap in the library: the ten-step spacing
scale further down is `calc(Npx * var(--gog-density))`, so 0.9 tightens the whole
UI and 1.15 opens it up without touching a single component token. Keep it here
rather than inside a [data-theme] block — a step declared in a theme scope would be
computed once against :root's density instead of its own. */
--gog-density: 1;
}
/*
* ── Structure — motion, focus, and the metrics that are literals ─────────────
* The geometry every component sizes itself from, and the part of it that is a
* real number rather than a derivation.
*
* The spacing scale is deliberately NOT here. `--gog-space-4` … `--gog-space-48`
* and the five `--gog-space-xs` … `--gog-space-2xl` aliases onto them all read
* `--gog-density`, so they live in the generated block below with everything else
* that derives. Redeclaring one here as a literal is exactly how you would take it
* out of density without meaning to — this file used to do that with all five.
*/
:root {
--gog-duration-fast: 0.12s;
--gog-duration-base: 0.15s;
--gog-duration-slow: 0.2s;
--gog-easing: ease;
--gog-focus-ring-width: 3px;
--gog-focus-ring-offset: 2px;
--gog-disabled-opacity: 0.4;
/* The library's stacking floor. Every layer is `base + N` — badge 1, toast 100, dropdowns
and dialogs 300, tooltip 400, the blocking spinner overlay 8000 — so lifting the whole
library above your own chrome is this one number, with the internal order kept. */
--gog-z-base: 0;
/* The clear (x) button's glyph as a fraction of its box, shared by the five single-line
controls that draw one. `gog-textarea` keeps its own 1 on purpose: its clear button sits
in a corner rather than in the field's icon row. */
--gog-control-clear-icon-ratio: 0.7;
/* Checkbox and radio metrics, per size step (xsm/sm/md/lg/slg). A box is a shape,
not spacing, so these stay literal and do not follow density. */
--gog-control-checkbox-box-size-xsm: 12px;
--gog-control-checkbox-box-size-sm: 18px;
--gog-control-checkbox-box-size-md: 24px;
--gog-control-checkbox-box-size-lg: 32px;
--gog-control-checkbox-box-size-slg: 40px;
--gog-control-checkbox-label-size-xsm: 0.6875rem;
--gog-control-checkbox-label-size-sm: 0.8125rem;
--gog-control-checkbox-label-size-md: 0.9375rem;
--gog-control-checkbox-label-size-lg: 1.0625rem;
--gog-control-checkbox-label-size-slg: 1.1875rem;
--gog-control-checkbox-icon-size-xsm: 10px;
--gog-control-checkbox-icon-size-sm: 12px;
--gog-control-checkbox-icon-size-md: 14px;
--gog-control-checkbox-icon-size-lg: 18px;
--gog-control-checkbox-icon-size-slg: 22px;
/* Field sizing, shared by input / select / multiselect. The glyph box is literal on
purpose while the offsets around it follow density: an icon that shrinks with the
padding stops being legible well before the padding stops being usable. */
--gog-field-icon-glyph-xsm: 12px;
--gog-field-icon-glyph-sm: 14px;
--gog-field-icon-glyph: 16px;
--gog-field-slg-font-size: 1.25rem;
/* Float-label geometry, one scale for every field that can float its label. Each
control reads these through its own --gog-<block>-float-label-* token below, so a
value set here retunes all of them while a single control can still be tuned alone.
`reserve` is the headroom added inside the field for the 'in'/'on' variants;
`in-top` is where the label lands once floated; `over-reserve` is the space kept
permanently clear for the 'over' variant. */
--gog-field-float-label-reserve: 14px;
--gog-field-float-label-in-top: 6px;
--gog-field-float-label-over-reserve: 1.4em;
--gog-icon-size: 1.2em;
--gog-icon-stroke-width: 2;
--gog-spinner-size-xsm: 12px;
--gog-spinner-size-sm: 18px;
--gog-spinner-size-md: 48px;
--gog-spinner-size-lg: 96px;
--gog-spinner-size-slg: 144px;
--gog-spinner-rune-size: 20px;
/* Toast stack geometry */
--gog-toast-min-width: 280px;
--gog-toast-max-width: 400px;
--gog-toast-z-index: 9999;
--gog-toast-enter-distance: 110%;
/* Stacking order for dropdown panels and the spinner overlay */
--gog-dropdown-z: 300;
--gog-spinner-overlay-z: 8000;
}
/* theme-starter:derived-start */
/*
* ── Component tokens — every one, generated ─────────────────────────────────
* Copied verbatim from the installed @guildofgleks/ui's theme.css derived layer by
* `npm run generate:theme-starter`. Do not hand-edit between the markers: run the
* script instead, or the next run reverts you. Everything here reads another token,
* so a palette or character-layer edit above already carries through — override one
* of these directly only when that one component has to differ from the rest.
*
* theme.css re-declares seventeen of these inside an `@supports (color: color-mix(…))`
* block, which is how 21.7.1 gives older browsers a flat fallback. That block is
* deliberately not mirrored here: this file is loaded after the library, so a value you
* set below wins in every browser, which is what an override file should do.
*/
:root,
[data-theme] {
/* ── Derived foundation tokens ─────────────────────────────────────────────── */
/* ── The elevation ladder ────────────────────────────────────────────────────
Generated from the knobs above. What sits on each step:
0 — flat: buttons at rest, `outlined` and `filled` cards and panels
1 — a mark on a control: the toggle's thumb
2 — raised in flow: `elevated` cards and panels
3 — anchored overlays: dropdown panels, tooltip, menu
4 — free-floating overlays: toast
5 — modal: dialog */
--gog-elevation-contact: 0 1px var(--gog-elevation-contact-blur)
rgb(var(--gog-elevation-ink) / var(--gog-elevation-ambient-alpha));
/* Character layers, not steps: a surface that wants one prepends it. */
--gog-elevation-ring: 0 0 0 var(--gog-elevation-ring-width) var(--gog-border-color);
--gog-elevation-highlight: inset 0 1px 0
rgb(var(--gog-elevation-highlight-ink) / var(--gog-elevation-highlight-alpha));
--gog-elevation-0: none;
--gog-elevation-1:
var(--gog-elevation-contact),
calc(1px * var(--gog-elevation-key-x)) calc(1px * var(--gog-elevation-key-y))
calc(1px * var(--gog-elevation-key-blur))
rgb(var(--gog-elevation-ink) / var(--gog-elevation-key-alpha));
--gog-elevation-2:
var(--gog-elevation-contact),
calc(2px * var(--gog-elevation-key-x)) calc(2px * var(--gog-elevation-key-y))
calc(2px * var(--gog-elevation-key-blur))
rgb(var(--gog-elevation-ink) / var(--gog-elevation-key-alpha));
--gog-elevation-3:
var(--gog-elevation-contact),
calc(4px * var(--gog-elevation-key-x)) calc(4px * var(--gog-elevation-key-y))
calc(4px * var(--gog-elevation-key-blur))
rgb(var(--gog-elevation-ink) / var(--gog-elevation-key-alpha));
--gog-elevation-4:
var(--gog-elevation-contact),
calc(8px * var(--gog-elevation-key-x)) calc(8px * var(--gog-elevation-key-y))
calc(8px * var(--gog-elevation-key-blur))
rgb(var(--gog-elevation-ink) / var(--gog-elevation-key-alpha));
--gog-elevation-5:
var(--gog-elevation-contact),
calc(16px * var(--gog-elevation-key-x)) calc(16px * var(--gog-elevation-key-y))
calc(16px * var(--gog-elevation-key-blur))
rgb(var(--gog-elevation-ink) / var(--gog-elevation-key-alpha));
/* The public surface names consumers override, each placed on the ladder; a theme moves all of
them by turning the knobs, and overriding one still works. */
--gog-panel-shadow: var(--gog-elevation-ring), var(--gog-elevation-3);
--gog-toast-shadow: var(--gog-elevation-ring), var(--gog-elevation-4);
--gog-dialog-shadow: var(--gog-elevation-ring), var(--gog-elevation-5);
--gog-toggle-thumb-shadow: var(--gog-elevation-1);
/* ── Text on a status fill ───────────────────────────────────────────────────
One label colour does not read on every status fill (white on an amber fill can fall far below
AA), so each status names its own. They default to the accent's label; a theme overrides only
the ones its own hues need. */
--gog-success-text-color: var(--gog-accent-text-color, var(--gog-primary-color));
--gog-danger-text-color: var(--gog-accent-text-color, var(--gog-primary-color));
--gog-warning-text-color: var(--gog-accent-text-color, var(--gog-primary-color));
--gog-info-text-color: var(--gog-accent-text-color, var(--gog-primary-color));
/* Which way a status fill deepens on hover and press: away from its label, so the label only
gets easier to read. Themes whose label is the ink reverse this in their own files. */
--gog-success-shade: var(--gog-text-color);
--gog-danger-shade: var(--gog-text-color);
--gog-warning-shade: var(--gog-text-color);
--gog-info-shade: var(--gog-text-color);
/* ── Overlay stacking ─────────────────────────────────────────────────────────
All read `--gog-z-base`. The gaps leave room for an app to slot its own layer in between. */
--gog-badge-z: calc(var(--gog-z-base) + 1);
--gog-toast-base-z: calc(var(--gog-z-base) + 100);
--gog-dropdown-z: calc(var(--gog-z-base) + 300);
--gog-tooltip-z: calc(var(--gog-z-base) + 400);
/* Above everything, including a dialog it may be covering. */
--gog-spinner-overlay-z: calc(var(--gog-z-base) + 8000);
/* ── Spacing & geometry ─────────────────────────────────────────────────────── */
--gog-space-4: calc(4px * var(--gog-density));
--gog-space-8: calc(8px * var(--gog-density));
--gog-space-12: calc(12px * var(--gog-density));
--gog-space-16: calc(16px * var(--gog-density));
--gog-space-20: calc(20px * var(--gog-density));
--gog-space-24: calc(24px * var(--gog-density));
--gog-space-28: calc(28px * var(--gog-density));
--gog-space-32: calc(32px * var(--gog-density));
/* Needed by the 2:1 padding ratio: an `slg` control with 20px vertical padding takes 40px horizontal. */
--gog-space-40: calc(40px * var(--gog-density));
--gog-space-48: calc(48px * var(--gog-density));
--gog-space-xs: var(--gog-space-4);
--gog-space-sm: var(--gog-space-8);
--gog-space-md: var(--gog-space-16);
--gog-space-lg: var(--gog-space-24);
--gog-space-2xl: var(--gog-space-48);
--gog-panel-radius: calc(var(--gog-radius) + 8px);
/* ── Control metrics ────────────────────────────────────────────────────────── */
/* The shared control padding, at the library's 2:1 horizontal-to-vertical ratio. */
--gog-control-padding-y: var(--gog-space-12);
--gog-control-padding-x: var(--gog-space-24);
/* Padding around a checkable control's box is part of its pointer target: it is what lets the
smallest checkbox reach 24×24 (WCAG 2.5.8) without growing the box. */
--gog-control-checkbox-padding: var(--gog-space-8);
--gog-control-icon-offset: var(--gog-space-12);
/* ── Field sizing ───────────────────────────────────────────────────────────── */
--gog-field-xsm-padding-y: var(--gog-space-4);
--gog-field-xsm-padding-x: var(--gog-space-8);
--gog-field-sm-padding-y: var(--gog-space-8);
--gog-field-sm-padding-x: var(--gog-space-16);
--gog-field-md-padding-y: var(--gog-control-padding-y);
--gog-field-md-padding-x: var(--gog-control-padding-x);
--gog-field-lg-padding-y: var(--gog-space-16);
--gog-field-lg-padding-x: var(--gog-space-32);
--gog-field-slg-padding-y: var(--gog-space-20);
--gog-field-slg-padding-x: var(--gog-space-40);
--gog-field-xsm-font-size: var(--gog-text-xs);
--gog-field-sm-font-size: var(--gog-text-sm);
--gog-field-md-font-size: var(--gog-text-md);
--gog-field-lg-font-size: var(--gog-text-lg);
/* A type size among geometry, because it reads a token and so must live in this derived block. */
--gog-field-slg-font-size: var(--gog-text-slg);
--gog-field-xsm-icon-offset: var(--gog-space-8);
--gog-field-sm-icon-offset: var(--gog-space-8);
--gog-field-md-icon-offset: var(--gog-control-icon-offset);
--gog-field-lg-icon-offset: var(--gog-space-16);
--gog-field-slg-icon-offset: var(--gog-space-20);
/* offset + glyph + offset. */
--gog-field-xsm-icon-inset: calc(
var(--gog-field-xsm-icon-offset) * 2 + var(--gog-field-icon-glyph-xsm)
);
--gog-field-sm-icon-inset: calc(
var(--gog-field-sm-icon-offset) * 2 + var(--gog-field-icon-glyph-sm)
);
--gog-field-md-icon-inset: calc(
var(--gog-field-md-icon-offset) * 2 + var(--gog-field-icon-glyph)
);
--gog-field-lg-icon-inset: calc(
var(--gog-field-lg-icon-offset) * 2 + var(--gog-field-icon-glyph)
);
--gog-field-slg-icon-inset: calc(
var(--gog-field-slg-icon-offset) * 2 + var(--gog-field-icon-glyph)
);
/* Leading for the three kinds of text a field renders — the value (one line, sized to the row),
the label and the error message (both may wrap) — declared once and aliased per component. */
--gog-field-line-height: var(--gog-line-height-normal);
--gog-field-label-line-height: var(--gog-line-height-snug);
--gog-field-error-line-height: var(--gog-line-height-snug);
/* ── Float label geometry ───────────────────────────────────────────────────── */
--gog-field-float-label-over-gap: var(--gog-space-8);
/* ── Field label ──────────────────────────────────────────────────────────────
The label above every form control, declared once so a theme restyles all eight together;
each component's `--gog-<block>-label-*` aliases these. */
--gog-field-label-color: var(--gog-accent-color);
--gog-field-label-font-family: var(--gog-font-heading);
--gog-field-label-font-size: var(--gog-text-sm);
--gog-field-label-font-weight: var(--gog-font-weight-regular);
--gog-field-label-letter-spacing: var(--gog-letter-spacing);
--gog-field-label-text-transform: var(--gog-text-transform);
/* ── Toast stack ──────────────────────────────────────────────────────────── */
--gog-toast-stack-padding: var(--gog-space-16);
/* The message wraps, so the cap is a measure in `ch`; the viewport clamp keeps the toast on screen
on narrow devices. */
--gog-toast-max-width: min(53ch, calc(100vw - var(--gog-toast-stack-padding) * 2));
/* ── Elevation ────────────────────────────────────────────────────────────────
What a raised surface paints. Equal to the surface on light themes, where a shadow carries
elevation; dark themes lift it instead, because a shadow has nothing to darken on a near-black
page. */
--gog-elevated-surface-color: var(--gog-surface-color);
/* ══════════════════════════════════════════════════════════════════════════════
COMPONENT TOKENS
Everything below is what an individual component paints with. Override a block
to restyle just that component; the values themselves all derive from the
foundation tokens above, so a palette swap carries through for free.
══════════════════════════════════════════════════════════════════════════════ */
/* ── Accordion ─────────────────────────────────────────────────────────────── */
--gog-accordion-font-family: var(--gog-font-heading);
--gog-accordion-body-font-family: var(--gog-font-body);
--gog-accordion-border-color: var(--gog-accent-dim);
--gog-accordion-border-width: var(--gog-control-border-width);
--gog-accordion-border-style: var(--gog-control-border-style);
--gog-accordion-text-color: var(--gog-text-color);
--gog-accordion-accent-color: var(--gog-accent-color);
--gog-accordion-hover-bg: var(--gog-hover-color);
/* The label keeps body colour while hovered or pressed: the accent is not readable as text on a
ground already tinted with the accent. */
--gog-accordion-hover-color: var(--gog-accordion-text-color);
--gog-accordion-press-bg: var(--gog-border-color);
/* Its own token, so focus is never a hover-weight colour that fails 3:1. */
--gog-accordion-focus-ring-color: var(--gog-accent-color);
--gog-accordion-focus-ring-width: var(--gog-focus-ring-width);
--gog-accordion-body-color: var(--gog-text-color);
--gog-accordion-body-line-height: var(--gog-line-height-loose);
--gog-accordion-header-text-transform: var(--gog-text-transform);
--gog-accordion-header-gap: var(--gog-space-12);
--gog-accordion-disabled-opacity: var(--gog-disabled-opacity);
--gog-accordion-transition-duration: var(--gog-duration-base);
--gog-accordion-body-transition-duration: var(--gog-duration-slow);
--gog-accordion-chevron-transition-duration: var(--gog-duration-slow);
--gog-accordion-body-lift: -2px;
/* Square by default; rounding is opt-in. */
--gog-accordion-radius: 0px;
--gog-accordion-body-radius: 0px;
/* The header carries its own ground so several open items stay separable. The body stays
transparent so the accordion takes on whatever surface it is placed on. */
--gog-accordion-header-bg: var(--gog-hover-color);
--gog-accordion-body-bg: transparent;
/* Per-size metrics; `lg` is the default. */
--gog-accordion-xsm-padding-y: var(--gog-space-4);
--gog-accordion-xsm-padding-x: var(--gog-space-8);
--gog-accordion-xsm-font-size: var(--gog-text-xs);
/* One UI line, so the leading is the row height. */
--gog-accordion-line-height: var(--gog-line-height-normal);
--gog-accordion-xsm-letter-spacing: 0.2px;
--gog-accordion-xsm-content-gap: var(--gog-space-4);
--gog-accordion-xsm-body-font-size: var(--gog-text-xs);
--gog-accordion-xsm-body-line-height: var(--gog-line-height-relaxed);
--gog-accordion-xsm-body-padding-top: var(--gog-space-4);
--gog-accordion-xsm-body-padding-bottom: var(--gog-space-8);
--gog-accordion-xsm-chevron-size: 1.4em;
/* The chevron is a ratio of the header's own type, so it scales with the label (including browser
text zoom). `1em` is the icon's basis; the box at 1.4em always contains the 1.2em glyph. */
--gog-accordion-xsm-chevron-font-size: 1em;
/* A glyph in its own box: leading would push it off centre. */
--gog-accordion-chevron-line-height: var(--gog-line-height-none);
--gog-accordion-sm-padding-y: var(--gog-space-8);
--gog-accordion-sm-padding-x: var(--gog-space-16);
--gog-accordion-sm-font-size: var(--gog-text-xs);
--gog-accordion-sm-letter-spacing: 0.4px;
--gog-accordion-sm-content-gap: var(--gog-space-4);
--gog-accordion-sm-body-font-size: var(--gog-text-xs);
--gog-accordion-sm-body-line-height: var(--gog-accordion-body-line-height);
--gog-accordion-sm-body-padding-top: var(--gog-space-8);
--gog-accordion-sm-body-padding-bottom: var(--gog-space-8);
--gog-accordion-sm-chevron-size: 1.4em;
--gog-accordion-sm-chevron-font-size: 1em;
--gog-accordion-md-padding-y: var(--gog-space-12);
--gog-accordion-md-padding-x: var(--gog-space-24);
--gog-accordion-md-font-size: var(--gog-text-xs);
--gog-accordion-md-letter-spacing: 0.8px;
--gog-accordion-md-content-gap: var(--gog-space-4);
--gog-accordion-md-body-font-size: var(--gog-text-sm);
--gog-accordion-md-body-line-height: var(--gog-accordion-body-line-height);
--gog-accordion-md-body-padding-top: var(--gog-space-8);
--gog-accordion-md-body-padding-bottom: var(--gog-space-12);
--gog-accordion-md-chevron-size: 1.4em;
--gog-accordion-md-chevron-font-size: 1em;
--gog-accordion-lg-padding-y: var(--gog-space-16);
--gog-accordion-lg-padding-x: var(--gog-space-32);
--gog-accordion-lg-font-size: var(--gog-text-sm);
--gog-accordion-lg-letter-spacing: 0.8px;
--gog-accordion-lg-content-gap: var(--gog-space-4);
--gog-accordion-lg-body-font-size: var(--gog-text-md);
--gog-accordion-lg-body-line-height: var(--gog-accordion-body-line-height);
--gog-accordion-lg-body-padding-top: var(--gog-space-12);
--gog-accordion-lg-body-padding-bottom: var(--gog-space-16);
--gog-accordion-lg-chevron-size: 1.4em;
--gog-accordion-lg-chevron-font-size: 1em;
--gog-accordion-slg-padding-y: var(--gog-space-20);
--gog-accordion-slg-padding-x: var(--gog-space-40);
--gog-accordion-slg-font-size: var(--gog-text-md);
--gog-accordion-slg-letter-spacing: 0.8px;
--gog-accordion-slg-content-gap: var(--gog-space-4);
--gog-accordion-slg-body-font-size: var(--gog-text-lg);
--gog-accordion-slg-body-line-height: var(--gog-accordion-body-line-height);
--gog-accordion-slg-body-padding-top: var(--gog-space-16);
--gog-accordion-slg-body-padding-bottom: var(--gog-space-20);
--gog-accordion-slg-chevron-size: 1.4em;
--gog-accordion-slg-chevron-font-size: 1em;
/* ── Alert ─────────────────────────────────────────────────────────────────
Severity is carried by a leading edge and the icon over the ordinary surface, not by a tinted
fill: the palette has no per-status tint, and inventing one would be one more colour every theme
has to restate. The severity tokens derive from the status colours, so a theme retunes once. */
--gog-alert-bg: var(--gog-surface-color);
--gog-alert-color: var(--gog-text-color);
--gog-alert-heading-color: var(--gog-text-color);
--gog-alert-font-family: var(--gog-font-body);
--gog-alert-border-color: var(--gog-border-color);
--gog-alert-border-width: var(--gog-panel-border-width);
--gog-alert-border-style: var(--gog-panel-border-style);
/* Twice the control border, so it reads as a mark rather than an uneven border, and thickens with
the controls. */
--gog-alert-edge-width: calc(var(--gog-control-border-width) * 2);
--gog-alert-radius: var(--gog-radius);
--gog-alert-padding-y: var(--gog-space-12);
--gog-alert-padding-x: var(--gog-space-24);
--gog-alert-gap: var(--gog-space-12);
/* The tightest step: heading and body are one block of text. */
--gog-alert-main-gap: var(--gog-space-4);
--gog-alert-icon-font-size: var(--gog-text-md);
/* A glyph in its own box: leading would push it off centre. */
--gog-alert-icon-line-height: var(--gog-line-height-none);
--gog-alert-heading-font-size: var(--gog-text-md);
--gog-alert-heading-font-weight: var(--gog-font-weight-semibold);
--gog-alert-heading-line-height: var(--gog-line-height-snug);
--gog-alert-body-font-size: var(--gog-text-sm);
--gog-alert-body-line-height: var(--gog-line-height-relaxed);
--gog-alert-accent-color: var(--gog-accent-color);
--gog-alert-success-color: var(--gog-success-color);
--gog-alert-danger-color: var(--gog-danger-color);
--gog-alert-warning-color: var(--gog-warning-color);
--gog-alert-info-color: var(--gog-info-color);
/* ── Avatar ────────────────────────────────────────────────────────────────
The five sizes are the skeleton circle's, by reference, so a `gog-skeleton shape="circle"`
standing in for an avatar at the same size is replaced without the layout moving. The fallback
(initials, then the icon) is drawn at a ratio of the box, so it scales with whichever size
resolves. */
--gog-avatar-xsm-size: var(--gog-skeleton-circle-size-xsm);
--gog-avatar-sm-size: var(--gog-skeleton-circle-size-sm);
--gog-avatar-md-size: var(--gog-skeleton-circle-size-md);
--gog-avatar-lg-size: var(--gog-skeleton-circle-size-lg);
--gog-avatar-slg-size: var(--gog-skeleton-circle-size-slg);
/* The fallback for an engine without color-mix(); the supported value is in the block below. */
--gog-avatar-bg: var(--gog-hover-color);
--gog-avatar-color: var(--gog-text-color);
--gog-avatar-font-family: var(--gog-font-body);
--gog-avatar-font-weight: var(--gog-font-weight-semibold);
/* The letters' box stays inside the circle. Measured across the eleven themes, the widest pair is
"WW" in `parchment`, 0.80d wide at this ratio and 0.28d tall: its corners sit 0.42d from the
centre, inside the 0.5d radius. "AL" is 0.49d, "GH" 0.6d. */
--gog-avatar-initials-ratio: 0.4;
/* Of the box, as the basis the glyph is drawn from: the icon is --gog-icon-size (1.2em) of it,
so 0.5 draws the user glyph at 0.6 of the diameter. */
--gog-avatar-icon-ratio: 0.5;
/* A glyph or two letters in their own box: leading would push them off centre. */
--gog-avatar-line-height: var(--gog-line-height-none);
--gog-avatar-rounded-radius: var(--gog-radius);
/* How far in from its box corner a circle crosses the diagonal: (1 - 1/sqrt(2)) / 2 of the
diameter. A `gogBadge` on a round avatar anchors there instead of at the empty box corner. */
--gog-avatar-badge-inset-ratio: 0.1464;
/* How far each avatar in a gog-avatar-group steps back over the one before, of the diameter. The
next avatar and its ring cover the trailing (ratio * d + ring) of this one, and a typical pair
of initials ("GH", 0.6d) ends 0.2d from the edge: an eighth plus a 2px ring leaves it uncovered
at every size. The widest pairs ("WW", 0.75-0.8d) lose a few pixels of their outer stroke. */
--gog-avatar-group-overlap-ratio: 0.125;
/* Separates two overlapping edges; set the colour to whatever the group sits on. */
--gog-avatar-group-ring-width: var(--gog-control-border-width);
--gog-avatar-group-ring-color: var(--gog-background-color);
/* Three characters where an avatar draws two: "99+" is 0.51d at this ratio (0.69d at 0.4), so it
stays narrower than a typical pair of initials. */
--gog-avatar-group-more-initials-ratio: 0.3;
/* ── Breadcrumbs ───────────────────────────────────────────────────────────
The parents are links in the muted colour, the current page is the text colour: the trail is
read as context, and the one item that is not a link is the one that says where you are. */
--gog-breadcrumbs-font-family: var(--gog-font-body);
/* A single line of labels: the tight end of the leading scale. */
--gog-breadcrumbs-line-height: var(--gog-line-height-snug);
--gog-breadcrumbs-gap: var(--gog-space-8);
--gog-breadcrumbs-link-color: var(--gog-muted-text-color);
--gog-breadcrumbs-link-hover-color: var(--gog-text-color);
--gog-breadcrumbs-current-color: var(--gog-text-color);
--gog-breadcrumbs-current-font-weight: var(--gog-font-weight-semibold);
--gog-breadcrumbs-separator-color: var(--gog-muted-text-color);
--gog-breadcrumbs-more-padding-y: var(--gog-space-4);
--gog-breadcrumbs-more-padding-x: var(--gog-space-8);
--gog-breadcrumbs-more-radius: var(--gog-radius);
--gog-breadcrumbs-more-hover-bg: var(--gog-hover-color);
--gog-breadcrumbs-focus-ring-width: var(--gog-focus-ring-width);
--gog-breadcrumbs-focus-ring-offset: var(--gog-focus-ring-offset);
--gog-breadcrumbs-focus-ring-color: var(--gog-accent-color);
--gog-breadcrumbs-xsm-font-size: var(--gog-text-xs);
--gog-breadcrumbs-sm-font-size: var(--gog-text-sm);
--gog-breadcrumbs-md-font-size: var(--gog-text-sm);
--gog-breadcrumbs-lg-font-size: var(--gog-text-md);
--gog-breadcrumbs-slg-font-size: var(--gog-text-lg);
/* ── Stepper ───────────────────────────────────────────────────────────────
An indicator per step, drawn from the step's font size. Done is the accent fill, the current
step the accent ring, an error the danger fill; a step not yet reachable is muted. */
--gog-stepper-font-family: var(--gog-font-body);
/* Label and description are one short block: the tight end of the leading scale. */
--gog-stepper-line-height: var(--gog-line-height-snug);
--gog-stepper-gap: var(--gog-space-8);
--gog-stepper-trigger-padding-y: var(--gog-space-4);
--gog-stepper-trigger-padding-x: var(--gog-space-8);
--gog-stepper-trigger-radius: var(--gog-radius);
--gog-stepper-trigger-hover-bg: var(--gog-hover-color);
--gog-stepper-trigger-press-bg: var(--gog-border-color);
--gog-stepper-focus-ring-width: var(--gog-focus-ring-width);
--gog-stepper-focus-ring-offset: var(--gog-focus-ring-offset);
--gog-stepper-focus-ring-color: var(--gog-accent-color);
/* The number at the label's size with half an em clear on every side. */
--gog-stepper-indicator-ratio: 2;
--gog-stepper-indicator-border-width: var(--gog-control-border-width);
--gog-stepper-indicator-border-color: var(--gog-control-boundary-color);
--gog-stepper-indicator-bg: transparent;
--gog-stepper-indicator-color: var(--gog-muted-text-color);
--gog-stepper-indicator-font-weight: var(--gog-font-weight-semibold);
--gog-stepper-label-color: var(--gog-text-color);
--gog-stepper-description-color: var(--gog-muted-text-color);
/* One step down the type scale from the label at md (--gog-text-xs / --gog-text-sm), as a ratio so
it follows every size. */
--gog-stepper-description-font-size: 0.857em;
/* A short note under a label: single-line in practice, so the label's own tight step. */
--gog-stepper-description-line-height: var(--gog-line-height-snug);
--gog-stepper-current-color: var(--gog-accent-color);
--gog-stepper-current-label-color: var(--gog-text-color);
--gog-stepper-current-font-weight: var(--gog-font-weight-semibold);
--gog-stepper-complete-bg: var(--gog-accent-color);
--gog-stepper-complete-color: var(--gog-accent-text-color, var(--gog-primary-color));
--gog-stepper-error-bg: var(--gog-danger-color);
--gog-stepper-error-color: var(--gog-danger-text-color);
--gog-stepper-error-label-color: var(--gog-danger-color);
--gog-stepper-unreachable-color: var(--gog-muted-text-color);
--gog-stepper-connector-thickness: var(--gog-control-border-width);
--gog-stepper-connector-min-length: var(--gog-space-24);
--gog-stepper-connector-color: var(--gog-control-boundary-color);
--gog-stepper-connector-done-color: var(--gog-accent-color);
--gog-stepper-xsm-font-size: var(--gog-text-xs);
--gog-stepper-sm-font-size: var(--gog-text-sm);
--gog-stepper-md-font-size: var(--gog-text-sm);
--gog-stepper-lg-font-size: var(--gog-text-md);
--gog-stepper-slg-font-size: var(--gog-text-lg);
/* ── File upload ───────────────────────────────────────────────────────────
A dashed surface around an invisible file input. The dash is the control boundary colour, so
the zone stays visible at 3:1; hover and a drag over it tint it with the accent. */
--gog-file-upload-font-family: var(--gog-font-body);
/* Prompt, file names: short lines of text. */
--gog-file-upload-line-height: var(--gog-line-height-snug);
--gog-file-upload-gap: var(--gog-space-8);
--gog-file-upload-label-font-family: var(--gog-field-label-font-family);
--gog-file-upload-label-font-size: var(--gog-field-label-font-size);
--gog-file-upload-label-line-height: var(--gog-field-label-line-height);
--gog-file-upload-label-font-weight: var(--gog-field-label-font-weight);
--gog-file-upload-label-color: var(--gog-field-label-color);
--gog-file-upload-label-text-transform: var(--gog-field-label-text-transform);
--gog-file-upload-label-letter-spacing: var(--gog-field-label-letter-spacing);
--gog-file-upload-zone-gap: var(--gog-space-4);
--gog-file-upload-zone-border-width: var(--gog-control-border-width);
--gog-file-upload-zone-border-color: var(--gog-control-boundary-color);
--gog-file-upload-zone-radius: var(--gog-radius);
--gog-file-upload-zone-bg: transparent;
--gog-file-upload-zone-active-border-color: var(--gog-accent-color);
--gog-file-upload-zone-active-bg: var(--gog-hover-color);
--gog-file-upload-transition-duration: var(--gog-duration-fast);
--gog-file-upload-prompt-color: var(--gog-text-color);
/* Marked by its underline and weight, not a colour: accent-dim fell to 4.29:1 on the hover tint in
one-dark, and the text colour clears every ground. */
--gog-file-upload-browse-color: var(--gog-text-color);
--gog-file-upload-browse-font-weight: var(--gog-font-weight-semibold);
--gog-file-upload-icon-color: var(--gog-muted-text-color);
/* Of the prompt's own size, as the basis the glyph is drawn from (1.2em of it). */
--gog-file-upload-icon-font-size: 1.5em;
/* A glyph in its own box: leading would push it off centre. */
--gog-file-upload-icon-line-height: var(--gog-line-height-none);
--gog-file-upload-hint-color: var(--gog-muted-text-color);
--gog-file-upload-hint-font-size: var(--gog-text-xs);
--gog-file-upload-hint-line-height: var(--gog-line-height-snug);
--gog-file-upload-list-gap: var(--gog-space-4);
--gog-file-upload-file-gap: var(--gog-space-8);
--gog-file-upload-name-color: var(--gog-text-color);
--gog-file-upload-remove-radius: var(--gog-radius);
--gog-file-upload-error-color: var(--gog-danger-color);
--gog-file-upload-focus-ring-width: var(--gog-focus-ring-width);
--gog-file-upload-focus-ring-offset: var(--gog-focus-ring-offset);
--gog-file-upload-focus-ring-color: var(--gog-accent-color);
--gog-file-upload-disabled-opacity: var(--gog-disabled-opacity);
--gog-file-upload-xsm-font-size: var(--gog-text-xs);
--gog-file-upload-sm-font-size: var(--gog-text-sm);
--gog-file-upload-md-font-size: var(--gog-text-sm);
--gog-file-upload-lg-font-size: var(--gog-text-md);
--gog-file-upload-slg-font-size: var(--gog-text-lg);
--gog-file-upload-xsm-zone-padding: var(--gog-space-12);
--gog-file-upload-sm-zone-padding: var(--gog-space-16);
--gog-file-upload-md-zone-padding: var(--gog-space-24);
--gog-file-upload-lg-zone-padding: var(--gog-space-32);
--gog-file-upload-slg-zone-padding: var(--gog-space-40);
/* ── Rating ────────────────────────────────────────────────────────────────
Stars over native radios. An empty star's outline is the control boundary colour, so there is
visibly a star to press at 3:1; a filled one is the accent. */
--gog-rating-font-family: var(--gog-font-body);
--gog-rating-gap: var(--gog-space-8);
--gog-rating-label-font-family: var(--gog-field-label-font-family);
--gog-rating-label-font-size: var(--gog-field-label-font-size);
--gog-rating-label-line-height: var(--gog-field-label-line-height);
--gog-rating-label-font-weight: var(--gog-field-label-font-weight);
--gog-rating-label-color: var(--gog-field-label-color);
--gog-rating-label-text-transform: var(--gog-field-label-text-transform);
--gog-rating-label-letter-spacing: var(--gog-field-label-letter-spacing);
/* The least room around a star; the component raises it to keep a 24x24 target. */
--gog-rating-star-padding: var(--gog-space-4);
--gog-rating-star-radius: var(--gog-radius);
/* A glyph in its own box: leading would push it off centre. */
--gog-rating-glyph-line-height: var(--gog-line-height-none);
--gog-rating-empty-color: var(--gog-control-boundary-color);
--gog-rating-fill-color: var(--gog-accent-color);
--gog-rating-focus-ring-width: var(--gog-focus-ring-width);
--gog-rating-focus-ring-offset: var(--gog-focus-ring-offset);
--gog-rating-focus-ring-color: var(--gog-accent-color);
--gog-rating-error-color: var(--gog-danger-color);
--gog-rating-error-font-size: var(--gog-text-xs);
--gog-rating-error-line-height: var(--gog-line-height-snug);
--gog-rating-disabled-opacity: var(--gog-disabled-opacity);
--gog-rating-xsm-star-size: var(--gog-space-16);
--gog-rating-sm-star-size: var(--gog-space-20);
--gog-rating-md-star-size: var(--gog-space-24);
--gog-rating-lg-star-size: var(--gog-space-28);
--gog-rating-slg-star-size: var(--gog-space-32);
/* ── Empty state ───────────────────────────────────────────────────────────
What a region says when it has nothing to show: a muted icon, a title, a description at a
readable measure, and actions. No border or fill — it sits in a surface that has one. */
--gog-empty-state-font-family: var(--gog-font-body);
--gog-empty-state-gap: var(--gog-space-12);
--gog-empty-state-message-gap: var(--gog-space-4);
/* A description reads as a paragraph, not one line across a wide table. */
--gog-empty-state-measure: 48ch;
--gog-empty-state-icon-color: var(--gog-muted-text-color);
/* A glyph in its own box: leading would push it off centre. */
--gog-empty-state-icon-line-height: var(--gog-line-height-none);
--gog-empty-state-heading-color: var(--gog-text-color);
--gog-empty-state-heading-font-weight: var(--gog-font-weight-semibold);
/* A title of a few words: the tight end of the leading scale. */
--gog-empty-state-heading-line-height: var(--gog-line-height-snug);
--gog-empty-state-description-color: var(--gog-muted-text-color);
--gog-empty-state-description-line-height: var(--gog-line-height-relaxed);
--gog-empty-state-actions-gap: var(--gog-space-8);
/* The actions sit a step further from the text than the text's own gap. */
--gog-empty-state-actions-offset: var(--gog-space-4);
--gog-empty-state-xsm-padding: var(--gog-space-12);
--gog-empty-state-sm-padding: var(--gog-space-16);
--gog-empty-state-md-padding: var(--gog-space-24);
--gog-empty-state-lg-padding: var(--gog-space-32);
--gog-empty-state-slg-padding: var(--gog-space-40);
--gog-empty-state-xsm-icon-size: var(--gog-space-24);
--gog-empty-state-sm-icon-size: var(--gog-space-32);
--gog-empty-state-md-icon-size: var(--gog-space-40);
--gog-empty-state-lg-icon-size: var(--gog-space-48);
--gog-empty-state-slg-icon-size: calc(var(--gog-space-32) * 2);
--gog-empty-state-xsm-heading-font-size: var(--gog-text-sm);
--gog-empty-state-sm-heading-font-size: var(--gog-text-md);
--gog-empty-state-md-heading-font-size: var(--gog-text-lg);
--gog-empty-state-lg-heading-font-size: var(--gog-text-xl);
--gog-empty-state-slg-heading-font-size: var(--gog-text-2xl);
--gog-empty-state-xsm-description-font-size: var(--gog-text-xs);
--gog-empty-state-sm-description-font-size: var(--gog-text-sm);
--gog-empty-state-md-description-font-size: var(--gog-text-sm);
--gog-empty-state-lg-description-font-size: var(--gog-text-md);
--gog-empty-state-slg-description-font-size: var(--gog-text-lg);
/* ── Collapsible ───────────────────────────────────────────────────────────
No owned markup: the `.gog-collapsible__*` rules live in utilities.css, because they style content
the consumer projects, which a scoped stylesheet cannot reach. */
--gog-collapsible-transition-duration: var(--gog-duration-slow);
/* The content's natural height, so an open panel never clips what it holds. It still animates where
`interpolate-size` is supported and snaps open elsewhere. Set a length only to cap a panel on
purpose — it will clip. */
--gog-collapsible-max-height: max-content;
--gog-collapsible-disabled-opacity: var(--gog-disabled-opacity);
/* ── Button ────────────────────────────────────────────────────────────────
`--gog-button-bg`, `-color`, `-border`, `-shadow`, `-hover-bg`, `-hover-shadow`, `-padding` and
`-font-size` are intentionally NOT declared: they are the per-instance escape hatch the variant
and size classes fall back through. */
--gog-button-xsm-padding: var(--gog-space-4) var(--gog-space-8);
--gog-button-sm-padding: var(--gog-space-8) var(--gog-space-16);
--gog-button-md-padding: var(--gog-space-12) var(--gog-space-24);
--gog-button-lg-padding: var(--gog-space-16) var(--gog-space-32);
--gog-button-slg-padding: var(--gog-space-20) var(--gog-space-40);
--gog-button-xsm-font-size: var(--gog-text-xs);
--gog-button-sm-font-size: var(--gog-text-sm);
--gog-button-md-font-size: var(--gog-text-md);
--gog-button-lg-font-size: var(--gog-text-lg);
--gog-button-slg-font-size: var(--gog-text-slg);
--gog-button-font-family: var(--gog-font-heading);
--gog-button-font-weight: var(--gog-font-weight-heavy);
--gog-button-letter-spacing: var(--gog-letter-spacing);
--gog-button-text-transform: var(--gog-text-transform);
--gog-button-line-height: var(--gog-line-height-none);
--gog-button-gap: var(--gog-space-sm);
--gog-button-radius: var(--gog-radius);
--gog-button-border-width: var(--gog-control-border-width);
--gog-button-border-style: var(--gog-control-border-style);
--gog-button-transition-duration: var(--gog-duration-base);
--gog-button-focus-ring-width: var(--gog-focus-ring-width);
/* One focus colour for every variant: the ring has to show against the page the button sits on,
which does not change with the button's fill. A variant's hover wash is too faint to do it. */
--gog-button-focus-ring-color: var(--gog-accent-color);
/* A pixel further out than the foundation ring, so it separates from a filled button; derived, so
it moves with the foundation. */
--gog-button-focus-ring-offset: calc(var(--gog-focus-ring-offset) + 1px);
/* Named `active` rather than `press` for compatibility: consumers already override it. */
--gog-button-active-scale: 0.97;
--gog-button-disabled-opacity: var(--gog-disabled-opacity);
--gog-button-loading-opacity: 0.7;
--gog-button-spinner-max-size: 70%;
--gog-button-primary-bg: var(--gog-accent-color);
--gog-button-primary-color: var(--gog-accent-text-color, var(--gog-primary-color));
--gog-button-primary-border: transparent;
--gog-button-primary-shadow: none;
--gog-button-primary-hover-bg: var(--gog-accent-bright);
--gog-button-primary-hover-color: var(--gog-button-primary-color);
--gog-button-primary-hover-shadow: 0 0 16px var(--gog-accent-pale);
/* The label colour, not the page text colour: a filled button is not the page. */
--gog-button-primary-spinner-color: var(--gog-button-primary-color);
--gog-button-secondary-bg: var(--gog-secondary-color);
--gog-button-secondary-color: var(--gog-accent-text-color, var(--gog-primary-color));
--gog-button-secondary-border: transparent;
--gog-button-secondary-shadow: none;
--gog-button-secondary-hover-bg: var(--gog-accent-color);
--gog-button-secondary-hover-color: var(--gog-button-secondary-color);
--gog-button-secondary-hover-shadow: none;
--gog-button-secondary-spinner-color: var(--gog-button-secondary-color);
--gog-button-outline-bg: transparent;
--gog-button-outline-color: var(--gog-accent-color);
--gog-button-outline-border: var(--gog-accent-color);
--gog-button-outline-shadow: none;
--gog-button-outline-hover-bg: var(--gog-accent-color);
/* Hovered, the button sits on the accent fill, so its label is the "text on accent" token. */
--gog-button-outline-hover-color: var(--gog-accent-text-color, var(--gog-primary-color));
--gog-button-outline-hover-shadow: none;
--gog-button-outline-spinner-color: var(--gog-accent-color);
--gog-button-ghost-bg: transparent;
--gog-button-ghost-color: var(--gog-accent-color);
--gog-button-ghost-border: transparent;
--gog-button-ghost-shadow: none;
--gog-button-ghost-hover-bg: var(--gog-hover-color);
/* The label leaves the accent on hover: ghost's label is the accent and its hover tints the ground
with the accent, so the two would converge below AA. Body text keeps the hover a subtle wash. */
--gog-button-ghost-hover-color: var(--gog-text-color);
--gog-button-ghost-hover-shadow: none;
--gog-button-ghost-spinner-color: var(--gog-accent-color);
/* The press is a colour, not only a scale: reduced motion removes the scale, and a press must still
be visible. Each variant goes one step deeper than its own hover. */
/* The toggled state (`aria-pressed="true"`) is an inset ring, not a fill: hover and press already
own the background, and a toggled button must still read as on while hovered or pressed. The
ring colour is the one guaranteed to read on each variant. */
--gog-button-toggled-ring-width: 2px;
--gog-button-primary-toggled-shadow: inset 0 0 0 var(--gog-button-toggled-ring-width)
var(--gog-accent-text-color, var(--gog-primary-color));
--gog-button-secondary-toggled-shadow: var(--gog-button-primary-toggled-shadow);
--gog-button-outline-toggled-shadow: inset 0 0 0 var(--gog-button-toggled-ring-width)
var(--gog-accent-color);
--gog-button-ghost-toggled-shadow: var(--gog-button-outline-toggled-shadow);
--gog-button-primary-press-bg: var(--gog-accent-dim);
--gog-button-primary-press-color: var(--gog-button-primary-color);
--gog-button-secondary-press-bg: var(--gog-accent-dim);
--gog-button-secondary-press-color: var(--gog-button-secondary-color);
--gog-button-outline-press-bg: var(--gog-accent-dim);
--gog-button-outline-press-color: var(--gog-button-outline-hover-color);
/* Ghost presses to a fill: its label is the accent, so an accent wash would erase it. The filled
press moves the label to the "text on accent" pair instead. */
--gog-button-ghost-press-bg: var(--gog-accent-dim);
--gog-button-ghost-press-color: var(--gog-accent-text-color, var(--gog-primary-color));
/* ── Button severity ─────────────────────────────────────────────────────────
Severity is orthogonal to variant: it re-points the ingredients the four variants are built from,
and `styles/button.css` applies them per variant.
`-fill` / `-on-fill` are the filled pair. `-ink` is the label of the transparent variants: the raw
status hue is too light as text in most themes, so it is mixed halfway toward the theme's ink —
toward `--gog-text-color` rather than black, so the same mix works on light and dark themes.
Override `--gog-button-<status>-ink` to get the raw colour back.
Hover and press step toward the ink as well, away from the label. These flat values are what a
browser without `color-mix()` renders; the mixed ones are in the @supports block at the end. */
--gog-button-success-fill: var(--gog-success-color);
--gog-button-success-on-fill: var(--gog-success-text-color);
--gog-button-success-fill-hover: var(--gog-success-color);
--gog-button-success-fill-press: var(--gog-success-color);
--gog-button-success-ink: var(--gog-success-color);
--gog-button-success-wash: transparent;
--gog-button-danger-fill: var(--gog-danger-color);
--gog-button-danger-on-fill: var(--gog-danger-text-color);
--gog-button-danger-fill-hover: var(--gog-danger-color);
--gog-button-danger-fill-press: var(--gog-danger-color);
--gog-button-danger-ink: var(--gog-danger-color);
--gog-button-danger-wash: transparent;
--gog-button-warning-fill: var(--gog-warning-color);
--gog-button-warning-on-fill: var(--gog-warning-text-color);
--gog-button-warning-fill-hover: var(--gog-warning-color);
--gog-button-warning-fill-press: var(--gog-warning-color);
--gog-button-warning-ink: var(--gog-warning-color);
--gog-button-warning-wash: transparent;
--gog-button-info-fill: var(--gog-info-color);
--gog-button-info-on-fill: var(--gog-info-text-color);
--gog-button-info-fill-hover: var(--gog-info-color);
--gog-button-info-fill-press: var(--gog-info-color);
--gog-button-info-ink: var(--gog-info-color);
--gog-button-info-wash: transparent;
/* ── Button toggle group ───────────────────────────────────────────────────
`-bg`, `-color`, `-padding` and `-font-size` are intentionally NOT declared (per-instance escape
hatch). Sizes reuse the button scale so a toggle group lines up with buttons in a toolbar. */
--gog-button-toggle-font-family: var(--gog-font-heading);
--gog-button-toggle-font-weight: var(--gog-font-weight-bold);
--gog-button-toggle-letter-spacing: 0.5px;
--gog-button-toggle-text-transform: var(--gog-text-transform);
--gog-button-toggle-line-height: var(--gog-line-height-none);
--gog-button-toggle-gap: var(--gog-space-sm);
--gog-button-toggle-icon-size: 1.1em;
--gog-button-toggle-radius: var(--gog-radius);
--gog-button-toggle-border-width: var(--gog-control-border-width);
--gog-button-toggle-border-style: var(--gog-control-border-style);
--gog-button-toggle-border-color: var(--gog-control-boundary-color);
--gog-button-toggle-rest-bg: transparent;
--gog-button-toggle-rest-color: var(--gog-text-color);
--gog-button-toggle-hover-bg: var(--gog-hover-color);
--gog-button-toggle-press-bg: var(--gog-border-color);
--gog-button-toggle-hover-color: var(--gog-text-color);
--gog-button-toggle-selected-bg: var(--gog-accent-color);
--gog-button-toggle-selected-color: var(--gog-accent-text-color, var(--gog-primary-color));
--gog-button-toggle-selected-border-color: var(--gog-accent-color);
/* A selected option is already a fill, so its press deepens like a filled button. */
--gog-button-toggle-selected-press-bg: var(--gog-accent-dim);
--gog-button-toggle-separated-gap: var(--gog-space-sm);
--gog-button-toggle-transition-duration: var(--gog-duration-base);
--gog-button-toggle-disabled-opacity: var(--gog-disabled-opacity);
--gog-button-toggle-focus-ring-width: var(--gog-focus-ring-width);
--gog-button-toggle-focus-ring-offset: var(--gog-focus-ring-offset);
--gog-button-toggle-focus-ring-color: var(--gog-accent-color);
/* ── Calendar (the month grid inside gog-datepicker, and gog-calendar on its own) ── */
--gog-calendar-font-family: var(--gog-font-body);
--gog-calendar-color: var(--gog-text-color);
/* Hugs the month grid; set `100%` to fill the container. */
--gog-calendar-max-width: max-content;
--gog-calendar-padding: var(--gog-space-12);
--gog-calendar-header-gap: var(--gog-space-4);
--gog-calendar-header-margin: var(--gog-space-8);
--gog-calendar-months-gap: var(--gog-space-16);
--gog-calendar-title-color: var(--gog-text-color);
--gog-calendar-title-font-weight: var(--gog-font-weight-bold);
--gog-calendar-nav-size: 28px;
--gog-calendar-nav-radius: calc(var(--gog-radius) - 2px);
--gog-calendar-nav-bg: transparent;
--gog-calendar-nav-color: var(--gog-muted-text-color);
--gog-calendar-nav-hover-bg: var(--gog-hover-color);
--gog-calendar-nav-hover-color: var(--gog-text-color);
--gog-calendar-nav-icon-size: 0.8rem;
/* Pulls the two chevrons of a year step together so they read as one control. */
--gog-calendar-nav-icon-overlap: -0.35em;
--gog-calendar-weekday-padding: var(--gog-space-4) 0;
--gog-calendar-weekday-color: var(--gog-muted-text-color);
--gog-calendar-weekday-font-size: var(--gog-text-xs);
--gog-calendar-weekday-line-height: var(--gog-line-height-none);
--gog-calendar-weekday-font-weight: var(--gog-font-weight-semibold);
--gog-calendar-weekday-text-transform: var(--gog-text-transform);
--gog-calendar-day-radius: calc(var(--gog-radius) - 2px);
--gog-calendar-day-border-width: var(--gog-border-width);
--gog-calendar-day-border-style: var(--gog-border-style);
--gog-calendar-day-rest-bg: transparent;
--gog-calendar-day-rest-color: var(--gog-text-color);
--gog-calendar-day-hover-bg: var(--gog-hover-color);
--gog-calendar-day-outside-color: var(--gog-muted-text-color);
--gog-calendar-today-border-color: var(--gog-accent-color);
--gog-calendar-today-font-weight: var(--gog-font-weight-bold);
--gog-calendar-selected-bg: var(--gog-accent-color);
--gog-calendar-selected-color: var(--gog-accent-text-color, var(--gog-primary-color));
--gog-calendar-selected-font-weight: var(--gog-font-weight-bold);
/* Same hue, low enough to read as a band rather than a second selection. */
--gog-calendar-range-bg: var(--gog-accent-pale);
--gog-calendar-range-color: var(--gog-text-color);
--gog-calendar-disabled-opacity: var(--gog-disabled-opacity);
--gog-calendar-transition-duration: var(--gog-duration-fast);
--gog-calendar-focus-ring-width: var(--gog-focus-ring-width);
/* Inset: cells sit edge to edge, so an outward ring would cover the neighbour. */
--gog-calendar-focus-ring-offset: calc(var(--gog-focus-ring-offset) * -1);
--gog-calendar-focus-ring-color: var(--gog-accent-color);
--gog-calendar-divider-width: 1px;
--gog-calendar-divider-style: solid;
--gog-calendar-divider-color: var(--gog-border-color);
--gog-calendar-time-gap: var(--gog-space-8);
--gog-calendar-time-margin: var(--gog-space-12);
--gog-calendar-time-input-width: 3.5rem;
--gog-calendar-time-input-padding: var(--gog-space-4) var(--gog-space-8);
--gog-calendar-time-input-bg: var(--gog-background-color);
--gog-calendar-action-padding: var(--gog-space-4) var(--gog-space-8);
--gog-calendar-footer-gap: var(--gog-space-8);
--gog-calendar-xsm-font-size: var(--gog-text-xs);
--gog-calendar-xsm-day-size: 24px;
--gog-calendar-sm-font-size: var(--gog-text-sm);
--gog-calendar-sm-day-size: 28px;
--gog-calendar-md-font-size: var(--gog-text-sm);
--gog-calendar-md-day-size: 34px;
--gog-calendar-lg-font-size: var(--gog-text-md);
--gog-calendar-lg-day-size: 40px;
--gog-calendar-slg-font-size: var(--gog-text-lg);
--gog-calendar-line-height: var(--gog-line-height-normal);
--gog-calendar-slg-day-size: 46px;
/* ── Card ──────────────────────────────────────────────────────────────────
`--gog-card-bg`, `-border-color`, `-shadow`, `-padding-y`, `-padding-x` and `-gap` are
intentionally NOT declared: the per-instance escape hatch. */
--gog-card-font-family: var(--gog-font-body);
--gog-card-color: var(--gog-text-color);
--gog-card-radius: var(--gog-radius);
--gog-card-border-width: var(--gog-panel-border-width);
--gog-card-border-style: var(--gog-panel-border-style);
--gog-card-transition-duration: var(--gog-duration-base);
--gog-card-heading-color: var(--gog-text-color);
--gog-card-heading-font-family: var(--gog-font-heading);
--gog-card-heading-font-size: var(--gog-text-lg);
--gog-card-heading-font-weight: var(--gog-font-weight-semibold);
--gog-card-heading-line-height: var(--gog-line-height-snug);
--gog-card-outlined-bg: var(--gog-surface-color);
--gog-card-outlined-border-color: var(--gog-border-color);
--gog-card-outlined-shadow: none;
--gog-card-elevated-bg: var(--gog-elevated-surface-color);
--gog-card-elevated-border-color: transparent;
/* Step 2 of the ladder, the in-flow raised surface. */
--gog-card-elevated-shadow: var(--gog-elevation-highlight), var(--gog-elevation-2);
--gog-card-filled-bg: var(--gog-accent-pale);
--gog-card-filled-border-color: transparent;
--gog-card-filled-shadow: none;
/* Hover and focus only apply to a card that holds a `gogCardLink`. */
--gog-card-hover-border-color: var(--gog-accent-dim);
--gog-card-hover-shadow: var(--gog-panel-shadow);
--gog-card-focus-ring: var(--gog-accent-color);
--gog-card-focus-ring-width: var(--gog-focus-ring-width);
--gog-card-focus-ring-offset: var(--gog-focus-ring-offset);
--gog-card-disabled-opacity: var(--gog-disabled-opacity);
--gog-card-footer-border-color: var(--gog-border-color);
--gog-card-footer-gap: var(--gog-space-sm);
--gog-card-footer-padding-top: var(--gog-space-sm);
--gog-card-xsm-padding-y: var(--gog-space-8);
--gog-card-xsm-padding-x: var(--gog-space-12);
--gog-card-xsm-gap: var(--gog-space-8);
--gog-card-sm-padding-y: var(--gog-space-12);
--gog-card-sm-padding-x: var(--gog-space-16);
--gog-card-sm-gap: var(--gog-space-sm);
--gog-card-md-padding-y: var(--gog-space-md);
--gog-card-md-padding-x: var(--gog-space-20);
--gog-card-md-gap: var(--gog-space-12);
--gog-card-lg-padding-y: var(--gog-space-20);
--gog-card-lg-padding-x: var(--gog-space-lg);
--gog-card-lg-gap: var(--gog-space-16);
--gog-card-slg-padding-y: var(--gog-space-28);
--gog-card-slg-padding-x: var(--gog-space-32);
--gog-card-slg-gap: var(--gog-space-md);
/* ── Checkbox ──────────────────────────────────────────────────────────────
Box, label and icon sizes come from the shared `--gog-control-checkbox-*` scale. */
--gog-checkbox-font-family: var(--gog-font-body);
--gog-checkbox-gap: var(--gog-space-12);
--gog-checkbox-radius: var(--gog-radius);
--gog-checkbox-border-width: var(--gog-control-border-width);
--gog-checkbox-border-style: var(--gog-control-border-style);
--gog-checkbox-border-color: var(--gog-accent-dim);
--gog-checkbox-bg: var(--gog-surface-color);
--gog-checkbox-checked-bg: var(--gog-accent-color);
--gog-checkbox-checked-border: var(--gog-accent-color);
--gog-checkbox-icon-color: var(--gog-accent-text-color, var(--gog-primary-color));
/* A glyph in its own box: the box is the glyph, not the font. */
--gog-checkbox-icon-line-height: var(--gog-line-height-none);
--gog-checkbox-label-color: var(--gog-muted-text-color);
--gog-checkbox-label-line-height: var(--gog-line-height-snug);
/* The accent, not a pale wash: this outline is the only focus indicator, and it must clear 3:1. */
--gog-checkbox-focus-ring: var(--gog-accent-color);
--gog-checkbox-focus-ring-width: var(--gog-focus-ring-width);
--gog-checkbox-focus-ring-offset: var(--gog-focus-ring-offset);
--gog-checkbox-disabled-opacity: var(--gog-disabled-opacity);
--gog-checkbox-transition-duration: var(--gog-duration-base);
--gog-checkbox-dash-width-ratio: 0.45;
--gog-checkbox-dash-height: 2px;
--gog-checkbox-dash-radius: 999px;
/* ── Radio group ───────────────────────────────────────────────────────────
Sizes reuse the `--gog-control-checkbox-*` scale. */
--gog-radio-font-family: var(--gog-font-body);
--gog-radio-group-gap: var(--gog-space-12);
--gog-radio-group-label-size: var(--gog-field-label-font-size);
--gog-radio-group-label-color: var(--gog-field-label-color);
--gog-radio-group-label-font-family: var(--gog-field-label-font-family);
--gog-radio-group-label-font-weight: var(--gog-field-label-font-weight);
--gog-radio-group-label-line-height: var(--gog-field-label-line-height);
--gog-radio-group-label-letter-spacing: var(--gog-field-label-letter-spacing);
--gog-radio-group-label-text-transform: var(--gog-field-label-text-transform);
--gog-radio-group-option-gap: var(--gog-space-8);
--gog-radio-group-option-gap-horizontal: var(--gog-space-20);
--gog-radio-gap: var(--gog-space-12);
--gog-radio-border-width: var(--gog-control-border-width);
--gog-radio-border-style: var(--gog-control-border-style);
--gog-radio-border-color: var(--gog-accent-dim);
--gog-radio-bg: var(--gog-surface-color);
--gog-radio-checked-bg: var(--gog-surface-color);
--gog-radio-checked-border: var(--gog-accent-color);
--gog-radio-dot-color: var(--gog-accent-color);
--gog-radio-dot-size-ratio: 0.45;
--gog-radio-label-color: var(--gog-muted-text-color);
--gog-radio-label-line-height: var(--gog-line-height-snug);
/* The accent, not a pale wash: this outline is the only focus indicator, and it must clear 3:1. */
--gog-radio-focus-ring: var(--gog-accent-color);
--gog-radio-focus-ring-width: var(--gog-focus-ring-width);
--gog-radio-focus-ring-offset: var(--gog-focus-ring-offset);
--gog-radio-disabled-opacity: var(--gog-disabled-opacity);
--gog-radio-transition-duration: var(--gog-duration-base);
--gog-radio-error-font-size: var(--gog-text-xs);
--gog-radio-error-line-height: var(--gog-field-error-line-height);
--gog-radio-error-color: var(--gog-danger-color);
/* ── Chip ──────────────────────────────────────────────────────────────────
The unsuffixed `--gog-chip-font-size`, `-padding-*`, `-gap`, `-avatar-size`, `-icon-size` and
`-remove-size` are left undeclared as the per-instance escape hatch. */
--gog-chip-font-family: inherit;
--gog-chip-bg: var(--gog-surface-color);
--gog-chip-hover-bg: var(--gog-hover-color);
--gog-chip-press-bg: var(--gog-border-color);
--gog-chip-border: var(--gog-control-boundary-color);
--gog-chip-border-width: var(--gog-border-width);
--gog-chip-border-style: var(--gog-border-style);
--gog-chip-color: var(--gog-text-color);
--gog-chip-font-weight: var(--gog-font-weight-medium);
--gog-chip-line-height: var(--gog-line-height-tight);
--gog-chip-radius: max(var(--gog-radius), 2px);
--gog-chip-pill-radius: 9999px;
--gog-chip-remove-color: var(--gog-muted-text-color);
--gog-chip-remove-hover-color: var(--gog-text-color);
/* The remove button's box as a multiple of its glyph: 1 is the glyph itself, anything above is
padding. */
--gog-chip-remove-scale: 1;
--gog-chip-avatar-inset-ratio: 0.9;
--gog-chip-remove-inset-ratio: 0.85;
--gog-chip-disabled-opacity: var(--gog-disabled-opacity);
/* A selected filter chip is an inset ring, not a fill, so it stays visibly selected while hovered
or pressed. */
--gog-chip-selected-ring-width: 2px;
--gog-chip-selected-shadow: inset 0 0 0 var(--gog-chip-selected-ring-width)
var(--gog-accent-color);
/* A focus colour of its own; the chip's border is too faint to mark focus. */
--gog-chip-focus-ring-color: var(--gog-accent-color);
--gog-chip-focus-ring-width: 2px;
--gog-chip-focus-ring-offset: var(--gog-focus-ring-offset);
--gog-chip-xsm-font-size: var(--gog-text-2xs);
--gog-chip-xsm-padding-block: var(--gog-space-4);
--gog-chip-xsm-padding-inline: var(--gog-space-8);
--gog-chip-xsm-gap: var(--gog-space-4);
/* Avatar, icon and remove glyph are ratios of the chip's own type, so each scales with its label
and one override carries all three. */
--gog-chip-xsm-avatar-size: 1.5em;
--gog-chip-xsm-icon-size: 1em;
--gog-chip-xsm-remove-size: 1.125em;
--gog-chip-sm-font-size: var(--gog-text-xs);
--gog-chip-sm-padding-block: var(--gog-space-4);
--gog-chip-sm-padding-inline: var(--gog-space-8);
--gog-chip-sm-gap: var(--gog-space-8);
--gog-chip-sm-avatar-size: 1.5em;
--gog-chip-sm-icon-size: 1em;
--gog-chip-sm-remove-size: 1.125em;
--gog-chip-md-font-size: var(--gog-text-sm);
--gog-chip-md-padding-block: var(--gog-space-8);
--gog-chip-md-padding-inline: var(--gog-space-16);
--gog-chip-md-gap: var(--gog-space-8);
--gog-chip-md-avatar-size: 1.5em;
--gog-chip-md-icon-size: 1em;
--gog-chip-md-remove-size: 1.125em;
--gog-chip-lg-font-size: var(--gog-text-md);
--gog-chip-lg-padding-block: var(--gog-space-12);
--gog-chip-lg-padding-inline: var(--gog-space-24);
--gog-chip-lg-gap: var(--gog-space-12);
--gog-chip-lg-avatar-size: 1.5em;
--gog-chip-lg-icon-size: 1em;
--gog-chip-lg-remove-size: 1.125em;
--gog-chip-slg-font-size: var(--gog-text-lg);
--gog-chip-slg-padding-block: var(--gog-space-12);
--gog-chip-slg-padding-inline: var(--gog-space-24);
--gog-chip-slg-gap: var(--gog-space-12);
--gog-chip-slg-avatar-size: 1.5em;
--gog-chip-slg-icon-size: 1em;
--gog-chip-slg-remove-size: 1.125em;
/* ── Dialog ────────────────────────────────────────────────────────────────── */
--gog-dialog-font-family: var(--gog-font-heading);
/* A flat value, not derived from the palette: the scrim must read the same over any page. */
--gog-dialog-backdrop-bg: rgba(10, 8, 3, 0.72);
--gog-dialog-backdrop-blur: 2px;
--gog-dialog-backdrop-padding: var(--gog-space-lg);
--gog-dialog-backdrop-fade-duration: var(--gog-duration-base);
--gog-dialog-enter-duration: var(--gog-duration-slow);
--gog-dialog-enter-distance: -12px;
--gog-dialog-bg: var(--gog-surface-color);
--gog-dialog-color: var(--gog-text-color);
--gog-dialog-border: var(--gog-border-color);
--gog-dialog-border-width: var(--gog-panel-border-width);
--gog-dialog-border-style: var(--gog-panel-border-style);
--gog-dialog-radius: var(--gog-radius);
--gog-dialog-min-width: 320px;
--gog-dialog-max-height: 90vh;
--gog-dialog-header-padding: var(--gog-space-16) var(--gog-space-20) var(--gog-space-16);
--gog-dialog-header-gap: var(--gog-space-12);
--gog-dialog-header-border-color: var(--gog-border-color);
/* Stated explicitly so the dialog title does not inherit the browser's default heading size. */
--gog-dialog-title-font-size: var(--gog-text-xl);
--gog-dialog-title-line-height: var(--gog-line-height-snug);
--gog-dialog-body-padding: var(--gog-space-20);
--gog-dialog-body-max-height: calc(var(--gog-dialog-max-height) - 60px);
--gog-dialog-close-size: 2rem;
--gog-dialog-close-font-size: var(--gog-text-sm);
--gog-dialog-close-line-height: var(--gog-line-height-none);
--gog-dialog-close-color: var(--gog-muted-text-color);
--gog-dialog-close-hover-color: var(--gog-text-color);
--gog-dialog-close-hover-bg: var(--gog-hover-color);
--gog-dialog-close-hover-border: var(--gog-border-color);
--gog-dialog-close-focus-ring: var(--gog-accent-color);
--gog-dialog-close-focus-ring-width: var(--gog-focus-ring-width);
--gog-dialog-close-focus-ring-offset: var(--gog-focus-ring-offset);
/* Confirmation dialog */
--gog-confirmation-dialog-gap: var(--gog-space-12);
--gog-confirmation-dialog-min-width: 320px;
--gog-confirmation-dialog-title-font-size: var(--gog-text-lg);
--gog-confirmation-dialog-title-line-height: var(--gog-line-height-snug);
--gog-confirmation-dialog-description-font-size: var(--gog-text-sm);
--gog-confirmation-dialog-description-line-height: var(--gog-line-height-relaxed);
/* The description wraps, so its cap is a measure in `ch`. No viewport clamp: the dialog panel
around it is already capped to the viewport, so a second clamp could never apply. */
--gog-confirmation-dialog-max-width: 51ch;
--gog-confirmation-dialog-color: var(--gog-text-color);
--gog-confirmation-dialog-description-color: var(--gog-muted-text-color);
--gog-confirmation-dialog-actions-gap: var(--gog-space-sm);
--gog-confirmation-dialog-actions-offset: var(--gog-space-sm);
/* ── Autocomplete ──────────────────────────────────────────────────────────
Sizes reuse the shared `--gog-field-<size>-*` scale so it lines up with the other fields.
`-bg`, `-color`, `-font-size`, `-padding-x` and `-padding-y` are intentionally NOT declared
(per-instance escape hatch). */
--gog-autocomplete-font-family: var(--gog-font-body);
--gog-autocomplete-label-font-family: var(--gog-field-label-font-family);
--gog-autocomplete-gap: var(--gog-space-4);
--gog-autocomplete-label-color: var(--gog-field-label-color);
--gog-autocomplete-label-font-size: var(--gog-field-label-font-size);
--gog-autocomplete-label-line-height: var(--gog-field-label-line-height);
--gog-autocomplete-label-font-weight: var(--gog-field-label-font-weight);
--gog-autocomplete-label-letter-spacing: var(--gog-field-label-letter-spacing);
--gog-autocomplete-label-text-transform: var(--gog-field-label-text-transform);
--gog-autocomplete-field-bg: var(--gog-surface-color);
--gog-autocomplete-text-color: var(--gog-text-color);
--gog-autocomplete-placeholder-color: var(--gog-muted-text-color);
--gog-autocomplete-border-width: var(--gog-control-border-width);
--gog-autocomplete-border-style: var(--gog-control-border-style);
--gog-autocomplete-border-color: var(--gog-accent-dim);
--gog-autocomplete-hover-border-color: var(--gog-accent-color);
--gog-autocomplete-radius: var(--gog-radius);
--gog-autocomplete-line-height: var(--gog-line-height-normal);
--gog-autocomplete-transition-duration: var(--gog-duration-base);
--gog-autocomplete-disabled-opacity: var(--gog-disabled-opacity);
--gog-autocomplete-focus-ring-width: var(--gog-focus-ring-width);
--gog-autocomplete-focus-ring-offset: var(--gog-focus-ring-offset);
--gog-autocomplete-focus-ring-color: var(--gog-accent-color);
--gog-autocomplete-error-color: var(--gog-danger-color);
--gog-autocomplete-error-border-color: var(--gog-danger-color);
--gog-autocomplete-error-font-family: var(--gog-font-body);
--gog-autocomplete-error-font-size: var(--gog-text-xs);
--gog-autocomplete-error-line-height: var(--gog-field-error-line-height);
/* Floor for an auto-width field, so it cannot collapse to its chrome. */
--gog-autocomplete-min-width: 120px;
/* Clear outermost, the same order every dropdown uses, so fields line up in a form. */
--gog-autocomplete-actions-inset: var(--gog-control-icon-offset);
--gog-autocomplete-actions-gap: var(--gog-space-8);
/* Room on the input for the trailing actions. */
--gog-autocomplete-actions-reserve: 40px;
--gog-autocomplete-clear-color: var(--gog-autocomplete-placeholder-color);
--gog-autocomplete-clear-hover-color: var(--gog-autocomplete-label-color);
--gog-autocomplete-clear-icon-ratio: var(--gog-control-clear-icon-ratio);
--gog-autocomplete-spinner-size: 0.875rem;
/* Panel */
--gog-autocomplete-panel-bg: var(--gog-surface-color);
--gog-autocomplete-panel-shadow: var(--gog-panel-shadow);
--gog-autocomplete-panel-border-width: var(--gog-panel-border-width);
--gog-autocomplete-panel-border-style: var(--gog-panel-border-style);
--gog-autocomplete-panel-border-color: var(--gog-border-color);
--gog-autocomplete-panel-radius: var(--gog-radius);
--gog-autocomplete-panel-gap: var(--gog-space-4);
--gog-autocomplete-panel-max-height: 260px;
/* Ceiling for a content-sized panel, so one long option cannot span the viewport. */
--gog-autocomplete-panel-max-width: 420px;
--gog-autocomplete-options-padding: var(--gog-space-4);
--gog-autocomplete-option-padding: var(--gog-space-8) var(--gog-space-16);
/* Concentric with the panel: its radius minus the list padding. Derived so it stays correct when
density changes the padding. */
--gog-autocomplete-option-radius: max(
0px,
calc(var(--gog-autocomplete-panel-radius) - var(--gog-autocomplete-options-padding))
);
/* The gap inside a row (icon to label), not between rows. */
--gog-autocomplete-option-gap: var(--gog-space-12);
--gog-autocomplete-option-color: var(--gog-text-color);
--gog-autocomplete-option-hover-bg: var(--gog-hover-color);
--gog-autocomplete-option-press-bg: var(--gog-border-color);
--gog-autocomplete-option-hover-color: var(--gog-text-color);
--gog-autocomplete-option-selected-bg: var(--gog-accent-pale);
/* Body text, not the accent: the selected row also carries a tint, and the accent on that tint
falls below AA. */
--gog-autocomplete-option-selected-color: var(--gog-text-color);
/* A starting estimate for the up/down placement. The component measures a real row after the
panel first renders and corrects itself; this only affects that first frame. */
--gog-autocomplete-option-height: 36px;
--gog-autocomplete-empty-color: var(--gog-autocomplete-placeholder-color);
--gog-autocomplete-empty-font-size: var(--gog-text-sm);
--gog-autocomplete-empty-line-height: var(--gog-line-height-normal);
--gog-autocomplete-float-label-reserve: var(--gog-field-float-label-reserve);
--gog-autocomplete-float-label-in-top: var(--gog-field-float-label-in-top);
--gog-autocomplete-float-label-over-gap: var(--gog-field-float-label-over-gap);
--gog-autocomplete-float-label-over-reserve: var(--gog-field-float-label-over-reserve);
/* ── Badge (the `gogBadge` directive; its classes live in utilities.css) ───── */
--gog-badge-font-family: var(--gog-font-body);
--gog-badge-font-size: var(--gog-text-xs);
--gog-badge-font-weight: var(--gog-font-weight-semibold);
--gog-badge-line-height: var(--gog-line-height-none);
/* Min-width and height: one digit stays a circle, more digits grow sideways. */
--gog-badge-size: 1.25rem;
--gog-badge-dot-size: 0.5rem;
--gog-badge-padding-inline: var(--gog-space-4);
--gog-badge-radius: 999px;
/* How far the badge hangs outside the host corner; enough to clear the default corner radius. */
--gog-badge-offset: var(--gog-space-8);
/* How far in from the host's box corner the badge anchors. 0 for a box; a round `gog-avatar`
sets it on itself to where its circle crosses the diagonal. */
--gog-badge-host-inset: 0px;
--gog-badge-dot-offset: var(--gog-badge-offset);
--gog-badge-border-width: 0;
--gog-badge-border-style: var(--gog-border-style);
--gog-badge-border-color: transparent;
/* Above the host's chrome, below any overlay panel. */
/* Each label is its own status's "text on this fill" token: one colour does not read on every
status fill. */
--gog-badge-success-bg: var(--gog-success-color);
--gog-badge-success-color: var(--gog-success-text-color);
--gog-badge-danger-bg: var(--gog-danger-color);
--gog-badge-danger-color: var(--gog-danger-text-color);
--gog-badge-warning-bg: var(--gog-warning-color);
--gog-badge-warning-color: var(--gog-warning-text-color);
--gog-badge-info-bg: var(--gog-info-color);
--gog-badge-info-color: var(--gog-info-text-color);
/* ── Datepicker (the field; the grid inside it is themed by --gog-calendar-*) ───
`-bg`, `-color`, `-font-size`, `-padding-x` and `-padding-y` are intentionally NOT declared
(per-instance escape hatch). */
--gog-datepicker-font-family: var(--gog-font-body);
--gog-datepicker-label-font-family: var(--gog-field-label-font-family);
--gog-datepicker-gap: var(--gog-space-4);
--gog-datepicker-label-color: var(--gog-field-label-color);
--gog-datepicker-label-font-size: var(--gog-field-label-font-size);
--gog-datepicker-label-line-height: var(--gog-field-label-line-height);
--gog-datepicker-label-font-weight: var(--gog-field-label-font-weight);
--gog-datepicker-label-letter-spacing: var(--gog-field-label-letter-spacing);
--gog-datepicker-label-text-transform: var(--gog-field-label-text-transform);
--gog-datepicker-field-bg: var(--gog-surface-color);
--gog-datepicker-text-color: var(--gog-text-color);
--gog-datepicker-placeholder-color: var(--gog-muted-text-color);
--gog-datepicker-border-width: var(--gog-control-border-width);
--gog-datepicker-border-style: var(--gog-control-border-style);
--gog-datepicker-border-color: var(--gog-accent-dim);
--gog-datepicker-hover-border-color: var(--gog-accent-color);
--gog-datepicker-radius: var(--gog-radius);
--gog-datepicker-line-height: var(--gog-line-height-normal);
--gog-datepicker-transition-duration: var(--gog-duration-base);
--gog-datepicker-disabled-opacity: var(--gog-disabled-opacity);
--gog-datepicker-focus-ring-width: var(--gog-focus-ring-width);
--gog-datepicker-focus-ring-offset: var(--gog-focus-ring-offset);
--gog-datepicker-focus-ring-color: var(--gog-accent-color);
--gog-datepicker-error-color: var(--gog-danger-color);
--gog-datepicker-error-border-color: var(--gog-danger-color);
--gog-datepicker-error-font-family: var(--gog-font-body);
--gog-datepicker-error-font-size: var(--gog-text-xs);
--gog-datepicker-error-line-height: var(--gog-field-error-line-height);
--gog-datepicker-min-width: 150px;
--gog-datepicker-actions-inset: var(--gog-control-icon-offset);
--gog-datepicker-actions-gap: var(--gog-space-8);
/* Room on the input for the calendar and clear buttons. */
--gog-datepicker-actions-reserve: 40px;
--gog-datepicker-icon-color: var(--gog-accent-color);
--gog-datepicker-icon-hover-color: var(--gog-accent-bright);
--gog-datepicker-toggle-icon-size: 1rem;
--gog-datepicker-clear-color: var(--gog-datepicker-placeholder-color);
--gog-datepicker-clear-icon-ratio: var(--gog-control-clear-icon-ratio);
--gog-datepicker-panel-bg: var(--gog-surface-color);
--gog-datepicker-panel-shadow: var(--gog-panel-shadow);
--gog-datepicker-panel-border-width: var(--gog-panel-border-width);
--gog-datepicker-panel-border-style: var(--gog-panel-border-style);
--gog-datepicker-panel-border-color: var(--gog-border-color);
--gog-datepicker-panel-radius: var(--gog-radius);
--gog-datepicker-panel-gap: var(--gog-space-4);
/* The dropdown panel. Inline mode is `gog-calendar` itself and sizes from `--gog-calendar-max-width`. */
--gog-datepicker-panel-width: max-content;
--gog-datepicker-float-label-reserve: var(--gog-field-float-label-reserve);
--gog-datepicker-float-label-in-top: var(--gog-field-float-label-in-top);
--gog-datepicker-float-label-over-gap: var(--gog-field-float-label-over-gap);
--gog-datepicker-float-label-over-reserve: var(--gog-field-float-label-over-reserve);
/* ── Divider ───────────────────────────────────────────────────────────────── */
--gog-divider-line-color: var(--gog-border-color);
--gog-divider-line-thickness: 1px;
/* Variant classes map onto these, so a theme decides what "dashed" looks like. */
--gog-divider-solid-style: solid;
--gog-divider-dashed-style: dashed;
--gog-divider-dotted-style: dotted;
--gog-divider-block-spacing: var(--gog-space-md);
--gog-divider-inline-spacing: var(--gog-space-md);
--gog-divider-inset-size: var(--gog-space-lg);
/* Length of a vertical divider with nothing to stretch to; in a flex or grid row it stretches. */
--gog-divider-vertical-length: 1.5em;
--gog-divider-label-gap: var(--gog-space-sm);
--gog-divider-label-color: var(--gog-muted-text-color);
--gog-divider-label-font-family: var(--gog-font-body);
--gog-divider-label-font-size: var(--gog-text-sm);
--gog-divider-label-font-weight: var(--gog-font-weight-medium);
--gog-divider-label-line-height: var(--gog-line-height-normal);
/* ── Icon ──────────────────────────────────────────────────────────────────── */
--gog-icon-fallback-size: 1em;
/* ── Input field ───────────────────────────────────────────────────────────── */
--gog-input-font-family: var(--gog-font-body);
--gog-input-label-font-family: var(--gog-field-label-font-family);
--gog-input-gap: var(--gog-space-4);
--gog-input-label-color: var(--gog-field-label-color);
--gog-input-label-font-size: var(--gog-field-label-font-size);
--gog-input-label-line-height: var(--gog-field-label-line-height);
--gog-input-label-font-weight: var(--gog-field-label-font-weight);
--gog-input-label-letter-spacing: var(--gog-field-label-letter-spacing);
--gog-input-label-text-transform: var(--gog-field-label-text-transform);
--gog-input-field-bg: var(--gog-surface-color);
--gog-input-field-border: var(--gog-accent-dim);
--gog-input-field-border-width: var(--gog-control-border-width);
--gog-input-field-border-style: var(--gog-control-border-style);
--gog-input-radius: var(--gog-radius);
--gog-input-field-color: var(--gog-text-color);
--gog-input-placeholder-color: var(--gog-muted-text-color);
--gog-input-focus-border: var(--gog-accent-color);
--gog-input-focus-ring: var(--gog-accent-pale);
--gog-input-focus-glow: 0 0 8px var(--gog-input-focus-ring);
--gog-input-focus-ring-width: var(--gog-focus-ring-width);
--gog-input-focus-ring-offset: var(--gog-focus-ring-offset);
--gog-input-error-color: var(--gog-danger-color);
--gog-input-error-font-size: var(--gog-text-xs);
--gog-input-error-line-height: var(--gog-field-error-line-height);
/* Extra space above the error line, on top of the field's own gap. Zero so every field spaces its
error the same way. */
--gog-input-error-offset: 0px;
--gog-input-icon-color: var(--gog-muted-text-color);
--gog-input-icon-line-height: var(--gog-line-height-none);
--gog-input-icon-hover-color: var(--gog-accent-color);
--gog-input-icon-action-radius: calc(var(--gog-radius) - 4px);
--gog-input-icon-focus-ring-width: 2px;
/* The spin buttons sit flush against the border, so hover is a fill rather than a ring. */
--gog-input-spin-hover-bg: var(--gog-hover-color);
--gog-input-disabled-opacity: var(--gog-disabled-opacity);
--gog-input-transition-duration: var(--gog-duration-base);
/* Float label — also used by gog-textarea, which shares the --gog-input-* block. */
/* Clear button, rendered once the field has text. Its radius is a quarter of the corner radius,
so a theme that rounds its corners rounds this too. */
--gog-input-clear-radius: calc(var(--gog-radius) / 4);
--gog-input-clear-line-height: var(--gog-line-height-none);
--gog-input-clear-icon-ratio: var(--gog-control-clear-icon-ratio);
/* A full-size glyph: 0.7 suits a dense dropdown trigger and reads as a speck on a
multi-line box. */
--gog-textarea-clear-icon-ratio: 1;
/* The only place the library renders prose the user typed. */
--gog-textarea-line-height: var(--gog-line-height-relaxed);
/* A custom grip replaces the native one, which cannot be restyled reliably. It follows the field
border so it reads as part of the field. */
--gog-textarea-resize-grip-size: 11px;
--gog-textarea-resize-grip-color: var(--gog-input-field-border);
--gog-textarea-resize-grip-opacity: 0.8;
--gog-textarea-resize-grip-stripe-width: 1.5px;
/* Inside one painted mark, so off the 4px grid on purpose: at 4px the grip becomes a block. */
--gog-textarea-resize-grip-stripe-gap: 2px;
--gog-textarea-resize-grip-offset: var(--gog-space-4);
/* Written per instance as inline styles by the component's ResizeObserver, to follow a
field dragged smaller than its container. Declared here so the resting value is visible. */
--gog-textarea-resize-inset-right: 0px;
--gog-textarea-resize-inset-bottom: 0px;
--gog-input-clear-inset: var(--gog-space-8);
/* One stepper button's width, scaled to the field's font size. A token because two places
read it: the buttons, and the clear button's offset on a clearable number field. */
--gog-input-spin-width: calc(
var(--gog-input-size-font-size, var(--gog-field-md-font-size)) * 1.35
);
--gog-input-float-label-reserve: var(--gog-field-float-label-reserve);
--gog-input-float-label-in-top: var(--gog-field-float-label-in-top);
--gog-input-float-label-over-gap: var(--gog-field-float-label-over-gap);
--gog-input-float-label-over-reserve: var(--gog-field-float-label-over-reserve);
/* ── Multiselect ───────────────────────────────────────────────────────────── */
--gog-multiselect-font-family: var(--gog-font-body);
--gog-multiselect-label-font-family: var(--gog-field-label-font-family);
--gog-multiselect-gap: var(--gog-space-4);
/* The gap between rows (inside a row is `-option-gap-inline`). */
--gog-multiselect-option-gap: var(--gog-space-4);
--gog-multiselect-options-padding: var(--gog-space-4);
--gog-multiselect-label-color: var(--gog-field-label-color);
--gog-multiselect-label-font-size: var(--gog-field-label-font-size);
--gog-multiselect-label-line-height: var(--gog-field-label-line-height);
--gog-multiselect-label-font-weight: var(--gog-field-label-font-weight);
--gog-multiselect-label-letter-spacing: var(--gog-field-label-letter-spacing);
--gog-multiselect-label-text-transform: var(--gog-field-label-text-transform);
--gog-multiselect-field-bg: var(--gog-surface-color);
--gog-multiselect-field-border: var(--gog-accent-dim);
--gog-multiselect-field-border-width: var(--gog-control-border-width);
--gog-multiselect-field-border-style: var(--gog-control-border-style);
--gog-multiselect-radius: var(--gog-radius);
--gog-multiselect-field-color: var(--gog-text-color);
--gog-multiselect-value-color: var(--gog-text-color);
--gog-multiselect-placeholder-color: var(--gog-muted-text-color);
--gog-multiselect-focus-border: var(--gog-accent-color);
/* The accent, not a pale wash: this outline is the only focus indicator, and it must clear 3:1. */
--gog-multiselect-focus-ring: var(--gog-accent-color);
--gog-multiselect-focus-glow: 0 0 8px var(--gog-multiselect-focus-ring);
--gog-multiselect-focus-ring-width: var(--gog-focus-ring-width);
--gog-multiselect-focus-ring-offset: var(--gog-focus-ring-offset);
--gog-multiselect-error-color: var(--gog-danger-color);
--gog-multiselect-error-font-size: var(--gog-text-xs);
--gog-multiselect-error-line-height: var(--gog-field-error-line-height);
/* Zero, like every field — see `--gog-input-error-offset`. */
--gog-multiselect-error-offset: 0px;
--gog-multiselect-border-color: var(--gog-accent-color);
--gog-multiselect-panel-bg: var(--gog-surface-color);
--gog-multiselect-panel-border: var(--gog-accent-color);
--gog-multiselect-panel-shadow: var(--gog-panel-shadow);
/* The panel's own corner, separate from `--gog-multiselect-radius` so a pill-shaped field does not
turn the dropdown into a pill. */
--gog-multiselect-panel-radius: var(--gog-radius);
--gog-multiselect-panel-max-height: 260px;
--gog-multiselect-panel-gap: var(--gog-space-4);
--gog-multiselect-option-hover-bg: var(--gog-hover-color);
--gog-multiselect-option-press-bg: var(--gog-border-color);
--gog-multiselect-option-color: var(--gog-text-color);
--gog-multiselect-option-gap-inline: var(--gog-space-12);
/* A starting estimate for the up/down placement. The component measures a real row after the
panel first renders and corrects itself; this only affects that first frame. */
--gog-multiselect-option-height: 40px;
/* Concentric with the panel: its radius minus the list padding, derived so it survives density changes. */
--gog-multiselect-option-radius: max(
0px,
calc(var(--gog-multiselect-panel-radius) - var(--gog-multiselect-options-padding))
);
--gog-multiselect-option-disabled-opacity: var(--gog-disabled-opacity);
--gog-multiselect-option-transition-duration: var(--gog-duration-fast);
--gog-multiselect-checkbox-border: var(--gog-accent-dim);
--gog-multiselect-checkbox-checked-bg: var(--gog-accent-color);
--gog-multiselect-controls-gap: var(--gog-space-4);
--gog-multiselect-controls-padding: var(--gog-space-8) var(--gog-space-12);
--gog-multiselect-actions-gap: var(--gog-space-8);
--gog-multiselect-filter-padding: var(--gog-space-8);
--gog-multiselect-filter-input-padding-y: var(--gog-space-8);
--gog-multiselect-filter-input-padding-x: var(--gog-space-16);
--gog-multiselect-filter-input-bg: var(--gog-background-color);
--gog-multiselect-filter-input-color: var(--gog-multiselect-field-color);
--gog-multiselect-filter-input-border: var(--gog-multiselect-field-border);
/* Square is the concentric answer: the filter is inset by exactly the panel's radius, so a right
angle keeps the gap to the curve constant. */
--gog-multiselect-filter-input-radius: max(
0px,
calc(var(--gog-multiselect-panel-radius) - var(--gog-multiselect-filter-padding))
);
--gog-multiselect-filter-border-width: var(--gog-panel-border-width);
--gog-multiselect-filter-border-style: var(--gog-panel-border-style);
--gog-multiselect-filter-border-color: var(--gog-border-color);
--gog-multiselect-filter-empty-padding: var(--gog-space-12);
--gog-multiselect-filter-empty-color: var(--gog-multiselect-placeholder-color);
/* Matches --gog-select-chevron-inset. */
/* "+N" summary when the selection does not fit on one line. */
--gog-multiselect-overflow-color: var(--gog-multiselect-placeholder-color);
--gog-multiselect-overflow-font-size: var(--gog-text-sm);
/* Sits on the value's baseline, so it takes the field text leading. */
--gog-multiselect-overflow-line-height: var(--gog-field-line-height);
--gog-multiselect-overflow-gap: var(--gog-space-8);
--gog-multiselect-min-width: 120px;
--gog-multiselect-panel-max-width: 420px;
--gog-multiselect-actions-inset: var(--gog-control-icon-offset);
/* A quarter of the corner radius, like the input's clear button. */
--gog-multiselect-clear-radius: calc(var(--gog-radius) / 4);
--gog-multiselect-clear-line-height: var(--gog-line-height-none);
--gog-multiselect-disabled-opacity: var(--gog-disabled-opacity);
--gog-multiselect-transition-duration: var(--gog-duration-base);
--gog-multiselect-float-label-reserve: var(--gog-field-float-label-reserve);
--gog-multiselect-float-label-in-top: var(--gog-field-float-label-in-top);
--gog-multiselect-float-label-over-gap: var(--gog-field-float-label-over-gap);
--gog-multiselect-float-label-over-reserve: var(--gog-field-float-label-over-reserve);
--gog-multiselect-arrow-transition-duration: var(--gog-duration-slow);
/* Icon geometry as ratios of the control's font size. */
--gog-multiselect-clear-icon-ratio: var(--gog-control-clear-icon-ratio);
--gog-multiselect-arrow-icon-ratio: 0.875;
--gog-multiselect-mark-size-ratio: 1.2375;
--gog-multiselect-mark-icon-ratio: 1.125;
/* ── Menu ──────────────────────────────────────────────────────────────────
The menu opened by `[gogMenuTrigger]`. Metrics follow the dropdown panel's, so a menu and a
select from the same toolbar read as one surface. */
--gog-menu-z: var(--gog-dropdown-z);
--gog-menu-bg: var(--gog-surface-color);
--gog-menu-border-color: var(--gog-border-color);
--gog-menu-border-width: var(--gog-control-border-width);
--gog-menu-border-style: var(--gog-control-border-style);
--gog-menu-radius: var(--gog-panel-radius);
/* Step 3, with the dropdown panels it sits beside. */
--gog-menu-shadow: var(--gog-panel-shadow);
--gog-menu-font-family: var(--gog-font-body);
--gog-menu-padding: var(--gog-space-4);
--gog-menu-gap: var(--gog-space-4);
/* Read by `menu.component.ts` for positioning, not by CSS. */
--gog-menu-panel-gap: var(--gog-space-4);
--gog-menu-min-width: 180px;
/* Viewport-clamped because the menu portals to <body>. Items do not wrap, so the cap stays in px. */
--gog-menu-max-width: min(320px, calc(100vw - var(--gog-space-16) * 2));
--gog-menu-max-height: 320px;
--gog-menu-transition-duration: var(--gog-duration-base);
--gog-menu-focus-ring: var(--gog-accent-color);
--gog-menu-focus-ring-width: var(--gog-focus-ring-width);
--gog-menu-item-color: var(--gog-text-color);
--gog-menu-item-hover-bg: var(--gog-hover-color);
/* One step past the item's hover, as a colour so reduced motion keeps it. The tinted value is in
the @supports block at the end. */
--gog-menu-item-press-bg: var(--gog-border-color);
--gog-menu-item-hover-color: var(--gog-text-color);
--gog-menu-item-font-size: var(--gog-text-sm);
--gog-menu-item-padding: var(--gog-space-8) var(--gog-space-16);
/* Concentric with the panel: its radius minus the menu padding. */
--gog-menu-item-radius: max(0px, calc(var(--gog-menu-radius) - var(--gog-menu-padding)));
--gog-menu-item-gap: var(--gog-space-sm);
--gog-menu-item-disabled-opacity: var(--gog-disabled-opacity);
--gog-menu-item-disabled-color: var(--gog-muted-text-color);
--gog-menu-item-line-height: var(--gog-line-height-normal);
--gog-menu-item-icon-size: 1em;
/* ── Paginator ─────────────────────────────────────────────────────────────── */
--gog-paginator-gap: var(--gog-space-4);
--gog-paginator-ellipsis-color: var(--gog-muted-text-color);
--gog-paginator-ellipsis-font-size: var(--gog-text-sm);
--gog-paginator-ellipsis-line-height: var(--gog-line-height-none);
--gog-paginator-ellipsis-font-family: var(--gog-font-body);
/* Fits a three-digit page size and the chevron, so the row does not shift. */
--gog-paginator-page-size-min-width: 5rem;
--gog-paginator-ellipsis-min-width: 32px;
/* ── Panel ─────────────────────────────────────────────────────────────────
`gog-panel` shares the `--gog-panel-*` prefix with the foundation surface tier deliberately: a
panel is that surface, so a theme's house radius for raised surfaces applies here too.
`--gog-panel-bg`, `-border-color`, `-padding-y`, `-padding-x` and `-gap` are intentionally NOT
declared (per-instance escape hatch). The elevated variant reads `--gog-panel-shadow` from its
own host, so setting that on one panel already affects only that panel. */
--gog-panel-font-family: var(--gog-font-body);
--gog-panel-color: var(--gog-text-color);
--gog-panel-transition-duration: var(--gog-duration-base);
--gog-panel-heading-color: var(--gog-text-color);
--gog-panel-heading-font-family: var(--gog-font-heading);
--gog-panel-heading-font-size: var(--gog-text-xl);
--gog-panel-heading-font-weight: var(--gog-font-weight-semibold);
/* The heading role, the same step as the card heading. */
--gog-panel-heading-line-height: var(--gog-line-height-snug);
--gog-panel-outlined-bg: var(--gog-surface-color);
--gog-panel-outlined-border-color: var(--gog-border-color);
--gog-panel-outlined-shadow: none;
--gog-panel-elevated-bg: var(--gog-elevated-surface-color);
--gog-panel-elevated-border-color: transparent;
--gog-panel-filled-bg: var(--gog-accent-pale);
--gog-panel-filled-border-color: transparent;
--gog-panel-filled-shadow: none;
--gog-panel-header-gap: var(--gog-space-sm);
--gog-panel-toggle-size: 2rem;
--gog-panel-toggle-radius: var(--gog-radius);
--gog-panel-toggle-color: var(--gog-muted-text-color);
--gog-panel-toggle-hover-bg: var(--gog-hover-color);
--gog-panel-chevron-size: 1rem;
--gog-panel-focus-ring: var(--gog-accent-color);
--gog-panel-focus-ring-width: var(--gog-focus-ring-width);
--gog-panel-focus-ring-offset: var(--gog-focus-ring-offset);
--gog-panel-disabled-opacity: var(--gog-disabled-opacity);
--gog-panel-footer-border-color: var(--gog-border-color);
--gog-panel-footer-gap: var(--gog-space-sm);
--gog-panel-footer-padding-top: var(--gog-space-sm);
--gog-panel-xsm-padding-y: var(--gog-space-12);
--gog-panel-xsm-padding-x: var(--gog-space-12);
--gog-panel-xsm-gap: var(--gog-space-sm);
--gog-panel-sm-padding-y: var(--gog-space-16);
--gog-panel-sm-padding-x: var(--gog-space-md);
--gog-panel-sm-gap: var(--gog-space-12);
--gog-panel-md-padding-y: var(--gog-space-20);
--gog-panel-md-padding-x: var(--gog-space-20);
--gog-panel-md-gap: var(--gog-space-12);
--gog-panel-lg-padding-y: var(--gog-space-lg);
--gog-panel-lg-padding-x: var(--gog-space-28);
--gog-panel-lg-gap: var(--gog-space-md);
--gog-panel-slg-padding-y: var(--gog-space-32);
--gog-panel-slg-padding-x: var(--gog-space-32);
--gog-panel-slg-gap: var(--gog-space-20);
/* ── Progressbar ──────────────────────────────────────────────────────────── */
--gog-progressbar-track-base-bg: var(--gog-border-color);
--gog-progressbar-radius: 999px;
--gog-progressbar-transition-duration: var(--gog-duration-slow);
--gog-progressbar-xsm-height: 2px;
--gog-progressbar-sm-height: 4px;
--gog-progressbar-md-height: 6px;
--gog-progressbar-lg-height: 10px;
--gog-progressbar-slg-height: 14px;
--gog-progressbar-value-gap: var(--gog-space-sm);
--gog-progressbar-value-min-width: 3ch;
--gog-progressbar-value-color: var(--gog-muted-text-color);
--gog-progressbar-value-font-family: var(--gog-font-body);
--gog-progressbar-value-font-size: var(--gog-text-sm);
--gog-progressbar-value-line-height: var(--gog-line-height-none);
--gog-progressbar-indeterminate-duration: 1.6s;
--gog-progressbar-indeterminate-easing: cubic-bezier(0.65, 0.05, 0.36, 1);
/* Stands in for the indeterminate animation under reduced motion. */
--gog-progressbar-stripe-size: 6px;
--gog-progressbar-stripe-color: var(--gog-surface-color);
/* Two hairlines that mark where the fill ends, off by default (width 0). On, they make that
boundary clear 3:1 in every theme, which the fill and track colours alone do not — but a light
line on a dark fill reads as an outline, not as the value. Set the width to 1px to opt in. */
--gog-progressbar-edge-width: 0px;
--gog-progressbar-edge-color: var(--gog-text-color);
--gog-progressbar-edge-backing-color: var(--gog-surface-color);
/* Same hue at low opacity, so the buffer reads as ahead of the fill, not as a second colour. */
--gog-progressbar-accent-bg: var(--gog-accent-color);
--gog-progressbar-accent-buffer-bg: var(--gog-accent-pale);
--gog-progressbar-success-bg: var(--gog-success-color);
--gog-progressbar-success-buffer-bg: var(--gog-border-color);
--gog-progressbar-danger-bg: var(--gog-danger-color);
--gog-progressbar-danger-buffer-bg: var(--gog-border-color);
--gog-progressbar-warning-bg: var(--gog-warning-color);
--gog-progressbar-warning-buffer-bg: var(--gog-border-color);
--gog-progressbar-info-bg: var(--gog-info-color);
--gog-progressbar-info-buffer-bg: var(--gog-border-color);
/* ── Ripple (the `gogRipple` directive; its classes live in ripple.css) ────
`currentColor`, so the wash matches the host's foreground on any variant. The property inherits,
so setting it above a host is the per-instance override. */
--gog-ripple-color: currentColor;
--gog-ripple-opacity: 0.16;
/* Longer than other motion on purpose: a ripple as fast as the house duration is over before the
eye follows it. Still derived, so zeroed durations flatten it. */
--gog-ripple-enter-duration: calc(var(--gog-duration-slow) * 2);
--gog-ripple-exit-duration: var(--gog-duration-slow);
--gog-ripple-easing: var(--gog-easing);
/* ── Scroll ────────────────────────────────────────────────────────────────── */
--gog-scroll-track-bg: transparent;
--gog-scroll-track-radius: var(--gog-radius);
--gog-scroll-thumb-bg: var(--gog-accent-dim);
--gog-scroll-thumb-hover-bg: var(--gog-accent-color);
--gog-scroll-thumb-active-bg: var(--gog-accent-bright);
/* Concentric with the track: its radius minus the thumb inset. */
--gog-scroll-thumb-radius: max(
0px,
calc(var(--gog-scroll-track-radius) - var(--gog-scroll-thumb-inset))
);
/* Inside one painted mark, so off the 4px grid on purpose: 4px would leave the thumb barely wider
than a hairline. */
--gog-scroll-thumb-inset: 2px;
--gog-scroll-corner-bg: transparent;
/* Where the vertical track starts. Content that pins a header over the viewport's top sets it to
that header's height, so the thumb never runs over the header; `gog-table` does this itself. */
--gog-scroll-track-start: 0px;
--gog-scroll-fade-duration: var(--gog-duration-base);
--gog-scroll-focus-ring: var(--gog-accent-color);
--gog-scroll-focus-ring-width: var(--gog-focus-ring-width);
/* The two scroll sizes the `.gog-scroll--thin` modifier switches between. */
--gog-scroll-normal-track-width: 10px;
--gog-scroll-thin-track-width: 6px;
--gog-scroll-normal-thumb-min-size: 32px;
--gog-scroll-thin-thumb-min-size: 24px;
/* Invisible hit padding around the thumb, bringing the pointer target to roughly 24px. */
--gog-scroll-normal-thumb-hit-padding: var(--gog-space-8);
--gog-scroll-thin-thumb-hit-padding: var(--gog-space-8);
/* ── Select ────────────────────────────────────────────────────────────────── */
--gog-select-font-family: var(--gog-font-body);
--gog-select-label-font-family: var(--gog-field-label-font-family);
--gog-select-gap: var(--gog-space-4);
--gog-select-label-color: var(--gog-field-label-color);
--gog-select-label-font-size: var(--gog-field-label-font-size);
--gog-select-label-line-height: var(--gog-field-label-line-height);
--gog-select-label-font-weight: var(--gog-field-label-font-weight);
--gog-select-label-letter-spacing: var(--gog-field-label-letter-spacing);
--gog-select-label-text-transform: var(--gog-field-label-text-transform);
--gog-select-field-bg: var(--gog-surface-color);
--gog-select-field-border: var(--gog-accent-dim);
--gog-select-field-border-width: var(--gog-control-border-width);
--gog-select-field-border-style: var(--gog-control-border-style);
--gog-select-radius: var(--gog-radius);
--gog-select-field-color: var(--gog-text-color);
--gog-select-placeholder-color: var(--gog-muted-text-color);
--gog-select-focus-border: var(--gog-accent-color);
--gog-select-focus-ring: var(--gog-accent-pale);
--gog-select-focus-glow: 0 0 8px var(--gog-select-focus-ring);
--gog-select-focus-ring-width: var(--gog-focus-ring-width);
--gog-select-focus-ring-offset: var(--gog-focus-ring-offset);
--gog-select-error-color: var(--gog-danger-color);
--gog-select-error-font-size: var(--gog-text-xs);
--gog-select-error-line-height: var(--gog-field-error-line-height);
--gog-select-chevron-color: var(--gog-accent-color);
/* The trigger's padding-right, with the chevron inside that padding; matches the input's icon
inset so fields line up in a form. */
--gog-select-chevron-inset: var(--gog-control-icon-offset);
/* Floor for an auto-width trigger, so it cannot collapse to the chevron. */
--gog-select-min-width: 120px;
/* Ceiling for a content-sized panel, so one long option cannot span the viewport. */
--gog-select-panel-max-width: 420px;
/* Filter box, rendered only when `filter` is on. */
--gog-select-filter-padding: var(--gog-space-8);
--gog-select-filter-input-padding-y: var(--gog-space-8);
--gog-select-filter-input-padding-x: var(--gog-space-16);
--gog-select-filter-input-bg: var(--gog-background-color);
--gog-select-filter-input-color: var(--gog-select-field-color);
--gog-select-filter-input-border: var(--gog-select-field-border);
/* Square is the concentric answer: the filter is inset by exactly the panel's radius, so a right
angle keeps the gap to the curve constant. */
--gog-select-filter-input-radius: max(
0px,
calc(var(--gog-select-panel-radius) - var(--gog-select-filter-padding))
);
--gog-select-filter-border-width: var(--gog-panel-border-width);
--gog-select-filter-border-style: var(--gog-panel-border-style);
--gog-select-filter-border-color: var(--gog-select-option-border-color, var(--gog-border-color));
--gog-select-filter-empty-padding: var(--gog-space-12);
--gog-select-filter-empty-color: var(--gog-select-placeholder-color);
/* Clear button, rendered once a value is selected. */
/* A quarter of the corner radius, like the input's clear button. */
--gog-select-clear-radius: calc(var(--gog-radius) / 4);
--gog-select-clear-line-height: var(--gog-line-height-none);
--gog-select-clear-icon-ratio: var(--gog-control-clear-icon-ratio);
--gog-select-clear-gap: var(--gog-space-8);
--gog-select-clear-color: var(--gog-select-placeholder-color);
--gog-select-clear-hover-color: var(--gog-select-label-color);
--gog-select-control-gap: var(--gog-space-12);
--gog-select-panel-bg: var(--gog-surface-color);
--gog-select-panel-shadow: var(--gog-panel-shadow);
--gog-select-panel-max-height: 260px;
--gog-select-panel-gap: var(--gog-space-4);
/* The panel's own corner, separate from `--gog-select-radius` so a pill-shaped field does not turn
the dropdown into a pill. */
--gog-select-panel-radius: var(--gog-radius);
/* The list's gutter, so rounded rows sit inside the rounded panel. */
--gog-select-options-padding: var(--gog-space-4);
--gog-select-option-hover-bg: var(--gog-hover-color);
--gog-select-option-press-bg: var(--gog-border-color);
--gog-select-option-selected-color: var(--gog-accent-color);
--gog-select-option-color: var(--gog-text-color);
/* The gap inside a row (check mark to label), not between rows. */
--gog-select-option-gap: var(--gog-space-12);
/* Concentric with the panel: its radius minus the list padding, derived so it survives density changes. */
--gog-select-option-radius: max(
0px,
calc(var(--gog-select-panel-radius) - var(--gog-select-options-padding))
);
/* A starting estimate for the up/down placement. The component measures a real row after the
panel first renders and corrects itself; this only affects that first frame. */
--gog-select-option-height: 40px;
--gog-select-option-disabled-opacity: var(--gog-disabled-opacity);
--gog-select-option-transition-duration: var(--gog-duration-fast);
/* Icon geometry as ratios of the control's font size. */
--gog-select-chevron-icon-ratio: 0.875;
--gog-select-mark-size-ratio: 1.125;
--gog-select-mark-icon-ratio: 0.875;
--gog-select-disabled-opacity: var(--gog-disabled-opacity);
--gog-select-transition-duration: var(--gog-duration-base);
--gog-select-float-label-reserve: var(--gog-field-float-label-reserve);
--gog-select-float-label-in-top: var(--gog-field-float-label-in-top);
--gog-select-float-label-over-gap: var(--gog-field-float-label-over-gap);
--gog-select-float-label-over-reserve: var(--gog-field-float-label-over-reserve);
/* ── Skeleton ─────────────────────────────────────────────────────────────── */
--gog-skeleton-base: var(--gog-hover-color);
--gog-skeleton-shine: var(--gog-surface-color);
--gog-skeleton-radius: var(--gog-radius);
--gog-skeleton-square-radius: 0px;
--gog-skeleton-line-radius: calc(var(--gog-skeleton-radius) / 2);
--gog-skeleton-line-gap: var(--gog-space-sm);
--gog-skeleton-short-line-width: 60%;
--gog-skeleton-pulse-duration: 1.6s;
--gog-skeleton-pulse-min-opacity: 0.5;
--gog-skeleton-wave-duration: 1.6s;
--gog-skeleton-line-height-xsm: 8px;
--gog-skeleton-line-height-sm: 10px;
--gog-skeleton-line-height-md: 14px;
--gog-skeleton-line-height-lg: 18px;
--gog-skeleton-line-height-slg: 24px;
--gog-skeleton-circle-size-xsm: 24px;
--gog-skeleton-circle-size-sm: 32px;
--gog-skeleton-circle-size-md: 48px;
--gog-skeleton-circle-size-lg: 64px;
--gog-skeleton-circle-size-slg: 96px;
--gog-skeleton-rect-height-xsm: 40px;
--gog-skeleton-rect-height-sm: 64px;
--gog-skeleton-rect-height-md: 120px;
--gog-skeleton-rect-height-lg: 200px;
--gog-skeleton-rect-height-slg: 320px;
/* ── Slider ───────────────────────────────────────────────────────────────── */
--gog-slider-auto-width: 240px;
/* Track length of a vertical slider; `-auto-width` covers the horizontal case. */
--gog-slider-vertical-length: 160px;
--gog-slider-label-font-family: var(--gog-field-label-font-family);
--gog-slider-value-font-family: var(--gog-font-mono);
--gog-slider-error-font-family: var(--gog-font-body);
--gog-slider-gap: var(--gog-space-8);
--gog-slider-label-color: var(--gog-field-label-color);
--gog-slider-label-font-size: var(--gog-field-label-font-size);
--gog-slider-label-line-height: var(--gog-field-label-line-height);
--gog-slider-label-font-weight: var(--gog-field-label-font-weight);
--gog-slider-label-letter-spacing: var(--gog-field-label-letter-spacing);
--gog-slider-label-text-transform: var(--gog-field-label-text-transform);
--gog-slider-value-color: var(--gog-accent-color);
--gog-slider-value-font-size: var(--gog-text-sm);
--gog-slider-value-line-height: var(--gog-line-height-none);
--gog-slider-value-min-width: 40px;
--gog-slider-track-height: 4px;
--gog-slider-track-area-height: 20px;
--gog-slider-track-radius: 0px;
/*
* Not an accent token: a groove on the accent ramp blurs into the accent fill at a 4px track. A
* neutral groove stays distinct from the fill in every theme.
*/
--gog-slider-track-bg: var(--gog-border-color);
--gog-slider-track-border-width: var(--gog-border-width);
--gog-slider-track-border-style: var(--gog-border-style);
/* Transparent by default: the border is in the box model, and a theme opts in by giving it a colour. */
--gog-slider-track-border-color: transparent;
/* Bound to `background`, so a gradient works as well as a colour. */
--gog-slider-fill-bg: var(--gog-accent-color);
--gog-slider-thumb-size: 16px;
/* A range thumb's pointer target (WCAG 2.5.8); the drawn thumb stays --gog-slider-thumb-size. */
--gog-slider-range-target-size: 24px;
--gog-slider-thumb-bg: var(--gog-accent-color);
--gog-slider-thumb-border: var(--gog-background-color);
--gog-slider-thumb-border-width: var(--gog-control-border-width);
--gog-slider-thumb-radius: 50%;
/* A colour, not a shadow: the thumb composes it as `0 0 var(--gog-slider-thumb-glow-size) <this>`. */
--gog-slider-thumb-glow-color: var(--gog-accent-pale);
--gog-slider-thumb-glow-size: 6px;
--gog-slider-focus-ring: var(--gog-accent-pale);
--gog-slider-focus-ring-width: var(--gog-focus-ring-width);
--gog-slider-range-color: var(--gog-muted-text-color);
--gog-slider-range-font-size: var(--gog-text-xs);
--gog-slider-range-line-height: var(--gog-line-height-none);
--gog-slider-error-color: var(--gog-danger-color);
--gog-slider-error-font-size: var(--gog-text-xs);
--gog-slider-error-line-height: var(--gog-field-error-line-height);
--gog-slider-disabled-opacity: var(--gog-disabled-opacity);
/* ── Spinner ──────────────────────────────────────────────────────────────── */
--gog-spinner-rune-font-family: var(--gog-font-heading);
--gog-spinner-track-color: var(--gog-accent-dim);
--gog-spinner-arc-outer-color: var(--gog-accent-color);
--gog-spinner-arc-inner-color: var(--gog-accent-bright);
--gog-spinner-diamond-color: var(--gog-accent-bright);
--gog-spinner-rune-color: var(--gog-accent-bright);
--gog-spinner-glow-color: var(--gog-accent-color);
--gog-spinner-track-opacity: 0.35;
--gog-spinner-arc-inner-opacity: 0.75;
--gog-spinner-diamond-opacity: 0.85;
--gog-spinner-arc-outer-pulse-opacity: 0.8;
--gog-spinner-arc-inner-pulse-opacity: 0.45;
--gog-spinner-rune-pulse-opacity: 0.4;
--gog-spinner-arc-outer-dash: 100 63;
--gog-spinner-arc-inner-dash: 35 78;
--gog-spinner-arc-inner-stroke-compact: 1;
--gog-spinner-spin-duration: 1.4s;
--gog-spinner-spin-slow-duration: 2s;
--gog-spinner-ticks-duration: 6s;
--gog-spinner-pulse-duration: 2.8s;
--gog-spinner-ring-duration: 1s;
--gog-spinner-ring-padding: 16%;
--gog-spinner-arc-outer-glow: 5px;
--gog-spinner-arc-inner-glow: 4px;
--gog-spinner-diamond-glow: 3px;
--gog-spinner-rune-glow: 6px;
--gog-spinner-ring-glow: 5px;
--gog-spinner-overlay-blur: 3px;
--gog-spinner-overlay-fade-duration: var(--gog-duration-slow);
/* ── Table ────────────────────────────────────────────────────────────────── */
--gog-table-font-family: var(--gog-font-body);
--gog-table-header-font-family: var(--gog-font-heading);
--gog-table-numeric-font-family: var(--gog-font-mono);
--gog-table-gap: var(--gog-space-12);
--gog-table-border-color: var(--gog-accent-dim);
--gog-table-border-width: var(--gog-control-border-width);
--gog-table-border-style: var(--gog-border-style);
--gog-table-row-border-width: var(--gog-border-width);
/* Sized to its checkbox; never grows with content. */
--gog-table-select-col-width: 44px;
--gog-table-surface: var(--gog-surface-color);
/* The header's own ground, so a sticky header stays distinct from the rows scrolling beneath it. */
--gog-table-header-bg: var(--gog-hover-color);
--gog-table-text-color: var(--gog-text-color);
--gog-table-accent-color: var(--gog-accent-color);
--gog-table-accent-bright: var(--gog-accent-bright);
--gog-table-hover-bg: var(--gog-accent-pale);
/* Only an `interactiveRows` row presses; a plain row is not a control. */
--gog-table-row-press-bg: var(--gog-border-color);
/* Selected rows keep this tint through hover, so hover never reads as deselecting. */
--gog-table-selected-bg: var(--gog-accent-pale);
--gog-table-muted-color: var(--gog-muted-text-color);
--gog-table-focus-ring: var(--gog-accent-color);
--gog-table-focus-ring-width: var(--gog-focus-ring-width);
--gog-table-header-letter-spacing: var(--gog-letter-spacing);
--gog-table-header-text-transform: var(--gog-text-transform);
--gog-table-num-col-width: 48px;
--gog-table-th-inner-gap: var(--gog-space-8);
--gog-table-sort-icon-size: 0.9em;
--gog-table-sort-icon-width: 1.1em;
--gog-table-sort-icon-opacity: 0.6;
--gog-table-empty-padding: var(--gog-space-24) var(--gog-space-16);
--gog-table-empty-font-size: var(--gog-text-md);
--gog-table-empty-line-height: var(--gog-line-height-normal);
--gog-table-loading-padding: var(--gog-space-32) var(--gog-space-16);
--gog-table-loading-opacity: 0.5;
--gog-table-row-transition-duration: var(--gog-duration-fast);
--gog-table-footer-gap: var(--gog-space-sm);
--gog-table-footer-min-height: 32px;
--gog-table-total-font-size: var(--gog-text-xs);
--gog-table-total-line-height: var(--gog-line-height-normal);
--gog-table-total-letter-spacing: 0.5px;
--gog-table-total-text-transform: var(--gog-text-transform);
--gog-table-num-font-size: var(--gog-text-xs);
--gog-table-num-line-height: var(--gog-line-height-normal);
--gog-table-padding-h: var(--gog-space-16);
--gog-table-xsm-padding-v: var(--gog-space-4);
--gog-table-xsm-th-font-size: var(--gog-text-xs);
--gog-table-xsm-td-font-size: var(--gog-text-xs);
--gog-table-sm-padding-v: var(--gog-space-4);
--gog-table-sm-th-font-size: var(--gog-text-xs);
--gog-table-sm-td-font-size: var(--gog-text-xs);
--gog-table-md-padding-v: var(--gog-space-8);
--gog-table-md-th-font-size: var(--gog-text-xs);
--gog-table-md-td-font-size: var(--gog-text-sm);
--gog-table-lg-padding-v: var(--gog-space-12);
--gog-table-lg-th-font-size: var(--gog-text-sm);
--gog-table-lg-td-font-size: var(--gog-text-md);
--gog-table-slg-padding-v: var(--gog-space-16);
--gog-table-slg-th-font-size: var(--gog-text-md);
--gog-table-slg-td-font-size: var(--gog-text-lg);
/* One value for every size: the role picks the leading, not the size. */
--gog-table-td-line-height: var(--gog-line-height-normal);
--gog-table-th-line-height: var(--gog-line-height-normal);
/* ── Tabs ──────────────────────────────────────────────────────────────────
`--gog-tabs-tab-bg`, `-tab-color`, `-tab-padding` and `-tab-font-size` are intentionally NOT
declared (per-instance escape hatch). The indicator's offset and length are written as inline
styles from measured geometry. */
--gog-tabs-font-family: var(--gog-font-heading);
--gog-tabs-font-weight: var(--gog-font-weight-bold);
--gog-tabs-letter-spacing: 0.4px;
--gog-tabs-text-transform: none;
--gog-tabs-line-height: var(--gog-line-height-tight);
--gog-tabs-gap: 0px;
--gog-tabs-tab-gap: var(--gog-space-sm);
--gog-tabs-icon-size: 1.1em;
--gog-tabs-rest-bg: transparent;
--gog-tabs-rest-color: var(--gog-muted-text-color);
--gog-tabs-hover-color: var(--gog-text-color);
/* Tabs have no rest or hover ground, so the press is their only fill. */
--gog-tabs-press-bg: var(--gog-border-color);
/* The press uses full text colour: a muted label on a tinted ground falls below AA. */
--gog-tabs-press-color: var(--gog-text-color);
--gog-tabs-active-color: var(--gog-accent-color);
--gog-tabs-header-border-width: var(--gog-border-width);
--gog-tabs-header-border-style: var(--gog-border-style);
--gog-tabs-header-border-color: var(--gog-border-color);
--gog-tabs-indicator-color: var(--gog-accent-color);
--gog-tabs-indicator-thickness: 2px;
--gog-tabs-indicator-radius: 999px;
--gog-tabs-transition-duration: var(--gog-duration-base);
--gog-tabs-disabled-opacity: var(--gog-disabled-opacity);
--gog-tabs-focus-ring-width: var(--gog-focus-ring-width);
/* Inset: tabs sit shoulder to shoulder, like calendar cells. */
--gog-tabs-focus-ring-offset: calc(var(--gog-focus-ring-offset) * -1);
--gog-tabs-focus-ring-color: var(--gog-accent-color);
--gog-tabs-panel-padding: var(--gog-space-md);
--gog-tabs-panel-color: var(--gog-text-color);
--gog-tabs-xsm-padding: var(--gog-space-8) var(--gog-space-16);
--gog-tabs-xsm-font-size: var(--gog-text-xs);
--gog-tabs-sm-padding: var(--gog-space-8) var(--gog-space-16);
--gog-tabs-sm-font-size: var(--gog-text-sm);
--gog-tabs-md-padding: var(--gog-space-12) var(--gog-space-24);
--gog-tabs-md-font-size: var(--gog-text-md);
--gog-tabs-lg-padding: var(--gog-space-16) var(--gog-space-32);
--gog-tabs-lg-font-size: var(--gog-text-lg);
--gog-tabs-slg-padding: var(--gog-space-20) var(--gog-space-40);
--gog-tabs-slg-font-size: var(--gog-text-xl);
/* ── Tag ──────────────────────────────────────────────────────────────────
The unsuffixed `--gog-tag-bg`, `-border`, `-color`, `-font-size` and friends stay undeclared so
variant and size classes fall through them. */
--gog-tag-font-family: inherit;
--gog-tag-default-color: var(--gog-info-color, var(--gog-muted-text-color));
--gog-tag-success-color: var(--gog-success-color);
--gog-tag-danger-color: var(--gog-danger-color);
--gog-tag-warning-color: var(--gog-warning-color);
--gog-tag-info-color: var(--gog-info-color);
--gog-tag-bg-mix: 10%;
/* The label is the status hue mixed halfway toward the theme's ink — toward `--gog-text-color`
rather than black, so it works on light and dark themes and stays readable as text. */
--gog-tag-color-mix: 50%;
--gog-tag-bg-base: var(--gog-surface-color);
--gog-tag-color-base: var(--gog-text-color);
--gog-tag-border-width: var(--gog-border-width);
--gog-tag-border-style: var(--gog-border-style);
--gog-tag-inner-border-width: var(--gog-border-width);
--gog-tag-font-weight: var(--gog-font-weight-semibold);
--gog-tag-line-height: var(--gog-line-height-none);
--gog-tag-radius: max(var(--gog-radius), 2px);
--gog-tag-pill-radius: 9999px;
--gog-tag-xsm-font-size: var(--gog-text-2xs);
--gog-tag-xsm-padding-block: var(--gog-space-4);
--gog-tag-xsm-padding-inline: var(--gog-space-8);
--gog-tag-xsm-gap: var(--gog-space-4);
--gog-tag-xsm-icon-size: 0.6875rem;
--gog-tag-sm-font-size: var(--gog-text-xs);
--gog-tag-sm-padding-block: var(--gog-space-4);
--gog-tag-sm-padding-inline: var(--gog-space-8);
--gog-tag-sm-gap: var(--gog-space-4);
--gog-tag-sm-icon-size: 0.75rem;
--gog-tag-md-font-size: var(--gog-text-sm);
--gog-tag-md-padding-block: var(--gog-space-8);
--gog-tag-md-padding-inline: var(--gog-space-16);
--gog-tag-md-gap: var(--gog-space-8);
--gog-tag-md-icon-size: 0.875rem;
--gog-tag-lg-font-size: var(--gog-text-md);
--gog-tag-lg-padding-block: var(--gog-space-8);
--gog-tag-lg-padding-inline: var(--gog-space-16);
--gog-tag-lg-gap: var(--gog-space-8);
--gog-tag-lg-icon-size: 1rem;
--gog-tag-slg-font-size: var(--gog-text-lg);
--gog-tag-slg-padding-block: var(--gog-space-12);
--gog-tag-slg-padding-inline: var(--gog-space-24);
--gog-tag-slg-gap: var(--gog-space-12);
--gog-tag-slg-icon-size: 1.125rem;
/* ── Toast ────────────────────────────────────────────────────────────────── */
--gog-toast-font-family: var(--gog-font-body);
--gog-toast-bg: var(--gog-surface-color);
--gog-toast-color: var(--gog-text-color);
--gog-toast-border: var(--gog-accent-color);
--gog-toast-icon-color: var(--gog-accent-color);
/* Each type has its own colour; it paints the stripe, the icon and the countdown bar, so it is the
whole signal. */
--gog-toast-success-color: var(--gog-success-color);
--gog-toast-error-color: var(--gog-danger-color);
--gog-toast-warning-color: var(--gog-warning-color);
--gog-toast-info-color: var(--gog-info-color);
--gog-toast-accent-width: 4px;
--gog-toast-padding: var(--gog-space-12) var(--gog-space-16);
--gog-toast-radius: 0px;
--gog-toast-content-gap: var(--gog-space-12);
--gog-toast-main-gap: var(--gog-space-sm);
--gog-toast-actions-gap: var(--gog-space-8);
--gog-toast-message-font-size: var(--gog-text-sm);
--gog-toast-message-line-height: var(--gog-line-height-relaxed);
--gog-toast-icon-size: 1rem;
--gog-toast-icon-line-height: var(--gog-line-height-normal);
--gog-toast-action-padding: var(--gog-space-4) var(--gog-space-8);
--gog-toast-action-font-size: var(--gog-text-xs);
--gog-toast-action-line-height: var(--gog-line-height-none);
--gog-toast-close-padding: var(--gog-space-4) var(--gog-space-8);
--gog-toast-close-font-size: var(--gog-text-xs);
--gog-toast-close-line-height: var(--gog-line-height-none);
--gog-toast-progress-height: 3px;
--gog-toast-progress-opacity: 30%;
--gog-toast-transition-duration: 0.25s;
--gog-toast-stack-peek: 14px;
--gog-toast-stack-scale-step: 0.06;
--gog-toast-stack-expanded-gap: 84px;
--gog-toast-stack-min-opacity: 0.4;
--gog-toast-stack-opacity-step: 0.18;
--gog-toast-stack-max-depth: 6;
/* ── Toggle ───────────────────────────────────────────────────────────────────
A switch, not a checkbox. The label reuses the checkbox scale so the two read at the same weight
in one form; the track and thumb geometry is its own. */
--gog-toggle-font-family: var(--gog-font-body);
--gog-toggle-gap: var(--gog-space-sm);
--gog-toggle-radius: 999px;
--gog-toggle-border-width: var(--gog-border-width);
--gog-toggle-border-style: var(--gog-border-style);
--gog-toggle-border-color: var(--gog-control-boundary-color);
--gog-toggle-on-border-color: var(--gog-accent-color);
--gog-toggle-track-off-bg: var(--gog-border-color);
--gog-toggle-track-on-bg: var(--gog-accent-color);
--gog-toggle-thumb-off-bg: var(--gog-surface-color);
--gog-toggle-thumb-on-bg: var(--gog-accent-text-color, var(--gog-primary-color));
/* Inside one painted mark, so off the 4px grid on purpose: the thumb at this inset fills enough of
the track to read as a switch. */
--gog-toggle-thumb-inset: 2px;
--gog-toggle-transition-duration: var(--gog-duration-base);
--gog-toggle-disabled-opacity: var(--gog-disabled-opacity);
--gog-toggle-label-color: var(--gog-text-color);
--gog-toggle-label-line-height: var(--gog-line-height-normal);
--gog-toggle-focus-ring-width: var(--gog-focus-ring-width);
--gog-toggle-focus-ring-offset: var(--gog-focus-ring-offset);
--gog-toggle-focus-ring-color: var(--gog-accent-color);
/* In-track on/off wording. */
--gog-toggle-state-color: var(--gog-accent-text-color, var(--gog-primary-color));
--gog-toggle-state-font-weight: var(--gog-font-weight-semibold);
--gog-toggle-state-letter-spacing: 0.04em;
--gog-toggle-state-padding-inline: var(--gog-space-4);
--gog-toggle-state-offset: var(--gog-space-8);
/* The full clearance (thumb size + this gap) is computed in the component stylesheet: a size token
substituted here would freeze to one size. */
--gog-toggle-state-thumb-gap: var(--gog-space-8);
--gog-toggle-xsm-track-width: 24px;
--gog-toggle-xsm-track-height: 14px;
--gog-toggle-xsm-thumb-size: 10px;
--gog-toggle-xsm-label-size: var(--gog-control-checkbox-label-size-xsm);
--gog-toggle-xsm-state-font-size: 0.5rem;
--gog-toggle-sm-track-width: 32px;
--gog-toggle-sm-track-height: 18px;
--gog-toggle-sm-thumb-size: 14px;
--gog-toggle-sm-label-size: var(--gog-control-checkbox-label-size-sm);
--gog-toggle-sm-state-font-size: 0.5625rem;
--gog-toggle-md-track-width: 44px;
--gog-toggle-md-track-height: 24px;
--gog-toggle-md-thumb-size: 18px;
--gog-toggle-md-label-size: var(--gog-control-checkbox-label-size-md);
--gog-toggle-md-state-font-size: 0.625rem;
--gog-toggle-lg-track-width: 56px;
--gog-toggle-lg-track-height: 32px;
--gog-toggle-lg-thumb-size: 26px;
--gog-toggle-lg-label-size: var(--gog-control-checkbox-label-size-lg);
--gog-toggle-lg-state-font-size: var(--gog-text-xs);
--gog-toggle-slg-track-width: 68px;
--gog-toggle-slg-track-height: 40px;
--gog-toggle-slg-thumb-size: 34px;
--gog-toggle-slg-label-size: var(--gog-control-checkbox-label-size-slg);
--gog-toggle-slg-state-font-size: 0.8125rem;
--gog-toggle-state-line-height: var(--gog-line-height-none);
/* ── Tooltip ──────────────────────────────────────────────────────────────── */
--gog-tooltip-font-family: var(--gog-font-body);
--gog-tooltip-font-size: var(--gog-text-xs);
--gog-tooltip-line-height: var(--gog-line-height-normal);
--gog-tooltip-padding: var(--gog-space-8) var(--gog-space-12);
--gog-tooltip-radius: var(--gog-radius);
/* The bubble wraps, so its cap is a measure in `ch`; the viewport clamp keeps it on screen. */
--gog-tooltip-max-width: min(43ch, calc(100vw - var(--gog-space-16) * 2));
/* A cap, not a height: only unusually long content (a template with several paragraphs) scrolls. */
--gog-tooltip-max-height: 220px;
/* The same floating-panel recipe as the dialog and the dropdowns, rather than an inverted bubble,
so it belongs to the theme. */
--gog-tooltip-bg: var(--gog-surface-color);
--gog-tooltip-color: var(--gog-text-color);
--gog-tooltip-border-width: var(--gog-panel-border-width);
--gog-tooltip-border-style: var(--gog-panel-border-style);
--gog-tooltip-border-color: var(--gog-border-color);
--gog-tooltip-shadow: var(--gog-panel-shadow);
--gog-tooltip-arrow-size: 5px;
/* Read by the directive for its placement math, not only by CSS. */
--gog-tooltip-gap: var(--gog-space-8);
--gog-tooltip-transition-duration: var(--gog-duration-fast);
}
/* theme-starter:derived-end */