@salemcobalt/tokens 0.2.0-rc.3 → 0.2.0-rc.5

package/README.md

@@ -10,3 +10,23 @@ Design tokens for the Salem Cobalt design system. One Style Dictionary source (`
 | `@salemcobalt/tokens/json` | `dist/json/tokens.json`       | `{ light, dark }` flat maps of resolved values.                                                                                                                                                    |
 
 `src/` is the source of truth. `scripts/generate-color.mjs` regenerates the color primitives and the themed color and elevation tokens from OKLCH parameters; run it only when the palette itself changes, then review the diff. `pnpm test` checks every documented text/surface pair against WCAG AA in both themes.
+
+## Layering
+
+`--sc-z-*` is one ordered ladder; every fixed or portaled surface in `@salemcobalt/ui` takes its `z-index` from it and
+nothing else sets one. Popups sit above dialogs on purpose: a Menu, Select or Popover opened from inside a Dialog
+renders over it, and a Tooltip over that.
+
+| Token             | Value | Used by                                                            |
+| ----------------- | ----- | ------------------------------------------------------------------ |
+| `--sc-z-base`     | 0     | Normal flow.                                                       |
+| `--sc-z-raised`   | 1     | Hover and focus rings over siblings.                               |
+| `--sc-z-sticky`   | 100   | Pinned chrome inside the page: sticky Toolbar, Banner, Table head. |
+| `--sc-z-backdrop` | 1100  | Dialog scrim.                                                      |
+| `--sc-z-dialog`   | 1200  | Dialog popup and sheet.                                            |
+| `--sc-z-dropdown` | 1300  | Menu, Select and Popover positioners, so they open over a Dialog.  |
+| `--sc-z-toast`    | 1400  | Toasts.                                                            |
+| `--sc-z-tooltip`  | 1500  | Tooltips, above everything.                                        |
+
+An app that pins its own chrome (a header, a bottom bar) should use `--sc-z-sticky` or a value below
+`--sc-z-backdrop` so dialogs still cover it. `pnpm test` asserts the order.

package/dist/css/tokens.css

@@ -1,4 +1,4 @@
-/* @salemcobalt/tokens 0.2.0-rc.3 — generated from src/ by Style Dictionary. Do not edit. */
+/* @salemcobalt/tokens 0.2.0-rc.5 — generated from src/ by Style Dictionary. Do not edit. */
 :root, [data-theme="light"] {
   color-scheme: light;
   --sc-color-white: #ffffff; /** Primitive. */
@@ -74,12 +74,12 @@
   --sc-color-surface-backdrop: #0b0d1699; /** Dialog scrim, 60% alpha. */
   --sc-z-base: 0; /** Normal flow. */
   --sc-z-raised: 1; /** Hover and focus rings over siblings. */
-  --sc-z-sticky: 100; /** Sticky headers and table heads. */
-  --sc-z-dropdown: 1000; /** Menus, selects, popovers. */
+  --sc-z-sticky: 100; /** Pinned chrome inside the page: sticky Toolbar, Banner, Table head. */
   --sc-z-backdrop: 1100; /** Dialog scrim. */
-  --sc-z-dialog: 1200; /** Dialog popup. */
-  --sc-z-toast: 1300; /** Toasts. */
-  --sc-z-tooltip: 1400; /** Tooltips, above everything. */
+  --sc-z-dialog: 1200; /** Dialog popup and sheet. */
+  --sc-z-dropdown: 1300; /** Menus, selects, popovers. Above dialog so a popup opened from inside one shows over it. */
+  --sc-z-toast: 1400; /** Toasts, above open popups. */
+  --sc-z-tooltip: 1500; /** Tooltips, above everything. */
   --sc-duration-fast: 100ms; /** Hover and press color changes. */
   --sc-duration-base: 200ms; /** Dialog enter, backdrop fade. */
   --sc-duration-slow: 300ms; /** Layout shifts, panels sliding. */

package/dist/js/tokens.d.ts

@@ -1,4 +1,4 @@
-/* @salemcobalt/tokens 0.2.0-rc.3 — generated from src/ by Style Dictionary. Do not edit. */
+/* @salemcobalt/tokens 0.2.0-rc.5 — generated from src/ by Style Dictionary. Do not edit. */
 export declare const prefix: "sc";
 export declare const tokens: {
   color: {
@@ -241,11 +241,11 @@ export declare const tokens: {
     base: 0,
     raised: 1,
     sticky: 100,
-    dropdown: 1000,
     backdrop: 1100,
     dialog: 1200,
-    toast: 1300,
-    tooltip: 1400
+    dropdown: 1300,
+    toast: 1400,
+    tooltip: 1500
   },
   duration: {
     fast: "100ms",
@@ -370,7 +370,7 @@ export declare const tokens: {
     }
   }
 };
-export type TokenName = "color-white" | "color-black" | "color-neutral-0" | "color-neutral-50" | "color-neutral-100" | "color-neutral-200" | "color-neutral-300" | "color-neutral-400" | "color-neutral-500" | "color-neutral-600" | "color-neutral-700" | "color-neutral-800" | "color-neutral-900" | "color-neutral-950" | "color-neutral-1000" | "color-brand-50" | "color-brand-100" | "color-brand-200" | "color-brand-300" | "color-brand-400" | "color-brand-500" | "color-brand-600" | "color-brand-700" | "color-brand-800" | "color-brand-900" | "color-brand-950" | "color-green-50" | "color-green-100" | "color-green-200" | "color-green-300" | "color-green-400" | "color-green-500" | "color-green-600" | "color-green-700" | "color-green-800" | "color-green-900" | "color-green-950" | "color-amber-50" | "color-amber-100" | "color-amber-200" | "color-amber-300" | "color-amber-400" | "color-amber-500" | "color-amber-600" | "color-amber-700" | "color-amber-800" | "color-amber-900" | "color-amber-950" | "color-red-50" | "color-red-100" | "color-red-200" | "color-red-300" | "color-red-400" | "color-red-500" | "color-red-600" | "color-red-700" | "color-red-800" | "color-red-900" | "color-red-950" | "color-teal-50" | "color-teal-100" | "color-teal-200" | "color-teal-300" | "color-teal-400" | "color-teal-500" | "color-teal-600" | "color-teal-700" | "color-teal-800" | "color-teal-900" | "color-teal-950" | "color-surface-canvas" | "color-surface-default" | "color-surface-raised" | "color-surface-sunken" | "color-surface-hover" | "color-surface-active" | "color-surface-backdrop" | "color-text-default" | "color-text-muted" | "color-text-subtle" | "color-text-on-accent" | "color-text-on-status" | "color-text-link" | "color-border-default" | "color-border-strong" | "color-border-focus" | "color-accent-default" | "color-accent-hover" | "color-accent-active" | "color-accent-subtle" | "color-accent-text" | "color-success-subtle" | "color-success-text" | "color-success-solid" | "color-warning-subtle" | "color-warning-text" | "color-warning-solid" | "color-info-subtle" | "color-info-text" | "color-info-solid" | "color-danger-subtle" | "color-danger-text" | "color-danger-solid" | "color-danger-hover" | "z-base" | "z-raised" | "z-sticky" | "z-dropdown" | "z-backdrop" | "z-dialog" | "z-toast" | "z-tooltip" | "duration-fast" | "duration-base" | "duration-slow" | "duration-slower" | "ease-standard" | "ease-enter" | "ease-exit" | "radius-none" | "radius-xs" | "radius-sm" | "radius-md" | "radius-lg" | "radius-xl" | "radius-2xl" | "radius-full" | "size-control-sm" | "size-control-md" | "size-control-lg" | "size-control-compact-sm" | "size-control-compact-md" | "size-control-compact-lg" | "size-touch-target" | "size-badge-sm" | "size-badge-md" | "size-icon-xs" | "size-icon-sm" | "size-icon-md" | "size-icon-lg" | "size-icon-xl" | "size-dialog-sm" | "size-dialog-md" | "size-dialog-lg" | "border-width-hairline" | "border-width-focus" | "spacing-none" | "spacing-3xs" | "spacing-2xs" | "spacing-xs" | "spacing-sm" | "spacing-md" | "spacing-lg" | "spacing-xl" | "spacing-2xl" | "spacing-3xl" | "spacing-4xl" | "font-family-sans" | "font-family-mono" | "font-size-xs" | "font-size-sm" | "font-size-md" | "font-size-lg" | "font-size-xl" | "font-size-2xl" | "font-size-3xl" | "font-size-4xl" | "font-size-5xl" | "font-weight-regular" | "font-weight-medium" | "font-weight-semibold" | "font-line-height-tight" | "font-line-height-snug" | "font-line-height-normal" | "font-line-height-ui" | "font-tracking-tight" | "font-tracking-snug" | "font-tracking-normal" | "font-tracking-wide" | "font-measure" | "elevation-0" | "elevation-1" | "elevation-2" | "elevation-3";
+export type TokenName = "color-white" | "color-black" | "color-neutral-0" | "color-neutral-50" | "color-neutral-100" | "color-neutral-200" | "color-neutral-300" | "color-neutral-400" | "color-neutral-500" | "color-neutral-600" | "color-neutral-700" | "color-neutral-800" | "color-neutral-900" | "color-neutral-950" | "color-neutral-1000" | "color-brand-50" | "color-brand-100" | "color-brand-200" | "color-brand-300" | "color-brand-400" | "color-brand-500" | "color-brand-600" | "color-brand-700" | "color-brand-800" | "color-brand-900" | "color-brand-950" | "color-green-50" | "color-green-100" | "color-green-200" | "color-green-300" | "color-green-400" | "color-green-500" | "color-green-600" | "color-green-700" | "color-green-800" | "color-green-900" | "color-green-950" | "color-amber-50" | "color-amber-100" | "color-amber-200" | "color-amber-300" | "color-amber-400" | "color-amber-500" | "color-amber-600" | "color-amber-700" | "color-amber-800" | "color-amber-900" | "color-amber-950" | "color-red-50" | "color-red-100" | "color-red-200" | "color-red-300" | "color-red-400" | "color-red-500" | "color-red-600" | "color-red-700" | "color-red-800" | "color-red-900" | "color-red-950" | "color-teal-50" | "color-teal-100" | "color-teal-200" | "color-teal-300" | "color-teal-400" | "color-teal-500" | "color-teal-600" | "color-teal-700" | "color-teal-800" | "color-teal-900" | "color-teal-950" | "color-surface-canvas" | "color-surface-default" | "color-surface-raised" | "color-surface-sunken" | "color-surface-hover" | "color-surface-active" | "color-surface-backdrop" | "color-text-default" | "color-text-muted" | "color-text-subtle" | "color-text-on-accent" | "color-text-on-status" | "color-text-link" | "color-border-default" | "color-border-strong" | "color-border-focus" | "color-accent-default" | "color-accent-hover" | "color-accent-active" | "color-accent-subtle" | "color-accent-text" | "color-success-subtle" | "color-success-text" | "color-success-solid" | "color-warning-subtle" | "color-warning-text" | "color-warning-solid" | "color-info-subtle" | "color-info-text" | "color-info-solid" | "color-danger-subtle" | "color-danger-text" | "color-danger-solid" | "color-danger-hover" | "z-base" | "z-raised" | "z-sticky" | "z-backdrop" | "z-dialog" | "z-dropdown" | "z-toast" | "z-tooltip" | "duration-fast" | "duration-base" | "duration-slow" | "duration-slower" | "ease-standard" | "ease-enter" | "ease-exit" | "radius-none" | "radius-xs" | "radius-sm" | "radius-md" | "radius-lg" | "radius-xl" | "radius-2xl" | "radius-full" | "size-control-sm" | "size-control-md" | "size-control-lg" | "size-control-compact-sm" | "size-control-compact-md" | "size-control-compact-lg" | "size-touch-target" | "size-badge-sm" | "size-badge-md" | "size-icon-xs" | "size-icon-sm" | "size-icon-md" | "size-icon-lg" | "size-icon-xl" | "size-dialog-sm" | "size-dialog-md" | "size-dialog-lg" | "border-width-hairline" | "border-width-focus" | "spacing-none" | "spacing-3xs" | "spacing-2xs" | "spacing-xs" | "spacing-sm" | "spacing-md" | "spacing-lg" | "spacing-xl" | "spacing-2xl" | "spacing-3xl" | "spacing-4xl" | "font-family-sans" | "font-family-mono" | "font-size-xs" | "font-size-sm" | "font-size-md" | "font-size-lg" | "font-size-xl" | "font-size-2xl" | "font-size-3xl" | "font-size-4xl" | "font-size-5xl" | "font-weight-regular" | "font-weight-medium" | "font-weight-semibold" | "font-line-height-tight" | "font-line-height-snug" | "font-line-height-normal" | "font-line-height-ui" | "font-tracking-tight" | "font-tracking-snug" | "font-tracking-normal" | "font-tracking-wide" | "font-measure" | "elevation-0" | "elevation-1" | "elevation-2" | "elevation-3";
 export declare const tokenNames: readonly TokenName[];
 export type Theme = 'light' | 'dark';
 export declare const cssVar: (name: TokenName) => `var(--sc-${TokenName})`;

package/dist/js/tokens.js

@@ -1,4 +1,4 @@
-/* @salemcobalt/tokens 0.2.0-rc.3 — generated from src/ by Style Dictionary. Do not edit. */
+/* @salemcobalt/tokens 0.2.0-rc.5 — generated from src/ by Style Dictionary. Do not edit. */
 export const prefix = "sc";
 export const tokens = {
   "color": {
@@ -241,11 +241,11 @@ export const tokens = {
     "base": 0,
     "raised": 1,
     "sticky": 100,
-    "dropdown": 1000,
     "backdrop": 1100,
     "dialog": 1200,
-    "toast": 1300,
-    "tooltip": 1400
+    "dropdown": 1300,
+    "toast": 1400,
+    "tooltip": 1500
   },
   "duration": {
     "fast": "100ms",
@@ -370,5 +370,5 @@ export const tokens = {
     }
   }
 };
-export const tokenNames = ["color-white","color-black","color-neutral-0","color-neutral-50","color-neutral-100","color-neutral-200","color-neutral-300","color-neutral-400","color-neutral-500","color-neutral-600","color-neutral-700","color-neutral-800","color-neutral-900","color-neutral-950","color-neutral-1000","color-brand-50","color-brand-100","color-brand-200","color-brand-300","color-brand-400","color-brand-500","color-brand-600","color-brand-700","color-brand-800","color-brand-900","color-brand-950","color-green-50","color-green-100","color-green-200","color-green-300","color-green-400","color-green-500","color-green-600","color-green-700","color-green-800","color-green-900","color-green-950","color-amber-50","color-amber-100","color-amber-200","color-amber-300","color-amber-400","color-amber-500","color-amber-600","color-amber-700","color-amber-800","color-amber-900","color-amber-950","color-red-50","color-red-100","color-red-200","color-red-300","color-red-400","color-red-500","color-red-600","color-red-700","color-red-800","color-red-900","color-red-950","color-teal-50","color-teal-100","color-teal-200","color-teal-300","color-teal-400","color-teal-500","color-teal-600","color-teal-700","color-teal-800","color-teal-900","color-teal-950","color-surface-canvas","color-surface-default","color-surface-raised","color-surface-sunken","color-surface-hover","color-surface-active","color-surface-backdrop","color-text-default","color-text-muted","color-text-subtle","color-text-on-accent","color-text-on-status","color-text-link","color-border-default","color-border-strong","color-border-focus","color-accent-default","color-accent-hover","color-accent-active","color-accent-subtle","color-accent-text","color-success-subtle","color-success-text","color-success-solid","color-warning-subtle","color-warning-text","color-warning-solid","color-info-subtle","color-info-text","color-info-solid","color-danger-subtle","color-danger-text","color-danger-solid","color-danger-hover","z-base","z-raised","z-sticky","z-dropdown","z-backdrop","z-dialog","z-toast","z-tooltip","duration-fast","duration-base","duration-slow","duration-slower","ease-standard","ease-enter","ease-exit","radius-none","radius-xs","radius-sm","radius-md","radius-lg","radius-xl","radius-2xl","radius-full","size-control-sm","size-control-md","size-control-lg","size-control-compact-sm","size-control-compact-md","size-control-compact-lg","size-touch-target","size-badge-sm","size-badge-md","size-icon-xs","size-icon-sm","size-icon-md","size-icon-lg","size-icon-xl","size-dialog-sm","size-dialog-md","size-dialog-lg","border-width-hairline","border-width-focus","spacing-none","spacing-3xs","spacing-2xs","spacing-xs","spacing-sm","spacing-md","spacing-lg","spacing-xl","spacing-2xl","spacing-3xl","spacing-4xl","font-family-sans","font-family-mono","font-size-xs","font-size-sm","font-size-md","font-size-lg","font-size-xl","font-size-2xl","font-size-3xl","font-size-4xl","font-size-5xl","font-weight-regular","font-weight-medium","font-weight-semibold","font-line-height-tight","font-line-height-snug","font-line-height-normal","font-line-height-ui","font-tracking-tight","font-tracking-snug","font-tracking-normal","font-tracking-wide","font-measure","elevation-0","elevation-1","elevation-2","elevation-3"];
+export const tokenNames = ["color-white","color-black","color-neutral-0","color-neutral-50","color-neutral-100","color-neutral-200","color-neutral-300","color-neutral-400","color-neutral-500","color-neutral-600","color-neutral-700","color-neutral-800","color-neutral-900","color-neutral-950","color-neutral-1000","color-brand-50","color-brand-100","color-brand-200","color-brand-300","color-brand-400","color-brand-500","color-brand-600","color-brand-700","color-brand-800","color-brand-900","color-brand-950","color-green-50","color-green-100","color-green-200","color-green-300","color-green-400","color-green-500","color-green-600","color-green-700","color-green-800","color-green-900","color-green-950","color-amber-50","color-amber-100","color-amber-200","color-amber-300","color-amber-400","color-amber-500","color-amber-600","color-amber-700","color-amber-800","color-amber-900","color-amber-950","color-red-50","color-red-100","color-red-200","color-red-300","color-red-400","color-red-500","color-red-600","color-red-700","color-red-800","color-red-900","color-red-950","color-teal-50","color-teal-100","color-teal-200","color-teal-300","color-teal-400","color-teal-500","color-teal-600","color-teal-700","color-teal-800","color-teal-900","color-teal-950","color-surface-canvas","color-surface-default","color-surface-raised","color-surface-sunken","color-surface-hover","color-surface-active","color-surface-backdrop","color-text-default","color-text-muted","color-text-subtle","color-text-on-accent","color-text-on-status","color-text-link","color-border-default","color-border-strong","color-border-focus","color-accent-default","color-accent-hover","color-accent-active","color-accent-subtle","color-accent-text","color-success-subtle","color-success-text","color-success-solid","color-warning-subtle","color-warning-text","color-warning-solid","color-info-subtle","color-info-text","color-info-solid","color-danger-subtle","color-danger-text","color-danger-solid","color-danger-hover","z-base","z-raised","z-sticky","z-backdrop","z-dialog","z-dropdown","z-toast","z-tooltip","duration-fast","duration-base","duration-slow","duration-slower","ease-standard","ease-enter","ease-exit","radius-none","radius-xs","radius-sm","radius-md","radius-lg","radius-xl","radius-2xl","radius-full","size-control-sm","size-control-md","size-control-lg","size-control-compact-sm","size-control-compact-md","size-control-compact-lg","size-touch-target","size-badge-sm","size-badge-md","size-icon-xs","size-icon-sm","size-icon-md","size-icon-lg","size-icon-xl","size-dialog-sm","size-dialog-md","size-dialog-lg","border-width-hairline","border-width-focus","spacing-none","spacing-3xs","spacing-2xs","spacing-xs","spacing-sm","spacing-md","spacing-lg","spacing-xl","spacing-2xl","spacing-3xl","spacing-4xl","font-family-sans","font-family-mono","font-size-xs","font-size-sm","font-size-md","font-size-lg","font-size-xl","font-size-2xl","font-size-3xl","font-size-4xl","font-size-5xl","font-weight-regular","font-weight-medium","font-weight-semibold","font-line-height-tight","font-line-height-snug","font-line-height-normal","font-line-height-ui","font-tracking-tight","font-tracking-snug","font-tracking-normal","font-tracking-wide","font-measure","elevation-0","elevation-1","elevation-2","elevation-3"];
 export const cssVar = (name) => `var(--sc-${name})`;

package/dist/json/tokens.json

@@ -1,5 +1,5 @@
 {
-  "version": "0.2.0-rc.3",
+  "version": "0.2.0-rc.5",
   "prefix": "sc",
   "light": {
     "sc-color-white": "#ffffff",
@@ -109,11 +109,11 @@
     "sc-z-base": 0,
     "sc-z-raised": 1,
     "sc-z-sticky": 100,
-    "sc-z-dropdown": 1000,
     "sc-z-backdrop": 1100,
     "sc-z-dialog": 1200,
-    "sc-z-toast": 1300,
-    "sc-z-tooltip": 1400,
+    "sc-z-dropdown": 1300,
+    "sc-z-toast": 1400,
+    "sc-z-tooltip": 1500,
     "sc-duration-fast": "100ms",
     "sc-duration-base": "200ms",
     "sc-duration-slow": "300ms",
@@ -295,11 +295,11 @@
     "sc-z-base": 0,
     "sc-z-raised": 1,
     "sc-z-sticky": 100,
-    "sc-z-dropdown": 1000,
     "sc-z-backdrop": 1100,
     "sc-z-dialog": 1200,
-    "sc-z-toast": 1300,
-    "sc-z-tooltip": 1400,
+    "sc-z-dropdown": 1300,
+    "sc-z-toast": 1400,
+    "sc-z-tooltip": 1500,
     "sc-duration-fast": "100ms",
     "sc-duration-base": "200ms",
     "sc-duration-slow": "300ms",

package/dist/scss/_tokens.scss

@@ -1,4 +1,4 @@
-// @salemcobalt/tokens 0.2.0-rc.3 — generated from src/ by Style Dictionary. Do not edit.
+// @salemcobalt/tokens 0.2.0-rc.5 — generated from src/ by Style Dictionary. Do not edit.
 $sc-color-white: #ffffff; // Primitive.
 $sc-color-black: #05070c; // Primitive. Deepest dark surface.
 $sc-color-neutral-0: #ffffff; // Primitive. Cool neutral, OKLCH hue 263.
@@ -105,12 +105,12 @@ $sc-color-danger-solid: #a8001c; // Danger Button fill and solid danger Badge.
 $sc-color-danger-hover: #860014; // Danger Button hover.
 $sc-z-base: 0; // Normal flow.
 $sc-z-raised: 1; // Hover and focus rings over siblings.
-$sc-z-sticky: 100; // Sticky headers and table heads.
-$sc-z-dropdown: 1000; // Menus, selects, popovers.
+$sc-z-sticky: 100; // Pinned chrome inside the page: sticky Toolbar, Banner, Table head.
 $sc-z-backdrop: 1100; // Dialog scrim.
-$sc-z-dialog: 1200; // Dialog popup.
-$sc-z-toast: 1300; // Toasts.
-$sc-z-tooltip: 1400; // Tooltips, above everything.
+$sc-z-dialog: 1200; // Dialog popup and sheet.
+$sc-z-dropdown: 1300; // Menus, selects, popovers. Above dialog so a popup opened from inside one shows over it.
+$sc-z-toast: 1400; // Toasts, above open popups.
+$sc-z-tooltip: 1500; // Tooltips, above everything.
 $sc-duration-fast: 100ms; // Hover and press color changes.
 $sc-duration-base: 200ms; // Dialog enter, backdrop fade.
 $sc-duration-slow: 300ms; // Layout shifts, panels sliding.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@salemcobalt/tokens",
-  "version": "0.2.0-rc.3",
+  "version": "0.2.0-rc.5",
   "description": "Design tokens for the Salem Cobalt design system: CSS custom properties, Sass, TypeScript and JSON from one Style Dictionary source.",
   "license": "MIT",
   "repository": {

package/src/global/layer.json

@@ -2,11 +2,19 @@
   "z": {
     "base": { "$value": 0, "$type": "number", "$description": "Normal flow." },
     "raised": { "$value": 1, "$type": "number", "$description": "Hover and focus rings over siblings." },
-    "sticky": { "$value": 100, "$type": "number", "$description": "Sticky headers and table heads." },
-    "dropdown": { "$value": 1000, "$type": "number", "$description": "Menus, selects, popovers." },
+    "sticky": {
+      "$value": 100,
+      "$type": "number",
+      "$description": "Pinned chrome inside the page: sticky Toolbar, Banner, Table head."
+    },
     "backdrop": { "$value": 1100, "$type": "number", "$description": "Dialog scrim." },
-    "dialog": { "$value": 1200, "$type": "number", "$description": "Dialog popup." },
-    "toast": { "$value": 1300, "$type": "number", "$description": "Toasts." },
-    "tooltip": { "$value": 1400, "$type": "number", "$description": "Tooltips, above everything." }
+    "dialog": { "$value": 1200, "$type": "number", "$description": "Dialog popup and sheet." },
+    "dropdown": {
+      "$value": 1300,
+      "$type": "number",
+      "$description": "Menus, selects, popovers. Above dialog so a popup opened from inside one shows over it."
+    },
+    "toast": { "$value": 1400, "$type": "number", "$description": "Toasts, above open popups." },
+    "tooltip": { "$value": 1500, "$type": "number", "$description": "Tooltips, above everything." }
   }
 }