diff --git a/docs/_includes/sidebar.njk b/docs/_includes/sidebar.njk
index 24465565d..40b45c8ff 100644
--- a/docs/_includes/sidebar.njk
+++ b/docs/_includes/sidebar.njk
@@ -249,10 +249,10 @@
Borders
- Corners
+ Shadows
- Shadows
+ Motion
Extras
diff --git a/docs/docs/theming/color.md b/docs/docs/theming/color.md
index 267c6dfe6..2de022128 100644
--- a/docs/docs/theming/color.md
+++ b/docs/docs/theming/color.md
@@ -504,10 +504,10 @@ Surfaces are background layers that other components and content rest on. Surfac
| Custom Property | Preview |
| ----------------------------- | ------------------------------- |
-| `--wa-color-surface-raised` | |
-| `--wa-color-surface-default` | |
-| `--wa-color-surface-lowered` | |
-| `--wa-color-surface-border` | |
+| `--wa-color-surface-raised` | |
+| `--wa-color-surface-default` | |
+| `--wa-color-surface-lowered` | |
+| `--wa-color-surface-border` | |
### Text
@@ -515,9 +515,9 @@ Text colors are used for standard text elements. We recommend a minimum 4.5:1 co
| Custom Property | Preview |
| ----------------------------- | ------------------------------- |
-| `--wa-color-text-normal` | |
-| `--wa-color-text-quiet` | |
-| `--wa-color-text-link` | |
+| `--wa-color-text-normal` | AaBb
|
+| `--wa-color-text-quiet` | AaBb
|
+| `--wa-color-text-link` | AaBb
|
### Overlays
@@ -525,8 +525,8 @@ Overlays provide a backdrop to isolate content, often allowing background contex
| Custom Property | Preview |
| ----------------------------- | ------------------------------- |
-| `--wa-color-overlay-modal` | |
-| `--wa-color-overlay-inline` | |
+| `--wa-color-overlay-modal` | |
+| `--wa-color-overlay-inline` | |
### Shadow
@@ -534,7 +534,7 @@ Shadows indicate elevation. `--wa-color-shadow` is used to construct your theme'
| Custom Property | Preview |
| ----------------------------- | ------------------------------- |
-| `--wa-color-shadow` | |
+| `--wa-color-shadow` | |
### Interactions
@@ -544,7 +544,7 @@ Web Awesome uses a single, consistent focus color for predictable keyboard navig
| Custom Property | Preview |
| ----------------------------- | ------------------------------- |
-| `--wa-color-focus` | |
+| `--wa-color-focus` | |
#### Hover and Active
@@ -552,8 +552,8 @@ We leverage `color-mix()` to achieve consistent hover and active states across c
| Custom Property | Preview |
| ----------------------------- | ------------------------------- |
-| `--wa-color-mix-hover` | |
-| `--wa-color-mix-active` | |
+| `--wa-color-mix-hover` | mixed
|
+| `--wa-color-mix-active` | mixed
|
## Semantic Colors
@@ -580,12 +580,12 @@ Finally, each color is named according to how much attention it draws. Here, we
| Custom Property | brand | success | neutral | warning | danger |
| ----------------------------- | ------------------------------- | ------------------------------- | ------------------------------- | ------------------------------- | ------------------------------- |
-| `--wa-color-*-fill-quiet` | | | | | |
-| `--wa-color-*-fill-normal` | | | | | |
-| `--wa-color-*-fill-loud` | | | | | |
-| `--wa-color-*-border-quiet` | | | | | |
-| `--wa-color-*-border-normal` | | | | | |
-| `--wa-color-*-border-loud` | | | | | |
-| `--wa-color-*-on-quiet` | | | | | |
-| `--wa-color-*-on-normal` | | | | | |
-| `--wa-color-*-on-loud` | | | | | |
\ No newline at end of file
+| `--wa-color-*-fill-quiet` | | | | | |
+| `--wa-color-*-fill-normal` | | | | | |
+| `--wa-color-*-fill-loud` | | | | | |
+| `--wa-color-*-border-quiet` | | | | | |
+| `--wa-color-*-border-normal` | | | | | |
+| `--wa-color-*-border-loud` | | | | | |
+| `--wa-color-*-on-quiet` | AaBb
| AaBb
| AaBb
| AaBb
| AaBb
|
+| `--wa-color-*-on-normal` | AaBb
| AaBb
| AaBb
| AaBb
| AaBb
|
+| `--wa-color-*-on-loud` | AaBb
| AaBb
| AaBb
| AaBb
| AaBb
|
\ No newline at end of file
diff --git a/docs/docs/theming/corners.md b/docs/docs/theming/corners.md
deleted file mode 100644
index fb1c68290..000000000
--- a/docs/docs/theming/corners.md
+++ /dev/null
@@ -1,7 +0,0 @@
----
-title: Corners
-description: Sharpen or soften the appearance of your components with Web Awesome's corner properties.
-layout: page.njk
----
-
-coming soon!
\ No newline at end of file
diff --git a/docs/docs/theming/extras.md b/docs/docs/theming/extras.md
index 24c7295c3..37fd8a877 100644
--- a/docs/docs/theming/extras.md
+++ b/docs/docs/theming/extras.md
@@ -5,6 +5,13 @@ layout: page.njk
---
## Focus
+| Custom Property | Preview |
+| ----------------------------- | ------------------------------- |
+| `--wa-color-focus` | |
+| `--wa-focus-ring-style` | |
+| `--wa-focus-ring-width` | |
+| `--wa-focus-ring` | |
+| `--wa-focus-ring-offset` | |
## Links
diff --git a/docs/docs/theming/motion.md b/docs/docs/theming/motion.md
new file mode 100644
index 000000000..4f6ea70a5
--- /dev/null
+++ b/docs/docs/theming/motion.md
@@ -0,0 +1,24 @@
+---
+title: Motion
+description: Customize your theme's built-in transitions and animations with Web Awesome's motion properties.
+layout: page.njk
+---
+
+
+
+## Transitions
+
+| Custom Property | Preview |
+| ----------------------------- | ------------------------------- |
+| `--wa-transition-normal` | |
+| `--wa-transition-fast` | |
+| `--wa-transition-faster` | |
\ No newline at end of file
diff --git a/src/themes/default.css b/src/themes/default.css
index 14bbf6ed5..f5bbc8c1a 100644
--- a/src/themes/default.css
+++ b/src/themes/default.css
@@ -307,7 +307,7 @@
--wa-border-radius-m: calc(var(--wa-border-radius-multiplier) * 2rem);
--wa-border-radius-l: calc(var(--wa-border-radius-multiplier) * 3rem);
- /* Semantic corner properties create specific shapes beyond the theme's preferred corner styles. */
+ /* These common border radius properties can create specific shapes beyond the theme's preferred corner styles. */
--wa-border-radius-pill: 9999px;
--wa-border-radius-circle: 50%;
--wa-border-radius-sharp: 0;
@@ -318,7 +318,7 @@
--wa-focus-ring-style: solid;
--wa-focus-ring-width: 0.1875rem; /* 3px */
--wa-focus-ring: var(--wa-focus-ring-style) var(--wa-focus-ring-width)
- color-mix(in oklab, var(--wa-color-focus) 98%, transparent);
+ color-mix(in oklab, var(--wa-color-focus) 99%, transparent);
--wa-focus-ring-offset: 0.0625rem; /* 1px */
/**