@codecademy/gamut-styles 20.0.3-alpha.487323.0 → 20.0.3-alpha.4994b7.0

package/dist/themes/admin.d.ts

@@ -34,13 +34,20 @@ export declare const adminTheme: Record<"breakpoints", {
     md: string;
     lg: string;
     xl: string;
-}> & import("@codecademy/variance/dist/createTheme/types").Merge<Record<"elements", Record<"elements", import("@codecademy/variance").KeyAsVariable<{
-    readonly headerHeight: {
-        readonly base: "4rem";
-        readonly md: "5rem";
-    };
-    readonly headerZ: 15;
-}, "elements">>> & import("@codecademy/variance/dist/createTheme/types").Merge<import("@codecademy/variance/dist/createTheme/types").MergeTheme<import("@codecademy/variance/dist/createTheme/types").MergeTheme<Record<"breakpoints", {
+}> & import("@codecademy/variance/dist/createTheme/types").Merge<Record<"zIndices", Record<"zIndices", import("@codecademy/variance").KeyAsVariable<{
+    readonly underlay: -1;
+    readonly base: 0;
+    readonly foreground: 1;
+    readonly stickyHeader: 100;
+    readonly portal: 200;
+    readonly widget: 300;
+    readonly appBar: 400;
+    readonly flyout: 500;
+    readonly modal: 600;
+    readonly popover: 700;
+    readonly toaster: 800;
+    readonly tooltip: 900;
+}, "zIndices">>> & import("@codecademy/variance/dist/createTheme/types").Merge<import("@codecademy/variance/dist/createTheme/types").MergeTheme<import("@codecademy/variance/dist/createTheme/types").MergeTheme<import("@codecademy/variance/dist/createTheme/types").MergeTheme<Record<"breakpoints", {
     c_base: string;
     c_xs: string;
     c_sm: string;
@@ -120,7 +127,21 @@ export declare const adminTheme: Record<"breakpoints", {
             readonly base: "4rem";
             readonly md: "5rem";
         };
-        readonly headerZ: 15;
+        readonly headerZ: 400;
+    };
+    zIndices: {
+        readonly underlay: -1;
+        readonly base: 0;
+        readonly foreground: 1;
+        readonly stickyHeader: 100;
+        readonly portal: 200;
+        readonly widget: 300;
+        readonly appBar: 400;
+        readonly flyout: 500;
+        readonly modal: 600;
+        readonly popover: 700;
+        readonly toaster: 800;
+        readonly tooltip: 900;
     };
 } & import("@codecademy/variance/dist/createTheme/types").PrivateThemeKeys, Record<"colors", import("@codecademy/variance").KeyAsVariable<import("@codecademy/variance").LiteralPaths<{
     readonly beige: "#FFF0E5";
@@ -544,7 +565,13 @@ export declare const adminTheme: Record<"breakpoints", {
 }>, Record<"borders", import("@codecademy/variance").LiteralPaths<{
     1: string;
     2: string;
-}, "-">>>, import("@codecademy/variance/dist/createTheme/types").PrivateThemeKeys> & import("@codecademy/variance/dist/createTheme/types").PrivateThemeKeys, Record<"name", string>> & import("@codecademy/variance/dist/createTheme/types").PrivateThemeKeys, {
+}, "-">>>, import("@codecademy/variance/dist/createTheme/types").PrivateThemeKeys, Record<"elements", Record<"elements", import("@codecademy/variance").KeyAsVariable<{
+    readonly headerHeight: {
+        readonly base: "4rem";
+        readonly md: "5rem";
+    };
+    readonly headerZ: 400;
+}, "elements">>>>, import("@codecademy/variance/dist/createTheme/types").PrivateThemeKeys> & import("@codecademy/variance/dist/createTheme/types").PrivateThemeKeys, Record<"name", string>> & import("@codecademy/variance/dist/createTheme/types").PrivateThemeKeys, {
     colors: import("@codecademy/variance").KeyAsVariable<import("@codecademy/variance").LiteralPaths<{
         primary: {
             _: "blue-500";

package/dist/themes/core.d.ts

@@ -15,13 +15,20 @@ export declare const coreTheme: Record<"breakpoints", {
     md: string;
     lg: string;
     xl: string;
-}> & import("@codecademy/variance/dist/createTheme/types").Merge<Record<"elements", Record<"elements", import("@codecademy/variance").KeyAsVariable<{
-    readonly headerHeight: {
-        readonly base: "4rem";
-        readonly md: "5rem";
-    };
-    readonly headerZ: 15;
-}, "elements">>> & import("@codecademy/variance/dist/createTheme/types").Merge<import("@codecademy/variance/dist/createTheme/types").MergeTheme<import("@codecademy/variance/dist/createTheme/types").MergeTheme<Record<"breakpoints", {
+}> & import("@codecademy/variance/dist/createTheme/types").Merge<Record<"zIndices", Record<"zIndices", import("@codecademy/variance").KeyAsVariable<{
+    readonly underlay: -1;
+    readonly base: 0;
+    readonly foreground: 1;
+    readonly stickyHeader: 100;
+    readonly portal: 200;
+    readonly widget: 300;
+    readonly appBar: 400;
+    readonly flyout: 500;
+    readonly modal: 600;
+    readonly popover: 700;
+    readonly toaster: 800;
+    readonly tooltip: 900;
+}, "zIndices">>> & import("@codecademy/variance/dist/createTheme/types").Merge<import("@codecademy/variance/dist/createTheme/types").MergeTheme<import("@codecademy/variance/dist/createTheme/types").MergeTheme<import("@codecademy/variance/dist/createTheme/types").MergeTheme<Record<"breakpoints", {
     c_base: string;
     c_xs: string;
     c_sm: string;
@@ -101,7 +108,21 @@ export declare const coreTheme: Record<"breakpoints", {
             readonly base: "4rem";
             readonly md: "5rem";
         };
-        readonly headerZ: 15;
+        readonly headerZ: 400;
+    };
+    zIndices: {
+        readonly underlay: -1;
+        readonly base: 0;
+        readonly foreground: 1;
+        readonly stickyHeader: 100;
+        readonly portal: 200;
+        readonly widget: 300;
+        readonly appBar: 400;
+        readonly flyout: 500;
+        readonly modal: 600;
+        readonly popover: 700;
+        readonly toaster: 800;
+        readonly tooltip: 900;
     };
 } & import("@codecademy/variance/dist/createTheme/types").PrivateThemeKeys, Record<"colors", import("@codecademy/variance").KeyAsVariable<import("@codecademy/variance").LiteralPaths<{
     readonly beige: "#FFF0E5";
@@ -525,7 +546,13 @@ export declare const coreTheme: Record<"breakpoints", {
 }>, Record<"borders", import("@codecademy/variance").LiteralPaths<{
     1: string;
     2: string;
-}, "-">>>, import("@codecademy/variance/dist/createTheme/types").PrivateThemeKeys> & import("@codecademy/variance/dist/createTheme/types").PrivateThemeKeys, Record<"name", string>> & import("@codecademy/variance/dist/createTheme/types").PrivateThemeKeys;
+}, "-">>>, import("@codecademy/variance/dist/createTheme/types").PrivateThemeKeys, Record<"elements", Record<"elements", import("@codecademy/variance").KeyAsVariable<{
+    readonly headerHeight: {
+        readonly base: "4rem";
+        readonly md: "5rem";
+    };
+    readonly headerZ: 400;
+}, "elements">>>>, import("@codecademy/variance/dist/createTheme/types").PrivateThemeKeys> & import("@codecademy/variance/dist/createTheme/types").PrivateThemeKeys, Record<"name", string>> & import("@codecademy/variance/dist/createTheme/types").PrivateThemeKeys;
 export type CoreThemeShape = typeof coreTheme;
 export interface CoreTheme extends CoreThemeShape {
 }

package/dist/themes/core.js

@@ -1,5 +1,5 @@
 import { createTheme } from '@codecademy/variance';
-import { borderRadii, containerQueries, corePalette, elements, fontFamily, fontSize, fontWeight, lineHeight, mediaQueries, spacing } from '../variables';
+import { borderRadii, containerQueries, corePalette, elements, fontFamily, fontSize, fontWeight, lineHeight, mediaQueries, spacing, zIndices } from '../variables';
 
 /**
  *  @description  This is the core theme that all other Codecademy themes are extended from
@@ -18,7 +18,8 @@ export const coreTheme = createTheme({
   lineHeight,
   fontWeight,
   spacing,
-  elements
+  elements,
+  zIndices
 }).addColors(corePalette).addColorModes('light', {
   light: {
     text: {
@@ -129,4 +130,4 @@ export const coreTheme = createTheme({
 }) => ({
   1: `1px solid ${colors['border-primary']}`,
   2: `2px solid ${colors['border-primary']}`
-})).createScaleVariables('elements').addName('core').build();
+})).createScaleVariables('elements').createScaleVariables('zIndices').addName('core').build();

package/dist/themes/lxStudio.d.ts

@@ -78,18 +78,45 @@ export declare const lxStudioTheme: Record<"breakpoints", {
         lg: string;
         xl: string;
     };
+    zIndices: Record<"zIndices", import("@codecademy/variance").KeyAsVariable<{
+        readonly underlay: -1;
+        readonly base: 0;
+        readonly foreground: 1;
+        readonly stickyHeader: 100;
+        readonly portal: 200;
+        readonly widget: 300;
+        readonly appBar: 400;
+        readonly flyout: 500;
+        readonly modal: 600;
+        readonly popover: 700;
+        readonly toaster: 800;
+        readonly tooltip: 900;
+    }, "zIndices">> & {
+        readonly underlay: -1;
+        readonly base: 0;
+        readonly foreground: 1;
+        readonly stickyHeader: 100;
+        readonly portal: 200;
+        readonly widget: 300;
+        readonly appBar: 400;
+        readonly flyout: 500;
+        readonly modal: 600;
+        readonly popover: 700;
+        readonly toaster: 800;
+        readonly tooltip: 900;
+    };
     elements: Record<"elements", import("@codecademy/variance").KeyAsVariable<{
         readonly headerHeight: {
             readonly base: "4rem";
             readonly md: "5rem";
         };
-        readonly headerZ: 15;
+        readonly headerZ: 400;
     }, "elements">> & {
         readonly headerHeight: {
             readonly base: "4rem";
             readonly md: "5rem";
         };
-        readonly headerZ: 15;
+        readonly headerZ: 400;
     };
     fontSize: {
         readonly 64: string;
@@ -120,8 +147,8 @@ export declare const lxStudioTheme: Record<"breakpoints", {
         readonly 64: string;
         readonly 96: string;
     };
-    _variables: import("@codecademy/variance/dist/createTheme/types").Assign<Record<string, import("@codecademy/variance").CSSObject>, Record<string, import("@codecademy/variance").CSSObject>> & Record<string, import("@codecademy/variance").CSSObject>;
-    _tokens: import("@codecademy/variance/dist/createTheme/types").Assign<Record<string | number, any>, Record<string | number, any>> & Record<string | number, any>;
+    _variables: import("@codecademy/variance/dist/createTheme/types").Assign<import("@codecademy/variance/dist/createTheme/types").Assign<Record<string, import("@codecademy/variance").CSSObject>, Record<string, import("@codecademy/variance").CSSObject>>, Record<string, import("@codecademy/variance").CSSObject>> & Record<string, import("@codecademy/variance").CSSObject>;
+    _tokens: import("@codecademy/variance/dist/createTheme/types").Assign<import("@codecademy/variance/dist/createTheme/types").Assign<Record<string | number, any>, Record<string | number, any>>, Record<string | number, any>> & Record<string | number, any>;
     colors: import("@codecademy/variance/dist/createTheme/types").Assign<import("@codecademy/variance").KeyAsVariable<import("@codecademy/variance").LiteralPaths<{
         readonly beige: "#FFF0E5";
         readonly blue: "#1557FF";

package/dist/themes/percipio.d.ts

@@ -62,18 +62,45 @@ export declare const percipioTheme: Record<"breakpoints", {
         lg: string;
         xl: string;
     };
+    zIndices: Record<"zIndices", import("@codecademy/variance").KeyAsVariable<{
+        readonly underlay: -1;
+        readonly base: 0;
+        readonly foreground: 1;
+        readonly stickyHeader: 100;
+        readonly portal: 200;
+        readonly widget: 300;
+        readonly appBar: 400;
+        readonly flyout: 500;
+        readonly modal: 600;
+        readonly popover: 700;
+        readonly toaster: 800;
+        readonly tooltip: 900;
+    }, "zIndices">> & {
+        readonly underlay: -1;
+        readonly base: 0;
+        readonly foreground: 1;
+        readonly stickyHeader: 100;
+        readonly portal: 200;
+        readonly widget: 300;
+        readonly appBar: 400;
+        readonly flyout: 500;
+        readonly modal: 600;
+        readonly popover: 700;
+        readonly toaster: 800;
+        readonly tooltip: 900;
+    };
     elements: Record<"elements", import("@codecademy/variance").KeyAsVariable<{
         readonly headerHeight: {
             readonly base: "4rem";
             readonly md: "5rem";
         };
-        readonly headerZ: 15;
+        readonly headerZ: 400;
     }, "elements">> & {
         readonly headerHeight: {
             readonly base: "4rem";
             readonly md: "5rem";
         };
-        readonly headerZ: 15;
+        readonly headerZ: 400;
     };
     borderRadii: {
         none: string;
@@ -112,8 +139,8 @@ export declare const percipioTheme: Record<"breakpoints", {
         readonly 64: string;
         readonly 96: string;
     };
-    _variables: import("@codecademy/variance/dist/createTheme/types").Assign<Record<string, import("@codecademy/variance").CSSObject>, Record<string, import("@codecademy/variance").CSSObject>> & Record<string, import("@codecademy/variance").CSSObject>;
-    _tokens: import("@codecademy/variance/dist/createTheme/types").Assign<Record<string | number, any>, Record<string | number, any>> & Record<string | number, any>;
+    _variables: import("@codecademy/variance/dist/createTheme/types").Assign<import("@codecademy/variance/dist/createTheme/types").Assign<Record<string, import("@codecademy/variance").CSSObject>, Record<string, import("@codecademy/variance").CSSObject>>, Record<string, import("@codecademy/variance").CSSObject>> & Record<string, import("@codecademy/variance").CSSObject>;
+    _tokens: import("@codecademy/variance/dist/createTheme/types").Assign<import("@codecademy/variance/dist/createTheme/types").Assign<Record<string | number, any>, Record<string | number, any>>, Record<string | number, any>> & Record<string | number, any>;
     colors: import("@codecademy/variance/dist/createTheme/types").Assign<import("@codecademy/variance").KeyAsVariable<import("@codecademy/variance").LiteralPaths<{
         readonly beige: "#FFF0E5";
         readonly blue: "#1557FF";

package/dist/themes/platform.d.ts

@@ -50,13 +50,20 @@ export declare const platformTheme: Record<"breakpoints", {
     md: string;
     lg: string;
     xl: string;
-}> & import("@codecademy/variance/dist/createTheme/types").Merge<Record<"elements", Record<"elements", import("@codecademy/variance").KeyAsVariable<{
-    readonly headerHeight: {
-        readonly base: "4rem";
-        readonly md: "5rem";
-    };
-    readonly headerZ: 15;
-}, "elements">>> & import("@codecademy/variance/dist/createTheme/types").Merge<import("@codecademy/variance/dist/createTheme/types").MergeTheme<import("@codecademy/variance/dist/createTheme/types").MergeTheme<Record<"breakpoints", {
+}> & import("@codecademy/variance/dist/createTheme/types").Merge<Record<"zIndices", Record<"zIndices", import("@codecademy/variance").KeyAsVariable<{
+    readonly underlay: -1;
+    readonly base: 0;
+    readonly foreground: 1;
+    readonly stickyHeader: 100;
+    readonly portal: 200;
+    readonly widget: 300;
+    readonly appBar: 400;
+    readonly flyout: 500;
+    readonly modal: 600;
+    readonly popover: 700;
+    readonly toaster: 800;
+    readonly tooltip: 900;
+}, "zIndices">>> & import("@codecademy/variance/dist/createTheme/types").Merge<import("@codecademy/variance/dist/createTheme/types").MergeTheme<import("@codecademy/variance/dist/createTheme/types").MergeTheme<import("@codecademy/variance/dist/createTheme/types").MergeTheme<Record<"breakpoints", {
     c_base: string;
     c_xs: string;
     c_sm: string;
@@ -136,7 +143,21 @@ export declare const platformTheme: Record<"breakpoints", {
             readonly base: "4rem";
             readonly md: "5rem";
         };
-        readonly headerZ: 15;
+        readonly headerZ: 400;
+    };
+    zIndices: {
+        readonly underlay: -1;
+        readonly base: 0;
+        readonly foreground: 1;
+        readonly stickyHeader: 100;
+        readonly portal: 200;
+        readonly widget: 300;
+        readonly appBar: 400;
+        readonly flyout: 500;
+        readonly modal: 600;
+        readonly popover: 700;
+        readonly toaster: 800;
+        readonly tooltip: 900;
     };
 } & import("@codecademy/variance/dist/createTheme/types").PrivateThemeKeys, Record<"colors", import("@codecademy/variance").KeyAsVariable<import("@codecademy/variance").LiteralPaths<{
     readonly beige: "#FFF0E5";
@@ -560,7 +581,13 @@ export declare const platformTheme: Record<"breakpoints", {
 }>, Record<"borders", import("@codecademy/variance").LiteralPaths<{
     1: string;
     2: string;
-}, "-">>>, import("@codecademy/variance/dist/createTheme/types").PrivateThemeKeys> & import("@codecademy/variance/dist/createTheme/types").PrivateThemeKeys, Record<"name", string>> & import("@codecademy/variance/dist/createTheme/types").PrivateThemeKeys, Record<"colors", import("@codecademy/variance").KeyAsVariable<import("@codecademy/variance").LiteralPaths<{
+}, "-">>>, import("@codecademy/variance/dist/createTheme/types").PrivateThemeKeys, Record<"elements", Record<"elements", import("@codecademy/variance").KeyAsVariable<{
+    readonly headerHeight: {
+        readonly base: "4rem";
+        readonly md: "5rem";
+    };
+    readonly headerZ: 400;
+}, "elements">>>>, import("@codecademy/variance/dist/createTheme/types").PrivateThemeKeys> & import("@codecademy/variance/dist/createTheme/types").PrivateThemeKeys, Record<"name", string>> & import("@codecademy/variance/dist/createTheme/types").PrivateThemeKeys, Record<"colors", import("@codecademy/variance").KeyAsVariable<import("@codecademy/variance").LiteralPaths<{
     readonly lightBeige: "#FFFBF8";
     readonly gold: "#8A7300";
     readonly teal: "#006D82";

package/dist/variables/elements.d.ts

@@ -4,8 +4,9 @@ export declare const elements: {
         readonly md: "5rem";
     };
     /**
-     * Semi-arbitrary z-index for global page headers.
-     * @remarks PLEASE talk to web platform before adding new z-index constants!
+     * z-index for global page headers. Aliases the `appBar` token from the `zIndices`
+     * scale so consumers still reading `elements.headerZ` stay in sync with the scale.
+     * Prefer `zIndex="appBar"` in new code.
      */
-    readonly headerZ: 15;
+    readonly headerZ: 400;
 };

package/dist/variables/elements.js

@@ -1,11 +1,13 @@
+import { zIndices } from './zIndices';
 export const elements = {
   headerHeight: {
     base: '4rem',
     md: '5rem'
   },
   /**
-   * Semi-arbitrary z-index for global page headers.
-   * @remarks PLEASE talk to web platform before adding new z-index constants!
+   * z-index for global page headers. Aliases the `appBar` token from the `zIndices`
+   * scale so consumers still reading `elements.headerZ` stay in sync with the scale.
+   * Prefer `zIndex="appBar"` in new code.
    */
-  headerZ: 15
+  headerZ: zIndices.appBar
 };

package/dist/variables/index.d.ts

@@ -5,3 +5,4 @@ export * from './responsive';
 export * from './spacing';
 export * from './timing';
 export * from './typography';
+export * from './zIndices';

package/dist/variables/index.js

@@ -4,4 +4,5 @@ export * from './elements';
 export * from './responsive';
 export * from './spacing';
 export * from './timing';
-export * from './typography';
+export * from './typography';
+export * from './zIndices';

package/dist/variables/zIndices.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Semantic z-index scale. A single scale covers both in-flow layers (low values) and
+ * portal layers (≥100). Every z-index in Gamut should reference a token here rather than a
+ * magic number.
+ *
+ * The `zIndex` prop is intentionally left numeric/unscaled, and this object is numeric, so
+ * tokens are used as `zIndex={zIndices.modal}`. That preserves the escape hatch (a raw
+ * in-between number, e.g. `zIndex={605}`) and arithmetic on tokens (e.g. `zIndices.foreground - 2`).
+ *
+ * Portal-band values are spaced by 100 so in-between escape-hatch numbers are available.
+ * `portal` (200) is the floor of the portal band and the default for `BodyPortal`.
+ *
+ * @remarks PLEASE talk to web platform before adding new z-index tokens.
+ */
+export declare const zIndices: {
+    /** Decorative layer behind content (underlines, backdrops, shadows). */
+    readonly underlay: -1;
+    /** Ground layer — establishes a local stacking context without lifting above siblings. */
+    readonly base: 0;
+    /** Content lifted just above a sibling underlay/base. */
+    readonly foreground: 1;
+    /**
+     * In-flow sticky content headers (e.g. a sticky table `thead`). Below the portal band,
+     * so every overlay and the app nav cover it. Not a portal layer.
+     */
+    readonly stickyHeader: 100;
+    /** Portal floor / `BodyPortal` default — un-tokenized portal content lands here. */
+    readonly portal: 200;
+    /** Persistent floating page furniture at rest (e.g. an AI chat launcher, help bubble). */
+    readonly widget: 300;
+    /** Global app header / nav bar. Aliased by the legacy `elements.headerZ` constant. */
+    readonly appBar: 400;
+    /** Portaled side panel (the `Flyout` component = `Drawer` inside `Overlay`). */
+    readonly flyout: 500;
+    /** `Overlay`, `Modal`, and `Dialog` (they share one portal primitive). */
+    readonly modal: 600;
+    /** Portal-mode `Popover` and the portaled `SelectDropdown` menu — above modal. */
+    readonly popover: 700;
+    /** Toasts / notifications — visible above modals. */
+    readonly toaster: 800;
+    /** Floating tooltips (`FloatingTip`) — highest, so they are never clipped. */
+    readonly tooltip: 900;
+};

package/dist/variables/zIndices.js

@@ -0,0 +1,43 @@
+/**
+ * Semantic z-index scale. A single scale covers both in-flow layers (low values) and
+ * portal layers (≥100). Every z-index in Gamut should reference a token here rather than a
+ * magic number.
+ *
+ * The `zIndex` prop is intentionally left numeric/unscaled, and this object is numeric, so
+ * tokens are used as `zIndex={zIndices.modal}`. That preserves the escape hatch (a raw
+ * in-between number, e.g. `zIndex={605}`) and arithmetic on tokens (e.g. `zIndices.foreground - 2`).
+ *
+ * Portal-band values are spaced by 100 so in-between escape-hatch numbers are available.
+ * `portal` (200) is the floor of the portal band and the default for `BodyPortal`.
+ *
+ * @remarks PLEASE talk to web platform before adding new z-index tokens.
+ */
+export const zIndices = {
+  /** Decorative layer behind content (underlines, backdrops, shadows). */
+  underlay: -1,
+  /** Ground layer — establishes a local stacking context without lifting above siblings. */
+  base: 0,
+  /** Content lifted just above a sibling underlay/base. */
+  foreground: 1,
+  /**
+   * In-flow sticky content headers (e.g. a sticky table `thead`). Below the portal band,
+   * so every overlay and the app nav cover it. Not a portal layer.
+   */
+  stickyHeader: 100,
+  /** Portal floor / `BodyPortal` default — un-tokenized portal content lands here. */
+  portal: 200,
+  /** Persistent floating page furniture at rest (e.g. an AI chat launcher, help bubble). */
+  widget: 300,
+  /** Global app header / nav bar. Aliased by the legacy `elements.headerZ` constant. */
+  appBar: 400,
+  /** Portaled side panel (the `Flyout` component = `Drawer` inside `Overlay`). */
+  flyout: 500,
+  /** `Overlay`, `Modal`, and `Dialog` (they share one portal primitive). */
+  modal: 600,
+  /** Portal-mode `Popover` and the portaled `SelectDropdown` menu — above modal. */
+  popover: 700,
+  /** Toasts / notifications — visible above modals. */
+  toaster: 800,
+  /** Floating tooltips (`FloatingTip`) — highest, so they are never clipped. */
+  tooltip: 900
+};

package/dist/variance/config.js

@@ -450,6 +450,9 @@ export const positioning = {
     resolveProperty: getPropertyMode,
     transform: transformSize
   },
+  // Intentionally unscaled: scaled variance props are token-only and reject raw numbers,
+  // which would break the numeric escape hatch and Tip's z-index arithmetic. Use the numeric
+  // `zIndices` token object instead (e.g. zIndex={zIndices.modal}).
   zIndex: {
     property: 'zIndex'
   },

package/package.json

@@ -1,10 +1,10 @@
 {
   "name": "@codecademy/gamut-styles",
   "description": "Styleguide & Component library for codecademy.com",
-  "version": "20.0.3-alpha.487323.0",
+  "version": "20.0.3-alpha.4994b7.0",
   "author": "Jake Hiller <jake@codecademy.com>",
   "dependencies": {
-    "@codecademy/variance": "0.26.2-alpha.487323.0",
+    "@codecademy/variance": "0.26.2-alpha.4994b7.0",
     "@emotion/is-prop-valid": "^1.1.0",
     "framer-motion": "^11.18.0",
     "get-nonce": "^1.0.0",