Skip to content

Commit 6b0e1b5

Browse files
committed
Update guides to document new variants.
1 parent 097503e commit 6b0e1b5

42 files changed

Lines changed: 154 additions & 147 deletions

File tree

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

‎frontend/purestack.studio/components/actions/alert-box/alert-box.mdx‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -142,7 +142,7 @@ AlertBox is a visual content component and does not automatically announce messa
142142
</ApiProperty>
143143

144144
<ApiProperty anchor="alert-box-prop-variant" name="variant" valueType="RefOrValue&lt;ComponentVariant&gt;" defaultValue="surface">
145-
<p>Visual treatment. Accepts solid, surface, surfaceAlt, outlineFill, outline, subtle, subtleBtn, link, sheen, underline, rail, bracket or none.</p>
145+
<p>Visual treatment. Accepts solid, surface, surfaceAlt, spotlight, glass, flat, flatAlt, flatSolid, outlineFill, outline, subtle, subtleBtn, link, sheen, underline, rail, bracket or none.</p>
146146
</ApiProperty>
147147

148148
<ApiProperty anchor="alert-box-prop-variantMode" name="variantMode" valueType="RefOrValue&lt;ComponentVariantMode&gt;" defaultValue="stateless">

‎frontend/purestack.studio/components/actions/badge/badge-playground.ts‎

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -47,6 +47,11 @@ function createBadgePlayground(): BadgePlayground {
4747
'solid',
4848
'surface',
4949
'surfaceAlt',
50+
'spotlight',
51+
'glass',
52+
'flat',
53+
'flatAlt',
54+
'flatSolid',
5055
'outlineFill',
5156
'outline',
5257
'subtle',

‎frontend/purestack.studio/components/actions/badge/badge.mdx‎

Lines changed: 18 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
---
22
title: Badge
3-
description: Compact status and metadata with semantic tones, thirteen visual treatments, inline composition, and reactive release status examples.
3+
description: Compact status and metadata with semantic tones, several visual treatments, inline composition, and reactive release status examples.
44
template: doc
55
layout:
66
showNav: true
@@ -92,6 +92,11 @@ function createBadgePlayground(): BadgePlayground {
9292
'solid',
9393
'surface',
9494
'surfaceAlt',
95+
'spotlight',
96+
'glass',
97+
'flat',
98+
'flatAlt',
99+
'flatSolid',
95100
'outlineFill',
96101
'outline',
97102
'subtle',
@@ -185,7 +190,7 @@ Use tone to reinforce the meaning already expressed by the label. “Passing”,
185190

186191
## Variants
187192

188-
Badge accepts all thirteen shared variants and defaults to `surface`. Its variants use stateless styling: they do not add the hover and active behavior used by buttons. Interaction-oriented treatments may therefore look similar on a badge.
193+
Badge accepts every shared variant and defaults to `surface`. Its variants use stateless styling: they do not add the hover and active behavior used by buttons. Interaction-oriented treatments may therefore look similar on a badge.
189194

190195
<Tabs
191196
group="badge-variants-example"
@@ -200,6 +205,11 @@ Badge accepts all thirteen shared variants and defaults to `surface`. Its varian
200205
<Badge tone="accent" variant="solid">solid</Badge>
201206
<Badge tone="accent" variant="surface">surface</Badge>
202207
<Badge tone="accent" variant="surfaceAlt">surfaceAlt</Badge>
208+
<Badge tone="accent" variant="spotlight">spotlight</Badge>
209+
<Badge tone="accent" variant="glass">glass</Badge>
210+
<Badge tone="accent" variant="flat">flat</Badge>
211+
<Badge tone="accent" variant="flatAlt">flatAlt</Badge>
212+
<Badge tone="accent" variant="flatSolid">flatSolid</Badge>
203213
<Badge tone="accent" variant="outlineFill">outlineFill</Badge>
204214
<Badge tone="accent" variant="outline">outline</Badge>
205215
<Badge tone="accent" variant="subtle">subtle</Badge>
@@ -218,6 +228,11 @@ Badge accepts all thirteen shared variants and defaults to `surface`. Its varian
218228
<Badge tone="accent" variant="solid">solid</Badge>
219229
<Badge tone="accent" variant="surface">surface</Badge>
220230
<Badge tone="accent" variant="surfaceAlt">surfaceAlt</Badge>
231+
<Badge tone="accent" variant="spotlight">spotlight</Badge>
232+
<Badge tone="accent" variant="glass">glass</Badge>
233+
<Badge tone="accent" variant="flat">flat</Badge>
234+
<Badge tone="accent" variant="flatAlt">flatAlt</Badge>
235+
<Badge tone="accent" variant="flatSolid">flatSolid</Badge>
221236
<Badge tone="accent" variant="outlineFill">outlineFill</Badge>
222237
<Badge tone="accent" variant="outline">outline</Badge>
223238
<Badge tone="accent" variant="subtle">subtle</Badge>
@@ -458,7 +473,7 @@ Both props accept values or Regor refs. Register `defineBadgeComponents()` when
458473

459474
<ApiProperty anchor="badge-prop-variant" name="variant" valueType="ComponentVariant" defaultValue="surface">
460475
<p>Sets the visual treatment using the stateless form of the shared variants. A variant changes appearance; it never turns the badge into a link or a button.</p>
461-
<div class="api-values"><code>solid</code><code>surface</code><code>surfaceAlt</code><code>outlineFill</code><code>outline</code><code>subtle</code><code>subtleBtn</code><code>link</code><code>sheen</code><code>underline</code><code>rail</code><code>bracket</code><code>none</code></div>
476+
<div class="api-values"><code>solid</code><code>surface</code><code>surfaceAlt</code><code>spotlight</code><code>glass</code><code>flat</code><code>flatAlt</code><code>flatSolid</code><code>outlineFill</code><code>outline</code><code>subtle</code><code>subtleBtn</code><code>link</code><code>sheen</code><code>underline</code><code>rail</code><code>bracket</code><code>none</code></div>
462477
<div class="api-demo"><Badge tone="accent" variant="solid">Solid</Badge><Badge tone="accent">Surface</Badge><Badge tone="accent" variant="outline">Outline</Badge><Badge tone="accent" variant="subtle">Subtle</Badge></div>
463478
```html
464479
<Badge tone="accent" variant="solid">Featured</Badge>

‎frontend/purestack.studio/components/actions/btn-group-drop-down/btn-group-drop-down.mdx‎

Lines changed: 8 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -172,6 +172,11 @@ function createDropdownPlayground(): DropdownPlayground {
172172
'solid',
173173
'surface',
174174
'surfaceAlt',
175+
'spotlight',
176+
'glass',
177+
'flat',
178+
'flatAlt',
179+
'flatSolid',
175180
'outlineFill',
176181
'outline',
177182
'subtle',
@@ -673,8 +678,8 @@ All props accept values or Regor refs. Register `defineBtnGroupComponents()` and
673678
</ApiProperty>
674679

675680
<ApiProperty anchor="dropdown-prop-variant" name="variant" valueType="ComponentVariant" defaultValue="solid">
676-
<p>The trigger's visual treatment. All thirteen shared variants are supported; the menu panel has its own variant.</p>
677-
<div class="api-values"><code>solid</code><code>surface</code><code>surfaceAlt</code><code>outlineFill</code><code>outline</code><code>subtle</code><code>subtleBtn</code><code>link</code><code>sheen</code><code>underline</code><code>rail</code><code>bracket</code><code>none</code></div>
681+
<p>The trigger's visual treatment. Every shared variant is supported; the menu panel has its own variant.</p>
682+
<div class="api-values"><code>solid</code><code>surface</code><code>surfaceAlt</code><code>spotlight</code><code>glass</code><code>flat</code><code>flatAlt</code><code>flatSolid</code><code>outlineFill</code><code>outline</code><code>subtle</code><code>subtleBtn</code><code>link</code><code>sheen</code><code>underline</code><code>rail</code><code>bracket</code><code>none</code></div>
678683
```html
679684
<BtnGroupDropDown label="Resources" variant="outline" menuVariant="surfaceAlt">
680685
<BtnLink href="/components/" variant="subtle">Component guides</BtnLink>
@@ -699,7 +704,7 @@ All props accept values or Regor refs. Register `defineBtnGroupComponents()` and
699704
</ApiProperty>
700705

701706
<ApiProperty anchor="dropdown-prop-menu-variant" name="menuVariant" valueType="ComponentVariant" defaultValue="surfaceAlt">
702-
<p>The menu's fill, border, and text treatment. Accepts the same thirteen variants as the trigger. Surface variants give popup content a distinct background.</p>
707+
<p>The menu's fill, border, and text treatment. Accepts the same variants as the trigger. Surface variants give popup content a distinct background.</p>
703708
```html
704709
<BtnGroupDropDown label="Explore" variant="outline" menuTone="neutral" menuVariant="surface">
705710
<BtnLink href="/components/" variant="subtle">Component guides</BtnLink>

‎frontend/purestack.studio/components/actions/btn-group-drop-down/dropdown-playground.ts‎

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -125,6 +125,11 @@ function createDropdownPlayground(): DropdownPlayground {
125125
'solid',
126126
'surface',
127127
'surfaceAlt',
128+
'spotlight',
129+
'glass',
130+
'flat',
131+
'flatAlt',
132+
'flatSolid',
128133
'outlineFill',
129134
'outline',
130135
'subtle',

‎frontend/purestack.studio/components/actions/btn-link/btn-link.mdx‎

Lines changed: 16 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -167,6 +167,11 @@ function createLinkPlayground(): LinkPlayground {
167167
'solid',
168168
'surface',
169169
'surfaceAlt',
170+
'spotlight',
171+
'glass',
172+
'flat',
173+
'flatAlt',
174+
'flatSolid',
170175
'outlineFill',
171176
'outline',
172177
'subtle',
@@ -348,6 +353,11 @@ Thirteen treatments share the same link semantics. Use a strong treatment for th
348353
<BtnLink href="#link-destination" tone="accent" variant="solid">solid</BtnLink>
349354
<BtnLink href="#link-destination" tone="accent" variant="surface">surface</BtnLink>
350355
<BtnLink href="#link-destination" tone="accent" variant="surfaceAlt">surfaceAlt</BtnLink>
356+
<BtnLink href="#link-destination" tone="accent" variant="spotlight">spotlight</BtnLink>
357+
<BtnLink href="#link-destination" tone="accent" variant="glass">glass</BtnLink>
358+
<BtnLink href="#link-destination" tone="accent" variant="flat">flat</BtnLink>
359+
<BtnLink href="#link-destination" tone="accent" variant="flatAlt">flatAlt</BtnLink>
360+
<BtnLink href="#link-destination" tone="accent" variant="flatSolid">flatSolid</BtnLink>
351361
<BtnLink href="#link-destination" tone="accent" variant="outlineFill">outlineFill</BtnLink>
352362
<BtnLink href="#link-destination" tone="accent" variant="outline">outline</BtnLink>
353363
<BtnLink href="#link-destination" tone="accent" variant="subtle">subtle</BtnLink>
@@ -366,6 +376,11 @@ Thirteen treatments share the same link semantics. Use a strong treatment for th
366376
<BtnLink href="#link-destination" tone="accent" variant="solid">solid</BtnLink>
367377
<BtnLink href="#link-destination" tone="accent" variant="surface">surface</BtnLink>
368378
<BtnLink href="#link-destination" tone="accent" variant="surfaceAlt">surfaceAlt</BtnLink>
379+
<BtnLink href="#link-destination" tone="accent" variant="spotlight">spotlight</BtnLink>
380+
<BtnLink href="#link-destination" tone="accent" variant="glass">glass</BtnLink>
381+
<BtnLink href="#link-destination" tone="accent" variant="flat">flat</BtnLink>
382+
<BtnLink href="#link-destination" tone="accent" variant="flatAlt">flatAlt</BtnLink>
383+
<BtnLink href="#link-destination" tone="accent" variant="flatSolid">flatSolid</BtnLink>
369384
<BtnLink href="#link-destination" tone="accent" variant="outlineFill">outlineFill</BtnLink>
370385
<BtnLink href="#link-destination" tone="accent" variant="outline">outline</BtnLink>
371386
<BtnLink href="#link-destination" tone="accent" variant="subtle">subtle</BtnLink>
@@ -552,7 +567,7 @@ Props accept values or Regor refs. For reactive expressions, pass a `computed` r
552567

553568
<ApiProperty anchor="link-prop-variant" name="variant" valueType="ComponentVariant" defaultValue="solid">
554569
<p>Controls fill, border, and interaction styling. The destination and anchor behavior stay the same for every treatment.</p>
555-
<div class="api-values"><code>solid</code><code>surface</code><code>surfaceAlt</code><code>outlineFill</code><code>outline</code><code>subtle</code><code>subtleBtn</code><code>link</code><code>sheen</code><code>underline</code><code>rail</code><code>bracket</code><code>none</code></div>
570+
<div class="api-values"><code>solid</code><code>surface</code><code>surfaceAlt</code><code>spotlight</code><code>glass</code><code>flat</code><code>flatAlt</code><code>flatSolid</code><code>outlineFill</code><code>outline</code><code>subtle</code><code>subtleBtn</code><code>link</code><code>sheen</code><code>underline</code><code>rail</code><code>bracket</code><code>none</code></div>
556571
<div class="api-demo"><BtnLink href="#variants" tone="accent" variant="solid">Solid</BtnLink><BtnLink href="#variants" tone="accent" variant="outline">Outline</BtnLink><BtnLink href="#variants" tone="accent" variant="link">Link</BtnLink></div>
557572
</ApiProperty>
558573

‎frontend/purestack.studio/components/actions/btn-link/link-playground.ts‎

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -122,6 +122,11 @@ function createLinkPlayground(): LinkPlayground {
122122
'solid',
123123
'surface',
124124
'surfaceAlt',
125+
'spotlight',
126+
'glass',
127+
'flat',
128+
'flatAlt',
129+
'flatSolid',
125130
'outlineFill',
126131
'outline',
127132
'subtle',

‎frontend/purestack.studio/components/actions/buttons/button-playground.ts‎

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -53,6 +53,11 @@ const variants: ComponentVariant[] = [
5353
'solid',
5454
'surface',
5555
'surfaceAlt',
56+
'spotlight',
57+
'glass',
58+
'flat',
59+
'flatAlt',
60+
'flatSolid',
5661
'outlineFill',
5762
'outline',
5863
'subtle',

‎frontend/purestack.studio/components/actions/buttons/buttons.mdx‎

Lines changed: 46 additions & 108 deletions
Original file line numberDiff line numberDiff line change
@@ -21,7 +21,7 @@ A clear next step. Theme-aware actions with native button semantics, expressive
2121

2222
## Playground
2323

24-
Explore all thirteen variants and ten semantic tones. Change the size, move the icon, or try the disabled state. The source tabs contain the complete playground: controls, reactive state, icon registration, and application mount.
24+
Explore every variant and all ten semantic tones. Change the size, move the icon, or try the disabled state. The source tabs contain the complete playground: controls, reactive state, icon registration, and application mount.
2525

2626
<Tabs
2727
group="button-playground-example"
@@ -96,6 +96,11 @@ const variants: ComponentVariant[] = [
9696
'solid',
9797
'surface',
9898
'surfaceAlt',
99+
'spotlight',
100+
'glass',
101+
'flat',
102+
'flatAlt',
103+
'flatSolid',
99104
'outlineFill',
100105
'outline',
101106
'subtle',
@@ -280,116 +285,48 @@ Choose the visual treatment independently from the tone. Filled variants suit pr
280285
tabVariant="underline"
281286
>
282287
<TabPane id="button-variants-preview" label="Preview">
283-
<Grid columns="2" columnsSm="3">
284-
<Flex direction="column" align="center">
285-
<Btn tone="accent" variant="solid">solid</Btn>
286-
<code>solid</code>
287-
</Flex>
288-
<Flex direction="column" align="center">
289-
<Btn tone="accent" variant="surface">surface</Btn>
290-
<code>surface</code>
291-
</Flex>
292-
<Flex direction="column" align="center">
293-
<Btn tone="accent" variant="surfaceAlt">surfaceAlt</Btn>
294-
<code>surfaceAlt</code>
295-
</Flex>
296-
<Flex direction="column" align="center">
297-
<Btn tone="accent" variant="outlineFill">outlineFill</Btn>
298-
<code>outlineFill</code>
299-
</Flex>
300-
<Flex direction="column" align="center">
301-
<Btn tone="accent" variant="outline">outline</Btn>
302-
<code>outline</code>
303-
</Flex>
304-
<Flex direction="column" align="center">
305-
<Btn tone="accent" variant="subtle">subtle</Btn>
306-
<code>subtle</code>
307-
</Flex>
308-
<Flex direction="column" align="center">
309-
<Btn tone="accent" variant="subtleBtn">subtleBtn</Btn>
310-
<code>subtleBtn</code>
311-
</Flex>
312-
<Flex direction="column" align="center">
313-
<Btn tone="accent" variant="link">link</Btn>
314-
<code>link</code>
315-
</Flex>
316-
<Flex direction="column" align="center">
317-
<Btn tone="accent" variant="sheen">sheen</Btn>
318-
<code>sheen</code>
319-
</Flex>
320-
<Flex direction="column" align="center">
321-
<Btn tone="accent" variant="underline">underline</Btn>
322-
<code>underline</code>
323-
</Flex>
324-
<Flex direction="column" align="center">
325-
<Btn tone="accent" variant="rail">rail</Btn>
326-
<code>rail</code>
327-
</Flex>
328-
<Flex direction="column" align="center">
329-
<Btn tone="accent" variant="bracket">bracket</Btn>
330-
<code>bracket</code>
331-
</Flex>
332-
<Flex direction="column" align="center">
333-
<Btn tone="accent" variant="none">none</Btn>
334-
<code>none</code>
335-
</Flex>
288+
<Grid columns="2" columnsSm="3" alignItems="center" justifyItems="center" class="gap-4">
289+
<Btn tone="accent" variant="solid">solid</Btn>
290+
<Btn tone="accent" variant="surface">surface</Btn>
291+
<Btn tone="accent" variant="surfaceAlt">surfaceAlt</Btn>
292+
<Btn tone="accent" variant="spotlight">spotlight</Btn>
293+
<Btn tone="accent" variant="glass">glass</Btn>
294+
<Btn tone="accent" variant="flat">flat</Btn>
295+
<Btn tone="accent" variant="flatAlt">flatAlt</Btn>
296+
<Btn tone="accent" variant="flatSolid">flatSolid</Btn>
297+
<Btn tone="accent" variant="outlineFill">outlineFill</Btn>
298+
<Btn tone="accent" variant="outline">outline</Btn>
299+
<Btn tone="accent" variant="subtle">subtle</Btn>
300+
<Btn tone="accent" variant="subtleBtn">subtleBtn</Btn>
301+
<Btn tone="accent" variant="link">link</Btn>
302+
<Btn tone="accent" variant="sheen">sheen</Btn>
303+
<Btn tone="accent" variant="underline">underline</Btn>
304+
<Btn tone="accent" variant="rail">rail</Btn>
305+
<Btn tone="accent" variant="bracket">bracket</Btn>
306+
<Btn tone="accent" variant="none">none</Btn>
336307
</Grid>
337308
</TabPane>
338309
<TabPane id="button-variants-source" label="variants.mdx">
339310
```html
340-
<Grid columns="2" columnsSm="3">
341-
<Flex direction="column" align="center">
342-
<Btn tone="accent" variant="solid">solid</Btn>
343-
<code>solid</code>
344-
</Flex>
345-
<Flex direction="column" align="center">
346-
<Btn tone="accent" variant="surface">surface</Btn>
347-
<code>surface</code>
348-
</Flex>
349-
<Flex direction="column" align="center">
350-
<Btn tone="accent" variant="surfaceAlt">surfaceAlt</Btn>
351-
<code>surfaceAlt</code>
352-
</Flex>
353-
<Flex direction="column" align="center">
354-
<Btn tone="accent" variant="outlineFill">outlineFill</Btn>
355-
<code>outlineFill</code>
356-
</Flex>
357-
<Flex direction="column" align="center">
358-
<Btn tone="accent" variant="outline">outline</Btn>
359-
<code>outline</code>
360-
</Flex>
361-
<Flex direction="column" align="center">
362-
<Btn tone="accent" variant="subtle">subtle</Btn>
363-
<code>subtle</code>
364-
</Flex>
365-
<Flex direction="column" align="center">
366-
<Btn tone="accent" variant="subtleBtn">subtleBtn</Btn>
367-
<code>subtleBtn</code>
368-
</Flex>
369-
<Flex direction="column" align="center">
370-
<Btn tone="accent" variant="link">link</Btn>
371-
<code>link</code>
372-
</Flex>
373-
<Flex direction="column" align="center">
374-
<Btn tone="accent" variant="sheen">sheen</Btn>
375-
<code>sheen</code>
376-
</Flex>
377-
<Flex direction="column" align="center">
378-
<Btn tone="accent" variant="underline">underline</Btn>
379-
<code>underline</code>
380-
</Flex>
381-
<Flex direction="column" align="center">
382-
<Btn tone="accent" variant="rail">rail</Btn>
383-
<code>rail</code>
384-
</Flex>
385-
<Flex direction="column" align="center">
386-
<Btn tone="accent" variant="bracket">bracket</Btn>
387-
<code>bracket</code>
388-
</Flex>
389-
<Flex direction="column" align="center">
390-
<Btn tone="accent" variant="none">none</Btn>
391-
<code>none</code>
392-
</Flex>
311+
<Grid columns="2" columnsSm="3" alignItems="center" justifyItems="center" class="gap-4">
312+
<Btn tone="accent" variant="solid">solid</Btn>
313+
<Btn tone="accent" variant="surface">surface</Btn>
314+
<Btn tone="accent" variant="surfaceAlt">surfaceAlt</Btn>
315+
<Btn tone="accent" variant="spotlight">spotlight</Btn>
316+
<Btn tone="accent" variant="glass">glass</Btn>
317+
<Btn tone="accent" variant="flat">flat</Btn>
318+
<Btn tone="accent" variant="flatAlt">flatAlt</Btn>
319+
<Btn tone="accent" variant="flatSolid">flatSolid</Btn>
320+
<Btn tone="accent" variant="outlineFill">outlineFill</Btn>
321+
<Btn tone="accent" variant="outline">outline</Btn>
322+
<Btn tone="accent" variant="subtle">subtle</Btn>
323+
<Btn tone="accent" variant="subtleBtn">subtleBtn</Btn>
324+
<Btn tone="accent" variant="link">link</Btn>
325+
<Btn tone="accent" variant="sheen">sheen</Btn>
326+
<Btn tone="accent" variant="underline">underline</Btn>
327+
<Btn tone="accent" variant="rail">rail</Btn>
328+
<Btn tone="accent" variant="bracket">bracket</Btn>
329+
<Btn tone="accent" variant="none">none</Btn>
393330
</Grid>
394331
```
395332
</TabPane>
@@ -776,11 +713,12 @@ Color, treatment, and scale are independent. Combine them to fit the importance
776713
</Flex>
777714
<div class="api-values" aria-label="Accepted variants">
778715
<code>solid</code><code>surface</code><code>surfaceAlt</code>
716+
<code>spotlight</code><code>glass</code><code>flat</code><code>flatAlt</code><code>flatSolid</code>
779717
<code>outlineFill</code><code>outline</code><code>subtle</code>
780718
<code>subtleBtn</code><code>link</code><code>sheen</code>
781719
<code>underline</code><code>rail</code><code>bracket</code><code>none</code>
782720
</div>
783-
<p><a href="#variants">Compare all 13 variants</a></p>
721+
<p><a href="#variants">Compare all variants</a></p>
784722
```html
785723
<Btn tone="accent" variant="outline">View details</Btn>
786724
```

0 commit comments

Comments
 (0)