@primer/primitives 11.4.1-rc.eb8ee149 → 11.5.0-rc.14eaeb12

package/dist/internalCss/light-colorblind-high-contrast.css

@@ -350,7 +350,7 @@
   --borderColor-sponsors-muted: var(--base-color-pink-3); /** Subtle border for GitHub Sponsors content */
   --borderColor-success-emphasis: var(--base-color-blue-5); /** Strong success border for prominent positive elements */
   --borderColor-success-muted: var(--base-color-blue-3); /** Subtle success border for positive feedback elements */
-  --borderColor-translucent: var(--base-color-neutral-9); /** Semi-transparent border for overlays and layered elements */
+  --borderColor-translucent: var(--base-color-neutral-9); /** Semi-transparent border for overlays and layered elements. Border-specific token — no bgColor-translucent counterpart exists by design. */
   --borderColor-transparent: var(--base-color-transparent); /** Fully transparent border */
   --borderWidth-default: var(--borderWidth-thin); /** Default border width for most UI elements. Alias of borderWidth.thin (1px) */
   --boxShadow-thick: inset 0 0 0 var(--borderWidth-thick); /** Thick shadow (2px) used instead of a border for emphasis without layout shift */
@@ -358,7 +358,7 @@
   --boxShadow-thin: inset 0 0 0 var(--borderWidth-thin); /** Thin shadow used instead of a border to prevent layout shift */
   --button-danger-bgColor-active: var(--base-color-orange-6);
   --button-danger-borderColor-hover: var(--base-color-orange-7);
-  --button-danger-shadow-selected: inset 0px 1px 0px 0px #43001133;
+  --button-danger-shadow-selected: inset 0 1px 0 0 #43001133;
   --button-inactive-bgColor: var(--base-color-neutral-3);
   --button-inactive-fgColor: var(--base-color-neutral-10);
   --button-invisible-bgColor-disabled: var(--base-color-transparent);
@@ -366,10 +366,10 @@
   --button-invisible-fgColor-hover: var(--base-color-neutral-11);
   --button-invisible-iconColor-hover: var(--base-color-neutral-11);
   --button-outline-borderColor-hover: var(--base-color-blue-7);
-  --button-outline-shadow-selected: inset 0px 1px 0px 0px #021a4a33;
+  --button-outline-shadow-selected: inset 0 1px 0 0 #021a4a33;
   --button-primary-borderColor-disabled: var(--button-primary-bgColor-disabled);
   --button-primary-borderColor-rest: var(--base-color-blue-7);
-  --button-primary-shadow-selected: inset 0px 1px 0px 0px #00230b4d;
+  --button-primary-shadow-selected: inset 0 1px 0 0 #00230b4d;
   --button-star-iconColor: var(--base-color-yellow-2);
   --buttonCounter-default-bgColor-rest: var(--base-color-neutral-7);
   --buttonCounter-outline-fgColor-rest: var(--base-color-blue-6);
@@ -918,13 +918,13 @@
   --reactionButton-selected-fgColor-hover: var(--base-color-blue-6);
   --selectMenu-bgColor-active: var(--base-color-blue-1);
   --selectMenu-borderColor: var(--base-color-transparent);
-  --shadow-floating-legacy: 0px 6px 12px -3px #25292e0a, 0px 6px 18px 0px #25292e1f;
-  --shadow-resting-medium: 0px 1px 1px 0px #25292e1a, 0px 3px 6px 0px #25292e1f;
+  --shadow-floating-legacy: 0 6px 12px -3px #25292e0a, 0 6px 18px 0 #25292e1f; /** Legacy floating shadow for backward compatibility */
+  --shadow-resting-medium: 0 1px 1px 0 #25292e1a, 0 3px 6px 0 #25292e1f; /** Medium resting shadow for cards and elevated surfaces */
   --skeletonLoader-bgColor: var(--base-color-neutral-5);
   --treeViewItem-leadingVisual-iconColor-rest: var(--base-color-blue-3);
   --underlineNav-borderColor-active: var(--base-color-coral-3);
   --avatar-bgColor: var(--base-color-neutral-0);
-  --avatar-shadow: 0px 0px 0px 2px #ffffffcc;
+  --avatar-shadow: 0 0 0 2px #ffffffcc;
   --base-color-inset: var(--base-color-neutral-0);
   --bgColor-black: var(--base-color-neutral-13); /** Pure black background */
   --bgColor-closed-emphasis: var(--bgColor-neutral-emphasis); /** Strong background for closed state badges and labels */
@@ -952,6 +952,7 @@
   --border-sponsors-muted: 0.0625rem solid #ed4baf;
   --border-success-emphasis: 0.0625rem solid #0349b4;
   --border-success-muted: 0.0625rem solid #368cf9;
+  --border-translucent: 0.0625rem solid #59636e; /** Semi-transparent border shorthand for overlays and layered elements. Border-specific token — no bgColor-translucent counterpart exists by design. */
   --border-transparent: 0.0625rem solid #ffffff00;
   --borderColor-closed-muted: var(--borderColor-default); /** Subtle border for closed state indicators */
   --borderColor-draft-emphasis: var(--borderColor-neutral-emphasis); /** Strong border for draft state badges */
@@ -973,7 +974,7 @@
   --button-default-bgColor-rest: var(--control-bgColor-rest);
   --button-default-bgColor-selected: var(--control-bgColor-active);
   --button-default-fgColor-rest: var(--control-fgColor-rest);
-  --button-default-shadow-resting: 0px 1px 0px 0px #0104090a;
+  --button-default-shadow-resting: 0 1px 0 0 #0104090a;
   --button-invisible-bgColor-active: var(--control-transparent-bgColor-active);
   --button-invisible-bgColor-hover: var(--control-transparent-bgColor-hover);
   --button-invisible-bgColor-rest: var(--control-transparent-bgColor-rest);
@@ -1102,9 +1103,9 @@
   --progressBar-bgColor-sponsors: var(--bgColor-sponsors-emphasis);
   --progressBar-bgColor-success: var(--bgColor-success-emphasis);
   --selection-bgColor: #0349b433; /** Background color for text selection highlights */
-  --shadow-inset: inset 0px 1px 0px 0px #0104090a;
-  --shadow-resting-small: 0px 1px 1px 0px #0104090f, 0px 1px 3px 0px #0104090f;
-  --shadow-resting-xsmall: 0px 1px 1px 0px #0104090f;
+  --shadow-inset: inset 0 1px 0 0 #0104090a; /** Inset shadow for recessed elements */
+  --shadow-resting-small: 0 1px 1px 0 #0104090a, 0 1px 2px 0 #01040908; /** Small resting shadow for buttons and interactive elements */
+  --shadow-resting-xsmall: 0 1px 1px 0 #0104090d; /** Extra small resting shadow for minimal elevation */
   --sideNav-bgColor-selected: var(--base-color-neutral-0);
   --timelineBadge-bgColor: var(--bgColor-muted);
   --tooltip-bgColor: var(--bgColor-emphasis);
@@ -1113,6 +1114,8 @@
   --avatar-borderColor: var(--borderColor-emphasis);
   --border-closed-emphasis: var(--border-danger-emphasis);
   --border-closed-muted: var(--border-danger-muted);
+  --border-draft-emphasis: 0.0625rem solid #59636e;
+  --border-draft-muted: 0.0625rem solid #454c54;
   --border-emphasis: 0.0625rem solid #454c54;
   --border-muted: 0.0625rem solid #454c54;
   --border-open-emphasis: var(--border-success-emphasis);
@@ -1123,16 +1126,19 @@
   --borderColor-neutral-muted: var(--borderColor-muted); /** Subtle neutral semantic border */
   --button-danger-bgColor-disabled: var(--control-bgColor-disabled);
   --button-danger-borderColor-rest: var(--control-borderColor-rest);
+  --button-danger-iconColor-disabled: var(--button-danger-fgColor-disabled);
   --button-danger-iconColor-rest: var(--button-danger-fgColor-rest);
   --button-default-bgColor-disabled: var(--control-bgColor-disabled);
   --button-default-borderColor-active: var(--control-borderColor-rest);
   --button-default-borderColor-disabled: var(--control-borderColor-disabled);
   --button-default-borderColor-rest: var(--control-borderColor-rest);
+  --button-default-fgColor-disabled: var(--control-fgColor-disabled);
   --button-invisible-borderColor-hover: var(--control-transparent-borderColor-hover);
   --button-invisible-fgColor-disabled: var(--control-fgColor-disabled);
   --button-invisible-iconColor-disabled: var(--control-fgColor-disabled);
   --button-outline-bgColor-disabled: var(--control-bgColor-disabled);
   --button-primary-fgColor-rest: var(--fgColor-white);
+  --button-primary-iconColor-disabled: var(--button-primary-fgColor-disabled);
   --button-primary-iconColor-rest: #ffffffcc;
   --buttonKeybindingHint-danger-bgColor-disabled: var(--buttonKeybindingHint-default-bgColor-disabled);
   --buttonKeybindingHint-danger-fgColor-active: var(--fgColor-onEmphasis);
@@ -1181,10 +1187,10 @@
   --focus-outline: 2px solid #0349b4; /** Focus ring outline for keyboard navigation and accessibility. */
   --progressBar-track-bgColor: var(--bgColor-default);
   --reactionButton-selected-fgColor-rest: var(--fgColor-link);
-  --shadow-floating-large: 0px 0px 0px 1px #454c54, 0px 40px 80px 0px #25292e3d; /** Large floating shadow for modals and dialogs */
-  --shadow-floating-medium: 0px 0px 0px 1px #454c54, 0px 8px 16px -4px #25292e14, 0px 4px 32px -4px #25292e14, 0px 24px 48px -12px #25292e14, 0px 48px 96px -24px #25292e14;
-  --shadow-floating-small: 0px 0px 0px 1px #454c5480, 0px 6px 12px -3px #25292e0a, 0px 6px 18px 0px #25292e1f; /** Small floating shadow for dropdowns, tooltips, and small overlays */
-  --shadow-floating-xlarge: 0px 0px 0px 1px #454c54, 0px 56px 112px 0px #25292e52;
+  --shadow-floating-large: 0 0 0 1px #454c54, 0 40px 80px 0 #25292e3d; /** Large floating shadow for modals and dialogs */
+  --shadow-floating-medium: 0 0 0 1px #454c54, 0 8px 16px -4px #25292e14, 0 4px 32px -4px #25292e14, 0 24px 48px -12px #25292e14, 0 48px 96px -24px #25292e14; /** Medium floating shadow for popovers and action menus */
+  --shadow-floating-small: 0 0 0 1px #454c5480, 0 6px 12px -3px #25292e0a, 0 6px 18px 0 #25292e1f; /** Small floating shadow for dropdowns, tooltips, and small overlays */
+  --shadow-floating-xlarge: 0 0 0 1px #454c54, 0 56px 112px 0 #25292e52; /** Extra large floating shadow for full-screen overlays and sheets */
   --tooltip-fgColor: var(--fgColor-onEmphasis);
   --underlineNav-borderColor-hover: var(--borderColor-muted);
   --border-neutral-muted: 0.0625rem solid #454c54;
@@ -1546,7 +1552,7 @@
     --borderColor-sponsors-muted: var(--base-color-pink-3); /** Subtle border for GitHub Sponsors content */
     --borderColor-success-emphasis: var(--base-color-blue-5); /** Strong success border for prominent positive elements */
     --borderColor-success-muted: var(--base-color-blue-3); /** Subtle success border for positive feedback elements */
-    --borderColor-translucent: var(--base-color-neutral-9); /** Semi-transparent border for overlays and layered elements */
+    --borderColor-translucent: var(--base-color-neutral-9); /** Semi-transparent border for overlays and layered elements. Border-specific token — no bgColor-translucent counterpart exists by design. */
     --borderColor-transparent: var(--base-color-transparent); /** Fully transparent border */
     --borderWidth-default: var(--borderWidth-thin); /** Default border width for most UI elements. Alias of borderWidth.thin (1px) */
     --boxShadow-thick: inset 0 0 0 var(--borderWidth-thick); /** Thick shadow (2px) used instead of a border for emphasis without layout shift */
@@ -1554,7 +1560,7 @@
     --boxShadow-thin: inset 0 0 0 var(--borderWidth-thin); /** Thin shadow used instead of a border to prevent layout shift */
     --button-danger-bgColor-active: var(--base-color-orange-6);
     --button-danger-borderColor-hover: var(--base-color-orange-7);
-    --button-danger-shadow-selected: inset 0px 1px 0px 0px #43001133;
+    --button-danger-shadow-selected: inset 0 1px 0 0 #43001133;
     --button-inactive-bgColor: var(--base-color-neutral-3);
     --button-inactive-fgColor: var(--base-color-neutral-10);
     --button-invisible-bgColor-disabled: var(--base-color-transparent);
@@ -1562,10 +1568,10 @@
     --button-invisible-fgColor-hover: var(--base-color-neutral-11);
     --button-invisible-iconColor-hover: var(--base-color-neutral-11);
     --button-outline-borderColor-hover: var(--base-color-blue-7);
-    --button-outline-shadow-selected: inset 0px 1px 0px 0px #021a4a33;
+    --button-outline-shadow-selected: inset 0 1px 0 0 #021a4a33;
     --button-primary-borderColor-disabled: var(--button-primary-bgColor-disabled);
     --button-primary-borderColor-rest: var(--base-color-blue-7);
-    --button-primary-shadow-selected: inset 0px 1px 0px 0px #00230b4d;
+    --button-primary-shadow-selected: inset 0 1px 0 0 #00230b4d;
     --button-star-iconColor: var(--base-color-yellow-2);
     --buttonCounter-default-bgColor-rest: var(--base-color-neutral-7);
     --buttonCounter-outline-fgColor-rest: var(--base-color-blue-6);
@@ -2114,13 +2120,13 @@
     --reactionButton-selected-fgColor-hover: var(--base-color-blue-6);
     --selectMenu-bgColor-active: var(--base-color-blue-1);
     --selectMenu-borderColor: var(--base-color-transparent);
-    --shadow-floating-legacy: 0px 6px 12px -3px #25292e0a, 0px 6px 18px 0px #25292e1f;
-    --shadow-resting-medium: 0px 1px 1px 0px #25292e1a, 0px 3px 6px 0px #25292e1f;
+    --shadow-floating-legacy: 0 6px 12px -3px #25292e0a, 0 6px 18px 0 #25292e1f; /** Legacy floating shadow for backward compatibility */
+    --shadow-resting-medium: 0 1px 1px 0 #25292e1a, 0 3px 6px 0 #25292e1f; /** Medium resting shadow for cards and elevated surfaces */
     --skeletonLoader-bgColor: var(--base-color-neutral-5);
     --treeViewItem-leadingVisual-iconColor-rest: var(--base-color-blue-3);
     --underlineNav-borderColor-active: var(--base-color-coral-3);
     --avatar-bgColor: var(--base-color-neutral-0);
-    --avatar-shadow: 0px 0px 0px 2px #ffffffcc;
+    --avatar-shadow: 0 0 0 2px #ffffffcc;
     --base-color-inset: var(--base-color-neutral-0);
     --bgColor-black: var(--base-color-neutral-13); /** Pure black background */
     --bgColor-closed-emphasis: var(--bgColor-neutral-emphasis); /** Strong background for closed state badges and labels */
@@ -2148,6 +2154,7 @@
     --border-sponsors-muted: 0.0625rem solid #ed4baf;
     --border-success-emphasis: 0.0625rem solid #0349b4;
     --border-success-muted: 0.0625rem solid #368cf9;
+    --border-translucent: 0.0625rem solid #59636e; /** Semi-transparent border shorthand for overlays and layered elements. Border-specific token — no bgColor-translucent counterpart exists by design. */
     --border-transparent: 0.0625rem solid #ffffff00;
     --borderColor-closed-muted: var(--borderColor-default); /** Subtle border for closed state indicators */
     --borderColor-draft-emphasis: var(--borderColor-neutral-emphasis); /** Strong border for draft state badges */
@@ -2169,7 +2176,7 @@
     --button-default-bgColor-rest: var(--control-bgColor-rest);
     --button-default-bgColor-selected: var(--control-bgColor-active);
     --button-default-fgColor-rest: var(--control-fgColor-rest);
-    --button-default-shadow-resting: 0px 1px 0px 0px #0104090a;
+    --button-default-shadow-resting: 0 1px 0 0 #0104090a;
     --button-invisible-bgColor-active: var(--control-transparent-bgColor-active);
     --button-invisible-bgColor-hover: var(--control-transparent-bgColor-hover);
     --button-invisible-bgColor-rest: var(--control-transparent-bgColor-rest);
@@ -2298,9 +2305,9 @@
     --progressBar-bgColor-sponsors: var(--bgColor-sponsors-emphasis);
     --progressBar-bgColor-success: var(--bgColor-success-emphasis);
     --selection-bgColor: #0349b433; /** Background color for text selection highlights */
-    --shadow-inset: inset 0px 1px 0px 0px #0104090a;
-    --shadow-resting-small: 0px 1px 1px 0px #0104090f, 0px 1px 3px 0px #0104090f;
-    --shadow-resting-xsmall: 0px 1px 1px 0px #0104090f;
+    --shadow-inset: inset 0 1px 0 0 #0104090a; /** Inset shadow for recessed elements */
+    --shadow-resting-small: 0 1px 1px 0 #0104090a, 0 1px 2px 0 #01040908; /** Small resting shadow for buttons and interactive elements */
+    --shadow-resting-xsmall: 0 1px 1px 0 #0104090d; /** Extra small resting shadow for minimal elevation */
     --sideNav-bgColor-selected: var(--base-color-neutral-0);
     --timelineBadge-bgColor: var(--bgColor-muted);
     --tooltip-bgColor: var(--bgColor-emphasis);
@@ -2309,6 +2316,8 @@
     --avatar-borderColor: var(--borderColor-emphasis);
     --border-closed-emphasis: var(--border-danger-emphasis);
     --border-closed-muted: var(--border-danger-muted);
+    --border-draft-emphasis: 0.0625rem solid #59636e;
+    --border-draft-muted: 0.0625rem solid #454c54;
     --border-emphasis: 0.0625rem solid #454c54;
     --border-muted: 0.0625rem solid #454c54;
     --border-open-emphasis: var(--border-success-emphasis);
@@ -2319,16 +2328,19 @@
     --borderColor-neutral-muted: var(--borderColor-muted); /** Subtle neutral semantic border */
     --button-danger-bgColor-disabled: var(--control-bgColor-disabled);
     --button-danger-borderColor-rest: var(--control-borderColor-rest);
+    --button-danger-iconColor-disabled: var(--button-danger-fgColor-disabled);
     --button-danger-iconColor-rest: var(--button-danger-fgColor-rest);
     --button-default-bgColor-disabled: var(--control-bgColor-disabled);
     --button-default-borderColor-active: var(--control-borderColor-rest);
     --button-default-borderColor-disabled: var(--control-borderColor-disabled);
     --button-default-borderColor-rest: var(--control-borderColor-rest);
+    --button-default-fgColor-disabled: var(--control-fgColor-disabled);
     --button-invisible-borderColor-hover: var(--control-transparent-borderColor-hover);
     --button-invisible-fgColor-disabled: var(--control-fgColor-disabled);
     --button-invisible-iconColor-disabled: var(--control-fgColor-disabled);
     --button-outline-bgColor-disabled: var(--control-bgColor-disabled);
     --button-primary-fgColor-rest: var(--fgColor-white);
+    --button-primary-iconColor-disabled: var(--button-primary-fgColor-disabled);
     --button-primary-iconColor-rest: #ffffffcc;
     --buttonKeybindingHint-danger-bgColor-disabled: var(--buttonKeybindingHint-default-bgColor-disabled);
     --buttonKeybindingHint-danger-fgColor-active: var(--fgColor-onEmphasis);
@@ -2377,10 +2389,10 @@
     --focus-outline: 2px solid #0349b4; /** Focus ring outline for keyboard navigation and accessibility. */
     --progressBar-track-bgColor: var(--bgColor-default);
     --reactionButton-selected-fgColor-rest: var(--fgColor-link);
-    --shadow-floating-large: 0px 0px 0px 1px #454c54, 0px 40px 80px 0px #25292e3d; /** Large floating shadow for modals and dialogs */
-    --shadow-floating-medium: 0px 0px 0px 1px #454c54, 0px 8px 16px -4px #25292e14, 0px 4px 32px -4px #25292e14, 0px 24px 48px -12px #25292e14, 0px 48px 96px -24px #25292e14;
-    --shadow-floating-small: 0px 0px 0px 1px #454c5480, 0px 6px 12px -3px #25292e0a, 0px 6px 18px 0px #25292e1f; /** Small floating shadow for dropdowns, tooltips, and small overlays */
-    --shadow-floating-xlarge: 0px 0px 0px 1px #454c54, 0px 56px 112px 0px #25292e52;
+    --shadow-floating-large: 0 0 0 1px #454c54, 0 40px 80px 0 #25292e3d; /** Large floating shadow for modals and dialogs */
+    --shadow-floating-medium: 0 0 0 1px #454c54, 0 8px 16px -4px #25292e14, 0 4px 32px -4px #25292e14, 0 24px 48px -12px #25292e14, 0 48px 96px -24px #25292e14; /** Medium floating shadow for popovers and action menus */
+    --shadow-floating-small: 0 0 0 1px #454c5480, 0 6px 12px -3px #25292e0a, 0 6px 18px 0 #25292e1f; /** Small floating shadow for dropdowns, tooltips, and small overlays */
+    --shadow-floating-xlarge: 0 0 0 1px #454c54, 0 56px 112px 0 #25292e52; /** Extra large floating shadow for full-screen overlays and sheets */
     --tooltip-fgColor: var(--fgColor-onEmphasis);
     --underlineNav-borderColor-hover: var(--borderColor-muted);
     --border-neutral-muted: 0.0625rem solid #454c54;

package/dist/internalCss/light-colorblind.css

@@ -354,14 +354,14 @@
   --boxShadow-thicker: inset 0 0 0 var(--borderWidth-thicker); /** Thickest shadow (4px) used for high emphasis borders without layout shift. Use sparingly for maximum visual impact */
   --boxShadow-thin: inset 0 0 0 var(--borderWidth-thin); /** Thin shadow used instead of a border to prevent layout shift */
   --button-danger-bgColor-active: var(--base-color-orange-6);
-  --button-danger-shadow-selected: inset 0px 1px 0px 0px #47170033;
+  --button-danger-shadow-selected: inset 0 1px 0 0 #47170033;
   --button-inactive-bgColor: var(--base-color-neutral-3);
   --button-inactive-fgColor: var(--base-color-neutral-9);
   --button-invisible-bgColor-disabled: var(--base-color-transparent);
   --button-invisible-borderColor-disabled: var(--base-color-transparent);
-  --button-outline-shadow-selected: inset 0px 1px 0px 0px #00215533;
+  --button-outline-shadow-selected: inset 0 1px 0 0 #00215533;
   --button-primary-borderColor-disabled: var(--button-primary-bgColor-disabled);
-  --button-primary-shadow-selected: inset 0px 1px 0px 0px #0021554d;
+  --button-primary-shadow-selected: inset 0 1px 0 0 #0021554d;
   --button-star-iconColor: var(--base-color-yellow-2);
   --buttonCounter-danger-fgColor-rest: var(--base-color-orange-6);
   --buttonCounter-outline-fgColor-rest: var(--base-color-blue-6);
@@ -931,14 +931,14 @@
   --reactionButton-selected-fgColor-hover: var(--base-color-blue-6);
   --selectMenu-bgColor-active: var(--base-color-blue-1);
   --selectMenu-borderColor: var(--base-color-transparent);
-  --shadow-floating-legacy: 0px 6px 12px -3px #25292e0a, 0px 6px 18px 0px #25292e1f;
-  --shadow-resting-medium: 0px 1px 1px 0px #25292e1a, 0px 3px 6px 0px #25292e1f;
+  --shadow-floating-legacy: 0 6px 12px -3px #25292e0a, 0 6px 18px 0 #25292e1f; /** Legacy floating shadow for backward compatibility */
+  --shadow-resting-medium: 0 1px 1px 0 #25292e1a, 0 3px 6px 0 #25292e1f; /** Medium resting shadow for cards and elevated surfaces */
   --skeletonLoader-bgColor: #818b981a;
   --topicTag-borderColor: var(--base-color-transparent);
   --treeViewItem-leadingVisual-iconColor-rest: var(--base-color-blue-3);
   --underlineNav-borderColor-active: var(--base-color-coral-3);
   --avatar-bgColor: var(--base-color-neutral-0);
-  --avatar-shadow: 0px 0px 0px 2px #ffffffcc;
+  --avatar-shadow: 0 0 0 2px #ffffffcc;
   --base-color-inset: var(--base-color-neutral-0);
   --bgColor-black: var(--base-color-neutral-13); /** Pure black background */
   --bgColor-closed-emphasis: var(--bgColor-neutral-emphasis); /** Strong background for closed state badges and labels */
@@ -974,7 +974,7 @@
   --borderColor-draft-emphasis: var(--borderColor-neutral-emphasis); /** Strong border for draft state badges */
   --borderColor-draft-muted: #d1d9e066; /** Subtle border for draft state indicators */
   --borderColor-muted: #d1d9e0b3; /** Subtle border for secondary elements and light separators */
-  --borderColor-translucent: #1f232826; /** Semi-transparent border for overlays and layered elements */
+  --borderColor-translucent: #1f232826; /** Semi-transparent border for overlays and layered elements. Border-specific token — no bgColor-translucent counterpart exists by design. */
   --borderColor-upsell-emphasis: var(--borderColor-done-emphasis); /** Strong border for prominent upsell elements */
   --borderColor-upsell-muted: var(--borderColor-done-muted); /** Subtle border for upsell and promotional content */
   --button-danger-bgColor-hover: var(--bgColor-danger-emphasis);
@@ -989,7 +989,7 @@
   --button-default-bgColor-rest: var(--control-bgColor-rest);
   --button-default-bgColor-selected: var(--control-bgColor-active);
   --button-default-fgColor-rest: var(--control-fgColor-rest);
-  --button-default-shadow-resting: 0px 1px 0px 0px #1f23280a;
+  --button-default-shadow-resting: 0 1px 0 0 #1f23280a;
   --button-invisible-bgColor-active: var(--control-transparent-bgColor-active);
   --button-invisible-bgColor-hover: var(--control-transparent-bgColor-hover);
   --button-invisible-bgColor-rest: var(--control-transparent-bgColor-rest);
@@ -1101,9 +1101,9 @@
   --progressBar-bgColor-success: var(--bgColor-success-emphasis);
   --progressBar-track-bgColor: var(--borderColor-default);
   --selection-bgColor: #0969da33; /** Background color for text selection highlights */
-  --shadow-inset: inset 0px 1px 0px 0px #1f23280a;
-  --shadow-resting-small: 0px 1px 1px 0px #1f23280f, 0px 1px 3px 0px #1f23280f;
-  --shadow-resting-xsmall: 0px 1px 1px 0px #1f23280f;
+  --shadow-inset: inset 0 1px 0 0 #1f23280a; /** Inset shadow for recessed elements */
+  --shadow-resting-small: 0 1px 1px 0 #1f23280a, 0 1px 2px 0 #1f232808; /** Small resting shadow for buttons and interactive elements */
+  --shadow-resting-xsmall: 0 1px 1px 0 #1f23280d; /** Extra small resting shadow for minimal elevation */
   --sideNav-bgColor-selected: var(--base-color-neutral-0);
   --timelineBadge-bgColor: var(--bgColor-muted);
   --tooltip-bgColor: var(--bgColor-emphasis);
@@ -1111,24 +1111,30 @@
   --avatar-borderColor: var(--borderColor-translucent);
   --border-closed-emphasis: var(--border-danger-emphasis);
   --border-closed-muted: var(--border-danger-muted);
+  --border-draft-emphasis: 0.0625rem solid #59636e;
+  --border-draft-muted: 0.0625rem solid #d1d9e066;
   --border-muted: 0.0625rem solid #d1d9e0b3;
   --border-open-emphasis: var(--border-success-emphasis);
   --border-open-muted: var(--border-success-muted);
+  --border-translucent: 0.0625rem solid #1f232826; /** Semi-transparent border shorthand for overlays and layered elements. Border-specific token — no bgColor-translucent counterpart exists by design. */
   --border-upsell-emphasis: 0.0625rem solid #8250df;
   --border-upsell-muted: 0.0625rem solid #c297ff66;
   --borderColor-neutral-muted: var(--borderColor-muted); /** Subtle neutral semantic border */
   --button-danger-bgColor-disabled: var(--control-bgColor-disabled);
   --button-danger-borderColor-rest: var(--control-borderColor-rest);
+  --button-danger-iconColor-disabled: var(--button-danger-fgColor-disabled);
   --button-danger-iconColor-rest: var(--button-danger-fgColor-rest);
   --button-default-bgColor-disabled: var(--control-bgColor-disabled);
   --button-default-borderColor-active: var(--control-borderColor-rest);
   --button-default-borderColor-disabled: var(--control-borderColor-disabled);
   --button-default-borderColor-rest: var(--control-borderColor-rest);
+  --button-default-fgColor-disabled: var(--control-fgColor-disabled);
   --button-invisible-fgColor-disabled: var(--control-fgColor-disabled);
   --button-invisible-iconColor-disabled: var(--control-fgColor-disabled);
   --button-outline-bgColor-disabled: var(--control-bgColor-disabled);
   --button-primary-borderColor-rest: var(--borderColor-translucent);
   --button-primary-fgColor-rest: var(--fgColor-white);
+  --button-primary-iconColor-disabled: var(--button-primary-fgColor-disabled);
   --button-primary-iconColor-rest: #ffffffcc;
   --buttonKeybindingHint-danger-bgColor-disabled: var(--buttonKeybindingHint-default-bgColor-disabled);
   --buttonKeybindingHint-danger-borderColor-hover: var(--borderColor-translucent);
@@ -1186,10 +1192,10 @@
   --buttonKeybindingHint-danger-borderColor-disabled: var(--buttonKeybindingHint-default-borderColor-disabled);
   --buttonKeybindingHint-danger-borderColor-rest: var(--buttonKeybindingHint-default-borderColor-rest);
   --buttonKeybindingHint-danger-fgColor-disabled: var(--buttonKeybindingHint-default-fgColor-disabled);
-  --shadow-floating-large: 0px 0px 0px 1px #d1d9e0, 0px 40px 80px 0px #25292e3d; /** Large floating shadow for modals and dialogs */
-  --shadow-floating-medium: 0px 0px 0px 1px #d1d9e0, 0px 8px 16px -4px #25292e14, 0px 4px 32px -4px #25292e14, 0px 24px 48px -12px #25292e14, 0px 48px 96px -24px #25292e14;
-  --shadow-floating-small: 0px 0px 0px 1px #d1d9e080, 0px 6px 12px -3px #25292e0a, 0px 6px 18px 0px #25292e1f; /** Small floating shadow for dropdowns, tooltips, and small overlays */
-  --shadow-floating-xlarge: 0px 0px 0px 1px #d1d9e0, 0px 56px 112px 0px #25292e52;
+  --shadow-floating-large: 0 0 0 1px #d1d9e000, 0 40px 80px 0 #25292e3d; /** Large floating shadow for modals and dialogs */
+  --shadow-floating-medium: 0 0 0 1px #d1d9e000, 0 8px 16px -4px #25292e14, 0 4px 32px -4px #25292e14, 0 24px 48px -12px #25292e14, 0 48px 96px -24px #25292e14; /** Medium floating shadow for popovers and action menus */
+  --shadow-floating-small: 0 0 0 1px #d1d9e080, 0 6px 12px -3px #25292e0a, 0 6px 18px 0 #25292e1f; /** Small floating shadow for dropdowns, tooltips, and small overlays */
+  --shadow-floating-xlarge: 0 0 0 1px #d1d9e000, 0 56px 112px 0 #25292e52; /** Extra large floating shadow for full-screen overlays and sheets */
   --button-danger-borderColor-active: var(--button-danger-borderColor-hover);
   --button-outline-borderColor-hover: var(--button-primary-borderColor-hover);
   --button-outline-borderColor-active: var(--button-outline-borderColor-hover);
@@ -1550,14 +1556,14 @@
     --boxShadow-thicker: inset 0 0 0 var(--borderWidth-thicker); /** Thickest shadow (4px) used for high emphasis borders without layout shift. Use sparingly for maximum visual impact */
     --boxShadow-thin: inset 0 0 0 var(--borderWidth-thin); /** Thin shadow used instead of a border to prevent layout shift */
     --button-danger-bgColor-active: var(--base-color-orange-6);
-    --button-danger-shadow-selected: inset 0px 1px 0px 0px #47170033;
+    --button-danger-shadow-selected: inset 0 1px 0 0 #47170033;
     --button-inactive-bgColor: var(--base-color-neutral-3);
     --button-inactive-fgColor: var(--base-color-neutral-9);
     --button-invisible-bgColor-disabled: var(--base-color-transparent);
     --button-invisible-borderColor-disabled: var(--base-color-transparent);
-    --button-outline-shadow-selected: inset 0px 1px 0px 0px #00215533;
+    --button-outline-shadow-selected: inset 0 1px 0 0 #00215533;
     --button-primary-borderColor-disabled: var(--button-primary-bgColor-disabled);
-    --button-primary-shadow-selected: inset 0px 1px 0px 0px #0021554d;
+    --button-primary-shadow-selected: inset 0 1px 0 0 #0021554d;
     --button-star-iconColor: var(--base-color-yellow-2);
     --buttonCounter-danger-fgColor-rest: var(--base-color-orange-6);
     --buttonCounter-outline-fgColor-rest: var(--base-color-blue-6);
@@ -2127,14 +2133,14 @@
     --reactionButton-selected-fgColor-hover: var(--base-color-blue-6);
     --selectMenu-bgColor-active: var(--base-color-blue-1);
     --selectMenu-borderColor: var(--base-color-transparent);
-    --shadow-floating-legacy: 0px 6px 12px -3px #25292e0a, 0px 6px 18px 0px #25292e1f;
-    --shadow-resting-medium: 0px 1px 1px 0px #25292e1a, 0px 3px 6px 0px #25292e1f;
+    --shadow-floating-legacy: 0 6px 12px -3px #25292e0a, 0 6px 18px 0 #25292e1f; /** Legacy floating shadow for backward compatibility */
+    --shadow-resting-medium: 0 1px 1px 0 #25292e1a, 0 3px 6px 0 #25292e1f; /** Medium resting shadow for cards and elevated surfaces */
     --skeletonLoader-bgColor: #818b981a;
     --topicTag-borderColor: var(--base-color-transparent);
     --treeViewItem-leadingVisual-iconColor-rest: var(--base-color-blue-3);
     --underlineNav-borderColor-active: var(--base-color-coral-3);
     --avatar-bgColor: var(--base-color-neutral-0);
-    --avatar-shadow: 0px 0px 0px 2px #ffffffcc;
+    --avatar-shadow: 0 0 0 2px #ffffffcc;
     --base-color-inset: var(--base-color-neutral-0);
     --bgColor-black: var(--base-color-neutral-13); /** Pure black background */
     --bgColor-closed-emphasis: var(--bgColor-neutral-emphasis); /** Strong background for closed state badges and labels */
@@ -2170,7 +2176,7 @@
     --borderColor-draft-emphasis: var(--borderColor-neutral-emphasis); /** Strong border for draft state badges */
     --borderColor-draft-muted: #d1d9e066; /** Subtle border for draft state indicators */
     --borderColor-muted: #d1d9e0b3; /** Subtle border for secondary elements and light separators */
-    --borderColor-translucent: #1f232826; /** Semi-transparent border for overlays and layered elements */
+    --borderColor-translucent: #1f232826; /** Semi-transparent border for overlays and layered elements. Border-specific token — no bgColor-translucent counterpart exists by design. */
     --borderColor-upsell-emphasis: var(--borderColor-done-emphasis); /** Strong border for prominent upsell elements */
     --borderColor-upsell-muted: var(--borderColor-done-muted); /** Subtle border for upsell and promotional content */
     --button-danger-bgColor-hover: var(--bgColor-danger-emphasis);
@@ -2185,7 +2191,7 @@
     --button-default-bgColor-rest: var(--control-bgColor-rest);
     --button-default-bgColor-selected: var(--control-bgColor-active);
     --button-default-fgColor-rest: var(--control-fgColor-rest);
-    --button-default-shadow-resting: 0px 1px 0px 0px #1f23280a;
+    --button-default-shadow-resting: 0 1px 0 0 #1f23280a;
     --button-invisible-bgColor-active: var(--control-transparent-bgColor-active);
     --button-invisible-bgColor-hover: var(--control-transparent-bgColor-hover);
     --button-invisible-bgColor-rest: var(--control-transparent-bgColor-rest);
@@ -2297,9 +2303,9 @@
     --progressBar-bgColor-success: var(--bgColor-success-emphasis);
     --progressBar-track-bgColor: var(--borderColor-default);
     --selection-bgColor: #0969da33; /** Background color for text selection highlights */
-    --shadow-inset: inset 0px 1px 0px 0px #1f23280a;
-    --shadow-resting-small: 0px 1px 1px 0px #1f23280f, 0px 1px 3px 0px #1f23280f;
-    --shadow-resting-xsmall: 0px 1px 1px 0px #1f23280f;
+    --shadow-inset: inset 0 1px 0 0 #1f23280a; /** Inset shadow for recessed elements */
+    --shadow-resting-small: 0 1px 1px 0 #1f23280a, 0 1px 2px 0 #1f232808; /** Small resting shadow for buttons and interactive elements */
+    --shadow-resting-xsmall: 0 1px 1px 0 #1f23280d; /** Extra small resting shadow for minimal elevation */
     --sideNav-bgColor-selected: var(--base-color-neutral-0);
     --timelineBadge-bgColor: var(--bgColor-muted);
     --tooltip-bgColor: var(--bgColor-emphasis);
@@ -2307,24 +2313,30 @@
     --avatar-borderColor: var(--borderColor-translucent);
     --border-closed-emphasis: var(--border-danger-emphasis);
     --border-closed-muted: var(--border-danger-muted);
+    --border-draft-emphasis: 0.0625rem solid #59636e;
+    --border-draft-muted: 0.0625rem solid #d1d9e066;
     --border-muted: 0.0625rem solid #d1d9e0b3;
     --border-open-emphasis: var(--border-success-emphasis);
     --border-open-muted: var(--border-success-muted);
+    --border-translucent: 0.0625rem solid #1f232826; /** Semi-transparent border shorthand for overlays and layered elements. Border-specific token — no bgColor-translucent counterpart exists by design. */
     --border-upsell-emphasis: 0.0625rem solid #8250df;
     --border-upsell-muted: 0.0625rem solid #c297ff66;
     --borderColor-neutral-muted: var(--borderColor-muted); /** Subtle neutral semantic border */
     --button-danger-bgColor-disabled: var(--control-bgColor-disabled);
     --button-danger-borderColor-rest: var(--control-borderColor-rest);
+    --button-danger-iconColor-disabled: var(--button-danger-fgColor-disabled);
     --button-danger-iconColor-rest: var(--button-danger-fgColor-rest);
     --button-default-bgColor-disabled: var(--control-bgColor-disabled);
     --button-default-borderColor-active: var(--control-borderColor-rest);
     --button-default-borderColor-disabled: var(--control-borderColor-disabled);
     --button-default-borderColor-rest: var(--control-borderColor-rest);
+    --button-default-fgColor-disabled: var(--control-fgColor-disabled);
     --button-invisible-fgColor-disabled: var(--control-fgColor-disabled);
     --button-invisible-iconColor-disabled: var(--control-fgColor-disabled);
     --button-outline-bgColor-disabled: var(--control-bgColor-disabled);
     --button-primary-borderColor-rest: var(--borderColor-translucent);
     --button-primary-fgColor-rest: var(--fgColor-white);
+    --button-primary-iconColor-disabled: var(--button-primary-fgColor-disabled);
     --button-primary-iconColor-rest: #ffffffcc;
     --buttonKeybindingHint-danger-bgColor-disabled: var(--buttonKeybindingHint-default-bgColor-disabled);
     --buttonKeybindingHint-danger-borderColor-hover: var(--borderColor-translucent);
@@ -2382,10 +2394,10 @@
     --buttonKeybindingHint-danger-borderColor-disabled: var(--buttonKeybindingHint-default-borderColor-disabled);
     --buttonKeybindingHint-danger-borderColor-rest: var(--buttonKeybindingHint-default-borderColor-rest);
     --buttonKeybindingHint-danger-fgColor-disabled: var(--buttonKeybindingHint-default-fgColor-disabled);
-    --shadow-floating-large: 0px 0px 0px 1px #d1d9e0, 0px 40px 80px 0px #25292e3d; /** Large floating shadow for modals and dialogs */
-    --shadow-floating-medium: 0px 0px 0px 1px #d1d9e0, 0px 8px 16px -4px #25292e14, 0px 4px 32px -4px #25292e14, 0px 24px 48px -12px #25292e14, 0px 48px 96px -24px #25292e14;
-    --shadow-floating-small: 0px 0px 0px 1px #d1d9e080, 0px 6px 12px -3px #25292e0a, 0px 6px 18px 0px #25292e1f; /** Small floating shadow for dropdowns, tooltips, and small overlays */
-    --shadow-floating-xlarge: 0px 0px 0px 1px #d1d9e0, 0px 56px 112px 0px #25292e52;
+    --shadow-floating-large: 0 0 0 1px #d1d9e000, 0 40px 80px 0 #25292e3d; /** Large floating shadow for modals and dialogs */
+    --shadow-floating-medium: 0 0 0 1px #d1d9e000, 0 8px 16px -4px #25292e14, 0 4px 32px -4px #25292e14, 0 24px 48px -12px #25292e14, 0 48px 96px -24px #25292e14; /** Medium floating shadow for popovers and action menus */
+    --shadow-floating-small: 0 0 0 1px #d1d9e080, 0 6px 12px -3px #25292e0a, 0 6px 18px 0 #25292e1f; /** Small floating shadow for dropdowns, tooltips, and small overlays */
+    --shadow-floating-xlarge: 0 0 0 1px #d1d9e000, 0 56px 112px 0 #25292e52; /** Extra large floating shadow for full-screen overlays and sheets */
     --button-danger-borderColor-active: var(--button-danger-borderColor-hover);
     --button-outline-borderColor-hover: var(--button-primary-borderColor-hover);
     --button-outline-borderColor-active: var(--button-outline-borderColor-hover);